@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.
- package/README.md +5 -4
- package/agents/revisor-orfeu.md +2 -1
- package/package.json +1 -1
- package/skills/acropole/references/fluxos/atualizar-libs-2026-10.md +2 -2
- package/skills/angular/SKILL.md +2 -2
- 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/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 +6 -2
- 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/trismegisto/SKILL.md +42 -29
- package/skills/trismegisto/references/angular-api.md +608 -6
- package/skills/trismegisto/references/angular-exports.md +479 -791
- package/skills/trismegisto/references/angular-recipes.md +13 -7
- package/skills/trismegisto/references/angular.md +32 -9
- package/skills/trismegisto/references/catalogo/imports.json +1627 -0
- package/skills/trismegisto/references/catalogo/seletores.json +90 -65
- package/skills/trismegisto/references/react-api.md +16864 -0
- package/skills/trismegisto/references/react.md +237 -0
- package/skills/trismegisto/references/spine-api.md +5565 -1973
- package/skills/trismegisto/references/spine-recipes.md +113 -26
- package/skills/trismegisto/references/spine.md +95 -33
- 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/
|
|
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/
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
|
@@ -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
|
|
278
|
-
| 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 |
|
|
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/
|
|
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` (
|
|
352
|
-
`@trismegisto/
|
|
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.
|