@lynx-js/rspeedy-canary 0.11.0-canary-20250827-bc310a8c → 0.11.0-canary-20250828-86da1623

package/CHANGELOG.md

@@ -1,9 +1,13 @@
 # @lynx-js/rspeedy
 
-## 0.11.0-canary-20250827124621-bc310a8c9a6242687baffb8d629c4524935be386
+## 0.11.0-canary-20250828061943-86da1623d0bd2cc5fa6dc1642915e5f43a02d350
 
 ### Minor Changes
 
+- Deprecate `source.alias`, use `resolve.alias` instead. ([#1610](https://github.com/lynx-family/lynx-stack/pull/1610))
+
+  Note that `resolve.alias` has **lower** priority than the deprecated `source.alias`.
+
 - Bump Rsbuild v1.5.0 with Rspack v1.5.0. ([#1591](https://github.com/lynx-family/lynx-stack/pull/1591))
 
 - **BREAKING CHANGE**: Remove the `./register` exports from `@lynx-js/rspeedy`. ([#1547](https://github.com/lynx-family/lynx-stack/pull/1547))
@@ -12,10 +16,12 @@
 
 ### Patch Changes
 
+- Support `resolve.alias`. ([#1610](https://github.com/lynx-family/lynx-stack/pull/1610))
+
 - Support `rspeedy build --watch` ([#1579](https://github.com/lynx-family/lynx-stack/pull/1579))
 
 - Updated dependencies [[`1952fc1`](https://github.com/lynx-family/lynx-stack/commit/1952fc1557e5abbdbdf4a2073fd3b6f64dd32c3c)]:
-  - @lynx-js/chunk-loading-webpack-plugin@0.3.2-canary-20250827124621-bc310a8c9a6242687baffb8d629c4524935be386
+  - @lynx-js/chunk-loading-webpack-plugin@0.3.2-canary-20250828061943-86da1623d0bd2cc5fa6dc1642915e5f43a02d350
   - @lynx-js/cache-events-webpack-plugin@0.0.1
 
 ## 0.10.8

package/dist/index.d.ts

@@ -414,9 +414,13 @@ export declare interface Config {
      */
     output?: Output | undefined;
     /**
-     * The {@link Performance} option is used to
+     * The {@link Performance} option is used to optimize the build-time and runtime performance.
      */
     performance?: Performance | undefined;
+    /**
+     * The {@link Resolve} option is used to control the resolution behavior of Rspack.
+     */
+    resolve?: Resolve | undefined;
     /**
      * The {@link Server} option changes the behavior of dev-server.
      */
@@ -2362,6 +2366,94 @@ export declare interface Performance {
     printFileSize?: PerformanceConfig['printFileSize'] | undefined;
 }
 
+/**
+ * {@inheritdoc Config.resolve}
+ *
+ * @public
+ */
+export declare interface Resolve {
+    /**
+     * Create aliases to `import` or `require` certain modules more easily.
+     *
+     * @example
+     *
+     * A trailing `$` can also be added to the given object's keys to signify an exact match:
+     *
+     * ```js
+     * import { defineConfig } from '@lynx-js/rspeedy'
+     * export default defineConfig({
+     *   resolve: {
+     *     alias: {
+     *       xyz$: 'path/to/file.js',
+     *     },
+     *   },
+     * })
+     * ```
+     *
+     * which would yield these results:
+     *
+     * ```js
+     * import Test1 from 'xyz'; // Exact match, so path/to/file.js is resolved and imported
+     * import Test2 from 'xyz/file.js'; // Not an exact match, normal resolution takes place
+     * ```
+     *
+     * @example
+     *
+     * `resolve.alias` is useful to control how a npm package is resolved.
+     *
+     * - Change `react` to `@lynx-js/react`:
+     *
+     * ```js
+     * import { defineConfig } from '@lynx-js/rspeedy'
+     * import { createRequire } from 'module'
+     * const require = createRequire(import.meta.url)
+     * export default defineConfig({
+     *   resolve: {
+     *     alias: {
+     *       react: require.resolve('@lynx-js/react'),
+     *     },
+     *   },
+     * })
+     * ```
+     *
+     * This allows you to use some third-party libraries that directly uses `react` as dependencies in ReactLynx.
+     *
+     * - Force using the same version of `dayjs`:
+     *
+     * ```js
+     * import { defineConfig } from '@lynx-js/rspeedy'
+     * import { createRequire } from 'module'
+     * const require = createRequire(import.meta.url)
+     * export default defineConfig({
+     *   resolve: {
+     *     alias: {
+     *       dayjs: require.resolve('dayjs'),
+     *     },
+     *   },
+     * })
+     * ```
+     *
+     * Please note that this is dangerous, since all the `dayjs`(including the dependencies of a dependencies) is resolved to the version in the project.
+     * It may cause both compile-time and runtime errors due to version mismatch.
+     *
+     * @example
+     * Setting `resolve.alias` to `false` will ignore a module.
+     *
+     * ```js
+     * import { defineConfig } from '@lynx-js/rspeedy'
+     * export default defineConfig({
+     *   resolve: {
+     *     alias: {
+     *       'ignored-module': false,
+     *       './ignored-module': false,
+     *     },
+     *   },
+     * })
+     * ```
+     */
+    alias?: Record<string, string | false | string[]> | undefined;
+}
+
 export { RsbuildPlugin }
 
 export { RsbuildPluginAPI }
@@ -2484,83 +2576,9 @@ export declare interface Server {
  */
 export declare interface Source {
     /**
-     * Create aliases to `import` or `require` certain modules more easily.
-     *
-     * @example
-     *
-     * A trailing `$` can also be added to the given object's keys to signify an exact match:
-     *
-     * ```js
-     * import { defineConfig } from '@lynx-js/rspeedy'
-     * export default defineConfig({
-     *   source: {
-     *     alias: {
-     *       xyz$: 'path/to/file.js',
-     *     },
-     *   },
-     * })
-     * ```
-     *
-     * which would yield these results:
-     *
-     * ```js
-     * import Test1 from 'xyz'; // Exact match, so path/to/file.js is resolved and imported
-     * import Test2 from 'xyz/file.js'; // Not an exact match, normal resolution takes place
-     * ```
-     *
-     * @example
-     *
-     * `source.alias` is useful to control how a npm package is resolved.
-     *
-     * - Change `react` to `@lynx-js/react`:
-     *
-     * ```js
-     * import { defineConfig } from '@lynx-js/rspeedy'
-     * import { createRequire } from 'module'
-     * const require = createRequire(import.meta.url)
-     * export default defineConfig({
-     *   source: {
-     *     alias: {
-     *       react: require.resolve('@lynx-js/react'),
-     *     },
-     *   },
-     * })
-     * ```
-     *
-     * This allows you to use some third-party libraries that directly uses `react` as dependencies in ReactLynx.
-     *
-     * - Force using the same version of `dayjs`:
+     * {@inheritdoc Resolve.alias}
      *
-     * ```js
-     * import { defineConfig } from '@lynx-js/rspeedy'
-     * import { createRequire } from 'module'
-     * const require = createRequire(import.meta.url)
-     * export default defineConfig({
-     *   source: {
-     *     alias: {
-     *       dayjs: require.resolve('dayjs'),
-     *     },
-     *   },
-     * })
-     * ```
-     *
-     * Please note that this is dangerous, since all the `dayjs`(including the dependencies of a dependencies) is resolved to the version in the project.
-     * It may cause both compile-time and runtime errors due to version mismatch.
-     *
-     * @example
-     * Setting `source.alias` to `false` will ignore a module.
-     *
-     * ```js
-     * import { defineConfig } from '@lynx-js/rspeedy'
-     * export default defineConfig({
-     *   source: {
-     *     alias: {
-     *       'ignored-module': false,
-     *       './ignored-module': false,
-     *     },
-     *   },
-     * })
-     * ```
+     * @deprecated - Use {@link Resolve.alias} instead.
      */
     alias?: Record<string, string | false | string[]> | undefined;
     /**

package/dist/index.js

@@ -341,9 +341,10 @@ function toRsbuildConfig(config) {
             sourceMap: config.output?.sourceMap
         },
         resolve: {
-            alias: config.source?.alias
+            alias: config.resolve?.alias
         },
         source: {
+            alias: config.source?.alias,
             assetsInclude: config.source?.assetsInclude,
             decorators: config.source?.decorators,
             define: config.source?.define,

package/dist/src_cli_build_ts.js

@@ -321,9 +321,10 @@ export const __webpack_modules__ = {
                     sourceMap: config.output?.sourceMap
                 },
                 resolve: {
-                    alias: config.source?.alias
+                    alias: config.resolve?.alias
                 },
                 source: {
+                    alias: config.source?.alias,
                     assetsInclude: config.source?.assetsInclude,
                     decorators: config.source?.decorators,
                     define: config.source?.define,

package/dist/src_cli_dev_ts.js

@@ -313,9 +313,10 @@ export const __webpack_modules__ = {
                     sourceMap: config.output?.sourceMap
                 },
                 resolve: {
-                    alias: config.source?.alias
+                    alias: config.resolve?.alias
                 },
                 source: {
+                    alias: config.source?.alias,
                     assetsInclude: config.source?.assetsInclude,
                     decorators: config.source?.decorators,
                     define: config.source?.define,

package/dist/src_cli_inspect_ts.js

@@ -259,9 +259,10 @@ export const __webpack_modules__ = {
                     sourceMap: config.output?.sourceMap
                 },
                 resolve: {
-                    alias: config.source?.alias
+                    alias: config.resolve?.alias
                 },
                 source: {
+                    alias: config.source?.alias,
                     assetsInclude: config.source?.assetsInclude,
                     decorators: config.source?.decorators,
                     define: config.source?.define,

package/dist/src_cli_preview_ts.js

@@ -261,9 +261,10 @@ export const __webpack_modules__ = {
                     sourceMap: config.output?.sourceMap
                 },
                 resolve: {
-                    alias: config.source?.alias
+                    alias: config.resolve?.alias
                 },
                 source: {
+                    alias: config.source?.alias,
                     assetsInclude: config.source?.assetsInclude,
                     decorators: config.source?.decorators,
                     define: config.source?.define,