@kjanat/dreamcli 3.0.0-rc.9 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (490) hide show
  1. package/CHANGELOG.md +246 -1
  2. package/README.md +30 -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 +25 -31
  487. package/dist/core/schema-dsl/runtime.d.mts +0 -144
  488. package/dist/core/schema-dsl/runtime.mjs +0 -271
  489. package/dist/core/schema-dsl/to-json-schema.d.mts +0 -29
  490. package/dist/core/schema-dsl/to-json-schema.mjs +0 -74
@@ -1,6 +1,5 @@
1
1
  import { getFlagAliasNames } from "../schema/flag.mjs";
2
- import { parseSchema } from "../schema-dsl/runtime.mjs";
3
- import { nodeToJsonSchema } from "../schema-dsl/to-json-schema.mjs";
2
+ import { resolveExampleCommand } from "../schema/command.mjs";
4
3
  import { definitionMetaSchemaDescriptions } from "./meta-descriptions.generated.mjs";
5
4
  //#region src/core/json-schema/index.ts
6
5
  /**
@@ -38,6 +37,8 @@ function isRecord(value) {
38
37
  *
39
38
  * @param schema - The CLI schema from `CLIBuilder.schema`.
40
39
  * @param options - Generation options.
40
+ * @param meta - Program name/version for function-form examples; defaults to
41
+ * the CLI schema's own `name`/`version`.
41
42
  * @returns A plain object suitable for `JSON.stringify()`.
42
43
  *
43
44
  * @example
@@ -47,16 +48,20 @@ function isRecord(value) {
47
48
  * writeFileSync('cli-schema.json', JSON.stringify(definition, null, 2));
48
49
  * ```
49
50
  */
