nestable-tailwind-variants 0.1.4 → 0.2.0

package/dist/cache.d.ts

@@ -0,0 +1,7 @@
+import { extendTailwindMerge } from 'tailwind-merge';
+import type { NtvOptions } from './types.js';
+type TwMergeConfig = NonNullable<NtvOptions['twMergeConfig']>;
+type TwMergeFn = ReturnType<typeof extendTailwindMerge>;
+export declare function getCachedTwMerge(config: TwMergeConfig): TwMergeFn;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,KAAK,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;AAC9D,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIxD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAOjE"}

package/dist/cache.js

@@ -0,0 +1,11 @@
+import { extendTailwindMerge } from 'tailwind-merge';
+const cache = new Map();
+export function getCachedTwMerge(config) {
+    let cached = cache.get(config);
+    if (!cached) {
+        cached = extendTailwindMerge(config);
+        cache.set(config, cached);
+    }
+    return cached;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAMrD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;AAElD,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { composeNtv, createComposeNtv } from './composeNtv.js';
-export { createNTV, ntv } from './ntv.js';
-export type { NTVConfig, TWMergeConfig } from './types.js';
+export { createMergeNtv, mergeNtv, mergeNtvWithOptions } from './merge.js';
+export { createNtv, ntv } from './ntv.js';
+export type { ClassProp, ClassValue, NtvOptions, 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,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,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,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { composeNtv, createComposeNtv } from './composeNtv.js';
-export { createNTV, ntv } from './ntv.js';
+export { createMergeNtv, mergeNtv, mergeNtvWithOptions } from './merge.js';
+export { createNtv, ntv } from './ntv.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","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"}

package/dist/merge.d.ts

@@ -0,0 +1,59 @@
+import type { MergeStyleFunctionProps, NtvOptions, StyleFunction } from './types.js';
+/**
+ * Create a merged style function with custom options (curried version).
+ *
+ * @param styleFns - Style functions to merge
+ * @returns A function that accepts options and returns a merged style function
+ *
+ * @example
+ * ```ts
+ * const styles = mergeNtvWithOptions(baseStyles, overrideStyles)({ twMerge: false });
+ * styles({ variant: 'primary' });
+ * ```
+ */
+export declare function mergeNtvWithOptions<T extends readonly StyleFunction<any>[]>(...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).
+ *
+ * @param styleFns - Style functions to merge
+ * @returns A merged style function that accepts combined props from all input functions
+ *
+ * @example
+ * ```ts
+ * const colorStyles = ntv<{ color: 'red' | 'blue' }>({
+ *   color: { red: 'text-red', blue: 'text-blue' },
+ * });
+ *
+ * const sizeStyles = ntv<{ size: 'sm' | 'lg' }>({
+ *   size: { sm: 'text-sm', lg: 'text-lg' },
+ * });
+ *
+ * const styles = mergeNtv(colorStyles, sizeStyles);
+ * styles({ color: 'red', size: 'lg' }); // 'text-red text-lg'
+ * ```
+ */
+export declare function mergeNtv<T extends readonly StyleFunction<any>[]>(...styleFns: T): StyleFunction<MergeStyleFunctionProps<T>>;
+/**
+ * Create a pre-configured mergeNtv function with fixed options.
+ *
+ * @param defaultOptions - Default options to apply to all mergeNtv calls
+ * @returns A pre-configured mergeNtv function
+ *
+ * @example
+ * ```ts
+ * const myMergeNtv = createMergeNtv({
+ *   twMergeConfig: {
+ *     extend: {
+ *       classGroups: {
+ *         'font-size': [{ text: ['huge', 'tiny'] }],
+ *       },
+ *     },
+ *   },
+ * });
+ *
+ * const styles = myMergeNtv(baseStyles, overrideStyles);
+ * ```
+ */
+export declare function createMergeNtv(defaultOptions: NtvOptions): <T extends readonly StyleFunction<any>[]>(...styleFns: T) => StyleFunction<MergeStyleFunctionProps<[...T]>>;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +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"}

package/dist/merge.js

@@ -0,0 +1,78 @@
+import { twJoin, twMerge } from 'tailwind-merge';
+import { getCachedTwMerge } from './cache.js';
+/**
+ * Create a merged style function with custom options (curried version).
+ *
+ * @param styleFns - Style functions to merge
+ * @returns A function that accepts options and returns a merged style function
+ *
+ * @example
+ * ```ts
+ * const styles = mergeNtvWithOptions(baseStyles, overrideStyles)({ twMerge: false });
+ * styles({ variant: 'primary' });
+ * ```
+ */
+export function mergeNtvWithOptions(...styleFns) {
+    return function createMergedStyleFn({ twMerge: usesTwMerge = true, twMergeConfig, } = {}) {
+        const mergeFn = usesTwMerge
+            ? twMergeConfig
+                ? getCachedTwMerge(twMergeConfig)
+                : twMerge
+            : twJoin;
+        return function mergedStyleFn({ class: slotClass, className: slotClassName, ...props } = {}) {
+            const styleResults = styleFns.map((fn) => fn(props));
+            return mergeFn(...styleResults, slotClass, slotClassName);
+        };
+    };
+}
+/**
+ * Merge multiple style functions into a single style function.
+ * Later functions take precedence over earlier ones (via tailwind-merge).
+ *
+ * @param styleFns - Style functions to merge
+ * @returns A merged style function that accepts combined props from all input functions
+ *
+ * @example
+ * ```ts
+ * const colorStyles = ntv<{ color: 'red' | 'blue' }>({
+ *   color: { red: 'text-red', blue: 'text-blue' },
+ * });
+ *
+ * const sizeStyles = ntv<{ size: 'sm' | 'lg' }>({
+ *   size: { sm: 'text-sm', lg: 'text-lg' },
+ * });
+ *
+ * const styles = mergeNtv(colorStyles, sizeStyles);
+ * styles({ color: 'red', size: 'lg' }); // 'text-red text-lg'
+ * ```
+ */
+export function mergeNtv(...styleFns) {
+    return mergeNtvWithOptions(...styleFns)();
+}
+/**
+ * Create a pre-configured mergeNtv function with fixed options.
+ *
+ * @param defaultOptions - Default options to apply to all mergeNtv calls
+ * @returns A pre-configured mergeNtv function
+ *
+ * @example
+ * ```ts
+ * const myMergeNtv = createMergeNtv({
+ *   twMergeConfig: {
+ *     extend: {
+ *       classGroups: {
+ *         'font-size': [{ text: ['huge', 'tiny'] }],
+ *       },
+ *     },
+ *   },
+ * });
+ *
+ * const styles = myMergeNtv(baseStyles, overrideStyles);
+ * ```
+ */
+export function createMergeNtv(defaultOptions) {
+    return function configuredMergeNtv(...styleFns) {
+        return mergeNtvWithOptions(...styleFns)(defaultOptions);
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +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"}

package/dist/ntv.d.ts

@@ -1,61 +1,59 @@
-import type { NTVConfig, StyleFunction } from './types.js';
-type BooleanConditionKey = `is${Capitalize<string>}` | `allows${Capitalize<string>}`;
-type ExtractBooleanKeys<Props> = {
-    [K in keyof Props]: K extends BooleanConditionKey ? K : never;
-}[keyof Props];
-type ExtractVariantKeys<Props> = Exclude<keyof Props, ExtractBooleanKeys<Props>>;
-type NestedStyleValue<Props> = string | StyleDefinition<Props>;
-type StyleDefinition<Props> = {
-    default?: string;
-} & {
-    [K in ExtractBooleanKeys<Props>]?: NestedStyleValue<Props>;
-} & {
-    [K in ExtractVariantKeys<Props>]?: {
-        [V in Extract<Props[K], string>]?: NestedStyleValue<Props>;
-    };
-};
+import type { NtvOptions, NtvProps, NtvScheme, SchemeFor, StyleFunction } from './types.js';
 /**
- * Creates a customized `ntv` function with the specified options.
+ * Create a nestable tailwind variants style function.
+ *
+ * @param scheme - The scheme object defining variants and conditions
+ * @param options - Optional settings for tailwind-merge behavior
+ * @returns A style function that accepts props and returns merged class names
  *
  * @example
  * ```ts
- * // Disable tailwind-merge
- * const ntvNoMerge = createNTV({ twMerge: false });
+ * type ButtonProps = { variant: 'primary' | 'secondary'; isDisabled: boolean };
  *
- * // With custom tailwind-merge config
- * const customNTV = createNTV({
- *   twMergeConfig: {
- *     extend: {
- *       theme: {
- *         shadow: ['100', '200', '300'],
- *       },
- *     },
+ * const button = ntv<ButtonProps>({
+ *   $base: 'px-4 py-2 rounded',
+ *   variant: {
+ *     primary: 'bg-blue-500 text-white',
+ *     secondary: 'bg-gray-200 text-gray-800',
  *   },
+ *   isDisabled: 'opacity-50 cursor-not-allowed',
  * });
+ *
+ * button({ variant: 'primary' }); // 'px-4 py-2 rounded bg-blue-500 text-white'
+ * button({ variant: 'primary', isDisabled: true }); // 'px-4 py-2 rounded bg-blue-500 text-white opacity-50 cursor-not-allowed'
  * ```
  */
-export declare function createNTV(options?: NTVConfig): <Props extends Record<string, any>>(style: StyleDefinition<Props>) => StyleFunction<Props>;
+export declare function ntv<TProps extends NtvProps>(scheme: SchemeFor<TProps>, options?: NtvOptions): StyleFunction<TProps>;
+export declare function ntv(scheme: NtvScheme, options?: NtvOptions): StyleFunction<any>;
 /**
- * Creates a style function from a nested style definition.
+ * Create a pre-configured ntv function with fixed options.
+ *
+ * @param defaultOptions - Default options to apply to all ntv calls
+ * @returns A pre-configured ntv function
  *
  * @example
  * ```ts
- * const button = ntv<{ variant?: 'primary' | 'secondary'; isDisabled?: boolean }>({
- *   default: 'px-4 py-2 rounded',
- *   variant: {
- *     primary: 'bg-blue-500 text-white',
- *     secondary: 'bg-gray-200 text-gray-800',
+ * const myNtv = createNtv({
+ *   twMergeConfig: {
+ *     extend: {
+ *       classGroups: {
+ *         'font-size': [{ text: ['huge', 'tiny'] }],
+ *       },
+ *     },
  *   },
- *   isDisabled: 'opacity-50 cursor-not-allowed',
  * });
  *
- * button({ variant: 'primary' });
- * // => 'px-4 py-2 rounded bg-blue-500 text-white'
- *
- * button({ variant: 'primary', isDisabled: true });
- * // => 'px-4 py-2 rounded bg-blue-500 text-white opacity-50 cursor-not-allowed'
+ * const button = myNtv({
+ *   $base: 'text-huge',
+ *   variant: {
+ *     primary: 'bg-blue-500',
+ *     secondary: 'bg-gray-200',
+ *   },
+ * });
  * ```
  */
-export declare const ntv: <Props extends Record<string, any>>(style: StyleDefinition<Props>) => StyleFunction<Props>;
-export {};
+export declare function createNtv(defaultOptions: NtvOptions): {
+    <TProps extends NtvProps>(scheme: SchemeFor<TProps>): StyleFunction<TProps>;
+    (scheme: NtvScheme): 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,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3D,KAAK,mBAAmB,GAAG,KAAK,UAAU,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;AAErF,KAAK,kBAAkB,CAAC,KAAK,IAAI;KAC9B,CAAC,IAAI,MAAM,KAAK,GAAG,CAAC,SAAS,mBAAmB,GAAG,CAAC,GAAG,KAAK;CAC9D,CAAC,MAAM,KAAK,CAAC,CAAC;AAEf,KAAK,kBAAkB,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AAEjF,KAAK,gBAAgB,CAAC,KAAK,IAAI,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAE/D,KAAK,eAAe,CAAC,KAAK,IAAI;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG;KACD,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC;CAC3D,GAAG;KACD,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SAChC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC;KAC3D;CACF,CAAC;AAgFF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,SAAc,IAS3B,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnD,OAAO,eAAe,CAAC,KAAK,CAAC,KAC5B,aAAa,CAAC,KAAK,CAAC,CAaxB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,GAAG,GAtCM,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,SAC5C,eAAe,CAAC,KAAK,CAAC,KAC5B,aAAa,CAAC,KAAK,CAoCM,CAAC"}
+{"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;AAoCpB;;;;;;;;;;;;;;;;;;;;;;;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"}

package/dist/ntv.js

@@ -1,123 +1,72 @@
-import { extendTailwindMerge, twMerge } from 'tailwind-merge';
-import { joinClasses } from './utils.js';
-function isStyleDefinition(value) {
+import { twJoin, twMerge } from 'tailwind-merge';
+import { getCachedTwMerge } from './cache.js';
+import { resolveConditions } from './resolver.js';
+function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
-function evaluateDefinition(definition, context) {
-    if (typeof definition === 'string') {
-        context.classes.push(definition);
-        return;
+function validateScheme(scheme) {
+    if ('class' in scheme) {
+        throw new Error('The "class" property is not allowed in ntv scheme. Use "$base" instead.');
     }
-    if (!isStyleDefinition(definition)) {
-        return;
+    if ('className' in scheme) {
+        throw new Error('The "className" property is not allowed in ntv scheme. Use "$base" instead.');
     }
-    const entries = Object.entries(definition);
-    let defaultValue = undefined;
-    const conditions = [];
-    for (const [key, value] of entries) {
-        if (key === 'default') {
-            defaultValue = value;
-        }
-        else {
-            conditions.push([key, value]);
-        }
-    }
-    const allConditionKeys = conditions.map(([key]) => key);
-    const subSkipConditions = new Set([...context.skipConditions, ...allConditionKeys]);
-    if (defaultValue !== undefined) {
-        evaluateDefinition(defaultValue, {
-            ...context,
-            skipConditions: subSkipConditions,
-        });
-    }
-    for (const [key, value] of conditions) {
-        if (context.skipConditions.has(key)) {
-            continue;
-        }
-        subSkipConditions.delete(key);
-        const propValue = context.props[key];
-        if (/^(is|allows)[A-Z]/.test(key) && propValue) {
-            const nestedSkipConditions = new Set([...subSkipConditions, key]);
-            evaluateDefinition(value, {
-                props: context.props,
-                skipConditions: nestedSkipConditions,
-                classes: context.classes,
-            });
+    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.`);
         }
-        else if (key !== 'default' && propValue !== undefined) {
-            if (isStyleDefinition(value)) {
-                const variantValue = value[propValue];
-                if (variantValue !== undefined) {
-                    const nestedSkipConditions = new Set([...subSkipConditions, key]);
-                    evaluateDefinition(variantValue, {
-                        props: context.props,
-                        skipConditions: nestedSkipConditions,
-                        classes: context.classes,
-                    });
-                }
-            }
+        // 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);
+    };
+}
 /**
- * Creates a customized `ntv` function with the specified options.
+ * Create a pre-configured ntv function with fixed options.
+ *
+ * @param defaultOptions - Default options to apply to all ntv calls
+ * @returns A pre-configured ntv function
  *
  * @example
  * ```ts
- * // Disable tailwind-merge
- * const ntvNoMerge = createNTV({ twMerge: false });
- *
- * // With custom tailwind-merge config
- * const customNTV = createNTV({
+ * const myNtv = createNtv({
  *   twMergeConfig: {
  *     extend: {
- *       theme: {
- *         shadow: ['100', '200', '300'],
+ *       classGroups: {
+ *         'font-size': [{ text: ['huge', 'tiny'] }],
  *       },
  *     },
  *   },
  * });
- * ```
- */
-export function createNTV(options = {}) {
-    const { twMerge: useTwMerge = true, twMergeConfig } = options;
-    const mergeClasses = useTwMerge
-        ? twMergeConfig
-            ? extendTailwindMerge(twMergeConfig)
-            : twMerge
-        : joinClasses;
-    return function ntv(style) {
-        return (props) => {
-            const context = {
-                props,
-                skipConditions: new Set(),
-                classes: [],
-            };
-            evaluateDefinition(style, context);
-            return mergeClasses(...context.classes);
-        };
-    };
-}
-/**
- * Creates a style function from a nested style definition.
  *
- * @example
- * ```ts
- * const button = ntv<{ variant?: 'primary' | 'secondary'; isDisabled?: boolean }>({
- *   default: 'px-4 py-2 rounded',
+ * const button = myNtv({
+ *   $base: 'text-huge',
  *   variant: {
- *     primary: 'bg-blue-500 text-white',
- *     secondary: 'bg-gray-200 text-gray-800',
+ *     primary: 'bg-blue-500',
+ *     secondary: 'bg-gray-200',
  *   },
- *   isDisabled: 'opacity-50 cursor-not-allowed',
  * });
- *
- * button({ variant: 'primary' });
- * // => 'px-4 py-2 rounded bg-blue-500 text-white'
- *
- * button({ variant: 'primary', isDisabled: true });
- * // => 'px-4 py-2 rounded bg-blue-500 text-white opacity-50 cursor-not-allowed'
  * ```
  */
-export const ntv = createNTV();
+export function createNtv(defaultOptions) {
+    return function configuredNtv(scheme) {
+        return ntv(scheme, defaultOptions);
+    };
+}
 //# sourceMappingURL=ntv.js.map

package/dist/ntv.js.map

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

package/dist/resolver.d.ts

@@ -0,0 +1,11 @@
+import type { ClassValue } from './types.js';
+/**
+ * Resolves conditions from scheme based on provided props to generate class values.
+ *
+ * $default behavior:
+ * - If no conditions match at a level, that level's $default is applied
+ * - 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[];
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"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,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"}

package/dist/resolver.js

@@ -0,0 +1,52 @@
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Resolves conditions from scheme based on provided props to generate class values.
+ *
+ * $default behavior:
+ * - If no conditions match at a level, that level's $default is applied
+ * - 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) {
+    const classes = [];
+    let hasMatchedCondition = false;
+    function addClasses(value) {
+        if (isObject(value)) {
+            classes.push(...resolveConditions(value, props));
+        }
+        else {
+            classes.push(value);
+        }
+    }
+    for (const [key, value] of Object.entries(conditions)) {
+        const propValue = props[key];
+        if (propValue === '$default') {
+            throw new Error(`The value "$default" cannot be passed as a runtime value for "${key}". "$default" is a reserved keyword.`);
+        }
+        // Boolean conditions (isXxx or allowsXxx)
+        if (/^is[A-Z]/.test(key) || /^allows[A-Z]/.test(key)) {
+            if (propValue) {
+                hasMatchedCondition = true;
+                addClasses(value);
+            }
+            continue;
+        }
+        // Variant conditions (nested objects)
+        if (isObject(value)) {
+            if (typeof propValue === 'string' && propValue in value) {
+                hasMatchedCondition = true;
+                addClasses(value[propValue]);
+            }
+            else {
+                classes.push(value['$default']);
+            }
+        }
+    }
+    if (!hasMatchedCondition) {
+        classes.unshift($default);
+    }
+    return classes;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,KAAc;IAC9B,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,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,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,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,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,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"}