@acropole/skills 0.0.0-stage → 1.1.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 (92) hide show
  1. package/README.md +181 -2
  2. package/agents/revisor-deploy.md +73 -0
  3. package/agents/revisor-documentacao.md +78 -0
  4. package/agents/revisor-orfeu.md +80 -0
  5. package/agents/revisor-trismegisto.md +81 -0
  6. package/bin/install.js +252 -0
  7. package/package.json +15 -4
  8. package/skills/acropole/SKILL.md +80 -0
  9. package/skills/acropole/references/arquitetura.md +174 -0
  10. package/skills/acropole/references/fluxos/app-novo.md +34 -0
  11. package/skills/acropole/references/fluxos/doctor.md +55 -0
  12. package/skills/acropole/references/fluxos/endpoint-novo.md +22 -0
  13. package/skills/acropole/references/fluxos/revisar.md +56 -0
  14. package/skills/acropole/references/fluxos/tela-nova.md +27 -0
  15. package/skills/acropole/scripts/doctor.mjs +439 -0
  16. package/skills/angular/SKILL.md +155 -0
  17. package/skills/angular/references/armadilhas.md +99 -0
  18. package/skills/angular/references/dados.md +251 -0
  19. package/skills/angular/references/estrutura.md +279 -0
  20. package/skills/angular/references/features.md +219 -0
  21. package/skills/angular/references/testes-build.md +257 -0
  22. package/skills/angular/scripts/checar.mjs +182 -0
  23. package/skills/angular/scripts/nucleo.mjs +227 -0
  24. package/skills/apollo/SKILL.md +226 -0
  25. package/skills/apollo/references/armadilhas.md +99 -0
  26. package/skills/apollo/references/envelope-erros.md +120 -0
  27. package/skills/apollo/references/estrutura-bootstrap.md +310 -0
  28. package/skills/apollo/references/schema-resolvers.md +183 -0
  29. package/skills/apollo/references/subscriptions.md +224 -0
  30. package/skills/apollo/references/testes-build.md +181 -0
  31. package/skills/apollo/scripts/checar.mjs +160 -0
  32. package/skills/apollo/scripts/nucleo.mjs +227 -0
  33. package/skills/docker/SKILL.md +102 -0
  34. package/skills/docker/references/modelos.md +251 -0
  35. package/skills/docker/references/porques.md +286 -0
  36. package/skills/documentacao/SKILL.md +146 -0
  37. package/skills/documentacao/references/checklist-coerencia.md +59 -0
  38. package/skills/documentacao/references/ligar-app-novo.md +107 -0
  39. package/skills/documentacao/references/modelo-especificacao.md +51 -0
  40. package/skills/documentacao/references/modelo-readme.md +75 -0
  41. package/skills/documentacao/scripts/checar.mjs +454 -0
  42. package/skills/documentacao/scripts/nucleo.mjs +227 -0
  43. package/skills/express/SKILL.md +156 -0
  44. package/skills/express/references/dados.md +180 -0
  45. package/skills/express/references/estrutura.md +157 -0
  46. package/skills/express/references/middlewares.md +227 -0
  47. package/skills/express/references/rotas-erros.md +286 -0
  48. package/skills/express/references/testes-deploy.md +154 -0
  49. package/skills/express/scripts/checar.mjs +115 -0
  50. package/skills/express/scripts/nucleo.mjs +227 -0
  51. package/skills/fastapi/SKILL.md +132 -0
  52. package/skills/fastapi/references/banco.md +197 -0
  53. package/skills/fastapi/references/estrutura.md +325 -0
  54. package/skills/fastapi/references/integracoes.md +145 -0
  55. package/skills/fastapi/references/rotas-erros.md +140 -0
  56. package/skills/fastapi/references/testes-deploy.md +190 -0
  57. package/skills/fastapi/scripts/checar.mjs +108 -0
  58. package/skills/fastapi/scripts/nucleo.mjs +227 -0
  59. package/skills/hefesto/SKILL.md +119 -0
  60. package/skills/hefesto/references/conceitos.md +131 -0
  61. package/skills/hefesto/references/diagnostico.md +70 -0
  62. package/skills/hefesto/references/fluxo.md +122 -0
  63. package/skills/hefesto/references/preparar-app.md +105 -0
  64. package/skills/orfeu/SKILL.md +162 -0
  65. package/skills/orfeu/references/angular-api.md +201 -0
  66. package/skills/orfeu/references/angular-armadilhas.md +116 -0
  67. package/skills/orfeu/references/angular-recipes.md +474 -0
  68. package/skills/orfeu/references/angular.md +212 -0
  69. package/skills/orfeu/references/diferencas.md +56 -0
  70. package/skills/orfeu/references/node-api.md +354 -0
  71. package/skills/orfeu/references/node-armadilhas.md +158 -0
  72. package/skills/orfeu/references/node-recipes.md +541 -0
  73. package/skills/orfeu/references/node.md +204 -0
  74. package/skills/orfeu/references/python-api.md +346 -0
  75. package/skills/orfeu/references/python-recipes.md +479 -0
  76. package/skills/orfeu/references/python.md +240 -0
  77. package/skills/orfeu/scripts/checar.mjs +126 -0
  78. package/skills/orfeu/scripts/nucleo.mjs +227 -0
  79. package/skills/trismegisto/SKILL.md +194 -0
  80. package/skills/trismegisto/references/angular-api.md +2788 -0
  81. package/skills/trismegisto/references/angular-exports.md +4020 -0
  82. package/skills/trismegisto/references/angular-recipes.md +1883 -0
  83. package/skills/trismegisto/references/angular-types.md +492 -0
  84. package/skills/trismegisto/references/angular.md +390 -0
  85. package/skills/trismegisto/references/catalogo/icones.json +912 -0
  86. package/skills/trismegisto/references/catalogo/seletores.json +7013 -0
  87. package/skills/trismegisto/references/catalogo/tokens.json +240 -0
  88. package/skills/trismegisto/references/spine-api.md +1530 -0
  89. package/skills/trismegisto/references/spine-recipes.md +581 -0
  90. package/skills/trismegisto/references/spine.md +343 -0
  91. package/skills/trismegisto/scripts/checar.mjs +216 -0
  92. package/skills/trismegisto/scripts/nucleo.mjs +227 -0
