{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "volume-knob",
  "title": "Volume Knob",
  "author": "VenusUI",
  "description": "A synth-style knob you drag, scroll or use the keyboard to turn, with an LED ring.",
  "files": [
    {
      "path": "registry/default/ui/volume-knob.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\n\ninterface VolumeKnobProps extends Omit<React.ComponentProps<\"div\">, \"onChange\" | \"defaultValue\"> {\n  value?: number\n  defaultValue?: number\n  onValueChange?: (value: number) => void\n  min?: number\n  max?: number\n  step?: number\n  /** Accessible name and caption, e.g. \"Volume\". */\n  label?: string\n  /** Formats the value for the readout and screen readers. */\n  format?: (value: number) => string\n}\n\nconst SWEEP = 270 // degrees from min to max\nconst LEDS = 21\n/** Pixels of vertical drag for the full range. */\nconst DRAG_RANGE = 220\n\n/**\n * A synth-style knob. Drag up or down (or scroll) to turn it; the LED ring\n * lights up to the value. It's a `slider`: arrow keys, Page Up/Down, Home\n * and End work as usual.\n */\nfunction VolumeKnob({\n  value: valueProp,\n  defaultValue = 50,\n  onValueChange,\n  min = 0,\n  max = 100,\n  step = 1,\n  label = \"Volume\",\n  format = (v) => `${Math.round(v)}%`,\n  className,\n  ...props\n}: VolumeKnobProps) {\n  const [uncontrolled, setUncontrolled] = React.useState(defaultValue)\n  const value = valueProp ?? uncontrolled\n  const drag = React.useRef<{ y: number; value: number } | null>(null)\n  const knobRef = React.useRef<HTMLDivElement>(null)\n\n  const set = React.useCallback(\n    (next: number) => {\n      const snapped = Math.min(max, Math.max(min, Math.round(next / step) * step))\n      setUncontrolled(snapped)\n      onValueChange?.(snapped)\n    },\n    [min, max, step, onValueChange]\n  )\n\n  // Wheel needs a non-passive listener to stop the page from scrolling.\n  React.useEffect(() => {\n    const el = knobRef.current\n    if (!el) return\n    const onWheel = (event: WheelEvent) => {\n      event.preventDefault()\n      set(value - Math.sign(event.deltaY) * step * 2)\n    }\n    el.addEventListener(\"wheel\", onWheel, { passive: false })\n    return () => el.removeEventListener(\"wheel\", onWheel)\n  }, [set, value, step])\n\n  const ratio = (value - min) / (max - min)\n  const angle = -SWEEP / 2 + ratio * SWEEP\n  const lit = Math.round(ratio * (LEDS - 1))\n\n  return (\n    <div data-slot=\"volume-knob\" className={cn(\"inline-flex flex-col items-center gap-3 select-none\", className)} {...props}>\n      <div className=\"relative grid size-40 place-items-center\">\n        {/* LED ring */}\n        {Array.from({ length: LEDS }, (_, i) => {\n          const a = -SWEEP / 2 + (i / (LEDS - 1)) * SWEEP\n          const on = i <= lit && value > min\n          const color =\n            i < LEDS * 0.6\n              ? \"bg-emerald-400 shadow-[0_0_6px_rgb(52_211_153)]\"\n              : i < LEDS * 0.85\n                ? \"bg-amber-400 shadow-[0_0_6px_rgb(251_191_36)]\"\n                : \"bg-red-500 shadow-[0_0_6px_rgb(239_68_68)]\"\n          return (\n            <span key={i} aria-hidden=\"true\" className=\"absolute inset-0\" style={{ transform: `rotate(${a}deg)` }}>\n              <span\n                className={cn(\n                  \"absolute top-0 left-1/2 h-2.5 w-1.5 -translate-x-1/2 rounded-full transition-[background-color,box-shadow] duration-150\",\n                  on ? color : \"bg-neutral-300 dark:bg-neutral-700\"\n                )}\n              />\n            </span>\n          )\n        })}\n\n        {/* Knob */}\n        <div\n          ref={knobRef}\n          role=\"slider\"\n          tabIndex={0}\n          aria-label={label}\n          aria-valuemin={min}\n          aria-valuemax={max}\n          aria-valuenow={value}\n          aria-valuetext={format(value)}\n          aria-orientation=\"vertical\"\n          onPointerDown={(event) => {\n            event.currentTarget.setPointerCapture(event.pointerId)\n            drag.current = { y: event.clientY, value }\n          }}\n          onPointerMove={(event) => {\n            if (!drag.current) return\n            const dy = drag.current.y - event.clientY\n            set(drag.current.value + (dy / DRAG_RANGE) * (max - min))\n          }}\n          onPointerUp={() => (drag.current = null)}\n          onPointerCancel={() => (drag.current = null)}\n          onKeyDown={(event) => {\n            const big = (max - min) / 10\n            const keys: Record<string, number> = {\n              ArrowUp: value + step,\n              ArrowRight: value + step,\n              ArrowDown: value - step,\n              ArrowLeft: value - step,\n              PageUp: value + big,\n              PageDown: value - big,\n              Home: min,\n              End: max,\n            }\n            if (!(event.key in keys)) return\n            event.preventDefault()\n            set(keys[event.key])\n          }}\n          className=\"relative size-28 cursor-ns-resize touch-none rounded-full outline-none focus-visible:ring-3 focus-visible:ring-ring/50\"\n        >\n          <span aria-hidden=\"true\" className=\"absolute inset-0 rounded-full bg-linear-to-b from-neutral-200 to-neutral-500 shadow-[0_10px_20px_-6px_rgb(0_0_0/0.5),inset_0_1px_0_rgb(255_255_255/0.8)] dark:from-neutral-600 dark:to-neutral-900 dark:shadow-[0_10px_20px_-6px_rgb(0_0_0/0.8),inset_0_1px_0_rgb(255_255_255/0.15)]\" />\n          <span\n            aria-hidden=\"true\"\n            className=\"absolute inset-[10%] rounded-full bg-[conic-gradient(from_0deg,#d4d4d4,#fafafa,#a3a3a3,#e5e5e5,#d4d4d4,#fafafa,#a3a3a3,#e5e5e5,#d4d4d4)] shadow-[inset_0_2px_4px_rgb(255_255_255/0.6),inset_0_-3px_6px_rgb(0_0_0/0.25)] dark:bg-[conic-gradient(from_0deg,#404040,#737373,#262626,#525252,#404040,#737373,#262626,#525252,#404040)]\"\n            style={{ transform: `rotate(${angle}deg)` }}\n          >\n            <span className=\"absolute top-[8%] left-1/2 h-[24%] w-[5%] -translate-x-1/2 rounded-full bg-neutral-900 dark:bg-white\" />\n          </span>\n        </div>\n      </div>\n      <div className=\"text-center\">\n        <p className=\"text-xs tracking-widest text-muted-foreground uppercase\">{label}</p>\n        <p aria-hidden=\"true\" className=\"font-mono text-lg font-semibold tabular-nums\">\n          {format(value)}\n        </p>\n      </div>\n    </div>\n  )\n}\n\nexport { VolumeKnob }\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "version": "0.1.0"
  },
  "categories": [
    "inputs",
    "interactive"
  ],
  "type": "registry:ui"
}