@acropole/skills 1.7.0 → 1.8.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.
Files changed (54) hide show
  1. package/README.md +14 -11
  2. package/agents/revisor-orfeu.md +2 -1
  3. package/bin/install.js +41 -9
  4. package/package.json +1 -1
  5. package/skills/acropole/SKILL.md +2 -2
  6. package/skills/acropole/references/fluxos/atualizar-libs-2026-10.md +53 -17
  7. package/skills/angular/SKILL.md +4 -3
  8. package/skills/angular/references/armadilhas.md +3 -3
  9. package/skills/angular/references/dados.md +3 -3
  10. package/skills/angular/references/estrutura.md +6 -5
  11. package/skills/angular/references/features.md +5 -5
  12. package/skills/angular/references/testes-build.md +1 -1
  13. package/skills/auto-servico/SKILL.md +18 -14
  14. package/skills/auto-servico/references/roteiros.md +1 -1
  15. package/skills/auto-servico/references/tools.md +1 -1
  16. package/skills/express/references/dados.md +4 -1
  17. package/skills/express/references/estrutura.md +2 -1
  18. package/skills/fastapi/references/banco.md +6 -2
  19. package/skills/fastapi/references/estrutura.md +1 -1
  20. package/skills/hefesto/SKILL.md +13 -6
  21. package/skills/hefesto/references/diagnostico.md +1 -0
  22. package/skills/hefesto/references/mcp-roteiros.md +48 -7
  23. package/skills/orfeu/SKILL.md +43 -13
  24. package/skills/orfeu/references/angular-api.md +39 -13
  25. package/skills/orfeu/references/angular-armadilhas.md +18 -1
  26. package/skills/orfeu/references/angular-recipes.md +25 -12
  27. package/skills/orfeu/references/angular.md +37 -15
  28. package/skills/orfeu/references/diferencas.md +17 -8
  29. package/skills/orfeu/references/node-api.md +41 -9
  30. package/skills/orfeu/references/node-armadilhas.md +16 -2
  31. package/skills/orfeu/references/node-recipes.md +13 -4
  32. package/skills/orfeu/references/node.md +31 -12
  33. package/skills/orfeu/references/python-api.md +41 -16
  34. package/skills/orfeu/references/python-recipes.md +13 -9
  35. package/skills/orfeu/references/python.md +33 -12
  36. package/skills/orfeu/references/react.md +133 -0
  37. package/skills/orquestracao/SKILL.md +3 -1
  38. package/skills/orquestracao/scripts/coord.sh +10 -2
  39. package/skills/trismegisto/SKILL.md +89 -35
  40. package/skills/trismegisto/references/angular-api.md +4548 -344
  41. package/skills/trismegisto/references/angular-exports.md +8275 -2579
  42. package/skills/trismegisto/references/angular-recipes.md +327 -6
  43. package/skills/trismegisto/references/angular-types.md +92 -0
  44. package/skills/trismegisto/references/angular.md +96 -16
  45. package/skills/trismegisto/references/catalogo/icones.json +7 -0
  46. package/skills/trismegisto/references/catalogo/imports.json +1627 -0
  47. package/skills/trismegisto/references/catalogo/seletores.json +12110 -3426
  48. package/skills/trismegisto/references/catalogo/tokens.json +114 -0
  49. package/skills/trismegisto/references/react-api.md +16864 -0
  50. package/skills/trismegisto/references/react.md +237 -0
  51. package/skills/trismegisto/references/spine-api.md +5904 -1361
  52. package/skills/trismegisto/references/spine-recipes.md +140 -46
  53. package/skills/trismegisto/references/spine.md +121 -49
  54. package/skills/trismegisto/scripts/checar.mjs +66 -1
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  name: trismegisto
3
- description: "Interface de apps Angular com o design system Trismegisto (@trismegisto/*, componentes hm-*, tokens --hm-*, ícones) e o shell @trismegisto/spine. Use ao criar ou alterar a parte visual de uma tela — formulário, listagem, modal, menu, navegação, tema/família/fonte/densidade, ícone, gráfico, mapa, texto de interface — e antes de escrever HTML/CSS próprio nesses apps. Estrutura do app, rotas, serviços de dados e build são da skill angular (numa tela nova use as duas); login e sessão, da orfeu."
3
+ description: "Interface de apps Angular e React com o design system Trismegisto (@trismegisto/angular, @trismegisto/react, componentes hm-*, tokens --hm-*, ícones), gráficos/mapas/terminal e o shell spine (@trismegisto/angular/spine, @trismegisto/react/spine, núcleo @trismegisto/spine), inclusive a migração da 3.3.x para a 3.4.0. Use ao criar ou alterar a parte visual de uma tela — formulário, listagem, modal, menu, navegação, tema/família/fonte/densidade, ícone, gráfico, mapa, texto de interface — e antes de escrever HTML/CSS próprio nesses apps. Estrutura do app, rotas, serviços de dados e build são da skill angular (numa tela nova use as duas); login e sessão, da orfeu."
4
4
  ---
