tailwind-styled-v4 5.0.12 → 5.0.13

package/dist/compiler.d.ts

@@ -358,6 +358,54 @@ interface NativeBridge {
     reset_compilation_metrics?: () => string;
     validate_css_output?: (css: string) => string;
     get_compiler_diagnostics?: () => string;
+    configureCacheBackend?: (configJson: string) => string;
+    getRecommendedCacheConfig?: (workloadType: string) => string;
+    clearAllCachesNapi?: () => void;
+    clearResolveCacheNapi?: () => void;
+    clearCompileCacheNapi?: () => void;
+    clearCssGenCacheNapi?: () => void;
+    getResolverPoolStats?: () => string;
+    clearResolverPool?: () => string;
+    getCacheOptimizationHints?: () => string;
+    estimateStreamingBatchSize?: (targetMemoryMb: number) => string;
+    parseClass?: (input: string) => string;
+    compileClassNapi?: (input: string) => string;
+    getParseStats?: () => string;
+    clearParseCacheNapi?: () => void;
+    parseColorsNapi?: (colorsJson: string) => string | Record<string, string>;
+    parseSpacingNapi?: (spacingJson: string) => string | Record<string, string>;
+    parseTransformNapi?: (transformJson: string) => string | Record<string, string>;
+    normalizeColorNapi?: (color: string, opacity: string) => string;
+    sanitizeColorNapi?: (color: string) => string;
+    splitRgbaNapi?: (color: string) => string | {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    validateColorsNapi?: (colorsJson: string) => boolean;
+    validateBreakpointsNapi?: (breakpointsJson: string) => boolean;
+    runHealthCheck?: () => void;
+    watchFiles?: (rootDir: string, optionsJson?: string | null) => string;
+    stopWatching?: (handleId: number) => string;
+    getWatchEvents?: (handleId: number, maxEvents?: number | null) => string;
+    getWatchPerformance?: () => string;
+    clearWatchStats?: () => string;
+    getActiveWatches?: () => number;
+    setWatchMetrics?: (metricName: string, value: string) => string;
+    setWatchAggregation?: (aggregationType: string) => string;
+    getOptimizationRecommendations?: (hitRate: number, memoryMb: number, classCount: number) => string;
+    estimateOptimalBatchSize?: (totalClasses: number, memoryAvailableMb: number) => number;
+    predictMemoryUsage?: (uniqueClasses: number, avgClassSizeBytes: number) => number;
+    recommendCachingStrategy?: (isSsr: boolean, memoryConstraintMb: number) => string;
+    benchmarkStreamingVsBuffered?: (classCount: number) => string;
+    getWeek6OptimizationStatus?: () => string;
+    scanCacheGet?: (filePath: string, contentHash: string) => string[] | null;
+    scanCachePut?: (filePath: string, contentHash: string, classes: string[], mtimeMs: number, size: number) => void;
+    scanCacheInvalidate?: (filePath: string) => void;
+    scanCacheStats?: () => {
+        size: number;
+    };
 }
 interface NativeTransformResult {
     code: string;
@@ -387,12 +435,10 @@ declare const adaptNativeResult: (raw: NativeTransformResult) => {
  * cssGeneratorNative.ts
  *
  * High-performance CSS generator using Rust compiler via NAPI binding.
- * Falls back to JavaScript Tailwind if Rust binding is unavailable.
+ * Rust-only implementation - no JavaScript fallback.
  */
 interface GenerateCssNativeOptions {
     theme: Record<string, unknown>;
-    fallbackToJs?: boolean;
-    logFallback?: boolean;
 }
 /**
  * Generate CSS from Tailwind classes using the Rust compiler.
@@ -458,77 +504,6 @@ declare function getCacheStats(): {
  */
 declare function clearThemeCache(): void;
 
-declare function scanWorkspace(root: string, extensions?: string[]): ScanWorkspaceResult;
-declare function extractClassesFromSourceNative(source: string): string[];
-declare function batchExtractClassesNative(filePaths: string[]): BatchExtractResult[];
-declare function checkAgainstSafelistNative(classes: string[], safelist: string[]): SafelistCheckResult;
-declare function scanFile(filePath: string): ScanFileResult;
-declare function collectFiles(root: string, extensions?: string[]): string[];
-declare function walkAndPrefilterSourceFiles(root: string, extensions?: string[], _parallel?: boolean): PrefilterFileResult[];
-declare function generateSubComponentTypes(root: string, outputPath?: string): string;
-
-/**
- * Detect dead CSS selectors in generated CSS.
- */
-declare function detectDeadCode(scanResultJson: string, css: string): DeadCodeResult;
-/**
- * Analyze class usage across scanned files.
- */
-declare function analyzeClassUsageNative(classes: string[], scanResultJson: string, css: string): ClassUsageItem[];
-/**
- * Analyze entire class list and generate CSS.
- */
-declare function analyzeClassesNative(filesJson: string, cwd: string, flags?: number): {
-    css?: string;
-    code: string;
-    classes: string[];
-    changed: boolean;
-    rscJson?: string;
-    metadataJson?: string;
-    safelist?: string[];
-} | null;
-/**
- * Analyze React Server Component requirements.
- */
-declare function analyzeRscNative(source: string, filename: string): {
-    isServer: boolean;
-    needsClientDirective: boolean;
-    clientReasons: string[];
-};
-/**
- * Optimize CSS by removing dead code and minifying.
- */
-declare function optimizeCssNative(css: string): {
-    css: string;
-    originalSize: number;
-    optimizedSize: number;
-    reductionPercentage: number;
-};
-/**
- * Process Tailwind CSS with Lightning CSS post-processing.
- */
-declare function processTailwindCssLightning(css: string): ProcessedCssResult;
-/**
- * Eliminate dead CSS selectors.
- */
-declare function eliminateDeadCssNative(css: string, deadClasses: string[]): string;
-/**
- * Hoist components from source code.
- */
-declare function hoistComponentsNative(source: string): HoistResult;
-/**
- * Compile variant configuration table.
- */
-declare function compileVariantTableNative(configJson: string): VariantTableResult;
-/**
- * Classify and sort classes by bucket.
- */
-declare function classifyAndSortClassesNative(classes: string[]): ClassifyResult[];
-/**
- * Merge CSS declarations from multiple chunks.
- */
-declare function mergeCssDeclarationsNative(cssChunks: string[]): MergeResult;
-
 /**
  * Compile Tailwind classes directly to CSS.
  */
@@ -598,1144 +573,1269 @@ declare function clearAtomicRegistry(): void;
 declare function atomicRegistrySize(): number;
 
 /**
- * cacheNative.ts
+ * cssCompilationNative.ts
  *
- * Phase 5.1: Cache Management - Advanced caching strategies and optimization
- * Exposes 9 cache-related Rust functions for improved performance tuning
+ * Phase 5.2: Advanced CSS Compilation - Complex CSS generation and transformations
+ * Exposes 12 CSS compilation functions for animations, themes, and merging
  */
 /**
- * Cache optimization hints and recommendations
+ * Compiled CSS rule result
  */
-interface CacheOptimizationHints {
-    current_strategy: string;
-    recommended_strategy: string;
-    estimated_improvement_percent: number;
-    suggested_memory_mb: number;
-    notes: string[];
+interface CompiledCssRule {
+    selector: string;
+    declarations: string;
+    properties: Array<{
+        key: string;
+        value: string;
+    }>;
+    specificity: number;
 }
 /**
- * Optimal cache configuration recommendations
+ * Compiled animation result
  */
-interface OptimalCacheConfig {
-    parse_cache_size: number;
-    resolve_cache_size: number;
-    compile_cache_size: number;
-    css_gen_cache_size: number;
-    recommended_eviction_policy: string;
-    ttl_seconds: number;
-    expected_hit_rate_percent: number;
+interface CompiledAnimation {
+    animation_id: string;
+    keyframes_css: string;
+    animation_rule: string;
+    duration_ms: number;
 }
 /**
- * Cache statistics from all layers
+ * Compiled theme result
  */
-interface CacheStatistics {
-    parse_cache: {
-        hits: number;
-        misses: number;
-        size: number;
-    };
-    resolve_cache: {
-        hits: number;
-        misses: number;
-        size: number;
-    };
-    compile_cache: {
-        hits: number;
-        misses: number;
-        size: number;
-    };
-    css_gen_cache: {
-        hits: number;
-        misses: number;
-        size: number;
-    };
-    overall_hit_rate: number;
-    total_memory_bytes: number;
+interface CompiledTheme {
+    selector: string;
+    variables: Array<{
+        name: string;
+        value: string;
+    }>;
+    variables_css: string;
+    theme_name: string;
 }
 /**
- * Get comprehensive cache statistics across all layers
- * Useful for monitoring and optimization
- *
- * @returns Cache stats including hit rates, sizes, and recommendations
- * @example
- * ```ts
- * const stats = getCacheStatistics()
- * console.log(`Overall hit rate: ${stats.overall_hit_rate}%`)
- * console.log(`Total memory used: ${stats.total_memory_bytes / 1024}KB`)
- * ```
+ * CSS compile result with metadata
  */
-declare function getCacheStatistics(): CacheStatistics;
+interface CssCompileResult {
+    css: string;
+    resolved_classes: string[];
+    unknown_classes: string[];
+    size_bytes: number;
+    duration_ms: number;
+}
 /**
- * Clear all caches (parse, resolve, compile, CSS generation)
- * Use when switching themes or major configuration changes
+ * tw_merge options
+ */
+interface TwMergeOptions {
+    separator?: string;
+    debug?: boolean;
+}
+/**
+ * Compile a single Tailwind class to CSS rule
+ * Full compilation pipeline: parse → resolve → generate
+ *
+ * @param input - Single Tailwind class (e.g., "md:hover:bg-blue-600/50")
+ * @returns Compiled CSS rule as JSON
  *
  * @example
  * ```ts
- * // Clear before switching themes
- * clearAllCaches()
- * const css = await generateCssNative(classes, { theme: newTheme })
+ * const rule = compileClass('md:hover:bg-blue-600')
+ * // Returns: {
+ * //   selector: '.md\\:hover\\:bg-blue-600',
+ * //   declarations: 'background-color: #2563eb;',
+ * //   ...
+ * // }
  * ```
  */
-declare function clearAllCaches(): void;
-/**
- * Clear only the parse cache
- * Useful when parser behavior changes or cache gets stale
- */
-declare function clearParseCache(): void;
-/**
- * Clear only the resolve cache
- * Use when theme configuration changes
- */
-declare function clearResolveCache(): void;
-/**
- * Clear only the compile cache
- * Use when Tailwind configuration changes
- */
-declare function clearCompileCache(): void;
-/**
- * Clear only the CSS generation cache
- * Use when theme or layout changes
- */
-declare function clearCssGenCache(): void;
+declare function compileClass(input: string): CompiledCssRule;
 /**
- * Get optimization hints based on current cache performance
- * Analyzes hit rates and suggests improvements
+ * Compile multiple Tailwind classes to CSS rules
+ * Batch processing with parallel compilation
  *
- * @param hitRatePercent - Current hit rate (0-100)
- * @param memoryUsedMb - Memory currently used in MB
- * @returns Optimization recommendations
+ * @param inputs - Array of Tailwind classes
+ * @returns JSON string of compiled rules
  *
  * @example
  * ```ts
- * const stats = getCacheStatistics()
- * const hints = getCacheOptimizationHints(
- *   stats.overall_hit_rate,
- *   stats.total_memory_bytes / (1024 * 1024)
- * )
- * console.log(`Recommendation: ${hints.recommended_strategy}`)
- * console.log(`Potential improvement: ${hints.estimated_improvement_percent}%`)
+ * const rules = compileClasses(['px-4', 'bg-blue-600', 'hover:opacity-80'])
  * ```
  */
-declare function getCacheOptimizationHints(hitRatePercent: number, memoryUsedMb: number): CacheOptimizationHints;
+declare function compileClasses(inputs: string[]): CssCompileResult;
 /**
- * Estimate optimal cache configuration for your workload
- * Analyzes typical patterns and recommends sizes
+ * One-step: class → CSS string
+ * Compiles and generates in single call
  *
- * @param totalBudgetMb - Maximum memory budget in MB
- * @param workloadType - "small" (< 100 files), "medium" (100-1000), "large" (1000+)
- * @returns Recommended cache configuration
+ * @param input - Single Tailwind class
+ * @param minify - Whether to minify output (default: false)
+ * @returns Generated CSS string
  *
  * @example
  * ```ts
- * const config = estimateOptimalCacheConfig(512, 'large')
- * console.log(`Parse cache: ${config.parse_cache_size}MB`)
- * console.log(`Expected hit rate: ${config.expected_hit_rate_percent}%`)
+ * const css = compileToCss('bg-blue-600')
+ * // Returns: ".bg-blue-600 { background-color: #2563eb; }"
+ *
+ * const minified = compileToCss('bg-blue-600', true)
+ * // Returns: ".bg-blue-600{background-color:#2563eb}"
  * ```
  */
-declare function estimateOptimalCacheConfig(totalBudgetMb: number, workloadType: "small" | "medium" | "large"): OptimalCacheConfig;
+declare function compileToCss(input: string, minify?: boolean): string;
 /**
- * Read cache from disk (persistence)
- * Restores cached data from previous sessions
+ * Batch compile to CSS
+ * Compiles multiple classes and generates combined CSS
  *
- * @param cachePath - Path to cache file
- * @returns Entries loaded from disk
+ * @param inputs - Array of Tailwind classes
+ * @param minify - Whether to minify output
+ * @returns Combined CSS string
  *
  * @example
  * ```ts
- * const entries = cacheRead('./.tw-cache/scan.json')
- * // Warm up cache with persisted data
+ * const css = compileToCssBatch(['px-4', 'bg-blue-600'], true)
  * ```
  */
-declare function cacheRead(cachePath: string): Array<{
-    file: string;
-    contentHash: string;
-    classes: string[];
-    mtimeMs: number;
-    sizeBytes: number;
-}>;
+declare function compileToCssBatch(inputs: string[], minify?: boolean): string;
 /**
- * Write cache to disk (persistence)
- * Saves cached data for next session
+ * Minify CSS string
+ * Removes unnecessary whitespace and formatting
  *
- * @param cachePath - Path where cache should be written
- * @param entries - Cache entries to persist
- * @returns Success status
+ * @param css - Raw CSS string
+ * @returns Minified CSS (40-60% size reduction)
  *
  * @example
  * ```ts
- * const stats = getCacheStatistics()
- * const success = cacheWrite(
- *   './.tw-cache/scan.json',
- *   // entries array from previous scan
- * )
+ * const css = ".px-4 { padding-left: 1rem; padding-right: 1rem; }"
+ * const minified = minifyCss(css)
+ * // Returns: ".px-4{padding-left:1rem;padding-right:1rem}"
  * ```
  */
-declare function cacheWrite(cachePath: string, entries: Array<{
-    file: string;
-    contentHash: string;
-    classes: string[];
-    mtimeMs: number;
-    sizeBytes: number;
-}>): boolean;
+declare function minifyCss(css: string): string;
 /**
- * Calculate cache priority score for file ordering
- * Useful for prioritizing which files to scan first
+ * Compile animation from from/to states
+ * Generates @keyframes and animation rule
  *
- * @param mtimeMs - File modification time in milliseconds
- * @param sizeBytes - File size in bytes
- * @param hitCount - Number of times this file was accessed from cache
- * @returns Priority score (higher = process first)
+ * @param animationName - Animation name
+ * @param from - From state classes (e.g., "opacity-0 scale-95")
+ * @param to - To state classes (e.g., "opacity-100 scale-100")
+ * @returns Compiled animation with keyframes
  *
  * @example
  * ```ts
- * const priority = cachePriority(Date.now(), 2048, 5)
- * // Use priority to sort files for scanning
+ * const anim = compileAnimation('fade-in', 'opacity-0', 'opacity-100')
+ * console.log(anim.keyframes_css)  // @keyframes fade-in { ... }
+ * console.log(anim.animation_rule) // animation: fade-in 300ms;
  * ```
  */
-declare function cachePriority(mtimeMs: number, sizeBytes: number, hitCount: number): number;
-
-/**
- * themeResolutionNative.ts
- *
- * Phase 5.1: Theme Resolution Extended - Advanced theme configuration handling
- * Exposes 7 theme resolution functions for complex Tailwind configurations
- */
-/**
- * Validation result for theme config
- */
-interface ThemeValidationResult {
-    is_valid: boolean;
-    errors: string[];
-    warnings: string[];
-    suggestions: string[];
-}
-/**
- * Resolved variant configuration
- */
-interface ResolvedVariantConfig {
-    variants: string[];
-    supported: string[];
-    deprecated: string[];
-    conflicting: string[];
-}
-/**
- * Theme cascade resolution result
- */
-interface ThemeCascadeResult {
-    base_theme: Record<string, unknown>;
-    user_overrides: Record<string, unknown>;
-    merged_theme: Record<string, unknown>;
-    conflict_resolutions: Array<{
-        key: string;
-        base_value: unknown;
-        override_value: unknown;
-        resolution: "override" | "merge" | "error";
-    }>;
-}
-/**
- * Class name resolution from theme
- */
-interface ResolvedClassName {
-    class_name: string;
-    property: string;
-    value: string;
-    from_theme_path: string;
-    is_responsive: boolean;
-    variants: string[];
-}
-/**
- * Conflict group information
- */
-interface ConflictGroupInfo {
-    group_name: string;
-    conflicting_classes: string[];
-    description: string;
-    resolution_strategy: string;
-}
+declare function compileAnimation(animationName: string, from: string, to: string): CompiledAnimation;
 /**
- * Get all resolved variants from theme configuration
- * Parses theme config and returns all variant prefixes
+ * Compile keyframes from stop definitions
+ * Creates @keyframes from percentage stops
  *
- * @param configJson - JSON string of theme configuration
- * @returns Resolved variants with metadata
+ * @param name - Keyframes name
+ * @param stopsJson - JSON array of stops: `[{"stop":"0%","classes":"opacity-0"}...]`
+ * @returns Compiled @keyframes rule
  *
  * @example
  * ```ts
- * const config = {
- *   screens: { md: '768px', lg: '1024px' },
- *   state: { hover: '&:hover', focus: '&:focus' }
- * }
- * const variants = resolveVariants(JSON.stringify(config))
- * console.log(variants.variants)  // ['md', 'lg', 'hover', 'focus', ...]
+ * const kf = compileKeyframes('slide-in', JSON.stringify([
+ *   { stop: '0%', classes: 'translate-x-full' },
+ *   { stop: '100%', classes: 'translate-x-0' }
+ * ]))
  * ```
  */
-declare function resolveVariants(configJson: string): ResolvedVariantConfig;
+declare function compileKeyframes(name: string, stopsJson: string): CompiledAnimation;
 /**
- * Validate theme configuration for correctness
- * Checks for common issues and provides warnings
+ * Compile theme to CSS variables
+ * Converts token map to CSS custom properties
  *
- * @param configJson - JSON string of theme configuration
- * @returns Validation result with errors and suggestions
+ * @param tokensJson - Theme tokens as JSON
+ * @param themeName - Theme name ("light", "dark", etc.)
+ * @param prefix - CSS variable prefix (e.g., "tw" → "--tw-color-primary")
+ * @returns Compiled theme with variables CSS
  *
  * @example
  * ```ts
- * const result = validateThemeConfig(JSON.stringify(myTheme))
- * if (!result.is_valid) {
- *   console.error('Errors:', result.errors)
- *   console.warn('Warnings:', result.warnings)
- * }
+ * const theme = compileTheme(
+ *   JSON.stringify({ colors: { blue: { 600: '#2563eb' } } }),
+ *   'light',
+ *   'tw'
+ * )
+ * // Returns CSS: :root { --tw-color-blue-600: #2563eb; }
  * ```
  */
-declare function validateThemeConfig(configJson: string): ThemeValidationResult;
+declare function compileTheme(tokensJson: string, themeName: string, prefix: string): CompiledTheme;
 /**
- * Resolve theme cascade (base + overrides)
- * Merges base theme with user overrides intelligently
+ * Merge conflicting Tailwind classes
+ * Resolves conflicts intelligently (last-one-wins by default)
  *
- * @param baseThemeJson - Base theme configuration
- * @param overridesJson - User overrides configuration
- * @returns Merged theme with conflict information
+ * @param classString - Space-separated class string (e.g., "px-4 px-8 bg-red-500 bg-blue-600")
+ * @returns Merged classes with conflicts resolved
  *
  * @example
  * ```ts
- * const cascade = resolveCascade(
- *   JSON.stringify(baseTheme),
- *   JSON.stringify(userOverrides)
- * )
- * console.log(cascade.merged_theme)
- * console.log('Conflicts resolved:', cascade.conflict_resolutions.length)
+ * const merged = twMerge('px-4 px-8 bg-red-500 bg-blue-600')
+ * // Returns: "px-8 bg-blue-600"
  * ```
  */
-declare function resolveCascade(baseThemeJson: string, overridesJson: string): ThemeCascadeResult;
+declare function twMerge(classString: string): string;
 /**
- * Resolve class names from theme
- * Maps Tailwind class names to theme values
+ * Merge multiple class strings
+ * Combines and resolves conflicts across multiple strings
  *
- * @param classNames - Array of Tailwind class names (e.g., ["text-lg", "bg-blue-600"])
- * @param themeJson - Theme configuration
- * @returns Resolved class name information
+ * @param classStrings - Array of class strings
+ * @returns Merged result
  *
  * @example
  * ```ts
- * const resolved = resolveClassNames(
- *   ['text-lg', 'bg-blue-600', 'md:p-4'],
- *   JSON.stringify(theme)
- * )
- * resolved.forEach(item => {
- *   console.log(`${item.class_name} -> ${item.property}: ${item.value}`)
- * })
+ * const merged = twMergeMany([
+ *   'px-4 hover:bg-blue-600',
+ *   'px-8 hover:opacity-80'
+ * ])
+ * // Returns: "px-8 hover:bg-blue-600 hover:opacity-80"
  * ```
  */
-declare function resolveClassNames(classNames: string[], themeJson: string): ResolvedClassName[];
+declare function twMergeMany(classStrings: string[]): string;
 /**
- * Get conflict group information
- * Identifies classes that conflict with each other
+ * Merge with custom separator
+ * Useful for non-standard class separators
  *
- * @param groupName - Conflict group name (e.g., "display", "position", "flex-direction")
- * @param themeJson - Theme configuration
- * @returns Information about the conflict group
+ * @param classString - Classes to merge
+ * @param options - Merge options (separator, debug)
+ * @returns Merged classes
  *
  * @example
  * ```ts
- * const info = resolveConflictGroup('display', JSON.stringify(theme))
- * console.log('Conflicting classes:', info.conflicting_classes)
- * console.log('Strategy:', info.resolution_strategy)
+ * const merged = twMergeWithSeparator(
+ *   'px-4,px-8,bg-red-500,bg-blue-600',
+ *   { separator: ',' }
+ * )
  * ```
  */
-declare function resolveConflictGroup(groupName: string, themeJson: string): ConflictGroupInfo;
+declare function twMergeWithSeparator(classString: string, options: TwMergeOptions): string;
 /**
- * Resolve theme value from key path
- * Navigates nested theme config to find values
- *
- * @param keyPath - Dot-separated path (e.g., "colors.blue.600")
- * @param themeJson - Theme configuration
- * @returns Resolved value or null if not found
+ * Merge many with custom separator
+ * Batch merge with custom separator
  *
- * @example
- * ```ts
- * const color = resolveThemeValue('colors.blue.600', JSON.stringify(theme))
- * console.log(color)  // "#2563eb" or similar
- * ```
+ * @param classStrings - Array of class strings
+ * @param options - Merge options
+ * @returns Merged result
  */
-declare function resolveThemeValue(keyPath: string, themeJson: string): string | null;
+declare function twMergeManyWithSeparator(classStrings: string[], options: TwMergeOptions): string;
 /**
- * Get all simple variants from configuration
- * Returns variants that don't require complex selector nesting
+ * Raw merge from class lists
+ * Direct merge without preprocessing
  *
- * @param configJson - Theme/variant configuration
- * @returns Array of simple variant names
+ * @param classLists - Array of class lists
+ * @returns Merged classes
  *
  * @example
  * ```ts
- * const simpleVariants = resolveSimpleVariants(JSON.stringify(config))
- * console.log(simpleVariants)
- * // ["hover", "focus", "active", "group-hover", ...]
+ * const merged = twMergeRaw(['px-4 px-8', 'bg-red bg-blue'])
  * ```
  */
-declare function resolveSimpleVariants(configJson: string): string[];
+declare function twMergeRaw(classLists: string[]): string;
 
 /**
- * streamingNative.ts
+ * idRegistryNative.ts
  *
- * Phase 5.1: Streaming & Incremental Processing - Handle file changes efficiently
- * Exposes 8 functions for real-time incremental compilation
- */
-/**
- * File change notification
- */
-interface FileChangeEvent {
-    file_path: string;
-    event_type: "added" | "modified" | "deleted";
-    old_content?: string;
-    new_content?: string;
-    timestamp_ms: number;
-}
-/**
- * Processed file change result
- */
-interface ProcessedFileChange {
-    file_path: string;
-    status: "processed" | "skipped" | "error";
-    old_classes: string[];
-    new_classes: string[];
-    added_classes: string[];
-    removed_classes: string[];
-    changed: boolean;
-    fingerprint: string;
-    error?: string;
-}
-/**
- * Diff between two scan results
- */
-interface FileDiff {
-    added_files: string[];
-    removed_files: string[];
-    modified_files: string[];
-    added_classes: string[];
-    removed_classes: string[];
-    total_changes: number;
-}
-/**
- * File fingerprint for change detection
- */
-interface FileFingerprint {
-    file_path: string;
-    content_hash: string;
-    size_bytes: number;
-    mtime_ms: number;
-    class_hash: string;
-    signature: string;
-}
-/**
- * Incremental diff result
- */
-interface IncrementalDiffResult {
-    is_changed: boolean;
-    changes_count: number;
-    diff: FileDiff;
-    processing_time_ms: number;
-}
-/**
- * State injection result
- */
-interface StateInjectionResult {
-    injected: boolean;
-    state_hash: string;
-    affected_files: number;
-    total_injected_bytes: number;
-}
-/**
- * Stale entry pruning result
+ * Phase 5.2: ID Registry Management - Efficient ID generation and lookup
+ * Exposes 16 ID registry functions for deterministic class/component identification
  */
-interface PruneResult {
-    entries_before: number;
-    entries_after: number;
-    entries_removed: number;
-    freed_bytes: number;
-}
 /**
- * Rebuilt workspace result
+ * Registry snapshot data
  */
-interface RebuildWorkspaceResult {
-    total_files_scanned: number;
-    total_classes_found: number;
-    unique_classes: number;
-    build_time_ms: number;
-    files_with_changes: number;
+interface RegistrySnapshot {
+    handle: number;
+    next_id: number;
+    entries: Array<{
+        name: string;
+        id: number;
+    }>;
+    total_entries: number;
 }
 /**
- * Process a single file change event
- * Called when a file is added, modified, or deleted
+ * Create a new ID generator
+ * Returns a handle to be used in subsequent operations
  *
- * @param fileChangeJson - JSON string describing the file change
- * @returns Processing result with class changes
+ * @returns Generator handle (u32)
  *
  * @example
  * ```ts
- * const change = processFileChange(JSON.stringify({
- *   file_path: 'src/Button.tsx',
- *   event_type: 'modified',
- *   new_content: 'export const Button = ...',
- *   timestamp_ms: Date.now()
- * }))
- *
- * console.log('Added classes:', change.added_classes)
- * console.log('Removed classes:', change.removed_classes)
+ * const handle = idRegistryCreate()
+ * // Use handle for all subsequent operations
+ * try {
+ *   const id = idRegistryGenerate(handle, 'MyComponent')
+ *   // ... use id ...
+ * } finally {
+ *   idRegistryDestroy(handle)  // Clean up
+ * }
  * ```
  */
-declare function processFileChange(fileChangeJson: string): ProcessedFileChange;
+declare function idRegistryCreate(): number;
 /**
- * Compute incremental diff between old and new scan results
- * Efficient way to identify only what changed
+ * Generate a new ID for a name
+ * Same name always returns same ID (deterministic)
  *
- * @param oldScanJson - JSON string of previous scan result
- * @param newScanJson - JSON string of new scan result
- * @returns Diff showing what changed
+ * @param handle - Generator handle from idRegistryCreate()
+ * @param name - Identifier name (e.g., component name, class name)
+ * @returns Generated ID
  *
  * @example
  * ```ts
- * const oldResult = scanWorkspace('./src')
- * // ... files changed ...
- * const newResult = scanWorkspace('./src')
- *
- * const diff = computeIncrementalDiff(
- *   JSON.stringify(oldResult),
- *   JSON.stringify(newResult)
- * )
- *
- * if (diff.is_changed) {
- *   console.log(`${diff.changes_count} files changed`)
- *   console.log('Added:', diff.diff.added_classes)
- *   console.log('Removed:', diff.diff.removed_classes)
- * }
+ * const handle = idRegistryCreate()
+ * const id1 = idRegistryGenerate(handle, 'Button')  // Returns 1
+ * const id2 = idRegistryGenerate(handle, 'Button')  // Returns 1 (same)
+ * const id3 = idRegistryGenerate(handle, 'Card')    // Returns 2 (different)
  * ```
  */
-declare function computeIncrementalDiff(oldScanJson: string, newScanJson: string): IncrementalDiffResult;
+declare function idRegistryGenerate(handle: number, name: string): number;
 /**
- * Create a fingerprint of a file for change detection
- * Use fingerprints to quickly check if file needs reprocessing
+ * Lookup existing ID for a name
+ * Returns -1 if not found
  *
- * @param filePath - Path to file
- * @param fileContent - File content
- * @returns File fingerprint
+ * @param handle - Generator handle
+ * @param name - Name to look up
+ * @returns ID if found, -1 if not found
  *
  * @example
  * ```ts
- * const fingerprint = createFingerprint('src/Button.tsx', fileContent)
- * // Store fingerprint, check later if content changed
- * const newFingerprint = createFingerprint('src/Button.tsx', newContent)
- * if (fingerprint.signature !== newFingerprint.signature) {
- *   // Content changed, needs reprocessing
+ * const id = idRegistryLookup(handle, 'Button')
+ * if (id !== -1) {
+ *   console.log(`Button has ID: ${id}`)
+ * } else {
+ *   console.log('Button not in registry yet')
  * }
  * ```
  */
-declare function createFingerprint(filePath: string, fileContent: string): FileFingerprint;
+declare function idRegistryLookup(handle: number, name: string): number;
 /**
- * Inject state hash into compiled CSS
- * Marks CSS with version/state hash for cache busting
+ * Get the next ID that would be assigned
+ * Useful for knowing how many unique IDs exist
  *
- * @param css - Raw CSS string
- * @param stateHash - State hash to inject
- * @returns Modified CSS with injected state
+ * @param handle - Generator handle
+ * @returns Next available ID
  *
  * @example
  * ```ts
- * const css = compileCssNative2(['px-4', 'bg-blue-600'])
- * const withState = injectStateHash(css, 'v5-hash-123')
- * // CSS now includes version marker for cache control
+ * const handle = idRegistryCreate()
+ * idRegistryGenerate(handle, 'Button')
+ * idRegistryGenerate(handle, 'Card')
+ * const nextId = idRegistryNext(handle)  // Returns 2 (next available)
  * ```
  */
-declare function injectStateHash(css: string, stateHash: string): StateInjectionResult;
+declare function idRegistryNext(handle: number): number;
 /**
- * Prune stale entries from cache
- * Removes old/unused cache entries to free memory
+ * Destroy a registry (clean up resources)
+ * Must be called when done with registry
  *
- * @param maxAgeSeconds - Remove entries older than this many seconds
- * @param maxEntries - Keep only this many most-recent entries
- * @returns Result of pruning operation
+ * @param handle - Generator handle
  *
  * @example
  * ```ts
- * // Remove cache entries older than 1 hour, keep max 10000 entries
- * const result = pruneStaleCacheEntries(3600, 10000)
- * console.log(`Freed ${result.freed_bytes / 1024}KB`)
+ * const handle = idRegistryCreate()
+ * try {
+ *   // Use registry
+ * } finally {
+ *   idRegistryDestroy(handle)
+ * }
  * ```
  */
-declare function pruneStaleCacheEntries(maxAgeSeconds: number, maxEntries: number): PruneResult;
+declare function idRegistryDestroy(handle: number): void;
 /**
- * Rebuild workspace result from scratch
- * Useful after major configuration changes
+ * Reset registry to initial state
+ * Clears all entries but reuses handle
  *
- * @param rootDir - Root directory to scan
- * @param extensions - File extensions to scan (e.g., [".tsx", ".ts"])
- * @returns Rebuilt workspace result
+ * @param handle - Generator handle
  *
  * @example
  * ```ts
- * const result = rebuildWorkspaceResult('./src', ['.tsx', '.ts'])
- * console.log(`Found ${result.unique_classes} unique classes`)
- * console.log(`${result.files_with_changes} files had changes`)
+ * const handle = idRegistryCreate()
+ * idRegistryGenerate(handle, 'Component1')
+ * idRegistryGenerate(handle, 'Component2')
+ * idRegistryReset(handle)  // Clear all
+ * const id = idRegistryNext(handle)  // Back to 0
  * ```
  */
-declare function rebuildWorkspaceResult(rootDir: string, extensions?: string[]): RebuildWorkspaceResult;
+declare function idRegistryReset(handle: number): void;
 /**
- * Scan a single file with incremental state
- * Returns only new/changed classes since last scan
+ * Get snapshot of current registry state
+ * Useful for serialization/debugging
  *
- * @param filePath - Path to file
- * @param fileContent - File content
- * @returns Updated classes and change status
+ * @param handle - Generator handle
+ * @returns Snapshot with all entries
  *
  * @example
  * ```ts
- * // On file change, get only what changed
- * const file = scanFileNative('src/Button.tsx', newContent)
- * if (file.changed) {
- *   console.log('Added:', file.added_classes)
- *   console.log('Removed:', file.removed_classes)
- * }
+ * const handle = idRegistryCreate()
+ * idRegistryGenerate(handle, 'Button')
+ * idRegistryGenerate(handle, 'Card')
+ * const snapshot = idRegistrySnapshot(handle)
+ * console.log(JSON.stringify(snapshot, null, 2))
  * ```
  */
-declare function scanFileNative(filePath: string, fileContent: string): {
-    file: string;
-    classes: string[];
-    added_classes: string[];
-    removed_classes: string[];
-    changed: boolean;
-};
+declare function idRegistrySnapshot(handle: number): RegistrySnapshot;
 /**
- * Scan multiple files in batch with incremental state
- * Efficient batch processing of file changes
+ * Get count of active registries
+ * Useful for monitoring resource usage
  *
- * @param filesJson - JSON array of {file, content} objects
- * @returns Results for each file
+ * @returns Number of active generator handles
  *
  * @example
  * ```ts
- * const files = [
- *   { file: 'src/Button.tsx', content: newButtonContent },
- *   { file: 'src/Card.tsx', content: newCardContent }
- * ]
- * const results = scanFilesBatchNative(JSON.stringify(files))
+ * console.log(`Active registries: ${idRegistryActiveCount()}`)
  * ```
  */
-declare function scanFilesBatchNative(filesJson: string): Array<{
-    file: string;
-    classes: string[];
-    changed: boolean;
-}>;
-
-/**
- * cssCompilationNative.ts
- *
- * Phase 5.2: Advanced CSS Compilation - Complex CSS generation and transformations
- * Exposes 12 CSS compilation functions for animations, themes, and merging
- */
-/**
- * Compiled CSS rule result
- */
-interface CompiledCssRule {
-    selector: string;
-    declarations: string;
-    properties: Array<{
-        key: string;
-        value: string;
-    }>;
-    specificity: number;
-}
-/**
- * Compiled animation result
- */
-interface CompiledAnimation {
-    animation_id: string;
-    keyframes_css: string;
-    animation_rule: string;
-    duration_ms: number;
-}
-/**
- * Compiled theme result
- */
-interface CompiledTheme {
-    selector: string;
-    variables: Array<{
-        name: string;
-        value: string;
-    }>;
-    variables_css: string;
-    theme_name: string;
-}
-/**
- * CSS compile result with metadata
- */
-interface CssCompileResult {
-    css: string;
-    resolved_classes: string[];
-    unknown_classes: string[];
-    size_bytes: number;
-    duration_ms: number;
-}
-/**
- * tw_merge options
- */
-interface TwMergeOptions {
-    separator?: string;
-    debug?: boolean;
-}
+declare function idRegistryActiveCount(): number;
 /**
- * Compile a single Tailwind class to CSS rule
- * Full compilation pipeline: parse → resolve → generate
+ * Register a property name with global registry
+ * Maps property names to consistent IDs
  *
- * @param input - Single Tailwind class (e.g., "md:hover:bg-blue-600/50")
- * @returns Compiled CSS rule as JSON
+ * @param propertyName - Property name (e.g., "background-color")
+ * @returns Assigned property ID
  *
  * @example
  * ```ts
- * const rule = compileClass('md:hover:bg-blue-600')
- * // Returns: {
- * //   selector: '.md\\:hover\\:bg-blue-600',
- * //   declarations: 'background-color: #2563eb;',
- * //   ...
- * // }
+ * const bgColorId = registerPropertyName('background-color')
+ * const paddingId = registerPropertyName('padding')
  * ```
  */
-declare function compileClass(input: string): CompiledCssRule;
+declare function registerPropertyName(propertyName: string): number;
 /**
- * Compile multiple Tailwind classes to CSS rules
- * Batch processing with parallel compilation
+ * Register a value name with global registry
+ * Maps values to consistent IDs
  *
- * @param inputs - Array of Tailwind classes
- * @returns JSON string of compiled rules
+ * @param valueName - Value name (e.g., "blue-600")
+ * @returns Assigned value ID
  *
  * @example
  * ```ts
- * const rules = compileClasses(['px-4', 'bg-blue-600', 'hover:opacity-80'])
+ * const blueId = registerValueName('blue-600')
+ * const redId = registerValueName('red-500')
  * ```
  */
-declare function compileClasses(inputs: string[]): CssCompileResult;
+declare function registerValueName(valueName: string): number;
 /**
- * One-step: class → CSS string
- * Compiles and generates in single call
+ * Convert property ID back to name
+ * Reverse lookup for serialized data
  *
- * @param input - Single Tailwind class
- * @param minify - Whether to minify output (default: false)
- * @returns Generated CSS string
+ * @param propertyId - Property ID
+ * @returns Property name or empty string if not found
  *
  * @example
  * ```ts
- * const css = compileToCss('bg-blue-600')
- * // Returns: ".bg-blue-600 { background-color: #2563eb; }"
- *
- * const minified = compileToCss('bg-blue-600', true)
- * // Returns: ".bg-blue-600{background-color:#2563eb}"
+ * const bgColorId = registerPropertyName('background-color')
+ * const name = propertyIdToString(bgColorId)
+ * console.log(name)  // "background-color"
  * ```
  */
-declare function compileToCss(input: string, minify?: boolean): string;
+declare function propertyIdToString(propertyId: number): string;
 /**
- * Batch compile to CSS
- * Compiles multiple classes and generates combined CSS
+ * Convert value ID back to name
+ * Reverse lookup for serialized data
  *
- * @param inputs - Array of Tailwind classes
- * @param minify - Whether to minify output
- * @returns Combined CSS string
+ * @param valueId - Value ID
+ * @returns Value name or empty string if not found
  *
  * @example
  * ```ts
- * const css = compileToCssBatch(['px-4', 'bg-blue-600'], true)
+ * const blueId = registerValueName('blue-600')
+ * const value = valueIdToString(blueId)
+ * console.log(value)  // "blue-600"
  * ```
  */
-declare function compileToCssBatch(inputs: string[], minify?: boolean): string;
+declare function valueIdToString(valueId: number): string;
 /**
- * Minify CSS string
- * Removes unnecessary whitespace and formatting
- *
- * @param css - Raw CSS string
- * @returns Minified CSS (40-60% size reduction)
+ * Reverse lookup: find property by ID
+ * Alternative way to look up property names
  *
- * @example
- * ```ts
- * const css = ".px-4 { padding-left: 1rem; padding-right: 1rem; }"
- * const minified = minifyCss(css)
- * // Returns: ".px-4{padding-left:1rem;padding-right:1rem}"
- * ```
+ * @param propertyId - Property ID to look up
+ * @returns Property name
  */
-declare function minifyCss(css: string): string;
+declare function reverseLookupProperty(propertyId: number): string;
 /**
- * Compile animation from from/to states
- * Generates @keyframes and animation rule
- *
- * @param animationName - Animation name
- * @param from - From state classes (e.g., "opacity-0 scale-95")
- * @param to - To state classes (e.g., "opacity-100 scale-100")
- * @returns Compiled animation with keyframes
+ * Reverse lookup: find value by ID
+ * Alternative way to look up value names
  *
- * @example
- * ```ts
- * const anim = compileAnimation('fade-in', 'opacity-0', 'opacity-100')
- * console.log(anim.keyframes_css)  // @keyframes fade-in { ... }
- * console.log(anim.animation_rule) // animation: fade-in 300ms;
- * ```
+ * @param valueId - Value ID to look up
+ * @returns Value name
  */
-declare function compileAnimation(animationName: string, from: string, to: string): CompiledAnimation;
+declare function reverseLookupValue(valueId: number): string;
 /**
- * Compile keyframes from stop definitions
- * Creates @keyframes from percentage stops
+ * Export registry state for persistence
+ * Useful for saving/restoring registry data
  *
- * @param name - Keyframes name
- * @param stopsJson - JSON array of stops: `[{"stop":"0%","classes":"opacity-0"}...]`
- * @returns Compiled @keyframes rule
+ * @param handle - Generator handle
+ * @returns Serialized registry state
  *
  * @example
  * ```ts
- * const kf = compileKeyframes('slide-in', JSON.stringify([
- *   { stop: '0%', classes: 'translate-x-full' },
- *   { stop: '100%', classes: 'translate-x-0' }
- * ]))
+ * const exported = idRegistryExport(handle)
+ * // Save to file/database
  * ```
  */
-declare function compileKeyframes(name: string, stopsJson: string): CompiledAnimation;
+declare function idRegistryExport(handle: number): string;
 /**
- * Compile theme to CSS variables
- * Converts token map to CSS custom properties
+ * Import registry state
+ * Restore registry from saved state
  *
- * @param tokensJson - Theme tokens as JSON
- * @param themeName - Theme name ("light", "dark", etc.)
- * @param prefix - CSS variable prefix (e.g., "tw" → "--tw-color-primary")
- * @returns Compiled theme with variables CSS
+ * @param importedData - Serialized registry data
+ * @returns New handle with imported data
  *
  * @example
  * ```ts
- * const theme = compileTheme(
- *   JSON.stringify({ colors: { blue: { 600: '#2563eb' } } }),
- *   'light',
- *   'tw'
- * )
- * // Returns CSS: :root { --tw-color-blue-600: #2563eb; }
+ * const handle = idRegistryImport(savedData)
+ * // Registry restored with same IDs
  * ```
  */
-declare function compileTheme(tokensJson: string, themeName: string, prefix: string): CompiledTheme;
+declare function idRegistryImport(importedData: string): number;
+
 /**
- * Merge conflicting Tailwind classes
- * Resolves conflicts intelligently (last-one-wins by default)
- *
- * @param classString - Space-separated class string (e.g., "px-4 px-8 bg-red-500 bg-blue-600")
- * @returns Merged classes with conflicts resolved
+ * streamingNative.ts
  *
- * @example
- * ```ts
- * const merged = twMerge('px-4 px-8 bg-red-500 bg-blue-600')
- * // Returns: "px-8 bg-blue-600"
- * ```
+ * Phase 5.1: Streaming & Incremental Processing - Handle file changes efficiently
+ * Exposes 8 functions for real-time incremental compilation
  */
-declare function twMerge(classString: string): string;
 /**
- * Merge multiple class strings
- * Combines and resolves conflicts across multiple strings
- *
- * @param classStrings - Array of class strings
- * @returns Merged result
- *
- * @example
- * ```ts
- * const merged = twMergeMany([
- *   'px-4 hover:bg-blue-600',
- *   'px-8 hover:opacity-80'
- * ])
- * // Returns: "px-8 hover:bg-blue-600 hover:opacity-80"
- * ```
+ * File change notification
  */
-declare function twMergeMany(classStrings: string[]): string;
+interface FileChangeEvent {
+    file_path: string;
+    event_type: "added" | "modified" | "deleted";
+    old_content?: string;
+    new_content?: string;
+    timestamp_ms: number;
+}
 /**
- * Merge with custom separator
- * Useful for non-standard class separators
- *
- * @param classString - Classes to merge
- * @param options - Merge options (separator, debug)
- * @returns Merged classes
- *
- * @example
- * ```ts
- * const merged = twMergeWithSeparator(
- *   'px-4,px-8,bg-red-500,bg-blue-600',
- *   { separator: ',' }
+ * Processed file change result
+ */
+interface ProcessedFileChange {
+    file_path: string;
+    status: "processed" | "skipped" | "error";
+    old_classes: string[];
+    new_classes: string[];
+    added_classes: string[];
+    removed_classes: string[];
+    changed: boolean;
+    fingerprint: string;
+    error?: string;
+}
+/**
+ * Diff between two scan results
+ */
+interface FileDiff {
+    added_files: string[];
+    removed_files: string[];
+    modified_files: string[];
+    added_classes: string[];
+    removed_classes: string[];
+    total_changes: number;
+}
+/**
+ * File fingerprint for change detection
+ */
+interface FileFingerprint {
+    file_path: string;
+    content_hash: string;
+    size_bytes: number;
+    mtime_ms: number;
+    class_hash: string;
+    signature: string;
+}
+/**
+ * Incremental diff result
+ */
+interface IncrementalDiffResult {
+    is_changed: boolean;
+    changes_count: number;
+    diff: FileDiff;
+    processing_time_ms: number;
+}
+/**
+ * State injection result
+ */
+interface StateInjectionResult {
+    injected: boolean;
+    state_hash: string;
+    affected_files: number;
+    total_injected_bytes: number;
+}
+/**
+ * Stale entry pruning result
+ */
+interface PruneResult {
+    entries_before: number;
+    entries_after: number;
+    entries_removed: number;
+    freed_bytes: number;
+}
+/**
+ * Rebuilt workspace result
+ */
+interface RebuildWorkspaceResult {
+    total_files_scanned: number;
+    total_classes_found: number;
+    unique_classes: number;
+    build_time_ms: number;
+    files_with_changes: number;
+}
+/**
+ * Process a single file change event
+ * Called when a file is added, modified, or deleted
+ *
+ * @param fileChangeJson - JSON string describing the file change
+ * @returns Processing result with class changes
+ *
+ * @example
+ * ```ts
+ * const change = processFileChange(JSON.stringify({
+ *   file_path: 'src/Button.tsx',
+ *   event_type: 'modified',
+ *   new_content: 'export const Button = ...',
+ *   timestamp_ms: Date.now()
+ * }))
+ *
+ * console.log('Added classes:', change.added_classes)
+ * console.log('Removed classes:', change.removed_classes)
+ * ```
+ */
+declare function processFileChange(fileChangeJson: string): ProcessedFileChange;
+/**
+ * Compute incremental diff between old and new scan results
+ * Efficient way to identify only what changed
+ *
+ * @param oldScanJson - JSON string of previous scan result
+ * @param newScanJson - JSON string of new scan result
+ * @returns Diff showing what changed
+ *
+ * @example
+ * ```ts
+ * const oldResult = scanWorkspace('./src')
+ * // ... files changed ...
+ * const newResult = scanWorkspace('./src')
+ *
+ * const diff = computeIncrementalDiff(
+ *   JSON.stringify(oldResult),
+ *   JSON.stringify(newResult)
  * )
+ *
+ * if (diff.is_changed) {
+ *   console.log(`${diff.changes_count} files changed`)
+ *   console.log('Added:', diff.diff.added_classes)
+ *   console.log('Removed:', diff.diff.removed_classes)
+ * }
  * ```
  */
-declare function twMergeWithSeparator(classString: string, options: TwMergeOptions): string;
+declare function computeIncrementalDiff(oldScanJson: string, newScanJson: string): IncrementalDiffResult;
 /**
- * Merge many with custom separator
- * Batch merge with custom separator
+ * Create a fingerprint of a file for change detection
+ * Use fingerprints to quickly check if file needs reprocessing
  *
- * @param classStrings - Array of class strings
- * @param options - Merge options
- * @returns Merged result
+ * @param filePath - Path to file
+ * @param fileContent - File content
+ * @returns File fingerprint
+ *
+ * @example
+ * ```ts
+ * const fingerprint = createFingerprint('src/Button.tsx', fileContent)
+ * // Store fingerprint, check later if content changed
+ * const newFingerprint = createFingerprint('src/Button.tsx', newContent)
+ * if (fingerprint.signature !== newFingerprint.signature) {
+ *   // Content changed, needs reprocessing
+ * }
+ * ```
  */
-declare function twMergeManyWithSeparator(classStrings: string[], options: TwMergeOptions): string;
+declare function createFingerprint(filePath: string, fileContent: string): FileFingerprint;
 /**
- * Raw merge from class lists
- * Direct merge without preprocessing
+ * Inject state hash into compiled CSS
+ * Marks CSS with version/state hash for cache busting
+ *
+ * @param css - Raw CSS string
+ * @param stateHash - State hash to inject
+ * @returns Modified CSS with injected state
+ *
+ * @example
+ * ```ts
+ * const css = compileCssNative2(['px-4', 'bg-blue-600'])
+ * const withState = injectStateHash(css, 'v5-hash-123')
+ * // CSS now includes version marker for cache control
+ * ```
+ */
+declare function injectStateHash(css: string, stateHash: string): StateInjectionResult;
+/**
+ * Prune stale entries from cache
+ * Removes old/unused cache entries to free memory
+ *
+ * @param maxAgeSeconds - Remove entries older than this many seconds
+ * @param maxEntries - Keep only this many most-recent entries
+ * @returns Result of pruning operation
+ *
+ * @example
+ * ```ts
+ * // Remove cache entries older than 1 hour, keep max 10000 entries
+ * const result = pruneStaleCacheEntries(3600, 10000)
+ * console.log(`Freed ${result.freed_bytes / 1024}KB`)
+ * ```
+ */
+declare function pruneStaleCacheEntries(maxAgeSeconds: number, maxEntries: number): PruneResult;
+/**
+ * Rebuild workspace result from scratch
+ * Useful after major configuration changes
+ *
+ * @param rootDir - Root directory to scan
+ * @param extensions - File extensions to scan (e.g., [".tsx", ".ts"])
+ * @returns Rebuilt workspace result
+ *
+ * @example
+ * ```ts
+ * const result = rebuildWorkspaceResult('./src', ['.tsx', '.ts'])
+ * console.log(`Found ${result.unique_classes} unique classes`)
+ * console.log(`${result.files_with_changes} files had changes`)
+ * ```
+ */
+declare function rebuildWorkspaceResult(rootDir: string, extensions?: string[]): RebuildWorkspaceResult;
+/**
+ * Scan a single file with incremental state
+ * Returns only new/changed classes since last scan
+ *
+ * @param filePath - Path to file
+ * @param fileContent - File content
+ * @returns Updated classes and change status
+ *
+ * @example
+ * ```ts
+ * // On file change, get only what changed
+ * const file = scanFileNative('src/Button.tsx', newContent)
+ * if (file.changed) {
+ *   console.log('Added:', file.added_classes)
+ *   console.log('Removed:', file.removed_classes)
+ * }
+ * ```
+ */
+declare function scanFileNative(filePath: string, fileContent: string): {
+    file: string;
+    classes: string[];
+    added_classes: string[];
+    removed_classes: string[];
+    changed: boolean;
+};
+/**
+ * Scan multiple files in batch with incremental state
+ * Efficient batch processing of file changes
+ *
+ * @param filesJson - JSON array of {file, content} objects
+ * @returns Results for each file
+ *
+ * @example
+ * ```ts
+ * const files = [
+ *   { file: 'src/Button.tsx', content: newButtonContent },
+ *   { file: 'src/Card.tsx', content: newCardContent }
+ * ]
+ * const results = scanFilesBatchNative(JSON.stringify(files))
+ * ```
+ */
+declare function scanFilesBatchNative(filesJson: string): Array<{
+    file: string;
+    classes: string[];
+    changed: boolean;
+}>;
+
+interface CssPipelineResult {
+    css: string;
+    classes: string[];
+    sizeBytes: number;
+    optimized: boolean;
+}
+declare function runCssPipeline(classes: string[], cssEntryContent?: string, root?: string, minify?: boolean): Promise<CssPipelineResult>;
+
+/**
+ * Parser Sub-entry Point
+ *
+ * Exports class parsing and extraction functionality.
+ * - Tailwind class parsing
+ * - Class extraction from source
+ * - Class normalization and deduplication
+ * - Component analysis
+ */
+declare const parseClasses: (raw: string) => Array<{
+    raw: string;
+    type: string;
+}>;
+declare const extractAllClasses: (source: string) => string[];
+declare const extractClassesFromSource: (source: string) => string;
+declare const astExtractClasses: (source: string, _filename: string) => string[];
+declare const normalizeClasses: (raw: string) => string;
+declare const mergeClassesStatic: (classes: string) => string;
+declare const normalizeAndDedupClasses: (raw: string) => {
+    normalized: string;
+    duplicatesRemoved: number;
+    uniqueCount: number;
+};
+declare const extractComponentUsage: (source: string) => Array<{
+    component: string;
+    propsJson: string;
+}>;
+declare const batchExtractClasses: (filePaths: string[]) => {
+    file: string;
+    classes: string[];
+    contentHash: string;
+    ok: boolean;
+    error?: string;
+}[];
+declare const checkAgainstSafelist: (classes: string[], safelist: string[]) => {
+    matched: string[];
+    unmatched: string[];
+    safelistSize: number;
+};
+declare const diffClassLists: (previous: string[], current: string[]) => {
+    added: string[];
+    removed: string[];
+    unchanged: string[];
+    hasChanges: boolean;
+};
+
+/**
+ * Detect dead CSS selectors in generated CSS.
+ */
+declare function detectDeadCode(scanResultJson: string, css: string): DeadCodeResult;
+/**
+ * Analyze class usage across scanned files.
+ */
+declare function analyzeClassUsageNative(classes: string[], scanResultJson: string, css: string): ClassUsageItem[];
+/**
+ * Analyze entire class list and generate CSS.
+ */
+declare function analyzeClassesNative(filesJson: string, cwd: string, flags?: number): {
+    css?: string;
+    code: string;
+    classes: string[];
+    changed: boolean;
+    rscJson?: string;
+    metadataJson?: string;
+    safelist?: string[];
+} | null;
+/**
+ * Analyze React Server Component requirements.
+ */
+declare function analyzeRscNative(source: string, filename: string): {
+    isServer: boolean;
+    needsClientDirective: boolean;
+    clientReasons: string[];
+};
+/**
+ * Optimize CSS by removing dead code and minifying.
+ */
+declare function optimizeCssNative(css: string): {
+    css: string;
+    originalSize: number;
+    optimizedSize: number;
+    reductionPercentage: number;
+};
+/**
+ * Process Tailwind CSS with Lightning CSS post-processing.
+ */
+declare function processTailwindCssLightning(css: string): ProcessedCssResult;
+/**
+ * Eliminate dead CSS selectors.
+ */
+declare function eliminateDeadCssNative(css: string, deadClasses: string[]): string;
+/**
+ * Hoist components from source code.
+ */
+declare function hoistComponentsNative(source: string): HoistResult;
+/**
+ * Compile variant configuration table.
+ */
+declare function compileVariantTableNative(configJson: string): VariantTableResult;
+/**
+ * Classify and sort classes by bucket.
+ */
+declare function classifyAndSortClassesNative(classes: string[]): ClassifyResult[];
+/**
+ * Merge CSS declarations from multiple chunks.
+ */
+declare function mergeCssDeclarationsNative(cssChunks: string[]): MergeResult;
+
+/**
+ * themeResolutionNative.ts
+ *
+ * Phase 5.1: Theme Resolution Extended - Advanced theme configuration handling
+ * Exposes 7 theme resolution functions for complex Tailwind configurations
+ */
+/**
+ * Validation result for theme config
+ */
+interface ThemeValidationResult {
+    is_valid: boolean;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+}
+/**
+ * Resolved variant configuration
+ */
+interface ResolvedVariantConfig {
+    variants: string[];
+    supported: string[];
+    deprecated: string[];
+    conflicting: string[];
+}
+/**
+ * Theme cascade resolution result
+ */
+interface ThemeCascadeResult {
+    base_theme: Record<string, unknown>;
+    user_overrides: Record<string, unknown>;
+    merged_theme: Record<string, unknown>;
+    conflict_resolutions: Array<{
+        key: string;
+        base_value: unknown;
+        override_value: unknown;
+        resolution: "override" | "merge" | "error";
+    }>;
+}
+/**
+ * Class name resolution from theme
+ */
+interface ResolvedClassName {
+    class_name: string;
+    property: string;
+    value: string;
+    from_theme_path: string;
+    is_responsive: boolean;
+    variants: string[];
+}
+/**
+ * Conflict group information
+ */
+interface ConflictGroupInfo {
+    group_name: string;
+    conflicting_classes: string[];
+    description: string;
+    resolution_strategy: string;
+}
+/**
+ * Get all resolved variants from theme configuration
+ * Parses theme config and returns all variant prefixes
  *
- * @param classLists - Array of class lists
- * @returns Merged classes
+ * @param configJson - JSON string of theme configuration
+ * @returns Resolved variants with metadata
  *
  * @example
  * ```ts
- * const merged = twMergeRaw(['px-4 px-8', 'bg-red bg-blue'])
+ * const config = {
+ *   screens: { md: '768px', lg: '1024px' },
+ *   state: { hover: '&:hover', focus: '&:focus' }
+ * }
+ * const variants = resolveVariants(JSON.stringify(config))
+ * console.log(variants.variants)  // ['md', 'lg', 'hover', 'focus', ...]
  * ```
  */
-declare function twMergeRaw(classLists: string[]): string;
-
-/**
- * idRegistryNative.ts
- *
- * Phase 5.2: ID Registry Management - Efficient ID generation and lookup
- * Exposes 16 ID registry functions for deterministic class/component identification
- */
-/**
- * Registry snapshot data
- */
-interface RegistrySnapshot {
-    handle: number;
-    next_id: number;
-    entries: Array<{
-        name: string;
-        id: number;
-    }>;
-    total_entries: number;
-}
+declare function resolveVariants(configJson: string): ResolvedVariantConfig;
 /**
- * Create a new ID generator
- * Returns a handle to be used in subsequent operations
+ * Validate theme configuration for correctness
+ * Checks for common issues and provides warnings
  *
- * @returns Generator handle (u32)
+ * @param configJson - JSON string of theme configuration
+ * @returns Validation result with errors and suggestions
  *
  * @example
  * ```ts
- * const handle = idRegistryCreate()
- * // Use handle for all subsequent operations
- * try {
- *   const id = idRegistryGenerate(handle, 'MyComponent')
- *   // ... use id ...
- * } finally {
- *   idRegistryDestroy(handle)  // Clean up
+ * const result = validateThemeConfig(JSON.stringify(myTheme))
+ * if (!result.is_valid) {
+ *   console.error('Errors:', result.errors)
+ *   console.warn('Warnings:', result.warnings)
  * }
  * ```
  */
-declare function idRegistryCreate(): number;
+declare function validateThemeConfig(configJson: string): ThemeValidationResult;
 /**
- * Generate a new ID for a name
- * Same name always returns same ID (deterministic)
+ * Resolve theme cascade (base + overrides)
+ * Merges base theme with user overrides intelligently
  *
- * @param handle - Generator handle from idRegistryCreate()
- * @param name - Identifier name (e.g., component name, class name)
- * @returns Generated ID
+ * @param baseThemeJson - Base theme configuration
+ * @param overridesJson - User overrides configuration
+ * @returns Merged theme with conflict information
  *
  * @example
  * ```ts
- * const handle = idRegistryCreate()
- * const id1 = idRegistryGenerate(handle, 'Button')  // Returns 1
- * const id2 = idRegistryGenerate(handle, 'Button')  // Returns 1 (same)
- * const id3 = idRegistryGenerate(handle, 'Card')    // Returns 2 (different)
+ * const cascade = resolveCascade(
+ *   JSON.stringify(baseTheme),
+ *   JSON.stringify(userOverrides)
+ * )
+ * console.log(cascade.merged_theme)
+ * console.log('Conflicts resolved:', cascade.conflict_resolutions.length)
  * ```
  */
-declare function idRegistryGenerate(handle: number, name: string): number;
+declare function resolveCascade(baseThemeJson: string, overridesJson: string): ThemeCascadeResult;
 /**
- * Lookup existing ID for a name
- * Returns -1 if not found
+ * Resolve class names from theme
+ * Maps Tailwind class names to theme values
  *
- * @param handle - Generator handle
- * @param name - Name to look up
- * @returns ID if found, -1 if not found
+ * @param classNames - Array of Tailwind class names (e.g., ["text-lg", "bg-blue-600"])
+ * @param themeJson - Theme configuration
+ * @returns Resolved class name information
  *
  * @example
  * ```ts
- * const id = idRegistryLookup(handle, 'Button')
- * if (id !== -1) {
- *   console.log(`Button has ID: ${id}`)
- * } else {
- *   console.log('Button not in registry yet')
- * }
+ * const resolved = resolveClassNames(
+ *   ['text-lg', 'bg-blue-600', 'md:p-4'],
+ *   JSON.stringify(theme)
+ * )
+ * resolved.forEach(item => {
+ *   console.log(`${item.class_name} -> ${item.property}: ${item.value}`)
+ * })
  * ```
  */
-declare function idRegistryLookup(handle: number, name: string): number;
+declare function resolveClassNames(classNames: string[], themeJson: string): ResolvedClassName[];
 /**
- * Get the next ID that would be assigned
- * Useful for knowing how many unique IDs exist
+ * Get conflict group information
+ * Identifies classes that conflict with each other
  *
- * @param handle - Generator handle
- * @returns Next available ID
+ * @param groupName - Conflict group name (e.g., "display", "position", "flex-direction")
+ * @param themeJson - Theme configuration
+ * @returns Information about the conflict group
  *
  * @example
  * ```ts
- * const handle = idRegistryCreate()
- * idRegistryGenerate(handle, 'Button')
- * idRegistryGenerate(handle, 'Card')
- * const nextId = idRegistryNext(handle)  // Returns 2 (next available)
+ * const info = resolveConflictGroup('display', JSON.stringify(theme))
+ * console.log('Conflicting classes:', info.conflicting_classes)
+ * console.log('Strategy:', info.resolution_strategy)
  * ```
  */
-declare function idRegistryNext(handle: number): number;
+declare function resolveConflictGroup(groupName: string, themeJson: string): ConflictGroupInfo;
 /**
- * Destroy a registry (clean up resources)
- * Must be called when done with registry
+ * Resolve theme value from key path
+ * Navigates nested theme config to find values
  *
- * @param handle - Generator handle
+ * @param keyPath - Dot-separated path (e.g., "colors.blue.600")
+ * @param themeJson - Theme configuration
+ * @returns Resolved value or null if not found
  *
  * @example
  * ```ts
- * const handle = idRegistryCreate()
- * try {
- *   // Use registry
- * } finally {
- *   idRegistryDestroy(handle)
- * }
+ * const color = resolveThemeValue('colors.blue.600', JSON.stringify(theme))
+ * console.log(color)  // "#2563eb" or similar
  * ```
  */
-declare function idRegistryDestroy(handle: number): void;
+declare function resolveThemeValue(keyPath: string, themeJson: string): string | null;
 /**
- * Reset registry to initial state
- * Clears all entries but reuses handle
+ * Get all simple variants from configuration
+ * Returns variants that don't require complex selector nesting
  *
- * @param handle - Generator handle
+ * @param configJson - Theme/variant configuration
+ * @returns Array of simple variant names
  *
  * @example
  * ```ts
- * const handle = idRegistryCreate()
- * idRegistryGenerate(handle, 'Component1')
- * idRegistryGenerate(handle, 'Component2')
- * idRegistryReset(handle)  // Clear all
- * const id = idRegistryNext(handle)  // Back to 0
+ * const simpleVariants = resolveSimpleVariants(JSON.stringify(config))
+ * console.log(simpleVariants)
+ * // ["hover", "focus", "active", "group-hover", ...]
  * ```
  */
-declare function idRegistryReset(handle: number): void;
+declare function resolveSimpleVariants(configJson: string): string[];
+
+declare function scanWorkspace(root: string, extensions?: string[]): ScanWorkspaceResult;
+declare function extractClassesFromSourceNative(source: string): string[];
+declare function batchExtractClassesNative(filePaths: string[]): BatchExtractResult[];
+declare function checkAgainstSafelistNative(classes: string[], safelist: string[]): SafelistCheckResult;
+declare function scanFile(filePath: string): ScanFileResult;
+declare function collectFiles(root: string, extensions?: string[]): string[];
+declare function walkAndPrefilterSourceFiles(root: string, extensions?: string[], _parallel?: boolean): PrefilterFileResult[];
+declare function generateSubComponentTypes(root: string, outputPath?: string): string;
+
 /**
- * Get snapshot of current registry state
- * Useful for serialization/debugging
+ * cacheNative.ts
  *
- * @param handle - Generator handle
- * @returns Snapshot with all entries
+ * Phase 5.1: Cache Management - Advanced caching strategies and optimization
+ * Exposes 9 cache-related Rust functions for improved performance tuning
+ */
+/**
+ * Cache optimization hints and recommendations
+ */
+interface CacheOptimizationHints {
+    current_strategy: string;
+    recommended_strategy: string;
+    estimated_improvement_percent: number;
+    suggested_memory_mb: number;
+    notes: string[];
+}
+/**
+ * Optimal cache configuration recommendations
+ */
+interface OptimalCacheConfig {
+    parse_cache_size: number;
+    resolve_cache_size: number;
+    compile_cache_size: number;
+    css_gen_cache_size: number;
+    recommended_eviction_policy: string;
+    ttl_seconds: number;
+    expected_hit_rate_percent: number;
+}
+/**
+ * Cache statistics from all layers
+ */
+interface CacheStatistics {
+    parse_cache: {
+        hits: number;
+        misses: number;
+        size: number;
+    };
+    resolve_cache: {
+        hits: number;
+        misses: number;
+        size: number;
+    };
+    compile_cache: {
+        hits: number;
+        misses: number;
+        size: number;
+    };
+    css_gen_cache: {
+        hits: number;
+        misses: number;
+        size: number;
+    };
+    overall_hit_rate: number;
+    total_memory_bytes: number;
+}
+/**
+ * Get comprehensive cache statistics across all layers
+ * Useful for monitoring and optimization
  *
+ * @returns Cache stats including hit rates, sizes, and recommendations
  * @example
  * ```ts
- * const handle = idRegistryCreate()
- * idRegistryGenerate(handle, 'Button')
- * idRegistryGenerate(handle, 'Card')
- * const snapshot = idRegistrySnapshot(handle)
- * console.log(JSON.stringify(snapshot, null, 2))
+ * const stats = getCacheStatistics()
+ * console.log(`Overall hit rate: ${stats.overall_hit_rate}%`)
+ * console.log(`Total memory used: ${stats.total_memory_bytes / 1024}KB`)
  * ```
  */
-declare function idRegistrySnapshot(handle: number): RegistrySnapshot;
+declare function getCacheStatistics(): CacheStatistics;
 /**
- * Get count of active registries
- * Useful for monitoring resource usage
- *
- * @returns Number of active generator handles
+ * Clear all caches (parse, resolve, compile, CSS generation)
+ * Use when switching themes or major configuration changes
  *
  * @example
  * ```ts
- * console.log(`Active registries: ${idRegistryActiveCount()}`)
+ * // Clear before switching themes
+ * clearAllCaches()
+ * const css = await generateCssNative(classes, { theme: newTheme })
  * ```
  */
-declare function idRegistryActiveCount(): number;
+declare function clearAllCaches(): void;
+/**
+ * Clear only the parse cache
+ * Useful when parser behavior changes or cache gets stale
+ */
+declare function clearParseCache(): void;
+/**
+ * Clear only the resolve cache
+ * Use when theme configuration changes
+ */
+declare function clearResolveCache(): void;
+/**
+ * Clear only the compile cache
+ * Use when Tailwind configuration changes
+ */
+declare function clearCompileCache(): void;
 /**
- * Register a property name with global registry
- * Maps property names to consistent IDs
- *
- * @param propertyName - Property name (e.g., "background-color")
- * @returns Assigned property ID
- *
- * @example
- * ```ts
- * const bgColorId = registerPropertyName('background-color')
- * const paddingId = registerPropertyName('padding')
- * ```
+ * Clear only the CSS generation cache
+ * Use when theme or layout changes
  */
-declare function registerPropertyName(propertyName: string): number;
+declare function clearCssGenCache(): void;
 /**
- * Register a value name with global registry
- * Maps values to consistent IDs
+ * Get optimization hints based on current cache performance
+ * Analyzes hit rates and suggests improvements
  *
- * @param valueName - Value name (e.g., "blue-600")
- * @returns Assigned value ID
+ * @param hitRatePercent - Current hit rate (0-100)
+ * @param memoryUsedMb - Memory currently used in MB
+ * @returns Optimization recommendations
  *
  * @example
  * ```ts
- * const blueId = registerValueName('blue-600')
- * const redId = registerValueName('red-500')
+ * const stats = getCacheStatistics()
+ * const hints = getCacheOptimizationHints(
+ *   stats.overall_hit_rate,
+ *   stats.total_memory_bytes / (1024 * 1024)
+ * )
+ * console.log(`Recommendation: ${hints.recommended_strategy}`)
+ * console.log(`Potential improvement: ${hints.estimated_improvement_percent}%`)
  * ```
  */
-declare function registerValueName(valueName: string): number;
+declare function getCacheOptimizationHints(hitRatePercent: number, memoryUsedMb: number): CacheOptimizationHints;
 /**
- * Convert property ID back to name
- * Reverse lookup for serialized data
+ * Estimate optimal cache configuration for your workload
+ * Analyzes typical patterns and recommends sizes
  *
- * @param propertyId - Property ID
- * @returns Property name or empty string if not found
+ * @param totalBudgetMb - Maximum memory budget in MB
+ * @param workloadType - "small" (< 100 files), "medium" (100-1000), "large" (1000+)
+ * @returns Recommended cache configuration
  *
  * @example
  * ```ts
- * const bgColorId = registerPropertyName('background-color')
- * const name = propertyIdToString(bgColorId)
- * console.log(name)  // "background-color"
+ * const config = estimateOptimalCacheConfig(512, 'large')
+ * console.log(`Parse cache: ${config.parse_cache_size}MB`)
+ * console.log(`Expected hit rate: ${config.expected_hit_rate_percent}%`)
  * ```
  */
-declare function propertyIdToString(propertyId: number): string;
+declare function estimateOptimalCacheConfig(totalBudgetMb: number, workloadType: "small" | "medium" | "large"): OptimalCacheConfig;
 /**
- * Convert value ID back to name
- * Reverse lookup for serialized data
+ * Read cache from disk (persistence)
+ * Restores cached data from previous sessions
  *
- * @param valueId - Value ID
- * @returns Value name or empty string if not found
+ * @param cachePath - Path to cache file
+ * @returns Entries loaded from disk
  *
  * @example
  * ```ts
- * const blueId = registerValueName('blue-600')
- * const value = valueIdToString(blueId)
- * console.log(value)  // "blue-600"
+ * const entries = cacheRead('./.tw-cache/scan.json')
+ * // Warm up cache with persisted data
  * ```
  */
-declare function valueIdToString(valueId: number): string;
-/**
- * Reverse lookup: find property by ID
- * Alternative way to look up property names
- *
- * @param propertyId - Property ID to look up
- * @returns Property name
- */
-declare function reverseLookupProperty(propertyId: number): string;
-/**
- * Reverse lookup: find value by ID
- * Alternative way to look up value names
- *
- * @param valueId - Value ID to look up
- * @returns Value name
- */
-declare function reverseLookupValue(valueId: number): string;
+declare function cacheRead(cachePath: string): Array<{
+    file: string;
+    contentHash: string;
+    classes: string[];
+    mtimeMs: number;
+    sizeBytes: number;
+}>;
 /**
- * Export registry state for persistence
- * Useful for saving/restoring registry data
+ * Write cache to disk (persistence)
+ * Saves cached data for next session
  *
- * @param handle - Generator handle
- * @returns Serialized registry state
+ * @param cachePath - Path where cache should be written
+ * @param entries - Cache entries to persist
+ * @returns Success status
  *
  * @example
  * ```ts
- * const exported = idRegistryExport(handle)
- * // Save to file/database
+ * const stats = getCacheStatistics()
+ * const success = cacheWrite(
+ *   './.tw-cache/scan.json',
+ *   // entries array from previous scan
+ * )
  * ```
  */
-declare function idRegistryExport(handle: number): string;
+declare function cacheWrite(cachePath: string, entries: Array<{
+    file: string;
+    contentHash: string;
+    classes: string[];
+    mtimeMs: number;
+    sizeBytes: number;
+}>): boolean;
 /**
- * Import registry state
- * Restore registry from saved state
+ * Calculate cache priority score for file ordering
+ * Useful for prioritizing which files to scan first
  *
- * @param importedData - Serialized registry data
- * @returns New handle with imported data
+ * @param mtimeMs - File modification time in milliseconds
+ * @param sizeBytes - File size in bytes
+ * @param hitCount - Number of times this file was accessed from cache
+ * @returns Priority score (higher = process first)
  *
  * @example
  * ```ts
- * const handle = idRegistryImport(savedData)
- * // Registry restored with same IDs
+ * const priority = cachePriority(Date.now(), 2048, 5)
+ * // Use priority to sort files for scanning
  * ```
  */
-declare function idRegistryImport(importedData: string): number;
+declare function cachePriority(mtimeMs: number, sizeBytes: number, hitCount: number): number;
 
 /**
  * redisNative.ts
@@ -2598,40 +2698,26 @@ declare function validateCssOutput(css: string): string;
  */
 declare function getCompilerDiagnostics(): string;
 
-type LoaderOutput = {
-    code: string;
-    changed: boolean;
-    classes: string[];
-    staticCss?: string;
-    rsc?: {
-        isServer?: boolean;
-        needsClientDirective?: boolean;
-        clientReasons?: string[];
-    };
-    engine?: string;
-};
+/**
+ * tailwind-styled-v5 — Compiler Main Entry Point
+ *
+ * Re-exports all sub-entry points for backward compatibility.
+ * For better tree-shaking, import from specific sub-entries:
+ * - '@tailwind-styled/compiler/compiler' - CSS generation and compilation
+ * - '@tailwind-styled/compiler/parser' - Class parsing and extraction
+ * - '@tailwind-styled/compiler/analyzer' - Analysis and optimization
+ * - '@tailwind-styled/compiler/cache' - Cache management
+ * - '@tailwind-styled/compiler/redis' - Redis and distributed cache
+ * - '@tailwind-styled/compiler/watch' - File watching and monitoring
+ */
+
 declare const transformSource: (source: string, opts?: Record<string, unknown>) => NativeTransformResult;
 declare const hasTwUsage: (source: string) => boolean;
 declare const isAlreadyTransformed: (source: string) => boolean;
 declare const shouldProcess: (source: string) => boolean;
 declare const compileCssFromClasses: (classes: string[], prefix?: string | null) => NativeTransformResult;
 declare const buildStyleTag: (classes: string[]) => string;
-declare const compileCssNative: (classes: string[], prefix?: string | null) => NativeTransformResult;
 declare const generateCssForClasses: (classes: string[], _tailwindConfig?: Record<string, unknown>, root?: string, cssEntryContent?: string, minify?: boolean) => Promise<string>;
-declare const extractAllClasses: (source: string) => string[];
-declare const extractClassesFromSource: (source: string) => string;
-declare const astExtractClasses: (source: string, _filename: string) => string[];
-declare const parseClasses: (raw: string) => Array<{
-    raw: string;
-    type: string;
-}>;
-declare const normalizeClasses: (raw: string) => string;
-declare const mergeClassesStatic: (classes: string) => string;
-declare const normalizeAndDedupClasses: (raw: string) => {
-    normalized: string;
-    duplicatesRemoved: number;
-    uniqueCount: number;
-};
 declare const eliminateDeadCss: (css: string, deadClasses: Set<string>) => string;
 declare const findDeadVariants: (variantConfig: Record<string, unknown> | Array<{
     name: string;
@@ -2642,74 +2728,26 @@ declare const findDeadVariants: (variantConfig: Record<string, unknown> | Array<
     unused: string[];
 };
 declare const runElimination: (css: string, scanResult: unknown) => string;
-declare const optimizeCss: (css: string) => string;
 declare const scanProjectUsage: (dirs: string[], cwd: string) => Record<string, Record<string, Set<string>>>;
-declare const extractComponentUsage: (source: string) => Array<{
-    component: string;
-    propsJson: string;
-}>;
-declare const diffClassLists: (previous: string[], current: string[]) => {
-    added: string[];
-    removed: string[];
-    unchanged: string[];
-    hasChanges: boolean;
-};
-declare const batchExtractClasses: (filePaths: string[]) => {
-    file: string;
-    classes: string[];
-    contentHash: string;
-    ok: boolean;
-    error?: string;
-}[];
-declare const checkAgainstSafelist: (classes: string[], safelist: string[]) => {
-    matched: string[];
-    unmatched: string[];
-    safelistSize: number;
-};
-declare const hoistComponents: (source: string) => HoistResult;
-declare const compileVariantTable: (configJson: string) => VariantTableResult;
-declare const compileVariants: (componentId: string, config: Record<string, unknown>) => VariantTableResult;
-declare const classifyAndSortClasses: (classes: string[]) => ClassifyResult[];
-declare const mergeCssDeclarations: (cssChunks: string[]) => MergeResult;
-declare const analyzeClassUsage: (classes: string[], scanResultJson: string, css: string) => ClassUsageItem[];
-declare const analyzeRsc: (source: string, filename: string) => {
-    isServer: boolean;
-    needsClientDirective: boolean;
-    clientReasons: string[];
-};
-declare const analyzeFile: (source: string, filename: string) => {
-    isServer: boolean;
-    needsClientDirective: boolean;
-    clientReasons: string[];
-    interactiveClasses: never[];
-    canStaticResolveVariants: boolean;
-};
-declare const analyzeVariantUsage: (_source: string, _componentName: string, _variantKeys: string[]) => {
-    resolved: Record<string, string>;
-    dynamic: string[];
-};
-declare const injectClientDirective: (source: string) => string;
-declare const injectServerOnlyComment: (source: string) => string;
-declare const analyzeClasses: (filesJson: string, cwd: string, flags: number) => {
-    css?: string;
-    code: string;
-    classes: string[];
-    changed: boolean;
-    rscJson?: string;
-    metadataJson?: string;
-    safelist?: string[];
-} | null;
 declare const generateSafelist: (scanDirs: string[], outputPath?: string, cwd?: string) => string[];
 declare const loadSafelist: (safelistPath: string) => string[];
 declare const loadTailwindConfig: (cwd?: string) => {};
 declare const getContentPaths: (cwd?: string) => {
     content: string[];
 };
-/**
- * Extract container configs dari source dan generate static `@container` CSS.
- * Native-only: delegates ke Rust extractTwContainerConfigs.
- */
 declare function extractContainerCssFromSource(source: string): string;
+type LoaderOutput = {
+    code: string;
+    changed: boolean;
+    classes: string[];
+    staticCss?: string;
+    rsc?: {
+        isServer?: boolean;
+        needsClientDirective?: boolean;
+        clientReasons?: string[];
+    };
+    engine?: string;
+};
 declare const runLoaderTransform: (ctx: {
     filepath: string;
     source: string;
@@ -2721,28 +2759,44 @@ declare const getAllRoutes: () => string[];
 declare const getRouteClasses: (_route: string) => Set<string>;
 declare const registerFileClasses: (_filepath: string, _classes: string[]) => void;
 declare const registerGlobalClasses: (_classes: string[]) => void;
-declare const getIncrementalEngine: () => {
-    compile(source: string): NativeTransformResult;
-};
+declare const getIncrementalEngine: () => IncrementalEngine;
 declare const resetIncrementalEngine: () => void;
-declare const IncrementalEngine: {
-    new (): {
-        compile(source: string): NativeTransformResult;
-    };
-};
+declare class IncrementalEngine {
+    compile(source: string): NativeTransformResult;
+}
 declare const getBucketEngine: () => {
     add: (className: string) => string;
     get: (_bucket: string) => string[];
 };
 declare const resetBucketEngine: () => void;
-declare const BucketEngine: {
-    new (): {
-        add(className: string): string;
-    };
-};
+declare class BucketEngine {
+    add(className: string): string;
+}
 declare const classifyNode: (_node: unknown) => string;
 declare const detectConflicts: (_classes: string[]) => string[];
 declare const bucketSort: (classes: string[]) => string[];
+declare const analyzeFile: (source: string, filename: string) => {
+    isServer: boolean;
+    needsClientDirective: boolean;
+    clientReasons: string[];
+    interactiveClasses: never[];
+    canStaticResolveVariants: boolean;
+};
+declare const analyzeVariantUsage: (_source: string, _componentName: string, _variantKeys: string[]) => {
+    resolved: Record<string, string>;
+    dynamic: string[];
+};
+declare const injectClientDirective: (source: string) => string;
+declare const injectServerOnlyComment: (source: string) => string;
+declare const analyzeClasses: (filesJson: string, cwd: string, flags: number) => {
+    css?: string;
+    code: string;
+    classes: string[];
+    changed: boolean;
+    rscJson?: string;
+    metadataJson?: string;
+    safelist?: string[];
+} | null;
 interface TwStateConfigEntry {
     tag: string;
     componentName: string;
@@ -2762,7 +2816,7 @@ interface GeneratedStateRule {
     stateName: string;
 }
 declare const extractTwStateConfigs: (source: string, filename: string) => TwStateConfigEntry[];
-declare const generateStaticStateCss: (inputs: StaticStateCssInput[], resolvedCss?: string | null) => GeneratedStateRule[];
+declare const generateStaticStateCss: (entries: TwStateConfigEntry[], _themeConfig?: Record<string, unknown>) => GeneratedStateRule[];
 declare const extractAndGenerateStateCss: (source: string, filename: string) => GeneratedStateRule[];
 
-export { type BatchExtractResult, BucketEngine, type CacheOptimizationHints, type CacheStatistics, type ClassExtractResult, type ClassUsageItem, type ClassifyResult, type CompiledAnimation, type CompiledCssRule, type CompiledTheme, type ComponentMetadata, type ConflictGroupInfo, type ContainerConfig, type CssCompileResult, type DeadCodeResult, type FileChangeEvent, type FileDiff, type FileFingerprint, type GeneratedStateCss, type GeneratedStateRule, type HoistResult, type IncrementalDiffResult, IncrementalEngine, type KeyExpiration, type LoaderOutput, type MergeResult, type NativeBridge, type NativeRscResult, type NativeTransformResult, type OptimalCacheConfig, type PoolInfo, type PrefilterFileResult, type ProcessedCssResult, type ProcessedFileChange, type PruneResult, type PubSubMessage, type RebuildWorkspaceResult, type RedisCacheConfig, type RedisClusterNode, type RedisClusterStatus, type RedisPoolStats, type RegistrySnapshot, type ResolvedClassName, type ResolvedVariantConfig, type SafelistCheckResult, type ScanFileResult, type ScanWorkspaceResult, type StateCssConfig, type StateInjectionResult, type StaticStateCssInput, type ThemeCascadeResult, type ThemeValidationResult, type TwMergeOptions, type TwStateConfigEntry, type VariantTableResult, type WatchEvent, type WatchHandle, type WatchStats, adaptNativeResult, analyzeClassUsage, analyzeClassUsageNative, analyzeClasses, analyzeClassesNative, analyzeFile, analyzeRsc, analyzeRscNative, analyzeVariantUsage, astExtractClasses, atomicRegistrySize, batchExtractClasses, batchExtractClassesNative, bucketSort, buildStyleTag, cachePriority, cacheRead, cacheWrite, checkAgainstSafelist, checkAgainstSafelistNative, classifyAndSortClasses, classifyAndSortClassesNative, classifyNode, clearAllCaches, clearAtomicRegistry, clearCompileCache, clearCssGenCache, clearParseCache, clearResolveCache, clearThemeCache, collectFiles, compileAnimation, compileClass, compileClasses, compileCssFromClasses, compileCssLightning, compileCssNative, compileCssNative2, compileKeyframes, compileTheme, compileToCss, compileToCssBatch, compileVariantTable, compileVariantTableNative, compileVariants, computeIncrementalDiff, createFingerprint, detectConflicts, detectDeadCode, diffClassLists, eliminateDeadCss, eliminateDeadCssNative, emitPluginHook, estimateOptimalCacheConfig, extractAllClasses, extractAndGenerateStateCss, extractAndGenerateStateCssNative, extractClassesFromSource, extractClassesFromSourceNative, extractComponentUsage, extractContainerCssFromSource, extractTwContainerConfigs, extractTwStateConfigs, extractTwStateConfigsNative, fileToRoute, findDeadVariants, generateAtomicCss, generateCssForClasses, generateCssNative, generateSafelist, generateStaticStateCss, generateStaticStateCssNative, generateSubComponentTypes, getAllRoutes, getBucketEngine, getCacheOptimizationHints, getCacheStatistics, getCacheStats, getCompilationMetrics, getCompilerDiagnostics, getContentPaths, getIncrementalEngine, getNativeBridge, getPluginHooks, getRouteClasses, getWatchStats, hasTwUsage, hashContent, hoistComponents, hoistComponentsNative, idRegistryActiveCount, idRegistryCreate, idRegistryDestroy, idRegistryExport, idRegistryGenerate, idRegistryImport, idRegistryLookup, idRegistryNext, idRegistryReset, idRegistrySnapshot, injectClientDirective, injectServerOnlyComment, injectStateHash, isAlreadyTransformed, isWatchRunning, layoutClassesToCss, loadSafelist, loadTailwindConfig, mergeClassesStatic, mergeCssDeclarations, mergeCssDeclarationsNative, minifyCss, normalizeAndDedupClasses, normalizeClasses, optimizeCss, optimizeCssNative, parseAtomicClass, parseClasses, pollWatchEvents, processFileChange, processTailwindCssLightning, propertyIdToString, pruneStaleCacheEntries, rebuildWorkspaceResult, redisCacheClear, redisCacheHitRate, redisCacheKeyCount, redisCacheSize, redisCacheSync, redisClusterStatus, redisDelete, redisDiagnose, redisDisableCacheWarming, redisDisableCluster, redisDisablePersistence, redisEnableCacheWarming, redisEnableCluster, redisEnablePersistence, redisExists, redisExpirationGet, redisExpirationSet, redisFlushAll, redisFlushDb, redisGet, redisGetEvictionPolicy, redisInfo, redisMemoryStats, redisMget, redisMonitor, redisMset, redisOptimizeMemory, redisPing, redisPoolConnect, redisPoolReconnect, redisPoolStats, redisPublish, redisReplicate, redisReplicationStatus, redisSet, redisSetEvictionPolicy, redisSnapshot, redisSubscribe, registerFileClasses, registerGlobalClasses, registerPluginHook, registerPropertyName, registerValueName, resetBucketEngine, resetCompilationMetrics, resetIncrementalEngine, resetNativeBridgeCache, resolveCascade, resolveClassNames, resolveConflictGroup, resolveSimpleVariants, resolveThemeValue, resolveVariants, reverseLookupProperty, reverseLookupValue, runElimination, runLoaderTransform, scanCacheOptimizations, scanFile, scanFileNative, scanFilesBatchNative, scanProjectUsage, scanWorkspace, shouldProcess, shouldSkipFile, startWatch, stopWatch, toAtomicClasses, transformSource, twMerge, twMergeMany, twMergeManyWithSeparator, twMergeRaw, twMergeWithSeparator, unregisterPluginHook, validateCssOutput, validateThemeConfig, valueIdToString, walkAndPrefilterSourceFiles, watchAddPattern, watchClearAll, watchEventTypeToString, watchGetActiveHandles, watchPause, watchRemovePattern, watchResume };
+export { type BatchExtractResult, BucketEngine, type CacheOptimizationHints, type CacheStatistics, type ClassExtractResult, type ClassUsageItem, type ClassifyResult, type CompiledAnimation, type CompiledCssRule, type CompiledTheme, type ComponentMetadata, type ConflictGroupInfo, type ContainerConfig, type CssCompileResult, type DeadCodeResult, type FileChangeEvent, type FileDiff, type FileFingerprint, type GeneratedStateCss, type GeneratedStateRule, type HoistResult, type IncrementalDiffResult, IncrementalEngine, type KeyExpiration, type LoaderOutput, type MergeResult, type NativeBridge, type NativeRscResult, type NativeTransformResult, type OptimalCacheConfig, type PoolInfo, type PrefilterFileResult, type ProcessedCssResult, type ProcessedFileChange, type PruneResult, type PubSubMessage, type RebuildWorkspaceResult, type RedisCacheConfig, type RedisClusterNode, type RedisClusterStatus, type RedisPoolStats, type RegistrySnapshot, type ResolvedClassName, type ResolvedVariantConfig, type SafelistCheckResult, type ScanFileResult, type ScanWorkspaceResult, type StateCssConfig, type StateInjectionResult, type StaticStateCssInput, type ThemeCascadeResult, type ThemeValidationResult, type TwMergeOptions, type TwStateConfigEntry, type VariantTableResult, type WatchEvent, type WatchHandle, type WatchStats, adaptNativeResult, analyzeClassUsageNative, analyzeClasses, analyzeClassesNative, analyzeFile, analyzeRscNative, analyzeVariantUsage, astExtractClasses, atomicRegistrySize, batchExtractClasses, batchExtractClassesNative, bucketSort, buildStyleTag, cachePriority, cacheRead, cacheWrite, checkAgainstSafelist, checkAgainstSafelistNative, classifyAndSortClassesNative, classifyNode, clearAllCaches, clearAtomicRegistry, clearCompileCache, clearCssGenCache, clearParseCache, clearResolveCache, clearThemeCache, collectFiles, compileAnimation, compileClass, compileClasses, compileCssFromClasses, compileCssLightning, compileCssNative2, compileKeyframes, compileTheme, compileToCss, compileToCssBatch, compileVariantTableNative, computeIncrementalDiff, createFingerprint, detectConflicts, detectDeadCode, diffClassLists, eliminateDeadCss, eliminateDeadCssNative, emitPluginHook, estimateOptimalCacheConfig, extractAllClasses, extractAndGenerateStateCss, extractAndGenerateStateCssNative, extractClassesFromSource, extractClassesFromSourceNative, extractComponentUsage, extractContainerCssFromSource, extractTwContainerConfigs, extractTwStateConfigs, extractTwStateConfigsNative, fileToRoute, findDeadVariants, generateAtomicCss, generateCssForClasses, generateCssNative, generateSafelist, generateStaticStateCss, generateStaticStateCssNative, generateSubComponentTypes, getAllRoutes, getBucketEngine, getCacheOptimizationHints, getCacheStatistics, getCacheStats, getCompilationMetrics, getCompilerDiagnostics, getContentPaths, getIncrementalEngine, getNativeBridge, getPluginHooks, getRouteClasses, getWatchStats, hasTwUsage, hashContent, hoistComponentsNative, idRegistryActiveCount, idRegistryCreate, idRegistryDestroy, idRegistryExport, idRegistryGenerate, idRegistryImport, idRegistryLookup, idRegistryNext, idRegistryReset, idRegistrySnapshot, injectClientDirective, injectServerOnlyComment, injectStateHash, isAlreadyTransformed, isWatchRunning, layoutClassesToCss, loadSafelist, loadTailwindConfig, mergeClassesStatic, mergeCssDeclarationsNative, minifyCss, normalizeAndDedupClasses, normalizeClasses, optimizeCssNative, parseAtomicClass, parseClasses, pollWatchEvents, processFileChange, processTailwindCssLightning, propertyIdToString, pruneStaleCacheEntries, rebuildWorkspaceResult, redisCacheClear, redisCacheHitRate, redisCacheKeyCount, redisCacheSize, redisCacheSync, redisClusterStatus, redisDelete, redisDiagnose, redisDisableCacheWarming, redisDisableCluster, redisDisablePersistence, redisEnableCacheWarming, redisEnableCluster, redisEnablePersistence, redisExists, redisExpirationGet, redisExpirationSet, redisFlushAll, redisFlushDb, redisGet, redisGetEvictionPolicy, redisInfo, redisMemoryStats, redisMget, redisMonitor, redisMset, redisOptimizeMemory, redisPing, redisPoolConnect, redisPoolReconnect, redisPoolStats, redisPublish, redisReplicate, redisReplicationStatus, redisSet, redisSetEvictionPolicy, redisSnapshot, redisSubscribe, registerFileClasses, registerGlobalClasses, registerPluginHook, registerPropertyName, registerValueName, resetBucketEngine, resetCompilationMetrics, resetIncrementalEngine, resetNativeBridgeCache, resolveCascade, resolveClassNames, resolveConflictGroup, resolveSimpleVariants, resolveThemeValue, resolveVariants, reverseLookupProperty, reverseLookupValue, runCssPipeline, runElimination, runLoaderTransform, scanCacheOptimizations, scanFile, scanFileNative, scanFilesBatchNative, scanProjectUsage, scanWorkspace, shouldProcess, shouldSkipFile, startWatch, stopWatch, toAtomicClasses, transformSource, twMerge, twMergeMany, twMergeManyWithSeparator, twMergeRaw, twMergeWithSeparator, unregisterPluginHook, validateCssOutput, validateThemeConfig, valueIdToString, walkAndPrefilterSourceFiles, watchAddPattern, watchClearAll, watchEventTypeToString, watchGetActiveHandles, watchPause, watchRemovePattern, watchResume };