tailwind-styled-v4 5.0.37 → 5.0.38

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import React from 'react';
-import { z } from 'zod';
 
 type CSSFillMode = "none" | "forwards" | "backwards" | "both";
 type CSSDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
@@ -220,63 +219,18 @@ type TwObject = TwComponentFactory & TwTagFactory & {
 };
 
 /**
- * tailwind-styled-v4 — Container Query Engine
- *
- * Generates @container rules from a simple breakpoint config.
- *
- * Usage:
- *   const Card = tw.div({
- *     base: "p-4",
- *     container: {
- *       sm: "flex-col",      // @container (min-width: 320px)
- *       md: "flex-row",      // @container (min-width: 640px)
- *       lg: "grid-cols-3",   // @container (min-width: 1024px)
- *     },
- *     containerName: "card",
- *   })
- *
- *   // Wrap with container context:
- *   const CardWrapper = tw.div`@container`
- *
- * Named containers:
- *   const SidebarCard = tw.div({
- *     base: "p-2",
- *     container: { lg: "text-sm" },
- *     containerName: "sidebar",
- *   })
- *   // Generates: @container sidebar (min-width: 1024px) { ... }
- */
-
-interface ContainerEntry {
-    id: string;
-    tag: string;
-    containerName?: string;
-    breakpoints: Array<{
-        minWidth: string;
-        classes: string;
-    }>;
-    cssInjected: boolean;
-}
-declare const containerRegistry: Map<string, ContainerEntry>;
-declare global {
-    interface Window {
-        __TW_CONTAINER_REGISTRY__?: typeof containerRegistry;
-    }
-}
-interface ContainerQueryResult {
-    containerClass: string;
-    hasContainer: true;
-}
-declare function processContainer(tag: string, container: ContainerConfig, containerName?: string): ContainerQueryResult;
-/**
- * Generate @container CSS rules dari breakpoint config.
+ * tailwind-styled-v4 v2 — tw
  *
- * Native-only: Rust string building tanpa intermediate allocations.
+ * API:
+ *   tw.div`p-4 bg-zinc-900`
+ *   tw.button`px-4 [icon] { h-4 w-4 }`   ← sub-components inline
+ *   tw.button({ base: "px-4", variants: { size: { sm: "text-sm" } } })
+ *   tw(Link)`underline text-blue-400`
+ *   tw.server.div`p-4`   ← server-only, compiler enforced + runtime dev warning
  */
-declare function generateContainerCss(tag: string, container: ContainerConfig, containerName?: string): string;
-declare function getContainerRegistry(): Map<string, ContainerEntry>;
 
-declare function createComponent<TConfig extends ComponentConfig>(tag: React.ElementType, config: TConfig | string): TwStyledComponent<TConfig, InferSubFromConfig<TConfig>>;
+declare const server: TwServerObject;
+declare const tw: TwObject;
 
 /**
  * tailwind-styled-v4 — cv()
@@ -290,6 +244,11 @@ declare function createComponent<TConfig extends ComponentConfig>(tag: React.Ele
  *    → Requires native Rust binding for variant resolution
  */
 
