balm-core 5.2.0 → 6.0.0-alpha.1

package/lib/config/logs.js

@@ -1,11 +0,0 @@
-const level = 3;
-/**
- * Node.js - util.inspect(object[, options])
- *
- * @reference https://github.com/nodejs/node/blob/master/doc/api/util.md#utilinspectobject-options
- */
-const formatOptions = {};
-export default {
-  level,
-  formatOptions
-};

package/lib/config/paths.js

@@ -1,46 +0,0 @@
-const source = {
-  base: '',
-  // Project directory
-  html: '',
-  // HTML template directory: `src`
-  css: 'styles',
-  // Stylesheet directory: `src/styles`
-  js: 'scripts',
-  // Javascript directory: `src/scripts`
-  img: 'images',
-  // Image directory: `src/images`
-  font: 'fonts',
-  // Font directory: `src/fonts`
-  media: 'media' // Media directory: `src/media`
-};
-const tmp = {
-  base: '',
-  // `.tmp`
-  css: 'css',
-  // `.tmp/css`
-  js: 'js',
-  // `.tmp/js`
-  img: 'img',
-  // `.tmp/img`
-  font: 'fonts',
-  // `.tmp/fonts`
-  media: 'media' // `.tmp/media`
-};
-const target = {
-  base: '',
-  // `dist`
-  css: 'css',
-  // `dist/css`
-  js: 'js',
-  // `dist/js`
-  img: 'img',
-  // `dist/img`
-  font: 'font',
-  // `dist/font`
-  media: 'media' // `dist/media`
-};
-export default {
-  source,
-  tmp,
-  target
-};

package/lib/config/pwa.js

@@ -1,24 +0,0 @@
-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';
-const version = '';
-export default {
-  enabled,
-  manifest,
-  workboxSw,
-  mode,
-  options,
-  swSrcFilename,
-  swDestFilename,
-  version
-};

package/lib/config/roots.js

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

package/lib/config/scripts.js

@@ -1,162 +0,0 @@
-// Base options
-const bundler = 'webpack';
-const minify = false;
-/**
- * Terser minify options
- *
- * @reference https://github.com/terser/terser#minify-options
- */
-const minifyOptions = {
-  ecma: 5,
-  compress: {
-    // Disabled because of an issue with Uglify breaking seemingly valid code:
-    // https://github.com/facebook/create-react-app/issues/2376
-    // Pending further investigation:
-    // https://github.com/mishoo/UglifyJS2/issues/2011
-    comparisons: false,
-    // Disabled because of an issue with Terser breaking valid code:
-    // https://github.com/facebook/create-react-app/issues/5250
-    // Pending further investigation:
-    // https://github.com/terser-js/terser/issues/120
-    inline: 2
-  },
-  mangle: {
-    safari10: true
-  },
-  format: {
-    comments: false,
-    // Turned on because emoji and regex is not minified properly using default
-    // https://github.com/facebook/create-react-app/issues/2488
-    ascii_only: true
-  }
-};
-// Entry and Context (webpack/esbuild common options)
-const entry = '';
-const lint = false;
-
-/**
- * Webpack bundler
- */
-
-// Output
-const library = '';
-// Module
-const loaders = [];
-const defaultLoaders = {};
-const includeJsResource = [];
-const useEsModule = true;
-/**
- * Scripts: babel-loader options
- *
- * @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 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 stats = {
-  colors: true,
-  assets: true,
-  children: false,
-  chunks: false,
-  modules: false
-};
-/**
- * Full custom webpack configuration
- *
- * @reference https://webpack.js.org/configuration/
- */
-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 = {};
-export default {
-  // base
-  bundler,
-  minify,
-  minifyOptions,
-  entry,
-  lint,
-  // webpack
-  library,
-  loaders,
-  defaultLoaders,
-  includeJsResource,
-  useEsModule,
-  babelLoaderOptions,
-  postcssLoaderOptions,
-  htmlLoaderOptions,
-  imageAssetType,
-  imageInlineSizeLimit,
-  extensions,
-  alias,
-  plugins,
-  nodeEnv,
-  injectHtml,
-  htmlPluginOptions,
-  extractCss,
-  sourceMap,
-  target,
-  externals,
-  stats,
-  webpackOptions,
-  optimization,
-  extractAllVendors,
-  vendorName,
-  ie8,
-  // rollup
-  inputOptions,
-  outputOptions,
-  // esbuild
-  buildOptions,
-  useTransform,
-  transformOptions
-};

