@mobilabs/es6lib 2.1.0 → 2.1.2

package/scripts/build.js.dev.js

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+/* *****************************************************************************
+ *
+ * Creates the JS bundle.
+ *
+ * build:js.dev script creates the JS bundle from ./public/src/main.js by importing
+ * all the linked src files;
+ *
+ * Private Functions:
+ *  . _help                       displays the help message,
+ *  . _clean                      removes the previous build,
+ *  . _docore                     creates the content of the library,
+ *  . _doumdlib                   creates the UMD Module,
+ *  . _domodule                   creates the ES6 module,
+ *  . _delcore                    removes the temp file(s),
+ *
+ *
+ * Public Static Methods:
+ *  . run                         executes the script,
+ *
+ *
+ * @namespace    -
+ * @dependencies none
+ * @exports      -
+ * @author       -
+ * @since        0.0.0
+ * @version      -
+ * ************************************************************************** */
+/* eslint one-var: 0, semi-style: 0, no-underscore-dangle: 0 */
+
+'use strict';
+
+// -- Vendor Modules
+const fs   = require('fs')
+    , nopt = require('nopt')
+    ;
+
+
+// -- Local Modules
+const pack   = require('../package.json')
+    , config = require('./config')
+    ;
+
+
+// -- Local Constants
+const VERSION     = '0.0.0-alpha.0'
+    , opts        = {
+      help: [Boolean, false],
+      version: [String, null],
+    }
+    , shortOpts   = {
+      h: ['--help'],
+      v: ['--version', VERSION],
+    }
+    , parsed      = nopt(opts, shortOpts, process.argv, 2)
+    , destination = config.libdir
+    , { ES6GLOB } = config
+    , source      = config.src
+    , { libname } = config
+    , { name }    = config
+    , head        = source[0]
+    , core        = source.slice(1, -1)
+    , foot        = source[source.length - 1]
+    , { version } = pack
+    ;
+
+
+// -- Local Variables
+
+
+// -- Private Functions --------------------------------------------------------
+
+/**
+ * Dispays the help message.
+ *
+ * @function ()
+ * @private
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _help() {
+  const message = ['',
+    'Usage: command [options]',
+    '',
+    '                       creates the js bundle from ./public/src/main.js',
+    '',
+    'Options:',
+    '',
+    '-h, --help             output usage information',
+    '-v, --version          output the version number',
+    '',
+  ].join('\n');
+
+  process.stdout.write(`${message}\n`);
+}
+
+/**
+ * Removes the previous build.
+ *
+ * @function ()
+ * @private
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _clean() {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mclean\x1b[89m\x1b[0m\'...\n');
+
+  fs.rmSync(destination, { force: true, recursive: true });
+  fs.mkdirSync(destination, { recursive: true });
+
+  const d2 = new Date() - d1;
+  process.stdout.write(`Finished '\x1b[36mclean\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+}
+
+/**
+ * Creates the content of the library.
+ *
+ * @function ()
+ * @private
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _docore() {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mdocore\x1b[89m\x1b[0m\'...\n');
+
+  let src = '';
+  for (let i = 0; i < core.length; i++) {
+    src += fs.readFileSync(core[i]);
+    if (i < core.length - 1) {
+      src += '\n';
+    }
+  }
+
+  src = src
+    .replace(/{{lib:name}}/g, libname)
+    .replace(/{{lib:version}}/g, version)
+    // remove the extra global and 'use strict':
+    .replace(/\/\* global[\w$_\s,]+\*\//g, '/* - */')
+    .replace(/\n'use strict';\n/g, '')
+    // indent the first line with 2 spaces:
+    .replace(/^/g, '  ')
+    // indent each other lines with 2 spaces:
+    .replace(/\n/g, '\n  ')
+  ;
+
+  fs.writeFileSync(`${destination}/core.js`, src);
+  const d2 = new Date() - d1;
+  process.stdout.write(`Finished '\x1b[36mdocore\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+}
+
+/**
+ * Creates the UMD Module.
+ *
+ * @function ()
+ * @private
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _doumdlib() {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mdoumdlib\x1b[89m\x1b[0m\'...\n');
+
+  let src = '';
+  src = fs.readFileSync(head);
+  src += '\n';
+  src += fs.readFileSync(`${destination}/core.js`);
+  src += '\n';
+  src += fs.readFileSync(foot);
+
+  src = src
+    .replace('{{lib:es6:define}}\n', '')
+    .replace('{{lib:es6:link}}', 'this')
+    .replace('{{lib:es6:export}}\n', '')
+    // fix the blanck lines we indented too:
+    .replace(/\s{2}\n/g, '\n')
+  ;
+
+  fs.writeFileSync(`${destination}/${name}.js`, src);
+  const d2 = new Date() - d1;
+  process.stdout.write(`Finished '\x1b[36mdoumdlib\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+}
+
+/**
+ * Creates the ES6 module.
+ *
+ * @function ()
+ * @private
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _domodule() {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mdomodule\x1b[89m\x1b[0m\'...\n');
+
+  let exportM = '\n// -- Export\n';
+  exportM += `export default ${ES6GLOB}.${libname};`;
+
+  let src = '';
+  src = fs.readFileSync(head);
+  src += '\n';
+  src += fs.readFileSync(`${destination}/core.js`);
+  src += '\n';
+  src += fs.readFileSync(foot);
+
+  src = src
+    .replace('{{lib:es6:define}}', `const ${ES6GLOB} = {};`)
+    .replace('{{lib:es6:link}}', ES6GLOB)
+    .replace('{{lib:es6:export}}', exportM)
+    // fix the blanck lines we indented too:
+    .replace(/\s{2}\n/g, '\n')
+  ;
+
+  fs.writeFileSync(`${destination}/${name}.mjs`, src);
+  const d2 = new Date() - d1;
+  process.stdout.write(`Finished '\x1b[36mdomodule\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+}
+
+/**
+ * Removes the temp file(s).
+ *
+ * @function ()
+ * @private
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _delcore() {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mdelcore\x1b[89m\x1b[0m\'...\n');
+  fs.unlinkSync(`${destination}/core.js`);
+
+  const d2 = new Date() - d1;
+  process.stdout.write(`Finished '\x1b[36mdelcore\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+}
+
+
+// -- Main ---------------------------------------------------------------------
+
+/**
+ * Executes the script.
+ *
+ * @function ()
+ * @public
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function run() {
+  if (parsed.help) {
+    _help();
+    return;
+  }
+
+  if (parsed.version) {
+    process.stdout.write(`version: ${parsed.version}\n`);
+    return;
+  }
+
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mbuild:js:dev\x1b[89m\x1b[0m\'...\n');
+
+  _clean();
+  _docore();
+  _doumdlib();
+  _domodule();
+  _delcore();
+
+  const d2 = new Date() - d1;
+  process.stdout.write(`Finished '\x1b[36mbuild:js:dev\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+}
+
+
+// Start script.
+run();
+
+
+// -- oOo --

package/scripts/build.js.prod.js

@@ -0,0 +1,294 @@
+#!/usr/bin/env node
+/* *****************************************************************************
+ *
+ * Creates the production JS files.
+ *
+ * build:js:prod.js script minifies JS files and copies them in the
+ * production folder.
+ *
+ * Private Functions:
+ *  . _help                       displays the help message,
+ *  . _clean                      removes the previous js production files,
+ *  . _copydev                    builds the js production file,
+ *  . _copydevm                   builds the ES6 module production file,
+ *  . _makeminified               builds and minifies the js production file,
+ *  . _makeminifiedm              builds and minifies the ES6 module production file,
+ *
+ *
+ * Public Static Methods:
+ *  . run                         executes the script,
+ *
+ *
+ * @namespace    -
+ * @dependencies none
+ * @exports      -
+ * @author       -
+ * @since        0.0.0
+ * @version      -
+ * ************************************************************************** */
+/* eslint one-var: 0, semi-style: 0, no-underscore-dangle: 0,
+  import/no-extraneous-dependencies: 0 */
+
+'use strict';
+
+// -- Vendor Modules
+const fs         = require('fs')
+    , nopt       = require('nopt')
+    , { minify } = require('terser')
+    ;
+
+
+// -- Local Modules
+const config = require('./config')
+    ;
+
+
+// -- Local Constants
+const VERSION     = '0.0.0-alpha.0'
+    , opts        = {
+      help: [Boolean, false],
+      version: [String, null],
+    }
+    , shortOpts   = {
+      h: ['--help'],
+      v: ['--version', VERSION],
+    }
+    , parsed      = nopt(opts, shortOpts, process.argv, 2)
+    , { dist }    = config
+    , { libdir }  = config
+    , { name }    = config
+    , { license } = config
+    ;
+
+
+// -- Local Variables
+
+
+// -- Private Functions --------------------------------------------------------
+
+/**
+ * Dispays the help message.
+ *
+ * @function ()
+ * @private
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _help() {
+  const message = ['',
+    'Usage: command [options]',
+    '',
+    '                       creates the js production files',
+    '',
+    'Options:',
+    '',
+    '-h, --help             output usage information',
+    '-v, --version          output the version number',
+    '',
+  ].join('\n');
+
+  process.stdout.write(`${message}\n`);
+}
+
+/**
+ * Removes the previous js production build.
+ *
+ * @function ()
+ * @private
+ * @param {}              -,
+ * @returns {}            -,
+ * @since 0.0.0
+ */
+function _clean() {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mclean\x1b[89m\x1b[0m\'...\n');
+
+  return new Promise((resolve) => {
+    fs.rm(`${dist}/lib`, { force: true, recursive: true }, (err1) => {
+      if (err1) throw new Error(err1);
+
+      fs.mkdir(`${dist}/lib`, { recursive: true }, (err2) => {
+        if (err2) throw new Error(err2);
+
+        const d2 = new Date() - d1;
+        process.stdout.write(`Finished '\x1b[36mclean\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+        resolve();
+      });
+    });
+  });
+}
+
+/**
+ * Builds the js production file.
+ *
+ * @function (arg1)
+ * @private
+ * @param {Function}        the function to call at the completion,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _copydev(done) {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mcopydev\x1b[89m\x1b[0m\'...\n');
+
+  fs.readFile(`${libdir}/${name}.js`, 'utf8', (err1, data) => {
+    if (err1) throw new Error(err1);
+
+    let content = license;
+    content += data;
+    fs.writeFile(`${dist}/lib/${name}.js`, content, { encoding: 'utf8' }, (err2) => {
+      if (err2) throw new Error(err2);
+
+      const d2 = new Date() - d1;
+      process.stdout.write(`Finished '\x1b[36mcopydev\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+      done();
+    });
+  });
+}
+
+/**
+ * Builds the ES6 module production file.
+ *
+ * @function (arg1)
+ * @private
+ * @param {Function}        the function to call at the completion,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _copydevm(done) {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mcopydevm\x1b[89m\x1b[0m\'...\n');
+
+  fs.readFile(`${libdir}/${name}.mjs`, 'utf8', (err1, data) => {
+    if (err1) throw new Error(err1);
+
+    let content = license;
+    content += data;
+    fs.writeFile(`${dist}/lib/${name}.mjs`, content, { encoding: 'utf8' }, (err2) => {
+      if (err2) throw new Error(err2);
+
+      const d2 = new Date() - d1;
+      process.stdout.write(`Finished '\x1b[36mcopydevm\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+      done();
+    });
+  });
+}
+
+/**
+ * Builds and minifies the js production file.
+ *
+ * @function (arg1)
+ * @private
+ * @param {Function}        the function to call at the completion,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _makeminified(done) {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mmakeminified\x1b[89m\x1b[0m\'...\n');
+
+  fs.readFile(`${libdir}/${name}.js`, 'utf8', (err1, data) => {
+    if (err1) throw new Error(err1);
+
+    let content = license;
+    content += data.replace(/\/\*! \*\*\*/g, '/** ***');
+
+    minify(content, {})
+      .then((result) => {
+        fs.writeFile(`${dist}/lib/${name}.min.js`, result.code, { encoding: 'utf8' }, (err2) => {
+          if (err2) throw new Error(err2);
+
+          const d2 = new Date() - d1;
+          process.stdout.write(`Finished '\x1b[36mmakeminified\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+          done();
+        });
+      });
+  });
+}
+
+/**
+ * Builds and minifies the ES6 module production file.
+ *
+ * @function (arg1)
+ * @private
+ * @param {Function}        the function to call at the completion,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+function _makeminifiedm(done) {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mmakeminified\x1b[89m\x1b[0m\'...\n');
+
+  fs.readFile(`${libdir}/${name}.mjs`, 'utf8', (err1, data) => {
+    if (err1) throw new Error(err1);
+
+    let content = license;
+    content += data.replace(/\/\*! \*\*\*/g, '/** ***');
+
+    minify(content, {})
+      .then((result) => {
+        fs.writeFile(`${dist}/lib/${name}.min.mjs`, result.code, { encoding: 'utf8' }, (err2) => {
+          if (err2) throw new Error(err2);
+
+          const d2 = new Date() - d1;
+          process.stdout.write(`Finished '\x1b[36mmakeminified\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+          done();
+        });
+      });
+  });
+}
+
+
+// -- Main ---------------------------------------------------------------------
+
+/**
+ * Executes the script.
+ *
+ * @function ()
+ * @public
+ * @param {}                -,
+ * @returns {}              -,
+ * @since 0.0.0
+ */
+async function run() {
+  const PENDING = 4;
+
+  if (parsed.help) {
+    _help();
+    return;
+  }
+
+  if (parsed.version) {
+    process.stdout.write(`version: ${parsed.version}\n`);
+    return;
+  }
+
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mbuild:js:prod\x1b[89m\x1b[0m\'...\n');
+
+  let pending = PENDING;
+  /**
+   * Executes done until completion.
+   */
+  function done() {
+    pending -= 1;
+    if (!pending) {
+      const d2 = new Date() - d1;
+      process.stdout.write(`Finished '\x1b[36mbuild:js:prod\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+    }
+  }
+
+  await _clean();
+  _copydev(done);
+  _copydevm(done);
+  _makeminified(done);
+  _makeminifiedm(done);
+}
+
+
+// Start script.
+run();
+
+
+// -- oOo --