@yaredfall/class-variants 0.0.6 → 0.0.8

package/build/{chunk-BNE2ZOTW.js → chunk-5UWIPH6K.js}

@@ -1,7 +1,7 @@
 import {
   getEntries,
   getKeys
-} from "./chunk-3RDDXOQ3.js";
+} from "./chunk-AQSN2Y5C.js";
 
 // src/index.ts
 import { clsx } from "clsx";
@@ -36,4 +36,4 @@ var cv = (config, options = {}) => {
 export {
   cv
 };
-//# sourceMappingURL=chunk-BNE2ZOTW.js.map
+//# sourceMappingURL=chunk-5UWIPH6K.js.map

package/build/chunk-5UWIPH6K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { ClassValue, clsx } from \"clsx\";\r\nimport { MarkRequired, Prettify } from \"ts-essentials\";\r\nimport { getEntries, getKeys } from \"./utils\";\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport type VariantProps<CVR extends (args?: any) => string> = Prettify<Omit<NonNullable<Exclude<Parameters<CVR>[0], void>>, \"class\">>;\r\n\r\nexport type CVVariantsSchema = Record<string, Record<string, ClassValue>>;\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport type WithClassProp<T extends Record<string, any>> = T & {\r\n    class?: ClassValue;\r\n};\r\n\r\nexport type CVCompoundVariantsSchema<V extends CVVariantsSchema> = WithClassProp<{\r\n    [K in keyof V]?: (keyof V[K] & string) | (keyof V[K])[] | boolean\r\n}>[];\r\n\r\nexport interface CVConfig<V extends CVVariantsSchema, R extends keyof V> {\r\n    baseClass?: ClassValue;\r\n    variants?: V;\r\n    compoundVariants?: CVCompoundVariantsSchema<NoInfer<V>> | ((variants: NoInfer<V>) => CVCompoundVariantsSchema<NoInfer<V>>);\r\n    defaultVariant?: Partial<{ [K in keyof V]?: keyof V[K] }>;\r\n    requiredProps?: R[];\r\n}\r\n\r\nexport type CVVariantProps<V extends CVVariantsSchema, R extends (keyof V)> =\r\nWithClassProp<MarkRequired<{ [K in keyof V]?: keyof V[K] }, R>>;\r\n\r\nexport type CVReturn<V extends CVVariantsSchema, R extends keyof V = never> = (props: Prettify<CVVariantProps<V, R>> | ([R] extends [never] ? void : never)) => string;\r\n\r\nexport interface CVOptions {\r\n    merge?: (...args: ClassValue[]) => string;\r\n}\r\n\r\nexport interface CV {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVReturn<V, R>;\r\n}\r\n\r\nexport const cv: CV = (config, options = {}) => {\r\n    const { variants, defaultVariant, baseClass } = config;\r\n\r\n    const merge = options.merge ?? clsx;\r\n\r\n    if (variants == null) return props => merge(baseClass, props?.class);\r\n\r\n    const compoundVariants = typeof config.compoundVariants === \"function\" ? config.compoundVariants(variants) : config.compoundVariants;\r\n\r\n    return (props) => {\r\n        const variantClassNames = getKeys(variants).map((variant) => {\r\n            const variantProp = props?.[variant];\r\n            const defaultVariantProp = defaultVariant?.[variant];\r\n\r\n            const variantKey = (variantProp || defaultVariantProp) as keyof (typeof variants)[typeof variant];\r\n\r\n            return variants[variant][variantKey];\r\n        });\r\n\r\n        const compoundVariantClassNames = compoundVariants?.reduce((acc, { class: cvClass, ...cvConfig }) => {\r\n            const shouldApplyCompoundVariant = getEntries(cvConfig).every(([cvKey, cvSelector]) => {\r\n                const defaultsSelector = defaultVariant?.[cvKey as keyof typeof defaultVariant];\r\n                const propsSelector = props?.[cvKey as keyof typeof props];\r\n\r\n                if (cvSelector === true) return propsSelector !== undefined; // only when prop is defined\r\n                else if (cvSelector === false) return propsSelector === undefined; // only when prop is not defined\r\n\r\n                const selector = propsSelector ?? defaultsSelector;\r\n\r\n                return Array.isArray(cvSelector) ? cvSelector.includes(selector as string) : selector === cvSelector;\r\n            });\r\n\r\n            if (shouldApplyCompoundVariant) acc.push(cvClass);\r\n            return acc;\r\n        }, new Array<ClassValue>());\r\n\r\n        return merge(config?.baseClass, variantClassNames, compoundVariantClassNames, props?.class);\r\n    };\r\n};\r\n"],"mappings":";;;;;;AAAA,SAAqB,YAAY;AAwC1B,IAAM,KAAS,CAAC,QAAQ,UAAU,CAAC,MAAM;AAC5C,QAAM,EAAE,UAAU,gBAAgB,UAAU,IAAI;AAEhD,QAAM,QAAQ,QAAQ,SAAS;AAE/B,MAAI,YAAY,KAAM,QAAO,WAAS,MAAM,WAAW,OAAO,KAAK;AAEnE,QAAM,mBAAmB,OAAO,OAAO,qBAAqB,aAAa,OAAO,iBAAiB,QAAQ,IAAI,OAAO;AAEpH,SAAO,CAAC,UAAU;AACd,UAAM,oBAAoB,QAAQ,QAAQ,EAAE,IAAI,CAAC,YAAY;AACzD,YAAM,cAAc,QAAQ,OAAO;AACnC,YAAM,qBAAqB,iBAAiB,OAAO;AAEnD,YAAM,aAAc,eAAe;AAEnC,aAAO,SAAS,OAAO,EAAE,UAAU;AAAA,IACvC,CAAC;AAED,UAAM,4BAA4B,kBAAkB,OAAO,CAAC,KAAK,EAAE,OAAO,SAAS,GAAG,SAAS,MAAM;AACjG,YAAM,6BAA6B,WAAW,QAAQ,EAAE,MAAM,CAAC,CAAC,OAAO,UAAU,MAAM;AACnF,cAAM,mBAAmB,iBAAiB,KAAoC;AAC9E,cAAM,gBAAgB,QAAQ,KAA2B;AAEzD,YAAI,eAAe,KAAM,QAAO,kBAAkB;AAAA,iBACzC,eAAe,MAAO,QAAO,kBAAkB;AAExD,cAAM,WAAW,iBAAiB;AAElC,eAAO,MAAM,QAAQ,UAAU,IAAI,WAAW,SAAS,QAAkB,IAAI,aAAa;AAAA,MAC9F,CAAC;AAED,UAAI,2BAA4B,KAAI,KAAK,OAAO;AAChD,aAAO;AAAA,IACX,GAAG,IAAI,MAAkB,CAAC;AAE1B,WAAO,MAAM,QAAQ,WAAW,mBAAmB,2BAA2B,OAAO,KAAK;AAAA,EAC9F;AACJ;","names":[]}

package/build/{chunk-3RDDXOQ3.js → chunk-AQSN2Y5C.js}

@@ -8,10 +8,14 @@ function getEntries(obj) {
 function getVariantsOptions(variants) {
   return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)]));
 }
+function objectFromEntries(entries) {
+  return Object.fromEntries(entries);
+}
 
 export {
   getKeys,
   getEntries,
-  getVariantsOptions
+  getVariantsOptions,
+  objectFromEntries
 };
-//# sourceMappingURL=chunk-3RDDXOQ3.js.map
+//# sourceMappingURL=chunk-AQSN2Y5C.js.map

package/build/chunk-AQSN2Y5C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["import { DeepReadonly, DeepWritable, Prettify, UnionToIntersection } from \"ts-essentials\";\r\nimport { CVVariantsSchema } from \".\";\r\n\r\nexport function getKeys<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.keys(obj) as (keyof O)[];\r\n}\r\n\r\ntype EntriesOf<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };\r\nexport function getEntries<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.entries(obj) as (EntriesOf<O>[keyof EntriesOf<O>])[];\r\n}\r\n\r\nexport function getVariantsOptions<V extends CVVariantsSchema>(variants: V) {\r\n    return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)])) as { [K in keyof V]: (keyof V[K])[] };\r\n}\r\n\r\ntype Entries = [PropertyKey, unknown][] | DeepReadonly<[PropertyKey, unknown][]>;\r\ntype UnionFromPairs<TArr extends Entries> =\r\n    DeepWritable<TArr> extends (infer R)[] ? R extends [infer key, infer val] ? { [prop in key & PropertyKey]: val } : never : never;\r\n\r\ntype MergeIntersectingObjects<O> = { [K in keyof O]: O[K] };\r\n\r\nexport function objectFromEntries<E extends Entries>(entries: E) {\r\n    return Object.fromEntries(entries) as Prettify<MergeIntersectingObjects<UnionToIntersection<UnionFromPairs<E>>>>;\r\n}\r\n"],"mappings":";AAGO,SAAS,QAA2C,KAAQ;AAC/D,SAAO,OAAO,KAAK,GAAG;AAC1B;AAGO,SAAS,WAA8C,KAAQ;AAClE,SAAO,OAAO,QAAQ,GAAG;AAC7B;AAEO,SAAS,mBAA+C,UAAa;AACxE,SAAO,OAAO,YAAY,WAAW,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC;AACnG;AAQO,SAAS,kBAAqC,SAAY;AAC7D,SAAO,OAAO,YAAY,OAAO;AACrC;","names":[]}

