chore(remove-selector): add types

Author: novlan1

docs/changelog/postcss-plugin-remove-selector.md

@@ -1,53 +1,33 @@
 # postcss-plugin-remove-selector
 
-## 1.0.0 (2025-06-09)
+## <small>0.1.5 (2026-02-08)</small>
 
-* docs: update docs ([dc32fc4](https://github.com/novlan1/plugin-light/commits/dc32fc4))
-* docs: update docs ([47c235e](https://github.com/novlan1/plugin-light/commits/47c235e))
-* docs: update docs ([761f6c4](https://github.com/novlan1/plugin-light/commits/761f6c4))
-* docs: update docs ([6f3a885](https://github.com/novlan1/plugin-light/commits/6f3a885))
-* docs: update readme ([5483ce8](https://github.com/novlan1/plugin-light/commits/5483ce8))
-* chore: update license ([5ba3e91](https://github.com/novlan1/plugin-light/commits/5ba3e91))
-* refactor: use eslint import/order rule ([41afa85](https://github.com/novlan1/plugin-light/commits/41afa85))
-* feat(postcss-plugin-remove-selector): 增加press-icon-plus-remove-selector参数 ([837fc0a](https://github.com/novlan1/plugin-light/commits/837fc0a))
+* feat(remove-selector): add used/unused api ([68e1973](https://github.com/novlan1/plugins/commit/68e1973))
 
 
 
-## <small>0.0.5 (2025-03-18)</small>
+## <small>0.1.4 (2026-02-08)</small>
 
-* feat(postcss-plugin-remove-selector): 异常参数兼容 ([91fd8a5](https://github.com/novlan1/plugin-light/commits/91fd8a5))
+* feat(remove-selector): add tdesignUsedIcon exports ([e9fbfc3](https://github.com/novlan1/plugins/commit/e9fbfc3))
 
 
 
-## <small>0.0.4 (2025-03-18)</small>
+## <small>0.1.3 (2026-02-08)</small>
 
-* feat(postcss-plugin-remove-selector): 优化api ([f6f3c3f](https://github.com/novlan1/plugin-light/commits/f6f3c3f))
-* chore: 优化版本号 ([bf5a4cb](https://github.com/novlan1/plugin-light/commits/bf5a4cb))
-* chore: sort package.json ([42cab1e](https://github.com/novlan1/plugin-light/commits/42cab1e))
-* chore: update docs ([43dbc9d](https://github.com/novlan1/plugin-light/commits/43dbc9d))
-* chore: update license ([7f6a9d9](https://github.com/novlan1/plugin-light/commits/7f6a9d9))
-* docs: update docs ([cc81245](https://github.com/novlan1/plugin-light/commits/cc81245))
+* feat(remove-selector): support postcss@7 ([615fbd8](https://github.com/novlan1/plugins/commit/615fbd8))
 
 
 
-## <small>0.0.3 (2024-11-24)</small>
+## <small>0.1.2 (2026-02-08)</small>
 
-* chore: add meta in pkg.json ([3f6088c](https://github.com/novlan1/plugin-light/commits/3f6088c))
-* chore: add release script ([defe6af](https://github.com/novlan1/plugin-light/commits/defe6af))
-* chore: update deps to latest ([455918d](https://github.com/novlan1/plugin-light/commits/455918d))
-* chore: update name ([02b2100](https://github.com/novlan1/plugin-light/commits/02b2100))
-* chore: update plugin-light-shared ([08a9790](https://github.com/novlan1/plugin-light/commits/08a9790))
-* chore: update plugin-light-shared to 0.0.12 ([4d33550](https://github.com/novlan1/plugin-light/commits/4d33550))
-* docs: move docs position ([1937e17](https://github.com/novlan1/plugin-light/commits/1937e17))
-* docs: update docs ([883589c](https://github.com/novlan1/plugin-light/commits/883589c))
+* feat(remove-selector): add tdesign-config exports ([ab9c52a](https://github.com/novlan1/plugins/commit/ab9c52a))
 
 
 
-## <small>0.0.2 (2024-09-18)</small>
+## <small>0.1.1 (2026-02-08)</small>
 
-* chore: update project-config ([af4ff17](https://github.com/novlan1/plugin-light/commits/af4ff17))
-* chore: update rollup.config ([19fc828](https://github.com/novlan1/plugin-light/commits/19fc828))
-* feat: add monorepo packages ([494adb6](https://github.com/novlan1/plugin-light/commits/494adb6))
+* chore: update plugin docs ([19ca7f4](https://github.com/novlan1/plugins/commit/19ca7f4))
+* init ([fc48bfe](https://github.com/novlan1/plugins/commit/fc48bfe))
 
 
 

docs/zh/postcss-plugin-remove-selector.md

@@ -1,12 +1,12 @@
 # 移除选择器
 
 <p align="center">
-  <img src="https://img.shields.io/npm/dw/@plugin-light/postcss-plugin-remove-selector">
-  <img src="https://img.shields.io/npm/unpacked-size/@plugin-light/postcss-plugin-remove-selector">
-  <img src="https://img.shields.io/npm/v/@plugin-light/postcss-plugin-remove-selector">
-  <img src="https://img.shields.io/npm/l/@plugin-light/postcss-plugin-remove-selector">
-  <img src="https://img.shields.io/github/last-commit/novlan1/plugin-light">
-  <img src="https://img.shields.io/github/created-at/novlan1/plugin-light">
+  <img src="https://img.shields.io/npm/dw/@novlan/postcss-plugin-remove-selector">
+  <img src="https://img.shields.io/npm/unpacked-size/@novlan/postcss-plugin-remove-selector">
+  <img src="https://img.shields.io/npm/v/@novlan/postcss-plugin-remove-selector">
+  <img src="https://img.shields.io/npm/l/@novlan/postcss-plugin-remove-selector">
+  <img src="https://img.shields.io/github/last-commit/novlan1/plugins">
+  <img src="https://img.shields.io/github/created-at/novlan1/plugins">
 </p>
 
 可用于移除三方库中的不需要的样式，从而减小包体积。
@@ -20,73 +20,119 @@
 安装
 
 ```bash
-pnpm add @plugin-light/postcss-plugin-remove-selector -D
+pnpm add @novlan/postcss-plugin-remove-selector -D
 ```
 
-`postcss.config.js` 中新增配置：
+### 简化模式（推荐）
+
+通过 `mode` 指定预设，只需关注 `used`/`unused`，无需手动配置 `file` 和 `selectorPattern`：
+
+```ts
+import { defineConfig } from 'vite';
+import { postcssPluginRemoveSelector } from '@novlan/postcss-plugin-remove-selector';
+
+export default defineConfig({
+  css: {
+    postcss: {
+      plugins: [
+        postcssPluginRemoveSelector({
+          mode: 'tdesign',
+          used: ['home', 'chat', 'user', 'add', 'search', 'close'],
+        }),
+      ],
+    },
+  },
+});
+```
+
+使用 `customUsed` / `customUnused` 可在预设基础上增量追加，不会覆盖预设中已有的列表：
 
 ```ts
-module.exports = {
-  require('@plugin-light/postcss-plugin-remove-selector/lib/index')({
-    list: [{
-      file: new RegExp('press-ui/press-icon-plus/css/icon.scss'),
-      include: [
-        'arrow',
-        'arrow-left',
-        'arrow-right',
-        'arrow-up',
-        'arrow-down',
-        'success',
-        'cross',
-        'plus',
-        'minus',
-        'fail',
-        'circle',
-      ].map(item => `.press-icon-plus-${item}:before`),
-    }],
-  }),
-}
+postcssPluginRemoveSelector({
+  mode: 'tdesign',
+  // 在 tdesign 预设默认的 used 列表上，额外追加 'star' 和 'heart'
+  customUsed: ['star', 'heart'],
+  // 从结果中额外移除 'loading'
+  customUnused: ['loading'],
+})
 ```
 
-也可以在 `vite.config.ts` 中使用：
+### 标准模式
+
+通过 `list` 数组传入完整配置，适用于需要匹配多个文件的复杂场景：
 
 ```ts
 import { defineConfig } from 'vite';
-import removeSelector from '@plugin-light/postcss-plugin-remove-selector';
+import { postcssPluginRemoveSelector } from '@novlan/postcss-plugin-remove-selector';
 import {
-  PRESS_ICON_PLUS_REMOVE_SELECTOR 
-} from '@plugin-light/postcss-plugin-remove-selector/lib/press-ui-icon-plus';
+  TDESIGN_ICON_REMOVE_SELECTOR
+} from '@novlan/postcss-plugin-remove-selector/lib/tdesign-uniapp-icon';
 
 
 export default defineConfig({
   css: {
     postcss: {
-      plugins: [removeSelector(PRESS_ICON_PLUS_REMOVE_SELECTOR)],
+      plugins: [postcssPluginRemoveSelector(TDESIGN_ICON_REMOVE_SELECTOR)],
     },
   },
 });
 ```
 
 ## 3. 类型
 
-```ts
-interface Options {
-  list: Array<{
-    file: RegExp | string;
-    exclude?: string[];
-    include?: string[];
-  }>;
-}
-```
+插件支持两种配置方式，传入 `SimpleOptions`（简化模式）或 `Options`（标准模式）均可。
+
+### SimpleOptions（简化模式）
+
+| 属性 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `mode` | `'tdesign'` | 否 | 预设模式，设置后自动使用对应的 `file` 和 `selectorPattern` 默认值 |
+| `file` | `RegExp \| string` | 否 | 文件匹配规则。使用 `mode` 时可省略 |
+| `used` | `string[]` | 否 | 正在使用的图标名称列表，这些图标会被保留 |
+| `unused` | `string[]` | 否 | 未使用的图标名称列表，这些图标会被移除 |
+| `customUsed` | `string[]` | 否 | 增量追加到 `used` 列表（不覆盖预设或已有的 `used`） |
+| `customUnused` | `string[]` | 否 | 增量追加到 `unused` 列表（不覆盖预设或已有的 `unused`） |
+| `selectorPattern` | `RegExp` | 否 | 选择器匹配模式。使用 `mode` 时可省略 |
+| `debug` | `boolean` | 否 | 是否开启调试模式 |
+
+> `mode` 和 `file` 至少需要指定一个。当 `mode` 和 `file`/`selectorPattern` 同时指定时，`file`/`selectorPattern` 优先。
+
+### Options（标准模式）
+
+| 属性 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `list` | `FileConfig[]` | 是 | 配置列表 |
+| `debug` | `boolean` | 否 | 是否开启调试模式 |
+
+### FileConfig
+
+| 属性 | 类型 | 是否必填 | 说明 |
+| --- | --- | --- | --- |
+| `file` | `RegExp \| string` | 是 | 文件匹配规则，可以是字符串或正则表达式 |
+| `used` | `string[]` | 否 | 正在使用的图标名称列表，这些图标会被保留 |
+| `unused` | `string[]` | 否 | 未使用的图标名称列表，这些图标会被移除 |
+| `customUsed` | `string[]` | 否 | 增量追加到 `used` 列表（不覆盖已有的 `used`） |
+| `customUnused` | `string[]` | 否 | 增量追加到 `unused` 列表（不覆盖已有的 `unused`） |
+| `selectorPattern` | `RegExp` | 否 | 选择器匹配模式，只处理匹配该模式的选择器 |
+
+### 内置预设
+
+| mode | 说明 | 默认 file | 默认 selectorPattern |
+| --- | --- | --- | --- |
+| `tdesign` | TDesign UniApp 图标减包 | `/[@/]tdesign[/]uniapp[/]dist[/]icon[/]icon\.[css\|vue]/` | `/^\.t-icon-[\w-]+:before$/` |
 
 ## 4. 更新日志
 
-[点此查看](../changelog/postcss-plugin-remove-selector.md)
+[点此查看](https://novlan1.github.io/plugins/changelog/postcss-plugin-remove-selector.html)
 
 ## 5. 效果
 
-使用此插件，可使小程序大小减少`15KB`。
+以 [tdesign-uniapp-starter](https://github.com/TDesignOteam/tdesign-uniapp-starter) 为例，使用此插件，可使小程序大小减少`138KB`，约`95.8%`。
+
+使用前：
+
+<img src="https://cdn.uwayfly.com/article/2026/2/own_mike_4w2yXDz3tMcaJ2nx.png" width="600">
 
-<img src="https://mike-1255355338.cos.ap-guangzhou.myqcloud.com/article/2025/3/own_mike_5110452c29f3a22c3a.png" width="600">
+使用后：
 
-<img src="https://mike-1255355338.cos.ap-guangzhou.myqcloud.com/article/2025/3/own_mike_d5703094c04270a6d5.png" width="600">
+<img src="https://cdn.uwayfly.com/article/2026/2/own_mike_dsdB5TmAaedmkPr5.png" width="600">

packages/postcss-plugin-remove-selector/README.md

@@ -123,12 +123,16 @@ export default defineConfig({
 
 ## 4. 更新日志
 
-[点此查看](./CHANGELOG.md)
+[点此查看](https://novlan1.github.io/plugins/changelog/postcss-plugin-remove-selector.html)
 
 ## 5. 效果
 
-使用此插件，可使小程序大小减少`15KB`。
+以 [tdesign-uniapp-starter](https://github.com/TDesignOteam/tdesign-uniapp-starter) 为例，使用此插件，可使小程序大小减少`138KB`，约`95.8%`。
 
-<img src="https://mike-1255355338.cos.ap-guangzhou.myqcloud.com/article/2025/3/own_mike_5110452c29f3a22c3a.png" width="600">
+使用前：
 
-<img src="https://mike-1255355338.cos.ap-guangzhou.myqcloud.com/article/2025/3/own_mike_d5703094c04270a6d5.png" width="600">
+<img src="https://cdn.uwayfly.com/article/2026/2/own_mike_4w2yXDz3tMcaJ2nx.png" width="600">
+
+使用后：
+
+<img src="https://cdn.uwayfly.com/article/2026/2/own_mike_dsdB5TmAaedmkPr5.png" width="600">

packages/postcss-plugin-remove-selector/src/plugin.ts

@@ -1,9 +1,9 @@
 import { shouldHandleFile, shouldRemoveRule } from './helper';
 import { PRESETS } from './presets';
 
-import type { Options, SimpleOptions } from './types';
+import type { Options, SimpleOptions, PostCSSRoot, PostCSSResult, PostCSSRule, PluginCreator } from './types';
 
-export type { Options, SimpleOptions, FileConfig, ShouldRemoveRuleOptions, PresetMode, Preset } from './types';
+export type { Options, SimpleOptions, FileConfig, ShouldRemoveRuleOptions, PresetMode, Preset, PostCSSRoot, PostCSSResult, PostCSSRule, PostCSSPlugin, PluginCreator } from './types';
 export { shouldHandleFile, shouldRemoveRule, extractIconName } from './helper';
 
 const PLUGIN_NAME = 'postcss-plugin-remove-selector';
@@ -76,7 +76,7 @@ function normalizeOptions(opts: Options | SimpleOptions): Options {
 /**
  * 核心处理逻辑，PostCSS 7 / 8 共用
  */
-function processRoot(root: any, result: any, opts: Options) {
+function processRoot(root: PostCSSRoot, result: PostCSSResult, opts: Options) {
   const { list = [], debug = false } = opts;
   const fileName = result.opts?.from || '';
   const found = shouldHandleFile(list, fileName);
@@ -97,7 +97,7 @@ function processRoot(root: any, result: any, opts: Options) {
 
   let removedCount = 0;
 
-  root.walkRules((rule: any) => {
+  root.walkRules((rule: PostCSSRule) => {
     if (shouldRemoveRule({
       selectorPattern,
       used: mergedUsed,
@@ -129,11 +129,11 @@ function processRoot(root: any, result: any, opts: Options) {
  * @param opts 配置项
  * @returns PostCSS 插件
  */
-const postcssPluginRemoveSelector: any = (opts: Options | SimpleOptions = { list: [] }) => {
+const postcssPluginRemoveSelector: PluginCreator = (opts: Options | SimpleOptions = { list: [] }) => {
   const normalizedOpts = normalizeOptions(opts);
   return {
     postcssPlugin: PLUGIN_NAME,
-    Once(root: any, { result }: any) {
+    Once(root: PostCSSRoot, { result }: { result: PostCSSResult }) {
       processRoot(root, result, normalizedOpts);
     },
   };
@@ -149,13 +149,13 @@ try {
   if (postcss && typeof postcss.plugin === 'function') {
     postcssPluginRemoveSelector.postcss7 = postcss.plugin(
       PLUGIN_NAME,
-      (opts: Options | SimpleOptions = { list: [] }) => (root: any, result: any) => {
+      (opts: Options | SimpleOptions = { list: [] }) => (root: PostCSSRoot, result: PostCSSResult) => {
         const normalizedOpts = normalizeOptions(opts);
         processRoot(root, result, normalizedOpts);
       },
     );
   }
-} catch (e) {
+} catch {
   // postcss 未安装或不支持 postcss.plugin，忽略
 }
 

packages/postcss-plugin-remove-selector/src/types.ts

@@ -82,4 +82,40 @@ export interface ShouldRemoveRuleOptions {
   selector: string;
 }
 
+/**
+ * PostCSS 兼容类型定义
+ * 兼容 PostCSS 7 和 PostCSS 8，避免直接依赖 postcss 包的类型
+ */
+
+/** PostCSS Rule 节点（兼容 v7/v8） */
+export interface PostCSSRule {
+  selector: string;
+  remove(): void;
+}
+
+/** PostCSS Root 节点（兼容 v7/v8） */
+export interface PostCSSRoot {
+  walkRules(callback: (rule: PostCSSRule) => void): void;
+}
+
+/** PostCSS Result 对象（兼容 v7/v8） */
+export interface PostCSSResult {
+  opts?: {
+    from?: string;
+  };
+}
+
+/** PostCSS 8 插件对象 */
+export interface PostCSSPlugin {
+  postcssPlugin: string;
+  Once(root: PostCSSRoot, helpers: { result: PostCSSResult }): void;
+}
+
+/** PostCSS 插件创建函数（含 postcss 标记和 postcss7 兼容） */
+export interface PluginCreator {
+  (opts?: Options | SimpleOptions): PostCSSPlugin;
+  postcss: true;
+  postcss7?: (opts?: Options | SimpleOptions) => (root: PostCSSRoot, result: PostCSSResult) => void;
+}
+