@acropole/skills 1.2.0 → 1.3.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.
@@ -1,7 +1,7 @@
1
1
  # Catálogo de API — @trismegisto/angular
2
2
 
3
- > **Gerado** a partir do código-fonte da versão 1.0.0, a cada `npm run sync` do @acropole/skills.
4
- > Gerado do código-fonte do `@trismegisto/angular` 1.0.0. Confira a versão instalada no `package.json` do pacote em `node_modules`.
3
+ > **Gerado** a partir do código-fonte da versão 1.0.2, a cada `npm run sync` do @acropole/skills.
4
+ > Gerado do código-fonte do `@trismegisto/angular` 1.0.2. Confira a versão instalada no `package.json` do pacote em `node_modules`.
5
5
 
6
6
  Legenda: `input` = `[prop]`; `model` = two-way `[(prop)]`; `output` = `(evento)`.
7
7
  Slots são os seletores de `<ng-content>`: projete com o atributo (ex.: `<div footer>`).
@@ -13,7 +13,7 @@ Membros "herdados" vêm da classe base (ex.: `HermesFormFieldBase` dá `disabled
13
13
 
14
14
  `AccordionContentDirective` — import de `@trismegisto/angular/accordion` (também na raiz)
15
15
 
16
- Conteúdo preguiçoso de um `hm-accordion-panel`: o template só é montado na **primeira vez** que o painel abre, e depois fica montado (o corpo recolhido continua `inert`, como sempre), para não perder estado ao reabrir. Com `destroyOnClose` no painel, o conteúdo é destruído ao fechar e montado de novo ao abrir.
16
+ Corpo preguiçoso de um `hm-accordion-panel`: `<ng-template hmAccordionContent>…</ng-template>` (ou `*hmAccordionContent`) como filho direto. Criado na primeira abertura e mantido ao fechar, a menos que o painel tenha `destroyOnClose`.
17
17
 
18
18
  _Sem inputs/outputs._
19
19
 
@@ -21,7 +21,7 @@ _Sem inputs/outputs._
21
21
 
22
22
  `AccordionPanelComponent` — import de `@trismegisto/angular/accordion` (também na raiz)
23
23
 
24
- Um bloco do acordeão: cabeçalho clicável, indicador de expansão e o painel que abre.
24
+ Um painel de acordeão: cabeçalho (`[heading]` e, opcional, `[description]`) que abre e fecha o corpo.
25
25
 
26
26
  Slots: `[heading]`, `[description]`, `(padrão)`
27
27
 
@@ -30,15 +30,15 @@ Métodos públicos: `close(): void`
30
30
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
31
31
  |---|---|---|---|---|
32
32
  | `disabled` | input | `boolean` | `false` | |
33
- | `headingLevel` | input | `number` | `3` | Nível do cabeçalho na página, para o `aria-level` (o `h1` da tela é 1). |
34
- | `open` | model | `boolean` | `false` | Two-way: o clique no cabeçalho escreve aqui, e quem usa pode abrir de fora. |
35
- | `destroyOnClose` | input | `boolean` | `false` | Com conteúdo preguiçoso (`hmAccordionContent`), destrói o conteúdo ao fechar em vez de mantê-lo montado. Use quando o conteúdo precisa recomeçar a cada abertur… |
33
+ | `headingLevel` | input | `number` | `3` | Nível do título (`aria-level`) dentro da hierarquia da página. |
34
+ | `open` | model | `boolean` | `false` | |
35
+ | `destroyOnClose` | input | `boolean` | `false` | Com `hmAccordionContent`: destrói o corpo ao fechar (recria ao abrir). |
36
36
 
37
37
  ## `hm-accordion`
38
38
 
39
39
  `AccordionComponent` — import de `@trismegisto/angular/accordion` (também na raiz)
40
40
 
41
- Grupo de blocos que abrem e fecham: reúne os `hm-accordion-panel` numa superfície só, decide quantos podem ficar abertos ao mesmo tempo e liga a navegação por seta entre os cabeçalhos.
41
+ Grupo de painéis que abrem e fecham (`hm-accordion-panel`). Por padrão só um fica aberto por vez; `multi` permite vários. As setas ↑/↓ e Home/End passeiam pelos cabeçalhos do grupo (só movem o foco).
42
42
 
43
43
  Slots: `(padrão)`
44
44
 
@@ -46,26 +46,26 @@ Métodos públicos: `closeOthers(opened: { close(): void }): void`
46
46
 
47
47
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
48
48
  |---|---|---|---|---|
49
- | `multi` | input | `boolean` | `false` | Permite mais de um painel aberto. Desligado, abrir um recolhe o que estava aberto. |
49
+ | `multi` | input | `boolean` | `false` | Permite mais de um painel aberto ao mesmo tempo. |
50
50
 
51
51
  ## `hm-account-avatar`
52
52
 
53
53
  `AccountAvatarComponent` — import de `@trismegisto/angular/account-avatar` (também na raiz)
54
54
 
55
- Avatar de conta. A ordem é **foto → iniciais → ícone genérico**: mostra a imagem quando há `imageUrl` (e ela carrega); sem URL ou com a imagem quebrada, as iniciais do `name`; sem nome também, o ícone de pessoa. Cair direto no ícone quando falta a foto jogaria fora o que o nome diz — duas pessoas virariam o mesmo boneco numa lista.
55
+ Círculo que identifica uma pessoa ao lado do nome dela (menu da conta, autor de comentário, responsável numa lista).
56
56
 
57
57
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
58
58
  |---|---|---|---|---|
59
- | `name` | input | `string` | `''` | Nome da conta: origem das iniciais. Vazio (e sem foto) = ícone genérico. |
60
- | `imageUrl` | input | `string \| null \| undefined` | `null` | Foto da conta; opcional. |
61
- | `size` | input | `AccountAvatarSize \| null` | `null` | Tamanho na escala do sistema. Sem valor, herda `--hm-avatar-size` (36px por padrão). |
62
- | `loading` | input | `boolean` | `false` | Dado da conta ainda não chegou: círculo de esqueleto no lugar do retrato. |
59
+ | `name` | input | `string` | `''` | Nome da pessoa, de onde saem as iniciais. Vazio e sem foto, aparece o ícone genérico. |
60
+ | `imageUrl` | input | `string \| null \| undefined` | `null` | Endereço da foto (opcional). Se não carregar, ficam as iniciais. |
61
+ | `size` | input | `AccountAvatarSize \| null` | `null` | Diâmetro na escala do sistema. Sem valor, segue o `--hm-avatar-size` herdado. |
62
+ | `loading` | input | `boolean` | `false` | Os dados da pessoa ainda não chegaram: mostra o placeholder de carregamento. |
63
63
 
64
64
  ## `hm-alert-group`
65
65
 
66
66
  `AlertGroupComponent` — import de `@trismegisto/angular/alert` (também na raiz)
67
67
 
68
- Paginador de alertas: vários `hm-alert` numa faixa só, um por vez, com "1 de 3" e anterior/próximo. Feito para os alertas de app (`appearance="banner"`) no topo do shell, mas aceita qualquer `hm-alert`.
68
+ Empilha vários `hm-alert` numa faixa só e mostra um por vez, com paginador ("2 de 3") quando há mais de um aberto. Alertas fechados saem da conta. `[(current)]` é o índice pedido; o mostrado é esse índice preso ao número de abertos, então fechar o último não deixa a faixa vazia.
69
69
 
70
70
  Slots: `hm-alert`
71
71
 
@@ -73,14 +73,14 @@ Métodos públicos: `isCurrent(alert: object): boolean`
73
73
 
74
74
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
75
75
  |---|---|---|---|---|
76
- | `label` | input | `string` | `''` | Nome da faixa para o leitor de tela. Vazio = "N alertas" (`HERMES_MESSAGES.alert.groupLabel`). |
77
- | `current` | model | `number` | `0` | Posição do alerta visível, 0-based, contando só os abertos. |
76
+ | `label` | input | `string` | `''` | Nome da região; vazio usa a contagem ("3 alertas"). |
77
+ | `current` | model | `number` | `0` | Índice pedido entre os alertas abertos. |
78
78
 
79
79
  ## `hm-alert`
80
80
 
81
81
  `AlertComponent` — import de `@trismegisto/angular/alert` (também na raiz)
82
82
 
83
- Mensagem em destaque, com título, ações e fechamento opcionais.
83
+ Aviso dentro do conteúdo (`inline`) ou faixa do app (`banner`). O erro interrompe o leitor de tela (`role="alert"`); os outros tons são `status`. Cada tom tem glifo próprio, então a cor nunca é o único sinal.
84
84
 
85
85
  Slots: `(padrão)`, `[actions]`
86
86
 
@@ -89,16 +89,16 @@ Métodos públicos: `close(): void`
89
89
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
90
90
  |---|---|---|---|---|
91
91
  | `variant` | input | `AlertVariant` | `'info'` | |
92
- | `appearance` | input | `AlertAppearance` | `'inline'` | `inline` (padrão): caixa no conteúdo. `banner`: faixa de app no topo, largura total, sem cantos. |
93
- | `heading` | input | `string` | `''` | Primeira linha em negrito (ex.: "Manutenção programada"). Vazio não desenha. |
92
+ | `appearance` | input | `AlertAppearance` | `'inline'` | |
93
+ | `heading` | input | `string` | `''` | |
94
94
  | `closable` | input | `boolean` | `false` | |
95
- | `size` | input | `AlertSize` | `'medium'` | `small`: versão compacta (menos respiro, texto e ícone menores). |
95
+ | `size` | input | `AlertSize` | `'medium'` | |
96
96
  | `showIcon` | input | `boolean` | `true` | |
97
- | `link` | input | `string` | `''` | URL de um link de ação à direita da mensagem. Vazio não desenha. |
98
- | `linkLabel` | input | `string` | `''` | Texto do link. Vazio = `HERMES_MESSAGES.alert.linkLabel` ("Saiba mais"). |
99
- | `linkTarget` | input | `string` | `''` | `_blank` abre em nova aba (com `rel="noopener noreferrer"` e aviso ao leitor de tela). |
100
- | `dismissKey` | input | `string` | `''` | Chave para lembrar o fechamento entre visitas (`localStorage`). Vazio (padrão) = fechar vale só para esta visita. Use um id estável e versionado por mensagem (… |
101
- | `duration` | input | `number` | `0` | Fecha sozinho depois de N ms. `0` (padrão) mantém na tela. Não usar em `error`. |
97
+ | `link` | input | `string` | `''` | URL do atalho de ação. |
98
+ | `linkLabel` | input | `string` | `''` | Texto do atalho; vazio usa o do catálogo. |
99
+ | `linkTarget` | input | `string` | `''` | |
100
+ | `dismissKey` | input | `string` | `''` | Chave para lembrar o fechamento entre visitas. |
101
+ | `duration` | input | `number` | `0` | Fecha sozinho depois de N ms (0 = nunca). |
102
102
  | `closed` | output | `void` | | |
103
103
 
104
104
  ## `hm-attachment-group`
@@ -147,46 +147,46 @@ Slots: `(padrão)`
147
147
 
148
148
  `AvatarGroupComponent` — import de `@trismegisto/angular/avatar-group` (também na raiz)
149
149
 
150
- Pilha de avatares sobrepostos (`hm-avatar-group`): quem participa de algo, quando são poucos e o rosto basta para reconhecer. Compõe `hm-account-avatar` (foto ou iniciais).
150
+ Rostos sobrepostos de quem participa de algo (responsáveis, membros, revisores), com "+N" para o que passar do limite.
151
151
 
152
152
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
153
153
  |---|---|---|---|---|
154
154
  | `people` | input (obrigatório) | `readonly AvatarGroupPerson[]` | | |
155
- | `max` | input | `number` | `3` | Quantos rostos aparecem antes do "+N". 0 = todos. |
155
+ | `max` | input | `number` | `3` | Quantos rostos aparecem antes do "+N". `0` = sem limite. |
156
156
  | `size` | input | `AvatarGroupSize` | `'medium'` | |
157
- | `label` | input | `string` | `''` | Do que essas pessoas fazem parte ("Responsáveis", "Participantes"). Vazio = catálogo ("Pessoas"). |
157
+ | `label` | input | `string` | `''` | Nome da lista. Vazio usa o texto padrão do catálogo. |
158
158
 
159
159
  ## `hm-badge`
160
160
 
161
161
  `BadgeComponent` — import de `@trismegisto/angular/badge` (também na raiz)
162
162
 
163
- Contador que se ancora no canto de outra coisa (um sino, um ícone de módulo) — diz QUANTOS, não O QUÊ. Sem `value` (ou com `dot`) vira um ponto sólido: "tem algo novo" quando o número não importa.
163
+ Contador pequeno ao lado de um rótulo (itens novos, pendências) ou só um ponto de "tem novidade".
164
164
 
165
165
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
166
166
  |---|---|---|---|---|
167
- | `value` | input | `number` | `0` | Zero ou negativo esconde o badge (a menos que `dot`): "0 notificações" é ruído. |
168
- | `max` | input | | `BADGE_DEFAULT_MAX` | Acima disto o texto vira `{max}+`. |
169
- | `dot` | input | `boolean` | `false` | Só o ponto, sem número. |
167
+ | `value` | input | `number` | `0` | |
168
+ | `max` | input | `number` | `BADGE_DEFAULT_MAX` | Teto do número exibido; acima dele aparece `max+`. |
169
+ | `dot` | input | `boolean` | `false` | Só o ponto, sem número (aparece mesmo com `value` 0). |
170
170
  | `intent` | input | `BadgeIntent` | `'danger'` | |
171
- | `label` | input | `string` | `''` | O que o leitor de tela anuncia, ex.: "3 notificações não lidas". Vazio: decorativo. |
171
+ | `label` | input | `string` | `''` | Nome acessível. Vazio deixa o contador fora do leitor de tela. |
172
172
 
173
173
  ## `hm-breadcrumb`
174
174
 
175
175
  `BreadcrumbComponent` — import de `@trismegisto/angular/breadcrumb` (também na raiz)
176
176
 
177
- Trilha "você está aqui": o caminho até a página atual, com volta a qualquer nível num clique. O último item é a página atual — sem link, com `aria-current="page"`.
177
+ Trilha de navegação ("você está aqui"): `<nav>` nomeado com uma lista ordenada; o último degrau é a página atual (`aria-current="page"`, nunca link).
178
178
 
179
179
  Slots: `[actions]`
180
180
 
181
181
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
182
182
  |---|---|---|---|---|
183
183
  | `items` | input (obrigatório) | `readonly BreadcrumbItem[]` | | |
184
- | `maxItems` | input | `number` | `4` | Acima disto o meio recolhe. `0` = nunca recolhe. |
185
- | `itemsBeforeCollapse` | input | `number` | `1` | Quantos níveis ficam visíveis antes do "…". |
186
- | `itemsAfterCollapse` | input | `number` | `2` | Quantos níveis ficam visíveis depois do "…" (contando a página atual). |
187
- | `label` | input | `string` | `''` | Nome do `nav`. Vazio = texto do catálogo ("Você está aqui"). |
188
- | `loading` | input | `boolean` | `false` | Silhueta no lugar da trilha enquanto a rota resolve. |
189
- | `itemClick` | output | `BreadcrumbItem` | | Clique num degrau com link — além da navegação, para quem precisa reagir (analytics, estado). |
184
+ | `maxItems` | input | `number` | `4` | Acima disto a trilha recolhe o meio. `0` nunca recolhe. |
185
+ | `itemsBeforeCollapse` | input | `number` | `1` | Degraus visíveis antes do "…" (mínimo 1). |
186
+ | `itemsAfterCollapse` | input | `number` | `2` | Degraus visíveis depois do "…" (mínimo 1). |
187
+ | `label` | input | `string` | `''` | Nome do `<nav>`. Vazio = texto do catálogo. |
188
+ | `loading` | input | `boolean` | `false` | Mostra a silhueta no lugar da trilha. |
189
+ | `itemClick` | output | `BreadcrumbItem` | | Clique num degrau com link (além da navegação). |
190
190
 
191
191
  ## `hm-bubble`
192
192
 
@@ -207,29 +207,29 @@ Slots: `(padrão)`
207
207
 
208
208
  `BulkInputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/bulk-input` (também na raiz)
209
209
 
210
- Entrada em lote: a pessoa cola uma lista (de planilha, chamado, CSV) num textarea e vê, enquanto escreve, quantos itens valem, quantos não valem e quantos vieram repetidos. Os inválidos aparecem listados com o motivo e saem no ×; o valor do campo é só o `string[]` dos válidos.
210
+ Campo para colar ou digitar vários itens de uma vez (e-mails, códigos, matrículas). O valor do formulário é sempre a lista de itens válidos lida do texto; o texto continua sendo o que a pessoa escreveu, para ela corrigir no lugar o que foi recusado.
211
211
 
212
212
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
213
213
  |---|---|---|---|---|
214
- | `value` | model | `string[]` | `[]` | Os itens válidos, sem repetição, na ordem em que apareceram. |
214
+ | `value` | model | `string[]` | `[]` | |
215
215
  | `label` | input (obrigatório) | `string` | | |
216
- | `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
216
+ | `hint` | input | `string` | `''` | |
217
217
  | `placeholder` | input | `string` | `''` | |
218
218
  | `rows` | input | `number` | `5` | |
219
- | `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
219
+ | `labelHidden` | input | `boolean` | `false` | Tira o rótulo da vista sem tirá-lo do leitor de tela. |
220
220
  | `loading` | input | `boolean` | `false` | |
221
- | `separators` | input | `readonly BulkSeparator[]` | `BULK_DEFAULT_SEPARATORS` | Separadores aceitos. Padrão: quebra de linha, vírgula, ponto e vírgula e tab. |
222
- | `trim` | input | `boolean` | `true` | Tira espaço das pontas de cada item. |
223
- | `textCase` | input | `BulkCase` | `'preserve'` | Caixa aplicada a cada item: `preserve`, `lower` ou `upper`. |
224
- | `ignoreCaseDuplicates` | input | `boolean` | `false` | Repetido sem diferenciar maiúscula de minúscula (fica a 1ª forma escrita). |
225
- | `validate` | input | `BulkValidator \| null` | `null` | Regex ou função do app; a função pode devolver o motivo em texto (já no idioma do app). |
226
- | `max` | input | `number \| null` | `null` | Máximo de itens válidos; o excedente vira inválido com o motivo de limite. |
227
- | `announceDelay` | input | `number` | `800` | Pausa, em ms, antes de anunciar o resumo ao leitor de tela. |
228
- | `parsed` | output | `BulkParseResult` | | Resultado completo da leitura, a cada mudança do texto. |
229
- | `disabled` | input (herdado) | `boolean` | `false` | |
230
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
231
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
232
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
221
+ | `separators` | input | `readonly BulkSeparator[]` | `BULK_DEFAULT_SEPARATORS` | |
222
+ | `trim` | input | `boolean` | `true` | |
223
+ | `textCase` | input | `BulkCase` | `'preserve'` | |
224
+ | `ignoreCaseDuplicates` | input | `boolean` | `false` | |
225
+ | `validate` | input | `BulkValidator \| null` | `null` | |
226
+ | `max` | input | `number \| null` | `null` | |
227
+ | `announceDelay` | input | `number` | `800` | Pausa (ms) sem digitar antes de o resumo ser falado. |
228
+ | `parsed` | output | `BulkParseResult` | | Leitura completa do texto (válidos, inválidos, repetidos) a cada mudança dela. |
229
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
230
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
231
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
232
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
233
233
 
234
234
  ## `hm-button-group`
235
235
 
@@ -251,6 +251,8 @@ Métodos públicos: `register(button: ButtonComponent): void`, `unregister(butto
251
251
 
252
252
  `ButtonComponent` — import de `@trismegisto/angular/button` (também na raiz)
253
253
 
254
+ Botão de ação (`<button>`) ou de navegação (`<a>`, com `link`).
255
+
254
256
  Slots: `[mark]`, `(padrão)`
255
257
 
256
258
  Métodos públicos: `activateFromMenu(): void`
@@ -260,22 +262,22 @@ Métodos públicos: `activateFromMenu(): void`
260
262
  | `emphasis` | input | `ButtonEmphasis` | `'high'` | |
261
263
  | `intent` | input | `ButtonIntent` | `'primary'` | |
262
264
  | `size` | input | `ButtonSize` | `'medium'` | |
263
- | `type` | input | `'button' \| 'submit'` | `'button'` | `submit` dentro de `<form>`; `button` no resto. Ignorado quando há `link`. |
264
- | `icon` | input | `string` | `''` | Ícone do hermes-icon antes do rótulo (shape). Decorativo. |
265
- | `iconDirection` | input | `string` | `''` | hermes-icon direcional (ex.: shape="angle") precisa de `direction` além de `shape`. |
266
- | `iconEnd` | input | `string` | `''` | |
265
+ | `type` | input | `'button' \| 'submit'` | `'button'` | Tipo do `<button>`. Sem efeito com `link`. |
266
+ | `icon` | input | `string` | `''` | Ícone decorativo antes do rótulo (quem usa registra o ícone). |
267
+ | `iconDirection` | input | `string` | `''` | Direção do `icon`, para os ícones direcionais (`angle`, `arrow`). |
268
+ | `iconEnd` | input | `string` | `''` | Ícone decorativo depois do rótulo. |
267
269
  | `disabled` | input | `boolean` | `false` | |
268
- | `loading` | input | `boolean` | `false` | Bloqueia o botão e anuncia a espera por `aria-busy`. Para o ciclo completo de uma ação assíncrona (com spinner e confirmação visual de sucesso/erro), use `load… |
269
- | `busy` | input | `boolean` | `false` | Depreciado desde 0.2.0 — use `loading` (mesmo nome dos outros componentes). |
270
- | `loadingState` | input | `HermesLoadingState` | `HermesLoadingState.DEFAULT` | Ciclo completo de uma ação assíncrona: `LOADING` trava a largura atual (evita o botão "pulando" de tamanho) e mostra um spinner; `SUCCESS`/`ERROR` mantêm a lar… |
271
- | `loadingStateChange` | output | `HermesLoadingState` | | |
270
+ | `loading` | input | `boolean` | `false` | |
271
+ | `busy` | input | `boolean` | `false` | Depreciado use `loading`. |
272
+ | `loadingState` | input | `HermesLoadingState` | `HermesLoadingState.DEFAULT` | |
273
+ | `loadingStateChange` | output | `HermesLoadingState` | | Pede a volta a `DEFAULT` depois de mostrar sucesso/erro (par de `[(loadingState)]`). |
272
274
  | `block` | input | `boolean` | `false` | Ocupa a largura toda do contêiner. |
273
- | `link` | input | `string` | `''` | Quando preenchido, a peça vira `<a>` em vez de `<button>` (abre em nova aba, é copiável, entra na lista de links do leitor de tela — o que `<button>` não faz). |
274
- | `newTab` | input | `boolean` | `false` | |
275
- | `caret` | input | `boolean` | `false` | Seta de "abre um menu" depois do rótulo — o `dropdown-toggle` antigo (use com `hmDropdownTrigger`). |
276
- | `inMenu` | input | `boolean` | `false` | Dentro de `hm-button-group`: vai para o menu "…" em vez de ficar na fileira (`hermesInMenu`). |
277
- | `toggle` | input | `boolean` | `false` | Botão de alternância: cada clique inverte `pressed` e o botão expõe `aria-pressed` (o leitor de tela anuncia "pressionado"/"não pressionado"). Sem `toggle`, `p… |
278
- | `pressed` | model | `boolean` | `false` | Estado do botão de alternância (só com `toggle`). Two-way: `[(pressed)]`. |
275
+ | `link` | input | `string` | `''` | Endereço: preenchido, o botão vira `<a href>`. |
276
+ | `newTab` | input | `boolean` | `false` | Com `link`, abre em outra aba. |
277
+ | `caret` | input | `boolean` | `false` | Seta de "abre menu" no fim. |
278
+ | `inMenu` | input | `boolean` | `false` | Num `hm-button-group`, sai da fileira e vai para o menu "…". |
279
+ | `toggle` | input | `boolean` | `false` | Botão de alternância (`aria-pressed`). Sem efeito com `link`. |
280
+ | `pressed` | model | `boolean` | `false` | |
279
281
  | `clicked` | output | `void` | | |
280
282
 
281
283
  ## `hm-card-container`
@@ -346,13 +348,13 @@ Slots: `[media]`, `[actions]`, `(padrão)`, `[footer]`
346
348
 
347
349
  `CarouselComponent` — import de `@trismegisto/angular/carousel` (também na raiz)
348
350
 
349
- Carrossel de slides com imagem e texto, navegável por botão, marcador, seta do teclado e arrasto. Só apresentação: recebe os slides prontos e não sabe de onde vieram.
351
+ Carrossel de slides com título, texto e imagem opcional (novidades, apresentação de recursos).
350
352
 
351
353
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
352
354
  |---|---|---|---|---|
353
- | `label` | input (obrigatório) | `string` | | Nome da região, lido antes do conteúdo por leitor de tela. |
355
+ | `label` | input (obrigatório) | `string` | | Nome da região (ex.: "Novidades"). |
354
356
  | `slides` | input (obrigatório) | `readonly CarouselSlide[]` | | |
355
- | `interval` | input | `number` | `0` | Milissegundos entre trocas automáticas. `0` deixa o avanço só no comando de quem usa. |
357
+ | `interval` | input | `number` | `0` | Milissegundos entre trocas automáticas. `0` desliga. |
356
358
 
357
359
  ## `hm-certificate-viewer`
358
360
 
@@ -383,10 +385,10 @@ Grupo de caixas de seleção com valor `string[]` (os `value` marcados, na ordem
383
385
  | `options` | input (obrigatório) | `readonly CheckboxGroupOption[]` | | |
384
386
  | `layout` | input | `CheckboxGroupLayout \| undefined` | `undefined` | Ver `CheckboxGroupLayout`. Sem padrão literal: vazio = `'stacked'`. |
385
387
  | `hint` | input | `string` | `''` | Texto de apoio embaixo do grupo. |
386
- | `disabled` | input (herdado) | `boolean` | `false` | |
387
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
388
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
389
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
388
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
389
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
390
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
391
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
390
392
 
391
393
  ## `hm-checkbox`
392
394
 
@@ -400,10 +402,10 @@ Checkbox com rótulo clicável e o visual `.hm-check` (o mesmo do hm-tree e da s
400
402
  | `labelHidden` | input | `boolean` | `false` | Esconde o rótulo visualmente (continua sendo o nome acessível). |
401
403
  | `checked` | model | `boolean` | `false` | Two-way sem formulário. |
402
404
  | `indeterminate` | input | `boolean` | `false` | |
403
- | `disabled` | input (herdado) | `boolean` | `false` | |
404
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
405
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
406
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
405
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
406
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
407
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
408
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
407
409
 
408
410
  ## `hm-chip-group`
409
411
 
@@ -426,7 +428,7 @@ Métodos públicos: `isSelected(value: string): boolean`, `isDisabled(): boolean
426
428
 
427
429
  `ChipComponent` — import de `@trismegisto/angular/chip` (também na raiz)
428
430
 
429
- Ficha (pílula) que representa **um item já escolhido** dentro de um conjunto que a pessoa montou: os valores de uma escolha múltipla, os filtros aplicados a uma tabela, as contas de um lote. Comportamento de mercado (MUI Chip, Material input chip): com `removable`, um ✕ desfaz aquela escolha em um gesto.
431
+ Ficha (`hm-chip`): uma escolha já feita que dá para retirar — cada valor de uma seleção múltipla, cada filtro aplicado a uma lista. Não serve para sinalizar estado de nada; status com cor e nome é o `hm-tag`.
430
432
 
431
433
  Slots: `(padrão)`
432
434
 
@@ -444,6 +446,42 @@ Slots: `(padrão)`
444
446
  | `value` | input | `string` | `''` | Identifica a ficha dentro de `hm-chip-group` (é o que entra no `value` do grupo). |
445
447
  | `removed` | output | `void` | | O ✕ foi acionado (clique, Enter/Espaço ou Backspace/Delete). Quem escuta remove o item. |
446
448
 
449
+ ## `hm-code-diff`
450
+
451
+ `CodeDiffComponent` — import de `@trismegisto/angular/code-diff` (também na raiz)
452
+
453
+ Diferenças entre dois textos, somente leitura: lado a lado ou unificado, com realce de sintaxe, realce intra-linha, regiões inalteradas recolhidas e navegação entre mudanças.
454
+
455
+ Métodos públicos: `nextChange(): void`, `previousChange(): void`, `goToChange(index: number): void`, `expandAll(): void`, `collapseAll(): void`, `copy(): Promise<boolean>`
456
+
457
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
458
+ |---|---|---|---|---|
459
+ | `original` | input (obrigatório) | `string \| null \| undefined` | | Texto anterior. |
460
+ | `modified` | input (obrigatório) | `string \| null \| undefined` | | Texto novo. |
461
+ | `language` | input | `string \| CodeLanguage \| null \| undefined` | `undefined` | Linguagem dos dois lados (id/alias ou objeto). Sem ela, infere pelo `filename`. |
462
+ | `filename` | input | `string` | `''` | |
463
+ | `originalLabel` | input | `string` | `''` | Títulos das colunas. Vazio = catálogo ("Original"/"Modificado"). |
464
+ | `modifiedLabel` | input | `string` | `''` | |
465
+ | `layout` | input | `CodeDiffLayoutInput` | `'auto'` | `auto` = lado a lado a partir de `--hm-code-diff-split-min` de largura, senão unificado. |
466
+ | `layoutToggle` | input | `boolean` | `false` | Alternância "Lado a lado / Unificado" no cabeçalho. |
467
+ | `intraline` | input | `TextDiffIntraline` | `'word'` | |
468
+ | `whitespace` | input | `TextDiffWhitespace` | `'exact'` | |
469
+ | `ignoreLineEndings` | input | `boolean` | `true` | |
470
+ | `collapseUnchanged` | input | `boolean` | `true` | |
471
+ | `contextLines` | input | `number` | `3` | Linhas inalteradas visíveis em volta de cada mudança (0–100). |
472
+ | `minCollapsed` | input | `number` | `4` | Trecho inalterado só é recolhido se esconder pelo menos isto. |
473
+ | `showLineNumbers` | input | `boolean` | `true` | |
474
+ | `wrap` | input | `boolean` | `false` | |
475
+ | `tabSize` | input | `number` | `4` | |
476
+ | `copyTarget` | input | `CodeDiffCopyTarget` | `'modified'` | O que o botão copiar do cabeçalho copia (`patch` = diff unificado). |
477
+ | `virtualize` | input | `CodeViewerVirtualize` | `'auto'` | |
478
+ | `virtualizeThreshold` | input | `number` | `2000` | |
479
+ | `maxComputeMs` | input | `number` | `500` | Orçamento do cálculo (ms). |
480
+ | `revealInvisibles` | input | `boolean` | `true` | Revela espaços de largura zero e controles C0/C1 (bidi sempre). |
481
+ | `activeChange` | model | `number` | `-1` | Mudança corrente na navegação (0-based); `-1` = nenhuma. |
482
+ | `computed` | output | `TextDiffSummary` | | Cada novo resultado de diff. |
483
+ | `copied` | output | `string` | | Copiou pelo botão do cabeçalho. |
484
+
447
485
  ## `hm-code-input`
448
486
 
449
487
  `CodeInputComponent` · `ControlValueAccessor` — import de `@trismegisto/angular/code-input` (também na raiz)
@@ -455,54 +493,98 @@ N caixas de dígito único, com avanço automático ao digitar e retrocesso ao a
455
493
  | `length` | input | `number` | `6` | |
456
494
  | `completed` | output | `string` | | |
457
495
 
496
+ ## `[hmCodeLine]`
497
+
498
+ `CodeLineDirective` — import de `@trismegisto/angular/code-viewer`
499
+
500
+ Desenha UMA linha de código no elemento: tokens como `<span class="hm-code-token--<kind>">` (só classe, `kind` validado contra a lista fechada), texto sempre por nó de texto (nunca HTML), trechos intra-linha do diff e caracteres invisíveis/bidi como marcador visível com nome acessível. Monta o DOM direto (sem uma view do Angular por token): uma linha tem dezenas de nós e um arquivo, milhares de l…
501
+
502
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
503
+ |---|---|---|---|---|
504
+ | `hmCodeLine` | input (obrigatório) | `string` | | Texto da linha (sem o terminador). |
505
+ | `hmCodeLineTokens` | input | `readonly CodeToken[] \| null` | `null` | Tokens (ou `null` enquanto não tokenizada: sai tudo `plain`). |
506
+ | `hmCodeLineReveal` | input | `boolean` | `true` | Revela largura zero e controles C0/C1 (bidi sempre). |
507
+ | `hmCodeLineFirst` | input | `boolean` | `false` | A linha é a primeira do documento (o BOM U+FEFF na posição 0 não é revelado). |
508
+ | `hmCodeLineRanges` | input | `readonly (readonly [number, number])[]` | `[]` | Trechos intra-linha `[início, fim)` e a classe que recebem. |
509
+ | `hmCodeLineRangeClass` | input | `string` | `''` | |
510
+ | `hmCodeLineInvisibleLabel` | input | `string` | `'{code}'` | Nome do marcador: `Caractere invisível {code}`. |
511
+ | `hmCodeLineRef` | input | `CodeLineRef \| null` | `null` | Onde a linha mora no modelo (cópia). |
512
+
513
+ ## `hm-code-viewer`
514
+
515
+ `CodeViewerComponent` — import de `@trismegisto/angular/code-viewer` (também na raiz)
516
+
517
+ Visualizador de código somente leitura, com realce de sintaxe por linguagem.
518
+
519
+ Métodos públicos: `copyAll(): Promise<boolean>`, `scrollToLine(line: number, align: 'start' \| 'center' = 'start'): void`
520
+
521
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
522
+ |---|---|---|---|---|
523
+ | `code` | input (obrigatório) | `string \| null \| undefined` | | Texto a exibir. `null`/`undefined` viram `''` (com aviso de desenvolvimento). |
524
+ | `language` | input | `string \| CodeLanguage \| null \| undefined` | `undefined` | Id/alias registrado ou o próprio objeto da linguagem. Sem ele, infere pelo `filename` (senão, texto puro). |
525
+ | `filename` | input | `string` | `''` | Nome no cabeçalho; também infere a linguagem. |
526
+ | `label` | input | `string` | `''` | Nome acessível da região. Vazio = gerado do catálogo. |
527
+ | `showLineNumbers` | input | `boolean` | `true` | |
528
+ | `firstLineNumber` | input | `number` | `1` | Número da primeira linha (inteiro ≥ 0). |
529
+ | `highlightLines` | input | `string \| readonly number[]` | `''` | Linhas destacadas na numeração exibida: `"3, 5-8, 12"` ou `[3, 5]`. |
530
+ | `wrap` | input | `boolean` | `false` | |
531
+ | `tabSize` | input | `number` | `4` | Largura visual do TAB (1–16). Não altera o texto copiado. |
532
+ | `copyable` | input | `boolean` | `true` | |
533
+ | `header` | input | `CodeViewerHeader` | `'auto'` | |
534
+ | `virtualize` | input | `CodeViewerVirtualize` | `'auto'` | |
535
+ | `virtualizeThreshold` | input | `number` | `2000` | |
536
+ | `revealInvisibles` | input | `boolean` | `true` | Revela espaços de largura zero e controles C0/C1. Os controles bidi aparecem sempre. |
537
+ | `copied` | output | `string` | | Copiou pelo botão (ou `copyAll()`): o texto exato. |
538
+ | `tokenized` | output | `void` | | A tokenização do documento inteiro terminou. |
539
+
458
540
  ## `hm-combobox-multi`
459
541
 
460
542
  `ComboboxMultiComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/combobox-multi` (também na raiz)
461
543
 
462
- Escolha de VÁRIAS opções entre muitas, digitando para filtrar — o `hm-combobox` com seleção múltipla, com três diferenças do single que o padrão de multisseleção da WAI-ARIA exige: (1) a lista NÃO fecha ao escolher — quem marca vários espera continuar; (2) o campo é `readonly` — o escolhido vira ficha removível antes dele, e a busca mora dentro do popover, não no campo (digitar ali disputaria esp…
544
+ Escolha de **vários** valores: fichas no campo (na ordem em que foram escolhidos) e, ao abrir, um cartão com busca e a lista marcável (APG Combobox + Listbox multisseleção). Marcar não fecha a lista; o foco fica na busca do cartão enquanto ela está aberta.
463
545
 
464
546
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
465
547
  |---|---|---|---|---|
466
548
  | `label` | input (obrigatório) | `string` | | |
467
549
  | `options` | input (obrigatório) | `readonly ComboboxOption[]` | | |
468
- | `selected` | model | `readonly string[]` | `[]` | Valores escolhidos, na ORDEM em que foram escolhidos — as fichas seguem essa ordem, não a da lista. |
469
- | `extraOptions` | input | `readonly ComboboxOption[]` | `[]` | Rótulos de valores que podem estar escolhidos mas não são mais oferecidos na lista — dão nome à ficha sem aparecer como opção (outro papel, por exemplo); a fic… |
470
- | `unknownLabel` | input | `string` | `''` | O que a ficha mostra quando o valor não está nem nas opções nem em `extraOptions`. Vazio (o padrão) mostra o próprio valor — serve a um valor já legível, não a… |
471
- | `placeholder` | input | `string` | `''` | |
472
- | `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
550
+ | `selected` | model | `readonly string[]` | `[]` | Itens marcados, preservando a sequência em que entraram. |
551
+ | `extraOptions` | input | `readonly ComboboxOption[]` | `[]` | Só dão nome a fichas de valores que saíram de `options`; não aparecem na lista. |
552
+ | `unknownLabel` | input | `string` | `''` | Nome da ficha de um valor que ninguém conhece; vazio = o próprio valor. |
553
+ | `placeholder` | input | `string` | `''` | Aparece só sem nenhuma ficha. |
554
+ | `hint` | input | `string` | `''` | |
473
555
  | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
474
- | `max` | input | `number \| null` | `null` | Teto de escolhas; `null` não limita. Atingido, o resto da lista desabilita. |
475
- | `visibleChipsLimit` | input | `number \| null` | `1` | Quantas fichas aparecem fechado antes de o resto virar "+N". `null` mostra todas. |
476
- | `disabled` | input (herdado) | `boolean` | `false` | |
477
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
478
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
479
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
556
+ | `max` | input | `number \| null` | `null` | Quantidade máxima de itens marcados (`null` libera). |
557
+ | `visibleChipsLimit` | input | `number \| null` | `1` | Fichas visíveis com a lista fechada; `null` = todas. |
558
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
559
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
560
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
561
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
480
562
 
481
563
  ## `hm-combobox`
482
564
 
483
565
  `ComboboxComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/combobox` (também na raiz)
484
566
 
485
- Escolha de uma opção entre muitas, digitando para filtrar — padrão combobox da WAI-ARIA 1.2. O posicionamento do popover reaproveita `placeDirect`/`placeWithin` e o "move pro `<body>` ao abrir" do `hm-menu` (mesma técnica, escapa de `overflow`/`transform` de qualquer ancestral — inclusive um `hm-modal`/`hm-drawer` por cima), e o erro de validação reaproveita `resolveFieldError`, o mesmo que o `hm…
567
+ Escolha de **um** valor numa lista longa, filtrando pelo que se digita (padrão Combobox do APG com lista e `aria-activedescendant`: o foco nunca sai do campo).
486
568
 
487
569
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
488
570
  |---|---|---|---|---|
489
571
  | `label` | input (obrigatório) | `string` | | |
490
572
  | `options` | input (obrigatório) | `readonly ComboboxOption[]` | | |
491
- | `value` | model | `string` | `''` | `''` = nenhuma escolha. Two-way sem formulário; com formulário, o controle é a fonte. |
573
+ | `value` | model | `string` | `''` | Valor escolhido; `''` = nenhum. |
492
574
  | `placeholder` | input | `string` | `''` | |
493
- | `icon` | input | `string` | `''` | |
575
+ | `icon` | input | `string` | `''` | Ícone decorativo no início do campo. |
494
576
  | `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
495
577
  | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
496
578
  | `size` | input | `ComboboxSize` | `'medium'` | |
497
- | `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela — o nome da coluna de uma tabela. |
498
- | `clearable` | input | `boolean` | `false` | Botão de limpar quando há escolha — só faz sentido se a escolha for opcional. |
579
+ | `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
580
+ | `clearable` | input | `boolean` | `false` | Botão para limpar a escolha. |
499
581
  | `requiredManual` | input | `boolean` | `false` | Depreciado desde 0.2.0 — use `required`. |
500
- | `loading` | input | `boolean` | `false` | |
501
- | `allowCustomValue` | input | `boolean` | `false` | Aceita texto livre (padrão `<datalist>`): as opções viram sugestões e o valor pode ser qualquer texto digitado. Padrão `false` — só valores da lista. |
502
- | `disabled` | input (herdado) | `boolean` | `false` | |
503
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
504
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
505
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
582
+ | `loading` | input | `boolean` | `false` | Silhueta no lugar do campo enquanto as opções chegam. |
583
+ | `allowCustomValue` | input | `boolean` | `false` | Aceita texto livre: as opções passam a ser sugestões. |
584
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
585
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
586
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
587
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
506
588
 
507
589
  ## `hm-command-palette`
508
590
 
@@ -552,21 +634,21 @@ Métodos públicos: `close(): void`
552
634
 
553
635
  `CopyButtonComponent` — import de `@trismegisto/angular/copy-button` (também na raiz)
554
636
 
555
- Botão que copia `value` para a área de transferência e confirma que copiou. Comportamento no padrão de mercado (MUI/Primer `ClipboardCopyButton`).
637
+ Botão de copiar um valor para a área de transferência.
556
638
 
557
639
  Métodos públicos: `copy(): Promise<boolean>`
558
640
 
559
641
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
560
642
  |---|---|---|---|---|
561
- | `value` | input (obrigatório) | `string` | | Texto que vai para a área de transferência. |
562
- | `label` | input (obrigatório) | `string` | | Nome da ação ("Copiar token"). Na variante `icon`, é o `aria-label`; na `text`, o texto visível. |
563
- | `copiedLabel` | input | `string` | `''` | Texto da confirmação. Vazio = catálogo ("Copiado"). |
643
+ | `value` | input (obrigatório) | `string` | | Valor copiado ao clicar. |
644
+ | `label` | input (obrigatório) | `string` | | O que o botão faz ("Copiar token"): nome acessível (`icon`) ou texto visível (`text`). |
645
+ | `copiedLabel` | input | `string` | `''` | Confirmação depois de copiar. Vazio = texto do catálogo. |
564
646
  | `variant` | input | `CopyButtonVariant` | `'icon'` | |
565
647
  | `size` | input | `ButtonSize` | `'medium'` | |
566
648
  | `disabled` | input | `boolean` | `false` | |
567
- | `feedbackDuration` | input | `number` | `2000` | Quanto tempo (ms) o estado "copiado"/"falhou" fica visível antes de voltar ao normal. |
649
+ | `feedbackDuration` | input | `number` | `2000` | Por quanto tempo (ms) a confirmação ou a falha fica à vista. |
568
650
  | `copied` | output | `string` | | Copiou: emite o texto copiado. |
569
- | `copyFailed` | output | `unknown` | | Nenhuma das duas vias conseguiu copiar: emite o erro original (ou `null`, sem erro lançado). |
651
+ | `copyFailed` | output | `unknown` | | Nenhuma via funcionou: emite o erro da API de clipboard (ou `null`). |
570
652
 
571
653
  ## `hm-data-grid-action-bar`
572
654
 
@@ -596,13 +678,13 @@ Troca o desenho de uma célula por um template projetado, sem trocar o DADO dela
596
678
 
597
679
  `DataGridColumnFilterComponent` — import de `@trismegisto/angular/data-grid` (também na raiz)
598
680
 
599
- Pop-over de filtro de UMA coluna do `hm-data-grid`: lista de marcar (coluna categórica — `options` não nulo) ou campo de texto livre (senão). Mesma infraestrutura de posicionamento do `hm-menu` (`placeDirect`/`placeWithin`, cartão movido pro `<body>` ao abrir) — não duplicada por acaso, ver o comentário lá: o cartão precisa escapar de `overflow`/contexto de empilhamento do mesmo jeito, e é o mesm…
681
+ Per-column filter card of `hm-data-grid`: a free-text field, or a checkbox list when `options` is given. Fully controlled — it shows `term`/`values` as received and only reports intents; whoever opened it clears `anchor` on `closed`.
600
682
 
601
683
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
602
684
  |---|---|---|---|---|
603
- | `anchor` | input (obrigatório) | `PopoverAnchor \| null` | | Coordenada da viewport; `null` = fechado. |
604
- | `label` | input (obrigatório) | `string` | | Nome da coluna, pro rótulo acessível do cartão e do campo. |
605
- | `options` | input | `readonly GridFilterOption[] \| null` | `null` | Não-nulo: a coluna é categórica, o cartão vira lista de marcar. Nulo: campo de texto livre. |
685
+ | `anchor` | input (obrigatório) | `PopoverAnchor \| null` | | Trigger rectangle in viewport px; `null` keeps the card closed. |
686
+ | `label` | input (obrigatório) | `string` | | Accessible name of the card and of the text field. |
687
+ | `options` | input | `readonly GridFilterOption[] \| null` | `null` | Checkbox choices; `null` switches to the text field. |
606
688
  | `term` | input | `string` | `''` | |
607
689
  | `values` | input | `readonly string[]` | `[]` | |
608
690
  | `termChanged` | output | `string` | | |
@@ -624,7 +706,7 @@ Troca o desenho do TÍTULO de uma coluna (não a célula) por um template projet
624
706
 
625
707
  `DataGridComponent` — import de `@trismegisto/angular/data-grid` (também na raiz)
626
708
 
627
- Grid de listagem: cabeçalho ordenável, redimensionável por arrasto (a ordem das colunas é a que `columns()` define — a tela decide, não quem usa), detalhe de linha expansível, ações por linha, busca + filtro por coluna, paginação (com rodapé embutido, cliente OU servidor — ver `totalItems`) e os estados de carregando/erro/vazio.
709
+ Tabela de dados: busca e filtro por coluna, filtro composto, ordenação, agrupamento, paginação, seleção, detalhe por linha (abaixo ou em painel), ações por linha, colunas redimensionáveis, reordenáveis e fixas, exportação, persistência e rolagem virtual. O template é o mesmo para todos os modos; cada recurso mora numa feature em `features/` e esta classe só as liga.
628
710
 
629
711
  Slots: `[dataGridActions]`
630
712
 
@@ -636,58 +718,58 @@ Métodos públicos: `exportCsv(options: DataGridExportOptions = {}): string`, `c
636
718
  |---|---|---|---|---|
637
719
  | `columns` | input (obrigatório) | `readonly GridColumn<T>[]` | | |
638
720
  | `rows` | input (obrigatório) | `readonly T[]` | | |
639
- | `rowId` | input (obrigatório) | `(row: T) => string` | | Chave estável de cada registro, usada no `track` do `@for`. |
640
- | `caption` | input (obrigatório) | `string` | | Descrição do grid pra leitor de tela — vira o `<caption>`. |
721
+ | `rowId` | input (obrigatório) | `(row: T) => string` | | |
722
+ | `caption` | input (obrigatório) | `string` | | Nome acessível da tabela (`<caption>`). |
641
723
  | `rowActions` | input | `readonly DataGridRowAction<T>[]` | `[]` | |
642
724
  | `loading` | input | `boolean` | `false` | |
643
725
  | `error` | input | `string` | `''` | |
644
- | `emptyMessage` | input | `string` | `''` | Vazio quando não há filtro nenhum: cai no texto padrão (`HERMES_MESSAGES`). |
645
- | `noResultsMessage` | input | `string` | `''` | Vazio quando o FILTRO não achou nada — texto diferente de "não há nada". |
646
- | `filterable` | input | `boolean` | `true` | A barra de ações (busca + o que a tela projetar) acima do grid. |
647
- | `paginated` | input | `boolean` | `true` | Corta os registros em páginas por dentro, depois de filtrar. Desligue (`false`) quando `rows()` já vier paginado por quem busca os dados (paginação no servidor… |
726
+ | `emptyMessage` | input | `string` | `''` | |
727
+ | `noResultsMessage` | input | `string` | `''` | Mensagem quando há filtro ativo e nada passou; vazia, vale a de vazio. |
728
+ | `filterable` | input | `boolean` | `true` | |
729
+ | `paginated` | input | `boolean` | `true` | Corta em páginas no cliente. |
648
730
  | `pageState` | model | `PaginationState` | `INITIAL_PAGE` | |
649
- | `pagination` | input | `boolean` | `true` | Mostra o rodapé de paginação, independente de `paginated` — desligue só pra uma lista embutida que nunca pagina (não é o caso comum: mesmo servidor-driven quer… |
650
- | `totalItems` | input | `number \| null` | `null` | Total de registros pro rodapé, quando `paginated` é `false` (o servidor sabe o total, a grade só vê a página atual em `rows()`). Sem isto nesse modo, o rodapé… |
731
+ | `pagination` | input | `boolean` | `true` | Mostra contagem, itens por página e paginador no rodapé. |
732
+ | `totalItems` | input | `number \| null` | `null` | Total do servidor (paginação remota); `null` = o total filtrado local. |
651
733
  | `sort` | model | `readonly GridSort[]` | `[]` | |
652
- | `selectable` | input | `boolean` | `false` | Atalho de `selectionMode="multiple"` (checkbox por linha + selecionar a página). |
653
- | `selectionMode` | input | `DataGridSelectionMode` | `'none'` | `'single'` = rádio por linha (uma só); `'multiple'` = checkbox. `'none'` + `selectable` = `'multiple'`. |
734
+ | `selectable` | input | `boolean` | `false` | |
735
+ | `selectionMode` | input | `DataGridSelectionMode` | `'none'` | |
654
736
  | `selection` | model | `GridSelection` | `EMPTY_SELECTION` | |
655
- | `rowSelectable` | input | `((row: T) => boolean) \| null` | `null` | Trava por linha: `false` = a linha não pode ser selecionada (controle desativado). `null` = todas. |
656
- | `rowSelectableReason` | input | `((row: T) => string) \| null` | `null` | Motivo de a linha estar travada (anunciado com o controle e mostrado no `title` da célula). |
657
- | `rowDetailDisabled` | input | `((row: T) => boolean) \| null` | `null` | Detalhe desta linha desativado: o botão aparece, mas `disabled`. |
658
- | `rowDetailHidden` | input | `((row: T) => boolean) \| null` | `null` | Detalhe desta linha oculto: sem botão e sem detalhe. Vence `rowDetailDisabled`. |
659
- | `virtual` | input | `boolean` | `false` | Rolagem virtual: desenha só as linhas visíveis (+ folga). Use com `[paginated]="false"`. |
660
- | `rowHeight` | input | `number` | `40` | Altura estimada de uma linha (px), usada até a linha ser medida. |
661
- | `pinnedColumns` | model | `GridPinnedColumns` | `NO_PINNED_COLUMNS` | Fixação escolhida pela pessoa, por chave (`'start'`/`'end'`; `null` desafixa); vazio = o `pinned` das definições. O gerenciador de colunas escreve aqui. |
662
- | `columnState` | model | `readonly GridColumnState[]` | `[]` | Preferência de LARGURA de coluna, em two-way. Vazio = a própria grade semeia o estado inicial (ver `constructor`) a partir da largura renderizada — arrastar o… |
663
- | `pageSizes` | input | `readonly number[]` | `[10, 25, 50, 100]` | Opções de itens-por-página do `hm-paginator` embutido — mesmo padrão dele (`[10, 25, 50, 100]`), sobrescrevível por grid (ex.: uma lista curta que nunca precis… |
737
+ | `rowSelectable` | input | `((row: T) => boolean) \| null` | `null` | |
738
+ | `rowSelectableReason` | input | `((row: T) => string) \| null` | `null` | |
739
+ | `rowDetailDisabled` | input | `((row: T) => boolean) \| null` | `null` | |
740
+ | `rowDetailHidden` | input | `((row: T) => boolean) \| null` | `null` | |
741
+ | `virtual` | input | `boolean` | `false` | |
742
+ | `rowHeight` | input | `number` | `40` | Altura estimada da linha (px) na rolagem virtual, até ela ser medida. |
743
+ | `pinnedColumns` | model | `GridPinnedColumns` | `NO_PINNED_COLUMNS` | |
744
+ | `columnState` | model | `readonly GridColumnState[]` | `[]` | |
745
+ | `pageSizes` | input | `readonly number[]` | `[10, 25, 50, 100]` | |
664
746
  | `fillHeight` | input | `boolean` | `false` | |
665
747
  | `maxHeight` | input | `string` | `''` | |
666
- | `bordered` | input | `boolean` | `false` | Divisória visível entre colunas e linhas — desligada por padrão. |
748
+ | `bordered` | input | `boolean` | `false` | |
667
749
  | `rowState` | input | `(row: T) => DataGridRowState \| null` | `() => null` | |
668
750
  | `rowClickable` | input | `boolean` | `false` | |
669
751
  | `actionTriggered` | output | `DataGridActionTriggered<T>` | | |
670
752
  | `detailToggled` | output | `{ row: T; open: boolean }` | | |
671
753
  | `rowClicked` | output | `T` | | |
672
754
  | `clearFiltersRequested` | output | `void` | | |
673
- | `filteredChange` | output | `readonly T[]` | | Os registros que sobraram depois do filtro — pra contagem/exportação fora da grade. |
674
- | `remoteSearch` | input | `boolean` | `false` | A busca da barra pergunta ao servidor em vez de recortar o que já veio (grid grande demais pro navegador). A grade continua dona do campo (`searchTerm`); escut… |
755
+ | `filteredChange` | output | `readonly T[]` | | Todas as linhas depois de filtrar e ordenar (todas as páginas). |
756
+ | `remoteSearch` | input | `boolean` | `false` | |
675
757
  | `searchTermChanged` | output | `string` | | |
676
- | `remoteSort` | input | `boolean` | `false` | Mesmo raciocínio de `remoteSearch`, pra ordenação: o grid ordena `rows` sozinho por padrão (asc/desc/desempate, por tipo de coluna) — desligue quando `rows` já… |
677
- | `itemsLabel` | input | `string` | `''` | Rodapé: o que vem depois da contagem ("1 - 10 de 42 <itemsLabel>"). Padrão: "itens". |
678
- | `pageSizeLabel` | input | `string` | `''` | Rodapé: rótulo do seletor de itens por página. Padrão: "por página". |
679
- | `exportable` | input | `boolean` | `false` | Botão "Exportar" (CSV / Excel) na barra de ações. Por código: `exportCsv()`. |
680
- | `exportFileName` | input | `string` | `''` | Nome do arquivo exportado (sem extensão). Padrão: o `caption`. |
681
- | `groupBy` | model | `string \| null` | `null` | Agrupa pela coluna desta chave (`null` = sem grupo). Two-way para um seletor de agrupamento. |
682
- | `aggregates` | input | `GridAggregates` | `{}` | Agregação por coluna (`{ total: 'sum' }`): rodapé de totais e linha de cada grupo. |
683
- | `aggregateFormatter` | input | `GridAggregateFormatter \| null` | `null` | Formata o agregado (moeda, unidade); sem ele, número no formato do idioma. |
684
- | `persistKey` | input | `string` | `''` | Persiste o estado da grade com esta chave (vazio = não persiste). |
758
+ | `remoteSort` | input | `boolean` | `false` | |
759
+ | `itemsLabel` | input | `string` | `''` | |
760
+ | `pageSizeLabel` | input | `string` | `''` | |
761
+ | `exportable` | input | `boolean` | `false` | |
762
+ | `exportFileName` | input | `string` | `''` | |
763
+ | `groupBy` | model | `string \| null` | `null` | |
764
+ | `aggregates` | input | `GridAggregates` | `{}` | |
765
+ | `aggregateFormatter` | input | `GridAggregateFormatter \| null` | `null` | |
766
+ | `persistKey` | input | `string` | `''` | |
685
767
  | `persistStorage` | input | `DataGridPersistStorage` | `'local'` | |
686
- | `advancedFilter` | input | `boolean` | `false` | Filtro composto (botão "Filtro avançado" na barra). |
768
+ | `advancedFilter` | input | `boolean` | `false` | |
687
769
  | `filterQuery` | model | `GridFilterQuery` | `EMPTY_GRID_QUERY` | |
688
- | `columnManager` | input | `boolean` | `false` | Gerenciador de colunas (botão na barra; substitui o seletor de colunas do rodapé). |
689
- | `columnOrder` | model | `readonly string[]` | `[]` | Ordem das colunas escolhida no gerenciador (chaves); vazio = a ordem de `columns()`. |
690
- | `detailPaneToggled` | output | `{ row: T; open: boolean }` | | Abriu/fechou o detail pane. |
770
+ | `columnManager` | input | `boolean` | `false` | |
771
+ | `columnOrder` | model | `readonly string[]` | `[]` | |
772
+ | `detailPaneToggled` | output | `{ row: T; open: boolean }` | | |
691
773
 
692
774
  ## `hm-calendar`
693
775
 
@@ -723,10 +805,10 @@ Campo de data — o `hermes-date-container` + `hermesDate` do hermes-ui antigo,
723
805
  | `min` | input | `IsoDate \| null` | `null` | |
724
806
  | `max` | input | `IsoDate \| null` | `null` | |
725
807
  | `valueFormat` | input | `DateValueFormat` | `'iso'` | Formato do valor gravado no controle/`value`: `'iso'` (AAAA-MM-DD, padrão) ou `'dd/mm/yyyy'` (formulário que já guardava a data como texto brasileiro). A LEITU… |
726
- | `disabled` | input (herdado) | `boolean` | `false` | |
727
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
728
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
729
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
808
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
809
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
810
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
811
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
730
812
 
731
813
  ## `hm-date-range-picker`
732
814
 
@@ -748,10 +830,10 @@ Intervalo de datas num campo só — o `hermesStartDate`/`hermesEndDate` do herm
748
830
  | `max` | input | `IsoDate \| null` | `null` | |
749
831
  | `valueFormat` | input | `DateValueFormat` | `'iso'` | Formato das duas pontas: `'iso'` (AAAA-MM-DD, padrão) ou `'dd/mm/yyyy'`. A LEITURA aceita os dois (e ISO com hora) em qualquer caso — um formato inesperado não… |
750
832
  | `presets` | input | `readonly DateRangePresetOption[]` | `[]` | Atalhos de intervalo ao lado do calendário (ver acima). Vazio = sem lista. |
751
- | `disabled` | input (herdado) | `boolean` | `false` | |
752
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
753
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
754
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
833
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
834
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
835
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
836
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
755
837
 
756
838
  ## `hm-description-item`
757
839
 
@@ -890,21 +972,21 @@ Métodos públicos: `register(item: HermesDragItemRef): void`, `unregister(item:
890
972
 
891
973
  `DrawerComponent` — import de `@trismegisto/angular/drawer` (também na raiz)
892
974
 
893
- Painel que desliza da borda. Use para conteúdo que se beneficia de mais espaço que um modal (um formulário longo, o detalhe de um registro) sem tirar a pessoa da tela de trás.
975
+ Painel que desliza de uma borda da tela, para conteúdo que não cabe bem num modal sem que a tela de origem desapareça por completo (detalhe de um registro, formulário longo, filtros).
894
976
 
895
977
  Slots: `(padrão)`, `[footer]`
896
978
 
897
979
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
898
980
  |---|---|---|---|---|
899
- | `open` | model (obrigatório) | `boolean` | | Visibilidade. Two-way: o próprio drawer fecha no Esc e no X. |
900
- | `heading` | input (obrigatório) | `string` | | Título do painel: também o rótulo acessível do dialog (ou da região, quando `pinned`). |
901
- | `size` | input | `ModalSize` | `'medium'` | Largura (em `start`/`end`) ou altura máxima (em `bottom`): `small`, `medium` (padrão), `large`, `xlarge` ou `full` (tela cheia — cobre a viewport, com a área s… |
902
- | `position` | input | `DrawerPosition` | `'end'` | Borda de onde o painel sai. `bottom` = bottom sheet. |
903
- | `pinned` | input | `boolean` | `false` | Fixa o painel no layout, ao lado do conteúdo, sem véu e sem modal (persistent drawer). |
904
- | `closeLabel` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.drawer.close`). |
905
- | `closable` | input | `boolean` | `true` | |
906
- | `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda de fechamento, igual à do `hm-modal`: chamada antes de o X ou o Esc fecharem. Devolvendo `false` (ou uma Promise que resolve `false`), o painel continua… |
907
- | `closed` | output | `void` | | |
981
+ | `open` | model (obrigatório) | `boolean` | | Aberto ou fechado, em mão dupla (`[(open)]`); o X e o `Esc` gravam `false` sozinhos. |
982
+ | `heading` | input (obrigatório) | `string` | | Título do cabeçalho e nome acessível do painel (do diálogo ou, fixado, da região). |
983
+ | `size` | input | `ModalSize` | `'medium'` | Largura (painel lateral) ou altura máxima (folha inferior), com os mesmos valores do `hm-modal`: `small`, `medium` (padrão), `large`, `xlarge` e `full`. `full`… |
984
+ | `position` | input | `DrawerPosition` | `'end'` | Borda de entrada; ver `DrawerPosition`. |
985
+ | `pinned` | input | `boolean` | `false` | Fixa o painel no layout: deixa de ser sobreposição e passa a dividir o espaço com a página, sem véu nem bloqueio. Vira uma região complementar nomeada pelo tít… |
986
+ | `closeLabel` | input | `string` | `''` | Nome acessível do X. Vazio usa `drawer.close` do catálogo. |
987
+ | `closable` | input | `boolean` | `true` | `false` tira o X e ignora o `Esc`. |
988
+ | `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda consultada quando a pessoa tenta sair pelo X ou pelo `Esc`, igual à do `hm-modal`: `false` (ou Promise com `false`) mantém aberto. Não é chamada quando… |
989
+ | `closed` | output | `void` | | Emitido depois que a pessoa fechou pelo X ou pelo `Esc`. |
908
990
 
909
991
  ## `hm-dropdown`
910
992
 
@@ -978,10 +1060,10 @@ Métodos públicos: `moveMarked(from: DualListSide): void`, `moveAll(from: DualL
978
1060
  | `searchable` | input | `boolean` | `true` | Mostra a busca em cada lado. |
979
1061
  | `size` | input | `DualListSize` | `'medium'` | |
980
1062
  | `loading` | input | `boolean` | `false` | |
981
- | `disabled` | input (herdado) | `boolean` | `false` | |
982
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
983
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
984
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
1063
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
1064
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
1065
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
1066
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
985
1067
 
986
1068
  ## `hm-empty`
987
1069
 
@@ -1037,7 +1119,7 @@ Botão de ação flutuante, com o que faltava para ser componente de biblioteca:
1037
1119
  | `fixed` | input | `boolean` | `true` | `false` deixa o botão no fluxo do documento (quem monta decide onde). |
1038
1120
  | `size` | input | `FabSize` | `'medium'` | |
1039
1121
  | `disabled` | input | `boolean` | `false` | |
1040
- | `highlight` | input | `boolean` | `false` | Anel parado em volta: há o que fazer com ele nesta tela (não pisca, de propósito). |
1122
+ | `highlight` | input | `boolean` | `false` | Contorna o botão com um anel estático de destaque (sem animação). |
1041
1123
  | `actions` | input | `readonly FabAction[]` | `[]` | Ações do speed dial; vazio, o botão age sozinho (`triggered`). |
1042
1124
  | `hideOnScroll` | input | `boolean` | `false` | Esconde ao rolar para baixo e volta ao rolar para cima. |
1043
1125
  | `avoid` | input | `string \| HTMLElement \| null` | `'footer, [role="contentinfo"]'` | Seletor (ou elemento) que o botão não pode cobrir; `''` desliga. |
@@ -1061,7 +1143,7 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
1061
1143
  | `type` | input (herdado) | `InputType` | `'text'` | |
1062
1144
  | `placeholder` | input (herdado) | `string` | `''` | |
1063
1145
  | `icon` | input (herdado) | `string` | `''` | Ícone decorativo no fim do campo. |
1064
- | `labelHidden` | input (herdado) | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
1146
+ | `labelHidden` | input (herdado) | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
1065
1147
  | `hint` | input (herdado) | `string` | `''` | Texto de apoio embaixo do campo (formato esperado, efeito automático...). |
1066
1148
  | `prefix` | input (herdado) | `string` | `''` | Texto antes do valor ("R$"). Anunciado como descrição do campo. |
1067
1149
  | `suffix` | input (herdado) | `string` | `''` | Texto depois do valor ("kg"). Anunciado como descrição do campo. |
@@ -1075,42 +1157,42 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
1075
1157
  | `maxLength` | input (herdado) | `number \| null, unknown` | `null` | Limite de caracteres, com contador visível. Ignorado com `mask`. |
1076
1158
  | `autocomplete` | input (herdado) | `string` | `''` | |
1077
1159
  | `inputMode` | input (herdado) | `InputMode \| ''` | `''` | Sobrescreve o `inputmode` derivado do tipo/máscara. |
1078
- | `disabled` | input (herdado) | `boolean` | `false` | |
1079
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
1080
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
1081
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
1160
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
1161
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
1162
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
1163
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1082
1164
 
1083
1165
  ## `hm-file-upload`
1084
1166
 
1085
1167
  `FileUploadComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/file-upload` (também na raiz)
1086
1168
 
1087
- Envio de arquivos: área de soltar + botão "Escolher arquivos", validação antes de entrar na lista e a lista com o estado de cada arquivo.
1169
+ Campo de envio de arquivos: um `<input type="file">` nativo (o caminho por teclado e leitor de tela) dentro de uma área onde também se pode soltar arquivos arrastados, mais a lista do que foi escolhido com situação, progresso, remover e tentar de novo.
1088
1170
 
1089
1171
  Métodos públicos: `addFiles(list: readonly File[]): UploadFile[]`, `update(id: string, patch: UploadFilePatch): void`, `remove(id: string): void`, `retry(id: string): void`
1090
1172
 
1091
1173
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1092
1174
  |---|---|---|---|---|
1093
- | `files` | model | `readonly UploadFile[]` | `[]` | A lista de arquivos (valor do campo). `[(files)]` / `(filesChange)`. |
1175
+ | `files` | model | `readonly UploadFile[]` | `[]` | |
1094
1176
  | `label` | input (obrigatório) | `string` | | |
1095
- | `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
1096
- | `hint` | input | `string` | `''` | Texto de apoio embaixo da área. |
1097
- | `accept` | input | `string` | `''` | Mesmo formato do atributo nativo: `'.pdf,.xlsx,image/*'`. Vazio aceita qualquer tipo. |
1098
- | `multiple` | input | `boolean` | `false` | Vários arquivos. Sem isto, escolher outro arquivo substitui o atual. |
1099
- | `maxFiles` | input | `number` | `0` | Máximo de arquivos na lista (com `multiple`). Zero = sem limite. |
1100
- | `maxSize` | input | `number` | `0` | Tamanho máximo de cada arquivo, em bytes. Zero = sem limite. |
1101
- | `maxTotalSize` | input | `number` | `0` | Tamanho máximo da soma dos arquivos, em bytes. Zero = sem limite. |
1102
- | `size` | input | `FileUploadSize` | `'medium'` | Altura da área de soltar. |
1177
+ | `labelHidden` | input | `boolean` | `false` | |
1178
+ | `hint` | input | `string` | `''` | |
1179
+ | `accept` | input | `string` | `''` | Formatos aceitos, como no atributo nativo (`'.pdf,image/*'`). |
1180
+ | `multiple` | input | `boolean` | `false` | |
1181
+ | `maxFiles` | input | `number` | `0` | Quantidade máxima de arquivos (com `multiple`); 0 = sem limite. |
1182
+ | `maxSize` | input | `number` | `0` | Bytes por arquivo; 0 = sem limite. |
1183
+ | `maxTotalSize` | input | `number` | `0` | Bytes somando a lista inteira; 0 = sem limite. |
1184
+ | `size` | input | `FileUploadSize` | `'medium'` | |
1103
1185
  | `loading` | input | `boolean` | `false` | |
1104
- | `browseLabel` | input | `string` | `''` | Texto do botão (padrão do catálogo: "Escolher arquivos"/"Escolher arquivo"). |
1105
- | `uploader` | input | `FileUploader \| null` | `null` | Envio automático (opcional). Ver `FileUploader`. |
1106
- | `added` | output | `UploadFile[]` | | Arquivos que passaram na validação e entraram na lista. |
1107
- | `rejected` | output | `FileRejection[]` | | Arquivos recusados, com o motivo (`type`, `size`, `totalSize`, `count`, `duplicate`). |
1108
- | `removed` | output | `UploadFile` | | Arquivo removido pela pessoa (já fora da lista). |
1109
- | `retried` | output | `UploadFile` | | Pediu para tentar de novo um envio com erro (sem `uploader`, o app reenvia). |
1110
- | `disabled` | input (herdado) | `boolean` | `false` | |
1111
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
1112
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
1113
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
1186
+ | `browseLabel` | input | `string` | `''` | Texto do botão de escolher; vazio usa o do catálogo. |
1187
+ | `uploader` | input | `FileUploader \| null` | `null` | Com ele, cada arquivo aceito é enviado pelo próprio campo. |
1188
+ | `added` | output | `UploadFile[]` | | Arquivos que entraram na lista nesta seleção. |
1189
+ | `rejected` | output | `FileRejection[]` | | Arquivos recusados nesta seleção, com o motivo. |
1190
+ | `removed` | output | `UploadFile` | | |
1191
+ | `retried` | output | `UploadFile` | | "Tentar de novo" sem `uploader`: o item voltou para a fila e o app reenvia. |
1192
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
1193
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
1194
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
1195
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1114
1196
 
1115
1197
  ## `hm-filter-bar`
1116
1198
 
@@ -1180,12 +1262,12 @@ Legenda de obrigatório do formulário ("Campos marcados com “obrigatório”
1180
1262
 
1181
1263
  `GeometricTextureComponent` — import de `@trismegisto/angular/geometric-texture` (também na raiz)
1182
1264
 
1183
- Malha geométrica de fundo para telas grandes e vazias (hoje, o login). O desenho fica em `geometry.ts`, então trocar a arte é trocar aquele arquivo e nada aqui.
1265
+ Malha de greca decorativa que se traça sozinha, fica, some e recomeça (ciclo longo, calmo). Cobre a caixa do contêiner posicionado mais próximo, atrás do conteúdo dele.
1184
1266
 
1185
1267
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1186
1268
  |---|---|---|---|---|
1187
- | `columns` | input | `number` | `6` | Tamanho da grade. O SVG cobre o contêiner com `slice`, então isto é densidade — quantos ladrilhos cabem na tela —, e não largura em pixels. |
1188
- | `rows` | input | `number` | `5` | |
1269
+ | `columns` | input | `number` | `6` | Ladrilhos na largura. |
1270
+ | `rows` | input | `number` | `5` | Ladrilhos na altura. |
1189
1271
 
1190
1272
  ## `hm-global-search`
1191
1273
 
@@ -1208,34 +1290,35 @@ Busca global: o mesmo contêiner da `hm-command-palette` (diálogo ancorado no a
1208
1290
 
1209
1291
  `HeaderComponent` — import de `@trismegisto/angular/header` (também na raiz)
1210
1292
 
1211
- Faixa fixa no topo do shell. A marca entra por `<ng-content>`, os atalhos de módulo pelo slot `[shortcuts]` e as ações pelo slot `[actions]` — o componente não sabe o que nenhum deles faz.
1293
+ Faixa superior do shell: gatilho do menu lateral (só no celular), marca, atalhos de módulo, gatilho da busca global e ações. O componente não busca nada — só avisa, por `searchRequested`, que a pessoa pediu a busca (clique no gatilho ou Ctrl/⌘+K em qualquer ponto da página).
1212
1294
 
1213
- Slots: `(padrão)`, `[shortcuts], [atalhos]`, `[actions], [acoes]`
1295
+ Slots: `(padrão)`, `[shortcuts]`, `[actions]`
1214
1296
 
1215
1297
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1216
1298
  |---|---|---|---|---|
1217
- | `searchRequested` | output | `void` | | Pedido de abrir a busca do sistema (clique no campo ou `Ctrl K`). |
1218
- | `searchPlaceholder` | input | | `this.text.search` | |
1219
- | `searchLabel` | input | | `this.text.searchLabel` | Nome acessível do campo — não há <label> visível. |
1299
+ | `searchRequested` | output | `void` | | A pessoa pediu a busca global; quem consome decide como abri-la. |
1300
+ | `searchPlaceholder` | input | `string` | `this.#messages.search` | Texto visível dentro do gatilho da busca. |
1301
+ | `searchLabel` | input | `string` | `this.#messages.searchLabel` | Nome acessível do gatilho da busca (não há rótulo visível). |
1220
1302
 
1221
1303
  ## `hm-icon-button`
1222
1304
 
1223
1305
  `IconButtonComponent` — import de `@trismegisto/angular/icon-button` (também na raiz)
1224
1306
 
1225
- Botão cuja única marca visível é o ícone. Aqui `label` é obrigatório porque, sem texto na tela, ele é o nome acessível (aria-label).
1307
+ Botão só com ícone. O `label` é obrigatório: vira o nome acessível do `<button>` (não há texto visível). Em modo `toggle` o nome não muda entre os estados — quem diz o estado é `aria-pressed`.
1226
1308
 
1227
1309
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1228
1310
  |---|---|---|---|---|
1229
1311
  | `label` | input (obrigatório) | `string` | | |
1230
1312
  | `icon` | input (obrigatório) | `string` | | |
1231
- | `solid` | input | `boolean` | `false` | Variante preenchida do ícone (ex.: favorito marcado) — repassada ao `hm-icon`. |
1232
- | `iconDirection` | input | `string` | `''` | Direção de ícones direcionais (ex.: shape="angle"/"angle-double") — o glifo não tem variante por nome, só por direção (o mesmo `angle`, girado). |
1313
+ | `solid` | input | `boolean` | `false` | Variante preenchida do desenho, quando o ícone tem. |
1314
+ | `iconDirection` | input | `string` | `''` | Direção, para os ícones direcionais (`angle`, `arrow`). |
1233
1315
  | `emphasis` | input | `IconButtonEmphasis` | `'outlined'` | |
1234
1316
  | `intent` | input | `ButtonIntent` | `'primary'` | |
1235
1317
  | `size` | input | `ButtonSize` | `'medium'` | |
1236
1318
  | `disabled` | input | `boolean` | `false` | |
1237
- | `toggle` | input | `boolean` | `false` | Botão de alternância: o clique inverte `pressed` e o botão ganha `aria-pressed`. |
1238
- | `pressed` | model | `boolean` | `false` | Estado do botão de alternância (só com `toggle`). Two-way: `[(pressed)]`. |
1319
+ | `toggle` | input | `boolean` | `false` | |
1320
+ | `pressed` | model | `boolean` | `false` | |
1321
+ | `keyShortcuts` | input | `string` | `''` | Atalho que aciona o botão, na forma ARIA (`aria-keyshortcuts`: `'Control+B'`, `'Meta+B'`). |
1239
1322
  | `clicked` | output | `void` | | |
1240
1323
 
1241
1324
  ## `hm-icon`
@@ -1260,7 +1343,7 @@ Botão cuja única marca visível é o ícone. Aqui `label` é obrigatório porq
1260
1343
 
1261
1344
  `IllustrationAttentionComponent` — import de `@trismegisto/angular/illustration-attention`
1262
1345
 
1263
- Ilustração de atenção (algo pede cuidado antes de seguir), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1346
+ Ilustração decorativa da situação "atenção" (algo pede cuidado antes de seguir). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1264
1347
 
1265
1348
  _Sem inputs/outputs._
1266
1349
 
@@ -1268,7 +1351,7 @@ _Sem inputs/outputs._
1268
1351
 
1269
1352
  `IllustrationErrorComponent` — import de `@trismegisto/angular/illustration-error`
1270
1353
 
1271
- Ilustração de erro (algo deu errado), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1354
+ Ilustração decorativa da situação "erro" (a ação não pôde ser concluída). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1272
1355
 
1273
1356
  _Sem inputs/outputs._
1274
1357
 
@@ -1276,7 +1359,7 @@ _Sem inputs/outputs._
1276
1359
 
1277
1360
  `IllustrationJourneyEndComponent` — import de `@trismegisto/angular/illustration-journey-end`
1278
1361
 
1279
- Ilustração de fim de jornada (tarefa concluída / sessão finalizada), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1362
+ Ilustração decorativa da situação "fim de jornada" (não há mais nada a fazer por aqui). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1280
1363
 
1281
1364
  _Sem inputs/outputs._
1282
1365
 
@@ -1284,7 +1367,7 @@ _Sem inputs/outputs._
1284
1367
 
1285
1368
  `IllustrationLockedComponent` — import de `@trismegisto/angular/illustration-locked`
1286
1369
 
1287
- Ilustração de bloqueado (recurso travado), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1370
+ Ilustração decorativa da situação "bloqueado" (o recurso está trancado). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1288
1371
 
1289
1372
  _Sem inputs/outputs._
1290
1373
 
@@ -1292,7 +1375,7 @@ _Sem inputs/outputs._
1292
1375
 
1293
1376
  `IllustrationNoPermissionComponent` — import de `@trismegisto/angular/illustration-no-permission`
1294
1377
 
1295
- Ilustração de sem permissão, sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1378
+ Ilustração decorativa da situação "sem permissão" (a conta não tem acesso a esta área). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1296
1379
 
1297
1380
  _Sem inputs/outputs._
1298
1381
 
@@ -1300,7 +1383,7 @@ _Sem inputs/outputs._
1300
1383
 
1301
1384
  `IllustrationNoResultsComponent` — import de `@trismegisto/angular/illustration-no-results`
1302
1385
 
1303
- Ilustração de sem resultado (busca/lista vazia), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1386
+ Ilustração decorativa da situação "sem resultados" (a busca ou o filtro não encontrou nada). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1304
1387
 
1305
1388
  _Sem inputs/outputs._
1306
1389
 
@@ -1308,7 +1391,7 @@ _Sem inputs/outputs._
1308
1391
 
1309
1392
  `IllustrationNotFoundComponent` — import de `@trismegisto/angular/illustration-not-found`
1310
1393
 
1311
- Ilustração de "página não encontrada", sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1394
+ Ilustração decorativa da situação "não encontrado" (o endereço não leva a lugar nenhum). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1312
1395
 
1313
1396
  _Sem inputs/outputs._
1314
1397
 
@@ -1316,7 +1399,7 @@ _Sem inputs/outputs._
1316
1399
 
1317
1400
  `IllustrationSessionExpiredComponent` — import de `@trismegisto/angular/illustration-session-expired`
1318
1401
 
1319
- Ilustração de sessão expirada, sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1402
+ Ilustração decorativa da situação "sessão expirada" (é preciso entrar de novo). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1320
1403
 
1321
1404
  _Sem inputs/outputs._
1322
1405
 
@@ -1324,7 +1407,7 @@ _Sem inputs/outputs._
1324
1407
 
1325
1408
  `IllustrationSuccessComponent` — import de `@trismegisto/angular/illustration-success`
1326
1409
 
1327
- Ilustração de sucesso, sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1410
+ Ilustração decorativa da situação "sucesso" (a ação terminou bem). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1328
1411
 
1329
1412
  _Sem inputs/outputs._
1330
1413
 
@@ -1332,10 +1415,52 @@ _Sem inputs/outputs._
1332
1415
 
1333
1416
  `IllustrationUnlockedComponent` — import de `@trismegisto/angular/illustration-unlocked`
1334
1417
 
1335
- Ilustração de desbloqueado (acesso liberado), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
1418
+ Ilustração decorativa da situação "desbloqueado" (o acesso foi liberado). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
1336
1419
 
1337
1420
  _Sem inputs/outputs._
1338
1421
 
1422
+ ## `hm-image-crop`
1423
+
1424
+ `ImageCropComponent` — import de `@trismegisto/angular/image-crop` (também na raiz)
1425
+
1426
+ Recorte de imagem: mostra a imagem inteira com uma área de recorte móvel e redimensionável por cima, com proporção fixa opcional, recorte redondo, zoom da vista e giro em quartos de volta, e gera a imagem recortada (`exportImage()`) como `Blob` PNG/JPEG/WebP.
1427
+
1428
+ Slots: `[hmImageCropEmpty]`
1429
+
1430
+ Métodos públicos: `exportImage(options: ImageCropExportOptions = {}): Promise<ImageCropResult>`, `reset(): void`, `rotateBy(quarterTurns: number): void`, `focusRegion(): void`
1431
+
1432
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1433
+ |---|---|---|---|---|
1434
+ | `src` | input | `ImageCropSource` | `null` | Imagem a recortar; `null`/vazio limpa (estado vazio). |
1435
+ | `label` | input (obrigatório) | `string` | | Nome acessível do componente e da área de recorte ("Foto de perfil"). |
1436
+ | `alt` | input | `string` | `''` | Descrição da imagem; vazio → `alt=""` (o `label` já dá o contexto). |
1437
+ | `ratio` | input | `number \| null` | `null` | Largura ÷ altura fixa (`16 / 9`); `null` = livre. |
1438
+ | `shape` | input | `ImageCropShape` | `'rect'` | `round` mostra a máscara elíptica (sem `ratio`, vira círculo). |
1439
+ | `minWidth` | input | `number` | `0` | Mínimos da área, em pixels da imagem. |
1440
+ | `minHeight` | input | `number` | `0` | |
1441
+ | `accept` | input | `readonly ImageCropType[]` | `IMAGE_CROP_TYPES` | Formatos de entrada aceitos (reconhecidos pelos bytes). |
1442
+ | `maxSize` | input | `number` | `0` | Bytes máximos da entrada; 0 = sem limite. |
1443
+ | `maxPixels` | input | `number` | `50_000_000` | Largura × altura máxima da imagem decodificada. |
1444
+ | `credentials` | input | `'omit' \| 'same-origin' \| 'include'` | `'same-origin'` | Cookies ao baixar `src` por endereço. |
1445
+ | `maxZoom` | input | `number` | `4` | Zoom máximo da vista (mínimo efetivo 1). |
1446
+ | `controls` | input | `boolean` | `true` | Barra de ajustes (zoom, girar, restaurar). |
1447
+ | `fields` | input | `boolean` | `true` | Campos numéricos X, Y, largura e altura — a alternativa sem arrasto para redimensionar (WCAG 2.5.7). |
1448
+ | `guides` | input | `boolean` | `true` | Linhas dos terços durante o arrasto. |
1449
+ | `exportType` | input | `ImageCropOutputType` | `'image/png'` | |
1450
+ | `exportQuality` | input | `number` | `0.9` | 0–1, para JPEG/WebP. |
1451
+ | `exportMaxWidth` | input | `number` | `0` | Largura/altura máxima da saída (reduz mantendo a proporção); 0 = sem limite. |
1452
+ | `exportMaxHeight` | input | `number` | `0` | |
1453
+ | `exportFill` | input | `string` | `'#ffffff'` | Cor que substitui a transparência no JPEG (e o fundo fora da elipse no JPEG redondo). |
1454
+ | `exportMask` | input | `boolean` | `true` | Com a forma `round`: fora da elipse fica transparente (PNG/WebP) ou `exportFill` (JPEG). |
1455
+ | `liveExport` | input | `boolean` | `false` | Gera a imagem ao fim de cada ajuste e emite `exported`. |
1456
+ | `disabled` | input | `boolean` | `false` | |
1457
+ | `region` | model | `ImageCropRegion \| null` | `null` | Área atual em pixels inteiros da imagem orientada e girada; `null` sem imagem. |
1458
+ | `zoom` | model | `number` | `1` | Fator da vista, 1…`maxZoom`. |
1459
+ | `rotation` | model | `ImageCropRotation` | `0` | Giro horário em quartos de volta. |
1460
+ | `loaded` | output | `ImageCropInfo` | | Imagem decodificada e área inicial definida. |
1461
+ | `failed` | output | `ImageCropError` | | Falha ao carregar (só da carga mais recente). |
1462
+ | `exported` | output | `ImageCropResult` | | Com `liveExport`: resultado da última geração automática. |
1463
+
1339
1464
  ## `hm-input`
1340
1465
 
1341
1466
  `InputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/input` (também na raiz)
@@ -1351,7 +1476,7 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
1351
1476
  | `type` | input | `InputType` | `'text'` | |
1352
1477
  | `placeholder` | input | `string` | `''` | |
1353
1478
  | `icon` | input | `string` | `''` | Ícone decorativo no fim do campo. |
1354
- | `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
1479
+ | `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
1355
1480
  | `hint` | input | `string` | `''` | Texto de apoio embaixo do campo (formato esperado, efeito automático...). |
1356
1481
  | `prefix` | input | `string` | `''` | Texto antes do valor ("R$"). Anunciado como descrição do campo. |
1357
1482
  | `suffix` | input | `string` | `''` | Texto depois do valor ("kg"). Anunciado como descrição do campo. |
@@ -1365,10 +1490,10 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
1365
1490
  | `maxLength` | input | `number \| null, unknown` | `null` | Limite de caracteres, com contador visível. Ignorado com `mask`. |
1366
1491
  | `autocomplete` | input | `string` | `''` | |
1367
1492
  | `inputMode` | input | `InputMode \| ''` | `''` | Sobrescreve o `inputmode` derivado do tipo/máscara. |
1368
- | `disabled` | input (herdado) | `boolean` | `false` | |
1369
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
1370
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
1371
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
1493
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
1494
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
1495
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
1496
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1372
1497
 
1373
1498
  ## `hm-item-group`
1374
1499
 
@@ -1457,14 +1582,14 @@ Métodos públicos: `cardTemplate(): TemplateRef<KanbanCardContext<T>> \| null`,
1457
1582
 
1458
1583
  `LegendComponent` — import de `@trismegisto/angular/legend` (também na raiz)
1459
1584
 
1460
- Legenda de cores/status: explica, uma vez só, o que cada cor da tela significa. Serve também de legenda de série para gráficos (`color` por item, `marker="line"`).
1585
+ Legenda: o que cada cor quer dizer, em texto. Lista nomeada; o marcador é só decoração (o rótulo carrega o significado — WCAG 1.4.1).
1461
1586
 
1462
1587
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1463
1588
  |---|---|---|---|---|
1464
1589
  | `items` | input | `readonly LegendItem[]` | `[]` | |
1465
- | `orientation` | input | `LegendOrientation` | `'vertical'` | `vertical` (padrão) empilha os itens; `horizontal` os põe em linha, quebrando se faltar espaço. |
1466
- | `marker` | input | `LegendMarker` | `'dot'` | Forma do marcador: `dot` (status), `square` (área/barra) ou `line` (série de linha). |
1467
- | `label` | input | `string` | `''` | Nome acessível da lista. Vazio cai no "Legenda" do catálogo. |
1590
+ | `orientation` | input | `LegendOrientation` | `'vertical'` | |
1591
+ | `marker` | input | `LegendMarker` | `'dot'` | |
1592
+ | `label` | input | `string` | `''` | Nome da lista para leitor de tela; vazio usa o texto do catálogo ("Legenda"). |
1468
1593
 
1469
1594
  ## `hm-loading-square`
1470
1595
 
@@ -1478,24 +1603,25 @@ _Sem inputs/outputs._
1478
1603
 
1479
1604
  `MenuButtonComponent` — import de `@trismegisto/angular/menu-button` (também na raiz)
1480
1605
 
1481
- Botão de ícone que abre um `hm-menu` logo abaixo dele: o ícone + seta dos dropdowns de cabeçalho (configurações, ajuda, documentos). Só compõe os dois — não decide os itens nem o que a escolha significa.
1606
+ Botão que abre um `hm-menu` preso a ele (APG *Menu Button*): `aria-haspopup="menu"` e `aria-expanded` no gatilho, foco no primeiro item ao abrir (`↓`/`↑` no gatilho abrem no primeiro ou no último) e, ao fechar por qualquer caminho, foco de volta no gatilho.
1482
1607
 
1483
1608
  Slots: `(padrão)`
1484
1609
 
1485
1610
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1486
1611
  |---|---|---|---|---|
1487
- | `label` | input (obrigatório) | `string` | | Nome acessível do gatilho; o menu reusa o mesmo. |
1488
- | `icon` | input | `string` | `''` | |
1612
+ | `label` | input (obrigatório) | `string` | | Nome acessível do botão e do menu. |
1613
+ | `icon` | input | `string` | `''` | Ícone antes do conteúdo (vazio = sem ícone). O app registra o ícone que passar aqui. |
1489
1614
  | `items` | input (obrigatório) | `readonly MenuItem[]` | | |
1490
- | `showArrow` | input | `boolean` | `true` | A seta de "abre um menu"; some no ícone que já diz isso. |
1491
- | `align` | input | `PopoverAlign` | `'start'` | `end` é para o gatilho encostado na borda direita da tela: o menu cresce para a esquerda. |
1492
- | `side` | input | `PopoverSide` | `'bottom'` | |
1615
+ | `showArrow` | input | `boolean` | `true` | Seta para baixo depois do conteúdo. |
1616
+ | `align` | input | `PopoverAlign` | `'start'` | Encosto do menu no eixo cruzado (troca sozinho se não couber). |
1617
+ | `side` | input | `PopoverSide` | `'bottom'` | Lado preferido do menu (vira para o oposto se não couber). |
1493
1618
  | `size` | input | `MenuButtonSize` | `'medium'` | |
1494
1619
  | `shape` | input | `'default' \| 'circle'` | `'default'` | |
1495
- | `layer` | input | `'default' \| 'above-invoker'` | `'default'` | |
1496
- | `closeOnCheck` | input | `boolean` | `false` | Itens checkbox/rádio: fecha o menu ao marcar (padrão: continua aberto, como no `hm-menu`). |
1620
+ | `layer` | input | `'default' \| 'above-invoker'` | `'default'` | Ver `hm-menu`: `above-invoker` quando o botão está dentro de um overlay. |
1621
+ | `closeOnCheck` | input | `boolean` | `false` | Ver `hm-menu`: fecha ao marcar um item `checkbox`/`radio`. |
1622
+ | `disabled` | input | `boolean` | `false` | Desabilita o botão (o menu não abre). |
1497
1623
  | `chosen` | output | `string` | | |
1498
- | `checkedChange` | output | `MenuItemChange` | | Um item checkbox/rádio mudou; aplique em `items` com `applyMenuItemChange`. |
1624
+ | `checkedChange` | output | `MenuItemChange` | | |
1499
1625
 
1500
1626
  ## `[hmContextMenu]`
1501
1627
 
@@ -1519,21 +1645,21 @@ Métodos públicos: `openAt(x: number, y: number): boolean`, `close(): void`
1519
1645
 
1520
1646
  `MenuComponent` — import de `@trismegisto/angular/menu` (também na raiz)
1521
1647
 
1522
- Pop-over e menu de contexto na mesma peça: abre numa coordenada da viewport, navega por seta e devolve o id da ação escolhida. Apontando um **retângulo** (o botão que o abriu) ele é o pop-over, com vão e bico; apontando um **ponto** (o cursor do botão direito) nasce no cursor, sem vão e sem bico.
1648
+ Menu de ações ancorado: lista de `MenuItem` (ações, submenus, itens `checkbox`/`radio`) que abre num retângulo (um gatilho — o cartão encosta num lado, com vão e bico) ou num ponto (o cursor — nasce ali, sem bico). Quem abre controla `anchor`: `null` fecha, e o menu só PEDE para fechar por `closed`.
1523
1649
 
1524
1650
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1525
1651
  |---|---|---|---|---|
1526
- | `anchor` | input (obrigatório) | `PopoverAnchor \| null` | | Coordenada da viewport; `null` = fechado. |
1652
+ | `anchor` | input (obrigatório) | `PopoverAnchor \| null` | | Onde abrir, em coordenadas da viewport; `null` = fechado. |
1527
1653
  | `items` | input (obrigatório) | `readonly MenuItem[]` | | |
1528
- | `label` | input (obrigatório) | `string` | | Nome do menu para leitor de tela. |
1529
- | `layer` | input | `'default' \| 'above-invoker'` | `'default'` | `above-invoker`: quando o menu abre de dentro de um overlay (ex.: modal) e precisa ficar por cima dele. |
1530
- | `closeOnCheck` | input | `boolean` | `false` | Fecha o menu ao marcar um item `checkbox`/`radio` (padrão: continua aberto). |
1531
- | `initialFocus` | input | `'first' \| 'last'` | `'first'` | Onde o foco entra ao abrir: no primeiro item (padrão) ou no último (↑ num gatilho de barra de menus). |
1532
- | `chosen` | output | `string` | | |
1533
- | `closed` | output | `void` | | |
1534
- | `checkedChange` | output | `MenuItemChange` | | Um item `checkbox`/`radio` foi marcado/desmarcado. |
1535
- | `navigate` | output | `'previous' \| 'next'` | | ←/→ num item sem submenu, no nível de cima (ou → dentro de um submenu): pedido para ir ao menu vizinho. Só quem compõe o menu numa barra (`hm-menubar`) usa; so… |
1536
- | `pointerOutside` | output | `MouseEvent` | | Ponteiro no fundo transparente (fora do cartão): `pointermove` e `click`, com as coordenadas. Gancho para peças compostas (a barra de menus troca de menu ao pa… |
1654
+ | `label` | input (obrigatório) | `string` | | Rótulo acessível do menu (vai para a região e para o `role="menu"`). |
1655
+ | `layer` | input | `'default' \| 'above-invoker'` | `'default'` | `above-invoker` quando quem abre já está num overlay (modal, gaveta): sobe fundo e cartão de camada. |
1656
+ | `closeOnCheck` | input | `boolean` | `false` | Fecha ao marcar um item `checkbox`/`radio` (padrão: continua aberto para marcar outros). |
1657
+ | `initialFocus` | input | `'first' \| 'last'` | `'first'` | Item que recebe o foco ao abrir. |
1658
+ | `chosen` | output | `string` | | Id da ação escolhida (o menu pede para fechar em seguida, por `closed`). |
1659
+ | `closed` | output | `void` | | Pedido de fechamento: Esc, Tab, escolha, clique fora. Quem abre zera `anchor`. |
1660
+ | `checkedChange` | output | `MenuItemChange` | | Um item `checkbox`/`radio` mudou de estado. |
1661
+ | `navigate` | output | `'previous' \| 'next'` | | `←`/`→` sem uso dentro do menu: para quem coloca vários menus lado a lado (`hm-menubar`). |
1662
+ | `pointerOutside` | output | `MouseEvent` | | Ponteiro sobre o fundo (`pointermove` e, antes de `closed`, o `click`). |
1537
1663
 
1538
1664
  ## `hm-menubar`
1539
1665
 
@@ -1612,47 +1738,47 @@ Slots: `(padrão)`, `[hmMessageActions]`
1612
1738
 
1613
1739
  `ModalComponent` — import de `@trismegisto/angular/modal` (também na raiz)
1614
1740
 
1615
- Diálogo modal genérico: sobreposição, foco preso na janela, Esc para fechar, retorno de foco a quem abriu, scroll do body travado.
1741
+ Janela de diálogo modal. Aberta, deixa a página de trás inerte (sem foco nem rolagem) e prende o `Tab` dentro dela.
1616
1742
 
1617
1743
  Slots: `(padrão)`, `[footer]`
1618
1744
 
1619
1745
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1620
1746
  |---|---|---|---|---|
1621
- | `open` | model (obrigatório) | `boolean` | | Visibilidade. Two-way: o próprio modal fecha no Esc e no X. |
1622
- | `heading` | input (obrigatório) | `string` | | Título da janela: também o rótulo acessível do dialog. |
1623
- | `size` | input | `ModalSize` | `'medium'` | Largura: `small` (320px), `medium` (640px, padrão), `large` (960px), `xlarge` (1280px) ou `full` (tela cheia: a janela vira a viewport, sem cantos, com a área… |
1624
- | `closeLabel` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.modal.close`). |
1625
- | `closable` | input | `boolean` | `true` | |
1626
- | `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda de fechamento (padrão de mercado, como o `canDeactivate`/`beforeClose` dos overlays): chamada antes de o X, o Esc ou o fundo fecharem. Devolvendo `false… |
1627
- | `closed` | output | `void` | | |
1747
+ | `open` | model (obrigatório) | `boolean` | | Aberto ou fechado, em mão dupla (`[(open)]`). O próprio componente grava `false` quando a pessoa sai pelo X ou pelo `Esc`. |
1748
+ | `heading` | input (obrigatório) | `string` | | Título exibido no cabeçalho; é também o nome do diálogo para leitores de tela. |
1749
+ | `size` | input | `ModalSize` | `'medium'` | Largura da janela: `small`, `medium` (padrão), `large`, `xlarge` ou `full` — este ocupa a tela inteira, sem cantos arredondados, respeitando as áreas seguras d… |
1750
+ | `closeLabel` | input | `string` | `''` | Nome acessível do X. Vazio usa `modal.close` do catálogo, no idioma ativo. |
1751
+ | `closable` | input | `boolean` | `true` | `false` tira o X e ignora o `Esc`: o diálogo só sai pelas ações do rodapé. |
1752
+ | `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda chamada quando a pessoa tenta sair pelo X ou pelo `Esc` (ex.: confirmar descarte de alterações). Devolver `false`, ou uma Promise que resolve em `false`… |
1753
+ | `closed` | output | `void` | | Emitido depois que a pessoa fechou pelo X ou pelo `Esc` (já com `open` em `false`). |
1628
1754
 
1629
1755
  ## `hm-animated-number`
1630
1756
 
1631
1757
  `AnimatedNumberComponent` — import de `@trismegisto/angular/motion` (também na raiz)
1632
1758
 
1633
- Número que **conta até o valor** quando entra na vista, e conta de novo (a partir do valor atual) quando o valor muda.
1759
+ Exibe um valor numérico animando de `from` até `value`; a animação começa quando o elemento aparece na tela (indicadores de painel, métricas de destaque).
1634
1760
 
1635
1761
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1636
1762
  |---|---|---|---|---|
1637
- | `value` | input (obrigatório) | `number` | | O valor final, cru. |
1638
- | `format` | input | `Intl.NumberFormatOptions` | `{}` | Opções do `Intl.NumberFormat` (moeda, porcentagem, unidade, notação compacta…). |
1639
- | `duration` | input | `number` | `1000` | Duração da contagem em milissegundos. |
1763
+ | `value` | input (obrigatório) | `number` | | |
1764
+ | `format` | input | `Intl.NumberFormatOptions` | `{}` | |
1765
+ | `duration` | input | `number` | `1000` | Duração da contagem em ms. |
1640
1766
  | `from` | input | `number` | `0` | De onde a primeira contagem parte. |
1641
1767
 
1642
1768
  ## `[hmFlip]`
1643
1769
 
1644
1770
  `FlipDirective` — import de `@trismegisto/angular/motion` (também na raiz)
1645
1771
 
1646
- Rearranjo animado (técnica FLIP): ao reordenar, os itens **deslizam** até a posição nova em vez de saltarem para ela. Útil em listas reordenáveis (`hm-reorder-list`), quadros (`hm-kanban`), grades de cartões e resultados que mudam de ordem.
1772
+ Rearranjo animado (técnica FLIP): quando a ordem dos itens muda, cada item anima o deslocamento até o lugar novo, sem pulo.
1647
1773
 
1648
1774
  Métodos públicos: `capture(): void`
1649
1775
 
1650
1776
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1651
1777
  |---|---|---|---|---|
1652
- | `hmFlip` | input | `unknown` | `undefined` | Gatilho: qualquer valor que muda quando a ordem muda (a própria lista, uma versão…). |
1653
- | `hmFlipItems` | input | `string` | `''` | Seletor CSS dos itens animados, relativo ao contêiner (padrão: filhos diretos). |
1654
- | `hmFlipDuration` | input | `number \| null` | `null` | Duração em ms; `null` lê `--hm-duration-standard`. |
1655
- | `hmFlipEasing` | input | `string` | `''` | Curva CSS; vazio lê `--hm-ease-standard`. |
1778
+ | `hmFlip` | input | `unknown` | `undefined` | Disparo: qualquer valor, trocado a cada reordenação. |
1779
+ | `hmFlipItems` | input | `string` | `''` | Seletor dos itens dentro do elemento. Vazio = filhos diretos. |
1780
+ | `hmFlipDuration` | input | `number \| null` | `null` | Duração em ms. `null` lê `--hm-duration-standard`. |
1781
+ | `hmFlipEasing` | input | `string` | `''` | Curva CSS. Vazio lê `--hm-ease-standard`. |
1656
1782
 
1657
1783
  ## `[hmReveal]`
1658
1784
 
@@ -1719,61 +1845,46 @@ Métodos públicos: `toggle(key: string): void`, `hoverTrigger(key: string, even
1719
1845
  | `openDelay` | input | `number` | `NAVIGATION_MENU_OPEN_DELAY` | Espera (ms) com o mouse sobre um botão antes de abrir o painel. |
1720
1846
  | `closeDelay` | input | `number` | `HOVER_CLOSE_DELAY` | Espera (ms) depois de o mouse sair da navegação antes de fechar o painel aberto pelo mouse. |
1721
1847
 
1722
- ## `hm-opening-scene`
1723
-
1724
- `OpeningSceneComponent` — import de `@trismegisto/angular/opening-scene` (também na raiz)
1725
-
1726
- Cena de transição entre o login e a área privada: a câmera se aproxima do logotipo do app (projetado como conteúdo: `<hm-opening-scene><img src="logo.svg" alt="" /></hm-opening-scene>`), para diante dele por um instante e o entrega no lugar exato que o logo do cartão de login ocupa. A lib não traz marca própria (marca é do app): sem conteúdo projetado, a cena é só a cortina.
1727
-
1728
- Slots: `(padrão)`
1729
-
1730
- | Nome | Tipo | Tipo TS | Padrão | Descrição |
1731
- |---|---|---|---|---|
1732
- | `label` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.openingScene.entering`). |
1733
- | `skipLabel` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.openingScene.skip`). |
1734
- | `targetSelector` | input | `string` | `'[data-hermes-opening-target]'` | Seletor CSS do elemento (a marca do cartão de login) onde a cena pousa. |
1735
- | `completed` | output | `void` | | A cena acabou (ou foi pulada). Quem escuta decide para onde ir. |
1736
-
1737
1848
  ## `hm-page-header`
1738
1849
 
1739
1850
  `PageHeaderComponent` — import de `@trismegisto/angular/page-header` (também na raiz)
1740
1851
 
1741
- Cabeçalho de página: título, trilha de navegação opcional, descrição, metadados/status e as ações que valem para a página inteira.
1852
+ Topo de uma página: título no nível certo da hierarquia, trilha de navegação, ações da página (`[actions]`), descrição, um resumo vivo ("7 aguardando envio", anunciado a cada mudança) e metadados (`[meta]`). Com `loading`, título e resumo viram silhuetas e a trilha também carrega.
1742
1853
 
1743
1854
  Slots: `[actions]`, `[meta]`
1744
1855
 
1745
1856
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1746
1857
  |---|---|---|---|---|
1747
- | `heading` | input (obrigatório) | `string` | | Título da página. |
1748
- | `level` | input | `PageHeaderLevel` | `1` | Nível do título (`<h1>`…`<h6>`). Ver a nota da classe sobre um único `<h1>`. |
1749
- | `headingId` | input | `string` | `''` | `id` do título, para `aria-labelledby` da seção que ele nomeia. |
1750
- | `description` | input | `string` | `''` | Texto de apoio fixo embaixo do título. |
1751
- | `summary` | input | `string` | `''` | Contagem/resumo vivo da listagem — anunciado (`role="status"`). |
1752
- | `breadcrumb` | input | `readonly BreadcrumbItem[]` | `[]` | Trilha de navegação, abaixo do título (reusa `hm-breadcrumb`). Vazia = sem trilha. |
1753
- | `breadcrumbLabel` | input | `string` | `''` | Nome do `nav` da trilha. Vazio = catálogo ("Você está aqui"); dê outro quando houver duas trilhas na tela. |
1754
- | `loading` | input | `boolean` | `false` | Silhueta no título, na trilha e no resumo enquanto a tela resolve. |
1755
- | `breadcrumbClick` | output | `BreadcrumbItem` | | Clique num degrau da trilha (repassado do `hm-breadcrumb`). |
1858
+ | `heading` | input (obrigatório) | `string` | | |
1859
+ | `level` | input | `PageHeaderLevel` | `1` | Nível do título na hierarquia da página (`<h1>`…`<h6>`). |
1860
+ | `headingId` | input | `string` | `''` | `id` do título, para `aria-labelledby` de uma região ou formulário da página. |
1861
+ | `description` | input | `string` | `''` | |
1862
+ | `summary` | input | `string` | `''` | Frase curta que muda com os dados ("7 aguardando envio"); anunciada pelo leitor de tela. |
1863
+ | `breadcrumb` | input | `readonly BreadcrumbItem[]` | `[]` | |
1864
+ | `breadcrumbLabel` | input | `string` | `''` | |
1865
+ | `loading` | input | `boolean` | `false` | |
1866
+ | `breadcrumbClick` | output | `BreadcrumbItem` | | |
1756
1867
 
1757
1868
  ## `hm-paginator`
1758
1869
 
1759
1870
  `PaginatorComponent` — import de `@trismegisto/angular/paginator` (também na raiz)
1760
1871
 
1761
- Controle de paginação: saltos pras pontas, passo a passo, e os números das páginas — a janela desliza em vez de paginar em blocos, então ir de 7 pra 8 não troca a fileira inteira.
1872
+ Controles de paginação. Não guarda página nem fatia lista: cada ação emite o estado novo em `stateChanged` e o componente mostra o `state` que o pai devolver.
1762
1873
 
1763
1874
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1764
1875
  |---|---|---|---|---|
1765
- | `state` | input | `PaginationState` | `DEFAULT_STATE` | Página e tamanho atuais. Obrigatório na `full`; na `simple` com cursor pode ficar de fora. |
1766
- | `totalItems` | input | `number \| null` | `null` | Total de registros. `null` = desconhecido (só faz sentido na `simple`, com `hasNext`). |
1876
+ | `state` | input | `PaginationState` | `{ page: 1, size: 10 }` | |
1877
+ | `totalItems` | input | `number \| null` | `null` | Total de registros; `null` quando não se sabe (cursor). |
1767
1878
  | `variant` | input | `PaginatorVariant` | `'full'` | |
1768
- | `label` | input | `string` | `''` | Nome do `nav`. Vazio usa "Paginação" do catálogo. Dê um nome próprio quando houver mais de um paginador na tela (dois landmarks `nav` com o mesmo nome não se d… |
1769
- | `showPage` | input | `boolean` | `true` | Na `simple`, mostra a posição ("Página 2 de 5", ou "Página 2" sem total). |
1770
- | `hasNext` | input | `boolean \| undefined` | `undefined` | Há página seguinte? Vazio = calcula pelo total. Use em listas com cursor. |
1771
- | `hasPrevious` | input | `boolean \| undefined` | `undefined` | Há página anterior? Vazio = calcula pela página atual. |
1772
- | `sizes` | input | `readonly number[]` | `DEFAULT_SIZES` | |
1773
- | `maxNumbers` | input | `number` | `7` | Quantos números aparecem antes de a lista virar reticências. |
1879
+ | `label` | input | `string` | `''` | Nome do `nav`. Vazio = catálogo. Dois paginadores na mesma tela precisam de nomes distintos. |
1880
+ | `showPage` | input | `boolean` | `true` | Na variante `simple`, mostra a posição ("Página 2 de 5"). |
1881
+ | `hasNext` | input | `boolean \| undefined` | `undefined` | Só na `simple`: força a habilitação da próxima (cursor). `undefined` = calcula pelo total. |
1882
+ | `hasPrevious` | input | `boolean \| undefined` | `undefined` | |
1883
+ | `sizes` | input | `readonly number[]` | `[10, 25, 50, 100]` | |
1884
+ | `maxNumbers` | input | `number` | `7` | |
1774
1885
  | `stateChanged` | output | `PaginationState` | | |
1775
- | `nextPage` | output | `void` | | "Próxima página" acionado (as duas variantes) — o gatilho para buscar o próximo cursor. |
1776
- | `previousPage` | output | `void` | | "Página anterior" acionado (as duas variantes). |
1886
+ | `nextPage` | output | `void` | | |
1887
+ | `previousPage` | output | `void` | | |
1777
1888
 
1778
1889
  ## `| hmDate` (pipe)
1779
1890
 
@@ -1879,21 +1990,21 @@ Métodos públicos: `currentErrors(): Readonly<Record<string, string>>`
1879
1990
 
1880
1991
  `RadioComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/radio` (também na raiz)
1881
1992
 
1882
- Grupo de opções mutuamente exclusivas. Mesmo contrato dos outros controles: Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
1993
+ Escolha única entre poucas opções visíveis, com rádios nativos: Tab entra no grupo, as setas trocam a escolha e pulam as desabilitadas. Valor `string` (o `value` da opção marcada).
1883
1994
 
1884
1995
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1885
1996
  |---|---|---|---|---|
1886
1997
  | `value` | model | `string` | `''` | |
1887
1998
  | `label` | input (obrigatório) | `string` | | |
1888
1999
  | `options` | input (obrigatório) | `readonly RadioOption[]` | | |
1889
- | `appearance` | input | `RadioAppearance \| undefined` | `undefined` | `'list'` (padrão, também sem valor): rádios em lista. `'card'`: cada opção num cartão (ver doc da classe). Sem padrão literal de propósito: o gerador de ícones… |
1890
- | `layout` | input | `RadioLayout \| undefined` | `undefined` | `'inline'`: opções lado a lado (poucas opções curtas — "Sim / Não", "Dia / Semana / Mês"); em tela estreita quebram para a linha de baixo. Vazio = `'stacked'`.… |
1891
- | `hint` | input | `string` | `''` | Texto de apoio embaixo do grupo. |
2000
+ | `appearance` | input | `RadioAppearance \| undefined` | `undefined` | |
2001
+ | `layout` | input | `RadioLayout \| undefined` | `undefined` | |
2002
+ | `hint` | input | `string` | `''` | |
1892
2003
  | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
1893
- | `disabled` | input (herdado) | `boolean` | `false` | |
1894
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
1895
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
1896
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2004
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2005
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2006
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2007
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1897
2008
 
1898
2009
  ## `hm-reorder-list`
1899
2010
 
@@ -1911,16 +2022,50 @@ Lista reordenável (`hm-reorder-list`) por arrasto **e** por teclado. A interaç
1911
2022
  | `removable` | input | `boolean` | `false` | Mostra em cada linha o botão que remove o item da lista. |
1912
2023
  | `moved` | output | `ReorderListMove` | | Movimento confirmado: item, posição de origem e de destino (índices a partir de 0). |
1913
2024
  | `removed` | output | `ReorderListRemoval` | | Item removido pelo ✕ (a lista nova já foi publicada em `items`/formulário). |
1914
- | `disabled` | input (herdado) | `boolean` | `false` | |
1915
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
1916
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
1917
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2025
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2026
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2027
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2028
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2029
+
2030
+ ## `hm-rich-text`
2031
+
2032
+ `RichTextComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/rich-text` (também na raiz)
2033
+
2034
+ Campo de texto com formatação cujo valor é **HTML canônico e sanitizado** (`<p>`, `<h2>`, listas, citação, código, `strong`/`em`/`u`/`s`/`code`/`a`). Funciona com Reactive Forms, `[(ngModel)]` ou `[(value)]`; o documento vazio vale `''` (então `Validators.required` funciona sem adaptação) e `RichTextValidators.maxLength(n)` conta os caracteres de texto.
2035
+
2036
+ Métodos públicos: `focus(): void`, `apply(tool: RichTextFormatTool): void`, `undo(): void`, `redo(): void`
2037
+
2038
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2039
+ |---|---|---|---|---|
2040
+ | `value` | model | `string` | `''` | HTML canônico. Two-way (`[(value)]`). |
2041
+ | `label` | input (obrigatório) | `string` | | Rótulo do campo (nome acessível da área de edição). |
2042
+ | `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
2043
+ | `hint` | input | `string` | `''` | |
2044
+ | `placeholder` | input | `string` | `''` | Texto exibido com o documento vazio. |
2045
+ | `readonly` | input | `boolean` | `false` | Somente leitura: mostra o conteúdo (links navegam), permite selecionar e copiar, sem barra. |
2046
+ | `loading` | input | `boolean` | `false` | |
2047
+ | `tools` | input | `readonly RichTextTool[]` | `RICH_TEXT_DEFAULT_TOOLS` | Ferramentas da barra, na ordem (`'\|'` separa grupos). Também define o esquema aceito. |
2048
+ | `headingLevels` | input | `readonly RichTextHeadingLevel[]` | `[2, 3]` | Níveis de título oferecidos e aceitos. |
2049
+ | `hideToolbar` | input | `boolean` | `false` | Oculta a barra; os atalhos continuam valendo. |
2050
+ | `rows` | input | `number` | `5` | Altura mínima, em linhas de texto. |
2051
+ | `maxRows` | input | `number \| null` | `null` | Teto de altura em linhas (rola por dentro acima disso); `null` = sem teto. |
2052
+ | `maxLength` | input | `number \| null` | `null` | Limite flexível de caracteres de texto (não bloqueia a digitação). Liga o contador. |
2053
+ | `showCounter` | input | `boolean` | `false` | Mostra o contador mesmo sem `maxLength`. |
2054
+ | `pasteMode` | input | `RichTextPasteMode` | `'formatted'` | `'plain'` cola sempre como texto puro. |
2055
+ | `linkProtocols` | input | `readonly string[]` | `RICH_TEXT_DEFAULT_PROTOCOLS` | Protocolos aceitos em links (sem `:`). |
2056
+ | `allowRelativeLinks` | input | `boolean` | `false` | Aceita `href` relativo (`/caminho`, `#ancora`, `?q=`). |
2057
+ | `spellcheck` | input | `boolean` | `true` | |
2058
+ | `focusChange` | output | `boolean` | | Foco entrou (`true`) ou saiu (`false`) do componente (área, barra e popover de link contam). |
2059
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2060
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2061
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2062
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1918
2063
 
1919
2064
  ## `hm-search-field`
1920
2065
 
1921
2066
  `SearchFieldComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/search-field` (também na raiz)
1922
2067
 
1923
- Campo de busca: rótulo, lupa, botão de limpar e o termo publicado com espera opcional. Filtrar é de quem tem o dado, não deste componente.
2068
+ Campo de busca: `<input type="search">` com rótulo real, lupa decorativa e botão de limpar. Não filtra nada — publica o termo (`search`) e quem usa decide o que fazer com ele.
1924
2069
 
1925
2070
  Métodos públicos: `focus(): void`, `clear(): void`
1926
2071
 
@@ -1928,19 +2073,19 @@ Métodos públicos: `focus(): void`, `clear(): void`
1928
2073
  |---|---|---|---|---|
1929
2074
  | `value` | model | `string` | `''` | |
1930
2075
  | `label` | input (obrigatório) | `string` | | |
1931
- | `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
2076
+ | `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
1932
2077
  | `placeholder` | input | `string` | `''` | |
1933
- | `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
2078
+ | `hint` | input | `string` | `''` | |
1934
2079
  | `size` | input | `SearchFieldSize` | `'medium'` | |
1935
- | `debounce` | input | `number` | `0` | Espera (ms) entre a última tecla e o evento `search`. `0` = a cada tecla. |
1936
- | `landmark` | input | `boolean` | `true` | `role="search"` no contêiner (ver nota da classe). |
1937
- | `loading` | input | `boolean` | `false` | Silhueta no lugar do campo enquanto a tela resolve. |
1938
- | `search` | output | `string` | | Termo publicado (com `debounce`); `Enter` e limpar publicam na hora. |
1939
- | `cleared` | output | `void` | | O termo foi limpo (botão ou `Esc`). |
1940
- | `disabled` | input (herdado) | `boolean` | `false` | |
1941
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
1942
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
1943
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2080
+ | `debounce` | input | `number` | `0` | Espera (ms) depois da última tecla antes de publicar `search`; 0 = na hora. |
2081
+ | `landmark` | input | `boolean` | `true` | Marca o bloco como região de busca (`role="search"`). |
2082
+ | `loading` | input | `boolean` | `false` | |
2083
+ | `search` | output | `string` | | Termo publicado (por tecla, depois da espera, no Enter ou ao limpar). |
2084
+ | `cleared` | output | `void` | | O termo foi limpo (botão, Esc ou `clear()`). |
2085
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2086
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2087
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2088
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1944
2089
 
1945
2090
  ## `hm-segmented-control`
1946
2091
 
@@ -1955,10 +2100,10 @@ Escolha exclusiva entre poucas opções curtas (2 a 5), todas visíveis de uma v
1955
2100
  | `label` | input (obrigatório) | `string` | | Nome do grupo para leitor de tela (não aparece: o rótulo visível mora na linha em volta). |
1956
2101
  | `size` | input | `SegmentedControlSize` | `'medium'` | |
1957
2102
  | `emphasis` | input | `SegmentedControlEmphasis` | `'subtle'` | |
1958
- | `disabled` | input (herdado) | `boolean` | `false` | |
1959
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
1960
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
1961
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2103
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2104
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2105
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2106
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1962
2107
 
1963
2108
  ## `hm-select`
1964
2109
 
@@ -1972,12 +2117,12 @@ Slots: `(padrão)`
1972
2117
  |---|---|---|---|---|
1973
2118
  | `value` | model | `T` | `undefined as unknown as T` | Genérico: `T` default `string \| null` porque um select sem seleção (placeholder "Selecione...") é um estado comum. Tipado como `T` para quem recebe o `valueCha… |
1974
2119
  | `label` | input (obrigatório) | `string` | | |
1975
- | `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
2120
+ | `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
1976
2121
  | `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
1977
- | `disabled` | input (herdado) | `boolean` | `false` | |
1978
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
1979
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
1980
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2122
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2123
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2124
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2125
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1981
2126
 
1982
2127
  ## `hm-session-recovery`
1983
2128
 
@@ -2051,15 +2196,15 @@ Métodos públicos: `focusFirstInvalid(): void`
2051
2196
 
2052
2197
  `ShortcutListComponent` — import de `@trismegisto/angular/shortcut-list` (também na raiz)
2053
2198
 
2054
- Painel de atalhos de teclado: um bloco por grupo, cada atalho com a descrição e as teclas desenhadas como tecla (`<kbd>`). Cabe dentro de um `hm-modal` — o diálogo que o `?` costuma abrir.
2199
+ Painel com os atalhos de teclado do app, agrupados: os registrados no `HermesShortcutService` (que entram e saem conforme as telas abrem e fecham) e os declarados em `items`. Cada tecla é um `<kbd>` — o mesmo desenho do `.hm-kbd` do core —, com o nome por extenso para leitor de tela quando o rótulo é só um símbolo (⌘, ⇧, ←).
2055
2200
 
2056
2201
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2057
2202
  |---|---|---|---|---|
2058
- | `items` | input | `readonly HermesShortcutItem[]` | `[]` | Atalhos declarados além dos registrados (os que outra peça ou o navegador disparam). |
2059
- | `registered` | input | `boolean` | `true` | Inclui os atalhos registrados no `HermesShortcutService`. |
2060
- | `searchable` | input | `boolean` | `false` | Mostra a busca. |
2061
- | `characterKeysToggle` | input | `boolean` | `false` | Mostra o interruptor dos atalhos de tecla única (WCAG 2.1.4). |
2062
- | `headingLevel` | input | `number` | `3` | Nível do título de cada grupo (3 = abaixo do título de um `hm-modal`). |
2203
+ | `items` | input | `readonly HermesShortcutItem[]` | `[]` | Atalhos que só aparecem no painel (tratados pelo próprio componente, por exemplo). |
2204
+ | `registered` | input | `boolean` | `true` | Inclui os atalhos registrados no serviço. |
2205
+ | `searchable` | input | `boolean` | `false` | |
2206
+ | `characterKeysToggle` | input | `boolean` | `false` | Mostra o interruptor dos atalhos de tecla única. |
2207
+ | `headingLevel` | input | `number` | `3` | Nível dos títulos de grupo (`aria-level`). |
2063
2208
 
2064
2209
  ## `[hmShortcut]`
2065
2210
 
@@ -2081,7 +2226,7 @@ Liga um atalho de teclado a um elemento **enquanto ele existe**: registra no `He
2081
2226
 
2082
2227
  `SidebarGroupComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
2083
2228
 
2084
- Grupo expansível do `hm-sidebar`: cabeçalho clicável (ícone, rótulo, seta) e os links (ou outro grupo, no 3º nível) que abrem embaixo. O primeiro nível nasce aberto; um grupo dentro de outro nasce fechado. O aberto/fechado mora no `HermesSidebarService`, só na sessão.
2229
+ Grupo expansível da navegação lateral (padrão APG *Disclosure*). No primeiro nível nasce aberto; dentro de outro grupo, fechado. A escolha vale para a sessão e é por `id` — dois grupos com o mesmo `id` dividem a preferência, então use ids únicos.
2085
2230
 
2086
2231
  Slots: `(padrão)`
2087
2232
 
@@ -2089,62 +2234,62 @@ Métodos públicos: `expand(): void`, `markActive(source: object, active: boolea
2089
2234
 
2090
2235
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2091
2236
  |---|---|---|---|---|
2092
- | `id` | input (obrigatório) | `string` | | Identifica o grupo no serviço. Use um valor **único** (ex.: o caminho da rota): ids repetidos fazem grupos distintos compartilharem estado. |
2237
+ | `id` | input (obrigatório) | `string` | | Chave da preferência de aberto/fechado (e alvo de "expandir/recolher tudo"). |
2093
2238
  | `label` | input (obrigatório) | `string` | | |
2094
- | `icon` | input (obrigatório) | `string` | | |
2239
+ | `icon` | input (obrigatório) | `string` | | Nome de ícone do catálogo; quem usa registra. |
2095
2240
 
2096
2241
  ## `hm-sidebar-link`
2097
2242
 
2098
2243
  `SidebarLinkComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
2099
2244
 
2100
- Item de navegação: ícone, texto e o destino da rota. Solto dentro do `hm-sidebar` ou aninhado num `hm-sidebar-group` (clicar nele abre o grupo). Só apresentação: aponta para a rota, não decide.
2245
+ Item de rota da navegação lateral: um `<a routerLink>` de verdade (Ctrl/clique do meio abrem em outra aba). A atividade usa as opções padrão do `RouterLinkActive` — a rota-pai continua ativa nas filhas — e é repassada ao grupo mais próximo.
2101
2246
 
2102
2247
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2103
2248
  |---|---|---|---|---|
2104
2249
  | `route` | input (obrigatório) | `string \| readonly unknown[]` | | |
2105
- | `label` | input (obrigatório) | `string` | | Texto do item; único rótulo que resta com a navegação colapsada (via `title`). |
2106
- | `icon` | input (obrigatório) | `string` | | |
2250
+ | `label` | input (obrigatório) | `string` | | |
2251
+ | `icon` | input (obrigatório) | `string` | | Nome de ícone do catálogo; quem usa registra. |
2107
2252
 
2108
2253
  ## `hm-sidebar-node`
2109
2254
 
2110
2255
  `SidebarNodeComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
2111
2256
 
2112
- Desenha um nó da árvore dentro do `hm-sidebar`: sem filhos (ou com `depth <= 0`) vira link direto; com filhos e `depth > 0` vira grupo expansível com os filhos, um nível mais fundo (`depth - 1`) cada. É recursivo, mas **capado em profundidade**: ao chegar em `0` o nó vira link mesmo tendo filhos, porque navegar até ele é entrar na rota, que decide o que fazer com o resto.
2257
+ Desenha uma árvore de `SidebarNode` com `hm-sidebar-group`/`hm-sidebar-link`. `depth` é quantos níveis ainda podem virar grupo: `0` desenha só links (lista de módulos), `Infinity` aninha até as folhas.
2113
2258
 
2114
2259
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2115
2260
  |---|---|---|---|---|
2116
2261
  | `node` | input (obrigatório) | `SidebarNode` | | |
2117
- | `depth` | input | `number` | `1` | Quantos níveis de grupo ainda restam, incluindo este. `0` trava como link mesmo com filhos. |
2262
+ | `depth` | input | `number` | `1` | |
2118
2263
 
2119
2264
  ## `hm-sidebar`
2120
2265
 
2121
2266
  `SidebarComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
2122
2267
 
2123
- Navegação lateral do shell. Em tela larga tem três modos (`HermesSidebarService`); o padrão, **auto**, é compacta em repouso e abre por cima do conteúdo ao aproximar o ponteiro ou o foco de teclado. Abaixo de 768px vira sobreposição, aberta pelo gatilho do `hm-header`.
2268
+ Coluna de navegação do shell. O conteúdo projetado (links, grupos, `hm-sidebar-node` ou qualquer outra coisa) rola dentro de `#hm-sidebar-content`. Com `heading`, a coluna mostra um nível de módulo com título e, se houver `backLabel`, o botão de voltar (`back`).
2124
2269
 
2125
2270
  Slots: `(padrão)`
2126
2271
 
2127
2272
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2128
2273
  |---|---|---|---|---|
2129
- | `label` | input (obrigatório) | `string` | | Nome da navegação para leitor de tela. |
2130
- | `heading` | input | `string` | `''` | O que a coluna mostra — o módulo em que se está. Vazio não desenha cabeçalho (nível raiz). Também é a chave da troca de conteúdo: quando muda, o nível é recria… |
2274
+ | `label` | input (obrigatório) | `string` | | Nome do landmark `<nav>`. |
2275
+ | `heading` | input | `string` | `''` | Título do nível atual; vazio = nível raiz, sem topo. |
2131
2276
  | `headingIcon` | input | `string` | `'grid'` | |
2132
- | `backLabel` | input | `string` | `''` | Rótulo da volta para o nível de cima. Vazio não desenha o botão. |
2133
- | `direction` | input | `'forward' \| 'back'` | `'forward'` | Para que lado a troca de nível se move. |
2134
- | `collapsible` | input | `boolean` | `true` | Oferece a escolha de modo no rodapé. |
2277
+ | `backLabel` | input | `string` | `''` | Texto do botão de voltar (só aparece com `heading`); vazio = sem botão. |
2278
+ | `direction` | input | `'forward' \| 'back'` | `'forward'` | De que lado o nível novo entra: `forward` vem do fim, `back` do início. |
2279
+ | `collapsible` | input | `boolean` | `true` | Rodapé com o menu de modos e as ações de expandir/recolher tudo. |
2135
2280
  | `back` | output | `void` | | |
2136
2281
 
2137
2282
  ## `hm-skeleton`
2138
2283
 
2139
2284
  `SkeletonComponent` — import de `@trismegisto/angular/skeleton` (também na raiz)
2140
2285
 
2141
- O único estado de espera do Hermes — não há spinner genérico. Um esqueleto reserva o espaço que o conteúdo vai ocupar e responde "vai chegar o quê", que é a pergunta de quem espera; um spinner centrado numa região vazia é trocado por uma lista de linhas e a página salta no instante em que o dado chega — bem na tela em que a pessoa estava olhando.
2286
+ Silhueta de carregamento no lugar do conteúdo que ainda não chegou.
2142
2287
 
2143
2288
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2144
2289
  |---|---|---|---|---|
2145
2290
  | `shape` | input | `SkeletonShape` | `'text'` | |
2146
- | `count` | input | `number` | `3` | Quantas linhas, itens ou cartões desenhar. |
2147
- | `label` | input (obrigatório) | `string` | | O que está sendo carregado, para quem usa leitor de tela — puramente visual sem isto. |
2291
+ | `count` | input | `number` | `3` | Quantas linhas, faixas ou cartões (mínimo 1). |
2292
+ | `label` | input (obrigatório) | `string` | | Nome do que está carregando, para o leitor de tela. |
2148
2293
 
2149
2294
  ## `hm-slider`
2150
2295
 
@@ -2171,10 +2316,10 @@ Controle deslizante — valor único ou intervalo (dois polegares), com o padrã
2171
2316
  | `size` | input | `SliderSize` | `'medium'` | |
2172
2317
  | `format` | input | `Intl.NumberFormatOptions \| null` | `null` | Opções do `Intl.NumberFormat` para o valor exibido e anunciado. |
2173
2318
  | `valueText` | input | `((value: number, thumb: SliderThumb \| null) => string) \| null` | `null` | Texto exibido/anunciado de um valor (tem precedência sobre `format`). |
2174
- | `disabled` | input (herdado) | `boolean` | `false` | |
2175
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
2176
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
2177
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2319
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2320
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2321
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2322
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2178
2323
 
2179
2324
  ## `hm-spinner`
2180
2325
 
@@ -2232,46 +2377,46 @@ Métodos públicos: `restoreDefault(): void`
2232
2377
 
2233
2378
  `StatCardComponent` — import de `@trismegisto/angular/stat-card` (também na raiz)
2234
2379
 
2235
- Casca de card pra métrica (ícone + rótulo + valor num destaque), sobre o `hm-card`: a borda, o padding, o raio e a altura 100% (estica junto com os vizinhos do grid) já vêm prontos — não reimplemente essa casca no app.
2380
+ Indicador de um número só (`hm-stat-card`), desenhado sobre um `hm-card`: rótulo com ícone num disco, o valor em destaque e, se quiser, uma frase de contexto, o detalhamento e a variação.
2236
2381
 
2237
2382
  Slots: `[trailing]`, `[footer]`
2238
2383
 
2239
2384
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2240
2385
  |---|---|---|---|---|
2241
- | `icon` | input | `string` | `''` | Ícone do círculo ao lado do rótulo. Vazio = sem círculo. |
2242
- | `label` | input (obrigatório) | `string` | | |
2243
- | `value` | input (obrigatório) | `number \| string` | | |
2244
- | `intent` | input | `IconStatus` | `'neutral'` | Cor do círculo do ícone e do valor. Mesmo eixo `status` do `hm-icon`. |
2245
- | `fill` | input | `boolean` | `true` | Mesmo `fill` do `hm-card`: liga quando a altura vem de fora (grid com `align-items: stretch`), pra o card preencher a célula inteira em vez de só a altura do p… |
2246
- | `description` | input | `string` | `''` | Frase curta, sempre visível, sob o valor: o que o indicador conta. |
2247
- | `details` | input | `readonly StatCardDetail[]` | `[]` | Fragmentos do detalhamento, separados por `·`. |
2248
- | `trend` | input | `StatCardTrend \| null` | `null` | Variação do número, com seta. |
2249
- | `hint` | input | `string` | `''` | Explicação do indicador, num `hm-toggletip` ao lado do rótulo. |
2386
+ | `icon` | input | `string` | `''` | Ícone do catálogo num disco ao lado do rótulo; vazio = sem disco. |
2387
+ | `label` | input (obrigatório) | `string` | | Nome do indicador. |
2388
+ | `value` | input (obrigatório) | `string \| number` | | O número (ou texto) em destaque, impresso sem formatação. |
2389
+ | `intent` | input | `IconStatus` | `'neutral'` | Tom do disco e do valor. |
2390
+ | `fill` | input | `boolean` | `true` | Repassado ao `fill` do `hm-card`. |
2391
+ | `description` | input | `string` | `''` | Frase curta, sempre visível, sob o valor. |
2392
+ | `details` | input | `readonly StatCardDetail[]` | `[]` | Fragmentos do detalhamento, em linha. |
2393
+ | `trend` | input | `StatCardTrend \| null` | `null` | Variação com seta; `null` = nenhuma. |
2394
+ | `hint` | input | `string` | `''` | Explicação aberta sob demanda num `hm-toggletip`. |
2250
2395
  | `size` | input | `StatCardSize` | `'medium'` | |
2251
- | `selectable` | input | `boolean` | `false` | O cartão vira botão de alternância (`aria-pressed`), para agir como filtro. |
2252
- | `selected` | input | `boolean` | `false` | Este é o cartão escolhido. Só tem efeito com `selectable`. |
2253
- | `selectedChange` | output | `boolean` | | Pedido de troca, com o valor desejado (`!selected`). Só emite com `selectable`. |
2254
- | `loading` | input | `boolean` | `false` | O dado ainda não chegou: valor, detalhamento e variação viram esqueleto. |
2396
+ | `selectable` | input | `boolean` | `false` | Faz do cartão um botão de alternância. |
2397
+ | `selected` | input | `boolean` | `false` | Ligado; só conta com `selectable`. |
2398
+ | `selectedChange` | output | `boolean` | | Pede a troca de estado com o valor desejado (`!selected`). |
2399
+ | `loading` | input | `boolean` | `false` | O dado ainda não chegou. |
2255
2400
 
2256
2401
  ## `hm-stat-group`
2257
2402
 
2258
2403
  `StatGroupComponent` — import de `@trismegisto/angular/stat-group` (também na raiz)
2259
2404
 
2260
- Várias métricas de uma mesma categoria sob um título, com uma ação "ver mais" opcional. Sobre o `hm-card`: o título vira o `heading` do card, então o grupo é uma região nomeada (`role="region"`) — dê títulos distintos a grupos na mesma tela.
2405
+ Resumo de uma categoria (`hm-stat-group`): um `hm-card` com título que vira região nomeada, as métricas dela numa lista de descrição (`<dl>`) e, se pedido, uma ação "ver mais" no rodapé.
2261
2406
 
2262
2407
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2263
2408
  |---|---|---|---|---|
2264
- | `heading` | input (obrigatório) | `string` | | Categoria que as métricas compartilham (`MPLS`, `Internet`). Nomeia a região. |
2265
- | `icon` | input | `string` | `''` | Ícone ao lado do título. Decorativo. |
2409
+ | `heading` | input (obrigatório) | `string` | | Categoria das métricas: título do card e nome da região. |
2410
+ | `icon` | input | `string` | `''` | Ícone decorativo ao lado do título. |
2266
2411
  | `metrics` | input (obrigatório) | `readonly StatGroupMetric[]` | | |
2267
- | `intent` | input | `IconStatus` | `'neutral'` | Cor dos valores (o grupo inteiro fala de uma categoria só). Padrão `neutral`. |
2268
- | `hint` | input | `string` | `''` | Explicação da regra por trás das métricas, num `hm-toggletip` no canto do cabeçalho. |
2269
- | `moreLabel` | input | `string` | `''` | Texto da ação "ver mais". Vazio, com `moreLink`/`showMore`, usa o do catálogo. |
2270
- | `moreLink` | input | `string` | `''` | Destino da ação: vira link. Sem ele (e com `moreLabel`), botão que emite `more`. |
2271
- | `moreAction` | input | `boolean` | `false` | Liga a ação mesmo sem `moreLabel`/`moreLink` (texto do catálogo, emite `more`). |
2272
- | `fill` | input | `boolean` | `true` | Mesmo `fill` do `hm-card` (altura vinda da grade). |
2273
- | `loading` | input | `boolean` | `false` | Valores ainda não chegaram: viram esqueleto; rótulos ficam; a ação some. |
2274
- | `more` | output | `void` | | A pessoa acionou "ver mais" (também emite quando é link, antes de navegar). |
2412
+ | `intent` | input | `IconStatus` | `'neutral'` | Tom dos valores que não trazem o próprio. |
2413
+ | `hint` | input | `string` | `''` | Explicação das métricas, no canto do cabeçalho. |
2414
+ | `moreLabel` | input | `string` | `''` | Texto da ação; vazio usa `statCard.more`. |
2415
+ | `moreLink` | input | `string` | `''` | Destino da ação; com ele a ação é um link. |
2416
+ | `moreAction` | input | `boolean` | `false` | Mostra a ação mesmo sem texto nem destino. |
2417
+ | `fill` | input | `boolean` | `true` | Repassado ao `fill` do `hm-card`. |
2418
+ | `loading` | input | `boolean` | `false` | |
2419
+ | `more` | output | `void` | | A ação "ver mais" foi acionada (botão ou link). |
2275
2420
 
2276
2421
  ## `hm-state-page`
2277
2422
 
@@ -2294,44 +2439,44 @@ Slots: `(padrão)`
2294
2439
 
2295
2440
  `StateScreenComponent` — import de `@trismegisto/angular/state-screen` (também na raiz)
2296
2441
 
2297
- Tela inteira de feedback: título, descrição, ilustração e a ação de retorno — estado vazio e feedback com a mesma anatomia, mudando só a situação.
2442
+ Tela de situação — lista vazia, erro, acesso negado, fim de fluxo — com título, explicação, ilustração e uma ação para seguir em frente.
2298
2443
 
2299
2444
  Slots: `[illustration]`, `(padrão)`
2300
2445
 
2301
2446
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2302
2447
  |---|---|---|---|---|
2303
2448
  | `heading` | input (obrigatório) | `string` | | |
2304
- | `description` | input | `string` | `''` | Uma frase dizendo o que aconteceu ou o que fazer em seguida. |
2449
+ | `description` | input | `string` | `''` | Explicação curta embaixo do título. Vazia não desenha. |
2305
2450
  | `situation` | input | `StateScreenSituation` | `'empty'` | |
2306
- | `action` | input | `string` | `''` | Rótulo da ação; vazio não desenha o botão. |
2451
+ | `action` | input | `string` | `''` | Rótulo do botão principal. Vazio = sem botão. |
2307
2452
  | `actionIcon` | input | `string` | `'arrow-left'` | |
2308
- | `actionTriggered` | output | `void` | | Clique na ação. Navegar é de quem usa a peça, não dela. |
2453
+ | `actionTriggered` | output | `void` | | |
2309
2454
 
2310
2455
  ## `hm-step`
2311
2456
 
2312
2457
  `StepComponent` — import de `@trismegisto/angular/stepper` (também na raiz)
2313
2458
 
2314
- Uma etapa de `hm-stepper`/`hm-wizard`: o rótulo e a situação dela entram no indicador (desenhado pelo grupo), e o conteúdo (`<ng-content>`) só aparece enquanto ela é a etapa aberta.
2459
+ Uma etapa de `hm-stepper` (ou de `hm-wizard`). Só a etapa aberta desenha o painel; as outras ficam sem nada no DOM, mas o conteúdo projetado continua vivo — um formulário preenchido numa etapa está lá do mesmo jeito quando a pessoa volta a ela.
2315
2460
 
2316
2461
  Slots: `(padrão)`
2317
2462
 
2318
2463
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2319
2464
  |---|---|---|---|---|
2320
- | `label` | input | `string` | `''` | Rótulo da etapa no indicador e título do painel. |
2321
- | `description` | input | `string` | `''` | Texto curto sob o rótulo no indicador. |
2322
- | `optional` | input | `boolean` | `false` | Pode ser pulada sem ser concluída (não bloqueia o avanço no modo linear). |
2323
- | `disabled` | input | `boolean` | `false` | Fora do alcance: não navegável, pulada por Avançar/Voltar. |
2324
- | `error` | input | `boolean` | `false` | Força a etapa como com erro (por exemplo, o servidor recusou um dado dela). |
2325
- | `completed` | input | `boolean \| null` | `null` | Força concluída (`true`) ou pendente (`false`); `null` deixa o stepper decidir ao avançar. |
2326
- | `stepControl` | input | `AbstractControl \| null` | `null` | Formulário da etapa: precisa estar válido para avançar no modo linear. |
2327
- | `canAdvance` | input | `HermesStepGuard \| null` | `null` | Regra extra de avanço, síncrona ou assíncrona. |
2328
- | `summary` | input | `HermesStepSummary \| null` | `null` | O que a etapa coletou, para a página de resumo do `hm-wizard`. `null` = fica fora do resumo. |
2465
+ | `label` | input | `string` | `''` | Nome da etapa no indicador e título do painel. |
2466
+ | `description` | input | `string` | `''` | Texto curto sob o nome, no indicador. |
2467
+ | `optional` | input | `boolean` | `false` | Não segura o avanço no modo linear, nem impede o fluxo de ficar completo. |
2468
+ | `disabled` | input | `boolean` | `false` | Nunca alcançável; Avançar e Voltar passam por cima dela. |
2469
+ | `error` | input | `boolean` | `false` | Força a situação de erro (soma-se ao erro de validação). |
2470
+ | `completed` | input | `boolean \| null` | `null` | `true`/`false` forçam concluída/pendente; `null` deixa o stepper decidir pelo que a pessoa fez. |
2471
+ | `stepControl` | input | `AbstractControl \| null` | `null` | Controle validado ao sair adiante da etapa (é tocado para mostrar os erros). |
2472
+ | `canAdvance` | input | `HermesStepGuard \| null` | `null` | Guarda extra, chamada depois do controle passar. |
2473
+ | `summary` | input | `HermesStepSummary \| null` | `null` | O que esta etapa mostra na página de revisão do `hm-wizard`. |
2329
2474
 
2330
2475
  ## `hm-stepper`
2331
2476
 
2332
2477
  `StepperComponent` — import de `@trismegisto/angular/stepper` (também na raiz)
2333
2478
 
2334
- Indicador de etapas de um fluxo (`hm-stepper` + `hm-step`): onde a pessoa está, o que já ficou pronto, o que deu erro — e o conteúdo da etapa aberta logo abaixo (ou ao lado, na vertical).
2479
+ Fluxo em etapas: o indicador (lista ordenada dentro de um `nav`) e o painel da etapa aberta.
2335
2480
 
2336
2481
  Slots: `(padrão)`
2337
2482
 
@@ -2339,60 +2484,60 @@ Métodos públicos: `isActive(step: object): boolean`, `next(): Promise<boolean>
2339
2484
 
2340
2485
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2341
2486
  |---|---|---|---|---|
2342
- | `selectedIndex` | model | `number` | `0` | Two-way: índice da etapa aberta. |
2343
- | `linear` | input | `boolean` | `false` | Não avança sem validar a etapa aberta e não pula etapas pelos rótulos. |
2344
- | `orientation` | input | `StepperOrientation` | `'horizontal'` | Direção da trilha. A horizontal deita sozinha em contêiner estreito. |
2345
- | `readOnly` | input | `boolean` | `false` | Ninguém navega pelos rótulos: as etapas só informam. |
2346
- | `label` | input | `string` | `''` | Nome da lista de etapas. Vazio = catálogo ("Etapas"). |
2347
- | `level` | input | `number` | `3` | Nível do título de cada painel (`aria-level`). |
2348
- | `hideHeading` | input | `boolean` | `false` | Título do painel só para leitor de tela (quando o conteúdo já tem o próprio título). |
2349
- | `steps` | input | `readonly StepComponent[] \| null` | `null` | Etapas vindas de fora em vez dos `hm-step` filhos. Uso do `hm-wizard`, que re-projeta as etapas dele (e um `contentChildren` não enxerga conteúdo re-projetado). |
2487
+ | `selectedIndex` | model | `number` | `0` | Índice (0-based) da etapa aberta. Two-way. |
2488
+ | `linear` | input | `boolean` | `false` | Avançar valida a etapa aberta e o indicador não salta adiante sem concluir as anteriores. |
2489
+ | `orientation` | input | `StepperOrientation` | `'horizontal'` | |
2490
+ | `readOnly` | input | `boolean` | `false` | Indicador só informativo: nenhuma etapa é clicável. |
2491
+ | `label` | input | `string` | `''` | Nome do `nav`. Vazio = catálogo. |
2492
+ | `level` | input | `number` | `3` | `aria-level` do título de cada painel. |
2493
+ | `hideHeading` | input | `boolean` | `false` | Título do painel só para leitor de tela (quando a tela já tem um título visível). |
2494
+ | `steps` | input | `readonly StepComponent[] \| null` | `null` | Etapas explícitas no lugar das filhas. Para quem re-projeta `hm-step` (o `hm-wizard`): conteúdo re-projetado não aparece na consulta de conteúdo deste componen… |
2350
2495
 
2351
2496
  ## `hm-switch`
2352
2497
 
2353
2498
  `SwitchComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/switch` (também na raiz)
2354
2499
 
2355
- Interruptor: liga e desliga uma preferência **com efeito imediato**. Mesmo contrato dos outros controles: Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
2500
+ Interruptor de efeito imediato (ligar/desligar uma preferência). É um checkbox nativo com `role="switch"`: Espaço alterna e o leitor anuncia "ligado/desligado". Para escolha que só vale ao enviar um formulário, prefira `hm-checkbox`.
2356
2501
 
2357
2502
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2358
2503
  |---|---|---|---|---|
2359
2504
  | `value` | model | `boolean` | `false` | |
2360
2505
  | `label` | input (obrigatório) | `string` | | |
2361
- | `hint` | input | `string` | `''` | Texto auxiliar permanente abaixo do controle. |
2506
+ | `hint` | input | `string` | `''` | Texto de apoio embaixo do rótulo. |
2362
2507
  | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
2363
- | `labelPosition` | input | `SwitchLabelPosition` | `'after'` | `before` põe o rótulo à esquerda do controle — para uma linha de configuração, onde a coluna de interruptores alinha à direita e o olho desce por ela. |
2364
- | `loading` | input | `boolean` | `false` | Silhueta de carregamento no lugar do controle. Estado da peça, como `disabled`. |
2365
- | `disabled` | input (herdado) | `boolean` | `false` | |
2366
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
2367
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
2368
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2508
+ | `labelPosition` | input | `SwitchLabelPosition` | `'after'` | Lado do rótulo. A ordem de leitura e de foco não muda. |
2509
+ | `loading` | input | `boolean` | `false` | Silhueta no lugar do controle enquanto o valor real não chega. |
2510
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2511
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2512
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2513
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2369
2514
 
2370
2515
  ## `hm-tab-bar`
2371
2516
 
2372
2517
  `TabBarComponent` — import de `@trismegisto/angular/tab-bar` (também na raiz)
2373
2518
 
2374
- A fileira de abas "de navegador": escolher, fechar, reordenar e arrastar. Apresentacional — não sabe o que é uma página, só desenha o que recebe; quem decide o resto é quem consome `(activated)`/`(closed)`/`(reordered)`.
2519
+ Fileira de abas "de navegador" (páginas abertas), **controlada**: desenha `tabs`/`active` e só emite intenções — ativar, fechar, reordenar, nova aba, menu de contexto, aba recebida de outra fileira. Quem consome (um `TabBarStore`, o `hm-workspace`) aplica a mudança.
2375
2520
 
2376
2521
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2377
2522
  |---|---|---|---|---|
2378
2523
  | `tabs` | input (obrigatório) | `readonly TabItem[]` | | |
2379
- | `active` | input (obrigatório) | `string` | | |
2380
- | `label` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.tabBar.label`). |
2381
- | `allowNewTab` | input | `boolean` | `true` | Mostra o `+` no fim da fileira. |
2382
- | `contentId` | input | `string` | `''` | Id do elemento que as abas controlam (`aria-controls`) — normalmente a região de conteúdo que troca ao ativar uma aba. Sem isto, nenhuma aba recebe `aria-contr… |
2383
- | `tabGroup` | input | `unknown` | `null` | Grupo de arrasto: fileiras com o mesmo valor (comparado por identidade — uma string ou um objeto, como o store do `hm-workspace`) aceitam abas umas das outras… |
2524
+ | `active` | input (obrigatório) | `string` | | Id da aba em cena. |
2525
+ | `label` | input | `string` | `''` | Nome da fileira (vazio = texto padrão do catálogo). |
2526
+ | `allowNewTab` | input | `boolean` | `true` | Mostra o botão "+" de nova aba. |
2527
+ | `contentId` | input | `string` | `''` | Id do elemento que mostra o conteúdo da aba ativa (`aria-controls`); vazio = sem o atributo. |
2528
+ | `tabGroup` | input | `unknown` | `null` | Grupo de fileiras que trocam abas por arrasto (comparado por identidade); `null` = só reordena. |
2384
2529
  | `activated` | output | `string` | | |
2385
2530
  | `closed` | output | `string` | | |
2386
- | `reordered` | output | `{ id: string; index: number }` | | Reordenar (arrasto, teclado do arrasto ou `Ctrl+←/→`): `index` é a posição final da aba. |
2531
+ | `reordered` | output | `{ id: string; index: number }` | | |
2387
2532
  | `newTabRequested` | output | `void` | | |
2388
- | `contextMenuRequested` | output | `{ id: string; anchor: PopoverAnchor }` | | Botão direito sobre uma aba: quem consome decide o que abrir ali (ex.: um `hm-menu`). |
2389
- | `tabReceived` | output | `TabReceivedEvent` | | Aba de outra fileira do mesmo `tabGroup` solta aqui: quem consome a move de fato (a fileira não é dona do estado). |
2533
+ | `contextMenuRequested` | output | `{ id: string; anchor: PopoverAnchor }` | | |
2534
+ | `tabReceived` | output | `TabReceivedEvent` | | |
2390
2535
 
2391
2536
  ## `ng-template[hmTabContent]`
2392
2537
 
2393
2538
  `TabContentDirective` — import de `@trismegisto/angular/tabs` (também na raiz)
2394
2539
 
2395
- Conteúdo preguiçoso de um `hm-tab`: o template só é montado na **primeira vez** que a aba é selecionada, e depois fica montado (escondido com `hidden` enquanto outra aba está em cena), para não perder estado (rolagem, formulário digitado) ao voltar. Com `destroyOnHide` no `hm-tab`, o conteúdo é destruído ao sair e montado de novo ao voltar.
2540
+ Conteúdo preguiçoso de um `hm-tab`: `<ng-template hmTabContent>…</ng-template>` (ou `*hmTabContent`) como filho direto da aba. Só é criado na primeira vez que a aba é exibida e, por padrão, fica vivo (escondido) quando a pessoa troca de aba; `destroyOnHide` no `hm-tab` o recria a cada volta.
2396
2541
 
2397
2542
  _Sem inputs/outputs._
2398
2543
 
@@ -2400,55 +2545,55 @@ _Sem inputs/outputs._
2400
2545
 
2401
2546
  `TabComponent` — import de `@trismegisto/angular/tabs` (também na raiz)
2402
2547
 
2403
- O painel de uma aba: só o conteúdo (`<ng-content>`) mostrado quando esta aba está selecionada. O botão da aba em si (o `role="tab"`) é responsabilidade do `hm-tabs`, que lê `label` e `disabled` de cada item para montar a tablist — este componente cuida só do `tabpanel`.
2548
+ Uma aba de `hm-tabs`. O botão (ou o link, no modo `nav`) é desenhado pelo grupo, na faixa; aqui fica só o painel, que existe enquanto a aba está em exibição. Com um `hmTabContent` filho direto, o conteúdo nasce na primeira exibição e sobrevive escondido às trocas de aba (salvo com `destroyOnHide`).
2404
2549
 
2405
2550
  Slots: `(padrão)`
2406
2551
 
2407
2552
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2408
2553
  |---|---|---|---|---|
2409
- | `id` | input | `string` | `''` | Identifica a aba dentro do grupo e liga o botão da tablist a este painel. Não é `input.required`: `active()` (abaixo) lê `group.selected()`, que itera o `id` d… |
2410
- | `label` | input | `string` | `''` | Texto do botão na tablist. Mesma razão do `id` acima para não ser `input.required`. |
2554
+ | `id` | input | `string` | `''` | Identificador da aba, o valor de `active` no grupo. |
2555
+ | `label` | input | `string` | `''` | Texto da aba na faixa. |
2411
2556
  | `disabled` | input | `boolean` | `false` | |
2412
- | `count` | input | `number \| null` | `null` | Quanta coisa há dentro da aba, desenhada ao lado do rótulo. |
2413
- | `route` | input | `string \| readonly unknown[] \| null` | `null` | Destino da aba no modo `nav` do `hm-tabs` (o mesmo valor que se passaria a um `routerLink`: string ou array de segmentos, relativo à rota de quem declara o `hm… |
2414
- | `exact` | input | `boolean` | `false` | No modo `nav`, a aba só conta como ativa com a URL **exatamente** igual ao destino (o `routerLinkActiveOptions: { exact: true }`). O padrão (`false`) marca a a… |
2415
- | `destroyOnHide` | input | `boolean` | `false` | Com conteúdo preguiçoso (`hmTabContent`), destrói o conteúdo ao trocar de aba em vez de mantê-lo montado e escondido. Use quando o conteúdo precisa recomeçar a… |
2557
+ | `count` | input | `number \| null` | `null` | Número exibido ao lado do rótulo (`0` aparece); `null` = sem contagem. |
2558
+ | `route` | input | `string \| readonly unknown[] \| null` | `null` | Só no modo `nav`: destino do link (como no `routerLink`). |
2559
+ | `exact` | input | `boolean` | `false` | Só no modo `nav`: o link fica atual apenas com a URL idêntica (rotas filhas não contam). |
2560
+ | `destroyOnHide` | input | `boolean` | `false` | Com `hmTabContent`: destrói o conteúdo ao sair da aba (recria ao voltar). |
2416
2561
 
2417
2562
  ## `hm-tabs`
2418
2563
 
2419
2564
  `TabsComponent` — import de `@trismegisto/angular/tabs` (também na raiz)
2420
2565
 
2421
- Grupo de abas de conteúdo: uma tablist de botões e o painel da aba selecionada, no padrão ARIA completo (`tablist`/`tab`/`tabpanel`, `aria-selected`, `aria-controls`, `aria-orientation`) com navegação por teclado e roving tabindex — só a aba ativa é parada de `Tab`, e as setas movem entre as demais (←/→ no horizontal, ↑/↓ no `orientation="vertical"`; `Home`/`End` nas pontas).
2566
+ Abas de conteúdo: alterna seções de uma mesma tela.
2422
2567
 
2423
2568
  Slots: `[actions]`, `(padrão)`
2424
2569
 
2425
2570
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2426
2571
  |---|---|---|---|---|
2427
- | `label` | input (obrigatório) | `string` | | Nome do grupo de abas (ou da região de navegação, no modo `nav`), lido pelo leitor de tela. |
2428
- | `active` | model | `string` | `''` | Two-way: id da aba ativa. Assume a primeira aba não desabilitada quando não informado. No modo `nav`, segue a rota. |
2429
- | `orientation` | input | `HermesTabsOrientation` | `'horizontal'` | `horizontal` (padrão) ou `vertical` (faixa à esquerda do painel, setas ↑/↓). |
2430
- | `mode` | input | `HermesTabsMode` | `'tabs'` | `tabs` (padrão): tablist com painéis. `nav`: links de rota (subnav), com `aria-current="page"`. |
2431
- | `overflow` | input | `HermesTabsOverflow` | `'menu'` | Abas que não cabem: `menu` (padrão) vão para o botão "Mais"; `wrap` quebra/rola como antes. Só no horizontal. |
2432
- | `fillHeight` | input | `boolean` | `false` | As abas ocupam a altura que sobrar e o painel rola por dentro dele mesmo. |
2433
- | `noPanelGap` | input | `boolean` | `false` | O painel da aba abre mão do respiro próprio. |
2572
+ | `label` | input (obrigatório) | `string` | | Nome acessível da lista de abas (ou da região de navegação, no modo `nav`). |
2573
+ | `active` | model | `string` | `''` | Id da aba ativa (two-way). |
2574
+ | `orientation` | input | `HermesTabsOrientation` | `'horizontal'` | |
2575
+ | `mode` | input | `HermesTabsMode` | `'tabs'` | |
2576
+ | `overflow` | input | `HermesTabsOverflow` | `'menu'` | Só na horizontal: `menu` leva as abas que não cabem para o "Mais"; `wrap` quebra a fileira. |
2577
+ | `fillHeight` | input | `boolean` | `false` | Ocupa a altura do pai flex; o painel em exibição fica com o restante e rola por dentro. |
2578
+ | `noPanelGap` | input | `boolean` | `false` | Tira o respiro vertical do painel (para conteúdo que já tem o seu). |
2434
2579
 
2435
2580
  ## `hm-tag`
2436
2581
 
2437
2582
  `TagComponent` — import de `@trismegisto/angular/tag` (também na raiz)
2438
2583
 
2439
- Marcação curta com nome e cor — a etiqueta de um cartão do quadro Kanban, ou o **status** de um objeto ("Ativa", "Bloqueada", "Em análise"). Diferente do `hm-badge` (contador que diz QUANTOS) e do `hm-chip` (item que a pessoa escolheu e pode remover), a etiqueta não se remove: é um atributo do objeto. A cor é fechada a uma paleta pequena de tokens semânticos, pra não abrir hex arbitrário.
2584
+ Etiqueta curta de categoria ou situação ("Ativa", "Rascunho", "Produção").
2440
2585
 
2441
2586
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2442
2587
  |---|---|---|---|---|
2443
2588
  | `name` | input (obrigatório) | `string` | | |
2444
2589
  | `color` | input | `TagColor` | `'neutral'` | |
2445
- | `compact` | input | `boolean` | `false` | Versão barra: só a cor, sem o nome escrito — o rosto de um cartão do Kanban, no padrão do Trello. O nome não desaparece: continua acessível por `title` (dica d… |
2590
+ | `compact` | input | `boolean` | `false` | Só a cor, sem texto visível (o nome vai para a dica e para o leitor de tela). |
2446
2591
 
2447
2592
  ## `[hmTextareaPrefix], [hmTextareaSuffix], [hmTextareaActions], [hmTextareaActionsEnd]`
2448
2593
 
2449
2594
  `TextareaAddonDirective` — import de `@trismegisto/angular/textarea` (também na raiz)
2450
2595
 
2451
- Marca um conteúdo projetado no `hm-textarea` como complemento do campo: - `hmTextareaPrefix` / `hmTextareaSuffix`: ao lado do texto, no início/fim da linha (ícone, avatar, botão curto); - `hmTextareaActions` / `hmTextareaActionsEnd`: na barra embaixo do texto, no início (anexar, formatar) e no fim (enviar).
2596
+ Marca um complemento do `hm-textarea` (prefixo, sufixo ou ação da barra de baixo). É a presença desta diretiva que liga a moldura de complementos: importe-a junto com o `TextareaComponent`.
2452
2597
 
2453
2598
  _Sem inputs/outputs._
2454
2599
 
@@ -2456,7 +2601,7 @@ _Sem inputs/outputs._
2456
2601
 
2457
2602
  `TextareaComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/textarea` (também na raiz)
2458
2603
 
2459
- Textarea com rótulo, texto de apoio, contador de caracteres opcional e mensagem de erro, no mesmo contrato do `hm-input`: Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
2604
+ Texto de várias linhas com rótulo, ajuda, contador e erro ligados por `aria-describedby`, na mesma régua do `hm-input`. Funciona com Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
2460
2605
 
2461
2606
  Slots: `[hmTextareaPrefix]`, `[hmTextareaSuffix]`, `[hmTextareaActions]`, `[hmTextareaActionsEnd]`
2462
2607
 
@@ -2464,21 +2609,21 @@ Slots: `[hmTextareaPrefix]`, `[hmTextareaSuffix]`, `[hmTextareaActions]`, `[hmTe
2464
2609
  |---|---|---|---|---|
2465
2610
  | `value` | model | `string` | `''` | |
2466
2611
  | `label` | input (obrigatório) | `string` | | |
2467
- | `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
2612
+ | `hint` | input | `string` | `''` | |
2468
2613
  | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
2469
2614
  | `placeholder` | input | `string` | `''` | |
2470
- | `maxLength` | input | `number \| null` | `null` | Limite exibido no contador; também vira `maxlength` do `<textarea>`. |
2471
- | `rows` | input | `number` | `3` | Linhas visíveis antes de crescer (com `autoGrow`) ou rolar. |
2472
- | `autoGrow` | input | `boolean` | `false` | Cresce junto com o conteúdo em vez de rolar por dentro; mede o DOM, só no navegador. |
2473
- | `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
2615
+ | `maxLength` | input | `number \| null` | `null` | Limite de caracteres, com contador. |
2616
+ | `rows` | input | `number` | `3` | |
2617
+ | `autoGrow` | input | `boolean` | `false` | Altura acompanha o conteúdo. |
2618
+ | `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
2474
2619
  | `loading` | input | `boolean` | `false` | |
2475
- | `maxRows` | input | `number \| null` | `null` | Com `autoGrow`: cresce até este número de linhas e passa a rolar por dentro. `null` = sem limite. |
2476
- | `submitKey` | input | `TextareaSubmitKey` | `'none'` | Atalho de teclado que emite `submitted` (ver `TextareaSubmitKey`). |
2477
- | `submitted` | output | `string` | | A pessoa usou o atalho de envio (`submitKey`); leva o texto atual. Limpar o campo é do app. |
2478
- | `disabled` | input (herdado) | `boolean` | `false` | |
2479
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
2480
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
2481
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2620
+ | `maxRows` | input | `number \| null` | `null` | Teto do `autoGrow`, em linhas. |
2621
+ | `submitKey` | input | `TextareaSubmitKey` | `'none'` | |
2622
+ | `submitted` | output | `string` | | |
2623
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2624
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2625
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2626
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2482
2627
 
2483
2628
  ## `hm-theme-builder`
2484
2629
 
@@ -2501,14 +2646,14 @@ Métodos públicos: `download(): void`
2501
2646
 
2502
2647
  `ThemePickerComponent` — import de `@trismegisto/angular/theme-picker` (também na raiz)
2503
2648
 
2504
- Conteúdo do modal de tema: grade de famílias de cor (aqui as mesmas 12 do design de referência, ver families.ts) e o par claro/escuro embaixo.
2649
+ Escolha de família de cor (e, opcionalmente, de claro/escuro). Não guarda nem aplica nada: mostra o que recebe em `family`/`theme` e avisa a escolha por `familyChosen`/`themeChosen` — quem aplica é o app (em geral `HermesThemeService`).
2505
2650
 
2506
2651
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2507
2652
  |---|---|---|---|---|
2508
2653
  | `families` | input (obrigatório) | `readonly HermesFamily[]` | | |
2509
- | `family` | input (obrigatório) | `string` | | |
2654
+ | `family` | input (obrigatório) | `string` | | Id da família escolhida. |
2510
2655
  | `theme` | input (obrigatório) | `HermesThemeName` | | |
2511
- | `showMode` | input | `boolean` | `true` | Mostra o par claro/escuro embaixo da grade. `false` quando o modo é escolhido em outro controle (ex.: `hm-segmented-control` com a opção "Sistema", no painel d… |
2656
+ | `showMode` | input | `boolean` | `true` | Mostra o par Claro/Escuro. |
2512
2657
  | `familyChosen` | output | `string` | | |
2513
2658
  | `themeChosen` | output | `HermesThemeName` | | |
2514
2659
 
@@ -2537,10 +2682,10 @@ Campo de hora. Digita-se a hora com máscara no relógio do idioma — 24 h (`14
2537
2682
  | `max` | input | `IsoTime \| null` | `null` | Último horário aceito (`HH:mm`). |
2538
2683
  | `interval` | input | `number` | `30` | Intervalo, em minutos, entre os horários sugeridos. |
2539
2684
  | `hourCycle` | input | `TimeHourCycle \| null` | `null` | Força o relógio de exibição (`h12`/`h23`); `null` segue o idioma. |
2540
- | `disabled` | input (herdado) | `boolean` | `false` | |
2541
- | `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
2542
- | `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
2543
- | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
2685
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2686
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2687
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2688
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2544
2689
 
2545
2690
  ## `hm-timeline-item`
2546
2691
 
@@ -2563,21 +2708,21 @@ Slots: `(padrão)`
2563
2708
 
2564
2709
  `TimelineComponent` — import de `@trismegisto/angular/timeline` (também na raiz)
2565
2710
 
2566
- Linha do tempo (`hm-timeline` + `hm-timeline-item`): a trilha de algo que anda sozinho — uma solicitação, um pedido, um chamado — com o que já aconteceu, onde está e o que falta.
2711
+ Linha do tempo de um processo que se acompanha: cada `hm-timeline-item` vira um marco com data, título, descrição e conteúdo livre. A situação de cada marco vem do próprio item (`status`) ou é deduzida de `current` (o marco em que o processo está) e `outcome` (correndo, concluído ou falhou).
2567
2712
 
2568
2713
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2569
2714
  |---|---|---|---|---|
2570
- | `orientation` | input | `TimelineOrientation` | `'vertical'` | Direção da trilha. A horizontal serve a poucos itens curtos; com muitos, use a vertical. |
2571
- | `current` | input | `string` | `''` | `key` do item em que o processo está agora. Vazio: nenhum (tudo pendente, salvo `status` explícito). |
2572
- | `outcome` | input | `TimelineOutcome` | `'running'` | Como o processo está: correndo (o atual pulsa), concluído (tudo concluído) ou com falha (o atual com erro). |
2573
- | `label` | input | `string` | `''` | Nome da lista para leitor de tela. Vazio = catálogo ("Linha do tempo"). |
2574
- | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | Formato das datas (`Intl.DateTimeFormatOptions`). Padrão: data média e hora curta. |
2715
+ | `orientation` | input | `TimelineOrientation` | `'vertical'` | |
2716
+ | `current` | input | `string` | `''` | `key` do marco em que o processo está. |
2717
+ | `outcome` | input | `TimelineOutcome` | `'running'` | `running` (padrão), `completed` (fecha todos) ou `failed` (o atual com erro). |
2718
+ | `label` | input | `string` | `''` | Nome da lista. Vazio = catálogo. |
2719
+ | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | Opções do `Intl.DateTimeFormat`; o idioma é o do catálogo ativo. |
2575
2720
 
2576
2721
  ## `hm-toast-stack`
2577
2722
 
2578
2723
  `ToastStackComponent` — import de `@trismegisto/angular/toast` (também na raiz)
2579
2724
 
2580
- A pilha de avisos flutuantes, montada uma vez pro app inteiro (ver `HermesToastService`).
2725
+ Onde os avisos do `HermesToastService` aparecem: uma coluna fixa no canto de cima, do lado do fim da linha. Monte uma vez, no layout do app (`<router-outlet /><hm-toast-stack />`).
2581
2726
 
2582
2727
  _Sem inputs/outputs._
2583
2728
 
@@ -2585,16 +2730,16 @@ _Sem inputs/outputs._
2585
2730
 
2586
2731
  `ToastComponent` — import de `@trismegisto/angular/toast` (também na raiz)
2587
2732
 
2588
- Um aviso que chega sozinho, em cartão flutuante: ícone da variante, título, mensagem, ação opcional (ex.: "Desfazer"), botão de fechar e a barra de tempo que ele tem na tela.
2733
+ Cartão de aviso flutuante. Normalmente quem o monta é o `hm-toast-stack`, a partir do `HermesToastService`; usado sozinho, quem decide quando tirá-lo da tela é você (`closed`).
2589
2734
 
2590
2735
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2591
2736
  |---|---|---|---|---|
2592
2737
  | `variant` | input | `AlertVariant` | `'info'` | |
2593
- | `title` | input | `string` | `''` | Vazio = título padrão da variante, do catálogo (`HERMES_MESSAGES.toast.titles`, acompanha o idioma). |
2738
+ | `title` | input | `string` | `''` | Título do cartão. Vazio usa o título padrão da variante. |
2594
2739
  | `message` | input (obrigatório) | `string` | | |
2595
- | `duration` | input | `number` | `0` | Milissegundos até sair sozinho. `0` fica até alguém fechar (é o que a pausa usa). |
2596
- | `actionLabel` | input | `string` | `''` | Texto do botão de ação (ex.: "Desfazer"). Vazio não desenha o botão. |
2597
- | `action` | output | `void` | | Clique no botão de ação. Quem usa decide se fecha (o `hm-toast-stack` roda a ação e fecha). |
2740
+ | `duration` | input | `number` | `0` | Milissegundos até fechar sozinho. `0` = só fecha pelo botão. |
2741
+ | `actionLabel` | input | `string` | `''` | Rótulo do botão de ação. Vazio = sem botão. |
2742
+ | `action` | output | `void` | | |
2598
2743
  | `closed` | output | `void` | | |
2599
2744
 
2600
2745
  ## `hm-toggle-group-item`
@@ -2639,7 +2784,7 @@ Métodos públicos: `isMultiple(): boolean`, `isPressed(value: string): boolean`
2639
2784
 
2640
2785
  `ToggletipComponent` — import de `@trismegisto/angular/toggletip` (também na raiz)
2641
2786
 
2642
- Dica de clique ("toggletip"): um ícone de informação que, **ao clique**, abre um balão de ajuda que fica até a pessoa fechar — clicando fora, no `Esc` (o foco volta ao ícone) ou de novo no ícone. O balão entra numa região `role="status"`, então o leitor de tela anuncia o texto ao abrir.
2787
+ Toggletip: um ícone que, clicado, mostra uma explicação curta num balão — e o mesmo clique esconde. Diferente da dica de hover (`hmTooltip`), o conteúdo fica até a pessoa fechar e pode ter link.
2643
2788
 
2644
2789
  Slots: `(padrão)`
2645
2790
 
@@ -2647,10 +2792,10 @@ Métodos públicos: `close(): void`
2647
2792
 
2648
2793
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2649
2794
  |---|---|---|---|---|
2650
- | `label` | input (obrigatório) | `string` | | Nome acessível do ícone — diga sobre o que é a ajuda: "Mais informações sobre o prazo". |
2651
- | `text` | input | `string` | `''` | Texto do balão. Pode ser substituído/complementado por conteúdo projetado. |
2652
- | `side` | input | `ToggletipSide` | `'bottom'` | |
2653
- | `intent` | input | `'default' \| 'danger'` | `'default'` | `danger`: ícone vermelho, para o aviso de um grupo sem campo próprio. |
2795
+ | `label` | input (obrigatório) | `string` | | Nome acessível do ícone (ex.: "Ajuda sobre o prazo de resposta"). |
2796
+ | `text` | input | `string` | `''` | Texto do balão; o conteúdo projetado vem depois dele. |
2797
+ | `side` | input | `ToggletipSide` | `'bottom'` | Lado preferido; vira para o outro quando não cabe. |
2798
+ | `intent` | input | `'default' \| 'danger'` | `'default'` | |
2654
2799
  | `icon` | input | `string` | `'info-circle'` | |
2655
2800
 
2656
2801
  ## `hm-toolbar`
@@ -2687,33 +2832,33 @@ Métodos públicos: `show(): void`, `hide(): void`
2687
2832
 
2688
2833
  `TreeComponent` — import de `@trismegisto/angular/tree` (também na raiz)
2689
2834
 
2690
- Árvore no padrão `role="tree"`, com as funcionalidades do `hermes-tree` do hermes-ui antigo: - **Seleção múltipla tri-state** (`selectable`, padrão): caixa `.hm-check` por nó — marcada, desmarcada ou indeterminada quando só parte dos filhos está marcada. Marcar uma pasta marca todas as folhas dela. Recebe `selected` e emite `changed` (lote) — não decide o domínio. - **Navegação** (`[selectable]="…
2835
+ Árvore (`hm-tree`), lista ARIA `tree` achatada: todos os `treeitem` são irmãos, com nível/posição em atributos.
2691
2836
 
2692
2837
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2693
2838
  |---|---|---|---|---|
2694
2839
  | `nodes` | input (obrigatório) | `readonly TreeNode[]` | | |
2695
- | `label` | input (obrigatório) | `string` | | Nome da árvore para leitor de tela. |
2696
- | `emptyMessage` | input | `string` | | |
2697
- | `selectable` | input | `boolean` | `true` | Mostra as caixas de marcação (seleção múltipla). `false` = árvore de navegação. |
2698
- | `selectionMode` | input | `TreeSelectionMode \| null` | `null` | Seleção por `aria-selected` (ver doc da classe). `null` (padrão) = comportamento de sempre, decidido por `selectable` (caixas tri-state ou navegação com `activ… |
2699
- | `selection` | model | `ReadonlySet<string>` | `new Set<string>()` | Two-way: ids selecionados em `selectionMode` `single`/`multiple`. |
2700
- | `selected` | input | `ReadonlySet<string>` | `new Set<string>()` | Ids marcados agora (folhas; ou pasta lazy ainda fechada). |
2701
- | `expanded` | model | `ReadonlySet<string>` | `new Set<string>()` | Two-way: ids das pastas abertas. |
2702
- | `activeId` | model | `string \| null` | `null` | Two-way: nó ativo (destacado, `aria-selected`) — seleção única / navegação. |
2703
- | `loadChildren` | input | `TreeChildrenLoader \| null` | `null` | Busca os filhos de um nó `expandable` na primeira vez que ele é aberto. |
2704
- | `changed` | output | `readonly TreeSelectionChange[]` | | O que marcar/desmarcar — sempre em lote, mesmo quando é uma folha só. |
2705
- | `activated` | output | `TreeNode` | | Nó ativado (clique/Enter) — em árvore de navegação, ou clique no rótulo com `selectable`. |
2706
- | `draggable` | input | `boolean` | `false` | Liga mover nó por arrasto (ponteiro e teclado). Nó desabilitado não é arrastado. |
2707
- | `canDrop` | input | `TreeCanDrop \| null` | `null` | Filtro de destino: pode soltar `node` em `position` de `target`? Substitui o padrão, que só aceita "dentro" de nó que pode ter filhos (`treeAcceptsChildren`).… |
2708
- | `moved` | output | `TreeMoveEvent` | | Nó solto num novo lugar. Os dados não mudam sozinhos: o app aplica (ex.: `moveTreeNode`). |
2709
- | `nodeActions` | input | `TreeNodeActions` | `EMPTY_ACTIONS` | Itens do menu de contexto do nó (vazio = menu nativo do navegador). Função = itens por nó. |
2710
- | `nodeAction` | output | `TreeNodeActionEvent` | | Item escolhido no menu de contexto de um nó. |
2840
+ | `label` | input (obrigatório) | `string` | | Nome acessível da árvore. |
2841
+ | `emptyMessage` | input | `string` | | Texto quando não há nada para mostrar (padrão: `tree.empty`). |
2842
+ | `selectable` | input | `boolean` | `true` | Caixas tri-state; `false` = árvore de navegação. Ignorado quando há `selectionMode`. |
2843
+ | `selectionMode` | input | `TreeSelectionMode \| null` | `null` | |
2844
+ | `selection` | model | `ReadonlySet<string>` | `new Set()` | Seleção por `aria-selected` (`selectionMode` single/multiple). |
2845
+ | `selected` | input | `ReadonlySet<string>` | `new Set()` | Marcação das caixas — só entrada: o app aplica o que `changed` emitir. |
2846
+ | `expanded` | model | `ReadonlySet<string>` | `new Set()` | |
2847
+ | `activeId` | model | `string \| null` | `null` | |
2848
+ | `loadChildren` | input | `TreeChildrenLoader \| null` | `null` | |
2849
+ | `draggable` | input | `boolean` | `false` | |
2850
+ | `canDrop` | input | `TreeCanDrop \| null` | `null` | |
2851
+ | `nodeActions` | input | `TreeNodeActions` | `[]` | |
2852
+ | `changed` | output | `readonly TreeSelectionChange[]` | | |
2853
+ | `activated` | output | `TreeNode` | | |
2854
+ | `moved` | output | `TreeMoveEvent` | | |
2855
+ | `nodeAction` | output | `TreeNodeActionEvent` | | |
2711
2856
 
2712
2857
  ## `ng-template[hmTreeNode]`
2713
2858
 
2714
2859
  `TreeNodeTemplateDirective` — import de `@trismegisto/angular/tree` (também na raiz)
2715
2860
 
2716
- Conteúdo customizado do nó (no lugar de ícone + rótulo).
2861
+ Conteúdo próprio do nó (no lugar de ícone + rótulo): `<ng-template hmTreeNode let-node let-active="active">`.
2717
2862
 
2718
2863
  _Sem inputs/outputs._
2719
2864
 
@@ -2735,7 +2880,6 @@ Métodos públicos: `isActive(step: object): boolean`
2735
2880
  | `size` | input | `ModalSize` | `'large'` | Largura do modal (só no modo `modal`): `small`, `medium`, `large` (padrão), `xlarge` ou `full` (tela cheia, bom para assistente longo no celular). Repassada ao… |
2736
2881
  | `selectedIndex` | model | `number` | `0` | Two-way: índice da etapa aberta. |
2737
2882
  | `linear` | input | `boolean` | `true` | Avançar valida a etapa aberta e os rótulos não pulam etapas. Padrão ligado. |
2738
- | `orientation` | input | `StepperOrientation` | `'horizontal'` | |
2739
2883
  | `loading` | input | `boolean` | `false` | Salvando: o Concluir carrega, os demais botões e o X travam. |
2740
2884
  | `confirmCancel` | input | `boolean \| Partial<HermesConfirmOptions>` | `false` | Pergunta antes de cancelar. `true` usa os textos do catálogo; um objeto troca os que vierem (`heading`, `message`, `confirmLabel`, `cancelLabel`, `danger`). |
2741
2885
  | `level` | input | `number` | `3` | Nível do título de cada etapa (`aria-level`): 3 cabe sob o título do modal (`h2`). |