{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ds-changelog",
  "title": "Changelog",
  "description": "Visualização estruturada de release notes com categorização semântica e timeline de versões.",
  "dependencies": [
    "date-fns",
    "lucide-react"
  ],
  "registryDependencies": [
    "@lema-ds/badge",
    "@lema-ds/skeleton",
    "@lema-ds/ui-i18n",
    "@lema-ds/ds-locale-provider",
    "@lema-ds/tokens"
  ],
  "files": [
    {
      "path": "components/ds/ds-changelog.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { format, type Locale } from \"date-fns\"\nimport { ptBR, enUS, es, fr } from \"date-fns/locale\"\nimport { Sparkles, Bug, Zap, AlertOctagon } from \"lucide-react\"\n\nimport { cn } from \"@/lib/utils\"\nimport { Badge } from \"@/components/ui/badge\"\nimport { Skeleton } from \"@/components/ui/skeleton\"\nimport { UI_I18N, type UILocale } from \"@/lib/ui-i18n\"\nimport { useUILocale } from \"@/components/ui/ds-locale-provider\"\n\nconst dateFnsLocales: Record<UILocale, Locale> = {\n  \"pt-BR\": ptBR,\n  \"en-US\": enUS,\n  \"es-ES\": es,\n  \"fr-FR\": fr,\n}\n\n// ── Types ──\n\nexport type ChangeType = \"feature\" | \"fix\" | \"improvement\" | \"breaking\"\n\nexport interface ChangelogEntry {\n  type: ChangeType\n  description: React.ReactNode\n}\n\nexport interface ChangelogRelease {\n  version: string\n  date: string | Date\n  title: string\n  isLatest?: boolean\n  changes: ChangelogEntry[]\n}\n\nexport interface ChangelogProps extends React.HTMLAttributes<HTMLDivElement> {\n  /**\n   * Release list in descending chronological order.\n   */\n  releases: ChangelogRelease[]\n  /**\n   * Loading state.\n   */\n  loading?: boolean\n  /**\n   * Localization setting.\n   */\n  locale?: UILocale\n}\n\n// ── Component ──\n\nexport const Changelog = React.forwardRef<HTMLDivElement, ChangelogProps>(\n  (\n    { releases, loading = false, locale: localeProp, className, ...props },\n    ref\n  ) => {\n    const locale = useUILocale(localeProp)\n    const t = UI_I18N[locale].changelog\n    const dfLocale = dateFnsLocales[locale]\n\n    const formatReleaseDate = (d: string | Date) => {\n      if (typeof d === \"string\") return d\n      return format(d, \"PP\", { locale: dfLocale })\n    }\n\n    if (loading) {\n      return (\n        <div\n          ref={ref}\n          className={cn(\"flex w-full flex-col gap-8\", className)}\n          {...props}\n        >\n          {[1, 2].map((i) => (\n            <div key={i} className=\"flex gap-4\">\n              <Skeleton className=\"size-8 shrink-0 rounded-full\" />\n              <div className=\"flex flex-1 flex-col gap-3\">\n                <Skeleton className=\"h-6 w-48\" />\n                <Skeleton className=\"h-4 w-96\" />\n                <Skeleton className=\"h-4 w-80\" />\n              </div>\n            </div>\n          ))}\n        </div>\n      )\n    }\n\n    const renderTypeBadge = (type: ChangeType) => {\n      switch (type) {\n        case \"feature\":\n          return (\n            <Badge\n              variant=\"outline\"\n              className=\"h-4 shrink-0 gap-1 border-primary/25 bg-primary/10 px-1.5 py-0 text-xs font-semibold text-primary uppercase\"\n            >\n              <Sparkles className=\"size-2.5\" />\n              {t.features}\n            </Badge>\n          )\n        case \"fix\":\n          return (\n            <Badge\n              variant=\"outline\"\n              className=\"h-4 shrink-0 gap-1 border-warning/30 bg-warning/10 px-1.5 py-0 text-xs font-semibold text-warning uppercase\"\n            >\n              <Bug className=\"size-2.5\" />\n              {t.fixes}\n            </Badge>\n          )\n        case \"improvement\":\n          return (\n            <Badge\n              variant=\"outline\"\n              className=\"h-4 shrink-0 gap-1 border-success/30 bg-success/10 px-1.5 py-0 text-xs font-semibold text-success uppercase\"\n            >\n              <Zap className=\"size-2.5\" />\n              {t.improvements}\n            </Badge>\n          )\n        case \"breaking\":\n          return (\n            <Badge\n              variant=\"destructive\"\n              className=\"h-4 shrink-0 gap-1 px-1.5 py-0 text-xs font-semibold uppercase\"\n            >\n              <AlertOctagon className=\"size-2.5\" />\n              {t.breaking}\n            </Badge>\n          )\n      }\n    }\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\"relative flex w-full flex-col\", className)}\n        {...props}\n      >\n        {releases.map((rel, relIdx) => {\n          const isLast = relIdx === releases.length - 1\n\n          return (\n            <div\n              key={rel.version}\n              className=\"relative flex gap-4 pb-8 last:pb-0\"\n            >\n              {/* Rail Line */}\n              {!isLast && (\n                <span\n                  className=\"absolute top-8 -bottom-0 left-4 w-px -translate-x-1/2 bg-border\"\n                  aria-hidden=\"true\"\n                />\n              )}\n\n              {/* Version Bullet */}\n              <div className=\"relative z-10 flex size-8 shrink-0 items-center justify-center rounded-full border border-border bg-card\">\n                <div\n                  className={cn(\n                    \"size-2.5 rounded-full\",\n                    rel.isLatest\n                      ? \"bg-primary motion-safe:animate-pulse\"\n                      : \"bg-muted-foreground/50\"\n                  )}\n                />\n              </div>\n\n              {/* Release Content */}\n              <div className=\"flex min-w-0 flex-1 flex-col gap-2 pt-0.5\">\n                <div className=\"flex flex-wrap items-center gap-2\">\n                  <span className=\"text-base font-bold text-foreground\">\n                    {rel.version}\n                  </span>\n                  {rel.isLatest && (\n                    <Badge variant=\"secondary\" className=\"h-5 text-xs\">\n                      {t.latest}\n                    </Badge>\n                  )}\n                  <time className=\"text-xs text-muted-foreground\">\n                    {formatReleaseDate(rel.date)}\n                  </time>\n                </div>\n\n                <h3 className=\"text-sm font-semibold text-foreground\">\n                  {rel.title}\n                </h3>\n\n                <ul className=\"m-0 flex list-none flex-col gap-2 p-0 pt-1\">\n                  {rel.changes.map((item, i) => (\n                    <li key={i} className=\"flex items-start gap-2 text-xs\">\n                      {renderTypeBadge(item.type)}\n                      <span className=\"flex-1 leading-relaxed text-foreground\">\n                        {item.description}\n                      </span>\n                    </li>\n                  ))}\n                </ul>\n              </div>\n            </div>\n          )\n        })}\n      </div>\n    )\n  }\n)\n\nChangelog.displayName = \"Changelog\"\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}
