weapp-tailwindcss 5.1.15 → 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

@@ -0,0 +1,71 @@
+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(sourcesByFile: Map<string, {
+    source: string;
+    type: 'html' | 'js';
+}>): 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: {
+    cache: ReturnType<typeof getCompilerContext>['cache'];
+    defaultStyleHandlerOptionsCache: Map<number | 'unknown', Partial<IStyleHandlerOptions>>;
+    gulpProcessCacheKeys: Set<string>;
+    phase: string;
+    runtimeSet: Set<string>;
+    runtimeSourceHashByFile: Map<string, string>;
+    runtimeSourcesByFile: Map<string, {
+        source: string;
+        type: 'html' | 'js';
+    }>;
+}): {
+    phase: string;
+    process: {
+        rssMb: number;
+        heapTotalMb: number;
+        heapUsedMb: number;
+        externalMb: number;
+        arrayBuffersMb: number;
+    };
+    runtime: {
+        runtimeSet: number;
+        runtimeSourceHashByFile: number;
+        runtimeSourcesByFile: number;
+        maxRuntimeSources: number;
+    };
+    processCache: {
+        instance: number;
+        hashMap: number;
+        activeCacheKeys: number;
+        maxCacheKeys: number;
+    };
+    gulpOptions: {
+        defaultStyleHandlerOptions: number;
+    };
+    tailwind: {
+        v4: {
+            max: number;
+            entryCandidatesMax: number;
+            entryCssBytesMax: number;
+            size: number;
+            taskMax: number;
+            taskSize: number;
+            entries: {
+                candidates: number;
+                classSet: number;
+                cssBytes: number;
+                rawCssBytes: number;
+                keyHash: string;
+                keyBytes: number;
+            }[];
+            keys: {
+                keyHash: string;
+                keyBytes: number;
+            }[];
+            taskKeys: {
+                keyHash: string;
+                keyBytes: number;
+            }[];
+        };
+    };
+} | undefined;

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

@@ -0,0 +1,45 @@
+import type File from 'vinyl';
+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;
+    forceCollect?: boolean;
+    clearCache?: boolean;
+};
+export interface GulpFileTransformContext {
+    cache: ReturnType<typeof getCompilerContext>['cache'];
+    createRuntimeSetHash: (rawSource: string, nextRuntimeSet: Set<string>, sourceTraceSignature?: string, sourceCandidateSignature?: string, outputSignature?: string) => string;
+    debug: DebugFunction;
+    generatedCssPreflightModeByFile: Map<string, {
+        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>;
+    gulpProcessCacheKeys: Set<string>;
+    opts: ReturnType<typeof getCompilerContext>;
+    refreshGulpV4SourceCandidates: (forceRefresh?: boolean) => Promise<((entries?: unknown) => Set<string>) | undefined>;
+    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;
+    resolveWxmlHandlerOptions: (options?: Partial<ITemplateHandlerOptions>) => Partial<ITemplateHandlerOptions>;
+    resolveWxssFileHandlerOptions: (file: File, rawSource: string, options?: Partial<IStyleHandlerOptions>) => Partial<IStyleHandlerOptions>;
+    resolveWxssUserHandlerOptions: (options?: Partial<IStyleHandlerOptions>) => Partial<IStyleHandlerOptions>;
+    runtimeState: TailwindRuntimeState;
+}
+export declare function createGulpFileTransforms(context: GulpFileTransformContext): {
+    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<CreateJsHandlerOptions>) => import("node:stream").Transform;
+};
+export {};

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

@@ -1,8 +1,15 @@
-import type { CreateJsHandlerOptions, 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<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

@@ -0,0 +1,21 @@
+import type { IStyleHandlerOptions, LoadedPostcssOptions } from '@weapp-tailwindcss/postcss/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;
+export declare function captureResolvedFrameworkPostcssOptions(owner: InternalUserDefinedOptions, options: LoadedPostcssOptions | undefined): LoadedPostcssOptions | undefined;
+export declare function hasFrameworkPostcssOptions(owner: InternalUserDefinedOptions): boolean;
+export declare function adaptGeneratedCssWithFrameworkPipeline(owner: InternalUserDefinedOptions, generated: GenerateCssByGeneratorResult, options: {
+    cssHandlerOptions: IStyleHandlerOptions;
+    file: string;
+    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

@@ -0,0 +1,19 @@
+import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/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 | undefined;
+    preservePreflight?: boolean | undefined;
+    removeEmptyAtRuleAncestors?: boolean | undefined;
+    styleOptions?: Partial<IStyleHandlerOptions> | undefined;
+}): string;
+export declare function resolveMiniProgramPreflightModeForGeneratorCss(opts: InternalUserDefinedOptions, options: {
+    cssHandlerOptions: IStyleHandlerOptions;
+    isolateCurrentCssCandidates: boolean;
+    localImports?: string | undefined;
+    primaryCssSource?: boolean | undefined;
+    explicitCssSource?: boolean | undefined;
+}): {
+    inject: boolean;
+    preserve: boolean;
+};

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

@@ -0,0 +1,25 @@
+import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
+import type { createWeappTailwindcssGenerator } from '../../../../generator/index.js';
+export declare function shouldFinalizeMarkedUserLayerComponentsCss(file: string): boolean;
+export declare function splitRawSourceByGeneratedCssOrder(rawSource: string, rawTailwindCss: string): {
+    before: string;
+    after: string;
+} | undefined;
+export declare function shouldUseGeneratorForCurrentCss(_majorVersion: number | undefined, cssHandlerOptions: IStyleHandlerOptions, options: {
+    forceGenerator?: boolean | undefined;
+    hasGeneratedCss: boolean;
+    hasGeneratedMarkers: boolean;
+    hasSourceDirectives: boolean;
+    rawSource: string;
+    runtimeCandidateCount?: number | undefined;
+    target?: string | undefined;
+    configuredCssSourceCount?: number | undefined;
+}): 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/index.js").TailwindV4GenerateResult & {
+    target: import("../../../../generator/index.js").WeappTailwindcssGeneratorTarget;
+    rawCss: string;
+}) | undefined;
+type GeneratorResult = Awaited<ReturnType<ReturnType<typeof createWeappTailwindcssGenerator>['generate']>>;
+export {};

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

