@acropole/skills 1.2.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +4 -3
  2. package/package.json +4 -4
  3. package/skills/acropole/SKILL.md +2 -0
  4. package/skills/acropole/references/arquitetura.md +29 -5
  5. package/skills/acropole/references/fluxos/app-novo.md +4 -4
  6. package/skills/acropole/references/fluxos/tela-nova.md +1 -1
  7. package/skills/apollo/references/subscriptions.md +10 -4
  8. package/skills/apollo/references/testes-build.md +1 -0
  9. package/skills/auto-servico/SKILL.md +153 -0
  10. package/skills/auto-servico/references/diagnostico.md +42 -0
  11. package/skills/auto-servico/references/roteiros.md +63 -0
  12. package/skills/auto-servico/references/tools.md +108 -0
  13. package/skills/docker/SKILL.md +3 -0
  14. package/skills/docker/references/podman-local.md +73 -0
  15. package/skills/express/references/dados.md +3 -1
  16. package/skills/fastapi/SKILL.md +4 -4
  17. package/skills/fastapi/references/banco.md +53 -50
  18. package/skills/fastapi/references/estrutura.md +2 -2
  19. package/skills/fastapi/references/integracoes.md +8 -0
  20. package/skills/hefesto/SKILL.md +49 -14
  21. package/skills/hefesto/references/diagnostico.md +15 -5
  22. package/skills/hefesto/references/fluxo.md +64 -35
  23. package/skills/hefesto/references/mcp-diagnostico.md +44 -0
  24. package/skills/hefesto/references/mcp-roteiros.md +53 -0
  25. package/skills/hefesto/references/mcp-tools.md +94 -0
  26. package/skills/orfeu/SKILL.md +1 -1
  27. package/skills/orfeu/references/diferencas.md +1 -1
  28. package/skills/orfeu/references/node.md +1 -1
  29. package/skills/orquestracao/SKILL.md +1 -1
  30. package/skills/orquestracao/templates/spec.md +1 -1
  31. package/skills/trismegisto/SKILL.md +4 -4
  32. package/skills/trismegisto/references/angular-api.md +653 -507
  33. package/skills/trismegisto/references/angular-exports.md +541 -130
  34. package/skills/trismegisto/references/angular-types.md +1 -1
  35. package/skills/trismegisto/references/angular.md +28 -8
  36. package/skills/trismegisto/references/catalogo/icones.json +5 -0
  37. package/skills/trismegisto/references/catalogo/seletores.json +452 -31
  38. package/skills/trismegisto/references/catalogo/tokens.json +136 -16
  39. package/skills/trismegisto/references/spine-api.md +181 -44
  40. package/skills/trismegisto/references/spine-recipes.md +1 -1
  41. package/skills/trismegisto/references/spine.md +4 -3
@@ -41,7 +41,7 @@ type LegendOrientation = 'horizontal' | 'vertical'; type LegendMarker = 'dot' |
41
41
  type FileUploadSize = 'small' | 'medium' | 'large'; // altura da área de soltar
42
42
  type FileUploadStatus = 'pending' | 'uploading' | 'done' | 'error';
43
43
  type FileRejectionReason = 'type' | 'size' | 'totalSize' | 'count' | 'duplicate';
44
- type StepperOrientation = 'horizontal' | 'vertical'; // hm-stepper / hm-wizard
44
+ type StepperOrientation = 'horizontal' | 'vertical'; // hm-stepper (o hm-wizard não tem orientation)
45
45
  type WizardMode = 'modal' | 'page';
46
46
  type TimelineOrientation = 'vertical' | 'horizontal';
47
47
  type TimelineStatus = 'completed' | 'current' | 'pending' | 'error';
@@ -71,7 +71,7 @@ Todos os componentes são **standalone**: importe a classe no `imports` do compo
71
71
  - Cor: `--hm-surface`, `--hm-surface-raised`, `--hm-text`, `--hm-muted`, `--hm-border`, `--hm-divider`,
72
72
  `--hm-accent`, `--hm-action`, `--hm-on-action`, `--hm-hover`, `--hm-focus-color`;
