@majapisoftwares/ui 6.3.0 → 6.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +27 -27
- package/README.md +79 -79
- package/THIRD_PARTY_NOTICES.md +39 -39
- package/components.json +25 -25
- package/docs/MIGRATION-0.2.md +20 -20
- package/docs/MIGRATION-6.0.md +33 -33
- package/docs/NEXT-STARTER-VALIDATION.md +14 -14
- package/docs/STANDARDS.md +65 -51
- package/docs/VALIDATION.md +11 -11
- package/docs/VERSIONING.md +32 -28
- package/docs/validation/preference-titles.md +22 -22
- package/package.json +91 -89
- package/scripts/check-standards.mjs +41 -41
- package/src/components/ui/accordion.tsx +82 -82
- package/src/components/ui/alert-dialog.tsx +187 -187
- package/src/components/ui/alert.tsx +77 -77
- package/src/components/ui/attachment.tsx +209 -0
- package/src/components/ui/avatar.tsx +108 -108
- package/src/components/ui/badge.tsx +55 -55
- package/src/components/ui/breadcrumb.tsx +125 -125
- package/src/components/ui/bubble.tsx +129 -0
- package/src/components/ui/button-group.tsx +89 -89
- package/src/components/ui/button.tsx +59 -59
- package/src/components/ui/card.tsx +101 -101
- package/src/components/ui/checkbox.tsx +27 -27
- package/src/components/ui/collapsible.tsx +21 -21
- package/src/components/ui/context-menu.tsx +271 -271
- package/src/components/ui/dialog.tsx +161 -161
- package/src/components/ui/dropdown-menu.tsx +271 -271
- package/src/components/ui/empty.tsx +105 -105
- package/src/components/ui/field.tsx +238 -238
- package/src/components/ui/hover-card.tsx +50 -50
- package/src/components/ui/input-group.tsx +155 -155
- package/src/components/ui/input.tsx +21 -21
- package/src/components/ui/item.tsx +203 -0
- package/src/components/ui/kbd.tsx +28 -28
- package/src/components/ui/label.tsx +19 -19
- package/src/components/ui/message-scroller.tsx +166 -0
- package/src/components/ui/message.tsx +93 -0
- package/src/components/ui/orb.css +1002 -1002
- package/src/components/ui/orb.tsx +752 -752
- package/src/components/ui/popover.tsx +89 -89
- package/src/components/ui/progress.tsx +82 -82
- package/src/components/ui/radio-group.tsx +37 -37
- package/src/components/ui/scroll-area.tsx +54 -54
- package/src/components/ui/select.tsx +204 -204
- package/src/components/ui/separator.tsx +24 -24
- package/src/components/ui/sheet.tsx +139 -139
- package/src/components/ui/sidebar.tsx +1048 -1048
- package/src/components/ui/skeleton.tsx +15 -15
- package/src/components/ui/slider.tsx +53 -53
- package/src/components/ui/sonner.tsx +44 -44
- package/src/components/ui/spinner.tsx +32 -32
- package/src/components/ui/switch.tsx +31 -31
- package/src/components/ui/table.tsx +121 -121
- package/src/components/ui/tabs.tsx +81 -81
- package/src/components/ui/textarea.tsx +19 -19
- package/src/components/ui/toggle-group.tsx +89 -89
- package/src/components/ui/toggle.tsx +44 -44
- package/src/components/ui/tooltip.tsx +65 -65
- package/src/components/ui/trace.tsx +163 -0
- package/src/hooks/use-mobile.ts +20 -20
- package/src/hooks/use-streamed-text.ts +64 -0
- package/src/lib/i18n.tsx +151 -109
- package/src/lib/utils.ts +1 -1
- package/src/patterns/app-shell.tsx +237 -237
- package/src/patterns/chat-markdown.tsx +72 -0
- package/src/patterns/chat-trace.tsx +200 -0
- package/src/patterns/chat.tsx +317 -0
- package/src/patterns/data-table.tsx +2492 -2492
- package/src/patterns/filter-tabs.tsx +53 -53
- package/src/patterns/majapi-logo.tsx +32 -32
- package/src/patterns/page-header.tsx +62 -62
- package/src/patterns/prompt-input.tsx +364 -0
- package/src/patterns/status-badge.tsx +24 -24
- package/src/patterns/user-menu.tsx +218 -218
- package/src/patterns/workspace-switcher.tsx +176 -176
- package/src/styles.css +170 -165
- package/src/templates/admin-dashboard.tsx +44 -44
- package/src/templates/auth-layout.tsx +30 -30
- package/src/templates/signup-form.tsx +177 -177
package/docs/STANDARDS.md
CHANGED
|
@@ -1,51 +1,65 @@
|
|
|
1
|
-
# Padrão v1 de código e UI/UX
|
|
2
|
-
|
|
3
|
-
`LoginForm` aceita `mode="providers"` com `alternative` obrigatório para autenticação exclusiva por OAuth/SSO, sem campos de senha nem callback de credenciais. O modo padrão continua `credentials`. Catálogo e starter demonstram em `/login/provider`. A identidade autenticada usa `UserMenu` no slot `footer` do `AppShell`; tema, idioma e saída permanecem no padrão compartilhado.
|
|
4
|
-
|
|
5
|
-
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.
|
|
6
|
-
|
|
7
|
-
## Arquitetura e código
|
|
8
|
-
|
|
9
|
-
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.
|
|
10
|
-
|
|
11
|
-
## Base visual
|
|
12
|
-
|
|
13
|
-
`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.
|
|
14
|
-
|
|
15
|
-
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.
|
|
16
|
-
|
|
17
|
-
## Comportamentos de UX
|
|
18
|
-
|
|
19
|
-
DataTable mantém os resets de paginação fora da avaliação de row models durante render. Mudanças de dados aplicam o reset após commit; filtros e ordenação preservam os handlers oficiais, e paginação manual permanece controlada pelo consumidor. Não adicione resets assíncronos durante render para contornar Suspense/StrictMode. `npm run test:data-table` verifica montagem concorrente, avanço de página e substituição dos dados.
|
|
20
|
-
|
|
21
|
-
- Ação primária destaca o objetivo; secundária usa outline/secondary; destrutiva usa variante própria e depende das autorizações do app.
|
|
22
|
-
- 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.
|
|
23
|
-
- Á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`).
|
|
24
|
-
- 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.
|
|
25
|
-
- Não repetir o que já está na tela: o breadcrumb nomeia a página, então ela não ganha um título `PageHeader` com o mesmo nome. Na sidebar, o grupo abre a página principal da ferramenta, que não aparece de novo como subitem. O mesmo vale para títulos de diálogo, rótulos e descrições que repetem um texto visível.
|
|
26
|
-
- Rótulos curtos, em uma linha: botões, itens de menu, abas e badges não quebram linha. Menus se ajustam à largura do conteúdo (não à do botão que os abre); se o texto não couber, encurte-o.
|
|
27
|
-
- Estados com texto e cor: sucesso, aviso, erro e desconhecido. Nunca traduzir ausência de informação em zero ou sucesso.
|
|
28
|
-
- 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.
|
|
29
|
-
- 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.
|
|
30
|
-
- Preferência por movimento reduzido é respeitada. A ordem de leitura deve acompanhar a ordem visual. Ícones sozinhos exigem nome acessível.
|
|
31
|
-
- 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.
|
|
32
|
-
|
|
33
|
-
## Evolução sem customizações isoladas
|
|
34
|
-
|
|
35
|
-
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.
|
|
36
|
-
|
|
37
|
-
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.
|
|
38
|
-
|
|
39
|
-
## Adaptações do upstream
|
|
40
|
-
|
|
41
|
-
- Imports internos relativos e `"use client"` são aplicados por `npm run normalize:ui` após o CLI do shadcn.
|
|
42
|
-
- Sheet traduz o nome acessível do fechamento pelo idioma ativo.
|
|
43
|
-
- 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.
|
|
44
|
-
- use-mobile usa useSyncExternalStore (compatível com SSR e com a regra de hooks).
|
|
45
|
-
- 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.
|
|
46
|
-
- Tokens de identidade, estados semânticos e padrões compostos são mantidos aqui.
|
|
47
|
-
- Mudanças posteriores no upstream devem ser avaliadas com o diff do CLI, preservando estas decisões e o contrato público.
|
|
48
|
-
|
|
49
|
-
##
|
|
50
|
-
|
|
51
|
-
|
|
1
|
+
# Padrão v1 de código e UI/UX
|
|
2
|
+
|
|
3
|
+
`LoginForm` aceita `mode="providers"` com `alternative` obrigatório para autenticação exclusiva por OAuth/SSO, sem campos de senha nem callback de credenciais. O modo padrão continua `credentials`. Catálogo e starter demonstram em `/login/provider`. A identidade autenticada usa `UserMenu` no slot `footer` do `AppShell`; tema, idioma e saída permanecem no padrão compartilhado.
|
|
4
|
+
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
## Arquitetura e código
|
|
8
|
+
|
|
9
|
+
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.
|
|
10
|
+
|
|
11
|
+
## Base visual
|
|
12
|
+
|
|
13
|
+
`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.
|
|
14
|
+
|
|
15
|
+
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.
|
|
16
|
+
|
|
17
|
+
## Comportamentos de UX
|
|
18
|
+
|
|
19
|
+
DataTable mantém os resets de paginação fora da avaliação de row models durante render. Mudanças de dados aplicam o reset após commit; filtros e ordenação preservam os handlers oficiais, e paginação manual permanece controlada pelo consumidor. Não adicione resets assíncronos durante render para contornar Suspense/StrictMode. `npm run test:data-table` verifica montagem concorrente, avanço de página e substituição dos dados.
|
|
20
|
+
|
|
21
|
+
- Ação primária destaca o objetivo; secundária usa outline/secondary; destrutiva usa variante própria e depende das autorizações do app.
|
|
22
|
+
- 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.
|
|
23
|
+
- Á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`).
|
|
24
|
+
- 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.
|
|
25
|
+
- Não repetir o que já está na tela: o breadcrumb nomeia a página, então ela não ganha um título `PageHeader` com o mesmo nome. Na sidebar, o grupo abre a página principal da ferramenta, que não aparece de novo como subitem. O mesmo vale para títulos de diálogo, rótulos e descrições que repetem um texto visível.
|
|
26
|
+
- Rótulos curtos, em uma linha: botões, itens de menu, abas e badges não quebram linha. Menus se ajustam à largura do conteúdo (não à do botão que os abre); se o texto não couber, encurte-o.
|
|
27
|
+
- Estados com texto e cor: sucesso, aviso, erro e desconhecido. Nunca traduzir ausência de informação em zero ou sucesso.
|
|
28
|
+
- 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.
|
|
29
|
+
- 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.
|
|
30
|
+
- Preferência por movimento reduzido é respeitada. A ordem de leitura deve acompanhar a ordem visual. Ícones sozinhos exigem nome acessível.
|
|
31
|
+
- 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.
|
|
32
|
+
|
|
33
|
+
## Evolução sem customizações isoladas
|
|
34
|
+
|
|
35
|
+
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.
|
|
36
|
+
|
|
37
|
+
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.
|
|
38
|
+
|
|
39
|
+
## Adaptações do upstream
|
|
40
|
+
|
|
41
|
+
- Imports internos relativos e `"use client"` são aplicados por `npm run normalize:ui` após o CLI do shadcn.
|
|
42
|
+
- Sheet traduz o nome acessível do fechamento pelo idioma ativo.
|
|
43
|
+
- 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.
|
|
44
|
+
- use-mobile usa useSyncExternalStore (compatível com SSR e com a regra de hooks).
|
|
45
|
+
- 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.
|
|
46
|
+
- Tokens de identidade, estados semânticos e padrões compostos são mantidos aqui.
|
|
47
|
+
- Mudanças posteriores no upstream devem ser avaliadas com o diff do CLI, preservando estas decisões e o contrato público.
|
|
48
|
+
|
|
49
|
+
## Chat com agentes
|
|
50
|
+
|
|
51
|
+
Base do shadcn AI Elements (Base UI) instalada pelo CLI: `message-scroller` (`@shadcn/react`), `message`, `bubble`, `attachment`, `trace` e `item`. Padrões compostos, unindo o upstream ao chat da Numa:
|
|
52
|
+
|
|
53
|
+
- `patterns/chat`: `Chat` (layout em `AppShell fillHeight`), `ChatMessages` (Message Scroller com `autoScroll` e `defaultScrollPosition="last-anchor"`; cada linha em `MessageScrollerItem`, turnos da pessoa com `scrollAnchor`), `ChatComposer` (alinhado à transcrição mesmo com a calha da barra de rolagem, como na Numa), `ChatMessage` (pessoa em Bubble `muted` no fim; agente sem caixa), `MessageActions`/`MessageAction`/`CopyMessageAction` (ícones com tooltip; feedback com `aria-pressed`), `TypingIndicator` (Orb com texto) e `Suggestions`.
|
|
54
|
+
- `patterns/prompt-input`: InputGroup com Enter envia e Shift+Enter quebra linha (respeitando IME), anexar/colar/soltar arquivos com Attachment, foco preservado ao enviar, botão Parar durante `submitted`/`streaming` e rascunho restaurado quando o envio rejeita (Numa).
|
|
55
|
+
- `patterns/chat-trace`: `ChatTrace`, `Reasoning` (abre enquanto pensa, fecha ao terminar salvo se a pessoa alternou; vários passos são várias linhas), `Tool` (estados pending/running/done/error/denied, saída sob demanda) e `Confirmation` (Aprovar/Negar; depois de respondida vira `Tool`).
|
|
56
|
+
- `patterns/chat-markdown`: `ChatMarkdown` com Streamdown (sanitiza a saída do modelo, completa markdown incompleto durante o streaming e traduz os controles). Substitui o react-markdown da Numa.
|
|
57
|
+
- `hooks/use-streamed-text`: revela progressivamente uma resposta que chega inteira (Numa), respeitando movimento reduzido.
|
|
58
|
+
|
|
59
|
+
Erros de resposta aparecem na própria mensagem (Bubble `destructive`) com Tentar novamente; erros de ações fora da conversa seguem no toast. O catálogo demonstra em `/chat` (conversa com raciocínio, ferramentas, aprovação, erro e retry) e `/chat/new` (vazio com sugestões).
|
|
60
|
+
|
|
61
|
+
Adaptações: `MessageScrollerItem` usa `-m-2 p-2` (e `MessageScrollerContent`, `p-2`) porque `content-visibility: auto` sempre aplica contenção de pintura e cortava sombras e anéis de foco na borda de cada linha; não remova essa margem nem coloque itens em contêineres sem o padding correspondente. `message-scroller` também traduz o nome da região e do botão, troca utilitários de barra de rolagem que não existem aqui por `[scrollbar-gutter:stable]` e exporta `useMessageScrollerGutterWidth`; `attachment` usa `no-scrollbar`. `styles.css` importa `streamdown/styles.css` e adiciona o `@source` do Streamdown. `hast-util-raw` 9.2 exige `parse5` 8.1+; mantenha o lockfile sem `parse5` 8.0.
|
|
62
|
+
|
|
63
|
+
## Contextual tool navigation
|
|
64
|
+
|
|
65
|
+
AppShell navigation items accept optional `children` for one level of related tool views. Only the active tool expands. The current destination alone receives aria-current. Navigation closes the mobile sidebar after selection. Sidebar subitems have 44px touch targets on mobile. Use route navigation here; reserve FilterTabs for filters or views of the current dataset. Use `fillHeight` for contained table/chat pages and ordinary page flow for long forms and card collections.
|
package/docs/VALIDATION.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
# Validação da base v1
|
|
2
|
-
|
|
3
|
-
- TypeScript strict, ESLint sem warnings, verificador de padrões, Prettier e build Vite aprovados.
|
|
4
|
-
- CI pública executa npm ci, typecheck, lint, check:standards e build, sem secrets ou acesso à AWS.
|
|
5
|
-
- Catálogo renderizado em navegador real em desktop e mobile (viewport de 500px), incluindo template administrativo, login e cadastro.
|
|
6
|
-
- Cadastro demonstrativo: confirmação divergente de senha foi bloqueada, campo marcado aria-invalid e erro anunciado por role=alert. Nenhuma informação foi enviada ou persistida.
|
|
7
|
-
- DataTable demonstrativa possui busca, filtro por região, ordenação e paginação; DetailsSheet usa Radix com título e descrição. Estados de vazio, erro e carregamento estão expostos no catálogo.
|
|
8
|
-
- O primeiro consumidor real é o Cloud Manager, que importa a biblioteca por commit público fixo e continua exibindo o inventário real AWS. Detalhes de infraestrutura e credenciais permanecem no repo privado do produto.
|
|
9
|
-
- Ajustes de navegação e toolbar mobile foram feitos nos componentes compartilhados e publicados antes de atualizar o consumidor, exercitando a regra de contribuição upstream.
|
|
10
|
-
|
|
11
|
-
Esta revisão é uma validação inicial de implementação, não uma certificação de acessibilidade nem prova de integração de autenticação. Backend de login/cadastro pertence a cada produto e deve ser validado pelo consumidor.
|
|
1
|
+
# Validação da base v1
|
|
2
|
+
|
|
3
|
+
- TypeScript strict, ESLint sem warnings, verificador de padrões, Prettier e build Vite aprovados.
|
|
4
|
+
- CI pública executa npm ci, typecheck, lint, check:standards e build, sem secrets ou acesso à AWS.
|
|
5
|
+
- Catálogo renderizado em navegador real em desktop e mobile (viewport de 500px), incluindo template administrativo, login e cadastro.
|
|
6
|
+
- Cadastro demonstrativo: confirmação divergente de senha foi bloqueada, campo marcado aria-invalid e erro anunciado por role=alert. Nenhuma informação foi enviada ou persistida.
|
|
7
|
+
- DataTable demonstrativa possui busca, filtro por região, ordenação e paginação; DetailsSheet usa Radix com título e descrição. Estados de vazio, erro e carregamento estão expostos no catálogo.
|
|
8
|
+
- O primeiro consumidor real é o Cloud Manager, que importa a biblioteca por commit público fixo e continua exibindo o inventário real AWS. Detalhes de infraestrutura e credenciais permanecem no repo privado do produto.
|
|
9
|
+
- Ajustes de navegação e toolbar mobile foram feitos nos componentes compartilhados e publicados antes de atualizar o consumidor, exercitando a regra de contribuição upstream.
|
|
10
|
+
|
|
11
|
+
Esta revisão é uma validação inicial de implementação, não uma certificação de acessibilidade nem prova de integração de autenticação. Backend de login/cadastro pertence a cada produto e deve ser validado pelo consumidor.
|
package/docs/VERSIONING.md
CHANGED
|
@@ -1,28 +1,32 @@
|
|
|
1
|
-
# Versionamento
|
|
2
|
-
|
|
3
|
-
`@majapisoftwares/ui` segue [SemVer](https://semver.org) sobre a **API pública**: subpaths exportados no `package.json`, nomes de componentes, props e seus tipos, variantes, tokens CSS, classes documentadas (ex.: `orb-*`) e comportamento que um app possa ter usado.
|
|
4
|
-
|
|
5
|
-
## Qual número subir
|
|
6
|
-
|
|
7
|
-
| Mudança | Versão |
|
|
8
|
-
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
|
|
9
|
-
| Correção de bug, acessibilidade, tradução, ajuste visual que não muda a API | **patch** |
|
|
10
|
-
| Componente, padrão, export, prop opcional ou variante novos; mudança de visual padrão (preset, tokens) que não exige alteração no código do app; deprecação | **minor** |
|
|
11
|
-
| Remover ou renomear export, componente, prop, variante ou token; tornar prop obrigatória; mudar o tipo ou o significado de uma prop; mudança de comportamento que obriga o app a mudar código | **major** |
|
|
12
|
-
|
|
13
|
-
Na dúvida, a pergunta é: **um app que compilava com a versão anterior continua compilando e funcionando sem alterações?** Se sim, não é major.
|
|
14
|
-
|
|
15
|
-
## Evitar majors
|
|
16
|
-
|
|
17
|
-
- Prefira mudanças aditivas: nova prop ao lado da antiga, novo componente em vez de mudar o existente.
|
|
18
|
-
- Para trocar uma API, mantenha a antiga funcionando, marque-a com `@deprecated` (JSDoc, com a alternativa) e só remova no próximo major planejado.
|
|
19
|
-
- Agrupe remoções num único major, com `docs/MIGRATION-<versão>.md` e os consumidores conhecidos atualizados em seguida.
|
|
20
|
-
- Um major precisa de aprovação explícita do responsável antes da publicação; o agente propõe e justifica.
|
|
21
|
-
|
|
22
|
-
## Publicar
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
1
|
+
# Versionamento
|
|
2
|
+
|
|
3
|
+
`@majapisoftwares/ui` segue [SemVer](https://semver.org) sobre a **API pública**: subpaths exportados no `package.json`, nomes de componentes, props e seus tipos, variantes, tokens CSS, classes documentadas (ex.: `orb-*`) e comportamento que um app possa ter usado.
|
|
4
|
+
|
|
5
|
+
## Qual número subir
|
|
6
|
+
|
|
7
|
+
| Mudança | Versão |
|
|
8
|
+
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
|
|
9
|
+
| Correção de bug, acessibilidade, tradução, ajuste visual que não muda a API | **patch** |
|
|
10
|
+
| Componente, padrão, export, prop opcional ou variante novos; mudança de visual padrão (preset, tokens) que não exige alteração no código do app; deprecação | **minor** |
|
|
11
|
+
| Remover ou renomear export, componente, prop, variante ou token; tornar prop obrigatória; mudar o tipo ou o significado de uma prop; mudança de comportamento que obriga o app a mudar código | **major** |
|
|
12
|
+
|
|
13
|
+
Na dúvida, a pergunta é: **um app que compilava com a versão anterior continua compilando e funcionando sem alterações?** Se sim, não é major.
|
|
14
|
+
|
|
15
|
+
## Evitar majors
|
|
16
|
+
|
|
17
|
+
- Prefira mudanças aditivas: nova prop ao lado da antiga, novo componente em vez de mudar o existente.
|
|
18
|
+
- Para trocar uma API, mantenha a antiga funcionando, marque-a com `@deprecated` (JSDoc, com a alternativa) e só remova no próximo major planejado.
|
|
19
|
+
- Agrupe remoções num único major, com `docs/MIGRATION-<versão>.md` e os consumidores conhecidos atualizados em seguida.
|
|
20
|
+
- Um major precisa de aprovação explícita do responsável antes da publicação; o agente propõe e justifica.
|
|
21
|
+
|
|
22
|
+
## Publicar
|
|
23
|
+
|
|
24
|
+
Publicação automática pelo workflow `Release` (npm Trusted Publishing via OIDC do GitHub, com proveniência; sem token, senha ou OTP). PRs não mudam `version`.
|
|
25
|
+
|
|
26
|
+
1. Escolha o número pela tabela acima e justifique no commit (`feat:` → minor, `fix:` → patch, `feat!:`/`BREAKING CHANGE:` → major).
|
|
27
|
+
2. Com as mudanças na `main`, rode `gh workflow run release.yml -f bump=<patch|minor|major>`.
|
|
28
|
+
3. O workflow sobe a versão, valida a biblioteca e o starter contra o pacote empacotado, publica no npm, fixa o starter na versão publicada (`npm run test:starter`), cria o commit `release: v<versão>`, a tag e a release no GitHub.
|
|
29
|
+
4. Registre a versão no plano.
|
|
30
|
+
5. Apps fixam a versão exata (`--save-exact`) e atualizam por PR.
|
|
31
|
+
|
|
32
|
+
O vínculo de confiança do pacote é configurado uma vez por quem tem acesso de publicação: `npm trust github @majapisoftwares/ui --repo majapisoftwares/ui --file release.yml --allow-publish`.
|
|
@@ -1,22 +1,22 @@
|
|
|
1
|
-
# Saved-language titles
|
|
2
|
-
|
|
3
|
-
The initial preference state matched server HTML in English. Child title effects
|
|
4
|
-
ran before browser preferences were loaded, briefly writing the English title.
|
|
5
|
-
The pre-paint visibility mask also expired after two seconds, independently of
|
|
6
|
-
whether hydration had completed.
|
|
7
|
-
|
|
8
|
-
`Preferences` now exposes internal readiness to `useDocumentTitle`. Titles are
|
|
9
|
-
written only after the stored/browser language is resolved. The pre-paint mask
|
|
10
|
-
is removed only when React has committed that language. The public API remains
|
|
11
|
-
compatible, including `useDocumentTitle` outside Preferences.
|
|
12
|
-
|
|
13
|
-
The catalog and generated starter consume the shared implementation. Cloud and
|
|
14
|
-
the starter pin the corrected public Git source archive by its full commit SHA;
|
|
15
|
-
no registry authentication or mutable dependency ref is required.
|
|
16
|
-
|
|
17
|
-
Validation: Portuguese and English hydration tests record every document-title
|
|
18
|
-
write and verify that all writes use the selected language. Library typecheck,
|
|
19
|
-
lint, standards and build pass. Generated-starter lint, typecheck, UI standards
|
|
20
|
-
and build pass. Local Chrome refresh shows `Padrões · Majapi UI` and
|
|
21
|
-
`Repositórios · Majapi Cloud`, with visible Portuguese content and the button
|
|
22
|
-
`Conectar repositórios`. No production deployment was performed.
|
|
1
|
+
# Saved-language titles
|
|
2
|
+
|
|
3
|
+
The initial preference state matched server HTML in English. Child title effects
|
|
4
|
+
ran before browser preferences were loaded, briefly writing the English title.
|
|
5
|
+
The pre-paint visibility mask also expired after two seconds, independently of
|
|
6
|
+
whether hydration had completed.
|
|
7
|
+
|
|
8
|
+
`Preferences` now exposes internal readiness to `useDocumentTitle`. Titles are
|
|
9
|
+
written only after the stored/browser language is resolved. The pre-paint mask
|
|
10
|
+
is removed only when React has committed that language. The public API remains
|
|
11
|
+
compatible, including `useDocumentTitle` outside Preferences.
|
|
12
|
+
|
|
13
|
+
The catalog and generated starter consume the shared implementation. Cloud and
|
|
14
|
+
the starter pin the corrected public Git source archive by its full commit SHA;
|
|
15
|
+
no registry authentication or mutable dependency ref is required.
|
|
16
|
+
|
|
17
|
+
Validation: Portuguese and English hydration tests record every document-title
|
|
18
|
+
write and verify that all writes use the selected language. Library typecheck,
|
|
19
|
+
lint, standards and build pass. Generated-starter lint, typecheck, UI standards
|
|
20
|
+
and build pass. Local Chrome refresh shows `Padrões · Majapi UI` and
|
|
21
|
+
`Repositórios · Majapi Cloud`, with visible Portuguese content and the button
|
|
22
|
+
`Conectar repositórios`. No production deployment was performed.
|
package/package.json
CHANGED
|
@@ -1,89 +1,91 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@majapisoftwares/ui",
|
|
3
|
-
"version": "6.
|
|
4
|
-
"description": "Shared Majapi UI and UX standards based on shadcn/ui",
|
|
5
|
-
"publishConfig": {
|
|
6
|
-
"access": "public"
|
|
7
|
-
},
|
|
8
|
-
"repository": {
|
|
9
|
-
"type": "git",
|
|
10
|
-
"url": "git+https://github.com/majapisoftwares/ui.git"
|
|
11
|
-
},
|
|
12
|
-
"homepage": "https://ui.majapi.com",
|
|
13
|
-
"type": "module",
|
|
14
|
-
"sideEffects": [
|
|
15
|
-
"**/*.css"
|
|
16
|
-
],
|
|
17
|
-
"files": [
|
|
18
|
-
"scripts/check-standards.mjs",
|
|
19
|
-
"src",
|
|
20
|
-
"components.json",
|
|
21
|
-
"docs",
|
|
22
|
-
"AGENTS.md",
|
|
23
|
-
"THIRD_PARTY_NOTICES.md"
|
|
24
|
-
],
|
|
25
|
-
"exports": {
|
|
26
|
-
"./components/*": "./src/components/ui/*.tsx",
|
|
27
|
-
"./patterns/*": "./src/patterns/*.tsx",
|
|
28
|
-
"./templates/*": "./src/templates/*.tsx",
|
|
29
|
-
"./hooks/*": "./src/hooks/*.ts",
|
|
30
|
-
"./styles.css": "./src/styles.css",
|
|
31
|
-
"./lib/utils": "./src/lib/utils.ts",
|
|
32
|
-
"./lib/i18n": "./src/lib/i18n.tsx"
|
|
33
|
-
},
|
|
34
|
-
"scripts": {
|
|
35
|
-
"create:app": "node scripts/create-app.mjs",
|
|
36
|
-
"test:starter": "node --test scripts/create-app.test.mjs",
|
|
37
|
-
"dev": "npm run dev -w catalog",
|
|
38
|
-
"build": "node scripts/write-release.mjs && tsc --noEmit && npm run build -w catalog",
|
|
39
|
-
"typecheck": "tsc --noEmit",
|
|
40
|
-
"lint": "eslint . --max-warnings=0",
|
|
41
|
-
"format:check": "prettier --check src examples scripts *.json *.ts *.md docs/*.md",
|
|
42
|
-
"check:standards": "node scripts/check-standards.mjs",
|
|
43
|
-
"normalize:ui": "node scripts/normalize-ui.mjs && prettier --write src/components/ui src/hooks",
|
|
44
|
-
"test:preferences": "tsx --test scripts/preferences.test.tsx",
|
|
45
|
-
"test:data-table": "tsx --test scripts/data-table.test.tsx"
|
|
46
|
-
},
|
|
47
|
-
"peerDependencies": {
|
|
48
|
-
"react": "19.3.1",
|
|
49
|
-
"react-dom": "19.3.1"
|
|
50
|
-
},
|
|
51
|
-
"engines": {
|
|
52
|
-
"node": ">=22"
|
|
53
|
-
},
|
|
54
|
-
"dependencies": {
|
|
55
|
-
"@base-ui/react": "1.9.0",
|
|
56
|
-
"@dnd-kit/core": "6.3.1",
|
|
57
|
-
"@dnd-kit/modifiers": "9.0.0",
|
|
58
|
-
"@dnd-kit/sortable": "10.0.0",
|
|
59
|
-
"@dnd-kit/utilities": "3.2.2",
|
|
60
|
-
"@fontsource-variable/geist": "^5.3.0",
|
|
61
|
-
"@
|
|
62
|
-
"
|
|
63
|
-
"
|
|
64
|
-
"
|
|
65
|
-
"
|
|
66
|
-
"
|
|
67
|
-
"
|
|
68
|
-
"
|
|
69
|
-
"
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
"@
|
|
75
|
-
"@types/
|
|
76
|
-
"@types/
|
|
77
|
-
"
|
|
78
|
-
"
|
|
79
|
-
"
|
|
80
|
-
"
|
|
81
|
-
"
|
|
82
|
-
"
|
|
83
|
-
"
|
|
84
|
-
"
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
1
|
+
{
|
|
2
|
+
"name": "@majapisoftwares/ui",
|
|
3
|
+
"version": "6.4.0",
|
|
4
|
+
"description": "Shared Majapi UI and UX standards based on shadcn/ui",
|
|
5
|
+
"publishConfig": {
|
|
6
|
+
"access": "public"
|
|
7
|
+
},
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/majapisoftwares/ui.git"
|
|
11
|
+
},
|
|
12
|
+
"homepage": "https://ui.majapi.com",
|
|
13
|
+
"type": "module",
|
|
14
|
+
"sideEffects": [
|
|
15
|
+
"**/*.css"
|
|
16
|
+
],
|
|
17
|
+
"files": [
|
|
18
|
+
"scripts/check-standards.mjs",
|
|
19
|
+
"src",
|
|
20
|
+
"components.json",
|
|
21
|
+
"docs",
|
|
22
|
+
"AGENTS.md",
|
|
23
|
+
"THIRD_PARTY_NOTICES.md"
|
|
24
|
+
],
|
|
25
|
+
"exports": {
|
|
26
|
+
"./components/*": "./src/components/ui/*.tsx",
|
|
27
|
+
"./patterns/*": "./src/patterns/*.tsx",
|
|
28
|
+
"./templates/*": "./src/templates/*.tsx",
|
|
29
|
+
"./hooks/*": "./src/hooks/*.ts",
|
|
30
|
+
"./styles.css": "./src/styles.css",
|
|
31
|
+
"./lib/utils": "./src/lib/utils.ts",
|
|
32
|
+
"./lib/i18n": "./src/lib/i18n.tsx"
|
|
33
|
+
},
|
|
34
|
+
"scripts": {
|
|
35
|
+
"create:app": "node scripts/create-app.mjs",
|
|
36
|
+
"test:starter": "node --test scripts/create-app.test.mjs",
|
|
37
|
+
"dev": "npm run dev -w catalog",
|
|
38
|
+
"build": "node scripts/write-release.mjs && tsc --noEmit && npm run build -w catalog",
|
|
39
|
+
"typecheck": "tsc --noEmit",
|
|
40
|
+
"lint": "eslint . --max-warnings=0",
|
|
41
|
+
"format:check": "prettier --check src examples scripts *.json *.ts *.md docs/*.md",
|
|
42
|
+
"check:standards": "node scripts/check-standards.mjs",
|
|
43
|
+
"normalize:ui": "node scripts/normalize-ui.mjs && prettier --write src/components/ui src/hooks",
|
|
44
|
+
"test:preferences": "tsx --test scripts/preferences.test.tsx",
|
|
45
|
+
"test:data-table": "tsx --test scripts/data-table.test.tsx"
|
|
46
|
+
},
|
|
47
|
+
"peerDependencies": {
|
|
48
|
+
"react": "19.3.1",
|
|
49
|
+
"react-dom": "19.3.1"
|
|
50
|
+
},
|
|
51
|
+
"engines": {
|
|
52
|
+
"node": ">=22"
|
|
53
|
+
},
|
|
54
|
+
"dependencies": {
|
|
55
|
+
"@base-ui/react": "1.9.0",
|
|
56
|
+
"@dnd-kit/core": "6.3.1",
|
|
57
|
+
"@dnd-kit/modifiers": "9.0.0",
|
|
58
|
+
"@dnd-kit/sortable": "10.0.0",
|
|
59
|
+
"@dnd-kit/utilities": "3.2.2",
|
|
60
|
+
"@fontsource-variable/geist": "^5.3.0",
|
|
61
|
+
"@shadcn/react": "0.3.1",
|
|
62
|
+
"@tanstack/react-table": "8.21.3",
|
|
63
|
+
"class-variance-authority": "0.7.1",
|
|
64
|
+
"clsx": "2.1.1",
|
|
65
|
+
"cn": "^0.5.0",
|
|
66
|
+
"lucide-react": "1.61.0",
|
|
67
|
+
"shadcn": "^4.22.1",
|
|
68
|
+
"sonner": "^2.0.8",
|
|
69
|
+
"streamdown": "2.7.1",
|
|
70
|
+
"tailwind-merge": "3.7.0",
|
|
71
|
+
"tw-animate-css": "^1.4.0"
|
|
72
|
+
},
|
|
73
|
+
"devDependencies": {
|
|
74
|
+
"@eslint/js": "10.0.1",
|
|
75
|
+
"@types/jsdom": "30.0.0",
|
|
76
|
+
"@types/node": "26.6.5",
|
|
77
|
+
"@types/react": "19.3.0",
|
|
78
|
+
"@types/react-dom": "19.3.0",
|
|
79
|
+
"eslint": "10.13.0",
|
|
80
|
+
"eslint-plugin-react-hooks": "7.1.1",
|
|
81
|
+
"jsdom": "29.1.1",
|
|
82
|
+
"prettier": "3.9.10",
|
|
83
|
+
"tailwindcss": "4.3.3",
|
|
84
|
+
"tsx": "4.23.15",
|
|
85
|
+
"typescript": "6.0.3",
|
|
86
|
+
"typescript-eslint": "8.72.0"
|
|
87
|
+
},
|
|
88
|
+
"workspaces": [
|
|
89
|
+
"catalog"
|
|
90
|
+
]
|
|
91
|
+
}
|
|
@@ -1,41 +1,41 @@
|
|
|
1
|
-
import { readdir, readFile } from "node:fs/promises";
|
|
2
|
-
import { resolve, relative } from "node:path";
|
|
3
|
-
const consumer = process.argv[2];
|
|
4
|
-
const root = resolve(consumer ?? "src");
|
|
5
|
-
const violations = [];
|
|
6
|
-
async function visit(path) {
|
|
7
|
-
for (const entry of await readdir(path, { withFileTypes: true })) {
|
|
8
|
-
if (["node_modules", "dist", ".git"].includes(entry.name)) continue;
|
|
9
|
-
const file = resolve(path, entry.name);
|
|
10
|
-
if (entry.isDirectory()) {
|
|
11
|
-
await visit(file);
|
|
12
|
-
continue;
|
|
13
|
-
}
|
|
14
|
-
if (!/\.[jt]sx?$/.test(entry.name)) continue;
|
|
15
|
-
const text = await readFile(file, "utf8"),
|
|
16
|
-
name = relative(root, file).replaceAll("\\", "/");
|
|
17
|
-
if (/from\s+["'](?:radix-ui|@radix-ui\/)/.test(text))
|
|
18
|
-
violations.push(`${name}: the Workbench foundation uses Base UI`);
|
|
19
|
-
if (!consumer && name.startsWith("components/ui/")) continue;
|
|
20
|
-
if (consumer && /(?:^|\/)components\/ui\//.test(name))
|
|
21
|
-
violations.push(`${name}: local UI primitive copies are forbidden`);
|
|
22
|
-
if (/components\/native-select|<NativeSelect\b/.test(text))
|
|
23
|
-
violations.push(`${name}: use Select (Base UI), not a native select`);
|
|
24
|
-
if (/<(?:button|input|select|table|dialog)(?:\s|>)/.test(text))
|
|
25
|
-
violations.push(`${name}: use the shared UI primitive`);
|
|
26
|
-
if (
|
|
27
|
-
/(?:bg|text|border)-(?:red|blue|green|orange|gray|slate|zinc)-\d|(?:bg|text|border)-\[#[a-f\d]/i.test(
|
|
28
|
-
text,
|
|
29
|
-
)
|
|
30
|
-
)
|
|
31
|
-
violations.push(`${name}: use semantic tokens instead of local colors`);
|
|
32
|
-
if (!consumer && /from ["']@\//.test(text))
|
|
33
|
-
violations.push(`${name}: library internals must use portable imports`);
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
await visit(root);
|
|
37
|
-
if (violations.length) {
|
|
38
|
-
console.error(violations.join("\n"));
|
|
39
|
-
process.exitCode = 1;
|
|
40
|
-
} else
|
|
41
|
-
console.log(`UI standards passed (${consumer ? "consumer" : "library"}).`);
|
|
1
|
+
import { readdir, readFile } from "node:fs/promises";
|
|
2
|
+
import { resolve, relative } from "node:path";
|
|
3
|
+
const consumer = process.argv[2];
|
|
4
|
+
const root = resolve(consumer ?? "src");
|
|
5
|
+
const violations = [];
|
|
6
|
+
async function visit(path) {
|
|
7
|
+
for (const entry of await readdir(path, { withFileTypes: true })) {
|
|
8
|
+
if (["node_modules", "dist", ".git"].includes(entry.name)) continue;
|
|
9
|
+
const file = resolve(path, entry.name);
|
|
10
|
+
if (entry.isDirectory()) {
|
|
11
|
+
await visit(file);
|
|
12
|
+
continue;
|
|
13
|
+
}
|
|
14
|
+
if (!/\.[jt]sx?$/.test(entry.name)) continue;
|
|
15
|
+
const text = await readFile(file, "utf8"),
|
|
16
|
+
name = relative(root, file).replaceAll("\\", "/");
|
|
17
|
+
if (/from\s+["'](?:radix-ui|@radix-ui\/)/.test(text))
|
|
18
|
+
violations.push(`${name}: the Workbench foundation uses Base UI`);
|
|
19
|
+
if (!consumer && name.startsWith("components/ui/")) continue;
|
|
20
|
+
if (consumer && /(?:^|\/)components\/ui\//.test(name))
|
|
21
|
+
violations.push(`${name}: local UI primitive copies are forbidden`);
|
|
22
|
+
if (/components\/native-select|<NativeSelect\b/.test(text))
|
|
23
|
+
violations.push(`${name}: use Select (Base UI), not a native select`);
|
|
24
|
+
if (/<(?:button|input|select|table|dialog)(?:\s|>)/.test(text))
|
|
25
|
+
violations.push(`${name}: use the shared UI primitive`);
|
|
26
|
+
if (
|
|
27
|
+
/(?:bg|text|border)-(?:red|blue|green|orange|gray|slate|zinc)-\d|(?:bg|text|border)-\[#[a-f\d]/i.test(
|
|
28
|
+
text,
|
|
29
|
+
)
|
|
30
|
+
)
|
|
31
|
+
violations.push(`${name}: use semantic tokens instead of local colors`);
|
|
32
|
+
if (!consumer && /from ["']@\//.test(text))
|
|
33
|
+
violations.push(`${name}: library internals must use portable imports`);
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
await visit(root);
|
|
37
|
+
if (violations.length) {
|
|
38
|
+
console.error(violations.join("\n"));
|
|
39
|
+
process.exitCode = 1;
|
|
40
|
+
} else
|
|
41
|
+
console.log(`UI standards passed (${consumer ? "consumer" : "library"}).`);
|