tailwind-styled-v4 5.0.35 → 5.0.37

package/dist/index.d.mts

@@ -1,12 +1,27 @@
 import React from 'react';
-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-DQI6O24n.mjs';
-import './analyzeWorkspace-hYfu4Hg3.mjs';
-import './schemas-DR-SLxZZ.mjs';
-import 'zod';
+import { z } from 'zod';
+
+type CSSFillMode = "none" | "forwards" | "backwards" | "both";
+type CSSDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
+type CSSIterationCount = number | "infinite";
+type PresetEasing = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | "step-start" | "step-end";
+type CubicBezierEasing = `cubic-bezier(${string})`;
+type StepsEasing = `steps(${string})`;
+type CSSEasing = PresetEasing | CubicBezierEasing | StepsEasing;
+interface AnimateOptions {
+    from: string;
+    to: string;
+    duration?: number;
+    easing?: CSSEasing;
+    delay?: number;
+    fill?: CSSFillMode;
+    iterations?: CSSIterationCount;
+    direction?: CSSDirection;
+    name?: string;
+}
+
+type TokenMap = Record<string, string>;
+type HtmlTagName = keyof HTMLElementTagNameMap;
 
 /**
  * tailwind-styled-v4 — Core Types
@@ -301,6 +316,40 @@ declare function cx(...inputs: (ClassValue | ClassValue[])[]): string;
 /** @deprecated Use cx() instead. */
 declare const cxm: typeof cx;
 
