{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "step-cards",
  "title": "Step Cards",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Como funciona, em passos numerados. Sai como lista ordenada no HTML, e a arte de cada passo entra por slot.",
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/blocks/step-cards/StepCards.tsx",
      "content": "import * as React from \"react\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * StepCards — \"como funciona\" em passos numerados, com o visual por slot.\n *\n * Duas referências viraram este bloco: os três cards de gradiente\n * (assinar/pedir/receber) e os quatro passos com mini-telas do produto dentro.\n * O que elas têm em comum e o que separa uma da outra:\n *\n * - **Comum:** número, título, uma frase, e uma área grande de visual em cima.\n * - **Diferente:** a arte. Numa é gradiente de marca, na outra é screenshot do\n *   app. Por isso `visual` é slot e o componente não desenha nada lá dentro —\n *   um bloco que embute a arte de um cliente só serve para aquele cliente.\n *\n * Decisões:\n *\n * 1. **É `<ol>`, não uma grade de `<div>`.** A ordem é a informação. Quem navega\n *    por leitor de tela ouve \"lista de 4 itens\" e sabe que existe uma sequência.\n * 2. **O número é `aria-hidden`.** O `<ol>` já numera; o \"01\" na tela é o eco\n *    visual disso, e anunciar os dois faz \"um, um, envie seu pedido\".\n * 3. **`columns` aceita o passo órfão.** Quatro passos em três colunas deixam um\n *    sozinho na segunda linha — a referência resolve deitando o último\n *    (`wideLast`), e é isso que a prop faz.\n *\n * ── 4. O passo em foco, e por que ele não é enfeite ────────────────────────\n *\n * Três cards idênticos numa fileira dizem \"existem três passos\" e param aí. O\n * que a peça precisa dizer é **onde você está** — numa página de \"como\n * funciona\" que acompanha a rolagem, num onboarding que marca o passo atual,\n * num carrossel que passa sozinho. Por isso existe `active`.\n *\n * O destaque é por **recuo dos outros**, não por brilho no escolhido: o ativo\n * fica inteiro e acende o fio de cima na cor da marca, e os demais perdem\n * opacidade. É a diferença entre a fileira ter um foco e a fileira ter um card\n * piscando.\n *\n * ── 5. Sem caixa em volta ──────────────────────────────────────────────────\n *\n * A versão anterior era card com borda, fundo, sombra, selo em pílula no\n * número e borda de marca no ativo: quatro molduras pra dizer \"passo\". Lia\n * como template. Agora o passo é a arte (com cantos e altura fixa, sem faixa\n * cinza sobrando embaixo), um fio de percurso e o texto. O fio é a única\n * moldura, e ele faz trabalho: liga os passos numa linha só e marca onde você\n * está.\n *\n * Duas guardas:\n * · **Sem `active`, nada muda.** Quem já usava o bloco recebe o mesmo pixel —\n *   inclusive o passo do meio, que não vira \"o ativo\" por acaso.\n * · **O ponteiro também promove.** Passar o mouse num passo recuado traz ele\n *   de volta, senão o recuo vira um card apagado que ninguém consegue ler.\n *   E `motion-reduce` corta a transição, não o estado: quem pediu menos\n *   movimento continua enxergando qual é o passo atual.\n */\n\nexport interface Step {\n  title: React.ReactNode;\n  description?: React.ReactNode;\n  /** A arte do passo: mockup, gradiente, ilustração. Vem do projeto. */\n  visual?: React.ReactNode;\n  /** Sobrescreve o número impresso. Útil quando o passo 0 existe. */\n  label?: string;\n}\n\nexport interface StepCardsProps extends React.HTMLAttributes<HTMLOListElement> {\n  steps: Step[];\n  columns?: 2 | 3 | 4;\n  /** O último passo ocupa a linha inteira quando sobrar sozinho. */\n  wideLast?: boolean;\n  /** Altura da área de visual. Abaixo de ~180px o mockup não se lê. */\n  visualHeight?: number;\n  /**\n   * Índice do passo em foco. Os outros recuam. Sem valor, todos iguais.\n   *\n   * Quem manda é quem consome: rolagem, timer de carrossel ou clique. O bloco\n   * não escolhe passo sozinho — passo atual é estado da página, não do card.\n   */\n  active?: number;\n}\n\nconst COLS: Record<2 | 3 | 4, string> = {\n  2: \"sm:grid-cols-2\",\n  3: \"sm:grid-cols-2 lg:grid-cols-3\",\n  4: \"sm:grid-cols-2 lg:grid-cols-4\",\n};\n\nexport function StepCards({\n  steps,\n  columns = 3,\n  wideLast = false,\n  visualHeight = 240,\n  active,\n  className,\n  ...props\n}: StepCardsProps) {\n  const orphan = wideLast && steps.length % columns === 1;\n  const marcado = typeof active === \"number\";\n\n  return (\n    <ol className={cn(\"grid grid-cols-1 gap-x-6 gap-y-10\", COLS[columns], className)} {...props}>\n      {steps.map((step, i) => {\n        const last = i === steps.length - 1;\n        const ativo = marcado && i === active;\n        const deitado = orphan && last;\n\n        return (\n          <li\n            key={i}\n            data-active={ativo ? \"\" : undefined}\n            className={cn(\n              \"flex flex-col gap-5\",\n              deitado && \"sm:col-span-full lg:flex-row lg:items-center lg:gap-8\",\n              // Sem `active` a fileira é a de sempre: nem transição, nem recuo.\n              marcado && [\n                \"transition-opacity [transition-duration:var(--dur-base,240ms)]\",\n                \"[transition-timing-function:var(--ease-out)]\",\n                \"motion-reduce:transition-none\",\n                // O ponteiro devolve o passo recuado: recuo é hierarquia, não\n                // porta trancada.\n                !ativo && \"opacity-50 hover:opacity-100\",\n              ],\n            )}\n          >\n            {step.visual ? (\n              <div\n                className={cn(\n                  \"relative isolate shrink-0 overflow-hidden rounded-[var(--r-surface,1rem)] bg-[var(--muted)]\",\n                  // Altura FIXA e a arte preenchendo: com `min-height` a foto de\n                  // proporção menor deixava uma faixa cinza embaixo do visual.\n                  \"[&>*]:size-full [&_img]:size-full [&_img]:object-cover [&_video]:size-full [&_video]:object-cover\",\n                  deitado && \"order-last lg:w-1/2\",\n                )}\n                style={{ height: visualHeight }}\n              >\n                {step.visual}\n              </div>\n            ) : null}\n\n            <div className={cn(\"flex flex-col gap-3\", deitado && \"lg:w-1/2\")}>\n              {/* O fio de percurso: liga os passos e acende no atual. */}\n              <span aria-hidden=\"true\" className=\"relative block h-px w-full bg-[var(--border)]\">\n                <span\n                  className={cn(\n                    \"absolute inset-x-0 top-1/2 h-0.5 -translate-y-1/2 origin-left bg-[var(--brand,var(--foreground))]\",\n                    \"transition-transform [transition-duration:var(--dur-slow,300ms)] [transition-timing-function:var(--ease-out)]\",\n                    \"motion-reduce:transition-none\",\n                    ativo ? \"scale-x-100\" : \"scale-x-0\",\n                  )}\n                />\n              </span>\n\n              <div className=\"flex items-baseline gap-3 pt-1\">\n                {/* O <ol> já numera para quem ouve; este é só o eco visual. */}\n                <span\n                  aria-hidden=\"true\"\n                  className=\"shrink-0 text-[13px] font-medium tabular-nums text-[var(--muted-foreground)]\"\n                >\n                  {step.label ?? String(i + 1).padStart(2, \"0\")}\n                </span>\n                <h3 className=\"text-balance [font-family:var(--font-display,inherit)] text-[1.1875rem] font-medium leading-[1.25] tracking-[-0.01em] text-[var(--foreground)]\">\n                  {step.title}\n                </h3>\n              </div>\n\n              {step.description ? (\n                <p className=\"max-w-[44ch] text-pretty text-[14px] leading-[1.6] text-[var(--muted-foreground)]\">\n                  {step.description}\n                </p>\n              ) : null}\n            </div>\n          </li>\n        );\n      })}\n    </ol>\n  );\n}\n",
      "type": "registry:component",
      "target": "~/components/step-cards/StepCards.tsx"
    },
    {
      "path": "registry/visant/blocks/step-cards/index.ts",
      "content": "export { StepCards } from \"./StepCards\";\nexport type { Step, StepCardsProps } from \"./StepCards\";\n",
      "type": "registry:component",
      "target": "~/components/step-cards/index.ts"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Seção de como funciona em passos numerados com arte por passo, em landing ou onboarding",
      "evite": "História longa ou changelog: timeline; passos com a arte presa no scroll, pinned-scene"
    }
  },
  "categories": [
    "conteudo",
    "passos",
    "como-funciona",
    "onboarding"
  ],
  "type": "registry:block"
}