vite-plugin-taro 0.7.7 → 0.7.9

package/dist/node/plugins/mini/dev/hmr-files.d.ts

@@ -2,7 +2,7 @@ import type { HmrInfo } from './hmr-protocol.ts';
 export declare const hmrInfoFileName = "hmr/info.js";
 /**
  * Renders immutable CommonJS metadata because App startup must initialize the runtime synchronously before any entry capsule.
- * Freezing also prevents application code from accidentally changing the build identity or socket endpoint for the App heap.
+ * Freezing also prevents application code from accidentally changing the running App's build identity or socket endpoint.
  */
 export declare function renderHmrInfo(info: HmrInfo): string;
 /**
@@ -10,7 +10,7 @@ export declare function renderHmrInfo(info: HmrInfo): string;
  *
  * Imported global CSS can change while the entry remains byte-identical. DevTools may then reuse an older persistent compile
  * cache after it restarts. Tying this inert comment to the build identity invalidates that cache once per complete build,
- * while incremental style updates continue changing only the imported file and therefore preserve the App heap.
+ * while incremental style updates continue changing only the imported file and therefore keep the App running.
  */
 export declare function renderDevelopmentAppStyle(globalStyleFileName: string, buildId: string): string;
 /**

package/dist/node/plugins/mini/dev/inject-dev-page-component.d.ts

@@ -0,0 +1,11 @@
+import type { AstTransformResult } from '../../../utils/transform.ts';
+/**
+ * In serve, a native Page may load its original physical capsule after HMR has already installed a newer component factory.
+ * Taro captures the component at createPageConfig() time; without this lookup, that Page first mounts with stale source even
+ * though the patch was acknowledged. Replace only the component argument, leaving the production capsule untouched.
+ */
+export declare function injectDevPageComponent({ capsuleCode, componentId, capsuleId }: {
+    capsuleCode: string;
+    componentId: string;
+    capsuleId: string;
+}): AstTransformResult;

package/dist/node/plugins/mini/dev/plugins.d.ts

