{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "detent-slider",
  "title": "Detent Slider",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Slider com paradas que agarram e a consequência em letra grande, com dígitos que rolam antes de confirmar.",
  "dependencies": [
    "motion"
  ],
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/ui/detent-slider.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { motion, useReducedMotion, useSpring, useTransform } from \"motion/react\";\n\nimport { cn } from \"@/lib/utils\";\n\nexport interface DetentSliderProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onChange\" | \"defaultValue\"> {\n  /** Valor controlado, de 1 a 100. */\n  value?: number;\n  /**\n   * Onde a peça nasce quando é livre.\n   * @min 1\n   * @max 100\n   * @step 1\n   */\n  defaultValue?: number;\n  /** As paradas que puxam o polegar. */\n  stops?: number[];\n  /**\n   * A que distância uma parada agarra.\n   * @min 0\n   * @max 10\n   * @step 1\n   */\n  magnet?: number;\n  /** A consequência do valor, em letra grande. Os dígitos rolam. */\n  format?: (value: number) => string;\n  /** O nome do que o número grande mede, em uma linha acima dele. */\n  caption?: string;\n  /** O botão de confirmar. Sem ele, a peça é só o controle. */\n  action?: string | ((value: number) => string);\n  /** O que o botão diz por 2 segundos depois de confirmar, ou até o valor mudar. */\n  confirmedAction?: string | ((value: number) => string);\n  /** Nome do controle para leitor de tela. */\n  label?: string;\n  onValueChange?: (value: number) => void;\n  onAction?: (value: number) => void;\n}\n\nconst PARADAS = [25, 50, 75, 100];\nconst MOLA = { stiffness: 420, damping: 34 };\nconst limita = (v: number) => Math.max(1, Math.min(100, Math.round(v)));\n\n/** Um dígito é uma coluna de 0 a 9 que rola até o valor. */\nfunction Digito({ d, reduz }: { d: number; reduz: boolean | null }) {\n  const v = useSpring(d, { stiffness: 260, damping: 28 });\n  React.useEffect(() => {\n    if (reduz) v.jump(d);\n    else v.set(d);\n  }, [d, reduz, v]);\n  const y = useTransform(v, (n) => `${-n}em`);\n  return (\n    <span className=\"inline-block h-[1em] overflow-hidden\">\n      <motion.span style={{ y }} className=\"flex flex-col\">\n        {Array.from({ length: 10 }, (_, i) => (\n          <span key={i} className=\"h-[1em]\">\n            {i}\n          </span>\n        ))}\n      </motion.span>\n    </span>\n  );\n}\n\n/** Ancorado à direita: cada coluna fica no lugar enquanto o valor muda de tamanho. */\nfunction Rolante({ texto, reduz }: { texto: string; reduz: boolean | null }) {\n  return (\n    <span aria-hidden className=\"inline-flex flex-row-reverse leading-none tabular-nums\">\n      {[...texto].reverse().map((c, i) =>\n        /\\d/.test(c) ? (\n          <Digito key={`d${i}`} d={Number(c)} reduz={reduz} />\n        ) : (\n          <span key={`c${i}`} className=\"whitespace-pre\">\n            {c}\n          </span>\n        ),\n      )}\n    </span>\n  );\n}\n\n/**\n * Slider com paradas: mostra a consequência exata em letra grande, antes de confirmar. O\n * polegar agarra nas paradas com um pulso no ponto e uma vibração onde o aparelho deixa.\n *\n * - **O valor é sempre 1 a 100, e a consequência vem de fora.** O número grande sai de\n *   `format`, então a peça serve para fechar parte de uma posição, repartir uma conta ou\n *   dividir um orçamento, sem saber de nada disso.\n * - **Dígitos que rolam, não que trocam.** O olho acompanha a mudança, e a coluna fixa à\n *   direita evita que o número dance.\n * - **Sem cor própria.** A versão do laboratório tinha um brilho iridescente e verde e\n *   vermelho no resultado; caiu tudo. O sinal do número já diz se é ganho ou perda.\n * - **`pan-y`, e o dedo só mexe no valor depois de andar de lado.** Sem isso, o começo de\n *   uma rolagem em pé já arrastava o polegar. Toque parado também escolhe, ao soltar.\n * - **Confirmar responde.** O botão troca de texto e de preenchimento, e volta sozinho em\n *   2 segundos ou quando o valor muda.\n * - **Movimento reduzido:** o número e o polegar pousam, sem rolar e sem pulso.\n */\nexport function DetentSlider({\n  value,\n  defaultValue = 50,\n  stops = PARADAS,\n  magnet = 3,\n  format = (v) => `${v}%`,\n  caption,\n  action,\n  confirmedAction = \"Confirmado\",\n  label = \"Valor\",\n  onValueChange,\n  onAction,\n  className,\n  ...rest\n}: DetentSliderProps) {\n  const reduz = useReducedMotion();\n  const trilho = React.useRef<HTMLDivElement>(null);\n  const [interno, setInterno] = React.useState(defaultValue);\n  const [confirmado, setConfirmado] = React.useState(false);\n  const inicio = React.useRef<{ x: number; y: number; decidido: boolean } | null>(null);\n  const atual = limita(value ?? interno);\n  const polegar = useSpring(atual, MOLA);\n  const pulso = useSpring(1, { stiffness: 600, damping: 18 });\n  const preenchido = useTransform(polegar, (v) => v / 100);\n  const posicao = useTransform(polegar, (v) => `${v}%`);\n\n  React.useEffect(() => {\n    if (reduz) polegar.jump(atual);\n    else polegar.set(atual);\n  }, [atual, reduz, polegar]);\n\n  React.useEffect(() => setConfirmado(false), [atual]);\n  React.useEffect(() => {\n    if (!confirmado) return;\n    const t = window.setTimeout(() => setConfirmado(false), 2000);\n    return () => window.clearTimeout(t);\n  }, [confirmado]);\n\n  const definir = (proximo: number, agarra = false) => {\n    const alvo = agarra ? (stops.find((s) => Math.abs(s-proximo) <= magnet) ?? proximo) : proximo;\n    const v = limita(alvo);\n    if (v === atual) return;\n    if (stops.includes(v)) {\n      if (!reduz) {\n        pulso.jump(1.8);\n        pulso.set(1);\n      }\n      navigator.vibrate?.(8);\n    }\n    setInterno(v);\n    onValueChange?.(v);\n  };\n\n  const doX = (x: number) => {\n    const r = trilho.current!.getBoundingClientRect();\n    return ((x - r.left) / r.width) * 100;\n  };\n  const resultado = format(atual);\n  const rotulo = typeof action === \"function\" ? action(atual) : action;\n  const feito = typeof confirmedAction === \"function\" ? confirmedAction(atual) : confirmedAction;\n\n  return (\n    <div className={cn(\"flex w-full max-w-sm flex-col gap-5 text-foreground\", className)} {...rest}>\n      <div className=\"flex flex-col gap-2\">\n        {caption ? <span className=\"text-sm text-muted-foreground\">{caption}</span> : null}\n        <span className=\"text-[clamp(2.25rem,11vw,3.25rem)] font-medium tracking-[-0.02em] [font-family:var(--font-display,inherit)]\">\n          <Rolante texto={resultado} reduz={reduz} />\n          <span className=\"sr-only\">{resultado}</span>\n        </span>\n      </div>\n\n      <div\n        role=\"slider\"\n        tabIndex={0}\n        aria-label={label}\n        aria-valuemin={1}\n        aria-valuemax={100}\n        aria-valuenow={atual}\n        aria-valuetext={`${atual}%, ${resultado}`}\n        onPointerDown={(e) => {\n          e.currentTarget.setPointerCapture(e.pointerId);\n          const dedo = e.pointerType === \"touch\";\n          inicio.current = { x: e.clientX, y: e.clientY, decidido: !dedo };\n          if (!dedo) definir(doX(e.clientX), true);\n        }}\n        onPointerMove={(e) => {\n          const i = inicio.current;\n          if (!i) return;\n          if (!i.decidido) {\n            const dx = Math.abs(e.clientX - i.x);\n            if (dx < 6 || dx < Math.abs(e.clientY - i.y)) return;\n            i.decidido = true;\n          }\n          definir(doX(e.clientX), true);\n        }}\n        onPointerUp={(e) => {\n          if (inicio.current && !inicio.current.decidido) definir(doX(e.clientX), true);\n          inicio.current = null;\n        }}\n        onPointerCancel={() => (inicio.current = null)}\n        onKeyDown={(e) => {\n          const proxima = stops.find((s) => s > atual) ?? 100;\n          const anterior = [...stops].reverse().find((s) => s < atual) ?? 1;\n          const mapa: Record<string, number> = {\n            ArrowRight: atual + 1,\n            ArrowUp: atual + 1,\n            ArrowLeft: atual - 1,\n            ArrowDown: atual - 1,\n            PageUp: proxima,\n            PageDown: anterior,\n            Home: 1,\n            End: 100,\n          };\n          if (!(e.key in mapa)) return;\n          e.preventDefault();\n          definir(mapa[e.key]);\n        }}\n        className=\"relative h-12 cursor-grab touch-pan-y select-none overflow-hidden pointer-coarse:h-13 rounded-[var(--r-control,0.5rem)] outline-none focus-visible:[box-shadow:var(--focus)] active:cursor-grabbing\"\n      >\n        {/* `overflow-hidden` na caixa: a camada do polegar anda em `transform` e somaria largura à rolagem de quem contém a peça. */}\n        <div ref={trilho} className=\"absolute inset-x-3 top-1/2 h-1 -translate-y-1/2 rounded-full bg-border\">\n          <motion.div style={{ scaleX: preenchido }} className=\"absolute inset-0 origin-left rounded-full bg-foreground\" />\n          {stops.map((s) => (\n            <motion.span\n              key={s}\n              aria-hidden\n              style={{ left: `${s}%`, scale: s === atual ? pulso : 1, x: \"-50%\", y: \"-50%\" }}\n              className={cn(\"absolute top-1/2 size-1.5 rounded-full\", s <= atual ? \"bg-background\" : \"bg-muted-foreground\")}\n            />\n          ))}\n          <motion.div style={{ x: posicao }} className=\"pointer-events-none absolute inset-0\">\n            <span className=\"absolute left-0 top-1/2 size-6 -translate-x-1/2 -translate-y-1/2 rounded-full border-2 border-background bg-foreground [box-shadow:var(--e-raised,none)]\" />\n          </motion.div>\n        </div>\n      </div>\n\n      {rotulo ? (\n        <button\n          type=\"button\"\n          data-confirmado={confirmado || undefined}\n          onClick={() => {\n            setConfirmado(true);\n            onAction?.(atual);\n          }}\n          className=\"h-11 rounded-[var(--r-control,0.5rem)] border border-foreground bg-foreground px-4 text-sm font-medium text-background outline-none transition-[transform,background-color,color] [transition-duration:var(--dur-fast,150ms)] [transition-timing-function:var(--ease-out,ease-out)] focus-visible:[box-shadow:var(--focus)] active:scale-[0.98] data-[confirmado]:bg-transparent data-[confirmado]:text-foreground pointer-coarse:h-13\"\n        >\n          <span aria-live=\"polite\">{confirmado ? feito : rotulo}</span>\n        </button>\n      ) : null}\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Escolher quanto de algo, vendo o resultado antes de confirmar: fechar parte, dividir, repartir",
      "evite": "Simular um cenário com vários valores: sim-slider; ajustar sem consequência a mostrar: elastic-slider"
    }
  },
  "categories": [
    "controles",
    "slider",
    "paradas",
    "percentual",
    "formulario",
    "digitos"
  ],
  "type": "registry:ui"
}