tailwind-styled-v4 5.0.11 → 5.0.13

package/README.md

@@ -372,12 +372,17 @@ Diukur di Node.js 22, Rust 1.75.
 tailwind-styled-v4/
 ├── native/                    # Rust engine (NAPI-RS)
 │   ├── src/application/
-│   │   └── ast_extract.rs     # Extract Tailwind classes dari source files
+│   │   ├── ast_extract.rs     # Extract Tailwind classes dari source files
+│   │   ├── variant_resolver.rs # Variant resolution with precedence
+│   │   ├── variant_system.rs   # Variant composition system
+│   │   └── theme_resolver_pool.rs # Multi-tier caching
 │   ├── src/domain/
 │   │   ├── variants.rs        # Variant resolution (props override defaults)
+│   │   ├── variant_precedence.rs # Precedence calculation
 │   │   └── transform.rs       # Transform object config → JS component
 │   └── src/infrastructure/
-│       └── cache_store.rs     # Persistent cache dengan bracket-aware parser
+│       ├── napi_bridge_*.rs   # Modularized NAPI bridges
+│       └── cache_*.rs         # Multi-tier cache backends
 │
 ├── packages/
 │   ├── domain/
@@ -385,11 +390,30 @@ tailwind-styled-v4/
 │   │   ├── compiler/          # Tailwind JS + LightningCSS pipeline
 │   │   └── scanner/           # File scanner (Rust-backed)
 │   ├── presentation/
-│   │   └── next/              # Next.js plugin (withTailwindStyled)
+│   │   ├── next/              # Next.js plugin (withTailwindStyled)
+│   │   ├── vite/              # Vite plugin
+│   │   └── rspack/            # Rspack plugin
 │   └── infrastructure/
 │       └── cli/               # CLI (tw setup, tw audit, dll)
+│
+├── config/                    # Configuration files (centralized)
+│   ├── biome.json
+│   ├── tsconfig.base.json
+│   ├── turbo.json
+│   └── ...
+│
+├── docs/
+│   ├── archive/               # Phase docs, session summaries, reference
+│   ├── phase-4/, phase-5/, phase-6/ # Phase-specific documentation
+│   └── api/                   # API reference
 ```
 
+**New Structure (Phase 7):**
+- Configuration files centralized in `config/` directory
+- Documentation archived in `docs/archive/` for cleaner root
+- Modularized NAPI bridges (`napi_bridge_*.rs`) for better maintainability
+- Phase-specific docs in dedicated directories
+
 ---
 
 ## TypeScript
@@ -434,7 +458,79 @@ Card.xyz     // ❌ TypeScript error
 
 ---
 
-## Development
+## Architecture Updates (Phase 7)
+
+### R1-R6: Parser Consolidation through Resolver Caching ✅ Completed 2026-06-12
+
+Recent Phase 7 updates span multiple refactoring rounds:
+
+**R1: Parser Consolidation** ✅
+- Single unified production parser (v2-based)
+- ~5% binary size reduction
+- 100% backward compatible, all 545+ tests passing
+
+**R2-R3: Infrastructure Modularization** ✅
+- NAPI bridge modularized into specialized modules
+- Comprehensive integration tests covering all layers
+- Cache backend infrastructure refactored
+
+**R4: Property Testing Framework** ✅
+- 6 core properties verified across 53 test cases
+- Parser determinism property testing
+- Round-trip parsing validation
+- Cache consistency & eviction properties
+
+**R5: Variant Precedence System** ✅
+- Native variant resolution with precedence handling
+- Compound variant support
+- Theme-aware variant composition
+
+**R6: Resolver Caching** ✅ 
+- Multi-tier caching for theme resolver
+- Performance optimization verified
+
+For architecture details and improvements roadmap, see:
+- [Phase 7 Architecture Design](.kiro/specs/phase-7-architecture/design.md)
+- [R4 Property Tests Design](.kiro/specs/phase-7-architecture/R4_PROPERTY_TESTS_DESIGN.md)
+- [R5 Variant Precedence Design](.kiro/specs/phase-7-architecture/R5_VARIANT_PRECEDENCE_DESIGN.md)
+- [Full spec directory](.kiro/specs/phase-7-architecture/)
+
+---
+
+## Recent Changes (82 commits, not yet pushed)
+
+### Infrastructure & Organization 🏗️
+- **Config centralization** — moved 6 root config files to `config/` directory
+- **Docs reorganization** — 42 summary/reference files moved to `docs/archive/`
+- **Benchmarking suite** — added comprehensive performance benchmarking (`native/benches/`)
+
+### Rust Engine Enhancements 🦀
+- **Modularized NAPI bridges** — split monolithic bridge into specialized modules:
+  - `napi_bridge_cache.rs` — caching layer
+  - `napi_bridge_redis.rs` — distributed cache
+  - `napi_bridge_theme.rs` — theme resolution
+  - `napi_bridge_variants.rs` — variant composition
+  - And 5 more specialized modules
+- **Theme resolver pool** — multi-tier caching with adaptive strategies
+- **Variant system improvements** — precedence calculation, compound variant support
+
+### Testing & Validation ✅
+- **Property testing** — 6 core properties across 53 test cases
+- **Integration tests** — comprehensive NAPI module tests (1000+ tests added)
+- **Variant precedence tests** — 493+ test cases for variant resolution
+- **Performance benchmarks** — week8, week9 scale testing suites
+
+### TypeScript/JS Improvements
+- **Native bridge refactor** — simplified async/sync patterns, improved error handling
+- **Cache integration** — unified cache interface across Redis, LRU, and file-based backends
+- **Stream support** — added streaming CSS compilation
+
+### Documentation 📚
+- **Phase 7 specs** — comprehensive design docs in `.kiro/specs/phase-7-architecture/`
+- **NAPI module guide** — `MIGRATION_GUIDE_PHASE_7_3.md`
+- **Architecture docs** — modular bridge patterns and integration guide
+
+---
 
 ```bash
 git clone https://github.com/Dictionar32/tailwind-styled-v4.git

