@acropole/skills 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4,25 +4,101 @@
4
4
  "--hm-accent-subtle",
5
5
  "--hm-action",
6
6
  "--hm-action-hover",
7
+ "--hm-alert-icon",
8
+ "--hm-alert-pad-block",
9
+ "--hm-alert-pad-inline",
10
+ "--hm-alert-tint",
11
+ "--hm-alert-tone",
7
12
  "--hm-aspect-ratio",
8
13
  "--hm-attachment-media",
14
+ "--hm-avatar-group-overlap",
15
+ "--hm-avatar-group-ring",
9
16
  "--hm-avatar-size",
17
+ "--hm-badge-size",
10
18
  "--hm-border",
11
19
  "--hm-border-hairline",
12
20
  "--hm-border-thin",
13
- "--hm-breadcrumb-label-room",
14
21
  "--hm-breakpoint-lg",
15
22
  "--hm-breakpoint-md",
16
23
  "--hm-breakpoint-sm",
17
24
  "--hm-breakpoint-xl",
18
25
  "--hm-btn-intent-override",
26
+ "--hm-bulk-input-rejects-max",
19
27
  "--hm-calendar-cell",
20
28
  "--hm-card-container-min",
21
29
  "--hm-card-media-radius",
30
+ "--hm-card-media-ratio",
31
+ "--hm-card-media-width",
22
32
  "--hm-card-pad",
33
+ "--hm-carousel-index",
34
+ "--hm-carousel-shift",
23
35
  "--hm-center-max",
24
36
  "--hm-certificate-viewer-depth",
25
37
  "--hm-check-size",
38
+ "--hm-chip-edge",
39
+ "--hm-chip-label-max",
40
+ "--hm-chip-pad-end",
41
+ "--hm-chip-pad-start",
42
+ "--hm-code-active-change-outline",
43
+ "--hm-code-bg",
44
+ "--hm-code-border",
45
+ "--hm-code-columns",
46
+ "--hm-code-diff-added-bg",
47
+ "--hm-code-diff-added-marker",
48
+ "--hm-code-diff-added-strong-bg",
49
+ "--hm-code-diff-changed-marker",
50
+ "--hm-code-diff-collapsed-bg",
51
+ "--hm-code-diff-collapsed-text",
52
+ "--hm-code-diff-filler-bg",
53
+ "--hm-code-diff-filler-stripe",
54
+ "--hm-code-diff-removed-bg",
55
+ "--hm-code-diff-removed-marker",
56
+ "--hm-code-diff-removed-strong-bg",
57
+ "--hm-code-diff-split-min",
58
+ "--hm-code-font-family",
59
+ "--hm-code-font-size",
60
+ "--hm-code-gutter-bg",
61
+ "--hm-code-gutter-digits",
62
+ "--hm-code-gutter-text",
63
+ "--hm-code-header-bg",
64
+ "--hm-code-header-text",
65
+ "--hm-code-invisible-bg",
66
+ "--hm-code-invisible-text",
67
+ "--hm-code-line-height",
68
+ "--hm-code-line-highlight-bar",
69
+ "--hm-code-line-highlight-bg",
70
+ "--hm-code-selection-bg",
71
+ "--hm-code-syntax-attribute",
72
+ "--hm-code-syntax-code",
73
+ "--hm-code-syntax-comment",
74
+ "--hm-code-syntax-constant",
75
+ "--hm-code-syntax-emphasis",
76
+ "--hm-code-syntax-escape",
77
+ "--hm-code-syntax-function",
78
+ "--hm-code-syntax-heading",
79
+ "--hm-code-syntax-invalid",
80
+ "--hm-code-syntax-keyword",
81
+ "--hm-code-syntax-link",
82
+ "--hm-code-syntax-meta",
83
+ "--hm-code-syntax-number",
84
+ "--hm-code-syntax-operator",
85
+ "--hm-code-syntax-property",
86
+ "--hm-code-syntax-punctuation",
87
+ "--hm-code-syntax-regexp",
88
+ "--hm-code-syntax-string",
89
+ "--hm-code-syntax-strong",
90
+ "--hm-code-syntax-tag",
91
+ "--hm-code-syntax-type",
92
+ "--hm-code-syntax-variable",
93
+ "--hm-code-tab",
94
+ "--hm-code-text",
95
+ "--hm-code-tint-added",
96
+ "--hm-code-tint-added-strong",
97
+ "--hm-code-tint-highlight",
98
+ "--hm-code-tint-removed",
99
+ "--hm-code-tint-removed-strong",
100
+ "--hm-code-viewer-max-height",
101
+ "--hm-code-viewer-windowed-height",
26
102
  "--hm-color-white",
