vite-plugin-taro 0.7.0 → 0.7.1-beta.2

package/dist/node/plugins/client/client-taro.d.ts

@@ -1,6 +1,11 @@
-import { type Plugin } from 'vite';
+import type { Plugin } from 'vite';
 import type { VptTarget } from '../../../options.ts';
-/** Public facade used by transformed application API imports. */
+/** Public application facade: H5's static ESM namespace or Mini's shared Taro object. */
 export declare const clientTaroApiId = "virtual:taro/api";
-/** Creates the shared Taro facade backed by the selected target's API implementation. */
+/**
+ * Resolves application imports without transforming either the facade or its consumers. Each physical facade imports its
+ * canonical backend directly, so upstream @tarojs/taro requests cannot recurse into the generic Mini implementation on H5.
+ * H5's optimizer separately resolves dependency-internal Taro requests to the backend, keeping framework initialization out
+ * of the components → APIs → components cycle. The public namespace shares those same API functions and state objects.
+ */
 export declare function createClientTaroPlugin(target: VptTarget): Plugin;

package/dist/node/plugins/h5/plugins.d.ts

@@ -2,20 +2,5 @@ import type { PluginOption } from 'vite';
 import type { VptOptions } from '../../../options.ts';
 /** Creates the plugins that own the H5 target. */
 export declare function createH5TargetPlugins(options: VptOptions): PluginOption[];
-/**
- * Coarse source prefilter for the upstream Taro API transform.
- *
- * The plugin has two independent responsibilities: adapting imports from the compiler facade and normalizing camel-case
- * H5 ARIA attributes. Matching `aria` followed by any uppercase letter is intentionally broader than Taro's current
- * attribute table. A duplicated exact list would silently stop routing files through Babel when upstream adds another
- * attribute, while a broad false positive costs only one unnecessary transform. Ordinary application modules match
- * neither branch and remain entirely outside Babel's parser and generator.
- */
-export declare const h5TaroApiTransformCodeFilter: RegExp;
-/** Babel preset body shared by Rolldown's filtered adapter and direct semantic tests. */
-export declare function h5TaroApiPreset(): {
-    plugins: [string, {
-        packageName: string;
-        definition: any;
-    }][];
-};
+/** Resolves only the Taro request that must remain within optimized component chunks. */
+export declare function resolveH5OptimizerTaro(id: string): string | undefined;

package/dist/node/plugins/mini/dev/react-refresh.d.ts

@@ -1,4 +1,11 @@
 import { type Plugin } from 'vite';
+/**
+ * Creates the serve-only Oxc substitution for React's free DevTools-hook references.
+ *
+ * Bundled Vite folds `define` into its existing native Oxc transform. Oxc rewrites only free references, preserving explicit
+ * members, property keys, string contents, and shadowed bindings without an all-module plugin filter or a second AST parse.
+ */
+export declare function createMiniReactRefreshDefines(isDevelopment: boolean): Record<string, string>;
 /**
  * Creates the serve-only React Refresh adaptation transforms for a Mini Program target.
  *
@@ -9,16 +16,22 @@ import { type Plugin } from 'vite';
  *   and injects its renderer hook at module evaluation, replacing the missing HTML preamble.
  * - React Reconciler is selected by exact physical ID. Its renderer injection receives a static dependency on the refresh
  *   runtime, so hook installation cannot race renderer initialization during cold startup.
- * - React-family modules are selected by the reserved free DevTools-hook identifier. Their expression references are rewritten
- *   as explicit `globalThis` members; an AST visitor edits only those identifier ranges after the filter admits the module.
- * - Refresh boundaries are selected by Vite's generated `$RefreshReg$` guard. The AST transform removes only that web-preamble
- *   assertion because each boundary already owns local wrappers over the imported refresh runtime.
  *
- * These adaptations deliberately remain serve-only plugin transforms rather than target-wide `define` entries. That scope
- * prevents development protocol behavior from leaking into production or unrelated Mini Program modules. Plugin order also
- * matters: Reconciler receives its static refresh dependency before the later DevTools-hook transform lowers its free references.
+ * These adaptations deliberately remain serve-only plugin transforms rather than target-wide production behavior. Reconciler's
+ * static refresh dependency establishes hook installation order. The Mini config lowers React's free DevTools-hook protocol with
+ * a serve-only native Oxc define. A filtered post-transform removes the browser-preamble assertion before both complete chunk
+ * rendering and incremental factory generation. Removing it only during renderChunk leaves HMR patches unadapted.
  */
 export declare function createMiniReactRefreshTransforms(): Plugin[];
