@acropole/skills 1.7.1 → 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 (42) hide show
  1. package/README.md +5 -4
  2. package/agents/revisor-orfeu.md +2 -1
  3. package/package.json +1 -1
  4. package/skills/acropole/references/fluxos/atualizar-libs-2026-10.md +2 -2
  5. package/skills/angular/SKILL.md +2 -2
  6. package/skills/angular/references/dados.md +3 -3
  7. package/skills/angular/references/estrutura.md +6 -5
  8. package/skills/angular/references/features.md +5 -5
  9. package/skills/angular/references/testes-build.md +1 -1
  10. package/skills/auto-servico/SKILL.md +18 -14
  11. package/skills/express/references/dados.md +4 -1
  12. package/skills/express/references/estrutura.md +2 -1
  13. package/skills/fastapi/references/banco.md +6 -2
  14. package/skills/fastapi/references/estrutura.md +1 -1
  15. package/skills/hefesto/SKILL.md +6 -2
  16. package/skills/orfeu/SKILL.md +43 -13
  17. package/skills/orfeu/references/angular-api.md +39 -13
  18. package/skills/orfeu/references/angular-armadilhas.md +18 -1
  19. package/skills/orfeu/references/angular-recipes.md +25 -12
  20. package/skills/orfeu/references/angular.md +37 -15
  21. package/skills/orfeu/references/diferencas.md +17 -8
  22. package/skills/orfeu/references/node-api.md +41 -9
  23. package/skills/orfeu/references/node-armadilhas.md +16 -2
  24. package/skills/orfeu/references/node-recipes.md +13 -4
  25. package/skills/orfeu/references/node.md +31 -12
  26. package/skills/orfeu/references/python-api.md +41 -16
  27. package/skills/orfeu/references/python-recipes.md +13 -9
  28. package/skills/orfeu/references/python.md +33 -12
  29. package/skills/orfeu/references/react.md +133 -0
  30. package/skills/trismegisto/SKILL.md +42 -29
  31. package/skills/trismegisto/references/angular-api.md +608 -6
  32. package/skills/trismegisto/references/angular-exports.md +479 -791
  33. package/skills/trismegisto/references/angular-recipes.md +13 -7
  34. package/skills/trismegisto/references/angular.md +32 -9
  35. package/skills/trismegisto/references/catalogo/imports.json +1627 -0
  36. package/skills/trismegisto/references/catalogo/seletores.json +90 -65
  37. package/skills/trismegisto/references/react-api.md +16864 -0
  38. package/skills/trismegisto/references/react.md +237 -0
  39. package/skills/trismegisto/references/spine-api.md +5565 -1973
  40. package/skills/trismegisto/references/spine-recipes.md +113 -26
  41. package/skills/trismegisto/references/spine.md +95 -33
  42. package/skills/trismegisto/scripts/checar.mjs +66 -1
@@ -1836,10 +1836,13 @@ com `[announce]="false"` para não ser lido como mensagem.
1836
1836
  `submitKey="enter"`: Enter envia e Shift+Enter quebra linha; `mod-enter` exige Ctrl/⌘. Os anexos usam os
1837
1837
  mesmos textos de estado do `hm-file-upload` (`UploadFile` serve de modelo).
1838
1838
 
1839
- ## 36. Mapa com marcadores e GeoJSON (`@trismegisto/maps`)
1839
+ ## 36. Mapa com marcadores e GeoJSON (`@trismegisto/angular/map`)
1840
+
1841
+ Instale o núcleo `@trismegisto/maps` (peer opcional) e importe as peças da casca, que fica fora do barrel:
1840
1842
 
1841
1843
  ```ts
1842
- import { HM_MAP_COMPONENTS } from '@trismegisto/maps';
1844
+ import { HM_MAP_COMPONENTS } from '@trismegisto/angular/map';
1845
+ import type { GeoJsonFeatureCollection } from '@trismegisto/maps'; // tipos e dados do núcleo
1843
1846
  ```
1844
1847
  ```html
1845
1848
  <hm-map
@@ -1861,12 +1864,15 @@ import { HM_MAP_COMPONENTS } from '@trismegisto/maps';
1861
1864
  Tiles raster por `tileUrl` com a `attribution` exigida pelo provedor (OpenStreetMap, servidor próprio ou
1862
1865
  contratado); sem `tileUrl`, um mapa base embutido (`<hm-map-basemap layer="br/ufs" />`); valor por região é
1863
1866
  `hm-map-choropleth`. Textos do mapa seguem
1864
- `setLocale`; para sobrescrever, `provideMapsMessages({ override })`.
1867
+ `setLocale`; para sobrescrever, `provideMapsMessages({ override })` (`@trismegisto/angular/map`).
1868
+
1869
+ ## 37. Gráficos (`@trismegisto/angular/charts`)
1865
1870
 
1866
- ## 37. Gráficos (`@trismegisto/charts`)
1871
+ Instale o núcleo `@trismegisto/charts` (peer opcional). Componentes da casca; tipos dos dados, do núcleo:
1867
1872
 
1868
1873
  ```ts
