Merge branch 'dev'

Author: Itee

.czrc

@@ -0,0 +1,6 @@
+{
+  "path": "./node_modules/cz-emoji",
+  "config": {
+    "cz-emoji": {}
+  }
+}

.github/workflows/node.js.yml

@@ -32,7 +32,7 @@ jobs:
       - name: Install dependencies
         run: npm ci
       - name: Release
-        run: npm run clean && npm run lint && npm run doc && npm run build-test && npm run test
+        run: npm run build && npm run build-test && npm run lint && npm run test
 
   publish:
     needs: build

.gitignore

@@ -1,4 +1,5 @@
 /.idea/
 /node_modules/
 /tests/units/builds/
-/tests/benchmarks/builds/
+/tests/benchmarks/builds/
+/tests/bundles/

.releaserc

@@ -1,22 +1,101 @@
 {
-    "branch": "master",
-    "plugins": [
-        "@semantic-release/commit-analyzer",
-        "@semantic-release/release-notes-generator",
-        "@semantic-release/changelog",
-        "@semantic-release/npm",
-        "@semantic-release/github",
-        [
-            "@semantic-release/git",
-            {
-                "assets": [
-                    "builds/**",
-                    "docs/**",
-                    "package.json",
-                    "CHANGELOG.md"
-                ],
-                "message": "chore(release): v${nextRelease.version}"
-            }
-        ]
+  "branch": "master",
+  "plugins": [
+    [
+      "semantic-release-gitmoji",
+      {
+        "releaseRules": {
+          "major": [
+            ":boom:"
+          ],
+          "minor": [
+            ":sparkles:"
+          ],
+          "patch": [
+            ":art:",
+            ":zap:",
+            ":fire:",
+            ":bug:",
+            ":ambulance:",
+            ":pencil:",
+            ":rocket:",
+            ":lipstick:",
+            ":white_check_mark:",
+            ":lock:",
+            ":apple:",
+            ":penguin:",
+            ":checkered_flag:",
+            ":robot:",
+            ":green_apple:",
+            ":rotating_light:",
+            ":green_heart:",
+            ":arrow_down:",
+            ":pushpin:",
+            ":construction_worker:",
+            ":chart_with_upwards_trend:",
+            ":recycle:",
+            ":whale:",
+            ":heavy_plus_sign:",
+            ":heavy_minus_sign:",
+            ":wrench:",
+            ":globe_with_meridians:",
+            ":pencil2:",
+            ":poop:",
+            ":rewind:",
+            ":package:",
+            ":alien:",
+            ":truck:",
+            ":page_facing_up:",
+            ":bento:",
+            ":ok_hand:",
+            ":wheelchair:",
+            ":bulb:",
+            ":beers:",
+            ":speech_balloon:",
+            ":card_file_box:",
+            ":loud_sound:",
+            ":mute:",
+            ":busts_in_silhouette:",
+            ":children_crossing:",
+            ":building_construction:",
+            ":iphone:",
+            ":clown_face:",
+            ":see_no_evil:",
+            ":camera_flash:",
+            ":alembic:",
+            ":mag:",
+            ":wheel_of_dharma:",
+            ":label:",
+            ":seedling:",
+            ":dizzy:",
+            ":wastebasket:",
+            ":passport_control:",
+            ":adhesive_bandage:",
+            ":monocle_face:",
+            ":coffin:",
+            ":test_tube:",
+            ":necktie:",
+            ":stethoscope:",
+            ":bricks:",
+            ":technologist:"
+          ]
+        }
+      }
+    ],
+    "@semantic-release/changelog",
+    "@semantic-release/npm",
+    "@semantic-release/github",
+    [
+      "@semantic-release/git",
+      {
+        "assets": [
+          "builds/**",
+          "docs/**",
+          "package.json",
+          "CHANGELOG.md"
+        ],
+        "message": "chore(release): v${nextRelease.version}"
+      }
     ]
+  ]
 }

.tasks/_utils.mjs

@@ -0,0 +1,66 @@
+import {
+    join,
+    dirname
+}                        from 'path'
+import { readFileSync }  from 'fs'
+import { fileURLToPath } from 'url'
+
+// We cannot use directly the import.meta.dirname or filename because all IDE usage do not produce them
+// We use
+function getDirname() {
+
+    let __dirname
+
+    if ( import.meta.dirname ) {
+        __dirname = import.meta.dirname
+    } else if ( import.meta.filename ) {
+        __dirname = dirname( import.meta.filename )
+    } else if ( import.meta.url ) {
+        const __filename = fileURLToPath( import.meta.url )
+        __dirname        = dirname( __filename )
+    } else {
+        throw new Error( 'Unable to retrieve module dirname.' )
+    }
+
+    // Todo: distinguish between dirname and packageRootFolder to avoid misusing
+    __dirname = join( __dirname, '..' )
+
+    return __dirname
+
+}
+
+const __dirname    = getDirname()
+const packagePath  = join( __dirname, 'package.json' )
+const packageData  = readFileSync( packagePath )
+const packageInfos = JSON.parse( packageData )
+
+class Indenter {
+
+    _          = ''
+    __         = ''
+    ___        = ''
+    ____       = ''
+    _____      = ''
+    ______     = ''
+    _______    = ''
+    ________   = ''
+    _________  = ''
+    __________ = ''
+
+    constructor( indentationChar = '\t', maxIndentationLevel = 10 ) {
+
+        let currentProperty = '_'
+        for ( let currentIndentationLevel = 1 ; currentIndentationLevel <= maxIndentationLevel ; currentIndentationLevel++ ) {
+            this[ currentProperty ] = indentationChar.repeat( currentIndentationLevel )
+            currentProperty += '_'
+        }
+
+    }
+
+}
+
+export {
+    packageInfos,
+    Indenter,
+    getDirname
+}

.tasks/builds/build.mjs

@@ -0,0 +1,40 @@
+import rollupConfigurator from '../../configs/rollup.conf.js'
+import { rollup }         from 'rollup'
+import log                from 'fancy-log'
+import { getGulpConfigForTask } from '../../configs/gulp.conf.mjs'
+
+function build( done ) {
+
+    const options = getGulpConfigForTask('builds')
+    const configs = rollupConfigurator( options )
+
+    nextBuild()
+
+    function nextBuild( error ) {
+        'use strict'
+
+        if ( error ) {
+
+            done( error )
+
+        } else if ( configs.length === 0 ) {
+
+            done()
+
+        } else {
+
+            const config = configs.pop()
+            log( `Building ${ config.output.file }` )
+
+            rollup( config )
+                .then( ( bundle ) => { return bundle.write( config.output ) } )
+                .then( () => { nextBuild() } )
+                .catch( nextBuild )
+
+        }
+
+    }
+
+}
+
+export { build }

.tasks/cleans/clean.mjs

@@ -0,0 +1,20 @@
+import { getGulpConfigForTask } from '../../configs/gulp.conf.mjs'
+import { deleteAsync }          from 'del'
+import log                      from 'fancy-log'
+import colors                   from 'ansi-colors'
+
+const red = colors.red
+
+function clean( done ) {
+
+    const filesToClean = getGulpConfigForTask( 'clean' )
+
+    for ( let fileIndex = 0, numberOfFiles = filesToClean.length ; fileIndex < numberOfFiles ; fileIndex++ ) {
+        log( red( `[${ fileIndex + 1 }/${ numberOfFiles }] Delete ${ filesToClean[ fileIndex ] }` ) )
+    }
+
+    return deleteAsync( filesToClean )
+
+}
+
+export { clean }

.tasks/docs/doc.mjs

@@ -0,0 +1,37 @@
+import log                      from 'fancy-log'
+import jsdocConfiguration       from '../../configs/jsdoc.conf.js'
+import { getGulpConfigForTask } from '../../configs/gulp.conf.mjs'
+import gulp                     from 'gulp'
+import jsdoc                    from 'gulp-jsdoc3'
+
+
+async function doc( done ) {
+
+    const config     = jsdocConfiguration
+    const filesToDoc = getGulpConfigForTask( 'doc' )
+
+    for ( let fileIndex = 0, numberOfFiles = filesToDoc.length ; fileIndex < numberOfFiles ; fileIndex++ ) {
+        log( `[${ fileIndex + 1 }/${ numberOfFiles }] Documenting ${ filesToDoc[ fileIndex ] }` )
+    }
+
+    // gulp
+    //     .src( filesToDoc, {
+    //         read:       false,
+    //         allowEmpty: true
+    //     } )
+    //     .pipe( jsdoc( config, done ) )
+    //     .on( 'error', done )
+
+    await new Promise( ( ( resolve, reject ) => {
+        gulp.src( filesToDoc, {
+            read:       false,
+            allowEmpty: true
+        } )
+            .pipe( jsdoc( config, resolve ) )
+            .on( 'error', reject )
+    } ) )
+    done()
+
+}
+
+export { doc }