package/build/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/utils.ts"],"sourcesContent":["import { ClassValue, clsx } from \"clsx\";\r\nimport { Prettify } from \"ts-essentials\";\r\nimport { getEntries, getKeys } from \"./utils\";\r\n\r\nexport type VariantProps<Component extends CVReturn<CVVariantsSchema>> = Prettify<Omit<NonNullable<Parameters<Component>[0]>, \"class\">> | undefined;\r\n\r\nexport type CVVariantsSchema = Record<string, Record<string, ClassValue>>;\r\n\r\nexport type WithClassProp<T extends Record<string, unknown>> = T & {\r\n    class?: ClassValue;\r\n};\r\n\r\nexport type CVCompoundVariantsSchema<V extends CVVariantsSchema> = WithClassProp<{\r\n    [K in keyof V]?: (keyof V[K] & string) | (keyof V[K])[] | boolean\r\n}>[];\r\n\r\nexport interface CVConfig<V extends CVVariantsSchema> {\r\n    baseClass?: ClassValue;\r\n    variants?: V;\r\n    compoundVariants?: CVCompoundVariantsSchema<NoInfer<V>> | ((variants: NoInfer<V>) => CVCompoundVariantsSchema<NoInfer<V>>);\r\n    defaultVariant?: Partial<{ [K in keyof V]?: keyof V[K] }>;\r\n}\r\n\r\nexport type CVVariantProps<V extends CVVariantsSchema> = WithClassProp<{ [K in keyof V]?: keyof V[K] }>;\r\n\r\nexport type CVReturn<V extends CVVariantsSchema> = (props?: CVVariantProps<V>) => string;\r\n\r\nexport interface CVOptions {\r\n    merge?: (...args: ClassValue[]) => string;\r\n}\r\n\r\nexport interface CV {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVReturn<V>;\r\n}\r\n\r\nexport const cv: CV = (config, options = {}) => {\r\n    const { variants, defaultVariant, baseClass } = config;\r\n\r\n    const merge = options.merge ?? clsx;\r\n\r\n    if (variants == null) return props => merge(baseClass, props?.class);\r\n\r\n    const compoundVariants = typeof config.compoundVariants === \"function\" ? config.compoundVariants(variants) : config.compoundVariants;\r\n\r\n    return (props) => {\r\n        const variantClassNames = getKeys(variants).map((variant) => {\r\n            const variantProp = props?.[variant];\r\n            const defaultVariantProp = defaultVariant?.[variant];\r\n\r\n            const variantKey = (variantProp || defaultVariantProp) as keyof (typeof variants)[typeof variant];\r\n\r\n            return variants[variant][variantKey];\r\n        });\r\n\r\n        const compoundVariantClassNames = compoundVariants?.reduce((acc, { class: cvClass, ...cvConfig }) => {\r\n            const shouldApplyCompoundVariant = getEntries(cvConfig).every(([cvKey, cvSelector]) => {\r\n                const defaultsSelector = defaultVariant?.[cvKey as keyof typeof defaultVariant];\r\n                const propsSelector = props?.[cvKey as keyof typeof props];\r\n\r\n                if (cvSelector === true) return propsSelector !== undefined; // only when prop is defined\r\n                else if (cvSelector === false) return propsSelector === undefined; // only when prop is not defined\r\n\r\n                const selector = propsSelector ?? defaultsSelector;\r\n\r\n                return Array.isArray(cvSelector) ? cvSelector.includes(selector as string) : selector === cvSelector;\r\n            });\r\n\r\n            if (shouldApplyCompoundVariant) acc.push(cvClass);\r\n            return acc;\r\n        }, new Array<ClassValue>());\r\n\r\n        return merge(config?.baseClass, variantClassNames, compoundVariantClassNames, props?.class);\r\n    };\r\n};\r\n","import { CVVariantsSchema } from \".\";\r\n\r\nexport function getKeys<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.keys(obj) as (keyof O)[];\r\n}\r\n\r\ntype Entries<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };\r\nexport function getEntries<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.entries(obj) as (Entries<O>[keyof Entries<O>])[];\r\n}\r\n\r\nexport function getVariantsOptions<V extends CVVariantsSchema>(variants: V) {\r\n    return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)])) as { [K in keyof V]: (keyof V[K])[] };\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiC;;;ACE1B,SAAS,QAA2C,KAAQ;AAC/D,SAAO,OAAO,KAAK,GAAG;AAC1B;AAGO,SAAS,WAA8C,KAAQ;AAClE,SAAO,OAAO,QAAQ,GAAG;AAC7B;;;AD2BO,IAAM,KAAS,CAAC,QAAQ,UAAU,CAAC,MAAM;AAC5C,QAAM,EAAE,UAAU,gBAAgB,UAAU,IAAI;AAEhD,QAAM,QAAQ,QAAQ,SAAS;AAE/B,MAAI,YAAY,KAAM,QAAO,WAAS,MAAM,WAAW,OAAO,KAAK;AAEnE,QAAM,mBAAmB,OAAO,OAAO,qBAAqB,aAAa,OAAO,iBAAiB,QAAQ,IAAI,OAAO;AAEpH,SAAO,CAAC,UAAU;AACd,UAAM,oBAAoB,QAAQ,QAAQ,EAAE,IAAI,CAAC,YAAY;AACzD,YAAM,cAAc,QAAQ,OAAO;AACnC,YAAM,qBAAqB,iBAAiB,OAAO;AAEnD,YAAM,aAAc,eAAe;AAEnC,aAAO,SAAS,OAAO,EAAE,UAAU;AAAA,IACvC,CAAC;AAED,UAAM,4BAA4B,kBAAkB,OAAO,CAAC,KAAK,EAAE,OAAO,SAAS,GAAG,SAAS,MAAM;AACjG,YAAM,6BAA6B,WAAW,QAAQ,EAAE,MAAM,CAAC,CAAC,OAAO,UAAU,MAAM;AACnF,cAAM,mBAAmB,iBAAiB,KAAoC;AAC9E,cAAM,gBAAgB,QAAQ,KAA2B;AAEzD,YAAI,eAAe,KAAM,QAAO,kBAAkB;AAAA,iBACzC,eAAe,MAAO,QAAO,kBAAkB;AAExD,cAAM,WAAW,iBAAiB;AAElC,eAAO,MAAM,QAAQ,UAAU,IAAI,WAAW,SAAS,QAAkB,IAAI,aAAa;AAAA,MAC9F,CAAC;AAED,UAAI,2BAA4B,KAAI,KAAK,OAAO;AAChD,aAAO;AAAA,IACX,GAAG,IAAI,MAAkB,CAAC;AAE1B,WAAO,MAAM,QAAQ,WAAW,mBAAmB,2BAA2B,OAAO,KAAK;AAAA,EAC9F;AACJ;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/utils.ts"],"sourcesContent":["import { ClassValue, clsx } from \"clsx\";\r\nimport { MarkRequired, Prettify } from \"ts-essentials\";\r\nimport { getEntries, getKeys } from \"./utils\";\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport type VariantProps<CVR extends (args?: any) => string> = Prettify<Omit<NonNullable<Exclude<Parameters<CVR>[0], void>>, \"class\">>;\r\n\r\nexport type CVVariantsSchema = Record<string, Record<string, ClassValue>>;\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport type WithClassProp<T extends Record<string, any>> = T & {\r\n    class?: ClassValue;\r\n};\r\n\r\nexport type CVCompoundVariantsSchema<V extends CVVariantsSchema> = WithClassProp<{\r\n    [K in keyof V]?: (keyof V[K] & string) | (keyof V[K])[] | boolean\r\n}>[];\r\n\r\nexport interface CVConfig<V extends CVVariantsSchema, R extends keyof V> {\r\n    baseClass?: ClassValue;\r\n    variants?: V;\r\n    compoundVariants?: CVCompoundVariantsSchema<NoInfer<V>> | ((variants: NoInfer<V>) => CVCompoundVariantsSchema<NoInfer<V>>);\r\n    defaultVariant?: Partial<{ [K in keyof V]?: keyof V[K] }>;\r\n    requiredProps?: R[];\r\n}\r\n\r\nexport type CVVariantProps<V extends CVVariantsSchema, R extends (keyof V)> =\r\nWithClassProp<MarkRequired<{ [K in keyof V]?: keyof V[K] }, R>>;\r\n\r\nexport type CVReturn<V extends CVVariantsSchema, R extends keyof V = never> = (props: Prettify<CVVariantProps<V, R>> | ([R] extends [never] ? void : never)) => string;\r\n\r\nexport interface CVOptions {\r\n    merge?: (...args: ClassValue[]) => string;\r\n}\r\n\r\nexport interface CV {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVReturn<V, R>;\r\n}\r\n\r\nexport const cv: CV = (config, options = {}) => {\r\n    const { variants, defaultVariant, baseClass } = config;\r\n\r\n    const merge = options.merge ?? clsx;\r\n\r\n    if (variants == null) return props => merge(baseClass, props?.class);\r\n\r\n    const compoundVariants = typeof config.compoundVariants === \"function\" ? config.compoundVariants(variants) : config.compoundVariants;\r\n\r\n    return (props) => {\r\n        const variantClassNames = getKeys(variants).map((variant) => {\r\n            const variantProp = props?.[variant];\r\n            const defaultVariantProp = defaultVariant?.[variant];\r\n\r\n            const variantKey = (variantProp || defaultVariantProp) as keyof (typeof variants)[typeof variant];\r\n\r\n            return variants[variant][variantKey];\r\n        });\r\n\r\n        const compoundVariantClassNames = compoundVariants?.reduce((acc, { class: cvClass, ...cvConfig }) => {\r\n            const shouldApplyCompoundVariant = getEntries(cvConfig).every(([cvKey, cvSelector]) => {\r\n                const defaultsSelector = defaultVariant?.[cvKey as keyof typeof defaultVariant];\r\n                const propsSelector = props?.[cvKey as keyof typeof props];\r\n\r\n                if (cvSelector === true) return propsSelector !== undefined; // only when prop is defined\r\n                else if (cvSelector === false) return propsSelector === undefined; // only when prop is not defined\r\n\r\n                const selector = propsSelector ?? defaultsSelector;\r\n\r\n                return Array.isArray(cvSelector) ? cvSelector.includes(selector as string) : selector === cvSelector;\r\n            });\r\n\r\n            if (shouldApplyCompoundVariant) acc.push(cvClass);\r\n            return acc;\r\n        }, new Array<ClassValue>());\r\n\r\n        return merge(config?.baseClass, variantClassNames, compoundVariantClassNames, props?.class);\r\n    };\r\n};\r\n","import { DeepReadonly, DeepWritable, Prettify, UnionToIntersection } from \"ts-essentials\";\r\nimport { CVVariantsSchema } from \".\";\r\n\r\nexport function getKeys<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.keys(obj) as (keyof O)[];\r\n}\r\n\r\ntype EntriesOf<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };\r\nexport function getEntries<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.entries(obj) as (EntriesOf<O>[keyof EntriesOf<O>])[];\r\n}\r\n\r\nexport function getVariantsOptions<V extends CVVariantsSchema>(variants: V) {\r\n    return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)])) as { [K in keyof V]: (keyof V[K])[] };\r\n}\r\n\r\ntype Entries = [PropertyKey, unknown][] | DeepReadonly<[PropertyKey, unknown][]>;\r\ntype UnionFromPairs<TArr extends Entries> =\r\n    DeepWritable<TArr> extends (infer R)[] ? R extends [infer key, infer val] ? { [prop in key & PropertyKey]: val } : never : never;\r\n\r\ntype MergeIntersectingObjects<O> = { [K in keyof O]: O[K] };\r\n\r\nexport function objectFromEntries<E extends Entries>(entries: E) {\r\n    return Object.fromEntries(entries) as Prettify<MergeIntersectingObjects<UnionToIntersection<UnionFromPairs<E>>>>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiC;;;ACG1B,SAAS,QAA2C,KAAQ;AAC/D,SAAO,OAAO,KAAK,GAAG;AAC1B;AAGO,SAAS,WAA8C,KAAQ;AAClE,SAAO,OAAO,QAAQ,GAAG;AAC7B;;;AD8BO,IAAM,KAAS,CAAC,QAAQ,UAAU,CAAC,MAAM;AAC5C,QAAM,EAAE,UAAU,gBAAgB,UAAU,IAAI;AAEhD,QAAM,QAAQ,QAAQ,SAAS;AAE/B,MAAI,YAAY,KAAM,QAAO,WAAS,MAAM,WAAW,OAAO,KAAK;AAEnE,QAAM,mBAAmB,OAAO,OAAO,qBAAqB,aAAa,OAAO,iBAAiB,QAAQ,IAAI,OAAO;AAEpH,SAAO,CAAC,UAAU;AACd,UAAM,oBAAoB,QAAQ,QAAQ,EAAE,IAAI,CAAC,YAAY;AACzD,YAAM,cAAc,QAAQ,OAAO;AACnC,YAAM,qBAAqB,iBAAiB,OAAO;AAEnD,YAAM,aAAc,eAAe;AAEnC,aAAO,SAAS,OAAO,EAAE,UAAU;AAAA,IACvC,CAAC;AAED,UAAM,4BAA4B,kBAAkB,OAAO,CAAC,KAAK,EAAE,OAAO,SAAS,GAAG,SAAS,MAAM;AACjG,YAAM,6BAA6B,WAAW,QAAQ,EAAE,MAAM,CAAC,CAAC,OAAO,UAAU,MAAM;AACnF,cAAM,mBAAmB,iBAAiB,KAAoC;AAC9E,cAAM,gBAAgB,QAAQ,KAA2B;AAEzD,YAAI,eAAe,KAAM,QAAO,kBAAkB;AAAA,iBACzC,eAAe,MAAO,QAAO,kBAAkB;AAExD,cAAM,WAAW,iBAAiB;AAElC,eAAO,MAAM,QAAQ,UAAU,IAAI,WAAW,SAAS,QAAkB,IAAI,aAAa;AAAA,MAC9F,CAAC;AAED,UAAI,2BAA4B,KAAI,KAAK,OAAO;AAChD,aAAO;AAAA,IACX,GAAG,IAAI,MAAkB,CAAC;AAE1B,WAAO,MAAM,QAAQ,WAAW,mBAAmB,2BAA2B,OAAO,KAAK;AAAA,EAC9F;AACJ;","names":[]}

