@kjanat/dreamcli 4.0.0-rc.2 → 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 (629) hide show
  1. package/README.md +5 -7
  2. package/dist/{runtime/adapter.d.mts → adapter-D0hbBNVB.d.mts} +5 -7
  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} +149 -25
  14. package/dist/index-DndPmT8J.d.mts +275 -0
  15. package/dist/{core/json-schema/index.d.mts → index-DyoaS234.d.mts} +54 -45
  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.d.mts +16 -4
  32. package/dist/version.mjs +1 -7
  33. package/dreamcli.schema.json +697 -538
  34. package/package.json +37 -12
  35. package/skills/cli-creation/SKILL.md +16 -11
  36. package/CHANGELOG.md +0 -2453
  37. package/dist/core/cli/builtins.d.mts +0 -47
  38. package/dist/core/cli/builtins.mjs +0 -135
  39. package/dist/core/cli/compiled.d.mts +0 -29
  40. package/dist/core/cli/compiled.mjs +0 -76
  41. package/dist/core/cli/dispatch.d.mts +0 -38
  42. package/dist/core/cli/dispatch.mjs +0 -205
  43. package/dist/core/cli/help-links.d.mts +0 -15
  44. package/dist/core/cli/help-links.mjs +0 -41
  45. package/dist/core/cli/index.mjs +0 -1265
  46. package/dist/core/cli/planner.d.mts +0 -96
  47. package/dist/core/cli/planner.mjs +0 -323
  48. package/dist/core/cli/plugin.d.mts +0 -94
  49. package/dist/core/cli/plugin.mjs +0 -41
  50. package/dist/core/cli/propagate.d.mts +0 -39
  51. package/dist/core/cli/propagate.mjs +0 -57
  52. package/dist/core/cli/reserved-flags.d.mts +0 -1
  53. package/dist/core/cli/reserved-flags.mjs +0 -158
  54. package/dist/core/cli/root-help.d.mts +0 -1
  55. package/dist/core/cli/root-help.mjs +0 -221
  56. package/dist/core/cli/root-output-flags.d.mts +0 -1
  57. package/dist/core/cli/root-output-flags.mjs +0 -169
  58. package/dist/core/cli/root-surface.d.mts +0 -1
  59. package/dist/core/cli/root-surface.mjs +0 -28
  60. package/dist/core/cli/runtime-preflight.d.mts +0 -1
  61. package/dist/core/cli/runtime-preflight.mjs +0 -221
  62. package/dist/core/completion/index.d.mts +0 -76
  63. package/dist/core/completion/index.mjs +0 -90
  64. package/dist/core/completion/shells/bash.d.mts +0 -22
  65. package/dist/core/completion/shells/bash.mjs +0 -309
  66. package/dist/core/completion/shells/fish.d.mts +0 -18
  67. package/dist/core/completion/shells/fish.mjs +0 -163
  68. package/dist/core/completion/shells/powershell.d.mts +0 -12
  69. package/dist/core/completion/shells/powershell.mjs +0 -359
  70. package/dist/core/completion/shells/shared.d.mts +0 -49
  71. package/dist/core/completion/shells/shared.mjs +0 -147
  72. package/dist/core/completion/shells/zsh.d.mts +0 -22
  73. package/dist/core/completion/shells/zsh.mjs +0 -252
  74. package/dist/core/config/index.d.mts +0 -191
  75. package/dist/core/config/index.mjs +0 -285
  76. package/dist/core/config/package-json.d.mts +0 -179
  77. package/dist/core/config/package-json.mjs +0 -353
  78. package/dist/core/errors/index.d.mts +0 -126
  79. package/dist/core/errors/index.mjs +0 -87
  80. package/dist/core/execution/index.d.mts +0 -1
  81. package/dist/core/execution/index.mjs +0 -220
  82. package/dist/core/help/ansi.d.mts +0 -73
  83. package/dist/core/help/ansi.mjs +0 -121
  84. package/dist/core/help/index.d.mts +0 -110
  85. package/dist/core/help/index.mjs +0 -414
  86. package/dist/core/help/theme.d.mts +0 -48
  87. package/dist/core/help/theme.mjs +0 -46
  88. package/dist/core/json-schema/index.mjs +0 -1007
  89. package/dist/core/json-schema/meta-descriptions.generated.d.mts +0 -274
  90. package/dist/core/json-schema/meta-descriptions.generated.mjs +0 -136
  91. package/dist/core/output/activity.d.mts +0 -1
  92. package/dist/core/output/activity.mjs +0 -452
  93. package/dist/core/output/bind.d.mts +0 -1
  94. package/dist/core/output/bind.mjs +0 -56
  95. package/dist/core/output/contracts.d.mts +0 -81
  96. package/dist/core/output/contracts.mjs +0 -57
  97. package/dist/core/output/display-value.d.mts +0 -1
  98. package/dist/core/output/display-value.mjs +0 -32
  99. package/dist/core/output/index.d.mts +0 -160
  100. package/dist/core/output/index.mjs +0 -512
  101. package/dist/core/output/renderers.d.mts +0 -1
  102. package/dist/core/output/renderers.mjs +0 -46
  103. package/dist/core/output/writer.d.mts +0 -39
  104. package/dist/core/output/writer.mjs +0 -12
  105. package/dist/core/parse/index.d.mts +0 -178
  106. package/dist/core/parse/index.mjs +0 -850
  107. package/dist/core/parse/occurrences.d.mts +0 -89
  108. package/dist/core/parse/occurrences.mjs +0 -114
  109. package/dist/core/prompt/index.d.mts +0 -213
  110. package/dist/core/prompt/index.mjs +0 -348
  111. package/dist/core/read-flags/index.d.mts +0 -150
  112. package/dist/core/read-flags/index.mjs +0 -217
  113. package/dist/core/resolve/args.d.mts +0 -39
  114. package/dist/core/resolve/args.mjs +0 -182
  115. package/dist/core/resolve/coerce.d.mts +0 -79
  116. package/dist/core/resolve/coerce.mjs +0 -900
  117. package/dist/core/resolve/config.d.mts +0 -1
  118. package/dist/core/resolve/config.mjs +0 -19
  119. package/dist/core/resolve/contracts.d.mts +0 -145
  120. package/dist/core/resolve/errors.d.mts +0 -10
  121. package/dist/core/resolve/errors.mjs +0 -148
  122. package/dist/core/resolve/flags.d.mts +0 -47
  123. package/dist/core/resolve/flags.mjs +0 -246
  124. package/dist/core/resolve/index.d.mts +0 -44
  125. package/dist/core/resolve/index.mjs +0 -123
  126. package/dist/core/resolve/path-checks.d.mts +0 -47
  127. package/dist/core/resolve/path-checks.mjs +0 -102
  128. package/dist/core/resolve/redaction.d.mts +0 -12
  129. package/dist/core/resolve/redaction.mjs +0 -14
  130. package/dist/core/resolve/stages.d.mts +0 -85
  131. package/dist/core/resolve/stages.mjs +0 -170
  132. package/dist/core/resolve/standard.d.mts +0 -1
  133. package/dist/core/resolve/standard.mjs +0 -212
  134. package/dist/core/schema/activity.d.mts +0 -189
  135. package/dist/core/schema/arg.d.mts +0 -1451
  136. package/dist/core/schema/arg.mjs +0 -1139
  137. package/dist/core/schema/brand.d.mts +0 -17
  138. package/dist/core/schema/cardinality.d.mts +0 -301
  139. package/dist/core/schema/cardinality.mjs +0 -514
  140. package/dist/core/schema/command.d.mts +0 -1086
  141. package/dist/core/schema/command.mjs +0 -999
  142. package/dist/core/schema/flag.d.mts +0 -1487
  143. package/dist/core/schema/flag.mjs +0 -1207
  144. package/dist/core/schema/index.d.mts +0 -15
  145. package/dist/core/schema/index.mjs +0 -10
  146. package/dist/core/schema/middleware.d.mts +0 -126
  147. package/dist/core/schema/middleware.mjs +0 -41
  148. package/dist/core/schema/number-constraints.d.mts +0 -96
  149. package/dist/core/schema/number-constraints.mjs +0 -60
  150. package/dist/core/schema/prompt.d.mts +0 -135
  151. package/dist/core/schema/provenance.d.mts +0 -99
  152. package/dist/core/schema/provenance.mjs +0 -28
  153. package/dist/core/schema/run.d.mts +0 -161
  154. package/dist/core/schema/source.d.mts +0 -179
  155. package/dist/core/schema/source.mjs +0 -206
  156. package/dist/core/schema/standard.d.mts +0 -93
  157. package/dist/core/schema/standard.mjs +0 -15
  158. package/dist/core/schema/stdin.d.mts +0 -87
  159. package/dist/core/schema/stdin.mjs +0 -91
  160. package/dist/core/schema/string-constraints.d.mts +0 -108
  161. package/dist/core/schema/string-constraints.mjs +0 -86
  162. package/dist/core/schema/value-parsers.d.mts +0 -150
  163. package/dist/core/schema/value-parsers.mjs +0 -160
  164. package/dist/core/schema/value.d.mts +0 -242
  165. package/dist/core/schema/value.mjs +0 -573
  166. package/dist/core/testkit/index.d.mts +0 -56
  167. package/dist/core/testkit/index.mjs +0 -102
  168. package/dist/runtime/adapter.mjs +0 -92
  169. package/dist/runtime/auto.d.mts +0 -25
  170. package/dist/runtime/auto.mjs +0 -45
  171. package/dist/runtime/deno.d.mts +0 -99
  172. package/dist/runtime/deno.mjs +0 -265
  173. package/dist/runtime/detect.d.mts +0 -86
  174. package/dist/runtime/detect.mjs +0 -45
  175. package/dist/runtime/index.d.mts +0 -6
  176. package/dist/runtime/node.d.mts +0 -71
  177. package/dist/runtime/node.mjs +0 -228
  178. package/dist/runtime/paths.d.mts +0 -1
  179. package/dist/runtime/paths.mjs +0 -48
  180. package/dist/strings.d.mts +0 -12
  181. package/dist/strings.mjs +0 -22
  182. package/examples/basic.ts +0 -37
  183. package/examples/flag-types.ts +0 -79
  184. package/examples/gh/node_modules/typescript/LICENSE +0 -55
  185. package/examples/gh/node_modules/typescript/NOTICE.txt +0 -436
  186. package/examples/gh/node_modules/typescript/README.md +0 -49
  187. package/examples/gh/node_modules/typescript/bin/tsc +0 -2
  188. package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts +0 -529
  189. package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts.map +0 -1
  190. package/examples/gh/node_modules/typescript/dist/api/async/api.js +0 -1657
  191. package/examples/gh/node_modules/typescript/dist/api/async/api.js.map +0 -1
  192. package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts +0 -39
  193. package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts.map +0 -1
  194. package/examples/gh/node_modules/typescript/dist/api/async/client.js +0 -211
  195. package/examples/gh/node_modules/typescript/dist/api/async/client.js.map +0 -1
  196. package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts +0 -310
  197. package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts.map +0 -1
  198. package/examples/gh/node_modules/typescript/dist/api/async/types.js +0 -2
  199. package/examples/gh/node_modules/typescript/dist/api/async/types.js.map +0 -1
  200. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts +0 -109
  201. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts.map +0 -1
  202. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js +0 -2
  203. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js.map +0 -1
  204. package/examples/gh/node_modules/typescript/dist/api/fs.d.ts +0 -23
  205. package/examples/gh/node_modules/typescript/dist/api/fs.d.ts.map +0 -1
  206. package/examples/gh/node_modules/typescript/dist/api/fs.js +0 -109
  207. package/examples/gh/node_modules/typescript/dist/api/fs.js.map +0 -1
  208. package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts +0 -15
  209. package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts.map +0 -1
  210. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts +0 -5
  211. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts.map +0 -1
  212. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js +0 -74
  213. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js.map +0 -1
  214. package/examples/gh/node_modules/typescript/dist/api/node/encoder.js +0 -287
  215. package/examples/gh/node_modules/typescript/dist/api/node/encoder.js.map +0 -1
  216. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts +0 -32
  217. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts.map +0 -1
  218. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js +0 -213
  219. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js.map +0 -1
  220. package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts +0 -76
  221. package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts.map +0 -1
  222. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts +0 -182
  223. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts.map +0 -1
  224. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js +0 -835
  225. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js.map +0 -1
  226. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts +0 -62
  227. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts.map +0 -1
  228. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js +0 -122
  229. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js.map +0 -1
  230. package/examples/gh/node_modules/typescript/dist/api/node/node.js +0 -298
  231. package/examples/gh/node_modules/typescript/dist/api/node/node.js.map +0 -1
  232. package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts +0 -29
  233. package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts.map +0 -1
  234. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts +0 -4
  235. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts.map +0 -1
  236. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js +0 -241
  237. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js.map +0 -1
  238. package/examples/gh/node_modules/typescript/dist/api/node/protocol.js +0 -30
  239. package/examples/gh/node_modules/typescript/dist/api/node/protocol.js.map +0 -1
  240. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts +0 -6
  241. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts.map +0 -1
  242. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js +0 -61
  243. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js.map +0 -1
  244. package/examples/gh/node_modules/typescript/dist/api/options.d.ts +0 -32
  245. package/examples/gh/node_modules/typescript/dist/api/options.d.ts.map +0 -1
  246. package/examples/gh/node_modules/typescript/dist/api/options.js +0 -11
  247. package/examples/gh/node_modules/typescript/dist/api/options.js.map +0 -1
  248. package/examples/gh/node_modules/typescript/dist/api/path.d.ts +0 -110
  249. package/examples/gh/node_modules/typescript/dist/api/path.d.ts.map +0 -1
  250. package/examples/gh/node_modules/typescript/dist/api/path.js +0 -508
  251. package/examples/gh/node_modules/typescript/dist/api/path.js.map +0 -1
  252. package/examples/gh/node_modules/typescript/dist/api/proto.d.ts +0 -239
  253. package/examples/gh/node_modules/typescript/dist/api/proto.d.ts.map +0 -1
  254. package/examples/gh/node_modules/typescript/dist/api/proto.js +0 -37
  255. package/examples/gh/node_modules/typescript/dist/api/proto.js.map +0 -1
  256. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts +0 -79
  257. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts.map +0 -1
  258. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js +0 -169
  259. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js.map +0 -1
  260. package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts +0 -529
  261. package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts.map +0 -1
  262. package/examples/gh/node_modules/typescript/dist/api/sync/api.js +0 -1665
  263. package/examples/gh/node_modules/typescript/dist/api/sync/api.js.map +0 -1
  264. package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts +0 -30
  265. package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts.map +0 -1
  266. package/examples/gh/node_modules/typescript/dist/api/sync/client.js +0 -124
  267. package/examples/gh/node_modules/typescript/dist/api/sync/client.js.map +0 -1
  268. package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts +0 -310
  269. package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts.map +0 -1
  270. package/examples/gh/node_modules/typescript/dist/api/sync/types.js +0 -2
  271. package/examples/gh/node_modules/typescript/dist/api/sync/types.js.map +0 -1
  272. package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts +0 -114
  273. package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts.map +0 -1
  274. package/examples/gh/node_modules/typescript/dist/api/syncChannel.js +0 -508
  275. package/examples/gh/node_modules/typescript/dist/api/syncChannel.js.map +0 -1
  276. package/examples/gh/node_modules/typescript/dist/api/timing.d.ts +0 -175
  277. package/examples/gh/node_modules/typescript/dist/api/timing.d.ts.map +0 -1
  278. package/examples/gh/node_modules/typescript/dist/api/timing.js +0 -149
  279. package/examples/gh/node_modules/typescript/dist/api/timing.js.map +0 -1
  280. package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts +0 -100
  281. package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts.map +0 -1
  282. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts +0 -1161
  283. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts.map +0 -1
  284. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js +0 -4
  285. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js.map +0 -1
  286. package/examples/gh/node_modules/typescript/dist/ast/ast.js +0 -7
  287. package/examples/gh/node_modules/typescript/dist/ast/ast.js.map +0 -1
  288. package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts +0 -19
  289. package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts.map +0 -1
  290. package/examples/gh/node_modules/typescript/dist/ast/astnav.js +0 -596
  291. package/examples/gh/node_modules/typescript/dist/ast/astnav.js.map +0 -1
  292. package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts +0 -16
  293. package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts.map +0 -1
  294. package/examples/gh/node_modules/typescript/dist/ast/clone.js +0 -104
  295. package/examples/gh/node_modules/typescript/dist/ast/clone.js.map +0 -1
  296. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts +0 -520
  297. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts.map +0 -1
  298. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js +0 -3057
  299. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js.map +0 -1
  300. package/examples/gh/node_modules/typescript/dist/ast/index.d.ts +0 -20
  301. package/examples/gh/node_modules/typescript/dist/ast/index.d.ts.map +0 -1
  302. package/examples/gh/node_modules/typescript/dist/ast/index.js +0 -20
  303. package/examples/gh/node_modules/typescript/dist/ast/index.js.map +0 -1
  304. package/examples/gh/node_modules/typescript/dist/ast/is.d.ts +0 -35
  305. package/examples/gh/node_modules/typescript/dist/ast/is.d.ts.map +0 -1
  306. package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts +0 -329
  307. package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts.map +0 -1
  308. package/examples/gh/node_modules/typescript/dist/ast/is.generated.js +0 -1103
  309. package/examples/gh/node_modules/typescript/dist/ast/is.generated.js.map +0 -1
  310. package/examples/gh/node_modules/typescript/dist/ast/is.js +0 -233
  311. package/examples/gh/node_modules/typescript/dist/ast/is.js.map +0 -1
  312. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts +0 -11
  313. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts.map +0 -1
  314. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js +0 -202
  315. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js.map +0 -1
  316. package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts +0 -97
  317. package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts.map +0 -1
  318. package/examples/gh/node_modules/typescript/dist/ast/scanner.js +0 -2230
  319. package/examples/gh/node_modules/typescript/dist/ast/scanner.js.map +0 -1
  320. package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts +0 -17
  321. package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts.map +0 -1
  322. package/examples/gh/node_modules/typescript/dist/ast/utils.js +0 -67
  323. package/examples/gh/node_modules/typescript/dist/ast/utils.js.map +0 -1
  324. package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts +0 -14
  325. package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts.map +0 -1
  326. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts +0 -50
  327. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts.map +0 -1
  328. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js +0 -978
  329. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js.map +0 -1
  330. package/examples/gh/node_modules/typescript/dist/ast/visitor.js +0 -47
  331. package/examples/gh/node_modules/typescript/dist/ast/visitor.js.map +0 -1
  332. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts +0 -2
  333. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts.map +0 -1
  334. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts +0 -129
  335. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts.map +0 -1
  336. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js +0 -132
  337. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js.map +0 -1
  338. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js +0 -130
  339. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js.map +0 -1
  340. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts +0 -2
  341. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts.map +0 -1
  342. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts +0 -5
  343. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts.map +0 -1
  344. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js +0 -6
  345. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js.map +0 -1
  346. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js +0 -6
  347. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js.map +0 -1
  348. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts +0 -2
  349. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts.map +0 -1
  350. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts +0 -28
  351. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts.map +0 -1
  352. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js +0 -30
  353. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js.map +0 -1
  354. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js +0 -30
  355. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js.map +0 -1
  356. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts +0 -2
  357. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts.map +0 -1
  358. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts +0 -7
  359. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts.map +0 -1
  360. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js +0 -9
  361. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js.map +0 -1
  362. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js +0 -9
  363. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js.map +0 -1
  364. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts +0 -2
  365. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts.map +0 -1
  366. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts +0 -12
  367. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts.map +0 -1
  368. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js +0 -14
  369. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js.map +0 -1
  370. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js +0 -14
  371. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js.map +0 -1
  372. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts +0 -2
  373. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts.map +0 -1
  374. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts +0 -23
  375. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts.map +0 -1
  376. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js +0 -25
  377. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js.map +0 -1
  378. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js +0 -25
  379. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js.map +0 -1
  380. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts +0 -2
  381. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts.map +0 -1
  382. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts +0 -9
  383. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts.map +0 -1
  384. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js +0 -11
  385. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js.map +0 -1
  386. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js +0 -11
  387. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js.map +0 -1
  388. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts +0 -2
  389. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts.map +0 -1
  390. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts +0 -5
  391. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts.map +0 -1
  392. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js +0 -6
  393. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js.map +0 -1
  394. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js +0 -6
  395. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js.map +0 -1
  396. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts +0 -2
  397. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts.map +0 -1
  398. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts +0 -42
  399. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts.map +0 -1
  400. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js +0 -44
  401. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js.map +0 -1
  402. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js +0 -44
  403. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js.map +0 -1
  404. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts +0 -2
  405. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts.map +0 -1
  406. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts +0 -7
  407. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts.map +0 -1
  408. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js +0 -9
  409. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js.map +0 -1
  410. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js +0 -9
  411. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js.map +0 -1
  412. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts +0 -2
  413. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts.map +0 -1
  414. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts +0 -17
  415. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts.map +0 -1
  416. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js +0 -19
  417. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js.map +0 -1
  418. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js +0 -19
  419. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js.map +0 -1
  420. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts +0 -2
  421. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts.map +0 -1
  422. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts +0 -9
  423. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts.map +0 -1
  424. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js +0 -11
  425. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js.map +0 -1
  426. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js +0 -11
  427. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js.map +0 -1
  428. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts +0 -2
  429. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts.map +0 -1
  430. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts +0 -6
  431. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts.map +0 -1
  432. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js +0 -8
  433. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js.map +0 -1
  434. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js +0 -8
  435. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js.map +0 -1
  436. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts +0 -2
  437. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts.map +0 -1
  438. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts +0 -36
  439. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts.map +0 -1
  440. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js +0 -38
  441. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js.map +0 -1
  442. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js +0 -38
  443. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js.map +0 -1
  444. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts +0 -2
  445. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts.map +0 -1
  446. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts +0 -44
  447. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts.map +0 -1
  448. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js +0 -46
  449. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js.map +0 -1
  450. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js +0 -46
  451. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js.map +0 -1
  452. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts +0 -2
  453. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts.map +0 -1
  454. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts +0 -50
  455. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts.map +0 -1
  456. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js +0 -52
  457. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js.map +0 -1
  458. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js +0 -52
  459. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js.map +0 -1
  460. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts +0 -2
  461. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts.map +0 -1
  462. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts +0 -16
  463. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts.map +0 -1
  464. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js +0 -18
  465. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js.map +0 -1
  466. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js +0 -18
  467. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js.map +0 -1
  468. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts +0 -2
  469. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts.map +0 -1
  470. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts +0 -13
  471. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts.map +0 -1
  472. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js +0 -14
  473. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js.map +0 -1
  474. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js +0 -14
  475. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js.map +0 -1
  476. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts +0 -2
  477. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts.map +0 -1
  478. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts +0 -11
  479. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts.map +0 -1
  480. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js +0 -12
  481. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js.map +0 -1
  482. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js +0 -12
  483. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js.map +0 -1
  484. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts +0 -2
  485. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts.map +0 -1
  486. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts +0 -17
  487. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts.map +0 -1
  488. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js +0 -18
  489. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js.map +0 -1
  490. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js +0 -18
  491. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js.map +0 -1
  492. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts +0 -2
  493. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts.map +0 -1
  494. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts +0 -15
  495. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts.map +0 -1
  496. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js +0 -17
  497. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js.map +0 -1
  498. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js +0 -17
  499. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js.map +0 -1
  500. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts +0 -2
  501. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts.map +0 -1
  502. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts +0 -5
  503. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts.map +0 -1
  504. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js +0 -7
  505. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js.map +0 -1
  506. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js +0 -7
  507. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js.map +0 -1
  508. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts +0 -2
  509. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts.map +0 -1
  510. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts +0 -71
  511. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts.map +0 -1
  512. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js +0 -73
  513. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js.map +0 -1
  514. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js +0 -73
  515. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js.map +0 -1
  516. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts +0 -2
  517. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts.map +0 -1
  518. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts +0 -389
  519. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts.map +0 -1
  520. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js +0 -391
  521. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js.map +0 -1
  522. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js +0 -391
  523. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js.map +0 -1
  524. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts +0 -2
  525. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts.map +0 -1
  526. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts +0 -30
  527. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts.map +0 -1
  528. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js +0 -32
  529. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js.map +0 -1
  530. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js +0 -32
  531. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js.map +0 -1
  532. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts +0 -2
  533. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts.map +0 -1
  534. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts +0 -76
  535. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts.map +0 -1
  536. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js +0 -78
  537. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js.map +0 -1
  538. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js +0 -78
  539. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js.map +0 -1
  540. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts +0 -2
  541. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts.map +0 -1
  542. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts +0 -7
  543. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts.map +0 -1
  544. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js +0 -9
  545. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js.map +0 -1
  546. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js +0 -9
  547. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js.map +0 -1
  548. package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts +0 -23
  549. package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts.map +0 -1
  550. package/examples/gh/node_modules/typescript/dist/internal/utils.js +0 -25
  551. package/examples/gh/node_modules/typescript/dist/internal/utils.js.map +0 -1
  552. package/examples/gh/node_modules/typescript/lib/getExePath.d.ts +0 -2
  553. package/examples/gh/node_modules/typescript/lib/getExePath.js +0 -70
  554. package/examples/gh/node_modules/typescript/lib/tsc.js +0 -28
  555. package/examples/gh/node_modules/typescript/lib/version.cjs +0 -3
  556. package/examples/gh/node_modules/typescript/lib/version.d.cts +0 -2
  557. package/examples/gh/node_modules/typescript/package.json +0 -87
  558. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/License.txt +0 -11
  559. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/README.md +0 -54
  560. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.d.ts +0 -17
  561. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.js +0 -83
  562. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.d.ts +0 -22
  563. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.js +0 -210
  564. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.d.ts +0 -14
  565. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.js +0 -87
  566. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.d.ts +0 -32
  567. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.js +0 -132
  568. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.d.ts +0 -367
  569. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.js +0 -1271
  570. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.d.ts +0 -9
  571. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.js +0 -16
  572. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.d.ts +0 -52
  573. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.js +0 -70
  574. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.d.ts +0 -39
  575. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.js +0 -135
  576. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.d.ts +0 -7
  577. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.js +0 -34
  578. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.d.ts +0 -55
  579. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.js +0 -412
  580. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.d.ts +0 -18
  581. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.js +0 -155
  582. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.d.ts +0 -77
  583. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.js +0 -246
  584. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.d.ts +0 -60
  585. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.js +0 -157
  586. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.d.ts +0 -369
  587. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.js +0 -436
  588. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.d.ts +0 -74
  589. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.js +0 -23
  590. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.d.ts +0 -10
  591. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.js +0 -74
  592. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.d.ts +0 -15
  593. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.js +0 -77
  594. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.d.ts +0 -58
  595. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.js +0 -289
  596. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.d.ts +0 -12
  597. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.js +0 -163
  598. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/package.json +0 -54
  599. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/typings/thenable.d.ts +0 -5
  600. package/examples/gh/package.json +0 -45
  601. package/examples/gh/src/commands/auth.ts +0 -66
  602. package/examples/gh/src/commands/issue.ts +0 -120
  603. package/examples/gh/src/commands/pr.ts +0 -125
  604. package/examples/gh/src/data/issues.yaml +0 -5
  605. package/examples/gh/src/data/issues.yaml.d.ts +0 -17
  606. package/examples/gh/src/data/pull-requests.yaml +0 -7
  607. package/examples/gh/src/data/pull-requests.yaml.d.ts +0 -18
  608. package/examples/gh/src/docs.ts +0 -11
  609. package/examples/gh/src/lib/auth.ts +0 -37
  610. package/examples/gh/src/lib/utils.ts +0 -17
  611. package/examples/gh/src/main.test.ts +0 -307
  612. package/examples/gh/src/main.ts +0 -46
  613. package/examples/help-config.ts +0 -43
  614. package/examples/interactive.ts +0 -67
  615. package/examples/json-mode.ts +0 -95
  616. package/examples/middleware.ts +0 -71
  617. package/examples/multi-command.ts +0 -66
  618. package/examples/output-extras.ts +0 -46
  619. package/examples/parser-control.ts +0 -40
  620. package/examples/pwsh-demo/README.md +0 -40
  621. package/examples/pwsh-demo/package.json +0 -41
  622. package/examples/pwsh-demo/pwsh-demo.cmd +0 -3
  623. package/examples/pwsh-demo/smoke-powershell.ps1 +0 -218
  624. package/examples/pwsh-demo/src/main.test.ts +0 -45
  625. package/examples/pwsh-demo/src/main.ts +0 -140
  626. package/examples/spinner-progress.ts +0 -49
  627. package/examples/standard-schema.ts +0 -45
  628. package/examples/testing.ts +0 -147
  629. package/examples/transport-launcher.ts +0 -85
