@softize/opus 9.1.1 → 11.0.0

package/CHANGELOG.md

@@ -11,6 +11,55 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 > tinha ficado sem registro nenhum, o que é exatamente o caso que este arquivo existe
 > pra cobrir.
 
+## 11.0.0 — 2026-08-21
+
+**Breaking — deprecateds removidos na fronteira pública.** O major anterior manteve por
+engano APIs cuja própria documentação prometia remoção na próxima versão; esta versão
+fecha a migração em vez de carregar duas taxonomias indefinidamente.
+
+- `AppShell`, `AppShellBar`, `AppShellTrigger`, `useAppShell`, `useSidebarSlot` e
+  `SectionShell` (incluindo seus tipos `Section*`) saem. Componha chrome e seções com
+  `Split`, `Pane`, `Sidebar`, `PaneHeader`, `PaneContent`, `PaneFooter` e `SidebarNav`.
+- `ResizablePanelGroup`, `ResizablePanel` e `ResizableHandle` deixam de ser exports
+  públicos. Use `<Split resizable>` e declare tamanho/limites nos `<Pane>`.
+- `SidebarHeader`, `SidebarContent` e `SidebarFooter` saem; eram aliases de
+  `PaneHeader`, `PaneContent` e `PaneFooter`.
+- `DomainConfig.models` sai. Declare entidades em `DomainConfig.entities`; os comandos
+  `opus db` e o gerador agora leem somente esse campo. O manifest deixa de emitir o array
+  redundante `models`; os nomes continuam disponíveis em `entities[].name`.
+
+`SidebarNav` passa a aceitar `subgroups`, cobrindo navegação contextual e a árvore de três
+níveis da documentação sem um shell especializado. `ShellNav` agora deriva o estado
+recolhido diretamente da `Sidebar`. O próprio `DocBrowser` foi migrado para a composição
+canônica e serve como consumidor de referência.
+
+**Migração:** substitua shells prontos pela composição `Split > Pane > Sidebar`; troque os
+aliases `Sidebar*` pelos slots `Pane*`; envolva painéis ajustáveis em `<Split resizable>`;
+renomeie `domain.models` para `domain.entities` e, ao consumir manifest, derive nomes de
+`domain.entities.map(entity => entity.name)`.
+
+## 10.0.0 — 2026-08-20
+
+**Breaking — forma usa a escala do Tailwind e superfícies sempre carregam seu foreground.**
+
+- `Card` volta a ser flat por padrão, alinhando a implementação ao contrato já documentado
+  no componente e no catálogo. Consumidores que precisam de elevação devem declarar a
+  intensidade explicitamente (`shadow-sm`, `shadow-md`, etc.).
+- Forma deixa de criar uma taxonomia paralela por componente: `rounded-card` e
+  `rounded-dialog` migram para `rounded-xl`; `rounded-popover`, para `rounded-md`. Os tokens
+  `--radius-card/popover/dialog` saem, e `opus check` acusa classes e overrides antigos.
+- Superfícies `card` e `popover` passam a exigir seu foreground no mesmo fragmento de
+  classes. Dialog, Composer, Chat e o fundo nativo do Calendar foram corrigidos; `opus check`
+  agora reprova `bg-card` sem `text-card-foreground` e `bg-popover` sem
+  `text-popover-foreground`, evitando que a igualdade acidental com o foreground global
+  esconda temas quebrados.
+
+**Migração:** troque `rounded-card` e `rounded-dialog` por `rounded-xl`, e
+`rounded-popover` por `rounded-md`. Remova overrides de `--radius-card`,
+`--radius-dialog` e `--radius-popover`; ajuste `--radius` ou a escala `--radius-*` quando
+necessário. Sempre declare `bg-card text-card-foreground` e
+`bg-popover text-popover-foreground` juntos. `opus check` aponta todos esses casos.
+
 ## 9.1.1 — 2026-08-20
 
 **`Ask` leva elicitação estruturada para `@softize/opus/ui/react`.** O componente
@@ -89,7 +138,6 @@ todas as mensagens que apenas têm comportamento `sticky` disponível.
 fronteira memoizada separada do estado do composer, e cada bloco Markdown reaproveita o
 resultado enquanto seu conteúdo não muda. Conversas longas mantêm o custo de digitação
 constante; durante streaming, somente a mensagem alterada volta a passar pelo parser.
-
 ## 9.0.3 — 2026-08-12
 
 **O pre-push ignora worktrees internos do Maestro.** Projetos sob `.maestro/` pertencem
