@kjanat/dreamcli 3.0.0-rc.1 → 3.0.0-rc.3

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 (137) hide show
  1. package/CHANGELOG.md +37 -1
  2. package/dist/core/cli/dispatch.mjs +214 -1
  3. package/dist/core/cli/help-links.mjs +41 -1
  4. package/dist/core/cli/index.mjs +901 -1
  5. package/dist/core/cli/planner.mjs +300 -1
  6. package/dist/core/cli/plugin.mjs +41 -1
  7. package/dist/core/cli/propagate.mjs +57 -1
  8. package/dist/core/cli/root-help.mjs +208 -4
  9. package/dist/core/cli/root-surface.mjs +27 -1
  10. package/dist/core/cli/runtime-preflight.mjs +168 -1
  11. package/dist/core/completion/index.mjs +90 -1
  12. package/dist/core/completion/shells/bash.mjs +304 -3
  13. package/dist/core/completion/shells/fish.mjs +159 -2
  14. package/dist/core/completion/shells/powershell.mjs +353 -2
  15. package/dist/core/completion/shells/shared.mjs +154 -1
  16. package/dist/core/completion/shells/zsh.mjs +244 -2
  17. package/dist/core/config/index.mjs +246 -1
  18. package/dist/core/config/package-json.mjs +385 -3
  19. package/dist/core/errors/index.mjs +87 -1
  20. package/dist/core/execution/index.mjs +189 -1
  21. package/dist/core/help/ansi.mjs +122 -2
  22. package/dist/core/help/index.mjs +329 -7
  23. package/dist/core/json-schema/index.mjs +487 -9
  24. package/dist/core/json-schema/meta-descriptions.generated.mjs +93 -28
  25. package/dist/core/output/activity.mjs +452 -1
  26. package/dist/core/output/bind.mjs +56 -1
  27. package/dist/core/output/contracts.mjs +57 -1
  28. package/dist/core/output/display-value.mjs +32 -1
  29. package/dist/core/output/index.d.mts +21 -0
  30. package/dist/core/output/index.mjs +442 -2
  31. package/dist/core/output/renderers.mjs +46 -1
  32. package/dist/core/output/writer.mjs +12 -1
  33. package/dist/core/parse/index.mjs +555 -1
  34. package/dist/core/prompt/index.d.mts +0 -1
  35. package/dist/core/prompt/index.mjs +348 -6
  36. package/dist/core/resolve/args.mjs +105 -1
  37. package/dist/core/resolve/coerce.mjs +279 -1
  38. package/dist/core/resolve/config.mjs +19 -1
  39. package/dist/core/resolve/errors.mjs +140 -2
  40. package/dist/core/resolve/flags.mjs +196 -1
  41. package/dist/core/resolve/index.mjs +85 -1
  42. package/dist/core/resolve/property.d.mts +0 -1
  43. package/dist/core/resolve/property.mjs +45 -1
  44. package/dist/core/schema/arg.mjs +463 -1
  45. package/dist/core/schema/command.d.mts +18 -0
  46. package/dist/core/schema/command.mjs +712 -1
  47. package/dist/core/schema/flag.mjs +453 -1
  48. package/dist/core/schema/middleware.mjs +41 -1
  49. package/dist/core/schema/number-constraints.mjs +60 -1
  50. package/dist/core/schema-dsl/runtime.mjs +271 -2
  51. package/dist/core/schema-dsl/to-json-schema.mjs +74 -1
  52. package/dist/core/testkit/index.mjs +83 -1
  53. package/dist/index.d.mts +2 -1
  54. package/dist/index.mjs +22 -1
  55. package/dist/runtime/adapter.mjs +82 -1
  56. package/dist/runtime/auto.mjs +46 -1
  57. package/dist/runtime/bun.mjs +28 -1
  58. package/dist/runtime/deno.mjs +217 -2
  59. package/dist/runtime/detect.mjs +45 -1
  60. package/dist/runtime/node.mjs +169 -2
  61. package/dist/runtime/paths.mjs +48 -1
  62. package/dist/runtime.mjs +7 -1
  63. package/dist/strings.mjs +22 -1
  64. package/dist/testkit.mjs +5 -1
  65. package/dist/version.d.mts +7 -3
  66. package/dist/version.mjs +7 -1
  67. package/package.json +21 -26
  68. package/src/core/cli/dispatch.ts +0 -355
  69. package/src/core/cli/help-links.ts +0 -82
  70. package/src/core/cli/index.ts +0 -1614
  71. package/src/core/cli/planner.ts +0 -656
  72. package/src/core/cli/plugin.ts +0 -117
  73. package/src/core/cli/propagate.ts +0 -97
  74. package/src/core/cli/root-help.ts +0 -342
  75. package/src/core/cli/root-surface.ts +0 -87
  76. package/src/core/cli/runtime-preflight.ts +0 -456
  77. package/src/core/completion/index.ts +0 -138
  78. package/src/core/completion/shells/bash.ts +0 -459
  79. package/src/core/completion/shells/fish.ts +0 -259
  80. package/src/core/completion/shells/powershell.ts +0 -439
  81. package/src/core/completion/shells/shared.ts +0 -310
  82. package/src/core/completion/shells/zsh.ts +0 -381
  83. package/src/core/config/index.ts +0 -417
  84. package/src/core/config/package-json.ts +0 -560
  85. package/src/core/errors/index.ts +0 -193
  86. package/src/core/execution/index.ts +0 -265
  87. package/src/core/help/ansi.ts +0 -144
  88. package/src/core/help/index.ts +0 -563
  89. package/src/core/json-schema/index.ts +0 -910
  90. package/src/core/json-schema/meta-descriptions.generated.ts +0 -202
  91. package/src/core/output/activity.ts +0 -575
  92. package/src/core/output/bind.ts +0 -59
  93. package/src/core/output/contracts.ts +0 -194
  94. package/src/core/output/display-value.ts +0 -48
  95. package/src/core/output/index.ts +0 -704
  96. package/src/core/output/renderers.ts +0 -125
  97. package/src/core/output/writer.ts +0 -46
  98. package/src/core/parse/index.ts +0 -742
  99. package/src/core/prompt/index.ts +0 -623
  100. package/src/core/resolve/args.ts +0 -144
  101. package/src/core/resolve/coerce.ts +0 -500
  102. package/src/core/resolve/config.ts +0 -26
  103. package/src/core/resolve/contracts.ts +0 -135
  104. package/src/core/resolve/errors.ts +0 -227
  105. package/src/core/resolve/flags.ts +0 -269
  106. package/src/core/resolve/index.ts +0 -108
  107. package/src/core/resolve/property.ts +0 -99
  108. package/src/core/schema/activity.ts +0 -240
  109. package/src/core/schema/arg.ts +0 -841
  110. package/src/core/schema/command.ts +0 -1500
  111. package/src/core/schema/flag.ts +0 -917
  112. package/src/core/schema/index.ts +0 -96
  113. package/src/core/schema/middleware.ts +0 -171
  114. package/src/core/schema/number-constraints.ts +0 -153
  115. package/src/core/schema/prompt.ts +0 -171
  116. package/src/core/schema/run.ts +0 -198
  117. package/src/core/schema-dsl/index.ts +0 -109
  118. package/src/core/schema-dsl/parse.ts +0 -262
  119. package/src/core/schema-dsl/runtime.ts +0 -609
  120. package/src/core/schema-dsl/to-json-schema.ts +0 -102
  121. package/src/core/testkit/index.ts +0 -147
  122. package/src/index.ts +0 -181
  123. package/src/runtime/adapter.ts +0 -303
  124. package/src/runtime/auto.ts +0 -86
  125. package/src/runtime/bun.ts +0 -48
  126. package/src/runtime/deno.ts +0 -367
  127. package/src/runtime/detect.ts +0 -105
  128. package/src/runtime/index.ts +0 -21
  129. package/src/runtime/node-builtins.d.ts +0 -27
  130. package/src/runtime/node.ts +0 -289
  131. package/src/runtime/paths.ts +0 -64
  132. package/src/runtime/support.ts +0 -77
  133. package/src/runtime.ts +0 -31
  134. package/src/schema.ts +0 -16
  135. package/src/strings.ts +0 -34
  136. package/src/testkit.ts +0 -25
  137. package/src/version.ts +0 -20
