{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "rotary-knob",
  "title": "Rotary knob",
  "description": "A matte charcoal plastic knob with a white indicator line over a scale printed on the faceplate, as a skirted knob or a pointer knob. Turn it by dragging, scrolling or with the arrow keys, and it clicks at each tick.",
  "registryDependencies": [
    "@ui95/hardware"
  ],
  "files": [
    {
      "path": "components/hardware/rotary-knob.css",
      "content": "[data-part=\"knob\"] {\n  --hw-knob-size: 64px;\n  display: inline-flex;\n  flex-direction: column;\n  align-items: center;\n  gap: 4px;\n}\n\n[data-part=\"knob\"][data-size=\"sm\"] {\n  --hw-knob-size: 40px;\n}\n\n[data-part=\"knob\"][data-size=\"lg\"] {\n  --hw-knob-size: 96px;\n}\n\n[data-part=\"knob-mount\"] {\n  position: relative;\n  display: grid;\n  place-items: center;\n  width: calc(var(--hw-knob-size) * 1.5);\n  height: calc(var(--hw-knob-size) * 1.5);\n}\n\n[data-part=\"knob-scale\"] {\n  position: absolute;\n  inset: 0;\n  overflow: visible;\n  color: var(--hw-legend);\n}\n\n[data-part=\"knob-scale\"] line {\n  stroke: currentColor;\n  stroke-width: 0.9;\n  stroke-linecap: butt;\n  opacity: 0.6;\n}\n\n[data-part=\"knob-scale\"] line[data-major] {\n  stroke-width: 1.5;\n  opacity: 0.92;\n}\n\n[data-part=\"knob-scale\"] text {\n  fill: currentColor;\n  font-family: var(--hw-font);\n  font-size: 7px;\n  font-weight: 700;\n  font-stretch: condensed;\n  text-anchor: middle;\n  dominant-baseline: central;\n  opacity: 0.92;\n}\n\n[data-part=\"knob\"][data-size=\"sm\"] [data-part=\"knob-scale\"] text {\n  display: none;\n}\n\n[data-part=\"knob-body\"] {\n  position: relative;\n  width: var(--hw-knob-size);\n  height: var(--hw-knob-size);\n  border-radius: 50%;\n  cursor: grab;\n  touch-action: none;\n  outline: none;\n}\n\n[data-part=\"knob-face\"] {\n  display: block;\n  width: 100%;\n  height: 100%;\n  overflow: visible;\n  filter: drop-shadow(1px 2px 1.2px rgb(var(--hw-shadow-tint) / 0.5)) drop-shadow(3px 6px 5px rgb(var(--hw-shadow-tint) / 0.35));\n  transition: filter 80ms ease-out, scale 80ms ease-out;\n}\n\n[data-part=\"knob-body\"][data-dragging] {\n  cursor: grabbing;\n}\n\n[data-part=\"knob-body\"][data-dragging] [data-part=\"knob-face\"] {\n  scale: 0.985;\n  filter: drop-shadow(1px 1px 1px rgb(var(--hw-shadow-tint) / 0.55)) drop-shadow(2px 4px 3px rgb(var(--hw-shadow-tint) / 0.3));\n}\n\n[data-part=\"knob-body\"][aria-disabled] {\n  cursor: not-allowed;\n}\n\n[data-part=\"knob-body\"][aria-disabled] [data-part=\"knob-face\"] {\n  opacity: 0.72;\n}\n\n[data-part=\"knob-body\"]:focus-visible {\n  box-shadow: 0 0 0 3px color-mix(in oklab, var(--hw-amber-lit) 75%, transparent);\n}\n\n[data-part=\"knob-turn\"] {\n  rotate: var(--hw-turn);\n}\n\n[data-part=\"knob-skirt\"],\n[data-part=\"knob-cap\"] {\n  stroke-width: 1.4;\n}\n\n[data-part=\"knob-flute\"] {\n  stroke: rgb(0 0 0 / 0.45);\n  stroke-width: 2;\n}\n\n[data-part=\"knob-dish\"] {\n  stroke: rgb(255 255 255 / 0.07);\n  stroke-width: 0.8;\n}\n\n[data-part=\"knob-index\"] {\n  stroke: #ece5d3;\n  stroke-width: 3;\n  stroke-linecap: round;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  [data-part=\"knob-face\"] {\n    transition: none;\n  }\n}\n",
      "type": "registry:component",
      "target": "@components/hardware/rotary-knob.css"
    },
    {
      "path": "components/hardware/rotary-knob.tsx",
      "content": "\"use client\"\n\nimport \"./hardware.css\"\nimport \"./rotary-knob.css\"\n\nimport * as React from \"react\"\n\ntype RotaryKnobSize = \"sm\" | \"md\" | \"lg\"\n\ntype RotaryKnobVariant = \"skirted\" | \"pointer\"\n\ntype RotaryKnobCap = \"red\" | \"amber\" | \"green\" | \"slate\"\n\ntype RotaryRange = { min: number; max: number; step: number }\n\nconst SWEEP_DEGREES = 270\n\nconst DRAG_SPAN_PX = 220\n\nconst FINE_DRAG_FACTOR = 0.1\n\nconst PAGE_FRACTION = 0.1\n\nconst SCALE_MAJOR_TICKS = 11\n\nconst SCALE_MINOR_PER_MAJOR = 2\n\nfunction snapToRange(value: number, { min, max, step }: RotaryRange): number {\n  const stepped = Math.round((value - min) / step) * step + min\n  const clamped = Math.min(max, Math.max(min, stepped))\n  return Number(clamped.toFixed(10))\n}\n\nfunction toTurn(value: number, { min, max }: RotaryRange): number {\n  const share = max > min ? (value - min) / (max - min) : 0\n  return share * SWEEP_DEGREES - SWEEP_DEGREES / 2\n}\n\nfunction nextFromKey(key: string, value: number, range: RotaryRange): number | null {\n  const page = Math.max(range.step, (range.max - range.min) * PAGE_FRACTION)\n  switch (key) {\n    case \"ArrowUp\":\n    case \"ArrowRight\":\n      return value + range.step\n    case \"ArrowDown\":\n    case \"ArrowLeft\":\n      return value - range.step\n    case \"PageUp\":\n      return value + page\n    case \"PageDown\":\n      return value - page\n    case \"Home\":\n      return range.min\n    case \"End\":\n      return range.max\n    default:\n      return null\n  }\n}\n\nfunction useRotaryInput(value: number, range: RotaryRange, setValue: (next: number) => void, disabled: boolean) {\n  const ref = React.useRef<HTMLDivElement>(null)\n  const drag = React.useRef<{ x: number; y: number; value: number } | null>(null)\n  const [isDragging, setIsDragging] = React.useState(false)\n\n  const onWheel = React.useEffectEvent((event: WheelEvent) => {\n    if (disabled || event.deltaY === 0) {\n      return\n    }\n    event.preventDefault()\n    setValue(snapToRange(value - Math.sign(event.deltaY) * range.step, range))\n  })\n\n  React.useEffect(() => {\n    const element = ref.current\n    if (!element) {\n      return\n    }\n    const listener = (event: WheelEvent) => onWheel(event)\n    element.addEventListener(\"wheel\", listener, { passive: false })\n    return () => element.removeEventListener(\"wheel\", listener)\n  }, [])\n\n  const onPointerDown = (event: React.PointerEvent<HTMLDivElement>) => {\n    if (disabled || event.button !== 0) {\n      return\n    }\n    event.currentTarget.setPointerCapture(event.pointerId)\n    drag.current = { x: event.clientX, y: event.clientY, value }\n    setIsDragging(true)\n  }\n\n  const onPointerMove = (event: React.PointerEvent<HTMLDivElement>) => {\n    const start = drag.current\n    if (!start) {\n      return\n    }\n    const travel = event.clientX - start.x - (event.clientY - start.y)\n    const factor = event.shiftKey ? FINE_DRAG_FACTOR : 1\n    setValue(snapToRange(start.value + (travel / DRAG_SPAN_PX) * (range.max - range.min) * factor, range))\n  }\n\n  const endDrag = () => {\n    drag.current = null\n    setIsDragging(false)\n  }\n\n  const onKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {\n    const next = disabled ? null : nextFromKey(event.key, value, range)\n    if (next === null) {\n      return\n    }\n    event.preventDefault()\n    setValue(snapToRange(next, range))\n  }\n\n  return {\n    ref,\n    isDragging,\n    handlers: { onPointerDown, onPointerMove, onPointerUp: endDrag, onPointerCancel: endDrag, onLostPointerCapture: endDrag, onKeyDown },\n  }\n}\n\nfunction polar(radius: number, radians: number) {\n  return { x: Number((Math.cos(radians) * radius).toFixed(3)), y: Number((Math.sin(radians) * radius).toFixed(3)) }\n}\n\nconst SCALE_TICK_COUNT = (SCALE_MAJOR_TICKS - 1) * SCALE_MINOR_PER_MAJOR + 1\n\nconst SCALE_TICKS = Array.from({ length: SCALE_TICK_COUNT }, (_, index) => {\n  const isMajor = index % SCALE_MINOR_PER_MAJOR === 0\n  const radians = ((index / (SCALE_TICK_COUNT - 1)) * SWEEP_DEGREES - SWEEP_DEGREES / 2 - 90) * (Math.PI / 180)\n  return {\n    index,\n    isMajor,\n    inner: polar(36.5, radians),\n    outer: polar(isMajor ? 41 : 39.5, radians),\n    numeral: isMajor ? { ...polar(46, radians), text: String(index / SCALE_MINOR_PER_MAJOR) } : null,\n  }\n})\n\nfunction KnobScale() {\n  return (\n    <svg aria-hidden data-part=\"knob-scale\" viewBox=\"-50 -50 100 100\">\n      {SCALE_TICKS.map(({ index, isMajor, inner, outer, numeral }) => (\n        <g key={index}>\n          <line x1={inner.x} y1={inner.y} x2={outer.x} y2={outer.y} data-major={isMajor ? \"\" : undefined} />\n          {numeral && (\n            <text x={numeral.x} y={numeral.y}>\n              {numeral.text}\n            </text>\n          )}\n        </g>\n      ))}\n    </svg>\n  )\n}\n\nconst FLUTE_COUNT = 36\n\nconst POINTER_ARM_CLEARANCE_DEGREES = 40\n\nfunction flutes(inner: number, outer: number, skipArm: boolean) {\n  return Array.from({ length: FLUTE_COUNT }, (_, index) => (index / FLUTE_COUNT) * 360)\n    .filter((degrees) => !skipArm || Math.abs(((degrees + 180) % 360) - 180) > POINTER_ARM_CLEARANCE_DEGREES)\n    .map((degrees) => {\n      const radians = (degrees - 90) * (Math.PI / 180)\n      return { degrees, from: polar(inner, radians), to: polar(outer, radians) }\n    })\n}\n\nconst SKIRTED_FLUTES = flutes(30.5, 34, false)\n\nconst POINTER_FLUTES = flutes(26.5, 30, true)\n\nconst POINTER_PATH = \"M -14.08 -26.49 C -10 -36 -5 -46 0 -47 C 5 -46 10 -36 14.08 -26.49 A 30 30 0 1 1 -14.08 -26.49 Z\"\n\nconst CAP_FILL: Record<RotaryKnobCap, string> = {\n  red: \"var(--hw-red)\",\n  amber: \"var(--hw-amber)\",\n  green: \"var(--hw-green)\",\n  slate: \"var(--hw-slate)\",\n}\n\nfunction KnobFace({ variant, cap, turn }: { variant: RotaryKnobVariant; cap?: RotaryKnobCap; turn: number }) {\n  const id = React.useId().replace(/[^a-zA-Z0-9]/g, \"\")\n  const light = `rotate(${-turn})`\n  const isSkirted = variant === \"skirted\"\n  return (\n    <svg aria-hidden data-part=\"knob-face\" viewBox=\"-50 -50 100 100\">\n      <defs>\n        <radialGradient id={`${id}-body`} gradientUnits=\"userSpaceOnUse\" cx=\"-20\" cy=\"-24\" r=\"82\" gradientTransform={light}>\n          <stop offset=\"0\" stopColor=\"#4d4a46\" />\n          <stop offset=\"0.42\" stopColor=\"#2c2a28\" />\n          <stop offset=\"1\" stopColor=\"#141312\" />\n        </radialGradient>\n        <radialGradient id={`${id}-dish`} gradientUnits=\"userSpaceOnUse\" cx=\"10\" cy=\"12\" r=\"34\" gradientTransform={light}>\n          <stop offset=\"0\" stopColor=\"#3a3734\" />\n          <stop offset=\"1\" stopColor=\"#1c1b19\" />\n        </radialGradient>\n        <linearGradient id={`${id}-rim`} gradientUnits=\"userSpaceOnUse\" x1=\"-34\" y1=\"-34\" x2=\"34\" y2=\"34\" gradientTransform={light}>\n          <stop offset=\"0\" stopColor=\"#8f8a82\" />\n          <stop offset=\"0.5\" stopColor=\"#2a2826\" />\n          <stop offset=\"1\" stopColor=\"#050505\" />\n        </linearGradient>\n        <radialGradient id={`${id}-insert`} gradientUnits=\"userSpaceOnUse\" cx=\"6\" cy=\"8\" r=\"20\" gradientTransform={light}>\n          <stop offset=\"0\" stopColor=\"#ffffff\" stopOpacity=\"0.12\" />\n          <stop offset=\"1\" stopColor=\"#000000\" stopOpacity=\"0.35\" />\n        </radialGradient>\n      </defs>\n      <g data-part=\"knob-turn\">\n        {isSkirted ? (\n          <>\n            <circle r=\"48\" fill={`url(#${id}-body)`} stroke={`url(#${id}-rim)`} data-part=\"knob-skirt\" />\n            <line x1=\"0\" y1=\"-46.5\" x2=\"0\" y2=\"-38\" data-part=\"knob-index\" />\n            <circle r=\"34\" fill={`url(#${id}-body)`} stroke={`url(#${id}-rim)`} data-part=\"knob-cap\" />\n            {SKIRTED_FLUTES.map(({ degrees, from, to }) => (\n              <line key={degrees} x1={from.x} y1={from.y} x2={to.x} y2={to.y} data-part=\"knob-flute\" />\n            ))}\n            <circle r=\"27\" fill={`url(#${id}-dish)`} data-part=\"knob-dish\" />\n          </>\n        ) : (\n          <>\n            <path d={POINTER_PATH} fill={`url(#${id}-body)`} stroke={`url(#${id}-rim)`} data-part=\"knob-cap\" />\n            {POINTER_FLUTES.map(({ degrees, from, to }) => (\n              <line key={degrees} x1={from.x} y1={from.y} x2={to.x} y2={to.y} data-part=\"knob-flute\" />\n            ))}\n            <circle r=\"21\" fill={`url(#${id}-dish)`} data-part=\"knob-dish\" />\n          </>\n        )}\n        {cap && (\n          <>\n            <circle r={isSkirted ? 17 : 13} style={{ fill: CAP_FILL[cap] }} />\n            <circle r={isSkirted ? 17 : 13} fill={`url(#${id}-insert)`} />\n          </>\n        )}\n        <line x1=\"0\" y1={isSkirted ? -9 : -12} x2=\"0\" y2={isSkirted ? -30 : -43} data-part=\"knob-index\" />\n      </g>\n    </svg>\n  )\n}\n\ntype RotaryKnobProps = Omit<React.ComponentProps<\"div\">, \"defaultValue\" | \"onChange\"> & {\n  label: string\n  value?: number\n  defaultValue?: number\n  onValueChange?: (value: number) => void\n  min?: number\n  max?: number\n  step?: number\n  size?: RotaryKnobSize\n  variant?: RotaryKnobVariant\n  cap?: RotaryKnobCap\n  disabled?: boolean\n}\n\nfunction RotaryKnob({\n  label,\n  value: controlled,\n  defaultValue,\n  onValueChange,\n  min = 0,\n  max = 100,\n  step = 1,\n  size = \"md\",\n  variant = \"skirted\",\n  cap,\n  disabled = false,\n  ...props\n}: RotaryKnobProps) {\n  const range = { min, max, step }\n  const [stored, setStored] = React.useState(() => snapToRange(defaultValue ?? min, range))\n  const value = controlled ?? stored\n  const setValue = (next: number) => {\n    if (next === value) {\n      return\n    }\n    setStored(next)\n    onValueChange?.(next)\n  }\n  const { ref, isDragging, handlers } = useRotaryInput(value, range, setValue, disabled)\n  const turn = toTurn(value, range)\n\n  return (\n    <div data-hw=\"\" data-part=\"knob\" data-size={size} data-variant={variant} {...props}>\n      <div data-part=\"knob-mount\">\n        <KnobScale />\n        <div\n          ref={ref}\n          role=\"slider\"\n          tabIndex={disabled ? -1 : 0}\n          aria-label={label}\n          aria-valuemin={min}\n          aria-valuemax={max}\n          aria-valuenow={value}\n          aria-disabled={disabled || undefined}\n          data-slot=\"rotary-knob\"\n          data-part=\"knob-body\"\n          data-dragging={isDragging ? \"\" : undefined}\n          style={{ \"--hw-turn\": `${turn}deg` } as React.CSSProperties}\n          {...handlers}\n        >\n          <KnobFace variant={variant} cap={cap} turn={turn} />\n        </div>\n      </div>\n      <span data-part=\"legend\">{label}</span>\n    </div>\n  )\n}\n\nexport { RotaryKnob, type RotaryKnobCap, type RotaryKnobSize, type RotaryKnobVariant }\n",
      "type": "registry:component",
      "target": "@components/hardware/rotary-knob.tsx"
    }
  ],
  "meta": {
    "sounds": {
      "knob.tick": {
        "note": "Detent click: sine 940 Hz falling to 420 Hz over a short noise tick, one per printed tick",
        "layers": [
          {
            "wave": "sine",
            "frequency": 940,
            "attack": 0.0005,
            "decay": 0.006,
            "gain": 0.16,
            "frequencyEnd": 420
          },
          {
            "wave": "noise",
            "frequency": 0,
            "attack": 0,
            "decay": 0.003,
            "gain": 0.12,
            "filter": {
              "type": "bandpass",
              "frequency": 3200,
              "q": 1.2
            }
          }
        ],
        "jitter": {
          "cents": 30,
          "gainDb": 1,
          "decay": 0.1
        },
        "detent": {
          "step": 5,
          "minGap": 18,
          "maxAhead": 60,
          "policy": "spread",
          "pitchFollow": 0
        }
      }
    }
  },
  "docs": "variant=\"skirted\" | \"pointer\" picks the knob shape, and cap=\"red\" | \"amber\" | \"green\" | \"slate\" adds a coloured cap insert. Drag up or right to turn it up, and hold Shift for fine control. The wheel and the arrow keys move one step, Page Up and Page Down a tenth of the range, Home and End to the stops. It is a role=\"slider\", so screen readers announce its value. The light stays at the top-left while the knob turns. With the sound item installed, data-slot=\"rotary-knob\" plays knob.tick at each printed tick.",
  "categories": [
    "hardware"
  ],
  "type": "registry:ui"
}
