es2049scripts
Version:
ECMAScript 2049: ES.Next on every line by triple-transpile by Harald Rudell: ERASE THE PAST
138 lines (129 loc) • 9.31 kB
Markdown
<h1>ECMAScript 2049 Scripts</h1>
<img src=https://raw.githubusercontent.com/haraldrudell/ECMAScript2049/HEAD/assets/ECMAScript%202049.png alt="ECMAScript 2049" />
<p><strong>ERASE THE PAST</strong></p>
<p> </p>
<h1>es2049scripts is deprecated</h1>
<p>Instead use Node.js 12+ with either <strong>--experimental-modules</strong> or package.json <strong>type: module</strong></p>
<p> </p>
<p>© <a href=http://haraldrudell.com>Harald Rudell</a> created <strong>ECMAScript 2049</strong> in December 2017. ISC License</p>
<p> </p>
<p>This is the <strong>es2049scripts</strong> package</p>
<p>Repository links:<br />
<strong><a href=https://github.com/haraldrudell/ECMAScript2049>ECMAScript 2049</a></strong> the monolithic repository<br />
<strong><a href=https://github.com/haraldrudell/ECMAScript2049/tree/master/packages/es2049package>es2049package</a></strong> compile libraries and command-line utilities configuration-free with RollupJS<br />
<strong><a href=https://github.com/haraldrudell/ECMAScript2049/tree/master/packages/allspawn>allspawn</a></strong> async spawn utility</p>
<h2>Benefits</h2>
<ul>
<li><p><strong>ECMAScript 2049</strong> provides instant on-the-fly transpilation of <strong>ES.Next ECMAScript</strong> to a runnable format</p></li>
<li><p><strong>ECMAScript 2049</strong> transpilation is so fast that a users are not aware of it taking place</p></li>
<li><p><strong>ECMAScript 2049</strong> thereby offers use of <strong>ES.Next</strong> everywhere:</p>
<ul>
<li><p>Production use of <strong>ECMAScript</strong> language features prior to standardization</p></li>
<li><p>Use of <strong>ECMAScript</strong> language features prior to their runtime implementation</p></li>
<li><p>As of December 31, 2017, offering <strong>ECMAScript 2018</strong> with all <strong>BabelJS 6</strong> Stage 0 experimental plugins runnable on <strong>Node.js v6 LTS</strong></p></li>
</ul><p> </p></li>
<li><p><strong>es2049scripts</strong> package allows for build scripts to be written in <strong>ES.Next</strong>, solving an issue of the last four years:<br /><br /> Running the unrunnable <strong>ES.Next</strong> chicken-and-egg problem</p><p> </p></li>
<li><p><strong>ECMAScript 2049</strong> aligns with <strong>Agile Method</strong> to produce the best possible design at that point in time</li>
<li><p><strong>ECMAScript 2049</strong> keeps developers and engineers happy and programming <strong>ECMAScript</strong> fun</li>
<li><p><strong>ECMAScript 2049</strong> offers <strong>venture capital</strong> investment opportunities in new technology, as opposed to building companies on technology that is old and obsolete</li>
</ul>
<h2>Features</h2>
<ul>
<li><p><strong>es2049scripts</strong> package offering initial instant on-the-fly transpile for package.json scripts</p></li>
<li><p><strong>es2049package</strong> package allows for configuration-free implementation of libraries and command-line utilities</p></li>
<li><p>Runtime environments target:</p>
<ul>
<li><p>Default: <strong>Node.js 6.10 LTS maintenance</strong>, the version currently used by many deployment environments as of December 31, 2017</p></li>
<li><p>Active: <strong>Node.js 8.9 LTS Active</strong></p></li>
<li><p>Current: <strong>Node.js v8.6+</strong> executable using <strong>CommonJS</strong> module format</p></li>
<li><p>Latest: <strong>Node.js v8.6+</strong> using native experimental modules with extension <strong>.mjs</strong></p></li>
<li><p>Rollup: Pre-transpilation of <strong>RollupJS</strong> configuration data so that it, too, can be written is <strong>ES.Next</strong></p></li>
</ul></li>
</ul>
<h2>Usage</h2>
<p>Typical use is to have a <strong>configes</strong> direcory of <strong>ES.Next</strong> code that is on-the-fly transpiled into the <strong>config</strong> directory by the <strong>scripts</strong> entry of <strong>package.json</strong></p>
<p>Note: <strong>yarn</strong> is expected to be installed on the host</p>
<ol>
<li><p>Add <strong>es2049scripts</strong> to your project:</p>
<blockquote><strong>yarn add es2049scripts --dev</strong></blockquote></li>
<li><p>Add <strong>es2049scripts</strong> to a <strong>scripts</strong> entry in <strong>package.json</strong>:</p>
<blockquote><strong>"scripts": {<br />
 "start": "es2049scripts -- node config",<br />
…</strong></blockquote></li>
<li><p>Write some <strong>ES.Next</strong> code in <strong>configes/index.mjs:</strong></p>
<blockquote><strong>console.log('The next ReactJS version:')<br />
f()<br />
async function f () {<br />
 for await (let v of [Promise.resolve(17)])<br />
 console.log(v)<br />
}</strong></blockquote></li>
<li><p>Run!</p>
<blockquote><strong>yarn start</strong><br />
yarn run v1.3.2<br />
$ es2049scripts -- node config<br />
The next ReactJS version:<br />
17<br />
Done in 0.73s.</blockquote></li>
</ol>
<p>A package.json using <strong>es2049scripts</strong> can be found <strong><a href=https://github.com/haraldrudell/ECMAScript2049/blob/master/workspace/packages/es2049package/package.json>here</a></strong></p>
<p> </p>
<p><strong>es2049scripts</strong> transpiles .js and .mjs to .js or .mjs with target options <strong>‑current ‑active ‑latest ‑rollup.</strong></p>
<p>For more information, use:</p>
<blockquote><strong>yarn es2049scripts ‑help</strong><br />
es2049scripts [options] source-directory target-directory args…<br />
  version: 0.0.11<br />
 Transpiles from ES.Next to Node.js executable format<br />
  Default target is Node.js 6.12.3 maintenance Long Term Support<br />
  Transpiles .js and .mjs (may be renamed to .js), other files are copied<br />
  Actions may be skipped based on modification date<br />
<br />
 -active Target latest Node.js LTS: 8.9.4<br />
 -current Target the executing Node.js version, must be v8.6+, CommonJS modules<br />
 -latest Target the executing Node.js version --experimental-modules v8.6+<br />
  Extension .mjs is kept on output<br />
 -rollup Target transpile of rollup.config.js: for buble with import<br />
 -- Skip options parsing to args parameter<br />
<br />
 source-directory default: ./configes<br />
 target-directory default: ./config<br />
 args… Any command with arguments to be launched on transpile complete</strong></blockquote>
<p>Note om Rollup: rollup reading of configuration files does not support generators, therefore not async or dynamic imports. This means one cannot include ECMAScript containing generators for parsing, even if those are not used.</p>
<h2>Internal Triple-Transpile</h2>
<h3>Compiling ZeroTranspiler</h3>
<p>The ZeroTranspiler class is written in <strong>ES.Next</strong> and is only used by es2049scripts developers. The <em><strong>yarn transpilezero</strong></em> command uses the <strong>babel-cli</strong> package to transpile to Node 6 ECMAScript . The output, <strong>config/transpilezero.js</strong> is checked in.
<h3>Transpiling to config</h3>
<p>As soon as the zero transpiler has been compiled, it is used to transpile <strong>ES.Next</strong> code in <strong>configes</strong> and <strong>configrollup</strong> using the proper babel environment, this result is also checked in. At this point, the es2049scripts project can be built.</p>
<h3>Building es2049scripts</h3>
<p>The project is built in the usual way using the transpiled code in <strong>config</strong>
<h3>Transpiling the Consuming Project</h3>
<p>The consuming project invokes the <strong>es2049scripts</strong> executable that is built from the <strong>ES.Next</strong> code in <strong>src</strong>. The transpilation, typically into the consuming project’s config directory, uses modification dates to reduce work.
<h2>Requirements</h2>
<p>To develop or compile the <strong>ECMAScript 2049</strong> project <strong>Yarn</strong> 1+ and <strong>Node.js current</strong> (v8.5+) are required.</p>
<p><em><strong>yarn test</strong></em> tests that the built executable is runnable:</p>
<blockquote><strong>yarn build</strong><br />
…<br />
src/index.mjs → bin/es2049scripts...<br />
created bin/es2049scripts in 1.6s<br />
Done in 2.94s.<br />
<strong>yarn test</strong><br />
…<br />
Ran all test suites.<br />
Done in 1.91s.</strong></blockquote>
<p><em><strong>yarn testmjs</strong></em> tests that experimental module support appears to be working.</p>
<p><em><strong>yarn testProject</strong></em> executes tests in the <strong>es2049scripts-test</strong> project:</p>
<blockquote><strong>yarn testProject</strong><br />
…<br />
yarn install<br />
…<br />
yarn test<br />
…<br />
This file was transpiled with RollupJS and executed successfully.<br />
…<br />
yarn start<br />
$ es2049scripts -- node config<br />
The next ReactJS version:<br />
17<br />
ScriptsTester.test: code transpiled by es2049scripts executed successfully.<br />
Done in 14.72s.</strong></blockquote>
<p> </p>
<p>© <a href=http://haraldrudell.com>Harald Rudell</a> created <strong>ECMAScript 2049</strong> in December 2017. ISC License</p>