73
73
  status: `--hm-{info,success,warning,danger}` e `--hm-{…}-bg`.
74
- - Espaço: `--hm-space-{xxxs,nano,quarck,xs,sm,md,lg,xl,2xl,3xl}`. Controle: `--hm-control-height{,-dense,-large}`.
74
+ - Espaço: `--hm-space-{xxxs,nano,micro,xs,sm,md,lg,xl,2xl,3xl}`. Controle: `--hm-control-height{,-dense,-large}`.
75
75
  - Forma: `--hm-radius{,-control,-micro,-pill}`, `--hm-shadow-{lg,overlay,nav}`, `--hm-border-{thin,hairline}`.
76
76
  - Tipografia: `--hm-font-sans`, `--hm-font-size-{xs,sm,md,lg,xl,xxl}`, `--hm-font-weight-{regular,medium,semibold,bold}`.
77
77
  - Movimento: `--hm-duration-{quick,standard,medium,relaxed,slow}`, `--hm-ease{,-standard,-decelerate}`.
@@ -183,7 +183,7 @@ escolha o que o resto do app usa, não misture no mesmo campo:
183
183
  | Conteúdo interativo curto ancorado num botão (filtros, detalhes) | `hm-popover` (`heading` ou `label`, `side`/`align`, `[(open)]`) + `[hmPopoverTrigger]="ref"` no botão |
184
184
  | Pré-visualização ao passar o ponteiro/focar um link (cartão de perfil) | `hm-popover openOn="hover"` (`openDelay`/`closeDelay`) + `[hmPopoverTrigger]`; o conteúdo só complementa — o link continua levando ao destino |
185
185
  | Navegação lateral | `hm-sidebar` + `hm-sidebar-node` (árvore) ou `hm-sidebar-group`/`hm-sidebar-link` |
186
- | Cabeçalho do app | `hm-header` (slots `[shortcuts]` e `[actions]`; `[atalhos]`/`[acoes]` depreciados) |
186
+ | Cabeçalho do app | `hm-header` (slots `[shortcuts]` e `[actions]`; marca no conteúdo sem slot) |
187
187
  | Cabeçalho da página (título, trilha, resumo, ações) | `hm-page-header` (`heading`, `level` — `<h1>` por padrão, só um por página —, `[breadcrumb]`, `description`, `summary` vivo, slots `[actions]`/`[meta]`) |
188
188
  | Barra de busca/filtros/ações de uma tela | `hm-toolbar` (`label` obrigatório; slots `[start]`/`[end]`; setas entre controles) |
189
189
  | Campo de busca | `hm-search-field` (`label` obrigatório, `debounce`, `(search)`; `[landmark]="false"` dentro de toolbar/tabela) |
@@ -219,6 +219,8 @@ escolha o que o resto do app usa, não misture no mesmo campo:
219
219
  | Horário | `hm-time-picker` (`label` obrigatório, valor `'HH:mm'`, `min`/`max`, `interval` em minutos, `hourCycle`) |
220
220
  | Escolher vários itens de uma lista grande, vendo o escolhido à parte | `hm-dual-list` (`[items]: DualListItem[]`, valor = ids escolhidos; busca de cada lado; `label` obrigatório) |
221
221
  | Pessoa definir a ordem de itens | `hm-reorder-list` (`[(items)]: ReorderListItem[]`; arrasto pela alça e teclado; `(moved)`; template de item opcional; `removable` → `(removed)`, foco ao vizinho) |
222
+ | Recortar imagem (foto de perfil, capa) | `hm-image-crop` (`src`, `label` obrigatório, `ratio`, `shape="round"`, `[(region)]`/`[(zoom)]`/`[(rotation)]`, campos X/Y/largura/altura como alternativa ao arrasto); a imagem final vem de `exportImage({ type, quality, maxWidth })` → `ImageCropResult` (Blob); `liveExport` + `(exported)` para prévia; slot `[hmImageCropEmpty]` |
223
+ | Texto com formatação que vira HTML | `hm-rich-text` (CVA; valor = HTML canônico e **sanitizado**, `''` quando vazio; `tools`, `headingLevels`, `maxLength`, `pasteMode`, `linkProtocols`, `readonly`); para exibir o HTML salvo fora do editor, use um contêiner `.hm-prose` |
222
224
  | Envio de arquivos | `hm-file-upload` (`label` obrigatório, `accept`, `multiple`, `maxFiles`, `maxSize`, `maxTotalSize`, `[uploader]` opcional; seção 3) |
