weapp-tailwindcss 5.5.4 → 5.5.6

package/dist/{generator-RK2HtgOb.cjs → generator-Bvr4WmuF.cjs}

@@ -12,7 +12,6 @@ let _tailwindcss_mangle_engine = require("@tailwindcss-mangle/engine");
 let _weapp_tailwindcss_postcss = require("@weapp-tailwindcss/postcss");
 let lru_cache = require("lru-cache");
 let node_module = require("node:module");
-let _csstools_css_tokenizer = require("@csstools/css-tokenizer");
 let node_fs_promises = require("node:fs/promises");
 let micromatch = require("micromatch");
 micromatch = require_rolldown_runtime.__toESM(micromatch, 1);
@@ -321,7 +320,7 @@ async function transformTailwindV4CssToWeapp(css, options) {
 		...options
 	});
 	const pruneOptions = {
-		preserveContentInit: options?.uniAppX === true && options.uniAppXCssTarget === "uvue" ? false : void 0,
+		...options?.uniAppX === true && options.uniAppXCssTarget === "uvue" ? { preserveContentInit: false } : {},
 		preservePreflight: true,
 		preserveConditionalComments: (0, _weapp_tailwindcss_postcss.hasCssMacroStyleOptions)(options)
 	};
@@ -339,48 +338,8 @@ function transformTailwindV4WebRpxCss(css) {
 async function transformTailwindV4CssByTarget(css, target, options) {
 	if (target === "weapp") return transformTailwindV4CssToWeapp(css, options);
 	const resolvedWebCss = await ((0, _weapp_tailwindcss_postcss.hasCssMacroStyleOptions)(options) ? (0, _weapp_tailwindcss_postcss.transformCssMacroCss)(css, options) : css);
-	return shouldUseUniAppWebRpxCompatibility(options?.appType) ? transformTailwindV4WebRpxCss(resolvedWebCss) : resolvedWebCss;
-}
-//#endregion
-//#region src/tailwindcss/v4-engine/css-import.ts
-function parseCssImportSpecifier(params) {
-	const tokens = (0, _csstools_css_tokenizer.tokenize)({ css: params }).filter((token) => token[0] !== _csstools_css_tokenizer.TokenType.Whitespace && token[0] !== _csstools_css_tokenizer.TokenType.Comment);
-	const first = tokens[0];
-	if (!first) return;
-	if (first[0] === _csstools_css_tokenizer.TokenType.String || first[0] === _csstools_css_tokenizer.TokenType.URL) return {
-		specifier: first[4].value,
-		raw: first[1],
-		quote: first[0] === _csstools_css_tokenizer.TokenType.String ? first[1][0] : void 0
-	};
-	if (first[0] === _csstools_css_tokenizer.TokenType.Function && first[4].value.toLowerCase() === "url" && tokens[1]?.[0] === _csstools_css_tokenizer.TokenType.String && tokens[2]?.[0] === _csstools_css_tokenizer.TokenType.CloseParen) return {
-		specifier: tokens[1][4].value,
-		raw: params.slice(first[2], tokens[2][3] + 1),
-		quote: tokens[1][1][0]
-	};
-}
-function quoteCssImportSpecifier(file, quote = "\"") {
-	return `${quote}${(node_path.default.sep === "\\" || /^[a-z]:[\\/]|^\\\\/i.test(file) ? file.replaceAll("\\", "/") : file).replaceAll("\\", "\\\\").replaceAll(quote, `\\${quote}`).replaceAll("\n", "\\a ").replaceAll("\r", "\\d ")}${quote}`;
-}
-function isTailwindCssImport(params) {
-	const specifier = parseCssImportSpecifier(params)?.specifier;
-	if (!specifier) return false;
-	if (specifier === "tailwindcss" || specifier.startsWith("tailwindcss/")) return true;
-	const paths = specifier.includes("\\") ? node_path.default.win32 : node_path.default.posix;
-	return paths.basename(specifier) === "index.css" && paths.basename(paths.dirname(specifier)) === "tailwindcss";
-}
-function parseImportSourceParam(params) {
-	const tokens = (0, _csstools_css_tokenizer.tokenize)({ css: params }).filter((token) => token[0] !== _csstools_css_tokenizer.TokenType.Whitespace && token[0] !== _csstools_css_tokenizer.TokenType.Comment);
-	const index = tokens.findIndex((token) => token[0] === _csstools_css_tokenizer.TokenType.Function && token[4].value === "source");
-	const value = tokens[index + 1];
-	if (index < 0 || tokens[index + 2]?.[0] !== _csstools_css_tokenizer.TokenType.CloseParen) return;
-	if (value?.[0] === _csstools_css_tokenizer.TokenType.Ident && value[4].value === "none") return {
-		none: true,
-		sourcePath: void 0
-	};
-	return value?.[0] === _csstools_css_tokenizer.TokenType.String ? {
-		none: false,
-		sourcePath: value[4].value
-	} : void 0;
+	const calculatedWebCss = await (0, _weapp_tailwindcss_postcss.applyConfiguredCssCalc)(resolvedWebCss, options ?? {});
+	return shouldUseUniAppWebRpxCompatibility(options?.appType) ? transformTailwindV4WebRpxCss(calculatedWebCss) : calculatedWebCss;
 }
 //#endregion
 //#region src/tailwindcss/v4-engine/tailwind-v4-default-colors.ts
@@ -772,7 +731,7 @@ function resolveTailwindV4ThemeCssFromImport(css) {
 	let resolved;
 	root.walkAtRules("import", (rule) => {
 		if (resolved) return;
-		const specifier = parseCssImportSpecifier(rule.params)?.specifier;
+		const specifier = (0, _weapp_tailwindcss_postcss.parseCssImportSpecifier)(rule.params)?.specifier;
 		if (!specifier || !node_path.default.isAbsolute(specifier) || node_path.default.basename(specifier) !== "index.css") return;
 		const themeCss = node_path.default.join(node_path.default.dirname(specifier), "theme.css");
 		if ((0, node_fs.existsSync)(themeCss)) resolved = themeCss;
@@ -804,58 +763,10 @@ function applyMiniProgramTailwindV4DefaultColorCss(css, source) {
 	if (insertionIndex === 0) return `${themeCss}\n${css}`;
 	return `${css.slice(0, insertionIndex)}\n${themeCss}\n${css.slice(insertionIndex)}`;
 }
-function isTailwindCssPreflightImport(params) {
-	const specifier = parseCssImportSpecifier(params)?.specifier;
-	return specifier === "tailwindcss/preflight.css" || specifier === "tailwindcss/preflight";
-}
-function removeTailwindV4PreflightImports(css) {
-	if (!css.includes("preflight")) return css;
-	let root;
-	try {
-		root = _weapp_tailwindcss_postcss.postcss.parse(css);
-	} catch {
-		return css;
-	}
-	let changed = false;
-	root.walkAtRules("import", (rule) => {
-		if (isTailwindCssPreflightImport(rule.params)) {
-			rule.remove();
-			changed = true;
-		}
-	});
-	return changed ? root.toString() : css;
-}
-function hasThemeParent(rule) {
-	let parent = rule.parent;
-	while (parent) {
-		if (parent.type === "atrule" && parent.name === "theme") return true;
-		parent = parent.parent;
-	}
-	return false;
-}
-function isVendorPrefixedKeyframes(rule) {
-	return rule.name.startsWith("-") && rule.name.endsWith("keyframes");
-}
-function removeUnsupportedThemeVendorKeyframes(css) {
-	if (!css.includes("@theme") || !css.includes("@-")) return css;
-	let root;
-	try {
-		root = _weapp_tailwindcss_postcss.postcss.parse(css);
-	} catch {
-		return css;
-	}
-	let changed = false;
-	root.walkAtRules((rule) => {
-		if (isVendorPrefixedKeyframes(rule) && hasThemeParent(rule)) {
-			rule.remove();
-			changed = true;
-		}
-	});
-	return changed ? root.toString() : css;
-}
 function createCompatibleSource(source, target) {
-	const filteredSourceCss = target === "weapp" ? removeTailwindV4PreflightImports(source.css) : source.css;
-	const compatibleSourceCss = removeUnsupportedThemeVendorKeyframes(target === "weapp" ? applyMiniProgramTailwindV4DefaultColorCss(filteredSourceCss, source) : filteredSourceCss);
+	const filteredSourceCss = target === "weapp" ? (0, _weapp_tailwindcss_postcss.removeTailwindV4PreflightImports)(source.css) : source.css;
+	const sourceCss = target === "weapp" ? applyMiniProgramTailwindV4DefaultColorCss(filteredSourceCss, source) : filteredSourceCss;
+	const compatibleSourceCss = (0, _weapp_tailwindcss_postcss.removeUnsupportedThemeVendorKeyframes)(sourceCss);
 	return compatibleSourceCss === source.css ? source : {
 		...source,
 		css: compatibleSourceCss
@@ -1273,7 +1184,7 @@ async function resolveCssDefinedScanSources(source) {
 	const definitions = [{
 		css: source.css,
 		base: source.base,
-		from: source.dependencies[0]
+		...source.dependencies[0] === void 0 ? {} : { from: source.dependencies[0] }
 	}];
 	for (const dependency of source.dependencies.slice(1)) {
 		if (!(0, node_fs.existsSync)(dependency)) continue;
@@ -1293,28 +1204,22 @@ async function resolveCssDefinedScanSources(source) {
 			continue;
 		}
 		root.walkAtRules((rule) => {
-			if (rule.name !== "import" || !isTailwindCssImport(rule.params)) return;
+			if (rule.name !== "import" || !(0, _weapp_tailwindcss_postcss.isTailwindCssImport)(rule.params)) return;
 			hasTailwindImport = true;
-			const sourceParam = parseImportSourceParam(rule.params);
+			const sourceParam = (0, _weapp_tailwindcss_postcss.parseImportSourceParam)(rule.params);
 			if (sourceParam?.none) hasSourceNone = true;
 			if (sourceParam?.sourcePath) importSourceBase = resolveSourceBase(definition.base, sourceParam.sourcePath);
 		});
 		sourcePatterns.push(...await resolveCssSourceEntries(root, definition.base, "**/*"));
 	}
-	if (!importSourceBase) {
-		if (sourcePatterns.length > 0) return [...normalizeCssDefinedScanSources(source.base, sourcePatterns), ...createDefaultIgnoredScanSources(source.base)];
-		if (hasSourceNone) return false;
-		if (hasTailwindImport) {
-			const defaultBase = resolveDefaultSourceBase(source);
-			return [await resolveTailwindSourceEntry(".", defaultBase, false, "**/*"), ...createDefaultIgnoredScanSources(defaultBase)];
-		}
-		return;
-	}
-	return [
-		await resolveTailwindSourceEntry(".", importSourceBase, false, "**/*"),
-		...sourcePatterns,
-		...createDefaultIgnoredScanSources(importSourceBase)
-	];
+	let entries;
+	if (importSourceBase) entries = [await resolveTailwindSourceEntry(".", importSourceBase, false, "**/*"), ...sourcePatterns];
+	else if (sourcePatterns.length > 0) entries = normalizeCssDefinedScanSources(source.base, sourcePatterns);
+	else if (hasSourceNone) return false;
+	else if (hasTailwindImport) entries = [await resolveTailwindSourceEntry(".", resolveDefaultSourceBase(source), false, "**/*")];
+	else return;
+	const scanBases = /* @__PURE__ */ new Set([importSourceBase ?? (sourcePatterns.length > 0 ? source.base : resolveDefaultSourceBase(source)), ...entries.filter((entry) => !entry.negated).map((entry) => entry.base)]);
+	return [...entries, ...[...scanBases].flatMap((base) => createDefaultIgnoredScanSources(base))];
 }
 async function resolveScanSources(source, scanSources) {
 	if (scanSources !== true) return scanSources;
@@ -1324,8 +1229,8 @@ function resolveCompiledSourceRoot(source) {
 	let root = null;
 	try {
 		_weapp_tailwindcss_postcss.postcss.parse(source.css).walkAtRules("import", (rule) => {
-			if (!isTailwindCssImport(rule.params)) return;
-			const sourceParam = parseImportSourceParam(rule.params);
+			if (!(0, _weapp_tailwindcss_postcss.isTailwindCssImport)(rule.params)) return;
+			const sourceParam = (0, _weapp_tailwindcss_postcss.parseImportSourceParam)(rule.params);
 			if (sourceParam?.none) {
 				root = "none";
 				return false;
@@ -1342,6 +1247,20 @@ function resolveCompiledSourceRoot(source) {
 	return root;
 }
 //#endregion
+//#region src/tailwindcss/v4-engine/generator/style-context.ts
+function resolveGenerationStyleContext(sourceCss, generatedCss, options) {
+	const calc = options?.cssOptions?.cssCalc ?? options?.cssCalc;
+	const include = Array.isArray(calc) ? calc : calc && typeof calc === "object" ? calc.includeCustomProperties : void 0;
+	if (calc !== true && !include?.length) return options;
+	const customPropertyValues = collectCustomPropertyValues(sourceCss);
+	mergeCustomPropertyValues(customPropertyValues, generatedCss);
+	for (const [name, value] of options?.customPropertyValues ?? []) customPropertyValues.set(name, value);
+	return {
+		...options,
+		customPropertyValues
+	};
+}
+//#endregion
 //#region src/tailwindcss/v4-engine/generator/engine.ts
 function isCssSyntaxError(error) {
 	return error instanceof Error && error.name === "CssSyntaxError";
@@ -1388,7 +1307,7 @@ function createTailwindV4Engine(source) {
 		}
 		const sources = Array.isArray(resolvedScanSources) ? resolvedScanSources : [];
 		const rawCss = restoreRpxLengthCssSelectors(generatedCss, normalizedCandidates.restoreCandidates);
-		const css = await transformTailwindV4CssByTarget(rawCss, target, resolvedStyleOptions);
+		const css = await transformTailwindV4CssByTarget(rawCss, target, resolveGenerationStyleContext(compatibleSource.css, rawCss, resolvedStyleOptions));
 		return {
 			classSet: restoreRpxLengthCandidates(classSet, normalizedCandidates.restoreCandidates),
 			rawCandidates: restoreRpxLengthCandidates(rawCandidates, normalizedCandidates.restoreCandidates),
@@ -2058,8 +1977,7 @@ function createCssNodeSignature(node) {
 		node.selector,
 		node.nodes?.map(createCssNodeSignature) ?? null
 	]);
-	if (node.type === "comment") return JSON.stringify(["comment", node.text]);
-	return node.toString();
+	return JSON.stringify(["comment", node.text]);
 }
 function createRuleBodySignature(rule) {
 	return JSON.stringify(rule.nodes?.map(createCssNodeSignature) ?? []);
@@ -2067,7 +1985,7 @@ function createRuleBodySignature(rule) {
 function createRuleAtRuleContextSignature(rule) {
 	const context = [];
 	let parent = rule.parent;
-	while (parent && parent.type !== "root" && parent.type !== "document") {
+	while (parent && parent.type !== "root") {
 		if (parent.type === "atrule") context.unshift(JSON.stringify([parent.name, parent.params]));
 		parent = parent.parent;
 	}
@@ -2261,6 +2179,7 @@ function filterApplyOnlyGeneratedCss(css, source, options = {}) {
 				});
 			});
 			const isVariableRule = rule.nodes?.some((node) => node.type === "decl" && node.prop.startsWith("--"));
+			if (options.preserveRuntimeProperties && (0, _weapp_tailwindcss_postcss.isTailwindRuntimePropertyRule)(rule)) return;
 			if (!isApplySelector && (!preserveVariables || !isVariableRule)) rule.remove();
 		});
 		root.walkAtRules((rule) => {
@@ -2343,9 +2262,38 @@ function isTailwindGeneratedThemeScopeSelector(selector) {
 	if (!selectors.every((item) => TAILWIND_GENERATED_THEME_SCOPE_SELECTORS.has(item))) return false;
 	return selectorSet.size === 2 && selectorSet.has(":root") && selectorSet.has(":host") || selectorSet.size === 4 && selectorSet.has(":host") && selectorSet.has("page") && selectorSet.has(".tw-root") && selectorSet.has("wx-root-portal-content");
 }
-function isTailwindGeneratedThemeRule(selector, node) {
-	if (!isTailwindGeneratedThemeScopeSelector(selector)) return false;
-	return node.nodes?.some((child) => child.type === "decl" && /^--(?:color|spacing|text|font|default|radius|tw-)/.test(child.prop)) ?? false;
+function themeDeclarationContext(declaration) {
+	const context = [];
+	let parent = declaration.parent?.parent;
+	while (parent && parent.type !== "root") {
+		if (parent.type === "atrule" && parent.name !== "layer") context.unshift(`@${parent.name} ${parent.params}`);
+		parent = parent.parent;
+	}
+	return context;
+}
+function themeDeclarationKey(declaration) {
+	const value = declaration.value.trim().replace(/^(-?)0\.(\d+(?:[a-z]+|%)?)$/i, "$1.$2");
+	return JSON.stringify([
+		themeDeclarationContext(declaration),
+		declaration.prop,
+		value,
+		Boolean(declaration.important)
+	]);
+}
+function collectGeneratedThemeDeclarations(source) {
+	const declarations = /* @__PURE__ */ new Set();
+	try {
+		_weapp_tailwindcss_postcss.postcss.parse(source).walkRules((rule) => {
+			if (!isTailwindGeneratedThemeScopeSelector(rule.selector.replace(/\s+/g, " ").replace(/\s*,\s*/g, ",").trim())) return;
+			for (const child of rule.nodes ?? []) if (child.type === "decl") declarations.add(themeDeclarationKey(child));
+		});
+	} catch {}
+	return declarations;
+}
+/** 同一轮框架恢复共享声明索引；只有遇到根变量时才解析生成产物。 */
+function createGeneratedThemeDeclarationResolver(source) {
+	let declarations;
+	return () => declarations ?? (declarations = collectGeneratedThemeDeclarations(source));
 }
 function isTailwindGeneratedPreflightRule(selector, node) {
 	if (selector === "view,text,::after,::before" || selector === "view, text, ::after, ::before" || selector === "*" || selector === "::after" || selector === "::before" || selector === "::backdrop" || selector === ":host" || selector === "[hidden]:not([hidden=\"until-found\"])" || selector === "[hidden]:not([hidden='until-found'])" || selector === "button,input[type=\"button\"],input[type=\"reset\"],input[type=\"submit\"]" || selector === "button, input[type=\"button\"], input[type=\"reset\"], input[type=\"submit\"]" || selector === "button,input[type='button'],input[type='reset'],input[type='submit']" || selector === "button, input[type='button'], input[type='reset'], input[type='submit']") return true;
@@ -2353,7 +2301,7 @@ function isTailwindGeneratedPreflightRule(selector, node) {
 	if (selector === ":host") return node.nodes?.some((child) => child.type === "decl" && child.value?.includes("--theme(")) ?? false;
 	return false;
 }
-function removeTailwindV4GeneratedUserCssArtifacts(source) {
+function removeTailwindV4GeneratedUserCssArtifacts(source, generatedSource) {
 	try {
 		const root = _weapp_tailwindcss_postcss.postcss.parse(source);
 		let changed = false;
@@ -2362,9 +2310,27 @@ function removeTailwindV4GeneratedUserCssArtifacts(source) {
 			comment.remove();
 			changed = true;
 		});
+		let generatedDeclarations;
+		const overriddenProperties = /* @__PURE__ */ new Set();
 		root.walkRules((rule) => {
-			const selector = rule.selector.replace(/\s+/g, " ").trim();
-			if (isTailwindGeneratedThemeRule(selector, rule) || isTailwindGeneratedPreflightRule(selector, rule)) {
+			const selector = rule.selector.replace(/\s+/g, " ").replace(/\s*,\s*/g, ",").trim();
+			if (isTailwindGeneratedThemeScopeSelector(selector) || TAILWIND_GENERATED_THEME_SCOPE_SELECTORS.has(selector) && rule.nodes.some((child) => child.type === "decl" && child.prop.startsWith("--"))) {
+				generatedDeclarations ?? (generatedDeclarations = typeof generatedSource === "function" ? generatedSource() : generatedSource ? collectGeneratedThemeDeclarations(generatedSource) : /* @__PURE__ */ new Set());
+				for (const child of [...rule.nodes]) {
+					if (child.type !== "decl") continue;
+					const propertyKey = JSON.stringify([themeDeclarationContext(child), child.prop]);
+					if (generatedDeclarations?.has(themeDeclarationKey(child)) && !overriddenProperties.has(propertyKey)) {
+						child.remove();
+						changed = true;
+					} else overriddenProperties.add(propertyKey);
+				}
+				if (rule.nodes.length === 0) {
+					rule.remove();
+					changed = true;
+				}
+				return;
+			}
+			if (isTailwindGeneratedPreflightRule(selector, rule)) {
 				rule.remove();
 				changed = true;
 			}
@@ -2628,16 +2594,37 @@ function unwrapMiniProgramCascadeLayers(source) {
 function hasClassSelector(selector) {
 	return /(?:^|[^\w-])\.[_a-z\u00A0-\uFFFF\\-]/i.test(selector);
 }
-function collectBareSelectorUserCss(source) {
+function collectBareSelectorUserCss(source, transformedCss) {
 	try {
 		const root = _weapp_tailwindcss_postcss.postcss.parse(source);
+		const representedSelectors = /* @__PURE__ */ new Set();
+		const rootSelectors = /* @__PURE__ */ new Set([
+			":root",
+			":host",
+			"page",
+			".tw-root",
+			"wx-root-portal-content"
+		]);
+		const selectorKey = (rule, selector) => {
+			const context = [];
+			let parent = rule.parent;
+			while (parent && parent.type !== "root") {
+				if (parent.type === "atrule") context.unshift(`@${parent.name} ${parent.params}`);
+				parent = parent.parent;
+			}
+			return JSON.stringify([...context, rootSelectors.has(selector.trim()) ? ":root" : selector.trim()]);
+		};
+		if (transformedCss !== void 0) _weapp_tailwindcss_postcss.postcss.parse(transformedCss).walkRules((rule) => {
+			for (const selector of rule.selectors) representedSelectors.add(selectorKey(rule, selector));
+		});
 		let changed = false;
 		root.walkAtRules("import", (rule) => {
 			rule.remove();
 			changed = true;
 		});
 		root.walkRules((rule) => {
-			if ((rule.selectors?.length ? rule.selectors : [rule.selector]).some((selector) => hasClassSelector(selector))) {
+			const selectors = rule.selectors?.length ? rule.selectors : [rule.selector];
+			if (selectors.some((selector) => hasClassSelector(selector)) || selectors.every((selector) => representedSelectors.has(selectorKey(rule, selector)))) {
 				rule.remove();
 				changed = true;
 			}
@@ -2683,22 +2670,30 @@ function stripUnmatchedTailwindSourceMediaCloseFragments(source) {
 //#region src/bundlers/shared/generator-css/user-css/transform.ts
 async function transformGeneratorUserCss(source, options) {
 	if (source.trim().length === 0) return "";
-	if (options.processed) return stripUnmatchedTailwindSourceMediaCloseFragments(stripTailwindSourceMediaFragments(removeTailwindV4GeneratorAtRules(options.generatorTarget === "weapp" ? removeTailwindV4GeneratedUserCssArtifacts(unwrapMiniProgramCascadeLayers(removeProcessedMiniProgramUnsupportedCss(source, {
-		...options.generatorStyleOptions,
-		...options.cssUserHandlerOptions
-	}))) : source)));
+	if (options.processed) {
+		const compiledSource = await options.compileAuthorCssFunctions?.(source) ?? source;
+		return stripUnmatchedTailwindSourceMediaCloseFragments(stripTailwindSourceMediaFragments(removeTailwindV4GeneratorAtRules(options.generatorTarget === "weapp" ? removeTailwindV4GeneratedUserCssArtifacts(unwrapMiniProgramCascadeLayers(removeProcessedMiniProgramUnsupportedCss(compiledSource, {
+			...options.generatorStyleOptions,
+			...options.cssUserHandlerOptions
+		})), options.generatedSource) : compiledSource)));
+	}
 	const cleanedSource = removeTailwindSourceDirectives(removeTailwindV4GeneratorAtRules(stripUnmatchedTailwindSourceMediaCloseFragments(stripTailwindSourceMediaFragments(source))), { importFallback: options.importFallback });
 	if (cleanedSource.trim().length === 0) return "";
-	const userSource = stripUnmatchedTailwindSourceMediaCloseFragments(removeTailwindApplyAtRules(removeTailwindSourceDirectives(stripUnmatchedTailwindSourceMediaCloseFragments(stripTailwindSourceMediaFragments(options.generatorTarget === "weapp" ? removeTailwindV4GeneratedUserCssArtifacts((0, _weapp_tailwindcss_postcss.removeUnsupportedMiniProgramAtRules)(unwrapMiniProgramCascadeLayers(cleanedSource))) : cleanedSource)), { importFallback: options.importFallback })));
+	const authorSource = stripUnmatchedTailwindSourceMediaCloseFragments(removeTailwindApplyAtRules(removeTailwindSourceDirectives(stripUnmatchedTailwindSourceMediaCloseFragments(stripTailwindSourceMediaFragments(options.generatorTarget === "weapp" ? removeTailwindV4GeneratedUserCssArtifacts((0, _weapp_tailwindcss_postcss.removeUnsupportedMiniProgramAtRules)(unwrapMiniProgramCascadeLayers(stripTailwindBanners(cleanedSource))), options.generatedSource) : cleanedSource)), { importFallback: options.importFallback })));
+	const userSource = await options.compileAuthorCssFunctions?.(authorSource) ?? authorSource;
 	if (userSource.trim().length === 0) return "";
 	if (isCommentOnlyCss(userSource)) return userSource;
-	if (options.generatorTarget !== "weapp") return userSource;
+	if (options.generatorTarget !== "weapp") return (0, _weapp_tailwindcss_postcss.applyConfiguredCssCalc)(userSource, {
+		cssCalc: options.generatorStyleOptions.cssOptions?.cssCalc ?? options.generatorStyleOptions.cssCalc ?? options.cssUserHandlerOptions.cssOptions?.cssCalc ?? options.cssUserHandlerOptions.cssCalc,
+		customPropertyValues: options.generatorStyleOptions.customPropertyValues ?? options.cssUserHandlerOptions.customPropertyValues,
+		contextCss: typeof options.generatedSource === "string" ? options.generatedSource : void 0
+	});
 	const { css } = await options.styleHandler(userSource, {
 		...options.generatorStyleOptions,
 		...options.cssUserHandlerOptions
 	});
-	const transformedCss = removeTailwindV4GeneratedUserCssArtifacts((0, _weapp_tailwindcss_postcss.removeUnsupportedMiniProgramAtRules)(css));
-	const bareSelectorUserCss = collectBareSelectorUserCss(userSource);
+	const transformedCss = removeTailwindV4GeneratedUserCssArtifacts((0, _weapp_tailwindcss_postcss.removeUnsupportedMiniProgramAtRules)(stripTailwindBanners(css)), options.generatedSource);
+	const bareSelectorUserCss = collectBareSelectorUserCss(userSource, transformedCss);
 	const missingBareSelectorUserCss = bareSelectorUserCss.trim().length > 0 ? (0, _weapp_tailwindcss_postcss.filterExistingCssRules)(transformedCss, bareSelectorUserCss) : "";
 	return missingBareSelectorUserCss.trim().length > 0 ? `${transformedCss}\n${missingBareSelectorUserCss}` : transformedCss;
 }
@@ -2732,6 +2727,11 @@ function normalizeExtendLengthUnits(value) {
 function normalizeTailwindcssRuntimeOptions(options) {
 	return options;
 }
+/** 清除可选字段中的 undefined，再交给引擎候选校验与生成契约。 */
+function resolveRuntimeBareArbitraryValues(options) {
+	const value = resolveTailwindcssOptions(options)?.v4?.bareArbitraryValues;
+	return value && typeof value === "object" ? value.units === void 0 ? {} : { units: value.units } : value;
+}
 //#endregion
 //#region src/utils/object.ts
 function definedEntries(value) {
@@ -3022,11 +3022,11 @@ function normalizeTailwindV4CssPackageImports(css, packageName) {
 	let changed = false;
 	root.walkAtRules((rule) => {
 		if (rule.name !== "import" && rule.name !== "reference") return;
-		const parsed = parseCssImportSpecifier(rule.params);
+		const parsed = (0, _weapp_tailwindcss_postcss.parseCssImportSpecifier)(rule.params);
 		if (!parsed || !importSpecifiers.has(parsed.specifier)) return;
 		const cssEntryPoint = resolvePackageCssEntryPoint(`${parsed.specifier}/index.css`);
 		if (!cssEntryPoint) return;
-		rule.params = rule.params.replace(parsed.raw, quoteCssImportSpecifier(cssEntryPoint, parsed.quote));
+		rule.params = rule.params.replace(parsed.raw, (0, _weapp_tailwindcss_postcss.quoteCssImportSpecifier)(cssEntryPoint, parsed.quote));
 		changed = true;
 	});
 	return changed ? root.toString() : css;
@@ -3080,7 +3080,7 @@ function normalizeTailwindV4CssEntrySources(cssEntries, packageName) {
 		}
 		const base = node_path.default.dirname(normalizedFile);
 		root.walkAtRules("import", (rule) => {
-			const parsed = parseCssImportSpecifier(rule.params);
+			const parsed = (0, _weapp_tailwindcss_postcss.parseCssImportSpecifier)(rule.params);
 			if (!parsed || !parsed.specifier.startsWith(".")) return;
 			const importedFile = resolveCssImportFile(base, parsed.specifier);
 			const resolved = (node_path.default.extname(importedFile) ? [importedFile] : [
@@ -3385,6 +3385,12 @@ Object.defineProperty(exports, "createCssAppend", {
 		return createCssAppend;
 	}
 });
+Object.defineProperty(exports, "createGeneratedThemeDeclarationResolver", {
+	enumerable: true,
+	get: function() {
+		return createGeneratedThemeDeclarationResolver;
+	}
+});
 Object.defineProperty(exports, "createTailwindV4Engine", {
 	enumerable: true,
 	get: function() {
@@ -3631,12 +3637,6 @@ Object.defineProperty(exports, "parseConfigParam", {
 		return parseConfigParam;
 	}
 });
-Object.defineProperty(exports, "parseCssImportSpecifier", {
-	enumerable: true,
-	get: function() {
-		return parseCssImportSpecifier;
-	}
-});
 Object.defineProperty(exports, "parseImportRequest", {
 	enumerable: true,
 	get: function() {
@@ -3655,12 +3655,6 @@ Object.defineProperty(exports, "prependConfigDirective", {
 		return prependConfigDirective;
 	}
 });
-Object.defineProperty(exports, "quoteCssImportSpecifier", {
-	enumerable: true,
-	get: function() {
-		return quoteCssImportSpecifier;
-	}
-});
 Object.defineProperty(exports, "removeMiniProgramInteractiveSelectors", {
 	enumerable: true,
 	get: function() {
@@ -3721,6 +3715,12 @@ Object.defineProperty(exports, "resolveGeneratorRuntimeBranch", {
 		return resolveGeneratorRuntimeBranch;
 	}
 });
+Object.defineProperty(exports, "resolveRuntimeBareArbitraryValues", {
+	enumerable: true,
+	get: function() {
+		return resolveRuntimeBareArbitraryValues;
+	}
+});
 Object.defineProperty(exports, "resolveRuntimeBranch", {
 	enumerable: true,
 	get: function() {