@lynx-js/rspeedy 0.14.5 → 0.15.0

package/dist/{1~src_cli_watch_ts.js → 1~watch.js}

@@ -1,7 +1,5 @@
 async function watchFiles(files, callback) {
-    const chokidar = await import("./1~node_modules_pnpm_chokidar_4_0_3_node_modules_chokidar_esm_index_js.js").then((mod)=>({
-            default: mod.chokidar_esm
-        }));
+    const chokidar = await import("./1~chokidar.js");
     const watcher = chokidar.default.watch(files, {
         ignoreInitial: true,
         ignorePermissionErrors: true

package/dist/cli/main.js

@@ -1 +1 @@
-export { main } from "../src_cli_main_ts.js";
+export { main } from "../src_cli_main_ts-node_child_process-node_events-node_fs-node_path-node_process.js";

package/dist/index.d.ts

@@ -98,9 +98,50 @@ export declare interface BuildCache {
     buildDependencies?: string[] | undefined;
 }
 
+/**
+ * The name of the bundle files.
+ *
+ * It can be a string with placeholders (`[name]`, `[contenthash]`,
+ * `[platform]`), or a function that returns a string based on the
+ * {@link BundleFilenameContext}.
+ *
+ * @public
+ */
+export declare type BundleFilename = string | ((context: BundleFilenameContext) => string);
+
+/**
+ * The context passed to the {@link Filename.bundle} function.
+ *
+ * @public
+ */
+export declare interface BundleFilenameContext {
+    /**
+     * Whether the filename is being resolved for a lazy bundle (async chunk)
+     * instead of the main bundle of an entry.
+     *
+     * This allows you to control the main bundle and the lazy bundles with a
+     * single function, without needing a dedicated `lazyBundle` field.
+     */
+    lazyBundle: boolean;
+    /**
+     * The name of the entry.
+     *
+     * It is `undefined` for lazy bundles, since a lazy bundle name is resolved
+     * per async chunk (use the `[name]` placeholder in the returned string
+     * instead).
+     */
+    entryName?: string | undefined;
+    /**
+     * The environment (platform) name, e.g. `'lynx'` or `'web'`.
+     */
+    platform: string;
+}
+
 /**
  * {@inheritdoc Performance.chunkSplit}
  *
+ * @deprecated Use the top-level {@link Config.splitChunks} option instead.
+ *
  * @public
  */
 export declare interface ChunkSplit {
@@ -195,6 +236,8 @@ export declare interface ChunkSplit {
 /**
  * {@inheritdoc Performance.chunkSplit}
  *
+ * @deprecated Use the top-level {@link Config.splitChunks} option instead.
+ *
  * @public
  */
 export declare interface ChunkSplitBySize {
@@ -259,6 +302,8 @@ export declare interface ChunkSplitBySize {
 /**
  * {@inheritdoc Performance.chunkSplit}
  *
+ * @deprecated Use the top-level {@link Config.splitChunks} option instead.
+ *
  * @public
  */
 export declare interface ChunkSplitCustom {
@@ -371,7 +416,7 @@ export declare interface Config {
      *
      * - Enable HMR and register the {@link https://rspack.rs/plugins/webpack/hot-module-replacement-plugin | HotModuleReplacementPlugin}.
      *
-     * - Generate JavaScript source maps, but do not generate CSS source maps. See {@link Output.sourceMap} for details.
+     * - Generate JavaScript and CSS source maps. In Lynx environments, all `.map` assets are removed before emit. See {@link Output.sourceMap} for details.
      *
      * - The `process.env.NODE_ENV` in the source code will be replaced with `'development'`.
      *
@@ -391,7 +436,7 @@ export declare interface Config {
      *
      * - Generated CSS Modules classnames will be shorter, see {@link CssModules.localIdentName}.
      *
-     * - Do not generate JavaScript and CSS source maps, see {@link Output.sourceMap}.
+     * - Generate JavaScript and CSS source maps. In Lynx environments, all `.map` assets are removed before emit. See {@link Output.sourceMap}.
      *
      * - The `process.env.NODE_ENV` in the source code will be replaced with `'production'`.
      *
@@ -432,6 +477,14 @@ export declare interface Config {
      * @defaultValue undefined
      */
     source?: Source | undefined;
+    /**
+     * Configure chunk splitting.
+     *
+     * @defaultValue Rspeedy defaults this to `false`; if configured, Rsbuild handles it with its top-level `splitChunks` option.
+     *
+     * See {@link https://rsbuild.rs/config/split-chunks | Rsbuild - splitChunks} for details.
+     */
+    splitChunks?: RsbuildConfig['splitChunks'] | undefined;
     /**
      * The {@link Tools} options changes the behavior of various building tools.
      *
@@ -620,16 +673,16 @@ export declare interface CssExtractRspackLoaderOptions {
      * You can enable a CommonJS syntax using:
      *
      * ```js
-     * import {CssExtractWebpackPlugin} from "@lynx-js/css-extract-webpack-plugin";
+     * import {CssExtractRspackPlugin} from "@lynx-js/css-extract-webpack-plugin";
      * export default {
-     *   plugins: [new CssExtractWebpackPlugin()],
+     *   plugins: [new CssExtractRspackPlugin()],
      *   module: {
      *     rules: [
      *       {
      *         test: /\.css$/i,
      *         use: [
      *           {
-     *             loader: CssExtractWebpackPlugin.loader,
+     *             loader: CssExtractRspackPlugin.loader,
      *             options: {
      *               esModule: false,
      *             },
@@ -1601,8 +1654,33 @@ export declare interface Filename {
      *   },
      * })
      * ```
+     *
+     * @example
+     *
+     * - Using a function to control the main bundle and the lazy bundles
+     *   separately (e.g. emit lazy bundles into another directory with a git
+     *   commit hash appended):
+     *
+     * ```js
+     * import { execSync } from 'node:child_process'
+     *
+     * import { defineConfig } from '@lynx-js/rspeedy'
+     *
+     * const gitHash = execSync('git rev-parse --short HEAD').toString().trim()
+     *
+     * export default defineConfig({
+     *   output: {
+     *     filename: {
+     *       bundle: ({ lazyBundle, platform }) =>
+     *         lazyBundle
+     *           ? `my-lazy-bundles/[name].[fullhash]-${gitHash}.bundle`
+     *           : `[name].${platform}.bundle`,
+     *     },
+     *   },
+     * })
+     * ```
      */
-    bundle?: string | undefined;
+    bundle?: BundleFilename | undefined;
     /**
      * The name of the template files.
      *
@@ -2297,7 +2375,7 @@ export declare interface Output {
     /**
      * The {@link Output.inlineScripts} option controls whether to inline scripts into Lynx bundle (`.lynx.bundle`).
      *
-     * @defaultValue Rspeedy defaults this to `true` and only switches it to `false` when the user explicitly sets `performance.chunkSplit.strategy` to a value other than `'all-in-one'`.
+     * @defaultValue Rspeedy defaults this to `true` and only switches it to `false` when the user explicitly enables the top-level `splitChunks` option.
      *
      * @remarks
      *
@@ -2362,7 +2440,7 @@ export declare interface Output {
     /**
      * The {@link SourceMap} configures whether and how to generate source-map for outputs.
      *
-     * @defaultValue When this option is unset, JavaScript source maps use `'cheap-module-source-map'` in development and are otherwise disabled; CSS source maps are disabled.
+     * @defaultValue When this option is unset in Lynx builds, JavaScript source maps use `'cheap-module-source-map'` in development and `'source-map'` in production; CSS source maps are also generated. All `.map` assets are removed before emit.
      */
     sourceMap?: boolean | SourceMap | undefined;
 }
@@ -2416,10 +2494,12 @@ export declare interface Performance {
      * {@link Performance.chunkSplit} is used to configure the chunk splitting strategy.
      *
      * @defaultValue For web builds, Rsbuild currently uses `{ strategy: 'split-by-experience' }` when this option is unset.
+     *
+     * @deprecated Use the top-level {@link Config.splitChunks} option instead.
      */
     chunkSplit?: ChunkSplit | ChunkSplitBySize | ChunkSplitCustom | undefined;
     /**
-     * Whether capture timing information in the build time and the runtime, the same as the {@link https://rspack.rs/config/other-options#profile | profile} config of Rspack.
+     * Whether capture timing information in Lynx runtime integrations such as ReactLynx.
      *
      * @defaultValue Rspeedy sets this to `true` when `DEBUG` contains `rspeedy`; otherwise it leaves the option unset.
      *
@@ -2427,11 +2507,8 @@ export declare interface Performance {
      *
      * Enable profile.
      *
-     * - Rsbuild will auto-generate `dist/stats.json` file through bundle analyzer.
-     *
-     * - Rspack will include the build time information when generating `stats.json`.
-     *
      * - Frameworks like ReactLynx will include runtime information using `console.profile`.
+     * - Rspeedy will emit `dist/stats.json` after build for bundle analysis compatibility.
      *
      * ```ts
      * import { defineConfig } from '@lynx-js/rspeedy'
@@ -2957,7 +3034,7 @@ export declare interface Server {
     /**
      * Specify the host that the Rspeedy Server listens to.
      *
-     * @defaultValue undefined
+     * @defaultValue "0.0.0.0"
      *
      * @remarks
      * During `rspeedy dev`, if `server.host` is unset, the dev plugin resolves dev-server-related URLs and client host settings with a detected local IPv4 address, such as `192.168.1.50`. If you have multiple network interfaces, set `server.host` explicitly to choose the desired address.
@@ -3172,7 +3249,7 @@ export declare interface Source {
      *
      * - Notably, if a `typeof` prefix is attached to the key, it will be exclusively defined for `typeof` calls."
      */
-    define?: Record<string, string | number | boolean | undefined | Record<string, unknown>> | undefined;
+    define?: Rspack.DefinePluginOptions;
     /**
      * The {@link Entry} option is used to set the entry module.
      *
@@ -3478,7 +3555,7 @@ export declare interface SourceMap {
     /**
      * How the source map should be generated. Setting it to `false` will disable the source map.
      *
-     * @defaultValue When `output.sourceMap` is an object and `js` is unset, it defaults to `'cheap-module-source-map'` in development and `false` in production.
+     * @defaultValue When `output.sourceMap` is an object and `js` is unset, it defaults to `'cheap-module-source-map'` in development. In production, it defaults to `'source-map'` for Lynx environments and `false` otherwise.
      *
      * @remarks
      *
@@ -3540,7 +3617,7 @@ export declare interface SourceMap {
      *
      * @remarks
      *
-     * Defaults to `true`.
+     * Defaults to `true`. In Lynx builds, all `.map` assets are removed before emit.
      *
      * @example
      *

package/dist/{src_cli_main_ts.js → src_cli_main_ts-node_child_process-node_events-node_fs-node_path-node_process.js}

@@ -1,6 +1,106 @@
-import * as __rspack_external_node_process_786449bf from "node:process";
-import { __webpack_require__ } from "./rslib-runtime.js";
-import { createRsbuild, logger, mergeRsbuildConfig, rspack, version } from "@rsbuild/core";
+import { logger, rspack, version } from "@rsbuild/core";
+import node_process from "node:process";
+import { createRequire as __rspack_createRequire } from "node:module";
+const __rspack_createRequire_require = __rspack_createRequire(import.meta.url);
+var __webpack_modules__ = {};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId].call(module.exports, module, module.exports, __webpack_require__);
+    return module.exports;
+}
+__webpack_require__.m = __webpack_modules__;
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    var getProto = Object.getPrototypeOf ? (obj)=>Object.getPrototypeOf(obj) : (obj)=>obj.__proto__;
+    var leafPrototypes;
+    __webpack_require__.t = function(value, mode) {
+        if (1 & mode) value = this(value);
+        if (8 & mode) return value;
+        if ('object' == typeof value && value) {
+            if (4 & mode && value.__esModule) return value;
+            if (16 & mode && 'function' == typeof value.then) return value;
+        }
+        var ns = Object.create(null);
+        __webpack_require__.r(ns);
+        var def = {};
+        leafPrototypes = leafPrototypes || [
+            null,
+            getProto({}),
+            getProto([]),
+            getProto(getProto)
+        ];
+        for(var current = 2 & mode && value; ('object' == typeof current || 'function' == typeof current) && !~leafPrototypes.indexOf(current); current = getProto(current))Object.getOwnPropertyNames(current).forEach((key)=>{
+            def[key] = ()=>value[key];
+        });
+        def['default'] = ()=>value;
+        __webpack_require__.d(ns, def);
+        return ns;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports, key)) Object.defineProperty(exports, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.add = function(modules) {
+        Object.assign(__webpack_require__.m, modules);
+    };
+})();
+var __webpack_require__temp = __webpack_require__;
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports, '__esModule', {
+            value: true
+        });
+    };
+})();
+(()=>{
+    var installedChunks = {
+        "cli/main": 0,
+        "src_cli_main_ts-node_child_process-node_events-node_fs-node_path-node_process": 0
+    };
+    var installChunk = (data)=>{
+        var __rspack_esm_ids = data.__rspack_esm_ids;
+        var __webpack_modules__ = data.__webpack_modules__;
+        var __rspack_esm_runtime = data.__rspack_esm_runtime;
+        var moduleId, chunkId, i = 0;
+        for(moduleId in __webpack_modules__)if (__webpack_require__.o(__webpack_modules__, moduleId)) __webpack_require__.m[moduleId] = __webpack_modules__[moduleId];
+        if (__rspack_esm_runtime) __rspack_esm_runtime(__webpack_require__);
+        for(; i < __rspack_esm_ids.length; i++){
+            chunkId = __rspack_esm_ids[i];
+            if (__webpack_require__.o(installedChunks, chunkId) && installedChunks[chunkId]) installedChunks[chunkId][0]();
+            installedChunks[__rspack_esm_ids[i]] = 0;
+        }
+    };
+    __webpack_require__.C = installChunk;
+})();
 __webpack_require__.add({
     "../../../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js" (module) {
         let p = process || {}, argv = p.argv || [], env = p.env || {};
@@ -68,11 +168,22 @@ __webpack_require__.add({
         module.exports = createColors();
         module.exports.createColors = createColors;
     },
-    "node:process" (module) {
-        module.exports = __rspack_external_node_process_786449bf;
+    "node:child_process" (module) {
+        module.exports = __rspack_createRequire_require("node:child_process");
+    },
+    "node:events" (module) {
+        module.exports = __rspack_createRequire_require("node:events");
+    },
+    "node:fs?9592" (module) {
+        module.exports = __rspack_createRequire_require("node:fs");
+    },
+    "node:path?435f" (module) {
+        module.exports = __rspack_createRequire_require("node:path");
+    },
+    "node:process?ecf8" (module) {
+        module.exports = __rspack_createRequire_require("node:process");
     }
 });
-const external_node_process_ = __webpack_require__("node:process");
 const asyncCallbacks = new Set();
 const callbacks = new Set();
 let isCalled = false;
@@ -83,7 +194,7 @@ async function exit(shouldManuallyExit, isSynchronous, signal) {
     if (asyncCallbacks.size > 0 && isSynchronous) console.error("SYNCHRONOUS TERMINATION NOTICE: When explicitly exiting the process via process.exit or via a parent process, asynchronous tasks in your exitHooks will not run. Either remove these tasks, use gracefulExit() instead of process.exit(), or ensure your parent process sends a SIGINT to the process running this code.");
     const exitCode = 128 + signal;
     const done = (force = false)=>{
-        if (true === force || true === shouldManuallyExit) external_node_process_["default"].exit(exitCode);
+        if (true === force || true === shouldManuallyExit) node_process.exit(exitCode);
     };
     for (const callback of callbacks)callback(exitCode);
     if (isSynchronous) return void done();
@@ -110,11 +221,11 @@ function addHook(options) {
     else asyncCallbacks.add(asyncCallbackConfig);
     if (!isRegistered) {
         isRegistered = true;
-        external_node_process_["default"].once('beforeExit', exit.bind(void 0, true, false, -128));
-        external_node_process_["default"].once('SIGINT', exit.bind(void 0, true, false, 2));
-        external_node_process_["default"].once('SIGTERM', exit.bind(void 0, true, false, 15));
-        external_node_process_["default"].once('exit', exit.bind(void 0, false, true, 0));
-        external_node_process_["default"].on('message', (message)=>{
+        node_process.once('beforeExit', exit.bind(void 0, true, false, -128));
+        node_process.once('SIGINT', exit.bind(void 0, true, false, 2));
+        node_process.once('SIGTERM', exit.bind(void 0, true, false, 15));
+        node_process.once('exit', exit.bind(void 0, false, true, 0));
+        node_process.on('message', (message)=>{
             if ('shutdown' === message) exit(true, true, -128);
         });
     }
@@ -192,7 +303,7 @@ async function exit_onExit(signal) {
     await Promise.allSettled(exitPromises);
 }
 var package_namespaceObject = {
-    rE: "0.14.5"
+    rE: "0.15.0"
 };
 const version_version = package_namespaceObject.rE;
 const rspackVersion = rspack.rspackVersion;
@@ -210,26 +321,12 @@ async function main(argv) {
     logger.greet(`  Rspeedy v${version_version} (Rsbuild v${version}, Rspack v${rspackVersion})\n`);
     try {
         const [{ Command }, { apply }] = await Promise.all([
-            import("./1~node_modules_pnpm_commander_13_1_0_node_modules_commander_esm_mjs.js").then((mod)=>({
-                    Argument: mod.Argument,
-                    Command: mod.Command,
-                    CommanderError: mod.CommanderError,
-                    Help: mod.Help,
-                    InvalidArgumentError: mod.InvalidArgumentError,
-                    InvalidOptionArgumentError: mod.InvalidOptionArgumentError,
-                    Option: mod.Option,
-                    createArgument: mod.createArgument,
-                    createCommand: mod.createCommand,
-                    createOption: mod.createOption,
-                    program: mod.program
-                })),
-            import("./1~src_cli_commands_ts.js").then((mod)=>({
-                    apply: mod.apply
-                }))
+            import("./1~esm.js").then((m)=>m.esm_namespaceObject),
+            import("./1~commands.js")
         ]);
         apply(new Command('rspeedy')).parse(argv);
     } catch  {
         return exit_exit(1);
     }
 }
-export { createRsbuild, debug, debugList, exit_exit, isDebug, logger, main, mergeRsbuildConfig, version_version };
+export { __webpack_require__temp as __webpack_require__, debug, debugList, exit_exit as exit, isDebug, main, version_version };