@kjanat/dreamcli 4.0.0-rc.3 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (212) hide show
  1. package/README.md +5 -7
  2. package/dist/{runtime/adapter.d.mts → adapter-D0hbBNVB.d.mts} +2 -4
  3. package/dist/completion-D4mz6axB.mjs +6 -0
  4. package/dist/completion.d.mts +90 -0
  5. package/dist/completion.mjs +1 -0
  6. package/dist/config-B9ddC-Kb.mjs +1 -0
  7. package/dist/config.d.mts +2 -0
  8. package/dist/config.mjs +1 -0
  9. package/dist/core-Cp2w8vRq.mjs +17 -0
  10. package/dist/index-BziI2aKc.d.mts +5440 -0
  11. package/dist/index-DOfClfYR.d.mts +370 -0
  12. package/dist/index-DWsnGZlx.d.mts +831 -0
  13. package/dist/{core/cli/index.d.mts → index-DXROeDPC.d.mts} +116 -57
  14. package/dist/index-DndPmT8J.d.mts +275 -0
  15. package/dist/{core/json-schema/index.d.mts → index-DyoaS234.d.mts} +43 -34
  16. package/dist/index.d.mts +190 -41
  17. package/dist/index.mjs +1 -26
  18. package/dist/json-schema-C9SzZ7jY.mjs +52 -0
  19. package/dist/json-schema.d.mts +2 -0
  20. package/dist/json-schema.mjs +1 -0
  21. package/dist/package-json-BgE9YjjQ.mjs +3 -0
  22. package/dist/prompt.d.mts +48 -0
  23. package/dist/prompt.mjs +1 -0
  24. package/dist/rolldown-runtime-G4Kt5YOX.mjs +1 -0
  25. package/dist/runtime.d.mts +2 -6
  26. package/dist/runtime.mjs +1 -6
  27. package/dist/terminal-C8KTXjv5.mjs +6 -0
  28. package/dist/test-prompter-v__jT2yG.mjs +1 -0
  29. package/dist/testkit.d.mts +54 -6
  30. package/dist/testkit.mjs +1 -5
  31. package/dist/version.mjs +1 -7
  32. package/dreamcli.schema.json +697 -538
  33. package/package.json +29 -7
  34. package/skills/cli-creation/SKILL.md +16 -11
  35. package/CHANGELOG.md +0 -1116
  36. package/dist/core/cli/builtins.d.mts +0 -117
  37. package/dist/core/cli/builtins.mjs +0 -135
  38. package/dist/core/cli/compiled.d.mts +0 -66
  39. package/dist/core/cli/compiled.mjs +0 -76
  40. package/dist/core/cli/dispatch.d.mts +0 -115
  41. package/dist/core/cli/dispatch.mjs +0 -205
  42. package/dist/core/cli/help-links.d.mts +0 -27
  43. package/dist/core/cli/help-links.mjs +0 -41
  44. package/dist/core/cli/index.mjs +0 -1271
  45. package/dist/core/cli/planner.d.mts +0 -174
  46. package/dist/core/cli/planner.mjs +0 -323
  47. package/dist/core/cli/plugin.d.mts +0 -94
  48. package/dist/core/cli/plugin.mjs +0 -41
  49. package/dist/core/cli/propagate.d.mts +0 -39
  50. package/dist/core/cli/propagate.mjs +0 -57
  51. package/dist/core/cli/reserved-flags.d.mts +0 -19
  52. package/dist/core/cli/reserved-flags.mjs +0 -158
  53. package/dist/core/cli/root-help.d.mts +0 -53
  54. package/dist/core/cli/root-help.mjs +0 -221
  55. package/dist/core/cli/root-output-flags.d.mts +0 -74
  56. package/dist/core/cli/root-output-flags.mjs +0 -169
  57. package/dist/core/cli/root-surface.d.mts +0 -64
  58. package/dist/core/cli/root-surface.mjs +0 -28
  59. package/dist/core/cli/runtime-preflight.d.mts +0 -213
  60. package/dist/core/cli/runtime-preflight.mjs +0 -221
  61. package/dist/core/completion/index.d.mts +0 -76
  62. package/dist/core/completion/index.mjs +0 -90
  63. package/dist/core/completion/shells/bash.d.mts +0 -23
  64. package/dist/core/completion/shells/bash.mjs +0 -312
  65. package/dist/core/completion/shells/fish.d.mts +0 -19
  66. package/dist/core/completion/shells/fish.mjs +0 -164
  67. package/dist/core/completion/shells/powershell.d.mts +0 -13
  68. package/dist/core/completion/shells/powershell.mjs +0 -360
  69. package/dist/core/completion/shells/shared.d.mts +0 -164
  70. package/dist/core/completion/shells/shared.mjs +0 -147
  71. package/dist/core/completion/shells/zsh.d.mts +0 -23
  72. package/dist/core/completion/shells/zsh.mjs +0 -256
  73. package/dist/core/config/index.d.mts +0 -191
  74. package/dist/core/config/index.mjs +0 -285
  75. package/dist/core/config/package-json.d.mts +0 -179
  76. package/dist/core/config/package-json.mjs +0 -353
  77. package/dist/core/errors/index.d.mts +0 -125
  78. package/dist/core/errors/index.mjs +0 -87
  79. package/dist/core/execution/index.d.mts +0 -61
  80. package/dist/core/execution/index.mjs +0 -220
  81. package/dist/core/help/ansi.d.mts +0 -84
  82. package/dist/core/help/ansi.mjs +0 -121
  83. package/dist/core/help/index.d.mts +0 -149
  84. package/dist/core/help/index.mjs +0 -418
  85. package/dist/core/help/theme.d.mts +0 -86
  86. package/dist/core/help/theme.mjs +0 -69
  87. package/dist/core/json-schema/index.mjs +0 -1008
  88. package/dist/core/json-schema/meta-descriptions.generated.d.mts +0 -274
  89. package/dist/core/json-schema/meta-descriptions.generated.mjs +0 -136
  90. package/dist/core/output/activity.d.mts +0 -193
  91. package/dist/core/output/activity.mjs +0 -452
  92. package/dist/core/output/bind.d.mts +0 -37
  93. package/dist/core/output/bind.mjs +0 -56
  94. package/dist/core/output/contracts.d.mts +0 -82
  95. package/dist/core/output/contracts.mjs +0 -57
  96. package/dist/core/output/display-value.d.mts +0 -19
  97. package/dist/core/output/display-value.mjs +0 -32
  98. package/dist/core/output/index.d.mts +0 -344
  99. package/dist/core/output/index.mjs +0 -514
  100. package/dist/core/output/renderers.d.mts +0 -45
  101. package/dist/core/output/renderers.mjs +0 -46
  102. package/dist/core/output/writer.d.mts +0 -39
  103. package/dist/core/output/writer.mjs +0 -12
  104. package/dist/core/parse/index.d.mts +0 -178
  105. package/dist/core/parse/index.mjs +0 -850
  106. package/dist/core/parse/occurrences.d.mts +0 -90
  107. package/dist/core/parse/occurrences.mjs +0 -114
  108. package/dist/core/prompt/index.d.mts +0 -213
  109. package/dist/core/prompt/index.mjs +0 -348
  110. package/dist/core/read-flags/index.d.mts +0 -150
  111. package/dist/core/read-flags/index.mjs +0 -217
  112. package/dist/core/resolve/args.d.mts +0 -39
  113. package/dist/core/resolve/args.mjs +0 -182
  114. package/dist/core/resolve/coerce.d.mts +0 -79
  115. package/dist/core/resolve/coerce.mjs +0 -900
  116. package/dist/core/resolve/config.d.mts +0 -10
  117. package/dist/core/resolve/config.mjs +0 -19
  118. package/dist/core/resolve/contracts.d.mts +0 -146
  119. package/dist/core/resolve/errors.d.mts +0 -10
  120. package/dist/core/resolve/errors.mjs +0 -148
  121. package/dist/core/resolve/flags.d.mts +0 -74
  122. package/dist/core/resolve/flags.mjs +0 -246
  123. package/dist/core/resolve/index.d.mts +0 -44
  124. package/dist/core/resolve/index.mjs +0 -123
  125. package/dist/core/resolve/path-checks.d.mts +0 -48
  126. package/dist/core/resolve/path-checks.mjs +0 -102
  127. package/dist/core/resolve/redaction.d.mts +0 -13
  128. package/dist/core/resolve/redaction.mjs +0 -14
  129. package/dist/core/resolve/stages.d.mts +0 -86
  130. package/dist/core/resolve/stages.mjs +0 -170
  131. package/dist/core/resolve/standard.d.mts +0 -26
  132. package/dist/core/resolve/standard.mjs +0 -212
  133. package/dist/core/schema/activity.d.mts +0 -189
  134. package/dist/core/schema/arg.d.mts +0 -1461
  135. package/dist/core/schema/arg.mjs +0 -1139
  136. package/dist/core/schema/brand.d.mts +0 -17
  137. package/dist/core/schema/cardinality.d.mts +0 -302
  138. package/dist/core/schema/cardinality.mjs +0 -514
  139. package/dist/core/schema/command.d.mts +0 -1132
  140. package/dist/core/schema/command.mjs +0 -999
  141. package/dist/core/schema/flag.d.mts +0 -1495
  142. package/dist/core/schema/flag.mjs +0 -1207
  143. package/dist/core/schema/index.d.mts +0 -15
  144. package/dist/core/schema/index.mjs +0 -10
  145. package/dist/core/schema/middleware.d.mts +0 -129
  146. package/dist/core/schema/middleware.mjs +0 -41
  147. package/dist/core/schema/number-constraints.d.mts +0 -96
  148. package/dist/core/schema/number-constraints.mjs +0 -60
  149. package/dist/core/schema/prompt.d.mts +0 -135
  150. package/dist/core/schema/provenance.d.mts +0 -99
  151. package/dist/core/schema/provenance.mjs +0 -28
  152. package/dist/core/schema/run.d.mts +0 -211
  153. package/dist/core/schema/source.d.mts +0 -180
  154. package/dist/core/schema/source.mjs +0 -206
  155. package/dist/core/schema/standard.d.mts +0 -100
  156. package/dist/core/schema/standard.mjs +0 -15
  157. package/dist/core/schema/stdin.d.mts +0 -97
  158. package/dist/core/schema/stdin.mjs +0 -91
  159. package/dist/core/schema/string-constraints.d.mts +0 -108
  160. package/dist/core/schema/string-constraints.mjs +0 -86
  161. package/dist/core/schema/value-parsers.d.mts +0 -150
  162. package/dist/core/schema/value-parsers.mjs +0 -160
  163. package/dist/core/schema/value.d.mts +0 -243
  164. package/dist/core/schema/value.mjs +0 -573
  165. package/dist/core/testkit/index.d.mts +0 -63
  166. package/dist/core/testkit/index.mjs +0 -102
  167. package/dist/runtime/adapter.mjs +0 -92
  168. package/dist/runtime/auto.d.mts +0 -25
  169. package/dist/runtime/auto.mjs +0 -45
  170. package/dist/runtime/deno.d.mts +0 -99
  171. package/dist/runtime/deno.mjs +0 -265
  172. package/dist/runtime/detect.d.mts +0 -86
  173. package/dist/runtime/detect.mjs +0 -45
  174. package/dist/runtime/index.d.mts +0 -6
  175. package/dist/runtime/node.d.mts +0 -71
  176. package/dist/runtime/node.mjs +0 -228
  177. package/dist/runtime/paths.d.mts +0 -31
  178. package/dist/runtime/paths.mjs +0 -48
  179. package/dist/strings.d.mts +0 -27
  180. package/dist/strings.mjs +0 -22
  181. package/examples/basic.ts +0 -37
  182. package/examples/flag-types.ts +0 -79
  183. package/examples/gh/package.json +0 -45
  184. package/examples/gh/src/commands/auth.ts +0 -66
  185. package/examples/gh/src/commands/issue.ts +0 -120
  186. package/examples/gh/src/commands/pr.ts +0 -125
  187. package/examples/gh/src/data/issues.yaml +0 -5
  188. package/examples/gh/src/data/issues.yaml.d.ts +0 -17
  189. package/examples/gh/src/data/pull-requests.yaml +0 -7
  190. package/examples/gh/src/data/pull-requests.yaml.d.ts +0 -18
  191. package/examples/gh/src/docs.ts +0 -11
  192. package/examples/gh/src/lib/auth.ts +0 -37
  193. package/examples/gh/src/lib/utils.ts +0 -17
  194. package/examples/gh/src/main.test.ts +0 -307
  195. package/examples/gh/src/main.ts +0 -46
  196. package/examples/help-config.ts +0 -43
  197. package/examples/interactive.ts +0 -67
  198. package/examples/json-mode.ts +0 -95
  199. package/examples/middleware.ts +0 -71
  200. package/examples/multi-command.ts +0 -66
  201. package/examples/output-extras.ts +0 -46
  202. package/examples/parser-control.ts +0 -40
  203. package/examples/pwsh-demo/README.md +0 -40
  204. package/examples/pwsh-demo/package.json +0 -41
  205. package/examples/pwsh-demo/pwsh-demo.cmd +0 -3
  206. package/examples/pwsh-demo/smoke-powershell.ps1 +0 -218
  207. package/examples/pwsh-demo/src/main.test.ts +0 -45
  208. package/examples/pwsh-demo/src/main.ts +0 -140
  209. package/examples/spinner-progress.ts +0 -49
  210. package/examples/standard-schema.ts +0 -45
  211. package/examples/testing.ts +0 -147
  212. package/examples/transport-launcher.ts +0 -85
