{"$schema":"https:\/\/ui.particle.academy\/schema\/registry-item.json","name":"number-field","type":"registry:ui","title":"NumberField","description":"Numeric field with a number or null value: blank stays null, partial text never emits a wrong number, and the wheel does not change it.","package":"react-fancy","dependencies":["tailwind-merge"],"registryDependencies":["input","field","paste-pills","popover","image-pill","portal"],"files":[{"path":"components\/fancy\/number-field\/NumberField.tsx","content":"import { forwardRef, useEffect, useRef, useState, type KeyboardEvent } from \"react\";\nimport { useControllableState } from \"..\/lib\/hooks\/use-controllable-state\";\nimport { Input } from \"..\/input\";\nimport type { NumberFieldProps } from \".\/NumberField.types\";\n\n\/**\n * Plain decimal notation only. `Number()` alone is not safe here: it reads \"0x10\"\n * as 16 and \"Infinity\" as a number, and those are wrong numbers to emit.\n *\/\nconst NUMBER = \/^[+-]?(\\d+(\\.\\d*)?|\\.\\d+)([eE][+-]?\\d+)?$\/;\nconst WHOLE = \/^[+-]?\\d+$\/;\n\n\/** The number the text says, or `null` if it does not say one. *\/\nfunction parseNumber(text: string): number | null {\n  const trimmed = text.trim();\n  if (!NUMBER.test(trimmed)) return null;\n\n  const n = Number(trimmed);\n  if (!Number.isFinite(n)) return null;\n  \/\/ Past 2^53 a whole number rounds to a different one than was typed.\n  if (WHOLE.test(trimmed) && !Number.isSafeInteger(n)) return null;\n\n  return n === 0 ? 0 : n; \/\/ -0 is 0\n}\n\nfunction formatNumber(value: number | null): string {\n  return value === null ? \"\" : String(value);\n}\n\n\/** Decimal places in a number, so stepping can round away floating-point dust. *\/\nfunction decimals(n: number): number {\n  const [mantissa, exponent] = String(n).split(\"e\");\n  const places = (mantissa.split(\".\")[1] ?? \"\").length - Number(exponent ?? 0);\n  return Math.min(Math.max(places, 0), 100);\n}\n\nfunction stepped(\n  current: number | null,\n  direction: 1 | -1,\n  min: number | undefined,\n  max: number | undefined,\n  step: number,\n): number {\n  const base = min ?? 0;\n  const places = Math.max(decimals(step), decimals(base));\n  const at = (k: number) => Number((base + k * step).toFixed(places));\n  const position = ((current ?? 0) - base) \/ step;\n  const nudge = 1e-9;\n\n  \/\/ The next grid line in that direction, so an off-grid value lands on the grid.\n  let k =\n    direction === 1\n      ? Math.floor(position + nudge) + 1\n      : Math.ceil(position - nudge) - 1;\n\n  if (max !== undefined && at(k) > max) k = Math.floor((max - base) \/ step + nudge);\n  if (min !== undefined && at(k) < min) k = 0;\n\n  return at(k);\n}\n\nexport const NumberField = forwardRef<HTMLInputElement, NumberFieldProps>(\n  (\n    {\n      value,\n      defaultValue = null,\n      onValueChange,\n      min,\n      max,\n      step,\n      messages,\n      name,\n      form,\n      inputMode,\n      onKeyDown,\n      onBlur,\n      ...rest\n    },\n    ref,\n  ) => {\n    const [held, setValue] = useControllableState<number | null>(\n      value,\n      defaultValue,\n      onValueChange,\n    );\n    \/\/ A host's NaN or Infinity has no text form, so it reads as no number.\n    const current = typeof held === \"number\" && Number.isFinite(held) ? held : null;\n\n    \/*\n     * The text is held apart from the number because \"1.\" and \"-\" have no number\n     * that displays them. It only moves on its own when the number moved to\n     * something the text does not say: a change from outside, or a parent refusing\n     * this one.\n     *\/\n    const [text, setText] = useState(() => formatNumber(current));\n    if (parseNumber(text) !== current && text !== formatNumber(current)) {\n      setText(formatNumber(current));\n    }\n\n    const stepSize = typeof step === \"number\" && step > 0 ? step : 1;\n\n    const problem = (() => {\n      if (text.trim() !== \"\" && parseNumber(text) === null) {\n        return messages?.invalid ?? \"Enter a number.\";\n      }\n      if (current === null) return \"\";\n      if (min !== undefined && current < min) return messages?.min ?? `Must be at least ${min}.`;\n      if (max !== undefined && current > max) return messages?.max ?? `Must be at most ${max}.`;\n      if (typeof step === \"number\" && step > 0) {\n        const position = (current - (min ?? 0)) \/ step;\n        if (Math.abs(position - Math.round(position)) > 1e-9) {\n          return messages?.step ?? `Must be in steps of ${step}.`;\n        }\n      }\n      return \"\";\n    })();\n\n    \/\/ The text input has no min\/max\/step of its own, so a form learns of them here.\n    \/\/ Runs every render: click-to-edit mounts a fresh input.\n    const inputRef = useRef<HTMLInputElement | null>(null);\n    useEffect(() => {\n      inputRef.current?.setCustomValidity(problem);\n    });\n\n    const handleKeyDown = (e: KeyboardEvent<HTMLInputElement>) => {\n      onKeyDown?.(e);\n      if (e.defaultPrevented || rest.disabled || rest.readOnly) return;\n      if (e.key !== \"ArrowUp\" && e.key !== \"ArrowDown\") return;\n\n      e.preventDefault(); \/\/ or the caret jumps to the end of the text\n      const next = stepped(current, e.key === \"ArrowUp\" ? 1 : -1, min, max, stepSize);\n      setText(formatNumber(next));\n      if (next !== current) setValue(next);\n    };\n\n    return (\n      <div data-react-fancy-number-field=\"\">\n        <Input\n          aria-invalid={problem ? true : undefined}\n          aria-valuemax={max}\n          aria-valuemin={min}\n          aria-valuenow={current ?? undefined}\n          inputMode={\n            inputMode ??\n            \/\/ A numeric or decimal keypad has no minus sign on iOS, so those are\n            \/\/ only offered where a negative number cannot be valid.\n            (min !== undefined && min >= 0\n              ? typeof step === \"number\" && Number.isInteger(step)\n                ? \"numeric\"\n                : \"decimal\"\n              : \"text\")\n          }\n          role=\"spinbutton\"\n          {...rest}\n          ref={(el) => {\n            inputRef.current = el;\n            if (typeof ref === \"function\") ref(el);\n            else if (ref) ref.current = el;\n          }}\n          \/\/ Text, not `number`: a browser reports \"-\" and \"1e\" in a number input as\n          \/\/ an empty value, indistinguishable from blank, and turns the wheel into\n          \/\/ a value change on a focused field. Neither applies to a text input.\n          type=\"text\"\n          value={text}\n          onValueChange={(next) => {\n            setText(next);\n            const parsed = parseNumber(next);\n            if (parsed !== current) setValue(parsed);\n          }}\n          onKeyDown={handleKeyDown}\n          onBlur={(e) => {\n            setText(formatNumber(current));\n            onBlur?.(e);\n          }}\n        \/>\n        {\/* What a native submit posts: the number, never the half-typed text. *\/}\n        {name ? (\n          <input\n            type=\"hidden\"\n            name={name}\n            form={form}\n            disabled={rest.disabled}\n            value={formatNumber(current)}\n          \/>\n        ) : null}\n      <\/div>\n    );\n  },\n);\n\nNumberField.displayName = \"NumberField\";\n","type":"registry:ui","target":"components\/fancy\/number-field\/NumberField.tsx"},{"path":"components\/fancy\/number-field\/NumberField.types.ts","content":"import type { InputHTMLAttributes, ReactNode } from \"react\";\nimport type { InputAffixProps, InputBaseProps } from \"..\/lib\/components\/inputs\/inputs.types\";\n\n\/** Validation messages, for a host working in another language. *\/\nexport interface NumberFieldMessages {\n  \/** The text is not a number. Default: \"Enter a number.\" *\/\n  invalid?: string;\n  \/** Below `min`. Default: \"Must be at least {min}.\" *\/\n  min?: string;\n  \/** Above `max`. Default: \"Must be at most {max}.\" *\/\n  max?: string;\n  \/** Off the `step` grid. Default: \"Must be in steps of {step}.\" *\/\n  step?: string;\n}\n\nexport interface NumberFieldProps\n  extends InputBaseProps,\n    InputAffixProps,\n    Omit<\n      InputHTMLAttributes<HTMLInputElement>,\n      \"size\" | \"type\" | \"prefix\" | \"value\" | \"defaultValue\" | \"min\" | \"max\" | \"step\"\n    > {\n  \/** The number, or `null` when there is none. Blank is `null`, never `0`. *\/\n  value?: number | null;\n  \/** Starting value when uncontrolled. *\/\n  defaultValue?: number | null;\n  \/**\n   * The number, or `null` when the field is blank or its text is not a number\n   * (a partial `-`, `.` or `1e`, or anything else unreadable). Called only when\n   * the value actually changes.\n   *\/\n  onValueChange?: (value: number | null) => void;\n  \/**\n   * Lowest valid value. A typed value below it is emitted and reported as invalid,\n   * not rewritten: \"5\" may be on its way to \"50\". The arrow keys stop here.\n   *\/\n  min?: number;\n  \/** Highest valid value. Same rules as `min`. *\/\n  max?: number;\n  \/**\n   * What the arrow keys move by, on a grid counted from `min` (or 0). Declaring it\n   * also makes off-grid values invalid. Omitted or `\"any\"`, the arrows move by 1 and\n   * any number is valid.\n   *\/\n  step?: number | \"any\";\n  leading?: ReactNode;\n  trailing?: ReactNode;\n  messages?: NumberFieldMessages;\n}\n","type":"registry:ui","target":"components\/fancy\/number-field\/NumberField.types.ts"},{"path":"components\/fancy\/number-field\/index.ts","content":"export { NumberField } from \".\/NumberField\";\nexport type { NumberFieldProps, NumberFieldMessages } from \".\/NumberField.types\";\n","type":"registry:ui","target":"components\/fancy\/number-field\/index.ts"},{"path":"components\/fancy\/lib\/hooks\/use-controllable-state.ts","content":"import { useCallback, useRef, useState } from \"react\";\n\n\/**\n * One state slot that works controlled or uncontrolled.\n *\n * ---------------------------------------------------------------------------\n * Why the value is tracked in a ref (fixed 5.32.0)\n * ---------------------------------------------------------------------------\n *\n * This resolved a functional update against the RENDER CLOSURE's `value` and then\n * handed React an already-computed value:\n *\n *     const nextValue = typeof next === \"function\" ? next(value) : next;\n *     setUncontrolledValue(nextValue);\n *\n * So `setValue(fn)` twice in one batch had both calls compute from the same stale\n * `value`, and **the first update was silently lost.** React's own `setState`\n * updater form does not have that problem precisely because React resolves it\n * against the latest state; passing a pre-computed value gives that up.\n *\n * Found by a hook test that paste-held two items inside one `act()` and got one.\n * It is not an exotic case \u2014 any caller that loops, or handles two events in a\n * batch, hits it, and the symptom is a dropped update with nothing to indicate one\n * happened.\n *\n * The fix cannot be \"pass the updater to React\", because `onChange` has to be\n * called with the resulting value and an updater must stay pure \u2014 React may invoke\n * it twice (StrictMode), which would fire `onChange` twice. So the previous value\n * comes from a ref that is re-synced from the authoritative `value` on every render\n * and advanced on every set. Within a batch the ref carries intent; after a render\n * the real value wins.\n *\n * A side effect worth having: `setValue` no longer depends on `value`, so it is\n * stable for the life of the component.\n *\/\nexport function useControllableState<T>(\n  controlledValue: T | undefined,\n  defaultValue: T,\n  onChange?: (value: T) => void,\n): [T, (value: T | ((prev: T) => T)) => void] {\n  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);\n  const isControlled = controlledValue !== undefined;\n  const value = isControlled ? controlledValue : uncontrolledValue;\n\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  \/\/ Re-synced every render from whichever side owns the value. A controlled parent\n  \/\/ that ignores `onChange` therefore wins on the next render rather than being\n  \/\/ overridden by what this hook optimistically recorded.\n  const valueRef = useRef(value);\n  valueRef.current = value;\n\n  const isControlledRef = useRef(isControlled);\n  isControlledRef.current = isControlled;\n\n  const setValue = useCallback((next: T | ((prev: T) => T)) => {\n    const nextValue =\n      typeof next === \"function\"\n        ? (next as (prev: T) => T)(valueRef.current)\n        : next;\n\n    \/\/ Advance the ref BEFORE notifying, so a second call in the same batch builds\n    \/\/ on this one instead of on what the last render saw.\n    valueRef.current = nextValue;\n\n    if (!isControlledRef.current) {\n      setUncontrolledValue(nextValue);\n    }\n\n    onChangeRef.current?.(nextValue);\n  }, []);\n\n  return [value, setValue];\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/hooks\/use-controllable-state.ts"},{"path":"components\/fancy\/lib\/components\/inputs\/inputs.types.ts","content":"import type { ReactNode } from \"react\";\nimport type { Size } from \"..\/..\/utils\/types\";\n\n\/** Text direction of one option's label. *\/\nexport type OptionDir = \"ltr\" | \"rtl\" | \"auto\";\n\nexport type InputOption<V = string> =\n  | string\n  | {\n      value: V;\n      label: string;\n      disabled?: boolean;\n      description?: string;\n      \/**\n       * BCP 47 language of `label`, when it differs from the page's: a language\n       * switcher that names each language in itself (WCAG 3.1.2, language of\n       * parts). Rendered as `lang` on the element holding the label, including\n       * the selected-value display. Unset renders no attribute.\n       *\/\n      lang?: string;\n      \/**\n       * Direction of `label`: `\"rtl\"` for a right-to-left script inside a\n       * left-to-right control. `\"auto\"` is available; nothing is added when\n       * unset.\n       *\/\n      dir?: OptionDir;\n    };\n\nexport type InputOptionGroup<V = string> = {\n  label: string;\n  options: InputOption<V>[];\n};\n\n\/**\n * Edit vs. read-only display. In `\"view\"` mode an input renders the bound value\n * as static text instead of an interactive control \u2014 the React\/Inertia analog of\n * Livewire's public\/bindable properties. Declared here (rather than in `mode\/`)\n * to keep `InputBaseProps` free of an import cycle. Resolved per input via\n * {@link useFieldMode}: explicit prop \u2192 `<Form>`\/`<FormProvider>` context \u2192 `\"edit\"`.\n *\/\nexport type FieldMode = \"edit\" | \"view\";\n\nexport interface InputBaseProps {\n  size?: Size;\n  dirty?: boolean;\n  error?: string;\n  label?: string;\n  \/**\n   * Keep the label for assistive tech, but do not draw it.\n   *\n   * For a control whose options already say what it does \u2014 a filter toolbar's\n   * segmented switches, say \u2014 where a visible label is noise but an unnamed\n   * control is a bug. Without this the only choices were an unnamed control or\n   * a label the design does not have, and the silent one is the one that ships.\n   *\/\n  labelHidden?: boolean;\n  description?: string;\n  required?: boolean;\n  disabled?: boolean;\n  className?: string;\n  id?: string;\n  name?: string;\n  \/** `\"edit\"` (default) renders the control; `\"view\"` renders the value as text. Overrides the `<Form mode>` context. *\/\n  mode?: FieldMode;\n}\n\nexport type AffixPosition = \"inside\" | \"outside\";\n\nexport interface InputAffixProps {\n  prefix?: ReactNode;\n  suffix?: ReactNode;\n  prefixPosition?: AffixPosition;\n  suffixPosition?: AffixPosition;\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/components\/inputs\/inputs.types.ts"},{"path":"components\/fancy\/lib\/utils\/types.ts","content":"import type { ElementType } from \"react\";\n\nexport type Size = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\n\n\/**\n * What a navigation primitive owes a router.\n *\n * Every nav surface here \u2014 `Navbar.Item`, `Sidebar.Item`, `Menu.Item`,\n * `MobileMenu.Item`, `Breadcrumbs.Item` \u2014 used to hardcode a plain `<a href>`.\n * That is a FULL PAGE LOAD in every client-routed app, and the only way around\n * it was to nest a router `<Link>` inside the item: an anchor inside an anchor,\n * which is invalid HTML and the same nested-anchor shape that already cost this\n * suite an SSR hydration bug.\n *\n * `as` is the seam {@link ButtonProps.as} already had. It is router-agnostic on\n * purpose \u2014 one prop serves Inertia, TanStack Router, React Router and Next\n * rather than a package per router:\n *\n * ```tsx\n * \/\/ href-based routers (Inertia, Next)\n * <Navbar.Item as={Link} href=\"\/dashboard\">Dashboard<\/Navbar.Item>\n *\n * \/\/ to-based routers (TanStack Router, React Router) \u2014 `to` reaches the Link\n * \/\/ through the forwarded rest props\n * <Navbar.Item as={Link} to=\"\/dashboard\">Dashboard<\/Navbar.Item>\n * ```\n *\n * Link mode engages on `href` OR `as`, because a `to`-based router never passes\n * an `href` and would otherwise silently render the non-interactive fallback.\n *\/\nexport interface NavigableProps {\n  \/** Target URL. Renders link mode with a plain `<a>` unless `as` is given. *\/\n  href?: string;\n  \/**\n   * Link-mode element override \u2014 the component to render INSTEAD of the plain\n   * `<a>`, e.g. a router's `<Link>` so navigation happens client-side. Receives\n   * `className`, the item's `data-*` handles, and every unrecognized prop, so\n   * router-specific props (`to`, `params`, `preload`, `search`) pass straight\n   * through. Ignored in button mode.\n   *\/\n  as?: ElementType;\n}\n\n\/**\n * The full Tailwind v4 named color palette \u2014 every default hue, including all\n * five gray families \u2014 plus `brand`, the host's own colour. Components that\n * accept a `color` should type it as this so the whole palette is available.\n *\n * `brand` is not a hue. It resolves through three CSS variables the host sets\n * once, rather than through a Tailwind scale:\n *\n *   `--color-brand`, `--color-brand-contrast`, `--color-brand-hover`\n *\n * Three rather than one because a generated hover assumes \"same hue, darker\",\n * and a brand palette need not work that way \u2014 navy whose hover is gold cannot\n * be derived from navy by any amount of arithmetic. The host states it.\n *\/\nexport type Color =\n  \/\/ the host's own colour, resolved from CSS variables (see styles.css)\n  | \"brand\"\n  \/\/ grays\n  | \"slate\"\n  | \"gray\"\n  | \"zinc\"\n  | \"neutral\"\n  | \"stone\"\n  \/\/ hues\n  | \"red\"\n  | \"orange\"\n  | \"amber\"\n  | \"yellow\"\n  | \"lime\"\n  | \"green\"\n  | \"emerald\"\n  | \"teal\"\n  | \"cyan\"\n  | \"sky\"\n  | \"blue\"\n  | \"indigo\"\n  | \"violet\"\n  | \"purple\"\n  | \"fuchsia\"\n  | \"pink\"\n  | \"rose\";\n\n\/** Every value of {@link Color}, for building exhaustive class maps. *\/\nexport const COLORS = [\n  \"brand\",\n  \"slate\", \"gray\", \"zinc\", \"neutral\", \"stone\",\n  \"red\", \"orange\", \"amber\", \"yellow\", \"lime\", \"green\", \"emerald\", \"teal\",\n  \"cyan\", \"sky\", \"blue\", \"indigo\", \"violet\", \"purple\", \"fuchsia\", \"pink\", \"rose\",\n] as const satisfies readonly Color[];\n\nexport type Variant = \"solid\" | \"outline\" | \"ghost\" | \"soft\";\n\n\/** Button accepts the full Tailwind v4 palette (alias of {@link Color}). *\/\nexport type ButtonColor = Color;\n\n\/**\n * @deprecated Renamed to {@link ButtonColor}. `ActionColor` remains as an alias\n * for backward compatibility and will be removed in a future major version.\n *\/\nexport type ActionColor = ButtonColor;\n\nexport type Placement =\n  | \"top\"\n  | \"bottom\"\n  | \"left\"\n  | \"right\"\n  | \"top-start\"\n  | \"top-end\"\n  | \"bottom-start\"\n  | \"bottom-end\";\n","type":"registry:lib","target":"components\/fancy\/lib\/utils\/types.ts"},{"path":"components\/fancy\/lib\/utils\/cn.ts","content":"import { twMerge } from \"tailwind-merge\";\n\n\/**\n * A class value: a string, a number, a conditional map, an array of any of\n * those, or nothing. Mirrors what `clsx` accepted, because every component in\n * this package already passes these shapes.\n *\/\nexport type ClassValue =\n  | string\n  | number\n  | bigint\n  | null\n  | undefined\n  | false\n  | ClassDictionary\n  | ClassValue[];\n\ntype ClassDictionary = Record<string, unknown>;\n\n\/**\n * Flatten class values into a space-separated string.\n *\n * This was `clsx` until 2026-08-19. It is roughly twenty lines of logic, it\n * shipped as a RUNTIME dependency to every consumer of this package, and its\n * last commit was 801 days old \u2014 so it fell to the rule that third-party code\n * must be both approved and actively maintained. Owning it costs less than\n * carrying it.\n *\n * `tailwind-merge` deliberately stays: deciding which of two conflicting\n * Tailwind utilities wins requires modelling the entire utility space, which is\n * emphatically not twenty lines, and it is actively maintained.\n *\n * Falsy values are dropped \u2014 including `0` and `\"\"`, which is what `clsx` did\n * and what `tests\/cn.test.ts` pins. A truthy number is kept, because digits are\n * legal class names. `bigint` is admitted because clsx's signature did and\n * the compiler proved it reachable from two call sites here.\n *\/\nfunction flatten(value: ClassValue): string {\n  if (!value) return \"\";\n\n  if (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"bigint\") {\n    return String(value);\n  }\n\n  if (Array.isArray(value)) {\n    let out = \"\";\n    for (const item of value) {\n      const part = flatten(item);\n      if (part) out = out ? `${out} ${part}` : part;\n    }\n    return out;\n  }\n\n  let out = \"\";\n  for (const key in value) {\n    if (value[key]) out = out ? `${out} ${key}` : key;\n  }\n  return out;\n}\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(flatten(inputs));\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/utils\/cn.ts"},{"path":"components\/fancy\/lib\/hooks\/use-adornment-width.ts","content":"import { useCallback, useEffect, useState } from \"react\";\n\n\/**\n * Measure an inline adornment so the input can reserve exactly its width.\n *\n * ## Why this exists\n *\n * `leading` \/ `trailing` render ABSOLUTELY over the input, so they take no\n * space in flow and the input must be padded by hand to keep text clear of\n * them. That padding used to be a fixed `pl-9` \/ `pr-9` (now `ps-9` \/ `pe-9`) \u2014 36px, sized for a\n * single icon. Any wider adornment ran straight under the value: `leading =\n * \"https:\/\/\"` is roughly 50px, so `https:\/\/` and `fancy.app` rendered on top of\n * one another.\n *\n * A fixed padding cannot be right for arbitrary content, and these props accept\n * arbitrary content \u2014 a currency code, a unit, a protocol, a short label. So\n * the width is measured rather than assumed.\n *\n * Returns `0` until measured (and on the server), which is the signal to keep\n * the old fixed padding as a fallback: an unmeasured render is then no worse\n * than it was before, rather than unpadded.\n *\n * `ResizeObserver` rather than a one-shot read, because the width changes after\n * first paint for reasons the first paint cannot see \u2014 a webfont swapping in,\n * the adornment's own content changing, a container query resizing the text.\n *\/\nexport function useAdornmentWidth(): [(node: HTMLElement | null) => void, number] {\n  const [width, setWidth] = useState(0);\n  const [node, setNode] = useState<HTMLElement | null>(null);\n\n  const ref = useCallback((n: HTMLElement | null) => setNode(n), []);\n\n  useEffect(() => {\n    if (!node) {\n      setWidth(0);\n\n      return;\n    }\n\n    const read = () => setWidth(node.getBoundingClientRect().width);\n    read();\n\n    if (typeof ResizeObserver === \"undefined\") return;\n\n    const observer = new ResizeObserver(read);\n    observer.observe(node);\n\n    return () => observer.disconnect();\n  }, [node]);\n\n  return [ref, width];\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/hooks\/use-adornment-width.ts"},{"path":"components\/fancy\/lib\/components\/inputs\/InputWrapper.tsx","content":"import type { ReactNode } from \"react\";\nimport { cn } from \"..\/..\/utils\/cn\";\nimport type { AffixPosition } from \".\/inputs.types\";\nimport type { Size } from \"..\/..\/utils\/types\";\n\ninterface InputWrapperProps {\n  children: ReactNode;\n  prefix?: ReactNode;\n  suffix?: ReactNode;\n  prefixPosition?: AffixPosition;\n  suffixPosition?: AffixPosition;\n  size?: Size;\n  \/** Extra padding className to apply to the input when affixes are \"inside\" *\/\n  insidePrefixPadding?: string;\n  insideSuffixPadding?: string;\n}\n\n\/\/ NOTE: these must be COMPLETE, static class strings. Tailwind only detects\n\/\/ utilities it can see verbatim in the source \u2014 building the arbitrary variant\n\/\/ at runtime (e.g. `[&_input]:${\"pl-9\"}`) means `[&_input]:ps-9` is never\n\/\/ emitted to CSS, so the inside affix gets no padding and overlaps the text\n\/\/ (issue #6). Keep input\/select\/textarea spelled out here.\nconst insidePaddingLeft: Record<Size, string> = {\n  xs: \"[&_input]:ps-7 [&_select]:ps-7 [&_textarea]:ps-7\",\n  sm: \"[&_input]:ps-8 [&_select]:ps-8 [&_textarea]:ps-8\",\n  md: \"[&_input]:ps-9 [&_select]:ps-9 [&_textarea]:ps-9\",\n  lg: \"[&_input]:ps-10 [&_select]:ps-10 [&_textarea]:ps-10\",\n  xl: \"[&_input]:ps-11 [&_select]:ps-11 [&_textarea]:ps-11\",\n};\n\nconst insidePaddingRight: Record<Size, string> = {\n  xs: \"[&_input]:pe-7 [&_select]:pe-7 [&_textarea]:pe-7\",\n  sm: \"[&_input]:pe-8 [&_select]:pe-8 [&_textarea]:pe-8\",\n  md: \"[&_input]:pe-9 [&_select]:pe-9 [&_textarea]:pe-9\",\n  lg: \"[&_input]:pe-10 [&_select]:pe-10 [&_textarea]:pe-10\",\n  xl: \"[&_input]:pe-11 [&_select]:pe-11 [&_textarea]:pe-11\",\n};\n\nconst affixOutsideClasses =\n  \"inline-flex items-center border border-[color:var(--fancy-border-strong,var(--color-zinc-500))] bg-zinc-50 px-3 text-sm text-[color:var(--fancy-text-muted,var(--color-zinc-500))] dark:border-[color:var(--fancy-border-strong-dark,var(--color-zinc-500))] dark:bg-zinc-800 dark:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))]\";\n\nexport function InputWrapper({\n  children,\n  prefix,\n  suffix,\n  prefixPosition = \"inside\",\n  suffixPosition = \"inside\",\n  size = \"md\",\n}: InputWrapperProps) {\n  const hasInsidePrefix = prefix && prefixPosition === \"inside\";\n  const hasInsideSuffix = suffix && suffixPosition === \"inside\";\n  const hasOutsidePrefix = prefix && prefixPosition === \"outside\";\n  const hasOutsideSuffix = suffix && suffixPosition === \"outside\";\n  const hasOutside = hasOutsidePrefix || hasOutsideSuffix;\n\n  if (!prefix && !suffix) {\n    return <>{children}<\/>;\n  }\n\n  if (hasOutside) {\n    return (\n      <div data-react-fancy-input-wrapper=\"\" className=\"flex\">\n        {hasOutsidePrefix && (\n          <span className={cn(affixOutsideClasses, \"rounded-s-lg border-e-0\")}>\n            {prefix}\n          <\/span>\n        )}\n        <div\n          className={cn(\n            \"relative flex flex-1 items-center\",\n            hasInsidePrefix && \"relative\",\n          )}\n        >\n          {hasInsidePrefix && (\n            <span className=\"pointer-events-none absolute start-3 z-10 text-[color:var(--fancy-text-muted,var(--color-zinc-500))] dark:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))]\">\n              {prefix}\n            <\/span>\n          )}\n          <div\n            className={cn(\n              \"w-full [&>*]:w-full\",\n              hasOutsidePrefix && !hasOutsideSuffix && \"[&_input]:rounded-s-none [&_select]:rounded-s-none [&_textarea]:rounded-s-none\",\n              !hasOutsidePrefix && hasOutsideSuffix && \"[&_input]:rounded-e-none [&_select]:rounded-e-none [&_textarea]:rounded-e-none\",\n              hasOutsidePrefix && hasOutsideSuffix && \"[&_input]:rounded-none [&_select]:rounded-none [&_textarea]:rounded-none\",\n              hasInsidePrefix && insidePaddingLeft[size],\n            )}\n          >\n            {children}\n          <\/div>\n          {hasInsideSuffix && (\n            <span className=\"pointer-events-none absolute end-3 z-10 text-[color:var(--fancy-text-muted,var(--color-zinc-500))] dark:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))]\">\n              {suffix}\n            <\/span>\n          )}\n        <\/div>\n        {hasOutsideSuffix && (\n          <span className={cn(affixOutsideClasses, \"rounded-e-lg border-s-0\")}>\n            {suffix}\n          <\/span>\n        )}\n      <\/div>\n    );\n  }\n\n  \/\/ Both inside\n  return (\n    <div data-react-fancy-input-wrapper=\"\" className=\"relative flex items-center\">\n      {hasInsidePrefix && (\n        <span className=\"pointer-events-none absolute start-3 z-10 text-[color:var(--fancy-text-muted,var(--color-zinc-500))] dark:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))]\">\n          {prefix}\n        <\/span>\n      )}\n      <div\n        className={cn(\n          \"w-full\",\n          hasInsidePrefix && insidePaddingLeft[size],\n          hasInsideSuffix && insidePaddingRight[size],\n        )}\n      >\n        {children}\n      <\/div>\n      {hasInsideSuffix && (\n        <span className=\"pointer-events-none absolute end-3 z-10 text-[color:var(--fancy-text-muted,var(--color-zinc-500))] dark:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))]\">\n          {suffix}\n        <\/span>\n      )}\n    <\/div>\n  );\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/components\/inputs\/InputWrapper.tsx"},{"path":"components\/fancy\/lib\/components\/inputs\/inputs.utils.ts","content":"import { createElement, Fragment, type AriaAttributes, type ReactNode } from \"react\";\nimport type { Size } from \"..\/..\/utils\/types\";\nimport type { InputOption, OptionDir } from \".\/inputs.types\";\n\nexport const inputSizeClasses: Record<Size, string> = {\n  xs: \"px-2 py-1 text-xs rounded\",\n  sm: \"px-2.5 py-1.5 text-sm rounded-md\",\n  md: \"px-3 py-2 text-sm rounded-lg\",\n  lg: \"px-4 py-2.5 text-base rounded-lg\",\n  xl: \"px-5 py-3 text-lg rounded-xl\",\n};\n\nexport const labelSizeClasses: Record<Size, string> = {\n  xs: \"text-xs\",\n  sm: \"text-xs\",\n  md: \"text-sm\",\n  lg: \"text-sm\",\n  xl: \"text-base\",\n};\n\nexport function dirtyClasses(dirty?: boolean): string {\n  return dirty ? \"border-s-[3px] border-s-amber-400\" : \"\";\n}\n\nexport function dirtyRingClasses(dirty?: boolean): string {\n  return dirty ? \"ring-2 ring-amber-400\/50\" : \"\";\n}\n\n\/**\n * Validation text: the error message and the required asterisk of Field,\n * Checkbox and Switch. Reads the `error` theme token (CC-fancy-0018, 6.19.0);\n * its defaults clear WCAG 1.4.3's 4.5:1 for small text. red-600 is 4.77:1 on\n * white; red-400 is 5.74:1 on #1e1e24, 6.13:1 on zinc-900, 5.16:1 on zinc-800.\n * The old `text-red-500` was 3.81:1 on white and 3.91:1 on zinc-800.\n *\/\nexport const ERROR_TEXT =\n  \"text-[color:var(--fancy-error,var(--color-red-600))] dark:text-[color:var(--fancy-error-dark,var(--color-red-400))]\";\n\nexport function errorClasses(error?: string): string {\n  return error ? \"border-red-500 focus:ring-red-500\" : \"\";\n}\n\n\/**\n * What a control needs to expose its error and description to assistive\n * technology (6.20.0, K1 of the full-kit benchmark). Every form control had\n * rendered its `error` as a plain paragraph: no `aria-invalid`, no\n * `aria-describedby`, nothing announced.\n *\n * `errorId` \/ `descriptionId` go to `Field` (which renders the message with\n * those ids, the error as `role=\"alert\"`); `aria` goes on the control. The\n * description is only rendered while there is no error, so the control is\n * described by whichever of the two is on screen, after any id the host passed.\n *\/\nexport function fieldAria(\n  id: string,\n  {\n    error,\n    description,\n    describedBy,\n    invalid,\n  }: {\n    error?: unknown;\n    description?: unknown;\n    \/** The host's own `aria-describedby`, kept ahead of the message id. *\/\n    describedBy?: string;\n    \/** The host's own `aria-invalid` (NumberField, PhoneInput), kept when there is no `error`. *\/\n    invalid?: unknown;\n  },\n): {\n  errorId: string;\n  descriptionId: string;\n  aria: { \"aria-invalid\": AriaAttributes[\"aria-invalid\"]; \"aria-describedby\": string | undefined };\n} {\n  const errorId = `${id}-error`;\n  const descriptionId = `${id}-description`;\n  const own = error ? errorId : description ? descriptionId : undefined;\n  const ids = [describedBy, own].filter(Boolean).join(\" \");\n  return {\n    errorId,\n    descriptionId,\n    aria: {\n      \"aria-invalid\": error ? true : (invalid as AriaAttributes[\"aria-invalid\"]),\n      \"aria-describedby\": ids || undefined,\n    },\n  };\n}\n\nexport const inputBaseClasses =\n  \"border border-[color:var(--fancy-border-strong,var(--color-zinc-500))] bg-[color:var(--fancy-input,var(--color-white))] text-[color:var(--fancy-text,var(--color-zinc-900))] placeholder:text-[color:var(--fancy-text-muted,var(--color-zinc-500))] transition-[border-color,box-shadow] duration-150 focus:outline-none focus:ring-2 focus:ring-[color:var(--fancy-focus,var(--color-blue-500))]\/40 focus:border-[color:var(--fancy-focus,var(--color-blue-500))] disabled:opacity-50 disabled:cursor-not-allowed dark:border-[color:var(--fancy-border-strong-dark,var(--color-zinc-500))] dark:bg-[color:var(--fancy-input-dark,#1e1e24)] dark:text-[color:var(--fancy-text-dark,var(--color-zinc-100))] dark:placeholder:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))] dark:focus:border-[color:var(--fancy-focus-dark,var(--color-blue-400))] dark:focus:ring-[color:var(--fancy-focus-dark,var(--color-blue-400))]\/20\";\n\nexport function resolveOption<V = string>(\n  option: InputOption<V>,\n): Exclude<InputOption<V>, string> {\n  if (typeof option === \"string\") {\n    return { value: option as unknown as V, label: option };\n  }\n  return option;\n}\n\n\/**\n * The `lang` \/ `dir` attributes for the element holding an option's label.\n * Only the keys that are set, so an option without them renders exactly as it\n * did before 6.13.0.\n *\/\nexport function optionLangProps(option: { lang?: string; dir?: OptionDir } | null | undefined): {\n  lang?: string;\n  dir?: OptionDir;\n} {\n  const out: { lang?: string; dir?: OptionDir } = {};\n  if (option?.lang) out.lang = option.lang;\n  if (option?.dir) out.dir = option.dir;\n  return out;\n}\n\n\/**\n * An option's label as a view-mode value: wrapped in a span carrying its\n * `lang` \/ `dir` when it has them, the bare string otherwise.\n *\/\nexport function optionLabelNode(\n  option: { label: string; lang?: string; dir?: OptionDir } | null | undefined,\n  fallback?: ReactNode,\n): ReactNode {\n  if (!option) return fallback;\n  const attrs = optionLangProps(option);\n  return attrs.lang || attrs.dir ? createElement(\"span\", attrs, option.label) : option.label;\n}\n\n\/**\n * Several labels joined with \", \". Stays one plain string unless an option\n * carries `lang` \/ `dir`, so existing output does not change.\n *\/\nexport function optionLabelList(\n  options: Array<{ label: string; lang?: string; dir?: OptionDir } | string>,\n): ReactNode {\n  const tagged = options.some((o) => typeof o !== \"string\" && (o.lang || o.dir));\n  if (!tagged) return options.map((o) => (typeof o === \"string\" ? o : o.label)).join(\", \");\n  return options.map((o, i) =>\n    createElement(Fragment, { key: i }, i > 0 ? \", \" : null, typeof o === \"string\" ? o : optionLabelNode(o)),\n  );\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/components\/inputs\/inputs.utils.ts"},{"path":"components\/fancy\/lib\/components\/inputs\/mode\/FieldMode.context.ts","content":"import { createContext, useContext } from \"react\";\nimport type { FieldMode } from \"..\/inputs.types\";\n\nexport interface FieldModeContextValue {\n  mode: FieldMode;\n}\n\nexport const FieldModeContext = createContext<FieldModeContextValue | null>(null);\n\n\/**\n * Resolve the effective mode for an input. Precedence: an explicit prop wins,\n * then the nearest `<Form>` \/ `<FormProvider>` context, then `\"edit\"`.\n *\n * Deliberately tolerant (returns `\"edit\"` outside any provider) \u2014 unlike a slot\n * guard \u2014 so every input works standalone with zero context and existing call\n * sites behave identically.\n *\/\nexport function useFieldMode(explicit?: FieldMode): FieldMode {\n  const ctx = useContext(FieldModeContext);\n  return explicit ?? ctx?.mode ?? \"edit\";\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/components\/inputs\/mode\/FieldMode.context.ts"},{"path":"components\/fancy\/lib\/components\/inputs\/mode\/DisplayValue.tsx","content":"import type { KeyboardEvent, ReactNode } from \"react\";\nimport { cn } from \"..\/..\/..\/utils\/cn\";\nimport type { Size } from \"..\/..\/..\/utils\/types\";\nimport { inputSizeClasses } from \"..\/inputs.utils\";\n\nexport interface DisplayValueProps {\n  \/** The formatted value to show. Empty \/ null \/ undefined renders `empty`. *\/\n  children?: ReactNode;\n  size?: Size;\n  \/** Static adornment rendered before the value (mirrors an input's `leading`\/`prefix`). *\/\n  leading?: ReactNode;\n  \/** Static adornment rendered after the value (mirrors an input's `trailing`\/`suffix`). *\/\n  trailing?: ReactNode;\n  \/** Shown when the value is empty. Default `\u2014`. *\/\n  empty?: ReactNode;\n  \/** When true the value is clickable to enter edit mode (inline click-to-edit). *\/\n  interactive?: boolean;\n  \/** Called when an interactive value is activated (click \/ Enter \/ Space). *\/\n  onActivate?: () => void;\n  className?: string;\n}\n\nfunction isEmpty(value: ReactNode): boolean {\n  return value === null || value === undefined || value === \"\";\n}\n\n\/**\n * The read-only counterpart to an `<input>`. Renders a non-interactive value\n * with the same size rhythm as the editable control (reusing\n * {@link inputSizeClasses}) but without the border \/ background \/ focus ring.\n *\n * When `interactive` (inline click-to-edit), the value becomes a focusable,\n * hoverable target that calls `onActivate` on click \/ Enter \/ Space to swap in\n * the real control. Dropped into the SAME `Field` wrapper the editable control\n * uses, so label \/ description \/ error chrome stays byte-identical between the\n * display and the editor.\n *\n * Carries `data-react-fancy-display` \/ `data-mode=\"view\"` stable handles for\n * agents and tests (Human+ contract).\n *\/\nexport function DisplayValue({\n  children,\n  size = \"md\",\n  leading,\n  trailing,\n  empty = \"\u2014\",\n  interactive,\n  onActivate,\n  className,\n}: DisplayValueProps) {\n  const empties = isEmpty(children);\n\n  const onKeyDown = interactive\n    ? (e: KeyboardEvent<HTMLDivElement>) => {\n        if (e.key === \"Enter\" || e.key === \" \") {\n          e.preventDefault();\n          onActivate?.();\n        }\n      }\n    : undefined;\n\n  return (\n    <div\n      data-react-fancy-display=\"\"\n      data-mode=\"view\"\n      role={interactive ? \"button\" : undefined}\n      tabIndex={interactive ? 0 : undefined}\n      title={interactive ? \"Click to edit\" : undefined}\n      onClick={interactive ? onActivate : undefined}\n      onKeyDown={onKeyDown}\n      className={cn(\n        \"flex w-full items-center gap-2 text-[color:var(--fancy-text,var(--color-zinc-900))] dark:text-[color:var(--fancy-text-dark,var(--color-zinc-100))]\",\n        inputSizeClasses[size],\n        \/\/ Strip the editable box look \u2014 keep only the size\/padding rhythm.\n        \"border-0 bg-transparent px-0\",\n        interactive &&\n          \"-mx-2 cursor-text rounded-md px-2 outline-none transition-colors hover:bg-[color:var(--fancy-surface-muted,var(--color-zinc-100))] focus-visible:ring-2 focus-visible:ring-blue-500\/40 dark:hover:bg-[color:var(--fancy-surface-muted-dark,var(--color-zinc-800))]\",\n        empties && \"text-[color:var(--fancy-text-muted,var(--color-zinc-500))] dark:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))]\",\n        className,\n      )}\n    >\n      {leading && <span className=\"text-[color:var(--fancy-text-muted,var(--color-zinc-500))] dark:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))]\">{leading}<\/span>}\n      <span className=\"min-w-0 truncate\">{empties ? empty : children}<\/span>\n      {trailing && <span className=\"text-[color:var(--fancy-text-muted,var(--color-zinc-500))] dark:text-[color:var(--fancy-text-muted-dark,var(--color-zinc-400))]\">{trailing}<\/span>}\n    <\/div>\n  );\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/components\/inputs\/mode\/DisplayValue.tsx"},{"path":"components\/fancy\/lib\/components\/inputs\/mode\/useInlineEdit.ts","content":"import { useCallback, useState } from \"react\";\nimport type { FieldMode } from \"..\/inputs.types\";\n\nexport interface InlineEdit {\n  \/** Render the editable control (`true`) vs. the read-only value display (`false`). *\/\n  showControl: boolean;\n  \/** Whether view mode is interactive (click-to-edit) \u2014 i.e. `view` and not disabled. *\/\n  interactive: boolean;\n  \/** Enter edit mode (no-op unless interactive). *\/\n  enterEdit: () => void;\n  \/** Leave edit mode, back to the value display. *\/\n  exitEdit: () => void;\n}\n\n\/**\n * Inline click-to-edit for `mode=\"view\"`. The bound value shows as clean static\n * text; clicking it swaps in the focused control; blur returns to the display\n * (the control's `onChange` \/ `onBlur` fire as usual, so a host can persist on\n * commit). `mode=\"edit\"` is always the control; a **disabled** view stays static\n * text (no click-to-edit).\n *\n * This is the value of \"view mode\": tidy read-only surfaces where each field\n * becomes editable only when the user reaches for it.\n *\/\nexport function useInlineEdit(mode: FieldMode, disabled?: boolean): InlineEdit {\n  const [editing, setEditing] = useState(false);\n  const interactive = mode === \"view\" && !disabled;\n  const showControl = mode !== \"view\" || (interactive && editing);\n  const enterEdit = useCallback(() => {\n    if (interactive) setEditing(true);\n  }, [interactive]);\n  const exitEdit = useCallback(() => setEditing(false), []);\n  return { showControl, interactive, enterEdit, exitEdit };\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/components\/inputs\/mode\/useInlineEdit.ts"},{"path":"components\/fancy\/lib\/utils\/label-template.ts","content":"\/**\n * Fill a label template's `{name}` slots: `\"Digit {n} of {total}\"`,\n * `\"Open {host}\"`. Single braces, for translatable labels only; a slot with no\n * value stays as written. Literal replacement, never evaluated.\n *\/\nexport function fillLabel(template: string, values: Record<string, string | number>): string {\n  return template.replace(\/\\{(\\w+)\\}\/g, (whole: string, name: string) =>\n    Object.prototype.hasOwnProperty.call(values, name) ? String(values[name]) : whole,\n  );\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/utils\/label-template.ts"},{"path":"components\/fancy\/lib\/utils\/ime.ts","content":"type KeyLike = Pick<KeyboardEvent, \"isComposing\" | \"keyCode\">;\n\n\/**\n * True while this keydown belongs to an IME composition.\n *\n * A Japanese, Chinese or Korean typist presses Enter to ACCEPT the candidate\n * they are composing. A field that sends, adds or picks on Enter must ignore\n * that keypress, or the person who meant to finish a word sends half a\n * sentence instead.\n *\n * `isComposing` is the standard signal. Safari fires the confirming keydown\n * after `compositionend`, with `isComposing` already false but `keyCode` 229,\n * and older engines only ever set the keyCode, so both are read.\n *\n * Takes a native `KeyboardEvent` or a React synthetic one (via `nativeEvent`).\n *\/\nexport function isImeComposing(event: KeyLike | { nativeEvent: KeyLike }): boolean {\n  const e = \"nativeEvent\" in event ? event.nativeEvent : event;\n  return e.isComposing === true || e.keyCode === 229;\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/utils\/ime.ts"},{"path":"components\/fancy\/lib\/utils\/trigger-child.ts","content":"import {\n  cloneElement,\n  Fragment,\n  isValidElement,\n  useEffect,\n  useRef,\n  type ReactElement,\n  type ReactNode,\n  type Ref,\n  type RefObject,\n} from \"react\";\nimport { cn } from \".\/cn\";\nimport { composeRefs } from \".\/compose-refs\";\n\n\/**\n * How a popup trigger (Dropdown.Trigger, Popover.Trigger) treats its child.\n *\n * The ARIA that says \"this opens a popup\" (`aria-haspopup`, `aria-expanded`,\n * `aria-controls`) belongs on the element a screen reader focuses. Before\n * 6.22.2 both triggers put it on a role-less wrapper `<span>`, where axe flags\n * it (`aria-allowed-attr`, critical) and no screen reader announces it.\n *\n * - `clone`: the child is one element that is, or renders, the focusable\n *   control. The trigger merges its props onto it (the asChild pattern) and\n *   renders no wrapper. `aria` is false when the child's explicit role cannot\n *   carry popup ARIA (a `role=\"img\"` preview pill); `role` is set when a\n *   focusable host element has no role of its own (`<span tabIndex={0}>`), so\n *   the ARIA lands on a `button` rather than on another role-less element.\n * - `wrap`: the child is text, several nodes, a fragment, or a host element\n *   nothing can focus. The trigger renders its own element around it.\n *\/\nexport type TriggerChild =\n  | { mode: \"clone\"; element: ReactElement<Record<string, unknown>>; aria: boolean; role?: \"button\" }\n  | { mode: \"wrap\" };\n\n\/** The `aria-haspopup` values that name a kind of popup (WAI-ARIA 1.2). *\/\nexport type PopupKind = \"menu\" | \"listbox\" | \"tree\" | \"grid\" | \"dialog\";\n\n\/**\n * The ARIA a popup trigger carries: what it opens, whether it is open, and,\n * while it is, the id of the popup (which exists in the DOM only then).\n *\/\nexport function popupTriggerAria(kind: PopupKind, open: boolean, popupId: string) {\n  return {\n    \"aria-haspopup\": kind,\n    ...disclosureAria(open, popupId),\n  };\n}\n\n\/**\n * The ARIA of a disclosure button: whether the region it shows is open and,\n * while it is, that region's id. No `aria-haspopup`, which would promise a\n * menu, listbox or dialog the region is not (a plain panel of links).\n *\/\nexport function disclosureAria(open: boolean, regionId: string) {\n  return {\n    \"aria-expanded\": open,\n    \"aria-controls\": open ? regionId : undefined,\n  };\n}\n\n\/** Roles that allow both `aria-expanded` and `aria-haspopup` (WAI-ARIA 1.2). *\/\nconst POPUP_ROLES = new Set([\n  \"button\",\n  \"combobox\",\n  \"gridcell\",\n  \"link\",\n  \"menuitem\",\n  \"menuitemcheckbox\",\n  \"menuitemradio\",\n  \"tab\",\n  \"treeitem\",\n]);\n\nconst BUTTON_INPUTS = new Set([\"button\", \"submit\", \"reset\", \"image\"]);\n\nexport function classifyTriggerChild(children: ReactNode): TriggerChild {\n  if (!isValidElement(children) || children.type === Fragment) return { mode: \"wrap\" };\n  const element = children as ReactElement<Record<string, unknown>>;\n  const props = element.props;\n  const role = typeof props.role === \"string\" ? props.role : undefined;\n\n  \/\/ A component (Button, a consumer's own): it renders the focusable control\n  \/\/ and is expected to forward its props and ref onto it.\n  if (typeof element.type !== \"string\") {\n    return { mode: \"clone\", element, aria: role === undefined || POPUP_ROLES.has(role) };\n  }\n\n  const tag = element.type;\n  const tabIndex = props.tabIndex === undefined ? undefined : Number(props.tabIndex);\n  let native: \"popup\" | \"other\" | null = null;\n  if (tag === \"button\" || tag === \"summary\" || tag === \"select\") native = \"popup\";\n  else if (tag === \"a\" && props.href !== undefined) native = \"popup\";\n  else if (tag === \"input\" && props.type !== \"hidden\") {\n    native = BUTTON_INPUTS.has(String(props.type)) ? \"popup\" : \"other\";\n  } else if (tag === \"textarea\") native = \"other\";\n\n  const focusable = native !== null || (tabIndex !== undefined && tabIndex >= 0);\n  if (!focusable) return { mode: \"wrap\" };\n\n  if (role !== undefined) return { mode: \"clone\", element, aria: POPUP_ROLES.has(role) };\n  if (native === \"popup\") return { mode: \"clone\", element, aria: true };\n  if (native === \"other\") return { mode: \"clone\", element, aria: false };\n  return { mode: \"clone\", element, aria: true, role: \"button\" };\n}\n\n\/** The child's own ref (React 19 passes it as a prop). *\/\nexport function triggerChildRef(target: TriggerChild): Ref<HTMLElement> | undefined {\n  return target.mode === \"clone\" ? (target.element.props.ref as Ref<HTMLElement> | undefined) : undefined;\n}\n\n\/**\n * Merge a trigger's props onto its child.\n *\n * `owned` always applies: the popup's ARIA, its stable handle, its handlers.\n * A handler the child already has runs first, then the trigger's, so a child\n * that calls `preventDefault()` still opts out. `fallback` (props forwarded to\n * the trigger by its caller) fills only what the child leaves unset, except\n * `className`, which is joined. `ref` should already include the child's own.\n *\/\nexport function cloneTriggerChild(\n  element: ReactElement<Record<string, unknown>>,\n  {\n    owned,\n    fallback = {},\n    ref,\n  }: { owned: Record<string, unknown>; fallback?: Record<string, unknown>; ref: Ref<HTMLElement> },\n): ReactElement {\n  const own = element.props;\n  const merged: Record<string, unknown> = {};\n\n  for (const [k, v] of Object.entries(fallback)) {\n    if (k === \"className\") continue;\n    if (own[k] === undefined) merged[k] = v;\n  }\n  if (fallback.className !== undefined) {\n    \/\/ A child whose `className` styles something other than the element it\n    \/\/ renders (Tooltip: the bubble) names the prop that reaches that element.\n    const key = triggerClassNameProp(element.type) ?? \"className\";\n    merged[key] = cn(fallback.className as string, own[key] as string | undefined);\n  }\n\n  for (const [k, v] of Object.entries(owned)) {\n    const mine = own[k] ?? merged[k];\n    if (\/^on[A-Z]\/.test(k) && typeof v === \"function\" && typeof mine === \"function\") {\n      merged[k] = (...args: unknown[]) => {\n        (mine as (...a: unknown[]) => void)(...args);\n        (v as (...a: unknown[]) => void)(...args);\n      };\n    } else {\n      merged[k] = v;\n    }\n  }\n\n  merged.ref = ref;\n  return cloneElement(element, merged);\n}\n\n\/**\n * Static a component sets when its `className` does NOT style the element it\n * renders, naming the prop that does. Tooltip sets it to `\"triggerClassName\"`:\n * its `className` styles the bubble, so a trigger's classes go to its child.\n *\/\nexport const TRIGGER_CLASS_NAME_PROP = Symbol.for(\"react-fancy.triggerClassNameProp\");\n\nfunction triggerClassNameProp(type: unknown): string | undefined {\n  if ((typeof type !== \"function\" && typeof type !== \"object\") || type === null) return undefined;\n  const value = (type as Record<symbol, unknown>)[TRIGGER_CLASS_NAME_PROP];\n  return typeof value === \"string\" ? value : undefined;\n}\n\n\/\/ Bundlers replace `process.env.NODE_ENV` textually; without one, the\n\/\/ reference throws and we read that as production.\ndeclare const process: { env: Record<string, string | undefined> };\n\nfunction isDev(): boolean {\n  try {\n    return process.env.NODE_ENV !== \"production\";\n  } catch {\n    return false;\n  }\n}\n\n\/**\n * Development only: warn once when a trigger's `className` did not reach the\n * element the trigger anchors to. The trigger merges `className` onto its\n * child, and a child component decides where that goes; one that styles an\n * inner or portalled element with it (a bubble, a label) leaves the control\n * without the class, which fails silently. \"None of the classes are on the\n * element\" is the test, so a class that tailwind-merge drops in favour of the\n * child's own conflicting one does not trip it.\n *\/\nexport function useTriggerClassNameCheck(\n  anchorRef: RefObject<HTMLElement | null>,\n  className: string | undefined,\n  name: string,\n): void {\n  const warned = useRef(false);\n  useEffect(() => {\n    if (warned.current || !className || !isDev()) return;\n    const el = anchorRef.current;\n    if (!el) return;\n    const tokens = className.split(\/\\s+\/).filter(Boolean);\n    if (tokens.length === 0 || tokens.some((t) => el.classList.contains(t))) return;\n    warned.current = true;\n    console.warn(\n      `[react-fancy] ${name} className=\"${className}\" did not reach the element it anchors to ` +\n        `(<${el.tagName.toLowerCase()}>). The trigger merges className onto its child, and this child ` +\n        \"styles something else with it. Put the classes on the child's own element instead.\",\n    );\n  });\n}\n\nexport { composeRefs };\n","type":"registry:lib","target":"components\/fancy\/lib\/utils\/trigger-child.ts"},{"path":"components\/fancy\/lib\/hooks\/use-floating-position.ts","content":"import { useCallback, useEffect, useState, type RefObject } from \"react\";\nimport type { Placement } from \"..\/utils\/types\";\nimport { directionOf, type Direction } from \"..\/utils\/direction\";\n\ninterface FloatingPosition {\n  x: number;\n  y: number;\n  placement: Placement;\n  \/**\n   * The anchor's writing direction. Put it on the floating element as `dir`:\n   * a floating element is portalled to `<body>`, so without it a `dir` set on\n   * a wrapper (rather than on `<html>`) would not reach the popup.\n   *\/\n  dir: Direction;\n}\n\ninterface UseFloatingPositionOptions {\n  placement?: Placement;\n  offset?: number;\n  enabled?: boolean;\n}\n\nfunction getPosition(\n  anchor: DOMRect,\n  floating: DOMRect,\n  placement: Placement,\n  offset: number,\n  dir: Direction = \"ltr\",\n): FloatingPosition {\n  let x = 0;\n  let y = 0;\n  const base = placement.split(\"-\")[0] as \"top\" | \"bottom\" | \"left\" | \"right\";\n  const align = placement.split(\"-\")[1] as \"start\" | \"end\" | undefined;\n\n  switch (base) {\n    case \"top\":\n      x = anchor.left + anchor.width \/ 2 - floating.width \/ 2;\n      y = anchor.top - floating.height - offset;\n      break;\n    case \"bottom\":\n      x = anchor.left + anchor.width \/ 2 - floating.width \/ 2;\n      y = anchor.bottom + offset;\n      break;\n    case \"left\":\n      x = anchor.left - floating.width - offset;\n      y = anchor.top + anchor.height \/ 2 - floating.height \/ 2;\n      break;\n    case \"right\":\n      x = anchor.right + offset;\n      y = anchor.top + anchor.height \/ 2 - floating.height \/ 2;\n      break;\n  }\n\n  \/\/ `start` \/ `end` are LOGICAL: `bottom-start` lines the popup up with the\n  \/\/ anchor's inline-start edge, which is its RIGHT edge in RTL. The base side\n  \/\/ (`left` \/ `right`) stays physical, as the names say.\n  if (base === \"top\" || base === \"bottom\") {\n    const startEdge = dir === \"rtl\" ? anchor.right - floating.width : anchor.left;\n    const endEdge = dir === \"rtl\" ? anchor.left : anchor.right - floating.width;\n    if (align === \"start\") x = startEdge;\n    else if (align === \"end\") x = endEdge;\n  }\n\n  if (base === \"left\" || base === \"right\") {\n    if (align === \"start\") y = anchor.top;\n    else if (align === \"end\") y = anchor.bottom - floating.height;\n  }\n\n  \/\/ Viewport clamping\n  let finalPlacement = placement;\n  const vw = window.innerWidth;\n  const vh = window.innerHeight;\n\n  if (base === \"bottom\" && y + floating.height > vh) {\n    y = anchor.top - floating.height - offset;\n    finalPlacement = placement.replace(\"bottom\", \"top\") as Placement;\n  } else if (base === \"top\" && y < 0) {\n    y = anchor.bottom + offset;\n    finalPlacement = placement.replace(\"top\", \"bottom\") as Placement;\n  } else if (base === \"left\" && x < 0) {\n    \/\/ The sides flip too, so a `left` \/ `right` popup is not clamped back on\n    \/\/ top of its own anchor when the viewport edge is close.\n    x = anchor.right + offset;\n    finalPlacement = placement.replace(\"left\", \"right\") as Placement;\n  } else if (base === \"right\" && x + floating.width > vw) {\n    x = anchor.left - floating.width - offset;\n    finalPlacement = placement.replace(\"right\", \"left\") as Placement;\n  }\n\n  x = Math.max(4, Math.min(x, vw - floating.width - 4));\n  y = Math.max(4, Math.min(y, vh - floating.height - 4));\n\n  return { x, y, placement: finalPlacement, dir };\n}\n\nexport function useFloatingPosition(\n  anchorRef: RefObject<HTMLElement | null>,\n  floatingRef: RefObject<HTMLElement | null>,\n  options: UseFloatingPositionOptions = {},\n): FloatingPosition {\n  const { placement = \"bottom\", offset = 8, enabled = true } = options;\n  const [position, setPosition] = useState<FloatingPosition>({\n    x: -9999,\n    y: -9999,\n    placement,\n    dir: \"ltr\",\n  });\n\n  const update = useCallback(() => {\n    const anchor = anchorRef.current;\n    const floating = floatingRef.current;\n    if (!anchor || !floating) return;\n\n    const anchorRect = anchor.getBoundingClientRect();\n    \/\/ The popup's SIZE comes from layout, not from its transformed box: popups\n    \/\/ open with `fancy-scale-in` (scale 0.95 to 1) and are measured during it, so\n    \/\/ the box is 5% small, and nothing re-measures when the animation ends. That\n    \/\/ left an RTL `bottom-start` (and an LTR `bottom-end`) popup off the anchor's\n    \/\/ edge for good. Layout size is 0 where nothing lays out (jsdom), so the box\n    \/\/ is the fallback.\n    const box = floating.getBoundingClientRect();\n    const floatingRect = {\n      width: floating.offsetWidth || box.width,\n      height: floating.offsetHeight || box.height,\n    } as DOMRect;\n    const next = getPosition(anchorRect, floatingRect, placement, offset, directionOf(anchor));\n    \/\/ Bail out when nothing changed so this can run after every commit\n    \/\/ (below) without causing an infinite render loop.\n    setPosition((prev) =>\n      prev.x === next.x && prev.y === next.y && prev.placement === next.placement && prev.dir === next.dir\n        ? prev\n        : next,\n    );\n  }, [anchorRef, floatingRef, placement, offset]);\n\n  \/\/ Re-measure after every commit while open.\n  \/\/\n  \/\/ The floating element mounts a frame or two AFTER `enabled` flips \u2014 its\n  \/\/ render is gated behind a state flip (e.g. useAnimation's `mounted`), so at\n  \/\/ the moment `enabled` turns true the floating ref is still null and a single\n  \/\/ measurement no-ops, leaving the popover parked at its off-screen sentinel.\n  \/\/\n  \/\/ A passive effect with no deps runs after *every* commit \u2014 including the one\n  \/\/ that finally mounts the floating element \u2014 and, crucially, keeps running in\n  \/\/ hidden\/background tabs where `requestAnimationFrame` is paused. The bail-out\n  \/\/ in `update` makes the steady-state calls free, so this both fixes the\n  \/\/ late-mount race and survives tab-visibility throttling.\n  useEffect(() => {\n    if (enabled) update();\n  });\n\n  \/\/ \u2026but the per-commit effect ISN'T enough when the floating element mounts\n  \/\/ through a <Portal> whose own mount gate (SSR-safe; renders nothing until its\n  \/\/ useEffect runs) attaches the node WITHOUT re-rendering this hook's component.\n  \/\/ Then no commit happens here, the measurement never runs, and the popover\n  \/\/ stays parked at its off-screen sentinel until an unrelated scroll\/resize\n  \/\/ fires `update()` \u2014 the \"menu only appears after I scroll\" bug. Poll with rAF\n  \/\/ until the node is actually in the DOM, measure it, then keep it observed for\n  \/\/ size changes (async content \/ lazily-loaded icons).\n  useEffect(() => {\n    if (!enabled) return;\n    let raf = 0;\n    let ro: ResizeObserver | null = null;\n    const tick = () => {\n      const el = floatingRef.current;\n      if (el) {\n        update();\n        if (typeof ResizeObserver !== \"undefined\") {\n          ro = new ResizeObserver(() => update());\n          ro.observe(el);\n        }\n      } else {\n        raf = requestAnimationFrame(tick);\n      }\n    };\n    raf = requestAnimationFrame(tick);\n    return () => {\n      cancelAnimationFrame(raf);\n      ro?.disconnect();\n    };\n  }, [enabled, update, floatingRef]);\n\n  \/\/ Park off-screen when closed so the next open re-measures from scratch.\n  useEffect(() => {\n    if (!enabled) {\n      setPosition((prev) =>\n        prev.x === -9999 ? prev : { x: -9999, y: -9999, placement, dir: prev.dir },\n      );\n    }\n  }, [enabled, placement]);\n\n  \/\/ Reposition on scroll\/resize while open.\n  useEffect(() => {\n    if (!enabled) return;\n\n    window.addEventListener(\"scroll\", update, true);\n    window.addEventListener(\"resize\", update);\n\n    return () => {\n      window.removeEventListener(\"scroll\", update, true);\n      window.removeEventListener(\"resize\", update);\n    };\n  }, [update, enabled]);\n\n  return position;\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/hooks\/use-floating-position.ts"},{"path":"components\/fancy\/lib\/hooks\/use-outside-click.ts","content":"import { useEffect, type RefObject } from \"react\";\n\nexport function useOutsideClick(\n  ref: RefObject<HTMLElement | null>,\n  handler: (event: MouseEvent | TouchEvent) => void,\n  enabled: boolean = true,\n  ignoreRef?: RefObject<HTMLElement | null>,\n): void {\n  useEffect(() => {\n    if (!enabled) return;\n\n    const listener = (event: MouseEvent | TouchEvent) => {\n      const el = ref.current;\n      if (!el || el.contains(event.target as Node)) return;\n      \/\/ Ignore clicks on the trigger\/anchor element \u2014 the trigger's\n      \/\/ own onClick handler manages toggling.\n      if (ignoreRef?.current?.contains(event.target as Node)) return;\n      handler(event);\n    };\n\n    document.addEventListener(\"mousedown\", listener);\n    document.addEventListener(\"touchstart\", listener);\n\n    return () => {\n      document.removeEventListener(\"mousedown\", listener);\n      document.removeEventListener(\"touchstart\", listener);\n    };\n  }, [ref, handler, enabled, ignoreRef]);\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/hooks\/use-outside-click.ts"},{"path":"components\/fancy\/lib\/hooks\/use-escape-key.ts","content":"import { createContext, useContext, useEffect, useRef } from \"react\";\n\n\/**\n * Escape belongs to the innermost open layer.\n *\n * Every `useEscapeKey(handler, enabled)` call is a LAYER while `enabled`: a\n * Dropdown's menu, a Select's listbox, a Popover, a Modal, a Drawer, a Tooltip,\n * a full-screen surface. They all join one stack, one document listener reads\n * each Escape, and only one layer gets it.\n *\n * Why not one document listener per layer, as this hook used to do: every\n * open layer then received the same Escape. A Dropdown inside a Modal closed\n * the menu AND the dialog. Inside a full-screen surface it was worse: the\n * surface's own key handler runs during the event's trip through the surface,\n * before any document listener, so it could not tell that a menu wanted the\n * key. DeckEditor exited full screen with its Shape menu still open. Fixing\n * that by ordering listeners would only last until someone registers one in a\n * different place. So the decision is made from the stack instead.\n *\n * \"Innermost\" is decided in two steps:\n *\n * 1. The most recently opened layer is the candidate. Opening a menu from a\n *    dialog is the normal order of things.\n * 2. A full-screen surface knows its own descendants: layers rendered inside\n *    it register under it through `EscapeLayerContext`, and that context flows\n *    through portals. If the candidate is a surface with open layers inside,\n *    the most recent of those wins instead. Without this step, a menu opened\n *    BEFORE an agent put its surface full screen would lose the Escape to the\n *    surface.\n *\n * An Escape that something already handled (`event.defaultPrevented`, for\n * example a text field clearing itself) is left alone.\n *\/\n\ninterface LayerEntry {\n  handler: { current: () => void };\n  \/** The surface this layer was rendered inside, if any. *\/\n  parent: EscapeScope | null;\n  \/** Set when the layer IS a surface: layers inside it point here. *\/\n  scope: EscapeScope | null;\n}\n\n\/** Identity of a full-screen surface for the layers rendered inside it. *\/\nexport type EscapeScope = object;\n\nconst stack: LayerEntry[] = [];\n\n\/** The surface (if any) that layers rendered here belong to. *\/\nexport const EscapeLayerContext = createContext<EscapeScope | null>(null);\n\nfunction innermost(): LayerEntry | undefined {\n  let candidate = stack[stack.length - 1];\n  while (candidate?.scope) {\n    const scope = candidate.scope;\n    let inner: LayerEntry | undefined;\n    for (let i = stack.length - 1; i >= 0; i--) {\n      if (stack[i].parent === scope) {\n        inner = stack[i];\n        break;\n      }\n    }\n    if (!inner) break;\n    candidate = inner;\n  }\n  return candidate;\n}\n\nfunction onDocumentKeyDown(event: KeyboardEvent) {\n  if (event.key !== \"Escape\" || event.defaultPrevented) return;\n  const target = innermost();\n  if (!target) return;\n  event.preventDefault();\n  target.handler.current();\n}\n\nfunction push(entry: LayerEntry): () => void {\n  if (stack.length === 0) document.addEventListener(\"keydown\", onDocumentKeyDown);\n  stack.push(entry);\n  return () => {\n    const i = stack.indexOf(entry);\n    if (i >= 0) stack.splice(i, 1);\n    if (stack.length === 0) document.removeEventListener(\"keydown\", onDocumentKeyDown);\n  };\n}\n\n\/**\n * Register a layer that closes on Escape while `enabled`. Pass `scope` only for\n * a surface that other layers can open inside (a full-screen surface).\n *\n * Returns `isInnermost()`, for a layer that also handles Escape in its own key\n * handler and must not act when a layer above it owns the key.\n *\n * @internal Exported for full-screen surfaces in sibling packages; ordinary\n * layers call `useEscapeKey`.\n *\/\nexport function useEscapeLayer(\n  handler: () => void,\n  enabled: boolean,\n  scope: EscapeScope | null = null,\n): { isInnermost: () => boolean } {\n  const parent = useContext(EscapeLayerContext);\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n  const entryRef = useRef<LayerEntry | null>(null);\n\n  \/\/ Depends on `enabled` (and identity), NOT on `handler`: callers pass inline\n  \/\/ callbacks, and re-registering on every render would move a dialog above\n  \/\/ the menu it had just opened.\n  useEffect(() => {\n    if (!enabled) return;\n    const entry: LayerEntry = { handler: handlerRef, parent, scope };\n    entryRef.current = entry;\n    const pop = push(entry);\n    return () => {\n      pop();\n      if (entryRef.current === entry) entryRef.current = null;\n    };\n  }, [enabled, parent, scope]);\n\n  const isInnermostRef = useRef(() => entryRef.current !== null && innermost() === entryRef.current);\n  return { isInnermost: isInnermostRef.current };\n}\n\nexport function useEscapeKey(handler: () => void, enabled: boolean = true): void {\n  useEscapeLayer(handler, enabled);\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/hooks\/use-escape-key.ts"},{"path":"components\/fancy\/lib\/utils\/compose-refs.ts","content":"import type { Ref, RefCallback } from \"react\";\n\n\/**\n * One ref callback that feeds every ref it is given.\n *\n * For a component that needs its own handle on an element AND has to honour a\n * ref someone else put there \u2014 a Tooltip anchoring to its trigger, a control\n * measuring itself while a caller holds a ref to it. Assigning one ref over the\n * other silently breaks whichever side lost.\n *\/\nexport function composeRefs<T>(...refs: Array<Ref<T> | undefined | null>): RefCallback<T> {\n  return (node: T | null) => {\n    for (const ref of refs) {\n      if (typeof ref === \"function\") ref(node);\n      else if (ref) (ref as { current: T | null }).current = node;\n    }\n  };\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/utils\/compose-refs.ts"},{"path":"components\/fancy\/lib\/utils\/direction.ts","content":"\/**\n * Writing direction, read from the DOM rather than passed as a prop.\n *\n * Components follow the `dir` the browser already resolved for them, inherited\n * from the nearest ancestor that sets one (usually `<html dir=\"rtl\">`). Reading\n * the computed `direction` means a `dir` on any wrapper works, with nothing to\n * thread through props or context, and SSR renders the same markup for both\n * directions: layout is logical CSS, and only code that measures or maps keys\n * asks this question, always in an effect or an event handler.\n *\/\nexport type Direction = \"ltr\" | \"rtl\";\n\nexport function directionOf(el: Element | null | undefined): Direction {\n  if (!el || typeof window === \"undefined\" || typeof getComputedStyle !== \"function\") return \"ltr\";\n  return getComputedStyle(el).direction === \"rtl\" ? \"rtl\" : \"ltr\";\n}\n\nexport function isRtl(el: Element | null | undefined): boolean {\n  return directionOf(el) === \"rtl\";\n}\n\n\/**\n * The LOGICAL step a horizontal arrow key means: +1 toward the inline end\n * (\"next\"), -1 toward the inline start (\"previous\"), 0 for any other key.\n *\n * ArrowRight moves visually right in both directions, and visually right is\n * the inline END in LTR but the inline START in RTL.\n *\/\nexport function inlineStep(key: string, el: Element | null | undefined): -1 | 0 | 1 {\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n  const forward = key === \"ArrowRight\" ? 1 : -1;\n  return (isRtl(el) ? -forward : forward) as -1 | 1;\n}\n","type":"registry:lib","target":"components\/fancy\/lib\/utils\/direction.ts"}]}