@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
@@ -1,7 +1,7 @@
1
1
  # Catálogo de API — @trismegisto/angular
2
2
 
3
- > **Gerado** a partir do código-fonte da versão 3.3.11, a cada `npm run sync` do @acropole/skills.
4
- > Gerado do código-fonte do `@trismegisto/angular` 3.3.11. Confira a versão instalada no `package.json` do pacote em `node_modules`.
3
+ > **Gerado** a partir do código-fonte da versão 3.4.0, a cada `npm run sync` do @acropole/skills.
4
+ > Gerado do código-fonte do `@trismegisto/angular` 3.4.0. Confira a versão instalada no `package.json` do pacote em `node_modules`.
5
5
 
6
6
  Legenda: `input` = `[prop]`; `model` = two-way `[(prop)]`; `output` = `(evento)`.
7
7
  Slots são os seletores de `<ng-content>`: projete com o atributo (ex.: `<div footer>`).
@@ -899,7 +899,7 @@ Backlog e sprints: seções empilhadas (as sprints, com datas, meta e capacidade
899
899
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
900
900
  |---|---|---|---|---|
901
901
  | `sections` | model | `readonly BacklogSection<T>[]` | `[]` | |
902
- | `itemKey` | input | `(item: T) => unknown` | `(item: T) => (item as { id?: unknown })?.id ?? it…` | Identidade do item (o `track`). Padrão: `id` quando existe, senão o próprio objeto. |
902
+ | `itemKey` | input | `(item: T) => unknown` | `(item: T) => backlogItemKey(item)` | Identidade do item (o `track`). Padrão: `id` quando existe, senão o próprio objeto. |
903
903
  | `itemLabel` | input | `((item: T) => string) \| null` | `null` | Nome falado do item nos anúncios. Padrão: `title`. |
904
904
  | `priorityScale` | input | `LevelScaleInput` | `'priority'` | |
905
905
  | `headingLevel` | input | `number` | `3` | |
@@ -1375,6 +1375,307 @@ Histórico de um item: mudanças de status, de campos e de responsável, criaç
1375
1375
  | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | |
1376
1376
  | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
1377
1377
 
1378
+ ## `hm-bar-chart`
1379
+
1380
+ `HmBarChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1381
+
1382
+ Barras por categoria: uma ou várias séries, agrupadas (padrão) ou empilhadas, em pé ou deitadas.
1383
+
1384
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1385
+ |---|---|---|---|---|
1386
+ | `categories` | input (obrigatório) | `readonly string[]` | | Rótulos das categorias (eixo de categorias), na ordem dos valores de cada série. |
1387
+ | `series` | input (obrigatório) | `readonly ChartSeries[]` | | |
1388
+ | `orientation` | input | `BarChartOrientation` | `'vertical'` | `vertical`: barras em pé; `horizontal`: deitadas (rótulos longos cabem melhor). |
1389
+ | `stacked` | input | `boolean` | `false` | Empilha as séries (soma por categoria) em vez de agrupá-las lado a lado. |
1390
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1391
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1392
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1393
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1394
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1395
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1396
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1397
+
1398
+ ## `hm-boxplot-chart`
1399
+
1400
+ `HmBoxplotChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1401
+
1402
+ Distribuição de uma medida por grupo (tempo de atendimento por equipe, ticket por região).
1403
+
1404
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1405
+ |---|---|---|---|---|
1406
+ | `data` | input (obrigatório) | `readonly BoxplotGroup[]` | | |
1407
+ | `orientation` | input | `'vertical' \| 'horizontal'` | `'vertical'` | `vertical`: caixas em pé; `horizontal`: deitadas. |
1408
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1409
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1410
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1411
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1412
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1413
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1414
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1415
+
1416
+ ## `hm-bullet-chart`
1417
+
1418
+ `HmBulletChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1419
+
1420
+ Gráfico de bala: cada linha é um indicador com o valor (barra fina na cor da série), a meta (marca vertical) e as faixas qualitativas ao fundo. Substitui um painel de medidores lado a lado em pouco espaço, com todos na mesma escala.
1421
+
1422
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1423
+ |---|---|---|---|---|
1424
+ | `items` | input (obrigatório) | `readonly BulletItem[]` | | |
1425
+ | `max` | input | `number \| null` | `null` | Fim da escala (comum a todos); padrão: um valor redondo que cobre valores, metas e faixas. |
1426
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1427
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1428
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1429
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1430
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1431
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1432
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1433
+
1434
+ ## `hm-calendar-heatmap`
1435
+
1436
+ `HmCalendarHeatmapComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1437
+
1438
+ Mapa de calor de calendário: um quadrado por dia, semanas em colunas (atividade diária, volume de pedidos). Nomes de mês e dia da semana seguem o idioma ativo.
1439
+
1440
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1441
+ |---|---|---|---|---|
1442
+ | `data` | input (obrigatório) | `readonly CalendarDatum[]` | | |
1443
+ | `range` | input | `string \| readonly [Date \| string, Date \| string] \| null` | `null` | Período desenhado: ano (`'2026'`), mês (`'2026-03'`) ou `[início, fim]`. Padrão: do primeiro ao último dia de `data`. |
1444
+ | `dateFormat` | input | `Intl.DateTimeFormatOptions \| null` | `null` | Formato da data no tooltip e na tabela (`Intl.DateTimeFormat`). |
1445
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1446
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1447
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1448
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1449
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1450
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1451
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1452
+
1453
+ ## `hm-chart`
1454
+
1455
+ `HmChartComponent` — import de `@trismegisto/angular/charts`
1456
+
1457
+ Gráfico genérico: recebe a opção completa do motor e liga as entradas ao `ChartHost` do núcleo, que cuida do ciclo de vida (criação, troca de opção, redimensionamento e descarte), do tema lido dos tokens, do idioma, de `prefers-reduced-motion` e de `forced-colors`. Renderização sempre em SVG. É a saída de emergência para o que os gráficos tipados (`hm-bar-chart`...) não cobrem.
1458
+
1459
+ Métodos públicos: `leave(): void`
1460
+
1461
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1462
+ |---|---|---|---|---|
1463
+ | `option` | input (obrigatório) | `HmChartOption` | | Opção completa do gráfico (séries, eixos, legenda...). Trocar a referência redesenha. |
1464
+ | `label` | input | `string` | `''` | Nome acessível do gráfico (texto do app, já traduzido). |
1465
+ | `points` | input | `readonly ChartPoint[]` | `[]` | Pontos navegáveis com as setas. Vazio: o gráfico não entra na ordem de foco. |
1466
+
1467
+ ## `hm-funnel-chart`
1468
+
1469
+ `HmFunnelChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1470
+
1471
+ Etapas sucessivas de um processo (visitas → cadastros → compras). A ordem de `data` é a ordem das etapas; a coluna de participação da tabela é a conversão em relação à primeira etapa.
1472
+
1473
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1474
+ |---|---|---|---|---|
1475
+ | `data` | input (obrigatório) | `readonly ChartDatum[]` | | |
1476
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1477
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1478
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1479
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1480
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1481
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1482
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1483
+
1484
+ ## `hm-gauge-chart`
1485
+
1486
+ `HmGaugeChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1487
+
1488
+ Um valor numa escala (meta atingida, ocupação, SLA). Para vários indicadores, vários medidores. Arco de 240° com a escala por fora, agulha e valor no centro; ao aparecer e a cada troca de valor, o arco preenche animado do valor anterior até o novo, com a agulha e o número acompanhando.
1489
+
1490
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1491
+ |---|---|---|---|---|
1492
+ | `value` | input (obrigatório) | `number` | | |
1493
+ | `min` | input | `number` | `0` | |
1494
+ | `max` | input | `number` | `100` | |
1495
+ | `animated` | input | `boolean` | `true` | Preenche o arco animado ao aparecer e a cada troca de valor (do valor anterior até o novo). Com `prefers-reduced-motion`, nunca anima. O resumo e a tabela já t… |
1496
+ | `needle` | input | `boolean` | `true` | Agulha que gira junto com a ponta do arco. Sem ela, o valor vai para o centro do arco. |
1497
+ | `ticks` | input | `boolean` | `true` | Marcas da escala por fora do arco, com rótulos. Desligado, só o mínimo e o máximo aparecem. |
1498
+ | `tickStep` | input | `number \| null` | `null` | Intervalo entre as marcas, na unidade do valor; padrão (ou intervalo que não divide a escala): um décimo. |
1499
+ | `caption` | input | `string` | `''` | Legenda curta abaixo do valor (ex.: "das PAs conectadas"); entra também no resumo acessível. |
1500
+ | `valueFormat` | input | `Intl.NumberFormatOptions \| null` | `null` | Formato do valor no centro, quando difere do `numberFormat` (que vale para a escala e a tabela). |
1501
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1502
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1503
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1504
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1505
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1506
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1507
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1508
+
1509
+ ## `hm-heatmap-chart`
1510
+
1511
+ `HmHeatmapChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1512
+
1513
+ Mapa de calor cartesiano: intensidade por cruzamento de duas categorias (dia × hora, região × produto). A escala de cor é a sequencial dos tokens; `legend` liga a régua de valores.
1514
+
1515
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1516
+ |---|---|---|---|---|
1517
+ | `data` | input (obrigatório) | `readonly HeatmapCell[]` | | |
1518
+ | `xCategories` | input | `readonly string[] \| null` | `null` | Ordem das colunas; padrão: a ordem em que aparecem em `data`. |
1519
+ | `yCategories` | input | `readonly string[] \| null` | `null` | Ordem das linhas; padrão: a ordem em que aparecem em `data`. |
1520
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1521
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1522
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1523
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1524
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1525
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1526
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1527
+
1528
+ ## `hm-line-chart`
1529
+
1530
+ `HmLineChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1531
+
1532
+ Linhas por categoria (tempo, etapas ordenadas); com `area`, preenche abaixo da linha.
1533
+
1534
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1535
+ |---|---|---|---|---|
1536
+ | `categories` | input (obrigatório) | `readonly string[]` | | |
1537
+ | `series` | input (obrigatório) | `readonly ChartSeries[]` | | |
1538
+ | `area` | input | `boolean` | `false` | Preenche a área sob cada linha (gráfico de área). |
1539
+ | `stacked` | input | `boolean` | `false` | Empilha as séries (útil com `area` para mostrar a composição do total). |
1540
+ | `smooth` | input | `boolean` | `false` | Suaviza a linha entre os pontos. |
1541
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1542
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1543
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1544
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1545
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1546
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1547
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1548
+
1549
+ ## `hm-pie-chart`
1550
+
1551
+ `HmPieChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1552
+
1553
+ Partes de um todo; com `donut`, rosca (o centro fica livre). Prefira poucas fatias (até ~6).
1554
+
1555
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1556
+ |---|---|---|---|---|
1557
+ | `data` | input (obrigatório) | `readonly ChartDatum[]` | | |
1558
+ | `donut` | input | `boolean` | `false` | Rosca em vez de pizza. |
1559
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1560
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1561
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1562
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1563
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1564
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1565
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1566
+
1567
+ ## `hm-radar-chart`
1568
+
1569
+ `HmRadarChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1570
+
1571
+ Perfis comparados em vários critérios (avaliação de fornecedores, competências). Até ~8 eixos.
1572
+
1573
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1574
+ |---|---|---|---|---|
1575
+ | `indicators` | input (obrigatório) | `readonly RadarIndicator[]` | | |
1576
+ | `series` | input (obrigatório) | `readonly RadarSeries[]` | | |
1577
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1578
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1579
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1580
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1581
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1582
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1583
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1584
+
1585
+ ## `hm-sankey-chart`
1586
+
1587
+ `HmSankeyChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1588
+
1589
+ Fluxos entre etapas ou origens (canal → plano → status). Os nós saem dos `links`; sem ciclos.
1590
+
1591
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1592
+ |---|---|---|---|---|
1593
+ | `links` | input (obrigatório) | `readonly SankeyLink[]` | | |
1594
+ | `nodes` | input | `readonly string[] \| null` | `null` | Ordem dos nós; padrão: a ordem em que aparecem nos links. |
1595
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1596
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1597
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1598
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1599
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1600
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1601
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1602
+
1603
+ ## `hm-scatter-chart`
1604
+
1605
+ `HmScatterChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1606
+
1607
+ Relação entre duas medidas (preço × volume, prazo × satisfação), uma ou várias séries. Com `size` nos pontos, vira gráfico de bolhas (a área de cada bolha mostra uma terceira medida).
1608
+
1609
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1610
+ |---|---|---|---|---|
1611
+ | `series` | input (obrigatório) | `readonly ScatterSeries[]` | | |
1612
+ | `xLabel` | input | `string` | `''` | Nome do eixo horizontal (texto do app). |
1613
+ | `yLabel` | input | `string` | `''` | Nome do eixo vertical (texto do app). |
1614
+ | `sizeLabel` | input | `string` | `''` | Nome da medida do tamanho das bolhas (texto do app); padrão "Tamanho". |
1615
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1616
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1617
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1618
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1619
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1620
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1621
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1622
+
1623
+ ## `hm-sparkline-chart`
1624
+
1625
+ `HmSparklineChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1626
+
1627
+ Minigráfico: a tendência de uma série em pouco espaço, sem eixos nem legenda (dentro de um card de indicador, numa linha de tabela). O resumo (primeiro, último, mínimo e máximo) e a tabela de dados ficam na árvore de acessibilidade; sem o botão "Ver como tabela", para caber no `[footer]` do `hm-stat-card`.
1628
+
1629
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1630
+ |---|---|---|---|---|
1631
+ | `data` | input (obrigatório) | `readonly (number \| null)[]` | | Valores na ordem (o mais antigo primeiro); `null` é lacuna. |
1632
+ | `categories` | input | `readonly string[]` | `[]` | Rótulo de cada valor (datas, meses) para a tabela e o tooltip; padrão: a posição (1, 2, 3...). |
1633
+ | `area` | input | `boolean` | `false` | Preenche a área sob a linha. |
1634
+ | `showLast` | input | `boolean` | `true` | Destaca o último ponto (o valor atual). |
1635
+ | `bars` | input | `boolean` | `false` | Barras em vez de linha (valores discretos: pedidos por dia). |
1636
+ | `interactive` | input | `boolean` | `false` | Entra na ordem de foco e mostra o tooltip (setas percorrem os pontos). Desligado (padrão), o minigráfico é só uma imagem com resumo: um card de indicador não g… |
1637
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1638
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1639
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1640
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1641
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1642
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1643
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1644
+
1645
+ ## `hm-treemap-chart`
1646
+
1647
+ `HmTreemapChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1648
+
1649
+ Composição hierárquica por área (orçamento por área → projeto, vendas por região → loja).
1650
+
1651
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1652
+ |---|---|---|---|---|
1653
+ | `data` | input (obrigatório) | `readonly TreemapNode[]` | | |
1654
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1655
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1656
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1657
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1658
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1659
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1660
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1661
+
1662
+ ## `hm-waterfall-chart`
1663
+
1664
+ `HmWaterfallChartComponent` · estende `HmChartBase` — import de `@trismegisto/angular/charts`
1665
+
1666
+ Gráfico de cascata: como um valor inicial chega ao final, etapa por etapa (receita → custos → lucro). Aumentos e reduções flutuam a partir do acumulado; totais partem do zero. Cores da escala divergente dos tokens (um polo para aumento, outro para redução, o ponto neutro para totais).
1667
+
1668
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1669
+ |---|---|---|---|---|
1670
+ | `steps` | input (obrigatório) | `readonly WaterfallStep[]` | | |
1671
+ | `label` | input (obrigatório) (herdado) | `string` | | Nome acessível do gráfico (obrigatório); também vira a legenda da tabela de dados. |
1672
+ | `description` | input (herdado) | `string` | `''` | Frase extra do app somada ao resumo automático (contexto, conclusão, fonte dos dados). |
1673
+ | `legend` | input (herdado) | `boolean` | `true` | Mostra a legenda (quando o gráfico tem mais de uma série/categoria). |
1674
+ | `tooltip` | input (herdado) | `boolean` | `true` | Mostra o tooltip ao passar o ponteiro ou navegar com as setas. |
1675
+ | `height` | input (herdado) | `string` | `''` | Altura do gráfico (qualquer comprimento CSS); padrão: oito alturas de controle. |
1676
+ | `numberFormat` | input (herdado) | `Intl.NumberFormatOptions \| null` | `null` | Formato dos valores (`Intl.NumberFormat`, no idioma ativo): moeda, porcentagem, compacto... |
1677
+ | `showTable` | model (herdado) | `boolean` | `false` | Mostra a tabela de dados no lugar do gráfico. |
1678
+
1378
1679
  ## `hm-checkbox-group`
1379
1680
 
1380
1681
  `CheckboxGroupComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/checkbox-group` (também na raiz)
@@ -1500,7 +1801,7 @@ N caixas de dígito único, com avanço automático ao digitar e retrocesso ao a
1500
1801
 
1501
1802
  `CodeLineDirective` — import de `@trismegisto/angular/code-viewer`
1502
1803
 
1503
- Desenha UMA linha de código no elemento: tokens como `<span class="hm-code-token--<kind>">` (só classe, `kind` validado contra a lista fechada), texto sempre por nó de texto (nunca HTML), trechos intra-linha do diff e caracteres invisíveis/bidi como marcador visível com nome acessível. Monta o DOM direto (sem uma view do Angular por token): uma linha tem dezenas de nós e um arquivo, milhares de l…
1804
+ Desenha UMA linha de código no elemento (`renderCodeLine` de `@trismegisto/primitives/code-dom`): tokens como `<span class="hm-code-token--<kind>">`, texto sempre por nó de texto (nunca HTML), trechos intra-linha do diff e caracteres invisíveis/bidi como marcador visível com nome acessível. O registro elemento → linha (`CodeLineRegistry`) também mora nos primitives.
1504
1805
 
1505
1806
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1506
1807
  |---|---|---|---|---|
@@ -1634,7 +1935,10 @@ Paleta de comandos: um diálogo com busca e a lista de comandos em grupos (`Mod+
1634
1935
  | `closeOnRun` | input | `boolean` | `true` | Fecha depois de executar. |
1635
1936
  | `browseGroups` | input | `readonly string[]` | `[]` | Grupos mostrados com a busca vazia, nessa ordem (ex.: favoritos, recentes, módulos). Vazio = todos. Com texto, a busca percorre todos os comandos — inclusive o… |
1636
1937
  | `groupIcons` | input | `Readonly<Record<string, string>>` | `{}` | Ícone (nome do catálogo) antes do título de cada grupo, por nome do grupo. |
1938
+ | `filtering` | input | `'local' \| 'none'` | `'local'` | Quem filtra: `local` (padrão) — a paleta filtra e ordena `commands` pelo texto; `none` — o app já entrega a lista filtrada e na ordem (busca no servidor, prove… |
1939
+ | `busy` | input | `boolean` | `false` | O app ainda está buscando: sem nenhum item, mostra "Buscando…" no lugar de "nada encontrado". |
1637
1940
  | `executed` | output | `HermesCommand` | | O comando terminou (depois da Promise, se houver). |
1941
+ | `queryChange` | output | `string` | | O texto digitado mudou (o app busca fora e devolve em `commands`, com `filtering="none"`). |
1638
1942
 
1639
1943
  ## `hm-palette-shell`
1640
1944
 
@@ -2293,6 +2597,7 @@ Slots: `(padrão)`, `[footer]`
2293
2597
  | `size` | input | `ModalSize` | `'medium'` | Largura (painel lateral) ou altura máxima (folha inferior), com os mesmos valores do `hm-modal`: `small`, `medium` (padrão), `large`, `xlarge` e `full`. `full`… |
2294
2598
  | `position` | input | `DrawerPosition` | `'end'` | Borda de entrada; ver `DrawerPosition`. |
2295
2599
  | `pinned` | input | `boolean` | `false` | Fixa o painel no layout: deixa de ser sobreposição e passa a dividir o espaço com a página, sem véu nem bloqueio. Vira uma região complementar nomeada pelo tít… |
2600
+ | `scope` | input | `HermesOverlayScope \| null` | `null` | Onde o painel aparece: `viewport` cobre a página inteira; `content` fica preso à área de conteúdo da tela (o palco `HM_OVERLAY_STAGE` que o layout fornece, ex.… |
2296
2601
  | `closeLabel` | input | `string` | `''` | Nome acessível do X. Vazio usa `drawer.close` do catálogo. |
2297
2602
  | `closable` | input | `boolean` | `true` | `false` tira o X e ignora o `Esc`. |
2298
2603
  | `closeOnBackdrop` | input | `boolean` | `false` | Clicar no véu fecha, passando pela mesma guarda do X (`closable=false` continua impedindo). Sem efeito se `pinned`. |
@@ -2771,6 +3076,7 @@ Métodos públicos: `bringToFront(): void`
2771
3076
  | `closable` | input | `boolean` | `true` | |
2772
3077
  | `closeOnEscape` | input | `boolean` | `false` | `Esc` fecha a janela. Padrão: não (janela não modal — `Esc` costuma ser do conteúdo). |
2773
3078
  | `autoFocus` | input | `boolean` | `true` | Leva o foco para dentro ao abrir. |
3079
+ | `sheetBelow` | input | `number` | `0` | Abaixo desta largura da tela (px), a janela vira folha inferior (ver acima). `0` = nunca. |
2774
3080
  | `storageKey` | input | `string` | `''` | Chave do `localStorage` para lembrar posição, tamanho e estado. Vazio = não persiste. |
2775
3081
  | `rect` | model | `FloatingRect \| null` | `null` | Geometria atual (px). Two-way; `null` = posição inicial automática. |
2776
3082
  | `state` | model | `FloatingWindowState` | `'normal'` | Estado de exibição. Two-way. |
@@ -2931,6 +3237,8 @@ Botão só com ícone. O `label` é obrigatório: vira o nome acessível do `<bu
2931
3237
 
2932
3238
  Campo de documento de identificação de qualquer país registrado (`hm-identity-document-input`): CPF/CNPJ, DNI e CUIT argentinos, RUT chileno, CURP e RFC mexicanos, SSN e EIN americanos, NIF português, DNI/NIE espanhóis... A máscara acompanha o documento (e o tamanho, no RUT), a validação confere o dígito verificador (`validateIdentityDocument`) e o rótulo padrão é o nome do documento ("CUIT/CUIL"…
2933
3239
 
3240
+ Métodos públicos: `identityDocumentErrors(this.code(), this.documentType(), String(control.value ?? ''))`
3241
+
2934
3242
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2935
3243
  |---|---|---|---|---|
2936
3244
  | `value` | model | `string` | `''` | |
@@ -3581,6 +3889,269 @@ Slots: `(padrão)`
3581
3889
  | `edit` | output | `void` | | |
3582
3890
  | `cancel` | output | `void` | | |
3583
3891
 
3892
+ ## `hm-map-basemap`
3893
+
3894
+ `MapBasemapComponent` · estende `MapRegionsBase` — import de `@trismegisto/angular/map`
3895
+
3896
+ Mapa base vetorial embutido: países (Natural Earth) ou malhas do IBGE (regiões, UFs, mesorregiões, microrregiões, municípios por UF), desenhado em SVG com as cores do tema — terra, bordas e rótulos vêm de `--hm-map-land`, `--hm-map-border` e `--hm-map-label`, e o fundo do `hm-map` faz o papel da água. Trocar tema ou família recolore na hora (é tudo `var(--hm-*)`). Sem tiles e sem serviço externo:…
3897
+
3898
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3899
+ |---|---|---|---|---|
3900
+ | `muted` | input | `boolean` | `false` | Terra em tom esmaecido, entre a terra e a água: para a camada de contexto (o mundo em volta do Brasil). |
3901
+ | `layer` | input (obrigatório) (herdado) | `BasemapLayerId \| BasemapLayer` | | Camada: id de um mapa base embutido (`'world'`, `'world/50m'`, `'br/regioes'`, `'br/ufs'`, `'br/mesorregioes'`, `'br/microrregioes'`, `'br/municipios/SP'`) — c… |
3902
+ | `fit` | input (herdado) | `boolean` | `true` | Enquadra a vista na camada quando ela chega e limita zoom e área a ela. |
3903
+ | `labels` | input (herdado) | `boolean \| string` | `false` | Rótulos sobre as regiões: `true` (nome), o nome de uma propriedade (ex.: `'sigla'`) ou `false`. |
3904
+ | `exclude` | input (herdado) | `readonly string[]` | `[]` | Códigos de regiões que não entram (ex.: `['BRA']` num mundo de contexto sob as UFs). |
3905
+ | `layerLoad` | output (herdado) | `BasemapLayer` | | A camada carregou (ou mudou). |
3906
+
3907
+ ## `hm-map-choropleth`
3908
+
3909
+ `MapChoroplethComponent` · estende `MapRegionsBase` — import de `@trismegisto/angular/map`
3910
+
3911
+ Mapa coroplético: pinta as regiões de um mapa base pelo valor de cada uma, numa escala de dados do tema (`sequential`: `--hm-data-sequential-1…5`; `diverging`: `--hm-data-diverging-1…7`, com o neutro no `midpoint`). As cores ficam como `var(...)`: claro/escuro e famílias trocam na hora.
3912
+
3913
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3914
+ |---|---|---|---|---|
3915
+ | `data` | input | `ChoroplethData \| null` | `null` | Valores: linhas (`[{ sigla: 'SP', valor: 12 }]`) ou mapa chave → valor (`{ SP: 12 }`). |
3916
+ | `joinBy` | input | `ChoroplethJoin` | `'id'` | Como ligar linha e região: `'id'` (código oficial), uma propriedade da região (`'sigla'`) ou `[propriedade, campo]`. |
3917
+ | `valueKey` | input | `string` | `'value'` | Campo do valor nas linhas. |
3918
+ | `scale` | input | `ChoroplethScale` | `'sequential'` | |
3919
+ | `classes` | input | `number \| undefined` | `undefined` | Número de classes (sequencial até 5, divergente até 7). Padrão: todas. |
3920
+ | `method` | input | `ChoroplethMethod` | `'equal'` | `equal` (intervalos iguais) ou `quantile` (mesmo número de regiões por classe). |
3921
+ | `domain` | input | `readonly [number, number] \| null` | `null` | Domínio `[mín, máx]` (padrão: o dos dados). |
3922
+ | `breaks` | input | `readonly number[] \| null` | `null` | Limiares explícitos entre as classes (vencem `classes`/`method`). |
3923
+ | `midpoint` | input | `number` | `0` | Divergente: valor neutro do meio. |
3924
+ | `format` | input | `((value: number) => string) \| null` | `null` | Formata os valores (legenda, dica, tabela, nome acessível). Padrão: número no idioma ativo. |
3925
+ | `label` | input | `string` | `''` | Nome do conjunto de dados ("População por UF"): legenda, tabela e lista de regiões. |
3926
+ | `valueLabel` | input | `string` | `''` | Cabeçalho da coluna de valores da tabela. Padrão: "Valor". |
3927
+ | `regionLabel` | input | `string` | `''` | Cabeçalho da coluna de regiões da tabela. Padrão: "Região". |
3928
+ | `legend` | input | `boolean` | `true` | Legenda sobre o mapa. Desligue para montar a sua com `legendItems()` (`<hm-legend [items]="…">`). |
3929
+ | `table` | input | `boolean` | `true` | Botão "Ver como tabela" (a tabela fica na árvore de acessibilidade de qualquer forma). |
3930
+ | `regionClick` | output | `MapRegionEvent` | | Região acionada por clique, Enter ou Espaço. |
3931
+ | `layer` | input (obrigatório) (herdado) | `BasemapLayerId \| BasemapLayer` | | Camada: id de um mapa base embutido (`'world'`, `'world/50m'`, `'br/regioes'`, `'br/ufs'`, `'br/mesorregioes'`, `'br/microrregioes'`, `'br/municipios/SP'`) — c… |
3932
+ | `fit` | input (herdado) | `boolean` | `true` | Enquadra a vista na camada quando ela chega e limita zoom e área a ela. |
3933
+ | `labels` | input (herdado) | `boolean \| string` | `false` | Rótulos sobre as regiões: `true` (nome), o nome de uma propriedade (ex.: `'sigla'`) ou `false`. |
3934
+ | `exclude` | input (herdado) | `readonly string[]` | `[]` | Códigos de regiões que não entram (ex.: `['BRA']` num mundo de contexto sob as UFs). |
3935
+ | `layerLoad` | output (herdado) | `BasemapLayer` | | A camada carregou (ou mudou). |
3936
+
3937
+ ## `hm-map-cluster`
3938
+
3939
+ `MapClusterComponent` — import de `@trismegisto/angular/map`
3940
+
3941
+ Agrupa os `<hm-map-marker>` filhos que ficam próximos na tela (opt-in: só os marcadores dentro dele). Cada grupo vira um botão com a contagem; acionar (clique, Enter ou Espaço) aproxima até o grupo se separar; no zoom máximo, mostra os marcadores do grupo. Os grupos se refazem a cada zoom.
3942
+
3943
+ Slots: `hm-map-marker`
3944
+
3945
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3946
+ |---|---|---|---|---|
3947
+ | `radius` | input | `number` | `56` | Distância (px na tela) até a qual marcadores entram no mesmo grupo. |
3948
+ | `disabled` | input | `boolean` | `false` | Desliga o agrupamento (os marcadores aparecem todos), sem tirar o componente. |
3949
+ | `disableAtZoom` | input | `number \| null` | `null` | A partir deste zoom não agrupa mais; padrão: agrupa até o zoom máximo. |
3950
+ | `clusterClick` | output | `MapClusterEvent` | | Emite ao acionar um grupo (antes de aproximar ou expandir). |
3951
+
3952
+ ## `hm-map-geojson`
3953
+
3954
+ `MapGeoJsonComponent` · estende `MapPathBase` — import de `@trismegisto/angular/map`
3955
+
3956
+ Camada GeoJSON: Point, LineString, Polygon, as variantes Multi*, GeometryCollection, Feature e FeatureCollection. Cada feature recebe uma cor da paleta de dados (`--hm-data-categorical-*`): `colorProperty` dá uma série por valor distinto daquela propriedade (na ordem em que aparecem); `featureStyle` decide tudo por feature e vence o resto. Pontos viram círculos de `pointRadius` px.
3957
+
3958
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3959
+ |---|---|---|---|---|
3960
+ | `data` | input | `GeoJsonObject \| null` | `null` | |
3961
+ | `colorProperty` | input | `string \| undefined` | `undefined` | Propriedade que separa as features em séries de cor (ex.: `'categoria'`). |
3962
+ | `featureStyle` | input | `((feature: GeoJsonFeature, index: number) => MapPathStyle) \| undefined` | `undefined` | Estilo por feature (vence `colorProperty` e os inputs de estilo). |
3963
+ | `fillColor` | input | `string \| undefined` | `undefined` | |
3964
+ | `fillOpacity` | input | `number \| undefined` | `undefined` | |
3965
+ | `pointRadius` | input | `number` | `6` | Raio, em px, dos pontos. |
3966
+ | `interactive` | input | `boolean` | `false` | Features reagem a clique (emite `featureClick`). |
3967
+ | `featureClick` | output | `MapFeatureEvent` | | |
3968
+ | `color` | input (herdado) | `string \| undefined` | `undefined` | Cor do traço (qualquer valor CSS). Padrão: `--hm-data-categorical-1`. |
3969
+ | `series` | input (herdado) | `number \| undefined` | `undefined` | Série da paleta de dados (1–8), usada quando `color` não vem. |
3970
+ | `weight` | input (herdado) | `number \| undefined` | `undefined` | Espessura do traço, em px. |
3971
+ | `opacity` | input (herdado) | `number \| undefined` | `undefined` | |
3972
+ | `dashArray` | input (herdado) | `string \| undefined` | `undefined` | |
3973
+ | `pathClass` | input (herdado) | `string \| undefined` | `undefined` | Classe CSS extra no `<path>`. |
3974
+ | `shapeClick` | output (herdado) | `void` | | Clique na forma (só com `interactive`). |
3975
+
3976
+ ## `hm-map`
3977
+
3978
+ `MapComponent` — import de `@trismegisto/angular/map`
3979
+
3980
+ Mapa interativo com mapas base vetoriais embutidos, camadas vetoriais (SVG), marcadores e popups.
3981
+
3982
+ Slots: `hm-map-basemap, hm-map-choropleth`, `hm-map-marker, hm-map-cluster, hm-map-route`, `hm-map-popup`, `(padrão)`
3983
+
3984
+ Métodos públicos: `setView(center: LatLngLike, zoom?: number): void`, `zoomIn(delta = 1): void`, `zoomOut(delta = 1): void`, `panBy(x: number, y: number): void`, `fitBounds(bounds: LatLngBoundsLike, padding = 0): void`, `getView(): MapViewChange`, `invalidateSize(): void`, `layerPoint(latlng: LatLng): Point`, `registerPaths(source: Signal<readonly MapPathItem[]>): () => void`, `panIntoView(el: HTMLElement): void`, `focus(): void`, `registerAttribution(source: Signal<string>): () => void`, `registerExtent(source: Signal<MapLayerExtent \| null>): () => void`, `registerPanel(source: Signal<MapDataPanel \| null>): () => void`, `showTooltip(tip: MapTooltip): void`, `hideTooltip(owner: string): void`, `clientToLayer(clientX: number, clientY: number): Point`, `revealLayerPoint(p: Point): void`
3985
+
3986
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3987
+ |---|---|---|---|---|
3988
+ | `center` | input | `LatLngLike` | `[0, 0]` | Centro inicial (e sempre que mudar): `[lat, lng]` ou `{ lat, lng }`. |
3989
+ | `zoom` | input | `number` | `2` | |
3990
+ | `minZoom` | input | `number` | `0` | |
3991
+ | `maxZoom` | input | `number` | `19` | |
3992
+ | `maxBounds` | input | `LatLngBoundsLike \| null` | `null` | Área de onde a vista não sai. |
3993
+ | `bounds` | input | `LatLngBoundsLike \| null` | `null` | Enquadra este retângulo (vence `center`/`zoom` quando presente). |
3994
+ | `boundsPadding` | input | `number` | `0` | Folga, em px, ao enquadrar `bounds`. |
3995
+ | `tileUrl` | input | `string` | `''` | Template da URL dos tiles: `{z}`, `{x}`, `{y}`, `{-y}`, `{s}`, `{r}`. Vazio: sem tiles. |
3996
+ | `subdomains` | input | `string \| readonly string[]` | `'abc'` | |
3997
+ | `maxNativeZoom` | input | `number \| undefined` | `undefined` | Zoom máximo servido pelo provedor; acima dele, os tiles são ampliados. |
3998
+ | `attribution` | input | `string` | `''` | Crédito exigido pelo provedor dos tiles/dados (HTML com links; sanitizado pelo Angular). |
3999
+ | `label` | input | `string` | `''` | Nome acessível do mapa (ex.: "Lojas em Recife"). Padrão: o do catálogo. |
4000
+ | `zoomControl` | input | `boolean` | `true` | |
4001
+ | `scale` | input | `boolean` | `false` | Mostra a escala gráfica. |
4002
+ | `scaleUnits` | input | `MapScaleUnits` | `'metric'` | |
4003
+ | `interactive` | input | `boolean` | `true` | Desligado: o mapa não responde a arrasto, roda, pinça, duplo clique nem teclado. |
4004
+ | `scrollWheelZoom` | input | `boolean` | `true` | Zoom pela roda do mouse (desligue em páginas longas com rolagem). |
4005
+ | `viewChange` | output | `MapViewChange` | | Fim de cada mudança de vista feita pela pessoa ou pelos métodos públicos. |
4006
+
4007
+ ## `hm-map-marker`
4008
+
4009
+ `MapMarkerComponent` — import de `@trismegisto/angular/map`
4010
+
4011
+ Marcador num ponto do mapa: um botão focável com nome acessível (`label`). O desenho padrão é o ícone `map-marker`; conteúdo projetado substitui o desenho (um `hm-icon` com outro `shape`, um avatar...). Um `<hm-map-popup>` filho abre e fecha ao acionar o marcador (clique, Enter ou Espaço).
4012
+
4013
+ Slots: `(padrão)`, `hm-map-popup`
4014
+
4015
+ Métodos públicos: `focus(): void`
4016
+
4017
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4018
+ |---|---|---|---|---|
4019
+ | `position` | input (obrigatório) | `LatLngLike` | | Posição: `[lat, lng]` ou `{ lat, lng }`. |
4020
+ | `label` | input | `string` | `''` | Nome acessível (o que o leitor de tela anuncia). Padrão: "Marcador". |
4021
+ | `anchor` | input | `'bottom' \| 'center'` | `'bottom'` | Ponto de ancoragem do desenho: a ponta de baixo (alfinete) ou o centro (bolinha, avatar). |
4022
+ | `color` | input | `string` | `''` | Cor do desenho padrão (qualquer valor CSS, ex.: `var(--hm-data-categorical-3)`). |
4023
+ | `markerClick` | output | `void` | | |
4024
+
4025
+ ## `hm-map-circle`
4026
+
4027
+ `MapCircleComponent` · estende `MapPathBase` — import de `@trismegisto/angular/map`
4028
+
4029
+ Círculo geográfico: centro e raio em metros (acompanha o zoom).
4030
+
4031
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4032
+ |---|---|---|---|---|
4033
+ | `center` | input (obrigatório) | `LatLngLike` | | |
4034
+ | `radius` | input (obrigatório) | `number` | | Raio em metros. |
4035
+ | `fillColor` | input | `string \| undefined` | `undefined` | |
4036
+ | `fillOpacity` | input | `number \| undefined` | `undefined` | |
4037
+ | `interactive` | input | `boolean` | `false` | |
4038
+ | `color` | input (herdado) | `string \| undefined` | `undefined` | Cor do traço (qualquer valor CSS). Padrão: `--hm-data-categorical-1`. |
4039
+ | `series` | input (herdado) | `number \| undefined` | `undefined` | Série da paleta de dados (1–8), usada quando `color` não vem. |
4040
+ | `weight` | input (herdado) | `number \| undefined` | `undefined` | Espessura do traço, em px. |
4041
+ | `opacity` | input (herdado) | `number \| undefined` | `undefined` | |
4042
+ | `dashArray` | input (herdado) | `string \| undefined` | `undefined` | |
4043
+ | `pathClass` | input (herdado) | `string \| undefined` | `undefined` | Classe CSS extra no `<path>`. |
4044
+ | `shapeClick` | output (herdado) | `void` | | Clique na forma (só com `interactive`). |
4045
+
4046
+ ## `hm-map-polygon`
4047
+
4048
+ `MapPolygonComponent` · estende `MapPathBase` — import de `@trismegisto/angular/map`
4049
+
4050
+ Polígono: um anel (`LatLngLike[]`) ou anel externo + furos (`LatLngLike[][]`).
4051
+
4052
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4053
+ |---|---|---|---|---|
4054
+ | `points` | input (obrigatório) | `readonly LatLngLike[] \| readonly (readonly LatLngLike[])[]` | | |
4055
+ | `fillColor` | input | `string \| undefined` | `undefined` | Cor do preenchimento. Padrão: a do traço. |
4056
+ | `fillOpacity` | input | `number \| undefined` | `undefined` | |
4057
+ | `interactive` | input | `boolean` | `false` | |
4058
+ | `color` | input (herdado) | `string \| undefined` | `undefined` | Cor do traço (qualquer valor CSS). Padrão: `--hm-data-categorical-1`. |
4059
+ | `series` | input (herdado) | `number \| undefined` | `undefined` | Série da paleta de dados (1–8), usada quando `color` não vem. |
4060
+ | `weight` | input (herdado) | `number \| undefined` | `undefined` | Espessura do traço, em px. |
4061
+ | `opacity` | input (herdado) | `number \| undefined` | `undefined` | |
4062
+ | `dashArray` | input (herdado) | `string \| undefined` | `undefined` | |
4063
+ | `pathClass` | input (herdado) | `string \| undefined` | `undefined` | Classe CSS extra no `<path>`. |
4064
+ | `shapeClick` | output (herdado) | `void` | | Clique na forma (só com `interactive`). |
4065
+
4066
+ ## `hm-map-polyline`
4067
+
4068
+ `MapPolylineComponent` · estende `MapPathBase` — import de `@trismegisto/angular/map`
4069
+
4070
+ Linha (ou várias, com `LatLngLike[][]`) desenhada no mapa.
4071
+
4072
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4073
+ |---|---|---|---|---|
4074
+ | `points` | input (obrigatório) | `readonly LatLngLike[] \| readonly (readonly LatLngLike[])[]` | | Pontos da linha — ou lista de linhas. |
4075
+ | `interactive` | input | `boolean` | `false` | Reage a clique (emite `shapeClick`). |
4076
+ | `color` | input (herdado) | `string \| undefined` | `undefined` | Cor do traço (qualquer valor CSS). Padrão: `--hm-data-categorical-1`. |
4077
+ | `series` | input (herdado) | `number \| undefined` | `undefined` | Série da paleta de dados (1–8), usada quando `color` não vem. |
4078
+ | `weight` | input (herdado) | `number \| undefined` | `undefined` | Espessura do traço, em px. |
4079
+ | `opacity` | input (herdado) | `number \| undefined` | `undefined` | |
4080
+ | `dashArray` | input (herdado) | `string \| undefined` | `undefined` | |
4081
+ | `pathClass` | input (herdado) | `string \| undefined` | `undefined` | Classe CSS extra no `<path>`. |
4082
+ | `shapeClick` | output (herdado) | `void` | | Clique na forma (só com `interactive`). |
4083
+
4084
+ ## `hm-map-popup`
4085
+
4086
+ `MapPopupComponent` — import de `@trismegisto/angular/map`
4087
+
4088
+ Balão ancorado num ponto do mapa. Dentro de um `<hm-map-marker>` ancora no marcador e abre/fecha com ele; solto no `<hm-map>`, ancora em `position`. É um diálogo não modal: ao abrir pela pessoa, recebe o foco e o mapa se move para ele caber na tela; Esc ou o botão fechar devolvem o foco ao marcador.
4089
+
4090
+ Slots: `(padrão)`
4091
+
4092
+ Métodos públicos: `toggle(byUser = false): void`, `show(byUser = false): void`, `close(restoreFocus = false): void`
4093
+
4094
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4095
+ |---|---|---|---|---|
4096
+ | `position` | input | `LatLngLike \| null` | `null` | Ponto de ancoragem quando o popup não está dentro de um marcador. |
4097
+ | `open` | model | `boolean` | `false` | Aberto/fechado (`[(open)]`). |
4098
+ | `label` | input | `string` | `''` | Nome acessível do diálogo. Padrão: "Detalhes do local". |
4099
+ | `closeButton` | input | `boolean` | `true` | |
4100
+
4101
+ ## `hm-map-route`
4102
+
4103
+ `MapRouteComponent` — import de `@trismegisto/angular/map`
4104
+
4105
+ Camada de rota dentro do `hm-map`: a linha da rota escolhida (com contorno, para ler sobre qualquer fundo), as alternativas mais apagadas por baixo, marcadores de partida e chegada com nome acessível e o destaque do trecho do passo ativo (`activeStep`). Clicar numa alternativa emite `(routeSelect)` com o `id` dela — o app troca a rota escolhida; quem usa teclado escolhe pela lista do `hm-route-di…
4106
+
4107
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4108
+ |---|---|---|---|---|
4109
+ | `route` | input (obrigatório) | `MapRoute` | | Rota escolhida. |
4110
+ | `alternatives` | input | `readonly MapRoute[]` | `[]` | Outras rotas possíveis, desenhadas por baixo e mais apagadas. |
4111
+ | `activeStep` | input | `number` | `-1` | Passo destacado (índice em `route.steps`); `-1` = nenhum. O mapa se move para mostrá-lo. |
4112
+ | `startLabel` | input | `string` | `''` | Nome do lugar de partida ("Av. Paulista, 1000"), para o marcador. |
4113
+ | `endLabel` | input | `string` | `''` | Nome do lugar de chegada, para o marcador. |
4114
+ | `markers` | input | `boolean` | `true` | Marcadores de partida e chegada. |
4115
+ | `routeSelect` | output | `string` | | Clique numa alternativa: `id` da rota. |
4116
+
4117
+ ## `hm-route-directions`
4118
+
4119
+ `RouteDirectionsComponent` — import de `@trismegisto/angular/map`
4120
+
4121
+ Lista de direções de uma rota: totais no topo, rotas alternativas como opções (botões com `aria-pressed`) e os passos numa lista ordenada (`<ol>`), cada um com o ícone da manobra (decorativo), a instrução e a distância. `[(activeStep)]` liga a lista ao `hm-map-route`: focar ou clicar num passo o torna ativo, e o mapa vai até ele. Setas para cima/baixo, Home e End percorrem os passos.
4122
+
4123
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4124
+ |---|---|---|---|---|
4125
+ | `route` | input (obrigatório) | `MapRoute` | | |
4126
+ | `alternatives` | input | `readonly MapRoute[]` | `[]` | |
4127
+ | `activeStep` | model | `number` | `-1` | Passo ativo (`-1` = nenhum). |
4128
+ | `units` | input | `RouteUnits` | `'metric'` | Sistema de unidades das distâncias. |
4129
+ | `label` | input | `string` | `''` | Título da lista. Padrão: o `label` da rota ou "Direções". |
4130
+ | `routeSelect` | output | `string` | | Escolha de outra rota: `id` dela. |
4131
+
4132
+ ## `hm-street-view`
4133
+
4134
+ `StreetViewComponent` — import de `@trismegisto/angular/map`
4135
+
4136
+ Moldura de street view: o app projeta a imagem ou o visualizador do provedor que usa (panorama, `<img>`, `<canvas>`) e a moldura dá o resto — cabeçalho com endereço e legenda, bússola com a direção da vista (`heading`, graus: 0 = norte, 90 = leste), botões de girar e de avançar/voltar, tela cheia opcional, a atribuição exigida pelo provedor e os estados "carregando" e "sem imagem para este local".
4137
+
4138
+ Slots: `(padrão)`
4139
+
4140
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4141
+ |---|---|---|---|---|
4142
+ | `address` | input | `string` | `''` | Endereço do ponto (cabeçalho). Também nomeia a área da imagem quando não há `label`. |
4143
+ | `caption` | input | `string` | `''` | Legenda curta (data da captura, "Vista a partir da calçada"...). |
4144
+ | `label` | input | `string` | `''` | Nome acessível da área da imagem. |
4145
+ | `heading` | model | `number` | `0` | Direção da vista, em graus (0 = norte, 90 = leste). |
4146
+ | `rotateStep` | input | `number` | `45` | Quantos graus cada giro anda. |
4147
+ | `attribution` | input (obrigatório) | `string` | | Crédito exigido pelo provedor das imagens (HTML com links, sanitizado). Obrigatório. |
4148
+ | `status` | input | `StreetViewStatus` | `'ready'` | |
4149
+ | `fullscreen` | input | `boolean` | `false` | Mostra o botão de tela cheia (emite `fullscreenRequest`). |
4150
+ | `canMoveForward` | input | `boolean` | `true` | |
4151
+ | `canMoveBackward` | input | `boolean` | `true` | |
4152
+ | `move` | output | `StreetViewMove` | | Avançar ou voltar ao ponto vizinho. |
4153
+ | `fullscreenRequest` | output | `void` | | Pedido de tela cheia: o app chama `requestFullscreen()` no elemento que quiser. |
4154
+
3584
4155
  ## `hm-member-list`
3585
4156
 
3586
4157
  `MemberListComponent` — import de `@trismegisto/angular/member-list` (também na raiz)
@@ -3788,6 +4359,7 @@ Slots: `(padrão)`, `[footer]`
3788
4359
  | `size` | input | `ModalSize` | `'medium'` | Largura da janela: `small`, `medium` (padrão), `large`, `xlarge` ou `full` — este ocupa a tela inteira, sem cantos arredondados, respeitando as áreas seguras d… |
3789
4360
  | `closeLabel` | input | `string` | `''` | Nome acessível do X. Vazio usa `modal.close` do catálogo, no idioma ativo. |
3790
4361
  | `closable` | input | `boolean` | `true` | `false` tira o X e ignora o `Esc`: o diálogo só sai pelas ações do rodapé. |
4362
+ | `scope` | input | `HermesOverlayScope \| null` | `null` | Onde a janela aparece: `viewport` cobre a página inteira; `content` fica preso à área de conteúdo da tela (o palco `HM_OVERLAY_STAGE` que o layout fornece, ex.… |
3791
4363
  | `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda chamada quando a pessoa tenta sair pelo X ou pelo `Esc` (ex.: confirmar descarte de alterações). Devolver `false`, ou uma Promise que resolve em `false`… |
3792
4364
  | `closed` | output | `void` | | Emitido depois que a pessoa fechou pelo X ou pelo `Esc` (já com `open` em `false`). |
3793
4365
 
@@ -5842,6 +6414,36 @@ Editor de tarefa (criar ou editar): título, descrição, status, prioridade, re
5842
6414
  | `cancel` | output | `void` | | |
5843
6415
  | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5844
6416
 
6417
+ ## `hm-terminal`
6418
+
6419
+ `TerminalComponent` — import de `@trismegisto/angular/terminal`
6420
+
6421
+ Terminal com o tema dos tokens (`--hm-terminal-*`: tema claro/escuro e accent da família), ajuste automático ao tamanho, busca (Ctrl+Shift+F), links clicáveis e i18n. O `Terminal` por baixo fica em `terminal()` para o que a API completa oferecer (parser, marcadores, decorações, complementos).
6422
+
6423
+ Métodos públicos: `write(data: string \| Uint8Array): void`, `writeln(data: string): void`, `clear(): void`, `reset(): void`, `focus(): void`, `fitToContainer(): void`, `openSearch(): void`, `closeSearch(): void`, `findNext(): void`, `findPrevious(): void`
6424
+
6425
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6426
+ |---|---|---|---|---|
6427
+ | `label` | input | `string` | `''` | Nome acessível (por exemplo, "Console do contêiner api"). |
6428
+ | `scrollback` | input | `number` | `1000` | |
6429
+ | `cursorStyle` | input | `'block' \| 'underline' \| 'bar'` | `'block'` | |
6430
+ | `cursorBlink` | input | `boolean` | `true` | |
6431
+ | `convertEol` | input | `boolean` | `false` | |
6432
+ | `disableStdin` | input | `boolean` | `false` | |
6433
+ | `screenReaderMode` | input | `boolean` | `false` | |
6434
+ | `fontSize` | input | `number \| null` | `null` | Tamanho da fonte em px; sem valor, `--hm-terminal-font-size`. |
6435
+ | `lineHeight` | input | `number` | `1.15` | |
6436
+ | `autoFit` | input | `boolean` | `true` | Ajusta colunas e linhas ao tamanho do componente (e a cada mudança de tamanho). |
6437
+ | `webLinks` | input | `boolean` | `true` | URLs escritas no terminal viram links. |
6438
+ | `searchable` | input | `boolean` | `true` | Busca no histórico (Ctrl+Shift+F). |
6439
+ | `options` | input | `ITerminalOptions` | `{}` | Opções avançadas repassadas ao `Terminal` (ganham das acima). |
6440
+ | `data` | output | `string` | | O que a pessoa digita (e as respostas do terminal às consultas): mande ao processo. |
6441
+ | `binary` | output | `string` | | |
6442
+ | `resized` | output | `{ cols: number; rows: number }` | | |
6443
+ | `titleChange` | output | `string` | | |
6444
+ | `bell` | output | `void` | | |
6445
+ | `ready` | output | `Terminal` | | O terminal está aberto (para escrever o que já chegou ou carregar complementos). |
6446
+
5845
6447
  ## `[hmTextareaPrefix], [hmTextareaSuffix], [hmTextareaActions], [hmTextareaActionsEnd]`
5846
6448
 
5847
6449
  `TextareaAddonDirective` — import de `@trismegisto/angular/textarea` (também na raiz)
@@ -6111,8 +6713,8 @@ Métodos públicos: `show(): void`, `hide(): void`
6111
6713
  | `hmTooltip` | input (obrigatório) | `string` | | Texto da dica. Vazio desliga a dica. |
6112
6714
  | `hmTooltipSide` | input | `PopoverSide` | `'top'` | Lado preferido; vira sozinho quando não cabe. |
6113
6715
  | `hmTooltipDisabled` | input | `boolean` | `false` | |
6114
- | `hmTooltipShowDelay` | input | `number` | `400` | Espera antes de abrir no hover (ms). No foco abre na hora. |
6115
- | `hmTooltipHideDelay` | input | `number` | `120` | Espera antes de fechar ao sair o ponteiro (ms) — o tempo de chegar com ele até a dica. |
6716
+ | `hmTooltipShowDelay` | input | | `TOOLTIP_SHOW_DELAY` | Espera antes de abrir no hover (ms). No foco abre na hora. |
6717
+ | `hmTooltipHideDelay` | input | | `TOOLTIP_HIDE_DELAY` | Espera antes de fechar ao sair o ponteiro (ms) — o tempo de chegar com ele até a dica. |
6116
6718
 
6117
6719
  ## `hm-tour`
6118
6720