vite-plugin-taro 0.0.2 → 0.0.4

package/dist/vite/targets/h5.js

@@ -0,0 +1,202 @@
+import babel from '@rolldown/plugin-babel';
+import react from '@vitejs/plugin-react';
+import { isProd, nodeRequire } from '../constants.js';
+import { createPageComponentImport } from '../utils.js';
+const virtualH5Id = 'virtual:vite-plugin-taro/h5';
+const patchStencilCssOrder = true;
+/**
+ * Checks whether an id belongs to an H5 virtual module.
+ */
+export function isH5VirtualModuleId(id) {
+    return id === virtualH5Id;
+}
+/**
+ * Loads generated source for H5 virtual modules.
+ */
+export function loadH5VirtualModule(cleanId, context) {
+    if (cleanId !== virtualH5Id)
+        return;
+    return createWebEntry(context);
+}
+/**
+ * Configures the Vite pieces needed for Taro H5 resolve/runtime behavior.
+ */
+export function createH5ViteConfig() {
+    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() {
+    const plugins = [...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() {
+    return {
+        name: 'rewrite-stencil-style-insertion',
+        visitor: {
+            CallExpression(path) {
+                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) {
+    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() {
+    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) {
+    if (context.target !== 'h5')
+        return;
+    const tags = [];
+    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) {
+    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) {
+    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) {
+    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/dist/vite/targets/wx.js

@@ -0,0 +1,364 @@
+import path from 'node:path';
+import { recursiveMerge } from '@tarojs/helper';
+import { Weapp as WechatPlatform } from '@tarojs/plugin-platform-weapp';
+import { isProd, nodeRequire } from '../constants.js';
+import { createPageComponentImport, normalizeModuleId } from '../utils.js';
+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) {
+    return id === virtualWxAppId || id === virtualWxCompId || id.startsWith(virtualWxPagePrefix);
+}
+export function loadWxVirtualModule(cleanId, context) {
+    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) {
+    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() {
+    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) {
+    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) {
+    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) {
+    return normalizeModuleId(id).includes('/node_modules/');
+}
+/**
+ * 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, context, cleanId) {
+    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) {
+    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) {
+    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() {
+    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, bundle, context) {
+    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, context) {
+    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, wechatRootAsset) {
+    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) {
+    const wechatComponentConfig = {
+        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) {
+    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, resolvedId) {
+    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() {
+    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) {
+    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) {
+    const wechatWxssChunks = [];
+    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) {
+    return isProd ? JSON.stringify(value) : JSON.stringify(value, null, 2);
+}

package/dist/vite/types.js

@@ -0,0 +1 @@
+export {};

package/dist/vite/{utils.d.ts → utils.js}

@@ -1,3 +1,4 @@
+import path from 'node:path';
 /**
  * Derives a page component import from a Taro-style page path.
  *
@@ -5,18 +6,26 @@
  * 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;
+export function createPageComponentImport(pagePath) {
+    return toImportPath(`src/${pagePath}.tsx`);
+}
 /**
  * Converts a local file path into an absolute ESM import path for Vite.
  */
-export declare function toImportPath(filePath: string): string;
+export function toImportPath(filePath) {
+    return path.resolve(filePath);
+}
 /**
  * Removes Rollup/Vite's internal virtual-module prefix before ID comparisons.
  */
-export declare function stripVirtualPrefix(id: string): string;
+export function stripVirtualPrefix(id) {
+    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 declare function normalizeModuleId(id: string): string;
+export function normalizeModuleId(id) {
+    return id.replace(/\\/g, '/').replace(/\?.*$/, '');
+}