vite-plugin-taro 0.2.0 → 0.2.2

package/README.md

@@ -71,7 +71,7 @@ npm run build:h5
 # Preview the built H5 app
 npm run preview:h5
 
-# Typecheck with tsgo
+# Typecheck with tsc
 npm run typecheck
 ```
 
@@ -102,11 +102,11 @@ For existing apps or custom project layouts, follow the steps below to wire the
 npm install -D vite-plugin-taro
 ```
 
-Your app must also provide Vite 8, React 19, React DOM 19, a TypeScript checker, and Node/React type packages. If your app does not already have them, install the missing packages:
+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/native-preview @types/node @types/react @types/react-dom cross-env
+npm install -D vite typescript@rc @types/node @types/react @types/react-dom cross-env
 ```
 
 You should NOT have direct dependencies on `@tarojs/*` packages anymore. Remove them if you have.
@@ -286,7 +286,7 @@ Use the same scripts generated by `create-vite-taro`:
         "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": "tsgo -b"
+        "typecheck": "tsc -b"
     }
 }
 ```
@@ -299,7 +299,7 @@ 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 tsgo
+npm run typecheck    # Typecheck with tsc
 ```
 
 Open the generated `dist/wx` directory in WeChat DevTools.
@@ -485,7 +485,7 @@ Common scripts:
 | --- | --- |
 | `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 `tsgo`. |
+| `pnpm typecheck` | Typecheck the plugin and sample app with `tsc`. |
 | `pnpm lint` | Run Biome checks. |
 | `pnpm format` | Apply Biome formatting. |
 | `pnpm dev:sample:wx` | Build the sample WeChat Mini Program in watch mode. Build the plugin first. |

package/README.zh.md

@@ -71,7 +71,7 @@ npm run build:h5
 # 预览构建后的 H5 应用
 npm run preview:h5
 
-# 使用 tsgo 进行类型检查
+# 使用 tsc 进行类型检查
 npm run typecheck
 ```
 
@@ -102,11 +102,11 @@ import { Text, View } from 'virtual:taro/components'
 npm install -D vite-plugin-taro
 ```
 
-你的应用还必须提供 Vite 8、React 19、React DOM 19、TypeScript 检查器，以及 Node/React 类型包。如果应用尚未安装它们，请安装缺失的包：
+你的应用还必须提供 Vite 8、React 19、React DOM 19、TypeScript 7，以及 Node/React 类型包。如果应用尚未安装它们，请安装缺失的包：
 
 ```sh
 npm install react react-dom
-npm install -D vite @typescript/native-preview @types/node @types/react @types/react-dom cross-env
+npm install -D vite typescript@rc @types/node @types/react @types/react-dom cross-env
 ```
 
 你不应再直接依赖任何 `@tarojs/*` 包。如果已经依赖，请将它们移除。
@@ -286,7 +286,7 @@ export default function IndexPage() {
         "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": "tsgo -b"
+        "typecheck": "tsc -b"
     }
 }
 ```
@@ -299,7 +299,7 @@ npm run dev:h5       # 启动 H5 开发服务器
 npm run build:wx     # 构建 dist/wx
 npm run build:h5     # 构建 dist/h5
 npm run preview:h5   # 预览 dist/h5
-npm run typecheck    # 使用 tsgo 进行类型检查
+npm run typecheck    # 使用 tsc 进行类型检查
 ```
 
 在微信开发者工具中打开生成的 `dist/wx` 目录。
@@ -485,7 +485,7 @@ pnpm typecheck
 | --- | --- |
 | `pnpm prepare:taro` | 从上游 npm tarball 和本地 patch 文件重新生成打过补丁的 React 19 Taro 包。 |
 | `pnpm build:plugin` | 将 `packages/vite-plugin-taro` 构建到 `dist`。 |
-| `pnpm typecheck` | 使用 `tsgo` 对插件和示例应用进行类型检查。 |
+| `pnpm typecheck` | 使用 `tsc` 对插件和示例应用进行类型检查。 |
 | `pnpm lint` | 运行 Biome 检查。 |
 | `pnpm format` | 应用 Biome 格式化。 |
 | `pnpm dev:sample:wx` | 以 watch 模式构建微信小程序示例。请先构建插件。 |

package/dist/shim/h5.d.ts

@@ -0,0 +1,4 @@
+import '@tarojs/plugin-platform-h5/dist/runtime';
+export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
+export { createBrowserHistory, createHashHistory, createRouter, handleAppMount } from '@tarojs/router';
+export { window } from '@tarojs/runtime';

package/dist/shim/wx.d.ts

@@ -0,0 +1,4 @@
+import '@tarojs/plugin-platform-weapp/dist/runtime.js';
+export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
+export { default as ReactDOM } from '@tarojs/react';
+export { createPageConfig, createRecursiveComponentConfig } from '@tarojs/runtime';

package/dist/virtual/api.d.ts

@@ -0,0 +1,3 @@
+import Taro from '@tarojs/taro';
+export * from '@tarojs/taro';
+export default Taro;

package/dist/virtual/components.d.ts

@@ -0,0 +1 @@
+export * from '@tarojs/components';

package/dist/vite/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const isProd: boolean;
+export declare const nodeRequire: NodeJS.Require;
+export declare const h5ShimImportPath: string;
+export declare const wxShimImportPath: string;

package/dist/vite/plugins.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from 'vite';
+import type { VitePluginTaroBuildContext } from './types.ts';
+/**
+ * Applies Taro-style conditional compilation comments before Vite parses source files.
+ *
+ * Mirrors Taro's CSS #ifdef/#ifndef handling, generalized before Vite parses code.
+ */
+export declare function createVitePluginTaroConditionalDirectivePlugin(context: VitePluginTaroBuildContext): Plugin;

