@splenddev/kreativ-core 0.1.7 → 0.1.9

package/dist/{chunk-Q5PIXJRW.js → chunk-JIJ42ZVR.js}

@@ -29,15 +29,19 @@ function useValidateChildren(parentKey, children) {
     if (!roleOk && !slotOk) {
       const name = type.displayName ?? "component";
       console.warn(
-        `[kreativ-ui] ${String(parentKey)} received an unexpected child "${name}" (role: ${meta.role ?? "none"}, groupSlot: ${meta.groupSlot ?? "none"}). Expected role in [${allowedRoles.join(", ")}] or groupSlot in [${allowedSlots.join(", ")}].`
+        `[kreativ-core] ${String(parentKey)} received an unexpected child "${name}" (role: ${meta.role ?? "none"}, groupSlot: ${meta.groupSlot ?? "none"}). Expected role in [${allowedRoles.join(", ")}] or groupSlot in [${allowedSlots.join(", ")}].`
       );
     }
   });
 }
 var KUI_CHILDREN_REGISTRY_ALLOWED = {
   ButtonGroup: { roles: ["action"], slots: ["ButtonGroup"] },
-  List: { roles: [], slots: ["List"] }
+  List: { roles: [], slots: ["List"] },
+  Card: { roles: ["layout"], slots: ["Card"] }
 };
+function isMotionGated(props) {
+  return props["data-kui-motion-gated"] === true || props["data-kui-motion-gated"] === "true";
+}
 
 // src/utils/composeRefs.ts
 function composeRefs(...refs) {
@@ -397,6 +401,67 @@ function warnOnFlatCompoundConflict({
   return childIsPresent;
 }
 
-export { composeRefs, createComponent, createFromProps, deepMerge, hasKuiMeta, isResponsiveValue, mergeResponsiveValue, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveTokenReference, resolveTokens, resolveTypography, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict };
-//# sourceMappingURL=chunk-Q5PIXJRW.js.map
-//# sourceMappingURL=chunk-Q5PIXJRW.js.map
+// src/utils/atomicStyle.ts
+function resolveToken(value) {
+  if (typeof value !== "string") return value;
+  const match = /^\{(.+)\}$/.exec(value.trim());
+  if (!match || match[1] === void 0) return value;
+  const path = match[1].trim().replace(/\./g, "-");
+  return `var(--kui-${path})`;
+}
+function kebabCase(prop) {
+  return prop.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function serializeStyle(style) {
+  return Object.entries(style).filter(([, value]) => value !== null && value !== void 0).map(([prop, value]) => [kebabCase(prop), resolveToken(value)]).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([prop, value]) => `${prop}:${value}`).join(";");
+}
+function hashStyle(input) {
+  let hash = 5381;
+  for (let i = 0; i < input.length; i++) {
+    hash = (hash * 33 ^ input.charCodeAt(i)) >>> 0;
+  }
+  return hash.toString(36);
+}
+var STYLE_ELEMENT_ATTR = "data-kui";
+var styleElement = null;
+function getStyleElement() {
+  if (typeof document === "undefined") return null;
+  if (styleElement && styleElement.isConnected) return styleElement;
+  const existing = document.querySelector(
+    `style[${STYLE_ELEMENT_ATTR}]`
+  );
+  if (existing) {
+    styleElement = existing;
+    return styleElement;
+  }
+  const el = document.createElement("style");
+  el.setAttribute(STYLE_ELEMENT_ATTR, "");
+  document.head.appendChild(el);
+  styleElement = el;
+  return styleElement;
+}
+function injectStyle(className, declarations) {
+  const el = getStyleElement();
+  if (!el) return;
+  el.appendChild(document.createTextNode(`.${className}{${declarations}}`));
+}
+var styleRegistry = /* @__PURE__ */ new Map();
+function registerStyle(className, declarations) {
+  if (styleRegistry.has(className)) return;
+  styleRegistry.set(className, true);
+  injectStyle(className, declarations);
+}
+function cssToClass(style) {
+  const declarations = serializeStyle(style);
+  const className = `kui-${hashStyle(declarations)}`;
+  registerStyle(className, declarations);
+  return className;
+}
+function resolveStyle(value) {
+  if (typeof value === "string") return value;
+  return cssToClass(value);
+}
+
+export { composeRefs, createComponent, createFromProps, cssToClass, deepMerge, hasKuiMeta, hashStyle, injectStyle, isMotionGated, isResponsiveValue, kebabCase, mergeResponsiveValue, registerStyle, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveStyle, resolveToken, resolveTokenReference, resolveTokens, resolveTypography, serializeStyle, styleRegistry, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict };
+//# sourceMappingURL=chunk-JIJ42ZVR.js.map
+//# sourceMappingURL=chunk-JIJ42ZVR.js.map

package/dist/chunk-JIJ42ZVR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/createComponent.tsx","../src/utils/composeRefs.ts","../src/utils/createFromProps.ts","../src/utils/responsive.ts","../src/utils/deepMerge.ts","../src/utils/resolveTokenReference.ts","../src/utils/resolveTypography.ts","../src/utils/cssVariables.ts","../src/utils/warnOnFlatCompoundConflict.ts","../src/utils/atomicStyle.ts"],"names":["value","resolveValue","React2"],"mappings":"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","file":"chunk-JIJ42ZVR.js","sourcesContent":["import * as React from \"react\";\nimport { MotionGatedProps } from \"..\";\n\n/**\n * Describes the common states a component can support.\n *\n * These flags are used by Kreativ UI to communicate states such as\n * disabled, invalid, and required to consumers and supporting utilities.\n *\n * Additional state flags may be added by components when needed.\n */\nexport interface KuiSupports {\n  disabled?: boolean;\n  invalid?: boolean;\n  required?: boolean;\n  [key: string]: boolean | undefined;\n}\n\n/**\n * Describes the visual shape a component should use when represented\n * as a skeleton.\n *\n * Custom string values can be used when a component needs a specialized\n * skeleton representation.\n */\nexport type KuiSkeletonHint =\n  | \"text\"\n  | \"rect\"\n  | \"circle\"\n  | \"input-shaped\"\n  | \"preserve\"\n  | (string & {});\n\n/**\n * Identifies the primary purpose of a component.\n *\n * The role helps Kreativ UI and supporting tools understand how a\n * component behaves and how it should be treated in different contexts.\n */\nexport type KuiRole =\n  | \"action\"\n  | \"formControl\"\n  | \"overlay\"\n  | \"layout\"\n  | \"display\"\n  | \"disclosure\"\n  | \"navigation\"\n  | (string & {});\n\n/**\n * Interaction states that can be represented by a component.\n */\nexport type KuiInteractionState = \"hover\" | \"focus\" | \"pressed\";\n\n/**\n * Describes how a component can participate in Kreativ Forge.\n *\n * Components can optionally provide this metadata to enable video\n * editing and animation support without requiring Forge as a dependency.\n */\nexport interface KuiVideoMeta<P> {\n  /**\n   * Stable identifier used to reference the component in Forge projects.\n   */\n  id: string;\n\n  /**\n   * Indicates whether Forge can safely control and render the component.\n   *\n   * Components marked as unsafe are excluded from Forge's interactive\n   * component controls.\n   */\n  safe: boolean;\n\n  /**\n   * Indicates whether the component can contain other Forge elements.\n   */\n  acceptsChildren?: boolean;\n\n  /**\n   * Indicates that the component depends on context provided by\n   * an ancestor component.\n   */\n  needsParentContext?: boolean;\n\n  /**\n   * Identifies props that can reference project assets.\n   *\n   * Forge uses these declarations to provide the appropriate asset\n   * selection and resolution behavior.\n   */\n  assetProps?: Record<\n    string,\n    \"image\" | \"video\" | \"audio\" | \"font\" | \"snippet\" | \"icon\"\n  >;\n\n  /**\n   * Lists props whose values can be controlled by Forge.\n   */\n  controlled?: Array<keyof P>;\n\n  /**\n   * Specifies which interaction states Forge can represent for the component.\n   */\n  interactionStates?: KuiInteractionState[];\n\n  /**\n   * Indicates the component's motion is gated by Forge at render-start\n   * (timers/transitions/uncontrolled animation disabled during render),\n   * rather than driven as a per-frame controlled prop. Components marked\n   * `safe: true` must honor this gate.\n   */\n  motionGated?: boolean;\n}\n\n/**\n * Metadata describing a Kreativ UI component's capabilities and behavior.\n *\n * This metadata is attached to components and can be used by Kreativ UI,\n * development tools, and integrations such as Kreativ Forge.\n */\nexport interface KuiMeta<P = any> {\n  /**\n   * Identifies whether the component is a single or compound form control.\n   */\n  formControl?: \"single\" | \"compound\";\n\n  /**\n   * Describes the states supported by the component.\n   */\n  supports?: KuiSupports;\n\n  /**\n   * Defines the skeleton representation used while the component loads.\n   */\n  skeleton?: KuiSkeletonHint;\n\n  /**\n   * Identifies the component's primary role.\n   */\n  role?: KuiRole;\n\n  /**\n   * Identifies the component's slot when it participates in a compound component.\n   */\n  groupSlot?: string;\n\n  /**\n   * Optional Kreativ Forge integration metadata.\n   */\n  video?: KuiVideoMeta<P>;\n\n  /**\n   * Allowlist of props exposed in Forge's Properties tab, with the\n   * synthesized-group each belongs to.\n   */\n  editableProps?: Array<{\n    prop: keyof P;\n    group: string;\n    label?: string;\n  }>;\n\n  /**\n   * Declares which prop resolves typography (via Kui's `resolveTypography`),\n   * letting Forge synthesize a Typography group wired to that prop.\n   */\n  typographyProp?: {\n    prop: keyof P;\n    allowedPresets?: string[] | \"all\";\n    allowCustom?: boolean;\n    allowTokenReferences?: boolean;\n    customFields?: {\n      fontFamily?: boolean;\n      fontSize?: boolean;\n      fontWeight?: boolean;\n      lineHeight?: boolean;\n      letterSpacing?: boolean;\n    };\n  };\n\n  /**\n   * Declares which prop resolves a semantic color token, letting Forge\n   * synthesize a Color group wired to that prop.\n   */\n  colorProp?: {\n    prop: keyof P;\n    allowedTokens?: string[] | \"all\";\n  };\n\n  /**\n   * Declares which prop resolves a size-scale token, letting Forge\n   * synthesize a Size group wired to that prop.\n   */\n  sizeProp?: {\n    prop: keyof P;\n    allowedSizes?: string[] | \"all\";\n  };\n}\n\n/**\n * A Kreativ UI component created with `createComponent`.\n *\n * In addition to normal React component behavior, Kreativ UI components\n * expose metadata describing their capabilities and role.\n */\nexport type KuiComponent<P, E> = React.ForwardRefExoticComponent<\n  React.PropsWithoutRef<P> & React.RefAttributes<E>\n> & {\n  __kui: KuiMeta<P>;\n\n  /**\n   * Describes a provider required by the component.\n   */\n  providerRequired?: KuiProviderRequirement;\n};\n\n/**\n * Configuration used to create a Kreativ UI component.\n */\nexport interface CreateComponentConfig<P, E> {\n  /**\n   * Metadata describing the component's capabilities and behavior.\n   */\n  __kui: KuiMeta<P>;\n\n  /**\n   * Renders the component and receives its forwarded ref.\n   */\n  render: (props: P, ref: React.ForwardedRef<E>) => React.ReactElement | null;\n\n  /**\n   * Optional name used when displaying the component in development tools.\n   */\n  displayName?: string;\n}\n\n/**\n * Creates a Kreativ UI component with forwarded-ref support and\n * Kreativ UI metadata.\n *\n * @param config Component rendering function and metadata.\n * @returns A React component with Kreativ UI metadata attached.\n */\nexport function createComponent<P extends object, E = unknown>(\n  config: CreateComponentConfig<P, E>,\n): KuiComponent<P, E> {\n  const C = React.forwardRef(\n    config.render as unknown as React.ForwardRefRenderFunction<E, any>,\n  ) as unknown as KuiComponent<P, E>;\n\n  if (config.displayName) C.displayName = config.displayName;\n\n  C.__kui = config.__kui;\n  return C;\n}\n\n/**\n * Checks whether a value is a Kreativ UI component with component metadata.\n *\n * Useful when working with component types dynamically, such as when\n * inspecting children of compound components.\n *\n * @param value Value to inspect.\n * @returns `true` when the value contains valid Kreativ UI metadata.\n */\nexport function hasKuiMeta(value: unknown): value is { __kui: KuiMeta } {\n  return (\n    (typeof value === \"function\" ||\n      (typeof value === \"object\" && value !== null)) &&\n    \"__kui\" in (value as object) &&\n    typeof (value as { __kui: unknown }).__kui === \"object\" &&\n    (value as { __kui: unknown }).__kui !== null\n  );\n}\n\n/**\n * Lists the provider families available to Kreativ UI components.\n *\n * `controlled` is the provider state a child may declare via\n * `requireProvider`, not Forge `video.controlled` (that list is keyof props).\n */\nexport interface KuiProviderRegistry {\n  \"Popover.Root\": { controlled: \"open\" };\n  \"Menu.Root\": { controlled: \"open\" };\n  \"Form.Root\": { controlled: \"values\" };\n  \"FormField.Root\": { controlled: \"invalid\" };\n  \"Select.Root\": { controlled: \"value\" | \"open\" };\n}\n\n/**\n * Describes a provider that a component requires from its parent tree.\n */\nexport interface KuiProviderRequirement<\n  C extends keyof KuiProviderRegistry = keyof KuiProviderRegistry,\n> {\n  /**\n   * Identifies the provider component that must be present.\n   */\n  component: C;\n\n  /**\n   * Human-readable description of the provider requirement.\n   */\n  label: string;\n\n  /**\n   * Lists provider state values that can be controlled by the parent provider.\n   */\n  controlled?: Array<KuiProviderRegistry[C][\"controlled\"]>;\n}\n\n/**\n * Declares that a component requires a specific provider ancestor.\n *\n * Use this when a component is intended to be rendered as part of a\n * provider-based component such as Popover or Menu.\n *\n * @param component Provider component that must be present (e.g. \"Popover.Root\").\n * @param opts Provider requirement details (label, controlled state).\n * @returns A requirement descriptor; attach it via `component.providerRequired = ...`\n * or pass the target component separately depending on call site.\n */\nexport function requireProvider<C extends keyof KuiProviderRegistry>(\n  component: C,\n  opts: Omit<KuiProviderRequirement<C>, \"component\">,\n): KuiProviderRequirement<C> {\n  return { component, ...opts };\n}\n\n/**\n * Defines the child roles and slots accepted by a compound component.\n */\nexport interface KuiChildrenRegistry {\n  ButtonGroup: { roles: [\"action\"]; slots: [\"ButtonGroup\"] };\n  List: { roles: []; slots: [\"List\"] };\n  Card:{roles:[\"layout\"];slots:[\"Card\"]}\n}\n\n/**\n * Validates the direct children of a compound component during development.\n *\n * Unexpected children produce a development warning. Validation is skipped\n * in production builds.\n *\n * @param parentKey Compound component whose children are being validated.\n * @param children Children passed to the compound component.\n */\nexport function useValidateChildren<K extends keyof KuiChildrenRegistry>(\n  parentKey: K,\n  children: React.ReactNode,\n): void {\n  if (process.env.NODE_ENV === \"production\") return;\n\n  React.Children.forEach(children, (child) => {\n    if (!React.isValidElement(child)) return;\n\n    const type = child.type;\n\n    if (!hasKuiMeta(type)) return;\n\n    const meta = (type as { __kui: KuiMeta }).__kui;\n\n    const allowedRoles: readonly string[] =\n      KUI_CHILDREN_REGISTRY_ALLOWED[parentKey]?.roles ?? [];\n\n    const allowedSlots: readonly string[] =\n      KUI_CHILDREN_REGISTRY_ALLOWED[parentKey]?.slots ?? [];\n\n    const roleOk = meta.role ? allowedRoles.includes(meta.role) : false;\n\n    const slotOk = meta.groupSlot\n      ? allowedSlots.includes(meta.groupSlot)\n      : false;\n\n    if (!roleOk && !slotOk) {\n      const name =\n        (type as { displayName?: string }).displayName ?? \"component\";\n\n      console.warn(\n        `[kreativ-core] ${String(parentKey)} received an unexpected child \"${name}\" ` +\n          `(role: ${meta.role ?? \"none\"}, groupSlot: ${meta.groupSlot ?? \"none\"}). ` +\n          `Expected role in [${allowedRoles.join(\", \")}] or groupSlot in [${allowedSlots.join(\", \")}].`,\n      );\n    }\n  });\n}\n\nconst KUI_CHILDREN_REGISTRY_ALLOWED = {\n  ButtonGroup: { roles: [\"action\"], slots: [\"ButtonGroup\"] },\n  List: { roles: [], slots: [\"List\"] },\n  Card: { roles: [\"layout\"], slots: [\"Card\"] },\n} satisfies {\n  [K in keyof KuiChildrenRegistry]: {\n    roles: KuiChildrenRegistry[K][\"roles\"];\n    slots: KuiChildrenRegistry[K][\"slots\"];\n  };\n};\n\nexport function isMotionGated(props: MotionGatedProps): boolean {\n  return (\n    props[\"data-kui-motion-gated\"] === true ||\n    props[\"data-kui-motion-gated\"] === \"true\"\n  );\n}","import type * as React from \"react\";\ntype PossibleRef<T> = React.Ref<T> | undefined;\n\nexport function composeRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T> {\n  return (node) => {\n    for (const ref of refs) {\n      if (typeof ref === \"function\") ref(node);\n      else if (ref) (ref as React.MutableRefObject<T | null>).current = node;\n    }\n  };\n}\n","export interface CreateFromPropsInput<T extends object> {\n  providerDefaults?: Partial<T>;\n  defaultProps?: Partial<T>;\n  generatedProps?: Partial<T>;\n  consumerProps?: Partial<T>;\n}\nexport function createFromProps<T extends object>(input: CreateFromPropsInput<T>): T {\n  return {\n    ...input.providerDefaults,\n    ...input.defaultProps,\n    ...input.generatedProps,\n    ...input.consumerProps,\n  } as T;\n}\n","import type { BaseBreakpoint, ResponsiveValue } from \"@/types\";\n\nexport function isResponsiveValue<T>(\n  value: ResponsiveValue<T>,\n): value is Partial<Record<\"base\" | BaseBreakpoint, T>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport interface ResolvedResponsiveValue<T> {\n  base?: T;\n  responsive: Record<string, T>;\n}\n\nexport function resolveResponsiveValue<T, B extends string = string>(\n  value: ResponsiveValue<T, B>,\n): ResolvedResponsiveValue<T> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    return {\n      base: value,\n      responsive: {},\n    };\n  }\n\n  const responsiveValue = value as Partial<Record<\"base\" | B, T>>;\n\n  const { base, ...responsive } = responsiveValue;\n\n  return {\n    base,\n    responsive: Object.fromEntries(\n      Object.entries(responsive).filter(([, value]) => value !== undefined),\n    ) as Record<string, T>,\n  };\n}\n\nexport function toResponsiveClasses<T>(\n  value: ResolvedResponsiveValue<T>,\n  resolve: (value: T) => string,\n): string {\n  const classes: string[] = [];\n\n  if (value.base !== undefined) {\n    classes.push(resolve(value.base));\n  }\n\n  for (const [breakpoint, item] of Object.entries(value.responsive)) {\n    classes.push(\n      item\n        ? item\n            .toString()\n            .split(\" \")\n            .map((className) => `${breakpoint}:${className}`)\n            .join(\" \")\n        : \"\",\n    );\n  }\n\n  return classes.filter(Boolean).join(\" \");\n}\n\nexport function mergeResponsiveValue<T, B extends string = string>(\n  defaults: ResponsiveValue<T, B>,\n  value?: ResponsiveValue<T, B>,\n): ResolvedResponsiveValue<T> {\n  const defaultValue = resolveResponsiveValue(defaults);\n\n  if (value === undefined) {\n    return defaultValue;\n  }\n\n  const overrideValue = resolveResponsiveValue(value);\n\n  return {\n    base: overrideValue.base ?? defaultValue.base,\n    responsive: {\n      ...defaultValue.responsive,\n      ...overrideValue.responsive,\n    },\n  };\n}\n","function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function deepMerge<T>(base: T, override?: unknown): T {\n  if (override === undefined) {\n    return base;\n  }\n\n  if (!isPlainObject(base) || !isPlainObject(override)) {\n    return override as T;\n  }\n\n  const result: Record<string, unknown> = {\n    ...base,\n  };\n\n  for (const [key, value] of Object.entries(override)) {\n    const existing = result[key];\n\n    if (isPlainObject(existing) && isPlainObject(value)) {\n      result[key] = deepMerge(existing, value);\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result as T;\n}\n","import type { DesignTokens } from \"@/types\";\r\n\r\nexport function resolveTokenReference(\r\n  value: unknown,\r\n  tokens: DesignTokens,\r\n): string | number {\r\n  if (typeof value !== \"string\") {\r\n    return typeof value === \"number\" ? value : \"\";\r\n  }\r\n\r\n  const match = value.match(/^\\{(.+)\\}$/);\r\n\r\n  if (!match || match[1] === undefined) {\r\n    return value;\r\n  }\r\n\r\n  const path = match[1].split(\".\");\r\n\r\n  let current: unknown = tokens;\r\n\r\n  for (const key of path) {\r\n    if (typeof current !== \"object\" || current === null || !(key in current)) {\r\n      return \"\";\r\n    }\r\n\r\n    current = (current as Record<string, unknown>)[key];\r\n  }\r\n\r\n  if (typeof current === \"object\" && current !== null && \"value\" in current) {\r\n    const tokenValue = (current as { value: unknown }).value;\r\n\r\n    if (typeof tokenValue === \"string\" || typeof tokenValue === \"number\") {\r\n      return tokenValue;\r\n    }\r\n\r\n    return \"\";\r\n  }\r\n\r\n  return typeof current === \"string\" || typeof current === \"number\"\r\n    ? current\r\n    : \"\";\r\n}\r\n","import type { CSSProperties } from \"react\";\r\nimport type { DesignTokens, TypographyStyle } from \"@/types\";\r\nimport { resolveTokenReference } from \"./resolveTokenReference\";\r\n\r\nexport function resolveTypography(\r\n  typography: TypographyStyle | undefined,\r\n  tokens: DesignTokens,\r\n): CSSProperties {\r\n  if (!typography) return {};\r\n\r\n  return {\r\n    fontFamily: resolveTokenReference(typography.fontFamily, tokens) as string,\r\n    fontSize: resolveTokenReference(typography.fontSize, tokens) as string,\r\n    fontWeight: resolveTokenReference(typography.fontWeight, tokens),\r\n    lineHeight: resolveTokenReference(typography.lineHeight, tokens),\r\n    letterSpacing: resolveTokenReference(\r\n      typography.letterSpacing,\r\n      tokens,\r\n    ) as string,\r\n  };\r\n}\r\n","import type {\r\n  DesignTokens,\r\n  ResolvedTokens,\r\n  SemanticTokens,\r\n  TokenDefinition,\r\n} from \"@/types\";\r\n\r\nexport function toKebabCase(str: string): string {\r\n  return str.replace(/([a-z0-9])([A-Z])/g, \"$1-$2\").toLowerCase();\r\n}\r\nfunction colorToRgbChannels(value: string): string {\r\n  const trimmed = value.trim();\r\n\r\n  const rgbMatch = trimmed.match(\r\n    /^rgba?\\(\\s*(\\d+(?:\\.\\d+)?)\\s*[,\\s]\\s*(\\d+(?:\\.\\d+)?)\\s*[,\\s]\\s*(\\d+(?:\\.\\d+)?)(?:\\s*[/,]\\s*[\\d.]+%?)?\\s*\\)$/i,\r\n  );\r\n\r\n  if (rgbMatch) {\r\n    return `${rgbMatch[1]} ${rgbMatch[2]} ${rgbMatch[3]}`;\r\n  }\r\n\r\n  if (trimmed.startsWith(\"#\")) {\r\n    const hex = trimmed.slice(1);\r\n\r\n   if (hex.length === 3) {\r\n     const r = parseInt(hex.slice(0, 1).repeat(2), 16);\r\n     const g = parseInt(hex.slice(1, 2).repeat(2), 16);\r\n     const b = parseInt(hex.slice(2, 3).repeat(2), 16);\r\n\r\n     return `${r} ${g} ${b}`;\r\n   }\r\n\r\n    if (hex.length === 6) {\r\n      const r = parseInt(hex.slice(0, 2), 16);\r\n      const g = parseInt(hex.slice(2, 4), 16);\r\n      const b = parseInt(hex.slice(4, 6), 16);\r\n\r\n      return `${r} ${g} ${b}`;\r\n    }\r\n  }\r\n\r\n  if (/^\\d+(?:\\.\\d+)?\\s+\\d+(?:\\.\\d+)?\\s+\\d+(?:\\.\\d+)?$/.test(trimmed)) {\r\n    return trimmed;\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\nfunction getTokenValue(\r\n  reference: string,\r\n  tokens: DesignTokens,\r\n): string | number | undefined {\r\n  const path = reference.replace(/^\\{/, \"\").replace(/\\}$/, \"\").split(\".\");\r\n\r\n  let current: unknown = tokens;\r\n\r\n  for (const segment of path) {\r\n    if (\r\n      typeof current !== \"object\" ||\r\n      current === null ||\r\n      !(segment in current)\r\n    ) {\r\n      return undefined;\r\n    }\r\n\r\n    current = (current as Record<string, unknown>)[segment];\r\n  }\r\n\r\n  if (typeof current === \"object\" && current !== null && \"value\" in current) {\r\n    const value = (current as TokenDefinition).value;\r\n\r\n    if (typeof value === \"string\" || typeof value === \"number\") {\r\n      return value;\r\n    }\r\n  }\r\n\r\n  return undefined;\r\n}\r\n\r\nfunction resolveReference(\r\n  reference: string,\r\n  tokens: DesignTokens,\r\n  seen = new Set<string>(),\r\n): string | undefined {\r\n  if (seen.has(reference)) {\r\n    console.error(\r\n      `[kreativ-core] Circular token reference detected: ${reference}`,\r\n    );\r\n\r\n    return undefined;\r\n  }\r\n\r\n  const nextSeen = new Set(seen);\r\n  nextSeen.add(reference);\r\n\r\n  const value = getTokenValue(reference, tokens);\r\n\r\n  if (value === undefined) {\r\n    console.warn(\r\n      `[kreativ-core] Unable to resolve token reference: ${reference}`,\r\n    );\r\n\r\n    return undefined;\r\n  }\r\n\r\n  if (typeof value === \"number\") {\r\n    return String(value);\r\n  }\r\n\r\n  if (value.startsWith(\"{\") && value.endsWith(\"}\")) {\r\n    return resolveReference(value, tokens, nextSeen);\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\nfunction resolveValue(\r\n  value: unknown,\r\n  tokens: DesignTokens,\r\n): string | undefined {\r\n  if (typeof value === \"number\") {\r\n    return String(value);\r\n  }\r\n\r\n  if (typeof value !== \"string\") {\r\n    return undefined;\r\n  }\r\n\r\n  if (value.startsWith(\"{\") && value.endsWith(\"}\")) {\r\n    return resolveReference(value, tokens);\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\nfunction flattenTokens(\r\n  value: unknown,\r\n  path: string[],\r\n  result: ResolvedTokens,\r\n  tokens: DesignTokens,\r\n): void {\r\n  if (typeof value !== \"object\" || value === null) {\r\n    return;\r\n  }\r\n\r\n  if (\"value\" in value) {\r\n    const tokenValue = (value as TokenDefinition).value;\r\n\r\n    const resolved = resolveValue(tokenValue, tokens);\r\n\r\n    if (resolved !== undefined) {\r\n      result[path.join(\".\")] = resolved;\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  for (const [key, child] of Object.entries(value as Record<string, unknown>)) {\r\n    flattenTokens(child, [...path, key], result, tokens);\r\n  }\r\n}\r\n\r\nfunction resolveSemanticValue(\r\n  value: unknown,\r\n  mode: \"light\" | \"dark\",\r\n  tokens: DesignTokens,\r\n): string | undefined {\r\n  if (\r\n    typeof value === \"object\" &&\r\n    value !== null &&\r\n    \"light\" in value &&\r\n    \"dark\" in value\r\n  ) {\r\n    const modeValue = (\r\n      value as {\r\n        light: unknown;\r\n        dark: unknown;\r\n      }\r\n    )[mode];\r\n\r\n    return resolveValue(modeValue, tokens);\r\n  }\r\n\r\n  return resolveValue(value, tokens);\r\n}\r\n\r\nfunction resolveSemanticTokens(\r\n  semanticTokens: SemanticTokens,\r\n  tokens: DesignTokens,\r\n  mode: \"light\" | \"dark\",\r\n): ResolvedTokens {\r\n  const result: ResolvedTokens = {};\r\n\r\n  function walk(value: unknown, path: string[]): void {\r\n    if (typeof value !== \"object\" || value === null) {\r\n      return;\r\n    }\r\n\r\n    if (\"value\" in value) {\r\n      const semanticValue = (value as TokenDefinition).value;\r\n\r\n      const resolved = resolveSemanticValue(semanticValue, mode, tokens);\r\n\r\n      if (resolved !== undefined) {\r\n        result[path.join(\".\")] = resolved;\r\n      }\r\n\r\n      return;\r\n    }\r\n\r\n    for (const [key, child] of Object.entries(\r\n      value as Record<string, unknown>,\r\n    )) {\r\n      walk(child, [...path, key]);\r\n    }\r\n  }\r\n\r\n  walk(semanticTokens, []);\r\n\r\n  return result;\r\n}\r\n\r\nexport function resolveTokens(\r\n  tokens: DesignTokens,\r\n  semanticTokens: SemanticTokens,\r\n  mode: \"light\" | \"dark\",\r\n): ResolvedTokens {\r\n  const primitiveTokens: ResolvedTokens = {};\r\n\r\n  flattenTokens(tokens, [], primitiveTokens, tokens);\r\n\r\n  const resolvedSemanticTokens = resolveSemanticTokens(\r\n    semanticTokens,\r\n    tokens,\r\n    mode,\r\n  );\r\n\r\n  return {\r\n    ...primitiveTokens,\r\n    ...resolvedSemanticTokens,\r\n  };\r\n}\r\n\r\nexport function resolveSemanticTokenReferences(\r\n  tokens: DesignTokens,\r\n  semanticTokens: SemanticTokens,\r\n): SemanticTokens {\r\n  function resolveValue(value: unknown, seen = new Set<string>()): unknown {\r\n    if (typeof value === \"string\") {\r\n      if (!value.startsWith(\"{\") || !value.endsWith(\"}\")) {\r\n        return value;\r\n      }\r\n\r\n      if (seen.has(value)) {\r\n        console.error(\r\n          `[kreativ-core] Circular token reference detected: ${value}`,\r\n        );\r\n\r\n        return value;\r\n      }\r\n\r\n      const resolved = getTokenValue(value, tokens);\r\n\r\n      if (resolved === undefined) {\r\n        console.warn(\r\n          `[kreativ-core] Unable to resolve token reference: ${value}`,\r\n        );\r\n\r\n        return value;\r\n      }\r\n\r\n      const nextSeen = new Set(seen);\r\n      nextSeen.add(value);\r\n\r\n      return resolveValue(resolved, nextSeen);\r\n    }\r\n\r\n    if (Array.isArray(value)) {\r\n      return value.map((item) => resolveValue(item, seen));\r\n    }\r\n\r\n    if (typeof value === \"object\" && value !== null) {\r\n      return Object.fromEntries(\r\n        Object.entries(value).map(([key, child]) => [\r\n          key,\r\n          resolveValue(child, seen),\r\n        ]),\r\n      );\r\n    }\r\n\r\n    return value;\r\n  }\r\n\r\n  return resolveValue(semanticTokens) as SemanticTokens;\r\n}\r\n\r\nexport function tokensToCssVars(\r\n  tokens: ResolvedTokens,\r\n  mode: \"light\" | \"dark\",\r\n  intensity: number,\r\n  prefix = \"kui\",\r\n): Record<string, string> {\r\n  const cssVars: Record<string, string> = {};\r\n\r\n  for (const [path, value] of Object.entries(tokens)) {\r\n    const parts = path.split(\".\");\r\n    const [_first = \"\", second = \"\"] = parts;\r\n\r\n    const isSemanticColor = parts.length === 2 && parts[0] === \"colors\";\r\n\r\n    const isPrimitiveColor = parts.length >= 3 && parts[0] === \"colors\";\r\n\r\n    const varName = isSemanticColor\r\n      ? `--${prefix}-${toKebabCase(second)}`\r\n      : `--${prefix}-${parts.map(toKebabCase).join(\"-\")}`;\r\n\r\n    const outputValue =\r\n      isSemanticColor || isPrimitiveColor ? colorToRgbChannels(value) : value;\r\n\r\n    cssVars[varName] = outputValue;\r\n  }\r\n\r\n  return {\r\n    ...cssVars,\r\n\r\n    [`--${prefix}-mode`]: mode,\r\n    [`--${prefix}-intensity`]: String(intensity),\r\n  };\r\n}\r\n","import * as React from \"react\";\n\nexport interface WarnOnFlatCompoundConflictOptions {\n  /** The flat prop's value (or undefined/falsy if unset). */\n  flatValue: unknown;\n  /**\n   * Override for legitimately-falsy boolean flat props (e.g. a flat\n   * `open={false}` is still \"set\" and should be checked for conflict) —\n   * when provided, this takes precedence over checking flatValue's truthiness.\n   */\n  hasFlatValue?: boolean;\n  children: React.ReactNode;\n  /** The compound part's component reference to match against, e.g. FormField.Label */\n  matchType: React.ElementType;\n  componentName: string;\n  propName: string;\n  childName: string;\n}\n\n/**\n * Detects whether a flat prop (sugar for one specific named compound\n * part) and that same named child are both present in the same\n * render. Scoped ONLY to this named-flat-prop-vs-named-child\n * conflict — not the general flat-vs-compound API style choice\n * (e.g. Slider's flat-or-compound, which has no such conflict since\n * the two are mutually exclusive paths with no simultaneous-use case).\n *\n * Returns true when the matching named child is present, meaning the\n * caller should suppress its flat-prop-derived rendering and let the\n * explicit child win. Warns in dev when BOTH the flat prop and the\n * child are present, since that's very likely an authoring mistake.\n */\nexport function warnOnFlatCompoundConflict({\n  flatValue,\n  hasFlatValue,\n  children,\n  matchType,\n  componentName,\n  propName,\n  childName,\n}: WarnOnFlatCompoundConflictOptions): boolean {\n  const flatIsSet = hasFlatValue !== undefined ? hasFlatValue : Boolean(flatValue);\n\n  let childIsPresent = false;\n  React.Children.forEach(children, (child) => {\n    if (childIsPresent) return;\n    if (React.isValidElement(child) && child.type === matchType) {\n      childIsPresent = true;\n    }\n  });\n\n  if (flatIsSet && childIsPresent && process.env.NODE_ENV !== \"production\") {\n    console.warn(\n      `<${componentName}>: both the \\`${propName}\\` prop and a <${childName} /> child were provided. ` +\n        `The \\`${propName}\\` prop will be ignored in favor of the explicit <${childName} /> child. ` +\n        `Remove one of the two to resolve this warning.`\n    );\n  }\n\n  return childIsPresent;\n}\n","import { RecipeStyle, StyleObject, StyleValue } from \"@/types\";\r\n\r\n/**\r\n * Resolves a `{token.path}` reference to a CSS var() call. Any other value\r\n * passes through unchanged.\r\n *\r\n * \"{colors.brand.500}\" -> \"var(--kui-colors-brand-500)\"\r\n * \"1rem\"                -> \"1rem\" (passthrough)\r\n * 16                     -> 16 (passthrough)\r\n */\r\nexport function resolveToken(value: StyleValue): StyleValue {\r\n  if (typeof value !== \"string\") return value;\r\n\r\n  const match = /^\\{(.+)\\}$/.exec(value.trim());\r\n  if (!match || match[1] === undefined) return value;\r\n\r\n  const path = match[1].trim().replace(/\\./g, \"-\");\r\n  return `var(--kui-${path})`;\r\n}\r\n\r\n/**\r\n * Converts a camelCase CSS property name to kebab-case.\r\n * `\"backgroundColor\"` -> `\"background-color\"`\r\n */\r\nexport function kebabCase(prop: string): string {\r\n  return prop.replace(/([a-z0-9])([A-Z])/g, \"$1-$2\").toLowerCase();\r\n}\r\n\r\n/**\r\n * Serializes a StyleObject into a stable, sorted CSS declaration string.\r\n * Filters out null/undefined values, resolves token references, kebab-cases\r\n * property names, and sorts alphabetically by property name for a stable\r\n * hash regardless of key insertion order.\r\n */\r\nexport function serializeStyle(style: StyleObject): string {\r\n  return Object.entries(style)\r\n    .filter(([, value]) => value !== null && value !== undefined)\r\n    .map(([prop, value]) => [kebabCase(prop), resolveToken(value)] as const)\r\n    .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\r\n    .map(([prop, value]) => `${prop}:${value}`)\r\n    .join(\";\");\r\n}\r\n \r\nexport function hashStyle(input: string): string {\r\n  let hash = 5381;\r\n  for (let i = 0; i < input.length; i++) {\r\n    hash = ((hash * 33) ^ input.charCodeAt(i)) >>> 0;\r\n  }\r\n  return hash.toString(36);\r\n}\r\n \r\n \r\nconst STYLE_ELEMENT_ATTR = \"data-kui\";\r\n \r\nlet styleElement: HTMLStyleElement | null = null;\r\n \r\nfunction getStyleElement(): HTMLStyleElement | null {\r\n  if (typeof document === \"undefined\") return null;\r\n  if (styleElement && styleElement.isConnected) return styleElement;\r\n \r\n  const existing = document.querySelector<HTMLStyleElement>(\r\n    `style[${STYLE_ELEMENT_ATTR}]`,\r\n  );\r\n  if (existing) {\r\n    styleElement = existing;\r\n    return styleElement;\r\n  }\r\n \r\n  const el = document.createElement(\"style\");\r\n  el.setAttribute(STYLE_ELEMENT_ATTR, \"\");\r\n  document.head.appendChild(el);\r\n  styleElement = el;\r\n  return styleElement;\r\n}\r\n \r\n/**\r\n * Appends a raw CSS rule to the shared <style data-kui> tag.\r\n * No-ops in non-browser environments (document === undefined).\r\n */\r\nexport function injectStyle(className: string, declarations: string): void {\r\n  const el = getStyleElement();\r\n  if (!el) return;\r\n  el.appendChild(document.createTextNode(`.${className}{${declarations}}`));\r\n}\r\n \r\n/** Map-based dedup registry, keyed by generated class name. */\r\nexport const styleRegistry = new Map<string, true>();\r\n \r\n/**\r\n * Registers a class name's CSS if it hasn't been injected yet.\r\n * Safe to call repeatedly with the same className — only injects once.\r\n */\r\nexport function registerStyle(className: string, declarations: string): void {\r\n  if (styleRegistry.has(className)) return;\r\n  styleRegistry.set(className, true);\r\n  injectStyle(className, declarations);\r\n}\r\n \r\n \r\n/**\r\n * Serializes a StyleObject into CSS, hashes it into a stable `kui-<hash>`\r\n * class name, registers the backing rule (dedup'd), and returns the class\r\n * name for use in a className string.\r\n */\r\nexport function cssToClass(style: StyleObject): string {\r\n  const declarations = serializeStyle(style);\r\n  const className = `kui-${hashStyle(declarations)}`;\r\n  registerStyle(className, declarations);\r\n  return className;\r\n}\r\n \r\n\r\n \r\n/**\r\n * Resolves a single RecipeStyle value to a class-name-safe string.\r\n * Strings pass through unchanged; StyleObjects are routed through the\r\n * atomic-CSS pipeline and resolve to a generated class name.\r\n */\r\nexport function resolveStyle(value: RecipeStyle): string {\r\n  if (typeof value === \"string\") return value;\r\n  return cssToClass(value);\r\n}"]}

