tailwind-styled-v4 5.0.11 → 5.0.12

package/dist/index.d.mts

@@ -3,6 +3,10 @@ import { a as AnimateOptions } from './types-DXr2PmGP.mjs';
 import { H as HtmlTagName } from './index-NDINUhLN.mjs';
 export { T as TokenMap } from './index-NDINUhLN.mjs';
 export { a as LiveTokenSet, T as TokenSubscriber, b as applyTokenSet, t as containerRef, c as createUseTokens, g as generateTokenCssString, d as getToken, e as getTokens, l as liveToken, s as setToken, h as setTokens, i as subscribeTokens, t as tokenRef, j as tokenVar } from './liveTokenEngine-DKoWRtqH.mjs';
+export { K as createEngine } from './index-DJv28Uzq.mjs';
+import './analyzeWorkspace-DpVPccjz.mjs';
+import './schemas-DR-SLxZZ.mjs';
+import 'zod';
 
 /**
  * tailwind-styled-v4 — Core Types
@@ -83,6 +87,13 @@ interface ComponentConfig {
     states?: StatesConfig;
     /** Sub-component definitions — string atau nested { tag: { name: classes } } */
     sub?: Record<string, SubValue>;
+    /**
+     * Pre-computed hash — di-inject oleh turbopackLoader via `inject_state_hash()` (Rust).
+     * Kalau ada, `stateEngine.ts` skip runtime `hashState()` computation sepenuhnya.
+     * Format: 6-char FNV-1a hex string, identik dengan output `hashState()`.
+     * @internal — jangan set manual, ini di-inject otomatis saat build/dev.
+     */
+    __hash?: string;
 }
 /**
  * Strip tag prefix dari "tag:name" format sub key.
@@ -245,8 +256,7 @@ declare function processContainer(tag: string, container: ContainerConfig, conta
 /**
  * Generate @container CSS rules dari breakpoint config.
  *
- * Native-first: Rust string building tanpa intermediate allocations.
- * JS fallback: `buildContainerRules()` loop.
+ * Native-only: Rust string building tanpa intermediate allocations.
  */
 declare function generateContainerCss(tag: string, container: ContainerConfig, containerName?: string): string;
 declare function getContainerRegistry(): Map<string, ContainerEntry>;
@@ -269,40 +279,26 @@ declare function cv<C extends ComponentConfig>(config: C, componentId?: string):
 
 /**
  * tailwind-styled-v4 v2 — cx / cn
- *
- * Native-first:
- *   cn() → simple join (no conflict resolution) — delegates ke Rust `resolve_class_names`
- *   cx() → conflict-aware merge — delegates ke Rust `tw_merge` (preferred)
- *   cxm() → alias cx() untuk backward compat
- *
- * Browser fallback: simple join when native binding unavailable.
- * In browser/client context, classes were already resolved on server during SSR.
+ * Pure Node.js — requires native Rust binding.
  */
 type ClassValue = string | undefined | null | false | 0;
 /**
  * cn — simple class name joiner (no conflict resolution).
- * Native-first: delegates ke Rust `resolve_class_names` yang filter+join
- * dalam satu pass tanpa intermediate allocations.
- * Browser fallback: flat+filter+join.
+ * Delegates ke Rust `resolve_class_names`.
  *
  * @example cn("p-4", isActive && "opacity-100") → "p-4 opacity-100"
  */
 declare function cn(...inputs: (ClassValue | ClassValue[])[]): string;
 /**
  * cx — conflict-aware class merger.
- * Native-first: delegates ke Rust `tw_merge` (preferred).
- * Mendukung array inputs — flatten sebelum di-pass ke native.
- * Browser fallback: simple join without conflict resolution.
+ * Delegates ke Rust `tw_merge_many`.
  *
  * @example cx("p-4 p-8")                        → "p-8"
  * @example cx("bg-red-500", "bg-blue-500")       → "bg-blue-500"
  * @example cx(["flex", "items-center"], "px-4")  → "flex items-center px-4"
  */
 declare function cx(...inputs: (ClassValue | ClassValue[])[]): string;
