vite-plugin-taro 0.3.1 → 0.4.0

package/README.en.md

@@ -0,0 +1,44 @@
+# vite-plugin-taro
+
+[![npm version](https://img.shields.io/npm/v/vite-plugin-taro.svg)](https://www.npmjs.com/package/vite-plugin-taro)
+![Vite compatibility](https://registry.vite.dev/api/badges?package=vite-plugin-taro&tool=vite)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+[简体中文](README.md) | English
+
+Build WeChat Mini Program and Web apps with Vite 8, React 19, Taro 4, and Tailwind CSS v4.
+
+Documentation website: <https://vite-plugin-taro.netlify.app>
+
+### 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>
+
+- **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.
+- **Automatic subpackages** Use standard static and dynamic imports while vpt plans WeChat packages automatically.
+- **Tailwind CSS v4 ready** Write utility classes directly; WeChat and Web styles adapt automatically.
+- **Built on Taro, beyond Taro** Use Taro components and APIs without the old webpack pipeline.
+- **Skyline ready** Use WeChat Skyline rendering globally or per page.
+
+## Create an app
+
+```sh
+npm create vite-taro@latest my-app
+```
+
+Continue with the [Quick Start guide](https://vite-plugin-taro.netlify.app/guides/quick-start/).
+
+## Documentation
+
+- [Automatic subpackages](https://vite-plugin-taro.netlify.app/guides/automatic-subpackages/)
+- [Native WeChat components](https://vite-plugin-taro.netlify.app/guides/native-components/)
+- [Hot module replacement](https://vite-plugin-taro.netlify.app/guides/hot-module-replacement/)
+- [Skyline mode](https://vite-plugin-taro.netlify.app/guides/skyline-mode/)
+- [Migrate from Taro CLI](https://vite-plugin-taro.netlify.app/guides/migrate-from-taro/)
+- [Configuration reference](https://vite-plugin-taro.netlify.app/references/configuration/)
+- [Repository management](https://vite-plugin-taro.netlify.app/references/repository-management/)
+
+## License
+
+MIT

package/README.md

@@ -4,516 +4,41 @@
 ![Vite compatibility](https://registry.vite.dev/api/badges?package=vite-plugin-taro&tool=vite)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-[简体中文](README.zh.md) | English
+简体中文 | [English](README.en.md)
 
-Build WeChat Mini Program and Web apps with the latest standards-based frontend stack: Vite 8, React 19, Taro 4, and Tailwind CSS v4.
+使用 Vite 8、React 19、Taro 4 和 Tailwind CSS v4 构建微信小程序与 Web 应用。
 
-`vite-plugin-taro` is for teams building Taro React apps with Vite: keep Taro's cross-platform components and APIs, leave Taro webpack behind, and fix/avoid common official Taro Vite pitfalls. One plugin builds WeChat Mini Program and Web.
+文档网站：<https://vite-plugin-taro.netlify.app>
 
-Live demo: <https://sep2.github.io/vite-plugin-taro>. See [Sample app](https://github.com/sep2/vite-plugin-taro/tree/main/packages/loan-genius/README.md) for how to run it locally.
+### 已支持微信开发者工具的 React 热更新
 
-- **Vite 8 + React 19** Build one codebase for WeChat Mini Program and Web with the Vite ecosystem.
-- **Hot reload** Re-engineered on Vite with seamless WeChat Mini Program support, so page edits no longer lose state.
-- **Tailwind CSS v4 ready** Write utility classes directly; WeChat and Web styles adapt automatically.
-- **Built on Taro, beyond Taro** Use Taro components and APIs while leaving the old webpack pipeline behind.
-- **Skyline ready** Support WeChat Skyline rendering mode perfectly.
-- **Conditional compilation** Split code and styles with Taro-style `#ifdef` / `#ifndef` blocks.
-- **Workspace friendly** Supports standalone apps and monorepos, compatible with `npm`, `pnpm`, `Yarn`, and `Bun`.
-- **TypeScript friendly** Type support from config to app code.
+<video src="https://github.com/user-attachments/assets/cd4e6d97-6bc7-40e0-9ba9-206c9fe369f1" controls autoplay muted loop playsinline width="100%"></video>
 
-## Quick start
+- **Vite 8 + React 19** 基于 Vite 生态，一份代码覆盖微信小程序与 Web。
+- **热更新** 编辑代码时保留 App 数据、当前页面、React 组件状态与输入状态。
+- **全自动分包** 使用标准静态与动态导入，由 vpt 自动规划微信小程序分包。
+- **Tailwind CSS v4 开箱即用** 直接书写工具类，微信与 Web 样式自动适配。
+- **基于 Taro，超越 Taro** 使用 Taro 组件和 API，摆脱旧式 webpack 链路。
+- **Skyline 就绪** 支持全局或按页面启用微信 Skyline 渲染模式。
 
-Use `create-vite-taro` for new apps. It scaffolds a Vite 8 + React 19 + Tailwind CSS v4 + Taro 4 project.
-
-### 1. Create and install
+## 创建应用
 
 ```sh
-# Create a new app from the default template
 npm create vite-taro@latest my-app
-
-# Or create with pnpm
-pnpm --config.minimum-release-age=0 create vite-taro@latest my-app
-
-# Enter the project and install dependencies
-cd my-app
-npm install
-```
-
-### 2. Configure WeChat Mini Program App ID
-
-The template creates `.env.local`. Set `VITE_PLUGIN_TARO_WECHAT_APP_ID` to your WeChat Mini Program App ID.
-
-### 3. Run in development
-
-```sh
-# WeChat Mini Program: start Vite with hot reload
-npm run dev:wx
-
-# Then open dist/wx in WeChat DevTools
-
-# H5: start the Vite dev server
-npm run dev:h5
-
-# Then open the standard Vite dev URL in your browser
-# http://localhost:5173
-```
-
-You can keep `npm run dev:wx` and `npm run dev:h5` running at the same time in separate terminals.
-
-WX development provides full Vite-powered hot reload through Rolldown's incremental module graph and React Refresh. JavaScript edits preserve the active native page and React/input state; CSS, assets, public files, and configuration changes are rebuilt automatically.
-
-### 4. Build, preview, and typecheck
-
-```sh
-# Production WeChat Mini Program output
-npm run build:wx
-
-# Production H5 output
-npm run build:h5
-
-# Preview the built H5 app
-npm run preview:h5
-
-# Typecheck with tsc
-npm run typecheck
-```
-
-### 5. Use Taro virtual modules
-
-Use these imports in app code:
-
-```tsx
-import Taro from 'virtual:taro/api'
-import { Text, View } from 'virtual:taro/components'
-```
-
-| Import | Use |
-| --- | --- |
-| `virtual:taro/components` | Taro React components such as `View`, `Text`, `Button`, `Image`, and `ScrollView`. |
-| `virtual:taro/api` | Taro APIs and hooks such as `Taro.navigateTo`, `Taro.getWindowInfo`, and `Taro.useLaunch`. |
-
-Usage is the same as Taro itself; see the [Taro website](https://docs.taro.zone) for component and API details.
-
-You no longer need to install `@tarojs/*` packages; application code should not import from `@tarojs/*`.
-
-## Manual setup for existing apps
-
-For existing apps or custom project layouts, follow the steps below to wire the plugin manually. First, install the plugin:
-
-```sh
-npm install -D vite-plugin-taro
-```
-
-Your app must also provide Vite 8, React 19, React DOM 19, TypeScript 7, and Node/React type packages. If your app does not already have them, install the missing packages:
-
-```sh
-npm install react react-dom
-npm install -D vite typescript@rc @types/node @types/react @types/react-dom cross-env
-```
-
-Remove all `@tarojs/*` packages from `dependencies` and `devDependencies`.
-
-The steps below create this source shape:
-
-```text
-my-app/
-├── index.html
-├── package.json
-├── tsconfig.json
-├── vite.config.ts
-└── src/
-    ├── app.css
-    ├── app.ts
-    └── pages/
-        └── index/
-            └── index.tsx
-```
-
-You can also see a sample layout at [packages/loan-genius](https://github.com/sep2/vite-plugin-taro/tree/main/packages/loan-genius).
-
-### 1. Add TypeScript declarations
-
-Add the plugin client types to `tsconfig.json` so TypeScript knows about the virtual modules:
-
-```json
-{
-    "compilerOptions": {
-        "jsx": "react-jsx",
-        "moduleResolution": "bundler",
-        "types": ["vite/client", "vite-plugin-taro/client"]
-    },
-    "include": ["src"]
-}
-```
-
-### 2. Configure Vite
-
-Create `vite.config.ts` and choose the plugin target from an environment variable:
-
-```ts
-import { defineConfig, loadEnv } from 'vite'
-import vitePluginTaro, { type VitePluginTaroTarget } from 'vite-plugin-taro'
-
-const targetEnvName = 'VITE_PLUGIN_TARO_TARGET'
-
-function getTarget(env: Record<string, string>): VitePluginTaroTarget {
-    const target = env[targetEnvName]
-    if (target === 'wx' || target === 'h5') return target
-    throw new Error(`${targetEnvName} must be "wx" or "h5".`)
-}
-
-export default defineConfig(({ mode }) => {
-    const env = loadEnv(mode, process.cwd(), 'VITE_PLUGIN_TARO_')
-    const target = getTarget(env)
-
-    return {
-        build: {
-            outDir: `dist/${target}`
-        },
-        plugins: [
-            vitePluginTaro({
-                target,
-                app: 'src/app.ts',
-                pages: [{ path: 'pages/index/index', config: { navigationBarTitleText: 'Home' } }],
-                appJson: {
-                    window: { navigationBarTitleText: 'Demo' }
-                },
-                projectConfigJson: {
-                    appid: env.VITE_PLUGIN_TARO_WECHAT_APP_ID || 'touristappid',
-                    projectname: 'demo',
-                    compileType: 'miniprogram'
-                },
-                sitemapJson: {
-                    rules: [{ action: 'allow', page: '*' }]
-                }
-            })
-        ]
-    }
-})
-```
-
-Important conventions:
-
-- `target` must be `wx` or `h5` for each Vite run.
-- `app` is the root React app component module. It should default-export the app component.
-- Every `pages[].path` maps to a file at `src/${path}.tsx`. For example, `pages/index/index` requires `src/pages/index/index.tsx`.
-- `appJson.pages` is generated from `pages`; any `pages` field you put in `appJson` is overwritten.
-- If your app uses Skyline, add the related `appJson` and `projectConfigJson` settings.
-- The plugin does not read Taro CLI config files such as `config/index.ts`, `app.config.ts`, or page `config.ts` files. Pass app and page config through the plugin options.
-
-### 3. Create the app component
-
-`src/app.ts` is the shared application wrapper. It receives the current page as `children`.
-
-```tsx
-import type { PropsWithChildren } from 'react'
-import './app.css'
-
-export default function App({ children }: PropsWithChildren) {
-    return children
-}
-```
-
-Import global styles from the app component. The next step creates `src/app.css`.
-
-### 4. Create global styles
-
-`src/app.css` can use plain CSS, component CSS modules, and Tailwind CSS v4. The plugin injects Taro H5 component styles automatically; the default global stylesheet enables Tailwind CSS v4 for both targets:
-
-```css
-@import "tailwindcss/theme.css";
-@import "tailwindcss/preflight.css";
-@import "tailwindcss/utilities.css";
-
-@source "./";
-```
-
-Keep `@source "./";` so Tailwind scans your source tree.
-
-### 5. Create a page component
-
-`src/pages/index/index.tsx` is the React component for `pages/index/index`.
-
-```tsx
-import { Text, View } from 'virtual:taro/components'
-
-export default function IndexPage() {
-    return (
-        <View className="p-4">
-            <Text>Hello Taro</Text>
-        </View>
-    )
-}
-```
-
-### 6. Add the H5 HTML shell
-
-For H5, keep a normal Vite `index.html` with an `#app` mount node. The plugin injects the generated Taro H5 entry automatically, so you do not need a normal Vite `src/main.tsx` script.
-
-```html
-<div id="app"></div>
-```
-
-### 7. Add scripts
-
-Use the same scripts generated by `create-vite-taro`:
-
-```json
-{
-    "scripts": {
-        "dev:wx": "cross-env NODE_ENV=development VITE_PLUGIN_TARO_TARGET=wx vite",
-        "dev:h5": "cross-env NODE_ENV=development VITE_PLUGIN_TARO_TARGET=h5 vite",
-        "build:wx": "cross-env NODE_ENV=production VITE_PLUGIN_TARO_TARGET=wx vite build",
-        "build:h5": "cross-env NODE_ENV=production VITE_PLUGIN_TARO_TARGET=h5 vite build",
-        "preview:h5": "cross-env NODE_ENV=production VITE_PLUGIN_TARO_TARGET=h5 vite preview --outDir dist/h5",
-        "typecheck": "tsc -b"
-    }
-}
-```
-
-### 8. Run each target
-
-```sh
-npm run dev:wx       # Start WX development with hot reload
-npm run dev:h5       # Start the H5 dev server
-npm run build:wx     # Build dist/wx
-npm run build:h5     # Build dist/h5
-npm run preview:h5   # Preview dist/h5
-npm run typecheck    # Typecheck with tsc
-```
-
-Open the generated `dist/wx` directory in WeChat DevTools.
-
-WX development completes an eager build of the App and every configured page before Vite reports ready. JavaScript and TypeScript component edits use React Refresh and preserve compatible React state, the current Taro page, and native input state. Module-local state resets on each code update. Changes to CSS, assets, or app configuration intentionally perform a complete rebuild and DevTools reload. The generated development project enables WeChat's `compileHotReLoad` setting automatically.
-
-| Target | Meaning | Output dir |
-| --- | --- | --- |
-| `wx` | WeChat Mini Program in both dev/prod mode. | `dist/wx` |
-| `h5` | H5 production output. | `dist/h5` |
-
-## Options
-
-```ts
-type VitePluginTaroTarget = 'wx' | 'h5'
-
-type VitePluginTaroPageOption = {
-    path: string
-    config: Record<string, unknown>
-}
-
-type VitePluginTaroOptions = {
-    target: VitePluginTaroTarget
-    app: string
-    pages: VitePluginTaroPageOption[]
-    appJson: Record<string, unknown>
-    projectConfigJson: Record<string, unknown>
-    sitemapJson: Record<string, unknown>
-}
-```
-
-| Option | Description |
-| --- | --- |
-| `target` | Active target for this Vite invocation. Use `wx` for WeChat Mini Program and `h5` for Web. |
-| `app` | Source file that default-exports the root React app component, for example `src/app.ts` or `src/app.tsx`. |
-| `pages` | Ordered page list. The order becomes `app.json.pages` and the Web route order. |
-| `pages[].path` | Taro-style route and output path without extension, for example `pages/index/index`. The page component must exist at `src/${path}.tsx`. |
-| `pages[].config` | Page config merged into the generated WeChat page JSON and Web route config. |
-| `appJson` | Base app config shared by both targets. The plugin overwrites the `pages` field from `options.pages`. |
-| `projectConfigJson` | WeChat `project.config.json` content emitted for `wx` builds. It is required by the option type even when the current target is `h5`. |
-| `sitemapJson` | WeChat `sitemap.json` content emitted for `wx` builds. It is required by the option type even when the current target is `h5`. |
-
-## Conditional compilation
-
-The plugin strips inactive Taro-style conditional comment blocks before Vite parses source. This works in TypeScript, JavaScript, JSX/TSX, CSS, Sass, Less, and Stylus files outside `node_modules`.
-
-```ts
-// #ifdef wx
-console.log('WeChat only')
-// #endif
-
-// #ifdef h5
-console.log('H5 only')
-// #endif
-
-// #ifndef h5
-console.log('Not H5')
-// #else
-console.log('H5 fallback')
-// #endif
-```
-
-Supported directives are `#ifdef`, `#ifndef`, `#else`, and `#endif`. Conditions use the plugin target tokens `wx` and `h5`.
-
-## Output by target
-
-### WeChat Mini Program
-
-For `target: 'wx'`, the plugin configures Vite to emit WeChat-compatible CommonJS chunks and Mini Program companion files.
-
-Typical output:
-
-```text
-dist/wx/
-├── app.js
-├── app.json
-├── app.wxss
-├── base.wxml
-├── comp.js
-├── comp.json
-├── comp.wxml
-├── project.config.json
-├── sitemap.json
-├── utils.wxs
-└── pages/**
-```
-
-Open `dist/wx` with WeChat DevTools; do not open the source project directory.
-
-### H5 / Web
-
-For `target: 'h5'`, the plugin injects a generated module into `index.html`, imports Taro H5 component styles before the app, builds route records from `pages`, and mounts the app with Taro's hash-history router. Routes use the page paths from your config, for example `#/pages/index/index`.
-
-## Migrating from Taro
-
-You can keep most React page components, business logic, assets, and styles, but the build entry moves from Taro CLI config to Vite config.
-
-Migration checklist:
-
-1. Install `vite-plugin-taro` and create `vite.config.ts` with `vitePluginTaro(...)`.
-2. Move app config and page config into `vite.config.ts`. The plugin does not read Taro files such as `config/index.ts`, `app.config.ts`, or page `config.ts`.
-3. Register every page in `pages`. Each page path must match `src/${path}.tsx`.
-4. Replace Taro scripts with Vite scripts that set `VITE_PLUGIN_TARO_TARGET=wx` or `VITE_PLUGIN_TARO_TARGET=h5`.
-5. For H5, add a normal Vite `index.html` with `<div id="app"></div>` and no separate `src/main.tsx` entry.
-6. Move global styles to `src/app.css`, keep `import './app.css'` in the app entry, and add the Taro/Tailwind imports shown below.
-7. Remove all `@tarojs/*` packages from `dependencies` and `devDependencies`.
-8. Replace application imports from `@tarojs/*` with the plugin virtual modules.
-
-Before:
-
-```tsx
-import Taro from '@tarojs/taro'
-import { Text, View } from '@tarojs/components'
 ```
 
-After:
+接下来阅读[快速开始](https://vite-plugin-taro.netlify.app/guides/quick-start/)。
 
-```tsx
-import Taro from 'virtual:taro/api'
-import { Text, View } from 'virtual:taro/components'
-```
-
-Style migration:
-
-```css
-@import "tailwindcss/theme.css";
-@import "tailwindcss/preflight.css";
-@import "tailwindcss/utilities.css";
-
-@source "./";
-```
-
-Remove all `@tarojs/*` packages and do not import them directly in application code. Let the plugin own Taro runtime resolution.
-
-## Sample app
-
-The sample app lives in [`packages/loan-genius`](https://github.com/sep2/vite-plugin-taro/tree/main/packages/loan-genius). It demonstrates the page convention, target selection, WeChat output, H5 routing, and Tailwind styling.
-
-```sh
-git clone https://github.com/sep2/vite-plugin-taro.git
-
-# Install dependencies
-pnpm install
-
-# Run once, it generates the patched Taro packages
-pnpm prepare:taro
-
-# Build the plugin for sample app to use
-pnpm build:plugin
-
-# Run the sample app in WeChat
-pnpm dev:loan-genius:wx
-
-# Build the sample app to WeChat output
-pnpm build:loan-genius:wx
-
-# Run the sample app in H5 dev mode
-pnpm dev:loan-genius:h5
-
-# Build the sample app to H5 output and preview it
-pnpm build:loan-genius:h5
-pnpm preview:loan-genius:h5
-```
-
-Open `packages/loan-genius/dist/wx` with WeChat DevTools to test the Mini Program output.
-
-## Develop this repository
-
-```sh
-pnpm install
-pnpm prepare:taro
-pnpm build:plugin
-pnpm typecheck
-```
-
-Common scripts:
-
-| Script | Description |
-| --- | --- |
-| `pnpm prepare:taro` | Regenerate the patched React 19 Taro packages from upstream npm tarballs and local patch files. |
-| `pnpm build:plugin` | Build `packages/vite-plugin-taro` into `dist`. |
-| `pnpm typecheck` | Typecheck the plugin and sample app with `tsc`. |
-| `pnpm lint` | Run Biome checks. |
-| `pnpm format` | Apply Biome formatting. |
-| `pnpm dev:loan-genius:wx` | Start the WeChat Mini Program sample with hot reload. Build the plugin first. |
-| `pnpm dev:loan-genius:h5` | Start the H5 sample app in Vite dev mode. Build the plugin first. |
-| `pnpm build:loan-genius:wx` | Build the WeChat Mini Program sample to `packages/loan-genius/dist/wx`. |
-| `pnpm build:loan-genius:h5` | Build the H5 sample app to `packages/loan-genius/dist/h5`. |
-| `pnpm preview:loan-genius:h5` | Preview the built H5 sample. |
-| `pnpm changelog` | Regenerate `CHANGELOG.md` from git release tags. |
-| `pnpm publish:dry` | Dry-run package validation and publishing. |
-| `pnpm release <version\|bump>` | Validate, bump versions, update the changelog, create the release commit and tag, and push to trigger CI publishing. |
-| `pnpm publish:all` | Publish the public packages in dependency order; mainly used by the tag-based Trusted Publishing workflow. |
-
-## Limitations
-
-- Only React apps are supported today.
-- Only `wx` and `h5` targets are generated today.
-- Application code must not import `@tarojs/*` packages directly.
-
-## Troubleshooting
-
-| Problem | Check |
-| --- | --- |
-| `VITE_PLUGIN_TARO_TARGET must be "wx" or "h5"` | Set the target environment variable in your script or `.env` file. |
-| `pnpm install` says dependency build scripts were ignored | Run `pnpm approve-builds` and approve the requested dependency build scripts. |
-| A page cannot be resolved | Confirm that `pages[].path` has a matching `src/${path}.tsx` file. |
-| WeChat DevTools cannot open the app | Open the generated `dist/wx` folder and check `projectConfigJson.appid`. |
-| H5 shows a blank page | Keep `<div id="app"></div>` in `index.html`, register the plugin, and avoid adding a separate default Vite `main.tsx` entry. |
-| Taro APIs are missing or behave differently | Remove direct `@tarojs/*` imports from application code and import Taro from `virtual:taro/api`. |
-| Components render without expected styles on H5 | Ensure the app entry imports `./app.css` and the generated H5 entry is injected into `index.html`. |
-| Tailwind classes do not appear | Ensure `src/app.css` imports Tailwind's CSS files, keeps `@source "./";`, and class names are statically discoverable. Restart the dev server after moving files. |
-
-## Release workflow
-
-This repository publishes automatically with npm Trusted Publishing and GitHub Actions. Normal pushes to `main` do not publish; only tags matching `v*.*.*` trigger `.github/workflows/publish.yml`.
-
-Create a release:
-
-```sh
-pnpm release patch
-```
-
-`pnpm release` requires a clean `main` working tree, runs `pnpm version:bump`, validates with `pnpm publish:dry -- --no-git-check`, creates the `chore: release vX.Y.Z` commit and `vX.Y.Z` tag, then pushes the branch and tag to trigger CI. You can also release an exact version or prerelease:
-
-```sh
-pnpm release 0.2.0
-pnpm release prerelease --preid beta
-pnpm release patch --dry-run
-pnpm release patch --no-push
-```
+## 文档
 
-CI runs `pnpm publish:all -- --no-git-check`, packs packages in dependency order, and publishes public packages through npm OIDC. Do not configure `NPM_TOKEN` for the publish workflow; each npm package's Trusted Publisher should point to `publish.yml`.
+- [全自动分包](https://vite-plugin-taro.netlify.app/guides/automatic-subpackages/)
+- [微信原生组件](https://vite-plugin-taro.netlify.app/guides/native-components/)
+- [开发者工具热更新](https://vite-plugin-taro.netlify.app/guides/hot-module-replacement/)
+- [Skyline 模式](https://vite-plugin-taro.netlify.app/guides/skyline-mode/)
+- [从 Taro CLI 迁移](https://vite-plugin-taro.netlify.app/guides/migrate-from-taro/)
+- [配置参考](https://vite-plugin-taro.netlify.app/references/configuration/)
+- [仓库维护](https://vite-plugin-taro.netlify.app/references/repository-management/)
 
-## License
+## 许可证
 
 MIT

package/client.d.ts

@@ -7,3 +7,12 @@ declare module 'virtual:taro/api' {
 declare module 'virtual:taro/components' {
     export * from '@tarojs/components'
 }
+
+declare module 'virtual:taro/native' {
+    type NativeModule = typeof import('./src/runtime/client/taro/define-native-component.ts')
+
+    export type NativeComponentEvent<Detail> =
+        import('./src/runtime/client/taro/define-native-component.ts').NativeComponentEvent<Detail>
+
+    export const defineNativeComponent: NativeModule['defineNativeComponent']
+}

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

@@ -0,0 +1,4 @@
+import type { Plugin } from 'vite';
+export declare const clientTaroApiId = "virtual:taro/api";
+/** Creates the target-neutral Taro facade plugin. */
+export declare function createClientTaroPlugin(): Plugin;

package/dist/node/plugins/client/client-taro.js

@@ -0,0 +1,19 @@
+import { resolvePackageFile } from '../../utils/packages.js';
+import { clientTaroNativeId } from './constant.js';
+export const clientTaroApiId = 'virtual:taro/api';
+const clientTaroComponentId = 'virtual:taro/components';
+const clientTaroModules = new Map([
+    [clientTaroApiId, resolvePackageFile('dist/runtime/client/taro/api.js')],
+    [clientTaroComponentId, resolvePackageFile('dist/runtime/client/taro/component.js')],
+    [clientTaroNativeId, resolvePackageFile('dist/runtime/client/taro/define-native-component.js')]
+]);
+/** Creates the target-neutral Taro facade plugin. */
+export function createClientTaroPlugin() {
+    return {
+        name: 'vpt:client-taro',
+        enforce: 'pre',
+        resolveId(id) {
+            return clientTaroModules.get(id);
+        }
+    };
+}

package/dist/node/plugins/client/constant.d.ts

@@ -0,0 +1,4 @@
+/** Maps runtime App imports to the configured application component. */
+export declare const appComponentId = "\0vpt:app-component";
+/** Exposes compile-time native component JSX interfaces to application modules. */
+export declare const clientTaroNativeId = "virtual:taro/native";

package/dist/node/plugins/client/constant.js

@@ -0,0 +1,4 @@
+/** Maps runtime App imports to the configured application component. */
+export const appComponentId = '\0vpt:app-component';
+/** Exposes compile-time native component JSX interfaces to application modules. */
+export const clientTaroNativeId = 'virtual:taro/native';

package/dist/node/plugins/conditional/conditional-directives.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from 'vite';
+import type { VitePluginTaroTarget } from '../../../options.ts';
+/** Creates source-level target conditional handling shared by H5 and WX. */
+export declare function createConditionalDirectivePlugin(target: VitePluginTaroTarget): Plugin;