@weapp-tailwindcss/postcss 3.3.4 → 3.3.6

package/dist/experimental/lightningcss/index.cjs

@@ -0,0 +1,256 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared = require("../../shared-CELzerNo.cjs");
+const require_preflight = require("../../preflight-BTZL2nvC.cjs");
+let _weapp_tailwindcss_shared = require("@weapp-tailwindcss/shared");
+//#region src/experimental/lightningcss/options.ts
+const FALLBACK_PLACEHOLDER_SUFFIXES = [":not(#n)", ":not(#\\#)"];
+function normalizeSelectorList(value) {
+	if (value === void 0 || value === false) return [];
+	return Array.isArray(value) ? value.filter(Boolean) : [value];
+}
+function getSpecificityMatchingName(options) {
+	const feature = options.cssPresetEnv?.features?.["is-pseudo-class"];
+	if (feature && typeof feature === "object" && "specificityMatchingName" in feature) {
+		const specificityName = feature.specificityMatchingName;
+		return typeof specificityName === "string" && specificityName.length > 0 ? specificityName : void 0;
+	}
+}
+function createRootSpecificityReplacer(options) {
+	const specificityMatchingName = getSpecificityMatchingName(options);
+	const selectors = normalizeSelectorList(options.cssSelectorReplacement?.root);
+	const replaceFallbackPlaceholder = (code) => {
+		let output = code;
+		for (const suffix of FALLBACK_PLACEHOLDER_SUFFIXES) if (output.includes(suffix)) output = output.split(suffix).join("");
+		return output;
+	};
+	if (!specificityMatchingName || selectors.length === 0) return replaceFallbackPlaceholder;
+	const suffix = `:not(.${specificityMatchingName})`;
+	const targets = selectors.map((selector) => selector?.trim()).filter((selector) => Boolean(selector?.length)).map((selector) => ({
+		match: `${selector}${suffix}`,
+		spacedMatch: `${selector} ${suffix}`,
+		replacement: selector
+	}));
+	if (!targets.length) return;
+	return (code) => {
+		let output = replaceFallbackPlaceholder(code);
+		for (const target of targets) {
+			if (output.includes(target.match)) output = output.split(target.match).join(target.replacement);
+			if (output.includes(target.spacedMatch)) output = output.split(target.spacedMatch).join(target.replacement);
+		}
+		return output;
+	};
+}
+function getLightningDefaultOptions(options) {
+	const customPropertiesFeature = options?.cssPresetEnv?.features?.["custom-properties"];
+	return {
+		cssPresetEnv: {
+			features: {
+				"cascade-layers": true,
+				"is-pseudo-class": { specificityMatchingName: "weapp-tw-ig" },
+				"oklab-function": true,
+				"color-mix": true,
+				"custom-properties": customPropertiesFeature !== void 0 ? customPropertiesFeature : options?.cssCalc ? { preserve: true } : false
+			},
+			autoprefixer: { add: false }
+		},
+		cssRemoveProperty: true,
+		cssRemoveHoverPseudoClass: true,
+		cssChildCombinatorReplaceValue: ["view", "text"],
+		cssSelectorReplacement: {
+			root: [
+				"page",
+				".tw-root",
+				"wx-root-portal-content"
+			],
+			universal: ["view", "text"]
+		}
+	};
+}
+function prepareStyleOptions(options) {
+	const merged = (0, _weapp_tailwindcss_shared.defuOverrideArray)(options, getLightningDefaultOptions(options));
+	merged.cssInjectPreflight = require_preflight.createInjectPreflight(merged.cssPreflight);
+	return merged;
+}
+//#endregion
+//#region src/experimental/lightningcss/selector-utils.ts
+function createTypeSelector(name) {
+	return {
+		type: "type",
+		name
+	};
+}
+function cloneComponent(value) {
+	const structured = globalThis.structuredClone;
+	if (typeof structured === "function") return structured(value);
+	return JSON.parse(JSON.stringify(value));
+}
+function cloneComponents(list) {
+	return list.map(cloneComponent);
+}
+function normalizeNestedSelectors(selectors) {
+	if (!selectors) return;
+	if (Array.isArray(selectors)) {
+		if (selectors.length === 0) return [];
+		const first = selectors[0];
+		if (Array.isArray(first)) return selectors;
+		return [selectors];
+	}
+	return [selectors];
+}
+function assignNestedSelectors(target, value) {
+	if (!("selectors" in target)) return;
+	if (Array.isArray(target.selectors)) target.selectors = value ?? [];
+	else if (target.selectors && !Array.isArray(target.selectors)) target.selectors = value?.[0] ?? target.selectors;
+}
+function trimCombinators(components) {
+	let start = 0;
+	let end = components.length;
+	while (start < end && components[start]?.type === "combinator") start++;
+	while (end > start && components[end - 1]?.type === "combinator") end--;
+	return components.slice(start, end);
+}
+function matchesHiddenNot(component) {
+	if (!component || component.type !== "pseudo-class" || component.kind !== "not") return false;
+	const selectors = normalizeNestedSelectors(component.selectors);
+	if (!selectors || selectors.length !== 1) return false;
+	const [nestedSelector] = selectors;
+	if (!nestedSelector || nestedSelector.length !== 1) return false;
+	const [node] = nestedSelector;
+	if (!node) return false;
+	return node.type === "attribute" && node.name === "hidden" || node.type === "type" && node.name === "template";
+}
+//#endregion
+//#region src/experimental/lightningcss/selector-transform.ts
+function buildSelectorReplacement(value) {
+	if (!value) return null;
+	const targets = Array.isArray(value) ? value : [value];
+	if (!targets.length) return null;
+	if (targets.length === 1) return [createTypeSelector(targets[0])];
+	return [{
+		type: "pseudo-class",
+		kind: "is",
+		selectors: targets.map((name) => [createTypeSelector(name)])
+	}];
+}
+function buildChildCombinatorReplacement(options) {
+	const { cssChildCombinatorReplaceValue } = options;
+	if (!cssChildCombinatorReplaceValue) return;
+	const normalized = Array.isArray(cssChildCombinatorReplaceValue) ? cssChildCombinatorReplaceValue : [cssChildCombinatorReplaceValue];
+	if (!normalized.length) return;
+	const baseComponents = buildSelectorReplacement(normalized) ?? [createTypeSelector("view")];
+	const left = cloneComponents(baseComponents);
+	const right = cloneComponents(baseComponents);
+	return [
+		...left,
+		{
+			type: "combinator",
+			value: "next-sibling"
+		},
+		...right
+	];
+}
+function transformSelectorComponent(component, ctx, transformList) {
+	const { options } = ctx;
+	if (component.type === "class") {
+		const cloned = cloneComponent(component);
+		cloned.name = require_shared.internalCssSelectorReplacer(component.name, { escapeMap: options.escapeMap });
+		return [cloned];
+	}
+	if (component.type === "universal") {
+		const replacement = buildSelectorReplacement(options.cssSelectorReplacement?.universal);
+		if (replacement) return cloneComponents(replacement);
+		return [cloneComponent(component)];
+	}
+	if (component.type === "type") {
+		if (options.uniAppX) return [];
+		return [cloneComponent(component)];
+	}
+	if (component.type === "attribute") {
+		if (options.uniAppX) return [];
+		return [cloneComponent(component)];
+	}
+	if (component.type === "combinator") return [cloneComponent(component)];
+	if (component.type === "pseudo-element") return [cloneComponent(component)];
+	if (component.type === "pseudo-class") {
+		if (component.kind === "hover" && options.cssRemoveHoverPseudoClass) return null;
+		if (component.kind === "root") {
+			const replacement = buildSelectorReplacement(options.cssSelectorReplacement?.root);
+			if (replacement) return cloneComponents(replacement);
+			return [cloneComponent(component)];
+		}
+		const cloned = cloneComponent(component);
+		if ("selectors" in cloned) {
+			const nestedSelectors = normalizeNestedSelectors(cloned.selectors);
+			if (nestedSelectors) assignNestedSelectors(cloned, transformList(nestedSelectors, ctx));
+		}
+		if (cloned.kind === "where" && options.uniAppX) cloned.kind = "is";
+		return [cloned];
+	}
+	return [cloneComponent(component)];
+}
+function transformSelector(selector, ctx, transformList) {
+	const { childCombinatorReplacement } = ctx;
+	const output = [];
+	for (let index = 0; index < selector.length; index++) {
+		const component = selector[index];
+		if (!component) continue;
+		if (component.type === "combinator" && component.value === "child" && childCombinatorReplacement) {
+			const next = selector[index + 1];
+			const combinator = selector[index + 2];
+			const third = selector[index + 3];
+			if (matchesHiddenNot(next) && combinator?.type === "combinator" && (combinator.value === "next-sibling" || combinator.value === "later-sibling") && matchesHiddenNot(third)) {
+				output.push(cloneComponent(component));
+				output.push(...cloneComponents(childCombinatorReplacement));
+				index += 3;
+				continue;
+			}
+		}
+		const replaced = transformSelectorComponent(component, ctx, transformList);
+		if (replaced === null) return null;
+		output.push(...replaced);
+	}
+	const trimmed = trimCombinators(output);
+	return trimmed.length > 0 ? trimmed : null;
+}
+function transformSelectorList(selectors, ctx) {
+	const result = [];
+	for (const selector of selectors) {
+		const transformed = transformSelector(selector, ctx, transformSelectorList);
+		if (transformed && transformed.length > 0) result.push(transformed);
+	}
+	return result;
+}
+function createVisitor(ctx) {
+	return {
+		Rule(rule) {
+			if (rule.type === "property" && ctx.options.cssRemoveProperty) return [];
+			if (rule.type !== "style") return rule;
+			const styleRule = rule.value;
+			if (!styleRule.selectors) return rule;
+			const selectors = transformSelectorList(styleRule.selectors, ctx);
+			if (!selectors.length) return [];
+			styleRule.selectors = selectors;
+			return rule;
+		},
+		RuleExit(rule) {
+			if (rule.type !== "style") return rule;
+			const styleRule = rule.value;
+			const hasValidSelectors = (styleRule.selectors ?? []).some((selector) => selector.length > 0);
+			const declarationCount = styleRule.declarations?.declarations?.length ?? 0;
+			if (!hasValidSelectors || ctx.options.uniAppX && declarationCount === 0) return [];
+			return rule;
+		}
+	};
+}
+//#endregion
+exports.assignNestedSelectors = assignNestedSelectors;
+exports.buildChildCombinatorReplacement = buildChildCombinatorReplacement;
+exports.cloneComponent = cloneComponent;
+exports.cloneComponents = cloneComponents;
+exports.createRootSpecificityReplacer = createRootSpecificityReplacer;
+exports.createTypeSelector = createTypeSelector;
+exports.createVisitor = createVisitor;
+exports.matchesHiddenNot = matchesHiddenNot;
+exports.normalizeNestedSelectors = normalizeNestedSelectors;
+exports.prepareStyleOptions = prepareStyleOptions;
+exports.trimCombinators = trimCombinators;