5
5
 
6
- # Trismegisto — interface dos apps Angular
6
+ # Trismegisto — interface dos apps Angular e React
7
7
 
8
- O Trismegisto é o design system Angular publicado no npm sob o scope `@trismegisto` (no código as classes
8
+ O Trismegisto é o design system publicado no npm sob o scope `@trismegisto` (no código as classes
9
9
  ainda levam o nome histórico **Hermes**: `HermesThemeService`, `provideHermesIcons`…). Entrega componentes
10
- standalone com prefixo **`hm-*`**, tokens CSS **`--hm-*`** (cor, espaço, tipografia, movimento, camadas) em
10
+ Angular (standalone) e React 19 com o mesmo DOM **`hm-*`**, tokens CSS **`--hm-*`** (cor, espaço, tipografia, movimento, camadas) em
11
11
  tema claro/escuro, 12 famílias de cor, duas densidades e quatro fontes, textos próprios em pt-BR/en/es e
12
12
  acessibilidade (teclado, leitor de tela, alto contraste, `prefers-reduced-motion`) já resolvida.
13
13
 
@@ -16,7 +16,9 @@ Divisão de trabalho entre as skills:
16
16
  não repete isso.
17
17
  - **trismegisto** (esta) — tudo que é **interface**: qual componente usar, tokens, tema, shell.
18
18
  - **orfeu** — sessão, token, guard e logout do `@orfeu/angular` (o spine depende dele).
19
- - Interface em React (`@trismegisto/react`) ainda não é coberta.
19
+ - **React** (`@trismegisto/react`, desde a 3.4.0): mesmas peças e regras, outra forma de usar — `references/react.md`
20
+ (escolha entre Angular e React no §1 de lá). As regras de ouro (§3) valem para os dois; os exemplos em `hm-*` abaixo
21
+ são Angular.
20
22
 
21
23
  > **Antes de dar por terminado:** `node scripts/checar.mjs <arquivos alterados>` (caminho relativo a esta skill: instalada, fica em `~/.claude/skills/trismegisto/scripts/checar.mjs`; `--help` lista as regras, `--json` para máquina).
22
24
  >
@@ -24,39 +26,48 @@ Divisão de trabalho entre as skills:
24
26
 
25
27
  ## 1. Pacotes
26
28
 
27
- Cadeia de dependência: `tokens ← icons ← primitives ← core ← angular ← (maps, charts, spine)`. Todos na
28
- **mesma versão** (`^2.1.2`); as 0.9.x foram retiradas do registry.
29
+ Camadas: `tokens ← icons ← primitives (+ núcleos charts, maps, terminal, spine) ← core ← angular · react`. Todos na
30
+ **mesma versão** (`^3.4.0`); não há versão maior depois da 3.x (uma faixa `^2.x` não aceita a 3.x).
29
31
 
30
- > **Atualizando um app** (vindo da 1.x ou da 2.0.x)? Siga o guia da skill `acropole`:
31
- > [../acropole/references/fluxos/atualizar-libs-2026-10.md](../acropole/references/fluxos/atualizar-libs-2026-10.md) — quebras da 2.0, o que a 2.1 muda no app e os contornos de CSS a remover.
32
+ > **Vindo da 3.3.x?** Na 3.4.0 `charts`, `maps`, `terminal` e `spine` viraram núcleos sem framework e os componentes
33
+ > foram para pontos de import do `@trismegisto/angular`: migração em `references/angular.md` §9 (gráficos, mapas,
34
+ > terminal) e `references/spine.md` §11 (shell). Vindo da 1.x/2.x, antes: guia da skill `acropole`,
35
+ > [../acropole/references/fluxos/atualizar-libs-2026-10.md](../acropole/references/fluxos/atualizar-libs-2026-10.md).
32
36
 
33
37
  | Pacote | Para quê |
34
38
  |---|---|
35
39
  | `@trismegisto/tokens` | variáveis CSS `--hm-*`, famílias de cor (`HERMES_FAMILIES`), breakpoints em TS. Sem framework |
36
40
  | `@trismegisto/icons` | catálogo de ícones SVG 24×24 (`@trismegisto/icons/catalog`). Sem framework |
37
41
  | `@trismegisto/primitives` | lógica sem framework: tema (`extendThemeConfig`), i18n (catálogos, `formatMessage`), máscaras, datas, árvore… |
38
- | `@trismegisto/core` | CSS dos componentes e utilitários (`.hm-stack`, `.hm-row`, `.hm-text-*`, `.hm-visually-hidden`…) |
39
- | `@trismegisto/angular` | os componentes `hm-*`, diretivas, pipes, serviços (`HermesThemeService`, `HermesDialogService`, `HermesToastService`…) e harnesses de teste (`/testing`) |
40
- | `@trismegisto/charts` | gráficos (`hm-bar-chart`, `hm-line-chart`…) com tabela acessível. Pesado: carregue sob demanda |
41
- | `@trismegisto/maps` | mapas (`hm-map`, coroplético, marcadores, GeoJSON) com mapas base embutidos |
42
- | `@trismegisto/spine` | o **shell pronto**: cabeçalho, menu lateral vindo do servidor de autorização (Argos), workspace em abas, barra da página, login/callback, modal/painel/toast por serviço, configurações, tour, auditoria, cliente GraphQL. O app entrega só as telas |
42
+ | `@trismegisto/core` | CSS dos componentes e utilitários (`.hm-stack`, `.hm-row`, `.hm-text-*`, `.hm-visually-hidden`…), dos dois frameworks |
43
+ | `@trismegisto/angular` | os componentes `hm-*`, diretivas, pipes, serviços (`HermesThemeService`, `HermesDialogService`, `HermesToastService`…), harnesses (`/testing`), peças de domínio genérico (§6) e, **fora do barrel**, as cascas `@trismegisto/angular/charts`, `/map`, `/terminal` e `/spine[/sub]` |
44
+ | `@trismegisto/react` | os mesmos componentes em React 19 (`Button`, `Modal`…, mesmo DOM `hm-*`), providers e hooks no lugar dos serviços; fora do barrel, `@trismegisto/react/charts`, `/map`, `/terminal` e `/spine[/sub]` (`references/react.md`) |
45
+ | `@trismegisto/charts` | núcleo dos gráficos: tipos dos dados (`ChartSeries`…), montagem, catálogos e o motor (`/engine`). Componentes: `@trismegisto/angular/charts` (`hm-bar-chart`…) / `@trismegisto/react/charts`. Pesado: carregue sob demanda |
46
+ | `@trismegisto/maps` | núcleo dos mapas: projeção, GeoJSON, mapas base embutidos (`/basemaps/<id>`), rotas, catálogos. Componentes: `@trismegisto/angular/map` (`hm-map`…) / `@trismegisto/react/map` |
47
+ | `@trismegisto/terminal` | emulador com a API no formato da do xterm.js (`Terminal`, `FitAddon`, `SearchAddon`, `WebLinksAddon`; substitui o `@xterm/xterm`). Componente: `@trismegisto/angular/terminal` (`hm-terminal`) / `@trismegisto/react/terminal` |
48
+ | `@trismegisto/spine` | núcleo do **shell pronto** (rotas, acesso, menu, config, catálogos). Cabeçalho, menu lateral vindo do servidor de autorização (Argos), workspace em abas, login/callback, modal/painel/toast por serviço, configurações, auditoria, GraphQL: casca `@trismegisto/angular/spine[/sub]` (`references/spine.md`) ou `@trismegisto/react/spine[/sub]`. O app entrega só as telas |
43
49
 
44
- ## 2. Instalação (2.1.2)
50
+ **Peers opcionais:** `charts`, `maps`, `terminal`, `spine` (e, para o shell, `@orfeu/*`, `react-router`, Apollo/GraphQL,
51
+ `marked`, `dompurify`) são `peerDependencies` **opcionais** do `angular` e do `react`: não vêm sozinhos. Instale só o
52
+ que o app usa, na mesma versão; sem o núcleo, o import da casca não resolve. A casca reexporta só **tipos** do núcleo:
53
+ constante, função e classe do núcleo se importam do núcleo (`@trismegisto/charts`, `@trismegisto/spine/<módulo>`…).
54
+
55
+ ## 2. Instalação (Angular, 3.4.0)
45
56
 
46
57
  ```bash
47
58
  # sem shell pronto
48
59
  npm install @trismegisto/angular @trismegisto/core @trismegisto/tokens @trismegisto/primitives @trismegisto/icons
49
- # com o shell (app que autentica no Argos)
50
- npm install @trismegisto/spine @trismegisto/angular @trismegisto/core @trismegisto/tokens \
51
- @trismegisto/primitives @trismegisto/icons @orfeu/angular
52
- # opcionais, na mesma versão
53
- npm install @trismegisto/charts @trismegisto/maps
60
+ # com o shell (app que autentica no Argos): + núcleo do spine, Orfeu e o Markdown das telas
61
+ npm install @trismegisto/angular @trismegisto/core @trismegisto/tokens @trismegisto/primitives \
62
+ @trismegisto/icons @trismegisto/spine @orfeu/angular marked dompurify
63
+ # opcionais, na mesma versão, só se usar a peça
64
+ npm install @trismegisto/charts @trismegisto/maps @trismegisto/terminal
54
65
  ```
55
66
 
56
- Peers: Angular **≥ 21** (`core`, `common`, `forms`, `router`, `platform-browser`), `rxjs` `^7.8`.
57
- `@angular/cdk` é peer **opcional** (só os harnesses de `@trismegisto/angular/testing`; instale como
58
- `devDependency`). O spine pede ainda `@orfeu/angular` `^1.0.0` (**uma cópia só** no app) e, só se usar
59
- `@trismegisto/spine/graphql`, `@apollo/client` `^4.2`, `apollo-angular` `^14.2`, `graphql` `^16`, `graphql-ws` `^6`.
67
+ React: `references/react.md` §2. Peers Angular: **≥ 21** (`core`, `common`, `forms`, `router`, `platform-browser`),
68
+ `rxjs` `^7.8`. `@angular/cdk` é peer **opcional** (só os harnesses de `@trismegisto/angular/testing`; instale como
69
+ `devDependency`). O shell pede `@orfeu/angular` (**uma cópia só** no app) e, só se usar
70
+ `@trismegisto/angular/spine/graphql`, `@apollo/client` `^4.2`, `apollo-angular` `^14.2`, `graphql` `^16`, `graphql-ws` `^6`.
60
71
 
61
72
  `angular.json` → `styles`, nesta ordem:
62
73
 
@@ -82,7 +93,11 @@ registra ícones, tema e toasts — não repita).
82
93
  no console. Confira em `@trismegisto/icons/catalog`.