package/dist/vite/tailwindcss.d.ts

@@ -0,0 +1,3 @@
+import type { PluginOption } from 'vite';
+import type { VitePluginTaroBuildContext } from './types.ts';
+export declare function createTailwindcssPlugins(context: VitePluginTaroBuildContext): PluginOption[];

package/dist/vite/targets/h5.d.ts

@@ -0,0 +1,31 @@
+import type { HtmlTagDescriptor, PluginOption, UserConfig } from 'vite';
+import type { VitePluginTaroBuildContext } from '../types.ts';
+/**
+ * Checks whether an id belongs to an H5 virtual module.
+ */
+export declare function isH5VirtualModuleId(id: string): boolean;
+/**
+ * Loads generated source for H5 virtual modules.
+ */
+export declare function loadH5VirtualModule(cleanId: string, context: VitePluginTaroBuildContext): string | undefined;
+/**
+ * Configures the Vite pieces needed for Taro H5 resolve/runtime behavior.
+ */
+export declare function createH5ViteConfig(): UserConfig;
+/**
+ * Creates H5-only support plugins used before the target emitter runs.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-platform-h5/src/program.ts#L219-L249
+ */
+export declare function createH5SupportPlugins(): PluginOption[];
+/**
+ * Injects vite-plugin-taro's generated Web entry into Vite's HTML shell.
+ */
+export declare function createWebIndexHtmlTags(context: VitePluginTaroBuildContext): HtmlTagDescriptor[] | undefined;
+/**
+ * Builds the generated Web entry around Taro's official Web router/runtime APIs.
+ * Base Taro CSS is imported before the app; component CSS order is handled by rewriteStencilStyleInsertion.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-loader/src/h5.ts#L120-L150
+ */
+export declare function createWebEntry(context: VitePluginTaroBuildContext): string;

package/dist/vite/targets/h5.js

@@ -119,8 +119,6 @@ function createH5TaroDefines() {
         'process.env.SUPPORT_TARO_POLYFILL': JSON.stringify('disabled'),
         'process.env.TARO_ENV': JSON.stringify('h5'),
         'process.env.TARO_PLATFORM': JSON.stringify('web'),
-        IS_H5: 'true',
-        IS_WEAPP: 'false',
         'process.env.SUPPORT_DINGTALK_NAVIGATE': JSON.stringify('disabled'),
         DEPRECATED_ADAPTER_COMPONENT: 'false'
     };

package/dist/vite/targets/wx.d.ts

