weapp-tailwindcss 5.1.16 → 5.2.0

package/README.en.md

@@ -9,3 +9,9 @@ This is the core package that brings Tailwind CSS to mini program ecosystems, ha
 For setup guides, configuration references, and framework examples, see the [official weapp-tailwindcss documentation](https://tw.icebreaker.top).
 
 For Tailwind CSS 4 projects, the entry CSS must still be imported by the application. Configure `cssEntries` explicitly with absolute paths resolved from the project root, but do not treat it as a replacement for importing the CSS entry into the build graph.
+
+## Runtime requirements
+
+Starting with `weapp-tailwindcss@5.2.0`, Node.js `>=22.12.0` is required. This is the first Node.js 22 release where loading ESM from CommonJS is enabled by default.
+
+When using `uni-app` or `uni-app x` through HBuilderX, HBuilderX `>=5.11` is also required. Older HBuilderX releases may bundle a Node.js runtime that cannot load the current ESM dependencies.

package/README.md

@@ -9,3 +9,9 @@
 更多接入方式、配置说明和框架示例见 [weapp-tailwindcss 官方文档](https://tw.icebreaker.top)。
 
 Tailwind CSS 4 项目中，入口 CSS 需要同时满足两点：在项目里被实际引入，并通过 `cssEntries` 显式传给插件用于稳定识别。`cssEntries` 应使用项目根目录解析出的绝对路径；它不是替代 import 的开关。
+
+## 运行环境
+
+从 `weapp-tailwindcss@5.2.0` 开始，需要 Node.js `>=22.12.0`。该版本默认支持从 CommonJS 加载 ESM。
+
+通过 HBuilderX 使用 `uni-app` 或 `uni-app x` 时，还需要 HBuilderX `>=5.11`。旧版 HBuilderX 的内置 Node 可能无法加载当前依赖中的 ESM 模块。

package/bin/{weapp-tailwindcss.js → weapp-tailwindcss.cjs}

@@ -2,7 +2,7 @@
 const fs = require('node:fs')
 const path = require('node:path')
 
-const cliPath = path.resolve(__dirname, '../dist/cli.js')
+const cliPath = path.resolve(__dirname, '../dist/cli.cjs')
 if (fs.existsSync(cliPath)) {
   require(cliPath)
 }

package/dist/bundlers/framework-selector.d.ts

@@ -1,5 +1,5 @@
-import type { DetectableAppType, DetectAppTypeOptions } from '../framework';
-import type { AppType, UserDefinedOptions } from '../types';
+import type { DetectableAppType, DetectAppTypeOptions } from '../framework/index.js';
+import type { AppType, UserDefinedOptions } from '../types/index.js';
 export interface ResolveBundlerFrameworkOptions extends Pick<DetectAppTypeOptions, 'cwd' | 'env' | 'manifest' | 'packageJson' | 'root' | 'searchUp'> {
     appType?: AppType | undefined;
     detectEnv?: boolean | undefined;

package/dist/bundlers/gulp/asset-emission-plan.d.ts

@@ -0,0 +1,10 @@
+import type File from 'vinyl';
+import type { AssetEmissionPlan } from '../../compiler/index.js';
+import { Buffer } from 'node:buffer';
+export type GulpAssetSource = string | Buffer;
+export interface ApplyGulpAssetEmissionPlanOptions {
+    deleteAsset: (assetId: string) => void;
+    writeAsset: (assetId: string, contents: Buffer) => void;
+}
+export declare function applyGulpAssetEmissionPlan(plan: AssetEmissionPlan<GulpAssetSource>, options: ApplyGulpAssetEmissionPlanOptions): void;
+export declare function writeGulpFileAsset(file: File, source: GulpAssetSource): void;

package/dist/bundlers/gulp/frameworks/native/index.d.ts

@@ -1,8 +1,15 @@
-import type { UserDefinedOptions } from '../../../../types';
+import type { UserDefinedOptions } from '../../../../types/index.js';
 export declare function createNativeGulpFrameworkPlugins(options?: UserDefinedOptions): {
+    beginCompilerShadowRun: () => number;
+    completeCompilerShadowRun: (revision?: number) => import("../../../../compiler/index.js").CompilerShadowGateResult | undefined;
+    dispose(): Promise<void>;
+    getCompilerShadowRunSnapshot: () => import("../../../../compiler/index.js").CompilerShadowRunSnapshot;
+    watchChange: (id: string, change?: {
+        event: "update" | "delete";
+    }) => Promise<Set<string>>;
     adaptWxss: (options?: Partial<import("@weapp-tailwindcss/postcss").IStyleHandlerOptions>) => import("node:stream").Transform;
     generateWxss: (options?: Partial<import("@weapp-tailwindcss/postcss").IStyleHandlerOptions>) => import("node:stream").Transform;
     transformWxss: (options?: Partial<import("@weapp-tailwindcss/postcss").IStyleHandlerOptions>) => import("node:stream").Transform;
-    transformWxml: (options?: Partial<import("@/types").ITemplateHandlerOptions>) => import("node:stream").Transform;
-    transformJs: (options?: Partial<import("@/types").CreateJsHandlerOptions>) => import("node:stream").Transform;
+    transformWxml: (options?: Partial<import("../../../../types/index.js").ITemplateHandlerOptions>) => import("node:stream").Transform;
+    transformJs: (options?: Partial<import("../../../../types/index.js").CreateJsHandlerOptions>) => import("node:stream").Transform;
 };

package/dist/bundlers/gulp/index.d.ts

@@ -1,8 +1,15 @@
-import type { UserDefinedOptions } from '../../types';
+import type { UserDefinedOptions } from '../../types/index.js';
 export declare function createPlugins(options?: UserDefinedOptions): {
+    beginCompilerShadowRun: () => number;
+    completeCompilerShadowRun: (revision?: number) => import("../../compiler/index.js").CompilerShadowGateResult | undefined;
+    dispose(): Promise<void>;
+    getCompilerShadowRunSnapshot: () => import("../../compiler/index.js").CompilerShadowRunSnapshot;
+    watchChange: (id: string, change?: {
+        event: "update" | "delete";
+    }) => Promise<Set<string>>;
     adaptWxss: (options?: Partial<import("@weapp-tailwindcss/postcss").IStyleHandlerOptions>) => import("node:stream").Transform;
     generateWxss: (options?: Partial<import("@weapp-tailwindcss/postcss").IStyleHandlerOptions>) => import("node:stream").Transform;
     transformWxss: (options?: Partial<import("@weapp-tailwindcss/postcss").IStyleHandlerOptions>) => import("node:stream").Transform;
-    transformWxml: (options?: Partial<import("@/types").ITemplateHandlerOptions>) => import("node:stream").Transform;
-    transformJs: (options?: Partial<import("@/types").CreateJsHandlerOptions>) => import("node:stream").Transform;
+    transformWxml: (options?: Partial<import("../../types/index.js").ITemplateHandlerOptions>) => import("node:stream").Transform;
+    transformJs: (options?: Partial<import("../../types/index.js").CreateJsHandlerOptions>) => import("node:stream").Transform;
 };

package/dist/bundlers/gulp/module-graph.d.ts

@@ -1,2 +1,2 @@
-import type { JsModuleGraphOptions, UserDefinedOptions } from '../../types';
+import type { JsModuleGraphOptions, UserDefinedOptions } from '../../types/index.js';
 export declare function createGulpModuleGraphOptions(opts: UserDefinedOptions): JsModuleGraphOptions;

package/dist/bundlers/gulp/runtime-snapshot.d.ts

@@ -1,5 +1,7 @@
-import type { BundleSnapshot } from '../vite/bundle-state';
+import type { RuntimeCompilationBuildState, RuntimeCompilationSnapshot } from '../../compiler/index.js';
 export declare function createGulpRuntimeSnapshot(runtimeSourcesByFile: Map<string, {
     source: string;
     type: 'html' | 'js';
-}>, changedFiles: Iterable<string>): BundleSnapshot;
+}>, state: RuntimeCompilationBuildState, computeHash: (source: string) => string, options?: {
+    removedFiles?: Iterable<string> | undefined;
+}): RuntimeCompilationSnapshot;

package/dist/bundlers/gulp/shared/create-native-framework-plugins/cache-state.d.ts

@@ -1,10 +1,10 @@
-import type { getCompilerContext } from '../../../../context';
-import type { IStyleHandlerOptions } from '../../../../types';
+import type { getCompilerContext } from '../../../../context/index.js';
+import type { IStyleHandlerOptions } from '../../../../types/index.js';
 export declare function touchMapEntry<Key, Value>(map: Map<Key, Value>, key: Key, value: Value): void;
-export declare function pruneGulpRuntimeSourceCaches(sourceHashByFile: Map<string, string>, sourcesByFile: Map<string, {
+export declare function pruneGulpRuntimeSourceCaches(sourcesByFile: Map<string, {
     source: string;
     type: 'html' | 'js';
-}>): void;
+}>): string[];
 export declare function rememberGulpProcessCacheKey(cacheKeys: Set<string>, key: string): void;
 export declare function pruneGulpProcessCache(cache: ReturnType<typeof getCompilerContext>['cache'], cacheKeys: Set<string>): void;
 export declare function resolveGulpMemoryDebugStats(context: {

package/dist/bundlers/gulp/shared/create-native-framework-plugins/file-transforms.d.ts

@@ -1,7 +1,7 @@
 import type File from 'vinyl';
-import type { getCompilerContext } from '../../../../context';
-import type { TailwindRuntimeState } from '../../../../tailwindcss/runtime';
-import type { CreateJsHandlerOptions, IStyleHandlerOptions, ITemplateHandlerOptions, JsModuleGraphOptions } from '../../../../types';
+import type { getCompilerContext } from '../../../../context/index.js';
+import type { TailwindRuntimeState } from '../../../../tailwindcss/runtime.js';
+import type { CreateJsHandlerOptions, IStyleHandlerOptions, ITemplateHandlerOptions, JsModuleGraphOptions } from '../../../../types/index.js';
 type DebugFunction = (formatter: unknown, ...args: unknown[]) => void;
 type RuntimeRefreshOptions = boolean | {
     forceRefresh?: boolean;
@@ -16,6 +16,7 @@ export interface GulpFileTransformContext {
         inject: boolean;
         preserve: boolean;
     }>;
+    getCompilationDependencyRevision: (scopeId: string) => number;
     getSourceCandidateGetter: () => ((entries?: unknown) => Set<string>) | undefined;
     getSourceCandidateSourceGetter: () => ((entries?: unknown) => Map<string, Set<string>>) | undefined;
     getRuntimeSet: () => Set<string>;
@@ -25,6 +26,7 @@ export interface GulpFileTransformContext {
     refreshRuntimeSet: (options?: RuntimeRefreshOptions) => Promise<Set<string>>;
     refreshRuntimeSetForSource: (file: File, rawSource: string, type: 'html' | 'js') => Promise<Set<string>>;
     registerAutoCssSource: (file: File, rawSource: string) => Promise<boolean>;
+    rememberCompilationScope: (sourceFile: string, scopeId: string) => void;
     resolveGulpStyleOutputExtension: (file: File) => string | undefined;
     resolveGulpTransformTimingDetails: (phase: string) => unknown;
     resolveModuleGraphOptions: (moduleGraph?: JsModuleGraphOptions) => JsModuleGraphOptions;

package/dist/bundlers/gulp/shared/create-native-framework-plugins.d.ts

@@ -1,8 +1,15 @@
-import type { IStyleHandlerOptions, ITemplateHandlerOptions, UserDefinedOptions } from '../../../types';
+import type { IStyleHandlerOptions, ITemplateHandlerOptions, UserDefinedOptions } from '../../../types/index.js';
 export declare function createNativeGulpPlugins(options?: UserDefinedOptions): {
+    beginCompilerShadowRun: () => number;
+    completeCompilerShadowRun: (revision?: number) => import("../../../compiler/index.js").CompilerShadowGateResult | undefined;
+    dispose(): Promise<void>;
+    getCompilerShadowRunSnapshot: () => import("../../../compiler/index.js").CompilerShadowRunSnapshot;
+    watchChange: (id: string, change?: {
+        event: "update" | "delete";
+    }) => Promise<Set<string>>;
     adaptWxss: (options?: Partial<IStyleHandlerOptions>) => import("node:stream").Transform;
     generateWxss: (options?: Partial<IStyleHandlerOptions>) => import("node:stream").Transform;
     transformWxss: (options?: Partial<IStyleHandlerOptions>) => import("node:stream").Transform;
     transformWxml: (options?: Partial<ITemplateHandlerOptions>) => import("node:stream").Transform;
-    transformJs: (options?: Partial<import("@/types").CreateJsHandlerOptions>) => import("node:stream").Transform;
+    transformJs: (options?: Partial<import("../../../types/index.js").CreateJsHandlerOptions>) => import("node:stream").Transform;
 };

package/dist/bundlers/rspack/index.d.ts

@@ -1,5 +1,5 @@
-import type { WebpackCssImportRewriteLoaderOptions } from '../webpack/loaders/runtime-registry';
-import { WeappTailwindcss, weappTailwindcssPackageDir } from '../webpack';
+import type { WebpackCssImportRewriteLoaderOptions } from '../webpack/loaders/runtime-registry.js';
+import { WeappTailwindcss, weappTailwindcssPackageDir } from '../webpack/index.js';
 export { WeappTailwindcss, weappTailwindcss, weappTailwindcssPackageDir };
 declare const weappTailwindcss: typeof WeappTailwindcss;
 export interface PatchRspackCssImportRewriteLoaderOptions {

package/dist/bundlers/shared/cache.d.ts

@@ -1,4 +1,4 @@
-import type { CacheValue, HashMapKey, ICreateCacheReturnType } from '../../cache';
+import type { CacheValue, HashMapKey, ICreateCacheReturnType } from '../../cache/index.js';
 export interface ProcessCachedTaskOptions<TValue extends CacheValue> {
     cache: ICreateCacheReturnType;
     cacheKey: string;

package/dist/bundlers/shared/css-imports.d.ts

@@ -1,4 +1,4 @@
-import type { AppType } from '../../types';
+import type { AppType } from '../../types/index.js';
 export interface ResolveTailwindcssImportOptions {
     join?: ((base: string, subpath: string) => string) | undefined;
     appType?: AppType | undefined;

package/dist/bundlers/shared/css-source-trace.d.ts

@@ -1,5 +1,5 @@
-import type { TailwindSourceEntry } from '../../tailwindcss/source-scan';
-import type { InternalUserDefinedOptions } from '../../types';
+import type { TailwindSourceEntry } from '../../tailwindcss/source-scan.js';
+import type { InternalUserDefinedOptions } from '../../types/index.js';
 export interface CssTokenSource {
     token: string;
     sources: string[];

package/dist/bundlers/shared/framework-postcss.d.ts

@@ -1,6 +1,6 @@
 import type { IStyleHandlerOptions, LoadedPostcssOptions } from '@weapp-tailwindcss/postcss/types';
-import type { GenerateCssByGeneratorResult } from './generator-css';
-import type { InternalUserDefinedOptions } from '../../types';
+import type { GenerateCssByGeneratorResult } from './generator-css.js';
+import type { InternalUserDefinedOptions } from '../../types/index.js';
 export declare function resolveFrameworkPostcssOptions(value: unknown): LoadedPostcssOptions | undefined;
 export declare function collectFrameworkPostcssOptionsFromLoaderEntries(entries: unknown[], loaderContext?: unknown): LoadedPostcssOptions | undefined;
 export declare function captureFrameworkPostcssOptions(owner: InternalUserDefinedOptions, options: unknown): LoadedPostcssOptions | undefined;
@@ -12,3 +12,10 @@ export declare function adaptGeneratedCssWithFrameworkPipeline(owner: InternalUs
     majorVersion: number;
     styleHandler: InternalUserDefinedOptions['styleHandler'];
 }): Promise<string>;
+export declare function adaptGeneratedCssWithFrameworkRootPipeline(owner: InternalUserDefinedOptions, generated: GenerateCssByGeneratorResult, options: {
+    cssHandlerOptions: IStyleHandlerOptions;
+    file: string;
+    majorVersion: number;
+    rawCandidates: Iterable<string>;
+    styleHandler: InternalUserDefinedOptions['styleHandler'];
+}): Promise<string>;

package/dist/bundlers/shared/generator-css/candidates.d.ts

@@ -0,0 +1,2 @@
+export declare function collectCssApplyCandidates(css: string): string[];
+export declare function collectGeneratorCssCandidates(css: string): string[];

package/dist/bundlers/shared/generator-css/generation-helpers/preflight.d.ts

@@ -1,9 +1,10 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { InternalUserDefinedOptions } from '../../../../types';
+import type { InternalUserDefinedOptions } from '../../../../types/index.js';
 export declare function hasMiniProgramTailwindV4PreflightReset(css: string): boolean;
 export declare function finalizeMiniProgramGeneratorCss(css: string, target: string, _majorVersion: number | undefined, cssPreflight: InternalUserDefinedOptions['cssPreflight'], options?: {
-    injectPreflight?: boolean;
-    preservePreflight?: boolean;
+    injectPreflight?: boolean | undefined;
+    preservePreflight?: boolean | undefined;
+    removeEmptyAtRuleAncestors?: boolean | undefined;
     styleOptions?: Partial<IStyleHandlerOptions> | undefined;
 }): string;
 export declare function resolveMiniProgramPreflightModeForGeneratorCss(opts: InternalUserDefinedOptions, options: {

package/dist/bundlers/shared/generator-css/generation-helpers/results.d.ts

@@ -1,5 +1,5 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { createWeappTailwindcssGenerator } from '../../../../generator';
+import type { createWeappTailwindcssGenerator } from '../../../../generator/index.js';
 export declare function shouldFinalizeMarkedUserLayerComponentsCss(file: string): boolean;
 export declare function splitRawSourceByGeneratedCssOrder(rawSource: string, rawTailwindCss: string): {
     before: string;
@@ -17,8 +17,8 @@ export declare function shouldUseGeneratorForCurrentCss(_majorVersion: number |
 }): boolean | undefined;
 export declare function hasGeneratorSourceDirectives(source: string, importFallback: boolean): boolean;
 export declare function createRuntimeWithCurrentCssCandidates(runtime: Set<string>, currentCssCandidates: string[], isolateCurrentCssCandidates: boolean): Set<string>;
-export declare function mergeGeneratorResults(generatedResults: GeneratorResult[]): (import("@/generator").TailwindV4GenerateResult & {
-    target: import("@/generator").WeappTailwindcssGeneratorTarget;
+export declare function mergeGeneratorResults(generatedResults: GeneratorResult[]): (import("../../../../generator/index.js").TailwindV4GenerateResult & {
+    target: import("../../../../generator/index.js").WeappTailwindcssGeneratorTarget;
     rawCss: string;
 }) | undefined;
 type GeneratorResult = Awaited<ReturnType<ReturnType<typeof createWeappTailwindcssGenerator>['generate']>>;

package/dist/bundlers/shared/generator-css/generation-helpers/runtime-isolation.d.ts

@@ -1,7 +1,7 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { GeneratorResolvedSource } from '../source-resolver';
-import type { TailwindSourceEntry } from '../../../../tailwindcss/source-scan';
-import type { InternalUserDefinedOptions } from '../../../../types';
+import type { GeneratorSourceRecord } from '../source-resolver.js';
+import type { TailwindSourceEntry } from '../../../../tailwindcss/source-scan.js';
+import type { InternalUserDefinedOptions } from '../../../../types/index.js';
 export declare function mergeScopedRuntimeWithCurrentRuntime(scopedRuntime: Set<string>, runtime: Set<string>, options: {
     currentCssCandidates?: string[] | undefined;
     cssHandlerOptions: IStyleHandlerOptions;
@@ -9,7 +9,7 @@ export declare function mergeScopedRuntimeWithCurrentRuntime(scopedRuntime: Set<
     majorVersion?: number | undefined;
     matchedCssSourceFile: boolean;
 }): Set<string>;
-export declare function shouldIsolateScopedCssSource(_majorVersion: number | undefined, source: GeneratorResolvedSource, sourceEntries: TailwindSourceEntry[] | undefined, options: {
+export declare function shouldIsolateScopedCssSource(_majorVersion: number | undefined, record: GeneratorSourceRecord, sourceEntries: TailwindSourceEntry[] | undefined, options: {
     cssHandlerOptions?: IStyleHandlerOptions | undefined;
     target: string;
 }): boolean;

package/dist/bundlers/shared/generator-css/generation-helpers.d.ts

@@ -1,4 +1,4 @@
-export { finalizeMiniProgramGeneratorCss, hasMiniProgramTailwindV4PreflightReset, resolveMiniProgramPreflightModeForGeneratorCss } from './generation-helpers/preflight';
-export { createRuntimeWithCurrentCssCandidates, hasGeneratorSourceDirectives, mergeGeneratorResults, shouldFinalizeMarkedUserLayerComponentsCss, shouldUseGeneratorForCurrentCss, splitRawSourceByGeneratedCssOrder } from './generation-helpers/results';
-export { isEmptyCssSourceOrderParts, mergeScopedRuntimeWithCurrentRuntime, resolveGeneratorStyleOptions, shouldAppendWebBundleCssFallback, shouldIsolateCurrentTailwindV4CssCandidates, shouldIsolateScopedCssSource, shouldScanTailwindV4Sources } from './generation-helpers/runtime-isolation';
-export { createCssSourceOrderAppend, deduplicateGeneratedCssRules } from './generation-helpers/source-order';
+export { finalizeMiniProgramGeneratorCss, hasMiniProgramTailwindV4PreflightReset, resolveMiniProgramPreflightModeForGeneratorCss } from './generation-helpers/preflight.js';
+export { createRuntimeWithCurrentCssCandidates, hasGeneratorSourceDirectives, mergeGeneratorResults, shouldFinalizeMarkedUserLayerComponentsCss, shouldUseGeneratorForCurrentCss, splitRawSourceByGeneratedCssOrder } from './generation-helpers/results.js';
+export { isEmptyCssSourceOrderParts, mergeScopedRuntimeWithCurrentRuntime, resolveGeneratorStyleOptions, shouldAppendWebBundleCssFallback, shouldIsolateCurrentTailwindV4CssCandidates, shouldIsolateScopedCssSource, shouldScanTailwindV4Sources } from './generation-helpers/runtime-isolation.js';
+export { createCssSourceOrderAppend, deduplicateGeneratedCssRules } from './generation-helpers/source-order.js';

package/dist/bundlers/shared/generator-css/legacy-compat.d.ts

@@ -1,6 +1,6 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { TailwindResolvedSource } from '../../../generator';
-import type { InternalUserDefinedOptions } from '../../../types';
+import type { TailwindResolvedSource } from '../../../generator/index.js';
+import type { InternalUserDefinedOptions } from '../../../types/index.js';
 export declare function removeTailwindApplyRules(rawSource: string): string;
 export declare function hasConfiguredContainerCompatSources(sources: TailwindResolvedSource[]): boolean;
 export declare function appendLegacyCompatCss(css: string, rawSource: string, generatorTarget: string, styleHandler: InternalUserDefinedOptions['styleHandler'], cssHandlerOptions: IStyleHandlerOptions, generatorStyleOptions: Partial<IStyleHandlerOptions> | undefined, options?: {

package/dist/bundlers/shared/generator-css/pipeline/context.d.ts

@@ -0,0 +1,58 @@
+import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
+import type { TailwindV4CssSource } from '../source-resolver/types.js';
+import type { GenerateCssByGeneratorOptions } from '../types.js';
+import type { NormalizedWeappTailwindcssGeneratorOptions, TailwindResolvedSource, WeappTailwindcssGenerateResult } from '../../../../generator/index.js';
+import type { RuntimeBranch } from '../../../../runtime-branch.js';
+export interface GeneratorPipelineExecutionContext {
+    cssHandlerOptions: GenerateCssByGeneratorOptions['cssHandlerOptions'];
+    cssUserHandlerOptions: GenerateCssByGeneratorOptions['cssUserHandlerOptions'];
+    debug: GenerateCssByGeneratorOptions['debug'];
+    file: string;
+    finalizeGeneratorCss: (css: string, target: string, options?: {
+        injectPreflight?: boolean | undefined;
+        preservePreflight?: boolean | undefined;
+        removeEmptyAtRuleAncestors?: boolean | undefined;
+        styleOptions?: Partial<IStyleHandlerOptions> | undefined;
+    }) => string;
+    generatedUserCssRawSource: string;
+    generatorBranch: RuntimeBranch;
+    generatorOptions: NormalizedWeappTailwindcssGeneratorOptions;
+    generatorRawSource: string;
+    getSourceCandidatesForEntries: GenerateCssByGeneratorOptions['getSourceCandidatesForEntries'];
+    hasDistinctUserRawSource: boolean;
+    hasGeneratedCss: boolean;
+    hasGeneratedMarkers: boolean;
+    hasSourceDirectives: boolean;
+    hasWebUserCssFallbackSource: boolean;
+    legacyCompatUserCssRawSource: string;
+    localImports: string | undefined;
+    majorVersion: number;
+    normalizeGeneratorSource: (source: TailwindResolvedSource) => TailwindResolvedSource;
+    normalizedCssSources: TailwindV4CssSource[] | undefined;
+    options: GenerateCssByGeneratorOptions;
+    opts: GenerateCssByGeneratorOptions['opts'];
+    prepareFinalGeneratorCss: (css: string) => string;
+    runtime: Set<string>;
+    runtimeState: GenerateCssByGeneratorOptions['runtimeState'];
+    shouldPreserveLegacyCompatSelectorOverrides: boolean;
+    styleHandler: GenerateCssByGeneratorOptions['styleHandler'];
+    userCssOrderSource: string;
+    userCssRawSource: string;
+    userRawSourceProcessed: boolean | undefined;
+    useMiniProgramCssBranch: boolean;
+}
+export interface GeneratorPipelineOutputContext extends GeneratorPipelineExecutionContext {
+    configuredContainerCompat: boolean;
+    filterGeneratedApplyOnlyCss: (css: string) => string;
+    generated: WeappTailwindcssGenerateResult;
+    generatedCss: string;
+    generatorStyleOptions: Partial<IStyleHandlerOptions>;
+    hasMatchedCssSourceFile: boolean;
+    isolateCurrentCssCandidates: boolean;
+    preflightMode: {
+        inject: boolean;
+        preserve: boolean;
+    };
+    runtimeWithCurrentCss: Set<string>;
+    shouldFilterApplyOnlyCss: boolean;
+}

package/dist/bundlers/shared/generator-css/pipeline/deferred-output.d.ts

@@ -1,14 +1,3 @@
-export declare function finalizeDeferredGeneratorCss(context: any): Promise<{
-    css: string;
-    classSet: Set<string>;
-    target: any;
-    source: string;
-    dependencies: any;
-    incremental: boolean;
-    metadata: {
-        file: any;
-        majorVersion: any;
-        preflightMode: any;
-        rawCss: any;
-    };
-} | undefined>;
+import type { GenerateCssByGeneratorResult } from '../types.js';
+import type { GeneratorPipelineOutputContext } from './context.js';
+export declare function finalizeDeferredGeneratorCss(context: GeneratorPipelineOutputContext): Promise<GenerateCssByGeneratorResult | undefined>;

package/dist/bundlers/shared/generator-css/pipeline/execution.d.ts

@@ -1,12 +1,3 @@
-export declare function executeGeneratorPipeline(context: any): Promise<{
-    css: any;
-    classSet: Set<string>;
-    target: any;
-    source: string;
-    dependencies: any;
-    metadata: {
-        file: any;
-        majorVersion: any;
-        rawCss: any;
-    };
-} | undefined>;
+import type { GenerateCssByGeneratorResult } from '../types.js';
+import type { GeneratorPipelineExecutionContext } from './context.js';
+export declare function executeGeneratorPipeline(context: GeneratorPipelineExecutionContext): Promise<GenerateCssByGeneratorResult | undefined>;

package/dist/bundlers/shared/generator-css/pipeline/fallback-output.d.ts

@@ -1,12 +1,3 @@
-export declare function finalizeFallbackGeneratorCss(context: any): Promise<{
-    css: any;
-    classSet: Set<string>;
-    target: any;
-    source: string;
-    dependencies: any;
-    metadata: {
-        file: any;
-        majorVersion: any;
-        rawCss: any;
-    };
-}>;
+import type { GenerateCssByGeneratorResult } from '../types.js';
+import type { GeneratorPipelineOutputContext } from './context.js';
+export declare function finalizeFallbackGeneratorCss(context: GeneratorPipelineOutputContext): Promise<GenerateCssByGeneratorResult>;

package/dist/bundlers/shared/generator-css/pipeline/ordered-output.d.ts

@@ -1,25 +1,3 @@
-export declare function finalizeOrderedGeneratorCss(context: any): Promise<{
-    css: string;
-    classSet: Set<string>;
-    target: any;
-    source: string;
-    dependencies: any;
-    incremental: boolean;
-    metadata: {
-        file: any;
-        majorVersion: any;
-        rawCss: any;
-    };
-} | {
-    css: any;
-    classSet: Set<string>;
-    target: any;
-    source: string;
-    dependencies: any;
-    metadata: {
-        file: any;
-        majorVersion: any;
-        rawCss: any;
-    };
-    incremental?: never;
-} | undefined>;
+import type { GenerateCssByGeneratorResult } from '../types.js';
+import type { GeneratorPipelineOutputContext } from './context.js';
+export declare function finalizeOrderedGeneratorCss(context: GeneratorPipelineOutputContext): Promise<GenerateCssByGeneratorResult | undefined>;

package/dist/bundlers/shared/generator-css/pipeline.d.ts

@@ -1,2 +1,2 @@
-import type { GenerateCssByGeneratorOptions, GenerateCssByGeneratorResult } from './types';
+import type { GenerateCssByGeneratorOptions, GenerateCssByGeneratorResult } from './types.js';
 export declare function generateCssByGenerator(options: GenerateCssByGeneratorOptions): Promise<GenerateCssByGeneratorResult | undefined>;

package/dist/bundlers/shared/generator-css/result-helpers.d.ts

@@ -1,5 +1,5 @@
-import type { normalizeWeappTailwindcssGeneratorOptions } from '../../../generator';
-import { finalizeMiniProgramGeneratorCss } from './generation-helpers';
+import type { normalizeWeappTailwindcssGeneratorOptions } from '../../../generator/index.js';
+import { finalizeMiniProgramGeneratorCss } from './generation-helpers.js';
 export declare function isCssAlreadyRepresentedByMarkers(css: string, source: string): boolean;
 export declare function resolveGeneratedCssClassSet(target: string, classSet: Set<string>, candidates: Iterable<string>, css: string, escapeMap: Record<string, string> | undefined, previousClassSet?: Set<string> | undefined): Set<string>;
 export declare function finalizeWebGeneratorCss(css: string, target: string, webCompat: ReturnType<typeof normalizeWeappTailwindcssGeneratorOptions>['webCompat']): string;

package/dist/bundlers/shared/generator-css/source-resolver/configuration.d.ts

@@ -1,7 +1,6 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { GeneratorResolvedSource } from './metadata';
-import type { GeneratorSourceRuntimeState, SourceStyleMatchOptions, TailwindV4CssSource, TailwindV4SourceOptions } from './types';
-import type { TailwindResolvedSource } from '../../../../generator';
+import type { GeneratorSourceRuntimeState, SourceStyleMatchOptions, TailwindV4CssSource, TailwindV4SourceOptions } from './types.js';
+import type { TailwindResolvedSource } from '../../../../generator/index.js';
 export declare function createCssEntrySources(cssEntries: string[] | undefined): {
     file: string;
 }[] | undefined;
@@ -22,7 +21,7 @@ export declare function resolveTailwindV4CssEntrySource(cssEntry: string, source
     candidateMatched?: boolean | undefined;
     includesPreflight?: boolean | undefined;
     index?: number | undefined;
-}): Promise<GeneratorResolvedSource>;
+}): Promise<import("./metadata.js").GeneratorResolvedSource>;
 export declare function canResolveSourceSideCssEntry(file: string, cssHandlerOptions: IStyleHandlerOptions, sourceOptions?: Pick<SourceStyleMatchOptions, 'sourceFile' | 'cssSources' | 'outputRoot'>): boolean;
 export declare function shouldResolveSourceSideCssEntry(rawSource: string): boolean;
 export declare function normalizeTailwindV4CssSourceConfig(cssSource: TailwindV4CssSource, sourceBase: string): import("@tailwindcss-mangle/engine").TailwindV4CssSource;

package/dist/bundlers/shared/generator-css/source-resolver/matching.d.ts

@@ -1,3 +1,3 @@
-import type { SourceStyleMatchOptions } from './types';
+import type { SourceStyleMatchOptions } from './types.js';
 export declare function normalizeCssSourceForCompare(css: string): string;
 export declare function scoreTailwindV4CssSourceFileMatch(file: string, cssSourceFile: string, sourceOptions: SourceStyleMatchOptions): number;

package/dist/bundlers/shared/generator-css/source-resolver/metadata.d.ts

@@ -1,6 +1,6 @@
-import type { SourceSideCssEntrySource } from '../source-files';
-import type { TailwindResolvedSource } from '../../../../generator';
-import type { TailwindSourceEntry } from '../../../../tailwindcss/source-scan';
+import type { SourceSideCssEntrySource } from '../source-files.js';
+import type { TailwindResolvedSource } from '../../../../generator/index.js';
+import type { TailwindSourceEntry } from '../../../../tailwindcss/source-scan.js';
 export interface GeneratorSourceMetadata {
     candidateMatchedCssSource?: boolean | undefined;
     cssEntryIndex?: number | undefined;
@@ -13,8 +13,16 @@ export interface GeneratorSourceMetadata {
     sourceBase?: string | undefined;
     sourceCss?: string | undefined;
 }
+declare const generatorSourceMetadataKey: unique symbol;
 export type GeneratorResolvedSource = TailwindResolvedSource & {
-    __weappTailwindcssMeta?: GeneratorSourceMetadata | undefined;
+    [generatorSourceMetadataKey]?: GeneratorSourceMetadata | undefined;
 };
+export interface GeneratorSourceRecord {
+    source: TailwindResolvedSource;
+    metadata: GeneratorSourceMetadata;
+}
+export declare function getGeneratorSourceMetadata(source: TailwindResolvedSource): GeneratorSourceMetadata | undefined;
 export declare function withGeneratorSourceMetadata(source: TailwindResolvedSource, metadata: GeneratorSourceMetadata): GeneratorResolvedSource;
-export declare function withMatchedSourceSideMetadata(source: TailwindResolvedSource, resolvedEntrySource: SourceSideCssEntrySource, metadata?: GeneratorSourceMetadata): import("@/generator").TailwindV4ResolvedSource;
+export declare function createGeneratorSourceRecord(source: TailwindResolvedSource): GeneratorSourceRecord;
+export declare function withMatchedSourceSideMetadata(source: TailwindResolvedSource, resolvedEntrySource: SourceSideCssEntrySource, metadata?: GeneratorSourceMetadata): import("../../../../generator/index.js").TailwindV4ResolvedSource;
+export {};

package/dist/bundlers/shared/generator-css/source-resolver/postcss-source.d.ts

@@ -1,5 +1,5 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { TailwindV4CssSource } from './types';
+import type { TailwindV4CssSource } from './types.js';
 export declare function resolvePostcssFromOption(cssHandlerOptions: IStyleHandlerOptions): string | undefined;
 export declare function resolvePostcssRequestOption(cssHandlerOptions: IStyleHandlerOptions): string | undefined;
 export declare function resolvePostcssSourceFile(cssHandlerOptions: IStyleHandlerOptions): string | undefined;

package/dist/bundlers/shared/generator-css/source-resolver/resolve-source.d.ts

@@ -1,4 +1,4 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { GeneratorSourceRuntimeState, GeneratorSourceSelectionOptions } from './types';
-import type { NormalizedWeappTailwindcssGeneratorOptions } from '../../../../generator';
-export declare function resolveGeneratorSource(_majorVersion: number | undefined, runtimeState: GeneratorSourceRuntimeState, rawSource: string, file: string, cssHandlerOptions: IStyleHandlerOptions, generatorOptions?: NormalizedWeappTailwindcssGeneratorOptions, selectionOptions?: GeneratorSourceSelectionOptions): Promise<import("@/generator").TailwindV4ResolvedSource>;
+import type { GeneratorSourceRuntimeState, GeneratorSourceSelectionOptions } from './types.js';
+import type { NormalizedWeappTailwindcssGeneratorOptions } from '../../../../generator/index.js';
+export declare function resolveGeneratorSource(_majorVersion: number | undefined, runtimeState: GeneratorSourceRuntimeState, rawSource: string, file: string, cssHandlerOptions: IStyleHandlerOptions, generatorOptions?: NormalizedWeappTailwindcssGeneratorOptions, selectionOptions?: GeneratorSourceSelectionOptions): Promise<import("../../../../generator/index.js").TailwindV4ResolvedSource>;

package/dist/bundlers/shared/generator-css/source-resolver/resolve-sources.d.ts

@@ -1,4 +1,5 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { GeneratorSourceRuntimeState, GeneratorSourceSelectionOptions } from './types';
-import type { NormalizedWeappTailwindcssGeneratorOptions, TailwindResolvedSource } from '../../../../generator';
-export declare function resolveGeneratorSources(majorVersion: number | undefined, runtimeState: GeneratorSourceRuntimeState, rawSource: string, file: string, cssHandlerOptions: IStyleHandlerOptions, generatorOptions?: NormalizedWeappTailwindcssGeneratorOptions, selectionOptions?: GeneratorSourceSelectionOptions): Promise<TailwindResolvedSource[]>;
+import type { GeneratorSourceRecord } from './metadata.js';
+import type { GeneratorSourceRuntimeState, GeneratorSourceSelectionOptions } from './types.js';
+import type { NormalizedWeappTailwindcssGeneratorOptions } from '../../../../generator/index.js';
+export declare function resolveGeneratorSources(majorVersion: number | undefined, runtimeState: GeneratorSourceRuntimeState, rawSource: string, file: string, cssHandlerOptions: IStyleHandlerOptions, generatorOptions?: NormalizedWeappTailwindcssGeneratorOptions, selectionOptions?: GeneratorSourceSelectionOptions): Promise<GeneratorSourceRecord[]>;

package/dist/bundlers/shared/generator-css/source-resolver/single-source.d.ts

@@ -1,16 +1,16 @@
 import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { resolveSourceSideCssEntrySource } from '../source-files';
-import type { GeneratorSourceSelectionOptions, TailwindV4CssSource, TailwindV4SourceOptions } from './types';
-import type { NormalizedWeappTailwindcssGeneratorOptions, resolveTailwindV4SourceOptionsFromRuntime } from '../../../../generator';
+import type { resolveSourceSideCssEntrySource } from '../source-files.js';
+import type { GeneratorSourceSelectionOptions, TailwindV4CssSource, TailwindV4SourceOptions } from './types.js';
+import type { NormalizedWeappTailwindcssGeneratorOptions, resolveTailwindV4SourceOptionsFromRuntime } from '../../../../generator/index.js';
 export declare function resolveSingleTailwindV4CssSource(cssSource: TailwindV4CssSource, sourceOptions: TailwindV4SourceOptions, options?: {
     includesPreflight?: boolean | undefined;
     index?: number | undefined;
     matched?: boolean;
     primary?: boolean | undefined;
-}): Promise<import("./metadata").GeneratorResolvedSource>;
-export declare function resolveTailwindV4CssSourceEntries(cssSource: TailwindV4CssSource, sourceOptions: TailwindV4SourceOptions): Promise<import("@/bundlers/vite/source-scan").ResolvedTailwindV4CssEntries | undefined>;
-export declare function resolveCandidateMatchedTailwindV4CssSource(_rawSource: string, _cssHandlerOptions: IStyleHandlerOptions, sourceOptions: TailwindV4SourceOptions, selectionOptions: GeneratorSourceSelectionOptions | undefined): Promise<import("./metadata").GeneratorResolvedSource | undefined>;
+}): Promise<import("./metadata.js").GeneratorResolvedSource>;
+export declare function resolveTailwindV4CssSourceEntries(cssSource: TailwindV4CssSource, sourceOptions: TailwindV4SourceOptions): Promise<import("../../source-scan.js").ResolvedTailwindV4CssEntries | undefined>;
+export declare function resolveCandidateMatchedTailwindV4CssSource(_rawSource: string, _cssHandlerOptions: IStyleHandlerOptions, sourceOptions: TailwindV4SourceOptions, selectionOptions: GeneratorSourceSelectionOptions | undefined): Promise<import("./metadata.js").GeneratorResolvedSource | undefined>;
 export declare function resolveTailwindV4CssEntryIncludesPreflight(cssEntry: string): Promise<boolean | undefined>;
-export declare function resolveCandidateMatchedTailwindV4CssEntry(sourceOptions: TailwindV4SourceOptions, selectionOptions: GeneratorSourceSelectionOptions | undefined): Promise<import("./metadata").GeneratorResolvedSource | undefined>;
-export declare function createTailwindV4CssSourceResolver(sourceOptions: TailwindV4SourceOptions, generatorOptions: NormalizedWeappTailwindcssGeneratorOptions | undefined): (cssSource: NonNullable<typeof sourceOptions.cssSources>[number], index: number) => Promise<import("./metadata").GeneratorResolvedSource>;
-export declare function resolveTailwindV4SourceSideEntrySource(resolvedEntrySource: ReturnType<typeof resolveSourceSideCssEntrySource>, sourceOptions: ReturnType<typeof resolveTailwindV4SourceOptionsFromRuntime>, generatorOptions: NormalizedWeappTailwindcssGeneratorOptions | undefined, file: string): Promise<import("@/generator").TailwindV4ResolvedSource | undefined>;
+export declare function resolveCandidateMatchedTailwindV4CssEntry(sourceOptions: TailwindV4SourceOptions, selectionOptions: GeneratorSourceSelectionOptions | undefined): Promise<import("./metadata.js").GeneratorResolvedSource | undefined>;
+export declare function createTailwindV4CssSourceResolver(sourceOptions: TailwindV4SourceOptions, generatorOptions: NormalizedWeappTailwindcssGeneratorOptions | undefined): (cssSource: NonNullable<typeof sourceOptions.cssSources>[number], index: number) => Promise<import("./metadata.js").GeneratorResolvedSource>;
+export declare function resolveTailwindV4SourceSideEntrySource(resolvedEntrySource: ReturnType<typeof resolveSourceSideCssEntrySource>, sourceOptions: ReturnType<typeof resolveTailwindV4SourceOptionsFromRuntime>, generatorOptions: NormalizedWeappTailwindcssGeneratorOptions | undefined, file: string): Promise<import("../../../../generator/index.js").TailwindV4ResolvedSource | undefined>;

package/dist/bundlers/shared/generator-css/source-resolver/source-entries.d.ts

@@ -1,3 +1,3 @@
-import type { GeneratorSourceRuntimeState } from './types';
-import type { TailwindResolvedSource } from '../../../../generator';
-export declare function resolveGeneratorSourceEntries(source: TailwindResolvedSource, runtimeState?: GeneratorSourceRuntimeState): Promise<import("../../../../tailwindcss/source-scan").TailwindSourceEntry[] | undefined>;
+import type { GeneratorSourceRecord } from './metadata.js';
+import type { GeneratorSourceRuntimeState } from './types.js';
+export declare function resolveGeneratorSourceEntries(record: GeneratorSourceRecord, runtimeState?: GeneratorSourceRuntimeState): Promise<import("../../../../tailwindcss/source-scan.js").TailwindSourceEntry[] | undefined>;