vite-plugin-taro 0.4.0 → 0.4.2

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

@@ -5,6 +5,7 @@ import { dev, viteReporterPlugin } from 'rolldown/experimental';
 import { once } from '../../../utils/once.js';
 import { resolvePackageFile } from '../../../utils/packages.js';
 import { appShellFileName } from '../module.js';
+import { emptyOutputDirectory } from './empty-output-directory.js';
 import { hmrControlPath, hmrInfoFileName, hmrPatchesFileName, renderHmrInfo, renderInitialHmrPatches, writeHmrFile } from './hmr-files.js';
 import { PatchPublisher } from './patch-publisher.js';
 /**
@@ -191,11 +192,25 @@ export async function createWxDevHost({ server, options }) {
                 implement: await bundleRuntimeSource(),
                 lazy: false
             };
+            const emptyOutputDirectoryPlugin = {
+                name: 'vpt:wx-empty-output-directory',
+                renderStart: {
+                    order: 'pre',
+                    // DevEngine bypasses Vite's build-only output preparation. Clear stale files before every complete
+                    // physical render while retaining the directory watched by WeChat DevTools.
+                    handler: () => emptyOutputDirectory(server.config.build.outDir)
+                }
+            };
             const reportInitialBuildPlugin = {
                 name: 'vpt:wx-report-initial-build',
                 buildEnd: settleInitialBuild
             };
-            rolldownOptions.plugins = [rolldownOptions.plugins, reportInitialBuildPlugin, createViteReporter(server)];
+            rolldownOptions.plugins = [
+                emptyOutputDirectoryPlugin,
+                rolldownOptions.plugins,
+                reportInitialBuildPlugin,
+                createViteReporter(server)
+            ];
             disableViteOxcSourcemap(rolldownOptions.plugins);
             return rolldownOptions;
         };

package/dist/node/plugins/wx/dev/empty-output-directory.d.ts

@@ -0,0 +1,2 @@
+/** Empties an output directory without replacing the directory itself or deleting Git metadata. */
+export declare function emptyOutputDirectory(directory: string): Promise<void>;

package/dist/node/plugins/wx/dev/empty-output-directory.js

@@ -0,0 +1,10 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/** Empties an output directory without replacing the directory itself or deleting Git metadata. */
+export async function emptyOutputDirectory(directory) {
+    await fs.mkdir(directory, { recursive: true });
+    const entries = await fs.readdir(directory);
+    await Promise.all(entries
+        .filter((entry) => entry !== '.git')
+        .map((entry) => fs.rm(path.join(directory, entry), { force: true, recursive: true })));
+}

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