+/**
+ * Removes only the generated browser assertion at the shared module-transform boundary.
+ * The native hook filter avoids parsing nonmatching modules. Matching modules cost O(n) time and memory; unchanged modules
+ * reuse the bundler's transform cache. Refresh registration and unrelated window expressions remain untouched.
+ */
+export declare function removeRefreshPreambleGuard({ code, id }: {
+    code: string;
+    id: string;
+}): import("../../../utils/transform.ts").AstTransformResult;
 /** Makes renderer hook injection statically depend on the refresh runtime. */
 export declare function injectReactRefreshRendererDependency(code: string): {
     code: string;
@@ -28,11 +41,3 @@ export declare function transformRefreshRuntime({ code, id }: {
     code: string;
     id: string;
 }): import("../../../utils/transform.ts").AstTransformResult;
-export declare function transformReactDevtoolsHook({ code, id }: {
-    code: string;
-    id: string;
-}): import("../../../utils/transform.ts").AstTransformResult;
-export declare function removeRefreshPreambleGuard({ code, id }: {
-    code: string;
-    id: string;
-}): import("../../../utils/transform.ts").AstTransformResult;

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

@@ -0,0 +1,3 @@
+import { UnRecursiveTemplate } from '@tarojs/shared/dist/template.js';
+/** Creates the Taro 4.2.1 WX template implementation without loading its CLI platform package. */
+export declare function createWxTemplate(): UnRecursiveTemplate;

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

@@ -0,0 +1,3 @@
+import { RecursiveTemplate } from '@tarojs/shared/dist/template.js';
+/** Creates the Taro 4.2.1 Alipay template implementation without loading its CLI platform package. */
+export declare function createZfbTemplate(): RecursiveTemplate;

package/dist/node/plugins/mini/skeleton/recursive-merge.d.ts

@@ -0,0 +1,9 @@
+type MergeRecord = Record<string, unknown>;
+/**
+ * Recursively merges sources into the retained target used by Taro's template generator.
+ *
+ * The target and its existing nested records are intentionally mutated because Taro retains their references. Matching arrays
+ * are concatenated, matching records are merged recursively, and all other source values replace their target values.
+ */
+export declare function recursiveMerge<T extends MergeRecord>(target: T, ...sources: ReadonlyArray<MergeRecord | undefined>): T;
+export {};

package/dist/node/utils/assert-runtime-versions.d.ts

@@ -0,0 +1,3 @@
+/** Verifies that Vite uses the versions pinned by VPT. */
+export declare function assertRuntimeVersions(): void;
+export declare function assertRuntimeVersionValues(actualViteVersion: string, actualRolldownVersion: string): void;

package/dist/runtime/client/taro/api.d.ts

@@ -1,3 +1,4 @@
-import taro from '@tarojs/taro';
-export * from '@tarojs/taro';
+import taro from 'vite-plugin-taro-runtime/taro';
+export * from 'vite-plugin-taro-runtime/taro';
+export * from './framework-apis.ts';
 export default taro;

package/dist/runtime/client/taro/api.js

@@ -1,10 +1,11 @@
-/*
- * This physical module is the shared facade, not the generic Taro implementation. Its own `@tarojs/taro` request is
- * resolved by the client plugin to the selected platform APIs, while application requests resolve back to this facade.
- * React's API loader then extends this same object with framework lifecycle hooks.
+import taro from 'vite-plugin-taro-runtime/taro';
+import * as frameworkApis from './framework-apis.js';
+/**
+ * Mini keeps Taro's shared mutable API object and bulk native initialization. This assignment preserves the upstream API
+ * loader's behavior after both dependencies have evaluated, regardless of when the framework's native hook was registered.
  */
-import taro from '@tarojs/taro';
-// Re-export platform APIs while preserving object identity for the framework loader's lifecycle assignments.
-// @ts-expect-error @tarojs/taro uses export= types while Rolldown exposes its runtime properties as named exports.
-export * from '@tarojs/taro';
+Object.assign(taro, frameworkApis);
+// @ts-expect-error Taro uses export= types; Rolldown exposes the CommonJS runtime properties as named exports.
+export * from 'vite-plugin-taro-runtime/taro';
+export * from './framework-apis.js';
 export default taro;

package/dist/runtime/client/taro/component.d.ts

@@ -1 +1 @@
-export * from '@tarojs/components';
+export * from 'vite-plugin-taro-runtime/components';

package/dist/runtime/client/taro/component.js

@@ -1 +1,2 @@
-export * from '@tarojs/components';
+// The compiler maps this typed component slot to the active H5 or Mini implementation.
+export * from 'vite-plugin-taro-runtime/components';

package/dist/runtime/client/taro/framework-apis.d.ts

@@ -0,0 +1,2 @@
+/** Lifecycle exports used by the H5 namespace and attached to the shared Taro object by the Mini facade. */
+export { useAddToFavorites, useDidHide, useDidShow, useError, useKeyboardHeight, useLaunch, useLoad, useOptionMenuClick, usePageNotFound, usePageScroll, usePullDownRefresh, usePullIntercept, useReachBottom, useReady, useResize, useRouter, useSaveExitState, useScope, useShareAppMessage, useShareTimeline, useTabItemTap, useTitleClick, useUnhandledRejection, useUnload } from 'vite-plugin-taro-runtime/plugin-framework-react/runtime';

package/dist/runtime/client/taro/framework-apis.js

@@ -0,0 +1,2 @@
+/** Lifecycle exports used by the H5 namespace and attached to the shared Taro object by the Mini facade. */
+export { useAddToFavorites, useDidHide, useDidShow, useError, useKeyboardHeight, useLaunch, useLoad, useOptionMenuClick, usePageNotFound, usePageScroll, usePullDownRefresh, usePullIntercept, useReachBottom, useReady, useResize, useRouter, useSaveExitState, useScope, useShareAppMessage, useShareTimeline, useTabItemTap, useTitleClick, useUnhandledRejection, useUnload } from 'vite-plugin-taro-runtime/plugin-framework-react/runtime';

package/dist/runtime/h5/taro-api-exports.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Keep platform APIs and React hooks as static bindings. Importing the upstream default object or assigning hooks onto it
+ * would make the application facade escape into a mutable object and retain otherwise unused APIs.
+ */
+export * from 'vite-plugin-taro-runtime/plugin-platform-h5/runtime/apis';
+export * from '../client/taro/framework-apis.ts';

package/dist/runtime/h5/taro-api-exports.js

@@ -0,0 +1,6 @@
+/**
+ * Keep platform APIs and React hooks as static bindings. Importing the upstream default object or assigning hooks onto it
+ * would make the application facade escape into a mutable object and retain otherwise unused APIs.
+ */
+export * from 'vite-plugin-taro-runtime/plugin-platform-h5/runtime/apis';
+export * from '../client/taro/framework-apis.js';

package/dist/runtime/h5/taro-api.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The default export is an ESM namespace, not an assembled API object. Rolldown resolves static member reads directly to
+ * exports, so Taro.showToast(), Taro['showToast'](), and named imports all tree-shake without an application transform.
+ * The namespace is read-only; shared mutable runtime state remains inside exported objects such as options and eventCenter.
+ */
+export * from './taro-api-exports.ts';
+export * as default from './taro-api-exports.ts';

package/dist/runtime/h5/taro-api.js

@@ -0,0 +1,7 @@
+/**
+ * The default export is an ESM namespace, not an assembled API object. Rolldown resolves static member reads directly to
+ * exports, so Taro.showToast(), Taro['showToast'](), and named imports all tree-shake without an application transform.
+ * The namespace is read-only; shared mutable runtime state remains inside exported objects such as options and eventCenter.
+ */
+export * from './taro-api-exports.js';
+export * as default from './taro-api-exports.js';

package/dist/runtime/h5/taro-runtime.d.ts

@@ -1,6 +1,7 @@
+/** biome-ignore-all assist/source/organizeImports: keep runtime side effect order */
 /** Runtime exports consumed by the generated H5 entry. */
-import '@tarojs/components/global.css';
-import '@tarojs/components/dist/taro-components/taro-components.css';
-export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
-export { createHashHistory, createRouter, handleAppMount } from '@tarojs/router';
-export { window } from '@tarojs/runtime';
+import 'vite-plugin-taro-runtime/components/global.css';
+import 'vite-plugin-taro-runtime/components/dist/taro-components/taro-components.css';
+export { createReactApp } from 'vite-plugin-taro-runtime/plugin-framework-react/runtime';
+export { createHashHistory, createRouter, handleAppMount } from 'vite-plugin-taro-runtime/router';
+export { window } from 'vite-plugin-taro-runtime/runtime/h5';

package/dist/runtime/h5/taro-runtime.js

@@ -1,6 +1,7 @@
+/** biome-ignore-all assist/source/organizeImports: keep runtime side effect order */
 /** Runtime exports consumed by the generated H5 entry. */
-import '@tarojs/components/global.css';
-import '@tarojs/components/dist/taro-components/taro-components.css';
-export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
-export { createHashHistory, createRouter, handleAppMount } from '@tarojs/router';
-export { window } from '@tarojs/runtime';
+import 'vite-plugin-taro-runtime/components/global.css';
+import 'vite-plugin-taro-runtime/components/dist/taro-components/taro-components.css';
+export { createReactApp } from 'vite-plugin-taro-runtime/plugin-framework-react/runtime';
+export { createHashHistory, createRouter, handleAppMount } from 'vite-plugin-taro-runtime/router';
+export { window } from 'vite-plugin-taro-runtime/runtime/h5';

package/dist/runtime/mini/capsule/page.d.ts

@@ -1,3 +1,3 @@
 import './app.ts';
-declare const config: import("@tarojs/runtime").PageInstance;
+declare const config: import("vite-plugin-taro-runtime/runtime/mini").PageInstance;
 export default config;

package/dist/runtime/mini/capsule/taro-runtime.d.ts

@@ -1,6 +1,6 @@
 /** biome-ignore-all assist/source/organizeImports: keep side effect order */
 /** Taro runtime exports shared by the App, Page, and generated recursive component capsules. */
 import '\0vpt:taro-platform-runtime';
-export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
-export { default as ReactDOM } from '@tarojs/react';
-export { createPageConfig, createRecursiveComponentConfig } from '@tarojs/runtime';
+export { createReactApp } from 'vite-plugin-taro-runtime/plugin-framework-react/runtime';
+export { default as ReactDOM } from 'vite-plugin-taro-runtime/react';
+export { createPageConfig, createRecursiveComponentConfig } from 'vite-plugin-taro-runtime/runtime/mini';

package/dist/runtime/mini/capsule/taro-runtime.js

@@ -2,10 +2,10 @@
 /** Taro runtime exports shared by the App, Page, and generated recursive component capsules. */
 // @ts-expect-error: The active Mini contract resolves its Taro platform initialization module.
 import '\0vpt:taro-platform-runtime';
-export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
-export { default as ReactDOM } from '@tarojs/react';
-export { createPageConfig, createRecursiveComponentConfig } from '@tarojs/runtime';
-import { customWrapperCache } from '@tarojs/runtime';
+export { createReactApp } from 'vite-plugin-taro-runtime/plugin-framework-react/runtime';
+export { default as ReactDOM } from 'vite-plugin-taro-runtime/react';
+export { createPageConfig, createRecursiveComponentConfig } from 'vite-plugin-taro-runtime/runtime/mini';
+import { customWrapperCache } from 'vite-plugin-taro-runtime/runtime/mini';
 // DevTools HMR runs in the bootstrap chunk, so publish the application graph's cache once on the language global.
 if (process.env.NODE_ENV === 'development') {
     Reflect.set(globalThis, Symbol.for('customWrapperCache'), customWrapperCache);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.7.0",
+  "version": "0.7.1-beta.2",
   "author": "sep2",
   "description": "Vite 8 plugin for building one React/Taro codebase for WeChat, Alipay, and H5 targets.",
   "type": "module",
@@ -57,21 +57,13 @@
     "@tailwindcss/node": "4.3.3",
     "@tailwindcss/oxide": "4.3.3",
     "@tailwindcss/vite": "4.3.3",
-    "@tarojs/components": "4.2.1",
-    "@tarojs/helper": "4.2.1",
-    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.7.0",
-    "@tarojs/plugin-platform-alipay": "4.2.1",
-    "@tarojs/plugin-platform-h5": "4.2.1",
-    "@tarojs/plugin-platform-weapp": "4.2.1",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.7.0",
-    "@tarojs/router": "4.2.1",
-    "@tarojs/runtime": "npm:vite-plugin-taro-runtime@0.7.0",
-    "@tarojs/taro": "4.2.1",
+    "@tarojs/shared": "4.2.1",
     "@vitejs/plugin-react": "^6.1.1",
     "react-reconciler": "0.33.0",
     "rolldown": "1.2.7",
     "sval": "0.6.12",
-    "tailwindcss": "^4.3.3"
+    "tailwindcss": "^4.3.3",
+    "vite-plugin-taro-runtime": "0.7.1-beta.2"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -86,7 +78,6 @@
     "@babel/plugin-transform-modules-systemjs": "^8.0.1",
     "@babel/types": "^8.0.4",
     "@oxc-project/types": "0.148.0",
-    "@rolldown/plugin-babel": "^0.2.3",
     "@tailwindcss-mangle/engine": "0.2.0",
     "@types/node": "^26.3.0",
     "@types/react": "^19.2.18",

package/dist/node/plugins/client/inject-taro-framework-apis.d.ts

@@ -1,5 +0,0 @@
-/**
- * Applies Taro React's standard source-to-source API loader. It imports the framework lifecycle hooks, assigns them to
- * the facade's `taro` object, and emits matching named exports; keeping the hook inventory owned by Taro avoids drift.
- */
-export declare function injectTaroFrameworkApis(source: string): string;