package/build/index.d.cts

@@ -1,31 +1,32 @@
 import { ClassValue } from 'clsx';
-import { Prettify } from 'ts-essentials';
+import { Prettify, MarkRequired } from 'ts-essentials';
 
-type VariantProps<Component extends CVReturn<CVVariantsSchema>> = Prettify<Omit<NonNullable<Parameters<Component>[0]>, "class">> | undefined;
+type VariantProps<CVR extends (args?: any) => string> = Prettify<Omit<NonNullable<Exclude<Parameters<CVR>[0], void>>, "class">>;
 type CVVariantsSchema = Record<string, Record<string, ClassValue>>;
-type WithClassProp<T extends Record<string, unknown>> = T & {
+type WithClassProp<T extends Record<string, any>> = T & {
     class?: ClassValue;
 };
 type CVCompoundVariantsSchema<V extends CVVariantsSchema> = WithClassProp<{
     [K in keyof V]?: (keyof V[K] & string) | (keyof V[K])[] | boolean;
 }>[];
-interface CVConfig<V extends CVVariantsSchema> {
+interface CVConfig<V extends CVVariantsSchema, R extends keyof V> {
     baseClass?: ClassValue;
     variants?: V;
     compoundVariants?: CVCompoundVariantsSchema<NoInfer<V>> | ((variants: NoInfer<V>) => CVCompoundVariantsSchema<NoInfer<V>>);
     defaultVariant?: Partial<{
         [K in keyof V]?: keyof V[K];
     }>;
+    requiredProps?: R[];
 }
-type CVVariantProps<V extends CVVariantsSchema> = WithClassProp<{
+type CVVariantProps<V extends CVVariantsSchema, R extends (keyof V)> = WithClassProp<MarkRequired<{
     [K in keyof V]?: keyof V[K];
-}>;
-type CVReturn<V extends CVVariantsSchema> = (props?: CVVariantProps<V>) => string;
+}, R>>;
+type CVReturn<V extends CVVariantsSchema, R extends keyof V = never> = (props: Prettify<CVVariantProps<V, R>> | ([R] extends [never] ? void : never)) => string;
 interface CVOptions {
     merge?: (...args: ClassValue[]) => string;
 }
 interface CV {
-    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVReturn<V>;
+    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVReturn<V, R>;
 }
 declare const cv: CV;
 

package/build/index.d.ts

@@ -1,31 +1,32 @@
 import { ClassValue } from 'clsx';
-import { Prettify } from 'ts-essentials';
+import { Prettify, MarkRequired } from 'ts-essentials';
 
-type VariantProps<Component extends CVReturn<CVVariantsSchema>> = Prettify<Omit<NonNullable<Parameters<Component>[0]>, "class">> | undefined;
+type VariantProps<CVR extends (args?: any) => string> = Prettify<Omit<NonNullable<Exclude<Parameters<CVR>[0], void>>, "class">>;
 type CVVariantsSchema = Record<string, Record<string, ClassValue>>;
-type WithClassProp<T extends Record<string, unknown>> = T & {
+type WithClassProp<T extends Record<string, any>> = T & {
     class?: ClassValue;
 };
 type CVCompoundVariantsSchema<V extends CVVariantsSchema> = WithClassProp<{
     [K in keyof V]?: (keyof V[K] & string) | (keyof V[K])[] | boolean;
 }>[];
-interface CVConfig<V extends CVVariantsSchema> {
+interface CVConfig<V extends CVVariantsSchema, R extends keyof V> {
     baseClass?: ClassValue;
     variants?: V;
     compoundVariants?: CVCompoundVariantsSchema<NoInfer<V>> | ((variants: NoInfer<V>) => CVCompoundVariantsSchema<NoInfer<V>>);
     defaultVariant?: Partial<{
         [K in keyof V]?: keyof V[K];
     }>;
+    requiredProps?: R[];
 }
-type CVVariantProps<V extends CVVariantsSchema> = WithClassProp<{
+type CVVariantProps<V extends CVVariantsSchema, R extends (keyof V)> = WithClassProp<MarkRequired<{
     [K in keyof V]?: keyof V[K];
-}>;
-type CVReturn<V extends CVVariantsSchema> = (props?: CVVariantProps<V>) => string;
+}, R>>;
+type CVReturn<V extends CVVariantsSchema, R extends keyof V = never> = (props: Prettify<CVVariantProps<V, R>> | ([R] extends [never] ? void : never)) => string;
 interface CVOptions {
     merge?: (...args: ClassValue[]) => string;
 }
 interface CV {
-    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVReturn<V>;
+    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVReturn<V, R>;
 }
 declare const cv: CV;
 

package/build/index.js

@@ -1,8 +1,7 @@
 import {
   cv
-} from "./chunk-BNE2ZOTW.js";
-import "./chunk-3RDDXOQ3.js";
-import "./chunk-PLDDJCW6.js";
+} from "./chunk-5UWIPH6K.js";
+import "./chunk-AQSN2Y5C.js";
 export {
   cv
 };

package/build/utils.cjs

@@ -22,7 +22,8 @@ var utils_exports = {};
 __export(utils_exports, {
   getEntries: () => getEntries,
   getKeys: () => getKeys,
-  getVariantsOptions: () => getVariantsOptions
+  getVariantsOptions: () => getVariantsOptions,
+  objectFromEntries: () => objectFromEntries
 });
 module.exports = __toCommonJS(utils_exports);
 function getKeys(obj) {
@@ -34,10 +35,14 @@ function getEntries(obj) {
 function getVariantsOptions(variants) {
   return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)]));
 }
+function objectFromEntries(entries) {
+  return Object.fromEntries(entries);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getEntries,
   getKeys,
-  getVariantsOptions
+  getVariantsOptions,
+  objectFromEntries
 });
 //# sourceMappingURL=utils.cjs.map

