vite-plugin-taro 0.6.1 → 0.6.2

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.1",
+  "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/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.6.1",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.6.1"
+    "@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?: {

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/placer/placement.ts

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto'
 import type { Rolldown } from 'vite'
 
 // Leave headroom below WeChat's 2M subpackage limit for rendered wrappers and native assets.
-const subpackagePlanningBudget = 1_900_000
+export const subpackagePlanningBudget = 1_900_000
 const generatedSubpackageRootPrefix = 'sub/p_'
 
 /** Identifies one generated code-only subpackage by its physical output root. */

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

@@ -1,10 +1,19 @@
-import type { Plugin, Rolldown } from 'vite'
-import { getWxExecutionKind, isTransportModule } from '../module.ts'
+import { normalizePath, type Plugin, type Rolldown } from 'vite'
+import { getWxExecutionKind, isTransportModule } from '../module/module.ts'
 import { getNativeComponentAssetBytes } from '../native/native-component-assets.ts'
 import { createPlacement, type GeneratedSubpackage, type PackageLocation, type Placement } from './placement.ts'
 
 export type { GeneratedSubpackage, Placement } from './placement.ts'
 
+const pnpmFrameworkPackagePattern = /\/node_modules\/\.pnpm\/(?:@tarojs\+|react(?:-dom|-reconciler)?@|scheduler@)/
+const workspaceFrameworkPackagePattern = /\/packages\/(?:taro-react|taro-plugin-framework-react)\//
+
+/** Selects the explicit React/Taro roots whose complete dependency closure forms the framework vendor chunk. */
+export function isWxFrameworkVendorModule(moduleId: string): boolean {
+    const normalizedId = normalizePath(moduleId)
+    return pnpmFrameworkPackagePattern.test(normalizedId) || workspaceFrameworkPackagePattern.test(normalizedId)
+}
+
 type PlacementState =
     | { phase: 'idle' }
     | { phase: 'awaiting-chunks' }