package/dist/hooks/index.d.ts

@@ -49,13 +49,42 @@ declare function useResponsiveStyles(responsiveStyles?: ResponsiveStyles): {
     style: string;
 };
 
+/**
+ * Options for {@link useSizeStyle}.
+ */
 interface UseSizeStyleOptions {
+    /**
+     * Include `height` in the resolved style.
+     * @default true
+     */
     includeHeight?: boolean;
+    /**
+     * Include `width` in the resolved style.
+     *
+     * When enabled, width is derived from the token's own `width` if
+     * `iconOnly` is set, otherwise from the token's `height`.
+     * @default false
+     */
     includeWidth?: boolean;
+    /**
+     * Force `width` to mirror `height`, even when not in icon-only mode.
+     * @default false
+     */
     widthFromHeight?: boolean;
+    /**
+     * CSS length subtracted from the resolved `height` / `width`
+     * (e.g. `"2px"`). Applied via `calc(...)`.
+     */
     sizeOffset?: string;
+    /**
+     * CSS length subtracted from the resolved `fontSize`.
+     * Applied via `calc(...)`.
+     */
     fontSizeOffset?: string;
 }
+/**
+ * Result of {@link useSizeStyle}.
+ */
 interface ResolvedSize {
     /**
      * Inline styles for non-responsive sizing.
@@ -68,13 +97,107 @@ interface ResolvedSize {
      * Styles generated for responsive sizing.
      */
     responsiveStyles?: ResponsiveStyles;
+    /** Resolved icon size, if defined on the token. */
     iconSize?: CSSProperties["width"];
+    /** Resolved font size, after applying `fontSizeOffset`. */
     fontSize?: CSSProperties["fontSize"];
+    /** Resolved gap between child elements. */
     gap?: CSSProperties["gap"];
 }
+/**
+ * Builds size-related inline styles from a theme size token.
+ *
+ * Accepts either a plain size name (e.g. `"md"`) or a responsive value
+ * (e.g. `{ base: "sm", lg: "md" }`). All token values are expanded through
+ * `resolveTokenReference`, so aliases like `"{spacing.4}"` become concrete
+ * values.
+ *
+ * Behavior notes:
+ * - Padding is skipped when `iconOnly` is `true`.
+ * - `gap` is forced to `0` when `iconOnly` is `true`.
+ * - The token's `radius` is exposed as the CSS variable
+ *   `--kui-<componentName>-radius` so consumers can reuse it in CSS.
+ * - For responsive inputs, breakpoint styles are returned in
+ *   `responsiveStyles` and `style` stays empty.
+ *
+ * @param size - Size name or responsive size object to resolve.
+ * @param iconOnly - When `true`, applies icon-specific sizing (square,
+ *   no horizontal padding, no gap).
+ * @param componentName - Namespace used for generated CSS variables.
+ * @param options - See {@link UseSizeStyleOptions}.
+ * @returns A {@link ResolvedSize} containing inline and/or responsive styles.
+ *
+ * @example
+ * ```ts
+ * const { style } = useSizeStyle("md");
+ * // <button style={style} />
+ * ```
+ *
+ * @example
+ * ```ts
+ * const { responsiveStyles } = useSizeStyle(
+ *   { base: "sm", lg: "md" },
+ *   false,
+ *   "button",
+ *   { includeWidth: true, sizeOffset: "2px" },
+ * );
+ * ```
+ */
 declare function useSizeStyle(size: ResponsiveValue<string>, iconOnly?: boolean, componentName?: string, options?: UseSizeStyleOptions): ResolvedSize;
 
