balm-core 4.11.0 → 4.13.0

package/lib/bundler/webpack/entry.js

@@ -1,11 +1,9 @@
 import { HMR_PATH } from '../../config/constants.js';
 const FILENAME_REGEX = new RegExp('[^/]+$', 'i');
 const HOT_CLIENT = 'webpack-hot-middleware/client';
-
 function initVendors(entries) {
   const jsVendors = [];
   const jsEntries = [];
-
   for (const [key, value] of Object.entries(entries)) {
     if (BalmJS.utils.isArray(value)) {
       jsVendors.push({
@@ -19,12 +17,11 @@ function initVendors(entries) {
       });
     }
   }
-
   BalmJS.vendors = jsVendors;
   BalmJS.entries = jsEntries;
-} // Relative path
-
+}
 
+// Relative path
 function getEntry(input, scripts) {
   let webpackEntries = {};
   const hotOptions = Object.assign({}, BalmJS.config.server.hotOptions, {
@@ -32,18 +29,19 @@ function getEntry(input, scripts) {
   });
   const HMR = `${HOT_CLIENT}?` + Object.entries(hotOptions).map(option => option.join('=')).join('&');
   const useHMR = BalmJS.config.server.useHMR;
-
   if (BalmJS.utils.isObject(input)) {
     initVendors(input);
-
     for (const [key, value] of Object.entries(input)) {
-      const isVendor = BalmJS.utils.isArray(value); // Key
+      const isVendor = BalmJS.utils.isArray(value);
 
-      const entryKey = isVendor ? node.path.join(scripts.vendorName, key) : node.path.join(key); // Value
+      // Key
+      const entryKey = isVendor ? node.path.join(scripts.vendorName, key) : node.path.join(key);
 
+      // Value
       const hotValue = BalmJS.utils.isString(value) ? [value, HMR] : [...value, HMR];
-      const entryValue = useHMR ? hotValue : value; // Result
+      const entryValue = useHMR ? hotValue : value;
 
+      // Result
       if (!isVendor) {
         webpackEntries[entryKey] = entryValue;
       }
@@ -59,11 +57,9 @@ function getEntry(input, scripts) {
   } else {
     BalmJS.logger.warn('webpack entry', '`scripts.entry` must be `string | array | object`');
   }
-
   BalmJS.logger.debug('webpack entry', webpackEntries, {
     pre: true
   });
   return webpackEntries;
 }
-
 export default getEntry;

package/lib/bundler/webpack/index.js

@@ -4,7 +4,6 @@ import getOutput from './output.js';
 import getDefaultConfig from './config/index.js';
 const webpackModule = process.env.WEBPACK || requireModule.resolve('webpack');
 const webpack = requireModule(webpackModule);
-
 function webpackConfig(input, output, customWebpackOptions = {}, isHook = false) {
   const scripts = BalmJS.config.scripts;
   const defaultEntry = `./${BalmJS.file.defaultEntry}`;
@@ -18,18 +17,16 @@ function webpackConfig(input, output, customWebpackOptions = {}, isHook = false)
   }, {
     pre: true
   });
-
   if (scripts.externals) {
     baseConfig.externals = scripts.externals;
   }
-
   const defaultConfig = getDefaultConfig(webpack, scripts);
   const configuration = merge(baseConfig, defaultConfig, scripts.webpackOptions, customWebpackOptions);
   BalmJS.logger.success('webpack configuration', configuration, {
     pre: true
   });
   return configuration;
-} // export default webpackConfig;
-
+}
 
+// export default webpackConfig;
 export { webpack, webpackConfig };

package/lib/bundler/webpack/loaders.js

@@ -1,6 +1,5 @@
 import { mergeWithRules, CustomizeRule } from 'webpack-merge';
 import LOADERS from './rules/index.js';