@@ -30,6 +39,22 @@ export const placementRolldownOptions = {
      * participation only; LTHP mutates the resulting OutputChunk filenames later without replacing the chunks.
      */
     output: {
+        /**
+         * React and Taro form one stable framework boundary shared by the App and every Page capsule. Keeping their complete
+         * dependency closure together prevents application edits from invalidating framework chunk identity and makes later
+         * development generations eligible to reuse the unchanged vendor. All remaining modules use Rolldown's automatic
+         * chunking; physical WX package placement operates on those final chunks without imposing another split strategy.
+         */
+        codeSplitting: {
+            groups: [
+                {
+                    name: 'vendor',
+                    test: isWxFrameworkVendorModule,
+                    priority: 100,
+                    includeDependenciesRecursively: true
+                }
+            ]
+        },
         /**
          * Native App/Page/Component shells are files addressed directly by WeChat and must retain the exact names configured
          * in `input`, such as `app.js` and `pages/home/index.js`. Transport is excluded even though it is CommonJS:

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

@@ -4,7 +4,7 @@ import { esTarget } from '../../utils/constant.ts'
 import { packageRequire } from '../../utils/packages.ts'
 import { clientTaroNativeId } from '../client/constant.ts'
 import { createWxDevelopmentPlugin } from './dev/plugins.ts'
-import { getWxExecutionKind, isTransportModule } from './module.ts'
+import { getWxExecutionKind, isTransportModule } from './module/module.ts'
 import { compileNativeComponentInterface } from './native/compile-native-component-interface.ts'
 import { createOutputFiles } from './output/files.ts'
 import { createWxPlacementPlugin, type WxPlacementPlugin } from './placer/placer.ts'

package/src/node/plugins/wx/render/capsule.ts

@@ -1,21 +1,57 @@
-import type { PluginTarget } from '@babel/core'
-import transformDynamicImport from '@babel/plugin-transform-dynamic-import'
-import transformModulesSystemjs from '@babel/plugin-transform-modules-systemjs'
 import type { Rolldown } from 'vite'
-import { type AstTransformResult, transformWithBabel } from '../../../utils/transform.ts'
-import { wrapCapsulePlugin } from './capsule-wrapper.ts'
+import type { AstTransformResult } from '../../../utils/transform.ts'
+import { resolveLogicalChunkReference } from '../module/chunk-path.ts'
+import { type SystemJsReferenceKind, transformSystemJs } from './system-js/system-js.ts'
 
-/** Renders one ESM chunk as an inert SystemJS capsule. */
-export function renderCapsule(code: string, chunk: Rolldown.RenderedChunk, sourcemap = true): AstTransformResult {
-    return transformWithBabel(
+/**
+ * Converts one final Rolldown ESM chunk into the inert registration consumed by the WX module runtime.
+ *
+ * Why this boundary exists:
+ *
+ * - Rolldown produces an ESM chunk graph, but a Mini Program loads emitted JavaScript through native `require` and
+ *   `require.async`; it does not provide the browser ESM loader that normally links Vite chunks.
+ * - Native App, Page, and Component shells must start through WeChat's synchronous lifecycle APIs, while their application
+ *   graph still needs ESM linking semantics such as cycles, live exports, dynamic imports, `import.meta`, and top-level await.
+ * - The plugin therefore keeps native lifecycle shells as CommonJS and executes application "capsules" through the bundled
+ *   SystemJS runtime. Native shells enter that graph with `global.System.importSync`, and genuine asynchronous boundaries use
+ *   the same runtime through `System.import`.
+ *
+ * What this renderer emits:
+ *
+ * The result is CommonJS source whose `module.exports` is a SystemJS registration tuple:
+ * `[logicalDependencyIds, declaration]`. Requiring a capsule only returns this inert tuple; it does not execute application
+ * code or call a global `System.register`. The generated transport can consequently load the physical file from either the
+ * main package or a subpackage, then hand its registration to the loader. The loader owns linking, setter invocation,
+ * execution order, cycle handling, and export publication.
+ *
+ * Why references are rewritten:
+ *
+ * Rolldown imports name physical output files whose relative paths include placement directories and content hashes. The
+ * SystemJS registry instead uses package-neutral logical chunk IDs. Canonicalizing both static and literal dynamic references
+ * here lets transport independently map a stable module identity to the physical `require` path selected by WX placement.
+ * Runtime-computed dynamic IDs cannot be canonicalized and are intentionally preserved.
+ *
+ * This function runs on final Rolldown output rather than arbitrary source modules. `transformSystemJs` accepts only the
+ * normalized final-chunk grammar required by this pipeline and fails the build on unsupported forms instead of risking a
+ * partial or semantically incorrect capsule. Source maps remain optional because WX development output deliberately disables
+ * them on this startup-critical path.
+ */
+export function renderCapsule(code: string, chunk: Rolldown.RenderedChunk, sourcemap: boolean): AstTransformResult {
+    return transformSystemJs({
         code,
-        chunk.fileName,
-        [
-            transformDynamicImport,
-            // Erase Babel's internal plugin pass type.
-            transformModulesSystemjs as PluginTarget,
-            wrapCapsulePlugin(chunk.fileName) as PluginTarget
-        ],
-        sourcemap
-    )
+        filename: chunk.fileName,
+        // Native require must return registration data without executing or globally registering the capsule.
+        format: 'commonjs-registration',
+        sourcemap,
+        // Bind every compile-time chunk edge to the same logical identity understood by transport and SystemJS.
+        resolveReference(reference, kind) {
+            return resolveCapsuleReference(chunk.fileName, reference, kind)
+        }
+    })
+}
+
+/** Canonicalizes physical chunk paths while preserving runtime-computed and package-like dynamic IDs. */
+function resolveCapsuleReference(fileName: string, reference: string, kind: SystemJsReferenceKind): string {
+    if (kind === 'dynamic' && !reference.startsWith('./') && !reference.startsWith('../')) return reference
+    return resolveLogicalChunkReference(fileName, reference)
 }