package/dist/experimental/lightningcss/index.d.ts

@@ -0,0 +1,3 @@
+export { createRootSpecificityReplacer, prepareStyleOptions } from './options.js';
+export { buildChildCombinatorReplacement, createVisitor, type SelectorTransformContext } from './selector-transform.js';
+export { assignNestedSelectors, cloneComponent, cloneComponents, createTypeSelector, matchesHiddenNot, normalizeNestedSelectors, trimCombinators } from './selector-utils.js';

package/dist/experimental/lightningcss/index.js

@@ -0,0 +1,245 @@
+import { internalCssSelectorReplacer } from "../../shared-CfQUwapA.js";
+import { createInjectPreflight } from "../../preflight-DVg4eehD.js";
+import { defuOverrideArray } from "@weapp-tailwindcss/shared";
+//#region src/experimental/lightningcss/options.ts
+const FALLBACK_PLACEHOLDER_SUFFIXES = [":not(#n)", ":not(#\\#)"];
+function normalizeSelectorList(value) {
+	if (value === void 0 || value === false) return [];
+	return Array.isArray(value) ? value.filter(Boolean) : [value];
+}
+function getSpecificityMatchingName(options) {
+	const feature = options.cssPresetEnv?.features?.["is-pseudo-class"];
+	if (feature && typeof feature === "object" && "specificityMatchingName" in feature) {
+		const specificityName = feature.specificityMatchingName;
+		return typeof specificityName === "string" && specificityName.length > 0 ? specificityName : void 0;
+	}
+}
+function createRootSpecificityReplacer(options) {
+	const specificityMatchingName = getSpecificityMatchingName(options);
+	const selectors = normalizeSelectorList(options.cssSelectorReplacement?.root);
+	const replaceFallbackPlaceholder = (code) => {
+		let output = code;
+		for (const suffix of FALLBACK_PLACEHOLDER_SUFFIXES) if (output.includes(suffix)) output = output.split(suffix).join("");
+		return output;
+	};
+	if (!specificityMatchingName || selectors.length === 0) return replaceFallbackPlaceholder;
+	const suffix = `:not(.${specificityMatchingName})`;
+	const targets = selectors.map((selector) => selector?.trim()).filter((selector) => Boolean(selector?.length)).map((selector) => ({
+		match: `${selector}${suffix}`,
+		spacedMatch: `${selector} ${suffix}`,
+		replacement: selector
+	}));
+	if (!targets.length) return;
+	return (code) => {
+		let output = replaceFallbackPlaceholder(code);
+		for (const target of targets) {
+			if (output.includes(target.match)) output = output.split(target.match).join(target.replacement);
+			if (output.includes(target.spacedMatch)) output = output.split(target.spacedMatch).join(target.replacement);
+		}
+		return output;
+	};
+}
+function getLightningDefaultOptions(options) {
+	const customPropertiesFeature = options?.cssPresetEnv?.features?.["custom-properties"];
+	return {
+		cssPresetEnv: {
+			features: {
+				"cascade-layers": true,
+				"is-pseudo-class": { specificityMatchingName: "weapp-tw-ig" },
+				"oklab-function": true,
+				"color-mix": true,
+				"custom-properties": customPropertiesFeature !== void 0 ? customPropertiesFeature : options?.cssCalc ? { preserve: true } : false
+			},
+			autoprefixer: { add: false }
+		},
+		cssRemoveProperty: true,
+		cssRemoveHoverPseudoClass: true,
+		cssChildCombinatorReplaceValue: ["view", "text"],
+		cssSelectorReplacement: {
+			root: [
+				"page",
+				".tw-root",
+				"wx-root-portal-content"
+			],
+			universal: ["view", "text"]
+		}
+	};
+}
+function prepareStyleOptions(options) {
+	const merged = defuOverrideArray(options, getLightningDefaultOptions(options));
+	merged.cssInjectPreflight = createInjectPreflight(merged.cssPreflight);
+	return merged;
+}
+//#endregion
+//#region src/experimental/lightningcss/selector-utils.ts
+function createTypeSelector(name) {
+	return {
+		type: "type",
+		name
+	};
+}
+function cloneComponent(value) {
+	const structured = globalThis.structuredClone;
+	if (typeof structured === "function") return structured(value);
+	return JSON.parse(JSON.stringify(value));
+}
+function cloneComponents(list) {
+	return list.map(cloneComponent);
+}
+function normalizeNestedSelectors(selectors) {
+	if (!selectors) return;
+	if (Array.isArray(selectors)) {
+		if (selectors.length === 0) return [];
+		const first = selectors[0];
+		if (Array.isArray(first)) return selectors;
+		return [selectors];
+	}
+	return [selectors];
+}
+function assignNestedSelectors(target, value) {
+	if (!("selectors" in target)) return;
+	if (Array.isArray(target.selectors)) target.selectors = value ?? [];
+	else if (target.selectors && !Array.isArray(target.selectors)) target.selectors = value?.[0] ?? target.selectors;
+}
+function trimCombinators(components) {
+	let start = 0;
+	let end = components.length;
+	while (start < end && components[start]?.type === "combinator") start++;
+	while (end > start && components[end - 1]?.type === "combinator") end--;
+	return components.slice(start, end);
+}
+function matchesHiddenNot(component) {
+	if (!component || component.type !== "pseudo-class" || component.kind !== "not") return false;
+	const selectors = normalizeNestedSelectors(component.selectors);
+	if (!selectors || selectors.length !== 1) return false;
+	const [nestedSelector] = selectors;
+	if (!nestedSelector || nestedSelector.length !== 1) return false;
+	const [node] = nestedSelector;
+	if (!node) return false;
+	return node.type === "attribute" && node.name === "hidden" || node.type === "type" && node.name === "template";
+}
+//#endregion
+//#region src/experimental/lightningcss/selector-transform.ts
+function buildSelectorReplacement(value) {
+	if (!value) return null;
+	const targets = Array.isArray(value) ? value : [value];
+	if (!targets.length) return null;
+	if (targets.length === 1) return [createTypeSelector(targets[0])];
+	return [{
+		type: "pseudo-class",
+		kind: "is",
+		selectors: targets.map((name) => [createTypeSelector(name)])
+	}];
+}
+function buildChildCombinatorReplacement(options) {
+	const { cssChildCombinatorReplaceValue } = options;
+	if (!cssChildCombinatorReplaceValue) return;
+	const normalized = Array.isArray(cssChildCombinatorReplaceValue) ? cssChildCombinatorReplaceValue : [cssChildCombinatorReplaceValue];
+	if (!normalized.length) return;
+	const baseComponents = buildSelectorReplacement(normalized) ?? [createTypeSelector("view")];
+	const left = cloneComponents(baseComponents);
+	const right = cloneComponents(baseComponents);
+	return [
+		...left,
+		{
+			type: "combinator",
+			value: "next-sibling"
+		},
+		...right
+	];
+}
+function transformSelectorComponent(component, ctx, transformList) {
+	const { options } = ctx;
+	if (component.type === "class") {
+		const cloned = cloneComponent(component);
+		cloned.name = internalCssSelectorReplacer(component.name, { escapeMap: options.escapeMap });
+		return [cloned];
+	}
+	if (component.type === "universal") {
+		const replacement = buildSelectorReplacement(options.cssSelectorReplacement?.universal);
+		if (replacement) return cloneComponents(replacement);
+		return [cloneComponent(component)];
+	}
+	if (component.type === "type") {
+		if (options.uniAppX) return [];
+		return [cloneComponent(component)];
+	}
+	if (component.type === "attribute") {
+		if (options.uniAppX) return [];
+		return [cloneComponent(component)];
+	}
+	if (component.type === "combinator") return [cloneComponent(component)];
+	if (component.type === "pseudo-element") return [cloneComponent(component)];
+	if (component.type === "pseudo-class") {
+		if (component.kind === "hover" && options.cssRemoveHoverPseudoClass) return null;
+		if (component.kind === "root") {
+			const replacement = buildSelectorReplacement(options.cssSelectorReplacement?.root);
+			if (replacement) return cloneComponents(replacement);
+			return [cloneComponent(component)];
+		}
+		const cloned = cloneComponent(component);
+		if ("selectors" in cloned) {
+			const nestedSelectors = normalizeNestedSelectors(cloned.selectors);
+			if (nestedSelectors) assignNestedSelectors(cloned, transformList(nestedSelectors, ctx));
+		}
+		if (cloned.kind === "where" && options.uniAppX) cloned.kind = "is";
+		return [cloned];
+	}
+	return [cloneComponent(component)];
+}
+function transformSelector(selector, ctx, transformList) {
+	const { childCombinatorReplacement } = ctx;
+	const output = [];
+	for (let index = 0; index < selector.length; index++) {
+		const component = selector[index];
+		if (!component) continue;
+		if (component.type === "combinator" && component.value === "child" && childCombinatorReplacement) {
+			const next = selector[index + 1];
+			const combinator = selector[index + 2];
+			const third = selector[index + 3];
+			if (matchesHiddenNot(next) && combinator?.type === "combinator" && (combinator.value === "next-sibling" || combinator.value === "later-sibling") && matchesHiddenNot(third)) {
+				output.push(cloneComponent(component));
+				output.push(...cloneComponents(childCombinatorReplacement));
+				index += 3;
+				continue;
+			}
+		}
+		const replaced = transformSelectorComponent(component, ctx, transformList);
+		if (replaced === null) return null;
+		output.push(...replaced);
+	}
+	const trimmed = trimCombinators(output);
+	return trimmed.length > 0 ? trimmed : null;
+}
+function transformSelectorList(selectors, ctx) {
+	const result = [];
+	for (const selector of selectors) {
+		const transformed = transformSelector(selector, ctx, transformSelectorList);
+		if (transformed && transformed.length > 0) result.push(transformed);
+	}
+	return result;
+}
+function createVisitor(ctx) {
+	return {
+		Rule(rule) {
+			if (rule.type === "property" && ctx.options.cssRemoveProperty) return [];
+			if (rule.type !== "style") return rule;
+			const styleRule = rule.value;
+			if (!styleRule.selectors) return rule;
+			const selectors = transformSelectorList(styleRule.selectors, ctx);
+			if (!selectors.length) return [];
+			styleRule.selectors = selectors;
+			return rule;
+		},
+		RuleExit(rule) {
+			if (rule.type !== "style") return rule;
+			const styleRule = rule.value;
+			const hasValidSelectors = (styleRule.selectors ?? []).some((selector) => selector.length > 0);
+			const declarationCount = styleRule.declarations?.declarations?.length ?? 0;
+			if (!hasValidSelectors || ctx.options.uniAppX && declarationCount === 0) return [];
+			return rule;
+		}
+	};
+}
+//#endregion
+export { assignNestedSelectors, buildChildCombinatorReplacement, cloneComponent, cloneComponents, createRootSpecificityReplacer, createTypeSelector, createVisitor, matchesHiddenNot, normalizeNestedSelectors, prepareStyleOptions, trimCombinators };