@@ -36,6 +36,7 @@ export const pageShellPath = resolvePackageFile('dist/runtime/wx/native/page.js'
 const shellModuleIds = new Set([appShellPath, componentShellPath, pageShellPath]);
 const capsuleModuleIds = new Set([appCapsulePath, componentCapsulePath, pageCapsulePath]);
 const amphibiousModuleIds = new Set([bootstrapPath, rolldownRuntimeId]);
+const transportModuleIds = new Set([transportPath]);
 /** Returns the one explicit lifecycle role owned by a chunk. */
 export function getWxEntryRole(chunk) {
     const ownsShell = containsModule(chunk, shellModuleIds);
@@ -47,7 +48,7 @@ export function getWxEntryRole(chunk) {
 }
 /** Tests whether a chunk contains the physical transport implementation. */
 export function isTransportModule(chunk) {
-    return chunk.moduleIds.includes(transportPath);
+    return containsModule(chunk, transportModuleIds);
 }
 /**
  * Classifies one final output chunk by execution domain. Entry role is deliberately independent: explicit capsule entries

package/dist/node/plugins/wx/native/compile-native-component-interface.js

@@ -10,7 +10,7 @@ export async function compileNativeComponentInterface({ code, id, sourcemap, add
     nativeComponents.forEach((source) => {
         addWatchFile(source.folder);
         source.assets.forEach((asset) => {
-            addWatchFile(path.join(source.folder, asset.relativePath));
+            addWatchFile(normalizeModuleId(path.join(source.folder, asset.relativePath)));
         });
     });
     const assetBytes = nativeComponents.reduce((sourceTotal, source) => {

package/dist/node/plugins/wx/render/capsule-wrapper.d.ts

@@ -1,3 +1,3 @@
-import { type PluginObject } from '@babel/core';
+import { type PluginObj } from '@babel/core';
 /** Wraps System.register as an inert CommonJS capsule tuple with canonical final dependency IDs. */
-export declare function wrapCapsulePlugin(fileName: string): PluginObject;
+export declare function wrapCapsulePlugin(fileName: string): PluginObj;

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

@@ -1,3 +1,3 @@
 export declare const packageRequire: NodeJS.Require;
-/** Resolves a file shipped by this package. */
+/** Resolves a file shipped by this package as a portable Vite module ID. */
 export declare function resolvePackageFile(...segments: string[]): string;

package/dist/node/utils/packages.js

@@ -1,8 +1,9 @@
 import { createRequire } from 'node:module';
 import path from 'node:path';
+import { normalizeModuleId } from './modules.js';
 export const packageRequire = createRequire(import.meta.url);
 const packageRoot = path.dirname(packageRequire.resolve('vite-plugin-taro/package.json'));
-/** Resolves a file shipped by this package. */
+/** Resolves a file shipped by this package as a portable Vite module ID. */
 export function resolvePackageFile(...segments) {
-    return path.join(packageRoot, ...segments);
+    return normalizeModuleId(path.join(packageRoot, ...segments));
 }

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

@@ -1,5 +1,5 @@
 import { type PluginItem } from '@babel/core';
-import generate from '@babel/generator';
+import { generate } from '@babel/generator';
 import { type Rolldown } from 'vite';
 export type AstTransformResult = {
     code: string;

package/dist/node/utils/transform.js

@@ -1,5 +1,5 @@
 import { transformSync } from '@babel/core';
-import generate from '@babel/generator';
+import { generate } from '@babel/generator';
 import { transformWithOxc } from 'vite';
 import { esTarget } from './constant.js';
 /** Replaces each placeholder with a Babel AST expression while transforming the module through Oxc. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "author": "sep2",
   "description": "Vite 8 plugin for building one React/Taro codebase for WeChat Mini Program and H5 targets.",
   "type": "module",
@@ -51,14 +51,13 @@
     "node": "^22.18.0 || >=24.11.0"
   },
   "dependencies": {
-    "@babel/core": "^8.0.1",
-    "@babel/generator": "^8.0.0",
-    "@babel/plugin-transform-dynamic-import": "^8.0.1",
-    "@babel/plugin-transform-modules-commonjs": "^8.0.1",
-    "@babel/plugin-transform-modules-systemjs": "^8.0.1",
+    "@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",
     "@rolldown/plugin-babel": "^0.2.3",
     "@tailwindcss-mangle/engine": "0.2.0",
-    "@weapp-tailwindcss/postcss": "3.2.8",
     "@tarojs/components": "^4.2.0",
     "@tarojs/helper": "^4.2.0",
     "@tarojs/plugin-platform-h5": "^4.2.0",
@@ -67,6 +66,7 @@
     "@tarojs/runtime": "^4.2.0",
     "@tarojs/taro": "^4.2.0",
     "@vitejs/plugin-react": "^6.0.5",
+    "@weapp-tailwindcss/postcss": "3.2.8",
     "babel-plugin-transform-taroapi": "^4.2.0",
     "picocolors": "^1.1.1",
     "react-reconciler": "0.33.0",
@@ -74,8 +74,8 @@
     "rolldown": "~1.2.2",
     "tailwindcss": "^4.3.3",
     "weapp-tailwindcss": "^5.2.11",
-    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.4.0",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.4.0"
+    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.4.2",
+    "@tarojs/react": "npm:vite-plugin-taro-react@0.4.2"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -83,6 +83,8 @@
     "vite": "^8.2.0"
   },
   "devDependencies": {
+    "@types/babel__core": "^7.20.5",
+    "@types/babel__generator": "^7.27.0",
     "@types/node": "^26.1.1",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",

package/src/node/babel-plugins.d.ts

@@ -0,0 +1,20 @@
+declare module '@babel/plugin-transform-dynamic-import' {
+    import type { PluginTarget } from '@babel/core'
+
+    const transformDynamicImport: PluginTarget
+    export default transformDynamicImport
+}
+
+declare module '@babel/plugin-transform-modules-commonjs' {
+    import type { PluginTarget } from '@babel/core'
+
+    const transformModulesCommonjs: PluginTarget
+    export default transformModulesCommonjs
+}
+
+declare module '@babel/plugin-transform-modules-systemjs' {
+    import type { PluginTarget } from '@babel/core'
+
+    const transformModulesSystemjs: PluginTarget
+    export default transformModulesSystemjs
+}

package/src/node/plugins/h5/plugins.ts

@@ -1,5 +1,5 @@
 import type { types as BabelTypes } from '@babel/core'
-import { type NodePath, type PluginObject, types } from '@babel/core'
+import { type NodePath, type PluginObj, types } from '@babel/core'
 import babel from '@rolldown/plugin-babel'
 import type { HtmlTagDescriptor, Plugin, PluginOption } from 'vite'
 import type { VitePluginTaroOptions } from '../../../options.ts'
@@ -127,7 +127,7 @@ function createH5SupportPlugins(): PluginOption[] {
 }
 
 /** Keeps Stencil-injected Taro component styles before application stylesheets. */
-function rewriteStencilStyleInsertion(): PluginObject {
+function rewriteStencilStyleInsertion(): PluginObj {
     return {
         name: 'vpt:rewrite-stencil-style-insertion',
         visitor: {

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

@@ -9,6 +9,7 @@ import type { VitePluginTaroOptions } from '../../../../options.ts'
 import { once } from '../../../utils/once.ts'
 import { resolvePackageFile } from '../../../utils/packages.ts'
 import { appShellFileName } from '../module.ts'
+import { emptyOutputDirectory } from './empty-output-directory.ts'
 import {
     type HmrInfo,
     hmrControlPath,
@@ -252,12 +253,26 @@ export async function createWxDevHost({
                 lazy: false
             }
 
+            const emptyOutputDirectoryPlugin: Plugin = {
+                name: 'vpt:wx-empty-output-directory',
+                renderStart: {
+                    order: 'pre',
+                    // DevEngine bypasses Vite's build-only output preparation. Clear stale files before every complete
+                    // physical render while retaining the directory watched by WeChat DevTools.
+                    handler: () => emptyOutputDirectory(server.config.build.outDir)
+                }
+            }
             const reportInitialBuildPlugin: Plugin = {
                 name: 'vpt:wx-report-initial-build',
                 buildEnd: settleInitialBuild
             }
 
-            rolldownOptions.plugins = [rolldownOptions.plugins, reportInitialBuildPlugin, createViteReporter(server)]
+            rolldownOptions.plugins = [
+                emptyOutputDirectoryPlugin,
+                rolldownOptions.plugins,
+                reportInitialBuildPlugin,
+                createViteReporter(server)
+            ]
             disableViteOxcSourcemap(rolldownOptions.plugins)
             return rolldownOptions
         }

package/src/node/plugins/wx/dev/empty-output-directory.ts

@@ -0,0 +1,14 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+
+/** Empties an output directory without replacing the directory itself or deleting Git metadata. */
+export async function emptyOutputDirectory(directory: string): Promise<void> {
+    await fs.mkdir(directory, { recursive: true })
+    const entries = await fs.readdir(directory)
+
+    await Promise.all(
+        entries
+            .filter((entry) => entry !== '.git')
+            .map((entry) => fs.rm(path.join(directory, entry), { force: true, recursive: true }))
+    )
+}

package/src/node/plugins/wx/dev/react-refresh.ts

@@ -1,4 +1,4 @@
-import { type PluginObject, types } from '@babel/core'
+import { type PluginObj, types } from '@babel/core'
 import type { Plugin } from 'vite'
 import { memoize } from '../../../utils/memoize.ts'
 import { transformWithBabel } from '../../../utils/transform.ts'
@@ -81,7 +81,7 @@ export function createWxReactRefreshTransforms(): Plugin[] {
  * explicit member access is precise. The hook itself is created on `global` by the dev
  * runtime chunk (see dev-runtime.ts).
  */
-function rewriteReactDevtoolsHookGlobal(): PluginObject {
+function rewriteReactDevtoolsHookGlobal(): PluginObj {
     return {
         name: 'vpt:wx-react-devtools-hook-global',
         visitor: {
@@ -124,7 +124,7 @@ function rewriteReactDevtoolsHookGlobal(): PluginObject {
  * replay captures it; the patched commit hooks then track every later mount, including the
  * remounts on re-execution.
  */
-function injectRefreshGlobalHook(): PluginObject {
+function injectRefreshGlobalHook(): PluginObj {
     return {
         name: 'vpt:wx-refresh-global-hook-injection',
         visitor: {
@@ -153,7 +153,7 @@ function injectRefreshGlobalHook(): PluginObject {
  * Only the exact known protocol names are rewritten, one by one, so unrelated `window`
  * accesses are never touched and future protocol additions are deliberate.
  */
-function rewriteRefreshRuntimeWindowAccess(): PluginObject {
+function rewriteRefreshRuntimeWindowAccess(): PluginObj {
     /**
      * Refresh protocol globals that must land on the WeChat `global`:
      * - `__registerBeforePerformReactRefresh`: assigned at module scope; in web, the HMR
@@ -186,7 +186,7 @@ function rewriteRefreshRuntimeWindowAccess(): PluginObject {
 }
 
 /** Boundary modules: remove the generated `if (!window.$RefreshReg$) throw Error(...)` guard. */
-function removeRefreshPreambleGuard(): PluginObject {
+function removeRefreshPreambleGuard(): PluginObj {
     return {
         name: 'vpt:wx-refresh-preamble-guard',
         visitor: {

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

@@ -63,6 +63,7 @@ export type WxExecutionKind = 'native' | 'capsule' | 'amphibious'
 const shellModuleIds: ReadonlySet<string> = new Set([appShellPath, componentShellPath, pageShellPath])
 const capsuleModuleIds: ReadonlySet<string> = new Set([appCapsulePath, componentCapsulePath, pageCapsulePath])
 const amphibiousModuleIds: ReadonlySet<string> = new Set([bootstrapPath, rolldownRuntimeId])
+const transportModuleIds: ReadonlySet<string> = new Set([transportPath])
 
 /** Returns the one explicit lifecycle role owned by a chunk. */
 export function getWxEntryRole(chunk: WxChunk): WxEntryRole | undefined {
@@ -76,7 +77,7 @@ export function getWxEntryRole(chunk: WxChunk): WxEntryRole | undefined {
 
 /** Tests whether a chunk contains the physical transport implementation. */
 export function isTransportModule(chunk: WxChunk): boolean {
-    return chunk.moduleIds.includes(transportPath)
+    return containsModule(chunk, transportModuleIds)
 }
 
 /**

package/src/node/plugins/wx/native/compile-native-component-interface.ts

@@ -26,7 +26,7 @@ export async function compileNativeComponentInterface({
         addWatchFile(source.folder)
 
         source.assets.forEach((asset) => {
-            addWatchFile(path.join(source.folder, asset.relativePath))
+            addWatchFile(normalizeModuleId(path.join(source.folder, asset.relativePath)))
         })
     })
 

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

@@ -1,8 +1,8 @@
-import { type PluginObject, types } from '@babel/core'
+import { type PluginObj, types } from '@babel/core'
 import { resolveChunkReference } from '../../../utils/modules.ts'
 
 /** Wraps System.register as an inert CommonJS capsule tuple with canonical final dependency IDs. */
-export function wrapCapsulePlugin(fileName: string): PluginObject {
+export function wrapCapsulePlugin(fileName: string): PluginObj {
     return {
         name: 'vpt:wrap-capsule',
         visitor: {},

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

@@ -1,4 +1,4 @@
-import { type PluginObject, type PluginTarget, types } from '@babel/core'
+import { type PluginObj, type PluginTarget, types } from '@babel/core'
 import transformModulesCommonjs from '@babel/plugin-transform-modules-commonjs'
 import type { Rolldown } from 'vite'
 import { resolveChunkReference } from '../../../utils/modules.ts'
@@ -29,7 +29,7 @@ export function renderNative({
 function connectNativeCapsulesPlugin(
     fileName: string,
     chunks: Readonly<Record<string, Rolldown.RenderedChunk>>
-): PluginObject {
+): PluginObj {
     return {
         name: 'vpt:connect-native-capsules',
         visitor: {

package/src/node/utils/packages.ts

@@ -1,10 +1,11 @@
 import { createRequire } from 'node:module'
 import path from 'node:path'
+import { normalizeModuleId } from './modules.ts'
 
 export const packageRequire = createRequire(import.meta.url)
 const packageRoot = path.dirname(packageRequire.resolve('vite-plugin-taro/package.json'))
 
-/** Resolves a file shipped by this package. */
+/** Resolves a file shipped by this package as a portable Vite module ID. */
 export function resolvePackageFile(...segments: string[]): string {
-    return path.join(packageRoot, ...segments)
+    return normalizeModuleId(path.join(packageRoot, ...segments))
 }

package/src/node/utils/transform.ts

@@ -1,5 +1,5 @@
 import { type PluginItem, transformSync } from '@babel/core'
-import generate from '@babel/generator'
+import { generate } from '@babel/generator'
 import { type Rolldown, transformWithOxc } from 'vite'
 import { esTarget } from './constant.ts'