initial checkin

Author: db-developer

.conf/eslint/.eslintrc.js

@@ -0,0 +1,18 @@
+module.exports = {
+    "env": {
+        "browser": true,
+        "es6": true,
+        "node": true
+    },
+    "extends": "eslint:recommended",
+    "globals": {
+        "Atomics": "readonly",
+        "SharedArrayBuffer": "readonly"
+    },
+    "parserOptions": {
+        "ecmaVersion": 2018,
+        "sourceType": "module"
+    },
+    "rules": {
+    }
+};

.conf/grunt/check_outdated.js

@@ -0,0 +1,30 @@
+/**
+ *  © 2021, db-developer.
+ *  Licensed under the MIT license.
+ */
+
+module.exports = function ( grunt, options ) {
+  return {
+    target1: {
+      options: {
+        // cwd:           process.cwd(),      // working directory for nyc + mocha run
+        // dryrun:        false,              // dry run - do nothing just print cmd line
+        // quiet          false,
+        /* node: {
+          exec:           false,              // defaults to: process.execPath
+          opts:           false               // array of node options
+        }, */
+        checkoutdated: {
+          ignore: {
+            prereleases:      false,
+            devdependencies:  false,
+            packages:         [ "webpack" ]
+          },
+          columns:            [ "name" , "current", "wanted", "latest" ],
+          depth:              false,
+          global:             false
+        }
+      }
+    }
+  };
+};

.conf/grunt/clean.js

@@ -0,0 +1,18 @@
+/**
+ *  © 2020, db-developer.
+ *  Licensed under the MIT license.
+ */
+
+module.exports = function ( grunt, options ) {
+  return {
+    build: {
+      src: [ `${ options.BUILDDIR }/` ]
+    },
+    coverage: {
+      src: [ `${ options.COVERAGEDIR }/`, `${ options.TMPDIR }/` ]
+    },
+    dist: {
+      src: [ `${ options.DISTDIR }/*.tgz` ]
+    }
+  };
+};

.conf/grunt/copy.js

@@ -0,0 +1,53 @@
+/**
+ *  © 2020, db-developer.
+ *  Licensed under the MIT license.
+ */
+const path      = require( "path" );
+
+const LATEST    = "latest";
+const TGZ       = "tgz"
+
+module.exports  = function ( grunt, options ) {
+  const VERSION = options.package.version;
+  const PACKAGE = options.package.name.replace( "@", "" ).replace( "/", "-" );
+  const PKGSDIR = path.join( "..", "..", "_packages_" );
+
+  return {
+    build: {
+      files: [
+        {
+          src:  [ "*.md", "!CODEFOCONDUCT.md", "!package.json", "LICENSE" ],
+          dest: `${ options.BUILDDIR }/`
+        },{
+          expand: true,
+          cwd:    `${ options.DOCSDIR }/`,
+          src:    [ "**/*.md" ],
+          dest:   `${ options.BUILDDIR }/${ options.DOCSDIR }/`
+        },{
+          expand: true,
+          flatten: true,
+          filter: "isFile",
+          src:  [ `${ options.TASKSDIR }/*.js` ],
+          dest: `${ options.BUILDDIR }/tasks/`
+        }
+      ]
+    },
+    deploy: {
+      files: [
+        {
+          src:  `${ options.DISTDIR }/${ PACKAGE }-${ VERSION }.${ TGZ }`,
+          dest: `${ PKGSDIR }/${ PACKAGE }-${ VERSION }.${ TGZ }`
+        }, {
+          src:  `${ options.DISTDIR }/${ PACKAGE }-${ VERSION }.${ TGZ }`,
+          dest: `${ PKGSDIR }/${ PACKAGE }-${ LATEST  }.${ TGZ }`
+        }
+      ]
+    },
+    test: {
+      expand: true,
+      cwd:    `${ options.TEMPLATEDIR }/`,
+      src:    `*`,
+      dest:   `${ options.TMPDIR }/`
+    }
+  }
+};

.conf/grunt/eslint.js

