vite-plugin-taro 0.6.8 → 0.6.12

package/README.en.md

@@ -10,6 +10,8 @@ Build WeChat Mini Program and Web apps with Vite 8, React 19, Taro 4, and Tailwi
 
 Website: <https://vpt.js.org>
 
+> **AI-assisted development is recommended:** Follow the [VPT AI development guide](https://vpt.js.org/guides/ai/) and let a coding assistant create, develop, test, and validate your app.
+
 ## Quick Start
 
 ```sh
@@ -32,6 +34,7 @@ Continue with the [Quick Start guide](https://vpt.js.org/guides/quick-start/).
 ## Documentation
 
 - [Quick Start](https://vpt.js.org/guides/quick-start/)
+- [AI-assisted development](https://vpt.js.org/guides/ai/)
 - [Styles](https://vpt.js.org/guides/styles/)
 - [Automatic subpackages](https://vpt.js.org/guides/automatic-subpackages/)
 - [Native WeChat components](https://vpt.js.org/guides/native-components/)

package/README.md

@@ -10,6 +10,8 @@
 
 官网：<https://vpt.js.org>
 
+> **推荐使用 AI 开发：** 阅读 [VPT AI 开发指南](https://vpt.js.org/guides/ai/)，让编程助手创建项目并完成开发、测试和验证。
+
 ## 快速开始
 
 ```sh
@@ -33,6 +35,7 @@ npm create vite-taro@latest my-app
 ## 文档
 
 - [快速开始](https://vpt.js.org/guides/quick-start/)
+- [AI 开发指南](https://vpt.js.org/guides/ai/)
 - [样式](https://vpt.js.org/guides/styles/)
 - [全自动分包](https://vpt.js.org/guides/automatic-subpackages/)
 - [微信原生组件](https://vpt.js.org/guides/native-components/)

package/dist/node/plugins/wx/dev/dev-host.js

@@ -67,6 +67,11 @@ export async function createWxDevHost({ server, options, styles }) {
             throw result;
         }
         await engine.ensureCurrentBuildFinish();
+        // onOutput admission happens on Rolldown's callback stack, but its style publication runs asynchronously through
+        // hostActions. Drain that transaction before returning control to Vite: otherwise the HTTP server can bind while the
+        // initial output action is still finalizing styles, causing both that action and the later listening action to observe
+        // the port and rotate the build identity twice.
+        await hostActions.waitForIdle();
     };
     // Vite binds the port only after initServer (and therefore the initial build) completes, so
     // the actual port is not observable while onOutput runs for the first build. The App metadata

package/dist/node/plugins/wx/module/module.d.ts

@@ -19,15 +19,19 @@ export declare const appCapsulePath: string;
 export declare const componentShellFileName = "comp.js";
 /** Identifies the synchronous recursive Component shell source. */
 export declare const componentShellPath: string;
-/** Identifies the recursive Component capsule kept behind the native shell boundary. */
+/** Identifies the recursive Component capsule shared by generated Taro component shells. */
 export declare const componentCapsulePath: string;
+/** Forces Taro's CustomWrapper native shell to emit at its configured root path. */
+export declare const customWrapperShellFileName = "custom-wrapper.js";
+/** Identifies the synchronous CustomWrapper shell source. */
+export declare const customWrapperShellPath: string;
 /** Resolves the configured Page component from its route-qualified capsule importer. */
 export declare const pageComponentId = "\0vpt:page-component";
 /** Gives every Page shell one private capsule target that can be resolved using its route. */
 export declare const pageCapsuleId = "\0vpt:page-capsule";
 /** Provides the Page capsule source specialized through a stable route query. */
 export declare const pageCapsulePath: string;
-/** Identifies the Taro facade shared by the App, Page, and recursive Component capsules. */
+/** Identifies the Taro facade shared by the App, Page, and generated component capsules. */
 export declare const taroRuntimePath: string;
 /** Identifies the reusable synchronous native Page shell source. */
 export declare const pageShellPath: string;

package/dist/node/plugins/wx/module/module.js

@@ -22,21 +22,30 @@ export const appCapsulePath = resolvePackageFile('dist/runtime/wx/capsule/app.js
 export const componentShellFileName = 'comp.js';
 /** Identifies the synchronous recursive Component shell source. */
 export const componentShellPath = resolvePackageFile('dist/runtime/wx/native/component.js');
-/** Identifies the recursive Component capsule kept behind the native shell boundary. */
+/** Identifies the recursive Component capsule shared by generated Taro component shells. */
 export const componentCapsulePath = resolvePackageFile('dist/runtime/wx/capsule/component.js');
+/** Forces Taro's CustomWrapper native shell to emit at its configured root path. */
+export const customWrapperShellFileName = 'custom-wrapper.js';
+/** Identifies the synchronous CustomWrapper shell source. */
+export const customWrapperShellPath = resolvePackageFile('dist/runtime/wx/native/custom-wrapper.js');
 /** Resolves the configured Page component from its route-qualified capsule importer. */
 export const pageComponentId = '\0vpt:page-component';
 /** Gives every Page shell one private capsule target that can be resolved using its route. */
 export const pageCapsuleId = '\0vpt:page-capsule';
 /** Provides the Page capsule source specialized through a stable route query. */
 export const pageCapsulePath = resolvePackageFile('dist/runtime/wx/capsule/page.js');
-/** Identifies the Taro facade shared by the App, Page, and recursive Component capsules. */
+/** Identifies the Taro facade shared by the App, Page, and generated component capsules. */
 export const taroRuntimePath = resolvePackageFile('dist/runtime/wx/capsule/taro-runtime.js');
 /** Identifies the reusable synchronous native Page shell source. */
 export const pageShellPath = resolvePackageFile('dist/runtime/wx/native/page.js');
 // These fixed source identities describe entry roles independently from the final execution kind. A capsule entry may,
 // for example, become amphibious when Rolldown coalesces its generated runtime into the same output chunk.
-const shellModuleIds = new Set([appShellPath, componentShellPath, pageShellPath]);
+const shellModuleIds = new Set([
+    appShellPath,
+    componentShellPath,
+    customWrapperShellPath,
+    pageShellPath
+]);
 const capsuleModuleIds = new Set([appCapsulePath, componentCapsulePath, pageCapsulePath]);
 const amphibiousModuleIds = new Set([bootstrapPath, rolldownRuntimeId]);
 const transportModuleIds = new Set([transportPath]);

package/dist/node/plugins/wx/output/files.d.ts

@@ -2,10 +2,11 @@ import type { Rolldown } from 'vite';
 import type { VptOptions } from '../../../../options.ts';
 import type { GeneratedSubpackage, PackageLocation } from '../placer/placement.ts';
 /** Creates every compiler-owned WX file derived from the final Rolldown bundle. */
-export declare function createOutputFiles({ bundle, options, subpackages, getModuleInfo, getPackageLocation }: {
+export declare function createOutputFiles({ bundle, options, subpackages, isProduction, getModuleInfo, getPackageLocation }: {
     bundle: Rolldown.OutputBundle;
     options: VptOptions;
     subpackages: readonly GeneratedSubpackage[];
+    isProduction: boolean;
     getModuleInfo: (moduleId: string) => {
         meta: Rolldown.CustomPluginOptions;
     } | null;

package/dist/node/plugins/wx/output/files.js

@@ -1,8 +1,7 @@
 import { createNativeComponentOutput } from '../native/create-native-component-output.js';
-import { createJsonAssets } from './json.js';
 import { createTemplateAssets } from './templates.js';
 /** Creates every compiler-owned WX file derived from the final Rolldown bundle. */
-export async function createOutputFiles({ bundle, options, subpackages, getModuleInfo, getPackageLocation }) {
+export async function createOutputFiles({ bundle, options, subpackages, isProduction, getModuleInfo, getPackageLocation }) {
     const nativeOutput = await createNativeComponentOutput({ bundle, getModuleInfo, getPackageLocation });
     return [
         {
@@ -10,8 +9,13 @@ export async function createOutputFiles({ bundle, options, subpackages, getModul
             fileName: 'app.wxss',
             source: '@import "./assets/global.wxss";\n'
         },
-        ...createJsonAssets({ options, subpackages, nativeComponents: nativeOutput.registrations }),
-        ...createTemplateAssets(bundle, options, nativeOutput.registrations),
+        ...createTemplateAssets({
+            bundle: bundle,
+            options: options,
+            subpackages: subpackages,
+            nativeComponents: nativeOutput.registrations,
+            isProduction: isProduction
+        }),
         ...nativeOutput.files
     ];
 }

package/dist/node/plugins/wx/output/templates.d.ts

@@ -1,7 +1,17 @@
 import type { Rolldown } from 'vite';
 import type { VptOptions } from '../../../../options.ts';
-/** Creates Taro's shared WeChat templates and native WXML/WXSS companions for every Page. */
-export declare function createTemplateAssets(bundle: Rolldown.OutputBundle, options: VptOptions, nativeComponents: readonly {
+import { type GeneratedSubpackage } from '../placer/placement.ts';
+type NativeComponentRegistration = {
     name: string;
+    componentPath: string;
     fields: readonly string[];
-}[]): Rolldown.EmittedAsset[];
+};
+/** Creates every JSON, WXML, WXS, and Page WXSS asset owned by Taro's native rendering boundary. */
+export declare function createTemplateAssets({ bundle, options, subpackages, nativeComponents, isProduction }: {
+    bundle: Rolldown.OutputBundle;
+    options: VptOptions;
+    subpackages: readonly GeneratedSubpackage[];
+    nativeComponents: readonly NativeComponentRegistration[];
+    isProduction: boolean;
+}): Rolldown.EmittedAsset[];
+export {};

package/dist/node/plugins/wx/output/templates.js

@@ -2,24 +2,38 @@ import { recursiveMerge } from '@tarojs/helper';
 import { Weapp as WxPlatform } from '@tarojs/plugin-platform-weapp';
 import { normalizeModuleId } from '../../../utils/modules.js';
 import { packageRequire } from '../../../utils/packages.js';
-import { renderJson } from './json.js';
+import { createAppConfig } from '../../../utils/project-config.js';
+import { isGeneratedSubpackageFile } from '../placer/placement.js';
 import { toRootRelativePath } from './relative-root.js';
+const customWrapperName = 'custom-wrapper';
 const taroComponentsModulePath = packageRequire.resolve('@tarojs/plugin-platform-weapp/dist/components-react');
-/** Creates Taro's shared WeChat templates and native WXML/WXSS companions for every Page. */
-export function createTemplateAssets(bundle, options, nativeComponents) {
+/** Creates every JSON, WXML, WXS, and Page WXSS asset owned by Taro's native rendering boundary. */
+export function createTemplateAssets({ bundle, options, subpackages, nativeComponents, isProduction }) {
     const templateBuilder = createTemplateBuilder();
+    const componentConfig = collectTemplateComponentConfig(bundle, nativeComponents);
+    const recursiveComponentJson = createRecursiveComponentJson();
+    const jsonAsset = (fileName, value) => createJsonAsset(fileName, value, isProduction);
     return [
-        createAsset('base.wxml', templateBuilder.buildBaseTemplate(collectTemplateComponentConfig(bundle, nativeComponents))),
+        jsonAsset('app.json', createAppJson({ options, subpackages, nativeComponents })),
+        createAsset('base.wxml', templateBuilder.buildBaseTemplate(componentConfig)),
         createAsset('utils.wxs', templateBuilder.buildXScript()),
         createAsset('comp.wxml', templateBuilder.buildBaseComponentTemplate('.wxml')),
-        createAsset('comp.json', renderJson(createComponentJson())),
+        jsonAsset('comp.json', recursiveComponentJson),
+        createAsset('custom-wrapper.wxml', templateBuilder.buildCustomComponentTemplate('.wxml')),
+        jsonAsset('custom-wrapper.json', recursiveComponentJson),
         ...options.pages.flatMap((page) => [
+            jsonAsset(`${page.path}.json`, createPageJson(page)),
             createAsset(`${page.path}.wxml`, templateBuilder.buildPageTemplate(toRootRelativePath(page.path, 'base.wxml'), {
                 content: page.config,
                 path: page.path
             })),
             createAsset(`${page.path}.wxss`, '')
-        ])
+        ]),
+        jsonAsset('project.config.json', options.projectConfigJson),
+        ...(options.projectPrivateConfigJson
+            ? [jsonAsset('project.private.config.json', options.projectPrivateConfigJson)]
+            : []),
+        ...(options.sitemapJson ? [jsonAsset('sitemap.json', options.sitemapJson)] : [])
     ];
 }
 /**
@@ -42,16 +56,19 @@ export function createTemplateAssets(bundle, options, nativeComponents) {
  *
  * Build-time output
  * -----------------
- * createTemplateAssets still asks one builder for the normal five products: shared base.wxml, utils.wxs, comp.wxml,
- * comp.json, and each Page WXML. This adapter specializes only the two products that own the native join:
+ * createTemplateAssets asks one builder for shared base.wxml, utils.wxs, comp.wxml, custom-wrapper.wxml, and each Page WXML.
+ * This adapter specializes the products that own the native join:
  *
- * - shared base.wxml receives branch-local slot forwarding plus vpt_fragment and vpt_page_outlet template definitions;
+ * - shared base.wxml receives branch-local slot forwarding at comp boundaries plus vpt_fragment and vpt_page_outlet
+ *   template definitions;
  * - each Page WXML replaces Taro's root:root entry with one generic comp bound to app and one caller-owned taro_tmpl bound
  *   to page as that component's default slot.
  *
- * utils.wxs remains Taro's normal compact-node dispatcher. comp.wxml and comp.json remain Taro's generic depth-reset
- * component and still know only i, l, virtual-host behavior, and eh event dispatch. There is one shared template namespace,
- * no Page-specific base file, no App/Page mode property, and no Page object threaded through App template data.
+ * utils.wxs remains Taro's normal compact-node dispatcher. comp.wxml and custom-wrapper.wxml retain Taro's generic compact
+ * rendering contracts; their JSON companions register only recursive boundaries, while runtime configs retain standard
+ * event dispatch. CustomWrapper keeps Taro's Page-local ownership model and is not made slot-transparent for App wrapping.
+ * There is one shared template namespace, no Page-specific base file, no App/Page mode property, and no Page object threaded
+ * through App template data.
  *
  * First native Page
  * -----------------
@@ -74,7 +91,7 @@ export function createTemplateAssets(bundle, options, nativeComponents) {
  *      -> comp.wxml (owns App eh, imports unchanged utils.wxs and shared base.wxml)
  *         -> tmpl_0_vpt_fragment (iterates the real App compact roots in app.cn)
  *            -> stock Taro templates (render App hosts and recurse through their cn arrays)
- *               -> depth-reset <comp i="{{i}}" l="{{l}}">
+ *               -> native recursion boundary <comp ...>
  *                    -> forwards <slot /> only when this compact subtree root has i.vo
  *               -> tmpl_0_vpt_page_outlet at React's exact {children} position
  *                  -> <slot />
@@ -90,8 +107,8 @@ export function createTemplateAssets(bundle, options, nativeComponents) {
  * Slots transfer caller-owned light DOM only. They do not transfer the caller's named-template table or WXS modules. App
  * dispatch runs inside comp.wxml, so vpt_fragment and vpt_page_outlet must live in base.wxml imported by that component.
  * Putting those definitions in buildPageTemplate produces Page WXML that compiles, but component runtime dispatch fails with
- * `Template tmpl_0_vpt_fragment not found`. Shared base.wxml makes the names visible in the root and every depth-reset comp
- * scope and emits them once rather than once per Page.
+ * `Template tmpl_0_vpt_fragment not found`. Shared base.wxml makes the names visible in the root and every recursive
+ * component scope and emits them once rather than once per Page.
  *
  * Projection-spine ownership
  * --------------------------
@@ -99,8 +116,8 @@ export function createTemplateAssets(bundle, options, nativeComponents) {
  * skips the unchanged root-side suffix, gives old leaf-side nodes the ordinary host prop vo=false, and gives new ones vo=true.
  * Taro's existing lazy structural hydration runs later and therefore serializes those props without projection-specific
  * scheduler or hydrate behavior. If React replaces the outlet host while moving it, the renderer finds the unique new marker
- * once and caches its new ancestor array. At a depth reset, i.vo makes forwarding an O(1) local decision; WXML never searches
- * descendants, and Page trees instantiate no unnamed slot.
+ * once and caches its new ancestor array. At each depth-reset comp boundary, i.vo makes forwarding an O(1) local decision;
+ * WXML never searches descendants, and Page trees instantiate no unnamed slot.
  *
  * Steady-state updates and navigation
  * -----------------------------------
@@ -113,11 +130,12 @@ export function createTemplateAssets(bundle, options, nativeComponents) {
  *
  * Method responsibilities
  * -----------------------
- * 1. buildBaseTemplate wraps Taro's buildTemplate output, preserves every stock host template, guards the slot at Taro's
- *    existing depth-reset call site with i.vo, and adds the two private definitions to the shared namespace.
+ * 1. buildBaseTemplate preserves stock host templates, makes each depth-reset comp boundary slot-transparent through i.vo,
+ *    and adds the two private definitions to the shared namespace.
  * 2. buildPageTemplate owns only the Page boundary: app binding, page binding, and the single Page-content slot.
  * 3. buildXScript delegates unchanged because routing metadata already travels inside compact node i.
  * 4. buildBaseComponentTemplate delegates unchanged so recursive comp remains generic and feature-independent.
+ * 5. buildCustomComponentTemplate delegates unchanged so CustomWrapper renders compact children in its own native scope.
  *
  * H5 never calls this WX output builder. Its App continues to receive ordinary Fragment children and none of these native
  * data roots, templates, custom-component boundaries, or slot rules enter the browser build.
@@ -208,6 +226,10 @@ function createTemplateBuilder() {
              */
             return taroTemplateBuilder.buildBaseComponentTemplate(ext);
         },
+        buildCustomComponentTemplate: (ext) => {
+            // CustomWrapper renders its compact children in its own native scope; imported base templates perform dispatch.
+            return taroTemplateBuilder.buildCustomComponentTemplate(ext);
+        },
         buildPageTemplate: (baseTempPath, page) => {
             const source = taroTemplateBuilder.buildPageTemplate(baseTempPath, page);
             /*
@@ -222,10 +244,11 @@ function createTemplateBuilder() {
         }
     };
 }
-/** Creates template metadata from reachable Taro hosts and native component JSX fields. */
+/** Creates template metadata from reachable Taro hosts, the standard CustomWrapper boundary, and native JSX fields. */
 function collectTemplateComponentConfig(bundle, nativeComponents) {
-    // This local config accumulates names in output order before the template builder consumes it.
-    const config = {
+    const components = findBundleModule(bundle, taroComponentsModulePath);
+    const renderedComponentNames = (components?.renderedExports ?? []).map(toDashed);
+    return {
         includes: new Set([
             'view',
             'catch-view',
@@ -236,20 +259,16 @@ function collectTemplateComponentConfig(bundle, nativeComponents) {
             'image',
             'static-image',
             'text',
-            'static-text'
+            'static-text',
+            ...renderedComponentNames.filter((name) => name !== customWrapperName)
         ]),
         exclude: new Set(),
-        thirdPartyComponents: new Map(),
+        thirdPartyComponents: new Map([
+            [customWrapperName, new Set()],
+            ...nativeComponents.map((component) => [component.name, new Set(component.fields)])
+        ]),
         includeAll: false
     };
-    const components = findBundleModule(bundle, taroComponentsModulePath);
-    for (const name of components?.renderedExports ?? []) {
-        config.includes.add(toDashed(name));
-    }
-    for (const component of nativeComponents) {
-        config.thirdPartyComponents.set(component.name, new Set(component.fields));
-    }
-    return config;
 }
 /** Finds one module in the final chunk metadata. */
 function findBundleModule(bundle, resolvedId) {
@@ -268,21 +287,68 @@ function findBundleModule(bundle, resolvedId) {
 function toDashed(value) {
     return value.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
 }
-/** Creates the recursive component configuration expected by Taro's templates. */
-function createComponentJson() {
+/** Creates App JSON with globally inherited native registrations and generated subpackages. */
+function createAppJson({ options, subpackages, nativeComponents }) {
+    const appConfig = createAppConfig(options);
+    const nativeUsingComponents = nativeComponents.map(({ name, componentPath }) => [name, componentPath]);
+    // Cross-package components require a placeholder while WeChat downloads their generated subpackage. Paths are
+    // root-absolute, so remove the leading slash before testing the output-relative subpackage prefix.
+    // https://developers.weixin.qq.com/miniprogram/dev/framework/subpackages/async.html
+    // https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/placeholder.html
+    const componentPlaceholders = nativeComponents.flatMap(({ name, componentPath }) => isGeneratedSubpackageFile(componentPath.slice(1)) ? [[name, 'view']] : []);
+    return {
+        ...appConfig,
+        ...(nativeUsingComponents.length > 0
+            ? {
+                usingComponents: {
+                    ...(isJsonObject(appConfig.usingComponents) ? appConfig.usingComponents : {}),
+                    ...Object.fromEntries(nativeUsingComponents)
+                }
+            }
+            : {}),
+        ...(componentPlaceholders.length > 0
+            ? {
+                componentPlaceholder: {
+                    ...(isJsonObject(appConfig.componentPlaceholder) ? appConfig.componentPlaceholder : {}),
+                    ...Object.fromEntries(componentPlaceholders)
+                }
+            }
+            : {}),
+        ...(subpackages.length > 0 ? { subPackages: subpackages } : {})
+    };
+}
+/** Preserves configured Page JSON and registers the generated recursive component entries. */
+function createPageJson(page) {
+    const usingComponents = isJsonObject(page.config.usingComponents) ? page.config.usingComponents : {};
+    return {
+        ...page.config,
+        usingComponents: {
+            ...usingComponents,
+            comp: toRootRelativePath(page.path, 'comp'),
+            [customWrapperName]: toRootRelativePath(page.path, customWrapperName)
+        }
+    };
+}
+/** Creates the shared recursive component configuration used by comp and CustomWrapper. */
+function createRecursiveComponentJson() {
     return {
         component: true,
         styleIsolation: 'apply-shared',
         usingComponents: {
-            comp: './comp'
+            comp: './comp',
+            [customWrapperName]: `./${customWrapperName}`
         }
     };
 }
-/** Creates one emitted template or style asset. */
+/** Tests whether a configured JSON value can be merged as an object. */
+function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Creates compact production JSON and readable development JSON. */
+function createJsonAsset(fileName, value, isProduction) {
+    return createAsset(fileName, isProduction ? JSON.stringify(value) : `${JSON.stringify(value, null, 4)}\n`);
+}
+/** Creates one emitted text asset. */
 function createAsset(fileName, source) {
-    return {
-        type: 'asset',
-        fileName,
-        source
-    };
+    return { type: 'asset', fileName: fileName, source: source };
 }

package/dist/node/plugins/wx/plugins.js

@@ -119,6 +119,7 @@ function createWxPlugin(options, resolver, placement) {
                     bundle,
                     options,
                     subpackages,
+                    isProduction: this.environment.config.isProduction,
                     getModuleInfo: (moduleId) => this.getModuleInfo(moduleId),
                     getPackageLocation: placement.getPackageLocation
                 });

package/dist/node/plugins/wx/resolve/resolver.js

@@ -2,7 +2,7 @@ import { normalizePath } from 'vite';
 import { normalizeModuleId, resolveAppComponentPath, resolvePageComponentPath } from '../../../utils/modules.js';
 import { createAppConfig } from '../../../utils/project-config.js';
 import { appComponentId } from '../../client/constant.js';
-import { appCapsulePath, appShellFileName, appShellPath, bootstrapPath, componentCapsulePath, componentShellFileName, componentShellPath, pageCapsuleId, pageCapsulePath, pageComponentId, pageShellPath, transportPath, vitePreloadId } from '../module/module.js';
+import { appCapsulePath, appShellFileName, appShellPath, bootstrapPath, componentCapsulePath, componentShellFileName, componentShellPath, customWrapperShellFileName, customWrapperShellPath, pageCapsuleId, pageCapsulePath, pageComponentId, pageShellPath, transportPath, vitePreloadId } from '../module/module.js';
 import { specializeAppCapsule } from './specialize-app-capsule.js';
 import { specializePageCapsule } from './specialize-page-capsule.js';
 /** Creates the resolver and source specializer for the wx module graph. */
@@ -76,6 +76,7 @@ function createEntryGraph(pages) {
             ['app-capsule', appCapsulePath],
             [componentShellFileName, componentShellPath],
             ['component-capsule', componentCapsulePath],
+            [customWrapperShellFileName, customWrapperShellPath],
             ...pageEntries.flatMap((entry) => {
                 return [
                     [entry.shellName, entry.shellId],

package/dist/node/plugins/wx/styles/plugins.js

@@ -140,6 +140,18 @@ export function createWxStylePlugin(applicationEntryIds) {
     const finalizeCurrentOutput = (context, javaScript) => {
         return finalizeOutput(entryIds, styleByModuleId, context.getModuleInfo.bind(context), weappContext, javaScript);
     };
+    /** Invalidates every Tailwind root fed by one changed compiler dependency. */
+    const invalidateTailwindDependencies = (dependencyId) => {
+        styleByModuleId.forEach((style, styleId) => {
+            if (style.tailwind?.dependencies.has(dependencyId)) {
+                styleByModuleId.set(styleId, {
+                    css: style.css,
+                    // The owning root transform replaces the generator using current source and plugin context.
+                    tailwind: { ...style.tailwind, invalidated: true }
+                });
+            }
+        });
+    };
     /** Releases native compiler resources while retaining captured CSS needed by subsequent output callbacks. */
     const disposeTailwindRoots = () => {
         styleByModuleId.forEach((style, styleId) => {
@@ -219,19 +231,14 @@ export function createWxStylePlugin(applicationEntryIds) {
                 return { code: compiled.css, map: null };
             }
         },
-        /** Marks roots whose compiler inputs changed; Rolldown still decides when those roots are transformed. */
+        /** Invalidates compiler state before Rolldown transforms roots selected through their watched dependencies. */
+        hotUpdate(update) {
+            invalidateTailwindDependencies(normalizeModuleId(update.file));
+            return update.modules;
+        },
+        /** Marks roots whose compiler inputs changed for non-HMR Rolldown watch lifecycles. */
         watchChange(id) {
-            const dependencyId = normalizeModuleId(id);
-            // A dependency may feed multiple roots, so every retained root must be checked before the next transform wave.
-            styleByModuleId.forEach((style, styleId) => {
-                if (style.tailwind?.dependencies.has(dependencyId)) {
-                    styleByModuleId.set(styleId, {
-                        css: style.css,
-                        // Delay generator replacement until the owning root transform has current root source and graph context.
-                        tailwind: { ...style.tailwind, invalidated: true }
-                    });
-                }
-            });
+            invalidateTailwindDependencies(normalizeModuleId(id));
         },
         generateBundle: {
             // Vite must finish chunking and CSS extraction before VPT can finalize the complete WX output transaction.

package/dist/runtime/wx/capsule/component.d.ts

@@ -1,3 +1,3 @@
 import './app.ts';
-declare const _default: any;
-export default _default;
+export declare const componentConfig: any;
+export declare const customWrapperConfig: any;

package/dist/runtime/wx/capsule/component.js

@@ -1,4 +1,5 @@
-// Keep recursive Component activation behind the same App initialization barrier as Page activation.
+// Keep generated recursive component activation behind the same App initialization barrier as Page activation.
 import './app.js';
 import { createRecursiveComponentConfig } from './taro-runtime.js';
-export default createRecursiveComponentConfig('comp');
+export const componentConfig = createRecursiveComponentConfig('comp');
+export const customWrapperConfig = createRecursiveComponentConfig('custom-wrapper');

package/dist/runtime/wx/capsule/taro-runtime.d.ts

@@ -1,5 +1,5 @@
 /** biome-ignore-all assist/source/organizeImports: keep side effect orders */
-/** Taro runtime exports shared by the App, Page, and recursive Component capsules. */
+/** Taro runtime exports shared by the App, Page, and generated recursive component capsules. */
 import '@tarojs/plugin-platform-weapp/dist/runtime.js';
 export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
 export { default as ReactDOM } from '@tarojs/react';

package/dist/runtime/wx/capsule/taro-runtime.js

@@ -1,5 +1,5 @@
 /** biome-ignore-all assist/source/organizeImports: keep side effect orders */
-/** Taro runtime exports shared by the App, Page, and recursive Component capsules. */
+/** Taro runtime exports shared by the App, Page, and generated recursive component capsules. */
 import '@tarojs/plugin-platform-weapp/dist/runtime.js';
 export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
 export { default as ReactDOM } from '@tarojs/react';

package/dist/runtime/wx/native/component.js

@@ -1,3 +1,3 @@
 import '../amphibious/bootstrap.js';
-import componentConfig from '../capsule/component.js';
+import { componentConfig } from '../capsule/component.js';
 Component(componentConfig);

package/dist/runtime/wx/native/custom-wrapper.d.ts

@@ -0,0 +1 @@
+import '../amphibious/bootstrap.ts';

package/dist/runtime/wx/native/custom-wrapper.js

@@ -0,0 +1,3 @@
+import '../amphibious/bootstrap.js';
+import { customWrapperConfig } from '../capsule/component.js';
+Component(customWrapperConfig);

package/dist/runtime/wx/systemjs/system-core.js

@@ -16,8 +16,8 @@
  */
 var envGlobal = global;
 var hasSymbol = typeof Symbol !== 'undefined';
-function errMsg(errCode, msg) {
-    return (msg || '') + ' (SystemJS https://github.com/systemjs/systemjs/blob/main/docs/errors.md#' + errCode + ')';
+function createMissingRegistrationError(id) {
+    return Error('Module did not instantiate: ' + id);
 }
 export { REGISTRY, systemJSPrototype };
 var toStringTag = hasSymbol && Symbol.toStringTag;
@@ -63,7 +63,7 @@ function linkLoadSync(loader, id) {
     if (isThenable(registration))
         throw createAsyncGraphError(id);
     if (!registration)
-        throw Error(errMsg(2, id));
+        throw createMissingRegistrationError(id);
     // This row is intentionally mutable SystemJS-owned linking and execution state.
     var load = {
         id: id,
@@ -170,7 +170,7 @@ export function getOrCreateLoad(loader, id, firstParentUrl, meta) {
     })
         .then(function (registration) {
         if (!registration)
-            throw Error(errMsg(2, id));
+            throw createMissingRegistrationError(id);
         var declared = registration[1](createExport(load), registration[1].length === 2 ? createDeclarationContext(loader, id) : undefined);
         load.e = declared.execute || function () { };
         return [registration[0], declared.setters || [], registration[2] || []];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.6.8",
+  "version": "0.6.12",
   "author": "sep2",
   "description": "Vite 8 plugin for building one React/Taro codebase for WeChat Mini Program and H5 targets.",
   "type": "module",
@@ -75,15 +75,38 @@
     "rxjs": "^7.8.2",
     "tailwindcss": "^4.3.3",
     "weapp-tailwindcss": "^5.2.11",
-    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.6.8",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.6.8",
-    "@tarojs/runtime": "npm:vite-plugin-taro-runtime@0.6.8"
+    "@tarojs/react": "npm:vite-plugin-taro-react@0.6.12",
+    "@tarojs/runtime": "npm:vite-plugin-taro-runtime@0.6.12",
+    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.6.12"
   },
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "vite": "8.2.1"
   },
+  "c8": {
+    "all": true,
+    "include": [
+      "src/**/*.{ts,js}"
+    ],
+    "exclude": [
+      "src/**/*.test.ts",
+      "src/**/*.d.ts",
+      "src/options.ts"
+    ],
+    "reporter": [
+      "text",
+      "html",
+      "lcov",
+      "json-summary"
+    ],
+    "reports-dir": "coverage",
+    "check-coverage": true,
+    "statements": 90,
+    "branches": 85,
+    "functions": 90,
+    "lines": 90
+  },
   "devDependencies": {
     "@babel/plugin-transform-dynamic-import": "^7.29.7",
     "@babel/plugin-transform-modules-commonjs": "^7.29.7",
@@ -94,12 +117,14 @@
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "@types/react-refresh": "^0.14.7",
+    "c8": "^10.1.3",
     "typescript": "^7.0.2",
     "vite": "8.2.1"
   },
   "scripts": {
     "build": "node ../../scripts/sync-plugin-readme.ts && node ../../scripts/clean-directory.ts dist && tsc --project tsconfig.build.json",
-    "test": "node --test",
+    "test": "node --test --test-concurrency=2",
+    "test:coverage": "c8 node --test --test-concurrency=2",
     "typecheck": "tsc --project tsconfig.json --noEmit"
   }
 }