{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "magnify-dock",
  "title": "Magnify Dock",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "A barra de atalhos em que os ícones crescem em onda conforme o cursor chega perto, com o nome em cima do mais próximo.",
  "dependencies": [
    "motion"
  ],
  "registryDependencies": [
    "utils",
    "@visant/sfx-bus",
    "@visant/motion"
  ],
  "files": [
    {
      "path": "registry/visant/ui/magnify-dock.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport {\n  AnimatePresence,\n  motion,\n  useMotionValue,\n  useReducedMotion,\n  useSpring,\n  useTransform,\n  type MotionValue,\n} from \"motion/react\";\n\nimport { playSfx } from \"@/lib/sfx-bus\";\nimport { DUR, EASE_OUT } from \"@/lib/motion\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * Magnify Dock — a barra de atalhos que cresce em onda na direção do cursor.\n *\n * Uma fileira de ícones iguais pede que o olho leia todos pra achar um. A onda\n * resolve isso sem texto: o ícone mais perto do cursor incha mais, os vizinhos\n * um pouco, os de longe nada. O alvo cresce ANTES de chegar nele, e o rótulo\n * aparece em cima do que está sob o ponteiro.\n *\n * ── Decisões que não se veem de primeira ──────────────────────────────────\n *\n * 1. **A ampliação é função da distância, não estado de hover.** O ponteiro\n *    vira um motion value com o X dentro da barra; cada ícone deriva a própria\n *    escala da distância até o seu centro (curva de cosseno: cheia no centro,\n *    zero em `reach` ícones de distância) e passa por uma mola. Por isso a onda\n *    desliza com o cursor em vez de pular de ícone em ícone, e nada disso\n *    renderiza o React a cada quadro.\n * 2. **O centro de cada ícone vem do `offsetLeft` da casa dele, não do\n *    retângulo.** `getBoundingClientRect` inclui a escala que a própria onda\n *    aplica, e o ícone mediria um centro que muda conforme cresce. A casa (o\n *    wrapper sem transform) dá o lugar de repouso, que é o que a distância\n *    precisa.\n * 3. **Cresce no lugar, a partir da base.** A largura dos vãos não muda: a\n *    barra não sacode e o ícone sob o cursor não foge dele. A origem do\n *    transform é a base, então o ícone sobe como num dock de verdade, e `lift`\n *    soma um degrau de altura. Cada atalho é uma pastilha com borda: o ícone\n *    inchado passa da borda da barra como num dock, e é a pastilha que diz\n *    \"isso é um objeto que cresceu\", não um glifo solto atravessando a linha.\n * 4. **O teclado faz a mesma onda.** A barra é um `toolbar` com uma parada de\n *    Tab só; as setas andam entre os ícones, e o foco põe a onda no ícone\n *    focado, com o rótulo junto.\n *\n * `prefers-reduced-motion`: sem onda e sem degrau; o rótulo continua.\n */\n\nexport interface MagnifyDockItem {\n  id: string;\n  /** Nome do atalho: vai no rótulo flutuante e no `aria-label`. */\n  label: string;\n  /** Ícone (lucide-react ou do projeto). */\n  icon: React.ReactNode;\n}\n\nexport interface MagnifyDockProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"onSelect\"> {\n  items: MagnifyDockItem[];\n  /** Item marcado como atual (ganha o ponto embaixo). */\n  active?: string;\n  onSelect?: (id: string) => void;\n  /** Escala do ícone mais perto do cursor. 1 desliga a onda. */\n  magnify?: number;\n  /** Quanto o ícone mais perto sobe, em px. */\n  lift?: number;\n  /** Alcance da onda, em ícones de distância. */\n  reach?: number;\n  /** Lado do ícone em repouso, em px. */\n  size?: number;\n}\n\nconst FORA = Number.POSITIVE_INFINITY;\nconst MOLA = { stiffness: 420, damping: 30, mass: 0.6 };\n\nexport function MagnifyDock({\n  items,\n  active,\n  onSelect,\n  magnify = 1.4,\n  lift = 8,\n  reach = 2,\n  size = 40,\n  className,\n  ...props\n}: MagnifyDockProps) {\n  const reduzir = useReducedMotion();\n  const cursorX = useMotionValue(FORA);\n  const [rotulo, setRotulo] = React.useState<string | null>(null);\n  const [foco, setFoco] = React.useState(0);\n  const botoes = React.useRef<(HTMLButtonElement | null)[]>([]);\n\n  const gap = Math.round(size * 0.3);\n  // Distância em px onde a onda zera: `reach` passos de ícone + vão.\n  const alcance = Math.max(1, reach) * (size + gap);\n\n  /*\n   * O tic de detente a cada ícone que o ponteiro cruza: o dock vira um seletor\n   * de dentes, como um knob de volume. Portão de 45 ms porque passar o mouse\n   * rápido pela barra cruza seis ícones em um piscar, e seis tics colados viram\n   * zumbido. O barramento já tem portão próprio; este é o da peça.\n   */\n  const ultimoTic = React.useRef(0);\n  const tic = () => {\n    const agora = performance.now();\n    if (agora - ultimoTic.current < 45) return;\n    ultimoTic.current = agora;\n    playSfx(\"detent\");\n  };\n\n  const mirar = (i: number) => {\n    const casa = botoes.current[i]?.parentElement;\n    if (casa) cursorX.set(casa.offsetLeft + casa.offsetWidth / 2);\n  };\n\n  const andar = (e: React.KeyboardEvent) => {\n    const passo = { ArrowRight: 1, ArrowDown: 1, ArrowLeft: -1, ArrowUp: -1 }[e.key];\n    let alvo: number | null = null;\n    if (passo) alvo = (foco + passo + items.length) % items.length;\n    if (e.key === \"Home\") alvo = 0;\n    if (e.key === \"End\") alvo = items.length - 1;\n    if (alvo === null) return;\n    e.preventDefault();\n    setFoco(alvo);\n    botoes.current[alvo]?.focus();\n  };\n\n  return (\n    <div\n      role=\"toolbar\"\n      aria-orientation=\"horizontal\"\n      {...props}\n      className={cn(\n        \"relative flex items-end rounded-[var(--r-surface)] border border-border bg-card px-3 pb-3 pt-3 [box-shadow:var(--e-raised)]\",\n        className,\n      )}\n      style={{ gap, ...props.style }}\n      onPointerMove={(e) => {\n        props.onPointerMove?.(e);\n        if (e.pointerType !== \"mouse\") return;\n        cursorX.set(e.clientX - e.currentTarget.getBoundingClientRect().left);\n      }}\n      onPointerLeave={(e) => {\n        props.onPointerLeave?.(e);\n        cursorX.set(FORA);\n        setRotulo(null);\n      }}\n      onKeyDown={(e) => {\n        props.onKeyDown?.(e);\n        andar(e);\n      }}\n    >\n      {items.map((item, i) => (\n        <DockIcone\n          key={item.id}\n          item={item}\n          ref={(el) => {\n            botoes.current[i] = el;\n          }}\n          size={size}\n          cursorX={cursorX}\n          alcance={alcance}\n          magnify={reduzir ? 1 : magnify}\n          lift={reduzir ? 0 : lift}\n          ativo={item.id === active}\n          tabIndex={i === foco ? 0 : -1}\n          mostrarRotulo={rotulo === item.id}\n          onPointerEnter={() => {\n            setRotulo(item.id);\n            tic();\n          }}\n          onFocus={(e) => {\n            setFoco(i);\n            setRotulo(item.id);\n            // Só o foco de teclado move a onda; o de clique já tem o cursor.\n            if (e.currentTarget.matches(\":focus-visible\")) mirar(i);\n          }}\n          onBlur={() => {\n            setRotulo((r) => (r === item.id ? null : r));\n            cursorX.set(FORA);\n          }}\n          onClick={() => onSelect?.(item.id)}\n        />\n      ))}\n    </div>\n  );\n}\n\ninterface DockIconeProps\n  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, \"onDrag\" | \"onDragStart\" | \"onDragEnd\" | \"onAnimationStart\"> {\n  item: MagnifyDockItem;\n  size: number;\n  cursorX: MotionValue<number>;\n  alcance: number;\n  magnify: number;\n  lift: number;\n  ativo: boolean;\n  mostrarRotulo: boolean;\n}\n\nconst DockIcone = React.forwardRef<HTMLButtonElement, DockIconeProps>(function DockIcone(\n  { item, size, cursorX, alcance, magnify, lift, ativo, mostrarRotulo, ...props },\n  ref,\n) {\n  const proprio = React.useRef<HTMLButtonElement | null>(null);\n\n  // 0 longe, 1 em cima: a mesma proximidade alimenta escala e degrau.\n  const perto = useTransform(cursorX, (x) => {\n    // A casa do ícone (o wrapper), que não sofre transform e mede contra a barra.\n    const el = proprio.current?.parentElement;\n    if (!el || !Number.isFinite(x)) return 0;\n    const d = Math.abs(x - (el.offsetLeft + el.offsetWidth / 2));\n    return d >= alcance ? 0 : (Math.cos((Math.PI * d) / alcance) + 1) / 2;\n  });\n  const escala = useSpring(\n    useTransform(perto, (p) => 1 + (magnify - 1) * p),\n    MOLA,\n  );\n  const y = useSpring(\n    useTransform(perto, (p) => -lift * p),\n    MOLA,\n  );\n  // O rótulo acompanha o topo do ícone inchado, pra não ser engolido por ele.\n  const rotuloY = useTransform([y, escala], ([v, e]) => (v as number) - size * ((e as number) - 1));\n\n  return (\n    <div className=\"relative flex flex-col items-center\">\n      <AnimatePresence>\n        {mostrarRotulo && (\n          <motion.span\n            aria-hidden\n            className=\"pointer-events-none absolute bottom-full z-10 mb-3 whitespace-nowrap rounded-[var(--r-control)] bg-foreground px-2 py-1 text-xs font-medium text-background\"\n            style={{ y: rotuloY }}\n            initial={{ opacity: 0, scale: 0.92 }}\n            animate={{ opacity: 1, scale: 1 }}\n            exit={{ opacity: 0, scale: 0.96 }}\n            transition={{ duration: DUR.press, ease: EASE_OUT }}\n          >\n            {item.label}\n          </motion.span>\n        )}\n      </AnimatePresence>\n\n      <motion.button\n        {...props}\n        ref={(el) => {\n          proprio.current = el;\n          if (typeof ref === \"function\") ref(el);\n          else if (ref) ref.current = el;\n        }}\n        type=\"button\"\n        aria-label={item.label}\n        aria-current={ativo ? \"page\" : undefined}\n        className={cn(\n          // Sem caixa própria: o ícone mora direto na barra. Borda em cada botão\n          // dentro da borda da barra era moldura dentro de moldura, e a onda de\n          // ampliação lia como caixas se empurrando em vez de ícones crescendo.\n          \"relative grid place-items-center rounded-[var(--r-control)] outline-none focus-visible:[box-shadow:var(--focus)] pointer-coarse:after:absolute pointer-coarse:after:-inset-0.5\",\n          \"transition-colors duration-[var(--dur-fast)] ease-[var(--ease-out)] hover:bg-muted\",\n          \"[&_svg]:size-[50%] [&_svg]:shrink-0\",\n          ativo || mostrarRotulo ? \"text-foreground\" : \"text-muted-foreground\",\n        )}\n        style={{ width: size, height: size, scale: escala, y, originY: 1 }}\n      >\n        {item.icon}\n      </motion.button>\n\n      <span\n        aria-hidden\n        className={cn(\n          \"absolute -bottom-2 size-1 rounded-[var(--r-pill)] bg-foreground transition-opacity duration-[var(--dur-fast)] ease-[var(--ease-out)]\",\n          ativo ? \"opacity-100\" : \"opacity-0\",\n        )}\n      />\n    </div>\n  );\n});\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Barra de atalhos de ícones que amplia em onda, em portfólio ou app de criação no desktop",
      "evite": "Navegação principal de app: side-nav; mobile, nav-drawer; poucas ações num botão, orbit-menu"
    }
  },
  "categories": [
    "controles",
    "dock",
    "navegacao",
    "toolbar",
    "icones",
    "ampliacao",
    "spring"
  ],
  "type": "registry:ui"
}