27
103
  "--hm-container-max",
28
104
  "--hm-control-height",
@@ -46,6 +122,7 @@
46
122
  "--hm-data-diverging-6",
47
123
  "--hm-data-diverging-7",
48
124
  "--hm-data-grid-fixed-col",
125
+ "--hm-data-grid-scrollbar",
49
126
  "--hm-data-sequential-1",
50
127
  "--hm-data-sequential-2",
51
128
  "--hm-data-sequential-3",
@@ -82,10 +159,15 @@
82
159
  "--hm-event-calendar-gutter",
83
160
  "--hm-event-calendar-hour",
84
161
  "--hm-event-calendar-row",
85
- "--hm-fab-gap",
162
+ "--hm-fab-action-size",
86
163
  "--hm-fab-lift",
87
- "--hm-fab-safe-inline",
164
+ "--hm-fab-offset",
165
+ "--hm-fab-safe-end",
166
+ "--hm-fab-safe-start",
88
167
  "--hm-fab-size",
168
+ "--hm-file-upload-cloud",
169
+ "--hm-file-upload-zone-min",
170
+ "--hm-file-upload-zone-padding",
89
171
  "--hm-floating-window-grip",
90
172
  "--hm-floating-window-layer",
91
173
  "--hm-focus-color",
@@ -124,12 +206,22 @@
124
206
  "--hm-icon-md",
125
207
  "--hm-icon-size",
126
208
  "--hm-icon-xl",
209
+ "--hm-image-crop-frame-dark",
210
+ "--hm-image-crop-frame-light",
211
+ "--hm-image-crop-frame-width",
212
+ "--hm-image-crop-handle-hit",
213
+ "--hm-image-crop-handle-hit-coarse",
214
+ "--hm-image-crop-handle-size",
215
+ "--hm-image-crop-max-height",
216
+ "--hm-image-crop-stage-bg",
217
+ "--hm-image-crop-veil",
127
218
  "--hm-info",
128
219
  "--hm-info-bg",
129
220
  "--hm-kanban-collapsed-width",
130
221
  "--hm-kanban-column-width",
131
222
  "--hm-layout-gap",
132
223
  "--hm-legend-color",
224
+ "--hm-legend-marker-size",
133
225
  "--hm-line-height-normal",
134
226
  "--hm-line-height-snug",
135
227
  "--hm-line-height-tight",
@@ -152,6 +244,8 @@
152
244
  "--hm-map-popup-tip",
153
245
  "--hm-map-region-border",
154
246
  "--hm-map-water",
247
+ "--hm-menu-button-padding",
248
+ "--hm-menu-button-size",
155
249
  "--hm-muted",
156
250
  "--hm-nav-gutter",
157
251
  "--hm-nav-hover",
@@ -173,27 +267,27 @@
173
267
  "--hm-panel-scrim",
174
268
  "--hm-panel-text",
175
269
  "--hm-panel-veil",
270
+ "--hm-placeholder",
176
271
  "--hm-property-view-name-width",
177
- "--hm-radio-card-min",
272
+ "--hm-radio-size",
178
273
  "--hm-radius",
179
274
  "--hm-radius-control",
180
275
  "--hm-radius-micro",
181
276
  "--hm-radius-pill",
182
277
  "--hm-reorder-list-row",
183
278
  "--hm-reveal-delay",
