{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "masonry-gallery",
  "title": "Masonry Gallery",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Mosaico por round-robin: anexar página nova não reordena o que já estava na tela.",
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/ui/masonry-gallery.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n\nexport interface MasonryBreakpoints {\n  /** < 640px */ base: number;\n  /** < 1024px */ sm: number;\n  /** < 1280px */ lg: number;\n  /** ≥ 1280px */ xl: number;\n}\n\nconst DEFAULT_BREAKPOINTS: MasonryBreakpoints = { base: 2, sm: 3, lg: 4, xl: 5 };\n\n/**\n * Contagem de colunas responsiva. Exportada porque o call site às vezes precisa\n * saber quantas colunas existem (ex.: pedir a próxima página em múltiplos dela).\n */\nexport function useMasonryColumns(\n  bp: MasonryBreakpoints = DEFAULT_BREAKPOINTS,\n): number {\n  const read = React.useCallback(() => {\n    if (typeof window === \"undefined\") return bp.lg;\n    const w = window.innerWidth;\n    if (w < 640) return bp.base;\n    if (w < 1024) return bp.sm;\n    if (w < 1280) return bp.lg;\n    return bp.xl;\n  }, [bp.base, bp.sm, bp.lg, bp.xl]);\n\n  const [cols, setCols] = React.useState(read);\n\n  React.useEffect(() => {\n    const onResize = () => setCols(read());\n    onResize();\n    window.addEventListener(\"resize\", onResize);\n    return () => window.removeEventListener(\"resize\", onResize);\n  }, [read]);\n\n  return cols;\n}\n\n/**\n * Masonry por round-robin (`i % cols`) — colunas de flex, não CSS `columns`.\n *\n * A escolha do round-robin é a coisa que importa aqui, e ela é contra-intuitiva:\n * a distribuição \"certa\" (sempre na coluna mais curta) exige medir as alturas, e\n * medir significa que ANEXAR uma página reordena o que já estava na tela. Num\n * feed infinito isso é o pior bug possível — o usuário perde o item que estava\n * olhando. Round-robin por índice é levemente menos equilibrado e perfeitamente\n * estável: item que entrou numa coluna nunca sai dela.\n *\n * Também é o motivo de não usar CSS `columns`: lá o navegador reflui a ordem\n * inteira e a leitura vira vertical-serpenteante, que quebra ordem cronológica.\n *\n * Não sabe o que renderiza: `renderItem` decide. Serve thumbnail, card, vídeo,\n * nó vivo — aspect ratios misturados são o caso normal, não a exceção.\n */\nexport function MasonryGallery<T>({\n  items,\n  renderItem,\n  getKey,\n  cols,\n  breakpoints,\n  gap = 12,\n  className,\n}: {\n  items: T[];\n  renderItem: (item: T, index: number) => React.ReactNode;\n  getKey: (item: T, index: number) => React.Key;\n  /**\n   * Colunas fixas. Omita para responsivo.\n   * @min 1\n   * @max 8\n   * @step 1\n   */\n  cols?: number;\n  breakpoints?: MasonryBreakpoints;\n  /**\n   * Espaço entre itens e colunas, em px.\n   * @min 0\n   * @max 40\n   * @step 2\n   */\n  gap?: number;\n  className?: string;\n}) {\n  const responsive = useMasonryColumns(breakpoints);\n  const n = Math.max(1, cols ?? responsive);\n\n  const columns = React.useMemo(() => {\n    const out: Array<Array<{ item: T; idx: number }>> = Array.from(\n      { length: n },\n      () => [],\n    );\n    items.forEach((item, idx) => out[idx % n].push({ item, idx }));\n    return out;\n  }, [items, n]);\n\n  return (\n    <div\n      className={cn(\"flex items-start\", className)}\n      style={{ gap }}\n      role=\"list\"\n    >\n      {columns.map((col, ci) => (\n        <div\n          key={ci}\n          className=\"flex min-w-0 flex-1 flex-col\"\n          style={{ gap }}\n        >\n          {col.map(({ item, idx }) => (\n            <div role=\"listitem\" key={getKey(item, idx)}>\n              {renderItem(item, idx)}\n            </div>\n          ))}\n        </div>\n      ))}\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Galeria de fotos de alturas diferentes com rolagem infinita, sem reordenar o que já carregou",
      "evite": "Abrir foto em tela cheia: photo-flip; trilho horizontal, rail; poucas capas em destaque, cover-flow"
    }
  },
  "categories": [
    "conteudo",
    "galeria",
    "grid"
  ],
  "type": "registry:ui"
}