{"id":15788436,"url":"https://github.com/ultcombo/traceuroso","last_synced_at":"2025-03-31T18:24:25.150Z","repository":{"id":18780268,"uuid":"21993533","full_name":"UltCombo/traceuroso","owner":"UltCombo","description":"Write and run ECMAScript.next Node.js packages without any build steps.","archived":false,"fork":false,"pushed_at":"2015-04-05T16:22:38.000Z","size":264,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-18T13:56:19.150Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UltCombo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-07-18T20:29:08.000Z","updated_at":"2015-04-05T16:22:38.000Z","dependencies_parsed_at":"2022-08-05T01:15:13.917Z","dependency_job_id":null,"html_url":"https://github.com/UltCombo/traceuroso","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UltCombo%2Ftraceuroso","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UltCombo%2Ftraceuroso/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UltCombo%2Ftraceuroso/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UltCombo%2Ftraceuroso/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UltCombo","download_url":"https://codeload.github.com/UltCombo/traceuroso/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246516109,"owners_count":20790175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-04T22:00:23.567Z","updated_at":"2025-03-31T18:24:25.128Z","avatar_url":"https://github.com/UltCombo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DEPRECATED\n\nThis package has been deprecated in favor of [slush-es20xx](https://github.com/es6rocks/slush-es20xx), which provides a better, fully optimized ECMAScript.next development and deployment workflow.\n\n# traceuroso\n[![npm version](http://img.shields.io/npm/v/traceuroso.svg)](https://npmjs.org/package/traceuroso)\n[![Build Status](http://img.shields.io/travis/UltCombo/traceuroso.svg)](https://travis-ci.org/UltCombo/traceuroso)\n[![Dependency Status](http://img.shields.io/david/UltCombo/traceuroso.svg)](https://david-dm.org/UltCombo/traceuroso)\n[![devDependency Status](http://img.shields.io/david/dev/UltCombo/traceuroso.svg)](https://david-dm.org/UltCombo/traceuroso#info=devDependencies)\n\nWrite and run ECMAScript.next Node.js packages without any build steps.\n\n# Purpose\n\n- **ECMAScript.next**: make use of the next generation JavaScript features today through the quantum time travelling magic of [Traceur](https://github.com/google/traceur-compiler).\n- **Modularity**: traceuroso is enabled per package, thus it does not conflict with your package's dependencies nor packages which depend upon your package.\n- **No build steps**: there is no transpiling between editing and running your code, thus providing a faster development workflow and cleaner source control, testing and deployment.\n\n# Install\n\n```\nnpm install --save traceuroso\n```\n\n# Usage\n\nCreate a traceuroso bootstrapping file and set it as your package's entry point. Here is a quick overview:\n\npackage.json\n\n```js\n\"main\": \"bootstrap.js\"\n```\n\nbootstrap.js\n\n```js\nmodule.exports = require('traceuroso')(__dirname, 'index');\n```\n\nindex.js\n\n```js\n// Just write your ES.next code naturally =]\nlet my = ((awesome, es6) =\u003e 'code')('shine!');\n```\n\nSee the API section below for details.\n\n# API\n\n```js\nentryPointExports = traceuroso(packageRoot[, entryPoint='index'][, compileOptions=traceur.util.Options.experimental().setFromObject({ modules: 'commonjs' })])\n```\n\n- `packageRoot` (string): the root directory of the package to traceurosofy. All `.js` files inside of `packageRoot`, except those inside of `packageRoot`'s `node_modules` directory, will be compiled using Traceur when `require()`d or `import`ed.\n- `entryPoint` (string, optional): the file path to your package's main file (your `package.json`'s original `main` file), relative to `packageRoot`. Defaults to `index`.\n- `compileOptions` (object, optional): the options passed to the Traceur compiler. See Traceur's [Options.js](https://github.com/google/traceur-compiler/blob/master/src/Options.js) for available options and values. Useful for parsing ES.next semantics without applying transformations (e.g. `{ blockBinding: 'parse' }` for usage with the Node.js `--harmony` flag). Defaults to all options enabled by default plus all experimental options enabled.\n- *returns*: `entryPoint`'s exports. You should re-export these in order to make them available to the files which `require()` your package.\n\n# The traceuroso bootstrapping file\n\nThe bootstrapping file is the first file to be executed when your package is required. It is responsible for loading Traceur, compiling and running your package, as well as re-exporting your package's exports. Review the Usage and API sections for example and details.\n\nNote that as the bootstrapping file is `require()`'d and executed directly by Node.js before the package is traceurosofied, the bootstrapping file must contain only valid Node.js code that can run without Traceur's aid.\n\n# Optimization\n\nIn order to avoid loading the Traceur compiler multiple times, it is recommended to run [`npm dedupe traceuroso`](https://www.npmjs.org/doc/cli/npm-dedupe.html) in the downstream package, or install traceuroso in the downstream package before installing the other dependencies.\n\n# Changelog\n\n- **0.0.6**: set a more specific Traceur version dependency in `package.json`.\n- **0.0.5**: updated the internal Traceur API usage to work with the latest Traceur version (v0.0.86 at the time of publishing), improved compilation error stack trace, bumped dependencies, deprecated traceuroso in favor of slush-es20xx.\n- **0.0.4**: added optimization section to documentation, improved source code readability.\n- **0.0.3**: added `compileOptions` parameter, replaced `traceur.require.makeDefault()` with own implementation.\n- **0.0.2**: no longer version locks Traceur, added full test coverage, documentation improvements.\n- **0.0.1**: initial release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultcombo%2Ftraceuroso","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fultcombo%2Ftraceuroso","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultcombo%2Ftraceuroso/lists"}