@softize/opus 8.6.6

package/src/ui/components/primitives/switch.tsx

@@ -0,0 +1,33 @@
+import * as React from "react"
+import { Switch as SwitchPrimitive } from "radix-ui"
+
+import { cn } from '../../lib/cn.ts'
+
+function Switch({
+  className,
+  size = "default",
+  ...props
+}: React.ComponentProps<typeof SwitchPrimitive.Root> & {
+  size?: "sm" | "default"
+}) {
+  return (
+    <SwitchPrimitive.Root
+      data-slot="switch"
+      data-size={size}
+      className={cn(
+        "peer group/switch inline-flex shrink-0 items-center rounded-full border border-transparent transition-all outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 data-[size=default]:h-[1.15rem] data-[size=default]:w-8 data-[size=sm]:h-3.5 data-[size=sm]:w-6 data-[state=checked]:bg-primary data-[state=unchecked]:bg-input dark:data-[state=unchecked]:bg-input/80",
+        className
+      )}
+      {...props}
+    >
+      <SwitchPrimitive.Thumb
+        data-slot="switch-thumb"
+        className={cn(
+          "pointer-events-none block rounded-full bg-background ring-0 transition-transform group-data-[size=default]/switch:size-4 group-data-[size=sm]/switch:size-3 data-[state=checked]:translate-x-[calc(100%-2px)] data-[state=unchecked]:translate-x-0 dark:data-[state=checked]:bg-primary-foreground dark:data-[state=unchecked]:bg-foreground"
+        )}
+      />
+    </SwitchPrimitive.Root>
+  )
+}
+
+export { Switch }

package/src/ui/components/primitives/table.tsx

