{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "metal-knob",
  "type": "registry:component",
  "title": "Metal Knob",
  "description": "A knurled metal knob you turn by dragging.",
  "author": "Marcelo Treviño Velázquez <https://furin.dev>",
  "dependencies": [],
  "categories": [
    "Navigation"
  ],
  "docs": "Installed in components/furin/metal-knob/. Docs, live controls and props table: https://furin.dev/components/metal-knob/",
  "files": [
    {
      "path": "registry/metal-knob/MetalKnob.tsx",
      "content": "\"use client\";\nimport { useRef, useState } from \"react\";\nimport type { CSSProperties, KeyboardEvent, PointerEvent } from \"react\";\nimport \"./MetalKnob.css\";\n\nexport interface MetalKnobProps {\n  /** Valor actual (modo controlado). */\n  value?: number;\n  /** Valor inicial cuando no se controla desde fuera. */\n  defaultValue?: number;\n  /** Se llama cada vez que cambia el valor. */\n  onChange?: (value: number) => void;\n  /** Valor mínimo. */\n  min?: number;\n  /** Valor máximo. */\n  max?: number;\n  /** Salto entre valores. */\n  step?: number;\n  /** Rótulo bajo la perilla. */\n  label?: string;\n  /** Unidad que se muestra junto al valor. */\n  unit?: string;\n  /** Diámetro de la perilla, en px. */\n  size?: number;\n  /** Marcas grandes de la escala. */\n  ticks?: number;\n  /** Color de las marcas encendidas. */\n  accent?: string;\n  /** Deshabilita la perilla. */\n  disabled?: boolean;\n  /** Clase extra para el contenedor. */\n  className?: string;\n  /** Estilos extra para el contenedor. */\n  style?: CSSProperties;\n}\n\nconst BARRIDO = 270; // grados totales que recorre la perilla\nconst SUBDIV = 5; // subdivisiones entre dos marcas grandes\n\nconst limitar = (v: number, a: number, b: number) => Math.min(b, Math.max(a, v));\n/** Diferencia de ángulos normalizada a -180..180 (para no saltar al cruzar el norte). */\nconst diferencia = (a: number, b: number) => ((((a - b) % 360) + 540) % 360) - 180;\n\n/** Perilla metálica moleteada: se gira arrastrando en círculo o con las flechas, con escala de marcas que se encienden y un reflejo que sigue al cursor. */\nexport function MetalKnob({\n  value: controlado,\n  defaultValue = 64,\n  onChange,\n  min = 0,\n  max = 100,\n  step = 1,\n  label = \"Volume\",\n  unit = \"\",\n  size = 140,\n  ticks = 11,\n  accent = \"#ffb13b\",\n  disabled = false,\n  className = \"\",\n  style,\n}: MetalKnobProps) {\n  const [interno, setInterno] = useState(defaultValue);\n  const valor = limitar(controlado ?? interno, min, max);\n  const [crudo, setCrudo] = useState<number | null>(null); // ángulo continuo mientras se arrastra\n  const perilla = useRef<HTMLDivElement>(null);\n  const gesto = useRef<{ ultimo: number; ang: number } | null>(null);\n\n  const rango = max - min || 1;\n  const aAngulo = (v: number) => ((v - min) / rango) * BARRIDO - BARRIDO / 2;\n  const aValor = (ang: number) => {\n    const bruto = min + ((ang + BARRIDO / 2) / BARRIDO) * rango;\n    const paso = step > 0 ? Math.round((bruto - min) / step) * step + min : bruto;\n    return limitar(Number(paso.toFixed(6)), min, max);\n  };\n  const angulo = crudo ?? aAngulo(valor);\n\n  const fijar = (v: number) => {\n    const n = limitar(v, min, max);\n    if (n === valor) return;\n    if (controlado === undefined) setInterno(n);\n    onChange?.(n);\n  };\n\n  const puntero = (e: PointerEvent) => {\n    const r = perilla.current!.getBoundingClientRect();\n    const dx = e.clientX - (r.left + r.width / 2);\n    const dy = e.clientY - (r.top + r.height / 2);\n    return { ang: (Math.atan2(dx, -dy) * 180) / Math.PI, dist: Math.hypot(dx, dy) };\n  };\n\n  const alBajar = (e: PointerEvent<HTMLDivElement>) => {\n    if (disabled) return;\n    e.currentTarget.setPointerCapture(e.pointerId);\n    gesto.current = { ultimo: puntero(e).ang, ang: aAngulo(valor) };\n    setCrudo(gesto.current.ang);\n  };\n  const alMover = (e: PointerEvent<HTMLDivElement>) => {\n    // El reflejo sigue al cursor aunque no se esté arrastrando.\n    const r = e.currentTarget.getBoundingClientRect();\n    e.currentTarget.style.setProperty(\"--fmk-x\", limitar((e.clientX - r.left) / r.width, 0, 1).toFixed(3));\n    e.currentTarget.style.setProperty(\"--fmk-y\", limitar((e.clientY - r.top) / r.height, 0, 1).toFixed(3));\n    const g = gesto.current;\n    if (!g) return;\n    const p = puntero(e);\n    if (p.dist < 12) return; // junto al centro el ángulo es inestable\n    g.ang = limitar(g.ang + diferencia(p.ang, g.ultimo), -BARRIDO / 2, BARRIDO / 2);\n    g.ultimo = p.ang;\n    setCrudo(g.ang);\n    fijar(aValor(g.ang));\n  };\n  const alSoltar = () => {\n    if (!gesto.current) return;\n    gesto.current = null;\n    setCrudo(null); // el ángulo vuelve al valor con paso, con rebote de muelle\n  };\n  const alTeclado = (e: KeyboardEvent<HTMLDivElement>) => {\n    if (disabled) return;\n    const salto = step > 0 ? step : rango / 100;\n    const mapa: Record<string, number> = { ArrowUp: salto, ArrowRight: salto, ArrowDown: -salto, ArrowLeft: -salto, PageUp: salto * 10, PageDown: -salto * 10 };\n    if (e.key in mapa) { e.preventDefault(); fijar(valor + mapa[e.key]); }\n    else if (e.key === \"Home\") { e.preventDefault(); fijar(min); }\n    else if (e.key === \"End\") { e.preventDefault(); fijar(max); }\n  };\n\n  // Escala: marcas grandes y pequeñas; se encienden hasta el valor actual.\n  const W = size + 104;\n  const c = W / 2;\n  const r0 = size / 2 + 24;\n  const segmentos = Math.max(2, ticks - 1);\n  const total = segmentos * SUBDIV;\n  const fraccion = (valor - min) / rango;\n  const marcas = Array.from({ length: total + 1 }, (_, m) => {\n    const f = m / total;\n    const a = ((-BARRIDO / 2 + f * BARRIDO) * Math.PI) / 180;\n    const grande = m % SUBDIV === 0;\n    const r1 = r0 + (grande ? 11 : 6);\n    return { x1: c + r0 * Math.sin(a), y1: c - r0 * Math.cos(a), x2: c + r1 * Math.sin(a), y2: c - r1 * Math.cos(a), grande, on: f <= fraccion + 1e-6 };\n  });\n  const etiqueta = (f: number) => {\n    const a = ((-BARRIDO / 2 + f * BARRIDO) * Math.PI) / 180;\n    return { x: c + (r0 + 24) * Math.sin(a), y: c - (r0 + 24) * Math.cos(a) };\n  };\n  const eMin = etiqueta(0);\n  const eMax = etiqueta(1);\n\n  const vars = { \"--fmk-d\": `${size}px`, \"--fmk-accent\": accent, \"--fmk-w\": `${W}px` } as CSSProperties;\n  const texto = `${Number(valor.toFixed(2))}${unit ? ` ${unit}` : \"\"}`;\n  return (\n    <div className={`furin-metal-knob ${disabled ? \"furin-metal-knob--off\" : \"\"} ${className}`} style={{ ...vars, ...style }}>\n      <div className=\"furin-metal-knob__dial\">\n        <svg className=\"furin-metal-knob__scale\" viewBox={`0 0 ${W} ${W}`} aria-hidden=\"true\">\n          {marcas.map((m, i) => (\n            <line key={i} x1={m.x1} y1={m.y1} x2={m.x2} y2={m.y2} className={`furin-metal-knob__tick${m.on ? \" is-on\" : \"\"}${m.grande ? \" is-major\" : \"\"}`} />\n          ))}\n          <text x={eMin.x} y={eMin.y} className=\"furin-metal-knob__num\" textAnchor=\"middle\" dominantBaseline=\"middle\">{min}</text>\n          <text x={eMax.x} y={eMax.y} className=\"furin-metal-knob__num\" textAnchor=\"middle\" dominantBaseline=\"middle\">{max}</text>\n        </svg>\n        <div className=\"furin-metal-knob__well\" />\n        <div\n          ref={perilla}\n          className={`furin-metal-knob__knob${crudo !== null ? \" is-dragging\" : \"\"}`}\n          role=\"slider\"\n          tabIndex={disabled ? -1 : 0}\n          aria-label={label}\n          aria-valuemin={min}\n          aria-valuemax={max}\n          aria-valuenow={valor}\n          aria-valuetext={texto}\n          aria-disabled={disabled || undefined}\n          onPointerDown={alBajar}\n          onPointerMove={alMover}\n          onPointerUp={alSoltar}\n          onPointerCancel={alSoltar}\n          onPointerLeave={(e) => { e.currentTarget.style.removeProperty(\"--fmk-x\"); e.currentTarget.style.removeProperty(\"--fmk-y\"); }}\n          onKeyDown={alTeclado}\n          onDoubleClick={() => fijar(defaultValue)}\n        >\n          <div className=\"furin-metal-knob__turn\" style={{ transform: `rotate(${angulo}deg)` }}>\n            <div className=\"furin-metal-knob__grip\" />\n            <div className=\"furin-metal-knob__cap\">\n              <div className=\"furin-metal-knob__mark\" />\n            </div>\n          </div>\n          <div className=\"furin-metal-knob__light furin-metal-knob__light--ring\" />\n          <div className=\"furin-metal-knob__light furin-metal-knob__light--cap\" />\n          <div className=\"furin-metal-knob__spec\" />\n        </div>\n      </div>\n      <div className=\"furin-metal-knob__readout\">\n        <span className=\"furin-metal-knob__label\">{label}</span>\n        <output className=\"furin-metal-knob__value\">{texto}</output>\n      </div>\n    </div>\n  );\n}\n\nexport default MetalKnob;\n",
      "type": "registry:component",
      "target": "components/furin/metal-knob/MetalKnob.tsx"
    },
    {
      "path": "registry/metal-knob/MetalKnob.css",
      "content": "@property --fmk-x { syntax: \"<number>\"; inherits: true; initial-value: 0.34; }\n@property --fmk-y { syntax: \"<number>\"; inherits: true; initial-value: 0.24; }\n\n.furin-metal-knob {\n  --fmk-d: 140px;\n  --fmk-accent: #ffb13b;\n  --fmk-grain: url(\"data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='240'%20height='240'%3E%3Cfilter%20id='g'%20x='0'%20y='0'%20width='100%25'%20height='100%25'%3E%3CfeTurbulence%20type='fractalNoise'%20baseFrequency='0.012%200.9'%20numOctaves='2'%20seed='5'%20stitchTiles='stitch'/%3E%3CfeColorMatrix%20type='matrix'%20values='0.33%200.33%200.33%200%200%200.33%200.33%200.33%200%200%200.33%200.33%200.33%200%200%200%200%200%200%201'/%3E%3CfeComponentTransfer%3E%3CfeFuncR%20type='linear'%20slope='2.2'%20intercept='-0.6'/%3E%3CfeFuncG%20type='linear'%20slope='2.2'%20intercept='-0.6'/%3E%3CfeFuncB%20type='linear'%20slope='2.2'%20intercept='-0.6'/%3E%3C/feComponentTransfer%3E%3C/filter%3E%3Crect%20width='100%25'%20height='100%25'%20filter='url(%23g)'/%3E%3C/svg%3E\");\n  display: inline-flex;\n  flex-direction: column;\n  align-items: center;\n  user-select: none;\n}\n.furin-metal-knob--off { opacity: 0.55; filter: grayscale(0.6); }\n\n.furin-metal-knob__dial {\n  position: relative;\n  width: var(--fmk-w);\n  height: var(--fmk-w);\n  display: grid;\n  place-items: center;\n  isolation: isolate;\n}\n\n/* Escala: marcas grabadas, las encendidas brillan con el color de acento. */\n.furin-metal-knob__scale { position: absolute; inset: 0; width: 100%; height: 100%; overflow: visible; }\n.furin-metal-knob__tick { stroke: #3a3f47; stroke-width: 1.4; stroke-linecap: round; transition: stroke 0.18s ease; }\n.furin-metal-knob__tick.is-major { stroke-width: 2.2; stroke: #4a5059; }\n.furin-metal-knob__tick.is-on { stroke: var(--fmk-accent); filter: drop-shadow(0 0 3px color-mix(in srgb, var(--fmk-accent) 75%, transparent)); }\n.furin-metal-knob__num { font: 600 10px / 1 ui-monospace, \"JetBrains Mono\", \"SF Mono\", Menlo, monospace; fill: #6b727c; letter-spacing: 0.04em; }\n\n/* Alojamiento: un pozo oscuro con bisel donde se asienta la perilla. */\n.furin-metal-knob__well {\n  position: absolute;\n  width: calc(var(--fmk-d) + 26px);\n  height: calc(var(--fmk-d) + 26px);\n  border-radius: 50%;\n  background:\n    radial-gradient(circle at 50% 38%, #101216 0%, #07080a 72%);\n  box-shadow:\n    0 0 0 2px #2a2e34,\n    0 0 0 3px #0a0b0d,\n    0 1px 0 3px rgba(255, 255, 255, 0.1),\n    inset 0 4px 10px rgba(0, 0, 0, 0.95);\n}\n/* Aro de aluminio oscuro alrededor del pozo, con reflejos de estudio. */\n.furin-metal-knob__well::before {\n  content: \"\";\n  position: absolute;\n  inset: -7px;\n  z-index: -1;\n  border-radius: 50%;\n  background: conic-gradient(from 30deg, #3b4047, #7a808a 12%, #2a2d33 25%, #646a74 37%, #3b4047 50%, #7a808a 62%, #2a2d33 75%, #646a74 87%, #3b4047);\n  box-shadow: 0 0 0 1px rgba(0, 0, 0, 0.8), 0 6px 12px rgba(0, 0, 0, 0.55), inset 0 1px 1px rgba(255, 255, 255, 0.35);\n}\n\n.furin-metal-knob__knob {\n  position: relative;\n  width: var(--fmk-d);\n  height: var(--fmk-d);\n  border-radius: 50%;\n  cursor: grab;\n  touch-action: none;\n  isolation: isolate;\n  outline: none;\n  box-shadow:\n    0 2px 2px rgba(0, 0, 0, 0.7),\n    0 10px 14px -2px rgba(0, 0, 0, 0.65),\n    0 24px 30px -8px rgba(0, 0, 0, 0.8);\n  transition: transform 0.25s cubic-bezier(0.3, 1.5, 0.5, 1), box-shadow 0.25s ease;\n}\n.furin-metal-knob__knob.is-dragging { cursor: grabbing; transform: scale(0.985); box-shadow: 0 1px 1px rgba(0, 0, 0, 0.7), 0 6px 10px -2px rgba(0, 0, 0, 0.65), 0 14px 20px -8px rgba(0, 0, 0, 0.8); }\n.furin-metal-knob__knob:focus-visible { outline: 2px solid rgba(150, 185, 255, 0.95); outline-offset: 10px; }\n.furin-metal-knob--off .furin-metal-knob__knob { cursor: not-allowed; }\n\n/* Parte que gira: aro moleteado y tapa con su marca. El snap al valor con paso rebota como muelle. */\n.furin-metal-knob__turn {\n  position: absolute;\n  inset: 0;\n  border-radius: 50%;\n  transition: transform 0.38s cubic-bezier(0.3, 1.45, 0.5, 1);\n  will-change: transform;\n}\n.furin-metal-knob__knob.is-dragging .furin-metal-knob__turn { transition: none; }\n\n/* Moleteado: una onda triangular de 3° vista desde arriba como dientes finos. */\n.furin-metal-knob__grip {\n  position: absolute;\n  inset: 0;\n  border-radius: 50%;\n  background:\n    repeating-conic-gradient(from 0deg, #3c4048 0deg, #cfd4db 1.5deg, #3c4048 3deg);\n  box-shadow: inset 0 0 0 1px rgba(0, 0, 0, 0.55), inset 0 0 8px rgba(0, 0, 0, 0.55);\n}\n\n.furin-metal-knob__cap {\n  position: absolute;\n  inset: calc(var(--fmk-d) * 0.11);\n  border-radius: 50%;\n  background:\n    repeating-radial-gradient(circle at 50% 50%, rgba(255, 255, 255, 0.07) 0 0.6px, rgba(0, 0, 0, 0.08) 0.6px 1.5px),\n    radial-gradient(circle at 50% 50%, #c4cad2 0%, #a2a9b3 100%);\n  box-shadow:\n    0 0 0 1.5px rgba(0, 0, 0, 0.75),\n    0 0 0 3px rgba(255, 255, 255, 0.12),\n    inset 0 0 0 1px rgba(255, 255, 255, 0.7),\n    inset 0 0 0 3.5px rgba(0, 0, 0, 0.16),\n    inset 0 -3px 5px rgba(0, 0, 0, 0.25);\n}\n\n/* Marca: una ranura rebajada con filo de luz. */\n.furin-metal-knob__mark {\n  position: absolute;\n  left: 50%;\n  top: 7%;\n  width: calc(var(--fmk-d) * 0.034);\n  height: 25%;\n  min-width: 4px;\n  transform: translateX(-50%);\n  border-radius: 99px;\n  background: linear-gradient(180deg, #0c0d10, #2a2d33);\n  box-shadow: 0 1px 0 rgba(255, 255, 255, 0.85), inset 0 1px 2px rgba(0, 0, 0, 0.9);\n}\n\n/* Luz de estudio fija: no gira con la perilla, así que los reflejos se quedan en su sitio. */\n.furin-metal-knob__light {\n  position: absolute;\n  border-radius: 50%;\n  pointer-events: none;\n  mix-blend-mode: overlay;\n}\n.furin-metal-knob__light--ring {\n  inset: 0;\n  background: conic-gradient(from 0deg, #fff 0%, #000 12%, #bbb 22%, #000 36%, #fff 50%, #000 62%, #bbb 72%, #000 86%, #fff 100%);\n  opacity: 0.8;\n}\n.furin-metal-knob__light--cap {\n  inset: calc(var(--fmk-d) * 0.11);\n  background:\n    radial-gradient(circle at 34% 26%, rgba(255, 255, 255, 0.9) 0%, rgba(255, 255, 255, 0) 52%),\n    conic-gradient(from 20deg, #e8e8e8 0%, #6a6a6a 14%, #f4f4f4 26%, #7c7c7c 40%, #dedede 52%, #626262 66%, #f6f6f6 78%, #787878 90%, #e8e8e8 100%);\n  opacity: 0.55;\n}\n/* Punto caliente que sigue al cursor. */\n.furin-metal-knob__spec {\n  position: absolute;\n  inset: 0;\n  border-radius: 50%;\n  pointer-events: none;\n  background: radial-gradient(circle at calc(var(--fmk-x) * 100%) calc(var(--fmk-y) * 100%), rgba(255, 255, 255, 0.55) 0%, rgba(255, 255, 255, 0.2) 22%, rgba(255, 255, 255, 0) 46%);\n  mix-blend-mode: normal;\n  transition: --fmk-x 0.4s cubic-bezier(0.2, 0.75, 0.25, 1), --fmk-y 0.4s cubic-bezier(0.2, 0.75, 0.25, 1);\n}\n.furin-metal-knob__knob { transition: --fmk-x 0.4s cubic-bezier(0.2, 0.75, 0.25, 1), --fmk-y 0.4s cubic-bezier(0.2, 0.75, 0.25, 1), transform 0.25s cubic-bezier(0.3, 1.5, 0.5, 1), box-shadow 0.25s ease; }\n\n/* Lectura. */\n.furin-metal-knob__readout { display: grid; justify-items: center; gap: 6px; margin-top: -30px; }\n.furin-metal-knob__label {\n  font: 600 10px / 1 ui-monospace, \"JetBrains Mono\", \"SF Mono\", Menlo, monospace;\n  letter-spacing: 0.22em;\n  text-indent: 0.22em;\n  text-transform: uppercase;\n  color: #7b828c;\n  text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.7);\n}\n.furin-metal-knob__value {\n  font: 600 20px / 1 ui-monospace, \"JetBrains Mono\", \"SF Mono\", Menlo, monospace;\n  font-variant-numeric: tabular-nums;\n  color: #e9ecf0;\n  text-shadow: 0 0 12px color-mix(in srgb, var(--fmk-accent) 40%, transparent);\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .furin-metal-knob__turn, .furin-metal-knob__knob, .furin-metal-knob__spec, .furin-metal-knob__tick { transition: none; }\n}\n",
      "type": "registry:file",
      "target": "components/furin/metal-knob/MetalKnob.css"
    }
  ]
}
