vite-plugin-taro 0.5.9 → 0.5.11

package/README.en.md

@@ -20,7 +20,7 @@ Continue with the [Quick Start guide](https://vpt.js.org/guides/quick-start/).
 
 ### React Hot Reload in WeChat DevTools
 
-<video src="https://github.com/user-attachments/assets/cd4e6d97-6bc7-40e0-9ba9-206c9fe369f1" controls autoplay muted loop playsinline width="100%"></video>
+<video src="https://github.com/user-attachments/assets/cb93daf5-1827-496a-bb74-8397975accf6" controls autoplay muted loop playsinline width="100%"></video>
 
 - **Vite 8 + React 19** Build one codebase for WeChat Mini Program and Web with the Vite ecosystem.
 - **Hot reload** Preserve App data, the active page, React component state, and input state while editing.

package/README.md

@@ -21,7 +21,7 @@ npm create vite-taro@latest my-app
 
 ### 已支持微信开发者工具的 React 热更新
 
-<video src="https://github.com/user-attachments/assets/cd4e6d97-6bc7-40e0-9ba9-206c9fe369f1" controls autoplay muted loop playsinline width="100%"></video>
+<video src="https://github.com/user-attachments/assets/cb93daf5-1827-496a-bb74-8397975accf6" controls autoplay muted loop playsinline width="100%"></video>
 
 - **Vite 8 + React 19** 基于 Vite 生态，一份代码覆盖微信小程序与 Web。
 - **热更新** 编辑代码时保留 App 数据、当前页面、React 组件状态与输入状态。

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

@@ -23,6 +23,14 @@ export function createWxDevelopmentPlugin(options) {
             config() {
                 return {
                     build: {
+                        // The development output is the live Mini Program project opened by WeChat DevTools, not a disposable
+                        // build artifact. Deleting and recreating its directory tree during a dev-server restart disrupts
+                        // DevTools' hot-reload watcher; recreating the same paths does not reliably attach that watcher again.
+                        // The host then continues writing hmr/patches.js, but DevTools no longer observes it and therefore never
+                        // re-executes the Page shell that consumes and acknowledges the patches. Keep the watched paths present
+                        // across host restarts and let the initial complete build overwrite active outputs. This plugin applies
+                        // only to `serve`; production builds retain Vite's normal output cleanup.
+                        emptyOutDir: false,
                         // Disable maps in resolved environment config as well as final output so Oxc and Babel skip producing
                         // intermediate maps that Rolldown would discard.
                         sourcemap: false

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

@@ -5,7 +5,6 @@ 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 { createInitialOutputDirectoryCleaner } from './empty-output-directory.js';
 /** Installs the physical WX output and runtime conventions over Vite's browser-oriented bundled-development options. */
 export function installWxDevOptions({ bundledDev, server, options }) {
     // The buildEnd hook and its one-shot result belong to the same abstraction. Consumers can await startup without receiving
@@ -42,26 +41,13 @@ export function installWxDevOptions({ bundledDev, server, options }) {
         });
         rolldownOptions.experimental ??= {};
         rolldownOptions.experimental.devMode = createWxDevMode(rolldownOptions.experimental.devMode, await bundleRuntimeSource());
-        const initializeOutputDirectory = createInitialOutputDirectoryCleaner(server.config.build.outDir);
-        const initializeOutputDirectoryPlugin = {
-            name: 'vpt:wx-initialize-output-directory',
-            renderStart: {
-                order: 'pre',
-                // DevEngine bypasses Vite's build-only output preparation. Remove stale startup contents once, before
-                // Rolldown starts treating its in-memory incremental output as authoritative for later complete builds.
-                handler: initializeOutputDirectory
-            }
-        };
         const reportInitialBuildPlugin = {
             name: 'vpt:wx-report-initial-build',
             buildEnd: settleInitialBuild
         };
-        rolldownOptions.plugins = [
-            initializeOutputDirectoryPlugin,
-            rolldownOptions.plugins,
-            reportInitialBuildPlugin,
-            createViteReporter(server)
-        ];
+        // Preserve the physical paths watched by WeChat DevTools across host restarts; the complete build overwrites every
+        // active output without disrupting the hot-reload watcher.
+        rolldownOptions.plugins = [rolldownOptions.plugins, reportInitialBuildPlugin, createViteReporter(server)];
         disableViteOxcSourcemap(rolldownOptions.plugins);
         return rolldownOptions;
     };

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

@@ -1,3 +1,4 @@
+import path from 'node:path';
 import { getWxExecutionKind, isTransportModule } from '../module.js';
 import { createPlacementPlan, getSubpackageName, isGeneratedSubpackageFile, mainPackage } from './plan.js';
 /**
@@ -94,9 +95,9 @@ export function createPlacer() {
                     if (location.kind === 'main') {
                         return 'assets/[name]-[hash].js';
                     }
-                    // The containing subpackage already supplies a stable identity. Do not leak the Rolldown group name
-                    // into every physical chunk filename; content identity alone is sufficient beneath that root.
-                    return `${location.root}/assets/[hash].js`;
+                    // The package group replaces Rolldown's [name], so recover the first bundled source file's name from
+                    // the final chunk module list instead of leaking the generated package hash into the filename.
+                    return `${location.root}/assets/${getFirstModuleName(chunk)}-[hash].js`;
                 },
                 // Keep generic assets independent of native output identities assigned after bundling.
                 assetFileNames: 'assets/[name]-[hash][extname]'
@@ -138,6 +139,19 @@ export function createPlacer() {
         }
     };
 }
+/** Uses the first bundled source filename as the readable identity of a generated subpackage chunk. */
+function getFirstModuleName(chunk) {
+    const firstModuleId = chunk.moduleIds[0];
+    if (!firstModuleId) {
+        throw new Error('wx subpackage chunk has no source modules');
+    }
+    const normalizedId = firstModuleId.replaceAll('\\', '/');
+    const suffixIndex = normalizedId.search(/[?#]/);
+    const cleanId = suffixIndex === -1 ? normalizedId : normalizedId.slice(0, suffixIndex);
+    const fileName = path.posix.basename(cleanId);
+    const extension = path.posix.extname(fileName);
+    return extension ? fileName.slice(0, -extension.length) : fileName;
+}
 /** Compares main by discriminant and generated subpackages by their unique physical root. */
 function hasSameLocation(left, right) {
     return left.kind === 'main' ? right.kind === 'main' : right.kind === 'subpackage' && left.root === right.root;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "author": "sep2",
   "description": "Vite 8 plugin for building one React/Taro codebase for WeChat Mini Program and H5 targets.",
   "type": "module",
@@ -75,8 +75,8 @@
     "rolldown": "1.2.3",
     "tailwindcss": "^4.3.3",
     "weapp-tailwindcss": "^5.2.11",
-    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.5.9",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.5.9"
+    "@tarojs/react": "npm:vite-plugin-taro-react@0.5.11",
+    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.5.11"
   },
   "peerDependencies": {
     "react": "^19.0.0",

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

@@ -29,6 +29,14 @@ export function createWxDevelopmentPlugin(options: VitePluginTaroOptions): Plugi
             config() {
                 return {
                     build: {
+                        // The development output is the live Mini Program project opened by WeChat DevTools, not a disposable
+                        // build artifact. Deleting and recreating its directory tree during a dev-server restart disrupts
+                        // DevTools' hot-reload watcher; recreating the same paths does not reliably attach that watcher again.
+                        // The host then continues writing hmr/patches.js, but DevTools no longer observes it and therefore never
+                        // re-executes the Page shell that consumes and acknowledges the patches. Keep the watched paths present
+                        // across host restarts and let the initial complete build overwrite active outputs. This plugin applies
+                        // only to `serve`; production builds retain Vite's normal output cleanup.
+                        emptyOutDir: false,
                         // Disable maps in resolved environment config as well as final output so Oxc and Babel skip producing
                         // intermediate maps that Rolldown would discard.
                         sourcemap: false

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

@@ -8,7 +8,6 @@ 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 { createInitialOutputDirectoryCleaner } from './empty-output-directory.ts'
 
 export type BundledDevRolldownOptions = InputOptions & {
     experimental?: {
@@ -77,28 +76,14 @@ export function installWxDevOptions({
             await bundleRuntimeSource()
         )
 
-        const initializeOutputDirectory = createInitialOutputDirectoryCleaner(server.config.build.outDir)
-        const initializeOutputDirectoryPlugin: Plugin = {
-            name: 'vpt:wx-initialize-output-directory',
-            renderStart: {
-                order: 'pre',
-                // DevEngine bypasses Vite's build-only output preparation. Remove stale startup contents once, before
-                // Rolldown starts treating its in-memory incremental output as authoritative for later complete builds.
-                handler: initializeOutputDirectory
-            }
-        }
-
         const reportInitialBuildPlugin: Plugin = {
             name: 'vpt:wx-report-initial-build',
             buildEnd: settleInitialBuild
         }
 
-        rolldownOptions.plugins = [
-            initializeOutputDirectoryPlugin,
-            rolldownOptions.plugins,
-            reportInitialBuildPlugin,
-            createViteReporter(server)
-        ]
+        // Preserve the physical paths watched by WeChat DevTools across host restarts; the complete build overwrites every
+        // active output without disrupting the hot-reload watcher.
+        rolldownOptions.plugins = [rolldownOptions.plugins, reportInitialBuildPlugin, createViteReporter(server)]
         disableViteOxcSourcemap(rolldownOptions.plugins)
 
         return rolldownOptions

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

@@ -1,3 +1,4 @@
+import path from 'node:path'
 import type { Rolldown } from 'vite'
 import { getWxExecutionKind, isTransportModule } from '../module.ts'
 import {
@@ -117,9 +118,9 @@ export function createPlacer() {
                     if (location.kind === 'main') {
                         return 'assets/[name]-[hash].js'
                     }
-                    // The containing subpackage already supplies a stable identity. Do not leak the Rolldown group name
-                    // into every physical chunk filename; content identity alone is sufficient beneath that root.
-                    return `${location.root}/assets/[hash].js`
+                    // The package group replaces Rolldown's [name], so recover the first bundled source file's name from
+                    // the final chunk module list instead of leaking the generated package hash into the filename.
+                    return `${location.root}/assets/${getFirstModuleName(chunk)}-[hash].js`
                 },
                 // Keep generic assets independent of native output identities assigned after bundling.
                 assetFileNames: 'assets/[name]-[hash][extname]'
@@ -165,6 +166,21 @@ export function createPlacer() {
     }
 }
 
+/** Uses the first bundled source filename as the readable identity of a generated subpackage chunk. */
+function getFirstModuleName(chunk: Rolldown.PreRenderedChunk): string {
+    const firstModuleId = chunk.moduleIds[0]
+    if (!firstModuleId) {
+        throw new Error('wx subpackage chunk has no source modules')
+    }
+
+    const normalizedId = firstModuleId.replaceAll('\\', '/')
+    const suffixIndex = normalizedId.search(/[?#]/)
+    const cleanId = suffixIndex === -1 ? normalizedId : normalizedId.slice(0, suffixIndex)
+    const fileName = path.posix.basename(cleanId)
+    const extension = path.posix.extname(fileName)
+    return extension ? fileName.slice(0, -extension.length) : fileName
+}
+
 /** Compares main by discriminant and generated subpackages by their unique physical root. */
 function hasSameLocation(left: PackageLocation, right: PackageLocation): boolean {
     return left.kind === 'main' ? right.kind === 'main' : right.kind === 'subpackage' && left.root === right.root

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

@@ -1,4 +0,0 @@
-/** Creates the one startup cleanup allowed before Rolldown begins tracking incremental output in memory. */
-export declare function createInitialOutputDirectoryCleaner(directory: string): () => Promise<void>;
-/** 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

@@ -1,17 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { once } from '../../../utils/once.js';
-/** Creates the one startup cleanup allowed before Rolldown begins tracking incremental output in memory. */
-export function createInitialOutputDirectoryCleaner(directory) {
-    // Later full builds suppress byte-identical emitted assets. Clearing again would delete those files behind Rolldown's
-    // output cache, so the writer would correctly emit no bytes and leave the physical Mini Program incomplete.
-    return once(() => emptyOutputDirectory(directory));
-}
-/** 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/src/node/plugins/wx/dev/empty-output-directory.ts

@@ -1,22 +0,0 @@
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import { once } from '../../../utils/once.ts'
-
-/** Creates the one startup cleanup allowed before Rolldown begins tracking incremental output in memory. */
-export function createInitialOutputDirectoryCleaner(directory: string): () => Promise<void> {
-    // Later full builds suppress byte-identical emitted assets. Clearing again would delete those files behind Rolldown's
-    // output cache, so the writer would correctly emit no bytes and leave the physical Mini Program incomplete.
-    return once(() => emptyOutputDirectory(directory))
-}
-
-/** 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 }))
-    )
-}