vite-plugin-taro 0.7.8 → 0.7.10-beta.0

package/dist/node/plugins/mini/watch/create-mini-watch-plugin.d.ts

@@ -1,4 +1,7 @@
 import type { Plugin } from 'vite';
-import type { VptTarget } from '../../../../options.ts';
+import type { MiniContract } from '../mini-contract.ts';
 /** Preserves watched directories and forces full reloads for Mini Program watch output without changing serve HMR. */
-export declare function createMiniWatchPlugin(target: VptTarget): Plugin;
+export declare function createMiniWatchPlugin(contract: {
+    output: Pick<MiniContract['output'], 'projectConfigFilename' | 'projectPrivateConfigFilename'>;
+    watch: MiniContract['watch'];
+}): Plugin;

package/dist/node/tests/create-mini-style-entries.d.ts

@@ -0,0 +1,3 @@
+import type { createResolver } from '../plugins/mini/resolve/resolver.ts';
+/** Supplies native entry metadata around test-owned capsule sources without loading production shells. */
+export declare function createMiniStyleEntries(appId: string, pageIds: readonly string[]): ReturnType<typeof createResolver>['entries'];

package/dist/node/tests/create-native-dev-runtime.d.ts

@@ -0,0 +1,7 @@
+import type { HmrInfo } from '../plugins/mini/dev/hmr-protocol.ts';
+/** Executes generated native CommonJS, SystemJS transport and HMR code without a DevTools installation. */
+export declare function createNativeDevRuntime(outDir: string, info: HmrInfo): {
+    run: (code: string) => unknown;
+    reports: unknown[];
+    applyPatches(source: string): void;
+};

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

@@ -1,5 +1,5 @@
 export declare const packageRequire: NodeJS.Require;
-/** Resolves a file shipped by this package as a portable Vite module ID. */
-export declare function resolvePackageFile(...segments: string[]): string;
+/** Resolves a public export of the bundled Taro runtime package. */
+export declare function resolveTaroRuntime(subpath: string): string;
 /** Resolves an unbundled browser runtime module from source in the workspace and from dist after publication. */
-export declare function resolveRuntimeFile(modulePath: string): string;
+export declare function resolveVptRuntime(modulePath: string): string;

package/dist/runtime/mini/dev/hmr-protocol.d.ts

@@ -1,8 +1,8 @@
-/** Host-to-App terminal control over the App heap's authenticated Vite socket. */
+/** Host-to-App terminal control over the authenticated Vite socket owned by the running App. */
 export declare const runtimeControlEvent = "vpt:mini-hmr:control";
 /** App-to-host application frontier and rebuild reports over the same socket. */
 export declare const runtimeReportEvent = "vpt:mini-hmr:report";
