{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "number-input",
  "type": "registry:ui",
  "title": "Number Input",
  "description": "Number Input is direct numeric entry with optional steppers and min/max/step — not currency, quantity business logic, or a Slider.",
  "author": "Skrewww",
  "dependencies": [
    "@phosphor-icons/react"
  ],
  "registryDependencies": [
    "@skrewww/form-field",
    "@skrewww/foundation"
  ],
  "docs": "Host requirements (assumed already present, not installed by this command): react, react-dom.",
  "files": [
    {
      "path": "components/ui/NumberInput.tsx",
      "content": "/** @skrewww-component number-input */\n\"use client\";\n\nimport { CaretDown, CaretUp } from \"@phosphor-icons/react\";\nimport {\n  forwardRef,\n  useEffect,\n  useId,\n  useRef,\n  useState,\n  type ChangeEvent,\n  type ClipboardEvent,\n  type FocusEvent,\n  type KeyboardEvent,\n} from \"react\";\nimport { useControllableState } from \"@/lib/use-controllable\";\nimport { FormField } from \"@/components/ui/FormField\";\nimport {\n  TextInputControl,\n  type TextInputControlProps,\n} from \"@/components/ui/TextInputControl\";\nimport {\n  commitNumberDraft,\n  formatCommittedNumber,\n  isAllowedNumberDraft,\n  parseNumberDraft,\n  stepNumber,\n} from \"@/lib/number-input-value\";\nimport styles from \"@/components/ui/number-input.module.css\";\n\nexport type NumberInputSize = TextInputControlProps[\"size\"];\n\nexport type NumberInputProps = {\n  label: string;\n  value?: number | null;\n  defaultValue?: number | null;\n  onValueChange?: (value: number | null) => void;\n  min?: number;\n  max?: number;\n  step?: number;\n  disabled?: boolean;\n  readOnly?: boolean;\n  required?: boolean;\n  supportingText?: string;\n  error?: string;\n  placeholder?: string;\n  hideLabel?: boolean;\n  /** When true (default), shows increment/decrement controls. */\n  showSteppers?: boolean;\n  name?: string;\n  id?: string;\n  size?: NumberInputSize;\n  className?: string;\n};\n\n/**\n * Direct numeric entry with optional steppers.\n *\n * Uses text semantics + spinbutton ARIA (not native type=number) so intermediate\n * drafts (\"-\", \"1.\") remain editable and browser spinner chrome stays consistent.\n * Not a currency field, quantity business logic, or Slider substitute.\n */\nexport const NumberInput = forwardRef<HTMLInputElement, NumberInputProps>(function NumberInput(\n  {\n    label,\n    value,\n    defaultValue = null,\n    onValueChange,\n    min = Number.NEGATIVE_INFINITY,\n    max = Number.POSITIVE_INFINITY,\n    step = 1,\n    disabled = false,\n    readOnly = false,\n    required = false,\n    supportingText,\n    error,\n    placeholder,\n    hideLabel = false,\n    showSteppers = true,\n    name,\n    id: idProp,\n    size = \"md\",\n    className,\n  },\n  ref,\n) {\n  const valueProvided = value !== undefined;\n  const generatedId = useId();\n  const controlId = idProp ?? generatedId;\n\n  const safeMin = Number.isFinite(min) ? min : Number.NEGATIVE_INFINITY;\n  const safeMax = Number.isFinite(max) ? max : Number.POSITIVE_INFINITY;\n  const safeStep = Number.isFinite(step) && step > 0 ? step : 1;\n\n  const [committed, setCommitted] = useControllableState<number | null>({\n    value: valueProvided ? value : undefined,\n    defaultValue,\n    onChange: onValueChange,\n    valueProvided,\n  });\n\n  const [draft, setDraft] = useState(() => formatCommittedNumber(committed));\n  const focusedRef = useRef(false);\n\n  useEffect(() => {\n    if (focusedRef.current) return;\n    setDraft(formatCommittedNumber(committed));\n  }, [committed]);\n\n  function commitText(text: string) {\n    const next = commitNumberDraft(text, safeMin, safeMax, safeStep, committed);\n    setCommitted(next);\n    setDraft(formatCommittedNumber(next));\n  }\n\n  function applyStep(direction: 1 | -1) {\n    if (disabled || readOnly) return;\n    const next = stepNumber(committed, direction, safeMin, safeMax, safeStep);\n    setCommitted(next);\n    setDraft(formatCommittedNumber(next));\n  }\n\n  function handleChange(event: ChangeEvent<HTMLInputElement>) {\n    const next = event.target.value;\n    if (!isAllowedNumberDraft(next)) return;\n    setDraft(next);\n    const parsed = parseNumberDraft(next);\n    if (parsed.kind === \"empty\") {\n      setCommitted(null);\n      return;\n    }\n    if (parsed.kind === \"valid\") {\n      // Live update without clamping so typing past max remains editable until blur.\n      setCommitted(parsed.value);\n    }\n  }\n\n  function handleBlur(event: FocusEvent<HTMLInputElement>) {\n    focusedRef.current = false;\n    commitText(event.currentTarget.value);\n  }\n\n  function handleFocus() {\n    focusedRef.current = true;\n  }\n\n  function handleKeyDown(event: KeyboardEvent<HTMLInputElement>) {\n    if (disabled || readOnly) return;\n    if (event.key === \"ArrowUp\") {\n      event.preventDefault();\n      applyStep(1);\n      return;\n    }\n    if (event.key === \"ArrowDown\") {\n      event.preventDefault();\n      applyStep(-1);\n      return;\n    }\n    if (event.key === \"Enter\") {\n      commitText(draft);\n    }\n  }\n\n  function handlePaste(event: ClipboardEvent<HTMLInputElement>) {\n    if (disabled || readOnly) return;\n    const pasted = event.clipboardData.getData(\"text\").trim();\n    const cleaned = pasted.replace(/[^\\d.\\-]/g, \"\");\n    if (!isAllowedNumberDraft(cleaned)) {\n      event.preventDefault();\n      return;\n    }\n    if (cleaned !== pasted) {\n      event.preventDefault();\n      setDraft(cleaned);\n      const parsed = parseNumberDraft(cleaned);\n      if (parsed.kind === \"empty\") setCommitted(null);\n      else if (parsed.kind === \"valid\") setCommitted(parsed.value);\n    }\n  }\n\n  const canDecrement =\n    !disabled &&\n    !readOnly &&\n    (committed === null || !Number.isFinite(safeMin) || committed > safeMin);\n  const canIncrement =\n    !disabled &&\n    !readOnly &&\n    (committed === null || !Number.isFinite(safeMax) || committed < safeMax);\n\n  const inputMode =\n    Number.isInteger(safeStep) && (!Number.isFinite(safeMin) || safeMin >= 0)\n      ? \"numeric\"\n      : \"decimal\";\n\n  const ariaValueMin = Number.isFinite(safeMin) ? safeMin : undefined;\n  const ariaValueMax = Number.isFinite(safeMax) ? safeMax : undefined;\n\n  return (\n    <FormField\n      label={label}\n      controlId={controlId}\n      required={required}\n      hideLabel={hideLabel}\n      supportingText={supportingText}\n      error={error}\n      className={className}\n    >\n      {({ controlId: id, describedBy, invalid }) => (\n        <TextInputControl\n          ref={ref}\n          id={id}\n          name={name}\n          className={styles.control}\n          size={size}\n          type=\"text\"\n          inputMode={inputMode}\n          autoComplete=\"off\"\n          spellCheck={false}\n          role=\"spinbutton\"\n          aria-valuemin={ariaValueMin}\n          aria-valuemax={ariaValueMax}\n          aria-valuenow={committed === null ? undefined : committed}\n          aria-invalid={invalid || undefined}\n          aria-describedby={describedBy}\n          aria-required={required || undefined}\n          placeholder={placeholder}\n          value={draft}\n          onChange={handleChange}\n          onBlur={handleBlur}\n          onFocus={handleFocus}\n          onKeyDown={handleKeyDown}\n          onPaste={handlePaste}\n          disabled={disabled}\n          readOnly={readOnly}\n          required={required}\n          trailingAction={\n            showSteppers ? (\n              <span className={styles.steppers}>\n                <button\n                  type=\"button\"\n                  className={styles.stepButton}\n                  aria-label=\"Increment\"\n                  tabIndex={-1}\n                  disabled={!canIncrement}\n                  onMouseDown={(event) => event.preventDefault()}\n                  onClick={() => applyStep(1)}\n                >\n                  <CaretUp size={12} weight=\"bold\" aria-hidden=\"true\" />\n                </button>\n                <button\n                  type=\"button\"\n                  className={styles.stepButton}\n                  aria-label=\"Decrement\"\n                  tabIndex={-1}\n                  disabled={!canDecrement}\n                  onMouseDown={(event) => event.preventDefault()}\n                  onClick={() => applyStep(-1)}\n                >\n                  <CaretDown size={12} weight=\"bold\" aria-hidden=\"true\" />\n                </button>\n              </span>\n            ) : undefined\n          }\n        />\n      )}\n    </FormField>\n  );\n});\n",
      "type": "registry:ui",
      "target": "~/components/ui/NumberInput.tsx"
    },
    {
      "path": "components/ui/number-input.module.css",
      "content": ".control {\n  width: 100%;\n}\n\n.control :global(input) {\n  /* Room for stacked steppers (override TextInputControl withTrailing). */\n  padding-right: 2.75rem;\n}\n\n.steppers {\n  display: inline-flex;\n  flex-direction: column;\n  align-items: stretch;\n  justify-content: center;\n  gap: 1px;\n  height: calc(100% - 0.5rem);\n  max-height: 2.25rem;\n}\n\n.stepButton {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  flex: 1 1 auto;\n  min-height: 0;\n  width: 1.75rem;\n  margin: 0;\n  padding: 0;\n  border: none;\n  border-radius: 2px;\n  background: transparent;\n  color: var(--semantic-icon-muted);\n  cursor: pointer;\n  line-height: 0;\n}\n\n.stepButton:hover:not(:disabled) {\n  color: var(--semantic-text-primary);\n  background: var(--semantic-surface-subtle);\n}\n\n.stepButton:focus {\n  outline: none;\n}\n\n.stepButton:focus-visible {\n  box-shadow: 0 0 0 2px var(--semantic-focus-ring);\n}\n\n.stepButton:disabled {\n  cursor: not-allowed;\n  opacity: var(--opacity-disabled);\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .stepButton {\n    transition: none;\n  }\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/number-input.module.css"
    },
    {
      "path": "lib/cn.ts",
      "content": "export function cn(...classes: Array<string | false | null | undefined>): string {\n  return classes.filter(Boolean).join(\" \");\n}\n",
      "type": "registry:lib",
      "target": "~/lib/cn.ts"
    },
    {
      "path": "lib/use-controllable.ts",
      "content": "import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport function useControllableState<T>({\n  value,\n  defaultValue,\n  onChange,\n  controlled: controlledProp,\n  valueProvided,\n}: {\n  value?: T;\n  defaultValue?: T;\n  onChange?: (next: T) => void;\n  /** Explicit controlled override — prefer `valueProvided` from the component root. */\n  controlled?: boolean;\n  /** True when the parent passed a `value` prop, including `undefined`. */\n  valueProvided?: boolean;\n}) {\n  const [uncontrolled, setUncontrolled] = useState(defaultValue as T);\n  const isControlled = controlledProp ?? valueProvided ?? value !== undefined;\n  const current = isControlled ? (value as T) : uncontrolled;\n  const wasControlledRef = useRef(isControlled);\n\n  useEffect(() => {\n    if (process.env.NODE_ENV !== \"development\") return;\n    if (wasControlledRef.current !== isControlled) {\n      console.warn(\n        \"[Skrewww] A component changed between controlled and uncontrolled modes. Keep `value` or `defaultValue` usage consistent across renders.\",\n      );\n    }\n    wasControlledRef.current = isControlled;\n  }, [isControlled]);\n\n  const setValue = useCallback(\n    (next: T) => {\n      if (!isControlled) setUncontrolled(next);\n      onChange?.(next);\n    },\n    [isControlled, onChange],\n  );\n\n  return [current, setValue] as const;\n}\n",
      "type": "registry:lib",
      "target": "~/lib/use-controllable.ts"
    },
    {
      "path": "components/ui/TextInputControl.tsx",
      "content": "\"use client\";\n\nimport { forwardRef, type InputHTMLAttributes, type ReactNode } from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport styles from \"@/components/ui/text-input.module.css\";\n\nexport type TextInputControlSize = \"sm\" | \"md\" | \"lg\";\n\nexport type TextInputControlProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  \"size\"\n> & {\n  size?: TextInputControlSize;\n  leadingIcon?: ReactNode;\n  trailingIcon?: ReactNode;\n  trailingAction?: ReactNode;\n};\n\nconst sizeClass: Record<TextInputControlSize, string> = {\n  sm: styles.sizeSm,\n  md: styles.sizeMd,\n  lg: styles.sizeLg,\n};\n\n/** Control-only single-line input — compose with FormField for label and validation. */\nexport const TextInputControl = forwardRef<HTMLInputElement, TextInputControlProps>(\n  function TextInputControl(\n    {\n      size = \"md\",\n      leadingIcon,\n      trailingIcon,\n      trailingAction,\n      className,\n      disabled,\n      required,\n      readOnly,\n      ...props\n    },\n    ref,\n  ) {\n    return (\n      <div className={cn(styles.controlWrap, className)}>\n        {leadingIcon ? (\n          <span className={styles.leading} aria-hidden=\"true\">\n            {leadingIcon}\n          </span>\n        ) : null}\n\n        <input\n          ref={ref}\n          className={cn(\n            styles.input,\n            sizeClass[size],\n            leadingIcon ? styles.withLeading : undefined,\n            trailingIcon || trailingAction ? styles.withTrailing : undefined,\n          )}\n          disabled={disabled}\n          readOnly={readOnly}\n          required={required}\n          aria-required={required || undefined}\n          {...props}\n        />\n\n        {trailingAction ? (\n          <span className={styles.trailingAction}>{trailingAction}</span>\n        ) : trailingIcon ? (\n          <span className={styles.trailing} aria-hidden=\"true\">\n            {trailingIcon}\n          </span>\n        ) : null}\n      </div>\n    );\n  },\n);\n",
      "type": "registry:ui",
      "target": "~/components/ui/TextInputControl.tsx"
    },
    {
      "path": "components/ui/text-input.module.css",
      "content": ".controlWrap {\n  position: relative;\n  display: flex;\n  align-items: center;\n  width: 100%;\n}\n\n.input {\n  width: 100%;\n  border: 1px solid var(--semantic-border-default);\n  border-radius: var(--shape-radius-control);\n  /* TextInput wasn't in the originally-reported list of squircle consumers,\n     but it consumes --shape-radius-control via plain border-radius exactly\n     like Button/Checkbox/Drawer's close button — same bug, fixed the same\n     way, found while auditing the other 5. */\n  clip-path: var(--squircle-clip-path-control, none);\n  background-color: var(--surface-fill-control);\n  background-image: var(--component-surface-gradient-overlay);\n  backdrop-filter: var(--glass-backdrop-filter-sm, none);\n  color: var(--semantic-text-primary);\n  font-family: inherit;\n  line-height: 1.4;\n  transition:\n    border-color 0.15s ease,\n    box-shadow 0.15s ease;\n}\n\n.input::placeholder {\n  color: var(--semantic-text-disabled);\n}\n\n.input:hover:not(:disabled):not([aria-invalid=\"true\"]) {\n  border-color: var(--semantic-border-strong);\n}\n\n.input:focus {\n  outline: none;\n}\n\n.input:focus-visible {\n  border-color: var(--semantic-focus-ring);\n  box-shadow: 0 0 0 2px var(--semantic-focus-ring);\n}\n\n/* clip-path clips an outset box-shadow ring exactly like it clips outline\n   (same reasoning as Button/Checkbox) — an inset ring stays fully visible\n   since it never extends past the clip boundary. Squircle mode only; every\n   other shape mode keeps the outset ring above unchanged. */\n[data-skrewww-shape=\"squircle\"] .input:focus-visible {\n  box-shadow: inset 0 0 0 2px var(--semantic-focus-ring);\n}\n\n.input:disabled {\n  cursor: not-allowed;\n  pointer-events: none;\n  color: var(--semantic-text-disabled);\n  border-color: var(--semantic-border-disabled);\n  background-color: var(--semantic-surface-disabled);\n  opacity: var(--opacity-disabled);\n}\n\n.input:read-only:not(:disabled) {\n  background-color: var(--semantic-surface-subtle);\n  cursor: default;\n}\n\n.input[aria-invalid=\"true\"] {\n  border-color: var(--semantic-action-danger);\n}\n\n.input[aria-invalid=\"true\"]:focus-visible {\n  box-shadow: 0 0 0 2px var(--semantic-action-danger);\n}\n\n[data-skrewww-shape=\"squircle\"] .input[aria-invalid=\"true\"]:focus-visible {\n  box-shadow: inset 0 0 0 2px var(--semantic-action-danger);\n}\n\n.input[type=\"search\"]::-webkit-search-cancel-button {\n  -webkit-appearance: none;\n  appearance: none;\n  display: none;\n}\n\n.sizeSm {\n  min-height: var(--control-height-sm);\n  padding: 0 var(--control-padding-x-sm);\n  font-size: var(--control-font-size-sm);\n}\n\n.sizeMd {\n  min-height: var(--control-height-md);\n  padding: 0 var(--control-padding-x-md);\n  font-size: var(--control-font-size-md);\n}\n\n.sizeLg {\n  min-height: var(--control-height-lg);\n  padding: 0 var(--control-padding-x-lg);\n  font-size: var(--control-font-size-lg);\n}\n\n.withLeading {\n  padding-left: 2.25rem;\n}\n\n.withTrailing {\n  padding-right: 2.25rem;\n}\n\n.leading,\n.trailing {\n  position: absolute;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  color: var(--semantic-icon-muted);\n  pointer-events: none;\n}\n\n.leading {\n  left: 0.75rem;\n}\n\n.trailing {\n  right: 0.75rem;\n  pointer-events: auto;\n}\n\n.trailingAction {\n  position: absolute;\n  right: 0.25rem;\n  display: inline-flex;\n  align-items: center;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .input {\n    transition: none;\n  }\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/text-input.module.css"
    },
    {
      "path": "lib/number-input-value.ts",
      "content": "/**\n * Number Input value helpers — draft text vs committed number | null.\n * Constraints (min/max/step) apply on commit (blur / step / arrows), not every keystroke.\n */\n\nexport function countDecimals(step: number): number {\n  if (!Number.isFinite(step) || step <= 0) return 0;\n  const text = String(step);\n  const i = text.indexOf(\".\");\n  return i === -1 ? 0 : text.length - i - 1;\n}\n\nexport function clampNumber(n: number, min: number, max: number): number {\n  return Math.min(Math.max(n, min), max);\n}\n\nexport function snapToStep(raw: number, min: number, max: number, step: number): number {\n  if (!Number.isFinite(step) || step <= 0) {\n    return clampNumber(raw, min, max);\n  }\n  const decimals = countDecimals(step);\n  const origin = Number.isFinite(min) ? min : 0;\n  const steps = Math.round((raw - origin) / step);\n  const snapped = origin + steps * step;\n  const rounded = decimals > 0 ? Number(snapped.toFixed(decimals)) : Math.round(snapped);\n  return clampNumber(rounded, min, max);\n}\n\n/** Empty / intermediate drafts allowed while typing; committed values are number | null. */\nexport function isAllowedNumberDraft(text: string): boolean {\n  if (text === \"\" || text === \"-\" || text === \".\" || text === \"-.\") return true;\n  return /^-?\\d*(\\.\\d*)?$/.test(text);\n}\n\nexport function parseNumberDraft(\n  text: string,\n): { kind: \"empty\" } | { kind: \"valid\"; value: number } | { kind: \"intermediate\" } {\n  const trimmed = text.trim();\n  if (trimmed === \"\") return { kind: \"empty\" };\n  if (trimmed === \"-\" || trimmed === \".\" || trimmed === \"-.\" || /^-?\\d+\\.$/.test(trimmed)) {\n    return { kind: \"intermediate\" };\n  }\n  if (!/^-?\\d+(\\.\\d+)?$/.test(trimmed)) return { kind: \"intermediate\" };\n  const value = Number(trimmed);\n  if (!Number.isFinite(value)) return { kind: \"intermediate\" };\n  return { kind: \"valid\", value };\n}\n\nexport function formatCommittedNumber(value: number | null): string {\n  if (value === null) return \"\";\n  return String(value);\n}\n\nexport function commitNumberDraft(\n  text: string,\n  min: number,\n  max: number,\n  step: number,\n  previous: number | null,\n): number | null {\n  const parsed = parseNumberDraft(text);\n  if (parsed.kind === \"empty\") return null;\n  if (parsed.kind === \"intermediate\") return previous;\n  return snapToStep(parsed.value, min, max, step);\n}\n\nexport function stepNumber(\n  current: number | null,\n  direction: 1 | -1,\n  min: number,\n  max: number,\n  step: number,\n): number {\n  const safeStep = Number.isFinite(step) && step > 0 ? step : 1;\n  if (current === null) {\n    // First step from empty lands on the nearer bound (min for up, max for down).\n    const landing =\n      direction > 0\n        ? Number.isFinite(min)\n          ? min\n          : 0\n        : Number.isFinite(max)\n          ? max\n          : 0;\n    return snapToStep(landing, min, max, safeStep);\n  }\n  const decimals = countDecimals(safeStep);\n  const raw = current + direction * safeStep;\n  const rounded = decimals > 0 ? Number(raw.toFixed(decimals)) : raw;\n  return snapToStep(rounded, min, max, safeStep);\n}\n",
      "type": "registry:lib",
      "target": "~/lib/number-input-value.ts"
    }
  ]
}
