@weapp-tailwindcss/postcss 3.0.2 → 3.0.4

package/README.en.md

@@ -0,0 +1,9 @@
+# @weapp-tailwindcss/postcss
+
+> English | [简体中文](./README.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.
+
+## Website
+
+For setup guides, configuration references, and framework examples, see the [official weapp-tailwindcss documentation](https://tw.icebreaker.top).

package/README.md

@@ -1,99 +1,9 @@
-<p align="center">
+# @weapp-tailwindcss/postcss
 
-<a href="https://tw.icebreaker.top">
+> 简体中文 | [English](./README.en.md)
 
-<img src="./assets/logo.png" alt="weapp-tailwindcss-logo" width="128">
-</a>
+这个包是 weapp-tailwindcss 的 CSS 处理核心，负责小程序端的 PostCSS AST 转换、选择器兼容、平台差异处理和 Tailwind 输出后处理。
 
-<br>
+## 官网
 
-<h1 align="center">weapp-tailwindcss</h1>
-
-</p>
-
-> 简体中文(zh-cn) | [English](./README_en.md)
-
-![star](https://badgen.net/github/stars/sonofmagic/weapp-tailwindcss)
-![dm0](https://badgen.net/npm/dm/weapp-tailwindcss)
-![license](https://badgen.net/npm/license/weapp-tailwindcss)
-[![test](https://github.com/sonofmagic/weapp-tailwindcss/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/sonofmagic/weapp-tailwindcss/actions/workflows/test.yml)
-[![codecov](https://codecov.io/gh/sonofmagic/weapp-tailwindcss/branch/main/graph/badge.svg?token=zn05qXYznt)](https://codecov.io/gh/sonofmagic/weapp-tailwindcss)
-
-> [!NOTE]
-> 降低开发维护成本，提升开发效率的 `小程序` `tailwindcss` 全方面解决方案
->
-> `weapp-tailwindcss@4.2.x` 现已支持 `uni-app x` 同时构建 `Web`,`小程序`,`安卓`,`IOS`,`鸿蒙`，详见 [**uni-app x 专题**](https://tw.icebreaker.top/docs/uni-app-x)
-
-\[[文档地址](https://tw.icebreaker.top)\] \| \[[备用文档地址](https://ice-tw.netlify.app/)\] \| \[[加入技术交流群](https://tw.icebreaker.top/docs/community/group)\]
-
-- [特性](#特性)
-- [版本对应](#版本对应)
-- [安装与使用方式](#安装与使用方式)
-- [生态和解决方案](#生态和解决方案)
-- [常见问题](#常见问题)
-- [各个框架的模板](#各个框架的模板)
-- [旧版本迁移指南](#旧版本迁移指南)
-- [配置项参考](#配置项参考)
-- [Contribute](#contribute)
-- [License](#license)
-- [Star History](#star-history)
-- [Related projects](#related-projects)
-  - [weapp-vite](#weapp-vite)
-
-## 特性
-
-| 不仅仅是`webpack`                                   | 主流框架与原生开发支持                          |
-| --------------------------------------------------- | ----------------------------------------------- |
-| ![wepback+vite+gulp](./assets/weapp-tw-plugins.png) | ![frameworks](./assets/weapp-tw-frameworks.png) |
-
-核心插件支持 `webpack`/`vite`/`rspack`/`rollup`/`rolldown`/`gulp` 为基底的框架类小程序开发，涵盖了市面上几乎所有的主流的开发框架。
-
-也支持直接从各个开发者工具中，直接创建的原生小程序应用。
-
-这些插件能够自动识别并精确处理所有 `tailwindcss` 的工具类来适配小程序环境。
-
-## 版本对应
-
-目前，`weapp-tailwindcss` 的 `5.x` 版本
-
-- 支持最新版本的 `tailwindcss v4` 和 `v3`。
-- 支持 `webpack5`、`vite`、`rspack`、`rollup`、`rolldown` 和 `gulp` 这些打包工具，也支持纯 `Nodejs` API 的方式，集成到你自己的构建工具中。
-
-> `weapp-tailwindcss@5` 面向 Tailwind CSS v3/v4 和现代构建链路，不再内置 Webpack4、PostCSS7、Tailwind CSS v2 兼容入口。`weapp-tailwindcss@5` 需要 `nodejs` 版本 `^20.19.0 || >=22.12.0`，建议安装 `nodejs` 的 `LTS` 版本，详见 [nodejs/release](https://github.com/nodejs/release)
-
-## [安装与使用方式](https://tw.icebreaker.top/docs/quick-start/install)
-
-## [生态和解决方案](https://tw.icebreaker.top/docs/community/templates)
-
-## [常见问题](https://tw.icebreaker.top/docs/issues/)
-
-## [各个框架的模板](https://tw.icebreaker.top/docs/community/templates)
-
-## [旧版本迁移指南](https://tw.icebreaker.top/docs/migrations/v2)
-
-## [配置项参考](https://tw.icebreaker.top/docs/api/interfaces/UserDefinedOptions)
-
-## Contribute
-
-我们邀请你来贡献和帮助改进 `weapp-tailwindcss` 💚💚💚
-
-以下有几个方式可以参与:
-
-- 报告错误：如果您遇到任何错误或问题，请提`issue`并提供完善的错误信息和复现方式。
-- 建议：有增强 `weapp-tailwindcss` 的想法吗？请提 `issue` 来分享您的建议。
-- 文档：如果您对文档有更好的见解或者更棒的修辞方式，欢迎 `pr`。
-- 代码：任何人的代码都不是完美的，我们欢迎你通过 `pr` 给代码提供更好的质量与活力。
-
-## License
-
-[MIT](./LICENSE)
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=sonofmagic/weapp-tailwindcss&type=Date)](https://star-history.com/#sonofmagic/weapp-tailwindcss&Date)
-
-## Related projects
-
-### weapp-vite
-
-[weapp-vite](https://vite.icebreaker.top/): 把现代化的开发模式带入小程序开发!
+更多接入方式、配置说明和框架示例见 [weapp-tailwindcss 官方文档](https://tw.icebreaker.top)。

package/dist/compat/color-mix/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const COLOR_MIX_NAME = "color-mix";
+export declare const MODERN_COLOR_FUNCTION_NAMES: Set<string>;
+export declare const PLACEHOLDER_PREFIX = "__weapp_tw_color_mix_";
+export declare const DYNAMIC_ALPHA_RE: RegExp;
+export declare const INTERNAL_TAILWIND_ALPHA_RE: RegExp;
+export declare const TRANSPARENT_COLOR_RE: RegExp;
+export declare const CURRENT_COLOR_RE: RegExp;
+export declare const CSS_WIDE_KEYWORD_RE: RegExp;
+export declare const CUSTOM_PROPERTY_RE: RegExp;

package/dist/compat/color-mix/modern.d.ts

@@ -0,0 +1,2 @@
+export declare function isDisplayP3ColorFunction(colorSource: string): boolean;
+export declare function hasUnsupportedModernColorFunction(value: string): boolean;

package/dist/compat/color-mix/parse.d.ts

@@ -0,0 +1,9 @@
+import type { ColorData } from '@csstools/css-color-parser';
+import type { Node } from 'postcss-value-parser';
+export declare function splitArguments(nodes: Node[]): Node[][];
+export declare function splitStopSegments(nodes: Node[]): Node[][];
+export declare function trimNodes(nodes: Node[]): Node[];
+export declare function parseAlphaValue(alphaSource: string): number | undefined;
+export declare function resolveColorData(colorSource: string, customPropertyValues: ReadonlyMap<string, string>, depth?: number): ColorData | undefined;
+export declare function normalizeColorFunctionName(colorSource: string, alpha: number, customPropertyValues: ReadonlyMap<string, string>): string | undefined;
+export declare function normalizeStandaloneColorFunction(colorSource: string): string | undefined;

package/dist/compat/color-mix/resolve.d.ts

@@ -0,0 +1,5 @@
+import type { FunctionNode } from 'postcss-value-parser';
+export declare function tryResolveColorMix(node: FunctionNode, customPropertyValues: ReadonlyMap<string, string>): {
+    value: string;
+    deferred: boolean;
+} | undefined;

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

@@ -0,0 +1,5 @@
+import postcss from 'postcss';
+export declare const TAILWIND_V4_BANNER_RE: RegExp;
+export declare function hasTailwindcssV4Signal(css: string): boolean;
+export declare function unwrapTailwindSourceMedia(root: postcss.Root): void;
+export declare function removeTailwindGenerationDirectives(root: postcss.Root): void;

package/dist/compat/mini-program-css/finalize-options.d.ts

@@ -0,0 +1,6 @@
+import type { CssPreflightOptions } from '../../types';
+export interface FinalizeMiniProgramCssOptions {
+    cssPreflight?: CssPreflightOptions | undefined;
+    preservePseudoContentInit?: boolean;
+    isTailwindcssV4?: boolean | undefined;
+}

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

@@ -1,13 +1,6 @@
-import type { CssPreflightOptions } from '../../types';
-import postcss from 'postcss';
-export interface FinalizeMiniProgramCssOptions {
-    cssPreflight?: CssPreflightOptions | undefined;
-    preservePseudoContentInit?: boolean;
-    isTailwindcssV4?: boolean | undefined;
-}
-export declare function collectPreflightRules(root: postcss.Root, options?: {
-    preservePseudoContentInit?: boolean;
-}): postcss.Rule[];
-export declare function insertHoistedRules(root: postcss.Root, rules: postcss.Rule[], anchor?: postcss.Comment): void;
+import type { FinalizeMiniProgramCssOptions } from './finalize-options';
+export type { FinalizeMiniProgramCssOptions } from './finalize-options';
+export { insertHoistedRules } from './hoist';
+export { collectPreflightRules } from './preflight';
 export declare function hoistTailwindPreflightBase(css: string): string;
 export declare function finalizeMiniProgramCss(css: string, options?: FinalizeMiniProgramCssOptions): string;

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

@@ -0,0 +1,4 @@
+import postcss from 'postcss';
+export declare function createHoistInsertionAnchor(root: postcss.Root): postcss.Comment | undefined;
+export declare function insertHoistedRules(root: postcss.Root, rules: postcss.Rule[], anchor?: postcss.Comment): void;
+export declare function mergeEquivalentHoistedRules(rules: postcss.Rule[]): postcss.Rule[];

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

@@ -0,0 +1,7 @@
+import type { CssPreflightOptions } from '../../types';
+import postcss from 'postcss';
+export declare function collectPreflightRules(root: postcss.Root, options?: {
+    preservePseudoContentInit?: boolean;
+    cssPreflight?: CssPreflightOptions | undefined;
+}): postcss.Rule[];
+export declare function createPreflightResetRule(cssPreflight: CssPreflightOptions | undefined): postcss.Rule | undefined;

package/dist/compat/mini-program-css/root-cleanups.d.ts

@@ -2,4 +2,10 @@ import type postcss from 'postcss';
 export declare function removeSpecificityPlaceholders(root: postcss.Root): void;
 export declare function removeUnsupportedBrowserSelectors(root: postcss.Root): void;
 export declare function removeDisplayP3Declarations(root: postcss.Root): void;
+interface RemoveTailwindContainerRulesOptions {
+    generatedOnly?: boolean;
+}
+export declare function removeTailwindContainerMaxWidthMediaRules(root: postcss.Root): void;
+export declare function removeTailwindContainerWidthRules(root: postcss.Root, options?: RemoveTailwindContainerRulesOptions): void;
 export declare function removeUnsupportedModernColorDeclarations(root: postcss.Root): void;
+export {};

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

@@ -0,0 +1,3 @@
+import type { FinalizeMiniProgramCssOptions } from './finalize-options';
+import postcss from 'postcss';
+export declare function collectThemeVariableRule(root: postcss.Root, options?: FinalizeMiniProgramCssOptions): postcss.Rule | undefined;