@@ -1,1086 +0,0 @@
1
- import { schemaBrand } from "./brand.mjs";
2
- import { Verbosity } from "../output/contracts.mjs";
3
- import { ProgressHandle, ProgressOptions, SpinnerHandle, SpinnerOptions, TableColumn, TableOptions } from "./activity.mjs";
4
- import { PromptConfig } from "./prompt.mjs";
5
- import { FlagBuilder, FlagConfig, FlagDefinition, FlagSchema, InferFlags } from "./flag.mjs";
6
- import { ArgBuilder, ArgConfig, ArgDefinition, ArgSchema, InferArgs } from "./arg.mjs";
7
- import { ErasedMiddlewareHandler, Middleware } from "./middleware.mjs";
8
- import { InputSources } from "./provenance.mjs";
9
- import { Colors } from "ansispeck";
10
- //#region src/core/schema/command.d.ts
11
- /**
12
- * Widen the context type when adding middleware.
13
- *
14
- * The default `C = Record<string, never>` uses an index signature where
15
- * every key maps to `never` — making property access a type error until
16
- * middleware extends it. Naive intersection (`Record<string, never> & { user: string }`)
17
- * collapses all properties to `never` because `never & T = never`.
18
- *
19
- * This utility replaces `Record<string, never>` entirely on the first
20
- * `.middleware()` call. Subsequent calls use plain intersection.
21
- */
22
- type WidenContext<C extends Record<string, unknown>, Output extends Record<string, unknown>> = C extends Record<string, never> ? Output : C & Output;
23
- /**
24
- * Widen the context type when adding command-scoped derived context.
25
- *
26
- * Validation-only derive handlers return `undefined` (or nothing), preserving `C`.
27
- * Context-producing derive handlers return an object that merges into `C`
28
- * using the same first-call replacement rules as middleware.
29
- */
30
- type WidenDerivedContext<C extends Record<string, unknown>, Output> = Awaited<Output> extends Record<string, unknown> ? WidenContext<C, Awaited<Output>> : C;
31
- /**
32
- * Parameters received by the interactive resolver function.
33
- *
34
- * `flags` contains partially resolved values — present for flags resolved
35
- * via CLI, env, or config, `undefined` for unresolved flags. The resolver
36
- * uses this to decide which prompts to show based on current state.
37
- */
38
- interface InteractiveParams<F extends Record<string, FlagBuilder<FlagConfig>>> {
39
- /** Partially resolved flag values (after CLI/env/config, before prompts). */
40
- readonly flags: Readonly<Partial<InferFlags<F>>>;
41
- }
42
- /**
43
- * A record mapping flag names to prompt configs or falsy values.
44
- *
45
- * - `PromptConfig` — show this prompt for the flag
46
- * - `false | undefined | null | 0 | ''` — skip prompting for this flag
47
- *
48
- * Only flag names that need prompting should have truthy values.
49
- * Flags not mentioned are handled by their per-flag `.prompt()` config.
50
- */
51
- type InteractiveResult = Readonly<Record<string, PromptConfig | false | undefined | null | 0 | "">>;
52
- /**
53
- * Interactive resolver function for command-level prompt control.
54
- *
55
- * Called after CLI/env/config resolution but before per-flag prompts fire.
56
- * Receives partially resolved values and returns a prompt schema for
57
- * flags that should be prompted. Commands without `.interactive()` use
58
- * per-flag prompt configs directly.
59
- *
60
- * @example
61
- * ```ts
62
- * import { command, flag } from '@kjanat/dreamcli';
63
- *
64
- * const deploy = command('deploy')
65
- * .flag('region', flag.enum(['us', 'eu', 'ap']))
66
- * .interactive(({ flags }) => ({
67
- * region: !flags.region && {
68
- * kind: 'select',
69
- * message: 'Select region',
70
- * },
71
- * }))
72
- * .action(({ flags, out }) => {
73
- * out.log(`Deploying to ${flags.region}`);
74
- * });
75
- * ```
76
- */
77
- type InteractiveResolver<F extends Record<string, FlagBuilder<FlagConfig>>> = (params: InteractiveParams<F>) => InteractiveResult;
78
- /**
79
- * Type-erased interactive resolver stored on {@linkcode CommandSchema}.
80
- *
81
- * Advanced bridge type: most consumers should use {@link InteractiveResolver}
82
- * via {@linkcode command | command().interactive()} and never reference this alias directly.
83
- *
84
- * At runtime, the resolver receives `{ flags: Record<string, unknown> }`
85
- * and returns `Record<string, PromptConfig | falsy>`. The phantom types
86
- * from `CommandBuilder<F, A>` are erased.
87
- */
88
- type ErasedInteractiveResolver = (params: {
89
- readonly flags: Readonly<Record<string, unknown>>;
90
- }) => InteractiveResult;
91
- /**
92
- * Output channel available inside action handlers.
93
- *
94
- * Provides structured methods for stdout/stderr, JSON output,
95
- * spinners, progress bars, and tables. The real implementation lives in
96
- * `src/core/output/`; this interface defines the shape that handlers consume.
97
- *
98
- * `Out` is a framework-created, non-exhaustive value: obtain instances from
99
- * action parameters, `createOutput()`, or `createCaptureOutput()` — do not
100
- * implement it. New readonly members may be added in minor releases.
101
- */
102
- interface Out {
103
- /** Framework-construction seal. Obtain `Out` values from DreamCLI; do not implement this interface. */
104
- readonly [outBrand]: never;
105
- /** Write to stdout (normal output). */
106
- log(message: string): void;
107
- /** Informational (may be suppressed in quiet mode). */
108
- info(message: string): void;
109
- /**
110
- * Status line to stderr, suppressed in quiet mode.
111
- *
112
- * Keeps stdout clean for piping; for success and progress notes like
113
- * `Wrote <path>` that scripts silence with `--quiet`.
114
- */
115
- status(message: string): void;
116
- /** Warning to stderr. */
117
- warn(message: string): void;
118
- /** Error to stderr. */
119
- error(message: string): void;
120
- /**
121
- * Request a process exit code without emitting error-shaped output.
122
- *
123
- * Use this for check/status commands that should print normal output but
124
- * still signal a non-zero status to scripts. This does not stop execution;
125
- * later calls overwrite earlier calls, and thrown errors still win.
126
- */
127
- setExitCode(code: number): void;
128
- /**
129
- * Emit a structured JSON value to stdout.
130
- *
131
- * Always serialises `value` as JSON to stdout regardless of output
132
- * mode. Prefer this over `log(JSON.stringify(...))` so the output
133
- * channel can enforce consistent formatting and future features
134
- * (pretty-print in TTY, streaming JSON, etc.).
135
- */
136
- json(value: unknown): void;
137
- /**
138
- * Whether the output channel is in JSON mode (`--json` flag active).
139
- *
140
- * Handlers can check this to skip decorative output (spinners,
141
- * progress bars, ANSI formatting) when machine-readable output is
142
- * expected.
143
- */
144
- readonly jsonMode: boolean;
145
- /**
146
- * Active output verbosity for this command execution.
147
- *
148
- * Root `--quiet`/`-q` resolves to `'quiet'`. Most handlers should emit
149
- * informational output through {@linkcode Out.info | info()},
150
- * {@linkcode Out.status | status()}, {@linkcode Out.spinner | spinner()},
151
- * or {@linkcode Out.progress | progress()} and let the channel suppress it
152
- * automatically. Read this property only when custom rendering or expensive
153
- * optional work genuinely depends on the active verbosity.
154
- */
155
- readonly verbosity: Verbosity;
156
- /**
157
- * Whether stdout is connected to a TTY (terminal).
158
- *
159
- * Handlers can check this to decide whether to emit decorative output
160
- * (spinners, progress bars, ANSI color codes). When `false`, the output
161
- * is being piped or redirected — skip interactive decorations.
162
- *
163
- * Note: `jsonMode` takes precedence — when `jsonMode` is `true`,
164
- * decorative output should be suppressed regardless of `isTTY`.
165
- */
166
- readonly isTTY: boolean;
167
- /**
168
- * Context-aware ANSI color palette (powered by `ansispeck`).
169
- *
170
- * Colors are enabled only when stdout is a TTY, JSON mode is off, and the
171
- * environment supports color (`NO_COLOR`, `FORCE_COLOR`, `--no-color`,
172
- * `--color`, `CI` are respected). When disabled, every formatter is an
173
- * identity function — `out.color.red('x')` returns `'x'` — so handlers can
174
- * style unconditionally without gating on `isTTY`/`jsonMode` themselves.
175
- *
176
- * @example
177
- * ```ts
178
- * .action(({ out }) => {
179
- * out.log(`${out.color.green('✔')} deployed ${out.color.bold('api')}`);
180
- * });
181
- * ```
182
- */
183
- readonly color: Colors;
184
- /**
185
- * Whether OSC 8 terminal hyperlinks should be emitted.
186
- *
187
- * Honors `NO_HYPERLINKS`/`FORCE_HYPERLINKS` and the
188
- * `--no-hyperlinks`/`--hyperlinks` argv flags, falling back to `isTTY`.
189
- * Handlers rendering their own `out.color.link(...)` output can gate on
190
- * this to keep OSC 8 escapes out of piped or opted-out contexts.
191
- */
192
- readonly isHyperlinkSupported: boolean;
193
- /**
194
- * Render tabular data.
195
- *
196
- * - **TTY mode** (non-JSON): Pretty-print aligned columns with headers.
197
- * - **JSON mode** (`--json`): Emit the rows as a JSON array to stdout.
198
- * - **Piped** (non-TTY, non-JSON): Same aligned text output as TTY
199
- * (useful for `grep`, `awk`, etc.).
200
- * - Pass `{ format: 'text', stream: 'stderr' }` to keep a human-readable
201
- * side channel while `json()` writes machine output to stdout.
202
- *
203
- * When `columns` is omitted, columns are auto-inferred from the keys
204
- * of the first row. Column headers default to the key name.
205
- *
206
- * When `columns` is provided, both text and JSON output are projected to
207
- * only the listed keys.
208
- *
209
- * @param rows - Array of row objects.
210
- */
211
- table<T extends Record<string, unknown>>(rows: readonly T[], options: TableOptions): void;
212
- /**
213
- * Render tabular data with explicit column selection.
214
- *
215
- * @param rows - Array of row objects.
216
- * @param columns - Column descriptors controlling which keys are shown and header labels.
217
- * @param options - Per-call rendering options (format, stream).
218
- */
219
- table<T extends Record<string, unknown>>(rows: readonly T[], columns?: readonly TableColumn<T>[], options?: TableOptions): void;
220
- /**
221
- * Create a spinner for indeterminate progress feedback.
222
- *
223
- * Returns a no-op handle in quiet or JSON mode. Otherwise, non-TTY output
224
- * uses a no-op handle or the configured static fallback.
225
- *
226
- * @param text - Initial spinner text.
227
- * @param options - Fallback strategy for non-TTY environments.
228
- * @returns A {@link SpinnerHandle} for lifecycle control.
229
- */
230
- spinner(text: string, options?: SpinnerOptions): SpinnerHandle;
231
- /**
232
- * Create a progress bar for measured work.
233
- *
234
- * Returns a no-op handle in quiet or JSON mode. Otherwise, pass `total` for
235
- * determinate mode (percentage bar); omit for indeterminate (pulsing).
236
- *
237
- * @param options - Progress configuration (total, label, fallback).
238
- * @returns A {@link ProgressHandle} for updating progress.
239
- */
240
- progress(options: ProgressOptions): ProgressHandle;
241
- /**
242
- * Stop the currently active spinner or progress handle, if any.
243
- *
244
- * TTY spinner and progress handles start `setInterval` timers that
245
- * prevent the process from exiting until a terminal method (`stop`,
246
- * `succeed`, `fail`, `done`) is called. If a handler throws before
247
- * reaching that call, the timer leaks and the process hangs.
248
- *
249
- * Call `stopActive()` in a `finally` block after handler execution
250
- * to guarantee cleanup. It is idempotent — safe to call when no
251
- * handle is active, or when the handle was already stopped.
252
- *
253
- * The framework calls this automatically in `runCommand()` and
254
- * `cli().run()`. Direct users of `createOutput()` should call it
255
- * themselves after the handler returns or throws.
256
- *
257
- * @example
258
- * ```ts
259
- * const out = createOutput({ isTTY: true });
260
- * try {
261
- * await handler({ out });
262
- * } finally {
263
- * out.stopActive();
264
- * }
265
- * ```
266
- */
267
- stopActive(): void;
268
- }
269
- /**
270
- * Runtime metadata about the CLI program and current command execution.
271
- *
272
- * Available to action handlers and middleware.
273
- *
274
- * Populated by the CLI dispatch layer from {@link CLISchema} and
275
- * {@link CommandSchema}. For standalone `runCommand()` calls without
276
- * a CLI wrapper, a minimal meta is constructed from the command's own schema.
277
- */
278
- interface CommandMeta {
279
- /** CLI program name (from `cli('name')` or package.json inference). */
280
- readonly name: string;
281
- /** Binary display name used in help/usage (may differ from `name`). */
282
- readonly bin: string;
283
- /** Program version, if set via `.version()` or discovered from package.json. */
284
- readonly version: string | undefined;
285
- /** The leaf command name currently being executed. */
286
- readonly command: string;
287
- }
288
- /**
289
- * The bag of values received by an action handler.
290
- *
291
- * - `args`: fully resolved positional arguments
292
- * - `flags`: fully resolved flags
293
- * - `sources`: which stage produced each of those values
294
- * - `ctx`: derive/middleware-provided context
295
- * - `out`: output channel
296
- * - `meta`: CLI program metadata (name, bin, version, command)
297
- *
298
- * The `C` parameter defaults to `Record<string, never>`, making `ctx`
299
- * property access a type error until derive or middleware extends it.
300
- */
301
- interface ActionParams<F extends Record<string, FlagBuilder<FlagConfig>>, A extends Record<string, ArgBuilder<ArgConfig>>, C extends Record<string, unknown> = Record<string, never>> {
302
- /** Fully resolved positional argument values, typed from `.arg()` definitions. */
303
- readonly args: Readonly<InferArgs<A>>;
304
- /** Fully resolved flag values, typed from `.flag()` definitions. */
305
- readonly flags: Readonly<InferFlags<F>>;
306
- /**
307
- * Where each resolved value came from, keyed like `flags` and `args`.
308
- *
309
- * An input that resolved no value has no record. {@link wasExplicit} answers
310
- * the explicit-versus-defaulted question; read `stage` for the rest.
311
- */
312
- readonly sources: InputSources<F, A>;
313
- /** Middleware/derive-provided context, typed from `.middleware()` and `.derive()` chains. */
314
- readonly ctx: Readonly<C>;
315
- /** Structured output channel for stdout, stderr, JSON, tables, and spinners. */
316
- readonly out: Out;
317
- /** Runtime metadata about the CLI program and current command. */
318
- readonly meta: CommandMeta;
319
- }
320
- /**
321
- * Action handler function signature.
322
- *
323
- * May be sync or async — the framework will `await` the return value
324
- * regardless. The `C` parameter carries the accumulated middleware
325
- * context type (defaults to empty).
326
- */
327
- type ActionHandler<F extends Record<string, FlagBuilder<FlagConfig>>, A extends Record<string, ArgBuilder<ArgConfig>>, C extends Record<string, unknown> = Record<string, never>> = (params: ActionParams<F, A, C>) => void | Promise<void>;
328
- /**
329
- * Type-erased action handler stored on {@linkcode CommandBuilder}.
330
- *
331
- * The typed {@linkcode ActionHandler} from `.action()` is cast to this
332
- * erased form at the type-erasure boundary, keeping {@linkcode CommandBuilder}
333
- * covariant in its generic parameters. This enables structural
334
- * compatibility across TypeScript declaration-file boundaries where
335
- * generic inference may fall back to constraint types.
336
- *
337
- * Follows the same erasure pattern as {@link ErasedDeriveHandler} and
338
- * {@link ErasedMiddlewareHandler}.
339
- */
340
- type ErasedActionHandler = (params: {
341
- readonly args: Readonly<Record<string, unknown>>;
342
- readonly flags: Readonly<Record<string, unknown>>;
343
- readonly sources: ErasedInputSources;
344
- readonly ctx: Readonly<Record<string, unknown>>;
345
- readonly out: Out;
346
- readonly meta: CommandMeta;
347
- }) => void | Promise<void>;
348
- /**
349
- * The provenance bag as the execution seam carries it, before a handler's own
350
- * flag and arg names type it.
351
- */
352
- type ErasedInputSources = InputSources<Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>;
353
- /**
354
- * The bag of values received by a derive handler.
355
- *
356
- * Identical to {@link ActionParams}: derives run after full resolution and
357
- * before the action handler, with typed args, flags, provenance, and current
358
- * context plus `out` and `meta`.
359
- */
360
- type DeriveParams<F extends Record<string, FlagBuilder<FlagConfig>>, A extends Record<string, ArgBuilder<ArgConfig>>, C extends Record<string, unknown> = Record<string, never>> = ActionParams<F, A, C>;
361
- /**
362
- * Command-scoped typed pre-action handler.
363
- *
364
- * Derive handlers may:
365
- * - validate resolved input and throw {@linkcode CLIError}
366
- * - return nothing (or `undefined`) to continue without changing context
367
- * - return an object whose properties merge into `ctx` downstream
368
- *
369
- * Handlers may be async; the resolved value follows the same rules.
370
- * They cannot wrap downstream execution; use {@linkcode middleware} for that.
371
- */
372
- type DeriveHandler<F extends Record<string, FlagBuilder<FlagConfig>>, A extends Record<string, ArgBuilder<ArgConfig>>, C extends Record<string, unknown> = Record<string, never>, Output extends Record<string, unknown> | undefined = undefined> = (params: DeriveParams<F, A, C>) => Output | Promise<Output> | void | Promise<void>;
373
- /**
374
- * Type-erased derive handler stored on the command builder.
375
- */
376
- type ErasedDeriveHandler = (params: {
377
- readonly args: Readonly<Record<string, unknown>>;
378
- readonly flags: Readonly<Record<string, unknown>>;
379
- readonly sources: ErasedInputSources;
380
- readonly ctx: Readonly<Record<string, unknown>>;
381
- readonly out: Out;
382
- readonly meta: CommandMeta;
383
- }) => undefined | Readonly<Record<string, unknown>> | Promise<undefined | Readonly<Record<string, unknown>>>;
384
- /**
385
- * Internal execution step union preserving registration order across
386
- * {@linkcode CommandBuilder.derive | derive()} and {@linkcode CommandBuilder.middleware | middleware()}.
387
- */
388
- type ExecutionStep = {
389
- readonly kind: "derive";
390
- readonly handler: ErasedDeriveHandler;
391
- } | {
392
- readonly kind: "middleware";
393
- readonly handler: ErasedMiddlewareHandler;
394
- };
395
- /**
396
- * Program metadata passed to a function-form example, resolved at render time.
397
- *
398
- * `name` is the actually-invoked program name (`options.help.binName`, falling
399
- * back to the command name) so examples stay truthful under symlinks,
400
- * `inheritName`, and `npx x` vs a global install. `version` is the program
401
- * version, or `undefined` when none is configured.
402
- */
403
- interface ExampleMeta {
404
- readonly name: string;
405
- readonly version: string | undefined;
406
- }
407
- /**
408
- * An example command line: a literal string, or a function resolved at render
409
- * time with the program {@link ExampleMeta} (so the program name need not be
410
- * hardcoded).
411
- */
412
- type ExampleCommand = string | ((meta: ExampleMeta) => string);
413
- /** A single usage example shown in help text. */
414
- interface CommandExample {
415
- /** The command invocation (e.g. `'deploy production --force'`). */
416
- readonly command: ExampleCommand;
417
- /** Optional description of what this example does. */
418
- readonly description?: string;
419
- }
420
- /** Resolve an {@link ExampleCommand} to its string form for the given meta. */
421
- declare function resolveExampleCommand(command: ExampleCommand, meta: ExampleMeta): string;
422
- /**
423
- * Runtime descriptor produced by {@link CommandBuilder}.
424
- *
425
- * Consumers (parser, help generator, CLI dispatcher) read this to
426
- * understand the command's shape — flags, args, aliases, subcommands,
427
- * and interactive resolver.
428
- */
429
- interface CommandSchema {
430
- /** Type-only seal produced by {@link createCommandSchema}. */
431
- readonly [schemaBrand]: "command";
432
- /** The command name (used for dispatch, e.g. `'deploy'`). */
433
- readonly name: string;
434
- /** Human-readable description for help text. */
435
- readonly description: string | undefined;
436
- /** Alternative names for this command. */
437
- readonly aliases: readonly string[];
438
- /** Whether this command is hidden from help listings. */
439
- readonly hidden: boolean;
440
- /** Usage examples for help text. */
441
- readonly examples: readonly CommandExample[];
442
- /** Named flag schemas, keyed by flag name. */
443
- readonly flags: Readonly<Record<string, FlagSchema>>;
444
- /** Ordered positional arg entries (name + schema). */
445
- readonly args: readonly CommandArgEntry[];
446
- /** Whether an action handler has been registered. */
447
- readonly hasAction: boolean;
448
- /**
449
- * Command-level interactive resolver for schema-driven prompt control.
450
- *
451
- * When set, called after CLI/env/config resolution with partially resolved
452
- * flag values. Returns prompt configs for flags that need interactive input.
453
- * Takes precedence over per-flag `.prompt()` configs for flags it returns
454
- * configs for; flags not mentioned fall back to their per-flag configs.
455
- *
456
- * @see InteractiveResolver
457
- */
458
- readonly interactive: ErasedInteractiveResolver | undefined;
459
- /**
460
- * Nested subcommand schemas (for help rendering and completion).
461
- *
462
- * Pure data — no execution closures. Populated by `.command()` on
463
- * `CommandBuilder`. Empty for leaf commands.
464
- */
465
- readonly commands: readonly CommandSchema[];
466
- }
467
- /**
468
- * A named positional argument entry in the command schema.
469
- *
470
- * Pairs a user-facing arg name with its {@link ArgSchema} descriptor.
471
- * The array ordering in {@link CommandSchema.args} determines CLI position.
472
- */
473
- interface CommandArgEntry {
474
- /** User-facing argument name (shown in help as `<name>`). */
475
- readonly name: string;
476
- /** Runtime descriptor controlling parsing, presence, and coercion. */
477
- readonly schema: ArgSchema;
478
- }
479
- /**
480
- * A named positional argument entry accepted by {@link createCommandSchema}.
481
- *
482
- * The schema may be an {@link ArgDefinition} or an already-built {@link ArgSchema}.
483
- */
484
- interface CommandArgEntryDefinition {
485
- /** User-facing argument name (shown in help as `<name>`). */
486
- readonly name: string;
487
- /** Arg definition or an already-built schema. */
488
- readonly schema: ArgDefinition | ArgSchema;
489
- }
490
- /**
491
- * Input shape accepted by {@link createCommandSchema}.
492
- *
493
- * Every field except `name` is optional. Flags, args, and subcommands accept
494
- * either definitions or already-built schemas.
495
- */
496
- interface CommandDefinition {
497
- /** The command name used for dispatch. */
498
- readonly name: string;
499
- /**
500
- * Human-readable description for help text.
501
- * @defaultValue `undefined`
502
- */
503
- readonly description?: string | undefined;
504
- /**
505
- * Alternative names for this command.
506
- * @defaultValue `[]`
507
- */
508
- readonly aliases?: readonly string[] | undefined;
509
- /**
510
- * Whether this command is hidden from help listings.
511
- * @defaultValue `false`
512
- */
513
- readonly hidden?: boolean | undefined;
514
- /**
515
- * Usage examples for help text.
516
- * @defaultValue `[]`
517
- */
518
- readonly examples?: readonly CommandExample[] | undefined;
519
- /**
520
- * Flag definitions or built schemas, keyed by flag name.
521
- * @defaultValue `{}`
522
- */
523
- readonly flags?: Readonly<Record<string, FlagDefinition | FlagSchema>> | undefined;
524
- /**
525
- * Ordered positional arg entries.
526
- * @defaultValue `[]`
527
- */
528
- readonly args?: readonly CommandArgEntryDefinition[] | undefined;
529
- /**
530
- * Whether an action handler has been registered.
531
- * @defaultValue `false`
532
- */
533
- readonly hasAction?: boolean | undefined;
534
- /**
535
- * Command-level interactive resolver.
536
- * @defaultValue `undefined`
537
- */
538
- readonly interactive?: ErasedInteractiveResolver | undefined;
539
- /**
540
- * Nested subcommand definitions or built schemas.
541
- * @defaultValue `[]`
542
- */
543
- readonly commands?: readonly (CommandDefinition | CommandSchema)[] | undefined;
544
- }
545
- /**
546
- * Create a {@link CommandSchema} from a plain definition object.
547
- *
548
- * Most consumers should prefer {@link command | command()}, which returns a
549
- * {@link CommandBuilder} with type inference. `createCommandSchema()` is the
550
- * low-level escape hatch for tooling that composes schemas as data.
551
- *
552
- * Flags, args, and subcommands are normalized recursively, so an already-built
553
- * schema fed back in produces a deep-equal schema.
554
- *
555
- * Flag spellings are checked across the whole tree, so a definition whose names,
556
- * aliases, or negated spellings collide with each other or with a propagated
557
- * ancestor flag is rejected here. Both flags still parse under their canonical
558
- * names, so what a collision costs is the shared spelling. Help advertises it on
559
- * both flags and the parser answers it with one of them.
560
- * Args go through the same invariants {@link CommandBuilder.arg} enforces.
561
- * These are the checks the {@link CommandBuilder} applies as flags, args, and
562
- * subcommands are registered.
563
- *
564
- * @param definition - Command name plus optional flags, args, and subcommands.
565
- * @returns A fully populated {@link CommandSchema}.
566
- * @throws {CLIError} With code `'INVALID_SCHEMA'` when a name at any depth is
567
- * empty or contains whitespace, a flag or arg at any depth is named
568
- * `__proto__`, which JavaScript cannot carry as a plain record key, or a flag
569
- * record at any depth has a
570
- * replaced prototype, which hides the entries a name check would read.
571
- * @throws {CLIError} With code `'FLAG_NAME_COLLISION'` when two flags on one
572
- * command share a spelling.
573
- * @throws {CLIError} With code `'PROPAGATED_FLAG_COLLISION'` when a flag shadows
574
- * a spelling propagated from an ancestor command.
575
- * @throws {CLIError} With code `'INVALID_BUILDER_STATE'` when a positional comes
576
- * after a variadic one, or `'DUPLICATE_STDIN_INPUT'` when two inputs on one
577
- * command consume stdin and either is exclusive.
578
- *
579
- * @example
580
- * ```ts
581
- * const schema = createCommandSchema({
582
- * name: 'deploy',
583
- * description: 'Ship the build',
584
- * flags: { force: { kind: 'boolean' } },
585
- * args: [{ name: 'target', schema: { kind: 'string' } }],
586
- * });
587
- * ```
588
- */
589
- declare function createCommandSchema(definition: CommandDefinition): CommandSchema;
590
- /**
591
- * Type-erased {@link CommandBuilder} for heterogeneous subcommand storage.
592
- *
593
- * Advanced helper alias: useful only when working on DreamCLI internals or
594
- * custom tooling that mirrors the framework's type-erasure boundary.
595
- *
596
- * Uses widest possible generic bounds so any `CommandBuilder<F, A, C>` is
597
- * assignable. The CLI layer's `compileCommand()` traverses these to build
598
- * the execution graph.
599
- *
600
- */
601
- type AnyCommandBuilder = CommandBuilder<Record<string, FlagBuilder<FlagConfig>>, Record<string, ArgBuilder<ArgConfig>>, Record<string, unknown>>;
602
- /**
603
- * Immutable command schema builder.
604
- *
605
- * The type parameters `F` (flags), `A` (args), and `C` (context) are
606
- * phantom types that accumulate builder types as `.flag()`, `.arg()`,
607
- * `.derive()`, and `.middleware()` are chained. The `.action()` handler receives
608
- * fully typed `ActionParams<F, A, C>`.
609
- *
610
- * `C` defaults to `Record<string, never>`, making `ctx` property
611
- * access a type error until derive or middleware extends it.
612
- *
613
- * @example
614
- * ```ts
615
- * const deploy = command('deploy')
616
- * .description('Deploy to an environment')
617
- * .arg('target', arg.string().describe('Deploy target'))
618
- * .flag('force', flag.boolean().alias('f'))
619
- * .flag('region', flag.enum(['us', 'eu', 'ap']))
620
- * .action(async ({ args, flags, out }) => {
621
- * // args.target: string
622
- * // flags.force: boolean
623
- * // flags.region: 'us' | 'eu' | 'ap' | undefined
624
- * out.log(`Deploying ${args.target}...`);
625
- * });
626
- * ```
627
- */
628
- declare class CommandBuilder<F extends Record<string, FlagBuilder<FlagConfig>> = {}, A extends Record<string, ArgBuilder<ArgConfig>> = {}, C extends Record<string, unknown> = Record<string, never>> {
629
- /**
630
- * Create a command builder from a pre-built schema descriptor.
631
- *
632
- * @param schema - Runtime command descriptor.
633
- * @param handler - Action handler, if registered.
634
- * @param subcommands - Nested sub-command builders (type-erased).
635
- * @param executionSteps - Derive/middleware steps in registration order.
636
- */
637
- constructor(schema: CommandSchema, handler?: ErasedActionHandler, subcommands?: readonly AnyCommandBuilder[], executionSteps?: readonly ExecutionStep[]);
638
- /**
639
- * Register a command-level interactive resolver for schema-driven prompts.
640
- *
641
- * The resolver is called after CLI/env/config resolution with partially
642
- * resolved flag values. It returns a prompt schema for flags that need
643
- * interactive input based on the current state.
644
- *
645
- * For flags the resolver returns a {@linkcode PromptConfig}, that config is used
646
- * instead of any per-flag `.prompt()` config. For flags returned as falsy
647
- * (or not mentioned), per-flag `.prompt()` configs are used as fallback.
648
- *
649
- * Commands without `.interactive()` use per-flag prompt configs directly.
650
- *
651
- * @example
652
- * ```ts
653
- * const deploy = command('deploy')
654
- * .flag('region', flag.enum(['us', 'eu', 'ap']))
655
- * .flag('force', flag.boolean())
656
- * .interactive(({ flags }) => ({
657
- * region: !flags.region && {
658
- * kind: 'select',
659
- * message: 'Select region',
660
- * },
661
- * }))
662
- * .action(({ flags }) => { ... });
663
- * ```
664
- *
665
- * @param resolver - Function receiving partially resolved flags and returning prompt configs.
666
- * @returns The builder (for chaining).
667
- */
668
- interactive(resolver: InteractiveResolver<F>): CommandBuilder<F, A, C>;
669
- /**
670
- * Register a command-scoped typed pre-action handler.
671
- *
672
- * Derive runs after full resolution and before the action handler.
673
- * It receives typed `{ args, flags, ctx, out, meta }` and may either:
674
- *
675
- * - return nothing (or `undefined`) for validation-only behavior
676
- * - return an object to merge additional properties into `ctx`
677
- *
678
- * Handlers may be async — the runtime awaits them before continuing.
679
- *
680
- * Unlike middleware, derive cannot wrap downstream execution and does not
681
- * use `next()`. Use {@linkcode middleware} for timing, logging, retries, cleanup,
682
- * or error-boundary patterns.
683
- *
684
- * Adding derive drops the current handler (like `.flag()`, `.arg()`, and
685
- * `.middleware()`) because the action handler's `ctx` type may change.
686
- *
687
- * @example
688
- * ```ts
689
- * command('deploy')
690
- * .flag('token', flag.string().env('AUTH_TOKEN'))
691
- * .derive(({ flags }) => {
692
- * if (!flags.token) {
693
- * throw new CLIError('Not authenticated', {
694
- * code: 'AUTH_REQUIRED',
695
- * suggest: 'Run `mycli login` or set AUTH_TOKEN',
696
- * });
697
- * }
698
- * return { token: flags.token };
699
- * })
700
- * .action(({ ctx }) => {
701
- * ctx.token; // string
702
- * });
703
- * ```
704
- *
705
- * @param handler - Derive function receiving typed args/flags/ctx.
706
- * @returns The builder (for chaining).
707
- */
708
- derive<Output extends Record<string, unknown> | undefined = undefined>(handler: DeriveHandler<F, A, C, Output>): CommandBuilder<F, A, WidenDerivedContext<C, Output>>;
709
- /**
710
- * Register middleware to run before the action handler.
711
- *
712
- * Middleware executes in registration order. Each middleware receives
713
- * `{ args, flags, ctx, out, meta, next }` and must call `next(additions)`
714
- * to continue the chain. Context additions are merged and become
715
- * typed downstream.
716
- *
717
- * Adding middleware widens `C` via intersection and drops the current
718
- * handler (like `.flag()` / `.arg()` — the handler's type signature
719
- * changes when context changes).
720
- *
721
- * @example
722
- * ```ts
723
- * import { CLIError, command, middleware } from '@kjanat/dreamcli';
724
- *
725
- * interface User {
726
- * id: string;
727
- * email: string;
728
- * }
729
- *
730
- * async function getCurrentUser(): Promise<User | null> {
731
- * return { id: 'u_123', email: 'dev@example.com' };
732
- * }
733
- *
734
- * function startTrace(name: string): string {
735
- * return `trace:${name}`;
736
- * }
737
- *
738
- * // Resolve the current user and expose it as `ctx.user` downstream.
739
- * const auth = middleware<{ user: User }>(async ({ next }) => {
740
- * const user = await getCurrentUser();
741
- * if (!user) {
742
- * throw new CLIError('Not authenticated', { code: 'AUTH_REQUIRED' });
743
- * }
744
- * await next({ user });
745
- * });
746
- *
747
- * // Create a trace id for this command run and expose it as `ctx.traceId`.
748
- * const telemetry = middleware<{ traceId: string }>(async ({ meta, next }) => {
749
- * const traceId = startTrace(`${meta.name}.${meta.command}`);
750
- * await next({ traceId });
751
- * });
752
- *
753
- * command('deploy')
754
- * .middleware(auth) // C becomes { user: User }
755
- * .middleware(telemetry) // C becomes { user: User } & { traceId: string }
756
- * .action(({ ctx }) => {
757
- * ctx.user; // User — typed
758
- * ctx.traceId; // string — typed
759
- * });
760
- * ```
761
- *
762
- * @param m - {@link Middleware} instance created via {@linkcode middleware | middleware()}.
763
- * Middleware handlers receive `{ args, flags, ctx, out, meta, next }`.
764
- * @returns The builder (for chaining).
765
- */
766
- middleware<Output extends Record<string, unknown>>(m: Middleware<Output>): CommandBuilder<F, A, WidenContext<C, Output>>;
767
- /**
768
- * Set the command's description for help text.
769
- *
770
- * Displayed below the usage line in `--help` output and next to the
771
- * command name in parent command/group help listings.
772
- *
773
- * @param text - One-line description of what the command does.
774
- *
775
- * @example
776
- * ```ts
777
- * command('deploy')
778
- * .description('Deploy the application to a target environment')
779
- * .action(({ out }) => { out.log('deploying...'); });
780
- *
781
- * // $ mycli deploy --help
782
- * // Usage: deploy [flags]
783
- * //
784
- * // Deploy the application to a target environment
785
- * ```
786
- *
787
- * @returns The builder (for chaining).
788
- */
789
- description(text: string): CommandBuilder<F, A, C>;
790
- /**
791
- * Add an alternative name for this command.
792
- *
793
- * Aliases are accepted during dispatch alongside the primary name.
794
- * Multiple aliases can be chained. Aliases are shown in help output.
795
- *
796
- * @param name - Alternative command name (e.g. `'d'` for `deploy`).
797
- *
798
- * @example
799
- * ```ts
800
- * command('deploy')
801
- * .alias('d')
802
- * .alias('push')
803
- * .action(({ out }) => { out.log('deploying...'); });
804
- *
805
- * // All equivalent:
806
- * // $ mycli deploy
807
- * // $ mycli d
808
- * // $ mycli push
809
- * ```
810
- *
811
- * @returns The builder (for chaining).
812
- */
813
- alias(name: string): CommandBuilder<F, A, C>;
814
- /**
815
- * Hide this command from help listings.
816
- *
817
- * The command remains fully functional and dispatchable — it just
818
- * won't appear in `--help` output or shell completions. Useful for
819
- * internal/debug commands.
820
- *
821
- * @example
822
- * ```ts
823
- * command('debug-dump')
824
- * .hidden()
825
- * .action(({ out }) => { out.log(JSON.stringify(internalState)); });
826
- *
827
- * // $ mycli --help → 'debug-dump' is not listed
828
- * // $ mycli debug-dump → still works
829
- * ```
830
- *
831
- * @returns The builder (for chaining).
832
- */
833
- hidden(): CommandBuilder<F, A, C>;
834
- /**
835
- * Add a usage example to help text.
836
- *
837
- * Examples are rendered in the "Examples:" section of `--help` output.
838
- * Call multiple times to add several examples. Each example shows a
839
- * shell invocation, optionally with a description.
840
- *
841
- * `cmd` may be a literal string or a function receiving the program
842
- * {@link ExampleMeta} (`name`, `version`), resolved at render time. Use the
843
- * function form to reference the invoked program name instead of hardcoding
844
- * it, so examples stay truthful under symlinks, `inheritName`, and
845
- * `npx x` vs a global install.
846
- *
847
- * @param cmd - The example command line, or a `(meta) => string` builder.
848
- * @param description - Optional one-line explanation of what the example does.
849
- *
850
- * @example
851
- * ```ts
852
- * command('deploy')
853
- * .arg('target', arg.string())
854
- * .flag('force', flag.boolean().alias('f'))
855
- * .example('deploy production', 'Deploy to production')
856
- * .example((m) => `${m.name} deploy staging -f`, 'Force deploy to staging')
857
- * .action(({ args, flags }) => { ... });
858
- *
859
- * // $ mycli deploy --help
860
- * // ...
861
- * // Examples:
862
- * // deploy production Deploy to production
863
- * // mycli deploy staging -f Force deploy to staging
864
- * ```
865
- *
866
- * @returns The builder (for chaining).
867
- */
868
- example(cmd: ExampleCommand, description?: string): CommandBuilder<F, A, C>;
869
- /**
870
- * Register a named flag on this command.
871
- *
872
- * The flag name is added to the type-level `F` map. Duplicate flag names
873
- * are prevented at the type level via the `Exclude` constraint.
874
- *
875
- * The builder controls the flag's type, presence, aliases, env/config
876
- * bindings, and description. See {@link FlagBuilder} for available modifiers.
877
- *
878
- * @param name - Flag name: the `--name` CLI token and the matching key on `flags`
879
- * in the handler. The name is preserved as-is (no camelCasing); read non-identifier
880
- * names such as `'dry-run'` with bracket access (`flags['dry-run']`).
881
- * @param builder - Configured {@linkcode FlagBuilder} from {@linkcode flag | flag.string()},
882
- * `flag.boolean()`, `flag.number()`, `flag.enum()`, `flag.array()`, or `flag.custom()`.
883
- *
884
- * @example
885
- * ```ts
886
- * command('serve')
887
- * .flag('port', flag.number()
888
- * .alias('p')
889
- * .env('PORT')
890
- * .default(3000)
891
- * .describe('Port to listen on'))
892
- * .flag('host', flag.string()
893
- * .env('HOST')
894
- * .default('localhost')
895
- * .describe('Bind address'))
896
- * .flag('verbose', flag.boolean()
897
- * .alias('v')
898
- * .describe('Enable verbose logging'))
899
- * .action(({ flags, out }) => {
900
- * flags.port; // number
901
- * flags.host; // string
902
- * flags.verbose; // boolean
903
- * out.log(`Listening on ${flags.host}:${flags.port}`);
904
- * });
905
- *
906
- * // $ mycli serve --port 8080 -v
907
- * // $ PORT=9090 mycli serve
908
- * ```
909
- *
910
- * @returns The builder (for chaining).
911
- * @throws {@link CLIError} `INVALID_SCHEMA` when the name is `__proto__`,
912
- * which a plain record cannot carry.
913
- * @throws {@link CLIError} `FLAG_NAME_COLLISION` when the command already
914
- * declares this name, or the new flag's spellings collide with another
915
- * flag's.
916
- * @throws {@link CLIError} `PROPAGATED_FLAG_COLLISION` when a spelling
917
- * collides with one propagated to a registered subcommand.
918
- */
919
- flag<N extends string, B extends FlagBuilder<FlagConfig>>(name: N & Exclude<N, keyof F>, builder: B): CommandBuilder<F & Record<N, B>, A, C>;
920
- /**
921
- * Register a named positional argument on this command.
922
- *
923
- * Args are ordered by registration — position on the CLI matches the
924
- * order of `.arg()` calls. The arg name is added to the type-level `A`
925
- * map. Duplicate arg names are prevented at the type level via the
926
- * `Exclude` constraint.
927
- *
928
- * The builder controls the arg's type, presence, env binding, and
929
- * description. See {@link ArgBuilder} for available modifiers.
930
- *
931
- * @param name - Positional arg name (used in help text and `args.*`).
932
- * @param builder - Configured {@linkcode ArgBuilder} from `arg.string()`, `arg.number()`,
933
- * or `arg.custom()`.
934
- *
935
- * @example
936
- * ```ts
937
- * command('deploy')
938
- * // Required string arg — first positional
939
- * .arg('target', arg.string()
940
- * .env('DEPLOY_TARGET')
941
- * .describe('Deploy target'))
942
- * // Optional number arg — second positional
943
- * .arg('port', arg.number()
944
- * .env('PORT')
945
- * .default(3000)
946
- * .describe('Port number'))
947
- * .action(({ args }) => {
948
- * args.target; // string
949
- * args.port; // number
950
- * });
951
- *
952
- * // Usage: deploy [flags] <target> [port]
953
- * // $ mycli deploy production 8080
954
- * // $ DEPLOY_TARGET=staging mycli deploy
955
- * ```
956
- *
957
- * @returns The builder (for chaining).
958
- * @throws {@link CLIError} `INVALID_SCHEMA` when the name is `__proto__`,
959
- * which a plain record cannot carry.
960
- * @throws {@link CLIError} `INVALID_BUILDER_STATE` when an earlier arg on this
961
- * command is variadic, so this one could never be filled.
962
- * @throws {@link CLIError} `DUPLICATE_STDIN_INPUT` when another input on this
963
- * command already consumes stdin exclusively.
964
- */
965
- arg<N extends string, B extends ArgBuilder<ArgConfig>>(name: N & Exclude<N, keyof A>, builder: B): CommandBuilder<F, A & Record<N, B>, C>;
966
- /**
967
- * Register a nested subcommand on this command.
968
- *
969
- * The subcommand's builder is stored in `_subcommands` for the CLI layer's
970
- * `compileCommand()` to traverse when building the execution graph. The
971
- * subcommand's `CommandSchema` is also appended to `schema.commands` for
972
- * help rendering and completion generation.
973
- *
974
- * Does not change `F`, `A`, or `C` — subcommands are type-erased at the
975
- * parent level (same semantics as `CLIBuilder.command()`). The handler is
976
- * preserved.
977
- *
978
- * @example
979
- * ```ts
980
- * const db = group('db')
981
- * .description('Database operations')
982
- * .command(migrateCmd)
983
- * .command(seedCmd);
984
- * ```
985
- *
986
- * @param sub - Child {@link CommandBuilder} to nest under this command.
987
- * @returns The builder (for chaining).
988
- * @throws {@link CLIError} `PROPAGATED_FLAG_COLLISION` when a spelling this
989
- * command propagates collides with one the subcommand, or any of its own
990
- * descendants, declares.
991
- */
992
- command<F2 extends Record<string, FlagBuilder<FlagConfig>>, A2 extends Record<string, ArgBuilder<ArgConfig>>, C2 extends Record<string, unknown>>(sub: CommandBuilder<F2, A2, C2>): CommandBuilder<F, A, C>;
993
- /**
994
- * Register the action handler for this command.
995
- *
996
- * The handler receives fully typed `{ args, flags, ctx, out, meta }` derived
997
- * from the accumulated `.flag()`, `.arg()`, `.derive()`, and `.middleware()`
998
- * definitions.
999
- *
1000
- * May be synchronous or async. Return values are ignored; command handlers
1001
- * communicate through `out`, thrown errors, and side effects.
1002
- *
1003
- * @param handler - Function receiving `ActionParams<F, A, C>`.
1004
- *
1005
- * @example
1006
- * ```ts
1007
- * // Minimal
1008
- * command('greet')
1009
- * .arg('name', arg.string())
1010
- * .action(({ args, out }) => {
1011
- * out.log(`Hello, ${args.name}!`);
1012
- * });
1013
- * ```
1014
- *
1015
- * @example
1016
- * ```ts
1017
- * // Full params — flags, args, context, output, metadata
1018
- * command('deploy')
1019
- * .arg('target', arg.string().env('DEPLOY_TARGET'))
1020
- * .flag('force', flag.boolean().alias('f'))
1021
- * .flag('region', flag.enum(['us', 'eu', 'ap']).env('REGION'))
1022
- * .middleware(auth)
1023
- * .action(async ({ args, flags, ctx, out, meta }) => {
1024
- * args.target; // string
1025
- * flags.force; // boolean
1026
- * flags.region; // 'us' | 'eu' | 'ap' | undefined
1027
- * ctx.user; // User (from auth middleware)
1028
- * meta.command; // string
1029
- *
1030
- * const spinner = out.spinner('Deploying...');
1031
- * await deploy(args.target, { force: flags.force });
1032
- * spinner.stop();
1033
- * out.log('Done');
1034
- * });
1035
- * ```
1036
- *
1037
- * @returns The builder (for chaining).
1038
- */
1039
- action(handler: ActionHandler<F, A, C>): CommandBuilder<F, A, C>;
1040
- }
1041
- /**
1042
- * Create a new command builder.
1043
- *
1044
- * @param name - The command name used for dispatch (e.g. `'deploy'`).
1045
- *
1046
- * @example
1047
- * ```ts
1048
- * import { arg, command, flag } from '@kjanat/dreamcli';
1049
- *
1050
- * const greet = command('greet')
1051
- * .arg('name', arg.string())
1052
- * .flag('loud', flag.boolean())
1053
- * .action(({ args, flags, out }) => {
1054
- * const msg = `Hello, ${args.name}!`;
1055
- * out.log(flags.loud ? msg.toUpperCase() : msg);
1056
- * });
1057
- * ```
1058
- *
1059
- * @returns A fresh {@link CommandBuilder} with empty flags, args, and context.
1060
- */
1061
- declare function command(name: string): CommandBuilder;
1062
- /**
1063
- * Create a command builder intended for use as a command group.
1064
- *
1065
- * Semantically identical to {@linkcode command | command()} — a group is simply a command that
1066
- * has subcommands registered via `.command()`. The separate factory
1067
- * communicates intent: groups organise subcommands, leaf commands have actions.
1068
- *
1069
- * A group may also have its own `.action()` (e.g. `git remote` lists remotes
1070
- * when invoked without a subcommand, but dispatches to `git remote add`, etc.).
1071
- *
1072
- * @param name - The group name used for dispatch (e.g. `'db'`).
1073
- *
1074
- * @example
1075
- * ```ts
1076
- * const db = group('db')
1077
- * .description('Database operations')
1078
- * .command(migrateCmd)
1079
- * .command(seedCmd);
1080
- * ```
1081
- *
1082
- * @returns A fresh {@link CommandBuilder} with empty flags, args, and context.
1083
- */
1084
- declare function group(name: string): CommandBuilder;
1085
- //#endregion
1086
- export { type ActionHandler, type ActionParams, type AnyCommandBuilder, type CommandArgEntry, type CommandArgEntryDefinition, CommandBuilder, type CommandDefinition, type CommandExample, type CommandMeta, type CommandSchema, type DeriveHandler, type DeriveParams, type ErasedActionHandler, type ErasedDeriveHandler, type ErasedInputSources, type ErasedInteractiveResolver, type ExampleCommand, type ExampleMeta, type ExecutionStep, type InteractiveParams, type InteractiveResolver, type InteractiveResult, type Out, type WidenContext, type WidenDerivedContext, command, createCommandSchema, group, resolveExampleCommand };