50
- function generateSchema(schema, options) {
51
+ function generateSchema(schema, options, meta) {
51
52
  const opts = resolveOptions(options);
53
+ const resolvedMeta = meta ?? {
54
+ name: schema.name,
55
+ version: schema.version
56
+ };
52
57
  const result = {
53
58
  $schema: DEFINITION_SCHEMA_URL,
54
59
  name: schema.name
55
60
  };
56
61
  if (schema.version !== void 0) result.version = schema.version;
57
62
  if (schema.description !== void 0) result.description = schema.description;
58
- if (schema.defaultCommand !== void 0 && (opts.includeHidden || !schema.defaultCommand.schema.hidden)) result.defaultCommand = serializeCommand(schema.defaultCommand.schema, opts);
59
- result.commands = schema.commands.filter((cmd) => opts.includeHidden || !cmd.schema.hidden).map((cmd) => serializeCommand(cmd.schema, opts));
63
+ if (schema.defaultCommand !== void 0 && (opts.includeHidden || !schema.defaultCommand.schema.hidden)) result.defaultCommand = serializeCommand(schema.defaultCommand.schema, opts, resolvedMeta);
64
+ result.commands = schema.commands.filter((cmd) => opts.includeHidden || !cmd.schema.hidden).map((cmd) => serializeCommand(cmd.schema, opts, resolvedMeta));
60
65
  return result;
61
66
  }
62
67
  /**
@@ -69,10 +74,16 @@ function generateSchema(schema, options) {
69
74
  *
70
75
  * @param schema - The command schema to serialize.
71
76
  * @param options - Generation options.
77
+ * @param meta - Program name/version for function-form examples; defaults to
78
+ * the command's own name with no version.
72
79
  * @returns A plain object suitable for `JSON.stringify()`.
73
80
  */
74
- function generateCommandSchema(schema, options) {
75
- return serializeCommand(schema, resolveOptions(options));
81
+ function generateCommandSchema(schema, options, meta) {
82
+ const resolvedMeta = meta ?? {
83
+ name: schema.name,
84
+ version: void 0
85
+ };
86
+ return serializeCommand(schema, resolveOptions(options), resolvedMeta);
76
87
  }
77
88
  /**
78
89
  * Serialize a single {@link CommandSchema} into a plain object.
@@ -81,17 +92,17 @@ function generateCommandSchema(schema, options) {
81
92
  * @param opts - Resolved generation options (hidden/prompt inclusion).
82
93
  * @returns JSON-serializable object representing the command.
83
94
  */
84
- function serializeCommand(schema, opts) {
95
+ function serializeCommand(schema, opts, meta) {
85
96
  const result = { name: schema.name };
86
97
  if (schema.description !== void 0) result.description = schema.description;
87
98
  if (schema.aliases.length > 0) result.aliases = [...schema.aliases];
88
99
  if (schema.hidden) result.hidden = true;
89
- if (schema.examples.length > 0) result.examples = schema.examples.map(serializeExample);
100
+ if (schema.examples.length > 0) result.examples = schema.examples.map((example) => serializeExample(example, meta));
90
101
  const flags = {};
91
102
  for (const [name, flagDef] of Object.entries(schema.flags)) flags[name] = serializeFlag(flagDef, opts);
92
103
  result.flags = flags;
93
104
  result.args = schema.args.map(serializeArgEntry);
94
- result.commands = schema.commands.filter((cmd) => opts.includeHidden || !cmd.hidden).map((cmd) => serializeCommand(cmd, opts));
105
+ result.commands = schema.commands.filter((cmd) => opts.includeHidden || !cmd.hidden).map((cmd) => serializeCommand(cmd, opts, meta));
95
106
  return result;
96
107
  }
97
108
  /**
@@ -113,7 +124,23 @@ function serializeFlag(schema, opts) {
113
124
  if (schema.configPath !== void 0) result.configPath = schema.configPath;
114
125
  if (schema.description !== void 0) result.description = schema.description;
115
126
  if (schema.enumValues !== void 0) result.enumValues = [...schema.enumValues];
127
+ if (schema.numberConstraints !== void 0) result.numberConstraints = { ...schema.numberConstraints };
128
+ if (schema.stringConstraints !== void 0) result.stringConstraints = {
129
+ ...schema.stringConstraints,
130
+ ...schema.stringConstraints.pattern !== void 0 ? { pattern: {
131
+ source: schema.stringConstraints.pattern.source,
132
+ flags: schema.stringConstraints.pattern.flags
133
+ } } : {}
134
+ };
116
135
  if (schema.elementSchema !== void 0) result.elementSchema = serializeFlag(schema.elementSchema, opts);
136
+ if (schema.separator !== void 0) result.separator = schema.separator;
137
+ if (schema.unique) result.unique = true;
138
+ if (schema.pathChecks !== void 0) result.pathChecks = {
139
+ mustExist: schema.pathChecks.mustExist,
140
+ ...schema.pathChecks.type !== void 0 ? { type: schema.pathChecks.type } : {},
141
+ ...schema.pathChecks.create ? { create: true } : {}
142
+ };
143
+ if (schema.valueHint !== void 0) result.valueHint = schema.valueHint;
117
144
  if (opts.includePrompts && schema.prompt !== void 0) result.prompt = serializePrompt(schema.prompt);
118
145
  if (schema.deprecated !== void 0) result.deprecated = schema.deprecated;
119
146
  if (schema.propagate) result.propagate = true;
@@ -190,11 +217,15 @@ function serializeChoice(choice) {
190
217
  /**
191
218
  * Serialize a {@link CommandExample} into a plain object.
192
219
  *
220
+ * Function-form commands are resolved against `meta` so the output is a plain
221
+ * serializable string rather than a dropped function.
222
+ *
193
223
  * @param example - The example to serialize.
224
+ * @param meta - Program name/version passed to function-form commands.
194
225
  * @returns JSON-serializable object with command and optional description.
195
226
  */
196
- function serializeExample(example) {
197
- const result = { command: example.command };
227
+ function serializeExample(example, meta) {
228
+ const result = { command: resolveExampleCommand(example.command, meta) };
198
229
  if (example.description !== void 0) result.description = example.description;
199
230
  return result;
200
231
  }
@@ -448,10 +479,6 @@ function isPlainJsonObject(value) {
448
479
  const proto = Object.getPrototypeOf(value);
449
480
  return proto === Object.prototype || proto === null;
450
481
  }
451
- /** Convert a DSL string to a JSON Schema object definition. */
452
- function def(source) {
453
- return nodeToJsonSchema(parseSchema(source));
454
- }
455
482
  function withDefinitionDescriptions(schema, descriptions) {
456
483
  const propertiesValue = schema.properties;
457
484
  const describedProperties = typeof propertiesValue === "object" && propertiesValue !== null && isPlainJsonObject(propertiesValue) && descriptions.properties !== void 0 ? Object.fromEntries(Object.entries(propertiesValue).map(([name, propertySchema]) => {
@@ -481,11 +508,6 @@ function withDefinitionMetaSchemaDescriptions(schema, descriptions) {
481
508
  /**
482
509
  * JSON Schema (draft 2020-12) that validates the output of {@link generateSchema}.
483
510
  *
484
- * Each `$defs` entry is defined once as a schema DSL string — the DSL
485
- * parser produces a runtime AST, and {@link nodeToJsonSchema} converts
486
- * that AST to a JSON Schema fragment. No probe fixtures, no override
487
- * maps, no manually maintained type definitions.
488
- *
489
511
  * Hosted at {@link DEFINITION_SCHEMA_URL} for `$schema` resolution. Also
490
512
  * exported so tooling can validate definition documents without a network
491
513
  * round-trip.
@@ -505,74 +527,235 @@ const definitionMetaSchema = withDefinitionMetaSchemaDescriptions({
505
527
  $id: DEFINITION_SCHEMA_URL,
506
528
  title: "@kjanat/dreamcli definition schema",
507
529
  description: "Describes the structure of a CLI built with dreamcli — commands, flags, args, types, constraints, env bindings, and prompts.",
508
- ...def(`{
509
- $schema: '${DEFINITION_SCHEMA_URL}';
510
- name: string;
511
- version?: string;
512
- description?: string;
513
- defaultCommand?: @command;
514
- commands: @command[]
515
- }`),
530
+ type: "object",
531
+ additionalProperties: false,
532
+ properties: {
533
+ $schema: { const: DEFINITION_SCHEMA_URL },
534
+ name: { type: "string" },
535
+ version: { type: "string" },
536
+ description: { type: "string" },
537
+ defaultCommand: { $ref: "#/$defs/command" },
538
+ commands: {
539
+ type: "array",
540
+ items: { $ref: "#/$defs/command" }
541
+ }
542
+ },
543
+ required: [
544
+ "$schema",
545
+ "name",
546
+ "commands"
547
+ ],
516
548
  $defs: {
517
- command: def(`{
518
- name: string;
519
- description?: string;
520
- aliases?: string[];
521
- hidden?: true;
522
- examples?: @example[];
523
- flags: Record<string, @flag>;
524
- args: @arg[];
525
- commands: @command[]
526
- }`),
527
- flag: def(`{
528
- kind: 'string' | 'number' | 'boolean' | 'enum' | 'array' | 'custom' | 'count' | 'keyValue';
529
- presence: 'optional' | 'required' | 'defaulted';
530
- defaultValue?: unknown;
531
- aliases?: string[];
532
- envVar?: string;
533
- configPath?: string;
534
- description?: string;
535
- enumValues?: string[];
536
- elementSchema?: @flag;
537
- prompt?: @prompt;
538
- deprecated?: string | true;
539
- propagate?: true;
540
- negation?: @negation;
541
- duplicates?: 'last' | 'first' | 'error'
542
- }`),
543
- negation: def(`{
544
- alias?: string;
545
- hidden?: true
546
- }`),
547
- arg: def(`{
548
- name: string;
549
- kind: 'string' | 'number' | 'enum' | 'custom';
550
- presence: 'required' | 'optional' | 'defaulted';
551
- variadic?: true;
552
- stdinMode?: true;
553
- defaultValue?: unknown;
554
- description?: string;
555
- envVar?: string;
556
- enumValues?: string[];
557
- deprecated?: string | true
558
- }`),
559
- prompt: def(`{
560
- kind: 'confirm' | 'input' | 'select' | 'multiselect';
561
- message: string;
562
- placeholder?: string;
563
- choices?: @choice[];
564
- min?: integer;
565
- max?: integer
566
- }`),
567
- choice: def(`{
568
- value: string;
569
- label?: string;
570
- description?: string
571
- }`),
572
- example: def(`{
573
- command: string;
574
- description?: string
575
- }`)
549
+ command: {
550
+ type: "object",
551
+ additionalProperties: false,
552
+ properties: {
553
+ name: { type: "string" },
554
+ description: { type: "string" },
555
+ aliases: {
556
+ type: "array",
557
+ items: { type: "string" }
558
+ },
559
+ hidden: { const: true },
560
+ examples: {
561
+ type: "array",
562
+ items: { $ref: "#/$defs/example" }
563
+ },
564
+ flags: {
565
+ type: "object",
566
+ additionalProperties: { $ref: "#/$defs/flag" }
567
+ },
568
+ args: {
569
+ type: "array",
570
+ items: { $ref: "#/$defs/arg" }
571
+ },
572
+ commands: {
573
+ type: "array",
574
+ items: { $ref: "#/$defs/command" }
575
+ }
576
+ },
577
+ required: [
578
+ "name",
579
+ "flags",
580
+ "args",
581
+ "commands"
582
+ ]
583
+ },
584
+ flag: {
585
+ type: "object",
586
+ additionalProperties: false,
587
+ properties: {
588
+ kind: { enum: [
589
+ "string",
590
+ "number",
591
+ "boolean",
592
+ "enum",
593
+ "array",
594
+ "custom",
595
+ "count",
596
+ "keyValue"
597
+ ] },
598
+ presence: { enum: [
599
+ "optional",
600
+ "required",
601
+ "defaulted"
602
+ ] },
603
+ defaultValue: {},
604
+ aliases: {
605
+ type: "array",
606
+ items: { type: "string" }
607
+ },
608
+ envVar: { type: "string" },
609
+ configPath: { type: "string" },
610
+ description: { type: "string" },
611
+ enumValues: {
612
+ type: "array",
613
+ items: { type: "string" }
614
+ },
615
+ numberConstraints: {
616
+ type: "object",
617
+ additionalProperties: false,
618
+ properties: {
619
+ min: { type: "number" },
620
+ max: { type: "number" },
621
+ int: { type: "boolean" },
622
+ finite: { type: "boolean" }
623
+ }
624
+ },
625
+ stringConstraints: {
626
+ type: "object",
627
+ additionalProperties: false,
628
+ properties: {
629
+ nonEmpty: { type: "boolean" },
630
+ minLength: {
631
+ type: "integer",
632
+ minimum: 0
633
+ },
634
+ maxLength: {
635
+ type: "integer",
636
+ minimum: 0
637
+ },
638
+ pattern: {
639
+ type: "object",
640
+ additionalProperties: false,
641
+ properties: {
642
+ source: { type: "string" },
643
+ flags: { type: "string" }
644
+ },
645
+ required: ["source", "flags"]
646
+ }
647
+ }
648
+ },
649
+ elementSchema: { $ref: "#/$defs/flag" },
650
+ separator: {
651
+ type: "string",
652
+ minLength: 1
653
+ },
654
+ unique: { type: "boolean" },
655
+ pathChecks: {
656
+ type: "object",
657
+ additionalProperties: false,
658
+ properties: {
659
+ mustExist: { type: "boolean" },
660
+ type: { enum: ["file", "directory"] },
661
+ create: { type: "boolean" }
662
+ },
663
+ required: ["mustExist"]
664
+ },
665
+ valueHint: { type: "string" },
666
+ prompt: { $ref: "#/$defs/prompt" },
667
+ deprecated: { oneOf: [{ type: "string" }, { const: true }] },
668
+ propagate: { const: true },
669
+ negation: { $ref: "#/$defs/negation" },
670
+ duplicates: { enum: [
671
+ "last",
672
+ "first",
673
+ "error"
674
+ ] }
675
+ },
676
+ required: ["kind", "presence"]
677
+ },
678
+ negation: {
679
+ type: "object",
680
+ additionalProperties: false,
681
+ properties: {
682
+ alias: { type: "string" },
683
+ hidden: { const: true }
684
+ }
685
+ },
686
+ arg: {
687
+ type: "object",
688
+ additionalProperties: false,
689
+ properties: {
690
+ name: { type: "string" },
691
+ kind: { enum: [
692
+ "string",
693
+ "number",
694
+ "enum",
695
+ "custom"
696
+ ] },
697
+ presence: { enum: [
698
+ "required",
699
+ "optional",
700
+ "defaulted"
701
+ ] },
702
+ variadic: { const: true },
703
+ stdinMode: { const: true },
704
+ defaultValue: {},
705
+ description: { type: "string" },
706
+ envVar: { type: "string" },
707
+ enumValues: {
708
+ type: "array",
709
+ items: { type: "string" }
710
+ },
711
+ deprecated: { oneOf: [{ type: "string" }, { const: true }] }
712
+ },
713
+ required: [
714
+ "name",
715
+ "kind",
716
+ "presence"
717
+ ]
718
+ },
719
+ prompt: {
720
+ type: "object",
721
+ additionalProperties: false,
722
+ properties: {
723
+ kind: { enum: [
724
+ "confirm",
725
+ "input",
726
+ "select",
727
+ "multiselect"
728
+ ] },
729
+ message: { type: "string" },
730
+ placeholder: { type: "string" },
731
+ choices: {
732
+ type: "array",
733
+ items: { $ref: "#/$defs/choice" }
734
+ },
735
+ min: { type: "integer" },
736
+ max: { type: "integer" }
737
+ },
738
+ required: ["kind", "message"]
739
+ },
740
+ choice: {
741
+ type: "object",
742
+ additionalProperties: false,
743
+ properties: {
744
+ value: { type: "string" },
745
+ label: { type: "string" },
746
+ description: { type: "string" }
747
+ },
748
+ required: ["value"]
749
+ },
750
+ example: {
751
+ type: "object",
752
+ additionalProperties: false,
753
+ properties: {
754
+ command: { type: "string" },
755
+ description: { type: "string" }
756
+ },
757
+ required: ["command"]
758
+ }
576
759
  }
577
760
  }, definitionMetaSchemaDescriptions);
578
761
  //#endregion
@@ -6,22 +6,22 @@
6
6
  */
7
7
  declare const definitionMetaSchemaDescriptions: {
8
8
  readonly root: {
9
- readonly description: 'Runtime descriptor for the CLI program.\n\nStores the program name, version, description, and registered commands.\\\nBuilt incrementally by CLIBuilder.';
9
+ readonly description: "Runtime descriptor for the CLI program.\n\nStores the program name, version, description, and registered commands.\\\nBuilt incrementally by CLIBuilder.";
10
10
  readonly properties: {
11
11
  readonly name: {
12
- readonly description: 'Program name (used in help text, usage lines, and completion scripts).';
12
+ readonly description: "Program name (used in help text, usage lines, and completion scripts).";
13
13
  };
14
14
  readonly version: {
15
- readonly description: 'Program version (shown by `--version`).';
15
+ readonly description: "Program version (shown by `--version`).";
16
16
  };
17
17
  readonly description: {
18
- readonly description: 'Program description (shown in root help).';
18
+ readonly description: "Program description (shown in root help).";
19
19
  };
20
20
  readonly defaultCommand: {
21
- readonly description: 'Default command dispatched when no subcommand matches.\n\nWhen set, the CLI root behaves like a hybrid command group: subcommands\ndispatch by name as usual, but empty argv or flags-only argv falls\nthrough to this command instead of showing root help.\n\nSet via the .default() builder method.';
21
+ readonly description: "Default command dispatched when no subcommand matches.\n\nWhen set, the CLI root behaves like a hybrid command group: subcommands\ndispatch by name as usual, but empty argv or flags-only argv falls\nthrough to this command instead of showing root help.\n\nSet via the .default() builder method.";
22
22
  };
23
23
  readonly commands: {
24
- readonly description: 'Registered commands (type-erased for heterogeneous storage).';
24
+ readonly description: "Registered commands (type-erased for heterogeneous storage).";
25
25
  };
26
26
  };
27
27
  };
@@ -33,25 +33,25 @@ declare const definitionMetaSchemaDescriptions: {
33
33
  readonly description: "The command name (used for dispatch, e.g. `'deploy'`).";
34
34
  };
35
35
  readonly description: {
36
- readonly description: 'Human-readable description for help text.';
36
+ readonly description: "Human-readable description for help text.";
37
37
  };
38
38
  readonly aliases: {
39
- readonly description: 'Alternative names for this command.';
39
+ readonly description: "Alternative names for this command.";
40
40
  };
41
41
  readonly hidden: {
42
- readonly description: 'Whether this command is hidden from help listings.';
42
+ readonly description: "Whether this command is hidden from help listings.";
43
43
  };
44
44
  readonly examples: {
45
- readonly description: 'Usage examples for help text.';
45
+ readonly description: "Usage examples for help text.";
46
46
  };
47
47
  readonly flags: {
48
- readonly description: 'Named flag schemas, keyed by flag name.';
48
+ readonly description: "Named flag schemas, keyed by flag name.";
49
49
  };
50
50
  readonly args: {
51
- readonly description: 'Ordered positional arg entries (name + schema).';
51
+ readonly description: "Ordered positional arg entries (name + schema).";
52
52
  };
53
53
  readonly commands: {
54
- readonly description: 'Nested subcommand schemas (for help rendering and completion).\n\nPure data — no execution closures. Populated by `.command()` on\n`CommandBuilder`. Empty for leaf commands.';
54
+ readonly description: "Nested subcommand schemas (for help rendering and completion).\n\nPure data — no execution closures. Populated by `.command()` on\n`CommandBuilder`. Empty for leaf commands.";
55
55
  };
56
56
  };
57
57
  };
@@ -59,25 +59,25 @@ declare const definitionMetaSchemaDescriptions: {
59
59
  readonly description: "The runtime descriptor stored inside every FlagBuilder. Consumers (parser,\nhelp generator, resolution chain) read this to understand the flag's shape\nwithout touching generics.";
60
60
  readonly properties: {
61
61
  readonly kind: {
62
- readonly description: 'What kind of value this flag accepts.';
62
+ readonly description: "What kind of value this flag accepts.";
63
63
  };
64
64
  readonly presence: {
65
65
  readonly description: "Presence describes whether a flag value is guaranteed to exist when the\naction handler runs:\n\n- `'optional'` — not required; unresolved value follows the kind-specific\n optional fallback (`undefined` for most flags, `[]` for arrays)\n- `'required'` — must be supplied; error if missing\n- `'defaulted'` — always present (falls back to default value)";
66
66
  };
67
67
  readonly defaultValue: {
68
- readonly description: 'Runtime default value (if any).';
68
+ readonly description: "Runtime default value (if any).";
69
69
  };
70
70
  readonly aliases: {
71
71
  readonly description: "Short/long aliases (e.g. `[{ name: 'f', hidden: false }]` for `--force`).";
72
72
  };
73
73
  readonly envVar: {
74
- readonly description: 'Environment variable name for v0.2+ resolution.';
74
+ readonly description: "Environment variable name for v0.2+ resolution.";
75
75
  };
76
76
  readonly configPath: {
77
77
  readonly description: "Dotted config path for v0.2+ resolution (e.g. `'deploy.region'`).";
78
78
  };
79
79
  readonly description: {
80
- readonly description: 'Human-readable description for help text.';
80
+ readonly description: "Human-readable description for help text.";
81
81
  };
82
82
  readonly enumValues: {
83
83
  readonly description: "Allowed literal values when `kind === 'enum'`.";
@@ -86,13 +86,13 @@ declare const definitionMetaSchemaDescriptions: {
86
86
  readonly description: "Element schema when `kind === 'array'`.";
87
87
  };
88
88
  readonly prompt: {
89
- readonly description: 'Interactive prompt configuration for v0.3+ resolution.';
89
+ readonly description: "Interactive prompt configuration for v0.3+ resolution.";
90
90
  };
91
91
  readonly deprecated: {
92
- readonly description: 'Deprecation marker.\n\n- `undefined` — not deprecated (default)\n- `true` — deprecated with no migration message\n- `string` — deprecated with a reason/migration message\n\nWhen a deprecated flag is used, a warning is emitted to stderr.\nHelp text shows `[deprecated]` or `[deprecated: <reason>]`.';
92
+ readonly description: "Deprecation marker.\n\n- `undefined` — not deprecated (default)\n- `true` — deprecated with no migration message\n- `string` — deprecated with a reason/migration message\n\nWhen a deprecated flag is used, a warning is emitted to stderr.\nHelp text shows `[deprecated]` or `[deprecated: <reason>]`.";
93
93
  };
94
94
  readonly propagate: {
95
- readonly description: 'Whether this flag propagates to subcommands in nested command trees.\n\nWhen `true`, the flag is automatically available to all descendant\ncommands. A child command that defines a flag with the same name\nshadows the propagated parent flag.\n\nDefault: `false`';
95
+ readonly description: "Whether this flag propagates to subcommands in nested command trees.\n\nWhen `true`, the flag is automatically available to all descendant\ncommands. A child command that defines a flag with the same name\nshadows the propagated parent flag.\n\nDefault: `false`";
96
96
  };
97
97
  readonly negation: {
98
98
  readonly description: "Negation settings when `kind === 'boolean'` and `.negatable()` was\ncalled (`undefined` otherwise). See FlagNegation.";
@@ -103,13 +103,13 @@ declare const definitionMetaSchemaDescriptions: {
103
103
  };
104
104
  };
105
105
  readonly negation: {
106
- readonly description: 'Negation settings for a boolean flag (set by `.negatable()`).\n\nThe negated spelling and the positive form are two spellings of ONE\nlogical flag: they share duplicate policy, and the last CLI occurrence\nwins across both. The negated spelling is presence-only — `--no-foo=x`\nis rejected.';
106
+ readonly description: "Negation settings for a boolean flag (set by `.negatable()`).\n\nThe negated spelling and the positive form are two spellings of ONE\nlogical flag: they share duplicate policy, and the last CLI occurrence\nwins across both. The negated spelling is presence-only — `--no-foo=x`\nis rejected.";
107
107
  readonly properties: {
108
108
  readonly alias: {
109
109
  readonly description: "Explicit negated spelling without the `--` prefix (e.g. `'no-sandbox'`).\n`undefined` synthesizes `no-<flagName>` wherever the flag name is known.";
110
110
  };
111
111
  readonly hidden: {
112
- readonly description: 'Hide the negated spelling from help, completions, and suggestions.';
112
+ readonly description: "Hide the negated spelling from help, completions, and suggestions.";
113
113
  };
114
114
  };
115
115
  };
@@ -117,25 +117,25 @@ declare const definitionMetaSchemaDescriptions: {
117
117
  readonly description: "The runtime descriptor stored inside every ArgBuilder. Consumers (parser,\nhelp generator) read this to understand the arg's shape without touching\ngenerics.";
118
118
  readonly properties: {
119
119
  readonly name: {
120
- readonly description: 'A named positional argument entry in the command schema.\n\nPairs a user-facing arg name with its ArgSchema descriptor.\nThe array ordering in CommandSchema.args determines CLI position.';
120
+ readonly description: "A named positional argument entry in the command schema.\n\nPairs a user-facing arg name with its ArgSchema descriptor.\nThe array ordering in CommandSchema.args determines CLI position.";
121
121
  };
122
122
  readonly kind: {
123
- readonly description: 'What kind of value this arg accepts.';
123
+ readonly description: "What kind of value this arg accepts.";
124
124
  };
125
125
  readonly presence: {
126
126
  readonly description: "Presence describes whether a positional arg is guaranteed to exist when the\naction handler runs:\n\n- `'required'` — must be supplied; error if missing (default)\n- `'optional'` — may be `undefined` if not supplied\n- `'defaulted'` — always present (falls back to default value)";
127
127
  };
128
128
  readonly variadic: {
129
- readonly description: 'Whether this arg consumes all remaining positionals.';
129
+ readonly description: "Whether this arg consumes all remaining positionals.";
130
130
  };
131
131
  readonly stdinMode: {
132
- readonly description: 'Whether this arg may read from stdin during resolution.\n\nDefault: `false`';
132
+ readonly description: "Whether this arg may read from stdin during resolution.\n\nDefault: `false`";
133
133
  };
134
134
  readonly defaultValue: {
135
- readonly description: 'Runtime default value (if any).';
135
+ readonly description: "Runtime default value (if any).";
136
136
  };
137
137
  readonly description: {
138
- readonly description: 'Human-readable description for help text.';
138
+ readonly description: "Human-readable description for help text.";
139
139
  };
140
140
  readonly envVar: {
141
141
  readonly description: "Environment variable name for env resolution.\n\nWhen set and the CLI value is absent, the resolver reads this env var\nand coerces the string to the arg's declared kind.";
@@ -144,7 +144,7 @@ declare const definitionMetaSchemaDescriptions: {
144
144
  readonly description: "Allowed literal values when `kind === 'enum'`.";
145
145
  };
146
146
  readonly deprecated: {
147
- readonly description: 'Deprecation marker.\n\n- `undefined` — not deprecated (default)\n- `true` — deprecated with no migration message\n- `string` — deprecated with a reason/migration message\n\nWhen a deprecated arg is used, a warning is emitted to stderr.\nHelp text shows `[deprecated]` or `[deprecated: <reason>]`.';
147
+ readonly description: "Deprecation marker.\n\n- `undefined` — not deprecated (default)\n- `true` — deprecated with no migration message\n- `string` — deprecated with a reason/migration message\n\nWhen a deprecated arg is used, a warning is emitted to stderr.\nHelp text shows `[deprecated]` or `[deprecated: <reason>]`.";
148
148
  };
149
149
  };
150
150
  };
@@ -155,44 +155,44 @@ declare const definitionMetaSchemaDescriptions: {
155
155
  readonly description: "The kind of interactive prompt to present.\n\n- `'confirm'` — yes/no boolean question\n- `'input'` — free-text string input\n- `'select'` — single selection from a list\n- `'multiselect'` — multiple selections from a list";
156
156
  };
157
157
  readonly message: {
158
- readonly description: 'The question displayed to the user.';
158
+ readonly description: "The question displayed to the user.";
159
159
  };
160
160
  readonly placeholder: {
161
- readonly description: 'Placeholder text shown before user types (informational only).';
161
+ readonly description: "Placeholder text shown before user types (informational only).";
162
162
  };
163
163
  readonly choices: {
164
- readonly description: 'Available choices. When omitted for `enum` flags, the enum values\nfrom the flag schema are used automatically.';
164
+ readonly description: "Available choices. When omitted for `enum` flags, the enum values\nfrom the flag schema are used automatically.";
165
165
  };
166
166
  readonly min: {
167
- readonly description: 'Minimum number of selections required.\n\nDefault: `0`';
167
+ readonly description: "Minimum number of selections required.\n\nDefault: `0`";
168
168
  };
169
169
  readonly max: {
170
- readonly description: 'Maximum number of selections allowed.\n\nDefault: `Infinity`';
170
+ readonly description: "Maximum number of selections allowed.\n\nDefault: `Infinity`";
171
171
  };
172
172
  };
173
173
  };
174
174
  readonly choice: {
175
- readonly description: 'A selectable option for SelectPromptConfig and MultiselectPromptConfig prompts.';
175
+ readonly description: "A selectable option for SelectPromptConfig and MultiselectPromptConfig prompts.";
176
176
  readonly properties: {
177
177
  readonly value: {
178
- readonly description: 'The value returned when this choice is selected.';
178
+ readonly description: "The value returned when this choice is selected.";
179
179
  };
180
180
  readonly label: {
181
- readonly description: 'Display label shown to the user.\n\nDefault: value';
181
+ readonly description: "Display label shown to the user.\n\nDefault: value";
182
182
  };
183
183
  readonly description: {
184
- readonly description: 'Optional description shown alongside the choice.';
184
+ readonly description: "Optional description shown alongside the choice.";
185
185
  };
186
186
  };
187
187
  };
188
188
  readonly example: {
189
- readonly description: 'A single usage example shown in help text.';
189
+ readonly description: "A single usage example shown in help text.";
190
190
  readonly properties: {
191
191
  readonly command: {
192
192
  readonly description: "The command invocation (e.g. `'deploy production --force'`).";
193
193
  };
194
194
  readonly description: {
195
- readonly description: 'Optional description of what this example does.';
195
+ readonly description: "Optional description of what this example does.";
196
196
  };
197
197
  };
198
198
  };