@ui-entropy/scanner-core 0.1.2 → 0.2.0

package/README.md

@@ -28,7 +28,13 @@ npm install @ui-entropy/scanner-core
 
 **For CLI usage**, install the main package instead:
 ```bash
-npm install -g ui-entropy
+npm install -g @ui-entropy/cli
+```
+
+The CLI includes smart project initialization:
+```bash
+npx @ui-entropy/cli init  # Auto-detects your framework
+npx @ui-entropy/cli scan  # Scan with generated config
 ```
 
 ## 🔧 Quick Start
@@ -97,15 +103,7 @@ Find all class/ID usage across source files.
 
 Calculate waste metrics and identify unused selectors.
 
-## 📈 Real-World Results
-
-| Project | CSS Size | Waste % | Unused Selectors |
-|---------|----------|---------|------------------|
-| build-and-bloom | 45 KB | 72% | 129 selectors |
-| Portfolio Site | 180 KB | 91% | 1,024 selectors |
-| React Dashboard | 89 KB | 38% | 412 selectors |
-
-## 🔗 Related Packages
+##  Related Packages
 
 - **[ui-entropy](https://npmjs.com/package/ui-entropy)** - CLI tool for terminal usage
 - **UI Entropy Dashboard** _(coming soon)_ - Team analytics and historical tracking

package/dist/analyzers/css-waste.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CSS Waste Analyzer
+ *
+ * Analyzes unused CSS selectors and calculates waste percentage.
+ * This is the primary analyzer for v0.1-v0.2 of UI Entropy.
+ */
+import type { Analyzer, AnalyzerContext, AnalyzerResult } from './types.js';
+export interface CSSWasteMetrics {
+    totalClasses: number;
+    totalIds: number;
+    usedClasses: number;
+    usedIds: number;
+    unusedClasses: string[];
+    unusedIds: string[];
+    wastePercentage: number;
+    totalCssBytes: number;
+    wastedBytes: number;
+    totalRules: number;
+}
+/**
+ * CSS Waste Analyzer
+ *
+ * Calculates entropy based on unused CSS selectors.
+ * Score = wastePercentage (0-100)
+ */
+export declare class CSSWasteAnalyzer implements Analyzer {
+    name: string;
+    weight: number;
+    analyze(context: AnalyzerContext): AnalyzerResult;
+    private generateRecommendations;
+}
+/**
+ * Factory function for creating CSS Waste analyzer
+ */
+export declare function cssWasteAnalyzer(): CSSWasteAnalyzer;
+//# sourceMappingURL=css-waste.d.ts.map

package/dist/analyzers/css-waste.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-waste.d.ts","sourceRoot":"","sources":["../../src/analyzers/css-waste.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,IAAI,SAAe;IACnB,MAAM,SAAO;IAEb,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc;IAiEjD,OAAO,CAAC,uBAAuB;CAgChC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAEnD"}

package/dist/analyzers/css-waste.js

@@ -0,0 +1,116 @@
+/**
+ * CSS Waste Analyzer
+ *
+ * Analyzes unused CSS selectors and calculates waste percentage.
+ * This is the primary analyzer for v0.1-v0.2 of UI Entropy.
+ */
+/**
+ * CSS Waste Analyzer
+ *
+ * Calculates entropy based on unused CSS selectors.
+ * Score = wastePercentage (0-100)
+ */
+export class CSSWasteAnalyzer {
+    name = 'CSS Waste';
+    weight = 0.6; // 60% of overall entropy score
+    analyze(context) {
+        const { selectors, usage } = context;
+        // Find unused selectors
+        const unusedClasses = [];
+        const unusedIds = [];
+        let usedClassCount = 0;
+        let usedIdCount = 0;
+        // Check which classes are unused
+        for (const className of selectors.classes) {
+            if (usage.classes.has(className)) {
+                usedClassCount++;
+            }
+            else {
+                unusedClasses.push(className);
+            }
+        }
+        // Check which IDs are unused
+        for (const idName of selectors.ids) {
+            if (usage.ids.has(idName)) {
+                usedIdCount++;
+            }
+            else {
+                unusedIds.push(idName);
+            }
+        }
+        // Calculate waste percentage
+        const totalSelectors = selectors.classes.size + selectors.ids.size;
+        const usedSelectors = usedClassCount + usedIdCount;
+        const unusedSelectors = totalSelectors - usedSelectors;
+        const wastePercentage = totalSelectors > 0
+            ? Math.round((unusedSelectors / totalSelectors) * 100)
+            : 0;
+        // Estimate wasted bytes (proportional to unused selectors)
+        const wastedBytes = Math.round((selectors.totalBytes * wastePercentage) / 100);
+        // Build metrics
+        const metrics = {
+            totalClasses: selectors.classes.size,
+            totalIds: selectors.ids.size,
+            usedClasses: usedClassCount,
+            usedIds: usedIdCount,
+            unusedClasses,
+            unusedIds,
+            wastePercentage,
+            totalCssBytes: selectors.totalBytes,
+            wastedBytes,
+            totalRules: selectors.totalRules,
+        };
+        // Generate recommendations
+        const recommendations = this.generateRecommendations(wastePercentage);
+        return {
+            name: this.name,
+            score: wastePercentage, // Waste % maps directly to entropy score
+            weight: this.weight,
+            metrics,
+            recommendations,
+        };
+    }
+    generateRecommendations(wastePercentage) {
+        if (wastePercentage < 10) {
+            return [
+                'Excellent! Your CSS is highly optimized.',
+                'Continue monitoring to maintain low waste.',
+            ];
+        }
+        else if (wastePercentage < 30) {
+            return [
+                'Good CSS hygiene. Minor cleanup opportunities exist.',
+                'Review unused classes for removal.',
+            ];
+        }
+        else if (wastePercentage < 50) {
+            return [
+                'Moderate waste detected.',
+                'Consider removing unused framework imports.',
+                'Review component-specific stylesheets.',
+            ];
+        }
+        else if (wastePercentage < 75) {
+            return [
+                'High waste detected.',
+                'Use PurgeCSS or Tailwind JIT to eliminate unused styles.',
+                'Avoid importing full CSS frameworks.',
+            ];
+        }
+        else {
+            return [
+                'Critical waste: Significant cleanup needed.',
+                'Enable Tailwind JIT or PurgeCSS immediately.',
+                'Remove unused CSS framework files.',
+                'Consider switching to a utility-first approach.',
+            ];
+        }
+    }
+}
+/**
+ * Factory function for creating CSS Waste analyzer
+ */
+export function cssWasteAnalyzer() {
+    return new CSSWasteAnalyzer();
+}
+//# sourceMappingURL=css-waste.js.map

package/dist/analyzers/duplication.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Duplication Analyzer (Placeholder for v0.3+)
+ *
+ * Analyzes CSS selector duplication and similar styles.
+ * Currently returns score of 0 (no duplication detected).
+ */
+import type { Analyzer, AnalyzerContext, AnalyzerResult } from './types.js';
+export interface DuplicationMetrics {
+    duplicateSelectors: number;
+    similarRules: number;
+    duplicationPercentage: number;
+    potentialSavings: number;
+}
+/**
+ * Duplication Analyzer (v0.3+ feature)
+ *
+ * Detects duplicate selectors and similar CSS rules.
+ * Currently a placeholder that returns 0.
+ */
+export declare class DuplicationAnalyzer implements Analyzer {
+    name: string;
+    weight: number;
+    analyze(_context: AnalyzerContext): AnalyzerResult;
+}
+/**
+ * Factory function for creating Duplication analyzer
+ */
+export declare function duplicationAnalyzer(): DuplicationAnalyzer;
+//# sourceMappingURL=duplication.d.ts.map

package/dist/analyzers/duplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplication.d.ts","sourceRoot":"","sources":["../../src/analyzers/duplication.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,QAAQ;IAClD,IAAI,SAAiB;IACrB,MAAM,SAAO;IAEb,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc;CAuBnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CAEzD"}

package/dist/analyzers/duplication.js

@@ -0,0 +1,44 @@
+/**
+ * Duplication Analyzer (Placeholder for v0.3+)
+ *
+ * Analyzes CSS selector duplication and similar styles.
+ * Currently returns score of 0 (no duplication detected).
+ */
+/**
+ * Duplication Analyzer (v0.3+ feature)
+ *
+ * Detects duplicate selectors and similar CSS rules.
+ * Currently a placeholder that returns 0.
+ */
+export class DuplicationAnalyzer {
+    name = 'Duplication';
+    weight = 0.4; // 40% of overall entropy score
+    analyze(_context) {
+        // TODO: Implement duplication detection in v0.3+
+        // - Find duplicate selectors
+        // - Detect similar CSS rules (same properties, different selectors)
+        // - Calculate consolidation opportunities
+        const metrics = {
+            duplicateSelectors: 0,
+            similarRules: 0,
+            duplicationPercentage: 0,
+            potentialSavings: 0,
+        };
+        return {
+            name: this.name,
+            score: 0, // Placeholder: no duplication detected
+            weight: this.weight,
+            metrics,
+            recommendations: [
+                'Duplication analysis coming in v0.3',
+            ],
+        };
+    }
+}
+/**
+ * Factory function for creating Duplication analyzer
+ */
+export function duplicationAnalyzer() {
+    return new DuplicationAnalyzer();
+}
+//# sourceMappingURL=duplication.js.map

package/dist/analyzers/entropy-engine.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Entropy Score Engine
+ *
+ * Combines multiple analyzers to calculate overall UI Entropy score.
+ */
+import type { Analyzer, AnalyzerContext, EntropyScore } from './types.js';
+/**
+ * Calculate overall entropy score from multiple analyzers
+ *
+ * Formula:
+ *   UI Entropy Score = Σ(analyzer.score × analyzer.weight)
+ *
+ * Example (v0.1):
+ *   = (CSS Waste Score × 0.6) + (Duplication Score × 0.4)
+ *   = (75 × 0.6) + (0 × 0.4)
+ *   = 45
+ */
+export declare function calculateEntropyScore(context: AnalyzerContext, analyzers: Analyzer[]): EntropyScore;
+//# sourceMappingURL=entropy-engine.d.ts.map

package/dist/analyzers/entropy-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entropy-engine.d.ts","sourceRoot":"","sources":["../../src/analyzers/entropy-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAkB,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,QAAQ,EAAE,GACpB,YAAY,CA2Bd"}

package/dist/analyzers/entropy-engine.js

@@ -0,0 +1,48 @@
+/**
+ * Entropy Score Engine
+ *
+ * Combines multiple analyzers to calculate overall UI Entropy score.
+ */
+/**
+ * Calculate overall entropy score from multiple analyzers
+ *
+ * Formula:
+ *   UI Entropy Score = Σ(analyzer.score × analyzer.weight)
+ *
+ * Example (v0.1):
+ *   = (CSS Waste Score × 0.6) + (Duplication Score × 0.4)
+ *   = (75 × 0.6) + (0 × 0.4)
+ *   = 45
+ */
+export function calculateEntropyScore(context, analyzers) {
+    // Run all analyzers
+    const results = analyzers.map(analyzer => analyzer.analyze(context));
+    // Normalize weights to sum to 1.0
+    const totalWeight = results.reduce((sum, r) => sum + r.weight, 0);
+    const normalizedResults = results.map(r => ({
+        ...r,
+        weight: r.weight / totalWeight,
+    }));
+    // Calculate weighted average
+    const overallScore = normalizedResults.reduce((sum, result) => sum + (result.score * result.weight), 0);
+    // Determine severity
+    const severity = getSeverityLevel(overallScore);
+    return {
+        overallScore: Math.round(overallScore),
+        analyzers: normalizedResults,
+        severity,
+    };
+}
+/**
+ * Map entropy score to severity level
+ */
+function getSeverityLevel(score) {
+    if (score < 20)
+        return 'low';
+    if (score < 50)
+        return 'medium';
+    if (score < 75)
+        return 'high';
+    return 'critical';
+}
+//# sourceMappingURL=entropy-engine.js.map

package/dist/analyzers/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Analyzer System Exports
+ */
+export * from './types.js';
+export * from './css-waste.js';
+export * from './duplication.js';
+export * from './entropy-engine.js';
+import type { Analyzer } from './types.js';
+/**
+ * Default analyzer configuration for v0.1
+ *
+ * Weights:
+ * - CSS Waste: 60%
+ * - Duplication: 40% (placeholder, returns 0)
+ */
+export declare function getDefaultAnalyzers(): Analyzer[];
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAKpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,EAAE,CAKhD"}

package/dist/analyzers/index.js

@@ -0,0 +1,24 @@
+/**
+ * Analyzer System Exports
+ */
+export * from './types.js';
+export * from './css-waste.js';
+export * from './duplication.js';
+export * from './entropy-engine.js';
+// Default analyzer set for v0.1
+import { cssWasteAnalyzer } from './css-waste.js';
+import { duplicationAnalyzer } from './duplication.js';
+/**
+ * Default analyzer configuration for v0.1
+ *
+ * Weights:
+ * - CSS Waste: 60%
+ * - Duplication: 40% (placeholder, returns 0)
+ */
+export function getDefaultAnalyzers() {
+    return [
+        cssWasteAnalyzer(),
+        duplicationAnalyzer(),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/analyzers/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Analyzer Plugin System
+ *
+ * Supports pluggable analyzers for different entropy metrics:
+ * - CSS Waste Analyzer (current)
+ * - Duplication Analyzer (future)
+ * - Framework Analyzer (future)
+ * - Accessibility Analyzer (future)
+ */
+import type { ExtractedSelectors } from '../parse-css.js';
+import type { UsageExtractionResult } from '../extract-usage.js';
+import type { CrawlResult } from '../crawl.js';
+/**
+ * Input data available to all analyzers
+ */
+export interface AnalyzerContext {
+    /** Extracted CSS selectors */
+    selectors: ExtractedSelectors;
+    /** Usage data from source files */
+    usage: UsageExtractionResult;
+    /** File crawl results */
+    crawl: CrawlResult;
+}
+/**
+ * Base analyzer result - all analyzers return a score 0-100
+ * where 0 = perfect, 100 = maximum entropy/waste
+ */
+export interface AnalyzerResult {
+    /** Analyzer name */
+    name: string;
+    /** Entropy score (0-100): 0 = perfect, 100 = maximum entropy */
+    score: number;
+    /** Weight in overall entropy calculation (0-1) */
+    weight: number;
+    /** Human-readable metrics */
+    metrics: Record<string, any>;
+    /** Recommendations based on score */
+    recommendations: string[];
+}
+/**
+ * Analyzer plugin interface
+ */
+export interface Analyzer {
+    /** Analyzer name */
+    name: string;
+    /** Weight in overall entropy score (0-1) */
+    weight: number;
+    /** Run the analyzer */
+    analyze(context: AnalyzerContext): AnalyzerResult;
+}
+/**
+ * Combined entropy score result
+ */
+export interface EntropyScore {
+    /** Overall UI Entropy score (0-100) */
+    overallScore: number;
+    /** Individual analyzer results */
+    analyzers: AnalyzerResult[];
+    /** Severity level */
+    severity: 'low' | 'medium' | 'high' | 'critical';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/analyzers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analyzers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,mCAAmC;IACnC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,yBAAyB;IACzB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,qCAAqC;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,qBAAqB;IACrB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CAClD"}

package/dist/analyzers/types.js

@@ -0,0 +1,11 @@
+/**
+ * Analyzer Plugin System
+ *
+ * Supports pluggable analyzers for different entropy metrics:
+ * - CSS Waste Analyzer (current)
+ * - Duplication Analyzer (future)
+ * - Framework Analyzer (future)
+ * - Accessibility Analyzer (future)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { extractSelectors, extractSelectorsFromMultiple, type ExtractedSelectors, type ParseWarning, } from './parse-css.js';
 export { extractUsage, extractUsedClasses, extractUsedIds, extractUsageFromMultiple, type UsageExtractionResult, } from './extract-usage.js';
+export { type Analyzer, type AnalyzerContext, type AnalyzerResult, type EntropyScore, cssWasteAnalyzer, duplicationAnalyzer, CSSWasteAnalyzer, DuplicationAnalyzer, calculateEntropyScore, getDefaultAnalyzers, } from './analyzers/index.js';
 export { analyzeWaste, estimateWastedBytes, type AnalysisResult, } from './analyze.js';
 export { generateReport, generateJsonReport, generateTextReport, generateSummaryReport, type ReportFormat, type JsonReport, } from './report.js';
 export { crawl, crawlSync, type CrawlOptions, type CrawlResult, } from './crawl.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,EACL,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,KAAK,MAAM,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,IAAI,EACJ,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EAGjB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EAGnB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,EACL,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,KAAK,MAAM,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,IAAI,EACJ,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -2,7 +2,13 @@
 export { extractSelectors, extractSelectorsFromMultiple, } from './parse-css.js';
 // Usage Extraction
 export { extractUsage, extractUsedClasses, extractUsedIds, extractUsageFromMultiple, } from './extract-usage.js';
-// Analysis
+// Analyzer System (NEW v0.3+)
+export { 
+// Built-in analyzers
+cssWasteAnalyzer, duplicationAnalyzer, CSSWasteAnalyzer, DuplicationAnalyzer, 
+// Entropy engine
+calculateEntropyScore, getDefaultAnalyzers, } from './analyzers/index.js';
+// Analysis (Legacy)
 export { analyzeWaste, estimateWastedBytes, } from './analyze.js';
 // Reporting
 export { generateReport, generateJsonReport, generateTextReport, generateSummaryReport, } from './report.js';

package/dist/scan.d.ts

@@ -1,6 +1,7 @@
 import { type ParseWarning } from './parse-css.js';
 import { type AnalysisResult } from './analyze.js';
 import { type ReportFormat } from './report.js';
+import { type Analyzer, type EntropyScore } from './analyzers/index.js';
 export interface ScanOptions {
     /**
      * Directory to scan
@@ -18,9 +19,16 @@ export interface ScanOptions {
     cssPatterns?: string[];
     sourcePatterns?: string[];
     ignorePatterns?: string[];
+    /**
+     * Custom analyzers (v0.3+)
+     * @default getDefaultAnalyzers()
+     */
+    analyzers?: Analyzer[];
 }
 export interface ScanResult {
     analysis: AnalysisResult;
+    /** NEW: Entropy score from analyzer system */
+    entropyScore: EntropyScore;
     report: string;
     files: {
         cssFiles: number;

package/dist/scan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CA+D1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,MAAsB,GAAG,MAAM,CAGjE"}
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,8CAA8C;IAC9C,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CA2E1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,MAAsB,GAAG,MAAM,CAGjE"}

package/dist/scan.js

@@ -4,6 +4,7 @@ import { extractSelectorsFromMultiple } from './parse-css.js';
 import { extractUsageFromMultiple } from './extract-usage.js';
 import { analyzeWaste } from './analyze.js';
 import { generateReport } from './report.js';
+import { getDefaultAnalyzers, calculateEntropyScore, } from './analyzers/index.js';
 /**
  * Scan a project directory for CSS waste
  *
@@ -16,7 +17,8 @@ import { generateReport } from './report.js';
  * 6. Generate report
  */
 export function scan(options = {}) {
-    const { baseDir = process.cwd(), format = 'text', cssPatterns, sourcePatterns, ignorePatterns, } = options;
+    const { baseDir = process.cwd(), format = 'text', cssPatterns, sourcePatterns, ignorePatterns, analyzers = getDefaultAnalyzers(), // NEW: Default analyzer set
+     } = options;
     // 1. Load configuration
     const config = getConfig(baseDir);
     // Override with CLI options if provided
@@ -46,13 +48,20 @@ export function scan(options = {}) {
     // 4. Extract usage from source files
     const sourceContents = crawlResult.sourceFiles.map(f => f.content);
     const usage = extractUsageFromMultiple(sourceContents);
-    // 5. Analyze waste
+    // 5. Analyze waste (legacy)
     const analysis = analyzeWaste(selectors, usage);
+    // 5b. NEW: Run analyzer system and calculate entropy score
+    const entropyScore = calculateEntropyScore({
+        selectors,
+        usage,
+        crawl: crawlResult,
+    }, analyzers);
     // 6. Generate report
     const reportFormat = config.output?.format ?? format;
     const report = generateReport(analysis, reportFormat, selectors.warnings);
     return {
         analysis,
+        entropyScore, // NEW: Entropy score included
         report,
         files: {
             cssFiles: crawlResult.stats.totalCssFiles,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ui-entropy/scanner-core",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "type": "module",
   "description": "CSS waste detection engine - finds unused classes and IDs in your codebase",
   "main": "./dist/index.js",