tailwind-styled-v4 5.0.8 → 5.0.10

package/dist/engine.d.mts

@@ -1,4 +1,4 @@
-import { e as AnalyzerSemanticReport, d as AnalyzerReport, h as analyzeWorkspace$1 } from './analyzeWorkspace-DuJKh7Ty.mjs';
+import { e as AnalyzerSemanticReport, d as AnalyzerReport, h as analyzeWorkspace$1 } from './analyzeWorkspace-BS5O4rhC.mjs';
 import { b as ScanWorkspaceResult, a as ScanWorkspaceOptions } from './schemas-DR-SLxZZ.mjs';
 export { S as ScanFileResult } from './schemas-DR-SLxZZ.mjs';
 import { z } from 'zod';
@@ -149,34 +149,71 @@ interface SourceLocation {
     line: number;
     column: number;
 }
+/**
+ * Generate a short fingerprint string from a list of ordered parts.
+ *
+ * Hot path — called on every class conflict check and IR node creation.
+ * Delegates to Rust `create_fingerprint()` (FNV-1a, base-36 output) when the
+ * native binding is available; falls back to the pure-JS djb2 variant otherwise.
+ */
 declare function createFingerprint(parts: string[]): string;
-declare function compareCascadeOrder(a: RuleIR, b: RuleIR): number;
 declare function createResolutionReason(causes: ResolutionCause[], finalDecision: string): ResolutionReason;
 
+/**
+ * tailwind-styled-v4 — Cascade Resolver
+ *
+ * JS layer: state management (rule collection, class registration).
+ * Rust layer: cascade algorithm (sort, compare, resolve winner/loser).
+ *
+ * Moved to native: compareCascade, resolveProperty, buildResolutionReason,
+ * determineCascadeStage — all pure computation, zero browser API.
+ *
+ * Rust #[napi] fn: resolve_cascade(rules_json: String) -> String
+ */
+
 declare class CascadeResolver {
-    private propertyBuckets;
-    private rules;
-    private styleGraph;
-    private resolutions;
-    private classRules;
+    private readonly rules;
+    private readonly classRules;
+    private readonly styleGraph;
     addRule(rule: RuleIR): void;
     addRules(rules: RuleIR[]): void;
-    resolveProperty(property: PropertyId): CascadeResolutionIR | null;
-    resolveAllProperties(): Map<PropertyId, CascadeResolutionIR>;
-    resolveForClass(classRuleIds: RuleId[]): Map<PropertyId, CascadeResolutionIR>;
-    getStyleGraph(): StyleGraphIR;
-    getRule(ruleId: RuleId): RuleIR | undefined;
-    getBucket(property: PropertyId): PropertyBucketIR | undefined;
-    getAllBuckets(): Map<PropertyId, PropertyBucketIR>;
-    getResolution(id: CascadeResolutionId): CascadeResolutionIR | undefined;
     registerClass(className: string, ruleIds: RuleId[]): void;
+    getRule(ruleId: RuleId): RuleIR | undefined;
     getClassRules(className: string): RuleId[] | undefined;
+    getStyleGraph(): StyleGraphIR;
+    /**
+     * Resolve cascade for a specific class.
+     * Delegates sort + winner selection to Rust.
+     */
     resolveByClassName(className: string): {
         resolvedProperties: Map<PropertyId, CascadeResolutionIR>;
     } | null;
-    private addConflictEdge;
+    /**
+     * Resolve cascade for all rules.
+     * Delegates sort + winner selection to Rust.
+     */
+    resolveAllProperties(): Map<PropertyId, CascadeResolutionIR>;
+    /**
+     * Resolve cascade for a specific set of rule IDs.
+     */
+    resolveForClass(classRuleIds: RuleId[]): Map<PropertyId, CascadeResolutionIR>;
+    /**
+     * Resolve cascade for a single property bucket.
+     */
+    resolveProperty(property: PropertyId): CascadeResolutionIR | null;
+    getResolution(_id: CascadeResolutionId): CascadeResolutionIR | undefined;
 }
 
