tailwind-styled-v4 4.0.0 → 5.0.0

package/dist/index.d.cts

@@ -39,8 +39,8 @@ type StyledComponentProps<P extends object, C extends ComponentConfig = Componen
 interface TwStyledComponent<P extends object = Record<string, any>> extends React.ForwardRefExoticComponent<P & React.RefAttributes<any>> {
     extend(strings: TemplateStringsArray, ...exprs: any[]): TwStyledComponent<P>;
     withVariants(config: Partial<ComponentConfig>): TwStyledComponent<P>;
-    /** Attach a CSS animation. Requires @tailwind-styled/animate. */
-    animate(opts: _tailwind_styled_animate.AnimateOptions): TwStyledComponent<P>;
+    /** Attach a CSS animation. Requires @tailwind-styled/animate v5 async API. */
+    animate(opts: _tailwind_styled_animate.AnimateOptions): Promise<TwStyledComponent<P>>;
 }
 type CvFn<C extends ComponentConfig> = (props?: InferVariantProps<C> & {
     className?: string;
@@ -190,6 +190,28 @@ declare function cx(...inputs: ClassValue[]): string;
  */
 declare const cxm: typeof cx;
 
+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 resolveThemeValue(key: string, theme: ThemeConfig, visited?: Set<string>): string;
+declare function extractThemeFromCSS(cssContent: string): ThemeConfig;
+declare function generateTypeDefinitions(theme: ThemeConfig): string;
+declare function clearThemeReaderCache(): void;
+
+interface MergeOptions {
+    prefix?: string;
+    separator?: string;
+    theme?: ThemeConfig;
+}
+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;
+
 /**
  * tailwind-styled-v4 — Live Token Engine
  *
@@ -434,6 +456,21 @@ 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>;
 
+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 — tw
  *
@@ -581,4 +618,38 @@ declare const v4Tokens: {
     readonly fontMono: string;
 };
 
-export { type ComponentConfig, type ContainerConfig, type ContainerEntry, type CvFn, type HtmlTagName, type InferVariantProps, type LiveTokenSet, type ResolvedThemeTokens, type StateComponentEntry, type StateConfig, type StyledComponentProps, type StyledSystemConfig, type StyledSystemInstance, type SystemComponentConfig, type SystemComponentFactory, type SystemTokenMap, type ThemeTokenMap, type TokenMap, type TokenSubscriber, type TwComponentFactory, type TwObject, type TwStyledComponent, type TwTagFactory, type VariantLiterals, applyTokenSet, cn, tokenRef as containerRef, createComponent, createStyledSystem, createTheme, createUseTokens, cssVar, cv, cx, cxm, generateContainerCss, generateStateCss, generateTokenCssString, getContainerRegistry, getStateRegistry, getToken, getTokens, liveToken, processContainer, processState, server, setToken, setTokens, subscribeTokens, t, tokenRef, tokenVar, tw, twVar, v4Tokens };
+/**
+ * tailwind-styled-v4 — Class parser
+ *
+ * Tries the Rust native binding first (parse_classes via napi),
+ * falls back to the JS implementation when the binding is unavailable.
+ *
+ * Public API is unchanged — same types and functions as before.
+ */
+interface ParsedClassModifier {
+    type: "opacity" | "arbitrary";
+    value: string;
+}
+interface ParsedClass {
+    raw: string;
+    base: string;
+    variants: string[];
+    modifier?: ParsedClassModifier;
+}
+/**
+ * Split a Tailwind class string, preserving bracket/parenthesis expressions.
+ * Uses Rust napi when available, JS fallback otherwise.
+ */
+declare function splitClassList(input: string): string[];
+/**
+ * Parse a single Tailwind class token into variants + base + modifier metadata.
+ * Uses Rust napi when available, JS fallback otherwise.
+ */
+declare function parseClassToken(rawToken: string): ParsedClass;
+/**
+ * Parse all Tailwind classes in a space-separated string.
+ * Uses Rust napi for bulk parsing when available.
+ */
+declare function parseTailwindClasses(input: string): ParsedClass[];
+
+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 SystemComponentConfig, type SystemComponentFactory, type SystemTokenMap, type ThemeConfig, type ThemeTokenMap, type TokenMap, type TokenSubscriber, type TwComponentFactory, type TwObject, type TwStyledComponent, type TwTagFactory, type VariantLiterals, applyTokenSet, clearThemeReaderCache, cn, tokenRef as containerRef, createComponent, createStyledSystem, createTheme, createTwMerge, createUseTokens, cssVar, cv, cx, cxm, extractThemeFromCSS, generateContainerCss, generateStateCss, generateTokenCssString, generateTypeDefinitions, getContainerRegistry, getStateRegistry, getToken, getTokens, liveToken, mergeWithRules, parseClassToken, parseTailwindClasses, processContainer, processState, resolveStyledClassName, resolveThemeValue, server, setToken, setTokens, splitClassList, styled, subscribeTokens, t, tokenRef, tokenVar, tw, twMerge, twVar, v4Tokens };

package/dist/index.d.ts

@@ -39,8 +39,8 @@ type StyledComponentProps<P extends object, C extends ComponentConfig = Componen
 interface TwStyledComponent<P extends object = Record<string, any>> extends React.ForwardRefExoticComponent<P & React.RefAttributes<any>> {
     extend(strings: TemplateStringsArray, ...exprs: any[]): TwStyledComponent<P>;
     withVariants(config: Partial<ComponentConfig>): TwStyledComponent<P>;
-    /** Attach a CSS animation. Requires @tailwind-styled/animate. */
-    animate(opts: _tailwind_styled_animate.AnimateOptions): TwStyledComponent<P>;
+    /** Attach a CSS animation. Requires @tailwind-styled/animate v5 async API. */
+    animate(opts: _tailwind_styled_animate.AnimateOptions): Promise<TwStyledComponent<P>>;
 }
 type CvFn<C extends ComponentConfig> = (props?: InferVariantProps<C> & {
     className?: string;
@@ -190,6 +190,28 @@ declare function cx(...inputs: ClassValue[]): string;
  */
 declare const cxm: typeof cx;
 
+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 resolveThemeValue(key: string, theme: ThemeConfig, visited?: Set<string>): string;
+declare function extractThemeFromCSS(cssContent: string): ThemeConfig;
+declare function generateTypeDefinitions(theme: ThemeConfig): string;
+declare function clearThemeReaderCache(): void;
+
+interface MergeOptions {
+    prefix?: string;
+    separator?: string;
+    theme?: ThemeConfig;
+}
+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;
+
 /**
  * tailwind-styled-v4 — Live Token Engine
  *
@@ -434,6 +456,21 @@ 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>;
 
+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 — tw
  *
@@ -581,4 +618,38 @@ declare const v4Tokens: {
     readonly fontMono: string;
 };
 
-export { type ComponentConfig, type ContainerConfig, type ContainerEntry, type CvFn, type HtmlTagName, type InferVariantProps, type LiveTokenSet, type ResolvedThemeTokens, type StateComponentEntry, type StateConfig, type StyledComponentProps, type StyledSystemConfig, type StyledSystemInstance, type SystemComponentConfig, type SystemComponentFactory, type SystemTokenMap, type ThemeTokenMap, type TokenMap, type TokenSubscriber, type TwComponentFactory, type TwObject, type TwStyledComponent, type TwTagFactory, type VariantLiterals, applyTokenSet, cn, tokenRef as containerRef, createComponent, createStyledSystem, createTheme, createUseTokens, cssVar, cv, cx, cxm, generateContainerCss, generateStateCss, generateTokenCssString, getContainerRegistry, getStateRegistry, getToken, getTokens, liveToken, processContainer, processState, server, setToken, setTokens, subscribeTokens, t, tokenRef, tokenVar, tw, twVar, v4Tokens };
+/**
+ * tailwind-styled-v4 — Class parser
+ *
+ * Tries the Rust native binding first (parse_classes via napi),
+ * falls back to the JS implementation when the binding is unavailable.
+ *
+ * Public API is unchanged — same types and functions as before.
+ */
+interface ParsedClassModifier {
+    type: "opacity" | "arbitrary";
+    value: string;
+}
+interface ParsedClass {
+    raw: string;
+    base: string;
+    variants: string[];
+    modifier?: ParsedClassModifier;
+}
+/**
+ * Split a Tailwind class string, preserving bracket/parenthesis expressions.
+ * Uses Rust napi when available, JS fallback otherwise.
+ */
+declare function splitClassList(input: string): string[];
+/**
+ * Parse a single Tailwind class token into variants + base + modifier metadata.
+ * Uses Rust napi when available, JS fallback otherwise.
+ */
+declare function parseClassToken(rawToken: string): ParsedClass;
+/**
+ * Parse all Tailwind classes in a space-separated string.
+ * Uses Rust napi for bulk parsing when available.
+ */
+declare function parseTailwindClasses(input: string): ParsedClass[];
+
+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 SystemComponentConfig, type SystemComponentFactory, type SystemTokenMap, type ThemeConfig, type ThemeTokenMap, type TokenMap, type TokenSubscriber, type TwComponentFactory, type TwObject, type TwStyledComponent, type TwTagFactory, type VariantLiterals, applyTokenSet, clearThemeReaderCache, cn, tokenRef as containerRef, createComponent, createStyledSystem, createTheme, createTwMerge, createUseTokens, cssVar, cv, cx, cxm, extractThemeFromCSS, generateContainerCss, generateStateCss, generateTokenCssString, generateTypeDefinitions, getContainerRegistry, getStateRegistry, getToken, getTokens, liveToken, mergeWithRules, parseClassToken, parseTailwindClasses, processContainer, processState, resolveStyledClassName, resolveThemeValue, server, setToken, setTokens, splitClassList, styled, subscribeTokens, t, tokenRef, tokenVar, tw, twMerge, twVar, v4Tokens };