-/** Build identity and authenticated socket endpoint fixed for one App heap. */
+/** Build identity and authenticated socket endpoint fixed for the lifetime of one running App. */
 export type HmrInfo = Readonly<{
     buildId: string;
     endpoint: string;

package/dist/runtime/mini/dev/hmr-protocol.js

@@ -1,4 +1,4 @@
-/** Host-to-App terminal control over the App heap's authenticated Vite socket. */
+/** Host-to-App terminal control over the authenticated Vite socket owned by the running App. */
 export const runtimeControlEvent = 'vpt:mini-hmr:control';
 /** App-to-host application frontier and rebuild reports over the same socket. */
 export const runtimeReportEvent = 'vpt:mini-hmr:report';

package/dist/runtime/mini/dev/mini-hmr-runtime.d.ts

@@ -1,7 +1,6 @@
-import type { DevRuntime as RolldownDevRuntime } from 'rolldown/experimental/runtime-types';
+import type { ElementType } from 'react';
+import { DevRuntime } from 'rolldown/experimental/runtime';
 import { type HmrInfo } from './hmr-protocol.ts';
-/** Lexical base class injected into the runtime chunk by Rolldown; typed via the contract. */
-declare const DevRuntime: new (clientId: string) => RolldownDevRuntime;
 /** Mode-independent patch metadata consumed by the shared sequence and graph reducer. */
 export type RuntimePatch = Readonly<{
     seq: number;
@@ -55,11 +54,12 @@ export type ConnectMiniSocket = (endpoint: string) => MiniSocketTask;
 /** Shared Mini Program host mechanics extending the Rolldown contract instead of reimplementing it. */
 export declare class MiniHmrRuntime extends DevRuntime {
     /**
-     * One session for this App heap. Undefined only before the mode-selected entry initializes the runtime; its identity then
+     * One session for the running App. Undefined only before the mode-selected entry initializes the runtime; its identity then
      * stays fixed while appliedSeq records the committed frontier.
      */
     private session;
     private socket;
+    private disconnectWarningHandled;
     /**
      * Sparse current-generation accepting boundaries keyed by module id. Entries alone must
      * outlive Rolldown module-cache eviction so old callbacks can receive fresh exports.
@@ -67,7 +67,7 @@ export declare class MiniHmrRuntime extends DevRuntime {
      * the new one. Passive contexts are never retained, so space is O(number of boundaries).
      */
     private readonly moduleHotContexts;
-    /** Immutable platform socket constructor retained for the App heap's first initialization. */
+    /** Immutable platform socket constructor retained until the running App initializes. */
     private readonly connectSocket;
     constructor(connectSocket: ConnectMiniSocket);
     /**
@@ -76,6 +76,8 @@ export declare class MiniHmrRuntime extends DevRuntime {
      * calling accept registers the new context after the apply plan captured old callbacks.
      */
     createModuleHotContext(moduleId: string): MiniHotContext;
+    /** Resolves a cold Page against patches installed before its physical capsule first executed. */
+    resolvePageComponent(moduleId: string, baseline: ElementType): ElementType;
     /** Computes accepting boundaries and every executed module that must be re-armed. */
     private computeHmrUpdate;
     /** Walks executed importers until an accepting boundary is found. */
@@ -86,7 +88,7 @@ export declare class MiniHmrRuntime extends DevRuntime {
      */
     private applyHmrUpdate;
     /**
-     * Initializes exactly once per App heap. Repeated entry evaluation must not replace the identity or reset `appliedSeq`, because
+     * Initializes exactly once each time DevTools loads the App. Repeated entry evaluation must not replace the identity or reset `appliedSeq`, because
      * either change could acknowledge factories against another host client or replay already committed application generations.
      */
     initialize(info: HmrInfo): void;

package/dist/runtime/mini/dev/mini-hmr-runtime.js

@@ -1,11 +1,12 @@
 /*
  * Shared Mini Program HMR runtime, bundled into the mode-selected entry and injected into Rolldown's generated runtime chunk.
- * Rolldown provides the lexical `DevRuntime` base class; this file extends that registry instead of duplicating module loading.
+ * The exported Rolldown `DevRuntime` is bundled with this adapter instead of relying on an implicitly injected base class.
  *
  * Concrete modes decide how executable registrations arrive—native project JavaScript or interpreted source—and provide only a
  * synchronous installer. This class owns the invariant that installation, graph propagation, cache eviction, boundary execution,
  * and ACK form one application transaction; it has no file-delivery or interpreter policy of its own.
  */
+import { DevRuntime } from 'rolldown/experimental/runtime';
 import { runtimeControlEvent, runtimeReportEvent } from './hmr-protocol.js';
 import { polyfillQueueMicrotask } from './polyfill/polyfill-queue-microtask.js';
 /** Shared no-op CSS contract because physical rebuilds replace styles wholesale. */
@@ -60,12 +61,14 @@ class MiniHotContext {
 /** Shared Mini Program host mechanics extending the Rolldown contract instead of reimplementing it. */
 export class MiniHmrRuntime extends DevRuntime {
     /**
-     * One session for this App heap. Undefined only before the mode-selected entry initializes the runtime; its identity then
+     * One session for the running App. Undefined only before the mode-selected entry initializes the runtime; its identity then
      * stays fixed while appliedSeq records the committed frontier.
      */
     session;
     // Set only by native OPEN and cleared on close/error: this reference is the authority for whether reports can be sent.
     socket;
+    // One socket belongs to this App runtime. Its first failure or deliberate stop silences subsequent error/close warnings.
+    disconnectWarningHandled = false;
     /**
      * Sparse current-generation accepting boundaries keyed by module id. Entries alone must
      * outlive Rolldown module-cache eviction so old callbacks can receive fresh exports.
@@ -73,7 +76,7 @@ export class MiniHmrRuntime extends DevRuntime {
      * the new one. Passive contexts are never retained, so space is O(number of boundaries).
      */
     moduleHotContexts = new Map();
-    /** Immutable platform socket constructor retained for the App heap's first initialization. */
+    /** Immutable platform socket constructor retained until the running App initializes. */
     connectSocket;
     constructor(connectSocket) {
         // The base has no messenger: the engine tracks per-client shipped payloads instead
@@ -94,6 +97,19 @@ export class MiniHmrRuntime extends DevRuntime {
         this.moduleHotContexts.delete(moduleId);
         return new MiniHotContext(moduleId, this.moduleHotContexts);
     }
+    /** Resolves a cold Page against patches installed before its physical capsule first executed. */
+    resolvePageComponent(moduleId, baseline) {
+        if (!this.hasFactory(moduleId)) {
+            return baseline;
+        }
+        // An unopened native Page evaluates its original capsule after the patch has already been ACKed. That capsule
+        // registers baseline exports in Rolldown's cache, shadowing the installed patch factory. Only evict that exact
+        // baseline reference: an already-refreshed Page's current exports must not be re-executed on every render.
+        if (this.isExecuted(moduleId) && this.loadExports(moduleId).default === baseline) {
+            this.removeModuleCache(moduleId);
+        }
+        return this.initModule(moduleId).default;
+    }
     /** Computes accepting boundaries and every executed module that must be re-armed. */
     computeHmrUpdate(changedIds) {
         // Mutable traversal accumulators are confined to one synchronous update plan.
@@ -120,7 +136,9 @@ export class MiniHmrRuntime extends DevRuntime {
             boundaries.push(moduleId);
             return undefined;
         }
-        const importers = this.getImporters(moduleId).filter((importer) => this.isExecuted(importer));
+        // A Page wrapper can import itself in Rolldown's graph. That edge makes no progress toward an accepting boundary;
+        // excluding it preserves real multi-module cycle detection below without rejecting an otherwise valid Page update.
+        const importers = this.getImporters(moduleId).filter((importer) => importer !== moduleId && this.isExecuted(importer));
         if (importers.length === 0) {
             return `no HMR boundary found for module ${moduleId}`;
         }
@@ -163,7 +181,7 @@ export class MiniHmrRuntime extends DevRuntime {
         }
     }
     /**
-     * Initializes exactly once per App heap. Repeated entry evaluation must not replace the identity or reset `appliedSeq`, because
+     * Initializes exactly once each time DevTools loads the App. Repeated entry evaluation must not replace the identity or reset `appliedSeq`, because
      * either change could acknowledge factories against another host client or replay already committed application generations.
      */
     initialize(info) {
@@ -172,11 +190,16 @@ export class MiniHmrRuntime extends DevRuntime {
         }
         this.session = { buildId: info.buildId, appliedSeq: 0 };
         const socket = this.connectSocket(info.endpoint);
-        const clearSocket = () => {
+        const handleDisconnect = () => {
             this.socket = undefined;
+            if (this.disconnectWarningHandled) {
+                return;
+            }
+            this.disconnectWarningHandled = true;
+            console.warn('[vpt] HMR disconnected. Ensure the Vite dev server is running, then reload the Mini Program in DevTools.');
         };
-        socket.onClose(clearSocket);
-        socket.onError(clearSocket);
+        socket.onClose(handleDisconnect);
+        socket.onError(handleDisconnect);
         socket.onOpen(() => {
             this.socket = socket;
             this.sendReport({ kind: 'startup' });
@@ -203,6 +226,8 @@ export class MiniHmrRuntime extends DevRuntime {
             throw new Error('Mini Program HMR socket is not initialized');
         }
         const socket = this.socket;
+        // Mark intentional shutdown before invoking the native API, which may immediately emit close or error.
+        this.disconnectWarningHandled = true;
         this.socket = undefined;
         socket?.close({ code: 1000, reason: reason });
     }
@@ -219,13 +244,13 @@ export class MiniHmrRuntime extends DevRuntime {
             return;
         }
         if (!this.socket) {
-            // Before OPEN the new heap uses only the disk baseline. Startup requests a rebuild if patches were published;
+            // Before OPEN the newly loaded App uses only the disk baseline. Startup requests a rebuild if patches were published;
             // do not replay their factories early or queue them for later. Closed connections likewise cannot acknowledge updates.
             return;
         }
         if (session.appliedSeq === 0 && payload.patches.length > 0 && payload.patches[0].seq > 1) {
             // Compile starts from the original bundle, but the physical file can be an ACK-pruned suffix. Do not install it or
-            // classify an expected new-heap synchronization as patch corruption. OPEN reports startup automatically; if already
+            // classify expected startup synchronization as patch corruption. OPEN reports startup automatically; if already
             // connected, ask the host to rebuild the baseline now.
             this.sendReport({ kind: 'startup' });
             return;

package/dist/runtime/mini/dev/modes/devtools/devtools-runtime.js

@@ -1,6 +1,6 @@
 /*
  * DevTools adapter injected into the App-global Rolldown runtime chunk. Every Page evaluates the inert `hmr/patches.js` payload
- * before its route capsule, while this singleton survives Page JavaScript hot reload in the App heap. That lifetime difference is
+ * before its route capsule, while this singleton survives Page JavaScript hot reload as the App keeps running. That lifetime difference is
  * what allows module and React state to survive repeated native Page registration.
  */
 import { MiniHmrRuntime } from '../../mini-hmr-runtime.js';

package/dist/runtime/mini/dev/modes/interpreter/interpreter-runtime.d.ts

@@ -2,7 +2,7 @@ import type { HmrInfo } from '../../hmr-protocol.ts';
 import { type ConnectMiniSocket, MiniHmrRuntime } from '../../mini-hmr-runtime.ts';
 /** Interprets cumulative patch source received by the shared App-level HMR socket. */
 declare class InterpreterHmrRuntime extends MiniHmrRuntime {
-    /** One installer and Sval scope retain interpreted factory closures for this App heap. */
+    /** One installer and Sval scope retain interpreted factory closures for the lifetime of the running App. */
     private readonly installPatch;
     constructor(connectSocket: ConnectMiniSocket);
     protected onSocketEvent(info: HmrInfo, event: string, data: unknown): void;

package/dist/runtime/mini/dev/modes/interpreter/interpreter-runtime.js

@@ -7,7 +7,7 @@ import { MiniHmrRuntime } from '../../mini-hmr-runtime.js';
 import { interpreterServerEvent } from './interpreter-protocol.js';
 /** Interprets cumulative patch source received by the shared App-level HMR socket. */
 class InterpreterHmrRuntime extends MiniHmrRuntime {
-    /** One installer and Sval scope retain interpreted factory closures for this App heap. */
+    /** One installer and Sval scope retain interpreted factory closures for the lifetime of the running App. */
     installPatch;
     constructor(connectSocket) {
         super(connectSocket);

package/dist/runtime/mini/systemjs/system-core.js

@@ -37,7 +37,7 @@ systemJSPrototype.import = function (id, parentId, meta) {
  *
  * Mini Program placement guarantees that every registration in a synchronous graph uses the main-package transport. Encountering
  * a thenable therefore indicates a fatal placement invariant violation. No rollback is attempted: rows already published
- * to the shared registry remain there and the current runtime heap must not be reused.
+ * to the shared registry remain there and the current runtime instance must not be reused.
  */
 systemJSPrototype.importSync = function (id) {
     var loader = this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.7.8",
+  "version": "0.7.10-beta.0",
   "author": "sep2",
   "description": "Vite 8 plugin for building one React/Taro codebase for WeChat, Alipay, TikTok, and H5 targets.",
   "type": "module",
@@ -67,7 +67,7 @@
     "rolldown": "1.2.9",
     "sval": "0.6.12",
     "tailwindcss": "^4.3.3",
-    "vite-plugin-taro-runtime": "0.7.8"
+    "vite-plugin-taro-runtime": "0.7.10-beta.0"
   },
   "peerDependencies": {
     "react": "^19.3.0",
@@ -80,18 +80,18 @@
     "@babel/plugin-transform-dynamic-import": "^8.0.1",
     "@babel/plugin-transform-modules-commonjs": "^8.0.1",
     "@babel/plugin-transform-modules-systemjs": "^8.0.1",
-    "@oxc-project/types": "0.150.0",
+    "@oxc-project/types": "0.151.0",
     "@tailwindcss-mangle/engine": "0.2.0",
     "@types/node": "^26.6.2",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "@types/react-refresh": "^0.14.7",
     "@weapp-core/escape": "8.0.0",
-    "@weapp-tailwindcss/postcss": "3.3.5",
+    "@weapp-tailwindcss/postcss": "3.3.7",
     "c8": "^12.0.0",
     "oxc-walker": "1.1.1",
     "picocolors": "^1.1.1",
-    "postcss-pxtrans": "1.0.4",
+    "postcss-rule-unit-converter": "0.2.3",
     "rxjs": "^7.8.2",
     "typescript": "^7.0.2",
     "vite": "8.3.0"