@mobilabs/es6lib 2.1.3 → 2.2.1

package/_dist/lib/es6lib.js

@@ -1,5 +1,5 @@
 /*! ****************************************************************************
- * ES6lib v2.1.3
+ * ES6lib v2.2.1
  *
  * A template for writing pure ES6 Javascript libraries.
  * (you can download it from npm or github repositories)
@@ -313,14 +313,14 @@
       const obj = Object.create(methods);
       obj._library = {
         name: 'ES6lib',
-        version: '2.1.3',
+        version: '2.2.1',
       };
       return obj;
     };
 
     // Attaches constants to ES6lib that provide name and version of the lib.
     ES6lib.NAME = 'ES6lib';
-    ES6lib.VERSION = '2.1.3';
+    ES6lib.VERSION = '2.2.1';
 
 
     // -- Private Static Methods -----------------------------------------------

package/_dist/lib/es6lib.min.js

@@ -1,5 +1,5 @@
 /*! ****************************************************************************
- * ES6lib v2.1.3
+ * ES6lib v2.2.1
  *
  * A template for writing pure ES6 Javascript libraries.
  * (you can download it from npm or github repositories)
@@ -8,4 +8,4 @@
  * at: http://www.opensource.org/licenses/mit-license.php).
  * Built from {{boiler:name}} v{{boiler:name:version}}.
  * ************************************************************************** */
-!function(t,e){"use strict";"function"==typeof define&&define.amd?define([""],e):"object"==typeof exports?module.exports=e(t):t.ES6lib=e(t)}(this,(t=>{"use strict";let e,n;const i={Public:{}};return n=function(t,e){const n=Object.keys(e);for(let i=0;i<n.length;i++)t[n[i]]=e[n[i]]},function(){const t=i.Public;n(t,{getString:()=>"I am a string!",getArray:()=>[1,2,3]})}(),function(){const n=i.Public,r=t.ES6lib;let o;e=function(){const t=Object.create(o);return t._library={name:"ES6lib",version:"2.1.3"},t},e.NAME="ES6lib",e.VERSION="2.1.3",e._setTestMode=function(){return[]},e.noConflict=function(){return t.ES6lib=r,this},o={whoami(){return this._library},getString:()=>n.getString(),getArray:()=>n.getArray()}}(),e}));
+!function(t,e){"use strict";"function"==typeof define&&define.amd?define([""],e):"object"==typeof exports?module.exports=e(t):t.ES6lib=e(t)}(this,(t=>{"use strict";let e,n;const i={Public:{}};return n=function(t,e){const n=Object.keys(e);for(let i=0;i<n.length;i++)t[n[i]]=e[n[i]]},function(){const t=i.Public;n(t,{getString:()=>"I am a string!",getArray:()=>[1,2,3]})}(),function(){const n=i.Public,r=t.ES6lib;let o;e=function(){const t=Object.create(o);return t._library={name:"ES6lib",version:"2.2.1"},t},e.NAME="ES6lib",e.VERSION="2.2.1",e._setTestMode=function(){return[]},e.noConflict=function(){return t.ES6lib=r,this},o={whoami(){return this._library},getString:()=>n.getString(),getArray:()=>n.getArray()}}(),e}));

package/_dist/lib/es6lib.min.mjs

@@ -1,5 +1,5 @@
 /*! ****************************************************************************
- * ES6lib v2.1.3
+ * ES6lib v2.2.1
  *
  * A template for writing pure ES6 Javascript libraries.
  * (you can download it from npm or github repositories)
@@ -8,4 +8,4 @@
  * at: http://www.opensource.org/licenses/mit-license.php).
  * Built from {{boiler:name}} v{{boiler:name:version}}.
  * ************************************************************************** */