279
+ "--hm-rich-text-max-rows",
280
+ "--hm-rich-text-rows",
184
281
  "--hm-scroll-area-max",
282
+ "--hm-segmented-error-icon",
185
283
  "--hm-shadow-lg",
186
284
  "--hm-shadow-nav",
187
285
  "--hm-shadow-overlay",
188
286
  "--hm-shortcut-list-key-min",
189
287
  "--hm-shortcut-list-min-column",
190
- "--hm-sidebar-direction",
191
- "--hm-sidebar-label-delay",
192
- "--hm-sidebar-link-color",
193
- "--hm-sidebar-link-font",
194
- "--hm-sidebar-link-glyph",
195
- "--hm-sidebar-link-glyph-color",
196
- "--hm-sidebar-width",
288
+ "--hm-sidebar-enter-from",
289
+ "--hm-sidebar-fit",
290
+ "--hm-sidebar-rail",
197
291
  "--hm-skeleton-base",
198
292
  "--hm-skeleton-shine",
199
293
  "--hm-slider-at",
@@ -206,30 +300,56 @@
206
300
  "--hm-space-3xl",
207
301
  "--hm-space-lg",
208
302
  "--hm-space-md",
303
+ "--hm-space-micro",
209
304
  "--hm-space-nano",
210
- "--hm-space-quarck",
211
305
  "--hm-space-sm",
212
306
  "--hm-space-xl",
213
307
  "--hm-space-xs",
214
308
  "--hm-space-xxxs",
215
309
  "--hm-stat-card-disc",
216
- "--hm-stat-card-value-size",
310
+ "--hm-stat-card-disc-ink",
311
+ "--hm-stat-card-disc-paint",
312
+ "--hm-stat-card-figure",
313
+ "--hm-stat-card-tone",
314
+ "--hm-stat-card-trend-tone",
315
+ "--hm-stat-group-tone",
316
+ "--hm-stepper-mark",
317
+ "--hm-stepper-pad",
318
+ "--hm-stepper-rule",
319
+ "--hm-stepper-rule-gap",
217
320
  "--hm-success",
218
321
  "--hm-success-bg",
219
322
  "--hm-surface",
220
323
  "--hm-surface-raised",
324
+ "--hm-switch-gap",
325
+ "--hm-switch-height",
326
+ "--hm-switch-thumb",
327
+ "--hm-switch-width",
221
328
  "--hm-tab-active-bg",
222
329
  "--hm-tab-strip-bg",
330
+ "--hm-tag-fill",
331
+ "--hm-tag-tone",
223
332
  "--hm-text",
224
333
  "--hm-texture-card",
225
- "--hm-timeline-line",
226
- "--hm-timeline-marker",
227
- "--hm-toast-duration",
334
+ "--hm-theme-picker-accent",
335
+ "--hm-theme-picker-accent-dark",
336
+ "--hm-theme-picker-accent-light",
337
+ "--hm-theme-picker-panel",
338
+ "--hm-timeline-gap",
339
+ "--hm-timeline-mark",
340
+ "--hm-timeline-ring",
341
+ "--hm-timeline-rule",
342
+ "--hm-toast-tone",
343
+ "--hm-toast-tone-bg",
228
344
  "--hm-tree-drop-level",
345
+ "--hm-tree-gutter",
346
+ "--hm-tree-indent",
229
347
  "--hm-tree-level",
230
348
  "--hm-truncate-lines",
231
349
  "--hm-warning",
232
350
  "--hm-warning-bg",
351
+ "--hm-wizard-nav",
352
+ "--hm-wizard-pad",
233
353
  "--hm-z-fixed",
234
354
  "--hm-z-menu",
235
355
  "--hm-z-overlay",
@@ -1,6 +1,6 @@
1
1
  # Catálogo de API — @trismegisto/spine
2
2
 
