@marinoscar/platform-cli 0.1.0-next.23 → 0.1.0-next.25
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/CHANGELOG.md +40 -0
- package/README.md +4 -3
- package/dist/engine/commands/node.d.ts.map +1 -1
- package/dist/engine/commands/node.js +73 -6
- package/dist/engine/commands/node.js.map +1 -1
- package/dist/engine/conformance.d.ts +3 -0
- package/dist/engine/conformance.d.ts.map +1 -1
- package/dist/engine/conformance.js +7 -0
- package/dist/engine/conformance.js.map +1 -1
- package/dist/engine/create-cli.d.ts +21 -0
- package/dist/engine/create-cli.d.ts.map +1 -1
- package/dist/engine/create-cli.js +11 -0
- package/dist/engine/create-cli.js.map +1 -1
- package/dist/engine/index.d.ts +26 -3
- package/dist/engine/index.d.ts.map +1 -1
- package/dist/engine/index.js +13 -1
- package/dist/engine/index.js.map +1 -1
- package/dist/engine/node/capabilities.d.ts +199 -4
- package/dist/engine/node/capabilities.d.ts.map +1 -1
- package/dist/engine/node/capabilities.js +292 -11
- package/dist/engine/node/capabilities.js.map +1 -1
- package/dist/engine/node/daemon-channels.d.ts +66 -0
- package/dist/engine/node/daemon-channels.d.ts.map +1 -0
- package/dist/engine/node/daemon-channels.js +65 -0
- package/dist/engine/node/daemon-channels.js.map +1 -0
- package/dist/engine/node/daemon.d.ts.map +1 -1
- package/dist/engine/node/daemon.js +52 -0
- package/dist/engine/node/daemon.js.map +1 -1
- package/dist/engine/node/doctor.d.ts +2 -0
- package/dist/engine/node/doctor.d.ts.map +1 -1
- package/dist/engine/node/doctor.js +56 -3
- package/dist/engine/node/doctor.js.map +1 -1
- package/dist/engine/node/executors/credential-hygiene.d.ts +1 -1
- package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -1
- package/dist/engine/node/executors/credential-hygiene.js +23 -2
- package/dist/engine/node/executors/credential-hygiene.js.map +1 -1
- package/dist/engine/node/executors/index.d.ts +52 -7
- package/dist/engine/node/executors/index.d.ts.map +1 -1
- package/dist/engine/node/executors/index.js +14 -0
- package/dist/engine/node/executors/index.js.map +1 -1
- package/dist/engine/node/executors/registry.d.ts.map +1 -1
- package/dist/engine/node/executors/registry.js +13 -2
- package/dist/engine/node/executors/registry.js.map +1 -1
- package/dist/engine/node/install-deps.d.ts +164 -6
- package/dist/engine/node/install-deps.d.ts.map +1 -1
- package/dist/engine/node/install-deps.js +251 -9
- package/dist/engine/node/install-deps.js.map +1 -1
- package/dist/engine/node/ipc-protocol.d.ts +49 -2
- package/dist/engine/node/ipc-protocol.d.ts.map +1 -1
- package/dist/engine/node/ipc-protocol.js +39 -0
- package/dist/engine/node/ipc-protocol.js.map +1 -1
- package/dist/engine/node/lifecycle.js +2 -1
- package/dist/engine/node/lifecycle.js.map +1 -1
- package/dist/engine/node/logger.d.ts +13 -0
- package/dist/engine/node/logger.d.ts.map +1 -1
- package/dist/engine/node/logger.js.map +1 -1
- package/dist/engine/node/memory-watchdog.d.ts +11 -0
- package/dist/engine/node/memory-watchdog.d.ts.map +1 -1
- package/dist/engine/node/memory-watchdog.js +28 -4
- package/dist/engine/node/memory-watchdog.js.map +1 -1
- package/dist/engine/node/models.d.ts +195 -0
- package/dist/engine/node/models.d.ts.map +1 -0
- package/dist/engine/node/models.js +379 -0
- package/dist/engine/node/models.js.map +1 -0
- package/dist/engine/node/node-dashboard-source.d.ts +46 -19
- package/dist/engine/node/node-dashboard-source.d.ts.map +1 -1
- package/dist/engine/node/node-dashboard-source.js +70 -102
- package/dist/engine/node/node-dashboard-source.js.map +1 -1
- package/dist/engine/node/node-engine.d.ts +20 -2
- package/dist/engine/node/node-engine.d.ts.map +1 -1
- package/dist/engine/node/node-engine.js +99 -11
- package/dist/engine/node/node-engine.js.map +1 -1
- package/dist/engine/node/runtime-state.d.ts +24 -0
- package/dist/engine/node/runtime-state.d.ts.map +1 -0
- package/dist/engine/node/runtime-state.js +19 -0
- package/dist/engine/node/runtime-state.js.map +1 -0
- package/dist/engine/node/runtime-tuning.d.ts +111 -2
- package/dist/engine/node/runtime-tuning.d.ts.map +1 -1
- package/dist/engine/node/runtime-tuning.js +133 -4
- package/dist/engine/node/runtime-tuning.js.map +1 -1
- package/dist/engine/node/service.d.ts.map +1 -1
- package/dist/engine/node/service.js +4 -0
- package/dist/engine/node/service.js.map +1 -1
- package/dist/engine/node/start.d.ts +7 -0
- package/dist/engine/node/start.d.ts.map +1 -1
- package/dist/engine/node/start.js +71 -3
- package/dist/engine/node/start.js.map +1 -1
- package/dist/engine/node/worker-env-aliases.d.ts +39 -0
- package/dist/engine/node/worker-env-aliases.d.ts.map +1 -0
- package/dist/engine/node/worker-env-aliases.js +126 -0
- package/dist/engine/node/worker-env-aliases.js.map +1 -0
- package/dist/engine/node/worker-env-table.d.ts.map +1 -1
- package/dist/engine/node/worker-env-table.js +4 -1
- package/dist/engine/node/worker-env-table.js.map +1 -1
- package/dist/engine/node/worker-env.d.ts +18 -1
- package/dist/engine/node/worker-env.d.ts.map +1 -1
- package/dist/engine/node/worker-env.js +13 -0
- package/dist/engine/node/worker-env.js.map +1 -1
- package/dist/engine/registries.d.ts.map +1 -1
- package/dist/engine/registries.js +7 -0
- package/dist/engine/registries.js.map +1 -1
- package/dist/engine/tui/app.d.ts.map +1 -1
- package/dist/engine/tui/app.js +15 -2
- package/dist/engine/tui/app.js.map +1 -1
- package/dist/engine/tui/builtin-screens.d.ts.map +1 -1
- package/dist/engine/tui/builtin-screens.js +6 -0
- package/dist/engine/tui/builtin-screens.js.map +1 -1
- package/dist/engine/tui/conformance.d.ts +143 -0
- package/dist/engine/tui/conformance.d.ts.map +1 -0
- package/dist/engine/tui/conformance.js +423 -0
- package/dist/engine/tui/conformance.js.map +1 -0
- package/dist/engine/tui/dashboard/index.d.ts +8 -0
- package/dist/engine/tui/dashboard/index.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/index.js +5 -0
- package/dist/engine/tui/dashboard/index.js.map +1 -0
- package/dist/engine/tui/dashboard/jobs-insights.d.ts +145 -0
- package/dist/engine/tui/dashboard/jobs-insights.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/jobs-insights.js +63 -0
- package/dist/engine/tui/dashboard/jobs-insights.js.map +1 -0
- package/dist/engine/tui/dashboard/node-embedded.d.ts +33 -0
- package/dist/engine/tui/dashboard/node-embedded.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/node-embedded.js +81 -0
- package/dist/engine/tui/dashboard/node-embedded.js.map +1 -0
- package/dist/engine/tui/dashboard/source.d.ts +274 -0
- package/dist/engine/tui/dashboard/source.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/source.js +351 -0
- package/dist/engine/tui/dashboard/source.js.map +1 -0
- package/dist/engine/tui/dashboard/use-dashboard.d.ts +23 -0
- package/dist/engine/tui/dashboard/use-dashboard.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/use-dashboard.js +32 -0
- package/dist/engine/tui/dashboard/use-dashboard.js.map +1 -0
- package/dist/engine/tui/layout.d.ts +20 -0
- package/dist/engine/tui/layout.d.ts.map +1 -1
- package/dist/engine/tui/layout.js +7 -0
- package/dist/engine/tui/layout.js.map +1 -1
- package/dist/engine/tui/menu-registry.d.ts +124 -0
- package/dist/engine/tui/menu-registry.d.ts.map +1 -0
- package/dist/engine/tui/menu-registry.js +151 -0
- package/dist/engine/tui/menu-registry.js.map +1 -0
- package/dist/engine/tui/menu-tree.d.ts +179 -0
- package/dist/engine/tui/menu-tree.d.ts.map +1 -0
- package/dist/engine/tui/menu-tree.js +250 -0
- package/dist/engine/tui/menu-tree.js.map +1 -0
- package/dist/engine/tui/screen-registry.d.ts +1 -1
- package/dist/engine/tui/screen-registry.d.ts.map +1 -1
- package/dist/engine/tui/screen-registry.js +2 -1
- package/dist/engine/tui/screen-registry.js.map +1 -1
- package/dist/engine/tui/screens/jobs.d.ts +12 -0
- package/dist/engine/tui/screens/jobs.d.ts.map +1 -0
- package/dist/engine/tui/screens/jobs.js +72 -0
- package/dist/engine/tui/screens/jobs.js.map +1 -0
- package/dist/engine/tui/screens/menu.d.ts +4 -1
- package/dist/engine/tui/screens/menu.d.ts.map +1 -1
- package/dist/engine/tui/screens/menu.js +85 -22
- package/dist/engine/tui/screens/menu.js.map +1 -1
- package/dist/engine/tui/screens/node.d.ts.map +1 -1
- package/dist/engine/tui/screens/node.js +82 -37
- package/dist/engine/tui/screens/node.js.map +1 -1
- package/dist/engine/tui/screens/not-logged-in.d.ts +12 -0
- package/dist/engine/tui/screens/not-logged-in.d.ts.map +1 -0
- package/dist/engine/tui/screens/not-logged-in.js +14 -0
- package/dist/engine/tui/screens/not-logged-in.js.map +1 -0
- package/dist/engine/tui/scroll-box.d.ts +15 -0
- package/dist/engine/tui/scroll-box.d.ts.map +1 -1
- package/dist/engine/tui/scroll-box.js +10 -0
- package/dist/engine/tui/scroll-box.js.map +1 -1
- package/dist/engine/tui/testing/feeds.d.ts +58 -0
- package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
- package/dist/engine/tui/testing/feeds.js +67 -0
- package/dist/engine/tui/testing/feeds.js.map +1 -0
- package/dist/engine/tui/testing/harness.d.ts +241 -0
- package/dist/engine/tui/testing/harness.d.ts.map +1 -0
- package/dist/engine/tui/testing/harness.js +332 -0
- package/dist/engine/tui/testing/harness.js.map +1 -0
- package/dist/engine/tui/ui/active-items.d.ts +40 -0
- package/dist/engine/tui/ui/active-items.d.ts.map +1 -0
- package/dist/engine/tui/ui/active-items.js +38 -0
- package/dist/engine/tui/ui/active-items.js.map +1 -0
- package/dist/engine/tui/ui/event-log.d.ts +58 -0
- package/dist/engine/tui/ui/event-log.d.ts.map +1 -0
- package/dist/engine/tui/ui/event-log.js +32 -0
- package/dist/engine/tui/ui/event-log.js.map +1 -0
- package/dist/engine/tui/ui/index.d.ts +20 -0
- package/dist/engine/tui/ui/index.d.ts.map +1 -0
- package/dist/engine/tui/ui/index.js +14 -0
- package/dist/engine/tui/ui/index.js.map +1 -0
- package/dist/engine/tui/ui/meter-legend.d.ts +26 -0
- package/dist/engine/tui/ui/meter-legend.d.ts.map +1 -0
- package/dist/engine/tui/ui/meter-legend.js +25 -0
- package/dist/engine/tui/ui/meter-legend.js.map +1 -0
- package/dist/engine/tui/ui/run-summary.d.ts +58 -0
- package/dist/engine/tui/ui/run-summary.d.ts.map +1 -0
- package/dist/engine/tui/ui/run-summary.js +29 -0
- package/dist/engine/tui/ui/run-summary.js.map +1 -0
- package/dist/engine/tui/ui/segment-meter.d.ts +72 -0
- package/dist/engine/tui/ui/segment-meter.d.ts.map +1 -0
- package/dist/engine/tui/ui/segment-meter.js +128 -0
- package/dist/engine/tui/ui/segment-meter.js.map +1 -0
- package/dist/engine/tui/ui/status-line.d.ts +42 -0
- package/dist/engine/tui/ui/status-line.d.ts.map +1 -0
- package/dist/engine/tui/ui/status-line.js +35 -0
- package/dist/engine/tui/ui/status-line.js.map +1 -0
- package/dist/engine/tui/ui/tone.d.ts +46 -0
- package/dist/engine/tui/ui/tone.d.ts.map +1 -0
- package/dist/engine/tui/ui/tone.js +48 -0
- package/dist/engine/tui/ui/tone.js.map +1 -0
- package/dist/node/index.d.ts +2 -2
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/index.js +1 -1
- package/dist/node/index.js.map +1 -1
- package/dist/testing/index.d.ts +2 -2
- package/dist/testing/index.d.ts.map +1 -1
- package/dist/testing/index.js +1 -1
- package/dist/testing/index.js.map +1 -1
- package/dist/tui/index.d.ts +2 -2
- package/dist/tui/index.d.ts.map +1 -1
- package/dist/tui/index.js +1 -1
- package/dist/tui/index.js.map +1 -1
- package/dist/tui/testing/index.d.ts +5 -0
- package/dist/tui/testing/index.d.ts.map +1 -0
- package/dist/tui/testing/index.js +12 -0
- package/dist/tui/testing/index.js.map +1 -0
- package/dist/tui/ui/index.d.ts +2 -0
- package/dist/tui/ui/index.d.ts.map +1 -0
- package/dist/tui/ui/index.js +10 -0
- package/dist/tui/ui/index.js.map +1 -0
- package/package.json +16 -3
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
import type { ConformanceTestApi } from '../conformance.js';
|
|
2
|
+
import type { DashboardReducer } from './dashboard/source.js';
|
|
3
|
+
import { TUI_MENU_MAX_DEPTH, type TuiMenuNode } from './menu-registry.js';
|
|
4
|
+
import { type TuiScreenRegistration } from './screen-registry.js';
|
|
5
|
+
import type { TuiTheme } from './theme.js';
|
|
6
|
+
/**
|
|
7
|
+
* The checks of the `tui` suite.
|
|
8
|
+
*
|
|
9
|
+
* @stability experimental
|
|
10
|
+
*/
|
|
11
|
+
export declare const TUI_CONFORMANCE_CHECKS: readonly ["menu-references", "lazy-screens", "no-ink-import", "labels", "reducer-purity", "screens-render", "no-color", "login-gate"];
|
|
12
|
+
/**
|
|
13
|
+
* One check of the `tui` suite.
|
|
14
|
+
*
|
|
15
|
+
* @stability experimental
|
|
16
|
+
*/
|
|
17
|
+
export type TuiConformanceCheck = (typeof TUI_CONFORMANCE_CHECKS)[number];
|
|
18
|
+
/**
|
|
19
|
+
* A dashboard reducer to check for purity.
|
|
20
|
+
*
|
|
21
|
+
* @stability experimental
|
|
22
|
+
*/
|
|
23
|
+
export interface TuiDashboardCheck {
|
|
24
|
+
/** Shown in the case name. */
|
|
25
|
+
id: string;
|
|
26
|
+
/** The reducer (any state and event types). */
|
|
27
|
+
reducer: DashboardReducer<any, any>;
|
|
28
|
+
/** Sample events to fold into the frozen initial state. */
|
|
29
|
+
events?: readonly unknown[] | undefined;
|
|
30
|
+
/** A sample snapshot for `hydrate`. */
|
|
31
|
+
snapshot?: unknown;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Options of the `tui` suite. Every field is optional: with none, the suite
|
|
35
|
+
* checks the registrations `createCli` collected.
|
|
36
|
+
*
|
|
37
|
+
* @stability experimental
|
|
38
|
+
*/
|
|
39
|
+
export interface TuiConformanceOptions {
|
|
40
|
+
/** Routes allowed to use `component` instead of `load` (each should be a deliberate choice). */
|
|
41
|
+
allowEager?: readonly string[] | undefined;
|
|
42
|
+
/**
|
|
43
|
+
* What the no-ink check imports, in a fresh process: module specifiers
|
|
44
|
+
* (resolved from the working directory), absolute paths or `file:` URLs.
|
|
45
|
+
* Default `['@marinoscar/platform-cli/tui']`. Add the app's compiled
|
|
46
|
+
* registration module (`dist/app.js`); a `.ts` file cannot be loaded.
|
|
47
|
+
*/
|
|
48
|
+
importEntries?: readonly string[] | undefined;
|
|
49
|
+
/** Dashboard reducers to check. */
|
|
50
|
+
dashboards?: readonly TuiDashboardCheck[] | undefined;
|
|
51
|
+
/** `params` to give an app screen by route when it is rendered. */
|
|
52
|
+
screenParams?: Readonly<Record<string, unknown>> | undefined;
|
|
53
|
+
/** Terminal widths of the render checks. Default `[80, 40, 24]`. */
|
|
54
|
+
columns?: readonly number[] | undefined;
|
|
55
|
+
/** Skip a check, with the reason (required, and printed in the case name). */
|
|
56
|
+
skip?: Partial<Record<TuiConformanceCheck, string>> | undefined;
|
|
57
|
+
/** Replaces the registered menu nodes (a test seam). */
|
|
58
|
+
nodes?: readonly TuiMenuNode[] | undefined;
|
|
59
|
+
/** Replaces the registered app screens (a test seam). */
|
|
60
|
+
screens?: readonly TuiScreenRegistration[] | undefined;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Checks the menu: references, reachability, cycles and depth.
|
|
64
|
+
*
|
|
65
|
+
* @param nodes - The menu nodes.
|
|
66
|
+
* @param screens - The app screens (the built-in routes are added).
|
|
67
|
+
* @returns One message per problem; empty when the menu is sound.
|
|
68
|
+
* @stability experimental
|
|
69
|
+
*/
|
|
70
|
+
export declare function checkTuiMenu(nodes: readonly TuiMenuNode[], screens: readonly TuiScreenRegistration[]): string[];
|
|
71
|
+
/**
|
|
72
|
+
* Checks that every app screen and screen section loads lazily.
|
|
73
|
+
*
|
|
74
|
+
* @param screens - The app screens.
|
|
75
|
+
* @param allowEager - Routes allowed to use `component`.
|
|
76
|
+
* @returns One message per eager registration.
|
|
77
|
+
* @stability experimental
|
|
78
|
+
*/
|
|
79
|
+
export declare function checkTuiLazy(screens: readonly TuiScreenRegistration[], allowEager?: readonly string[], sections?: ReadonlyArray<{
|
|
80
|
+
screen: string;
|
|
81
|
+
id: string;
|
|
82
|
+
component?: unknown;
|
|
83
|
+
load?: unknown;
|
|
84
|
+
}>): string[];
|
|
85
|
+
/**
|
|
86
|
+
* Checks that every label is non-empty for both login states.
|
|
87
|
+
*
|
|
88
|
+
* @param nodes - The menu nodes.
|
|
89
|
+
* @param screens - The app screens.
|
|
90
|
+
* @returns One message per bad label.
|
|
91
|
+
* @stability experimental
|
|
92
|
+
*/
|
|
93
|
+
export declare function checkTuiLabels(nodes: readonly TuiMenuNode[], screens: readonly TuiScreenRegistration[]): string[];
|
|
94
|
+
/**
|
|
95
|
+
* Checks that a dashboard reducer is pure: folding events into a deeply frozen
|
|
96
|
+
* `initial()` neither throws a mutation error nor changes it, and `initial()`
|
|
97
|
+
* returns a fresh value each call.
|
|
98
|
+
*
|
|
99
|
+
* @param dashboard - The reducer with sample events.
|
|
100
|
+
* @returns One message per problem.
|
|
101
|
+
* @stability experimental
|
|
102
|
+
*/
|
|
103
|
+
export declare function checkDashboardReducer(dashboard: TuiDashboardCheck): string[];
|
|
104
|
+
/**
|
|
105
|
+
* Imports the entries in a fresh Node process and reports whether any of them
|
|
106
|
+
* (or anything they import) resolved `ink`.
|
|
107
|
+
*
|
|
108
|
+
* @param entries - Specifiers, absolute paths or `file:` URLs. Default the `/tui` subpath.
|
|
109
|
+
* @returns One message per problem; empty when nothing loaded ink.
|
|
110
|
+
* @stability experimental
|
|
111
|
+
*/
|
|
112
|
+
export declare function checkTuiNoInkImport(entries?: readonly string[]): Promise<string[]>;
|
|
113
|
+
/**
|
|
114
|
+
* Renders an app screen at a width and reports a crash or an empty frame
|
|
115
|
+
* (and, under `'mono'`, any colour escape).
|
|
116
|
+
*
|
|
117
|
+
* @param screen - The registration.
|
|
118
|
+
* @param columns - The terminal width.
|
|
119
|
+
* @param theme - `'mono'` for the colourless theme.
|
|
120
|
+
* @param params - The screen's params.
|
|
121
|
+
* @returns One message per problem.
|
|
122
|
+
* @stability experimental
|
|
123
|
+
*/
|
|
124
|
+
export declare function checkTuiScreenRender(screen: TuiScreenRegistration, columns: number, theme: TuiTheme | 'mono' | undefined, params: unknown): Promise<string[]>;
|
|
125
|
+
/**
|
|
126
|
+
* Opens a login-gated route while logged out and reports whether the notice shows.
|
|
127
|
+
*
|
|
128
|
+
* @param route - A registered route that an entry gates.
|
|
129
|
+
* @returns One message per problem.
|
|
130
|
+
* @stability experimental
|
|
131
|
+
*/
|
|
132
|
+
export declare function checkTuiLoginGate(route: string): Promise<string[]>;
|
|
133
|
+
/**
|
|
134
|
+
* Registers the `tui` suite's cases.
|
|
135
|
+
*
|
|
136
|
+
* @param api - The test API.
|
|
137
|
+
* @param options - The suite's options.
|
|
138
|
+
* @stability experimental
|
|
139
|
+
*/
|
|
140
|
+
export declare function registerTuiConformance(api: ConformanceTestApi, options: TuiConformanceOptions): void;
|
|
141
|
+
/** Re-exported so the conformance doc can state the cap. */
|
|
142
|
+
export { TUI_MENU_MAX_DEPTH };
|
|
143
|
+
//# sourceMappingURL=conformance.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../src/engine/tui/conformance.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,423 @@
|
|
|
1
|
+
import { execFile } from 'node:child_process';
|
|
2
|
+
import { createRequire } from 'node:module';
|
|
3
|
+
import { isAbsolute } from 'node:path';
|
|
4
|
+
import { pathToFileURL } from 'node:url';
|
|
5
|
+
import { listTuiMenuNodes, TUI_MENU_MAX_DEPTH, TUI_MENU_ROOT, validateTuiMenuNodes, } from './menu-registry.js';
|
|
6
|
+
import { buildTuiMenuTree, tuiRouteRequiresLogin, visibleTuiMenuChildren } from './menu-tree.js';
|
|
7
|
+
import { BUILTIN_TUI_SCREENS, listRegisteredTuiScreens } from './screen-registry.js';
|
|
8
|
+
import { listTuiScreenSections, TUI_SECTION_SCREENS } from './section-registry.js';
|
|
9
|
+
// =============================================================================
|
|
10
|
+
// The `tui` conformance suite (RETRO-G1.5, #1069)
|
|
11
|
+
// =============================================================================
|
|
12
|
+
//
|
|
13
|
+
// An executable contract over an app's TUI registrations, run by
|
|
14
|
+
// `runPlatformConformance({ suites: { tui: {} } })` after `createCli`:
|
|
15
|
+
//
|
|
16
|
+
// menu-references every entry opens a registered screen, every section is
|
|
17
|
+
// reachable, no cycles, nesting <= TUI_MENU_MAX_DEPTH;
|
|
18
|
+
// lazy-screens every app screen and screen section uses `load`, so
|
|
19
|
+
// `--help` and `api` never load ink (opt out per route);
|
|
20
|
+
// no-ink-import importing `@marinoscar/platform-cli/tui` (and the app's
|
|
21
|
+
// own registration module) loads no `ink`, proven in a
|
|
22
|
+
// fresh Node process with a resolve hook;
|
|
23
|
+
// labels every label is non-empty for logged-in AND logged-out;
|
|
24
|
+
// reducer-purity each dashboard reducer leaves a frozen input untouched;
|
|
25
|
+
// screens-render every app screen renders (a non-empty frame, no crash) at
|
|
26
|
+
// 80 / 40 / 24 columns;
|
|
27
|
+
// no-color ... and under the monochrome theme emits no colour code;
|
|
28
|
+
// login-gate every login-gated entry shows the "not logged in" notice
|
|
29
|
+
// when logged out.
|
|
30
|
+
//
|
|
31
|
+
// Each check is skippable with a written reason (`skip: { 'no-color': 'why' }`),
|
|
32
|
+
// like a suite is. The pure checks are exported (`checkTuiMenu`, ...) so a
|
|
33
|
+
// test can prove each one fails on a broken fixture.
|
|
34
|
+
//
|
|
35
|
+
// The three render checks use the TUI testing kit (`/tui/testing`), which needs
|
|
36
|
+
// `ink-testing-library`; it is imported inside those cases only, so the pure
|
|
37
|
+
// checks run without it.
|
|
38
|
+
// =============================================================================
|
|
39
|
+
/**
|
|
40
|
+
* The checks of the `tui` suite.
|
|
41
|
+
*
|
|
42
|
+
* @stability experimental
|
|
43
|
+
*/
|
|
44
|
+
export const TUI_CONFORMANCE_CHECKS = [
|
|
45
|
+
'menu-references',
|
|
46
|
+
'lazy-screens',
|
|
47
|
+
'no-ink-import',
|
|
48
|
+
'labels',
|
|
49
|
+
'reducer-purity',
|
|
50
|
+
'screens-render',
|
|
51
|
+
'no-color',
|
|
52
|
+
'login-gate',
|
|
53
|
+
];
|
|
54
|
+
// -----------------------------------------------------------------------------
|
|
55
|
+
// The pure checks
|
|
56
|
+
// -----------------------------------------------------------------------------
|
|
57
|
+
function builtinScreenInfos() {
|
|
58
|
+
return BUILTIN_TUI_SCREENS.map(({ route, order }) => ({ route, order, label: route }));
|
|
59
|
+
}
|
|
60
|
+
/** The tree the suite checks: the built-ins with their route as label, then the app's screens. */
|
|
61
|
+
function treeOf(nodes, screens) {
|
|
62
|
+
return buildTuiMenuTree(nodes, [...builtinScreenInfos(), ...screens]);
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Checks the menu: references, reachability, cycles and depth.
|
|
66
|
+
*
|
|
67
|
+
* @param nodes - The menu nodes.
|
|
68
|
+
* @param screens - The app screens (the built-in routes are added).
|
|
69
|
+
* @returns One message per problem; empty when the menu is sound.
|
|
70
|
+
* @stability experimental
|
|
71
|
+
*/
|
|
72
|
+
export function checkTuiMenu(nodes, screens) {
|
|
73
|
+
const routes = [...BUILTIN_TUI_SCREENS, ...screens].map((screen) => screen.route);
|
|
74
|
+
const problems = [];
|
|
75
|
+
// `validateTuiMenuNodes` stops at the first problem; check node by node so a
|
|
76
|
+
// report names every one.
|
|
77
|
+
for (const node of nodes) {
|
|
78
|
+
try {
|
|
79
|
+
validateTuiMenuNodes(nodes.filter((other) => other === node || isAncestor(nodes, other, node)), routes);
|
|
80
|
+
}
|
|
81
|
+
catch (error) {
|
|
82
|
+
const message = error.message;
|
|
83
|
+
if (!problems.includes(message))
|
|
84
|
+
problems.push(message);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
if (problems.length > 0)
|
|
88
|
+
return problems;
|
|
89
|
+
const tree = treeOf(nodes, screens);
|
|
90
|
+
const reached = new Set();
|
|
91
|
+
const walk = (sectionId, loggedIn) => {
|
|
92
|
+
if (reached.has(`${sectionId}:${loggedIn}`))
|
|
93
|
+
return;
|
|
94
|
+
reached.add(`${sectionId}:${loggedIn}`);
|
|
95
|
+
for (const child of visibleTuiMenuChildren(sectionId, { loggedIn }, tree)) {
|
|
96
|
+
if (child.kind === 'section')
|
|
97
|
+
walk(child.id, loggedIn);
|
|
98
|
+
}
|
|
99
|
+
};
|
|
100
|
+
walk(TUI_MENU_ROOT, true);
|
|
101
|
+
walk(TUI_MENU_ROOT, false);
|
|
102
|
+
for (const id of tree.sections.keys()) {
|
|
103
|
+
if (id === TUI_MENU_ROOT)
|
|
104
|
+
continue;
|
|
105
|
+
if (!reached.has(`${id}:true`) && !reached.has(`${id}:false`)) {
|
|
106
|
+
problems.push(`TUI menu section "${id}" is unreachable: it has no entry visible to a logged-in or a logged-out user.`);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
return problems;
|
|
110
|
+
}
|
|
111
|
+
/** True when `candidate` is on the parent chain of `node` (so validating them together sees the node's depth and cycles). */
|
|
112
|
+
function isAncestor(nodes, candidate, node) {
|
|
113
|
+
const byId = new Map(nodes.map((entry) => [entry.id, entry]));
|
|
114
|
+
const seen = new Set();
|
|
115
|
+
let parent = node.parent;
|
|
116
|
+
while (parent !== undefined && parent !== TUI_MENU_ROOT && !seen.has(parent)) {
|
|
117
|
+
if (parent === candidate.id)
|
|
118
|
+
return true;
|
|
119
|
+
seen.add(parent);
|
|
120
|
+
parent = byId.get(parent)?.parent;
|
|
121
|
+
}
|
|
122
|
+
return false;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Checks that every app screen and screen section loads lazily.
|
|
126
|
+
*
|
|
127
|
+
* @param screens - The app screens.
|
|
128
|
+
* @param allowEager - Routes allowed to use `component`.
|
|
129
|
+
* @returns One message per eager registration.
|
|
130
|
+
* @stability experimental
|
|
131
|
+
*/
|
|
132
|
+
export function checkTuiLazy(screens, allowEager = [], sections = TUI_SECTION_SCREENS.flatMap((screen) => listTuiScreenSections(screen))) {
|
|
133
|
+
const problems = [];
|
|
134
|
+
for (const screen of screens) {
|
|
135
|
+
if (screen.component !== undefined && !allowEager.includes(screen.route)) {
|
|
136
|
+
problems.push(`TUI screen "${screen.route}" is registered with \`component\`, which loads ink on every run (\`--help\` and \`api\` included). Use \`load: async () => (await import('./x.js')).X\`, or list the route in \`allowEager\` for a reason.`);
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
for (const section of sections) {
|
|
140
|
+
if (section.component !== undefined && !allowEager.includes(`${section.screen}:${section.id}`)) {
|
|
141
|
+
problems.push(`TUI section "${section.screen}:${section.id}" is registered with \`component\`; use \`{ id, load }\`, or list "${section.screen}:${section.id}" in \`allowEager\`.`);
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
return problems;
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* Checks that every label is non-empty for both login states.
|
|
148
|
+
*
|
|
149
|
+
* @param nodes - The menu nodes.
|
|
150
|
+
* @param screens - The app screens.
|
|
151
|
+
* @returns One message per bad label.
|
|
152
|
+
* @stability experimental
|
|
153
|
+
*/
|
|
154
|
+
export function checkTuiLabels(nodes, screens) {
|
|
155
|
+
const problems = [];
|
|
156
|
+
const check = (what, label) => {
|
|
157
|
+
for (const loggedIn of [true, false]) {
|
|
158
|
+
const state = loggedIn ? 'logged in' : 'logged out';
|
|
159
|
+
try {
|
|
160
|
+
const text = typeof label === 'function' ? label({ loggedIn }) : label;
|
|
161
|
+
if (typeof text !== 'string' || text.trim() === '') {
|
|
162
|
+
problems.push(`${what} has an empty label when ${state}.`);
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
catch (error) {
|
|
166
|
+
problems.push(`${what}'s label function throws when ${state}: ${error.message}`);
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
};
|
|
170
|
+
for (const node of nodes)
|
|
171
|
+
check(`TUI menu ${node.kind} "${node.id}"`, node.label);
|
|
172
|
+
for (const screen of screens)
|
|
173
|
+
check(`TUI screen "${screen.route}"`, screen.label);
|
|
174
|
+
return problems;
|
|
175
|
+
}
|
|
176
|
+
function deepFreeze(value, seen = new Set()) {
|
|
177
|
+
if (typeof value !== 'object' || value === null || seen.has(value))
|
|
178
|
+
return value;
|
|
179
|
+
seen.add(value);
|
|
180
|
+
Object.freeze(value);
|
|
181
|
+
for (const key of Reflect.ownKeys(value))
|
|
182
|
+
deepFreeze(value[key], seen);
|
|
183
|
+
return value;
|
|
184
|
+
}
|
|
185
|
+
function plain(value) {
|
|
186
|
+
return JSON.stringify(value, (_key, item) => (typeof item === 'bigint' ? `${item}n` : item));
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Checks that a dashboard reducer is pure: folding events into a deeply frozen
|
|
190
|
+
* `initial()` neither throws a mutation error nor changes it, and `initial()`
|
|
191
|
+
* returns a fresh value each call.
|
|
192
|
+
*
|
|
193
|
+
* @param dashboard - The reducer with sample events.
|
|
194
|
+
* @returns One message per problem.
|
|
195
|
+
* @stability experimental
|
|
196
|
+
*/
|
|
197
|
+
export function checkDashboardReducer(dashboard) {
|
|
198
|
+
const problems = [];
|
|
199
|
+
const reducer = dashboard.reducer;
|
|
200
|
+
const name = `Dashboard reducer "${dashboard.id}"`;
|
|
201
|
+
const first = reducer.initial();
|
|
202
|
+
if (typeof first === 'object' && first !== null && first === reducer.initial()) {
|
|
203
|
+
problems.push(`${name}: initial() returns the same object every call; a reducer that mutates it would leak state between dashboards.`);
|
|
204
|
+
}
|
|
205
|
+
const frozen = deepFreeze(reducer.initial());
|
|
206
|
+
const before = plain(frozen);
|
|
207
|
+
const attempt = (step, run) => {
|
|
208
|
+
try {
|
|
209
|
+
run();
|
|
210
|
+
}
|
|
211
|
+
catch (error) {
|
|
212
|
+
problems.push(`${name}: ${step} threw on a frozen input (it mutates its input, or fails): ${error.message}`);
|
|
213
|
+
}
|
|
214
|
+
if (plain(frozen) !== before)
|
|
215
|
+
problems.push(`${name}: ${step} changed initial().`);
|
|
216
|
+
};
|
|
217
|
+
if (dashboard.snapshot !== undefined)
|
|
218
|
+
attempt('hydrate(initial(), snapshot)', () => reducer.hydrate(frozen, dashboard.snapshot));
|
|
219
|
+
for (const [index, event] of (dashboard.events ?? []).entries()) {
|
|
220
|
+
attempt(`reduce(initial(), events[${index}])`, () => reducer.reduce(frozen, event));
|
|
221
|
+
}
|
|
222
|
+
if (reducer.log !== undefined)
|
|
223
|
+
attempt('log(initial(), [])', () => reducer.log?.(frozen, []));
|
|
224
|
+
return problems;
|
|
225
|
+
}
|
|
226
|
+
const HOOK_SOURCE = `
|
|
227
|
+
let port;
|
|
228
|
+
export function initialize(data) { port = data.port; }
|
|
229
|
+
export async function resolve(specifier, context, next) {
|
|
230
|
+
if (/^ink(\\/|$)/.test(specifier) || specifier === 'ink-testing-library') port.postMessage(specifier);
|
|
231
|
+
return next(specifier, context);
|
|
232
|
+
}
|
|
233
|
+
`;
|
|
234
|
+
const CHILD_SOURCE = `
|
|
235
|
+
import { register } from 'node:module';
|
|
236
|
+
import { MessageChannel } from 'node:worker_threads';
|
|
237
|
+
const { port1, port2 } = new MessageChannel();
|
|
238
|
+
const seen = new Set();
|
|
239
|
+
port1.on('message', (specifier) => seen.add(specifier));
|
|
240
|
+
register('data:text/javascript,' + encodeURIComponent(process.env.TUI_CONFORMANCE_HOOK), { parentURL: import.meta.url, data: { port: port2 }, transferList: [port2] });
|
|
241
|
+
const failures = [];
|
|
242
|
+
for (const entry of JSON.parse(process.env.TUI_CONFORMANCE_ENTRIES)) {
|
|
243
|
+
try { await import(entry); } catch (error) { failures.push(entry + ': ' + (error && error.message || error)); }
|
|
244
|
+
}
|
|
245
|
+
await new Promise((resolve) => setTimeout(resolve, 100));
|
|
246
|
+
process.stdout.write(JSON.stringify({ ink: [...seen], failures }));
|
|
247
|
+
process.exit(0);
|
|
248
|
+
`;
|
|
249
|
+
function resolveEntry(entry) {
|
|
250
|
+
if (entry.startsWith('file:'))
|
|
251
|
+
return entry;
|
|
252
|
+
if (isAbsolute(entry))
|
|
253
|
+
return pathToFileURL(entry).href;
|
|
254
|
+
return pathToFileURL(createRequire(`${process.cwd()}/`).resolve(entry)).href;
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* Imports the entries in a fresh Node process and reports whether any of them
|
|
258
|
+
* (or anything they import) resolved `ink`.
|
|
259
|
+
*
|
|
260
|
+
* @param entries - Specifiers, absolute paths or `file:` URLs. Default the `/tui` subpath.
|
|
261
|
+
* @returns One message per problem; empty when nothing loaded ink.
|
|
262
|
+
* @stability experimental
|
|
263
|
+
*/
|
|
264
|
+
export async function checkTuiNoInkImport(entries = ['@marinoscar/platform-cli/tui']) {
|
|
265
|
+
let urls;
|
|
266
|
+
try {
|
|
267
|
+
urls = entries.map(resolveEntry);
|
|
268
|
+
}
|
|
269
|
+
catch (error) {
|
|
270
|
+
return [`Cannot resolve a no-ink entry: ${error.message}`];
|
|
271
|
+
}
|
|
272
|
+
const output = await new Promise((resolve, reject) => {
|
|
273
|
+
execFile(process.execPath, ['--input-type=module', '-e', CHILD_SOURCE], { env: { ...process.env, TUI_CONFORMANCE_HOOK: HOOK_SOURCE, TUI_CONFORMANCE_ENTRIES: JSON.stringify(urls) }, timeout: 60_000 }, (error, stdout, stderr) => (error === null ? resolve(stdout) : reject(new Error(`${error.message}\n${stderr}`))));
|
|
274
|
+
});
|
|
275
|
+
const report = JSON.parse(output);
|
|
276
|
+
return [
|
|
277
|
+
...report.failures.map((failure) => `Could not import ${failure}`),
|
|
278
|
+
...(report.ink.length > 0
|
|
279
|
+
? [
|
|
280
|
+
`Importing ${entries.join(', ')} loads ${[...new Set(report.ink)].join(', ')}. Registration modules must not import ink at the top level: register screens with \`load\` and import ink only inside the screen component's module.`,
|
|
281
|
+
]
|
|
282
|
+
: []),
|
|
283
|
+
];
|
|
284
|
+
}
|
|
285
|
+
async function loadRenderKit() {
|
|
286
|
+
try {
|
|
287
|
+
return await import('./testing/harness.js');
|
|
288
|
+
}
|
|
289
|
+
catch (error) {
|
|
290
|
+
throw new Error(`The tui render checks need ink-testing-library: install it as a dev dependency (\`npm i -D ink-testing-library\`), or skip them with a reason (\`skip: { 'screens-render': '...' }\`). ${error.message}`);
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
async function screenComponent(screen) {
|
|
294
|
+
return screen.component ?? (await screen.load?.());
|
|
295
|
+
}
|
|
296
|
+
/**
|
|
297
|
+
* Renders an app screen at a width and reports a crash or an empty frame
|
|
298
|
+
* (and, under `'mono'`, any colour escape).
|
|
299
|
+
*
|
|
300
|
+
* @param screen - The registration.
|
|
301
|
+
* @param columns - The terminal width.
|
|
302
|
+
* @param theme - `'mono'` for the colourless theme.
|
|
303
|
+
* @param params - The screen's params.
|
|
304
|
+
* @returns One message per problem.
|
|
305
|
+
* @stability experimental
|
|
306
|
+
*/
|
|
307
|
+
export async function checkTuiScreenRender(screen, columns, theme, params) {
|
|
308
|
+
const kit = await loadRenderKit();
|
|
309
|
+
const problems = [];
|
|
310
|
+
const name = `TUI screen "${screen.route}" at ${columns} columns${theme === 'mono' ? ' (monochrome)' : ''}`;
|
|
311
|
+
try {
|
|
312
|
+
const Screen = await screenComponent(screen);
|
|
313
|
+
if (Screen === undefined)
|
|
314
|
+
return [`${name}: has neither component nor load.`];
|
|
315
|
+
const handle = await kit.renderTuiScreen(Screen, { columns, theme, params });
|
|
316
|
+
try {
|
|
317
|
+
const crashed = handle.crashed();
|
|
318
|
+
if (crashed !== undefined)
|
|
319
|
+
return [`${name}: crashed: ${crashed}`];
|
|
320
|
+
const frame = handle.lastFrame() ?? '';
|
|
321
|
+
const text = kit.stripAnsi(frame);
|
|
322
|
+
if (text.trim() === '')
|
|
323
|
+
problems.push(`${name}: rendered an empty frame.`);
|
|
324
|
+
if (theme === 'mono' && kit.hasAnsi(frame))
|
|
325
|
+
problems.push(`${name}: emitted a colour escape under the monochrome theme (draw colour from \`useTuiTheme()\`).`);
|
|
326
|
+
}
|
|
327
|
+
finally {
|
|
328
|
+
handle.unmount();
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
catch (error) {
|
|
332
|
+
problems.push(`${name}: crashed: ${error.message}`);
|
|
333
|
+
}
|
|
334
|
+
return problems;
|
|
335
|
+
}
|
|
336
|
+
/**
|
|
337
|
+
* Opens a login-gated route while logged out and reports whether the notice shows.
|
|
338
|
+
*
|
|
339
|
+
* @param route - A registered route that an entry gates.
|
|
340
|
+
* @returns One message per problem.
|
|
341
|
+
* @stability experimental
|
|
342
|
+
*/
|
|
343
|
+
export async function checkTuiLoginGate(route) {
|
|
344
|
+
const kit = await loadRenderKit();
|
|
345
|
+
const handle = await kit.renderTuiRoute(route, { session: { loggedIn: false }, theme: 'mono' });
|
|
346
|
+
try {
|
|
347
|
+
const text = kit.stripAnsi(handle.lastFrame() ?? '');
|
|
348
|
+
return /not logged in/i.test(text)
|
|
349
|
+
? []
|
|
350
|
+
: [`TUI route "${route}" requires a login but showed no "not logged in" notice when logged out. The frame was:\n${text}`];
|
|
351
|
+
}
|
|
352
|
+
catch (error) {
|
|
353
|
+
return [`TUI route "${route}" crashed when opened logged out: ${error.message}`];
|
|
354
|
+
}
|
|
355
|
+
finally {
|
|
356
|
+
handle.unmount();
|
|
357
|
+
}
|
|
358
|
+
}
|
|
359
|
+
// -----------------------------------------------------------------------------
|
|
360
|
+
// Registering the cases
|
|
361
|
+
// -----------------------------------------------------------------------------
|
|
362
|
+
/**
|
|
363
|
+
* Registers the `tui` suite's cases.
|
|
364
|
+
*
|
|
365
|
+
* @param api - The test API.
|
|
366
|
+
* @param options - The suite's options.
|
|
367
|
+
* @stability experimental
|
|
368
|
+
*/
|
|
369
|
+
export function registerTuiConformance(api, options) {
|
|
370
|
+
for (const [check, reason] of Object.entries(options.skip ?? {})) {
|
|
371
|
+
if (!TUI_CONFORMANCE_CHECKS.includes(check)) {
|
|
372
|
+
throw new Error(`tui conformance: unknown check "${check}" in \`skip\`. Known checks: ${TUI_CONFORMANCE_CHECKS.join(', ')}.`);
|
|
373
|
+
}
|
|
374
|
+
if (typeof reason !== 'string' || reason.trim() === '') {
|
|
375
|
+
throw new Error(`tui conformance: check "${check}" is skipped without a reason. Pass \`skip: { '${check}': 'why this app does not run it' }\`.`);
|
|
376
|
+
}
|
|
377
|
+
}
|
|
378
|
+
const nodes = () => options.nodes ?? listTuiMenuNodes();
|
|
379
|
+
const screens = () => options.screens ?? listRegisteredTuiScreens();
|
|
380
|
+
// Throw the messages themselves: a matcher's diff would print `Array(1)`.
|
|
381
|
+
const expectNone = (problems) => {
|
|
382
|
+
if (problems.length > 0)
|
|
383
|
+
throw new Error(`\n${problems.join('\n')}`);
|
|
384
|
+
};
|
|
385
|
+
// A skipped check is one passing case that says why, as the suites do.
|
|
386
|
+
const run = (check, title, body) => {
|
|
387
|
+
const reason = options.skip?.[check];
|
|
388
|
+
if (reason !== undefined)
|
|
389
|
+
api.it(`${check}: skipped by the app (${reason})`, () => undefined);
|
|
390
|
+
else
|
|
391
|
+
api.it(`${check}: ${title}`, body);
|
|
392
|
+
};
|
|
393
|
+
api.describe('tui conformance', () => {
|
|
394
|
+
run('menu-references', 'every entry opens a registered screen, every section is reachable, no cycles, depth within the cap', () => expectNone(checkTuiMenu(nodes(), screens())));
|
|
395
|
+
run('lazy-screens', 'every app screen and section loads lazily', () => expectNone(checkTuiLazy(screens(), options.allowEager)));
|
|
396
|
+
run('no-ink-import', 'importing the TUI entries loads no ink', async () => expectNone(await checkTuiNoInkImport(options.importEntries)));
|
|
397
|
+
run('labels', 'every label is non-empty logged in and logged out', () => expectNone(checkTuiLabels(nodes(), screens())));
|
|
398
|
+
for (const dashboard of options.dashboards ?? []) {
|
|
399
|
+
run('reducer-purity', `dashboard "${dashboard.id}" does not mutate its input`, () => expectNone(checkDashboardReducer(dashboard)));
|
|
400
|
+
}
|
|
401
|
+
if (options.dashboards === undefined || options.dashboards.length === 0) {
|
|
402
|
+
run('reducer-purity', 'no dashboard reducer was passed (nothing to check)', () => undefined);
|
|
403
|
+
}
|
|
404
|
+
const widths = options.columns ?? [80, 40, 24];
|
|
405
|
+
for (const screen of screens()) {
|
|
406
|
+
for (const columns of widths) {
|
|
407
|
+
run('screens-render', `screen "${screen.route}" renders at ${columns} columns`, async () => expectNone(await checkTuiScreenRender(screen, columns, undefined, options.screenParams?.[screen.route])));
|
|
408
|
+
}
|
|
409
|
+
run('no-color', `screen "${screen.route}" draws no colour under the monochrome theme`, async () => expectNone(await checkTuiScreenRender(screen, 80, 'mono', options.screenParams?.[screen.route])));
|
|
410
|
+
}
|
|
411
|
+
run('login-gate', 'every login-gated entry shows the notice when logged out', async () => {
|
|
412
|
+
const tree = treeOf(nodes(), screens());
|
|
413
|
+
const gated = [...new Set(tree.entries.map((entry) => entry.route))].filter((route) => tuiRouteRequiresLogin(route, tree));
|
|
414
|
+
const problems = [];
|
|
415
|
+
for (const route of gated)
|
|
416
|
+
problems.push(...(await checkTuiLoginGate(route)));
|
|
417
|
+
expectNone(problems);
|
|
418
|
+
});
|
|
419
|
+
});
|
|
420
|
+
}
|
|
421
|
+
/** Re-exported so the conformance doc can state the cap. */
|
|
422
|
+
export { TUI_MENU_MAX_DEPTH };
|
|
423
|
+
//# sourceMappingURL=conformance.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../../src/engine/tui/conformance.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export { DashboardSource, daemonAttachFeed, inProcessFeed, pollFeed, selectDashboardFeed, } from './source.js';
|
|
2
|
+
export type { DaemonAttachFeedOptions, DashboardConnection, DashboardEmitter, DashboardFeed, DashboardFeedMessage, DashboardMode, DashboardReducer, DashboardSourceOptions, InProcessFeedOptions, PollFeedOptions, SelectDashboardFeedDeps, } from './source.js';
|
|
3
|
+
export { useDashboard } from './use-dashboard.js';
|
|
4
|
+
export { fetchJobsInsights, jobsInsightsReducer } from './jobs-insights.js';
|
|
5
|
+
export type { JobsApi, JobsDashboardData, JobsEta, JobsInsights, JobsPollResult, JobsStats, JobsStatusCounts, } from './jobs-insights.js';
|
|
6
|
+
export { embeddedNodeFeed, isDaemonListening } from './node-embedded.js';
|
|
7
|
+
export type { EmbeddedNodeFeedOptions } from './node-embedded.js';
|
|
8
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/tui/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EACV,OAAO,EACP,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,SAAS,EACT,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export { DashboardSource, daemonAttachFeed, inProcessFeed, pollFeed, selectDashboardFeed, } from './source.js';
|
|
2
|
+
export { useDashboard } from './use-dashboard.js';
|
|
3
|
+
export { fetchJobsInsights, jobsInsightsReducer } from './jobs-insights.js';
|
|
4
|
+
export { embeddedNodeFeed, isDaemonListening } from './node-embedded.js';
|
|
5
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/tui/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAcrB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAU5E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
|