@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
|
@@ -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
|
|
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
|
|
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
|
-
-
|
|
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)
|
|
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
|
|
270
|
-
| Mapa (mundo/Brasil, coroplético, marcadores, GeoJSON) | `@trismegisto/
|
|
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
|
-
|
|
302
|
-
|
|
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 (
|
|
305
|
-
|
|
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
|
-
- **
|
|
328
|
-
`
|
|
329
|
-
|
|
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",
|