@acropole/skills 1.7.0 → 1.7.1

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 3.1.0, a cada `npm run sync` do @acropole/skills.
4
- > Gerado do código-fonte do `@trismegisto/angular` 3.1.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 3.3.11, a cada `npm run sync` do @acropole/skills.
4
+ > Gerado do código-fonte do `@trismegisto/angular` 3.3.11. Confira a versão instalada no `package.json` do pacote em `node_modules`.
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>`).
@@ -9,6 +9,77 @@ Slots são os seletores de `<ng-content>`: projete com o atributo (ex.: `<div fo
9
9
  "Templates no conteúdo" = `<ng-template #nome>` que a peça procura dentro dela; "Métodos públicos" = chamáveis por `viewChild(Classe)` ou `#ref`.
10
10
  Membros "herdados" vêm da classe base (ex.: `HermesFormFieldBase` dá `disabled`/`required`/`error`/`messages` a todo controle de formulário).
11
11
 
12
+ ## `hm-access-policy-editor`
13
+
14
+ `AccessPolicyEditorComponent` — import de `@trismegisto/angular/access-control` (também na raiz)
15
+
16
+ Editor de política de acesso: uma lista de regras "quem · permissão · permitir/bloquear", com adicionar e remover e o aviso de regra repetida, conflitante ou incompleta.
17
+
18
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
19
+ |---|---|---|---|---|
20
+ | `rules` | model | `readonly AccessRule[]` | `[]` | |
21
+ | `subjects` | input (obrigatório) | `readonly PeopleEntity[]` | | Quem pode aparecer numa regra (pessoas, equipes, grupos, papéis). |
22
+ | `permissions` | input (obrigatório) | `readonly PermissionDefinition[]` | | |
23
+ | `readonly` | input | `boolean` | `false` | |
24
+ | `defaultEffect` | input | `AccessEffect` | `'allow'` | Efeito da regra nova. |
25
+ | `label` | input | `string` | `''` | Nome da lista de regras. Vazio = "Política de acesso". |
26
+ | `texts` | input | `Partial<AccessControlMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
27
+
28
+ ## `hm-access-request`
29
+
30
+ `AccessRequestComponent` — import de `@trismegisto/angular/access-control` (também na raiz)
31
+
32
+ Pedido de acesso, do lado de quem pede: escolher o papel, explicar o motivo e enviar; depois, a situação do pedido (aguardando, aprovado, recusado).
33
+
34
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
35
+ |---|---|---|---|---|
36
+ | `roles` | input (obrigatório) | `readonly PeopleRole[]` | | Papéis que se pode pedir (o primeiro vem escolhido). |
37
+ | `status` | input | `AccessRequestStatus` | `'idle'` | |
38
+ | `reasonRequired` | input | `boolean` | `false` | |
39
+ | `loading` | input | `boolean` | `false` | |
40
+ | `submitLabel` | input | `string` | `''` | Texto do botão. Vazio = "Pedir acesso". |
41
+ | `statusNote` | input | `string` | `''` | Frase extra na situação (ex.: o motivo da recusa, vindo de quem decidiu). |
42
+ | `requested` | output | `AccessRequestPayload` | | |
43
+ | `texts` | input | `Partial<AccessControlMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
44
+
45
+ ## `hm-access-request-review`
46
+
47
+ `AccessRequestReviewComponent` — import de `@trismegisto/angular/access-control` (também na raiz)
48
+
49
+ Pedido de acesso, do lado de quem aprova: quem pediu, o papel, o motivo e as ações aprovar/recusar — recusar abre o campo do motivo da recusa antes de confirmar.
50
+
51
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
52
+ |---|---|---|---|---|
53
+ | `requester` | input (obrigatório) | `string` | | |
54
+ | `email` | input | `string` | `''` | |
55
+ | `imageUrl` | input | `string \| null \| undefined` | `null` | |
56
+ | `requestedRole` | input (obrigatório) | `string` | | Nome do papel pedido. |
57
+ | `reason` | input | `string` | `''` | |
58
+ | `requestedAt` | input | `Date \| number \| string \| null` | `null` | Quando foi pedido (o que `new Date()` aceita). |
59
+ | `decision` | input | `'pending' \| 'approved' \| 'denied'` | `'pending'` | Situação depois de decidido. `pending` = mostra as ações. |
60
+ | `denyReasonRequired` | input | `boolean` | `false` | |
61
+ | `loading` | input | `boolean` | `false` | |
62
+ | `approve` | output | `void` | | |
63
+ | `deny` | output | `string` | | Recusa confirmada, com o motivo (pode ser vazio). |
64
+ | `texts` | input | `Partial<AccessControlMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
65
+
66
+ ## `hm-access-summary`
67
+
68
+ `AccessSummaryComponent` — import de `@trismegisto/angular/access-control` (também na raiz)
69
+
70
+ Resumo de quem tem acesso a um recurso: alcance (privado, restrito, organização, público), quantas pessoas, os primeiros rostos, a contagem por papel e convites pendentes — com o atalho "Gerenciar acesso".
71
+
72
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
73
+ |---|---|---|---|---|
74
+ | `visibility` | input | `AccessVisibility` | `'private'` | |
75
+ | `members` | input | `readonly PeopleMember[]` | `[]` | Quem tem acesso (os primeiros, quando `total` vem do servidor). |
76
+ | `roles` | input | `readonly PeopleRole[]` | `[]` | Papéis, para a contagem por papel. |
77
+ | `total` | input | `number \| null` | `null` | Total de pessoas com acesso; `null` = o tamanho de `members`. |
78
+ | `maxAvatars` | input | `number` | `5` | |
79
+ | `manageable` | input | `boolean` | `false` | Mostra o botão "Gerenciar acesso" (`manage`). |
80
+ | `manage` | output | `void` | | |
81
+ | `texts` | input | `Partial<AccessControlMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
82
+
12
83
  ## `ng-template[hmAccordionContent]`
13
84
 
14
85
  `AccordionContentDirective` — import de `@trismegisto/angular/accordion` (também na raiz)
@@ -60,6 +131,520 @@ Círculo que identifica uma pessoa ao lado do nome dela (menu da conta, autor de
60
131
  | `imageUrl` | input | `string \| null \| undefined` | `null` | Endereço da foto (opcional). Se não carregar, ficam as iniciais. |
61
132
  | `size` | input | `AccountAvatarSize \| null` | `null` | Diâmetro na escala do sistema. Sem valor, segue o `--hm-avatar-size` herdado. |
62
133
  | `loading` | input | `boolean` | `false` | Os dados da pessoa ainda não chegaram: mostra o placeholder de carregamento. |
134
+ | `presence` | input | `PresenceStatus \| null \| undefined` | `null` | Situação de presença (ponto no canto + texto oculto). `null` (padrão) = sem ponto. |
135
+ | `texts` | input | `Partial<PresenceMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
136
+
137
+ ## `hm-account-closure`
138
+
139
+ `AccountClosureComponent` — import de `@trismegisto/angular/account-closure` (também na raiz)
140
+
141
+ Desativação ou exclusão de conta com confirmação forte: o que acontece (lista vinda do app), a frase a digitar (`confirmationPhrase`, ex. o e-mail da conta), senha opcional, motivo opcional e o botão destrutivo.
142
+
143
+ Slots: `(padrão)`
144
+
145
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
146
+ |---|---|---|---|---|
147
+ | `mode` | input | `AccountClosureMode` | `'deactivate'` | |
148
+ | `confirmationPhrase` | input (obrigatório) | `string` | | Frase que a pessoa digita para confirmar (o e-mail da conta, o nome do espaço). |
149
+ | `consequences` | input | `readonly string[]` | `[]` | O que acontece com a conta (textos do app). |
150
+ | `requirePassword` | input | `boolean` | `false` | |
151
+ | `passwordLabel` | input | `string` | `''` | Rótulo do campo de senha. Vazio = "Senha". |
152
+ | `askReason` | input | `boolean` | `false` | |
153
+ | `offerExport` | input | `boolean` | `false` | Botão "Baixar meus dados" (`exportData`). |
154
+ | `headingLevel` | input | `AccountClosureHeadingLevel` | `2` | |
155
+ | `loading` | input | `boolean` | `false` | |
156
+ | `error` | input | `string` | `''` | |
157
+ | `texts` | input | `Partial<AccountClosureMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
158
+ | `confirmed` | output | `AccountClosurePayload` | | |
159
+ | `exportData` | output | `void` | | |
160
+
161
+ ## `hm-forgot-password-form`
162
+
163
+ `ForgotPasswordFormComponent` — import de `@trismegisto/angular/account-forms` (também na raiz)
164
+
165
+ "Esqueci a senha": pede o e-mail e, depois do envio, confirma sem revelar se a conta existe ("Se houver uma conta para…"), com reenvio após a contagem e "Usar outro e-mail".
166
+
167
+ _Sem inputs/outputs._
168
+
169
+ ## `hm-magic-link-form`
170
+
171
+ `MagicLinkFormComponent` — import de `@trismegisto/angular/account-forms` (também na raiz)
172
+
173
+ Link mágico: entrar sem senha, recebendo um link por e-mail. Mesmo fluxo do "esqueci a senha": e-mail → confirmação → reenvio com contagem.
174
+
175
+ _Sem inputs/outputs._
176
+
177
+ ## `hm-email-verification`
178
+
179
+ `EmailVerificationComponent` — import de `@trismegisto/angular/account-forms` (também na raiz)
180
+
181
+ Verificação de e-mail por código: "Enviamos um código de 6 dígitos para a•••a@exemplo.com", as caixas do `hm-code-input`, verificar, reenviar (com contagem) e trocar o e-mail.
182
+
183
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
184
+ |---|---|---|---|---|
185
+ | `email` | input (obrigatório) | `string` | | Para onde o código foi (aparece mascarado). |
186
+ | `length` | input | `number` | `6` | |
187
+ | `autoSubmit` | input | `boolean` | `true` | Verifica sozinho quando o último dígito entra. |
188
+ | `resendAvailableAt` | input | `Date \| number \| null` | `null` | |
189
+ | `loading` | input | `boolean` | `false` | |
190
+ | `error` | input | `string` | `''` | Erro vindo do servidor (código incorreto ou expirado). |
191
+ | `texts` | input | `Partial<AccountFormsMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
192
+ | `verify` | output | `string` | | Código completo para verificar. |
193
+ | `resend` | output | `void` | | |
194
+ | `changeEmail` | output | `void` | | |
195
+
196
+ ## `hm-new-password-form`
197
+
198
+ `NewPasswordFormComponent` — import de `@trismegisto/angular/account-forms` (também na raiz)
199
+
200
+ Nova senha: redefinir (vindo do link do "esqueci a senha") ou trocar (na área da conta). Nova senha com medidor de força, confirmação e, em `change`, a senha atual.
201
+
202
+ Slots: `(padrão)`
203
+
204
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
205
+ |---|---|---|---|---|
206
+ | `mode` | input | `NewPasswordMode` | `'reset'` | |
207
+ | `policy` | input | `PasswordPolicy` | `{}` | |
208
+ | `username` | input | `string` | `''` | Conta da senha (campo oculto para o gerenciador de senhas associar a senha nova). |
209
+ | `offerSignOutOthers` | input | `boolean` | `false` | |
210
+ | `loading` | input | `boolean` | `false` | |
211
+ | `error` | input | `string` | `''` | |
212
+ | `submitLabel` | input | `string` | `''` | |
213
+ | `texts` | input | `Partial<AccountFormsMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
214
+ | `submitted` | output | `NewPasswordPayload` | | |
215
+
216
+ ## `hm-passkey-button`
217
+
218
+ `PasskeyButtonComponent` — import de `@trismegisto/angular/account-forms` (também na raiz)
219
+
220
+ Botão de chave de acesso (passkey / WebAuthn). A lib não chama `navigator.credentials`: o botão emite `activate`, o app faz a cerimônia e devolve a situação por `state`.
221
+
222
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
223
+ |---|---|---|---|---|
224
+ | `mode` | input | `PasskeyMode` | `'sign-in'` | |
225
+ | `state` | input | `PasskeyState` | `'idle'` | |
226
+ | `detectSupport` | input | `boolean` | `true` | |
227
+ | `emphasis` | input | `'high' \| 'medium'` | `'medium'` | |
228
+ | `label` | input | `string` | `''` | Texto do botão. Vazio = do catálogo, conforme `mode`. |
229
+ | `texts` | input | `Partial<AccountFormsMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
230
+ | `activate` | output | `void` | | |
231
+
232
+ ## `hm-social-sign-in`
233
+
234
+ `SocialSignInComponent` — import de `@trismegisto/angular/account-forms` (também na raiz)
235
+
236
+ Botões de login por outro serviço ("Continuar com …"), genéricos: o app passa os provedores.
237
+
238
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
239
+ |---|---|---|---|---|
240
+ | `providers` | input (obrigatório) | `readonly SocialSignInProvider[]` | | |
241
+ | `layout` | input | `SocialSignInLayout` | `'stack'` | |
242
+ | `divider` | input | `boolean` | `false` | Separador "ou" depois dos botões. |
243
+ | `loadingProvider` | input | `string \| null` | `null` | Id do provedor em andamento. |
244
+ | `texts` | input | `Partial<AccountFormsMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
245
+ | `selected` | output | `string` | | |
246
+
247
+ ## `hm-sign-up-form`
248
+
249
+ `SignUpFormComponent` — import de `@trismegisto/angular/account-forms` (também na raiz)
250
+
251
+ Formulário de cadastro: nome, e-mail, senha com medidor de força e aceite dos termos. Encaixa no padrão de página de login (`.hm-login`, dentro do `.hm-login__panel`): título, marca e rodapé continuam do app.
252
+
253
+ Slots: `[hmSignUpTerms]`, `(padrão)`
254
+
255
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
256
+ |---|---|---|---|---|
257
+ | `policy` | input | `PasswordPolicy` | `{}` | Política de senha (requisitos e medidor). |
258
+ | `askName` | input | `boolean` | `true` | Pede o nome. |
259
+ | `requireTerms` | input | `boolean` | `true` | Exige o aceite dos termos. |
260
+ | `termsLabel` | input | `string` | `''` | Rótulo da caixa dos termos. Vazio = texto do catálogo. Links: slot `[hmSignUpTerms]`. |
261
+ | `submitLabel` | input | `string` | `''` | |
262
+ | `loading` | input | `boolean` | `false` | |
263
+ | `error` | input | `string` | `''` | Erro vindo do servidor, mostrado no alto. |
264
+ | `texts` | input | `Partial<AccountFormsMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
265
+ | `submitted` | output | `SignUpPayload` | | |
266
+
267
+ ## `hm-account-switcher`
268
+
269
+ `AccountSwitcherComponent` — import de `@trismegisto/angular/account-switcher` (também na raiz)
270
+
271
+ Troca de conta: a conta atual em destaque (com "Gerenciar conta"), as outras contas guardadas como botões "Entrar como…", "Adicionar outra conta" e "Sair de todas as contas". Cabe num `hm-popover` aberto pelo avatar do cabeçalho, ou numa página.
272
+
273
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
274
+ |---|---|---|---|---|
275
+ | `accounts` | input (obrigatório) | `readonly AccountEntry[]` | | |
276
+ | `currentId` | input | `string \| null` | `null` | Id da conta em uso. |
277
+ | `allowAdd` | input | `boolean` | `true` | Botão "Adicionar outra conta". |
278
+ | `manageable` | input | `boolean` | `true` | Botão "Gerenciar conta" na conta atual. |
279
+ | `texts` | input | `Partial<AccountSwitcherMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
280
+ | `switchTo` | output | `AccountEntry` | | |
281
+ | `add` | output | `void` | | |
282
+ | `manage` | output | `AccountEntry` | | |
283
+ | `signOutAll` | output | `void` | | Sair (de todas, ou da única conta). |
284
+
285
+ ## `hm-address-card`
286
+
287
+ `AddressCardComponent` — import de `@trismegisto/angular/address` (também na raiz)
288
+
289
+ Endereço em cartão (`hm-address-card`): apelido ("Casa", "Trabalho"), selo de principal, as linhas do endereço num `<address>` (as mesmas do `hm-address-view`, por `formatAddressLines`), o telefone e, se quiser, os botões de editar e remover.
290
+
291
+ Slots: `[heading]`, `(padrão)`
292
+
293
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
294
+ |---|---|---|---|---|
295
+ | `address` | input (obrigatório) | `PostalAddress` | | |
296
+ | `label` | input | `string` | `''` | Apelido do endereço ("Casa"). |
297
+ | `icon` | input | `string` | `''` | Ícone ao lado do apelido. |
298
+ | `isDefault` | input | `boolean` | `false` | |
299
+ | `actions` | input | `boolean` | `false` | Mostra editar e remover. |
300
+ | `showCountry` | input | `boolean` | `false` | Inclui o país na última linha. |
301
+ | `countryName` | input | `string` | `''` | Nome do país, já traduzido, para a linha de país (sem ele, sai o `country` do endereço). |
302
+ | `plain` | input | `boolean` | `false` | Sem borda nem fundo (dentro de outro cartão ou de uma opção de rádio). |
303
+ | `edit` | output | `void` | | |
304
+ | `remove` | output | `void` | | |
305
+ | `texts` | input | `Partial<AddressMessages> \| null` | `null` | Sobrescrita parcial dos textos (`ADDRESS_MESSAGES_PT_BR`). |
306
+
307
+ ## `hm-address-field`
308
+
309
+ `AddressFieldComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/address` (também na raiz)
310
+
311
+ Endereço postal para digitar (`hm-address-field`) — de entrega, de cobrança ou de cadastro: os campos na ordem do país (`addressFieldOrder`), o código postal com a máscara dele (`postalCodeMask`), `autocomplete` certo em cada campo (o navegador preenche o endereço salvo da pessoa) e obrigatórios configuráveis (`requiredFields`). É um campo de formulário: funciona com Reactive Forms, `[(ngModel)]`…
312
+
313
+ Métodos públicos: `lines(countryName = ''): string[]`
314
+
315
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
316
+ |---|---|---|---|---|
317
+ | `value` | model | `PostalAddress` | `{}` | |
318
+ | `country` | input | `string` | `''` | País fixo (ISO alfa-2). Vazio: o do valor, ou escolhido em `countries`. |
319
+ | `countries` | input | `readonly AddressOption[] \| null` | `null` | Países para escolher (`code` ISO alfa-2). Ignorado com `country` fixo. |
320
+ | `states` | input | `readonly AddressOption[] \| null` | `null` | Estados para escolher (`code` = sigla guardada no valor). Sem lista: texto livre. |
321
+ | `cities` | input | `readonly AddressOption[] \| null` | `null` | Cidades para escolher (guarda o `name`). Sem lista: texto livre. |
322
+ | `statesLoading` | input | `boolean` | `false` | |
323
+ | `citiesLoading` | input | `boolean` | `false` | |
324
+ | `showRecipient` | input | `boolean` | `false` | Mostra o campo de destinatário (o primeiro). |
325
+ | `showPhone` | input | `boolean` | `false` | Mostra o campo de telefone (o último). |
326
+ | `requiredFields` | input | `readonly AddressField[]` | `ADDRESS_REQUIRED_FIELDS` | Campos obrigatórios (os escondidos não contam). Padrão: `ADDRESS_REQUIRED_FIELDS`. |
327
+ | `hiddenFields` | input | `readonly AddressField[]` | `[]` | Campos que não aparecem (ex.: `['complement']`). |
328
+ | `showErrors` | input | `boolean` | `false` | Mostra os erros de todos os campos (ex.: depois de tentar enviar). |
329
+ | `lookingUp` | input | `boolean` | `false` | O app está buscando o endereço pelo código postal. |
330
+ | `section` | input | `'' \| 'shipping' \| 'billing'` | `''` | Seção do `autocomplete` (`shipping` / `billing`), para o navegador não misturar dois endereços. |
331
+ | `legend` | input | `string` | `''` | Legenda do fieldset. Padrão: "Endereço". |
332
+ | `legendHidden` | input | `boolean` | `false` | Esconde a legenda (fica só para leitor de tela), quando o título já está em volta. |
333
+ | `texts` | input | `Partial<AddressMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
334
+ | `postalCodeComplete` | output | `string` | | Código postal completo e válido (valor cru): o app busca o endereço e devolve por `[(value)]`. |
335
+ | `countryChange` | output | `string` | | País escolhido na lista (`code`). |
336
+ | `regionChange` | output | `string` | | Estado escolhido (`code`): o app carrega as cidades. |
337
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
338
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
339
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
340
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
341
+
342
+ ## `hm-address-picker`
343
+
344
+ `AddressPickerComponent` — import de `@trismegisto/angular/address` (também na raiz)
345
+
346
+ Escolha entre endereços salvos (`hm-address-picker`): cada endereço é uma opção de rádio em cartão, com as linhas de `formatAddressLines` (as mesmas do `hm-address-view`), e o botão "Adicionar endereço" no fim.
347
+
348
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
349
+ |---|---|---|---|---|
350
+ | `addresses` | input | `readonly SavedAddress[]` | `[]` | |
351
+ | `value` | model | `string` | `''` | Id do endereço escolhido. |
352
+ | `label` | input | `string` | `''` | Legenda do grupo. Vazio = "Endereço de entrega". |
353
+ | `legendHidden` | input | `boolean` | `false` | |
354
+ | `allowAdd` | input | `boolean` | `true` | Mostra "Adicionar endereço". |
355
+ | `add` | output | `void` | | |
356
+ | `texts` | input | `Partial<AddressMessages> \| null` | `null` | Sobrescrita parcial dos textos (`ADDRESS_MESSAGES_PT_BR`). |
357
+
358
+ ## `hm-address-view`
359
+
360
+ `AddressViewComponent` — import de `@trismegisto/angular/address` (também na raiz)
361
+
362
+ Endereço para ler (`hm-address-view`): as linhas na convenção do país (`formatAddressLines` — no Brasil "Rua, número – complemento", bairro, "Cidade – UF", CEP formatado) dentro de um `<address>`, uma por linha, só texto. O destinatário (quando houver) é a 1ª linha; `countryName` (já traduzido pelo app) entra como a última. Com apelido, selo de principal ou ações, use o `hm-address-card`, que mon…
363
+
364
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
365
+ |---|---|---|---|---|
366
+ | `address` | input (obrigatório) | `PostalAddress` | | |
367
+ | `countryName` | input | `string` | `''` | Nome do país, já traduzido, como última linha. Vazio: sem linha de país. |
368
+ | `showRecipient` | input | `boolean` | `true` | Destinatário como primeira linha. |
369
+ | `plain` | input | `boolean` | `false` | `<p>` em vez de `<address>`. |
370
+
371
+ ## `hm-agent-terminal`
372
+
373
+ `AgentTerminalComponent` — import de `@trismegisto/angular/agent` (também na raiz)
374
+
375
+ Um comando que o agente rodou e o que ele imprimiu.
376
+
377
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
378
+ |---|---|---|---|---|
379
+ | `command` | input | `string` | `''` | |
380
+ | `output` | input | `string` | `''` | |
381
+ | `running` | input | `boolean` | `false` | O comando ainda está rodando. |
382
+ | `exitCode` | input | `number \| null` | `null` | Código de saída, quando terminou. |
383
+ | `label` | input | `string` | `''` | |
384
+ | `texts` | input | `AgentTexts` | `{}` | |
385
+
386
+ ## `hm-checkpoint`
387
+
388
+ `CheckpointComponent` — import de `@trismegisto/angular/agent` (também na raiz)
389
+
390
+ Marca um ponto da conversa para onde dá para voltar. Quem restaura de fato é o app, ao receber `restore`.
391
+
392
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
393
+ |---|---|---|---|---|
394
+ | `label` | input | `string` | `''` | |
395
+ | `texts` | input | `AgentTexts` | `{}` | |
396
+ | `restore` | output | `void` | | |
397
+
398
+ ## `hm-file-tree`
399
+
400
+ `FileTreeComponent` — import de `@trismegisto/angular/agent` (também na raiz)
401
+
402
+ Os arquivos que um agente tocou, em árvore (`hm-tree`), com o que mudou em cada um.
403
+
404
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
405
+ |---|---|---|---|---|
406
+ | `files` | input | `readonly AgentFile[]` | `[]` | |
407
+ | `label` | input | `string` | `''` | |
408
+ | `expanded` | model | `ReadonlySet<string>` | `new Set()` | |
409
+ | `texts` | input | `AgentTexts` | `{}` | |
410
+
411
+ ## `hm-model-selector`
412
+
413
+ `ModelSelectorComponent` — import de `@trismegisto/angular/agent` (também na raiz)
414
+
415
+ Escolhe o modelo que responde. A lista vem do app, que sabe quais a pessoa pode usar.
416
+
417
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
418
+ |---|---|---|---|---|
419
+ | `models` | input | `readonly AgentModel[]` | `[]` | |
420
+ | `value` | model | `string` | `''` | |
421
+ | `label` | input | `string` | `''` | |
422
+ | `labelHidden` | input | `boolean` | `false` | |
423
+ | `texts` | input | `AgentTexts` | `{}` | |
424
+
425
+ ## `hm-stack-trace`
426
+
427
+ `StackTraceComponent` — import de `@trismegisto/angular/agent` (também na raiz)
428
+
429
+ Um erro com a pilha de chamadas recolhida.
430
+
431
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
432
+ |---|---|---|---|---|
433
+ | `name` | input (obrigatório) | `string` | | |
434
+ | `message` | input | `string` | `''` | |
435
+ | `frames` | input | `readonly AgentStackFrame[]` | `[]` | |
436
+ | `texts` | input | `AgentTexts` | `{}` | |
437
+
438
+ ## `hm-test-results`
439
+
440
+ `TestResultsComponent` — import de `@trismegisto/angular/agent` (também na raiz)
441
+
442
+ O resultado de uma rodada de testes: o resumo e cada teste, com a falha para abrir.
443
+
444
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
445
+ |---|---|---|---|---|
446
+ | `tests` | input | `readonly AgentTest[]` | `[]` | |
447
+ | `texts` | input | `AgentTexts` | `{}` | |
448
+
449
+ ## `hm-agent-sources`
450
+
451
+ `AgentSourcesComponent` — import de `@trismegisto/angular/agent` (também na raiz)
452
+
453
+ As fontes que um agente usou numa resposta. Fica recolhida para não competir com a resposta.
454
+
455
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
456
+ |---|---|---|---|---|
457
+ | `sources` | input | `readonly AgentSource[]` | `[]` | |
458
+ | `texts` | input | `AgentTexts` | `{}` | |
459
+
460
+ ## `hm-inline-citation`
461
+
462
+ `InlineCitationComponent` — import de `@trismegisto/angular/agent` (também na raiz)
463
+
464
+ Referência a uma fonte no meio de uma frase: um número que abre os dados dela.
465
+
466
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
467
+ |---|---|---|---|---|
468
+ | `index` | input (obrigatório) | `number` | | |
469
+ | `source` | input (obrigatório) | `AgentSource` | | |
470
+ | `texts` | input | `AgentTexts` | `{}` | |
471
+
472
+ ## `hm-agent-plan`
473
+
474
+ `AgentPlanComponent` — import de `@trismegisto/angular/agent` (também na raiz)
475
+
476
+ Os passos que um agente pretende seguir e até onde chegou.
477
+
478
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
479
+ |---|---|---|---|---|
480
+ | `heading` | input (obrigatório) | `string` | | |
481
+ | `description` | input | `string` | `''` | O que o plano resolve, acima das etapas. |
482
+ | `steps` | input | `readonly AgentStep[]` | `[]` | |
483
+ | `texts` | input | `AgentTexts` | `{}` | |
484
+
485
+ ## `hm-agent-queue`
486
+
487
+ `AgentQueueComponent` — import de `@trismegisto/angular/agent` (também na raiz)
488
+
489
+ A lista de pendências de um agente, separada entre o que falta e o que já terminou.
490
+
491
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
492
+ |---|---|---|---|---|
493
+ | `items` | input | `readonly AgentQueueItem[]` | `[]` | |
494
+ | `texts` | input | `AgentTexts` | `{}` | |
495
+
496
+ ## `hm-agent-task`
497
+
498
+ `AgentTaskComponent` — import de `@trismegisto/angular/agent` (também na raiz)
499
+
500
+ Uma tarefa de um agente, com os passos conforme ele os executa.
501
+
502
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
503
+ |---|---|---|---|---|
504
+ | `heading` | input (obrigatório) | `string` | | |
505
+ | `steps` | input | `readonly AgentStep[]` | `[]` | |
506
+ | `expanded` | input | `boolean` | `false` | |
507
+ | `texts` | input | `AgentTexts` | `{}` | |
508
+
509
+ ## `hm-chain-of-thought`
510
+
511
+ `ChainOfThoughtComponent` — import de `@trismegisto/angular/agent` (também na raiz)
512
+
513
+ Um resumo que abre os passos do raciocínio. Os passos são `hm-trace-item` projetados.
514
+
515
+ Slots: `(padrão)`
516
+
517
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
518
+ |---|---|---|---|---|
519
+ | `summary` | input (obrigatório) | `string` | | |
520
+ | `expanded` | input | `boolean` | `false` | Começa aberto (os passos à vista). |
521
+ | `texts` | input | `AgentTexts` | `{}` | |
522
+
523
+ ## `hm-context-usage`
524
+
525
+ `ContextUsageComponent` — import de `@trismegisto/angular/agent` (também na raiz)
526
+
527
+ Quanto do contexto do modelo a conversa já usou. Avisa em cor quando está perto do limite.
528
+
529
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
530
+ |---|---|---|---|---|
531
+ | `used` | input | `number` | `0` | |
532
+ | `limit` | input | `number` | `0` | |
533
+ | `texts` | input | `AgentTexts` | `{}` | |
534
+
535
+ ## `hm-reasoning`
536
+
537
+ `ReasoningComponent` — import de `@trismegisto/angular/agent` (também na raiz)
538
+
539
+ O raciocínio de um agente enquanto ele pensa: aberto durante o streaming, recolhido ao terminar.
540
+
541
+ Slots: `(padrão)`
542
+
543
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
544
+ |---|---|---|---|---|
545
+ | `streaming` | input | `boolean` | `false` | O agente ainda está pensando. |
546
+ | `seconds` | input | `number \| null` | `null` | Quanto tempo levou, quando o app souber. |
547
+ | `texts` | input | `AgentTexts` | `{}` | |
548
+
549
+ ## `hm-subagent`
550
+
551
+ `SubagentComponent` — import de `@trismegisto/angular/agent` (também na raiz)
552
+
553
+ O trabalho de um agente auxiliar: título, estado e o que ele fez (`hm-trace-item` ou resultado projetados).
554
+
555
+ Slots: `(padrão)`
556
+
557
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
558
+ |---|---|---|---|---|
559
+ | `heading` | input (obrigatório) | `string` | | |
560
+ | `detail` | input | `string` | `''` | O que o auxiliar faz, ou a duração. |
561
+ | `status` | input | `TraceStatus` | `'running'` | |
562
+ | `task` | input | `string` | `''` | O pedido que o auxiliar recebeu, no alto do conteúdo. |
563
+ | `model` | input | `string` | `''` | O modelo que ele usa. |
564
+ | `tools` | input | `readonly string[]` | `[]` | As ferramentas que ele pode chamar. |
565
+ | `texts` | input | `AgentTexts` | `{}` | |
566
+
567
+ ## `hm-agent-search-results`
568
+
569
+ `AgentSearchResultsComponent` — import de `@trismegisto/angular/agent` (também na raiz)
570
+
571
+ O endereço de cada resultado de uma busca, como etiqueta que abre a página. Vai dentro de uma etapa.
572
+
573
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
574
+ |---|---|---|---|---|
575
+ | `sources` | input | `readonly AgentSource[]` | `[]` | |
576
+ | `label` | input | `string` | `''` | Nome acessível da lista. Padrão: "Resultados da busca". |
577
+ | `texts` | input | `AgentTexts` | `{}` | |
578
+
579
+ ## `hm-agent-tool`
580
+
581
+ `AgentToolComponent` — import de `@trismegisto/angular/agent` (também na raiz)
582
+
583
+ Uma ferramenta que o agente chamou (rodar um comando, ler um arquivo, consultar uma API), do pedido ao resultado. Enquanto roda é uma linha com o estado; quando há parâmetros, resultado ou erro, a linha abre e mostra cada um. Dentro de um `hm-trace` vira uma das etapas dele; sozinha, monta a própria lista.
584
+
585
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
586
+ |---|---|---|---|---|
587
+ | `heading` | input (obrigatório) | `string` | | O que a ferramenta faz, no tempo certo ("Consultando os servidores", "Consultou os servidores"). |
588
+ | `detail` | input | `string` | `''` | Texto curto ao lado (o alvo, a duração). |
589
+ | `status` | input | `TraceStatus` | `'running'` | |
590
+ | `parameters` | input | `unknown` | `undefined` | O que o agente mandou para a ferramenta. Texto vai como veio; objeto vira JSON. |
591
+ | `result` | input | `unknown` | `undefined` | O que a ferramenta devolveu. |
592
+ | `error` | input | `string` | `''` | Por que falhou (texto pronto). |
593
+ | `open` | model | `boolean` | `false` | Se o conteúdo está aberto. |
594
+ | `texts` | input | `AgentTexts` | `{}` | |
595
+
596
+ ## `hm-tool-confirmation`
597
+
598
+ `ToolConfirmationComponent` — import de `@trismegisto/angular/agent` (também na raiz)
599
+
600
+ Pede aprovação antes de um agente executar uma ação. Só apresenta e devolve a decisão: quem impede a execução sem a aprovação é o servidor, não esta peça.
601
+
602
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
603
+ |---|---|---|---|---|
604
+ | `heading` | input (obrigatório) | `string` | | |
605
+ | `description` | input | `string` | `''` | |
606
+ | `icon` | input | `string` | `'wrench'` | |
607
+ | `state` | input | `ToolConfirmationState` | `'pending'` | |
608
+ | `busy` | input | `boolean` | `false` | A decisão está sendo enviada. |
609
+ | `texts` | input | `AgentTexts` | `{}` | |
610
+ | `approved` | output | `void` | | |
611
+ | `denied` | output | `void` | | |
612
+
613
+ ## `hm-alert-history`
614
+
615
+ `AlertHistoryComponent` — import de `@trismegisto/angular/alert-history` (também na raiz)
616
+
617
+ Histórico de alertas (`hm-alert-history`): tabela com regra, severidade, estado (disparado, reconhecido, silenciado, resolvido — ícone + texto), início, duração (até `now` para os que seguem abertos), valor e serviço; filtros de estado e severidade (`[(stateFilter)]`, `[(severityFilter)]`); a regra de cada linha é um botão que seleciona o evento (`[(selected)]` com o id e `(eventSelect)` com o ev…
618
+
619
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
620
+ |---|---|---|---|---|
621
+ | `events` | input | `readonly AlertEvent[]` | `[]` | |
622
+ | `now` | input | `number \| null` | `null` | "Agora" da duração dos alertas abertos (ms). `null` = hora do cálculo. |
623
+ | `stateFilter` | model | `AlertStateFilter` | `'all'` | |
624
+ | `severityFilter` | model | `AlertSeverityFilter` | `'all'` | |
625
+ | `selected` | model | `string \| null` | `null` | Id do evento selecionado. |
626
+ | `label` | input | `string` | `''` | Nome da tabela. Vazio = catálogo. |
627
+ | `texts` | input | `Partial<AlertHistoryMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
628
+ | `eventSelect` | output | `AlertEvent` | | Evento escolhido pela pessoa. |
629
+
630
+ ## `hm-alert-rule-editor`
631
+
632
+ `AlertRuleEditorComponent` — import de `@trismegisto/angular/alert-rule-editor` (também na raiz)
633
+
634
+ Editor de regra de alerta e limiar (`hm-alert-rule-editor`): nome, métrica, agregação, condição, limiar com unidade, por quanto tempo a condição precisa valer, severidade, canais e ativa. Monta a frase de resumo ("Alerta quando a média de CPU > 80% por 5 min."), valida com `alertRuleIssues` e, com `preview`, diz se a regra dispararia sobre a série recebida (`evaluateAlertRule`).
635
+
636
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
637
+ |---|---|---|---|---|
638
+ | `value` | model (obrigatório) | `AlertRule` | | A regra em edição (two-way: muda a cada campo). Comece com `emptyAlertRule()`. |
639
+ | `metrics` | input | `readonly AlertMetricOption[]` | `[]` | |
640
+ | `channels` | input | `readonly AlertChannelOption[]` | `[]` | |
641
+ | `requireChannel` | input | `boolean` | `false` | Exige pelo menos um canal para salvar. |
642
+ | `durationOptions` | input | `readonly number[]` | `ALERT_RULE_DURATIONS` | Durações oferecidas (ms); a da regra entra se não estiver na lista. |
643
+ | `preview` | input | `readonly MetricPoint[] \| null` | `null` | Série recente da métrica para a prévia; `null` = sem prévia. |
644
+ | `label` | input | `string` | `''` | Nome do formulário. Vazio = catálogo. |
645
+ | `texts` | input | `Partial<AlertRuleEditorMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
646
+ | `save` | output | `AlertRule` | | Regra válida, pedida pelo botão de salvar. |
647
+ | `cancel` | output | `void` | | |
63
648
 
64
649
  ## `hm-alert-group`
65
650
 
@@ -101,6 +686,136 @@ Métodos públicos: `close(): void`
101
686
  | `duration` | input | `number` | `0` | Fecha sozinho depois de N ms (0 = nunca). |
102
687
  | `closed` | output | `void` | | |
103
688
 
689
+ ## `hm-anchor-nav`
690
+
691
+ `AnchorNavComponent` — import de `@trismegisto/angular/anchor-nav` (também na raiz)
692
+
693
+ Índice da página com scrollspy ("Nesta página"): os links levam a cada seção e o item da seção que está em leitura fica marcado enquanto a pessoa rola.
694
+
695
+ Métodos públicos: `scrollTo(id: string): boolean`
696
+
697
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
698
+ |---|---|---|---|---|
699
+ | `items` | input | `readonly AnchorNavItem[]` | `[]` | Seções da página, na ordem em que aparecem. |
700
+ | `label` | input | `string` | `''` | Título visível e nome da navegação. Vazio = "Nesta página" do catálogo. |
701
+ | `hideTitle` | input | `boolean` | `false` | Esconde o título da vista (continua sendo o nome da navegação). |
702
+ | `offset` | input | `number` | `0` | Altura (px) do que fica fixo no topo da área que rola. |
703
+ | `smooth` | input | `boolean` | `true` | Rolagem suave no clique (instantânea com `prefers-reduced-motion`). |
704
+ | `sticky` | input | `boolean` | `false` | Gruda o índice no topo enquanto a página rola (`position: sticky`). |
705
+ | `activeChange` | output | `string \| null` | | A seção em leitura mudou (id, ou `null` antes da primeira). |
706
+ | `texts` | input | `Partial<AnchorNavMessages>` | `{}` | Textos próprios (cada chave vence o catálogo do componente). |
707
+
708
+ ## `[hmAnnounce]`
709
+
710
+ `HermesAnnounceDirective` — import de `@trismegisto/angular/announcer` (também na raiz)
711
+
712
+ Anuncia o texto sempre que ele muda, sem código no componente: `<span [hmAnnounce]="resultCount()">{{ resultCount() }}</span>` — ou num `<ng-container>`. O primeiro valor não é anunciado (é o estado inicial da tela, lido no fluxo normal); texto vazio não anuncia.
713
+
714
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
715
+ |---|---|---|---|---|
716
+ | `hmAnnounce` | input | `string \| number \| null \| undefined` | `''` | Texto a anunciar quando mudar. |
717
+ | `hmAnnouncePoliteness` | input | `AnnouncePoliteness` | `'polite'` | `polite` (padrão) ou `assertive`. |
718
+
719
+ ## `hm-api-exchange`
720
+
721
+ `ApiExchangeComponent` — import de `@trismegisto/angular/api-exchange` (também na raiz)
722
+
723
+ Visor de uma troca HTTP (requisição e resposta) para telas de desenvolvedor — console de API, log de webhook, depurador de integração: método, URL, status com a classe ("404 Not Found", erro do cliente), duração e tamanho no topo; abas com o corpo da resposta (JSON indentado e destacado no `hm-code-viewer`), os cabeçalhos da resposta e a requisição (parâmetros de consulta, cabeçalhos e corpo). Ca…
724
+
725
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
726
+ |---|---|---|---|---|
727
+ | `request` | input (obrigatório) | `ApiRequest` | | |
728
+ | `response` | input | `ApiResponse \| null` | `null` | |
729
+ | `error` | input | `string` | `''` | Falha sem resposta (rede, tempo esgotado): o texto do erro. |
730
+ | `sensitiveHeaders` | input | `readonly string[]` | `[]` | Outros cabeçalhos a mascarar, além dos padrão. |
731
+ | `copyable` | input | `boolean` | `true` | Mostra "Copiar como cURL" (padrão). |
732
+ | `texts` | input | `Partial<ApiExchangeMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial). |
733
+
734
+ ## `hm-appointment-details`
735
+
736
+ `AppointmentDetailsComponent` — import de `@trismegisto/angular/appointment-details` (também na raiz)
737
+
738
+ Detalhes de um compromisso (reunião, consulta, reserva): título, situação, quando (data, horário, dia inteiro), repetição em texto, local ou link da reunião on-line, organizador, participantes com a resposta de cada um e a descrição. Ações (remarcar, cancelar, responder) entram por projeção em `[appointmentActions]` — o componente não decide nada, só mostra.
739
+
740
+ Slots: `[appointmentActions]`
741
+
742
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
743
+ |---|---|---|---|---|
744
+ | `appointment` | input (obrigatório) | `Appointment` | | |
745
+ | `timeZone` | input | `string \| null` | `null` | Fuso IANA de exibição (o mesmo do `hm-event-calendar`); sem ele, o do navegador. |
746
+ | `headingLevel` | input | `AppointmentHeadingLevel` | `2` | Nível do título (padrão 2). |
747
+ | `maxAttendees` | input | `number` | `8` | Participantes listados antes do "e mais N" (o resumo conta todos). |
748
+ | `texts` | input | `Partial<AppointmentMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
749
+
750
+ ## `hm-approval-badge`
751
+
752
+ `ApprovalBadgeComponent` — import de `@trismegisto/angular/approval` (também na raiz)
753
+
754
+ Selo de aprovação: "Aguardando aprovação", "Aprovado", "Rejeitado" (situação geral) ou a decisão de uma etapa ("Aguardando", "Dispensado"). Mesmo desenho do `hm-status-badge` (marca que muda de forma + texto).
755
+
756
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
757
+ |---|---|---|---|---|
758
+ | `state` | input (obrigatório) | `ApprovalState \| ApprovalDecision` | | |
759
+ | `step` | input | `boolean` | `false` | Em etapa, `pending` diz "Aguardando" em vez de "Aguardando aprovação". |
760
+ | `size` | input | `'small' \| 'medium'` | `'medium'` | |
761
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
762
+
763
+ ## `hm-approval`
764
+
765
+ `ApprovalComponent` — import de `@trismegisto/angular/approval` (também na raiz)
766
+
767
+ Pedido de aprovação em etapas: situação geral, resumo ("2 de 3 aprovações" + a regra), a linha do tempo das etapas (quem, papel, decisão, quando, comentário) e as ações de aprovar e rejeitar.
768
+
769
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
770
+ |---|---|---|---|---|
771
+ | `steps` | input (obrigatório) | `readonly ApprovalStep[]` | | |
772
+ | `rule` | input | `ApprovalRule` | `'all'` | |
773
+ | `actionable` | input | `boolean` | `false` | A pessoa logada pode decidir agora: mostra Aprovar e Rejeitar. |
774
+ | `disabled` | input | `boolean` | `false` | Ações desligadas (ex.: enquanto grava). |
775
+ | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | |
776
+ | `approve` | output | `string` | | Aprovou (comentário opcional, aparado). |
777
+ | `reject` | output | `string` | | Rejeitou (motivo obrigatório, aparado). |
778
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
779
+
780
+ ## `hm-assignee-select`
781
+
782
+ `AssigneeSelectComponent` — import de `@trismegisto/angular/assignee` (também na raiz)
783
+
784
+ Campo de responsável (ou de aprovador, revisor...): busca entre pessoas, equipes e filas, com a opção "Sem responsável" e o atalho "Atribuir a mim".
785
+
786
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
787
+ |---|---|---|---|---|
788
+ | `people` | input (obrigatório) | `readonly WorkflowAssignee[]` | | |
789
+ | `value` | model | `string \| null` | `null` | Id escolhido; `null` = sem responsável. Two-way. |
790
+ | `label` | input | `string` | `''` | Rótulo. Vazio = "Responsável". |
791
+ | `hint` | input | `string` | `''` | |
792
+ | `error` | input | `string` | `''` | |
793
+ | `allowUnassigned` | input | `boolean` | `true` | Oferece "Sem responsável" na lista. |
794
+ | `me` | input | `string` | `''` | Id da pessoa logada (atalho "Atribuir a mim"). |
795
+ | `disabled` | input | `boolean` | `false` | |
796
+ | `required` | input | `boolean` | `false` | |
797
+ | `assign` | output | `WorkflowAssignee \| null` | | Escolheu alguém (ou "Sem responsável" = `null`). |
798
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
799
+
800
+ ## `hm-assignee`
801
+
802
+ `AssigneeComponent` — import de `@trismegisto/angular/assignee` (também na raiz)
803
+
804
+ Quem responde por um item: pessoa (avatar + nome), equipe ou fila (ícone + nome) ou "Sem responsável", com o nível de escalonamento e as ações de reatribuir e escalar.
805
+
806
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
807
+ |---|---|---|---|---|
808
+ | `assignee` | input | `WorkflowAssignee \| null \| undefined` | `null` | Responsável atual; `null` = "Sem responsável". |
809
+ | `size` | input | `AccountAvatarSize` | `'small'` | |
810
+ | `showDetail` | input | `boolean` | `false` | Mostra a segunda linha (`detail`: e-mail, cargo, tamanho da fila). |
811
+ | `escalation` | input | `string` | `''` | Nível de escalonamento atual (texto). Vazio = não escalonado. |
812
+ | `reassignable` | input | `boolean` | `false` | Mostra "Reatribuir" (emite `reassign`). |
813
+ | `escalatable` | input | `boolean` | `false` | Mostra "Escalar" (emite `escalate`). |
814
+ | `maxEscalation` | input | `boolean` | `false` | Já está no último nível: "Escalar" fica desligado. |
815
+ | `reassign` | output | `void` | | |
816
+ | `escalate` | output | `void` | | |
817
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
818
+
104
819
  ## `hm-attachment-group`
105
820
 
106
821
  `AttachmentGroupComponent` — import de `@trismegisto/angular/attachment` (também na raiz)
@@ -140,9 +855,27 @@ Slots: `(padrão)`
140
855
  | `removable` | input | `boolean` | `false` | Mostra o botão de remover (emite `removed`; tirar da lista é do app). |
141
856
  | `retryable` | input | `boolean` | `false` | Em `error`, mostra o botão de tentar de novo (emite `retried`). |
142
857
  | `disabled` | input | `boolean` | `false` | |
858
+ | `scale` | input | `AttachmentScale` | `'medium'` | `small` encolhe a mídia; `tiny` fica só com ícone e nome (o tamanho e a situação seguem para leitor de tela). |
143
859
  | `removed` | output | `void` | | Pediu para remover o anexo. |
144
860
  | `retried` | output | `void` | | Pediu para tentar o envio de novo (só com `retryable`, em `error`). |
145
861
 
862
+ ## `hm-availability-editor`
863
+
864
+ `AvailabilityEditorComponent` — import de `@trismegisto/angular/availability-editor` (também na raiz)
865
+
866
+ Editor da disponibilidade semanal (horário de atendimento, expediente de uma pessoa, funcionamento de uma sala): para cada dia da semana, um interruptor "disponível" e as faixas de horário, com adicionar, remover e "copiar para os outros dias". `[(value)]` é o `WeeklyAvailability` que o `hm-slot-picker` e o `hm-resource-calendar` leem. Faixa com fim antes do início ou que cruza outra mostra o err…
867
+
868
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
869
+ |---|---|---|---|---|
870
+ | `value` | model | `WeeklyAvailability` | `{}` | Faixas por dia da semana (0 = domingo). Two-way. |
871
+ | `label` | input | `string` | `''` | Título do grupo (padrão: "Disponibilidade semanal"). |
872
+ | `weekStartsOn` | input | `Weekday \| null` | `null` | Primeiro dia da lista (0 = domingo); sem ele, o do idioma. |
873
+ | `interval` | input | `number` | `30` | Intervalo das sugestões dos campos de horário (minutos). |
874
+ | `defaultRange` | input | `AvailabilityRange` | `{ start: '09:00', end: '18:00' }` | Faixa criada ao ligar um dia ou adicionar horário. |
875
+ | `showTotal` | input | `boolean` | `true` | Mostra o total de horas por semana. |
876
+ | `disabled` | input | `boolean` | `false` | |
877
+ | `texts` | input | `Partial<AvailabilityMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
878
+
146
879
  ## `hm-avatar-group`
147
880
 
148
881
  `AvatarGroupComponent` — import de `@trismegisto/angular/avatar-group` (também na raiz)
@@ -155,6 +888,32 @@ Rostos sobrepostos de quem participa de algo (responsáveis, membros, revisores)
155
888
  | `max` | input | `number` | `3` | Quantos rostos aparecem antes do "+N". `0` = sem limite. |
156
889
  | `size` | input | `AvatarGroupSize` | `'medium'` | |
157
890
  | `label` | input | `string` | `''` | Nome da lista. Vazio usa o texto padrão do catálogo. |
891
+ | `total` | input | `number \| null` | `null` | Quantas pessoas há ao todo, quando `people` traz só as primeiras (um resumo vindo do servidor). O "+N" conta a partir dele. Omitido (ou menor que a lista) = o… |
892
+
893
+ ## `hm-backlog`
894
+
895
+ `BacklogComponent` — import de `@trismegisto/angular/backlog` (também na raiz)
896
+
897
+ Backlog e sprints: seções empilhadas (as sprints, com datas, meta e capacidade, e a fila sem data) cujos itens se reordenam e passam de uma seção para outra por ponteiro, toque e teclado (o serviço de arrastar do Hermes).
898
+
899
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
900
+ |---|---|---|---|---|
901
+ | `sections` | model | `readonly BacklogSection<T>[]` | `[]` | |
902
+ | `itemKey` | input | `(item: T) => unknown` | `(item: T) => (item as { id?: unknown })?.id ?? it…` | Identidade do item (o `track`). Padrão: `id` quando existe, senão o próprio objeto. |
903
+ | `itemLabel` | input | `((item: T) => string) \| null` | `null` | Nome falado do item nos anúncios. Padrão: `title`. |
904
+ | `priorityScale` | input | `LevelScaleInput` | `'priority'` | |
905
+ | `headingLevel` | input | `number` | `3` | |
906
+ | `disabled` | input | `boolean` | `false` | |
907
+ | `moved` | output | `BacklogMoveEvent<T>` | | |
908
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
909
+
910
+ ## `ng-template[hmBacklogItem]`
911
+
912
+ `BacklogItemDirective` — import de `@trismegisto/angular/backlog` (também na raiz)
913
+
914
+ Conteúdo de cada item do `hm-backlog` (sem ele, a linha padrão de tarefa).
915
+
916
+ _Sem inputs/outputs._
158
917
 
159
918
  ## `hm-badge`
160
919
 
@@ -170,6 +929,153 @@ Contador pequeno ao lado de um rótulo (itens novos, pendências) ou só um pont
170
929
  | `intent` | input | `BadgeIntent` | `'danger'` | |
171
930
  | `label` | input | `string` | `''` | Nome acessível. Vazio deixa o contador fora do leitor de tela. |
172
931
 
932
+ ## `hm-billing-period`
933
+
934
+ `BillingPeriodComponent` — import de `@trismegisto/angular/billing` (também na raiz)
935
+
936
+ Período de cobrança (`hm-billing-period`): as datas do ciclo atual ("15 de out. a 14 de nov."), em que dia dele estamos, quantos dias faltam e quando renova (ou termina, com `endsAtPeriodEnd`).
937
+
938
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
939
+ |---|---|---|---|---|
940
+ | `start` | input | `DateInput` | `null` | Início do período (inclusive). Com `end`, vence a âncora. |
941
+ | `end` | input | `DateInput` | `null` | Fim do período (inclusive). |
942
+ | `anchor` | input | `DateInput` | `null` | Data de início da assinatura, para calcular o período atual. |
943
+ | `interval` | input | `BillingInterval` | `'month'` | |
944
+ | `now` | input | `Date \| null` | `null` | Data de referência (padrão: hoje). |
945
+ | `showProgress` | input | `boolean` | `true` | |
946
+ | `endsAtPeriodEnd` | input | `boolean` | `false` | A assinatura termina no fim do período (cancelada): diz "Termina em" no lugar de "Renova em". |
947
+ | `label` | input | `string` | `''` | |
948
+ | `texts` | input | `CatalogOverride<BillingMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`BILLING_MESSAGES_PT_BR`). |
949
+
950
+ ## `hm-plan-picker`
951
+
952
+ `PlanPickerComponent` — import de `@trismegisto/angular/billing` (também na raiz)
953
+
954
+ Escolha de plano (`hm-plan-picker`): cada plano é uma opção de rádio em cartão com nome, descrição, preço por mês no ciclo escolhido (o anual dividido por 12, com "R$ X cobrados por ano" e a economia), selo do plano e a marca de "Plano atual".
955
+
956
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
957
+ |---|---|---|---|---|
958
+ | `plans` | input | `readonly Plan[]` | `[]` | |
959
+ | `value` | model | `string` | `''` | Id do plano escolhido. |
960
+ | `cycle` | input | `BillingCycle` | `'monthly'` | |
961
+ | `currency` | input | `string` | `'BRL'` | |
962
+ | `currentPlanId` | input | `string` | `''` | Plano que a pessoa já tem (ganha o selo "Plano atual"). |
963
+ | `label` | input | `string` | `''` | |
964
+ | `legendHidden` | input | `boolean` | `false` | |
965
+ | `texts` | input | `CatalogOverride<BillingMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`BILLING_MESSAGES_PT_BR`). |
966
+
967
+ ## `hm-pricing-table`
968
+
969
+ `PricingTableComponent` — import de `@trismegisto/angular/billing` (também na raiz)
970
+
971
+ Tabela de preços (`hm-pricing-table`): alternador mensal/anual (com a maior economia anual no rótulo), um cartão por plano com preço por mês, descrição, recursos e o botão de escolher ("Fale com vendas" no plano sob consulta, "Plano atual" desabilitado no que a pessoa já tem) e, se quiser, a tabela comparativa com todos os recursos.
972
+
973
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
974
+ |---|---|---|---|---|
975
+ | `plans` | input | `readonly Plan[]` | `[]` | |
976
+ | `cycle` | model | `BillingCycle` | `'monthly'` | |
977
+ | `currency` | input | `string` | `'BRL'` | |
978
+ | `currentPlanId` | input | `string` | `''` | |
979
+ | `cycleToggle` | input | `boolean` | `true` | Mostra o alternador de ciclo (some quando nenhum plano tem preço anual). |
980
+ | `showComparison` | input | `boolean` | `false` | |
981
+ | `headingLevel` | input | `2 \| 3 \| 4` | `3` | |
982
+ | `choose` | output | `string` | | Pediu para escolher o plano (id). |
983
+ | `contact` | output | `string` | | Pediu contato para o plano sob consulta (id). |
984
+ | `texts` | input | `CatalogOverride<BillingMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`BILLING_MESSAGES_PT_BR`). |
985
+
986
+ ## `hm-subscription-card`
987
+
988
+ `SubscriptionCardComponent` — import de `@trismegisto/angular/billing` (também na raiz)
989
+
990
+ Assinatura (`hm-subscription-card`): plano, situação, preço por ciclo, próxima cobrança, fim do teste ou do acesso, usuários, meio de cobrança e as ações que a situação pede — mudar de plano, cancelar, reativar (cancelada ou pausada) e atualizar o pagamento (pagamento pendente, com aviso).
991
+
992
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
993
+ |---|---|---|---|---|
994
+ | `subscription` | input (obrigatório) | `SubscriptionInfo` | | |
995
+ | `headingLevel` | input | `2 \| 3 \| 4` | `3` | |
996
+ | `changePlan` | output | `void` | | |
997
+ | `cancel` | output | `void` | | |
998
+ | `resume` | output | `void` | | |
999
+ | `updatePayment` | output | `void` | | |
1000
+ | `readonly` | input | `boolean` | `false` | Esconde as ações (só leitura). |
1001
+ | `texts` | input | `CatalogOverride<BillingMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`BILLING_MESSAGES_PT_BR`). |
1002
+
1003
+ ## `hm-usage-meter`
1004
+
1005
+ `UsageMeterComponent` — import de `@trismegisto/angular/billing` (também na raiz)
1006
+
1007
+ Medidor de uso de um recurso do plano (`hm-usage-meter`): quanto foi usado do limite ("7,2 GB de 10 GB"), barra com aviso perto do limite e alarme ao passar dele, quanto resta e, com `periodFraction`, a projeção para o fim do período no ritmo atual.
1008
+
1009
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1010
+ |---|---|---|---|---|
1011
+ | `label` | input (obrigatório) | `string` | | |
1012
+ | `used` | input (obrigatório) | `number` | | |
1013
+ | `limit` | input | `number \| null` | `null` | Limite do plano; `null` = ilimitado. |
1014
+ | `unit` | input | `string` | `''` | Unidade escrita depois dos números ("GB", "usuários"). |
1015
+ | `thresholds` | input | `UsageThresholds` | `{}` | |
1016
+ | `periodFraction` | input | `number \| null` | `null` | Fração do período de cobrança já corrida (0–1), para projetar o uso no fim. |
1017
+ | `compact` | input | `boolean` | `false` | |
1018
+ | `texts` | input | `CatalogOverride<BillingMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`BILLING_MESSAGES_PT_BR`). |
1019
+
1020
+ ## `hm-bottom-navigation`
1021
+
1022
+ `BottomNavigationComponent` — import de `@trismegisto/angular/bottom-navigation` (também na raiz)
1023
+
1024
+ Navegação inferior para celular: de 3 a 5 destinos principais do app, ícone sobre o rótulo, numa barra no pé da tela ao alcance do polegar.
1025
+
1026
+ Slots: `(padrão)`
1027
+
1028
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1029
+ |---|---|---|---|---|
1030
+ | `label` | input | `string` | `''` | Nome da navegação. Vazio = "Navegação principal" do catálogo. Com outra `<nav>` principal na página, dê um nome que as distinga. |
1031
+ | `fixed` | input | `boolean` | `false` | Prende a barra no pé da janela. |
1032
+ | `hideAbove` | input | `'sm' \| 'md' \| 'lg' \| null` | `null` | Esconde a barra a partir deste breakpoint (`sm`, `md`, `lg`). `null` = sempre à mostra. |
1033
+ | `texts` | input | `Partial<BottomNavigationMessages>` | `{}` | Textos próprios (cada chave vence o catálogo do componente). |
1034
+
1035
+ ## `hm-bottom-navigation-item`
1036
+
1037
+ `BottomNavigationItemComponent` — import de `@trismegisto/angular/bottom-navigation` (também na raiz)
1038
+
1039
+ Um destino da `hm-bottom-navigation`: ícone + rótulo, um link de verdade (`route` pelo roteador ou `href`). `badge` mostra um contador sobre o ícone e entra no nome do link ("Pedidos, 3 novos").
1040
+
1041
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1042
+ |---|---|---|---|---|
1043
+ | `label` | input (obrigatório) | `string` | | Rótulo visível (curto: uma palavra). |
1044
+ | `icon` | input (obrigatório) | `string` | | Ícone (nome do catálogo; o app registra). |
1045
+ | `route` | input | `string \| readonly unknown[] \| null` | `null` | Destino pelo roteador (o valor de um `routerLink`); marca `aria-current` sozinho. |
1046
+ | `href` | input | `string \| null` | `null` | Destino por URL comum. |
1047
+ | `exact` | input | `boolean` | `false` | Com `route`: só é o atual com a URL exatamente igual (use no "Início"). |
1048
+ | `current` | input | `boolean` | `false` | Com `href`: este é o destino atual. |
1049
+ | `badge` | input | `number` | `0` | Contador sobre o ícone (0 = nenhum). |
1050
+ | `texts` | input | `Partial<BottomNavigationMessages>` | `{}` | Textos próprios (cada chave vence o catálogo do componente). |
1051
+
1052
+ ## `hm-bottom-sheet`
1053
+
1054
+ `BottomSheetComponent` — import de `@trismegisto/angular/bottom-sheet` (também na raiz)
1055
+
1056
+ Folha inferior (bottom sheet) e lista de ações (action sheet) para celular: painel modal que sobe da borda de baixo, com alça para arrastar entre alturas de parada e fechar com o gesto.
1057
+
1058
+ Slots: `(padrão)`, `[footer]`
1059
+
1060
+ Métodos públicos: `close(): void`
1061
+
1062
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1063
+ |---|---|---|---|---|
1064
+ | `open` | model | `boolean` | `false` | Aberta ou fechada (`[(open)]`); o gesto, o X, o `Esc` e o fundo gravam `false`. |
1065
+ | `heading` | input (obrigatório) | `string` | | Título do cabeçalho e nome acessível do diálogo. |
1066
+ | `snapPoints` | input | `readonly number[]` | `[]` | Alturas de parada: fração da tela (`0 < n <= 1`) ou px (`n > 1`). Vazio (padrão): a altura do conteúdo, sem paradas. |
1067
+ | `snap` | model | `number` | `0` | Índice da parada atual (`[(snap)]`), da menor para a maior. Ao abrir, a folha começa nele. |
1068
+ | `actions` | input | `readonly BottomSheetAction[]` | `[]` | Ações da action sheet (lista de botões + Cancelar). Vazio: só o conteúdo projetado. |
1069
+ | `closable` | input | `boolean` | `true` | `false` tira o X/Cancelar, ignora o `Esc` e o clique no fundo e não fecha pelo gesto. |
1070
+ | `dismissible` | input | `boolean` | `true` | Puxar abaixo da menor parada fecha (com `closable`). |
1071
+ | `closeOnBackdrop` | input | `boolean` | `true` | Clique no fundo escurecido fecha (com `closable`). |
1072
+ | `closeLabel` | input | `string` | `''` | Nome do X. Vazio usa o catálogo ("Fechar"). |
1073
+ | `cancelLabel` | input | `string` | `''` | Rótulo do Cancelar da action sheet. Vazio usa o catálogo ("Cancelar"). |
1074
+ | `handleLabel` | input | `string` | `''` | Nome da alça de altura. Vazio usa o catálogo ("Ajustar altura"). |
1075
+ | `closed` | output | `void` | | A pessoa fechou (gesto, X, Cancelar, `Esc` ou fundo). |
1076
+ | `chosen` | output | `string` | | Uma ação da action sheet foi escolhida (`id`); a folha fecha em seguida. |
1077
+ | `texts` | input | `Partial<BottomSheetMessages>` | `{}` | Troca textos do catálogo da peça. |
1078
+
173
1079
  ## `hm-breadcrumb`
174
1080
 
175
1081
  `BreadcrumbComponent` — import de `@trismegisto/angular/breadcrumb` (também na raiz)
@@ -268,7 +1174,6 @@ Métodos públicos: `activateFromMenu(): void`
268
1174
  | `iconEnd` | input | `string` | `''` | Ícone decorativo depois do rótulo. |
269
1175
  | `disabled` | input | `boolean` | `false` | |
270
1176
  | `loading` | input | `boolean` | `false` | |
271
- | `busy` | input | `boolean` | `false` | Depreciado use `loading`. |
272
1177
  | `loadingState` | input | `HermesLoadingState` | `HermesLoadingState.DEFAULT` | |
273
1178
  | `loadingStateChange` | output | `HermesLoadingState` | | Pede a volta a `DEFAULT` depois de mostrar sucesso/erro (par de `[(loadingState)]`). |
274
1179
  | `block` | input | `boolean` | `false` | Ocupa a largura toda do contêiner. |
@@ -356,6 +1261,89 @@ Carrossel de slides com título, texto e imagem opcional (novidades, apresentaç
356
1261
  | `slides` | input (obrigatório) | `readonly CarouselSlide[]` | | |
357
1262
  | `interval` | input | `number` | `0` | Milissegundos entre trocas automáticas. `0` desliga. |
358
1263
 
1264
+ ## `hm-cart`
1265
+
1266
+ `CartComponent` — import de `@trismegisto/angular/cart` (também na raiz)
1267
+
1268
+ Carrinho de compras (`hm-cart`): linhas com imagem, variante, preço e quantidade, remoção, cupom, barra de frete grátis e o resumo (`hm-order-summary`) com o botão de finalizar.
1269
+
1270
+ Slots: `(padrão)`
1271
+
1272
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1273
+ |---|---|---|---|---|
1274
+ | `lines` | input | `readonly CartLine[]` | `[]` | |
1275
+ | `discounts` | input | `readonly CartDiscount[]` | `[]` | |
1276
+ | `shipping` | input | `number \| null` | `null` | |
1277
+ | `tax` | input | `number \| null` | `null` | |
1278
+ | `taxRate` | input | `number \| null` | `null` | |
1279
+ | `currency` | input | `string` | `'BRL'` | |
1280
+ | `freeShippingThreshold` | input | `number \| null` | `null` | Subtotal a partir do qual o frete é grátis (mostra a barra de progresso). `null` = sem barra. |
1281
+ | `heading` | input | `string` | `''` | |
1282
+ | `headingLevel` | input | `1 \| 2 \| 3 \| 4` | `2` | |
1283
+ | `hideHeading` | input | `boolean` | `false` | |
1284
+ | `emptyText` | input | `string` | `''` | |
1285
+ | `showCoupon` | input | `boolean` | `true` | |
1286
+ | `couponError` | input | `string` | `''` | Erro do último cupom (devolvido pelo app). |
1287
+ | `applyingCoupon` | input | `boolean` | `false` | |
1288
+ | `showCheckout` | input | `boolean` | `true` | |
1289
+ | `checkoutLabel` | input | `string` | `''` | |
1290
+ | `checkingOut` | input | `boolean` | `false` | |
1291
+ | `readonly` | input | `boolean` | `false` | Só leitura: sem quantidade editável, remoção nem cupom. |
1292
+ | `quantityChange` | output | `CartQuantityChange` | | |
1293
+ | `remove` | output | `string` | | |
1294
+ | `applyCoupon` | output | `string` | | |
1295
+ | `removeDiscount` | output | `string` | | |
1296
+ | `checkout` | output | `void` | | |
1297
+ | `texts` | input | `CatalogOverride<CartMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`CART_MESSAGES_PT_BR`). |
1298
+
1299
+ ## `hm-order-summary`
1300
+
1301
+ `OrderSummaryComponent` — import de `@trismegisto/angular/cart` (também na raiz)
1302
+
1303
+ Resumo de valores de um pedido ou carrinho (`hm-order-summary`): subtotal com a contagem de itens, cada desconto, frete ("A calcular" enquanto não houver, "Grátis" quando zero), impostos e o total.
1304
+
1305
+ Slots: `(padrão)`
1306
+
1307
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1308
+ |---|---|---|---|---|
1309
+ | `lines` | input | `readonly CartLine[]` | `[]` | |
1310
+ | `discounts` | input | `readonly CartDiscount[]` | `[]` | |
1311
+ | `shipping` | input | `number \| null` | `null` | Frete; `null` = ainda não calculado ("A calcular"). |
1312
+ | `tax` | input | `number \| null` | `null` | Imposto já calculado (valor). |
1313
+ | `taxRate` | input | `number \| null` | `null` | Alíquota em % sobre (subtotal − desconto), quando o app não manda `tax`. |
1314
+ | `currency` | input | `string` | `'BRL'` | |
1315
+ | `totals` | input | `CartTotals \| null` | `null` | Totais prontos (do servidor): vencem o cálculo local. |
1316
+ | `heading` | input | `string` | `''` | Título. Vazio = "Resumo do pedido". |
1317
+ | `headingLevel` | input | `2 \| 3 \| 4 \| 5 \| 6` | `2` | |
1318
+ | `hideHeading` | input | `boolean` | `false` | |
1319
+ | `showSavings` | input | `boolean` | `false` | Mostra "Você economiza R$ X" (descontos + preços "de" dos itens). |
1320
+ | `compact` | input | `boolean` | `false` | Espaçamento menor (lateral de checkout, gaveta). |
1321
+ | `texts` | input | `CatalogOverride<CartMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`CART_MESSAGES_PT_BR`). |
1322
+
1323
+ ## `hm-cascader`
1324
+
1325
+ `CascaderComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/cascader` (também na raiz)
1326
+
1327
+ Escolha de um item por níveis, uma coluna por nível (país → estado → cidade; categoria → subcategoria), como campo de formulário. Abrir um item mostra os filhos na coluna seguinte; escolher uma folha grava e fecha. Com `changeOnSelect`, qualquer nível pode ser o escolhido (o item é gravado ao ser aberto).
1328
+
1329
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1330
+ |---|---|---|---|---|
1331
+ | `value` | model | `readonly string[] \| null` | `null` | |
1332
+ | `nodes` | input (obrigatório) | `readonly TreeNode[]` | | |
1333
+ | `label` | input (obrigatório) | `string` | | |
1334
+ | `labelHidden` | input | `boolean` | `false` | |
1335
+ | `hint` | input | `string` | `''` | |
1336
+ | `placeholder` | input | `string` | `''` | |
1337
+ | `changeOnSelect` | input | `boolean` | `false` | Qualquer nível pode ser escolhido, não só as folhas. |
1338
+ | `searchable` | input | `boolean` | `false` | Caixa de busca no topo do cartão. |
1339
+ | `loadChildren` | input | `TreeChildrenLoader \| null` | `null` | Filhos sob demanda (mesma assinatura do `hm-tree`; uma carga por nó, sem páginas). |
1340
+ | `separator` | input | `string` | `''` | Separador do caminho no campo (padrão: catálogo, " / "). |
1341
+ | `texts` | input | `Partial<CascaderMessages>` | `{}` | Textos próprios (sobrescrevem os do catálogo da peça, por chave). |
1342
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
1343
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
1344
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
1345
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1346
+
359
1347
  ## `hm-certificate-viewer`
360
1348
 
361
1349
  `CertificateViewerComponent` — import de `@trismegisto/angular/certificate-viewer` (também na raiz)
@@ -372,6 +1360,21 @@ Visualizador de certificado X.509: o app entrega o certificado **já interpretad
372
1360
  | `warningDays` | input | | `CERTIFICATE_WARNING_DAYS` | A partir de quantos dias para o vencimento a situação vira "vence em N dias". |
373
1361
  | `referenceDate` | input | `CertificateDate \| null` | `null` | Data de referência da situação de validade (padrão: agora). |
374
1362
 
1363
+ ## `hm-change-history`
1364
+
1365
+ `ChangeHistoryComponent` — import de `@trismegisto/angular/change-history` (também na raiz)
1366
+
1367
+ Histórico de um item: mudanças de status, de campos e de responsável, criação e comentários, do mais recente para o mais antigo (ou o contrário, `order`).
1368
+
1369
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1370
+ |---|---|---|---|---|
1371
+ | `entries` | input (obrigatório) | `readonly ChangeHistoryEntry[]` | | |
1372
+ | `statuses` | input | `readonly WorkflowStatus[]` | `[]` | Status do fluxo, para os registros `status` (ids → selos). |
1373
+ | `order` | input | `'newest' \| 'oldest'` | `'newest'` | |
1374
+ | `label` | input | `string` | `''` | Nome da lista. Vazio = "Histórico". |
1375
+ | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | |
1376
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
1377
+
375
1378
  ## `hm-checkbox-group`
376
1379
 
377
1380
  `CheckboxGroupComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/checkbox-group` (também na raiz)
@@ -516,6 +1519,8 @@ Desenha UMA linha de código no elemento: tokens como `<span class="hm-code-toke
516
1519
 
517
1520
  Visualizador de código somente leitura, com realce de sintaxe por linguagem.
518
1521
 
1522
+ Slots: `[hmCodeViewerActions]`
1523
+
519
1524
  Métodos públicos: `copyAll(): Promise<boolean>`, `scrollToLine(line: number, align: 'start' \| 'center' = 'start'): void`
520
1525
 
521
1526
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
@@ -534,9 +1539,36 @@ Métodos públicos: `copyAll(): Promise<boolean>`, `scrollToLine(line: number, a
534
1539
  | `virtualize` | input | `CodeViewerVirtualize` | `'auto'` | |
535
1540
  | `virtualizeThreshold` | input | `number` | `2000` | |
536
1541
  | `revealInvisibles` | input | `boolean` | `true` | Revela espaços de largura zero e controles C0/C1. Os controles bidi aparecem sempre. |
1542
+ | `addedLines` | input | `string \| readonly number[]` | `''` | Linhas adicionadas (verde, com `+`), na numeração exibida: `"3, 5-8"` ou `[3, 5]`. |
1543
+ | `removedLines` | input | `string \| readonly number[]` | `''` | Linhas removidas (vermelho, com `-`). |
1544
+ | `size` | input | `CodeViewerSize` | `'medium'` | |
1545
+ | `variant` | input | `CodeViewerVariant` | `'default'` | |
1546
+ | `maxHeight` | input | `string` | `''` | Teto da altura (qualquer medida CSS: `20rem`, `50vh`); a área rola por dentro. |
1547
+ | `collapsedLines` | input | `number \| null` | `null` | Mostra só estas linhas e um botão para abrir o resto. `null`: tudo. |
1548
+ | `texts` | input | `Partial<CodeViewerMessages>` | `{}` | Sobrescrita parcial dos textos de diff e de mostrar mais. |
537
1549
  | `copied` | output | `string` | | Copiou pelo botão (ou `copyAll()`): o texto exato. |
538
1550
  | `tokenized` | output | `void` | | A tokenização do documento inteiro terminou. |
539
1551
 
1552
+ ## `hm-color-picker`
1553
+
1554
+ `ColorPickerComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/color-picker` (também na raiz)
1555
+
1556
+ Seletor de cor como campo: amostra que abre o seletor nativo do sistema, campo hexadecimal (`#rrggbb`, aceita `#abc` e sem `#`) e, opcional, uma paleta de amostras sugeridas. Mesma regra das linhas de cor do `hm-theme-builder` (`resolveColorInput`, em `@trismegisto/primitives`): o texto só vira valor quando é uma cor, e o erro de hexadecimal inválido só aparece ao confirmar (sair do campo ou Ente…
1557
+
1558
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1559
+ |---|---|---|---|---|
1560
+ | `label` | input (obrigatório) | `string` | | |
1561
+ | `value` | model | `string` | `''` | |
1562
+ | `hint` | input | `string` | `''` | |
1563
+ | `swatches` | input | `readonly string[]` | `[]` | Amostras sugeridas (hexadecimais; repetidas e inválidas são ignoradas). |
1564
+ | `clearable` | input | `boolean` | `false` | Botão para voltar a "sem cor". |
1565
+ | `placeholder` | input | `string` | `'#000000'` | |
1566
+ | `texts` | input | `Partial<ColorPickerMessages>` | `{}` | Textos próprios do componente, por cima do catálogo do idioma ativo (parcial). |
1567
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
1568
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
1569
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
1570
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1571
+
540
1572
  ## `hm-combobox-multi`
541
1573
 
542
1574
  `ComboboxMultiComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/combobox-multi` (também na raiz)
@@ -546,13 +1578,13 @@ Escolha de **vários** valores: fichas no campo (na ordem em que foram escolhido
546
1578
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
547
1579
  |---|---|---|---|---|
548
1580
  | `label` | input (obrigatório) | `string` | | |
1581
+ | `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
549
1582
  | `options` | input (obrigatório) | `readonly ComboboxOption[]` | | |
550
1583
  | `selected` | model | `readonly string[]` | `[]` | Itens marcados, preservando a sequência em que entraram. |
551
1584
  | `extraOptions` | input | `readonly ComboboxOption[]` | `[]` | Só dão nome a fichas de valores que saíram de `options`; não aparecem na lista. |
552
1585
  | `unknownLabel` | input | `string` | `''` | Nome da ficha de um valor que ninguém conhece; vazio = o próprio valor. |
553
1586
  | `placeholder` | input | `string` | `''` | Aparece só sem nenhuma ficha. |
554
1587
  | `hint` | input | `string` | `''` | |
555
- | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
556
1588
  | `max` | input | `number \| null` | `null` | Quantidade máxima de itens marcados (`null` libera). |
557
1589
  | `visibleChipsLimit` | input | `number \| null` | `1` | Fichas visíveis com a lista fechada; `null` = todas. |
558
1590
  | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
@@ -574,11 +1606,9 @@ Escolha de **um** valor numa lista longa, filtrando pelo que se digita (padrão
574
1606
  | `placeholder` | input | `string` | `''` | |
575
1607
  | `icon` | input | `string` | `''` | Ícone decorativo no início do campo. |
576
1608
  | `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
577
- | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
578
1609
  | `size` | input | `ComboboxSize` | `'medium'` | |
579
1610
  | `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
580
1611
  | `clearable` | input | `boolean` | `false` | Botão para limpar a escolha. |
581
- | `requiredManual` | input | `boolean` | `false` | Depreciado desde 0.2.0 — use `required`. |
582
1612
  | `loading` | input | `boolean` | `false` | Silhueta no lugar do campo enquanto as opções chegam. |
583
1613
  | `allowCustomValue` | input | `boolean` | `false` | Aceita texto livre: as opções passam a ser sugestões. |
584
1614
  | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
@@ -602,6 +1632,8 @@ Paleta de comandos: um diálogo com busca e a lista de comandos em grupos (`Mod+
602
1632
  | `recentLimit` | input | `number` | `0` | Quantos recentes mostrar no topo (busca vazia). 0 = sem recentes. |
603
1633
  | `recentIds` | model | `readonly string[]` | `[]` | Ids dos recentes, do mais novo ao mais antigo. Two-way, para o app persistir. |
604
1634
  | `closeOnRun` | input | `boolean` | `true` | Fecha depois de executar. |
1635
+ | `browseGroups` | input | `readonly string[]` | `[]` | Grupos mostrados com a busca vazia, nessa ordem (ex.: favoritos, recentes, módulos). Vazio = todos. Com texto, a busca percorre todos os comandos — inclusive o… |
1636
+ | `groupIcons` | input | `Readonly<Record<string, string>>` | `{}` | Ícone (nome do catálogo) antes do título de cada grupo, por nome do grupo. |
605
1637
  | `executed` | output | `HermesCommand` | | O comando terminou (depois da Promise, se houver). |
606
1638
 
607
1639
  ## `hm-palette-shell`
@@ -630,6 +1662,85 @@ Métodos públicos: `close(): void`
630
1662
  | `retry` | output | `void` | | |
631
1663
  | `dismissed` | output | `void` | | Fechou por Esc ou clique fora. |
632
1664
 
1665
+ ## `hm-connection-wizard`
1666
+
1667
+ `ConnectionWizardComponent` — import de `@trismegisto/angular/connection-wizard` (também na raiz)
1668
+
1669
+ Assistente de conexão (`hm-connection-wizard`) sobre o `hm-wizard`: **Escolher** a fonte (`hm-data-source-picker`) → **Credenciais** (`hm-credentials-form`, ou conteúdo projetado para um fluxo de autorização) → **Testar** (`hm-connection-test`) → **Concluir**.
1670
+
1671
+ Slots: `(padrão)`
1672
+
1673
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1674
+ |---|---|---|---|---|
1675
+ | `heading` | input | `string` | `''` | Título; vazio = catálogo ("Conectar integração"). |
1676
+ | `mode` | input | `WizardMode` | `'modal'` | |
1677
+ | `size` | input | `ModalSize` | `'large'` | |
1678
+ | `open` | model | `boolean` | `false` | Visibilidade (modo `modal`). Two-way. |
1679
+ | `sources` | input | `readonly DataSourceOption[]` | `[]` | Fontes para a etapa Escolher; vazio = sem a etapa. |
1680
+ | `sourceId` | model | `string \| null` | `null` | Fonte escolhida. Two-way. |
1681
+ | `fields` | input | `readonly CredentialField[]` | `[]` | Campos de credencial; vazio = a etapa mostra o conteúdo projetado. |
1682
+ | `values` | model | `CredentialFormValues` | `{}` | Valores das credenciais. Two-way. |
1683
+ | `canAuthorize` | input | `boolean` | `true` | Libera o Avançar da etapa Credenciais quando ela é um fluxo projetado (autorização). |
1684
+ | `testResult` | input | `ConnectionTestResult \| null` | `null` | |
1685
+ | `saving` | input | `boolean` | `false` | Salvando: o Concluir carrega. |
1686
+ | `confirmCancel` | input | `boolean` | `false` | Pergunta antes de cancelar (repassado ao `hm-wizard`). |
1687
+ | `test` | output | `ConnectionWizardRequest` | | |
1688
+ | `completed` | output | `ConnectionWizardRequest` | | |
1689
+ | `cancelled` | output | `void` | | |
1690
+ | `texts` | input | `Partial<ConnectionWizardMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
1691
+
1692
+ ## `hm-consent-preferences`
1693
+
1694
+ `ConsentPreferencesComponent` — import de `@trismegisto/angular/consent` (também na raiz)
1695
+
1696
+ Preferências de privacidade/cookies: uma chave por categoria (obrigatórias travadas em "Sempre ativo") e as ações recusar opcionais, aceitar todos e salvar.
1697
+
1698
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1699
+ |---|---|---|---|---|
1700
+ | `categories` | input (obrigatório) | `readonly ConsentCategory[]` | | |
1701
+ | `value` | model | `ConsentState \| null` | `null` | Escolha atual; `null` = nenhuma salva. |
1702
+ | `texts` | input | `Partial<ConsentMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
1703
+ | `saved` | output | `ConsentState` | | |
1704
+
1705
+ ## `hm-cookie-banner`
1706
+
1707
+ `CookieBannerComponent` — import de `@trismegisto/angular/consent` (também na raiz)
1708
+
1709
+ Aviso de cookies: título, texto, links (projetados) e as escolhas recusar opcionais, personalizar e aceitar todos — "Personalizar" abre o `hm-consent-preferences` no próprio aviso.
1710
+
1711
+ Slots: `(padrão)`
1712
+
1713
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1714
+ |---|---|---|---|---|
1715
+ | `categories` | input (obrigatório) | `readonly ConsentCategory[]` | | |
1716
+ | `value` | input | `ConsentState \| null` | `null` | Escolha salva antes (para "Personalizar" partir dela). |
1717
+ | `heading` | input | `string` | `''` | |
1718
+ | `message` | input | `string` | `''` | |
1719
+ | `position` | input | `CookieBannerPosition` | `'inline'` | |
1720
+ | `texts` | input | `Partial<ConsentMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
1721
+ | `saved` | output | `ConsentState` | | |
1722
+
1723
+ ## `hm-terms-acceptance`
1724
+
1725
+ `TermsAcceptanceComponent` — import de `@trismegisto/angular/consent` (também na raiz)
1726
+
1727
+ Aceite de termos: o texto (projetado) numa área com rolagem, a exigência de ler até o fim, a caixa "Li e aceito" e os botões aceitar/recusar.
1728
+
1729
+ Slots: `(padrão)`
1730
+
1731
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1732
+ |---|---|---|---|---|
1733
+ | `version` | input | `string` | `''` | Versão dos termos ("3.1"). |
1734
+ | `updatedAt` | input | `Date \| string \| number \| null` | `null` | Data da versão (o que `new Date()` aceita). |
1735
+ | `requireScroll` | input | `boolean` | `true` | |
1736
+ | `requireCheckbox` | input | `boolean` | `true` | |
1737
+ | `checkboxLabel` | input | `string` | `''` | |
1738
+ | `declinable` | input | `boolean` | `true` | Botão "Recusar". |
1739
+ | `loading` | input | `boolean` | `false` | |
1740
+ | `texts` | input | `Partial<ConsentMessages>` | `{}` | Sobrescrita parcial dos textos (padrão: o catálogo do idioma ativo). |
1741
+ | `accepted` | output | `void` | | |
1742
+ | `declined` | output | `void` | | |
1743
+
633
1744
  ## `hm-copy-button`
634
1745
 
635
1746
  `CopyButtonComponent` — import de `@trismegisto/angular/copy-button` (também na raiz)
@@ -650,6 +1761,58 @@ Métodos públicos: `copy(): Promise<boolean>`
650
1761
  | `copied` | output | `string` | | Copiou: emite o texto copiado. |
651
1762
  | `copyFailed` | output | `unknown` | | Nenhuma via funcionou: emite o erro da API de clipboard (ou `null`). |
652
1763
 
1764
+ ## `hm-connection-test`
1765
+
1766
+ `ConnectionTestComponent` — import de `@trismegisto/angular/credentials-form` (também na raiz)
1767
+
1768
+ Resultado de um teste de conexão (`hm-connection-test`): testando, sucesso (com a latência) ou falha (com a mensagem do app). Usado pelo `hm-credentials-form` e pelo `hm-database-connection-form`, e sozinho onde o teste mora fora de um formulário.
1769
+
1770
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1771
+ |---|---|---|---|---|
1772
+ | `result` | input | `ConnectionTestResult \| null` | `null` | Resultado do teste que o app executou; `null` = ainda não testou. |
1773
+ | `showIdle` | input | `boolean` | `false` | Mostra o texto do estado `idle`. |
1774
+ | `texts` | input | `Partial<CredentialsFormMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
1775
+
1776
+ ## `hm-credentials-form`
1777
+
1778
+ `CredentialsFormComponent` — import de `@trismegisto/angular/credentials-form` (também na raiz)
1779
+
1780
+ Formulário de credenciais de uma integração (`hm-credentials-form`): desenha `fields` numa grade responsiva, valida com `credentialIssues` e oferece **Testar conexão** e **Salvar**, com o resultado do teste (`hm-connection-test`) logo abaixo.
1781
+
1782
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1783
+ |---|---|---|---|---|
1784
+ | `fields` | input | `readonly CredentialField[]` | `[]` | |
1785
+ | `values` | model | `CredentialFormValues` | `{}` | Valores. Two-way. |
1786
+ | `testResult` | input | `ConnectionTestResult \| null` | `null` | Resultado do último teste (o app testa). |
1787
+ | `testable` | input | `boolean` | `true` | Mostra o botão Testar conexão. |
1788
+ | `requireTest` | input | `boolean` | `false` | Salvar só depois de um teste com sucesso. |
1789
+ | `saving` | input | `boolean` | `false` | Salvando: o Salvar carrega e o formulário trava. |
1790
+ | `hideActions` | input | `boolean` | `false` | Esconde os botões (quando outro componente, como o assistente, conduz o fluxo). |
1791
+ | `testLabel` | input | `string` | `''` | Rótulos dos botões; vazio = catálogo. |
1792
+ | `saveLabel` | input | `string` | `''` | |
1793
+ | `test` | output | `CredentialFormValues` | | Pede o teste com os valores (só a intenção: o app conecta). |
1794
+ | `save` | output | `CredentialFormValues` | | Pede para salvar com os valores. |
1795
+ | `texts` | input | `Partial<CredentialsFormMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
1796
+
1797
+ ## `hm-database-connection-form`
1798
+
1799
+ `DatabaseConnectionFormComponent` — import de `@trismegisto/angular/credentials-form` (também na raiz)
1800
+
1801
+ Formulário de conexão com banco de dados (`hm-database-connection-form`): o motor, os campos de `databaseConnectionFields` (servidor, porta, base, usuário, senha, SSL) num `hm-credentials-form` e a pré-visualização do endereço de conexão com a senha **sempre mascarada** (`databaseConnectionPreview`).
1802
+
1803
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1804
+ |---|---|---|---|---|
1805
+ | `engine` | model | `DatabaseEngine` | `'postgresql'` | Motor. Two-way. |
1806
+ | `engines` | input | `readonly DatabaseEngine[]` | `DATABASE_ENGINES` | Motores oferecidos (padrão: todos). |
1807
+ | `values` | model | `CredentialFormValues` | `{}` | Valores dos campos. Two-way. |
1808
+ | `testResult` | input | `ConnectionTestResult \| null` | `null` | |
1809
+ | `saving` | input | `boolean` | `false` | |
1810
+ | `requireTest` | input | `boolean` | `false` | |
1811
+ | `hideActions` | input | `boolean` | `false` | |
1812
+ | `test` | output | `DatabaseConnectionRequest` | | |
1813
+ | `save` | output | `DatabaseConnectionRequest` | | |
1814
+ | `texts` | input | `Partial<CredentialsFormMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
1815
+
653
1816
  ## `hm-data-grid-action-bar`
654
1817
 
655
1818
  `DataGridActionBarComponent` — import de `@trismegisto/angular/data-grid` (também na raiz)
@@ -664,6 +1827,16 @@ Slots: `(padrão)`
664
1827
  | `placeholder` | input | `string` | `''` | |
665
1828
  | `label` | input | `string` | `''` | Rótulo acessível do campo; vazio cai no texto padrão (`HERMES_MESSAGES`). |
666
1829
 
1830
+ ## `ng-template[hmCellEditor]`
1831
+
1832
+ `DataGridCellEditorDirective` — import de `@trismegisto/angular/data-grid` (também na raiz)
1833
+
1834
+ Editor próprio de uma coluna editável (`editor` na coluna): troca os campos prontos (texto, número, seleção, data, checkbox) por um template. O contexto traz o valor, `set`, `commit`, `cancel`, o erro e um nome acessível; Enter, Esc e Tab dentro dele seguem a grade (pare a propagação se o campo usa a tecla).
1835
+
1836
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1837
+ |---|---|---|---|---|
1838
+ | `hmCellEditor` | input (obrigatório) | `string` | | |
1839
+
667
1840
  ## `ng-template[hmCell]`
668
1841
 
669
1842
  `DataGridCellDirective` — import de `@trismegisto/angular/data-grid` (também na raiz)
@@ -712,7 +1885,7 @@ Slots: `[dataGridActions]`
712
1885
 
713
1886
  Templates no conteúdo: `<ng-template #detail>`, `<ng-template #detailPane>`, `<ng-template #detailPaneHeader>`, `<ng-template #footerDescription>`
714
1887
 
715
- Métodos públicos: `exportCsv(options: DataGridExportOptions = {}): string`, `clearPersistedState(): void`
1888
+ Métodos públicos: `exportCsv(options: DataGridExportOptions = {}): string`, `editRow(id: string, key: string \| null = null): boolean`, `saveEdits(): void`, `discardEdits(rowId?: string): void`, `expandAllRows(): void`, `collapseAllRows(): void`, `clearPersistedState(): void`
716
1889
 
717
1890
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
718
1891
  |---|---|---|---|---|
@@ -769,8 +1942,37 @@ Métodos públicos: `exportCsv(options: DataGridExportOptions = {}): string`, `c
769
1942
  | `filterQuery` | model | `GridFilterQuery` | `EMPTY_GRID_QUERY` | |
770
1943
  | `columnManager` | input | `boolean` | `false` | |
771
1944
  | `columnOrder` | model | `readonly string[]` | `[]` | |
1945
+ | `striped` | input | `boolean` | `true` | Linhas intercaladas (zebra). `false` deixa todas as linhas no mesmo fundo. |
1946
+ | `columnGroups` | input | `readonly GridColumnGroup[]` | `[]` | Cabeçalho em dois níveis: títulos que cobrem colunas vizinhas. |
1947
+ | `editMode` | input | `DataGridEditMode` | `'none'` | Edição inline nas colunas com `editor`: por célula ou pela linha inteira. |
1948
+ | `editBatch` | input | `boolean` | `false` | Guarda as alterações (marcadas como alteradas) até "Salvar alterações", em vez de emitir a cada confirmação. |
1949
+ | `editSaved` | output | `DataGridEditSave<T>` | | Intenção de salvar: a grade não grava nada; o app persiste e devolve as linhas em `rows`. |
1950
+ | `editStarted` | output | `{ row: T; key: string \| null }` | | |
1951
+ | `editCanceled` | output | `T` | | |
1952
+ | `texts` | input | `Partial<DataGridEditMessages> \| null` | `null` | Sobrescreve textos da edição (rótulos, anúncios, validação), chave a chave. |
1953
+ | `treeChildren` | input | `((row: T) => readonly T[] \| null \| undefined) \| null` | `null` | Tree table: filhos de cada linha (`rows` vira a lista de raízes). |
1954
+ | `treeHasChildren` | input | `((row: T) => boolean) \| null` | `null` | Tree table com carga sob demanda: a linha tem filhos ainda não carregados. |
1955
+ | `treeExpanded` | model | `GridTreeExpanded` | `NO_EXPANDED_TREE_ROWS` | Ids das linhas abertas na tree table. |
1956
+ | `treePagination` | input | `'rows' \| 'roots'` | `'rows'` | Tree table: o que a paginação conta. "rows" (padrão) corta a lista visível, filhos inclusive; "roots" conta só as raízes e traz cada uma com todos os filhos vi… |
1957
+ | `treeChildPageSize` | input | `number \| null` | `null` | Tree table: quantos filhos de um pai aparecem antes da linha "Mostrar mais"; `null` (padrão) = todos. |
1958
+ | `treeToggled` | output | `DataGridTreeToggle<T>` | | |
772
1959
  | `detailPaneToggled` | output | `{ row: T; open: boolean }` | | |
773
1960
 
1961
+ ## `hm-data-source-picker`
1962
+
1963
+ `DataSourcePickerComponent` — import de `@trismegisto/angular/data-source-picker` (também na raiz)
1964
+
1965
+ Escolha de uma fonte de dados (`hm-data-source-picker`): cartões de rádio agrupados pelo `type` de cada opção, com busca opcional. `[(value)]` guarda o `id` escolhido.
1966
+
1967
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
1968
+ |---|---|---|---|---|
1969
+ | `options` | input | `readonly DataSourceOption[]` | `[]` | |
1970
+ | `value` | model | `string \| null` | `null` | `id` escolhido. Two-way. |
1971
+ | `label` | input | `string` | `''` | Rótulo do grupo; vazio = catálogo ("Fonte de dados"). |
1972
+ | `searchable` | input | `boolean` | `false` | Mostra a busca. |
1973
+ | `query` | model | `string` | `''` | Texto da busca. Two-way. |
1974
+ | `texts` | input | `Partial<DataSourcePickerMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
1975
+
774
1976
  ## `hm-calendar`
775
1977
 
776
1978
  `CalendarComponent` — import de `@trismegisto/angular/date-picker` (também na raiz)
@@ -786,8 +1988,12 @@ Métodos públicos: `focusNow(): void`, `focusActive(): void`
786
1988
  | `rangeEnd` | input | `IsoDate \| null` | `null` | |
787
1989
  | `min` | input | `IsoDate \| null` | `null` | |
788
1990
  | `max` | input | `IsoDate \| null` | `null` | |
1991
+ | `pickLevel` | input | `'day' \| 'month'` | `'day'` | Até onde a pessoa escolhe: `'day'` (padrão, o calendário de sempre) ou `'month'` — abre na grade de meses, escolher um mês emite `monthPicked` (`AAAA-MM`) em v… |
1992
+ | `selectedMonth` | input | `string \| null` | `null` | Mês marcado no modo `pickLevel="month"` (`AAAA-MM`). |
1993
+ | `texts` | input | `Partial<CalendarMonthMessages>` | `{}` | Textos próprios do modo mês (sobrescrevem os do catálogo da peça, por chave). |
789
1994
  | `picked` | output | `IsoDate` | | |
790
1995
  | `cleared` | output | `void` | | |
1996
+ | `monthPicked` | output | `string` | | Mês escolhido no modo `pickLevel="month"` (`AAAA-MM`). |
791
1997
 
792
1998
  ## `hm-date-picker`
793
1999
 
@@ -810,6 +2016,21 @@ Campo de data — o `hermes-date-container` + `hermesDate` do hermes-ui antigo,
810
2016
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
811
2017
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
812
2018
 
2019
+ ## `hm-date-popover`
2020
+
2021
+ `DatePopoverComponent` — import de `@trismegisto/angular/date-picker`
2022
+
2023
+ Cartão flutuante do calendário, ancorado no campo (abaixo, alinhado à esquerda; em cima se não couber). Mesma técnica do hm-dropdown/hm-menu: vai para o `<body>` (escapa de `overflow` de modal e de tabela), fundo transparente fecha no clique fora, Esc fecha.
2024
+
2025
+ Slots: `(padrão)`
2026
+
2027
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2028
+ |---|---|---|---|---|
2029
+ | `anchorEl` | input (obrigatório) | `HTMLElement` | | |
2030
+ | `label` | input | `string` | `''` | |
2031
+ | `closed` | output | `void` | | |
2032
+ | `ready` | output | `void` | | Já medido, posicionado e visível — só então dá pra focar algo dentro (invisível não recebe foco). |
2033
+
813
2034
  ## `hm-date-range-picker`
814
2035
 
815
2036
  `DateRangePickerComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/date-picker` (também na raiz)
@@ -819,10 +2040,6 @@ Intervalo de datas num campo só — o `hermesStartDate`/`hermesEndDate` do herm
819
2040
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
820
2041
  |---|---|---|---|---|
821
2042
  | `value` | model | `DateRange` | `EMPTY_DATE_RANGE` | |
822
- | `startControl` | input | `DateControl \| null` | `null` | Depreciado desde 0.2.0 — use `formControlName`/`[(ngModel)]`/`[(value)]` com `DateRange`. |
823
- | `endControl` | input | `DateControl \| null` | `null` | Depreciado desde 0.2.0 — idem `startControl`. |
824
- | `start` | model | `string \| null` | `null` | Depreciado desde 0.2.0 — use `[(value)]` com `DateRange`. |
825
- | `end` | model | `string \| null` | `null` | Depreciado desde 0.2.0 — use `[(value)]` com `DateRange`. |
826
2043
  | `label` | input (obrigatório) | `string` | | |
827
2044
  | `labelHidden` | input | `boolean` | `false` | |
828
2045
  | `hint` | input | `string` | `''` | |
@@ -835,6 +2052,99 @@ Intervalo de datas num campo só — o `hermesStartDate`/`hermesEndDate` do herm
835
2052
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
836
2053
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
837
2054
 
2055
+ ## `hm-datetime-picker`
2056
+
2057
+ `DateTimePickerComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/datetime-picker` (também na raiz)
2058
+
2059
+ Data e hora num campo só (início de um evento, agendamento). Junta o `hm-date-picker` (digitação com máscara e calendário) e o `hm-time-picker` (relógio do idioma e horários sugeridos) num grupo com um rótulo, e grava UM valor: ISO local `AAAA-MM-DDTHH:mm`, o do `<input type="datetime-local">` (sem fuso; a leitura aceita segundos, `Z` e espaço no lugar do `T`, sem converter o relógio).
2060
+
2061
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2062
+ |---|---|---|---|---|
2063
+ | `value` | model | `string \| null` | `null` | |
2064
+ | `label` | input (obrigatório) | `string` | | |
2065
+ | `labelHidden` | input | `boolean` | `false` | |
2066
+ | `hint` | input | `string` | `''` | |
2067
+ | `min` | input | `string \| number \| null \| undefined` | `null` | Primeiro instante aceito (`AAAA-MM-DDTHH:mm`). Número (o `min()` do Signal Forms) é ignorado. |
2068
+ | `max` | input | `string \| number \| null \| undefined` | `null` | Último instante aceito (`AAAA-MM-DDTHH:mm`). Número é ignorado, como no `min`. |
2069
+ | `interval` | input | `number` | `30` | Intervalo, em minutos, entre os horários sugeridos. |
2070
+ | `hourCycle` | input | `TimeHourCycle \| null` | `null` | Força o relógio (`h12`/`h23`); `null` segue o idioma. |
2071
+ | `defaultTime` | input | `IsoTime \| null` | `null` | Hora preenchida sozinha quando a pessoa escolhe a data e a hora ainda está vazia (`HH:mm`). |
2072
+ | `dateLabel` | input | `string` | `''` | Nome da parte de data (padrão: catálogo, "Data"). |
2073
+ | `timeLabel` | input | `string` | `''` | Nome da parte de hora (padrão: catálogo, "Hora"). |
2074
+ | `texts` | input | `Partial<DateTimePickerMessages>` | `{}` | Textos próprios (sobrescrevem os do catálogo da peça, por chave). |
2075
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2076
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2077
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2078
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2079
+
2080
+ ## `hm-deadline`
2081
+
2082
+ `DeadlineComponent` — import de `@trismegisto/angular/deadline` (também na raiz)
2083
+
2084
+ Indicador de prazo e contagem regressiva.
2085
+
2086
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2087
+ |---|---|---|---|---|
2088
+ | `due` | input | `WorkflowDateValue` | `null` | |
2089
+ | `completedAt` | input | `WorkflowDateValue` | `null` | |
2090
+ | `variant` | input | `DeadlineVariant` | `'badge'` | |
2091
+ | `soonHours` | input | `number` | `24` | Janela de "vence logo", em horas. |
2092
+ | `now` | input | `WorkflowDateValue` | `null` | Fixa o "agora". Vazio = relógio real. |
2093
+ | `expired` | output | `void` | | A contagem chegou a zero (uma vez por prazo). |
2094
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
2095
+
2096
+ ## `hm-sla`
2097
+
2098
+ `SlaComponent` — import de `@trismegisto/angular/deadline` (também na raiz)
2099
+
2100
+ Indicador de SLA: quanto do tempo-alvo já foi consumido, a situação (no prazo, em risco, estourado, pausado, cumprido, descumprido) e o tempo que resta (ou passou).
2101
+
2102
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2103
+ |---|---|---|---|---|
2104
+ | `start` | input | `WorkflowDateValue` | `null` | |
2105
+ | `due` | input | `WorkflowDateValue` | `null` | |
2106
+ | `completedAt` | input | `WorkflowDateValue` | `null` | |
2107
+ | `pausedMs` | input | `number` | `0` | Tempo já parado (ms) que não conta. |
2108
+ | `paused` | input | `boolean` | `false` | |
2109
+ | `atRiskRatio` | input | `number` | `0.75` | |
2110
+ | `label` | input | `string` | `''` | Nome do SLA ("Primeira resposta"). Vazio = "SLA". |
2111
+ | `compact` | input | `boolean` | `false` | Sem a linha de restante/meta (listas). |
2112
+ | `now` | input | `WorkflowDateValue` | `null` | |
2113
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
2114
+
2115
+ ## `hm-deploy-pipeline`
2116
+
2117
+ `DeployPipelineComponent` — import de `@trismegisto/angular/deploy-pipeline` (também na raiz)
2118
+
2119
+ Etapas de um deploy (build → testes → deploy → verificação…) com o estado de cada uma, a duração, a etapa atual (`aria-current="step"`) e o estado geral do pipeline (`pipelineStatus`). As ações — tentar de novo uma etapa que falhou, cancelar o deploy em curso, reverter o que terminou — só emitem a intenção.
2120
+
2121
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2122
+ |---|---|---|---|---|
2123
+ | `stages` | input | `readonly DeployPipelineStage[]` | `[]` | |
2124
+ | `heading` | input | `string` | `''` | Nome do deploy ("api · v2.14.0"). |
2125
+ | `headingLevel` | input | `DeployPipelineHeadingLevel` | `0` | `0` (padrão): nome só em destaque; `2`–`6`: título com esse nível. |
2126
+ | `label` | input | `string` | `''` | Nome da lista de etapas. Vazio = catálogo. |
2127
+ | `now` | input | `number \| null` | `null` | Instante de referência (ms) para a duração das etapas em curso; `null` = agora. |
2128
+ | `retryable` | input | `boolean` | `false` | |
2129
+ | `cancellable` | input | `boolean` | `false` | |
2130
+ | `rollbackable` | input | `boolean` | `false` | |
2131
+ | `texts` | input | `Partial<MonitoringTextMessages & DeployPipelineMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
2132
+ | `retry` | output | `string` | | Pede para repetir a etapa (id). |
2133
+ | `cancel` | output | `void` | | |
2134
+ | `rollback` | output | `void` | | |
2135
+
2136
+ ## `hm-deploy-status`
2137
+
2138
+ `DeployStatusComponent` — import de `@trismegisto/angular/deploy-pipeline` (também na raiz)
2139
+
2140
+ Selo do estado de um deploy, de uma etapa ou de um release: ícone + nome do estado, no tom de `deployStatusIntent`.
2141
+
2142
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2143
+ |---|---|---|---|---|
2144
+ | `status` | input | `DeployStatus` | `'queued'` | |
2145
+ | `label` | input | `string` | `''` | Texto no lugar do nome do estado. |
2146
+ | `texts` | input | `Partial<MonitoringTextMessages & DeployPipelineMessages> \| null` | `null` | Sobrescrita parcial dos textos. |
2147
+
838
2148
  ## `hm-description-item`
839
2149
 
840
2150
  `DescriptionItemComponent` — import de `@trismegisto/angular/description-list` (também na raiz)
@@ -985,8 +2295,9 @@ Slots: `(padrão)`, `[footer]`
985
2295
  | `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
2296
  | `closeLabel` | input | `string` | `''` | Nome acessível do X. Vazio usa `drawer.close` do catálogo. |
987
2297
  | `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`. |
2298
+ | `closeOnBackdrop` | input | `boolean` | `false` | Clicar no véu fecha, passando pela mesma guarda do X (`closable=false` continua impedindo). Sem efeito se `pinned`. |
2299
+ | `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda consultada quando a pessoa tenta sair pelo X, pelo `Esc` ou pelo véu, igual à do `hm-modal`: `false` (ou Promise com `false`) mantém aberto. Não é chama… |
2300
+ | `closed` | output | `void` | | Emitido depois que a pessoa fechou pelo X, pelo `Esc` ou pelo véu. |
990
2301
 
991
2302
  ## `hm-dropdown`
992
2303
 
@@ -1082,6 +2393,68 @@ Slots: `[emptyMedia]`, `[emptyDescription]`, `(padrão)`
1082
2393
  | `size` | input | `EmptySize` | `'medium'` | |
1083
2394
  | `headingLevel` | input | `EmptyHeadingLevel` | `0` | |
1084
2395
 
2396
+ ## `hm-endpoint-card`
2397
+
2398
+ `EndpointCardComponent` — import de `@trismegisto/angular/endpoint-card` (também na raiz)
2399
+
2400
+ Cartão de um endpoint de API (catálogo de API, documentação interna, painel de integração): método e caminho com os parâmetros de caminho destacados (`/users/{id}`), resumo e descrição, autenticação, ciclo de vida (estável, beta, descontinuado), parâmetros (onde vão, tipo, obrigatório) e respostas possíveis. Ações ("Testar", "Copiar URL") entram por projeção em `[endpointActions]`.
2401
+
2402
+ Slots: `[endpointActions]`
2403
+
2404
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2405
+ |---|---|---|---|---|
2406
+ | `method` | input (obrigatório) | `string` | | |
2407
+ | `path` | input (obrigatório) | `string` | | |
2408
+ | `summary` | input | `string` | `''` | Uma linha: o que o endpoint faz. |
2409
+ | `description` | input | `string` | `''` | |
2410
+ | `auth` | input | `string \| null` | `null` | Esquema de autenticação ("Bearer", "API key"); vazio = sem autenticação; `null` esconde a linha. |
2411
+ | `lifecycle` | input | `EndpointLifecycle \| null` | `null` | |
2412
+ | `params` | input | `readonly EndpointParam[]` | `[]` | |
2413
+ | `responses` | input | `readonly EndpointResponse[]` | `[]` | |
2414
+ | `headingLevel` | input | `EndpointHeadingLevel` | `3` | |
2415
+ | `texts` | input | `Partial<EndpointCardMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial). |
2416
+
2417
+ ## `hm-entity-picker`
2418
+
2419
+ `EntityPickerComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/entity-picker` (também na raiz)
2420
+
2421
+ Seletor de entidade com presets: pessoa, equipe, organização, departamento, papel, permissão ou grupo. Por baixo é o `hm-combobox` (um) ou o `hm-combobox-multi` (`multiple`), com filtro por digitação no nome e na descrição; o `kind` escolhe o ícone de cada opção e o rótulo/placeholder padrão do catálogo.
2422
+
2423
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2424
+ |---|---|---|---|---|
2425
+ | `value` | model | `EntityPickerValue` | `''` | |
2426
+ | `entities` | input (obrigatório) | `readonly PeopleEntity[]` | | |
2427
+ | `kind` | input | `PeopleEntityKind` | `'user'` | Preset: ícone das opções e rótulo/placeholder padrão. |
2428
+ | `multiple` | input | `boolean` | `false` | Vários valores (fichas). |
2429
+ | `label` | input | `string` | `''` | Rótulo do campo. Vazio = nome do tipo ("Pessoa", "Equipe"...). |
2430
+ | `labelHidden` | input | `boolean` | `false` | |
2431
+ | `placeholder` | input | `string` | `''` | Vazio = "Buscar pessoas", "Buscar equipes"... |
2432
+ | `hint` | input | `string` | `''` | |
2433
+ | `clearable` | input | `boolean` | `false` | Botão de limpar (só sem `multiple`). |
2434
+ | `loading` | input | `boolean` | `false` | Silhueta enquanto a lista chega (só sem `multiple`). |
2435
+ | `max` | input | `number \| null` | `null` | Limite de itens com `multiple`. |
2436
+ | `visibleChipsLimit` | input | `number \| null` | `2` | Fichas visíveis com a lista fechada (`multiple`); `null` = todas. |
2437
+ | `texts` | input | `Partial<EntityPickerMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
2438
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2439
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2440
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2441
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2442
+
2443
+ ## `hm-environment-picker`
2444
+
2445
+ `EnvironmentPickerComponent` — import de `@trismegisto/angular/environment-picker` (também na raiz)
2446
+
2447
+ Seletores de ambiente e cluster de uma tela de operação (deploy, logs, métricas). O ambiente escolhido aparece também como selo com ícone e o nome do tipo; produção ganha, além da cor, o aviso em texto.
2448
+
2449
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2450
+ |---|---|---|---|---|
2451
+ | `environments` | input | `readonly EnvironmentOption[]` | `[]` | |
2452
+ | `clusters` | input | `readonly ClusterOption[]` | `[]` | Clusters; vazio = sem seletor de cluster. |
2453
+ | `environment` | model | `string` | `''` | Id do ambiente escolhido. |
2454
+ | `cluster` | model | `string` | `''` | Id do cluster escolhido. |
2455
+ | `control` | input | `EnvironmentPickerControl` | `'auto'` | |
2456
+ | `texts` | input | `Partial<MonitoringTextMessages & EnvironmentPickerMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
2457
+
1085
2458
  ## `hm-event-calendar`
1086
2459
 
1087
2460
  `EventCalendarComponent` — import de `@trismegisto/angular/event-calendar` (também na raiz)
@@ -1100,9 +2473,36 @@ Agenda de eventos genérica: visões **mês, semana, dia e lista** (`[(view)]`),
1100
2473
  | `scrollToHour` | input | `number` | `8` | Hora em que a grade de semana/dia abre rolada. |
1101
2474
  | `compactBelow` | input | `number` | `600` | Largura (px) do componente abaixo da qual semana vira lista e mês fica compacto. 0 desliga. |
1102
2475
  | `label` | input | `string` | `''` | Nome da agenda para leitor de tela (padrão: "Agenda" do catálogo). |
2476
+ | `editable` | input | `boolean` | `false` | Liga arrastar/redimensionar (e o atalho Alt + setas). Padrão desligado. |
2477
+ | `snapMinutes` | input | `number` | `15` | Passo (minutos) do arrasto na grade de horas e do Alt + cima/baixo. |
1103
2478
  | `eventClick` | output | `CalendarEvent` | | |
1104
2479
  | `dateClick` | output | `EventCalendarDateClick` | | |
1105
2480
  | `rangeChange` | output | `EventCalendarRangeChange` | | |
2481
+ | `eventChange` | output | `CalendarEventChange` | | Evento movido ou redimensionado (só com `editable`): novo início/fim, para o app gravar. |
2482
+
2483
+ ## `hm-execution-status`
2484
+
2485
+ `ExecutionStatusComponent` — import de `@trismegisto/angular/execution-status` (também na raiz)
2486
+
2487
+ Execução e conclusão de um processo (importação, rotina, implantação, etapa de workflow): situação, progresso, início, fim, duração e as ações de cancelar, pausar/retomar e tentar de novo.
2488
+
2489
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2490
+ |---|---|---|---|---|
2491
+ | `state` | input (obrigatório) | `ExecutionState` | | |
2492
+ | `label` | input | `string` | `''` | Nome do que está executando. |
2493
+ | `progress` | input | `number \| null` | `null` | 0–100; `null` = sem medida. |
2494
+ | `startedAt` | input | `WorkflowDateValue` | `null` | |
2495
+ | `finishedAt` | input | `WorkflowDateValue` | `null` | |
2496
+ | `message` | input | `string` | `''` | Detalhe: o resultado, o erro ou o passo atual. |
2497
+ | `cancelable` | input | `boolean` | `false` | |
2498
+ | `pausable` | input | `boolean` | `false` | |
2499
+ | `retryable` | input | `boolean` | `false` | |
2500
+ | `now` | input | `WorkflowDateValue` | `null` | |
2501
+ | `cancel` | output | `void` | | |
2502
+ | `pause` | output | `void` | | |
2503
+ | `resume` | output | `void` | | |
2504
+ | `retry` | output | `void` | | |
2505
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
1106
2506
 
1107
2507
  ## `hm-fab`
1108
2508
 
@@ -1128,39 +2528,80 @@ Botão de ação flutuante, com o que faltava para ser componente de biblioteca:
1128
2528
  | `triggered` | output | `void` | | Clique no botão sem `actions`. |
1129
2529
  | `chosen` | output | `string` | | `id` da ação escolhida no speed dial. |
1130
2530
 
1131
- ## `hm-field`
2531
+ ## `hm-feature-flags`
1132
2532
 
1133
- `FieldComponent` · `ControlValueAccessor` · **Depreciado** · estende `InputComponent` — import de `@trismegisto/angular/field` (também na raiz)
2533
+ `FeatureFlagsComponent` — import de `@trismegisto/angular/feature-flags` (também na raiz)
1134
2534
 
1135
- Depreciado desde 0.2.0 — use `<hm-input>` (mesma API; ligue o formulário com `formControlName`/`[formControl]`, `[(ngModel)]` ou `[(value)]` — o `[control]` saiu). Será removido na 0.3.0.
2535
+ Lista de flags de funcionalidade com alternância: busca (nome, chave, descrição, etiquetas), filtro por estado, resumo ("3 de 8 ativas") e, por flag, o interruptor, a chave que o código lê, descrição, etiquetas, liberação gradual (percentual) e quem alterou por último. Flag `locked` aparece travada com o motivo. O interruptor só pede (`toggle`); quem grava (e atualiza `flags`) é o app — `busy` mo…
1136
2536
 
1137
- Slots: `[hmPrefix]`, `[hmSuffix]`
2537
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2538
+ |---|---|---|---|---|
2539
+ | `flags` | input (obrigatório) | `readonly FeatureFlag[]` | | |
2540
+ | `filter` | model | `FeatureFlagFilter` | `'all'` | Filtro por estado. Two-way. |
2541
+ | `query` | model | `string` | `''` | Texto de busca. Two-way. |
2542
+ | `busy` | input | `readonly string[]` | `[]` | Chaves sendo gravadas (o interruptor mostra a espera). |
2543
+ | `searchable` | input | `boolean` | `true` | |
2544
+ | `filterable` | input | `boolean` | `true` | |
2545
+ | `label` | input | `string` | `''` | Título (padrão: "Flags de funcionalidade"). |
2546
+ | `texts` | input | `Partial<FeatureFlagsMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial). |
2547
+ | `toggle` | output | `FeatureFlagToggle` | | |
2548
+
2549
+ ## `hm-field-mapping`
2550
+
2551
+ `FieldMappingComponent` — import de `@trismegisto/angular/field-mapping` (também na raiz)
2552
+
2553
+ Mapeamento de campos (`hm-field-mapping`): uma linha por campo de destino, com o campo de origem escolhido num select (nome e tipo), os obrigatórios marcados, **Mapear automaticamente** (`autoMapFields`: casa nome, rótulo e apelidos sem acento nem pontuação, sem mexer no que já foi escolhido) e os problemas de cada linha (`fieldMappingIssues`: obrigatório sem origem, origem repetida, tipo incompa…
2554
+
2555
+ Métodos públicos: `autoMap(): void`
1138
2556
 
1139
2557
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1140
2558
  |---|---|---|---|---|
1141
- | `value` | model (herdado) | `T` | `'' as T` | |
1142
- | `label` | input (obrigatório) (herdado) | `string` | | |
1143
- | `type` | input (herdado) | `InputType` | `'text'` | |
1144
- | `placeholder` | input (herdado) | `string` | `''` | |
1145
- | `icon` | input (herdado) | `string` | `''` | Ícone decorativo no fim do campo. |
1146
- | `labelHidden` | input (herdado) | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
1147
- | `hint` | input (herdado) | `string` | `''` | Texto de apoio embaixo do campo (formato esperado, efeito automático...). |
1148
- | `prefix` | input (herdado) | `string` | `''` | Texto antes do valor ("R$"). Anunciado como descrição do campo. |
1149
- | `suffix` | input (herdado) | `string` | `''` | Texto depois do valor ("kg"). Anunciado como descrição do campo. |
1150
- | `prefixIcon` | input (herdado) | `string` | `''` | Ícone decorativo no início do campo. |
1151
- | `mask` | input (herdado) | `HermesMask \| ''` | `''` | Máscara pronta (`cpf`, `cnpj`, `cep`, `phone`) ou padrão customizado; vazio = sem máscara. |
1152
- | `maskValue` | input (herdado) | `InputMaskValue` | `'raw'` | |
1153
- | `min` | input (herdado) | `number \| null, unknown` | `null` | |
1154
- | `max` | input (herdado) | `number \| null, unknown` | `null` | |
1155
- | `step` | input (herdado) | `number \| null, unknown` | `null` | |
1156
- | `stepButtons` | input (herdado) | `boolean` | `true` | Botões −/+ no `type="number"`. |
1157
- | `maxLength` | input (herdado) | `number \| null, unknown` | `null` | Limite de caracteres, com contador visível. Ignorado com `mask`. |
1158
- | `autocomplete` | input (herdado) | `string` | `''` | |
1159
- | `inputMode` | input (herdado) | `InputMode \| ''` | `''` | Sobrescreve o `inputmode` derivado do tipo/máscara. |
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.' }`). |
2559
+ | `source` | input | `readonly MappableField[]` | `[]` | Campos de onde os dados vêm (colunas da planilha, campos da API). |
2560
+ | `target` | input | `readonly MappableField[]` | `[]` | Campos de destino (o modelo do app). |
2561
+ | `mapping` | model | `FieldMapping` | `{}` | Destino → origem. Two-way. |
2562
+ | `texts` | input | `Partial<FieldMappingMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
2563
+
2564
+ ## `hm-file-list`
2565
+
2566
+ `FileListComponent` — import de `@trismegisto/angular/file-list` (também na raiz)
2567
+
2568
+ Lista de arquivos por coleção — **todos**, **recentes** (último acesso da pessoa), **compartilhados comigo** e **favoritos** — com o seletor de coleção (`collections`, `[(collection)]`), busca por texto (`query`), agrupamento por data ("Hoje", "Ontem", "Últimos 7 dias"...) e a estrela de favorito em cada linha. Ícone por tipo do mesmo jeito do `hm-attachment`. Só apresentação: `open` abre, `favor…
2569
+
2570
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2571
+ |---|---|---|---|---|
2572
+ | `files` | input (obrigatório) | `readonly FileItem[]` | | |
2573
+ | `collection` | model | `FileCollection` | `'all'` | Coleção mostrada. Two-way. |
2574
+ | `collections` | input | `readonly FileCollection[]` | `FILE_COLLECTIONS` | Coleções no seletor (e a ordem). Vazio ou uma só esconde o seletor. |
2575
+ | `query` | input | `string` | `''` | Texto de busca (nome e local). |
2576
+ | `groupByDate` | input | `boolean \| null` | `null` | Agrupa por data. Padrão: só em "recentes" e "compartilhados". |
2577
+ | `recentLimit` | input | `number` | `50` | Limite de "recentes". |
2578
+ | `favorites` | input | `boolean` | `true` | Mostra a estrela de favorito (padrão). |
2579
+ | `label` | input | `string` | `''` | Título (padrão: "Arquivos"). |
2580
+ | `now` | input | `Date \| null` | `null` | Agora, para os grupos de data (padrão: o relógio do navegador). |
2581
+ | `open` | output | `FileItem` | | |
2582
+ | `favoriteChange` | output | `FileFavoriteChange` | | |
2583
+ | `texts` | input | `Partial<FileListMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
2584
+
2585
+ ## `hm-file-permissions`
2586
+
2587
+ `FilePermissionsComponent` — import de `@trismegisto/angular/file-permissions` (também na raiz)
2588
+
2589
+ Permissões de um arquivo ou pasta: adicionar pessoas/grupos com um papel, a lista de quem tem acesso (dono primeiro; herdados da pasta aparecem com a origem e não mudam aqui) com troca de papel e remoção, e o acesso pelo link (restrito / organização / qualquer pessoa) com "copiar link". Só emite a intenção (`invite`, `roleChange`, `remove`, `[(linkAccess)]`); quem aplica — e quem decide quem pode…
2590
+
2591
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2592
+ |---|---|---|---|---|
2593
+ | `entries` | input (obrigatório) | `readonly FilePermission[]` | | |
2594
+ | `roles` | input | `readonly FileRoleOption[] \| null` | `null` | Papéis do seletor, do maior para o menor acesso. Padrão: proprietário, editor, comentador, leitor. |
2595
+ | `ownerRole` | input | `string` | `'owner'` | Papel que conta como dono (não pode ficar sem nenhum). |
2596
+ | `inviteRole` | input | `string` | `'viewer'` | Papel padrão do convite. |
2597
+ | `linkAccess` | model | `FileLinkAccess \| null` | `null` | Acesso pelo link. `null` esconde a seção. Two-way. |
2598
+ | `link` | input | `string` | `''` | Link do arquivo para "copiar link". |
2599
+ | `canManage` | input | `boolean` | `true` | A pessoa pode gerenciar (sem isso, tudo é só leitura). |
2600
+ | `label` | input | `string` | `''` | Título (padrão: "Acesso ao arquivo"). |
2601
+ | `invite` | output | `FilePermissionInvite` | | |
2602
+ | `roleChange` | output | `{ readonly entry: FilePermission; readonly role: string }` | | |
2603
+ | `remove` | output | `FilePermission` | | |
2604
+ | `texts` | input | `Partial<FilePermissionsMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
1164
2605
 
1165
2606
  ## `hm-file-upload`
1166
2607
 
@@ -1194,6 +2635,22 @@ Métodos públicos: `addFiles(list: readonly File[]): UploadFile[]`, `update(id:
1194
2635
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
1195
2636
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1196
2637
 
2638
+ ## `hm-file-versions`
2639
+
2640
+ `FileVersionsComponent` — import de `@trismegisto/angular/file-versions` (também na raiz)
2641
+
2642
+ Versões e histórico de um arquivo: da mais recente para a mais antiga, cada uma com número (ou `label`), autor, data e hora, tamanho (com a variação para a anterior) e comentário; a atual leva o selo "Versão atual". Ações por versão: `restore` (as anteriores, com `restorable`) e `download` (com `downloadable`). O componente só emite — restaurar de verdade (e atualizar `versions`) é do app.
2643
+
2644
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2645
+ |---|---|---|---|---|
2646
+ | `versions` | input (obrigatório) | `readonly FileVersion[]` | | |
2647
+ | `restorable` | input | `boolean` | `true` | Mostra "Restaurar" nas versões que não são a atual. |
2648
+ | `downloadable` | input | `boolean` | `true` | Mostra "Baixar" em todas. |
2649
+ | `label` | input | `string` | `''` | Título (padrão: "Histórico de versões"). |
2650
+ | `restore` | output | `FileVersion` | | |
2651
+ | `download` | output | `FileVersion` | | |
2652
+ | `texts` | input | `Partial<FileVersionsMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
2653
+
1197
2654
  ## `hm-filter-bar`
1198
2655
 
1199
2656
  `FilterBarComponent` — import de `@trismegisto/angular/filter-bar` (também na raiz)
@@ -1214,6 +2671,78 @@ Métodos públicos: `clearAll(): void`, `reloadSaved(): Promise<void>`
1214
2671
  | `savedChange` | output | `readonly SavedFilter[]` | | A lista de salvos mudou (já persistida). |
1215
2672
  | `savedApplied` | output | `SavedFilter` | | Um salvo foi aplicado pela pessoa (ou o padrão, ao carregar). |
1216
2673
 
2674
+ ## `hm-balance-card`
2675
+
2676
+ `BalanceCardComponent` — import de `@trismegisto/angular/finance` (também na raiz)
2677
+
2678
+ Saldo e crédito (`hm-balance-card`): saldo em destaque, valor a liberar, o limite de crédito com a parte usada numa barra e o limite disponível, com o botão de ocultar valores (olho) para uso em público.
2679
+
2680
+ Slots: `(padrão)`
2681
+
2682
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2683
+ |---|---|---|---|---|
2684
+ | `balance` | input (obrigatório) | `number` | | |
2685
+ | `currency` | input | `string` | `'BRL'` | |
2686
+ | `label` | input | `string` | `''` | |
2687
+ | `pending` | input | `number \| null` | `null` | Valor a liberar (vendas a receber, depósito em compensação). |
2688
+ | `credit` | input | `CreditLine \| null` | `null` | |
2689
+ | `updatedAt` | input | `DateInput` | `null` | |
2690
+ | `hideable` | input | `boolean` | `false` | Mostra o botão de ocultar valores. |
2691
+ | `hidden` | model | `boolean` | `false` | |
2692
+ | `texts` | input | `CatalogOverride<FinanceMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`FINANCE_MESSAGES_PT_BR`). |
2693
+
2694
+ ## `hm-budget-variance`
2695
+
2696
+ `BudgetVarianceComponent` — import de `@trismegisto/angular/finance` (também na raiz)
2697
+
2698
+ Orçamento × realizado (`hm-budget-variance`): uma linha por categoria com orçado, realizado, a barra do quanto já foi usado (com a marca do esperado até agora), a variação em valor e porcentagem e a situação (abaixo do previsto, dentro, perto do limite, acima), e a linha de total.
2699
+
2700
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2701
+ |---|---|---|---|---|
2702
+ | `lines` | input | `readonly BudgetLine[]` | `[]` | |
2703
+ | `currency` | input | `string` | `'BRL'` | |
2704
+ | `expectedFraction` | input | `number` | `1` | Fração do período já corrida (1 = período fechado). |
2705
+ | `nearAt` | input | `number` | `0.9` | A partir de que fração do orçado avisa "perto do limite". |
2706
+ | `caption` | input | `string` | `''` | |
2707
+ | `hideCaption` | input | `boolean` | `false` | |
2708
+ | `texts` | input | `CatalogOverride<FinanceMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`FINANCE_MESSAGES_PT_BR`). |
2709
+
2710
+ ## `hm-financial-summary`
2711
+
2712
+ `FinancialSummaryComponent` — import de `@trismegisto/angular/finance` (também na raiz)
2713
+
2714
+ Resumo financeiro e KPIs de receita e despesa (`hm-financial-summary`): três `hm-stat-card` (receitas, despesas, resultado com a margem) com a variação contra o período anterior — receita subindo é bom, despesa subindo é ruim — e a comparação receitas × despesas em barras.
2715
+
2716
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2717
+ |---|---|---|---|---|
2718
+ | `revenue` | input (obrigatório) | `number` | | |
2719
+ | `expenses` | input (obrigatório) | `number` | | |
2720
+ | `previousRevenue` | input | `number \| null` | `null` | |
2721
+ | `previousExpenses` | input | `number \| null` | `null` | |
2722
+ | `currency` | input | `string` | `'BRL'` | |
2723
+ | `period` | input | `string` | `''` | Período já escrito ("Outubro de 2026"). |
2724
+ | `heading` | input | `string` | `''` | |
2725
+ | `headingLevel` | input | `2 \| 3 \| 4` | `2` | |
2726
+ | `hideHeading` | input | `boolean` | `false` | |
2727
+ | `showComparison` | input | `boolean` | `true` | |
2728
+ | `compactValues` | input | `boolean` | `false` | Valores em notação compacta ("R$ 120,5 mil"). |
2729
+ | `texts` | input | `CatalogOverride<FinanceMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`FINANCE_MESSAGES_PT_BR`). |
2730
+
2731
+ ## `hm-reconciliation`
2732
+
2733
+ `ReconciliationComponent` — import de `@trismegisto/angular/finance` (também na raiz)
2734
+
2735
+ Conciliação bancária (`hm-reconciliation`): o extrato do banco de um lado, os lançamentos do sistema do outro; escolhe-se um de cada lado (mesmo valor) e "Conciliar selecionados" forma o par. "Sugerir pares" casa sozinho os de mesmo valor com data próxima (`suggestMatches`). Embaixo, os pares conciliados (com desfazer) e os totais com a diferença.
2736
+
2737
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2738
+ |---|---|---|---|---|
2739
+ | `statement` | input | `readonly LedgerEntry[]` | `[]` | Lançamentos do extrato bancário (positivo = entrada). |
2740
+ | `ledger` | input | `readonly LedgerEntry[]` | `[]` | Lançamentos do sistema. |
2741
+ | `matches` | model | `readonly ReconciliationMatch[]` | `[]` | |
2742
+ | `currency` | input | `string` | `'BRL'` | |
2743
+ | `dateToleranceDays` | input | `number` | `3` | Distância máxima de datas para a sugestão. |
2744
+ | `texts` | input | `CatalogOverride<FinanceMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`FINANCE_MESSAGES_PT_BR`). |
2745
+
1217
2746
  ## `hm-floating-window`
1218
2747
 
1219
2748
  `FloatingWindowComponent` — import de `@trismegisto/angular/floating-window` (também na raiz)
@@ -1247,6 +2776,25 @@ Métodos públicos: `bringToFront(): void`
1247
2776
  | `state` | model | `FloatingWindowState` | `'normal'` | Estado de exibição. Two-way. |
1248
2777
  | `closed` | output | `void` | | Fechou pelo X (ou `Esc`, com `closeOnEscape`). |
1249
2778
 
2779
+ ## `hm-form-error-summary`
2780
+
2781
+ `FormErrorSummaryComponent` — import de `@trismegisto/angular/form-error-summary` (também na raiz)
2782
+
2783
+ Resumo de erros do formulário: no topo do formulário, depois de um envio que falhou, a lista de todos os erros, cada um um link que leva o foco ao campo (padrão GOV.UK/WCAG 3.3.1 e 3.3.3).
2784
+
2785
+ Métodos públicos: `focus(): void`, `visit(form, null)`
2786
+
2787
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2788
+ |---|---|---|---|---|
2789
+ | `errors` | input | `readonly FormErrorItem[]` | `[]` | Os erros, na ordem dos campos no formulário. Vazio = o resumo não aparece. |
2790
+ | `heading` | input | `string` | `''` | Título. Vazio = "Corrija N campos para continuar" (plural do catálogo). |
2791
+ | `description` | input | `string` | `''` | Frase opcional sob o título. |
2792
+ | `level` | input | `number` | `2` | Nível do título (`aria-level`), pela hierarquia da página. |
2793
+ | `autoFocus` | input | `boolean` | `true` | Foca o resumo quando a lista passa de vazia a não vazia. |
2794
+ | `scope` | input | `HTMLElement \| null` | `null` | Onde procurar o campo de um `target` que não é id. Padrão: o `<form>` em volta do resumo (ou a página). |
2795
+ | `texts` | input | `Partial<FormErrorSummaryMessages>` | `{}` | Textos próprios (cada chave vence o catálogo do componente). |
2796
+ | `itemClick` | output | `FormErrorItem` | | Um link de erro foi seguido (depois de o foco ir ao campo). |
2797
+
1250
2798
  ## `hm-form-required-hint`
1251
2799
 
1252
2800
  `FormRequiredHintComponent` — import de `@trismegisto/angular/form-required-hint` (também na raiz)
@@ -1258,6 +2806,27 @@ Legenda de obrigatório do formulário ("Campos marcados com “obrigatório”
1258
2806
  | `mark` | input | `string` | `''` | Marca citada na frase. Vazio = `HERMES_MESSAGES.field.required`. |
1259
2807
  | `text` | input | `string` | `''` | Frase inteira. Vazio = `HERMES_MESSAGES.form.requiredHint`. Aceita `{mark}`. |
1260
2808
 
2809
+ ## `hm-gantt`
2810
+
2811
+ `GanttComponent` — import de `@trismegisto/angular/gantt` (também na raiz)
2812
+
2813
+ Gantt de projeto, marcos e roadmap: barras de tarefas numa régua de dias, semanas, meses ou trimestres, com progresso, marcos (losangos), dependências (linhas de fim a início), grupos (fase, épico, equipe) e a linha de hoje.
2814
+
2815
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2816
+ |---|---|---|---|---|
2817
+ | `items` | input (obrigatório) | `readonly GanttItem[]` | | |
2818
+ | `scale` | model | `GanttScale` | `'week'` | Escala da régua. Two-way (o seletor de escala muda). |
2819
+ | `scaleControl` | input | `boolean` | `true` | Mostra o seletor de escala acima. |
2820
+ | `interactive` | input | `boolean` | `false` | Cada barra vira botão e emite `itemClick`. |
2821
+ | `label` | input | `string` | `''` | Nome do cronograma. Vazio = "Cronograma". |
2822
+ | `now` | input | `WorkflowDateValue` | `null` | Fixa o "hoje" (testes, capturas); vazio = data atual. |
2823
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
2824
+ | `editable` | input | `boolean` | `false` | Barras editáveis: arrastar (barra e bordas) e Alt + setas. Emite `taskChange`; não muda `items`. |
2825
+ | `editStep` | input | `number` | `1` | Passo da edição, em dias (1 = dia, 7 = semana). |
2826
+ | `blockConflicts` | input | `boolean` | `false` | Recusa (e anuncia) a edição que quebraria uma dependência fim → início. Sem ele, a mudança sai com `conflicts`. |
2827
+ | `itemClick` | output | `GanttItem` | | |
2828
+ | `taskChange` | output | `GanttTaskChange` | | Intenção de mudar as datas de uma tarefa (`editable`). O app grava e devolve `items` atualizado. |
2829
+
1261
2830
  ## `hm-geometric-texture`
1262
2831
 
1263
2832
  `GeometricTextureComponent` — import de `@trismegisto/angular/geometric-texture` (também na raiz)
@@ -1290,7 +2859,7 @@ Busca global: o mesmo contêiner da `hm-command-palette` (diálogo ancorado no a
1290
2859
 
1291
2860
  `HeaderComponent` — import de `@trismegisto/angular/header` (também na raiz)
1292
2861
 
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).
2862
+ 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, Ctrl/⌘+K em qualquer ponto da página ou `/` fora de um campo).
1294
2863
 
1295
2864
  Slots: `(padrão)`, `[shortcuts]`, `[actions]`
1296
2865
 
@@ -1300,6 +2869,23 @@ Slots: `(padrão)`, `[shortcuts]`, `[actions]`
1300
2869
  | `searchPlaceholder` | input | `string` | `this.#messages.search` | Texto visível dentro do gatilho da busca. |
1301
2870
  | `searchLabel` | input | `string` | `this.#messages.searchLabel` | Nome acessível do gatilho da busca (não há rótulo visível). |
1302
2871
 
2872
+ ## `hm-health-status`
2873
+
2874
+ `HealthStatusComponent` — import de `@trismegisto/angular/health-status` (também na raiz)
2875
+
2876
+ Indicador de saúde de um serviço ou do sistema inteiro: ícone (ou ponto) + o nome do estado do catálogo, na cor do tom de `healthIntent`.
2877
+
2878
+ Slots: `(padrão)`
2879
+
2880
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2881
+ |---|---|---|---|---|
2882
+ | `status` | input | `HealthStatus` | `'unknown'` | Estado a mostrar. No `banner` com `statuses`, é ignorado (vale o pior da lista). |
2883
+ | `statuses` | input | `readonly HealthStatus[] \| null` | `null` | Estados de todos os serviços (só no `banner`). |
2884
+ | `label` | input | `string` | `''` | Texto no lugar do nome do estado. Vazio = catálogo. |
2885
+ | `appearance` | input | `HealthStatusAppearance` | `'badge'` | |
2886
+ | `size` | input | `HealthStatusSize` | `'medium'` | |
2887
+ | `texts` | input | `Partial<MonitoringTextMessages & HealthStatusMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
2888
+
1303
2889
  ## `hm-icon-button`
1304
2890
 
1305
2891
  `IconButtonComponent` — import de `@trismegisto/angular/icon-button` (também na raiz)
@@ -1339,6 +2925,30 @@ Botão só com ícone. O `label` é obrigatório: vira o nome acessível do `<bu
1339
2925
  | `inverse` | input | `boolean` | `false` | |
1340
2926
  | `label` | input | `string` | `''` | Nome acessível. Vazio = decorativo. |
1341
2927
 
2928
+ ## `hm-identity-document-input`
2929
+
2930
+ `IdentityDocumentInputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/identity-document` (também na raiz)
2931
+
2932
+ Campo de documento de identificação de qualquer país registrado (`hm-identity-document-input`): CPF/CNPJ, DNI e CUIT argentinos, RUT chileno, CURP e RFC mexicanos, SSN e EIN americanos, NIF português, DNI/NIE espanhóis... A máscara acompanha o documento (e o tamanho, no RUT), a validação confere o dígito verificador (`validateIdentityDocument`) e o rótulo padrão é o nome do documento ("CUIT/CUIL"…
2933
+
2934
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
2935
+ |---|---|---|---|---|
2936
+ | `value` | model | `string` | `''` | |
2937
+ | `country` | model | `string` | `'BR'` | País do documento (ISO alfa-2). |
2938
+ | `documentType` | model | `string` | `'cpf'` | Tipo do documento (`cpf`, `cuit`, `rut`...). |
2939
+ | `countries` | input | `readonly string[] \| null` | `null` | Países para escolher (mostra o seletor com mais de um). `null`: país fixo. |
2940
+ | `chooseType` | input | `boolean` | `false` | Mostra o seletor de tipo (os documentos do país para `holder`). |
2941
+ | `holder` | input | `IdentityDocumentHolder` | `'any'` | Para quem: pessoa física, jurídica ou ambas (filtra os tipos). |
2942
+ | `label` | input | `string` | `''` | Rótulo do campo. Padrão: o nome do documento. |
2943
+ | `labelHidden` | input | `boolean` | `false` | |
2944
+ | `hint` | input | `string` | `''` | Texto de apoio. Padrão: um exemplo formatado. |
2945
+ | `placeholder` | input | `string` | `''` | |
2946
+ | `texts` | input | `Partial<IdentityDocumentMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
2947
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2948
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2949
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2950
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2951
+
1342
2952
  ## `hm-illustration-attention`
1343
2953
 
1344
2954
  `IllustrationAttentionComponent` — import de `@trismegisto/angular/illustration-attention`
@@ -1461,6 +3071,98 @@ Métodos públicos: `exportImage(options: ImageCropExportOptions = {}): Promise<
1461
3071
  | `failed` | output | `ImageCropError` | | Falha ao carregar (só da carga mais recente). |
1462
3072
  | `exported` | output | `ImageCropResult` | | Com `liveExport`: resultado da última geração automática. |
1463
3073
 
3074
+ ## `hm-image-gallery`
3075
+
3076
+ `ImageGalleryComponent` — import de `@trismegisto/angular/image-gallery` (também na raiz)
3077
+
3078
+ Grade de miniaturas que abrem o `hm-lightbox` (visualização em tela cheia com teclado, zoom e legenda). Cada miniatura é um botão nomeado "Ampliar: <alt>"; ao fechar o lightbox, o foco volta para a miniatura de onde saiu.
3079
+
3080
+ Métodos públicos: `show(index: number): void`
3081
+
3082
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3083
+ |---|---|---|---|---|
3084
+ | `images` | input (obrigatório) | `readonly GalleryImage[]` | | |
3085
+ | `label` | input | `string` | `''` | Nome da lista para leitores de tela (padrão: `gallery.label` do catálogo). |
3086
+ | `aspect` | input | `ImageGalleryAspect` | `'square'` | |
3087
+ | `thumbnailSize` | input | `string` | `''` | |
3088
+ | `showCaptions` | input | `boolean` | `false` | |
3089
+ | `loop` | input | `boolean` | `true` | |
3090
+ | `index` | model | `number` | `0` | Imagem aberta no lightbox (`[(index)]`); muda ao navegar dentro dele. |
3091
+ | `opened` | output | `number` | | Emitido ao abrir uma imagem (índice). |
3092
+ | `texts` | input | `Partial<ImageGalleryMessages>` | `{}` | Textos próprios do componente, por cima do catálogo do idioma ativo (parcial). |
3093
+
3094
+ ## `hm-lightbox`
3095
+
3096
+ `LightboxComponent` — import de `@trismegisto/angular/image-gallery` (também na raiz)
3097
+
3098
+ Visualização de imagem em tela cheia (diálogo modal): uma imagem por vez, com legenda, posição ("Imagem 2 de 8"), anterior/próxima e zoom. Pode ser usado sozinho (`[(open)]`, `[(index)]`) ou pelo `hm-image-gallery`, que o abre ao clicar numa miniatura.
3099
+
3100
+ Métodos públicos: `close(): void`
3101
+
3102
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3103
+ |---|---|---|---|---|
3104
+ | `images` | input (obrigatório) | `readonly GalleryImage[]` | | |
3105
+ | `open` | model | `boolean` | `false` | |
3106
+ | `index` | model | `number` | `0` | Imagem mostrada (0-based). |
3107
+ | `loop` | input | `boolean` | `true` | Da última volta para a primeira (e vice-versa). |
3108
+ | `closed` | output | `void` | | Emitido depois que a pessoa fechou (X, Esc ou clique no fundo). |
3109
+ | `texts` | input | `Partial<ImageGalleryMessages>` | `{}` | Textos próprios do componente, por cima do catálogo do idioma ativo (parcial). |
3110
+
3111
+ ## `hm-incident-card`
3112
+
3113
+ `IncidentCardComponent` — import de `@trismegisto/angular/incident` (também na raiz)
3114
+
3115
+ Cartão de incidente (`hm-incident-card`): severidade e status em selo (ícone + texto), id, título, serviço afetado, responsável (avatar + nome, ou "Sem responsável"), início e duração, e as ações que o estado atual aceita (`incidentActions`). Só apresenta: cada ação sai por `(action)` com o tipo e o app decide.
3116
+
3117
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3118
+ |---|---|---|---|---|
3119
+ | `incident` | input (obrigatório) | `Incident` | | |
3120
+ | `now` | input | `number \| null` | `null` | "Agora" da duração (ms). `null` = hora do cálculo. |
3121
+ | `headingLevel` | input | `IncidentHeadingLevel, unknown` | `3` | Nível do título (padrão 3; `0` = parágrafo). |
3122
+ | `href` | input | `string` | `''` | Link do detalhe; vazio = título só texto. |
3123
+ | `actions` | input | `boolean` | `true` | Mostra as ações do estado atual. |
3124
+ | `action` | output | `IncidentAction` | | Ação pedida pela pessoa. |
3125
+ | `texts` | input | `Partial<IncidentMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
3126
+
3127
+ ## `hm-incident-severity`
3128
+
3129
+ `IncidentSeverityComponent` — import de `@trismegisto/angular/incident` (também na raiz)
3130
+
3131
+ Selo de severidade (`hm-incident-severity`): ícone + texto no tom de `incidentSeverityIntent`. A forma do ícone muda com a severidade (não só a cor) e o leitor de tela ouve "Severidade Crítica".
3132
+
3133
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3134
+ |---|---|---|---|---|
3135
+ | `severity` | input (obrigatório) | `IncidentSeverity` | | |
3136
+
3137
+ ## `hm-incident-status`
3138
+
3139
+ `IncidentStatusComponent` — import de `@trismegisto/angular/incident` (também na raiz)
3140
+
3141
+ Selo do estado de um incidente (`hm-incident-status`): ícone + texto no tom de `incidentStatusIntent`; o leitor de tela ouve "Status Investigando".
3142
+
3143
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3144
+ |---|---|---|---|---|
3145
+ | `status` | input (obrigatório) | `IncidentStatus` | | |
3146
+
3147
+ ## `hm-incident-detail`
3148
+
3149
+ `IncidentDetailComponent` — import de `@trismegisto/angular/incident` (também na raiz)
3150
+
3151
+ Detalhe de um incidente (`hm-incident-detail`): cabeçalho com severidade, status e id; título; serviço, início e duração; o campo de atribuição (escolhe um dos `responders` e emite `assign` com o id); as ações do estado atual (`incidentActions`, menos `assign`, que já é o campo); resumo e impacto; e a linha do tempo das atualizações, da mais recente para a mais antiga, com o formulário opcional d…
3152
+
3153
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3154
+ |---|---|---|---|---|
3155
+ | `incident` | input (obrigatório) | `Incident` | | |
3156
+ | `updates` | input | `readonly IncidentUpdate[]` | `[]` | Atualizações em qualquer ordem; são mostradas da mais recente para a mais antiga. |
3157
+ | `responders` | input | `readonly IncidentPerson[]` | `[]` | Quem pode assumir o incidente; vazio = sem campo de atribuição. |
3158
+ | `now` | input | `number \| null` | `null` | "Agora" da duração (ms). `null` = hora do cálculo. |
3159
+ | `headingLevel` | input | `Exclude<IncidentHeadingLevel, 0>, unknown` | `2` | Nível do título (padrão 2); as seções ficam um nível abaixo. |
3160
+ | `postable` | input | `boolean` | `false` | Mostra o formulário de nova atualização. |
3161
+ | `texts` | input | `Partial<IncidentMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
3162
+ | `action` | output | `IncidentAction` | | Ação pedida (reconhecer, escalar, resolver, reabrir). |
3163
+ | `assign` | output | `string` | | Id da pessoa escolhida no campo de atribuição. |
3164
+ | `post` | output | `string` | | Texto da nova atualização (sem espaços nas pontas). |
3165
+
1464
3166
  ## `hm-input`
1465
3167
 
1466
3168
  `InputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/input` (também na raiz)
@@ -1495,6 +3197,101 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
1495
3197
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
1496
3198
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
1497
3199
 
3200
+ ## `hm-connected-account`
3201
+
3202
+ `ConnectedAccountComponent` — import de `@trismegisto/angular/integration` (também na raiz)
3203
+
3204
+ A conta conectada a uma integração (`hm-connected-account`): avatar, nome, e-mail, "Conectada desde", **Desconectar** com confirmação e **Reconectar** quando a autorização expirou.
3205
+
3206
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3207
+ |---|---|---|---|---|
3208
+ | `account` | input (obrigatório) | `ConnectedAccountInfo` | | |
3209
+ | `integrationName` | input | `string` | `''` | Nome da integração, usado no título da confirmação ("Desconectar Slack?"). |
3210
+ | `confirmDisconnect` | input | `boolean` | `true` | Pergunta antes de desconectar. |
3211
+ | `busy` | input | `boolean` | `false` | Trava os botões (operação em andamento). |
3212
+ | `timeZone` | input | `string \| undefined` | `undefined` | Fuso para a data (padrão: o do navegador). |
3213
+ | `disconnect` | output | `void` | | |
3214
+ | `reconnect` | output | `void` | | |
3215
+ | `texts` | input | `Partial<IntegrationMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
3216
+
3217
+ ## `hm-integration-card`
3218
+
3219
+ `IntegrationCardComponent` — import de `@trismegisto/angular/integration` (também na raiz)
3220
+
3221
+ Cartão de uma integração do catálogo (`hm-integration-card`): logo (slot `[logo]`, ou o `icon` do item), nome, fornecedor, descrição, categoria, selos, o estado em texto e as ações.
3222
+
3223
+ Slots: `[logo]`
3224
+
3225
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3226
+ |---|---|---|---|---|
3227
+ | `integration` | input (obrigatório) | `IntegrationItem` | | |
3228
+ | `headingLevel` | input | `IntegrationHeadingLevel` | `3` | Nível do título (`aria-level`). |
3229
+ | `actions` | input | `boolean` | `true` | Esconde as ações (cartão só informativo). |
3230
+ | `statusLabel` | input | `string` | `''` | Texto no lugar do estado do catálogo, para quando o app não sabe se a conexão está de pé ("Cadastrada"). |
3231
+ | `logoTemplate` | input | `TemplateRef<{ readonly $implicit: IntegrationItem }> \| null` | `null` | Logo por template (`let-item`), usado pelo catálogo; tem prioridade sobre o slot `[logo]`. |
3232
+ | `connect` | output | `IntegrationItem` | | |
3233
+ | `disconnect` | output | `IntegrationItem` | | |
3234
+ | `configure` | output | `IntegrationItem` | | |
3235
+ | `texts` | input | `Partial<IntegrationMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
3236
+
3237
+ ## `hm-integration-catalog`
3238
+
3239
+ `IntegrationCatalogComponent` — import de `@trismegisto/angular/integration` (também na raiz)
3240
+
3241
+ Catálogo de integrações (`hm-integration-catalog`): busca, filtro por categoria, "só as conectadas", a grade de `hm-integration-card` e o estado vazio. Repassa as intenções dos cartões.
3242
+
3243
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3244
+ |---|---|---|---|---|
3245
+ | `integrations` | input | `readonly IntegrationItem[]` | `[]` | |
3246
+ | `query` | model | `string` | `''` | Texto da busca. Two-way. |
3247
+ | `category` | model | `string \| null` | `null` | Categoria escolhida (`null` = todas). Two-way. |
3248
+ | `connectedOnly` | model | `boolean` | `false` | Só as que não estão desconectadas. Two-way. |
3249
+ | `headingLevel` | input | `IntegrationHeadingLevel` | `3` | Nível do título de cada cartão. |
3250
+ | `logoTemplate` | input | `TemplateRef<IntegrationLogoContext> \| null` | `null` | Template do logo de cada cartão (`let-item`). |
3251
+ | `connect` | output | `IntegrationItem` | | |
3252
+ | `disconnect` | output | `IntegrationItem` | | |
3253
+ | `configure` | output | `IntegrationItem` | | |
3254
+ | `texts` | input | `Partial<IntegrationMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
3255
+
3256
+ ## `hm-integration-detail`
3257
+
3258
+ `IntegrationDetailComponent` — import de `@trismegisto/angular/integration` (também na raiz)
3259
+
3260
+ Página/painel de uma integração (`hm-integration-detail`): cabeçalho com logo (slot `[logo]`), nome, fornecedor e estado; a conta conectada (`hm-connected-account`); as permissões pedidas; as ações; e o conteúdo projetado (as configurações próprias da integração) por último.
3261
+
3262
+ Slots: `[logo]`, `(padrão)`
3263
+
3264
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3265
+ |---|---|---|---|---|
3266
+ | `integration` | input (obrigatório) | `IntegrationItem` | | |
3267
+ | `permissions` | input | `readonly IntegrationPermission[]` | `[]` | |
3268
+ | `account` | input | `ConnectedAccountInfo \| null` | `null` | Conta ligada; `null` = nenhuma (a seção some). |
3269
+ | `headingLevel` | input | `IntegrationDetailHeadingLevel` | `2` | |
3270
+ | `busy` | input | `boolean` | `false` | Trava as ações. |
3271
+ | `timeZone` | input | `string \| undefined` | `undefined` | Fuso da data da conta. |
3272
+ | `connect` | output | `IntegrationItem` | | |
3273
+ | `disconnect` | output | `IntegrationItem` | | |
3274
+ | `configure` | output | `IntegrationItem` | | |
3275
+ | `texts` | input | `Partial<IntegrationMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
3276
+
3277
+ ## `hm-invoice`
3278
+
3279
+ `InvoiceComponent` — import de `@trismegisto/angular/invoice` (também na raiz)
3280
+
3281
+ Fatura (`hm-invoice`): número, situação (uma fatura em aberto com vencimento passado aparece como vencida), emissão e vencimento com a contagem de dias, emitente e cliente, a tabela de itens, os totais (`computeInvoiceTotals`) e as ações "Pagar fatura" e "Baixar PDF".
3282
+
3283
+ Slots: `(padrão)`
3284
+
3285
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3286
+ |---|---|---|---|---|
3287
+ | `invoice` | input (obrigatório) | `InvoiceInfo` | | |
3288
+ | `headingLevel` | input | `1 \| 2 \| 3 \| 4` | `2` | |
3289
+ | `downloadable` | input | `boolean` | `true` | |
3290
+ | `now` | input | `Date \| null` | `null` | Data de referência para vencida/dias até vencer (padrão: hoje). |
3291
+ | `pay` | output | `void` | | |
3292
+ | `download` | output | `void` | | |
3293
+ | `texts` | input | `CatalogOverride<InvoiceMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`INVOICE_MESSAGES_PT_BR`). |
3294
+
1498
3295
  ## `hm-item-group`
1499
3296
 
1500
3297
  `ItemGroupComponent` — import de `@trismegisto/angular/item` (também na raiz)
@@ -1529,6 +3326,23 @@ Slots: `[itemHeader]`, `[itemActions]`, `[itemFooter]`, `[itemMedia]`, `[itemTit
1529
3326
  | `disabled` | input | `boolean` | `false` | Desabilita a linha clicável (`clickable`). Link não tem estado desabilitado. |
1530
3327
  | `clicked` | output | `void` | | Clique na linha (com `clickable` ou `link`). Não dispara pelos controles de `[itemActions]`. |
1531
3328
 
3329
+ ## `hm-json-viewer`
3330
+
3331
+ `JsonViewerComponent` — import de `@trismegisto/angular/json-viewer` (também na raiz)
3332
+
3333
+ Visualizador de JSON em árvore, só leitura: objetos e arrays recolhem e expandem, cada valor aparece com a cor do tipo e o nó em foco pode ter o caminho (`$.users[0].name`) ou o valor (JSON indentado) copiado pelos botões do topo ou com Ctrl+C. A busca procura em chaves e valores (sem caixa nem acento), abre o caminho até cada resultado e anda entre eles.
3334
+
3335
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3336
+ |---|---|---|---|---|
3337
+ | `data` | input (obrigatório) | `unknown` | | O valor exibido (objeto, array ou primitivo). |
3338
+ | `label` | input | `string` | `''` | Nome da árvore para leitores de tela (padrão: `jsonViewer.label` do catálogo). |
3339
+ | `expandDepth` | input | `number` | `1` | Níveis abertos ao receber dados novos (0 = tudo recolhido). |
3340
+ | `searchable` | input | `boolean` | `true` | Mostra a busca no topo. |
3341
+ | `copyable` | input | `boolean` | `true` | Mostra os botões de copiar caminho e valor. |
3342
+ | `pageSize` | input | `number` | `JSON_TREE_PAGE_SIZE` | Filhos exibidos por pai antes do "mostrar mais". |
3343
+ | `rootName` | input | `string` | `'$'` | Raiz do caminho copiado. |
3344
+ | `texts` | input | `Partial<JsonViewerMessages>` | `{}` | Textos próprios do componente, por cima do catálogo do idioma ativo (parcial). |
3345
+
1532
3346
  ## `hm-kanban-column`
1533
3347
 
1534
3348
  `KanbanColumnComponent` — import de `@trismegisto/angular/kanban` (também na raiz)
@@ -1555,6 +3369,30 @@ Ações no cabeçalho de cada coluna (`<ng-template hmKanbanColumnActions let-co
1555
3369
 
1556
3370
  _Sem inputs/outputs._
1557
3371
 
3372
+ ## `ng-template[hmKanbanColumnEmpty]`
3373
+
3374
+ `KanbanColumnEmptyDirective` — import de `@trismegisto/angular/kanban` (também na raiz)
3375
+
3376
+ Conteúdo da coluna sem cartões (`<ng-template hmKanbanColumnEmpty let-column>`), no lugar do texto padrão do catálogo. Continua dentro da lista (soltar ali funciona) e se esconde enquanto um cartão paira sobre ela.
3377
+
3378
+ _Sem inputs/outputs._
3379
+
3380
+ ## `ng-template[hmKanbanColumnFooter]`
3381
+
3382
+ `KanbanColumnFooterDirective` — import de `@trismegisto/angular/kanban` (também na raiz)
3383
+
3384
+ Rodapé de cada coluna, depois dos cartões (`<ng-template hmKanbanColumnFooter let-column>`): o lugar do "+ Criar" e da criação rápida do app. Fica fora da lista (não é área de soltar) e some com a coluna recolhida.
3385
+
3386
+ _Sem inputs/outputs._
3387
+
3388
+ ## `ng-template[hmKanbanColumnSummary]`
3389
+
3390
+ `KanbanColumnSummaryDirective` — import de `@trismegisto/angular/kanban` (também na raiz)
3391
+
3392
+ Linha logo abaixo do cabeçalho de cada coluna (`<ng-template hmKanbanColumnSummary let-column>`): resumo do app ("mais antigo há 3 dias", "2 vencidos"). Some com a coluna recolhida.
3393
+
3394
+ _Sem inputs/outputs._
3395
+
1558
3396
  ## `hm-kanban`
1559
3397
 
1560
3398
  `KanbanComponent` — import de `@trismegisto/angular/kanban` (também na raiz)
@@ -1563,7 +3401,7 @@ Quadro kanban genérico: colunas com cartões que se movem entre colunas e se re
1563
3401
 
1564
3402
  Slots: `[hmKanbanToolbar]`, `(padrão)`
1565
3403
 
1566
- Métodos públicos: `cardTemplate(): TemplateRef<KanbanCardContext<T>> \| null`, `actionsTemplate(): TemplateRef<KanbanColumnContext<T>> \| null`, `isCollapsed(id: string): boolean`, `toggleCollapsed(id: string): void`, `key(item: T): unknown`, `labelOf(item: T): string`, `allows(data: unknown, type: string, to: string): boolean`, `handleSorted(to: string, event: HermesSortEvent<T>): void`
3404
+ Métodos públicos: `cardTemplate(): TemplateRef<KanbanCardContext<T>> \| null`, `actionsTemplate(): TemplateRef<KanbanColumnContext<T>> \| null`, `summaryTemplate(): TemplateRef<KanbanColumnContext<T>> \| null`, `footerTemplate(): TemplateRef<KanbanColumnContext<T>> \| null`, `emptyTemplate(): TemplateRef<KanbanColumnContext<T>> \| null`, `isCollapsed(id: string): boolean`, `toggleCollapsed(id: string): void`, `key(item: T): unknown`, `labelOf(item: T): string`, `zoneLabel(column: KanbanColumn<T>): string`, `allows(data: unknown, type: string, to: string): boolean`, `handleSorted(to: string, event: HermesSortEvent<T>): void`
1567
3405
 
1568
3406
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1569
3407
  |---|---|---|---|---|
@@ -1576,7 +3414,11 @@ Métodos públicos: `cardTemplate(): TemplateRef<KanbanCardContext<T>> \| null`,
1576
3414
  | `collapsible` | input | `boolean` | `true` | Mostra o botão de recolher nas colunas. |
1577
3415
  | `headingLevel` | input | `number` | `3` | Nível do título de cada coluna (`aria-level`). |
1578
3416
  | `disabled` | input | `boolean` | `false` | Somente leitura: nada se arrasta. |
3417
+ | `dragGroup` | input | `string \| null` | `null` | Quadros com o mesmo grupo trocam cartões entre si (ver `canReceive`/`received`). `null` = só os próprios. |
3418
+ | `canReceive` | input | `((item: T, to: KanbanColumn<T>) => boolean) \| null` | `null` | Um cartão de outro quadro do grupo pode cair na coluna `to`? `null` = nenhum pode. |
3419
+ | `columnLabel` | input | `((column: KanbanColumn<T>) => string) \| null` | `null` | Nome falado de cada coluna como destino do arrasto. Padrão: o título. |
1579
3420
  | `moved` | output | `KanbanMoveEvent<T>` | | Um cartão mudou de lugar (já aplicado em `columns`). |
3421
+ | `received` | output | `KanbanReceiveEvent<T>` | | Um cartão de outro quadro do `dragGroup` caiu aqui (NÃO aplicado em `columns`). |
1580
3422
 
1581
3423
  ## `hm-legend`
1582
3424
 
@@ -1591,6 +3433,37 @@ Legenda: o que cada cor quer dizer, em texto. Lista nomeada; o marcador é só d
1591
3433
  | `marker` | input | `LegendMarker` | `'dot'` | |
1592
3434
  | `label` | input | `string` | `''` | Nome da lista para leitor de tela; vazio usa o texto do catálogo ("Legenda"). |
1593
3435
 
3436
+ ## `hm-level-badge`
3437
+
3438
+ `LevelBadgeComponent` — import de `@trismegisto/angular/level-badge` (também na raiz)
3439
+
3440
+ Selo de um nível numa escala ordenada: prioridade, severidade, criticidade, urgência, impacto, probabilidade ou risco (as escalas prontas) ou uma escala do app.
3441
+
3442
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3443
+ |---|---|---|---|---|
3444
+ | `scale` | input (obrigatório) | `LevelScaleInput` | | |
3445
+ | `value` | input | `string \| null \| undefined` | `null` | |
3446
+ | `compact` | input | `boolean` | `false` | Só as barras; o nome vai para a dica e para o leitor de tela. |
3447
+ | `showScale` | input | `boolean` | `false` | Escreve o nome da escala antes do nível ("Prioridade: Alta"). |
3448
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
3449
+
3450
+ ## `hm-level-select`
3451
+
3452
+ `LevelSelectComponent` — import de `@trismegisto/angular/level-badge` (também na raiz)
3453
+
3454
+ Seletor de nível numa escala (prioridade, severidade, criticidade, urgência, impacto, probabilidade, risco ou uma escala do app).
3455
+
3456
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3457
+ |---|---|---|---|---|
3458
+ | `scale` | input (obrigatório) | `LevelScaleInput` | | |
3459
+ | `value` | model | `string \| null` | `null` | Valor do nível (`LevelOption.value`); `''`/`null` = não definido. Two-way. |
3460
+ | `label` | input | `string` | `''` | Rótulo do campo. Vazio = nome da escala. |
3461
+ | `hint` | input | `string` | `''` | |
3462
+ | `appearance` | input | `LevelSelectAppearance` | `'select'` | |
3463
+ | `allowEmpty` | input | `boolean` | `false` | |
3464
+ | `disabled` | input | `boolean` | `false` | |
3465
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
3466
+
1594
3467
  ## `hm-list-editor`
1595
3468
 
1596
3469
  `ListEditorComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/list-editor` (também na raiz)
@@ -1637,6 +3510,110 @@ Spinner de carregamento; segue a cor de ação do tema (`--hm-action`). Estilo e
1637
3510
 
1638
3511
  _Sem inputs/outputs._
1639
3512
 
3513
+ ## `hm-location-select`
3514
+
3515
+ `LocationSelectComponent` — import de `@trismegisto/angular/location-select` (também na raiz)
3516
+
3517
+ Seletores encadeados país → estado → cidade (`hm-location-select`), cada um um `hm-combobox` com filtro por digitação. Os dados chegam prontos por input (`countries`, `states`, `cities`) e o componente avisa a escolha de cada nível por `[(country)]`, `[(state)]`, `[(city)]`: o app carrega o nível seguinte (de uma API, das malhas embutidas do `@trismegisto/maps`...) e liga `statesLoading`/`citiesL…
3518
+
3519
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3520
+ |---|---|---|---|---|
3521
+ | `countries` | input | `readonly LocationOption[]` | `[]` | |
3522
+ | `states` | input | `readonly LocationOption[]` | `[]` | |
3523
+ | `cities` | input | `readonly LocationOption[]` | `[]` | |
3524
+ | `country` | model | `string` | `''` | País escolhido (`code`). |
3525
+ | `state` | model | `string` | `''` | Estado escolhido (`code`). |
3526
+ | `city` | model | `string` | `''` | Cidade escolhida (`code`). |
3527
+ | `countriesLoading` | input | `boolean` | `false` | |
3528
+ | `statesLoading` | input | `boolean` | `false` | |
3529
+ | `citiesLoading` | input | `boolean` | `false` | |
3530
+ | `levels` | input | `readonly LocationLevel[]` | `['country', 'state', 'city']` | Níveis mostrados, de cima para baixo. |
3531
+ | `required` | input | `boolean` | `false` | |
3532
+ | `disabled` | input | `boolean` | `false` | |
3533
+ | `label` | input | `string` | `''` | Nome do grupo. Padrão: "Localidade". |
3534
+ | `texts` | input | `Partial<LocationSelectMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
3535
+
3536
+ ## `hm-log-viewer`
3537
+
3538
+ `LogViewerComponent` — import de `@trismegisto/angular/log-viewer` (também na raiz)
3539
+
3540
+ Visualizador de logs: uma linha por entrada (número, horário, nível, origem, mensagem), filtro por nível e por texto, e "seguir o fim" — com ele ligado, cada entrada nova rola até o fim; rolar para cima desliga sozinho e um botão "N linhas novas" volta ao fim. A lista é sempre virtual (só o visível + folga no DOM), com a mesma janela do `hm-code-viewer` (`codeVirtualLayout`), então aguenta dezena…
3541
+
3542
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3543
+ |---|---|---|---|---|
3544
+ | `entries` | input | `readonly LogEntry[]` | `[]` | Entradas, na ordem (a mais nova no fim). |
3545
+ | `text` | input | `string` | `''` | Texto cru, uma entrada por linha. Quando preenchido, vale no lugar de `entries`. |
3546
+ | `label` | input | `string` | `''` | Nome da região para leitores de tela (padrão: `logViewer.label` do catálogo). |
3547
+ | `height` | input | `string` | `''` | Altura da área rolável (qualquer comprimento CSS; padrão do tema). |
3548
+ | `follow` | model | `boolean` | `true` | Seguir o fim (`[(follow)]`). |
3549
+ | `levels` | model | `readonly LogLevel[]` | `LOG_LEVELS` | Níveis exibidos (`[(levels)]`). |
3550
+ | `filter` | model | `string` | `''` | Texto do filtro (`[(filter)]`). |
3551
+ | `toolbar` | input | `boolean` | `true` | Mostra a barra com níveis, filtro, seguir e copiar. |
3552
+ | `wrap` | input | `boolean` | `false` | Quebra as linhas longas em vez de rolar na horizontal. |
3553
+ | `showTimestamps` | input | `boolean` | `true` | |
3554
+ | `showSource` | input | `boolean` | `true` | |
3555
+ | `showLineNumbers` | input | `boolean` | `true` | |
3556
+ | `timeFormat` | input | `Intl.DateTimeFormatOptions` | `{ hour: '2-digit', minute: '2-digit', second: '2-…` | Formato do horário (`Intl.DateTimeFormat`). |
3557
+ | `texts` | input | `Partial<LogViewerMessages>` | `{}` | Textos próprios do componente, por cima do catálogo do idioma ativo (parcial). |
3558
+
3559
+ ## `hm-maintenance-window`
3560
+
3561
+ `MaintenanceWindowComponent` — import de `@trismegisto/angular/maintenance-window` (também na raiz)
3562
+
3563
+ Cartão de uma janela de manutenção: título, início e fim (no idioma do `HermesI18nService`), o estado (agendada, em andamento, concluída, cancelada — `maintenanceState`), o progresso enquanto ela corre, os serviços afetados e as ações de editar/cancelar, que só emitem a intenção.
3564
+
3565
+ Slots: `(padrão)`
3566
+
3567
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3568
+ |---|---|---|---|---|
3569
+ | `heading` | input (obrigatório) | `string` | | Título da manutenção ("Troca do banco de dados"). |
3570
+ | `headingLevel` | input | `MaintenanceWindowHeadingLevel` | `3` | `0`: título é só texto em destaque; `2`–`6` (padrão `3`): título com esse nível. |
3571
+ | `start` | input (obrigatório) | `number` | | Início (ms desde a época). |
3572
+ | `end` | input (obrigatório) | `number` | | Fim (ms desde a época). |
3573
+ | `cancelled` | input | `boolean` | `false` | |
3574
+ | `description` | input | `string` | `''` | |
3575
+ | `services` | input | `readonly string[]` | `[]` | Nomes dos serviços afetados. |
3576
+ | `now` | input | `number \| null` | `null` | Instante de referência (ms); `null` = agora. |
3577
+ | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | Opções do `Intl.DateTimeFormat` de início e fim (inclusive `timeZone`). |
3578
+ | `editable` | input | `boolean` | `false` | Mostra "Editar". |
3579
+ | `cancellable` | input | `boolean` | `false` | Mostra "Cancelar manutenção". |
3580
+ | `texts` | input | `Partial<MonitoringTextMessages & MaintenanceWindowMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
3581
+ | `edit` | output | `void` | | |
3582
+ | `cancel` | output | `void` | | |
3583
+
3584
+ ## `hm-member-list`
3585
+
3586
+ `MemberListComponent` — import de `@trismegisto/angular/member-list` (também na raiz)
3587
+
3588
+ Lista de membros de um recurso (projeto, grupo, pasta): busca por nome ou e-mail, paginação, papel de cada um e, com `editable`, troca de papel e remoção.
3589
+
3590
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3591
+ |---|---|---|---|---|
3592
+ | `members` | input (obrigatório) | `readonly PeopleMember[]` | | |
3593
+ | `roles` | input | `readonly PeopleRole[]` | `[]` | Papéis atribuíveis (nome do selo e opções do seletor). |
3594
+ | `label` | input | `string` | `''` | Nome da lista. Vazio = "Membros". |
3595
+ | `pageSize` | input | `number` | `10` | |
3596
+ | `searchable` | input | `boolean` | `true` | |
3597
+ | `editable` | input | `boolean` | `false` | Seletor de papel e botão de remover em cada linha (menos do dono). |
3598
+ | `invitable` | input | `boolean` | `false` | Botão "Convidar pessoas" ao lado da busca. |
3599
+ | `roleChange` | output | `MemberRoleChange` | | |
3600
+ | `remove` | output | `PeopleMember` | | |
3601
+ | `invite` | output | `void` | | |
3602
+ | `texts` | input | `Partial<MemberListMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
3603
+
3604
+ ## `hm-mention-text`
3605
+
3606
+ `MentionTextComponent` — import de `@trismegisto/angular/mention-text` (também na raiz)
3607
+
3608
+ Texto já enviado com as menções destacadas: `@Ana Souza` de quem está em `candidates` vira um realce; o resto fica como veio (texto puro, nunca HTML).
3609
+
3610
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3611
+ |---|---|---|---|---|
3612
+ | `text` | input (obrigatório) | `string` | | |
3613
+ | `candidates` | input | `readonly MentionCandidate[]` | `[]` | |
3614
+ | `trigger` | input | `string` | `'@'` | |
3615
+ | `highlightId` | input | `string \| null` | `null` | Id de quem lê: as menções a essa pessoa ganham ênfase. |
3616
+
1640
3617
  ## `hm-menu-button`
1641
3618
 
1642
3619
  `MenuButtonComponent` — import de `@trismegisto/angular/menu-button` (também na raiz)
@@ -1677,6 +3654,7 @@ Métodos públicos: `openAt(x: number, y: number): boolean`, `close(): void`
1677
3654
  | `hmContextMenuLayer` | input | `'default' \| 'above-invoker'` | `'default'` | Ver `hm-menu`: `above-invoker` quando o host está dentro de um overlay (ex.: modal). |
1678
3655
  | `hmContextMenuCloseOnCheck` | input | `boolean` | `false` | Ver `hm-menu`: fecha ao marcar um item `checkbox`/`radio` (padrão: continua aberto). |
1679
3656
  | `chosen` | output | `string` | | Id do item escolhido. |
3657
+ | `closed` | output | `void` | | O menu fechou (escolha, Esc, Tab ou clique fora). |
1680
3658
  | `checkedChange` | output | `MenuItemChange` | | Um item `checkbox`/`radio` foi marcado/desmarcado (ver `hm-menu`). |
1681
3659
 
1682
3660
  ## `hm-menu`
@@ -1728,6 +3706,7 @@ Slots: `(padrão)`
1728
3706
  | `label` | input | `string` | `''` | Texto do divisor. Conteúdo projetado também vale (um `<time>`, um link). |
1729
3707
  | `icon` | input | `string` | `''` | Ícone antes do texto (decorativo; o app registra). |
1730
3708
  | `variant` | input | `MessageDividerVariant` | `'separator'` | |
3709
+ | `live` | input | `boolean` | `false` | Algo em andamento: troca o ícone por um spinner, o texto ganha brilho e as mudanças são anunciadas. |
1731
3710
 
1732
3711
  ## `hm-message-scroller`
1733
3712
 
@@ -1737,7 +3716,7 @@ Contêiner de uma conversa: rola, acompanha o fim quando chegam mensagens e carr
1737
3716
 
1738
3717
  Slots: `(padrão)`
1739
3718
 
1740
- Métodos públicos: `scrollToEnd(behavior: ScrollBehavior = 'auto'): void`, `announce(message: string): void`
3719
+ Métodos públicos: `scrollToEnd(behavior: ScrollBehavior = 'auto'): void`, `scrollToMessage(id: string, behavior: ScrollBehavior = 'auto'): boolean`, `announce(message: string): void`
1741
3720
 
1742
3721
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
1743
3722
  |---|---|---|---|---|
@@ -1771,6 +3750,28 @@ Slots: `(padrão)`, `[hmMessageActions]`
1771
3750
  | `status` | input | `MessageStatus \| null` | `null` | Estado de envio no rodapé; `null` = nenhum. |
1772
3751
  | `announce` | input | `boolean` | `true` | Entra no anúncio (e na contagem) de mensagem nova do `hm-message-scroller`. Desligue no indicador de digitação e em mensagens que não são novidade. As `end` (e… |
1773
3752
  | `retry` | output | `void` | | "Tentar de novo" do estado `failed`. |
3753
+ | `reactions` | input | `readonly MessageReaction[]` | `[]` | Reações já recebidas. Vazio (padrão) = sem barra de reações. |
3754
+ | `reactionChoices` | input | `readonly (string \| MessageReactionChoice)[]` | `[]` | Emojis do seletor "Adicionar reação" (texto ou `{ emoji, label }`). Vazio = sem o botão. |
3755
+ | `texts` | input | `Partial<ReactionsMessages>` | `{}` | Sobrescrita parcial dos textos das reações. |
3756
+ | `reactionToggle` | output | `MessageReactionChoice` | | Quem lê clicou numa reação (inverter a dele). |
3757
+
3758
+ ## `hm-metric-explorer`
3759
+
3760
+ `MetricExplorerComponent` — import de `@trismegisto/angular/metric-explorer` (também na raiz)
3761
+
3762
+ Explorador de métricas (`hm-metric-explorer`): barra de consulta (métrica, agregação, agrupar por e intervalo com atalhos 15 min / 1 h / 24 h / 7 d) em `[(query)]`, o gráfico como slot (`[chart]`, desenhado pelo app — com `@trismegisto/charts` ou o que quiser), o resumo de cada série (mínimo, máximo, média e p95, via `aggregateMetric`) e a tabela de dados equivalente ao gráfico, recolhível.
3763
+
3764
+ Slots: `[chart]`
3765
+
3766
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3767
+ |---|---|---|---|---|
3768
+ | `metrics` | input | `readonly MetricExplorerOption[]` | `[]` | |
3769
+ | `groupOptions` | input | `readonly MetricExplorerOption[]` | `[]` | Dimensões para agrupar (host, região...); vazio = sem o campo. |
3770
+ | `query` | model | `MetricQuery` | `{ metric: '', aggregation: 'avg', groupBy: null,…` | A consulta (two-way: `queryChange` a cada campo). |
3771
+ | `series` | input | `readonly MetricSeries[]` | `[]` | Séries da consulta atual, devolvidas pelo app. |
3772
+ | `unit` | input | `string` | `''` | Unidade dos valores; vazio = a da métrica escolhida. |
3773
+ | `label` | input | `string` | `''` | Nome da barra de consulta. Vazio = catálogo. |
3774
+ | `texts` | input | `Partial<MetricExplorerMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
1774
3775
 
1775
3776
  ## `hm-modal`
1776
3777
 
@@ -1790,6 +3791,28 @@ Slots: `(padrão)`, `[footer]`
1790
3791
  | `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`… |
1791
3792
  | `closed` | output | `void` | | Emitido depois que a pessoa fechou pelo X ou pelo `Esc` (já com `open` em `false`). |
1792
3793
 
3794
+ ## `hm-month-picker`
3795
+
3796
+ `MonthPickerComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/month-picker` (também na raiz)
3797
+
3798
+ Campo de mês/ano (competência, validade de cartão, mês de referência). Digita-se `mm/aaaa` (a ordem e o separador seguem o idioma; a máscara põe o separador) ou escolhe-se na grade de meses do `hm-calendar` (`pickLevel="month"`: ano no cabeçalho, setas trocam o ano, o título abre a página de anos). O VALOR é ISO `AAAA-MM`, o mesmo do `<input type="month">`; com `valueFormat="first-day"`, `AAAA-MM…
3799
+
3800
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3801
+ |---|---|---|---|---|
3802
+ | `value` | model | `string \| null` | `null` | |
3803
+ | `label` | input (obrigatório) | `string` | | |
3804
+ | `labelHidden` | input | `boolean` | `false` | |
3805
+ | `hint` | input | `string` | `''` | |
3806
+ | `placeholder` | input | `string` | `''` | |
3807
+ | `min` | input | `string \| number \| null \| undefined` | `null` | Primeiro mês aceito (`AAAA-MM` ou uma data ISO — vale o mês dela). Número é ignorado: é o que o `[formField]` do Signal Forms liga aqui (o `min()` numérico del… |
3808
+ | `max` | input | `string \| number \| null \| undefined` | `null` | Último mês aceito (`AAAA-MM` ou uma data ISO); número é ignorado, como no `min`. |
3809
+ | `valueFormat` | input | `MonthValueFormat` | `'month'` | |
3810
+ | `texts` | input | `Partial<MonthPickerMessages>` | `{}` | Textos próprios (sobrescrevem os do catálogo da peça, por chave). |
3811
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
3812
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
3813
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
3814
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
3815
+
1793
3816
  ## `hm-animated-number`
1794
3817
 
1795
3818
  `AnimatedNumberComponent` — import de `@trismegisto/angular/motion` (também na raiz)
@@ -1833,6 +3856,19 @@ Métodos públicos: `reveal(): void`
1833
3856
  | `hmRevealOnce` | input | `boolean` | `true` | `false` esconde de novo ao sair da vista (revela a cada passagem). |
1834
3857
  | `revealed` | output | `void` | | Emite quando o bloco é revelado. |
1835
3858
 
3859
+ ## `hm-navigation-menu-group`
3860
+
3861
+ `NavigationMenuGroupComponent` — import de `@trismegisto/angular/navigation-menu` (também na raiz)
3862
+
3863
+ Grupo de links com título dentro do painel de um `hm-navigation-menu-item` — a coluna de um "mega menu". Combine com `wide` e `columns` no item para pôr os grupos lado a lado:
3864
+
3865
+ Slots: `(padrão)`
3866
+
3867
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3868
+ |---|---|---|---|---|
3869
+ | `label` | input (obrigatório) | `string` | | Título do grupo (também o nome do `role="group"`). |
3870
+ | `description` | input | `string` | `''` | Uma linha sob o título. |
3871
+
1836
3872
  ## `hm-navigation-menu-item`
1837
3873
 
1838
3874
  `NavigationMenuItemComponent` — import de `@trismegisto/angular/navigation-menu` (também na raiz)
@@ -1849,6 +3885,7 @@ Slots: `(padrão)`
1849
3885
  | `exact` | input | `boolean` | `false` | Com `route`: só marca como atual com a URL exatamente igual (padrão: também nas rotas filhas). |
1850
3886
  | `current` | input | `boolean` | `false` | Com `href`: este link é a página atual (`aria-current="page"`). |
1851
3887
  | `columns` | input | `number` | `1` | Colunas do painel na barra larga (na tela estreita é sempre uma). |
3888
+ | `wide` | input | `boolean` | `false` | Painel largo ("mega menu"): ocupa a largura inteira da navegação, em vez de só a do conteúdo. Para painéis com vários grupos (`hm-navigation-menu-group`) lado… |
1852
3889
 
1853
3890
  ## `hm-navigation-menu-link`
1854
3891
 
@@ -1883,6 +3920,125 @@ Métodos públicos: `toggle(key: string): void`, `hoverTrigger(key: string, even
1883
3920
  | `openDelay` | input | `number` | `NAVIGATION_MENU_OPEN_DELAY` | Espera (ms) com o mouse sobre um botão antes de abrir o painel. |
1884
3921
  | `closeDelay` | input | `number` | `HOVER_CLOSE_DELAY` | Espera (ms) depois de o mouse sair da navegação antes de fechar o painel aberto pelo mouse. |
1885
3922
 
3923
+ ## `hm-currency-input`
3924
+
3925
+ `CurrencyInputComponent` · `ControlValueAccessor` · estende `HermesNumberFieldBase` — import de `@trismegisto/angular/number-field` (também na raiz)
3926
+
3927
+ Campo de valor em dinheiro. O modelo é `number \| null` na unidade da moeda (`1234.5` = R$ 1.234,50), nunca texto formatado; o formato (milhar, decimal, lado do símbolo) segue o idioma ativo.
3928
+
3929
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3930
+ |---|---|---|---|---|
3931
+ | `currency` | input | `string` | `'BRL'` | Moeda (ISO 4217). |
3932
+ | `currencyDisplay` | input | `CurrencyInputDisplay` | `'symbol'` | |
3933
+ | `fractionDigits` | input | `number \| null, unknown` | `null` | Casas decimais; `null` (padrão) = as da moeda. |
3934
+ | `value` | model (herdado) | `number \| null` | `null` | Valor numérico; `null` = vazio. |
3935
+ | `label` | input (obrigatório) (herdado) | `string` | | |
3936
+ | `placeholder` | input (herdado) | `string` | `''` | |
3937
+ | `labelHidden` | input (herdado) | `boolean` | `false` | Rótulo só para tecnologia assistiva (visualmente oculto, segue como nome acessível). |
3938
+ | `hint` | input (herdado) | `string` | `''` | Texto de apoio embaixo do campo. |
3939
+ | `min` | input (herdado) | `number \| null, unknown` | `null` | Mínimo aceito (na unidade do modelo). Abaixo dele, erro `min`. |
3940
+ | `max` | input (herdado) | `number \| null, unknown` | `null` | Máximo aceito (na unidade do modelo). Acima dele, erro `max`. |
3941
+ | `allowNegative` | input (herdado) | `boolean` | `false` | Aceita valor negativo (o `-` no começo). Desligado, o sinal é ignorado ao digitar e colar. |
3942
+ | `autocomplete` | input (herdado) | `string` | `''` | Repassado ao `<input>` (`transaction-amount`, por exemplo). |
3943
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
3944
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
3945
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
3946
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
3947
+
3948
+ ## `hm-percent-input`
3949
+
3950
+ `PercentInputComponent` · `ControlValueAccessor` · estende `HermesNumberFieldBase` — import de `@trismegisto/angular/number-field` (também na raiz)
3951
+
3952
+ Campo de percentual. A pessoa digita em pontos (`15,5`) com o `%` do lado que o idioma usa; o modelo é `number \| null` na escala de `valueScale`.
3953
+
3954
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3955
+ |---|---|---|---|---|
3956
+ | `valueScale` | input | `PercentInputScale` | `'fraction'` | |
3957
+ | `fractionDigits` | input | `number \| null, unknown` | `2` | Casas decimais dos pontos percentuais (padrão 2). |
3958
+ | `value` | model (herdado) | `number \| null` | `null` | Valor numérico; `null` = vazio. |
3959
+ | `label` | input (obrigatório) (herdado) | `string` | | |
3960
+ | `placeholder` | input (herdado) | `string` | `''` | |
3961
+ | `labelHidden` | input (herdado) | `boolean` | `false` | Rótulo só para tecnologia assistiva (visualmente oculto, segue como nome acessível). |
3962
+ | `hint` | input (herdado) | `string` | `''` | Texto de apoio embaixo do campo. |
3963
+ | `min` | input (herdado) | `number \| null, unknown` | `null` | Mínimo aceito (na unidade do modelo). Abaixo dele, erro `min`. |
3964
+ | `max` | input (herdado) | `number \| null, unknown` | `null` | Máximo aceito (na unidade do modelo). Acima dele, erro `max`. |
3965
+ | `allowNegative` | input (herdado) | `boolean` | `false` | Aceita valor negativo (o `-` no começo). Desligado, o sinal é ignorado ao digitar e colar. |
3966
+ | `autocomplete` | input (herdado) | `string` | `''` | Repassado ao `<input>` (`transaction-amount`, por exemplo). |
3967
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
3968
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
3969
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
3970
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
3971
+
3972
+ ## `hm-order-detail`
3973
+
3974
+ `OrderDetailComponent` — import de `@trismegisto/angular/order` (também na raiz)
3975
+
3976
+ Detalhe de um pedido (`hm-order-detail`): número, data e situação no topo, linha do tempo, itens, resumo de valores, endereços de entrega e cobrança, meio de pagamento e as ações que a situação permite (cancelar antes do envio, pedir devolução depois da entrega, rastrear, comprar de novo).
3977
+
3978
+ Slots: `(padrão)`
3979
+
3980
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3981
+ |---|---|---|---|---|
3982
+ | `order` | input (obrigatório) | `OrderDetail` | | |
3983
+ | `headingLevel` | input | `1 \| 2 \| 3` | `1` | |
3984
+ | `trackable` | input | `boolean` | `true` | Mostra "Rastrear entrega" quando o pedido está enviado. |
3985
+ | `showBuyAgain` | input | `boolean` | `false` | |
3986
+ | `cancel` | output | `void` | | |
3987
+ | `requestReturn` | output | `void` | | |
3988
+ | `track` | output | `void` | | |
3989
+ | `buyAgain` | output | `void` | | |
3990
+ | `texts` | input | `CatalogOverride<OrderMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`ORDER_MESSAGES_PT_BR`). |
3991
+
3992
+ ## `hm-order-status`
3993
+
3994
+ `OrderStatusComponent` — import de `@trismegisto/angular/order` (também na raiz)
3995
+
3996
+ Situação de um pedido (`hm-order-status`): um `hm-tag` com o nome da situação no idioma ativo e a cor do tom correspondente (aguardando pagamento, pago, em separação, enviado, entregue, cancelado, devolvido, reembolsado).
3997
+
3998
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
3999
+ |---|---|---|---|---|
4000
+ | `status` | input (obrigatório) | `OrderStatus` | | |
4001
+ | `compact` | input | `boolean` | `false` | Só a cor (o nome vai para a dica e para o leitor de tela). |
4002
+ | `labelOverride` | input | `string` | `''` | Texto no lugar do nome padrão da situação. |
4003
+ | `texts` | input | `CatalogOverride<OrderMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`ORDER_MESSAGES_PT_BR`). |
4004
+
4005
+ ## `hm-order-timeline`
4006
+
4007
+ `OrderTimelineComponent` — import de `@trismegisto/angular/order` (também na raiz)
4008
+
4009
+ Linha do tempo de um pedido (`hm-order-timeline`): as etapas do caminho feliz (aguardando pagamento → pago → em separação → enviado → entregue) sobre o `hm-timeline`, com a data de cada etapa vinda de `events`. Cancelado encerra no ponto em que parou, com um marco de erro; devolvido e reembolsado acrescentam o marco depois da entrega.
4010
+
4011
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4012
+ |---|---|---|---|---|
4013
+ | `status` | input (obrigatório) | `OrderStatus` | | |
4014
+ | `events` | input | `readonly OrderEvent[]` | `[]` | Histórico de situações com data (a mais recente de cada situação vale). |
4015
+ | `orientation` | input | `TimelineOrientation` | `'vertical'` | |
4016
+ | `label` | input | `string` | `''` | Nome da lista. Vazio = "Andamento do pedido". |
4017
+ | `texts` | input | `CatalogOverride<OrderMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`ORDER_MESSAGES_PT_BR`). |
4018
+
4019
+ ## `hm-org-chart`
4020
+
4021
+ `OrgChartComponent` — import de `@trismegisto/angular/org-chart` (também na raiz)
4022
+
4023
+ Organograma: quem responde a quem, de cima para baixo, com cada equipe abrindo e fechando.
4024
+
4025
+ Métodos públicos: `expandAll(): void`, `collapseAll(): void`, `reveal(id: string, options: { focus?: boolean } = {}): void`, `setZoom(value: number): void`, `fit(): void`
4026
+
4027
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4028
+ |---|---|---|---|---|
4029
+ | `nodes` | input (obrigatório) | `readonly OrgChartNode[]` | | Raiz (ou raízes) do organograma. |
4030
+ | `expandDepth` | input | `number` | `1` | Níveis abertos de início. |
4031
+ | `label` | input | `string` | `''` | Nome da região. Vazio = "Organograma". |
4032
+ | `selectable` | input | `boolean` | `false` | O nome de cada pessoa vira botão (`nodeSelect`). |
4033
+ | `zoomable` | input | `boolean` | `false` | Barra de zoom, Ctrl + roda e arrastar o fundo para mover. Padrão desligado. |
4034
+ | `zoom` | model | `number` | `1` | Zoom do desenho (0,25–2), com `zoomable`. Two-way. |
4035
+ | `highlightId` | input | `string \| null` | `null` | Nó destacado (`aria-current`): o caminho até ele abre e ele vem para o centro da área. |
4036
+ | `arrowNavigation` | input | `boolean` | `false` | Setas andam entre os cartões (baixo abre a equipe, cima vai ao gestor, lados aos colegas). Padrão desligado. |
4037
+ | `compactLeaves` | input | `boolean` | `false` | Equipe só de folhas (ninguém com equipe própria) empilha na vertical, em vez de lado a lado. Padrão desligado. |
4038
+ | `nodeSelect` | output | `OrgChartNode` | | |
4039
+ | `expandedChange` | output | `readonly string[]` | | Ids abertos depois de cada mudança (pessoa ou `expandAll`/`collapseAll`/`reveal`), para o app guardar. |
4040
+ | `texts` | input | `Partial<OrgChartMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
4041
+
1886
4042
  ## `hm-page-header`
1887
4043
 
1888
4044
  `PageHeaderComponent` — import de `@trismegisto/angular/page-header` (também na raiz)
@@ -1924,22 +4080,237 @@ Controles de paginação. Não guarda página nem fatia lista: cada ação emite
1924
4080
  | `nextPage` | output | `void` | | |
1925
4081
  | `previousPage` | output | `void` | | |
1926
4082
 
1927
- ## `| hmDate` (pipe)
4083
+ ## `hm-password-strength`
4084
+
4085
+ `PasswordStrengthComponent` — import de `@trismegisto/angular/password-strength` (também na raiz)
4086
+
4087
+ Medidor de força da senha e lista de requisitos, para pôr logo abaixo do campo de senha.
4088
+
4089
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4090
+ |---|---|---|---|---|
4091
+ | `password` | input (obrigatório) | `string` | | Senha digitada (texto puro, não sai do componente). |
4092
+ | `policy` | input | `PasswordPolicy` | `{}` | Política: comprimento mínimo, classes exigidas, palavras proibidas. |
4093
+ | `showRequirements` | input | `boolean` | `true` | Mostra a lista de requisitos. |
4094
+ | `evaluated` | output | `PasswordEvaluation` | | Avaliação atual (força, requisitos, `valid`). |
4095
+ | `texts` | input | `Partial<PasswordStrengthMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
4096
+
4097
+ ## `hm-bank-account-field`
4098
+
4099
+ `BankAccountFieldComponent` — import de `@trismegisto/angular/payment-fields` (também na raiz)
4100
+
4101
+ Conta bancária (`hm-bank-account-field`): banco (lista ou código), agência e dígito, conta e dígito, tipo de conta e titular, com a validação de `validateBankAccount` (`@trismegisto/primitives`).
4102
+
4103
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4104
+ |---|---|---|---|---|
4105
+ | `value` | model | `BankAccountDraft` | `{}` | |
4106
+ | `banks` | input | `readonly BankOption[]` | `[]` | Bancos para escolher; vazio = campo de código (3 dígitos). |
4107
+ | `rules` | input | `BankAccountRules` | `{}` | |
4108
+ | `legend` | input | `string` | `''` | |
4109
+ | `legendHidden` | input | `boolean` | `false` | |
4110
+ | `showBranchDigit` | input | `boolean` | `false` | |
4111
+ | `showAccountDigit` | input | `boolean` | `true` | |
4112
+ | `showHolder` | input | `boolean` | `false` | |
4113
+ | `accountTypes` | input | `readonly BankAccountType[]` | `['checking', 'savings']` | Tipos oferecidos (um só = sem a pergunta). |
4114
+ | `showErrors` | input | `boolean` | `false` | |
4115
+ | `disabled` | input | `boolean` | `false` | |
4116
+ | `validityChange` | output | `boolean` | | |
4117
+ | `texts` | input | `CatalogOverride<PaymentFieldsMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PAYMENT_FIELDS_MESSAGES_PT_BR`). |
4118
+
4119
+ ## `hm-credit-card-field`
4120
+
4121
+ `CreditCardFieldComponent` — import de `@trismegisto/angular/payment-fields` (também na raiz)
4122
+
4123
+ Campos de cartão de crédito (`hm-credit-card-field`): número com a máscara da bandeira (detectada enquanto se digita), nome impresso, validade `MM/AA` e código de segurança, com validação de Luhn, validade vencida e tamanho do CVC (`@trismegisto/primitives`).
4124
+
4125
+ Métodos públicos: `readCard(): CardInput`, `clear(): void`
4126
+
4127
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4128
+ |---|---|---|---|---|
4129
+ | `legend` | input | `string` | `''` | Legenda do grupo. Vazio = "Dados do cartão". |
4130
+ | `legendHidden` | input | `boolean` | `false` | |
4131
+ | `showHolder` | input | `boolean` | `true` | |
4132
+ | `disabled` | input | `boolean` | `false` | |
4133
+ | `showErrors` | input | `boolean` | `false` | Mostra os erros de todos os campos (tentativa de pagar). |
4134
+ | `now` | input | `Date \| null` | `null` | Data de referência para a validade (padrão: agora). |
4135
+ | `cardChange` | output | `CardSummary` | | Resumo seguro do que foi digitado — sem número completo nem CVC. |
4136
+ | `texts` | input | `CatalogOverride<PaymentFieldsMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PAYMENT_FIELDS_MESSAGES_PT_BR`). |
4137
+
4138
+ ## `hm-iban-field`
4139
+
4140
+ `IbanFieldComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/payment-fields` (também na raiz)
4141
+
4142
+ Campo de IBAN (`hm-iban-field`): máscara em grupos de 4 com o tamanho do país, país detectado nas duas primeiras letras e validação do dígito mod 97 (`validateIban`).
4143
+
4144
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4145
+ |---|---|---|---|---|
4146
+ | `value` | model | `string` | `''` | |
4147
+ | `label` | input | `string` | `''` | Rótulo. Vazio = "IBAN". |
4148
+ | `hint` | input | `string` | `''` | |
4149
+ | `showErrors` | input | `boolean` | `false` | Mostra o erro sem esperar a pessoa sair do campo. |
4150
+ | `texts` | input | `CatalogOverride<PaymentFieldsMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PAYMENT_FIELDS_MESSAGES_PT_BR`). |
4151
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
4152
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
4153
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
4154
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
4155
+
4156
+ ## `hm-payment-form`
4157
+
4158
+ `PaymentFormComponent` — import de `@trismegisto/angular/payment-form` (também na raiz)
4159
+
4160
+ Formulário de pagamento (`hm-payment-form`): escolha entre os meios salvos e os novos (cartão, Pix, boleto…), dados do cartão (`hm-credit-card-field`), parcelas, endereço de cobrança ("usar o da entrega" ou o `hm-address-field`) e o botão "Pagar R$ X".
4161
+
4162
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4163
+ |---|---|---|---|---|
4164
+ | `amount` | input (obrigatório) | `number` | | Valor a pagar. |
4165
+ | `currency` | input | `string` | `'BRL'` | |
4166
+ | `methods` | input | `readonly PaymentMethod[]` | `[]` | Meios salvos, oferecidos primeiro. |
4167
+ | `newKinds` | input | `readonly PaymentMethodKind[]` | `['card', 'pix', 'boleto']` | Meios novos oferecidos. |
4168
+ | `maxInstallments` | input | `number` | `1` | Até quantas parcelas no cartão (1 = só à vista). |
4169
+ | `interestFreeInstallments` | input | `number` | `1` | Até quantas parcelas sem juros (o cálculo de juros é do app). |
4170
+ | `shippingAddress` | input | `PostalAddress \| null` | `null` | Endereço da entrega, oferecido como cobrança. |
4171
+ | `requireBillingAddress` | input | `boolean` | `true` | |
4172
+ | `tokenize` | input | `CardTokenizer \| null` | `null` | Tokenizador do provedor de pagamento (obrigatório para cartão novo). |
4173
+ | `submitting` | input | `boolean` | `false` | |
4174
+ | `error` | input | `string` | `''` | Erro do último pagamento (recusa, falha de rede), devolvido pelo app. |
4175
+ | `submitted` | output | `PaymentSubmission` | | |
4176
+ | `texts` | input | `CatalogOverride<PaymentFormMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PAYMENT_FORM_MESSAGES_PT_BR`). |
4177
+
4178
+ ## `hm-payment-method-card`
4179
+
4180
+ `PaymentMethodCardComponent` — import de `@trismegisto/angular/payment-method` (também na raiz)
4181
+
4182
+ Meio de pagamento salvo (`hm-payment-method-card`): ícone do tipo, nome ("Visa terminado em 4242"), validade com aviso de vencido ou vencendo, selo de principal e, se quiser, as ações "Tornar principal" e remover.
4183
+
4184
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4185
+ |---|---|---|---|---|
4186
+ | `method` | input (obrigatório) | `PaymentMethod` | | |
4187
+ | `actions` | input | `boolean` | `false` | Mostra "Tornar principal" e remover. |
4188
+ | `plain` | input | `boolean` | `false` | Sem borda nem fundo (dentro de uma opção de rádio ou de outro cartão). |
4189
+ | `now` | input | `Date \| null` | `null` | Data de referência para vencido/vencendo (padrão: agora). |
4190
+ | `makeDefault` | output | `void` | | |
4191
+ | `remove` | output | `void` | | |
4192
+ | `texts` | input | `CatalogOverride<PaymentMethodMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PAYMENT_METHOD_MESSAGES_PT_BR`). |
4193
+
4194
+ ## `hm-payment-method-picker`
4195
+
4196
+ `PaymentMethodPickerComponent` — import de `@trismegisto/angular/payment-method` (também na raiz)
4197
+
4198
+ Escolha entre meios de pagamento salvos (`hm-payment-method-picker`): cada meio é uma opção de rádio em cartão (`hm-payment-method-card` por dentro), com "Adicionar forma de pagamento" no fim.
4199
+
4200
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4201
+ |---|---|---|---|---|
4202
+ | `methods` | input | `readonly PaymentMethod[]` | `[]` | |
4203
+ | `value` | model | `string` | `''` | Id do meio escolhido. |
4204
+ | `label` | input | `string` | `''` | |
4205
+ | `legendHidden` | input | `boolean` | `false` | |
4206
+ | `allowAdd` | input | `boolean` | `true` | |
4207
+ | `now` | input | `Date \| null` | `null` | |
4208
+ | `add` | output | `void` | | |
4209
+ | `texts` | input | `CatalogOverride<PaymentMethodMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PAYMENT_METHOD_MESSAGES_PT_BR`). |
4210
+
4211
+ ## `hm-pdf-viewer`
4212
+
4213
+ `PdfViewerComponent` — import de `@trismegisto/angular/pdf-viewer` (também na raiz)
4214
+
4215
+ Visualizador de PDF sem biblioteca de PDF: o documento é desenhado pelo leitor do próprio navegador (Chrome, Edge, Firefox e Safari no computador) dentro de um `<iframe>`, que já traz páginas, zoom, busca, impressão e seleção de texto acessíveis. A lib acrescenta o cabeçalho (nome do arquivo, abrir em outra aba, baixar), a página e o zoom iniciais (parâmetros de abertura `#page=`/`#zoom=`) e a al…
4216
+
4217
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4218
+ |---|---|---|---|---|
4219
+ | `src` | input (obrigatório) | `string` | | Endereço do PDF (relativo, http(s), `blob:` ou `data:application/pdf`). |
4220
+ | `fileName` | input | `string` | `''` | Nome exibido e usado ao baixar (padrão: o fim do caminho de `src`). |
4221
+ | `label` | input | `string` | `''` | Nome do quadro para leitores de tela (padrão: `{nome} (PDF)`). |
4222
+ | `page` | input | `number \| null` | `null` | Página inicial (1..). |
4223
+ | `zoom` | input | `PdfZoom \| null` | `null` | Zoom inicial: percentual, `page-width` ou `page-fit`. |
4224
+ | `height` | input | `string` | `''` | Altura do quadro (qualquer comprimento CSS; padrão do tema). |
4225
+ | `embed` | input | `PdfViewerEmbed` | `'auto'` | `auto` usa o leitor do navegador quando existe; `never` mostra sempre o cartão. |
4226
+ | `texts` | input | `Partial<PdfViewerMessages>` | `{}` | Textos próprios do componente, por cima do catálogo do idioma ativo (parcial). |
4227
+
4228
+ ## `hm-permission-matrix`
4229
+
4230
+ `PermissionMatrixComponent` — import de `@trismegisto/angular/permission-matrix` (também na raiz)
4231
+
4232
+ Matriz de permissões: papéis nas colunas, permissões nas linhas, uma caixa por cruzamento.
4233
+
4234
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4235
+ |---|---|---|---|---|
4236
+ | `roles` | input (obrigatório) | `readonly PeopleRole[]` | | |
4237
+ | `permissions` | input (obrigatório) | `readonly PermissionDefinition[]` | | |
4238
+ | `grants` | model | `PermissionGrants` | `{}` | Concessões atuais: id do papel → ids das permissões. |
4239
+ | `lockedRoles` | input | `readonly string[]` | `[]` | Papéis cujas colunas não se editam (mostradas, travadas). |
4240
+ | `readonly` | input | `boolean` | `false` | Só leitura: nenhuma caixa se edita e as caixas "todas" somem. |
4241
+ | `label` | input | `string` | `''` | Nome da tabela. Vazio = "Matriz de permissões". |
4242
+ | `texts` | input | `Partial<PermissionMatrixMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
4243
+
4244
+ ## `| hmDate` (pipe)
4245
+
4246
+ `HermesDatePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
4247
+
4248
+ Data no idioma ativo da Hermes (`HermesI18nService`), por `Intl.DateTimeFormat`:
4249
+
4250
+ Assinatura: `transform(value: HermesDateInput, presetOrOptions?: HermesDatePreset \| Intl.DateTimeFormatOptions, options?: Intl.DateTimeFormatOptions): string`
4251
+
4252
+
4253
+ ## `| hmDateTime` (pipe)
4254
+
4255
+ `HermesDateTimePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
4256
+
4257
+ Data e hora no idioma ativo da Hermes — igual ao `hmDate`, com o preset aplicado também à hora (`timeStyle`): `'short'` (padrão) = 03/10/2026, 14:30; `'medium'` com segundos; `'long'`/`'full'` com o fuso. Relógio de 12/24 h segue o idioma; para forçar, `{ hourCycle: 'h23' }`.
4258
+
4259
+ Assinatura: `transform(value: HermesDateInput, presetOrOptions?: HermesDatePreset \| Intl.DateTimeFormatOptions, options?: Intl.DateTimeFormatOptions): string`
4260
+
4261
+
4262
+ ## `| hmCurrency` (pipe)
4263
+
4264
+ `HermesCurrencyPipe` — import de `@trismegisto/angular/pipes` (também na raiz)
4265
+
4266
+ Dinheiro no idioma ativo. A moeda (ISO 4217, padrão `'BRL'`) é dado: em inglês, reais continuam reais (`R$1,234.50`). Casas decimais seguem a moeda, salvo `options`.
4267
+
4268
+ Assinatura: `transform(value: HermesNumberInput, currency = 'BRL', options?: Omit<Intl.NumberFormatOptions, 'style' \| 'currency'>): string`
4269
+
4270
+
4271
+ ## `| hmDuration` (pipe)
4272
+
4273
+ `HermesDurationPipe` — import de `@trismegisto/angular/pipes` (também na raiz)
4274
+
4275
+ Duração no idioma ativo. O valor é em milissegundos, salvo `unit`.
4276
+
4277
+ Assinatura: `transform(value: HermesNumberInput, options?: HermesDurationOptions): string`
4278
+
4279
+
4280
+ ## `| hmFileSize` (pipe)
4281
+
4282
+ `HermesFileSizePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
1928
4283
 
1929
- `HermesDatePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
4284
+ Tamanho de arquivo em bytes no idioma ativo, com a mesma regra do `hm-file-upload`/`hm-attachment` (`formatFileSize`, base 1024): `1536` → `1,5 kB`. Vazio, inválido ou negativo → `''`.
1930
4285
 
1931
- Data no idioma ativo da Hermes (`HermesI18nService`), por `Intl.DateTimeFormat`:
4286
+ Assinatura: `transform(value: HermesNumberInput): string`
1932
4287
 
1933
- Assinatura: `transform(value: HermesDateInput, presetOrOptions?: HermesDatePreset \| Intl.DateTimeFormatOptions, options?: Intl.DateTimeFormatOptions): string`
1934
4288
 
4289
+ ## `| hmNumber` (pipe)
1935
4290
 
1936
- ## `| hmDateTime` (pipe)
4291
+ `HermesNumberPipe` — import de `@trismegisto/angular/pipes` (também na raiz)
1937
4292
 
1938
- `HermesDateTimePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
4293
+ Número no idioma ativo (`Intl.NumberFormat`). Vazio/inválido → `''`.
1939
4294
 
1940
- Data e hora no idioma ativo da Hermes — igual ao `hmDate`, com o preset aplicado também à hora (`timeStyle`): `'short'` (padrão) = 03/10/2026, 14:30; `'medium'` com segundos; `'long'`/`'full'` com o fuso. Relógio de 12/24 h segue o idioma; para forçar, `{ hourCycle: 'h23' }`.
4295
+ Assinatura: `transform(value: HermesNumberInput, options?: Intl.NumberFormatOptions): string`
1941
4296
 
1942
- Assinatura: `transform(value: HermesDateInput, presetOrOptions?: HermesDatePreset \| Intl.DateTimeFormatOptions, options?: Intl.DateTimeFormatOptions): string`
4297
+
4298
+ ## `| hmPercent` (pipe)
4299
+
4300
+ `HermesPercentPipe` — import de `@trismegisto/angular/pipes` (também na raiz)
4301
+
4302
+ Percentual no idioma ativo, a partir da FRAÇÃO (como o Intl): `0.155` → `16%`. Valor em pontos (`15.5`) passe `'points'` como primeiro argumento.
4303
+
4304
+ Assinatura: `transform(value: HermesNumberInput, scaleOrOptions?: 'fraction' \| 'points' \| Omit<Intl.NumberFormatOptions, 'style'>, options?: Omit<Intl.NumberFormatOptions, 'style'>): string`
4305
+
4306
+
4307
+ ## `| hmRelativeTime` (pipe)
4308
+
4309
+ `HermesRelativeTimePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
4310
+
4311
+ Tempo relativo no idioma ativo: "há 5 minutos", "ontem", "em 2 horas". O texto não envelhece sozinho: para atualizar na tela, passe `{ now: relogio() }` com um signal que mude (a cada minuto, por exemplo).
4312
+
4313
+ Assinatura: `transform(value: HermesInstantInput, options?: HermesRelativeTimeOptions): string`
1943
4314
 
1944
4315
 
1945
4316
  ## `| hmTranslate` (pipe)
@@ -1951,6 +4322,41 @@ Texto do catálogo do `HermesI18nService` pela chave (`seção.chave`), no idiom
1951
4322
  Assinatura: `transform(key: string \| null \| undefined, params?: MessageParams): string`
1952
4323
 
1953
4324
 
4325
+ ## `[hmPopconfirmTrigger]`
4326
+
4327
+ `PopconfirmTriggerDirective` — import de `@trismegisto/angular/popconfirm` (também na raiz)
4328
+
4329
+ Gatilho de um `hm-popconfirm`: abre e fecha a confirmação no clique e mantém o ARIA do botão em dia (`aria-haspopup="dialog"`, `aria-expanded` e, aberto, `aria-controls`). Vá num elemento que já é botão (`<button>`, `hm-button`, `hm-icon-button`): num componente-botão, os atributos vão para o `<button>` interno.
4330
+
4331
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4332
+ |---|---|---|---|---|
4333
+ | `hmPopconfirmTrigger` | input (obrigatório) | `PopconfirmComponent` | | O `hm-popconfirm` aberto por este gatilho (referência de template: `#confirm`). |
4334
+
4335
+ ## `hm-popconfirm`
4336
+
4337
+ `PopconfirmComponent` — import de `@trismegisto/angular/popconfirm` (também na raiz)
4338
+
4339
+ Confirmação ancorada no botão que a pediu: uma pergunta curta e dois botões, num cartão `hm-popover` (mesma régua de posicionamento, mesmo movimento para o `<body>`, mesmo foco). Par com a diretiva `[hmPopconfirmTrigger]`:
4340
+
4341
+ Slots: `(padrão)`
4342
+
4343
+ Métodos públicos: `show(trigger?: HTMLElement): void`, `close(): void`, `toggle(trigger?: HTMLElement): void`
4344
+
4345
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4346
+ |---|---|---|---|---|
4347
+ | `open` | model | `boolean` | `false` | Aberto/fechado. `[(open)]` para controlar de fora; sem binding, o gatilho controla. |
4348
+ | `heading` | input (obrigatório) | `string` | | A pergunta (título do cartão e nome acessível do diálogo). Obrigatório. |
4349
+ | `headingLevel` | input | `number` | `2` | Nível do título para o leitor de tela (`aria-level`). |
4350
+ | `message` | input | `string` | `''` | Consequência em uma frase ("Não dá para desfazer."). Descreve o diálogo. |
4351
+ | `confirmLabel` | input | `string` | `''` | Rótulo do botão de confirmar; diga a ação ("Excluir"), não "Sim". Vazio usa o catálogo ("Confirmar"). |
4352
+ | `cancelLabel` | input | `string` | `''` | Rótulo do botão de cancelar. Vazio usa o catálogo ("Cancelar"). |
4353
+ | `intent` | input | `PopconfirmIntent` | `'default'` | `danger` pinta o botão de confirmar de vermelho (ação destrutiva). |
4354
+ | `side` | input | `PopoverSide` | `'top'` | Lado preferido em relação ao gatilho (vira para o oposto quando não cabe). |
4355
+ | `align` | input | `PopoverAlign` | `'center'` | Encosto no eixo cruzado. |
4356
+ | `confirmed` | output | `void` | | A pessoa confirmou. |
4357
+ | `cancelled` | output | `void` | | A pessoa desistiu (Cancelar, `Esc` ou clique fora). |
4358
+ | `texts` | input | `Partial<PopconfirmMessages>` | `{}` | Troca textos do catálogo da peça (ex.: rótulos padrão em outro tom). |
4359
+
1954
4360
  ## `[hmPopoverTrigger]`
1955
4361
 
1956
4362
  `PopoverTriggerDirective` — import de `@trismegisto/angular/popover` (também na raiz)
@@ -1977,6 +4383,7 @@ Métodos públicos: `show(trigger?: HTMLElement): void`, `close(): void`, `toggl
1977
4383
  | `heading` | input | `string` | `''` | Título visível; também nomeia o diálogo (`aria-labelledby`). |
1978
4384
  | `headingLevel` | input | `number` | `2` | Nível do título para o leitor de tela (`aria-level`). |
1979
4385
  | `label` | input | `string` | `''` | Nome acessível quando não há `heading` visível. |
4386
+ | `describedBy` | input | `string` | `''` | Id(s) de texto do conteúdo que descreve o cartão (`aria-describedby`); vazio não emite o atributo. |
1980
4387
  | `side` | input | `PopoverSide` | `'bottom'` | Lado preferido em relação ao gatilho; vira para o oposto quando não cabe. |
1981
4388
  | `align` | input | `PopoverAlign` | `'start'` | Encosto no eixo cruzado; troca sozinho por outro que caiba. |
1982
4389
  | `arrow` | input | `boolean` | `true` | Bico apontando para o gatilho. |
@@ -1987,6 +4394,130 @@ Métodos públicos: `show(trigger?: HTMLElement): void`, `close(): void`, `toggl
1987
4394
  | `openDelay` | input | `number` | `HOVER_OPEN_DELAY` | Só em `openOn="hover"`: espera (ms) com o mouse/foco no gatilho antes de abrir. |
1988
4395
  | `closeDelay` | input | `number` | `HOVER_CLOSE_DELAY` | Só em `openOn="hover"`: espera (ms) depois de o mouse sair antes de fechar. |
1989
4396
 
4397
+ ## `hm-price`
4398
+
4399
+ `PriceComponent` — import de `@trismegisto/angular/price` (também na raiz)
4400
+
4401
+ Preço de um produto ou plano (`hm-price`): o valor cobrado, o preço "de" riscado quando há desconto, o selo de porcentagem, a economia, a recorrência e o parcelamento.
4402
+
4403
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4404
+ |---|---|---|---|---|
4405
+ | `amount` | input (obrigatório) | `number` | | Preço cobrado, na unidade principal da moeda. |
4406
+ | `compareAt` | input | `number \| null` | `null` | Preço de referência ("de"); só aparece riscado quando maior que `amount`. |
4407
+ | `currency` | input | `string` | `'BRL'` | Código ISO 4217 (`BRL`, `USD`, `EUR`). |
4408
+ | `size` | input | `PriceSize` | `'medium'` | |
4409
+ | `period` | input | `PricePeriod` | `''` | Recorrência depois do valor. |
4410
+ | `unit` | input | `string` | `''` | Unidade de venda ("kg", "m²") — vira "/kg". Vence o `period`. |
4411
+ | `showDiscount` | input | `boolean` | `true` | Selo "-20%" ao lado do preço riscado. |
4412
+ | `showSavings` | input | `boolean` | `false` | Linha "Economize R$ 20,00". |
4413
+ | `installments` | input | `number` | `0` | Em quantas parcelas (0 ou 1 = sem linha de parcelamento). |
4414
+ | `interestFree` | input | `boolean` | `false` | Parcelamento sem juros. |
4415
+ | `freeLabel` | input | `boolean` | `true` | Valor zero escrito como "Grátis". |
4416
+ | `texts` | input | `CatalogOverride<PriceMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PRICE_MESSAGES_PT_BR`). |
4417
+
4418
+ ## `hm-stock-status`
4419
+
4420
+ `StockStatusComponent` — import de `@trismegisto/angular/price` (também na raiz)
4421
+
4422
+ Situação de estoque (`hm-stock-status`): em estoque, últimas unidades, esgotado, sob encomenda ou pré-venda, deduzida da quantidade.
4423
+
4424
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4425
+ |---|---|---|---|---|
4426
+ | `quantity` | input | `number \| null` | `null` | Unidades disponíveis; `null` = estoque não controlado (sempre "Em estoque"). |
4427
+ | `lowThreshold` | input | `number` | `5` | Até quantas unidades conta como "últimas unidades". |
4428
+ | `backorder` | input | `boolean` | `false` | Vende sem estoque (entrega quando repor). |
4429
+ | `preorder` | input | `boolean` | `false` | Produto ainda não lançado. |
4430
+ | `showCount` | input | `boolean` | `false` | Mostra a quantidade também quando o estoque está folgado. |
4431
+ | `texts` | input | `CatalogOverride<PriceMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PRICE_MESSAGES_PT_BR`). |
4432
+
4433
+ ## `hm-product-card`
4434
+
4435
+ `ProductCardComponent` — import de `@trismegisto/angular/product` (também na raiz)
4436
+
4437
+ Cartão de produto (`hm-product-card`): imagem, selo, marca, nome, preço (com desconto e parcelas), estoque e o botão de adicionar ao carrinho.
4438
+
4439
+ Slots: `[extra]`
4440
+
4441
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4442
+ |---|---|---|---|---|
4443
+ | `product` | input (obrigatório) | `ProductSummary` | | |
4444
+ | `currency` | input | `string` | `'BRL'` | Código ISO 4217 do preço. |
4445
+ | `layout` | input | `ProductCardLayout` | `'vertical'` | |
4446
+ | `headingLevel` | input | `2 \| 3 \| 4 \| 5 \| 6` | `3` | Nível do título (o nome do produto) na estrutura da página. |
4447
+ | `showAction` | input | `boolean` | `true` | Mostra o botão de adicionar ao carrinho. |
4448
+ | `actionLabel` | input | `string` | `''` | Texto do botão no lugar de "Adicionar ao carrinho". |
4449
+ | `adding` | input | `boolean` | `false` | O pedido de adicionar está em andamento (botão em espera). |
4450
+ | `addToCart` | output | `ProductSummary` | | Pediu para adicionar ao carrinho. |
4451
+ | `view` | output | `ProductSummary` | | Clicou no nome (só quando o produto não tem `href`). |
4452
+ | `texts` | input | `CatalogOverride<ProductMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PRODUCT_MESSAGES_PT_BR`). |
4453
+
4454
+ ## `hm-product-detail`
4455
+
4456
+ `ProductDetailComponent` — import de `@trismegisto/angular/product` (também na raiz)
4457
+
4458
+ Detalhe de produto (`hm-product-detail`): galeria com miniaturas, nome, preço, estoque, variantes, quantidade e o botão de adicionar ao carrinho — o miolo de uma página de produto.
4459
+
4460
+ Slots: `[description]`, `(padrão)`
4461
+
4462
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4463
+ |---|---|---|---|---|
4464
+ | `name` | input (obrigatório) | `string` | | |
4465
+ | `brand` | input | `string` | `''` | |
4466
+ | `images` | input | `readonly ProductImage[]` | `[]` | |
4467
+ | `price` | input (obrigatório) | `number` | | |
4468
+ | `compareAt` | input | `number \| null` | `null` | |
4469
+ | `currency` | input | `string` | `'BRL'` | |
4470
+ | `installments` | input | `number` | `0` | |
4471
+ | `interestFree` | input | `boolean` | `false` | |
4472
+ | `sku` | input | `string` | `''` | Código do produto (a variante pode trazer o próprio). |
4473
+ | `stock` | input | `StockInput \| null` | `null` | |
4474
+ | `options` | input | `readonly ProductOption[]` | `[]` | |
4475
+ | `variants` | input | `readonly ProductVariant[]` | `[]` | |
4476
+ | `selection` | model | `VariantSelection` | `{}` | |
4477
+ | `quantity` | model | `number` | `1` | |
4478
+ | `maxQuantity` | input | `number \| null` | `null` | Teto de unidades por pedido (o estoque da variante também limita). |
4479
+ | `headingLevel` | input | `1 \| 2 \| 3` | `1` | |
4480
+ | `adding` | input | `boolean` | `false` | O pedido de adicionar está em andamento. |
4481
+ | `addToCart` | output | `AddToCartRequest` | | |
4482
+ | `texts` | input | `CatalogOverride<ProductMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PRODUCT_MESSAGES_PT_BR`). |
4483
+
4484
+ ## `hm-product-list`
4485
+
4486
+ `ProductListComponent` — import de `@trismegisto/angular/product` (também na raiz)
4487
+
4488
+ Lista de produtos (`hm-product-list`): uma grade de `hm-product-card` que se ajusta à largura (ou uma lista de cartões horizontais), com contagem, estado vazio e esqueletos durante o carregamento.
4489
+
4490
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4491
+ |---|---|---|---|---|
4492
+ | `products` | input | `readonly ProductSummary[]` | `[]` | |
4493
+ | `currency` | input | `string` | `'BRL'` | |
4494
+ | `layout` | input | `ProductListLayout` | `'grid'` | Grade de cartões verticais ou lista de cartões horizontais. |
4495
+ | `label` | input | `string` | `''` | Nome da lista para leitor de tela. Vazio = "Produtos". |
4496
+ | `headingLevel` | input | `2 \| 3 \| 4 \| 5 \| 6` | `3` | |
4497
+ | `showAction` | input | `boolean` | `true` | |
4498
+ | `showCount` | input | `boolean` | `true` | Mostra a contagem de produtos acima da lista. |
4499
+ | `emptyText` | input | `string` | `''` | Texto do estado vazio. |
4500
+ | `loading` | input | `boolean` | `false` | |
4501
+ | `skeletonCount` | input | `number` | `4` | Quantos esqueletos durante o carregamento. |
4502
+ | `addingId` | input | `string \| null` | `null` | Produto cujo "adicionar" está em andamento. |
4503
+ | `addToCart` | output | `ProductSummary` | | |
4504
+ | `view` | output | `ProductSummary` | | |
4505
+ | `texts` | input | `CatalogOverride<ProductMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PRODUCT_MESSAGES_PT_BR`). |
4506
+
4507
+ ## `hm-variant-picker`
4508
+
4509
+ `VariantPickerComponent` — import de `@trismegisto/angular/product` (também na raiz)
4510
+
4511
+ Escolha de variantes de um produto (`hm-variant-picker`): um grupo de opções por eixo (cor, tamanho…), com amostra de cor ou botão de texto, marcando o que está esgotado e o que não existe na combinação.
4512
+
4513
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4514
+ |---|---|---|---|---|
4515
+ | `options` | input (obrigatório) | `readonly ProductOption[]` | | Eixos de escolha, na ordem exibida. |
4516
+ | `variants` | input | `readonly ProductVariant[]` | `[]` | Todas as variantes que existem (com `available: false` nas esgotadas). |
4517
+ | `selection` | model | `VariantSelection` | `{}` | Valor escolhido em cada eixo (`{ cor: 'azul' }`). |
4518
+ | `variantChange` | output | `ProductVariant \| null` | | A variante da seleção completa, ou `null` enquanto falta algum eixo. |
4519
+ | `texts` | input | `CatalogOverride<ProductMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`PRODUCT_MESSAGES_PT_BR`). |
4520
+
1990
4521
  ## `hm-progress`
1991
4522
 
1992
4523
  `ProgressComponent` — import de `@trismegisto/angular/progress` (também na raiz)
@@ -2004,6 +4535,53 @@ Barra de progresso (`role="progressbar"`).
2004
4535
  | `intent` | input | `ProgressIntent` | `'accent'` | |
2005
4536
  | `size` | input | `ProgressSize` | `'medium'` | Espessura da trilha. |
2006
4537
  | `hint` | input | `string` | `''` | Texto de apoio embaixo da barra ("3 de 8 arquivos"). |
4538
+ | `shape` | input | `ProgressShape` | `'bar'` | `bar` (padrão) ou `circle` (anel). Ver `ProgressShape`. |
4539
+
4540
+ ## `hm-prompt-input`
4541
+
4542
+ `PromptInputComponent` — import de `@trismegisto/angular/prompt-input` (também na raiz)
4543
+
4544
+ O campo em que a pessoa escreve para o agente: texto que cresce, anexos, escolha de modelo e de esforço, e enviar (ou parar, enquanto o agente responde). Enter envia; Shift+Enter quebra a linha. Só apresenta e devolve a intenção: ler os arquivos, enviar e limpar o campo é do app.
4545
+
4546
+ Métodos públicos: `send(): void`, `pick(): void`
4547
+
4548
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4549
+ |---|---|---|---|---|
4550
+ | `value` | model | `string` | `''` | |
4551
+ | `label` | input | `string` | `''` | Nome do campo. Padrão: "Mensagem para o agente". |
4552
+ | `showLabel` | input | `boolean` | `false` | Mostra o rótulo acima do campo (por padrão ele vale só para leitor de tela). |
4553
+ | `placeholder` | input | `string` | `''` | |
4554
+ | `hint` | input | `string` | `''` | |
4555
+ | `disabled` | input | `boolean` | `false` | |
4556
+ | `streaming` | input | `boolean` | `false` | O agente está respondendo: no lugar de enviar, o botão para a resposta. |
4557
+ | `attachments` | input | `readonly PromptInputAttachment[]` | `[]` | |
4558
+ | `attachable` | input | `boolean` | `true` | Mostra o botão de anexar. |
4559
+ | `accept` | input | `string` | `''` | Tipos aceitos no seletor de arquivo (`accept` do input). |
4560
+ | `multipleFiles` | input | `boolean` | `true` | |
4561
+ | `models` | input | `readonly AgentModel[]` | `[]` | Modelos que a pessoa pode escolher; vazio esconde a escolha. |
4562
+ | `model` | model | `string` | `''` | |
4563
+ | `efforts` | input | `readonly AgentModel[]` | `[]` | Níveis de esforço (raciocínio) que o modelo aceita; vazio esconde a escolha. |
4564
+ | `effort` | model | `string` | `''` | |
4565
+ | `maxRows` | input | `number` | `8` | Teto da altura, em linhas. |
4566
+ | `texts` | input | `Partial<PromptInputMessages>` | `{}` | |
4567
+ | `submitted` | output | `PromptInputSubmit` | | Pediu para enviar: o app manda e limpa o campo. |
4568
+ | `stopped` | output | `void` | | Pediu para parar a resposta em andamento. |
4569
+ | `filesAdded` | output | `readonly File[]` | | Arquivos escolhidos para anexar. |
4570
+ | `attachmentRemoved` | output | `string` | | Id do anexo que a pessoa tirou. |
4571
+
4572
+ ## `hm-prompt-suggestions`
4573
+
4574
+ `PromptSuggestionsComponent` — import de `@trismegisto/angular/prompt-suggestions` (também na raiz)
4575
+
4576
+ Perguntas prontas para um assistente: escolher uma envia o texto dela, sem digitar. Mostra a pessoa o que dá para perguntar. Quem envia é o app, ao receber `chosen`.
4577
+
4578
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4579
+ |---|---|---|---|---|
4580
+ | `suggestions` | input | `readonly string[]` | `[]` | |
4581
+ | `label` | input | `string` | `''` | Nome acessível do grupo. Padrão: "Sugestões de pergunta". |
4582
+ | `disabled` | input | `boolean` | `false` | Enquanto o assistente responde. |
4583
+ | `layout` | input | `'wrap' \| 'scroll'` | `'wrap'` | `wrap` quebra em linhas; `scroll` fica numa linha só, que rola de lado (em cima do campo, onde a altura pesa). |
4584
+ | `chosen` | output | `string` | | O texto da sugestão escolhida. |
2007
4585
 
2008
4586
  ## `hm-property-view`
2009
4587
 
@@ -2024,6 +4602,28 @@ Métodos públicos: `currentErrors(): Readonly<Record<string, string>>`
2024
4602
  | `headingLevel` | input | `number` | `3` | Nível dos cabeçalhos de grupo (`aria-level`). |
2025
4603
  | `propertyChange` | output | `PropertyChangeEvent` | | Uma propriedade foi editada. |
2026
4604
 
4605
+ ## `hm-questionnaire`
4606
+
4607
+ `QuestionnaireComponent` — import de `@trismegisto/angular/questionnaire` (também na raiz)
4608
+
4609
+ Perguntas em sequência para a pessoa esclarecer o pedido antes de o agente seguir: uma por vez, com respostas prontas (uma ou várias), resposta livre, pular nas opcionais, atalhos de teclado e progresso. Pergunta com `disabled` (valor ou função das respostas) sai da sequência. O app recebe as respostas em `submitted` e decide o resto: onde o questionário fica (cartão, diálogo), guardar, enviar, c…
4610
+
4611
+ Métodos públicos: `skip(): void`, `previous(): void`, `next(): void`, `submit(): void`
4612
+
4613
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4614
+ |---|---|---|---|---|
4615
+ | `questions` | input (obrigatório) | `readonly QuestionnaireQuestion[]` | | |
4616
+ | `answers` | model | `QuestionnaireAnswers` | `{}` | Respostas por id da pergunta. O app pode trazer as de uma sessão anterior. |
4617
+ | `active` | model | `string` | `''` | Id da pergunta à vista. Vazio: a primeira que vale. |
4618
+ | `shortcuts` | input | `QuestionnaireShortcuts \| null` | `null` | Atalho por letra ou número em cada opção. |
4619
+ | `validate` | input | `QuestionnaireValidator \| null` | `null` | Validação do app, além de exigir resposta nas obrigatórias. |
4620
+ | `showProgress` | input | `boolean` | `true` | |
4621
+ | `busy` | input | `boolean` | `false` | Enquanto o app envia: trava os campos e mostra o andamento no botão. |
4622
+ | `label` | input | `string` | `''` | Nome acessível do grupo. Padrão: "Perguntas". |
4623
+ | `submitLabel` | input | `string` | `''` | Texto do botão final. Padrão: "Enviar respostas". |
4624
+ | `texts` | input | `Partial<QuestionnaireMessages>` | `{}` | |
4625
+ | `submitted` | output | `QuestionnaireAnswers` | | As respostas das perguntas que valem, depois de todas passarem pela validação. |
4626
+
2027
4627
  ## `hm-radio`
2028
4628
 
2029
4629
  `RadioComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/radio` (também na raiz)
@@ -2038,12 +4638,90 @@ Escolha única entre poucas opções visíveis, com rádios nativos: Tab entra n
2038
4638
  | `appearance` | input | `RadioAppearance \| undefined` | `undefined` | |
2039
4639
  | `layout` | input | `RadioLayout \| undefined` | `undefined` | |
2040
4640
  | `hint` | input | `string` | `''` | |
2041
- | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
2042
4641
  | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2043
4642
  | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2044
4643
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2045
4644
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2046
4645
 
4646
+ ## `hm-rating`
4647
+
4648
+ `RatingComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/rating` (também na raiz)
4649
+
4650
+ Avaliação por estrelas como campo de formulário. Um único ponto de foco no padrão Slider do APG: setas somam/subtraem um passo (meia estrela com `allowHalf`), Home/End vão a 0/máximo, os dígitos escolhem direto; com o ponteiro, passar por cima mostra a prévia e clicar escolhe (a metade inicial da estrela vale meio ponto com `allowHalf`). `clearable`: clicar no valor atual volta a 0.
4651
+
4652
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4653
+ |---|---|---|---|---|
4654
+ | `label` | input | `string` | `''` | Rótulo do campo (obrigatório como campo; no modo `readonly` pode ficar vazio). |
4655
+ | `value` | model | `number` | `0` | |
4656
+ | `max` | input | `number` | `5` | Quantidade de estrelas. |
4657
+ | `allowHalf` | input | `boolean` | `false` | Aceita meia estrela. |
4658
+ | `readonly` | input | `boolean` | `false` | Só exibe o valor (sem foco nem interação). |
4659
+ | `clearable` | input | `boolean` | `false` | Clicar no valor atual volta a 0. |
4660
+ | `showValue` | input | `boolean` | `false` | Mostra o número ao lado das estrelas. |
4661
+ | `size` | input | `RatingSize` | `'medium'` | |
4662
+ | `hint` | input | `string` | `''` | |
4663
+ | `texts` | input | `Partial<RatingMessages>` | `{}` | Textos próprios do componente, por cima do catálogo do idioma ativo (parcial). |
4664
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
4665
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
4666
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
4667
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
4668
+
4669
+ ## `hm-reason-dialog`
4670
+
4671
+ `ReasonDialogComponent` — import de `@trismegisto/angular/reason-dialog` (também na raiz)
4672
+
4673
+ Confirmação de uma mudança de workflow com motivo opcional ou obrigatório: o diálogo comum do `hm-status-select` (transição), do `hm-approval` (rejeição) e de qualquer ação do app que peça "por quê?".
4674
+
4675
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4676
+ |---|---|---|---|---|
4677
+ | `open` | model | `boolean` | `false` | |
4678
+ | `heading` | input (obrigatório) | `string` | | |
4679
+ | `message` | input | `string` | `''` | Frase abaixo do título (o que vai acontecer). |
4680
+ | `reason` | input | `WorkflowReasonMode` | `'none'` | |
4681
+ | `reasonLabel` | input | `string` | `''` | Rótulo do campo. Vazio = "Motivo" (obrigatório) ou "Motivo (opcional)". |
4682
+ | `requiredMessage` | input | `string` | `''` | Erro do campo obrigatório vazio. Vazio = catálogo. |
4683
+ | `confirmLabel` | input | `string` | `''` | |
4684
+ | `cancelLabel` | input | `string` | `''` | |
4685
+ | `danger` | input | `boolean` | `false` | Ação destrutiva: o botão de confirmar fica em perigo. |
4686
+ | `confirmed` | output | `string` | | A pessoa confirmou; o motivo vem aparado ('' quando não há campo). |
4687
+ | `canceled` | output | `void` | | |
4688
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
4689
+
4690
+ ## `hm-recurrence-editor`
4691
+
4692
+ `RecurrenceEditorComponent` — import de `@trismegisto/angular/recurrence-editor` (também na raiz)
4693
+
4694
+ Editor de recorrência de um evento ("repete toda semana às terças e quintas, 10 vezes"): frequência, intervalo, dias da semana (semanal), dia do mês ou "n-ésima segunda" (mensal) e fim (nunca, depois de N vezes, numa data). `[(rule)]` é a regra (`RecurrenceRule` de `@trismegisto/primitives`, a mesma que o `hm-event-calendar` expande em `recurrence`); `null` = não repete. Para gravar como texto RR…
4695
+
4696
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4697
+ |---|---|---|---|---|
4698
+ | `rule` | model | `RecurrenceRule \| null` | `null` | Regra editada; `null` = não repete. Two-way. |
4699
+ | `startDate` | input | `IsoDate \| null` | `null` | Primeira data da série (ISO). Padrão: hoje. |
4700
+ | `label` | input | `string` | `''` | Título do grupo (padrão: "Repetição" do catálogo). |
4701
+ | `allowNone` | input | `boolean` | `true` | Oferece "Não repete" na frequência (padrão). Desligue quando a série é obrigatória (relatório agendado). |
4702
+ | `frequencies` | input | `readonly RecurrenceFrequency[]` | `RECURRENCE_FREQUENCIES` | Frequências oferecidas (e a ordem). |
4703
+ | `weekStartsOn` | input | `Weekday \| null` | `null` | Primeiro dia da semana nos botões (0 = domingo); sem ele, o do idioma. |
4704
+ | `showSummary` | input | `boolean` | `true` | Mostra o resumo em texto embaixo (padrão). |
4705
+ | `disabled` | input | `boolean` | `false` | |
4706
+ | `texts` | input | `Partial<RecurrenceMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
4707
+
4708
+ ## `hm-release-timeline`
4709
+
4710
+ `ReleaseTimelineComponent` — import de `@trismegisto/angular/release-timeline` (também na raiz)
4711
+
4712
+ Linha do tempo de deploys/releases, do mais recente para o mais antigo (na ordem recebida): versão e ambiente, data, o estado (`hm-deploy-status`), autor e nota curta, e as ações "Ver detalhes" e "Reverter", que só emitem o id. Monta sobre o `hm-timeline`.
4713
+
4714
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4715
+ |---|---|---|---|---|
4716
+ | `releases` | input | `readonly ReleaseItem[]` | `[]` | |
4717
+ | `label` | input | `string` | `''` | Nome da lista. Vazio = catálogo. |
4718
+ | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | Opções do `Intl.DateTimeFormat` da data de cada item. |
4719
+ | `showDetails` | input | `boolean` | `false` | Mostra "Ver detalhes" em cada item. |
4720
+ | `rollbackable` | input | `boolean` | `false` | Mostra "Reverter" nos itens concluídos. |
4721
+ | `texts` | input | `Partial<MonitoringTextMessages & ReleaseTimelineMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
4722
+ | `details` | output | `string` | | Pede os detalhes do item (id). |
4723
+ | `rollback` | output | `string` | | Pede para reverter para o item (id). |
4724
+
2047
4725
  ## `hm-reorder-list`
2048
4726
 
2049
4727
  `ReorderListComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/reorder-list` (também na raiz)
@@ -2066,6 +4744,96 @@ Lista reordenável (`hm-reorder-list`) por arrasto **e** por teclado. A interaç
2066
4744
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2067
4745
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2068
4746
 
4747
+ ## `hm-report-history`
4748
+
4749
+ `ReportHistoryComponent` — import de `@trismegisto/angular/report-history` (também na raiz)
4750
+
4751
+ Histórico de envios de um relatório agendado, com o status de entrega: tabela (data, status, "3 de 4 entregues", formato, tamanho, ações) da execução mais recente para a mais antiga, um resumo no topo (taxa de entrega, último entregue) e, por linha, as entregas de cada destinatário. `download` e `retry` (nas que falharam ou entregaram em parte) só emitem — reenviar de verdade é do app.
4752
+
4753
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4754
+ |---|---|---|---|---|
4755
+ | `runs` | input (obrigatório) | `readonly ReportRun[]` | | |
4756
+ | `showSummary` | input | `boolean` | `true` | Mostra o resumo (taxa de entrega, último entregue). |
4757
+ | `label` | input | `string` | `''` | Título (padrão: "Histórico de envios"). |
4758
+ | `texts` | input | `Partial<ReportHistoryMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial). |
4759
+ | `download` | output | `ReportRun` | | |
4760
+ | `retry` | output | `ReportRun` | | |
4761
+
4762
+ ## `hm-report-schedule`
4763
+
4764
+ `ReportScheduleComponent` — import de `@trismegisto/angular/report-schedule` (também na raiz)
4765
+
4766
+ Agendamento de um relatório: liga/desliga o envio automático, frequência (o `hm-recurrence-editor`, sem "não repete"), data de início, horário, formato do arquivo e destinatários (com colar vários de uma vez), e a prévia dos próximos envios. `[(value)]` é o `ReportSchedule` inteiro; os problemas que impedem salvar (`validateReportSchedule`) aparecem junto do campo, e o app chama a mesma função an…
4767
+
4768
+ Slots: `[scheduleActions]`
4769
+
4770
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4771
+ |---|---|---|---|---|
4772
+ | `value` | model | `ReportSchedule` | `defaultReportSchedule()` | O agendamento. Two-way. |
4773
+ | `formats` | input | `readonly ReportFormatOption[] \| null` | `null` | Formatos oferecidos. |
4774
+ | `previewCount` | input | `number` | `3` | Quantos próximos envios a prévia mostra (0 esconde). |
4775
+ | `showIssues` | input | `boolean` | `false` | Mostra os problemas mesmo antes de a pessoa mexer (ex.: depois de tentar salvar). |
4776
+ | `timeZoneLabel` | input | `string` | `''` | Nome do fuso dos horários ("Brasília"). |
4777
+ | `now` | input | `Date \| null` | `null` | Agora, para a prévia (padrão: o relógio do navegador). |
4778
+ | `label` | input | `string` | `''` | Título (padrão: "Agendamento do relatório"). |
4779
+ | `disabled` | input | `boolean` | `false` | |
4780
+ | `texts` | input | `Partial<ReportScheduleMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
4781
+
4782
+ ## `hm-resource-calendar`
4783
+
4784
+ `ResourceCalendarComponent` — import de `@trismegisto/angular/resource-calendar` (também na raiz)
4785
+
4786
+ Calendário de recursos e de equipe: um dia em linha do tempo horizontal, uma linha por recurso (sala, veículo, equipamento) ou pessoa (`appearance="team"`), com os compromissos posicionados pela hora e empilhados quando se sobrepõem, e o que está fora do expediente de cada um (`availability`) hachurado. Navega por dia (`[(date)]`). Só apresentação: `eventClick` abre o compromisso, `slotClick` (cl…
4787
+
4788
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4789
+ |---|---|---|---|---|
4790
+ | `resources` | input (obrigatório) | `readonly CalendarResource[]` | | |
4791
+ | `events` | input | `readonly ResourceEvent[]` | `[]` | |
4792
+ | `date` | model | `IsoDate` | `eventCalendarToday()` | Dia mostrado (ISO). Two-way. |
4793
+ | `startHour` | input | `number` | `8` | Primeira e última hora da grade. |
4794
+ | `endHour` | input | `number` | `18` | |
4795
+ | `appearance` | input | `ResourceCalendarAppearance` | `'resource'` | |
4796
+ | `timeZone` | input | `string \| null` | `null` | Fuso IANA de exibição; sem ele, o do navegador. |
4797
+ | `label` | input | `string` | `''` | Nome da grade para leitor de tela (padrão: "Calendário de recursos"). |
4798
+ | `showOccupancy` | input | `boolean` | `true` | Mostra a ocupação ("45% ocupado") embaixo do nome. |
4799
+ | `eventClick` | output | `ResourceEvent` | | |
4800
+ | `slotClick` | output | `ResourceSlotClick` | | |
4801
+ | `texts` | input | `Partial<ResourceCalendarMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
4802
+
4803
+ ## `hm-resource-usage`
4804
+
4805
+ `ResourceUsageComponent` — import de `@trismegisto/angular/resource-usage` (também na raiz)
4806
+
4807
+ Medidores de uso de recurso (CPU, memória, rede, disco ou qualquer outro): nome com ícone, o valor em texto, o nível (normal / atenção / crítico, por `thresholdLevel`) e uma barra `role="meter"`.
4808
+
4809
+ Slots: `(padrão)`
4810
+
4811
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4812
+ |---|---|---|---|---|
4813
+ | `resources` | input | `readonly ResourceUsageItem[]` | `[]` | |
4814
+ | `label` | input | `string` | `''` | Nome da lista. Vazio = catálogo. |
4815
+ | `layout` | input | `ResourceUsageLayout` | `'list'` | `list` (um embaixo do outro) ou `grid` (colunas que se ajustam à largura). |
4816
+ | `texts` | input | `Partial<MonitoringTextMessages & ResourceUsageMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
4817
+
4818
+ ## `hm-return-request`
4819
+
4820
+ `ReturnRequestComponent` — import de `@trismegisto/angular/return-request` (também na raiz)
4821
+
4822
+ Pedido de devolução e reembolso (`hm-return-request`): quais itens e quantas unidades voltam, o motivo, um comentário, como receber o reembolso e a estimativa do valor (itens − taxa de reposição + frete na devolução total), calculada por `estimateRefund`.
4823
+
4824
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4825
+ |---|---|---|---|---|
4826
+ | `lines` | input | `readonly CartLine[]` | `[]` | Itens do pedido (o `quantity` de cada linha é o máximo que pode voltar). |
4827
+ | `currency` | input | `string` | `'BRL'` | |
4828
+ | `restockingFeePercent` | input | `number` | `0` | Taxa de reposição sobre os itens, em %. |
4829
+ | `shipping` | input | `number` | `0` | Frete pago no pedido. |
4830
+ | `refundShipping` | input | `boolean` | `true` | Devolve o frete quando todas as unidades voltam. |
4831
+ | `refundMethods` | input | `readonly RefundMethod[]` | `['original', 'store-credit']` | Formas de reembolso oferecidas (a primeira é a padrão). |
4832
+ | `reasons` | input | `readonly ReturnReason[]` | `RETURN_REASONS` | Motivos oferecidos, na ordem. |
4833
+ | `submitting` | input | `boolean` | `false` | |
4834
+ | `submitted` | output | `ReturnRequest` | | |
4835
+ | `texts` | input | `CatalogOverride<ReturnRequestMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`RETURN_REQUEST_MESSAGES_PT_BR`). |
4836
+
2069
4837
  ## `hm-rich-text`
2070
4838
 
2071
4839
  `RichTextComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/rich-text` (também na raiz)
@@ -2100,6 +4868,54 @@ Métodos públicos: `focus(): void`, `apply(tool: RichTextFormatTool): void`, `u
2100
4868
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2101
4869
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2102
4870
 
4871
+ ## `hm-risk-matrix`
4872
+
4873
+ `RiskMatrixComponent` — import de `@trismegisto/angular/risk-register` (também na raiz)
4874
+
4875
+ Matriz de riscos probabilidade × impacto (5 × 5 por padrão): cada célula pinta a faixa de risco (baixo, médio, alto, crítico) e conta os riscos que caem nela; escolher uma célula filtra (`[(selected)]`).
4876
+
4877
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4878
+ |---|---|---|---|---|
4879
+ | `risks` | input (obrigatório) | `readonly RiskItem[]` | | |
4880
+ | `selected` | model | `RiskCellSelection \| null` | `null` | Célula escolhida (filtro). Two-way; `null` = nenhuma. |
4881
+ | `thresholds` | input | `readonly [number, number, number]` | `[4, 9, 16]` | Limites das faixas (`riskLevel`). |
4882
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
4883
+
4884
+ ## `hm-risk-register`
4885
+
4886
+ `RiskRegisterComponent` — import de `@trismegisto/angular/risk-register` (também na raiz)
4887
+
4888
+ Registro de riscos: a matriz probabilidade × impacto (`hm-risk-matrix`) e a tabela dos riscos, do maior para o menor, com pontuação, nível, probabilidade, impacto, responsável, status e mitigação. Escolher uma célula da matriz filtra a tabela.
4889
+
4890
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4891
+ |---|---|---|---|---|
4892
+ | `risks` | input (obrigatório) | `readonly T[]` | | |
4893
+ | `statuses` | input | `readonly WorkflowStatus[]` | `[]` | |
4894
+ | `showMatrix` | input | `boolean` | `true` | |
4895
+ | `interactive` | input | `boolean` | `false` | |
4896
+ | `thresholds` | input | `readonly [number, number, number]` | `[4, 9, 16]` | |
4897
+ | `selected` | model | `RiskCellSelection \| null` | `null` | Filtro da matriz. Two-way. |
4898
+ | `label` | input | `string` | `''` | Nome da tabela. Vazio = "Registro de riscos". |
4899
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
4900
+ | `riskClick` | output | `T` | | |
4901
+
4902
+ ## `hm-save-status`
4903
+
4904
+ `SaveStatusComponent` — import de `@trismegisto/angular/save-status` (também na raiz)
4905
+
4906
+ Indicador de salvamento: "Alterações não salvas", "Salvando…", "Salvo às 14:32", "Não foi possível salvar". Fica perto do título ou das ações do formulário/documento, principalmente com salvamento automático, onde não há um botão "Salvar" para dar a resposta.
4907
+
4908
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4909
+ |---|---|---|---|---|
4910
+ | `status` | input | `SaveStatus` | `'idle'` | A situação do salvamento. |
4911
+ | `savedAt` | input | `Date \| number \| null` | `null` | Hora do último salvamento: em `saved`, mostra "Salvo às 14:32". |
4912
+ | `text` | input | `string` | `''` | Texto próprio para a situação atual (vence o catálogo). |
4913
+ | `announce` | input | `boolean` | `true` | Anuncia o salvo e a falha ao leitor de tela. |
4914
+ | `retryable` | input | `boolean` | `false` | Mostra o botão "Tentar de novo" na falha. |
4915
+ | `retryLabel` | input | `string` | `''` | Rótulo do botão de tentar de novo. Vazio = catálogo. |
4916
+ | `texts` | input | `Partial<SaveStatusMessages>` | `{}` | Textos próprios (cada chave vence o catálogo do componente). |
4917
+ | `retry` | output | `void` | | "Tentar de novo" na falha. |
4918
+
2103
4919
  ## `hm-search-field`
2104
4920
 
2105
4921
  `SearchFieldComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/search-field` (também na raiz)
@@ -2163,6 +4979,39 @@ Slots: `(padrão)`
2163
4979
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2164
4980
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2165
4981
 
4982
+ ## `hm-service-map`
4983
+
4984
+ `ServiceMapComponent` — import de `@trismegisto/angular/service-map` (também na raiz)
4985
+
4986
+ Mapa de serviços e dependências (`hm-service-map`): o grafo em camadas de `layoutServiceGraph` (quem chama à esquerda de quem é chamado), cada nó com tipo, nome, detalhe e status (cor + ícone + texto), arestas com status e rótulo, seleção de nó (`[(selected)]` + `(nodeSelect)`) que destaca os vizinhos, e a tabela equivalente (serviço → depende de / é usado por) para quem não enxerga o desenho.
4987
+
4988
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
4989
+ |---|---|---|---|---|
4990
+ | `nodes` | input | `readonly ServiceGraphNode[]` | `[]` | |
4991
+ | `edges` | input | `readonly ServiceGraphEdge[]` | `[]` | |
4992
+ | `selected` | model | `string \| null` | `null` | Id do nó selecionado (two-way); destaca ele e os vizinhos. |
4993
+ | `label` | input | `string` | `''` | Nome do mapa. Vazio = catálogo. |
4994
+ | `texts` | input | `Partial<ServiceMapMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
4995
+ | `nodeSelect` | output | `ServiceGraphNode` | | Nó escolhido pela pessoa (ao desmarcar, não sai nada). |
4996
+
4997
+ ## `hm-service-status-list`
4998
+
4999
+ `ServiceStatusListComponent` — import de `@trismegisto/angular/service-status` (também na raiz)
5000
+
5001
+ Lista de serviços de uma status page: nome, descrição, estado (`hm-health-status`), uptime do intervalo e, se quiser, a barra de uptime de cada um (`hm-uptime-bar`). Serviços com `group` viram grupos, recolhíveis com `collapsible` — o cabeçalho do grupo mostra o pior estado dos serviços dele.
5002
+
5003
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5004
+ |---|---|---|---|---|
5005
+ | `services` | input | `readonly ServiceStatusItem[]` | `[]` | |
5006
+ | `label` | input | `string` | `''` | Nome da lista sem grupo. Vazio = catálogo. |
5007
+ | `showUptime` | input | `boolean` | `true` | Mostra o uptime (%) de cada linha. |
5008
+ | `showUptimeBar` | input | `boolean` | `false` | Mostra a barra de uptime sob cada linha que tiver `samples`. |
5009
+ | `collapsible` | input | `boolean` | `false` | Grupos recolhíveis. |
5010
+ | `collapsed` | model | `readonly string[]` | `[]` | Nomes dos grupos fechados. |
5011
+ | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `UPTIME_BAR_DATE_FORMAT` | Opções de data das barras de uptime. |
5012
+ | `digits` | input | `number` | `2` | Casas decimais das porcentagens. |
5013
+ | `texts` | input | `Partial<MonitoringTextMessages & ServiceStatusMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
5014
+
2166
5015
  ## `hm-session-recovery`
2167
5016
 
2168
5017
  `SessionRecoveryComponent` — import de `@trismegisto/angular/session-recovery` (também na raiz)
@@ -2172,7 +5021,7 @@ Botão "voltar para o aplicativo" para quando a sessão/solicitação morreu de
2172
5021
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2173
5022
  |---|---|---|---|---|
2174
5023
  | `origin` | input | `string \| null \| undefined` | `null` | URL de retorno (ex.: referrer do fluxo). Vazia, inválida ou fora de `http:`/`https:` esconde o botão. |
2175
- | `allowedOrigins` | input | `readonly string[] \| null` | `null` | Origens aceitas além da própria página (`https://app.exemplo.com`; só esquema + host + porta contam). `null`/vazio = qualquer origem `http(s)`. |
5024
+ | `allowedOrigins` | input | `readonly string[] \| null` | `null` | Origens aceitas além da própria página (`https://app.exemplo.com`; só esquema + host + porta contam). `null`/vazio = só a mesma origem da página. |
2176
5025
  | `label` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.sessionRecovery.back`). |
2177
5026
  | `navigate` | input | `boolean` | `true` | |
2178
5027
  | `returned` | output | `string` | | Emite o endereço já normalizado (absoluto) antes de navegar. |
@@ -2232,6 +5081,40 @@ Métodos públicos: `focusFirstInvalid(): void`
2232
5081
  | `control` | input | `AbstractControl \| null` | `null` | Formulário da seção: inválido impede o OK do diálogo e marca a seção na navegação. |
2233
5082
  | `invalid` | input | `boolean` | `false` | Força a seção como inválida (regra de fora do formulário, recusa do servidor). |
2234
5083
 
5084
+ ## `hm-shipment-tracking`
5085
+
5086
+ `ShipmentTrackingComponent` — import de `@trismegisto/angular/shipping` (também na raiz)
5087
+
5088
+ Rastreio de uma entrega (`hm-shipment-tracking`): situação atual, transportadora, código de rastreio (com botão de copiar), previsão de entrega, link para o site da transportadora e as movimentações, da mais recente para a mais antiga, sobre o `hm-timeline`.
5089
+
5090
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5091
+ |---|---|---|---|---|
5092
+ | `events` | input | `readonly ShipmentEvent[]` | `[]` | |
5093
+ | `carrier` | input | `string` | `''` | |
5094
+ | `code` | input | `string` | `''` | Código de rastreio. |
5095
+ | `trackingUrl` | input | `string` | `''` | Página de rastreio da transportadora. |
5096
+ | `estimatedDelivery` | input | `DateInput` | `null` | |
5097
+ | `texts` | input | `CatalogOverride<ShippingMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`SHIPPING_MESSAGES_PT_BR`). |
5098
+
5099
+ ## `hm-shipping-options`
5100
+
5101
+ `ShippingOptionsComponent` — import de `@trismegisto/angular/shipping` (também na raiz)
5102
+
5103
+ Opções de entrega (`hm-shipping-options`): cada modalidade é uma opção de rádio em cartão com preço ("Grátis" quando zero), prazo em dias úteis e a data estimada de chegada, com os selos "Mais barato" e "Mais rápido".
5104
+
5105
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5106
+ |---|---|---|---|---|
5107
+ | `options` | input | `readonly ShippingOption[]` | `[]` | |
5108
+ | `value` | model | `string` | `''` | Id da opção escolhida. |
5109
+ | `currency` | input | `string` | `'BRL'` | |
5110
+ | `from` | input | `Date \| null` | `null` | A partir de quando contar o prazo (padrão: agora). |
5111
+ | `label` | input | `string` | `''` | |
5112
+ | `legendHidden` | input | `boolean` | `false` | |
5113
+ | `emptyText` | input | `string` | `''` | |
5114
+ | `loading` | input | `boolean` | `false` | |
5115
+ | `highlight` | input | `boolean` | `true` | Mostra os selos de mais barato/mais rápido (só com duas opções ou mais). |
5116
+ | `texts` | input | `CatalogOverride<ShippingMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`SHIPPING_MESSAGES_PT_BR`). |
5117
+
2235
5118
  ## `hm-shortcut-list`
2236
5119
 
2237
5120
  `ShortcutListComponent` — import de `@trismegisto/angular/shortcut-list` (também na raiz)
@@ -2332,6 +5215,41 @@ Silhueta de carregamento no lugar do conteúdo que ainda não chegou.
2332
5215
  | `count` | input | `number` | `3` | Quantas linhas, faixas ou cartões (mínimo 1). |
2333
5216
  | `label` | input (obrigatório) | `string` | | Nome do que está carregando, para o leitor de tela. |
2334
5217
 
5218
+ ## `hm-skip-link`
5219
+
5220
+ `SkipLinkComponent` — import de `@trismegisto/angular/skip-link` (também na raiz)
5221
+
5222
+ Link "pular para o conteúdo" (WCAG 2.4.1, ignorar blocos): o primeiro focável da página, escondido até receber o foco pelo teclado. Leva quem navega por Tab direto ao conteúdo, sem passar por cabeçalho e menu a cada página.
5223
+
5224
+ Métodos públicos: `skip(event?: Event): boolean`
5225
+
5226
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5227
+ |---|---|---|---|---|
5228
+ | `target` | input | `string` | `''` | Id do destino (sem `#`). Vazio = o primeiro `<main>`/`[role="main"]`. |
5229
+ | `label` | input | `string` | `''` | Texto do link. Vazio = "Pular para o conteúdo" do catálogo. |
5230
+ | `texts` | input | `Partial<SkipLinkMessages>` | `{}` | Textos próprios (cada chave vence o catálogo do componente). |
5231
+
5232
+ ## `hm-sla-summary`
5233
+
5234
+ `SlaSummaryComponent` — import de `@trismegisto/angular/sla-summary` (também na raiz)
5235
+
5236
+ Resumo de SLA/SLO de um período: meta x medido, se cumpriu, quanto do orçamento de erro sobra (medidor), a indisponibilidade permitida e a ocorrida e, se vierem, a taxa de erro e os percentis de latência contra os objetivos. O cálculo é o `slaSummary` de `@trismegisto/primitives`.
5237
+
5238
+ Slots: `(padrão)`
5239
+
5240
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5241
+ |---|---|---|---|---|
5242
+ | `heading` | input | `string` | `''` | Nome do resumo ("API pública — outubro"). |
5243
+ | `headingLevel` | input | `SlaSummaryHeadingLevel` | `0` | `0` (padrão): o nome é só texto em destaque; `2`–`6`: vira título com esse nível. |
5244
+ | `target` | input (obrigatório) | `number` | | Meta (0..1). |
5245
+ | `actual` | input (obrigatório) | `number` | | Medido no período (0..1). |
5246
+ | `periodMs` | input | `number \| null` | `null` | Duração do período (ms), para a indisponibilidade permitida e a ocorrida. |
5247
+ | `errorRate` | input | `number \| null` | `null` | Taxa de erro medida (0..1); `null` = não mostra. |
5248
+ | `errorRateObjective` | input | `number \| null` | `null` | Taxa de erro máxima aceita (0..1). |
5249
+ | `latency` | input | `readonly SlaLatency[]` | `[]` | Percentis de latência (ms) contra o objetivo. |
5250
+ | `digits` | input | `number` | `2` | Casas decimais das porcentagens. |
5251
+ | `texts` | input | `Partial<MonitoringTextMessages & SlaSummaryMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
5252
+
2335
5253
  ## `hm-slider`
2336
5254
 
2337
5255
  `SliderComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/slider` (também na raiz)
@@ -2362,6 +5280,36 @@ Controle deslizante — valor único ou intervalo (dois polegares), com o padrã
2362
5280
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2363
5281
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2364
5282
 
5283
+ ## `hm-slot-picker`
5284
+
5285
+ `SlotPickerComponent` — import de `@trismegisto/angular/slot-picker` (também na raiz)
5286
+
5287
+ Agendamento e reserva de horário: os dias visíveis em colunas, cada um com os horários livres calculados de `availability` (faixas por dia da semana), `overrides` (feriado, plantão) e `booked` (o que já está ocupado), em passos de `duration`/`step`. A pessoa escolhe um horário (`[(selected)]`, o `id` `'2026-10-12T09:30'`) e confirma — `book` emite o horário; reservar de verdade é do app.
5288
+
5289
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5290
+ |---|---|---|---|---|
5291
+ | `availability` | input (obrigatório) | `WeeklyAvailability` | | Faixas de atendimento por dia da semana (0 = domingo). |
5292
+ | `overrides` | input | `readonly AvailabilityOverride[]` | `[]` | Exceções por data (`ranges: []` fecha o dia). |
5293
+ | `booked` | input | `readonly BookedInterval[]` | `[]` | Horários já ocupados. |
5294
+ | `duration` | input | `number` | `30` | Duração de cada horário (minutos). |
5295
+ | `step` | input | `number \| null` | `null` | Passo entre inícios (minutos); padrão = `duration`. |
5296
+ | `buffer` | input | `number` | `0` | Intervalo livre exigido depois de cada reserva (minutos). |
5297
+ | `minNotice` | input | `number` | `0` | Antecedência mínima (minutos) a partir de agora. |
5298
+ | `days` | input | `number` | `5` | Dias visíveis lado a lado. |
5299
+ | `date` | model | `IsoDate` | `todayIso()` | Primeiro dia visível (ISO). Two-way: anterior/próximo mudam. Padrão: hoje. |
5300
+ | `selected` | model | `string \| null` | `null` | Horário escolhido (`id` do `TimeSlot`). Two-way. |
5301
+ | `showUnavailable` | input | `boolean` | `false` | Mostra ocupados e passados (desabilitados). Padrão: só os livres. |
5302
+ | `confirmable` | input | `boolean` | `true` | Mostra o rodapé com o escolhido e o botão de confirmar (padrão). |
5303
+ | `confirmLabel` | input | `string` | `''` | Texto do botão de confirmar (padrão: "Confirmar horário"). |
5304
+ | `timeZoneLabel` | input | `string` | `''` | Nome do fuso, mostrado no topo ("Brasília (GMT-3)"). |
5305
+ | `minDate` | input | `IsoDate \| null` | `null` | Não volta para antes de hoje. |
5306
+ | `now` | input | `Date \| null` | `null` | Agora, para marcar horários passados (padrão: o relógio do navegador). |
5307
+ | `label` | input | `string` | `''` | |
5308
+ | `loading` | input | `boolean` | `false` | |
5309
+ | `slotSelect` | output | `TimeSlot` | | Clique num horário livre. |
5310
+ | `book` | output | `TimeSlot` | | Confirmar com um horário escolhido. |
5311
+ | `texts` | input | `Partial<SlotPickerMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
5312
+
2365
5313
  ## `hm-spinner`
2366
5314
 
2367
5315
  `SpinnerComponent` — import de `@trismegisto/angular/spinner` (também na raiz)
@@ -2378,6 +5326,29 @@ Indicador de carregamento indeterminado: o anel giratório do `.hm-spinner` (cor
2378
5326
  | `done` | input | `boolean` | `false` | Terminou: o anel vira um ✓ e o texto anunciado passa a `doneLabel` (padrão "Concluído"). |
2379
5327
  | `doneLabel` | input | `string` | `''` | O que terminou ("Servidores carregados"). Vazio cai no "Concluído" do catálogo. |
2380
5328
 
5329
+ ## `hm-split-button`
5330
+
5331
+ `SplitButtonComponent` — import de `@trismegisto/angular/split-button` (também na raiz)
5332
+
5333
+ Botão dividido: a ação principal num botão e as variações dela num menu, aberto pela seta colada ao lado ("Salvar" \| seta: "Salvar como rascunho", "Salvar e publicar").
5334
+
5335
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5336
+ |---|---|---|---|---|
5337
+ | `label` | input (obrigatório) | `string` | | Texto da ação principal (também compõe o nome da seta). |
5338
+ | `items` | input (obrigatório) | `readonly MenuItem[]` | | Variações da ação, no menu da seta. |
5339
+ | `icon` | input | `string` | `''` | Ícone antes do texto (vazio = sem ícone). O app registra o ícone que passar aqui. |
5340
+ | `emphasis` | input | `ButtonEmphasis` | `'high'` | |
5341
+ | `intent` | input | `ButtonIntent` | `'primary'` | |
5342
+ | `size` | input | `ButtonSize` | `'medium'` | |
5343
+ | `disabled` | input | `boolean` | `false` | Desabilita os dois botões. |
5344
+ | `menuDisabled` | input | `boolean` | `false` | Desabilita só a seta (a ação principal continua disponível). |
5345
+ | `menuLabel` | input | `string` | `''` | Nome acessível da seta e do menu. Vazio usa "Mais opções de {label}" do catálogo. |
5346
+ | `align` | input | `PopoverAlign` | `'end'` | Encosto do menu (padrão `end`: o menu se alinha à borda final do botão, onde está a seta). |
5347
+ | `layer` | input | `'default' \| 'above-invoker'` | `'default'` | Ver `hm-menu`: `above-invoker` quando o botão está dentro de um overlay. |
5348
+ | `clicked` | output | `void` | | A ação principal foi acionada. |
5349
+ | `chosen` | output | `string` | | Um item do menu foi escolhido (`id` do item). |
5350
+ | `texts` | input | `Partial<SplitButtonMessages>` | `{}` | Troca textos do catálogo da peça. |
5351
+
2381
5352
  ## `hm-splitter-panel`
2382
5353
 
2383
5354
  `SplitterPanelComponent` — import de `@trismegisto/angular/splitter` (também na raiz)
@@ -2482,16 +5453,47 @@ Slots: `(padrão)`
2482
5453
 
2483
5454
  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.
2484
5455
 
2485
- Slots: `[illustration]`, `(padrão)`
5456
+ Slots: `[illustration]`, `(padrão)`
5457
+
5458
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5459
+ |---|---|---|---|---|
5460
+ | `heading` | input (obrigatório) | `string` | | |
5461
+ | `description` | input | `string` | `''` | Explicação curta embaixo do título. Vazia não desenha. |
5462
+ | `situation` | input | `StateScreenSituation` | `'empty'` | |
5463
+ | `action` | input | `string` | `''` | Rótulo do botão principal. Vazio = sem botão. |
5464
+ | `actionIcon` | input | `string` | `'arrow-left'` | |
5465
+ | `actionTriggered` | output | `void` | | |
5466
+
5467
+ ## `hm-status-badge`
5468
+
5469
+ `StatusBadgeComponent` — import de `@trismegisto/angular/status-badge` (também na raiz)
5470
+
5471
+ Selo de status de um fluxo ("Aberto", "Em análise", "Concluído").
5472
+
5473
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5474
+ |---|---|---|---|---|
5475
+ | `status` | input | `WorkflowStatus \| string \| null \| undefined` | `null` | |
5476
+ | `statuses` | input | `readonly WorkflowStatus[]` | `[]` | Onde procurar quando `status` é um id. |
5477
+ | `size` | input | `StatusBadgeSize` | `'medium'` | |
5478
+ | `appearance` | input | `StatusBadgeAppearance` | `'soft'` | |
5479
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5480
+
5481
+ ## `hm-status-select`
5482
+
5483
+ `StatusSelectComponent` — import de `@trismegisto/angular/status-select` (também na raiz)
5484
+
5485
+ Seletor de status que só oferece as transições permitidas pelo fluxo, com confirmação e motivo quando a transição pede.
2486
5486
 
2487
5487
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
2488
5488
  |---|---|---|---|---|
2489
- | `heading` | input (obrigatório) | `string` | | |
2490
- | `description` | input | `string` | `''` | Explicação curta embaixo do título. Vazia não desenha. |
2491
- | `situation` | input | `StateScreenSituation` | `'empty'` | |
2492
- | `action` | input | `string` | `''` | Rótulo do botão principal. Vazio = sem botão. |
2493
- | `actionIcon` | input | `string` | `'arrow-left'` | |
2494
- | `actionTriggered` | output | `void` | | |
5489
+ | `definition` | input (obrigatório) | `WorkflowDefinition` | | |
5490
+ | `value` | model | `string \| null` | `null` | Id do status atual. Two-way. |
5491
+ | `label` | input | `string` | `''` | Nome do campo (início do nome acessível do gatilho). Vazio = "Status". |
5492
+ | `size` | input | `MenuButtonSize` | `'medium'` | |
5493
+ | `disabled` | input | `boolean` | `false` | |
5494
+ | `apply` | input | `boolean` | `true` | Atualiza `value` ao confirmar. Falso = só emite `transition` (o app aplica depois). |
5495
+ | `transition` | output | `StatusTransitionEvent` | | A pessoa pediu (e confirmou, quando era o caso) uma mudança. |
5496
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
2495
5497
 
2496
5498
  ## `hm-step`
2497
5499
 
@@ -2534,6 +5536,47 @@ Métodos públicos: `isActive(step: object): boolean`, `next(): Promise<boolean>
2534
5536
  | `hideHeading` | input | `boolean` | `false` | Título do painel só para leitor de tela (quando a tela já tem um título visível). |
2535
5537
  | `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… |
2536
5538
 
5539
+ ## `hm-storage-usage`
5540
+
5541
+ `StorageUsageComponent` — import de `@trismegisto/angular/storage-usage` (também na raiz)
5542
+
5543
+ Cota e uso de armazenamento: barra segmentada por tipo (Documentos, Imagens, Lixeira...), "2,1 GB de 15 GB usados", o que sobra e o aviso quando passa de `warnAt` (atenção) ou `criticalAt` (crítico). Sem `total`, sem cota: mostra só o usado e a divisão. Cores das fatias vêm da paleta categórica (`color` 1–8), na ordem.
5544
+
5545
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5546
+ |---|---|---|---|---|
5547
+ | `segments` | input | `readonly StorageSegment[]` | `[]` | Divisão do uso. |
5548
+ | `used` | input | `number \| null` | `null` | Usado (bytes); sem ele, a soma das fatias. Maior que a soma: a diferença vira "Outros". |
5549
+ | `total` | input | `number \| null` | `null` | Cota (bytes); `null`/0 = sem cota. |
5550
+ | `warnAt` | input | `number` | `0.8` | |
5551
+ | `criticalAt` | input | `number` | `0.95` | |
5552
+ | `label` | input | `string` | `''` | Título (padrão: "Armazenamento"). |
5553
+ | `showLegend` | input | `boolean` | `true` | |
5554
+ | `size` | input | `StorageUsageSize` | `'medium'` | |
5555
+ | `texts` | input | `Partial<StorageUsageMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (parcial), ex.: termos do domínio do app. |
5556
+
5557
+ ## `hm-swimlane-board`
5558
+
5559
+ `SwimlaneBoardComponent` — import de `@trismegisto/angular/swimlane-board` (também na raiz)
5560
+
5561
+ Quadro kanban com raias (swimlanes): as mesmas colunas repetidas por raia, e cada cartão na raia que `laneOf` disser. Cada raia é um `hm-kanban` (arrastar por ponteiro, toque e teclado, `canMove`) e pode ser recolhida.
5562
+
5563
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5564
+ |---|---|---|---|---|
5565
+ | `columns` | model | `readonly KanbanColumn<T>[]` | `[]` | O quadro inteiro. Two-way. |
5566
+ | `lanes` | input (obrigatório) | `readonly SwimlaneLane[]` | | |
5567
+ | `laneOf` | input (obrigatório) | `(item: T) => string` | | Em que raia o cartão fica (id de `lanes`). |
5568
+ | `collapsedLanes` | model | `readonly string[]` | `[]` | Ids das raias recolhidas. Two-way. |
5569
+ | `canMove` | input | `KanbanCanMove<T> \| null` | `null` | |
5570
+ | `itemKey` | input | `(item: T) => unknown` | `(item: T) => item` | |
5571
+ | `itemLabel` | input | `((item: T) => string) \| null` | `null` | |
5572
+ | `headingLevel` | input | `number` | `3` | Nível do título das raias (as colunas usam o seguinte). |
5573
+ | `disabled` | input | `boolean` | `false` | |
5574
+ | `allowLaneChange` | input | `boolean` | `false` | Deixa arrastar cartões para outra raia (emite `laneChange`; o app muda o dado). |
5575
+ | `canMoveLane` | input | `SwimlaneCanMoveLane<T> \| null` | `null` | Regra para trocar de raia; `null` = qualquer troca vale (com `allowLaneChange`). |
5576
+ | `moved` | output | `SwimlaneMoveEvent<T>` | | |
5577
+ | `laneChange` | output | `SwimlaneLaneChangeEvent<T>` | | Intenção de levar um cartão para outra raia (`allowLaneChange`). Nada é aplicado em `columns`. |
5578
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5579
+
2537
5580
  ## `hm-switch`
2538
5581
 
2539
5582
  `SwitchComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/switch` (também na raiz)
@@ -2545,7 +5588,6 @@ Interruptor de efeito imediato (ligar/desligar uma preferência). É um checkbox
2545
5588
  | `value` | model | `boolean` | `false` | |
2546
5589
  | `label` | input (obrigatório) | `string` | | |
2547
5590
  | `hint` | input | `string` | `''` | Texto de apoio embaixo do rótulo. |
2548
- | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
2549
5591
  | `labelPosition` | input | `SwitchLabelPosition` | `'after'` | Lado do rótulo. A ordem de leitura e de foco não muda. |
2550
5592
  | `loading` | input | `boolean` | `false` | Silhueta no lugar do controle enquanto o valor real não chega. |
2551
5593
  | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
@@ -2553,6 +5595,36 @@ Interruptor de efeito imediato (ligar/desligar uma preferência). É um checkbox
2553
5595
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2554
5596
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2555
5597
 
5598
+ ## `hm-sync-history`
5599
+
5600
+ `SyncHistoryComponent` — import de `@trismegisto/angular/sync-status` (também na raiz)
5601
+
5602
+ Histórico de sincronizações (`hm-sync-history`): uma tabela de `SyncRun` com estado (texto), início, duração, registros processados, falhas e quem disparou. Rola por dentro em telas estreitas.
5603
+
5604
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5605
+ |---|---|---|---|---|
5606
+ | `runs` | input | `readonly SyncRun[]` | `[]` | |
5607
+ | `now` | input | `number` | `0` | |
5608
+ | `timeZone` | input | `string \| undefined` | `undefined` | |
5609
+ | `texts` | input | `Partial<SyncStatusMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
5610
+
5611
+ ## `hm-sync-status`
5612
+
5613
+ `SyncStatusComponent` — import de `@trismegisto/angular/sync-status` (também na raiz)
5614
+
5615
+ Estado da sincronização (`hm-sync-status`): a execução atual ou a última — estado em texto, progresso (`hm-progress`, determinado quando há `total`, indeterminado sem ele), contadores de criados/atualizados/ removidos/falhas, duração, quem disparou, os erros por registro (lista recolhível) e as ações.
5616
+
5617
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5618
+ |---|---|---|---|---|
5619
+ | `run` | input | `SyncRun \| null` | `null` | Execução atual ou a última; `null` = nunca sincronizou. |
5620
+ | `now` | input | `number` | `0` | Instante atual (epoch ms) para a duração de execução em andamento. |
5621
+ | `timeZone` | input | `string \| undefined` | `undefined` | |
5622
+ | `hideActions` | input | `boolean` | `false` | Esconde as ações. |
5623
+ | `syncNow` | output | `void` | | |
5624
+ | `cancel` | output | `SyncRun` | | |
5625
+ | `retry` | output | `SyncRun` | | |
5626
+ | `texts` | input | `Partial<SyncStatusMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
5627
+
2556
5628
  ## `hm-tab-bar`
2557
5629
 
2558
5630
  `TabBarComponent` — import de `@trismegisto/angular/tab-bar` (também na raiz)
@@ -2618,6 +5690,34 @@ Slots: `[actions]`, `(padrão)`
2618
5690
  | `fillHeight` | input | `boolean` | `false` | Ocupa a altura do pai flex; o painel em exibição fica com o restante e rola por dentro. |
2619
5691
  | `noPanelGap` | input | `boolean` | `false` | Tira o respiro vertical do painel (para conteúdo que já tem o seu). |
2620
5692
 
5693
+ ## `hm-tag-input`
5694
+
5695
+ `TagInputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/tag-input` (também na raiz)
5696
+
5697
+ Campo de tags livre: a pessoa digita e confirma cada tag com Enter ou vírgula (ou cola várias de uma vez, separadas por vírgula, ponto e vírgula ou linha), e remove pelo ✕ da tag ou com Backspace no campo vazio. Diferente do `hm-combobox-multi`, o valor não precisa estar numa lista: `suggestions` só sugere (padrão Combobox do APG com `aria-autocomplete="list"`).
5698
+
5699
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5700
+ |---|---|---|---|---|
5701
+ | `label` | input (obrigatório) | `string` | | |
5702
+ | `value` | model | `readonly string[]` | `[]` | Tags, na ordem em que entraram. |
5703
+ | `placeholder` | input | `string` | `''` | Aparece só sem nenhuma tag. |
5704
+ | `hint` | input | `string` | `''` | |
5705
+ | `suggestions` | input | `readonly string[]` | `[]` | Sugestões oferecidas enquanto se digita (a pessoa pode escrever outra). |
5706
+ | `max` | input | `number \| null, unknown` | `null` | Quantidade máxima de tags (`null` libera). |
5707
+ | `maxLength` | input | `number \| null, unknown` | `null` | Comprimento máximo de cada tag (`null` libera). |
5708
+ | `allowDuplicates` | input | `boolean` | `false` | Aceita a mesma tag duas vezes. |
5709
+ | `validate` | input | `((tag: string) => string \| null \| undefined) \| null` | `null` | Validação de cada tag: devolve o texto do erro, ou `null` quando a tag é aceita. |
5710
+ | `separators` | input | `readonly string[]` | `TAG_INPUT_SEPARATORS` | Caracteres que fecham uma tag ao digitar ou colar. |
5711
+ | `addOnBlur` | input | `boolean` | `true` | Ao sair do campo, o texto digitado vira tag. |
5712
+ | `tagAdded` | output | `string` | | Tag que entrou (digitada, colada ou escolhida nas sugestões). |
5713
+ | `tagRemoved` | output | `string` | | Tag que saiu (✕ ou Backspace). |
5714
+ | `tagRejected` | output | `TagRejection` | | Tag recusada pelas regras, com o motivo. |
5715
+ | `texts` | input | `Partial<TagInputMessages>` | `{}` | Textos próprios do componente, por cima do catálogo do idioma ativo (parcial). |
5716
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
5717
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
5718
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
5719
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
5720
+
2621
5721
  ## `hm-tag`
2622
5722
 
2623
5723
  `TagComponent` — import de `@trismegisto/angular/tag` (também na raiz)
@@ -2630,6 +5730,118 @@ Etiqueta curta de categoria ou situação ("Ativa", "Rascunho", "Produção").
2630
5730
  | `color` | input | `TagColor` | `'neutral'` | |
2631
5731
  | `compact` | input | `boolean` | `false` | Só a cor, sem texto visível (o nome vai para a dica e para o leitor de tela). |
2632
5732
 
5733
+ ## `hm-task-card`
5734
+
5735
+ `TaskCardComponent` — import de `@trismegisto/angular/task-card` (também na raiz)
5736
+
5737
+ Cartão de tarefa: código, prioridade, título, etiquetas, status, prazo, subtarefas, bloqueio, estimativa e responsável — o que cabe num quadro (`hm-kanban`, `hm-swimlane-board`) ou numa grade de cartões.
5738
+
5739
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5740
+ |---|---|---|---|---|
5741
+ | `task` | input (obrigatório) | `TaskItem` | | |
5742
+ | `statuses` | input | `readonly WorkflowStatus[]` | `[]` | Status do fluxo (ids → selos). |
5743
+ | `priorityScale` | input | `LevelScaleInput` | `'priority'` | Escala da prioridade. Padrão: a pronta `priority`. |
5744
+ | `showStatus` | input | `boolean` | `true` | |
5745
+ | `blocked` | input | `boolean` | `false` | Alguma dependência ainda aberta. |
5746
+ | `openable` | input | `boolean` | `false` | O título vira botão e emite `open`. |
5747
+ | `now` | input | `WorkflowDateValue` | `null` | Fixa o "agora" do prazo. |
5748
+ | `open` | output | `TaskItem` | | |
5749
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5750
+
5751
+ ## `hm-task-list`
5752
+
5753
+ `TaskListComponent` — import de `@trismegisto/angular/task-card` (também na raiz)
5754
+
5755
+ Lista de tarefas em linhas: concluir com um clique, código, título, status, prioridade, prazo e responsável.
5756
+
5757
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5758
+ |---|---|---|---|---|
5759
+ | `tasks` | input (obrigatório) | `readonly TaskItem[]` | | |
5760
+ | `statuses` | input | `readonly WorkflowStatus[]` | `[]` | |
5761
+ | `priorityScale` | input | `LevelScaleInput` | `'priority'` | |
5762
+ | `checkable` | input | `boolean` | `false` | Caixa de concluir por linha. |
5763
+ | `openable` | input | `boolean` | `false` | O título vira botão (`open`). |
5764
+ | `disabled` | input | `boolean` | `false` | |
5765
+ | `label` | input | `string` | `''` | Nome da lista. Vazio = "Tarefas". |
5766
+ | `now` | input | `WorkflowDateValue` | `null` | |
5767
+ | `doneChange` | output | `TaskDoneChange` | | |
5768
+ | `open` | output | `TaskItem` | | |
5769
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5770
+
5771
+ ## `hm-subtask-list`
5772
+
5773
+ `SubtaskListComponent` — import de `@trismegisto/angular/task-detail` (também na raiz)
5774
+
5775
+ Subtarefas de uma tarefa: progresso, marcar como feita e, com `editable`, acrescentar e remover.
5776
+
5777
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5778
+ |---|---|---|---|---|
5779
+ | `subtasks` | model | `readonly TaskSubtask[]` | `[]` | |
5780
+ | `editable` | input | `boolean` | `false` | Acrescentar e remover. |
5781
+ | `disabled` | input | `boolean` | `false` | |
5782
+ | `label` | input | `string` | `''` | Nome da lista. Vazio = "Subtarefas". |
5783
+ | `toggled` | output | `TaskSubtask` | | |
5784
+ | `added` | output | `TaskSubtask` | | Subtarefa criada (com o id provisório). |
5785
+ | `removed` | output | `TaskSubtask` | | |
5786
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5787
+
5788
+ ## `hm-task-dependencies`
5789
+
5790
+ `TaskDependenciesComponent` — import de `@trismegisto/angular/task-detail` (também na raiz)
5791
+
5792
+ Dependências de uma tarefa: de quais ela depende ("Bloqueada por") e quais dependem dela ("Bloqueia"), com status de cada uma e, com `editable`, acrescentar e remover.
5793
+
5794
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5795
+ |---|---|---|---|---|
5796
+ | `taskId` | input (obrigatório) | `string` | | |
5797
+ | `tasks` | input (obrigatório) | `readonly TaskItem[]` | | Todas as tarefas do projeto (as dependências são lidas de `dependsOn`). |
5798
+ | `statuses` | input | `readonly WorkflowStatus[]` | `[]` | |
5799
+ | `editable` | input | `boolean` | `false` | |
5800
+ | `disabled` | input | `boolean` | `false` | |
5801
+ | `add` | output | `TaskDependencyChange` | | |
5802
+ | `remove` | output | `TaskDependencyChange` | | |
5803
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5804
+
5805
+ ## `hm-task-detail`
5806
+
5807
+ `TaskDetailComponent` — import de `@trismegisto/angular/task-detail` (também na raiz)
5808
+
5809
+ Detalhe de uma tarefa: cabeçalho (código, título, status trocável), propriedades, descrição, subtarefas, dependências e histórico — cada seção só aparece quando o dado vem.
5810
+
5811
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5812
+ |---|---|---|---|---|
5813
+ | `task` | input (obrigatório) | `TaskItem` | | |
5814
+ | `workflow` | input | `WorkflowDefinition \| null` | `null` | Fluxo do status: liga o `hm-status-select`. |
5815
+ | `tasks` | input | `readonly TaskItem[] \| null` | `null` | Tarefas do projeto: liga a seção de dependências. |
5816
+ | `history` | input | `readonly ChangeHistoryEntry[] \| null` | `null` | Histórico: liga a seção de histórico. |
5817
+ | `priorityScale` | input | `LevelScaleInput` | `'priority'` | |
5818
+ | `editable` | input | `boolean` | `false` | |
5819
+ | `headingLevel` | input | `number` | `2` | Nível do título da tarefa; as seções usam o seguinte. |
5820
+ | `now` | input | `WorkflowDateValue` | `null` | |
5821
+ | `statusChange` | output | `StatusTransitionEvent` | | |
5822
+ | `subtasksChange` | output | `readonly TaskSubtask[]` | | |
5823
+ | `dependencyAdd` | output | `TaskDependencyChange` | | |
5824
+ | `dependencyRemove` | output | `TaskDependencyChange` | | |
5825
+ | `edit` | output | `void` | | |
5826
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5827
+
5828
+ ## `hm-task-editor`
5829
+
5830
+ `TaskEditorComponent` — import de `@trismegisto/angular/task-detail` (também na raiz)
5831
+
5832
+ Editor de tarefa (criar ou editar): título, descrição, status, prioridade, responsável, início, prazo e estimativa, sobre os campos do Hermes.
5833
+
5834
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5835
+ |---|---|---|---|---|
5836
+ | `task` | input | `TaskItem \| null` | `null` | Tarefa a editar; `null` = nova. |
5837
+ | `statuses` | input | `readonly WorkflowStatus[]` | `[]` | |
5838
+ | `people` | input | `readonly WorkflowAssignee[]` | `[]` | |
5839
+ | `priorityScale` | input | `LevelScaleInput` | `'priority'` | |
5840
+ | `me` | input | `string` | `''` | Id da pessoa logada (atalho "Atribuir a mim"). |
5841
+ | `save` | output | `TaskDraft` | | |
5842
+ | `cancel` | output | `void` | | |
5843
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
5844
+
2633
5845
  ## `[hmTextareaPrefix], [hmTextareaSuffix], [hmTextareaActions], [hmTextareaActionsEnd]`
2634
5846
 
2635
5847
  `TextareaAddonDirective` — import de `@trismegisto/angular/textarea` (também na raiz)
@@ -2651,7 +5863,6 @@ Slots: `[hmTextareaPrefix]`, `[hmTextareaSuffix]`, `[hmTextareaActions]`, `[hmTe
2651
5863
  | `value` | model | `string` | `''` | |
2652
5864
  | `label` | input (obrigatório) | `string` | | |
2653
5865
  | `hint` | input | `string` | `''` | |
2654
- | `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
2655
5866
  | `placeholder` | input | `string` | `''` | |
2656
5867
  | `maxLength` | input | `number \| null` | `null` | Limite de caracteres, com contador. |
2657
5868
  | `rows` | input | `number` | `3` | |
@@ -2661,6 +5872,10 @@ Slots: `[hmTextareaPrefix]`, `[hmTextareaSuffix]`, `[hmTextareaActions]`, `[hmTe
2661
5872
  | `maxRows` | input | `number \| null` | `null` | Teto do `autoGrow`, em linhas. |
2662
5873
  | `submitKey` | input | `TextareaSubmitKey` | `'none'` | |
2663
5874
  | `submitted` | output | `string` | | |
5875
+ | `mentionCandidates` | input | `readonly MentionCandidate[] \| null` | `null` | Quem pode ser mencionado com `@`. `null` (padrão) = menções desligadas. |
5876
+ | `mentionTrigger` | input | `string` | `'@'` | Caractere que abre as sugestões. |
5877
+ | `texts` | input | `Partial<MentionsMessages>` | `{}` | Sobrescrita parcial dos textos das menções. |
5878
+ | `mentioned` | output | `MentionCandidate` | | Pessoa escolhida na lista de sugestões. |
2664
5879
  | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
2665
5880
  | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
2666
5881
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
@@ -2728,6 +5943,32 @@ Campo de hora. Digita-se a hora com máscara no relógio do idioma — 24 h (`14
2728
5943
  | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
2729
5944
  | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
2730
5945
 
5946
+ ## `hm-time-range`
5947
+
5948
+ `TimeRangeComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/time-range` (também na raiz)
5949
+
5950
+ Faixa de horário (expediente, janela de entrega, turno): dois `hm-time-picker` — início e fim — num grupo com um rótulo. O valor é um `TimeRange` (`{ start, end }`, `HH:mm` ou `null` em cada ponta) num controle só, como o `hm-date-range-picker`.
5951
+
5952
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
5953
+ |---|---|---|---|---|
5954
+ | `value` | model | `TimeRange` | `EMPTY_TIME_RANGE` | |
5955
+ | `label` | input (obrigatório) | `string` | | |
5956
+ | `labelHidden` | input | `boolean` | `false` | |
5957
+ | `hint` | input | `string` | `''` | |
5958
+ | `min` | input | `IsoTime \| number \| null \| undefined` | `null` | Primeiro horário aceito nas duas pontas (`HH:mm`). Número (o `min()` do Signal Forms) é ignorado. |
5959
+ | `max` | input | `IsoTime \| number \| null \| undefined` | `null` | Último horário aceito nas duas pontas (`HH:mm`). Número é ignorado, como no `min`. |
5960
+ | `interval` | input | `number` | `30` | |
5961
+ | `hourCycle` | input | `TimeHourCycle \| null` | `null` | |
5962
+ | `overnight` | input | `boolean` | `false` | Aceita fim antes do início como "termina no dia seguinte". |
5963
+ | `showDuration` | input | `boolean` | `false` | Mostra a duração da faixa embaixo do campo. |
5964
+ | `startLabel` | input | `string` | `''` | Nome da ponta inicial (padrão: catálogo, "Início"). |
5965
+ | `endLabel` | input | `string` | `''` | Nome da ponta final (padrão: catálogo, "Fim"). |
5966
+ | `texts` | input | `Partial<TimeRangeMessages>` | `{}` | Textos próprios (sobrescrevem os do catálogo da peça, por chave). |
5967
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
5968
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
5969
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
5970
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
5971
+
2731
5972
  ## `hm-timeline-item`
2732
5973
 
2733
5974
  `TimelineItemComponent` — import de `@trismegisto/angular/timeline` (também na raiz)
@@ -2763,9 +6004,13 @@ Linha do tempo de um processo que se acompanha: cada `hm-timeline-item` vira um
2763
6004
 
2764
6005
  `ToastStackComponent` — import de `@trismegisto/angular/toast` (também na raiz)
2765
6006
 
2766
- 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 />`).
6007
+ Onde os avisos do `HermesToastService` aparecem: uma pilha fixa num canto da tela (padrão: em cima, do lado do fim da linha). Monte uma vez, no layout do app (`<router-outlet /><hm-toast-stack />`).
2767
6008
 
2768
- _Sem inputs/outputs._
6009
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6010
+ |---|---|---|---|---|
6011
+ | `position` | input | `ToastStackPosition \| undefined` | `undefined` | Canto da tela. Vazio: o do `provideHermesToast()`, ou `'top-end'`. |
6012
+ | `expand` | input | `boolean \| undefined` | `undefined` | Sempre aberta (todos os visíveis inteiros), sem precisar de ponteiro/foco. Vazio: o do provider, ou `false`. |
6013
+ | `visibleToasts` | input | `number \| undefined` | `undefined` | Quantos aparecem de cada vez; os outros esperam escondidos na fila. Vazio: o do provider, ou 3. |
2769
6014
 
2770
6015
  ## `hm-toast`
2771
6016
 
@@ -2869,6 +6114,184 @@ Métodos públicos: `show(): void`, `hide(): void`
2869
6114
  | `hmTooltipShowDelay` | input | `number` | `400` | Espera antes de abrir no hover (ms). No foco abre na hora. |
2870
6115
  | `hmTooltipHideDelay` | input | `number` | `120` | Espera antes de fechar ao sair o ponteiro (ms) — o tempo de chegar com ele até a dica. |
2871
6116
 
6117
+ ## `hm-tour`
6118
+
6119
+ `TourComponent` — import de `@trismegisto/angular/tour` (também na raiz)
6120
+
6121
+ Tour guiado (coachmark): apresenta partes da tela uma de cada vez. Cada passo destaca um elemento (recorte no véu) e mostra, ancorado nele, um cartão com título, texto e **Anterior / Próximo / Pular**.
6122
+
6123
+ Métodos públicos: `start(index = 0): void`, `stop(): void`, `act(action: TourAction): void`
6124
+
6125
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6126
+ |---|---|---|---|---|
6127
+ | `open` | model | `boolean` | `false` | Tour em andamento. `[(open)]`: o componente grava `false` ao concluir ou pular. |
6128
+ | `steps` | input (obrigatório) | `readonly TourStep[]` | | Os passos, em ordem. |
6129
+ | `index` | model | `number` | `0` | Passo atual (`[(index)]`). Ao abrir, o tour começa nele. |
6130
+ | `headingLevel` | input | `number` | `2` | Nível do título do cartão para o leitor de tela (`aria-level`). |
6131
+ | `spotlightPadding` | input | `number` | `8` | Folga (px) entre o alvo e a borda do recorte. |
6132
+ | `skipLabel` | input | `string` | `''` | Rótulo do botão de pular. Vazio usa o catálogo ("Pular tour"). |
6133
+ | `finishLabel` | input | `string` | `''` | Rótulo do botão do último passo. Vazio usa o catálogo ("Concluir"). |
6134
+ | `finished` | output | `void` | | A pessoa chegou ao fim (Próximo/Concluir no último passo). |
6135
+ | `skipped` | output | `number` | | A pessoa pulou (botão Pular ou `Esc`); traz o índice do passo em que estava. |
6136
+ | `texts` | input | `Partial<TourMessages>` | `{}` | Troca textos do catálogo da peça. |
6137
+
6138
+ ## `hm-trace-waterfall`
6139
+
6140
+ `TraceWaterfallComponent` — import de `@trismegisto/angular/trace-waterfall` (também na raiz)
6141
+
6142
+ Trace distribuído em cascata (`hm-trace-waterfall`): a árvore de spans (`layoutTraceWaterfall`) com recolher/expandir, cada barra posicionada pelo início e pela duração relativos ao trace, cor por serviço (`--hm-data-categorical-N`, com legenda), erro destacado com ícone + texto, eixo de tempo (`traceTicks`), caminho crítico opcional, seleção (`[(selected)]` + `(spanSelect)`) e painel de atributo…
6143
+
6144
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6145
+ |---|---|---|---|---|
6146
+ | `spans` | input | `readonly TraceSpan[]` | `[]` | |
6147
+ | `collapsed` | model | `ReadonlySet<string>` | `new Set()` | Ids dos spans recolhidos (two-way). |
6148
+ | `selected` | model | `string \| null` | `null` | Id do span selecionado (two-way). |
6149
+ | `criticalPath` | input | `boolean` | `false` | Destaca a cadeia de spans que determina a duração total. |
6150
+ | `detail` | input | `boolean` | `true` | Mostra o painel de atributos do span selecionado. |
6151
+ | `headingLevel` | input | `number` | `3` | Nível do título do painel de detalhe. |
6152
+ | `label` | input | `string` | `''` | Nome da árvore. Vazio = catálogo. |
6153
+ | `texts` | input | `Partial<TraceWaterfallMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
6154
+ | `spanSelect` | output | `TraceSpan` | | Span escolhido pela pessoa (clique, Enter ou Espaço). |
6155
+
6156
+ ## `hm-trace`
6157
+
6158
+ `TraceComponent` — import de `@trismegisto/angular/trace` (também na raiz)
6159
+
6160
+ As etapas de um trabalho automático, na ordem em que acontecem: as ferramentas que um agente chamou, os passos de uma tarefa. Só apresenta o que recebe; quem acompanha o andamento é o app.
6161
+
6162
+ Slots: `(padrão)`
6163
+
6164
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6165
+ |---|---|---|---|---|
6166
+ | `label` | input | `string` | `''` | Nome acessível da lista. |
6167
+
6168
+ ## `hm-trace-item`
6169
+
6170
+ `TraceItemComponent` — import de `@trismegisto/angular/trace` (também na raiz)
6171
+
6172
+ Uma etapa do `hm-trace`. O estado aparece no desenho e, para leitor de tela, em texto. Com `expandable`, a linha vira um botão que mostra o conteúdo projetado (a saída de uma ferramenta, por exemplo), que pode trazer outro `hm-trace`. Com `href`, a linha vira um link (um passo que aponta para outra tela ou para um arquivo).
6173
+
6174
+ Slots: `(padrão)`
6175
+
6176
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6177
+ |---|---|---|---|---|
6178
+ | `heading` | input (obrigatório) | `string` | | |
6179
+ | `detail` | input | `string` | `''` | Texto curto ao lado do título (o ambiente, a duração). |
6180
+ | `status` | input | `TraceStatus` | `'pending'` | |
6181
+ | `expandable` | input | `boolean` | `false` | A linha abre o conteúdo projetado. |
6182
+ | `open` | model | `boolean` | `false` | Com `expandable`, se o conteúdo está aberto. |
6183
+ | `href` | input | `string` | `''` | Destino da linha (ignorado com `expandable`, que já é um botão). |
6184
+ | `external` | input | `boolean` | `false` | Com `href`: abre em nova aba. |
6185
+ | `texts` | input | `Partial<TraceMessages>` | `{}` | Sobrescrita parcial dos textos de estado. |
6186
+
6187
+ ## `hm-payment-history`
6188
+
6189
+ `PaymentHistoryComponent` — import de `@trismegisto/angular/transaction` (também na raiz)
6190
+
6191
+ Histórico de pagamentos (`hm-payment-history`): uma tabela por mês (mais recente primeiro) com data, descrição, meio, situação e valor, o total do mês, busca por texto e filtro por situação, e o botão de recibo por linha.
6192
+
6193
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6194
+ |---|---|---|---|---|
6195
+ | `payments` | input | `readonly PaymentRecord[]` | `[]` | |
6196
+ | `currency` | input | `string` | `'BRL'` | |
6197
+ | `showFilters` | input | `boolean` | `true` | |
6198
+ | `receipts` | input | `boolean` | `false` | Botão de recibo nas linhas pagas. |
6199
+ | `selectable` | input | `boolean` | `false` | A descrição vira botão que emite `view`. |
6200
+ | `emptyText` | input | `string` | `''` | |
6201
+ | `receipt` | output | `PaymentRecord` | | |
6202
+ | `view` | output | `PaymentRecord` | | |
6203
+ | `texts` | input | `CatalogOverride<TransactionMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`TRANSACTION_MESSAGES_PT_BR`). |
6204
+
6205
+ ## `hm-transaction-detail`
6206
+
6207
+ `TransactionDetailComponent` — import de `@trismegisto/angular/transaction` (também na raiz)
6208
+
6209
+ Detalhe de uma transação (`hm-transaction-detail`): valor com sinal de entrada/saída, situação, data, meio de pagamento, contraparte, tarifas, reembolsado, valor líquido, identificador copiável, o histórico (`hm-transaction-timeline`) e as ações "Reembolsar" (pago, com saldo a devolver) e "Tentar de novo" (recusado).
6210
+
6211
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6212
+ |---|---|---|---|---|
6213
+ | `transaction` | input (obrigatório) | `TransactionInfo` | | |
6214
+ | `showTimeline` | input | `boolean` | `true` | |
6215
+ | `refundable` | input | `boolean` | `true` | Oferece "Reembolsar" quando cabe. |
6216
+ | `retryable` | input | `boolean` | `true` | Oferece "Tentar de novo" quando recusado. |
6217
+ | `refund` | output | `void` | | |
6218
+ | `retry` | output | `void` | | |
6219
+ | `texts` | input | `CatalogOverride<TransactionMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`TRANSACTION_MESSAGES_PT_BR`). |
6220
+
6221
+ ## `hm-transaction-status`
6222
+
6223
+ `TransactionStatusComponent` — import de `@trismegisto/angular/transaction` (também na raiz)
6224
+
6225
+ Situação de uma transação de pagamento (`hm-transaction-status`): pendente, autorizado, pago, recusado, cancelado, reembolsado, reembolso parcial, em disputa ou expirado, num `hm-tag` com o tom certo.
6226
+
6227
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6228
+ |---|---|---|---|---|
6229
+ | `status` | input (obrigatório) | `TransactionStatus` | | |
6230
+ | `compact` | input | `boolean` | `false` | |
6231
+ | `texts` | input | `CatalogOverride<TransactionMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`TRANSACTION_MESSAGES_PT_BR`). |
6232
+
6233
+ ## `hm-transaction-timeline`
6234
+
6235
+ `TransactionTimelineComponent` — import de `@trismegisto/angular/transaction` (também na raiz)
6236
+
6237
+ Histórico de uma transação (`hm-transaction-timeline`): cada mudança de situação na ordem em que aconteceu, sobre o `hm-timeline`. O último evento fica "em andamento" enquanto a transação está pendente ou autorizada, "com erro" quando terminou em recusa, disputa, expiração ou cancelamento.
6238
+
6239
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6240
+ |---|---|---|---|---|
6241
+ | `events` | input | `readonly TransactionEvent[]` | `[]` | |
6242
+ | `orientation` | input | `TimelineOrientation` | `'vertical'` | |
6243
+ | `label` | input | `string` | `''` | |
6244
+ | `texts` | input | `CatalogOverride<TransactionMessages> \| null` | `null` | Sobrescreve textos do catálogo da peça (`TRANSACTION_MESSAGES_PT_BR`). |
6245
+
6246
+ ## `hm-tree-select-multi`
6247
+
6248
+ `TreeSelectMultiComponent` · `ControlValueAccessor` · estende `TreeSelectBase` — import de `@trismegisto/angular/tree-select` (também na raiz)
6249
+
6250
+ Escolha de VÁRIOS itens numa hierarquia (permissões, regiões atendidas), como campo de formulário. O cartão traz a busca e o `hm-tree` com caixas tri-state: marcar uma pasta marca as folhas dela, e a pasta mostra "parcial" quando só parte está marcada. O campo mostra os escolhidos em fichas (as primeiras `maxChips`, depois "+N"), cada uma com o X para tirar; o X do fim limpa tudo.
6251
+
6252
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6253
+ |---|---|---|---|---|
6254
+ | `value` | model | `readonly string[]` | `EMPTY` | |
6255
+ | `maxChips` | input | `number` | `3` | Quantas fichas aparecem antes do "+N". |
6256
+ | `nodes` | input (obrigatório) (herdado) | `readonly TreeNode[]` | | |
6257
+ | `label` | input (obrigatório) (herdado) | `string` | | |
6258
+ | `labelHidden` | input (herdado) | `boolean` | `false` | |
6259
+ | `hint` | input (herdado) | `string` | `''` | |
6260
+ | `placeholder` | input (herdado) | `string` | `''` | |
6261
+ | `searchable` | input (herdado) | `boolean` | `true` | Caixa de busca no topo do cartão (poda a árvore pelo rótulo, sem acento nem maiúscula). |
6262
+ | `loadChildren` | input (herdado) | `TreeChildrenLoader \| null` | `null` | Filhos sob demanda e paginados — o mesmo contrato do `loadChildren` do `hm-tree`. |
6263
+ | `emptyMessage` | input (herdado) | `string` | `''` | Texto quando não há opção nenhuma (padrão: catálogo). |
6264
+ | `texts` | input (herdado) | `Partial<TreeSelectMessages>` | `{}` | Textos próprios (sobrescrevem os do catálogo da peça, por chave). |
6265
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
6266
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
6267
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
6268
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
6269
+
6270
+ ## `hm-tree-select`
6271
+
6272
+ `TreeSelectComponent` · `ControlValueAccessor` · estende `TreeSelectBase` — import de `@trismegisto/angular/tree-select` (também na raiz)
6273
+
6274
+ Escolha de UM item numa hierarquia (categoria, unidade da organização, pasta), como campo de formulário. O gatilho mostra o escolhido (com `showPath`, o caminho inteiro: "Brasil / São Paulo / Campinas"); o cartão traz a busca e o `hm-tree` em `selectionMode="single"`, com o teclado dele (setas, Home/End, `*`, busca por letra). Clique ou Enter escolhe e fecha; Espaço escolhe e mantém aberto. Com `…
6275
+
6276
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6277
+ |---|---|---|---|---|
6278
+ | `value` | model | `string \| null` | `null` | |
6279
+ | `leavesOnly` | input | `boolean` | `false` | Só folhas podem ser escolhidas; uma pasta só abre e fecha. |
6280
+ | `showPath` | input | `boolean` | `false` | O gatilho mostra o caminho inteiro até o escolhido, não só o rótulo dele. |
6281
+ | `nodes` | input (obrigatório) (herdado) | `readonly TreeNode[]` | | |
6282
+ | `label` | input (obrigatório) (herdado) | `string` | | |
6283
+ | `labelHidden` | input (herdado) | `boolean` | `false` | |
6284
+ | `hint` | input (herdado) | `string` | `''` | |
6285
+ | `placeholder` | input (herdado) | `string` | `''` | |
6286
+ | `searchable` | input (herdado) | `boolean` | `true` | Caixa de busca no topo do cartão (poda a árvore pelo rótulo, sem acento nem maiúscula). |
6287
+ | `loadChildren` | input (herdado) | `TreeChildrenLoader \| null` | `null` | Filhos sob demanda e paginados — o mesmo contrato do `loadChildren` do `hm-tree`. |
6288
+ | `emptyMessage` | input (herdado) | `string` | `''` | Texto quando não há opção nenhuma (padrão: catálogo). |
6289
+ | `texts` | input (herdado) | `Partial<TreeSelectMessages>` | `{}` | Textos próprios (sobrescrevem os do catálogo da peça, por chave). |
6290
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
6291
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
6292
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
6293
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
6294
+
2872
6295
  ## `hm-tree`
2873
6296
 
2874
6297
  `TreeComponent` — import de `@trismegisto/angular/tree` (também na raiz)
@@ -2903,6 +6326,135 @@ Conteúdo próprio do nó (no lugar de ícone + rótulo): `<ng-template hmTreeNo
2903
6326
 
2904
6327
  _Sem inputs/outputs._
2905
6328
 
6329
+ ## `hm-uptime-bar`
6330
+
6331
+ `UptimeBarComponent` — import de `@trismegisto/angular/uptime-bar` (também na raiz)
6332
+
6333
+ Barra de uptime: um traço por período (dia, hora), colorido pelo estado do período (`uptimeHealth`, ou o `status` que o período trouxer), com o uptime total do intervalo (`uptimeRatio`) ao lado do nome.
6334
+
6335
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6336
+ |---|---|---|---|---|
6337
+ | `samples` | input | `readonly UptimeSample[]` | `[]` | Períodos em ordem de tempo (o mais antigo primeiro). |
6338
+ | `label` | input | `string` | `''` | Nome da barra (o serviço). Vazio = "Uptime" do catálogo. |
6339
+ | `thresholds` | input | `UptimeThresholds` | `DEFAULT_UPTIME_THRESHOLDS` | Limiares que classificam o uptime de cada período. |
6340
+ | `dateFormat` | input | `Intl.DateTimeFormatOptions` | `UPTIME_BAR_DATE_FORMAT` | Opções do `Intl.DateTimeFormat` da data de cada período. |
6341
+ | `digits` | input | `number` | `2` | Casas decimais das porcentagens. |
6342
+ | `labelHidden` | input | `boolean` | `false` | Esconde o nome visualmente (ele continua no nome da lista de períodos). |
6343
+ | `showSummary` | input | `boolean` | `true` | Mostra o uptime total ao lado do nome. |
6344
+ | `showRange` | input | `boolean` | `true` | Mostra a data do primeiro e do último período embaixo da barra. |
6345
+ | `texts` | input | `Partial<MonitoringTextMessages & UptimeBarMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
6346
+
6347
+ ## `hm-role-badge`
6348
+
6349
+ `RoleBadgeComponent` — import de `@trismegisto/angular/user-card` (também na raiz)
6350
+
6351
+ Selo do papel de alguém num recurso ("Editor", "Leitor") ou de dono.
6352
+
6353
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6354
+ |---|---|---|---|---|
6355
+ | `name` | input | `string` | `''` | Nome do papel. Ignorado quando `owner`. |
6356
+ | `owner` | input | `boolean` | `false` | Selo de dono (coroa + texto do catálogo). |
6357
+ | `tone` | input | `RoleBadgeTone` | `'neutral'` | |
6358
+ | `icon` | input | `string` | `''` | Ícone do catálogo antes do nome (decorativo). |
6359
+ | `texts` | input | `Partial<UserCardMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
6360
+
6361
+ ## `hm-team-card`
6362
+
6363
+ `TeamCardComponent` — import de `@trismegisto/angular/user-card` (também na raiz)
6364
+
6365
+ Cartão de uma equipe (ou grupo, departamento): ícone, nome, descrição, contagem de membros e os rostos dos primeiros.
6366
+
6367
+ Slots: `[teamCardMeta]`, `(padrão)`
6368
+
6369
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6370
+ |---|---|---|---|---|
6371
+ | `name` | input (obrigatório) | `string` | | |
6372
+ | `description` | input | `string` | `''` | |
6373
+ | `members` | input | `readonly AvatarGroupPerson[]` | `[]` | Primeiros membros (rostos da pilha). |
6374
+ | `memberCount` | input | `number \| null` | `null` | Total de membros; `null` = o tamanho de `members`. |
6375
+ | `maxAvatars` | input | `number` | `4` | Quantos rostos antes do "+N". |
6376
+ | `icon` | input | `string` | `'users'` | |
6377
+ | `headingLevel` | input | `PeopleCardHeadingLevel` | `0` | |
6378
+ | `compact` | input | `boolean` | `false` | |
6379
+ | `texts` | input | `Partial<UserCardMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
6380
+
6381
+ ## `hm-user-card`
6382
+
6383
+ `UserCardComponent` — import de `@trismegisto/angular/user-card` (também na raiz)
6384
+
6385
+ Cartão de uma pessoa: foto (ou iniciais) com presença, nome, cargo, papel, e-mail e ações.
6386
+
6387
+ Slots: `[userCardMeta]`, `(padrão)`
6388
+
6389
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6390
+ |---|---|---|---|---|
6391
+ | `name` | input (obrigatório) | `string` | | |
6392
+ | `jobTitle` | input | `string` | `''` | Cargo ou função ("Analista de dados"). |
6393
+ | `description` | input | `string` | `''` | Uma frase sobre a pessoa (opcional). |
6394
+ | `email` | input | `string` | `''` | |
6395
+ | `imageUrl` | input | `string \| null \| undefined` | `null` | |
6396
+ | `presence` | input | `PresenceStatus \| null` | `null` | Ponto de presença no avatar; `null` = sem ponto. |
6397
+ | `roleName` | input | `string` | `''` | Nome do papel no recurso em questão ("Editor"). |
6398
+ | `owner` | input | `boolean` | `false` | |
6399
+ | `headingLevel` | input | `PeopleCardHeadingLevel` | `0` | |
6400
+ | `compact` | input | `boolean` | `false` | Avatar menor e menos respiro (lista lateral, popover). |
6401
+ | `texts` | input | `Partial<UserCardMessages>` | `{}` | Sobrescrita parcial dos textos da peça (padrão: o catálogo do idioma ativo). |
6402
+
6403
+ ## `hm-vehicle-plate-input`
6404
+
6405
+ `VehiclePlateInputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/vehicle-plate` (também na raiz)
6406
+
6407
+ Campo de placa de veículo (`hm-vehicle-plate-input`). Aceita um ou mais formatos (`formats`, ids de `@trismegisto/primitives`; padrão: placa brasileira Mercosul **e** antiga) e decide a máscara pelo que já foi digitado (`plateMaskFor`): `ABC1D23` segue Mercosul, `ABC1234` vira `ABC-1234`. O modelo guarda o valor cru em maiúsculas (`ABC1D23`), sem separador.
6408
+
6409
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6410
+ |---|---|---|---|---|
6411
+ | `value` | model | `string` | `''` | |
6412
+ | `label` | input (obrigatório) | `string` | | |
6413
+ | `formats` | input | `readonly string[]` | `['br-mercosul', 'br-legacy']` | Formatos aceitos (ids), em ordem de preferência. |
6414
+ | `placeholder` | input | `string` | `''` | |
6415
+ | `labelHidden` | input | `boolean` | `false` | |
6416
+ | `hint` | input | `string` | `''` | Texto de apoio. Padrão: exemplos dos formatos aceitos. |
6417
+ | `convertLegacy` | input | `boolean` | `false` | Placa antiga brasileira: mostra a equivalente Mercosul e o botão de trocar. |
6418
+ | `preview` | input | `boolean` | `false` | Desenho da placa abaixo do campo. |
6419
+ | `texts` | input | `Partial<VehiclePlateMessages> \| null` | `null` | Sobrescrita parcial dos textos (o app troca a frase sem mudar de idioma). |
6420
+ | `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
6421
+ | `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
6422
+ | `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
6423
+ | `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
6424
+
6425
+ ## `hm-webhook-deliveries`
6426
+
6427
+ `WebhookDeliveriesComponent` — import de `@trismegisto/angular/webhook` (também na raiz)
6428
+
6429
+ Histórico de entregas de um webhook (`hm-webhook-deliveries`): tabela com evento, status HTTP, resultado, tentativa, duração e quando, a taxa de sucesso no topo e, ao abrir uma entrega, a requisição e a resposta (cabeçalhos com `redactHeaders`, corpo com `prettyPayload` num `hm-code-viewer` JSON) e o **Reenviar**.
6430
+
6431
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6432
+ |---|---|---|---|---|
6433
+ | `deliveries` | input | `readonly WebhookDelivery[]` | `[]` | |
6434
+ | `selectedId` | model | `string \| null` | `null` | Entrega aberta. Two-way. |
6435
+ | `resendingId` | input | `string \| null` | `null` | Entrega sendo reenviada (o botão carrega). |
6436
+ | `timeZone` | input | `string \| undefined` | `undefined` | |
6437
+ | `resend` | output | `WebhookDelivery` | | Pede o reenvio da entrega. |
6438
+ | `texts` | input | `Partial<WebhookMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
6439
+
6440
+ ## `hm-webhook-editor`
6441
+
6442
+ `WebhookEditorComponent` — import de `@trismegisto/angular/webhook` (também na raiz)
6443
+
6444
+ Editor de webhook (`hm-webhook-editor`): URL de destino (validada por `webhookUrlIssue`), segredo de assinatura mascarado, eventos agrupados pelo prefixo (`groupWebhookEvents`) com "marcar o grupo inteiro", e o interruptor de ativo. Emite `save`, `sendTest` e `generateSecret` — só intenções.
6445
+
6446
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6447
+ |---|---|---|---|---|
6448
+ | `events` | input | `readonly WebhookEventType[]` | `[]` | Eventos assináveis. |
6449
+ | `value` | model | `WebhookConfig` | `EMPTY_WEBHOOK_CONFIG` | Configuração. Two-way. |
6450
+ | `requireHttps` | input | `boolean` | `true` | |
6451
+ | `saving` | input | `boolean` | `false` | Salvando: o Salvar carrega. |
6452
+ | `sending` | input | `boolean` | `false` | Enviando o evento de teste. |
6453
+ | `save` | output | `WebhookConfig` | | |
6454
+ | `sendTest` | output | `WebhookConfig` | | |
6455
+ | `generateSecret` | output | `void` | | Pede um segredo novo (o app gera e devolve em `value.secret`). |
6456
+ | `texts` | input | `Partial<WebhookMessages> \| null` | `null` | Sobrescrita parcial dos textos da pasta (o app troca a frase sem mudar de idioma). |
6457
+
2906
6458
  ## `hm-wizard`
2907
6459
 
2908
6460
  `WizardComponent` — import de `@trismegisto/angular/wizard` (também na raiz)
@@ -2935,6 +6487,49 @@ Métodos públicos: `isActive(step: object): boolean`
2935
6487
  | `completed` | output | `void` | | Concluir com a última etapa válida. |
2936
6488
  | `cancelled` | output | `void` | | Cancelado (e confirmado, se `confirmCancel`). |
2937
6489
 
6490
+ ## `hm-workflow-diagram`
6491
+
6492
+ `WorkflowDiagramComponent` — import de `@trismegisto/angular/workflow-diagram` (também na raiz)
6493
+
6494
+ Diagrama de um fluxo: cada status é uma caixa, em colunas pela distância ao status inicial, e cada transição uma seta (as que voltam para trás passam por baixo, em curva). Destaca o status inicial e o atual.
6495
+
6496
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6497
+ |---|---|---|---|---|
6498
+ | `definition` | input (obrigatório) | `WorkflowDefinition` | | |
6499
+ | `current` | input | `string \| null` | `null` | Status atual (destacado). |
6500
+ | `label` | input | `string` | `''` | Nome do diagrama. Vazio = "Diagrama do fluxo". |
6501
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
6502
+
6503
+ ## `hm-workflow-editor`
6504
+
6505
+ `WorkflowEditorComponent` — import de `@trismegisto/angular/workflow-diagram` (também na raiz)
6506
+
6507
+ Editor de fluxo: os status (nome, categoria, cor, ordem, inicial), a matriz de transições "de → para" e a prévia no `hm-workflow-diagram`, com os problemas do fluxo apontados em texto.
6508
+
6509
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6510
+ |---|---|---|---|---|
6511
+ | `definition` | model (obrigatório) | `WorkflowDefinition` | | |
6512
+ | `preview` | input | `boolean` | `true` | |
6513
+ | `headingLevel` | input | `number` | `3` | |
6514
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
6515
+
6516
+ ## `hm-workload`
6517
+
6518
+ `WorkloadComponent` — import de `@trismegisto/angular/workload` (também na raiz)
6519
+
6520
+ Carga de trabalho, alocação e capacidade: uma tabela pessoa × período em que cada célula mostra o alocado contra a capacidade ("32 de 40") com uma barra e o estado (livre, com folga, equilibrado, no limite, sobrecarregado), mais o total de cada pessoa.
6521
+
6522
+ | Nome | Tipo | Tipo TS | Padrão | Descrição |
6523
+ |---|---|---|---|---|
6524
+ | `people` | input (obrigatório) | `readonly WorkloadPerson[]` | | |
6525
+ | `periods` | input (obrigatório) | `readonly WorkloadPeriod[]` | | |
6526
+ | `allocations` | input (obrigatório) | `readonly WorkloadAllocation[]` | | |
6527
+ | `unit` | input | `string` | `''` | Unidade escrita depois dos números ("h", "pts"). Vazio = só o número. |
6528
+ | `interactive` | input | `boolean` | `false` | Cada célula vira botão e emite `cellClick`. |
6529
+ | `label` | input | `string` | `''` | Nome da tabela. Vazio = "Carga de trabalho". |
6530
+ | `texts` | input | `WorkflowTextOverride \| null` | `null` | Sobrescreve textos desta peça (parcial; o resto segue o idioma ativo). |
6531
+ | `cellClick` | output | `WorkloadCellEvent` | | |
6532
+
2938
6533
  ## `hm-workspace-node`
2939
6534
 
2940
6535
  `WorkspaceNodeComponent` — import de `@trismegisto/angular/workspace` (também na raiz)
@@ -2946,10 +6541,14 @@ Um nó da árvore do `hm-workspace`: ou é um painel-folha (fileira de abas + co
2946
6541
  | `node` | input (obrigatório) | `PanelNode` | | |
2947
6542
  | `path` | input | `SplitPath` | `[]` | |
2948
6543
  | `store` | input (obrigatório) | `WorkspaceStore` | | |
6544
+ | `tree` | input (obrigatório) | `PanelNode` | | A árvore inteira (a raiz): o limite da grade é sobre ela, não sobre este nó. |
2949
6545
  | `focusedPanelId` | input (obrigatório) | `string` | | |
2950
6546
  | `panelLabels` | input (obrigatório) | `ReadonlyMap<string, string>` | | |
2951
6547
  | `contentTemplate` | input (obrigatório) | `TemplateRef<WorkspaceTabContext>` | | |
2952
6548
  | `keepAlive` | input | `boolean` | `false` | Ver `hm-workspace`: mantém as abas inativas montadas, escondidas. |
6549
+ | `split` | input | `boolean` | `true` | Ver `hm-workspace`: `false` = nenhum caminho divide nem move aba entre painéis. |
6550
+ | `maxColumns` | input | `number \| null` | `null` | Ver `hm-workspace`: limite de painéis lado a lado / empilhados (`null` = sem limite). |
6551
+ | `maxRows` | input | `number \| null` | `null` | |
2953
6552
  | `newTabRequested` | output | `string` | | O `+` de algum painel (não importa quão fundo na árvore) — borbulha até a raiz. O motor não sabe o que uma aba nova deveria conter (apresentacional, como o res… |
2954
6553
 
2955
6554
  ## `hm-workspace`
@@ -2967,6 +6566,9 @@ Templates no conteúdo: `<ng-template #content>`
2967
6566
  | `initialTabs` | input | `readonly TabItem[]` | `[]` | Abas do painel inicial (único, antes de qualquer divisão) — ignorado se `providedStore` vier preenchido. |
2968
6567
  | `initialActiveId` | input | `string` | `''` | Vazio = a primeira aba de `initialTabs`. |
2969
6568
  | `keepAlive` | input | `boolean` | `false` | Mantém montada a página de cada aba (as inativas ficam só escondidas) em vez de recriar a tela a cada troca de aba -- preserva estado, filtros, rolagem e requi… |
6569
+ | `split` | input | `boolean` | `true` | Deixa a pessoa dividir a área em painéis e mover abas entre eles (arrasto até a borda ou outro painel, menu de contexto da aba e atalhos). `false` = só o paine… |
6570
+ | `maxColumns` | input | `number \| null` | `null` | No máximo tantos painéis lado a lado (`null` = sem limite). Toda divisão oferecida à pessoa respeita: a bússola do arrasto, o botão de painéis, o menu de conte… |
6571
+ | `maxRows` | input | `number \| null` | `null` | No máximo tantos painéis empilhados (`null` = sem limite). Ver `maxColumns`. |
2970
6572
  | `label` | input | `string` | `''` | Nome da região (`aria-label`). Padrão do catálogo ("Área de trabalho"). Duas áreas de trabalho na mesma tela precisam de nomes diferentes (axe `landmark-unique… |
2971
6573
  | `providedStore` | input | `WorkspaceStore \| null` | `null` | Store já pronto (ex.: restaurado de `sessionStorage` via `restoreWorkspaceStore` — ver `@trismegisto/primitives`'s `workspace.ts`) — quando fornecido, o compon… |
2972
6574
  | `stateChange` | output | `WorkspaceState` | | A árvore inteira, a cada mudança — observar é opcional (ex.: persistência própria de quem consome). |