@@ -0,0 +1,74 @@
+import type { UserConfig } from 'vite';
+import type { VitePluginTaroBuildContext, VitePluginTaroPageOption } from '../types.ts';
+/**
+ * Checks whether an id belongs to a wx virtual module.
+ */
+export declare function isWxVirtualModuleId(id: string): boolean;
+export declare function loadWxVirtualModule(cleanId: string, context: VitePluginTaroBuildContext): string | undefined;
+/**
+ * Configures wx target entry, output, and chunk layout.
+ */
+export declare function createWxViteConfig(context: VitePluginTaroBuildContext): UserConfig;
+type WechatAssetSource = string | Uint8Array;
+type WechatBundleModule = {
+    renderedExports?: string[];
+};
+type WechatBundleItem = {
+    type: 'asset' | 'chunk';
+    source?: WechatAssetSource;
+    modules?: Record<string, WechatBundleModule>;
+};
+type WechatBundle = Record<string, WechatBundleItem>;
+type WechatChunkEmitter = {
+    emitFile(chunk: {
+        type: 'chunk';
+        id: string;
+        fileName: string;
+        implicitlyLoadedAfterOneOf: string[];
+    }): string;
+};
+type WechatAssetEmitter = {
+    emitFile(asset: {
+        type: 'asset';
+        fileName: string;
+        source: WechatAssetSource;
+    }): string;
+};
+/**
+ * Emits page and component chunks like Taro Webpack's MiniPlugin generated entries.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L228-L243
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L743-L777
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/TaroSingleEntryPlugin.ts#L18-L38
+ */
+export declare function emitWechatImplicitChunksForVirtualApp(emitter: WechatChunkEmitter, context: VitePluginTaroBuildContext, cleanId: string): void;
+/**
+ * Builds the generated WeChat app entry that registers Taro's React App config.
+ * vite-plugin-taro omits Taro's generated pxTransform initialization because styles are handled by Tailwind.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-loader/src/app.ts#L54-L63
+ */
+export declare function createWxAppEntry(context: VitePluginTaroBuildContext): string;
+/**
+ * Builds a generated WeChat page entry that registers Taro's Page config.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-loader/src/page.ts#L52-L78
+ */
+export declare function createWxPageEntry(pageOption: VitePluginTaroPageOption): string;
+/**
+ * Builds the generated JS companion for comp.wxml/comp.json. Without it WeChat
+ * can load recursive markup, but it will not have Taro's properties or `eh` event
+ * dispatch method.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/template/comp.ts#L1-L4
+ */
+export declare function createWxCompEntry(): string;
+/**
+ * Creates Taro-style Mini Program template/config/style companion files.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-platform-weapp/src/program.ts#L33-L55
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L1198-L1311
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L1346-L1390
+ */
+export declare function emitWechatAssets(emitter: WechatAssetEmitter, bundle: WechatBundle, context: VitePluginTaroBuildContext): void;
+export {};

package/dist/vite/targets/wx.js