@@ -0,0 +1,30 @@
+import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/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;
+    isolateCssSource: boolean;
+    majorVersion?: number | undefined;
+    matchedCssSourceFile: boolean;
+}): Set<string>;
+export declare function shouldIsolateScopedCssSource(_majorVersion: number | undefined, record: GeneratorSourceRecord, sourceEntries: TailwindSourceEntry[] | undefined, options: {
+    cssHandlerOptions?: IStyleHandlerOptions | undefined;
+    target: string;
+}): boolean;
+export declare function shouldIsolateCurrentTailwindV4CssCandidates(_majorVersion: number | undefined, cssHandlerOptions: IStyleHandlerOptions, options: {
+    hasGeneratedCss: boolean;
+    hasGeneratedMarkers: boolean;
+    rawSource: string;
+}): boolean;
+export declare function shouldScanTailwindV4Sources(majorVersion: number | undefined, target: string, generatorRuntime: Set<string>, isolateCssSource: boolean): boolean;
+export declare function shouldAppendWebBundleCssFallback(target: string, _options: {
+    hasSourceDirectives: boolean;
+    hasMatchedCssSourceFile: boolean;
+}): target is "web";
+export declare function isEmptyCssSourceOrderParts(parts: {
+    before: string;
+    after: string;
+}): boolean;
+export declare function resolveGeneratorStyleOptions(opts: InternalUserDefinedOptions, cssHandlerOptions: IStyleHandlerOptions, generatorStyleOptions: Partial<IStyleHandlerOptions> | undefined): Partial<IStyleHandlerOptions>;

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

@@ -0,0 +1,2 @@
+export declare function createCssSourceOrderAppend(base: string, extra: string): string;
+export declare function deduplicateGeneratedCssRules(css: string): string;

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

@@ -1,72 +1,4 @@
-import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
-import type { GeneratorResolvedSource } from './source-resolver';
-import type { createWeappTailwindcssGenerator } from '../../../generator';
-import type { TailwindSourceEntry } from '../../../tailwindcss/source-scan';
-import type { InternalUserDefinedOptions } from '../../../types';
-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;
-    styleOptions?: Partial<IStyleHandlerOptions> | undefined;
-}): string;
-export declare function resolveMiniProgramPreflightModeForGeneratorCss(opts: InternalUserDefinedOptions, options: {
-    cssHandlerOptions: IStyleHandlerOptions;
-    isolateCurrentCssCandidates: boolean;
-    localImports?: string | undefined;
-    primaryCssSource?: boolean | undefined;
-    explicitCssSource?: boolean | undefined;
-}): {
-    inject: boolean;
-    preserve: boolean;
-};
-export declare function mergeScopedRuntimeWithCurrentRuntime(scopedRuntime: Set<string>, runtime: Set<string>, options: {
-    currentCssCandidates?: string[] | undefined;
-    cssHandlerOptions: IStyleHandlerOptions;
-    isolateCssSource: boolean;
-    majorVersion?: number | undefined;
-    matchedCssSourceFile: boolean;
-}): Set<string>;
-export declare function shouldIsolateScopedCssSource(_majorVersion: number | undefined, source: GeneratorResolvedSource, sourceEntries: TailwindSourceEntry[] | undefined, options: {
-    cssHandlerOptions?: IStyleHandlerOptions | undefined;
-    target: string;
-}): boolean;
-export declare function shouldIsolateCurrentTailwindV4CssCandidates(_majorVersion: number | undefined, cssHandlerOptions: IStyleHandlerOptions, options: {
-    hasGeneratedCss: boolean;
-    hasGeneratedMarkers: boolean;
-    rawSource: string;
-}): boolean;
-export declare function shouldScanTailwindV4Sources(majorVersion: number | undefined, target: string, generatorRuntime: Set<string>, isolateCssSource: boolean): boolean;
-export declare function shouldAppendWebBundleCssFallback(target: string, _options: {
-    hasSourceDirectives: boolean;
-    hasMatchedCssSourceFile: boolean;
-}): target is "web";
-export declare function isEmptyCssSourceOrderParts(parts: {
-    before: string;
-    after: string;
-}): boolean;
-export declare function resolveGeneratorStyleOptions(opts: InternalUserDefinedOptions, cssHandlerOptions: IStyleHandlerOptions, generatorStyleOptions: Partial<IStyleHandlerOptions> | undefined): Partial<IStyleHandlerOptions>;
-export declare function createCssSourceOrderAppend(base: string, extra: string): string;
-export declare function deduplicateGeneratedCssRules(css: string): string;
-export declare function shouldFinalizeMarkedUserLayerComponentsCss(file: string): boolean;
-export declare function splitRawSourceByGeneratedCssOrder(rawSource: string, rawTailwindCss: string): {
-    before: string;
-    after: string;
-} | undefined;
-export declare function shouldUseGeneratorForCurrentCss(_majorVersion: number | undefined, cssHandlerOptions: IStyleHandlerOptions, options: {
-    forceGenerator?: boolean | undefined;
-    hasGeneratedCss: boolean;
-    hasGeneratedMarkers: boolean;
-    hasSourceDirectives: boolean;
-    rawSource: string;
-    runtimeCandidateCount?: number | undefined;
-    target?: string | undefined;
-    configuredCssSourceCount?: number | undefined;
-}): 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;
-    rawCss: string;
-}) | undefined;
-type GeneratorResult = Awaited<ReturnType<ReturnType<typeof createWeappTailwindcssGenerator>['generate']>>;
-export {};
+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,7 +1,9 @@
 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): Promise<string>;