@@ -0,0 +1,22 @@
+/**
+ *  © 2020, db-developer.
+ *  Licensed under the MIT license.
+ */
+const path        = require( "path" );
+
+const ESLINT      = "eslint";
+const ESLINTFILE  = `.${ ESLINT }rc.js`;
+const GRUNTFILE   = "gruntfile.js";
+
+module.exports = function ( grunt, options ) {
+
+  return {
+    options: {
+      configFile: path.join( options.CONFDIR, ESLINT, ESLINTFILE )
+    },
+    target: [
+      GRUNTFILE,
+      `${ options.LIBDIR }/**/*.js`
+    ]
+  }
+};

.conf/grunt/jsdoc2md.js

@@ -0,0 +1,19 @@
+/**
+ *  © 2020, db-developer.
+ *  Licensed under the MIT license.
+ */
+
+// Note: This is used for running tests only!
+module.exports = function ( grunt, options ) {
+  return {
+    api: {
+      src:      `${ options.LIBDIR }/**/*.js`,
+      dest:     `${ options.APIDIR }/`,
+      options: {
+        index: {
+          dest: `${ options.APIDIR }/../api.index.md`
+        }
+      }
+    }
+  };
+};

.conf/grunt/jsonfile.js

@@ -0,0 +1,25 @@
+/**
+ *  © 2020, db-developer.
+ *  Licensed under the MIT license.
+ */
+
+// Note: This is used for running tests only!
+module.exports = function ( grunt, options ) {
+  return {
+    options: {
+      templates: {
+        pkgjson:  "package.json",
+      }
+    },
+    build: {
+      template:   "pkgjson",
+      dest:       `${ options.BUILDDIR }/package.json`,
+      merge: {
+        "main":             "tasks/tasks.js",
+        "scripts":          undefined,
+        "peerDependencies": undefined,
+        "devDependencies":  undefined
+      }
+    }
+  };
+};

.conf/grunt/mkdir.js

@@ -0,0 +1,19 @@
+/**
+ *  © 2020, db-developer.
+ *  Licensed under the MIT license.
+ */
+
+module.exports = function ( grunt, options ) {
+  return {
+    all: {
+      options: {
+        mode:   0777,
+        create: [
+          options.BUILDDIR,
+          options.DISTDIR,
+          options.TMPDIR
+        ]
+      }
+    }
+  }
+};

.conf/grunt/move.js

@@ -0,0 +1,18 @@
+/**
+ *  © 2020, db-developer.
+ *  Licensed under the MIT license.
+ */
+const path      = require( "path" );
+
+const TGZSUFFIX = "*.tgz";
+
+module.exports  = function ( grunt, options ) {
+  const PKGSDIR = path.join( "..", "..", "_packages_" );
+
+  return {
+    distribute: {
+      src:  TGZSUFFIX,
+      dest: `${ options.DISTDIR }/`
+    }
+  };
+};

.conf/grunt/nyc_mocha.js

@@ -0,0 +1,35 @@
+/**
+ *  © 2020, db-developer.
+ *  Licensed under the MIT license.
+ */
+
+// Note: This is used for running tests only!
+module.exports = function ( grunt, options ) {
+  return {
+    test_and_coverage: {
+      src: `./src/test/**/*.spec.js`,                 // test suite to run...
+      options: {
+        nyc: {
+          coverage: {                                 // report nyc coverage results
+            dir:          "dist/coverage",            // ... to folder
+            reporter:     [                           // ... using reporters
+                            "html", "json", "lcov",
+                            "text-summary"
+                          ],
+            check:        true,
+            perfile:      true,
+            branches:     100,
+            functions:    100,
+            lines:        100,
+            statements:   100
+          },
+          excludes:       [ "gruntfile.js", ".conf/**/*.js", "src/test/**/*.js" ],
+          requires:       [ "grunt-nyc-mocha/scripts/sourcemapsupport" ]
+        },
+        mocha: {
+          color:          true                        // force colored output
+        }
+      }
+    }
+  }
+};