-
 function getLoaders(customLoaders) {
   const enableDefaultLoaders = Object.assign({
     js: true,
@@ -10,14 +9,11 @@ function getLoaders(customLoaders) {
   }, BalmJS.config.scripts.defaultLoaders);
   const useDefaultLoaders = Object.values(enableDefaultLoaders).some(value => value);
   let defaultLoaders = [];
-
   if (useDefaultLoaders) {
     Object.values(LOADERS).forEach(Loader => {
       const key = Loader.name.replace('Loader', '');
-
       if (enableDefaultLoaders[key]) {
         const loader = Loader();
-
         if (BalmJS.utils.isArray(loader)) {
           defaultLoaders = defaultLoaders.concat(loader);
         } else {
@@ -26,7 +22,6 @@ function getLoaders(customLoaders) {
       }
     });
   }
-
   const result = mergeWithRules({
     module: {
       rules: {
@@ -52,5 +47,4 @@ function getLoaders(customLoaders) {
   });
   return defaultModule.rules;
 }
-
 export default getLoaders;

package/lib/bundler/webpack/output.js

@@ -1,17 +1,13 @@
 import { CHUNK, ASSET } from '../../config/constants.js';
-
 function getJsFilename(scripts, isChunk = false) {
   let filename;
-
   if (isChunk) {
     filename = BalmJS.config.env.isProd ? `[name].${CHUNK.hash}` : '[name]';
   } else {
     filename = scripts.useCache ? `[name].${CHUNK.hash}` : '[name]';
   }
-
   return `${filename}.js`;
 }
-
 function getOutput(output, scripts, isHook = false) {
   const outputDirectory = output || BalmJS.config.dest.base;
   const jsFolder = BalmJS.config.paths.target.js;
@@ -42,5 +38,4 @@ function getOutput(output, scripts, isHook = false) {
     publicPath: BalmJS.file.publicUrlOrPath
   }, customLibraryConfig, miniprogramConfig);
 }
-
 export default getOutput;

package/lib/bundler/webpack/rules/asset.js

@@ -1,8 +1,8 @@
 import { imgRegex, fontRegex, mediaRegex } from '../config/regex.js';
 import { ASSET } from '../../../config/constants.js';
-
 function assetLoader() {
-  return [// "url" loader works like "file" loader except that it embeds assets
+  return [
+  // "url" loader works like "file" loader except that it embeds assets
   // smaller than specified limit in bytes as data URLs to avoid requests.
   // A missing `test` is equivalent to a match.
   {
@@ -30,5 +30,4 @@ function assetLoader() {
     }
   }];
 }
-
 export default assetLoader;

package/lib/bundler/webpack/rules/babel.js

@@ -1,14 +1,14 @@
 import { jsRegex } from '../config/regex.js';
-
 function jsLoader() {
   const options = Object.assign({
     // This is a feature of `babel-loader` for webpack (not Babel itself).
     // It enables caching results in ./node_modules/.cache/babel-loader/
     // directory for faster rebuilds.
     cacheDirectory: true
-  }, BalmJS.config.scripts.babelLoaderOptions); // Process application JS with Babel.
-  // The preset includes JSX, Flow, TypeScript, and some ESnext features.
+  }, BalmJS.config.scripts.babelLoaderOptions);
 
+  // Process application JS with Babel.
+  // The preset includes JSX, Flow, TypeScript, and some ESnext features.
   return {
     test: jsRegex,
     include: [BalmJS.file.absPaths(BalmJS.config.src.js), ...BalmJS.config.scripts.includeJsResource],
@@ -16,5 +16,4 @@ function jsLoader() {
     options
   };
 }
-
 export default jsLoader;

package/lib/bundler/webpack/rules/css.js

@@ -1,6 +1,5 @@
 import MiniCssExtractPlugin from 'mini-css-extract-plugin';
 import { cssRegex, cssModuleRegex, sassRegex, sassModuleRegex } from '../config/regex.js';
-
 // common function to get style loaders
 function getStyleLoaders(styleLoader, cssOptions, preProcessor = '', sassOptions = {}) {
   const {
@@ -23,7 +22,6 @@ function getStyleLoaders(styleLoader, cssOptions, preProcessor = '', sassOptions
       sourceMap
     }, BalmJS.config.scripts.postcssLoaderOptions)
   }].filter(Boolean);
-
   if (preProcessor) {
     loaders.push({
       loader: requireModule.resolve(preProcessor),
@@ -32,10 +30,8 @@ function getStyleLoaders(styleLoader, cssOptions, preProcessor = '', sassOptions
       }, sassOptions)
     });
   }
-
   return loaders;
 }
-
 function cssLoader() {
   let styleLoader = {
     loader: requireModule.resolve('style-loader'),
@@ -43,10 +39,8 @@ function cssLoader() {
       esModule: BalmJS.config.scripts.useEsModule
     }
   };
-
   if (BalmJS.config.env.inSSR) {
     const loadersCount = BalmJS.config.scripts.loaders.length;
-
     for (let i = 0; i < loadersCount; i++) {
       if (BalmJS.config.scripts.loaders[i].loader === 'vue-loader') {
         styleLoader = 'vue-style-loader';
@@ -54,15 +48,15 @@ function cssLoader() {
       }
     }
   }
+  const sourceMap = BalmJS.config.env.isProd ? BalmJS.config.scripts.sourceMap : BalmJS.config.env.isDev;
 
-  const sourceMap = BalmJS.config.env.isProd ? BalmJS.config.scripts.sourceMap : BalmJS.config.env.isDev; // "postcss" loader applies autoprefixer to our CSS.
+  // "postcss" loader applies autoprefixer to our CSS.
   // "css" loader resolves paths in CSS and adds assets as dependencies.
   // "style" loader turns CSS into JS modules that inject <style> tags.
   // In production, we use MiniCSSExtractPlugin to extract that CSS
   // to a file, but in development "style" loader enables hot editing
   // of CSS.
   // By default we support CSS Modules with the extension .module.css
-
   return [{
     test: cssRegex,
     exclude: cssModuleRegex,
@@ -79,7 +73,8 @@ function cssLoader() {
     // Remove this when webpack adds a warning or an error for this.
     // See https://github.com/webpack/webpack/issues/6571
     sideEffects: true
-  }, // Opt-in support for SASS (using .scss or .sass extensions).
+  },
+  // Opt-in support for SASS (using .scss or .sass extensions).
   // By default we support SASS Modules with the
   // extensions .module.scss or .module.sass
   {
@@ -102,5 +97,4 @@ function cssLoader() {
     sideEffects: true
   }];
 }
-
 export default cssLoader;

package/lib/bundler/webpack/rules/html.js

@@ -1,5 +1,4 @@
 import { htmlRegex } from '../config/regex.js';
-
 function htmlLoader() {
   const options = Object.assign({
     minimize: {
@@ -13,5 +12,4 @@ function htmlLoader() {
     options
   };
 }
-
 export default htmlLoader;

package/lib/config/assets.js

@@ -1,11 +1,7 @@
 const root = 'assets'; // Remote project root simulation
-
 const mainDir = 'public'; // The `public` directory contains the front controller and your assets (images, JavaScript, CSS, etc.)
-
 const subDir = ''; // Public subdirectory
-
 const buildDir = 'build'; // The suffix of the `subDir`: for dynamic language project
-
 const virtualDir = ''; //  The prefix of the `subDir`: for non-standard dynamic language project
 
 const cache = false;
@@ -14,7 +10,6 @@ const cache = false;
  *
  * @reference https://github.com/smysnk/gulp-rev-all#options
  */
-
 const options = {
   fileNameManifest: 'rev-manifest.json',
   dontRenameFile: ['.html'],

package/lib/config/env.js

@@ -13,7 +13,6 @@ const ENV = {
 const isProd = NODE_ENV === ENV.PROD || argv.includes(`--${ENV.PROD}`) || argv.includes('-p');
 const isTest = NODE_ENV === ENV.TEST || argv.includes(`--${ENV.TEST}`) || argv.includes('-t');
 const isDev = !isProd && !isTest;
-
 if (!NODE_ENV) {
   if (isProd) {
     process.env.NODE_ENV = ENV.PROD;
@@ -23,7 +22,6 @@ if (!NODE_ENV) {
     process.env.NODE_ENV = ENV.DEV;
   }
 }
-
 const inSSR = NODE_ENV === ENV.SSR || argv.includes(`--${ENV.SSR}`) || argv.includes('-ssr');
 const isMP = NODE_ENV === ENV.MP || argv.includes(`--${ENV.MP}`) || argv.includes('-mp');
 const inDesktopApp = NODE_ENV === ENV.DESKTOP_APP || argv.includes(`--${ENV.DESKTOP_APP}`) || argv.includes('-electron');

package/lib/config/globals.js

@@ -3,25 +3,23 @@ import fs from 'node:fs';
 import colors from 'ansi-colors';
 import { create } from 'browser-sync';
 import through2 from 'through2';
-import PluginError from 'plugin-error'; // Set env var for ORIGINAL cwd before anything touches it
+import PluginError from 'plugin-error';
 
+// Set env var for ORIGINAL cwd before anything touches it
 process.env.BALM_CWD = process.env.INIT_CWD || process.cwd();
 const gulpModule = path.join(process.env.BALM_ROOT || process.env.BALM_CWD, 'node_modules', 'gulp', 'index.js');
-
 if (fs.existsSync(gulpModule)) {
   // Chdir before requiring balm config to make sure
   // we let them chdir as needed
   if (process.cwd() !== process.env.BALM_CWD) {
     process.chdir(process.env.BALM_CWD);
   }
-
   global.gulp = requireModule(gulpModule);
   global.$ = requireModule('gulp-load-plugins')();
 } else {
   console.error(colors.bgBlueBright('BalmJS'), colors.yellow('`balm` module not found :('));
   process.exit(1);
 }
-
 global.node = {
   path,
   fs
@@ -29,5 +27,4 @@ global.node = {
 global.server = create();
 global.through2 = through2;
 global.PluginError = PluginError;
-
 global.NOOP = () => {};

package/lib/config/index.js

@@ -13,7 +13,6 @@ import ftp from './ftp.js';
 import pwa from './pwa.js';
 import logs from './logs.js';
 var LogLevel;
-
 (function (LogLevel) {
   LogLevel[LogLevel["Trace"] = 0] = "Trace";
   LogLevel[LogLevel["Debug"] = 1] = "Debug";
@@ -21,15 +20,12 @@ var LogLevel;
   LogLevel[LogLevel["Warn"] = 3] = "Warn";
   LogLevel[LogLevel["Error"] = 4] = "Error";
 })(LogLevel || (LogLevel = {}));
-
 var Bundler;
-
 (function (Bundler) {
   Bundler["webpack"] = "webpack";
   Bundler["rollup"] = "rollup";
   Bundler["esbuild"] = "esbuild";
 })(Bundler || (Bundler = {}));
-
 const vendors = [];
 const workspace = process.env.BALM_CWD;
 /**
@@ -38,7 +34,6 @@ const workspace = process.env.BALM_CWD;
  * set `true` for a static HTML project
  * set `false` for a dynamic language project (e.g. PHP framework)
  */
-
 const inFrontend = true;
 const useDefaults = true; // Use balm default task
 

package/lib/config/logs.js

@@ -4,7 +4,6 @@ const level = 3;
  *
  * @reference https://github.com/nodejs/node/blob/master/doc/api/util.md#utilinspectobject-options
  */
-
 const formatOptions = {};
 export default {
   level,

package/lib/config/paths.js

@@ -12,8 +12,8 @@ const source = {
   font: 'fonts',
   // Font directory: `src/fonts`
   media: 'media' // Media directory: `src/media`
-
 };
+
 const tmp = {
   base: '',
   // `.tmp`
@@ -26,8 +26,8 @@ const tmp = {
   font: 'fonts',
   // `.tmp/fonts`
   media: 'media' // `.tmp/media`
-
 };
+
 const target = {
   base: '',
   // `dist`
@@ -40,8 +40,8 @@ const target = {
   font: 'font',
   // `dist/font`
   media: 'media' // `dist/media`
-
 };
+
 export default {
   source,
   tmp,

package/lib/config/pwa.js

@@ -1,16 +1,13 @@
 const enabled = false;
 const manifest = 'manifest.json'; // 'manifest.json' or 'manifest.webmanifest'
-
 const workboxSw = 'node_modules/workbox-sw/build/workbox-sw.js';
 const mode = 'generateSW'; // 'generateSW' or 'injectManifest'
-
 /**
  * Workbox Build options
  *
  * @reference https://developers.google.com/web/tools/workbox/modules/workbox-build#full_generatesw_config
  * @reference https://developers.google.com/web/tools/workbox/modules/workbox-build#full_injectmanifest_config
  */
-
 const options = {};
 const swSrcFilename = 'service-worker.js';
 const swDestFilename = 'sw.js';

package/lib/config/roots.js

@@ -1,7 +1,5 @@
 const source = 'src'; // Source code
-
 const tmp = '.tmp'; // Temporary precompiled assets
-
 const target = 'dist'; // The final distribution folder
 
 export default {

package/lib/config/scripts.js

@@ -6,7 +6,6 @@ const minify = false;
  *
  * @reference https://github.com/terser/terser#minify-options
  */
-
 const minifyOptions = {
   ecma: 5,
   parse: {
@@ -38,17 +37,18 @@ const minifyOptions = {
     // https://github.com/facebook/create-react-app/issues/2488
     ascii_only: true
   }
-}; // Entry and Context (webpack/esbuild common options)
-
+};
+// Entry and Context (webpack/esbuild common options)
 const entry = '';
 const lint = false;
+
 /**
  * Webpack bundler
  */
-// Output
-
-const library = ''; // Module
 
+// Output
+const library = '';
+// Module
 const loaders = [];
 const defaultLoaders = {};
 const includeJsResource = [];
@@ -58,41 +58,37 @@ const useEsModule = true;
  *
  * @reference https://github.com/babel/babel-loader#options
  */
-
 const babelLoaderOptions = {};
 /**
  * Styling: postcss-loader options
  *
  * @reference https://github.com/postcss/postcss-loader#options
  */
-
 const postcssLoaderOptions = {};
 /**
  * Template: html-loader options
  *
  * @reference https://github.com/webpack-contrib/html-loader#options
  */
-
 const htmlLoaderOptions = {};
 const imageAssetType = 'asset';
 const imageInlineSizeLimit = 8096; // 8kb
 // Resolve
-
 const extensions = [];
-const alias = {}; // Plugins
-
+const alias = {};
+// Plugins
 const plugins = [];
 const nodeEnv = {};
 const injectHtml = false;
 const htmlPluginOptions = {};
-const extractCss = false; // Devtool
-
-const sourceMap = false; // Target
-
-const target = ['web', 'es5']; // Externals
-
-const externals = ''; // Stats
-
+const extractCss = false;
+// Devtool
+const sourceMap = false;
+// Target
+const target = ['web', 'es5'];
+// Externals
+const externals = '';
+// Stats
 const stats = {
   colors: true,
   assets: true,
@@ -105,32 +101,28 @@ const stats = {
  *
  * @reference https://webpack.js.org/configuration/
  */
-
-const webpackOptions = {}; // Optimization
-
+const webpackOptions = {};
+// Optimization
 /**
  * Webpack optimizations for manual configuration and overrides
  *
  * @reference https://webpack.js.org/configuration/optimization/
  */
-
 const optimization = {};
 const extractAllVendors = false; // Extract all vendors (all in one)
-
 const vendorName = 'vendor'; // AllInOne vendor filename or Vendors folder name
 // IE8 compatibility
-
 const ie8 = false;
+
 /**
  * Rollup bundler
  */
-
 const inputOptions = {};
 const outputOptions = {};
+
 /**
  * Esbuild bundler
  */
-
 const buildOptions = {};
 const useTransform = false;
 const transformOptions = {};

package/lib/config/server.js

@@ -3,8 +3,8 @@ const host = null;
 const https = undefined;
 const open = false;
 const proxy = false; // Host: your.project.dev
-
-const serveStatic = [// {
+const serveStatic = [
+  // {
   //     route: '/public',
   //     dir: '/path/to/public'
   // }
@@ -14,23 +14,20 @@ const serveStatic = [// {
  *
  * @reference https://browsersync.io/docs/options
  */
-
 const options = {};
-const next = NOOP; // Middleware
-
+const next = NOOP;
+// Middleware
 /**
  * A development middleware for webpack
  *
  * @reference https://github.com/webpack/webpack-dev-middleware#options
  */
-
 const devOptions = {};
 /**
  * Webpack hot reloading
  *
  * @reference https://github.com/webpack-contrib/webpack-hot-middleware#config
  */
-
 const hotOptions = {
   reload: true,
   noInfo: true
@@ -66,17 +63,14 @@ const hotOptions = {
  *   }
  * }]
  */
-
 const proxyConfig = false;
 /**
  * HTML 5 history API
  *
  * @reference https://github.com/bripkens/connect-history-api-fallback#options
  */
-
 const historyOptions = false;
 const middlewares = []; // Extra middlewares for server
-
 const extraWatchFiles = []; // Just for `mix.serve`
 
 export default {

package/lib/config/styles.js

@@ -7,7 +7,6 @@ const entry = '';
  *
  * @reference https://cssnano.co/docs/optimisations/
  */
-
 const options = {
   discardComments: {
     removeAll: true
@@ -18,21 +17,18 @@ const options = {
  *
  * @reference https://github.com/sass/node-sass#options
  */
-
 const sassOptions = {};
 /**
  * Less plugin for Gulp
  *
  * @reference https://github.com/gulp-community/gulp-less#options
  */
-
 const lessOptions = {};
 /**
  * PostCSS Preset Env
  *
  * @reference https://github.com/csstools/postcss-preset-env#options
  */
-
 const postcssEnvOptions = {
   stage: 0,
   autoprefixer: {
@@ -44,19 +40,15 @@ const postcssEnvOptions = {
  *
  * @reference https://www.postcss.parts/
  */
-
-const postcssPlugins = []; // CSS Sprites
-
+const postcssPlugins = [];
+// CSS Sprites
 const imageBasePath = '../'; // Relative to css file
-
 const sprites = []; // Image folders
-
 const spriteRetina = false;
 /**
  * Spritesmith parameters
  * @reference https://github.com/twolfson/gulp.spritesmith#spritesmithparams
  */
-
 const spriteParams = {};
 export default {
   extname,

package/lib/hello.js

@@ -12,10 +12,8 @@ global.BalmJS = {
   emitter: new EventEmitter(),
   useCacache: +versions.node.split('.')[0] >= 18
 };
-
 if (!BalmJS.useCacache) {
   BalmJS.loading = true;
   cacheBalmCore();
 }
-
 export default balmCorePkg.version;