@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,22 +1,18 @@
1
1
  # Exports por ponto de import — @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 (junto com o `angular-api.md`).
3
+ > **Gerado** a partir do código-fonte da versão 3.4.0, a cada `npm run sync` do @acropole/skills (junto com o `angular-api.md`).
4
4
 
5
5
  Tudo que cada `@trismegisto/angular/<ponto>` exporta: serviços (com os membros públicos), funções, constantes,
6
6
  tokens de injeção e tipos (com a declaração). Componentes, diretivas e pipes aparecem só pelo nome — inputs,
7
- outputs e slots estão no `angular-api.md`. A raiz `@trismegisto/angular` reexporta quase tudo (exceções: ilustrações e
8
- `testing`); o que ela traz a mais, vindo de `@trismegisto/primitives`, está na última seção.
7
+ outputs e slots estão no `angular-api.md`. A raiz `@trismegisto/angular` reexporta quase tudo (exceções: ilustrações,
8
+ `testing` e as cascas `charts`, `map` e `terminal`, que só saem pelo ponto de import porque o núcleo delas é dependência
9
+ opcional); o que ela traz a mais, vindo de `@trismegisto/primitives`, está na última seção. A casca do spine
10
+ (`@trismegisto/angular/spine[/sub]`) está no `spine-api.md`.
9
11
 
10
12
  ## `@trismegisto/angular/access-control`
11
13
 
12
14
  - `AccessSummaryComponent` — `hm-access-summary` (ver angular-api.md)
13
15
  - `AccessPolicyEditorComponent` — `hm-access-policy-editor` (ver angular-api.md)
14
- - `AccessRequestStatus` — Situação de um pedido de acesso. `idle` = ainda não pedido (mostra o formulário).
15
-
16
- ```ts
17
- type AccessRequestStatus = 'idle' | 'pending' | 'approved' | 'denied';
18
- ```
19
-
20
16
  - `AccessRequestPayload` — O que o pedido leva: o papel escolhido e o motivo (pode ser vazio).
21
17
 
22
18
  ```ts
@@ -28,6 +24,12 @@ interface AccessRequestPayload {
28
24
 
29
25
  - `AccessRequestComponent` — `hm-access-request` (ver angular-api.md)
30
26
  - `AccessRequestReviewComponent` — `hm-access-request-review` (ver angular-api.md)
27
+ - `AccessRequestStatus` _(de `@trismegisto/primitives/access-control`)_ — Situação de um pedido de acesso. `idle` = ainda não pedido (mostra o formulário).
28
+
29
+ ```ts
30
+ type AccessRequestStatus = 'idle' | 'pending' | 'approved' | 'denied';
31
+ ```
32
+
31
33
  - `AccessControlMessages`
32
34
 
33
35
  ```ts
