praxis-kit 2.0.1 → 3.0.0

package/dist/{chunk-ACAKUHH5.js → chunk-PBBPAHMV.js}

@@ -1,117 +1,6 @@
-// ../../adapters/react/src/shared/merge-refs.ts
-function mergeRefs(...refs) {
-  const active = refs.filter((r2) => r2 != null);
-  if (active.length === 0) return null;
-  if (active.length === 1) return active[0];
-  return (value) => {
-    for (const ref of active) {
-      if (typeof ref === "function") {
-        ref(value);
-      } else {
-        ref.current = value;
-      }
-    }
-  };
-}
-
-// ../../adapters/react/src/shared/slot/Slottable.tsx
-import { Fragment } from "react";
-import { jsx } from "react/jsx-runtime";
-function Slottable({ children }) {
-  return /* @__PURE__ */ jsx(Fragment, { children });
-}
-
-// ../../lib/primitive/src/utils/is-object.ts
-function isNull(value) {
-  return value === null;
-}
-function isObject(value) {
-  return !isNull(value) && typeof value === "object";
-}
-
-// ../../lib/primitive/src/merge/constants.ts
-var EVENT_HANDLER_RE = /^on[A-Z]/;
-
-// ../../lib/primitive/src/merge/predicates.ts
-function isFunction(value) {
-  return typeof value === "function";
-}
-function isPlainObject(value) {
-  if (!isObject(value)) return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-
-// ../shared/src/constants/primitive/slot-name.ts
-var SLOT_NAME = "Slot";
-
-// ../../adapters/react/src/shared/slot/clone.ts
-import { cloneElement } from "react";
-function cloneWithProps(child, props, ref) {
-  return cloneElement(child, ref !== null ? { ...props, ref } : props);
-}
-
-// ../../adapters/react/src/shared/slot/invariant.ts
-function panic(message) {
-  throw new Error(message);
-}
-function invariant(condition, message) {
-  if (!condition) panic(message);
-}
-
-// ../../adapters/react/src/shared/slot/applySlot.ts
-import { isValidElement as isValidElement3 } from "react";
-
-// ../../adapters/react/src/shared/slot/extractSlottable.ts
-import { createElement, Fragment as Fragment2, isValidElement as isValidElement2 } from "react";
-
-// ../../adapters/react/src/shared/slot/predicates.ts
-import { isValidElement } from "react";
-function isSlottableElement(value) {
-  return isValidElement(value) && value.type === Slottable;
-}
-
-// ../../adapters/react/src/shared/slot/extractSlottable.ts
-function extractSlottable(children) {
-  const childrenArray = Array.isArray(children) ? children : [children];
-  const slottables = childrenArray.filter(isSlottableElement);
-  invariant(slottables.length <= 1, "Slot: multiple Slottable children are not allowed");
-  if (slottables.length === 0) {
-    return null;
-  }
-  const [slottable] = slottables;
-  invariant(slottable, "Missing Slottable element");
-  const child = slottable.props.children;
-  invariant(
-    child !== null && child !== void 0,
-    "Slottable expects exactly one React element child, received null"
-  );
-  invariant(
-    typeof child !== "string" && typeof child !== "number",
-    "Slottable expects exactly one React element child, received text content"
-  );
-  invariant(isValidElement2(child), "Slottable expects exactly one React element child");
-  invariant(child.type !== Fragment2, "Slottable child cannot be a Fragment");
-  const index = childrenArray.indexOf(slottable);
-  return {
-    child,
-    // Fragment wrapper: Slot owns no DOM node; ref composition happens only on the merge target.
-    rebuild(merged) {
-      const out = childrenArray.map((node, i) => i === index ? merged : node);
-      return createElement(Fragment2, null, ...out);
-    }
-  };
-}
-
-// ../../adapters/react/src/shared/slot/applySlot.ts
-function applySlot(children, slotProps, ref, cloneSlotChild) {
-  const extraction = extractSlottable(children);
-  if (extraction) {
-    const merged = cloneSlotChild({ child: extraction.child, slotProps, ref });
-    return extraction.rebuild(merged);
-  }
-  invariant(isValidElement3(children), "Slot: child must be a valid React element");
-  return cloneSlotChild({ child: children, slotProps, ref });
+// ../../lib/adapter-utils/src/define-component.ts
+function defineContractComponent(options) {
+  return (factory) => factory(options);
 }
 
 // ../../lib/adapter-utils/src/apply-filter.ts
@@ -125,7 +14,7 @@ function applyFilter(props, filterProps, variantKeys) {
   return out;
 }
 
-// ../core/dist/chunk-XFCAUPVZ.js
+// ../core/dist/chunk-KKSHJDE7.js
 function makeResolveTag(defaultTag) {
   return function tag(as) {
     return as ?? defaultTag;
@@ -156,11 +45,11 @@ function mergeProps(defaultProps, props) {
     ...props
   };
 }
-function isNull2(value) {
+function isNull(value) {
   return value === null;
 }
-function isObject2(value) {
-  return !isNull2(value) && typeof value === "object";
+function isObject(value) {
+  return !isNull(value) && typeof value === "object";
 }
 function isString(value) {
   return typeof value === "string";
@@ -194,7 +83,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),
@@ -235,10 +124,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);
@@ -274,12 +163,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) {
@@ -296,7 +185,7 @@ function validateRenderProps(options, props, presetKey) {
     }
   }
 }
-function panic2(message) {
+function panic(message) {
   throw new Error(message);
 }
 function describe(value) {
@@ -306,21 +195,21 @@ function describe(value) {
 }
 function assertPluginShape(result) {
   if (result === null || typeof result !== "object")
-    panic2(
+    panic(
       `[praxis-kit] Plugin factory must return an object with a 'pipeline' function. Got: ${result === null ? "null" : typeof result}.`
     );
   const plugin = result;
   if (typeof plugin.pipeline !== "function")
-    panic2(
+    panic(
       `[praxis-kit] Plugin factory return value is missing a 'pipeline' function. Got pipeline: ${typeof plugin.pipeline}.`
     );
 }
 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")
-      panic2(`[praxis-kit] Plugin pipeline must return a string. Got: ${describe(result)}.`);
+      panic(`[praxis-kit] Plugin pipeline must return a string. Got: ${describe(result)}.`);
     return result;
   };
 }
@@ -343,11 +232,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 };
@@ -696,7 +585,7 @@ function isKnownAriaRole(value) {
   return isString(value) && KNOWN_ARIA_ROLES_SET.has(value);
 }
 
-// ../core/dist/chunk-VU44HAB7.js
+// ../core/dist/chunk-BNVYTMYV.js
 var IMPLICIT_ROLE_RECORD2 = {
   article: "article",
   aside: "complementary",
@@ -727,14 +616,14 @@ function getImplicitRole(tag) {
 }
 var COMPONENT_DEFAULT_TAG = /* @__PURE__ */ Symbol("praxis.component-default-tag");
 function resolveChildTag(child) {
-  if (!isObject2(child) || !("type" in child)) return void 0;
+  if (!isObject(child) || !("type" in child)) return void 0;
   const t = child.type;
   if (isString(t)) return t;
-  if (isObject2(t) && COMPONENT_DEFAULT_TAG in t) {
+  if (isObject(t) && COMPONENT_DEFAULT_TAG in t) {
     const defaultTag = t[COMPONENT_DEFAULT_TAG];
     if (!isString(defaultTag)) return void 0;
     const props = child.props;
-    const as = isObject2(props) && "as" in props ? props.as : void 0;
+    const as = isObject(props) && "as" in props ? props.as : void 0;
     return isString(as) ? as : defaultTag;
   }
   return void 0;
@@ -791,7 +680,7 @@ var StrictBase = class {
     }
   }
 };
-function isNull3(value) {
+function isNull2(value) {
   return value === null;
 }
 var VALID = [{ valid: true }];
@@ -946,7 +835,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends StrictBase {
   }
   validate(tag, props) {
     const key = _AriaPolicyEngine.#createPlanKey(tag, props);
-    if (!isNull3(key)) {
+    if (!isNull2(key)) {
       const cached = this.#planCache.get(key);
       if (cached !== void 0) {
         this.#planCache.delete(key);
@@ -960,7 +849,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends StrictBase {
     }
     const result = this.#extraRules.length ? _AriaPolicyEngine.#evaluateWithRules(tag, props, this.#extraRules) : _AriaPolicyEngine.evaluate(tag, props);
     if (result.violations.length > 0) this.report(result.violations);
-    if (!isNull3(key)) {
+    if (!isNull2(key)) {
       const { removals, updates } = _AriaPolicyEngine.#computePlan(
         props,
         result.props
@@ -1243,7 +1132,7 @@ function normalizeChildRule(rule) {
   };
 }
 function getChildType(child) {
-  if (!isObject2(child) || !("type" in child)) return void 0;
+  if (!isObject(child) || !("type" in child)) return void 0;
   return child.type;
 }
 function buildPartialIndex(rules) {
@@ -1553,7 +1442,7 @@ function landmarkRoleRule({ tag, props, implicitRole }) {
 var HTML_ARIA_RULES = [landmarkRoleRule];
 function isOpenContent(...blockedTags) {
   const set = new Set(blockedTags);
-  return (child) => isObject2(child) && "type" in child && (!isString(child.type) || !set.has(child.type));
+  return (child) => isObject(child) && "type" in child && (!isString(child.type) || !set.has(child.type));
 }
 var METADATA_TAGS = ["script", "template"];
 var metadataMatch = isTag(...METADATA_TAGS);
@@ -1721,7 +1610,7 @@ function enforceAllowedAs(tag, allowedAs, strict, displayName) {
   }
 }
 
-// ../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) => {
@@ -1798,18 +1687,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];
@@ -1821,7 +1710,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;
@@ -1829,10 +1718,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 });
   }
@@ -1840,15 +1729,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])}`;
     }
@@ -1873,13 +1762,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);
@@ -1951,6 +1840,30 @@ var SlotValidator = class extends StrictBase {
   }
 };
 
+// ../../lib/primitive/src/utils/is-object.ts
+function isNull3(value) {
+  return value === null;
+}
+function isObject2(value) {
+  return !isNull3(value) && typeof value === "object";
+}
+
+// ../../lib/primitive/src/merge/constants.ts
+var EVENT_HANDLER_RE = /^on[A-Z]/;
+
+// ../../lib/primitive/src/merge/predicates.ts
+function isFunction(value) {
+  return typeof value === "function";
+}
+function isPlainObject(value) {
+  if (!isObject2(value)) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+
+// ../shared/src/constants/primitive/slot-name.ts
+var SLOT_NAME = "Slot";
+
 // ../../lib/adapter-utils/src/slot/policies.ts
 import { clsx as clsx2 } from "clsx";
 function chainHandlers(childHandler, slotHandler) {
@@ -1995,6 +1908,98 @@ function applyMergePolicy(key, slotVal, childVal) {
   return policyHandlers[classifyProp(key, slotVal, childVal)](slotVal, childVal);
 }
 
+// ../../adapters/react/src/shared/merge-refs.ts
+function mergeRefs(...refs) {
+  const active = refs.filter((r2) => r2 != null);
+  if (active.length === 0) return null;
+  if (active.length === 1) return active[0];
+  return (value) => {
+    for (const ref of active) {
+      if (typeof ref === "function") {
+        ref(value);
+      } else {
+        ref.current = value;
+      }
+    }
+  };
+}
+
+// ../../adapters/react/src/shared/slot/Slottable.tsx
+import { Fragment } from "react";
+import { jsx } from "react/jsx-runtime";
+function Slottable({ children }) {
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+
+// ../../adapters/react/src/shared/slot/clone.ts
+import { cloneElement } from "react";
+function cloneWithProps(child, props, ref) {
+  return cloneElement(child, ref !== null ? { ...props, ref } : props);
+}
+
+// ../../adapters/react/src/shared/slot/invariant.ts
+function panic2(message) {
+  throw new Error(message);
+}
+function invariant(condition, message) {
+  if (!condition) panic2(message);
+}
+
+// ../../adapters/react/src/shared/slot/applySlot.ts
+import { isValidElement as isValidElement3 } from "react";
+
+// ../../adapters/react/src/shared/slot/extractSlottable.ts
+import { createElement, Fragment as Fragment2, isValidElement as isValidElement2 } from "react";
+
+// ../../adapters/react/src/shared/slot/predicates.ts
+import { isValidElement } from "react";
+function isSlottableElement(value) {
+  return isValidElement(value) && value.type === Slottable;
+}
+
+// ../../adapters/react/src/shared/slot/extractSlottable.ts
+function extractSlottable(children) {
+  const childrenArray = Array.isArray(children) ? children : [children];
+  const slottables = childrenArray.filter(isSlottableElement);
+  invariant(slottables.length <= 1, "Slot: multiple Slottable children are not allowed");
+  if (slottables.length === 0) {
+    return null;
+  }
+  const [slottable] = slottables;
+  invariant(slottable, "Missing Slottable element");
+  const child = slottable.props.children;
+  invariant(
+    child !== null && child !== void 0,
+    "Slottable expects exactly one React element child, received null"
+  );
+  invariant(
+    typeof child !== "string" && typeof child !== "number",
+    "Slottable expects exactly one React element child, received text content"
+  );
+  invariant(isValidElement2(child), "Slottable expects exactly one React element child");
+  invariant(child.type !== Fragment2, "Slottable child cannot be a Fragment");
+  const index = childrenArray.indexOf(slottable);
+  return {
+    child,
+    // Fragment wrapper: Slot owns no DOM node; ref composition happens only on the merge target.
+    rebuild(merged) {
+      const out = childrenArray.map((node, i) => i === index ? merged : node);
+      return createElement(Fragment2, null, ...out);
+    }
+  };
+}
+
+// ../../adapters/react/src/shared/slot/applySlot.ts
+function applySlot(children, slotProps, ref, cloneSlotChild) {
+  const extraction = extractSlottable(children);
+  if (extraction) {
+    const merged = cloneSlotChild({ child: extraction.child, slotProps, ref });
+    return extraction.rebuild(merged);
+  }
+  invariant(isValidElement3(children), "Slot: child must be a valid React element");
+  return cloneSlotChild({ child: children, slotProps, ref });
+}
+
 // ../../adapters/react/src/shared/slot/slot-validator.ts
 var SlotValidator2 = class extends SlotValidator {
   constructor(name, strict) {
@@ -2058,7 +2063,7 @@ function buildRenderState(tag, directives, props, className, children) {
   return state;
 }
 function resolveRenderState(runtime, props, filterProps) {
-  const { as, asChild, render: _render, children, className, variantKey, ...rest } = props;
+  const { as, asChild, render: _render, children, className, recipe, ...rest } = props;
   const tag = runtime.resolveTag(as);
   if (runtime.options.allowedAs !== void 0 && as !== void 0) {
     enforceAllowedAs(
@@ -2072,7 +2077,7 @@ function resolveRenderState(runtime, props, filterProps) {
   const baseProps = runtime.options.normalizeFn ? runtime.options.normalizeFn(mergedProps) : mergedProps;
   const htmlNormalizers = runtime.options.htmlPropNormalizersFn?.(tag);
   const normalizedProps = htmlNormalizers?.length ? htmlNormalizers.reduce((acc, fn) => ({ ...acc, ...fn(acc) }), baseProps) : baseProps;
-  const resolvedClass = runtime.resolveClasses(tag, normalizedProps, className, variantKey);
+  const resolvedClass = runtime.resolveClasses(tag, normalizedProps, className, recipe);
   const filteredProps = applyFilter(normalizedProps, filterProps, runtime.options.variantKeys);
   return buildRenderState(tag, buildDirectives(as, asChild), filteredProps, resolvedClass, children);
 }
@@ -2186,6 +2191,7 @@ function createContractedPolymorphic(options = {}) {
 export {
   createPolymorphic,
   createContractedPolymorphic,
+  defineContractComponent,
   buildEngines,
   composeFilter,
   isFunction,

package/dist/contract/index.d.ts

@@ -11,6 +11,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>;
@@ -21,6 +23,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';
@@ -53,9 +59,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>>;
 
@@ -69,19 +75,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> {
@@ -108,25 +111,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>>;
 
@@ -201,10 +204,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>;
@@ -215,8 +218,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>>;

package/dist/contract/index.js

@@ -1,4 +1,4 @@
-// ../core/dist/chunk-XFCAUPVZ.js
+// ../core/dist/chunk-KKSHJDE7.js
 function assertNever(value) {
   throw new Error(`Unexpected value: ${String(value)}`);
 }
@@ -321,7 +321,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",