{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "dynamic-island",
  "title": "Dynamic Island",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "A pílula que mostra a atividade em curso e cresce no lugar com os controles quando alguém toca nela.",
  "dependencies": [
    "motion"
  ],
  "registryDependencies": [
    "utils",
    "@visant/motion"
  ],
  "files": [
    {
      "path": "registry/visant/ui/dynamic-island.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { AnimatePresence, animate, motion, useMotionValue, useReducedMotion } from \"motion/react\";\n\nimport { DUR, EASE_OUT, INSTANT } from \"@/lib/motion\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * Dynamic Island — a pílula que guarda uma atividade em andamento e abre quando\n * alguém quer mexer nela.\n *\n * O problema que ela resolve é de espaço: uma chamada, um timer, uma música\n * tocando são coisas que o usuário quer VER o tempo todo e CONTROLAR de vez em\n * quando. Um card fixo rouba a tela; um toast some. A ilha fica pequena,\n * mostra o essencial (ícone e um número), e cresce no lugar quando tocada,\n * trazendo os controles junto. Tocar de novo devolve.\n *\n * ── Decisões que não se veem de primeira ──────────────────────────────────\n *\n * 1. **A casca anima largura e altura medidas, não `layout`.** A animação de\n *    layout do motion escala o elemento e corrige depois; numa pílula isso\n *    entorta o raio e espreme o texto no meio da viagem. Aqui o conteúdo é\n *    medido por um ResizeObserver e a casca vai até aquela caixa com mola, e\n *    o raio é CSS puro o caminho inteiro.\n * 2. **O conteúdo troca em cruz, a casca não pisca.** Mudar de atividade\n *    (`activityKey`) ou de tamanho troca o miolo com esmaecer curto, enquanto a\n *    mesma casca morfa de uma forma para outra. Quem olha vê UMA coisa mudando\n *    de forma, não duas trocando de lugar. O miolo é CENTRADO na casca (que\n *    cresce para os dois lados) e entra com um respiro de 90 ms: assim a casca\n *    abre caminho antes e nada aparece cortado só na borda direita.\n * 3. **O toque de recolher é um botão de verdade por trás do miolo.** O miolo\n *    aberto tem os próprios botões (pausar, desligar), e botão dentro de botão\n *    não existe em HTML. Então a área inteira é um `<button>` em camada de\n *    baixo, e o miolo por cima só aceita ponteiro nos controles dele: clique\n *    no vazio cai no botão de recolher, clique no \"pausar\" fica no pausar.\n *    No teclado, Esc também recolhe.\n * 4. **A mola tem duração visual fixa e só o `bounce` muda.** Quem ajusta a\n *    peça quer mais ou menos vida, não mais ou menos tempo; o tempo fica no\n *    teto de 300 ms da casa, que é resposta a gesto.\n *\n * `prefers-reduced-motion`: a ilha vai direto para o tamanho final e o miolo\n * troca sem viagem.\n */\n\n/** O conteúdo que sai vai seco, sem disputar a atenção com a ilha mudando de forma. */\nconst SAIDA_SECA = [0.4, 0, 1, 1] as const;\n\nexport interface DynamicIslandProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, \"children\"> {\n  /** Nome da atividade, lido pelo leitor de tela (“Timer, 4:56”). */\n  label: string;\n  /** Chave da atividade. Trocar a chave morfa a ilha para a nova forma. */\n  activityKey?: string;\n  /** O miolo recolhido: ícone e um dado curto. */\n  compact: React.ReactNode;\n  /** O miolo aberto, com os controles da atividade. */\n  children: React.ReactNode;\n  /** Aberta ou recolhida, controlado. */\n  expanded?: boolean;\n  defaultExpanded?: boolean;\n  onExpandedChange?: (expanded: boolean) => void;\n  /** Vida da mola, de 0 (seca) a 0,6 (saltitante). */\n  bounce?: number;\n}\n\nexport function DynamicIsland({\n  label,\n  activityKey = \"atividade\",\n  compact,\n  children,\n  expanded: expandedProp,\n  defaultExpanded = false,\n  onExpandedChange,\n  bounce = 0.3,\n  className,\n  onKeyDown,\n  ...props\n}: DynamicIslandProps) {\n  const reduzir = useReducedMotion();\n  const [interno, setInterno] = React.useState(defaultExpanded);\n  const aberta = expandedProp ?? interno;\n\n  const definir = React.useCallback(\n    (v: boolean) => {\n      if (expandedProp === undefined) setInterno(v);\n      onExpandedChange?.(v);\n    },\n    [expandedProp, onExpandedChange],\n  );\n\n  const mola = reduzir\n    ? INSTANT\n    : { type: \"spring\" as const, visualDuration: 0.28, bounce: Math.min(0.6, Math.max(0, bounce)) };\n  const molaRef = React.useRef(mola);\n  molaRef.current = mola;\n\n  // A caixa da casca, em px. \"auto\" até a primeira medida, então o HTML de\n  // servidor já sai do tamanho do miolo. A primeira medida CRAVA o valor sem\n  // animar: é ela que dá à casca uma largura própria, de onde a próxima troca\n  // parte. Sem cravar, a casca seguiria em `auto`, cresceria junto com o miolo\n  // novo no mesmo quadro, e a mola não teria distância nenhuma pra percorrer.\n  const largura = useMotionValue<number | string>(\"auto\");\n  const altura = useMotionValue<number | string>(\"auto\");\n  const medida = React.useRef(false);\n  const miolo = React.useRef<HTMLDivElement>(null);\n\n  React.useLayoutEffect(() => {\n    const el = miolo.current;\n    if (!el) return;\n    const medir = () => {\n      const w = el.offsetWidth;\n      const h = el.offsetHeight;\n      if (!medida.current) {\n        largura.set(w);\n        altura.set(h);\n        medida.current = true;\n        return;\n      }\n      animate(largura, w, molaRef.current);\n      animate(altura, h, molaRef.current);\n    };\n    medir();\n    const ro = new ResizeObserver(medir);\n    ro.observe(el);\n    return () => ro.disconnect();\n  }, [aberta, activityKey, largura, altura]);\n\n  const chave = `${activityKey}:${aberta ? \"aberta\" : \"recolhida\"}`;\n\n  return (\n    <motion.div\n      {...(props as React.ComponentProps<typeof motion.div>)}\n      className={cn(\n        \"relative isolate flex items-center justify-center overflow-hidden rounded-[var(--r-pill)] bg-foreground text-background [box-shadow:var(--e-raised)]\",\n        className,\n      )}\n      style={{ ...(props.style as object), width: largura, height: altura }}\n      onKeyDown={(e: React.KeyboardEvent<HTMLDivElement>) => {\n        onKeyDown?.(e);\n        if (e.key === \"Escape\" && aberta) {\n          e.stopPropagation();\n          definir(false);\n        }\n      }}\n    >\n      {/* O alvo de abrir/recolher, sempre por baixo do miolo. */}\n      <button\n        type=\"button\"\n        aria-expanded={aberta}\n        aria-label={aberta ? `Recolher ${label}` : `Abrir ${label}`}\n        onClick={() => definir(!aberta)}\n        className=\"absolute inset-0 z-0 cursor-pointer rounded-[inherit] outline-none focus-visible:[box-shadow:var(--focus)]\"\n      />\n\n      <AnimatePresence initial={false} mode=\"popLayout\">\n        <motion.div\n          key={chave}\n          aria-hidden={!aberta}\n          className={cn(\n            \"pointer-events-none relative z-10 w-max\",\n            // Só os controles do miolo aberto capturam ponteiro.\n            aberta && \"[&_a]:pointer-events-auto [&_button]:pointer-events-auto\",\n          )}\n          initial={reduzir ? { opacity: 0 } : { opacity: 0, scale: 0.94, filter: \"blur(4px)\" }}\n          animate={{ opacity: 1, scale: 1, filter: \"blur(0px)\" }}\n          exit={\n            reduzir\n              ? { opacity: 0, transition: INSTANT }\n              : { opacity: 0, scale: 0.96, filter: \"blur(4px)\", transition: { duration: DUR.press, ease: SAIDA_SECA } }\n          }\n          transition={reduzir ? INSTANT : { duration: DUR.fast, delay: 0.09, ease: EASE_OUT }}\n        >\n          {/*\n            A medida mora num `div` de dentro, não no `motion.div`: em\n            `popLayout` o AnimatePresence lê `children.props.ref`, e no React 18\n            isso dispara \"`ref` is not a prop\" a cada troca de atividade.\n          */}\n          <div ref={miolo} className=\"w-max\">\n            {aberta ? children : compact}\n          </div>\n        </motion.div>\n      </AnimatePresence>\n    </motion.div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Pílula de atividade em curso, como timer, player ou chamada, que cresce com controles ao tocar",
      "evite": "Aviso que some sozinho: toast-stack; espera de IA com etapas, status-ticker"
    }
  },
  "categories": [
    "feedback",
    "pilula",
    "atividade",
    "morph",
    "spring",
    "timer",
    "player",
    "chamada"
  ],
  "type": "registry:ui"
}