@@ -1,2 +1,271 @@
1
- const e={"{":`lbrace`,"}":`rbrace`,"[":`lbracket`,"]":`rbracket`,"<":`langle`,">":`rangle`,",":`comma`,":":`colon`,";":`semicolon`,"?":`question`,"|":`pipe`};function t(e){return e===` `||e===`
2
- `||e===` `||e===`\r`}function n(e){return e>=`a`&&e<=`z`||e>=`A`&&e<=`Z`||e>=`0`&&e<=`9`||e===`_`||e===`$`}function r(e){return e>=`a`&&e<=`z`||e>=`A`&&e<=`Z`||e===`_`||e===`$`}function i(i){let a=[],o=0;for(;o<i.length;){let s=i[o]??``;if(t(s)){o++;continue}let c=e[s];if(c!==void 0){a.push({kind:c,value:s}),o++;continue}if(s===`'`){let e=``;for(o++;o<i.length&&i[o]!==`'`;)e+=i[o],o++;if(o>=i.length)throw SyntaxError(`Unterminated string literal`);o++,a.push({kind:`string_literal`,value:e});continue}if(s===`@`){o++;let e=``;for(;o<i.length;){let t=i[o]??``;if(!n(t))break;e+=t,o++}if(e.length===0)throw SyntaxError(`Expected identifier after '@' at position ${String(o)}`);a.push({kind:`ref`,value:e});continue}if(r(s)){let e=``;for(;o<i.length;){let t=i[o]??``;if(!n(t))break;e+=t,o++}a.push({kind:`ident`,value:e});continue}throw SyntaxError(`Unexpected character '${s}' at position ${String(o)}`)}return a}const a=new Set([`string`,`number`,`integer`,`boolean`,`true`,`false`,`null`,`undefined`,`unknown`,`never`]);function o(e){switch(e){case`string`:return{kind:`string`};case`number`:return{kind:`number`};case`integer`:return{kind:`integer`};case`boolean`:return{kind:`boolean`};case`true`:return{kind:`true`};case`false`:return{kind:`false`};case`null`:return{kind:`null`};case`undefined`:return{kind:`undefined`};case`unknown`:return{kind:`unknown`};case`never`:return{kind:`never`};default:throw SyntaxError(`Unknown type '${e}'`)}}var s=class{tokens;pos=0;constructor(e){this.tokens=e}parseRoot(){let e=this.parseValue();if(this.pos<this.tokens.length){let e=this.peek();throw SyntaxError(`Unexpected token '${e?.value??`?`}' at position ${String(this.pos)}`)}return e}parseValue(){return this.parseUnion()}parseUnion(){let e=this.parsePostfix();if(!this.check(`pipe`))return e;let t=[e];for(;this.match(`pipe`);)t.push(this.parsePostfix());return{kind:`union`,members:t}}parsePostfix(){let e=this.parsePrimary();for(;this.check(`lbracket`)&&this.checkAt(this.pos+1,`rbracket`);)this.advance(),this.advance(),e={kind:`array`,element:e};return e}parsePrimary(){if(this.check(`lbrace`))return this.parseObject();if(this.check(`string_literal`))return{kind:`literal`,value:this.advance().value};if(this.check(`ref`))return{kind:`ref`,target:this.advance().value};let e=this.expectIdent();if(e===`Record`){if(this.expect(`langle`),this.parseValue().kind!==`string`)throw SyntaxError(`Record key type must be 'string' because JSON object keys are always strings`);this.expect(`comma`);let e=this.parseValue();return this.expect(`rangle`),{kind:`record`,value:e}}if(!a.has(e))throw SyntaxError(`Unknown type '${e}' at position ${String(this.pos-1)}`);return o(e)}parseObject(){this.expect(`lbrace`);let e={};for(;!this.check(`rbrace`);){let t=this.expectIdent();if(Object.hasOwn(e,t))throw SyntaxError(`Duplicate property '${t}' at position ${String(this.pos-1)}`);let n=this.match(`question`);this.expect(`colon`),e[t]={optional:n,schema:this.parseValue()},this.match(`semicolon`)}return this.expect(`rbrace`),{kind:`object`,properties:e}}peek(){return this.tokens[this.pos]}check(e){return this.peek()?.kind===e}checkAt(e,t){return this.tokens[e]?.kind===t}advance(){let e=this.tokens[this.pos];if(e===void 0)throw SyntaxError(`Unexpected end of input`);return this.pos++,e}match(e){return this.check(e)?(this.pos++,!0):!1}expect(e){if(!this.check(e)){let t=this.peek();throw SyntaxError(t?`Expected '${e}' but got '${t.kind}' ('${t.value}') at position ${String(this.pos)}`:`Expected '${e}' but reached end of input`)}return this.advance()}expectIdent(){return this.expect(`ident`).value}};function c(e){return new s(i(e)).parseRoot()}export{c as parseSchema};
1
+ //#region src/core/schema-dsl/runtime.ts
2
+ /** Map single characters to their token kinds. */
3
+ const SINGLE_CHAR_TOKENS = {
4
+ "{": "lbrace",
5
+ "}": "rbrace",
6
+ "[": "lbracket",
7
+ "]": "rbracket",
8
+ "<": "langle",
9
+ ">": "rangle",
10
+ ",": "comma",
11
+ ":": "colon",
12
+ ";": "semicolon",
13
+ "?": "question",
14
+ "|": "pipe"
15
+ };
16
+ /** Whitespace characters to skip. */
17
+ function isWhitespace(c) {
18
+ return c === " " || c === "\n" || c === " " || c === "\r";
19
+ }
20
+ /** Identifier-valid characters (a-z, A-Z, 0-9, _, $). */
21
+ function isIdentChar(c) {
22
+ return c >= "a" && c <= "z" || c >= "A" && c <= "Z" || c >= "0" && c <= "9" || c === "_" || c === "$";
23
+ }
24
+ /** Identifier start characters (a-z, A-Z, _, $). */
25
+ function isIdentStart(c) {
26
+ return c >= "a" && c <= "z" || c >= "A" && c <= "Z" || c === "_" || c === "$";
27
+ }
28
+ /**
29
+ * Tokenize a schema source string.
30
+ *
31
+ * Produces a flat array of tokens: identifiers (`string`, `number`, etc.),
32
+ * punctuation (`{`, `}`, `[`, `]`, `:`, `;`, `?`, `|`), and skips
33
+ * whitespace. Throws on unrecognized characters.
34
+ */
35
+ function tokenize(source) {
36
+ const tokens = [];
37
+ let i = 0;
38
+ while (i < source.length) {
39
+ const c = source[i] ?? "";
40
+ if (isWhitespace(c)) {
41
+ i++;
42
+ continue;
43
+ }
44
+ const singleKind = SINGLE_CHAR_TOKENS[c];
45
+ if (singleKind !== void 0) {
46
+ tokens.push({
47
+ kind: singleKind,
48
+ value: c
49
+ });
50
+ i++;
51
+ continue;
52
+ }
53
+ if (c === "'") {
54
+ let lit = "";
55
+ i++;
56
+ while (i < source.length && source[i] !== "'") {
57
+ lit += source[i];
58
+ i++;
59
+ }
60
+ if (i >= source.length) throw new SyntaxError("Unterminated string literal");
61
+ i++;
62
+ tokens.push({
63
+ kind: "string_literal",
64
+ value: lit
65
+ });
66
+ continue;
67
+ }
68
+ if (c === "@") {
69
+ i++;
70
+ let ref = "";
71
+ while (i < source.length) {
72
+ const ch = source[i] ?? "";
73
+ if (!isIdentChar(ch)) break;
74
+ ref += ch;
75
+ i++;
76
+ }
77
+ if (ref.length === 0) throw new SyntaxError(`Expected identifier after '@' at position ${String(i)}`);
78
+ tokens.push({
79
+ kind: "ref",
80
+ value: ref
81
+ });
82
+ continue;
83
+ }
84
+ if (isIdentStart(c)) {
85
+ let ident = "";
86
+ while (i < source.length) {
87
+ const ch = source[i] ?? "";
88
+ if (!isIdentChar(ch)) break;
89
+ ident += ch;
90
+ i++;
91
+ }
92
+ tokens.push({
93
+ kind: "ident",
94
+ value: ident
95
+ });
96
+ continue;
97
+ }
98
+ throw new SyntaxError(`Unexpected character '${c}' at position ${String(i)}`);
99
+ }
100
+ return tokens;
101
+ }
102
+ /** Primitive type names recognized by the parser. */
103
+ const PRIMITIVES = /* @__PURE__ */ new Set([
104
+ "string",
105
+ "number",
106
+ "integer",
107
+ "boolean",
108
+ "true",
109
+ "false",
110
+ "null",
111
+ "undefined",
112
+ "unknown",
113
+ "never"
114
+ ]);
115
+ /** Map a primitive name to its AST node. */
116
+ function primitiveNode(name) {
117
+ switch (name) {
118
+ case "string": return { kind: "string" };
119
+ case "number": return { kind: "number" };
120
+ case "integer": return { kind: "integer" };
121
+ case "boolean": return { kind: "boolean" };
122
+ case "true": return { kind: "true" };
123
+ case "false": return { kind: "false" };
124
+ case "null": return { kind: "null" };
125
+ case "undefined": return { kind: "undefined" };
126
+ case "unknown": return { kind: "unknown" };
127
+ case "never": return { kind: "never" };
128
+ default: throw new SyntaxError(`Unknown type '${name}'`);
129
+ }
130
+ }
131
+ /**
132
+ * Parse a token stream into a {@link SchemaNode} AST.
133
+ *
134
+ * Implements the grammar documented at the module level using standard
135
+ * recursive descent. Each grammar rule maps to one `parse*` method.
136
+ */
137
+ var SchemaParser = class {
138
+ tokens;
139
+ pos = 0;
140
+ constructor(tokens) {
141
+ this.tokens = tokens;
142
+ }
143
+ /** Parse the full token stream, asserting all tokens are consumed. */
144
+ parseRoot() {
145
+ const result = this.parseValue();
146
+ if (this.pos < this.tokens.length) {
147
+ const leftover = this.peek();
148
+ throw new SyntaxError(`Unexpected token '${leftover?.value ?? "?"}' at position ${String(this.pos)}`);
149
+ }
150
+ return result;
151
+ }
152
+ /** value = union */
153
+ parseValue() {
154
+ return this.parseUnion();
155
+ }
156
+ /** union = postfix ('|' postfix)* */
157
+ parseUnion() {
158
+ const first = this.parsePostfix();
159
+ if (!this.check("pipe")) return first;
160
+ const members = [first];
161
+ while (this.match("pipe")) members.push(this.parsePostfix());
162
+ return {
163
+ kind: "union",
164
+ members
165
+ };
166
+ }
167
+ /** postfix = primary ('[]')* */
168
+ parsePostfix() {
169
+ let node = this.parsePrimary();
170
+ while (this.check("lbracket") && this.checkAt(this.pos + 1, "rbracket")) {
171
+ this.advance();
172
+ this.advance();
173
+ node = {
174
+ kind: "array",
175
+ element: node
176
+ };
177
+ }
178
+ return node;
179
+ }
180
+ /** primary = object | record | ref | literal | IDENT */
181
+ parsePrimary() {
182
+ if (this.check("lbrace")) return this.parseObject();
183
+ if (this.check("string_literal")) return {
184
+ kind: "literal",
185
+ value: this.advance().value
186
+ };
187
+ if (this.check("ref")) return {
188
+ kind: "ref",
189
+ target: this.advance().value
190
+ };
191
+ const name = this.expectIdent();
192
+ if (name === "Record") {
193
+ this.expect("langle");
194
+ if (this.parseValue().kind !== "string") throw new SyntaxError("Record key type must be 'string' because JSON object keys are always strings");
195
+ this.expect("comma");
196
+ const valueSchema = this.parseValue();
197
+ this.expect("rangle");
198
+ return {
199
+ kind: "record",
200
+ value: valueSchema
201
+ };
202
+ }
203
+ if (!PRIMITIVES.has(name)) throw new SyntaxError(`Unknown type '${name}' at position ${String(this.pos - 1)}`);
204
+ return primitiveNode(name);
205
+ }
206
+ /** object = '{' properties '}' */
207
+ parseObject() {
208
+ this.expect("lbrace");
209
+ const properties = {};
210
+ while (!this.check("rbrace")) {
211
+ const name = this.expectIdent();
212
+ if (Object.hasOwn(properties, name)) throw new SyntaxError(`Duplicate property '${name}' at position ${String(this.pos - 1)}`);
213
+ const optional = this.match("question");
214
+ this.expect("colon");
215
+ properties[name] = {
216
+ optional,
217
+ schema: this.parseValue()
218
+ };
219
+ this.match("semicolon");
220
+ }
221
+ this.expect("rbrace");
222
+ return {
223
+ kind: "object",
224
+ properties
225
+ };
226
+ }
227
+ peek() {
228
+ return this.tokens[this.pos];
229
+ }
230
+ check(kind) {
231
+ return this.peek()?.kind === kind;
232
+ }
233
+ checkAt(pos, kind) {
234
+ return this.tokens[pos]?.kind === kind;
235
+ }
236
+ advance() {
237
+ const token = this.tokens[this.pos];
238
+ if (token === void 0) throw new SyntaxError("Unexpected end of input");
239
+ this.pos++;
240
+ return token;
241
+ }
242
+ match(kind) {
243
+ if (this.check(kind)) {
244
+ this.pos++;
245
+ return true;
246
+ }
247
+ return false;
248
+ }
249
+ expect(kind) {
250
+ if (!this.check(kind)) {
251
+ const got = this.peek();
252
+ throw new SyntaxError(got ? `Expected '${kind}' but got '${got.kind}' ('${got.value}') at position ${String(this.pos)}` : `Expected '${kind}' but reached end of input`);
253
+ }
254
+ return this.advance();
255
+ }
256
+ expectIdent() {
257
+ return this.expect("ident").value;
258
+ }
259
+ };
260
+ /**
261
+ * Parse a schema source string into a runtime AST.
262
+ *
263
+ * @param source - Schema string (e.g. `"{ name: string; age: number }"`).
264
+ * @returns The root {@link SchemaNode}.
265
+ * @throws {@link SyntaxError} on malformed input.
266
+ */
267
+ function parseSchema(source) {
268
+ return new SchemaParser(tokenize(source)).parseRoot();
269
+ }
270
+ //#endregion
271
+ export { parseSchema };
@@ -1 +1,74 @@
1
- function e(t){switch(t.kind){case`string`:return{type:`string`};case`number`:return{type:`number`};case`integer`:return{type:`integer`};case`boolean`:return{type:`boolean`};case`true`:return{const:!0};case`false`:return{const:!1};case`null`:return{type:`null`};case`literal`:return{const:t.value};case`undefined`:throw Error(`Cannot convert 'undefined' type to JSON Schema; model optionality at the parent level`);case`unknown`:return{};case`never`:return{not:{}};case`ref`:return{$ref:`#/$defs/${t.target}`};case`array`:return{type:`array`,items:e(t.element)};case`record`:return{type:`object`,additionalProperties:e(t.value)};case`object`:{let n={},r=[];for(let[i,a]of Object.entries(t.properties))n[i]=e(a.schema),a.optional||r.push(i);let i={type:`object`,additionalProperties:!1,properties:n};return r.length>0&&(i.required=r),i}case`union`:{let n=[],r=!0;for(let e of t.members)e.kind===`literal`?n.push(e.value):r=!1;return r?{enum:n}:{oneOf:t.members.map(e)}}}}export{e as nodeToJsonSchema};
1
+ //#region src/core/schema-dsl/to-json-schema.ts
2
+ /**
3
+ * Convert a {@link SchemaNode} AST node to a JSON Schema fragment.
4
+ *
5
+ * Mapping:
6
+ * - `string` → `{ type: 'string' }`
7
+ * - `number` → `{ type: 'number' }`
8
+ * - `integer` → `{ type: 'integer' }`
9
+ * - `boolean` → `{ type: 'boolean' }`
10
+ * - `true` → `{ const: true }`
11
+ * - `false` → `{ const: false }`
12
+ * - `null` → `{ type: 'null' }`
13
+ * - `undefined` → throws (JSON Schema has no `undefined` type)
14
+ * - `unknown` → `{}` (accepts any value)
15
+ * - `never` → `{ not: {} }` (rejects all values)
16
+ * - `'literal'` → `{ const: 'literal' }`
17
+ * - `@ref` → `{ $ref: '#/$defs/ref' }`
18
+ * - `T[]` → `{ type: 'array', items: convert(T) }`
19
+ * - `Record<K,V>` → `{ type: 'object', additionalProperties: convert(V) }`
20
+ * - `{...}` → `{ type: 'object', properties: ..., required: [...] }`
21
+ * - `A | B` → `{ enum: [...] }` if all literals, else `{ oneOf: [...] }`
22
+ *
23
+ * @param node - The AST node to convert.
24
+ * @returns A plain JSON Schema fragment.
25
+ */
26
+ function nodeToJsonSchema(node) {
27
+ switch (node.kind) {
28
+ case "string": return { type: "string" };
29
+ case "number": return { type: "number" };
30
+ case "integer": return { type: "integer" };
31
+ case "boolean": return { type: "boolean" };
32
+ case "true": return { const: true };
33
+ case "false": return { const: false };
34
+ case "null": return { type: "null" };
35
+ case "literal": return { const: node.value };
36
+ case "undefined": throw new Error("Cannot convert 'undefined' type to JSON Schema; model optionality at the parent level");
37
+ case "unknown": return {};
38
+ case "never": return { not: {} };
39
+ case "ref": return { $ref: `#/$defs/${node.target}` };
40
+ case "array": return {
41
+ type: "array",
42
+ items: nodeToJsonSchema(node.element)
43
+ };
44
+ case "record": return {
45
+ type: "object",
46
+ additionalProperties: nodeToJsonSchema(node.value)
47
+ };
48
+ case "object": {
49
+ const properties = {};
50
+ const required = [];
51
+ for (const [key, prop] of Object.entries(node.properties)) {
52
+ properties[key] = nodeToJsonSchema(prop.schema);
53
+ if (!prop.optional) required.push(key);
54
+ }
55
+ const result = {
56
+ type: "object",
57
+ additionalProperties: false,
58
+ properties
59
+ };
60
+ if (required.length > 0) result.required = required;
61
+ return result;
62
+ }
63
+ case "union": {
64
+ const literalValues = [];
65
+ let allLiteral = true;
66
+ for (const member of node.members) if (member.kind === "literal") literalValues.push(member.value);
67
+ else allLiteral = false;
68
+ if (allLiteral) return { enum: literalValues };
69
+ return { oneOf: node.members.map(nodeToJsonSchema) };
70
+ }
71
+ }
72
+ }
73
+ //#endregion
74
+ export { nodeToJsonSchema };
@@ -1 +1,83 @@
1
- import{createCaptureOutput as e}from"../output/index.mjs";import{includesBeforeSeparator as t,stripBeforeSeparator as n}from"../parse/index.mjs";import{buildRunResult as r,executeCommand as i}from"../execution/index.mjs";async function a(a,o,s){let c=t(o,`--json`),l=c||s?.jsonMode===!0,u=c?n(o,`--json`):o,d,f;if(s?.out!==void 0)d=s.out,f=s.captured??{stdout:[],stderr:[],activity:[]};else{let t={...s?.verbosity===void 0?{}:{verbosity:s.verbosity},...l?{jsonMode:l}:{},...s?.isTTY===void 0?{}:{isTTY:s.isTTY}};[d,f]=e(Object.keys(t).length>0?t:void 0)}let p=s?.mergedSchema??a.schema,m=s?.meta??{name:p.name,bin:s?.help?.binName??p.name,version:void 0,command:p.name},h=s===void 0?l?{jsonMode:l}:void 0:{...s,...l?{jsonMode:l}:{}};return r(await i({command:a,argv:u,out:d,schema:p,meta:m,...h===void 0?{}:{options:h}}),f)}export{a as runCommand};
1
+ import { createCaptureOutput } from "../output/index.mjs";
2
+ import { includesBeforeSeparator, stripBeforeSeparator } from "../parse/index.mjs";
3
+ import { buildRunResult, executeCommand } from "../execution/index.mjs";
4
+ //#region src/core/testkit/index.ts
5
+ /**
6
+ * Test harness: command.run() with injected state, output capture.
7
+ *
8
+ * Provides {@linkcode runCommand()} — the in-process test harness wrapper over DreamCLI's
9
+ * shared executor.\
10
+ * It wires capture output and standalone command metadata,
11
+ * then returns a structured {@linkcode RunResult} with exitCode and captured output.
12
+ *
13
+ * This keeps command tests process-free without testkit owning the canonical pipeline:
14
+ *
15
+ * ```text
16
+ * parse -> resolve -> execute
17
+ * ```
18
+ * @module dreamcli/core/testkit
19
+ */
20
+ /**
21
+ * Run a command builder against the given argv with injected options.
22
+ *
23
+ * This is the testkit wrapper around the shared executor:
24
+ * 1. Apply the CLI root-flag layer (detect/strip `--json`) so copied real argv works
25
+ * 2. Create or reuse capture output
26
+ * 3. Build standalone schema/meta defaults when CLI dispatch did not
27
+ * 4. Delegate parse -> resolve -> execute to the shared executor
28
+ * 5. Return the structured result with captured buffers
29
+ *
30
+ * Errors are normalized by the shared executor into structured {@linkcode RunResult}s
31
+ * with appropriate exit codes. The function never throws.
32
+ *
33
+ * @param cmd - The command builder (must have an action handler)
34
+ * @param argv - Raw argv strings (NOT including the command name itself). A
35
+ * CLI-level `--json` before the `--` separator is honored and stripped here,
36
+ * just like the real CLI root — so `['--json']` enables JSON mode rather than
37
+ * failing as an unknown flag. Equivalent to passing `{ jsonMode: true }`.
38
+ * @param options - Injectable runtime state
39
+ * @returns Structured run result with exit code and captured output
40
+ */
41
+ async function runCommand(cmd, argv, options) {
42
+ const hasJsonFlag = includesBeforeSeparator(argv, "--json");
43
+ const jsonMode = hasJsonFlag || options?.jsonMode === true;
44
+ const effectiveArgv = hasJsonFlag ? stripBeforeSeparator(argv, "--json") : argv;
45
+ let out;
46
+ let captured;
47
+ if (options?.out !== void 0) {
48
+ out = options.out;
49
+ captured = options.captured ?? {
50
+ stdout: [],
51
+ stderr: [],
52
+ activity: []
53
+ };
54
+ } else {
55
+ const captureOptions = {
56
+ ...options?.verbosity !== void 0 ? { verbosity: options.verbosity } : {},
57
+ ...jsonMode ? { jsonMode } : {},
58
+ ...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {}
59
+ };
60
+ [out, captured] = createCaptureOutput(Object.keys(captureOptions).length > 0 ? captureOptions : void 0);
61
+ }
62
+ const schema = options?.mergedSchema ?? cmd.schema;
63
+ const meta = options?.meta ?? {
64
+ name: schema.name,
65
+ bin: options?.help?.binName ?? schema.name,
66
+ version: void 0,
67
+ command: schema.name
68
+ };
69
+ const effectiveOptions = options !== void 0 ? {
70
+ ...options,
71
+ ...jsonMode ? { jsonMode } : {}
72
+ } : jsonMode ? { jsonMode } : void 0;
73
+ return buildRunResult(await executeCommand({
74
+ command: cmd,
75
+ argv: effectiveArgv,
76
+ out,
77
+ schema,
78
+ meta,
79
+ ...effectiveOptions !== void 0 ? { options: effectiveOptions } : {}
80
+ }), captured);
81
+ }
82
+ //#endregion
83
+ export { runCommand };
package/dist/index.d.mts CHANGED
@@ -28,4 +28,5 @@ import { SHELLS, Shell, generateCompletion } from "./core/completion/index.mjs";
28
28
  import { ConfigAdapter, ConfigDiscoveryOptions, ConfigDiscoveryResult, ConfigFound, ConfigNotFound, FormatLoader, buildConfigSearchPaths, configFormat, discoverConfig } from "./core/config/index.mjs";