package/dist/experimental/lightningcss/options.d.ts

@@ -0,0 +1,3 @@
+import type { IStyleHandlerOptions } from '../../types.js';
+export declare function createRootSpecificityReplacer(options: IStyleHandlerOptions): ((code: string) => string) | undefined;
+export declare function prepareStyleOptions(options?: Partial<IStyleHandlerOptions>): IStyleHandlerOptions;

package/dist/experimental/lightningcss/selector-transform.d.ts

@@ -0,0 +1,10 @@
+import type { SelectorComponent } from 'lightningcss';
+import type { IStyleHandlerOptions } from '../../types.js';
+type CustomAtRules = Record<string, never>;
+export interface SelectorTransformContext {
+    options: IStyleHandlerOptions;
+    childCombinatorReplacement?: SelectorComponent[] | undefined;
+}
+export declare function buildChildCombinatorReplacement(options: IStyleHandlerOptions): SelectorComponent[] | undefined;
+export declare function createVisitor(ctx: SelectorTransformContext): import("lightningcss").Visitor<CustomAtRules>;
+export {};

package/dist/experimental/lightningcss/selector-utils.d.ts

@@ -0,0 +1,10 @@
+import type { Selector, SelectorComponent } from 'lightningcss';
+export declare function createTypeSelector(name: string): SelectorComponent;
+export declare function cloneComponent<T>(value: T): T;
+export declare function cloneComponents(list: SelectorComponent[]): SelectorComponent[];
+export declare function normalizeNestedSelectors(selectors: Selector[] | Selector | null | undefined): Selector[] | undefined;
+export declare function assignNestedSelectors(target: SelectorComponent & {
+    selectors?: Selector[] | Selector | null;
+}, value: Selector[] | undefined): void;
+export declare function trimCombinators(components: SelectorComponent[]): SelectorComponent[];
+export declare function matchesHiddenNot(component: SelectorComponent | undefined): boolean;

