@weapp-tailwindcss/postcss 3.0.2 → 3.0.3

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/mini-program-css/finalize.d.ts

@@ -7,6 +7,7 @@ export interface FinalizeMiniProgramCssOptions {
 }
 export declare function collectPreflightRules(root: postcss.Root, options?: {
     preservePseudoContentInit?: boolean;
+    cssPreflight?: CssPreflightOptions | undefined;
 }): postcss.Rule[];
 export declare function insertHoistedRules(root: postcss.Root, rules: postcss.Rule[], anchor?: postcss.Comment): void;
 export declare function hoistTailwindPreflightBase(css: string): string;

package/dist/index.js

@@ -7472,6 +7472,7 @@ function removeUnsupportedModernColorDeclarations(root) {
 //#region src/compat/mini-program-css/finalize.ts
 const HOIST_ANCHOR_COMMENT = "__weapp_tailwindcss_base_anchor__";
 const TAILWIND_V4_BANNER_RE = /\/\*!\s*tailwindcss v4\./;
+const GENERATOR_PLACEHOLDER_COMMENT_RE = /^\s*(?:!\s*)?weapp-tailwindcss generator-placeholder\s*$/i;
 const MINI_PROGRAM_PSEUDO_CONTENT_SCOPE_SELECTOR = "::before,\n::after";
 const MINI_PROGRAM_PSEUDO_CONTENT_SELECTORS = new Set(["::before", "::after"]);
 function createPseudoContentInitRule() {
@@ -7482,6 +7483,26 @@ function createPseudoContentInitRule() {
 	});
 	return rule;
 }