1869
- import { HmBarChartComponent, HmLineChartComponent, type ChartSeries } from '@trismegisto/charts';
1874
+ import { HmBarChartComponent, HmLineChartComponent } from '@trismegisto/angular/charts';
1875
+ import type { ChartSeries } from '@trismegisto/charts';
1870
1876
  ```
1871
1877
  ```html
1872
1878
  <hm-bar-chart label="Receita por trimestre" description="O 4º trimestre puxou o ano."
@@ -1882,7 +1888,7 @@ Cada um já traz: cores de `--hm-data-*`, resumo automático no idioma ativo lig
1882
1888
  `null` em `data` é lacuna (a linha interrompe, a tabela mostra traço). `hm-chart` recebe a opção crua do motor
1883
1889
  (`HmChartOption`) e `points` para teclado/tabela: use só quando nenhum tipado servir. O pacote é grande
1884
1890
  (~215 kB gzip): carregue a tela de gráficos com `@defer` ou rota lazy. Textos seguem `setLocale`; para
1885
- sobrescrever, `provideChartsMessages({ override })`.
1891
+ sobrescrever, `provideChartsMessages({ override })` (`@trismegisto/angular/charts`).
1886
1892
 
1887
1893
  ## 38. Listas ordenadas digitadas (`hm-list-editor`, 2.2+)
1888
1894
 
@@ -2053,7 +2059,7 @@ readonly grupos: GridColumnGroup[] = [{ key: 'plano', title: 'Planejado', column
2053
2059
 
2054
2060
  ```ts
2055
2061
  import { HmSparklineChartComponent, HmBulletChartComponent, HmWaterfallChartComponent, HmScatterChartComponent,
2056
- HmGaugeChartComponent } from '@trismegisto/charts';
2062
+ HmGaugeChartComponent } from '@trismegisto/angular/charts';
2057
2063
  ```
2058
2064
  ```html
2059
2065
  <hm-stat-card label="Receita" [value]="receita()">
@@ -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
 
@@ -274,8 +274,8 @@ escolha o que o resto do app usa, não misture no mesmo campo:
274
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` |
275
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 |
276
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`) |
277
- | 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 |
278
- | 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 |
279
279
  | Saber se o componente está em `rtl` | `isRtl(elemento)` / `elementDirection()` de `@trismegisto/angular` na hora do gesto (não guarde o valor) |
280
280
  | Indicador (um número) | `hm-stat-card` (`description`, `details`, `trend`, `hint`, `size`, `loading`; filtro: `selectable` + `[selected]` + `(selectedChange)`, controlado) |
281
281
  | Várias métricas sob um título + "ver mais" | `hm-stat-group` (`heading`, `[metrics]: StatGroupMetric[]`, `moreLabel`/`moreLink`/`moreAction` + `(more)`, `loading`) |
@@ -341,15 +341,15 @@ escolha o que o resto do app usa, não misture no mesmo campo:
341
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
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
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/maps`; rota e imagens vêm do provedor do app) |
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
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` |
346
346
 
347
347
  Inputs exatos de cada um: `angular-api.md`.
348
348
 
349
349
  ## 5. Quando não existe componente
350
350
 
351
- **Não invente** um `hm-*` que não esteja em `angular-api.md` (ou, para mapas e gráficos, nos pacotes
352
- `@trismegisto/maps`/`@trismegisto/charts`): o build quebra. Antes de compor, confira as famílias de domínio genérico
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
353
  (workflow, pessoas, comércio, pagamentos, monitoramento, integrações… — SKILL.md §6 e as linhas acima): muita tela
354
354
  "de negócio" já tem peça.
355
355
 
@@ -463,5 +463,28 @@ expect(await name.getErrorText()).toBe('');
463
463
  o nome no catálogo.
464
464
  - **Não sobrescreva o DOM interno** (`.hm-btn__…`, `.hm-field__…`) nem teste por ele: muda entre versões. Ajuste
465
465
  por input, slot ou token; teste por harness.
466
- - **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).
467
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.