vite-plugin-taro 0.0.2 → 0.0.4

package/src/vite/targets/wx.ts

@@ -0,0 +1,438 @@
+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 type { JsonObject, VitePluginTaroBuildContext, VitePluginTaroPageOption } from '../types.ts'
+import { createPageComponentImport, normalizeModuleId } from '../utils.ts'
+
+const virtualWxAppId = 'virtual:vite-plugin-taro/wx/app'
+const virtualWxCompId = 'virtual:vite-plugin-taro/wx/comp'
+const virtualWxPagePrefix = 'virtual:vite-plugin-taro/wx/page/'
+
+/**
+ * Checks whether an id belongs to a wx virtual module.
+ */
+export function isWxVirtualModuleId(id: string): boolean {
+    return id === virtualWxAppId || id === virtualWxCompId || id.startsWith(virtualWxPagePrefix)
+}
+
+export function loadWxVirtualModule(cleanId: string, context: VitePluginTaroBuildContext): string | undefined {
+    if (cleanId === virtualWxAppId) {
+        return createWxAppEntry(context)
+    }
+
+    if (cleanId === virtualWxCompId) {
+        return createWxCompEntry()
+    }
+
+    if (!cleanId.startsWith(virtualWxPagePrefix)) {
+        return
+    }
+
+    const pagePath = cleanId.slice(virtualWxPagePrefix.length)
+    const page = context.pages.find((candidate) => candidate.path === pagePath)
+    if (page) {
+        return createWxPageEntry(page)
+    }
+}
+
+const taroWechatComponentsReactPath = nodeRequire.resolve('@tarojs/plugin-platform-weapp/dist/components-react')
+const vitePluginTaroSourcePath = normalizeModuleId(path.dirname(nodeRequire.resolve('vite-plugin-taro/vite')))
+const taroVersion = String(nodeRequire('@tarojs/runtime/package.json').version)
+
+/**
+ * Configures wx target entry, output, and chunk layout.
+ */
+export function createWxViteConfig(context: VitePluginTaroBuildContext): UserConfig {
+    return {
+        define: createWechatTaroDefines(),
+        // https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/MiniCombination.ts#L22-L84
+        resolve: {
+            // https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/MiniBaseConfig.ts#L44-L73
+            alias: [{ find: /^@tarojs\/components$/, replacement: taroWechatComponentsReactPath }]
+        },
+        build: {
+            target: 'es2018',
+            assetsInlineLimit: 1024,
+            cssCodeSplit: false,
+            minify: isProd,
+            rolldownOptions: {
+                // Start from app; page/component chunks below mirror Taro Webpack's generated entries.
+                input: { app: virtualWxAppId },
+                experimental: {
+                    // Rolldown's dev debug comments include virtual IDs like "\0virtual:...".
+                    // WeChat DevTools can blank-screen on those NUL markers, so disable them at the source.
+                    attachDebugInfo: 'none'
+                },
+                output: {
+                    format: 'cjs',
+                    entryFileNames: '[name].js',
+                    assetFileNames: 'assets/[name][extname]',
+                    chunkFileNames: createWechatChunkFileName,
+                    strictExecutionOrder: true,
+                    codeSplitting: {
+                        includeDependenciesRecursively: false,
+                        minSize: 0,
+                        // https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/MiniCombination.ts#L96-L144
+                        groups: [
+                            { name: 'taro', test: isWxTaroChunkModule, priority: 100 },
+                            { name: 'vendors', test: isNodeModule, priority: 10 },
+                            { name: 'common', minShareCount: 2, minModuleSize: 1, priority: 1 }
+                        ]
+                    }
+                }
+            }
+        }
+    }
+}
+
+/**
+ * Creates compile-time constants expected by Taro's WeChat runtime packages.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/MiniWebpackPlugin.ts#L67-L94
+ */
+function createWechatTaroDefines(): Record<string, string> {
+    return {
+        'process.env.FRAMEWORK': JSON.stringify('react'),
+        'process.env.SUPPORT_TARO_POLYFILL': JSON.stringify('disabled'),
+        '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',
+        ENABLE_INNER_HTML: 'false',
+        ENABLE_MUTATION_OBSERVER: 'false',
+        ENABLE_SIZE_APIS: 'false',
+        ENABLE_TEMPLATE_CONTENT: 'false'
+    }
+}
+
+/**
+ * Checks whether a module should live in the Taro/framework base chunk.
+ * vite-plugin-taro support modules are kept with Taro so pages do not duplicate runtime facades.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/MiniCombination.ts#L141-L144
+ */
+function isWxTaroChunkModule(id: string): boolean {
+    const normalizedId = normalizeModuleId(id)
+    return normalizedId.includes('/node_modules/@tarojs/') || normalizedId.startsWith(`${vitePluginTaroSourcePath}/`)
+}
+
+/**
+ * Names Rolldown's helper chunk like Taro webpack's runtime chunk.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/MiniCombination.ts#L96-L103
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/MiniCombination.ts#L115-L117
+ */
+function createWechatChunkFileName(chunkInfo: { name: string }): string {
+    return `${chunkInfo.name === 'rolldown-runtime' ? 'runtime' : chunkInfo.name}.js`
+}
+
+/**
+ * Checks whether a module is a third-party dependency chunk candidate.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/MiniCombination.ts#L132-L139
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-helper/src/utils.ts#L32-L36
+ */
+function isNodeModule(id: string): boolean {
+    return normalizeModuleId(id).includes('/node_modules/')
+}
+
+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 WechatTemplateComponentConfig = {
+    includes: Set<string>
+    exclude: Set<string>
+    thirdPartyComponents: Map<string, Set<string>>
+    includeAll: boolean
+}
+
+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 function emitWechatImplicitChunksForVirtualApp(
+    emitter: WechatChunkEmitter,
+    context: VitePluginTaroBuildContext,
+    cleanId: string
+): void {
+    if (context.target !== 'wx' || cleanId !== virtualWxAppId) return
+
+    for (const page of context.pages) {
+        emitter.emitFile({
+            type: 'chunk',
+            id: `${virtualWxPagePrefix}${page.path}`,
+            fileName: `${page.path}.js`,
+            implicitlyLoadedAfterOneOf: [cleanId]
+        })
+    }
+    emitter.emitFile({
+        type: 'chunk',
+        id: virtualWxCompId,
+        fileName: 'comp.js',
+        implicitlyLoadedAfterOneOf: [cleanId]
+    })
+}
+
+/**
+ * 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 function createWxAppEntry(context: VitePluginTaroBuildContext): string {
+    const wechatAppConfigCode = JSON.stringify(context.appConfig)
+
+    return `import { createReactApp, ReactDOM } from 'vite-plugin-taro/shim/wx'
+import React from 'react'
+import AppComponent from '${context.appComponentImport}'
+
+const appConfig = ${wechatAppConfigCode}
+App(createReactApp(AppComponent, React, ReactDOM, appConfig))
+`
+}
+
+/**
+ * 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 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'
+import PageComponent from '${pageComponentImport}'
+
+const pageConfig = ${wechatPageConfigCode}
+const taroPageConfig = createPageConfig(PageComponent, '${pageOption.path}', { root: { cn: [] } }, pageConfig)
+if (PageComponent && PageComponent.behaviors) {
+  taroPageConfig.behaviors = (taroPageConfig.behaviors || []).concat(PageComponent.behaviors)
+}
+Page(taroPageConfig)
+`
+}
+
+/**
+ * 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 function createWxCompEntry(): string {
+    return `import { createRecursiveComponentConfig } from 'vite-plugin-taro/shim/wx'
+
+Component(createRecursiveComponentConfig())
+`
+}
+
+/**
+ * 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 function emitWechatAssets(
+    emitter: WechatAssetEmitter,
+    bundle: WechatBundle,
+    context: VitePluginTaroBuildContext
+): void {
+    if (context.target !== 'wx') return
+    for (const asset of createWechatAssets(bundle, context)) {
+        emitter.emitFile({ type: 'asset', fileName: asset.fileName, source: asset.source })
+    }
+}
+
+function createWechatAssets(
+    bundle: WechatBundle,
+    context: VitePluginTaroBuildContext
+): { fileName: string; source: WechatAssetSource }[] {
+    const builder = createWechatTemplateBuilder()
+
+    return [
+        { fileName: 'app.json', source: stringifyJsonAsset(context.appConfig) },
+        { fileName: 'app.wxss', source: collectWechatBundleWxss(bundle) },
+        { fileName: 'base.wxml', source: builder.buildTemplate(collectWechatTemplateComponentConfig(bundle)) },
+        { fileName: 'utils.wxs', source: builder.buildXScript() },
+        { fileName: 'comp.wxml', source: builder.buildBaseComponentTemplate('.wxml') },
+        { fileName: 'comp.json', source: stringifyJsonAsset(createWechatCompJson()) },
+        { fileName: 'project.config.json', source: stringifyJsonAsset(context.projectConfigJson) },
+        { fileName: 'sitemap.json', source: stringifyJsonAsset(context.sitemapJson) },
+        ...context.pages.flatMap((page) => [
+            {
+                fileName: `${page.path}.wxml`,
+                source: builder.buildPageTemplate(relativeWechatRootAssetFromPage(page.path, 'base.wxml'), {
+                    content: page.config,
+                    path: page.path
+                })
+            },
+            {
+                fileName: `${page.path}.json`,
+                source: stringifyJsonAsset({
+                    ...page.config,
+                    usingComponents: {
+                        comp: relativeWechatRootAssetFromPage(page.path, 'comp')
+                    }
+                })
+            },
+            { fileName: `${page.path}.wxss`, source: '' }
+        ])
+    ]
+}
+
+function createWechatTemplateBuilder() {
+    const wechatPlatform = new WechatPlatform(
+        { helper: { recursiveMerge }, modifyWebpackChain() {}, registerPlatform() {} },
+        {},
+        {}
+    )
+    wechatPlatform.modifyTemplate({})
+    return wechatPlatform.template
+}
+
+/**
+ * Computes a WeChat import path from a page file to a generated root asset.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L1270-L1298
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-helper/src/utils.ts#L74-L88
+ */
+function relativeWechatRootAssetFromPage(wechatPagePath: string, wechatRootAsset: string): string {
+    const wechatPageDir = path.posix.dirname(wechatPagePath)
+    const relativePath = path.posix.relative(wechatPageDir, wechatRootAsset)
+    return relativePath.startsWith('.') ? relativePath : `./${relativePath}`
+}
+
+/**
+ * Builds Taro's template component include config from official defaults plus
+ * the component exports that Rolldown kept in the @tarojs/components bundle.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/utils/component.ts#L3-L8
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/TaroComponentsExportsPlugin.ts#L83-L124
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/TaroLoadChunksPlugin.ts#L165-L180
+ */
+function collectWechatTemplateComponentConfig(bundle: WechatBundle): WechatTemplateComponentConfig {
+    const wechatComponentConfig: WechatTemplateComponentConfig = {
+        includes: new Set([
+            'view',
+            'catch-view',
+            'static-view',
+            'pure-view',
+            'click-view',
+            'scroll-view',
+            'image',
+            'static-image',
+            'text',
+            'static-text'
+        ]),
+        exclude: new Set(),
+        thirdPartyComponents: new Map(),
+        includeAll: false
+    }
+
+    const wechatComponentsModule = findBundleModule(bundle, taroWechatComponentsReactPath)
+    for (const item of wechatComponentsModule?.renderedExports ?? []) {
+        wechatComponentConfig.includes.add(toDashed(item))
+    }
+
+    return wechatComponentConfig
+}
+
+function toDashed(s: string) {
+    return s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase()
+}
+
+/**
+ * Finds a module record inside the generated bundle by normalized module ID.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/TaroComponentsExportsPlugin.ts#L83-L124
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/TaroLoadChunksPlugin.ts#L165-L180
+ */
+function findBundleModule(bundle: WechatBundle, resolvedId: string): WechatBundleModule | undefined {
+    const normalizedResolvedId = normalizeModuleId(resolvedId)
+    for (const item of Object.values(bundle)) {
+        if (item.type !== 'chunk') {
+            continue
+        }
+
+        const found = Object.entries(item.modules ?? {}).find(([id]) => normalizeModuleId(id) === normalizedResolvedId)
+        if (found) {
+            return found[1]
+        }
+    }
+}
+
+/**
+ * Creates the JSON config for Taro's shared recursive component.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L1228-L1252
+ */
+function createWechatCompJson(): JsonObject {
+    return {
+        component: true,
+        styleIsolation: 'apply-shared',
+        // Taro's recursive template can nest <comp />, so the component references
+        // itself just like the official runner output.
+        usingComponents: { comp: './comp' }
+    }
+}
+
+/**
+ * Converts a WeChat-emitted asset's source into text.
+ */
+function getWechatAssetSource(item: WechatBundleItem): string {
+    if (typeof item.source === 'string') return item.source
+    return item.source ? new TextDecoder().decode(item.source) : ''
+}
+
+/**
+ * Flattens Vite-emitted CSS into app.wxss and removes the intermediate CSS asset.
+ * This is vite-plugin-taro's Vite equivalent of Taro Webpack's app/common style consolidation.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L1310-L1311
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/MiniPlugin.ts#L1471-L1528
+ */
+function collectWechatBundleWxss(bundle: WechatBundle): string {
+    const wechatWxssChunks: string[] = []
+    for (const [fileName, item] of Object.entries(bundle)) {
+        if (item.type !== 'asset' || !fileName.endsWith('.css')) continue
+        const source = getWechatAssetSource(item)
+        if (source) wechatWxssChunks.push(source)
+        delete bundle[fileName]
+    }
+    return wechatWxssChunks.join('\n')
+}
+
+/**
+ * Serializes generated Mini Program JSON assets; vite-plugin-taro pretty-prints non-prod output.
+ */
+function stringifyJsonAsset(value: JsonObject): string {
+    return isProd ? JSON.stringify(value) : JSON.stringify(value, null, 2)
+}