+/**
+ * tailwind-styled-v4 — Cascade Tracer
+ *
+ * Delegates cascade resolution to CascadeResolver (Rust-backed).
+ * JS layer: format trace output only.
+ *
+ * Removed from JS: resolvePropertyTraced, compareCascadeTraced,
+ * buildResolutionReasonTraced, determineCascadeStageTraced.
+ */
+
 interface VariantTrace {
     name: string;
     value: string;
@@ -300,12 +337,6 @@ declare class BundleAnalyzer {
     analyzeAll(scanResult: ScanWorkspaceResult, css: string): Map<string, BundleAnalysisResult>;
     calculateBundleContribution(className: string, css: string): number;
     detectDeadCode(scanResult: ScanWorkspaceResult, css: string): string[];
-    private countClassUsage;
-    private getFilesUsingClass;
-    private extractVariantChains;
-    private extractDependencies;
-    private checkIsDeadCode;
-    private extractClassesFromCss;
 }
 
 interface ImpactReport {
@@ -325,40 +356,66 @@ interface ComponentImpact {
     usageType: "direct" | "variant" | "component";
     variant?: string;
 }
+interface NativeImpactScore {
+    className: string;
+    usageScore: number;
+    sizeScore: number;
+    impactScore: number;
+    usageCount: number;
+    sizeBytes: number;
+}
 declare class ImpactTracker {
     private bundleAnalyzer;
-    private criticalPatterns;
     constructor();
+    analyzeWithBundle(className: string, scanResult: ScanWorkspaceResult, css?: string): ImpactReport;
+    analyzeAll(scanResult: ScanWorkspaceResult, css?: string): Map<string, ImpactReport>;
+    calculateImpact(className: string, bundleAnalysis: BundleAnalysisResult, scanResult: ScanWorkspaceResult | null | undefined, nativeScore?: NativeImpactScore): ImpactReport;
+    findAffectedComponents(className: string, scanResult: ScanWorkspaceResult | null | undefined): ComponentImpact[];
     /**
-     * Analisis impact sebuah class menggunakan BundleAnalyzer untuk dapat
-     * data akurat tentang bundle size contribution.
+     * Cek apakah sebuah class dianggap "critical" (tidak boleh dihapus).
      *
-     * @param className - Tailwind class yang ingin dianalisis
-     * @param scanResult - Hasil scan workspace
-     * @param css - CSS string dari build output (opsional — jika tidak ada, gunakan estimasi)
+     * Native: Rust `is_critical_class()` — O(n) pattern match di CRITICAL_PATTERNS.
+     * Lebih cepat dari regex JS untuk daftar panjang karena no backtracking.
+     *
+     * @example
+     * tracker.isCriticalClass("sr-only")     // true
+     * tracker.isCriticalClass("hidden")      // true
+     * tracker.isCriticalClass("bg-red-500")  // false
      */
-    analyzeWithBundle(className: string, scanResult: ScanWorkspaceResult, css?: string): ImpactReport;
+    isCriticalClass(className: string): boolean;
     /**
-     * Analisis semua class dalam workspace sekaligus.
+     * Generate human-readable suggestions berdasarkan impact analysis.
+     *
+     * Native: `generate_suggestions()` di Rust — pattern matching di CRITICAL_PATTERNS
+     * + threshold-based risk categories.
+     *
+     * Biasanya dipanggil setelah `calculateImpact` yang sudah set riskLevel.
      */
-    analyzeAll(scanResult: ScanWorkspaceResult, css?: string): Map<string, ImpactReport>;
-    calculateImpact(className: string, bundleAnalysis: BundleAnalysisResult, scanResult: ScanWorkspaceResult | null | undefined): ImpactReport;
-    findAffectedComponents(className: string, scanResult: ScanWorkspaceResult | null | undefined): ComponentImpact[];
-    calculateRisk(className: string, impact: ImpactReport): "low" | "medium" | "high";
-    generateSuggestions(className: string, impact: ImpactReport): string[];
-    private isCriticalClass;
-    private calculateSavings;
+    generateSuggestions(className: string, report: ImpactReport): string[];
     private createEmptyReport;
 }
 
 /**
  * Apply an incremental file-change event to an existing scan result.
  *
- * Native-only: Rust processFileChange is required.
- * No JavaScript fallback — native Rust binding must be available.
+ * Semua tiga helper internal sekarang native-first:
+ *   rebuildWorkspaceResult → Rust rebuild_workspace_result
+ *   applyClassDiff         → Rust apply_class_diff
+ *   areClassSetsEqual      → Rust are_class_sets_equal
  */
 declare function applyIncrementalChange(previous: ScanWorkspaceResult, filePath: string, type: "change" | "unlink", scanner?: ScanWorkspaceOptions): ScanWorkspaceResult;
 
+/**
+ * tailwind-styled-v4 — Reverse Lookup
+ *
+ * JS layer: thin wrapper, cache management.
+ * Rust layer: reverseLookupFromCss, reverseLookupByProperty,
+ *             reverseLookupFindDependents (DashMap-backed).
+ *
+ * Removed from JS: parseCSS(), JS filter loops, pruneCache().
+ * All lookup computation is now in native.
+ */
+
 interface ClassUsage {
     className: string;
     source: SourceLocation;
@@ -372,38 +429,47 @@ interface ReverseLookupResult {
     usedInClasses: ClassUsage[];
 }
 declare class ReverseLookup {
-    private parsedCache;
-    private static readonly MAX_CACHE_SIZE;
-    /** Jumlah karakter total yang disimpan di cache (approx) */
-    private cacheSizeBytes;
-    private static readonly MAX_CACHE_BYTES;
-    private parseCSS;
-    private findClosingBrace;
-    private calculateSpecificity;
     fromCSS(cssProperty: string, cssValue: string, css: string): ReverseLookupResult[];
-    fromBundle(className: string, css: string): RuleIR[];
-    findDependents(className: string, css: string): string[];
     findByProperty(property: string, css: string): ReverseLookupResult[];
-    /**
-     * Kosongkan seluruh parsed cache.
-     * Panggil ini saat CSS berubah (watch mode) atau saat memory pressure.
-     */
+    findDependents(className: string, css: string): string[];
+    fromBundle(className: string, css: string): RuleIR[];
     clearCache(): void;
-    /**
-     * Hapus entri cache lama sampai di bawah threshold.
-     * Dipakai oleh parseCSS secara internal.
-     */
-    private pruneCache;
-    /** Cache size untuk observability/diagnostics */
     get cacheSize(): number;
 }
 
+/**
+ * tailwind-styled-v4 — CSS → IR converter
+ *
+ * Native handles: CSS parsing, class extraction, variant splitting, specificity.
+ * JS handles: ID generation, layer detection, RuleIR assembly.
+ *
+ * Removed from JS: parseSelector, calculateSpecificity
+ * (native parseCssRules already returns className/variants/specificity).
+ */
+
+interface ParseCssToIrOptions {
+    prefix?: string;
+}
+declare function parseCssToIr(css: string, options?: ParseCssToIrOptions): {
+    rules: RuleIR[];
+    classToRuleIds: Map<string, RuleId[]>;
+};
+
+/**
+ * watch.ts — File system watcher for tailwind-styled-v4.
+ *
+ * Native-only: uses Rust `notify`-based watcher via NAPI
+ * (`start_watch` / `poll_watch_events` / `stop_watch` from watch_api.rs).
+ *
+ * Polling interval: 200ms (configurable via `pollIntervalMs`).
+ */
 interface WatcherOptions {
+    /** Directories to ignore (currently not enforced by native watcher, kept for API compatibility). */
     ignoreDirectories?: string[];
-    /**
-     * Delay before emitting change event to reduce noisy bursts.
-     */
+    /** Delay before emitting change event to reduce noisy bursts (applied in Rust layer). */
     debounceMs?: number;
+    /** Polling interval in ms for the Rust native watcher (default: 200). */
+    pollIntervalMs?: number;
     onError?: (error: Error, directory: string) => void;
 }
 interface WatcherEvent {
@@ -413,6 +479,11 @@ interface WatcherEvent {
 interface WorkspaceWatcher {
     close(): void;
 }
+/**
+ * watchWorkspace — watches `rootDir` recursively for file changes.
+ *
+ * Requires native Rust watcher. Throws if native binding unavailable.
+ */
 declare function watchWorkspace$1(rootDir: string, onEvent: (event: WatcherEvent) => void, options?: WatcherOptions): WorkspaceWatcher;
 
 /**
@@ -662,4 +733,4 @@ interface InspectionReport {
  */
 declare function inspectClass(className: string, scanResult: ScanWorkspaceResult, css?: string): Promise<InspectionReport>;
 
-export { type BuildResult, type BuildResultInput, BuildResultSchema, type BundleAnalysisResult, BundleAnalyzer, type CascadeResolutionIR, CascadeResolutionId, CascadeStage, type ClassBundleInfo, type ClassUsage, type ComponentImpact, type ConditionIR, ConditionId, ConditionResult, type ConflictTrace, EngineMetricsCollector, type EngineMetricsSnapshot, type EngineOptions, type EngineOptionsInput, EngineOptionsSchema, type EnginePlugin, type EnginePluginContext, type EngineWatchContext, type EngineWatchEvent, type EngineWatchOptions, type EngineWatchOptionsInput, EngineWatchOptionsSchema, type FinalComputedStyleIR, type FinalStyleProperty, type ImpactReport, ImpactTracker, Importance, type InspectionReport, LayerId, Origin, type PropertyBucketIR, PropertyId, type ResolutionCause, type ResolutionReason, ReverseLookup, type ReverseLookupResult, type RuleIR, RuleId, type RuleTrace, ScanWorkspaceOptions, ScanWorkspaceResult, type SelectorIR, SelectorId, type SourceLocation, type StyleGraphIR, type TailwindStyledEngine, type TraceResult, ValueId, type VariantChainIR, VariantChainId, type VariantTrace, type WatchCallback, type WatchEvent, type WatchEventKind, type WatchHandle, type WorkspaceWatcher, analyzeWorkspace, applyIncrementalChange, build, buildProvenanceChain, compareCascadeOrder, createEngine, createFingerprint, createResolutionReason, generateSafelist, inspectClass, parseEngineOptions, parseEngineWatchOptions, runAfterBuild, runAfterScan, runAfterWatch, runBeforeBuild, runBeforeScan, runBeforeWatch, runOnError, runTransformClasses, scanWorkspace, trace, traceClass, traceClasses, watchWorkspace$1 as watchWorkspaceLegacy, watchWorkspace as watchWorkspaceNative };
+export { type BuildResult, type BuildResultInput, BuildResultSchema, type BundleAnalysisResult, BundleAnalyzer, type CascadeResolutionIR, CascadeResolutionId, CascadeResolver, CascadeStage, type ClassBundleInfo, type ClassUsage, type ComponentImpact, type ConditionIR, ConditionId, ConditionResult, type ConflictTrace, EngineMetricsCollector, type EngineMetricsSnapshot, type EngineOptions, type EngineOptionsInput, EngineOptionsSchema, type EnginePlugin, type EnginePluginContext, type EngineWatchContext, type EngineWatchEvent, type EngineWatchOptions, type EngineWatchOptionsInput, EngineWatchOptionsSchema, type FinalComputedStyleIR, type FinalStyleProperty, type ImpactReport, ImpactTracker, Importance, type InspectionReport, LayerId, Origin, type PropertyBucketIR, PropertyId, type ResolutionCause, type ResolutionReason, ReverseLookup, type ReverseLookupResult, type RuleIR, RuleId, type RuleTrace, ScanWorkspaceOptions, ScanWorkspaceResult, type SelectorIR, SelectorId, type SourceLocation, type StyleGraphIR, type TailwindStyledEngine, type TraceResult, ValueId, type VariantChainIR, VariantChainId, type VariantTrace, type WatchCallback, type WatchEvent, type WatchEventKind, type WatchHandle, type WorkspaceWatcher, analyzeWorkspace, applyIncrementalChange, build, buildProvenanceChain, createEngine, createFingerprint, createResolutionReason, generateSafelist, inspectClass, parseCssToIr, parseEngineOptions, parseEngineWatchOptions, runAfterBuild, runAfterScan, runAfterWatch, runBeforeBuild, runBeforeScan, runBeforeWatch, runOnError, runTransformClasses, scanWorkspace, trace, traceClass, traceClasses, watchWorkspace$1 as watchWorkspaceLegacy, watchWorkspace as watchWorkspaceNative };

package/dist/engine.d.ts

@@ -1,4 +1,4 @@
-import { e as AnalyzerSemanticReport, d as AnalyzerReport, h as analyzeWorkspace$1 } from './analyzeWorkspace-Ct_NTAWt.js';
+import { e as AnalyzerSemanticReport, d as AnalyzerReport, h as analyzeWorkspace$1 } from './analyzeWorkspace-DDOQdzzI.js';
 import { b as ScanWorkspaceResult, a as ScanWorkspaceOptions } from './schemas-DR-SLxZZ.js';
 export { S as ScanFileResult } from './schemas-DR-SLxZZ.js';
 import { z } from 'zod';
@@ -149,34 +149,71 @@ interface SourceLocation {
     line: number;
     column: number;
 }
+/**
+ * Generate a short fingerprint string from a list of ordered parts.
+ *
+ * Hot path — called on every class conflict check and IR node creation.
+ * Delegates to Rust `create_fingerprint()` (FNV-1a, base-36 output) when the
+ * native binding is available; falls back to the pure-JS djb2 variant otherwise.
+ */
 declare function createFingerprint(parts: string[]): string;
-declare function compareCascadeOrder(a: RuleIR, b: RuleIR): number;
 declare function createResolutionReason(causes: ResolutionCause[], finalDecision: string): ResolutionReason;
 
+/**
+ * tailwind-styled-v4 — Cascade Resolver
+ *
+ * JS layer: state management (rule collection, class registration).
+ * Rust layer: cascade algorithm (sort, compare, resolve winner/loser).
+ *
+ * Moved to native: compareCascade, resolveProperty, buildResolutionReason,
+ * determineCascadeStage — all pure computation, zero browser API.
+ *
+ * Rust #[napi] fn: resolve_cascade(rules_json: String) -> String
+ */
+
 declare class CascadeResolver {
-    private propertyBuckets;
-    private rules;
-    private styleGraph;
-    private resolutions;
-    private classRules;
+    private readonly rules;
+    private readonly classRules;
+    private readonly styleGraph;
     addRule(rule: RuleIR): void;
     addRules(rules: RuleIR[]): void;
-    resolveProperty(property: PropertyId): CascadeResolutionIR | null;
-    resolveAllProperties(): Map<PropertyId, CascadeResolutionIR>;
-    resolveForClass(classRuleIds: RuleId[]): Map<PropertyId, CascadeResolutionIR>;
-    getStyleGraph(): StyleGraphIR;
-    getRule(ruleId: RuleId): RuleIR | undefined;
-    getBucket(property: PropertyId): PropertyBucketIR | undefined;
-    getAllBuckets(): Map<PropertyId, PropertyBucketIR>;
-    getResolution(id: CascadeResolutionId): CascadeResolutionIR | undefined;
     registerClass(className: string, ruleIds: RuleId[]): void;
+    getRule(ruleId: RuleId): RuleIR | undefined;
     getClassRules(className: string): RuleId[] | undefined;
+    getStyleGraph(): StyleGraphIR;
+    /**
+     * Resolve cascade for a specific class.
+     * Delegates sort + winner selection to Rust.
+     */
     resolveByClassName(className: string): {
         resolvedProperties: Map<PropertyId, CascadeResolutionIR>;
     } | null;
-    private addConflictEdge;
+    /**
+     * Resolve cascade for all rules.
+     * Delegates sort + winner selection to Rust.
+     */
+    resolveAllProperties(): Map<PropertyId, CascadeResolutionIR>;
+    /**
+     * Resolve cascade for a specific set of rule IDs.
+     */
+    resolveForClass(classRuleIds: RuleId[]): Map<PropertyId, CascadeResolutionIR>;
+    /**
+     * Resolve cascade for a single property bucket.
+     */
+    resolveProperty(property: PropertyId): CascadeResolutionIR | null;
+    getResolution(_id: CascadeResolutionId): CascadeResolutionIR | undefined;
 }
 
+/**
+ * tailwind-styled-v4 — Cascade Tracer
+ *
+ * Delegates cascade resolution to CascadeResolver (Rust-backed).
+ * JS layer: format trace output only.
+ *
+ * Removed from JS: resolvePropertyTraced, compareCascadeTraced,
+ * buildResolutionReasonTraced, determineCascadeStageTraced.
+ */
+
 interface VariantTrace {
     name: string;
     value: string;
@@ -300,12 +337,6 @@ declare class BundleAnalyzer {
     analyzeAll(scanResult: ScanWorkspaceResult, css: string): Map<string, BundleAnalysisResult>;
     calculateBundleContribution(className: string, css: string): number;
     detectDeadCode(scanResult: ScanWorkspaceResult, css: string): string[];
-    private countClassUsage;
-    private getFilesUsingClass;
-    private extractVariantChains;
-    private extractDependencies;
-    private checkIsDeadCode;
-    private extractClassesFromCss;
 }
 
 interface ImpactReport {
@@ -325,40 +356,66 @@ interface ComponentImpact {
     usageType: "direct" | "variant" | "component";
     variant?: string;
 }
+interface NativeImpactScore {
+    className: string;
+    usageScore: number;
+    sizeScore: number;
+    impactScore: number;
+    usageCount: number;
+    sizeBytes: number;
+}
 declare class ImpactTracker {
     private bundleAnalyzer;
-    private criticalPatterns;
     constructor();
+    analyzeWithBundle(className: string, scanResult: ScanWorkspaceResult, css?: string): ImpactReport;
+    analyzeAll(scanResult: ScanWorkspaceResult, css?: string): Map<string, ImpactReport>;
+    calculateImpact(className: string, bundleAnalysis: BundleAnalysisResult, scanResult: ScanWorkspaceResult | null | undefined, nativeScore?: NativeImpactScore): ImpactReport;
+    findAffectedComponents(className: string, scanResult: ScanWorkspaceResult | null | undefined): ComponentImpact[];
     /**
-     * Analisis impact sebuah class menggunakan BundleAnalyzer untuk dapat
-     * data akurat tentang bundle size contribution.
+     * Cek apakah sebuah class dianggap "critical" (tidak boleh dihapus).
      *
-     * @param className - Tailwind class yang ingin dianalisis
-     * @param scanResult - Hasil scan workspace
-     * @param css - CSS string dari build output (opsional — jika tidak ada, gunakan estimasi)
+     * Native: Rust `is_critical_class()` — O(n) pattern match di CRITICAL_PATTERNS.
+     * Lebih cepat dari regex JS untuk daftar panjang karena no backtracking.
+     *
+     * @example
+     * tracker.isCriticalClass("sr-only")     // true
+     * tracker.isCriticalClass("hidden")      // true
+     * tracker.isCriticalClass("bg-red-500")  // false
      */
-    analyzeWithBundle(className: string, scanResult: ScanWorkspaceResult, css?: string): ImpactReport;
+    isCriticalClass(className: string): boolean;
     /**
-     * Analisis semua class dalam workspace sekaligus.
+     * Generate human-readable suggestions berdasarkan impact analysis.
+     *
+     * Native: `generate_suggestions()` di Rust — pattern matching di CRITICAL_PATTERNS
+     * + threshold-based risk categories.
+     *
+     * Biasanya dipanggil setelah `calculateImpact` yang sudah set riskLevel.
      */
-    analyzeAll(scanResult: ScanWorkspaceResult, css?: string): Map<string, ImpactReport>;
-    calculateImpact(className: string, bundleAnalysis: BundleAnalysisResult, scanResult: ScanWorkspaceResult | null | undefined): ImpactReport;
-    findAffectedComponents(className: string, scanResult: ScanWorkspaceResult | null | undefined): ComponentImpact[];
-    calculateRisk(className: string, impact: ImpactReport): "low" | "medium" | "high";
-    generateSuggestions(className: string, impact: ImpactReport): string[];
-    private isCriticalClass;
-    private calculateSavings;
+    generateSuggestions(className: string, report: ImpactReport): string[];
     private createEmptyReport;
 }
 
 /**
  * Apply an incremental file-change event to an existing scan result.
  *
- * Native-only: Rust processFileChange is required.
- * No JavaScript fallback — native Rust binding must be available.
+ * Semua tiga helper internal sekarang native-first:
+ *   rebuildWorkspaceResult → Rust rebuild_workspace_result
+ *   applyClassDiff         → Rust apply_class_diff
+ *   areClassSetsEqual      → Rust are_class_sets_equal
  */
 declare function applyIncrementalChange(previous: ScanWorkspaceResult, filePath: string, type: "change" | "unlink", scanner?: ScanWorkspaceOptions): ScanWorkspaceResult;
 
+/**
+ * tailwind-styled-v4 — Reverse Lookup
+ *
+ * JS layer: thin wrapper, cache management.
+ * Rust layer: reverseLookupFromCss, reverseLookupByProperty,
+ *             reverseLookupFindDependents (DashMap-backed).
+ *
+ * Removed from JS: parseCSS(), JS filter loops, pruneCache().
+ * All lookup computation is now in native.
+ */
+
 interface ClassUsage {
     className: string;
     source: SourceLocation;
@@ -372,38 +429,47 @@ interface ReverseLookupResult {
     usedInClasses: ClassUsage[];
 }
 declare class ReverseLookup {
-    private parsedCache;
-    private static readonly MAX_CACHE_SIZE;
-    /** Jumlah karakter total yang disimpan di cache (approx) */
-    private cacheSizeBytes;
-    private static readonly MAX_CACHE_BYTES;
-    private parseCSS;
-    private findClosingBrace;
-    private calculateSpecificity;
     fromCSS(cssProperty: string, cssValue: string, css: string): ReverseLookupResult[];
-    fromBundle(className: string, css: string): RuleIR[];
-    findDependents(className: string, css: string): string[];
     findByProperty(property: string, css: string): ReverseLookupResult[];
-    /**
-     * Kosongkan seluruh parsed cache.
-     * Panggil ini saat CSS berubah (watch mode) atau saat memory pressure.
-     */
+    findDependents(className: string, css: string): string[];
+    fromBundle(className: string, css: string): RuleIR[];
     clearCache(): void;
-    /**
-     * Hapus entri cache lama sampai di bawah threshold.
-     * Dipakai oleh parseCSS secara internal.
-     */
-    private pruneCache;
-    /** Cache size untuk observability/diagnostics */
     get cacheSize(): number;
 }
 
+/**
+ * tailwind-styled-v4 — CSS → IR converter
+ *
+ * Native handles: CSS parsing, class extraction, variant splitting, specificity.
+ * JS handles: ID generation, layer detection, RuleIR assembly.
+ *
+ * Removed from JS: parseSelector, calculateSpecificity
+ * (native parseCssRules already returns className/variants/specificity).
+ */
+
+interface ParseCssToIrOptions {
+    prefix?: string;
+}
+declare function parseCssToIr(css: string, options?: ParseCssToIrOptions): {
+    rules: RuleIR[];
+    classToRuleIds: Map<string, RuleId[]>;
+};
+
+/**
+ * watch.ts — File system watcher for tailwind-styled-v4.
+ *
+ * Native-only: uses Rust `notify`-based watcher via NAPI
+ * (`start_watch` / `poll_watch_events` / `stop_watch` from watch_api.rs).
+ *
+ * Polling interval: 200ms (configurable via `pollIntervalMs`).
+ */
 interface WatcherOptions {
+    /** Directories to ignore (currently not enforced by native watcher, kept for API compatibility). */
     ignoreDirectories?: string[];
-    /**
-     * Delay before emitting change event to reduce noisy bursts.
-     */
+    /** Delay before emitting change event to reduce noisy bursts (applied in Rust layer). */
     debounceMs?: number;
+    /** Polling interval in ms for the Rust native watcher (default: 200). */
+    pollIntervalMs?: number;
     onError?: (error: Error, directory: string) => void;
 }
 interface WatcherEvent {
@@ -413,6 +479,11 @@ interface WatcherEvent {
 interface WorkspaceWatcher {
     close(): void;
 }
+/**
+ * watchWorkspace — watches `rootDir` recursively for file changes.
+ *
+ * Requires native Rust watcher. Throws if native binding unavailable.
+ */
 declare function watchWorkspace$1(rootDir: string, onEvent: (event: WatcherEvent) => void, options?: WatcherOptions): WorkspaceWatcher;
 
 /**
@@ -662,4 +733,4 @@ interface InspectionReport {
  */
 declare function inspectClass(className: string, scanResult: ScanWorkspaceResult, css?: string): Promise<InspectionReport>;
 
-export { type BuildResult, type BuildResultInput, BuildResultSchema, type BundleAnalysisResult, BundleAnalyzer, type CascadeResolutionIR, CascadeResolutionId, CascadeStage, type ClassBundleInfo, type ClassUsage, type ComponentImpact, type ConditionIR, ConditionId, ConditionResult, type ConflictTrace, EngineMetricsCollector, type EngineMetricsSnapshot, type EngineOptions, type EngineOptionsInput, EngineOptionsSchema, type EnginePlugin, type EnginePluginContext, type EngineWatchContext, type EngineWatchEvent, type EngineWatchOptions, type EngineWatchOptionsInput, EngineWatchOptionsSchema, type FinalComputedStyleIR, type FinalStyleProperty, type ImpactReport, ImpactTracker, Importance, type InspectionReport, LayerId, Origin, type PropertyBucketIR, PropertyId, type ResolutionCause, type ResolutionReason, ReverseLookup, type ReverseLookupResult, type RuleIR, RuleId, type RuleTrace, ScanWorkspaceOptions, ScanWorkspaceResult, type SelectorIR, SelectorId, type SourceLocation, type StyleGraphIR, type TailwindStyledEngine, type TraceResult, ValueId, type VariantChainIR, VariantChainId, type VariantTrace, type WatchCallback, type WatchEvent, type WatchEventKind, type WatchHandle, type WorkspaceWatcher, analyzeWorkspace, applyIncrementalChange, build, buildProvenanceChain, compareCascadeOrder, createEngine, createFingerprint, createResolutionReason, generateSafelist, inspectClass, parseEngineOptions, parseEngineWatchOptions, runAfterBuild, runAfterScan, runAfterWatch, runBeforeBuild, runBeforeScan, runBeforeWatch, runOnError, runTransformClasses, scanWorkspace, trace, traceClass, traceClasses, watchWorkspace$1 as watchWorkspaceLegacy, watchWorkspace as watchWorkspaceNative };
+export { type BuildResult, type BuildResultInput, BuildResultSchema, type BundleAnalysisResult, BundleAnalyzer, type CascadeResolutionIR, CascadeResolutionId, CascadeResolver, CascadeStage, type ClassBundleInfo, type ClassUsage, type ComponentImpact, type ConditionIR, ConditionId, ConditionResult, type ConflictTrace, EngineMetricsCollector, type EngineMetricsSnapshot, type EngineOptions, type EngineOptionsInput, EngineOptionsSchema, type EnginePlugin, type EnginePluginContext, type EngineWatchContext, type EngineWatchEvent, type EngineWatchOptions, type EngineWatchOptionsInput, EngineWatchOptionsSchema, type FinalComputedStyleIR, type FinalStyleProperty, type ImpactReport, ImpactTracker, Importance, type InspectionReport, LayerId, Origin, type PropertyBucketIR, PropertyId, type ResolutionCause, type ResolutionReason, ReverseLookup, type ReverseLookupResult, type RuleIR, RuleId, type RuleTrace, ScanWorkspaceOptions, ScanWorkspaceResult, type SelectorIR, SelectorId, type SourceLocation, type StyleGraphIR, type TailwindStyledEngine, type TraceResult, ValueId, type VariantChainIR, VariantChainId, type VariantTrace, type WatchCallback, type WatchEvent, type WatchEventKind, type WatchHandle, type WorkspaceWatcher, analyzeWorkspace, applyIncrementalChange, build, buildProvenanceChain, createEngine, createFingerprint, createResolutionReason, generateSafelist, inspectClass, parseCssToIr, parseEngineOptions, parseEngineWatchOptions, runAfterBuild, runAfterScan, runAfterWatch, runBeforeBuild, runBeforeScan, runBeforeWatch, runOnError, runTransformClasses, scanWorkspace, trace, traceClass, traceClasses, watchWorkspace$1 as watchWorkspaceLegacy, watchWorkspace as watchWorkspaceNative };