223
225
  | Colar uma lista vinda de fora (planilha, chamado) | `hm-bulk-input` (`label` obrigatório; valor = `string[]` dos válidos; `validate` regex ou função que devolve o motivo; `max`, `separators`, `textCase`, `ignoreCaseDuplicates`; `(parsed)` com válidos/inválidos/duplicados). Não procura nada na base |
224
226
  | Escolha numa lista longa | `hm-select` (nativo) ou `hm-combobox` (com filtro); múltipla: `hm-combobox-multi` |
@@ -252,6 +254,8 @@ escolha o que o resto do app usa, não misture no mesmo campo:
252
254
  | Ficha de leitura (termo/valor) | `hm-description-list` + `hm-description-item` (`term`, `value` ou conteúdo) ou `[items]`; `columns`; item com filhos = bloco expansível; `editable` = edição inline (`[(value)]` ou `(valueChange)`) |
253
255
  | Configurações com OK/Cancelar e validação por seção | `hm-settings-dialog [closeHandler]` (`onSubmit`/`onCancel` → `Promise<boolean>`) + `hm-settings-section [control]` |
254
256
  | Legenda de cores/status/séries | `hm-legend` (`[items]: LegendItem[]`, `marker` dot/square/line) |
257
+ | Código somente leitura com realce | `hm-code-viewer` (`code` obrigatório, `language` ou inferida do `filename`, `highlightLines="3, 5-8"`, `wrap`, `copyable`, virtualiza acima de `virtualizeThreshold` linhas); não é editor |
258
+ | Diferença entre dois textos | `hm-code-diff` (`original`/`modified` obrigatórios, `layout` auto/split/unified, `layoutToggle`, `intraline`, `collapseUnchanged` + `contextLines`, navegação `nextChange()`/`[(activeChange)]`, `copyTarget="patch"`) |
255
259
  | Copiar um valor | `hm-copy-button` (`value` e `label` obrigatórios; confirma "Copiado" sozinho) |
256
260
  | Certificado X.509 (titular, validade, impressões digitais, cadeia) | `hm-certificate-viewer` (`[certificate]` ou `[chain]` do final `[0]` à raiz, `CertificateInfo` já interpretado pelo app — não faz parser de PEM; `headingLevel`, `warningDays`, `[(selectedIndex)]`); a mesma regra de validade em TS: `certificateValidity(notBefore, notAfter, { warningDays })` |
257
261
  | Página de login | não é componente: classes `.hm-login` (`__panel`, `__brand`, `__title`, `__subtitle`, `__error` com `role="alert" tabindex="-1"`, `__form`, `__options`, `__actions`, `__divider`, `__footer`; `--split` + `__aside`/`__main`) com `hm-input autocomplete="username"`/`type="password"` e `hm-button type="submit"`; SSO = mesmo layout com um botão — site › Padrões › Página de login |
@@ -274,7 +278,7 @@ escolha o que o resto do app usa, não misture no mesmo campo:
274
278
  | Painel "atalhos de teclado" (o `?`) | `hm-shortcut-list` dentro de um `hm-modal` (lista os registrados + `[items]` declarados; `searchable`; `characterKeysToggle` — WCAG 2.1.4) — receitas §13 |
275
279
  | Grid de layout | classes `.hm-row` + `.hm-col-{1..12}` / `.hm-col-{sm,md,lg,xl}-N`; `.hm-col-{bp}-auto` desfaz o span; `.hm-offset-{bp}-N` (começa na coluna N+1, conta do início da linha); `.hm-order-{bp}-{first,last,0..5}` (só visual — Tab e leitor seguem o HTML) |