@@ -132,8 +180,9 @@ depender de coincidências do call site:
   removidos, deixando `ring-*` para foco e estados transitórios.
 - a elevação volta ao vocabulário de intensidade do Tailwind (`shadow-sm`, `shadow-md`,
   `shadow-lg` etc.), com a composição clara e difusa controlada pelo tema do Opus.
-  `Card`/`Composer`, menus/popovers e modais usam respectivamente `sm`, `md` e `lg` como
-  defaults; os aliases por papel e as variáveis intermediárias `--elevation-*` saem.
+  Na 9.0.0, `Card`/`Composer`, menus/popovers e modais passaram a usar respectivamente
+  `sm`, `md` e `lg` como defaults; os aliases por papel e as variáveis intermediárias
+  `--elevation-*` saíram. O default do `Card` foi posteriormente removido na 10.0.0.
 - `shadow-lg` ganha spread negativo e menos opacidade: mantém alcance, mas deixa de
   engrossar visualmente a borda no ponto de contato com a superfície.
 - toda a escala passa a declarar a receita diretamente em `--shadow-*`, preservando a

package/bin/lib/check.mjs

@@ -53,11 +53,25 @@ const REMOVED_UI_TOKENS = new Map([
   ['shadow-card', 'use `shadow-sm`'],
   ['shadow-popover', 'use `shadow-md`'],
   ['shadow-dialog', 'use `shadow-lg`'],
+  ['rounded-card', 'use `rounded-xl`'],
+  ['rounded-popover', 'use `rounded-md`'],
+  ['rounded-dialog', 'use `rounded-xl`'],
   ['--edge-value', 'remova o override; a aresta agora usa `--border`'],
   ['--color-edge', 'remova o token; a aresta agora usa `--border`'],
   ['--elevation-card', 'use/ajuste `--shadow-sm`'],
   ['--elevation-popover', 'use/ajuste `--shadow-md`'],
   ['--elevation-dialog', 'use/ajuste `--shadow-lg`'],
+  ['--radius-card', 'use/ajuste `--radius-xl`'],
+  ['--radius-popover', 'use/ajuste `--radius-md`'],
+  ['--radius-dialog', 'use/ajuste `--radius-xl`'],
+])
+
+// Superfícies com foreground próprio formam um par indivisível. Exigir as duas
+// utilities no mesmo fragmento de classes torna a regra local, revisável e evita que a
+// igualdade acidental com `--foreground` esconda um tema quebrado.
+const UI_SURFACE_PAIRS = new Map([
+  ['bg-card', 'text-card-foreground'],
+  ['bg-popover', 'text-popover-foreground'],
 ])
 
 /** Os três nomes que denotam action/contrato — o arquivo sem nenhum deles é pulado. */