-const $__ES6GLOB={};!function(t,e){"use strict";"function"==typeof define&&define.amd?define([""],e):"object"==typeof exports?module.exports=e(t):t.ES6lib=e(t)}($__ES6GLOB,(t=>{"use strict";let e,n;const i={Public:{}};return n=function(t,e){const n=Object.keys(e);for(let i=0;i<n.length;i++)t[n[i]]=e[n[i]]},function(){const t=i.Public;n(t,{getString:()=>"I am a string!",getArray:()=>[1,2,3]})}(),function(){const n=i.Public,r=t.ES6lib;let o;e=function(){const t=Object.create(o);return t._library={name:"ES6lib",version:"2.1.3"},t},e.NAME="ES6lib",e.VERSION="2.1.3",e._setTestMode=function(){return[]},e.noConflict=function(){return t.ES6lib=r,this},o={whoami(){return this._library},getString:()=>n.getString(),getArray:()=>n.getArray()}}(),e}));export default $__ES6GLOB.ES6lib;
+const $__ES6GLOB={};!function(t,e){"use strict";"function"==typeof define&&define.amd?define([""],e):"object"==typeof exports?module.exports=e(t):t.ES6lib=e(t)}($__ES6GLOB,(t=>{"use strict";let e,n;const i={Public:{}};return n=function(t,e){const n=Object.keys(e);for(let i=0;i<n.length;i++)t[n[i]]=e[n[i]]},function(){const t=i.Public;n(t,{getString:()=>"I am a string!",getArray:()=>[1,2,3]})}(),function(){const n=i.Public,r=t.ES6lib;let o;e=function(){const t=Object.create(o);return t._library={name:"ES6lib",version:"2.2.1"},t},e.NAME="ES6lib",e.VERSION="2.2.1",e._setTestMode=function(){return[]},e.noConflict=function(){return t.ES6lib=r,this},o={whoami(){return this._library},getString:()=>n.getString(),getArray:()=>n.getArray()}}(),e}));export default $__ES6GLOB.ES6lib;

package/_dist/lib/es6lib.mjs

@@ -1,5 +1,5 @@
 /*! ****************************************************************************
- * ES6lib v2.1.3
+ * ES6lib v2.2.1
  *
  * A template for writing pure ES6 Javascript libraries.
  * (you can download it from npm or github repositories)
@@ -314,14 +314,14 @@ const $__ES6GLOB = {};
       const obj = Object.create(methods);
       obj._library = {
         name: 'ES6lib',
-        version: '2.1.3',
+        version: '2.2.1',
       };
       return obj;
     };
 
     // Attaches constants to ES6lib that provide name and version of the lib.
     ES6lib.NAME = 'ES6lib';
-    ES6lib.VERSION = '2.1.3';
+    ES6lib.VERSION = '2.2.1';
 
 
     // -- Private Static Methods -----------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobilabs/es6lib",
-  "version": "2.1.3",
+  "version": "2.2.1",
   "description": "A template for writing pure ES6 Javascript libraries",
   "main": "index.js",
   "minified": "_dist/lib/es6lib.min.js",
@@ -12,18 +12,18 @@
   "scripts": {
     "general": " --- GENERAL ---",
 
-    "build:js": " --- JAVASCRIPT --- ",
+    "build:js": " --- BUILDING JAVASCRIPT --- ",
     "build:js:dev": "node scripts/build.js.dev.js $1",
     "build:js:prod": "node scripts/build.js.prod.js $1",
 
-    "build:css": " --- CSS --- ",
+    "build:css": " --- BUILDING CSS --- ",
 
-    "build:generic": " --- BUILD (GENERIC) --- ",
+    "build:generic": " --- BUILDING (GENERIC) --- ",
 
-    "build:development": " --- BUILD (DEVELOPMENT) --- ",
+    "build:development": " --- BUILDING (DEVELOPMENT) --- ",
     "build:dev": "npm run build:js:dev",
 
-    "build:production": " --- BUILD (PRODUCTION) --- ",
+    "build:production": " --- BUILDING (PRODUCTION) --- ",
     "build:skeleton:prod": "node scripts/build.skeleton.prod.js $1",
     "prebuild:prod": "npm run build:dev && npm run build:skeleton:prod",
     "build:prod": "npm run build:js:prod",
@@ -42,14 +42,13 @@
     "watch:js": "nodemon --watch './src/**/*.js' --exec npm run build:dev",
     "watch": "npm run watch:js",
 
-    "deployment": " --- DEPLOYMENT --- ",
+    "deployment": " --- DEPLOYING --- ",
     "dep:prod": "rm -rf _dist-$npm_package_version && npm run build:prod && cp -r _dist _dist-$npm_package_version",
     "dep:private:package": "npm run build:prod && node scripts/dep.private.js && sh scripts/compress.sh ${npm_package_name} ${npm_package_version} @mobilabs",
-    "dep:npm:private:package": "npm pack && sh scripts/dep.npm.private.sh ${npm_package_name} ${npm_package_version} @mobilabs",
+    "dep:npm:private:package": "npm run build:prod && npm pack && sh scripts/dep.npm.private.sh ${npm_package_name} ${npm_package_version} @mobilabs",
 
     "others": " --- OTHERS ---",
