Refactor build tasks and config file

[mcaskill]

Refactored the structure of the configuration file and tasks to allow for greater flexibility.

Replaced legacy mconfig.json with new loconfig.json. Base paths, and proxy URL, are grouped under paths. Targets to process are grouped under tasks. Previously hardcoded, each task can now process multiple targets.

Added:

• glob.js: A proxy function to check if one of tiny-glob, globby, fast-glob, or glob is available and export their main function or a facade for interoperability.

  If packages are missing, throws an error.

  The globbing function is used by concats.js.

  The tiny-glob package is required by default (and can be replaced).

• postcss.js: A proxy function to check if autoprefixer and postcss are available and export the processor.

  If packages are missing, styles.js will still compile Sass to CSS.

  Both packages are required by default (and can be removed).

• template.js: A function to render template tags ({% ... %}) in task target paths using the paths from loconfig.json.

Changed:

• Tasks:
  • Moved concat.js, scripts.js, styles.js, svgs.js to new build/tasks/ directory.
  • Replaced fs (callback API) with fs/promises (promise API) to streamline readability and catching of errors and improve asynchronous processing of tasks.
  • Prefixed Node.js built-in modules with 'node:' URI scheme.
  • concats.js:
  • Renamed from concat.js to represent its new flexibility.
  • Refactored task to support concatenation of multiple groups of files (no longer limited to JS files) with support for glob patterns.
  • scripts.js:
  • Refactored task to support an array of targets (such as app.js) to iterate over to compile JS bundles.
  • styles.js:
  • Refactored task to support an array of targets (such as main.css and critical.css) to iterate over to compile Sass stylesheets.
  • Promisified sass.render.
  • Added support for PostCSS (and Autoprefixer) with support for source maps.
  • svgs.js:
  • Refactored task to support an array of targets (such as sprite.svg) to iterate over to compile SVG spritesheets.
• Utilities:
  • message.json:
  • Replaced if statements with switch for improved readability.
  • Added new types notice and warning.
  • Added support any message type to stop a timer, except for tje waiting type which will just log the current timer.
  • Improved appearance of message types.
  • notification.json:
  • Moved to build/utils/ directory.
  • Added support for all node-notifier options.
• watch.js:
  • Changed CSS and JS file-watcher to include all files in their respective directories.
  • Changed concatenation file-watcher to include all files in a group’s target paths.
• README.md:
  • Updated Configuration section with clearer instructions on what to rename for new projects.
  • Fixed Node constraint.
  • Cleaned-up Markdown syntax.
• scripts/modules/*.js:
  • Replaced unnecessary non-breaking space in import.

[devenini]

Just tested on my end 👌 The only thing I would correct is the extra ' in concat.js on line 46 ( concatenated' => concatenated).

[Jerek0]

Looks great! 👌

However it seems to be greedier than before, compilation times seems to be longer now on my end. Which I get for styles because of postcss & autoprefixer, but I don't understand for scripts 🤔