package/lib/config/server.js

@@ -1,84 +0,0 @@
-const port = 3000;
-const host = null;
-const https = undefined;
-const open = false;
-const proxy = false; // Host: your.project.dev
-const serveStatic = [
-  // {
-  //     route: '/public',
-  //     dir: '/path/to/public'
-  // }
-];
-/**
- * Browsersync options
- *
- * @reference https://browsersync.io/docs/options
- */
-const options = {};
-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
-};
-/**
- * Http-proxy middleware
- *
- * @reference https://github.com/chimurai/http-proxy-middleware#options
- *
- * @example
- * Single proxy example
- * {
- *   target: 'http://www.example.org',
- *   changeOrigin: true,
- *   pathFilter: '/api'
- * }
- * @example
- * Multiple proxies example
- * [{
- *   target: 'http://www.example.org',
- *   changeOrigin: true,
- *   pathFilter: '/api'
- * }, {
- *   target: 'http://www.example2.org',
- *   changeOrigin: true,
- *   pathFilter: ['/api2', '/api3']
- * }]
- */
-const proxyOptions = 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 {
-  port,
-  host,
-  https,
-  open,
-  proxy,
-  serveStatic,
-  options,
-  next,
-  devOptions,
-  hotOptions,
-  proxyOptions,
-  historyOptions,
-  middlewares,
-  extraWatchFiles
-};

package/lib/config/spinner.js

@@ -1,9 +0,0 @@
-// Reference `cli-spinners`
-const spinner = process.platform === 'win32' ? {
-  interval: 130,
-  frames: ['-', '\\', '|', '/']
-} : {
-  interval: 80,
-  frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
-};
-export default spinner;

package/lib/config/styles.js

@@ -1,67 +0,0 @@
-const extname = 'css';
-const minify = false;
-const atImportPaths = [];
-const entry = '';
-/**
- * Cssnano optimisations
- *
- * @reference https://cssnano.co/docs/optimisations/
- */
-const options = {
-  discardComments: {
-    removeAll: true
-  }
-};
-/**
- * LibSass 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 = {
-  autoprefixer: {
-    flexbox: 'no-2009'
-  },
-  stage: 3
-};
-/**
- * PostCSS plugins
- *
- * @reference https://www.postcss.parts/
- */
-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,
-  minify,
-  atImportPaths,
-  entry,
-  options,
-  sassOptions,
-  lessOptions,
-  postcssEnvOptions,
-  postcssPlugins,
-  imageBasePath,
-  sprites,
-  spriteRetina,
-  spriteParams
-};

package/lib/hello.js

@@ -1,19 +0,0 @@
-import { versions } from 'node:process';
-import { createRequire } from 'node:module';
-import fs from 'node:fs';
-import { URL } from 'node:url';
-import { EventEmitter } from 'node:events';
-import cacheBalmCore from './utilities/cache-core.js';
-const requireModule = createRequire(import.meta.url);
-const balmCorePkg = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
-global.requireModule = requireModule;
-global.BalmJS = {
-  version: balmCorePkg.version,
-  emitter: new EventEmitter(),
-  useCacache: +versions.node.split('.')[0] >= 18
-};
-if (!BalmJS.useCacache) {
-  BalmJS.loading = true;
-  cacheBalmCore();
-}
-export default balmCorePkg.version;

package/lib/hooks/index.js