-    "prepare": "husky install",
-    "doc": ""
+    "prepare": "husky install"
   },
   "repository": {
     "type": "git",
@@ -85,6 +84,7 @@
     "eslint": "^8.56.0",
     "eslint-config-airbnb-base": "^15.0.0",
     "eslint-plugin-import": "^2.29.1",
+    "http-server": "^14.1.1",
     "husky": "^8.0.3",
     "mocha": "^10.2.0",
     "nodemon": "^3.0.2",

package/scripts/_old_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/_old_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 --

package/scripts/build.js.dev.js

@@ -9,10 +9,10 @@
  * 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),
+ *  . _doES6                      creates the ES6 module,
+ *  . _doUMD                      creates the UMD library,
+ *  . _doLib                      creates one UMD/ES6 library,
+ *  . _doLibs                     creates all UMD/ES6 libraries,
  *
  *
  * Public Static Methods:
@@ -55,12 +55,9 @@ const VERSION     = '0.0.0-alpha.0'
     , parsed      = nopt(opts, shortOpts, process.argv, 2)
     , destination = config.libdir
     , { ES6GLOB } = config
-    , source      = config.src
+    , { src }     = config
     , { libname } = config
     , { name }    = config
-    , head        = source[0]
-    , core        = source.slice(1, -1)
-    , foot        = source[source.length - 1]
     , { version } = pack
     ;
 