+type TokenSubscriber = (tokens: TokenMap) => void;
+interface LiveTokenSet {
+    vars: Record<string, string>;
+    get(name: string): string | undefined;
+    set(name: string, value: string): void;
+    setAll(tokens: TokenMap): void;
+    snapshot(): TokenMap;
+}
+interface LiveTokenEngineBridge {
+    getToken(name: string): string | undefined;
+    getTokens(): TokenMap;
+    setToken(name: string, value: string): void;
+    setTokens(tokens: TokenMap): void;
+    applyTokenSet(tokens: TokenMap): void;
+    subscribeTokens(fn: TokenSubscriber): () => void;
+    subscribe?(fn: TokenSubscriber): () => void;
+}
+declare function tokenVar(name: string): string;
+declare function tokenRef(name: string): string;
+declare function liveToken(tokens: TokenMap): LiveTokenSet;
+declare function setToken(name: string, value: string): void;
+declare function setTokens(tokens: TokenMap): void;
+declare function applyTokenSet(tokens: TokenMap): void;
+declare function getToken(name: string): string | undefined;
+declare function getTokens(): TokenMap;
+declare function subscribeTokens(fn: TokenSubscriber): () => void;
+declare function generateTokenCssString(): string;
+declare function createUseTokens(): () => TokenMap;
+declare global {
+    interface Window {
+        __TW_TOKEN_ENGINE__?: LiveTokenEngineBridge;
+    }
+}
+
 interface ThemeConfig$1 {
     colors: Record<string, string>;
     spacing: Record<string, string>;
@@ -675,4 +724,182 @@ declare const v4Tokens: {
     readonly fontMono: string;
 };
 
-export { type ComponentConfig, type ContainerConfig, type ContainerEntry, type CvFn, HtmlTagName, type InferVariantProps, type MergeOptions, type ParsedClass, type ParsedClassModifier, type ResolvedThemeTokens, type StateComponentEntry, type StateConfig, type StyledComponentProps, type StyledOptions, type StyledProps, type StyledSystemConfig, type StyledSystemInstance, type SubComponentEntry, type SubComponentMap, type SubComponentProps, type SystemComponentConfig, type SystemComponentFactory, type SystemTokenMap, type ThemeConfig, type ThemeTokenMap, type TwComponentFactory, type TwObject, type TwStyledComponent, type TwSubComponent, type TwTagFactory, type TwTagFactoryAny, type VariantLiterals, cn, createComponent, createStyledSystem, createTheme, createTwMerge, cssVar, cv, cx, cxm, generateContainerCss, generateStateCss, getAllSubComponents, getContainerRegistry, getStateRegistry, getSubComponent, mergeWithRules, processContainer, processState, registerSubComponent, resolveStyledClassName, server, styled, t, tw, twMerge, twVar, v4Tokens, withSubComponents };
+declare const ScanWorkspaceOptionsSchema: z.ZodObject<{
+    includeExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ignoreDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    useCache: z.ZodOptional<z.ZodBoolean>;
+    cacheDir: z.ZodOptional<z.ZodString>;
+    smartInvalidation: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type ScanWorkspaceOptions = z.infer<typeof ScanWorkspaceOptionsSchema>;
+declare const ScanWorkspaceResultSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        classes: z.ZodArray<z.ZodString>;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalFiles: z.ZodNumber;
+    uniqueClasses: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type ScanWorkspaceResult = z.infer<typeof ScanWorkspaceResultSchema>;
+
+/**
+ * Public type contracts for @tailwind-styled/analyzer.
+ * Keep this file aligned with the runtime report shape exposed by src/index.ts.
+ */
+
+interface ClassUsage {
+    readonly name: string;
+    readonly count: number;
+    readonly isUnused?: boolean;
+    readonly isConflict?: boolean;
+}
+interface ClassConflict {
+    readonly className: string;
+    readonly variants: readonly string[];
+    readonly classes: readonly string[];
+    readonly message: string;
+}
+interface AnalyzerClassStats {
+    readonly all: readonly ClassUsage[];
+    readonly top: readonly ClassUsage[];
+    readonly frequent: readonly ClassUsage[];
+    readonly unique: readonly ClassUsage[];
+    readonly distribution: Readonly<Record<string, number>>;
+}
+interface TailwindConfigSummary {
+    readonly path: string;
+    readonly loaded: boolean;
+    readonly safelistCount: number;
+    readonly customUtilityCount: number;
+    readonly warning?: string;
+}
+interface AnalyzerSemanticReport {
+    readonly unusedClasses: readonly ClassUsage[];
+    readonly unknownClasses: readonly ClassUsage[];
+    readonly conflicts: readonly ClassConflict[];
+    readonly tailwindConfig?: TailwindConfigSummary;
+}
+interface AnalyzerReport {
+    readonly root: string;
+    readonly totalFiles: number;
+    readonly uniqueClassCount: number;
+    readonly totalClassOccurrences: number;
+    readonly classStats: AnalyzerClassStats;
+    /** Alias for classStats.top — backward compat & test contract */
+    readonly topClasses: readonly ClassUsage[];
+    readonly safelist: readonly string[];
+    readonly semantic?: AnalyzerSemanticReport;
+}
+interface AnalyzerOptions {
+    readonly scanner?: ScanWorkspaceOptions;
+    readonly classStats?: {
+        readonly top?: number;
+        readonly frequentThreshold?: number;
+    };
+    readonly includeClass?: (className: string) => boolean;
+    readonly semantic?: boolean | {
+        readonly tailwindConfigPath?: string;
+    };
+}
+
+/**
+ * Analyze Tailwind class usage in a workspace and return usage statistics.
+ * Set `semantic.tailwindConfigPath` to override Tailwind config lookup.
+ * @example
+ * const report = await analyzeWorkspace("./src", {
+ *   classStats: { top: 20, frequentThreshold: 2 },
+ *   semantic: { tailwindConfigPath: "tailwind.config.js" },
+ * })
+ */
+declare function analyzeWorkspace(root: string, options?: AnalyzerOptions): Promise<AnalyzerReport>;
+
+interface EngineMetricsSnapshot {
+    eventsReceived: number;
+    eventsProcessed: number;
+    batchesProcessed: number;
+    incrementalUpdates: number;
+    fullRescans: number;
+    skippedLargeFiles: number;
+    queueMaxSize: number;
+    lastBuildMs: number;
+    avgBuildMs: number;
+}
+
+interface EnginePluginContext {
+    root: string;
+    timestamp: number;
+}
+interface EngineWatchContext {
+    root: string;
+    timestamp: number;
+}
+interface EnginePlugin {
+    name: string;
+    beforeScan?(context: EnginePluginContext): void | Promise<void>;
+    afterScan?(scan: ScanWorkspaceResult, context: EnginePluginContext): ScanWorkspaceResult | undefined | Promise<ScanWorkspaceResult | undefined>;
+    transformClasses?(classes: string[], context: EnginePluginContext): string[] | undefined | Promise<string[] | undefined>;
+    beforeBuild?(scan: ScanWorkspaceResult, context: EnginePluginContext): void | Promise<void>;
+    afterBuild?(result: BuildResult, context: EnginePluginContext): BuildResult | undefined | Promise<BuildResult | undefined>;
+    onError?(error: Error, context: EnginePluginContext): void | Promise<void>;
+    beforeWatch?(context: EngineWatchContext): void | Promise<void>;
+    afterWatch?(context: EngineWatchContext): void | Promise<void>;
+}
+
+interface EngineOptions {
+    root?: string;
+    scanner?: ScanWorkspaceOptions;
+    compileCss?: boolean;
+    tailwindConfigPath?: string;
+    plugins?: EnginePlugin[];
+    /** Enable analyzer integration - provides semantic report (unused classes, conflicts). Default: false */
+    analyze?: boolean;
+}
+interface EngineWatchOptions {
+    debounceMs?: number;
+    maxEventsPerFlush?: number;
+    largeFileThreshold?: number;
+}
+interface BuildResult {
+    scan: ScanWorkspaceResult;
+    mergedClassList: string;
+    css: string;
+    /** Analyzer semantic report - present when analyze: true in options */
+    analysis?: {
+        unusedClasses: string[];
+        classConflicts: Array<{
+            className: string;
+            files: string[];
+            classes?: string[];
+            message?: string;
+        }>;
+        classUsage: Record<string, number>;
+        semantic?: AnalyzerSemanticReport;
+        report: AnalyzerReport;
+    };
+}
+type EngineBuildWatchEventType = "initial" | "change" | "unlink" | "full-rescan";
+type EngineWatchEvent = {
+    type: EngineBuildWatchEventType;
+    filePath?: string;
+    result: BuildResult;
+    metrics?: EngineMetricsSnapshot;
+} | {
+    type: "error";
+    filePath?: string;
+    error: string;
+    metrics?: EngineMetricsSnapshot;
+};
+interface TailwindStyledEngine {
+    scan(): Promise<ScanWorkspaceResult>;
+    scanWorkspace(): Promise<ScanWorkspaceResult>;
+    analyzeWorkspace(): Promise<Awaited<ReturnType<typeof analyzeWorkspace>>>;
+    generateSafelist(): Promise<string[]>;
+    build(): Promise<BuildResult>;
+    watch(onEvent: (event: EngineWatchEvent) => void, options?: EngineWatchOptions): Promise<{
+        close(): void;
+    }>;
+}
+declare function createEngine(rawOptions?: EngineOptions): Promise<TailwindStyledEngine>;
+
+export { type ComponentConfig, type ContainerConfig, type ContainerEntry, type CvFn, type HtmlTagName, type InferVariantProps, type LiveTokenSet, type MergeOptions, type ParsedClass, type ParsedClassModifier, type ResolvedThemeTokens, type StateComponentEntry, type StateConfig, type StyledComponentProps, type StyledOptions, type StyledProps, type StyledSystemConfig, type StyledSystemInstance, type SubComponentEntry, type SubComponentMap, type SubComponentProps, type SystemComponentConfig, type SystemComponentFactory, type SystemTokenMap, type ThemeConfig, type ThemeTokenMap, type TokenMap, type TokenSubscriber, type TwComponentFactory, type TwObject, type TwStyledComponent, type TwSubComponent, type TwTagFactory, type TwTagFactoryAny, type VariantLiterals, applyTokenSet, cn, tokenRef as containerRef, createComponent, createEngine, createStyledSystem, createTheme, createTwMerge, createUseTokens, cssVar, cv, cx, cxm, generateContainerCss, generateStateCss, generateTokenCssString, getAllSubComponents, getContainerRegistry, getStateRegistry, getSubComponent, getToken, getTokens, liveToken, mergeWithRules, processContainer, processState, registerSubComponent, resolveStyledClassName, server, setToken, setTokens, styled, subscribeTokens, t, tokenRef, tokenVar, tw, twMerge, twVar, v4Tokens, withSubComponents };

package/dist/index.d.ts

@@ -1,12 +1,27 @@
 import React from 'react';
-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-UkYbyBkR.js';
-import './analyzeWorkspace-B1_XRfdl.js';
-import './schemas-DR-SLxZZ.js';
-import 'zod';
+import { z } from 'zod';
+
+type CSSFillMode = "none" | "forwards" | "backwards" | "both";
+type CSSDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
+type CSSIterationCount = number | "infinite";
+type PresetEasing = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out" | "step-start" | "step-end";
+type CubicBezierEasing = `cubic-bezier(${string})`;
+type StepsEasing = `steps(${string})`;
+type CSSEasing = PresetEasing | CubicBezierEasing | StepsEasing;
+interface AnimateOptions {
+    from: string;
+    to: string;
+    duration?: number;
+    easing?: CSSEasing;
+    delay?: number;
+    fill?: CSSFillMode;
+    iterations?: CSSIterationCount;
+    direction?: CSSDirection;
+    name?: string;
+}
+
+type TokenMap = Record<string, string>;
+type HtmlTagName = keyof HTMLElementTagNameMap;
 
 /**
  * tailwind-styled-v4 — Core Types
@@ -301,6 +316,40 @@ declare function cx(...inputs: (ClassValue | ClassValue[])[]): string;
 /** @deprecated Use cx() instead. */
 declare const cxm: typeof cx;
 
+type TokenSubscriber = (tokens: TokenMap) => void;
+interface LiveTokenSet {
+    vars: Record<string, string>;
+    get(name: string): string | undefined;
+    set(name: string, value: string): void;
+    setAll(tokens: TokenMap): void;
+    snapshot(): TokenMap;
+}
+interface LiveTokenEngineBridge {
+    getToken(name: string): string | undefined;
+    getTokens(): TokenMap;
+    setToken(name: string, value: string): void;
+    setTokens(tokens: TokenMap): void;
+    applyTokenSet(tokens: TokenMap): void;
+    subscribeTokens(fn: TokenSubscriber): () => void;
+    subscribe?(fn: TokenSubscriber): () => void;
+}
+declare function tokenVar(name: string): string;
+declare function tokenRef(name: string): string;
+declare function liveToken(tokens: TokenMap): LiveTokenSet;
+declare function setToken(name: string, value: string): void;
+declare function setTokens(tokens: TokenMap): void;
+declare function applyTokenSet(tokens: TokenMap): void;
+declare function getToken(name: string): string | undefined;
+declare function getTokens(): TokenMap;
+declare function subscribeTokens(fn: TokenSubscriber): () => void;
+declare function generateTokenCssString(): string;
+declare function createUseTokens(): () => TokenMap;
+declare global {
+    interface Window {
+        __TW_TOKEN_ENGINE__?: LiveTokenEngineBridge;
+    }
+}
+
 interface ThemeConfig$1 {
     colors: Record<string, string>;
     spacing: Record<string, string>;
@@ -675,4 +724,182 @@ declare const v4Tokens: {
     readonly fontMono: string;
 };
 
-export { type ComponentConfig, type ContainerConfig, type ContainerEntry, type CvFn, HtmlTagName, type InferVariantProps, type MergeOptions, type ParsedClass, type ParsedClassModifier, type ResolvedThemeTokens, type StateComponentEntry, type StateConfig, type StyledComponentProps, type StyledOptions, type StyledProps, type StyledSystemConfig, type StyledSystemInstance, type SubComponentEntry, type SubComponentMap, type SubComponentProps, type SystemComponentConfig, type SystemComponentFactory, type SystemTokenMap, type ThemeConfig, type ThemeTokenMap, type TwComponentFactory, type TwObject, type TwStyledComponent, type TwSubComponent, type TwTagFactory, type TwTagFactoryAny, type VariantLiterals, cn, createComponent, createStyledSystem, createTheme, createTwMerge, cssVar, cv, cx, cxm, generateContainerCss, generateStateCss, getAllSubComponents, getContainerRegistry, getStateRegistry, getSubComponent, mergeWithRules, processContainer, processState, registerSubComponent, resolveStyledClassName, server, styled, t, tw, twMerge, twVar, v4Tokens, withSubComponents };
+declare const ScanWorkspaceOptionsSchema: z.ZodObject<{
+    includeExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ignoreDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    useCache: z.ZodOptional<z.ZodBoolean>;
+    cacheDir: z.ZodOptional<z.ZodString>;
+    smartInvalidation: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type ScanWorkspaceOptions = z.infer<typeof ScanWorkspaceOptionsSchema>;
+declare const ScanWorkspaceResultSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        classes: z.ZodArray<z.ZodString>;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalFiles: z.ZodNumber;
+    uniqueClasses: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type ScanWorkspaceResult = z.infer<typeof ScanWorkspaceResultSchema>;
+
+/**
+ * Public type contracts for @tailwind-styled/analyzer.
+ * Keep this file aligned with the runtime report shape exposed by src/index.ts.
+ */
+
+interface ClassUsage {
+    readonly name: string;
+    readonly count: number;
+    readonly isUnused?: boolean;
+    readonly isConflict?: boolean;
+}
+interface ClassConflict {
+    readonly className: string;
+    readonly variants: readonly string[];
+    readonly classes: readonly string[];
+    readonly message: string;
+}
+interface AnalyzerClassStats {
+    readonly all: readonly ClassUsage[];
+    readonly top: readonly ClassUsage[];
+    readonly frequent: readonly ClassUsage[];
+    readonly unique: readonly ClassUsage[];
+    readonly distribution: Readonly<Record<string, number>>;
+}
+interface TailwindConfigSummary {
+    readonly path: string;
+    readonly loaded: boolean;
+    readonly safelistCount: number;
+    readonly customUtilityCount: number;
+    readonly warning?: string;
+}
+interface AnalyzerSemanticReport {
+    readonly unusedClasses: readonly ClassUsage[];
+    readonly unknownClasses: readonly ClassUsage[];
+    readonly conflicts: readonly ClassConflict[];
+    readonly tailwindConfig?: TailwindConfigSummary;
+}
+interface AnalyzerReport {
+    readonly root: string;
+    readonly totalFiles: number;
+    readonly uniqueClassCount: number;
+    readonly totalClassOccurrences: number;
+    readonly classStats: AnalyzerClassStats;
+    /** Alias for classStats.top — backward compat & test contract */
+    readonly topClasses: readonly ClassUsage[];
+    readonly safelist: readonly string[];
+    readonly semantic?: AnalyzerSemanticReport;
+}
+interface AnalyzerOptions {
+    readonly scanner?: ScanWorkspaceOptions;
+    readonly classStats?: {
+        readonly top?: number;
+        readonly frequentThreshold?: number;
+    };
+    readonly includeClass?: (className: string) => boolean;
+    readonly semantic?: boolean | {
+        readonly tailwindConfigPath?: string;
+    };
+}
+
+/**
+ * Analyze Tailwind class usage in a workspace and return usage statistics.
+ * Set `semantic.tailwindConfigPath` to override Tailwind config lookup.
+ * @example
+ * const report = await analyzeWorkspace("./src", {
+ *   classStats: { top: 20, frequentThreshold: 2 },
+ *   semantic: { tailwindConfigPath: "tailwind.config.js" },
+ * })
+ */
+declare function analyzeWorkspace(root: string, options?: AnalyzerOptions): Promise<AnalyzerReport>;
+
+interface EngineMetricsSnapshot {
+    eventsReceived: number;
+    eventsProcessed: number;
+    batchesProcessed: number;
+    incrementalUpdates: number;
+    fullRescans: number;
+    skippedLargeFiles: number;
+    queueMaxSize: number;
+    lastBuildMs: number;
+    avgBuildMs: number;
+}
+
+interface EnginePluginContext {
+    root: string;
+    timestamp: number;
+}
+interface EngineWatchContext {
+    root: string;
+    timestamp: number;
+}
+interface EnginePlugin {
+    name: string;
+    beforeScan?(context: EnginePluginContext): void | Promise<void>;
+    afterScan?(scan: ScanWorkspaceResult, context: EnginePluginContext): ScanWorkspaceResult | undefined | Promise<ScanWorkspaceResult | undefined>;
+    transformClasses?(classes: string[], context: EnginePluginContext): string[] | undefined | Promise<string[] | undefined>;
+    beforeBuild?(scan: ScanWorkspaceResult, context: EnginePluginContext): void | Promise<void>;
+    afterBuild?(result: BuildResult, context: EnginePluginContext): BuildResult | undefined | Promise<BuildResult | undefined>;
+    onError?(error: Error, context: EnginePluginContext): void | Promise<void>;
+    beforeWatch?(context: EngineWatchContext): void | Promise<void>;
+    afterWatch?(context: EngineWatchContext): void | Promise<void>;
+}
+
+interface EngineOptions {
+    root?: string;
+    scanner?: ScanWorkspaceOptions;
+    compileCss?: boolean;
+    tailwindConfigPath?: string;
+    plugins?: EnginePlugin[];
+    /** Enable analyzer integration - provides semantic report (unused classes, conflicts). Default: false */
+    analyze?: boolean;
+}
+interface EngineWatchOptions {
+    debounceMs?: number;
+    maxEventsPerFlush?: number;
+    largeFileThreshold?: number;
+}
+interface BuildResult {
+    scan: ScanWorkspaceResult;
+    mergedClassList: string;
+    css: string;
+    /** Analyzer semantic report - present when analyze: true in options */
+    analysis?: {
+        unusedClasses: string[];
+        classConflicts: Array<{
+            className: string;
+            files: string[];
+            classes?: string[];
+            message?: string;
+        }>;
+        classUsage: Record<string, number>;
+        semantic?: AnalyzerSemanticReport;
+        report: AnalyzerReport;
+    };
+}
+type EngineBuildWatchEventType = "initial" | "change" | "unlink" | "full-rescan";
+type EngineWatchEvent = {
+    type: EngineBuildWatchEventType;
+    filePath?: string;
+    result: BuildResult;
+    metrics?: EngineMetricsSnapshot;
+} | {
+    type: "error";
+    filePath?: string;
+    error: string;
+    metrics?: EngineMetricsSnapshot;
+};
+interface TailwindStyledEngine {
+    scan(): Promise<ScanWorkspaceResult>;
+    scanWorkspace(): Promise<ScanWorkspaceResult>;
+    analyzeWorkspace(): Promise<Awaited<ReturnType<typeof analyzeWorkspace>>>;
+    generateSafelist(): Promise<string[]>;
+    build(): Promise<BuildResult>;
+    watch(onEvent: (event: EngineWatchEvent) => void, options?: EngineWatchOptions): Promise<{
+        close(): void;
+    }>;
+}
+declare function createEngine(rawOptions?: EngineOptions): Promise<TailwindStyledEngine>;
+
+export { type ComponentConfig, type ContainerConfig, type ContainerEntry, type CvFn, type HtmlTagName, type InferVariantProps, type LiveTokenSet, type MergeOptions, type ParsedClass, type ParsedClassModifier, type ResolvedThemeTokens, type StateComponentEntry, type StateConfig, type StyledComponentProps, type StyledOptions, type StyledProps, type StyledSystemConfig, type StyledSystemInstance, type SubComponentEntry, type SubComponentMap, type SubComponentProps, type SystemComponentConfig, type SystemComponentFactory, type SystemTokenMap, type ThemeConfig, type ThemeTokenMap, type TokenMap, type TokenSubscriber, type TwComponentFactory, type TwObject, type TwStyledComponent, type TwSubComponent, type TwTagFactory, type TwTagFactoryAny, type VariantLiterals, applyTokenSet, cn, tokenRef as containerRef, createComponent, createEngine, createStyledSystem, createTheme, createTwMerge, createUseTokens, cssVar, cv, cx, cxm, generateContainerCss, generateStateCss, generateTokenCssString, getAllSubComponents, getContainerRegistry, getStateRegistry, getSubComponent, getToken, getTokens, liveToken, mergeWithRules, processContainer, processState, registerSubComponent, resolveStyledClassName, server, setToken, setTokens, styled, subscribeTokens, t, tokenRef, tokenVar, tw, twMerge, twVar, v4Tokens, withSubComponents };

package/dist/index.js

@@ -5228,17 +5228,12 @@ function hashState(tag, state) {
   _hashStateCache.set(sortedKey, id);
   return id;
 }
-var _twClassesToCssCache = /* @__PURE__ */ new Map();
-function twClassesToCss(classes) {
-  const cached = _twClassesToCssCache.get(classes);
-  if (cached !== void 0) return cached;
+function generateStateRules(id, state) {
   const native = getNativeBinding();
-  if (!native?.twClassesToCss) {
-    throw new Error("FATAL: Native binding 'twClassesToCss' is required but not available.");
+  if (!native?.generateRuntimeStateCss) {
+    throw new Error("FATAL: Native binding 'generateRuntimeStateCss' is required but not available.");
   }
-  const result = native.twClassesToCss(classes);
-  _twClassesToCssCache.set(classes, result);
-  return result;
+  return native.generateRuntimeStateCss(id, JSON.stringify(state), null).map((rule) => rule.cssRule);
 }
 var _staticCssDetected = /* @__PURE__ */ new Set();
 var _batchedInjectFn = null;
@@ -5270,10 +5265,7 @@ function injectStateStyles(id, state) {
       }
     }
   }
-  const rules = Object.entries(state).map(([stateName, classes]) => {
-    const css = twClassesToCss(classes);
-    return css ? `.${id}[data-${stateName}="true"]{${css}}` : null;
-  }).filter(Boolean);
+  const rules = generateStateRules(id, state);
   if (rules.length === 0) return;
   if (_batchedInjectFn) {
     for (const rule of rules) _batchedInjectFn(rule);
@@ -5303,11 +5295,7 @@ function processState(tag, state, precomputedHash) {
 }
 function generateStateCss(tag, state) {
   const id = hashState(tag, state);
-  const rules = Object.entries(state).map(([stateName, classes]) => {
-    const css = twClassesToCss(classes);
-    return css ? `.${id}[data-${stateName}="true"]{${css}}` : null;
-  }).filter(Boolean);
-  return rules.join("\n");
+  return generateStateRules(id, state).join("\n");
 }
 function getStateRegistry() {
   return stateRegistry;
@@ -5712,7 +5700,13 @@ function lookupGenerated(componentId, props, defaultVariants, variantKeys) {
   }
   const binding = getNativeBinding();
   if (!binding?.buildVariantLookupKey) {
-    throw new Error("FATAL: Native binding 'buildVariantLookupKey' is required but not available.");
+    const parts = [];
+    for (const k of sortedKeys) {
+      const v = props[k] ?? defaultVariants?.[k];
+      if (v != null) parts.push(`${k}:${String(v)}`);
+    }
+    const key2 = parts.join("|");
+    return table[key2];
   }
   const relevantDefaults = {};
   const relevantProps = {};
@@ -5755,7 +5749,31 @@ function resolveVariantsNative(config, props) {
   const { variants = {}, defaultVariants = {} } = config;
   const binding = getNativeBinding();
   if (!binding?.resolveVariants) {
-    throw new Error("FATAL: Native binding 'resolveVariants' is required but not available. Build cannot continue.");
+    const variantKeys2 = Object.keys(variants);
+    const classes = [];
+    for (const key of variantKeys2) {
+      const value = props[key] ?? defaultVariants[key];
+      if (value != null) {
+        const variantClass = variants[key]?.[String(value)];
+        if (variantClass) classes.push(variantClass);
+      }
+    }
+    if (config.compoundVariants) {
+      for (const compound of config.compoundVariants) {
+        const { class: compoundClass, ...conditions } = compound;
+        const resolved = {};
+        for (const key of variantKeys2) {
+          resolved[key] = String(
+            props[key] ?? defaultVariants[key] ?? ""
+          );
+        }
+        const matches = Object.entries(conditions).every(
+          ([k, v]) => resolved[k] === v
+        );
+        if (matches) classes.push(compoundClass);
+      }
+    }
+    return classes.join(" ");
   }
   const variantKeys = Object.keys(variants);
   const configJson = _getConfigJson(config);