@@ -0,0 +1,114 @@
+import * as React from "react"
+
+import { cn } from '../../lib/cn.ts'
+
+function Table({ className, ...props }: React.ComponentProps<"table">) {
+  return (
+    <div
+      data-slot="table-container"
+      className="relative w-full overflow-x-auto"
+    >
+      <table
+        data-slot="table"
+        className={cn("w-full caption-bottom text-sm", className)}
+        {...props}
+      />
+    </div>
+  )
+}
+
+function TableHeader({ className, ...props }: React.ComponentProps<"thead">) {
+  return (
+    <thead
+      data-slot="table-header"
+      className={cn("[&_tr]:border-b", className)}
+      {...props}
+    />
+  )
+}
+
+function TableBody({ className, ...props }: React.ComponentProps<"tbody">) {
+  return (
+    <tbody
+      data-slot="table-body"
+      className={cn("[&_tr:last-child]:border-0", className)}
+      {...props}
+    />
+  )
+}
+
+function TableFooter({ className, ...props }: React.ComponentProps<"tfoot">) {
+  return (
+    <tfoot
+      data-slot="table-footer"
+      className={cn(
+        "border-t bg-muted/50 font-medium [&>tr]:last:border-b-0",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableRow({ className, ...props }: React.ComponentProps<"tr">) {
+  return (
+    <tr
+      data-slot="table-row"
+      className={cn(
+        "border-b transition-colors hover:bg-muted/50 has-aria-expanded:bg-muted/50 data-[state=selected]:bg-muted",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableHead({ className, ...props }: React.ComponentProps<"th">) {
+  return (
+    <th
+      data-slot="table-head"
+      className={cn(
+        "h-10 px-2 text-left align-middle font-medium whitespace-nowrap text-foreground [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px]",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableCell({ className, ...props }: React.ComponentProps<"td">) {
+  return (
+    <td
+      data-slot="table-cell"
+      className={cn(
+        "p-2 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px]",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableCaption({
+  className,
+  ...props
+}: React.ComponentProps<"caption">) {
+  return (
+    <caption
+      data-slot="table-caption"
+      className={cn("mt-4 text-sm text-muted-foreground", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Table,
+  TableHeader,
+  TableBody,
+  TableFooter,
+  TableHead,
+  TableRow,
+  TableCell,
+  TableCaption,
+}

package/src/ui/components/primitives/tabs.tsx

@@ -0,0 +1,104 @@
+import * as React from "react"
+import { cva, type VariantProps } from "class-variance-authority"
+import { Tabs as TabsPrimitive } from "radix-ui"
+
+import { cn } from '../../lib/cn.ts'
+
+// Divergência da casa (ejetado): o Tabs ganhou `size` — Button e Select têm `sm`, o Tabs
+// não tinha, e uma fileira densa (o header do Maestro) ficava com o segmento 4px mais alto
+// que os irmãos. O tamanho flui pra TabsList via contexto (a altura é dela).
+type TabsSize = "default" | "sm"
+const TabsSizeContext = React.createContext<TabsSize>("default")
+
+function Tabs({
+  className,
+  orientation = "horizontal",
+  size = "default",
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Root> & { size?: TabsSize }) {
+  return (
+    <TabsSizeContext.Provider value={size}>
+      <TabsPrimitive.Root
+        data-slot="tabs"
+        data-orientation={orientation}
+        data-size={size}
+        orientation={orientation}
+        className={cn(
+          "group/tabs flex gap-2 data-[orientation=horizontal]:flex-col",
+          className
+        )}
+        {...props}
+      />
+    </TabsSizeContext.Provider>
+  )
+}
+
+const tabsListVariants = cva(
+  // Altura: horizontal segue o size (h-9 default / h-8 sm — combina `data-[size]` da PRÓPRIA
+  // list com o `group-data-[orientation]` do ancestral); vertical é h-fit em qualquer size.
+  "group/tabs-list inline-flex w-fit items-center justify-center rounded-lg p-[3px] text-muted-foreground group-data-[orientation=horizontal]/tabs:data-[size=default]:h-9 group-data-[orientation=horizontal]/tabs:data-[size=sm]:h-8 group-data-[orientation=vertical]/tabs:h-fit group-data-[orientation=vertical]/tabs:flex-col data-[variant=line]:rounded-none",
+  {
+    variants: {
+      variant: {
+        default: "bg-muted",
+        line: "gap-1 bg-transparent",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+)
+
+function TabsList({
+  className,
+  variant = "default",
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.List> &
+  VariantProps<typeof tabsListVariants>) {
+  // O size vem do <Tabs> (contexto) — a altura mora aqui, na list.
+  const size = React.useContext(TabsSizeContext)
+  return (
+    <TabsPrimitive.List
+      data-slot="tabs-list"
+      data-variant={variant}
+      data-size={size}
+      className={cn(tabsListVariants({ variant }), className)}
+      {...props}
+    />
+  )
+}
+
+function TabsTrigger({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Trigger>) {
+  return (
+    <TabsPrimitive.Trigger
+      data-slot="tabs-trigger"
+      className={cn(
+        "relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap text-foreground/60 transition-all group-data-[orientation=vertical]/tabs:w-full group-data-[orientation=vertical]/tabs:justify-start hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 focus-visible:outline-1 focus-visible:outline-ring disabled:pointer-events-none disabled:opacity-50 group-data-[variant=default]/tabs-list:data-[state=active]:shadow-sm group-data-[variant=line]/tabs-list:data-[state=active]:shadow-none dark:text-muted-foreground dark:hover:text-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        "group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-[state=active]:bg-transparent dark:group-data-[variant=line]/tabs-list:data-[state=active]:border-transparent dark:group-data-[variant=line]/tabs-list:data-[state=active]:bg-transparent",
+        "data-[state=active]:bg-background data-[state=active]:text-foreground dark:data-[state=active]:border-input dark:data-[state=active]:bg-input/30 dark:data-[state=active]:text-foreground",
+        "after:absolute after:bg-foreground after:opacity-0 after:transition-opacity group-data-[orientation=horizontal]/tabs:after:inset-x-0 group-data-[orientation=horizontal]/tabs:after:bottom-[-5px] group-data-[orientation=horizontal]/tabs:after:h-0.5 group-data-[orientation=vertical]/tabs:after:inset-y-0 group-data-[orientation=vertical]/tabs:after:-right-1 group-data-[orientation=vertical]/tabs:after:w-0.5 group-data-[variant=line]/tabs-list:data-[state=active]:after:opacity-100",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TabsContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Content>) {
+  return (
+    <TabsPrimitive.Content
+      data-slot="tabs-content"
+      className={cn("flex-1 outline-none", className)}
+      {...props}
+    />
+  )
+}
+
+export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants }

package/src/ui/components/primitives/textarea.tsx

@@ -0,0 +1,18 @@
+import * as React from "react"
+
+import { cn } from '../../lib/cn.ts'
+
+function Textarea({ className, ...props }: React.ComponentProps<"textarea">) {
+  return (
+    <textarea
+      data-slot="textarea"
+      className={cn(
+        "flex field-sizing-content min-h-16 w-full rounded-md border border-input bg-transparent px-3 py-2 text-base transition-[color,box-shadow] outline-none placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 md:text-sm dark:bg-input/30 dark:aria-invalid:ring-destructive/40",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Textarea }

package/src/ui/components/primitives/toggle-group.tsx

@@ -0,0 +1,81 @@
+import * as React from "react"
+import { type VariantProps } from "class-variance-authority"
+import { ToggleGroup as ToggleGroupPrimitive } from "radix-ui"
+
+import { cn } from '../../lib/cn.ts'
+import { toggleVariants } from './toggle.tsx'
+
+const ToggleGroupContext = React.createContext<
+  VariantProps<typeof toggleVariants> & {
+    spacing?: number
+  }
+>({
+  size: "default",
+  variant: "default",
+  spacing: 0,
+})
+
+function ToggleGroup({
+  className,
+  variant,
+  size,
+  spacing = 0,
+  children,
+  ...props
+}: React.ComponentProps<typeof ToggleGroupPrimitive.Root> &
+  VariantProps<typeof toggleVariants> & {
+    spacing?: number
+  }) {
+  return (
+    <ToggleGroupPrimitive.Root
+      data-slot="toggle-group"
+      data-variant={variant}
+      data-size={size}
+      data-spacing={spacing}
+      style={{ "--gap": spacing } as React.CSSProperties}
+      className={cn(
+        "group/toggle-group flex w-fit items-center gap-[--spacing(var(--gap))] rounded-md",
+        className
+      )}
+      {...props}
+    >
+      <ToggleGroupContext.Provider value={{ variant, size, spacing }}>
+        {children}
+      </ToggleGroupContext.Provider>
+    </ToggleGroupPrimitive.Root>
+  )
+}
+
+function ToggleGroupItem({
+  className,
+  children,
+  variant,
+  size,
+  ...props
+}: React.ComponentProps<typeof ToggleGroupPrimitive.Item> &
+  VariantProps<typeof toggleVariants>) {
+  const context = React.useContext(ToggleGroupContext)
+
+  return (
+    <ToggleGroupPrimitive.Item
+      data-slot="toggle-group-item"
+      data-variant={context.variant || variant}
+      data-size={context.size || size}
+      data-spacing={context.spacing}
+      className={cn(
+        toggleVariants({
+          variant: context.variant || variant,
+          size: context.size || size,
+        }),
+        "w-auto min-w-0 shrink-0 px-3 focus:z-10 focus-visible:z-10",
+        "data-[spacing=0]:rounded-none data-[spacing=0]:shadow-none data-[spacing=0]:first:rounded-l-md data-[spacing=0]:last:rounded-r-md data-[spacing=0]:data-[variant=outline]:border-l-0 data-[spacing=0]:data-[variant=outline]:first:border-l",
+        className
+      )}
+      {...props}
+    >
+      {children}
+    </ToggleGroupPrimitive.Item>
+  )
+}
+
+export { ToggleGroup, ToggleGroupItem }

package/src/ui/components/primitives/toggle.tsx

@@ -0,0 +1,45 @@
+import * as React from "react"
+import { cva, type VariantProps } from "class-variance-authority"
+import { Toggle as TogglePrimitive } from "radix-ui"
+
+import { cn } from '../../lib/cn.ts'
+
+const toggleVariants = cva(
+  "inline-flex items-center justify-center gap-2 rounded-md text-sm font-medium whitespace-nowrap transition-[color,box-shadow] outline-none hover:bg-muted hover:text-muted-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 data-[state=on]:bg-accent data-[state=on]:text-accent-foreground dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+  {
+    variants: {
+      variant: {
+        default: "bg-transparent",
+        outline:
+          "border border-input bg-transparent hover:bg-accent hover:text-accent-foreground",
+      },
+      size: {
+        default: "h-9 min-w-9 px-2",
+        sm: "h-8 min-w-8 px-1.5",
+        lg: "h-10 min-w-10 px-2.5",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+function Toggle({
+  className,
+  variant,
+  size,
+  ...props
+}: React.ComponentProps<typeof TogglePrimitive.Root> &
+  VariantProps<typeof toggleVariants>) {
+  return (
+    <TogglePrimitive.Root
+      data-slot="toggle"
+      className={cn(toggleVariants({ variant, size, className }))}
+      {...props}
+    />
+  )
+}
+
+export { Toggle, toggleVariants }

package/src/ui/components/primitives/tooltip.tsx

@@ -0,0 +1,55 @@
+import * as React from "react"
+import { Tooltip as TooltipPrimitive } from "radix-ui"
+
+import { cn } from '../../lib/cn.ts'
+
+function TooltipProvider({
+  delayDuration = 0,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
+  return (
+    <TooltipPrimitive.Provider
+      data-slot="tooltip-provider"
+      delayDuration={delayDuration}
+      {...props}
+    />
+  )
+}
+
+function Tooltip({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
+  return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+}
+
+function TooltipTrigger({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
+}
+
+function TooltipContent({
+  className,
+  sideOffset = 0,
+  children,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Content
+        data-slot="tooltip-content"
+        sideOffset={sideOffset}
+        className={cn(
+          "z-50 w-fit origin-(--radix-tooltip-content-transform-origin) animate-in rounded-md bg-foreground px-3 py-1.5 text-xs text-balance text-background fade-in-0 zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95",
+          className
+        )}
+        {...props}
+      >
+        {children}
+        <TooltipPrimitive.Arrow className="z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground" />
+      </TooltipPrimitive.Content>
+    </TooltipPrimitive.Portal>
+  )
+}
+
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }

package/src/ui/components/primitives/truncate.tsx

@@ -0,0 +1,49 @@
+import * as React from 'react'
+import { Tooltip, TooltipContent, TooltipTrigger } from './tooltip.tsx'
+import { cn } from '../../lib/cn.ts'
+
+export interface TruncateProps extends React.ComponentProps<'span'> {
+  /** Conteúdo do tooltip quando transborda. Default: os próprios children. */
+  tooltip?: React.ReactNode
+}
+
+/**
+ * Texto truncado com tooltip SÓ quando transborda de verdade (medição do overflow:
+ * `scrollWidth > clientWidth`, re-medido em resize). Substitui a composição
+ * `block truncate` + `title` sempre presente — title em texto que não corta é ruído.
+ * Requer `<TooltipProvider>` na raiz do app (o esqueleto do `opus create` já monta).
+ */
+export function Truncate({ tooltip, children, className, ...props }: TruncateProps): React.ReactElement {
+  const ref = React.useRef<HTMLSpanElement>(null)
+  const [overflowing, setOverflowing] = React.useState(false)
+
+  const measure = React.useCallback(() => {
+    const el = ref.current
+    if (el === null) return
+    setOverflowing(el.scrollWidth > el.clientWidth)
+  }, [])
+
+  React.useLayoutEffect(() => {
+    measure()
+    const el = ref.current
+    if (el === null || typeof ResizeObserver === 'undefined') return
+    const ro = new ResizeObserver(measure)
+    ro.observe(el)
+    return () => ro.disconnect()
+    // children na dependência: texto novo re-mede (o RO só vê mudança de CAIXA).
+  }, [measure, children])
+
+  const span = (
+    <span ref={ref} data-slot="truncate" className={cn('block truncate', className)} {...props}>
+      {children}
+    </span>
+  )
+
+  if (!overflowing) return span
+  return (
+    <Tooltip>
+      <TooltipTrigger asChild>{span}</TooltipTrigger>
+      <TooltipContent>{tooltip ?? children}</TooltipContent>
+    </Tooltip>
+  )
+}

package/src/ui/docs/DocBrowser.tsx

@@ -0,0 +1,90 @@
+/**
+ * DocBrowser — a VERDADE VISUAL da casa, como doc completa. Seção multi-página: conceitos
+ * (Introdução, Tokens & Tema, Microcopy, Customização) + uma página por componente do
+ * opus/ui, agrupados por seção. O que você vê aqui é o que os apps entregam (o site
+ * do shadcn é catálogo do que existe; a expectativa visual nasce aqui).
+ *
+ * Dois modos de roteamento:
+ *  - CONTROLADO (`path` vem de fora): o host (ex.: Maestro) é dono do path; o DocBrowser
+ *    só lê e navega.
+ *  - STANDALONE (`path` ausente): o path vem do router da casa — é o modo da rota dev
+ *    `/__docs` de cada app (a doc com a identidade do projeto).
+ * Nos dois, navegar emite `popstate`: host que guarda o path por conta própria acompanha.
+ * `basePath` adapta o prefixo das URLs (`/docs` no Maestro, `/__docs` nos apps).
+ */
+import { useEffect } from 'react'
+import { DOC_SECTIONS, type DocSection, type DocEntry } from './registry'
+import { SectionShell, type SectionNavGroup } from '../components/patterns/section-shell.tsx'
+import { navigate, usePathname } from '../router.ts'
+
+function findPage(sections: DocSection[], slug: string): DocEntry | undefined {
+  for (const s of sections) {
+    for (const g of s.groups) {
+      const p = g.pages.find((p) => p.slug === slug)
+      if (p) return p
+    }
+  }
+  return undefined
+}
+
+export interface DocBrowserProps {
+  /** Prefixo das rotas da doc. Default `/docs` (Maestro); `/__docs` na rota dev dos apps. */
+  basePath?: string
+  /** Path controlado pelo host (modo Maestro). Ausente = standalone (gerencia o próprio). */
+  path?: string
+  /** Seções a exibir (seção → grupo → página). Default = catálogo inteiro. */
+  sections?: DocSection[]
+  /** Monta o `document.title` a partir do título da página atual (ex.: `(t) => `${t} · Opus``).
+   *  Ausente = não mexe no title. */
+  documentTitle?: (pageTitle: string) => string
+}
+
+export function DocBrowser({
+  basePath = '/docs',
+  path: controlledPath,
+  sections = DOC_SECTIONS,
+  documentTitle,
+}: DocBrowserProps): React.ReactElement {
+  // Standalone: o path vem do router da casa (`usePathname` — pathname É o estado).
+  // Controlado: o host manda, e este valor é ignorado. O hook roda sempre (regra dos
+  // hooks); o que muda é quem vence no `??`.
+  const livePath = usePathname()
+  const path = controlledPath ?? livePath
+  // Default = 1ª página do 1º grupo da 1ª seção (a doc abre na 1ª página).
+  const defaultSlug = sections[0]?.groups[0]?.pages[0]?.slug ?? ''
+  // Slug = TODOS os segmentos após o basePath, unidos (rota aninhada: `/docs/guias/deploy`
+  // → `guias/deploy`). Slug flat de 1 segmento continua igual (`join` de 1 elemento = ele).
+  const rel = path.startsWith(basePath) ? path.slice(basePath.length) : ''
+  const slug = rel.split('/').filter(Boolean).join('/') || defaultSlug
+  const page = findPage(sections, slug) ?? findPage(sections, defaultSlug)
+
+  // `navigate` emite `popstate`, então o host é notificado nos dois modos — inclusive o
+  // que ainda escuta o evento na unha, que era como este componente avisava antes.
+  const go = (to: string): void => navigate(to)
+
+  // O title da aba acompanha a página atual (quando o host fornece o formato).
+  useEffect(() => {
+    if (page && documentTitle) document.title = documentTitle(page.title)
+  }, [page, documentTitle])
+
+  // Seção → grupo, e os grupos da seção → subgrupos. O tier do meio NÃO pode ser
+  // achatado: `docSectionsFromFolder` o preenche a partir de sub-pasta (ou do
+  // frontmatter `group:`), que é o caminho do `opusDocs({ source })`.
+  const navGroups: SectionNavGroup[] = sections.map((section) => ({
+    label: section.label,
+    subgroups: section.groups.map((g) => ({
+      label: g.label,
+      items: g.pages.map((p) => ({ id: p.slug, label: p.title, badge: p.badge })),
+    })),
+  }))
+
+  return (
+    <SectionShell
+      groups={navGroups}
+      activeId={page?.slug}
+      onSelect={(slug) => go(`${basePath}/${slug}`)}
+    >
+      <div className="mx-auto max-w-3xl px-8 py-8">{page?.render()}</div>
+    </SectionShell>
+  )
+}

package/src/ui/docs/changelog.tsx

@@ -0,0 +1,80 @@
+/**
+ * ChangelogView — apresentação do CHANGELOG.md do pacote (a MESMA fonte que viaja em
+ * node_modules): linha do tempo por versão, data ao lado, e a seção Breaking em
+ * destaque (badge + contêiner) — o leitor que pula versões acha as quebras no olho.
+ * O parser é convenção-fina sobre o markdown (`## <versão> — <data>` + `### Breaking`);
+ * o corpo de cada trecho segue renderizado pelo DocMarkdown (fidelidade total).
+ */
+import { Badge } from '../react.tsx'
+import { DocMarkdown } from './markdown.tsx'
+// A fonte é o CHANGELOG DO PACOTE (raiz) — a mesma que viaja em node_modules.
+import changelogMd from '../../../CHANGELOG.md?raw'
+
+export interface ChangelogVersion {
+  version: string
+  date?: string
+  body: string
+  breaking?: string
+}
+
+export interface ParsedChangelog {
+  intro: string
+  versions: ChangelogVersion[]
+}
+
+/** Parseia o changelog: intro (antes do 1º `## `) + versões (`## x — data`, `### Breaking`). */
+export function parseChangelog(source: string): ParsedChangelog {
+  const chunks = `\n${source.trim()}`.split(/\n## /)
+  const intro = chunks[0]?.trim() ?? ''
+  const versions: ChangelogVersion[] = []
+  for (const chunk of chunks.slice(1)) {
+    const nl = chunk.indexOf('\n')
+    const header = (nl === -1 ? chunk : chunk.slice(0, nl)).trim()
+    const rest = nl === -1 ? '' : chunk.slice(nl + 1)
+    const [version, date] = header.split(/\s+—\s+/)
+    const [body, breaking] = rest.split(/\n### Breaking\s*\n/)
+    versions.push({
+      version: (version ?? header).trim(),
+      ...(date !== undefined ? { date: date.trim() } : {}),
+      body: (body ?? '').trim(),
+      ...(breaking !== undefined ? { breaking: breaking.trim() } : {}),
+    })
+  }
+  return { intro, versions }
+}
+
+export function ChangelogView({ source }: { source: string }): React.ReactElement {
+  const { intro, versions } = parseChangelog(source)
+  return (
+    <div>
+      {intro.length > 0 && <DocMarkdown content={intro} />}
+      <div className="mt-10 space-y-10">
+        {versions.map((v) => (
+          <section key={v.version} className="border-t border-border/60 pt-6">
+            <div className="flex flex-wrap items-baseline gap-x-3 gap-y-1">
+              <h2 className="text-xl font-semibold tracking-tight">{v.version}</h2>
+              {v.date !== undefined && <span className="text-sm text-muted-foreground">{v.date}</span>}
+              {v.breaking !== undefined && <Badge variant="destructive">Breaking</Badge>}
+            </div>
+            {v.body.length > 0 && (
+              <div className="mt-3">
+                <DocMarkdown content={v.body} />
+              </div>
+            )}
+            {v.breaking !== undefined && (
+              <div className="mt-4 rounded-md border border-destructive/30 bg-destructive/5 px-4 py-3">
+                <div className="mb-2 text-xs font-medium text-destructive">Breaking — o que fazer</div>
+                <DocMarkdown content={v.breaking} />
+              </div>
+            )}
+          </section>
+        ))}
+      </div>
+    </div>
+  )
+}
+
+/** O changelog do Opus pronto pra montar (site: página de topo; Maestro: página da doc). */
+export function OpusChangelog(): React.ReactElement {
+  return <ChangelogView source={changelogMd} />
+}