3
- > **Gerado** por `scripts/gerar/trismegisto-spine.mjs` a partir do código-fonte da versão 1.0.0, a cada `npm run sync` do @acropole/skills.
3
+ > **Gerado** por `scripts/gerar/trismegisto-spine.mjs` a partir do código-fonte da versão 1.0.2, a cada `npm run sync` do @acropole/skills.
4
4
  > Gerado do código-fonte do `@trismegisto/spine`. Confira a versão instalada no `package.json` do pacote em `node_modules`.
5
5
 
6
6
  Uma seção por ponto de entrada (o `import` exato). Dentro dela: componentes (seletor, inputs/outputs),
@@ -55,18 +55,20 @@ Preferências do usuário que não são de tema (tema/família/densidade continu
55
55
 
56
56
  #### `SpineQuickAccessService` · `providedIn: root`
57
57
 
58
- Favoritos e páginas abertas por último. Um serviço só, e não cada componente com a sua cópia do `localStorage`: é o que faz o coração da trilha (`spine-page-bar`) e a tela inicial mostrarem a mesma coisa na hora, sem recarregar.
58
+ Favorites and recently visited pages, shared by every consumer in the app (page bar, home screen) and persisted per client in `localStorage`.
59
59
 
60
60
  - `readonly favorites: Signal (somente leitura)`
61
61
  - `readonly recents: Signal (somente leitura)`
62
62
  - `isFavorite(id: string | null | undefined): boolean`
63
63
  - `toggleFavorite(item: QuickAccessItem): void`
64
- - `recordVisit(item: QuickAccessItem): void` — Registra a visita: o mais recente vai pro topo e a lista não repete página.
64
+ - `recordVisit(item: QuickAccessItem): void`
65
65
  - `forgetRecent(id: string): void`
66
66
 
67
67
  ### Funções
68
68
 
69
69
  - `function routerIdOf(route: Route | null | undefined): string | null` — `router_id` da tela (nó 'page'), aceitando o argos antigo (que só mandava `route_id`, mesmo valor).
70
+ - `function mergeRouteTree(routes: readonly Route[] | null | undefined): Route[]` — Funde nós IRMÃOS que apontam para o mesmo endereço (`route_redirect`), em toda a árvore.
71
+ - `function spineRoutesOf(view: { routes?: readonly Route[] | null } | null | undefined): Route[]` — A árvore fundida da view atual (`ViewService.currentView`) — ver `mergeRouteTree`.
70
72
  - `function provideUi(config?: SpineConfig): EnvironmentProviders` — Registra o catálogo de ícones inteiro — o spine (header/sidebar/navegação/modal/onboarding) usa ícones de várias origens (shield, pencil, trash, floppy, chevrons...) que não vêm embutidos de graça (os componentes do hermes só registram os ícones que eles próp…
71
73
  - `function resolveSpineLogo(logo: SpineLogoConfig | false | null | undefined): SpineLogoSources | null` — Normaliza `SpineConfig.logo`: omitido → convenção; `false`/vazio → sem imagem (`null`).
72
74
  - `function applySpineFavicon(doc: Document, href: string): HTMLLinkElement | null` — Aponta o favicon do documento para `href`: atualiza o primeiro `<link rel="icon">` (ou `shortcut icon`) e remove os outros (senão o navegador pode continuar escolhendo um deles); sem nenhum, cria um no `<head>`. O `type` acompanha a extensão (some quando ela…
@@ -221,16 +223,15 @@ interface PackageInfo {
221
223
 
222
224
  #### `QuickAccessItem` (interface)
223
225
 
224
- Uma página guardada no navegador (favorito ou recente). Cópia, e não referência à árvore: a árvore pode mudar, e uma página que saiu do crachá atual continua listada até que se navegue pra ela -- melhor mostrar e receber "sem permissão" do que o favorito sumir sem explicação.
226
+ A page remembered by the shell, either as a favorite or as a recent visit.
225
227
 
226
228
  ```ts
227
229
  interface QuickAccessItem {
228
- /** Identidade do item: o endereço da página (`route_redirect`). */
229
230
  readonly id: string;
230
231
  readonly icon: string;
231
232
  readonly displayName: string;
232
233
  readonly redirect: string;
233
- /** Rótulos dos ancestrais, do topo pra baixo ("Rede › DNS"). Vazio = página de nível 1. */
234
+ /** Ancestor labels, top-down. `[]` = top-level page; absent = stored by an older version. */
234
235
  readonly trail?: readonly string[];
235
236
  }
236
237
  ```
@@ -819,26 +820,26 @@ interface AutoServiceClient {
819
820
 
820
821
  #### `GraphqlEnvelopeError` · extends Error
821
822
 
822
- Falha de negócio devolvida pelo backend, com o status do envelope preservado — a tela decide pelo `status` (403 = sem acesso, 404 = vazio, 500 = tente de novo). `message` é texto do backend: exibir como texto, nunca por `innerHTML`.
823
+ Business failure carried by an envelope. `status` is kept exactly as the backend sent it.
823
824
 
824
825
  ### Funções
825
826
 
826
- - `function isEnvelopeOk(status: GraphqlEnvelope<unknown>['status']): boolean` — O status do envelope indica sucesso? Número: 2xx. Texto: qualquer coisa que não seja erro.
827
- - `function unwrap<T>(envelope: GraphqlEnvelope<T> | null | undefined): T` — Confere o envelope e devolve o `data`.
828
- - `function envelopesOf(data: unknown): { field: string; status: number | string; message: string; ok: boolean }[]` — Os envelopes `{ status, message }` de primeiro nível de uma resposta (um por operação raiz).
829
- - `function failedEnvelopes(data: unknown, fallbackMessage: string = currentSpineMessages().graphql.serviceFailure): { field: string; status: unknown; message: string }[]` — Os envelopes com falha dentro de uma resposta (`result.data` inteiro, um campo por operação raiz). Usado pelo link de aviso do `provideGraphql`; exportado pra quem quiser o mesmo diagnóstico.
827
+ - `function isEnvelopeOk(status: GraphqlEnvelope<unknown>['status']): boolean`
828
+ - `function unwrap<T>(envelope: GraphqlEnvelope<T> | null | undefined): T` — Returns `data` of an ok envelope; throws `GraphqlEnvelopeError` for a missing or failed one.
829
+ - `function envelopesOf(data: unknown): { field: string; status: number | string; message: string; ok: boolean }[]` — First-level envelopes found in an operation's `data` (fields that carry both `status` and `message`).
830
+ - `function failedEnvelopes(data: unknown, fallbackMessage: string = currentSpineMessages().graphql.serviceFailure): { field: string; status: unknown; message: string }[]` — First-level fields whose status is a failure; `message` is optional here.
830
831
  - `function injectGraphqlClient(namedClient: string): GraphqlClient` — O `GraphqlClient` do backend `namedClient` (`environment.graphql.<chave>.namedClient`). Chamar em contexto de injeção.
831
- - `function provideGraphql(options: GraphqlOptions): Provider` — Clientes Apollo dos apps — UM lugar pra configuração que antes vivia copiada (e divergindo) em cada app: - token do Orfeu em `x-access-token` (o `@orfeu/node` não lê `Authorization`), no HTT…
832
+ - `function provideGraphql(options: GraphqlOptions): Provider`
832
833
 
833
834
  ### Constantes e tokens
834
835
 
835
- - `wsReconnected$`: `Subject<string>` — Emite o `namedClient` toda vez que o WebSocket RECONECTA depois de uma queda (não na 1ª conexão). O graphql-ws reassina as subscriptions sozinho, mas não reenvia o que foi publicado durante a queda — a tela usa isto pra ressincronizar.
836
+ - `wsReconnected$`: `Subject<string>` — Emits the `namedClient` whose socket came back after a drop (never on the first connection).
836
837
 
837
838
  ### Tipos
838
839
 
839
840
  #### `GraphqlEnvelope` (interface)
840
841
 
841
- O envelope que os GraphQL dos apps devolvem: `{ status, message, data }`. **O status vem dentro do payload, não no transporte** — uma resposta HTTP 200 pode carregar `status: 403` ou `500`. Ler o `data` sem conferir o `status` é o que faz a tela mostrar "lista vazia" onde devia dizer que faltou permissão ou que o serviço falhou.
842
+ Shape every root query/mutation field returns on the platform: business status travels in the payload.
842
843
 
843
844
  ```ts
844
845
  interface GraphqlEnvelope<T> {
@@ -877,25 +878,19 @@ interface GraphqlClient {
877
878
 
878
879
  #### `GraphqlEndpoint` (interface)
879
880
 
880
- Um backend GraphQL do app — o tipo de `environment.graphql.<chave>` em TODO app (importar daqui, não redeclarar). Campos mutáveis de propósito: o `main.ts` pode derivar `http`/`ws` do domínio em tempo de execução antes do bootstrap.
881
-
882
881
  ```ts
883
882
  interface GraphqlEndpoint {
884
- /** Nome do cliente Apollo (`apollo.use(namedClient)`). */
883
+ // Mutable on purpose: the runtime environment rewrites `http`/`ws` before bootstrap.
885
884
  namedClient: string;
886
885
  http: string;
887
- /** Sem `ws`, o cliente não tem subscription (só HTTP). */
888
886
  ws?: string;
889
887
  }
890
888
  ```
891
889
 
892
890
  #### `GraphqlOptions` (interface)
893
891
 
894
- Sem opções de comportamento DE PROPÓSITO: o padrão é o mesmo em todo app (lote, toast do envelope, reconexão, no-cache). O que varia entre apps é só QUAIS backends existem (`endpoints`).
895
-
896
892
  ```ts
897
893
  interface GraphqlOptions {
898
- /** `environment.graphql` do app: um cliente Apollo nomeado por entrada. */
899
894
  readonly endpoints: Readonly<Record<string, GraphqlEndpoint>>;
900
895
  }
901
896
  ```
@@ -943,7 +938,7 @@ _Sem inputs/outputs._
943
938
 
944
939
  #### `spine-onboarding-overlay` — `OnboardingOverlayComponent`
945
940
 
946
- Onboarding próprio: escurece a tela (holofote via box-shadow gigante no recorte do alvo) e posiciona um balão explicativo perto do elemento — ou centralizado nos passos sem alvo (boas-vindas/encerramento). Sem dependência externa, sem sequestrar o scroll da página.
941
+ Desenho do tour guiado: escurece a tela, recorta um holofote sobre o alvo do passo e põe o balão (título, texto, progresso e navegação) onde couber. Segue o `OnboardingService`; recalcula a cada passo e quando a janela rola ou muda de tamanho.
947
942
 
948
943
  _Sem inputs/outputs._
949
944
 
@@ -967,17 +962,17 @@ _Sem inputs/outputs._
967
962
 
968
963
  #### `spine-docs` — `SpineDocsComponent`
969
964
 
970
- Modal de documentação: índice com busca à esquerda — ele não some ao abrir um documento, é por ele que se pula de uma tela para outra — e a leitura à direita, com a aba técnica só quando `SpineDocsService.showTechnical`.
965
+ Modal de documentação das telas: índice (com busca) à esquerda e leitura à direita. Montado uma vez pelo `spine-layout`; abrir, fechar e o que se lê vêm todos do `SpineDocsService`.
971
966
 
972
967
  _Sem inputs/outputs._
973
968
 
974
969
  #### `spine-markdown` — `SpineMarkdownComponent`
975
970
 
976
- Markdown → HTML sanitizado. O HTML vem de `innerHTML`, que o encapsulamento de view não alcança: por isso `ViewEncapsulation.None` com tudo escopado em `.spine-markdown`.
971
+ Renderiza Markdown (GFM) como HTML com a tipografia do design system. O texto é tratado como dado: o HTML gerado passa pelo DOMPurify antes de chegar ao DOM.
977
972
 
978
973
  | Nome | Tipo | Tipo TS | Padrão | Descrição |
979
974
  |---|---|---|---|---|
980
- | `content` | input | `string` | `''` | |
975
+ | `content` | input | `string` | `''` | Markdown cru. Vazio não desenha nada. |
981
976
 
982
977
  ### Serviços e classes
983
978
 
@@ -1026,19 +1021,19 @@ Tokens de aplicação pessoais (`x-app-token`) do usuário logado — `argos-adm
1026
1021
 
1027
1022
  #### `SpineDocsService` · `providedIn: root`
1028
1023
 
1029
- Documentação das telas. A fonte é o próprio mapa de componentes (`COMPONENT_ROUTES`, campo `document`), e o índice só lista o que está na árvore de rotas da pessoa — documento de tela sem acesso nunca é oferecido nem baixado.
1024
+ Estado da documentação das telas: o que está registrado em `COMPONENT_ROUTES` com `document`, filtrado pelas telas que existem na árvore da pessoa (documento de tela sem acesso nunca é oferecido), e a leitura em andamento no modal `spine-docs`.
1030
1025
 
1031
- - `readonly technicalAvailable`
1026
+ - `readonly technicalAvailable: boolean` — Visão técnica liberada (`SpineConfig.technicalDocs`; sem configuração, só em desenvolvimento).
1032
1027
  - `readonly isOpen: Signal (somente leitura)`
1033
1028
  - `readonly current: Signal (somente leitura)`
1034
1029
  - `readonly view: Signal (somente leitura)`
1035
1030
  - `readonly content: Signal (somente leitura)`
1036
1031
  - `readonly loading: Signal (somente leitura)`
1037
- - `readonly error: computed(…)` — Texto do erro de carregamento (vazio = sem erro), no idioma ativo.
1032
+ - `readonly error: computed(…)`
1038
1033
  - `readonly showTechnical: computed(…)`
1039
1034
  - `readonly index: computed<DocsGroup[]>(…)`
1040
- - `documentFor(routerId: string | null | undefined, sourceTemplateRouterId?: string | null): DocsEntry | null` — Documento da tela (router_id do client e, como alternativa, o router do template de origem), ou `null` quando ela não tem (ou a pessoa não tem acesso).
1041
- - `openForRoute(routerId: string | null | undefined, sourceTemplateRouterId?: string | null): void` — Abre o modal no documento da tela; sem documento, no índice.
1035
+ - `documentFor(routerId: string | null | undefined, sourceTemplateRouterId?: string | null): DocsEntry | null`
1036
+ - `openForRoute(routerId: string | null | undefined, sourceTemplateRouterId?: string | null): void`
1042
1037
  - `openIndex(): void`
1043
1038
  - `close(): void`
1044
1039
  - `open(entry: DocsEntry, view: DocsView = 'usage'): Promise<void>`
@@ -1052,7 +1047,7 @@ Painel de novidades do app (ver `provideSpineNews`). Decide o que está devido
1052
1047
  - `readonly isOpen: signal(…)`
1053
1048
  - `readonly hasAny: computed(…)` — Há alguma novidade vigente — o item "Novidades" do menu só aparece com isto.
1054
1049
  - `scheduleOnEntry(): void` — Chamado uma vez pelo layout na entrada: abre as devidas, esperando o tour terminar.
1055
- - `showDue(): void` — Abre as devidas e as marca como vistas (vistas juntas, marcadas juntas).
1050
+ - `showDue(): void` — Marca como vistas todas as novidades devidas e as abre num único painel.
1056
1051
  - `showAll(): void` — Reabre todas as vigentes (menu do perfil), vistas ou não.
1057
1052
  - `close(): void`
1058
1053
 
@@ -1201,10 +1196,11 @@ interface CreatedAppToken {
1201
1196
 
1202
1197
  #### `DocsEntry` (interface)
1203
1198
 
1204
- Documento de tela já resolvido contra a árvore de rotas: título e grupo sempre presentes.
1199
+ Documento de uma tela que a pessoa logada pode abrir.
1205
1200
 
1206
1201
  ```ts
1207
1202
  interface DocsEntry extends RouteDocument {
1203
+ /** Chave da tela (router_id ou, sem ele, o do template), sempre em minúsculas. */
1208
1204
  readonly id: string;
1209
1205
  readonly title: string;
1210
1206
  readonly group: string;
@@ -1377,18 +1373,20 @@ Gate de navegação REAL (deep link, F5, `router.navigateByUrl` do painel focado
1377
1373
 
1378
1374
  #### `RouteDocument` (interface)
1379
1375
 
1380
- Documentação de uma tela, carregada sob demanda. O texto é markdown cru — no app, `import('./README.md')` com o loader `.md: "text"` no `angular.json` —, então viaja no chunk lazy da própria tela e só é baixado quando alguém abre a documentação.
1376
+ Manual de uma tela, declarado no `document` da própria `ComponentRoute` (mesma chave, o router_id). Os textos são Markdown buscado só quando alguém abre a documentação: nos apps, um `import()` do `.md` com o loader `text`, de modo que o conteúdo vai no chunk lazy da tela e não no carregamento inicial.
1381
1377
 
1382
1378
  ```ts
1383
1379
  interface RouteDocument {
1384
- /** Nome no índice. Opcional: sem ele vale o `route_display_name` da rota na árvore. */
1380
+ /** Nome da tela no índice da documentação; se faltar, usa-se o rótulo da rota na árvore do usuário. */
1385
1381
  title?: string;
1386
- /** Agrupa o índice. Opcional: sem ele vale o módulo (nó raiz) da rota na árvore. */
1382
+ /** Seção do índice em que a tela aparece; se faltar, usa-se o módulo de topo que a contém. */
1387
1383
  group?: string;
1388
- /** Manual de uso, para quem opera a tela (o `README.md`). */
1384
+ /** Texto para quem usa a tela no dia a dia (normalmente o `README.md` dela). */
1389
1385
  load: () => Promise<string>;
1390
- /** Especificação técnica, para quem desenvolve (o `ESPECIFICACAO.md`). Só exibida quando
1391
- * `SpineConfig.technicalDocs` (padrão: fora de produção, `isDevMode()`). */
1386
+ /**
1387
+ * Especificação técnica, para desenvolvimento (normalmente o `ESPECIFICACAO.md`). Só aparece com
1388
+ * `SpineConfig.technicalDocs` ativo — por padrão, apenas em `isDevMode()`.
1389
+ */
1392
1390
  loadTechnical?: () => Promise<string>;
1393
1391
  }
1394
1392
  ```
@@ -220,8 +220,9 @@ tipo daqui; não o redeclare. O comportamento é fixo de propósito (sem opçõe
220
220
  - token do Orfeu em `x-access-token` no HTTP e no `connection_init` do WebSocket (na raiz e em `headers`),
221
221
  junto de `routeId`/`clientId` para a auditoria das subscriptions;
222
222
  - HTTP em lote (`HttpBatchLink`), `fetchPolicy: 'no-cache'`, `errorPolicy` padrão (`none`);
223
- - subscription por `graphql-ws`, só no navegador, reconexão ilimitada (backoff até 30 s); 401/4401/4403
224
- recria os sockets; aba que volta de mais de 60 s em segundo plano também. `wsReconnected$` emite o
223
+ - subscription por `graphql-ws`, só no navegador, reconexão ilimitada (backoff até 30 s); qualquer fechamento
224
+ do socket (inclusive 4401/4403) leva a reconectar com o token atual, nunca a erro na subscription; 401 de
225
+ HTTP ou de resolver recria os sockets; aba que volta de mais de 60 s em segundo plano também. `wsReconnected$` emite o
225
226
  `namedClient` a cada **re**conexão — use para ressincronizar (receitas §6);
226
227
  - **toast automático do envelope** `{ status, message, data }` de cada campo raiz: mutation avisa sempre que
227
228
  falha (texto do catálogo se não vier `message`) e no sucesso quando o backend manda `message`; query só