@majapisoftwares/ui 6.1.0 → 6.1.2

package/AGENTS.md

@@ -1,27 +1,27 @@
-# Padrão obrigatório do Workbench
-
-- Apps e catálogo usam a versão estável mais recente do Next.js (confira com `npm view next version` antes de mudar dependências). O catálogo (`catalog/`) é um app Next.js como qualquer outro, com a mesma estrutura do starter; não use Vite nem outro framework.
-- Toda mudança na biblioteca que afete apps entra no mesmo commit no starter (`starters/next-app`) e no catálogo. O starter sempre depende da versão atual da biblioteca (o teste `npm run test:starter` falha se divergir) e deve compilar e passar lint/typecheck/build com ela.
-- Todo app é bilíngue: inglês (`en`) e português (`pt-BR`). Textos de UI ficam em catálogos `defineMessages` com as duas línguas; nada de texto fixo em componentes. Use `Preferences`/`PreferenceControls` da biblioteca para idioma e tema.
-- Mantenha o texto mínimo: sem descrições, avisos ou rótulos que não ajudem a tarefa.
-- `patterns/data-table` (TanStack Table, vindo da Numa) é a única tabela de dados: filtros por coluna, ordenação múltipla, colunas reordenáveis/ocultáveis/redimensionáveis, seleção, persistência e estados. Melhorias de tabela são feitas aqui e chegam a todos os apps por versão; apps não mantêm cópias próprias.
-- Ao trazer componentes de outros apps, remova sobrescritas visuais (arredondamento, altura, sombra, padding, cores) e deixe os primitivos da biblioteca definirem o visual; containers usam os raios já adotados aqui (ex.: rounded-2xl em tabelas e listas).
-- Seleção usa sempre o Select (Base UI) da biblioteca; não use select nativo nem NativeSelect (o check:standards bloqueia).
-- Versionamento segue docs/VERSIONING.md (SemVer sobre a API pública). Prefira mudanças aditivas e deprecação a remoções; major só com aprovação explícita do responsável.
-- Teste localmente com portless (`npm run dev` já roda via portless; o catálogo abre em https://majapi-ui.localhost). Não use portas fixas nem localhost:PORT nas instruções.
-
-- Novos apps web devem partir de starters/next-app, criado por npm run create:app -- <diretorio-novo>. O starter usa a versão estável do Next.js fixada e validada no manifesto; atualizações devem manter lockfile, CI e revisão de compatibilidade.
-
-- A base de primitivas é shadcn sobre Base UI (base-luma), não Radix. Use render para composição e nativeButton=false quando Button renderizar Link/a. Preserve as fronteiras use client da biblioteca em consumidores Next.js.
-
-- Esta biblioteca pública é a base obrigatória de todos os apps atuais e futuros do Workbench, incluindo administrativos, dashboards, login e cadastro. Leia README.md e docs/STANDARDS.md antes de alterar interfaces.
-- Antes de criar UI em um app, procure o componente, variante ou padrão existente aqui. Reutilize-o diretamente como dependência.
-- Se faltar uma capacidade reutilizável, contribua primeiro para esta biblioteca: adicione uma API genérica, documente o comportamento e mostre o uso no catálogo. Depois atualize o app para o commit publicado.
-- Não copie componentes shadcn para apps, não faça forks locais e não use CSS, classes ou wrappers locais para corrigir cores, tipografia, tamanho, estados ou comportamento de um componente compartilhado.
-- Adaptações específicas de domínio e composição de layout ficam no app; capacidades compartilhadas, tokens e variantes ficam aqui. Não traga AWS, autenticação, secrets ou modelos de negócio para a biblioteca.
-- Use o CLI oficial shadcn para adicionar componentes. Preserve a licença upstream e registre adaptações em docs/STANDARDS.md. Imports internos da biblioteca devem ser relativos, sem aliases particulares do consumidor.
-- className nos apps é para layout. Mudanças visuais precisam de tokens, variantes ou padrões oficiais. Evite controles HTML crus quando houver um componente da biblioteca.
-- Todos os fluxos devem incluir estados carregando, vazio, erro, parcial e indisponível quando aplicáveis. Não esconda falhas ou altere dados para o exemplo parecer funcionar.
-- Preserve acessibilidade: nome acessível, foco visível, navegação por teclado, título e descrição de overlays, labels em campos, e texto junto aos estados.
-- Antes de publicar: npm run typecheck, npm run lint, npm run check:standards, npm run build, git diff --check e revisão visual em desktop/mobile. Teste comportamentos novos de risco, sem testes que apenas espelhem markup.
-- Publique código e evidências no GitHub e vincule os commits ao PLAN.md central. Registre breaking changes e migração antes de atualizar consumidores.
+# Padrão obrigatório da Majapi
+
+- Apps e catálogo usam a versão estável mais recente do Next.js (confira com `npm view next version` antes de mudar dependências). O catálogo (`catalog/`) é um app Next.js como qualquer outro, com a mesma estrutura do starter; não use Vite nem outro framework.
+- Toda mudança na biblioteca que afete apps entra no mesmo commit no starter (`starters/next-app`) e no catálogo. O starter sempre depende da versão atual da biblioteca (o teste `npm run test:starter` falha se divergir) e deve compilar e passar lint/typecheck/build com ela.
+- Todo app é bilíngue: inglês (`en`) e português (`pt-BR`). Textos de UI ficam em catálogos `defineMessages` com as duas línguas; nada de texto fixo em componentes. Use `Preferences`/`PreferenceControls` da biblioteca para idioma e tema.
+- Mantenha o texto mínimo: sem descrições, avisos ou rótulos que não ajudem a tarefa.
+- `patterns/data-table` (TanStack Table, vindo da Numa) é a única tabela de dados: filtros por coluna, ordenação múltipla, colunas reordenáveis/ocultáveis/redimensionáveis, seleção, persistência e estados. Melhorias de tabela são feitas aqui e chegam a todos os apps por versão; apps não mantêm cópias próprias.
+- Ao trazer componentes de outros apps, remova sobrescritas visuais (arredondamento, altura, sombra, padding, cores) e deixe os primitivos da biblioteca definirem o visual; containers usam os raios já adotados aqui (ex.: rounded-2xl em tabelas e listas).
+- Seleção usa sempre o Select (Base UI) da biblioteca; não use select nativo nem NativeSelect (o check:standards bloqueia).
+- Versionamento segue docs/VERSIONING.md (SemVer sobre a API pública). Prefira mudanças aditivas e deprecação a remoções; major só com aprovação explícita do responsável.
+- Teste localmente com portless (`npm run dev` já roda via portless; o catálogo abre em https://majapi-ui.localhost). Não use portas fixas nem localhost:PORT nas instruções.
+
+- Novos apps web devem partir de starters/next-app, criado por npm run create:app -- <diretorio-novo>. O starter usa a versão estável do Next.js fixada e validada no manifesto; atualizações devem manter lockfile, CI e revisão de compatibilidade.
+
+- A base de primitivas é shadcn sobre Base UI (base-luma), não Radix. Use render para composição e nativeButton=false quando Button renderizar Link/a. Preserve as fronteiras use client da biblioteca em consumidores Next.js.
+
+- Esta biblioteca pública é a base obrigatória de todos os apps atuais e futuros da Majapi, incluindo administrativos, dashboards, login e cadastro. Leia README.md e docs/STANDARDS.md antes de alterar interfaces.
+- Antes de criar UI em um app, procure o componente, variante ou padrão existente aqui. Reutilize-o diretamente como dependência.
+- Se faltar uma capacidade reutilizável, contribua primeiro para esta biblioteca: adicione uma API genérica, documente o comportamento e mostre o uso no catálogo. Depois atualize o app para o commit publicado.
+- Não copie componentes shadcn para apps, não faça forks locais e não use CSS, classes ou wrappers locais para corrigir cores, tipografia, tamanho, estados ou comportamento de um componente compartilhado.
+- Adaptações específicas de domínio e composição de layout ficam no app; capacidades compartilhadas, tokens e variantes ficam aqui. Não traga AWS, autenticação, secrets ou modelos de negócio para a biblioteca.
+- Use o CLI oficial shadcn para adicionar componentes. Preserve a licença upstream e registre adaptações em docs/STANDARDS.md. Imports internos da biblioteca devem ser relativos, sem aliases particulares do consumidor.
+- className nos apps é para layout. Mudanças visuais precisam de tokens, variantes ou padrões oficiais. Evite controles HTML crus quando houver um componente da biblioteca.
+- Todos os fluxos devem incluir estados carregando, vazio, erro, parcial e indisponível quando aplicáveis. Não esconda falhas ou altere dados para o exemplo parecer funcionar.
+- Preserve acessibilidade: nome acessível, foco visível, navegação por teclado, título e descrição de overlays, labels em campos, e texto junto aos estados.
+- Antes de publicar: npm run typecheck, npm run lint, npm run check:standards, npm run build, git diff --check e revisão visual em desktop/mobile. Teste comportamentos novos de risco, sem testes que apenas espelhem markup.
+- Publique código e evidências no GitHub e vincule os commits ao PLAN.md central. Registre breaking changes e migração antes de atualizar consumidores.

package/README.md

@@ -1,79 +1,79 @@
-# Majapi UI
-
-Biblioteca pública `@majapisoftwares/ui`, base obrigatória de código, interface e experiência de **todos os apps atuais e futuros do Workbench**, baseada em shadcn/ui (**Base UI / base-luma**), React e Tailwind CSS v4. Repositório: https://github.com/majapisoftwares/workbench-ui.
-
-## Regra central
-
-**Contribuir para a biblioteca antes de customizar o app.** Quando um produto precisa de uma variante ou comportamento reutilizável, a mudança deve ser implementada aqui com documentação e exemplo. O produto passa a consumir a versão publicada. Não mantenha cópias, forks ou overrides visuais locais dos componentes.
-
-Composição de páginas, lógica de domínio, dados e permissões pertencem ao app. Primitivos, variantes, tokens e comportamentos reutilizáveis pertencem à biblioteca. Consulte [AGENTS.md](AGENTS.md) e [docs/STANDARDS.md](docs/STANDARDS.md).
-
-## Criar um app Next.js
-
-O starter completo fica em [starters/next-app](starters/next-app), com **Next.js 16.4.3** (versão estável mais recente; mantenha atualizada), React, App Router, TypeScript, Tailwind e esta biblioteca já configurados. A dependência da UI é uma versão npm fixa; não depende de caminhos para este checkout.
-
-Dentro deste repositório:
-
-```sh
-npm run create:app -- ../meu-app
-cd ../meu-app
-npm ci
-npm run dev
-```
-
-O app gerado é bilíngue (en/pt-BR, textos em `src/messages.ts`) e roda via [portless](https://www.npmjs.com/package/portless) em `https://<nome>.localhost`. O comando não sobrescreve diretórios existentes. Copia dashboard, login, cadastro, carregamento/erro/404, regras de agentes, lockfile e CI, sem node_modules, builds ou secrets. Customize por componentes, props e slots. As telas de autenticação são demonstrativas e devem ser conectadas à autenticação real do produto.
-
-## Catálogo visual
-
-O catálogo em [catalog/](catalog) é um app Next.js com a mesma estrutura do starter, exportado estaticamente para S3 + CloudFront pelo workflow `deploy-catalog` a cada push na `main`.
-
-```powershell
-npm ci
-npm run dev
-```
-
-Abra https://majapi-ui.localhost (via portless). O catálogo permite revisar componentes, temas claro/escuro, tabela com busca/ordenação/paginação/filtro, detalhes e estados de vazio/erro/carregamento. Usa dados demonstrativos explícitos, sem AWS ou credenciais.
-
-## Consumir
-
-Pacote público **@majapisoftwares/ui@6.0.0**, publicado na organização npm existente. Instale com `npm install --save-exact @majapisoftwares/ui@6.0.0` e versione o lockfile. O pacote exporta fontes TSX para bundlers React/TypeScript (Vite ou Next.js), não para execução direta em Node sem transformação. O starter e o gerador permanecem neste repositório Git, separados do pacote npm da biblioteca.
-
-O catálogo público está em **https://ui.majapi.com**. A versão 6 muda AppShell, AdminDashboard e os templates de autenticação; veja [docs/MIGRATION-6.0.md](docs/MIGRATION-6.0.md). A versão 5 substitui a base 4.x com uma mudança incompatível de API e a base antes chamada @workbench/ui. Apps existentes em ^4 permanecem nessa linha até migração explícita.
-
-```tsx
-import { Button } from "@majapisoftwares/ui/components/button";
-import { DataTable } from "@majapisoftwares/ui/patterns/data-table";
-import { AdminDashboard } from "@majapisoftwares/ui/templates/admin-dashboard";
-import { AuthLayout } from "@majapisoftwares/ui/templates/auth-layout";
-import { LoginForm } from "@majapisoftwares/ui/templates/login-form";
-import { SignupForm } from "@majapisoftwares/ui/templates/signup-form";
-import {
-  Preferences,
-  PreferenceControls,
-} from "@majapisoftwares/ui/patterns/preferences";
-import { defineMessages, useMessages } from "@majapisoftwares/ui/lib/i18n";
-import "@majapisoftwares/ui/styles.css";
-```
-
-O CSS inclui os tokens, fontes locais e o Tailwind, com `@source` da biblioteca. O app precisa processar esse CSS com Tailwind v4.
-
-## Contribuir e validar
-
-A sidebar do `AppShell` tem três modos (expandida, compacta e escondida), redimensionável pela borda, com troca de modo pela largura, menu de clique direito e Ctrl/⌘+B. Templates iniciais: **AdminDashboard**, **AuthLayout**, **LoginForm** e **SignupForm**. Configure marca, navegação, textos, dados, ações e conteúdo por props/slots React. Variações de tema são definidas e documentadas na biblioteca. Formulários recebem callbacks tipados; autenticação real, validação no servidor, sessões e autorização pertencem ao app. O catálogo demonstra os templates sem enviar ou persistir senhas.
-
-1. Leia o padrão e procure o primitivo/padrão existente.
-2. Adicione uma API reutilizável ou variante oficial, com defaults compatíveis e textos em en/pt-BR.
-3. Documente motivos, estados e migração; adicione exemplo no catálogo e atualize o starter no mesmo commit.
-4. Valide tipos, lint, padrões, build, teclado e visual desktop/mobile.
-5. Publique o commit e atualize o consumidor para esse commit; registre no plano.
-
-```powershell
-npm run typecheck
-npm run lint
-npm run check:standards
-npm run build
-npm run test:starter
-git diff --check
-```
-
-Os componentes foram instalados pelo CLI shadcn 4.22.1, preset base-luma e Base UI 1.9.0. A versão 0.2 migra a base anterior Radix; veja [docs/MIGRATION-0.2.md](docs/MIGRATION-0.2.md). Atribuição upstream: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). O Cloud Manager é o primeiro consumidor real.
+# Majapi UI
+
+Biblioteca pública `@majapisoftwares/ui`, base obrigatória de código, interface e experiência de **todos os apps atuais e futuros da Majapi**, baseada em shadcn/ui (**Base UI / base-luma**), React e Tailwind CSS v4. Repositório: https://github.com/majapisoftwares/ui.
+
+## Regra central
+
+**Contribuir para a biblioteca antes de customizar o app.** Quando um produto precisa de uma variante ou comportamento reutilizável, a mudança deve ser implementada aqui com documentação e exemplo. O produto passa a consumir a versão publicada. Não mantenha cópias, forks ou overrides visuais locais dos componentes.
+
+Composição de páginas, lógica de domínio, dados e permissões pertencem ao app. Primitivos, variantes, tokens e comportamentos reutilizáveis pertencem à biblioteca. Consulte [AGENTS.md](AGENTS.md) e [docs/STANDARDS.md](docs/STANDARDS.md).
+
+## Criar um app Next.js
+
+O starter completo fica em [starters/next-app](starters/next-app), com **Next.js 16.4.3** (versão estável mais recente; mantenha atualizada), React, App Router, TypeScript, Tailwind e esta biblioteca já configurados. A dependência da UI é uma versão npm fixa; não depende de caminhos para este checkout.
+
+Dentro deste repositório:
+
+```sh
+npm run create:app -- ../meu-app
+cd ../meu-app
+npm ci
+npm run dev
+```
+
+O app gerado é bilíngue (en/pt-BR, textos em `src/messages.ts`) e roda via [portless](https://www.npmjs.com/package/portless) em `https://<nome>.localhost`. O comando não sobrescreve diretórios existentes. Copia dashboard, login, cadastro, carregamento/erro/404, regras de agentes, lockfile e CI, sem node_modules, builds ou secrets. Customize por componentes, props e slots. As telas de autenticação são demonstrativas e devem ser conectadas à autenticação real do produto.
+
+## Catálogo visual
+
+O catálogo em [catalog/](catalog) é um app Next.js com a mesma estrutura do starter, exportado estaticamente para S3 + CloudFront pelo workflow `deploy-catalog` a cada push na `main`.
+
+```powershell
+npm ci
+npm run dev
+```
+
+Abra https://majapi-ui.localhost (via portless). O catálogo permite revisar componentes, temas claro/escuro, tabela com busca/ordenação/paginação/filtro, detalhes e estados de vazio/erro/carregamento. Usa dados demonstrativos explícitos, sem AWS ou credenciais.
+
+## Consumir
+
+Pacote público **@majapisoftwares/ui@6.0.0**, publicado na organização npm existente. Instale com `npm install --save-exact @majapisoftwares/ui@6.0.0` e versione o lockfile. O pacote exporta fontes TSX para bundlers React/TypeScript (Vite ou Next.js), não para execução direta em Node sem transformação. O starter e o gerador permanecem neste repositório Git, separados do pacote npm da biblioteca.
+
+O catálogo público está em **https://ui.majapi.com**. A versão 6 muda AppShell, AdminDashboard e os templates de autenticação; veja [docs/MIGRATION-6.0.md](docs/MIGRATION-6.0.md). A versão 5 substitui a base 4.x com uma mudança incompatível de API e a base antes chamada @workbench/ui. Apps existentes em ^4 permanecem nessa linha até migração explícita.
+
+```tsx
+import { Button } from "@majapisoftwares/ui/components/button";
+import { DataTable } from "@majapisoftwares/ui/patterns/data-table";
+import { AdminDashboard } from "@majapisoftwares/ui/templates/admin-dashboard";
+import { AuthLayout } from "@majapisoftwares/ui/templates/auth-layout";
+import { LoginForm } from "@majapisoftwares/ui/templates/login-form";
+import { SignupForm } from "@majapisoftwares/ui/templates/signup-form";
+import {
+  Preferences,
+  PreferenceControls,
+} from "@majapisoftwares/ui/patterns/preferences";
+import { defineMessages, useMessages } from "@majapisoftwares/ui/lib/i18n";
+import "@majapisoftwares/ui/styles.css";
+```
+
+O CSS inclui os tokens, fontes locais e o Tailwind, com `@source` da biblioteca. O app precisa processar esse CSS com Tailwind v4.
+
+## Contribuir e validar
+
+A sidebar do `AppShell` tem três modos (expandida, compacta e escondida), redimensionável pela borda, com troca de modo pela largura, menu de clique direito e Ctrl/⌘+B. Templates iniciais: **AdminDashboard**, **AuthLayout**, **LoginForm** e **SignupForm**. Configure marca, navegação, textos, dados, ações e conteúdo por props/slots React. Variações de tema são definidas e documentadas na biblioteca. Formulários recebem callbacks tipados; autenticação real, validação no servidor, sessões e autorização pertencem ao app. O catálogo demonstra os templates sem enviar ou persistir senhas.
+
+1. Leia o padrão e procure o primitivo/padrão existente.
+2. Adicione uma API reutilizável ou variante oficial, com defaults compatíveis e textos em en/pt-BR.
+3. Documente motivos, estados e migração; adicione exemplo no catálogo e atualize o starter no mesmo commit.
+4. Valide tipos, lint, padrões, build, teclado e visual desktop/mobile.
+5. Publique o commit e atualize o consumidor para esse commit; registre no plano.
+
+```powershell
+npm run typecheck
+npm run lint
+npm run check:standards
+npm run build
+npm run test:starter
+git diff --check
+```
+
+Os componentes foram instalados pelo CLI shadcn 4.22.1, preset base-luma e Base UI 1.9.0. A versão 0.2 migra a base anterior Radix; veja [docs/MIGRATION-0.2.md](docs/MIGRATION-0.2.md). Atribuição upstream: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). O Cloud Manager é o primeiro consumidor real.

package/THIRD_PARTY_NOTICES.md

@@ -1,39 +1,39 @@
-# Third-party notices
-
-The primitives in src/components/ui were generated with shadcn/ui 4.22.1, base-luma preset (Base UI), from https://github.com/shadcn-ui/ui and https://ui.shadcn.com. They are distributed under the MIT License:
-
-MIT License
-
-Copyright (c) 2023 shadcn
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-src/components/ui/orb.tsx and orb.css are adapted from AICSS Orbs (https://github.com/kvnkld/aicss, registry https://www.aicss.dev/r/orbs.json): colors mapped to theme tokens, labels translated, CSS module turned into orb-prefixed global CSS. MIT License:
-
-MIT License
-
-Copyright (c) 2026 AICSS
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-Other dependencies retain their own licenses in their package metadata. This notice does not change ownership or licensing of Workbench-authored code.
+# Third-party notices
+
+The primitives in src/components/ui were generated with shadcn/ui 4.22.1, base-luma preset (Base UI), from https://github.com/shadcn-ui/ui and https://ui.shadcn.com. They are distributed under the MIT License:
+
+MIT License
+
+Copyright (c) 2023 shadcn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+src/components/ui/orb.tsx and orb.css are adapted from AICSS Orbs (https://github.com/kvnkld/aicss, registry https://www.aicss.dev/r/orbs.json): colors mapped to theme tokens, labels translated, CSS module turned into orb-prefixed global CSS. MIT License:
+
+MIT License
+
+Copyright (c) 2026 AICSS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Other dependencies retain their own licenses in their package metadata. This notice does not change ownership or licensing of Workbench-authored code.

package/components.json

@@ -1,25 +1,25 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "base-luma",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "",
-    "css": "src/styles.css",
-    "baseColor": "neutral",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "iconLibrary": "lucide",
-  "rtl": false,
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  },
-  "menuColor": "default",
-  "menuAccent": "subtle",
-  "registries": {}
-}
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-luma",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/styles.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

package/docs/MIGRATION-0.2.md

@@ -1,20 +1,20 @@
-# Migração 0.1 → 0.2: shadcn sobre Base UI
-
-A base inicial era radix-nova. A versão 0.2 usa base-nova e @base-ui/react 1.9.0, regenerados pelo CLI oficial shadcn em diretório limpo e adaptados para preservar os contratos do Workbench. Tokens, estilos compartilhados, variantes navigation/success/warning e nomes dos padrões permanecem.
-
-## Mudanças de API
-
-- Primitivas com composição usam render, não asChild. Exemplo: `<Button render={<Link href="/dashboard" />} nativeButton={false}>Dashboard</Button>`.
-- Sheet usa Dialog de Base UI, com Backdrop/Popup e composição render. Os padrões DetailsSheet e DetailList mantêm suas props.
-- Badge usa useRender/mergeProps de Base UI. Button usa ButtonPrimitive.Props. Considere essas mudanças incompatíveis para consumidores diretos das primitivas antigas.
-- Componentes e padrões interativos têm use client explícito. Dados vindos do servidor devem ser serializáveis; callbacks de UI e definição de colunas com funções ficam em Client Components.
-- Não importe radix-ui ou @radix-ui diretamente nos consumidores. O verificador de padrões detecta esses imports.
-
-## Atualizar um produto
-
-1. Atualize a dependência @majapisoftwares/ui para o commit publicado da versão 0.2 e regenere o lockfile.
-2. Substitua asChild por render e nativeButton=false em links/triggers não nativos.
-3. Preserve imports dos padrões compostos, evitando reimplementar o comportamento no produto.
-4. Execute typecheck, lint/padrões, build e verificações de navegação, foco, overlays, campos e telas menores.
-
-O starter Next.js é o caminho padrão para novos apps. Autenticação real e permissões continuam sendo responsabilidade do produto, sem fallback ou simulação de login.
+# Migração 0.1 → 0.2: shadcn sobre Base UI
+
+A base inicial era radix-nova. A versão 0.2 usa base-nova e @base-ui/react 1.9.0, regenerados pelo CLI oficial shadcn em diretório limpo e adaptados para preservar os contratos do Workbench. Tokens, estilos compartilhados, variantes navigation/success/warning e nomes dos padrões permanecem.
+
+## Mudanças de API
+
+- Primitivas com composição usam render, não asChild. Exemplo: `<Button render={<Link href="/dashboard" />} nativeButton={false}>Dashboard</Button>`.
+- Sheet usa Dialog de Base UI, com Backdrop/Popup e composição render. Os padrões DetailsSheet e DetailList mantêm suas props.
+- Badge usa useRender/mergeProps de Base UI. Button usa ButtonPrimitive.Props. Considere essas mudanças incompatíveis para consumidores diretos das primitivas antigas.
+- Componentes e padrões interativos têm use client explícito. Dados vindos do servidor devem ser serializáveis; callbacks de UI e definição de colunas com funções ficam em Client Components.
+- Não importe radix-ui ou @radix-ui diretamente nos consumidores. O verificador de padrões detecta esses imports.
+
+## Atualizar um produto
+
+1. Atualize a dependência @majapisoftwares/ui para o commit publicado da versão 0.2 e regenere o lockfile.
+2. Substitua asChild por render e nativeButton=false em links/triggers não nativos.
+3. Preserve imports dos padrões compostos, evitando reimplementar o comportamento no produto.
+4. Execute typecheck, lint/padrões, build e verificações de navegação, foco, overlays, campos e telas menores.
+
+O starter Next.js é o caminho padrão para novos apps. Autenticação real e permissões continuam sendo responsabilidade do produto, sem fallback ou simulação de login.

package/docs/MIGRATION-6.0.md

@@ -1,33 +1,33 @@
-# Migração para 6.0
-
-Visual padrão do shadcn (tema neutral, Geist), textos em inglês e português e nova sidebar.
-
-## Idiomas
-
-Envolva o app com `Preferences` (idioma + tema) ou `LocaleProvider`. Os textos embutidos da biblioteca seguem o idioma ativo. Textos do app vão em `defineMessages({ en, "pt-BR" })` e são lidos com `useMessages`.
-
-## AppShell / AdminDashboard
-
-- `brand`, `brandMark` → `logo` (marca quadrada, fica fixa em todos os modos) e `name` (texto que some em fade no modo compacto).
-- `navigation` passa a ser uma lista de grupos: `[{ label?, items: [...] }]`.
-- `context` → `header` (ex.: breadcrumb) e `actions` (ex.: `PreferenceControls`).
-- `defaultMode` (`open` | `compact` | `closed`) e `defaultWidth` opcionais; o estado é salvo no cookie `sidebar_state` (`parseSidebarCookie` lê no servidor).
-- `AdminDashboard`: `actions` da página → `pageActions`; `description` opcional.
-
-## Autenticação
-
-- `AuthLayout`: `title`, `description`, `aside`, `brandMark` removidos; `brand` e `footer` opcionais.
-- `LoginForm`/`SignupForm`: títulos e rótulos têm padrão traduzido; props de texto continuam aceitas para sobrescrever.
-
-## Outros
-
-- `PageHeader`: `eyebrow` removido, `description` opcional.
-- `DetailsSheet`: `description` opcional.
-- `DataTable` agora é a tabela completa da Numa, sobre TanStack Table:
-  - `columns` são `ColumnDef` do TanStack (`accessorKey`/`accessorFn`, `cell`, `meta: { label, align, filter }`); `rows` → `data`.
-  - Busca global embutida (`searchPlaceholder`, `initialGlobalFilter`); `searchValue`/`searchLabel`/`defaultQuery` saem.
-  - `onOpen`/`rowLabel` → `onRowClick`/`getRowLabel`; `filters` → `toolbarStart`/`toolbarEnd`/`toolbarBelow` (recebem a instância da tabela).
-  - Filtros por coluna (`text`, `multi` com incluir/excluir, `number-range`, `date-range`, `custom`), ordenação múltipla, colunas reordenáveis/ocultáveis/redimensionáveis, seleção de linhas e persistência em `localStorage` com `storageKey`.
-  - Estados mantidos: `loading`, `error` + `onRetry`, `warning`, `unavailable`, `emptyState`/`emptyMessage`.
-- Classes `wb-*` removidas.
-- `NativeSelect` removido: use `Select` (Base UI) com `items` para o rótulo do valor. O `check:ui` acusa imports de `native-select`. Variante `navigation` do Button removida.
+# Migração para 6.0
+
+Visual padrão do shadcn (tema neutral, Geist), textos em inglês e português e nova sidebar.
+
+## Idiomas
+
+Envolva o app com `Preferences` (idioma + tema) ou `LocaleProvider`. Os textos embutidos da biblioteca seguem o idioma ativo. Textos do app vão em `defineMessages({ en, "pt-BR" })` e são lidos com `useMessages`.
+
+## AppShell / AdminDashboard
+
+- `brand`, `brandMark` → `logo` (marca quadrada, fica fixa em todos os modos) e `name` (texto que some em fade no modo compacto).
+- `navigation` passa a ser uma lista de grupos: `[{ label?, items: [...] }]`.
+- `context` → `header` (ex.: breadcrumb) e `actions` (ex.: `PreferenceControls`).
+- `defaultMode` (`open` | `compact` | `closed`) e `defaultWidth` opcionais; o estado é salvo no cookie `sidebar_state` (`parseSidebarCookie` lê no servidor).
+- `AdminDashboard`: `actions` da página → `pageActions`; `description` opcional.
+
+## Autenticação
+
+- `AuthLayout`: `title`, `description`, `aside`, `brandMark` removidos; `brand` e `footer` opcionais.
+- `LoginForm`/`SignupForm`: títulos e rótulos têm padrão traduzido; props de texto continuam aceitas para sobrescrever.
+
+## Outros
+
+- `PageHeader`: `eyebrow` removido, `description` opcional.
+- `DetailsSheet`: `description` opcional.
+- `DataTable` agora é a tabela completa da Numa, sobre TanStack Table:
+  - `columns` são `ColumnDef` do TanStack (`accessorKey`/`accessorFn`, `cell`, `meta: { label, align, filter }`); `rows` → `data`.
+  - Busca global embutida (`searchPlaceholder`, `initialGlobalFilter`); `searchValue`/`searchLabel`/`defaultQuery` saem.
+  - `onOpen`/`rowLabel` → `onRowClick`/`getRowLabel`; `filters` → `toolbarStart`/`toolbarEnd`/`toolbarBelow` (recebem a instância da tabela).
+  - Filtros por coluna (`text`, `multi` com incluir/excluir, `number-range`, `date-range`, `custom`), ordenação múltipla, colunas reordenáveis/ocultáveis/redimensionáveis, seleção de linhas e persistência em `localStorage` com `storageKey`.
+  - Estados mantidos: `loading`, `error` + `onRetry`, `warning`, `unavailable`, `emptyState`/`emptyMessage`.
+- Classes `wb-*` removidas.
+- `NativeSelect` removido: use `Select` (Base UI) com `items` para o rótulo do valor. O `check:ui` acusa imports de `native-select`. Variante `navigation` do Button removida.

package/docs/NEXT-STARTER-VALIDATION.md

@@ -1,14 +1,14 @@
-# Validação do starter Next.js e Base UI
-
-- Next.js e create-next-app 16.4.3 conferidos no registry npm e na documentação oficial; React 19.3.1; UI 0.2 com shadcn base-nova e @base-ui/react 1.9.0.
-- Biblioteca regenerada pelo CLI oficial shadcn em diretório limpo, preservando tokens e variantes compartilhadas. Imports diretos de Radix removidos; fronteiras use client explícitas nas primitivas e padrões interativos.
-- Biblioteca: typecheck, ESLint, verificação de padrões e build Vite aprovados.
-- Starter: lint, typegen/TypeScript, check:ui e build Next.js de produção aprovados para /dashboard, /login e /signup.
-- Um projeto independente foi criado pelo comando create:app e validado com npm ci, lint, tipos, padrões e build. O projeto não depende de um checkout local da biblioteca.
-- Teste do gerador confirma nome/lockfile coerentes, rotas, regras de agentes, workflow, ausência de node_modules e recusa de sobrescrita de diretório existente.
-- npm pack --dry-run foi inspecionado: starter incluído, sem node_modules, .next, tsbuildinfo ou arquivos de ambiente no pacote.
-- Navegador com build de produção: dashboard, navegação para login/cadastro, painel de detalhes Base UI, devolução de foco ao fechar, console sem erros/warnings e revisão de cadastro em viewport mobile de 500px.
-- As telas usam dados demonstrativos explícitos. Nenhuma credencial foi enviada nem conta criada; autenticação real e proteção das rotas são integração do produto consumidor.
-- Cloud Manager atualizado para a mesma UI Base UI: build, types, padrões e 20 testes passaram.
-
-A CI pública valida tanto a biblioteca quanto o starter Next.js. O processo de produção local do starter foi aberto em http://127.0.0.1:4319 para revisão. Não houve deploy público nem provisionamento de infraestrutura.
+# Validação do starter Next.js e Base UI
+
+- Next.js e create-next-app 16.4.3 conferidos no registry npm e na documentação oficial; React 19.3.1; UI 0.2 com shadcn base-nova e @base-ui/react 1.9.0.
+- Biblioteca regenerada pelo CLI oficial shadcn em diretório limpo, preservando tokens e variantes compartilhadas. Imports diretos de Radix removidos; fronteiras use client explícitas nas primitivas e padrões interativos.
+- Biblioteca: typecheck, ESLint, verificação de padrões e build Vite aprovados.
+- Starter: lint, typegen/TypeScript, check:ui e build Next.js de produção aprovados para /dashboard, /login e /signup.
+- Um projeto independente foi criado pelo comando create:app e validado com npm ci, lint, tipos, padrões e build. O projeto não depende de um checkout local da biblioteca.
+- Teste do gerador confirma nome/lockfile coerentes, rotas, regras de agentes, workflow, ausência de node_modules e recusa de sobrescrita de diretório existente.
+- npm pack --dry-run foi inspecionado: starter incluído, sem node_modules, .next, tsbuildinfo ou arquivos de ambiente no pacote.
+- Navegador com build de produção: dashboard, navegação para login/cadastro, painel de detalhes Base UI, devolução de foco ao fechar, console sem erros/warnings e revisão de cadastro em viewport mobile de 500px.
+- As telas usam dados demonstrativos explícitos. Nenhuma credencial foi enviada nem conta criada; autenticação real e proteção das rotas são integração do produto consumidor.
+- Cloud Manager atualizado para a mesma UI Base UI: build, types, padrões e 20 testes passaram.
+
+A CI pública valida tanto a biblioteca quanto o starter Next.js. O processo de produção local do starter foi aberto em http://127.0.0.1:4319 para revisão. Não houve deploy público nem provisionamento de infraestrutura.

package/docs/STANDARDS.md

@@ -1,41 +1,41 @@
-# Padrão v1 de código e UI/UX
-
-Base atual: shadcn base-luma com @base-ui/react. Os componentes interativos expõem fronteiras use client para uso no Next.js App Router. A migração da API Radix está documentada em MIGRATION-0.2.md.
-
-## Arquitetura e código
-
-TypeScript em modo strict, React com componentes funcionais e composição. APIs genéricas tipadas; sem any para contornar contratos, estado derivado duplicado ou dependências de domínio na UI. Imports públicos por subpath, internos relativos. Dependências e lockfile versionados. Interface, acesso a dados, autorização e operações de infraestrutura permanecem separados. Entradas externas são validadas no servidor; erros e resultados incompletos são explícitos.
-
-## Base visual
-
-`src/styles.css` é a fonte dos tokens de cor, tipografia, raio, bordas, foco, estados e estrutura. Preset base-luma do shadcn (o mesmo da home de ui.shadcn.com: cantos bem arredondados, campos com fundo suave, sombras leves) sobre o tema neutral, fonte Geist, foco visível e espaço consistente. Cores são semânticas: background, foreground, primary, muted, destructive, success e warning. Temas claro/escuro preservam a semântica. Tokens e padrões podem evoluir nesta biblioteca, nunca por overrides locais em um produto.
-
-Primitivos shadcn ficam em src/components/ui (Button, Badge, Card, Input, Table, Sheet, Sidebar, Tooltip, DropdownMenu, ContextMenu, Breadcrumb, Avatar, Checkbox, Collapsible, Alert, Empty, Select, Separator, Skeleton, Tabs, Field e Label). Padrões compostos: AppShell (slots `sidebarHeader` e `footer`), WorkspaceSwitcher, UserMenu, PageHeader, MetricStrip, StatusBadge, DataTable, DetailsSheet, DetailList, Preferences, PreferenceControls e MajapiLogo. Templates React: AdminDashboard, AuthLayout, LoginForm e SignupForm. Marca, navegação, textos, dados, ações e slots são configuráveis. Todos os apps atuais e futuros devem consumir esta base pública; ela não conhece AWS ou outro domínio.
-
-## Comportamentos de UX
-
-- Ação primária destaca o objetivo; secundária usa outline/secondary; destrutiva usa variante própria e depende das autorizações do app.
-- Busca, filtros, ordenação por coluna e paginação seguem DataTable (TanStack Table; origem: tabela da Numa). Filtros por coluna usam `meta.filter`; preferências do usuário persistem por `storageKey`. Telas centradas em uma tabela usam `AppShell fillHeight` + `DataTable fillHeight`: a tabela ocupa a altura restante e rola internamente, com cabeçalho, busca e paginação sempre visíveis.
-- Áreas com rolagem interna usam `scroll-fade` do shadcn (só `scroll-fade-b` quando há cabeçalho fixo dentro do contêiner) e as barras de rolagem finas globais, que aparecem com o ponteiro sobre a área e seguem o tema (`color-scheme`).
-- Espaçamento da página em uma escala só: padding, gap entre seções e entre cards de 16px no mobile e 24px a partir de md; o cabeçalho da página e o da sidebar têm a mesma altura (56px). Filtros de domínio são slots tipados do app. Não reconstruir tabelas por tela. Persistência não é habilitada por padrão para evitar guardar buscas sensíveis; quando necessária, deve evoluir como capacidade compartilhada com controle explícito.
-- Estados com texto e cor: sucesso, aviso, erro e desconhecido. Nunca traduzir ausência de informação em zero ou sucesso.
-- Carregamento usa Skeleton, vazio usa Empty, falhas usam Alert e detalhes usam DetailsSheet com título, descrição, foco preso ao overlay, Escape e devolução do foco ao fechar.
-- Em telas pequenas, controles têm texto de pelo menos 16px e alvo de 44px, navegação se reorganiza e tabelas têm rolagem interna, sem rolagem horizontal da página.
-- Preferência por movimento reduzido é respeitada. A ordem de leitura deve acompanhar a ordem visual. Ícones sozinhos exigem nome acessível.
-- Distinguir dados demonstrativos de dados reais; mostrar observação e cobertura em telas de infraestrutura. Todo texto existe em inglês e português (`defineMessages`); texto mínimo, sem descrições que não ajudem a tarefa.
-
-## Evolução sem customizações isoladas
-
-Uma necessidade reutilizável entra na biblioteca por prop, variante, token ou novo padrão documentado. Não adicionar props específicas como awsAccountId a componentes genéricos. Novas variantes preservam defaults; mudanças incompatíveis exigem versão/migração explícitas e atualização coordenada dos consumidores. A versão semântica identifica a API, e o commit Git fixo identifica o código efetivamente consumido.
-
-AGENTS.md nos apps exige contribuição upstream antes de uso. O verificador estático bloqueia primitivas locais e cores avulsas em consumidores; não substitui revisão humana de design, acessibilidade e comportamento. O catálogo e o primeiro consumidor devem ser revisados em navegador.
-
-## Adaptações do upstream
-
-- Imports internos relativos e `"use client"` são aplicados por `npm run normalize:ui` após o CLI do shadcn.
-- Sheet traduz o nome acessível do fechamento pelo idioma ativo.
-- Sidebar: três modos (open/compact/closed), largura redimensionável (208–448px) com troca de modo por largura, menu de clique direito, tooltip que fecha ao clicar e textos traduzidos.
-- use-mobile usa useSyncExternalStore (compatível com SSR e com a regra de hooks).
-- Field usa imports relativos. Button assume type=button para evitar submissões acidentais; formulários declaram type=submit. Badge inclui variantes success e warning reutilizadas por StatusBadge.
-- Tokens de identidade, estados semânticos e padrões compostos são mantidos aqui.
-- Mudanças posteriores no upstream devem ser avaliadas com o diff do CLI, preservando estas decisões e o contrato público.
+# Padrão v1 de código e UI/UX
+
+Base atual: shadcn base-luma com @base-ui/react. Os componentes interativos expõem fronteiras use client para uso no Next.js App Router. A migração da API Radix está documentada em MIGRATION-0.2.md.
+
+## Arquitetura e código
+
+TypeScript em modo strict, React com componentes funcionais e composição. APIs genéricas tipadas; sem any para contornar contratos, estado derivado duplicado ou dependências de domínio na UI. Imports públicos por subpath, internos relativos. Dependências e lockfile versionados. Interface, acesso a dados, autorização e operações de infraestrutura permanecem separados. Entradas externas são validadas no servidor; erros e resultados incompletos são explícitos.
+
+## Base visual
+
+`src/styles.css` é a fonte dos tokens de cor, tipografia, raio, bordas, foco, estados e estrutura. Preset base-luma do shadcn (o mesmo da home de ui.shadcn.com: cantos bem arredondados, campos com fundo suave, sombras leves) sobre o tema neutral, fonte Geist, foco visível e espaço consistente. Cores são semânticas: background, foreground, primary, muted, destructive, success e warning. Temas claro/escuro preservam a semântica. Tokens e padrões podem evoluir nesta biblioteca, nunca por overrides locais em um produto.
+
+Primitivos shadcn ficam em src/components/ui (Button, Badge, Card, Input, Table, Sheet, Sidebar, Tooltip, DropdownMenu, ContextMenu, Breadcrumb, Avatar, Checkbox, Collapsible, Alert, Empty, Select, Separator, Skeleton, Tabs, Field e Label). Padrões compostos: AppShell (slots `sidebarHeader` e `footer`), WorkspaceSwitcher, UserMenu, PageHeader, MetricStrip, StatusBadge, DataTable, DetailsSheet, DetailList, Preferences, PreferenceControls e MajapiLogo. Templates React: AdminDashboard, AuthLayout, LoginForm e SignupForm. Marca, navegação, textos, dados, ações e slots são configuráveis. Todos os apps atuais e futuros devem consumir esta base pública; ela não conhece AWS ou outro domínio.
+
+## Comportamentos de UX
+
+- Ação primária destaca o objetivo; secundária usa outline/secondary; destrutiva usa variante própria e depende das autorizações do app.
+- Busca, filtros, ordenação por coluna e paginação seguem DataTable (TanStack Table; origem: tabela da Numa). Filtros por coluna usam `meta.filter`; preferências do usuário persistem por `storageKey`. Telas centradas em uma tabela usam `AppShell fillHeight` + `DataTable fillHeight`: a tabela ocupa a altura restante e rola internamente, com cabeçalho, busca e paginação sempre visíveis.
+- Áreas com rolagem interna usam `scroll-fade` do shadcn (só `scroll-fade-b` quando há cabeçalho fixo dentro do contêiner) e as barras de rolagem finas globais, que aparecem com o ponteiro sobre a área e seguem o tema (`color-scheme`).
+- Espaçamento da página em uma escala só: padding, gap entre seções e entre cards de 16px no mobile e 24px a partir de md; o cabeçalho da página e o da sidebar têm a mesma altura (56px). Filtros de domínio são slots tipados do app. Não reconstruir tabelas por tela. Persistência não é habilitada por padrão para evitar guardar buscas sensíveis; quando necessária, deve evoluir como capacidade compartilhada com controle explícito.
+- Estados com texto e cor: sucesso, aviso, erro e desconhecido. Nunca traduzir ausência de informação em zero ou sucesso.
+- Carregamento usa Skeleton, vazio usa Empty, falhas usam Alert e detalhes usam DetailsSheet com título, descrição, foco preso ao overlay, Escape e devolução do foco ao fechar.
+- Em telas pequenas, controles têm texto de pelo menos 16px e alvo de 44px, navegação se reorganiza e tabelas têm rolagem interna, sem rolagem horizontal da página.
+- Preferência por movimento reduzido é respeitada. A ordem de leitura deve acompanhar a ordem visual. Ícones sozinhos exigem nome acessível.
+- Distinguir dados demonstrativos de dados reais; mostrar observação e cobertura em telas de infraestrutura. Todo texto existe em inglês e português (`defineMessages`); texto mínimo, sem descrições que não ajudem a tarefa.
+
+## Evolução sem customizações isoladas
+
+Uma necessidade reutilizável entra na biblioteca por prop, variante, token ou novo padrão documentado. Não adicionar props específicas como awsAccountId a componentes genéricos. Novas variantes preservam defaults; mudanças incompatíveis exigem versão/migração explícitas e atualização coordenada dos consumidores. A versão semântica identifica a API, e o commit Git fixo identifica o código efetivamente consumido.
+
+AGENTS.md nos apps exige contribuição upstream antes de uso. O verificador estático bloqueia primitivas locais e cores avulsas em consumidores; não substitui revisão humana de design, acessibilidade e comportamento. O catálogo e o primeiro consumidor devem ser revisados em navegador.
+
+## Adaptações do upstream
+
+- Imports internos relativos e `"use client"` são aplicados por `npm run normalize:ui` após o CLI do shadcn.
+- Sheet traduz o nome acessível do fechamento pelo idioma ativo.
+- Sidebar: três modos (open/compact/closed), largura redimensionável (208–448px) com troca de modo por largura, menu de clique direito, tooltip que fecha ao clicar e textos traduzidos.
+- use-mobile usa useSyncExternalStore (compatível com SSR e com a regra de hooks).
+- Field usa imports relativos. Button assume type=button para evitar submissões acidentais; formulários declaram type=submit. Badge inclui variantes success e warning reutilizadas por StatusBadge.
+- Tokens de identidade, estados semânticos e padrões compostos são mantidos aqui.
+- Mudanças posteriores no upstream devem ser avaliadas com o diff do CLI, preservando estas decisões e o contrato público.