vite-plugin-taro 0.6.0 → 0.6.2

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

@@ -1,19 +1,24 @@
 import path from 'node:path';
-import { types } from '@babel/core';
+import * as types from '@babel/types';
 import { replaceWithAst } from '../../../utils/transform.js';
-import { getWxExecutionKind } from '../module.js';
+import { toLogicalChunkId } from '../module/chunk-path.js';
+import { getWxExecutionKind } from '../module/module.js';
 const transportPlaceholder = '__VPT_TRANSPORT__';
 const moduleIdParameter = 'moduleId';
 const exportBindingParameter = 'exportBinding';
 /**
- * Materializes transport while Rolldown's preliminary hash placeholders are still active, so every injected physical
- * reference participates in final hash calculation instead of changing code after its filename has been fixed.
+ * Materializes transport while Rolldown's preliminary hash placeholders are still active. Each switch case deliberately has
+ * two IDs: the package-neutral preliminary filename without its `assets/` directory becomes the SystemJS registration
+ * identity, while the LTHP-selected assets/package-qualified filename becomes the literal native require path. Rolldown
+ * substitutes both hashes after this transform, so the
+ * generated transport code and its own content hash describe the exact files that `generateBundle` later materializes.
  *
  * This intentionally creates broad hash invalidation: changing one capsule can rename transport, then bootstrap, then
  * chunks that import bootstrap. A Mini Program ships one application package rather than independently cached HTTP
  * chunks, so honest content hashes and automatic graph linking are more valuable than minimizing that hash fan-out.
  */
