@kjanat/dreamcli 3.0.0-rc.9 → 3.0.1

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 (502) hide show
  1. package/CHANGELOG.md +262 -1
  2. package/README.md +32 -13
  3. package/dist/core/cli/dispatch.mjs +0 -11
  4. package/dist/core/cli/index.d.mts +133 -9
  5. package/dist/core/cli/index.mjs +108 -21
  6. package/dist/core/cli/planner.mjs +7 -1
  7. package/dist/core/cli/root-help.mjs +5 -0
  8. package/dist/core/cli/runtime-preflight.d.mts +4 -0
  9. package/dist/core/cli/runtime-preflight.mjs +5 -3
  10. package/dist/core/completion/shells/shared.mjs +1 -0
  11. package/dist/core/config/index.d.mts +43 -12
  12. package/dist/core/config/index.mjs +55 -16
  13. package/dist/core/config/package-json.d.mts +1 -0
  14. package/dist/core/errors/index.d.mts +2 -2
  15. package/dist/core/execution/index.mjs +6 -2
  16. package/dist/core/help/ansi.d.mts +11 -5
  17. package/dist/core/help/ansi.mjs +14 -16
  18. package/dist/core/help/index.d.mts +22 -0
  19. package/dist/core/help/index.mjs +75 -25
  20. package/dist/core/json-schema/index.d.mts +7 -8
  21. package/dist/core/json-schema/index.mjs +271 -88
  22. package/dist/core/json-schema/meta-descriptions.generated.d.mts +40 -40
  23. package/dist/core/output/contracts.d.mts +5 -5
  24. package/dist/core/output/contracts.mjs +1 -1
  25. package/dist/core/output/index.d.mts +38 -1
  26. package/dist/core/output/index.mjs +37 -2
  27. package/dist/core/parse/index.mjs +9 -6
  28. package/dist/core/resolve/contracts.d.mts +7 -2
  29. package/dist/core/resolve/flags.d.mts +3 -1
  30. package/dist/core/resolve/flags.mjs +29 -12
  31. package/dist/core/resolve/index.mjs +6 -1
  32. package/dist/core/resolve/property.d.mts +1 -1
  33. package/dist/core/resolve/standard.d.mts +24 -0
  34. package/dist/core/resolve/standard.mjs +114 -0
  35. package/dist/core/schema/arg.d.mts +37 -2
  36. package/dist/core/schema/arg.mjs +5 -2
  37. package/dist/core/schema/command.d.mts +49 -7
  38. package/dist/core/schema/command.mjs +15 -5
  39. package/dist/core/schema/flag.d.mts +77 -9
  40. package/dist/core/schema/flag.mjs +7 -3
  41. package/dist/core/schema/index.d.mts +3 -2
  42. package/dist/core/schema/prompt.d.mts +1 -1
  43. package/dist/core/schema/run.d.mts +7 -0
  44. package/dist/core/schema/standard.d.mts +100 -0
  45. package/dist/core/schema/standard.mjs +15 -0
  46. package/dist/core/testkit/index.d.mts +7 -5
  47. package/dist/core/testkit/index.mjs +12 -7
  48. package/dist/index.d.mts +5 -4
  49. package/dist/index.mjs +4 -4
  50. package/dist/runtime/adapter.d.mts +33 -0
  51. package/dist/runtime/adapter.mjs +6 -1
  52. package/dist/runtime/deno.d.mts +4 -0
  53. package/dist/runtime/deno.mjs +4 -1
  54. package/dist/runtime/node.mjs +9 -1
  55. package/dist/version.mjs +2 -2
  56. package/dreamcli.schema.json +82 -0
  57. package/examples/basic.ts +2 -2
  58. package/examples/flag-types.ts +79 -0
  59. package/examples/gh/node_modules/typescript/LICENSE +55 -0
  60. package/examples/gh/node_modules/typescript/NOTICE.txt +436 -0
  61. package/examples/gh/node_modules/typescript/README.md +49 -0
  62. package/examples/gh/node_modules/typescript/bin/tsc +2 -0
  63. package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts +529 -0
  64. package/examples/gh/node_modules/typescript/dist/api/async/api.d.ts.map +1 -0
  65. package/examples/gh/node_modules/typescript/dist/api/async/api.js +1657 -0
  66. package/examples/gh/node_modules/typescript/dist/api/async/api.js.map +1 -0
  67. package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts +39 -0
  68. package/examples/gh/node_modules/typescript/dist/api/async/client.d.ts.map +1 -0
  69. package/examples/gh/node_modules/typescript/dist/api/async/client.js +211 -0
  70. package/examples/gh/node_modules/typescript/dist/api/async/client.js.map +1 -0
  71. package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts +310 -0
  72. package/examples/gh/node_modules/typescript/dist/api/async/types.d.ts.map +1 -0
  73. package/examples/gh/node_modules/typescript/dist/api/async/types.js +2 -0
  74. package/examples/gh/node_modules/typescript/dist/api/async/types.js.map +1 -0
  75. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts +109 -0
  76. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.d.ts.map +1 -0
  77. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js +2 -0
  78. package/examples/gh/node_modules/typescript/dist/api/compilerOptions.js.map +1 -0
  79. package/examples/gh/node_modules/typescript/dist/api/fs.d.ts +23 -0
  80. package/examples/gh/node_modules/typescript/dist/api/fs.d.ts.map +1 -0
  81. package/examples/gh/node_modules/typescript/dist/api/fs.js +109 -0
  82. package/examples/gh/node_modules/typescript/dist/api/fs.js.map +1 -0
  83. package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts +15 -0
  84. package/examples/gh/node_modules/typescript/dist/api/node/encoder.d.ts.map +1 -0
  85. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts +5 -0
  86. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.d.ts.map +1 -0
  87. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js +74 -0
  88. package/examples/gh/node_modules/typescript/dist/api/node/encoder.generated.js.map +1 -0
  89. package/examples/gh/node_modules/typescript/dist/api/node/encoder.js +287 -0
  90. package/examples/gh/node_modules/typescript/dist/api/node/encoder.js.map +1 -0
  91. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts +32 -0
  92. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.d.ts.map +1 -0
  93. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js +213 -0
  94. package/examples/gh/node_modules/typescript/dist/api/node/msgpack.js.map +1 -0
  95. package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts +76 -0
  96. package/examples/gh/node_modules/typescript/dist/api/node/node.d.ts.map +1 -0
  97. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts +182 -0
  98. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.d.ts.map +1 -0
  99. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js +835 -0
  100. package/examples/gh/node_modules/typescript/dist/api/node/node.generated.js.map +1 -0
  101. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts +62 -0
  102. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.d.ts.map +1 -0
  103. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js +122 -0
  104. package/examples/gh/node_modules/typescript/dist/api/node/node.infrastructure.js.map +1 -0
  105. package/examples/gh/node_modules/typescript/dist/api/node/node.js +298 -0
  106. package/examples/gh/node_modules/typescript/dist/api/node/node.js.map +1 -0
  107. package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts +29 -0
  108. package/examples/gh/node_modules/typescript/dist/api/node/protocol.d.ts.map +1 -0
  109. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts +4 -0
  110. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.d.ts.map +1 -0
  111. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js +241 -0
  112. package/examples/gh/node_modules/typescript/dist/api/node/protocol.generated.js.map +1 -0
  113. package/examples/gh/node_modules/typescript/dist/api/node/protocol.js +30 -0
  114. package/examples/gh/node_modules/typescript/dist/api/node/protocol.js.map +1 -0
  115. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts +6 -0
  116. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.d.ts.map +1 -0
  117. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js +61 -0
  118. package/examples/gh/node_modules/typescript/dist/api/node/wtf8.js.map +1 -0
  119. package/examples/gh/node_modules/typescript/dist/api/options.d.ts +32 -0
  120. package/examples/gh/node_modules/typescript/dist/api/options.d.ts.map +1 -0
  121. package/examples/gh/node_modules/typescript/dist/api/options.js +11 -0
  122. package/examples/gh/node_modules/typescript/dist/api/options.js.map +1 -0
  123. package/examples/gh/node_modules/typescript/dist/api/path.d.ts +110 -0
  124. package/examples/gh/node_modules/typescript/dist/api/path.d.ts.map +1 -0
  125. package/examples/gh/node_modules/typescript/dist/api/path.js +508 -0
  126. package/examples/gh/node_modules/typescript/dist/api/path.js.map +1 -0
  127. package/examples/gh/node_modules/typescript/dist/api/proto.d.ts +239 -0
  128. package/examples/gh/node_modules/typescript/dist/api/proto.d.ts.map +1 -0
  129. package/examples/gh/node_modules/typescript/dist/api/proto.js +37 -0
  130. package/examples/gh/node_modules/typescript/dist/api/proto.js.map +1 -0
  131. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts +79 -0
  132. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.d.ts.map +1 -0
  133. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js +169 -0
  134. package/examples/gh/node_modules/typescript/dist/api/sourceFileCache.js.map +1 -0
  135. package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts +529 -0
  136. package/examples/gh/node_modules/typescript/dist/api/sync/api.d.ts.map +1 -0
  137. package/examples/gh/node_modules/typescript/dist/api/sync/api.js +1665 -0
  138. package/examples/gh/node_modules/typescript/dist/api/sync/api.js.map +1 -0
  139. package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts +30 -0
  140. package/examples/gh/node_modules/typescript/dist/api/sync/client.d.ts.map +1 -0
  141. package/examples/gh/node_modules/typescript/dist/api/sync/client.js +124 -0
  142. package/examples/gh/node_modules/typescript/dist/api/sync/client.js.map +1 -0
  143. package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts +310 -0
  144. package/examples/gh/node_modules/typescript/dist/api/sync/types.d.ts.map +1 -0
  145. package/examples/gh/node_modules/typescript/dist/api/sync/types.js +2 -0
  146. package/examples/gh/node_modules/typescript/dist/api/sync/types.js.map +1 -0
  147. package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts +114 -0
  148. package/examples/gh/node_modules/typescript/dist/api/syncChannel.d.ts.map +1 -0
  149. package/examples/gh/node_modules/typescript/dist/api/syncChannel.js +508 -0
  150. package/examples/gh/node_modules/typescript/dist/api/syncChannel.js.map +1 -0
  151. package/examples/gh/node_modules/typescript/dist/api/timing.d.ts +175 -0
  152. package/examples/gh/node_modules/typescript/dist/api/timing.d.ts.map +1 -0
  153. package/examples/gh/node_modules/typescript/dist/api/timing.js +149 -0
  154. package/examples/gh/node_modules/typescript/dist/api/timing.js.map +1 -0
  155. package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts +100 -0
  156. package/examples/gh/node_modules/typescript/dist/ast/ast.d.ts.map +1 -0
  157. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts +1161 -0
  158. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.d.ts.map +1 -0
  159. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js +4 -0
  160. package/examples/gh/node_modules/typescript/dist/ast/ast.generated.js.map +1 -0
  161. package/examples/gh/node_modules/typescript/dist/ast/ast.js +7 -0
  162. package/examples/gh/node_modules/typescript/dist/ast/ast.js.map +1 -0
  163. package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts +19 -0
  164. package/examples/gh/node_modules/typescript/dist/ast/astnav.d.ts.map +1 -0
  165. package/examples/gh/node_modules/typescript/dist/ast/astnav.js +596 -0
  166. package/examples/gh/node_modules/typescript/dist/ast/astnav.js.map +1 -0
  167. package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts +16 -0
  168. package/examples/gh/node_modules/typescript/dist/ast/clone.d.ts.map +1 -0
  169. package/examples/gh/node_modules/typescript/dist/ast/clone.js +104 -0
  170. package/examples/gh/node_modules/typescript/dist/ast/clone.js.map +1 -0
  171. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts +520 -0
  172. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.d.ts.map +1 -0
  173. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js +3057 -0
  174. package/examples/gh/node_modules/typescript/dist/ast/factory.generated.js.map +1 -0
  175. package/examples/gh/node_modules/typescript/dist/ast/index.d.ts +20 -0
  176. package/examples/gh/node_modules/typescript/dist/ast/index.d.ts.map +1 -0
  177. package/examples/gh/node_modules/typescript/dist/ast/index.js +20 -0
  178. package/examples/gh/node_modules/typescript/dist/ast/index.js.map +1 -0
  179. package/examples/gh/node_modules/typescript/dist/ast/is.d.ts +35 -0
  180. package/examples/gh/node_modules/typescript/dist/ast/is.d.ts.map +1 -0
  181. package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts +329 -0
  182. package/examples/gh/node_modules/typescript/dist/ast/is.generated.d.ts.map +1 -0
  183. package/examples/gh/node_modules/typescript/dist/ast/is.generated.js +1103 -0
  184. package/examples/gh/node_modules/typescript/dist/ast/is.generated.js.map +1 -0
  185. package/examples/gh/node_modules/typescript/dist/ast/is.js +233 -0
  186. package/examples/gh/node_modules/typescript/dist/ast/is.js.map +1 -0
  187. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts +11 -0
  188. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.d.ts.map +1 -0
  189. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js +202 -0
  190. package/examples/gh/node_modules/typescript/dist/ast/jsdoc.js.map +1 -0
  191. package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts +97 -0
  192. package/examples/gh/node_modules/typescript/dist/ast/scanner.d.ts.map +1 -0
  193. package/examples/gh/node_modules/typescript/dist/ast/scanner.js +2230 -0
  194. package/examples/gh/node_modules/typescript/dist/ast/scanner.js.map +1 -0
  195. package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts +17 -0
  196. package/examples/gh/node_modules/typescript/dist/ast/utils.d.ts.map +1 -0
  197. package/examples/gh/node_modules/typescript/dist/ast/utils.js +67 -0
  198. package/examples/gh/node_modules/typescript/dist/ast/utils.js.map +1 -0
  199. package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts +14 -0
  200. package/examples/gh/node_modules/typescript/dist/ast/visitor.d.ts.map +1 -0
  201. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts +50 -0
  202. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.d.ts.map +1 -0
  203. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js +978 -0
  204. package/examples/gh/node_modules/typescript/dist/ast/visitor.generated.js.map +1 -0
  205. package/examples/gh/node_modules/typescript/dist/ast/visitor.js +47 -0
  206. package/examples/gh/node_modules/typescript/dist/ast/visitor.js.map +1 -0
  207. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts +2 -0
  208. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.d.ts.map +1 -0
  209. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts +129 -0
  210. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.d.ts.map +1 -0
  211. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js +132 -0
  212. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.enum.js.map +1 -0
  213. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js +130 -0
  214. package/examples/gh/node_modules/typescript/dist/enums/characterCodes.js.map +1 -0
  215. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts +2 -0
  216. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.d.ts.map +1 -0
  217. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts +5 -0
  218. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.d.ts.map +1 -0
  219. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js +6 -0
  220. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.enum.js.map +1 -0
  221. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js +6 -0
  222. package/examples/gh/node_modules/typescript/dist/enums/commentDirectiveType.js.map +1 -0
  223. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts +2 -0
  224. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.d.ts.map +1 -0
  225. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts +28 -0
  226. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.d.ts.map +1 -0
  227. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js +30 -0
  228. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.enum.js.map +1 -0
  229. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js +30 -0
  230. package/examples/gh/node_modules/typescript/dist/enums/completionItemKind.js.map +1 -0
  231. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts +2 -0
  232. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.d.ts.map +1 -0
  233. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts +7 -0
  234. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.d.ts.map +1 -0
  235. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js +9 -0
  236. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.enum.js.map +1 -0
  237. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js +9 -0
  238. package/examples/gh/node_modules/typescript/dist/enums/diagnosticCategory.js.map +1 -0
  239. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts +2 -0
  240. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.d.ts.map +1 -0
  241. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts +12 -0
  242. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.d.ts.map +1 -0
  243. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js +14 -0
  244. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.enum.js.map +1 -0
  245. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js +14 -0
  246. package/examples/gh/node_modules/typescript/dist/enums/elementFlags.js.map +1 -0
  247. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts +2 -0
  248. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.d.ts.map +1 -0
  249. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts +23 -0
  250. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.d.ts.map +1 -0
  251. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js +25 -0
  252. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.enum.js.map +1 -0
  253. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js +25 -0
  254. package/examples/gh/node_modules/typescript/dist/enums/internalSymbolName.js.map +1 -0
  255. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts +2 -0
  256. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.d.ts.map +1 -0
  257. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts +9 -0
  258. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.d.ts.map +1 -0
  259. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js +11 -0
  260. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.enum.js.map +1 -0
  261. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js +11 -0
  262. package/examples/gh/node_modules/typescript/dist/enums/jsxEmit.js.map +1 -0
  263. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts +2 -0
  264. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.d.ts.map +1 -0
  265. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts +5 -0
  266. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.d.ts.map +1 -0
  267. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js +6 -0
  268. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.enum.js.map +1 -0
  269. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js +6 -0
  270. package/examples/gh/node_modules/typescript/dist/enums/languageVariant.js.map +1 -0
  271. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts +2 -0
  272. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.d.ts.map +1 -0
  273. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts +42 -0
  274. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.d.ts.map +1 -0
  275. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js +44 -0
  276. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.enum.js.map +1 -0
  277. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js +44 -0
  278. package/examples/gh/node_modules/typescript/dist/enums/modifierFlags.js.map +1 -0
  279. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts +2 -0
  280. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.d.ts.map +1 -0
  281. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts +7 -0
  282. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.d.ts.map +1 -0
  283. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js +9 -0
  284. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.enum.js.map +1 -0
  285. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js +9 -0
  286. package/examples/gh/node_modules/typescript/dist/enums/moduleDetectionKind.js.map +1 -0
  287. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts +2 -0
  288. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.d.ts.map +1 -0
  289. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts +17 -0
  290. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.d.ts.map +1 -0
  291. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js +19 -0
  292. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.enum.js.map +1 -0
  293. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js +19 -0
  294. package/examples/gh/node_modules/typescript/dist/enums/moduleKind.js.map +1 -0
  295. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts +2 -0
  296. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.d.ts.map +1 -0
  297. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts +9 -0
  298. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.d.ts.map +1 -0
  299. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js +11 -0
  300. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.enum.js.map +1 -0
  301. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js +11 -0
  302. package/examples/gh/node_modules/typescript/dist/enums/moduleResolutionKind.js.map +1 -0
  303. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts +2 -0
  304. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.d.ts.map +1 -0
  305. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts +6 -0
  306. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.d.ts.map +1 -0
  307. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js +8 -0
  308. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.enum.js.map +1 -0
  309. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js +8 -0
  310. package/examples/gh/node_modules/typescript/dist/enums/newLineKind.js.map +1 -0
  311. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts +2 -0
  312. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.d.ts.map +1 -0
  313. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts +36 -0
  314. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.d.ts.map +1 -0
  315. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js +38 -0
  316. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.enum.js.map +1 -0
  317. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js +38 -0
  318. package/examples/gh/node_modules/typescript/dist/enums/nodeBuilderFlags.js.map +1 -0
  319. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts +2 -0
  320. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.d.ts.map +1 -0
  321. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts +44 -0
  322. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.d.ts.map +1 -0
  323. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js +46 -0
  324. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.enum.js.map +1 -0
  325. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js +46 -0
  326. package/examples/gh/node_modules/typescript/dist/enums/nodeFlags.js.map +1 -0
  327. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts +2 -0
  328. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.d.ts.map +1 -0
  329. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts +50 -0
  330. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.d.ts.map +1 -0
  331. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js +52 -0
  332. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.enum.js.map +1 -0
  333. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js +52 -0
  334. package/examples/gh/node_modules/typescript/dist/enums/objectFlags.js.map +1 -0
  335. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts +2 -0
  336. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.d.ts.map +1 -0
  337. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts +16 -0
  338. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.d.ts.map +1 -0
  339. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js +18 -0
  340. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.enum.js.map +1 -0
  341. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js +18 -0
  342. package/examples/gh/node_modules/typescript/dist/enums/outerExpressionKinds.js.map +1 -0
  343. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts +2 -0
  344. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.d.ts.map +1 -0
  345. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts +13 -0
  346. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.d.ts.map +1 -0
  347. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js +14 -0
  348. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.enum.js.map +1 -0
  349. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js +14 -0
  350. package/examples/gh/node_modules/typescript/dist/enums/regularExpressionFlags.js.map +1 -0
  351. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts +2 -0
  352. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.d.ts.map +1 -0
  353. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts +11 -0
  354. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.d.ts.map +1 -0
  355. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js +12 -0
  356. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.enum.js.map +1 -0
  357. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js +12 -0
  358. package/examples/gh/node_modules/typescript/dist/enums/scriptKind.js.map +1 -0
  359. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts +2 -0
  360. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.d.ts.map +1 -0
  361. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts +17 -0
  362. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.d.ts.map +1 -0
  363. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js +18 -0
  364. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.enum.js.map +1 -0
  365. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js +18 -0
  366. package/examples/gh/node_modules/typescript/dist/enums/scriptTarget.js.map +1 -0
  367. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts +2 -0
  368. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.d.ts.map +1 -0
  369. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts +15 -0
  370. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.d.ts.map +1 -0
  371. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js +17 -0
  372. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.enum.js.map +1 -0
  373. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js +17 -0
  374. package/examples/gh/node_modules/typescript/dist/enums/signatureFlags.js.map +1 -0
  375. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts +2 -0
  376. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.d.ts.map +1 -0
  377. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts +5 -0
  378. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.d.ts.map +1 -0
  379. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js +7 -0
  380. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.enum.js.map +1 -0
  381. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js +7 -0
  382. package/examples/gh/node_modules/typescript/dist/enums/signatureKind.js.map +1 -0
  383. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts +2 -0
  384. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.d.ts.map +1 -0
  385. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts +71 -0
  386. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.d.ts.map +1 -0
  387. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js +73 -0
  388. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.enum.js.map +1 -0
  389. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js +73 -0
  390. package/examples/gh/node_modules/typescript/dist/enums/symbolFlags.js.map +1 -0
  391. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts +2 -0
  392. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.d.ts.map +1 -0
  393. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts +389 -0
  394. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.d.ts.map +1 -0
  395. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js +391 -0
  396. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.enum.js.map +1 -0
  397. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js +391 -0
  398. package/examples/gh/node_modules/typescript/dist/enums/syntaxKind.js.map +1 -0
  399. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts +2 -0
  400. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.d.ts.map +1 -0
  401. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts +30 -0
  402. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.d.ts.map +1 -0
  403. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js +32 -0
  404. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.enum.js.map +1 -0
  405. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js +32 -0
  406. package/examples/gh/node_modules/typescript/dist/enums/tokenFlags.js.map +1 -0
  407. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts +2 -0
  408. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.d.ts.map +1 -0
  409. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts +76 -0
  410. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.d.ts.map +1 -0
  411. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js +78 -0
  412. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.enum.js.map +1 -0
  413. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js +78 -0
  414. package/examples/gh/node_modules/typescript/dist/enums/typeFlags.js.map +1 -0
  415. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts +2 -0
  416. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.d.ts.map +1 -0
  417. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts +7 -0
  418. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.d.ts.map +1 -0
  419. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js +9 -0
  420. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.enum.js.map +1 -0
  421. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js +9 -0
  422. package/examples/gh/node_modules/typescript/dist/enums/typePredicateKind.js.map +1 -0
  423. package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts +23 -0
  424. package/examples/gh/node_modules/typescript/dist/internal/utils.d.ts.map +1 -0
  425. package/examples/gh/node_modules/typescript/dist/internal/utils.js +25 -0
  426. package/examples/gh/node_modules/typescript/dist/internal/utils.js.map +1 -0
  427. package/examples/gh/node_modules/typescript/lib/getExePath.d.ts +2 -0
  428. package/examples/gh/node_modules/typescript/lib/getExePath.js +70 -0
  429. package/examples/gh/node_modules/typescript/lib/tsc.js +28 -0
  430. package/examples/gh/node_modules/typescript/lib/version.cjs +3 -0
  431. package/examples/gh/node_modules/typescript/lib/version.d.cts +2 -0
  432. package/examples/gh/node_modules/typescript/package.json +87 -0
  433. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/License.txt +11 -0
  434. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/README.md +54 -0
  435. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.d.ts +17 -0
  436. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/main.js +83 -0
  437. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.d.ts +22 -0
  438. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/browser/ril.js +210 -0
  439. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.d.ts +14 -0
  440. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/api.js +87 -0
  441. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.d.ts +32 -0
  442. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/cancellation.js +132 -0
  443. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.d.ts +367 -0
  444. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/connection.js +1271 -0
  445. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.d.ts +9 -0
  446. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/disposable.js +16 -0
  447. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.d.ts +52 -0
  448. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/encoding.js +70 -0
  449. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.d.ts +39 -0
  450. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/events.js +135 -0
  451. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.d.ts +7 -0
  452. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/is.js +34 -0
  453. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.d.ts +55 -0
  454. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/linkedMap.js +412 -0
  455. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.d.ts +18 -0
  456. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageBuffer.js +155 -0
  457. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.d.ts +77 -0
  458. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageReader.js +246 -0
  459. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.d.ts +60 -0
  460. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messageWriter.js +157 -0
  461. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.d.ts +369 -0
  462. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/messages.js +436 -0
  463. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.d.ts +74 -0
  464. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/ral.js +23 -0
  465. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.d.ts +10 -0
  466. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/semaphore.js +74 -0
  467. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.d.ts +15 -0
  468. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/common/sharedArrayCancellation.js +77 -0
  469. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.d.ts +58 -0
  470. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/main.js +289 -0
  471. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.d.ts +12 -0
  472. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/lib/node/ril.js +163 -0
  473. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/package.json +54 -0
  474. package/examples/gh/node_modules/typescript/vendor/vscode-jsonrpc/typings/thenable.d.ts +5 -0
  475. package/examples/gh/package.json +11 -5
  476. package/examples/gh/src/main.ts +10 -4
  477. package/examples/help-config.ts +43 -0
  478. package/examples/json-mode.ts +8 -4
  479. package/examples/middleware.ts +1 -1
  480. package/examples/output-extras.ts +46 -0
  481. package/examples/parser-control.ts +40 -0
  482. package/examples/pwsh-demo/package.json +1 -1
  483. package/examples/pwsh-demo/src/main.ts +1 -1
  484. package/examples/standard-schema.ts +45 -0
  485. package/examples/transport-launcher.ts +10 -10
  486. package/package.json +26 -31
  487. package/skills/cli-creation/SKILL.md +140 -0
  488. package/skills/cli-creation/agents/openai.yaml +4 -0
  489. package/skills/cli-creation/assets/templates/multi-command.bun-test.ts.tpl +20 -0
  490. package/skills/cli-creation/assets/templates/multi-command.test.ts.tpl +20 -0
  491. package/skills/cli-creation/assets/templates/multi-command.ts.tpl +89 -0
  492. package/skills/cli-creation/assets/templates/single-command.bun-test.ts.tpl +29 -0
  493. package/skills/cli-creation/assets/templates/single-command.test.ts.tpl +29 -0
  494. package/skills/cli-creation/assets/templates/single-command.ts.tpl +47 -0
  495. package/skills/cli-creation/references/consumer-workflow.md +65 -0
  496. package/skills/cli-creation/references/pattern-cookbook.md +293 -0
  497. package/skills/cli-creation/references/runtime-notes.md +29 -0
  498. package/skills/cli-creation/scripts/scaffold_cli.py +360 -0
  499. package/dist/core/schema-dsl/runtime.d.mts +0 -144
  500. package/dist/core/schema-dsl/runtime.mjs +0 -271
  501. package/dist/core/schema-dsl/to-json-schema.d.mts +0 -29
  502. package/dist/core/schema-dsl/to-json-schema.mjs +0 -74