@@ -1,94 +0,0 @@
-import Maker from './maker.js';
-class BaseHooks {
-  get env() {
-    return BalmJS.config.env;
-  }
-
-  // HTML
-  html(input, output) {
-    Maker.generate('html', [input, output]);
-  }
-
-  // Stylesheets
-  css(input, output) {
-    Maker.generate('postcss', [input, output]);
-  }
-  sass(input, output, options) {
-    Maker.generate('sass', [input, output, options]);
-  }
-  less(input, output, options) {
-    Maker.generate('less', [input, output, options]);
-  }
-  url(input, output) {
-    Maker.generate('url', [input, output]);
-  }
-
-  // JavaScript
-  js() {
-    BalmJS.logger.warn('balm api', '`mix.js` is deprecated, please use `mix.webpack`/`mix.rollup`/`mix.esbuild` instead.');
-  }
-  webpack(input, output, options, fn) {
-    Maker.generate('webpack', [input, output, options, fn]);
-  }
-  esbuild(input, output, options) {
-    Maker.generate('esbuild', [input, output, options]);
-  }
-  rollup(input, output) {
-    Maker.generate('rollup', [input, output]);
-  }
-  jsmin(input, output, options) {
-    Maker.generate('jsmin', [input, output, options]);
-  }
-
-  // Files & Directories
-  copy(input, output, options) {
-    Maker.generate('copy', [input, output, options]);
-  }
-  remove(paths) {
-    Maker.generate('remove', [paths]);
-  }
-
-  // Cache
-  version(input, output, assetsOptions) {
-    Maker.generate('version', [input, output, assetsOptions]);
-  }
-
-  // Server
-  serve(handler) {
-    Maker.generate('serve', [handler]);
-  }
-}
-class BalmHooks extends BaseHooks {
-  // Stylesheets
-  sprite(input, output, spriteOptions) {
-    Maker.generate('sprite', [input, output, spriteOptions]);
-  }
-
-  // Assets
-  replace(input, output, options) {
-    Maker.generate('replace', [input, output, options]);
-  }
-  publish(input, output, renameOptions) {
-    Maker.generate('publish', [input, output, renameOptions]);
-  }
-  zip(input = '', output = '', filename = 'archive.zip') {
-    Maker.generate('zip', [input, output, filename]);
-  }
-  ftp(localFiles, options) {
-    Maker.generate('ftp', [localFiles, options]);
-  }
-
-  // PWA
-  generateSW(pwaOptions) {
-    Maker.generate('pwa', ['generateSW', pwaOptions]);
-  }
-  injectManifest(pwaOptions) {
-    Maker.generate('pwa', ['injectManifest', pwaOptions]);
-  }
-
-  // Others
-  modernizr() {
-    Maker.generate('modernizr');
-  }
-}
-export default BalmHooks;

package/lib/hooks/maker.js

@@ -1,59 +0,0 @@
-const BLOCKLIST_IN_PROD = ['serve'];
-let compiling = false;
-function ban(name) {
-  const BLOCKLIST_IN_DEV = ['publish', ...(BalmJS.config.useDefaults ? BLOCKLIST_IN_PROD : [])];
-  const banInProd = BalmJS.config.env.isProd && BLOCKLIST_IN_PROD.includes(name);
-  const banInDev = BalmJS.config.env.isDev && BLOCKLIST_IN_DEV.includes(name);
-  const isBan = banInProd || banInDev;
-  const api = name === 'postcss' ? 'css' : name;
-  if (isBan) {
-    const message = BalmJS.config.useDefaults && BalmJS.config.env.isDev && BLOCKLIST_IN_PROD.includes(name) ? `'mix.${api}()' can only be used for 'balm.config.useDefaults = false;'` : `There is no 'mix.${api}()' hook in ${banInProd ? 'production' : 'development'} mode`;
-    BalmJS.logger.warn('balm hook', message);
-  }
-  return isBan;
-}
-class Maker {
-  // Register custom task
-  static generate(name, args = []) {
-    if (ban(name)) {
-      return;
-    }
-    const customTask = BalmJS.tasks.get(name);
-    const taskName = ['sprite', ...BLOCKLIST_IN_PROD].includes(customTask.name) ? customTask.name : `${customTask.name}:${BalmJS.recipeIndex}`;
-    let balmTask = callback => {
-      callback();
-    }; // NOTE: `balmTask` function name for `gulp.parallel`
-
-    switch (customTask.name) {
-      // private
-      case 'sprite':
-        customTask.recipe(...args);
-        if (customTask.deps.length) {
-          balmTask = gulp.series(...BalmJS.toNamespace(customTask.deps));
-        } else {
-          BalmJS.logger.warn('balm hook', '`mix.sprite()` is missing `input` parameters');
-        }
-        break;
-      case 'modernizr':
-        balmTask = customTask.fn;
-        break;
-      // public
-      default:
-        balmTask = customTask.recipe(...args);
-    }
-    if (BalmJS.watching) {
-      if (!compiling) {
-        compiling = true;
-        gulp.series(balmTask, done => {
-          compiling = false;
-          done();
-        })();
-      }
-    } else {
-      gulp.task(BalmJS.toNamespace(taskName), balmTask);
-      BalmJS.recipes.push(taskName);
-      BalmJS.recipeIndex++;
-    }
-  }
-}
-export default Maker;

