@kjanat/dreamcli 2.5.0 → 3.0.0-rc.2

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 (160) hide show
  1. package/CHANGELOG.md +153 -1
  2. package/README.md +9 -2
  3. package/dist/core/cli/dispatch.mjs +214 -1
  4. package/dist/core/cli/help-links.mjs +41 -1
  5. package/dist/core/cli/index.d.mts +109 -16
  6. package/dist/core/cli/index.mjs +901 -1
  7. package/dist/core/cli/planner.d.mts +27 -5
  8. package/dist/core/cli/planner.mjs +300 -1
  9. package/dist/core/cli/plugin.mjs +41 -1
  10. package/dist/core/cli/propagate.mjs +57 -1
  11. package/dist/core/cli/root-help.d.mts +16 -2
  12. package/dist/core/cli/root-help.mjs +208 -6
  13. package/dist/core/cli/root-surface.d.mts +18 -3
  14. package/dist/core/cli/root-surface.mjs +27 -1
  15. package/dist/core/cli/runtime-preflight.d.mts +16 -1
  16. package/dist/core/cli/runtime-preflight.mjs +168 -1
  17. package/dist/core/completion/index.d.mts +32 -1
  18. package/dist/core/completion/index.mjs +90 -1
  19. package/dist/core/completion/shells/bash.mjs +304 -3
  20. package/dist/core/completion/shells/fish.mjs +159 -2
  21. package/dist/core/completion/shells/powershell.mjs +353 -2
  22. package/dist/core/completion/shells/shared.d.mts +10 -0
  23. package/dist/core/completion/shells/shared.mjs +154 -1
  24. package/dist/core/completion/shells/zsh.mjs +244 -2
  25. package/dist/core/config/index.mjs +246 -1
  26. package/dist/core/config/package-json.mjs +385 -3
  27. package/dist/core/errors/index.mjs +87 -1
  28. package/dist/core/execution/index.mjs +189 -1
  29. package/dist/core/help/ansi.mjs +122 -2
  30. package/dist/core/help/index.d.mts +45 -1
  31. package/dist/core/help/index.mjs +329 -7
  32. package/dist/core/json-schema/index.mjs +487 -9
  33. package/dist/core/json-schema/meta-descriptions.generated.d.mts +38 -38
  34. package/dist/core/json-schema/meta-descriptions.generated.mjs +93 -28
  35. package/dist/core/output/activity.mjs +452 -1
  36. package/dist/core/output/bind.mjs +56 -1
  37. package/dist/core/output/contracts.mjs +57 -1
  38. package/dist/core/output/display-value.mjs +32 -1
  39. package/dist/core/output/index.d.mts +21 -0
  40. package/dist/core/output/index.mjs +442 -2
  41. package/dist/core/output/renderers.mjs +46 -1
  42. package/dist/core/output/writer.mjs +12 -1
  43. package/dist/core/parse/index.d.mts +15 -1
  44. package/dist/core/parse/index.mjs +555 -1
  45. package/dist/core/prompt/index.d.mts +11 -4
  46. package/dist/core/prompt/index.mjs +348 -6
  47. package/dist/core/resolve/args.mjs +105 -1
  48. package/dist/core/resolve/coerce.mjs +279 -1
  49. package/dist/core/resolve/config.mjs +19 -1
  50. package/dist/core/resolve/errors.mjs +140 -2
  51. package/dist/core/resolve/flags.mjs +196 -1
  52. package/dist/core/resolve/index.mjs +85 -1
  53. package/dist/core/resolve/property.d.mts +2 -1
  54. package/dist/core/resolve/property.mjs +45 -1
  55. package/dist/core/schema/arg.d.mts +90 -10
  56. package/dist/core/schema/arg.mjs +463 -1
  57. package/dist/core/schema/command.d.mts +21 -1
  58. package/dist/core/schema/command.mjs +712 -1
  59. package/dist/core/schema/flag.d.mts +92 -2
  60. package/dist/core/schema/flag.mjs +453 -1
  61. package/dist/core/schema/index.d.mts +2 -1
  62. package/dist/core/schema/middleware.mjs +41 -1
  63. package/dist/core/schema/number-constraints.d.mts +96 -0
  64. package/dist/core/schema/number-constraints.mjs +60 -0
  65. package/dist/core/schema/prompt.d.mts +15 -0
  66. package/dist/core/schema/run.d.mts +4 -4
  67. package/dist/core/schema-dsl/runtime.mjs +271 -2
  68. package/dist/core/schema-dsl/to-json-schema.mjs +74 -1
  69. package/dist/core/testkit/index.d.mts +9 -5
  70. package/dist/core/testkit/index.mjs +83 -1
  71. package/dist/index.d.mts +3 -1
  72. package/dist/index.mjs +22 -1
  73. package/dist/runtime/adapter.mjs +82 -1
  74. package/dist/runtime/auto.mjs +46 -1
  75. package/dist/runtime/bun.mjs +28 -1
  76. package/dist/runtime/deno.mjs +217 -2
  77. package/dist/runtime/detect.mjs +45 -1
  78. package/dist/runtime/node.mjs +169 -2
  79. package/dist/runtime/paths.mjs +48 -1
  80. package/dist/runtime.mjs +7 -1
  81. package/dist/strings.mjs +22 -1
  82. package/dist/testkit.mjs +5 -1
  83. package/dist/version.mjs +7 -1
  84. package/examples/basic.ts +5 -1
  85. package/examples/gh/package.json +2 -7
  86. package/examples/pwsh-demo/package.json +1 -7
  87. package/examples/pwsh-demo/src/main.test.ts +1 -4
  88. package/examples/pwsh-demo/src/main.ts +14 -4
  89. package/examples/transport-launcher.ts +85 -0
  90. package/package.json +23 -41
  91. package/dist/runtime/support.d.mts +0 -42
  92. package/dist/runtime/support.mjs +0 -1
  93. package/src/core/cli/dispatch.ts +0 -349
  94. package/src/core/cli/help-links.ts +0 -82
  95. package/src/core/cli/index.ts +0 -1413
  96. package/src/core/cli/planner.ts +0 -487
  97. package/src/core/cli/plugin.ts +0 -117
  98. package/src/core/cli/propagate.ts +0 -97
  99. package/src/core/cli/root-help.ts +0 -252
  100. package/src/core/cli/root-surface.ts +0 -74
  101. package/src/core/cli/runtime-preflight.ts +0 -438
  102. package/src/core/completion/index.ts +0 -88
  103. package/src/core/completion/shells/bash.ts +0 -459
  104. package/src/core/completion/shells/fish.ts +0 -259
  105. package/src/core/completion/shells/powershell.ts +0 -439
  106. package/src/core/completion/shells/shared.ts +0 -283
  107. package/src/core/completion/shells/zsh.ts +0 -381
  108. package/src/core/config/index.ts +0 -417
  109. package/src/core/config/package-json.ts +0 -560
  110. package/src/core/errors/index.ts +0 -193
  111. package/src/core/execution/index.ts +0 -268
  112. package/src/core/help/ansi.ts +0 -144
  113. package/src/core/help/index.ts +0 -516
  114. package/src/core/json-schema/index.ts +0 -891
  115. package/src/core/json-schema/meta-descriptions.generated.ts +0 -185
  116. package/src/core/output/activity.ts +0 -575
  117. package/src/core/output/bind.ts +0 -59
  118. package/src/core/output/contracts.ts +0 -194
  119. package/src/core/output/display-value.ts +0 -48
  120. package/src/core/output/index.ts +0 -704
  121. package/src/core/output/renderers.ts +0 -125
  122. package/src/core/output/writer.ts +0 -46
  123. package/src/core/parse/index.ts +0 -681
  124. package/src/core/prompt/index.ts +0 -583
  125. package/src/core/resolve/args.ts +0 -144
  126. package/src/core/resolve/coerce.ts +0 -432
  127. package/src/core/resolve/config.ts +0 -26
  128. package/src/core/resolve/contracts.ts +0 -135
  129. package/src/core/resolve/errors.ts +0 -227
  130. package/src/core/resolve/flags.ts +0 -255
  131. package/src/core/resolve/index.ts +0 -108
  132. package/src/core/resolve/property.ts +0 -99
  133. package/src/core/schema/activity.ts +0 -240
  134. package/src/core/schema/arg.ts +0 -719
  135. package/src/core/schema/command.ts +0 -1498
  136. package/src/core/schema/flag.ts +0 -801
  137. package/src/core/schema/index.ts +0 -91
  138. package/src/core/schema/middleware.ts +0 -171
  139. package/src/core/schema/prompt.ts +0 -156
  140. package/src/core/schema/run.ts +0 -198
  141. package/src/core/schema-dsl/index.ts +0 -109
  142. package/src/core/schema-dsl/parse.ts +0 -262
  143. package/src/core/schema-dsl/runtime.ts +0 -609
  144. package/src/core/schema-dsl/to-json-schema.ts +0 -102
  145. package/src/core/testkit/index.ts +0 -123
  146. package/src/index.ts +0 -179
  147. package/src/runtime/adapter.ts +0 -303
  148. package/src/runtime/auto.ts +0 -110
  149. package/src/runtime/bun.ts +0 -55
  150. package/src/runtime/deno.ts +0 -369
  151. package/src/runtime/detect.ts +0 -105
  152. package/src/runtime/index.ts +0 -21
  153. package/src/runtime/node-builtins.d.ts +0 -27
  154. package/src/runtime/node.ts +0 -300
  155. package/src/runtime/paths.ts +0 -64
  156. package/src/runtime/support.ts +0 -135
  157. package/src/runtime.ts +0 -31
  158. package/src/strings.ts +0 -34
  159. package/src/testkit.ts +0 -25
  160. package/src/version.ts +0 -20