@@ -12,7 +12,7 @@ export declare function isMiniClientEnvironment(environment: Readonly<{
  * The shared style pipeline already owns the resolver's ordered App/Page cascade policy, so the host does not reconstruct it
  * from unrelated Rolldown shell and bootstrap entries.
  */
-export declare function createMiniDevelopmentPlugin(contract: Pick<MiniContract, 'options' | 'runtime' | 'styles'>, styles: MiniStylePlugin): PluginOption[];
+export declare function createMiniDevelopmentPlugin(contract: MiniContract, styles: MiniStylePlugin): PluginOption[];
 /**
  * Transfers development ownership of the App stylesheet from complete output to the dev host.
  *
@@ -25,11 +25,11 @@ export declare function createMiniDevelopmentPlugin(contract: Pick<MiniContract,
  *    rebuild-mode transaction has completed;
  * 3. let the host replace the wrapper again with the new marker, causing a second App reload.
  *
- * Deleting the in-memory bundle entry avoids both premature writes. Startup cleanup removes all physical files; live recovery
- * builds do not clean, so their prior App stylesheet remains available. The host publishes the stylesheet once afterward.
+ * Deleting the in-memory bundle entry avoids both premature writes. Startup cleanup retains DevTools project configuration
+ * but removes the prior physical App stylesheet; recovery builds do not clean. The host publishes the stylesheet once afterward.
  * Patch modes first reset delivery and publish matching `hmr/info.js`; rebuild mode has no patch state and writes a fresh marker
  * directly. Incremental HMR never enters this complete-output hook and changes only the imported global stylesheet; rewriting
- * the App root would reload the heap while a JavaScript patch is awaiting acknowledgement. The serve-only plugin leaves
+ * the App root would reload the runtime while a JavaScript patch is awaiting acknowledgement. The serve-only plugin leaves
  * production output unchanged.
  */
 export declare function removeDevelopmentAppStyle(bundle: Record<string, unknown>, appStyleFileName: string): void;

package/dist/node/plugins/mini/mini-contract.d.ts

@@ -45,9 +45,11 @@ export type MiniProjectSkeletonInput = Readonly<{
     nativeComponents: readonly MiniNativeComponentRegistration[];
     isProduction: boolean;
 }>;
-/** One target-owned native project-skeleton generator. */
+/** Target-owned native project filenames and project-skeleton generator. */
 export type OutputContract = {
-    generateProjectSkeleton(input: MiniProjectSkeletonInput): Rolldown.EmittedAsset[];
+    projectConfigFilename: string;
+    projectPrivateConfigFilename: string;
+    generateProjectSkeleton(input: MiniProjectSkeletonInput, contract: MiniContract): Rolldown.EmittedAsset[];
 };
 /** Complete input consumed by the shared Mini Program pipeline. */
 export type MiniContract = {

package/dist/node/plugins/mini/output/files.d.ts

@@ -4,7 +4,7 @@ import type { GeneratedSubpackage, PackageLocation } from '../placer/placement.t
 /** Creates every compiler-owned Mini Program file derived from the final Rolldown bundle. */
 export declare function createOutputFiles({ bundle, contract, subpackages, isProduction, getModuleInfo, getPackageLocation }: {
     bundle: Rolldown.OutputBundle;
-    contract: Pick<MiniContract, 'output' | 'styles'>;
+    contract: MiniContract;
     subpackages: readonly GeneratedSubpackage[];
     isProduction: boolean;
     getModuleInfo: (moduleId: string) => {

package/dist/node/plugins/tt/create-tt-skeleton.d.ts

@@ -1,14 +1,8 @@
 import type { Rolldown } from 'vite';
-import type { VptOptions } from '../../../options.ts';
-import type { MiniProjectSkeletonInput } from '../mini/mini-contract.ts';
-type TtSkeletonInput = MiniProjectSkeletonInput & Readonly<{
-    options: VptOptions;
-    componentsModulePath: string;
-}>;
+import type { MiniContract, MiniProjectSkeletonInput } from '../mini/mini-contract.ts';
 /**
  * TT supports recursive named templates. Like Alipay, its App host carries the independent Page root as p through each
  * template scope and CustomWrapper boundary. The TT runtime declares p as a native property on both generated components.
  * This preserves the App → Page React tree without copying Page nodes into the shared App projection or adding layout nodes.
  */
-export declare function createTtSkeleton({ bundle, subpackages, nativeComponents, isProduction, options, componentsModulePath }: TtSkeletonInput): Rolldown.EmittedAsset[];
-export {};
+export declare function createTtSkeleton({ bundle, subpackages, nativeComponents, isProduction }: MiniProjectSkeletonInput, contract: MiniContract): Rolldown.EmittedAsset[];

package/dist/node/plugins/wx/create-wx-skeleton.d.ts

@@ -1,10 +1,5 @@
 import type { Rolldown } from 'vite';
-import type { VptOptions } from '../../../options.ts';
-import type { MiniProjectSkeletonInput } from '../mini/mini-contract.ts';
-type WxSkeletonInput = MiniProjectSkeletonInput & Readonly<{
-    options: VptOptions;
-    componentsModulePath: string;
-}>;
+import type { MiniContract, MiniProjectSkeletonInput } from '../mini/mini-contract.ts';
 /**
  * Generates the WX templates that project one React ownership tree through two native Page data roots.
  *
@@ -53,5 +48,4 @@ type WxSkeletonInput = MiniProjectSkeletonInput & Readonly<{
  * Page root mutates the in-memory outlet but does not serialize that root into App data. A newly pushed native Page receives the
  * current complete App snapshot with its initial Page batch; retained and hidden Pages need no navigation synchronization.
  */
-export declare function createWxSkeleton({ bundle, subpackages, nativeComponents, isProduction, options, componentsModulePath }: WxSkeletonInput): Rolldown.EmittedAsset[];
-export {};
+export declare function createWxSkeleton({ bundle, subpackages, nativeComponents, isProduction }: MiniProjectSkeletonInput, contract: MiniContract): Rolldown.EmittedAsset[];

package/dist/node/plugins/zfb/create-zfb-skeleton.d.ts

@@ -1,10 +1,5 @@
 import type { Rolldown } from 'vite';
-import type { VptOptions } from '../../../options.ts';
-import type { MiniProjectSkeletonInput } from '../mini/mini-contract.ts';
-type ZfbSkeletonInput = MiniProjectSkeletonInput & Readonly<{
-    options: VptOptions;
-    componentsModulePath: string;
-}>;
+import type { MiniContract, MiniProjectSkeletonInput } from '../mini/mini-contract.ts';
 /**
  * Generates the Alipay templates that project one React ownership tree through two independent native Page data roots.
  *
@@ -53,7 +48,6 @@ type ZfbSkeletonInput = MiniProjectSkeletonInput & Readonly<{
  * declaration, but accepts an empty array and still packages the files beneath that root. Keeping `pages: []` preserves the real
  * model: no synthetic Page, native lifecycle, route, or template exists merely to make code eligible for asynchronous loading.
  */
-export declare function createZfbSkeleton({ bundle, subpackages, nativeComponents, isProduction, options, componentsModulePath }: ZfbSkeletonInput): Rolldown.EmittedAsset[];
+export declare function createZfbSkeleton({ bundle, subpackages, nativeComponents, isProduction }: MiniProjectSkeletonInput, contract: MiniContract): Rolldown.EmittedAsset[];
 /** Adds Alipay's transparent App collection and threads the independent Page root through every recursive data scope. */
 export declare function buildZfbBaseTemplate(source: string): string;
-export {};

package/dist/node/utils/clean-output-files.d.ts

@@ -1,5 +1,5 @@
 /**
  * WeChat DevTools can retain stale file contents when output directories are deleted and recreated.
- * Preserve every directory so its watcher stays attached, but unlink every file to invalidate cached contents.
+ * Preserve every directory so its watcher stays attached, retain caller-owned project files, and unlink the rest.
  */
-export declare function cleanOutputFiles(directory: string): void;
+export declare function cleanOutputFiles(directory: string, preservedRelativePaths: readonly string[]): void;

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,3 +1,4 @@
+import type { ElementType } from 'react';
 import type { DevRuntime as RolldownDevRuntime } from 'rolldown/experimental/runtime-types';
 import { type HmrInfo } from './hmr-protocol.ts';
 /** Lexical base class injected into the runtime chunk by Rolldown; typed via the contract. */
@@ -55,7 +56,7 @@ 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;
@@ -67,7 +68,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 +77,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 +89,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

@@ -60,7 +60,7 @@ 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;
@@ -73,7 +73,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 +94,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.
@@ -163,7 +176,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) {
@@ -219,13 +232,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.7",
+  "version": "0.7.9",
   "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.7"
+    "vite-plugin-taro-runtime": "0.7.9"
   },
   "peerDependencies": {
     "react": "^19.3.0",
@@ -91,6 +91,7 @@
     "c8": "^12.0.0",
     "oxc-walker": "1.1.1",
     "picocolors": "^1.1.1",
+    "postcss-rule-unit-converter": "0.2.3",
     "rxjs": "^7.8.2",
     "typescript": "^7.0.2",
     "vite": "8.3.0"