@novlan/postcss-plugin-remove-selector 0.1.2 → 0.1.4

package/README.md

@@ -44,25 +44,21 @@ export default defineConfig({
 
 ## 3. 类型
 
-```ts
-interface FileConfig {
-  /** 文件匹配规则，可以是字符串或正则表达式 */
-  file: RegExp | string;
-  /** 需要保留的选择器列表（图标名称） */
-  include?: string[];
-  /** 需要移除的选择器列表（图标名称） */
-  exclude?: string[];
-  /** 选择器匹配模式，只处理匹配该模式的选择器 */
-  selectorPattern?: RegExp;
-}
-
-interface Options {
-  /** 配置列表 */
-  list: FileConfig[];
-  /** 是否开启调试模式 */
-  debug?: boolean;
-}
-```
+### Options
+
+| 属性 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `list` | `FileConfig[]` | 是 | 配置列表 |
+| `debug` | `boolean` | 否 | 是否开启调试模式 |
+
+### FileConfig
+
+| 属性 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `file` | `RegExp \| string` | 是 | 文件匹配规则，可以是字符串或正则表达式 |
+| `include` | `string[]` | 否 | 需要保留的选择器列表（图标名称） |
+| `exclude` | `string[]` | 否 | 需要移除的选择器列表（图标名称） |
+| `selectorPattern` | `RegExp` | 否 | 选择器匹配模式，只处理匹配该模式的选择器 |
 
 ## 4. 更新日志
 

package/lib/index.d.ts

@@ -1,2 +1,3 @@
 export * from './plugin';
-export { TDESIGN_ICON_REMOVE_SELECTOR } from './tdesign-uniapp-icon';
+export * from './tdesign-uniapp-icon';
+export { postCssPluginRemoveSelector as default } from './plugin';

package/lib/index.js

@@ -48,53 +48,77 @@ function shouldRemoveRule(options) {
     return false;
 }
 
+const PLUGIN_NAME = 'postcss-plugin-remove-selector';
+/**
+ * 核心处理逻辑，PostCSS 7 / 8 共用
+ */
+function processRoot(root, result, opts) {
+    const { list = [], debug = false } = opts;
+    const fileName = result.opts?.from || '';
+    const found = shouldHandleFile(list, fileName);
+    if (!found) {
+        return;
+    }
+    const { exclude = [], include = [], selectorPattern } = found;
+    if (debug) {
+        console.log('[postcss-plugin-remove-selector] handling:', fileName);
+    }
+    let removedCount = 0;
+    root.walkRules((rule) => {
+        if (shouldRemoveRule({
+            selectorPattern,
+            exclude,
+            include,
+            selector: rule.selector,
+        })) {
+            rule.remove();
+            removedCount += 1;
+        }
+    });
+    if (debug) {
+        console.log(`[postcss-plugin-remove-selector] removed ${removedCount} rules from:`, fileName);
+    }
+}
 /**
  * PostCSS 插件：移除指定的 CSS 选择器
  * 用于图标样式减包等场景
  *
+ * 同时兼容 PostCSS 7 和 PostCSS 8：
+ * - PostCSS 8：使用标准 Creator 函数格式 + postcss: true 标记
+ * - PostCSS 7：回退到 postcss.plugin() 注册方式
+ *
  * @param opts 配置项
  * @returns PostCSS 插件
  */
-function postCssPluginRemoveSelector(opts = { list: [] }) {
-    const { list = [], debug = false } = opts;
-    const plugin = {
-        postcssPlugin: 'postcss-plugin-remove-selector',
-        postcss: true,
-        Once(root, { result }) {
-            const fileName = result.opts?.from || '';
-            const found = shouldHandleFile(list, fileName);
-            if (!found) {
-                return;
-            }
-            const { exclude = [], include = [], selectorPattern } = found;
-            if (debug) {
-                console.log('[postcss-plugin-remove-selector] handling:', fileName);
-            }
-            let removedCount = 0;
-            root.walkRules((rule) => {
-                if (shouldRemoveRule({
-                    selectorPattern,
-                    exclude,
-                    include,
-                    selector: rule.selector,
-                })) {
-                    rule.remove();
-                    removedCount += 1;
-                }
-            });
-            if (debug) {
-                console.log(`[postcss-plugin-remove-selector] removed ${removedCount} rules from:`, fileName);
-            }
-        },
-    };
-    return plugin;
+const postCssPluginRemoveSelector = (opts = { list: [] }) => 
+// PostCSS 8 格式
+({
+    postcssPlugin: PLUGIN_NAME,
+    Once(root, { result }) {
+        processRoot(root, result, opts);
+    },
+});
+// 标记为 PostCSS 8 插件
+postCssPluginRemoveSelector.postcss = true;
+// PostCSS 7 兼容：通过 postcss.plugin() 注册
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const postcss = require('postcss');
+    if (postcss && typeof postcss.plugin === 'function') {
+        postCssPluginRemoveSelector.postcss7 = postcss.plugin(PLUGIN_NAME, (opts = { list: [] }) => (root, result) => {
+            processRoot(root, result, opts);
+        });
+    }
+}
+catch (e) {
+    // postcss 未安装或不支持 postcss.plugin，忽略
 }
 
 /**
  * TDesign UniApp 图标减包配置
  *
  * 使用说明：
- * 1. 在 USED_ICONS 数组中配置项目中实际使用的图标名称
+ * 1. 在 TDESIGN_USED_ICONS 数组中配置项目中实际使用的图标名称
  * 2. 插件只会处理 .t-icon-xxx:before 这类图标选择器
  * 3. 其他基础样式（如 @font-face、.t-icon 等）会自动保留
  *
@@ -105,7 +129,7 @@ function postCssPluginRemoveSelector(opts = { list: [] }) {
  * 项目中实际使用的图标列表
  * 根据 src 目录下的 .vue 文件分析得出
  */
-const USED_ICONS = [
+const TDESIGN_USED_ICONS = [
     // custom-tab-bar.vue
     'home',
     'chat',
@@ -171,13 +195,15 @@ const TDESIGN_ICON_REMOVE_SELECTOR = {
             // 只处理 .t-icon-xxx:before 这类图标选择器，其他样式自动保留
             selectorPattern: /^\.t-icon-[\w-]+:before$/,
             // 保留的图标名称列表
-            include: USED_ICONS,
+            include: TDESIGN_USED_ICONS,
             exclude: [],
         },
     ],
 };
 
 exports.TDESIGN_ICON_REMOVE_SELECTOR = TDESIGN_ICON_REMOVE_SELECTOR;
+exports.TDESIGN_USED_ICONS = TDESIGN_USED_ICONS;
+exports["default"] = postCssPluginRemoveSelector;
 exports.extractIconName = extractIconName;
 exports.postCssPluginRemoveSelector = postCssPluginRemoveSelector;
 exports.shouldHandleFile = shouldHandleFile;

package/lib/plugin.d.ts

@@ -1,13 +1,15 @@
-import type { Options, PostCSSPlugin } from './types';
-export type { Options, FileConfig, ShouldRemoveRuleOptions, PostCSSPlugin } from './types';
+export type { Options, FileConfig, ShouldRemoveRuleOptions } from './types';
 export { shouldHandleFile, shouldRemoveRule, extractIconName } from './helper';
 /**
  * PostCSS 插件：移除指定的 CSS 选择器
  * 用于图标样式减包等场景
  *
+ * 同时兼容 PostCSS 7 和 PostCSS 8：
+ * - PostCSS 8：使用标准 Creator 函数格式 + postcss: true 标记
+ * - PostCSS 7：回退到 postcss.plugin() 注册方式
+ *
  * @param opts 配置项
  * @returns PostCSS 插件
  */
-export declare function postCssPluginRemoveSelector(opts?: Options): PostCSSPlugin & {
-    postcss: true;
-};
+declare const postCssPluginRemoveSelector: any;
+export { postCssPluginRemoveSelector };

package/lib/tdesign-uniapp-icon.d.ts

@@ -2,13 +2,18 @@
  * TDesign UniApp 图标减包配置
  *
  * 使用说明：
- * 1. 在 USED_ICONS 数组中配置项目中实际使用的图标名称
+ * 1. 在 TDESIGN_USED_ICONS 数组中配置项目中实际使用的图标名称
  * 2. 插件只会处理 .t-icon-xxx:before 这类图标选择器
  * 3. 其他基础样式（如 @font-face、.t-icon 等）会自动保留
  *
  * 如何查找项目中使用的图标：
  * grep -rho 'icon="[^"]*"\|left-icon="[^"]*"\|name="[^"]*"' src --include="*.vue" | sort | uniq
  */
+/**
+ * 项目中实际使用的图标列表
+ * 根据 src 目录下的 .vue 文件分析得出
+ */
+export declare const TDESIGN_USED_ICONS: string[];
 /**
  * TDesign UniApp 图标减包配置
  */

package/lib/types.d.ts

@@ -1,4 +1,3 @@
-import type { Root, Result } from 'postcss';
 /**
  * 单个文件匹配配置
  */
@@ -34,12 +33,3 @@ export interface ShouldRemoveRuleOptions {
     /** 当前选择器 */
     selector: string;
 }
-/**
- * PostCSS 插件返回类型
- */
-export interface PostCSSPlugin {
-    postcssPlugin: string;
-    Once(root: Root, helpers: {
-        result: Result;
-    }): void;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novlan/postcss-plugin-remove-selector",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "homepage": "https://novlan1.github.io/plugins/zh/postcss-plugin-remove-selector.html",
   "bugs": {
     "url": "https://github.com/novlan1/plugins/issues"
@@ -18,7 +18,7 @@
   ],
   "dependencies": {},
   "peerDependencies": {
-    "postcss": "^8.0.0"
+    "postcss": "^7.0.0 || ^8.0.0"
   },
   "publishConfig": {
     "access": "public",