@pathscale/rsbuild-plugin-ui-css-purge 0.9.2 → 0.9.3

package/dist/postbuild-purge.d.ts

@@ -2,45 +2,57 @@
 /**
  * Postbuild CSS purge — standalone Bun script.
  *
- * Runs after rsbuild build, purges CSS files in dist/ using the purge manifest
- * and consumer JSX analysis. Zero Node imports.
+ * Runs after rsbuild build, purges CSS files in dist/ using a database-first
+ * component manifest and consumer JSX usage analysis.
  *
- * Three-level purge:
- *   L1 — class-level: drop rules whose class selectors aren't in the safelist (postcss)
- *   L2 — attr-level: drop rules with data/aria attribute selectors for unused props (postcss)
- *   L3 — var cleanup: iteratively remove declared-but-unreferenced CSS custom properties (postcss)
- *   Final — minification via Lightning CSS
- *
- * Usage:
- *   bunx @pathscale/rsbuild-plugin-ui-css-purge \
- *     --dist dist --src src --manifest node_modules/@pathscale/ui/dist/purge-manifest.json
+ * Conservative rules:
+ *   - selectors owned only by unused known components can be removed
+ *   - selectors owned by used components but unused known prop variants can be removed
+ *   - selectors with unknown ownership are kept
+ *   - data/aria runtime state is kept when the owning component selector is kept
+ *   - vars/keyframes are removed only after selector purge proves them unreferenced
  */
-import type { PurgeManifest } from "./scan-consumer";
-interface KillListResult {
-    killList: Set<string>;
-    /**
-     * BEM root classes of components the consumer actually uses. Used to
-     * preserve pure attribute selector rules like
-     * `[data-slot="checkbox-default-indicator--checkmark"]` that have no class
-     * reference but are still component-scoped.
-     */
-    usedBemRoots: Set<string>;
+import type { LegacyComponentManifest, PurgeManifest, Safelists } from "./scan-consumer";
+interface NormalizedComponentRecord extends LegacyComponentManifest {
+    key: string;
+    component: string;
+    part?: string;
+    selectors: string[];
+    attributeSelectors: string[];
+    cssVars: {
+        declared: string[];
+        referenced: string[];
+    };
+    keyframes: {
+        declared: string[];
+        referenced: string[];
+    };
 }
-export declare function buildKillList(manifest: PurgeManifest, importedComponents: Set<string>): KillListResult;
-/**
- * Extract all `[data-slot="..."]` attribute values from a selector. Handles
- * quoted and unquoted forms (Lightning CSS strips quotes when the value is a
- * simple identifier-like token, so post-minify CSS often looks like
- * `[data-slot=checkbox-default-indicator--checkmark]`).
- */
-export declare function extractDataSlotValues(sel: string): string[];
-/**
- * True when every `[data-slot="X"]` in `sel` belongs to a used component —
- * X matches one of `usedBemRoots` as exact, or as `root-`, `root__`, `root--`
- * prefix. Returns false when the selector has no `[data-slot]` at all
- * (caller decides via other heuristics) or when any slot doesn't match.
- */
-export declare function dataSlotsMatchUsedRoots(sel: string, usedBemRoots: Set<string>): boolean;
-export declare function isKeepableNonClassSelector(sel: string, usedBemRoots?: Set<string>): boolean;
-export declare function purgeClasses(css: string, killList: Set<string>, usedBemRoots?: Set<string>): string;
-export {};
+interface NormalizedPurgeDatabase {
+    version: 2;
+    components: Record<string, NormalizedComponentRecord>;
+}
+declare function normalizePurgeDatabase(manifest: PurgeManifest): NormalizedPurgeDatabase;
+interface SelectorPurgeReport {
+    selectorsKeptKnown: number;
+    selectorsKeptUnknown: number;
+    selectorsRemoved: number;
+    selectorsRemovedUnusedComponent: number;
+    selectorsRemovedUnusedVariant: number;
+    attrSelectorsSeen: number;
+    keyframesRemoved: number;
+    fontFacesRemoved: number;
+}
+interface PurgeResult {
+    css: string;
+    report: SelectorPurgeReport;
+}
+declare function purgeCssWithDatabase(css: string, manifest: PurgeManifest | NormalizedPurgeDatabase, safelists: Safelists): PurgeResult;
+interface VarCleanupResult {
+    css: string;
+    removed: number;
+}
+declare function cleanUnusedVarsWithReport(css: string, externallyReferencedVars: Set<string>): VarCleanupResult;
+declare function cleanUnusedVars(css: string, externallyReferencedVars: Set<string>): string;
+export { cleanUnusedVars, cleanUnusedVarsWithReport, normalizePurgeDatabase, purgeCssWithDatabase, };
+export type { NormalizedPurgeDatabase, PurgeResult, SelectorPurgeReport, VarCleanupResult, };