+export declare function appendLegacyCompatCss(css: string, rawSource: string, generatorTarget: string, styleHandler: InternalUserDefinedOptions['styleHandler'], cssHandlerOptions: IStyleHandlerOptions, generatorStyleOptions: Partial<IStyleHandlerOptions> | undefined, options?: {
+    preserveSelectorOverrides?: boolean | undefined;
+}): Promise<string>;
 export declare function appendLegacyContainerCompatCss(css: string, rawSource: string, file: string, runtime: Set<string>, configuredContainerCompat: boolean, generatorTarget: string, styleHandler: InternalUserDefinedOptions['styleHandler'], cssHandlerOptions: IStyleHandlerOptions, generatorStyleOptions: Partial<IStyleHandlerOptions> | undefined): Promise<string>;

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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1,6 @@
+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;
+export declare function finalizeIncrementalGeneratorCss(previousCss: string, incrementalCss: string, target: string, majorVersion: number | undefined, cssPreflight: Parameters<typeof finalizeMiniProgramGeneratorCss>[3], options: Parameters<typeof finalizeMiniProgramGeneratorCss>[4], webCompat: ReturnType<typeof normalizeWeappTailwindcssGeneratorOptions>['webCompat']): string;

package/dist/bundlers/shared/generator-css/scoped-rules.d.ts

@@ -0,0 +1 @@
+export declare function preferScopedGeneratedCssRules(css: string): string;

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

@@ -0,0 +1,32 @@
+import type { IStyleHandlerOptions } from '@weapp-tailwindcss/postcss/types';
+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;
+export declare function mergeCssSources(cssSources: TailwindV4CssSource[] | undefined, cssEntrySources: TailwindV4CssSource[] | undefined): import("@tailwindcss-mangle/engine").TailwindV4CssSource[] | undefined;
+export declare function createSingleTailwindV4SourceOptions(sourceOptions: TailwindV4SourceOptions, options: {
+    base: string;
+    css: string;
+    cssEntries?: string[] | undefined;
+}): Partial<{
+    projectRoot: string;
+    baseFallbacks: string[];
+    packageName: string;
+    base: string;
+    css: string;
+    cssEntries: string[];
+}>;
+export declare function resolveTailwindV4CssEntrySource(cssEntry: string, sourceOptions: TailwindV4SourceOptions, options?: {
+    candidateMatched?: boolean | undefined;
+    includesPreflight?: boolean | undefined;
+    index?: number | undefined;
+}): 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;
+export declare function normalizeResolvedTailwindV4SourceConfig<T extends TailwindResolvedSource>(source: T, file: string | undefined, sourceOptions: TailwindV4SourceOptions | undefined): T;
+export declare function normalizeTailwindV4CssSourceConfigs(sourceOptions: TailwindV4SourceOptions): TailwindV4SourceOptions;
+export declare function tryResolveTailwindV4SourceOptions(runtimeState: GeneratorSourceRuntimeState): TailwindV4SourceOptions | undefined;
+export declare function hasConfiguredTailwindV4CssSource(sourceOptions: TailwindV4SourceOptions | undefined): boolean;
+export declare function isSameTailwindV4CssSource(a: TailwindV4CssSource | undefined, b: TailwindV4CssSource | undefined): boolean;

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;