package/CHANGELOG.md CHANGED
@@ -7,6 +7,259 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [3.0.1] - 2026-07-21
11
+
12
+ No library code changed; this release ships agent-facing material that was
13
+ being built but never published.
14
+
15
+ ### Added
16
+
17
+ - **The `cli-creation` skill now ships in the package** — `skills/` was absent
18
+ from npm's `files` and JSR's `publish.include`, so consumers installing from
19
+ either registry never received it.
20
+ - **Documentation lookup paths in the `cli-creation` skill** — `deno doc`
21
+ against JSR (works whether the consumer installed from npm or JSR, including
22
+ subpaths, `--json`, and `--filter`), plus the site's `llms.txt`,
23
+ `llms-full.txt`, and `/raw/` markdown endpoints, so API shapes are read from
24
+ the published package rather than recalled.
25
+
26
+ ## [3.0.0] - 2026-07-21
27
+
28
+ The stable 3.0.0 release. It ships the code of 3.0.0-rc.20 plus the fix and
29
+ documentation below; the complete v3 feature record lives in the rc.1 - rc.20
30
+ sections that follow. Upgrading from 2.x is covered by the new
31
+ [upgrade guide](https://dreamcli.kjanat.dev/guide/upgrading-v3).
32
+
33
+ ### Fixed
34
+
35
+ - **`runCommand()` rejected `--quiet`/`-q`** — the testkit gained the root-flag
36
+ layer for `--json` in rc.1, but `--quiet` (added in rc.17) was never taught to
37
+ it, so copying a real `mycli --quiet …` invocation into a test failed with
38
+ `Unknown flag` (exit 2). Both spellings are now detected before the `--`
39
+ separator, set quiet verbosity, and are stripped before parsing; a literal
40
+ post-separator `--quiet` still reaches the command.
41
+ - **Mobile documentation hovers** — the twoslash bottom sheet collapsed to a
42
+ 2px sliver (a transformed popper ancestor became the containing block for the
43
+ fixed sheet), its backdrop stayed over the page after dismissal, and closing a
44
+ popup disabled it permanently via an inline `display: none`.
45
+
46
+ ### Added
47
+
48
+ - **Upgrade guide** — `docs/guide/upgrading-v3.md` documents every 2.5.0 →
49
+ 3.0.0 breaking and behavioral change with before/after code.
50
+ - **Five new examples** covering the v3 surface: `flag-types.ts` (url, path
51
+ with `create`, date, duration, bytes, count, keyValue, constraints, array
52
+ separator/unique), `parser-control.ts` (negatable, duplicates, spelling
53
+ parity), `standard-schema.ts` (Standard Schema v1 interop),
54
+ `help-config.ts` (themes, `flagOrder`, routable default, JSON help),
55
+ `output-extras.ts` (`out.color`, hyperlink gating, `setExitCode`).
56
+
57
+ ### Changed
58
+
59
+ - **Examples modernized** — `basic.ts` uses function-form `.example()`,
60
+ `json-mode.ts` and `middleware.ts` use `out.status()` and document
61
+ `--quiet`, `transport-launcher.ts` replaces its hand-rolled port check
62
+ with declarative numeric constraints.
63
+ - **`skills/cli-creation` rewritten for v3** — corrected stale grounding paths
64
+ (`examples/standalone/`, `apps/docs/` no longer exist), rebuilt the pattern
65
+ cookbook around the v3 surface with every snippet type-checked against the
66
+ published types, and modernized the scaffolder templates (function-form
67
+ examples, declarative numeric constraints instead of hand-clamping,
68
+ `out.status()`, a `--quiet` test).
69
+ - **README refreshed** — the flag-types block lists the full v3 family
70
+ (dropping the `flag.custom` URL sample that `flag.url()` superseded), the
71
+ output sample shows `out.status()` / `out.setExitCode()` / `--quiet`, the
72
+ completions sample covers the eager-flag form and fixes a
73
+ `completion`/`completions` typo.
74
+
75
+ ## [3.0.0-rc.20] - 2026-07-21
76
+
77
+ ### Changed
78
+
79
+ - **ansispeck `^0.4.1`** — bumped from `^0.2.0` (npm dependency and JSR
80
+ import map).
81
+
82
+ ## [3.0.0-rc.19] - 2026-07-21
83
+
84
+ ### Added
85
+
86
+ - **Expanded config discovery** (#61) — the default search now covers three
87
+ scopes, first match wins, no merging:
88
+ 1. **Project**: the base directory (default `cwd`) and every ancestor up
89
+ to the filesystem root, nearest first, each probed for
90
+ `.{appName}.{ext}`, `{appName}.config.{ext}`, and the new
91
+ `.config/{appName}.{ext}` convention.
92
+ 2. **User**: XDG / AppData as before, plus
93
+ `~/Library/Application Support/{appName}/config.{ext}` on macOS.
94
+ 3. **System**: `/etc/{appName}/config.{ext}` on Linux and macOS.
95
+ - **`baseDir` discovery option** — `discoverConfig()` accepts a base
96
+ directory to anchor the project-scope walk somewhere other than `cwd`.
97
+ - **`RuntimeAdapter.userConfigDirs` / `systemConfigDirs`** — optional
98
+ ordered config roots supplied by the runtime adapters; discovery falls
99
+ back to `[configDir]` / `[]` when a custom adapter omits them.
100
+
101
+ ### Changed
102
+
103
+ - **Breaking**: `buildConfigSearchPaths(appName, options)` replaces the
104
+ positional `(appName, cwd, configDir, loaders?)` signature; options carry
105
+ `baseDir`, `userConfigDirs`, `systemConfigDirs`, and `loaders`.
106
+
107
+ ## [3.0.0-rc.18] - 2026-07-21
108
+
109
+ ### Added
110
+
111
+ - **`flag.path({ type: 'directory', create: true })`** — creates the directory
112
+ (recursively) at resolution time when nothing exists at the path. Only
113
+ available with `type: 'directory'`, enforced at the type level. Creation
114
+ runs through a new `mkdir` seam: `RuntimeAdapter.mkdir`, overridable via
115
+ run options, noop in the test adapter, so `src/core` stays process-free.
116
+
117
+ ### Fixed
118
+
119
+ - **`flag.path({ type, mustExist: false })` rejected missing paths** — the
120
+ builder recorded the explicit `mustExist: false`, but resolution errored on
121
+ any missing path whenever path checks were active, making an optional
122
+ to-be-created path (e.g. an `--outdir` that the command itself creates)
123
+ impossible to declare. A missing path now passes when `mustExist` is
124
+ `false`; an existing path is still type-checked.
125
+
126
+ ## [3.0.0-rc.17] - 2026-07-20
127
+
128
+ ### Added
129
+
130
+ - **`out.status()`** — a success/status line channel that writes to **stderr**
131
+ (stdout stays clean for piping) and is suppressed under quiet verbosity.
132
+ `info` remains stdout-bound; `warn`/`error` remain always-emitted.
133
+ - **Global `--quiet`/`-q` flag** — sets quiet verbosity on every CLI, wired
134
+ like `--json`: detected and stripped at the root before dispatch (command
135
+ schemas never see it), honoring the `--` separator so a literal `-q`
136
+ positional reaches the command unchanged. Listed under root help's
137
+ `Global options:`.
138
+
139
+ ### Fixed
140
+
141
+ - **`.run()` misread a post-separator `--json`** — runtime preflight used a
142
+ naive `includes('--json')`, so `mycli cmd -- --json` entered JSON mode via
143
+ the adapter path even though `.execute()` correctly treats it as a
144
+ positional. Preflight now uses the `--`-aware detection.
145
+
146
+ ## [3.0.0-rc.16] - 2026-07-20
147
+
148
+ ### Added
149
+
150
+ - **`resolveRenderContext(argv, options?)`** — pre-`run()` probe returning the
151
+ output decisions the framework will make for a given argv: `jsonMode`
152
+ (`--`-aware `--json` detection), `isTTY`, the gated `color` palette, and
153
+ `isHyperlinkSupported`. Computed with the same composition `.execute()`/
154
+ `.run()` feed into the output channel, so content styled before `run()` —
155
+ banners, hand-rendered help — matches the channel that will actually render,
156
+ with zero argv re-parsing.
157
+ - **`includesBeforeSeparator` / `stripBeforeSeparator`** exported from the
158
+ package root — the `--`-aware root-flag primitives, for consumers who only
159
+ need correct flag detection.
160
+
161
+ ## [3.0.0-rc.15] - 2026-07-20
162
+
163
+ ### Added
164
+
165
+ - **Configurable flag order in help** — `.help({ flagOrder })` controls the
166
+ `Flags:` table order: `'alphabetical'` (default, short-aliased flags first
167
+ then alphabetical) or `'declaration'` (the order `.flag()` was called). For
168
+ full control, `.help({ sortFlags: (a, b) => number })` supplies a custom
169
+ comparator over flag names that wins over `flagOrder`. Both are also
170
+ accepted at runtime via `execute`/`run` `help` options.
171
+
172
+ ## [3.0.0-rc.14] - 2026-07-20
173
+
174
+ ### Added
175
+
176
+ - **Function-form examples** — `.example()` now accepts a
177
+ `(meta) => string` builder alongside the literal string. `meta` carries the
178
+ invoked program `name` (`help.binName`, falling back to the command name) and
179
+ `version`, resolved at render time, so examples reference the real program
180
+ name instead of hardcoding it and stay truthful under symlinks, `inheritName`,
181
+ and `npx x` vs a global install. The thunk resolves in both `--help` text
182
+ (composing with example highlighting) and `--json`/definition-schema output.
183
+ - **`ExampleMeta`** and **`ExampleCommand`** public types for annotating
184
+ function-form example builders.
185
+
186
+ ## [3.0.0-rc.13] - 2026-07-20
187
+
188
+ ### Changed
189
+
190
+ - **Syntax-highlighted example commands** — the `Examples:` help section now
191
+ highlights each command per token: the leading binary via `usageBin` (bold)
192
+ and flag tokens (`-x`, `--long`) via `flag` (cyan), with values left plain.
193
+ Tokenizing is quote-aware so `--scope './a b'` stays one token, and the
194
+ existing color gate is respected (identity formatters when `NO_COLOR` or
195
+ non-TTY), so `stripAnsi(colored)` still equals the plain rendering.
196
+
197
+ ## [3.0.0-rc.12] - 2026-07-20
198
+
199
+ ### Added
200
+
201
+ - **`out.isHyperlinkSupported`** — resolved OSC 8 hyperlink gate on the output
202
+ channel. Honors `NO_HYPERLINKS`/`FORCE_HYPERLINKS` and the
203
+ `--no-hyperlinks`/`--hyperlinks` flags, falling back to `isTTY`. Consumers
204
+ rendering their own `out.color.link(...)` output can gate on it to keep OSC 8
205
+ escapes out of piped or opted-out contexts.
206
+ - **Standard Schema v1 validation** — `flag.custom(schema)` and
207
+ `arg.custom(schema)` accept any conforming validator (including callable,
208
+ sync, and async schemas) with inferred output types and no runtime
209
+ dependency. Validation runs after source resolution, so argv, env, config,
210
+ prompt, stdin, and default values behave consistently; array flags and
211
+ variadic args validate each element.
212
+ - **`isMainModule(import.meta)`**: Compatibility helper for consumers whose
213
+ ambient `ImportMeta` interface omits `main`. Projects with normal Node, Bun,
214
+ or Deno runtime typings can keep using the conventional
215
+ `if (import.meta.main)` guard directly.
216
+
217
+ ### Changed
218
+
219
+ - **`.manifest({ from: import.meta })` compatibility form**: Anchored manifest
220
+ discovery now also accepts the calling module's complete `import.meta`
221
+ object and extracts its URL internally. The conventional
222
+ `{ from: import.meta.url }` form remains supported and preferred when runtime
223
+ typings expose `url`. Together with `isMainModule(import.meta)`, the new forms
224
+ avoid global `ImportMeta` augmentation, allowing consumers with an empty
225
+ ambient `ImportMeta` interface to pass both TypeScript/Deno checks and JSR
226
+ publish validation.
227
+
228
+ ### Removed
229
+
230
+ - **Internal schema DSL** — the private template-literal parser, validator, and
231
+ JSON Schema converter were replaced by direct definition-schema objects,
232
+ removing roughly 1,500 lines without changing the generated schema.
233
+
234
+ ### Fixed
235
+
236
+ - **`NO_HYPERLINKS` ignored in the help header** — root-help header hyperlinks
237
+ gated on raw TTY status, so `NO_HYPERLINKS=1` (and `--no-hyperlinks`) still
238
+ emitted OSC 8 links in the header. The gate now consults
239
+ `out.isHyperlinkSupported`, which respects the standard hyperlink overrides.
240
+
241
+ ## [3.0.0-rc.11] - 2026-07-15
242
+
243
+ ### Fixed
244
+
245
+ - **JSR publish** — the Deno import map pinned `ansispeck` below `0.2.0`,
246
+ so the JSR build resolved an ansispeck whose `createColors` rejected
247
+ `osc8`'s two-argument call and failed type checking. The map now tracks
248
+ `^0.2.0` alongside the npm dependency. (rc.10 published to npm only.)
249
+
250
+ ## [3.0.0-rc.10] - 2026-07-15
251
+
252
+ ### Changed
253
+
254
+ - **`osc8()` link text is optional** — it now defaults to the link target, so
255
+ `osc8('https://x.dev')` renders as a hyperlink displaying its own URL.
256
+ Terminals without OSC 8 support still show a usable address. Passing an
257
+ explicit label is unchanged.
258
+ - **`osc8()` now delegates to `ansispeck`'s hyperlink constructor** — it emits
259
+ the **ST** (`ESC \`) terminator instead of **BEL** (`\x07`). Both are valid
260
+ OSC 8 terminators supported by modern terminals; the rendered link is
261
+ unchanged. This removes dreamcli's last hand-rolled escape-sequence code.
262
+
10
263
  ## [3.0.0-rc.9] - 2026-07-11
11
264
 
12
265
  ### Added
@@ -1198,7 +1451,15 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
1198
1451
  - MIT License.
1199
1452
  - Markdownlint configuration.
1200
1453
 
1201
- [Unreleased]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.9...HEAD
1454
+ [Unreleased]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.17...HEAD
1455
+ [3.0.0-rc.17]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.16...v3.0.0-rc.17
1456
+ [3.0.0-rc.16]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.15...v3.0.0-rc.16
1457
+ [3.0.0-rc.15]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.14...v3.0.0-rc.15
1458
+ [3.0.0-rc.14]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.13...v3.0.0-rc.14
1459
+ [3.0.0-rc.13]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.12...v3.0.0-rc.13
1460
+ [3.0.0-rc.12]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.11...v3.0.0-rc.12
1461
+ [3.0.0-rc.11]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.10...v3.0.0-rc.11
1462
+ [3.0.0-rc.10]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.9...v3.0.0-rc.10
1202
1463
  [3.0.0-rc.9]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.8...v3.0.0-rc.9
1203
1464
  [3.0.0-rc.8]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.7...v3.0.0-rc.8
1204
1465
  [3.0.0-rc.7]: https://github.com/kjanat/dreamcli/compare/v3.0.0-rc.6...v3.0.0-rc.7
package/README.md CHANGED
@@ -2,6 +2,7 @@
2
2
 
3
3
  [![NPM](https://img.shields.io/npm/v/@kjanat/dreamcli?logo=npm&labelColor=CB3837&color=black)][npm]
4
4
  [![JSR](https://img.shields.io/jsr/v/@kjanat/dreamcli?logoColor=083344&logo=jsr&logoSize=auto&label=&labelColor=f7df1e&color=black)][jsr]
5
+ [![Socket](https://badge.socket.dev/npm/package/@kjanat/dreamcli)][socket]
5
6
 
6
7
  Schema-first, fully typed TypeScript CLI framework. Zero runtime dependencies.
7
8
 
@@ -92,9 +93,9 @@ cli('greet').default(greet).run();
92
93
  ### Multi-command CLI
93
94
 
94
95
  <picture>
95
- <source media="(prefers-color-scheme: dark)" width="700" height="400" alt="dreamcli-migrate-dark" srcset="https://github.com/user-attachments/assets/1ef7f20c-9ffb-4cb6-a6bc-fb562895aa6f">
96
- <source media="(prefers-color-scheme: light)" width="700" height="400" alt="dreamcli-migrate-light" srcset="https://github.com/user-attachments/assets/1ee5f38d-cad8-47ec-94b2-c826eabab76b">
97
- <img alt="DreamCLI migration progress demo" width="700" height="400" src="https://github.com/user-attachments/assets/1ee5f38d-cad8-47ec-94b2-c826eabab76b">
96
+ <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/1ef7f20c-9ffb-4cb6-a6bc-fb562895aa6f">
97
+ <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/1ee5f38d-cad8-47ec-94b2-c826eabab76b">
98
+ <img alt="DreamCLI migration progress demo" width="700" src="https://github.com/user-attachments/assets/1ee5f38d-cad8-47ec-94b2-c826eabab76b">
98
99
  </picture>
99
100
 
100
101
  ```ts
@@ -208,7 +209,7 @@ Third-party plugins and custom glue can extend the other libraries.
208
209
  | Built-in test harness with output capture | `runCommand()` + capture | No | No | No | No | No |
209
210
  | Shell completions from command definitions | Built-in (bash/zsh/fish/powershell) | No | Built-in (bash/zsh) | No | No | No |
210
211
  | Structured output primitives | Built-in (`--json`, tables, spinners) | DIY | DIY | DIY | DIY | DIY |
211
- | Config file support | Built-in (XDG discovery, JSON) | DIY | Built-in (`.config()`) | No | No | No |
212
+ | Config file support | Built-in (project/user/system discovery, JSON) | DIY | Built-in (`.config()`) | No | No | No |
212
213
 
213
214
  The closest analog is what tRPC did to API routes — individual pieces existed,
214
215
  the insight was wiring them so types flow end-to-end.
@@ -220,16 +221,24 @@ the insight was wiring them so types flow end-to-end.
220
221
  ```ts
221
222
  import { flag } from '@kjanat/dreamcli';
222
223
 
223
- flag.string(); // string | undefined
224
- flag.number(); // number | undefined
225
- flag.boolean(); // boolean (defaults to false)
224
+ flag.string({ nonEmpty: true }); // string | undefined, with constraints
225
+ flag.number({ int: true, min: 1 }); // number | undefined, with constraints
226
+ flag.boolean().negatable(); // boolean; accepts --no-<name>
226
227
  flag.enum(['us', 'eu', 'ap']); // "us" | "eu" | "ap" | undefined
227
- flag.array(flag.string()); // string[] | undefined
228
- flag.custom((v) => new URL(v)); // URL | undefined
228
+ flag.array(flag.string()).separator(',').unique(); // string[] | undefined
229
+ flag.url({ protocols: ['https'] }); // URL | undefined
230
+ flag.path({ type: 'directory', create: true }); // string | undefined, mkdir when missing
231
+ flag.date(); // Date | undefined, strict ISO-8601
232
+ flag.duration(); // number (ms) | undefined — '1h30m', '250ms'
233
+ flag.bytes(); // number | undefined — '512mb', '1.5gb'
234
+ flag.count(); // number — -vvv → 3
235
+ flag.keyValue(); // Record<string, string> — repeated KEY=VALUE
236
+ flag.custom(zodSchema); // any Standard Schema v1 validator, inferred output
229
237
  ```
230
238
 
231
239
  Every flag supports: `.default()`, `.required()`, `.alias()`, `.env()`, `.config()`, `.describe()`,
232
- `.prompt()`, `.deprecated()`, `.propagate()`.
240
+ `.prompt()`, `.deprecated()`, `.propagate()`, `.duplicates()`, plus constraint chains
241
+ (`.int()`, `.min()`, `.nonEmpty()`, `.pattern()`, …) on their matching kinds.
233
242
 
234
243
  ### Resolution chain
235
244
 
@@ -342,6 +351,7 @@ const rows = [
342
351
 
343
352
  const status = command('status').action(({ out }) => {
344
353
  out.log('Human-readable message');
354
+ out.status('Progress note on stderr, silenced by --quiet');
345
355
  out.json({ status: 'ok', count: 42 });
346
356
  out.table(rows, [
347
357
  { key: 'name', header: 'Name' },
@@ -357,14 +367,17 @@ const status = command('status').action(({ out }) => {
357
367
  });
358
368
  progress.update(50);
359
369
  progress.done('Upload complete');
370
+
371
+ out.setExitCode(1); // report-and-continue failures, no throw needed
360
372
  });
361
373
 
362
374
  cli('mycli').default(status).run();
363
375
  ```
364
376
 
365
- - TTY → pretty formatting, spinners animate
366
- - Piped → minimal stable output, spinners suppressed
377
+ - TTY → pretty formatting, colors (`out.color`), spinners animate
378
+ - Piped → minimal stable output, identity colors, spinners suppressed
367
379
  - `--json` → structured JSON to stdout, everything else to stderr
380
+ - `--quiet` → `status`/`info` suppressed, warnings and errors kept
368
381
 
369
382
  ### Shell completions
370
383
 
@@ -376,7 +389,12 @@ import { cli, command } from '@kjanat/dreamcli';
376
389
  cli('mycli').command(command('deploy')).completions().run();
377
390
 
378
391
  // mycli completions bash
379
- // mycli completion zsh
392
+ // mycli completions zsh
393
+
394
+ // Or as an eager root flag with shell auto-detection:
395
+ cli('mycli').command(command('deploy')).completions({ as: 'flag' }).run();
396
+
397
+ // mycli --completions
380
398
  ```
381
399
 
382
400
  For programmatic integrations, call the generator directly:
@@ -567,3 +585,4 @@ handles the divergent edges (argv, env, filesystem, TTY detection, exit behavior
567
585
  [LICENSE]: https://github.com/kjanat/dreamcli/blob/master/LICENSE
568
586
  [npm]: https://npm.im/@kjanat/dreamcli
569
587
  [jsr]: https://jsr.io/@kjanat/dreamcli
588
+ [socket]: https://socket.dev/npm/package/@kjanat/dreamcli
@@ -1,17 +1,6 @@
1
1
  import { buildFlagLookup, flagExpectsValue } from "../parse/index.mjs";
2
2
  //#region src/core/cli/dispatch.ts
3
3
  /**
4
- * Recursive command dispatch for nested command trees.
5
- *
6
- * Walks argv segments, matching command names at each level of the tree.
7
- * Returns a discriminated union describing the dispatch outcome: a matched
8
- * command with its ancestor path, a group that needs a subcommand, or an
9
- * unknown command with suggestion candidates.
10
- *
11
- * @module dreamcli/core/cli/dispatch
12
- * @internal
13
- */
14
- /**
15
4
  * Recursively walk argv, consuming command name segments from the front.
16
5
  *
17
6
  * At each level, the first non-flag token is tested as a command name
@@ -13,6 +13,7 @@ import { CompletionOptions } from "../completion/shells/shared.mjs";
13
13
  import { Shell } from "../completion/index.mjs";
14
14
  import { FormatLoader } from "../config/index.mjs";
15
15
  import { formatRootHelp } from "./root-help.mjs";
16
+ import { Colors } from "ansispeck";
16
17
  //#region src/core/cli/index.d.ts
17
18
  /**
18
19
  * Runtime descriptor for the CLI program.
@@ -153,6 +154,24 @@ interface HelpConfig {
153
154
  readonly width?: number;
154
155
  /** Emit OSC 8 hyperlinks in the header when supported. */
155
156
  readonly hyperlinks?: boolean;
157
+ /**
158
+ * Order of flags in the `Flags:` table.
159
+ *
160
+ * - `'alphabetical'` — short-aliased flags first, then alphabetical by name.
161
+ * - `'declaration'` — the order `.flag()` was called.
162
+ *
163
+ * Ignored when {@link HelpConfig.sortFlags} is set.
164
+ *
165
+ * @defaultValue `'alphabetical'`
166
+ */
167
+ readonly flagOrder?: 'alphabetical' | 'declaration';
168
+ /**
169
+ * Custom comparator over flag long names for the `Flags:` table. When set,
170
+ * it wins over {@link HelpConfig.flagOrder}.
171
+ *
172
+ * @defaultValue `undefined` (use `flagOrder`)
173
+ */
174
+ readonly sortFlags?: (a: string, b: string) => number;
156
175
  /**
157
176
  * Theme overrides for help output, merged over the built-in theme.
158
177
  *
@@ -269,6 +288,82 @@ interface CLIRunOptions extends Omit<RunOptions, 'meta' | 'mergedSchema'> {
269
288
  */
270
289
  readonly adapter?: RuntimeAdapter;
271
290
  }
291
+ /**
292
+ * Inputs for {@linkcode resolveRenderContext}. Pass the host facts (TTY
293
+ * status, environment) and any explicit overrides; the resolver applies the
294
+ * same gating `.execute()`/`.run()` feed into the output channel.
295
+ */
296
+ interface RenderContextOptions {
297
+ /**
298
+ * Whether stdout is connected to a TTY (e.g. `process.stdout.isTTY`).
299
+ *
300
+ * @defaultValue `false`
301
+ */
302
+ readonly isTTY?: boolean;
303
+ /**
304
+ * Force JSON mode on regardless of argv.
305
+ *
306
+ * @defaultValue detected from a pre-separator `--json` in `argv`
307
+ */
308
+ readonly jsonMode?: boolean;
309
+ /**
310
+ * Explicitly enable or disable colors, winning over the auto-gate.
311
+ *
312
+ * @defaultValue auto — `isTTY && !jsonMode` and environment support
313
+ */
314
+ readonly color?: boolean;
315
+ /**
316
+ * Environment variables consulted for `NO_HYPERLINKS`/`FORCE_HYPERLINKS`
317
+ * (e.g. `process.env`).
318
+ *
319
+ * @defaultValue `{}`
320
+ */
321
+ readonly env?: Readonly<Record<string, string | undefined>>;
322
+ }
323
+ /**
324
+ * The output decisions the framework will make for a given argv, resolved
325
+ * before `.run()`.
326
+ */
327
+ interface RenderContext {
328
+ /** Whether a pre-separator `--json` puts the run in JSON mode. */
329
+ readonly jsonMode: boolean;
330
+ /** The TTY status the output channel will carry. */
331
+ readonly isTTY: boolean;
332
+ /**
333
+ * The gated ANSI palette the output channel will expose as `out.color` —
334
+ * identity formatters when color is off; `color.isColorSupported` is the
335
+ * boolean gate.
336
+ */
337
+ readonly color: Colors;
338
+ /** Whether OSC 8 hyperlinks should be emitted (see `out.isHyperlinkSupported`). */
339
+ readonly isHyperlinkSupported: boolean;
340
+ }
341
+ /**
342
+ * Resolve the render context for content built before `.run()`.
343
+ *
344
+ * Content styled ahead of execution — hand-rendered banners, custom help, or
345
+ * anything else emitted outside an action handler — has no `out` to consult,
346
+ * which pushes consumers into re-deriving the framework's decisions from raw
347
+ * argv (`argv.includes('--json')` misreads a post-`--` literal). This probe
348
+ * runs the same composition `.execute()`/`.run()` feed into the output
349
+ * channel — `--`-aware `--json` detection, the color gate, and the hyperlink
350
+ * override — so pre-run styling matches the channel that will render.
351
+ *
352
+ * @param argv - Raw argv tokens (NOT including the binary/script path,
353
+ * i.e. equivalent to `process.argv.slice(2)`).
354
+ * @param options - Host facts and overrides.
355
+ * @returns The resolved output decisions.
356
+ *
357
+ * @example
358
+ * ```ts
359
+ * const ctx = resolveRenderContext(process.argv.slice(2), {
360
+ * isTTY: process.stdout.isTTY === true,
361
+ * env: process.env,
362
+ * });
363
+ * const banner = ctx.color.bold('mycli');
364
+ * ```
365
+ */
366
+ declare function resolveRenderContext(argv: readonly string[], options?: RenderContextOptions): RenderContext;
272
367
  /**
273
368
  * Options for {@linkcode CLIBuilder.default | .default()}.
274
369
  */
@@ -402,12 +497,16 @@ declare class CLIBuilder {
402
497
  /**
403
498
  * Enable automatic config file discovery.
404
499
  *
405
- * When enabled, `.run()` probes standard paths before dispatching:
406
- * 1. `$CWD/.{appName}.json`
407
- * 2. `$CWD/{appName}.config.json`
408
- * 3. `$CONFIG_DIR/{appName}/config.json`
409
- * (`$XDG_CONFIG_HOME` / `~/.config` on Unix,
500
+ * When enabled, `.run()` probes standard paths before dispatching,
501
+ * first match wins, no merging:
502
+ * 1. Project scope — for `$CWD` and each ancestor directory up to the
503
+ * filesystem root, nearest first:
504
+ * `.{appName}.json`, `{appName}.config.json`, `.config/{appName}.json`
505
+ * 2. User scope — `{dir}/{appName}/config.json` for each user config
506
+ * root (`$XDG_CONFIG_HOME` / `~/.config` on Unix, plus
507
+ * `~/Library/Application Support` on macOS,
410
508
  * `%APPDATA%` / `%USERPROFILE%\\AppData\\Roaming` on Windows)
509
+ * 3. System scope — `/etc/{appName}/config.json` on Linux and macOS
411
510
  *
412
511
  * The user can override the path via `--config <path>` or `--config=<path>`.
413
512
  *
@@ -514,7 +613,9 @@ declare class CLIBuilder {
514
613
  * `{ scope: 'keep' }` to keep a leading `@scope/` (stripped by default).
515
614
  * - `from`: anchor discovery to a file/URL/path instead of `cwd`. Pass
516
615
  * `import.meta.url` for installable CLIs that must report THEIR OWN
517
- * version. Accepts string paths, `file:` URL strings, or `URL` instances.
616
+ * version. If the consumer's ambient `ImportMeta` omits `url`, pass
617
+ * `import.meta` instead. Also accepts string paths, `file:` URL strings,
618
+ * or `URL` instances.
518
619
  *
519
620
  * @example
520
621
  * ```ts
@@ -729,8 +830,13 @@ type InferNameOption = boolean | {
729
830
  interface ManifestSettings {
730
831
  /** Infer the CLI name from `bin` keys or `name`. @defaultValue `false` */
731
832
  readonly inferName?: InferNameOption;
732
- /** Anchor discovery to a file/URL/path instead of `cwd`. */
733
- readonly from?: string | URL;
833
+ /**
834
+ * Anchor discovery to a file/URL/path instead of `cwd`. Normally, pass
835
+ * `import.meta.url`. Pass `import.meta` whole as a compatibility form when a
836
+ * project `tsconfig.json` `lib` override drops the runtime's ambient
837
+ * `ImportMeta` extras and direct `.url` access does not type-check.
838
+ */
839
+ readonly from?: string | URL | ImportMeta;
734
840
  /**
735
841
  * Candidate manifest filenames in priority order — NOT npm's `files` publish
736
842
  * globs. Discovery probes each name per directory and takes the first that
@@ -802,5 +908,23 @@ interface CLIOptions {
802
908
  declare function cli(name: string, options?: Omit<CLIOptions, 'name'>): CLIBuilder;
803
909
  /** Create a new CLI program builder from an options object. */
804
910
  declare function cli(options: CLIOptions): CLIBuilder;
911
+ /**
912
+ * Report whether the calling module is the process entrypoint, cross-runtime.
913
+ *
914
+ * Node, Bun, and Deno set `import.meta.main` on the module invoked directly;
915
+ * projects with the runtime's ambient types can read that property directly.
916
+ * This helper is a compatibility form for projects whose `tsconfig.json` `lib`
917
+ * override drops those `ImportMeta` extras: passing `import.meta` whole avoids
918
+ * a direct `.main` access without requiring global augmentation.
919
+ *
920
+ * @param meta - The calling module's `import.meta`.
921
+ * @returns `true` when the module was run as the entrypoint.
922
+ *
923
+ * @example
924
+ * ```ts
925
+ * if (isMainModule(import.meta)) cli('mycli').command(deploy).run();
926
+ * ```
927
+ */
928
+ declare function isMainModule(meta: ImportMeta): boolean;
805
929
  //#endregion
806
- export { type BeforeParseParams, CLIBuilder, type CLIOptions, type CLIPlugin, type CLIPluginHooks, type CLIRunOptions, type CLISchema, type CompletionsFlagConfig, type ConfigSettings, type DefaultCommandOptions, type HelpConfig, type HelpLinks, type InferNameOption, type ManifestPresetSettings, type ManifestSettings, type PackageJsonSettings, type PluginCommandContext, type ResolvedCommandParams, type ResolvedManifestSettings, cli, formatRootHelp, plugin };
930
+ export { type BeforeParseParams, CLIBuilder, type CLIOptions, type CLIPlugin, type CLIPluginHooks, type CLIRunOptions, type CLISchema, type CompletionsFlagConfig, type ConfigSettings, type DefaultCommandOptions, type HelpConfig, type HelpLinks, type InferNameOption, type ManifestPresetSettings, type ManifestSettings, type PackageJsonSettings, type PluginCommandContext, type RenderContext, type RenderContextOptions, type ResolvedCommandParams, type ResolvedManifestSettings, cli, formatRootHelp, isMainModule, plugin, resolveRenderContext };