@lynx-js/react-rsbuild-plugin 0.17.1 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,91 @@
 # @lynx-js/react-rsbuild-plugin
 
+## 0.18.0
+
+### Minor Changes
+
+- Stop injecting `webpackChunkName` into dynamic imports so lazy bundle intermediate files stay inside the output directory. ([#2961](https://github.com/lynx-family/lynx-stack/pull/2961))
+
+  The ReactLynx transform injected `webpackChunkName: "<request>-react__<layer>"`, so a dynamic import resolving above the compiler context (e.g. `import('../../Foo.js')`) leaked `../` into `[name]`/`[id]` and the intermediate js/css/hmr files escaped the output directory. Async chunks now keep rspack's own ids, `__webpack_require__.lynx_aci` maps them by chunk id, and each lazy bundle's intermediate JS and CSS are emitted under `.rspeedy/async/<bundle-name>/<layer>.js` and `<layer>.css` next to its other intermediate outputs (`tasm.json`, `debug-metadata.json`, CSS hot-update files). Explicit `webpackChunkName` comments written by users are still honored and keep the user-controlled `[name]` placement. Main-thread chunks no longer emit CSS hot-update files — CSS only exists on the background thread, and the main-thread HMR runtime receives updates from it.
+
+  These packages release together and must be upgraded together: `@lynx-js/react-webpack-plugin` and `@lynx-js/css-extract-webpack-plugin` require `@lynx-js/template-webpack-plugin` `^0.13.0`, and `@lynx-js/react-rsbuild-plugin` requires `@lynx-js/react` `^0.123.0`.
+
+- Choose the lazy bundle loader from `engineVersion`: use the new `fetchBundle` ([#2584](https://github.com/lynx-family/lynx-stack/pull/2584))
+  loader when `engineVersion >= 3.9`, otherwise keep the legacy `QueryComponent`
+  loader.
+
+  ```js
+  import('./Foo.jsx', { with: { mode: 'sync' | 'async' } })
+  ```
+
+  Force a loader regardless of `engineVersion` with the `REACT_LAZY_BUNDLE_FETCHER`
+  env var (`FetchBundle` / `QueryComponent`).
+
+- Add `firstScreenSyncTiming: 'manual'` and a new `markFirstScreenSyncReady()` API exported by `@lynx-js/react`. ([#2826](https://github.com/lynx-family/lynx-stack/pull/2826))
+
+  In `'manual'` mode, the main thread holds the UI control after the first screen until the business calls `markFirstScreenSyncReady()`, so the handover timing to the background thread (for hydration) is fully controlled by the user. The API can be called from both threads (a background-thread call is forwarded to the main thread) and takes effect once the first-screen tree has finished rendering.
+
+  ```js
+  pluginReactLynx({
+    firstScreenSyncTiming: 'manual',
+  })
+  ```
+
+  ```js
+  import { markFirstScreenSyncReady } from '@lynx-js/react'
+
+  markFirstScreenSyncReady()
+  ```
+
+### Patch Changes
+
+- Add `compat.legacySlot` to `pluginReactLynx`. When enabled, dynamic children are compiled to the pre-SlotV2 form (JSX `children` + `wrapper` elements + `__DynamicPartChildren`/`__DynamicPartSlot` symbols instead of `$0`/`$1` slot props + `SlotV2`), so the compiled output stays compatible with legacy runtimes without `SlotV2` support (`< 0.120.0`, which shipped the SlotV2 refactor in #1764) — e.g. a standalone lazy bundle consumed by a host App that ships an older runtime. ([#2947](https://github.com/lynx-family/lynx-stack/pull/2947))
+
+  ```js
+  import { defineConfig } from '@lynx-js/rspeedy'
+  import { pluginReactLynx } from '@lynx-js/react-rsbuild-plugin'
+
+  export default defineConfig({
+    plugins: [
+      pluginReactLynx({
+        compat: {
+          legacySlot: true,
+        },
+      }),
+    ],
+  })
+  ```
+
+  The default (SlotV2) codegen is unchanged, and the runtime keeps supporting both forms.
+
+- Updated dependencies [[`0a5f3f2`](https://github.com/lynx-family/lynx-stack/commit/0a5f3f2347000124eb266ba24459c615a5bc5520), [`983e33d`](https://github.com/lynx-family/lynx-stack/commit/983e33d73d20f6a9558c5662c7b7983ff3a2fa7a), [`1064984`](https://github.com/lynx-family/lynx-stack/commit/1064984d887eb76f880b8ccfeea096c9d787beca), [`a10dbd8`](https://github.com/lynx-family/lynx-stack/commit/a10dbd8939842ca091981e2ec9fabc95b8920f45), [`34318ea`](https://github.com/lynx-family/lynx-stack/commit/34318ea3432b6484a383707458ed9c4ee19e2097), [`fec4237`](https://github.com/lynx-family/lynx-stack/commit/fec4237b2257455a40a68f33864fb713c147f7d4), [`2b5d83a`](https://github.com/lynx-family/lynx-stack/commit/2b5d83a4b8e3c1f5329de9d9fe7539d38e33e420), [`2b5d83a`](https://github.com/lynx-family/lynx-stack/commit/2b5d83a4b8e3c1f5329de9d9fe7539d38e33e420), [`fec4237`](https://github.com/lynx-family/lynx-stack/commit/fec4237b2257455a40a68f33864fb713c147f7d4), [`fec4237`](https://github.com/lynx-family/lynx-stack/commit/fec4237b2257455a40a68f33864fb713c147f7d4), [`fec4237`](https://github.com/lynx-family/lynx-stack/commit/fec4237b2257455a40a68f33864fb713c147f7d4), [`983e33d`](https://github.com/lynx-family/lynx-stack/commit/983e33d73d20f6a9558c5662c7b7983ff3a2fa7a)]:
+  - @lynx-js/react-webpack-plugin@0.10.0
+  - @lynx-js/react-refresh-webpack-plugin@0.4.1
+  - @lynx-js/react-alias-rsbuild-plugin@0.18.0
+  - @lynx-js/css-extract-webpack-plugin@0.9.0
+  - @lynx-js/template-webpack-plugin@0.13.0
+  - @lynx-js/use-sync-external-store@1.5.0
+  - @lynx-js/runtime-wrapper-webpack-plugin@0.2.2
+
+## 0.17.2
+
+### Patch Changes
+
+- Fix the `web` environment crashing in development because its main thread was bundled with the Rsbuild web HMR runtime. ([#2910](https://github.com/lynx-family/lynx-stack/pull/2910))
+
+  Previously the `web` environment was compiled with `target: 'web'`, which makes Rsbuild inject its own HMR client (`@rsbuild/core/dist/client/hmr.js`). That client drives `__webpack_require__.hmrM`, which is implemented with `lynx.requireModuleAsync` — an API the web main thread does not provide — so hot updates crashed.
+
+  The `web` environment now uses the same target and HMR entry as the `lynx` environment, going through Lynx's own HMR runtime instead of the Rsbuild web one.
+
+- Updated dependencies [[`7a6577a`](https://github.com/lynx-family/lynx-stack/commit/7a6577a5b29db4020cbba22a911f712bafde7e66), [`d18c3e7`](https://github.com/lynx-family/lynx-stack/commit/d18c3e7a3976569ec9ba2a1b4a1e0e6c3ffa1f1d)]:
+  - @lynx-js/runtime-wrapper-webpack-plugin@0.2.1
+  - @lynx-js/react-alias-rsbuild-plugin@0.17.2
+  - @lynx-js/react-webpack-plugin@0.9.5
+  - @lynx-js/use-sync-external-store@1.5.0
+  - @lynx-js/react-refresh-webpack-plugin@0.4.0
+  - @lynx-js/template-webpack-plugin@0.12.2
+  - @lynx-js/css-extract-webpack-plugin@0.8.0
+
 ## 0.17.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -314,6 +314,40 @@ export declare interface CompatVisitorConfig {
      * ```
      */
     darkMode?: boolean | DarkModeConfig
+
+    /**
+     * Compile dynamic children as children + wrapper (the pre-SlotV2 slot
+     * codegen: `Slot`/`Children` dynamic parts rendered through wrapper
+     * elements) instead of the default SlotV2 codegen (`$N` slot props).
+     *
+     * @remarks
+     *
+     * Enable this when the compiled output needs to run on legacy
+     * `@lynx-js/react` runtimes without `SlotV2` support (`< 0.120.0`),
+     * e.g. a standalone lazy bundle consumed by a host App that ships an
+     * older runtime. It only changes the compile output; the runtime
+     * supports both forms.
+     *
+     * @example
+     *
+     * ```js
+     * import { defineConfig } from '@lynx-js/rspeedy'
+     * import { pluginReactLynx } from '@lynx-js/react-rsbuild-plugin'
+     *
+     * export default defineConfig({
+     *   plugins: [
+     *     pluginReactLynx({
+     *       compat: {
+     *         legacySlot: true,
+     *       },
+     *     })
+     *   ],
+     * })
+     * ```
+     *
+     * @defaultValue `false`
+     */
+    legacySlot?: boolean
 }
 
 declare interface DarkModeConfig {
@@ -447,11 +481,12 @@ export declare interface PluginReactLynxOptions {
      */
     enableUiSourceMap?: boolean;
     /**
-     * The `compat` option controls compatibilities with ReactLynx2.0.
+     * The `compat` option controls compatibilities with legacy ReactLynx.
      *
      * @remarks
      *
-     * These options should only be used for migrating from ReactLynx2.0.
+     * These options should only be used for migrating from ReactLynx2.0 or
+     * targeting legacy ReactLynx3 runtimes.
      *
      * @defaultValue `undefined`
      */
@@ -605,18 +640,21 @@ export declare interface PluginReactLynxOptions {
     /**
      * This flag controls when MainThread (Lepus) transfers control to Background after the first screen
      *
-     * This flag has two options:
+     * This flag has three options:
      *
      * `"immediately"`: Transfer immediately
      *
      * `"jsReady"`: Transfer when background (JS Runtime) is ready
      *
+     * `"manual"`: Transfer when the business calls the `markFirstScreenSyncReady()` API exported
+     * by `@lynx-js/react`, so the handover timing is fully controlled by the user
+     *
      * After handing over control, MainThread (Lepus) runtime can no longer respond to data updates,
      * and data updates will be forwarded to background (JS Runtime) and processed __asynchronously__
      *
      * @defaultValue "immediately"
      */
-    firstScreenSyncTiming?: 'immediately' | 'jsReady';
+    firstScreenSyncTiming?: 'immediately' | 'jsReady' | 'manual';
     /**
      * `enableSSR` enable Lynx SSR feature for this build.
      *

package/dist/index.js

@@ -104,6 +104,28 @@ const normalizeCssLoaderOptions = (options, exportOnlyLocals)=>{
     }
     return options;
 };
+const FETCH_BUNDLE_MIN_ENGINE_VERSION = '3.9';
+function resolveLazyBundleFetcher(engineVersion) {
+    const meets = meetsMinEngineVersion(engineVersion, FETCH_BUNDLE_MIN_ENGINE_VERSION);
+    const envOverride = process.env['REACT_LAZY_BUNDLE_FETCHER'];
+    if ('FetchBundle' === envOverride && !meets) throw new Error(`[pluginReactLynx] REACT_LAZY_BUNDLE_FETCHER=FetchBundle requires engineVersion >= ${FETCH_BUNDLE_MIN_ENGINE_VERSION}, but got ${engineVersion ? `'${engineVersion}'` : '<unset>'}. Older hosts do not expose 'lynx.fetchBundle' / 'lynx.loadScript'. Either bump 'engineVersion' to '${FETCH_BUNDLE_MIN_ENGINE_VERSION}' or higher, or unset REACT_LAZY_BUNDLE_FETCHER (the default falls back to 'QueryComponent' on older hosts).`);
+    if ('FetchBundle' === envOverride || 'QueryComponent' === envOverride) return envOverride;
+    return meets ? 'FetchBundle' : 'QueryComponent';
+}
+function meetsMinEngineVersion(actual, min) {
+    if (!actual) return false;
+    const actualParts = actual.split('.').map(Number);
+    const minParts = min.split('.').map(Number);
+    const len = Math.max(actualParts.length, minParts.length);
+    for(let i = 0; i < len; i++){
+        const a = actualParts[i] ?? 0;
+        const m = minParts[i] ?? 0;
+        if (Number.isNaN(a) || Number.isNaN(m)) return false;
+        if (a > m) break;
+        if (a < m) return false;
+    }
+    return true;
+}
 const PLUGIN_NAME_REACT = 'lynx:react';
 const PLUGIN_NAME_TEMPLATE = 'lynx:template';
 const PLUGIN_NAME_RUNTIME_WRAPPER = 'lynx:runtime-wrapper';
@@ -113,6 +135,7 @@ const DEFAULT_FILENAME_HASH = '.[contenthash:8]';
 const EMPTY_HASH = '';
 function applyEntry(api, options) {
     const { compat, customCSSInheritanceList, debugInfoOutside, defaultDisplayLinear, enableAccessibilityElement, enableCSSInheritance, enableCSSInvalidation, enableCSSSelector, enableNewGesture, enableRemoveCSSScope, firstScreenSyncTiming, globalPropsMode, enableSSR, removeDescendantSelectorScope, targetSdkVersion, extractStr: originalExtractStr, experimental_isLazyBundle } = options;
+    const lazyBundleFetcher = resolveLazyBundleFetcher(targetSdkVersion);
     api.modifyBundlerChain(async (chain, { environment, isDev, isProd })=>{
         const mainThreadChunks = [];
         const rsbuildConfig = api.getRsbuildConfig();
@@ -126,8 +149,8 @@ function applyEntry(api, options) {
             const isLynx = 'lynx' === environment.name || environment.name.startsWith('lynx-');
             const isWeb = 'web' === environment.name || environment.name.startsWith('web-');
             const { hmr, liveReload } = environment.config.dev ?? {};
-            const enabledHMR = isDev && !isWeb && false !== hmr;
-            const enabledLiveReload = isDev && !isWeb && false !== liveReload;
+            const enabledHMR = isDev && false !== hmr;
+            const enabledLiveReload = isDev && false !== liveReload;
             chain.entryPoints.clear();
             Object.entries(entries).forEach(([entryName, entryPoint])=>{
                 const { imports } = getChunks(entryName, entryPoint.values());
@@ -203,6 +226,7 @@ function applyEntry(api, options) {
                         removeDescendantSelectorScope,
                         targetSdkVersion,
                         experimental_isLazyBundle,
+                        lazyBundleFetcher,
                         cssPlugins: []
                     }
                 ]).end();
@@ -253,7 +277,8 @@ function applyEntry(api, options) {
                 experimental_isLazyBundle,
                 experimental_useElementTemplate: options.experimental_useElementTemplate,
                 profile: getDefaultProfile(),
-                workletRuntimePath: await resolve(`@lynx-js/react/${isDev ? 'worklet-dev-runtime' : 'worklet-runtime'}`)
+                workletRuntimePath: await resolve(`@lynx-js/react/${isDev ? 'worklet-dev-runtime' : 'worklet-runtime'}`),
+                lazyBundleFetcher
             }
         ]);
         function getDefaultProfile() {
@@ -618,7 +643,7 @@ const _assertGuard = (exceptionable, props, factory)=>{
     return false;
 };
 const validateConfig = (()=>{
-    const _io0 = (input, _exceptionable = true)=>(void 0 === input.enableUiSourceMap || "boolean" == typeof input.enableUiSourceMap) && (void 0 === input.compat || "object" == typeof input.compat && null !== input.compat && false === Array.isArray(input.compat) && _io1(input.compat, _exceptionable)) && (void 0 === input.customCSSInheritanceList || Array.isArray(input.customCSSInheritanceList) && input.customCSSInheritanceList.every((elem, _index1)=>"string" == typeof elem)) && (void 0 === input.debugInfoOutside || "boolean" == typeof input.debugInfoOutside) && (void 0 === input.defaultDisplayLinear || "boolean" == typeof input.defaultDisplayLinear) && (void 0 === input.enableAccessibilityElement || "boolean" == typeof input.enableAccessibilityElement) && (void 0 === input.enableCSSInheritance || "boolean" == typeof input.enableCSSInheritance) && (void 0 === input.enableCSSInvalidation || "boolean" == typeof input.enableCSSInvalidation) && (void 0 === input.enableCSSSelector || "boolean" == typeof input.enableCSSSelector) && (void 0 === input.enableNewGesture || "boolean" == typeof input.enableNewGesture) && (void 0 === input.enableRemoveCSSScope || "boolean" == typeof input.enableRemoveCSSScope) && (void 0 === input.firstScreenSyncTiming || "immediately" === input.firstScreenSyncTiming || "jsReady" === input.firstScreenSyncTiming) && (void 0 === input.enableSSR || "boolean" == typeof input.enableSSR) && (void 0 === input.removeDescendantSelectorScope || "boolean" == typeof input.removeDescendantSelectorScope) && (void 0 === input.shake || "object" == typeof input.shake && null !== input.shake && false === Array.isArray(input.shake) && _io4(input.shake, _exceptionable)) && (void 0 === input.defineDCE || "object" == typeof input.defineDCE && null !== input.defineDCE && false === Array.isArray(input.defineDCE) && _io5(input.defineDCE, _exceptionable)) && (void 0 === input.engineVersion || "string" == typeof input.engineVersion) && (void 0 === input.targetSdkVersion || "string" == typeof input.targetSdkVersion) && (void 0 === input.globalPropsMode || "reactive" === input.globalPropsMode || "event" === input.globalPropsMode) && null !== input.extractStr && (void 0 === input.extractStr || "boolean" == typeof input.extractStr || "object" == typeof input.extractStr && null !== input.extractStr && false === Array.isArray(input.extractStr) && _io7(input.extractStr, _exceptionable)) && (void 0 === input.experimental_isLazyBundle || "boolean" == typeof input.experimental_isLazyBundle) && (void 0 === input.experimental_useElementTemplate || "boolean" == typeof input.experimental_useElementTemplate) && null !== input.optimizeBundleSize && (void 0 === input.optimizeBundleSize || "boolean" == typeof input.optimizeBundleSize || "object" == typeof input.optimizeBundleSize && null !== input.optimizeBundleSize && false === Array.isArray(input.optimizeBundleSize) && _io8(input.optimizeBundleSize, _exceptionable)) && (0 === Object.keys(input).length || Object.keys(input).every((key)=>{
+    const _io0 = (input, _exceptionable = true)=>(void 0 === input.enableUiSourceMap || "boolean" == typeof input.enableUiSourceMap) && (void 0 === input.compat || "object" == typeof input.compat && null !== input.compat && false === Array.isArray(input.compat) && _io1(input.compat, _exceptionable)) && (void 0 === input.customCSSInheritanceList || Array.isArray(input.customCSSInheritanceList) && input.customCSSInheritanceList.every((elem, _index1)=>"string" == typeof elem)) && (void 0 === input.debugInfoOutside || "boolean" == typeof input.debugInfoOutside) && (void 0 === input.defaultDisplayLinear || "boolean" == typeof input.defaultDisplayLinear) && (void 0 === input.enableAccessibilityElement || "boolean" == typeof input.enableAccessibilityElement) && (void 0 === input.enableCSSInheritance || "boolean" == typeof input.enableCSSInheritance) && (void 0 === input.enableCSSInvalidation || "boolean" == typeof input.enableCSSInvalidation) && (void 0 === input.enableCSSSelector || "boolean" == typeof input.enableCSSSelector) && (void 0 === input.enableNewGesture || "boolean" == typeof input.enableNewGesture) && (void 0 === input.enableRemoveCSSScope || "boolean" == typeof input.enableRemoveCSSScope) && (void 0 === input.firstScreenSyncTiming || "immediately" === input.firstScreenSyncTiming || "jsReady" === input.firstScreenSyncTiming || "manual" === input.firstScreenSyncTiming) && (void 0 === input.enableSSR || "boolean" == typeof input.enableSSR) && (void 0 === input.removeDescendantSelectorScope || "boolean" == typeof input.removeDescendantSelectorScope) && (void 0 === input.shake || "object" == typeof input.shake && null !== input.shake && false === Array.isArray(input.shake) && _io4(input.shake, _exceptionable)) && (void 0 === input.defineDCE || "object" == typeof input.defineDCE && null !== input.defineDCE && false === Array.isArray(input.defineDCE) && _io5(input.defineDCE, _exceptionable)) && (void 0 === input.engineVersion || "string" == typeof input.engineVersion) && (void 0 === input.targetSdkVersion || "string" == typeof input.targetSdkVersion) && (void 0 === input.globalPropsMode || "reactive" === input.globalPropsMode || "event" === input.globalPropsMode) && null !== input.extractStr && (void 0 === input.extractStr || "boolean" == typeof input.extractStr || "object" == typeof input.extractStr && null !== input.extractStr && false === Array.isArray(input.extractStr) && _io7(input.extractStr, _exceptionable)) && (void 0 === input.experimental_isLazyBundle || "boolean" == typeof input.experimental_isLazyBundle) && (void 0 === input.experimental_useElementTemplate || "boolean" == typeof input.experimental_useElementTemplate) && null !== input.optimizeBundleSize && (void 0 === input.optimizeBundleSize || "boolean" == typeof input.optimizeBundleSize || "object" == typeof input.optimizeBundleSize && null !== input.optimizeBundleSize && false === Array.isArray(input.optimizeBundleSize) && _io8(input.optimizeBundleSize, _exceptionable)) && (0 === Object.keys(input).length || Object.keys(input).every((key)=>{
             if ([
                 "enableUiSourceMap",
                 "compat",
@@ -648,7 +673,7 @@ const validateConfig = (()=>{
             if (void 0 === value) return true;
             return false;
         }));
-    const _io1 = (input, _exceptionable = true)=>(void 0 === input.componentsPkg || Array.isArray(input.componentsPkg) && input.componentsPkg.every((elem, _index2)=>"string" == typeof elem)) && (void 0 === input.oldRuntimePkg || Array.isArray(input.oldRuntimePkg) && input.oldRuntimePkg.every((elem, _index3)=>"string" == typeof elem)) && (void 0 === input.newRuntimePkg || "string" == typeof input.newRuntimePkg) && (void 0 === input.additionalComponentAttributes || Array.isArray(input.additionalComponentAttributes) && input.additionalComponentAttributes.every((elem, _index4)=>"string" == typeof elem)) && null !== input.addComponentElement && (void 0 === input.addComponentElement || "boolean" == typeof input.addComponentElement || "object" == typeof input.addComponentElement && null !== input.addComponentElement && _io2(input.addComponentElement, _exceptionable)) && (void 0 === input.simplifyCtorLikeReactLynx2 || "boolean" == typeof input.simplifyCtorLikeReactLynx2) && (void 0 === input.removeComponentAttrRegex || "string" == typeof input.removeComponentAttrRegex) && (void 0 === input.disableDeprecatedWarning || "boolean" == typeof input.disableDeprecatedWarning) && null !== input.darkMode && (void 0 === input.darkMode || "boolean" == typeof input.darkMode || "object" == typeof input.darkMode && null !== input.darkMode && _io3(input.darkMode, _exceptionable)) && (void 0 === input.disableCreateSelectorQueryIncompatibleWarning || "boolean" == typeof input.disableCreateSelectorQueryIncompatibleWarning) && (0 === Object.keys(input).length || Object.keys(input).every((key)=>{
+    const _io1 = (input, _exceptionable = true)=>(void 0 === input.componentsPkg || Array.isArray(input.componentsPkg) && input.componentsPkg.every((elem, _index2)=>"string" == typeof elem)) && (void 0 === input.oldRuntimePkg || Array.isArray(input.oldRuntimePkg) && input.oldRuntimePkg.every((elem, _index3)=>"string" == typeof elem)) && (void 0 === input.newRuntimePkg || "string" == typeof input.newRuntimePkg) && (void 0 === input.additionalComponentAttributes || Array.isArray(input.additionalComponentAttributes) && input.additionalComponentAttributes.every((elem, _index4)=>"string" == typeof elem)) && null !== input.addComponentElement && (void 0 === input.addComponentElement || "boolean" == typeof input.addComponentElement || "object" == typeof input.addComponentElement && null !== input.addComponentElement && _io2(input.addComponentElement, _exceptionable)) && (void 0 === input.simplifyCtorLikeReactLynx2 || "boolean" == typeof input.simplifyCtorLikeReactLynx2) && (void 0 === input.removeComponentAttrRegex || "string" == typeof input.removeComponentAttrRegex) && (void 0 === input.disableDeprecatedWarning || "boolean" == typeof input.disableDeprecatedWarning) && null !== input.darkMode && (void 0 === input.darkMode || "boolean" == typeof input.darkMode || "object" == typeof input.darkMode && null !== input.darkMode && _io3(input.darkMode, _exceptionable)) && (void 0 === input.legacySlot || "boolean" == typeof input.legacySlot) && (void 0 === input.disableCreateSelectorQueryIncompatibleWarning || "boolean" == typeof input.disableCreateSelectorQueryIncompatibleWarning) && (0 === Object.keys(input).length || Object.keys(input).every((key)=>{
             if ([
                 "componentsPkg",
                 "oldRuntimePkg",
@@ -659,6 +684,7 @@ const validateConfig = (()=>{
                 "removeComponentAttrRegex",
                 "disableDeprecatedWarning",
                 "darkMode",
+                "legacySlot",
                 "disableCreateSelectorQueryIncompatibleWarning"
             ].some((prop)=>key === prop)) return true;
             const value = input[key];
@@ -792,10 +818,10 @@ const validateConfig = (()=>{
             path: _path + ".enableRemoveCSSScope",
             expected: "(boolean | undefined)",
             value: input.enableRemoveCSSScope
-        }, _errorFactory)) && (void 0 === input.firstScreenSyncTiming || "immediately" === input.firstScreenSyncTiming || "jsReady" === input.firstScreenSyncTiming || _assertGuard(_exceptionable, {
+        }, _errorFactory)) && (void 0 === input.firstScreenSyncTiming || "immediately" === input.firstScreenSyncTiming || "jsReady" === input.firstScreenSyncTiming || "manual" === input.firstScreenSyncTiming || _assertGuard(_exceptionable, {
             method: "typia.createAssertEquals",
             path: _path + ".firstScreenSyncTiming",
-            expected: "(\"immediately\" | \"jsReady\" | undefined)",
+            expected: "(\"immediately\" | \"jsReady\" | \"manual\" | undefined)",
             value: input.firstScreenSyncTiming
         }, _errorFactory)) && (void 0 === input.enableSSR || "boolean" == typeof input.enableSSR || _assertGuard(_exceptionable, {
             method: "typia.createAssertEquals",
@@ -1012,6 +1038,11 @@ const validateConfig = (()=>{
             path: _path + ".darkMode",
             expected: "(DarkModeConfig | boolean | undefined)",
             value: input.darkMode
+        }, _errorFactory)) && (void 0 === input.legacySlot || "boolean" == typeof input.legacySlot || _assertGuard(_exceptionable, {
+            method: "typia.createAssertEquals",
+            path: _path + ".legacySlot",
+            expected: "(boolean | undefined)",
+            value: input.legacySlot
         }, _errorFactory)) && (void 0 === input.disableCreateSelectorQueryIncompatibleWarning || "boolean" == typeof input.disableCreateSelectorQueryIncompatibleWarning || _assertGuard(_exceptionable, {
             method: "typia.createAssertEquals",
             path: _path + ".disableCreateSelectorQueryIncompatibleWarning",
@@ -1028,6 +1059,7 @@ const validateConfig = (()=>{
                 "removeComponentAttrRegex",
                 "disableDeprecatedWarning",
                 "darkMode",
+                "legacySlot",
                 "disableCreateSelectorQueryIncompatibleWarning"
             ].some((prop)=>key === prop)) return true;
             const value = input[key];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynx-js/react-rsbuild-plugin",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "description": "A rsbuild plugin for ReactLynx",
   "keywords": [
     "rsbuild",
@@ -33,21 +33,21 @@
   ],
   "dependencies": {
     "tiny-invariant": "^1.3.3",
-    "@lynx-js/css-extract-webpack-plugin": "0.8.0",
-    "@lynx-js/react-alias-rsbuild-plugin": "0.17.1",
-    "@lynx-js/react-refresh-webpack-plugin": "0.4.0",
-    "@lynx-js/react-webpack-plugin": "0.9.4",
-    "@lynx-js/runtime-wrapper-webpack-plugin": "0.2.0",
-    "@lynx-js/template-webpack-plugin": "0.12.1",
+    "@lynx-js/css-extract-webpack-plugin": "0.9.0",
+    "@lynx-js/react-alias-rsbuild-plugin": "0.18.0",
+    "@lynx-js/react-refresh-webpack-plugin": "0.4.1",
+    "@lynx-js/react-webpack-plugin": "0.10.0",
+    "@lynx-js/runtime-wrapper-webpack-plugin": "0.2.2",
+    "@lynx-js/template-webpack-plugin": "0.13.0",
     "@lynx-js/use-sync-external-store": "1.5.0",
     "background-only": "^0.0.1"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "7.58.2",
-    "@rsbuild/core": "2.0.11",
+    "@rsbuild/core": "2.1.4",
     "@rsbuild/plugin-sass": "1.5.2",
     "@rsbuild/plugin-typed-css-modules": "1.2.2",
-    "@rstest/core": "0.10.5",
+    "@rstest/core": "0.11.0",
     "rsbuild-plugin-arethetypeswrong": "0.3.1",
     "rsbuild-plugin-publint": "0.3.4",
     "source-map": "^0.7.6",
@@ -55,15 +55,15 @@
     "type-fest": "^5.4.4",
     "typia": "12.1.1",
     "typia-rspack-plugin": "3.0.1",
-    "@lynx-js/config-rsbuild-plugin": "0.1.0",
     "@lynx-js/debug-metadata": "0.1.0",
-    "@lynx-js/react": "0.122.0",
+    "@lynx-js/react": "0.123.0",
+    "@lynx-js/config-rsbuild-plugin": "0.1.1",
     "@lynx-js/react-transform": "0.2.0",
-    "@lynx-js/rspeedy": "0.15.1",
+    "@lynx-js/rspeedy": "0.16.0",
     "@lynx-js/test-tools": "0.0.0"
   },
   "peerDependencies": {
-    "@lynx-js/react": "^0.103.0 || ^0.104.0 || ^0.105.0 || ^0.106.0 || ^0.107.0 || ^0.108.0 || ^0.109.0 || ^0.110.0 || ^0.111.0 || ^0.112.0 || ^0.113.0 || ^0.114.0 || ^0.115.0 || ^0.116.0 || ^0.117.0 || ^0.118.0 || ^0.119.0 || ^0.120.0 || ^0.121.0 || ^0.122.0"
+    "@lynx-js/react": "^0.123.0"
   },
   "peerDependenciesMeta": {
     "@lynx-js/react": {