@@ -1,125 +0,0 @@
1
- /**
2
- * Internal output renderer factories.
3
- *
4
- * Keeps concrete writer and activity-handle construction separate from the
5
- * semantic output-policy layer.
6
- *
7
- * @module dreamcli/core/output/renderers
8
- * @internal
9
- */
10
-
11
- import type {
12
- ProgressHandle,
13
- ProgressOptions,
14
- SpinnerHandle,
15
- } from '#internals/core/schema/activity.ts';
16
- import {
17
- noopProgressHandle,
18
- noopSpinnerHandle,
19
- StaticProgressHandle,
20
- StaticSpinnerHandle,
21
- TTYProgressHandle,
22
- TTYSpinnerHandle,
23
- } from './activity.ts';
24
- import type { ActivityPolicy, OutputStream } from './contracts.ts';
25
- import type { WriteFn } from './writer.ts';
26
-
27
- /**
28
- * Paired write functions for the two standard output streams.
29
- *
30
- * @internal
31
- */
32
- interface OutputWriters {
33
- /** Write function targeting standard output. */
34
- readonly stdout: WriteFn;
35
- /** Write function targeting standard error. */
36
- readonly stderr: WriteFn;
37
- }
38
-
39
- /**
40
- * Spinner handle paired with its optional teardown function.
41
- *
42
- * @internal
43
- */
44
- interface SpinnerRenderResult {
45
- /** The spinner handle exposed to command handlers. */
46
- readonly handle: SpinnerHandle;
47
- /** Defined only when the mode requires cleanup (TTY or static); `undefined` for noop. */
48
- readonly cleanup: (() => void) | undefined;
49
- }
50
-
51
- /**
52
- * Progress handle paired with its optional teardown function.
53
- *
54
- * @internal
55
- */
56
- interface ProgressRenderResult {
57
- /** The progress handle exposed to command handlers. */
58
- readonly handle: ProgressHandle;
59
- /** Defined only when the mode requires cleanup (TTY or static); `undefined` for noop. */
60
- readonly cleanup: (() => void) | undefined;
61
- }
62
-
63
- /** Select the concrete {@linkcode WriteFn} for a given stream label. @internal */
64
- function resolveWriterForStream(writers: OutputWriters, stream: OutputStream): WriteFn {
65
- return stream === 'stderr' ? writers.stderr : writers.stdout;
66
- }
67
-
68
- /** Create a spinner handle matching the resolved {@linkcode ActivityPolicy} mode. @internal */
69
- function createSpinnerHandleFromPolicy(
70
- policy: ActivityPolicy,
71
- text: string,
72
- stderr: WriteFn,
73
- ): SpinnerRenderResult {
74
- if (policy.mode === 'noop') {
75
- return {
76
- handle: noopSpinnerHandle,
77
- cleanup: undefined,
78
- };
79
- }
80
-
81
- if (policy.mode === 'tty') {
82
- const handle = new TTYSpinnerHandle(text, stderr);
83
- return {
84
- handle,
85
- cleanup: () => handle.stop(),
86
- };
87
- }
88
-
89
- const handle = new StaticSpinnerHandle(text, stderr);
90
- return {
91
- handle,
92
- cleanup: () => handle.stop(),
93
- };
94
- }
95
-
96
- /** Create a progress handle matching the resolved {@linkcode ActivityPolicy} mode. @internal */
97
- function createProgressHandleFromPolicy(
98
- policy: ActivityPolicy,
99
- options: ProgressOptions,
100
- stderr: WriteFn,
101
- ): ProgressRenderResult {
102
- if (policy.mode === 'noop') {
103
- return {
104
- handle: noopProgressHandle,
105
- cleanup: undefined,
106
- };
107
- }
108
-
109
- if (policy.mode === 'tty') {
110
- const handle = new TTYProgressHandle(options, stderr);
111
- return {
112
- handle,
113
- cleanup: () => handle.done(),
114
- };
115
- }
116
-
117
- const handle = new StaticProgressHandle(options.label, stderr);
118
- return {
119
- handle,
120
- cleanup: () => handle.done(),
121
- };
122
- }
123
-
124
- export type { OutputWriters, ProgressRenderResult, SpinnerRenderResult };
125
- export { createProgressHandleFromPolicy, createSpinnerHandleFromPolicy, resolveWriterForStream };
@@ -1,46 +0,0 @@
1
- /**
2
- * Minimal I/O seam — the only write primitive the output module depends on.
3
- *
4
- * Extracted to its own file so that both `index.ts` (OutputChannel) and
5
- * `activity.ts` (handle classes) can import it without a circular dependency.
6
- *
7
- * @module dreamcli/core/output/writer
8
- * @internal
9
- */
10
-
11
- // --- Writer abstraction
12
-
13
- /**
14
- * A function that writes a string somewhere.
15
- *
16
- * This is the only write primitive the output layer depends on.
17
- * In production it usually wraps `process.stdout.write` or
18
- * `process.stderr.write`; in tests it is often a simple string accumulator.
19
- *
20
- * The contract is intentionally tiny:
21
- * - writes are synchronous fire-and-forget
22
- * - callers decide whether to append a trailing newline
23
- * - there is no backpressure or flush signal
24
- *
25
- * @example
26
- * ```ts
27
- * const lines: string[] = [];
28
- * const write: WriteFn = (data) => {
29
- * lines.push(data);
30
- * };
31
- * ```
32
- */
33
- type WriteFn = (data: string) => void;
34
-
35
- /**
36
- * Write a message followed by a newline.
37
- *
38
- * @param write - The underlying write function.
39
- * @param message - The text to write.
40
- */
41
- function writeLine(write: WriteFn, message: string): void {
42
- write(`${message}\n`);
43
- }
44
-
45
- export type { WriteFn };
46
- export { writeLine };