@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.
- package/README.md +14 -11
- package/agents/revisor-orfeu.md +2 -1
- package/bin/install.js +41 -9
- package/package.json +1 -1
- package/skills/acropole/SKILL.md +2 -2
- package/skills/acropole/references/fluxos/atualizar-libs-2026-10.md +53 -17
- package/skills/angular/SKILL.md +4 -3
- package/skills/angular/references/armadilhas.md +3 -3
- package/skills/angular/references/dados.md +3 -3
- package/skills/angular/references/estrutura.md +6 -5
- package/skills/angular/references/features.md +5 -5
- package/skills/angular/references/testes-build.md +1 -1
- package/skills/auto-servico/SKILL.md +18 -14
- package/skills/auto-servico/references/roteiros.md +1 -1
- package/skills/auto-servico/references/tools.md +1 -1
- package/skills/express/references/dados.md +4 -1
- package/skills/express/references/estrutura.md +2 -1
- package/skills/fastapi/references/banco.md +6 -2
- package/skills/fastapi/references/estrutura.md +1 -1
- package/skills/hefesto/SKILL.md +13 -6
- package/skills/hefesto/references/diagnostico.md +1 -0
- package/skills/hefesto/references/mcp-roteiros.md +48 -7
- package/skills/orfeu/SKILL.md +43 -13
- package/skills/orfeu/references/angular-api.md +39 -13
- package/skills/orfeu/references/angular-armadilhas.md +18 -1
- package/skills/orfeu/references/angular-recipes.md +25 -12
- package/skills/orfeu/references/angular.md +37 -15
- package/skills/orfeu/references/diferencas.md +17 -8
- package/skills/orfeu/references/node-api.md +41 -9
- package/skills/orfeu/references/node-armadilhas.md +16 -2
- package/skills/orfeu/references/node-recipes.md +13 -4
- package/skills/orfeu/references/node.md +31 -12
- package/skills/orfeu/references/python-api.md +41 -16
- package/skills/orfeu/references/python-recipes.md +13 -9
- package/skills/orfeu/references/python.md +33 -12
- package/skills/orfeu/references/react.md +133 -0
- package/skills/orquestracao/SKILL.md +3 -1
- package/skills/orquestracao/scripts/coord.sh +10 -2
- package/skills/trismegisto/SKILL.md +89 -35
- package/skills/trismegisto/references/angular-api.md +4548 -344
- package/skills/trismegisto/references/angular-exports.md +8275 -2579
- package/skills/trismegisto/references/angular-recipes.md +327 -6
- package/skills/trismegisto/references/angular-types.md +92 -0
- package/skills/trismegisto/references/angular.md +96 -16
- package/skills/trismegisto/references/catalogo/icones.json +7 -0
- package/skills/trismegisto/references/catalogo/imports.json +1627 -0
- package/skills/trismegisto/references/catalogo/seletores.json +12110 -3426
- package/skills/trismegisto/references/catalogo/tokens.json +114 -0
- package/skills/trismegisto/references/react-api.md +16864 -0
- package/skills/trismegisto/references/react.md +237 -0
- package/skills/trismegisto/references/spine-api.md +5904 -1361
- package/skills/trismegisto/references/spine-recipes.md +140 -46
- package/skills/trismegisto/references/spine.md +121 -49
- 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
|
|
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
|
|
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
|
|
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
|
-
-
|
|
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
|
-
|
|
28
|
-
**mesma versão** (`^
|
|
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
|
-
> **
|
|
31
|
-
>
|
|
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`…)
|
|
40
|
-
| `@trismegisto/
|
|
41
|
-
| `@trismegisto/
|
|
42
|
-
| `@trismegisto/
|
|
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
|
-
|
|
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/
|
|
51
|
-
@trismegisto/
|
|
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
|
-
|
|
57
|
-
`@angular/cdk` é peer **opcional** (só os harnesses de `@trismegisto/angular/testing`; instale como
|
|
58
|
-
`devDependency`). O
|
|
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`)
|
|
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. **
|
|
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
|
|
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.
|
|
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–§
|
|
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
|
|
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.
|