vite-plugin-taro 0.5.7 → 0.5.9

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

@@ -1,2 +1,4 @@
+/** 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,5 +1,12 @@
 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 });

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

@@ -5,7 +5,7 @@ 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 { 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,13 +42,14 @@ export function installWxDevOptions({ bundledDev, server, options }) {
         });
         rolldownOptions.experimental ??= {};
         rolldownOptions.experimental.devMode = createWxDevMode(rolldownOptions.experimental.devMode, await bundleRuntimeSource());
-        const emptyOutputDirectoryPlugin = {
-            name: 'vpt:wx-empty-output-directory',
+        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. Preserve the watched directory itself while
-                // removing stale contents before each complete physical render.
-                handler: () => emptyOutputDirectory(server.config.build.outDir)
+                // 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 = {
@@ -56,7 +57,7 @@ export function installWxDevOptions({ bundledDev, server, options }) {
             buildEnd: settleInitialBuild
         };
         rolldownOptions.plugins = [
-            emptyOutputDirectoryPlugin,
+            initializeOutputDirectoryPlugin,
             rolldownOptions.plugins,
             reportInitialBuildPlugin,
             createViteReporter(server)

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

@@ -104,8 +104,8 @@ function createWxPlugin(options) {
         generateBundle: {
             /*
              * This hook is registered after createCssPlugins() and shares hook-level `order: 'post'` with the adapted
-             * upstream hooks and VPT style finalizer. Registration order therefore guarantees that app.wxss is complete
-             * before native Page/component companions are emitted. Without this order, the CSS finalizer could consume
+             * upstream hooks and VPT style finalizer. Registration order therefore guarantees that the imported global
+             * stylesheet is complete before native Page/component companions are emitted. Without this order, the finalizer could consume
              * incomplete Tailwind output or mistake native WXSS companions for additional compiler styles.
              */
             order: 'post',

package/dist/runtime/wx/dev/dev-runtime.js

@@ -278,7 +278,7 @@ class WxDevRuntime extends DevRuntime {
     /**
      * Folds one cumulative physical patch file into a single logical HMR update.
      *
-     * `hmr/patches.js` can contain several unacknowledged Rolldown patches and can be required by several Page shells. The
+     * `hmr/patches.js` can contain several unacknowledged application patches and can be required by several Page shells. The
      * runtime must therefore ignore replayed sequences, reject a missing sequence, and move directly from the currently live
      * module generation to the latest published generation without rendering intermediate generations.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "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.7",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.5.7"
+    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.5.9",
+    "@tarojs/react": "npm:vite-plugin-taro-react@0.5.9"
   },
   "peerDependencies": {
     "react": "^19.0.0",

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

@@ -1,5 +1,13 @@
 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> {

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

@@ -8,7 +8,7 @@ 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 { createInitialOutputDirectoryCleaner } from './empty-output-directory.ts'
 
 export type BundledDevRolldownOptions = InputOptions & {
     experimental?: {
@@ -77,13 +77,14 @@ export function installWxDevOptions({
             await bundleRuntimeSource()
         )
 
-        const emptyOutputDirectoryPlugin: Plugin = {
-            name: 'vpt:wx-empty-output-directory',
+        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. Preserve the watched directory itself while
-                // removing stale contents before each complete physical render.
-                handler: () => emptyOutputDirectory(server.config.build.outDir)
+                // 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
             }
         }
 
@@ -93,7 +94,7 @@ export function installWxDevOptions({
         }
 
         rolldownOptions.plugins = [
-            emptyOutputDirectoryPlugin,
+            initializeOutputDirectoryPlugin,
             rolldownOptions.plugins,
             reportInitialBuildPlugin,
             createViteReporter(server)

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

@@ -128,8 +128,8 @@ function createWxPlugin(options: VitePluginTaroOptions): Plugin {
         generateBundle: {
             /*
              * This hook is registered after createCssPlugins() and shares hook-level `order: 'post'` with the adapted
-             * upstream hooks and VPT style finalizer. Registration order therefore guarantees that app.wxss is complete
-             * before native Page/component companions are emitted. Without this order, the CSS finalizer could consume
+             * upstream hooks and VPT style finalizer. Registration order therefore guarantees that the imported global
+             * stylesheet is complete before native Page/component companions are emitted. Without this order, the finalizer could consume
              * incomplete Tailwind output or mistake native WXSS companions for additional compiler styles.
              */
             order: 'post',

package/src/runtime/wx/dev/dev-runtime.ts

@@ -26,8 +26,8 @@ type HmrSession = {
     /** Fixed control URL discovered from the Vite server that produced this full build. */
     readonly endpoint: string
     /**
-     * Highest contiguous Rolldown sequence whose factories, graph propagation, and accept
-     * callbacks all succeeded. Replayed Page shells read this watermark; it advances only
+     * Highest contiguous application sequence whose factories, graph propagation, and accept callbacks all succeeded.
+     * Host-filtered native asset updates consume no sequence. Replayed Page shells read this watermark; it advances only
      * after an atomic batch succeeds and resets only with a new App heap.
      */
     appliedSeq: number
@@ -39,7 +39,7 @@ type PatchPayload = Readonly<{
     patches: readonly PatchProgram[]
 }>
 
-/** One patch: its Rolldown sequence, changed module ids, and factory program. */
+/** One patch: its physical application sequence, changed module ids, and Rolldown factory program. */
 type PatchProgram = Readonly<{
     seq: number
     /** Stable ids of the changed modules; the sync apply walks the graph from these. */
@@ -415,7 +415,7 @@ class WxDevRuntime extends DevRuntime {
     /**
      * Folds one cumulative physical patch file into a single logical HMR update.
      *
-     * `hmr/patches.js` can contain several unacknowledged Rolldown patches and can be required by several Page shells. The
+     * `hmr/patches.js` can contain several unacknowledged application patches and can be required by several Page shells. The
      * runtime must therefore ignore replayed sequences, reject a missing sequence, and move directly from the currently live
      * module generation to the latest published generation without rendering intermediate generations.
      *