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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (501) hide show
  1. package/CHANGELOG.md +516 -1842
  2. package/dist/core/cli/builtins.d.mts +74 -4
  3. package/dist/core/cli/compiled.d.mts +39 -2
  4. package/dist/core/cli/dispatch.d.mts +81 -4
  5. package/dist/core/cli/help-links.d.mts +13 -1
  6. package/dist/core/cli/index.d.mts +77 -12
  7. package/dist/core/cli/index.mjs +9 -3
  8. package/dist/core/cli/planner.d.mts +86 -8
  9. package/dist/core/cli/reserved-flags.d.mts +19 -1
  10. package/dist/core/cli/root-help.d.mts +53 -1
  11. package/dist/core/cli/root-help.mjs +1 -1
  12. package/dist/core/cli/root-output-flags.d.mts +74 -1
  13. package/dist/core/cli/root-surface.d.mts +64 -1
  14. package/dist/core/cli/runtime-preflight.d.mts +213 -1
  15. package/dist/core/completion/index.d.mts +2 -2
  16. package/dist/core/completion/shells/bash.d.mts +1 -0
  17. package/dist/core/completion/shells/bash.mjs +4 -1
  18. package/dist/core/completion/shells/fish.d.mts +1 -0
  19. package/dist/core/completion/shells/fish.mjs +2 -1
  20. package/dist/core/completion/shells/powershell.d.mts +1 -0
  21. package/dist/core/completion/shells/powershell.mjs +2 -1
  22. package/dist/core/completion/shells/shared.d.mts +118 -3
  23. package/dist/core/completion/shells/shared.mjs +1 -1
  24. package/dist/core/completion/shells/zsh.d.mts +1 -0
  25. package/dist/core/completion/shells/zsh.mjs +6 -2
  26. package/dist/core/config/index.d.mts +1 -1
  27. package/dist/core/config/package-json.d.mts +1 -1
  28. package/dist/core/errors/index.d.mts +17 -18
  29. package/dist/core/execution/index.d.mts +61 -1
  30. package/dist/core/help/ansi.d.mts +11 -0
  31. package/dist/core/help/index.d.mts +42 -3
  32. package/dist/core/help/index.mjs +14 -10
  33. package/dist/core/help/theme.d.mts +39 -1
  34. package/dist/core/help/theme.mjs +24 -1
  35. package/dist/core/json-schema/index.d.mts +11 -11
  36. package/dist/core/json-schema/index.mjs +7 -6
  37. package/dist/core/output/activity.d.mts +193 -1
  38. package/dist/core/output/bind.d.mts +37 -1
  39. package/dist/core/output/contracts.d.mts +5 -4
  40. package/dist/core/output/display-value.d.mts +19 -1
  41. package/dist/core/output/index.d.mts +191 -7
  42. package/dist/core/output/index.mjs +6 -4
  43. package/dist/core/output/renderers.d.mts +45 -1
  44. package/dist/core/parse/index.d.mts +4 -4
  45. package/dist/core/parse/occurrences.d.mts +9 -8
  46. package/dist/core/prompt/index.d.mts +3 -3
  47. package/dist/core/read-flags/index.d.mts +1 -1
  48. package/dist/core/resolve/coerce.d.mts +4 -4
  49. package/dist/core/resolve/config.d.mts +10 -1
  50. package/dist/core/resolve/contracts.d.mts +9 -8
  51. package/dist/core/resolve/flags.d.mts +28 -1
  52. package/dist/core/resolve/path-checks.d.mts +4 -3
  53. package/dist/core/resolve/redaction.d.mts +1 -0
  54. package/dist/core/resolve/stages.d.mts +7 -6
  55. package/dist/core/resolve/standard.d.mts +26 -1
  56. package/dist/core/schema/activity.d.mts +16 -16
  57. package/dist/core/schema/arg.d.mts +76 -66
  58. package/dist/core/schema/brand.d.mts +1 -1
  59. package/dist/core/schema/cardinality.d.mts +18 -17
  60. package/dist/core/schema/command.d.mts +40 -9
  61. package/dist/core/schema/flag.d.mts +98 -90
  62. package/dist/core/schema/index.d.mts +1 -1
  63. package/dist/core/schema/middleware.d.mts +4 -1
  64. package/dist/core/schema/number-constraints.d.mts +5 -5
  65. package/dist/core/schema/prompt.d.mts +4 -4
  66. package/dist/core/schema/provenance.d.mts +11 -11
  67. package/dist/core/schema/run.d.mts +58 -8
  68. package/dist/core/schema/source.d.mts +13 -12
  69. package/dist/core/schema/standard.d.mts +31 -24
  70. package/dist/core/schema/stdin.d.mts +12 -2
  71. package/dist/core/schema/string-constraints.d.mts +4 -4
  72. package/dist/core/schema/value-parsers.d.mts +3 -3
  73. package/dist/core/schema/value.d.mts +15 -14
  74. package/dist/core/testkit/index.d.mts +13 -4
  75. package/dist/index.d.mts +6 -6
  76. package/dist/runtime/adapter.d.mts +3 -3
  77. package/dist/runtime/deno.d.mts +3 -3
  78. package/dist/runtime/detect.d.mts +2 -2
  79. package/dist/runtime/node.d.mts +3 -3
  80. package/dist/runtime/paths.d.mts +31 -1
  81. package/dist/strings.d.mts +16 -1
  82. package/dist/version.d.mts +16 -4
  83. package/dist/version.mjs +2 -2
  84. package/package.json +15 -11
  85. package/skills/cli-creation/SKILL.md +1 -1
  86. package/examples/gh/node_modules/typescript/LICENSE +0 -55
  87. package/examples/gh/node_modules/typescript/NOTICE.txt +0 -436
  88. package/examples/gh/node_modules/typescript/README.md +0 -49
  89. package/examples/gh/node_modules/typescript/bin/tsc +0 -2
  90. package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts +0 -529
  91. package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts.map +0 -1
  92. package/examples/gh/node_modules/typescript/dist/api/async/api.js +0 -1657
  93. package/examples/gh/node_modules/typescript/dist/api/async/api.js.map +0 -1
  94. package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts +0 -39
  95. package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts.map +0 -1
  96. package/examples/gh/node_modules/typescript/dist/api/async/client.js +0 -211
  97. package/examples/gh/node_modules/typescript/dist/api/async/client.js.map +0 -1
  98. package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts +0 -310
  99. package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts.map +0 -1
  100. package/examples/gh/node_modules/typescript/dist/api/async/types.js +0 -2
  101. package/examples/gh/node_modules/typescript/dist/api/async/types.js.map +0 -1
  102. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts +0 -109
  103. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts.map +0 -1
  104. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js +0 -2
  105. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js.map +0 -1
  106. package/examples/gh/node_modules/typescript/dist/api/fs.d.ts +0 -23
  107. package/examples/gh/node_modules/typescript/dist/api/fs.d.ts.map +0 -1
  108. package/examples/gh/node_modules/typescript/dist/api/fs.js +0 -109
  109. package/examples/gh/node_modules/typescript/dist/api/fs.js.map +0 -1
  110. package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts +0 -15
  111. package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts.map +0 -1
  112. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts +0 -5
  113. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts.map +0 -1
  114. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js +0 -74
  115. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js.map +0 -1
  116. package/examples/gh/node_modules/typescript/dist/api/node/encoder.js +0 -287
  117. package/examples/gh/node_modules/typescript/dist/api/node/encoder.js.map +0 -1
  118. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts +0 -32
  119. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts.map +0 -1
  120. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js +0 -213
  121. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js.map +0 -1
  122. package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts +0 -76
  123. package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts.map +0 -1
  124. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts +0 -182
  125. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts.map +0 -1
  126. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js +0 -835
  127. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js.map +0 -1
  128. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts +0 -62
  129. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts.map +0 -1
  130. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js +0 -122
  131. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js.map +0 -1
  132. package/examples/gh/node_modules/typescript/dist/api/node/node.js +0 -298
  133. package/examples/gh/node_modules/typescript/dist/api/node/node.js.map +0 -1
  134. package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts +0 -29
  135. package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts.map +0 -1
  136. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts +0 -4
  137. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts.map +0 -1
  138. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js +0 -241
  139. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js.map +0 -1
  140. package/examples/gh/node_modules/typescript/dist/api/node/protocol.js +0 -30
  141. package/examples/gh/node_modules/typescript/dist/api/node/protocol.js.map +0 -1
  142. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts +0 -6
  143. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts.map +0 -1
  144. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js +0 -61
  145. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js.map +0 -1
  146. package/examples/gh/node_modules/typescript/dist/api/options.d.ts +0 -32
  147. package/examples/gh/node_modules/typescript/dist/api/options.d.ts.map +0 -1
  148. package/examples/gh/node_modules/typescript/dist/api/options.js +0 -11
  149. package/examples/gh/node_modules/typescript/dist/api/options.js.map +0 -1
  150. package/examples/gh/node_modules/typescript/dist/api/path.d.ts +0 -110
  151. package/examples/gh/node_modules/typescript/dist/api/path.d.ts.map +0 -1
  152. package/examples/gh/node_modules/typescript/dist/api/path.js +0 -508
  153. package/examples/gh/node_modules/typescript/dist/api/path.js.map +0 -1
  154. package/examples/gh/node_modules/typescript/dist/api/proto.d.ts +0 -239
  155. package/examples/gh/node_modules/typescript/dist/api/proto.d.ts.map +0 -1
  156. package/examples/gh/node_modules/typescript/dist/api/proto.js +0 -37
  157. package/examples/gh/node_modules/typescript/dist/api/proto.js.map +0 -1
  158. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts +0 -79
  159. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts.map +0 -1
  160. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js +0 -169
  161. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js.map +0 -1
  162. package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts +0 -529
  163. package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts.map +0 -1
  164. package/examples/gh/node_modules/typescript/dist/api/sync/api.js +0 -1665
  165. package/examples/gh/node_modules/typescript/dist/api/sync/api.js.map +0 -1
  166. package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts +0 -30
  167. package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts.map +0 -1
  168. package/examples/gh/node_modules/typescript/dist/api/sync/client.js +0 -124
  169. package/examples/gh/node_modules/typescript/dist/api/sync/client.js.map +0 -1
  170. package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts +0 -310
  171. package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts.map +0 -1
  172. package/examples/gh/node_modules/typescript/dist/api/sync/types.js +0 -2
  173. package/examples/gh/node_modules/typescript/dist/api/sync/types.js.map +0 -1
  174. package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts +0 -114
  175. package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts.map +0 -1
  176. package/examples/gh/node_modules/typescript/dist/api/syncChannel.js +0 -508
  177. package/examples/gh/node_modules/typescript/dist/api/syncChannel.js.map +0 -1
  178. package/examples/gh/node_modules/typescript/dist/api/timing.d.ts +0 -175
  179. package/examples/gh/node_modules/typescript/dist/api/timing.d.ts.map +0 -1
  180. package/examples/gh/node_modules/typescript/dist/api/timing.js +0 -149
  181. package/examples/gh/node_modules/typescript/dist/api/timing.js.map +0 -1
  182. package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts +0 -100
  183. package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts.map +0 -1
  184. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts +0 -1161
  185. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts.map +0 -1
  186. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js +0 -4
  187. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js.map +0 -1
  188. package/examples/gh/node_modules/typescript/dist/ast/ast.js +0 -7
  189. package/examples/gh/node_modules/typescript/dist/ast/ast.js.map +0 -1
  190. package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts +0 -19
  191. package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts.map +0 -1
  192. package/examples/gh/node_modules/typescript/dist/ast/astnav.js +0 -596
  193. package/examples/gh/node_modules/typescript/dist/ast/astnav.js.map +0 -1
  194. package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts +0 -16
  195. package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts.map +0 -1
  196. package/examples/gh/node_modules/typescript/dist/ast/clone.js +0 -104
  197. package/examples/gh/node_modules/typescript/dist/ast/clone.js.map +0 -1
  198. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts +0 -520
  199. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts.map +0 -1
  200. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js +0 -3057
  201. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js.map +0 -1
  202. package/examples/gh/node_modules/typescript/dist/ast/index.d.ts +0 -20
  203. package/examples/gh/node_modules/typescript/dist/ast/index.d.ts.map +0 -1
  204. package/examples/gh/node_modules/typescript/dist/ast/index.js +0 -20
  205. package/examples/gh/node_modules/typescript/dist/ast/index.js.map +0 -1
  206. package/examples/gh/node_modules/typescript/dist/ast/is.d.ts +0 -35
  207. package/examples/gh/node_modules/typescript/dist/ast/is.d.ts.map +0 -1
  208. package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts +0 -329
  209. package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts.map +0 -1
  210. package/examples/gh/node_modules/typescript/dist/ast/is.generated.js +0 -1103
  211. package/examples/gh/node_modules/typescript/dist/ast/is.generated.js.map +0 -1
  212. package/examples/gh/node_modules/typescript/dist/ast/is.js +0 -233
  213. package/examples/gh/node_modules/typescript/dist/ast/is.js.map +0 -1
  214. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts +0 -11
  215. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts.map +0 -1
  216. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js +0 -202
  217. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js.map +0 -1
  218. package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts +0 -97
  219. package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts.map +0 -1
  220. package/examples/gh/node_modules/typescript/dist/ast/scanner.js +0 -2230
  221. package/examples/gh/node_modules/typescript/dist/ast/scanner.js.map +0 -1
  222. package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts +0 -17
  223. package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts.map +0 -1
  224. package/examples/gh/node_modules/typescript/dist/ast/utils.js +0 -67
  225. package/examples/gh/node_modules/typescript/dist/ast/utils.js.map +0 -1
  226. package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts +0 -14
  227. package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts.map +0 -1
  228. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts +0 -50
  229. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts.map +0 -1
  230. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js +0 -978
  231. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js.map +0 -1
  232. package/examples/gh/node_modules/typescript/dist/ast/visitor.js +0 -47
  233. package/examples/gh/node_modules/typescript/dist/ast/visitor.js.map +0 -1
  234. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts +0 -2
  235. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts.map +0 -1
  236. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts +0 -129
  237. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts.map +0 -1
  238. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js +0 -132
  239. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js.map +0 -1
  240. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js +0 -130
  241. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js.map +0 -1
  242. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts +0 -2
  243. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts.map +0 -1
  244. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts +0 -5
  245. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts.map +0 -1
  246. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js +0 -6
  247. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js.map +0 -1
  248. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js +0 -6
  249. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js.map +0 -1
  250. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts +0 -2
  251. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts.map +0 -1
  252. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts +0 -28
  253. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts.map +0 -1
  254. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js +0 -30
  255. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js.map +0 -1
  256. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js +0 -30
  257. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js.map +0 -1
  258. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts +0 -2
  259. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts.map +0 -1
  260. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts +0 -7
  261. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts.map +0 -1
  262. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js +0 -9
  263. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js.map +0 -1
  264. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js +0 -9
  265. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js.map +0 -1
  266. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts +0 -2
  267. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts.map +0 -1
  268. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts +0 -12
  269. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts.map +0 -1
  270. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js +0 -14
  271. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js.map +0 -1
  272. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js +0 -14
  273. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js.map +0 -1
  274. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts +0 -2
  275. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts.map +0 -1
  276. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts +0 -23
  277. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts.map +0 -1
  278. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js +0 -25
  279. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js.map +0 -1
  280. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js +0 -25
  281. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js.map +0 -1
  282. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts +0 -2
  283. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts.map +0 -1
  284. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts +0 -9
  285. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts.map +0 -1
  286. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js +0 -11
  287. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js.map +0 -1
  288. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js +0 -11
  289. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js.map +0 -1
  290. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts +0 -2
  291. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts.map +0 -1
  292. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts +0 -5
  293. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts.map +0 -1
  294. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js +0 -6
  295. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js.map +0 -1
  296. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js +0 -6
  297. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js.map +0 -1
  298. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts +0 -2
  299. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts.map +0 -1
  300. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts +0 -42
  301. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts.map +0 -1
  302. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js +0 -44
  303. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js.map +0 -1
  304. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js +0 -44
  305. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js.map +0 -1
  306. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts +0 -2
  307. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts.map +0 -1
  308. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts +0 -7
  309. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts.map +0 -1
  310. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js +0 -9
  311. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js.map +0 -1
  312. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js +0 -9
  313. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js.map +0 -1
  314. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts +0 -2
  315. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts.map +0 -1
  316. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts +0 -17
  317. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts.map +0 -1
  318. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js +0 -19
  319. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js.map +0 -1
  320. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js +0 -19
  321. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js.map +0 -1
  322. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts +0 -2
  323. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts.map +0 -1
  324. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts +0 -9
  325. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts.map +0 -1
  326. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js +0 -11
  327. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js.map +0 -1
  328. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js +0 -11
  329. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js.map +0 -1
  330. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts +0 -2
  331. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts.map +0 -1
  332. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts +0 -6
  333. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts.map +0 -1
  334. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js +0 -8
  335. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js.map +0 -1
  336. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js +0 -8
  337. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js.map +0 -1
  338. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts +0 -2
  339. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts.map +0 -1
  340. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts +0 -36
  341. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts.map +0 -1
  342. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js +0 -38
  343. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js.map +0 -1
  344. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js +0 -38
  345. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js.map +0 -1
  346. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts +0 -2
  347. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts.map +0 -1
  348. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts +0 -44
  349. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts.map +0 -1
  350. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js +0 -46
  351. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js.map +0 -1
  352. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js +0 -46
  353. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js.map +0 -1
  354. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts +0 -2
  355. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts.map +0 -1
  356. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts +0 -50
  357. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts.map +0 -1
  358. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js +0 -52
  359. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js.map +0 -1
  360. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js +0 -52
  361. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js.map +0 -1
  362. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts +0 -2
  363. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts.map +0 -1
  364. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts +0 -16
  365. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts.map +0 -1
  366. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js +0 -18
  367. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js.map +0 -1
  368. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js +0 -18
  369. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js.map +0 -1
  370. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts +0 -2
  371. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts.map +0 -1
  372. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts +0 -13
  373. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts.map +0 -1
  374. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js +0 -14
  375. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js.map +0 -1
  376. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js +0 -14
  377. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js.map +0 -1
  378. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts +0 -2
  379. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts.map +0 -1
  380. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts +0 -11
  381. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts.map +0 -1
  382. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js +0 -12
  383. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js.map +0 -1
  384. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js +0 -12
  385. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js.map +0 -1
  386. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts +0 -2
  387. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts.map +0 -1
  388. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts +0 -17
  389. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts.map +0 -1
  390. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js +0 -18
  391. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js.map +0 -1
  392. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js +0 -18
  393. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js.map +0 -1
  394. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts +0 -2
  395. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts.map +0 -1
  396. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts +0 -15
  397. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts.map +0 -1
  398. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js +0 -17
  399. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js.map +0 -1
  400. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js +0 -17
  401. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js.map +0 -1
  402. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts +0 -2
  403. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts.map +0 -1
  404. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts +0 -5
  405. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts.map +0 -1
  406. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js +0 -7
  407. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js.map +0 -1
  408. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js +0 -7
  409. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js.map +0 -1
  410. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts +0 -2
  411. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts.map +0 -1
  412. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts +0 -71
  413. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts.map +0 -1
  414. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js +0 -73
  415. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js.map +0 -1
  416. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js +0 -73
  417. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js.map +0 -1
  418. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts +0 -2
  419. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts.map +0 -1
  420. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts +0 -389
  421. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts.map +0 -1
  422. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js +0 -391
  423. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js.map +0 -1
  424. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js +0 -391
  425. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js.map +0 -1
  426. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts +0 -2
  427. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts.map +0 -1
  428. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts +0 -30
  429. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts.map +0 -1
  430. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js +0 -32
  431. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js.map +0 -1
  432. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js +0 -32
  433. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js.map +0 -1
  434. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts +0 -2
  435. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts.map +0 -1
  436. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts +0 -76
  437. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts.map +0 -1
  438. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js +0 -78
  439. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js.map +0 -1
  440. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js +0 -78
  441. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js.map +0 -1
  442. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts +0 -2
  443. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts.map +0 -1
  444. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts +0 -7
  445. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts.map +0 -1
  446. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js +0 -9
  447. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js.map +0 -1
  448. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js +0 -9
  449. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js.map +0 -1
  450. package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts +0 -23
  451. package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts.map +0 -1
  452. package/examples/gh/node_modules/typescript/dist/internal/utils.js +0 -25
  453. package/examples/gh/node_modules/typescript/dist/internal/utils.js.map +0 -1
  454. package/examples/gh/node_modules/typescript/lib/getExePath.d.ts +0 -2
  455. package/examples/gh/node_modules/typescript/lib/getExePath.js +0 -70
  456. package/examples/gh/node_modules/typescript/lib/tsc.js +0 -28
  457. package/examples/gh/node_modules/typescript/lib/version.cjs +0 -3
  458. package/examples/gh/node_modules/typescript/lib/version.d.cts +0 -2
  459. package/examples/gh/node_modules/typescript/package.json +0 -87
  460. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/License.txt +0 -11
  461. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/README.md +0 -54
  462. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.d.ts +0 -17
  463. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.js +0 -83
  464. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.d.ts +0 -22
  465. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.js +0 -210
  466. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.d.ts +0 -14
  467. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.js +0 -87
  468. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.d.ts +0 -32
  469. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.js +0 -132
  470. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.d.ts +0 -367
  471. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.js +0 -1271
  472. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.d.ts +0 -9
  473. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.js +0 -16
  474. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.d.ts +0 -52
  475. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.js +0 -70
  476. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.d.ts +0 -39
  477. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.js +0 -135
  478. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.d.ts +0 -7
  479. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.js +0 -34
  480. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.d.ts +0 -55
  481. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.js +0 -412
  482. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.d.ts +0 -18
  483. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.js +0 -155
  484. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.d.ts +0 -77
  485. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.js +0 -246
  486. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.d.ts +0 -60
  487. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.js +0 -157
  488. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.d.ts +0 -369
  489. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.js +0 -436
  490. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.d.ts +0 -74
  491. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.js +0 -23
  492. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.d.ts +0 -10
  493. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.js +0 -74
  494. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.d.ts +0 -15
  495. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.js +0 -77
  496. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.d.ts +0 -58
  497. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.js +0 -289
  498. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.d.ts +0 -12
  499. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.js +0 -163
  500. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/package.json +0 -54
  501. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/typings/thenable.d.ts +0 -5