83
94
  4. **i18n:** a lib traz os próprios textos (fechar, paginação, erros) em pt-BR/en/es; os rótulos que você
84
95
  passa são do i18n do app. Ao trocar de idioma, chame também `inject(HermesI18nService).setLocale(locale)`
85
- (o spine troca junto). Não monte texto da lib por concatenação.
96
+ (o spine troca junto). Não monte texto da lib por concatenação. As peças novas (§6) têm catálogo próprio
97
+ por pasta, que segue o idioma ativo; para trocar um texto numa instância, passe só as chaves no input
98
+ parcial da peça, que tem o mesmo nome em todas: `texts` (também nos recursos novos de peças antigas: edição do
99
+ `hm-data-grid`, menções do `hm-textarea`, reações do `hm-message`, mês do `hm-calendar`). Em campo de
100
+ formulário, `messages` continua sendo o texto por chave de erro (`{ required: '…' }`).
86
101
  5. **Acessibilidade:** todo controle tem `label` real (use `labelHidden` para esconder, nunca `label=""`);
87
102
  não aninhe interativo em interativo (`hm-card` não é clicável); landmarks com nome único; ação destrutiva
88
103
  com `intent="danger"` **e confirmação** (`HermesDialogService.confirm({ …, danger: true })`); evento de
