nestable-tailwind-variants 0.2.1 → 0.3.0

package/README.md

@@ -73,11 +73,11 @@ npm install nestable-tailwind-variants
 
 ### `$base` - Always-applied styles
 
-The `$base` property defines styles that are always included in the output:
+The `$base` property defines styles that are always applied at that level. It can be used at the top level or nested inside variants and conditions:
 
 ```ts
 interface CardProps {
-  variant: 'elevated' | 'flat';
+  variant?: 'elevated' | 'flat';
 }
 
 const card = ntv<CardProps>({
@@ -96,14 +96,129 @@ card({ variant: 'elevated' });
 // Note: shadow-md is replaced by shadow-xl via tailwind-merge
 ```
 
+When nested inside a variant or condition, `$base` applies whenever that context is entered:
+
+```ts
+interface ButtonProps {
+  variant?: 'primary' | 'secondary';
+  size?: 'sm' | 'lg';
+}
+
+const button = ntv<ButtonProps>({
+  $base: 'px-4 py-2',
+  variant: {
+    primary: {
+      $base: 'bg-blue-500 text-white', // Applied when variant='primary'
+      size: {
+        sm: 'text-sm',
+        lg: 'text-lg',
+      },
+    },
+    secondary: 'bg-gray-500',
+  },
+});
+
+button({ variant: 'primary' });
+// => 'px-4 py-2 bg-blue-500 text-white'
+
+button({ variant: 'primary', size: 'sm' });
+// => 'px-4 py-2 bg-blue-500 text-white text-sm'
+```
+
+### `$default` - Fallback styles
+
+Use `$default` for styles applied when no conditions match at that level. Within variants, `$default` can also contain nested conditions:
+
+```ts
+interface ChipProps {
+  variant?: 'filled' | 'outlined';
+  isSelected?: boolean;
+}
+
+const chip = ntv<ChipProps>({
+  $base: 'inline-flex items-center rounded-full px-3 py-1',
+  variant: {
+    $default: {
+      $base: 'bg-gray-100', // Applied when variant is not specified
+      isSelected: 'bg-gray-200', // Applied when isSelected and no variant
+    },
+    filled: {
+      $default: 'bg-gray-200 text-gray-800', // Applied when isSelected is false
+      isSelected: 'bg-blue-500 text-white',
+    },
+    outlined: {
+      $default: 'border border-gray-300 text-gray-800',
+      isSelected: 'border-blue-500 text-blue-500',
+    },
+  },
+});
+
+chip();
+// => 'inline-flex items-center rounded-full px-3 py-1 bg-gray-100'
+
+chip({ isSelected: true });
+// => 'inline-flex items-center rounded-full px-3 py-1 bg-gray-200'
+
+chip({ variant: 'filled' });
+// => 'inline-flex items-center rounded-full px-3 py-1 bg-gray-200 text-gray-800'
+
+chip({ variant: 'filled', isSelected: true });
+// => 'inline-flex items-center rounded-full px-3 py-1 bg-blue-500 text-white'
+```
+
+> **Note:** Within variant conditions, `$default` is only available when the variant key is optional. Required variant keys always have a value provided, so there's no fallback case:
+>
+> ```ts
+> // ❌ Error: variant is required, so $default is not allowed
+> ntv<{ variant: 'a' | 'b' }>({
+>   variant: {
+>     a: 'a-class',
+>     b: 'b-class',
+>     $default: 'default-class', // TypeScript error
+>   },
+> });
+>
+> // ✅ OK: variant is optional, so $default is allowed
+> ntv<{ variant?: 'a' | 'b' }>({
+>   variant: {
+>     a: 'a-class',
+>     b: 'b-class',
+>     $default: 'default-class',
+>   },
+> });
+> ```
+
+### `$base` vs `$default`
+
+- **`$base`**: Always applied, regardless of whether conditions match
+- **`$default`**: Only applied when no conditions match
+
+```ts
+interface ButtonProps {
+  isDisabled?: boolean;
+}
+
+const button = ntv<ButtonProps>({
+  $base: 'px-4 py-2', // Always applied
+  $default: 'bg-blue-500', // Only applied when isDisabled is false
+  isDisabled: 'bg-gray-300 cursor-not-allowed',
+});
+
+button();
+// => 'px-4 py-2 bg-blue-500'
+
+button({ isDisabled: true });
+// => 'px-4 py-2 bg-gray-300 cursor-not-allowed'
+```
+
 ### Variants - String-based selection
 
 Define variants as objects mapping variant values to class names:
 
 ```ts
 interface BadgeProps {
-  size: 'sm' | 'md' | 'lg';
-  color: 'info' | 'success' | 'warning';
+  size?: 'sm' | 'md' | 'lg';
+  color?: 'info' | 'success' | 'warning';
 }
 
 const badge = ntv<BadgeProps>({
@@ -130,10 +245,10 @@ Keys matching `is[A-Z]*` or `allows[A-Z]*` are treated as boolean conditions:
 
 ```ts
 interface InputProps {
-  isFocused: boolean;
-  isDisabled: boolean;
-  isInvalid: boolean;
-  allowsClearing: boolean;
+  isFocused?: boolean;
+  isDisabled?: boolean;
+  isInvalid?: boolean;
+  allowsClearing?: boolean;
 }
 
 const input = ntv<InputProps>({
@@ -151,65 +266,6 @@ input({ isDisabled: true, isInvalid: true });
 // => 'border rounded px-3 py-2 bg-gray-100 text-gray-400 cursor-not-allowed border-red-500 text-red-600'
 ```
 
-### `$default` - Fallback styles
-
-Use `$default` for styles applied when no conditions match:
-
-```ts
-interface TextProps {
-  variant: 'primary' | 'danger';
-}
-
-const text = ntv<TextProps>({
-  $default: 'text-gray-500',
-  variant: {
-    primary: 'text-blue-600',
-    danger: 'text-red-600',
-  },
-});
-
-text();
-// => 'text-gray-500'
-
-text({ variant: 'primary' });
-// => 'text-blue-600'
-```
-
-When `$default` is nested inside variants, they accumulate only when no conditions match at each level:
-
-```ts
-interface Props {
-  variant: 'primary';
-  size: 'large';
-}
-
-const styles = ntv<Props>({
-  $base: 'base',
-  $default: 'root-default',
-  variant: {
-    $default: 'variant-default',
-    primary: {
-      size: {
-        $default: 'size-default',
-        large: 'size-large',
-      },
-    },
-  },
-});
-
-styles();
-// => 'base root-default variant-default'
-// No conditions matched, so $defaults accumulate
-
-styles({ variant: 'primary' });
-// => 'base size-default'
-// variant matched, so only nested $default is applied
-
-styles({ variant: 'primary', size: 'large' });
-// => 'base size-large'
-// Both matched, so no $defaults are applied
-```
-
 ## Nested Conditions
 
 The core feature of nestable-tailwind-variants is the ability to nest conditions inside variants.
@@ -218,8 +274,8 @@ The core feature of nestable-tailwind-variants is the ability to nest conditions
 
 ```ts
 interface ChipProps {
-  variant: 'filled' | 'outlined';
-  isSelected: boolean;
+  variant?: 'filled' | 'outlined';
+  isSelected?: boolean;
 }
 
 const chip = ntv<ChipProps>({
@@ -252,10 +308,10 @@ You can nest conditions to any depth:
 
 ```ts
 interface ButtonProps {
-  variant: 'primary';
-  isHovered: boolean;
-  isPressed: boolean;
-  isDisabled: boolean;
+  variant?: 'primary';
+  isHovered?: boolean;
+  isPressed?: boolean;
+  isDisabled?: boolean;
 }
 
 const button = ntv<ButtonProps>({
@@ -294,7 +350,7 @@ Merge multiple style functions into one. Later functions take precedence:
 import { ntv, mergeNtv } from 'nestable-tailwind-variants';
 
 interface BaseButtonProps {
-  size: 'sm' | 'md';
+  size?: 'sm' | 'md';
 }
 
 const baseButton = ntv<BaseButtonProps>({
@@ -306,7 +362,7 @@ const baseButton = ntv<BaseButtonProps>({
 });
 
 interface ColoredButtonProps {
-  variant: 'primary' | 'secondary';
+  variant?: 'primary' | 'secondary';
 }
 
 const coloredButton = ntv<ColoredButtonProps>({
@@ -328,7 +384,7 @@ Pass additional classes using `class` or `className`:
 
 ```ts
 interface BoxProps {
-  variant: 'primary' | 'secondary';
+  variant?: 'primary' | 'secondary';
 }
 
 const box = ntv<BoxProps>({
@@ -435,8 +491,39 @@ const button = ntv<ButtonProps>({
   isDisabled: 'opacity-50',
 });
 
-button({ variant: 'primary', size: 'lg' }); // ✅ OK
+// All props are required - props parameter is mandatory
+button({ variant: 'primary', size: 'lg', isDisabled: false }); // ✅ OK
 button({ variant: 'tertiary' }); // ❌ Error: 'tertiary' is not assignable
+button({ variant: 'primary' }); // ❌ Error: missing 'size' and 'isDisabled'
+```
+
+Use optional properties (`?`) when you want to allow calling the style function without providing all props:
+
+```ts
+interface ButtonProps {
+  variant?: 'primary' | 'secondary';
+  size?: 'sm' | 'md' | 'lg';
+  isDisabled?: boolean;
+}
+
+const button = ntv<ButtonProps>({
+  $base: 'rounded',
+  variant: {
+    primary: 'bg-blue-500',
+    secondary: 'bg-gray-200',
+  },
+  size: {
+    sm: 'text-sm',
+    md: 'text-base',
+    lg: 'text-lg',
+  },
+  isDisabled: 'opacity-50',
+});
+
+// All props are optional - props parameter can be omitted
+button(); // ✅ OK
+button({ variant: 'primary' }); // ✅ OK
+button({ variant: 'primary', size: 'lg' }); // ✅ OK
 ```
 
 Omitting the type argument when the scheme has keys disables type checking. Provide explicit type arguments when possible for better type safety.
@@ -601,13 +688,13 @@ export default [
 
 ### Scheme Properties
 
-| Property       | Description                                          |
-| -------------- | ---------------------------------------------------- |
-| `$base`        | Classes always applied (top-level only)              |
-| `$default`     | Fallback classes when no conditions match            |
-| `is[A-Z]*`     | Boolean condition (e.g., `isSelected`, `isDisabled`) |
-| `allows[A-Z]*` | Boolean condition (e.g., `allowsRemoving`)           |
-| `[key]`        | Variant object mapping values to classes             |
+| Property       | Description                                                                                 |
+| -------------- | ------------------------------------------------------------------------------------------- |
+| `$base`        | Classes always applied at that level (can be used at top-level or nested within conditions) |
+| `$default`     | Fallback classes when no conditions match at that level                                     |
+| `is[A-Z]*`     | Boolean condition (e.g., `isSelected`, `isDisabled`)                                        |
+| `allows[A-Z]*` | Boolean condition (e.g., `allowsRemoving`)                                                  |
+| `[key]`        | Variant object mapping values to classes                                                    |
 
 ## License
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { createMergeNtv, mergeNtv, mergeNtvWithOptions } from './merge.js';
 export { createNtv, ntv } from './ntv.js';
-export type { ClassProp, ClassValue, MergeStyleFunctionProps, NtvOptions, NtvProps, NtvScheme, SchemeFor, StyleFunction, TwMergeConfig, } from './types.js';
+export type { ClassProp, ClassValue, MergeStyleFunctionProps, NtvOptions, Props, PropValue, Scheme, StyleFunction, TwMergeConfig, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EACV,SAAS,EACT,UAAU,EACV,uBAAuB,EACvB,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EACV,SAAS,EACT,UAAU,EACV,uBAAuB,EACvB,UAAU,EACV,KAAK,EACL,SAAS,EACT,MAAM,EACN,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/merge.d.ts

@@ -1,4 +1,4 @@
-import type { MergeStyleFunctionProps, NtvOptions, StyleFunction } from './types.js';
+import type { AnyStyleFunction, MergeStyleFunctionProps, NtvOptions, StyleFunction } from './types.js';
 /**
  * Create a merged style function with custom options (curried version).
  *
@@ -11,7 +11,7 @@ import type { MergeStyleFunctionProps, NtvOptions, StyleFunction } from './types
  * styles({ variant: 'primary' });
  * ```
  */
-export declare function mergeNtvWithOptions<T extends readonly StyleFunction<any>[]>(...styleFns: T): (options?: NtvOptions) => StyleFunction<MergeStyleFunctionProps<T>>;
+export declare function mergeNtvWithOptions<T extends readonly AnyStyleFunction[]>(...styleFns: T): (options?: NtvOptions) => StyleFunction<MergeStyleFunctionProps<T>>;
 /**
  * Merge multiple style functions into a single style function.
  * Later functions take precedence over earlier ones (via tailwind-merge).
@@ -21,11 +21,11 @@ export declare function mergeNtvWithOptions<T extends readonly StyleFunction<any
  *
  * @example
  * ```ts
- * const colorStyles = ntv<{ color: 'red' | 'blue' }>({
+ * const colorStyles = ntv<{ color?: 'red' | 'blue' }>({
  *   color: { red: 'text-red', blue: 'text-blue' },
  * });
  *
- * const sizeStyles = ntv<{ size: 'sm' | 'lg' }>({
+ * const sizeStyles = ntv<{ size?: 'sm' | 'lg' }>({
  *   size: { sm: 'text-sm', lg: 'text-lg' },
  * });
  *
@@ -33,7 +33,7 @@ export declare function mergeNtvWithOptions<T extends readonly StyleFunction<any
  * styles({ color: 'red', size: 'lg' }); // 'text-red text-lg'
  * ```
  */
-export declare function mergeNtv<T extends readonly StyleFunction<any>[]>(...styleFns: T): StyleFunction<MergeStyleFunctionProps<T>>;
+export declare function mergeNtv<T extends readonly AnyStyleFunction[]>(...styleFns: T): StyleFunction<MergeStyleFunctionProps<T>>;
 /**
  * Create a pre-configured mergeNtv function with fixed options.
  *
@@ -55,5 +55,5 @@ export declare function mergeNtv<T extends readonly StyleFunction<any>[]>(...sty
  * const styles = myMergeNtv(baseStyles, overrideStyles);
  * ```
  */
-export declare function createMergeNtv(defaultOptions: NtvOptions): <T extends readonly StyleFunction<any>[]>(...styleFns: T) => StyleFunction<MergeStyleFunctionProps<[...T]>>;
+export declare function createMergeNtv(defaultOptions: NtvOptions): <T extends readonly AnyStyleFunction[]>(...styleFns: T) => StyleFunction<MergeStyleFunctionProps<T>>;
 //# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,uBAAuB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhG;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,EACzE,GAAG,QAAQ,EAAE,CAAC,GACb,CAAC,OAAO,CAAC,EAAE,UAAU,KAAK,aAAa,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAoBrE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,EAC9D,GAAG,QAAQ,EAAE,CAAC,GACb,aAAa,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAE3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,UAAU,IACpB,CAAC,SAAS,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,UAAU,CAAC,oDAG3F"}
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,uBAAuB,EACvB,UAAU,EACV,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,gBAAgB,EAAE,EACvE,GAAG,QAAQ,EAAE,CAAC,GACb,CAAC,OAAO,CAAC,EAAE,UAAU,KAAK,aAAa,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAoBrE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,gBAAgB,EAAE,EAC5D,GAAG,QAAQ,EAAE,CAAC,GACb,aAAa,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAE3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,UAAU,GACzB,CAAC,CAAC,SAAS,SAAS,gBAAgB,EAAE,EACvC,GAAG,QAAQ,EAAE,CAAC,KACX,aAAa,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAQ7C"}

package/dist/merge.js

@@ -34,11 +34,11 @@ export function mergeNtvWithOptions(...styleFns) {
  *
  * @example
  * ```ts
- * const colorStyles = ntv<{ color: 'red' | 'blue' }>({
+ * const colorStyles = ntv<{ color?: 'red' | 'blue' }>({
  *   color: { red: 'text-red', blue: 'text-blue' },
  * });
  *
- * const sizeStyles = ntv<{ size: 'sm' | 'lg' }>({
+ * const sizeStyles = ntv<{ size?: 'sm' | 'lg' }>({
  *   size: { sm: 'text-sm', lg: 'text-lg' },
  * });
  *

package/dist/merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAG,QAAW;IAEd,OAAO,SAAS,mBAAmB,CAAC,EAClC,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,aAAa,MACC,EAAE;QAChB,MAAM,OAAO,GAAG,WAAW;YACzB,CAAC,CAAC,aAAa;gBACb,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC;gBACjC,CAAC,CAAC,OAAO;YACX,CAAC,CAAC,MAAM,CAAC;QAEX,OAAO,SAAS,aAAa,CAAC,EAC5B,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,aAAa,EACxB,GAAG,KAAK,KAC+B,EAAE;YACzC,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YACrD,OAAO,OAAO,CAAC,GAAG,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAC5D,CAA8C,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAG,QAAW;IAEd,OAAO,mBAAmB,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAAC,cAA0B;IACvD,OAAO,SAAS,kBAAkB,CAA0C,GAAG,QAAW;QACxF,OAAO,mBAAmB,CAAC,GAAG,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAC;IAC1D,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAQjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAG,QAAW;IAEd,OAAO,SAAS,mBAAmB,CAAC,EAClC,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,aAAa,MACC,EAAE;QAChB,MAAM,OAAO,GAAG,WAAW;YACzB,CAAC,CAAC,aAAa;gBACb,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC;gBACjC,CAAC,CAAC,OAAO;YACX,CAAC,CAAC,MAAM,CAAC;QAEX,OAAO,SAAS,aAAa,CAAC,EAC5B,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,aAAa,EACxB,GAAG,KAAK,KAC+B,EAAE;YACzC,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAY,CAAC,CAAC,CAAC;YAC5D,OAAO,OAAO,CAAC,GAAG,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAC5D,CAAyD,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAG,QAAW;IAEd,OAAO,mBAAmB,CAAC,GAAG,QAAQ,CAAC,EAA0D,CAAC;AACpG,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAC5B,cAA0B;IAI1B,OAAO,SAAS,kBAAkB,CAChC,GAAG,QAAW;QAEd,OAAO,mBAAmB,CAAC,GAAG,QAAQ,CAAC,CAAC,cAAc,CAErD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/ntv.d.ts

@@ -1,4 +1,4 @@
-import type { NtvOptions, NtvProps, NtvScheme, SchemeFor, StyleFunction } from './types.js';
+import type { NtvOptions, Scheme, StyleFunction } from './types.js';
 /**
  * Create a nestable tailwind variants style function.
  *
@@ -8,7 +8,7 @@ import type { NtvOptions, NtvProps, NtvScheme, SchemeFor, StyleFunction } from '
  *
  * @example
  * ```ts
- * type ButtonProps = { variant: 'primary' | 'secondary'; isDisabled: boolean };
+ * type ButtonProps = { variant?: 'primary' | 'secondary'; isDisabled?: boolean };
  *
  * const button = ntv<ButtonProps>({
  *   $base: 'px-4 py-2 rounded',
@@ -23,8 +23,8 @@ import type { NtvOptions, NtvProps, NtvScheme, SchemeFor, StyleFunction } from '
  * button({ variant: 'primary', isDisabled: true }); // 'px-4 py-2 rounded bg-blue-500 text-white opacity-50 cursor-not-allowed'
  * ```
  */
-export declare function ntv<TProps extends NtvProps>(scheme: SchemeFor<TProps>, options?: NtvOptions): StyleFunction<TProps>;
-export declare function ntv(scheme: NtvScheme, options?: NtvOptions): StyleFunction<any>;
+export declare function ntv<TProps extends {}>(scheme: Scheme<TProps>, options?: NtvOptions): StyleFunction<TProps>;
+export declare function ntv(scheme: Scheme & Record<string, unknown>, options?: NtvOptions): StyleFunction<any>;
 /**
  * Create a pre-configured ntv function with fixed options.
  *
@@ -53,7 +53,7 @@ export declare function ntv(scheme: NtvScheme, options?: NtvOptions): StyleFunct
  * ```
  */
 export declare function createNtv(defaultOptions: NtvOptions): {
-    <TProps extends NtvProps>(scheme: SchemeFor<TProps>): StyleFunction<TProps>;
-    (scheme: NtvScheme): StyleFunction<any>;
+    <TProps extends {}>(scheme: Scheme<TProps>): StyleFunction<TProps>;
+    (scheme: Scheme & Record<string, unknown>): StyleFunction<any>;
 };
 //# sourceMappingURL=ntv.d.ts.map

package/dist/ntv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ntv.d.ts","sourceRoot":"","sources":["../src/ntv.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,EACd,MAAM,YAAY,CAAC;AAiCpB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,GAAG,CAAC,MAAM,SAAS,QAAQ,EACzC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EACzB,OAAO,CAAC,EAAE,UAAU,GACnB,aAAa,CAAC,MAAM,CAAC,CAAC;AACzB,wBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;AAwBjF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CAAC,cAAc,EAAE,UAAU,GAAG;IACrD,CAAC,MAAM,SAAS,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5E,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;CACzC,CAIA"}
+{"version":3,"file":"ntv.d.ts","sourceRoot":"","sources":["../src/ntv.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAa/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wBAAgB,GAAG,CAAC,MAAM,SAAS,EAAE,EACnC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EACtB,OAAO,CAAC,EAAE,UAAU,GACnB,aAAa,CAAC,MAAM,CAAC,CAAC;AACzB,wBAAgB,GAAG,CACjB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,OAAO,CAAC,EAAE,UAAU,GACnB,aAAa,CAAC,GAAG,CAAC,CAAC;AAuBtB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CAAC,cAAc,EAAE,UAAU,GAAG;IAErD,CAAC,MAAM,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;CAChE,CAIA"}

package/dist/ntv.js

@@ -1,7 +1,6 @@
 import { twJoin, twMerge } from 'tailwind-merge';
 import { getCachedTwMerge } from './cache.js';
 import { resolveConditions } from './resolver.js';
-import { isPlainObject } from './utils.js';
 function validateScheme(scheme) {
     if ('class' in scheme) {
         throw new Error('The "class" property is not allowed in ntv scheme. Use "$base" instead.');
@@ -9,30 +8,17 @@ function validateScheme(scheme) {
     if ('className' in scheme) {
         throw new Error('The "className" property is not allowed in ntv scheme. Use "$base" instead.');
     }
-    validateNoNestedSpecialKeys(scheme, false);
-}
-function validateNoNestedSpecialKeys(obj, isNested) {
-    for (const [key, value] of Object.entries(obj)) {
-        // Check if this is a top-level-only key in a nested context
-        if (isNested && key === '$base') {
-            throw new Error(`The "${key}" property is only allowed at the top level of ntv scheme. It cannot be nested inside variants or conditions.`);
-        }
-        // Recursively validate nested objects
-        if (isPlainObject(value)) {
-            validateNoNestedSpecialKeys(value, true);
-        }
-    }
 }
 export function ntv(scheme, { twMerge: usesTwMerge = true, twMergeConfig } = {}) {
     validateScheme(scheme);
-    const { $base, ...conditions } = scheme;
     const mergeFn = usesTwMerge
         ? twMergeConfig
             ? getCachedTwMerge(twMergeConfig)
             : twMerge
         : twJoin;
     return function styleFn({ class: slotClass, className: slotClassName, ...props } = {}) {
-        return mergeFn($base, ...resolveConditions(conditions, props), slotClass, slotClassName);
+        const resolvedClasses = resolveConditions(scheme, props);
+        return mergeFn(...resolvedClasses, slotClass, slotClassName);
     };
 }
 /**

package/dist/ntv.js.map

@@ -1 +1 @@
-{"version":3,"file":"ntv.js","sourceRoot":"","sources":["../src/ntv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AASjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,SAAS,cAAc,CAAC,MAAiB;IACvC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IAED,2BAA2B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,2BAA2B,CAAC,GAA4B,EAAE,QAAiB;IAClF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,4DAA4D;QAC5D,IAAI,QAAQ,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,QAAQ,GAAG,+GAA+G,CAC3H,CAAC;QACJ,CAAC;QAED,sCAAsC;QACtC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,2BAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;AACH,CAAC;AA+BD,MAAM,UAAU,GAAG,CACjB,MAAiB,EACjB,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,aAAa,KAAiB,EAAE;IAE/D,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;IAExC,MAAM,OAAO,GAAG,WAAW;QACzB,CAAC,CAAC,aAAa;YACb,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC;YACjC,CAAC,CAAC,OAAO;QACX,CAAC,CAAC,MAAM,CAAC;IAEX,OAAO,SAAS,OAAO,CAAC,EACtB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,aAAa,EACxB,GAAG,KAAK,KAC+B,EAAE;QACzC,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC3F,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,SAAS,CAAC,cAA0B;IAIlD,OAAO,SAAS,aAAa,CAAC,MAAiB;QAC7C,OAAO,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ntv.js","sourceRoot":"","sources":["../src/ntv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,SAAS,cAAc,CAAC,MAAc;IACpC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;AACH,CAAC;AAmCD,MAAM,UAAU,GAAG,CACjB,MAAc,EACd,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,aAAa,KAAiB,EAAE;IAE/D,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,MAAM,OAAO,GAAG,WAAW;QACzB,CAAC,CAAC,aAAa;YACb,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC;YACjC,CAAC,CAAC,OAAO;QACX,CAAC,CAAC,MAAM,CAAC;IAEX,OAAO,SAAS,OAAO,CAAC,EACtB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,aAAa,EACxB,GAAG,KAAK,KAC+B,EAAE;QACzC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,OAAO,CAAC,GAAG,eAAe,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,SAAS,CAAC,cAA0B;IAKlD,OAAO,SAAS,aAAa,CAAC,MAAwC;QACpE,OAAO,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC"}

package/dist/resolver.d.ts

@@ -7,5 +7,5 @@ import type { ClassValue } from './types.js';
  * - If a variant matches, only the nested evaluation result is used
  * - When no conditions match, $defaults accumulate from each unmatched level
  */
-export declare function resolveConditions({ $default, ...conditions }: Record<string, unknown>, props: Record<string, unknown>): ClassValue[];
+export declare function resolveConditions({ $base, $default, ...conditions }: Record<string, unknown>, props: Record<string, unknown>): ClassValue[];
 //# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,UAAU,EAAE,CA8Cd"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,UAAU,EAAE,CA2Cd"}

package/dist/resolver.js

@@ -1,4 +1,6 @@
-import { isPlainObject } from './utils.js';
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
 /**
  * Resolves conditions from scheme based on provided props to generate class values.
  *
@@ -7,16 +9,11 @@ import { isPlainObject } from './utils.js';
  * - If a variant matches, only the nested evaluation result is used
  * - When no conditions match, $defaults accumulate from each unmatched level
  */
-export function resolveConditions({ $default, ...conditions }, props) {
+export function resolveConditions({ $base, $default, ...conditions }, props) {
     const classes = [];
     let hasMatchedCondition = false;
-    function addClasses(value) {
-        if (isPlainObject(value)) {
-            classes.push(...resolveConditions(value, props));
-        }
-        else {
-            classes.push(value);
-        }
+    function toClassValues(value) {
+        return isPlainObject(value) ? resolveConditions(value, props) : [value];
     }
     for (const [key, value] of Object.entries(conditions)) {
         const propValue = props[key];
@@ -27,24 +24,23 @@ export function resolveConditions({ $default, ...conditions }, props) {
         if (/^is[A-Z]/.test(key) || /^allows[A-Z]/.test(key)) {
             if (propValue) {
                 hasMatchedCondition = true;
-                addClasses(value);
+                classes.push(...toClassValues(value));
             }
             continue;
         }
         // Variant conditions (nested objects)
         if (isPlainObject(value)) {
-            if (typeof propValue === 'string' && propValue in value) {
+            const matched = typeof propValue === 'string' && propValue in value;
+            if (matched) {
                 hasMatchedCondition = true;
-                addClasses(value[propValue]);
-            }
-            else {
-                classes.push(value['$default']);
             }
+            classes.push(...toClassValues(value[matched ? propValue : '$default']));
         }
     }
     if (!hasMatchedCondition) {
         classes.unshift($default);
     }
+    classes.unshift($base);
     return classes;
 }
 //# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAE,QAAQ,EAAE,GAAG,UAAU,EAA2B,EACpD,KAA8B;IAE9B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAEhC,SAAS,UAAU,CAAC,KAAc;QAChC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,KAAmB,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,iEAAiE,GAAG,sCAAsC,CAC3G,CAAC;QACJ,CAAC;QAED,0CAA0C;QAC1C,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,IAAI,SAAS,EAAE,CAAC;gBACd,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;YACD,SAAS;QACX,CAAC;QAED,sCAAsC;QACtC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;gBACxD,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAe,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,OAAO,CAAC,OAAO,CAAC,QAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAEA,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,UAAU,EAA2B,EAC3D,KAA8B;IAE9B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAEhC,SAAS,aAAa,CAAC,KAAc;QACnC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAmB,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,iEAAiE,GAAG,sCAAsC,CAC3G,CAAC;QACJ,CAAC;QAED,0CAA0C;QAC1C,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,IAAI,SAAS,EAAE,CAAC;gBACd,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,SAAS;QACX,CAAC;QAED,sCAAsC;QACtC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,CAAC;YACpE,IAAI,OAAO,EAAE,CAAC;gBACZ,mBAAmB,GAAG,IAAI,CAAC;YAC7B,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,OAAO,CAAC,OAAO,CAAC,QAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,KAAmB,CAAC,CAAC;IAErC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/types.d.ts

@@ -1,9 +1,7 @@
 import type { ClassNameValue as ClassValue, extendTailwindMerge } from 'tailwind-merge';
 export type { ClassValue };
-/**
- * Union type for class prop - ensures only one of class or className is used.
- * This prevents ambiguity when passing class names to components.
- */
+export type PropValue = boolean | string;
+export type Props = Record<string, PropValue | undefined>;
 export type ClassProp = {
     class?: ClassValue;
     className?: never;
@@ -11,88 +9,55 @@ export type ClassProp = {
     class?: never;
     className?: ClassValue;
 };
-/**
- * Props type constraint for NTV style functions.
- * Props are either boolean flags or string variant selections.
- */
-export interface NtvProps {
-}
-/**
- * Merge all properties from a union type into a single object type.
- * Combines props from multiple style functions by creating unions of their values.
- */
-type MergeUnion<T> = {
-    [K in T extends unknown ? keyof T : never]: T extends unknown ? K extends keyof T ? T[K] : never : never;
-};
-/**
- * Extract and merge props types from an array of style functions.
- * Used by mergeNtv to create a combined props type.
- */
-export type MergeStyleFunctionProps<T extends readonly StyleFunction<any>[]> = MergeUnion<{
-    [K in keyof T]: T[K] extends StyleFunction<infer P> ? P : never;
-}[number]>;
-/**
- * Make all properties optional and allow undefined values.
- * Ensures proper handling of missing props in style functions.
- */
-type PartialWithUndefined<T> = {
-    [K in keyof T]?: T[K] | undefined;
-};
-/**
- * Flatten intersection types for better IDE display.
- */
-type Simplify<T> = {
+type Flatten<T> = {
     [K in keyof T]: T[K];
 };
-/**
- * Function signature for style generators.
- * Accepts optional props and returns a string of class names.
- */
-export type StyleFunction<TProps> = (props?: Simplify<PartialWithUndefined<TProps> & ClassProp>) => string;
-/**
- * Boolean scheme entry - class value or nested scheme with conditions.
- */
-type BooleanSchemeEntry<TProps extends NtvProps> = ClassValue | (SchemeFor<TProps> & {
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type OptionalKeys<T> = Exclude<keyof T, RequiredKeys<T>>;
+type NestedScheme<TProps extends Props = {}> = {
+    $base?: ClassValue;
+    $default?: ClassValue | NestedScheme<TProps>;
+} & PropConditions<TProps>;
+type VariantMapping<TVariant extends string, TProps extends Props, TAllowDefault extends boolean> = {
+    [V in TVariant]?: ClassValue | NestedScheme<TProps>;
+} & (TAllowDefault extends true ? {
+    $default?: ClassValue | NestedScheme<TProps>;
+} : {});
+type PropConditions<TProps extends Props> = {
+    [K in keyof TProps & string]?: NonNullable<TProps[K]> extends boolean ? ClassValue | NestedScheme<TProps> : NonNullable<TProps[K]> extends string ? VariantMapping<NonNullable<TProps[K]>, TProps, undefined extends TProps[K] ? true : false> : never;
+};
+export type Scheme<TProps extends Props = {}> = {
+    $base?: ClassValue;
     $default?: ClassValue;
-});
-/**
- * Variant scheme entry - maps variant values to class values or nested schemes.
- */
-type VariantSchemeEntry<TVariant extends string, TProps extends NtvProps> = {
-    [V in TVariant]?: ClassValue | (SchemeFor<TProps> & {
-        $default?: ClassValue;
-    });
+} & PropConditions<TProps>;
+type NormalizeProps<T> = Flatten<{
+    [K in RequiredKeys<T>]: T[K];
 } & {
-    $default?: ClassValue;
+    [K in OptionalKeys<T>]?: T[K];
+}>;
+export type StyleFunction<TProps = Props> = (RequiredKeys<TProps> extends never ? (props?: Flatten<NormalizeProps<TProps> & ClassProp>) => string : (props: Flatten<NormalizeProps<TProps> & ClassProp>) => string) & {
+    readonly __ntvProps?: TProps;
 };
-/**
- * Scheme conditions based on the props type.
- * Maps each prop to its appropriate scheme entry type.
- */
-type SchemeConditions<TProps extends NtvProps> = {
-    [K in keyof TProps & string]?: TProps[K] extends boolean ? BooleanSchemeEntry<TProps> : TProps[K] extends string ? VariantSchemeEntry<TProps[K], TProps> : never;
+export type AnyStyleFunction = ((...args: any[]) => string) & {
+    readonly __ntvProps?: unknown;
 };
-/**
- * Main scheme type for NTV style definitions.
- * Validated against TProps to ensure type safety.
- */
-export type SchemeFor<TProps extends NtvProps> = {
-    $base?: ClassValue;
-    $default?: ClassValue;
-} & SchemeConditions<TProps>;
-/**
- * Runtime scheme interface for NTV style definitions.
- * Untyped version used for JavaScript or when types aren't available.
- */
-export interface NtvScheme {
-    $base?: ClassValue;
-    $default?: ClassValue;
-    [key: string]: unknown;
-}
+type KeysOfUnion<T> = T extends unknown ? keyof T : never;
+type IsRequiredInAny<T, K extends PropertyKey> = T extends unknown ? K extends keyof T ? K extends RequiredKeys<T> ? true : never : never : never;
+type ValueFromUnion<T, K extends PropertyKey> = T extends unknown ? K extends keyof T ? Exclude<T[K], undefined> : never : never;
+type MergeProps<T> = Flatten<{
+    [K in KeysOfUnion<T> as true extends IsRequiredInAny<T, K> ? K : never]: ValueFromUnion<T, K>;
+} & {
+    [K in KeysOfUnion<T> as true extends IsRequiredInAny<T, K> ? never : K]?: ValueFromUnion<T, K>;
+}>;
+type ExtractProps<T> = T extends {
+    readonly __ntvProps?: infer P;
+} ? NonNullable<P> : never;
+export type MergeStyleFunctionProps<T extends readonly AnyStyleFunction[]> = MergeProps<{
+    [K in keyof T]: ExtractProps<T[K]>;
+}[number]>;
 export type TwMergeConfig = Parameters<typeof extendTailwindMerge>[0];
-/**
- * Configuration options for NTV function behavior.
- */
 export interface NtvOptions {
     /**
      * Whether to merge the class names with `tailwind-merge` library.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestable-tailwind-variants",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Tailwind CSS variant library with nestable conditions for compound styling instead of flat compoundVariants.",
   "homepage": "https://github.com/yuheiy/nestable-tailwind-variants#readme",
   "bugs": {

package/dist/utils.d.ts

@@ -1,2 +0,0 @@
-export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
-//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E"}

package/dist/utils.js

@@ -1,4 +0,0 @@
-export function isPlainObject(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}