@@ -399,7 +413,7 @@ export function checkUiMigrations(file, text) {
       action: token,
       line,
       file,
-      message: `token removido na 9.0.0 — ${replacement}.`,
+      message: `token removido — ${replacement}.`,
     })
   }
   for (const [index, raw] of source.split(/\r?\n/).entries()) {
@@ -422,6 +436,28 @@ export function checkUiMigrations(file, text) {
     const objectProperty = /\b(?!aria(?:Label|Description)\b|label\b|title\b|description\b|text\b|message\b|note\b|content\b)[A-Za-z_$][\w$-]*\s*:\s*$/.test(beforeValue)
     const classListCall = /\bclassList\.(?:add|remove|toggle|replace|contains)\s*\([^)]*$/.test(beforeValue)
     const stylePropertyCall = /\b(?:style\.)?setProperty\s*\([^)]*$/.test(beforeValue)
+    const utilityContext = classAttribute || classExpression || utilityHelper || classBinding || objectProperty || classListCall
+    const utilities = value.trim().split(/\s+/).filter(Boolean)
+    for (const [background, foreground] of UI_SURFACE_PAIRS) {
+      const pairKey = `surface:${background}`
+      const hasUtility = (expected) => utilities.some((utility) => {
+        const normalized = utility.replace(/^!/, '').replace(/!$/, '')
+        return normalized === expected || normalized.startsWith(`${expected}/`)
+      })
+      const hasBackground = hasUtility(background)
+      const hasForeground = hasUtility(foreground)
+      if (!seen.has(pairKey) && utilityContext && hasBackground && !hasForeground) {
+        seen.add(pairKey)
+        findings.push({
+          rule: 'unpaired-ui-surface',
+          level: 'error',
+          action: background,
+          line: startLine,
+          file,
+          message: `superfície sem o foreground correspondente — use \`${background} ${foreground}\` no mesmo fragmento de classes.`,
+        })
+      }
+    }
     for (const [token, replacement] of REMOVED_UI_TOKENS) {
       const usedAsUtility = matchesToken(value, token) && (
         classAttribute || classExpression || utilityHelper || classBinding || objectProperty ||

package/bin/lib/db-check-runner.mjs

@@ -8,7 +8,7 @@
  *
  * Contrato do `opus.config.ts` pros comandos `db`:
  *   - `entities?: EntityConfig[]`        — entidades explícitas (opcional)
- *   - `domains?: DomainConfig[]`         — entidades coletadas de `domain.models`
+ *   - `domains?: DomainConfig[]`         — entidades coletadas de `domain.entities`
  *   - `database: () => Kysely | Promise<Kysely>`  — factory LAZY do banco.
  *     É factory (não instância) de propósito: o `gen` importa o mesmo config
  *     sem nunca chamar `database()`, então não abre conexão.
@@ -29,9 +29,9 @@ function emit(obj) {
 
 function collectEntities(domain, out) {
   if (domain === null || typeof domain !== 'object') return
-  const models = domain.models
-  if (models !== undefined && models !== null && typeof models === 'object') {
-    for (const value of Object.values(models)) {
+  const entities = domain.entities
+  if (entities !== undefined && entities !== null && typeof entities === 'object') {
+    for (const value of Object.values(entities)) {
       if (isEntityConfig(value)) out.push(value)
     }
   }
@@ -59,7 +59,7 @@ async function main() {
   }
 
   if (entities.length === 0) {
-    emit({ ok: false, error: 'nenhuma entidade encontrada (config.entities ou domain.models)' })
+    emit({ ok: false, error: 'nenhuma entidade encontrada (config.entities ou domain.entities)' })
     return
   }
 

package/bin/lib/db-migrate-runner.mjs

@@ -28,9 +28,9 @@ function emit(obj) {
 
 function collectEntities(domain, out) {
   if (domain === null || typeof domain !== 'object') return
-  const models = domain.models
-  if (models !== undefined && models !== null && typeof models === 'object') {
-    for (const value of Object.values(models)) if (isEntityConfig(value)) out.push(value)
+  const entities = domain.entities
+  if (entities !== undefined && entities !== null && typeof entities === 'object') {
+    for (const value of Object.values(entities)) if (isEntityConfig(value)) out.push(value)
   }
   if (Array.isArray(domain.subdomains)) for (const sub of domain.subdomains) collectEntities(sub, out)
 }

package/bin/lib/db-scaffold-runner.mjs

@@ -23,9 +23,9 @@ function emit(obj) {
 
 function collectEntities(domain, out) {
   if (domain === null || typeof domain !== 'object') return
-  const models = domain.models
-  if (models !== undefined && models !== null && typeof models === 'object') {
-    for (const value of Object.values(models)) if (isEntityConfig(value)) out.push(value)
+  const entities = domain.entities
+  if (entities !== undefined && entities !== null && typeof entities === 'object') {
+    for (const value of Object.values(entities)) if (isEntityConfig(value)) out.push(value)
   }
   if (Array.isArray(domain.subdomains)) for (const sub of domain.subdomains) collectEntities(sub, out)
 }
@@ -48,7 +48,7 @@ async function main() {
   if (Array.isArray(config.entities)) for (const e of config.entities) if (isEntityConfig(e)) entities.push(e)
   if (Array.isArray(config.domains)) for (const d of config.domains) collectEntities(d, entities)
   if (entities.length === 0) {
-    emit({ ok: false, error: 'nenhuma entidade encontrada (config.entities ou domain.models)' })
+    emit({ ok: false, error: 'nenhuma entidade encontrada (config.entities ou domain.entities)' })
     return
   }
   if (typeof config.database !== 'function') {

package/bin/lib/db.mjs

@@ -249,7 +249,7 @@ Flags:
 
 O opus.config.ts precisa expor, pros comandos db:
   database: () => Kysely          factory LAZY do banco (gen não a chama)
-  entities | domains              entidades (explícitas ou via domain.models)
+  entities | domains              entidades (explícitas ou via domain.entities)
   schema?: string                 script SQL idempotente (default: ./db/schema.sql)
   migrations?: string             pasta dos rascunhos do scaffold (default: ./migrations)
 

package/bin/lib/gen-manifest.mjs

@@ -25,10 +25,7 @@ function shapeDomain(d) {
     dicts: d.dicts,
     repository: d.hasRepository,
     service: d.hasService,
-    // `entities` = a fonte estrutural+negócio (campos + docs). `models` = nomes
-    // (legado, removido no PR de rename). Ambos por ora pra não quebrar a lente.
     entities: d.entities ?? [],
-    models: d.modelNames,
     actions: d.actions.map(shapeAction),
     reactions: d.reactions,
     schedules: d.schedules,

package/bin/lib/gen-runner.mjs

@@ -30,7 +30,7 @@
  *     SerializedDomain:
  *     {
  *       name, dicts, actions, reactions, schedules, subdomains,
- *       hasRepository, hasService, hasModels
+ *       hasRepository, hasService
  *     }
  *
  *     SerializedAction (todos os ActionDef preservam suas strings):
@@ -143,17 +143,12 @@ async function main() {
 // =============================================================================
 
 function serializeDomain(domain, ctx) {
-  // `entities` é o nome preferido; `models` é o legado (alias). Lê os dois.
-  const entitySrc = domain.entities ?? domain.models
-  const entityList = serializeEntities(entitySrc)
+  const entityList = serializeEntities(domain.entities)
   return {
     name: domain.name,
     description: nullable(domain.description),
     hasRepository: domain.repository !== undefined,
     hasService: domain.service !== undefined,
-    // Compat: nomes ainda expostos; `entities` traz a estrutura+doc completa.
-    hasModels: entityList.length > 0,
-    modelNames: entityList.map((e) => e.name),
     entities: entityList,
     dicts: serializeDicts(domain.dicts),
     actions: Array.from(iterateActions(domain.actions), (a) =>

package/docs/data-layer.md

@@ -90,7 +90,7 @@ infra do `gen`, não a do `check`). Contrato do config **pros comandos `db`**:
 
 ```ts
 export default {
-  domains: [...],                       // entidades coletadas de domain.models
+  domains: [...],                       // entidades coletadas de domain.entities
   entities: [Deal, Company],            // ou explícitas (opcional)
   schema: './src/db/schema.sql',        // o script idempotente (default: ./db/schema.sql)
   database: () => new Kysely({ ... }),  // factory LAZY do banco
@@ -139,7 +139,7 @@ import { Kysely, PostgresDialect, CamelCasePlugin } from 'kysely'
 import { Deal } from './src/domains/deals/deal.entity.ts'
 
 export default {
-  entities: [Deal],          // ou domains: [...] (entidades via domain.models)
+  entities: [Deal],          // ou domains: [...] (entidades via domain.entities)
   naming: 'snake',           // colunas snake no banco
   migrations: './migrations',
   database: () => new Kysely({

package/docs/elevation-scale.md

@@ -32,8 +32,8 @@ uma superfície que precisava apenas de mais presença acabava recebendo um nome
 - Qualquer componente pode subir ou descer um degrau sem adotar o nome de outro papel.
 - A escala global afeta todo uso legítimo de `shadow-*`, inclusive consumidores externos;
   isso é intencional e fica declarado no tema.
-- Forma e cor podem continuar semânticas (`rounded-card`, `bg-popover`), pois não
-  representam uma intensidade intercambiável.
+- Cor pode continuar semântica (`bg-popover`); forma usa diretamente a escala
+  (`rounded-md`, `rounded-xl`). Nenhuma delas representa intensidade intercambiável.
 
 ## Alternativas descartadas
 

package/docs/protocol.md

@@ -2053,14 +2053,14 @@ defineAction({
 
 ### Entidades dentro de um domínio
 
-`DomainConfig.models` recebe as entidades do recorte (substitui o `unknown` placeholder atual). O domínio agrupa; a entidade declara.
+`DomainConfig.entities` recebe as entidades do recorte. O domínio agrupa; a entidade declara.
 
 ```ts
 import { defineDomain } from '@softize/opus'
 
 export const crm = defineDomain({
   name: 'crm',
-  models: { Deal, Company, Contact },
+  entities: { Deal, Company, Contact },
   actions: { /* deal.create, deal.search, ... */ },
 })
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "9.1.1",
+  "version": "11.0.0",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

package/registry/skills/build-opus-ui/SKILL.md

@@ -20,12 +20,17 @@ existentes, mantendo navegação observável e componentes reutilizáveis sem la
 4. Manter margem e posicionamento no consumidor; componente reutilizável controla apenas
    seu interior.
 5. Evoluir um pattern compartilhado apenas quando a recorrência e o contrato estiverem claros.
-6. Testar estados de loading, vazio, erro, sucesso, permissão e interação relevante.
+6. Tratar tokens de superfície como pares indivisíveis no mesmo fragmento de classes:
+   `bg-card text-card-foreground` e `bg-popover text-popover-foreground`. Não depender da
+   igualdade atual com `--foreground`, porque o app pode sobrescrever cada par.
+7. Usar diretamente a escala `rounded-*`; não criar radius por nome de componente quando
+   `rounded-sm` a `rounded-xl` já expressam a forma.
+8. Testar estados de loading, vazio, erro, sucesso, permissão e interação relevante.
 
 ## Verificação
 
-Rodar testes focados, typecheck e build da superfície. Inspecionar visualmente a rota real
-e validar navegação por URL quando aplicável.
+Rodar `opus check`, testes focados, typecheck e build da superfície. Inspecionar visualmente
+a rota real e validar navegação por URL quando aplicável.
 
 ## Limites
 

package/registry/skills/build-opus-ui/references/evaluations.md

@@ -3,3 +3,5 @@
 - Dispara: “Monte a tela de edição usando a form action do Opus.”
 - Não dispara: “Ajuste o CSS de um e-mail estático.”
 - Execução: implementar uma lista com modal roteável e provar loading, erro, vazio e back.
+- Reprova: criar uma casca `bg-card` que herda o texto global ou introduzir `rounded-widget`
+  quando a escala `rounded-*` atende ao papel.

package/registry/skills/build-opus-ui/references/ui-patterns.md

@@ -5,4 +5,7 @@
   operação, não a uma tela isolada.
 - URL representa estado que precisa sobreviver a refresh, deep link ou histórico.
 - Componentes compartilhados não impõem margem externa; páginas e shells compõem layout.
+- Superfície semântica e foreground são um par local (`bg-card text-card-foreground`,
+  `bg-popover text-popover-foreground`); herança do foreground global não substitui o par.
+- Forma usa a escala `rounded-*`; nome de componente não cria uma segunda escala de radius.
 - Catálogo e API efetivos vêm dos exports da versão instalada, não de memória ou exemplo antigo.

package/src/core/domain.ts

@@ -2,7 +2,7 @@
  * tbdlib — `defineDomain` factory + flatten helper.
  *
  * Domain agrupa as peças que pertencem a um mesmo recorte funcional
- * (dicts, models, repository, service, actions, reactions, schedules,
+ * (dicts, entities, repository, service, actions, reactions, schedules,
  * subdomains). É puramente declarativo: nenhum efeito colateral acontece
  * em `defineDomain`. O runtime consome o objeto via `flattenDomain` quando
  * recebe um `DomainConfig` em `register(...)`.
@@ -55,12 +55,9 @@ export interface DomainConfig {
   dicts?: Record<string, unknown>
 
   /** Entidades do domínio (`defineEntity`). Map de nome → EntityConfig. É a fonte
-   *  estrutural+negócio que vai pro manifest. `models` é o nome legado (alias). */
+   *  estrutural+negócio que vai pro manifest. */
   entities?: Record<string, unknown>
 
-  /** @deprecated Use `entities`. Mantido por compat — o runtime/gen lê os dois. */
-  models?: Record<string, unknown>
-
   /** Repository class do domínio. */
   repository?: unknown
 
@@ -152,7 +149,7 @@ export function isDomainConfig(value: unknown): value is DomainConfig {
     'schedules' in v ||
     'subdomains' in v ||
     'dicts' in v ||
-    'models' in v ||
+    'entities' in v ||
     'repository' in v ||
     'service' in v
   )

package/src/schema/entity.ts

@@ -310,7 +310,7 @@ export function entityTable(config: EntityConfig): string {
 
 /**
  * `true` se `value` parece um `EntityConfig`. Usado pra coletar entidades de
- * `domain.models` (que é `unknown`) sem confundir com action/reaction/model.
+ * `domain.entities` (que é `unknown`) sem confundir com action/reaction/model.
  * Heurística: tem `name` string + `fields` objeto e **não** tem `kind`
  * (descarta `ActionDef`).
  */

package/src/ui/components/patterns/shell-nav.tsx

@@ -2,11 +2,8 @@
  * <ShellNav /> — o menu como primitivo PIVOTÁVEL. Um nav (grupos → itens, com heading e
  * âncora inferior) que serve os DOIS lares do chrome sem flag:
  *
- *   - na sidebar do <AppShell>  → recolhe pra ícone-só (com tooltip) quando a sidebar
- *     recolhe, sozinho. Sabe que está NA sidebar (e se ela recolheu) pelo contexto de
- *     slot do AppShell (`useSidebarSlot`) — o app não passa isso em duas mãos.
- *   - dentro do conteúdo (o que o <SectionShell> faz) → sempre expandido (fora da sidebar,
- *     `useSidebarSlot` é null).
+ *   - dentro de <Sidebar> → recolhe pra ícone-só (com tooltip) junto com a coluna;
+ *   - fora de <Sidebar> → permanece expandido.
  *
  * "Tanto faz onde": o componente se adapta ao lugar, sem "modo" configurado.
  *
@@ -17,7 +14,7 @@
 
 import type { ReactNode } from 'react'
 import { cn } from '../../lib/cn.ts'
-import { useSidebarSlot } from './app-shell.tsx'
+import { useSidebarCollapsed } from './sidebar.tsx'
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '../primitives/tooltip.tsx'
 
 export interface ShellNavItem {
@@ -49,7 +46,7 @@ export interface ShellNavProps {
   footer?: ShellNavGroup[]
   /** Rótulo da landmark `<nav>`. */
   navLabel?: string
-  /** Classes da raiz (a coluna). A LARGURA vem do lar (sidebar do AppShell / SectionShell). */
+  /** Classes da raiz (a coluna). A largura vem do pane/sidebar que a contém. */
   className?: string
 }
 
@@ -109,8 +106,7 @@ function renderGroup(group: ShellNavGroup, gi: number, activeId: string | undefi
 }
 
 export function ShellNav({ groups, activeId, onSelect, heading, footer, navLabel = 'Navegação', className }: ShellNavProps): React.ReactElement {
-  // Recolhe SÓ na sidebar recolhida (o contexto de slot é null no conteúdo → sempre expandido).
-  const railed = useSidebarSlot()?.collapsed ?? false
+  const railed = useSidebarCollapsed()
 
   const body = (
     <div data-slot="shell-nav" className={cn('flex h-full min-h-0 flex-col', className)}>

package/src/ui/components/patterns/sidebar.tsx

@@ -5,6 +5,11 @@ import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '../pri
 interface SidebarContextValue { collapsed: boolean }
 const SidebarContext = createContext<SidebarContextValue | null>(null)
 
+/** Estado da Sidebar mais próxima. Uso interno por navegações que se adaptam ao colapso. */
+export function useSidebarCollapsed(): boolean {
+  return useContext(SidebarContext)?.collapsed ?? false
+}
+
 export interface SidebarProps {
   collapsed?: boolean
   /** Desliga a borda quando o Split já desenha a divisória. */
@@ -39,27 +44,21 @@ export function PaneFooter({ className, children }: { className?: string; childr
   return <div data-slot="pane-footer" className={cn('shrink-0 border-t border-border p-2', className)}>{children}</div>
 }
 
-/** @deprecated Use PaneHeader. */
-export const SidebarHeader = PaneHeader
-/** @deprecated Use PaneContent. */
-export const SidebarContent = PaneContent
-/** @deprecated Use PaneFooter. */
-export const SidebarFooter = PaneFooter
-
 export interface SidebarItemProps {
   label: string
   icon?: ReactNode
   badge?: ReactNode
   active?: boolean
   disabled?: boolean
+  className?: string
   onClick: () => void
 }
 
 /** Item de navegação que se adapta ao colapso da Sidebar em que está. */
-export function SidebarItem({ label, icon, badge, active = false, disabled = false, onClick }: SidebarItemProps): React.ReactElement {
-  const collapsed = useContext(SidebarContext)?.collapsed ?? false
+export function SidebarItem({ label, icon, badge, active = false, disabled = false, className, onClick }: SidebarItemProps): React.ReactElement {
+  const collapsed = useSidebarCollapsed()
   const button = (
-    <button type="button" disabled={disabled} aria-current={active ? 'page' : undefined} onClick={onClick} className={cn('flex items-center gap-2.5 rounded-md transition-colors', 'disabled:pointer-events-none disabled:opacity-40', collapsed ? 'mx-auto size-9 justify-center p-0' : 'w-full px-2.5 py-1.5 text-left text-sm', active ? 'bg-muted font-medium text-foreground' : 'text-foreground/80 hover:bg-muted/60')}>
+    <button type="button" disabled={disabled} aria-current={active ? 'page' : undefined} onClick={onClick} className={cn('flex items-center gap-2.5 rounded-md transition-colors', 'disabled:pointer-events-none disabled:opacity-40', collapsed ? 'mx-auto size-9 justify-center p-0' : 'w-full px-2.5 py-1.5 text-left text-sm', active ? 'bg-muted font-medium text-foreground' : 'text-foreground/80 hover:bg-muted/60', className)}>
       {icon !== undefined && <span className="flex shrink-0">{icon}</span>}
       {!collapsed && <span className="min-w-0 flex-1 truncate">{label}</span>}
       {!collapsed && badge !== undefined && <span className="shrink-0">{badge}</span>}
@@ -71,17 +70,43 @@ export function SidebarItem({ label, icon, badge, active = false, disabled = fal
 
 export interface SidebarNavGroup {
   label?: string
-  items: Array<Omit<SidebarItemProps, 'active' | 'onClick'> & { id: string }>
+  items?: SidebarNavItem[]
+  subgroups?: SidebarNavSubgroup[]
+}
+
+export type SidebarNavItem = Omit<SidebarItemProps, 'active' | 'onClick'> & { id: string }
+
+export interface SidebarNavSubgroup {
+  label?: string
+  items: SidebarNavItem[]
 }
 
+const titled = (label?: string): boolean => (label ?? '').trim() !== ''
+const subFilled = (subgroup: SidebarNavSubgroup): boolean => subgroup.items.length > 0
+const groupFilled = (group: SidebarNavGroup): boolean =>
+  (group.items?.length ?? 0) > 0 || (group.subgroups?.some(subFilled) ?? false)
+
 /** Navegação controlada para Sidebar. Header/footer continuam slots explícitos do pai. */
 export function SidebarNav({ groups, activeId, onSelect, navLabel = 'Navegação', className }: { groups: SidebarNavGroup[]; activeId?: string; onSelect: (id: string) => void; navLabel?: string; className?: string }): React.ReactElement {
-  const collapsed = useContext(SidebarContext)?.collapsed ?? false
+  const collapsed = useSidebarCollapsed()
+  const renderItem = (item: SidebarNavItem, nested = false): React.ReactElement => (
+    <SidebarItem
+      key={item.id}
+      {...item}
+      className={cn(nested && !collapsed && 'pl-6', item.className)}
+      active={item.id === activeId}
+      onClick={() => onSelect(item.id)}
+    />
+  )
   const body = (
     <nav aria-label={navLabel} data-slot="sidebar-nav" className={cn('space-y-4 p-2', className)}>
-      {groups.map((group, gi) => <div key={gi} className="space-y-0.5">
-        {!collapsed && group.label?.trim() && <div className="px-2.5 pb-1 text-xs font-medium text-muted-foreground/70">{group.label}</div>}
-        {group.items.map(({ id, ...item }) => <SidebarItem key={id} {...item} active={id === activeId} onClick={() => onSelect(id)} />)}
+      {groups.map((group, gi) => !groupFilled(group) ? null : <div key={gi} className="space-y-0.5">
+        {!collapsed && titled(group.label) && <div className="px-2.5 pb-1 text-xs font-medium text-muted-foreground/70">{group.label}</div>}
+        {group.items?.map((item) => renderItem(item))}
+        {group.subgroups?.map((subgroup, si) => !subFilled(subgroup) ? null : <div key={si} className="space-y-0.5">
+          {!collapsed && titled(subgroup.label) && <div className="pb-0.5 pl-4 pr-2.5 pt-1.5 text-[11px] font-medium text-muted-foreground/50">{subgroup.label}</div>}
+          {subgroup.items.map((item) => renderItem(item, titled(subgroup.label)))}
+        </div>)}
       </div>)}
     </nav>
   )

package/src/ui/components/primitives/alert-dialog.tsx

@@ -52,7 +52,7 @@ function AlertDialogContent({
       <AlertDialogPrimitive.Content
         data-slot="alert-dialog-content"
         className={cn(
-          "group/alert-dialog-content fixed top-[50%] left-[50%] z-50 grid w-full max-w-xs translate-x-[-50%] translate-y-[-50%] gap-4 rounded-dialog border border-border bg-background p-6 shadow-lg duration-200 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95",
+          "group/alert-dialog-content fixed top-[50%] left-[50%] z-50 grid w-full max-w-xs translate-x-[-50%] translate-y-[-50%] gap-4 rounded-xl border border-border bg-background p-6 shadow-lg duration-200 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95",
           className
         )}
         {...props}

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

@@ -76,7 +76,7 @@ function Calendar({
           defaultClassNames.dropdown_root
         ),
         dropdown: cn(
-          "absolute inset-0 bg-popover opacity-0",
+          "absolute inset-0 bg-popover text-popover-foreground opacity-0",
           defaultClassNames.dropdown
         ),
         caption_label: cn(

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

@@ -4,8 +4,8 @@ import { cn } from '../../lib/cn.ts'
 
 /**
  * Card — a superfície da casa: SÓ a casca (borda + raio + bg). Divergência DECLARADA vs
- * shadcn: `rounded-lg` (não `rounded-xl`), FLAT (sem `shadow-sm`) e SEM `flex/gap/py`
- * forçados. O upstream embute `py-6 gap-6` + slots `px-6`, o que briga com card-box
+ * shadcn: FLAT (sem `shadow-sm`) e SEM `flex/gap/py` forçados. O upstream embute
+ * `py-6 gap-6` + slots `px-6`, o que briga com card-box
  * simples (o `gap-6` do Card + o `space-y` do consumidor = espaçamento dobrado) — por isso
  * a casa hand-rollava. Aqui o padding mora no SLOT (Header/Content/Footer) ou no `className`
  * do consumidor (box simples) — mesmo modelo do Dialog.
@@ -24,7 +24,7 @@ export function Card({
 }): React.ReactElement {
   const Comp = asChild ? Slot : 'div'
   return (
-    <Comp data-slot="card" className={cn('rounded-card border border-border bg-card text-card-foreground shadow-sm', className)} {...props} />
+    <Comp data-slot="card" className={cn('rounded-xl border border-border bg-card text-card-foreground', className)} {...props} />
   )
 }
 

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

@@ -163,7 +163,7 @@ const ChatTranscript = React.memo(function ChatTranscript({
                       href={item.artifact.ref}
                       target="_blank"
                       rel="noreferrer"
-                      className="rounded-xl border bg-card px-3.5 py-2 text-sm underline-offset-2 hover:underline"
+                      className="rounded-xl border bg-card px-3.5 py-2 text-sm text-card-foreground underline-offset-2 hover:underline"
                     >
                       {item.artifact.title ?? item.artifact.ref}
                     </a>

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

@@ -34,7 +34,7 @@ export interface ComposerProps {
 
 /**
  * <Composer /> — a caixa de escrever da casa: textarea (Enter envia / Shift+Enter quebra
- * linha) numa pílula elevada (rounded-card + border + shadow-sm), com o enviar dentro.
+ * linha) numa pílula elevada (rounded-xl + border + shadow-sm), com o enviar dentro.
  * É o composer do `<Chat>` extraído pra ser reusável SOZINHO — o Maestro cria sessão com
  * ele (sem chat nenhum), e a GB prende seletores nele. Com `actions`, ganha uma barra
  * embaixo pros seletores; sem, é a linha única de sempre.
@@ -111,7 +111,7 @@ export function Composer({
         fire()
       }}
       className={cn(
-        'rounded-card border border-border bg-card shadow-sm transition focus-within:ring-2 focus-within:ring-primary/15',
+        'rounded-xl border border-border bg-card text-card-foreground shadow-sm transition',
         twoRow ? 'p-2' : 'relative flex items-end gap-2 p-2 pl-3.5',
         className,
       )}

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

@@ -54,7 +54,7 @@ export function DialogContent({
           // Superfície PURA: só a casca (borda/bg/raio/sombra) + coluna flex com teto de
           // altura. O padding mora nos SLOTS (Header/Body/Footer), não aqui — assim ninguém
           // precisa negar margem pra escapar de um p-6 embutido.
-          "fixed left-[50%] top-[50%] z-50 flex max-h-[85vh] w-full max-w-[calc(100%-2rem)] translate-x-[-50%] translate-y-[-50%] flex-col overflow-hidden rounded-dialog border border-border bg-card shadow-lg duration-200 outline-none data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 sm:max-w-lg",
+          "fixed left-[50%] top-[50%] z-50 flex max-h-[85vh] w-full max-w-[calc(100%-2rem)] translate-x-[-50%] translate-y-[-50%] flex-col overflow-hidden rounded-xl border border-border bg-card text-card-foreground shadow-lg duration-200 outline-none data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 sm:max-w-lg",
           className,
         )}
         {...props}