vite-plugin-taro 0.2.1 → 0.3.0

package/dist/vite/targets/wx.js

@@ -1,364 +0,0 @@
-import path from 'node:path';
-import { recursiveMerge } from '@tarojs/helper';
-import { Weapp as WechatPlatform } from '@tarojs/plugin-platform-weapp';
-import { isProd, nodeRequire, wxShimImportPath } 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')));
-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 ${JSON.stringify(wxShimImportPath)}
-import React from 'react'
-import AppComponent from ${JSON.stringify(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 ${JSON.stringify(wxShimImportPath)}
-import PageComponent from ${JSON.stringify(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 ${JSON.stringify(wxShimImportPath)}
-
-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/virtual-modules.js

@@ -1,13 +0,0 @@
-import path from 'node:path';
-import { nodeRequire } from './constants.js';
-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) {
-    if (id === virtualTaroApiId)
-        return virtualTaroApiResolvedId;
-    if (id === virtualTaroComponentsId)
-        return virtualTaroComponentsResolvedId;
-}

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

@@ -1,80 +0,0 @@
-import { createVitePluginTaroConditionalDirectivePlugin } from './plugins.js';
-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.
- */
-export default function vitePluginTaro(options) {
-    const context = createVitePluginTaroBuildContext(options);
-    return [
-        createVitePluginTaroConditionalDirectivePlugin(context),
-        ...createTargetSupportPlugins(context),
-        ...createTailwindcssPlugins(context),
-        createVitePluginTaroPlugin(context)
-    ];
-}
-function createTargetSupportPlugins(context) {
-    switch (context.target) {
-        case 'h5':
-            return createH5SupportPlugins();
-        default:
-            return [];
-    }
-}
-/**
- * Creates the vite-plugin-taro plugin that emits H5 or Wx outputs.
- */
-function createVitePluginTaroPlugin(context) {
-    return {
-        name: 'vite-plugin-taro',
-        enforce: 'post',
-        /** Configures Vite/Rolldown for the active target. */
-        config: {
-            order: 'pre',
-            handler: () => {
-                return context.target === 'wx' ? createWxViteConfig(context) : createH5ViteConfig();
-            }
-        },
-        /** Maps public virtual modules to real proxy files and marks generated entries as virtual modules. */
-        resolveId(id) {
-            return resolvePublicVirtualModuleId(id) ?? (isWxVirtualModuleId(id) || isH5VirtualModuleId(id) ? `\0${id}` : undefined);
-        },
-        /** 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) {
-    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/shim/h5.ts

@@ -1,6 +0,0 @@
-import '@tarojs/plugin-platform-h5/dist/runtime'
-
-// @ts-expect-error Taro exposes createReactApp from this runtime-only deep entry without types.
-export { createReactApp } from '@tarojs/plugin-framework-react/dist/runtime'
-export { createBrowserHistory, createHashHistory, createRouter, handleAppMount } from '@tarojs/router'
-export { window } from '@tarojs/runtime'

package/src/virtual/components.ts

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

package/src/vite/constants.ts

@@ -1,12 +0,0 @@
-import { createRequire } from 'node:module'
-import path from 'node:path'
-import { toImportPath } from './utils.ts'
-
-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 = toImportPath(path.join(packageRoot, 'dist/shim/h5.js'))
-export const wxShimImportPath = toImportPath(path.join(packageRoot, 'dist/shim/wx.js'))