+function applyConfiguredPreflightDeclarations(rule, cssPreflight) {
+	if (!cssPreflight || typeof cssPreflight !== "object") return;
+	const configuredProps = new Set(Object.keys(cssPreflight));
+	rule.walkDecls((decl) => {
+		if (!configuredProps.has(decl.prop)) return;
+		const value = cssPreflight[decl.prop];
+		if (value === false) {
+			decl.remove();
+			return;
+		}
+		decl.value = value.toString();
+	});
+	for (const [prop, value] of Object.entries(cssPreflight)) {
+		if (value === false || rule.nodes?.some((node) => node.type === "decl" && node.prop === prop)) continue;
+		rule.append({
+			prop,
+			value: value.toString()
+		});
+	}
+}
 function collectPreflightRules(root, options = {}) {
 	const preflightNodes = [];
 	for (const node of root.nodes ?? []) if (isMiniProgramPreflightRule(node)) preflightNodes.push(node);
@@ -7497,7 +7518,10 @@ function collectPreflightRules(root, options = {}) {
 		const selectors = getRuleSelectors(rule);
 		const hasElementSelector = selectors.some((selector) => selector === "view" || selector === "text");
 		if (selectors.length > 0 && selectors.every((selector) => MINI_PROGRAM_PSEUDO_CONTENT_SELECTORS.has(selector))) rule.selector = MINI_PROGRAM_PSEUDO_CONTENT_SCOPE_SELECTOR;
-		else if (hasElementSelector && selectors.every((selector) => MINI_PROGRAM_ELEMENT_SCOPE_SELECTORS.has(selector))) rule.selector = MINI_PROGRAM_ELEMENT_SCOPE_SELECTOR;
+		else if (hasElementSelector && selectors.every((selector) => MINI_PROGRAM_ELEMENT_SCOPE_SELECTORS.has(selector))) {
+			rule.selector = MINI_PROGRAM_ELEMENT_SCOPE_SELECTOR;
+			applyConfiguredPreflightDeclarations(rule, options.cssPreflight);
+		}
 	}
 	const nonEmptyPreflightRules = clonedPreflightRules.filter((rule) => (rule.nodes?.length ?? 0) > 0);
 	const preflightRules = [...options.preservePseudoContentInit ? [createPseudoContentInitRule()] : [], ...nonEmptyPreflightRules];
@@ -7587,21 +7611,41 @@ function insertHoistedRules(root, rules, anchor) {
 function mergeEquivalentHoistedRules(rules) {
 	const mergedRules = [];
 	const ruleBySelector = /* @__PURE__ */ new Map();
+	const propsBySelector = /* @__PURE__ */ new Map();
 	for (const rule of rules) {
 		const key = getSortedRuleSelectorKey(rule);
 		const existingRule = ruleBySelector.get(key);
 		if (existingRule) {
-			existingRule.append(...(rule.nodes ?? []).map((node) => node.clone()));
+			const existingProps = propsBySelector.get(key) ?? /* @__PURE__ */ new Set();
+			const nextNodes = (rule.nodes ?? []).filter((node) => {
+				if (node.type !== "decl") return true;
+				if (existingProps.has(node.prop)) return false;
+				existingProps.add(node.prop);
+				return true;
+			});
+			existingRule.append(...nextNodes.map((node) => node.clone()));
+			propsBySelector.set(key, existingProps);
 			continue;
 		}
 		ruleBySelector.set(key, rule);
+		propsBySelector.set(key, new Set((rule.nodes ?? []).flatMap((node) => node.type === "decl" ? [node.prop] : [])));
 		mergedRules.push(rule);
 	}
 	return mergedRules;
 }
 function unwrapTailwindSourceMedia(root) {
 	root.walkAtRules("media", (atRule) => {
-		if (atRule.params.startsWith("source(") && atRule.nodes && atRule.nodes.length > 0) atRule.replaceWith(...atRule.nodes);
+		if (!atRule.params.startsWith("source(")) return;
+		if (atRule.nodes && atRule.nodes.length > 0) atRule.replaceWith(...atRule.nodes);
+		else atRule.remove();
+	});
+}
+function removeTailwindGenerationDirectives(root) {
+	root.walkComments((comment) => {
+		if (GENERATOR_PLACEHOLDER_COMMENT_RE.test(comment.text)) comment.remove();
+	});
+	root.walkAtRules((atRule) => {
+		if (atRule.name === "config" || atRule.name === "source" || atRule.name === "tailwind" || atRule.name === "reference" || atRule.name === "plugin") atRule.remove();
 	});
 }
 function finalizeMiniProgramCssRoot(root, options = {}) {
@@ -7609,6 +7653,7 @@ function finalizeMiniProgramCssRoot(root, options = {}) {
 	const tailwindcssV4DefaultNodes = shouldInjectTailwindcssV4Defaults ? createMissingCssVarsV4Nodes(root, collectUsedTailwindcssV4Variables(root)) : [];
 	removeUnsupportedCascadeLayers(root);
 	unwrapTailwindSourceMedia(root);
+	removeTailwindGenerationDirectives(root);
 	root.walkAtRules("property", (atRule) => {
 		atRule.remove();
 	});

package/dist/index.mjs

@@ -7484,6 +7484,7 @@ function removeUnsupportedModernColorDeclarations(root) {
 //#region src/compat/mini-program-css/finalize.ts
 const HOIST_ANCHOR_COMMENT = "__weapp_tailwindcss_base_anchor__";
 const TAILWIND_V4_BANNER_RE = /\/\*!\s*tailwindcss v4\./;
+const GENERATOR_PLACEHOLDER_COMMENT_RE = /^\s*(?:!\s*)?weapp-tailwindcss generator-placeholder\s*$/i;
 const MINI_PROGRAM_PSEUDO_CONTENT_SCOPE_SELECTOR = "::before,\n::after";
 const MINI_PROGRAM_PSEUDO_CONTENT_SELECTORS = new Set(["::before", "::after"]);
 function createPseudoContentInitRule() {
@@ -7494,6 +7495,26 @@ function createPseudoContentInitRule() {
 	});
 	return rule;
 }
+function applyConfiguredPreflightDeclarations(rule, cssPreflight) {
+	if (!cssPreflight || typeof cssPreflight !== "object") return;
+	const configuredProps = new Set(Object.keys(cssPreflight));
+	rule.walkDecls((decl) => {
+		if (!configuredProps.has(decl.prop)) return;
+		const value = cssPreflight[decl.prop];
+		if (value === false) {
+			decl.remove();
+			return;
+		}
+		decl.value = value.toString();
+	});
+	for (const [prop, value] of Object.entries(cssPreflight)) {
+		if (value === false || rule.nodes?.some((node) => node.type === "decl" && node.prop === prop)) continue;
+		rule.append({
+			prop,
+			value: value.toString()
+		});
+	}
+}
 function collectPreflightRules(root, options = {}) {
 	const preflightNodes = [];
 	for (const node of root.nodes ?? []) if (isMiniProgramPreflightRule(node)) preflightNodes.push(node);
@@ -7509,7 +7530,10 @@ function collectPreflightRules(root, options = {}) {
 		const selectors = getRuleSelectors(rule);
 		const hasElementSelector = selectors.some((selector) => selector === "view" || selector === "text");
 		if (selectors.length > 0 && selectors.every((selector) => MINI_PROGRAM_PSEUDO_CONTENT_SELECTORS.has(selector))) rule.selector = MINI_PROGRAM_PSEUDO_CONTENT_SCOPE_SELECTOR;
-		else if (hasElementSelector && selectors.every((selector) => MINI_PROGRAM_ELEMENT_SCOPE_SELECTORS.has(selector))) rule.selector = MINI_PROGRAM_ELEMENT_SCOPE_SELECTOR;
+		else if (hasElementSelector && selectors.every((selector) => MINI_PROGRAM_ELEMENT_SCOPE_SELECTORS.has(selector))) {
+			rule.selector = MINI_PROGRAM_ELEMENT_SCOPE_SELECTOR;
+			applyConfiguredPreflightDeclarations(rule, options.cssPreflight);
+		}
 	}
 	const nonEmptyPreflightRules = clonedPreflightRules.filter((rule) => (rule.nodes?.length ?? 0) > 0);
 	const preflightRules = [...options.preservePseudoContentInit ? [createPseudoContentInitRule()] : [], ...nonEmptyPreflightRules];
@@ -7599,21 +7623,41 @@ function insertHoistedRules(root, rules, anchor) {
 function mergeEquivalentHoistedRules(rules) {
 	const mergedRules = [];
 	const ruleBySelector = /* @__PURE__ */ new Map();
+	const propsBySelector = /* @__PURE__ */ new Map();
 	for (const rule of rules) {
 		const key = getSortedRuleSelectorKey(rule);
 		const existingRule = ruleBySelector.get(key);
 		if (existingRule) {
-			existingRule.append(...(rule.nodes ?? []).map((node) => node.clone()));
+			const existingProps = propsBySelector.get(key) ?? /* @__PURE__ */ new Set();
+			const nextNodes = (rule.nodes ?? []).filter((node) => {
+				if (node.type !== "decl") return true;
+				if (existingProps.has(node.prop)) return false;
+				existingProps.add(node.prop);
+				return true;
+			});
+			existingRule.append(...nextNodes.map((node) => node.clone()));
+			propsBySelector.set(key, existingProps);
 			continue;
 		}
 		ruleBySelector.set(key, rule);
+		propsBySelector.set(key, new Set((rule.nodes ?? []).flatMap((node) => node.type === "decl" ? [node.prop] : [])));
 		mergedRules.push(rule);
 	}
 	return mergedRules;
 }
 function unwrapTailwindSourceMedia(root) {
 	root.walkAtRules("media", (atRule) => {
-		if (atRule.params.startsWith("source(") && atRule.nodes && atRule.nodes.length > 0) atRule.replaceWith(...atRule.nodes);
+		if (!atRule.params.startsWith("source(")) return;
+		if (atRule.nodes && atRule.nodes.length > 0) atRule.replaceWith(...atRule.nodes);
+		else atRule.remove();
+	});
+}
+function removeTailwindGenerationDirectives(root) {
+	root.walkComments((comment) => {
+		if (GENERATOR_PLACEHOLDER_COMMENT_RE.test(comment.text)) comment.remove();
+	});
+	root.walkAtRules((atRule) => {
+		if (atRule.name === "config" || atRule.name === "source" || atRule.name === "tailwind" || atRule.name === "reference" || atRule.name === "plugin") atRule.remove();
 	});
 }
 function finalizeMiniProgramCssRoot(root, options = {}) {
@@ -7621,6 +7665,7 @@ function finalizeMiniProgramCssRoot(root, options = {}) {
 	const tailwindcssV4DefaultNodes = shouldInjectTailwindcssV4Defaults ? createMissingCssVarsV4Nodes(root, collectUsedTailwindcssV4Variables(root)) : [];
 	removeUnsupportedCascadeLayers(root);
 	unwrapTailwindSourceMedia(root);
+	removeTailwindGenerationDirectives(root);
 	root.walkAtRules("property", (atRule) => {
 		atRule.remove();
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weapp-tailwindcss/postcss",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "@weapp-tailwindcss/postcss",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -65,7 +65,7 @@
     "postcss-rule-unit-converter": "^0.2.2",
     "postcss-selector-parser": "~7.1.1",
     "postcss-value-parser": "^4.2.0",
-    "@weapp-tailwindcss/postcss-calc": "^1.0.1",
+    "@weapp-tailwindcss/postcss-calc": "^1.0.2",
     "@weapp-tailwindcss/shared": "2.0.0"
   },
   "devDependencies": {