package/lib/index.js

@@ -1,5 +0,0 @@
-import version from './hello.js';
-import Balm from './balm.js';
-const balm = new Balm();
-export default balm;
-export { Balm, version };

package/lib/middlewares/history.js

@@ -1,6 +0,0 @@
-import history from 'connect-history-api-fallback';
-function historyMiddleware() {
-  const historyOptions = BalmJS.config.server.historyOptions;
-  return historyOptions ? [BalmJS.utils.isObject(historyOptions) ? history(historyOptions) : history()] : [];
-}
-export default historyMiddleware;

package/lib/middlewares/index.js

@@ -1,11 +0,0 @@
-import webpackMiddleware from './webpack.js';
-import httpProxyMiddleware from './proxy.js';
-import historyMiddleware from './history.js';
-function getMiddlewares() {
-  const canOverride = BalmJS.config.server.middlewares.every(middleware => BalmJS.utils.isFunction(middleware) || BalmJS.utils.isObject(middleware));
-  if (!canOverride) {
-    BalmJS.logger.error('server middleware', 'Server middleware must be a function (`function (req, res, next) {}`) or object (`{ route: "/api", handle: function (req, res, next) {} }`)');
-  }
-  return [...(BalmJS.config.scripts.bundler === BalmJS.Bundler.webpack ? webpackMiddleware() : []), ...httpProxyMiddleware(), ...historyMiddleware(), ...(canOverride ? BalmJS.config.server.middlewares : [])];
-}
-export default getMiddlewares;

package/lib/middlewares/proxy.js

@@ -1,28 +0,0 @@
-import { createProxyMiddleware } from 'http-proxy-middleware';
-function httpProxyMiddleware() {
-  const middleware = [];
-  const proxyOptions = BalmJS.config.server.proxyOptions;
-  if (proxyOptions) {
-    try {
-      if (BalmJS.utils.isObject(proxyOptions)) {
-        // Single proxy
-        const options = proxyOptions;
-        middleware.push(createProxyMiddleware(options));
-      } else if (BalmJS.utils.isArray(proxyOptions)) {
-        // Multiple proxies
-        for (const options of proxyOptions) {
-          middleware.push(createProxyMiddleware(options));
-        }
-      } else {
-        BalmJS.logger.error('proxy middleware', `Proxy options (https://github.com/chimurai/http-proxy-middleware#options) must be an object or array`);
-      }
-    } catch (error) {
-      const {
-        message
-      } = error;
-      BalmJS.logger.error('proxy middleware', message);
-    }
-  }
-  return middleware;
-}
-export default httpProxyMiddleware;

package/lib/middlewares/webpack.js

@@ -1,26 +0,0 @@
-import webpackDevMiddleware from 'webpack-dev-middleware';
-import webpackHotMiddleware from 'webpack-hot-middleware';
-import { HMR_PATH } from '../config/constants.js';
-function webpackMiddleware() {
-  const middleware = [];
-  if (BalmJS.webpackCompiler) {
-    middleware.push(webpackDevMiddleware(BalmJS.webpackCompiler, Object.assign({}, BalmJS.config.server.devOptions, {
-      headers: [{
-        key: 'balm-core',
-        value: BalmJS.version
-      }],
-      publicPath: BalmJS.file.publicUrlOrPath,
-      stats: false
-    })));
-    if (BalmJS.config.server.useHMR) {
-      middleware.push(webpackHotMiddleware(BalmJS.webpackCompiler, {
-        log: false,
-        path: HMR_PATH
-      }));
-    }
-  } else {
-    BalmJS.logger.warn('webpack middleware', 'Webpack compiler is not ready');
-  }
-  return middleware;
-}
-export default webpackMiddleware;