@@ -0,0 +1,4020 @@
1
+ # Exports por ponto de import — @trismegisto/angular
2
+
3
+ > **Gerado** a partir do código-fonte da versão 1.0.0, a cada `npm run sync` do @acropole/skills (junto com o `angular-api.md`).
4
+
5
+ Tudo que cada `@trismegisto/angular/<ponto>` exporta: serviços (com os membros públicos), funções, constantes,
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.
9
+
10
+ ## `@trismegisto/angular/accordion`
11
+
12
+ - `AccordionPanelComponent` — `hm-accordion-panel` (ver angular-api.md)
13
+ - `AccordionComponent` — `hm-accordion` (ver angular-api.md)
14
+ - **`HermesAccordionGroup`** (classe) — Contrato que `hm-accordion` publica por injeção para os `hm-accordion-panel` dentro dele.
15
+
16
+ ```ts
17
+ abstract class HermesAccordionGroup {
18
+ }
19
+ ```
20
+
21
+ - `AccordionContentDirective` — `ng-template[hmAccordionContent]` (ver angular-api.md)
22
+
23
+ ## `@trismegisto/angular/account-avatar`
24
+
25
+ - `AccountAvatarSize` — Escala de tamanho do avatar (a mesma do `hm-avatar-group`).
26
+
27
+ ```ts
28
+ type AccountAvatarSize = 'small' | 'medium' | 'large';
29
+ ```
30
+
31
+ - `AccountAvatarComponent` — `hm-account-avatar` (ver angular-api.md)
32
+
33
+ ## `@trismegisto/angular/alert`
34
+
35
+ - `AlertGroupComponent` — `hm-alert-group` (ver angular-api.md)
36
+ - **`HermesAlertGroup`** (classe) — Contrato que `hm-alert-group` publica por injeção para os `hm-alert` dentro dele.
37
+
38
+ ```ts
39
+ abstract class HermesAlertGroup {
40
+ }
41
+ ```
42
+
43
+ - `AlertSize` — `medium` (padrão) ou `small`: respiro, texto e ícone menores para painel, cartão e formulário.
44
+
45
+ ```ts
46
+ type AlertSize = 'small' | 'medium';
47
+ ```
48
+
49
+ - `AlertComponent` — `hm-alert` (ver angular-api.md)
50
+
51
+ ## `@trismegisto/angular/attachment`
52
+
53
+ - `AttachmentStatus` — Situação do anexo: `idle` (arquivo já disponível, sem envio em jogo) ou uma das situações de envio do `hm-file-upload` (`pending`, `uploading`, `done`, `error`), com os mesmos textos.
54
+
55
+ ```ts
56
+ type AttachmentStatus = 'idle' | FileUploadStatus;
57
+ ```
58
+
59
+ - `AttachmentComponent` — `hm-attachment` (ver angular-api.md)
60
+ - `AttachmentGroupLayout` — Como o grupo arruma os anexos: `list` (um por linha, largura toda), `inline` (cartões compactos que quebram linha — embaixo de um campo de prompt, numa mensagem) ou `grid` (blocos com a miniatura em cima — galeria de im…
61
+
62
+ ```ts
63
+ type AttachmentGroupLayout = 'list' | 'inline' | 'grid';
64
+ ```
65
+
66
+ - `AttachmentGroupComponent` — `hm-attachment-group` (ver angular-api.md)
67
+ - `function fileExtension(name: string): string` — Extensão minúscula, sem o ponto (`'Relatório.PDF'` → `'pdf'`); sem extensão, `''`.
68
+ - `function isImageFile(name: string, type = ''): boolean` — O arquivo é uma imagem (pelo MIME ou, sem ele, pela extensão)?
69
+ - `function fileIconName(name: string, type = ''): string` — Nome do ícone do catálogo para o arquivo.
70
+
71
+ ## `@trismegisto/angular/avatar-group`
72
+
73
+ - `AvatarGroupPerson` — Uma pessoa da pilha: o mesmo par que o `hm-account-avatar` consome.
74
+
75
+ ```ts
76
+ interface AvatarGroupPerson {
77
+ readonly name: string;
78
+ readonly imageUrl?: string | null;
79
+ }
80
+ ```
81
+
82
+ - `AvatarGroupSize`
83
+
84
+ ```ts
85
+ type AvatarGroupSize = 'small' | 'medium' | 'large';
86
+ ```
87
+
88
+ - `AvatarGroupComponent` — `hm-avatar-group` (ver angular-api.md)
89
+
90
+ ## `@trismegisto/angular/badge`
91
+
92
+ - `BadgeComponent` — `hm-badge` (ver angular-api.md)
93
+
94
+ ## `@trismegisto/angular/breadcrumb`
95
+
96
+ - `BreadcrumbItem` — Um degrau da trilha. Sem `routerLink` nem `href`, o degrau é só texto.
97
+
98
+ ```ts
99
+ interface BreadcrumbItem {
100
+ readonly label: string;
101
+ readonly routerLink?: string | readonly unknown[];
102
+ readonly queryParams?: Readonly<Record<string, string>>;
103
+ readonly href?: string;
104
+ readonly target?: string;
105
+ readonly icon?: string;
106
+ }
107
+ ```
108
+
109
+ - `BreadcrumbComponent` — `hm-breadcrumb` (ver angular-api.md)
110
+
111
+ ## `@trismegisto/angular/bubble`
112
+
113
+ - `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…
114
+
115
+ ```ts
116
+ type BubbleVariant = 'received' | 'sent' | 'system' | 'emphasis';
117
+ ```
118
+
119
+ - `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.
120
+
121
+ ```ts
122
+ interface BubbleReaction {
123
+ readonly emoji: string;
124
+ readonly count: number;
125
+ readonly label?: string;
126
+ readonly selected?: boolean;
127
+ }
128
+ ```
129
+
130
+ - `BubbleComponent` — `hm-bubble` (ver angular-api.md)
131
+
132
+ ## `@trismegisto/angular/bulk-input`
133
+
134
+ - `BulkInputComponent` — `hm-bulk-input` (ver angular-api.md)
135
+
136
+ ## `@trismegisto/angular/button`
137
+
138
+ - `ButtonGroupRegistry` — Registro de um `hm-button` no `hm-button-group` que o contém (ver button-group.component.ts).
139
+
140
+ ```ts
141
+ interface ButtonGroupRegistry {
142
+ register(button: ButtonComponent): void;
143
+ unregister(button: ButtonComponent): void;
144
+ }
145
+ ```
146
+
147
+ - `const HM_BUTTON_GROUP: InjectionToken<ButtonGroupRegistry>`
148
+ - `ButtonComponent` — `hm-button` (ver angular-api.md)
149
+
150
+ ## `@trismegisto/angular/button-group`
151
+
152
+ - `ButtonGroupComponent` — `hm-button-group` (ver angular-api.md)
153
+
154
+ ## `@trismegisto/angular/card`
155
+
156
+ - `CardMediaPosition` — Onde a mídia fica: em cima de tudo, ou numa coluna ao lado (começo ou fim da linha).
157
+
158
+ ```ts
159
+ type CardMediaPosition = 'top' | 'start' | 'end';
160
+ ```
161
+
162
+ - `CardComponent` — `hm-card` (ver angular-api.md)
163
+
164
+ ## `@trismegisto/angular/card-container`
165
+
166
+ - `CardContainerPersistStorage` — Onde `persistKey` guarda a ordem e a visibilidade.
167
+
168
+ ```ts
169
+ type CardContainerPersistStorage = 'local' | 'session';
170
+ ```
171
+
172
+ - `CardVisibilityChange` — Um cartão mudou de visibilidade (`visibilityChange`; "restaurar padrão" emite um por cartão reexibido).
173
+
174
+ ```ts
175
+ interface CardVisibilityChange {
176
+ readonly key: unknown;
177
+ readonly visible: boolean;
178
+ }
179
+ ```
180
+
181
+ - `CardContainerItemContext` — Contexto do template do cartão: `let-item let-index="index" let-selected="selected"`.
182
+
183
+ ```ts
184
+ interface CardContainerItemContext<T = unknown> {
185
+ readonly $implicit: T;
186
+ readonly index: number;
187
+ readonly selected: boolean;
188
+ }
189
+ ```
190
+
191
+ - `CardContainerItemDirective` — `ng-template[hmCardContainerItem]` (ver angular-api.md)
192
+ - `CardContainerEmptyDirective` — `ng-template[hmCardContainerEmpty]` (ver angular-api.md)
193
+ - `CardContainerComponent` — `hm-card-container` (ver angular-api.md)
194
+ - `CardSelectionMode` _(de `@trismegisto/primitives`)_ — Grade de cartões (`hm-card-container`), sem framework: a navegação por setas numa grade que reflui com a largura (colunas medidas na hora) e a seleção simples/múltipla por chave.
195
+
196
+ ```ts
197
+ type CardSelectionMode = 'none' | 'single' | 'multiple';
198
+ ```
199
+
200
+ ## `@trismegisto/angular/carousel`
201
+
202
+ - `CarouselComponent` — `hm-carousel` (ver angular-api.md)
203
+
204
+ ## `@trismegisto/angular/certificate-viewer`
205
+
206
+ - `CertificateViewerHeadingLevel` — Nível de título (`h1`…`h6`).
207
+
208
+ ```ts
209
+ type CertificateViewerHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
210
+ ```
211
+
212
+ - `CertificateViewerComponent` — `hm-certificate-viewer` (ver angular-api.md)
213
+
214
+ ## `@trismegisto/angular/checkbox`
215
+
216
+ - `CheckboxComponent` — `hm-checkbox` (ver angular-api.md)
217
+
218
+ ## `@trismegisto/angular/checkbox-group`
219
+
220
+ - `CheckboxGroupOption`
221
+
222
+ ```ts
223
+ interface CheckboxGroupOption {
224
+ readonly value: string;
225
+ readonly label: string;
226
+ readonly description?: string;
227
+ readonly disabled?: boolean;
228
+ }
229
+ ```
230
+
231
+ - `CheckboxGroupLayout` — `'stacked'` (padrão): uma opção por linha. `'inline'`: lado a lado, quebrando linha quando falta espaço.
232
+
233
+ ```ts
234
+ type CheckboxGroupLayout = 'stacked' | 'inline';
235
+ ```
236
+
237
+ - `CheckboxGroupComponent` — `hm-checkbox-group` (ver angular-api.md)
238
+
239
+ ## `@trismegisto/angular/chip`
240
+
241
+ - `ChipGroupComponent` — `hm-chip-group` (ver angular-api.md)
242
+ - **`HermesChipGroup`** (classe) — Contrato que `hm-chip-group` publica por injeção para os `hm-chip` dentro dele.
243
+
244
+ ```ts
245
+ abstract class HermesChipGroup {
246
+ }
247
+ ```
248
+
249
+ - `ChipVariant`
250
+
251
+ ```ts
252
+ type ChipVariant = 'outlined' | 'filled';
253
+ ```
254
+
255
+ - `ChipSize`
256
+
257
+ ```ts
258
+ type ChipSize = 'small' | 'medium';
259
+ ```
260
+
261
+ - `ChipComponent` — `hm-chip` (ver angular-api.md)
262
+
263
+ ## `@trismegisto/angular/code-input`
264
+
265
+ - `CodeInputComponent` — `hm-code-input` (ver angular-api.md)
266
+
267
+ ## `@trismegisto/angular/combobox`
268
+
269
+ - `ComboboxSize`
270
+
271
+ ```ts
272
+ type ComboboxSize = 'small' | 'medium' | 'large';
273
+ ```
274
+
275
+ - `ComboboxComponent` — `hm-combobox` (ver angular-api.md)
276
+ - `ComboboxOption` _(de `@trismegisto/primitives`)_ — `value` identifica a opção; `label` é o texto pesquisável e mostrado. `raw`/`swatchBackground`+ `swatchBorder` (sempre os dois juntos — só o fundo deixaria a opção sem moldura num tema onde o fundo se aproxima da superf…
277
+
278
+ ```ts
279
+ interface ComboboxOption {
280
+ readonly value: string;
281
+ readonly label: string;
282
+ readonly disabled?: boolean;
283
+ readonly icon?: string;
284
+ readonly swatchBackground?: string;
285
+ readonly swatchBorder?: string;
286
+ }
287
+ ```
288
+
289
+ ## `@trismegisto/angular/combobox-multi`
290
+
291
+ - `ComboboxMultiComponent` — `hm-combobox-multi` (ver angular-api.md)
292
+
293
+ ## `@trismegisto/angular/command-palette`
294
+
295
+ - `HermesCommand` — Um comando da paleta.
296
+
297
+ ```ts
298
+ interface HermesCommand {
299
+ readonly id: string;
300
+ readonly label: string;
301
+ readonly group?: string;
302
+ readonly keywords?: readonly string[];
303
+ readonly icon?: string;
304
+ readonly shortcut?: string | readonly string[];
305
+ readonly description?: string;
306
+ readonly disabled?: boolean;
307
+ readonly run: () => void | Promise<unknown>;
308
+ }
309
+ ```
310
+
311
+ - `CommandPaletteComponent` — `hm-command-palette` (ver angular-api.md)
312
+ - `PaletteOptionView` — Uma opção pronta para a lista (o que a paleta e a busca global entregam ao contêiner).
313
+
314
+ ```ts
315
+ interface PaletteOptionView {
316
+ readonly key: string;
317
+ readonly segments: readonly HighlightSegment[];
318
+ readonly description?: string;
319
+ readonly icon?: string;
320
+ readonly shortcut?: string | readonly string[];
321
+ readonly disabled?: boolean;
322
+ readonly busy?: boolean;
323
+ }
324
+ ```
325
+
326
+ - `PaletteGroupView`
327
+
328
+ ```ts
329
+ interface PaletteGroupView {
330
+ readonly key: string;
331
+ readonly label: string;
332
+ readonly options: readonly PaletteOptionView[];
333
+ }
334
+ ```
335
+
336
+ - `PaletteStatusKind` — Estado no lugar da lista: vazio, carregando, erro (com "tentar de novo") ou dica inicial.
337
+
338
+ ```ts
339
+ type PaletteStatusKind = '' | 'idle' | 'empty' | 'loading' | 'error';
340
+ ```
341
+
342
+ - `PaletteShellComponent` — `hm-palette-shell` (ver angular-api.md)
343
+
344
+ ## `@trismegisto/angular/copy-button`
345
+
346
+ - `CopyButtonVariant` — `icon`: só o ícone (padrão do `hm-icon-button`); `text`: ícone + rótulo visível.
347
+
348
+ ```ts
349
+ type CopyButtonVariant = 'icon' | 'text';
350
+ ```
351
+
352
+ - `CopyButtonComponent` — `hm-copy-button` (ver angular-api.md)
353
+
354
+ ## `@trismegisto/angular/data-grid`
355
+
356
+ - `DataGridActionBarComponent` — `hm-data-grid-action-bar` (ver angular-api.md)
357
+ - `DataGridCellDirective` — `ng-template[hmCell]` (ver angular-api.md)
358
+ - `DataGridColumnFilterComponent` — `hm-data-grid-column-filter` (ver angular-api.md)
359
+ - `DataGridHeaderDirective` — `ng-template[hmColumnHeader]` (ver angular-api.md)
360
+ - `DataGridComponent` — `hm-data-grid` (ver angular-api.md)
361
+ - `DataGridRowAction` — Ação por linha, desenhada como item do menu da última coluna.
362
+
363
+ ```ts
364
+ interface DataGridRowAction<T = unknown> {
365
+ readonly id: string;
366
+ readonly icon: string;
367
+ readonly label: string;
368
+ readonly danger?: boolean;
369
+ readonly separatorAbove?: boolean;
370
+ readonly available?: (row: T) => boolean;
371
+ }
372
+ ```
373
+
374
+ - `DataGridActionTriggered`
375
+
376
+ ```ts
377
+ interface DataGridActionTriggered<T> {
378
+ readonly action: string;
379
+ readonly row: T;
380
+ }
381
+ ```
382
+
383
+ - `DataGridContext`
384
+
385
+ ```ts
386
+ interface DataGridContext<T> {
387
+ readonly $implicit: T;
388
+ }
389
+ ```
390
+
391
+ - `DataGridFooterContext` — Contexto do `#footerDescription`: posição (1-based) do primeiro e do último item da página.
392
+
393
+ ```ts
394
+ interface DataGridFooterContext {
395
+ readonly first: number;
396
+ readonly last: number;
397
+ readonly total: number;
398
+ readonly page: number;
399
+ readonly lastPage: number;
400
+ }
401
+ ```
402
+
403
+ - `DataGridRowState` — Veredito da linha inteira, quando ela tem um — a tinta é reforço, nunca o portador do significado: quem usa continua devendo uma coluna que diga o que houve (WCAG 1.4.1).
404
+
405
+ ```ts
406
+ type DataGridRowState = 'error' | 'warning';
407
+ ```
408
+
409
+ - `DataGridRowDetail` — Disponibilidade do detalhe de UMA linha (`rowDetailDisabled`/`rowDetailHidden`): `'disabled'` mostra o botão desativado (fora da ordem de Tab); `'hidden'` não desenha botão nem detalhe.
410
+
411
+ ```ts
412
+ type DataGridRowDetail = 'enabled' | 'disabled' | 'hidden';
413
+ ```
414
+
415
+ - `DataGridColumn` _(de `@trismegisto/primitives`)_ — Definição de coluna. `value` devolve o texto já formatado que a célula mostra; `raw` (quando existe) devolve o valor comparável/filtrável — separar os dois é o que permite filtrar por `>18` numa coluna que exibe "18 ano…
416
+
417
+ ```ts
418
+ interface GridColumn<T> {
419
+ readonly key: string;
420
+ readonly title: string;
421
+ readonly value: (row: T) => string;
422
+ readonly type?: GridColumnType;
423
+ readonly raw?: (row: T) => unknown;
424
+ readonly sortable?: boolean;
425
+ readonly filterable?: boolean;
426
+ readonly searchable?: boolean;
427
+ readonly align?: 'start' | 'end';
428
+ readonly initialWidth?: string;
429
+ readonly hideable?: boolean;
430
+ readonly hidden?: boolean;
431
+ readonly exportable?: boolean;
432
+ readonly pinned?: 'start' | 'end';
433
+ }
434
+ ```
435
+
436
+ - `DataGridExportFormat` — `csv`: RFC 4180 (vírgula, sem BOM). `excel`: BOM UTF-8 e o separador do idioma (`;` em pt-BR/es).
437
+
438
+ ```ts
439
+ type DataGridExportFormat = 'csv' | 'excel';
440
+ ```
441
+
442
+ - `DataGridExportOptions`
443
+
444
+ ```ts
445
+ interface DataGridExportOptions {
446
+ readonly format?: DataGridExportFormat;
447
+ readonly fileName?: string;
448
+ readonly download?: boolean;
449
+ }
450
+ ```
451
+
452
+ - `DataGridPersistStorage`
453
+
454
+ ```ts
455
+ type DataGridPersistStorage = 'local' | 'session';
456
+ ```
457
+
458
+ - `DataGridSelectionMode` — `'single'` = rádio por linha (uma só); `'multiple'` = checkbox (o antigo `selectable`).
459
+
460
+ ```ts
461
+ type DataGridSelectionMode = 'none' | 'single' | 'multiple';
462
+ ```
463
+
464
+ ## `@trismegisto/angular/date-picker`
465
+
466
+ - `CalendarComponent` — `hm-calendar` (ver angular-api.md)
467
+ - `DatePickerComponent` — `hm-date-picker` (ver angular-api.md)
468
+ - `DateRangePreset` — Atalho próprio do app: rótulo e o intervalo, calculado na hora em que a lista aparece.
469
+
470
+ ```ts
471
+ interface DateRangePreset {
472
+ readonly label: string;
473
+ readonly range: () => DateRange;
474
+ }
475
+ ```
476
+
477
+ - `DateRangePresetOption` — Item de `presets`: um atalho pronto (`'today'`, `'last7Days'`…) ou um do app.
478
+
479
+ ```ts
480
+ type DateRangePresetOption = DateRangePresetId | DateRangePreset;
481
+ ```
482
+
483
+ - `DateRangePickerComponent` — `hm-date-range-picker` (ver angular-api.md)
484
+ - `DateRangePresetId` _(de `@trismegisto/primitives`)_ — Atalhos prontos: os textos vêm do catálogo (`datePicker.preset*`).
485
+
486
+ ```ts
487
+ type DateRangePresetId = 'today' | 'last7Days' | 'last30Days' | 'thisMonth' | 'lastMonth';
488
+ ```
489
+
490
+ ## `@trismegisto/angular/deprecation`
491
+
492
+ - `function warnDeprecated(api: string, replacement: string, since = '0.2.0', removal = '0.3.0'): void` — Aviso de API depreciada, **uma vez por API** e só em modo de desenvolvimento (some do build de produção junto com o `ngDevMode`). É o que o guia de migração manda procurar no console: cada `[hermes] … está depreciado` a…
493
+ - `function resetDeprecationWarnings(): void` — @internal Só para testes: esquece os avisos já dados.
494
+
495
+ ## `@trismegisto/angular/description-list`
496
+
497
+ - `DescriptionItemComponent` — `hm-description-item` (ver angular-api.md)
498
+ - `DescriptionListItem` — Um par termo/valor para a API por dados (`[items]`).
499
+
500
+ ```ts
501
+ interface DescriptionListItem {
502
+ readonly term: string;
503
+ readonly value?: string | number | null;
504
+ readonly fullWidth?: boolean;
505
+ readonly children?: readonly DescriptionListItem[];
506
+ readonly expanded?: boolean;
507
+ readonly editable?: boolean;
508
+ }
509
+ ```
510
+
511
+ - `DescriptionListValueChange` — Valor salvo na edição inline de um item por dados.
512
+
513
+ ```ts
514
+ interface DescriptionListValueChange {
515
+ readonly item: DescriptionListItem;
516
+ readonly path: readonly number[];
517
+ readonly value: string;
518
+ }
519
+ ```
520
+
521
+ - `DescriptionListLabelPosition`
522
+
523
+ ```ts
524
+ type DescriptionListLabelPosition = 'top' | 'start';
525
+ ```
526
+
527
+ - `DescriptionListVariant`
528
+
529
+ ```ts
530
+ type DescriptionListVariant = 'plain' | 'outlined';
531
+ ```
532
+
533
+ - `DescriptionListComponent` — `hm-description-list` (ver angular-api.md)
534
+
535
+ ## `@trismegisto/angular/dialog`
536
+
537
+ - `const HERMES_DIALOG_DATA: InjectionToken<unknown>` — Dados passados em `open(…, { data })`, injetáveis no componente aberto.
538
+ - `HermesDialogConfig`
539
+
540
+ ```ts
541
+ interface HermesDialogConfig<D = unknown> {
542
+ readonly heading: string;
543
+ readonly size?: ModalSize;
544
+ readonly closable?: boolean;
545
+ readonly data?: D;
546
+ }
547
+ ```
548
+
549
+ - `HermesConfirmOptions`
550
+
551
+ ```ts
552
+ interface HermesConfirmOptions {
553
+ readonly heading: string;
554
+ readonly message: string;
555
+ readonly confirmLabel?: string;
556
+ readonly cancelLabel?: string;
557
+ readonly danger?: boolean;
558
+ }
559
+ ```
560
+
561
+ - **`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…
562
+
563
+ ```ts
564
+ class HermesDialogRef<R = unknown> {
565
+ readonly closed: Promise<R | undefined>
566
+ onClose: () => void = () => {}
567
+ close(result?: R): void
568
+ }
569
+ ```
570
+
571
+ - **`HermesDialogService`** (classe)
572
+
573
+ ```ts
574
+ class HermesDialogService {
575
+ open<R = unknown, D = unknown>(component: Type<unknown>, config: HermesDialogConfig<D>): HermesDialogRef<R>
576
+ async confirm(options: HermesConfirmOptions): Promise<boolean>
577
+ }
578
+ ```
579
+
580
+ ## `@trismegisto/angular/direction`
581
+
582
+ - `HermesDirection` — Direção de escrita EFETIVA de um elemento (`ltr`/`rtl`), num lugar só.
583
+
584
+ ```ts
585
+ type HermesDirection = 'ltr' | 'rtl';
586
+ ```
587
+
588
+ - `function elementDirection(element: Element | null | undefined): HermesDirection` — `rtl` ou `ltr` pelo estilo computado do elemento; `ltr` quando não dá para medir.
589
+ - `function isRtl(element: Element | null | undefined): boolean` — Atalho de `elementDirection(element) === 'rtl'`.
590
+
591
+ ## `@trismegisto/angular/divider`
592
+
593
+ - `DividerOrientation`
594
+
595
+ ```ts
596
+ type DividerOrientation = 'horizontal' | 'vertical';
597
+ ```
598
+
599
+ - `DividerEmphasis`
600
+
601
+ ```ts
602
+ type DividerEmphasis = 'subtle' | 'strong';
603
+ ```
604
+
605
+ - `DividerThickness`
606
+
607
+ ```ts
608
+ type DividerThickness = 'hairline' | 'thin';
609
+ ```
610
+
611
+ - `DividerSpacing`
612
+
613
+ ```ts
614
+ type DividerSpacing = 'none' | 'small' | 'medium' | 'large';
615
+ ```
616
+
617
+ - `DividerLabelAlign`
618
+
619
+ ```ts
620
+ type DividerLabelAlign = 'start' | 'center' | 'end';
621
+ ```
622
+
623
+ - `DividerComponent` — `hm-divider` (ver angular-api.md)
624
+
625
+ ## `@trismegisto/angular/drag-drop`
626
+
627
+ - `const HERMES_DRAG_DROP =` — Todas as diretivas de arrastar e soltar, para um `imports: [HERMES_DRAG_DROP]` só.
628
+ - `HermesDragVia` — Como o arrasto foi feito: ponteiro (mouse, caneta, toque) ou teclado.
629
+
630
+ ```ts
631
+ type HermesDragVia = 'pointer' | 'keyboard';
632
+ ```
633
+
634
+ - `HermesDropAccepts` — Filtro de uma zona: tipo (`hmDragType`), lista de tipos ou predicado sobre os dados e o tipo.
635
+
636
+ ```ts
637
+ type HermesDropAccepts = string | readonly string[] | ((data: unknown, type: string) => boolean) | null;
638
+ ```
639
+
640
+ - `HermesDropEvent` — Item solto numa zona (`[hmDropZone]` → `dropped`).
641
+
642
+ ```ts
643
+ interface HermesDropEvent<T = unknown> {
644
+ readonly data: T;
645
+ readonly type: string;
646
+ readonly index: number;
647
+ readonly previousIndex: number;
648
+ readonly via: HermesDragVia;
649
+ }
650
+ ```
651
+
652
+ - `HermesDropOverEvent` — Ponteiro sobre uma zona (`[hmDropZone]` → `overPoint`), a cada movimento enquanto o item está sobre ela.
653
+
654
+ ```ts
655
+ interface HermesDropOverEvent<T = unknown> {
656
+ readonly data: T;
657
+ readonly type: string;
658
+ readonly point: DragPoint;
659
+ readonly offset: DragPoint;
660
+ readonly rect: DOMRect;
661
+ }
662
+ ```
663
+
664
+ - `HermesSortEvent` — Item solto numa lista ordenável (`[hmSortable]` → `sorted`), na mesma lista ou vindo de outra do grupo.
665
+
666
+ ```ts
667
+ interface HermesSortEvent<T = unknown> extends HermesDropEvent<T> {
668
+ readonly container: readonly T[];
669
+ readonly previousContainer: readonly unknown[];
670
+ readonly sameContainer: boolean;
671
+ }
672
+ ```
673
+
674
+ - `HermesDragTemplateContext` — Contexto dos templates `hmDragPreview`/`hmDragPlaceholder`: `let-data`.
675
+
676
+ ```ts
677
+ interface HermesDragTemplateContext<T = unknown> {
678
+ readonly $implicit: T;
679
+ }
680
+ ```
681
+
682
+ - `HermesDragItemRef` — @internal Um item arrastável, visto pelo serviço.
683
+
684
+ ```ts
685
+ interface HermesDragItemRef {
686
+ readonly element: HTMLElement;
687
+ readonly container: HermesDropTargetRef | null;
688
+ data(): unknown;
689
+ type(): string;
690
+ label(): string;
691
+ disabled(): boolean;
692
+ contained(): boolean;
693
+ focusTarget(): HTMLElement;
694
+ previewTemplate(): TemplateRef<HermesDragTemplateContext> | null;
695
+ setDragging(via: HermesDragVia | null): void;
696
+ started(via: HermesDragVia): void;
697
+ ended(dropped: boolean): void;
698
+ }
699
+ ```
700
+
701
+ - `HermesDropTargetRef` — @internal Um destino (zona simples ou lista ordenável), visto pelo serviço.
702
+
703
+ ```ts
704
+ interface HermesDropTargetRef {
705
+ readonly element: HTMLElement;
706
+ label(): string;
707
+ disabled(): boolean;
708
+ accepts(item: HermesDragItemRef): boolean;
709
+ orientation(): DragListOrientation | null;
710
+ columns(): number;
711
+ items(): readonly HermesDragItemRef[];
712
+ placeholderTemplate(): TemplateRef<HermesDragTemplateContext> | null;
713
+ setState(active: boolean, over: boolean): void;
714
+ drop(item: HermesDragItemRef, index: number, previousIndex: number, via: HermesDragVia): void;
715
+ pointerIndex?(item: HermesDragItemRef, point: DragPoint): number | null;
716
+ keyboardIndex?(item: HermesDragItemRef, index: number, key: string): number | null;
717
+ originIndex?(item: HermesDragItemRef): number;
718
+ announcement?(kind: 'grabbed' | 'over' | 'dropped', item: HermesDragItemRef, index: number): string | null;
719
+ indicate?(index: number | null): void;
720
+ pointerOver?(item: HermesDragItemRef, point: DragPoint): void;
721
+ }
722
+ ```
723
+
724
+ - `HermesSortableContainer` — @internal A lista ordenável que contém um `[hmDraggable]` (o item se registra nela).
725
+
726
+ ```ts
727
+ interface HermesSortableContainer extends HermesDropTargetRef {
728
+ register(item: HermesDragItemRef): void;
729
+ unregister(item: HermesDragItemRef): void;
730
+ }
731
+ ```
732
+
733
+ - `const HM_SORTABLE_CONTAINER: InjectionToken<HermesSortableContainer>` — @internal
734
+ - `function accessibleName(element: HTMLElement): string` — Nome acessível de um elemento (`aria-label` ou o texto de quem o `aria-labelledby` aponta).
735
+ - `` — Ordena pela posição no documento.
736
+ - **`HermesDragDropService`** (classe)
737
+
738
+ ```ts
739
+ class HermesDragDropService {
740
+ readonly instructionsId
741
+ readonly dragging = signal(…)
742
+ registerTarget(target: HermesDropTargetRef): void
743
+ unregisterTarget(target: HermesDropTargetRef): void
744
+ registerItem(item: HermesDragItemRef): void
745
+ unregisterItem(item: HermesDragItemRef): void
746
+ isActive(item: HermesDragItemRef, via?: HermesDragVia): boolean
747
+ blocksTouch(item: HermesDragItemRef): boolean
748
+ pointerDown(item: HermesDragItemRef, event: PointerEvent, capture: HTMLElement, activation: DragActivationOptions): void
749
+ cancelPress(item: HermesDragItemRef): void
750
+ keyboardGrab(item: HermesDragItemRef): void
751
+ keyboardKey(event: KeyboardEvent): boolean
752
+ keyboardBlur(item: HermesDragItemRef): void
753
+ get announcement(): string
754
+ }
755
+ ```
756
+
757
+ - `DragPreviewDirective` — `ng-template[hmDragPreview]` (ver angular-api.md)
758
+ - `HermesDragEndEvent` — Fim de um arrasto (`[hmDraggable]` → `dragEnded`).
759
+
760
+ ```ts
761
+ interface HermesDragEndEvent {
762
+ readonly dropped: boolean;
763
+ readonly via: HermesDragVia;
764
+ }
765
+ ```
766
+
767
+ - `DraggableDirective` — `[hmDraggable]` (ver angular-api.md)
768
+ - `DragHandleDirective` — `[hmDragHandle]` (ver angular-api.md)
769
+ - `function hermesDropAccepts(accepts: HermesDropAccepts, data: unknown, type: string): boolean` — Confere o filtro de uma zona contra os dados e o tipo do item. `null` aceita tudo.
770
+ - `DropZoneDirective` — `[hmDropZone]` (ver angular-api.md)
771
+ - `DragPlaceholderDirective` — `ng-template[hmDragPlaceholder]` (ver angular-api.md)
772
+ - `SortableDirective` — `[hmSortable]` (ver angular-api.md)
773
+ - `DragListOrientation` _(de `@trismegisto/primitives`)_
774
+
775
+ ```ts
776
+ type DragListOrientation = 'vertical' | 'horizontal' | 'grid';
777
+ ```
778
+
779
+ ## `@trismegisto/angular/drawer`
780
+
781
+ - `DrawerPosition` — Borda de onde o painel sai: fim da linha (direita em LTR), começo da linha ou de baixo.
782
+
783
+ ```ts
784
+ type DrawerPosition = 'end' | 'start' | 'bottom';
785
+ ```
786
+
787
+ - `DrawerComponent` — `hm-drawer` (ver angular-api.md)
788
+
789
+ ## `@trismegisto/angular/dropdown`
790
+
791
+ - `DropdownPosition` — Posição no formato do hermes-ui antigo (`hermesPosition`): `<lado>-<alinhamento>`.
792
+
793
+ ```ts
794
+ type DropdownPosition =
795
+ | 'bottom-left'
796
+ | 'bottom-right'
797
+ | 'top-left'
798
+ | 'top-right'
799
+ | 'left-top'
800
+ | 'left-bottom'
801
+ | 'right-top'
802
+ | 'right-bottom';
803
+ ```
804
+
805
+ - `DropdownComponent` — `hm-dropdown` (ver angular-api.md)
806
+ - `DropdownTriggerDirective` — `[hmDropdownTrigger]` (ver angular-api.md)
807
+ - `DropdownIfOpenDirective` — `[hmIfOpen]` (ver angular-api.md)
808
+ - `DropdownItemDirective` — `[hmDropdownItem]` (ver angular-api.md)
809
+ - `DropdownMenuComponent` — `hm-dropdown-menu` (ver angular-api.md)
810
+ - `const HERMES_DROPDOWN =`
811
+
812
+ ## `@trismegisto/angular/dual-list`
813
+
814
+ - `DualListSize`
815
+
816
+ ```ts
817
+ type DualListSize = 'small' | 'medium' | 'large';
818
+ ```
819
+
820
+ - `DualListComponent` — `hm-dual-list` (ver angular-api.md)
821
+
822
+ ## `@trismegisto/angular/empty`
823
+
824
+ - `EmptyAppearance` — Moldura do estado vazio: `plain` (sem moldura, padrão — o cartão em volta já desenha o limite) ou `dashed` (contorno tracejado, para uma área que vai receber conteúdo: "solte arquivos aqui").
825
+
826
+ ```ts
827
+ type EmptyAppearance = 'plain' | 'dashed';
828
+ ```
829
+
830
+ - `EmptySize` — Respiro: `medium` (padrão — cartão, painel) ou `small` (célula de tabela, coluna estreita).
831
+
832
+ ```ts
833
+ type EmptySize = 'small' | 'medium';
834
+ ```
835
+
836
+ - `EmptyHeadingLevel` — Nível de título do `heading`: `0` (padrão) não é título, só texto em destaque.
837
+
838
+ ```ts
839
+ type EmptyHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
840
+ ```
841
+
842
+ - `EmptyComponent` — `hm-empty` (ver angular-api.md)
843
+
844
+ ## `@trismegisto/angular/event-calendar`
845
+
846
+ - `EventCalendarDateClick` — O que `dateClick` emite: o dia e, quando o clique foi na grade de horas, o horário (`'HH:mm'`, em meia hora).
847
+
848
+ ```ts
849
+ interface EventCalendarDateClick {
850
+ readonly date: IsoDate;
851
+ readonly time: string | null;
852
+ }
853
+ ```
854
+
855
+ - `EventCalendarRangeChange` — O que `rangeChange` emite: o intervalo visível (fim exclusivo) e a visão — o que o app busca no servidor.
856
+
857
+ ```ts
858
+ interface EventCalendarRangeChange extends EventCalendarRange {
859
+ readonly view: EventCalendarView;
860
+ }
861
+ ```
862
+
863
+ - `EventCalendarComponent` — `hm-event-calendar` (ver angular-api.md)
864
+ - `CalendarEvent` _(de `@trismegisto/primitives`)_ — Um evento da agenda.
865
+
866
+ ```ts
867
+ interface CalendarEvent {
868
+ readonly id: string;
869
+ readonly title: string;
870
+ readonly start: Date | string;
871
+ readonly end?: Date | string | null;
872
+ readonly allDay?: boolean;
873
+ readonly color?: CalendarEventColor;
874
+ }
875
+ ```
876
+
877
+ - `CalendarEventColor` _(de `@trismegisto/primitives`)_ — Cor de categoria do evento: índice da paleta categórica validada (`--hm-data-categorical-1` a `-8`). Nunca hex — a paleta já foi medida nos dois temas e é a mesma dos gráficos e legendas.
878
+
879
+ ```ts
880
+ type CalendarEventColor = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
881
+ ```
882
+
883
+ - `EventCalendarRange` _(de `@trismegisto/primitives`)_ — Intervalo de datas, fim **exclusivo** (`{ start: '2026-10-01', end: '2026-11-01' }` = outubro).
884
+
885
+ ```ts
886
+ interface EventCalendarRange {
887
+ readonly start: IsoDate;
888
+ readonly end: IsoDate;
889
+ }
890
+ ```
891
+
892
+ - `EventCalendarView` _(de `@trismegisto/primitives`)_ — As quatro visões, na ordem do seletor.
893
+
894
+ ```ts
895
+ type EventCalendarView = 'month' | 'week' | 'day' | 'list';
896
+ ```
897
+
898
+ ## `@trismegisto/angular/fab`
899
+
900
+ - `FabPosition` — Canto (ou centro da base) onde o botão flutua. Lógico: `end` é a direita em LTR e a esquerda em RTL.
901
+
902
+ ```ts
903
+ type FabPosition = 'bottom-end' | 'bottom-start' | 'bottom-center' | 'top-end' | 'top-start';
904
+ ```
905
+
906
+ - `FabSize`
907
+
908
+ ```ts
909
+ type FabSize = 'small' | 'medium' | 'large';
910
+ ```
911
+
912
+ - `FabAction` — Ação do "speed dial": cada uma vira um `menuitem` com ícone e rótulo visível.
913
+
914
+ ```ts
915
+ interface FabAction {
916
+ readonly id: string;
917
+ readonly label: string;
918
+ readonly icon?: string;
919
+ readonly disabled?: boolean;
920
+ }
921
+ ```
922
+
923
+ - `FabComponent` — `hm-fab` (ver angular-api.md)
924
+
925
+ ## `@trismegisto/angular/field`
926
+
927
+ - `FieldType` — Depreciado desde 0.2.0 — use `InputType`.
928
+
929
+ ```ts
930
+ type FieldType = 'text' | 'password';
931
+ ```
932
+
933
+ - `FieldComponent` — `hm-field` (ver angular-api.md)
934
+
935
+ ## `@trismegisto/angular/file-upload`
936
+
937
+ - `FileUploadSize`
938
+
939
+ ```ts
940
+ type FileUploadSize = 'small' | 'medium' | 'large';
941
+ ```
942
+
943
+ - `FileUploader` — Envio opcional feito pelo próprio componente: recebe o arquivo, uma função para informar o progresso (0–100) e um `AbortSignal` (abortado quando a pessoa remove o arquivo durante o envio). Resolver = enviado; rejeitar =…
944
+
945
+ ```ts
946
+ type FileUploader = (file: File, report: (progress: number) => void, signal: AbortSignal) => Promise<unknown>;
947
+ ```
948
+
949
+ - `FileUploadComponent` — `hm-file-upload` (ver angular-api.md)
950
+
951
+ ## `@trismegisto/angular/filter-bar`
952
+
953
+ - `FilterBarComponent` — `hm-filter-bar` (ver angular-api.md)
954
+ - `FilterBarField` _(de `@trismegisto/primitives`)_ — Um campo declarado pelo app. `options` vale para `select`/`multiselect`.
955
+
956
+ ```ts
957
+ interface FilterBarField {
958
+ readonly key: string;
959
+ readonly label: string;
960
+ readonly type: FilterBarFieldType;
961
+ readonly options?: readonly ComboboxOption[];
962
+ readonly placeholder?: string;
963
+ }
964
+ ```
965
+
966
+ - `FilterBarFieldType` _(de `@trismegisto/primitives`)_
967
+
968
+ ```ts
969
+ type FilterBarFieldType = 'text' | 'select' | 'multiselect' | 'date-range' | 'boolean';
970
+ ```
971
+
972
+ - `FilterBarFieldValue` _(de `@trismegisto/primitives`)_ — Valor de um campo, por tipo: `text`/`select` → `string`; `multiselect` → `string[]`; `date-range` → `DateRange` (`{ start, end }`, AAAA-MM-DD, uma das pontas pode faltar); `boolean` → `true`/`false` (`null` = sem filtro…
973
+
974
+ ```ts
975
+ type FilterBarFieldValue = string | readonly string[] | DateRange | boolean | null;
976
+ ```
977
+
978
+ - `FilterBarStorage` _(de `@trismegisto/primitives`)_ — Onde os filtros salvos moram. Síncrono ou assíncrono (Promise) — o app troca o localStorage por uma API do servidor implementando os dois métodos. `key` é a `storageKey` da faixa.
979
+
980
+ ```ts
981
+ interface FilterBarStorage {
982
+ get(key: string): readonly SavedFilter[] | null | undefined | Promise<readonly SavedFilter[] | null | undefined>;
983
+ set(key: string, filters: readonly SavedFilter[]): void | Promise<void>;
984
+ }
985
+ ```
986
+
987
+ - `FilterBarValue` _(de `@trismegisto/primitives`)_ — Valor da faixa: só os campos ativos, por `key`.
988
+
989
+ ```ts
990
+ type FilterBarValue = Readonly<Record<string, FilterBarFieldValue>>;
991
+ ```
992
+
993
+ - `SavedFilter` _(de `@trismegisto/primitives`)_ — Uma combinação de filtros com nome. `isDefault`: aplicada sozinha ao abrir a tela.
994
+
995
+ ```ts
996
+ interface SavedFilter {
997
+ readonly id: string;
998
+ readonly name: string;
999
+ readonly value: FilterBarValue;
1000
+ readonly isDefault?: boolean;
1001
+ }
1002
+ ```
1003
+
1004
+ - `const EMPTY_FILTER_BAR_VALUE: FilterBarValue` _(de `@trismegisto/primitives`)_
1005
+ - `function applyFilterBar<T>(rows: readonly T[], fields: readonly FilterBarField[], value: FilterBarValue | null | undefined, accessor: FilterBarAccessor<T> = defaultAccessor): readonly T[]` _(de `@trismegisto/primitives`)_ — Recorta as linhas no app; sem filtro ativo devolve a MESMA lista (mesma referência).
1006
+ - `function filterBarGridUnsupported(fields: readonly FilterBarField[], value: FilterBarValue | null | undefined): readonly string[]` _(de `@trismegisto/primitives`)_ — Campos ativos que `filterBarToGridQuery` não consegue exprimir (hoje: `multiselect` com 2+ escolhas).
1007
+ - `function filterBarToGridQuery(fields: readonly FilterBarField[], value: FilterBarValue | null | undefined): GridFilterQuery` _(de `@trismegisto/primitives`)_ — Converte para o filtro composto do `hm-data-grid` (`[filterQuery]`), com `key` = `key` da coluna. `text` → contém; `select` e `multiselect` de 1 escolha → igual; `date-range` → entre (ponta que falta vira o extremo do c…
1008
+ - `function localStorageFilterBarStorage(prefix = 'hm-filter-bar:'): FilterBarStorage` _(de `@trismegisto/primitives`)_ — Armazenamento padrão: `localStorage`, uma entrada JSON por chave (`<prefix><key>`). Sem `localStorage` (SSR, navegação privada que bloqueia) vira memória e não quebra.
1009
+ - `function serializeFilterBarValue(fields: readonly FilterBarField[], value: FilterBarValue | null | undefined): string` _(de `@trismegisto/primitives`)_ — Texto estável (chaves na ordem da declaração) — serve para guardar na URL/servidor e para comparar.
1010
+ - `function parseFilterBarValue(fields: readonly FilterBarField[], text: string | null | undefined): FilterBarValue` _(de `@trismegisto/primitives`)_ — O inverso de `serializeFilterBarValue`; texto inválido devolve `{}`.
1011
+
1012
+ ## `@trismegisto/angular/floating-window`
1013
+
1014
+ - `FloatingWindowComponent` — `hm-floating-window` (ver angular-api.md)
1015
+ - `HermesOverlayStackEntry` — Uma janela registrada na pilha.
1016
+
1017
+ ```ts
1018
+ interface HermesOverlayStackEntry {
1019
+ readonly id: string;
1020
+ readonly element: () => HTMLElement | null | undefined;
1021
+ readonly focus: () => void;
1022
+ }
1023
+ ```
1024
+
1025
+ - **`HermesOverlayStack`** (classe)
1026
+
1027
+ ```ts
1028
+ class HermesOverlayStack {
1029
+ readonly order = orderState.asReadonly(…)
1030
+ register(entry: HermesOverlayStackEntry): () => void
1031
+ bringToFront(id: string): void
1032
+ layer(id: string): number
1033
+ isTop(id: string): boolean
1034
+ cycleFocus(direction: 1 | -1): boolean
1035
+ }
1036
+ ```
1037
+
1038
+ ## `@trismegisto/angular/form-required-hint`
1039
+
1040
+ - `FormRequiredHintComponent` — `hm-form-required-hint` (ver angular-api.md)
1041
+
1042
+ ## `@trismegisto/angular/forms`
1043
+
1044
+ - `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…
1045
+ - `HermesFormFieldBase` — classe base
1046
+
1047
+ ## `@trismegisto/angular/geometric-texture`
1048
+
1049
+ - `GeometricTextureComponent` — `hm-geometric-texture` (ver angular-api.md)
1050
+
1051
+ ## `@trismegisto/angular/global-search`
1052
+
1053
+ - `HermesSearchResult` — Um resultado da busca global.
1054
+
1055
+ ```ts
1056
+ interface HermesSearchResult {
1057
+ readonly id: string;
1058
+ readonly label: string;
1059
+ readonly description?: string;
1060
+ readonly icon?: string;
1061
+ readonly disabled?: boolean;
1062
+ readonly data?: unknown;
1063
+ }
1064
+ ```
1065
+
1066
+ - `HermesSearchGroup` — Os resultados de uma fonte (escopo): "Pessoas", "Servidores", "Telas"…
1067
+
1068
+ ```ts
1069
+ interface HermesSearchGroup {
1070
+ readonly id: string;
1071
+ readonly label: string;
1072
+ readonly results: readonly HermesSearchResult[];
1073
+ }
1074
+ ```
1075
+
1076
+ - `HermesSearchFn` — A consulta do app: recebe o termo e um `AbortSignal` (abortado quando o termo muda).
1077
+
1078
+ ```ts
1079
+ type HermesSearchFn = (term: string, signal: AbortSignal) => Promise<readonly HermesSearchGroup[]>;
1080
+ ```
1081
+
1082
+ - `HermesSearchSelection` — O que `(selected)` emite.
1083
+
1084
+ ```ts
1085
+ interface HermesSearchSelection {
1086
+ readonly result: HermesSearchResult;
1087
+ readonly group: HermesSearchGroup;
1088
+ }
1089
+ ```
1090
+
1091
+ - `GlobalSearchComponent` — `hm-global-search` (ver angular-api.md)
1092
+
1093
+ ## `@trismegisto/angular/header`
1094
+
1095
+ - `HeaderComponent` — `hm-header` (ver angular-api.md)
1096
+
1097
+ ## `@trismegisto/angular/i18n`
1098
+
1099
+ - `HermesI18nConfig`
1100
+
1101
+ ```ts
1102
+ interface HermesI18nConfig {
1103
+ readonly locale?: string;
1104
+ readonly base?: HermesMessages;
1105
+ readonly catalogs?: Readonly<Record<string, HermesMessages | HermesCatalogLoader>>;
1106
+ readonly override?: HermesMessagesOverride;
1107
+ }
1108
+ ```
1109
+
1110
+ - `const HERMES_I18N_CONFIG: InjectionToken<HermesI18nConfig>`
1111
+ - `HermesCatalogLoader` — Carrega um catálogo sob demanda (o `import()` vira um chunk à parte no bundle do app).
1112
+
1113
+ ```ts
1114
+ type HermesCatalogLoader = () => Promise<HermesMessages>;
1115
+ ```
1116
+
1117
+ - `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ó.
1118
+ - `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`.
1119
+ - **`HermesI18nService`** (classe)
1120
+
1121
+ ```ts
1122
+ class HermesI18nService {
1123
+ readonly locale = signal(…)
1124
+ readonly messages = computed(…)
1125
+ setLocale(locale: string): Promise<void>
1126
+ registerCatalog(locale: string, catalog: HermesMessages): void
1127
+ setOverride(override: HermesMessagesOverride): void
1128
+ format(template: string, params?: MessageParams): string
1129
+ plural(message: PluralMessage, count: number, params?: MessageParams): string
1130
+ pick<T>(byLocale: Readonly<Record<string, T>>, fallback: T): T
1131
+ }
1132
+ ```
1133
+
1134
+ - `function liveCatalog<T extends object>(source: () => T): T` — Vista viva de um catálogo de duas camadas (`seção.chave`): cada leitura (`messages.modal.close`) consulta `source()`, então um template que mostra o texto é re-renderizado quando o signal por trás muda — mesmo lendo por…
1135
+ - `const HERMES_MESSAGES: InjectionToken<HermesMessages>` — Catálogo de textos dos componentes — vista viva do `HermesI18nService` (pt-BR por padrão).
1136
+ - `function provideHermesI18n(config: HermesI18nConfig): Provider` — Configura idioma, catálogos e sobrescritas dos textos da lib.
1137
+ - `function provideHermesMessages(override: HermesMessagesOverride = {}, base: HermesMessages = HERMES_MESSAGES_PT_BR): Provider` — Atalho compatível com a 0.1.x: troca o catálogo (`base`) e/ou sobrescreve textos avulsos. Equivale a `provideHermesI18n({ base, override })`; para trocar de idioma em tempo de execução, use `HermesI18nService.setLocale`.
1138
+
1139
+ ## `@trismegisto/angular/icon`
1140
+
1141
+ - `IconSize`
1142
+
1143
+ ```ts
1144
+ type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | (string & {});
1145
+ ```
1146
+
1147
+ - `IconStatus`
1148
+
1149
+ ```ts
1150
+ type IconStatus = 'info' | 'success' | 'warning' | 'danger' | 'neutral';
1151
+ ```
1152
+
1153
+ - `IconDirection`
1154
+
1155
+ ```ts
1156
+ type IconDirection = 'up' | 'down' | 'left' | 'right';
1157
+ ```
1158
+
1159
+ - `IconFlip`
1160
+
1161
+ ```ts
1162
+ type IconFlip = 'horizontal' | 'vertical';
1163
+ ```
1164
+
1165
+ - `IconComponent` — `hm-icon` (ver angular-api.md)
1166
+ - `const ICON_ANGLE: RegisteredIcon`
1167
+ - `const ICON_ANGLE_DOUBLE: RegisteredIcon`
1168
+ - `const ICON_ARROW: RegisteredIcon`
1169
+ - `const ICON_ARROWS_HORIZONTAL: RegisteredIcon`
1170
+ - `const ICON_BOOKMARK: RegisteredIcon`
1171
+ - `const ICON_CALENDAR: RegisteredIcon`
1172
+ - `const ICON_CHECK: RegisteredIcon`
1173
+ - `const ICON_CHECK_CIRCLE: RegisteredIcon`
1174
+ - `const ICON_CHECK_DOUBLE: RegisteredIcon`
1175
+ - `const ICON_CIRCLE: RegisteredIcon`
1176
+ - `const ICON_CLOCK: RegisteredIcon`
1177
+ - `const ICON_CLOUD_UP: RegisteredIcon`
1178
+ - `const ICON_COG: RegisteredIcon`
1179
+ - `const ICON_COPY: RegisteredIcon`
1180
+ - `const ICON_DOCUMENT_CSV: RegisteredIcon`
1181
+ - `const ICON_DOCUMENT_DOC: RegisteredIcon`
1182
+ - `const ICON_DOCUMENT_IMAGE: RegisteredIcon`
1183
+ - `const ICON_DOCUMENT_PDF: RegisteredIcon`
1184
+ - `const ICON_DOCUMENTS_EXCEL: RegisteredIcon`
1185
+ - `const ICON_DOWNLOAD: RegisteredIcon`
1186
+ - `const ICON_DRAG_HANDLE: RegisteredIcon`
1187
+ - `const ICON_ELLIPSIS_HORIZONTAL: RegisteredIcon`
1188
+ - `const ICON_ELLIPSIS_VERTICAL: RegisteredIcon`
1189
+ - `const ICON_ERROR_STANDARD: RegisteredIcon`
1190
+ - `const ICON_EXCLAMATION_CIRCLE: RegisteredIcon`
1191
+ - `const ICON_EXCLAMATION_TRIANGLE: RegisteredIcon`
1192
+ - `const ICON_EYE: RegisteredIcon`
1193
+ - `const ICON_EYE_HIDE: RegisteredIcon`
1194
+ - `const ICON_FILE: RegisteredIcon`
1195
+ - `const ICON_FILE_TEXT: RegisteredIcon`
1196
+ - `const ICON_FILE_ZIP: RegisteredIcon`
1197
+ - `const ICON_FILTER_GRID: RegisteredIcon`
1198
+ - `const ICON_FILTER_GRID_CIRCLE: RegisteredIcon`
1199
+ - `const ICON_GRID: RegisteredIcon`
1200
+ - `const ICON_INFO_CIRCLE: RegisteredIcon`
1201
+ - `const ICON_KEY: RegisteredIcon`
1202
+ - `const ICON_KEYBOARD: RegisteredIcon`
1203
+ - `const ICON_LIST: RegisteredIcon`
1204
+ - `const ICON_LOGIN: RegisteredIcon`
1205
+ - `const ICON_MENU: RegisteredIcon`
1206
+ - `const ICON_MINUS: RegisteredIcon`
1207
+ - `const ICON_NODE: RegisteredIcon`
1208
+ - `const ICON_PAUSE: RegisteredIcon`
1209
+ - `const ICON_PENCIL: RegisteredIcon`
1210
+ - `const ICON_PIN: RegisteredIcon`
1211
+ - `const ICON_PLAY: RegisteredIcon`
1212
+ - `const ICON_PLUS: RegisteredIcon`
1213
+ - `const ICON_REFRESH: RegisteredIcon`
1214
+ - `const ICON_SEARCH: RegisteredIcon`
1215
+ - `const ICON_STAR: RegisteredIcon`
1216
+ - `const ICON_STEP_FORWARD_2: RegisteredIcon`
1217
+ - `const ICON_SUCCESS_STANDARD: RegisteredIcon`
1218
+ - `const ICON_TEXT: RegisteredIcon`
1219
+ - `const ICON_TIMES: RegisteredIcon`
1220
+ - `const ICON_TIMES_CIRCLE: RegisteredIcon`
1221
+ - `const ICON_TOOLS: RegisteredIcon`
1222
+ - `const ICON_TRASH: RegisteredIcon`
1223
+ - `const ICON_UNDO: RegisteredIcon`
1224
+ - `const ICON_UPLOAD: RegisteredIcon`
1225
+ - `const ICON_USER: RegisteredIcon`
1226
+ - `const ICON_VIEW_COLUMNS: RegisteredIcon`
1227
+ - `const ICON_WINDOW_MAX: RegisteredIcon`
1228
+ - `const ICON_WINDOW_MIN: RegisteredIcon`
1229
+ - `const ICON_WINDOW_RESTORE: RegisteredIcon`
1230
+ - `const HERMES_INTERNAL_ICONS: readonly RegisteredIcon[]` — Todos os ícones internos (compatibilidade). Importar este array leva TODOS para o bundle; os componentes não o usam — cada um registra só os seus (`<PASTA>_ICONS`).
1231
+ - `function provideHermesIcons(...items: (RegisteredIcon | readonly RegisteredIcon[])[]): EnvironmentProviders` — Registra ícones no bootstrap — um catálogo só, nenhum vem embutido de graça. Pro caso comum de "quero tudo": `provideHermesIcons(HERMES_ICONS)`, de `@trismegisto/icons/catalog` — não tem mais como esquecer de registrar…
1232
+ - `function provideHermesIconLoader( loader: () => Promise<RegisteredIcon | readonly RegisteredIcon[]>, ): EnvironmentProviders` — Registra ícones vindos de um carregador assíncrono, **fora do bundle inicial** — o caso do catálogo inteiro (~1,5 MB sem compressão), que vira um chunk à parte baixado logo depois do bootstrap:
1233
+ - `function useHermesIcons(icons: readonly RegisteredIcon[]): void` — Registra os ícones que um componente da lib usa por dentro — chamado num campo, no começo da classe: `readonly #icons = useHermesIcons(MODAL_ICONS);` (o conjunto vem do `icons.generated.ts` da pasta, gerado por `scripts…
1234
+
1235
+ ## `@trismegisto/angular/icon-button`
1236
+
1237
+ - `IconButtonComponent` — `hm-icon-button` (ver angular-api.md)
1238
+
1239
+ ## `@trismegisto/angular/illustration-attention`
1240
+
1241
+ - `IllustrationAttentionComponent` — `hm-illustration-attention` (ver angular-api.md)
1242
+
1243
+ ## `@trismegisto/angular/illustration-error`
1244
+
1245
+ - `IllustrationErrorComponent` — `hm-illustration-error` (ver angular-api.md)
1246
+
1247
+ ## `@trismegisto/angular/illustration-journey-end`
1248
+
1249
+ - `IllustrationJourneyEndComponent` — `hm-illustration-journey-end` (ver angular-api.md)
1250
+
1251
+ ## `@trismegisto/angular/illustration-locked`
1252
+
1253
+ - `IllustrationLockedComponent` — `hm-illustration-locked` (ver angular-api.md)
1254
+
1255
+ ## `@trismegisto/angular/illustration-no-permission`
1256
+
1257
+ - `IllustrationNoPermissionComponent` — `hm-illustration-no-permission` (ver angular-api.md)
1258
+
1259
+ ## `@trismegisto/angular/illustration-no-results`
1260
+
1261
+ - `IllustrationNoResultsComponent` — `hm-illustration-no-results` (ver angular-api.md)
1262
+
1263
+ ## `@trismegisto/angular/illustration-not-found`
1264
+
1265
+ - `IllustrationNotFoundComponent` — `hm-illustration-not-found` (ver angular-api.md)
1266
+
1267
+ ## `@trismegisto/angular/illustration-session-expired`
1268
+
1269
+ - `IllustrationSessionExpiredComponent` — `hm-illustration-session-expired` (ver angular-api.md)
1270
+
1271
+ ## `@trismegisto/angular/illustration-shared`
1272
+
1273
+ - `IllustrationIdRef` — Um id interno do SVG e as formas de referenciá-lo.
1274
+
1275
+ ```ts
1276
+ interface IllustrationIdRef {
1277
+ readonly id: string;
1278
+ readonly url: string;
1279
+ readonly href: string;
1280
+ }
1281
+ ```
1282
+
1283
+ - `function illustrationIds<const K extends string>(name: string, ...keys: readonly K[]): Readonly<Record<K, IllustrationIdRef>>` — Ids únicos por instância para os `<clipPath>`, gradientes, máscaras etc. de uma ilustração.
1284
+
1285
+ ## `@trismegisto/angular/illustration-success`
1286
+
1287
+ - `IllustrationSuccessComponent` — `hm-illustration-success` (ver angular-api.md)
1288
+
1289
+ ## `@trismegisto/angular/illustration-unlocked`
1290
+
1291
+ - `IllustrationUnlockedComponent` — `hm-illustration-unlocked` (ver angular-api.md)
1292
+
1293
+ ## `@trismegisto/angular/input`
1294
+
1295
+ - `InputType`
1296
+
1297
+ ```ts
1298
+ type InputType = 'text' | 'email' | 'tel' | 'url' | 'number' | 'search' | 'password';
1299
+ ```
1300
+
1301
+ - `InputValue` — Valor do `hm-input`: texto, ou número (`null` = vazio) quando `type="number"`.
1302
+
1303
+ ```ts
1304
+ type InputValue = string | number | null;
1305
+ ```
1306
+
1307
+ - `InputMaskValue` — `raw`: o modelo guarda só os caracteres digitados (`12345678901`); `masked`: com a pontuação.
1308
+
1309
+ ```ts
1310
+ type InputMaskValue = 'raw' | 'masked';
1311
+ ```
1312
+
1313
+ - `InputMode`
1314
+
1315
+ ```ts
1316
+ type InputMode = 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
1317
+ ```
1318
+
1319
+ - `InputComponent` — `hm-input` (ver angular-api.md)
1320
+
1321
+ ## `@trismegisto/angular/item`
1322
+
1323
+ - `HermesItemGroup` — O que o `hm-item-group` publica para os `hm-item` dentro dele. Arquivo próprio para o item não importar o grupo (nem o contrário): basta a presença do token — dentro de um grupo, o item vira `role="listitem"` (o grupo é…
1324
+
1325
+ ```ts
1326
+ interface HermesItemGroup {
1327
+ readonly kind: 'item-group';
1328
+ }
1329
+ ```
1330
+
1331
+ - `const HM_ITEM_GROUP: InjectionToken<HermesItemGroup>`
1332
+ - `ItemAppearance` — Peso visual da linha: `plain` (sem moldura, padrão), `outlined` (borda) ou `muted` (fundo suave).
1333
+
1334
+ ```ts
1335
+ type ItemAppearance = 'plain' | 'outlined' | 'muted';
1336
+ ```
1337
+
1338
+ - `ItemSize` — Respiro da linha: `medium` (padrão) ou `small` (lista densa, painel lateral).
1339
+
1340
+ ```ts
1341
+ type ItemSize = 'small' | 'medium';
1342
+ ```
1343
+
1344
+ - `ItemComponent` — `hm-item` (ver angular-api.md)
1345
+ - `ItemGroupComponent` — `hm-item-group` (ver angular-api.md)
1346
+
1347
+ ## `@trismegisto/angular/kanban`
1348
+
1349
+ - `const HERMES_KANBAN = [KanbanComponent, KanbanColumnComponent, KanbanCardDirective, KanbanColumnActionsDirective] as const` — O quadro e os templates, para um `imports: [HERMES_KANBAN]` só.
1350
+ - `KanbanCardContext` — Contexto do template de cartão (`<ng-template hmKanbanCard let-item let-column="column" let-index="index">`).
1351
+
1352
+ ```ts
1353
+ interface KanbanCardContext<T = unknown> {
1354
+ readonly $implicit: T;
1355
+ readonly column: KanbanColumn<T>;
1356
+ readonly index: number;
1357
+ }
1358
+ ```
1359
+
1360
+ - `KanbanColumnContext` — Contexto do template de ações da coluna (`<ng-template hmKanbanColumnActions let-column>`).
1361
+
1362
+ ```ts
1363
+ interface KanbanColumnContext<T = unknown> {
1364
+ readonly $implicit: KanbanColumn<T>;
1365
+ }
1366
+ ```
1367
+
1368
+ - `KanbanMoveEvent` — Um cartão mudou de lugar (`hm-kanban` → `moved`).
1369
+
1370
+ ```ts
1371
+ interface KanbanMoveEvent<T = unknown> {
1372
+ readonly item: T;
1373
+ readonly from: string;
1374
+ readonly to: string;
1375
+ readonly fromIndex: number;
1376
+ readonly toIndex: number;
1377
+ readonly via: HermesDragVia;
1378
+ readonly columns: readonly KanbanColumn<T>[];
1379
+ }
1380
+ ```
1381
+
1382
+ - `KanbanCanMove` — Regra de negócio: o cartão pode ir da coluna `from` para a `to`?
1383
+
1384
+ ```ts
1385
+ type KanbanCanMove<T = unknown> = (item: T, from: KanbanColumn<T>, to: KanbanColumn<T>) => boolean;
1386
+ ```
1387
+
1388
+ - `HermesKanbanHost` — @internal O que a coluna lê do quadro.
1389
+
1390
+ ```ts
1391
+ interface HermesKanbanHost<T = unknown> {
1392
+ readonly dragType: string;
1393
+ readonly disabled: Signal<boolean>;
1394
+ readonly collapsible: Signal<boolean>;
1395
+ readonly headingLevel: Signal<number>;
1396
+ cardTemplate(): TemplateRef<KanbanCardContext<T>> | null;
1397
+ actionsTemplate(): TemplateRef<KanbanColumnContext<T>> | null;
1398
+ isCollapsed(id: string): boolean;
1399
+ toggleCollapsed(id: string): void;
1400
+ key(item: T): unknown;
1401
+ labelOf(item: T): string;
1402
+ allows(data: unknown, type: string, to: string): boolean;
1403
+ handleSorted(to: string, event: HermesSortEvent<T>): void;
1404
+ }
1405
+ ```
1406
+
1407
+ - `const HM_KANBAN: InjectionToken<HermesKanbanHost>` — @internal
1408
+ - `KanbanComponent` — `hm-kanban` (ver angular-api.md)
1409
+ - `KanbanColumnComponent` — `hm-kanban-column` (ver angular-api.md)
1410
+ - `KanbanCardDirective` — `ng-template[hmKanbanCard]` (ver angular-api.md)
1411
+ - `KanbanColumnActionsDirective` — `ng-template[hmKanbanColumnActions]` (ver angular-api.md)
1412
+ - `KanbanColumn` _(de `@trismegisto/primitives`)_ — Uma coluna do quadro. `items` na ordem de exibição; `limit` é o limite WIP (opcional).
1413
+
1414
+ ```ts
1415
+ interface KanbanColumn<T = unknown> {
1416
+ readonly id: string;
1417
+ readonly title: string;
1418
+ readonly items: readonly T[];
1419
+ readonly limit?: number | null;
1420
+ }
1421
+ ```
1422
+
1423
+ - `KanbanMove` _(de `@trismegisto/primitives`)_ — Um movimento de cartão: de qual coluna/posição para qual coluna/posição.
1424
+
1425
+ ```ts
1426
+ interface KanbanMove {
1427
+ readonly from: string;
1428
+ readonly to: string;
1429
+ readonly fromIndex: number;
1430
+ readonly toIndex: number;
1431
+ }
1432
+ ```
1433
+
1434
+ - `KanbanWipState` _(de `@trismegisto/primitives`)_ — Estado do limite WIP: `none` (sem limite), `under` (abaixo), `at` (no limite — próximo cartão estoura) e `over` (acima).
1435
+
1436
+ ```ts
1437
+ type KanbanWipState = 'none' | 'under' | 'at' | 'over';
1438
+ ```
1439
+
1440
+ ## `@trismegisto/angular/legend`
1441
+
1442
+ - `LegendIntent`
1443
+
1444
+ ```ts
1445
+ type LegendIntent = 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'neutral';
1446
+ ```
1447
+
1448
+ - `LegendOrientation`
1449
+
1450
+ ```ts
1451
+ type LegendOrientation = 'horizontal' | 'vertical';
1452
+ ```
1453
+
1454
+ - `LegendMarker`
1455
+
1456
+ ```ts
1457
+ type LegendMarker = 'dot' | 'square' | 'line';
1458
+ ```
1459
+
1460
+ - `LegendItem` — Um item da legenda.
1461
+
1462
+ ```ts
1463
+ interface LegendItem {
1464
+ readonly label: string;
1465
+ readonly intent?: LegendIntent;
1466
+ readonly color?: string;
1467
+ readonly value?: string | number;
1468
+ readonly description?: string;
1469
+ }
1470
+ ```
1471
+
1472
+ - `LegendComponent` — `hm-legend` (ver angular-api.md)
1473
+
1474
+ ## `@trismegisto/angular/loading-square`
1475
+
1476
+ - `LoadingSquareComponent` — `hm-loading-square` (ver angular-api.md)
1477
+
1478
+ ## `@trismegisto/angular/menu`
1479
+
1480
+ - `ContextMenuDirective` — `[hmContextMenu]` (ver angular-api.md)
1481
+ - `MenuComponent` — `hm-menu` (ver angular-api.md)
1482
+
1483
+ ## `@trismegisto/angular/menu-button`
1484
+
1485
+ - `MenuButtonSize`
1486
+
1487
+ ```ts
1488
+ type MenuButtonSize = 'small' | 'medium' | 'large';
1489
+ ```
1490
+
1491
+ - `MenuButtonComponent` — `hm-menu-button` (ver angular-api.md)
1492
+
1493
+ ## `@trismegisto/angular/menubar`
1494
+
1495
+ - `MenubarMenu` — Um menu da barra: o título (gatilho) e os itens do `hm-menu` que ele abre.
1496
+
1497
+ ```ts
1498
+ interface MenubarMenu {
1499
+ readonly id: string;
1500
+ readonly label: string;
1501
+ readonly items: readonly MenuItem[];
1502
+ readonly disabled?: boolean;
1503
+ }
1504
+ ```
1505
+
1506
+ - `MenubarComponent` — `hm-menubar` (ver angular-api.md)
1507
+
1508
+ ## `@trismegisto/angular/message`
1509
+
1510
+ - `MessageAlign` — Lado da mensagem: `start` = recebida (outra pessoa, assistente), `end` = enviada por quem lê.
1511
+
1512
+ ```ts
1513
+ type MessageAlign = 'start' | 'end';
1514
+ ```
1515
+
1516
+ - `MessageStatus` — Estado de envio, mostrado no rodapé (normalmente só nas mensagens `end`).
1517
+
1518
+ ```ts
1519
+ type MessageStatus = 'sending' | 'sent' | 'delivered' | 'read' | 'failed';
1520
+ ```
1521
+
1522
+ - `MessageContext` — O que um `hm-bubble` dentro de um `hm-message` lê do pai (lado e autor).
1523
+
1524
+ ```ts
1525
+ interface MessageContext {
1526
+ readonly align: Signal<MessageAlign>;
1527
+ readonly author: Signal<string>;
1528
+ }
1529
+ ```
1530
+
1531
+ - `const HM_MESSAGE: InjectionToken<MessageContext>` — Token pelo qual o `hm-bubble` encontra o `hm-message` em volta, sem importar a classe.
1532
+ - `MessageComponent` — `hm-message` (ver angular-api.md)
1533
+
1534
+ ## `@trismegisto/angular/message-divider`
1535
+
1536
+ - `MessageDividerVariant` — `separator`: texto centralizado entre dois traços — a quebra de data ("Hoje", "Ontem") ou de sessão ("Nova conversa"). `inline`: ícone e texto alinhados ao começo, sem traço — o evento no meio do fluxo ("Ana entrou na c…
1537
+
1538
+ ```ts
1539
+ type MessageDividerVariant = 'separator' | 'inline';
1540
+ ```
1541
+
1542
+ - `MessageDividerComponent` — `hm-message-divider` (ver angular-api.md)
1543
+
1544
+ ## `@trismegisto/angular/message-scroller`
1545
+
1546
+ - `MessageScrollerLive` — `polite`: o componente anuncia as mensagens que chegam; `off`: o app cuida do anúncio (ou não quer).
1547
+
1548
+ ```ts
1549
+ type MessageScrollerLive = 'polite' | 'off';
1550
+ ```
1551
+
1552
+ - `MessageScrollerComponent` — `hm-message-scroller` (ver angular-api.md)
1553
+
1554
+ ## `@trismegisto/angular/modal`
1555
+
1556
+ - `ModalComponent` — `hm-modal` (ver angular-api.md)
1557
+
1558
+ ## `@trismegisto/angular/motion`
1559
+
1560
+ - `AnimatedNumberComponent` — `hm-animated-number` (ver angular-api.md)
1561
+ - `FlipDirective` — `[hmFlip]` (ver angular-api.md)
1562
+ - `RevealDirective` — `[hmReveal]` (ver angular-api.md)
1563
+
1564
+ ## `@trismegisto/angular/navigation-menu`
1565
+
1566
+ - **`HermesNavigationMenu`** (classe) — Contrato que `hm-navigation-menu` publica por injeção para os itens e links dentro dele.
1567
+
1568
+ ```ts
1569
+ abstract class HermesNavigationMenu {
1570
+ }
1571
+ ```
1572
+
1573
+ - `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.
1574
+ - `NavigationMenuComponent` — `hm-navigation-menu` (ver angular-api.md)
1575
+ - `NavigationMenuItemComponent` — `hm-navigation-menu-item` (ver angular-api.md)
1576
+ - `NavigationMenuLinkComponent` — `hm-navigation-menu-link` (ver angular-api.md)
1577
+
1578
+ ## `@trismegisto/angular/opening-scene`
1579
+
1580
+ - `OpeningSceneComponent` — `hm-opening-scene` (ver angular-api.md)
1581
+
1582
+ ## `@trismegisto/angular/page-header`
1583
+
1584
+ - `PageHeaderLevel`
1585
+
1586
+ ```ts
1587
+ type PageHeaderLevel = 1 | 2 | 3 | 4 | 5 | 6;
1588
+ ```
1589
+
1590
+ - `PageHeaderComponent` — `hm-page-header` (ver angular-api.md)
1591
+
1592
+ ## `@trismegisto/angular/paginator`
1593
+
1594
+ - `PaginatorVariant` — `full`: pontas, números e itens por página. `simple`: só anterior/próxima (+ "Página X").
1595
+
1596
+ ```ts
1597
+ type PaginatorVariant = 'full' | 'simple';
1598
+ ```
1599
+
1600
+ - `PaginatorComponent` — `hm-paginator` (ver angular-api.md)
1601
+
1602
+ ## `@trismegisto/angular/pipes`
1603
+
1604
+ - `HermesDatePreset` — Presets: os estilos do próprio `Intl` (`dateStyle`/`timeStyle`) — curto, médio, longo e completo.
1605
+
1606
+ ```ts
1607
+ type HermesDatePreset = 'short' | 'medium' | 'long' | 'full';
1608
+ ```
1609
+
1610
+ - `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 `''`.
1611
+
1612
+ ```ts
1613
+ type HermesDateInput = Date | number | string | null | undefined;
1614
+ ```
1615
+
1616
+ - `HermesDateKind`
1617
+
1618
+ ```ts
1619
+ type HermesDateKind = 'date' | 'dateTime';
1620
+ ```
1621
+
1622
+ - `function toHermesDate(value: HermesDateInput): Date | null` — `HermesDateInput` → `Date` válida, ou `null`.
1623
+ - `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…
1624
+ - `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 → `''`.
1625
+ - `HermesDatePipe` — `| hmDate` (ver angular-api.md)
1626
+ - `HermesDateTimePipe` — `| hmDateTime` (ver angular-api.md)
1627
+ - `HermesTranslatePipe` — `| hmTranslate` (ver angular-api.md)
1628
+ - `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…
1629
+
1630
+ ## `@trismegisto/angular/popover`
1631
+
1632
+ - `PopoverTriggerDirective` — `[hmPopoverTrigger]` (ver angular-api.md)
1633
+ - `PopoverComponent` — `hm-popover` (ver angular-api.md)
1634
+
1635
+ ## `@trismegisto/angular/progress`
1636
+
1637
+ - `ProgressIntent`
1638
+
1639
+ ```ts
1640
+ type ProgressIntent = 'accent' | 'success' | 'warning' | 'danger';
1641
+ ```
1642
+
1643
+ - `ProgressSize`
1644
+
1645
+ ```ts
1646
+ type ProgressSize = 'small' | 'medium' | 'large';
1647
+ ```
1648
+
1649
+ - `ProgressComponent` — `hm-progress` (ver angular-api.md)
1650
+
1651
+ ## `@trismegisto/angular/property-view`
1652
+
1653
+ - `PropertyChangeEvent` — Uma propriedade mudou pela edição inline (`hm-property-view` → `propertyChange`).
1654
+
1655
+ ```ts
1656
+ interface PropertyChangeEvent {
1657
+ readonly key: string;
1658
+ readonly value: unknown;
1659
+ readonly previous: unknown;
1660
+ readonly values: PropertyValues;
1661
+ readonly error: string | null;
1662
+ }
1663
+ ```
1664
+
1665
+ - `PropertyViewComponent` — `hm-property-view` (ver angular-api.md)
1666
+ - `PropertyDefinition` _(de `@trismegisto/primitives`)_ — Uma propriedade (linha da grade).
1667
+
1668
+ ```ts
1669
+ interface PropertyDefinition {
1670
+ readonly key: string;
1671
+ readonly label: string;
1672
+ readonly type?: PropertyType;
1673
+ readonly group?: string;
1674
+ readonly editable?: boolean;
1675
+ readonly options?: readonly PropertyOption[];
1676
+ readonly hint?: string;
1677
+ readonly required?: boolean;
1678
+ readonly min?: number | string | null;
1679
+ readonly max?: number | string | null;
1680
+ readonly validate?: (value: unknown, values: PropertyValues) => string | null;
1681
+ readonly format?: (value: unknown, values: PropertyValues) => string;
1682
+ }
1683
+ ```
1684
+
1685
+ - `PropertyGroup` _(de `@trismegisto/primitives`)_ — Um grupo (seção recolhível). A ordem de `groups` é a ordem na tela.
1686
+
1687
+ ```ts
1688
+ interface PropertyGroup {
1689
+ readonly id: string;
1690
+ readonly label: string;
1691
+ readonly collapsed?: boolean;
1692
+ }
1693
+ ```
1694
+
1695
+ - `PropertyOption` _(de `@trismegisto/primitives`)_ — Opção de uma propriedade `select`.
1696
+
1697
+ ```ts
1698
+ interface PropertyOption {
1699
+ readonly value: string;
1700
+ readonly label: string;
1701
+ }
1702
+ ```
1703
+
1704
+ - `PropertyType` _(de `@trismegisto/primitives`)_ — Tipo do valor: decide o editor (texto, número, interruptor, seleção, data) e a exibição.
1705
+
1706
+ ```ts
1707
+ type PropertyType = 'text' | 'number' | 'boolean' | 'select' | 'date';
1708
+ ```
1709
+
1710
+ - `PropertyValues` _(de `@trismegisto/primitives`)_ — Valores da grade: chave da propriedade → valor.
1711
+
1712
+ ```ts
1713
+ type PropertyValues = Readonly<Record<string, unknown>>;
1714
+ ```
1715
+
1716
+ ## `@trismegisto/angular/radio`
1717
+
1718
+ - `RadioOption`
1719
+
1720
+ ```ts
1721
+ interface RadioOption {
1722
+ readonly value: string;
1723
+ readonly label: string;
1724
+ readonly description?: string;
1725
+ readonly icon?: string;
1726
+ readonly danger?: boolean;
1727
+ readonly disabled?: boolean;
1728
+ readonly disabledReason?: string;
1729
+ }
1730
+ ```
1731
+
1732
+ - `RadioAppearance` — Desenho do grupo: lista de rádios (padrão) ou cartões clicáveis (opção explicada, com ícone).
1733
+
1734
+ ```ts
1735
+ type RadioAppearance = 'list' | 'card';
1736
+ ```
1737
+
1738
+ - `RadioLayout` — Disposição das opções: `'stacked'` (padrão, uma por linha) ou `'inline'` (lado a lado, quebrando linha sem espaço).
1739
+
1740
+ ```ts
1741
+ type RadioLayout = 'stacked' | 'inline';
1742
+ ```
1743
+
1744
+ - `RadioComponent` — `hm-radio` (ver angular-api.md)
1745
+
1746
+ ## `@trismegisto/angular/reorder-list`
1747
+
1748
+ - `ReorderListItem` — Um item da lista ordenável.
1749
+
1750
+ ```ts
1751
+ interface ReorderListItem {
1752
+ readonly id: string;
1753
+ readonly label: string;
1754
+ readonly description?: string;
1755
+ }
1756
+ ```
1757
+
1758
+ - `ReorderListSize`
1759
+
1760
+ ```ts
1761
+ type ReorderListSize = 'small' | 'medium' | 'large';
1762
+ ```
1763
+
1764
+ - `ReorderListMove` — Movimento concluído (soltou num lugar diferente de onde pegou).
1765
+
1766
+ ```ts
1767
+ interface ReorderListMove {
1768
+ readonly item: ReorderListItem;
1769
+ readonly from: number;
1770
+ readonly to: number;
1771
+ }
1772
+ ```
1773
+
1774
+ - `ReorderListRemoval` — Item removido pelo botão de remover (`removable`): o item e a posição que ocupava (a partir de 0).
1775
+
1776
+ ```ts
1777
+ interface ReorderListRemoval {
1778
+ readonly item: ReorderListItem;
1779
+ readonly index: number;
1780
+ }
1781
+ ```
1782
+
1783
+ - `ReorderListItemContext` — Contexto do template de item (`<ng-template let-item let-index="index">`).
1784
+
1785
+ ```ts
1786
+ interface ReorderListItemContext {
1787
+ readonly $implicit: ReorderListItem;
1788
+ readonly index: number;
1789
+ }
1790
+ ```
1791
+
1792
+ - `ReorderListComponent` — `hm-reorder-list` (ver angular-api.md)
1793
+
1794
+ ## `@trismegisto/angular/search-field`
1795
+
1796
+ - `SearchFieldSize`
1797
+
1798
+ ```ts
1799
+ type SearchFieldSize = 'small' | 'medium' | 'large';
1800
+ ```
1801
+
1802
+ - `SearchFieldComponent` — `hm-search-field` (ver angular-api.md)
1803
+
1804
+ ## `@trismegisto/angular/segmented-control`
1805
+
1806
+ - `SegmentedOption` — Uma opção do `hm-segmented-control`.
1807
+
1808
+ ```ts
1809
+ interface SegmentedOption<T extends string = string> {
1810
+ value: T;
1811
+ label: string;
1812
+ icon?: string;
1813
+ disabled?: boolean;
1814
+ }
1815
+ ```
1816
+
1817
+ - `SegmentedControlSize` — Altura do controle — mesmo trilho do `hm-button`.
1818
+
1819
+ ```ts
1820
+ type SegmentedControlSize = 'small' | 'medium' | 'large';
1821
+ ```
1822
+
1823
+ - `SegmentedControlEmphasis` — Peso da opção marcada: `subtle` (superfície elevada, padrão — escolha de exibição) ou `action` (cor de ação, como um `hm-button` primário — filtro/ambiente que muda o que a tela mostra).
1824
+
1825
+ ```ts
1826
+ type SegmentedControlEmphasis = 'subtle' | 'action';
1827
+ ```
1828
+
1829
+ - `SegmentedControlComponent` — `hm-segmented-control` (ver angular-api.md)
1830
+
1831
+ ## `@trismegisto/angular/select`
1832
+
1833
+ - `SelectComponent` — `hm-select` (ver angular-api.md)
1834
+
1835
+ ## `@trismegisto/angular/session-recovery`
1836
+
1837
+ - `SessionRecoveryComponent` — `hm-session-recovery` (ver angular-api.md)
1838
+
1839
+ ## `@trismegisto/angular/settings`
1840
+
1841
+ - `SettingsDialogComponent` — `hm-settings-dialog` (ver angular-api.md)
1842
+ - `SettingsRowComponent` — `hm-settings-row` (ver angular-api.md)
1843
+ - `SettingsSectionComponent` — `hm-settings-section` (ver angular-api.md)
1844
+ - `SettingsDialogContext` — O que `hm-settings-section`/`hm-settings-row` precisam saber do diálogo em volta. Token (e não o componente) para os três arquivos não se importarem em ciclo.
1845
+
1846
+ ```ts
1847
+ interface SettingsDialogContext {
1848
+ readonly query: Signal<string>;
1849
+ readonly activeKey: Signal<string>;
1850
+ readonly attempted: Signal<boolean>;
1851
+ }
1852
+ ```
1853
+
1854
+ - `HermesSettingsCloseHandler` — OK/Cancelar do modo formulário do `hm-settings-dialog`. Cada função devolve se a janela pode fechar — síncrona ou `Promise`, e enquanto a `Promise` não resolve o botão carrega e a janela trava. - `onSubmit`: chamado no…
1855
+
1856
+ ```ts
1857
+ interface HermesSettingsCloseHandler {
1858
+ readonly onSubmit?: () => boolean | Promise<boolean>;
1859
+ readonly onCancel?: () => boolean | Promise<boolean>;
1860
+ }
1861
+ ```
1862
+
1863
+ - `SettingsSectionContext`
1864
+
1865
+ ```ts
1866
+ interface SettingsSectionContext {
1867
+ readonly matchesSelf: Signal<boolean>;
1868
+ }
1869
+ ```
1870
+
1871
+ - `const SETTINGS_DIALOG: InjectionToken<SettingsDialogContext>`
1872
+ - `const SETTINGS_SECTION: InjectionToken<SettingsSectionContext>`
1873
+ - `function normalizeSettingsText(text: string): string` — Minúsculo e sem acento: "Aparência" casa com "aparencia".
1874
+ - `function settingsTextMatches(query: string, ...texts: string[]): boolean` — Todas as palavras da busca aparecem no texto (em qualquer ordem).
1875
+
1876
+ ## `@trismegisto/angular/shortcut-list`
1877
+
1878
+ - `ShortcutListComponent` — `hm-shortcut-list` (ver angular-api.md)
1879
+ - `ShortcutAction` — O que o atalho faz com o elemento: `auto` foca campo editável e clica no resto.
1880
+
1881
+ ```ts
1882
+ type ShortcutAction = 'auto' | 'click' | 'focus' | 'none';
1883
+ ```
1884
+
1885
+ - `ShortcutDirective` — `[hmShortcut]` (ver angular-api.md)
1886
+ - `HermesShortcutConfig`
1887
+
1888
+ ```ts
1889
+ interface HermesShortcutConfig {
1890
+ readonly platform?: ShortcutPlatform;
1891
+ readonly sequenceTimeout?: number;
1892
+ readonly characterKeys?: boolean;
1893
+ readonly groupOrder?: readonly string[];
1894
+ }
1895
+ ```
1896
+
1897
+ - `const HERMES_SHORTCUT_CONFIG: InjectionToken<HermesShortcutConfig>`
1898
+ - `function provideHermesShortcuts(config: HermesShortcutConfig): Provider` — Configura o `HermesShortcutService` (plataforma, tempo de sequência, tecla única ligada ou não).
1899
+ - `HermesShortcut` — Um atalho registrado no serviço.
1900
+
1901
+ ```ts
1902
+ interface HermesShortcut extends ShortcutDefinition {
1903
+ readonly description: string;
1904
+ readonly handler: (event: KeyboardEvent) => void | boolean;
1905
+ readonly preventDefault?: boolean;
1906
+ }
1907
+ ```
1908
+
1909
+ - `HermesShortcutItem` — Um atalho como o painel lista (registrado ou só declarado).
1910
+
1911
+ ```ts
1912
+ interface HermesShortcutItem {
1913
+ readonly keys: string | readonly string[];
1914
+ readonly description: string;
1915
+ readonly group?: string;
1916
+ }
1917
+ ```
1918
+
1919
+ - **`HermesShortcutService`** (classe)
1920
+
1921
+ ```ts
1922
+ class HermesShortcutService {
1923
+ readonly platform: ShortcutPlatform
1924
+ readonly groupOrder: readonly string[]
1925
+ readonly characterKeys = characterKeysState.asReadonly(…)
1926
+ readonly list = computed(…)
1927
+ register(shortcut: HermesShortcut): () => void
1928
+ setCharacterKeys(enabled: boolean): void
1929
+ groupName(group: string | undefined): string
1930
+ format(keys: string | readonly string[]): ShortcutDisplay[]
1931
+ ariaKeyShortcuts(keys: string | readonly string[]): string
1932
+ dispatch(event: KeyboardEvent): void
1933
+ }
1934
+ ```
1935
+
1936
+ ## `@trismegisto/angular/sidebar`
1937
+
1938
+ - `SidebarGroupComponent` — `hm-sidebar-group` (ver angular-api.md)
1939
+ - **`HermesSidebarGroup`** (classe) — Contrato que `hm-sidebar-group` publica por injeção para o que está dentro dele (`hm-sidebar-link` e grupos aninhados). Em arquivo próprio para não fechar um ciclo de importação entre o link e o grupo.
1940
+
1941
+ ```ts
1942
+ abstract class HermesSidebarGroup {
1943
+ }
1944
+ ```
1945
+
1946
+ - `SidebarLinkComponent` — `hm-sidebar-link` (ver angular-api.md)
1947
+ - `SidebarNode` — Um nó da árvore de navegação que o `hm-sidebar-node` sabe desenhar. Genérico: não conhece rota nem domínio.
1948
+
1949
+ ```ts
1950
+ interface SidebarNode {
1951
+ id: string;
1952
+ label: string;
1953
+ icon?: string;
1954
+ route: string | readonly unknown[];
1955
+ children?: readonly SidebarNode[];
1956
+ hidden?: boolean;
1957
+ }
1958
+ ```
1959
+
1960
+ - `SidebarNodeComponent` — `hm-sidebar-node` (ver angular-api.md)
1961
+ - `SidebarComponent` — `hm-sidebar` (ver angular-api.md)
1962
+ - `const HERMES_SIDEBAR_CONFIG = new InjectionToken<Pick<SidebarStoreOptions, 'storageKey' | 'defaultMode'>>`
1963
+ - **`HermesSidebarService`** (classe)
1964
+
1965
+ ```ts
1966
+ class HermesSidebarService {
1967
+ readonly mode = computed(…)
1968
+ readonly expanded = computed(…)
1969
+ readonly collapsed = computed(…)
1970
+ readonly overlaid = computed(…)
1971
+ readonly mobileOpen = computed(…)
1972
+ readonly groups = computed(…)
1973
+ setMode(mode: SidebarMode): void { this.store.setMode(mode); }
1974
+ peekPointer(inside: boolean): void { this.store.peekPointer(inside); }
1975
+ peekFocus(inside: boolean): void { this.store.peekFocus(inside); }
1976
+ toggleMobile(): void { this.store.toggleMobile(); }
1977
+ closeMobile(): void { this.store.closeMobile(); }
1978
+ ensureExpanded(): void { this.store.ensureExpanded(); }
1979
+ isGroupOpen(id: string, byDefault: boolean): boolean
1980
+ setGroupOpen(id: string, open: boolean): void { this.store.setGroupOpen(id, open); }
1981
+ resetGroups(): void { this.store.resetGroups(); }
1982
+ registerGroup(id: string): void { this.store.registerGroup(id); }
1983
+ unregisterGroup(id: string): void { this.store.unregisterGroup(id); }
1984
+ setAllGroups(open: boolean): void { this.store.setAllGroups(open); }
1985
+ get doc(): Document { return this.document; }
1986
+ }
1987
+ ```
1988
+
1989
+ ## `@trismegisto/angular/skeleton`
1990
+
1991
+ - `SkeletonComponent` — `hm-skeleton` (ver angular-api.md)
1992
+
1993
+ ## `@trismegisto/angular/slider`
1994
+
1995
+ - `SliderModelValue`
1996
+
1997
+ ```ts
1998
+ type SliderModelValue = number | SliderRangeValue | null;
1999
+ ```
2000
+
2001
+ - `SliderOrientation`
2002
+
2003
+ ```ts
2004
+ type SliderOrientation = 'horizontal' | 'vertical';
2005
+ ```
2006
+
2007
+ - `SliderSize`
2008
+
2009
+ ```ts
2010
+ type SliderSize = 'small' | 'medium' | 'large';
2011
+ ```
2012
+
2013
+ - `SliderTooltip` — Balão com o valor sobre o polegar: `auto` (ao passar o mouse, focar ou arrastar), sempre ou nunca.
2014
+
2015
+ ```ts
2016
+ type SliderTooltip = 'auto' | 'always' | 'never';
2017
+ ```
2018
+
2019
+ - `SliderComponent` — `hm-slider` (ver angular-api.md)
2020
+
2021
+ ## `@trismegisto/angular/spinner`
2022
+
2023
+ - `SpinnerSize`
2024
+
2025
+ ```ts
2026
+ type SpinnerSize = 'small' | 'medium' | 'large';
2027
+ ```
2028
+
2029
+ - `SpinnerComponent` — `hm-spinner` (ver angular-api.md)
2030
+
2031
+ ## `@trismegisto/angular/splitter`
2032
+
2033
+ - `SplitterPanelComponent` — `hm-splitter-panel` (ver angular-api.md)
2034
+ - `SplitterComponent` — `hm-splitter` (ver angular-api.md)
2035
+
2036
+ ## `@trismegisto/angular/stat-card`
2037
+
2038
+ - `StatCardSize` — Escala de tamanho do cartão: muda o destaque do valor, o disco do ícone e o respiro.
2039
+
2040
+ ```ts
2041
+ type StatCardSize = 'small' | 'medium' | 'large';
2042
+ ```
2043
+
2044
+ - `StatCardDetail` — Um fragmento do detalhamento (`23 MPLS`, `19 Internet`), com um ponto colorido opcional.
2045
+
2046
+ ```ts
2047
+ interface StatCardDetail {
2048
+ readonly text: string;
2049
+ readonly intent?: IconStatus;
2050
+ }
2051
+ ```
2052
+
2053
+ - `StatCardTrendDirection` — Direção da variação. A seta e o texto lido pelo leitor de tela vêm dela.
2054
+
2055
+ ```ts
2056
+ type StatCardTrendDirection = 'up' | 'down' | 'flat';
2057
+ ```
2058
+
2059
+ - `StatCardTrend` — Variação do número em relação a um período (`+8%` em relação à semana passada). A direção (alta/queda) não diz se é bom ou ruim — isso é `intent`: alta de incidentes é `danger`.
2060
+
2061
+ ```ts
2062
+ interface StatCardTrend {
2063
+ readonly value: string;
2064
+ readonly direction: StatCardTrendDirection;
2065
+ readonly intent?: IconStatus;
2066
+ readonly label?: string;
2067
+ }
2068
+ ```
2069
+
2070
+ - `StatCardComponent` — `hm-stat-card` (ver angular-api.md)
2071
+
2072
+ ## `@trismegisto/angular/stat-group`
2073
+
2074
+ - `StatGroupMetric` — Uma métrica do grupo: `{ label: 'Concluídos', value: '28', caption: 'hoje' }`.
2075
+
2076
+ ```ts
2077
+ interface StatGroupMetric {
2078
+ readonly label: string;
2079
+ readonly value: number | string;
2080
+ readonly caption?: string;
2081
+ readonly intent?: IconStatus;
2082
+ }
2083
+ ```
2084
+
2085
+ - `StatGroupComponent` — `hm-stat-group` (ver angular-api.md)
2086
+
2087
+ ## `@trismegisto/angular/state-page`
2088
+
2089
+ - `StatePageKind` — As páginas prontas. Cada uma é um `hm-state-screen` com texto, ilustração e ação definidos.
2090
+
2091
+ ```ts
2092
+ type StatePageKind =
2093
+ | 'not-found'
2094
+ | 'no-content'
2095
+ | 'no-rights'
2096
+ | 'no-results'
2097
+ | 'session-expired'
2098
+ | 'logged-out'
2099
+ | 'error'
2100
+ | 'blocked'
2101
+ | 'outdated';
2102
+ ```
2103
+
2104
+ - `StatePageVisual` — O que não é texto em cada página: a situação (que escolhe a ilustração) e o ícone da ação.
2105
+
2106
+ ```ts
2107
+ interface StatePageVisual {
2108
+ readonly situation: StateScreenSituation;
2109
+ readonly actionIcon: string;
2110
+ }
2111
+ ```
2112
+
2113
+ - `StatePagePreset` — Página resolvida: o visual mais os textos do catálogo (`HERMES_MESSAGES.statePage[kind]`).
2114
+
2115
+ ```ts
2116
+ interface StatePagePreset extends StatePageVisual {
2117
+ readonly heading: string;
2118
+ readonly description: string;
2119
+ readonly action: string;
2120
+ }
2121
+ ```
2122
+
2123
+ - `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`.
2124
+ - `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…
2125
+ - `const STATE_PAGE_PRESETS: Readonly<Record<StatePageKind, StatePagePreset>>` — Depreciado Fixo em pt-BR e não acompanha `setLocale` — use `statePagePreset(kind, messages)` (com o `HERMES_MESSAGES` injetado) ou `STATE_PAGE_VISUALS` para só a situação/ícone. Mantido para quem lia `STATE_PAGE_PRESETS…
2126
+ - `StatePageComponent` — `hm-state-page` (ver angular-api.md)
2127
+
2128
+ ## `@trismegisto/angular/state-screen`
2129
+
2130
+ - `StateScreenSituation` — As situações de feedback que a tela cobre. O nome descreve o **estado da tela**, não a ilustração: quem escolhe o desenho é a situação.
2131
+
2132
+ ```ts
2133
+ type StateScreenSituation =
2134
+ | 'empty'
2135
+ | 'success'
2136
+ | 'error'
2137
+ | 'attention'
2138
+ | 'done'
2139
+ | 'locked'
2140
+ | 'unlocked'
2141
+ | 'forbidden'
2142
+ | 'not-found'
2143
+ | 'session-expired';
2144
+ ```
2145
+
2146
+ - `StateScreenComponent` — `hm-state-screen` (ver angular-api.md)
2147
+
2148
+ ## `@trismegisto/angular/stepper`
2149
+
2150
+ - `HermesStepGuard` — Pergunta assíncrona ou síncrona "a etapa pode avançar?", feita ao clicar em Avançar.
2151
+
2152
+ ```ts
2153
+ type HermesStepGuard = () => boolean | Promise<boolean>;
2154
+ ```
2155
+
2156
+ - `HermesStepSummaryEntry` — Um par termo/valor do resumo de uma etapa (o mesmo formato do `[items]` do `hm-description-list`).
2157
+
2158
+ ```ts
2159
+ interface HermesStepSummaryEntry {
2160
+ readonly term: string;
2161
+ readonly value?: string | number | null;
2162
+ }
2163
+ ```
2164
+
2165
+ - `HermesStepSummary` — O que a etapa coletou, para a página de resumo do `hm-wizard` (`summary`): um template (conteúdo livre) ou uma função que devolve os pares termo/valor — chamada na hora em que o resumo aparece, com os valores atuais do…
2166
+
2167
+ ```ts
2168
+ type HermesStepSummary = TemplateRef<unknown> | (() => readonly HermesStepSummaryEntry[]);
2169
+ ```
2170
+
2171
+ - `StepComponent` — `hm-step` (ver angular-api.md)
2172
+ - `StepperOrientation`
2173
+
2174
+ ```ts
2175
+ type StepperOrientation = 'horizontal' | 'vertical';
2176
+ ```
2177
+
2178
+ - `StepperComponent` — `hm-stepper` (ver angular-api.md)
2179
+ - **`HermesStepGroup`** (classe) — Contrato que `hm-stepper` (e `hm-wizard`, que delega ao stepper interno) publica por injeção para os `hm-step` dentro dele.
2180
+
2181
+ ```ts
2182
+ abstract class HermesStepGroup {
2183
+ }
2184
+ ```
2185
+
2186
+ ## `@trismegisto/angular/switch`
2187
+
2188
+ - `SwitchLabelPosition` — De que lado do controle o rótulo fica.
2189
+
2190
+ ```ts
2191
+ type SwitchLabelPosition = 'before' | 'after';
2192
+ ```
2193
+
2194
+ - `SwitchComponent` — `hm-switch` (ver angular-api.md)
2195
+
2196
+ ## `@trismegisto/angular/tab-bar`
2197
+
2198
+ - `TabDragData` — Dados de uma aba em arrasto (o `data()` do item no serviço de arrastar e soltar, tipo `TAB_DRAG_TYPE`).
2199
+
2200
+ ```ts
2201
+ interface TabDragData {
2202
+ readonly id: string;
2203
+ readonly label: string;
2204
+ readonly group: unknown;
2205
+ }
2206
+ ```
2207
+
2208
+ - `TabReceivedEvent` — Aba de outra fileira do mesmo `tabGroup` solta nesta (`tabReceived`).
2209
+
2210
+ ```ts
2211
+ interface TabReceivedEvent {
2212
+ readonly id: string;
2213
+ readonly index: number;
2214
+ readonly via: HermesDragVia;
2215
+ }
2216
+ ```
2217
+
2218
+ - `TabBarComponent` — `hm-tab-bar` (ver angular-api.md)
2219
+ - `TabItem` _(de `@trismegisto/primitives`)_ — Barra de abas "de navegador" (SDD): escolher, fechar, reordenar e arrastar para fora. Sem framework — a lógica de teclado, arrasto e o estado das abas abertas, que qualquer wrapper (Angular, React) usa do mesmo jeito.
2220
+
2221
+ ```ts
2222
+ interface TabItem {
2223
+ readonly id: string;
2224
+ readonly label: string;
2225
+ readonly icon?: string;
2226
+ readonly pinned?: boolean;
2227
+ }
2228
+ ```
2229
+
2230
+ ## `@trismegisto/angular/tabs`
2231
+
2232
+ - `TabComponent` — `hm-tab` (ver angular-api.md)
2233
+ - `TabsComponent` — `hm-tabs` (ver angular-api.md)
2234
+ - **`HermesTabGroup`** (classe) — Contrato que `hm-tabs` publica por injeção para os `hm-tab` dentro dele.
2235
+
2236
+ ```ts
2237
+ abstract class HermesTabGroup {
2238
+ }
2239
+ ```
2240
+
2241
+ - `HermesTabsMode` — `tabs`: tablist com painéis (padrão). `nav`: links de rota com `aria-current="page"`.
2242
+
2243
+ ```ts
2244
+ type HermesTabsMode = 'tabs' | 'nav';
2245
+ ```
2246
+
2247
+ - `HermesTabsOrientation` — Direção da faixa de abas (WAI-ARIA APG: ←/→ no horizontal, ↑/↓ no vertical).
2248
+
2249
+ ```ts
2250
+ type HermesTabsOrientation = 'horizontal' | 'vertical';
2251
+ ```
2252
+
2253
+ - `HermesTabsOverflow` — O que fazer quando as abas não cabem na faixa horizontal: `menu` (padrão) leva as que sobram para o botão "Mais"; `wrap` mantém o comportamento antigo (a fileira quebra/rola).
2254
+
2255
+ ```ts
2256
+ type HermesTabsOverflow = 'menu' | 'wrap';
2257
+ ```
2258
+
2259
+ - `TabContentDirective` — `ng-template[hmTabContent]` (ver angular-api.md)
2260
+
2261
+ ## `@trismegisto/angular/tag`
2262
+
2263
+ - `TagColor` — Cor semântica da etiqueta — o mesmo vocabulário de `hm-button`/`hm-badge`/`hm-icon`/`hm-progress` e dos tokens (`--hm-danger`): `danger` é o vermelho de erro/perigo. `error` continua aceito como apelido **depreciado** d…
2264
+
2265
+ ```ts
2266
+ type TagColor = 'primary' | 'info' | 'success' | 'warning' | 'danger' | 'neutral' | 'error';
2267
+ ```
2268
+
2269
+ - `TagComponent` — `hm-tag` (ver angular-api.md)
2270
+
2271
+ ## `@trismegisto/angular/testing`
2272
+
2273
+ - `HermesFieldHarnessFilters` — Filtro comum dos harnesses de campo: rótulo visível (ou o nome acessível, nos grupos).
2274
+
2275
+ ```ts
2276
+ interface HermesFieldHarnessFilters extends BaseHarnessFilters {
2277
+ label?: string | RegExp;
2278
+ }
2279
+ ```
2280
+
2281
+ - `HermesFieldParts` — Onde cada parte do campo mora no DOM do componente concreto.
2282
+
2283
+ ```ts
2284
+ interface HermesFieldParts {
2285
+ readonly control: string;
2286
+ readonly label: string;
2287
+ readonly labelExclude?: string;
2288
+ readonly hint?: string;
2289
+ readonly error?: string;
2290
+ readonly required?: string;
2291
+ }
2292
+ ```
2293
+
2294
+ - **`HermesFieldHarness`** (classe) — Base dos harnesses de campo (input, select, textarea, combobox...). Concentra o que todo campo do Hermes tem igual — rótulo, texto de apoio, erro, obrigatório, desabilitado, foco — lendo o DOM real, do jeito que a pesso…
2295
+
2296
+ ```ts
2297
+ abstract class HermesFieldHarness extends ComponentHarness {
2298
+ static with<T extends HermesFieldHarness>(this: ComponentHarnessConstructor<T>, options: HermesFieldHarnessFilters = {}): HarnessPredicate<T>
2299
+ async getLabel(): Promise<string>
2300
+ async getHint(): Promise<string>
2301
+ async getErrorText(): Promise<string>
2302
+ async isInvalid(): Promise<boolean>
2303
+ async isRequired(): Promise<boolean>
2304
+ async isDisabled(): Promise<boolean>
2305
+ async focus(): Promise<void>
2306
+ async blur(): Promise<void>
2307
+ async isFocused(): Promise<boolean>
2308
+ }
2309
+ ```
2310
+
2311
+ - **`HermesInputHarness`** (classe) — Harness do `hm-input`. `setValue` digita de verdade (eventos `input`), então máscara, contador e validação reagem como na tela.
2312
+
2313
+ ```ts
2314
+ class HermesInputHarness extends HermesFieldHarness {
2315
+ async getValue(): Promise<string>
2316
+ async setValue(value: string): Promise<void>
2317
+ async getPlaceholder(): Promise<string>
2318
+ async getType(): Promise<string>
2319
+ }
2320
+ ```
2321
+
2322
+ - **`HermesTextareaHarness`** (classe) — Harness do `hm-textarea`: mesmo contrato do `HermesInputHarness` (`getValue`/`setValue`/erro/rótulo).
2323
+
2324
+ ```ts
2325
+ class HermesTextareaHarness extends HermesFieldHarness {
2326
+ async getValue(): Promise<string>
2327
+ async setValue(value: string): Promise<void>
2328
+ async getPlaceholder(): Promise<string>
2329
+ async isLoading(): Promise<boolean>
2330
+ }
2331
+ ```
2332
+
2333
+ - **`HermesSelectHarness`** (classe) — Harness do `hm-select` (o `<select>` nativo com o visual do Hermes).
2334
+
2335
+ ```ts
2336
+ class HermesSelectHarness extends HermesFieldHarness {
2337
+ async getValue(): Promise<string>
2338
+ async getSelectedLabel(): Promise<string>
2339
+ async getOptionLabels(): Promise<string[]>
2340
+ async selectOption(label: string | RegExp): Promise<void>
2341
+ }
2342
+ ```
2343
+
2344
+ - **`HermesCheckboxHarness`** (classe) — Harness do `hm-checkbox`. `check`/`uncheck` só clicam quando o estado precisa mudar.
2345
+
2346
+ ```ts
2347
+ class HermesCheckboxHarness extends HermesFieldHarness {
2348
+ async isChecked(): Promise<boolean>
2349
+ async isIndeterminate(): Promise<boolean>
2350
+ async toggle(): Promise<void>
2351
+ async check(): Promise<void>
2352
+ async uncheck(): Promise<void>
2353
+ }
2354
+ ```
2355
+
2356
+ - **`HermesRadioHarness`** (classe) — Harness do `hm-radio` (o grupo inteiro, `role="radiogroup"`).
2357
+
2358
+ ```ts
2359
+ class HermesRadioHarness extends HermesFieldHarness {
2360
+ async getOptionLabels(): Promise<string[]>
2361
+ async getCheckedLabel(): Promise<string>
2362
+ async getCheckedValue(): Promise<string>
2363
+ async check(label: string | RegExp): Promise<void>
2364
+ override async isDisabled(): Promise<boolean>
2365
+ override async isFocused(): Promise<boolean>
2366
+ override async isRequired(): Promise<boolean>
2367
+ }
2368
+ ```
2369
+
2370
+ - **`HermesSwitchHarness`** (classe) — Harness do `hm-switch` (`role="switch"` sobre checkbox nativo).
2371
+
2372
+ ```ts
2373
+ class HermesSwitchHarness extends HermesFieldHarness {
2374
+ async isChecked(): Promise<boolean>
2375
+ async toggle(): Promise<void>
2376
+ async check(): Promise<void>
2377
+ async uncheck(): Promise<void>
2378
+ async isLoading(): Promise<boolean>
2379
+ }
2380
+ ```
2381
+
2382
+ - **`HermesSegmentedControlHarness`** (classe) — Harness do `hm-segmented-control`. O rótulo é o nome acessível do grupo (`aria-label`), já que o controle não desenha rótulo visível.
2383
+
2384
+ ```ts
2385
+ class HermesSegmentedControlHarness extends HermesFieldHarness {
2386
+ override async getLabel(): Promise<string>
2387
+ override async isDisabled(): Promise<boolean>
2388
+ override async isFocused(): Promise<boolean>
2389
+ override async focus(): Promise<void>
2390
+ async getOptionLabels(): Promise<string[]>
2391
+ async getSelectedLabel(): Promise<string>
2392
+ async isOptionDisabled(label: string | RegExp): Promise<boolean>
2393
+ async select(label: string | RegExp): Promise<void>
2394
+ }
2395
+ ```
2396
+
2397
+ - `HermesComboboxOptionHarnessFilters` — Filtro das opções da lista de um combobox.
2398
+
2399
+ ```ts
2400
+ interface HermesComboboxOptionHarnessFilters extends BaseHarnessFilters {
2401
+ text?: string | RegExp;
2402
+ selected?: boolean;
2403
+ }
2404
+ ```
2405
+
2406
+ - **`HermesComboboxOptionHarness`** (classe) — Uma opção (`role="option"`) da lista do `hm-combobox` ou do `hm-combobox-multi`. A lista é movida para o `<body>` ao abrir, então o harness do campo busca as opções na raiz do documento.
2407
+
2408
+ ```ts
2409
+ class HermesComboboxOptionHarness extends ComponentHarness {
2410
+ static with(options: HermesComboboxOptionHarnessFilters = {}): HarnessPredicate<HermesComboboxOptionHarness>
2411
+ async getText(): Promise<string>
2412
+ async isSelected(): Promise<boolean>
2413
+ async isDisabled(): Promise<boolean>
2414
+ async click(): Promise<void>
2415
+ }
2416
+ ```
2417
+
2418
+ - **`HermesComboboxHarness`** (classe) — Harness do `hm-combobox` (seleção única com filtro por digitação).
2419
+
2420
+ ```ts
2421
+ class HermesComboboxHarness extends HermesComboboxHarnessBase {
2422
+ async getValue(): Promise<string>
2423
+ async filter(text: string): Promise<void>
2424
+ async selectOption(filters: Omit<HermesComboboxOptionHarnessFilters, 'ancestor'>): Promise<void>
2425
+ async clear(): Promise<void>
2426
+ }
2427
+ ```
2428
+
2429
+ - **`HermesComboboxMultiHarness`** (classe) — Harness do `hm-combobox-multi` (vários valores, fichas no campo, busca dentro da lista).
2430
+
2431
+ ```ts
2432
+ class HermesComboboxMultiHarness extends HermesComboboxHarnessBase {
2433
+ async getChipLabels(): Promise<string[]>
2434
+ async getOverflowText(): Promise<string>
2435
+ async getSelectedLabels(): Promise<string[]>
2436
+ async filter(text: string): Promise<void>
2437
+ async toggleOption(filters: Omit<HermesComboboxOptionHarnessFilters, 'ancestor'>): Promise<void>
2438
+ async selectOptions(...labels: (string | RegExp)[]): Promise<void>
2439
+ async removeChip(label: string): Promise<void>
2440
+ async clear(): Promise<void>
2441
+ }
2442
+ ```
2443
+
2444
+ - **`HermesDatePickerHarness`** (classe) — Harness do `hm-date-picker`. Trabalha com o texto digitado, no padrão de data do idioma ativo (`dd/mm/aaaa` em pt-BR): é o que a pessoa vê e digita. O valor do formulário (ISO, por padrão) confira no próprio `FormContro…
2445
+
2446
+ ```ts
2447
+ class HermesDatePickerHarness extends HermesFieldHarness {
2448
+ async getValue(): Promise<string>
2449
+ async setValue(value: string): Promise<void>
2450
+ async isCalendarOpen(): Promise<boolean>
2451
+ async openCalendar(): Promise<void>
2452
+ async closeCalendar(): Promise<void>
2453
+ }
2454
+ ```
2455
+
2456
+ - `HermesButtonHarnessFilters` — Filtro do `HermesButtonHarness`.
2457
+
2458
+ ```ts
2459
+ interface HermesButtonHarnessFilters extends BaseHarnessFilters {
2460
+ text?: string | RegExp;
2461
+ disabled?: boolean;
2462
+ }
2463
+ ```
2464
+
2465
+ - **`HermesButtonHarness`** (classe) — Harness do `hm-button` e do `hm-icon-button` (o texto do botão de ícone é o rótulo acessível). Também serve para o `hm-button` com `link` (vira `<a>`).
2466
+
2467
+ ```ts
2468
+ class HermesButtonHarness extends ComponentHarness {
2469
+ static with(options: HermesButtonHarnessFilters = {}): HarnessPredicate<HermesButtonHarness>
2470
+ async getText(): Promise<string>
2471
+ async isDisabled(): Promise<boolean>
2472
+ async isBusy(): Promise<boolean>
2473
+ async isLink(): Promise<boolean>
2474
+ async click(): Promise<void>
2475
+ async focus(): Promise<void>
2476
+ async blur(): Promise<void>
2477
+ async isFocused(): Promise<boolean>
2478
+ }
2479
+ ```
2480
+
2481
+ - `HermesModalHarnessFilters` — Filtro do `HermesModalHarness`.
2482
+
2483
+ ```ts
2484
+ interface HermesModalHarnessFilters extends BaseHarnessFilters {
2485
+ heading?: string | RegExp;
2486
+ }
2487
+ ```
2488
+
2489
+ - `HermesModalSection` — Áreas do modal onde dá para procurar outros harnesses (`getHarness`/`getChildLoader`).
2490
+
2491
+ ```ts
2492
+ enum HermesModalSection {
2493
+ BODY = '.hm-modal__body',
2494
+ FOOTER = '.hm-modal__footer',
2495
+ }
2496
+ ```
2497
+
2498
+ - **`HermesModalHarness`** (classe) — Harness do `hm-modal` — e dos diálogos abertos pelo `HermesDialogService`, que desenham um `hm-modal` dentro de um host anexado ao `<body>`. Para esses, use o loader da raiz do documento:
2499
+
2500
+ ```ts
2501
+ class HermesModalHarness extends ContentContainerComponentHarness<HermesModalSection | string> {
2502
+ static with(options: HermesModalHarnessFilters = {}): HarnessPredicate<HermesModalHarness>
2503
+ async isOpen(): Promise<boolean>
2504
+ async getHeading(): Promise<string>
2505
+ async getBodyText(): Promise<string>
2506
+ async getSize(): Promise<'small' | 'medium' | 'large'>
2507
+ async isClosable(): Promise<boolean>
2508
+ async close(): Promise<void>
2509
+ async pressEscape(): Promise<void>
2510
+ async getFooterButtons(filters: Omit<HermesButtonHarnessFilters, 'ancestor'> = {}): Promise<HermesButtonHarness[]>
2511
+ async getFooterButton(filters: Omit<HermesButtonHarnessFilters, 'ancestor'> = {}): Promise<HermesButtonHarness>
2512
+ }
2513
+ ```
2514
+
2515
+ - `HermesTabHarnessFilters` — Filtro de uma aba.
2516
+
2517
+ ```ts
2518
+ interface HermesTabHarnessFilters extends BaseHarnessFilters {
2519
+ label?: string | RegExp;
2520
+ selected?: boolean;
2521
+ }
2522
+ ```
2523
+
2524
+ - `HermesTabsHarnessFilters` — Filtro do grupo de abas.
2525
+
2526
+ ```ts
2527
+ interface HermesTabsHarnessFilters extends BaseHarnessFilters {
2528
+ label?: string | RegExp;
2529
+ }
2530
+ ```
2531
+
2532
+ - **`HermesTabHarness`** (classe) — Uma aba (`role="tab"`) do `hm-tabs` no modo `tabs`.
2533
+
2534
+ ```ts
2535
+ class HermesTabHarness extends ComponentHarness {
2536
+ static with(options: HermesTabHarnessFilters = {}): HarnessPredicate<HermesTabHarness>
2537
+ async getLabel(): Promise<string>
2538
+ async getCount(): Promise<string | null>
2539
+ async isSelected(): Promise<boolean>
2540
+ async isDisabled(): Promise<boolean>
2541
+ async isOverflowed(): Promise<boolean>
2542
+ async select(): Promise<void>
2543
+ }
2544
+ ```
2545
+
2546
+ - **`HermesTabsHarness`** (classe) — Harness do `hm-tabs` (abas de conteúdo, modo `tabs`). O painel ativo é o único desenhado, então `getHarness(...)`/`getActivePanelText()` enxergam só o conteúdo da aba selecionada.
2547
+
2548
+ ```ts
2549
+ class HermesTabsHarness extends ContentContainerComponentHarness {
2550
+ static with(options: HermesTabsHarnessFilters = {}): HarnessPredicate<HermesTabsHarness>
2551
+ async getLabel(): Promise<string>
2552
+ async getTabs(filters: HermesTabHarnessFilters = {}): Promise<HermesTabHarness[]>
2553
+ async getSelectedTab(): Promise<HermesTabHarness>
2554
+ async selectTab(filters: HermesTabHarnessFilters = {}): Promise<void>
2555
+ async getActivePanelText(): Promise<string>
2556
+ }
2557
+ ```
2558
+
2559
+ - `HermesMenuItemHarnessFilters` — Filtro de um item de menu.
2560
+
2561
+ ```ts
2562
+ interface HermesMenuItemHarnessFilters extends BaseHarnessFilters {
2563
+ text?: string | RegExp;
2564
+ disabled?: boolean;
2565
+ }
2566
+ ```
2567
+
2568
+ - `HermesMenuHarnessFilters` — Filtro do cartão de menu aberto.
2569
+
2570
+ ```ts
2571
+ interface HermesMenuHarnessFilters extends BaseHarnessFilters {
2572
+ label?: string | RegExp;
2573
+ }
2574
+ ```
2575
+
2576
+ - **`HermesMenuItemHarness`** (classe) — Um item (`role="menuitem"`) de um `hm-menu` aberto.
2577
+
2578
+ ```ts
2579
+ class HermesMenuItemHarness extends ComponentHarness {
2580
+ static with(options: HermesMenuItemHarnessFilters = {}): HarnessPredicate<HermesMenuItemHarness>
2581
+ async getText(): Promise<string>
2582
+ async getShortcut(): Promise<string>
2583
+ async isDisabled(): Promise<boolean>
2584
+ async isDanger(): Promise<boolean>
2585
+ async hasSubmenu(): Promise<boolean>
2586
+ async click(): Promise<void>
2587
+ }
2588
+ ```
2589
+
2590
+ - **`HermesMenuHarness`** (classe) — O cartão de um `hm-menu` aberto. Ele é movido para o `<body>` ao abrir, então procure com o loader da raiz do documento (`TestbedHarnessEnvironment.documentRootLoader(fixture)`) — ou, mais simples, use o `HermesMenuButt…
2591
+
2592
+ ```ts
2593
+ class HermesMenuHarness extends ComponentHarness {
2594
+ static with(options: HermesMenuHarnessFilters = {}): HarnessPredicate<HermesMenuHarness>
2595
+ async getLabel(): Promise<string>
2596
+ async getItems(filters: HermesMenuItemHarnessFilters = {}): Promise<HermesMenuItemHarness[]>
2597
+ async clickItem(filter: HermesMenuItemHarnessFilters, ...submenuFilters: HermesMenuItemHarnessFilters[]): Promise<void>
2598
+ async close(): Promise<void>
2599
+ }
2600
+ ```
2601
+
2602
+ - `HermesMenuButtonHarnessFilters` — Filtro do `HermesMenuButtonHarness`.
2603
+
2604
+ ```ts
2605
+ interface HermesMenuButtonHarnessFilters extends BaseHarnessFilters {
2606
+ label?: string | RegExp;
2607
+ }
2608
+ ```
2609
+
2610
+ - **`HermesMenuButtonHarness`** (classe) — Harness do `hm-menu-button` (botão que abre um `hm-menu`).
2611
+
2612
+ ```ts
2613
+ class HermesMenuButtonHarness extends ComponentHarness {
2614
+ static with(options: HermesMenuButtonHarnessFilters = {}): HarnessPredicate<HermesMenuButtonHarness>
2615
+ async getLabel(): Promise<string>
2616
+ async isOpen(): Promise<boolean>
2617
+ async open(): Promise<void>
2618
+ async close(): Promise<void>
2619
+ async getMenu(): Promise<HermesMenuHarness>
2620
+ async getItems(filters: HermesMenuItemHarnessFilters = {}): Promise<HermesMenuItemHarness[]>
2621
+ async clickItem(filter: HermesMenuItemHarnessFilters, ...submenuFilters: HermesMenuItemHarnessFilters[]): Promise<void>
2622
+ async focus(): Promise<void>
2623
+ async isFocused(): Promise<boolean>
2624
+ }
2625
+ ```
2626
+
2627
+ - `HermesDataGridCellHarnessFilters` — Filtro de uma célula.
2628
+
2629
+ ```ts
2630
+ interface HermesDataGridCellHarnessFilters extends BaseHarnessFilters {
2631
+ text?: string | RegExp;
2632
+ columnTitle?: string | RegExp;
2633
+ }
2634
+ ```
2635
+
2636
+ - `HermesDataGridRowHarnessFilters` — Filtro de uma linha.
2637
+
2638
+ ```ts
2639
+ interface HermesDataGridRowHarnessFilters extends BaseHarnessFilters {
2640
+ cellText?: string | RegExp;
2641
+ selected?: boolean;
2642
+ }
2643
+ ```
2644
+
2645
+ - `HermesDataGridHeaderHarnessFilters` — Filtro de um cabeçalho de coluna.
2646
+
2647
+ ```ts
2648
+ interface HermesDataGridHeaderHarnessFilters extends BaseHarnessFilters {
2649
+ title?: string | RegExp;
2650
+ key?: string;
2651
+ }
2652
+ ```
2653
+
2654
+ - `HermesDataGridHarnessFilters` — Filtro da grade.
2655
+
2656
+ ```ts
2657
+ interface HermesDataGridHarnessFilters extends BaseHarnessFilters {
2658
+ caption?: string | RegExp;
2659
+ }
2660
+ ```
2661
+
2662
+ - `HermesDataGridSortDirection` — Direção de ordenação lida do `aria-sort` do cabeçalho.
2663
+
2664
+ ```ts
2665
+ type HermesDataGridSortDirection = 'ascending' | 'descending' | 'none';
2666
+ ```
2667
+
2668
+ - **`HermesDataGridCellHarness`** (classe) — Uma célula de dados.
2669
+
2670
+ ```ts
2671
+ class HermesDataGridCellHarness extends ComponentHarness {
2672
+ static with(options: HermesDataGridCellHarnessFilters = {}): HarnessPredicate<HermesDataGridCellHarness>
2673
+ async getText(): Promise<string>
2674
+ async getColumnTitle(): Promise<string>
2675
+ }
2676
+ ```
2677
+
2678
+ - **`HermesDataGridRowHarness`** (classe) — Uma linha de dados (o esqueleto de carregamento não conta).
2679
+
2680
+ ```ts
2681
+ class HermesDataGridRowHarness extends ComponentHarness {
2682
+ static with(options: HermesDataGridRowHarnessFilters = {}): HarnessPredicate<HermesDataGridRowHarness>
2683
+ async getCells(filters: HermesDataGridCellHarnessFilters = {}): Promise<HermesDataGridCellHarness[]>
2684
+ async getCellTexts(): Promise<string[]>
2685
+ async getCellTextByColumnTitle(): Promise<Record<string, string>>
2686
+ async isSelected(): Promise<boolean>
2687
+ async toggleSelection(): Promise<void>
2688
+ async select(): Promise<void>
2689
+ async deselect(): Promise<void>
2690
+ async isExpanded(): Promise<boolean>
2691
+ async toggleDetail(): Promise<void>
2692
+ async click(): Promise<void>
2693
+ }
2694
+ ```
2695
+
2696
+ - **`HermesDataGridHeaderHarness`** (classe) — Cabeçalho de uma coluna de dados.
2697
+
2698
+ ```ts
2699
+ class HermesDataGridHeaderHarness extends ComponentHarness {
2700
+ static with(options: HermesDataGridHeaderHarnessFilters = {}): HarnessPredicate<HermesDataGridHeaderHarness>
2701
+ async getTitle(): Promise<string>
2702
+ async getKey(): Promise<string>
2703
+ async isSortable(): Promise<boolean>
2704
+ async getSortDirection(): Promise<HermesDataGridSortDirection>
2705
+ async sort(): Promise<void>
2706
+ async isFilterable(): Promise<boolean>
2707
+ async isFiltered(): Promise<boolean>
2708
+ async openFilter(): Promise<void>
2709
+ }
2710
+ ```
2711
+
2712
+ - **`HermesDataGridHarness`** (classe) — Harness do `hm-data-grid`: linhas, células, ordenar, buscar, filtrar por coluna, paginar e selecionar, sempre pela interface (os mesmos cliques e digitação da pessoa).
2713
+
2714
+ ```ts
2715
+ class HermesDataGridHarness extends ComponentHarness {
2716
+ static with(options: HermesDataGridHarnessFilters = {}): HarnessPredicate<HermesDataGridHarness>
2717
+ async getCaption(): Promise<string>
2718
+ async isLoading(): Promise<boolean>
2719
+ async isEmpty(): Promise<boolean>
2720
+ async getEmptyText(): Promise<string>
2721
+ async getRows(filters: HermesDataGridRowHarnessFilters = {}): Promise<HermesDataGridRowHarness[]>
2722
+ async getCellTextByIndex(): Promise<string[][]>
2723
+ async getColumnTexts(title: string | RegExp): Promise<string[]>
2724
+ async getHeaders(filters: HermesDataGridHeaderHarnessFilters = {}): Promise<HermesDataGridHeaderHarness[]>
2725
+ async getColumnTitles(): Promise<string[]>
2726
+ async getHeader(title: string | RegExp): Promise<HermesDataGridHeaderHarness>
2727
+ async sortBy(title: string | RegExp, direction: HermesDataGridSortDirection = 'ascending'): Promise<void>
2728
+ async getSortDirection(title: string | RegExp): Promise<HermesDataGridSortDirection>
2729
+ async search(term: string): Promise<void>
2730
+ async getSearchTerm(): Promise<string>
2731
+ async filterColumn(title: string | RegExp, value: string | readonly string[]): Promise<void>
2732
+ async clearFilters(): Promise<void>
2733
+ async getCurrentPage(): Promise<number>
2734
+ async getPageCount(): Promise<number>
2735
+ async goToPage(page: number): Promise<void>
2736
+ async firstPage(): Promise<void>
2737
+ async previousPage(): Promise<void>
2738
+ async nextPage(): Promise<void>
2739
+ async lastPage(): Promise<void>
2740
+ async getPageSize(): Promise<number>
2741
+ async setPageSize(size: number): Promise<void>
2742
+ async getRangeText(): Promise<string>
2743
+ async getSelectedRows(): Promise<HermesDataGridRowHarness[]>
2744
+ async isAllSelected(): Promise<boolean>
2745
+ async toggleSelectAll(): Promise<void>
2746
+ async getSelectionText(): Promise<string>
2747
+ }
2748
+ ```
2749
+
2750
+ ## `@trismegisto/angular/textarea`
2751
+
2752
+ - `TextareaSubmitKey` — Tecla que envia (`submitted`): `none` (padrão — Enter só quebra linha), `mod-enter` (Ctrl+Enter, ou Cmd+Enter no macOS) ou `enter` (Enter envia, Shift+Enter quebra linha — padrão de conversa).
2753
+
2754
+ ```ts
2755
+ type TextareaSubmitKey = 'none' | 'mod-enter' | 'enter';
2756
+ ```
2757
+
2758
+ - `TextareaComponent` — `hm-textarea` (ver angular-api.md)
2759
+ - `TextareaAddonSlot` — Onde o conteúdo projetado entra no `hm-textarea`.
2760
+
2761
+ ```ts
2762
+ type TextareaAddonSlot = 'prefix' | 'suffix' | 'actions' | 'actionsEnd';
2763
+ ```
2764
+
2765
+ - `TextareaAddonDirective` — `[hmTextareaPrefix], [hmTextareaSuffix], [hmTextareaActions], [hmTextareaActionsEnd]` (ver angular-api.md)
2766
+
2767
+ ## `@trismegisto/angular/theme`
2768
+
2769
+ - `HermesThemeDirective` — `[hermesTheme]` (ver angular-api.md)
2770
+ - `const HERMES_THEME_CONFIG: InjectionToken<HermesThemeConfig>`
2771
+ - **`HermesThemeService`** (classe)
2772
+
2773
+ ```ts
2774
+ class HermesThemeService {
2775
+ readonly theme = computed(…)
2776
+ readonly mode = computed(…)
2777
+ readonly family = computed(…)
2778
+ readonly density = computed(…)
2779
+ readonly font = computed(…)
2780
+ readonly palette = computed(…)
2781
+ readonly families: readonly HermesFamily[]
2782
+ readonly fonts: readonly HermesFontDefinition[]
2783
+ setTheme(theme: HermesThemeName): void
2784
+ setMode(mode: HermesThemeMode): void
2785
+ setFamily(id: string): void
2786
+ setDensity(density: HermesDensity): void
2787
+ setFont(font: HermesFont): void
2788
+ toggle(): void
2789
+ toggleDensity(): void
2790
+ }
2791
+ ```
2792
+
2793
+ ## `@trismegisto/angular/theme-builder`
2794
+
2795
+ - `ThemeBuilderFormat`
2796
+
2797
+ ```ts
2798
+ type ThemeBuilderFormat = 'css' | 'json' | 'typescript';
2799
+ ```
2800
+
2801
+ - `ThemeBuilderComponent` — `hm-theme-builder` (ver angular-api.md)
2802
+
2803
+ ## `@trismegisto/angular/theme-picker`
2804
+
2805
+ - `ThemePickerComponent` — `hm-theme-picker` (ver angular-api.md)
2806
+
2807
+ ## `@trismegisto/angular/time-picker`
2808
+
2809
+ - `TimePickerComponent` — `hm-time-picker` (ver angular-api.md)
2810
+
2811
+ ## `@trismegisto/angular/timeline`
2812
+
2813
+ - `TimelineItemComponent` — `hm-timeline-item` (ver angular-api.md)
2814
+ - `TimelineOrientation`
2815
+
2816
+ ```ts
2817
+ type TimelineOrientation = 'vertical' | 'horizontal';
2818
+ ```
2819
+
2820
+ - `TimelineComponent` — `hm-timeline` (ver angular-api.md)
2821
+
2822
+ ## `@trismegisto/angular/toast`
2823
+
2824
+ - `ToastStackComponent` — `hm-toast-stack` (ver angular-api.md)
2825
+ - `ToastComponent` — `hm-toast` (ver angular-api.md)
2826
+ - **`HermesToastService`** (classe)
2827
+
2828
+ ```ts
2829
+ class HermesToastService {
2830
+ readonly toasts = computed(…)
2831
+ push(variant: AlertVariant, message: string, options?: ToastPushOptions): void
2832
+ error(message: string, options?: ToastPushOptions): void
2833
+ warning(message: string, options?: ToastPushOptions): void
2834
+ info(message: string, options?: ToastPushOptions): void
2835
+ success(message: string, options?: ToastPushOptions): void
2836
+ dismiss(id: string): void
2837
+ pause(): void
2838
+ resume(): void
2839
+ }
2840
+ ```
2841
+
2842
+ ## `@trismegisto/angular/toggle-group`
2843
+
2844
+ - **`HermesToggleGroup`** (classe) — Contrato que `hm-toggle-group` publica por injeção para os `hm-toggle-group-item` dentro dele.
2845
+
2846
+ ```ts
2847
+ abstract class HermesToggleGroup {
2848
+ }
2849
+ ```
2850
+
2851
+ - `ToggleGroupItemComponent` — `hm-toggle-group-item` (ver angular-api.md)
2852
+ - `ToggleGroupValue` — Valor do grupo: o `value` do item marcado (escolha única) ou a lista dos ligados (múltipla).
2853
+
2854
+ ```ts
2855
+ type ToggleGroupValue = string | readonly string[];
2856
+ ```
2857
+
2858
+ - `ToggleGroupAppearance` — Peso visual: `outlined` (itens encostados numa moldura só, padrão) ou `subtle` (sem moldura).
2859
+
2860
+ ```ts
2861
+ type ToggleGroupAppearance = 'outlined' | 'subtle';
2862
+ ```
2863
+
2864
+ - `ToggleGroupSize` — Altura — mesmo trilho do `hm-button`/`hm-icon-button`.
2865
+
2866
+ ```ts
2867
+ type ToggleGroupSize = 'small' | 'medium' | 'large';
2868
+ ```
2869
+
2870
+ - `ToggleGroupOrientation`
2871
+
2872
+ ```ts
2873
+ type ToggleGroupOrientation = 'horizontal' | 'vertical';
2874
+ ```
2875
+
2876
+ - `ToggleGroupComponent` — `hm-toggle-group` (ver angular-api.md)
2877
+
2878
+ ## `@trismegisto/angular/toggletip`
2879
+
2880
+ - `ToggletipSide` — Lado preferido de abertura do balão; ele vira sozinho quando não cabe.
2881
+
2882
+ ```ts
2883
+ type ToggletipSide = 'bottom' | 'top';
2884
+ ```
2885
+
2886
+ - `ToggletipComponent` — `hm-toggletip` (ver angular-api.md)
2887
+
2888
+ ## `@trismegisto/angular/toolbar`
2889
+
2890
+ - `ToolbarComponent` — `hm-toolbar` (ver angular-api.md)
2891
+
2892
+ ## `@trismegisto/angular/tooltip`
2893
+
2894
+ - `TooltipDirective` — `[hmTooltip]` (ver angular-api.md)
2895
+
2896
+ ## `@trismegisto/angular/tree`
2897
+
2898
+ - `TreeCanDrop` — Pode soltar `node` em `position` de `target`? (`canDrop` do hm-tree).
2899
+
2900
+ ```ts
2901
+ type TreeCanDrop = (node: TreeNode, target: TreeNode, position: TreeDropPosition) => boolean;
2902
+ ```
2903
+
2904
+ - `TreeMoveEvent` — Nó solto em outro lugar (`moved`). O hm-tree não muda `nodes`: aplique com `moveTreeNode`.
2905
+
2906
+ ```ts
2907
+ interface TreeMoveEvent {
2908
+ readonly node: TreeNode;
2909
+ readonly target: TreeNode;
2910
+ readonly position: TreeDropPosition;
2911
+ readonly from: TreeLocation;
2912
+ readonly to: TreeLocation;
2913
+ readonly via: HermesDragVia;
2914
+ }
2915
+ ```
2916
+
2917
+ - `TreeNodeActionEvent` — Ação escolhida no menu de contexto de um nó (`nodeAction`).
2918
+
2919
+ ```ts
2920
+ interface TreeNodeActionEvent {
2921
+ readonly id: string;
2922
+ readonly node: TreeNode;
2923
+ }
2924
+ ```
2925
+
2926
+ - `TreeNodeActions` — Itens do menu de contexto: os mesmos para todo nó, ou filtrados/calculados por nó.
2927
+
2928
+ ```ts
2929
+ type TreeNodeActions = readonly MenuItem[] | ((node: TreeNode) => readonly MenuItem[]);
2930
+ ```
2931
+
2932
+ - `TreeLoadContext` — Onde a carga está: quantos filhos do nó já chegaram e qual página é esta (0 = a primeira).
2933
+
2934
+ ```ts
2935
+ interface TreeLoadContext {
2936
+ readonly offset: number;
2937
+ readonly page: number;
2938
+ }
2939
+ ```
2940
+
2941
+ - `TreeChildrenLoader` — Carregador de filhos sob demanda — Promise ou Observable (o primeiro valor vale). Devolve a lista inteira (forma de sempre) ou uma página `{ children, hasMore }`: com `hasMore`, a árvore mostra "Carregar mais" no fim do…
2942
+
2943
+ ```ts
2944
+ type TreeChildrenLoader = (
2945
+ node: TreeNode,
2946
+ context: TreeLoadContext,
2947
+ ) => Promise<TreeChildrenResult> | Observable<TreeChildrenResult>;
2948
+ ```
2949
+
2950
+ - `TreeNodeTemplateContext` — Contexto do template customizado de nó (`<ng-template hmTreeNode let-node let-row="row">`).
2951
+
2952
+ ```ts
2953
+ interface TreeNodeTemplateContext {
2954
+ $implicit: TreeNode;
2955
+ row: TreeRow;
2956
+ active: boolean;
2957
+ }
2958
+ ```
2959
+
2960
+ - `TreeNodeTemplateDirective` — `ng-template[hmTreeNode]` (ver angular-api.md)
2961
+ - `TreeComponent` — `hm-tree` (ver angular-api.md)
2962
+ - `TreeChildrenPage` _(de `@trismegisto/primitives`)_ — Uma página de filhos: o que chegou e se ainda há mais para pedir ("carregar mais").
2963
+
2964
+ ```ts
2965
+ interface TreeChildrenPage {
2966
+ readonly children: readonly TreeNode[];
2967
+ readonly hasMore?: boolean;
2968
+ }
2969
+ ```
2970
+
2971
+ - `TreeChildrenResult` _(de `@trismegisto/primitives`)_ — O que um `loadChildren` pode devolver: a lista inteira (forma antiga) ou uma página.
2972
+
2973
+ ```ts
2974
+ type TreeChildrenResult = readonly TreeNode[] | TreeChildrenPage;
2975
+ ```
2976
+
2977
+ - `TreeDropPosition` _(de `@trismegisto/primitives`)_ — Onde soltar em relação ao nó-alvo: antes, dentro (último filho) ou depois.
2978
+
2979
+ ```ts
2980
+ type TreeDropPosition = DropPosition;
2981
+ ```
2982
+
2983
+ - `TreeLocation` _(de `@trismegisto/primitives`)_ — Lugar de um nó: id do pai (`null` = raiz) e posição entre os irmãos (a partir de 0).
2984
+
2985
+ ```ts
2986
+ interface TreeLocation {
2987
+ readonly parentId: string | null;
2988
+ readonly index: number;
2989
+ }
2990
+ ```
2991
+
2992
+ - `TreeNode` _(de `@trismegisto/primitives`)_
2993
+
2994
+ ```ts
2995
+ interface TreeNode {
2996
+ readonly id: string;
2997
+ readonly label: string;
2998
+ readonly leaf?: boolean;
2999
+ readonly children?: readonly TreeNode[];
3000
+ readonly expandable?: boolean;
3001
+ readonly disabled?: boolean;
3002
+ readonly icon?: string;
3003
+ readonly link?: string;
3004
+ readonly data?: unknown;
3005
+ }
3006
+ ```
3007
+
3008
+ - `TreeSelectionChange` _(de `@trismegisto/primitives`)_
3009
+
3010
+ ```ts
3011
+ interface TreeSelectionChange {
3012
+ readonly id: string;
3013
+ readonly selected: boolean;
3014
+ }
3015
+ ```
3016
+
3017
+ - `TreeSelectionMode` _(de `@trismegisto/primitives`)_ — `none`: só ativa; `single`: um nó por vez; `multiple`: vários, com Ctrl/Shift e Ctrl+A.
3018
+
3019
+ ```ts
3020
+ type TreeSelectionMode = 'none' | 'single' | 'multiple';
3021
+ ```
3022
+
3023
+ ## `@trismegisto/angular/wizard`
3024
+
3025
+ - `WizardMode`
3026
+
3027
+ ```ts
3028
+ type WizardMode = 'modal' | 'page';
3029
+ ```
3030
+
3031
+ - `WizardComponent` — `hm-wizard` (ver angular-api.md)
3032
+
3033
+ ## `@trismegisto/angular/workspace`
3034
+
3035
+ - `WorkspaceNodeComponent` — `hm-workspace-node` (ver angular-api.md)
3036
+ - `WorkspaceTabContext` — Contexto do `<ng-template>` de conteúdo: a aba ativa do painel que está sendo desenhado, e o id do painel dono dela — necessário pra quem projeta conteúdo saber "estou desenhando dentro de QUAL painel" (ex.: decidir se…
3037
+
3038
+ ```ts
3039
+ interface WorkspaceTabContext {
3040
+ readonly $implicit: TabItem;
3041
+ readonly panelId: string;
3042
+ readonly active: boolean;
3043
+ }
3044
+ ```
3045
+
3046
+ - `WorkspaceComponent` — `hm-workspace` (ver angular-api.md)
3047
+
3048
+ ## `@trismegisto/angular/workspace-persistence`
3049
+
3050
+ - `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,…
3051
+ - `function provideHermesWorkspacePersistence(config: WorkspacePersistenceConfig): Provider`
3052
+ - `function createPersistedWorkspaceStore( fallback: TabBarState, resolveTab: (id: string) => TabItem | null, 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…
3053
+
3054
+ ## `@trismegisto/angular/zoom`
3055
+
3056
+ - **`HermesZoomService`** (classe)
3057
+
3058
+ ```ts
3059
+ class HermesZoomService {
3060
+ readonly level = computed(…)
3061
+ readonly pixelRatio = computed(…)
3062
+ readonly zoomed = computed(…)
3063
+ }
3064
+ ```
3065
+
3066
+ - `function provideHermesZoom(): EnvironmentProviders` — Liga o `HermesZoomService` no bootstrap, para as classes `hm-zoom-*` estarem no `<html>` desde a primeira pintura (sem esperar algum componente injetar o serviço).
3067
+
3068
+ ## Só na raiz `@trismegisto/angular` (vindos de `@trismegisto/primitives`)
3069
+
3070
+ Também podem ser importados direto de `@trismegisto/primitives`.
3071
+
3072
+ - `const HERMES_MESSAGES_PT_BR: HermesMessages`
3073
+ - `HermesMessages` — Todo texto que os componentes Hermes exibem ou anunciam (SDD §12.3: sem texto hardcoded).
3074
+
3075
+ ```ts
3076
+ interface HermesMessages {
3077
+ meta: { locale: string };
3078
+ field: {
3079
+ required: string;
3080
+ showPassword: string;
3081
+ hidePassword: string;
3082
+ errors: Readonly<Record<string, string>> & { invalid: string };
3083
+ loading: string;
3084
+ };
3085
+ input: { increment: string; decrement: string; counter: string };
3086
+ alert: {
3087
+ close: string;
3088
+ linkLabel: string;
3089
+ newTab: string;
3090
+ previous: string;
3091
+ next: string;
3092
+ position: string;
3093
+ groupLabel: PluralMessage;
3094
+ };
3095
+ modal: { close: string };
3096
+ drawer: { close: string };
3097
+ form: { requiredHint: string };
3098
+ floatingWindow: {
3099
+ minimize: string;
3100
+ maximize: string;
3101
+ restore: string;
3102
+ close: string;
3103
+ keyboardHint: string;
3104
+ moved: string;
3105
+ resized: string;
3106
+ minimized: string;
3107
+ maximized: string;
3108
+ restored: string;
3109
+ };
3110
+ commandPalette: {
3111
+ label: string;
3112
+ placeholder: string;
3113
+ inputLabel: string;
3114
+ recent: string;
3115
+ // …
3116
+ ```
3117
+
3118
+ - `HermesMessagesOverride`
3119
+
3120
+ ```ts
3121
+ type HermesMessagesOverride = CatalogOverride<HermesMessages>;
3122
+ ```
3123
+
3124
+ - `CatalogOverride` — Sobrescrita parcial de qualquer catálogo `seção → chave` (o da lib, o do spine, o de um app).
3125
+
3126
+ ```ts
3127
+ type CatalogOverride<T> = {
3128
+ [K in keyof T]?: SectionOverride<T[K]>;
3129
+ };
3130
+ ```
3131
+
3132
+ - `MessageParams`
3133
+
3134
+ ```ts
3135
+ type MessageParams = Readonly<Record<string, string | number>>;
3136
+ ```
3137
+
3138
+ - `PluralMessage` — Formas plurais de uma mensagem (categorias do Unicode CLDR). `other` é obrigatória; `zero` é opcional e vale para contagem 0 em qualquer idioma (texto próprio para "nenhum").
3139
+
3140
+ ```ts
3141
+ interface PluralMessage {
3142
+ readonly zero?: string;
3143
+ readonly one?: string;
3144
+ readonly two?: string;
3145
+ readonly few?: string;
3146
+ readonly many?: string;
3147
+ readonly other: string;
3148
+ }
3149
+ ```
3150
+
3151
+ - `function formatMessage(template: string, params: MessageParams = {}): string` — Troca `{nome}` pelo parâmetro. Parâmetro ausente fica como está (o erro aparece na tela, não some).
3152
+ - `function mergeCatalog<T extends object>(override: CatalogOverride<T>, base: T): T` — Mescla sobrescritas parciais por cima de um catálogo base `seção → chave`. Desce um nível dentro de cada seção: sobrescrever `field.errors.required` mantém as outras mensagens de erro (`email`, `minlength`…) do catálogo…
3153
+ - `function mergeMessages( override: HermesMessagesOverride, base: HermesMessages = HERMES_MESSAGES_PT_BR, ): HermesMessages` — `mergeCatalog` para o catálogo da lib (base padrão: pt-BR).
3154
+ - `function pluralMessage(message: PluralMessage, count: number, locale: string, params: MessageParams = {}): string` — Escolhe a forma plural de `count` no idioma e formata com `{count}` e os demais parâmetros.
3155
+ - `HermesZoomLevel` — Nível de zoom para reflow (WCAG 1.4.10), sem framework.
3156
+
3157
+ ```ts
3158
+ type HermesZoomLevel = 'none' | 'x2' | 'x4';
3159
+ ```
3160
+
3161
+ - `const HERMES_ZOOM_BREAKPOINTS =` — Abaixo de qual largura (px CSS) cada nível vale.
3162
+ - `const HERMES_ZOOM_CLASSES =` — Classes que o nível põe no elemento raiz (`<html>`). São cumulativas: `hm-zoom-x2` quer dizer "200% ou mais" (também presente em `'x4'`) e `hm-zoom-x4`, "400% ou mais". Assim um estilo de reflow escrito para 200% contin…
3163
+ - `const HERMES_FAMILIES: readonly HermesFamily[]` — Doze famílias com nomes da mitologia grega. A primeira (`hera`) é o padrão do sistema: uma família desconhecida cai nela. Contraste medido por `scripts/check-families.mjs` (WCAG: accent ≥ 4,5:1 nos dois temas; borda do…
3164
+ - `HermesFamily` — As 12 famílias de cor: cada uma com o par accent (cor de ação, `--hm-accent`/`--hm-action`) e panelBg (banda escura do painel de marca, `--hm-panel-bg`), em claro e escuro. No claro é o tom mais escuro da família; no es…
3165
+
3166
+ ```ts
3167
+ interface HermesFamily {
3168
+ id: string;
3169
+ label: string;
3170
+ description: string;
3171
+ light: { accent: string; panelBg: string };
3172
+ dark: { accent: string; panelBg: string };
3173
+ }
3174
+ ```
3175
+
3176
+ - `HermesThemeName`
3177
+
3178
+ ```ts
3179
+ type HermesThemeName = 'light' | 'dark';
3180
+ ```
3181
+
3182
+ - `HermesDensity` — `compact` reescreve a escala de espaçamento/altura de controle (ver `[data-density]` em tokens.css) — não é um tamanho de componente (isso é `size`, um eixo independente).
3183
+
3184
+ ```ts
3185
+ type HermesDensity = 'comfortable' | 'compact';
3186
+ ```
3187
+
3188
+ - `HermesThemeMode` — Preferência de tema: um dos temas fixos ou `system` (acompanha o claro/escuro do sistema operacional, ao vivo). O tema APLICADO continua sendo sempre `HermesThemeName` (`theme`).
3189
+
3190
+ ```ts
3191
+ type HermesThemeMode = HermesThemeName | 'system';
3192
+ ```
3193
+
3194
+ - `HermesLoadingState` — Estado assíncrono de uma ação disparada por botão (ex.: confirmar um modal, salvar um formulário). Puro — sem Angular, sem DOM — para caber no mesmo padrão dos outros stores de `@trismegisto/primitives`; quem desenha o…
3195
+
3196
+ ```ts
3197
+ enum HermesLoadingState {
3198
+ DEFAULT = 'default',
3199
+ LOADING = 'loading',
3200
+ SUCCESS = 'success',
3201
+ ERROR = 'error',
3202
+ }
3203
+ ```
3204
+
3205
+ - `AlertVariant`
3206
+
3207
+ ```ts
3208
+ type AlertVariant = 'error' | 'warning' | 'info' | 'success';
3209
+ ```
3210
+
3211
+ - `ButtonEmphasis` — Montagem das classes CSS `hm-*` (definidas em @trismegisto/core) — igual em qualquer framework.
3212
+
3213
+ ```ts
3214
+ type ButtonEmphasis = 'high' | 'medium' | 'minimal';
3215
+ ```
3216
+
3217
+ - `ButtonIntent`
3218
+
3219
+ ```ts
3220
+ type ButtonIntent = 'primary' | 'success' | 'warning' | 'danger';
3221
+ ```
3222
+
3223
+ - `ButtonSize`
3224
+
3225
+ ```ts
3226
+ type ButtonSize = 'small' | 'medium' | 'large';
3227
+ ```
3228
+
3229
+ - `IconButtonEmphasis`
3230
+
3231
+ ```ts
3232
+ type IconButtonEmphasis = 'filled' | 'outlined' | 'subtle';
3233
+ ```
3234
+
3235
+ - `ModalSize` — Degraus de largura dos overlays (`hm-modal`, `hm-drawer`, `hm-wizard`, `HermesDialogService`). `xlarge` é o degrau acima de `large` (tabelas, comparações lado a lado); `full` ocupa a tela inteira (sem véu à vista, sem c…
3236
+
3237
+ ```ts
3238
+ type ModalSize = 'small' | 'medium' | 'large' | 'xlarge' | 'full';
3239
+ ```
3240
+
3241
+ - `HermesIcon`
3242
+ - `IconBadge`
3243
+ - `MenuItem` — Pop-over e menu de contexto: posicionamento e teclado, sem DOM nem framework.
3244
+
3245
+ ```ts
3246
+ interface MenuItem {
3247
+ readonly id: string;
3248
+ readonly label: string;
3249
+ readonly icon?: string;
3250
+ readonly shortcut?: string;
3251
+ readonly disabled?: boolean;
3252
+ readonly danger?: boolean;
3253
+ readonly separatorAbove?: boolean;
3254
+ readonly groupTitle?: string;
3255
+ readonly children?: readonly MenuItem[];
3256
+ readonly type?: MenuItemType;
3257
+ readonly checked?: boolean;
3258
+ readonly group?: string;
3259
+ readonly value?: string;
3260
+ }
3261
+ ```
3262
+
3263
+ - `MenuItemChange` — O que mudou ao marcar um item de estado (`checkbox`/`radio`).
3264
+
3265
+ ```ts
3266
+ interface MenuItemChange {
3267
+ readonly id: string;
3268
+ readonly type: MenuItemType;
3269
+ readonly checked: boolean;
3270
+ readonly group?: string;
3271
+ readonly value?: string;
3272
+ }
3273
+ ```
3274
+
3275
+ - `MenuItemType`
3276
+
3277
+ ```ts
3278
+ type MenuItemType = 'checkbox' | 'radio';
3279
+ ```
3280
+
3281
+ - `PopoverAlign`
3282
+
3283
+ ```ts
3284
+ type PopoverAlign = 'start' | 'center' | 'end';
3285
+ ```
3286
+
3287
+ - `PopoverAnchor` — Onde o menu abre, em coordenadas de viewport.
3288
+
3289
+ ```ts
3290
+ interface PopoverAnchor {
3291
+ readonly x: number;
3292
+ readonly y: number;
3293
+ readonly right?: number;
3294
+ readonly bottom?: number;
3295
+ readonly side?: PopoverSide;
3296
+ readonly align?: PopoverAlign;
3297
+ }
3298
+ ```
3299
+
3300
+ - `PopoverSide`
3301
+
3302
+ ```ts
3303
+ type PopoverSide = 'top' | 'bottom' | 'left' | 'right';
3304
+ ```
3305
+
3306
+ - `SidebarMode`
3307
+
3308
+ ```ts
3309
+ type SidebarMode = (typeof SIDEBAR_MODES)[number];
3310
+ ```
3311
+
3312
+ - `TabBarState`
3313
+
3314
+ ```ts
3315
+ interface TabBarState {
3316
+ readonly tabs: readonly TabItem[];
3317
+ readonly activeId: string;
3318
+ }
3319
+ ```
3320
+
3321
+ - `TabReorder`
3322
+
3323
+ ```ts
3324
+ interface TabReorder {
3325
+ readonly id: string;
3326
+ readonly index: number;
3327
+ }
3328
+ ```
3329
+
3330
+ - `function createTabBarStore(initial: TabBarState): TabBarStore`
3331
+ - `AlertAppearance` — Onde o alerta mora: `inline` (padrão) é a caixa no meio do conteúdo; `banner` é a faixa de app no topo, largura total, sem cantos.
3332
+
3333
+ ```ts
3334
+ type AlertAppearance = 'inline' | 'banner';
3335
+ ```
3336
+
3337
+ - `FloatingRect` — Janela flutuante não modal (`hm-floating-window`) — geometria sem DOM: arrastar pela barra de título, redimensionar por borda/canto, teclado (mover/redimensionar), limites da viewport, maximizar, persistência opcional e…
3338
+
3339
+ ```ts
3340
+ interface FloatingRect {
3341
+ readonly x: number;
3342
+ readonly y: number;
3343
+ readonly width: number;
3344
+ readonly height: number;
3345
+ }
3346
+ ```
3347
+
3348
+ - `FloatingWindowState` — Estado de exibição: aberta no tamanho dela, só a barra de título, ou ocupando a tela.
3349
+
3350
+ ```ts
3351
+ type FloatingWindowState = 'normal' | 'minimized' | 'maximized';
3352
+ ```
3353
+
3354
+ - `BulkCase` — Caixa aplicada a cada item depois do trim.
3355
+
3356
+ ```ts
3357
+ type BulkCase = 'preserve' | 'lower' | 'upper';
3358
+ ```
3359
+
3360
+ - `BulkInvalidItem`
3361
+
3362
+ ```ts
3363
+ interface BulkInvalidItem {
3364
+ readonly value: string;
3365
+ readonly reason: BulkInvalidReason;
3366
+ readonly message?: string;
3367
+ }
3368
+ ```
3369
+
3370
+ - `BulkInvalidReason` — `format`: reprovado pela validação sem texto próprio; `custom`: com o texto em `message`; `limit`: passou do máximo.
3371
+
3372
+ ```ts
3373
+ type BulkInvalidReason = 'format' | 'custom' | 'limit';
3374
+ ```
3375
+
3376
+ - `BulkParseOptions`
3377
+
3378
+ ```ts
3379
+ interface BulkParseOptions {
3380
+ readonly separators?: readonly BulkSeparator[];
3381
+ readonly trim?: boolean;
3382
+ readonly case?: BulkCase;
3383
+ readonly ignoreCaseDuplicates?: boolean;
3384
+ readonly validate?: BulkValidator | null;
3385
+ readonly max?: number | null;
3386
+ }
3387
+ ```
3388
+
3389
+ - `BulkParseResult`
3390
+
3391
+ ```ts
3392
+ interface BulkParseResult {
3393
+ readonly valid: readonly string[];
3394
+ readonly invalid: readonly BulkInvalidItem[];
3395
+ readonly duplicates: readonly string[];
3396
+ }
3397
+ ```
3398
+
3399
+ - `BulkSeparator` — Separadores aceitos. `space` fica fora do padrão: nome de pessoa tem espaço.
3400
+
3401
+ ```ts
3402
+ type BulkSeparator = 'newline' | 'comma' | 'semicolon' | 'space' | 'tab';
3403
+ ```
3404
+
3405
+ - `BulkValidator` — Validação do app. Regex: vale o que casa. Função: `true` (ou `null`/`undefined`/`''`) vale; `false` é inválido com o motivo padrão; uma string é inválido com ESSE motivo (texto do app, já no idioma dele).
3406
+
3407
+ ```ts
3408
+ type BulkValidator = RegExp | ((item: string) => boolean | string | null | undefined);
3409
+ ```
3410
+
3411
+ - `UploadFile` — Um arquivo na lista do `hm-file-upload`. Imutável: mudanças geram um objeto novo.
3412
+
3413
+ ```ts
3414
+ interface UploadFile<F extends FileLike = File> {
3415
+ readonly id: string;
3416
+ readonly file: F;
3417
+ readonly status: FileUploadStatus;
3418
+ readonly progress: number;
3419
+ readonly error?: string;
3420
+ }
3421
+ ```
3422
+
3423
+ - `UploadFilePatch` — O que dá para mudar num item depois de criado.
3424
+
3425
+ ```ts
3426
+ type UploadFilePatch = Partial<Pick<UploadFile<FileLike>, 'status' | 'progress' | 'error'>>;
3427
+ ```
3428
+
3429
+ - `FileUploadStatus` — Situação de um arquivo na lista: na fila, enviando, enviado, falhou.
3430
+
3431
+ ```ts
3432
+ type FileUploadStatus = 'pending' | 'uploading' | 'done' | 'error';
3433
+ ```
3434
+
3435
+ - `FileRejection`
3436
+
3437
+ ```ts
3438
+ interface FileRejection<F extends FileLike = File> {
3439
+ readonly file: F;
3440
+ readonly reason: FileRejectionReason;
3441
+ }
3442
+ ```
3443
+
3444
+ - `FileRejectionReason` — Por que um arquivo não entrou na lista.
3445
+
3446
+ ```ts
3447
+ type FileRejectionReason = 'type' | 'size' | 'totalSize' | 'count' | 'duplicate';
3448
+ ```
3449
+
3450
+ - `PageWindowItem` — A janela de números de página em volta da atual — desliza em vez de paginar em blocos, então ir de 7 pra 8 não troca a fileira inteira. Pontas sempre visíveis, com "salto" (reticências) no meio quando há intervalo.
3451
+
3452
+ ```ts
3453
+ type PageWindowItem = number | 'gap';
3454
+ ```
3455
+
3456
+ - `PaginationState` — Paginação client-side: fatia uma lista já filtrada (e, se aplicável, ordenada). Não sabe de onde vem a lista nem em que critério está — só corta por página e tamanho.
3457
+
3458
+ ```ts
3459
+ interface PaginationState {
3460
+ readonly page: number;
3461
+ readonly size: number;
3462
+ }
3463
+ ```
3464
+
3465
+ - `const INITIAL_PAGE: PaginationState`
3466
+ - `DateRange` — Intervalo de datas (`hm-date-range-picker`): as duas pontas no formato do controle (`valueFormat`).
3467
+
3468
+ ```ts
3469
+ interface DateRange {
3470
+ readonly start: string | null;
3471
+ readonly end: string | null;
3472
+ }
3473
+ ```
3474
+
3475
+ - `DateValueFormat` — Formato do valor gravado no controle: ISO (padrão, o do `<input type="date">`) ou `dd/mm/yyyy` (formulários que já guardavam a data como texto brasileiro).
3476
+
3477
+ ```ts
3478
+ type DateValueFormat = 'iso' | 'dd/mm/yyyy';
3479
+ ```
3480
+
3481
+ - `IsoDate` — Datas do hm-date-picker / hm-date-range-picker, sem framework. O VALOR é sempre ISO `AAAA-MM-DD` (o mesmo do `<input type="date">` que ele substitui — comparável como texto, sem fuso); o que a pessoa vê e digita é `dd/m…
3482
+
3483
+ ```ts
3484
+ type IsoDate = string;
3485
+ ```
3486
+
3487
+ - `DisplayDatePattern` — Como a data é digitada/exibida num idioma: ordem das partes e separador (pt-BR `dd/mm/aaaa`, en-US `mm/dd/yyyy`, de-DE `dd.mm.yyyy`). Sai do `Intl`, não de uma tabela cravada.
3488
+
3489
+ ```ts
3490
+ interface DisplayDatePattern {
3491
+ readonly order: readonly ('day' | 'month' | 'year')[];
3492
+ readonly separator: string;
3493
+ }
3494
+ ```
3495
+
3496
+ - `const EMPTY_DATE_RANGE: DateRange`
3497
+ - `function normalizeDateRange(value: Partial<DateRange> | null | undefined): DateRange` — `null`/`undefined` (formulário sem valor inicial) e objeto parcial viram um `DateRange` completo.
3498
+ - `function displayDatePattern(locale: string): DisplayDatePattern`
3499
+ - `function formatDisplayDate(value: string | null | undefined, pattern: DisplayDatePattern = DEFAULT_DATE_PATTERN): string` — ISO → texto no padrão do idioma (vazio se inválido).
3500
+ - `function parseDisplayDate(text: string, pattern: DisplayDatePattern = DEFAULT_DATE_PATTERN): IsoDate | null` — Texto digitado no padrão do idioma → ISO; data que não existe (31/02) → null.
3501
+ - `GridColumn` — Definição de coluna. `value` devolve o texto já formatado que a célula mostra; `raw` (quando existe) devolve o valor comparável/filtrável — separar os dois é o que permite filtrar por `>18` numa coluna que exibe "18 ano…
3502
+
3503
+ ```ts
3504
+ interface GridColumn<T> {
3505
+ readonly key: string;
3506
+ readonly title: string;
3507
+ readonly value: (row: T) => string;
3508
+ readonly type?: GridColumnType;
3509
+ readonly raw?: (row: T) => unknown;
3510
+ readonly sortable?: boolean;
3511
+ readonly filterable?: boolean;
3512
+ readonly searchable?: boolean;
3513
+ readonly align?: 'start' | 'end';
3514
+ readonly initialWidth?: string;
3515
+ readonly hideable?: boolean;
3516
+ readonly hidden?: boolean;
3517
+ readonly exportable?: boolean;
3518
+ readonly pinned?: 'start' | 'end';
3519
+ }
3520
+ ```
3521
+
3522
+ - `GridColumnState` — Preferência da pessoa sobre uma coluna — separada da definição, que é de quem desenvolve.
3523
+
3524
+ ```ts
3525
+ interface GridColumnState {
3526
+ readonly key: string;
3527
+ readonly visible: boolean;
3528
+ readonly width?: number;
3529
+ }
3530
+ ```
3531
+
3532
+ - `GridColumnType`
3533
+
3534
+ ```ts
3535
+ type GridColumnType = 'text' | 'number' | 'date' | 'boolean';
3536
+ ```
3537
+
3538
+ - `GridColumnFilterValue` — Filtro de UMA coluna — texto livre (substring, colunas sem poucos valores distintos) OU um conjunto de valores marcados (`columnFilterOptions` devolveu uma lista pra essa coluna). Nunca os dois ao mesmo tempo: o pop-ove…
3539
+
3540
+ ```ts
3541
+ type GridColumnFilterValue = string | readonly string[];
3542
+ ```
3543
+
3544
+ - `GridFilterOption` — Um valor de opção, pro pop-over de filtro de uma coluna categórica.
3545
+
3546
+ ```ts
3547
+ interface GridFilterOption {
3548
+ readonly value: string;
3549
+ readonly label: string;
3550
+ }
3551
+ ```
3552
+
3553
+ - `GridSelection` — Seleção de linhas por id — persiste entre páginas de propósito: nunca se guarda "linhas selecionadas da página atual", sempre o conjunto completo de ids.
3554
+
3555
+ ```ts
3556
+ type GridSelection = ReadonlySet<string>;
3557
+ ```
3558
+
3559
+ - `GridSort` — Ordenação de uma coluna; a prioridade é a posição na lista. O grid só GUARDA a intenção — quem reordena de verdade os dados é quem os possui (ver `hm-data-grid`'s doc: apresentacional).
3560
+
3561
+ ```ts
3562
+ interface GridSort {
3563
+ readonly key: string;
3564
+ readonly direction: SortDirection;
3565
+ }
3566
+ ```
3567
+
3568
+ - `SortDirection`
3569
+
3570
+ ```ts
3571
+ type SortDirection = 'asc' | 'desc';
3572
+ ```
3573
+
3574
+ - `const EMPTY_SELECTION: GridSelection`
3575
+ - `function initialColumnState<T>(columns: readonly GridColumn<T>[]): readonly GridColumnState[]`
3576
+ - `GridFilterOperator`
3577
+
3578
+ ```ts
3579
+ type GridFilterOperator =
3580
+ | 'contains'
3581
+ | 'equals'
3582
+ | 'notEquals'
3583
+ | 'startsWith'
3584
+ | 'greaterThan'
3585
+ | 'lessThan'
3586
+ | 'between'
3587
+ | 'before'
3588
+ | 'after';
3589
+ ```
3590
+
3591
+ - `GridFilterConnector`
3592
+
3593
+ ```ts
3594
+ type GridFilterConnector = 'and' | 'or';
3595
+ ```
3596
+
3597
+ - `GridFilterCondition` — Uma condição. `value`/`valueTo` são texto (número com `.` decimal, data `AAAA-MM-DD`, como os `<input type="number|date">` devolvem); `valueTo` só vale em `between`.
3598
+
3599
+ ```ts
3600
+ interface GridFilterCondition {
3601
+ readonly id: string;
3602
+ readonly column: string;
3603
+ readonly operator: GridFilterOperator;
3604
+ readonly value: string;
3605
+ readonly valueTo?: string;
3606
+ }
3607
+ ```
3608
+
3609
+ - `GridFilterQuery` — Condições combinadas por um conector (todas = E, qualquer uma = OU).
3610
+
3611
+ ```ts
3612
+ interface GridFilterQuery {
3613
+ readonly connector: GridFilterConnector;
3614
+ readonly conditions: readonly GridFilterCondition[];
3615
+ }
3616
+ ```
3617
+
3618
+ - `GridAggregateFn`
3619
+
3620
+ ```ts
3621
+ type GridAggregateFn = 'sum' | 'avg' | 'min' | 'max' | 'count';
3622
+ ```
3623
+
3624
+ - `GridAggregates` — Agregação de cada coluna, por chave: `{ salary: 'sum', age: 'avg' }`.
3625
+
3626
+ ```ts
3627
+ type GridAggregates = Readonly<Record<string, GridAggregateFn>>;
3628
+ ```
3629
+
3630
+ - `GridAggregateFormatter` — Formatador de agregado por coluna (moeda, unidade...). Sem ele vale `formatGridAggregate`.
3631
+
3632
+ ```ts
3633
+ type GridAggregateFormatter = (value: number, fn: GridAggregateFn, key: string) => string;
3634
+ ```
3635
+
3636
+ - `GridCsvSeparator` — Separador de campo: `,` (RFC 4180), `;` (o que o Excel espera onde a vírgula é decimal) ou tab.
3637
+
3638
+ ```ts
3639
+ type GridCsvSeparator = ',' | ';' | '\t';
3640
+ ```
3641
+
3642
+ - `const EMPTY_GRID_QUERY: GridFilterQuery`
3643
+ - `const GRID_FILTER_OPERATORS: readonly GridFilterOperator[]`
3644
+ - `function applyMenuItemChange(items: readonly MenuItem[], change: MenuItemChange): readonly MenuItem[]` — Aplica uma mudança a uma lista de itens (imutável; desce nos `children`): o checkbox troca de estado; o rádio marca o item e desmarca os outros rádios do MESMO `group` no mesmo nível. Para o app que controla o estado gu…
3645
+ - `function menuRadioValue(items: readonly MenuItem[], group: string): string | null` — Valor do rádio marcado num grupo (`value` ou `id`), ou `null` se nenhum estiver marcado.
3646
+ - `const HOVER_OPEN_DELAY = 500` — Atraso padrão para abrir ao passar o mouse (ms): evita abrir em quem só cruza o gatilho.
3647
+ - `const HOVER_CLOSE_DELAY = 300` — Atraso padrão para fechar ao sair (ms): dá tempo de levar o mouse do gatilho até o cartão.
3648
+ - `TimelineDateValue` — Valor aceito como data de um item: `Date`, ISO (`'2026-10-03T14:30'`) ou epoch em milissegundos.
3649
+
3650
+ ```ts
3651
+ type TimelineDateValue = Date | string | number | null | undefined;
3652
+ ```
3653
+
3654
+ - `TimelineOutcome` — Como o processo inteiro está: ainda correndo, concluído ou parado com falha.
3655
+
3656
+ ```ts
3657
+ type TimelineOutcome = 'running' | 'completed' | 'failed';
3658
+ ```
3659
+
3660
+ - `TimelineStatus` — Situação de um item: concluído, o atual, ainda não aconteceu, ou parou com erro.
3661
+
3662
+ ```ts
3663
+ type TimelineStatus = 'completed' | 'current' | 'pending' | 'error';
3664
+ ```
3665
+
3666
+ - `DualListItem`
3667
+
3668
+ ```ts
3669
+ interface DualListItem {
3670
+ readonly id: string;
3671
+ readonly label: string;
3672
+ readonly description?: string;
3673
+ readonly disabled?: boolean;
3674
+ }
3675
+ ```
3676
+
3677
+ - `ShortcutDisplay` — Um atalho: os passos em ordem (`G` depois `H`).
3678
+
3679
+ ```ts
3680
+ type ShortcutDisplay = readonly ShortcutDisplayStep[];
3681
+ ```
3682
+
3683
+ - `ShortcutDisplayStep` — Um passo da sequência: as teclas apertadas juntas.
3684
+
3685
+ ```ts
3686
+ type ShortcutDisplayStep = readonly ShortcutKeyLabel[];
3687
+ ```
3688
+
3689
+ - `ShortcutKeyLabel` — Uma tecla como aparece: o rótulo (`⌘`, `Ctrl`, `K`) e, se houver, o nome para leitor de tela.
3690
+
3691
+ ```ts
3692
+ interface ShortcutKeyLabel {
3693
+ readonly label: string;
3694
+ readonly name: ShortcutKeyName | null;
3695
+ }
3696
+ ```
3697
+
3698
+ - `ShortcutKeyName` — Nome falado de uma tecla cujo rótulo é símbolo ou abreviação — chave do catálogo `shortcuts.keys`.
3699
+
3700
+ ```ts
3701
+ type ShortcutKeyName =
3702
+ | 'command'
3703
+ | 'control'
3704
+ | 'option'
3705
+ | 'alt'
3706
+ | 'shift'
3707
+ | 'meta'
3708
+ | 'up'
3709
+ | 'down'
3710
+ | 'left'
3711
+ | 'right'
3712
+ | 'space'
3713
+ | 'enter'
3714
+ | 'escape'
3715
+ | 'backspace'
3716
+ | 'tab';
3717
+ ```
3718
+
3719
+ - `ShortcutPlatform` — Atalhos de teclado, sem framework: a escrita do atalho (`'Mod+K'`, `'Shift+?'`, a sequência `'G H'`), o casamento com o `KeyboardEvent`, o registro com detecção de conflito, a exibição por plataforma (⌘ no macOS, Ctrl n…
3720
+
3721
+ ```ts
3722
+ type ShortcutPlatform = 'mac' | 'other';
3723
+ ```
3724
+
3725
+ - `CertificateAltName`
3726
+
3727
+ ```ts
3728
+ interface CertificateAltName {
3729
+ readonly type: CertificateAltNameType;
3730
+ readonly value: string;
3731
+ }
3732
+ ```
3733
+
3734
+ - `CertificateAltNameType` — Tipo de um nome alternativo (Subject Alternative Name).
3735
+
3736
+ ```ts
3737
+ type CertificateAltNameType = 'dns' | 'ip' | 'email' | 'uri' | 'other';
3738
+ ```
3739
+
3740
+ - `CertificateDate` — Data aceita nos campos de validade: `Date`, milissegundos ou texto ISO.
3741
+
3742
+ ```ts
3743
+ type CertificateDate = Date | number | string;
3744
+ ```
3745
+
3746
+ - `CertificateDistinguishedName` — Nome distinto (DN) do titular ou do emissor — os atributos mais comuns, todos opcionais.
3747
+
3748
+ ```ts
3749
+ interface CertificateDistinguishedName {
3750
+ readonly commonName?: string;
3751
+ readonly organization?: string;
3752
+ readonly organizationalUnit?: string;
3753
+ readonly locality?: string;
3754
+ readonly stateOrProvince?: string;
3755
+ readonly country?: string;
3756
+ readonly email?: string;
3757
+ }
3758
+ ```
3759
+
3760
+ - `CertificateInfo` — Um certificado, com os campos que o visualizador mostra.
3761
+
3762
+ ```ts
3763
+ interface CertificateInfo {
3764
+ readonly subject: CertificateDistinguishedName;
3765
+ readonly issuer: CertificateDistinguishedName;
3766
+ readonly serialNumber: string;
3767
+ readonly notBefore: CertificateDate;
3768
+ readonly notAfter: CertificateDate;
3769
+ readonly signatureAlgorithm?: string;
3770
+ readonly publicKeyAlgorithm?: string;
3771
+ readonly version?: number;
3772
+ readonly fingerprints?: { readonly sha1?: string; readonly sha256?: string };
3773
+ readonly keyUsage?: readonly CertificateKeyUsage[];
3774
+ readonly extendedKeyUsage?: readonly string[];
3775
+ readonly subjectAltNames?: readonly CertificateAltName[];
3776
+ readonly isCertificateAuthority?: boolean;
3777
+ }
3778
+ ```
3779
+
3780
+ - `CertificateKeyUsage` — Bits da extensão Key Usage (RFC 5280 §4.2.1.3), com o nome usado pelo `pkijs`/OpenSSL.
3781
+
3782
+ ```ts
3783
+ type CertificateKeyUsage =
3784
+ | 'digitalSignature'
3785
+ | 'nonRepudiation'
3786
+ | 'keyEncipherment'
3787
+ | 'dataEncipherment'
3788
+ | 'keyAgreement'
3789
+ | 'keyCertSign'
3790
+ | 'cRLSign'
3791
+ | 'encipherOnly'
3792
+ | 'decipherOnly';
3793
+ ```
3794
+
3795
+ - `CertificateValidity`
3796
+
3797
+ ```ts
3798
+ interface CertificateValidity {
3799
+ readonly state: CertificateValidityState;
3800
+ readonly days: number;
3801
+ }
3802
+ ```
3803
+
3804
+ - `CertificateValidityOptions`
3805
+
3806
+ ```ts
3807
+ interface CertificateValidityOptions {
3808
+ readonly now?: CertificateDate;
3809
+ readonly warningDays?: number;
3810
+ }
3811
+ ```
3812
+
3813
+ - `CertificateValidityState` — Situação de validade em relação a uma data de referência.
3814
+
3815
+ ```ts
3816
+ type CertificateValidityState = 'valid' | 'expiring' | 'expired' | 'not-yet-valid';
3817
+ ```
3818
+
3819
+ - `const CERTIFICATE_NAME_FIELDS =` — Ordem de exibição dos atributos do DN.
3820
+ - `const CERTIFICATE_WARNING_DAYS = 30` — Limite padrão de "vence em breve".
3821
+ - `function certificateValidity( notBefore: CertificateDate, notAfter: CertificateDate, options: CertificateValidityOptions = {}, ): CertificateValidity` — Situação de validade de um certificado: ainda não válido, vencido, vence em breve (dentro de `warningDays`) ou válido. Os limites são inclusivos: no instante `notBefore` já vale; no instante `notAfter` ainda vale. Data…
3822
+ - `SplitterOrientation` — Divisor arrastável entre dois painéis (`hm-splitter`) — padrão WAI-ARIA APG "Window Splitter". Lógica pura (sem DOM): posição em porcentagem do painel PRIMÁRIO (0–100), limites, teclado, arrasto e o template de grid. O…
3823
+
3824
+ ```ts
3825
+ type SplitterOrientation = 'horizontal' | 'vertical';
3826
+ ```
3827
+
3828
+ - `ToastVariant`
3829
+
3830
+ ```ts
3831
+ type AlertVariant = 'error' | 'warning' | 'info' | 'success';
3832
+ ```
3833
+
3834
+ - `ToastItem` — Um aviso na fila do canto da tela.
3835
+
3836
+ ```ts
3837
+ interface ToastItem {
3838
+ readonly id: string;
3839
+ readonly variant: AlertVariant;
3840
+ readonly message: string;
3841
+ readonly title: string;
3842
+ readonly duration: number;
3843
+ readonly durationBeforePause?: number;
3844
+ readonly action?: ToastAction;
3845
+ }
3846
+ ```
3847
+
3848
+ - `ToastPushOptions`
3849
+
3850
+ ```ts
3851
+ interface ToastPushOptions {
3852
+ readonly title?: string;
3853
+ readonly duration?: number;
3854
+ readonly action?: ToastAction;
3855
+ }
3856
+ ```
3857
+
3858
+ - `ToastState`
3859
+
3860
+ ```ts
3861
+ interface ToastState {
3862
+ readonly toasts: readonly ToastItem[];
3863
+ }
3864
+ ```
3865
+
3866
+ - `ToastAction` — Ação de um aviso (ex.: "Desfazer"). `run` é chamado no clique e o aviso fecha em seguida.
3867
+
3868
+ ```ts
3869
+ interface ToastAction {
3870
+ readonly label: string;
3871
+ readonly run: () => void;
3872
+ }
3873
+ ```
3874
+
3875
+ - `DropZone` — Onde uma aba arrastada cairia sobre um painel: borda = divide naquela direção; centro = move pra lá sem dividir.
3876
+
3877
+ ```ts
3878
+ type DropZone = 'left' | 'right' | 'top' | 'bottom' | 'center';
3879
+ ```
3880
+
3881
+ - `PanelLeaf`
3882
+
3883
+ ```ts
3884
+ interface PanelLeaf {
3885
+ readonly kind: 'panel';
3886
+ readonly id: string;
3887
+ readonly tabs: TabBarState;
3888
+ }
3889
+ ```
3890
+
3891
+ - `PanelNode`
3892
+
3893
+ ```ts
3894
+ type PanelNode = PanelLeaf | PanelSplit;
3895
+ ```
3896
+
3897
+ - `PanelSplit`
3898
+
3899
+ ```ts
3900
+ interface PanelSplit {
3901
+ readonly kind: 'split';
3902
+ readonly direction: SplitDirection;
3903
+ readonly ratio: number;
3904
+ readonly a: PanelNode;
3905
+ readonly b: PanelNode;
3906
+ }
3907
+ ```
3908
+
3909
+ - `PersistedPanelNode` — Formato persistido: a MESMA forma de `PanelNode`, mas cada folha vira só `tabIds`/`activeId` — nunca o `TabItem` inteiro. Rótulo/ícone podem ficar velhos (ex.: depois de trocar de idioma); quem restaura sempre re-resolv…
3910
+
3911
+ ```ts
3912
+ type PersistedPanelNode =
3913
+ | { readonly kind: 'panel'; readonly tabIds: readonly string[]; readonly activeId: string }
3914
+ | { readonly kind: 'split'; readonly direction: SplitDirection; readonly ratio: number; readonly a: PersistedPanelNode; readonly b: PersistedPanelNode };
3915
+ ```
3916
+
3917
+ - `PersistedWorkspace`
3918
+
3919
+ ```ts
3920
+ interface PersistedWorkspace {
3921
+ readonly root: PersistedPanelNode;
3922
+ readonly focusedPath: SplitPath;
3923
+ }
3924
+ ```
3925
+
3926
+ - `SplitDirection`
3927
+
3928
+ ```ts
3929
+ type SplitDirection = 'row' | 'column';
3930
+ ```
3931
+
3932
+ - `SplitPath`
3933
+
3934
+ ```ts
3935
+ type SplitPath = readonly SplitStep[];
3936
+ ```
3937
+
3938
+ - `SplitStep` — Endereço de um nó `PanelSplit` dentro da árvore, a partir da raiz.
3939
+
3940
+ ```ts
3941
+ type SplitStep = 'a' | 'b';
3942
+ ```
3943
+
3944
+ - `WorkspaceKeyAction`
3945
+
3946
+ ```ts
3947
+ type WorkspaceKeyAction =
3948
+ | { readonly type: 'focus-panel'; readonly panelId: string }
3949
+ | { readonly type: 'move-tab-to-panel'; readonly panelId: string }
3950
+ | { readonly type: 'split-panel'; readonly direction: SplitDirection }
3951
+ | { readonly type: 'close-panel' };
3952
+ ```
3953
+
3954
+ - `WorkspacePersistenceConfig`
3955
+
3956
+ ```ts
3957
+ interface WorkspacePersistenceConfig {
3958
+ readonly storagePrefix: string;
3959
+ }
3960
+ ```
3961
+
3962
+ - `WorkspaceState`
3963
+
3964
+ ```ts
3965
+ interface WorkspaceState {
3966
+ readonly root: PanelNode;
3967
+ readonly focusedPanelId: string;
3968
+ }
3969
+ ```
3970
+
3971
+ - `WorkspaceStorage` — O motor puro nunca persiste nada sozinho (handoff §9, não-meta explícita: persistência é decisão de produto do app consumidor). O que segue é só o PRIMITIVE reusável — mesmo padrão já usado por `theme.ts`/`HermesThemeCo…
3972
+
3973
+ ```ts
3974
+ type WorkspaceStorage = Pick<Storage, 'getItem' | 'setItem'>;
3975
+ ```
3976
+
3977
+ - `WorkspaceStore`
3978
+
3979
+ ```ts
3980
+ interface WorkspaceStore {
3981
+ getState(): WorkspaceState;
3982
+ subscribe(listener: (state: WorkspaceState) => void): () => void;
3983
+ splitPanel(panelId: string, direction: SplitDirection, newTab: TabItem): string;
3984
+ moveTab(tabId: string, fromPanelId: string, toPanelId: string, zone: DropZone, index?: number): void;
3985
+ resizeSplit(path: SplitPath, ratio: number): void;
3986
+ closePanel(panelId: string): void;
3987
+ focusPanel(panelId: string): void;
3988
+ activateTab(panelId: string, tabId: string): void;
3989
+ closeTab(panelId: string, tabId: string): void;
3990
+ closeOtherTabs(panelId: string, tabId: string): void;
3991
+ closeTabsToTheRight(panelId: string, tabId: string): void;
3992
+ reorderTab(panelId: string, tabId: string, index: number): void;
3993
+ openTab(panelId: string, tab: TabItem, options?: { activate?: boolean }): void;
3994
+ navigateActiveTab(panelId: string, tab: TabItem): void;
3995
+ }
3996
+ ```
3997
+
3998
+ - `const DEFAULT_WORKSPACE_PERSISTENCE_CONFIG: WorkspacePersistenceConfig`
3999
+ - `function createWorkspaceStore(initialTabs: TabBarState): WorkspaceStore` — Cria a área de trabalho com um único painel, já com `initialTabs`. O id desse primeiro painel é gerado internamente (mesmo padrão de qualquer painel novo — quem consome nunca precisa inventar um id de painel).
4000
+ - `function cyclicPanelNeighbor(panelIds: readonly string[], panelId: string, step: 1 | -1): string | null` — Painel vizinho na ordem da árvore, cíclico (o último volta pro primeiro). `null` sem vizinho (um painel só, ou id desconhecido). Exportada pra a camada Angular usar a MESMA regra no item "mover para outro painel" do men…
4001
+ - `function dropZone(rect: { readonly left: number; readonly top: number; readonly width: number; readonly height: number }, x: number, y: number): DropZone` — Borda do retângulo do painel mais perto do ponteiro — a faixa de borda é uma fração da dimensão do painel (`DROP_EDGE_FRACTION`), não um valor fixo, então um painel estreito não fica com uma borda maior que ele mesmo. A…
4002
+ - `function findPanelContainingTab(node: PanelNode, tabId: string): string | null` — Em qual painel (por id) mora a aba `tabId` — usado pra achar de onde uma aba arrastada saiu sem precisar de um segundo tipo de dado no `dataTransfer` (o `hm-tab-bar` não sabe o que é um "painel"; a árvore já sabe onde c…
4003
+ - `function findPanelTabs(node: PanelNode, panelId: string): TabBarState | null` — As abas do painel `panelId` (tabs + qual está ativa), ou `null` se o painel não existir mais na árvore — o que quem integra o workspace com um roteador de verdade precisa pra saber "qual é a aba ativa do painel focado a…
4004
+ - `function isValidPersistedWorkspace(value: unknown): value is PersistedWorkspace` — Nunca confia cegamente no que veio do storage — valida a forma inteira antes de aceitar (mesma regra de `readLanguage`/`readStoredTabs` já usadas nesta base).
4005
+ - `function loadWorkspace(config: WorkspacePersistenceConfig, storage: WorkspaceStorage | null): PersistedWorkspace | null` — Lê e valida o que está salvo; `null` se não houver nada, a versão não bater, ou a forma for inválida — quem chama cai no fallback de sempre (`createWorkspaceStore` simples).
4006
+ - `function panelIdsInOrder(node: PanelNode): readonly string[]` — Ids de todo painel da árvore, na ordem de leitura (esquerda→direita, cima→baixo).
4007
+ - `function restoreWorkspaceStore(persisted: PersistedWorkspace, resolveTab: (id: string) => TabItem | null): WorkspaceStore | null` — Recria um `WorkspaceStore` a partir de estado persistido. `null` se a árvore restaurada esvaziar por completo (todas as abas salvas apontavam pra páginas que sumiram) — quem chama cai no fallback de sempre (`createWorks…
4008
+ - `function saveWorkspace(state: WorkspaceState, config: WorkspacePersistenceConfig, storage: WorkspaceStorage | null): void` — Grava o estado atual. Try/catch mudo (cota estourada, modo privado, storage indisponível) — perder o arranjo salvo é aceitável, quebrar a aplicação por causa disso não é (mesmo padrão de `theme.ts`/`language.ts`). Debou…
4009
+ - `function toPersistedWorkspace(state: WorkspaceState): PersistedWorkspace` — `WorkspaceState` (com painéis/stores de verdade) → forma persistível.
4010
+ - `function workspaceKeyAction( event: Pick<KeyboardEvent, 'key' | 'ctrlKey' | 'altKey' | 'shiftKey'>, panelIds: readonly string[], focusedPanelId: string, ): WorkspaceKeyAction | null` — Atalhos do workspace com o foco num painel. Mover o foco (ou a aba) é cíclico na ordem da árvore (próximo/anterior) — suficiente pro MVP (no máximo poucos painéis, onde o vizinho "óbvio" já é cíclico). Navegação geométr…
4011
+ - `CarouselSlide`
4012
+
4013
+ ```ts
4014
+ interface CarouselSlide {
4015
+ readonly title: string;
4016
+ readonly text: string;
4017
+ readonly image: string;
4018
+ readonly alt: string;
4019
+ }
4020
+ ```