@@ -1,9 +1,9 @@
1
1
  import { schemaBrand } from "../schema/brand.mjs";
2
2
  //#region src/core/cli/builtins.d.ts
3
3
  /** A built-in flag a consumer can take over. */
4
- type BuiltinName = "help" | "json" | "quiet";
4
+ type BuiltinName = 'help' | 'json' | 'quiet';
5
5
  /** Whether the root keeps a built-in or releases it to commands. */
6
- type BuiltinMode = "on" | "off";
6
+ type BuiltinMode = 'on' | 'off';
7
7
  /**
8
8
  * Built-in flag settings accepted by {@linkcode CLIBuilder.builtins} and the
9
9
  * `builtins` field of {@link CLIDefinition}.
@@ -35,7 +35,7 @@ interface BuiltinsConfig {
35
35
  */
36
36
  interface Builtins {
37
37
  /** Type-only seal produced by {@link createCLISchema}. */
38
- readonly [schemaBrand]: "builtins";
38
+ readonly [schemaBrand]: 'builtins';
39
39
  /** Whether the root owns `--help`/`-h` and the bare `help` token. */
40
40
  readonly help: BuiltinMode;
41
41
  /** Whether the root owns `--json`. */
@@ -43,5 +43,75 @@ interface Builtins {
43
43
  /** Whether the root owns `--quiet`/`-q`. */
44
44
  readonly quiet: BuiltinMode;
45
45
  }
46
+ /**
47
+ * {@link Builtins} before the type-only seal is applied.
48
+ *
49
+ * @internal
50
+ */
51
+ type BuiltinsDraft = Omit<Builtins, typeof schemaBrand>;
52
+ /** Everything the framework needs to know about one built-in flag. @internal */
53
+ interface BuiltinSpec {
54
+ /** Long spellings, the only forms that carry an inline `=value`. */
55
+ readonly long: readonly string[];
56
+ /** Short spellings, which have no inline-value form. */
57
+ readonly short: readonly string[];
58
+ /** Description shown in the root-help `Global options:` block. */
59
+ readonly description: string;
60
+ }
61
+ /**
62
+ * The spelling table every built-in-aware layer reads.
63
+ *
64
+ * @internal
65
+ */
66
+ declare const BUILTIN_SPECS: Readonly<Record<BuiltinName, BuiltinSpec>>;
67
+ /** Spelling error messages and help entries name a built-in by. @internal */
68
+ declare function builtinSpelling(name: BuiltinName): string;
69
+ /** Built-in names in the order root help advertises them. @internal */
70
+ declare const BUILTIN_NAMES: readonly ["help", "json", "quiet"];
71
+ /** Every built-in on, the state a CLI starts in. @internal */
72
+ declare const DEFAULT_BUILTINS: BuiltinsDraft;
73
+ /**
74
+ * Whether the root still owns a built-in.
75
+ *
76
+ * @param builtins - Normalized state, or `undefined` for the defaults.
77
+ * @param name - Built-in to check.
78
+ * @returns `true` when the root reads the token, `false` once it is released.
79
+ *
80
+ * @internal
81
+ */
82
+ declare function builtinEnabled(builtins: BuiltinsConfig | undefined, name: BuiltinName): boolean;
83
+ /**
84
+ * The argv spellings of one built-in, joined for a help entry.
85
+ *
86
+ * @param name - Built-in to render.
87
+ * @returns Short spellings first, e.g. `-h, --help`.
88
+ *
89
+ * @internal
90
+ */
91
+ declare function builtinFlagForms(name: BuiltinName): string;
92
+ /**
93
+ * The spellings of one built-in as bare tokens, dashes removed.
94
+ *
95
+ * @param name - Built-in to read.
96
+ * @returns Tokens as a command flag would declare them, e.g. `help` and `h`.
97
+ *
98
+ * @internal
99
+ */
100
+ declare function builtinTokens(name: BuiltinName): readonly string[];
101
+ /**
102
+ * Normalize built-in settings into the fully populated schema state.
103
+ *
104
+ * Shared by {@link createCLISchema} and {@linkcode CLIBuilder.builtins}, so both
105
+ * construction paths produce identical state. Re-feeding a normalized value
106
+ * returns an equal value.
107
+ *
108
+ * @param config - Caller-supplied settings, or `undefined` for the defaults.
109
+ * @returns Every built-in resolved to a mode.
110
+ * @throws {@linkcode CLIError} `INVALID_SCHEMA` for a value that is neither
111
+ * `'on'` nor `'off'`.
112
+ *
113
+ * @internal
114
+ */
115
+ declare function normalizeBuiltins(config: BuiltinsConfig | undefined): BuiltinsDraft;
46
116
  //#endregion
47
- export type { BuiltinMode, BuiltinName, Builtins, BuiltinsConfig };
117
+ export { BUILTIN_NAMES, BUILTIN_SPECS, type BuiltinMode, type BuiltinName, type BuiltinSpec, type Builtins, type BuiltinsConfig, type BuiltinsDraft, DEFAULT_BUILTINS, builtinEnabled, builtinFlagForms, builtinSpelling, builtinTokens, normalizeBuiltins };
@@ -1,4 +1,6 @@
1
- import { CommandSchema, ErasedActionHandler, ExecutionStep } from "../schema/command.mjs";
1
+ import { FlagBuilder, FlagConfig } from "../schema/flag.mjs";
2
+ import { ArgBuilder, ArgConfig } from "../schema/arg.mjs";
3
+ import { CommandBuilder, CommandSchema, ErasedActionHandler, ExecutionStep } from "../schema/command.mjs";
2
4
  import { CLIPlugin } from "./plugin.mjs";
3
5
  //#region src/core/cli/compiled.d.ts
4
6
  /**
@@ -25,5 +27,40 @@ interface CompiledCLI {
25
27
  /** Plugins in registration order. */
26
28
  readonly plugins: readonly CLIPlugin[];
27
29
  }