@@ -98,82 +95,96 @@ function _help() {
 /**
  * Removes the previous build.
  *
- * @function ()
+ * @function (arg1)
  * @private
- * @param {}                -,
+ * @param {Function}        the function to call at the completion,
  * @returns {}              -,
  * @since 0.0.0
  */
-function _clean() {
+function _clean(done) {
   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 });
+  return new Promise((resolve) => {
+    fs.rm(destination, { force: true, recursive: true }, (err1) => {
+      if (err1) throw new Error(err1);
 
-  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`);
+      fs.mkdir(destination, { 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();
+        if (done) done();
+      });
+    });
+  });
 }
 
 /**
- * Creates the content of the library.
+ * Creates the ES6 module.
  *
- * @function ()
+ * @function (arg1, arg2, arg3, arg4)
  * @private
- * @param {}                -,
+ * @param {String}          the header of the library,
+ * @param {String}          the content of the library,
+ * @param {String}          the footer of the library,
+ * @param {Function}        the function to call at the completion,
  * @returns {}              -,
  * @since 0.0.0
  */
-function _docore() {
+function _doES6(head, core, foot, done) {
   const d1 = new Date();
-  process.stdout.write('Starting \'\x1b[36mdocore\x1b[89m\x1b[0m\'...\n');
+  process.stdout.write('Starting \'\x1b[36mdo:es6\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';
-    }
-  }
+  let exportM = '\n// -- Export\n';
+  exportM += `export default ${ES6GLOB}.${libname};`;
 
-  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  ')
+  let lib = head;
+  lib += '\n';
+  lib += core;
+  lib += '\n';
+  lib += foot;
+
+  lib = lib
+    .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}/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`);
+  fs.writeFile(`${destination}/${name}.mjs`, lib, { encoding: 'utf8' }, (err) => {
+    if (err) throw new Error(err);
+    const d2 = new Date() - d1;
+    process.stdout.write(`Finished '\x1b[36mdo:es6\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+    done();
+  });
 }
 
 /**
- * Creates the UMD Module.
+ * Creates the UMD library.
  *
- * @function ()
+ * @function (arg1, arg2, arg3, arg4)
  * @private
- * @param {}                -,
+ * @param {String}          the header of the library,
+ * @param {String}          the content of the library,
+ * @param {String}          the footer of the library,
+ * @param {Function}        the function to call at the completion,
  * @returns {}              -,
  * @since 0.0.0
  */
-function _doumdlib() {
+function _doUMD(head, core, foot, done) {
   const d1 = new Date();
-  process.stdout.write('Starting \'\x1b[36mdoumdlib\x1b[89m\x1b[0m\'...\n');
+  process.stdout.write("Starting '\x1b[36mdo:umd\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);
+  let lib = head;
+  lib += '\n';
+  lib += core;
+  lib += '\n';
+  lib += foot;
 
-  src = src
+  lib = lib
     .replace('{{lib:es6:define}}\n', '')
     .replace('{{lib:es6:link}}', 'this')
     .replace('{{lib:es6:export}}\n', '')
@@ -181,63 +192,90 @@ function _doumdlib() {
     .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`);
+  fs.writeFile(`${destination}/${name}.js`, lib, { encoding: 'utf8' }, (err) => {
+    if (err) throw new Error(err);
+    const d2 = new Date() - d1;
+    process.stdout.write(`Finished '\x1b[36mdo:umd\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+    done();
+  });
 }
 
 /**
- * Creates the ES6 module.
+ * Creates one UMD/ES6 library.
  *
- * @function ()
+ * @function (arg1, arg2)
  * @private
- * @param {}                -,
+ * @param {Array}           the files defining the library,
+ * @param {Function}        the function to call at the completion,
  * @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};`;
+function _doLib(source, done) {
+  const head = fs.readFileSync(source[0])
+      , core = source.slice(1, -1)
+      , foot = fs.readFileSync(source[source.length - 1])
+      ;
 
-  let src = '';
-  src = fs.readFileSync(head);
-  src += '\n';
-  src += fs.readFileSync(`${destination}/core.js`);
-  src += '\n';
-  src += fs.readFileSync(foot);
+  let content = '';
+  for (let i = 0; i < core.length; i++) {
+    content += fs.readFileSync(core[i]);
+    if (i < core.length - 1) {
+      content += '\n';
+    }
+  }
 
-  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')
+  content = content
+    .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}/${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`);
+  // For testing purpose:
+  // fs.writeFileSync(`${destination}/${name}-${suffix}-core.js`, src);
+
+  /**
+   * Waits until completion.
+   */
+  let count = 2;
+  function _next() {
+    count -= 1;
+    if (!count) {
+      done();
+    }
+  }
+  _doUMD(head, content, foot, _next);
+  _doES6(head, content, foot, _next);
 }
 
 /**
- * Removes the temp file(s).
+ * Creates all UMD/ES6 libraries.
  *
- * @function ()
+ * @function (arg1)
  * @private
- * @param {}                -,
+ * @param {Function}        the function to call at the completion,
  * @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`);
+function _doLibs(done) {
+  let pending = 1;
+  /**
+   * Waits until completion.
+   */
+  function _next() {
+    pending -= 1;
+    if (!pending) {
+      done();
+    }
+  }
 
-  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`);
+  _doLib(src, () => {
+    _next();
+  });
 }
 
 
@@ -266,14 +304,12 @@ function run() {
   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`);
+  _clean(() => {
+    _doLibs(() => {
+      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`);
+    });
+  });
 }
 
 

package/scripts/build.js.prod.js

@@ -9,10 +9,11 @@
  * 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,
+ *  . _makeminified               builds and minifies the js production file,
+ *  . _copydevm                   builds the ES6 module production file,
+ *  . _copydev                    builds the js production file,
+ *  . _doLibs                     builds the js production libraries,
  *
  *
  * Public Static Methods:
@@ -94,13 +95,13 @@ function _help() {
 /**
  * Removes the previous js production build.
  *
- * @function ()
+ * @function (arg1)
  * @private
- * @param {}              -,
- * @returns {}            -,
+ * @param {Function}        the function to call at the completion,
+ * @returns {}              -,
  * @since 0.0.0
  */
-function _clean() {
+function _clean(done) {
   const d1 = new Date();
   process.stdout.write('Starting \'\x1b[36mclean\x1b[89m\x1b[0m\'...\n');
 
@@ -114,13 +115,14 @@ function _clean() {
         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();
+        if (done) done();
       });
     });
   });
 }
 
 /**
- * Builds the js production file.
+ * Builds and minifies the ES6 module production file.
  *
  * @function (arg1)
  * @private
@@ -128,22 +130,58 @@ function _clean() {
  * @returns {}              -,
  * @since 0.0.0
  */
-function _copydev(done) {
+function _makeminifiedm(done) {
+  const d1 = new Date();
+  process.stdout.write('Starting \'\x1b[36mmake:minified:es6\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[36mmake:minified:es6\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[36mcopydev\x1b[89m\x1b[0m\'...\n');
+  process.stdout.write('Starting \'\x1b[36mmake:minified:umd\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);
+    content += data.replace(/\/\*! \*\*\*/g, '/** ***');
 
-      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();
-    });
+    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[36mmake:minified:umd\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+          done();
+        });
+      });
   });
 }
 
@@ -158,7 +196,7 @@ function _copydev(done) {
  */
 function _copydevm(done) {
   const d1 = new Date();
-  process.stdout.write('Starting \'\x1b[36mcopydevm\x1b[89m\x1b[0m\'...\n');
+  process.stdout.write("Starting '\x1b[36mcopy:es6\x1b[89m\x1b[0m'...\n");
 
   fs.readFile(`${libdir}/${name}.mjs`, 'utf8', (err1, data) => {
     if (err1) throw new Error(err1);
@@ -169,14 +207,14 @@ function _copydevm(done) {
       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`);
+      process.stdout.write(`Finished '\x1b[36mcopy:es6\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
       done();
     });
   });
 }
 
 /**
- * Builds and minifies the js production file.
+ * Builds the js production file.
  *
  * @function (arg1)
  * @private
@@ -184,31 +222,27 @@ function _copydevm(done) {
  * @returns {}              -,
  * @since 0.0.0
  */
-function _makeminified(done) {
+function _copydev(done) {
   const d1 = new Date();
-  process.stdout.write('Starting \'\x1b[36mmakeminified\x1b[89m\x1b[0m\'...\n');
+  process.stdout.write("Starting '\x1b[36mcopy:umd\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);
+    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[36mmakeminified\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
-          done();
-        });
-      });
+      const d2 = new Date() - d1;
+      process.stdout.write(`Finished '\x1b[36mcopy:umd\x1b[89m\x1b[0m' after \x1b[35m${d2} ms\x1b[89m\x1b[0m\n`);
+      done();
+    });
   });
 }
 
 /**
- * Builds and minifies the ES6 module production file.
+ * Builds the js production libraries.
  *
  * @function (arg1)
  * @private
@@ -216,27 +250,22 @@ function _makeminified(done) {
  * @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);
+function _doLibs(done) {
+  let pending = 4;
+  /**
+   * Executes done until completion.
+   */
+  function _next() {
+    pending -= 1;
+    if (!pending) {
+      done();
+    }
+  }
 
-          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();
-        });
-      });
-  });
+  _copydev(_next);
+  _copydevm(_next);
+  _makeminified(_next);
+  _makeminifiedm(_next);
 }
 
 
@@ -252,7 +281,7 @@ function _makeminifiedm(done) {
  * @since 0.0.0
  */
 async function run() {
-  const PENDING = 4;
+  const PENDING = 1;
 
   if (parsed.help) {
     _help();
@@ -280,10 +309,7 @@ async function run() {
   }
 
   await _clean();
-  _copydev(done);
-  _copydevm(done);
-  _makeminified(done);
-  _makeminifiedm(done);
+  _doLibs(done);
 }
 
 

package/test/index.html

@@ -1,22 +1,19 @@
-<!-- x -->
 <!doctype html>
 <html class="no-js" lang="">
   <head>
     <meta charset="utf-8">
-    <title>View ES6lib</title>
-    <meta name="description" content="{{app:description}}">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-
+    <title>View ES6lib</title>
     <link rel="stylesheet" href="">
-    <meta name="theme-color" content="#2196f3">
+    <meta name="description" content="">
+    <meta name="theme-color" content="#fafafa">
+
     <style>
       /* - */
     </style>
-
-    <!-- <script src='./lib/view.js'></script> -->
     <script>
       document.addEventListener('DOMContentLoaded', () => {
-        /* global Pixi */
+        /* global ... */
         'use strict';
         //
       });
@@ -24,16 +21,8 @@
   </head>
 
   <body>
-    <!--[if IE]>
-      <p class="browserupgrade">You are using an <strong>outdated and unsupported</strong> browser. Please <a href="https://browsehappy.com/">upgrade your browser</a> to benefit of all the features of this web App.</p>
-    <![endif]-->
-
     <!-- Warning message if Javascript isn't enabled -->
-    <noscript>
-      <p style="text-align:center;padding-top:3em;">
-        We are sorry, but this website doesn't work properly without JavaScript enabled!
-      </p>
-    </noscript>
+    <noscript><p style="text-align:center;padding-top:3em;">We are sorry, but this website doesn't work properly without JavaScript enabled!</p></noscript>
 
     <!-- Add your site or application content here -->
     <div id="app"></div>
@@ -53,7 +42,6 @@
       el.append(`Es6lib v${ES6lib.VERSION}`);
       el.append(`   ... ${lib.getString()}`);
       el.append(`   ... ${lib.getArray()}`);
-
     </script>
   </body>
 </html>