{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "slosh-slider",
  "title": "Slosh Slider",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Um slider em que o preenchimento tem peso: arrastou rápido, a tinta passa do polegar, balança e assenta.",
  "dependencies": [
    "motion"
  ],
  "registryDependencies": [
    "utils",
    "@visant/sfx-bus"
  ],
  "files": [
    {
      "path": "registry/visant/ui/slosh-slider.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport {\n  motion,\n  useMotionTemplate,\n  useMotionValue,\n  useReducedMotion,\n  useSpring,\n  useTransform,\n  useVelocity,\n} from \"motion/react\";\n\nimport { playSfx } from \"@/lib/sfx-bus\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * Slosh Slider — o slider cujo preenchimento tem peso, como líquido num tubo.\n *\n * Um slider de volume, de intensidade, de \"quanto\" responde igual a qualquer\n * outro: o preenchimento cola no polegar e para seco. Aqui o polegar continua\n * exato (o valor é o que o dedo marcou), mas o preenchimento vem atrás com\n * inércia: arrastou rápido, ele passa do polegar, volta, e assenta. A borda\n * dele inclina conforme a velocidade, como a superfície de um líquido\n * chacoalhado. É controle de trabalho com um pouco de corpo, não brinquedo:\n * o número nunca mente, só a tinta balança.\n *\n * ── Decisões que não se veem de primeira ──────────────────────────────────\n *\n * 1. **Duas posições, uma verdade.** O polegar é o valor; o preenchimento é\n *    uma mola que PERSEGUE o polegar. Por isso o balanço não atrasa nem\n *    arredonda o valor, e o consumidor recebe `onValueChange` no ritmo do dedo.\n * 2. **Tudo em porcentagem, nada medido por quadro.** Posição e inclinação são\n *    motion values que viram um `clip-path` em `calc(% ± px)`. A única medida\n *    é o retângulo do trilho no evento de ponteiro, que é quando ele importa.\n * 3. **A inclinação vem da velocidade da mola, com teto.** Sem teto, um\n *    arremesso de ponta a ponta virava uma cunha atravessando o trilho.\n *    `tilt` é o desvio máximo da borda, em px, de cima até embaixo.\n * 4. **`viscosity` é o amortecimento.** Baixo, a tinta balança duas, três\n *    vezes; alto, assenta de uma vez, quase como slider comum.\n * 5. **O teclado também chacoalha.** Setas andam um `step`, Page anda dez,\n *    Home/End vão às pontas, e o pulo do polegar faz a tinta correr atrás.\n *\n * `prefers-reduced-motion`: a tinta cola no polegar, sem balanço e sem\n * inclinação.\n */\n\nexport interface SloshSliderProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onChange\" | \"defaultValue\"> {\n  /** Rótulo visível; também nomeia o polegar pra leitor de tela. */\n  label: string;\n  /** Valor controlado. Sem ele, o slider guarda o próprio estado. */\n  value?: number;\n  defaultValue?: number;\n  onValueChange?: (value: number) => void;\n  min?: number;\n  max?: number;\n  step?: number;\n  /** Amortecimento da tinta: baixo balança mais, alto assenta logo. */\n  viscosity?: number;\n  /** Inclinação máxima da borda da tinta, em px. 0 deixa a borda reta. */\n  tilt?: number;\n  /** Formata o número exibido ao lado do rótulo. */\n  format?: (value: number) => string;\n}\n\n/** Meia largura do polegar, em px: o recuo da pista em cada ponta. */\nconst RESPIRO = 12;\n/** Dentes do anel de foco no curso inteiro: um `focus` a cada dente cruzado no arrasto. */\nconst DENTES = 40;\nconst limitar = (v: number, a: number, b: number) => Math.min(b, Math.max(a, v));\nconst casas = (v: number) => (String(v).split(\".\")[1] ?? \"\").length;\n\nexport function SloshSlider({\n  label,\n  value: valueProp,\n  defaultValue = 50,\n  onValueChange,\n  min = 0,\n  max = 100,\n  step = 1,\n  viscosity = 9,\n  tilt = 14,\n  format,\n  className,\n  ...props\n}: SloshSliderProps) {\n  const reduzir = useReducedMotion();\n  const id = React.useId();\n  const trilho = React.useRef<HTMLDivElement>(null);\n  const [interno, setInterno] = React.useState(defaultValue);\n  const valor = limitar(valueProp ?? interno, min, max);\n  const pct = (v: number) => ((v - min) / (max - min || 1)) * 100;\n\n  // O polegar: a verdade, em %.\n  const polegar = useMotionValue(pct(valor));\n  // A tinta: persegue o polegar com massa. `restDelta` baixo pra não parar torta.\n  const tinta = useSpring(polegar, {\n    stiffness: 210,\n    damping: Math.max(2, viscosity),\n    mass: 1,\n    restDelta: 0.01,\n  });\n  const velocidade = useVelocity(tinta);\n  // %/s → px de desvio da borda, com teto. Sinal: a crista vai na frente.\n  const desvio = useTransform(velocidade, (v) =>\n    reduzir ? 0 : limitar(v * 0.06, -tilt, tilt),\n  );\n  const borda = useTransform(() => (reduzir ? polegar.get() : tinta.get()));\n  // A pista útil desconta meia largura de polegar em cada ponta: em 0 e em 100\n  // o polegar fica inteiro dentro do trilho, e a tinta acompanha a mesma régua.\n  const recorte = useMotionTemplate`polygon(0 0, calc(${RESPIRO}px + (100% - ${2 * RESPIRO}px) * ${borda} / 100 + ${desvio}px) 0, calc(${RESPIRO}px + (100% - ${2 * RESPIRO}px) * ${borda} / 100 - ${desvio}px) 100%, 0 100%)`;\n  const esquerda = useMotionTemplate`calc(${RESPIRO}px + (100% - ${2 * RESPIRO}px) * ${polegar} / 100)`;\n\n  React.useEffect(() => {\n    polegar.set(pct(valor));\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [valor, min, max]);\n\n  const definir = (cru: number) => {\n    const n = limitar(Math.round((cru - min) / step) * step + min, min, max);\n    const v = Number(n.toFixed(casas(step)));\n    if (v === valor) return;\n    if (valueProp === undefined) setInterno(v);\n    onValueChange?.(v);\n  };\n\n  const doPonteiro = (clientX: number) => {\n    const r = trilho.current?.getBoundingClientRect();\n    if (!r || r.width === 0) return;\n    const util = r.width - 2 * RESPIRO;\n    if (util <= 0) return;\n    const fracao = limitar((clientX - r.left - RESPIRO) / util, 0, 1);\n    // Som de anel de foco girando: só quando o arrasto cruza um dente novo.\n    const d = Math.round(fracao * DENTES);\n    if (dente.current !== null && d !== dente.current) playSfx(\"focus\");\n    dente.current = d;\n    definir(min + fracao * (max - min));\n  };\n\n  const arrastando = React.useRef(false);\n  const dente = React.useRef<number | null>(null);\n\n  const teclas = (e: React.KeyboardEvent) => {\n    const grande = step * 10;\n    const mapa: Record<string, number> = {\n      ArrowRight: valor + step,\n      ArrowUp: valor + step,\n      ArrowLeft: valor - step,\n      ArrowDown: valor - step,\n      PageUp: valor + grande,\n      PageDown: valor - grande,\n      Home: min,\n      End: max,\n    };\n    if (!(e.key in mapa)) return;\n    e.preventDefault();\n    definir(mapa[e.key]);\n  };\n\n  const texto = format ? format(valor) : String(valor);\n\n  return (\n    <div {...props} className={cn(\"flex w-full flex-col gap-2\", className)}>\n      <div className=\"flex items-baseline justify-between gap-3 text-sm\">\n        <span id={`${id}-rotulo`} className=\"font-medium text-foreground\">\n          {label}\n        </span>\n        <span className=\"tabular-nums text-muted-foreground\">{texto}</span>\n      </div>\n\n      <div\n        ref={trilho}\n        className=\"relative h-11 cursor-pointer touch-pan-y select-none overflow-hidden rounded-[var(--r-pill)] bg-muted\"\n        onPointerDown={(e) => {\n          if (e.button !== 0) return;\n          arrastando.current = true;\n          dente.current = null;\n          e.currentTarget.setPointerCapture(e.pointerId);\n          doPonteiro(e.clientX);\n          // O foco vai pro polegar, pra que as setas continuem de onde o dedo parou.\n          // `focusVisible: false`: foco vindo de ponteiro não acende o anel.\n          (e.currentTarget.querySelector('[role=\"slider\"]') as HTMLElement | null)?.focus({\n            preventScroll: true,\n            focusVisible: false,\n          } as FocusOptions);\n          e.preventDefault();\n        }}\n        onPointerMove={(e) => {\n          if (arrastando.current) doPonteiro(e.clientX);\n        }}\n        onPointerUp={() => {\n          arrastando.current = false;\n        }}\n        onPointerCancel={() => {\n          arrastando.current = false;\n        }}\n      >\n        <motion.div\n          aria-hidden\n          className=\"absolute inset-0 bg-[var(--brand)]\"\n          style={{ clipPath: recorte }}\n        />\n\n        <motion.div\n          role=\"slider\"\n          tabIndex={0}\n          aria-labelledby={`${id}-rotulo`}\n          aria-valuemin={min}\n          aria-valuemax={max}\n          aria-valuenow={valor}\n          aria-valuetext={texto}\n          aria-orientation=\"horizontal\"\n          onKeyDown={teclas}\n          // inset-y-1: o anel de foco (4px) cabe dentro do trilho, que recorta tudo o que passa da pílula.\n          className=\"absolute inset-y-1 grid w-6 -translate-x-1/2 place-items-center rounded-[var(--r-control)] outline-none focus-visible:[box-shadow:var(--focus)]\"\n          style={{ left: esquerda }}\n        >\n          <span className=\"h-5 w-1 rounded-[var(--r-pill)] bg-foreground\" />\n        </motion.div>\n      </div>\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Slider de volume ou intensidade em que o preenchimento tem peso e balança ao soltar",
      "evite": "Formulário neutro: elastic-slider; simulação com projeção, sim-slider; console de áudio, vintage-slider"
    }
  },
  "categories": [
    "controles",
    "slider",
    "range",
    "volume",
    "fisica",
    "spring",
    "teclado"
  ],
  "type": "registry:ui"
}