package/dist/{analyzeWorkspace-DDOQdzzI.d.ts → analyzeWorkspace-CopJNGmi.d.ts}

@@ -93,6 +93,8 @@ interface NativeAnalyzerBinding {
         utilityPrefix: string;
         isArbitrary: boolean;
     }>;
+    /** Map Tailwind class base → conflict group name. Return "" if no group. */
+    resolveConflictGroup?(base: string): string;
     /** Aggregate class counts from scan files JSON. */
     collectClassCounts?(filesJson: string): Array<{
         name: string;

package/dist/{analyzeWorkspace-BS5O4rhC.d.mts → analyzeWorkspace-DpVPccjz.d.mts}

@@ -93,6 +93,8 @@ interface NativeAnalyzerBinding {
         utilityPrefix: string;
         isArbitrary: boolean;
     }>;
+    /** Map Tailwind class base → conflict group name. Return "" if no group. */
+    resolveConflictGroup?(base: string): string;
     /** Aggregate class counts from scan files JSON. */
     collectClassCounts?(filesJson: string): Array<{
         name: string;

package/dist/analyzer.d.mts

@@ -1,5 +1,5 @@
-import { C as ClassToCssOptions, a as ClassToCssResult, c as collectClassCounts, b as buildDistribution } from './analyzeWorkspace-BS5O4rhC.mjs';
-export { A as AnalyzerOptions, d as AnalyzerReport, e as AnalyzerSemanticReport, f as ClassConflict, g as ClassUsage, h as analyzeWorkspace } from './analyzeWorkspace-BS5O4rhC.mjs';
+import { C as ClassToCssOptions, a as ClassToCssResult, c as collectClassCounts, b as buildDistribution } from './analyzeWorkspace-DpVPccjz.mjs';
+export { A as AnalyzerOptions, d as AnalyzerReport, e as AnalyzerSemanticReport, f as ClassConflict, g as ClassUsage, h as analyzeWorkspace } from './analyzeWorkspace-DpVPccjz.mjs';
 import './schemas-DR-SLxZZ.mjs';
 import 'zod';
 
@@ -17,14 +17,14 @@ declare const classToCss: (input: string | string[], options?: ClassToCssOptions
  */
 
 declare const __internal: {
-    normalizeClassInput: (input: string | string[], _binding?: {
+    normalizeClassInput: (input: string | string[], binding: {
         normalizeClassInput?: (s: string) => string[];
     }) => string[];
     splitVariantAndBase: (className: string) => {
         variantKey: string;
         base: string;
     };
-    resolveConflictGroup: (base: string) => string | null;
+    resolveConflictGroup: (base: string) => Promise<string | null>;
     collectClassCounts: typeof collectClassCounts;
     buildDistribution: typeof buildDistribution;
     utilityPrefix: (baseClass: string) => string;

package/dist/analyzer.d.ts

@@ -1,5 +1,5 @@
-import { C as ClassToCssOptions, a as ClassToCssResult, c as collectClassCounts, b as buildDistribution } from './analyzeWorkspace-DDOQdzzI.js';
-export { A as AnalyzerOptions, d as AnalyzerReport, e as AnalyzerSemanticReport, f as ClassConflict, g as ClassUsage, h as analyzeWorkspace } from './analyzeWorkspace-DDOQdzzI.js';
+import { C as ClassToCssOptions, a as ClassToCssResult, c as collectClassCounts, b as buildDistribution } from './analyzeWorkspace-CopJNGmi.js';
+export { A as AnalyzerOptions, d as AnalyzerReport, e as AnalyzerSemanticReport, f as ClassConflict, g as ClassUsage, h as analyzeWorkspace } from './analyzeWorkspace-CopJNGmi.js';
 import './schemas-DR-SLxZZ.js';
 import 'zod';
 
@@ -17,14 +17,14 @@ declare const classToCss: (input: string | string[], options?: ClassToCssOptions
  */
 
 declare const __internal: {
-    normalizeClassInput: (input: string | string[], _binding?: {
+    normalizeClassInput: (input: string | string[], binding: {
         normalizeClassInput?: (s: string) => string[];
     }) => string[];
     splitVariantAndBase: (className: string) => {
         variantKey: string;
         base: string;
     };
-    resolveConflictGroup: (base: string) => string | null;
+    resolveConflictGroup: (base: string) => Promise<string | null>;
     collectClassCounts: typeof collectClassCounts;
     buildDistribution: typeof buildDistribution;
     utilityPrefix: (baseClass: string) => string;

package/dist/analyzer.js

@@ -1,7 +1,7 @@
 'use strict';
 
 require('crypto');
-var fs4 = require('fs');
+var fs3 = require('fs');
 var path5 = require('path');
 var url = require('url');
 var module$1 = require('module');
@@ -12,7 +12,7 @@ var zod = require('zod');
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var fs4__default = /*#__PURE__*/_interopDefault(fs4);
+var fs3__default = /*#__PURE__*/_interopDefault(fs3);
 var path5__default = /*#__PURE__*/_interopDefault(path5);
 
 /* tailwind-styled-v4 v5.0.4 | MIT | https://github.com/dictionar32/tailwind-styled-v4 */
@@ -77,7 +77,7 @@ function loadNativeBinding(options) {
   for (const candidate of candidates) {
     const candidatePath = path5__default.default.resolve(runtimeDir, candidate);
     try {
-      if (!fs4__default.default.existsSync(candidatePath) && !fs4__default.default.existsSync(candidatePath + ".node")) {
+      if (!fs3__default.default.existsSync(candidatePath) && !fs3__default.default.existsSync(candidatePath + ".node")) {
         continue;
       }
       const mod = requireNativeModule(candidatePath);
@@ -109,9 +109,9 @@ function resolveNativeBindingCandidates(options) {
     }
   }
   if (!includeDefaultCandidates) return candidates;
-  if (fs4__default.default.existsSync(runtimeDir)) {
+  if (fs3__default.default.existsSync(runtimeDir)) {
     try {
-      for (const entry of fs4__default.default.readdirSync(runtimeDir)) {
+      for (const entry of fs3__default.default.readdirSync(runtimeDir)) {
         if (entry.endsWith(".node")) candidates.push(entry);
       }
     } catch {
@@ -527,7 +527,7 @@ function defaultCachePath(rootDir, cacheDir) {
 }
 function readCache(rootDir, cacheDir) {
   const cachePath = defaultCachePath(rootDir, cacheDir);
-  fs4__default.default.mkdirSync(path5__default.default.dirname(cachePath), { recursive: true });
+  fs3__default.default.mkdirSync(path5__default.default.dirname(cachePath), { recursive: true });
   const result = cacheReadNative(cachePath);
   if (!result) return [];
   return result.entries.map((e) => ({
@@ -542,7 +542,7 @@ function readCache(rootDir, cacheDir) {
 }
 function writeCache(rootDir, entries, cacheDir) {
   const cachePath = defaultCachePath(rootDir, cacheDir);
-  fs4__default.default.mkdirSync(path5__default.default.dirname(cachePath), { recursive: true });
+  fs3__default.default.mkdirSync(path5__default.default.dirname(cachePath), { recursive: true });
   const success = cacheWriteNative(cachePath, entries);
   if (!success) {
     throw new Error(
@@ -569,27 +569,7 @@ var init_cache_native = __esm({
 function collectFiles(rootDir, extensions, ignoreDirs) {
   const native = collectFilesNative(rootDir, extensions, ignoreDirs);
   if (native !== null) return native;
-  const files = [];
-  function walk(dir) {
-    let entries;
-    try {
-      entries = fs4__default.default.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      const fullPath = path5__default.default.join(dir, entry.name);
-      const rel = path5__default.default.relative(rootDir, fullPath);
-      if (entry.isDirectory()) {
-        const ignored = ignoreDirs.some((d) => entry.name === d || rel.startsWith(d + path5__default.default.sep));
-        if (!ignored) walk(fullPath);
-      } else if (isScannableFile(entry.name, extensions)) {
-        files.push(fullPath);
-      }
-    }
-  }
-  walk(rootDir);
-  return files;
+  throw new Error("FATAL: Native binding 'collectFiles' is required but not available.");
 }
 function mergeResults(batchResults) {
   const files = batchResults.map((r) => ({
@@ -599,8 +579,7 @@ function mergeResults(batchResults) {
   }));
   const native = rebuildWorkspaceResultNative(files);
   if (native) return native;
-  const unique = new Set(files.flatMap((f) => f.classes));
-  return { files, totalFiles: files.length, uniqueClasses: Array.from(unique).sort() };
+  throw new Error("FATAL: Native binding 'rebuildWorkspaceResult' is required but not available.");
 }
 function runChunkInWorker(filePaths) {
   return new Promise((resolve, reject) => {
@@ -739,7 +718,7 @@ __export(src_exports, {
   DEFAULT_IGNORES: () => DEFAULT_IGNORES,
   batchExtractClassesNative: () => batchExtractClassesNative,
   extractClassesNative: () => extractClassesNative,
-  isScannableFile: () => isScannableFile,
+  isScannableFile: () => isScannableFile2,
   parseScanWorkspaceOptions: () => parseScanWorkspaceOptions,
   parseScanWorkspaceResult: () => parseScanWorkspaceResult,
   parseScannerWorkerMessage: () => parseScannerWorkerMessage,
@@ -773,7 +752,7 @@ function resolveScannerWorkerModulePath() {
     path5__default.default.resolve(runtimeDir, "worker.ts")
   ];
   for (const candidate of candidates) {
-    if (fs4__default.default.existsSync(candidate)) return candidate;
+    if (fs3__default.default.existsSync(candidate)) return candidate;
   }
   return null;
 }
@@ -830,7 +809,7 @@ function collectCandidates(rootDir, ignoreDirectories, extensionSet) {
     if (!currentDir) continue;
     const entries = (() => {
       try {
-        return fs4__default.default.readdirSync(currentDir, { withFileTypes: true });
+        return fs3__default.default.readdirSync(currentDir, { withFileTypes: true });
       } catch {
         return [];
       }
@@ -868,7 +847,7 @@ function scanSource(source) {
     "FATAL: Native parser binding is required but not available.\nThis package requires native Rust bindings.\n\nResolution steps:\n1. Build the native Rust module: npm run build:rust"
   );
 }
-function isScannableFile(filePath, includeExtensions = DEFAULT_EXTENSIONS) {
+function isScannableFile2(filePath, includeExtensions = DEFAULT_EXTENSIONS) {
   return includeExtensions.includes(path5__default.default.extname(filePath));
 }
 function scanFile(filePath) {
@@ -929,7 +908,7 @@ function scanWorkspace(rootDir, options = {}) {
     for (const filePath of candidates) {
       const stat = (() => {
         try {
-          return fs4__default.default.statSync(filePath);
+          return fs3__default.default.statSync(filePath);
         } catch {
           return null;
         }
@@ -955,7 +934,7 @@ function scanWorkspace(rootDir, options = {}) {
     for (const { filePath, stat, size, cached } of ranked) {
       const content = (() => {
         try {
-          return fs4__default.default.readFileSync(filePath, "utf8");
+          return fs3__default.default.readFileSync(filePath, "utf8");
         } catch {
           return null;
         }
@@ -1099,7 +1078,7 @@ var init_src2 = __esm({
           )
         ];
         for (const fullPath of candidates) {
-          if (!fs4__default.default.existsSync(fullPath)) continue;
+          if (!fs3__default.default.existsSync(fullPath)) continue;
           try {
             const required = req(fullPath);
             if (required && (typeof required.extractClassesFromSource === "function" || typeof required.parseClasses === "function" || typeof required.parse_classes === "function")) {
@@ -1153,7 +1132,7 @@ function isRecord(value) {
 }
 async function pathExists(filePath) {
   try {
-    await fs4__default.default.promises.access(filePath, fs4__default.default.constants.F_OK);
+    await fs3__default.default.promises.access(filePath, fs3__default.default.constants.F_OK);
     return true;
   } catch {
     return false;
@@ -1369,27 +1348,13 @@ var splitVariantAndBase = (className) => {
   const base = parts.pop() ?? className;
   return { variantKey: parts.join(":"), base };
 };
-var isArbitraryUtility = (baseClass) => {
-  return baseClass.includes("[") && baseClass.includes("]");
-};
-var resolveConflictGroup = (base) => {
-  if (isArbitraryUtility(base)) return null;
-  if (["block", "inline", "inline-block", "inline-flex", "flex", "grid", "hidden"].includes(base))
-    return "display";
-  if (base.startsWith("bg-")) return "bg";
-  if (base.startsWith("text-")) return "text";
-  if (base.startsWith("font-")) return "font";
-  if (base.startsWith("rounded")) return "rounded";
-  if (base.startsWith("shadow")) return "shadow";
-  if (base.startsWith("border-")) return "border";
-  if (base.startsWith("opacity-")) return "opacity";
-  if (base.startsWith("w-") || base.startsWith("min-w-") || base.startsWith("max-w-"))
-    return "width";
-  if (base.startsWith("h-") || base.startsWith("min-h-") || base.startsWith("max-h-"))
-    return "height";
-  if (base.startsWith("p-") || base.startsWith("px-") || base.startsWith("py-")) return "padding";
-  if (base.startsWith("m-") || base.startsWith("mx-") || base.startsWith("my-")) return "margin";
-  return null;
+var resolveConflictGroup = async (base) => {
+  const native = await getNativeBinding();
+  if (!native?.resolveConflictGroup) {
+    throw new Error("Native binding 'resolveConflictGroup' is required but not available.");
+  }
+  const result = native.resolveConflictGroup(base);
+  return result.length > 0 ? result : null;
 };
 var detectConflicts = async (usages) => {
   const native = await getNativeBinding();
@@ -1477,7 +1442,7 @@ var collectCustomUtilities = (config) => {
   return out;
 };
 var collectSafelistFromSource = async (configPath) => {
-  const source = await fs4__default.default.promises.readFile(configPath, "utf8");
+  const source = await fs3__default.default.promises.readFile(configPath, "utf8");
   const { extractClassesNative: extractClassesNative2 } = await Promise.resolve().then(() => (init_src2(), src_exports));
   const allTokens = extractClassesNative2(source);
   const hasSafelist = source.includes("safelist");
@@ -1504,7 +1469,7 @@ var loadTailwindConfig = async (root, semanticOption) => {
       customUtilities: /* @__PURE__ */ new Set()
     };
   }
-  const configStat = await fs4__default.default.promises.stat(configPath).catch(() => null);
+  const configStat = await fs3__default.default.promises.stat(configPath).catch(() => null);
   if (configStat) {
     const cached = tailwindConfigCache.get(configPath);
     if (cached && cached.mtimeMs === configStat.mtimeMs && cached.size === configStat.size) {
@@ -1785,12 +1750,12 @@ async function analyzeWorkspace(root, options = {}) {
 }
 
 // packages/domain/analyzer/src/classToCss.ts
-var normalizeClassInput = (input, _binding) => {
+var normalizeClassInput = (input, binding) => {
   if (typeof input === "string") {
-    if (_binding?.normalizeClassInput) {
-      return _binding.normalizeClassInput(input);
+    if (!binding.normalizeClassInput) {
+      throw new Error("FATAL: Native binding 'normalizeClassInput' is required but not available.");
     }
-    return input.split(/\s+/).map((item) => item.trim()).filter((item) => item.length > 0);
+    return binding.normalizeClassInput(input);
   }
   if (!Array.isArray(input)) {
     throw new TypeError("classToCss input must be a string or an array of strings.");
@@ -1822,11 +1787,11 @@ var mergeDeclarationMap = (target, css, binding) => {
   }
 };
 var declarationMapToString = (declarationMap, binding) => {
-  const entries = Array.from(declarationMap.entries()).map(([property, value]) => ({ property, value }));
-  if (binding?.declarationMapToString) {
-    return binding.declarationMapToString(entries);
+  if (!binding.declarationMapToString) {
+    throw new Error("FATAL: Native binding 'declarationMapToString' is required but not available.");
   }
-  return entries.map(({ property, value }) => `${property}: ${value}`).join("; ");
+  const entries = Array.from(declarationMap.entries()).map(([property, value]) => ({ property, value }));
+  return binding.declarationMapToString(entries);
 };
 var classToCss = async (input, options = {}) => {
   const binding = await requireNativeCssCompiler();