vite-plugin-taro 0.0.4 → 0.0.6

package/dist/vite/vite-plugin-taro.js

@@ -3,6 +3,7 @@ import { createTailwindcssPlugins } from './tailwindcss.js';
 import { createH5SupportPlugins, createH5ViteConfig, createWebIndexHtmlTags, isH5VirtualModuleId, loadH5VirtualModule } from './targets/h5.js';
 import { createWxViteConfig, emitWechatAssets, emitWechatImplicitChunksForVirtualApp, isWxVirtualModuleId, loadWxVirtualModule } from './targets/wx.js';
 import { stripVirtualPrefix, toImportPath } from './utils.js';
+import { resolvePublicVirtualModuleId } from './virtual-modules.js';
 /**
  * Creates the Vite/Rolldown plugin that emits either WeChat Mini Program files
  * or a Taro Web app using the official Taro runtime packages.
@@ -38,10 +39,9 @@ function createVitePluginTaroPlugin(context) {
                 return context.target === 'wx' ? createWxViteConfig(context) : createH5ViteConfig();
             }
         },
-        /** Marks generated app/page/component entries as virtual modules. */
+        /** Maps public virtual modules to real proxy files and marks generated entries as virtual modules. */
         resolveId(id) {
-            if (isWxVirtualModuleId(id) || isH5VirtualModuleId(id))
-                return `\0${id}`;
+            return resolvePublicVirtualModuleId(id) ?? (isWxVirtualModuleId(id) || isH5VirtualModuleId(id) ? `\0${id}` : undefined);
         },
         /** Supplies source code for each virtual entry module. */
         load(id) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-taro",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Vite 8 plugin for building one React/Taro codebase for WeChat Mini Program and H5 targets.",
   "type": "module",
   "repository": {
@@ -20,38 +20,18 @@
       "import": "./dist/vite.js",
       "default": "./dist/vite.js"
     },
-    "./components": {
-      "types": "./src/public/components.ts",
-      "import": "./dist/public/components.js",
-      "default": "./dist/public/components.js"
-    },
-    "./taro": {
-      "types": "./src/public/taro.d.ts",
-      "import": "./dist/public/taro.js",
-      "default": "./dist/public/taro.js"
-    },
-    "./shim/h5": {
-      "types": "./src/shim/h5.ts",
-      "import": "./dist/shim/h5.js",
-      "default": "./dist/shim/h5.js"
-    },
-    "./shim/wx": {
-      "types": "./src/shim/wx.ts",
-      "import": "./dist/shim/wx.js",
-      "default": "./dist/shim/wx.js"
-    },
-    "./vite": {
-      "types": "./src/vite.ts",
-      "import": "./dist/vite.js",
-      "default": "./dist/vite.js"
+    "./client": {
+      "types": "./client.d.ts"
     },
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
     "src",
+    "client.d.ts",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "README.en.md"
   ],
   "keywords": [
     "vite",
@@ -67,7 +47,7 @@
     "access": "public"
   },
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22"
   },
   "dependencies": {
     "@babel/core": "^7.29.7",
@@ -84,8 +64,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@4.2.0-react19.3",
-    "@tarojs/react": "npm:vite-plugin-taro-react@4.2.0-react19.3"
+    "@tarojs/plugin-framework-react": "npm:vite-plugin-taro-plugin-framework-react@4.2.0-react19.5",
+    "@tarojs/react": "npm:vite-plugin-taro-react@4.2.0-react19.5"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -99,7 +79,7 @@
     "vite": "^8.0.16"
   },
   "scripts": {
-    "build": "rm -rf dist && tsgo --project tsconfig.json",
+    "build": "node ../../scripts/sync-plugin-readme.mjs && rm -rf dist && tsgo --project tsconfig.json",
     "typecheck": "tsgo --project tsconfig.json --noEmit"
   }
 }

package/src/vite/constants.ts

@@ -1,5 +1,15 @@
 import { createRequire } from 'node:module'
+import path from 'node:path'
 
 export const isProd = process.env.NODE_ENV === 'production'
 
 export const nodeRequire = createRequire(import.meta.url)
+
+const packageRoot = path.dirname(nodeRequire.resolve('vite-plugin-taro/package.json'))
+
+export const h5ShimImportPath = normalizeFileImport(path.join(packageRoot, 'dist/shim/h5.js'))
+export const wxShimImportPath = normalizeFileImport(path.join(packageRoot, 'dist/shim/wx.js'))
+
+function normalizeFileImport(filePath: string): string {
+    return filePath.replace(/\\/g, '/')
+}

package/src/vite/targets/h5.ts

@@ -2,9 +2,10 @@ import type { types as BabelTypes, NodePath, PluginObj } from '@babel/core'
 import babel from '@rolldown/plugin-babel'
 import react from '@vitejs/plugin-react'
 import type { HtmlTagDescriptor, PluginOption, UserConfig } from 'vite'
-import { isProd, nodeRequire } from '../constants.ts'
+import { h5ShimImportPath, isProd, nodeRequire } from '../constants.ts'
 import type { JsonObject, VitePluginTaroBuildContext, VitePluginTaroPageOption } from '../types.ts'
 import { createPageComponentImport } from '../utils.ts'
+import { virtualTaroApiId } from '../virtual-modules.ts'
 
 const virtualH5Id = 'virtual:vite-plugin-taro/h5'
 const patchStencilCssOrder = true
@@ -87,14 +88,14 @@ export function createH5SupportPlugins(): PluginOption[] {
         )
     }
 