29
29
  import { CLIBuilder, CLIOptions, CLIRunOptions, CLISchema, ConfigSettings, InferNameOption, ManifestPresetSettings, ManifestSettings, PackageJsonSettings, ResolvedManifestSettings, cli } from "./core/cli/index.mjs";
30
30
  import { JsonSchemaOptions, definitionMetaSchema, generateInputSchema, generateSchema } from "./core/json-schema/index.mjs";
31
- export { type ActionHandler, type ActionParams, type ActivityEvent, type AnyCommandBuilder, ArgBuilder, type ArgConfig, type ArgFactory, type ArgKind, type ArgParseFn, type ArgPresence, type ArgSchema, type BeforeParseParams, CLIBuilder, CLIError, type CLIErrorJSON, type CLIErrorOptions, type CLIOptions, type CLIPlugin, type CLIPluginHooks, type CLIRunOptions, type CLISchema, type CommandArgEntry, CommandBuilder, type CommandConfig, type CommandExample, type CommandMeta, type CommandSchema, type CompletionOptions, type ConfigAdapter, type ConfigDiscoveryOptions, type ConfigDiscoveryResult, type ConfigFound, type ConfigNotFound, type ConfigSettings, type ConfirmPromptConfig, type DeprecationWarning, type DeriveHandler, type DeriveParams, type ErrorCode, type Fallback, FlagBuilder, type FlagConfig, type FlagFactory, type FlagKind, type FlagParseFn, type FlagPresence, type FlagSchema, type FormatLoader, type HelpLinks, type HelpOptions, type InferArg, type InferArgs, type InferFlag, type InferFlags, type InferNameOption, type InputPromptConfig, type InteractiveParams, type InteractiveResolver, type InteractiveResult, type JsonSchemaOptions, type ManifestDiscoveryOptions, type ManifestPresetSettings, type ManifestSettings, type Middleware, type MiddlewareHandler, type MiddlewareParams, type MultiselectPromptConfig, type NumberConstraintViolation, type NumberConstraints, type Out, type OutputOptions, type PackageJsonAdapter, type PackageJsonData, type PackageJsonSettings, type PackageRepository, ParseError, type ParseErrorCode, type ParseErrorOptions, type ParseResult, type PluginCommandContext, type ProgressHandle, type ProgressOptions, type PromptConfig, type PromptConfigBase, type PromptEngine, type PromptKind, type PromptResult, type ReadFn, type ResolveOptions, type ResolveResult, type ResolvedArgValue, type ResolvedCommandParams, type ResolvedManifestSettings, type ResolvedMultiselectPromptConfig, type ResolvedPromptConfig, type ResolvedSelectPromptConfig, type ResolvedValue, type RunResult, SHELLS, type SelectChoice, type SelectPromptConfig, type Shell, type SpinnerHandle, type SpinnerOptions, type TableColumn, type TableFormat, type TableOptions, type TableStream, type Token, ValidationError, type ValidationErrorCode, type ValidationErrorOptions, type Verbosity, type WithArgPresence, type WithPresence, type WithVariadic, type WriteFn, arg, buildConfigSearchPaths, cli, command, configFormat, createArgSchema, createOutput, createSchema, createTerminalPrompter, definitionMetaSchema, discoverConfig, discoverManifest, discoverPackageJson, flag, formatHelp, generateBashCompletion, generateCompletion, generateFishCompletion, generateInputSchema, generatePowerShellCompletion, generateSchema, generateZshCompletion, group, inferCliName, isCLIError, isParseError, isValidationError, middleware, osc8, packageRepositoryUrl, parse, plugin, resolve, resolvePromptConfig, tokenize, visibleWidth };
31
+ import { Colors } from "ansispeck";
32
+ export { type ActionHandler, type ActionParams, type ActivityEvent, type AnyCommandBuilder, ArgBuilder, type ArgConfig, type ArgFactory, type ArgKind, type ArgParseFn, type ArgPresence, type ArgSchema, type BeforeParseParams, CLIBuilder, CLIError, type CLIErrorJSON, type CLIErrorOptions, type CLIOptions, type CLIPlugin, type CLIPluginHooks, type CLIRunOptions, type CLISchema, type Colors, type CommandArgEntry, CommandBuilder, type CommandConfig, type CommandExample, type CommandMeta, type CommandSchema, type CompletionOptions, type ConfigAdapter, type ConfigDiscoveryOptions, type ConfigDiscoveryResult, type ConfigFound, type ConfigNotFound, type ConfigSettings, type ConfirmPromptConfig, type DeprecationWarning, type DeriveHandler, type DeriveParams, type ErrorCode, type Fallback, FlagBuilder, type FlagConfig, type FlagFactory, type FlagKind, type FlagParseFn, type FlagPresence, type FlagSchema, type FormatLoader, type HelpLinks, type HelpOptions, type InferArg, type InferArgs, type InferFlag, type InferFlags, type InferNameOption, type InputPromptConfig, type InteractiveParams, type InteractiveResolver, type InteractiveResult, type JsonSchemaOptions, type ManifestDiscoveryOptions, type ManifestPresetSettings, type ManifestSettings, type Middleware, type MiddlewareHandler, type MiddlewareParams, type MultiselectPromptConfig, type NumberConstraintViolation, type NumberConstraints, type Out, type OutputOptions, type PackageJsonAdapter, type PackageJsonData, type PackageJsonSettings, type PackageRepository, ParseError, type ParseErrorCode, type ParseErrorOptions, type ParseResult, type PluginCommandContext, type ProgressHandle, type ProgressOptions, type PromptConfig, type PromptConfigBase, type PromptEngine, type PromptKind, type PromptResult, type ReadFn, type ResolveOptions, type ResolveResult, type ResolvedArgValue, type ResolvedCommandParams, type ResolvedManifestSettings, type ResolvedMultiselectPromptConfig, type ResolvedPromptConfig, type ResolvedSelectPromptConfig, type ResolvedValue, type RunResult, SHELLS, type SelectChoice, type SelectPromptConfig, type Shell, type SpinnerHandle, type SpinnerOptions, type TableColumn, type TableFormat, type TableOptions, type TableStream, type Token, ValidationError, type ValidationErrorCode, type ValidationErrorOptions, type Verbosity, type WithArgPresence, type WithPresence, type WithVariadic, type WriteFn, arg, buildConfigSearchPaths, cli, command, configFormat, createArgSchema, createOutput, createSchema, createTerminalPrompter, definitionMetaSchema, discoverConfig, discoverManifest, discoverPackageJson, flag, formatHelp, generateBashCompletion, generateCompletion, generateFishCompletion, generateInputSchema, generatePowerShellCompletion, generateSchema, generateZshCompletion, group, inferCliName, isCLIError, isParseError, isValidationError, middleware, osc8, packageRepositoryUrl, parse, plugin, resolve, resolvePromptConfig, tokenize, visibleWidth };
package/dist/index.mjs CHANGED
@@ -1 +1,22 @@
1
- import{FlagBuilder as e,createSchema as t,flag as n}from"./core/schema/flag.mjs";import{generateBashCompletion as r}from"./core/completion/shells/bash.mjs";import{generateFishCompletion as i}from"./core/completion/shells/fish.mjs";import{generatePowerShellCompletion as a}from"./core/completion/shells/powershell.mjs";import{CLIError as o,ParseError as s,ValidationError as c,isCLIError as l,isParseError as u,isValidationError as d}from"./core/errors/index.mjs";import{generateZshCompletion as f}from"./core/completion/shells/zsh.mjs";import{SHELLS as p,generateCompletion as m}from"./core/completion/index.mjs";import{osc8 as h,visibleWidth as g}from"./core/help/ansi.mjs";import{formatHelp as _}from"./core/help/index.mjs";import{createOutput as v}from"./core/output/index.mjs";import{ArgBuilder as y,arg as b,createArgSchema as x}from"./core/schema/arg.mjs";import{CommandBuilder as S,command as C,group as w}from"./core/schema/command.mjs";import{middleware as T}from"./core/schema/middleware.mjs";import{parse as E,tokenize as D}from"./core/parse/index.mjs";import{createTerminalPrompter as O,resolvePromptConfig as k}from"./core/prompt/index.mjs";import{resolve as A}from"./core/resolve/index.mjs";import{discoverManifest as j,discoverPackageJson as M,inferCliName as N,packageRepositoryUrl as P}from"./core/config/package-json.mjs";import{plugin as F}from"./core/cli/plugin.mjs";import{buildConfigSearchPaths as I,configFormat as L,discoverConfig as R}from"./core/config/index.mjs";import{CLIBuilder as z,cli as B}from"./core/cli/index.mjs";import{definitionMetaSchema as V,generateInputSchema as H,generateSchema as U}from"./core/json-schema/index.mjs";export{y as ArgBuilder,z as CLIBuilder,o as CLIError,S as CommandBuilder,e as FlagBuilder,s as ParseError,p as SHELLS,c as ValidationError,b as arg,I as buildConfigSearchPaths,B as cli,C as command,L as configFormat,x as createArgSchema,v as createOutput,t as createSchema,O as createTerminalPrompter,V as definitionMetaSchema,R as discoverConfig,j as discoverManifest,M as discoverPackageJson,n as flag,_ as formatHelp,r as generateBashCompletion,m as generateCompletion,i as generateFishCompletion,H as generateInputSchema,a as generatePowerShellCompletion,U as generateSchema,f as generateZshCompletion,w as group,N as inferCliName,l as isCLIError,u as isParseError,d as isValidationError,T as middleware,h as osc8,P as packageRepositoryUrl,E as parse,F as plugin,A as resolve,k as resolvePromptConfig,D as tokenize,g as visibleWidth};
1
+ import { FlagBuilder, createSchema, flag } from "./core/schema/flag.mjs";
2
+ import { generateBashCompletion } from "./core/completion/shells/bash.mjs";
3
+ import { generateFishCompletion } from "./core/completion/shells/fish.mjs";
4
+ import { generatePowerShellCompletion } from "./core/completion/shells/powershell.mjs";
5
+ import { CLIError, ParseError, ValidationError, isCLIError, isParseError, isValidationError } from "./core/errors/index.mjs";
6
+ import { generateZshCompletion } from "./core/completion/shells/zsh.mjs";
7
+ import { SHELLS, generateCompletion } from "./core/completion/index.mjs";
8
+ import { osc8, visibleWidth } from "./core/help/ansi.mjs";
9
+ import { formatHelp } from "./core/help/index.mjs";
10
+ import { createOutput } from "./core/output/index.mjs";
11
+ import { ArgBuilder, arg, createArgSchema } from "./core/schema/arg.mjs";
12
+ import { CommandBuilder, command, group } from "./core/schema/command.mjs";
13
+ import { middleware } from "./core/schema/middleware.mjs";
14
+ import { parse, tokenize } from "./core/parse/index.mjs";
15
+ import { createTerminalPrompter, resolvePromptConfig } from "./core/prompt/index.mjs";
16
+ import { resolve } from "./core/resolve/index.mjs";
17
+ import { discoverManifest, discoverPackageJson, inferCliName, packageRepositoryUrl } from "./core/config/package-json.mjs";
18
+ import { plugin } from "./core/cli/plugin.mjs";
19
+ import { buildConfigSearchPaths, configFormat, discoverConfig } from "./core/config/index.mjs";
20
+ import { CLIBuilder, cli } from "./core/cli/index.mjs";
21
+ import { definitionMetaSchema, generateInputSchema, generateSchema } from "./core/json-schema/index.mjs";
22
+ export { ArgBuilder, CLIBuilder, CLIError, CommandBuilder, FlagBuilder, ParseError, SHELLS, ValidationError, arg, buildConfigSearchPaths, cli, command, configFormat, createArgSchema, createOutput, createSchema, createTerminalPrompter, definitionMetaSchema, discoverConfig, discoverManifest, discoverPackageJson, flag, formatHelp, generateBashCompletion, generateCompletion, generateFishCompletion, generateInputSchema, generatePowerShellCompletion, generateSchema, generateZshCompletion, group, inferCliName, isCLIError, isParseError, isValidationError, middleware, osc8, packageRepositoryUrl, parse, plugin, resolve, resolvePromptConfig, tokenize, visibleWidth };
@@ -1 +1,82 @@
1
- var e=class extends Error{name=`ExitError`;code;constructor(e){super(`Process exited with code ${e}`),this.code=e}};const t=()=>{},n=()=>Promise.resolve(null),r=()=>Promise.resolve(null);function i(i){let a=i?.stdinIsTTY??!1,o=a?void 0:i?.stdinData;return{argv:i?.argv??[`node`,`test`],env:i?.env??{},cwd:i?.cwd??`/test`,stdout:i?.stdout??t,stderr:i?.stderr??t,stdin:i?.stdin??n,readStdin:()=>{if(o===void 0)return Promise.resolve(null);let e=o;return o=void 0,Promise.resolve(e)},isTTY:i?.isTTY??!1,stdinIsTTY:a,exit:i?.exit??(t=>{throw new e(t)}),readFile:i?.readFile??r,homedir:i?.homedir??`/home/test`,configDir:i?.configDir??`/home/test/.config`}}export{e as ExitError,i as createTestAdapter};
1
+ //#region src/runtime/adapter.ts
2
+ /**
3
+ * Error thrown by adapter implementations that model process exit as an
4
+ * exception instead of terminating immediately.
5
+ *
6
+ * Runtime and CLI dispatch layers can catch this to perform real process
7
+ * termination, while tests can assert on exit codes without killing the
8
+ * runner:
9
+ *
10
+ * ```ts
11
+ * try {
12
+ * await cli.run({ adapter: createTestAdapter() });
13
+ * } catch (e) {
14
+ * if (e instanceof ExitError) expect(e.code).toBe(0);
15
+ * }
16
+ * ```
17
+ */
18
+ var ExitError = class extends Error {
19
+ /** Error name — always `'ExitError'` for `instanceof` checks. */
20
+ name = "ExitError";
21
+ /** The exit code passed to `exit()`. */
22
+ code;
23
+ /** Create an ExitError for the given process exit code. */
24
+ constructor(code) {
25
+ super(`Process exited with code ${code}`);
26
+ this.code = code;
27
+ }
28
+ };
29
+ /** Noop writer — silently discards output. */
30
+ const noopWrite = () => {};
31
+ /** Noop reader — returns `null` (EOF) immediately. */
32
+ const eofRead = () => Promise.resolve(null);
33
+ /** Noop file reader — returns `null` (not found) for all paths. */
34
+ const noopReadFile = () => Promise.resolve(null);
35
+ /**
36
+ * Create a test runtime adapter with injectable process state.
37
+ *
38
+ * Use this in `@kjanat/dreamcli/testkit` tests when you need to simulate argv,
39
+ * environment variables, TTY state, stdin, or config-file reads without
40
+ * touching the host process.
41
+ *
42
+ * @param options - Optional overrides for any adapter field.
43
+ * @returns A {@linkcode RuntimeAdapter} suitable for test scenarios.
44
+ *
45
+ * @example
46
+ * ```ts
47
+ * const adapter = createTestAdapter({
48
+ * argv: ['node', 'cli.js', 'deploy', '--force'],
49
+ * env: { DEPLOY_REGION: 'us' },
50
+ * });
51
+ *
52
+ * const result = await cli('mycli').run({ adapter });
53
+ * ```
54
+ */
55
+ function createTestAdapter(options) {
56
+ const stdinIsTTY = options?.stdinIsTTY ?? false;
57
+ let stdinData = !stdinIsTTY ? options?.stdinData : void 0;
58
+ return {
59
+ argv: options?.argv ?? ["node", "test"],
60
+ env: options?.env ?? {},
61
+ cwd: options?.cwd ?? "/test",
62
+ stdout: options?.stdout ?? noopWrite,
63
+ stderr: options?.stderr ?? noopWrite,
64
+ stdin: options?.stdin ?? eofRead,
65
+ readStdin: () => {
66
+ if (stdinData === void 0) return Promise.resolve(null);
67
+ const result = stdinData;
68
+ stdinData = void 0;
69
+ return Promise.resolve(result);
70
+ },
71
+ isTTY: options?.isTTY ?? false,
72
+ stdinIsTTY,
73
+ exit: options?.exit ?? ((code) => {
74
+ throw new ExitError(code);
75
+ }),
76
+ readFile: options?.readFile ?? noopReadFile,
77
+ homedir: options?.homedir ?? "/home/test",
78
+ configDir: options?.configDir ?? "/home/test/.config"
79
+ };
80
+ }
81
+ //#endregion
82
+ export { ExitError, createTestAdapter };
@@ -1 +1,46 @@
1
- import{createNodeAdapter as e}from"./node.mjs";import{createBunAdapter as t}from"./bun.mjs";import{createDenoAdapter as n}from"./deno.mjs";import{detectRuntime as r}from"./detect.mjs";function i(e){if(typeof e!=`object`||!e)return!1;let t=e;return Array.isArray(t.args)&&typeof t.cwd==`function`&&typeof t.exit==`function`&&typeof t.readTextFile==`function`&&typeof t.env?.get==`function`&&typeof t.env.toObject==`function`&&typeof t.stdout?.writeSync==`function`&&typeof t.stdout.isTerminal==`function`&&typeof t.stderr?.writeSync==`function`&&typeof t.stdin?.isTerminal==`function`&&typeof t.stdin?.readable?.getReader==`function`}function a(e){let t=e.Deno;return i(t)?t:void 0}function o(i){let o=i??globalThis,s=r(o);switch(s){case`bun`:return t();case`deno`:return n(a(o));case`node`:case`unknown`:return e();default:return s}}export{o as createAdapter};
1
+ import { createNodeAdapter } from "./node.mjs";
2
+ import { createBunAdapter } from "./bun.mjs";
3
+ import { createDenoAdapter } from "./deno.mjs";
4
+ import { detectRuntime } from "./detect.mjs";
5
+ //#region src/runtime/auto.ts
6
+ function isDenoNamespace(value) {
7
+ if (typeof value !== "object" || value === null) return false;
8
+ const candidate = value;
9
+ return Array.isArray(candidate.args) && typeof candidate.cwd === "function" && typeof candidate.exit === "function" && typeof candidate.readTextFile === "function" && typeof candidate.env?.get === "function" && typeof candidate.env.toObject === "function" && typeof candidate.stdout?.writeSync === "function" && typeof candidate.stdout.isTerminal === "function" && typeof candidate.stderr?.writeSync === "function" && typeof candidate.stdin?.isTerminal === "function" && typeof candidate.stdin?.readable?.getReader === "function";
10
+ }
11
+ function getInjectedDenoNamespace(globals) {
12
+ const candidate = globals.Deno;
13
+ return isDenoNamespace(candidate) ? candidate : void 0;
14
+ }
15
+ /**
16
+ * Create a runtime adapter for the current environment.
17
+ *
18
+ * Detection order follows {@link detectRuntime}: Bun → Deno → Node → unknown.
19
+ * Unknown runtimes fall back to the Node adapter because most JS runtimes
20
+ * expose a Node-compatible `process` global.
21
+ *
22
+ * @param globals - Override `globalThis` for testing. Production callers
23
+ * should omit this parameter.
24
+ * @returns A {@linkcode RuntimeAdapter} for the detected runtime.
25
+ *
26
+ * @example
27
+ * ```ts
28
+ * import { cli } from '@kjanat/dreamcli';
29
+ *
30
+ * // Auto-detects Node/Bun/Deno and creates the right adapter
31
+ * cli('mycli').run(); // uses createAdapter() internally
32
+ * ```
33
+ */
34
+ function createAdapter(globals) {
35
+ const runtimeGlobals = globals ?? globalThis;
36
+ const runtime = detectRuntime(runtimeGlobals);
37
+ switch (runtime) {
38
+ case "bun": return createBunAdapter();
39
+ case "deno": return createDenoAdapter(getInjectedDenoNamespace(runtimeGlobals));
40
+ case "node":
41
+ case "unknown": return createNodeAdapter();
42
+ default: return runtime;
43
+ }
44
+ }
45
+ //#endregion
46
+ export { createAdapter };
@@ -1 +1,28 @@
1
- import{createNodeAdapter as e}from"./node.mjs";function t(t){return e(t)}export{t as createBunAdapter};
1
+ import { createNodeAdapter } from "./node.mjs";
2
+ //#region src/runtime/bun.ts
3
+ /**
4
+ * Create a runtime adapter backed by Bun's Node-compatible `process` global.
5
+ *
6
+ * Bun exposes `globalThis.process` with the same shape as Node.js, so this
7
+ * delegates entirely to {@link createNodeAdapter}. If Bun-specific optimizations
8
+ * are needed in the future (e.g. `Bun.write` for I/O), they can be layered
9
+ * here without changing the public API.
10
+ *
11
+ * @param proc - Override the process object (useful for testing the adapter itself).
12
+ * @returns A {@linkcode RuntimeAdapter} backed by Bun's process state.
13
+ *
14
+ * @example
15
+ * ```ts
16
+ * import { cli } from '@kjanat/dreamcli';
17
+ * import { createBunAdapter } from '@kjanat/dreamcli/runtime';
18
+ *
19
+ * cli('mycli')
20
+ * .command(deploy)
21
+ * .run({ adapter: createBunAdapter() });
22
+ * ```
23
+ */
24
+ function createBunAdapter(proc) {
25
+ return createNodeAdapter(proc);
26
+ }
27
+ //#endregion
28
+ export { createBunAdapter };