@@ -1,452 +0,0 @@
1
- import { bindMethods } from "./bind.mjs";
2
- import { writeLine } from "./writer.mjs";
3
- //#region src/core/output/activity.ts
4
- /**
5
- * Noop spinner handle singleton.
6
- *
7
- * All methods are no-ops. Used when spinners should produce no output
8
- * at all — `jsonMode`, or non-TTY with `fallback: 'silent'` (default).
9
- *
10
- * @internal
11
- */
12
- const noopSpinnerHandle = {
13
- update() {},
14
- succeed() {},
15
- fail() {},
16
- stop() {},
17
- wrap(promise) {
18
- return promise;
19
- }
20
- };
21
- /**
22
- * Noop progress handle singleton.
23
- *
24
- * All methods are no-ops. Used when progress bars should produce no
25
- * output at all — `jsonMode`, or non-TTY with `fallback: 'silent'`.
26
- *
27
- * @internal
28
- */
29
- const noopProgressHandle = {
30
- increment() {},
31
- update() {},
32
- done() {},
33
- fail() {}
34
- };
35
- /**
36
- * Static spinner handle — emits plain text at lifecycle boundaries.
37
- *
38
- * Used in non-TTY environments with `fallback: 'static'`. No animation,
39
- * no ANSI codes. Emits text on start and terminal events only.
40
- *
41
- * Terminal methods are idempotent — calling after stop is a no-op.
42
- *
43
- * @internal
44
- */
45
- var StaticSpinnerHandle = class {
46
- write;
47
- /** Whether the handle has been stopped (terminal state reached). */
48
- stopped = false;
49
- constructor(text, write) {
50
- this.write = write;
51
- writeLine(write, text);
52
- bindMethods(this);
53
- }
54
- update(_text) {}
55
- succeed(text) {
56
- if (this.stopped) return;
57
- this.stopped = true;
58
- if (text !== void 0) writeLine(this.write, text);
59
- }
60
- fail(text) {
61
- if (this.stopped) return;
62
- this.stopped = true;
63
- if (text !== void 0) writeLine(this.write, text);
64
- }
65
- stop() {
66
- if (this.stopped) return;
67
- this.stopped = true;
68
- }
69
- async wrap(promise, options) {
70
- try {
71
- const value = await promise;
72
- this.succeed(options?.succeed);
73
- return value;
74
- } catch (error) {
75
- this.fail(options?.fail);
76
- throw error;
77
- }
78
- }
79
- };
80
- /**
81
- * Static progress handle — emits plain text at lifecycle boundaries.
82
- *
83
- * Used in non-TTY environments with `fallback: 'static'`. No animation,
84
- * no progress bar rendering. Emits label on start, text on done/fail.
85
- *
86
- * Terminal methods are idempotent — calling after stop is a no-op.
87
- *
88
- * @internal
89
- */
90
- var StaticProgressHandle = class {
91
- write;
92
- /** Whether the handle has been stopped (terminal state reached). */
93
- stopped = false;
94
- constructor(label, write) {
95
- this.write = write;
96
- if (label !== void 0) writeLine(write, label);
97
- bindMethods(this);
98
- }
99
- increment(_n) {}
100
- update(_value) {}
101
- done(text) {
102
- if (this.stopped) return;
103
- this.stopped = true;
104
- if (text !== void 0) writeLine(this.write, text);
105
- }
106
- fail(text) {
107
- if (this.stopped) return;
108
- this.stopped = true;
109
- if (text !== void 0) writeLine(this.write, text);
110
- }
111
- };
112
- /** Hide the terminal cursor. @internal */
113
- const HIDE_CURSOR = "\x1B[?25l";
114
- /** Show the terminal cursor. @internal */
115
- const SHOW_CURSOR = "\x1B[?25h";
116
- /** Erase the entire current line. @internal */
117
- const ERASE_LINE = "\x1B[2K";
118
- /**
119
- * Braille-dot spinner frames.
120
- *
121
- * Provides smooth animation across most terminal emulators. The 10-frame
122
- * sequence completes a full rotation of the braille clock pattern.
123
- *
124
- * @internal
125
- */
126
- const SPINNER_FRAMES = [
127
- "⠋",
128
- "⠙",
129
- "⠹",
130
- "⠸",
131
- "⠼",
132
- "⠴",
133
- "⠦",
134
- "⠧",
135
- "⠇",
136
- "⠏"
137
- ];
138
- /** @internal */ const SPINNER_INTERVAL_MS = 80;
139
- /** Success symbol for terminal output. @internal */
140
- const CHECK = "✓";
141
- /** Failure symbol for terminal output. @internal */
142
- const CROSS = "✗";
143
- /** Filled segment of a progress bar. @internal */
144
- const BAR_FILLED = "█";
145
- /** Empty segment of a progress bar. @internal */
146
- const BAR_EMPTY = "░";
147
- /** Width of the progress bar in characters. @internal */
148
- const BAR_WIDTH = 20;
149
- /** Pulse width for indeterminate progress (number of filled segments). @internal */
150
- const PULSE_WIDTH = 3;
151
- /** Animation interval for indeterminate progress pulse (ms). @internal */
152
- const PULSE_INTERVAL_MS = 80;
153
- /**
154
- * TTY spinner handle — animated braille frames with ANSI line overwrite.
155
- *
156
- * Used in TTY environments (non-JSON mode). Renders a spinning indicator
157
- * with configurable text, using `\r` + erase-line to overwrite in place.
158
- * Hides the cursor during animation and restores it on any terminal method.
159
- *
160
- * Terminal methods (`succeed`, `fail`, `stop`) are idempotent — calling any
161
- * of them after the handle is already stopped is a no-op.
162
- *
163
- * **Note:** If the process exits abnormally (e.g. `SIGKILL`) while a spinner
164
- * is active, the cursor may remain hidden. Use {@link SpinnerHandle.wrap} to
165
- * ensure cleanup on both success and failure paths.
166
- *
167
- * @internal
168
- */
169
- var TTYSpinnerHandle = class {
170
- write;
171
- /** Whether the handle has been stopped (terminal state reached). */
172
- stopped = false;
173
- /** Animation timer handle — cleared on any terminal method. */
174
- timer;
175
- /** Current position in the braille frame sequence. */
176
- frameIndex = 0;
177
- /** Current spinner text (mutable via `update()`). */
178
- text;
179
- constructor(text, write) {
180
- this.write = write;
181
- this.text = text;
182
- write(HIDE_CURSOR);
183
- this.render();
184
- this.timer = setInterval(() => {
185
- this.frameIndex = (this.frameIndex + 1) % SPINNER_FRAMES.length;
186
- this.render();
187
- }, SPINNER_INTERVAL_MS);
188
- bindMethods(this);
189
- }
190
- /** Render the current frame + text, overwriting the current line. */
191
- render() {
192
- const frame = SPINNER_FRAMES[this.frameIndex] ?? SPINNER_FRAMES[0];
193
- this.write(`\r${ERASE_LINE}${frame} ${this.text}`);
194
- }
195
- /** Clear the animation timer, erase the line, and restore the cursor. */
196
- cleanup() {
197
- if (this.timer !== void 0) {
198
- clearInterval(this.timer);
199
- this.timer = void 0;
200
- }
201
- this.write(`\r${ERASE_LINE}${SHOW_CURSOR}`);
202
- }
203
- update(text) {
204
- if (this.stopped) return;
205
- this.text = text;
206
- this.render();
207
- }
208
- succeed(text) {
209
- if (this.stopped) return;
210
- this.stopped = true;
211
- this.cleanup();
212
- if (text !== void 0) writeLine(this.write, `${CHECK} ${text}`);
213
- }
214
- fail(text) {
215
- if (this.stopped) return;
216
- this.stopped = true;
217
- this.cleanup();
218
- if (text !== void 0) writeLine(this.write, `${CROSS} ${text}`);
219
- }
220
- stop() {
221
- if (this.stopped) return;
222
- this.stopped = true;
223
- this.cleanup();
224
- }
225
- async wrap(promise, options) {
226
- try {
227
- const value = await promise;
228
- this.succeed(options?.succeed);
229
- return value;
230
- } catch (error) {
231
- this.fail(options?.fail);
232
- throw error;
233
- }
234
- }
235
- };
236
- /**
237
- * TTY progress handle — bar rendering with ANSI line overwrite.
238
- *
239
- * Supports two modes:
240
- * - **Determinate** (`total` provided) — renders `[████░░░░░░] 40% label`,
241
- * re-rendered on each `increment()` / `update()` call. No timer.
242
- * - **Indeterminate** (`total` omitted) — renders a pulsing highlight that
243
- * bounces across the bar via `setInterval`.
244
- *
245
- * Terminal methods (`done`, `fail`) are idempotent — calling any of them
246
- * after the handle is already stopped is a no-op.
247
- *
248
- * @internal
249
- */
250
- var TTYProgressHandle = class {
251
- write;
252
- /** Whether the handle has been stopped (terminal state reached). */
253
- stopped = false;
254
- /** Animation timer for indeterminate mode — `undefined` in determinate mode. */
255
- timer;
256
- /** Current progress value (units completed). */
257
- current = 0;
258
- /** Total units of work (`undefined` = indeterminate mode). */
259
- total;
260
- /** Label displayed alongside the bar. */
261
- label;
262
- /** Pulse position for indeterminate animation (bouncing highlight). */
263
- pulsePos = 0;
264
- /** Pulse direction: 1 = forward, -1 = backward (for bounce). */
265
- pulseDir = 1;
266
- constructor(opts, write) {
267
- this.write = write;
268
- this.total = opts.total;
269
- this.label = opts.label ?? "";
270
- write(HIDE_CURSOR);
271
- this.render();
272
- if (this.total === void 0) this.timer = setInterval(() => {
273
- this.advancePulse();
274
- this.render();
275
- }, PULSE_INTERVAL_MS);
276
- bindMethods(this);
277
- }
278
- /** Advance the indeterminate pulse position with bounce logic. */
279
- advancePulse() {
280
- this.pulsePos += this.pulseDir;
281
- if (this.pulsePos + PULSE_WIDTH > BAR_WIDTH) {
282
- this.pulseDir = -1;
283
- this.pulsePos = 17;
284
- } else if (this.pulsePos < 0) {
285
- this.pulseDir = 1;
286
- this.pulsePos = 0;
287
- }
288
- }
289
- /** Render the progress bar, overwriting the current line. */
290
- render() {
291
- const bar = this.total !== void 0 ? this.renderDeterminate(this.total) : this.renderIndeterminate();
292
- const suffix = this.label.length > 0 ? ` ${this.label}` : "";
293
- this.write(`\r${ERASE_LINE}${bar}${suffix}`);
294
- }
295
- /** Render a determinate bar: `[████░░░░░░] 40%`. */
296
- renderDeterminate(total) {
297
- const ratio = total > 0 ? Math.max(0, Math.min(this.current / total, 1)) : 0;
298
- const filled = Math.round(ratio * BAR_WIDTH);
299
- const empty = BAR_WIDTH - filled;
300
- const pct = Math.round(ratio * 100);
301
- return `[${BAR_FILLED.repeat(filled)}${BAR_EMPTY.repeat(empty)}] ${String(pct)}%`;
302
- }
303
- /** Render an indeterminate bar: pulsing highlight bouncing across empty segments. */
304
- renderIndeterminate() {
305
- let bar = "";
306
- for (let i = 0; i < BAR_WIDTH; i++) bar += i >= this.pulsePos && i < this.pulsePos + PULSE_WIDTH ? BAR_FILLED : BAR_EMPTY;
307
- return `[${bar}]`;
308
- }
309
- /** Clear the animation timer, erase the line, and restore the cursor. */
310
- cleanup() {
311
- if (this.timer !== void 0) {
312
- clearInterval(this.timer);
313
- this.timer = void 0;
314
- }
315
- this.write(`\r${ERASE_LINE}${SHOW_CURSOR}`);
316
- }
317
- increment(n) {
318
- if (this.stopped) return;
319
- this.current += n ?? 1;
320
- this.render();
321
- }
322
- update(value) {
323
- if (this.stopped) return;
324
- this.current = value;
325
- this.render();
326
- }
327
- done(text) {
328
- if (this.stopped) return;
329
- this.stopped = true;
330
- this.cleanup();
331
- if (text !== void 0) writeLine(this.write, `${CHECK} ${text}`);
332
- }
333
- fail(text) {
334
- if (this.stopped) return;
335
- this.stopped = true;
336
- this.cleanup();
337
- if (text !== void 0) writeLine(this.write, `${CROSS} ${text}`);
338
- }
339
- };
340
- /**
341
- * Spinner handle that records lifecycle events to a shared `ActivityEvent[]`.
342
- *
343
- * Used by `createCaptureOutput()` so testkit can assert on spinner behaviour
344
- * without polluting stdout/stderr arrays. Terminal methods are idempotent.
345
- *
346
- * @internal
347
- */
348
- var CaptureSpinnerHandle = class {
349
- events;
350
- /** Whether the handle has been stopped (terminal state reached). */
351
- stopped = false;
352
- constructor(text, events) {
353
- this.events = events;
354
- events.push({
355
- type: "spinner:start",
356
- text
357
- });
358
- bindMethods(this);
359
- }
360
- update(text) {
361
- if (this.stopped) return;
362
- this.events.push({
363
- type: "spinner:update",
364
- text
365
- });
366
- }
367
- succeed(text) {
368
- if (this.stopped) return;
369
- this.stopped = true;
370
- this.events.push({
371
- type: "spinner:succeed",
372
- text: text ?? ""
373
- });
374
- }
375
- fail(text) {
376
- if (this.stopped) return;
377
- this.stopped = true;
378
- this.events.push({
379
- type: "spinner:fail",
380
- text: text ?? ""
381
- });
382
- }
383
- stop() {
384
- if (this.stopped) return;
385
- this.stopped = true;
386
- this.events.push({ type: "spinner:stop" });
387
- }
388
- async wrap(promise, options) {
389
- try {
390
- const value = await promise;
391
- this.succeed(options?.succeed);
392
- return value;
393
- } catch (error) {
394
- this.fail(options?.fail);
395
- throw error;
396
- }
397
- }
398
- };
399
- /**
400
- * Progress handle that records lifecycle events to a shared `ActivityEvent[]`.
401
- *
402
- * Used by `createCaptureOutput()` so testkit can assert on progress behaviour
403
- * without polluting stdout/stderr arrays. Terminal methods are idempotent.
404
- *
405
- * @internal
406
- */
407
- var CaptureProgressHandle = class {
408
- events;
409
- /** Whether the handle has been stopped (terminal state reached). */
410
- stopped = false;
411
- constructor(opts, events) {
412
- this.events = events;
413
- events.push({
414
- type: "progress:start",
415
- label: opts.label ?? "",
416
- total: opts.total
417
- });
418
- bindMethods(this);
419
- }
420
- increment(n) {
421
- if (this.stopped) return;
422
- this.events.push({
423
- type: "progress:increment",
424
- delta: n ?? 1
425
- });
426
- }
427
- update(value) {
428
- if (this.stopped) return;
429
- this.events.push({
430
- type: "progress:update",
431
- value
432
- });
433
- }
434
- done(text) {
435
- if (this.stopped) return;
436
- this.stopped = true;
437
- this.events.push({
438
- type: "progress:done",
439
- text
440
- });
441
- }
442
- fail(text) {
443
- if (this.stopped) return;
444
- this.stopped = true;
445
- this.events.push({
446
- type: "progress:fail",
447
- text
448
- });
449
- }
450
- };
451
- //#endregion
452
- export { CaptureProgressHandle, CaptureSpinnerHandle, StaticProgressHandle, StaticSpinnerHandle, TTYProgressHandle, TTYSpinnerHandle, noopProgressHandle, noopSpinnerHandle };
@@ -1,37 +0,0 @@
1
- //#region src/core/output/bind.d.ts
2
- /**
3
- * Method-binding helper for value objects handed to consumers.
4
- *
5
- * Output value objects — the `Out` channel and the spinner/progress handles
6
- * — expose methods that read instance state via `this`. Consumers naturally
7
- * detach those methods, either by destructuring
8
- * (`const { log } = out` / `const { succeed, fail } = spinner`) or by passing
9
- * them as callbacks (`promise.finally(spinner.stop)`). Detached, an unbound
10
- * prototype method loses its `this` and crashes on the first field access.
11
- *
12
- * {@linkcode bindMethods} eliminates that footgun by installing instance-bound
13
- * copies of every method, so the ergonomic usage is also the correct one.
14
- *
15
- * @module dreamcli/core/output/bind
16
- * @internal
17
- */
18
- /**
19
- * Bind every method on an instance's prototype chain to the instance.
20
- *
21
- * Walks the prototype chain up to (but excluding) `Object.prototype`, binding
22
- * each method name exactly once — the most-derived definition wins, so subclass
23
- * overrides (e.g. `CaptureOutputChannel.spinner`) are preserved rather than
24
- * clobbered by a base-class version. Bound methods are installed as
25
- * non-enumerable own properties, mirroring the enumerability of the prototype
26
- * methods they shadow. Getters and non-function members are left untouched.
27
- *
28
- * Call this once, last, in a class constructor. Because it reads the live
29
- * prototype rather than a hand-maintained name list, methods added later are
30
- * bound automatically — the binding can't silently fall out of date.
31
- *
32
- * @param instance - The object whose methods should be bound to it.
33
- * @internal
34
- */
35
- declare function bindMethods(instance: object): void;
36
- //#endregion
37
- export { bindMethods };
@@ -1,56 +0,0 @@
1
- //#region src/core/output/bind.ts
2
- /**
3
- * Method-binding helper for value objects handed to consumers.
4
- *
5
- * Output value objects — the `Out` channel and the spinner/progress handles
6
- * — expose methods that read instance state via `this`. Consumers naturally
7
- * detach those methods, either by destructuring
8
- * (`const { log } = out` / `const { succeed, fail } = spinner`) or by passing
9
- * them as callbacks (`promise.finally(spinner.stop)`). Detached, an unbound
10
- * prototype method loses its `this` and crashes on the first field access.
11
- *
12
- * {@linkcode bindMethods} eliminates that footgun by installing instance-bound
13
- * copies of every method, so the ergonomic usage is also the correct one.
14
- *
15
- * @module dreamcli/core/output/bind
16
- * @internal
17
- */
18
- /**
19
- * Bind every method on an instance's prototype chain to the instance.
20
- *
21
- * Walks the prototype chain up to (but excluding) `Object.prototype`, binding
22
- * each method name exactly once — the most-derived definition wins, so subclass
23
- * overrides (e.g. `CaptureOutputChannel.spinner`) are preserved rather than
24
- * clobbered by a base-class version. Bound methods are installed as
25
- * non-enumerable own properties, mirroring the enumerability of the prototype
26
- * methods they shadow. Getters and non-function members are left untouched.
27
- *
28
- * Call this once, last, in a class constructor. Because it reads the live
29
- * prototype rather than a hand-maintained name list, methods added later are
30
- * bound automatically — the binding can't silently fall out of date.
31
- *
32
- * @param instance - The object whose methods should be bound to it.
33
- * @internal
34
- */
35
- function bindMethods(instance) {
36
- const bound = instance;
37
- const seen = /* @__PURE__ */ new Set();
38
- let proto = Object.getPrototypeOf(instance);
39
- while (proto !== null && proto !== Object.prototype) {
40
- for (const name of Object.getOwnPropertyNames(proto)) {
41
- if (name === "constructor" || seen.has(name)) continue;
42
- seen.add(name);
43
- const descriptor = Object.getOwnPropertyDescriptor(proto, name);
44
- if (descriptor === void 0 || typeof descriptor.value !== "function") continue;
45
- Object.defineProperty(bound, name, {
46
- value: descriptor.value.bind(instance),
47
- writable: true,
48
- enumerable: false,
49
- configurable: true
50
- });
51
- }
52
- proto = Object.getPrototypeOf(proto);
53
- }
54
- }
55
- //#endregion
56
- export { bindMethods };
@@ -1,82 +0,0 @@
1
- import { Fallback, TableOptions } from "../schema/activity.mjs";
2
- //#region src/core/output/contracts.d.ts
3
- /** Ordered output verbosity levels owned by the output policy layer. */
4
- declare const OUTPUT_VERBOSITY_LEVELS: readonly ["normal", "quiet"];
5
- /** Stable output text streams. */
6
- declare const OUTPUT_STREAMS: readonly ["stdout", "stderr"];
7
- /** Stable activity rendering modes. */
8
- declare const ACTIVITY_RENDER_MODES: readonly ["noop", "static", "tty", "capture"];
9
- /** Stable activity cleanup actions. */
10
- declare const ACTIVITY_CLEANUP_KINDS: readonly ["none", "stop", "done"];
11
- /** Stable text verbosity labels. */
12
- type Verbosity = (typeof OUTPUT_VERBOSITY_LEVELS)[number];
13
- /** Stable output stream labels. */
14
- type OutputStream = (typeof OUTPUT_STREAMS)[number];
15
- /** Stable activity-render labels. */
16
- type ActivityRenderMode = (typeof ACTIVITY_RENDER_MODES)[number];
17
- /** Stable cleanup labels for tracked activity handles. */
18
- type ActivityCleanupKind = (typeof ACTIVITY_CLEANUP_KINDS)[number];
19
- /** Semantic output facts chosen before concrete rendering begins. */
20
- interface OutputPolicy {
21
- /** Whether `--json` was requested, routing structured data to stdout. */
22
- readonly jsonMode: boolean;
23
- /** Whether the output stream is connected to an interactive terminal. */
24
- readonly isTTY: boolean;
25
- /** Active verbosity level controlling which message categories emit. */
26
- readonly verbosity: Verbosity;
27
- }
28
- /** Inputs for building an {@linkcode OutputPolicy} snapshot. */
29
- interface ResolveOutputPolicyOptions {
30
- /** Whether `--json` was requested on the command line. */
31
- readonly jsonMode: boolean;
32
- /** Whether the output stream is connected to an interactive terminal. */
33
- readonly isTTY: boolean;
34
- /** Verbosity level to apply for this channel instance. */
35
- readonly verbosity: Verbosity;
36
- }
37
- /** Concrete activity policy chosen for spinner/progress creation. */
38
- interface ActivityPolicy {
39
- /** Render strategy for the activity indicator (never `'capture'` here). */
40
- readonly mode: Exclude<ActivityRenderMode, 'capture'>;
41
- /** Activity output always targets stderr to avoid polluting structured stdout. */
42
- readonly stream: 'stderr';
43
- /** Cleanup action the output layer must run when the handle is discarded. */
44
- readonly cleanup: ActivityCleanupKind;
45
- }
46
- /** Stable output-policy facts the re-foundation workstream is freezing. */
47
- interface OutputContract {
48
- /** In JSON mode, stdout carries only machine-readable structured output. */
49
- readonly jsonReservesStdoutForStructuredData: true;
50
- /** Quiet verbosity suppresses `info()` messages entirely. */
51
- readonly quietSuppressesInfo: true;
52
- /** Quiet verbosity suppresses rendered spinner/progress output; capture still records lifecycle events. */
53
- readonly quietSuppressesRenderedActivity: true;
54
- /** Spinner/progress writes go to stderr so stdout stays parseable. */
55
- readonly activityUsesStderrOutsideCapture: true;
56
- /** Animated TTY spinners require both a real terminal and non-JSON mode. */
57
- readonly ttyActivityRequiresTTYAndNonJson: true;
58
- /** Spinner handles clean up via `stop()` to clear the animation line. */
59
- readonly spinnerCleanupUsesStop: true;
60
- /** Progress handles clean up via `done()` to render the final state. */
61
- readonly progressCleanupUsesDone: true;
62
- }
63
- /** Runtime-accessible copy of the frozen output-policy invariants. */
64
- declare const outputContract: OutputContract;
65
- /** Build the stable output-policy snapshot for one channel instance. */
66
- declare function resolveOutputPolicy(options: ResolveOutputPolicyOptions): OutputPolicy;
67
- /** Resolve the default text stream for non-JSON structured output. */
68
- declare function resolveTextStream(policy: OutputPolicy): OutputStream;
69
- /** Whether `info()`/`status()` messages should be emitted under the current policy. */
70
- declare function shouldEmitInfo(policy: OutputPolicy): boolean;
71
- /** Resolve the concrete table format under the current policy. */
72
- declare function resolveTableFormat(policy: OutputPolicy, options?: TableOptions): 'text' | 'json';
73
- /** Resolve the text-table stream after table-format selection. */
74
- declare function resolveTableTextStream(policy: OutputPolicy, options?: TableOptions): OutputStream;
75
- /** Resolve the non-capture activity mode shared by spinner and progress. */
76
- declare function resolveActivityRenderMode(policy: OutputPolicy, fallback: Fallback): ActivityPolicy['mode'];
77
- /** Resolve spinner activity policy including cleanup ownership. */
78
- declare function resolveSpinnerPolicy(policy: OutputPolicy, fallback: Fallback): ActivityPolicy;
79
- /** Resolve progress activity policy including cleanup ownership. */
80
- declare function resolveProgressPolicy(policy: OutputPolicy, fallback: Fallback): ActivityPolicy;
81
- //#endregion
82
- export { ACTIVITY_CLEANUP_KINDS, ACTIVITY_RENDER_MODES, type ActivityCleanupKind, type ActivityPolicy, type ActivityRenderMode, OUTPUT_STREAMS, OUTPUT_VERBOSITY_LEVELS, type OutputContract, type OutputPolicy, type OutputStream, type ResolveOutputPolicyOptions, type Verbosity, outputContract, resolveActivityRenderMode, resolveOutputPolicy, resolveProgressPolicy, resolveSpinnerPolicy, resolveTableFormat, resolveTableTextStream, resolveTextStream, shouldEmitInfo };
@@ -1,57 +0,0 @@
1
- //#region src/core/output/contracts.ts
2
- /** Build the stable output-policy snapshot for one channel instance. */
3
- function resolveOutputPolicy(options) {
4
- return {
5
- jsonMode: options.jsonMode,
6
- isTTY: options.isTTY,
7
- verbosity: options.verbosity
8
- };
9
- }
10
- /** Resolve the default text stream for non-JSON structured output. */
11
- function resolveTextStream(policy) {
12
- return policy.jsonMode ? "stderr" : "stdout";
13
- }
14
- /** Whether `info()`/`status()` messages should be emitted under the current policy. */
15
- function shouldEmitInfo(policy) {
16
- return policy.verbosity !== "quiet";
17
- }
18
- /** Resolve the concrete table format under the current policy. */
19
- function resolveTableFormat(policy, options) {
20
- switch (options?.format) {
21
- case "json": return "json";
22
- case "text": return "text";
23
- case "auto":
24
- case void 0: return policy.jsonMode ? "json" : "text";
25
- }
26
- }
27
- /** Resolve the text-table stream after table-format selection. */
28
- function resolveTableTextStream(policy, options) {
29
- if (options?.format === "text" && "stream" in options && options.stream !== void 0) return options.stream;
30
- return resolveTextStream(policy);
31
- }
32
- /** Resolve the non-capture activity mode shared by spinner and progress. */
33
- function resolveActivityRenderMode(policy, fallback) {
34
- if (policy.jsonMode || policy.verbosity === "quiet") return "noop";
35
- if (policy.isTTY) return "tty";
36
- return fallback === "static" ? "static" : "noop";
37
- }
38
- /** Resolve spinner activity policy including cleanup ownership. */
39
- function resolveSpinnerPolicy(policy, fallback) {
40
- const mode = resolveActivityRenderMode(policy, fallback);
41
- return {
42
- mode,
43
- stream: "stderr",
44
- cleanup: mode === "noop" ? "none" : "stop"
45
- };
46
- }
47
- /** Resolve progress activity policy including cleanup ownership. */
48
- function resolveProgressPolicy(policy, fallback) {
49
- const mode = resolveActivityRenderMode(policy, fallback);
50
- return {
51
- mode,
52
- stream: "stderr",
53
- cleanup: mode === "noop" ? "none" : "done"
54
- };
55
- }
56
- //#endregion
57
- export { resolveActivityRenderMode, resolveOutputPolicy, resolveProgressPolicy, resolveSpinnerPolicy, resolveTableFormat, resolveTableTextStream, resolveTextStream, shouldEmitInfo };