@@ -88,8 +88,6 @@ function createWechatTaroDefines() {
         'process.env.TARO_ENV': JSON.stringify('weapp'),
         'process.env.TARO_PLATFORM': JSON.stringify('mini'),
         'process.env.TARO_VERSION': JSON.stringify(taroVersion),
-        IS_H5: 'false',
-        IS_WEAPP: 'true',
         ENABLE_ADJACENT_HTML: 'false',
         ENABLE_CLONE_NODE: 'false',
         ENABLE_CONTAINS: 'false',

package/dist/vite/types.d.ts

@@ -0,0 +1,38 @@
+/** Plain JSON object emitted into Mini Program/Web config payloads. */
+export type JsonObject = Record<string, unknown>;
+/** Build target handled by this plugin. */
+export type VitePluginTaroTarget = 'wx' | 'h5';
+/** Describes one React-backed page shared by WeChat Mini Program and Web builds. */
+export type VitePluginTaroPageOption = {
+    /**
+     * Page route and output path, without file extension.
+     * Example: "pages/index/index" emits pages/index/index.{js,json,wxml,wxss}
+     * for WeChat and becomes the Web router path.
+     */
+    path: string;
+    /** Page JSON config merged into WeChat JSON and Web route config. */
+    config: JsonObject;
+};
+/** Required build inputs for the custom Vite/Rolldown Taro renderer plugin. */
+export interface VitePluginTaroOptions {
+    /** Active target for this Vite invocation. */
+    target: VitePluginTaroTarget;
+    /** Source file that default-exports the root React app component. */
+    app: string;
+    /** Ordered page list; also becomes app.json.pages and Web route order. */
+    pages: VitePluginTaroPageOption[];
+    /** Base app.json content. Its pages field is overwritten from options.pages. */
+    appJson: JsonObject;
+    /** project.config.json content emitted at the Mini Program root. */
+    projectConfigJson: JsonObject;
+    /** sitemap.json content emitted at the Mini Program root. */
+    sitemapJson: JsonObject;
+}
+export type VitePluginTaroBuildContext = {
+    target: VitePluginTaroTarget;
+    appComponentImport: string;
+    pages: VitePluginTaroPageOption[];
+    appConfig: JsonObject;
+    projectConfigJson: JsonObject;
+    sitemapJson: JsonObject;
+};

package/dist/vite/utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Derives a page component import from a Taro-style page path.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L660-L668
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/utils/app.ts#L74-L90
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-loader/src/h5.ts#L12-L21
+ */
+export declare function createPageComponentImport(pagePath: string): string;
+/**
+ * Converts a local file path into a Vite file-system import specifier.
+ *
+ * Rolldown does not reliably resolve raw Windows absolute paths from virtual
+ * module source, so generated imports use Vite's /@fs/ prefix instead.
+ */
+export declare function toImportPath(filePath: string): string;
+/**
+ * Removes Rollup/Vite's internal virtual-module prefix before ID comparisons.
+ */
+export declare function stripVirtualPrefix(id: string): string;
+/**
+ * Uses Taro-style slash normalization, plus Vite query-string stripping for module IDs.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-helper/src/utils.ts#L32-L34
+ */
+export declare function normalizeModuleId(id: string): string;

package/dist/vite/virtual-modules.d.ts

@@ -0,0 +1,3 @@
+export declare const virtualTaroApiId = "virtual:taro/api";
+export declare const virtualTaroComponentsId = "virtual:taro/components";
+export declare function resolvePublicVirtualModuleId(id: string): string | undefined;

package/dist/vite/vite-plugin-taro.d.ts

@@ -0,0 +1,7 @@
+import type { PluginOption } from 'vite';
+import type { VitePluginTaroOptions } from './types.ts';
+/**
+ * Creates the Vite/Rolldown plugin that emits either WeChat Mini Program files
+ * or a Taro Web app using the official Taro runtime packages.
+ */
+export default function vitePluginTaro(options: VitePluginTaroOptions): PluginOption[];

package/dist/vite.d.ts

@@ -0,0 +1,2 @@
+export type { VitePluginTaroOptions, VitePluginTaroPageOption, VitePluginTaroTarget } from './vite/types.ts';
+export { default } from './vite/vite-plugin-taro.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "author": "sep2",
   "description": "Vite 8 plugin for building one React/Taro codebase for WeChat Mini Program and H5 targets.",
   "type": "module",
@@ -15,9 +15,10 @@
   "homepage": "https://github.com/sep2/vite-plugin-taro/tree/main/packages/vite-plugin-taro#readme",
   "main": "./dist/vite.js",
   "module": "./dist/vite.js",
+  "types": "./dist/vite.d.ts",
   "exports": {
     ".": {
-      "types": "./src/vite.ts",
+      "types": "./dist/vite.d.ts",
       "import": "./dist/vite.js",
       "default": "./dist/vite.js"
     },
@@ -64,8 +65,8 @@
     "babel-plugin-transform-taroapi": "^4.2.0",
     "tailwindcss": "^4.3.1",
     "weapp-tailwindcss": "^5.0.13",
-    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.2.0",
-    "@tarojs/react": "npm:vite-plugin-taro-react@0.2.0"
+    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.2.2",
+    "@tarojs/react": "npm:vite-plugin-taro-react@0.2.2"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -75,11 +76,11 @@
   "devDependencies": {
     "@types/babel__core": "^7.20.5",
     "@types/node": "^26.0.0",
-    "@typescript/native-preview": "latest",
+    "typescript": "^7.0.1-rc",
     "vite": "^8.0.16"
   },
   "scripts": {
-    "build": "node ../../scripts/sync-plugin-readme.ts && node ../../scripts/clean-directory.ts dist && tsgo --project tsconfig.json",
-    "typecheck": "tsgo --project tsconfig.json --noEmit"
+    "build": "node ../../scripts/sync-plugin-readme.ts && node ../../scripts/clean-directory.ts dist && tsc --project tsconfig.json",
+    "typecheck": "tsc --project tsconfig.json --noEmit"
   }
 }

package/src/vite/targets/h5.ts

@@ -140,8 +140,6 @@ function createH5TaroDefines(): Record<string, string> {
         'process.env.SUPPORT_TARO_POLYFILL': JSON.stringify('disabled'),
         'process.env.TARO_ENV': JSON.stringify('h5'),
         'process.env.TARO_PLATFORM': JSON.stringify('web'),
-        IS_H5: 'true',
-        IS_WEAPP: 'false',
         'process.env.SUPPORT_DINGTALK_NAVIGATE': JSON.stringify('disabled'),
         DEPRECATED_ADAPTER_COMPONENT: 'false'
     }

package/src/vite/targets/wx.ts

@@ -99,8 +99,6 @@ function createWechatTaroDefines(): Record<string, string> {
         'process.env.TARO_ENV': JSON.stringify('weapp'),
         'process.env.TARO_PLATFORM': JSON.stringify('mini'),
         'process.env.TARO_VERSION': JSON.stringify(taroVersion),
-        IS_H5: 'false',
-        IS_WEAPP: 'true',
         ENABLE_ADJACENT_HTML: 'false',
         ENABLE_CLONE_NODE: 'false',
         ENABLE_CONTAINS: 'false',