+/**
+ * Register pre-computed variant table dari generated file.
+ * Dipanggil otomatis saat import variants.generated.ts
+ */
+declare function registerVariantTable(componentId: string, table: Record<string, string>): void;
 declare function cv<C extends ComponentConfig>(config: C, componentId?: string): CvFn<C>;
 
 /**
@@ -316,39 +275,7 @@ 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;
-    }
-}
+declare function createComponent<TConfig extends ComponentConfig>(tag: React.ElementType, config: TConfig | string): TwStyledComponent<TConfig, InferSubFromConfig<TConfig>>;
 
 interface ThemeConfig$1 {
     colors: Record<string, string>;
@@ -373,45 +300,6 @@ declare function createTwMerge(_options?: MergeOptions): (...classLists: Array<s
 declare const twMerge: (...classLists: Array<string | undefined | null | false>) => string;
 declare function mergeWithRules(rules: Record<string, (classes: string[]) => string>, ...classLists: string[]): string;
 
-/**
- * tailwind-styled-v5 — Native Rust Bindings
- *
- * All functions require native Rust bindings.
- * Uses @tailwind-styled/shared for native resolution.
- */
-interface ParsedClassModifier {
-    type: "opacity" | "arbitrary";
-    value: string;
-}
-interface ParsedClass {
-    raw: string;
-    base: string;
-    variants: string[];
-    modifier?: ParsedClassModifier;
-}
-interface ThemeConfig {
-    colors: Record<string, string>;
-    spacing: Record<string, string>;
-    fonts: Record<string, string>;
-    breakpoints: Record<string, string>;
-    animations: Record<string, string>;
-    raw: Record<string, string>;
-}
-
-interface SubComponentProps {
-    children?: React.ReactNode;
-    className?: string;
-}
-interface SubComponentEntry {
-    name: string;
-    component: React.FC<SubComponentProps>;
-    defaultClasses?: string;
-}
-declare function registerSubComponent(entry: SubComponentEntry): void;
-declare function getSubComponent(name: string): SubComponentEntry | undefined;
-declare function getAllSubComponents(): SubComponentEntry[];
-declare function withSubComponents<T extends object>(Component: T, subComponentNames: string[]): T & Record<string, React.FC<SubComponentProps>>;
-
 /**
  * tailwind-styled-v4 — Reactive State Engine
  *
@@ -470,20 +358,62 @@ declare function generateStateCss(tag: string, state: StateConfig): string;
  */
 declare function getStateRegistry(): Map<string, StateComponentEntry>;
 