package/{dist/vite/types.d.ts → src/vite/types.ts}

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

package/src/vite/utils.ts

@@ -0,0 +1,35 @@
+import path from 'node:path'
+
+/**
+ * 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 function createPageComponentImport(pagePath: string): string {
+    return toImportPath(`src/${pagePath}.tsx`)
+}
+
+/**
+ * Converts a local file path into an absolute ESM import path for Vite.
+ */
+export function toImportPath(filePath: string): string {
+    return path.resolve(filePath)
+}
+
+/**
+ * Removes Rollup/Vite's internal virtual-module prefix before ID comparisons.
+ */
+export function stripVirtualPrefix(id: string): string {
+    return id.startsWith('\0') ? id.slice(1) : id
+}
+
+/**
+ * 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 function normalizeModuleId(id: string): string {
+    return id.replace(/\\/g, '/').replace(/\?.*$/, '')
+}

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

@@ -0,0 +1,105 @@
+import type { Plugin, PluginOption, UserConfig } from 'vite'
+import { createVitePluginTaroConditionalDirectivePlugin } from './plugins.ts'
+import { createTailwindcssPlugins } from './tailwindcss.ts'
+import {
+    createH5SupportPlugins,
+    createH5ViteConfig,
+    createWebIndexHtmlTags,
+    isH5VirtualModuleId,
+    loadH5VirtualModule
+} from './targets/h5.ts'
+import {
+    createWxViteConfig,
+    emitWechatAssets,
+    emitWechatImplicitChunksForVirtualApp,
+    isWxVirtualModuleId,
+    loadWxVirtualModule
+} from './targets/wx.ts'
+import type { VitePluginTaroBuildContext, VitePluginTaroOptions } from './types.ts'
+import { stripVirtualPrefix, toImportPath } from './utils.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[] {
+    const context = createVitePluginTaroBuildContext(options)
+
+    return [
+        createVitePluginTaroConditionalDirectivePlugin(context),
+        ...createTargetSupportPlugins(context),
+        ...createTailwindcssPlugins(context),
+        createVitePluginTaroPlugin(context)
+    ]
+}
+
+function createTargetSupportPlugins(context: VitePluginTaroBuildContext): PluginOption[] {
+    switch (context.target) {
+        case 'h5':
+            return createH5SupportPlugins()
+        default:
+            return []
+    }
+}
+
+/**
+ * Creates the vite-plugin-taro plugin that emits H5 or Wx outputs.
+ */
+function createVitePluginTaroPlugin(context: VitePluginTaroBuildContext): Plugin {
+    return {
+        name: 'vite-plugin-taro',
+        enforce: 'post',
+
+        /** Configures Vite/Rolldown for the active target. */
+        config: {
+            order: 'pre',
+            handler: (): UserConfig => {
+                return context.target === 'wx' ? createWxViteConfig(context) : createH5ViteConfig()
+            }
+        },
+
+        /** Marks generated app/page/component entries as virtual modules. */
+        resolveId(id) {
+            if (isWxVirtualModuleId(id) || isH5VirtualModuleId(id)) return `\0${id}`
+        },
+
+        /** Supplies source code for each virtual entry module. */
+        load(id) {
+            const cleanId = stripVirtualPrefix(id)
+
+            emitWechatImplicitChunksForVirtualApp(this, context, cleanId)
+
+            return loadWxVirtualModule(cleanId, context) ?? loadH5VirtualModule(cleanId, context)
+        },
+
+        /** Injects the generated Web entry into the app shell before Vite scans HTML imports. */
+        transformIndexHtml: {
+            order: 'pre',
+            handler() {
+                return createWebIndexHtmlTags(context)
+            }
+        },
+
+        /** Emits the WeChat JSON/WXML/WXS/WXSS files that are not JS bundle chunks. */
+        generateBundle(_, bundle) {
+            emitWechatAssets(this, bundle, context)
+        }
+    }
+}
+
+/**
+ * Normalizes user options into the shared data used by both target builders.
+ */
+function createVitePluginTaroBuildContext(options: VitePluginTaroOptions): VitePluginTaroBuildContext {
+    return {
+        target: options.target,
+        appComponentImport: toImportPath(options.app),
+        pages: options.pages,
+        appConfig: {
+            ...options.appJson,
+            pages: options.pages.map((page) => page.path)
+        },
+        projectConfigJson: options.projectConfigJson,
+        sitemapJson: options.sitemapJson
+    }
+}

package/src/vite.ts

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

package/dist/public/components.d.ts

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

package/dist/public/taro.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"taro.js","names":[],"sources":["../../src/public/taro.ts"],"sourcesContent":["import { hooks } from '@tarojs/runtime'\nimport Taro from '@tarojs/taro'\n\nif (hooks.isExist('initNativeApi')) {\n    hooks.call('initNativeApi', Taro)\n}\n\n// @ts-expect-error @tarojs/taro declares export= types, but vite-plugin-taro target aliases expose runtime named exports.\nexport * from '@tarojs/taro'\nexport default Taro\n"],"mappings":";;;;AAGA,IAAI,MAAM,QAAQ,eAAe,GAC7B,MAAM,KAAK,iBAAiB,IAAI;AAKpC,IAAA,eAAe"}

package/dist/shim/h5.d.ts

@@ -1,3 +0,0 @@
-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

@@ -1,3 +0,0 @@
-export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime';
-export { default as ReactDOM } from '@tarojs/react';
-export { createPageConfig, createRecursiveComponentConfig } from '@tarojs/runtime';

package/dist/vite/constants.d.ts

@@ -1,2 +0,0 @@
-export declare const isProd: boolean;
-export declare const nodeRequire: NodeJS.Require;