vite-plugin-taro 0.2.1 → 0.2.2

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.1",
+  "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/react": "npm:vite-plugin-taro-react@0.2.1",
-    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@0.2.1"
+    "@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",

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',