@@ -215,12 +217,6 @@ interface SignUpPayload {
215
217
  - `SignUpFormComponent` — `hm-sign-up-form` (ver angular-api.md)
216
218
  - `ForgotPasswordFormComponent` — `hm-forgot-password-form` (ver angular-api.md)
217
219
  - `MagicLinkFormComponent` — `hm-magic-link-form` (ver angular-api.md)
218
- - `NewPasswordMode` — `reset`: redefinir pelo link do e-mail (sem a senha atual). `change`: trocar estando dentro (pede a atual).
219
-
220
- ```ts
221
- type NewPasswordMode = 'reset' | 'change';
222
- ```
223
-
224
220
  - `NewPasswordPayload`
225
221
 
226
222
  ```ts
@@ -232,6 +228,12 @@ interface NewPasswordPayload {
232
228
  ```
233
229
 
234
230
  - `NewPasswordFormComponent` — `hm-new-password-form` (ver angular-api.md)
231
+ - `NewPasswordMode` _(de `@trismegisto/primitives/account-forms`)_ — `reset`: redefinir pelo link do e-mail (sem a senha atual). `change`: trocar estando dentro (pede a atual).
232
+
233
+ ```ts
234
+ type NewPasswordMode = 'reset' | 'change';
235
+ ```
236
+
235
237
  - `EmailVerificationComponent` — `hm-email-verification` (ver angular-api.md)
236
238
  - `SocialSignInProvider` — Um provedor de login. A lib não embute marca nenhuma: nome, ícone (registrado pelo app) ou imagem do logotipo vêm do app, que cuida das regras de marca de cada provedor.
237
239
 
@@ -286,7 +288,7 @@ interface AccountSwitcherMessages {
286
288
  - `const ACCOUNT_SWITCHER_MESSAGES_PT_BR: AccountSwitcherMessages`
287
289
  - `const ACCOUNT_SWITCHER_MESSAGES_EN: AccountSwitcherMessages`
288
290
  - `const ACCOUNT_SWITCHER_MESSAGES_ES: AccountSwitcherMessages`
289
- - `const ACCOUNT_SWITCHER_MESSAGES: Readonly<Record<string, AccountSwitcherMessages>>` — Catálogos por idioma, para `HermesI18nService.pick`.
291
+ - `const ACCOUNT_SWITCHER_MESSAGES: Readonly<Record<string, AccountSwitcherMessages>>` — Catálogos por idioma, para `pick` do store de i18n.
290
292
  - `AccountSwitcherComponent` — `hm-account-switcher` (ver angular-api.md)
291
293
 
292
294
  ## `@trismegisto/angular/address`
@@ -465,13 +467,13 @@ interface AgentModel {
465
467
  }
466
468
  ```
467
469
 
468
- - `AgentFileStatus`
469
-
470
- ```ts
471
- type AgentFileStatus = 'added' | 'modified' | 'deleted';
472
- ```
473
-
474
- - `AgentFile`
470
+ - `ModelSelectorComponent` — `hm-model-selector` (ver angular-api.md)
471
+ - `CheckpointComponent` — `hm-checkpoint` (ver angular-api.md)
472
+ - `FileTreeComponent` — `hm-file-tree` (ver angular-api.md)
473
+ - `AgentTerminalComponent` — `hm-agent-terminal` (ver angular-api.md)
474
+ - `TestResultsComponent` — `hm-test-results` (ver angular-api.md)
475
+ - `StackTraceComponent` — `hm-stack-trace` (ver angular-api.md)
476
+ - `AgentFile` _(de `@trismegisto/primitives/agent`)_
475
477
 
476
478
  ```ts
477
479
  interface AgentFile {
@@ -482,13 +484,25 @@ interface AgentFile {
482
484
  }
483
485
  ```
484
486
 
485
- - `AgentTestStatus`
487
+ - `AgentFileStatus` _(de `@trismegisto/primitives/agent`)_
486
488
 
487
489
  ```ts
488
- type AgentTestStatus = 'passed' | 'failed' | 'skipped';
490
+ type AgentFileStatus = 'added' | 'modified' | 'deleted';
489
491
  ```
490
492
 
491
- - `AgentTest`
493
+ - `AgentStackFrame` _(de `@trismegisto/primitives/agent`)_
494
+
495
+ ```ts
496
+ interface AgentStackFrame {
497
+ readonly fn: string;
498
+ readonly file?: string;
499
+ readonly line?: number;
500
+ readonly href?: string;
501
+ readonly internal?: boolean;
502
+ }
503
+ ```
504
+
505
+ - `AgentTest` _(de `@trismegisto/primitives/agent`)_
492
506
 
493
507
  ```ts
494
508
  interface AgentTest {
@@ -500,24 +514,12 @@ interface AgentTest {
500
514
  }
501
515
  ```
502
516
 
503
- - `AgentStackFrame`
517
+ - `AgentTestStatus` _(de `@trismegisto/primitives/agent`)_
504
518
 
505
519
  ```ts
506
- interface AgentStackFrame {
507
- readonly fn: string;
508
- readonly file?: string;
509
- readonly line?: number;
510
- readonly href?: string;
511
- readonly internal?: boolean;
512
- }
520
+ type AgentTestStatus = 'passed' | 'failed' | 'skipped';
513
521
  ```
514
522
 
515
- - `ModelSelectorComponent` — `hm-model-selector` (ver angular-api.md)
516
- - `CheckpointComponent` — `hm-checkpoint` (ver angular-api.md)
517
- - `FileTreeComponent` — `hm-file-tree` (ver angular-api.md)
518
- - `AgentTerminalComponent` — `hm-agent-terminal` (ver angular-api.md)
519
- - `TestResultsComponent` — `hm-test-results` (ver angular-api.md)
520
- - `StackTraceComponent` — `hm-stack-trace` (ver angular-api.md)
521
523
  - `AgentToolComponent` — `hm-agent-tool` (ver angular-api.md)
522
524
  - `AgentSearchResultsComponent` — `hm-agent-search-results` (ver angular-api.md)
523
525
 
@@ -563,25 +565,6 @@ interface AlertHistoryMessages {
563
565
  - `const ALERT_HISTORY_MESSAGES_PT_BR: AlertHistoryMessages`
564
566
  - `const ALERT_HISTORY_MESSAGES_EN: AlertHistoryMessages`
565
567
  - `const ALERT_HISTORY_MESSAGES_ES: AlertHistoryMessages`
566
- - `AlertEventState`
567
-
568
- ```ts
569
- type AlertEventState = AlertEvent['state'];
570
- ```
571
-
572
- - `const ALERT_EVENT_STATES: readonly AlertEventState[]`
573
- - `AlertStateFilter` — Filtro de estado ou severidade: um valor ou `'all'`.
574
-
575
- ```ts
576
- type AlertStateFilter = AlertEventState | 'all';
577
- ```
578
-
579
- - `AlertSeverityFilter`
580
-
581
- ```ts
582
- type AlertSeverityFilter = IncidentSeverity | 'all';
583
- ```
584
-
585
568
  - `AlertHistoryComponent` — `hm-alert-history` (ver angular-api.md)
586
569
 
587
570
  ## `@trismegisto/angular/alert-rule-editor`
@@ -647,9 +630,9 @@ interface AlertChannelOption {
647
630
  }
648
631
  ```
649
632
 
650
- - `const ALERT_RULE_DURATIONS: readonly number[]` — Durações padrão do "por quanto tempo" (ms).
651
- - `function emptyAlertRule(overrides: Partial<AlertRule> = {}): AlertRule` — Regra em branco para começar um editor novo (limiar ainda não informado).
652
633
  - `AlertRuleEditorComponent` — `hm-alert-rule-editor` (ver angular-api.md)
634
+ - `const ALERT_RULE_DURATIONS: readonly number[]` _(de `@trismegisto/primitives/alert-rule-editor`)_ — Durações padrão do "por quanto tempo" (ms).
635
+ - `function emptyAlertRule(overrides: Partial<AlertRule> = {}): AlertRule` _(de `@trismegisto/primitives/alert-rule-editor`)_ — Regra em branco para começar um editor novo (limiar ainda não informado).
653
636
 
654
637
  ## `@trismegisto/angular/anchor-nav`
655
638
 
@@ -664,7 +647,7 @@ interface AnchorNavItem {
664
647
  ```
665
648
 
666
649
  - `AnchorNavComponent` — `hm-anchor-nav` (ver angular-api.md)
667
- - `AnchorNavMessages` — Textos do `hm-anchor-nav`, fora do catálogo compartilhado.
650
+ - `AnchorNavMessages` — Textos do `hm-anchor-nav`, fora do catálogo compartilhado (Angular e React reexportam daqui).
668
651
 
669
652
  ```ts
670
653
  interface AnchorNavMessages {
@@ -811,19 +794,6 @@ type AppointmentMessages = CalendarFilesMessages['appointment'];
811
794
 
812
795
  ## `@trismegisto/angular/approval`
813
796
 
814
- - `ApprovalStep` — Uma etapa da aprovação: quem aprova e o que decidiu.
815
-
816
- ```ts
817
- interface ApprovalStep {
818
- readonly id: string;
819
- readonly approver: WorkflowAssignee;
820
- readonly decision: ApprovalDecision;
821
- readonly role?: string;
822
- readonly decidedAt?: WorkflowDateValue;
823
- readonly comment?: string;
824
- }
825
- ```
826
-
827
797
  - `ApprovalBadgeComponent` — `hm-approval-badge` (ver angular-api.md)
828
798
  - `ApprovalComponent` — `hm-approval` (ver angular-api.md)
829
799
 
@@ -854,9 +824,9 @@ type AttachmentGroupLayout = 'list' | 'inline' | 'grid';
854
824
  ```
855
825
 
856
826
  - `AttachmentGroupComponent` — `hm-attachment-group` (ver angular-api.md)
857
- - `function fileExtension(name: string): string` — Extensão em minúsculas (`'Relatório.PDF'` → `'pdf'`); `''` sem extensão ou em `.gitignore`.
858
- - `function isImageFile(name: string, type = ''): boolean` — É imagem? Com MIME, ele decide; sem MIME, a extensão.
859
- - `function fileIconName(name: string, type = ''): string` — Nome do ícone do catálogo para o arquivo; `'file'` quando o tipo não é conhecido.
827
+ - `function fileExtension(name: string): string` _(de `@trismegisto/primitives/attachment`)_ — Extensão em minúsculas (`'Relatório.PDF'` → `'pdf'`); `''` sem extensão ou em `.gitignore`.
828
+ - `function fileIconName(name: string, type = ''): string` _(de `@trismegisto/primitives/attachment`)_ — Nome do ícone do catálogo para o arquivo; `'file'` quando o tipo não é conhecido.
829
+ - `function isImageFile(name: string, type = ''): boolean` _(de `@trismegisto/primitives/attachment`)_ — É imagem? Com MIME, ele decide; sem MIME, a extensão.
860
830
 
861
831
  ## `@trismegisto/angular/availability-editor`
862
832
 
@@ -1032,23 +1002,6 @@ interface BreadcrumbItem {
1032
1002
 
1033
1003
  ## `@trismegisto/angular/bubble`
1034
1004
 
1035
- - `BubbleVariant` — Variante do balão. `received` (superfície neutra) e `sent` (cor de ação) são os dois lados da conversa; `system` é o aviso do próprio sistema no fluxo, sem balão; `emphasis` destaca uma mensagem (menção, resposta fixada…
1036
-
1037
- ```ts
1038
- type BubbleVariant = 'received' | 'sent' | 'system' | 'emphasis' | 'outline' | 'ghost';
1039
- ```
1040
-
1041
- - `BubbleReaction` — Uma reação sob o balão. `label` é o nome da reação para o leitor de tela ("Curtir"); sem ele, o próprio emoji é lido. `selected` = a pessoa que lê reagiu com ela.
1042
-
1043
- ```ts
1044
- interface BubbleReaction {
1045
- readonly emoji: string;
1046
- readonly count: number;
1047
- readonly label?: string;
1048
- readonly selected?: boolean;
1049
- }
1050
- ```
1051
-
1052
1005
  - `BubbleComponent` — `hm-bubble` (ver angular-api.md)
1053
1006
 
1054
1007
  ## `@trismegisto/angular/bulk-input`
@@ -1187,6 +1140,69 @@ type CertificateViewerHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
1187
1140
 
1188
1141
  - `ChangeHistoryComponent` — `hm-change-history` (ver angular-api.md)
1189
1142
 
1143
+ ## `@trismegisto/angular/charts`
1144
+
1145
+ - `HmBarChartComponent` — `hm-bar-chart` (ver angular-api.md)
1146
+ - `BarChartOrientation`
1147
+ - `HmLineChartComponent` — `hm-line-chart` (ver angular-api.md)
1148
+ - `HmPieChartComponent` — `hm-pie-chart` (ver angular-api.md)
1149
+ - `HmHeatmapChartComponent` — `hm-heatmap-chart` (ver angular-api.md)
1150
+ - `HeatmapCell`
1151
+ - `HmCalendarHeatmapComponent` — `hm-calendar-heatmap` (ver angular-api.md)
1152
+ - `CalendarDatum`
1153
+ - `HmScatterChartComponent` — `hm-scatter-chart` (ver angular-api.md)
1154
+ - `ScatterPoint`
1155
+ - `ScatterSeries`
1156
+ - `HmGaugeChartComponent` — `hm-gauge-chart` (ver angular-api.md)
1157
+ - `HmFunnelChartComponent` — `hm-funnel-chart` (ver angular-api.md)
1158
+ - `HmRadarChartComponent` — `hm-radar-chart` (ver angular-api.md)
1159
+ - `RadarIndicator`
1160
+ - `RadarSeries`
1161
+ - `HmTreemapChartComponent` — `hm-treemap-chart` (ver angular-api.md)
1162
+ - `TreemapNode`
1163
+ - `HmSankeyChartComponent` — `hm-sankey-chart` (ver angular-api.md)
1164
+ - `SankeyLink`
1165
+ - `HmBoxplotChartComponent` — `hm-boxplot-chart` (ver angular-api.md)
1166
+ - `BoxplotGroup`
1167
+ - `HmSparklineChartComponent` — `hm-sparkline-chart` (ver angular-api.md)
1168
+ - `HmBulletChartComponent` — `hm-bullet-chart` (ver angular-api.md)
1169
+ - `BulletItem`
1170
+ - `HmWaterfallChartComponent` — `hm-waterfall-chart` (ver angular-api.md)
1171
+ - `WaterfallStep`
1172
+ - `WaterfallBar`
1173
+ - `HmChartBase` — classe base
1174
+ - `HmChartComponent` — `hm-chart` (ver angular-api.md)
1175
+ - `ChartPoint`
1176
+ - **`ChartsI18nService`** (classe)
1177
+
1178
+ ```ts
1179
+ class ChartsI18nService implements ChartsTextFormatter {
1180
+ readonly messages = computed(…)
1181
+ readonly locale = computed(…)
1182
+ format(template: string, params: MessageParams = {}): string
1183
+ plural(message: PluralMessage, count: number, params: MessageParams = {}): string
1184
+ }
1185
+ ```
1186
+
1187
+ - `const CHARTS_I18N_CONFIG: InjectionToken<ChartsI18nConfig>`
1188
+ - `function provideChartsMessages(config: ChartsI18nConfig): Provider` — Sobrescreve textos dos gráficos e/ou acrescenta idiomas. O idioma em si vem de `provideHermesI18n`.
1189
+ - `ChartsI18nConfig`
1190
+ - `ChartsMessagesOverride`
1191
+ - `HmChartOption`
1192
+ - `HmChartSeriesOption`
1193
+ - `HmBarSeriesOption`
1194
+ - `HmLineSeriesOption`
1195
+ - `HmPieSeriesOption`
1196
+ - `HmScatterSeriesOption`
1197
+ - `HmHeatmapSeriesOption`
1198
+ - `HmGaugeSeriesOption`
1199
+ - `HmFunnelSeriesOption`
1200
+ - `HmRadarSeriesOption`
1201
+ - `HmTreemapSeriesOption`
1202
+ - `HmSankeySeriesOption`
1203
+ - `HmBoxplotSeriesOption`
1204
+ - `HmChartInstance`
1205
+
1190
1206
  ## `@trismegisto/angular/checkbox`
1191
1207
 
1192
1208
  - `CheckboxComponent` — `hm-checkbox` (ver angular-api.md)
@@ -1308,13 +1324,13 @@ type CodeViewerSize = 'medium' | 'small';
1308
1324
  type CodeViewerVariant = 'default' | 'destructive';
1309
1325
  ```
1310
1326
 
1311
- - `CodeViewerLineChange` — Linha marcada como diff, além do destaque.
1327
+ - `CodeViewerComponent` — `hm-code-viewer` (ver angular-api.md)
1328
+ - `CodeViewerLineChange` _(de `@trismegisto/primitives/code-viewer`)_ — Linha marcada como diff, além do destaque.
1312
1329
 
1313
1330
  ```ts
1314
1331
  type CodeViewerLineChange = 'added' | 'removed' | null;
1315
1332
  ```
1316
1333
 
1317
- - `CodeViewerComponent` — `hm-code-viewer` (ver angular-api.md)
1318
1334
  - **`CodeLanguagesService`** (classe)
1319
1335
 
1320
1336
  ```ts
@@ -1329,16 +1345,9 @@ class CodeLanguagesService {
1329
1345
  ```
1330
1346
 
1331
1347
  - `function provideCodeLanguages(...languages: readonly (CodeLanguage | CodeLanguageLoader)[]): EnvironmentProviders` — Registra linguagens no app:
1332
- - `ResolvedCodeLanguage` — Resultado da resolução de `language`/`filename` de um componente.
1333
-
1334
- ```ts
1335
- interface ResolvedCodeLanguage {
1336
- readonly language: CodeLanguage;
1337
- readonly pending: Promise<CodeLanguage> | null;
1338
- }
1339
- ```
1340
-
1341
1348
  - `function resolveCodeLanguageInput( service: CodeLanguagesService, language: string | CodeLanguage | null | undefined, filename: string, prefix: string, ): ResolvedCodeLanguage` — `language` (objeto, id/alias) ou, sem ele, a inferida de `filename`. Desconhecida = texto puro e um aviso de desenvolvimento por id (`prefix` = `[hermes-code-viewer]`/`[hermes-code-diff]`).
1349
+ - `const CODE_LINE_REGISTRY: InjectionToken<CodeLineRegistry>`
1350
+ - `CodeLineDirective` — `[hmCodeLine]` (ver angular-api.md)
1342
1351
  - `CodeLineRef` — Onde a linha mora no modelo (o que a cópia usa para montar o texto, nunca o DOM).
1343
1352
 
1344
1353
  ```ts
@@ -1359,9 +1368,31 @@ class CodeLineRegistry {
1359
1368
  }
1360
1369
  ```
1361
1370
 
1362
- - `const CODE_LINE_REGISTRY: InjectionToken<CodeLineRegistry>`
1363
1371
  - `const CODE_INVISIBLE_CLASS = 'hm-code-viewer__invisible'` — Classe do marcador de caractere invisível (a cópia o reconhece e devolve o caractere original).
1364
- - `CodeLineDirective` — `[hmCodeLine]` (ver angular-api.md)
1372
+ - `CodeLineRenderOptions` — Como desenhar uma linha (`renderCodeLine`).
1373
+
1374
+ ```ts
1375
+ interface CodeLineRenderOptions {
1376
+ readonly tokens?: readonly CodeToken[] | null;
1377
+ readonly reveal?: boolean;
1378
+ readonly first?: boolean;
1379
+ readonly ranges?: readonly (readonly [number, number])[];
1380
+ readonly rangeClass?: string;
1381
+ readonly invisibleLabel?: string;
1382
+ }
1383
+ ```
1384
+
1385
+ - `CodeLineSegment` — Um trecho da linha com a mesma classe (token e/ou trecho intra-linha); `className` vazio = texto puro.
1386
+
1387
+ ```ts
1388
+ interface CodeLineSegment {
1389
+ readonly className: string;
1390
+ readonly pieces: readonly CodeTextPiece[];
1391
+ }
1392
+ ```
1393
+
1394
+ - `function codeLineSegments(text: string, options: Omit<CodeLineRenderOptions, 'invisibleLabel'> = {}): CodeLineSegment[]` — Corta UMA linha nos trechos que o desenho usa: fronteiras dos tokens e dos trechos intra-linha, classe `hm-code-token--<kind>` (só com `kind` da lista fechada) e os pedaços de texto/invisível de cada trecho. É o que `re…
1395
+ - `function renderCodeLine(el: Element, text: string, options: CodeLineRenderOptions = {}): void` — Desenha UMA linha de código em `el` (dono exclusivo dos filhos: limpa tudo e desenha de novo) a partir de `codeLineSegments`: tokens como `<span class="hm-code-token--<kind>">` (só classe), texto sempre por nó de texto…
1365
1396
  - `const CODE_SLICE_MS = 8` — Fatia máxima de trabalho de fundo (ms) antes de devolver o navegador.
1366
1397
  - `function scheduleCodeTask(win: Window | null, task: () => void): () => void` — Agenda `task` para quando o navegador estiver ocioso (`requestIdleCallback`, senão `setTimeout`).
1367
1398
  - `CodeModelPoint`
@@ -1496,7 +1527,7 @@ interface ComboboxOption {
1496
1527
 
1497
1528
  - `ɵComboboxOverlay`
1498
1529
  - `ɵrevealOption`
1499
- - `ɵComboboxOverlayParts` — Onde o cartão de uma lista de combobox se pendura e para onde o foco volta.
1530
+ - `ɵComboboxOverlayParts` — Onde o cartão se pendura e para onde o foco volta.
1500
1531
 
1501
1532
  ```ts
1502
1533
  interface ComboboxOverlayParts {
@@ -1526,46 +1557,22 @@ interface HermesCommand {
1526
1557
  readonly description?: string;
1527
1558
  readonly disabled?: boolean;
1528
1559
  readonly run: () => void | Promise<unknown>;
1560
+ readonly keepOpen?: boolean;
1529
1561
  }
1530
1562
  ```
1531
1563
 
1532
1564
  - `CommandPaletteComponent` — `hm-command-palette` (ver angular-api.md)
1533
- - `PaletteOptionView` — Uma opção pronta para a lista (o que a paleta e a busca global entregam ao contêiner).
1534
-
1535
- ```ts
1536
- interface PaletteOptionView {
1537
- readonly key: string;
1538
- readonly segments: readonly HighlightSegment[];
1539
- readonly description?: string;
1540
- readonly icon?: string;
1541
- readonly shortcut?: string | readonly string[];
1542
- readonly disabled?: boolean;
1543
- readonly busy?: boolean;
1544
- }
1545
- ```
1546
-
1547
- - `PaletteGroupView`
1548
-
1549
- ```ts
1550
- interface PaletteGroupView {
1551
- readonly key: string;
1552
- readonly label: string;
1553
- readonly icon?: string;
1554
- readonly options: readonly PaletteOptionView[];
1555
- }
1556
- ```
1557
-
1558
- - `PaletteStatusKind` — Estado no lugar da lista: vazio, carregando, erro (com "tentar de novo") ou dica inicial.
1559
-
1560
- ```ts
1561
- type PaletteStatusKind = '' | 'idle' | 'empty' | 'loading' | 'error';
1562
- ```
1563
-
1564
1565
  - `PaletteShellComponent` — `hm-palette-shell` (ver angular-api.md)
1565
1566
 
1566
1567
  ## `@trismegisto/angular/commerce-format`
1567
1568
 
1568
- - `MoneyFormatOptions`
1569
+ - `function formatMoney(amount: number, currency: string, locale: string, options: MoneyFormatOptions = {}): string` _(de `@trismegisto/primitives/commerce-format`)_ — `199.9`, BRL, pt-BR → "R$ 199,90".
1570
+ - `function formatPercent(points: number, locale: string, options: { digits?: number; signDisplay?: MoneyFormatOptions['signDisplay'] } = {}): string` _(de `@trismegisto/primitives/commerce-format`)_ — Porcentagem a partir de pontos percentuais (`12.5` → "12,5%").
1571
+ - `function formatNumber(value: number, locale: string, maximumFractionDigits = 2): string` _(de `@trismegisto/primitives/commerce-format`)_ — Número com separadores do idioma.
1572
+ - `function formatDate(value: DateInput, locale: string, options: Intl.DateTimeFormatOptions = { dateStyle: 'medium' }): string` _(de `@trismegisto/primitives/commerce-format`)_ — Data formatada; `''` para vazia ou inválida. Padrão: "30 de out. de 2026".
1573
+ - `function isoDate(value: DateInput): string` _(de `@trismegisto/primitives/commerce-format`)_ — Valor para o atributo `datetime` de `<time>` (`''` se inválido).
1574
+ - `function toDate(value: DateInput): Date | null` _(de `@trismegisto/primitives/commerce-format`)_
1575
+ - `MoneyFormatOptions` _(de `@trismegisto/primitives/commerce-format`)_
1569
1576
 
1570
1577
  ```ts
1571
1578
  interface MoneyFormatOptions {
@@ -1574,32 +1581,17 @@ interface MoneyFormatOptions {
1574
1581
  }
1575
1582
  ```
1576
1583
 
1577
- - `function formatMoney(amount: number, currency: string, locale: string, options: MoneyFormatOptions = {}): string` — `199.9`, BRL, pt-BR → "R$ 199,90".
1578
- - `function formatPercent(points: number, locale: string, options: { digits?: number; signDisplay?: MoneyFormatOptions['signDisplay'] } = {}): string` — Porcentagem a partir de pontos percentuais (`12.5` → "12,5%").
1579
- - `function formatNumber(value: number, locale: string, maximumFractionDigits = 2): string` — Número com separadores do idioma.
1580
- - `DateInput`
1584
+ - `DateInput` _(de `@trismegisto/primitives/commerce-format`)_
1581
1585
 
1582
1586
  ```ts
1583
1587
  type DateInput = Date | string | number | null | undefined;
1584
1588
  ```
1585
1589
 
1586
- - `function formatDate(value: DateInput, locale: string, options: Intl.DateTimeFormatOptions = { dateStyle: 'medium' }): string` — Data formatada; `''` para vazia ou inválida. Padrão: "30 de out. de 2026".
1587
- - `function isoDate(value: DateInput): string` — Valor para o atributo `datetime` de `<time>` (`''` se inválido).
1588
- - `function toDate(value: DateInput): Date | null`
1589
1590
  - `function localCatalog<T extends object>( byLocale: Readonly<Record<string, T>>, fallback: T, override: () => CatalogOverride<T> | null | undefined, ): Signal<T>` — Catálogo de textos de uma pasta (`<pasta>-messages.ts`) no idioma ativo, com a sobrescrita do app por cima. Chamado num campo do componente:
1590
1591
  - `function formatLocale(): Signal<string>` — Locale de formatação (`Intl`) do idioma ativo, com o formato regional escolhido.
1591
1592
 
1592
1593
  ## `@trismegisto/angular/connection-wizard`
1593
1594
 
1594
- - `ConnectionWizardRequest` — O que o assistente entrega ao concluir (ou ao pedir um teste).
1595
-
1596
- ```ts
1597
- interface ConnectionWizardRequest {
1598
- readonly sourceId: string | null;
1599
- readonly values: CredentialFormValues;
1600
- }
1601
- ```
1602
-
1603
1595
  - `ConnectionWizardComponent` — `hm-connection-wizard` (ver angular-api.md)
1604
1596
  - `ConnectionWizardMessages` — Textos do hm-connection-wizard.
1605
1597
 
@@ -1680,12 +1672,6 @@ type CopyButtonVariant = 'icon' | 'text';
1680
1672
  ## `@trismegisto/angular/credentials-form`
1681
1673
 
1682
1674
  - `ConnectionTestComponent` — `hm-connection-test` (ver angular-api.md)
1683
- - `CredentialFormValues` — Valores do formulário de credenciais (nome do campo → valor).
1684
-
1685
- ```ts
1686
- type CredentialFormValues = Record<string, string | number | boolean | null>;
1687
- ```
1688
-
1689
1675
  - `CredentialsFormComponent` — `hm-credentials-form` (ver angular-api.md)
1690
1676
  - `DatabaseConnectionRequest` — O que o formulário de banco emite: os valores dos campos e o motor escolhido.
1691
1677
 
@@ -1911,7 +1897,7 @@ interface GridColumn<T> {
1911
1897
  }
1912
1898
  ```
1913
1899
 
1914
- - `DataGridExportFormat` — `csv` is plain RFC 4180; `excel` adds a BOM and the locale's list separator so spreadsheets open it right.
1900
+ - `DataGridExportFormat`
1915
1901
 
1916
1902
  ```ts
1917
1903
  type DataGridExportFormat = 'csv' | 'excel';
@@ -2020,13 +2006,13 @@ interface DateTimePickerMessages {
2020
2006
  ## `@trismegisto/angular/deadline`
2021
2007
 
2022
2008
  - `function hermesClock( fixed: () => WorkflowDateValue, intervalMs: () => number, active: () => boolean = () => true, ): Signal<number>` — Relógio dos indicadores de prazo: devolve o "agora" em ms. Com `fixed()` (o input `now` do componente) preenchido, usa esse valor e não agenda nada (testes, capturas, servidor); senão, avança a cada `intervalMs()` enqua…
2023
- - `DeadlineVariant` — `badge`: selo curto ("Vence em 2 d"); `countdown`: contagem regressiva ao vivo, com segundos.
2009
+ - `DeadlineComponent` — `hm-deadline` (ver angular-api.md)
2010
+ - `DeadlineVariant` _(de `@trismegisto/primitives/deadline`)_ — `badge`: selo curto ("Vence em 2 d"); `countdown`: contagem regressiva ao vivo, com segundos.
2024
2011
 
2025
2012
  ```ts
2026
2013
  type DeadlineVariant = 'badge' | 'countdown';
2027
2014
  ```
2028
2015
 
2029
- - `DeadlineComponent` — `hm-deadline` (ver angular-api.md)
2030
2016
  - `SlaComponent` — `hm-sla` (ver angular-api.md)
2031
2017
 
2032
2018
  ## `@trismegisto/angular/deploy-pipeline`
@@ -2046,8 +2032,8 @@ type DeployPipelineHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
2046
2032
  ```
2047
2033
 
2048
2034
  - `DeployPipelineComponent` — `hm-deploy-pipeline` (ver angular-api.md)
2049
- - `function deployStatusShape(status: DeployStatus): string` — Nome do ícone de um estado de deploy (o mesmo do `hm-deploy-status`).
2050
2035
  - `DeployStatusComponent` — `hm-deploy-status` (ver angular-api.md)
2036
+ - `function deployStatusShape(status: DeployStatus): string` _(de `@trismegisto/primitives/deploy-pipeline`)_ — Nome do ícone de um estado de deploy (estado desconhecido usa o de `queued`).
2051
2037
  - `DeployPipelineMessages` — Textos do `hm-deploy-pipeline` e do `hm-deploy-status`. pt-BR embutido; en/es ao lado. O app sobrescreve frases pelo input `texts` do componente.
2052
2038
 
2053
2039
  ```ts
@@ -2135,10 +2121,7 @@ interface HermesConfirmOptions {
2135
2121
  - **`HermesDialogRef`** (classe) — Referência a um diálogo aberto por `HermesDialogService`. O componente aberto a recebe por injeção (`inject(HermesDialogRef)`) para fechar com um resultado; quem abriu espera `closed`. Fechar pelo X ou pelo Esc resolve…
2136
2122
 
2137
2123
  ```ts
2138
- class HermesDialogRef<R = unknown> {
2139
- readonly closed: Promise<R | undefined>
2140
- onClose: () => void = () => {}
2141
- close(result?: R): void
2124
+ class HermesDialogRef<R = unknown> extends DialogHandle<R> {
2142
2125
  }
2143
2126
  ```
2144
2127
 
@@ -2153,15 +2136,14 @@ class HermesDialogService {
2153
2136
 
2154
2137
  ## `@trismegisto/angular/direction`
2155
2138
 
2156
- - `HermesDirection` — Direção de escrita EFETIVA de um elemento (`ltr`/`rtl`), num lugar só.
2139
+ - `function elementDirection(element: Element | null | undefined): HermesDirection` _(de `@trismegisto/primitives/direction`)_ — `rtl` ou `ltr` pelo estilo computado do elemento; `ltr` quando não dá para medir.
2140
+ - `function isRtl(element: Element | null | undefined): boolean` _(de `@trismegisto/primitives/direction`)_ — Atalho de `elementDirection(element) === 'rtl'`.
2141
+ - `HermesDirection` _(de `@trismegisto/primitives/direction`)_ — Direção de escrita EFETIVA de um elemento (`ltr`/`rtl`), num lugar só.
2157
2142
 
2158
2143
  ```ts
2159
2144
  type HermesDirection = 'ltr' | 'rtl';
2160
2145
  ```
2161
2146
 
2162
- - `function elementDirection(element: Element | null | undefined): HermesDirection` — `rtl` ou `ltr` pelo estilo computado do elemento; `ltr` quando não dá para medir.
2163
- - `function isRtl(element: Element | null | undefined): boolean` — Atalho de `elementDirection(element) === 'rtl'`.
2164
-
2165
2147
  ## `@trismegisto/angular/divider`
2166
2148
 
2167
2149
  - `DividerOrientation`
@@ -2202,13 +2184,13 @@ type DividerLabelAlign = 'start' | 'center' | 'end';
2202
2184
  - `HermesDragVia` — Como o arrasto foi feito: ponteiro (mouse, caneta, toque) ou teclado.
2203
2185
 
2204
2186
  ```ts
2205
- type HermesDragVia = 'pointer' | 'keyboard';
2187
+ type HermesDragVia = DragVia;
2206
2188
  ```
2207
2189
 
2208
2190
  - `HermesDropAccepts` — Filtro de uma zona: tipo (`hmDragType`), lista de tipos ou predicado sobre os dados e o tipo.
2209
2191
 
2210
2192
  ```ts
2211
- type HermesDropAccepts = string | readonly string[] | ((data: unknown, type: string) => boolean) | null;
2193
+ type HermesDropAccepts = DropAccepts;
2212
2194
  ```
2213
2195
 
2214
2196
  - `HermesDropEvent` — Item solto numa zona (`[hmDropZone]` → `dropped`).
@@ -2253,7 +2235,7 @@ interface HermesDragTemplateContext<T = unknown> {
2253
2235
  }
2254
2236
  ```
2255
2237
 
2256
- - `HermesDragItemRef` — @internal Um item arrastável, visto pelo serviço.
2238
+ - `HermesDragItemRef` — @internal Um item arrastável, visto pelo serviço (o `DragItemRef` do coordenador de @trismegisto/primitives, com o template do Angular).
2257
2239
 
2258
2240
  ```ts
2259
2241
  interface HermesDragItemRef {
@@ -2273,7 +2255,7 @@ interface HermesDragItemRef {
2273
2255
  }
2274
2256
  ```
2275
2257
 
2276
- - `HermesDropTargetRef` — @internal Um destino (zona simples ou lista ordenável), visto pelo serviço.
2258
+ - `HermesDropTargetRef` — @internal Um destino (zona simples ou lista ordenável), visto pelo serviço (o `DropTargetRef` do coordenador, com o template do Angular).
2277
2259
 
2278
2260
  ```ts
2279
2261
  interface HermesDropTargetRef {
@@ -2306,14 +2288,15 @@ interface HermesSortableContainer extends HermesDropTargetRef {
2306
2288
  ```
2307
2289
 
2308
2290
  - `const HM_SORTABLE_CONTAINER: InjectionToken<HermesSortableContainer>` — @internal
2309
- - `function accessibleName(element: HTMLElement): string` — Nome acessível de um elemento (`aria-label` ou o texto de quem o `aria-labelledby` aponta).
2310
- - `` — Ordena pela posição no documento.
2291
+ - `function accessibleName(element: HTMLElement): string` _(de `@trismegisto/primitives/drag-drop`)_ — Nome acessível de um elemento (`aria-label` ou o texto de quem o `aria-labelledby` aponta).
2292
+ - `` _(de `@trismegisto/primitives/drag-drop`)_ — Ordena pela posição no documento.
2311
2293
  - **`HermesDragDropService`** (classe)
2312
2294
 
2313
2295
  ```ts
2314
2296
  class HermesDragDropService {
2315
- readonly instructionsId
2316
2297
  readonly dragging = signal(…)
2298
+ readonly instructionsId
2299
+ get announcement(): string
2317
2300
  registerTarget(target: HermesDropTargetRef): void
2318
2301
  unregisterTarget(target: HermesDropTargetRef): void
2319
2302
  registerItem(item: HermesDragItemRef): void
@@ -2325,7 +2308,6 @@ class HermesDragDropService {
2325
2308
  keyboardGrab(item: HermesDragItemRef): void
2326
2309
  keyboardKey(event: KeyboardEvent): boolean
2327
2310
  keyboardBlur(item: HermesDragItemRef): void
2328
- get announcement(): string
2329
2311
  }
2330
2312
  ```
2331
2313
 
@@ -2363,7 +2345,13 @@ type DrawerPosition = 'end' | 'start' | 'bottom';
2363
2345
 
2364
2346
  ## `@trismegisto/angular/dropdown`
2365
2347
 
2366
- - `DropdownPosition` — Posição no formato do hermes-ui antigo (`hermesPosition`): `<lado>-<alinhamento>`.
2348
+ - `DropdownComponent` — `hm-dropdown` (ver angular-api.md)
2349
+ - `DropdownTriggerDirective` — `[hmDropdownTrigger]` (ver angular-api.md)
2350
+ - `DropdownIfOpenDirective` — `[hmIfOpen]` (ver angular-api.md)
2351
+ - `DropdownItemDirective` — `[hmDropdownItem]` (ver angular-api.md)
2352
+ - `DropdownMenuComponent` — `hm-dropdown-menu` (ver angular-api.md)
2353
+ - `const HERMES_DROPDOWN =`
2354
+ - `DropdownPosition` _(de `@trismegisto/primitives/dropdown`)_ — Posição no formato do hermes-ui antigo (`hermesPosition`): `<lado>-<alinhamento>`.
2367
2355
 
2368
2356
  ```ts
2369
2357
  type DropdownPosition =
@@ -2377,13 +2365,6 @@ type DropdownPosition =
2377
2365
  | 'right-bottom';
2378
2366
  ```
2379
2367
 
2380
- - `DropdownComponent` — `hm-dropdown` (ver angular-api.md)
2381
- - `DropdownTriggerDirective` — `[hmDropdownTrigger]` (ver angular-api.md)
2382
- - `DropdownIfOpenDirective` — `[hmIfOpen]` (ver angular-api.md)
2383
- - `DropdownItemDirective` — `[hmDropdownItem]` (ver angular-api.md)
2384
- - `DropdownMenuComponent` — `hm-dropdown-menu` (ver angular-api.md)
2385
- - `const HERMES_DROPDOWN =`
2386
-
2387
2368
  ## `@trismegisto/angular/dual-list`
2388
2369
 
2389
2370
  - `DualListSize`
@@ -2418,19 +2399,20 @@ type EmptyHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
2418
2399
 
2419
2400
  ## `@trismegisto/angular/endpoint-card`
2420
2401
 
2421
- - `EndpointParamLocation`
2402
+ - `EndpointCardComponent` — `hm-endpoint-card` (ver angular-api.md)
2403
+ - `EndpointHeadingLevel` _(de `@trismegisto/primitives/endpoint-card`)_ — Nível do título (`0` = texto em destaque, não título).
2422
2404
 
2423
2405
  ```ts
2424
- type EndpointParamLocation = 'path' | 'query' | 'header' | 'body';
2406
+ type EndpointHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
2425
2407
  ```
2426
2408
 
2427
- - `EndpointLifecycle`
2409
+ - `EndpointLifecycle` _(de `@trismegisto/primitives/endpoint-card`)_
2428
2410
 
2429
2411
  ```ts
2430
2412
  type EndpointLifecycle = 'stable' | 'beta' | 'deprecated';
2431
2413
  ```
2432
2414
 
2433
- - `EndpointParam`
2415
+ - `EndpointParam` _(de `@trismegisto/primitives/endpoint-card`)_
2434
2416
 
2435
2417
  ```ts
2436
2418
  interface EndpointParam {
@@ -2442,22 +2424,21 @@ interface EndpointParam {
2442
2424
  }
2443
2425
  ```
2444
2426
 
2445
- - `EndpointResponse`
2427
+ - `EndpointParamLocation` _(de `@trismegisto/primitives/endpoint-card`)_ — Cartão de um endpoint de API (`hm-endpoint-card`, Angular e React): os tipos dos dados e as regras de texto e cor, fora do framework. O caminho com parâmetros destacados e a classe do status HTTP vêm de `dev-tools` (`en…
2446
2428
 
2447
2429
  ```ts
2448
- interface EndpointResponse {
2449
- readonly status: number;
2450
- readonly description?: string;
2451
- }
2430
+ type EndpointParamLocation = 'path' | 'query' | 'header' | 'body';
2452
2431
  ```
2453
2432
 
2454
- - `EndpointHeadingLevel` — Nível do título (`0` = texto em destaque, não título).
2433
+ - `EndpointResponse` _(de `@trismegisto/primitives/endpoint-card`)_
2455
2434
 
2456
2435
  ```ts
2457
- type EndpointHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
2436
+ interface EndpointResponse {
2437
+ readonly status: number;
2438
+ readonly description?: string;
2439
+ }
2458
2440
  ```
2459
2441
 
2460
- - `EndpointCardComponent` — `hm-endpoint-card` (ver angular-api.md)
2461
2442
  - `EndpointCardMessages`
2462
2443
 
2463
2444
  ```ts
@@ -2467,16 +2448,10 @@ type EndpointCardMessages = CalendarFilesMessages['endpointCard'];
2467
2448
  - `const ENDPOINT_CARD_MESSAGES_PT_BR: EndpointCardMessages`
2468
2449
  - `const ENDPOINT_CARD_MESSAGES_EN: EndpointCardMessages`
2469
2450
  - `const ENDPOINT_CARD_MESSAGES_ES: EndpointCardMessages`
2470
- - `const ENDPOINT_CARD_MESSAGES: Readonly<Record<string, EndpointCardMessages>>` — Catálogos por idioma, no formato do `HermesI18nService.pick`.
2451
+ - `const ENDPOINT_CARD_MESSAGES: Readonly<Record<string, EndpointCardMessages>>` — Catálogos por idioma, no formato do `pick` do i18n (Angular e React).
2471
2452
 
2472
2453
  ## `@trismegisto/angular/entity-picker`
2473
2454
 
2474
- - `EntityPickerValue` — Valor do seletor: o id escolhido (`''` = nenhum) ou, com `multiple`, a lista de ids.
2475
-
2476
- ```ts
2477
- type EntityPickerValue = string | readonly string[];
2478
- ```
2479
-
2480
2455
  - `EntityPickerComponent` — `hm-entity-picker` (ver angular-api.md)
2481
2456
  - `EntityPickerMessages`
2482
2457
 
@@ -2510,7 +2485,14 @@ interface EntityPickerMessages {
2510
2485
 
2511
2486
  ## `@trismegisto/angular/environment-picker`
2512
2487
 
2513
- - `EnvironmentOption` — Um ambiente de deploy.
2488
+ - `ClusterOption` — Um cluster; com `environmentId`, só aparece naquele ambiente.
2489
+
2490
+ ```ts
2491
+ type ClusterOption = EnvironmentCluster;
2492
+ ```
2493
+
2494
+ - `EnvironmentPickerComponent` — `hm-environment-picker` (ver angular-api.md)
2495
+ - `EnvironmentOption` _(de `@trismegisto/primitives/environment-picker`)_ — Um ambiente oferecido.
2514
2496
 
2515
2497
  ```ts
2516
2498
  interface EnvironmentOption {
@@ -2520,19 +2502,12 @@ interface EnvironmentOption {
2520
2502
  }
2521
2503
  ```
2522
2504
 
2523
- - `ClusterOption` — Um cluster; com `environmentId`, só aparece naquele ambiente.
2524
-
2525
- ```ts
2526
- type ClusterOption = EnvironmentCluster;
2527
- ```
2528
-
2529
- - `EnvironmentPickerControl` — Controle do ambiente: `auto` (segmentado até 4 ambientes com rótulos curtos, lista nos outros casos), `segmented` ou `select`.
2505
+ - `EnvironmentPickerControl` _(de `@trismegisto/primitives/environment-picker`)_ — `auto`: segmentado quando cabe numa tela estreita; senão, select.
2530
2506
 
2531
2507
  ```ts
2532
2508
  type EnvironmentPickerControl = 'auto' | 'segmented' | 'select';
2533
2509
  ```
2534
2510
 
2535
- - `EnvironmentPickerComponent` — `hm-environment-picker` (ver angular-api.md)
2536
2511
  - `EnvironmentPickerMessages` — Textos do `hm-environment-picker`. pt-BR embutido; en/es ao lado. O app sobrescreve frases pelo input `texts` do componente.
2537
2512
 
2538
2513
  ```ts
@@ -2652,29 +2627,6 @@ type EventCalendarEditingMessages = CalendarFilesMessages['eventCalendarEditing'
2652
2627
 
2653
2628
  ## `@trismegisto/angular/fab`
2654
2629
 
2655
- - `FabPosition` — Canto (ou centro da base) onde o botão flutua. Lógico: `end` é a direita em LTR e a esquerda em RTL.
2656
-
2657
- ```ts
2658
- type FabPosition = 'bottom-end' | 'bottom-start' | 'bottom-center' | 'top-end' | 'top-start';
2659
- ```
2660
-
2661
- - `FabSize`
2662
-
2663
- ```ts
2664
- type FabSize = 'small' | 'medium' | 'large';
2665
- ```
2666
-
2667
- - `FabAction` — Ação do "speed dial": cada uma vira um `menuitem` com ícone e rótulo visível.
2668
-
2669
- ```ts
2670
- interface FabAction {
2671
- readonly id: string;
2672
- readonly label: string;
2673
- readonly icon?: string;
2674
- readonly disabled?: boolean;
2675
- }
2676
- ```
2677
-
2678
2630
  - `FabComponent` — `hm-fab` (ver angular-api.md)
2679
2631
 
2680
2632
  ## `@trismegisto/angular/feature-flags`
@@ -2758,6 +2710,7 @@ interface FieldMappingMessages {
2758
2710
  - `const FIELD_MAPPING_MESSAGES_PT_BR: FieldMappingMessages`
2759
2711
  - `const FIELD_MAPPING_MESSAGES_EN: FieldMappingMessages`
2760
2712
  - `const FIELD_MAPPING_MESSAGES_ES: FieldMappingMessages`
2713
+ - `const FIELD_MAPPING_MESSAGES: Readonly<Record<string, FieldMappingMessages>>` — Catálogos por idioma, para o `pick` do store de i18n.
2761
2714
 
2762
2715
  ## `@trismegisto/angular/file-list`
2763
2716
 
@@ -2979,15 +2932,6 @@ interface SavedFilter {
2979
2932
 
2980
2933
  ## `@trismegisto/angular/finance`
2981
2934
 
2982
- - `CreditLine` — Limite de crédito: total e quanto já foi usado.
2983
-
2984
- ```ts
2985
- interface CreditLine {
2986
- readonly limit: number;
2987
- readonly used: number;
2988
- }
2989
- ```
2990
-
2991
2935
  - `BalanceCardComponent` — `hm-balance-card` (ver angular-api.md)
2992
2936
  - `BudgetVarianceComponent` — `hm-budget-variance` (ver angular-api.md)
2993
2937
  - `const FINANCE_MESSAGES_PT_BR =`
@@ -3006,14 +2950,10 @@ type FinanceMessages = typeof FINANCE_MESSAGES_PT_BR;
3006
2950
  ## `@trismegisto/angular/floating-window`
3007
2951
 
3008
2952
  - `FloatingWindowComponent` — `hm-floating-window` (ver angular-api.md)
3009
- - `HermesOverlayStackEntry` — Uma janela registrada na pilha.
2953
+ - `HermesOverlayStackEntry` — Uma janela registrada na pilha (o `FloatingOverlayEntry` dos primitives).
3010
2954
 
3011
2955
  ```ts
3012
- interface HermesOverlayStackEntry {
3013
- readonly id: string;
3014
- readonly element: () => HTMLElement | null | undefined;
3015
- readonly focus: () => void;
3016
- }
2956
+ type HermesOverlayStackEntry = FloatingOverlayEntry;
3017
2957
  ```
3018
2958
 
3019
2959
  - **`HermesOverlayStack`** (classe)
@@ -3056,7 +2996,7 @@ interface FormErrorSummaryMessages {
3056
2996
 
3057
2997
  - `const DateRangeValidators =` — Validadores para um controle cujo valor é `DateRange` (`hm-date-range-picker` com `formControlName`). `Validators.required` do Angular não serve aqui: `{ start: null, end: null }` é um objeto não vazio, então ele daria…
3058
2998
  - `HermesFormFieldBase` — classe base
3059
- - `const TimeRangeValidators =` — Validadores para um controle cujo valor é `TimeRange` (`hm-time-range` com `formControlName`). `Validators.required` do Angular não serve: `{ start: null, end: null }` é um objeto não vazio.
2999
+ - `const TimeRangeValidators =` — Validadores para um controle cujo valor é `TimeRange` (`hm-time-range` com `formControlName`). `Validators.required` do Angular não serve: `{ start: null, end: null }` é um objeto não vazio. A regra mora em `TimeRangeCh…
3060
3000
 
3061
3001
  ## `@trismegisto/angular/gantt`
3062
3002
 
@@ -3082,44 +3022,6 @@ interface GanttTaskChange {
3082
3022
 
3083
3023
  ## `@trismegisto/angular/global-search`
3084
3024
 
3085
- - `HermesSearchResult` — Um resultado da busca global.
3086
-
3087
- ```ts
3088
- interface HermesSearchResult {
3089
- readonly id: string;
3090
- readonly label: string;
3091
- readonly description?: string;
3092
- readonly icon?: string;
3093
- readonly disabled?: boolean;
3094
- readonly data?: unknown;
3095
- }
3096
- ```
3097
-
3098
- - `HermesSearchGroup` — Os resultados de uma fonte (escopo): "Pessoas", "Servidores", "Telas"…
3099
-
3100
- ```ts
3101
- interface HermesSearchGroup {
3102
- readonly id: string;
3103
- readonly label: string;
3104
- readonly results: readonly HermesSearchResult[];
3105
- }
3106
- ```
3107
-
3108
- - `HermesSearchFn` — A consulta do app: recebe o termo e um `AbortSignal` (abortado quando o termo muda).
3109
-
3110
- ```ts
3111
- type HermesSearchFn = (term: string, signal: AbortSignal) => Promise<readonly HermesSearchGroup[]>;
3112
- ```
3113
-
3114
- - `HermesSearchSelection` — O que `(selected)` emite.
3115
-
3116
- ```ts
3117
- interface HermesSearchSelection {
3118
- readonly result: HermesSearchResult;
3119
- readonly group: HermesSearchGroup;
3120
- }
3121
- ```
3122
-
3123
3025
  - `GlobalSearchComponent` — `hm-global-search` (ver angular-api.md)
3124
3026
 
3125
3027
  ## `@trismegisto/angular/header`
@@ -3128,12 +3030,6 @@ interface HermesSearchSelection {
3128
3030
 
3129
3031
  ## `@trismegisto/angular/health-status`
3130
3032
 
3131
- - `HealthStatusAppearance` — Forma do indicador: `badge` (pílula com ícone e texto), `dot` (ponto e texto, para tabela) ou `banner` (faixa de "saúde do sistema" no topo de uma status page).
3132
-
3133
- ```ts
3134
- type HealthStatusAppearance = 'badge' | 'dot' | 'banner';
3135
- ```
3136
-
3137
3033
  - `HealthStatusSize`
3138
3034
 
3139
3035
  ```ts
@@ -3142,6 +3038,12 @@ type HealthStatusSize = 'small' | 'medium';
3142
3038
 
3143
3039
  - `function healthStatusShape(status: HealthStatus): string` — Nome do ícone de um estado de saúde (o mesmo que o `hm-health-status` desenha).
3144
3040
  - `HealthStatusComponent` — `hm-health-status` (ver angular-api.md)
3041
+ - `HealthStatusAppearance` _(de `@trismegisto/primitives/health-status`)_ — Forma do indicador: `badge`, `dot` ou `banner`.
3042
+
3043
+ ```ts
3044
+ type HealthStatusAppearance = 'badge' | 'dot' | 'banner';
3045
+ ```
3046
+
3145
3047
  - `HealthStatusMessages` — Textos do `hm-health-status`. pt-BR embutido; en/es ao lado. O app sobrescreve frases pelo input `texts` do componente.
3146
3048
 
3147
3049
  ```ts
@@ -3165,33 +3067,13 @@ interface HealthStatusMessages {
3165
3067
 
3166
3068
  ## `@trismegisto/angular/i18n`
3167
3069
 
3168
- - `HermesI18nConfig`
3169
-
3170
- ```ts
3171
- interface HermesI18nConfig {
3172
- readonly locale?: string;
3173
- readonly base?: HermesMessages;
3174
- readonly catalogs?: Readonly<Record<string, HermesMessages | HermesCatalogLoader>>;
3175
- readonly override?: HermesMessagesOverride;
3176
- readonly regionalFormat?: HermesRegionalFormat;
3177
- }
3178
- ```
3179
-
3180
3070
  - `const HERMES_I18N_CONFIG: InjectionToken<HermesI18nConfig>`
3181
- - `HermesCatalogLoader` — Carrega um catálogo sob demanda (o `import()` vira um chunk à parte no bundle do app).
3182
-
3183
- ```ts
3184
- type HermesCatalogLoader = () => Promise<HermesMessages>;
3185
- ```
3186
-
3187
- - `const HERMES_CATALOG_LOADERS: Readonly<Record<string, HermesCatalogLoader>>` — Carregadores dos catálogos que acompanham a lib, fora o pt-BR (o único embutido): só o idioma que a pessoa escolher é baixado, e só quando escolher. Mantém leve o bundle de quem usa um idioma só.
3188
- - `function preloadHermesCatalog(locale: string): Promise<HermesMessages | undefined>` — Baixa antes um catálogo da lib (`'en'`, `'es'`) — ex.: num `provideAppInitializer`, para o primeiro `setLocale` daquele idioma ser síncrono. Idioma sem carregador conhecido: resolve `undefined`.
3189
3071
  - **`HermesI18nService`** (classe)
3190
3072
 
3191
3073
  ```ts
3192
3074
  class HermesI18nService {
3193
- readonly locale = signal(…)
3194
- readonly regionalFormat = signal(…)
3075
+ readonly locale = computed(…)
3076
+ readonly regionalFormat = computed(…)
3195
3077
  readonly messages = computed(…)
3196
3078
  readonly formatLocale = computed(…)
3197
3079
  setLocale(locale: string): Promise<void>
@@ -3240,6 +3122,7 @@ type IconFlip = 'horizontal' | 'vertical';
3240
3122
  - `const ICON_APPLICATION: RegisteredIcon`
3241
3123
  - `const ICON_ARROW: RegisteredIcon`
3242
3124
  - `const ICON_ARROW_BACK: RegisteredIcon`
3125
+ - `const ICON_ARROW_FORWARD: RegisteredIcon`
3243
3126
  - `const ICON_ARROW_LR: RegisteredIcon`
3244
3127
  - `const ICON_ARROW_SEND: RegisteredIcon`
3245
3128
  - `const ICON_ARROWS_HORIZONTAL: RegisteredIcon`
@@ -3250,7 +3133,9 @@ type IconFlip = 'horizontal' | 'vertical';
3250
3133
  - `const ICON_BANK: RegisteredIcon`
3251
3134
  - `const ICON_BAR_CODE: RegisteredIcon`
3252
3135
  - `const ICON_BELL_SYMBOL: RegisteredIcon`
3136
+ - `const ICON_BLOCK: RegisteredIcon`
3253
3137
  - `const ICON_BLOCK_QUOTE: RegisteredIcon`
3138
+ - `const ICON_BOAT: RegisteredIcon`
3254
3139
  - `const ICON_BOLD: RegisteredIcon`
3255
3140
  - `const ICON_BOLT: RegisteredIcon`
3256
3141
  - `const ICON_BOOKMARK: RegisteredIcon`
@@ -3309,6 +3194,7 @@ type IconFlip = 'horizontal' | 'vertical';
3309
3194
  - `const ICON_FILTER_GRID: RegisteredIcon`
3310
3195
  - `const ICON_FILTER_OFF: RegisteredIcon`
3311
3196
  - `const ICON_FINGERPRINT_SQUARE: RegisteredIcon`
3197
+ - `const ICON_FLAG: RegisteredIcon`
3312
3198
  - `const ICON_FLAME: RegisteredIcon`
3313
3199
  - `const ICON_FLASK: RegisteredIcon`
3314
3200
  - `const ICON_FOLDER: RegisteredIcon`
@@ -3377,6 +3263,7 @@ type IconFlip = 'horizontal' | 'vertical';
3377
3263
  - `const ICON_SERVERS_DATABASE: RegisteredIcon`
3378
3264
  - `const ICON_SHOPPING_CART: RegisteredIcon`
3379
3265
  - `const ICON_SHRINK: RegisteredIcon`
3266
+ - `const ICON_SORT_VERTICAL: RegisteredIcon`
3380
3267
  - `const ICON_STAR: RegisteredIcon`
3381
3268
  - `const ICON_STEP_FORWARD_2: RegisteredIcon`
3382
3269
  - `const ICON_STOP: RegisteredIcon`
@@ -3480,7 +3367,8 @@ interface IdentityDocumentMessages {
3480
3367
 
3481
3368
  ## `@trismegisto/angular/illustration-shared`
3482
3369
 
3483
- - `IllustrationIdRef` — Referência a um elemento definidor de SVG (`<clipPath>`, gradiente, máscara, filtro).
3370
+ - `function illustrationIds<const K extends string>( name: string, ...keys: readonly K[] ): Readonly<Record<K, IllustrationIdRef>>` _(de `@trismegisto/primitives/illustration-ids`)_ — Ids de SVG próprios de uma instância de ilustração, no formato `hm-illustration-<nome>-<n>-<chave>`. Cada chamada reserva um `n` novo, compartilhado pelas chaves dela. Não toca no DOM (seguro em SSR).
3371
+ - `IllustrationIdRef` _(de `@trismegisto/primitives/illustration-ids`)_ — Referência a um elemento definidor de SVG (`<clipPath>`, gradiente, máscara, filtro).
3484
3372
 
3485
3373
  ```ts
3486
3374
  interface IllustrationIdRef {
@@ -3490,8 +3378,6 @@ interface IllustrationIdRef {
3490
3378
  }
3491
3379
  ```
3492
3380
 
3493
- - `function illustrationIds<const K extends string>( name: string, ...keys: readonly K[] ): Readonly<Record<K, IllustrationIdRef>>` — Ids de SVG próprios de uma instância de ilustração, no formato `hm-illustration-<nome>-<n>-<chave>`. Cada chamada reserva um `n` novo, compartilhado pelas chaves dela. Não toca no DOM (seguro em SSR).
3494
-
3495
3381
  ## `@trismegisto/angular/illustration-success`
3496
3382
 
3497
3383
  - `IllustrationSuccessComponent` — `hm-illustration-success` (ver angular-api.md)
@@ -3647,17 +3533,7 @@ interface GalleryImage {
3647
3533
 
3648
3534
  ## `@trismegisto/angular/incident`
3649
3535
 
3650
- - `IncidentPerson` — Pessoa que pode responder por um incidente.
3651
-
3652
- ```ts
3653
- interface IncidentPerson {
3654
- readonly id: string;
3655
- readonly name: string;
3656
- readonly imageUrl?: string | null;
3657
- }
3658
- ```
3659
-
3660
- - `Incident` — Um incidente como o app o entrega (já pronto, sem consulta nenhuma daqui). Instantes em ms.
3536
+ - `Incident` _(de `@trismegisto/primitives/incident`)_ — Um incidente como o app o entrega (já pronto, sem consulta nenhuma daqui). Instantes em ms.
3661
3537
 
3662
3538
  ```ts
3663
3539
  interface Incident {
@@ -3674,7 +3550,17 @@ interface Incident {
3674
3550
  }
3675
3551
  ```
3676
3552
 
3677
- - `IncidentUpdate` — Uma atualização da linha do tempo do incidente.
3553
+ - `IncidentPerson` _(de `@trismegisto/primitives/incident`)_ — Pessoa que pode responder por um incidente.
3554
+
3555
+ ```ts
3556
+ interface IncidentPerson {
3557
+ readonly id: string;
3558
+ readonly name: string;
3559
+ readonly imageUrl?: string | null;
3560
+ }
3561
+ ```
3562
+
3563
+ - `IncidentUpdate` _(de `@trismegisto/primitives/incident`)_ — Uma atualização da linha do tempo do incidente.
3678
3564
 
3679
3565
  ```ts
3680
3566
  interface IncidentUpdate {
@@ -3686,10 +3572,10 @@ interface IncidentUpdate {
3686
3572
  }
3687
3573
  ```
3688
3574
 
3689
- - `const INCIDENT_SEVERITY_ICONS: Readonly<Record<IncidentSeverity, string>>` — Ícone de cada severidade: a forma muda junto com a cor.
3690
- - `const INCIDENT_STATUS_ICONS: Readonly<Record<IncidentStatus, string>>` — Ícone de cada estado do incidente.
3691
- - `const INCIDENT_ACTION_ICONS: Readonly<Record<IncidentAction, string>>` — Ícone de cada ação.
3692
- - `function formatIncidentTime(time: number, locale: string): string` — Data e hora curtas no idioma do catálogo.
3575
+ - `function formatIncidentTime(time: number, locale: string): string` _(de `@trismegisto/primitives/incident`)_ — Data e hora curtas no idioma do catálogo.
3576
+ - `const INCIDENT_ACTION_ICONS: Readonly<Record<IncidentAction, string>>` _(de `@trismegisto/primitives/incident`)_ — Ícone de cada ação.
3577
+ - `const INCIDENT_SEVERITY_ICONS: Readonly<Record<IncidentSeverity, string>>` _(de `@trismegisto/primitives/incident`)_ — Ícone de cada severidade: a forma muda junto com a cor.
3578
+ - `const INCIDENT_STATUS_ICONS: Readonly<Record<IncidentStatus, string>>` _(de `@trismegisto/primitives/incident`)_ — Ícone de cada estado do incidente.
3693
3579
  - `IncidentMessages`
3694
3580
 
3695
3581
  ```ts
@@ -3731,32 +3617,31 @@ type IncidentHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
3731
3617
 
3732
3618
  ## `@trismegisto/angular/input`
3733
3619
 
3734
- - `InputType`
3620
+ - `InputMaskValue` — `raw`: o modelo guarda só os caracteres digitados (`12345678901`); `masked`: com a pontuação.
3735
3621
 
3736
3622
  ```ts
3737
- type InputType = 'text' | 'email' | 'tel' | 'url' | 'number' | 'search' | 'password';
3623
+ type InputMaskValue = 'raw' | 'masked';
3738
3624
  ```
3739
3625
 
3740
- - `InputValue` — Valor do `hm-input`: texto, ou número (`null` = vazio) quando `type="number"`.
3626
+ - `InputComponent` — `hm-input` (ver angular-api.md)
3627
+ - `InputMode` _(de `@trismegisto/primitives/input`)_
3741
3628
 
3742
3629
  ```ts
3743
- type InputValue = string | number | null;
3630
+ type InputMode = 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
3744
3631
  ```
3745
3632
 
3746
- - `InputMaskValue` — `raw`: o modelo guarda só os caracteres digitados (`12345678901`); `masked`: com a pontuação.
3633
+ - `InputType` _(de `@trismegisto/primitives/input`)_ — Regras sem framework do `hm-input`: tipo e teclado virtual do `<input>`, texto mostrado (com máscara), validação e passo do `type="number"`.
3747
3634
 
3748
3635
  ```ts
3749
- type InputMaskValue = 'raw' | 'masked';
3636
+ type InputType = 'text' | 'email' | 'tel' | 'url' | 'number' | 'search' | 'password';
3750
3637
  ```
3751
3638
 
3752
- - `InputMode`
3639
+ - `InputValue` _(de `@trismegisto/primitives/input`)_ — Valor do `hm-input`: texto, ou número (`null` = vazio) quando `type="number"`.
3753
3640
 
3754
3641
  ```ts
3755
- type InputMode = 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
3642
+ type InputValue = string | number | null;
3756
3643
  ```
3757
3644
 
3758
- - `InputComponent` — `hm-input` (ver angular-api.md)
3759
-
3760
3645
  ## `@trismegisto/angular/integration`
3761
3646
 
3762
3647
  - `IntegrationHeadingLevel` — Nível do título do cartão (2..6).
@@ -3782,18 +3667,6 @@ type IntegrationDetailHeadingLevel = 1 | 2 | 3 | 4;
3782
3667
  ```
3783
3668
 
3784
3669
  - `IntegrationDetailComponent` — `hm-integration-detail` (ver angular-api.md)
3785
- - `ConnectedAccountInfo` — A conta de terceiro ligada a uma integração (dados prontos do app).
3786
-
3787
- ```ts
3788
- interface ConnectedAccountInfo {
3789
- readonly name: string;
3790
- readonly email?: string;
3791
- readonly imageUrl?: string;
3792
- readonly connectedAt?: number;
3793
- readonly expired?: boolean;
3794
- }
3795
- ```
3796
-
3797
3670
  - `ConnectedAccountComponent` — `hm-connected-account` (ver angular-api.md)
3798
3671
  - `IntegrationMessages` — Textos de hm-integration-card, hm-integration-catalog, hm-integration-detail e hm-connected-account.
3799
3672
 
@@ -3856,7 +3729,7 @@ interface IntegrationTextMessages {
3856
3729
  expired: string;
3857
3730
  disabled: string;
3858
3731
  };
3859
- duration: { ms: string; seconds: string; minutes: string; hours: string };
3732
+ duration: IntegrationDurationMessages;
3860
3733
  }
3861
3734
  ```
3862
3735
 
@@ -3864,8 +3737,8 @@ interface IntegrationTextMessages {
3864
3737
  - `const INTEGRATION_TEXT_MESSAGES_EN: IntegrationTextMessages`
3865
3738
  - `const INTEGRATION_TEXT_MESSAGES_ES: IntegrationTextMessages`
3866
3739
  - `function injectIntegrationText(): Signal<IntegrationTextMessages>` — Textos comuns da área de integrações no idioma ativo (reativo à troca). Chame num inicializador de campo (contexto de injeção).
3867
- - `function formatIntegrationDuration(ms: number, text: IntegrationTextMessages['duration'], locale = 'pt-BR'): string` — Duração curta e legível (`850 ms`, `4,2 s`, `3 min 12 s`, `1 h 05 min`) com os textos de `duration`. Os números saem no formato do idioma (`locale`).
3868
- - `function formatIntegrationTimestamp(at: number, locale = 'pt-BR', timeZone?: string): string` — Data e hora curtas no idioma (`30/10/2026 14:05`). `timeZone` fixa o fuso (útil em teste e captura).
3740
+ - `function formatIntegrationDuration(ms: number, text: IntegrationDurationMessages, locale = 'pt-BR'): string` _(de `@trismegisto/primitives/integration-text`)_ — Duração curta e legível (`850 ms`, `4,2 s`, `3 min 12 s`, `1 h 05 min`) com os textos de `duration`. Os números saem no formato do idioma (`locale`).
3741
+ - `function formatIntegrationTimestamp(at: number, locale = 'pt-BR', timeZone?: string): string` _(de `@trismegisto/primitives/integration-text`)_ — Data e hora curtas no idioma (`30/10/2026 14:05`). `timeZone` fixa o fuso (útil em teste e captura).
3869
3742
 
3870
3743
  ## `@trismegisto/angular/invoice`
3871
3744
 
@@ -3879,16 +3752,8 @@ type InvoiceMessages = typeof INVOICE_MESSAGES_PT_BR;
3879
3752
  - `const INVOICE_MESSAGES_EN: InvoiceMessages`
3880
3753
  - `const INVOICE_MESSAGES_ES: InvoiceMessages`
3881
3754
  - `const INVOICE_MESSAGES: Readonly<Record<string, InvoiceMessages>>`
3882
- - `InvoiceParty` — Emitente ou cliente da fatura: nome e as linhas que o app quiser (documento, endereço, e-mail).
3883
-
3884
- ```ts
3885
- interface InvoiceParty {
3886
- readonly name: string;
3887
- readonly lines?: readonly string[];
3888
- }
3889
- ```
3890
-
3891
- - `InvoiceInfo` — Uma fatura, como o `hm-invoice` mostra.
3755
+ - `InvoiceComponent` — `hm-invoice` (ver angular-api.md)
3756
+ - `InvoiceInfo` _(de `@trismegisto/primitives/invoice`)_ — Uma fatura, como o `hm-invoice` mostra.
3892
3757
 
3893
3758
  ```ts
3894
3759
  interface InvoiceInfo {
@@ -3906,7 +3771,14 @@ interface InvoiceInfo {
3906
3771
  }
3907
3772
  ```
3908
3773
 
3909
- - `InvoiceComponent` — `hm-invoice` (ver angular-api.md)
3774
+ - `InvoiceParty` _(de `@trismegisto/primitives/invoice`)_ — Emitente ou cliente da fatura: nome e as linhas que o app quiser (documento, endereço, e-mail).
3775
+
3776
+ ```ts
3777
+ interface InvoiceParty {
3778
+ readonly name: string;
3779
+ readonly lines?: readonly string[];
3780
+ }
3781
+ ```
3910
3782
 
3911
3783
  ## `@trismegisto/angular/item`
3912
3784
 
@@ -4116,7 +3988,7 @@ interface LegendItem {
4116
3988
  - `LevelScaleInput` — Escala aceita pelos componentes: o nome de uma pronta (`'priority'`, `'severity'`...) ou uma própria.
4117
3989
 
4118
3990
  ```ts
4119
- type LevelScaleInput = LevelScaleKind | LevelScale;
3991
+ type LevelScaleInput = LevelScaleInputBase;
4120
3992
  ```
4121
3993
 
4122
3994
  - `function resolveLevelScale(scale: LevelScaleInput, messages: WorkflowCatalog): LevelScale` — Resolve a escala com os nomes do catálogo ativo (as prontas) ou devolve a própria.
@@ -4271,17 +4143,109 @@ interface MaintenanceWindowMessages {
4271
4143
  - `const MAINTENANCE_WINDOW_MESSAGES_EN: MaintenanceWindowMessages`
4272
4144
  - `const MAINTENANCE_WINDOW_MESSAGES_ES: MaintenanceWindowMessages`
4273
4145
 
4274
- ## `@trismegisto/angular/member-list`
4146
+ ## `@trismegisto/angular/map`
4275
4147
 
4276
- - `MemberRoleChange` — Troca de papel pedida na lista.
4148
+ - `const HM_MAP_COMPONENTS =` — Todas as peças do mapa, para `imports: [HM_MAP_COMPONENTS]`.
4149
+ - `MapComponent` — `hm-map` (ver angular-api.md)
4150
+ - `MapScaleUnits`
4151
+ - `MapMarkerComponent` — `hm-map-marker` (ver angular-api.md)
4152
+ - `MapClusterComponent` — `hm-map-cluster` (ver angular-api.md)
4153
+ - `MapClusterEvent` — Evento de `(clusterClick)`: os marcadores do grupo acionado e a área que eles ocupam.
4277
4154
 
4278
4155
  ```ts
4279
- interface MemberRoleChange {
4280
- readonly member: PeopleMember;
4281
- readonly role: string;
4156
+ interface MapClusterEvent {
4157
+ readonly markers: readonly MapMarkerComponent[];
4158
+ readonly positions: readonly LatLng[];
4159
+ }
4160
+ ```
4161
+
4162
+ - `MapPopupComponent` — `hm-map-popup` (ver angular-api.md)
4163
+ - `MapPathBase` — classe base
4164
+ - `MapPolylineComponent` — `hm-map-polyline` (ver angular-api.md)
4165
+ - `MapPolygonComponent` — `hm-map-polygon` (ver angular-api.md)
4166
+ - `MapCircleComponent` — `hm-map-circle` (ver angular-api.md)
4167
+ - `MapGeoJsonComponent` — `hm-map-geojson` (ver angular-api.md)
4168
+ - `MapFeatureEvent`
4169
+
4170
+ ```ts
4171
+ interface MapFeatureEvent {
4172
+ readonly feature: GeoJsonFeature;
4173
+ readonly index: number;
4282
4174
  }
4283
4175
  ```
4284
4176
 
4177
+ - `const HM_MAP: InjectionToken<HmMapContext>`
4178
+ - `const HM_MAP_MARKER: InjectionToken<HmMapMarkerContext>`
4179
+ - `HmMapContext` — O que as peças filhas (`hm-map-marker`, `hm-map-polyline`...) usam do `hm-map`.
4180
+
4181
+ ```ts
4182
+ interface HmMapContext {
4183
+ readonly frame: Signal<LayerFrame>;
4184
+ readonly ready: Signal<boolean>;
4185
+ readonly tileSize: number;
4186
+ layerPoint(latlng: LatLng): Point;
4187
+ registerPaths(source: Signal<readonly MapPathItem[]>): () => void;
4188
+ panIntoView(el: HTMLElement): void;
4189
+ focus(): void;
4190
+ readonly viewSize: Signal<Point>;
4191
+ registerAttribution(source: Signal<string>): () => void;
4192
+ registerExtent(source: Signal<MapLayerExtent | null>): () => void;
4193
+ registerPanel(source: Signal<MapDataPanel | null>): () => void;
4194
+ showTooltip(tip: MapTooltip): void;
4195
+ hideTooltip(owner: string): void;
4196
+ clientToLayer(clientX: number, clientY: number): Point;
4197
+ revealLayerPoint(p: Point): void;
4198
+ fitBounds(bounds: LatLngBoundsLike, padding?: number): void;
4199
+ setView(center: LatLngLike, zoom?: number): void;
4200
+ readonly zoomRange: Signal<{ readonly minZoom: number; readonly maxZoom: number }>;
4201
+ }
4202
+ ```
4203
+
4204
+ - `HmMapMarkerContext` — O que um `hm-map-popup` usa do marcador que o contém.
4205
+
4206
+ ```ts
4207
+ interface HmMapMarkerContext {
4208
+ focus(): void;
4209
+ }
4210
+ ```
4211
+
4212
+ - `MapPathItem`
4213
+ - `MapPathStyle`
4214
+ - `MapViewChange`
4215
+ - `MapLayerExtent`
4216
+ - `MapTooltip`
4217
+ - `MapDataPanel`
4218
+ - `MapDataTable`
4219
+ - `const ICON_MAP_MARKER: RegisteredIcon`
4220
+ - `const ROUTE_ICONS: readonly RegisteredIcon[]` — Ícones das manobras (lista de direções).
4221
+ - `const STREET_VIEW_ICONS: readonly RegisteredIcon[]` — Ícones da moldura de street view.
4222
+ - `MapRouteComponent` — `hm-map-route` (ver angular-api.md)
4223
+ - `RouteDirectionsComponent` — `hm-route-directions` (ver angular-api.md)
4224
+ - `StreetViewComponent` — `hm-street-view` (ver angular-api.md)
4225
+ - `StreetViewStatus`
4226
+ - `StreetViewMove`
4227
+ - `MapRegionsBase` — classe base
4228
+ - `MapRegionPath`
4229
+ - `MapBasemapComponent` — `hm-map-basemap` (ver angular-api.md)
4230
+ - `MapChoroplethComponent` — `hm-map-choropleth` (ver angular-api.md)
4231
+ - `MapRegionEvent` — Região acionada (clique, Enter ou Espaço).
4232
+
4233
+ ```ts
4234
+ interface MapRegionEvent {
4235
+ readonly region: BasemapRegion;
4236
+ readonly value: number | null;
4237
+ readonly row: Readonly<Record<string, unknown>> | null;
4238
+ }
4239
+ ```
4240
+
4241
+ - `const MAPS_MESSAGES: InjectionToken<MapsMessages>` — Textos dos mapas no idioma ativo da lib (`HermesI18nService.locale`): `setLocale` troca a lib e os mapas juntos. Vista viva, como `HERMES_MESSAGES` (`inject(MAPS_MESSAGES).controls.zoomIn`).
4242
+ - `const MAPS_I18N_CONFIG: InjectionToken<MapsI18nConfig>`
4243
+ - `function provideMapsMessages(config: MapsI18nConfig): Provider` — Sobrescreve textos dos mapas e/ou acrescenta idiomas. O idioma em si vem de `provideHermesI18n`.
4244
+ - `MapsI18nConfig`
4245
+ - `MapsMessagesOverride`
4246
+
4247
+ ## `@trismegisto/angular/member-list`
4248
+
4285
4249
  - `MemberListComponent` — `hm-member-list` (ver angular-api.md)
4286
4250
  - `MemberListMessages`
4287
4251
 
@@ -4342,18 +4306,6 @@ interface MenubarMenu {
4342
4306
 
4343
4307
  ## `@trismegisto/angular/message`
4344
4308
 
4345
- - `MessageAlign` — Lado da mensagem: `start` = recebida (outra pessoa, assistente), `end` = enviada por quem lê.
4346
-
4347
- ```ts
4348
- type MessageAlign = 'start' | 'end';
4349
- ```
4350
-
4351
- - `MessageStatus` — Estado de envio, mostrado no rodapé (normalmente só nas mensagens `end`).
4352
-
4353
- ```ts
4354
- type MessageStatus = 'sending' | 'sent' | 'delivered' | 'read' | 'failed';
4355
- ```
4356
-
4357
4309
  - `MessageContext` — O que um `hm-bubble` dentro de um `hm-message` lê do pai (lado e autor).
4358
4310
 
4359
4311
  ```ts
@@ -4364,15 +4316,6 @@ interface MessageContext {
4364
4316
  ```
4365
4317
 
4366
4318
  - `const HM_MESSAGE: InjectionToken<MessageContext>` — Token pelo qual o `hm-bubble` encontra o `hm-message` em volta, sem importar a classe.
4367
- - `MessageReactionChoice` — Emoji oferecido no seletor de reação: o caractere e, opcional, o nome lido pelo leitor de tela.
4368
-
4369
- ```ts
4370
- interface MessageReactionChoice {
4371
- readonly emoji: string;
4372
- readonly label?: string;
4373
- }
4374
- ```
4375
-
4376
4319
  - `MessageComponent` — `hm-message` (ver angular-api.md)
4377
4320
 
4378
4321
  ## `@trismegisto/angular/message-divider`
@@ -4387,14 +4330,13 @@ type MessageDividerVariant = 'separator' | 'inline' | 'border';
4387
4330
 
4388
4331
  ## `@trismegisto/angular/message-scroller`
4389
4332
 
4390
- - `MessageScrollerLive` — `polite`: o componente anuncia as mensagens que chegam; `off`: o app cuida do anúncio (ou não quer).
4333
+ - `MessageScrollerComponent` — `hm-message-scroller` (ver angular-api.md)
4334
+ - `MessageScrollerLive` _(de `@trismegisto/primitives/message-scroller`)_ — `polite`: o componente anuncia as mensagens que chegam; `off`: o app cuida do anúncio (ou não quer).
4391
4335
 
4392
4336
  ```ts
4393
4337
  type MessageScrollerLive = 'polite' | 'off';
4394
4338
  ```
4395
4339
 
4396
- - `MessageScrollerComponent` — `hm-message-scroller` (ver angular-api.md)
4397
-
4398
4340
  ## `@trismegisto/angular/metric-explorer`
4399
4341
 
4400
4342
  - `MetricExplorerMessages`
@@ -4421,53 +4363,14 @@ interface MetricExplorerMessages {
4421
4363
  p95: string;
4422
4364
  points: string;
4423
4365
  data: string;
4424
- time: string;
4425
- noData: string;
4426
- }
4427
- ```
4428
-
4429
- - `const METRIC_EXPLORER_MESSAGES_PT_BR: MetricExplorerMessages`
4430
- - `const METRIC_EXPLORER_MESSAGES_EN: MetricExplorerMessages`
4431
- - `const METRIC_EXPLORER_MESSAGES_ES: MetricExplorerMessages`
4432
- - `MetricRange` — Atalhos de intervalo de tempo.
4433
-
4434
- ```ts
4435
- type MetricRange = '15m' | '1h' | '24h' | '7d';
4436
- ```
4437
-
4438
- - `const METRIC_RANGES: readonly MetricRange[]`
4439
- - `const METRIC_RANGE_MS: Readonly<Record<MetricRange, number>>` — Duração de cada atalho (ms), para o app montar a consulta.
4440
- - `MetricQuery` — Consulta montada na barra. `groupBy` = id de uma das `groupOptions`, ou `null`.
4441
-
4442
- ```ts
4443
- interface MetricQuery {
4444
- readonly metric: string;
4445
- readonly aggregation: MetricAggregation;
4446
- readonly groupBy: string | null;
4447
- readonly range: MetricRange;
4448
- }
4449
- ```
4450
-
4451
- - `MetricExplorerOption`
4452
-
4453
- ```ts
4454
- interface MetricExplorerOption {
4455
- readonly id: string;
4456
- readonly label: string;
4457
- readonly unit?: string;
4458
- }
4459
- ```
4460
-
4461
- - `MetricSeries` — Uma série devolvida pelo app para a consulta (uma por grupo, ou só uma).
4462
-
4463
- ```ts
4464
- interface MetricSeries {
4465
- readonly id: string;
4466
- readonly label: string;
4467
- readonly points: readonly MetricPoint[];
4366
+ time: string;
4367
+ noData: string;
4468
4368
  }
4469
4369
  ```
4470
4370
 
4371
+ - `const METRIC_EXPLORER_MESSAGES_PT_BR: MetricExplorerMessages`
4372
+ - `const METRIC_EXPLORER_MESSAGES_EN: MetricExplorerMessages`
4373
+ - `const METRIC_EXPLORER_MESSAGES_ES: MetricExplorerMessages`
4471
4374
  - `MetricExplorerComponent` — `hm-metric-explorer` (ver angular-api.md)
4472
4375
 
4473
4376
  ## `@trismegisto/angular/modal`
@@ -4532,13 +4435,13 @@ interface MonitoringCatalogs<T> {
4532
4435
 
4533
4436
  ## `@trismegisto/angular/month-picker`
4534
4437
 
4535
- - `MonthValueFormat` — Formato do valor gravado: `'month'` (`AAAA-MM`, padrão) ou `'first-day'` (`AAAA-MM-01`, para quem guarda data).
4438
+ - `MonthPickerComponent` — `hm-month-picker` (ver angular-api.md)
4439
+ - `MonthValueFormat` _(de `@trismegisto/primitives/month-picker`)_ — Formato do valor gravado: `'month'` (`AAAA-MM`) ou `'first-day'` (`AAAA-MM-01`).
4536
4440
 
4537
4441
  ```ts
4538
4442
  type MonthValueFormat = 'month' | 'first-day';
4539
4443
  ```
4540
4444
 
4541
- - `MonthPickerComponent` — `hm-month-picker` (ver angular-api.md)
4542
4445
  - `MonthPickerMessages`
4543
4446
 
4544
4447
  ```ts
@@ -4565,8 +4468,8 @@ interface MonthPickerMessages {
4565
4468
 
4566
4469
  ```ts
4567
4470
  class HermesMotionService {
4568
- readonly preference
4569
- readonly systemReduced
4471
+ readonly preference = computed(…)
4472
+ readonly systemReduced = computed(…)
4570
4473
  readonly reduced = computed(…)
4571
4474
  setPreference(preference: HermesMotionPreference): void
4572
4475
  }
@@ -4581,7 +4484,6 @@ abstract class HermesNavigationMenu {
4581
4484
  }
4582
4485
  ```
4583
4486
 
4584
- - `const NAVIGATION_MENU_OPEN_DELAY = 200` — Atraso padrão para abrir um painel ao passar o mouse (ms): curto, a barra é o destino do mouse.
4585
4487
  - `NavigationMenuComponent` — `hm-navigation-menu` (ver angular-api.md)
4586
4488
  - `NavigationMenuItemComponent` — `hm-navigation-menu-item` (ver angular-api.md)
4587
4489
  - `NavigationMenuLinkComponent` — `hm-navigation-menu-link` (ver angular-api.md)
@@ -4660,25 +4562,6 @@ interface ObservabilityTextMessages {
4660
4562
 
4661
4563
  ## `@trismegisto/angular/order`
4662
4564
 
4663
- - `OrderDetail` — Um pedido já feito, como o `hm-order-detail` mostra.
4664
-
4665
- ```ts
4666
- interface OrderDetail {
4667
- readonly number: string;
4668
- readonly date: DateInput;
4669
- readonly status: OrderStatus;
4670
- readonly lines: readonly CartLine[];
4671
- readonly discounts?: readonly CartDiscount[];
4672
- readonly shipping?: number | null;
4673
- readonly tax?: number | null;
4674
- readonly currency?: string;
4675
- readonly shippingAddress?: PostalAddress | null;
4676
- readonly billingAddress?: PostalAddress | null;
4677
- readonly payment?: PaymentMethod | null;
4678
- readonly events?: readonly OrderEvent[];
4679
- }
4680
- ```
4681
-
4682
4565
  - `OrderDetailComponent` — `hm-order-detail` (ver angular-api.md)
4683
4566
  - `const ORDER_MESSAGES_PT_BR =`
4684
4567
  - `OrderMessages`
@@ -4691,16 +4574,6 @@ type OrderMessages = typeof ORDER_MESSAGES_PT_BR;
4691
4574
  - `const ORDER_MESSAGES_ES: OrderMessages`
4692
4575
  - `const ORDER_MESSAGES: Readonly<Record<string, OrderMessages>>`
4693
4576
  - `OrderStatusComponent` — `hm-order-status` (ver angular-api.md)
4694
- - `OrderEvent` — Quando o pedido chegou numa situação, e um detalhe opcional ("Pix aprovado", "Correios").
4695
-
4696
- ```ts
4697
- interface OrderEvent {
4698
- readonly status: OrderStatus;
4699
- readonly date: TimelineDateValue;
4700
- readonly description?: string;
4701
- }
4702
- ```
4703
-
4704
4577
  - `OrderTimelineComponent` — `hm-order-timeline` (ver angular-api.md)
4705
4578
 
4706
4579
  ## `@trismegisto/angular/org-chart`
@@ -4733,15 +4606,33 @@ interface OrgChartMessages {
4733
4606
  - `const ORG_CHART_MESSAGES_ES: OrgChartMessages`
4734
4607
  - `const ORG_CHART_MESSAGES: Readonly<Record<string, OrgChartMessages>>` — Catálogos por idioma, para `HermesI18nService.pick`.
4735
4608
 
4736
- ## `@trismegisto/angular/page-header`
4609
+ ## `@trismegisto/angular/overlay-stage`
4737
4610
 
4738
- - `PageHeaderLevel`
4611
+ - `HermesOverlayScope` — Onde um `hm-drawer` ou `hm-modal` aparece: `viewport` cobre a página inteira (o padrão de sempre); `content` fica preso ao palco fornecido por quem monta a tela (`HM_OVERLAY_STAGE`), sem cobrir cabeçalho nem menu. Sem p…
4739
4612
 
4740
4613
  ```ts
4741
- type PageHeaderLevel = 1 | 2 | 3 | 4 | 5 | 6;
4614
+ type HermesOverlayScope = 'viewport' | 'content';
4742
4615
  ```
4743
4616
 
4617
+ - `HermesOverlayStage` — A área (palco) em que os overlays `content` de uma tela aparecem: a área de conteúdo dela.
4618
+
4619
+ ```ts
4620
+ interface HermesOverlayStage {
4621
+ element(): HTMLElement | null;
4622
+ }
4623
+ ```
4624
+
4625
+ - `const HM_OVERLAY_STAGE: InjectionToken<HermesOverlayStage>` — Palco dos overlays da tela, fornecido pelo layout (ex.: o Spine, um por aba).
4626
+ - `const HM_OVERLAY_SCOPE: InjectionToken<HermesOverlayScope>` — Escopo padrão dos overlays abaixo deste injetor, quando o componente não define `scope`.
4627
+
4628
+ ## `@trismegisto/angular/page-header`
4629
+
4744
4630
  - `PageHeaderComponent` — `hm-page-header` (ver angular-api.md)
4631
+ - `PageHeaderLevel` _(de `@trismegisto/primitives/page-header`)_ — Nível do título (`<h1>`…`<h6>`).
4632
+
4633
+ ```ts
4634
+ type PageHeaderLevel = 1 | 2 | 3 | 4 | 5 | 6;
4635
+ ```
4745
4636
 
4746
4637
  ## `@trismegisto/angular/paginator`
4747
4638
 
@@ -4848,19 +4739,6 @@ type PaymentFormMessages = typeof PAYMENT_FORM_MESSAGES_PT_BR;
4848
4739
  type CardTokenizer = (card: CardInput) => Promise<string>;
4849
4740
  ```
4850
4741
 
4851
- - `PaymentSubmission` — O que o `hm-payment-form` emite ao confirmar. Nunca contém número completo nem CVC.
4852
-
4853
- ```ts
4854
- interface PaymentSubmission {
4855
- readonly kind: PaymentMethodKind;
4856
- readonly methodId: string | null;
4857
- readonly card: CardSummary | null;
4858
- readonly token: string | null;
4859
- readonly installments: number;
4860
- readonly billingAddress: PostalAddress | null;
4861
- }
4862
- ```
4863
-
4864
4742
  - `PaymentFormComponent` — `hm-payment-form` (ver angular-api.md)
4865
4743
 
4866
4744
  ## `@trismegisto/angular/payment-method`
@@ -4881,13 +4759,13 @@ type PaymentMethodMessages = typeof PAYMENT_METHOD_MESSAGES_PT_BR;
4881
4759
 
4882
4760
  ## `@trismegisto/angular/pdf-viewer`
4883
4761
 
4884
- - `PdfViewerEmbed`
4762
+ - `PdfViewerComponent` — `hm-pdf-viewer` (ver angular-api.md)
4763
+ - `PdfViewerEmbed` _(de `@trismegisto/primitives/pdf-view`)_ — Como o visualizador decide entre o quadro e o cartão de alternativa.
4885
4764
 
4886
4765
  ```ts
4887
4766
  type PdfViewerEmbed = 'auto' | 'always' | 'never';
4888
4767
  ```
4889
4768
 
4890
- - `PdfViewerComponent` — `hm-pdf-viewer` (ver angular-api.md)
4891
4769
  - `PdfViewerMessages` — Visualizador de PDF (`hm-pdf-viewer`). `labelNamed` = nome com o arquivo (`{name}`); `unsupported`/ `unsupportedHint` = alternativa quando o navegador não mostra PDF embutido; `fileName` = nome padrão do arquivo baixado.
4892
4770
 
4893
4771
  ```ts
@@ -4905,6 +4783,7 @@ interface PdfViewerMessages {
4905
4783
  - `const PDF_VIEWER_MESSAGES_PT_BR: PdfViewerMessages`
4906
4784
  - `const PDF_VIEWER_MESSAGES_EN: PdfViewerMessages`
4907
4785
  - `const PDF_VIEWER_MESSAGES_ES: PdfViewerMessages`
4786
+ - `const PDF_VIEWER_MESSAGES: Readonly<Record<string, PdfViewerMessages>>` — Catálogos por idioma, no formato do `pick` do store de i18n.
4908
4787
 
4909
4788
  ## `@trismegisto/angular/permission-matrix`
4910
4789
 
@@ -4929,31 +4808,31 @@ interface PermissionMatrixMessages {
4929
4808
 
4930
4809
  ## `@trismegisto/angular/pipes`
4931
4810
 
4932
- - `HermesDatePreset` — Presets: os estilos do próprio `Intl` (`dateStyle`/`timeStyle`) — curto, médio, longo e completo.
4811
+ - `function formatHermesDate( value: HermesDateInput, locale: string, kind: HermesDateKind = 'date', preset?: HermesDatePreset, options?: Intl.DateTimeFormatOptions, ): string` _(de `@trismegisto/primitives/date-format`)_ — Data (ou data-hora) no idioma `locale`. Valor vazio ou inválido → `''`.
4812
+ - `function formatHermesDateArgs( value: HermesDateInput, locale: string, kind: HermesDateKind, presetOrOptions?: HermesDatePreset | Intl.DateTimeFormatOptions, options?: Intl.DateTimeFormatOptions, ): string` _(de `@trismegisto/primitives/date-format`)_ — O mesmo texto dos pipes `hmDate`/`hmDateTime`, com os argumentos na forma deles: o segundo é o preset (`'long'`) ou já as opções; o terceiro são opções que entram por cima.
4813
+ - `function hermesDateOptions(kind: HermesDateKind, preset: HermesDatePreset = 'short', options: Intl.DateTimeFormatOptions = {}): Intl.DateTimeFormatOptions` _(de `@trismegisto/primitives/date-format`)_ — Opções finais do `Intl.DateTimeFormat`: o preset vira `dateStyle` (e `timeStyle`, em data-hora); as `options` entram por cima. Se `options` trouxer campos avulsos (`year`, `month`, `hour`…) ou os próprios `dateStyle`/`t…
4814
+ - `function toHermesDate(value: HermesDateInput): Date | null` _(de `@trismegisto/primitives/date-format`)_ — `HermesDateInput` → `Date` válida, ou `null`.
4815
+ - `HermesDateInput` _(de `@trismegisto/primitives/date-format`)_ — O que os pipes aceitam: `Date`, milissegundos ou texto ISO. `'AAAA-MM-DD'` é data local (dia certo em qualquer fuso, o mesmo formato do valor do `hm-date-picker`). Vazio ou inválido vira `''`.
4933
4816
 
4934
4817
  ```ts
4935
- type HermesDatePreset = 'short' | 'medium' | 'long' | 'full';
4818
+ type HermesDateInput = Date | number | string | null | undefined;
4936
4819
  ```
4937
4820
 
4938
- - `HermesDateInput` — O que os pipes aceitam: `Date`, milissegundos ou texto ISO. `'AAAA-MM-DD'` é data local (dia certo em qualquer fuso, o mesmo formato do valor do `hm-date-picker`). Vazio ou inválido vira `''`.
4821
+ - `HermesDateKind` _(de `@trismegisto/primitives/date-format`)_
4939
4822
 
4940
4823
  ```ts
4941
- type HermesDateInput = Date | number | string | null | undefined;
4824
+ type HermesDateKind = 'date' | 'dateTime';
4942
4825
  ```
4943
4826
 
4944
- - `HermesDateKind`
4827
+ - `HermesDatePreset` _(de `@trismegisto/primitives/date-format`)_ — Presets: os estilos do próprio `Intl` (`dateStyle`/`timeStyle`) — curto, médio, longo e completo.
4945
4828
 
4946
4829
  ```ts
4947
- type HermesDateKind = 'date' | 'dateTime';
4830
+ type HermesDatePreset = 'short' | 'medium' | 'long' | 'full';
4948
4831
  ```
4949
4832
 
4950
- - `function toHermesDate(value: HermesDateInput): Date | null` — `HermesDateInput` → `Date` válida, ou `null`.
4951
- - `function hermesDateOptions(kind: HermesDateKind, preset: HermesDatePreset = 'short', options: Intl.DateTimeFormatOptions = {}): Intl.DateTimeFormatOptions` — Opções finais do `Intl.DateTimeFormat`: o preset vira `dateStyle` (e `timeStyle`, em data-hora); as `options` entram por cima. Se `options` trouxer campos avulsos (`year`, `month`, `hour`…) ou os próprios `dateStyle`/`t…
4952
- - `function formatHermesDate( value: HermesDateInput, locale: string, kind: HermesDateKind = 'date', preset?: HermesDatePreset, options?: Intl.DateTimeFormatOptions, ): string` — Data (ou data-hora) no idioma `locale`. Valor vazio ou inválido → `''`.
4953
4833
  - `HermesDatePipe` — `| hmDate` (ver angular-api.md)
4954
4834
  - `HermesDateTimePipe` — `| hmDateTime` (ver angular-api.md)
4955
4835
  - `HermesTranslatePipe` — `| hmTranslate` (ver angular-api.md)
4956
- - `function translateMessage(catalog: object, key: string | null | undefined, params?: MessageParams): string` — Resolve `chave` num catálogo de seções (`HermesMessages` ou um estendido pelo app), com parâmetros e plural. Usada pelo `hmTranslate`; exportada para quem precisa do mesmo resultado em TS — dentro de um `computed`, lend…
4957
4836
  - `HermesNumberPipe` — `| hmNumber` (ver angular-api.md)
4958
4837
  - `HermesCurrencyPipe` — `| hmCurrency` (ver angular-api.md)
4959
4838
  - `HermesPercentPipe` — `| hmPercent` (ver angular-api.md)
@@ -4963,13 +4842,13 @@ type HermesDateKind = 'date' | 'dateTime';
4963
4842
 
4964
4843
  ## `@trismegisto/angular/popconfirm`
4965
4844
 
4966
- - `PopconfirmIntent` — Peso da confirmação: `default` (ação comum) ou `danger` (destrutiva: o botão de confirmar fica vermelho).
4845
+ - `PopconfirmComponent` — `hm-popconfirm` (ver angular-api.md)
4846
+ - `PopconfirmIntent` _(de `@trismegisto/primitives/popconfirm`)_ — Intenção visual: `danger` para ação destrutiva.
4967
4847
 
4968
4848
  ```ts
4969
4849
  type PopconfirmIntent = 'default' | 'danger';
4970
4850
  ```
4971
4851
 
4972
- - `PopconfirmComponent` — `hm-popconfirm` (ver angular-api.md)
4973
4852
  - `PopconfirmTriggerDirective` — `[hmPopconfirmTrigger]` (ver angular-api.md)
4974
4853
  - `PopconfirmMessages` — hm-popconfirm: rótulos padrão dos botões de confirmar e cancelar.
4975
4854
 
@@ -5008,13 +4887,13 @@ type PriceMessages = typeof PRICE_MESSAGES_PT_BR;
5008
4887
  type PriceSize = 'small' | 'medium' | 'large';
5009
4888
  ```
5010
4889
 
5011
- - `PricePeriod` — Recorrência impressa depois do valor ("/mês").
4890
+ - `PriceComponent` — `hm-price` (ver angular-api.md)
4891
+ - `PricePeriod` _(de `@trismegisto/primitives/price`)_ — Recorrência impressa depois do valor ("/mês").
5012
4892
 
5013
4893
  ```ts
5014
4894
  type PricePeriod = '' | 'month' | 'year';
5015
4895
  ```
5016
4896
 
5017
- - `PriceComponent` — `hm-price` (ver angular-api.md)
5018
4897
  - `StockStatusComponent` — `hm-stock-status` (ver angular-api.md)
5019
4898
 
5020
4899
  ## `@trismegisto/angular/product`
@@ -5058,52 +4937,10 @@ type ProductMessages = typeof PRODUCT_MESSAGES_PT_BR;
5058
4937
 
5059
4938
  ## `@trismegisto/angular/progress`
5060
4939
 
5061
- - `ProgressIntent`
5062
-
5063
- ```ts
5064
- type ProgressIntent = 'accent' | 'success' | 'warning' | 'danger';
5065
- ```
5066
-
5067
- - `ProgressSize`
5068
-
5069
- ```ts
5070
- type ProgressSize = 'small' | 'medium' | 'large';
5071
- ```
5072
-
5073
- - `ProgressShape` — Forma do indicador: `bar` (padrão, a barra horizontal) ou `circle` (anel).
5074
-
5075
- ```ts
5076
- type ProgressShape = 'bar' | 'circle';
5077
- ```
5078
-
5079
4940
  - `ProgressComponent` — `hm-progress` (ver angular-api.md)
5080
4941
 
5081
4942
  ## `@trismegisto/angular/prompt-input`
5082
4943
 
5083
- - `PromptInputAttachment` — Um arquivo que vai com a mensagem. Quem envia e acompanha o envio é o app.
5084
-
5085
- ```ts
5086
- interface PromptInputAttachment {
5087
- readonly id: string;
5088
- readonly name: string;
5089
- readonly size?: number;
5090
- readonly type?: string;
5091
- readonly thumbnail?: string;
5092
- readonly status?: AttachmentStatus;
5093
- readonly progress?: number;
5094
- readonly error?: string;
5095
- }
5096
- ```
5097
-
5098
- - `PromptInputSubmit` — O que a pessoa mandou: o texto e os anexos à vista naquele momento.
5099
-
5100
- ```ts
5101
- interface PromptInputSubmit {
5102
- readonly text: string;
5103
- readonly attachments: readonly PromptInputAttachment[];
5104
- }
5105
- ```
5106
-
5107
4944
  - `PromptInputComponent` — `hm-prompt-input` (ver angular-api.md)
5108
4945
  - `PromptInputMessages`
5109
4946
 
@@ -5209,7 +5046,8 @@ type PropertyValues = Readonly<Record<string, unknown>>;
5209
5046
 
5210
5047
  ## `@trismegisto/angular/questionnaire`
5211
5048
 
5212
- - `QuestionnaireValidator` — Validação do app, além de "responder antes de seguir": devolve o erro (texto pronto) ou `null`.
5049
+ - `QuestionnaireComponent` — `hm-questionnaire` (ver angular-api.md)
5050
+ - `QuestionnaireValidator` _(de `@trismegisto/primitives/questionnaire`)_ — Validação do app, além de "responder antes de seguir": devolve o erro (texto pronto) ou `null`.
5213
5051
 
5214
5052
  ```ts
5215
5053
  type QuestionnaireValidator = (
@@ -5219,7 +5057,6 @@ type QuestionnaireValidator = (
5219
5057
  ) => string | null;
5220
5058
  ```
5221
5059
 
5222
- - `QuestionnaireComponent` — `hm-questionnaire` (ver angular-api.md)
5223
5060
  - `QuestionnaireMessages`
5224
5061
 
5225
5062
  ```ts
@@ -5336,21 +5173,6 @@ type RecurrenceMessages = CalendarFilesMessages['recurrence'];
5336
5173
 
5337
5174
  ## `@trismegisto/angular/release-timeline`
5338
5175
 
5339
- - `ReleaseItem` — Um deploy/release do histórico.
5340
-
5341
- ```ts
5342
- interface ReleaseItem {
5343
- readonly id: string;
5344
- readonly version: string;
5345
- readonly environment?: string;
5346
- readonly status: DeployStatus;
5347
- readonly author?: string;
5348
- readonly at: number;
5349
- readonly notes?: string;
5350
- readonly rollbackable?: boolean;
5351
- }
5352
- ```
5353
-
5354
5176
  - `ReleaseTimelineComponent` — `hm-release-timeline` (ver angular-api.md)
5355
5177
  - `ReleaseTimelineMessages` — Textos do `hm-release-timeline`. pt-BR embutido; en/es ao lado. O app sobrescreve frases pelo input `texts` do componente.
5356
5178
 
@@ -5471,16 +5293,6 @@ type ReportHistoryMessages = CalendarFilesMessages['reportHistory'];
5471
5293
 
5472
5294
  ## `@trismegisto/angular/report-schedule`
5473
5295
 
5474
- - `ReportFormatOption` — Um formato oferecido. Sem `formats`, PDF, CSV e planilha.
5475
-
5476
- ```ts
5477
- interface ReportFormatOption {
5478
- readonly value: string;
5479
- readonly label: string;
5480
- }
5481
- ```
5482
-
5483
- - `function defaultReportSchedule(startDate = todayIso()): ReportSchedule` — Agendamento inicial quando o app ainda não tem um: toda segunda às 08:00, em PDF, sem destinatários.
5484
5296
  - `ReportScheduleComponent` — `hm-report-schedule` (ver angular-api.md)
5485
5297
  - `ReportSchedule` _(de `@trismegisto/primitives/reports`)_ — Agendamento de um relatório. `startDate` é a primeira data da série; `time`, o horário de parede do envio.
5486
5298
 
@@ -5571,33 +5383,6 @@ type ResourceCalendarMessages = CalendarFilesMessages['resourceCalendar'];
5571
5383
 
5572
5384
  ## `@trismegisto/angular/resource-usage`
5573
5385
 
5574
- - `ResourceKind`
5575
-
5576
- ```ts
5577
- type ResourceKind = 'cpu' | 'memory' | 'network' | 'disk' | 'other';
5578
- ```
5579
-
5580
- - `ResourceUsageItem` — Um recurso medido.
5581
-
5582
- ```ts
5583
- interface ResourceUsageItem {
5584
- readonly id: string;
5585
- readonly label?: string;
5586
- readonly value: number;
5587
- readonly max?: number;
5588
- readonly unit?: string;
5589
- readonly display?: string;
5590
- readonly thresholds?: MetricThresholds;
5591
- readonly kind?: ResourceKind;
5592
- }
5593
- ```
5594
-
5595
- - `ResourceUsageLayout`
5596
-
5597
- ```ts
5598
- type ResourceUsageLayout = 'list' | 'grid';
5599
- ```
5600
-
5601
5386
  - `ResourceUsageComponent` — `hm-resource-usage` (ver angular-api.md)
5602
5387
  - `ResourceUsageMessages` — Textos do `hm-resource-usage`. pt-BR embutido; en/es ao lado. O app sobrescreve frases pelo input `texts` do componente.
5603
5388
 
@@ -5637,7 +5422,8 @@ type ReturnRequestMessages = typeof RETURN_REQUEST_MESSAGES_PT_BR;
5637
5422
  - `const RETURN_REQUEST_MESSAGES_EN: ReturnRequestMessages`
5638
5423
  - `const RETURN_REQUEST_MESSAGES_ES: ReturnRequestMessages`
5639
5424
  - `const RETURN_REQUEST_MESSAGES: Readonly<Record<string, ReturnRequestMessages>>`
5640
- - `ReturnRequest` — O pedido de devolução que o `hm-return-request` emite.
5425
+ - `ReturnRequestComponent` — `hm-return-request` (ver angular-api.md)
5426
+ - `ReturnRequest` _(de `@trismegisto/primitives/return-request`)_ — O pedido de devolução que o `hm-return-request` emite.
5641
5427
 
5642
5428
  ```ts
5643
5429
  interface ReturnRequest {
@@ -5648,8 +5434,6 @@ interface ReturnRequest {
5648
5434
  }
5649
5435
  ```
5650
5436
 
5651
- - `ReturnRequestComponent` — `hm-return-request` (ver angular-api.md)
5652
-
5653
5437
  ## `@trismegisto/angular/rich-text`
5654
5438
 
5655
5439
  - `RichTextComponent` — `hm-rich-text` (ver angular-api.md)
@@ -5657,15 +5441,6 @@ interface ReturnRequest {
5657
5441
 
5658
5442
  ## `@trismegisto/angular/risk-register`
5659
5443
 
5660
- - `RiskCellSelection` — Célula escolhida na matriz: probabilidade e impacto (degraus a partir de 1).
5661
-
5662
- ```ts
5663
- interface RiskCellSelection {
5664
- readonly likelihood: number;
5665
- readonly impact: number;
5666
- }
5667
- ```
5668
-
5669
5444
  - `RiskMatrixComponent` — `hm-risk-matrix` (ver angular-api.md)
5670
5445
  - `RiskRegisterComponent` — `hm-risk-register` (ver angular-api.md)
5671
5446
 
@@ -5759,7 +5534,8 @@ interface ServiceMapMessages {
5759
5534
 
5760
5535
  ## `@trismegisto/angular/service-status`
5761
5536
 
5762
- - `ServiceStatusItem` — Um serviço da lista.
5537
+ - `ServiceStatusListComponent` — `hm-service-status-list` (ver angular-api.md)
5538
+ - `ServiceStatusItem` _(de `@trismegisto/primitives/service-status`)_ — Um serviço da lista.
5763
5539
 
5764
5540
  ```ts
5765
5541
  interface ServiceStatusItem {
@@ -5773,7 +5549,6 @@ interface ServiceStatusItem {
5773
5549
  }
5774
5550
  ```
5775
5551
 
5776
- - `ServiceStatusListComponent` — `hm-service-status-list` (ver angular-api.md)
5777
5552
  - `ServiceStatusMessages` — Textos do `hm-service-status-list`. pt-BR embutido; en/es ao lado. O app sobrescreve frases pelo input `texts` do componente.
5778
5553
 
5779
5554
  ```ts
@@ -5792,7 +5567,6 @@ interface ServiceStatusMessages {
5792
5567
  ## `@trismegisto/angular/session-recovery`
5793
5568
 
5794
5569
  - `SessionRecoveryComponent` — `hm-session-recovery` (ver angular-api.md)
5795
- - `function safeReturnUrl(origin: string | null | undefined, document: Document, allowed?: readonly string[] | null): string | null` — `origin` resolvido contra a página e validado: só `http:`/`https:` e só a mesma origem da página ou uma das listadas em `allowed` (sem lista, só a mesma origem). Devolve o `href` normalizado ou `null`.
5796
5570
 
5797
5571
  ## `@trismegisto/angular/settings`
5798
5572
 
@@ -5828,8 +5602,8 @@ interface SettingsSectionContext {
5828
5602
 
5829
5603
  - `const SETTINGS_DIALOG: InjectionToken<SettingsDialogContext>`
5830
5604
  - `const SETTINGS_SECTION: InjectionToken<SettingsSectionContext>`
5831
- - `function normalizeSettingsText(text: string): string` — Minúsculo e sem acento: "Aparência" casa com "aparencia".
5832
- - `function settingsTextMatches(query: string, ...texts: string[]): boolean` — Todas as palavras da busca aparecem no texto (em qualquer ordem).
5605
+ - `function normalizeSettingsText(text: string): string` _(de `@trismegisto/primitives/settings`)_ — Texto comparável na busca: sem acentos, minúsculo e aparado.
5606
+ - `function settingsTextMatches(query: string, ...texts: string[]): boolean` _(de `@trismegisto/primitives/settings`)_ — A busca `query` (já normalizada) casa com os textos? Cada palavra da busca precisa aparecer em algum deles, em qualquer ordem. Busca vazia casa com tudo.
5833
5607
 
5834
5608
  ## `@trismegisto/angular/shipping`
5835
5609
 
@@ -5849,13 +5623,13 @@ type ShippingMessages = typeof SHIPPING_MESSAGES_PT_BR;
5849
5623
  ## `@trismegisto/angular/shortcut-list`
5850
5624
 
5851
5625
  - `ShortcutListComponent` — `hm-shortcut-list` (ver angular-api.md)
5852
- - `ShortcutAction` — O que o atalho faz com o elemento: `auto` foca campo editável e clica no resto.
5626
+ - `ShortcutDirective` — `[hmShortcut]` (ver angular-api.md)
5627
+ - `ShortcutAction` _(de `@trismegisto/primitives/shortcuts`)_ — O que a diretiva faz com o alvo: `auto` foca campo editável e clica no resto.
5853
5628
 
5854
5629
  ```ts
5855
5630
  type ShortcutAction = 'auto' | 'click' | 'focus' | 'none';
5856
5631
  ```
5857
5632
 
5858
- - `ShortcutDirective` — `[hmShortcut]` (ver angular-api.md)
5859
5633
  - `HermesShortcutConfig`
5860
5634
 
5861
5635
  ```ts
@@ -5869,24 +5643,16 @@ interface HermesShortcutConfig {
5869
5643
 
5870
5644
  - `const HERMES_SHORTCUT_CONFIG: InjectionToken<HermesShortcutConfig>`
5871
5645
  - `function provideHermesShortcuts(config: HermesShortcutConfig): Provider` — Configura o `HermesShortcutService` (plataforma, tempo de sequência, tecla única ligada ou não).
5872
- - `HermesShortcut` — Um atalho registrado no serviço.
5646
+ - `HermesShortcut` — Um atalho registrado no serviço (`ManagedShortcut` de `@trismegisto/primitives/shortcuts`, o mesmo do React).
5873
5647
 
5874
5648
  ```ts
5875
- interface HermesShortcut extends ShortcutDefinition {
5876
- readonly description: string;
5877
- readonly handler: (event: KeyboardEvent) => void | boolean;
5878
- readonly preventDefault?: boolean;
5879
- }
5649
+ type HermesShortcut = ManagedShortcut;
5880
5650
  ```
5881
5651
 
5882
5652
  - `HermesShortcutItem` — Um atalho como o painel lista (registrado ou só declarado).
5883
5653
 
5884
5654
  ```ts
5885
- interface HermesShortcutItem {
5886
- readonly keys: string | readonly string[];
5887
- readonly description: string;
5888
- readonly group?: string;
5889
- }
5655
+ type HermesShortcutItem = ShortcutListItem;
5890
5656
  ```
5891
5657
 
5892
5658
  - **`HermesShortcutService`** (classe)
@@ -5895,7 +5661,7 @@ interface HermesShortcutItem {
5895
5661
  class HermesShortcutService {
5896
5662
  readonly platform: ShortcutPlatform
5897
5663
  readonly groupOrder: readonly string[]
5898
- readonly characterKeys = characterKeysState.asReadonly(…)
5664
+ readonly characterKeys = computed(…)
5899
5665
  readonly list = computed(…)
5900
5666
  register(shortcut: HermesShortcut): () => void
5901
5667
  setCharacterKeys(enabled: boolean): void
@@ -5981,7 +5747,14 @@ interface SkipLinkMessages {
5981
5747
 
5982
5748
  ## `@trismegisto/angular/sla-summary`
5983
5749
 
5984
- - `SlaLatency` — Um percentil de latência contra o objetivo. `value`/`objective` em ms.
5750
+ - `SlaSummaryHeadingLevel`
5751
+
5752
+ ```ts
5753
+ type SlaSummaryHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
5754
+ ```
5755
+
5756
+ - `SlaSummaryComponent` — `hm-sla-summary` (ver angular-api.md)
5757
+ - `SlaLatency` _(de `@trismegisto/primitives/sla-summary`)_ — Um percentil de latência contra o objetivo. `value`/`objective` em ms.
5985
5758
 
5986
5759
  ```ts
5987
5760
  interface SlaLatency {
@@ -5991,13 +5764,6 @@ interface SlaLatency {
5991
5764
  }
5992
5765
  ```
5993
5766
 
5994
- - `SlaSummaryHeadingLevel`
5995
-
5996
- ```ts
5997
- type SlaSummaryHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
5998
- ```
5999
-
6000
- - `SlaSummaryComponent` — `hm-sla-summary` (ver angular-api.md)
6001
5767
  - `SlaSummaryMessages` — Textos do `hm-sla-summary`. pt-BR embutido; en/es ao lado. O app sobrescreve frases pelo input `texts` do componente.
6002
5768
 
6003
5769
  ```ts
@@ -6197,31 +5963,16 @@ interface StatGroupMetric {
6197
5963
 
6198
5964
  ## `@trismegisto/angular/state-page`
6199
5965
 
6200
- - `StatePageKind` — As páginas prontas. Cada uma é um `hm-state-screen` com texto, ilustração e ação definidos.
6201
-
6202
- ```ts
6203
- type StatePageKind =
6204
- | 'not-found'
6205
- | 'no-content'
6206
- | 'no-rights'
6207
- | 'no-results'
6208
- | 'session-expired'
6209
- | 'logged-out'
6210
- | 'error'
6211
- | 'blocked'
6212
- | 'outdated';
6213
- ```
6214
-
6215
- - `StatePageVisual` — O que não é texto em cada página: a situação (que escolhe a ilustração) e o ícone da ação.
5966
+ - `StatePageComponent` — `hm-state-page` (ver angular-api.md)
5967
+ - `const STATE_PAGE_VISUALS: Readonly<Record<StatePageKind, StatePageVisual>>` _(de `@trismegisto/primitives/state-page`)_ — Situação e ícone de cada página. Os textos moram no catálogo, na seção `statePage`.
5968
+ - `function statePagePreset(kind: StatePageKind, messages: Pick<HermesMessages, 'statePage'>): StatePagePreset` _(de `@trismegisto/primitives/state-page`)_ — A página `kind` no idioma de `messages`: visual de `STATE_PAGE_VISUALS` + textos de `messages.statePage[kind]`.
5969
+ - `StatePageKind` _(de `@trismegisto/primitives/state-page`)_ — As páginas prontas. Cada uma é um `hm-state-screen` com texto, ilustração e ação definidos.
6216
5970
 
6217
5971
  ```ts
6218
- interface StatePageVisual {
6219
- readonly situation: StateScreenSituation;
6220
- readonly actionIcon: string;
6221
- }
5972
+ type StatePageKind = keyof HermesMessages['statePage'];
6222
5973
  ```
6223
5974
 
6224
- - `StatePagePreset` — Página resolvida: o visual mais os textos do catálogo (`HERMES_MESSAGES.statePage[kind]`).
5975
+ - `StatePagePreset` _(de `@trismegisto/primitives/state-page`)_ — Página resolvida: o visual mais os textos do catálogo (`HermesMessages.statePage[kind]`).
6225
5976
 
6226
5977
  ```ts
6227
5978
  interface StatePagePreset extends StatePageVisual {
@@ -6231,9 +5982,14 @@ interface StatePagePreset extends StatePageVisual {
6231
5982
  }
6232
5983
  ```
6233
5984
 
6234
- - `const STATE_PAGE_VISUALS: Readonly<Record<StatePageKind, StatePageVisual>>` — Situação e ícone de cada página. Os textos moram no catálogo, na seção `statePage`.
6235
- - `function statePagePreset(kind: StatePageKind, messages: Pick<HermesMessages, 'statePage'>): StatePagePreset` — A página `kind` no idioma de `messages`: visual de `STATE_PAGE_VISUALS` + textos de `messages.statePage[kind]`. Passe o `HERMES_MESSAGES` injetado e leia dentro de um `computed` para acompanhar a troca de idioma: privat…
6236
- - `StatePageComponent` — `hm-state-page` (ver angular-api.md)
5985
+ - `StatePageVisual` _(de `@trismegisto/primitives/state-page`)_ — O que não é texto em cada página: a situação (que escolhe a ilustração) e o ícone da ação.
5986
+
5987
+ ```ts
5988
+ interface StatePageVisual {
5989
+ readonly situation: StatePageSituation;
5990
+ readonly actionIcon: string;
5991
+ }
5992
+ ```
6237
5993
 
6238
5994
  ## `@trismegisto/angular/state-screen`
6239
5995
 
@@ -6257,33 +6013,21 @@ type StateScreenSituation =
6257
6013
 
6258
6014
  ## `@trismegisto/angular/status-badge`
6259
6015
 
6260
- - `StatusBadgeSize`
6016
+ - `StatusBadgeComponent` — `hm-status-badge` (ver angular-api.md)
6017
+ - `StatusBadgeAppearance` _(de `@trismegisto/primitives/status-badge`)_ — `soft`: pílula com fundo; `dot`: só a marca e o texto (tabelas e listas densas).
6261
6018
 
6262
6019
  ```ts
6263
- type StatusBadgeSize = 'small' | 'medium';
6020
+ type StatusBadgeAppearance = 'soft' | 'dot';
6264
6021
  ```
6265
6022
 
6266
- - `StatusBadgeAppearance` — `soft`: pílula com fundo; `dot`: só a marca e o texto (tabelas e listas densas).
6023
+ - `StatusBadgeSize` _(de `@trismegisto/primitives/status-badge`)_ — Selo de status de um fluxo (`hm-status-badge`), sem framework: qual status mostrar (objeto ou id procurado na lista) e as classes do selo (tom, forma da marca pela categoria, aparência e tamanho).
6267
6024
 
6268
6025
  ```ts
6269
- type StatusBadgeAppearance = 'soft' | 'dot';
6026
+ type StatusBadgeSize = 'small' | 'medium';
6270
6027
  ```
6271
6028
 
6272
- - `StatusBadgeComponent` — `hm-status-badge` (ver angular-api.md)
6273
-
6274
6029
  ## `@trismegisto/angular/status-select`
6275
6030
 
6276
- - `StatusTransitionEvent` — Uma mudança de status pedida (`hm-status-select` → `transition`).
6277
-
6278
- ```ts
6279
- interface StatusTransitionEvent {
6280
- readonly from: string | null;
6281
- readonly to: string;
6282
- readonly transition: WorkflowTransition;
6283
- readonly reason: string;
6284
- }
6285
- ```
6286
-
6287
6031
  - `StatusSelectComponent` — `hm-status-select` (ver angular-api.md)
6288
6032
 
6289
6033
  ## `@trismegisto/angular/stepper`
@@ -6360,7 +6104,7 @@ type StorageUsageMessages = CalendarFilesMessages['storageUsage'];
6360
6104
  - `const STORAGE_USAGE_MESSAGES_PT_BR: StorageUsageMessages`
6361
6105
  - `const STORAGE_USAGE_MESSAGES_EN: StorageUsageMessages`
6362
6106
  - `const STORAGE_USAGE_MESSAGES_ES: StorageUsageMessages`
6363
- - `const STORAGE_USAGE_MESSAGES: Readonly<Record<string, StorageUsageMessages>>` — Catálogos por idioma, no formato do `HermesI18nService.pick`.
6107
+ - `const STORAGE_USAGE_MESSAGES: Readonly<Record<string, StorageUsageMessages>>` — Catálogos por idioma, no formato do `pick` do store de i18n.
6364
6108
 
6365
6109
  ## `@trismegisto/angular/swimlane-board`
6366
6110
 
@@ -6449,17 +6193,7 @@ interface SyncStatusMessages {
6449
6193
 
6450
6194
  ## `@trismegisto/angular/tab-bar`
6451
6195
 
6452
- - `TabDragData` — Dados de uma aba em arrasto (o que uma zona de soltura enxerga em `item.data()`).
6453
-
6454
- ```ts
6455
- interface TabDragData {
6456
- readonly id: string;
6457
- readonly label: string;
6458
- readonly group: unknown;
6459
- }
6460
- ```
6461
-
6462
- - `TabReceivedEvent` — Aba de outra fileira do mesmo grupo solta nesta.
6196
+ - `TabReceivedEvent`
6463
6197
 
6464
6198
  ```ts
6465
6199
  interface TabReceivedEvent {
@@ -6483,6 +6217,16 @@ interface TabItem {
6483
6217
  }
6484
6218
  ```
6485
6219
 
6220
+ - `TabDragData` _(de `@trismegisto/primitives/tab-bar`)_ — O que uma aba arrastada leva consigo.
6221
+
6222
+ ```ts
6223
+ interface TabDragData {
6224
+ readonly id: string;
6225
+ readonly label: string;
6226
+ readonly group: unknown;
6227
+ }
6228
+ ```
6229
+
6486
6230
  ## `@trismegisto/angular/tabs`
6487
6231
 
6488
6232
  - `TabComponent` — `hm-tab` (ver angular-api.md)
@@ -6550,48 +6294,24 @@ interface TagInputMessages {
6550
6294
  ## `@trismegisto/angular/task-card`
6551
6295
 
6552
6296
  - `TaskCardComponent` — `hm-task-card` (ver angular-api.md)
6553
- - `TaskDoneChange` — Uma tarefa foi marcada ou desmarcada (`hm-task-list` → `doneChange`).
6554
-
6555
- ```ts
6556
- interface TaskDoneChange {
6557
- readonly task: TaskItem;
6558
- readonly done: boolean;
6559
- }
6560
- ```
6561
-
6562
6297
  - `TaskListComponent` — `hm-task-list` (ver angular-api.md)
6563
6298
 
6564
6299
  ## `@trismegisto/angular/task-detail`
6565
6300
 
6566
6301
  - `SubtaskListComponent` — `hm-subtask-list` (ver angular-api.md)
6567
- - `TaskDependencyChange` — Uma dependência pedida ou removida: `taskId` passa (ou deixa) de depender de `dependsOn`.
6568
-
6569
- ```ts
6570
- interface TaskDependencyChange {
6571
- readonly taskId: string;
6572
- readonly dependsOn: string;
6573
- }
6574
- ```
6575
-
6576
6302
  - `TaskDependenciesComponent` — `hm-task-dependencies` (ver angular-api.md)
6577
- - `TaskDraft` — O que o editor devolve ao salvar: os campos editáveis, com as datas em ISO (`aaaa-mm-dd`).
6578
-
6579
- ```ts
6580
- interface TaskDraft {
6581
- readonly title: string;
6582
- readonly description: string;
6583
- readonly status: string | null;
6584
- readonly priority: string | null;
6585
- readonly assigneeId: string | null;
6586
- readonly start: string | null;
6587
- readonly due: string | null;
6588
- readonly estimate: number | null;
6589
- }
6590
- ```
6591
-
6592
6303
  - `TaskEditorComponent` — `hm-task-editor` (ver angular-api.md)
6593
6304
  - `TaskDetailComponent` — `hm-task-detail` (ver angular-api.md)
6594
6305
 
6306
+ ## `@trismegisto/angular/terminal`
6307
+
6308
+ - `TerminalComponent` — `hm-terminal` (ver angular-api.md)
6309
+ - `const TERMINAL_MESSAGES: InjectionToken<TerminalMessages>` — Textos do terminal no idioma ativo da lib (`HermesI18nService.locale`), como vista viva.
6310
+ - `const TERMINAL_I18N_CONFIG: InjectionToken<TerminalI18nConfig>`
6311
+ - `function provideTerminalMessages(config: TerminalI18nConfig): Provider` — Sobrescreve textos do terminal e/ou acrescenta idiomas. O idioma em si vem de `provideHermesI18n`.
6312
+ - `TerminalI18nConfig`
6313
+ - `TerminalMessagesOverride`
6314
+
6595
6315
  ## `@trismegisto/angular/testing`
6596
6316
 
6597
6317
  - `HermesFieldHarnessFilters` — Filtro comum dos harnesses de campo: rótulo visível (ou o nome acessível, nos grupos).
@@ -7073,12 +6793,6 @@ class HermesDataGridHarness extends ComponentHarness {
7073
6793
 
7074
6794
  ## `@trismegisto/angular/textarea`
7075
6795
 
7076
- - `TextareaSubmitKey` — Tecla que envia o texto (`submitted`): nunca, Ctrl/⌘+Enter, ou Enter (Shift+Enter quebra linha).
7077
-
7078
- ```ts
7079
- type TextareaSubmitKey = 'none' | 'mod-enter' | 'enter';
7080
- ```
7081
-
7082
6796
  - `TextareaComponent` — `hm-textarea` (ver angular-api.md)
7083
6797
  - `TextareaAddonSlot`
7084
6798
 
@@ -7116,14 +6830,13 @@ class HermesThemeService {
7116
6830
 
7117
6831
  ## `@trismegisto/angular/theme-builder`
7118
6832
 
7119
- - `ThemeBuilderFormat`
6833
+ - `ThemeBuilderComponent` — `hm-theme-builder` (ver angular-api.md)
6834
+ - `ThemeBuilderFormat` _(de `@trismegisto/primitives/theme-builder`)_ — Formatos de exportação do Theme Builder.
7120
6835
 
7121
6836
  ```ts
7122
6837
  type ThemeBuilderFormat = 'css' | 'json' | 'typescript';
7123
6838
  ```
7124
6839
 
7125
- - `ThemeBuilderComponent` — `hm-theme-builder` (ver angular-api.md)
7126
-
7127
6840
  ## `@trismegisto/angular/theme-picker`
7128
6841
 
7129
6842
  - `ThemePickerComponent` — `hm-theme-picker` (ver angular-api.md)
@@ -7198,7 +6911,7 @@ interface HermesToastConfig {
7198
6911
  ```ts
7199
6912
  class HermesToastService {
7200
6913
  readonly toasts = computed(…)
7201
- readonly activeStack = computed(…)
6914
+ readonly activeStack
7202
6915
  push(variant: AlertVariant, message: string, options?: ToastPushOptions): void
7203
6916
  error(message: string, options?: ToastPushOptions): void
7204
6917
  warning(message: string, options?: ToastPushOptions): void
@@ -7221,12 +6934,6 @@ abstract class HermesToggleGroup {
7221
6934
  ```
7222
6935
 
7223
6936
  - `ToggleGroupItemComponent` — `hm-toggle-group-item` (ver angular-api.md)
7224
- - `ToggleGroupValue` — Valor do grupo: o `value` do item marcado (escolha única) ou a lista dos ligados (múltipla).
7225
-
7226
- ```ts
7227
- type ToggleGroupValue = string | readonly string[];
7228
- ```
7229
-
7230
6937
  - `ToggleGroupAppearance` — Peso visual: `outlined` (itens encostados numa moldura só, padrão) ou `subtle` (sem moldura).
7231
6938
 
7232
6939
  ```ts
@@ -7249,14 +6956,13 @@ type ToggleGroupOrientation = 'horizontal' | 'vertical';
7249
6956
 
7250
6957
  ## `@trismegisto/angular/toggletip`
7251
6958
 
7252
- - `ToggletipSide`
6959
+ - `ToggletipComponent` — `hm-toggletip` (ver angular-api.md)
6960
+ - `ToggletipSide` _(de `@trismegisto/primitives/toggletip`)_ — Lado preferido do balão; vira para o outro quando não cabe.
7253
6961
 
7254
6962
  ```ts
7255
6963
  type ToggletipSide = 'bottom' | 'top';
7256
6964
  ```
7257
6965
 
7258
- - `ToggletipComponent` — `hm-toggletip` (ver angular-api.md)
7259
-
7260
6966
  ## `@trismegisto/angular/toolbar`
7261
6967
 
7262
6968
  - `ToolbarComponent` — `hm-toolbar` (ver angular-api.md)
@@ -7588,7 +7294,7 @@ class HermesUnsavedChangesService {
7588
7294
  register(check: UnsavedChangesCheck, options: UnsavedChangesEntryOptions = {}): () => void
7589
7295
  hasUnsavedChanges(scope?: string): boolean
7590
7296
  confirmDiscard(options: HermesUnsavedChangesConfirmOptions = {}): Promise<boolean>
7591
- async canLeave(scope?: string, options?: HermesUnsavedChangesConfirmOptions): Promise<boolean>
7297
+ canLeave(scope?: string, options?: HermesUnsavedChangesConfirmOptions): Promise<boolean>
7592
7298
  warnBeforeUnload(scope?: string): () => void
7593
7299
  }
7594
7300
  ```
@@ -7700,18 +7406,6 @@ interface VehiclePlateMessages {
7700
7406
 
7701
7407
  ## `@trismegisto/angular/webhook`
7702
7408
 
7703
- - `WebhookConfig` — Configuração de um webhook (o que o editor edita e emite).
7704
-
7705
- ```ts
7706
- interface WebhookConfig {
7707
- readonly url: string;
7708
- readonly secret: string;
7709
- readonly events: readonly string[];
7710
- readonly active: boolean;
7711
- }
7712
- ```
7713
-
7714
- - `const EMPTY_WEBHOOK_CONFIG: WebhookConfig`
7715
7409
  - `WebhookEditorComponent` — `hm-webhook-editor` (ver angular-api.md)
7716
7410
  - `WebhookDeliveriesComponent` — `hm-webhook-deliveries` (ver angular-api.md)
7717
7411
  - `WebhookMessages` — Textos de hm-webhook-editor e hm-webhook-deliveries.
@@ -7765,12 +7459,6 @@ interface WebhookMessages {
7765
7459
 
7766
7460
  ## `@trismegisto/angular/wizard`
7767
7461
 
7768
- - `WizardMode`
7769
-
7770
- ```ts
7771
- type WizardMode = 'modal' | 'page';
7772
- ```
7773
-
7774
7462
  - `WizardComponent` — `hm-wizard` (ver angular-api.md)
7775
7463
 
7776
7464
  ## `@trismegisto/angular/workflow-diagram`
@@ -7879,13 +7567,7 @@ interface TaskMessages {
7879
7567
  // …
7880
7568
  ```
7881
7569
 
7882
- - `const WORKFLOW_MESSAGES_PT_BR: WorkflowMessages`
7883
- - `const TASKS_MESSAGES_PT_BR: TaskMessages`
7884
- - `const WORKFLOW_MESSAGES_EN: WorkflowMessages`
7885
- - `const TASKS_MESSAGES_EN: TaskMessages`
7886
- - `const WORKFLOW_MESSAGES_ES: WorkflowMessages`
7887
- - `const TASKS_MESSAGES_ES: TaskMessages`
7888
- - `WorkflowCatalog` — Os textos das peças de status/workflow e de tarefas/projetos, num idioma.
7570
+ - `WorkflowCatalog` _(de `@trismegisto/primitives/messages-workflow`)_ — Os textos das peças de status/workflow e de tarefas/projetos, num idioma.
7889
7571
 
7890
7572
  ```ts
7891
7573
  interface WorkflowCatalog {
@@ -7894,7 +7576,7 @@ interface WorkflowCatalog {
7894
7576
  }
7895
7577
  ```
7896
7578
 
7897
- - `WorkflowTextOverride` — Sobrescrita parcial dos textos (input `texts` de cada peça): seção → grupo → chave. Ex.: `{ workflow: { status: { confirm: 'Mudar' } } }`.
7579
+ - `WorkflowTextOverride` _(de `@trismegisto/primitives/messages-workflow`)_ — Sobrescrita parcial dos textos (input/prop `texts` de cada peça): seção → grupo → chave. Ex.: `{ workflow: { status: { confirm: 'Mudar' } } }`.
7898
7580
 
7899
7581
  ```ts
7900
7582
  interface WorkflowTextOverride {
@@ -7903,6 +7585,13 @@ interface WorkflowTextOverride {
7903
7585
  }
7904
7586
  ```
7905
7587
 
7588
+ - `function mergeWorkflowCatalog(base: WorkflowCatalog, override: WorkflowTextOverride | null | undefined): WorkflowCatalog` _(de `@trismegisto/primitives/messages-workflow`)_ — Aplica a sobrescrita parcial sobre um catálogo (dois níveis: grupo e chave).
7589
+ - `const WORKFLOW_MESSAGES_PT_BR: WorkflowMessages`
7590
+ - `const TASKS_MESSAGES_PT_BR: TaskMessages`
7591
+ - `const WORKFLOW_MESSAGES_EN: WorkflowMessages`
7592
+ - `const TASKS_MESSAGES_EN: TaskMessages`
7593
+ - `const WORKFLOW_MESSAGES_ES: WorkflowMessages`
7594
+ - `const TASKS_MESSAGES_ES: TaskMessages`
7906
7595
  - `WorkflowText` — O que as peças leem: o catálogo do idioma ativo (com a sobrescrita) e o locale de formatação.
7907
7596
 
7908
7597
  ```ts
@@ -7914,7 +7603,6 @@ interface WorkflowText extends WorkflowCatalog {
7914
7603
  - `const WORKFLOW_CATALOG_PT_BR: WorkflowCatalog`
7915
7604
  - `const WORKFLOW_CATALOG_EN: WorkflowCatalog`
7916
7605
  - `const WORKFLOW_CATALOG_ES: WorkflowCatalog`
7917
- - `function mergeWorkflowCatalog(base: WorkflowCatalog, override: WorkflowTextOverride | null | undefined): WorkflowCatalog` — Aplica a sobrescrita parcial sobre um catálogo (dois níveis: grupo e chave).
7918
7606
  - `function workflowMessages(override: () => WorkflowTextOverride | null | undefined = () => null): WorkflowText` — Textos das peças de workflow no idioma do `HermesI18nService` (pt-BR, en, es), com a sobrescrita `override()` (o input `texts`). Chamar no contexto de injeção; ler dentro de `computed`/template (é reativo: os getters le…
7919
7607
 
7920
7608
  ## `@trismegisto/angular/workload`
@@ -7950,7 +7638,7 @@ interface WorkspaceTabContext {
7950
7638
 
7951
7639
  - `const HERMES_WORKSPACE_PERSISTENCE_CONFIG = new InjectionToken<WorkspacePersistenceConfig>` — Config de persistência do `hm-workspace` (`storagePrefix`, ver `@trismegisto/primitives`'s `workspace.ts`) — mesmo padrão de `HERMES_THEME_CONFIG`: um app consumidor sobrescreve via provider pra ter seu próprio prefixo,…
7952
7640
  - `function provideHermesWorkspacePersistence(config: WorkspacePersistenceConfig): Provider`
7953
- - `function createPersistedWorkspaceStore( fallback: TabBarState, resolveTab: WorkspaceTabResolver, config: WorkspacePersistenceConfig = DEFAULT_WORKSPACE_PERSISTENCE_CONFIG, ): WorkspaceStore` — Cria (ou restaura de `sessionStorage`) um `WorkspaceStore` e liga a persistência automática — o ponto de entrada pra quem quer "abas do workspace sobrevivem a F5" sem escrever storage à mão. `resolveTab` re-resolve cada…
7641
+ - `function createPersistedWorkspaceStore( fallback: TabBarState, resolveTab: WorkspaceTabResolver, config: WorkspacePersistenceConfig = DEFAULT_WORKSPACE_PERSISTENCE_CONFIG, storage: WorkspaceStorage | null = workspaceSessionStorage(), ): Wo…` _(de `@trismegisto/primitives/workspace-persistence`)_ — Cria (ou restaura do storage) um `WorkspaceStore` e liga a persistência automática — o ponto de entrada pra quem quer "abas do workspace sobrevivem a F5" sem escrever storage à mão. `resolveTab` re-resolve cada id salvo…
7954
7642
 
7955
7643
  ## `@trismegisto/angular/zoom`
7956
7644
 
@@ -7961,7 +7649,7 @@ class HermesZoomService {
7961
7649
  readonly level = computed(…)
7962
7650
  readonly pixelRatio = computed(…)
7963
7651
  readonly zoomed = computed(…)
7964
- readonly textScale
7652
+ readonly textScale = computed(…)
7965
7653
  setTextScale(scale: number): void
7966
7654
  }
7967
7655
  ```
@@ -8129,6 +7817,7 @@ interface HermesMessages {
8129
7817
  restore: string;
8130
7818
  close: string;
8131
7819
  keyboardHint: string;
7820
+ sheetHint?: string;
8132
7821
  moved: string;
8133
7822
  resized: string;
8134
7823
  minimized: string;
@@ -8139,7 +7828,6 @@ interface HermesMessages {
8139
7828
  label: string;
8140
7829
  placeholder: string;
8141
7830
  inputLabel: string;
8142
- recent: string;
8143
7831
  // …
8144
7832
  ```
8145
7833
 
@@ -8513,7 +8201,7 @@ interface BulkParseResult {
8513
8201
  }
8514
8202
  ```
8515
8203
 
8516
- - `BulkSeparator` — Entrada em lote: um texto colado (lista do Excel, e-mails separados por vírgula, códigos um por linha) vira uma lista de itens válidos, mais o relatório do que foi recusado. Sem framework.
8204
+ - `BulkSeparator`
8517
8205
 
8518
8206
  ```ts
8519
8207
  type BulkSeparator = 'newline' | 'comma' | 'semicolon' | 'space' | 'tab';