package/build/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["import { CVVariantsSchema } from \".\";\r\n\r\nexport function getKeys<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.keys(obj) as (keyof O)[];\r\n}\r\n\r\ntype Entries<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };\r\nexport function getEntries<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.entries(obj) as (Entries<O>[keyof Entries<O>])[];\r\n}\r\n\r\nexport function getVariantsOptions<V extends CVVariantsSchema>(variants: V) {\r\n    return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)])) as { [K in keyof V]: (keyof V[K])[] };\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEO,SAAS,QAA2C,KAAQ;AAC/D,SAAO,OAAO,KAAK,GAAG;AAC1B;AAGO,SAAS,WAA8C,KAAQ;AAClE,SAAO,OAAO,QAAQ,GAAG;AAC7B;AAEO,SAAS,mBAA+C,UAAa;AACxE,SAAO,OAAO,YAAY,WAAW,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC;AACnG;","names":[]}
+{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["import { DeepReadonly, DeepWritable, Prettify, UnionToIntersection } from \"ts-essentials\";\r\nimport { CVVariantsSchema } from \".\";\r\n\r\nexport function getKeys<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.keys(obj) as (keyof O)[];\r\n}\r\n\r\ntype EntriesOf<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };\r\nexport function getEntries<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.entries(obj) as (EntriesOf<O>[keyof EntriesOf<O>])[];\r\n}\r\n\r\nexport function getVariantsOptions<V extends CVVariantsSchema>(variants: V) {\r\n    return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)])) as { [K in keyof V]: (keyof V[K])[] };\r\n}\r\n\r\ntype Entries = [PropertyKey, unknown][] | DeepReadonly<[PropertyKey, unknown][]>;\r\ntype UnionFromPairs<TArr extends Entries> =\r\n    DeepWritable<TArr> extends (infer R)[] ? R extends [infer key, infer val] ? { [prop in key & PropertyKey]: val } : never : never;\r\n\r\ntype MergeIntersectingObjects<O> = { [K in keyof O]: O[K] };\r\n\r\nexport function objectFromEntries<E extends Entries>(entries: E) {\r\n    return Object.fromEntries(entries) as Prettify<MergeIntersectingObjects<UnionToIntersection<UnionFromPairs<E>>>>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,SAAS,QAA2C,KAAQ;AAC/D,SAAO,OAAO,KAAK,GAAG;AAC1B;AAGO,SAAS,WAA8C,KAAQ;AAClE,SAAO,OAAO,QAAQ,GAAG;AAC7B;AAEO,SAAS,mBAA+C,UAAa;AACxE,SAAO,OAAO,YAAY,WAAW,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC;AACnG;AAQO,SAAS,kBAAqC,SAAY;AAC7D,SAAO,OAAO,YAAY,OAAO;AACrC;","names":[]}

package/build/utils.d.cts

@@ -1,12 +1,20 @@
+import { Prettify, UnionToIntersection, DeepReadonly, DeepWritable } from 'ts-essentials';
 import { CVVariantsSchema } from './index.cjs';
 import 'clsx';
-import 'ts-essentials';
 
 declare function getKeys<O extends Record<string, unknown>>(obj: O): (keyof O)[];
-type Entries<O extends Record<string, unknown>> = {
+type EntriesOf<O extends Record<string, unknown>> = {
     [K in keyof O]: [K, O[K]];
 };
-declare function getEntries<O extends Record<string, unknown>>(obj: O): (Entries<O>[keyof Entries<O>])[];
+declare function getEntries<O extends Record<string, unknown>>(obj: O): (EntriesOf<O>[keyof EntriesOf<O>])[];
 declare function getVariantsOptions<V extends CVVariantsSchema>(variants: V): { [K in keyof V]: (keyof V[K])[]; };
+type Entries = [PropertyKey, unknown][] | DeepReadonly<[PropertyKey, unknown][]>;
+type UnionFromPairs<TArr extends Entries> = DeepWritable<TArr> extends (infer R)[] ? R extends [infer key, infer val] ? {
+    [prop in key & PropertyKey]: val;
+} : never : never;
+type MergeIntersectingObjects<O> = {
+    [K in keyof O]: O[K];
+};
+declare function objectFromEntries<E extends Entries>(entries: E): Prettify<MergeIntersectingObjects<UnionToIntersection<UnionFromPairs<E>>>>;
 
-export { getEntries, getKeys, getVariantsOptions };
+export { getEntries, getKeys, getVariantsOptions, objectFromEntries };

package/build/utils.d.ts

@@ -1,12 +1,20 @@
+import { Prettify, UnionToIntersection, DeepReadonly, DeepWritable } from 'ts-essentials';
 import { CVVariantsSchema } from './index.js';
 import 'clsx';
-import 'ts-essentials';
 
 declare function getKeys<O extends Record<string, unknown>>(obj: O): (keyof O)[];
-type Entries<O extends Record<string, unknown>> = {
+type EntriesOf<O extends Record<string, unknown>> = {
     [K in keyof O]: [K, O[K]];
 };
-declare function getEntries<O extends Record<string, unknown>>(obj: O): (Entries<O>[keyof Entries<O>])[];
+declare function getEntries<O extends Record<string, unknown>>(obj: O): (EntriesOf<O>[keyof EntriesOf<O>])[];
 declare function getVariantsOptions<V extends CVVariantsSchema>(variants: V): { [K in keyof V]: (keyof V[K])[]; };
+type Entries = [PropertyKey, unknown][] | DeepReadonly<[PropertyKey, unknown][]>;
+type UnionFromPairs<TArr extends Entries> = DeepWritable<TArr> extends (infer R)[] ? R extends [infer key, infer val] ? {
+    [prop in key & PropertyKey]: val;
+} : never : never;
+type MergeIntersectingObjects<O> = {
+    [K in keyof O]: O[K];
+};
+declare function objectFromEntries<E extends Entries>(entries: E): Prettify<MergeIntersectingObjects<UnionToIntersection<UnionFromPairs<E>>>>;
 
-export { getEntries, getKeys, getVariantsOptions };
+export { getEntries, getKeys, getVariantsOptions, objectFromEntries };

package/build/utils.js

@@ -1,12 +1,13 @@
 import {
   getEntries,
   getKeys,
-  getVariantsOptions
-} from "./chunk-3RDDXOQ3.js";
-import "./chunk-PLDDJCW6.js";
+  getVariantsOptions,
+  objectFromEntries
+} from "./chunk-AQSN2Y5C.js";
 export {
   getEntries,
   getKeys,
-  getVariantsOptions
+  getVariantsOptions,
+  objectFromEntries
 };
 //# sourceMappingURL=utils.js.map

package/build/vue.cjs

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/vue.ts
 var vue_exports = {};
 __export(vue_exports, {
-  cvWithProps: () => cvWithProps
+  cvWithProps: () => cvWithProps,
+  getPropsDeclaration: () => getPropsDeclaration
 });
 module.exports = __toCommonJS(vue_exports);
 
@@ -34,6 +35,9 @@ function getKeys(obj) {
 function getEntries(obj) {
   return Object.entries(obj);
 }
+function objectFromEntries(entries) {
+  return Object.fromEntries(entries);
+}
 
 // src/index.ts
 var cv = (config, options = {}) => {
@@ -65,24 +69,28 @@ var cv = (config, options = {}) => {
 };
 
 // src/vue.ts
-var cvWithProps = (config, options) => {
-  const getClass = cv(config, options);
+function getPropsDeclaration(config) {
   if (typeof config?.variants === "undefined") {
-    return { getClass, props: {} };
+    return {};
   }
-  const props = Object.fromEntries(
-    Object.keys(config.variants).map((key) => [
+  return objectFromEntries(
+    getKeys(config.variants).map((key) => [
       key,
       {
         type: String,
-        default: config.defaultVariant?.[key]
+        required: config.requiredProps?.includes(key)
       }
     ])
   );
+}
+var cvWithProps = (config, options) => {
+  const getClass = cv(config, options);
+  const props = getPropsDeclaration(config);
   return { getClass, props };
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  cvWithProps
+  cvWithProps,
+  getPropsDeclaration
 });
 //# sourceMappingURL=vue.cjs.map

package/build/vue.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vue.ts","../src/index.ts","../src/utils.ts"],"sourcesContent":["import { cv, CVConfig, CVOptions, CVReturn, CVVariantsSchema } from \".\";\r\nimport { Prettify } from \"ts-essentials\";\r\nimport { type Prop } from \"vue\";\r\n\r\ntype PropsDeclaration<V extends CVVariantsSchema> = Prettify<{ [K in keyof V]: Prop<keyof V[K]> }>;\r\n\r\nexport interface CVWithPropsReturn<V extends CVVariantsSchema> {\r\n    getClass: CVReturn<V>;\r\n    props: PropsDeclaration<V>;\r\n}\r\n\r\nexport interface CVWithProps {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVWithPropsReturn<V>;\r\n}\r\n\r\nexport const cvWithProps = ((config, options) => {\r\n    const getClass = cv(config, options);\r\n\r\n    if (typeof config?.variants === \"undefined\") {\r\n        return { getClass, props: {} };\r\n    }\r\n\r\n    const props = Object.fromEntries(\r\n        Object.keys(config.variants).map(key => [\r\n            key,\r\n            {\r\n                type: String,\r\n                default: config.defaultVariant?.[key],\r\n            },\r\n        ]),\r\n    );\r\n\r\n    return { getClass, props };\r\n}) as CVWithProps;\r\n","import { ClassValue, clsx } from \"clsx\";\r\nimport { Prettify } from \"ts-essentials\";\r\nimport { getEntries, getKeys } from \"./utils\";\r\n\r\nexport type VariantProps<Component extends CVReturn<CVVariantsSchema>> = Prettify<Omit<NonNullable<Parameters<Component>[0]>, \"class\">> | undefined;\r\n\r\nexport type CVVariantsSchema = Record<string, Record<string, ClassValue>>;\r\n\r\nexport type WithClassProp<T extends Record<string, unknown>> = T & {\r\n    class?: ClassValue;\r\n};\r\n\r\nexport type CVCompoundVariantsSchema<V extends CVVariantsSchema> = WithClassProp<{\r\n    [K in keyof V]?: (keyof V[K] & string) | (keyof V[K])[] | boolean\r\n}>[];\r\n\r\nexport interface CVConfig<V extends CVVariantsSchema> {\r\n    baseClass?: ClassValue;\r\n    variants?: V;\r\n    compoundVariants?: CVCompoundVariantsSchema<NoInfer<V>> | ((variants: NoInfer<V>) => CVCompoundVariantsSchema<NoInfer<V>>);\r\n    defaultVariant?: Partial<{ [K in keyof V]?: keyof V[K] }>;\r\n}\r\n\r\nexport type CVVariantProps<V extends CVVariantsSchema> = WithClassProp<{ [K in keyof V]?: keyof V[K] }>;\r\n\r\nexport type CVReturn<V extends CVVariantsSchema> = (props?: CVVariantProps<V>) => string;\r\n\r\nexport interface CVOptions {\r\n    merge?: (...args: ClassValue[]) => string;\r\n}\r\n\r\nexport interface CV {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVReturn<V>;\r\n}\r\n\r\nexport const cv: CV = (config, options = {}) => {\r\n    const { variants, defaultVariant, baseClass } = config;\r\n\r\n    const merge = options.merge ?? clsx;\r\n\r\n    if (variants == null) return props => merge(baseClass, props?.class);\r\n\r\n    const compoundVariants = typeof config.compoundVariants === \"function\" ? config.compoundVariants(variants) : config.compoundVariants;\r\n\r\n    return (props) => {\r\n        const variantClassNames = getKeys(variants).map((variant) => {\r\n            const variantProp = props?.[variant];\r\n            const defaultVariantProp = defaultVariant?.[variant];\r\n\r\n            const variantKey = (variantProp || defaultVariantProp) as keyof (typeof variants)[typeof variant];\r\n\r\n            return variants[variant][variantKey];\r\n        });\r\n\r\n        const compoundVariantClassNames = compoundVariants?.reduce((acc, { class: cvClass, ...cvConfig }) => {\r\n            const shouldApplyCompoundVariant = getEntries(cvConfig).every(([cvKey, cvSelector]) => {\r\n                const defaultsSelector = defaultVariant?.[cvKey as keyof typeof defaultVariant];\r\n                const propsSelector = props?.[cvKey as keyof typeof props];\r\n\r\n                if (cvSelector === true) return propsSelector !== undefined; // only when prop is defined\r\n                else if (cvSelector === false) return propsSelector === undefined; // only when prop is not defined\r\n\r\n                const selector = propsSelector ?? defaultsSelector;\r\n\r\n                return Array.isArray(cvSelector) ? cvSelector.includes(selector as string) : selector === cvSelector;\r\n            });\r\n\r\n            if (shouldApplyCompoundVariant) acc.push(cvClass);\r\n            return acc;\r\n        }, new Array<ClassValue>());\r\n\r\n        return merge(config?.baseClass, variantClassNames, compoundVariantClassNames, props?.class);\r\n    };\r\n};\r\n","import { CVVariantsSchema } from \".\";\r\n\r\nexport function getKeys<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.keys(obj) as (keyof O)[];\r\n}\r\n\r\ntype Entries<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };\r\nexport function getEntries<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.entries(obj) as (Entries<O>[keyof Entries<O>])[];\r\n}\r\n\r\nexport function getVariantsOptions<V extends CVVariantsSchema>(variants: V) {\r\n    return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)])) as { [K in keyof V]: (keyof V[K])[] };\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAAiC;;;ACE1B,SAAS,QAA2C,KAAQ;AAC/D,SAAO,OAAO,KAAK,GAAG;AAC1B;AAGO,SAAS,WAA8C,KAAQ;AAClE,SAAO,OAAO,QAAQ,GAAG;AAC7B;;;AD2BO,IAAM,KAAS,CAAC,QAAQ,UAAU,CAAC,MAAM;AAC5C,QAAM,EAAE,UAAU,gBAAgB,UAAU,IAAI;AAEhD,QAAM,QAAQ,QAAQ,SAAS;AAE/B,MAAI,YAAY,KAAM,QAAO,WAAS,MAAM,WAAW,OAAO,KAAK;AAEnE,QAAM,mBAAmB,OAAO,OAAO,qBAAqB,aAAa,OAAO,iBAAiB,QAAQ,IAAI,OAAO;AAEpH,SAAO,CAAC,UAAU;AACd,UAAM,oBAAoB,QAAQ,QAAQ,EAAE,IAAI,CAAC,YAAY;AACzD,YAAM,cAAc,QAAQ,OAAO;AACnC,YAAM,qBAAqB,iBAAiB,OAAO;AAEnD,YAAM,aAAc,eAAe;AAEnC,aAAO,SAAS,OAAO,EAAE,UAAU;AAAA,IACvC,CAAC;AAED,UAAM,4BAA4B,kBAAkB,OAAO,CAAC,KAAK,EAAE,OAAO,SAAS,GAAG,SAAS,MAAM;AACjG,YAAM,6BAA6B,WAAW,QAAQ,EAAE,MAAM,CAAC,CAAC,OAAO,UAAU,MAAM;AACnF,cAAM,mBAAmB,iBAAiB,KAAoC;AAC9E,cAAM,gBAAgB,QAAQ,KAA2B;AAEzD,YAAI,eAAe,KAAM,QAAO,kBAAkB;AAAA,iBACzC,eAAe,MAAO,QAAO,kBAAkB;AAExD,cAAM,WAAW,iBAAiB;AAElC,eAAO,MAAM,QAAQ,UAAU,IAAI,WAAW,SAAS,QAAkB,IAAI,aAAa;AAAA,MAC9F,CAAC;AAED,UAAI,2BAA4B,KAAI,KAAK,OAAO;AAChD,aAAO;AAAA,IACX,GAAG,IAAI,MAAkB,CAAC;AAE1B,WAAO,MAAM,QAAQ,WAAW,mBAAmB,2BAA2B,OAAO,KAAK;AAAA,EAC9F;AACJ;;;AD1DO,IAAM,cAAe,CAAC,QAAQ,YAAY;AAC7C,QAAM,WAAW,GAAG,QAAQ,OAAO;AAEnC,MAAI,OAAO,QAAQ,aAAa,aAAa;AACzC,WAAO,EAAE,UAAU,OAAO,CAAC,EAAE;AAAA,EACjC;AAEA,QAAM,QAAQ,OAAO;AAAA,IACjB,OAAO,KAAK,OAAO,QAAQ,EAAE,IAAI,SAAO;AAAA,MACpC;AAAA,MACA;AAAA,QACI,MAAM;AAAA,QACN,SAAS,OAAO,iBAAiB,GAAG;AAAA,MACxC;AAAA,IACJ,CAAC;AAAA,EACL;AAEA,SAAO,EAAE,UAAU,MAAM;AAC7B;","names":[]}
+{"version":3,"sources":["../src/vue.ts","../src/index.ts","../src/utils.ts"],"sourcesContent":["import { Prettify } from \"ts-essentials\";\r\nimport { PropType } from \"vue\";\r\nimport { CVConfig, CVOptions, CVReturn, CVVariantsSchema, cv } from \".\";\r\nimport { getKeys, objectFromEntries } from \"./utils\";\r\n\r\ntype PropsDeclaration<V extends CVVariantsSchema, R extends keyof V = never> = Prettify<{ [K in keyof V]: {\r\n    type: PropType<keyof V[K] | (K extends R ? never : undefined)>;\r\n    required: K extends R ? true : false;\r\n} }>;\r\nexport interface CVWithPropsReturn<V extends CVVariantsSchema, R extends keyof V = never> {\r\n    getClass: CVReturn<V, R>;\r\n    props: PropsDeclaration<NoInfer<V>, NoInfer<R>>;\r\n}\r\n\r\nexport interface CVWithProps {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVWithPropsReturn<V, R>;\r\n}\r\n\r\nexport function getPropsDeclaration<V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>) {\r\n    if (typeof config?.variants === \"undefined\") {\r\n        return {};\r\n    }\r\n\r\n    return objectFromEntries(\r\n        getKeys(config.variants).map(key => [\r\n            key,\r\n            {\r\n                type: String,\r\n                required: config.requiredProps?.includes(key as R),\r\n            },\r\n        ] as const),\r\n    );\r\n}\r\n\r\nexport const cvWithProps: CVWithProps = ((config, options) => {\r\n    const getClass = cv(config, options);\r\n    const props = getPropsDeclaration(config);\r\n\r\n    return { getClass, props };\r\n}) as CVWithProps;\r\n","import { ClassValue, clsx } from \"clsx\";\r\nimport { MarkRequired, Prettify } from \"ts-essentials\";\r\nimport { getEntries, getKeys } from \"./utils\";\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport type VariantProps<CVR extends (args?: any) => string> = Prettify<Omit<NonNullable<Exclude<Parameters<CVR>[0], void>>, \"class\">>;\r\n\r\nexport type CVVariantsSchema = Record<string, Record<string, ClassValue>>;\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport type WithClassProp<T extends Record<string, any>> = T & {\r\n    class?: ClassValue;\r\n};\r\n\r\nexport type CVCompoundVariantsSchema<V extends CVVariantsSchema> = WithClassProp<{\r\n    [K in keyof V]?: (keyof V[K] & string) | (keyof V[K])[] | boolean\r\n}>[];\r\n\r\nexport interface CVConfig<V extends CVVariantsSchema, R extends keyof V> {\r\n    baseClass?: ClassValue;\r\n    variants?: V;\r\n    compoundVariants?: CVCompoundVariantsSchema<NoInfer<V>> | ((variants: NoInfer<V>) => CVCompoundVariantsSchema<NoInfer<V>>);\r\n    defaultVariant?: Partial<{ [K in keyof V]?: keyof V[K] }>;\r\n    requiredProps?: R[];\r\n}\r\n\r\nexport type CVVariantProps<V extends CVVariantsSchema, R extends (keyof V)> =\r\nWithClassProp<MarkRequired<{ [K in keyof V]?: keyof V[K] }, R>>;\r\n\r\nexport type CVReturn<V extends CVVariantsSchema, R extends keyof V = never> = (props: Prettify<CVVariantProps<V, R>> | ([R] extends [never] ? void : never)) => string;\r\n\r\nexport interface CVOptions {\r\n    merge?: (...args: ClassValue[]) => string;\r\n}\r\n\r\nexport interface CV {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVReturn<V, R>;\r\n}\r\n\r\nexport const cv: CV = (config, options = {}) => {\r\n    const { variants, defaultVariant, baseClass } = config;\r\n\r\n    const merge = options.merge ?? clsx;\r\n\r\n    if (variants == null) return props => merge(baseClass, props?.class);\r\n\r\n    const compoundVariants = typeof config.compoundVariants === \"function\" ? config.compoundVariants(variants) : config.compoundVariants;\r\n\r\n    return (props) => {\r\n        const variantClassNames = getKeys(variants).map((variant) => {\r\n            const variantProp = props?.[variant];\r\n            const defaultVariantProp = defaultVariant?.[variant];\r\n\r\n            const variantKey = (variantProp || defaultVariantProp) as keyof (typeof variants)[typeof variant];\r\n\r\n            return variants[variant][variantKey];\r\n        });\r\n\r\n        const compoundVariantClassNames = compoundVariants?.reduce((acc, { class: cvClass, ...cvConfig }) => {\r\n            const shouldApplyCompoundVariant = getEntries(cvConfig).every(([cvKey, cvSelector]) => {\r\n                const defaultsSelector = defaultVariant?.[cvKey as keyof typeof defaultVariant];\r\n                const propsSelector = props?.[cvKey as keyof typeof props];\r\n\r\n                if (cvSelector === true) return propsSelector !== undefined; // only when prop is defined\r\n                else if (cvSelector === false) return propsSelector === undefined; // only when prop is not defined\r\n\r\n                const selector = propsSelector ?? defaultsSelector;\r\n\r\n                return Array.isArray(cvSelector) ? cvSelector.includes(selector as string) : selector === cvSelector;\r\n            });\r\n\r\n            if (shouldApplyCompoundVariant) acc.push(cvClass);\r\n            return acc;\r\n        }, new Array<ClassValue>());\r\n\r\n        return merge(config?.baseClass, variantClassNames, compoundVariantClassNames, props?.class);\r\n    };\r\n};\r\n","import { DeepReadonly, DeepWritable, Prettify, UnionToIntersection } from \"ts-essentials\";\r\nimport { CVVariantsSchema } from \".\";\r\n\r\nexport function getKeys<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.keys(obj) as (keyof O)[];\r\n}\r\n\r\ntype EntriesOf<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };\r\nexport function getEntries<O extends Record<string, unknown>>(obj: O) {\r\n    return Object.entries(obj) as (EntriesOf<O>[keyof EntriesOf<O>])[];\r\n}\r\n\r\nexport function getVariantsOptions<V extends CVVariantsSchema>(variants: V) {\r\n    return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)])) as { [K in keyof V]: (keyof V[K])[] };\r\n}\r\n\r\ntype Entries = [PropertyKey, unknown][] | DeepReadonly<[PropertyKey, unknown][]>;\r\ntype UnionFromPairs<TArr extends Entries> =\r\n    DeepWritable<TArr> extends (infer R)[] ? R extends [infer key, infer val] ? { [prop in key & PropertyKey]: val } : never : never;\r\n\r\ntype MergeIntersectingObjects<O> = { [K in keyof O]: O[K] };\r\n\r\nexport function objectFromEntries<E extends Entries>(entries: E) {\r\n    return Object.fromEntries(entries) as Prettify<MergeIntersectingObjects<UnionToIntersection<UnionFromPairs<E>>>>;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAAiC;;;ACG1B,SAAS,QAA2C,KAAQ;AAC/D,SAAO,OAAO,KAAK,GAAG;AAC1B;AAGO,SAAS,WAA8C,KAAQ;AAClE,SAAO,OAAO,QAAQ,GAAG;AAC7B;AAYO,SAAS,kBAAqC,SAAY;AAC7D,SAAO,OAAO,YAAY,OAAO;AACrC;;;ADgBO,IAAM,KAAS,CAAC,QAAQ,UAAU,CAAC,MAAM;AAC5C,QAAM,EAAE,UAAU,gBAAgB,UAAU,IAAI;AAEhD,QAAM,QAAQ,QAAQ,SAAS;AAE/B,MAAI,YAAY,KAAM,QAAO,WAAS,MAAM,WAAW,OAAO,KAAK;AAEnE,QAAM,mBAAmB,OAAO,OAAO,qBAAqB,aAAa,OAAO,iBAAiB,QAAQ,IAAI,OAAO;AAEpH,SAAO,CAAC,UAAU;AACd,UAAM,oBAAoB,QAAQ,QAAQ,EAAE,IAAI,CAAC,YAAY;AACzD,YAAM,cAAc,QAAQ,OAAO;AACnC,YAAM,qBAAqB,iBAAiB,OAAO;AAEnD,YAAM,aAAc,eAAe;AAEnC,aAAO,SAAS,OAAO,EAAE,UAAU;AAAA,IACvC,CAAC;AAED,UAAM,4BAA4B,kBAAkB,OAAO,CAAC,KAAK,EAAE,OAAO,SAAS,GAAG,SAAS,MAAM;AACjG,YAAM,6BAA6B,WAAW,QAAQ,EAAE,MAAM,CAAC,CAAC,OAAO,UAAU,MAAM;AACnF,cAAM,mBAAmB,iBAAiB,KAAoC;AAC9E,cAAM,gBAAgB,QAAQ,KAA2B;AAEzD,YAAI,eAAe,KAAM,QAAO,kBAAkB;AAAA,iBACzC,eAAe,MAAO,QAAO,kBAAkB;AAExD,cAAM,WAAW,iBAAiB;AAElC,eAAO,MAAM,QAAQ,UAAU,IAAI,WAAW,SAAS,QAAkB,IAAI,aAAa;AAAA,MAC9F,CAAC;AAED,UAAI,2BAA4B,KAAI,KAAK,OAAO;AAChD,aAAO;AAAA,IACX,GAAG,IAAI,MAAkB,CAAC;AAE1B,WAAO,MAAM,QAAQ,WAAW,mBAAmB,2BAA2B,OAAO,KAAK;AAAA,EAC9F;AACJ;;;AD3DO,SAAS,oBAA2E,QAAwB;AAC/G,MAAI,OAAO,QAAQ,aAAa,aAAa;AACzC,WAAO,CAAC;AAAA,EACZ;AAEA,SAAO;AAAA,IACH,QAAQ,OAAO,QAAQ,EAAE,IAAI,SAAO;AAAA,MAChC;AAAA,MACA;AAAA,QACI,MAAM;AAAA,QACN,UAAU,OAAO,eAAe,SAAS,GAAQ;AAAA,MACrD;AAAA,IACJ,CAAU;AAAA,EACd;AACJ;AAEO,IAAM,cAA4B,CAAC,QAAQ,YAAY;AAC1D,QAAM,WAAW,GAAG,QAAQ,OAAO;AACnC,QAAM,QAAQ,oBAAoB,MAAM;AAExC,SAAO,EAAE,UAAU,MAAM;AAC7B;","names":[]}

package/build/vue.d.cts

@@ -1,18 +1,22 @@
-import { CVVariantsSchema, CVReturn, CVConfig, CVOptions } from './index.cjs';
 import { Prettify } from 'ts-essentials';
-import { Prop } from 'vue';
+import { PropType } from 'vue';
+import { CVVariantsSchema, CVReturn, CVConfig, CVOptions } from './index.cjs';
 import 'clsx';
 
-type PropsDeclaration<V extends CVVariantsSchema> = Prettify<{
-    [K in keyof V]: Prop<keyof V[K]>;
+type PropsDeclaration<V extends CVVariantsSchema, R extends keyof V = never> = Prettify<{
+    [K in keyof V]: {
+        type: PropType<keyof V[K] | (K extends R ? never : undefined)>;
+        required: K extends R ? true : false;
+    };
 }>;
-interface CVWithPropsReturn<V extends CVVariantsSchema> {
-    getClass: CVReturn<V>;
-    props: PropsDeclaration<V>;
+interface CVWithPropsReturn<V extends CVVariantsSchema, R extends keyof V = never> {
+    getClass: CVReturn<V, R>;
+    props: PropsDeclaration<NoInfer<V>, NoInfer<R>>;
 }
 interface CVWithProps {
-    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVWithPropsReturn<V>;
+    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVWithPropsReturn<V, R>;
 }
+declare function getPropsDeclaration<V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>): {};
 declare const cvWithProps: CVWithProps;
 
-export { type CVWithProps, type CVWithPropsReturn, cvWithProps };
+export { type CVWithProps, type CVWithPropsReturn, cvWithProps, getPropsDeclaration };

package/build/vue.d.ts

@@ -1,18 +1,22 @@
-import { CVVariantsSchema, CVReturn, CVConfig, CVOptions } from './index.js';
 import { Prettify } from 'ts-essentials';
-import { Prop } from 'vue';
+import { PropType } from 'vue';
+import { CVVariantsSchema, CVReturn, CVConfig, CVOptions } from './index.js';
 import 'clsx';
 
-type PropsDeclaration<V extends CVVariantsSchema> = Prettify<{
-    [K in keyof V]: Prop<keyof V[K]>;
+type PropsDeclaration<V extends CVVariantsSchema, R extends keyof V = never> = Prettify<{
+    [K in keyof V]: {
+        type: PropType<keyof V[K] | (K extends R ? never : undefined)>;
+        required: K extends R ? true : false;
+    };
 }>;
-interface CVWithPropsReturn<V extends CVVariantsSchema> {
-    getClass: CVReturn<V>;
-    props: PropsDeclaration<V>;
+interface CVWithPropsReturn<V extends CVVariantsSchema, R extends keyof V = never> {
+    getClass: CVReturn<V, R>;
+    props: PropsDeclaration<NoInfer<V>, NoInfer<R>>;
 }
 interface CVWithProps {
-    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVWithPropsReturn<V>;
+    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVWithPropsReturn<V, R>;
 }
+declare function getPropsDeclaration<V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>): {};
 declare const cvWithProps: CVWithProps;
 
-export { type CVWithProps, type CVWithPropsReturn, cvWithProps };
+export { type CVWithProps, type CVWithPropsReturn, cvWithProps, getPropsDeclaration };

package/build/vue.js

@@ -1,27 +1,33 @@
 import {
   cv
-} from "./chunk-BNE2ZOTW.js";
-import "./chunk-3RDDXOQ3.js";
-import "./chunk-PLDDJCW6.js";
+} from "./chunk-5UWIPH6K.js";
+import {
+  getKeys,
+  objectFromEntries
+} from "./chunk-AQSN2Y5C.js";
 
 // src/vue.ts
-var cvWithProps = (config, options) => {
-  const getClass = cv(config, options);
+function getPropsDeclaration(config) {
   if (typeof config?.variants === "undefined") {
-    return { getClass, props: {} };
+    return {};
   }
-  const props = Object.fromEntries(
-    Object.keys(config.variants).map((key) => [
+  return objectFromEntries(
+    getKeys(config.variants).map((key) => [
       key,
       {
         type: String,
-        default: config.defaultVariant?.[key]
+        required: config.requiredProps?.includes(key)
       }
     ])
   );
+}
+var cvWithProps = (config, options) => {
+  const getClass = cv(config, options);
+  const props = getPropsDeclaration(config);
   return { getClass, props };
 };
 export {
-  cvWithProps
+  cvWithProps,
+  getPropsDeclaration
 };
 //# sourceMappingURL=vue.js.map

package/build/vue.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vue.ts"],"sourcesContent":["import { cv, CVConfig, CVOptions, CVReturn, CVVariantsSchema } from \".\";\r\nimport { Prettify } from \"ts-essentials\";\r\nimport { type Prop } from \"vue\";\r\n\r\ntype PropsDeclaration<V extends CVVariantsSchema> = Prettify<{ [K in keyof V]: Prop<keyof V[K]> }>;\r\n\r\nexport interface CVWithPropsReturn<V extends CVVariantsSchema> {\r\n    getClass: CVReturn<V>;\r\n    props: PropsDeclaration<V>;\r\n}\r\n\r\nexport interface CVWithProps {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVWithPropsReturn<V>;\r\n}\r\n\r\nexport const cvWithProps = ((config, options) => {\r\n    const getClass = cv(config, options);\r\n\r\n    if (typeof config?.variants === \"undefined\") {\r\n        return { getClass, props: {} };\r\n    }\r\n\r\n    const props = Object.fromEntries(\r\n        Object.keys(config.variants).map(key => [\r\n            key,\r\n            {\r\n                type: String,\r\n                default: config.defaultVariant?.[key],\r\n            },\r\n        ]),\r\n    );\r\n\r\n    return { getClass, props };\r\n}) as CVWithProps;\r\n"],"mappings":";;;;;;;AAgBO,IAAM,cAAe,CAAC,QAAQ,YAAY;AAC7C,QAAM,WAAW,GAAG,QAAQ,OAAO;AAEnC,MAAI,OAAO,QAAQ,aAAa,aAAa;AACzC,WAAO,EAAE,UAAU,OAAO,CAAC,EAAE;AAAA,EACjC;AAEA,QAAM,QAAQ,OAAO;AAAA,IACjB,OAAO,KAAK,OAAO,QAAQ,EAAE,IAAI,SAAO;AAAA,MACpC;AAAA,MACA;AAAA,QACI,MAAM;AAAA,QACN,SAAS,OAAO,iBAAiB,GAAG;AAAA,MACxC;AAAA,IACJ,CAAC;AAAA,EACL;AAEA,SAAO,EAAE,UAAU,MAAM;AAC7B;","names":[]}
+{"version":3,"sources":["../src/vue.ts"],"sourcesContent":["import { Prettify } from \"ts-essentials\";\r\nimport { PropType } from \"vue\";\r\nimport { CVConfig, CVOptions, CVReturn, CVVariantsSchema, cv } from \".\";\r\nimport { getKeys, objectFromEntries } from \"./utils\";\r\n\r\ntype PropsDeclaration<V extends CVVariantsSchema, R extends keyof V = never> = Prettify<{ [K in keyof V]: {\r\n    type: PropType<keyof V[K] | (K extends R ? never : undefined)>;\r\n    required: K extends R ? true : false;\r\n} }>;\r\nexport interface CVWithPropsReturn<V extends CVVariantsSchema, R extends keyof V = never> {\r\n    getClass: CVReturn<V, R>;\r\n    props: PropsDeclaration<NoInfer<V>, NoInfer<R>>;\r\n}\r\n\r\nexport interface CVWithProps {\r\n    // eslint-disable-next-line @typescript-eslint/prefer-function-type\r\n    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVWithPropsReturn<V, R>;\r\n}\r\n\r\nexport function getPropsDeclaration<V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>) {\r\n    if (typeof config?.variants === \"undefined\") {\r\n        return {};\r\n    }\r\n\r\n    return objectFromEntries(\r\n        getKeys(config.variants).map(key => [\r\n            key,\r\n            {\r\n                type: String,\r\n                required: config.requiredProps?.includes(key as R),\r\n            },\r\n        ] as const),\r\n    );\r\n}\r\n\r\nexport const cvWithProps: CVWithProps = ((config, options) => {\r\n    const getClass = cv(config, options);\r\n    const props = getPropsDeclaration(config);\r\n\r\n    return { getClass, props };\r\n}) as CVWithProps;\r\n"],"mappings":";;;;;;;;;AAmBO,SAAS,oBAA2E,QAAwB;AAC/G,MAAI,OAAO,QAAQ,aAAa,aAAa;AACzC,WAAO,CAAC;AAAA,EACZ;AAEA,SAAO;AAAA,IACH,QAAQ,OAAO,QAAQ,EAAE,IAAI,SAAO;AAAA,MAChC;AAAA,MACA;AAAA,QACI,MAAM;AAAA,QACN,UAAU,OAAO,eAAe,SAAS,GAAQ;AAAA,MACrD;AAAA,IACJ,CAAU;AAAA,EACd;AACJ;AAEO,IAAM,cAA4B,CAAC,QAAQ,YAAY;AAC1D,QAAM,WAAW,GAAG,QAAQ,OAAO;AACnC,QAAM,QAAQ,oBAAoB,MAAM;AAExC,SAAO,EAAE,UAAU,MAAM;AAC7B;","names":[]}

package/package.json

@@ -5,7 +5,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
   "main": "build/index.cjs",
   "module": "build/index.js",

package/src/index.ts

@@ -1,12 +1,14 @@
 import { ClassValue, clsx } from "clsx";
-import { Prettify } from "ts-essentials";
+import { MarkRequired, Prettify } from "ts-essentials";
 import { getEntries, getKeys } from "./utils";
 
-export type VariantProps<Component extends CVReturn<CVVariantsSchema>> = Prettify<Omit<NonNullable<Parameters<Component>[0]>, "class">> | undefined;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type VariantProps<CVR extends (args?: any) => string> = Prettify<Omit<NonNullable<Exclude<Parameters<CVR>[0], void>>, "class">>;
 
 export type CVVariantsSchema = Record<string, Record<string, ClassValue>>;
 
-export type WithClassProp<T extends Record<string, unknown>> = T & {
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type WithClassProp<T extends Record<string, any>> = T & {
     class?: ClassValue;
 };
 
@@ -14,16 +16,18 @@ export type CVCompoundVariantsSchema<V extends CVVariantsSchema> = WithClassProp
     [K in keyof V]?: (keyof V[K] & string) | (keyof V[K])[] | boolean
 }>[];
 
-export interface CVConfig<V extends CVVariantsSchema> {
+export interface CVConfig<V extends CVVariantsSchema, R extends keyof V> {
     baseClass?: ClassValue;
     variants?: V;
     compoundVariants?: CVCompoundVariantsSchema<NoInfer<V>> | ((variants: NoInfer<V>) => CVCompoundVariantsSchema<NoInfer<V>>);
     defaultVariant?: Partial<{ [K in keyof V]?: keyof V[K] }>;
+    requiredProps?: R[];
 }
 
-export type CVVariantProps<V extends CVVariantsSchema> = WithClassProp<{ [K in keyof V]?: keyof V[K] }>;
+export type CVVariantProps<V extends CVVariantsSchema, R extends (keyof V)> =
+WithClassProp<MarkRequired<{ [K in keyof V]?: keyof V[K] }, R>>;
 
-export type CVReturn<V extends CVVariantsSchema> = (props?: CVVariantProps<V>) => string;
+export type CVReturn<V extends CVVariantsSchema, R extends keyof V = never> = (props: Prettify<CVVariantProps<V, R>> | ([R] extends [never] ? void : never)) => string;
 
 export interface CVOptions {
     merge?: (...args: ClassValue[]) => string;
@@ -31,7 +35,7 @@ export interface CVOptions {
 
 export interface CV {
     // eslint-disable-next-line @typescript-eslint/prefer-function-type
-    <V extends CVVariantsSchema>(config: CVConfig<V>, options?: CVOptions): CVReturn<V>;
+    <V extends CVVariantsSchema, R extends keyof V = never>(config: CVConfig<V, R>, options?: CVOptions): CVReturn<V, R>;
 }
 
 export const cv: CV = (config, options = {}) => {

package/src/utils.ts

@@ -1,14 +1,25 @@
+import { DeepReadonly, DeepWritable, Prettify, UnionToIntersection } from "ts-essentials";
 import { CVVariantsSchema } from ".";
 
 export function getKeys<O extends Record<string, unknown>>(obj: O) {
     return Object.keys(obj) as (keyof O)[];
 }
 
-type Entries<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };
+type EntriesOf<O extends Record<string, unknown>> = { [K in keyof O]: [K, O[K]] };
 export function getEntries<O extends Record<string, unknown>>(obj: O) {
-    return Object.entries(obj) as (Entries<O>[keyof Entries<O>])[];
+    return Object.entries(obj) as (EntriesOf<O>[keyof EntriesOf<O>])[];
 }
 
 export function getVariantsOptions<V extends CVVariantsSchema>(variants: V) {
     return Object.fromEntries(getEntries(variants).map(([cvKey, cvVal]) => [cvKey, getKeys(cvVal)])) as { [K in keyof V]: (keyof V[K])[] };
 }
+
+type Entries = [PropertyKey, unknown][] | DeepReadonly<[PropertyKey, unknown][]>;
+type UnionFromPairs<TArr extends Entries> =
+    DeepWritable<TArr> extends (infer R)[] ? R extends [infer key, infer val] ? { [prop in key & PropertyKey]: val } : never : never;
+
+type MergeIntersectingObjects<O> = { [K in keyof O]: O[K] };
+
+export function objectFromEntries<E extends Entries>(entries: E) {
+    return Object.fromEntries(entries) as Prettify<MergeIntersectingObjects<UnionToIntersection<UnionFromPairs<E>>>>;
+}