-export async function materializeTransport({ code, transportChunk, chunks, getLoadMode, sourcemap = true }) {
+export async function materializeTransport({ code, transportChunk, chunks, getLoadMode, getPhysicalChunkId = (chunk) => chunk.fileName, sourcemap = true }) {
+    const physicalTransportId = getPhysicalChunkId(transportChunk);
     // Babel constructs and safely serializes an expression shaped like:
     // (moduleId) => {
     //     switch (moduleId) {
@@ -28,12 +33,16 @@ export async function materializeTransport({ code, transportChunk, chunks, getLo
         .sort((left, right) => left.chunk.fileName.localeCompare(right.chunk.fileName))
         .map(({ chunk, kind }) => {
         const loadMode = getLoadMode(chunk);
+        const logicalChunkId = toLogicalChunkId(chunk.fileName);
+        // Only native loading crosses the logical/physical boundary and receives the assets/package-qualified path.
+        const physicalChunkId = getPhysicalChunkId(chunk);
         if (kind === 'amphibious' && loadMode !== 'sync') {
             throw new Error(`Amphibious wx module must be in the main package: ${chunk.fileName}`);
         }
         return createTransportCase({
-            chunkId: chunk.fileName,
-            transportFileName: transportChunk.fileName,
+            chunkId: logicalChunkId,
+            transportFileName: physicalTransportId,
+            physicalChunkId: physicalChunkId,
             loadMode,
             kind
         });
@@ -58,9 +67,9 @@ function getTransportedChunks(chunks) {
     }
     return transportedChunks;
 }
-/** Creates one canonical-ID switch case while keeping its native require argument literal. */
-function createTransportCase({ chunkId, transportFileName, loadMode, kind }) {
-    const requirePath = toNativeRequirePath(transportFileName, chunkId);
+/** Creates one logical-ID switch case while keeping its physical native require argument literal. */
+function createTransportCase({ chunkId, transportFileName, loadMode, kind, physicalChunkId }) {
+    const requirePath = toNativeRequirePath(transportFileName, physicalChunkId);
     const requireCallee = loadMode === 'sync'
         ? types.identifier('require')
         : types.memberExpression(types.identifier('require'), types.identifier('async'));

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.js';
+import { appCapsulePath, appShellFileName, appShellPath, bootstrapPath, componentCapsulePath, componentShellFileName, componentShellPath, pageCapsuleId, pageCapsulePath, pageComponentId, pageShellPath, transportPath, vitePreloadId } from '../module/module.js';
 import { specializeBootstrap } from './specialize-bootstrap.js';
 import { specializePageCapsule } from './specialize-page-capsule.js';
 /** Creates the resolver and source specializer for the wx module graph. */

package/dist/node/plugins/wx/resolve/specialize-bootstrap.js

@@ -1,4 +1,4 @@
-import { types } from '@babel/core';
+import * as types from '@babel/types';
 import { replaceWithAst } from '../../../utils/transform.js';
 const appConfigPlaceholder = '__VPT_APP_CONFIG__';
 /** Specializes the amphibious bootstrap with the shared App configuration. */

package/dist/node/plugins/wx/resolve/specialize-page-capsule.js

@@ -1,4 +1,4 @@
-import { types } from '@babel/core';
+import * as types from '@babel/types';
 import { replaceWithAst } from '../../../utils/transform.js';
 const pagePathPlaceholder = '__VPT_PAGE_PATH__';
 const pageConfigPlaceholder = '__VPT_PAGE_CONFIG__';

package/dist/node/utils/modules.d.ts

@@ -6,8 +6,6 @@ type PageComponentPathOptions = {
     pagePath: string;
     projectRoot: string;
 };
-/** Resolves a final relative reference to the canonical output chunk ID used by the WX module registry. */
-export declare function resolveChunkReference(importerChunkId: string, reference: string): string;
 /** Resolves the source file for the configured App component. */
 export declare function resolveAppComponentPath({ appPath, projectRoot }: AppComponentPathOptions): string;
 /** Resolves the source file for one configured Page component. */

package/dist/node/utils/modules.js

@@ -1,12 +1,5 @@
 import path from 'node:path';
 import { normalizePath } from 'vite';
-/** Resolves a final relative reference to the canonical output chunk ID used by the WX module registry. */
-export function resolveChunkReference(importerChunkId, reference) {
-    if (!reference.startsWith('./') && !reference.startsWith('../')) {
-        throw new Error(`Expected a relative chunk reference in ${importerChunkId}: ${reference}`);
-    }
-    return path.posix.join(path.posix.dirname(importerChunkId), reference);
-}
 /** Resolves the source file for the configured App component. */
 export function resolveAppComponentPath({ appPath, projectRoot }) {
     return path.resolve(projectRoot, appPath);

package/dist/node/utils/transform.d.ts

@@ -1,4 +1,3 @@
-import { type PluginItem } from '@babel/core';
 import { generate } from '@babel/generator';
 import { type Rolldown } from 'vite';
 export type AstTransformResult = {
@@ -7,5 +6,3 @@ export type AstTransformResult = {
 };
 /** Replaces each placeholder with a Babel AST expression while transforming the module through Oxc. */
 export declare function replaceWithAst(code: string, filename: string, replacement: Readonly<Record<string, Parameters<typeof generate>[0]>>, sourcemap?: boolean): Promise<AstTransformResult>;
-/** Transforms one module with Babel's shared parser and source-map configuration. */
-export declare function transformWithBabel(code: string, filename: string, plugins: PluginItem[], sourcemap?: boolean): AstTransformResult;

package/dist/node/utils/transform.js

@@ -1,4 +1,3 @@
-import { transformSync } from '@babel/core';
 import { generate } from '@babel/generator';
 import { transformWithOxc } from 'vite';
 import { esTarget } from './constant.js';
@@ -34,25 +33,3 @@ function requireOnePlaceholder(code, placeholder) {
         throw new Error(`Expected one placeholder ${placeholder}, found ${replacementCount}`);
     }
 }
-/** Transforms one module with Babel's shared parser and source-map configuration. */
-export function transformWithBabel(code, filename, plugins, sourcemap = true) {
-    const transformed = transformSync(code, {
-        babelrc: false,
-        compact: true,
-        minified: true,
-        comments: false,
-        configFile: false,
-        filename,
-        plugins,
-        sourceFileName: filename,
-        sourceMaps: sourcemap,
-        sourceType: 'module'
-    });
-    if (!transformed?.code || (sourcemap && !transformed.map)) {
-        throw new Error(`Failed to transform ${filename} with Babel`);
-    }
-    return {
-        code: transformed.code,
-        map: sourcemap ? transformed.map : null
-    };
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "author": "sep2",
   "description": "Vite 8 plugin for building one React/Taro codebase for WeChat Mini Program and H5 targets.",
   "type": "module",
@@ -53,9 +53,8 @@
   "dependencies": {
     "@babel/core": "^7.29.7",
     "@babel/generator": "^7.29.8",
-    "@babel/plugin-transform-dynamic-import": "^7.29.7",
-    "@babel/plugin-transform-modules-commonjs": "^7.29.7",
-    "@babel/plugin-transform-modules-systemjs": "^7.29.8",
+    "@babel/types": "^7.29.8",
+    "@oxc-project/types": "0.143.0",
     "@rolldown/plugin-babel": "^0.2.3",
     "@tailwindcss-mangle/engine": "0.2.0",
     "@tarojs/components": "4.2.0",
@@ -76,8 +75,8 @@
     "rxjs": "^7.8.2",
     "tailwindcss": "^4.3.3",
     "weapp-tailwindcss": "^5.2.11",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.6.0",
-    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.6.0"
+    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.6.2",
+    "@tarojs/react": "npm:vite-plugin-taro-react@0.6.2"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -85,6 +84,9 @@
     "vite": "8.2.1"
   },
   "devDependencies": {
+    "@babel/plugin-transform-dynamic-import": "^7.29.7",
+    "@babel/plugin-transform-modules-commonjs": "^7.29.7",
+    "@babel/plugin-transform-modules-systemjs": "^7.29.8",
     "@types/babel__core": "^7.20.5",
     "@types/babel__generator": "^7.27.0",
     "@types/node": "^26.1.1",

package/src/node/plugins/h5/transform-app.ts

@@ -1,4 +1,4 @@
-import { types } from '@babel/core'
+import * as types from '@babel/types'
 import type { VptOptions, VptPageOption } from '../../../options.ts'
 import { createPageComponentImportPath } from '../../utils/modules.ts'
 import { createAppConfig } from '../../utils/project-config.ts'

package/src/node/plugins/wx/dev/plugins.ts

@@ -3,7 +3,7 @@ import type { VptOptions } from '../../../../options.ts'
 import { esTarget } from '../../../utils/constant.ts'
 import { memoize } from '../../../utils/memoize.ts'
 import { normalizeModuleId } from '../../../utils/modules.ts'
-import { appCapsulePath, pageCapsulePath, rolldownRuntimeId, taroRuntimePath } from '../module.ts'
+import { appCapsulePath, pageCapsulePath, rolldownRuntimeId, taroRuntimePath } from '../module/module.ts'
 import { createWxDevHost, type WxDevHost } from './dev-host.ts'
 import { developmentAppWxssFileName } from './hmr-files.ts'
 import { createWxReactRefreshTransforms } from './react-refresh.ts'

package/src/node/plugins/wx/dev/wx-dev-options.ts

@@ -6,7 +6,7 @@ import type { ViteDevServer } from 'vite'
 import type { VptOptions } from '../../../../options.ts'
 import { once } from '../../../utils/once.ts'
 import { resolvePackageFile } from '../../../utils/packages.ts'
-import { appShellFileName } from '../module.ts'
+import { appShellFileName } from '../module/module.ts'
 
 type BundledDevRolldownOptions = InputOptions & {
     experimental?: {
@@ -68,12 +68,26 @@ export function installWxDevOptions({
          * mutating configuredOutput itself would leak development normalization back into the user's resolved Vite config.
          */
         Object.assign(output, configured, {
+            // Development output is overwritten in place after every complete build. Strip hash placeholders from the
+            // configured asset pattern so old files cannot accumulate and native JSON/WXML references remain stable.
             assetFileNames: createStableFileNames(configured.assetFileNames, 'assets/[name][extname]'),
+            // Banners create physical CommonJS edges after graph analysis: App initializes the dev runtime and each Page
+            // consumes the stable patch journal without allowing those host-only files into the application chunk graph.
             banner: createEntryBanner(pageFiles),
+            // Preserve the configured directory/name shape while removing content hashes. Stable chunk paths let DevTools
+            // overwrite executable files and let cumulative HMR patches address one persistent physical module identity.
             chunkFileNames: createStableFileNames(configured.chunkFileNames, 'assets/[name].js'),
+            // Native entry paths are public Mini Program routes (`app.js`, `pages/.../index.js`); development must never hash
+            // or relocate them because DevTools determines App/Page reload behavior from those exact filenames.
             entryFileNames: createStableFileNames(configured.entryFileNames, '[name]'),
+            // Keep ESM until the existing WX renderChunk pipeline classifies each final chunk and converts capsules to
+            // System.register data or native/amphibious entries to CommonJS. Choosing CommonJS here would erase that boundary.
             format: 'es',
+            // Bundled development emits complete physical output repeatedly. Minifying bounds disk transfer and DevTools
+            // compile work; source-level HMR diagnostics still come from Vite/Rolldown before this final output pass.
             minify: true,
+            // DevTools executes physical WX files and HMR applies module factories rather than browser source maps. Disabling
+            // maps avoids extra output files and prevents Vite's Oxc sourcemap transform from touching generated host code.
             sourcemap: false
         })
 
@@ -84,9 +98,16 @@ export function installWxDevOptions({
         rolldownOptions.experimental ??= {}
         const existingDevMode = rolldownOptions.experimental.devMode
         rolldownOptions.experimental.devMode = {
+            // Retain unknown user/forward-compatible devMode fields while the three explicit WX invariants below win.
             ...(typeof existingDevMode === 'object' ? existingDevMode : {}),
+            // Install the WX-adapted self-contained Rolldown runtime. It consumes physical patch journals and reports
+            // acknowledgements/rebuild requests through the host bridge instead of relying on browser globals or sockets.
             implement: await bundleRuntimeSource(),
+            // Produce a complete output graph on the initial build. Lazy per-request compilation cannot establish the closed
+            // App/Page graph, native companions, style sidecars, and build identity required before any patch is admitted.
             lazy: false,
+            // Keep Rolldown's common runtime injection because generated application factories call its module registry and
+            // HMR primitives. Skipping it would leave the custom implementation without the runtime surface it extends.
             skipCommonRuntimeInjection: false
         }
 

package/src/node/plugins/wx/module/chunk-path.ts

@@ -0,0 +1,22 @@
+import path from 'node:path'
+
+/** Physical directory in which Rolldown writes generated JavaScript chunks inside each native package. */
+export const generatedChunkDirectory = 'assets'
+
+/** Projects one Rolldown-owned physical candidate path into the package-neutral SystemJS identity. */
+export function toLogicalChunkId(physicalChunkId: string): string {
+    return path.posix.relative(generatedChunkDirectory, physicalChunkId)
+}
+
+/** Resolves one relative Rolldown-generated import to its preliminary physical chunk path. */
+export function resolvePhysicalChunkReference(importerChunkId: string, reference: string): string {
+    if (!reference.startsWith('./') && !reference.startsWith('../')) {
+        throw new Error(`Expected a relative chunk reference in ${importerChunkId}: ${reference}`)
+    }
+    return path.posix.join(path.posix.dirname(importerChunkId), reference)
+}
+
+/** Projects one relative Rolldown-generated import into its package-neutral SystemJS identity. */
+export function resolveLogicalChunkReference(importerChunkId: string, reference: string): string {
+    return toLogicalChunkId(resolvePhysicalChunkReference(importerChunkId, reference))
+}

package/src/node/plugins/wx/{module.ts → module/module.ts}

@@ -1,7 +1,7 @@
 import path from 'node:path'
 import { normalizePath, type Rolldown } from 'vite'
-import { normalizeModuleId } from '../../utils/modules.ts'
-import { packageRequire, resolvePackageFile } from '../../utils/packages.ts'
+import { normalizeModuleId } from '../../../utils/modules.ts'
+import { packageRequire, resolvePackageFile } from '../../../utils/packages.ts'
 
 /** Identifies Rolldown's generated helper module independently of its unstable output filename. */
 export const rolldownRuntimeId = '\0rolldown/runtime.js'

package/src/node/plugins/wx/native/create-native-component-output.ts

@@ -1,16 +1,18 @@
 import { readFile } from 'node:fs/promises'
 import path from 'node:path'
 import type { Rolldown } from 'vite'
-import { isGeneratedSubpackageFile } from '../placement/plan.ts'
+import type { PackageLocation } from '../placer/placement.ts'
 import { getNativeComponentSources } from './native-component-assets.ts'
 
 /** Creates opaque native files and their registrations from each surviving JSX interface module. */
 export async function createNativeComponentOutput({
     bundle,
-    getModuleInfo
+    getModuleInfo,
+    getPackageLocation
 }: {
     bundle: Rolldown.OutputBundle
     getModuleInfo: (moduleId: string) => { meta: Rolldown.CustomPluginOptions } | null
+    getPackageLocation(chunk: Rolldown.OutputChunk): PackageLocation
 }) {
     // Files and registrations accumulate in final chunk order for deterministic output.
     const files: Rolldown.EmittedAsset[] = []
@@ -25,9 +27,8 @@ export async function createNativeComponentOutput({
         if (output.type !== 'chunk') {
             continue
         }
-        const packageRoot = isGeneratedSubpackageFile(output.fileName)
-            ? path.posix.dirname(path.posix.dirname(output.fileName))
-            : undefined
+        const location = getPackageLocation(output)
+        const packageRoot = location.kind === 'subpackage' ? location.root : undefined
 
         for (const moduleId of output.moduleIds) {
             const sources = getNativeComponentSources(getModuleInfo(moduleId)?.meta)

package/src/node/plugins/wx/output/files.ts

@@ -1,7 +1,7 @@
 import type { Rolldown } from 'vite'
 import type { VptOptions } from '../../../../options.ts'
 import { createNativeComponentOutput } from '../native/create-native-component-output.ts'
-import type { GeneratedSubpackage } from '../placement/placer.ts'
+import type { GeneratedSubpackage, PackageLocation } from '../placer/placement.ts'
 import { createJsonAssets } from './json.ts'
 import { createTemplateAssets } from './templates.ts'
 
@@ -10,14 +10,16 @@ export async function createOutputFiles({
     bundle,
     options,
     subpackages,
-    getModuleInfo
+    getModuleInfo,
+    getPackageLocation
 }: {
     bundle: Rolldown.OutputBundle
     options: VptOptions
     subpackages: readonly GeneratedSubpackage[]
     getModuleInfo: (moduleId: string) => { meta: Rolldown.CustomPluginOptions } | null
+    getPackageLocation(chunk: Rolldown.OutputChunk): PackageLocation
 }): Promise<Rolldown.EmittedFile[]> {
-    const nativeOutput = await createNativeComponentOutput({ bundle, getModuleInfo })
+    const nativeOutput = await createNativeComponentOutput({ bundle, getModuleInfo, getPackageLocation })
 
     return [
         {

package/src/node/plugins/wx/output/json.ts

@@ -1,8 +1,7 @@
 import type { Rolldown } from 'vite'
 import type { VptJsonObject, VptOptions, VptPageOption } from '../../../../options.ts'
 import { createAppConfig } from '../../../utils/project-config.ts'
-import type { GeneratedSubpackage } from '../placement/placer.ts'
-import { isGeneratedSubpackageFile } from '../placement/plan.ts'
+import { type GeneratedSubpackage, isGeneratedSubpackageFile } from '../placer/placement.ts'
 import { toRootRelativePath } from './relative-root.ts'
 
 /** Creates every configured native JSON asset. */