+/**
+ * Resolves a size token from the active theme.
+ *
+ * Accepts either a plain size name (e.g. `"md"`) or a responsive value
+ * (e.g. `{ base: "md", lg: "xl" }`). When a responsive object is passed,
+ * the `base` key is used, falling back to the theme's `fallbackSize`.
+ *
+ * All token values are passed through `resolveTokenReference`, so token
+ * aliases like `"{spacing.4}"` are expanded to their concrete value.
+ *
+ * @param size - Size name or responsive size object to resolve.
+ * @returns The full resolved {@link SizeToken} for the requested size.
+ *
+ * @example
+ * ```ts
+ * const token = useSizeToken("md");
+ * // { height: "40px", paddingX: "16px", fontSize: "14px", ... }
+ * ```
+ *
+ * @example
+ * ```ts
+ * const token = useSizeToken({ base: "sm", lg: "md" });
+ * ```
+ */
 declare function useSizeToken(size: ResponsiveValue<string>): SizeToken;
+/**
+ * Resolves a single value from a size token.
+ *
+ * Like the object overload, this accepts a plain or responsive size name and
+ * expands token references. When `offset` is provided, the resolved value is
+ * wrapped in a `calc(...)` expression subtracting the offset — useful for
+ * trimming sizes without redefining a token.
+ *
+ * @typeParam K - The key of {@link SizeToken} to read (e.g. `"height"`, `"fontSize"`).
+ * @param size - Size name or responsive size object to resolve.
+ * @param key - The token field to read.
+ * @param offset - Optional CSS length to subtract from the resolved value.
+ * @returns The resolved (and optionally offset) token field.
+ *
+ * @example
+ * ```ts
+ * const height = useSizeToken("md", "height");
+ * // "40px"
+ *
+ * const height = useSizeToken("md", "height", "4px");
+ * // "calc(40px - 4px)"
+ * ```
+ *
+ * @example
+ * ```ts
+ * const fontSize = useSizeToken({ base: "sm", lg: "md" }, "fontSize");
+ * ```
+ */
 declare function useSizeToken<K extends keyof SizeToken>(size: ResponsiveValue<string>, key: K, offset?: string): SizeToken[K];
 
 declare function getSizes(theme: Theme): Size[];

package/dist/hooks/index.js

@@ -1,5 +1,5 @@
 import { ThemeContext, useTheme } from '../chunk-5CYSF7C3.js';
-import { isResponsiveValue, resolveTypography, resolveResponsiveValue } from '../chunk-Q5PIXJRW.js';
+import { isResponsiveValue, resolveTypography, resolveTokenReference, resolveResponsiveValue } from '../chunk-JIJ42ZVR.js';
 import * as React from 'react';
 import { useState, useEffect, useContext, useMemo, useId, useRef, useCallback } from 'react';
 