@@ -90,10 +105,15 @@ registra ícones, tema e toasts — não repita).
90
105
  contém a propagação com `(click)="$event.stopPropagation()"` **junto** do `(clicked)` (a ação fica no
91
106
  `(clicked)`; o verificador aceita esse `(click)`).
92
107
  6. **Standalone e lazy:** importe a classe no `imports` do componente (não existe `HermesModule`); importe da
93
- raiz `@trismegisto/angular` ou do ponto da peça (`@trismegisto/angular/data-grid`). Gráficos, mapas e
108
+ raiz `@trismegisto/angular` ou do ponto da peça (`@trismegisto/angular/data-grid`); gráficos, mapas, terminal
109
+ e spine **só** pelo ponto (`@trismegisto/angular/charts`…), fora da raiz. Gráficos, mapas e
94
110
  telas pesadas em `@defer`/rota lazy.
95
111
  7. **Teste por harness** (`@trismegisto/angular/testing`), nunca por classe interna do DOM da lib.
96
- 8. **Estados da tela**: carregando (`hm-skeleton`), vazio (`hm-empty`) e erro (`hm-alert variant="error"` com
112
+ 8. **Peças de domínio genérico só mostram e emitem** (§6): os dados entram por input e a intenção sai por
113
+ output (`taskChange`, `eventChange`, `laneChange`, `transition`, `book`…); buscar, validar no servidor e
114
+ gravar é do app, que devolve o input atualizado. Edição é **opt-in** (`editable` no `hm-gantt` e no
115
+ `hm-event-calendar`, `allowLaneChange` no `hm-swimlane-board`): sem ela, nada muda para quem já usa.
116
+ 9. **Estados da tela**: carregando (`hm-skeleton`), vazio (`hm-empty`) e erro (`hm-alert variant="error"` com
97
117
  o botão "Tentar novamente") são três estados distintos; skeleton nunca fica no lugar de uma falha. Campo
98
118
  `hm-*` ligado a formulário reativo desabilita por `control.disable()`, não por `[disabled]` (skill
99
119
  `angular`).
@@ -107,7 +127,7 @@ Usar só tokens e a escala `--hm-space-*` já faz a tela acompanhar tudo isso.
107
127
 
108
128
  - **Com spine:** nada a fazer — o `provideUi` aplica no `<body>`, prefixa as chaves com o `clientId` e a
109
129
  pessoa escolhe em Configurações › Aparência. Por código: `ThemeService`, `DensityService`,
110
- `ThemePresetService` (`@trismegisto/spine`).
130
+ `ThemePresetService` (`@trismegisto/angular/spine`).
111
131
  - **Sem spine:** um `hermesTheme` no elemento raiz + `HERMES_THEME_CONFIG`; troca por `HermesThemeService`
112
132
  (`setMode`, `setFamily`, `setDensity`, `toggle`); seletor pronto: `hm-theme-picker`.
113
133
 
@@ -169,8 +189,8 @@ import { HERMES_THEME_CONFIG } from '@trismegisto/angular';
169
189
  <hm-state-page kind="outdated" (actionTriggered)="recarregar()" /> <!-- window.location.reload() -->
170
190
  ```
171
191
  O spine já mostra `outdated` sozinho quando a rota não carrega por chunk ausente; em `import()` dinâmico
172
- próprio, detecte com `isChunkLoadError(err)` (`@trismegisto/spine/routing`). Em código, os textos:
173
- `statePagePreset(kind, inject(HERMES_MESSAGES))` (o `STATE_PAGE_PRESETS` fixo em pt-BR está depreciado).
192
+ próprio, detecte com `isChunkLoadError(err)` (`@trismegisto/angular/spine/routing`). Em código, os textos:
193
+ `statePagePreset(kind, inject(HERMES_MESSAGES))` (o `STATE_PAGE_PRESETS` fixo em pt-BR saiu na 3.3.1).
174
194
  - **`hm-state-screen situation="…"`** — o bloco genérico (título/descrição/ação livres): `empty`, `success`,
175
195
  `error`, `attention`, `done`, `locked`, `unlocked`, `forbidden`, `not-found`, `session-expired`; outro
176
196
  desenho vai no slot `[illustration]`. Vazio **dentro** de cartão/tabela é `hm-empty`; falha ao carregar é
@@ -181,17 +201,51 @@ import { HERMES_THEME_CONFIG } from '@trismegisto/angular';
181
201
  da raiz (`@trismegisto/angular/illustration-error`…); prefira `hm-state-screen`/`hm-state-page`, que as
182
202
  carregam sob demanda.
183
203
 
184
- ## 6. Índice das referências (leia sob demanda)
204
+ ## 6. Famílias novas (lacunas e domínio genérico)
205
+
206
+ Antes de compor à mão, procure aqui. Receita em `references/angular-recipes.md`; inputs em `angular-api.md`
207
+ (gerado do código atual: se a peça não está lá, a versão instalada ainda não a tem).
208
+
209
+ | Família | Peças | Receita |
210
+ |---|---|---|
211
+ | Formatação e moeda | pipes `hmNumber`, `hmCurrency`, `hmPercent`, `hmRelativeTime`, `hmDuration`, `hmFileSize` (e `formatCurrency`… em TS); `hm-currency-input`, `hm-percent-input` | §39 |
212
+ | Data, hora e hierarquia | `hm-datetime-picker`, `hm-month-picker`, `hm-time-range`, `hm-tree-select(-multi)`, `hm-cascader` | §40 |
213
+ | Formulário acessível | `hm-form-error-summary` (`formErrorsFrom`), `HermesAnnouncer`/`[hmAnnounce]`, `hm-skip-link`, `hermesUnsavedChangesGuard`/`registerUnsavedChanges`, `hm-save-status`, `hm-anchor-nav` | §41 |
214
+ | Overlays e ações | `hm-popconfirm`, `hm-split-button`, `hm-tour`, `hm-bottom-sheet`, `hm-progress shape="circle"`, `hm-bottom-navigation` | §42 |
215
+ | Grade editável | `hm-data-grid` `editMode` + `hmCellEditor`, `treeChildren` (`treePagination`, `treeChildPageSize`), `columnGroups`, `striped` | §43 |
216
+ | Gráficos novos | `hm-sparkline-chart`, `hm-bullet-chart`, `hm-waterfall-chart`, bolhas (`size` no `hm-scatter-chart`), `hm-gauge-chart` animado | §44 |
217
+ | Campos e visualizadores | `hm-tag-input`, `hm-color-picker`, `hm-rating`; `hm-json-viewer`, `hm-log-viewer`, `hm-image-gallery`/`hm-lightbox`, `hm-pdf-viewer` | §45 |
218
+ | Workflow e tarefas | status, escalas, responsável, aprovação, prazo/SLA, tarefas, `hm-swimlane-board`, `hm-backlog`, `hm-workload`, `hm-workflow-editor`, `hm-gantt`, riscos | §46 |
219
+ | Pessoas e conta | `hm-entity-picker`, `hm-user-card`, `hm-member-list`, `hm-org-chart`, `hm-permission-matrix`, acesso; cadastro, senha, passkey, consentimento; presença, menções, reações | §47 |
220
+ | Calendário, arquivos, relatórios, dev | recorrência e edição no `hm-event-calendar`, `hm-slot-picker`, `hm-resource-calendar`; `hm-file-list`, versões, permissões, cota; `hm-report-schedule`; `hm-api-exchange`, `hm-feature-flags` | §48 |
221
+ | Comércio, pagamentos, finanças | produto, preço, `hm-cart`, pedido, entrega, devolução; meios de pagamento, `hm-payment-form`, fatura, planos, finanças | §49 |
222
+ | Monitoramento, integrações, mapas, entradas | saúde, incidentes, alertas, métricas, trace, deploy; integrações, webhooks, sincronização; `hm-map-cluster`, `hm-map-route`, `hm-street-view`; endereço `PostalAddress` + `hm-address-field`, placa, documentos | §50 |
223
+
224
+ - **Endereço é um só:** modelo `PostalAddress` (`@trismegisto/primitives`), campo `hm-address-field` (com
225
+ `hm-location-select`), exibição `hm-address-view`/`-card`/`-picker` (mesma `formatAddressLines`). Não crie tipo
226
+ de endereço próprio nem monte o texto à mão.
227
+ - **Signal Forms:** todo campo `hm-*` aceita `[formField]` (`@angular/forms/signals`) além dos três modos de
228
+ `references/angular.md` §3, inclusive os que têm validador próprio (número, moeda, documento, IBAN, placa,
229
+ endereço).
230
+ - **`hm-modal` deixa a página de trás `inert`** enquanto está aberto (e devolve ao fechar); não marque `inert`
231
+ nem `aria-hidden` à mão.
232
+ - **Exemplos integrados** (telas inteiras só com peças da lib, referência de implementação; site do Trismegisto ›
233
+ Componentes, aba Código): Calendar app, Org chart explorer, Projects app, Store app, Billing app, Ops console
234
+ app, People admin app, Files app, Developer portal — mapa em `references/angular-recipes.md` §51.
235
+
236
+ ## 7. Índice das referências (leia sob demanda)
185
237
 
186
238
  | Arquivo | Quando ler |
187
239
  |---|---|
188
240
  | `references/angular.md` | **Primeiro**, ao construir qualquer tela: setup sem spine, tokens em detalhe, formulários (Reactive/template/sem form), tabela "Preciso de… / Use", depreciações, harnesses, armadilhas |
189
- | `references/angular-recipes.md` | Ao montar um padrão completo: shell sem spine, listagem com data grid, formulário, wizard, filtros, kanban, árvore, agenda, upload, atalhos, login, theme builder, i18n/pipes, testes, gráficos e mapas (§1–§37) |
241
+ | `references/angular-recipes.md` | Ao montar um padrão completo: shell sem spine, listagem com data grid, formulário, wizard, filtros, kanban, árvore, agenda, upload, atalhos, login, theme builder, i18n/pipes, testes, gráficos e mapas (§1–§38); famílias novas e exemplos integrados (§39–§51) |
190
242
  | `references/angular-types.md` | Ao montar dados para um componente (`MenuItem`, `GridColumn`, `SidebarNode`, enums de variante) |
191
243
  | `references/angular-api.md` | Para conferir seletor, inputs/models/outputs, slots e métodos exatos de um `hm-*` (gerado do código; busque pelo seletor) |
192
244
  | `references/angular-exports.md` | Para conferir o nome/assinatura de serviço, função, constante, token ou tipo antes de importar, por ponto de import (gerado; busque pelo nome) |
193
- | `references/spine.md` | App com `@trismegisto/spine`: pontos de entrada, bootstrap (`provideUi`/`provideShell`/`provideAutoService`/`provideGraphql`), telas por `router_id`, `X-Route-Id`/`X-Client-Id`, GraphQL com `unwrap`, serviços do shell, auditoria, i18n, armadilhas |
194
- | `references/spine-recipes.md` | Receitas do spine: bootstrap completo, página pública, tela nova com documentação, serviço REST/GraphQL, subscription, modal/painel, auditoria lazy, seção de configurações, novidades, marca, testes |
195
- | `references/spine-api.md` | Para conferir exports exatos de cada `@trismegisto/spine/*` (gerado do código) |
245
+ | `references/spine.md` | App Angular com o shell (`@trismegisto/angular/spine` + núcleo `@trismegisto/spine`): pontos de entrada, casca × núcleo, migração da 3.3.x (§11), bootstrap (`provideUi`/`provideShell`/`provideAutoService`/`provideGraphql`), telas por `router_id`, `X-Route-Id`/`X-Client-Id`, GraphQL com `unwrap`, serviços do shell, auditoria, i18n, armadilhas |
246
+ | `references/spine-recipes.md` | Receitas do spine: bootstrap completo, página pública, tela nova com documentação, serviço REST/GraphQL, subscription, modal/painel, auditoria lazy, seção de configurações, novidades, marca, alterações não salvas e skip link, testes |
247
+ | `references/spine-api.md` | Para conferir exports exatos da casca `@trismegisto/angular/spine/*` e de cada módulo do núcleo `@trismegisto/spine/*` (gerado do código) |
248
+ | `references/react.md` | App React: Angular ou React, setup, regra das props (`onX`, `x`/`defaultX`/`onXChange`, slots), gráficos/mapas/terminal, shell `@trismegisto/react/spine` com React Router v7 e `@orfeu/react` |
249
+ | `references/react-api.md` | Para conferir componentes, props (`XProps`), hooks e tipos de cada `@trismegisto/react/*` (gerado do código) |
196
250
 
197
251
  Os arquivos `*-api.md` e `angular-exports.md` são grandes: use busca por nome em vez de ler inteiros.