30
+ /**
31
+ * The routes a command answers to: its name followed by its aliases.
32
+ *
33
+ * @param schema - Command schema to read the name and aliases from.
34
+ * @returns Route tokens in declaration order.
35
+ *
36
+ * @internal
37
+ */
38
+ declare function commandRoutes(schema: CommandSchema): readonly string[];
39
+ /**
40
+ * Reject a route already claimed by a sibling command, then record its owner.
41
+ *
42
+ * @param parentCommandName - Name of the command the siblings live under.
43
+ * @param routeOwners - Route to owning command name, mutated with `route`.
44
+ * @param route - Name or alias being registered.
45
+ * @param commandName - Command claiming the route.
46
+ *
47
+ * @internal
48
+ */
49
+ declare function assertNoSiblingRouteConflict(parentCommandName: string, routeOwners: Map<string, string>, route: string, commandName: string): void;
50
+ /**
51
+ * Compile a command builder into its executable graph node.
52
+ *
53
+ * Extracts the handler and execution steps, then recurses into
54
+ * `_subcommands` to index each child by name and alias. The builder itself is
55
+ * not retained; `schema` is the builder's own schema object, so the compiled
56
+ * node and the public schema tree share command schema identity.
57
+ *
58
+ * @param cmd - Command builder to compile.
59
+ * @returns The compiled command node.
60
+ * @throws {@linkcode CLIError} `DUPLICATE_COMMAND` when two siblings claim the same route.
61
+ *
62
+ * @internal
63
+ */
64
+ declare function compileCommand<F extends Record<string, FlagBuilder<FlagConfig>>, A extends Record<string, ArgBuilder<ArgConfig>>, C extends Record<string, unknown>>(cmd: CommandBuilder<F, A, C>): CompiledCommand;
28
65
  //#endregion
