{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "cover-art",
  "title": "Cover Art",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Capa determinística em CSS pra item sem arte: três famílias (livro, app, placa), monograma, e rampa tonal derivada da marca por color-mix. Zero byte de imagem, SSR igual ao cliente.",
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/lib/cover-look.ts",
      "content": "/**\n * A lógica determinística da capa gerada, fora do componente.\n *\n * Mora aqui e não no `.tsx` por dois motivos: dá pra **testar** (determinismo é\n * a única promessa que a capa faz — se ela mudar entre renders, quebra\n * hidratação e destrói o reconhecimento na prateleira), e o componente fica só\n * com a pintura.\n *\n * Nada de `Math.random`, nada de `Date`: só um hash da chave.\n */\n\nexport type CoverFamily = \"book\" | \"app\" | \"plate\";\n\n/**\n * djb2-ish. Estável entre Node e browser — é o que garante SSR == cliente.\n * Trocar por qualquer hash \"melhor\" é aceitável; trocar por um que dependa de\n * ordem de iteração de objeto ou de locale, não.\n */\nexport function hashKey(s: string): number {\n  let h = 5381;\n  for (let i = 0; i < s.length; i++) h = ((h << 5) + h + s.charCodeAt(i)) | 0;\n  return Math.abs(h);\n}\n\n/**\n * A rampa tonal.\n *\n * **Não são cores, são misturas.** O original trazia cinco pares de hex, e hex\n * num item de registry morre no primeiro cliente de outra marca. Aqui cada tom\n * é uma proporção entre `--card` e `--foreground`, então a rampa inteira nasce\n * da paleta de quem instalou.\n *\n * As diferenças são pequenas de propósito: numa prateleira real os livros\n * variam de tom sem virar arco-íris, e é essa variação sutil que faz um trilho\n * inteiro sem thumb não parecer defeito de carregamento.\n */\nexport const TONE_RAMP: ReadonlyArray<readonly [number, number]> = [\n  [14, 4],\n  [9, 2],\n  [18, 6],\n  [11, 3],\n  [16, 5],\n];\n\nexport const ANGLES = [135, 160, 115] as const;\n\n/**\n * Palavras que não identificam nada. Sem esta lista, \"A Imersão de Marca\" vira\n * \"ID\" (Imersão + de) — pego por teste, não na tela. Monograma existe pra a\n * pessoa reconhecer o item de relance; preposição não reconhece.\n *\n * A lista é pt-BR + en por padrão e entra por parâmetro quando o produto fala\n * outra língua: stopword é decisão de idioma, não de design.\n */\nexport const STOPWORDS_PT_EN = new Set([\n  \"a\", \"o\", \"as\", \"os\", \"de\", \"da\", \"do\", \"das\", \"dos\", \"e\", \"em\", \"no\", \"na\",\n  \"nos\", \"nas\", \"com\", \"por\", \"para\", \"pra\", \"ao\", \"aos\", \"um\", \"uma\",\n  \"the\", \"of\", \"in\", \"on\", \"at\", \"to\", \"for\", \"and\", \"an\",\n]);\n\n/** Duas letras pra identificar a peça na barra da janela. */\nexport function monogram(title: string, stopwords: Set<string> = STOPWORDS_PT_EN): string {\n  const palavras = title\n    .split(/\\s+/)\n    .filter((p) => /^\\p{L}/u.test(p) && p.length > 1 && !stopwords.has(p.toLowerCase()));\n  if (!palavras.length) {\n    // Título só de palavras funcionais ou de símbolos: cai no que houver de\n    // letra/dígito, e nunca devolve vazio (um monograma em branco lê como bug).\n    const cru = title.replace(/[^\\p{L}\\p{N}]/gu, \"\");\n    return (cru.slice(0, 2) || \"··\").toUpperCase();\n  }\n  if (palavras.length === 1) return palavras[0].slice(0, 2).toUpperCase();\n  return (palavras[0][0] + palavras[1][0]).toUpperCase();\n}\n\nexport type CoverLook = {\n  /** % de `--foreground` misturado no `--card` pro tom claro do gradiente. */\n  light: number;\n  /** idem, pro tom escuro. */\n  dark: number;\n  angle: number;\n  /** BOOK: título no topo em vez de na base. */\n  titleOnTop: boolean;\n  /** APP: painel lateral à esquerda. */\n  panelLeft: boolean;\n  /** APP: quantas linhas de conteúdo. */\n  lines: number;\n  /** Deslocamento das larguras de linha, pra duas janelas vizinhas não repetirem. */\n  spin: number;\n};\n\n/**\n * Toda a variação sai de UM hash, por deslocamento de bits — cada aspecto lê\n * uma fatia diferente do mesmo número, então nada precisa de segunda semente.\n */\nexport function coverLook(key: string): CoverLook {\n  const h = hashKey(key);\n  const [light, dark] = TONE_RAMP[h % TONE_RAMP.length];\n  return {\n    light,\n    dark,\n    angle: ANGLES[(h >> 6) % ANGLES.length],\n    titleOnTop: (h >> 3) % 3 === 2,\n    panelLeft: ((h >> 3) & 1) === 0,\n    lines: 3 + ((h >> 4) % 2),\n    spin: h >> 5,\n  };\n}\n\n/** `mix(14)` → um tom 14% mais próximo do `--foreground` que o `--card`. */\nexport const mix = (pct: number) =>\n  `color-mix(in oklch, var(--foreground) ${pct}%, var(--card))`;\n",
      "type": "registry:lib"
    },
    {
      "path": "registry/visant/ui/cover-art.tsx",
      "content": "import * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n/*\n * O lib se chama `cover-look`, e não `cover-art`, de propósito.\n *\n * O item entrega dois arquivos, e enquanto os dois tiveram o MESMO nome de base\n * o shadcn reescreveu o import errado na instalação: `@/lib/cover-art` virava\n * `@/components/ui/cover-art`, o arquivo passava a importar de si mesmo e o\n * projeto do cliente quebrava com \"Circular definition of import alias\". No\n * repo de origem isso não aparece — só o teste de instalação limpa pega.\n *\n * Regra que vale pra qualquer item de vários arquivos: dois arquivos do mesmo\n * item nunca compartilham nome de base.\n */\nimport { coverLook, mix, monogram, type CoverFamily, type CoverLook } from \"@/lib/cover-look\";\n\n/**\n * Cover Art — a capa determinística que substitui a caixa cinza.\n *\n * ── O problema, e por que ele é caro ───────────────────────────────────────\n *\n * Todo catálogo tem itens sem arte. As três saídas de sempre são ruins: caixa\n * cinza (o card lê como carregamento que travou), imagem de stock (o catálogo\n * inteiro fica com a mesma cara), ou geração por IA (custa dinheiro por item,\n * demora, e muda entre execuções). Esta é a quarta: **uma capa desenhada em\n * CSS a partir do próprio item**, sempre a mesma pro mesmo item, em qualquer\n * render. Nenhum byte de imagem, nenhum arquivo em bucket, nenhuma chamada.\n *\n * ── Três famílias, porque e-book e ferramenta não são a mesma coisa ────────\n *\n * | família | desenho | quando |\n * |---|---|---|\n * | `book` | lombada à esquerda + título grande | o card É a capa de frente |\n * | `app` | wireframe de janela com monograma | lê como software |\n * | `plate` | tonal + título | o genérico honesto |\n *\n * O wireframe é wireframe **de propósito**: desenhar uma UI \"realista\" ali\n * competiria com a UI real em volta.\n *\n * ── As três armadilhas que já custaram tela ────────────────────────────────\n *\n * 1. **A chave não é o título.** Use o slug. Título editado no admin mudaria a\n *    capa embaixo do usuário, e capa que muda sozinha destrói o reconhecimento\n *    na prateleira — que é a única coisa que a capa gerada tem a oferecer.\n * 2. **O traço de dentro da janela é relativo, não um token de borda.** Com\n *    `--border` fixo, uma peça apareceu com a janela vazia porque o tom sorteado\n *    tinha praticamente a cor da linha. Alpha sobre a peça resolve em qualquer\n *    tom.\n * 3. **`titleless` existe pra peça grande.** Num billboard o `<h1>` já é o\n *    título; repeti-lo dentro da arte cria dois títulos brigando.\n *\n * Zero hex: a rampa tonal é `color-mix` entre `--card` e `--foreground`, então\n * a capa nasce da paleta de quem instalou e o tema escuro sai de graça.\n *\n * ── 4. A capa se mede pela CAIXA que a recebe ──────────────────────────────\n *\n * O desenho era todo em px fixo: título de 22px, 40px de folga no topo, janela\n * com 20px de recuo, linha de 7px. Só que esta peça é um slot — a mesma capa\n * entra num card de 90px na grade e num herói de 600px. Numa caixa de 150×112 o\n * título de 22px em quatro linhas pedia 100px depois de 40px de folga: sobrava\n * pela borda e o `overflow-hidden` cortava a palavra no meio (\"Marca em 9 eta\").\n * Era esse o \"estourado\".\n *\n * Agora a raiz é um container de tamanho (`container-type: size`) e cada medida\n * sai de `cqmin` — 1% do MENOR lado da caixa — presa entre um piso e um teto. É\n * o único jeito de a mesma arte funcionar em 90px e em 600px sem prop de\n * tamanho, sem media query e sem medir nada em JS.\n */\n\nconst TRACO = \"color-mix(in oklch, var(--foreground) 18%, transparent)\";\nconst BORDA_JANELA = \"color-mix(in oklch, var(--foreground) 12%, transparent)\";\nconst LARGURAS = [\"72%\", \"54%\", \"84%\", \"46%\"];\n\n/** Realce no topo e sombra interna à direita e embaixo: faz a superfície ler\n *  como objeto, não como retângulo pintado. */\nfunction Espessura() {\n  return (\n    <div\n      className=\"absolute inset-0\"\n      aria-hidden=\"true\"\n      style={{\n        boxShadow:\n          \"inset 0 1px 0 color-mix(in oklch, var(--foreground) 6%, transparent), inset -16px 0 26px -20px color-mix(in oklch, var(--background) 90%, black), inset 0 -18px 28px -22px color-mix(in oklch, var(--background) 90%, black)\",\n      }}\n    />\n  );\n}\n\n/**\n * As medidas da capa, todas em função do menor lado da caixa.\n *\n * Ficam num objeto e não espalhadas pelo JSX porque as três famílias precisam\n * combinar entre si na mesma prateleira: mudar o piso do título num lugar só é\n * como o desenho perde o conjunto.\n */\nconst M = {\n  /** Respiro geral. */\n  pad: \"clamp(0.625rem,6cqmin,1.25rem)\",\n  /** Folga de topo do livro: o canto é território da etiqueta de formato. */\n  padTopo: \"clamp(1rem,15cqmin,2.5rem)\",\n  gap: \"clamp(0.25rem,3.5cqmin,0.75rem)\",\n  regua: \"clamp(1rem,10cqmin,2.25rem)\",\n  tituloLivro: \"clamp(0.6875rem,12.5cqmin,1.375rem)\",\n  tituloPlaca: \"clamp(0.625rem,11cqmin,1.25rem)\",\n} as const;\n\nfunction Regua() {\n  return <span className=\"block h-px bg-border\" style={{ width: M.regua }} />;\n}\n\nfunction Book({ title, look, titleless }: { title: string; look: CoverLook; titleless?: boolean }) {\n  return (\n    <div\n      className=\"absolute inset-0 overflow-hidden\"\n      style={{ background: `linear-gradient(${look.angle}deg, ${mix(look.light)}, ${mix(look.dark)})` }}\n    >\n      <Espessura />\n      {/* `pt-10` na composição de topo: quem embrulha esta capa costuma desenhar\n          uma etiqueta de formato no canto superior esquerdo, e sem essa folga o\n          título sai POR CIMA dela. O canto é território do card, não da capa. */}\n      {!titleless && (\n        <div\n          className={cn(\n            \"relative flex h-full flex-col\",\n            look.titleOnTop ? \"justify-start\" : \"justify-end\",\n          )}\n          style={{\n            gap: M.gap,\n            padding: M.pad,\n            // A lombada desenhada mora à esquerda: o texto começa depois dela.\n            paddingLeft: `calc(${M.pad} * 1.4)`,\n            paddingTop: look.titleOnTop ? M.padTopo : M.pad,\n          }}\n        >\n          <Regua />\n          {/* Três linhas, não quatro: em caixa pequena a quarta linha era o que\n              transbordava, e capa de catálogo não é lugar de ler o título todo —\n              é lugar de reconhecer o item. */}\n          <span\n            className=\"line-clamp-3 font-extrabold leading-[1.06] tracking-tight\"\n            style={{ fontSize: M.tituloLivro }}\n          >\n            {title}\n          </span>\n        </div>\n      )}\n    </div>\n  );\n}\n\nfunction App({ title, look }: { title: string; look: CoverLook }) {\n  return (\n    <div\n      className=\"absolute inset-0 overflow-hidden\"\n      style={{\n        background: `linear-gradient(${look.angle}deg, ${mix(look.dark)}, var(--background))`,\n      }}\n    >\n      <Espessura />\n      <div\n        className=\"absolute flex flex-col overflow-hidden rounded-[var(--r-control)]\"\n        style={{\n          inset: M.pad,\n          border: `1px solid ${BORDA_JANELA}`,\n          background: mix(look.light),\n        }}\n      >\n        {/* A barra de topo com o monograma é o que dá identidade a cada uma. */}\n        <div\n          className=\"flex shrink-0 items-center\"\n          style={{\n            height: \"clamp(0.875rem,13cqmin,2rem)\",\n            gap: M.gap,\n            paddingInline: `calc(${M.pad} * 0.7)`,\n            borderBottom: `1px solid ${BORDA_JANELA}`,\n            background: \"color-mix(in oklch, var(--foreground) 4%, transparent)\",\n          }}\n        >\n          <span\n            className=\"font-bold tracking-[0.08em] text-foreground\"\n            style={{ fontSize: \"clamp(0.4375rem,5cqmin,0.6875rem)\" }}\n          >\n            {monogram(title)}\n          </span>\n          <span className=\"ml-auto flex gap-1\" aria-hidden=\"true\">\n            <i className=\"block size-1 rounded-full\" style={{ background: TRACO }} />\n            <i className=\"block size-1 rounded-full\" style={{ background: TRACO }} />\n          </span>\n        </div>\n\n        <div className={cn(\"flex min-h-0 flex-1\", !look.panelLeft && \"flex-row-reverse\")}>\n          <div\n            className=\"w-[26%] shrink-0\"\n            style={{\n              [look.panelLeft ? \"borderRight\" : \"borderLeft\"]: `1px solid ${BORDA_JANELA}`,\n              background: \"color-mix(in oklch, var(--background) 22%, transparent)\",\n            }}\n          />\n          <div\n            className=\"flex min-w-0 flex-1 flex-col justify-center\"\n            style={{ gap: M.gap, paddingInline: `calc(${M.pad} * 0.7)` }}\n          >\n            {Array.from({ length: look.lines }).map((_, i) => (\n              <span\n                key={i}\n                className=\"block rounded-full\"\n                style={{\n                  height: \"clamp(2px,3.5cqmin,7px)\",\n                  width: LARGURAS[(i + look.spin) % LARGURAS.length],\n                  background: TRACO,\n                }}\n              />\n            ))}\n          </div>\n        </div>\n      </div>\n    </div>\n  );\n}\n\nfunction Plate({ title, look, titleless }: { title: string; look: CoverLook; titleless?: boolean }) {\n  return (\n    <div\n      className=\"absolute inset-0 overflow-hidden\"\n      style={{ background: `linear-gradient(${look.angle}deg, ${mix(look.light)}, ${mix(look.dark)})` }}\n    >\n      <Espessura />\n      {!titleless && (\n        <div\n          className=\"relative flex h-full flex-col justify-end\"\n          style={{ gap: M.gap, padding: M.pad }}\n        >\n          <Regua />\n          <span\n            className=\"line-clamp-3 font-bold uppercase leading-[1.1] tracking-tight\"\n            style={{ fontSize: M.tituloPlaca }}\n          >\n            {title}\n          </span>\n        </div>\n      )}\n    </div>\n  );\n}\n\nexport interface CoverArtProps {\n  title: string;\n  /** Chave ESTÁVEL: slug > id > título. Ver a armadilha 1 acima. */\n  seed: string;\n  family?: CoverFamily;\n  /** Fundo de peça grande: mesma linguagem, sem o título. */\n  titleless?: boolean;\n  className?: string;\n}\n\nexport function CoverArt({\n  title,\n  seed,\n  family = \"plate\",\n  titleless = false,\n  className,\n}: CoverArtProps) {\n  const look = coverLook(seed);\n  return (\n    // `container-type: size` e não `inline-size`: as medidas usam `cqmin`, que\n    // precisa dos DOIS lados da caixa. É seguro aqui porque a raiz é\n    // `absolute inset-0` — o tamanho vem do slot, nunca do conteúdo.\n    <div\n      className={cn(\"absolute inset-0 [container-type:size]\", className)}\n      aria-hidden=\"true\"\n    >\n      {family === \"book\" ? (\n        <Book title={title} look={look} titleless={titleless} />\n      ) : family === \"app\" ? (\n        // O wireframe já não tem título, então serve de fundo como está.\n        <App title={title} look={look} />\n      ) : (\n        <Plate title={title} look={look} titleless={titleless} />\n      )}\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Gerar capa de livro, app ou placa para item sem imagem, a partir do nome e da cor da marca",
      "evite": "Item com foto real: plate ou photo-frame; imagem ainda carregando, skeleton-rail"
    }
  },
  "categories": [
    "conteudo",
    "capa",
    "placeholder",
    "catalogo",
    "deterministico",
    "sem-imagem"
  ],
  "type": "registry:ui"
}