{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "number-field",
  "title": "Number field",
  "description": "A number input with steppers on Base UI NumberField.",
  "dependencies": [
    "@base-ui/react@^1.7.0",
    "@keyline-icons/react@^2.2.0"
  ],
  "registryDependencies": [
    "@khaeli/utils"
  ],
  "files": [
    {
      "path": "registry/khaeli/ui/number-field.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { NumberField as NumberFieldPrimitive } from \"@base-ui/react/number-field\"\nimport { MinusIcon, PlusIcon } from \"@keyline-icons/react\"\nimport { cn } from \"@/lib/utils\"\n\n// --- NumberField ---\n// A bounded quantity on Base UI NumberField: the value then − and + steppers\n// in one 30px field. It wears the input-group chrome (foundation.css: 30px, 10px\n// radius, control shadow, focus pair, phone capsules). Arrow keys, Page\n// Up/Down, Home/End and press-and-hold steppers come from Base UI. Values\n// stay in [min, max]; when one lands on a limit, by stepping or by typing\n// past it, a polite live region says so (\"10, maximum\"; \"Set to 10, the\n// maximum\"), because a silently corrected number reads as a bug.\n\ntype NumberFieldProps = {\n  value: number | null\n  onValueChange(value: number | null): void\n  min?: number\n  max?: number\n  step?: number\n  name?: string\n  id?: string\n  disabled?: boolean\n  required?: boolean\n  format?: Intl.NumberFormatOptions\n  className?: string\n  \"aria-label\"?: string\n  \"aria-describedby\"?: string\n}\n\nconst STEPPER =\n  \"flex size-6 shrink-0 cursor-pointer items-center justify-center rounded-small text-muted-foreground transition-colors hover:bg-accent hover:text-foreground disabled:pointer-events-none disabled:opacity-50 [&_svg]:size-3.5\"\n\n/** Pulls a typed string's number out without locale help: digits, one point, a leading minus. */\nfunction parseTyped(text: string) {\n  const cleaned = text.replace(/[^\\d.,-]/g, \"\").replace(/,/g, \"\")\n  const parsed = Number.parseFloat(cleaned)\n  return Number.isFinite(parsed) ? parsed : null\n}\n\nfunction NumberField({\n  value,\n  onValueChange,\n  min,\n  max,\n  step = 1,\n  name,\n  id,\n  disabled = false,\n  required = false,\n  format,\n  className,\n  \"aria-label\": ariaLabel,\n  \"aria-describedby\": ariaDescribedBy,\n}: NumberFieldProps) {\n  const [note, setNote] = React.useState(\"\")\n  const formatter = React.useMemo(() => new Intl.NumberFormat(undefined, format), [format])\n\n  // A repeated message would not be re-read, so a repeat alternates a trailing no-break space.\n  const announce = React.useCallback((message: string) => {\n    setNote((last) => (last === message ? `${message}\\u00a0` : message))\n  }, [])\n\n  const handleValueChange = (next: number | null, details: NumberFieldPrimitive.Root.ChangeEventDetails) => {\n    onValueChange(next)\n    if (next === null) return\n    const limit = max !== undefined && next >= max ? \"maximum\" : min !== undefined && next <= min ? \"minimum\" : null\n    if (!limit) return\n    if (details.reason.startsWith(\"input-\")) {\n      // Typed values clamp as you type but the text keeps what was typed until blur;\n      // only then, when the typed number differs, say what it became.\n      if (details.reason !== \"input-blur\") return\n      const target = details.event.target\n      const typed = target instanceof HTMLInputElement ? parseTyped(target.value) : null\n      if (typed !== null && typed !== next) announce(`Set to ${formatter.format(next)}, the ${limit}`)\n      return\n    }\n    announce(`${formatter.format(next)}, ${limit}`)\n  }\n\n  // At a limit Base UI disables the stepper and ignores the key, so a further press says where it stopped.\n  const handleKeyDown = (event: React.KeyboardEvent<HTMLInputElement>) => {\n    if (value === null) return\n    const up = event.key === \"ArrowUp\" || event.key === \"PageUp\"\n    const down = event.key === \"ArrowDown\" || event.key === \"PageDown\"\n    if (up && max !== undefined && value >= max) announce(`${formatter.format(max)}, maximum`)\n    if (down && min !== undefined && value <= min) announce(`${formatter.format(min)}, minimum`)\n  }\n\n  return (\n    <NumberFieldPrimitive.Root\n      id={id}\n      name={name}\n      value={value}\n      onValueChange={handleValueChange}\n      min={min}\n      max={max}\n      step={step}\n      disabled={disabled}\n      required={required}\n      format={format}\n      className={cn(\"relative w-full min-w-0\", className)}\n    >\n      <NumberFieldPrimitive.Group\n        data-slot=\"input-group\"\n        className=\"flex h-7.5 w-full min-w-0 items-center gap-0.5 rounded-control border border-transparent bg-background pr-[3px] shadow-control data-disabled:opacity-50\"\n      >\n        <NumberFieldPrimitive.Input\n          data-slot=\"input-group-control\"\n          aria-label={ariaLabel}\n          aria-describedby={ariaDescribedBy}\n          onKeyDown={handleKeyDown}\n          className=\"h-full min-w-0 flex-1 bg-transparent px-3 text-base tabular-nums outline-none placeholder:text-muted-foreground\"\n        />\n        <NumberFieldPrimitive.Decrement aria-label=\"Decrease\" className={STEPPER}>\n          <MinusIcon aria-hidden=\"true\" />\n        </NumberFieldPrimitive.Decrement>\n        <NumberFieldPrimitive.Increment aria-label=\"Increase\" className={STEPPER}>\n          <PlusIcon aria-hidden=\"true\" />\n        </NumberFieldPrimitive.Increment>\n      </NumberFieldPrimitive.Group>\n      <span role=\"status\" aria-live=\"polite\" className=\"sr-only\">\n        {note}\n      </span>\n    </NumberFieldPrimitive.Root>\n  )\n}\n\nexport { NumberField, type NumberFieldProps }\n",
      "type": "registry:ui"
    }
  ],
  "docs": "Install @khaeli/foundation first: this item's styling lives in its tokens and [data-slot] rules.",
  "type": "registry:ui"
}