-    // Mirrors Taro H5: rewrite default Taro.xxx calls from vite-plugin-taro/taro to named H5 API imports.
+    // Mirrors Taro H5: rewrite default Taro.xxx calls from virtual:taro/api to named H5 API imports.
     plugins.push(
         babel({
             plugins: [
                 [
                     nodeRequire.resolve('babel-plugin-transform-taroapi'),
                     {
-                        packageName: 'vite-plugin-taro/taro',
+                        packageName: virtualTaroApiId,
                         definition: nodeRequire(nodeRequire.resolve('@tarojs/plugin-platform-h5/dist/definition.json'))
                     }
                 ]
@@ -180,7 +181,7 @@ import {
     createRouter,
     handleAppMount,
     window
-} from 'vite-plugin-taro/shim/h5'
+} from ${JSON.stringify(h5ShimImportPath)}
 import React from 'react'
 import ReactDOM from 'react-dom/client'
 import AppComponent from '${context.appComponentImport}'

package/src/vite/targets/wx.ts

@@ -2,7 +2,7 @@ import path from 'node:path'
 import { recursiveMerge } from '@tarojs/helper'
 import { Weapp as WechatPlatform } from '@tarojs/plugin-platform-weapp'
 import type { UserConfig } from 'vite'
-import { isProd, nodeRequire } from '../constants.ts'
+import { isProd, nodeRequire, wxShimImportPath } from '../constants.ts'
 import type { JsonObject, VitePluginTaroBuildContext, VitePluginTaroPageOption } from '../types.ts'
 import { createPageComponentImport, normalizeModuleId } from '../utils.ts'
 
@@ -38,7 +38,7 @@ export function loadWxVirtualModule(cleanId: string, context: VitePluginTaroBuil
 }
 
 const taroWechatComponentsReactPath = nodeRequire.resolve('@tarojs/plugin-platform-weapp/dist/components-react')
-const vitePluginTaroSourcePath = normalizeModuleId(path.dirname(nodeRequire.resolve('vite-plugin-taro/vite')))
+const vitePluginTaroSourcePath = normalizeModuleId(path.dirname(nodeRequire.resolve('vite-plugin-taro')))
 const taroVersion = String(nodeRequire('@tarojs/runtime/package.json').version)
 
 /**
@@ -210,7 +210,7 @@ export function emitWechatImplicitChunksForVirtualApp(
 export function createWxAppEntry(context: VitePluginTaroBuildContext): string {
     const wechatAppConfigCode = JSON.stringify(context.appConfig)
 
-    return `import { createReactApp, ReactDOM } from 'vite-plugin-taro/shim/wx'
+    return `import { createReactApp, ReactDOM } from ${JSON.stringify(wxShimImportPath)}
 import React from 'react'
 import AppComponent from '${context.appComponentImport}'
 
@@ -227,7 +227,7 @@ App(createReactApp(AppComponent, React, ReactDOM, appConfig))
 export function createWxPageEntry(pageOption: VitePluginTaroPageOption): string {
     const wechatPageConfigCode = JSON.stringify(pageOption.config)
     const pageComponentImport = createPageComponentImport(pageOption.path)
-    return `import { createPageConfig } from 'vite-plugin-taro/shim/wx'
+    return `import { createPageConfig } from ${JSON.stringify(wxShimImportPath)}
 import PageComponent from '${pageComponentImport}'
 
 const pageConfig = ${wechatPageConfigCode}
@@ -247,7 +247,7 @@ Page(taroPageConfig)
  * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/template/comp.ts#L1-L4
  */
 export function createWxCompEntry(): string {
-    return `import { createRecursiveComponentConfig } from 'vite-plugin-taro/shim/wx'
+    return `import { createRecursiveComponentConfig } from ${JSON.stringify(wxShimImportPath)}
 
 Component(createRecursiveComponentConfig())
 `

package/src/vite/virtual-modules.ts

@@ -0,0 +1,14 @@
+import path from 'node:path'
+import { nodeRequire } from './constants.ts'
+
+export const virtualTaroApiId = 'virtual:taro/api'
+export const virtualTaroComponentsId = 'virtual:taro/components'
+
+const packageRoot = path.dirname(nodeRequire.resolve('vite-plugin-taro/package.json'))
+const virtualTaroApiResolvedId = path.join(packageRoot, 'dist/virtual/api.js')
+const virtualTaroComponentsResolvedId = path.join(packageRoot, 'dist/virtual/components.js')
+
+export function resolvePublicVirtualModuleId(id: string): string | undefined {
+    if (id === virtualTaroApiId) return virtualTaroApiResolvedId
+    if (id === virtualTaroComponentsId) return virtualTaroComponentsResolvedId
+}

package/src/vite/vite-plugin-taro.ts

@@ -17,6 +17,7 @@ import {
 } from './targets/wx.ts'
 import type { VitePluginTaroBuildContext, VitePluginTaroOptions } from './types.ts'
 import { stripVirtualPrefix, toImportPath } from './utils.ts'
+import { resolvePublicVirtualModuleId } from './virtual-modules.ts'
 
 /**
  * Creates the Vite/Rolldown plugin that emits either WeChat Mini Program files
@@ -58,9 +59,9 @@ function createVitePluginTaroPlugin(context: VitePluginTaroBuildContext): Plugin
             }
         },
 
-        /** Marks generated app/page/component entries as virtual modules. */
+        /** Maps public virtual modules to real proxy files and marks generated entries as virtual modules. */
         resolveId(id) {
-            if (isWxVirtualModuleId(id) || isH5VirtualModuleId(id)) return `\0${id}`
+            return resolvePublicVirtualModuleId(id) ?? (isWxVirtualModuleId(id) || isH5VirtualModuleId(id) ? `\0${id}` : undefined)
         },
 
         /** Supplies source code for each virtual entry module. */

package/src/public/taro.d.ts

@@ -1,2 +0,0 @@
-import Taro = require('@tarojs/taro')
-export = Taro