@@ -156,37 +156,46 @@ function useSizeStyle(size, iconOnly = false, componentName = "component", optio
   const { theme, fallbackSize } = useTheme();
   return useMemo(() => {
     const scale = theme.sizes;
+    const tokens = theme.tokens;
+    const resolveValue = (value) => String(resolveTokenReference(value, tokens));
     const resolveToken = (sizeName) => scale[sizeName] ?? scale[fallbackSize] ?? Object.values(scale)[0] ?? {};
     const buildStyle = (sizeName) => {
       const token2 = resolveToken(sizeName);
       const style = {};
-      if (includeHeight && token2.height) {
-        style.height = applySizeOffset(token2.height, sizeOffset);
+      const height = resolveValue(token2.height);
+      const width = resolveValue(token2.width);
+      const paddingX = resolveValue(token2.paddingX);
+      const paddingY = resolveValue(token2.paddingY);
+      const fontSize = resolveValue(token2.fontSize);
+      const gap = resolveValue(token2.gap);
+      const radius = resolveValue(token2.radius);
+      if (includeHeight && height) {
+        style.height = applySizeOffset(height, sizeOffset);
       }
       if (includeWidth) {
-        if (iconOnly && token2.width) {
-          style.width = applySizeOffset(token2.width, sizeOffset);
-        } else if ((iconOnly || widthFromHeight) && includeHeight && token2.height) {
-          style.width = applySizeOffset(token2.height, sizeOffset);
+        if (iconOnly && width) {
+          style.width = applySizeOffset(width, sizeOffset);
+        } else if ((iconOnly || widthFromHeight) && includeHeight && height) {
+          style.width = applySizeOffset(height, sizeOffset);
         }
       }
-      if (!iconOnly && token2.paddingX) {
-        style.paddingLeft = token2.paddingX;
-        style.paddingRight = token2.paddingX;
+      if (!iconOnly && paddingX) {
+        style.paddingLeft = paddingX;
+        style.paddingRight = paddingX;
       }
-      if (token2.paddingY) {
-        style.paddingTop = token2.paddingY;
-        style.paddingBottom = token2.paddingY;
+      if (paddingY) {
+        style.paddingTop = paddingY;
+        style.paddingBottom = paddingY;
       }
-      if (token2.fontSize) {
-        style.fontSize = applySizeOffset(token2.fontSize, fontSizeOffset);
+      if (fontSize) {
+        style.fontSize = applySizeOffset(fontSize, fontSizeOffset);
       }
-      if (token2.gap) {
-        style.gap = iconOnly ? 0 : token2.gap;
+      if (gap) {
+        style.gap = iconOnly ? 0 : gap;
       }
-      if (token2.radius) {
+      if (radius) {
         const varName = `--kui-${componentName}-radius`;
-        style[varName] = token2.radius;
+        style[varName] = radius;
       }
       return style;
     };
@@ -195,9 +204,9 @@ function useSizeStyle(size, iconOnly = false, componentName = "component", optio
       const token2 = resolveToken(size);
       return {
         style,
-        iconSize: token2.iconSize,
-        fontSize: applySizeOffset(token2.fontSize, fontSizeOffset),
-        gap: token2.gap
+        iconSize: resolveValue(token2.iconSize),
+        fontSize: applySizeOffset(resolveValue(token2.fontSize), fontSizeOffset),
+        gap: resolveValue(token2.gap)
       };
     }
     const { base, ...breakpoints } = size;
@@ -213,12 +222,12 @@ function useSizeStyle(size, iconOnly = false, componentName = "component", optio
     return {
       style: {},
       responsiveStyles,
-      iconSize: token.iconSize,
-      fontSize: applySizeOffset(token.fontSize, fontSizeOffset),
-      gap: token.gap
+      iconSize: resolveValue(token.iconSize),
+      fontSize: applySizeOffset(resolveValue(token.fontSize), fontSizeOffset),
+      gap: resolveValue(token.gap)
     };
   }, [
-    theme.sizes,
+    theme,
     size,
     fallbackSize,
     iconOnly,
@@ -243,13 +252,21 @@ function useSizeToken(size, key, offset) {
   const { theme, fallbackSize } = useTheme();
   return useMemo(() => {
     const scale = theme.sizes;
+    const tokens = theme.tokens;
     const baseSize = isResponsiveValue(size) ? size.base ?? fallbackSize : size;
     const token = scale[baseSize] ?? scale[fallbackSize] ?? Object.values(scale)[0] ?? {};
+    const resolve = (value) => value == null ? value : resolveTokenReference(value, tokens);
     if (!key) {
-      return token;
+      const resolved = Object.fromEntries(
+        Object.entries(token).map(([k, v]) => [k, resolve(v)])
+      );
+      return resolved;
     }
-    return applyOffset(token[key], offset);
-  }, [theme.sizes, size, fallbackSize, key, offset]);
+    return applyOffset(
+      resolve(token[key]),
+      offset
+    );
+  }, [theme, size, fallbackSize, key, offset]);
 }
 
 // src/hooks/useSizes.ts

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/useBreakpoint.ts","../../src/hooks/useColorMode.ts","../../src/hooks/useControllableState.ts","../../src/hooks/useMergedResponsiveStyles.ts","../../src/hooks/useResponsiveStyles.ts","../../src/hooks/useSizeStyle.ts","../../src/hooks/useSizeToken.ts","../../src/hooks/useSizes.ts","../../src/hooks/useTypography.ts","../../src/hooks/useUndoRedo.ts"],"names":["useMemo","token","useState","useRef","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["\"use client\";\r\n\r\nimport { BaseBreakpoint } from \"@/types\";\r\nimport { useEffect, useState } from \"react\";\r\n\r\nconst BREAKPOINTS: Record<BaseBreakpoint, number> = {\r\n  sm: 640,\r\n  md: 768,\r\n  lg: 1024,\r\n  xl: 1280,\r\n  \"2xl\": 1536,\r\n};\r\n\r\nexport function useBreakpoint(breakpoint: BaseBreakpoint): boolean {\r\n  const query = `(min-width: ${BREAKPOINTS[breakpoint]}px)`;\r\n  const [matches, setMatches] = useState(\r\n    () => typeof window !== \"undefined\" && window.matchMedia(query).matches,\r\n  );\r\n\r\n  useEffect(() => {\r\n    const mql = window.matchMedia(query);\r\n    const listener = (e: MediaQueryListEvent) => setMatches(e.matches);\r\n    mql.addEventListener(\"change\", listener);\r\n    setMatches(mql.matches);\r\n    return () => mql.removeEventListener(\"change\", listener);\r\n  }, [query]);\r\n\r\n  return matches;\r\n}\r\n","import { useContext } from \"react\";\nimport { ThemeContext } from \"../provider/ThemeContext\";\nimport { ColorMode } from \"@/types/theme\";\n\nexport interface UseColorModeReturn {\n  mode: ColorMode;\n  setMode: (mode: ColorMode) => void;\n  toggleColorMode: () => void;\n}\n\nexport function useColorMode(): UseColorModeReturn {\n  const ctx = useContext(ThemeContext);\n\n  if (!ctx) {\n    throw new Error(\"useColorMode must be used within a ThemeProvider\");\n  }\n\n  return {\n    mode: ctx.mode,\n    setMode: ctx.setMode,\n    toggleColorMode: () => {\n      throw new Error(\"not implemented\");\n    },\n  };\n}\n","import * as React from \"react\";\n\nexport interface UseControllableStateOptions<T> {\n  value?: T;\n  defaultValue: T;\n  onChange?: (next: T) => void;\n}\n\nexport function useControllableState<T>({\n  value,\n  defaultValue,\n  onChange,\n}: UseControllableStateOptions<T>): [T, (next: T) => void] {\n  const [internal, setInternal] = React.useState<T>(defaultValue);\n  const isControlled = value !== undefined;\n  const current = isControlled ? (value as T) : internal;\n  const currentRef = React.useRef(current);\n  currentRef.current = current;\n  const onChangeRef = React.useRef(onChange);\n  onChangeRef.current = onChange;\n\n  const set = React.useCallback(\n    (next: T) => {\n      if (Object.is(next, currentRef.current)) return;\n      if (!isControlled) setInternal(next);\n      onChangeRef.current?.(next);\n    },\n    [isControlled],\n  );\n  return [current, set];\n}\n","\"use client\";\r\n\r\nimport { useMemo } from \"react\";\r\nimport type { CSSProperties } from \"react\";\r\nimport type { ResponsiveValue, ResponsiveStyles } from \"@/types\";\r\nimport { resolveResponsiveValue } from \"@/utils/responsive\";\r\n\r\n/**\r\n * One entry: a responsive prop value plus a mapper from that value to a\r\n * partial CSSProperties object.\r\n *\r\n * Using `any` for the value type because different entries may have different\r\n * value types, and we only need to call the mapper with the resolved value.\r\n */\r\nexport type ResponsivePropEntry = [\r\n  value: ResponsiveValue<any> | undefined,\r\n  toCss: (value: any) => Partial<CSSProperties>,\r\n];\r\n\r\nfunction mergeResponsiveProps(\r\n  entries: ResponsivePropEntry[],\r\n): ResponsiveStyles {\r\n  const result: ResponsiveStyles = {};\r\n\r\n  for (const [value, toCss] of entries) {\r\n    if (value === undefined) continue;\r\n\r\n    const { base, responsive } = resolveResponsiveValue(value);\r\n\r\n    if (base !== undefined) {\r\n      result.base = { ...result.base, ...toCss(base) };\r\n    }\r\n\r\n    for (const [bp, v] of Object.entries(responsive)) {\r\n      result[bp] = { ...result[bp], ...toCss(v) };\r\n    }\r\n  }\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * Merges multiple ResponsiveValue<T> props into one ResponsiveStyles map,\r\n * memoized on the entries' values.\r\n *\r\n * @example\r\n * const responsiveStyles = useMergedResponsiveStyles([\r\n *   [gap, (v) => ({ gap: spaceVar(v) })],\r\n *   [align, (v) => ({ alignItems: v })],\r\n * ]);\r\n */\r\nexport function useMergedResponsiveStyles(\r\n  entries: ResponsivePropEntry[],\r\n): ResponsiveStyles {\r\n  // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  return useMemo(\r\n    () => mergeResponsiveProps(entries),\r\n    entries.map(([value]) => value),\r\n  );\r\n}\r\n","\"use client\";\r\n\r\nimport { type CSSProperties, useId, useMemo } from \"react\";\r\n\r\nimport type { ResponsiveStyles } from \"@/types\";\r\nimport { useTheme } from \"@/provider/useTheme\";\r\n\r\nconst cssPropertyToKebab = (property: string) =>\r\n  property.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);\r\n\r\nconst cssValue = (value: CSSProperties[keyof CSSProperties]) => {\r\n  if (typeof value === \"number\") {\r\n    return String(value);\r\n  }\r\n\r\n  return value;\r\n};\r\n\r\nexport function useResponsiveStyles(responsiveStyles?: ResponsiveStyles) {\r\n  const { theme } = useTheme();\r\n  const id = useId();\r\n\r\n  return useMemo(() => {\r\n    if (!responsiveStyles || Object.keys(responsiveStyles).length === 0) {\r\n      return {\r\n        attribute: undefined,\r\n        style: undefined,\r\n      };\r\n    }\r\n\r\n    const breakpoints = theme.tokens.breakpoints;\r\n\r\n    if (!breakpoints) {\r\n      return {\r\n        attribute: undefined,\r\n        style: undefined,\r\n      };\r\n    }\r\n\r\n    const attribute = id.replace(/:/g, \"\");\r\n\r\n    const selector = `[data-kui-responsive=\"${attribute}\"]`;\r\n\r\n    const rules: string[] = [];\r\n\r\n    for (const [breakpoint, styles] of Object.entries(responsiveStyles)) {\r\n      const declarations = Object.entries(styles)\r\n        .filter(([, value]) => value !== undefined)\r\n        .map(\r\n          ([property, value]) =>\r\n            `${cssPropertyToKebab(property)}:${cssValue(value)};`,\r\n        )\r\n        .join(\"\");\r\n\r\n      if (!declarations) continue;\r\n\r\n      if (breakpoint === \"base\") {\r\n        rules.push(`\r\n          ${selector} {\r\n            ${declarations}\r\n          }\r\n        `);\r\n\r\n        continue;\r\n      }\r\n\r\n      const breakpointToken = breakpoints[breakpoint];\r\n\r\n      if (!breakpointToken) continue;\r\n\r\n      rules.push(`\r\n        @media (min-width: ${breakpointToken.value}) {\r\n          ${selector} {\r\n            ${declarations}\r\n          }\r\n        }\r\n      `);\r\n    }\r\n\r\n    if (rules.length === 0) {\r\n      return {\r\n        attribute: undefined,\r\n        style: undefined,\r\n      };\r\n    }\r\n\r\n    return {\r\n      attribute,\r\n      style: rules.join(\"\\n\"),\r\n    };\r\n  }, [responsiveStyles, theme.tokens.breakpoints, id]);\r\n}\r\n","\"use client\";\n\nimport { useMemo, type CSSProperties } from \"react\";\n\nimport type {\n  CSSPropertiesWithVars,\n  ResponsiveStyles,\n  ResponsiveValue,\n} from \"@/types\";\nimport { isResponsiveValue } from \"@/utils/responsive\";\nimport { useTheme } from \"@/provider/useTheme\";\n\nexport interface UseSizeStyleOptions {\n  includeHeight?: boolean;\n  includeWidth?: boolean;\n  widthFromHeight?: boolean;\n  sizeOffset?: string;\n  fontSizeOffset?: string;\n}\n\nexport interface ResolvedSize {\n  /**\n   * Inline styles for non-responsive sizing.\n   *\n   * For responsive values this is intentionally empty so that\n   * breakpoint styles can override each other through CSS.\n   */\n  style: CSSProperties;\n\n  /**\n   * Styles generated for responsive sizing.\n   */\n  responsiveStyles?: ResponsiveStyles;\n\n  iconSize?: CSSProperties[\"width\"];\n  fontSize?: CSSProperties[\"fontSize\"];\n  gap?: CSSProperties[\"gap\"];\n}\n\nconst applySizeOffset = (\n  value: string | undefined,\n  offset: string | undefined,\n) => {\n  if (!value || !offset) return value;\n\n  return `calc(${value} - ${offset})`;\n};\n\nexport function useSizeStyle(\n  size: ResponsiveValue<string>,\n  iconOnly = false,\n  componentName = \"component\",\n  options: UseSizeStyleOptions = {},\n): ResolvedSize {\n  const {\n    widthFromHeight = false,\n    includeHeight = true,\n    includeWidth = false,\n    sizeOffset,\n    fontSizeOffset,\n  } = options;\n\n  const { theme, fallbackSize } = useTheme();\n\n  return useMemo(() => {\n    const scale = theme.sizes;\n\n    const resolveToken = (sizeName: string) =>\n      scale[sizeName] ?? scale[fallbackSize] ?? Object.values(scale)[0] ?? {};\n\n    const buildStyle = (sizeName: string): CSSPropertiesWithVars => {\n      const token = resolveToken(sizeName);\n      const style: CSSPropertiesWithVars = {};\n\n      if (includeHeight && token.height) {\n        style.height = applySizeOffset(token.height, sizeOffset);\n      }\n\n      if (includeWidth) {\n        if (iconOnly && token.width) {\n          style.width = applySizeOffset(token.width, sizeOffset);\n        } else if (\n          (iconOnly || widthFromHeight) &&\n          includeHeight &&\n          token.height\n        ) {\n          style.width = applySizeOffset(token.height, sizeOffset);\n        }\n      }\n\n      if (!iconOnly && token.paddingX) {\n        style.paddingLeft = token.paddingX;\n        style.paddingRight = token.paddingX;\n      }\n\n      if (token.paddingY) {\n        style.paddingTop = token.paddingY;\n        style.paddingBottom = token.paddingY;\n      }\n\n      if (token.fontSize) {\n        style.fontSize = applySizeOffset(token.fontSize, fontSizeOffset);\n      }\n\n      if (token.gap) {\n        style.gap = iconOnly ? 0 : token.gap;\n      }\n\n      if (token.radius) {\n        const varName = `--kui-${componentName}-radius` as `--kui-${string}`;\n\n        style[varName] = token.radius;\n      }\n\n      return style;\n    };\n\n    if (!isResponsiveValue(size)) {\n      const style = buildStyle(size);\n      const token = resolveToken(size);\n\n      return {\n        style,\n        iconSize: token.iconSize,\n        fontSize: applySizeOffset(token.fontSize, fontSizeOffset),\n        gap: token.gap,\n      };\n    }\n\n    const { base, ...breakpoints } = size;\n\n    const baseSize = base ?? fallbackSize;\n\n    const responsiveStyles: ResponsiveStyles = {\n      base: buildStyle(baseSize),\n    };\n\n    for (const [breakpoint, breakpointSize] of Object.entries(breakpoints)) {\n      if (breakpointSize === undefined) continue;\n\n      responsiveStyles[breakpoint] = buildStyle(breakpointSize);\n    }\n\n    const token = resolveToken(baseSize);\n\n    return {\n      style: {},\n      responsiveStyles,\n      iconSize: token.iconSize,\n      fontSize: applySizeOffset(token.fontSize, fontSizeOffset),\n      gap: token.gap,\n    };\n  }, [\n    theme.sizes,\n    size,\n    fallbackSize,\n    iconOnly,\n    includeHeight,\n    includeWidth,\n    widthFromHeight,\n    componentName,\n    sizeOffset,\n    fontSizeOffset,\n  ]);\n}\n","import type { ResponsiveValue, SizeToken } from \"@/types\";\r\n\r\nimport { useMemo } from \"react\";\r\nimport { useTheme } from \"@/provider/useTheme\";\r\nimport { isResponsiveValue } from \"@/utils/responsive\";\r\n\r\ntype SizeTokenValue = SizeToken[keyof SizeToken];\r\n\r\nfunction applyOffset(value: SizeTokenValue, offset?: string): SizeTokenValue {\r\n  if (offset == null || value == null) {\r\n    return value;\r\n  }\r\n\r\n  if (typeof value !== \"string\") {\r\n    return value;\r\n  }\r\n\r\n  return `calc(${value} - ${offset})`;\r\n}\r\n\r\nexport function useSizeToken(size: ResponsiveValue<string>): SizeToken;\r\n\r\nexport function useSizeToken<K extends keyof SizeToken>(\r\n  size: ResponsiveValue<string>,\r\n  key: K,\r\n  offset?: string,\r\n): SizeToken[K];\r\n\r\nexport function useSizeToken<K extends keyof SizeToken>(\r\n  size: ResponsiveValue<string>,\r\n  key?: K,\r\n  offset?: string,\r\n): SizeToken | SizeToken[K] {\r\n  const { theme, fallbackSize } = useTheme();\r\n\r\n  return useMemo(() => {\r\n    const scale = theme.sizes;\r\n\r\n    const baseSize = isResponsiveValue(size)\r\n      ? (size.base ?? fallbackSize)\r\n      : size;\r\n\r\n    const token =\r\n      scale[baseSize] ?? scale[fallbackSize] ?? Object.values(scale)[0] ?? {};\r\n\r\n    if (!key) {\r\n      return token;\r\n    }\r\n\r\n    return applyOffset(token[key], offset) as SizeToken[K];\r\n  }, [theme.sizes, size, fallbackSize, key, offset]);\r\n}\r\n","import { useTheme } from \"@/provider/useTheme\";\r\nimport type { Size, Theme } from \"@/types\";\r\n\r\nexport function getSizes(theme: Theme): Size[] {\r\n  return Object.keys(theme.sizes ?? {}) as Size[];\r\n}\r\n\r\nexport function useSizes(): Size[] {\r\n  const { theme } = useTheme();\r\n  return getSizes(theme);\r\n}\r\n","import { useTheme } from \"@/provider\";\r\nimport { resolveTypography } from \"@/utils\";\r\n\r\nexport function useTypography(name?: string) {\r\n  const { theme } = useTheme();\r\n\r\n  return resolveTypography(\r\n    name ? theme.typography[name] : undefined,\r\n    theme.tokens,\r\n  );\r\n}","import { useCallback, useRef, useState } from \"react\";\r\n\r\ninterface UseUndoRedoOptions {\r\n  /**\r\n   * Maximum number of history entries to keep.\r\n   * Only applies when `undoable` is `true` and the component manages its own history.\r\n   * @default 30\r\n   */\r\n  maxHistory?: number;\r\n}\r\n\r\n/**\r\n * Manages a history stack for a value, providing undo/redo capabilities.\r\n * The hook stores the current value in its own state, but you can also\r\n * sync it with external state by calling `push` when the external value changes.\r\n *\r\n * @param initialValue - The starting value.\r\n * @param options - Configuration (maxHistory).\r\n * @returns An object with the current value, setters, and undo/redo controls.\r\n */\r\nexport function useUndoRedo<T>(\r\n  initialValue: T,\r\n  options: UseUndoRedoOptions & {\r\n    onValueChange?: (value: T | undefined) => void;\r\n  } = {},\r\n) {\r\n  const { maxHistory = 30, onValueChange } = options;\r\n\r\n  const [value, setValue] = useState<T | undefined>(initialValue);\r\n  const historyRef = useRef<T[]>([initialValue]);\r\n  const indexRef = useRef(0);\r\n\r\n  const push = useCallback(\r\n    (newValue: T) => {\r\n      if (newValue === historyRef.current[indexRef.current]) return;\r\n\r\n      historyRef.current = historyRef.current.slice(0, indexRef.current + 1);\r\n\r\n      historyRef.current.push(newValue);\r\n      if (historyRef.current.length > maxHistory) {\r\n        historyRef.current = historyRef.current.slice(-maxHistory);\r\n        indexRef.current = historyRef.current.length - 1;\r\n      } else {\r\n        indexRef.current = historyRef.current.length - 1;\r\n      }\r\n\r\n      setValue(newValue);\r\n      onValueChange?.(newValue);\r\n    },\r\n    [maxHistory, onValueChange],\r\n  );\r\n\r\n  const undo = useCallback(() => {\r\n    if (indexRef.current <= 0) return;\r\n    indexRef.current -= 1;\r\n    const newValue = historyRef.current[indexRef.current];\r\n    setValue(newValue);\r\n    onValueChange?.(newValue);\r\n  }, [onValueChange]);\r\n\r\n  const redo = useCallback(() => {\r\n    if (indexRef.current >= historyRef.current.length - 1) return;\r\n    indexRef.current += 1;\r\n    const newVal = historyRef.current[indexRef.current];\r\n    setValue(newVal);\r\n  }, []);\r\n\r\n  const reset = useCallback(\r\n    (newValue: T) => {\r\n      historyRef.current = [newValue];\r\n      indexRef.current = 0;\r\n      setValue(newValue);\r\n      onValueChange?.(newValue);\r\n    },\r\n    [onValueChange],\r\n  );\r\n\r\n  const canUndo = indexRef.current > 0;\r\n  const canRedo = indexRef.current < historyRef.current.length - 1;\r\n\r\n  return {\r\n    value,\r\n    setValue,\r\n    push,\r\n    undo,\r\n    redo,\r\n    reset,\r\n    canUndo,\r\n    canRedo,\r\n    history: historyRef.current,\r\n    currentIndex: indexRef.current,\r\n  };\r\n}\r\n"]}
+{"version":3,"sources":["../../src/hooks/useBreakpoint.ts","../../src/hooks/useColorMode.ts","../../src/hooks/useControllableState.ts","../../src/hooks/useMergedResponsiveStyles.ts","../../src/hooks/useResponsiveStyles.ts","../../src/hooks/useSizeStyle.ts","../../src/hooks/useSizeToken.ts","../../src/hooks/useSizes.ts","../../src/hooks/useTypography.ts","../../src/hooks/useUndoRedo.ts"],"names":["useMemo","token","useState","useRef","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["\"use client\";\r\n\r\nimport { BaseBreakpoint } from \"@/types\";\r\nimport { useEffect, useState } from \"react\";\r\n\r\nconst BREAKPOINTS: Record<BaseBreakpoint, number> = {\r\n  sm: 640,\r\n  md: 768,\r\n  lg: 1024,\r\n  xl: 1280,\r\n  \"2xl\": 1536,\r\n};\r\n\r\nexport function useBreakpoint(breakpoint: BaseBreakpoint): boolean {\r\n  const query = `(min-width: ${BREAKPOINTS[breakpoint]}px)`;\r\n  const [matches, setMatches] = useState(\r\n    () => typeof window !== \"undefined\" && window.matchMedia(query).matches,\r\n  );\r\n\r\n  useEffect(() => {\r\n    const mql = window.matchMedia(query);\r\n    const listener = (e: MediaQueryListEvent) => setMatches(e.matches);\r\n    mql.addEventListener(\"change\", listener);\r\n    setMatches(mql.matches);\r\n    return () => mql.removeEventListener(\"change\", listener);\r\n  }, [query]);\r\n\r\n  return matches;\r\n}\r\n","import { useContext } from \"react\";\nimport { ThemeContext } from \"../provider/ThemeContext\";\nimport { ColorMode } from \"@/types/theme\";\n\nexport interface UseColorModeReturn {\n  mode: ColorMode;\n  setMode: (mode: ColorMode) => void;\n  toggleColorMode: () => void;\n}\n\nexport function useColorMode(): UseColorModeReturn {\n  const ctx = useContext(ThemeContext);\n\n  if (!ctx) {\n    throw new Error(\"useColorMode must be used within a ThemeProvider\");\n  }\n\n  return {\n    mode: ctx.mode,\n    setMode: ctx.setMode,\n    toggleColorMode: () => {\n      throw new Error(\"not implemented\");\n    },\n  };\n}\n","import * as React from \"react\";\n\nexport interface UseControllableStateOptions<T> {\n  value?: T;\n  defaultValue: T;\n  onChange?: (next: T) => void;\n}\n\nexport function useControllableState<T>({\n  value,\n  defaultValue,\n  onChange,\n}: UseControllableStateOptions<T>): [T, (next: T) => void] {\n  const [internal, setInternal] = React.useState<T>(defaultValue);\n  const isControlled = value !== undefined;\n  const current = isControlled ? (value as T) : internal;\n  const currentRef = React.useRef(current);\n  currentRef.current = current;\n  const onChangeRef = React.useRef(onChange);\n  onChangeRef.current = onChange;\n\n  const set = React.useCallback(\n    (next: T) => {\n      if (Object.is(next, currentRef.current)) return;\n      if (!isControlled) setInternal(next);\n      onChangeRef.current?.(next);\n    },\n    [isControlled],\n  );\n  return [current, set];\n}\n","\"use client\";\r\n\r\nimport { useMemo } from \"react\";\r\nimport type { CSSProperties } from \"react\";\r\nimport type { ResponsiveValue, ResponsiveStyles } from \"@/types\";\r\nimport { resolveResponsiveValue } from \"@/utils/responsive\";\r\n\r\n/**\r\n * One entry: a responsive prop value plus a mapper from that value to a\r\n * partial CSSProperties object.\r\n *\r\n * Using `any` for the value type because different entries may have different\r\n * value types, and we only need to call the mapper with the resolved value.\r\n */\r\nexport type ResponsivePropEntry = [\r\n  value: ResponsiveValue<any> | undefined,\r\n  toCss: (value: any) => Partial<CSSProperties>,\r\n];\r\n\r\nfunction mergeResponsiveProps(\r\n  entries: ResponsivePropEntry[],\r\n): ResponsiveStyles {\r\n  const result: ResponsiveStyles = {};\r\n\r\n  for (const [value, toCss] of entries) {\r\n    if (value === undefined) continue;\r\n\r\n    const { base, responsive } = resolveResponsiveValue(value);\r\n\r\n    if (base !== undefined) {\r\n      result.base = { ...result.base, ...toCss(base) };\r\n    }\r\n\r\n    for (const [bp, v] of Object.entries(responsive)) {\r\n      result[bp] = { ...result[bp], ...toCss(v) };\r\n    }\r\n  }\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * Merges multiple ResponsiveValue<T> props into one ResponsiveStyles map,\r\n * memoized on the entries' values.\r\n *\r\n * @example\r\n * const responsiveStyles = useMergedResponsiveStyles([\r\n *   [gap, (v) => ({ gap: spaceVar(v) })],\r\n *   [align, (v) => ({ alignItems: v })],\r\n * ]);\r\n */\r\nexport function useMergedResponsiveStyles(\r\n  entries: ResponsivePropEntry[],\r\n): ResponsiveStyles {\r\n  // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  return useMemo(\r\n    () => mergeResponsiveProps(entries),\r\n    entries.map(([value]) => value),\r\n  );\r\n}\r\n","\"use client\";\r\n\r\nimport { type CSSProperties, useId, useMemo } from \"react\";\r\n\r\nimport type { ResponsiveStyles } from \"@/types\";\r\nimport { useTheme } from \"@/provider/useTheme\";\r\n\r\nconst cssPropertyToKebab = (property: string) =>\r\n  property.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);\r\n\r\nconst cssValue = (value: CSSProperties[keyof CSSProperties]) => {\r\n  if (typeof value === \"number\") {\r\n    return String(value);\r\n  }\r\n\r\n  return value;\r\n};\r\n\r\nexport function useResponsiveStyles(responsiveStyles?: ResponsiveStyles) {\r\n  const { theme } = useTheme();\r\n  const id = useId();\r\n\r\n  return useMemo(() => {\r\n    if (!responsiveStyles || Object.keys(responsiveStyles).length === 0) {\r\n      return {\r\n        attribute: undefined,\r\n        style: undefined,\r\n      };\r\n    }\r\n\r\n    const breakpoints = theme.tokens.breakpoints;\r\n\r\n    if (!breakpoints) {\r\n      return {\r\n        attribute: undefined,\r\n        style: undefined,\r\n      };\r\n    }\r\n\r\n    const attribute = id.replace(/:/g, \"\");\r\n\r\n    const selector = `[data-kui-responsive=\"${attribute}\"]`;\r\n\r\n    const rules: string[] = [];\r\n\r\n    for (const [breakpoint, styles] of Object.entries(responsiveStyles)) {\r\n      const declarations = Object.entries(styles)\r\n        .filter(([, value]) => value !== undefined)\r\n        .map(\r\n          ([property, value]) =>\r\n            `${cssPropertyToKebab(property)}:${cssValue(value)};`,\r\n        )\r\n        .join(\"\");\r\n\r\n      if (!declarations) continue;\r\n\r\n      if (breakpoint === \"base\") {\r\n        rules.push(`\r\n          ${selector} {\r\n            ${declarations}\r\n          }\r\n        `);\r\n\r\n        continue;\r\n      }\r\n\r\n      const breakpointToken = breakpoints[breakpoint];\r\n\r\n      if (!breakpointToken) continue;\r\n\r\n      rules.push(`\r\n        @media (min-width: ${breakpointToken.value}) {\r\n          ${selector} {\r\n            ${declarations}\r\n          }\r\n        }\r\n      `);\r\n    }\r\n\r\n    if (rules.length === 0) {\r\n      return {\r\n        attribute: undefined,\r\n        style: undefined,\r\n      };\r\n    }\r\n\r\n    return {\r\n      attribute,\r\n      style: rules.join(\"\\n\"),\r\n    };\r\n  }, [responsiveStyles, theme.tokens.breakpoints, id]);\r\n}\r\n","\"use client\";\n\nimport { useMemo, type CSSProperties } from \"react\";\n\nimport type {\n  CSSPropertiesWithVars,\n  ResponsiveStyles,\n  ResponsiveValue,\n} from \"@/types\";\nimport { isResponsiveValue } from \"@/utils/responsive\";\nimport { useTheme } from \"@/provider/useTheme\";\n\n/**\n * Options for {@link useSizeStyle}.\n */\nexport interface UseSizeStyleOptions {\n  /**\n   * Include `height` in the resolved style.\n   * @default true\n   */\n  includeHeight?: boolean;\n\n  /**\n   * Include `width` in the resolved style.\n   *\n   * When enabled, width is derived from the token's own `width` if\n   * `iconOnly` is set, otherwise from the token's `height`.\n   * @default false\n   */\n  includeWidth?: boolean;\n\n  /**\n   * Force `width` to mirror `height`, even when not in icon-only mode.\n   * @default false\n   */\n  widthFromHeight?: boolean;\n\n  /**\n   * CSS length subtracted from the resolved `height` / `width`\n   * (e.g. `\"2px\"`). Applied via `calc(...)`.\n   */\n  sizeOffset?: string;\n\n  /**\n   * CSS length subtracted from the resolved `fontSize`.\n   * Applied via `calc(...)`.\n   */\n  fontSizeOffset?: string;\n}\n\n/**\n * Result of {@link useSizeStyle}.\n */\nexport interface ResolvedSize {\n  /**\n   * Inline styles for non-responsive sizing.\n   *\n   * For responsive values this is intentionally empty so that\n   * breakpoint styles can override each other through CSS.\n   */\n  style: CSSProperties;\n\n  /**\n   * Styles generated for responsive sizing.\n   */\n  responsiveStyles?: ResponsiveStyles;\n\n  /** Resolved icon size, if defined on the token. */\n  iconSize?: CSSProperties[\"width\"];\n\n  /** Resolved font size, after applying `fontSizeOffset`. */\n  fontSize?: CSSProperties[\"fontSize\"];\n\n  /** Resolved gap between child elements. */\n  gap?: CSSProperties[\"gap\"];\n}\n\nconst applySizeOffset = (\n  value: string | undefined,\n  offset: string | undefined,\n) => {\n  if (!value || !offset) return value;\n\n  return `calc(${value} - ${offset})`;\n};\n\nimport type { DesignTokens } from \"@/types\";\nimport { resolveTokenReference } from \"@/utils\";\n\n/**\n * Builds size-related inline styles from a theme size token.\n *\n * Accepts either a plain size name (e.g. `\"md\"`) or a responsive value\n * (e.g. `{ base: \"sm\", lg: \"md\" }`). All token values are expanded through\n * `resolveTokenReference`, so aliases like `\"{spacing.4}\"` become concrete\n * values.\n *\n * Behavior notes:\n * - Padding is skipped when `iconOnly` is `true`.\n * - `gap` is forced to `0` when `iconOnly` is `true`.\n * - The token's `radius` is exposed as the CSS variable\n *   `--kui-<componentName>-radius` so consumers can reuse it in CSS.\n * - For responsive inputs, breakpoint styles are returned in\n *   `responsiveStyles` and `style` stays empty.\n *\n * @param size - Size name or responsive size object to resolve.\n * @param iconOnly - When `true`, applies icon-specific sizing (square,\n *   no horizontal padding, no gap).\n * @param componentName - Namespace used for generated CSS variables.\n * @param options - See {@link UseSizeStyleOptions}.\n * @returns A {@link ResolvedSize} containing inline and/or responsive styles.\n *\n * @example\n * ```ts\n * const { style } = useSizeStyle(\"md\");\n * // <button style={style} />\n * ```\n *\n * @example\n * ```ts\n * const { responsiveStyles } = useSizeStyle(\n *   { base: \"sm\", lg: \"md\" },\n *   false,\n *   \"button\",\n *   { includeWidth: true, sizeOffset: \"2px\" },\n * );\n * ```\n */\nexport function useSizeStyle(\n  size: ResponsiveValue<string>,\n  iconOnly = false,\n  componentName = \"component\",\n  options: UseSizeStyleOptions = {},\n): ResolvedSize {\n  const {\n    widthFromHeight = false,\n    includeHeight = true,\n    includeWidth = false,\n    sizeOffset,\n    fontSizeOffset,\n  } = options;\n\n  const { theme, fallbackSize } = useTheme();\n\n  return useMemo(() => {\n    const scale = theme.sizes;\n    const tokens = theme.tokens as unknown as DesignTokens;\n\n    const resolveValue = (value: unknown) =>\n      String(resolveTokenReference(value, tokens));\n\n    const resolveToken = (sizeName: string) =>\n      scale[sizeName] ?? scale[fallbackSize] ?? Object.values(scale)[0] ?? {};\n\n    const buildStyle = (sizeName: string): CSSPropertiesWithVars => {\n      const token = resolveToken(sizeName);\n      const style: CSSPropertiesWithVars = {};\n\n      const height = resolveValue(token.height);\n      const width = resolveValue(token.width);\n      const paddingX = resolveValue(token.paddingX);\n      const paddingY = resolveValue(token.paddingY);\n      const fontSize = resolveValue(token.fontSize);\n      const gap = resolveValue(token.gap);\n      const radius = resolveValue(token.radius);\n\n      if (includeHeight && height) {\n        style.height = applySizeOffset(height, sizeOffset);\n      }\n\n      if (includeWidth) {\n        if (iconOnly && width) {\n          style.width = applySizeOffset(width, sizeOffset);\n        } else if ((iconOnly || widthFromHeight) && includeHeight && height) {\n          style.width = applySizeOffset(height, sizeOffset);\n        }\n      }\n\n      if (!iconOnly && paddingX) {\n        style.paddingLeft = paddingX;\n        style.paddingRight = paddingX;\n      }\n\n      if (paddingY) {\n        style.paddingTop = paddingY;\n        style.paddingBottom = paddingY;\n      }\n\n      if (fontSize) {\n        style.fontSize = applySizeOffset(fontSize, fontSizeOffset);\n      }\n\n      if (gap) {\n        style.gap = iconOnly ? 0 : gap;\n      }\n\n      if (radius) {\n        const varName = `--kui-${componentName}-radius` as `--kui-${string}`;\n        style[varName] = radius;\n      }\n\n      return style;\n    };\n\n    if (!isResponsiveValue(size)) {\n      const style = buildStyle(size);\n      const token = resolveToken(size);\n\n      return {\n        style,\n        iconSize: resolveValue(token.iconSize),\n        fontSize: applySizeOffset(resolveValue(token.fontSize), fontSizeOffset),\n        gap: resolveValue(token.gap),\n      };\n    }\n\n    const { base, ...breakpoints } = size;\n\n    const baseSize = base ?? fallbackSize;\n\n    const responsiveStyles: ResponsiveStyles = {\n      base: buildStyle(baseSize),\n    };\n\n    for (const [breakpoint, breakpointSize] of Object.entries(breakpoints)) {\n      if (breakpointSize === undefined) continue;\n\n      responsiveStyles[breakpoint] = buildStyle(breakpointSize);\n    }\n\n    const token = resolveToken(baseSize);\n\n    return {\n      style: {},\n      responsiveStyles,\n      iconSize: resolveValue(token.iconSize),\n      fontSize: applySizeOffset(resolveValue(token.fontSize), fontSizeOffset),\n      gap: resolveValue(token.gap),\n    };\n  }, [\n    theme,\n    size,\n    fallbackSize,\n    iconOnly,\n    includeHeight,\n    includeWidth,\n    widthFromHeight,\n    componentName,\n    sizeOffset,\n    fontSizeOffset,\n  ]);\n}\n","import type { ResponsiveValue, SizeToken, DesignTokens } from \"@/types\";\r\n\r\nimport { useMemo } from \"react\";\r\nimport { useTheme } from \"@/provider/useTheme\";\r\nimport { isResponsiveValue } from \"@/utils/responsive\";\r\nimport { resolveTokenReference } from \"@/utils/resolveTokenReference\";\r\n\r\ntype SizeTokenValue = SizeToken[keyof SizeToken];\r\n\r\nfunction applyOffset(value: SizeTokenValue, offset?: string): SizeTokenValue {\r\n  if (offset == null || value == null) {\r\n    return value;\r\n  }\r\n\r\n  if (typeof value !== \"string\") {\r\n    return value;\r\n  }\r\n\r\n  return `calc(${value} - ${offset})`;\r\n}\r\n\r\n/**\r\n * Resolves a size token from the active theme.\r\n *\r\n * Accepts either a plain size name (e.g. `\"md\"`) or a responsive value\r\n * (e.g. `{ base: \"md\", lg: \"xl\" }`). When a responsive object is passed,\r\n * the `base` key is used, falling back to the theme's `fallbackSize`.\r\n *\r\n * All token values are passed through `resolveTokenReference`, so token\r\n * aliases like `\"{spacing.4}\"` are expanded to their concrete value.\r\n *\r\n * @param size - Size name or responsive size object to resolve.\r\n * @returns The full resolved {@link SizeToken} for the requested size.\r\n *\r\n * @example\r\n * ```ts\r\n * const token = useSizeToken(\"md\");\r\n * // { height: \"40px\", paddingX: \"16px\", fontSize: \"14px\", ... }\r\n * ```\r\n *\r\n * @example\r\n * ```ts\r\n * const token = useSizeToken({ base: \"sm\", lg: \"md\" });\r\n * ```\r\n */\r\nexport function useSizeToken(size: ResponsiveValue<string>): SizeToken;\r\n\r\n/**\r\n * Resolves a single value from a size token.\r\n *\r\n * Like the object overload, this accepts a plain or responsive size name and\r\n * expands token references. When `offset` is provided, the resolved value is\r\n * wrapped in a `calc(...)` expression subtracting the offset — useful for\r\n * trimming sizes without redefining a token.\r\n *\r\n * @typeParam K - The key of {@link SizeToken} to read (e.g. `\"height\"`, `\"fontSize\"`).\r\n * @param size - Size name or responsive size object to resolve.\r\n * @param key - The token field to read.\r\n * @param offset - Optional CSS length to subtract from the resolved value.\r\n * @returns The resolved (and optionally offset) token field.\r\n *\r\n * @example\r\n * ```ts\r\n * const height = useSizeToken(\"md\", \"height\");\r\n * // \"40px\"\r\n *\r\n * const height = useSizeToken(\"md\", \"height\", \"4px\");\r\n * // \"calc(40px - 4px)\"\r\n * ```\r\n *\r\n * @example\r\n * ```ts\r\n * const fontSize = useSizeToken({ base: \"sm\", lg: \"md\" }, \"fontSize\");\r\n * ```\r\n */\r\nexport function useSizeToken<K extends keyof SizeToken>(\r\n  size: ResponsiveValue<string>,\r\n  key: K,\r\n  offset?: string,\r\n): SizeToken[K];\r\n\r\nexport function useSizeToken<K extends keyof SizeToken>(\r\n  size: ResponsiveValue<string>,\r\n  key?: K,\r\n  offset?: string,\r\n): SizeToken | SizeToken[K] {\r\n  const { theme, fallbackSize } = useTheme();\r\n\r\n  return useMemo(() => {\r\n    const scale = theme.sizes;\r\n    const tokens = theme.tokens as unknown as DesignTokens;\r\n\r\n    const baseSize = isResponsiveValue(size)\r\n      ? (size.base ?? fallbackSize)\r\n      : size;\r\n\r\n    const token =\r\n      scale[baseSize] ?? scale[fallbackSize] ?? Object.values(scale)[0] ?? {};\r\n\r\n    const resolve = (value: unknown) =>\r\n      value == null ? value : resolveTokenReference(value, tokens);\r\n\r\n    if (!key) {\r\n      const resolved = Object.fromEntries(\r\n        Object.entries(token).map(([k, v]) => [k, resolve(v)]),\r\n      ) as SizeToken;\r\n\r\n      return resolved;\r\n    }\r\n\r\n    return applyOffset(\r\n      resolve(token[key]) as SizeTokenValue,\r\n      offset,\r\n    ) as SizeToken[K];\r\n  }, [theme, size, fallbackSize, key, offset]);\r\n}\r\n","import { useTheme } from \"@/provider/useTheme\";\r\nimport type { Size, Theme } from \"@/types\";\r\n\r\nexport function getSizes(theme: Theme): Size[] {\r\n  return Object.keys(theme.sizes ?? {}) as Size[];\r\n}\r\n\r\nexport function useSizes(): Size[] {\r\n  const { theme } = useTheme();\r\n  return getSizes(theme);\r\n}\r\n","import { useTheme } from \"@/provider\";\r\nimport { resolveTypography } from \"@/utils\";\r\n\r\nexport function useTypography(name?: string) {\r\n  const { theme } = useTheme();\r\n\r\n  return resolveTypography(\r\n    name ? theme.typography[name] : undefined,\r\n    theme.tokens,\r\n  );\r\n}","import { useCallback, useRef, useState } from \"react\";\r\n\r\ninterface UseUndoRedoOptions {\r\n  /**\r\n   * Maximum number of history entries to keep.\r\n   * Only applies when `undoable` is `true` and the component manages its own history.\r\n   * @default 30\r\n   */\r\n  maxHistory?: number;\r\n}\r\n\r\n/**\r\n * Manages a history stack for a value, providing undo/redo capabilities.\r\n * The hook stores the current value in its own state, but you can also\r\n * sync it with external state by calling `push` when the external value changes.\r\n *\r\n * @param initialValue - The starting value.\r\n * @param options - Configuration (maxHistory).\r\n * @returns An object with the current value, setters, and undo/redo controls.\r\n */\r\nexport function useUndoRedo<T>(\r\n  initialValue: T,\r\n  options: UseUndoRedoOptions & {\r\n    onValueChange?: (value: T | undefined) => void;\r\n  } = {},\r\n) {\r\n  const { maxHistory = 30, onValueChange } = options;\r\n\r\n  const [value, setValue] = useState<T | undefined>(initialValue);\r\n  const historyRef = useRef<T[]>([initialValue]);\r\n  const indexRef = useRef(0);\r\n\r\n  const push = useCallback(\r\n    (newValue: T) => {\r\n      if (newValue === historyRef.current[indexRef.current]) return;\r\n\r\n      historyRef.current = historyRef.current.slice(0, indexRef.current + 1);\r\n\r\n      historyRef.current.push(newValue);\r\n      if (historyRef.current.length > maxHistory) {\r\n        historyRef.current = historyRef.current.slice(-maxHistory);\r\n        indexRef.current = historyRef.current.length - 1;\r\n      } else {\r\n        indexRef.current = historyRef.current.length - 1;\r\n      }\r\n\r\n      setValue(newValue);\r\n      onValueChange?.(newValue);\r\n    },\r\n    [maxHistory, onValueChange],\r\n  );\r\n\r\n  const undo = useCallback(() => {\r\n    if (indexRef.current <= 0) return;\r\n    indexRef.current -= 1;\r\n    const newValue = historyRef.current[indexRef.current];\r\n    setValue(newValue);\r\n    onValueChange?.(newValue);\r\n  }, [onValueChange]);\r\n\r\n  const redo = useCallback(() => {\r\n    if (indexRef.current >= historyRef.current.length - 1) return;\r\n    indexRef.current += 1;\r\n    const newVal = historyRef.current[indexRef.current];\r\n    setValue(newVal);\r\n  }, []);\r\n\r\n  const reset = useCallback(\r\n    (newValue: T) => {\r\n      historyRef.current = [newValue];\r\n      indexRef.current = 0;\r\n      setValue(newValue);\r\n      onValueChange?.(newValue);\r\n    },\r\n    [onValueChange],\r\n  );\r\n\r\n  const canUndo = indexRef.current > 0;\r\n  const canRedo = indexRef.current < historyRef.current.length - 1;\r\n\r\n  return {\r\n    value,\r\n    setValue,\r\n    push,\r\n    undo,\r\n    redo,\r\n    reset,\r\n    canUndo,\r\n    canRedo,\r\n    history: historyRef.current,\r\n    currentIndex: indexRef.current,\r\n  };\r\n}\r\n"]}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { TokenValue, SemanticToken, SizeToken, SizeScale, Typography, RecipeDefinition, DesignTokens, TokenDefinition, TokenReferenceString as TokenReferenceString$1, SemanticTokens, Theme, ColorMode, ResolvedTokens } from './types/index.js';
-export { AnimationTokens, BaseBreakpoint, BaseColor, BaseProps, BaseVariant, BreakpointTokens, CSSPropertiesWithVars, ClearableProps, ColorModeValue, ColorProps, ColorScale, ColorTokens, ControlledProps, CustomRecipes, DeepPartial, DefaultRecipeCollection, DisabledProps, Easing, EmbeddedProps, FontSizeTokens, FontTokens, FontWeightTokens, FormFieldStatus, FullWidthProps, IntensityMap, LetterSpacingTokens, LineHeightTokens, LoadingProps, Orientation, OrientationProps, RadiusTokens, RecipeCollection, RecipeCompoundVariant, RecipeStyle, RecipeVariant, RecipeVariantValue, ReportedValidity, RequiredStateControlProps, ResponsiveStyles, ResponsiveValue, SemanticColorTokens, ShadowTokens, Size, SizeProps, SizeValue, SpacingTokens, StateControlProps, StateProps, StatusProps, StyleObject, StyleValue, Styleable, ThemeAnimation, ThemeOverride, ThemeTogglerTransition, ThemeTransition, TokenGroup, TrimProps, TypographyProps, TypographyStyle, UndoRedoProps, ValidateOn, ValidateProps, ValidationResult, ValueProps, Variant, VariantProps } from './types/index.js';
+export { AnimationTokens, BaseBreakpoint, BaseColor, BaseProps, BaseVariant, BreakpointTokens, CSSPropertiesWithVars, ClearableProps, ColorModeValue, ColorProps, ColorScale, ColorTokens, ControlledProps, CustomRecipes, DeepPartial, DefaultRecipeCollection, DisabledProps, Easing, EmbeddedProps, FontSizeTokens, FontTokens, FontWeightTokens, FormFieldStatus, FullWidthProps, IntensityMap, LetterSpacingTokens, LineHeightTokens, LoadingProps, MotionGatedProps, Orientation, OrientationProps, RadiusTokens, RecipeCollection, RecipeCompoundVariant, RecipeStyle, RecipeVariant, RecipeVariantValue, ReportedValidity, RequiredStateControlProps, ResponsiveStyles, ResponsiveValue, SemanticColorTokens, ShadowTokens, Size, SizeProps, SizeValue, SpacingTokens, StateControlProps, StateProps, StatusProps, StyleObject, StyleValue, Styleable, ThemeAnimation, ThemeOverride, ThemeTogglerTransition, ThemeTransition, TokenGroup, TrimProps, TypographyProps, TypographyStyle, UndoRedoProps, ValidateOn, ValidateProps, ValidationResult, ValueProps, Variant, VariantProps } from './types/index.js';
 import * as React from 'react';
-export { CreateComponentConfig, CreateFromPropsInput, KuiChildrenRegistry, KuiComponent, KuiInteractionState, KuiMeta, KuiProviderRegistry, KuiProviderRequirement, KuiRole, KuiSkeletonHint, KuiSupports, KuiVideoMeta, ResolvedResponsiveValue, WarnOnFlatCompoundConflictOptions, composeRefs, createComponent, createFromProps, deepMerge, hasKuiMeta, isResponsiveValue, mergeResponsiveValue, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveTokenReference, resolveTokens, resolveTypography, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict } from './utils/index.js';
+export { CreateComponentConfig, CreateFromPropsInput, KuiChildrenRegistry, KuiComponent, KuiInteractionState, KuiMeta, KuiProviderRegistry, KuiProviderRequirement, KuiRole, KuiSkeletonHint, KuiSupports, KuiVideoMeta, ResolvedResponsiveValue, WarnOnFlatCompoundConflictOptions, composeRefs, createComponent, createFromProps, cssToClass, deepMerge, hasKuiMeta, hashStyle, injectStyle, isMotionGated, isResponsiveValue, kebabCase, mergeResponsiveValue, registerStyle, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveStyle, resolveToken, resolveTokenReference, resolveTokens, resolveTypography, serializeStyle, styleRegistry, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict } from './utils/index.js';
 
 declare function defineToken<T extends TokenValue>(value: T): {
     value: T;
@@ -33,6 +33,32 @@ declare function defineSizes<const T extends SizeScale>(sizes: T): T;
 
 declare function defineTypography<const T extends Typography>(typography: T): T;
 
+/**
+ * Defines a recipe while preserving its literal type.
+ *
+ * Use this when authoring a custom recipe so TypeScript keeps the exact
+ * shape you wrote (variant names, value keys, etc.) instead of widening
+ * them to `string`. The returned object is the same reference you passed
+ * in — this is a type-only helper with no runtime behavior.
+ *
+ * @typeParam T - The literal {@link RecipeDefinition} type inferred from `recipe`.
+ * @param recipe - The recipe definition to register.
+ * @returns The same `recipe`, typed as `T`.
+ *
+ * @example
+ * ```ts
+ * const button = defineRecipe({
+ *   base: { display: "inline-flex" },
+ *   variants: {
+ *     size: { sm: { height: "32px" }, md: { height: "40px" } },
+ *     tone: { solid: "btn-solid", ghost: "btn-ghost" },
+ *   },
+ *   defaultVariants: { size: "md", tone: "solid" },
+ * });
+ *
+ * button.variants?.size; // { sm: ...; md: ... } — not Record<string, ...>
+ * ```
+ */
 declare function defineRecipe<const T extends RecipeDefinition>(recipe: T): T;
 
 /**

package/dist/index.js

@@ -1,5 +1,5 @@
 export { ThemeContext, useTheme } from './chunk-5CYSF7C3.js';
-export { composeRefs, createComponent, createFromProps, deepMerge, hasKuiMeta, isResponsiveValue, mergeResponsiveValue, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveTokenReference, resolveTokens, resolveTypography, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict } from './chunk-Q5PIXJRW.js';
+export { composeRefs, createComponent, createFromProps, cssToClass, deepMerge, hasKuiMeta, hashStyle, injectStyle, isMotionGated, isResponsiveValue, kebabCase, mergeResponsiveValue, registerStyle, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveStyle, resolveToken, resolveTokenReference, resolveTokens, resolveTypography, serializeStyle, styleRegistry, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict } from './chunk-JIJ42ZVR.js';
 import './chunk-RV5MKKBP.js';
 
 // src/define/token.ts

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/define/token.ts","../src/define/semanticToken.ts","../src/define/size.ts","../src/define/typography.ts","../src/define/recipe.ts","../src/runtime/validateCycles.ts","../src/define/theme.ts"],"names":[],"mappings":";;;;;AAEO,SAAS,YAAkC,KAAA,EAAU;AAC1D,EAAA,OAAO;AAAA,IACL;AAAA,GACF;AACF;AAEO,SAAS,aAAmD,MAAA,EAAW;AAC5E,EAAA,OAAO,MAAA,CAAO,WAAA;AAAA,IACZ,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CAAE,IAAI,CAAC,CAAC,GAAA,EAAK,KAAK,MAAM,CAAC,GAAA,EAAK,WAAA,CAAY,KAAK,CAAC,CAAC;AAAA,GACxE;AAGF;;;ACEO,SAAS,mBAAA,CACd,cACA,IAAA,EACkB;AAClB,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,OAAO;AAAA,MACL,KAAA,EAAO;AAAA,QACL,gBAAA,EAAkB,IAAA;AAAA,QAClB,KAAA,EAAO;AAAA;AACT,KACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,KAAA,EAAO;AAAA,MACL,gBAAA,EAAkB,KAAA;AAAA,MAClB,KAAA,EAAO,YAAA;AAAA,MACP;AAAA;AACF,GACF;AACF;AAIO,SAAS,qBAGd,MAAA,EASA;AACA,EAAA,OAAO,MAAA,CAAO,WAAA;AAAA,IACZ,MAAA,CAAO,QAAQ,MAAM,CAAA,CAAE,IAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM;AAAA,MAC3C,GAAA;AAAA,MACA,UAAU,IAAA,IACV,OAAO,KAAA,KAAU,QAAA,IACjB,WAAW,KAAA,IACX,MAAA,IAAU,KAAA,GACN,mBAAA,CAAoB,MAAM,KAAA,EAAO,KAAA,CAAM,IAAI,CAAA,GAC3C,oBAAoB,KAAmB;AAAA,KAC5C;AAAA,GACH;AACF;;;AC9DO,SAAS,WAAsC,IAAA,EAAY;AAChE,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,YAAuC,KAAA,EAAa;AAClE,EAAA,OAAO,KAAA;AACT;;;ACNO,SAAS,iBAA6C,UAAA,EAAkB;AAC7E,EAAA,OAAO,UAAA;AACT;;;ACFO,SAAS,aAA+C,MAAA,EAAc;AAC3E,EAAA,OAAO,MAAA;AACT;;;ACFA,IAAM,iBAAA,GAAoB,YAAA;AAM1B,SAAS,qBAAqB,KAAA,EAAoC;AAChE,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,MAAA;AACtC,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,iBAAiB,CAAA;AAC3C,EAAA,OAAO,KAAA,GAAQ,KAAA,CAAM,CAAC,CAAA,GAAI,MAAA;AAC5B;AAMA,SAAS,WAAA,CAAY,MAAe,IAAA,EAAuB;AACzD,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAC/B,EAAA,IAAI,OAAA,GAAmB,IAAA;AAEvB,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,IAAI,OAAA,KAAY,IAAA,IAAQ,OAAO,OAAA,KAAY,UAAU,OAAO,MAAA;AAC5D,IAAA,OAAA,GAAW,QAAoC,OAAO,CAAA;AAAA,EACxD;AAEA,EAAA,OAAO,OAAA;AACT;AAQA,SAAS,eAAe,IAAA,EAAyB;AAC/C,EAAA,IAAI,SAAS,IAAA,IAAQ,OAAO,SAAS,QAAA,IAAY,EAAE,WAAW,IAAA,CAAA,EAAO;AACnE,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,iBAAkB,IAAA,CAA4B,KAAA;AAEpD,EAAA,IAAI,cAAA,KAAmB,IAAA,IAAQ,OAAO,cAAA,KAAmB,QAAA,EAAU;AACjE,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,GAAA,GAAM,cAAA;AAEZ,EAAA,IAAI,GAAA,CAAI,qBAAqB,IAAA,EAAM;AACjC,IAAA,MAAM,GAAA,GAAM,oBAAA,CAAqB,GAAA,CAAI,KAAK,CAAA;AAC1C,IAAA,OAAO,GAAA,GAAM,CAAC,GAAG,CAAA,GAAI,EAAC;AAAA,EACxB;AAEA,EAAA,MAAM,OAAiB,EAAC;AACxB,EAAA,MAAM,QAAA,GAAW,oBAAA,CAAqB,GAAA,CAAI,KAAK,CAAA;AAC/C,EAAA,MAAM,OAAA,GAAU,oBAAA,CAAqB,GAAA,CAAI,IAAI,CAAA;AAC7C,EAAA,IAAI,QAAA,EAAU,IAAA,CAAK,IAAA,CAAK,QAAQ,CAAA;AAChC,EAAA,IAAI,OAAA,EAAS,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA;AAC9B,EAAA,OAAO,IAAA;AACT;AAkBO,SAAS,iBACd,cAAA,EACuB;AACvB,EAAA,SAAS,IAAA,CAAK,MAAc,OAAA,EAA0C;AACpE,IAAA,IAAI,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,EAAG;AAC1B,MAAA,OAAO,EAAE,OAAO,KAAA,EAAO,SAAA,EAAW,CAAC,GAAG,OAAA,EAAS,IAAI,CAAA,EAAE;AAAA,IACvD;AAEA,IAAA,MAAM,IAAA,GAAO,WAAA,CAAY,cAAA,EAAgB,IAAI,CAAA;AAC7C,IAAA,MAAM,IAAA,GAAO,eAAe,IAAI,CAAA;AAEhC,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,SAAS,IAAA,CAAK,GAAA,EAAK,CAAC,GAAG,OAAA,EAAS,IAAI,CAAC,CAAA;AAC3C,MAAA,IAAI,CAAC,MAAA,CAAO,KAAA,EAAO,OAAO,MAAA;AAAA,IAC5B;AAEA,IAAA,OAAO,EAAE,OAAO,IAAA,EAAK;AAAA,EACvB;AAEA,EAAA,SAAS,YAAA,CAAa,IAAA,EAAe,MAAA,GAAmB,EAAC,EAAe;AACtE,IAAA,IAAI,SAAS,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,SAAiB,EAAC;AAEvD,IAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,IAA+B,CAAA;AAC9D,IAAA,MAAM,QAAoB,EAAC;AAE3B,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,CAAA,IAAK,OAAA,EAAS;AAClC,MAAA,MAAM,WAAA,GAAc,CAAC,GAAG,MAAA,EAAQ,GAAG,CAAA;AAEnC,MAAA,IACE,UAAU,IAAA,IACV,OAAO,KAAA,KAAU,QAAA,IACjB,WAAY,KAAA,EACZ;AACA,QAAA,KAAA,CAAM,KAAK,WAAW,CAAA;AAAA,MACxB,CAAA,MAAO;AACL,QAAA,KAAA,CAAM,IAAA,CAAK,GAAG,YAAA,CAAa,KAAA,EAAO,WAAW,CAAC,CAAA;AAAA,MAChD;AAAA,IACF;AAEA,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,YAAA,GAAe,aAAa,cAAc,CAAA;AAEhD,EAAA,KAAA,MAAW,gBAAgB,YAAA,EAAc;AACvC,IAAA,MAAM,IAAA,GAAO,YAAA,CAAa,IAAA,CAAK,GAAG,CAAA;AAClC,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,EAAM,EAAE,CAAA;AAC5B,IAAA,IAAI,CAAC,MAAA,CAAO,KAAA,EAAO,OAAO,MAAA;AAAA,EAC5B;AAEA,EAAA,OAAO,EAAE,OAAO,IAAA,EAAK;AACvB;AAMO,SAAS,eAAe,cAAA,EAAsC;AACnE,EAAA,MAAM,MAAA,GAAS,iBAAiB,cAAc,CAAA;AAE9C,EAAA,IAAI,CAAC,OAAO,KAAA,EAAO;AACjB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,wDAAA,EAA2D,MAAA,CAAO,SAAA,EAAW,IAAA,CAAK,MAAM,CAAC,CAAA;AAAA,KAC3F;AAAA,EACF;AACF;;;ACpHO,SAAS,YAA6B,KAAA,EAAgC;AAC3E,EAAA,cAAA,CAAe,MAAM,cAAc,CAAA;AACnC,EAAA,OAAO,KAAA;AACT","file":"index.js","sourcesContent":["import type { TokenValue } from \"@/types\";\n\nexport function defineToken<T extends TokenValue>(value: T) {\n  return {\n    value,\n  };\n}\n\nexport function defineTokens<T extends Record<string, TokenValue>>(tokens: T) {\n  return Object.fromEntries(\n    Object.entries(tokens).map(([key, value]) => [key, defineToken(value)]),\n  ) as {\n    [K in keyof T]: ReturnType<typeof defineToken<T[K]>>;\n  };\n}\n","import type { SemanticToken, TokenValue } from \"@/types\";\n\n/**\n * Defines a semantic token that shares a single value across both\n * light and dark modes (the explicit sameForBothModes shorthand).\n */\nexport function defineSemanticToken<T extends TokenValue>(\n  value: T,\n): SemanticToken<T>;\n/**\n * Defines a semantic token with distinct light and dark values.\n */\nexport function defineSemanticToken<T extends TokenValue>(\n  light: T,\n  dark: T,\n): SemanticToken<T>;\nexport function defineSemanticToken<T extends TokenValue>(\n  lightOrValue: T,\n  dark?: T,\n): SemanticToken<T> {\n  if (dark === undefined) {\n    return {\n      value: {\n        sameForBothModes: true,\n        value: lightOrValue,\n      },\n    };\n  }\n\n  return {\n    value: {\n      sameForBothModes: false,\n      light: lightOrValue,\n      dark,\n    },\n  };\n}\n\ntype SemanticTokenInput<T extends TokenValue> = T | { light: T; dark: T };\n\nexport function defineSemanticTokens<\n  T extends Record<string, SemanticTokenInput<TokenValue>>,\n>(\n  tokens: T,\n): {\n  [K in keyof T]: SemanticToken<T[K] extends { light: infer V; dark: infer _ }\n    ? V extends TokenValue\n      ? V\n      : never\n    : T[K] extends TokenValue\n      ? T[K]\n      : never>;\n} {\n  return Object.fromEntries(\n    Object.entries(tokens).map(([key, entry]) => [\n      key,\n      entry !== null &&\n      typeof entry === \"object\" &&\n      \"light\" in entry &&\n      \"dark\" in entry\n        ? defineSemanticToken(entry.light, entry.dark)\n        : defineSemanticToken(entry as TokenValue),\n    ]),\n  ) as ReturnType<typeof defineSemanticTokens<T>>;\n}\n","import type { SizeScale, SizeToken } from \"@/types\";\n\nexport function defineSize<const T extends SizeToken>(size: T): T {\n  return size;\n}\n\nexport function defineSizes<const T extends SizeScale>(sizes: T): T {\n  return sizes;\n}\n","import type { Typography } from \"@/types\";\n\nexport function defineTypography<const T extends Typography>(typography: T): T {\n  return typography;\n}\n","import type { RecipeDefinition } from \"@/types\";\n\nexport function defineRecipe<const T extends RecipeDefinition>(recipe: T): T {\n  return recipe;\n}\n","import type { SemanticTokens } from \"@/types\";\n\nconst REFERENCE_PATTERN = /^\\{(.+)\\}$/;\n\n/**\n * If value is a \"{colors.brand.500}\"-style reference string, returns\n * the raw dotted path (\"colors.brand.500\"). Otherwise returns null.\n */\nfunction extractReferencePath(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const match = value.match(REFERENCE_PATTERN);\n  return match ? match[1] : undefined;\n}\n\n/**\n * Resolves a dotted path against an object tree. Returns undefined\n * if any segment doesn't exist.\n */\nfunction resolvePath(tree: unknown, path: string): unknown {\n  const segments = path.split(\".\");\n  let current: unknown = tree;\n\n  for (const segment of segments) {\n    if (current === null || typeof current !== \"object\") return undefined;\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  return current;\n}\n\n/**\n * Given a resolved semantic-token node (shape: { value: ColorModeValue }),\n * returns the reference string(s) its value points to, if any — i.e.\n * the next hop(s) in a semantic->semantic chain. Non-reference\n * (literal) values return an empty array — the chain ends there.\n */\nfunction nextReferences(node: unknown): string[] {\n  if (node === null || typeof node !== \"object\" || !(\"value\" in node)) {\n    return [];\n  }\n\n  const colorModeValue = (node as { value: unknown }).value;\n\n  if (colorModeValue === null || typeof colorModeValue !== \"object\") {\n    return [];\n  }\n\n  const cmv = colorModeValue as Record<string, unknown>;\n\n  if (cmv.sameForBothModes === true) {\n    const ref = extractReferencePath(cmv.value);\n    return ref ? [ref] : [];\n  }\n\n  const refs: string[] = [];\n  const lightRef = extractReferencePath(cmv.light);\n  const darkRef = extractReferencePath(cmv.dark);\n  if (lightRef) refs.push(lightRef);\n  if (darkRef) refs.push(darkRef);\n  return refs;\n}\n\nexport interface CycleValidationResult {\n  valid: boolean;\n  cyclePath?: string[];\n}\n\n/**\n * Walks every semantic token's reference chain looking for a\n * semantic->semantic cycle. Reference *existence* (does the path\n * resolve at all) is validated separately at the type level via\n * ValidateSemanticTokenSection — this function only detects cycles\n * among references that do resolve to another semantic token.\n *\n * A reference that resolves to nothing (dangling) or to a primitive\n * token is a dead end for cycle-walking purposes here, not an error\n * this function raises — that's the type-level existence check's job.\n */\nexport function validateNoCycles(\n  semanticTokens: SemanticTokens,\n): CycleValidationResult {\n  function walk(path: string, visited: string[]): CycleValidationResult {\n    if (visited.includes(path)) {\n      return { valid: false, cyclePath: [...visited, path] };\n    }\n\n    const node = resolvePath(semanticTokens, path);\n    const refs = nextReferences(node);\n\n    for (const ref of refs) {\n      const result = walk(ref, [...visited, path]);\n      if (!result.valid) return result;\n    }\n\n    return { valid: true };\n  }\n\n  function collectPaths(tree: unknown, prefix: string[] = []): string[][] {\n    if (tree === null || typeof tree !== \"object\") return [];\n\n    const entries = Object.entries(tree as Record<string, unknown>);\n    const paths: string[][] = [];\n\n    for (const [key, value] of entries) {\n      const currentPath = [...prefix, key];\n\n      if (\n        value !== null &&\n        typeof value === \"object\" &&\n        \"value\" in (value as Record<string, unknown>)\n      ) {\n        paths.push(currentPath);\n      } else {\n        paths.push(...collectPaths(value, currentPath));\n      }\n    }\n\n    return paths;\n  }\n\n  const allLeafPaths = collectPaths(semanticTokens);\n\n  for (const pathSegments of allLeafPaths) {\n    const path = pathSegments.join(\".\");\n    const result = walk(path, []);\n    if (!result.valid) return result;\n  }\n\n  return { valid: true };\n}\n\n/**\n * Throws a descriptive error if a semantic->semantic cycle is found.\n * Intended to be called from defineTheme/extendTheme.\n */\nexport function assertNoCycles(semanticTokens: SemanticTokens): void {\n  const result = validateNoCycles(semanticTokens);\n\n  if (!result.valid) {\n    throw new Error(\n      `Kreativ UI: circular semantic token reference detected: ${result.cyclePath?.join(\" -> \")}`,\n    );\n  }\n}\n","import type { Theme } from \"@/types\";\nimport type { ValidateTheme } from \"../validate/theme\";\nimport { assertNoCycles } from \"../runtime/validateCycles\";\n\n/**\n * Defines a Kreativ UI theme.\n *\n * Type-safe boundary for creating themes while preserving the exact\n * structure and types of the supplied theme. Does not merge with the\n * default theme or mutate the provided object — extension/resolution\n * are handled separately by extendTheme.\n *\n * `T & ValidateTheme<T>` is what actually enforces validation at the\n * call site: ValidateTheme<T> resolves to `unknown` (a no-op) when\n * every section passes, or a section-named `{ tokens: Invalid<...> }`\n * / `{ semanticTokens: Invalid<...> }` / etc. object when a section\n * fails. Intersecting that onto the parameter type means a failing\n * theme produces a real compile error naming the failing section and\n * message, not just a generic \"not assignable to Theme\".\n *\n * Reference *existence* (does \"{colors.brand.500}\" resolve to a real\n * token) is checked at compile time via ValidateSemanticTokenSection,\n * as part of ValidateTheme above. Reference *cycles* (semantic token\n * A -> B -> A) can't be reliably caught at the type level (hit TS\n * inference edge cases in recursive conditional types), so they're\n * checked here at call time instead, via assertNoCycles.\n */\nexport function defineTheme<T extends Theme>(theme: T & ValidateTheme<T>): T {\n  assertNoCycles(theme.semanticTokens);\n  return theme;\n}\n\n"]}
+{"version":3,"sources":["../src/define/token.ts","../src/define/semanticToken.ts","../src/define/size.ts","../src/define/typography.ts","../src/define/recipe.ts","../src/runtime/validateCycles.ts","../src/define/theme.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { TokenValue } from \"@/types\";\n\nexport function defineToken<T extends TokenValue>(value: T) {\n  return {\n    value,\n  };\n}\n\nexport function defineTokens<T extends Record<string, TokenValue>>(tokens: T) {\n  return Object.fromEntries(\n    Object.entries(tokens).map(([key, value]) => [key, defineToken(value)]),\n  ) as {\n    [K in keyof T]: ReturnType<typeof defineToken<T[K]>>;\n  };\n}\n","import type { SemanticToken, TokenValue } from \"@/types\";\n\n/**\n * Defines a semantic token that shares a single value across both\n * light and dark modes (the explicit sameForBothModes shorthand).\n */\nexport function defineSemanticToken<T extends TokenValue>(\n  value: T,\n): SemanticToken<T>;\n/**\n * Defines a semantic token with distinct light and dark values.\n */\nexport function defineSemanticToken<T extends TokenValue>(\n  light: T,\n  dark: T,\n): SemanticToken<T>;\nexport function defineSemanticToken<T extends TokenValue>(\n  lightOrValue: T,\n  dark?: T,\n): SemanticToken<T> {\n  if (dark === undefined) {\n    return {\n      value: {\n        sameForBothModes: true,\n        value: lightOrValue,\n      },\n    };\n  }\n\n  return {\n    value: {\n      sameForBothModes: false,\n      light: lightOrValue,\n      dark,\n    },\n  };\n}\n\ntype SemanticTokenInput<T extends TokenValue> = T | { light: T; dark: T };\n\nexport function defineSemanticTokens<\n  T extends Record<string, SemanticTokenInput<TokenValue>>,\n>(\n  tokens: T,\n): {\n  [K in keyof T]: SemanticToken<T[K] extends { light: infer V; dark: infer _ }\n    ? V extends TokenValue\n      ? V\n      : never\n    : T[K] extends TokenValue\n      ? T[K]\n      : never>;\n} {\n  return Object.fromEntries(\n    Object.entries(tokens).map(([key, entry]) => [\n      key,\n      entry !== null &&\n      typeof entry === \"object\" &&\n      \"light\" in entry &&\n      \"dark\" in entry\n        ? defineSemanticToken(entry.light, entry.dark)\n        : defineSemanticToken(entry as TokenValue),\n    ]),\n  ) as ReturnType<typeof defineSemanticTokens<T>>;\n}\n","import type { SizeScale, SizeToken } from \"@/types\";\n\nexport function defineSize<const T extends SizeToken>(size: T): T {\n  return size;\n}\n\nexport function defineSizes<const T extends SizeScale>(sizes: T): T {\n  return sizes;\n}\n","import type { Typography } from \"@/types\";\n\nexport function defineTypography<const T extends Typography>(typography: T): T {\n  return typography;\n}\n","import type { RecipeDefinition } from \"@/types\";\n\n/**\n * Defines a recipe while preserving its literal type.\n *\n * Use this when authoring a custom recipe so TypeScript keeps the exact\n * shape you wrote (variant names, value keys, etc.) instead of widening\n * them to `string`. The returned object is the same reference you passed\n * in — this is a type-only helper with no runtime behavior.\n *\n * @typeParam T - The literal {@link RecipeDefinition} type inferred from `recipe`.\n * @param recipe - The recipe definition to register.\n * @returns The same `recipe`, typed as `T`.\n *\n * @example\n * ```ts\n * const button = defineRecipe({\n *   base: { display: \"inline-flex\" },\n *   variants: {\n *     size: { sm: { height: \"32px\" }, md: { height: \"40px\" } },\n *     tone: { solid: \"btn-solid\", ghost: \"btn-ghost\" },\n *   },\n *   defaultVariants: { size: \"md\", tone: \"solid\" },\n * });\n *\n * button.variants?.size; // { sm: ...; md: ... } — not Record<string, ...>\n * ```\n */\nexport function defineRecipe<const T extends RecipeDefinition>(recipe: T): T {\n  return recipe;\n}\n","import type { SemanticTokens } from \"@/types\";\n\nconst REFERENCE_PATTERN = /^\\{(.+)\\}$/;\n\n/**\n * If value is a \"{colors.brand.500}\"-style reference string, returns\n * the raw dotted path (\"colors.brand.500\"). Otherwise returns null.\n */\nfunction extractReferencePath(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const match = value.match(REFERENCE_PATTERN);\n  return match ? match[1] : undefined;\n}\n\n/**\n * Resolves a dotted path against an object tree. Returns undefined\n * if any segment doesn't exist.\n */\nfunction resolvePath(tree: unknown, path: string): unknown {\n  const segments = path.split(\".\");\n  let current: unknown = tree;\n\n  for (const segment of segments) {\n    if (current === null || typeof current !== \"object\") return undefined;\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  return current;\n}\n\n/**\n * Given a resolved semantic-token node (shape: { value: ColorModeValue }),\n * returns the reference string(s) its value points to, if any — i.e.\n * the next hop(s) in a semantic->semantic chain. Non-reference\n * (literal) values return an empty array — the chain ends there.\n */\nfunction nextReferences(node: unknown): string[] {\n  if (node === null || typeof node !== \"object\" || !(\"value\" in node)) {\n    return [];\n  }\n\n  const colorModeValue = (node as { value: unknown }).value;\n\n  if (colorModeValue === null || typeof colorModeValue !== \"object\") {\n    return [];\n  }\n\n  const cmv = colorModeValue as Record<string, unknown>;\n\n  if (cmv.sameForBothModes === true) {\n    const ref = extractReferencePath(cmv.value);\n    return ref ? [ref] : [];\n  }\n\n  const refs: string[] = [];\n  const lightRef = extractReferencePath(cmv.light);\n  const darkRef = extractReferencePath(cmv.dark);\n  if (lightRef) refs.push(lightRef);\n  if (darkRef) refs.push(darkRef);\n  return refs;\n}\n\nexport interface CycleValidationResult {\n  valid: boolean;\n  cyclePath?: string[];\n}\n\n/**\n * Walks every semantic token's reference chain looking for a\n * semantic->semantic cycle. Reference *existence* (does the path\n * resolve at all) is validated separately at the type level via\n * ValidateSemanticTokenSection — this function only detects cycles\n * among references that do resolve to another semantic token.\n *\n * A reference that resolves to nothing (dangling) or to a primitive\n * token is a dead end for cycle-walking purposes here, not an error\n * this function raises — that's the type-level existence check's job.\n */\nexport function validateNoCycles(\n  semanticTokens: SemanticTokens,\n): CycleValidationResult {\n  function walk(path: string, visited: string[]): CycleValidationResult {\n    if (visited.includes(path)) {\n      return { valid: false, cyclePath: [...visited, path] };\n    }\n\n    const node = resolvePath(semanticTokens, path);\n    const refs = nextReferences(node);\n\n    for (const ref of refs) {\n      const result = walk(ref, [...visited, path]);\n      if (!result.valid) return result;\n    }\n\n    return { valid: true };\n  }\n\n  function collectPaths(tree: unknown, prefix: string[] = []): string[][] {\n    if (tree === null || typeof tree !== \"object\") return [];\n\n    const entries = Object.entries(tree as Record<string, unknown>);\n    const paths: string[][] = [];\n\n    for (const [key, value] of entries) {\n      const currentPath = [...prefix, key];\n\n      if (\n        value !== null &&\n        typeof value === \"object\" &&\n        \"value\" in (value as Record<string, unknown>)\n      ) {\n        paths.push(currentPath);\n      } else {\n        paths.push(...collectPaths(value, currentPath));\n      }\n    }\n\n    return paths;\n  }\n\n  const allLeafPaths = collectPaths(semanticTokens);\n\n  for (const pathSegments of allLeafPaths) {\n    const path = pathSegments.join(\".\");\n    const result = walk(path, []);\n    if (!result.valid) return result;\n  }\n\n  return { valid: true };\n}\n\n/**\n * Throws a descriptive error if a semantic->semantic cycle is found.\n * Intended to be called from defineTheme/extendTheme.\n */\nexport function assertNoCycles(semanticTokens: SemanticTokens): void {\n  const result = validateNoCycles(semanticTokens);\n\n  if (!result.valid) {\n    throw new Error(\n      `Kreativ UI: circular semantic token reference detected: ${result.cyclePath?.join(\" -> \")}`,\n    );\n  }\n}\n","import type { Theme } from \"@/types\";\nimport type { ValidateTheme } from \"../validate/theme\";\nimport { assertNoCycles } from \"../runtime/validateCycles\";\n\n/**\n * Defines a Kreativ UI theme.\n *\n * Type-safe boundary for creating themes while preserving the exact\n * structure and types of the supplied theme. Does not merge with the\n * default theme or mutate the provided object — extension/resolution\n * are handled separately by extendTheme.\n *\n * `T & ValidateTheme<T>` is what actually enforces validation at the\n * call site: ValidateTheme<T> resolves to `unknown` (a no-op) when\n * every section passes, or a section-named `{ tokens: Invalid<...> }`\n * / `{ semanticTokens: Invalid<...> }` / etc. object when a section\n * fails. Intersecting that onto the parameter type means a failing\n * theme produces a real compile error naming the failing section and\n * message, not just a generic \"not assignable to Theme\".\n *\n * Reference *existence* (does \"{colors.brand.500}\" resolve to a real\n * token) is checked at compile time via ValidateSemanticTokenSection,\n * as part of ValidateTheme above. Reference *cycles* (semantic token\n * A -> B -> A) can't be reliably caught at the type level (hit TS\n * inference edge cases in recursive conditional types), so they're\n * checked here at call time instead, via assertNoCycles.\n */\nexport function defineTheme<T extends Theme>(theme: T & ValidateTheme<T>): T {\n  assertNoCycles(theme.semanticTokens);\n  return theme;\n}\n\n"]}

package/dist/types/index.d.ts

@@ -456,6 +456,14 @@ interface ValidateProps<T = string> {
      */
     validateOn?: ValidateOn;
 }
+/**
+ * Forge sets this on a safe, motionGated component at render-start.
+ * Data attributes stringify, so both the boolean prop and the "true"
+ * attribute count as gated.
+ */
+interface MotionGatedProps {
+    "data-kui-motion-gated"?: boolean | "true" | "false";
+}
 
 type TokenValue = string | number;
 interface TokenDefinition<T extends TokenValue = TokenValue> {
@@ -568,13 +576,13 @@ interface TypographyStyle {
 type Typography = Record<string, TypographyStyle>;
 
 /**
- * A single style value inside a StyleObject — either a raw CSS value
- * or (via resolveToken) a "{...}" token reference string.
+ * A single style value inside a {@link StyleObject} — either a raw CSS value
+ * or (via `resolveToken`) a `"{...}"` token reference string.
  */
 type StyleValue = string | number;
 /**
  * A CSS-object variant value — resolved at runtime into an atomic
- * class name via resolveStyle/cssToClass (see resolveRecipe.ts).
+ * class name via `resolveStyle` / `cssToClass` (see `resolveRecipe.ts`).
  */
 type StyleObject = Record<string, StyleValue>;
 /**
@@ -582,18 +590,86 @@ type StyleObject = Record<string, StyleValue>;
  * that gets hashed into an atomic class name at resolve time.
  */
 type RecipeStyle = string | StyleObject;
+/**
+ * A value a variant can be keyed by — typically the variant's name
+ * (e.g. `"solid"`, `"md"`) or a boolean toggle for on/off variants.
+ */
 type RecipeVariantValue = string | boolean | number;
+/**
+ * A single variant axis, mapping each possible value to the style
+ * applied when that value is selected.
+ *
+ * @example
+ * ```ts
+ * const size: RecipeVariant = {
+ *   sm: { height: "32px", paddingX: "12px" },
+ *   md: "btn-md", // class-name style
+ * };
+ * ```
+ */
 type RecipeVariant = Record<string, RecipeStyle>;
+/**
+ * Styles applied only when *all* listed conditions match the currently
+ * selected variant values.
+ *
+ * @example
+ * ```ts
+ * const compound: RecipeCompoundVariant = {
+ *   conditions: { variant: "solid", size: "sm" },
+ *   className: { paddingX: "10px" },
+ * };
+ * ```
+ */
 interface RecipeCompoundVariant {
+    /** Variant values that must all match for `className` to apply. */
     conditions: Record<string, RecipeVariantValue>;
+    /** Style applied when every condition matches. */
     className: RecipeStyle;
 }
+/**
+ * The shape of a single recipe — the base style plus any variant axes,
+ * default selections, and compound overrides.
+ *
+ * @example
+ * ```ts
+ * const button: RecipeDefinition = {
+ *   base: { display: "inline-flex", borderRadius: "6px" },
+ *   variants: {
+ *     size: { sm: { height: "32px" }, md: { height: "40px" } },
+ *     variant: { solid: "btn-solid", ghost: "btn-ghost" },
+ *   },
+ *   defaultVariants: { size: "md", variant: "solid" },
+ *   compoundVariants: [
+ *     { conditions: { variant: "solid", size: "sm" }, className: { paddingX: "10px" } },
+ *   ],
+ * };
+ * ```
+ */
 interface RecipeDefinition {
+    /** Style applied unconditionally, before any variant is resolved. */
     base?: RecipeStyle;
+    /**
+     * Variant axes keyed by name (e.g. `size`, `variant`, `tone`).
+     * Each axis maps a value to the style it selects.
+     */
     variants?: Record<string, RecipeVariant>;
+    /**
+     * Variant values used when the consumer doesn't specify one
+     * for a given axis.
+     */
     defaultVariants?: Record<string, RecipeVariantValue>;
+    /**
+     * Additional styles layered on top of `base` + selected variants
+     * when all their conditions match.
+     */
     compoundVariants?: RecipeCompoundVariant[];
 }
+/**
+ * The built-in recipes shipped with the library, keyed by component name.
+ *
+ * Each entry is a {@link RecipeDefinition} that a component looks up at
+ * render time. Augment or override these via {@link CustomRecipes}.
+ */
 type DefaultRecipeCollection = {
     Button: RecipeDefinition;
     FormControl: RecipeDefinition;
@@ -605,8 +681,51 @@ type DefaultRecipeCollection = {
     Switch: RecipeDefinition;
     Container: RecipeDefinition;
     Link: RecipeDefinition;
+    RepeaterRemove: RecipeDefinition;
+    RepeaterMoveUp: RecipeDefinition;
+    RepeaterMoveDown: RecipeDefinition;
+    RepeaterAdd: RecipeDefinition;
+    RepeaterItem: RecipeDefinition;
+    RepeaterItems: RecipeDefinition;
+    NumberStepper: RecipeDefinition;
+    NumberStepperButton: RecipeDefinition;
+    NumberStepperButtons: RecipeDefinition;
+    CardBody: RecipeDefinition;
+    CardFooter: RecipeDefinition;
+    CardHeader: RecipeDefinition;
+    CardMedia: RecipeDefinition;
+    CardOverlay: RecipeDefinition;
+    Card: RecipeDefinition;
 };
+/**
+ * User-defined recipes, keyed by an arbitrary component name.
+ *
+ * Keys may collide with {@link DefaultRecipeCollection} names to
+ * override the built-in recipe for that component, or introduce new
+ * components entirely.
+ *
+ * @example
+ * ```ts
+ * const recipes: CustomRecipes = {
+ *   Button: { base: "my-btn", variants: { ... } },
+ *   Callout: { base: { padding: "12px" } },
+ * };
+ * ```
+ */
 type CustomRecipes = Record<string, RecipeDefinition>;
+/**
+ * The full recipe collection passed to the provider — built-in defaults
+ * (all optional, so any subset can be overridden) merged with any
+ * {@link CustomRecipes}.
+ *
+ * @example
+ * ```ts
+ * const recipes: RecipeCollection = {
+ *   Button: { /* override the built-in Button *\/ },
+ *   Callout: { base: "callout" }, // add a new component
+ * };
+ * ```
+ */
 type RecipeCollection = Partial<DefaultRecipeCollection> & CustomRecipes;
 
 type ThemeTransition = "none" | "smooth" | "fast" | {
@@ -643,4 +762,4 @@ interface ThemeOverride {
 }
 type ColorMode = "light" | "dark" | "system";
 
-export type { AnimationTokens, BaseBreakpoint, BaseColor, BaseProps, BaseVariant, BreakpointTokens, CSSPropertiesWithVars, ClearableProps, ColorMode, ColorModeValue, ColorProps, ColorScale, ColorTokens, ControlledProps, CustomRecipes, DeepPartial, DefaultRecipeCollection, DesignTokens, DisabledProps, Easing, EmbeddedProps, FontSizeTokens, FontTokens, FontWeightTokens, FormFieldStatus, FullWidthProps, IntensityMap, LetterSpacingTokens, LineHeightTokens, LoadingProps, Orientation, OrientationProps, RadiusTokens, RecipeCollection, RecipeCompoundVariant, RecipeDefinition, RecipeStyle, RecipeVariant, RecipeVariantValue, ReportedValidity, RequiredStateControlProps, ResolvedTokens, ResponsiveStyles, ResponsiveValue, SemanticColorTokens, SemanticToken, SemanticTokens, ShadowTokens, Size, SizeProps, SizeScale, SizeToken, SizeValue, SpacingTokens, StateControlProps, StateProps, StatusProps, StyleObject, StyleValue, Styleable, Theme, ThemeAnimation, ThemeOverride, ThemeTogglerTransition, ThemeTransition, TokenDefinition, TokenGroup, TokenReferenceString, TokenValue, TrimProps, Typography, TypographyProps, TypographyStyle, UndoRedoProps, ValidateOn, ValidateProps, ValidationResult, ValueProps, Variant, VariantProps };
+export type { AnimationTokens, BaseBreakpoint, BaseColor, BaseProps, BaseVariant, BreakpointTokens, CSSPropertiesWithVars, ClearableProps, ColorMode, ColorModeValue, ColorProps, ColorScale, ColorTokens, ControlledProps, CustomRecipes, DeepPartial, DefaultRecipeCollection, DesignTokens, DisabledProps, Easing, EmbeddedProps, FontSizeTokens, FontTokens, FontWeightTokens, FormFieldStatus, FullWidthProps, IntensityMap, LetterSpacingTokens, LineHeightTokens, LoadingProps, MotionGatedProps, Orientation, OrientationProps, RadiusTokens, RecipeCollection, RecipeCompoundVariant, RecipeDefinition, RecipeStyle, RecipeVariant, RecipeVariantValue, ReportedValidity, RequiredStateControlProps, ResolvedTokens, ResponsiveStyles, ResponsiveValue, SemanticColorTokens, SemanticToken, SemanticTokens, ShadowTokens, Size, SizeProps, SizeScale, SizeToken, SizeValue, SpacingTokens, StateControlProps, StateProps, StatusProps, StyleObject, StyleValue, Styleable, Theme, ThemeAnimation, ThemeOverride, ThemeTogglerTransition, ThemeTransition, TokenDefinition, TokenGroup, TokenReferenceString, TokenValue, TrimProps, Typography, TypographyProps, TypographyStyle, UndoRedoProps, ValidateOn, ValidateProps, ValidationResult, ValueProps, Variant, VariantProps };

package/dist/utils/index.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { CSSProperties } from 'react';
-import { ResponsiveValue, BaseBreakpoint, TypographyStyle, DesignTokens, SemanticTokens, ResolvedTokens } from '../types/index.js';
+import { MotionGatedProps, ResponsiveValue, BaseBreakpoint, TypographyStyle, DesignTokens, SemanticTokens, ResolvedTokens, StyleObject, RecipeStyle, StyleValue } from '../types/index.js';
 
 /**
  * Describes the common states a component can support.
@@ -211,6 +211,9 @@ declare function hasKuiMeta(value: unknown): value is {
 };
 /**
  * Lists the provider families available to Kreativ UI components.
+ *
+ * `controlled` is the provider state a child may declare via
+ * `requireProvider`, not Forge `video.controlled` (that list is keyof props).
  */
 interface KuiProviderRegistry {
     "Popover.Root": {
@@ -219,6 +222,15 @@ interface KuiProviderRegistry {
     "Menu.Root": {
         controlled: "open";
     };
+    "Form.Root": {
+        controlled: "values";
+    };
+    "FormField.Root": {
+        controlled: "invalid";
+    };
+    "Select.Root": {
+        controlled: "value" | "open";
+    };
 }
 /**
  * Describes a provider that a component requires from its parent tree.
@@ -261,6 +273,10 @@ interface KuiChildrenRegistry {
         roles: [];
         slots: ["List"];
     };
+    Card: {
+        roles: ["layout"];
+        slots: ["Card"];
+    };
 }
 /**
  * Validates the direct children of a compound component during development.
@@ -272,6 +288,7 @@ interface KuiChildrenRegistry {
  * @param children Children passed to the compound component.
  */
 declare function useValidateChildren<K extends keyof KuiChildrenRegistry>(parentKey: K, children: React.ReactNode): void;
+declare function isMotionGated(props: MotionGatedProps): boolean;
 
 type PossibleRef<T> = React.Ref<T> | undefined;
 declare function composeRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T>;
@@ -335,4 +352,51 @@ interface WarnOnFlatCompoundConflictOptions {
  */
 declare function warnOnFlatCompoundConflict({ flatValue, hasFlatValue, children, matchType, componentName, propName, childName, }: WarnOnFlatCompoundConflictOptions): boolean;
 
-export { type CreateComponentConfig, type CreateFromPropsInput, type KuiChildrenRegistry, type KuiComponent, type KuiInteractionState, type KuiMeta, type KuiProviderRegistry, type KuiProviderRequirement, type KuiRole, type KuiSkeletonHint, type KuiSupports, type KuiVideoMeta, type ResolvedResponsiveValue, type WarnOnFlatCompoundConflictOptions, composeRefs, createComponent, createFromProps, deepMerge, hasKuiMeta, isResponsiveValue, mergeResponsiveValue, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveTokenReference, resolveTokens, resolveTypography, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict };
+/**
+ * Resolves a `{token.path}` reference to a CSS var() call. Any other value
+ * passes through unchanged.
+ *
+ * "{colors.brand.500}" -> "var(--kui-colors-brand-500)"
+ * "1rem"                -> "1rem" (passthrough)
+ * 16                     -> 16 (passthrough)
+ */
+declare function resolveToken(value: StyleValue): StyleValue;
+/**
+ * Converts a camelCase CSS property name to kebab-case.
+ * `"backgroundColor"` -> `"background-color"`
+ */
+declare function kebabCase(prop: string): string;
+/**
+ * Serializes a StyleObject into a stable, sorted CSS declaration string.
+ * Filters out null/undefined values, resolves token references, kebab-cases
+ * property names, and sorts alphabetically by property name for a stable
+ * hash regardless of key insertion order.
+ */
+declare function serializeStyle(style: StyleObject): string;
+declare function hashStyle(input: string): string;
+/**
+ * Appends a raw CSS rule to the shared <style data-kui> tag.
+ * No-ops in non-browser environments (document === undefined).
+ */
+declare function injectStyle(className: string, declarations: string): void;
+/** Map-based dedup registry, keyed by generated class name. */
+declare const styleRegistry: Map<string, true>;
+/**
+ * Registers a class name's CSS if it hasn't been injected yet.
+ * Safe to call repeatedly with the same className — only injects once.
+ */
+declare function registerStyle(className: string, declarations: string): void;
+/**
+ * Serializes a StyleObject into CSS, hashes it into a stable `kui-<hash>`
+ * class name, registers the backing rule (dedup'd), and returns the class
+ * name for use in a className string.
+ */
+declare function cssToClass(style: StyleObject): string;
+/**
+ * Resolves a single RecipeStyle value to a class-name-safe string.
+ * Strings pass through unchanged; StyleObjects are routed through the
+ * atomic-CSS pipeline and resolve to a generated class name.
+ */
+declare function resolveStyle(value: RecipeStyle): string;
+
+export { type CreateComponentConfig, type CreateFromPropsInput, type KuiChildrenRegistry, type KuiComponent, type KuiInteractionState, type KuiMeta, type KuiProviderRegistry, type KuiProviderRequirement, type KuiRole, type KuiSkeletonHint, type KuiSupports, type KuiVideoMeta, type ResolvedResponsiveValue, type WarnOnFlatCompoundConflictOptions, composeRefs, createComponent, createFromProps, cssToClass, deepMerge, hasKuiMeta, hashStyle, injectStyle, isMotionGated, isResponsiveValue, kebabCase, mergeResponsiveValue, registerStyle, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveStyle, resolveToken, resolveTokenReference, resolveTokens, resolveTypography, serializeStyle, styleRegistry, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict };

package/dist/utils/index.js

@@ -1,3 +1,3 @@
-export { composeRefs, createComponent, createFromProps, deepMerge, hasKuiMeta, isResponsiveValue, mergeResponsiveValue, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveTokenReference, resolveTokens, resolveTypography, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict } from '../chunk-Q5PIXJRW.js';
+export { composeRefs, createComponent, createFromProps, cssToClass, deepMerge, hasKuiMeta, hashStyle, injectStyle, isMotionGated, isResponsiveValue, kebabCase, mergeResponsiveValue, registerStyle, requireProvider, resolveResponsiveValue, resolveSemanticTokenReferences, resolveStyle, resolveToken, resolveTokenReference, resolveTokens, resolveTypography, serializeStyle, styleRegistry, toKebabCase, toResponsiveClasses, tokensToCssVars, useValidateChildren, warnOnFlatCompoundConflict } from '../chunk-JIJ42ZVR.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splenddev/kreativ-core",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Design-system foundation for Kreativ UI — tokens, theming, recipes, and component primitives.",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/chunk-Q5PIXJRW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/createComponent.tsx","../src/utils/composeRefs.ts","../src/utils/createFromProps.ts","../src/utils/responsive.ts","../src/utils/deepMerge.ts","../src/utils/resolveTokenReference.ts","../src/utils/resolveTypography.ts","../src/utils/cssVariables.ts","../src/utils/warnOnFlatCompoundConflict.ts"],"names":["value","resolveValue","React2"],"mappings":"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","file":"chunk-Q5PIXJRW.js","sourcesContent":["import * as React from \"react\";\n\n/**\n * Describes the common states a component can support.\n *\n * These flags are used by Kreativ UI to communicate states such as\n * disabled, invalid, and required to consumers and supporting utilities.\n *\n * Additional state flags may be added by components when needed.\n */\nexport interface KuiSupports {\n  disabled?: boolean;\n  invalid?: boolean;\n  required?: boolean;\n  [key: string]: boolean | undefined;\n}\n\n/**\n * Describes the visual shape a component should use when represented\n * as a skeleton.\n *\n * Custom string values can be used when a component needs a specialized\n * skeleton representation.\n */\nexport type KuiSkeletonHint =\n  | \"text\"\n  | \"rect\"\n  | \"circle\"\n  | \"input-shaped\"\n  | \"preserve\"\n  | (string & {});\n\n/**\n * Identifies the primary purpose of a component.\n *\n * The role helps Kreativ UI and supporting tools understand how a\n * component behaves and how it should be treated in different contexts.\n */\nexport type KuiRole =\n  | \"action\"\n  | \"formControl\"\n  | \"overlay\"\n  | \"layout\"\n  | \"display\"\n  | \"disclosure\"\n  | \"navigation\"\n  | (string & {});\n\n/**\n * Interaction states that can be represented by a component.\n */\nexport type KuiInteractionState = \"hover\" | \"focus\" | \"pressed\";\n\n/**\n * Describes how a component can participate in Kreativ Forge.\n *\n * Components can optionally provide this metadata to enable video\n * editing and animation support without requiring Forge as a dependency.\n */\nexport interface KuiVideoMeta<P> {\n  /**\n   * Stable identifier used to reference the component in Forge projects.\n   */\n  id: string;\n\n  /**\n   * Indicates whether Forge can safely control and render the component.\n   *\n   * Components marked as unsafe are excluded from Forge's interactive\n   * component controls.\n   */\n  safe: boolean;\n\n  /**\n   * Indicates whether the component can contain other Forge elements.\n   */\n  acceptsChildren?: boolean;\n\n  /**\n   * Indicates that the component depends on context provided by\n   * an ancestor component.\n   */\n  needsParentContext?: boolean;\n\n  /**\n   * Identifies props that can reference project assets.\n   *\n   * Forge uses these declarations to provide the appropriate asset\n   * selection and resolution behavior.\n   */\n  assetProps?: Record<\n    string,\n    \"image\" | \"video\" | \"audio\" | \"font\" | \"snippet\" | \"icon\"\n  >;\n\n  /**\n   * Lists props whose values can be controlled by Forge.\n   */\n  controlled?: Array<keyof P>;\n\n  /**\n   * Specifies which interaction states Forge can represent for the component.\n   */\n  interactionStates?: KuiInteractionState[];\n\n  /**\n   * Indicates the component's motion is gated by Forge at render-start\n   * (timers/transitions/uncontrolled animation disabled during render),\n   * rather than driven as a per-frame controlled prop. Components marked\n   * `safe: true` must honor this gate.\n   */\n  motionGated?: boolean;\n}\n\n/**\n * Metadata describing a Kreativ UI component's capabilities and behavior.\n *\n * This metadata is attached to components and can be used by Kreativ UI,\n * development tools, and integrations such as Kreativ Forge.\n */\nexport interface KuiMeta<P = any> {\n  /**\n   * Identifies whether the component is a single or compound form control.\n   */\n  formControl?: \"single\" | \"compound\";\n\n  /**\n   * Describes the states supported by the component.\n   */\n  supports?: KuiSupports;\n\n  /**\n   * Defines the skeleton representation used while the component loads.\n   */\n  skeleton?: KuiSkeletonHint;\n\n  /**\n   * Identifies the component's primary role.\n   */\n  role?: KuiRole;\n\n  /**\n   * Identifies the component's slot when it participates in a compound component.\n   */\n  groupSlot?: string;\n\n  /**\n   * Optional Kreativ Forge integration metadata.\n   */\n  video?: KuiVideoMeta<P>;\n\n  /**\n   * Allowlist of props exposed in Forge's Properties tab, with the\n   * synthesized-group each belongs to.\n   */\n  editableProps?: Array<{\n    prop: keyof P;\n    group: string;\n    label?: string;\n  }>;\n\n  /**\n   * Declares which prop resolves typography (via Kui's `resolveTypography`),\n   * letting Forge synthesize a Typography group wired to that prop.\n   */\n  typographyProp?: {\n    prop: keyof P;\n    allowedPresets?: string[] | \"all\";\n    allowCustom?: boolean;\n    allowTokenReferences?: boolean;\n    customFields?: {\n      fontFamily?: boolean;\n      fontSize?: boolean;\n      fontWeight?: boolean;\n      lineHeight?: boolean;\n      letterSpacing?: boolean;\n    };\n  };\n\n  /**\n   * Declares which prop resolves a semantic color token, letting Forge\n   * synthesize a Color group wired to that prop.\n   */\n  colorProp?: {\n    prop: keyof P;\n    allowedTokens?: string[] | \"all\";\n  };\n\n  /**\n   * Declares which prop resolves a size-scale token, letting Forge\n   * synthesize a Size group wired to that prop.\n   */\n  sizeProp?: {\n    prop: keyof P;\n    allowedSizes?: string[] | \"all\";\n  };\n}\n\n/**\n * A Kreativ UI component created with `createComponent`.\n *\n * In addition to normal React component behavior, Kreativ UI components\n * expose metadata describing their capabilities and role.\n */\nexport type KuiComponent<P, E> = React.ForwardRefExoticComponent<\n  React.PropsWithoutRef<P> & React.RefAttributes<E>\n> & {\n  __kui: KuiMeta<P>;\n\n  /**\n   * Describes a provider required by the component.\n   */\n  providerRequired?: KuiProviderRequirement;\n};\n\n/**\n * Configuration used to create a Kreativ UI component.\n */\nexport interface CreateComponentConfig<P, E> {\n  /**\n   * Metadata describing the component's capabilities and behavior.\n   */\n  __kui: KuiMeta<P>;\n\n  /**\n   * Renders the component and receives its forwarded ref.\n   */\n  render: (props: P, ref: React.ForwardedRef<E>) => React.ReactElement | null;\n\n  /**\n   * Optional name used when displaying the component in development tools.\n   */\n  displayName?: string;\n}\n\n/**\n * Creates a Kreativ UI component with forwarded-ref support and\n * Kreativ UI metadata.\n *\n * @param config Component rendering function and metadata.\n * @returns A React component with Kreativ UI metadata attached.\n */\nexport function createComponent<P extends object, E = unknown>(\n  config: CreateComponentConfig<P, E>,\n): KuiComponent<P, E> {\n  const C = React.forwardRef(\n    config.render as unknown as React.ForwardRefRenderFunction<E, any>,\n  ) as unknown as KuiComponent<P, E>;\n\n  if (config.displayName) C.displayName = config.displayName;\n\n  C.__kui = config.__kui;\n  return C;\n}\n\n/**\n * Checks whether a value is a Kreativ UI component with component metadata.\n *\n * Useful when working with component types dynamically, such as when\n * inspecting children of compound components.\n *\n * @param value Value to inspect.\n * @returns `true` when the value contains valid Kreativ UI metadata.\n */\nexport function hasKuiMeta(value: unknown): value is { __kui: KuiMeta } {\n  return (\n    (typeof value === \"function\" ||\n      (typeof value === \"object\" && value !== null)) &&\n    \"__kui\" in (value as object) &&\n    typeof (value as { __kui: unknown }).__kui === \"object\" &&\n    (value as { __kui: unknown }).__kui !== null\n  );\n}\n\n/**\n * Lists the provider families available to Kreativ UI components.\n */\nexport interface KuiProviderRegistry {\n  \"Popover.Root\": { controlled: \"open\" };\n  \"Menu.Root\": { controlled: \"open\" };\n}\n\n/**\n * Describes a provider that a component requires from its parent tree.\n */\nexport interface KuiProviderRequirement<\n  C extends keyof KuiProviderRegistry = keyof KuiProviderRegistry,\n> {\n  /**\n   * Identifies the provider component that must be present.\n   */\n  component: C;\n\n  /**\n   * Human-readable description of the provider requirement.\n   */\n  label: string;\n\n  /**\n   * Lists provider state values that can be controlled by the parent provider.\n   */\n  controlled?: Array<KuiProviderRegistry[C][\"controlled\"]>;\n}\n\n/**\n * Declares that a component requires a specific provider ancestor.\n *\n * Use this when a component is intended to be rendered as part of a\n * provider-based component such as Popover or Menu.\n *\n * @param component Provider component that must be present (e.g. \"Popover.Root\").\n * @param opts Provider requirement details (label, controlled state).\n * @returns A requirement descriptor; attach it via `component.providerRequired = ...`\n * or pass the target component separately depending on call site.\n */\nexport function requireProvider<C extends keyof KuiProviderRegistry>(\n  component: C,\n  opts: Omit<KuiProviderRequirement<C>, \"component\">,\n): KuiProviderRequirement<C> {\n  return { component, ...opts };\n}\n\n/**\n * Defines the child roles and slots accepted by a compound component.\n */\nexport interface KuiChildrenRegistry {\n  ButtonGroup: { roles: [\"action\"]; slots: [\"ButtonGroup\"] };\n  List: { roles: []; slots: [\"List\"] };\n}\n\n/**\n * Validates the direct children of a compound component during development.\n *\n * Unexpected children produce a development warning. Validation is skipped\n * in production builds.\n *\n * @param parentKey Compound component whose children are being validated.\n * @param children Children passed to the compound component.\n */\nexport function useValidateChildren<K extends keyof KuiChildrenRegistry>(\n  parentKey: K,\n  children: React.ReactNode,\n): void {\n  if (process.env.NODE_ENV === \"production\") return;\n\n  React.Children.forEach(children, (child) => {\n    if (!React.isValidElement(child)) return;\n\n    const type = child.type;\n\n    if (!hasKuiMeta(type)) return;\n\n    const meta = (type as { __kui: KuiMeta }).__kui;\n\n    const allowedRoles: readonly string[] =\n      KUI_CHILDREN_REGISTRY_ALLOWED[parentKey]?.roles ?? [];\n\n    const allowedSlots: readonly string[] =\n      KUI_CHILDREN_REGISTRY_ALLOWED[parentKey]?.slots ?? [];\n\n    const roleOk = meta.role ? allowedRoles.includes(meta.role) : false;\n\n    const slotOk = meta.groupSlot\n      ? allowedSlots.includes(meta.groupSlot)\n      : false;\n\n    if (!roleOk && !slotOk) {\n      const name =\n        (type as { displayName?: string }).displayName ?? \"component\";\n\n      console.warn(\n        `[kreativ-ui] ${String(parentKey)} received an unexpected child \"${name}\" ` +\n          `(role: ${meta.role ?? \"none\"}, groupSlot: ${meta.groupSlot ?? \"none\"}). ` +\n          `Expected role in [${allowedRoles.join(\", \")}] or groupSlot in [${allowedSlots.join(\", \")}].`,\n      );\n    }\n  });\n}\n\nconst KUI_CHILDREN_REGISTRY_ALLOWED = {\n  ButtonGroup: { roles: [\"action\"], slots: [\"ButtonGroup\"] },\n  List: { roles: [], slots: [\"List\"] },\n} satisfies {\n  [K in keyof KuiChildrenRegistry]: {\n    roles: KuiChildrenRegistry[K][\"roles\"];\n    slots: KuiChildrenRegistry[K][\"slots\"];\n  };\n};\n","import type * as React from \"react\";\ntype PossibleRef<T> = React.Ref<T> | undefined;\n\nexport function composeRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T> {\n  return (node) => {\n    for (const ref of refs) {\n      if (typeof ref === \"function\") ref(node);\n      else if (ref) (ref as React.MutableRefObject<T | null>).current = node;\n    }\n  };\n}\n","export interface CreateFromPropsInput<T extends object> {\n  providerDefaults?: Partial<T>;\n  defaultProps?: Partial<T>;\n  generatedProps?: Partial<T>;\n  consumerProps?: Partial<T>;\n}\nexport function createFromProps<T extends object>(input: CreateFromPropsInput<T>): T {\n  return {\n    ...input.providerDefaults,\n    ...input.defaultProps,\n    ...input.generatedProps,\n    ...input.consumerProps,\n  } as T;\n}\n","import type { BaseBreakpoint, ResponsiveValue } from \"@/types\";\n\nexport function isResponsiveValue<T>(\n  value: ResponsiveValue<T>,\n): value is Partial<Record<\"base\" | BaseBreakpoint, T>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport interface ResolvedResponsiveValue<T> {\n  base?: T;\n  responsive: Record<string, T>;\n}\n\nexport function resolveResponsiveValue<T, B extends string = string>(\n  value: ResponsiveValue<T, B>,\n): ResolvedResponsiveValue<T> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    return {\n      base: value,\n      responsive: {},\n    };\n  }\n\n  const responsiveValue = value as Partial<Record<\"base\" | B, T>>;\n\n  const { base, ...responsive } = responsiveValue;\n\n  return {\n    base,\n    responsive: Object.fromEntries(\n      Object.entries(responsive).filter(([, value]) => value !== undefined),\n    ) as Record<string, T>,\n  };\n}\n\nexport function toResponsiveClasses<T>(\n  value: ResolvedResponsiveValue<T>,\n  resolve: (value: T) => string,\n): string {\n  const classes: string[] = [];\n\n  if (value.base !== undefined) {\n    classes.push(resolve(value.base));\n  }\n\n  for (const [breakpoint, item] of Object.entries(value.responsive)) {\n    classes.push(\n      item\n        ? item\n            .toString()\n            .split(\" \")\n            .map((className) => `${breakpoint}:${className}`)\n            .join(\" \")\n        : \"\",\n    );\n  }\n\n  return classes.filter(Boolean).join(\" \");\n}\n\nexport function mergeResponsiveValue<T, B extends string = string>(\n  defaults: ResponsiveValue<T, B>,\n  value?: ResponsiveValue<T, B>,\n): ResolvedResponsiveValue<T> {\n  const defaultValue = resolveResponsiveValue(defaults);\n\n  if (value === undefined) {\n    return defaultValue;\n  }\n\n  const overrideValue = resolveResponsiveValue(value);\n\n  return {\n    base: overrideValue.base ?? defaultValue.base,\n    responsive: {\n      ...defaultValue.responsive,\n      ...overrideValue.responsive,\n    },\n  };\n}\n","function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function deepMerge<T>(base: T, override?: unknown): T {\n  if (override === undefined) {\n    return base;\n  }\n\n  if (!isPlainObject(base) || !isPlainObject(override)) {\n    return override as T;\n  }\n\n  const result: Record<string, unknown> = {\n    ...base,\n  };\n\n  for (const [key, value] of Object.entries(override)) {\n    const existing = result[key];\n\n    if (isPlainObject(existing) && isPlainObject(value)) {\n      result[key] = deepMerge(existing, value);\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result as T;\n}\n","import type { DesignTokens } from \"@/types\";\r\n\r\nexport function resolveTokenReference(\r\n  value: unknown,\r\n  tokens: DesignTokens,\r\n): string | number {\r\n  if (typeof value !== \"string\") {\r\n    return typeof value === \"number\" ? value : \"\";\r\n  }\r\n\r\n  const match = value.match(/^\\{(.+)\\}$/);\r\n\r\n  if (!match || match[1] === undefined) {\r\n    return value;\r\n  }\r\n\r\n  const path = match[1].split(\".\");\r\n\r\n  let current: unknown = tokens;\r\n\r\n  for (const key of path) {\r\n    if (typeof current !== \"object\" || current === null || !(key in current)) {\r\n      return \"\";\r\n    }\r\n\r\n    current = (current as Record<string, unknown>)[key];\r\n  }\r\n\r\n  if (typeof current === \"object\" && current !== null && \"value\" in current) {\r\n    const tokenValue = (current as { value: unknown }).value;\r\n\r\n    if (typeof tokenValue === \"string\" || typeof tokenValue === \"number\") {\r\n      return tokenValue;\r\n    }\r\n\r\n    return \"\";\r\n  }\r\n\r\n  return typeof current === \"string\" || typeof current === \"number\"\r\n    ? current\r\n    : \"\";\r\n}\r\n","import type { CSSProperties } from \"react\";\r\nimport type { DesignTokens, TypographyStyle } from \"@/types\";\r\nimport { resolveTokenReference } from \"./resolveTokenReference\";\r\n\r\nexport function resolveTypography(\r\n  typography: TypographyStyle | undefined,\r\n  tokens: DesignTokens,\r\n): CSSProperties {\r\n  if (!typography) return {};\r\n\r\n  return {\r\n    fontFamily: resolveTokenReference(typography.fontFamily, tokens) as string,\r\n    fontSize: resolveTokenReference(typography.fontSize, tokens) as string,\r\n    fontWeight: resolveTokenReference(typography.fontWeight, tokens),\r\n    lineHeight: resolveTokenReference(typography.lineHeight, tokens),\r\n    letterSpacing: resolveTokenReference(\r\n      typography.letterSpacing,\r\n      tokens,\r\n    ) as string,\r\n  };\r\n}\r\n","import type {\r\n  DesignTokens,\r\n  ResolvedTokens,\r\n  SemanticTokens,\r\n  TokenDefinition,\r\n} from \"@/types\";\r\n\r\nexport function toKebabCase(str: string): string {\r\n  return str.replace(/([a-z0-9])([A-Z])/g, \"$1-$2\").toLowerCase();\r\n}\r\nfunction colorToRgbChannels(value: string): string {\r\n  const trimmed = value.trim();\r\n\r\n  const rgbMatch = trimmed.match(\r\n    /^rgba?\\(\\s*(\\d+(?:\\.\\d+)?)\\s*[,\\s]\\s*(\\d+(?:\\.\\d+)?)\\s*[,\\s]\\s*(\\d+(?:\\.\\d+)?)(?:\\s*[/,]\\s*[\\d.]+%?)?\\s*\\)$/i,\r\n  );\r\n\r\n  if (rgbMatch) {\r\n    return `${rgbMatch[1]} ${rgbMatch[2]} ${rgbMatch[3]}`;\r\n  }\r\n\r\n  if (trimmed.startsWith(\"#\")) {\r\n    const hex = trimmed.slice(1);\r\n\r\n   if (hex.length === 3) {\r\n     const r = parseInt(hex.slice(0, 1).repeat(2), 16);\r\n     const g = parseInt(hex.slice(1, 2).repeat(2), 16);\r\n     const b = parseInt(hex.slice(2, 3).repeat(2), 16);\r\n\r\n     return `${r} ${g} ${b}`;\r\n   }\r\n\r\n    if (hex.length === 6) {\r\n      const r = parseInt(hex.slice(0, 2), 16);\r\n      const g = parseInt(hex.slice(2, 4), 16);\r\n      const b = parseInt(hex.slice(4, 6), 16);\r\n\r\n      return `${r} ${g} ${b}`;\r\n    }\r\n  }\r\n\r\n  if (/^\\d+(?:\\.\\d+)?\\s+\\d+(?:\\.\\d+)?\\s+\\d+(?:\\.\\d+)?$/.test(trimmed)) {\r\n    return trimmed;\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\nfunction getTokenValue(\r\n  reference: string,\r\n  tokens: DesignTokens,\r\n): string | number | undefined {\r\n  const path = reference.replace(/^\\{/, \"\").replace(/\\}$/, \"\").split(\".\");\r\n\r\n  let current: unknown = tokens;\r\n\r\n  for (const segment of path) {\r\n    if (\r\n      typeof current !== \"object\" ||\r\n      current === null ||\r\n      !(segment in current)\r\n    ) {\r\n      return undefined;\r\n    }\r\n\r\n    current = (current as Record<string, unknown>)[segment];\r\n  }\r\n\r\n  if (typeof current === \"object\" && current !== null && \"value\" in current) {\r\n    const value = (current as TokenDefinition).value;\r\n\r\n    if (typeof value === \"string\" || typeof value === \"number\") {\r\n      return value;\r\n    }\r\n  }\r\n\r\n  return undefined;\r\n}\r\n\r\nfunction resolveReference(\r\n  reference: string,\r\n  tokens: DesignTokens,\r\n  seen = new Set<string>(),\r\n): string | undefined {\r\n  if (seen.has(reference)) {\r\n    console.error(\r\n      `[kreativ-core] Circular token reference detected: ${reference}`,\r\n    );\r\n\r\n    return undefined;\r\n  }\r\n\r\n  const nextSeen = new Set(seen);\r\n  nextSeen.add(reference);\r\n\r\n  const value = getTokenValue(reference, tokens);\r\n\r\n  if (value === undefined) {\r\n    console.warn(\r\n      `[kreativ-core] Unable to resolve token reference: ${reference}`,\r\n    );\r\n\r\n    return undefined;\r\n  }\r\n\r\n  if (typeof value === \"number\") {\r\n    return String(value);\r\n  }\r\n\r\n  if (value.startsWith(\"{\") && value.endsWith(\"}\")) {\r\n    return resolveReference(value, tokens, nextSeen);\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\nfunction resolveValue(\r\n  value: unknown,\r\n  tokens: DesignTokens,\r\n): string | undefined {\r\n  if (typeof value === \"number\") {\r\n    return String(value);\r\n  }\r\n\r\n  if (typeof value !== \"string\") {\r\n    return undefined;\r\n  }\r\n\r\n  if (value.startsWith(\"{\") && value.endsWith(\"}\")) {\r\n    return resolveReference(value, tokens);\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\nfunction flattenTokens(\r\n  value: unknown,\r\n  path: string[],\r\n  result: ResolvedTokens,\r\n  tokens: DesignTokens,\r\n): void {\r\n  if (typeof value !== \"object\" || value === null) {\r\n    return;\r\n  }\r\n\r\n  if (\"value\" in value) {\r\n    const tokenValue = (value as TokenDefinition).value;\r\n\r\n    const resolved = resolveValue(tokenValue, tokens);\r\n\r\n    if (resolved !== undefined) {\r\n      result[path.join(\".\")] = resolved;\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  for (const [key, child] of Object.entries(value as Record<string, unknown>)) {\r\n    flattenTokens(child, [...path, key], result, tokens);\r\n  }\r\n}\r\n\r\nfunction resolveSemanticValue(\r\n  value: unknown,\r\n  mode: \"light\" | \"dark\",\r\n  tokens: DesignTokens,\r\n): string | undefined {\r\n  if (\r\n    typeof value === \"object\" &&\r\n    value !== null &&\r\n    \"light\" in value &&\r\n    \"dark\" in value\r\n  ) {\r\n    const modeValue = (\r\n      value as {\r\n        light: unknown;\r\n        dark: unknown;\r\n      }\r\n    )[mode];\r\n\r\n    return resolveValue(modeValue, tokens);\r\n  }\r\n\r\n  return resolveValue(value, tokens);\r\n}\r\n\r\nfunction resolveSemanticTokens(\r\n  semanticTokens: SemanticTokens,\r\n  tokens: DesignTokens,\r\n  mode: \"light\" | \"dark\",\r\n): ResolvedTokens {\r\n  const result: ResolvedTokens = {};\r\n\r\n  function walk(value: unknown, path: string[]): void {\r\n    if (typeof value !== \"object\" || value === null) {\r\n      return;\r\n    }\r\n\r\n    if (\"value\" in value) {\r\n      const semanticValue = (value as TokenDefinition).value;\r\n\r\n      const resolved = resolveSemanticValue(semanticValue, mode, tokens);\r\n\r\n      if (resolved !== undefined) {\r\n        result[path.join(\".\")] = resolved;\r\n      }\r\n\r\n      return;\r\n    }\r\n\r\n    for (const [key, child] of Object.entries(\r\n      value as Record<string, unknown>,\r\n    )) {\r\n      walk(child, [...path, key]);\r\n    }\r\n  }\r\n\r\n  walk(semanticTokens, []);\r\n\r\n  return result;\r\n}\r\n\r\nexport function resolveTokens(\r\n  tokens: DesignTokens,\r\n  semanticTokens: SemanticTokens,\r\n  mode: \"light\" | \"dark\",\r\n): ResolvedTokens {\r\n  const primitiveTokens: ResolvedTokens = {};\r\n\r\n  flattenTokens(tokens, [], primitiveTokens, tokens);\r\n\r\n  const resolvedSemanticTokens = resolveSemanticTokens(\r\n    semanticTokens,\r\n    tokens,\r\n    mode,\r\n  );\r\n\r\n  return {\r\n    ...primitiveTokens,\r\n    ...resolvedSemanticTokens,\r\n  };\r\n}\r\n\r\nexport function resolveSemanticTokenReferences(\r\n  tokens: DesignTokens,\r\n  semanticTokens: SemanticTokens,\r\n): SemanticTokens {\r\n  function resolveValue(value: unknown, seen = new Set<string>()): unknown {\r\n    if (typeof value === \"string\") {\r\n      if (!value.startsWith(\"{\") || !value.endsWith(\"}\")) {\r\n        return value;\r\n      }\r\n\r\n      if (seen.has(value)) {\r\n        console.error(\r\n          `[kreativ-core] Circular token reference detected: ${value}`,\r\n        );\r\n\r\n        return value;\r\n      }\r\n\r\n      const resolved = getTokenValue(value, tokens);\r\n\r\n      if (resolved === undefined) {\r\n        console.warn(\r\n          `[kreativ-core] Unable to resolve token reference: ${value}`,\r\n        );\r\n\r\n        return value;\r\n      }\r\n\r\n      const nextSeen = new Set(seen);\r\n      nextSeen.add(value);\r\n\r\n      return resolveValue(resolved, nextSeen);\r\n    }\r\n\r\n    if (Array.isArray(value)) {\r\n      return value.map((item) => resolveValue(item, seen));\r\n    }\r\n\r\n    if (typeof value === \"object\" && value !== null) {\r\n      return Object.fromEntries(\r\n        Object.entries(value).map(([key, child]) => [\r\n          key,\r\n          resolveValue(child, seen),\r\n        ]),\r\n      );\r\n    }\r\n\r\n    return value;\r\n  }\r\n\r\n  return resolveValue(semanticTokens) as SemanticTokens;\r\n}\r\n\r\nexport function tokensToCssVars(\r\n  tokens: ResolvedTokens,\r\n  mode: \"light\" | \"dark\",\r\n  intensity: number,\r\n  prefix = \"kui\",\r\n): Record<string, string> {\r\n  const cssVars: Record<string, string> = {};\r\n\r\n  for (const [path, value] of Object.entries(tokens)) {\r\n    const parts = path.split(\".\");\r\n    const [_first = \"\", second = \"\"] = parts;\r\n\r\n    const isSemanticColor = parts.length === 2 && parts[0] === \"colors\";\r\n\r\n    const isPrimitiveColor = parts.length >= 3 && parts[0] === \"colors\";\r\n\r\n    const varName = isSemanticColor\r\n      ? `--${prefix}-${toKebabCase(second)}`\r\n      : `--${prefix}-${parts.map(toKebabCase).join(\"-\")}`;\r\n\r\n    const outputValue =\r\n      isSemanticColor || isPrimitiveColor ? colorToRgbChannels(value) : value;\r\n\r\n    cssVars[varName] = outputValue;\r\n  }\r\n\r\n  return {\r\n    ...cssVars,\r\n\r\n    [`--${prefix}-mode`]: mode,\r\n    [`--${prefix}-intensity`]: String(intensity),\r\n  };\r\n}\r\n","import * as React from \"react\";\n\nexport interface WarnOnFlatCompoundConflictOptions {\n  /** The flat prop's value (or undefined/falsy if unset). */\n  flatValue: unknown;\n  /**\n   * Override for legitimately-falsy boolean flat props (e.g. a flat\n   * `open={false}` is still \"set\" and should be checked for conflict) —\n   * when provided, this takes precedence over checking flatValue's truthiness.\n   */\n  hasFlatValue?: boolean;\n  children: React.ReactNode;\n  /** The compound part's component reference to match against, e.g. FormField.Label */\n  matchType: React.ElementType;\n  componentName: string;\n  propName: string;\n  childName: string;\n}\n\n/**\n * Detects whether a flat prop (sugar for one specific named compound\n * part) and that same named child are both present in the same\n * render. Scoped ONLY to this named-flat-prop-vs-named-child\n * conflict — not the general flat-vs-compound API style choice\n * (e.g. Slider's flat-or-compound, which has no such conflict since\n * the two are mutually exclusive paths with no simultaneous-use case).\n *\n * Returns true when the matching named child is present, meaning the\n * caller should suppress its flat-prop-derived rendering and let the\n * explicit child win. Warns in dev when BOTH the flat prop and the\n * child are present, since that's very likely an authoring mistake.\n */\nexport function warnOnFlatCompoundConflict({\n  flatValue,\n  hasFlatValue,\n  children,\n  matchType,\n  componentName,\n  propName,\n  childName,\n}: WarnOnFlatCompoundConflictOptions): boolean {\n  const flatIsSet = hasFlatValue !== undefined ? hasFlatValue : Boolean(flatValue);\n\n  let childIsPresent = false;\n  React.Children.forEach(children, (child) => {\n    if (childIsPresent) return;\n    if (React.isValidElement(child) && child.type === matchType) {\n      childIsPresent = true;\n    }\n  });\n\n  if (flatIsSet && childIsPresent && process.env.NODE_ENV !== \"production\") {\n    console.warn(\n      `<${componentName}>: both the \\`${propName}\\` prop and a <${childName} /> child were provided. ` +\n        `The \\`${propName}\\` prop will be ignored in favor of the explicit <${childName} /> child. ` +\n        `Remove one of the two to resolve this warning.`\n    );\n  }\n\n  return childIsPresent;\n}\n"]}