-interface StyledOptions {
-    base?: string;
-    variants?: Record<string, Record<string, string>>;
-    defaultVariants?: Record<string, string>;
-    compoundVariants?: Array<{
-        variants: Record<string, string>;
-        className: string;
+/**
+ * tailwind-styled-v4 — Container Query Engine
+ *
+ * Generates @container rules from a simple breakpoint config.
+ *
+ * Usage:
+ *   const Card = tw.div({
+ *     base: "p-4",
+ *     container: {
+ *       sm: "flex-col",      // @container (min-width: 320px)
+ *       md: "flex-row",      // @container (min-width: 640px)
+ *       lg: "grid-cols-3",   // @container (min-width: 1024px)
+ *     },
+ *     containerName: "card",
+ *   })
+ *
+ *   // Wrap with container context:
+ *   const CardWrapper = tw.div`@container`
+ *
+ * Named containers:
+ *   const SidebarCard = tw.div({
+ *     base: "p-2",
+ *     container: { lg: "text-sm" },
+ *     containerName: "sidebar",
+ *   })
+ *   // Generates: @container sidebar (min-width: 1024px) { ... }
+ */
+
+interface ContainerEntry {
+    id: string;
+    tag: string;
+    containerName?: string;
+    breakpoints: Array<{
+        minWidth: string;
+        classes: string;
     }>;
+    cssInjected: boolean;
 }
-type StyledProps = {
-    className?: string;
-} & Record<string, string | number | boolean | undefined>;
-declare function resolveStyledClassName(options: StyledOptions, props?: StyledProps): string;
-declare function styled(options: StyledOptions): (props?: StyledProps) => string;
+declare const containerRegistry: Map<string, ContainerEntry>;
+declare global {
+    interface Window {
+        __TW_CONTAINER_REGISTRY__?: typeof containerRegistry;
+    }
+}
+interface ContainerQueryResult {
+    containerClass: string;
+    hasContainer: true;
+}
+declare function processContainer(tag: string, container: ContainerConfig, containerName?: string): ContainerQueryResult;
+/**
+ * Generate @container CSS rules dari breakpoint config.
+ *
+ * Native-only: Rust string building tanpa intermediate allocations.
+ */
+declare function generateContainerCss(tag: string, container: ContainerConfig, containerName?: string): string;
+declare function getContainerRegistry(): Map<string, ContainerEntry>;
 
 /**
  * tailwind-styled-v4 — createStyledSystem()
@@ -576,19 +506,20 @@ type StyledSystemInstance<T extends SystemTokenMap, C extends Record<string, Sys
 };
 declare function createStyledSystem<T extends SystemTokenMap = SystemTokenMap, C extends Record<string, SystemComponentConfig> = Record<string, SystemComponentConfig>>(config: StyledSystemConfig<T, C>): StyledSystemInstance<T, C>;
 
-/**
- * tailwind-styled-v4 v2 — tw
- *
- * API:
- *   tw.div`p-4 bg-zinc-900`
- *   tw.button`px-4 [icon] { h-4 w-4 }`   ← sub-components inline
- *   tw.button({ base: "px-4", variants: { size: { sm: "text-sm" } } })
- *   tw(Link)`underline text-blue-400`
- *   tw.server.div`p-4`   ← server-only, compiler enforced + runtime dev warning
- */
-
-declare const server: TwServerObject;
-declare const tw: TwObject;
+interface StyledOptions {
+    base?: string;
+    variants?: Record<string, Record<string, string>>;
+    defaultVariants?: Record<string, string>;
+    compoundVariants?: Array<{
+        variants: Record<string, string>;
+        className: string;
+    }>;
+}
+type StyledProps = {
+    className?: string;
+} & Record<string, string | number | boolean | undefined>;
+declare function resolveStyledClassName(options: StyledOptions, props?: StyledProps): string;
+declare function styled(options: StyledOptions): (props?: StyledProps) => string;
 
 /**
  * tailwind-styled-v4 v2 — twTheme
@@ -724,182 +655,77 @@ declare const v4Tokens: {
     readonly fontMono: string;
 };
 
-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;
+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 AnalyzerOptions {
-    readonly scanner?: ScanWorkspaceOptions;
-    readonly classStats?: {
-        readonly top?: number;
-        readonly frequentThreshold?: number;
-    };
-    readonly includeClass?: (className: string) => boolean;
-    readonly semantic?: boolean | {
-        readonly tailwindConfigPath?: string;
-    };
+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;
 }
-
-/**
- * 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;
+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 EnginePluginContext {
-    root: string;
-    timestamp: number;
-}
-interface EngineWatchContext {
-    root: string;
-    timestamp: number;
+interface SubComponentProps {
+    children?: React.ReactNode;
+    className?: string;
 }
-interface EnginePlugin {
+interface SubComponentEntry {
     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>;
+    component: React.FC<SubComponentProps>;
+    defaultClasses?: string;
 }
+declare function registerSubComponent(entry: SubComponentEntry): void;
+declare function getSubComponent(name: string): SubComponentEntry | undefined;
+declare function getAllSubComponents(): SubComponentEntry[];
+declare function withSubComponents<T extends object>(Component: T, subComponentNames: string[]): T & Record<string, React.FC<SubComponentProps>>;
 
-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;
+/**
+ * tailwind-styled-v5 — Native Rust Bindings
+ *
+ * All functions require native Rust bindings.
+ * Uses @tailwind-styled/shared for native resolution.
+ */
+interface ParsedClassModifier {
+    type: "opacity" | "arbitrary";
+    value: string;
 }
-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;
-    };
+interface ParsedClass {
+    raw: string;
+    base: string;
+    variants: string[];
+    modifier?: ParsedClassModifier;
 }
-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;
-    }>;
+interface ThemeConfig {
+    colors: Record<string, string>;
+    spacing: Record<string, string>;
+    fonts: Record<string, string>;
+    breakpoints: Record<string, string>;
+    animations: Record<string, string>;
+    raw: Record<string, string>;
 }
-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 };
+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, createStyledSystem, createTheme, createTwMerge, createUseTokens, cssVar, cv, cx, cxm, generateContainerCss, generateStateCss, generateTokenCssString, getAllSubComponents, getContainerRegistry, getStateRegistry, getSubComponent, getToken, getTokens, liveToken, mergeWithRules, processContainer, processState, registerSubComponent, registerVariantTable, resolveStyledClassName, server, setToken, setTokens, styled, subscribeTokens, t, tokenRef, tokenVar, tw, twMerge, twVar, v4Tokens, withSubComponents };