29
- export type { CompiledCLI, CompiledCommand };
66
+ export { type CompiledCLI, type CompiledCommand, assertNoSiblingRouteConflict, commandRoutes, compileCommand };
@@ -1,10 +1,19 @@
1
1
  import { CommandSchema } from "../schema/command.mjs";
2
+ import { FlagLookupEntry, ParseOptions } from "../parse/index.mjs";
2
3
  import { CompiledCommand } from "./compiled.mjs";
3
4
  //#region src/core/cli/dispatch.d.ts
5
+ /**
6
+ * Flag lookup (spelling → {@link FlagLookupEntry}) used to make the
7
+ * command-name scan aware of value-flag arity. Built from the flags valid at
8
+ * the current dispatch level via {@link buildFlagLookup}.
9
+ *
10
+ * @internal
11
+ */
12
+ type ValueFlagLookup = ReadonlyMap<string, FlagLookupEntry>;
4
13
  /** Successful dispatch — target command found with argv path. */
5
14
  interface DispatchMatch {
6
15
  /** Discriminant — a command name in argv matched a registered command. */
7
- readonly kind: "match";
16
+ readonly kind: 'match';
8
17
  /** The matched (target) command. */
9
18
  readonly command: CompiledCommand;
10
19
  /** Root → target (inclusive). Used for `collectPropagatedFlags()`. */
@@ -15,7 +24,7 @@ interface DispatchMatch {
15
24
  /** Target has subcommands but no handler and no subcommand was specified/matched. */
16
25
  interface DispatchNeedsSubcommand {
17
26
  /** Discriminant — command group reached without a subcommand or handler. */
18
- readonly kind: "needs-subcommand";
27
+ readonly kind: 'needs-subcommand';
19
28
  /** The group command that needs a subcommand. */
20
29
  readonly command: CompiledCommand;
21
30
  /** Root → group (inclusive). */
@@ -24,7 +33,7 @@ interface DispatchNeedsSubcommand {
24
33
  /** Unknown command name at this dispatch level. */
25
34
  interface DispatchUnknown {
26
35
  /** Discriminant — no registered command matched the input token. */
27
- readonly kind: "unknown";
36
+ readonly kind: 'unknown';
28
37
  /** The unrecognised input token. Empty string when no token present. */
29
38
  readonly input: string;
30
39
  /** Commands available at the level where matching failed. */
@@ -34,5 +43,73 @@ interface DispatchUnknown {
34
43
  }
35
44
  /** Discriminated result of recursive command dispatch. */
36
45
  type DispatchResult = DispatchMatch | DispatchNeedsSubcommand | DispatchUnknown;
46
+ /**
47
+ * Recursively walk argv, consuming command name segments from the front.
48
+ *
49
+ * At each level, the first non-flag token is tested as a command name
50
+ * against the provided command map. If matched and the matched command
51
+ * has subcommands, dispatch recurses into the child level with the
52
+ * remaining argv.
53
+ *
54
+ * Ambiguity resolution for commands that have both an action handler AND
55
+ * subcommands (e.g. `git remote` lists remotes, `git remote add` dispatches):
56
+ * - If the next token matches a subcommand → descend
57
+ * - If the next token is unknown and the command has a handler → match here
58
+ * - If the next token is unknown and no handler → propagate unknown error
59
+ * - If no next token and command has a handler → match here
60
+ * - If no next token and no handler → needs-subcommand
61
+ *
62
+ * @param argv - Remaining argv tokens (command names + flags + args).
63
+ * @param commands - Command map at the current tree level.
64
+ * @param ancestorPath - Schema path from root to current level (exclusive).
65
+ * @param valueFlags - Lookup of flags valid at this level, used so a
66
+ * space-separated value-flag's value (`--region eu`) is not mistaken for a
67
+ * command name. Empty by default (arity-unaware, legacy behaviour).
68
+ * @param parseOptions - Parser toggles (case parity) applied to descent-level
69
+ * flag lookups built inside dispatch.
70
+ * @returns Discriminated dispatch result.
71
+ *
72
+ * @internal
73
+ */
74
+ declare function dispatch(argv: readonly string[], commands: ReadonlyMap<string, CompiledCommand>, ancestorPath?: readonly CommandSchema[], valueFlags?: ValueFlagLookup, parseOptions?: ParseOptions): DispatchResult;
75
+ /**
76
+ * Whether a flag token consumes the following argv token as its value.
77
+ *
78
+ * Mirrors the parser's value-consumption rules (`parseLongFlag` /
79
+ * `parseShortFlags`) so the command-name scan skips exactly the tokens the
80
+ * parser would treat as flag values:
81
+ * - `--flag value` → consumes when `--flag` is a known value-flag.
82
+ * - `--flag=value` → self-contained, consumes nothing.
83
+ * - `-abc value` → consumes only when the trailing short flag is a value-flag;
84
+ * an earlier value-flag char takes the rest of the group as an inline value.
85
+ *
86
+ * Unknown flags conservatively consume nothing (the parser reports them later).
87
+ *
88
+ * @internal
89
+ */
90
+ declare function consumesFollowingToken(token: string, valueFlags: ValueFlagLookup): boolean;
91
+ /**
92
+ * Levenshtein distance between two strings.
93
+ * @internal
94
+ */
95
+ declare function levenshtein(a: string, b: string): number;
96
+ /**
97
+ * Find the closest command name match for a "did you mean?" suggestion.
98
+ *
99
+ * Searches command names and aliases. Returns `undefined` if no
100
+ * sufficiently close match exists (threshold: 3).
101
+ *
102
+ * @internal
103
+ */
104
+ declare function findClosestCommand(input: string, commands: readonly CompiledCommand[]): string | undefined;
105
+ /**
106
+ * Deduplicate commands from a name+alias map.
107
+ *
108
+ * A map keyed by name *and* alias contains duplicate entries for aliased
109
+ * commands. This returns unique commands (by schema identity).
110
+ *
111
+ * @internal
112
+ */
113
+ declare function uniqueCommands(commands: ReadonlyMap<string, CompiledCommand>): readonly CompiledCommand[];
37
114
  //#endregion
38
- export type { DispatchMatch, DispatchNeedsSubcommand, DispatchResult, DispatchUnknown };
115
+ export { type DispatchMatch, type DispatchNeedsSubcommand, type DispatchResult, type DispatchUnknown, type ValueFlagLookup, consumesFollowingToken, dispatch, findClosestCommand, levenshtein, uniqueCommands };
@@ -1,3 +1,4 @@
1
+ import { PackageJsonData } from "../config/package-json.mjs";
1
2
  //#region src/core/cli/help-links.d.ts
2
3
  /**
3
4
  * OSC 8 hyperlink targets for the root-help header.
@@ -11,5 +12,16 @@ interface HelpLinks {
11
12
  /** URL the version links to (e.g. the release tag). */
12
13
  readonly version: string | undefined;
13
14
  }
15
+ /**
16
+ * Fill `undefined` link fields from package.json metadata.
17
+ *
18
+ * Explicit URLs always win. The name falls back to the normalized
19
+ * `repository` URL, then `homepage`; the version falls back to the forge
20
+ * release-tag URL when both a repository and a version are known.
21
+ * Idempotent — already-resolved fields pass through unchanged.
22
+ *
23
+ * @internal
24
+ */
25
+ declare function deriveHelpLinks(links: HelpLinks | undefined, pkg: PackageJsonData | undefined, version: string | undefined): HelpLinks | undefined;
14
26
  //#endregion
15
- export type { HelpLinks };
27
+ export { type HelpLinks, deriveHelpLinks };
@@ -1,20 +1,21 @@
1
1
  import { schemaBrand } from "../schema/brand.mjs";
2
2
  import { BuiltinMode, BuiltinName, Builtins, BuiltinsConfig } from "./builtins.mjs";
3
- import { Verbosity } from "../output/contracts.mjs";
3
+ import { HelpThemeFactory } from "../help/theme.mjs";
4
4
  import { FlagBuilder, FlagConfig } from "../schema/flag.mjs";
5
5
  import { ArgBuilder, ArgConfig } from "../schema/arg.mjs";
6
- import { CommandBuilder, CommandDefinition, CommandSchema } from "../schema/command.mjs";
7
- import { HelpThemeFactory } from "../help/theme.mjs";
6
+ import { Verbosity } from "../output/contracts.mjs";
7
+ import { CommandBuilder, CommandDefinition, CommandSchema, Out } from "../schema/command.mjs";
8
8
  import "../help/index.mjs";
9
- import "../output/index.mjs";
9
+ import { CapturedOutput } from "../output/index.mjs";
10
10
  import { RunOptions, RunResult } from "../schema/run.mjs";
11
11
  import { ParseOptions } from "../parse/index.mjs";
12
12
  import { BeforeParseParams, CLIPlugin, CLIPluginHooks, PluginCommandContext, ResolvedCommandParams, plugin } from "./plugin.mjs";
13
+ import { CompiledCLI } from "./compiled.mjs";
14
+ import { RuntimeAdapter } from "../../runtime/adapter.mjs";
15
+ import { PackageJsonData } from "../config/package-json.mjs";
13
16
  import { HelpLinks } from "./help-links.mjs";
14
17
  import { CompletionOptions } from "../completion/shells/shared.mjs";
15
18
  import { Shell } from "../completion/index.mjs";
16
- import { RuntimeAdapter } from "../../runtime/adapter.mjs";
17
- import { PackageJsonData } from "../config/package-json.mjs";
18
19
  import { FormatLoader } from "../config/index.mjs";
19
20
  import { Colors } from "ansispeck";
20
21
  //#region src/core/cli/index.d.ts
@@ -26,7 +27,7 @@ import { Colors } from "ansispeck";
26
27
  */
27
28
  interface CLISchema {
28
29
  /** Type-only seal produced by {@link createCLISchema}. */
29
- readonly [schemaBrand]: "cli";
30
+ readonly [schemaBrand]: 'cli';
30
31
  /** Program name (used in help text, usage lines, and completion scripts). */
31
32
  readonly name: string;
32
33
  /**
@@ -120,6 +121,16 @@ interface CLISchema {
120
121
  */
121
122
  readonly builtins: Builtins;
122
123
  }
124
+ /**
125
+ * Read the compiled state seeded by {@linkcode CLIBuilder._from}.
126
+ *
127
+ * @param builder - Builder to look up.
128
+ * @returns Its compiled execution graph.
129
+ * @throws {@linkcode CLIError} `INVALID_BUILDER_STATE` when the builder was not created by `cli()`.
130
+ *
131
+ * @internal
132
+ */
133
+ declare function compiledStateOf(builder: CLIBuilder): CompiledCLI;
123
134
  /**
124
135
  * Configuration for the eager `--completions <shell>` flag.
125
136
  *
@@ -174,7 +185,7 @@ interface HelpConfig {
174
185
  *
175
186
  * @defaultValue `'alphabetical'`
176
187
  */
177
- readonly flagOrder?: "alphabetical" | "declaration";
188
+ readonly flagOrder?: 'alphabetical' | 'declaration';
178
189
  /**
179
190
  * Custom comparator over flag long names for the `Flags:` table. When set,
180
191
  * it wins over {@link HelpConfig.flagOrder}.
@@ -193,6 +204,13 @@ interface HelpConfig {
193
204
  * @defaultValue `undefined` (built-in theme)
194
205
  */
195
206
  readonly theme?: HelpThemeFactory;
207
+ /**
208
+ * Theme overrides used only by function-form flag and argument descriptions.
209
+ * Each supplied role merges over the resolved global theme.
210
+ *
211
+ * @defaultValue `undefined` (use the global theme)
212
+ */
213
+ readonly descriptionTheme?: HelpThemeFactory;
196
214
  }
197
215
  /**
198
216
  * Config discovery settings for automatic config file loading.
@@ -202,7 +220,7 @@ interface HelpConfig {
202
220
  */
203
221
  interface ConfigSettings {
204
222
  /** Type-only seal produced by {@link createCLISchema}. */
205
- readonly [schemaBrand]: "config";
223
+ readonly [schemaBrand]: 'config';
206
224
  /**
207
225
  * Application name used to build config search paths.
208
226
  *
@@ -432,6 +450,22 @@ interface CLIRunOptions extends CLIExecuteOptions {
432
450
  */
433
451
  readonly adapter?: RuntimeAdapter;
434
452
  }
453
+ /**
454
+ * CLI execution options extended with the fields `.run()` and dispatch
455
+ * populate themselves.
456
+ *
457
+ * @internal
458
+ */
459
+ interface InternalCLIExecuteOptions extends CLIExecuteOptions {
460
+ /** Output channel override so activity renders to the terminal. */
461
+ readonly out?: Out;
462
+ /** Capture buffers override paired with `out`. */
463
+ readonly captured?: CapturedOutput;
464
+ /** CLI plugins registered on the builder. */
465
+ readonly plugins?: readonly CLIPlugin[];
466
+ /** Built-in flag state from the schema, threaded to the command executor. */
467
+ readonly builtins?: BuiltinsConfig;
468
+ }
435
469
  /**
436
470
  * Inputs for {@linkcode resolveRenderContext}. Pass the host facts (TTY
437
471
  * status, environment) and any explicit overrides; the resolver applies the
@@ -481,6 +515,13 @@ interface RenderContextOptions {
481
515
  */
482
516
  readonly builtins?: BuiltinsConfig;
483
517
  }
518
+ /**
519
+ * Seals {@linkcode RenderContext} against structural construction outside the
520
+ * framework.
521
+ *
522
+ * @internal
523
+ */
524
+ declare const renderContextBrand: unique symbol;
484
525
  /**
485
526
  * The output decisions the framework will make for a given argv, resolved
486
527
  * before `.run()`.
@@ -584,7 +625,19 @@ interface DefaultCommandOptions {
584
625
  * ```
585
626
  */
586
627
  declare class CLIBuilder {
628
+ /** @internal Runtime schema descriptor. */
629
+ readonly schema: CLISchema;
587
630
  private constructor();
631
+ /**
632
+ * Build a CLI builder around a schema and its compiled execution graph.
633
+ *
634
+ * @param schema - Runtime schema descriptor.
635
+ * @param compiled - Compiled commands, default command, and plugins.
636
+ * @returns The builder, with its compiled state registered.
637
+ *
638
+ * @internal
639
+ */
640
+ static _from(schema: CLISchema, compiled: CompiledCLI): CLIBuilder;
588
641
  /**
589
642
  * Set the program version (shown by `--version`).
590
643
  *
@@ -1000,6 +1053,18 @@ declare class CLIBuilder {
1000
1053
  */
1001
1054
  run(options?: CLIRunOptions): Promise<never>;
1002
1055
  }
1056
+ /**
1057
+ * Execution body shared by {@linkcode CLIBuilder.execute} and {@linkcode CLIBuilder.run},
1058
+ * accepting the framework-populated output channel and plugin fields.
1059
+ *
1060
+ * @param builder - Builder supplying the schema and compiled command graph.
1061
+ * @param argv - Raw argv tokens (NOT including the binary/script path).
1062
+ * @param options - Injectable runtime state plus framework-populated fields.
1063
+ * @returns Structured result with exit code and captured output.
1064
+ *
1065
+ * @internal
1066
+ */
1067
+ declare function executeCLI(builder: CLIBuilder, argv: readonly string[], options?: InternalCLIExecuteOptions): Promise<RunResult>;
1003
1068
  /**
1004
1069
  * CLI-name inference control for {@link ManifestSettings.inferName}.
1005
1070
  *
@@ -1012,7 +1077,7 @@ declare class CLIBuilder {
1012
1077
  * options object can never silently enable inference (use `true` for that).
1013
1078
  */
1014
1079
  type InferNameOption = boolean | {
1015
- readonly scope: "keep" | "strip";
1080
+ readonly scope: 'keep' | 'strip';
1016
1081
  };
1017
1082
  /** Discovery settings accepted by {@link CLIBuilder.manifest}. */
1018
1083
  interface ManifestSettings {
@@ -1086,7 +1151,7 @@ interface CLIOptions {
1086
1151
  * .run();
1087
1152
  * ```
1088
1153
  */
1089
- declare function cli(name: string, options?: Omit<CLIOptions, "name">): CLIBuilder;
1154
+ declare function cli(name: string, options?: Omit<CLIOptions, 'name'>): CLIBuilder;
1090
1155
  /** Create a new CLI program builder from an options object. */
1091
1156
  declare function cli(options: CLIOptions): CLIBuilder;
1092
1157
  /**
@@ -1108,4 +1173,4 @@ declare function cli(options: CLIOptions): CLIBuilder;
1108
1173
  */
1109
1174
  declare function isMainModule(meta: ImportMeta): boolean;
1110
1175
  //#endregion
1111
- export { type BeforeParseParams, type BuiltinMode, type BuiltinName, type Builtins, type BuiltinsConfig, CLIBuilder, type CLIDefinition, type CLIExecuteOptions, type CLIOptions, type CLIPlugin, type CLIPluginHooks, type CLIRunOptions, type CLISchema, type CompletionsFlagConfig, type ConfigSettings, type ConfigSettingsDefinition, type DefaultCommandOptions, type HelpConfig, type HelpLinks, type InferNameOption, type ManifestSettings, type PluginCommandContext, type RenderContext, type RenderContextOptions, type ResolvedCommandParams, type ResolvedManifestSettings, cli, createCLISchema, isMainModule, plugin, resolveRenderContext };
1176
+ export { type BeforeParseParams, type BuiltinMode, type BuiltinName, type Builtins, type BuiltinsConfig, CLIBuilder, type CLIDefinition, type CLIExecuteOptions, type CLIOptions, type CLIPlugin, type CLIPluginHooks, type CLIRunOptions, type CLISchema, type CompletionsFlagConfig, type ConfigSettings, type ConfigSettingsDefinition, type DefaultCommandOptions, type HelpConfig, type HelpLinks, type InferNameOption, type ManifestSettings, type PluginCommandContext, type RenderContext, type RenderContextOptions, type ResolvedCommandParams, type ResolvedManifestSettings, cli, compiledStateOf, createCLISchema, executeCLI, isMainModule, plugin, resolveRenderContext };
@@ -275,6 +275,10 @@ function resolveRenderContext(argv, options) {
275
275
  function hyperlinksOption(override) {
276
276
  return override !== void 0 ? { hyperlinks: override } : {};
277
277
  }
278
+ /** Resolve the hyperlink decision shared by help rendering and the output channel. @internal */
279
+ function resolveEffectiveHyperlinkOverride(runtimeHelp, configuredHelp, env, argv) {
280
+ return runtimeHelp?.hyperlinks ?? configuredHelp?.hyperlinks ?? resolveHyperlinkOverride(env, argv);
281
+ }
278
282
  /**
279
283
  * Build {@linkcode RunOptions} from {@linkcode CLIExecuteOptions}, conditionally spreading each
280
284
  * field to satisfy `exactOptionalPropertyTypes`.
@@ -856,6 +860,7 @@ var CLIBuilder = class CLIBuilder {
856
860
  ...options?.help,
857
861
  width: runtimeHelpWidth
858
862
  } : options?.help;
863
+ const hyperlinkOverride = resolveEffectiveHyperlinkOverride(runtimeHelpOptions, effectiveBuilder.schema.helpConfig, adapter.env, adapter.argv);
859
864
  const executeOptions = {
860
865
  ...options,
861
866
  ...preflight.inputs,
@@ -866,7 +871,7 @@ var CLIBuilder = class CLIBuilder {
866
871
  jsonMode: preflight.inputs.jsonMode,
867
872
  isTTY: preflight.inputs.isTTY,
868
873
  ...preflight.inputs.verbosity !== "normal" ? { verbosity: preflight.inputs.verbosity } : {},
869
- ...hyperlinksOption(resolveHyperlinkOverride(adapter.env, adapter.argv))
874
+ ...hyperlinksOption(hyperlinkOverride)
870
875
  })
871
876
  };
872
877
  const result = await executeCLI(effectiveBuilder, preflight.filteredArgv, executeOptions);
@@ -890,11 +895,12 @@ async function executeCLI(builder, argv, options) {
890
895
  const rootOutputFlags = readRootOutputFlags(argv, builder.schema.builtins);
891
896
  const jsonMode = resolveRootJsonMode(rootOutputFlags, options?.jsonMode);
892
897
  const verbosity = resolveRootVerbosity(rootOutputFlags, options?.verbosity);
898
+ const hyperlinkOverride = resolveEffectiveHyperlinkOverride(options?.help, builder.schema.helpConfig, options?.env ?? {}, argv);
893
899
  const captureOptions = {
894
900
  ...verbosity !== void 0 ? { verbosity } : {},
895
901
  ...jsonMode ? { jsonMode } : {},
896
902
  ...options?.isTTY !== void 0 ? { isTTY: options.isTTY } : {},
897
- ...hyperlinksOption(resolveHyperlinkOverride(options?.env ?? {}, argv))
903
+ ...hyperlinksOption(hyperlinkOverride)
898
904
  };
899
905
  let out;
900
906
  let captured;
@@ -912,7 +918,7 @@ async function executeCLI(builder, argv, options) {
912
918
  ...builder.schema.helpConfig,
913
919
  ...options?.help,
914
920
  binName: options?.help?.binName ?? builder.schema.name,
915
- hyperlinks: options?.help?.hyperlinks ?? builder.schema.helpConfig?.hyperlinks ?? out.isHyperlinkSupported,
921
+ hyperlinks: out.isHyperlinkSupported,
916
922
  colors: options?.help?.colors ?? out.color,
917
923
  ...resolvedVersion !== void 0 ? { version: resolvedVersion } : {}
918
924
  };
@@ -1,28 +1,64 @@
1
+ import { BuiltinsConfig } from "./builtins.mjs";
2
+ import { CLIError } from "../errors/index.mjs";
1
3
  import { OutputPolicy } from "../output/contracts.mjs";
2
4
  import { CommandMeta, CommandSchema } from "../schema/command.mjs";
3
- import { CLIError } from "../errors/index.mjs";
4
5
  import { HelpOptions } from "../help/index.mjs";
6
+ import { ParseOptions } from "../parse/index.mjs";
5
7
  import { CLIPlugin } from "./plugin.mjs";
6
- import { CompiledCommand } from "./compiled.mjs";
8
+ import { CompiledCLI, CompiledCommand } from "./compiled.mjs";
9
+ import { CompletionOptions } from "../completion/shells/shared.mjs";
10
+ import { Shell } from "../completion/index.mjs";
7
11
  //#region src/core/cli/planner.d.ts
12
+ /**
13
+ * Descriptive subset of CLISchema used by the planner.
14
+ *
15
+ * Decouples invocation planning from the full CLIBuilder surface so the
16
+ * planner can be tested and reasoned about without constructing a real CLI.
17
+ * The executable half of a program reaches the planner separately, as the
18
+ * {@linkcode CompiledCLI} passed alongside this schema.
19
+ * @internal
20
+ */
21
+ interface PlannerSchemaLike {
22
+ /** CLI program name used in help text and error messages. */
23
+ readonly name: string;
24
+ /** Declared version string; `undefined` disables `--version` interception. */
25
+ readonly version: string | undefined;
26
+ /** Whether the default command is also exposed as a named top-level route. */
27
+ readonly defaultCommandRouted: boolean;
28
+ /**
29
+ * Eager `--completions <shell>` flag configuration, when `.completions()`
30
+ * was registered with `{ as: 'flag' }`. `undefined` disables interception.
31
+ */
32
+ readonly completionsFlag: {
33
+ readonly shells: readonly Shell[];
34
+ readonly options: CompletionOptions | undefined;
35
+ } | undefined;
36
+ /** Flag-parsing behavior settings (case parity) applied to flag lookups. */
37
+ readonly flagSettings?: ParseOptions | undefined;
38
+ /**
39
+ * Built-in flag state. `help: 'off'` stops root `--help`/`-h` interception
40
+ * and bare `help` routing, and `json`/`quiet` stop being read out of argv.
41
+ */
42
+ readonly builtins: BuiltinsConfig | undefined;
43
+ }
8
44
  /** Root-level help interception outcome. */
9
45
  interface RootHelpOutcome {
10
46
  /** Discriminant — argv matched `--help` / `-h` before any command. */
11
- readonly kind: "root-help";
47
+ readonly kind: 'root-help';
12
48
  /** Help options to render root-level usage. */
13
49
  readonly help: HelpOptions;
14
50
  }
15
51
  /** Root-level version interception outcome. */
16
52
  interface RootVersionOutcome {
17
53
  /** Discriminant — argv matched `--version` / `-V` and schema declares a version. */
18
- readonly kind: "root-version";
54
+ readonly kind: 'root-version';
19
55
  /** Resolved version string to render. */
20
56
  readonly version: string;
21
57
  }
22
58
  /** Root-level `--completions [shell]` interception outcome. */
23
59
  interface RootCompletionsOutcome {
24
60
  /** Discriminant — argv matched the eager `--completions [shell]` flag. */
25
- readonly kind: "root-completions";
61
+ readonly kind: 'root-completions';
26
62
  /**
27
63
  * Resolved, validated target shell, or `undefined` when the flag was given
28
64
  * without a value and the shell should be auto-detected from the environment.
@@ -34,14 +70,14 @@ interface RootCompletionsOutcome {
34
70
  /** CLI-level dispatch failure before command execution starts. */
35
71
  interface DispatchErrorOutcome {
36
72
  /** Discriminant — dispatch could not resolve a command from argv. */
37
- readonly kind: "dispatch-error";
73
+ readonly kind: 'dispatch-error';
38
74
  /** Structured error with suggestion text for the caller to render. */
39
75
  readonly error: CLIError;
40
76
  }
41
77
  /** Successful planner handoff to the shared command execution path. */
42
78
  interface PlannerMatchOutcome {
43
79
  /** Discriminant — dispatch found a matching command for argv. */
44
- readonly kind: "match";
80
+ readonly kind: 'match';
45
81
  /** Fully resolved execution plan ready for the executor pipeline. */
46
82
  readonly plan: CommandExecutionPlan;
47
83
  }
@@ -83,6 +119,39 @@ interface BuildCommandExecutionPlanOptions {
83
119
  readonly output: OutputPolicy;
84
120
  readonly help: HelpOptions | undefined;
85
121
  }
122
+ /**
123
+ * Dispatch resolved a group command that requires a subcommand selection.
124
+ *
125
+ * The caller should render subcommand-level help for the matched group.
126
+ * @internal
127
+ */
128
+ interface NeedsSubcommandOutcome {
129
+ /** Discriminant — group command matched but no leaf subcommand was selected. */
130
+ readonly kind: 'needs-subcommand';
131
+ /** The group command that was matched. */
132
+ readonly command: CompiledCommand;
133
+ /** Full ancestor path from root to this group, used for propagated flag collection. */
134
+ readonly commandPath: readonly CommandSchema[];
135
+ /** Help options scoped to the group command's bin path. */
136
+ readonly help: HelpOptions;
137
+ }
138
+ /** Full planner result including the `needs-subcommand` variant used by CLIBuilder. @internal */
139
+ type InvocationPlan = DispatchOutcome | NeedsSubcommandOutcome;
140
+ /** Options bag for {@linkcode planInvocation}. @internal */
141
+ interface PlanInvocationOptions {
142
+ /** CLI schema subset driving dispatch decisions. */
143
+ readonly schema: PlannerSchemaLike;
144
+ /** Compiled execution graph the dispatch walk resolves commands from. */
145
+ readonly compiled: CompiledCLI;
146
+ /** Raw argv tokens (typically `adapter.argv.slice(2)`). */
147
+ readonly argv: readonly string[];
148
+ /** Root-level help configuration for rendering. */
149
+ readonly help: HelpOptions;
150
+ /** Output policy propagated into matched execution plans. */
151
+ readonly output: OutputPolicy;
152
+ }
153
+ /** Build a name+alias lookup map for top-level commands. @internal */
154
+ declare function buildRootCommandMap(commands: readonly CompiledCommand[]): ReadonlyMap<string, CompiledCommand>;
86
155
  /**
87
156
  * Merge propagated ancestor flags into the matched command schema.
88
157
  *
@@ -92,5 +161,14 @@ interface BuildCommandExecutionPlanOptions {
92
161
  declare function mergeCommandSchema(command: CompiledCommand, commandPath: readonly CommandSchema[]): CommandSchema;
93
162
  /** Build the planner handoff for a matched command invocation. */
94
163
  declare function buildCommandExecutionPlan(options: BuildCommandExecutionPlanOptions): CommandExecutionPlan;
164
+ /**
165
+ * Decide what to do with an argv invocation before any command executes.
166
+ *
167
+ * Handles root interception (`--help`, `--version`, `--completions <shell>`,
168
+ * bare `help` token), dispatches into the command tree, falls back to the
169
+ * default command, and produces structured errors for unknown commands/flags.
170
+ * @internal
171
+ */
172
+ declare function planInvocation(options: PlanInvocationOptions): InvocationPlan;
95
173
  //#endregion
96
- export { type CommandExecutionPlan, type DispatchErrorOutcome, type DispatchOutcome, type OutputPolicy, type PlannerMatchOutcome, type RootCompletionsOutcome, type RootHelpOutcome, type RootVersionOutcome, buildCommandExecutionPlan, mergeCommandSchema };
174
+ export { type CommandExecutionPlan, type DispatchErrorOutcome, type DispatchOutcome, type InvocationPlan, type NeedsSubcommandOutcome, type OutputPolicy, type PlanInvocationOptions, type PlannerMatchOutcome, type PlannerSchemaLike, type RootCompletionsOutcome, type RootHelpOutcome, type RootVersionOutcome, buildCommandExecutionPlan, buildRootCommandMap, mergeCommandSchema, planInvocation };