vite-plugin-taro 0.5.1 → 0.5.4

package/src/node/plugins/wx/dev/dev-host.ts

@@ -22,7 +22,6 @@ import {
     writeHmrFile
 } from './hmr-files.ts'
 import { PatchPublisher } from './patch-publisher.ts'
-import { publishWxDevStyle } from './publish-wx-dev-style.ts'
 
 export type WxDevHost = Readonly<{
     close: () => Promise<void>
@@ -170,7 +169,6 @@ export async function createWxDevHost({
         }
 
         return dev(rolldownOptions, rolldownOptions.output, {
-            onAdditionalAssets: (output) => publishWxDevStyle(output, server.config.build.outDir),
             onHmrUpdates: async (result) => {
                 if (result instanceof Error) {
                     logWxError(server.config.logger, 'wx HMR update failed', result)
@@ -206,7 +204,6 @@ export async function createWxDevHost({
                     logWxError(server.config.logger, 'wx dev build failed', result)
                     return
                 }
-                await publishWxDevStyle(result, server.config.build.outDir)
                 // A fresh build identity per complete physical build; the App runtime reads it
                 // from hmr/info.js before any module registers.
                 await startFreshBuild()

package/src/node/plugins/wx/placement/placer.ts

@@ -121,8 +121,7 @@ export function createPlacer() {
                     // into every physical chunk filename; content identity alone is sufficient beneath that root.
                     return `${location.root}/assets/[hash].js`
                 },
-                // Keep generic assets independent of stylesheet conventions. The CSS adapter sees Tailwind's final
-                // mutation and owns the exact global `app.wxss` identity without confusing native Page companions.
+                // Keep generic assets independent of native output identities assigned after bundling.
                 assetFileNames: 'assets/[name]-[hash][extname]'
             },
             // Rolldown rejects strict entry signatures when code-splitting groups disable recursive dependency capture.

package/src/node/plugins/wx/plugins.ts

@@ -46,8 +46,11 @@ function createWxPlugin(options: VitePluginTaroOptions): Plugin {
 
                 build: {
                     modulePreload: false,
+                    // Mini Program styles are intentionally global. This guarantees one compiler stylesheet for the CSS
+                    // finalizer; enabling splitting would require Page ownership and must not be silently flattened.
                     cssCodeSplit: false,
-                    // Let weapp-tailwindcss own final WXSS transformation.
+                    // Preserve readable source for the final WX compatibility pass; browser minification can emit syntax
+                    // unsupported by WeChat and would make the subsequent whole-file conversion harder to reason about.
                     cssMinify: false,
 
                     // No base64 assets: Taro warns on image srcs above ~2KB, and inlined
@@ -123,6 +126,12 @@ function createWxPlugin(options: VitePluginTaroOptions): Plugin {
         },
 
         generateBundle: {
+            /*
+             * This hook is registered after createCssPlugins() and shares hook-level `order: 'post'` with the adapted
+             * upstream hooks and VPT style finalizer. Registration order therefore guarantees that app.wxss is complete
+             * before native Page/component companions are emitted. Without this order, the CSS finalizer could consume
+             * incomplete Tailwind output or mistake native WXSS companions for additional compiler styles.
+             */
             order: 'post',
             async handler(_, bundle) {
                 const subpackages = placer.getSubpackages(bundle)

package/src/node/vite-plugin.ts

@@ -11,7 +11,7 @@ import { createWxTargetPlugins } from './plugins/wx/plugins.ts'
 export default function vitePluginTaro(options: VitePluginTaroOptions): PluginOption[] {
     return [
         createConditionalDirectivePlugin(options.target),
-        createClientTaroPlugin(),
+        createClientTaroPlugin(options.target),
         ...createCssPlugins(options.target),
         ...react(),
         ...(options.target === 'wx' ? createWxTargetPlugins(options) : []),

package/src/runtime/client/taro/api.ts

@@ -1,11 +1,11 @@
-import '@tarojs/plugin-framework-react/dist/runtime'
-import { hooks } from '@tarojs/runtime'
-import Taro from '@tarojs/taro'
+/*
+ * This physical module is the shared facade, not the generic Taro implementation. Its own `@tarojs/taro` request is
+ * resolved by the client plugin to the selected platform APIs, while application requests resolve back to this facade.
+ * React's API loader then extends this same object with framework lifecycle hooks.
+ */
+import taro from '@tarojs/taro'
 
-if (hooks.isExist('initNativeApi')) {
-    hooks.call('initNativeApi', Taro)
-}
-
-// @ts-expect-error @tarojs/taro declares export= types, but the facade also exposes its runtime named exports.
+// Re-export platform APIs while preserving object identity for the framework loader's lifecycle assignments.
+// @ts-expect-error @tarojs/taro uses export= types while Rolldown exposes its runtime properties as named exports.
 export * from '@tarojs/taro'
-export default Taro
+export default taro

package/dist/node/plugins/wx/dev/publish-wx-dev-style.d.ts

@@ -1,11 +0,0 @@
-type DevOutputFile = Readonly<{
-    type: string;
-    fileName: string;
-    source?: string | Uint8Array;
-}>;
-type DevOutput = Readonly<{
-    output: readonly DevOutputFile[];
-}>;
-/** Publishes Vite bundled-dev's source-addressed global WXSS at WeChat's required root path. */
-export declare function publishWxDevStyle(output: DevOutput, outDir: string): Promise<void>;
-export {};

package/dist/node/plugins/wx/dev/publish-wx-dev-style.js

@@ -1,12 +0,0 @@
-import { writeFile } from 'node:fs/promises';
-import path from 'node:path';
-import { adaptWxss } from '../../css/plugins.js';
-/** Publishes Vite bundled-dev's source-addressed global WXSS at WeChat's required root path. */
-export async function publishWxDevStyle(output, outDir) {
-    // WX disables CSS splitting, so the only non-empty WXSS asset is the application stylesheet; Page companions are empty.
-    const globalStyle = output.output.find((file) => file.type === 'asset' && file.fileName.endsWith('.wxss') && file.source && file.source.length > 0);
-    if (!globalStyle?.source)
-        return;
-    const source = typeof globalStyle.source === 'string' ? globalStyle.source : new TextDecoder().decode(globalStyle.source);
-    await writeFile(path.join(outDir, 'app.wxss'), await adaptWxss(source));
-}

package/src/node/plugins/wx/dev/publish-wx-dev-style.ts

@@ -1,26 +0,0 @@
-import { writeFile } from 'node:fs/promises'
-import path from 'node:path'
-import { adaptWxss } from '../../css/plugins.ts'
-
-type DevOutputFile = Readonly<{
-    type: string
-    fileName: string
-    source?: string | Uint8Array
-}>
-
-type DevOutput = Readonly<{
-    output: readonly DevOutputFile[]
-}>
-
-/** Publishes Vite bundled-dev's source-addressed global WXSS at WeChat's required root path. */
-export async function publishWxDevStyle(output: DevOutput, outDir: string): Promise<void> {
-    // WX disables CSS splitting, so the only non-empty WXSS asset is the application stylesheet; Page companions are empty.
-    const globalStyle = output.output.find(
-        (file) => file.type === 'asset' && file.fileName.endsWith('.wxss') && file.source && file.source.length > 0
-    )
-    if (!globalStyle?.source) return
-
-    const source =
-        typeof globalStyle.source === 'string' ? globalStyle.source : new TextDecoder().decode(globalStyle.source)
-    await writeFile(path.join(outDir, 'app.wxss'), await adaptWxss(source))
-}