@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.
- package/README.md +1 -0
- package/package.json +3 -3
- package/skills/acropole/SKILL.md +1 -0
- package/skills/acropole/references/fluxos/tela-nova.md +1 -1
- package/skills/auto-servico/SKILL.md +153 -0
- package/skills/auto-servico/references/diagnostico.md +42 -0
- package/skills/auto-servico/references/roteiros.md +63 -0
- package/skills/auto-servico/references/tools.md +108 -0
- package/skills/orfeu/SKILL.md +1 -1
- package/skills/trismegisto/SKILL.md +2 -2
- package/skills/trismegisto/references/angular-api.md +649 -505
- package/skills/trismegisto/references/angular-exports.md +530 -130
- package/skills/trismegisto/references/angular-types.md +1 -1
- package/skills/trismegisto/references/angular.md +18 -8
- package/skills/trismegisto/references/catalogo/icones.json +5 -0
- package/skills/trismegisto/references/catalogo/seletores.json +444 -31
- package/skills/trismegisto/references/catalogo/tokens.json +136 -16
- package/skills/trismegisto/references/spine-api.md +36 -38
- package/skills/trismegisto/references/spine.md +3 -2
|
@@ -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-
|
|
162
|
+
"--hm-fab-action-size",
|
|
86
163
|
"--hm-fab-lift",
|
|
87
|
-
"--hm-fab-
|
|
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-
|
|
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-
|
|
191
|
-
"--hm-sidebar-
|
|
192
|
-
"--hm-sidebar-
|
|
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-
|
|
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-
|
|
226
|
-
"--hm-
|
|
227
|
-
"--hm-
|
|
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.
|
|
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
|
-
|
|
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`
|
|
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
|
-
|
|
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
|
-
/**
|
|
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
|
-
|
|
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`
|
|
827
|
-
- `function unwrap<T>(envelope: GraphqlEnvelope<T> | null | undefined): T` —
|
|
828
|
-
- `function envelopesOf(data: unknown): { field: string; status: number | string; message: string; ok: boolean }[]` —
|
|
829
|
-
- `function failedEnvelopes(data: unknown, fallbackMessage: string = currentSpineMessages().graphql.serviceFailure): { field: string; status: unknown; message: string }[]` —
|
|
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`
|
|
832
|
+
- `function provideGraphql(options: GraphqlOptions): Provider`
|
|
832
833
|
|
|
833
834
|
### Constantes e tokens
|
|
834
835
|
|
|
835
|
-
- `wsReconnected$`: `Subject<string>` —
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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(…)`
|
|
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`
|
|
1041
|
-
- `openForRoute(routerId: string | null | undefined, sourceTemplateRouterId?: string | null): void`
|
|
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` —
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
1384
|
+
/** Texto para quem usa a tela no dia a dia (normalmente o `README.md` dela). */
|
|
1389
1385
|
load: () => Promise<string>;
|
|
1390
|
-
/**
|
|
1391
|
-
*
|
|
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);
|
|
224
|
-
|
|
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ó
|