{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "detent-knob",
  "title": "Detent knob",
  "description": "A rotary switch that clicks into fixed positions and stops hard at both ends. For a few ordered settings where the order matters: reasoning effort, quality presets, verbosity.",
  "dependencies": [
    "cn"
  ],
  "registryDependencies": [
    "https://bevel-ui.vercel.app/r/bevel.json",
    "https://bevel-ui.vercel.app/r/feedback.json"
  ],
  "files": [
    {
      "path": "registry/bevel/ui/detent-knob.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { cn } from \"cn\"\nimport { useBevelFeedback } from \"@/lib/feedback\"\n\ntype Stop = { value: string; label: string }\n\ntype DetentKnobContextValue = {\n  register: (stop: Stop) => () => void\n}\n\nconst DetentKnobContext = React.createContext<DetentKnobContextValue | null>(null)\n\n/* Positions spread over 270°, from bottom-left to bottom-right, like a range switch. */\nconst SWEEP = 270\n\nfunction angleAt(index: number, count: number) {\n  return count < 2 ? 0 : -SWEEP / 2 + (SWEEP * index) / (count - 1)\n}\n\ntype DetentKnobProps = Omit<React.ComponentProps<\"div\">, \"onChange\" | \"defaultValue\"> & {\n  value?: string\n  defaultValue?: string\n  onValueChange?: (value: string) => void\n  disabled?: boolean\n}\n\n/**\n * A rotary switch: it clicks into fixed positions and stops hard at both\n * ends. Turn it with arrow keys, Home and End, or drag it round. List the\n * positions as DetentKnobStop children. Give it an aria-label.\n */\nfunction DetentKnob({\n  className,\n  value: valueProp,\n  defaultValue,\n  onValueChange,\n  disabled,\n  children,\n  ...props\n}: DetentKnobProps) {\n  const [stops, setStops] = React.useState<Stop[]>([])\n  const [uncontrolled, setUncontrolled] = React.useState(defaultValue)\n  const [bump, setBump] = React.useState<{ dir: \"up\" | \"down\"; n: number } | null>(null)\n  const knob = React.useRef<HTMLDivElement>(null)\n  const feedback = useBevelFeedback()\n  const value = valueProp ?? uncontrolled ?? stops[0]?.value\n  const index = Math.max(0, stops.findIndex((s) => s.value === value))\n\n  const register = React.useCallback((stop: Stop) => {\n    // Stops keep the order they mounted in, which is their order round the dial.\n    setStops((all) =>\n      all.some((s) => s.value === stop.value)\n        ? all.map((s) => (s.value === stop.value ? stop : s))\n        : [...all, stop]\n    )\n    return () => setStops((all) => all.filter((s) => s.value !== stop.value))\n  }, [])\n  const context = React.useMemo(() => ({ register }), [register])\n\n  const select = (next: number) => {\n    if (disabled || !stops.length) return\n    if (next < 0 || next > stops.length - 1) {\n      setBump((b) => ({ dir: next < 0 ? \"down\" : \"up\", n: (b?.n ?? 0) + 1 }))\n      feedback.click()\n      return\n    }\n    if (next === index) return\n    const stop = stops[next]!\n    setUncontrolled(stop.value)\n    onValueChange?.(stop.value)\n    feedback.detent()\n  }\n\n  const onKeyDown = (event: React.KeyboardEvent) => {\n    const step: Record<string, number> = { ArrowRight: 1, ArrowUp: 1, ArrowLeft: -1, ArrowDown: -1 }\n    if (event.key in step) select(index + step[event.key]!)\n    else if (event.key === \"Home\") select(0)\n    else if (event.key === \"End\") select(stops.length - 1)\n    else return\n    event.preventDefault()\n  }\n\n  // Dragging: the nearest position to the pointer's angle round the centre.\n  const fromPointer = (event: React.PointerEvent) => {\n    const box = knob.current?.getBoundingClientRect()\n    if (!box || stops.length < 2) return\n    const x = event.clientX - (box.left + box.width / 2)\n    const y = event.clientY - (box.top + box.height / 2)\n    const angle = (Math.atan2(x, -y) * 180) / Math.PI\n    const t = (angle + SWEEP / 2) / SWEEP\n    if (t < -0.05 || t > 1.05) return // in the dead zone at the bottom: stay put\n    select(Math.min(stops.length - 1, Math.max(0, Math.round(t * (stops.length - 1)))))\n  }\n\n  const current = stops[index]\n  return (\n    <DetentKnobContext value={context}>\n      {children}\n      <div\n        data-slot=\"detent-knob\"\n        data-disabled={disabled ? \"\" : undefined}\n        className={cn(\"relative grid size-56 shrink-0 place-items-center select-none data-disabled:opacity-50\", className)}\n      >\n        {stops.map((stop, i) => (\n          <span\n            key={stop.value}\n            aria-hidden\n            data-selected={i === index ? \"\" : undefined}\n            onClick={() => select(i)}\n            className=\"absolute top-1/2 left-1/2 cursor-pointer text-xs font-semibold whitespace-nowrap text-muted-foreground transition-colors duration-(--bevel-duration-small) data-selected:text-foreground motion-reduce:transition-none\"\n            style={{\n              transform: `translate(-50%, -50%) rotate(${angleAt(i, stops.length)}deg) translateY(calc(var(--detent-knob-label-radius) * -1)) rotate(${-angleAt(i, stops.length)}deg)`,\n            }}\n          >\n            {stop.label}\n          </span>\n        ))}\n        <div\n          ref={knob}\n          role=\"slider\"\n          tabIndex={disabled ? -1 : 0}\n          aria-disabled={disabled || undefined}\n          aria-valuemin={0}\n          aria-valuemax={Math.max(0, stops.length - 1)}\n          aria-valuenow={index}\n          aria-valuetext={current ? `${current.label}, ${index + 1} of ${stops.length}` : undefined}\n          aria-orientation=\"horizontal\"\n          onKeyDown={onKeyDown}\n          onPointerDown={(event) => {\n            if (disabled) return\n            event.currentTarget.setPointerCapture(event.pointerId)\n            fromPointer(event)\n          }}\n          onPointerMove={(event) => {\n            if (event.currentTarget.hasPointerCapture(event.pointerId)) fromPointer(event)\n          }}\n          className=\"group size-32 touch-none rounded-full focus-visible:outline-none\" // the face below draws the focus ring\n          {...props}\n        >\n          <div\n            key={bump?.n ?? 0}\n            data-slot=\"detent-knob-body\"\n            data-bump={bump?.dir}\n            className={cn(\"size-full rounded-full\", bump && \"detent-knob-bump motion-reduce:animate-none\")}\n          >\n            <div\n              data-slot=\"detent-knob-cap\"\n              className={cn(\n                \"bevel-metal relative size-full rounded-full shadow-(--bevel-depth-object)\",\n                \"transition-[rotate] duration-(--bevel-duration-small) ease-(--bevel-ease-spring) motion-reduce:transition-none\",\n                \"group-focus-visible:ring-3 group-focus-visible:ring-ring/60\"\n              )}\n              style={{ rotate: `${angleAt(index, stops.length)}deg` }}\n            >\n              <span aria-hidden className=\"detent-knob-knurl absolute inset-0 rounded-full\" />\n              <span aria-hidden className=\"bevel-metal absolute inset-3 rounded-full shadow-(--bevel-depth-raised)\" />\n              <span\n                aria-hidden\n                className=\"absolute top-3 left-1/2 h-8 w-1 -translate-x-1/2 rounded-full bg-(--detent-knob-pointer)\"\n              />\n            </div>\n          </div>\n        </div>\n      </div>\n    </DetentKnobContext>\n  )\n}\n\ntype DetentKnobStopProps = { value: string; children: string }\n\n/** One position. Renders nothing itself: the knob draws its label round the dial. */\nfunction DetentKnobStop({ value, children }: DetentKnobStopProps) {\n  const context = React.useContext(DetentKnobContext)\n  if (!context) throw new Error(\"DetentKnobStop must be inside <DetentKnob>\")\n  const { register } = context\n  React.useEffect(() => register({ value, label: children }), [value, children, register])\n  return null\n}\n\nexport { DetentKnob, DetentKnobStop }\nexport type { DetentKnobProps, DetentKnobStopProps }\n",
      "type": "registry:ui"
    }
  ],
  "css": {
    ":root": {
      "--detent-knob-cap": "oklch(0.3 0.01 260)",
      "--detent-knob-cap-edge": "oklch(0.18 0.01 260)",
      "--detent-knob-pointer": "oklch(0.95 0.02 90)",
      "--detent-knob-active": "oklch(0.82 0.15 85)",
      "--detent-knob-label-radius": "5.5rem",
      "--detent-knob-bump": "4deg"
    },
    "[data-slot=\"detent-knob-cap\"]": {
      "--bevel-material": "var(--detent-knob-cap)",
      "--bevel-material-edge": "var(--detent-knob-cap-edge)"
    },
    "@utility detent-knob-knurl": {
      "background-image": "repeating-conic-gradient(var(--bevel-highlight) 0deg 3deg, var(--bevel-shade) 3deg 6deg)"
    },
    "@keyframes detent-knob-bump": {
      "40%": {
        "rotate": "var(--detent-knob-bump-to)"
      }
    },
    "[data-slot=\"detent-knob-body\"][data-bump=\"up\"]": {
      "--detent-knob-bump-to": "var(--detent-knob-bump)"
    },
    "[data-slot=\"detent-knob-body\"][data-bump=\"down\"]": {
      "--detent-knob-bump-to": "calc(var(--detent-knob-bump) * -1)"
    },
    "@utility detent-knob-bump": {
      "animation": "detent-knob-bump var(--bevel-duration-small) var(--bevel-ease-out)"
    }
  },
  "categories": [
    "instruments"
  ],
  "type": "registry:ui"
}