{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ratchet",
  "title": "Ratchet",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Catraca de aço: o gesto dá corda numa roda que só gira para um lado, com a lingueta caindo a cada dente.",
  "dependencies": [
    "motion"
  ],
  "registryDependencies": [
    "utils",
    "@visant/use-idle"
  ],
  "files": [
    {
      "path": "registry/visant/ui/ratchet.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { motion, useMotionValue, useMotionValueEvent, useReducedMotion, useSpring, useTransform } from \"motion/react\";\n\nimport { useIdle } from \"@/hooks/use-idle\";\nimport { cn } from \"@/lib/utils\";\n\nexport interface RatchetProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onChange\"> {\n  /**\n   * Dentes da catraca.\n   * @min 8\n   * @max 32\n   * @step 1\n   */\n  teeth?: number;\n  /**\n   * Curso da roda do mouse por dente, em px. O arrasto não usa: uma volta do dedo é uma volta da roda.\n   * @min 16\n   * @max 120\n   * @step 4\n   */\n  pitch?: number;\n  /** Sozinha na tela, a catraca dá um clique de tempos em tempos. */\n  idle?: boolean;\n  /** Nome do controle para leitor de tela. */\n  label?: string;\n  /** Avisa a cada dente que a pessoa passa, com o total desde que a peça montou. O passo sozinho não conta. */\n  onWind?: (clicks: number) => void;\n}\n\nconst R_PONTA = 44;\nconst R_RAIZ = 36;\n// O aço sai do tema: tinta e fundo misturados em vários tons, nenhum valor próprio.\nconst ACO = (pct: number) => `color-mix(in srgb, var(--foreground) ${pct}%, var(--background))`;\nconst TORNEADO = `conic-gradient(from 25deg, ${ACO(52)}, ${ACO(8)} 11%, ${ACO(40)} 22%, ${ACO(80)} 36%, ${ACO(48)} 50%, ${ACO(6)} 61%, ${ACO(38)} 72%, ${ACO(78)} 87%, ${ACO(52)})`;\nconst CHAPA = `conic-gradient(from 205deg, ${ACO(30)}, ${ACO(5)} 14%, ${ACO(26)} 30%, ${ACO(60)} 48%, ${ACO(24)} 64%, ${ACO(6)} 78%, ${ACO(30)})`;\nconst CUBO = `conic-gradient(from 25deg, ${ACO(70)}, ${ACO(10)} 22%, ${ACO(58)} 46%, ${ACO(12)} 72%, ${ACO(70)})`;\nconst RISCOS = `repeating-radial-gradient(circle at 50% 50%, color-mix(in srgb, white 7%, transparent) 0 1px, color-mix(in srgb, black 7%, transparent) 1px 2px)`;\nconst FUROS = [0, 90, 180, 270];\n\n/** A engrenagem como polígono em %: escala com a caixa e cabe num `clip-path`. */\nfunction contorno(dentes: number) {\n  const passo = 360 / dentes;\n  const ponto = (r: number, grau: number) => {\n    const t = (grau * Math.PI) / 180;\n    const k = 50 * (r / R_PONTA);\n    return `${(50 + k * Math.cos(t)).toFixed(2)}% ${(50 + k * Math.sin(t)).toFixed(2)}%`;\n  };\n  const lados: string[] = [];\n  for (let i = 0; i < dentes; i++) {\n    const a = -90 + i * passo;\n    lados.push(ponto(R_RAIZ, a), ponto(R_PONTA, a + passo * 0.1)); // face íngreme, depois a rampa longa\n  }\n  return `polygon(${lados.join(\",\")})`;\n}\n\nconst subida = (s: number, curso: number) => Math.min((s % curso) / curso / 0.9, 1) * 15;\n\n/**\n * Catraca: girar o dedo em volta do eixo dá corda numa roda dentada que só anda no sentido\n * horário, com a lingueta subindo a rampa de cada dente e caindo da face íngreme.\n *\n * - **O gesto é o ângulo, não o eixo.** Uma volta do dedo é uma volta da roda: um clique por\n *   dente. No sentido contrário a lingueta segura, e a roda fica onde está.\n * - **Metal é luz que não gira.** O reflexo do aço torneado fica parado enquanto o recorte\n *   da roda gira: a roda vai num sentido e o gradiente, dentro dela, no sentido contrário.\n *   Tudo em `transform`, sem repintar por quadro. Um desvio pequeno faz o reflexo cintilar.\n * - **O clique tem três partes:** a lingueta quica (mola subamortecida), a roda recua um\n *   fio e o ponto de contato brilha. É isso que dá vida ao desenho.\n * - **`touch-none` só na roda.** Gesto circular não tem eixo para ceder à rolagem, e a zona\n *   é redonda: o dedo que começa fora dela rola a página. A roda do mouse é ouvida sem\n *   `preventDefault`: dá corda e a página rola junto, sem armadilha.\n * - **Movimento reduzido:** a lingueta só pousa, sem quique, sem recuo e sem brilho.\n */\nexport function Ratchet({ teeth = 16, pitch = 40, idle = true, label = \"Catraca\", onWind, className, ...rest }: RatchetProps) {\n  const reduz = useReducedMotion();\n  const caixa = React.useRef<HTMLDivElement>(null);\n  const nasce = pitch * 2.55; // no meio do dente: a foto já mostra a lingueta levantada\n  const curso = useMotionValue(nasce);\n  const mola = useSpring(curso, { stiffness: 520, damping: 42 });\n  const visto = reduz ? curso : mola;\n  const passo = 360 / teeth;\n  const lingueta = useSpring(subida(nasce, pitch), { stiffness: 700, damping: 14 });\n  const recuo = useSpring(0, { stiffness: 900, damping: 22 });\n  const brilho = useSpring(0, { stiffness: 260, damping: 26 });\n  const giro = useTransform([visto, recuo], ([s, r]: number[]) => (s / pitch) * passo + r);\n  const reflexo = useTransform(giro, (g) => -g + Math.sin((g * Math.PI) / 45) * 6);\n  const preso = React.useRef<number | null>(null);\n  const sozinho = React.useRef(0);\n  const dente = React.useRef(Math.floor(nasce / pitch));\n  const total = React.useRef(0);\n  const [cliques, setCliques] = React.useState(0);\n  const forma = React.useMemo(() => contorno(teeth), [teeth]);\n\n  useMotionValueEvent(visto, \"change\", (s) => {\n    if (reduz) lingueta.jump(subida(s, pitch));\n    else lingueta.set(subida(s, pitch));\n    const agora = Math.floor(s / pitch);\n    if (agora === dente.current) return;\n    const novos = agora - dente.current;\n    dente.current = agora;\n    // O passo sozinho anima a roda, mas não é valor de ninguém.\n    const dele = Math.min(novos, sozinho.current);\n    sozinho.current -= dele;\n    if (novos > dele) {\n      total.current += novos - dele;\n      setCliques(total.current);\n      onWind?.(total.current);\n    }\n    if (reduz) return;\n    lingueta.jump(0);\n    recuo.jump(-0.9);\n    recuo.set(0);\n    brilho.jump(1);\n    brilho.set(0);\n  });\n\n  const poke = useIdle(\n    caixa,\n    () => {\n      sozinho.current += 1;\n      curso.set(curso.get() + pitch);\n    },\n    2600,\n    idle,\n  );\n  const dar = (d: number) => {\n    if (d <= 0) return;\n    poke();\n    curso.set(curso.get() + d);\n  };\n\n  // O ângulo vem da caixa medida na tela, então vale igual dentro de um palco escalado.\n  const anguloDe = (e: React.PointerEvent<HTMLDivElement>) => {\n    const r = e.currentTarget.getBoundingClientRect();\n    return (Math.atan2(e.clientY - (r.top + r.height / 2), e.clientX - (r.left + r.width / 2)) * 180) / Math.PI;\n  };\n\n  return (\n    <div\n      ref={caixa}\n      className={cn(\"relative aspect-square w-[min(100%,22rem)] select-none [container-type:inline-size]\", className)}\n      {...rest}\n    >\n      {/* 73,3% da caixa = o raio da ponta (44) no viewBox de 120 da lingueta. */}\n      <div aria-hidden className=\"pointer-events-none absolute inset-[13.33%]\">\n        <span className=\"absolute inset-[7%] translate-y-[3%] rounded-full blur-md [background:color-mix(in_srgb,black_22%,transparent)]\" />\n        <motion.div style={{ rotate: giro, clipPath: forma }} className=\"absolute inset-0 overflow-hidden\">\n          <motion.div style={{ rotate: reflexo, background: TORNEADO }} className=\"absolute -inset-[22%]\" />\n          <span className=\"absolute inset-0\" style={{ background: RISCOS }} />\n        </motion.div>\n        {/* A chapa e o cubo são redondos: não precisam girar, e a luz neles fica de graça. */}\n        <span\n          className=\"absolute inset-[17%] rounded-full [box-shadow:inset_0_1px_2px_color-mix(in_srgb,black_45%,transparent),0_1px_0_color-mix(in_srgb,white_30%,transparent)]\"\n          style={{ background: `${RISCOS}, ${CHAPA}` }}\n        />\n        <motion.div style={{ rotate: giro }} className=\"absolute inset-0\">\n          {FUROS.map((g) => (\n            <span\n              key={g}\n              style={{ transform: `rotate(${g}deg) translateY(-15cqw)` }}\n              className=\"absolute left-1/2 top-1/2 -ml-[3cqw] -mt-[3cqw] size-[6cqw] rounded-full bg-background [box-shadow:inset_0_1px_2px_color-mix(in_srgb,black_55%,transparent)]\"\n            />\n          ))}\n        </motion.div>\n        <span\n          className=\"absolute inset-[39%] rounded-full [box-shadow:0_1px_3px_color-mix(in_srgb,black_45%,transparent)]\"\n          style={{ background: CUBO }}\n        />\n      </div>\n\n      <svg viewBox=\"-60 -60 120 120\" aria-hidden className=\"pointer-events-none absolute inset-0 size-full overflow-visible\">\n        <defs>\n          <linearGradient id=\"ratchet-lingueta\" x1=\"0\" y1=\"0\" x2=\"1\" y2=\"1\">\n            <stop offset=\"0\" style={{ stopColor: ACO(22) }} />\n            <stop offset=\"0.45\" style={{ stopColor: ACO(70) }} />\n            <stop offset=\"1\" style={{ stopColor: ACO(92) }} />\n          </linearGradient>\n        </defs>\n        <motion.g style={{ rotate: lingueta, originX: 1, originY: 0.29 }}>\n          <path d=\"M31,-50 C20,-49 8,-44 0,-36 C10,-38 22,-41 31,-42 Z\" fill=\"url(#ratchet-lingueta)\" className=\"stroke-foreground\" strokeWidth={0.5} strokeLinejoin=\"round\" />\n        </motion.g>\n        <motion.circle cx={1} cy={-37} r={7} style={{ opacity: brilho, fill: \"color-mix(in srgb, white 70%, transparent)\" }} className=\"blur-[2px]\" />\n        <circle cx={30} cy={-46} r={3.5} className=\"fill-[var(--brand)] stroke-foreground\" strokeWidth={1} />\n      </svg>\n\n      {/* A zona do gesto é a roda e só a roda: redonda, em cima de tudo. */}\n      <div\n        role=\"slider\"\n        tabIndex={0}\n        aria-label={label}\n        aria-valuemin={0}\n        aria-valuemax={Math.max(cliques, teeth)}\n        aria-valuenow={cliques}\n        aria-valuetext={`${cliques} ${cliques === 1 ? \"clique\" : \"cliques\"}`}\n        onPointerDown={(e) => {\n          e.currentTarget.setPointerCapture(e.pointerId);\n          preso.current = anguloDe(e);\n          poke();\n        }}\n        onPointerMove={(e) => {\n          if (preso.current === null) return;\n          const agora = anguloDe(e);\n          const d = ((((agora - preso.current + 540) % 360) + 360) % 360) - 180;\n          preso.current = agora;\n          dar((d / passo) * pitch);\n        }}\n        onPointerUp={() => (preso.current = null)}\n        onPointerCancel={() => (preso.current = null)}\n        onWheel={(e) => dar(e.deltaY)}\n        onKeyDown={(e) => {\n          const dentes = ({ ArrowUp: 1, ArrowRight: 1, PageUp: 4, ArrowDown: 0, ArrowLeft: 0, PageDown: 0 } as Record<string, number>)[e.key];\n          if (dentes === undefined) return;\n          e.preventDefault(); // voltar é não fazer nada, e a seta não pode cair na navegação da página\n          dar(dentes * pitch);\n        }}\n        className=\"absolute inset-[13.33%] cursor-grab touch-none rounded-full outline-none focus-visible:[box-shadow:var(--focus)] active:cursor-grabbing\"\n      />\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Um gesto de dar corda: contar passos para a frente, avançar sem poder voltar",
      "evite": "Ajustar um número nos dois sentidos: scrub-input; girar para os dois lados: vintage-knob"
    }
  },
  "categories": [
    "controles",
    "catraca",
    "engrenagem",
    "metal",
    "gesto",
    "clique"
  ],
  "type": "registry:ui"
}