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

package/dist/postbuild-purge.d.ts

@@ -2,17 +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
  */
-export {};
+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[];
+    };
+}
+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, };