276
280
  | Pilha, linha que quebra, dois lados, coluna de leitura | classes `.hm-stack`, `.hm-cluster`, `.hm-split`, `.hm-center`, `.hm-container` (+ `.hm-gap-*`; alinhamento `.hm-align-{start,center,end,stretch,baseline}`, `.hm-justify-{start,center,end,between}`, `.hm-fill`) |
277
- | Margem/padding sem SCSS | `.hm-{m,p}{,t,b,s,e,x,y}-{0,quarck,xs,sm,md,lg,xl,2xl,3xl}` (lógicos, `!important`) e `.hm-m{…}-auto`; entre irmãos prefira `.hm-gap-*` |
281
+ | Margem/padding sem SCSS | `.hm-{m,p}{,t,b,s,e,x,y}-{0,micro,xs,sm,md,lg,xl,2xl,3xl}` (lógicos, `!important`) e `.hm-m{…}-auto`; entre irmãos prefira `.hm-gap-*` |
278
282
  | Mostrar/ocultar por largura | `.hm-hide-{sm,md,lg,xl}-up` / `-down` (`display: none`, some também do leitor — só para versões alternativas do mesmo conteúdo) |
279
283
  | Truncar, alinhar, caixa, texto secundário | `.hm-truncate` (1 linha), `.hm-truncate-{2..5}`/`.hm-truncate-lines` + `--hm-truncate-lines`; `.hm-text-{start,center,end,justify}`, `.hm-text-{upper,lower,capitalize}`, `.hm-text-muted`, `.hm-break-word`, `.hm-nowrap` |
280
284
  | Reagir a zoom de 200%/400% (reflow) | `provideHermesZoom()` + `inject(HermesZoomService)` (`level()`, `zoomed()`); CSS com `.hm-zoom-x2`/`.hm-zoom-x4` no `<html>` (cumulativas) |
@@ -309,23 +313,29 @@ convenções do repositório dele.
309
313
 
310
314
  ## 6. Depreciações e remoções
311
315
 
312
- Na 1.0.0 tudo o que esta skill descreve está publicado. Ao migrar código de uma 0.x:
316
+ Esta skill descreve a 2.0.0. Ao migrar código de uma 0.x:
313
317
 
314
318
  - **Scope**: código escrito para uma versão anterior com outro nome de pacote passa a importar de
315
319
  `@trismegisto/angular` (e `@trismegisto/core`, `tokens`, `primitives`, `icons`): troque os nomes no
316
320
  `package.json`, nos imports e nos `@use`. O prefixo `hm-` dos seletores e o `--hm-*` dos tokens não mudaram.
317
321
  - **Removidos** (não compilam mais):
318
322
  - `[control]` dos controles de formulário → `[formControl]`/`formControlName` (seção 3);
319
- - `hm-mark` (marca) → o app desenha o próprio logotipo; `hm-opening-scene` agora só anima o conteúdo projetado;
323
+ - `hm-mark` (marca) → o app desenha o próprio logotipo;
320
324
  - ilustrações `hm-illustration-file-upload`, `hm-illustration-file-transfer`, `hm-illustration-message` e as
321
325
  situações `uploading`, `transfer` e `message` do `hm-state-screen` → use outra situação (ex.: `empty`) ou
322
326
  projete outro desenho no slot `[illustration]`.
323
327
  - **Depreciados** (ainda funcionam, com aviso em desenvolvimento; não use em código novo): `hm-field` → `hm-input`;
324
328
  `help` → `hint`; `busy` → `loading` (botão); `hm-tag color="error"` → `"danger"`; `[startControl]`/`[endControl]`
325
- e `start`/`end` do `hm-date-range-picker` → valor `DateRange`; slots `[atalhos]`/`[acoes]` do `hm-header` →
326
- `[shortcuts]`/`[actions]`; `STATE_PAGE_PRESETS` (fixo em pt-BR) → `statePagePreset(kind, messages)`.
329
+ e `start`/`end` do `hm-date-range-picker` → valor `DateRange`; `STATE_PAGE_PRESETS` (fixo em pt-BR) → `statePagePreset(kind, messages)`.
327
330
  `angular-api.md` marca cada item depreciado.