package/dist/framework-pipeline.d.ts

@@ -0,0 +1,4 @@
+import type { LoadedPostcssOptions } from './types.js';
+import postcss from 'postcss';
+/** 重放框架提供的管线，不附加小程序转换或默认插件。 */
+export declare function processFrameworkCss(css: string, options: LoadedPostcssOptions): Promise<postcss.Result<postcss.Document | postcss.Root>>;

package/dist/generator-plugin/config-directive.d.ts

@@ -1 +1,6 @@
+export declare function normalizeConfigDirective(css: string, config: string | undefined): string;
+/** 保留预处理器文本兼容；请求解析与文件定位由调用方提供。 */
+export declare function rewriteCssConfigRequests(source: string, resolve: (request: string) => string | undefined): string;
+/** 保留 Vite 预处理前的行级清理语义，允许尚未编译的 Sass 等源码。 */
+export declare function stripTailwindConfigDirectives(code: string): string;
 export declare function prependConfigDirective(css: string, config: string | undefined): string;

package/dist/generator-plugin/local-imports.d.ts

@@ -12,7 +12,11 @@ export interface CollectCssImportRequestsRootOptions {
 export declare function createCssSourceOrderAppend(base: string, extra: string): string;
 export declare function isLocalCssImportRequest(request: string): boolean;
 export declare function isMiniProgramLocalCssImportRequest(request: string): boolean;
-export declare function removeTailwindSourceDirectivesRoot(root: Root, options?: TailwindCssDirectiveOptions): boolean;
+interface RemoveTailwindSourceDirectivesOptions extends TailwindCssDirectiveOptions {
+    /** Web 输出中的 layer 声明负责层叠排序，不能作为源指令清理。 */
+    preserveCssLayers?: boolean | undefined;
+}
+export declare function removeTailwindSourceDirectivesRoot(root: Root, options?: RemoveTailwindSourceDirectivesOptions): boolean;
 export declare function isPureLocalCssImportWrapperRoot(root: Root): boolean;
 export declare function collectCssImportRequestsRoot(root: Root, options?: CollectCssImportRequestsRootOptions): Set<string>;
 export declare function removeUnsupportedMiniProgramCssImportsRoot(root: Root): boolean;
@@ -34,3 +38,4 @@ export declare function restoreLocalCssImports(css: string, imports: string | un
 export declare function normalizeOutputImportRequest(request: string, styleOutputExtension: string | undefined): string;
 export declare function rewriteLocalCssImportRequestsForOutputRoot(root: Root, options?: RewriteLocalCssImportRequestOptions): boolean;
 export declare function rewriteLocalCssImportRequestsForOutput(css: string, options?: RewriteLocalCssImportRequestOptions): string;
+export {};

package/dist/generator-plugin/source-files.d.ts

@@ -1,13 +1,13 @@
 import type { Result, Root } from 'postcss';
 import type { TailwindSourceEntry } from '../source-scan.js';
 import type { TailwindCandidateSource, WeappTailwindcssPostcssPluginOptions } from './types.js';
-export declare function collectAutoTailwindCandidates(root: Root, result: Result, options: WeappTailwindcssPostcssPluginOptions, context?: {
+interface ScanContext {
     css?: string | undefined;
     sourceEntries?: TailwindSourceEntry[] | undefined;
-}): Promise<Set<string>>;
-export declare function collectPostcssLocalSources(root: Root, result: Result, options: WeappTailwindcssPostcssPluginOptions, context?: {
-    sourceEntries?: TailwindSourceEntry[] | undefined;
-}): Promise<{
+}
+export declare function collectAutoTailwindCandidates(root: Root, result: Result, options: WeappTailwindcssPostcssPluginOptions, context?: ScanContext): Promise<Set<string>>;
+export declare function collectPostcssLocalSources(root: Root, result: Result, options: WeappTailwindcssPostcssPluginOptions, context?: ScanContext): Promise<{
     files: string[];
     sources: TailwindCandidateSource[];
 }>;
+export {};

package/dist/generator-plugin/types.d.ts

@@ -5,6 +5,8 @@ export interface TailwindCandidateSource {
     extension?: string | undefined;
 }
 export interface WeappTailwindcssPostcssGenerateOptions {
+    scanMode?: 'compiled' | undefined;
+    excludeFiles?: string[] | undefined;
     candidates?: Iterable<string> | undefined;
     scanSources?: boolean | undefined;
     sources?: TailwindCandidateSource[] | undefined;
@@ -19,6 +21,7 @@ export interface WeappTailwindcssPostcssGenerateResult {
     dependencies: string[];
 }
 export interface WeappTailwindcssPostcssGenerator {
+    dispose?: (() => void) | undefined;
     generate: (options?: WeappTailwindcssPostcssGenerateOptions) => Promise<WeappTailwindcssPostcssGenerateResult>;
 }
 export interface TailwindV4SourceOptions {
@@ -45,6 +48,8 @@ export interface NormalizedWeappTailwindcssPostcssGeneratorOptions {
     bareArbitraryValues?: unknown;
 }
 export interface WeappTailwindcssPostcssPluginAdapters {
+    /** 生成器支持在编译会话内复用来源扫描；省略时保留旧适配协议。 */
+    compiledSourceScan?: boolean | undefined;
     createGenerator: (source: TailwindResolvedSource) => WeappTailwindcssPostcssGenerator;
     normalizeGeneratorOptions: (options: WeappTailwindcssPostcssGeneratorUserOptions | undefined) => NormalizedWeappTailwindcssPostcssGeneratorOptions;
     resolveTailwindV4Source: (options: TailwindV4SourceOptions) => Promise<TailwindResolvedSource>;