-/**
- * cxm — alias untuk cx(), kept for backward compatibility.
- * @deprecated Use cx() instead.
- */
+/** @deprecated Use cx() instead. */
 declare const cxm: typeof cx;
 
 interface ThemeConfig$1 {
@@ -316,10 +312,7 @@ interface ThemeConfig$1 {
 
 /**
  * tailwind-styled-v4 — createTwMerge()
- *
- * Native-first: uses Rust `tw_merge_many` when available.
- * Browser fallback: simple join (no conflict resolution).
- * In browser/client context, classes were already resolved on the server during SSR.
+ * Pure Node.js — requires native Rust binding.
  */
 
 interface MergeOptions {
@@ -327,20 +320,6 @@ interface MergeOptions {
     separator?: string;
     theme?: ThemeConfig$1;
 }
-/**
- * createTwMerge — returns a conflict-aware merge function.
- * Native-first: uses Rust `tw_merge_many` when available.
- * Browser fallback: simple join without conflict resolution.
- *
- * IMPORTANT: The browser fallback must produce output identical to the server
- * (Rust) path to avoid React hydration mismatches. For static base classes this
- * is fine because they are pre-resolved at build time. For runtime className
- * overrides passed by the consumer, the join order must be stable and
- * deterministic on both sides.
- *
- * Note: `prefix` and `separator` options are not supported in native mode
- * (Tailwind v3/v4 defaults are used).
- */
 declare function createTwMerge(_options?: MergeOptions): (...classLists: Array<string | undefined | null | false>) => string;
 declare const twMerge: (...classLists: Array<string | undefined | null | false>) => string;
 declare function mergeWithRules(rules: Record<string, (classes: string[]) => string>, ...classLists: string[]): string;
@@ -425,8 +404,13 @@ interface StateEngineResult {
 /**
  * Process a StateConfig for a component.
  * Returns the state class and injects CSS (client-side only).
+ *
+ * @param tag HTML tag name
+ * @param state State config object
+ * @param precomputedHash Optional pre-computed hash dari `inject_state_hash()` Rust transform.
+ *   Kalau ada, skip runtime `hashState()` sepenuhnya → zero hashing overhead.
  */
-declare function processState(tag: string, state: StateConfig): StateEngineResult;
+declare function processState(tag: string, state: StateConfig, precomputedHash?: string): StateEngineResult;
 /**
  * Generate SSR-safe CSS string for a state config.
  * Used by SSR to inject styles into <head>.

package/dist/index.d.ts

@@ -3,6 +3,10 @@ import { a as AnimateOptions } from './types-DXr2PmGP.js';
 import { H as HtmlTagName } from './index-NDINUhLN.js';
 export { T as TokenMap } from './index-NDINUhLN.js';
 export { a as LiveTokenSet, T as TokenSubscriber, b as applyTokenSet, t as containerRef, c as createUseTokens, g as generateTokenCssString, d as getToken, e as getTokens, l as liveToken, s as setToken, h as setTokens, i as subscribeTokens, t as tokenRef, j as tokenVar } from './liveTokenEngine-CN9ian1R.js';
+export { K as createEngine } from './index-BDQw13kn.js';
+import './analyzeWorkspace-CopJNGmi.js';
+import './schemas-DR-SLxZZ.js';
+import 'zod';
 
 /**
  * tailwind-styled-v4 — Core Types
@@ -83,6 +87,13 @@ interface ComponentConfig {
     states?: StatesConfig;
     /** Sub-component definitions — string atau nested { tag: { name: classes } } */
     sub?: Record<string, SubValue>;
+    /**
+     * Pre-computed hash — di-inject oleh turbopackLoader via `inject_state_hash()` (Rust).
+     * Kalau ada, `stateEngine.ts` skip runtime `hashState()` computation sepenuhnya.
+     * Format: 6-char FNV-1a hex string, identik dengan output `hashState()`.
+     * @internal — jangan set manual, ini di-inject otomatis saat build/dev.
+     */
+    __hash?: string;
 }
 /**
  * Strip tag prefix dari "tag:name" format sub key.
@@ -245,8 +256,7 @@ declare function processContainer(tag: string, container: ContainerConfig, conta
 /**
  * Generate @container CSS rules dari breakpoint config.
  *
- * Native-first: Rust string building tanpa intermediate allocations.
- * JS fallback: `buildContainerRules()` loop.
+ * Native-only: Rust string building tanpa intermediate allocations.
  */
 declare function generateContainerCss(tag: string, container: ContainerConfig, containerName?: string): string;
 declare function getContainerRegistry(): Map<string, ContainerEntry>;
@@ -269,40 +279,26 @@ declare function cv<C extends ComponentConfig>(config: C, componentId?: string):
 
 /**
  * tailwind-styled-v4 v2 — cx / cn
- *
- * Native-first:
- *   cn() → simple join (no conflict resolution) — delegates ke Rust `resolve_class_names`
- *   cx() → conflict-aware merge — delegates ke Rust `tw_merge` (preferred)
- *   cxm() → alias cx() untuk backward compat
- *
- * Browser fallback: simple join when native binding unavailable.
- * In browser/client context, classes were already resolved on server during SSR.
+ * Pure Node.js — requires native Rust binding.
  */
 type ClassValue = string | undefined | null | false | 0;
 /**
  * cn — simple class name joiner (no conflict resolution).
- * Native-first: delegates ke Rust `resolve_class_names` yang filter+join
- * dalam satu pass tanpa intermediate allocations.
- * Browser fallback: flat+filter+join.
+ * Delegates ke Rust `resolve_class_names`.
  *
  * @example cn("p-4", isActive && "opacity-100") → "p-4 opacity-100"
  */
 declare function cn(...inputs: (ClassValue | ClassValue[])[]): string;
 /**
  * cx — conflict-aware class merger.
- * Native-first: delegates ke Rust `tw_merge` (preferred).
- * Mendukung array inputs — flatten sebelum di-pass ke native.
- * Browser fallback: simple join without conflict resolution.
+ * Delegates ke Rust `tw_merge_many`.
  *
  * @example cx("p-4 p-8")                        → "p-8"
  * @example cx("bg-red-500", "bg-blue-500")       → "bg-blue-500"
  * @example cx(["flex", "items-center"], "px-4")  → "flex items-center px-4"
  */
 declare function cx(...inputs: (ClassValue | ClassValue[])[]): string;
-/**
- * cxm — alias untuk cx(), kept for backward compatibility.
- * @deprecated Use cx() instead.
- */
+/** @deprecated Use cx() instead. */
 declare const cxm: typeof cx;
 
 interface ThemeConfig$1 {
@@ -316,10 +312,7 @@ interface ThemeConfig$1 {
 
 /**
  * tailwind-styled-v4 — createTwMerge()
- *
- * Native-first: uses Rust `tw_merge_many` when available.
- * Browser fallback: simple join (no conflict resolution).
- * In browser/client context, classes were already resolved on the server during SSR.
+ * Pure Node.js — requires native Rust binding.
  */
 
 interface MergeOptions {
@@ -327,20 +320,6 @@ interface MergeOptions {
     separator?: string;
     theme?: ThemeConfig$1;
 }
-/**
- * createTwMerge — returns a conflict-aware merge function.
- * Native-first: uses Rust `tw_merge_many` when available.
- * Browser fallback: simple join without conflict resolution.
- *
- * IMPORTANT: The browser fallback must produce output identical to the server
- * (Rust) path to avoid React hydration mismatches. For static base classes this
- * is fine because they are pre-resolved at build time. For runtime className
- * overrides passed by the consumer, the join order must be stable and
- * deterministic on both sides.
- *
- * Note: `prefix` and `separator` options are not supported in native mode
- * (Tailwind v3/v4 defaults are used).
- */
 declare function createTwMerge(_options?: MergeOptions): (...classLists: Array<string | undefined | null | false>) => string;
 declare const twMerge: (...classLists: Array<string | undefined | null | false>) => string;
 declare function mergeWithRules(rules: Record<string, (classes: string[]) => string>, ...classLists: string[]): string;
@@ -425,8 +404,13 @@ interface StateEngineResult {
 /**
  * Process a StateConfig for a component.
  * Returns the state class and injects CSS (client-side only).
+ *
+ * @param tag HTML tag name
+ * @param state State config object
+ * @param precomputedHash Optional pre-computed hash dari `inject_state_hash()` Rust transform.
+ *   Kalau ada, skip runtime `hashState()` sepenuhnya → zero hashing overhead.
  */
-declare function processState(tag: string, state: StateConfig): StateEngineResult;
+declare function processState(tag: string, state: StateConfig, precomputedHash?: string): StateEngineResult;
 /**
  * Generate SSR-safe CSS string for a state config.
  * Used by SSR to inject styles into <head>.