328
- - **Ilustrações** (modo adesivo) e páginas de estado (`hm-state-page`, inclusive `outdated`): `../SKILL.md` §5.
331
+ - **Ilustrações** e páginas de estado (`hm-state-page`, inclusive `outdated`): `../SKILL.md` §5.
332
+
333
+ Na 2.0.0 saíram, sem período de depreciação:
334
+ - `hm-opening-scene` (abertura) → ao concluir o login, redirecione direto;
335
+ - slots `[atalhos]`/`[acoes]` do `hm-header` → `[shortcuts]`/`[actions]`;
336
+ - `orientation` do `hm-wizard` → o wizard tem um layout só (etapas em coluna à esquerda, conteúdo à direita);
337
+ - token `--hm-space-quarck` e utilitários `.hm-{gap,m*,p*}-quarck` → `--hm-space-micro` / `-micro` (mesmo valor, 4px).
338
+ Entraram `hm-image-crop`, `hm-rich-text`, `hm-code-viewer` e `hm-code-diff` (tabela da seção de escolha).
329
339
 
330
340
  Ao atualizar a versão do pacote, confira `angular-api.md` e `angular-exports.md` (gerados do código da
331
341
  versão) antes de reaproveitar código escrito para a versão anterior.
@@ -382,6 +392,16 @@ expect(await name.getErrorText()).toBe('');
382
392
  - **`label=""` para satisfazer o tipo é bug de acessibilidade**: dê um rótulo real e use `labelHidden` se não
383
393
  quiser mostrá-lo.
384
394
  - **`Validators.required` não serve no `hm-date-range-picker`**: use `DateRangeValidators.required`/`.order`.
395
+ - **Largura de campo em barra de filtros**: não fixe largura menor que o tamanho natural do componente (ex.:
396
+ `flex: 0 0 16rem` num `hm-date-range-picker`). Até a 2.0.1 o campo não encolhia e o quadro vazava por cima do
397
+ vizinho; mesmo depois da correção, espremer duas datas corta o texto. Prefira `flex: 0 0 auto` (tamanho natural) ou
398
+ uma largura mínima que caiba o conteúdo, e confira a barra na largura de tela mais estreita que o app suporta.
399
+ - **`initialWidth` numa coluna de ações do `hm-data-grid`**: até a 2.0.1 ela é o tamanho FIXO da coluna no encaixe
400
+ automático (o conteúdo não é medido); um grupo de botões mais largo vaza da célula e o "…" do `hm-button-group` some.
401
+ Dimensione pelo conteúdo real (botões + "…" + respiro da célula) ou deixe sem `initialWidth`. Nas versões
402
+ seguintes ela vale como mínimo e a coluna cresce até caber.
403
+ - **Token que não existe não quebra o build**: `var(--hm-nome-errado)` deixa a propriedade inválida e o navegador usa o
404
+ valor inicial (ex.: ícone do tamanho do contêiner). Em estilo do app, use só tokens do `tokens.css` publicado.
385
405
  - **Ícone com nome errado não quebra o build**: vira ícone genérico com aviso `[hermes-icons]` no console. Confira
386
406
  o nome no catálogo.
387
407
  - **Não sobrescreva o DOM interno** (`.hm-btn__…`, `.hm-field__…`) nem teste por ele: muda entre versões. Ajuste
@@ -241,6 +241,7 @@
241
241
  "cloud-up",
242
242
  "cluster",
243
243
  "code",
244
+ "code-block",
244
245
  "code-edit",
245
246
  "code-list",
246
247
  "cog",
@@ -697,6 +698,10 @@
697
698
  "rocket-diagonal",
698
699
  "rodagem-dupla",
699
700
  "rodagem-simples",
701
+ "rotate-ccw",
702
+ "rotate-cw",
703
+ "rotate-left",
704
+ "rotate-right",
700
705
  "router",
701
706
  "ruble",
702
707
  "ruler-pencil",