tailwind-styled-v4 5.1.12 → 5.1.14

package/dist/index.d.mts

@@ -253,19 +253,34 @@ declare function cv<C extends ComponentConfig>(config: C, componentId?: string):
 
 /**
  * tailwind-styled-v4 v2 — cx / cn
- * Pure Node.js — requires native Rust binding.
+ *
+ * Native Rust binding dipakai di Node.js/SSR untuk performa maksimal.
+ *
+ * Browser fallback (Bug 2 — "Native binding 'resolveClassNames' is required
+ * but not available." crash di browser):
+ *
+ * getNativeBinding() return `null` di browser (bukan throw). Ketika itu terjadi
+ * kita gunakan pure-TS fallback yang semantiknya identik dengan implementasi Rust:
+ * - cn(): filter falsy + join spasi (identik dengan resolve_class_names di Rust)
+ * - cx(): conflict-aware merge via twMergeRawJs (port dari tw_merge.rs)
+ * - cxn(): flatten nested array + filter falsy + join spasi
+ *
+ * Server path TIDAK DIUBAH: throw Error tetap dijalankan jika native null di
+ * Node.js (menandakan miskonfigurasi). Fallback hanya aktif saat isBrowser=true.
  */
 type ClassValue = string | undefined | null | false | 0;
 /**
  * cn — simple class name joiner (no conflict resolution).
- * Delegates ke Rust `resolve_class_names`.
+ * Node.js: delegates ke Rust `resolve_class_names`.
+ * Browser: pure-TS fallback — filter falsy + join spasi.
  *
  * @example cn("p-4", isActive && "opacity-100") → "p-4 opacity-100"
  */
 declare function cn(...inputs: (ClassValue | ClassValue[])[]): string;
 /**
  * cx — conflict-aware class merger.
- * Delegates ke Rust `tw_merge_many`.
+ * Node.js: delegates ke Rust `tw_merge_many`.
+ * Browser: pure-TS fallback via twMergeRawJs (port algoritma Rust).
  *
  * @example cx("p-4 p-8")                        → "p-8"
  * @example cx("bg-red-500", "bg-blue-500")       → "bg-blue-500"

package/dist/index.d.ts

@@ -253,19 +253,34 @@ declare function cv<C extends ComponentConfig>(config: C, componentId?: string):
 
 /**
  * tailwind-styled-v4 v2 — cx / cn
- * Pure Node.js — requires native Rust binding.
+ *
+ * Native Rust binding dipakai di Node.js/SSR untuk performa maksimal.
+ *
+ * Browser fallback (Bug 2 — "Native binding 'resolveClassNames' is required
+ * but not available." crash di browser):
+ *
+ * getNativeBinding() return `null` di browser (bukan throw). Ketika itu terjadi
+ * kita gunakan pure-TS fallback yang semantiknya identik dengan implementasi Rust:
+ * - cn(): filter falsy + join spasi (identik dengan resolve_class_names di Rust)
+ * - cx(): conflict-aware merge via twMergeRawJs (port dari tw_merge.rs)
+ * - cxn(): flatten nested array + filter falsy + join spasi
+ *
+ * Server path TIDAK DIUBAH: throw Error tetap dijalankan jika native null di
+ * Node.js (menandakan miskonfigurasi). Fallback hanya aktif saat isBrowser=true.
  */
 type ClassValue = string | undefined | null | false | 0;
 /**
  * cn — simple class name joiner (no conflict resolution).
- * Delegates ke Rust `resolve_class_names`.
+ * Node.js: delegates ke Rust `resolve_class_names`.
+ * Browser: pure-TS fallback — filter falsy + join spasi.
  *
  * @example cn("p-4", isActive && "opacity-100") → "p-4 opacity-100"
  */
 declare function cn(...inputs: (ClassValue | ClassValue[])[]): string;
 /**
  * cx — conflict-aware class merger.
- * Delegates ke Rust `tw_merge_many`.
+ * Node.js: delegates ke Rust `tw_merge_many`.
+ * Browser: pure-TS fallback via twMergeRawJs (port algoritma Rust).
  *
  * @example cx("p-4 p-8")                        → "p-8"
  * @example cx("bg-red-500", "bg-blue-500")       → "bg-blue-500"