vite-plugin-taro 0.4.1 → 0.5.0

package/dist/node/plugins/wx/dev/create-wx-dev-mode.d.ts

@@ -0,0 +1,6 @@
+import type { InputOptions } from 'rolldown';
+type DevMode = NonNullable<NonNullable<InputOptions['experimental']>['devMode']>;
+type DevModeOptions = Exclude<DevMode, boolean>;
+/** Installs the custom WX runtime while restoring Rolldown's common runtime base. */
+export declare function createWxDevMode(devMode: DevMode | undefined, implement: string): DevModeOptions;
+export {};

package/dist/node/plugins/wx/dev/create-wx-dev-mode.js

@@ -0,0 +1,9 @@
+/** Installs the custom WX runtime while restoring Rolldown's common runtime base. */
+export function createWxDevMode(devMode, implement) {
+    return {
+        ...(typeof devMode === 'object' ? devMode : {}),
+        implement,
+        lazy: false,
+        skipCommonRuntimeInjection: false
+    };
+}

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

@@ -5,6 +5,8 @@ import { dev, viteReporterPlugin } from 'rolldown/experimental';
 import { once } from '../../../utils/once.js';
 import { resolvePackageFile } from '../../../utils/packages.js';
 import { appShellFileName } from '../module.js';
+import { createWxDevMode } from './create-wx-dev-mode.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';
 /**
@@ -184,18 +186,26 @@ export async function createWxDevHost({ server, options }) {
                 sourcemap: false
             });
             rolldownOptions.experimental ??= {};
-            rolldownOptions.experimental.devMode = {
-                ...(typeof rolldownOptions.experimental.devMode === 'object'
-                    ? rolldownOptions.experimental.devMode
-                    : {}),
-                implement: await bundleRuntimeSource(),
-                lazy: false
+            rolldownOptions.experimental.devMode = createWxDevMode(rolldownOptions.experimental.devMode, await bundleRuntimeSource());
+            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/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/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.1",
+  "version": "0.5.0",
   "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,28 +66,31 @@
     "@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",
     "react-refresh": "^0.18.0",
-    "rolldown": "~1.2.2",
+    "rolldown": "1.2.3",
     "tailwindcss": "^4.3.3",
     "weapp-tailwindcss": "^5.2.11",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.4.1",
-    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.4.1"
+    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.5.0",
+    "@tarojs/react": "npm:vite-plugin-taro-react@0.5.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "vite": "^8.2.0"
+    "vite": "8.2.1"
   },
   "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",
     "@types/react-refresh": "^0.14.7",
     "typescript": "^7.0.2",
-    "vite": "^8.2.0"
+    "vite": "8.2.1"
   },
   "scripts": {
     "build": "node ../../scripts/sync-plugin-readme.ts && node ../../scripts/clean-directory.ts dist && tsc --project tsconfig.build.json",

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/create-wx-dev-mode.ts

@@ -0,0 +1,14 @@
+import type { InputOptions } from 'rolldown'
+
+type DevMode = NonNullable<NonNullable<InputOptions['experimental']>['devMode']>
+type DevModeOptions = Exclude<DevMode, boolean>
+
+/** Installs the custom WX runtime while restoring Rolldown's common runtime base. */
+export function createWxDevMode(devMode: DevMode | undefined, implement: string): DevModeOptions {
+    return {
+        ...(typeof devMode === 'object' ? devMode : {}),
+        implement,
+        lazy: false,
+        skipCommonRuntimeInjection: false
+    }
+}

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

@@ -9,6 +9,8 @@ import type { VitePluginTaroOptions } from '../../../../options.ts'
 import { once } from '../../../utils/once.ts'
 import { resolvePackageFile } from '../../../utils/packages.ts'
 import { appShellFileName } from '../module.ts'
+import { createWxDevMode } from './create-wx-dev-mode.ts'
+import { emptyOutputDirectory } from './empty-output-directory.ts'
 import {
     type HmrInfo,
     hmrControlPath,
@@ -244,20 +246,31 @@ export async function createWxDevHost({
             })
 
             rolldownOptions.experimental ??= {}
-            rolldownOptions.experimental.devMode = {
-                ...(typeof rolldownOptions.experimental.devMode === 'object'
-                    ? rolldownOptions.experimental.devMode
-                    : {}),
-                implement: await bundleRuntimeSource(),
-                lazy: false
+            rolldownOptions.experimental.devMode = createWxDevMode(
+                rolldownOptions.experimental.devMode,
+                await bundleRuntimeSource()
+            )
+
+            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/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/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'