praxis-kit 2.0.1 → 3.0.0

package/dist/lit/index.d.ts

@@ -12,6 +12,8 @@ type KnownAriaRole = (typeof KNOWN_ARIA_ROLES)[number];
 
 type AriaRole = KnownAriaRole | (string & {});
 
+type Booleanish = boolean | 'true' | 'false';
+
 type ClassName = string | string[];
 
 type EmptyRecord = Record<never, never>;
@@ -22,6 +24,10 @@ type IntrinsicProps = AnyRecord & {
 
 type NonEmptyArray<T> = [T, ...T[]];
 
+type Numberish = number | `${number}`;
+
+type Primitive = string | number | boolean;
+
 type TagMap = Partial<Record<IntrinsicTag | (string & {}), ClassName>>;
 
 type StrictMode = boolean | 'warn' | 'async-warn' | 'throw';
@@ -54,9 +60,9 @@ type ValidResult = {
 
 type StringToBoolean<T> = T extends 'true' | 'false' ? boolean : T;
 
-type VariantValue = string | string[];
+type VariantValue$1 = string | string[];
 
-type VariantStates<K extends string = string> = Record<K, VariantValue>;
+type VariantStates<K extends string = string> = Record<K, VariantValue$1>;
 
 type VariantMap<V extends string = string, K extends string = string> = Record<V, VariantStates<K>>;
 
@@ -70,19 +76,16 @@ type CompoundVariantConditions<V extends VariantMap> = Simplify<{
 type CompoundVariantRequiredConditions<V extends VariantMap> = RequireAtLeastOneIfNotEmpty<CompoundVariantConditions<V>>;
 type CompoundVariantBase<V extends VariantMap> = keyof V extends never ? EmptyRecord : CompoundVariantRequiredConditions<V>;
 type CompoundVariant<V extends VariantMap> = CompoundVariantBase<V> & {
-    class: VariantValue;
+    class: VariantValue$1;
 };
 
 interface CVACompounds<V extends VariantMap> {
     compoundVariants?: readonly CompoundVariant<V>[];
 }
 
-/** The full optional prop surface exposed to callers for a given variant map. */
-type VariantProps<V extends VariantMap> = {
-    [K in keyof V]?: VariantKey<V, K>;
-};
+type VariantValue<K extends string> = string extends K ? Primitive : K extends 'true' | 'false' ? Booleanish : K extends `${number}` ? Numberish : K;
 type DefaultVariants<V extends VariantMap> = {
-    [K in keyof V]?: VariantKey<V, K>;
+    [K in keyof V]?: VariantValue<keyof V[K] & string>;
 };
 
 interface CVADefaults<V extends VariantMap> {
@@ -109,25 +112,25 @@ type VariantSelection<V extends VariantMap> = {
  * Presets are named bundles of variant props that callers activate by key,
  * avoiding the need to repeat variant combinations at each call site.
  */
-type PresetMap<V extends VariantMap = VariantMap> = Readonly<Record<string, VariantSelection<V>>>;
+type RecipeMap<V extends VariantMap = VariantMap> = Readonly<Record<string, VariantSelection<V>>>;
 
-type PresetTarget<TVariants extends VariantMap = VariantMap> = VariantSelection<TVariants>;
+type RecipeTarget<TVariants extends VariantMap = VariantMap> = VariantSelection<TVariants>;
 
 interface BaseClassOptions {
     baseClassName?: ClassName;
 }
 
-type ClassPipelineFn = (tag: unknown, props: AnyRecord, className?: ClassName, variantKey?: string) => string;
+type ClassPipelineFn = (tag: unknown, props: AnyRecord, className?: ClassName, recipe?: string) => string;
 
-interface PresetOptions<TVariants extends VariantMap = VariantMap> {
-    presetMap?: Record<string, PresetTarget<TVariants>>;
+interface RecipeOptions<TVariants extends VariantMap = VariantMap> {
+    recipeMap?: Record<string, RecipeTarget<TVariants>>;
 }
 
 interface TagMapOptions {
     tagMap?: TagMap;
 }
 
-type CompositionOptions<TVariants extends VariantMap = VariantMap> = Simplify<TagMapOptions & PresetOptions<TVariants>>;
+type CompositionOptions<TVariants extends VariantMap = VariantMap> = Simplify<TagMapOptions & RecipeOptions<TVariants>>;
 
 type CVASystemOptions<TVariants extends VariantMap = VariantMap> = Simplify<CVAVariants<TVariants> & CVADefaults<TVariants> & CVACompounds<TVariants>>;
 
@@ -202,10 +205,10 @@ type EnforcementOptions<TAllowed extends ElementType = ElementType> = {
     readonly allowedAs?: readonly TAllowed[];
 };
 
-type StylingOptions<V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord> = {
+type StylingOptions<V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord> = {
     readonly base?: ClassName;
     readonly variants?: V;
-    readonly defaults?: Partial<VariantProps<V>>;
+    readonly defaults?: Partial<DefaultVariants<V>>;
     readonly compounds?: readonly CompoundVariant<V>[];
     readonly presets?: TPreset;
     readonly tags?: Readonly<TagMap>;
@@ -216,8 +219,8 @@ type StylingOptions<V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPre
 type NormalizeFn<Props extends AnyRecord = AnyRecord> = {
     normalize(props: Readonly<Props & IntrinsicProps>): Props & IntrinsicProps;
 }['normalize'];
-type AnyFactoryOptions = FactoryOptions<ElementType, AnyRecord, VariantMap, PresetMap<VariantMap>, AnyRecord>;
-type FactoryOptions<TDefault extends ElementType = ElementType, Props extends AnyRecord = EmptyRecord, V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType> = {
+type AnyFactoryOptions = FactoryOptions<ElementType, AnyRecord, VariantMap, RecipeMap<VariantMap>, AnyRecord>;
+type FactoryOptions<TDefault extends ElementType = ElementType, Props extends AnyRecord = EmptyRecord, V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType> = {
     readonly tag?: TDefault;
     readonly name?: string;
     readonly defaults?: Partial<NoInfer<Props>>;
@@ -228,6 +231,8 @@ type FactoryOptions<TDefault extends ElementType = ElementType, Props extends An
 
 type FilterPredicate = (key: string, variantKeys: ReadonlySet<string>) => boolean;
 
+declare function defineContractComponent<O extends FactoryOptions>(options: O): <R>(factory: (options: O) => R) => R;
+
 /**
  * Options accepted by createContractComponent in the Lit adapter.
  *
@@ -239,7 +244,7 @@ type FilterPredicate = (key: string, variantKeys: ReadonlySet<string>) => boolea
  * Note: this adapter targets Light DOM composition only. Shadow DOM slot
  * protocol is intentionally out of scope.
  */
-type LitFactoryOptions<TDefault extends ElementType = ElementType, TProps extends AnyRecord = EmptyRecord, TVariants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<TVariants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord> = FactoryOptions<TDefault, TProps, TVariants, TPreset, TPluginProps> & {
+type LitFactoryOptions<TDefault extends ElementType = ElementType, TProps extends AnyRecord = EmptyRecord, TVariants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<TVariants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord> = FactoryOptions<TDefault, TProps, TVariants, TPreset, TPluginProps> & {
     readonly filterProps?: FilterPredicate;
 };
 
@@ -254,7 +259,7 @@ type UnknownProps = AnyRecord;
 type LitContractComponent<TVariants extends Readonly<VariantMap> = Readonly<EmptyRecord>> = {
     new (): LitElement & {
         as: string | undefined;
-        variantKey: string | undefined;
+        recipe: string | undefined;
         praxisClass: string | undefined;
     } & {
         [K in Extract<keyof TVariants, string>]?: string | null;
@@ -281,9 +286,7 @@ type LitContractComponent<TVariants extends Readonly<VariantMap> = Readonly<Empt
  * customElements.define('praxis-button', Button)
  * ```
  */
-declare function createContractComponent<TDefault extends ElementType, TProps extends UnknownProps = EmptyRecord, TVariants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<TVariants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: LitFactoryOptions<TDefault, TProps, TVariants, TPreset, TPluginProps>): LitContractComponent<TVariants>;
-
-declare function defineContractComponent<O extends FactoryOptions>(options: O): <R>(factory: (options: O) => R) => R;
+declare function createContractComponent<TDefault extends ElementType, TProps extends UnknownProps = EmptyRecord, TVariants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<TVariants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: LitFactoryOptions<TDefault, TProps, TVariants, TPreset, TPluginProps>): LitContractComponent<TVariants>;
 
 /**
  * Renders a praxis-kit Lit component to an HTML string without requiring a DOM.

package/dist/lit/index.js

@@ -12,7 +12,12 @@ function applyFilter(props, filterProps, variantKeys) {
   return out;
 }
 
-// ../core/dist/chunk-XFCAUPVZ.js
+// ../../lib/adapter-utils/src/define-component.ts
+function defineContractComponent(options) {
+  return (factory) => factory(options);
+}
+
+// ../core/dist/chunk-KKSHJDE7.js
 function makeResolveTag(defaultTag) {
   return function tag(as) {
     return as ?? defaultTag;
@@ -81,7 +86,7 @@ function resolveFactoryOptions(options = {}) {
     ...whenDefined("defaultProps", options.defaults),
     ...whenDefined("baseClassName", styling?.base),
     ...whenDefined("tagMap", styling?.tags),
-    ...whenDefined("presetMap", styling?.presets),
+    ...whenDefined("recipeMap", styling?.presets),
     ...whenDefined("variants", styling?.variants),
     ...whenDefined("defaultVariants", styling?.defaults),
     ...whenDefined("compoundVariants", styling?.compounds),
@@ -122,10 +127,10 @@ function validateFactoryOptions(resolved) {
       }
     }
   };
-  const { presetMap } = resolved;
-  if (presetMap) {
-    for (const presetKey in presetMap) {
-      checkSelection(`preset "${presetKey}"`, presetMap[presetKey]);
+  const { recipeMap } = resolved;
+  if (recipeMap) {
+    for (const recipeKey in recipeMap) {
+      checkSelection(`preset "${recipeKey}"`, recipeMap[recipeKey]);
     }
   }
   if (resolved.defaultVariants) checkSelection("defaults", resolved.defaultVariants);
@@ -161,12 +166,12 @@ function report2(strict, message) {
 function label(name) {
   return name ? `[${name}]` : "[createContractComponent]";
 }
-function validateRenderProps(options, props, presetKey) {
-  const { strict, presetMap, variants, displayName } = options;
+function validateRenderProps(options, props, recipeKey) {
+  const { strict, recipeMap, variants, displayName } = options;
   if (!strict) return;
   const tag = label(displayName);
-  if (presetKey !== void 0 && (!presetMap || !Object.hasOwn(presetMap, presetKey))) {
-    report2(strict, `${tag} Unknown presetKey "${presetKey}" \u2014 no preset with that name exists.`);
+  if (recipeKey !== void 0 && (!recipeMap || !Object.hasOwn(recipeMap, recipeKey))) {
+    report2(strict, `${tag} Unknown recipeKey "${recipeKey}" \u2014 no preset with that name exists.`);
   }
   if (variants) {
     for (const key in variants) {
@@ -204,8 +209,8 @@ function assertPluginShape(result) {
 }
 function guardPipeline(pipeline) {
   if (process.env.NODE_ENV === "production") return pipeline;
-  return function guardedPipeline(tag, props, className, variantKey) {
-    const result = pipeline(tag, props, className, variantKey);
+  return function guardedPipeline(tag, props, className, recipe) {
+    const result = pipeline(tag, props, className, recipe);
     if (typeof result !== "string")
       panic(`[praxis-kit] Plugin pipeline must return a string. Got: ${describe(result)}.`);
     return result;
@@ -230,11 +235,11 @@ function createRuntimeMethods(resolved, classPipeline, engine) {
     resolveProps(props) {
       return mergeProps(resolved.defaultProps, props);
     },
-    resolveClasses(tag, props, className, variantKey) {
+    resolveClasses(tag, props, className, recipe) {
       if (process.env.NODE_ENV !== "production") {
-        validateRenderProps(resolved, props, variantKey);
+        validateRenderProps(resolved, props, recipe);
       }
-      return classPipeline(tag, props, className, variantKey);
+      return classPipeline(tag, props, className, recipe);
     },
     resolveAria(tag, props) {
       if (!engine) return { props };
@@ -580,7 +585,7 @@ function isStandaloneTag(tag) {
   return STANDALONE_ROLES_SET.has(IMPLICIT_ROLE_RECORD[tag]);
 }
 
-// ../core/dist/chunk-VU44HAB7.js
+// ../core/dist/chunk-BNVYTMYV.js
 var IMPLICIT_ROLE_RECORD2 = {
   article: "article",
   aside: "complementary",
@@ -1515,7 +1520,7 @@ function getHtmlPropNormalizers(tag) {
   return typeof tag === "string" ? HTML_FORM_NORMALIZERS.get(tag) : void 0;
 }
 
-// ../core/dist/chunk-EHCOMLJ4.js
+// ../core/dist/chunk-3T4EM5FG.js
 var falsyToString = (value) => typeof value === "boolean" ? `${value}` : value === 0 ? "0" : value;
 var cx = clsx;
 var cva = (base, config) => (props) => {
@@ -1592,18 +1597,18 @@ var StaticClassResolver = class {
 };
 var VariantClassResolver = class _VariantClassResolver {
   #cvaFn;
-  #presetMap;
+  #recipeMap;
   #variantKeys;
   #precomputedClasses;
   #cache = /* @__PURE__ */ new Map();
-  constructor(cvaFn, presetMap, variantKeys, precomputedClasses) {
+  constructor(cvaFn, recipeMap, variantKeys, precomputedClasses) {
     this.#cvaFn = cvaFn ?? null;
-    this.#presetMap = Object.freeze(presetMap ?? {});
+    this.#recipeMap = Object.freeze(recipeMap ?? {});
     this.#variantKeys = variantKeys ?? null;
     this.#precomputedClasses = precomputedClasses ?? null;
   }
-  resolve({ props, variantKey }) {
-    const normalizedKey = variantKey ?? "__none__";
+  resolve({ props, recipe }) {
+    const normalizedKey = recipe ?? "__none__";
     const cacheKey = this.#createCacheKey(props, normalizedKey);
     if (this.#precomputedClasses !== null) {
       const precomputed = this.#precomputedClasses[cacheKey];
@@ -1615,7 +1620,7 @@ var VariantClassResolver = class _VariantClassResolver {
       this.#cache.set(cacheKey, cached);
       return cached;
     }
-    const result = this.#compute(props, variantKey);
+    const result = this.#compute(props, recipe);
     this.#cache.set(cacheKey, result);
     if (this.#cache.size > 1e3) {
       const lru = this.#cache.keys().next().value;
@@ -1623,10 +1628,10 @@ var VariantClassResolver = class _VariantClassResolver {
     }
     return result;
   }
-  #compute(props, variantKey) {
+  #compute(props, recipe) {
     if (!this.#cvaFn) return "";
-    if (!variantKey) return this.#cvaFn(props);
-    const preset = this.#presetMap[variantKey];
+    if (!recipe) return this.#cvaFn(props);
+    const preset = this.#recipeMap[recipe];
     if (!preset) return this.#cvaFn(props);
     return this.#cvaFn({ ...preset, ...props });
   }
@@ -1634,15 +1639,15 @@ var VariantClassResolver = class _VariantClassResolver {
   // props (className, id, etc.) produce identical CVA output and must not fragment the cache.
   // Iterating #variantKeys directly (fixed Set insertion order) avoids Object.keys + filter + sort.
   // String is built incrementally to avoid a parts[] array allocation on every render.
-  #createCacheKey(props, variantKey) {
+  #createCacheKey(props, recipe) {
     if (this.#variantKeys !== null) {
-      let key2 = variantKey;
+      let key2 = recipe;
       for (const k of this.#variantKeys) {
         if (k in props) key2 += `|${k}:${_VariantClassResolver.#serializeValue(props[k])}`;
       }
       return key2;
     }
-    let key = variantKey;
+    let key = recipe;
     for (const k of Object.keys(props).sort()) {
       key += `|${k}:${_VariantClassResolver.#serializeValue(props[k])}`;
     }
@@ -1667,13 +1672,13 @@ function createClassPipeline(resolved) {
   const staticResolver = new StaticClassResolver(baseClass, resolved.tagMap);
   const variantResolver = new VariantClassResolver(
     cvaFn,
-    resolved.presetMap,
+    resolved.recipeMap,
     variantKeys,
     resolved.precomputedClasses
   );
-  return function resolveClasses(tag, props, className, variantKey) {
-    const staticClasses = staticResolver.resolve(tag, variantKey !== void 0);
-    const variantClasses = variantResolver.resolve({ props, variantKey });
+  return function resolveClasses(tag, props, className, recipe) {
+    const staticClasses = staticResolver.resolve(tag, recipe !== void 0);
+    const variantClasses = variantResolver.resolve({ props, recipe });
     if (!className)
       return staticClasses && variantClasses ? `${staticClasses} ${variantClasses}` : staticClasses || variantClasses;
     return cn(staticClasses, variantClasses, className);
@@ -1776,7 +1781,7 @@ function renderToString(component, props = {}, innerHTML = "") {
     );
   }
   const { bundle } = entry;
-  const { as, className, variantKey, class: classAttr, ...rest } = props;
+  const { as, className, recipe, class: classAttr, ...rest } = props;
   const tag = bundle.runtime.resolveTag(as);
   const mergedProps = bundle.runtime.resolveProps(rest);
   const resolvedClass = bundle.runtime.resolveClasses(
@@ -1784,7 +1789,7 @@ function renderToString(component, props = {}, innerHTML = "") {
     mergedProps,
     // Accept both React-style className and HTML-native class
     className ?? classAttr,
-    variantKey
+    recipe
   );
   const ariaResult = bundle.runtime.resolveAria(tag, mergedProps);
   const filtered = applyFilter(
@@ -1820,7 +1825,7 @@ function toLooseBundle(bundle) {
   return bundle;
 }
 function resolveHostState(bundle, props) {
-  const { as, className, variantKey, ...rest } = props;
+  const { as, className, recipe, ...rest } = props;
   const tag = bundle.runtime.resolveTag(as);
   const mergedProps = bundle.runtime.resolveProps(rest);
   const baseProps = bundle.runtime.options.normalizeFn ? bundle.runtime.options.normalizeFn(mergedProps) : mergedProps;
@@ -1830,7 +1835,7 @@ function resolveHostState(bundle, props) {
     tag,
     normalizedProps,
     className,
-    variantKey
+    recipe
   );
   const ariaResult = bundle.runtime.resolveAria(tag, normalizedProps);
   const attributes = applyFilter(
@@ -1871,10 +1876,10 @@ function createContractComponent(options) {
   const bundle = buildRuntime(options);
   const looseBundle = toLooseBundle(bundle);
   const variantKeys = options.styling?.variants ? Object.keys(options.styling.variants) : [];
-  const praxisProps = /* @__PURE__ */ new Set(["as", "variantKey", "praxisClass", ...variantKeys]);
+  const praxisProps = /* @__PURE__ */ new Set(["as", "recipe", "praxisClass", ...variantKeys]);
   const staticProps = {
     as: { type: String, attribute: "as" },
-    variantKey: { type: String, attribute: "variant-key" },
+    recipe: { type: String, attribute: "variant-key" },
     // External className input — separate from the pipeline-output `class`
     // attribute so _applyPraxis can read it without a circular class→pipeline→class loop.
     praxisClass: { type: String, attribute: "praxis-class" }
@@ -1927,7 +1932,7 @@ function createContractComponent(options) {
         if (attr.name !== "class") props[attr.name] = attr.value;
       }
       props["as"] = self.as;
-      props["variantKey"] = self.variantKey;
+      props["recipe"] = self.recipe;
       props["className"] = self.praxisClass;
       for (const key of variantKeys) {
         const val = self[key];
@@ -1948,11 +1953,6 @@ function createContractComponent(options) {
   registerForSsr(PolymorphicLitElement, looseBundle);
   return PolymorphicLitElement;
 }
-
-// ../../adapters/lit/src/define-contract-component.ts
-function defineContractComponent(options) {
-  return (factory) => factory(options);
-}
 export {
   createContractComponent,
   defineContractComponent,

package/dist/{merge-refs-DxjWMq3U.d.ts → merge-refs-CfAbwCKz.d.ts}

@@ -12,6 +12,8 @@ type KnownAriaRole = (typeof KNOWN_ARIA_ROLES)[number];
 
 type AriaRole = KnownAriaRole | (string & {});
 
+type Booleanish = boolean | 'true' | 'false';
+
 type ClassName = string | string[];
 
 type EmptyRecord = Record<never, never>;
@@ -22,6 +24,10 @@ type IntrinsicProps = AnyRecord & {
 
 type NonEmptyArray<T> = [T, ...T[]];
 
+type Numberish = number | `${number}`;
+
+type Primitive = string | number | boolean;
+
 type TagMap = Partial<Record<IntrinsicTag | (string & {}), ClassName>>;
 
 type StrictMode = boolean | 'warn' | 'async-warn' | 'throw';
@@ -54,9 +60,9 @@ type ValidResult = {
 
 type StringToBoolean<T> = T extends 'true' | 'false' ? boolean : T;
 
-type VariantValue = string | string[];
+type VariantValue$1 = string | string[];
 
-type VariantStates<K extends string = string> = Record<K, VariantValue>;
+type VariantStates<K extends string = string> = Record<K, VariantValue$1>;
 
 type VariantMap<V extends string = string, K extends string = string> = Record<V, VariantStates<K>>;
 
@@ -70,7 +76,7 @@ type CompoundVariantConditions<V extends VariantMap> = Simplify<{
 type CompoundVariantRequiredConditions<V extends VariantMap> = RequireAtLeastOneIfNotEmpty<CompoundVariantConditions<V>>;
 type CompoundVariantBase<V extends VariantMap> = keyof V extends never ? EmptyRecord : CompoundVariantRequiredConditions<V>;
 type CompoundVariant<V extends VariantMap> = CompoundVariantBase<V> & {
-    class: VariantValue;
+    class: VariantValue$1;
 };
 
 interface CVACompounds<V extends VariantMap> {
@@ -81,8 +87,9 @@ interface CVACompounds<V extends VariantMap> {
 type VariantProps<V extends VariantMap> = {
     [K in keyof V]?: VariantKey<V, K>;
 };
+type VariantValue<K extends string> = string extends K ? Primitive : K extends 'true' | 'false' ? Booleanish : K extends `${number}` ? Numberish : K;
 type DefaultVariants<V extends VariantMap> = {
-    [K in keyof V]?: VariantKey<V, K>;
+    [K in keyof V]?: VariantValue<keyof V[K] & string>;
 };
 
 interface CVADefaults<V extends VariantMap> {
@@ -109,9 +116,9 @@ type VariantSelection<V extends VariantMap> = {
  * Presets are named bundles of variant props that callers activate by key,
  * avoiding the need to repeat variant combinations at each call site.
  */
-type PresetMap<V extends VariantMap = VariantMap> = Readonly<Record<string, VariantSelection<V>>>;
+type RecipeMap<V extends VariantMap = VariantMap> = Readonly<Record<string, VariantSelection<V>>>;
 
-interface PolymorphicGenerics<TDefault extends ElementType = ElementType, Props extends AnyRecord = AnyRecord, Variants extends Readonly<VariantMap> = Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TAllowed extends ElementType = ElementType> {
+interface PolymorphicGenerics<TDefault extends ElementType = ElementType, Props extends AnyRecord = AnyRecord, Variants extends Readonly<VariantMap> = Readonly<VariantMap>, TPreset extends RecipeMap<Variants> = Readonly<EmptyRecord>, TAllowed extends ElementType = ElementType> {
     default: TDefault;
     props: Props;
     variants: Variants;
@@ -119,26 +126,26 @@ interface PolymorphicGenerics<TDefault extends ElementType = ElementType, Props
     allowed: TAllowed;
 }
 type VariantsOf<T extends PolymorphicGenerics> = T['variants'];
-type PresetOf<T extends PolymorphicGenerics> = T['preset'];
+type RecipeOf<T extends PolymorphicGenerics> = T['preset'];
 type AllowedOf<T extends PolymorphicGenerics> = T['allowed'];
 
-type PresetTarget<TVariants extends VariantMap = VariantMap> = VariantSelection<TVariants>;
+type RecipeTarget<TVariants extends VariantMap = VariantMap> = VariantSelection<TVariants>;
 
 interface BaseClassOptions {
     baseClassName?: ClassName;
 }
 
-type ClassPipelineFn = (tag: unknown, props: AnyRecord, className?: ClassName, variantKey?: string) => string;
+type ClassPipelineFn = (tag: unknown, props: AnyRecord, className?: ClassName, recipe?: string) => string;
 
-interface PresetOptions<TVariants extends VariantMap = VariantMap> {
-    presetMap?: Record<string, PresetTarget<TVariants>>;
+interface RecipeOptions<TVariants extends VariantMap = VariantMap> {
+    recipeMap?: Record<string, RecipeTarget<TVariants>>;
 }
 
 interface TagMapOptions {
     tagMap?: TagMap;
 }
 
-type CompositionOptions<TVariants extends VariantMap = VariantMap> = Simplify<TagMapOptions & PresetOptions<TVariants>>;
+type CompositionOptions<TVariants extends VariantMap = VariantMap> = Simplify<TagMapOptions & RecipeOptions<TVariants>>;
 
 type CVASystemOptions<TVariants extends VariantMap = VariantMap> = Simplify<CVAVariants<TVariants> & CVADefaults<TVariants> & CVACompounds<TVariants>>;
 
@@ -213,10 +220,10 @@ type EnforcementOptions<TAllowed extends ElementType = ElementType> = {
     readonly allowedAs?: readonly TAllowed[];
 };
 
-type StylingOptions<V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord> = {
+type StylingOptions<V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord> = {
     readonly base?: ClassName;
     readonly variants?: V;
-    readonly defaults?: Partial<VariantProps<V>>;
+    readonly defaults?: Partial<DefaultVariants<V>>;
     readonly compounds?: readonly CompoundVariant<V>[];
     readonly presets?: TPreset;
     readonly tags?: Readonly<TagMap>;
@@ -227,8 +234,8 @@ type StylingOptions<V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPre
 type NormalizeFn<Props extends AnyRecord = AnyRecord> = {
     normalize(props: Readonly<Props & IntrinsicProps>): Props & IntrinsicProps;
 }['normalize'];
-type AnyFactoryOptions = FactoryOptions<ElementType, AnyRecord, VariantMap, PresetMap<VariantMap>, AnyRecord>;
-type FactoryOptions<TDefault extends ElementType = ElementType, Props extends AnyRecord = EmptyRecord, V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType> = {
+type AnyFactoryOptions = FactoryOptions<ElementType, AnyRecord, VariantMap, RecipeMap<VariantMap>, AnyRecord>;
+type FactoryOptions<TDefault extends ElementType = ElementType, Props extends AnyRecord = EmptyRecord, V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType> = {
     readonly tag?: TDefault;
     readonly name?: string;
     readonly defaults?: Partial<NoInfer<Props>>;
@@ -240,6 +247,8 @@ type FactoryOptions<TDefault extends ElementType = ElementType, Props extends An
 type DefaultOf<T extends PolymorphicGenerics> = T['default'];
 type PropsOf<T extends PolymorphicGenerics> = T['props'];
 
+declare function defineContractComponent<O extends FactoryOptions>(options: O): <R>(factory: (options: O) => R) => R;
+
 type UnknownProps = Record<string, unknown>;
 type SlotComponent = ComponentType<UnknownProps>;
 
@@ -255,7 +264,7 @@ type RenderCallbackProps = Readonly<Record<string, unknown>>;
  * Extends FactoryOptions with React-specific configuration.
  * slotComponent is intentionally not in core — it is a React rendering concern.
  */
-type ReactFactoryOptions<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType> = FactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps, TAllowed> & {
+type ReactFactoryOptions<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends RecipeMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType> = FactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps, TAllowed> & {
     /** Component used to render the asChild slot. Defaults to the built-in Slot. */
     slotComponent?: SlotComponent;
     /**
@@ -298,7 +307,7 @@ type OwnedProps<G extends PolymorphicGenerics> = ComponentProps<G> & ComponentVa
 type PolymorphicControlProps<G extends PolymorphicGenerics, TAs extends ElementType> = {
     as?: TAs & AllowedOf<G>;
     className?: ClassName | undefined;
-    variantKey?: keyof PresetOf<G>;
+    recipe?: keyof RecipeOf<G>;
     ref?: Ref<ElementRef<TAs>>;
 };
 /** @internal Full set of props owned by the component — used as the Omit key in IntrinsicPropsWithoutOwned. */
@@ -368,4 +377,4 @@ type PolymorphicComponent<G extends PolymorphicGenerics> = {
 
 declare function mergeRefs<T>(...refs: (Ref<T> | null | undefined)[]): Ref<T> | null;
 
-export { type AnyRecord as A, type ElementType as E, type FactoryOptions as F, type PresetMap as P, type ReactFactoryOptions as R, Slottable as S, type UnknownProps as U, type VariantMap as V, type EmptyRecord as a, type PolymorphicComponent as b, type PolymorphicGenerics as c, type AnyFactoryOptions as d, type ElementRef as e, type PolymorphicProps as f, type PolymorphicWithAsChild as g, type PolymorphicWithRender as h, type RenderCallbackProps as i, type SlottableProps as j, mergeRefs as m };
+export { type AnyRecord as A, type ElementType as E, type FactoryOptions as F, type PolymorphicComponent as P, type RecipeMap as R, Slottable as S, type UnknownProps as U, type VariantMap as V, type EmptyRecord as a, type ReactFactoryOptions as b, type PolymorphicGenerics as c, type AnyFactoryOptions as d, type ElementRef as e, type PolymorphicProps as f, type PolymorphicWithAsChild as g, type PolymorphicWithRender as h, type RenderCallbackProps as i, type SlottableProps as j, defineContractComponent as k, mergeRefs as m };