@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
@@ -4,8 +4,8 @@ Escrito para a **API 1.0**; o que saiu ou está depreciado está em
4
4
  [Depreciações e remoções](#6-depreciações-e-remoções). Pacotes, instalação, peers, tema/família/fonte,
5
5
  páginas de estado e ilustrações estão no `SKILL.md` da skill. Nomes exatos: `angular-api.md` (seletores,
6
6
  inputs, outputs, slots) e `angular-exports.md` (serviços, funções, tokens, tipos); tipos comentados:
7
- `angular-types.md`; receitas prontas: `angular-recipes.md`. Se o app usa o shell `@trismegisto/spine`,
8
- leia também `spine.md` — boa parte do setup abaixo ele já faz.
7
+ `angular-types.md`; receitas prontas: `angular-recipes.md`. Se o app usa o shell spine
8
+ (`@trismegisto/angular/spine`), leia também `spine.md` — boa parte do setup abaixo ele já faz.
9
9
 
10
10
  ## 1. Setup do app (sem spine)
11
11
 
@@ -31,7 +31,7 @@ export const appConfig: ApplicationConfig = {
31
31
  - Para bundle menor, registre só os ícones usados, importando-os por nome do mesmo `/catalog`:
32
32
  `provideHermesIcons([addText, airplane])`. O export é em camelCase (`addText`); no template, o nome é
33
33
  kebab-case (`shape="add-text"`).
34
- - Se o app usa `@trismegisto/spine`, o `provideUi()` do spine já registra o catálogo.
34
+ - Se o app usa o shell spine, o `provideUi()` (`@trismegisto/angular/spine`) já registra o catálogo.
35
35
 
36
36
  Raiz do app (o shell): **um** `hermesTheme` no elemento que envolve tudo, e **um** `hm-toast-stack`.
37
37
 
@@ -68,7 +68,13 @@ Todos os componentes são **standalone**: importe a classe no `imports` do compo
68
68
  1. **Nenhum valor visual cravado no app.** Cor, espaçamento, raio, sombra, duração e altura de controle vêm de
69
69
  `var(--hm-*)`. Um `#hex` ou um `px` de espaçamento num SCSS de tela é bug: não acompanha tema escuro,
70
70
  família nem densidade. Grupos principais:
71
- - Cor: `--hm-surface`, `--hm-surface-raised`, `--hm-text`, `--hm-muted`, `--hm-border`, `--hm-divider`,
71
+ - Superfícies, por elevação (o que fica por cima clareia nos dois temas):
72
+ `--hm-surface` é o fundo da página (cinza claro no claro, o mais escuro no escuro);
73
+ `--hm-surface-raised` é card, painel, campo e corpo de tabela (branco no claro);
74
+ `--hm-surface-overlay` é o que flutua (menu, popover, modal, drawer, toast);
75
+ `--hm-surface-muted` é o tom de apoio DENTRO de um card (cabeçalho de tabela, código, trilho), não elevação.
76
+ Elemento interno de um card não usa `--hm-surface`: vira um "buraco" com a cor da página.
77
+ - Cor: `--hm-text`, `--hm-muted`, `--hm-border`, `--hm-divider`,
72
78
  `--hm-accent`, `--hm-action`, `--hm-on-action`, `--hm-hover`, `--hm-focus-color`;
73
79
  status: `--hm-{info,success,warning,danger}` e `--hm-{…}-bg`.
74
80
  - Espaço: `--hm-space-{xxxs,nano,micro,xs,sm,md,lg,xl,2xl,3xl}`. Controle: `--hm-control-height{,-dense,-large}`.
@@ -130,6 +136,9 @@ escolha o que o resto do app usa, não misture no mesmo campo:
130
136
  <hm-input label="Busca" [(value)]="term" />
131
137
  ```
132
138
 
139
+ - **Signal Forms** também: `[formField]="meuForm.campo"` (`FormField` e `form()` de `@angular/forms/signals`) em
140
+ qualquer campo `hm-*`, inclusive os de validador próprio (`hm-input type="number"`, moeda/percentual, documento,
141
+ IBAN, placa, `hm-address-field`).
133
142
  - Two-way sem formulário: `[(value)]` em todos, exceto `hm-checkbox` (`[(checked)]`),
134
143
  `hm-combobox-multi` (`[(selected)]`, lista de valores), `hm-file-upload` (`[(files)]`, lista de
135
144
  `UploadFile`) e `hm-reorder-list` (`[(items)]`, a lista na ordem nova). `hm-dual-list` usa `[(value)]`
@@ -141,8 +150,7 @@ escolha o que o resto do app usa, não misture no mesmo campo:
141
150
  - Texto por chave de erro: `[messages]="{ email: 'Informe um e-mail válido.' }"`; sem isso, catálogo da lib.
142
151
  - Desabilitar: `form.disable()`/`control.disable()` ou o input `[disabled]` sem formulário.
143
152
  - Texto de apoio: `hint` em todos (`help` ainda funciona, depreciado).
144
- - `hm-field` virou **`hm-input`** (mesma API). `hm-field` ainda existe na 1.0, **depreciado** e com aviso no
145
- console em desenvolvimento: não use em código novo.
153
+ - `hm-field` virou **`hm-input`** (mesma API); o `hm-field` saiu na 3.3.1.
146
154
  - `[control]="form.controls.x"` (contrato 0.1.x) **foi removido** (depreciado desde 0.2.0): use
147
155
  `[formControl]="form.controls.x"` (com `ReactiveFormsModule`) ou `formControlName="x"`. Só o
148
156
  `hm-settings-section` mantém um `[control]` próprio (o `FormGroup` da seção).
@@ -266,8 +274,8 @@ escolha o que o resto do app usa, não misture no mesmo campo:
266
274
  | Arquivo anexado (mensagem, formulário, envio) | `hm-attachment` (`name`, `size`, `type`, `thumbnail`, `status` + `progress`/`error`, `removable` → `(removed)`, `retryable` → `(retried)`) em `hm-attachment-group` (`layout` list/inline/grid, `label`); escolher arquivos é `hm-file-upload` |
267
275
  | Campo de prompt (texto + botões dentro da moldura, Enter envia) | `hm-textarea` com `autoGrow` + `maxRows`, `submitKey="enter"`/`"mod-enter"` → `(submitted)` e botões em `<… hmTextareaActions>`/`hmTextareaActionsEnd` (`hmTextareaPrefix`/`Suffix` para ícones) — receitas |
268
276
  | Área com rolagem própria / mídia com proporção fixa | classes `.hm-scroll-area` (`--x`/`--y`, `--stable`, altura em `--hm-scroll-area-max`; dê `tabindex="0"`, `role="region"` e `aria-label`) e `.hm-aspect-ratio` (`--1-1`/`--4-3`/`--16-9` ou `--hm-aspect-ratio`; `--contain`) |
269
- | Gráfico (barras, linhas/área, pizza/rosca, mapa de calor, calendário, dispersão, medidor, funil, radar, treemap, sankey, caixa) | `@trismegisto/charts`: o tipado do caso (`hm-bar-chart`, `hm-line-chart`, `hm-pie-chart`…) com dados prontos (`categories` + `series`, ou `data`), `label` obrigatório (nome acessível e legenda da tabela), `description` com a conclusão, `numberFormat` (`Intl.NumberFormat`); a tabela de dados e o resumo para leitor de tela vêm sozinhos. `hm-chart` (opção crua do motor) só para o que os tipados não cobrem. Carregue a tela sob demanda (`@defer`/rota lazy) — receitas |
270
- | Mapa (mundo/Brasil, coroplético, marcadores, GeoJSON) | `@trismegisto/maps` (`HM_MAP_COMPONENTS`): `<hm-map>` com `hm-map-basemap` (mapas base embutidos, sem serviço externo: `world/50m`, `br/ufs`…), `hm-map-choropleth` para valor por região, `hm-map-marker`/`hm-map-popup`/`hm-map-geojson`/`hm-map-polyline`/`hm-map-polygon`/`hm-map-circle`; tiles raster só se o app quiser, por `tileUrl` + a `attribution` que o provedor exige; `label` em todo mapa e marcador, cores por `colorProperty` (paleta `--hm-data-*`), `[scrollWheelZoom]="false"` em página longa — receitas §36. Não há mapa de ruas próprio |
277
+ | Gráfico (barras, linhas/área, pizza/rosca, mapa de calor, calendário, dispersão, medidor, funil, radar, treemap, sankey, caixa) | `@trismegisto/angular/charts` (núcleo `@trismegisto/charts` instalado): o tipado do caso (`hm-bar-chart`, `hm-line-chart`, `hm-pie-chart`…) com dados prontos (`categories` + `series`, ou `data`), `label` obrigatório (nome acessível e legenda da tabela), `description` com a conclusão, `numberFormat` (`Intl.NumberFormat`); a tabela de dados e o resumo para leitor de tela vêm sozinhos. `hm-chart` (opção crua do motor) só para o que os tipados não cobrem. Carregue a tela sob demanda (`@defer`/rota lazy) — receitas |
278
+ | Mapa (mundo/Brasil, coroplético, marcadores, GeoJSON) | `@trismegisto/angular/map` (`HM_MAP_COMPONENTS`; núcleo `@trismegisto/maps` instalado): `<hm-map>` com `hm-map-basemap` (mapas base embutidos, sem serviço externo: `world/50m`, `br/ufs`…), `hm-map-choropleth` para valor por região, `hm-map-marker`/`hm-map-popup`/`hm-map-geojson`/`hm-map-polyline`/`hm-map-polygon`/`hm-map-circle`; tiles raster só se o app quiser, por `tileUrl` + a `attribution` que o provedor exige; `label` em todo mapa e marcador, cores por `colorProperty` (paleta `--hm-data-*`), `[scrollWheelZoom]="false"` em página longa — receitas §36. Não há mapa de ruas próprio |
271
279
  | Saber se o componente está em `rtl` | `isRtl(elemento)` / `elementDirection()` de `@trismegisto/angular` na hora do gesto (não guarde o valor) |
272
280
  | Indicador (um número) | `hm-stat-card` (`description`, `details`, `trend`, `hint`, `size`, `loading`; filtro: `selectable` + `[selected]` + `(selectedChange)`, controlado) |
273
281
  | Várias métricas sob um título + "ver mais" | `hm-stat-group` (`heading`, `[metrics]: StatGroupMetric[]`, `moreLabel`/`moreLink`/`moreAction` + `(more)`, `loading`) |
@@ -293,16 +301,60 @@ escolha o que o resto do app usa, não misture no mesmo campo:
293
301
  | Itens que deslizam ao reordenar (lista, kanban, grade) | diretiva `[hmFlip]="lista()"` no contêiner (`hmFlipItems=".cartao"` para itens mais fundos; ou `#f="hmFlip"` + `f.capture()` antes de mudar o estado) |
294
302
  | Bloco que aparece ao rolar (conteúdo editorial) | diretiva `hmReveal` (`[hmRevealDelay]` para escalonar); nunca em formulário/erro. Movimento: tudo respeita `prefers-reduced-motion` sozinho |
295
303
  | Pessoa criar/ajustar uma família de cor do app | `hm-theme-builder` (`baseFamily`, `exportFormats`, `headingLevel`, `(draftChange)`); a regra de contraste em TS: `familyContrastChecks(draftContrastInput(draft))` (`@trismegisto/primitives`). Trocar entre famílias prontas é `hm-theme-picker` |
304
+ | Valor em dinheiro / percentual (campo) | `hm-currency-input` (`currency`, `fractionDigits`; número no modelo, texto no formato do idioma) e `hm-percent-input` (`valueScale` fraction/points) — não `hm-input type="number"` com "R$" no prefixo |
305
+ | Número, dinheiro, %, "há 5 minutos", duração, tamanho de arquivo no template | pipes `hmNumber`, `hmCurrency` (`'BRL'` padrão), `hmPercent` (fração; `'points'` para pontos), `hmRelativeTime` (`{ now }` para envelhecer), `hmDuration` (ms), `hmFileSize`; em TS `formatNumber`/`formatCurrency`/`formatPercent`/`formatRelativeTime`/`formatDuration`/`formatFileSize` (`@trismegisto/primitives`, com o `locale`) |
306
+ | Data com hora / mês de referência / faixa de horário | `hm-datetime-picker` (`interval`, `defaultTime`), `hm-month-picker` (`AAAA-MM`; `valueFormat="first-day"`), `hm-time-range` (`{ start, end }`, `overnight`, `showDuration`) |
307
+ | Escolher um nó de uma hierarquia num formulário | `hm-tree-select` (`nodes: TreeNode[]`, `leavesOnly`, `showPath`, `searchable`, `loadChildren`), múltiplo `hm-tree-select-multi` (`maxChips`); por colunas (país › estado › cidade) `hm-cascader` (`changeOnSelect`) |
308
+ | Lista de erros no topo ao enviar | `hm-form-error-summary [errors]` com `formErrorsFrom(form, rótulos, inject(HERMES_MESSAGES))` no envio (recebe o foco; links levam ao campo) — receitas §41 |
309
+ | Anunciar algo do app ao leitor de tela | `inject(HermesAnnouncer).announce(texto)` (`'assertive'` como 2º argumento só para urgência) ou `[hmAnnounce]`; não crie região `aria-live` própria |
310
+ | "Pular para o conteúdo" | `hm-skip-link` (`target` = id; vazio = o `<main>`) como primeiro item; no spine, `features.skipLink: true` |
311
+ | Avisar ao sair com alterações não salvas | `canDeactivate: [hermesUnsavedChangesGuard]` + `registerUnsavedChanges(() => form.dirty)` na tela; `provideHermesUnsavedChanges({ beforeUnload: true })`; no spine, `features.unsavedChanges` + `registerSpineUnsavedChanges` |
312
+ | Salvando / salvo às 14:32 / falhou | `hm-save-status` (`status` idle/dirty/saving/saved/error, `savedAt`, `retryable` → `(retry)`) |
313
+ | Índice da página com a seção atual | `hm-anchor-nav` (`items`, `sticky`, `offset`, `(activeChange)`) |
314
+ | Confirmar sem modal, ancorado no botão | `hm-popconfirm` (`heading`, `message`, `intent`, `(confirmed)`) + `[hmPopconfirmTrigger]`; destrutivo e irreversível continua `HermesDialogService.confirm` |
315
+ | Ação principal + variações no mesmo botão | `hm-split-button` (`label`, `items: MenuItem[]`, `(clicked)` principal, `(chosen)` variação) |
316
+ | Tour guiado / coachmark | `hm-tour` (`[(open)]`, `steps: TourStep[]` com `target`/`title`/`body`, `(finished)`/`(skipped)`) |
317
+ | Painel de baixo no celular / action sheet | `hm-bottom-sheet` (`[(open)]`, `snapPoints`, `[(snap)]`, `actions` → `(chosen)`); navegação inferior `hm-bottom-navigation` + `hm-bottom-navigation-item` (`hideAbove`) |
318
+ | Progresso circular | `hm-progress shape="circle"` |
319
+ | Mega menu | `hm-navigation-menu-item wide` com colunas `hm-navigation-menu-group` (`label`, `description`) |
320
+ | Editar na tabela | `hm-data-grid editMode="cell"` ou `"row"` + `editor` na coluna (`GridColumnEditor`: `type`, `validate`, `apply`); `(editSaved)` com as mudanças (a grade não grava: devolva `rows`); `editBatch` para salvar em lote; editor próprio `<ng-template hmCellEditor="chave">` — receitas §43 |
321
+ | Linhas com filhos (tree table), cabeçalho em dois níveis, sem zebra | `hm-data-grid` com `treeChildren` (`treeHasChildren` para carga sob demanda; `treePagination="roots"` pagina por raiz, `treeChildPageSize` mostra os filhos aos poucos), `columnGroups`, `[striped]="false"` |
322
+ | Mini gráfico de tendência / meta × realizado / cascata / bolhas | `hm-sparkline-chart` (`data`), `hm-bullet-chart` (`items: BulletItem[]`), `hm-waterfall-chart` (`steps`), `hm-scatter-chart` com `size` nos pontos + `sizeLabel`; medidor `hm-gauge-chart` (`animated`, `needle`, `ticks`) |
323
+ | Tags livres / cor / nota em estrelas (campos) | `hm-tag-input` (`suggestions`, `validate`, `max`), `hm-color-picker` (`swatches`), `hm-rating` (`allowHalf`, `readonly`) |
324
+ | JSON em árvore / logs / galeria / PDF | `hm-json-viewer` (`data`, `expandDepth`, `searchable`), `hm-log-viewer` (`entries: LogEntry[]`, `[(follow)]`, `[(levels)]`), `hm-image-gallery` + `hm-lightbox` (`images: GalleryImage[]`), `hm-pdf-viewer` (`src`, `page`, `zoom`) |
325
+ | Status com transições e motivo | `hm-status-select` (`definition: WorkflowDefinition`, `[(value)]`, `(transition)`; `[apply]="false"` para o app aplicar), `hm-status-badge`, `hm-reason-dialog`, `hm-change-history` |
326
+ | Prioridade, severidade, impacto, risco | `hm-level-badge`/`hm-level-select` (`scale` pronta ou `LevelScale` própria, `allowEmpty`) |
327
+ | Responsável, aprovação, prazo, SLA, execução | `hm-assignee-select` (`people`, `allowUnassigned`), `hm-approval` (`steps`, `(approve)`/`(reject)`), `hm-deadline`, `hm-sla`, `hm-execution-status` |
328
+ | Tarefas, raias, backlog, carga, Gantt, riscos | `hm-task-card`/`hm-task-list`/`hm-task-detail`/`hm-task-editor`, `hm-swimlane-board` (`lanes`, `laneOf`; troca de raia só com `allowLaneChange`), `hm-backlog`, `hm-workload`, `hm-workflow-editor`, `hm-gantt` (`items: GanttItem[]`; arrastar só com `editable` → `(taskChange)`), `hm-risk-register`; burndown = `burndownSeries` + `hm-line-chart` — receitas §46 |
329
+ | Escolher pessoa, equipe, papel, grupo… | `hm-entity-picker` (`entities: PeopleEntity[]`, `kind`, `multiple`) — não um `hm-combobox` com avatar montado à mão |
330
+ | Cartão de pessoa / lista de membros / organograma / permissões | `hm-user-card` (`jobTitle`, `roleName`, `presence`), `hm-member-list`, `hm-org-chart` (`nodes: OrgChartNode[]`), `hm-permission-matrix` (`[(grants)]`), `hm-access-summary`, `hm-access-policy-editor`, `hm-access-request`/`hm-access-request-review` |
331
+ | Cadastro, senha, verificação, passkey, troca de conta, consentimento | `hm-sign-up-form`, `hm-password-strength`, `hm-forgot-password-form`/`hm-new-password-form`, `hm-email-verification`, `hm-social-sign-in`/`hm-passkey-button`/`hm-magic-link-form` (a cerimônia e o provedor são do app), `hm-account-switcher`, `hm-account-closure`, `hm-terms-acceptance`, `hm-consent-preferences`, `hm-cookie-banner` |
332
+ | Presença, menções, reações | `hm-account-avatar presence`, `hm-textarea [mentionCandidates]` + `hm-mention-text`, `hm-message [reactions]` + `[reactionChoices]` → `(reactionToggle)` |
333
+ | Evento que se repete / arrastar evento | `recurrence` no `CalendarEvent` + `hm-recurrence-editor` (`[(rule)]`); `hm-event-calendar editable` → `(eventChange)` (o app grava e devolve `events`) |
334
+ | Horários livres para marcar / disponibilidade / agenda por recurso | `hm-slot-picker` (`availability`, `booked`, `duration` → `(book)`), `hm-availability-editor` (`WeeklyAvailability`), `hm-resource-calendar`, `hm-appointment-details` |
335
+ | Arquivos (recentes, favoritos), versões, permissões, cota | `hm-file-list`, `hm-file-versions`, `hm-file-permissions`, `hm-storage-usage` |
336
+ | Relatório agendado / histórico de envio | `hm-report-schedule` (`[(value)]`), `hm-report-history` (`runs`, `(retry)`) |
337
+ | Requisição e resposta de API / endpoint / feature flags | `hm-api-exchange` (`request`, `response`, `sensitiveHeaders`), `hm-endpoint-card`, `hm-feature-flags` (`flags` → `(toggle)`) |
338
+ | Produto, preço, carrinho, pedido, entrega, devolução | `hm-product-card`/`hm-product-list`/`hm-product-detail`/`hm-variant-picker`, `hm-price` (`amount`, `compareAt`), `hm-stock-status`, `hm-cart` (`lines`, `(quantityChange)`, `(checkout)`), `hm-order-summary`, `hm-order-detail`/`hm-order-status`/`hm-order-timeline`, `hm-shipping-options`, `hm-shipment-tracking`, `hm-return-request` |
339
+ | Meio de pagamento, cartão/IBAN/conta, pagamento, fatura, plano, finanças | `hm-payment-method-picker`, `hm-credit-card-field`, `hm-iban-field`, `hm-bank-account-field`, `hm-payment-form` (`tokenize` do provedor), `hm-transaction-detail`/`hm-transaction-status`/`hm-transaction-timeline`, `hm-payment-history`, `hm-invoice`, `hm-pricing-table`, `hm-plan-picker`, `hm-subscription-card`, `hm-usage-meter`, `hm-financial-summary`, `hm-balance-card`, `hm-budget-variance`, `hm-reconciliation` |
340
+ | Saúde, incidentes, alertas, métricas, trace, deploy, manutenção | `hm-health-status`, `hm-service-status-list`, `hm-uptime-bar`, `hm-sla-summary`, `hm-resource-usage`, `hm-incident-card`/`hm-incident-detail`, `hm-alert-rule-editor`, `hm-alert-history`, `hm-metric-explorer`, `hm-trace-waterfall`, `hm-service-map`, `hm-deploy-pipeline`, `hm-release-timeline`, `hm-environment-picker`, `hm-maintenance-window` |
341
+ | Integrações, conexão, webhooks, sincronização, mapeamento | `hm-integration-catalog`/`hm-integration-card`/`hm-integration-detail`, `hm-connected-account`, `hm-connection-wizard`, `hm-credentials-form`, `hm-database-connection-form`, `hm-connection-test`, `hm-webhook-editor`, `hm-webhook-deliveries`, `hm-sync-status`, `hm-sync-history`, `hm-field-mapping`, `hm-data-source-picker` |
342
+ | Endereço (campo e exibição) | `hm-address-field` (`PostalAddress`; `country`, `requiredFields`, `hiddenFields`, `(postalCodeComplete)` para buscar o CEP) com `hm-location-select`; exibir: `hm-address-view`/`hm-address-card`/`hm-address-picker`; em TS `formatAddressLines` |
343
+ | Placa / documento de outro país | `hm-vehicle-plate-input` (Mercosul e antiga), `hm-identity-document-input` (`[(country)]`, `[(documentType)]`) |
344
+ | Muitos marcadores, rota, street view | `hm-map-cluster` (em volta dos `hm-map-marker`), `hm-map-route` + `hm-route-directions`, `hm-street-view` (`@trismegisto/angular/map`; rota e imagens vêm do provedor do app) |
345
+ | Agente de IA: conversa, etapas, ferramentas, perguntas, campo de mensagem | `hm-message-scroller` + `hm-message`/`hm-bubble` (`scrollToMessage(id)`), `hm-prompt-input` (`[(value)]`, `attachments`, `models`/`efforts`, `streaming` → `(submitted)`/`(stopped)`/`(filesAdded)`), `hm-questionnaire` (`questions`, `[(answers)]`, `shortcuts` → `(submitted)`; estado em `@trismegisto/primitives/questionnaire`), `hm-trace` + `hm-agent-tool` (`parameters`, `result`, `error`), `hm-tool-confirmation` (aprovação, fora do trace), `hm-reasoning`, `hm-chain-of-thought` + `hm-agent-search-results`, `hm-agent-plan`/`hm-agent-task`/`hm-agent-queue`/`hm-subagent`, `hm-agent-sources`/`hm-inline-citation`, `hm-context-usage`, `hm-model-selector`, `hm-checkpoint`, `hm-file-tree`, `hm-agent-terminal`, `hm-test-results`, `hm-stack-trace`, `hm-prompt-suggestions` |
296
346
 
297
347
  Inputs exatos de cada um: `angular-api.md`.
298
348
 
299
349
  ## 5. Quando não existe componente
300
350
 
301
- Hoje não há peça genérica conhecida faltando. **Não invente** um `hm-*` que não esteja em `angular-api.md`
302
- (ou, para mapas e gráficos, nos pacotes `@trismegisto/maps`/`@trismegisto/charts`): o build quebra.
351
+ **Não invente** um `hm-*` que não esteja em `angular-api.md` (mapas, gráficos e terminal estão lá, nos
352
+ pontos `@trismegisto/angular/map|charts|terminal`): o build quebra. Antes de compor, confira as famílias de domínio genérico
353
+ (workflow, pessoas, comércio, pagamentos, monitoramento, integrações… — SKILL.md §6 e as linhas acima): muita tela
354
+ "de negócio" já tem peça.
303
355
 
304
- Se a peça de que você precisa não está no catálogo (por exemplo, algo de domínio do app, como a marca ou um
305
- cartão de negócio), componha com os `hm-*` existentes e as classes utilitárias do `@trismegisto/core`; só crie
356
+ Se a peça de que você precisa não está no catálogo (algo específico do app, como a marca ou um cartão com regra
357
+ de negócio própria), componha com os `hm-*` existentes e as classes utilitárias do `@trismegisto/core`; só crie
306
358
  HTML/CSS próprio quando nem isso resolver.
307
359
 
308
360
  Ao criar algo local assim: use apenas tokens, mantenha acessível (rótulo, foco visível, teclado) e marque com
@@ -324,9 +376,14 @@ Esta skill descreve a 2.0.0. Ao migrar código de uma 0.x:
324
376
  - ilustrações `hm-illustration-file-upload`, `hm-illustration-file-transfer`, `hm-illustration-message` e as
325
377
  situações `uploading`, `transfer` e `message` do `hm-state-screen` → use outra situação (ex.: `empty`) ou
326
378
  projete outro desenho no slot `[illustration]`.
327
- - **Depreciados** (ainda funcionam, com aviso em desenvolvimento; não use em código novo): `hm-field` → `hm-input`;
328
- `help` → `hint`; `busy` → `loading` (botão); `hm-tag color="error"` → `"danger"`; `[startControl]`/`[endControl]`
329
- e `start`/`end` do `hm-date-range-picker` → valor `DateRange`; `STATE_PAGE_PRESETS` (fixo em pt-BR) → `statePagePreset(kind, messages)`.
379
+ - **Removidos na 3.3.1**: `hm-field` → `hm-input`; `STATE_PAGE_PRESETS` → `statePagePreset(kind, messages)`;
380
+ `provideHermesMessages` → `provideHermesI18n`; `[requiredManual]` do `hm-combobox` → `required`; `help` do
381
+ `hm-combobox-multi` → `hint`; `[(start)]`/`[(end)]` do `hm-date-range-picker` → `[(value)]` com `DateRange`;
382
+ `HermesSidebarService.doc` → `inject(DOCUMENT)`. `hm-session-recovery` sem `allowedOrigins` só aceita a mesma
383
+ origem.
384
+ - **Depreciados** (ainda funcionam, com aviso em desenvolvimento; não use em código novo): `help` → `hint`
385
+ (`hm-combobox`, `hm-textarea`, `hm-radio`, `hm-switch`); `busy` → `loading` (botão); `hm-tag color="error"` →
386
+ `"danger"`; `[startControl]`/`[endControl]` do `hm-date-range-picker` → valor `DateRange`.
330
387
  `angular-api.md` marca cada item depreciado.
331
388
  - **Ilustrações** e páginas de estado (`hm-state-page`, inclusive `outdated`): `../SKILL.md` §5.
332
389
 
@@ -406,5 +463,28 @@ expect(await name.getErrorText()).toBe('');
406
463
  o nome no catálogo.
407
464
  - **Não sobrescreva o DOM interno** (`.hm-btn__…`, `.hm-field__…`) nem teste por ele: muda entre versões. Ajuste
408
465
  por input, slot ou token; teste por harness.
409
- - **Gráficos pesam** (~215 kB gzip): carregue `@trismegisto/charts` sob demanda (`@defer` ou rota lazy).
466
+ - **Gráficos pesam** (~215 kB gzip): carregue a tela de `@trismegisto/angular/charts` sob demanda (`@defer` ou rota lazy).
410
467
  - **Cor própria só por token**: um `#hex` no SCSS da tela não acompanha tema escuro, família nem alto contraste.
468
+
469
+ ## 9. Gráficos, mapas e terminal: núcleo + casca (desde a 3.4.0)
470
+
471
+ `@trismegisto/charts`, `@trismegisto/maps` e `@trismegisto/terminal` são **núcleos sem framework** (dados, tipos, motor,
472
+ catálogos de texto, a classe `Terminal`). Os componentes Angular moram no `@trismegisto/angular`, em pontos de import
473
+ próprios, **fora do barrel** `@trismegisto/angular` (o núcleo é peer opcional: reexportar quebraria o build de quem
474
+ não o instalou). O mesmo vale para o React (`react.md` §4).
475
+
476
+ | Peça | Instale | Componentes (casca Angular) | Do núcleo |
477
+ |---|---|---|---|
478
+ | Gráficos | `@trismegisto/charts` | `@trismegisto/angular/charts`: `HmBarChartComponent`… `HmChartComponent`, `ChartsI18nService`, `provideChartsMessages`, tipos `Hm*SeriesOption`/`HmChartOption` | `@trismegisto/charts`: `ChartSeries`, `ChartDatum`, `CHARTS_MESSAGES_*`; `@trismegisto/charts/engine`: o motor |
479
+ | Mapas | `@trismegisto/maps` | `@trismegisto/angular/map`: `MapComponent`… `HM_MAP_COMPONENTS`, `MAPS_MESSAGES`, `provideMapsMessages` | `@trismegisto/maps`: `GeoJsonFeatureCollection`, `BasemapLayer`, `MapRoute`, `MAPS_MESSAGES_*`; `@trismegisto/maps/basemaps/<id>` |
480
+ | Terminal | `@trismegisto/terminal` | `@trismegisto/angular/terminal`: `TerminalComponent` (`hm-terminal`), `TERMINAL_MESSAGES`, `provideTerminalMessages` | `@trismegisto/terminal`: `Terminal`, `FitAddon`, `SearchAddon`, `WebLinksAddon`, `TERMINAL_MESSAGES_*` |
481
+
482
+ - **Regra dos peers opcionais:** sem o núcleo instalado, o import da casca não resolve (erro de build). Instale o núcleo
483
+ **na mesma versão** das outras libs, só no app que usa a peça.
484
+ - **A casca reexporta só tipos** das entradas e saídas; valor do núcleo (catálogo, classe, função) se importa do núcleo.
485
+ Não existe alias de um lado no outro.
486
+ - **Migração da 3.3.x:** troque `import { … } from '@trismegisto/charts'` (componentes, `provideChartsMessages`) por
487
+ `@trismegisto/angular/charts`; `@trismegisto/maps` (componentes, `HM_MAP_COMPONENTS`, `provideMapsMessages`) por
488
+ `@trismegisto/angular/map` (singular); `@trismegisto/terminal` (`TerminalComponent`, `provideTerminalMessages`) por
489
+ `@trismegisto/angular/terminal`. Tipos de dados e catálogos `*_MESSAGES_PT_BR/_EN/_ES` ficam no núcleo. O seletor
490
+ (`hm-bar-chart`, `hm-map`, `hm-terminal`) e os inputs não mudam.
@@ -113,6 +113,7 @@
113
113
  "bookmark-element",
114
114
  "box-open",
115
115
  "box-plot",
116
+ "breadcrumbs",
116
117
  "briefcase",
117
118
  "briefcase-bag",
118
119
  "browser-click",
@@ -260,6 +261,7 @@
260
261
  "container",
261
262
  "container-group",
262
263
  "container-volume",
264
+ "content-placeholder",
263
265
  "contract",
264
266
  "control-lun",
265
267
  "copy",
@@ -530,6 +532,7 @@
530
532
  "list",
531
533
  "list-bullets",
532
534
  "list-check",
535
+ "loading-ring",
533
536
  "lock",
534
537
  "lock-close",
535
538
  "lock-open",
@@ -604,6 +607,8 @@
604
607
  "outdent",
605
608
  "paint-roller",
606
609
  "palmTree",
610
+ "panel-center",
611
+ "panel-split",
607
612
  "paper-detached",
608
613
  "paperclip",
609
614
  "passport",
@@ -766,6 +771,7 @@
766
771
  "star-fill",
767
772
  "step-forward",
768
773
  "step-forward-2",
774
+ "step-progress",
769
775
  "stop",
770
776
  "storage",
771
777
  "storage-adapter",
@@ -788,6 +794,7 @@
788
794
  "switch",
789
795
  "sync",
790
796
  "t-square",
797
+ "tab-panel",
791
798
  "table",
792
799
  "table-edit",
793
800
  "table-pen",