@weapp-tailwindcss/postcss 3.3.4 → 3.3.6

package/README.md

@@ -1,5 +1,7 @@
 # @weapp-tailwindcss/postcss
 
+The `/syntax`, `/transform`, and `/plugin` subpaths separate syntax helpers, CSS transformations, and PostCSS generation orchestration. Existing root exports remain available.
+
 > English | [简体中文](./README.zh-CN.md)
 
 This package is the CSS processing core of weapp-tailwindcss. It handles PostCSS AST transforms, selector compatibility, platform differences, and Tailwind output post-processing for mini programs.
@@ -8,6 +10,14 @@ This package is the CSS processing core of weapp-tailwindcss. It handles PostCSS
 
 For repeated comparisons against one CSS string, `createCssRuleMatcher(baseCss)` provides `contains(css)` and `filter(css)` with reusable, lazy comparison indexes. It preserves the semantics of `containsCssAfterMinify` and `filterExistingCssRules`. Create a new matcher when the base CSS changes; release it after the batch.
 
+## Native compiler
+
+The isolated `@weapp-tailwindcss/postcss/native` entry provides `compileNativeCss(css, options)` for CSS-to-native style translation. It returns rules, variables, and warnings. React Native manifest IDs, Tailwind generation, and runtime integration remain in `@weapp-tailwindcss/react-native`; importing its `/runtime` entry does not load this compiler.
+
+## Experimental transforms
+
+Experimental LightningCSS selector transforms live under `@weapp-tailwindcss/postcss/experimental/lightningcss`. They are not exported from the stable root. The `@weapp-tailwindcss/experimental/lightningcss` facade loads the LightningCSS engine; the PostCSS subpath itself only imports its types. The optional peer is needed only by consumers of these experimental types.
+
 ## Website
 
 For setup guides, configuration references, and framework examples, see the [official weapp-tailwindcss documentation](https://tw.weapp.dev).

package/README.zh-CN.md

@@ -1,5 +1,11 @@
 # @weapp-tailwindcss/postcss
 
+`/syntax`、`/transform`、`/plugin` 子路径分别提供语法能力、CSS 转换和 PostCSS 生成编排。原根导出保持兼容。
+
+独立入口 `@weapp-tailwindcss/postcss/native` 提供 `compileNativeCss(css, options)`，将 CSS 转成原生样式规则、变量和告警。React Native manifest ID、Tailwind 生成与运行时集成仍由 `@weapp-tailwindcss/react-native` 负责；导入其 `/runtime` 不会加载 CSS 编译器。
+
+LightningCSS 实验转换放在 `@weapp-tailwindcss/postcss/experimental/lightningcss`，不由稳定根入口导出。实验包的原入口负责加载引擎，PostCSS 子入口只引用 LightningCSS 类型；可选 peer 仅供实验类型的消费方使用。
+
 > [English](./README.md) | 简体中文
 
 这个包是 weapp-tailwindcss 的 CSS 处理核心，负责小程序端的 PostCSS AST 转换、选择器兼容、平台差异处理和 Tailwind 输出后处理。

package/dist/compat/author-selector.d.ts

@@ -0,0 +1,2 @@
+/** 保留作者选择器在变体展开后增加前缀、伪类或主题条件的规则。 */
+export declare function createAuthorSelectorMatcher(selectors: Iterable<string>): (selector: string) => boolean;

package/dist/compat/index.d.ts

@@ -0,0 +1,57 @@
+export { createAuthorSelectorMatcher } from './author-selector.js';
+export { type DynamicColorMixAlphaProtection, type DynamicColorMixAlphaProtectionOptions, type ModernColorValueNormalization, normalizeModernColorValue, protectDynamicColorMixAlpha, protectDynamicVarFallbacks } from './color-mix.js';
+export { collectDedupedPostTransformCompatCss, collectGeneratedSelectors, inheritLegacyUnitConvertedDeclarations, normalizeCompatSelectors, removeGeneratedSelectorCompatCss, removeTailwindApplyRules } from './legacy-css/index.js';
+export { normalizeLegacyCompatCssSource, removeMiniProgramContainerCompatCss } from './legacy-css/source-cleanup.js';
+export { transformLynxCssCompat } from './lynx-css.js';
+export { consumeCascadeLayers, finalizeMiniProgramCss, type FinalizeMiniProgramCssOptions, finalizeMiniProgramCssRoot, finalizeMiniProgramCssStructure, hasEmptyCssBlockCandidate, hasMiniProgramCssSpecificityPlaceholders, hoistTailwindPreflightBase, normalizeMiniProgramGeneratedCssForPostcss, pruneMiniProgramGeneratedCss, removeEmptyAtRules, removeEmptyRules, removeUnsupportedAtSupports, removeUnsupportedCascadeLayers, removeUnsupportedMiniProgramAtRules, removeUnusedMiniProgramContentInit, repairTrailingUnclosedTailwindSourceMedia, stripMiniProgramCssSpecificityPlaceholders, unwrapUnsupportedCascadeLayers } from './mini-program-css/index.js';
+export { normalizeMiniProgramGeneratorCssSource, normalizeMiniProgramImportShell, removeMiniProgramOutputImports, removeSelfMiniProgramOutputImports } from './mini-program-css/output-import-shell.js';
+export { normalizeMiniProgramPrefixedDeclaration, removeUnsupportedMiniProgramPrefixedAtRule } from './mini-program-prefixes.js';
+export { hasNonCommentCss, isCssImportOnly, removeCommentOnlyAtRules, restoreProcessedCssImports } from './processed-css/cleanup.js';
+export { composeProcessedCssSources } from './processed-css/composition.js';
+export { removeTailwindEntryDirectivesFromCss } from './processed-css/entry-directives.js';
+export { collectImportedCssFiles, isStyleImportRequest, normalizeInjectableCssWithImports } from './processed-css/imports.js';
+export { removeCssCoveredByRootStyleSources, removeScopedTailwindPreflightCss } from './scoped-css/cleanup.js';
+export { collectRootScopedComparableCssCoverage, type ComparableCssCoverage, isRuleCoveredByRootCss } from './scoped-css/coverage.js';
+export { removeCssRulesCoveredBySources } from './scoped-css/covered-rules.js';
+export { hasScopedMiniProgramTailwindContentInitRule, hasScopedUniAppWebTailwindPreflightRule, hasUnscopedMiniProgramTailwindPreflightRule, hasVueScopedAttr, isLikelyTailwindGlobalRule, isLikelyTailwindLayerOrderAtRule, isLikelyTailwindPropertyAtRule, isScopedMiniProgramTailwindContentInitRule, isScopedUniAppWebTailwindPreflightRule, isScopedUniversalTailwindPreflightRule, isUnscopedMiniProgramTailwindPreflightRule, normalizeCssSignatureValue } from './scoped-css/predicates.js';
+export { injectTailwindDirectives, type TailwindDirectiveInjectionOptions } from './tailwind-directive-injection.js';
+export { convertTailwindcssRpxDeclarationsToRem, convertTailwindcssRpxDeclarationToRem, convertTailwindcssRpxValueToRem, normalizeTailwindcssRpxDeclaration, normalizeTailwindcssRpxDeclarations, normalizeTailwindcssWebRpxDeclarations, type TailwindcssRpxToRemOptions } from './tailwindcss-rpx.js';
+export { normalizeTailwindcssV4InfinityCalcCss } from './tailwindcss-v4.js';
+export { compileTailwindAuthorFunctions, createTailwindAuthorFunctionProbe } from './tailwindcss-v4/author-functions.js';
+export { normalizeTailwindV4GeneratedUrlValues, transformTailwindV4CssToWeapp, transformTailwindV4GeneratedCss, transformTailwindV4WebRpxCss } from './tailwindcss-v4/generated-output.js';
+export { normalizeTailwindcssV4InfinityRadiusCss } from './tailwindcss-v4/infinity-radius.js';
+export { rewriteTailwindPackageImportStatements } from './tailwindcss-v4/package-import-statements.js';
+export { includesTailwindV4PreflightDirective, isTailwindV4CssImportParam, isTailwindV4PreflightImportParam } from './tailwindcss-v4/preflight-imports.js';
+export { normalizeRpxLengthCandidates, restoreRpxLengthCandidates, restoreRpxLengthCssSelectors } from './tailwindcss-v4/rpx-candidates.js';
+export { insertTailwindThemeCss } from './tailwindcss-v4/theme-injection.js';
+export { normalizeTailwindV4RuntimeCss, removeTailwindV4PreflightImports, removeUnsupportedThemeVendorKeyframes } from './tailwindcss-v4/theme-source.js';
+export { filterTailwindV4ApplyOnlyGeneratedCss, normalizeEmptyTailwindCustomVariants } from './tailwindcss-v4/user-css/apply-only.js';
+export { createTailwindV4SourceReferenceSource, hasTailwindApplyContextDirective } from './tailwindcss-v4/user-css/apply-reference.js';
+export { removeTailwindApplyAtRules, removeTailwindSourceMediaBlocks, terminateTailwindSourceAtRulesBeforeNextDirective } from './tailwindcss-v4/user-css/at-rules.js';
+export { collectRawSourceClassSelectors, normalizeCssClassSelector } from './tailwindcss-v4/user-css/class-selectors.js';
+export { hasLocalCssImport, hasTailwindApplyDirective, hasTailwindNonRootGenerationDirectives, hasTailwindRootDirectives, hasTailwindRootImportDirectives, hasTailwindSourceDirectives, normalizeTailwindConfigDirectives, normalizeTailwindSourceDirectives, normalizeTailwindSourceForGenerator, parseImportRequest, removeTailwindSourceDirectives, resolveCssEntrySource } from './tailwindcss-v4/user-css/directives/index.js';
+export { extractConfigRequestFromSource, extractTailwindDirectiveLines, extractTailwindSourceForPostcssFallback } from './tailwindcss-v4/user-css/directives/fallback.js';
+export { composeFrameworkProcessedCss } from './tailwindcss-v4/user-css/framework-composition.js';
+export { normalizeFrameworkProcessedUserCss } from './tailwindcss-v4/user-css/framework-source.js';
+export { createGeneratedThemeDeclarationResolver, type GeneratedThemeDeclarationResolver, removeBalancedAtRuleBlock, removeTailwindV4GeneratedUserCssArtifacts, removeTailwindV4GeneratorAtRulesFallback, TAILWIND_V4_GENERATOR_AT_RULES } from './tailwindcss-v4/user-css/generated-cleanup.js';
+export { isCssAlreadyRepresentedByMarkers } from './tailwindcss-v4/user-css/identity.js';
+export { createCssAppend, GENERATOR_PLACEHOLDER_MARKER_GLOBAL_RE, GENERATOR_PLACEHOLDER_MARKER_RE, hasTailwindGeneratedCss, hasTailwindGeneratedCssMarkers, removeDuplicatedViteMarkers, removeTailwindGeneratedCssByBanner, splitGeneratorPlaceholderCssBySourceOrder, splitTailwindGeneratedCssByBanner, splitTailwindV4GeneratedCss, splitTailwindV4GeneratedCssBySourceOrder, stripGeneratorPlaceholderMarkers, stripTailwindBanner, stripTailwindBannerComments, stripTailwindBanners, TAILWIND_BANNER_GLOBAL_RE, TAILWIND_BANNER_PREFIX_RE, TAILWIND_BANNER_RE, TAILWIND_GENERATED_CSS_MARKER_RE, TAILWIND_V4_BANNER_RE, VITE_MARKER_RE } from './tailwindcss-v4/user-css/markers.js';
+export { deduplicateGeneratedCssRules } from './tailwindcss-v4/user-css/rule-deduplication.js';
+export { preferScopedGeneratedCssRules, preferScopedGeneratedCssRulesRoot } from './tailwindcss-v4/user-css/scoped-rules.js';
+export { collectBareSelectorUserCss, isCommentOnlyCss, removeMiniProgramHoverSelectors, removeMiniProgramInteractiveSelectors, type RemoveMiniProgramInteractiveSelectorsOptions, removeProcessedMiniProgramUnsupportedCss, removeTailwindV4GeneratorAtRules, stripTailwindSourceMediaFragments, stripUnmatchedTailwindSourceMediaCloseFragments, unwrapMiniProgramCascadeLayers } from './tailwindcss-v4/user-css/source-fragments.js';
+export { transformGeneratorUserCss } from './tailwindcss-v4/user-css/transform.js';
+export { extractMarkedUserLayerComponentsCss, mergeMarkedUserLayerComponentsCss, reorderMarkedUserLayerComponentsCss, wrapUserLayerComponentsCss } from './tailwindcss-v4/user-css/user-layer-order.js';
+export { analyzeApplyOnlySource, collectApplyOnlySourceSelectors, extractGeneratedCssForUserLayerSelectors, hasOnlyApplyBackedSourceRules, hasUserCssLayerBlocks, isEmptyCustomVariantBlock, normalizeGeneratedSelector, removeCssComments, splitUserCssLayerBlocks } from './tailwindcss-v4/user-css/user-layers.js';
+export { normalizeUniAppXImportantApplyForSass, restoreUniAppXImportantApplyMarker, UNI_APP_X_IMPORTANT_APPLY_MARKER } from './uni-app-x.js';
+export { isTailwindRuntimePropertyRule, retainUniAppXAuthorApplyCss } from './uni-app-x-author-apply.js';
+export { createUniAppXBorderPreflight, hoistUniAppXBorderPreflight, UNI_APP_X_BORDER_PREFLIGHT_CLASS } from './uni-app-x-border.js';
+export { collectCssApplyUtilities, type CssClassStyleValue, cssToClassStyleValue, expandCssApplySourcesToStyleValue, normalizeUniAppXStyleProperty, normalizeUniAppXStyleValue } from './uni-app-x-style-value.js';
+export { collectCssReferenceDirectives, createUniAppXHarmonyApplyGeneratorSource } from './uni-app-x/apply-source.js';
+export { createUniAppXHarmonyApplyCssExpander } from './uni-app-x/harmony-apply.js';
+export { rewriteUniAppXStyleReferences } from './uni-app-x/reference-paths.js';
+export { type NormalizedWebCssCompatOptions, normalizeWebCssCompatOptions, transformWebCssCompat, transformWebCssSafeSelectors } from './web-css.js';
+export { collectWebpackBareSelectorUserCss } from './webpack-css/bare-selectors.js';
+export { isOnlyWebpackTailwindGeneratedPreflightCss, parseWebpackCssLayerNames, removeWebpackTailwindGeneratedAssetCss, stripTrailingLineWhitespace } from './webpack-css/generated-cleanup.js';
+export { collectGeneratedCssClassCandidates, collectWebpackAssetUserCssMarkers, collectWebpackCssRuleIdentityMarkers, hasAdditionalWebpackAssetUserCssMarkers, unescapeCssIdentifier } from './webpack-css/identity.js';
+export { dedupeMiniProgramPreflightSelectorRules, ensureWebpackMiniProgramTwContentInit, hasMiniProgramPreflightSelector, removeMiniProgramPreflightSelectorRule, removeTailwindV4StandaloneHostPreflightRule } from './webpack-css/preflight.js';
+export { hasWebpackTailwindSourceDirectives, isWebpackCssSourceRepresentedInAsset, isWebpackTailwindImportRequest, normalizeWebpackUserCssFallbackSource, removeWebpackGeneratorNonTailwindImports, removeWebpackUserCssFallbackImports } from './webpack-css/user-source.js';

package/dist/compat/legacy-css/apply.d.ts

@@ -0,0 +1,2 @@
+/** 删除兼容源中的 `@apply` 规则及其空包装 at-rule。 */
+export declare function removeTailwindApplyRules(rawSource: string): string;

package/dist/compat/legacy-css/dedupe.d.ts

@@ -0,0 +1,2 @@
+export declare function removeGeneratedSelectorCompatCss(css: string, generatedCss: string): string;
+export declare function collectDedupedPostTransformCompatCss(css: string, generatedCss: string): string;

package/dist/compat/legacy-css/index.d.ts

@@ -0,0 +1,4 @@
+export { removeTailwindApplyRules } from './apply.js';
+export { collectDedupedPostTransformCompatCss, removeGeneratedSelectorCompatCss } from './dedupe.js';
+export { collectGeneratedSelectors, normalizeCompatSelectors } from './selectors.js';
+export { inheritLegacyUnitConvertedDeclarations } from './units.js';

package/dist/compat/legacy-css/selectors.d.ts

@@ -0,0 +1,7 @@
+import type { Rule } from 'postcss';
+export declare function normalizeCompatSelectors(selector: string): string[];
+export declare function getRuleCompatSelectorKeys(rule: Rule): string[];
+export declare function hasUtilityClassSelector(selector: string): boolean;
+export declare function isCustomPropertyOnlyRule(rule: Rule): boolean;
+export declare function isPseudoContentInitRule(rule: Rule): boolean;
+export declare function collectGeneratedSelectors(css: string): Set<string>;

package/dist/compat/legacy-css/source-cleanup.d.ts

@@ -0,0 +1,2 @@
+export declare function removeMiniProgramContainerCompatCss(css: string): string;
+export declare function normalizeLegacyCompatCssSource(rawSource: string): string;

package/dist/compat/legacy-css/units.d.ts

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

package/dist/compat/mini-program-css/class-presence.d.ts

@@ -0,0 +1,3 @@
+import type { Root } from 'postcss';
+/** 将已有类约束上的 class 存在条件等价改写为重复类，保留框架提权语义。 */
+export declare function normalizeClassPresenceSelectors(root: Root): boolean;

package/dist/compat/mini-program-css/content-init.d.ts

@@ -0,0 +1,3 @@
+import type { Root } from 'postcss';
+/** 移除候选裁剪后失去消费者的全局 content 初始化，保留用户类规则。 */
+export declare function removeUnusedMiniProgramContentInit(root: Root): boolean;

package/dist/compat/mini-program-css/empty-blocks.d.ts

@@ -0,0 +1,3 @@
+export declare function hasEmptyCssBlockCandidate(css: string): boolean;
+/** 在小程序样式进入最终产物图时规范化等价选择器并递归清理空 CSS 块。 */
+export declare function finalizeMiniProgramCssStructure(css: string): string;

package/dist/compat/mini-program-css/index.d.ts

@@ -1,6 +1,8 @@
 export { removeUnsupportedAtSupports, removeUnsupportedCascadeLayers, removeUnsupportedMiniProgramAtRules, unwrapUnsupportedCascadeLayers, } from './at-rules.js';
 export { consumeCascadeLayers } from './cascade-layers.js';
+export { removeUnusedMiniProgramContentInit } from './content-init.js';
 export { repairTrailingUnclosedTailwindSourceMedia } from './directives.js';
+export { finalizeMiniProgramCssStructure, hasEmptyCssBlockCandidate, } from './empty-blocks.js';
 export { finalizeMiniProgramCss, type FinalizeMiniProgramCssOptions, finalizeMiniProgramCssRoot, hoistTailwindPreflightBase, } from './finalize.js';
 export { normalizeMiniProgramGeneratedCssForPostcss, pruneMiniProgramGeneratedCss, type PruneMiniProgramGeneratedCssOptions, } from './prune-generated.js';
 export { hasMiniProgramCssSpecificityPlaceholders, removeEmptyAtRules, removeEmptyRules, stripMiniProgramCssSpecificityPlaceholders, } from './root-cleanups.js';

package/dist/compat/mini-program-css/output-import-shell.d.ts

@@ -0,0 +1,8 @@
+export declare function normalizeMiniProgramImportShell(css: string, output?: {
+    outputFile: string;
+    outputFiles: Iterable<string>;
+    cssOnly?: boolean;
+}): string;
+export declare function removeSelfMiniProgramOutputImports(css: string, outputFile: string): string;
+export declare function removeMiniProgramOutputImports(css: string): string;
+export declare function normalizeMiniProgramGeneratorCssSource(css: string, outputFile?: string | undefined, outputFiles?: Iterable<string>): string;

package/dist/compat/native/compile.d.ts

@@ -0,0 +1,2 @@
+import type { CompileNativeStylesheetOptions, NativeCssStylesheet } from './types.js';
+export declare function compileNativeCss(css: string, options?: CompileNativeStylesheetOptions): NativeCssStylesheet;

package/dist/compat/native/properties.d.ts

@@ -0,0 +1,15 @@
+export declare function propertyName(property: string): string;
+export declare function expandDeclaration(property: string, value: string, variables: Record<string, string>): {
+    [k: string]: number | undefined;
+} | {
+    shadowOpacity?: number;
+    shadowOffset: {
+        width: any;
+        height: any;
+    };
+    shadowRadius: any;
+    shadowColor: string;
+} | {
+    borderColor?: string;
+    borderWidth?: any;
+} | undefined;

package/dist/compat/native/selectors.d.ts

@@ -0,0 +1,8 @@
+import type { AtRule } from 'postcss';
+import type { NativeStyleRule } from './types.js';
+export declare function splitClassName(className: string): string[];
+export declare function baseClassName(className: string): string | undefined;
+export declare function unsupportedVariant(className: string): string | undefined;
+export declare function walkClasses(selector: string): string[];
+export declare function variantForClass(className: string): Pick<NativeStyleRule, 'colorScheme' | 'platform'>;
+export declare function atRuleVariant(node: AtRule | undefined): Pick<NativeStyleRule, 'colorScheme' | 'platform'>;

package/dist/compat/native/types.d.ts

@@ -0,0 +1,23 @@
+export type NativePlatform = 'android' | 'ios' | 'native' | 'web';
+export interface NativeStyleRule {
+    style: Record<string, unknown>;
+    colorScheme?: 'dark' | undefined;
+    platform?: NativePlatform | undefined;
+    important?: boolean | undefined;
+    order?: number | undefined;
+    id?: string | undefined;
+}
+export interface NativeCompilerWarning {
+    className?: string | undefined;
+    property?: string | undefined;
+    message: string;
+}
+export interface CompileNativeStylesheetOptions {
+    classSet?: Iterable<string> | undefined;
+    ignorePreflight?: boolean | undefined;
+}
+export interface NativeCssStylesheet {
+    rules: Record<string, NativeStyleRule[]>;
+    variables: Record<string, string>;
+    warnings: NativeCompilerWarning[];
+}

package/dist/compat/processed-css/cleanup.d.ts

@@ -0,0 +1,4 @@
+export declare function hasNonCommentCss(css: string): boolean;
+export declare function restoreProcessedCssImports(source: string, filtered: string, miniProgram?: boolean): string;
+export declare function removeCommentOnlyAtRules(css: string): string;
+export declare function isCssImportOnly(css: string): boolean;

package/dist/compat/processed-css/composition.d.ts

@@ -0,0 +1,6 @@
+interface ProcessedCssSource {
+    css: string;
+    processed: boolean;
+}
+export declare function composeProcessedCssSources(...sources: Array<ProcessedCssSource | undefined>): ProcessedCssSource | undefined;
+export {};

package/dist/compat/processed-css/entry-directives.d.ts

@@ -0,0 +1 @@
+export declare function removeTailwindEntryDirectivesFromCss(css: string, preserveCssLayers?: boolean): string;

package/dist/compat/processed-css/imports.d.ts

@@ -0,0 +1,8 @@
+type CssImportResolver = (request: string) => string | undefined;
+export declare function isStyleImportRequest(request: string | undefined): boolean;
+export declare function normalizeInjectableCssWithImports(css: string, miniProgram: boolean, resolveImport: CssImportResolver): {
+    css: string;
+    importedStyleFiles: Set<string>;
+};
+export declare function collectImportedCssFiles(css: string, resolveImport: CssImportResolver): Set<string>;
+export {};

package/dist/compat/scoped-css/cleanup.d.ts

@@ -0,0 +1,4 @@
+export declare function removeScopedTailwindPreflightCss(css: string, options?: {
+    preserveRuntimeProperties?: boolean;
+}): string;
+export declare function removeCssCoveredByRootStyleSources(css: string, rootSources: string[]): string;

package/dist/compat/scoped-css/coverage.d.ts

@@ -0,0 +1,10 @@
+import postcss from 'postcss';
+export declare function createAtRuleCoverageKey(atRule: postcss.AtRule): string;
+export declare function collectRootScopedComparableCssCoverage(cssSources: string[]): {
+    rules: Set<string>;
+    atRules: Set<string>;
+    declarationsBySelector: Map<string, Set<string>>;
+    normalizedRuleCss: Set<string>;
+};
+export type ComparableCssCoverage = ReturnType<typeof collectRootScopedComparableCssCoverage>;
+export declare function isRuleCoveredByRootCss(rule: postcss.Rule, coverage: ReturnType<typeof collectRootScopedComparableCssCoverage>): boolean;

package/dist/compat/scoped-css/covered-rules.d.ts

@@ -0,0 +1,4 @@
+import type { ComparableCssCoverage } from './coverage.js';
+export declare function removeCssRulesCoveredBySources(css: string, sources: string[], options?: {
+    exactOnly?: boolean | undefined;
+}, preparedCoverage?: ComparableCssCoverage | undefined): string;

package/dist/compat/scoped-css/predicates.d.ts

@@ -0,0 +1,13 @@
+import type { AtRule, Rule } from 'postcss';
+export declare function hasVueScopedAttr(value: string): boolean;
+export declare function normalizeCssSignatureValue(value: string): string;
+export declare function isScopedUniversalTailwindPreflightRule(rule: Rule): boolean;
+export declare function isScopedUniAppWebTailwindPreflightRule(rule: Rule): boolean;
+export declare function hasScopedUniAppWebTailwindPreflightRule(css: string): boolean;
+export declare function isLikelyTailwindGlobalRule(rule: Rule): boolean;
+export declare function isLikelyTailwindPropertyAtRule(atRule: AtRule): boolean;
+export declare function isLikelyTailwindLayerOrderAtRule(atRule: AtRule): boolean;
+export declare function isUnscopedMiniProgramTailwindPreflightRule(rule: Rule): boolean;
+export declare function isScopedMiniProgramTailwindContentInitRule(rule: Rule): boolean;
+export declare function hasUnscopedMiniProgramTailwindPreflightRule(css: string): boolean;
+export declare function hasScopedMiniProgramTailwindContentInitRule(css: string): boolean;

package/dist/compat/tailwind-directive-injection.d.ts

@@ -0,0 +1,8 @@
+import type { Root } from 'postcss';
+export interface TailwindDirectiveInjectionOptions {
+    directiveParams: readonly string[];
+    insertAfterAtRulesNames: readonly string[];
+    matchesComment: (text: string) => boolean;
+}
+/** 只插入缺失指令；配置、输入过滤和模板依赖由调用方管理。 */
+export declare function injectTailwindDirectives(root: Root, options: TailwindDirectiveInjectionOptions): void;

package/dist/compat/tailwindcss-v4/author-functions.d.ts

@@ -0,0 +1,7 @@
+/** 将编译期函数值交给当前 Tailwind 编译上下文处理，保留声明的顺序与作用域。 */
+export declare function compileTailwindAuthorFunctions(css: string, compileValues: (values: string[]) => Promise<string[]>): Promise<string>;
+/** 用唯一选择器承载待编译的值，避免依靠作者选择器或属性名猜测对应关系。 */
+export declare function createTailwindAuthorFunctionProbe(values: string[], selector: string): {
+    css: string;
+    read(compiledCss: string): string[];
+};

package/dist/compat/tailwindcss-v4/generated-output.d.ts

@@ -0,0 +1,5 @@
+import type { IStyleHandlerOptions } from '../../types.js';
+export declare function normalizeTailwindV4GeneratedUrlValues(css: string): string;
+export declare function transformTailwindV4CssToWeapp(css: string, options?: Partial<IStyleHandlerOptions>): Promise<string>;
+export declare function transformTailwindV4WebRpxCss(css: string): string;
+export declare function transformTailwindV4GeneratedCss(css: string, target: 'weapp' | 'web', options?: Partial<IStyleHandlerOptions>, webRpxCompatibility?: boolean): Promise<string>;

package/dist/compat/tailwindcss-v4/package-import-statements.d.ts

@@ -0,0 +1 @@
+export declare function rewriteTailwindPackageImportStatements(code: string, resolve: (specifier: string) => string | null | undefined): string | undefined;

package/dist/compat/tailwindcss-v4/preflight-imports.d.ts

@@ -0,0 +1,3 @@
+export declare function isTailwindV4CssImportParam(params: string): boolean;
+export declare function isTailwindV4PreflightImportParam(params: string): boolean;
+export declare function includesTailwindV4PreflightDirective(css: string): boolean;

package/dist/compat/tailwindcss-v4/rpx-candidates.d.ts

@@ -0,0 +1,6 @@
+export declare function normalizeRpxLengthCandidates(candidates: Iterable<string>): {
+    candidates: Set<string>;
+    restoreCandidates: Map<string, string>;
+};
+export declare function restoreRpxLengthCandidates(candidates: Iterable<string>, restoreCandidates: ReadonlyMap<string, string>): Set<string>;
+export declare function restoreRpxLengthCssSelectors(css: string, restoreCandidates: ReadonlyMap<string, string>): string;

package/dist/compat/tailwindcss-v4/theme-injection.d.ts

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

package/dist/compat/tailwindcss-v4/theme-source.d.ts

@@ -0,0 +1,9 @@
+import type { Root } from 'postcss';
+/** 从小程序入口 CSS 中移除 Tailwind v4 preflight import。 */
+export declare function removeTailwindV4PreflightImports(css: string): string;
+/** 删除 `@theme` 内不被小程序接受的厂商前缀 keyframes。 */
+export declare function removeUnsupportedThemeVendorKeyframes(css: string): string;
+/** 复用已有 AST，避免运行时样式清理重复解析。 */
+export declare function removeUnsupportedThemeVendorKeyframesRoot(root: Root): boolean;
+/** loader 调用端决定是否需要清理；非法 CSS 沿用原有抛错行为。 */
+export declare function normalizeTailwindV4RuntimeCss(css: string): string;

package/dist/compat/tailwindcss-v4/user-css/apply-only.d.ts

@@ -0,0 +1,6 @@
+export declare function normalizeEmptyTailwindCustomVariants(css: string): string;
+export declare function filterTailwindV4ApplyOnlyGeneratedCss(css: string, source: string, options?: {
+    preserveVariables?: boolean | undefined;
+    preserveRuntimeProperties?: boolean | undefined;
+    preferScopedRules?: boolean | undefined;
+}): string;

package/dist/compat/tailwindcss-v4/user-css/apply-reference.d.ts

@@ -0,0 +1,4 @@
+export declare function hasTailwindApplyContextDirective(css: string): boolean;
+export declare function createTailwindV4SourceReferenceSource(css: string, sourceOptions: {
+    packageName?: string | undefined;
+}, referenceDirective?: string): string;

package/dist/compat/tailwindcss-v4/user-css/at-rules.d.ts

@@ -0,0 +1,3 @@
+export declare function removeTailwindSourceMediaBlocks(source: string): string;
+export declare function terminateTailwindSourceAtRulesBeforeNextDirective(source: string): string;
+export declare function removeTailwindApplyAtRules(source: string): string;

package/dist/compat/tailwindcss-v4/user-css/class-selectors.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeCssClassSelector(value: string): string;
+export declare function collectRawSourceClassSelectors(rawSource: string): Set<string>;

package/dist/compat/tailwindcss-v4/user-css/directives/entry-source.d.ts

@@ -0,0 +1,9 @@
+export declare function resolveCssEntrySource(rawSource: string, base: string, options?: {
+    removeConfig?: boolean;
+    importFallback?: boolean;
+}): {
+    css: string;
+    config: string | undefined;
+    configRequest: string | undefined;
+    base: string;
+} | undefined;

package/dist/compat/tailwindcss-v4/user-css/directives/fallback.d.ts

@@ -0,0 +1,11 @@
+interface TailwindDirectiveOptions {
+    importFallback?: boolean | undefined;
+}
+export declare function extractTailwindDirectiveLines(rawSource: string, options?: TailwindDirectiveOptions & {
+    removeConfig?: boolean;
+}): string[];
+export declare function extractTailwindSourceForPostcssFallback(rawSource: string, options?: TailwindDirectiveOptions & {
+    removeConfig?: boolean;
+}): string | undefined;
+export declare function extractConfigRequestFromSource(rawSource: string): string | undefined;
+export {};

package/dist/compat/tailwindcss-v4/user-css/directives/index.d.ts

@@ -0,0 +1,2 @@
+export { resolveCssEntrySource } from './entry-source.js';
+export { hasLocalCssImport, hasTailwindApplyDirective, hasTailwindNonRootGenerationDirectives, hasTailwindRootDirectives, hasTailwindRootImportDirectives, hasTailwindSourceDirectives, normalizeTailwindConfigDirectives, normalizeTailwindSourceDirectives, normalizeTailwindSourceForGenerator, parseImportRequest, removeTailwindSourceDirectives, } from './shared.js';

package/dist/compat/tailwindcss-v4/user-css/directives/shared.d.ts

@@ -0,0 +1,26 @@
+import { postcss } from '../../../../postcss-runtime.js';
+interface TailwindDirectiveOptions {
+    importFallback?: boolean | undefined;
+    preserveApplyContext?: boolean | undefined;
+}
+interface TailwindGenerationDirectiveOptions extends TailwindDirectiveOptions {
+    ignoreLayer?: boolean | undefined;
+}
+export declare function parseImportRequest(params: string): string | undefined;
+export declare function hasLocalCssImport(rawSource: string): boolean;
+export declare function parseConfigRequest(params: string): string | undefined;
+export declare function normalizeTailwindImportAtRules(root: postcss.Root, options?: TailwindDirectiveOptions): boolean;
+export declare function resolveConfigPath(base: string, configPath: string): string | undefined;
+export declare function normalizeTailwindConfigDirectives(rawSource: string, base: string): string;
+export declare function hasPreprocessorOnlySyntax(rawSource: string): boolean;
+export declare function normalizeTailwindSourceForGenerator(rawSource: string, options?: TailwindDirectiveOptions): string;
+export declare function normalizeTailwindSourceDirectives(rawSource: string, options?: TailwindDirectiveOptions): string;
+export declare function hasGeneratedCssArtifacts(rawSource: string): boolean;
+export declare function isTailwindGenerationDirective(node: postcss.Node, options?: TailwindGenerationDirectiveOptions): boolean;
+export declare function removeTailwindSourceDirectives(rawSource: string, options?: TailwindDirectiveOptions): string;
+export declare function hasTailwindSourceDirectives(rawSource: string, options?: TailwindDirectiveOptions): boolean;
+export declare function hasTailwindNonRootGenerationDirectives(rawSource: string, options?: TailwindDirectiveOptions): boolean;
+export declare function hasTailwindRootImportDirectives(rawSource: string, options?: TailwindDirectiveOptions): boolean;
+export declare function hasTailwindRootDirectives(rawSource: string, options?: TailwindDirectiveOptions): boolean;
+export declare function hasTailwindApplyDirective(rawSource: string): boolean;
+export {};

package/dist/compat/tailwindcss-v4/user-css/framework-composition.d.ts

@@ -0,0 +1,2 @@
+/** 保留生成侧已确定的层位置；框架侧重复选择器及其间的覆盖区间按原顺序恢复。 */
+export declare function composeFrameworkProcessedCss(before: string, generated: string, after: string): string;

package/dist/compat/tailwindcss-v4/user-css/framework-source.d.ts

@@ -0,0 +1 @@
+export declare function normalizeFrameworkProcessedUserCss(source: string): string;

package/dist/compat/tailwindcss-v4/user-css/generated-cleanup.d.ts

@@ -0,0 +1,7 @@
+export declare const TAILWIND_V4_GENERATOR_AT_RULES: Set<string>;
+export declare function removeBalancedAtRuleBlock(source: string, atRuleStart: number): string;
+export declare function removeTailwindV4GeneratorAtRulesFallback(source: string): string;
+export type GeneratedThemeDeclarationResolver = () => ReadonlySet<string>;
+/** 同一轮框架恢复共享声明索引；只有遇到根变量时才解析生成产物。 */
+export declare function createGeneratedThemeDeclarationResolver(source: string): GeneratedThemeDeclarationResolver;
+export declare function removeTailwindV4GeneratedUserCssArtifacts(source: string, generatedSource?: string | GeneratedThemeDeclarationResolver): string;

package/dist/compat/tailwindcss-v4/user-css/identity.d.ts

@@ -0,0 +1 @@
+export declare function isCssAlreadyRepresentedByMarkers(css: string, source: string): boolean;

package/dist/compat/tailwindcss-v4/user-css/markers.d.ts

@@ -0,0 +1,32 @@
+import type postcss from 'postcss';
+export declare const TAILWIND_V4_BANNER_RE: RegExp;
+export declare const TAILWIND_GENERATED_CSS_MARKER_RE: RegExp;
+export declare const GENERATOR_PLACEHOLDER_MARKER_RE: RegExp;
+export declare const GENERATOR_PLACEHOLDER_MARKER_GLOBAL_RE: RegExp;
+export declare const TAILWIND_BANNER_PREFIX_RE: RegExp;
+export declare const TAILWIND_BANNER_RE: RegExp;
+export declare const TAILWIND_BANNER_GLOBAL_RE: RegExp;
+export declare const VITE_MARKER_RE: RegExp;
+export declare function removeDuplicatedViteMarkers(css: string, baseCss: string): string;
+export declare function createCssAppend(base: string, extra: string): string;
+export declare function splitTailwindV4GeneratedCss(rawSource: string, rawTailwindCss: string): string | undefined;
+export declare function splitTailwindV4GeneratedCssBySourceOrder(rawSource: string, rawTailwindCss: string): {
+    before: string;
+    after: string;
+} | undefined;
+export declare function splitGeneratorPlaceholderCssBySourceOrder(rawSource: string, rawTailwindCss?: string): {
+    before: string;
+    after: string;
+} | undefined;
+export declare function removeTailwindGeneratedCssByBanner(rawSource: string): string | undefined;
+export declare function splitTailwindGeneratedCssByBanner(rawSource: string, start?: number): {
+    before: string;
+    after: string;
+} | undefined;
+export declare function stripTailwindBanner(css: string): string;
+export declare function stripTailwindBanners(css: string): string;
+/** 仅移除 AST 中的 Tailwind 版权注释，保留其它注释和声明字面量。 */
+export declare function stripTailwindBannerComments(root: postcss.Root | postcss.Document): void;
+export declare function stripGeneratorPlaceholderMarkers(css: string): string;
+export declare function hasTailwindGeneratedCss(rawSource: string): boolean;
+export declare function hasTailwindGeneratedCssMarkers(rawSource: string): boolean;

package/dist/compat/tailwindcss-v4/user-css/rule-deduplication.d.ts

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

package/dist/compat/tailwindcss-v4/user-css/scoped-rules.d.ts

@@ -0,0 +1,4 @@
+import { postcss } from '../../../postcss-runtime.js';
+/** 复用调用方 AST；索引仅在本次调用内存活，不跨样式变更缓存。 */
+export declare function preferScopedGeneratedCssRulesRoot(root: postcss.Root): void;
+export declare function preferScopedGeneratedCssRules(css: string): string;

package/dist/compat/tailwindcss-v4/user-css/source-fragments.d.ts

@@ -0,0 +1,15 @@
+import type { IStyleHandlerOptions } from '../../../types.js';
+export declare function removeTailwindV4GeneratorAtRules(source: string): string;
+export declare function isCommentOnlyCss(source: string): boolean;
+export interface RemoveMiniProgramInteractiveSelectorsOptions {
+    active?: boolean | undefined;
+    hover?: boolean | undefined;
+    focus?: boolean | undefined;
+}
+export declare function removeMiniProgramInteractiveSelectors(source: string, options?: RemoveMiniProgramInteractiveSelectorsOptions): string;
+export declare function removeMiniProgramHoverSelectors(source: string, enabled?: boolean | undefined): string;
+export declare function removeProcessedMiniProgramUnsupportedCss(source: string, options: Partial<IStyleHandlerOptions>): string;
+export declare function unwrapMiniProgramCascadeLayers(source: string): string;
+export declare function collectBareSelectorUserCss(source: string, transformedCss?: string): string;
+export declare function stripTailwindSourceMediaFragments(source: string): string;
+export declare function stripUnmatchedTailwindSourceMediaCloseFragments(source: string): string;

package/dist/compat/tailwindcss-v4/user-css/transform.d.ts

@@ -0,0 +1,14 @@
+import type { IStyleHandlerOptions } from '../../../types.js';
+import type { GeneratedThemeDeclarationResolver } from './generated-cleanup.js';
+export declare function transformGeneratorUserCss(source: string, options: {
+    compileAuthorCssFunctions?: ((css: string) => Promise<string>) | undefined;
+    generatorTarget: string;
+    generatorStyleOptions: Partial<IStyleHandlerOptions>;
+    cssUserHandlerOptions: IStyleHandlerOptions;
+    styleHandler: (css: string, options: IStyleHandlerOptions) => Promise<{
+        css: string;
+    }>;
+    importFallback: boolean;
+    generatedSource?: string | GeneratedThemeDeclarationResolver | undefined;
+    processed?: boolean | undefined;
+}): Promise<string>;

package/dist/compat/tailwindcss-v4/user-css/user-layer-order.d.ts

@@ -0,0 +1,10 @@
+export declare function wrapUserLayerComponentsCss(css: string): string;
+export declare function extractMarkedUserLayerComponentsCss(css: string): {
+    layers: string[];
+    rest: string;
+};
+export declare function reorderMarkedUserLayerComponentsCss(css: string): string;
+export declare function mergeMarkedUserLayerComponentsCss(baseCss: string, markedCss: string): {
+    css: string;
+    merged: boolean;
+};

package/dist/compat/tailwindcss-v4/user-css/user-layers.d.ts

@@ -0,0 +1,15 @@
+import { postcss } from '../../../postcss-runtime.js';
+export declare function splitUserCssLayerBlocks(source: string): {
+    layer: string;
+    rest: string;
+};
+export declare function hasUserCssLayerBlocks(source: string): boolean;
+export declare function extractGeneratedCssForUserLayerSelectors(css: string, userLayerSource: string): {
+    layer: string;
+    rest: string;
+};
+export { analyzeApplyOnlySource, normalizeGeneratedSelector } from '../../../utils/apply-source.js';
+export declare function collectApplyOnlySourceSelectors(source: string): Set<string>;
+export declare function hasOnlyApplyBackedSourceRules(source: string): boolean;
+export declare function removeCssComments(css: string): string;
+export declare function isEmptyCustomVariantBlock(rule: postcss.AtRule): boolean;

package/dist/compat/tailwindcss-v4.d.ts

@@ -1,4 +1,5 @@
 export { normalizeTailwindcssV4Declaration } from './tailwindcss-v4/declarations.js';
 export { appendTailwindcssV4MiniProgramGradientRules, mergeTailwindcssV4GradientDirectionRules, normalizeTailwindcssV4GradientPosition, normalizeTailwindcssV4InfinityCalcCss, normalizeTailwindcssV4InfinityCalcValue } from './tailwindcss-v4/gradients.js';
 export { isTailwindcssV4DisplayP3Declaration, isTailwindcssV4DisplayP3Media, isTailwindcssV4DisplayP3Supports, isTailwindcssV4LinearGradientSupports, isTailwindcssV4ModernCheck } from './tailwindcss-v4/modern-syntax.js';
+export { removeTailwindV4PreflightImports, removeUnsupportedThemeVendorKeyframes } from './tailwindcss-v4/theme-source.js';
 export { collectUsedTailwindcssV4Variables, createMissingCssVarsV4Nodes, createUsedCssVarsV4Nodes, cssVarsV4Nodes, isTailwindcssV4, isTailwindcssV4ThemeVariable, testIfRootHostForV4, usesTailwindcssV4ContentVariable } from './tailwindcss-v4/variables.js';

package/dist/compat/uni-app-x/apply-source.d.ts

@@ -0,0 +1,2 @@
+export declare function createUniAppXHarmonyApplyGeneratorSource(applyStyleSources: string[]): string;
+export declare function collectCssReferenceDirectives(source: string): Set<string>;

package/dist/compat/uni-app-x/harmony-apply.d.ts

@@ -0,0 +1,2 @@
+/** 每份生成结果建立一次索引，仅在命中作者规则时克隆声明。 */
+export declare function createUniAppXHarmonyApplyCssExpander(generatedCss: string): ((styleSource: string) => string) | undefined;

package/dist/compat/uni-app-x/reference-paths.d.ts

@@ -0,0 +1,2 @@
+/** 路径身份由调用端解析，本包只改写 reference 声明。 */
+export declare function rewriteUniAppXStyleReferences(styleSource: string, resolveReference?: (request: string) => string): string;

package/dist/compat/uni-app-x-author-apply.d.ts

@@ -0,0 +1,10 @@
+import type { Rule } from 'postcss';
+/** 判断 Tailwind 的元素级变量初始化，兼容 Vue 已注入的 scoped 属性。 */
+export declare function isTailwindRuntimePropertyRule(rule: Rule): boolean;
+/**
+ * `@apply` 只应把声明带回作者样式，不能把 Tailwind 根入口的 preflight、
+ * utilities 复制进 scoped style 模块；Web 保留实际使用的运行时变量初始化和注册。
+ */
+export declare function retainUniAppXAuthorApplyCss(generatedCss: string, authorCss: string, options?: {
+    preserveRuntimeProperties?: boolean;
+}): string;