vite-plugin-taro 0.0.3 → 0.0.4

package/src/vite/targets/h5.ts

@@ -0,0 +1,230 @@
+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 type { JsonObject, VitePluginTaroBuildContext, VitePluginTaroPageOption } from '../types.ts'
+import { createPageComponentImport } from '../utils.ts'
+
+const virtualH5Id = 'virtual:vite-plugin-taro/h5'
+const patchStencilCssOrder = true
+
+/**
+ * Checks whether an id belongs to an H5 virtual module.
+ */
+export function isH5VirtualModuleId(id: string): boolean {
+    return id === virtualH5Id
+}
+
+/**
+ * Loads generated source for H5 virtual modules.
+ */
+export function loadH5VirtualModule(cleanId: string, context: VitePluginTaroBuildContext): string | undefined {
+    if (cleanId !== virtualH5Id) return
+    return createWebEntry(context)
+}
+
+/**
+ * Configures the Vite pieces needed for Taro H5 resolve/runtime behavior.
+ */
+export function createH5ViteConfig(): UserConfig {
+    return {
+        define: createH5TaroDefines(),
+        resolve: {
+            mainFields: ['main:h5', 'browser', 'module', 'jsnext:main', 'jsnext'],
+            alias: [
+                // Resolve Stencil's transitive runtime import after Taro components are optimized separately.
+                ...(patchStencilCssOrder
+                    ? [
+                          {
+                              find: /^@stencil\/core\/internal\/client$/,
+                              replacement: nodeRequire.resolve('@stencil/core/internal/client', {
+                                  paths: [nodeRequire.resolve('@tarojs/components/package.json')]
+                              })
+                          }
+                      ]
+                    : []),
+                // H5 React code must use Taro's React component wrappers, not the raw custom-element entry.
+                { find: /^@tarojs\/components$/, replacement: nodeRequire.resolve('@tarojs/components/lib/react') },
+                // Taro's H5 router/components deep-import this custom-element loader; make it resolvable under pnpm.
+                {
+                    find: /^@tarojs\/components\/dist\/components$/,
+                    replacement: nodeRequire.resolve('@tarojs/components/dist/components')
+                },
+                // H5 APIs are exported from the platform API barrel; the generic @tarojs/taro root is native-oriented.
+                {
+                    find: /^@tarojs\/taro$/,
+                    replacement: nodeRequire.resolve('@tarojs/plugin-platform-h5/dist/runtime/apis')
+                }
+            ]
+        },
+        optimizeDeps: {
+            // Keep the Stencil runtime in Vite's transform pipeline so rewriteStencilStyleInsertion can patch it.
+            exclude: [patchStencilCssOrder ? '@stencil/core/internal/client' : ''].filter(Boolean)
+        },
+        build: {
+            target: 'es2018',
+            minify: isProd
+        }
+    }
+}
+
+/**
+ * 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 function createH5SupportPlugins(): PluginOption[] {
+    const plugins: PluginOption[] = [...react()]
+
+    if (patchStencilCssOrder) {
+        plugins.push(
+            babel({
+                include: /[\\/]@stencil[\\/]core[\\/]internal[\\/]client[\\/]index\.js(?:\?.*)?$/,
+                exclude: [],
+                plugins: [rewriteStencilStyleInsertion]
+            })
+        )
+    }
+
+    // Mirrors Taro H5: rewrite default Taro.xxx calls from vite-plugin-taro/taro to named H5 API imports.
+    plugins.push(
+        babel({
+            plugins: [
+                [
+                    nodeRequire.resolve('babel-plugin-transform-taroapi'),
+                    {
+                        packageName: 'vite-plugin-taro/taro',
+                        definition: nodeRequire(nodeRequire.resolve('@tarojs/plugin-platform-h5/dist/definition.json'))
+                    }
+                ]
+            ]
+        })
+    )
+
+    return plugins
+}
+
+function rewriteStencilStyleInsertion(): PluginObj {
+    return {
+        name: 'rewrite-stencil-style-insertion',
+        visitor: {
+            CallExpression(path: NodePath<BabelTypes.CallExpression>) {
+                if (!isStencilStyleInsertBeforeCall(path)) return
+
+                path.get('arguments.1').replaceWithSourceString(
+                    `scopeId.startsWith('sc-taro-') ? styleContainerNode.querySelector('style,link[rel="stylesheet"]') : styleContainerNode.querySelector('link')`
+                )
+            }
+        }
+    }
+}
+
+function isStencilStyleInsertBeforeCall(path: NodePath<BabelTypes.CallExpression>): boolean {
+    return (
+        path.get('callee').matchesPattern('styleContainerNode.insertBefore') &&
+        path.get('arguments.0').toString() === 'styleElm' &&
+        path.get('arguments.1').toString() === "styleContainerNode.querySelector('link')"
+    )
+}
+
+/**
+ * Creates compile-time constants expected by Taro's Web runtime packages.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/webpack/H5WebpackPlugin.ts#L51-L69
+ */
+function createH5TaroDefines(): Record<string, string> {
+    return {
+        'process.env.FRAMEWORK': JSON.stringify('react'),
+        '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'
+    }
+}
+
+/**
+ * Injects vite-plugin-taro's generated Web entry into Vite's HTML shell.
+ */
+export function createWebIndexHtmlTags(context: VitePluginTaroBuildContext): HtmlTagDescriptor[] | undefined {
+    if (context.target !== 'h5') return
+
+    const tags: HtmlTagDescriptor[] = []
+    tags.push({
+        tag: 'script',
+        attrs: { type: 'module' },
+        children: `import '${virtualH5Id}'`,
+        injectTo: 'body'
+    })
+    return tags
+}
+
+/**
+ * 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 function createWebEntry(context: VitePluginTaroBuildContext): string {
+    const webAppConfigCode = JSON.stringify(createWebAppConfig(context.appConfig))
+    const webRoutesConfigCode = createWebRoutesConfig(context.pages)
+
+    return `import ${JSON.stringify(nodeRequire.resolve('@tarojs/components/global.css'))}
+import ${JSON.stringify(nodeRequire.resolve('@tarojs/components/dist/taro-components/taro-components.css'))}
+import {
+    createHashHistory,
+    createReactApp,
+    createRouter,
+    handleAppMount,
+    window
+} from 'vite-plugin-taro/shim/h5'
+import React from 'react'
+import ReactDOM from 'react-dom/client'
+import AppComponent from '${context.appComponentImport}'
+
+const config = window.__taroAppConfig = ${webAppConfigCode}
+config.routes = ${webRoutesConfigCode}
+const app = createReactApp(AppComponent, React, ReactDOM, config)
+const history = createHashHistory({ window })
+handleAppMount(config, history)
+createRouter(history, app, config, React)
+`
+}
+
+/**
+ * Creates the H5 app config consumed by Taro's Web router.
+ * Taro's H5 runtime expects `config.router` to exist, even when it is an empty object.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/H5Plugin.ts#L49-L53
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-webpack5-runner/src/plugins/H5Plugin.ts#L133-L138
+ */
+function createWebAppConfig(sharedAppConfig: JsonObject): JsonObject {
+    return {
+        router: {},
+        ...sharedAppConfig
+    }
+}
+
+/**
+ * Creates Web route records in the same shape as Taro's H5 loader.
+ *
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-loader/src/h5.ts#L12-L21
+ * https://github.com/NervJS/taro/blob/f0e5c39d5f04290db975670411e23c3a396e15f8/packages/taro-loader/src/h5.ts#L108-L114
+ */
+function createWebRoutesConfig(webPages: VitePluginTaroPageOption[]): string {
+    const webRoutes = webPages.map((page) =>
+        [
+            'Object.assign({',
+            `  path: ${JSON.stringify(page.path)},`,
+            '  load: async function(context, params) {',
+            `    const page = await import(${JSON.stringify(createPageComponentImport(page.path))})`,
+            '    return [page, context, params]',
+            '  }',
+            `}, ${JSON.stringify(page.config)})`
+        ].join('\n')
+    )
+    return `[\n${webRoutes.join(',\n')}\n]`
+}

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)
+}