@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,13 +1,13 @@
1
1
  import { Fallback, TableOptions } from "../schema/activity.mjs";
2
2
  //#region src/core/output/contracts.d.ts
3
3
  /** Ordered output verbosity levels owned by the output policy layer. */
4
- declare const OUTPUT_VERBOSITY_LEVELS: readonly ['normal', 'quiet'];
4
+ declare const OUTPUT_VERBOSITY_LEVELS: readonly ["normal", "quiet"];
5
5
  /** Stable output text streams. */
6
- declare const OUTPUT_STREAMS: readonly ['stdout', 'stderr'];
6
+ declare const OUTPUT_STREAMS: readonly ["stdout", "stderr"];
7
7
  /** Stable activity rendering modes. */
8
- declare const ACTIVITY_RENDER_MODES: readonly ['noop', 'static', 'tty', 'capture'];
8
+ declare const ACTIVITY_RENDER_MODES: readonly ["noop", "static", "tty", "capture"];
9
9
  /** Stable activity cleanup actions. */
10
- declare const ACTIVITY_CLEANUP_KINDS: readonly ['none', 'stop', 'done'];
10
+ declare const ACTIVITY_CLEANUP_KINDS: readonly ["none", "stop", "done"];
11
11
  /** Stable text verbosity labels. */
12
12
  type Verbosity = (typeof OUTPUT_VERBOSITY_LEVELS)[number];
13
13
  /** Stable output stream labels. */
@@ -71,7 +71,7 @@ declare const outputContract: {
71
71
  declare function resolveOutputPolicy(options: ResolveOutputPolicyOptions): OutputPolicy;
72
72
  /** Resolve the default text stream for non-JSON structured output. */
73
73
  declare function resolveTextStream(policy: OutputPolicy): OutputStream;
74
- /** Whether `info()` messages should be emitted under the current policy. */
74
+ /** Whether `info()`/`status()` messages should be emitted under the current policy. */
75
75
  declare function shouldEmitInfo(policy: OutputPolicy): boolean;
76
76
  /** Resolve the concrete table format under the current policy. */
77
77
  declare function resolveTableFormat(policy: OutputPolicy, options?: TableOptions): 'text' | 'json';
@@ -11,7 +11,7 @@ function resolveOutputPolicy(options) {
11
11
  function resolveTextStream(policy) {
12
12
  return policy.jsonMode ? "stderr" : "stdout";
13
13
  }
14
- /** Whether `info()` messages should be emitted under the current policy. */
14
+ /** Whether `info()`/`status()` messages should be emitted under the current policy. */
15
15
  function shouldEmitInfo(policy) {
16
16
  return policy.verbosity !== "quiet";
17
17
  }
@@ -57,6 +57,17 @@ interface OutputOptions {
57
57
  * `FORCE_COLOR`, `--no-color`, `--color`, `CI` are respected).
58
58
  */
59
59
  readonly color?: boolean;
60
+ /**
61
+ * Resolved OSC 8 hyperlink support for `out.isHyperlinkSupported`.
62
+ *
63
+ * When set, this wins over the `isTTY` fallback. Callers pass the
64
+ * `NO_HYPERLINKS`/`FORCE_HYPERLINKS` (and `--no-hyperlinks`/`--hyperlinks`)
65
+ * decision here via {@linkcode resolveHyperlinkOverride}, keeping `process`
66
+ * access out of the output layer.
67
+ *
68
+ * @defaultValue `isTTY`
69
+ */
70
+ readonly hyperlinks?: boolean;
60
71
  }
61
72
  /** Fully resolved output options with no optional fields. */
62
73
  interface ResolvedOutputOptions {
@@ -66,10 +77,24 @@ interface ResolvedOutputOptions {
66
77
  readonly verbosity: Verbosity;
67
78
  readonly jsonMode: boolean;
68
79
  readonly color: boolean;
80
+ readonly isHyperlinkSupported: boolean;
69
81
  }
82
+ /** Store the exit code requested through an output channel. @internal */
70
83
  declare function setRequestedExitCode(out: Out, code: number): void;
84
+ /** Read the exit code requested through an output channel. @internal */
71
85
  declare function getRequestedExitCode(out: Out): number | undefined;
86
+ /** Clear a previously requested exit code from an output channel. @internal */
72
87
  declare function clearRequestedExitCode(out: Out): void;
88
+ /**
89
+ * Forced hyperlink decision from `NO_HYPERLINKS`/`FORCE_HYPERLINKS` and the
90
+ * `--no-hyperlinks`/`--hyperlinks` argv flags; `undefined` when unset.
91
+ *
92
+ * Pure over its inputs — callers pass the adapter's `env`/`argv` so the
93
+ * output layer never touches `process` directly.
94
+ *
95
+ * @see https://no-hyperlinks.org/
96
+ */
97
+ declare function resolveHyperlinkOverride(env: Readonly<Record<string, string | undefined>>, argv: readonly string[]): boolean | undefined;
73
98
  /**
74
99
  * Concrete implementation of the {@linkcode Out} interface.
75
100
  *
@@ -104,6 +129,13 @@ declare class OutputChannel implements Out {
104
129
  * colors are off, so handlers can style unconditionally.
105
130
  */
106
131
  readonly color: Colors;
132
+ /**
133
+ * Whether OSC 8 hyperlinks should be emitted for this channel.
134
+ *
135
+ * Honors `NO_HYPERLINKS`/`FORCE_HYPERLINKS` and the
136
+ * `--no-hyperlinks`/`--hyperlinks` argv flags, falling back to `isTTY`.
137
+ */
138
+ readonly isHyperlinkSupported: boolean;
107
139
  constructor(options: ResolvedOutputOptions);
108
140
  /**
109
141
  * Write to stdout (normal output). Always emitted.
@@ -119,6 +151,11 @@ declare class OutputChannel implements Out {
119
151
  * In JSON mode, redirected to stderr.
120
152
  */
121
153
  info(message: string): void;
154
+ /**
155
+ * Status line to stderr (stdout stays clean for piping).
156
+ * Suppressed when verbosity is `'quiet'`.
157
+ */
158
+ status(message: string): void;
122
159
  /** Warning to stderr. Always emitted. */
123
160
  warn(message: string): void;
124
161
  /** Error to stderr. Always emitted. */
@@ -302,4 +339,4 @@ interface CapturedOutput {
302
339
  */
303
340
  declare function createCaptureOutput(options?: Omit<OutputOptions, 'stdout' | 'stderr'>): [out: Out, captured: CapturedOutput];
304
341
  //#endregion
305
- export { CaptureOutputChannel, CaptureProgressHandle, CaptureSpinnerHandle, type CapturedOutput, OutputChannel, type OutputOptions, StaticProgressHandle, StaticSpinnerHandle, TTYProgressHandle, TTYSpinnerHandle, type Verbosity, type WriteFn, clearRequestedExitCode, createCaptureOutput, createOutput, getRequestedExitCode, noopProgressHandle, noopSpinnerHandle, setRequestedExitCode, writeLine };
342
+ export { CaptureOutputChannel, CaptureProgressHandle, CaptureSpinnerHandle, type CapturedOutput, OutputChannel, type OutputOptions, StaticProgressHandle, StaticSpinnerHandle, TTYProgressHandle, TTYSpinnerHandle, type Verbosity, type WriteFn, clearRequestedExitCode, createCaptureOutput, createOutput, getRequestedExitCode, noopProgressHandle, noopSpinnerHandle, resolveHyperlinkOverride, setRequestedExitCode, writeLine };
@@ -28,15 +28,33 @@ function validateExitCode(code) {
28
28
  if (!Number.isInteger(code) || code < 0 || code > 255) throw new RangeError("Exit code must be an integer from 0 to 255");
29
29
  return code;
30
30
  }
31
+ /** Store the exit code requested through an output channel. @internal */
31
32
  function setRequestedExitCode(out, code) {
32
33
  requestedExitCodes.set(out, validateExitCode(code));
33
34
  }
35
+ /** Read the exit code requested through an output channel. @internal */
34
36
  function getRequestedExitCode(out) {
35
37
  return requestedExitCodes.get(out);
36
38
  }
39
+ /** Clear a previously requested exit code from an output channel. @internal */
37
40
  function clearRequestedExitCode(out) {
38
41
  requestedExitCodes.delete(out);
39
42
  }
43
+ /**
44
+ * Forced hyperlink decision from `NO_HYPERLINKS`/`FORCE_HYPERLINKS` and the
45
+ * `--no-hyperlinks`/`--hyperlinks` argv flags; `undefined` when unset.
46
+ *
47
+ * Pure over its inputs — callers pass the adapter's `env`/`argv` so the
48
+ * output layer never touches `process` directly.
49
+ *
50
+ * @see https://no-hyperlinks.org/
51
+ */
52
+ function resolveHyperlinkOverride(env, argv) {
53
+ const separator = argv.indexOf("--");
54
+ const flags = separator === -1 ? argv : argv.slice(0, separator);
55
+ if (env.NO_HYPERLINKS || flags.includes("--no-hyperlinks")) return false;
56
+ if (env.FORCE_HYPERLINKS || flags.includes("--hyperlinks")) return true;
57
+ }
40
58
  /** Merge user-supplied options with defaults. */
41
59
  function resolveOptions(options) {
42
60
  const isTTY = options?.isTTY ?? false;
@@ -47,7 +65,8 @@ function resolveOptions(options) {
47
65
  isTTY,
48
66
  verbosity: options?.verbosity ?? "normal",
49
67
  jsonMode,
50
- color: options?.color ?? (isTTY && !jsonMode && isColorSupported)
68
+ color: options?.color ?? (isTTY && !jsonMode && isColorSupported),
69
+ isHyperlinkSupported: options?.hyperlinks ?? isTTY
51
70
  };
52
71
  }
53
72
  /**
@@ -84,12 +103,20 @@ var OutputChannel = class {
84
103
  * colors are off, so handlers can style unconditionally.
85
104
  */
86
105
  color;
106
+ /**
107
+ * Whether OSC 8 hyperlinks should be emitted for this channel.
108
+ *
109
+ * Honors `NO_HYPERLINKS`/`FORCE_HYPERLINKS` and the
110
+ * `--no-hyperlinks`/`--hyperlinks` argv flags, falling back to `isTTY`.
111
+ */
112
+ isHyperlinkSupported;
87
113
  constructor(options) {
88
114
  this.options = options;
89
115
  this.policy = resolveOutputPolicy(options);
90
116
  this.jsonMode = options.jsonMode;
91
117
  this.isTTY = options.isTTY;
92
118
  this.color = createColors(options.color);
119
+ this.isHyperlinkSupported = options.isHyperlinkSupported;
93
120
  bindMethods(this);
94
121
  }
95
122
  /**
@@ -111,6 +138,14 @@ var OutputChannel = class {
111
138
  if (!shouldEmitInfo(this.policy)) return;
112
139
  writeLine(resolveWriterForStream(this.options, resolveTextStream(this.policy)), message);
113
140
  }
141
+ /**
142
+ * Status line to stderr (stdout stays clean for piping).
143
+ * Suppressed when verbosity is `'quiet'`.
144
+ */
145
+ status(message) {
146
+ if (!shouldEmitInfo(this.policy)) return;
147
+ writeLine(this.options.stderr, message);
148
+ }
114
149
  /** Warning to stderr. Always emitted. */
115
150
  warn(message) {
116
151
  writeLine(this.options.stderr, message);
@@ -439,4 +474,4 @@ function createCaptureOutput(options) {
439
474
  }), captured.activity), captured];
440
475
  }
441
476
  //#endregion
442
- export { CaptureOutputChannel, CaptureProgressHandle, CaptureSpinnerHandle, OutputChannel, clearRequestedExitCode, createCaptureOutput, createOutput, getRequestedExitCode, setRequestedExitCode, writeLine };
477
+ export { CaptureOutputChannel, CaptureProgressHandle, CaptureSpinnerHandle, OutputChannel, clearRequestedExitCode, createCaptureOutput, createOutput, getRequestedExitCode, resolveHyperlinkOverride, setRequestedExitCode, writeLine };
@@ -181,12 +181,15 @@ function buildFlagLookup(flags, options) {
181
181
  parity: false
182
182
  });
183
183
  }
184
- if (options?.caseParity !== false) for (const [spelling, entry] of [...lookup]) {
185
- const counterpart = counterpartSpelling(spelling);
186
- if (counterpart !== void 0 && !lookup.has(counterpart)) lookup.set(counterpart, {
187
- ...entry,
188
- parity: true
189
- });
184
+ if (options?.caseParity !== false) {
185
+ const declared = [...lookup];
186
+ for (const [spelling, entry] of declared) {
187
+ const counterpart = counterpartSpelling(spelling);
188
+ if (counterpart !== void 0 && !lookup.has(counterpart)) lookup.set(counterpart, {
189
+ ...entry,
190
+ parity: true
191
+ });
192
+ }
190
193
  }
191
194
  return lookup;
192
195
  }
@@ -4,9 +4,9 @@ import "../schema/index.mjs";
4
4
  import { ParseResult } from "../parse/index.mjs";
5
5
  //#region src/core/resolve/contracts.d.ts
6
6
  /** Ordered flag resolution stages owned by the resolver. */
7
- declare const FLAG_RESOLUTION_ORDER: readonly ['cli', 'env', 'config', 'prompt', 'default'];
7
+ declare const FLAG_RESOLUTION_ORDER: readonly ["cli", "env", "config", "prompt", "default"];
8
8
  /** Ordered arg resolution stages owned by the resolver. */
9
- declare const ARG_RESOLUTION_ORDER: readonly ['cli', 'stdin', 'env', 'default'];
9
+ declare const ARG_RESOLUTION_ORDER: readonly ["cli", "stdin", "env", "default"];
10
10
  /** Stable flag-source labels for precedence and diagnostics. */
11
11
  type FlagResolutionStage = (typeof FLAG_RESOLUTION_ORDER)[number];
12
12
  /** Stable arg-source labels for precedence and diagnostics. */
@@ -53,6 +53,11 @@ interface ResolveOptions {
53
53
  * `null` when nothing does. When absent, path checks are skipped.
54
54
  */
55
55
  readonly stat?: (path: string) => Promise<'file' | 'directory' | null>;
56
+ /**
57
+ * Recursive directory creation for `flag.path()` `create` checks. When
58
+ * absent, missing paths are not created and existence rules apply as-is.
59
+ */
60
+ readonly mkdir?: (path: string) => Promise<void>;
56
61
  }
57
62
  /** Structured deprecation notice emitted for explicitly sourced values. */
58
63
  interface DeprecationWarning {
@@ -10,8 +10,10 @@ import { ErasedInteractiveResolver } from "../schema/command.mjs";
10
10
  * Returns what exists at the path, or `null` when nothing does.
11
11
  */
12
12
  type StatFn = (path: string) => Promise<'file' | 'directory' | null>;
13
+ /** Recursive directory creation injected by the caller for `flag.path()` `create` checks. */
14
+ type MkdirFn = (path: string) => Promise<void>;
13
15
  /** Walk every declared flag through the resolution chain (cli -> env -> config -> prompt -> default), collecting deprecations and throwing aggregated errors. */
14
- declare function resolveFlags(flagSchemas: Readonly<Record<string, FlagSchema>>, parsedFlags: Readonly<Record<string, unknown>>, env: Readonly<Record<string, string | undefined>>, config: Readonly<Record<string, unknown>>, prompter: PromptEngine | undefined, interactive: ErasedInteractiveResolver | undefined, deprecations: DeprecationWarning[], stat: StatFn | undefined): Promise<Readonly<Record<string, unknown>>>;
16
+ declare function resolveFlags(flagSchemas: Readonly<Record<string, FlagSchema>>, parsedFlags: Readonly<Record<string, unknown>>, env: Readonly<Record<string, string | undefined>>, config: Readonly<Record<string, unknown>>, prompter: PromptEngine | undefined, interactive: ErasedInteractiveResolver | undefined, deprecations: DeprecationWarning[], stat: StatFn | undefined, mkdir: MkdirFn | undefined): Promise<Readonly<Record<string, unknown>>>;
15
17
  /** Maps each flag kind to the prompt kinds that produce compatible values. */
16
18
  declare const COMPATIBLE_PROMPT_KINDS: Record<FlagKind, readonly PromptKind[]>;
17
19
  //#endregion
@@ -11,7 +11,7 @@ import { resolveConfigPath } from "./config.mjs";
11
11
  * @internal
12
12
  */
13
13
  /** Walk every declared flag through the resolution chain (cli -> env -> config -> prompt -> default), collecting deprecations and throwing aggregated errors. */
14
- async function resolveFlags(flagSchemas, parsedFlags, env, config, prompter, interactive, deprecations, stat) {
14
+ async function resolveFlags(flagSchemas, parsedFlags, env, config, prompter, interactive, deprecations, stat, mkdir) {
15
15
  const resolved = {};
16
16
  const errors = [];
17
17
  const hardErrorFlags = /* @__PURE__ */ new Set();
@@ -125,7 +125,7 @@ async function resolveFlags(flagSchemas, parsedFlags, env, config, prompter, int
125
125
  const value = resolved[name];
126
126
  if (schema.kind === "array" && schema.unique && Array.isArray(value)) resolved[name] = [...new Set(value)];
127
127
  if (schema.pathChecks !== void 0 && typeof value === "string" && stat !== void 0) {
128
- const violation = await validatePathChecks(name, value, schema.pathChecks, stat);
128
+ const violation = await validatePathChecks(name, value, schema.pathChecks, stat, mkdir);
129
129
  if (violation !== void 0) errors.push(violation);
130
130
  }
131
131
  }
@@ -139,17 +139,34 @@ async function resolveFlags(flagSchemas, parsedFlags, env, config, prompter, int
139
139
  * {@link ValidationError} with code `'CONSTRAINT_VIOLATED'` otherwise.
140
140
  * @internal
141
141
  */
142
- async function validatePathChecks(flagName, value, checks, stat) {
142
+ async function validatePathChecks(flagName, value, checks, stat, mkdir) {
143
143
  const found = await stat(value);
144
- if (found === null) return new ValidationError(`Path '${value}' for flag --${flagName} does not exist`, {
145
- code: "CONSTRAINT_VIOLATED",
146
- details: {
147
- flag: flagName,
148
- value,
149
- constraint: "mustExist"
150
- },
151
- suggest: `Provide an existing path for --${flagName}`
152
- });
144
+ if (found === null) {
145
+ if (checks.create && mkdir !== void 0) try {
146
+ await mkdir(value);
147
+ return;
148
+ } catch (error) {
149
+ return new ValidationError(`Failed to create directory '${value}' for flag --${flagName}: ${error instanceof Error ? error.message : String(error)}`, {
150
+ code: "CONSTRAINT_VIOLATED",
151
+ details: {
152
+ flag: flagName,
153
+ value,
154
+ constraint: "create"
155
+ },
156
+ suggest: `Provide a creatable or existing directory path for --${flagName}`
157
+ });
158
+ }
159
+ if (!checks.mustExist) return void 0;
160
+ return new ValidationError(`Path '${value}' for flag --${flagName} does not exist`, {
161
+ code: "CONSTRAINT_VIOLATED",
162
+ details: {
163
+ flag: flagName,
164
+ value,
165
+ constraint: "mustExist"
166
+ },
167
+ suggest: `Provide an existing path for --${flagName}`
168
+ });
169
+ }
153
170
  if (checks.type !== void 0 && found !== checks.type) return new ValidationError(`Path '${value}' for flag --${flagName} is a ${found}, expected a ${checks.type}`, {
154
171
  code: "CONSTRAINT_VIOLATED",
155
172
  details: {
@@ -2,6 +2,7 @@ import { isValidationError } from "../errors/index.mjs";
2
2
  import { collectValidationErrors, isNonEmpty, throwAggregatedErrors } from "./errors.mjs";
3
3
  import { resolveArgs } from "./args.mjs";
4
4
  import { resolveFlags } from "./flags.mjs";
5
+ import { applyStandardValidators } from "./standard.mjs";
5
6
  //#region src/core/resolve/index.ts
6
7
  /**
7
8
  * Resolution chain: CLI -> env -> config -> prompt -> default.
@@ -63,7 +64,7 @@ async function resolve(schema, parsed, options) {
63
64
  let args = {};
64
65
  const errors = [];
65
66
  try {
66
- flags = await resolveFlags(schema.flags, parsed.flags, env, config, prompter, schema.interactive, deprecations, options?.stat);
67
+ flags = await resolveFlags(schema.flags, parsed.flags, env, config, prompter, schema.interactive, deprecations, options?.stat, options?.mkdir);
67
68
  } catch (error) {
68
69
  if (!isValidationError(error)) throw error;
69
70
  errors.push(...collectValidationErrors(error));
@@ -74,6 +75,10 @@ async function resolve(schema, parsed, options) {
74
75
  if (!isValidationError(error)) throw error;
75
76
  errors.push(...collectValidationErrors(error));
76
77
  }
78
+ const validated = await applyStandardValidators(schema, flags, args);
79
+ flags = validated.flags;
80
+ args = validated.args;
81
+ errors.push(...validated.errors);
77
82
  if (isNonEmpty(errors)) throwAggregatedErrors(errors);
78
83
  return {
79
84
  flags,
@@ -5,7 +5,7 @@ import { FlagSchema } from "../schema/flag.mjs";
5
5
  import "../schema/index.mjs";
6
6
  //#region src/core/resolve/property.d.ts
7
7
  /** Flag/arg kinds that share a common coercion path. */
8
- declare const SHARED_PROPERTY_MODEL_KINDS: readonly ['string', 'number', 'enum', 'custom'];
8
+ declare const SHARED_PROPERTY_MODEL_KINDS: readonly ["string", "number", "enum", "custom"];
9
9
  /** Union of kind discriminants that participate in shared coercion. */
10
10
  type SharedPropertyKind = (typeof SHARED_PROPERTY_MODEL_KINDS)[number];
11
11
  /** Minimal coercion-relevant slice of a flag or arg schema, discriminated by kind. */
@@ -0,0 +1,24 @@
1
+ import { ValidationError } from "../errors/index.mjs";
2
+ import { CommandSchema } from "../schema/command.mjs";
3
+ import "../schema/index.mjs";
4
+ //#region src/core/resolve/standard.d.ts
5
+ /** Resolved values after the Standard Schema pass, plus any issues found. */
6
+ interface StandardValidationResult {
7
+ readonly flags: Readonly<Record<string, unknown>>;
8
+ readonly args: Readonly<Record<string, unknown>>;
9
+ readonly errors: readonly ValidationError[];
10
+ }
11
+ /**
12
+ * Validate resolved flag and arg values against any attached Standard Schema
13
+ * validators. Values without a validator, or resolved to `undefined`, pass
14
+ * through untouched.
15
+ *
16
+ * @param schema - The command schema carrying per-flag/arg validators.
17
+ * @param flags - Resolved flag values, keyed by flag name.
18
+ * @param args - Resolved arg values, keyed by arg name.
19
+ * @returns The (possibly transformed) values and any constraint violations.
20
+ * @internal
21
+ */
22
+ declare function applyStandardValidators(schema: CommandSchema, flags: Readonly<Record<string, unknown>>, args: Readonly<Record<string, unknown>>): Promise<StandardValidationResult>;
23
+ //#endregion
24
+ export { applyStandardValidators };
@@ -0,0 +1,114 @@
1
+ import { ValidationError } from "../errors/index.mjs";
2
+ //#region src/core/resolve/standard.ts
3
+ /**
4
+ * Standard Schema v1 validation pass.
5
+ *
6
+ * Runs after CLI/env/config/prompt/default resolution so a validator attached
7
+ * via `flag.custom()` / `arg.custom()` sees the final value regardless of its
8
+ * source. `~standard.validate` may be sync or async; both are awaited here.
9
+ * Issues become `CONSTRAINT_VIOLATED` validation errors; a successful result
10
+ * replaces the value with the validator's (possibly transformed) output.
11
+ *
12
+ * @module dreamcli/core/resolve/standard
13
+ */
14
+ /** Render an issue path (e.g. `['a', 0]` → `a.0`), or `undefined` when empty. */
15
+ function formatIssuePath(path) {
16
+ if (path === void 0 || path.length === 0) return;
17
+ return path.map((segment) => {
18
+ const key = typeof segment === "object" ? segment.key : segment;
19
+ return typeof key === "symbol" ? key.toString() : String(key);
20
+ }).join(".");
21
+ }
22
+ /** Build a `CONSTRAINT_VIOLATED` message from a validator's issues. */
23
+ function issuesMessage(label, issues) {
24
+ return `${label} failed validation: ${issues.map((issue) => {
25
+ const path = formatIssuePath(issue.path);
26
+ return path === void 0 ? issue.message : `${path}: ${issue.message}`;
27
+ }).join("; ")}`;
28
+ }
29
+ /** Await a validator against a single value, mapping failure to a typed error. */
30
+ async function validateValue(label, value, validator) {
31
+ const result = await validator["~standard"].validate(value);
32
+ if (result.issues !== void 0) return {
33
+ ok: false,
34
+ error: new ValidationError(issuesMessage(label, result.issues), {
35
+ code: "CONSTRAINT_VIOLATED",
36
+ details: {
37
+ value,
38
+ issues: result.issues.map((issue) => issue.message)
39
+ },
40
+ suggest: `Provide a value for ${label} that satisfies its validator`
41
+ })
42
+ };
43
+ return {
44
+ ok: true,
45
+ value: result.value
46
+ };
47
+ }
48
+ /**
49
+ * Validate resolved flag and arg values against any attached Standard Schema
50
+ * validators. Values without a validator, or resolved to `undefined`, pass
51
+ * through untouched.
52
+ *
53
+ * @param schema - The command schema carrying per-flag/arg validators.
54
+ * @param flags - Resolved flag values, keyed by flag name.
55
+ * @param args - Resolved arg values, keyed by arg name.
56
+ * @returns The (possibly transformed) values and any constraint violations.
57
+ * @internal
58
+ */
59
+ async function applyStandardValidators(schema, flags, args) {
60
+ const errors = [];
61
+ const nextFlags = { ...flags };
62
+ for (const [name, flagSchema] of Object.entries(schema.flags)) {
63
+ const value = flags[name];
64
+ if (value === void 0) continue;
65
+ const elementValidator = flagSchema.kind === "array" ? flagSchema.elementSchema?.standard : void 0;
66
+ if (elementValidator !== void 0 && Array.isArray(value)) {
67
+ const nextValue = [];
68
+ for (const [index, element] of value.entries()) {
69
+ const result = await validateValue(`--${name}[${index}]`, element, elementValidator);
70
+ if (result.ok) nextValue.push(result.value);
71
+ else {
72
+ nextValue.push(element);
73
+ errors.push(result.error);
74
+ }
75
+ }
76
+ nextFlags[name] = nextValue;
77
+ continue;
78
+ }
79
+ const validator = flagSchema.standard;
80
+ if (validator === void 0) continue;
81
+ const result = await validateValue(`--${name}`, value, validator);
82
+ if (result.ok) nextFlags[name] = result.value;
83
+ else errors.push(result.error);
84
+ }
85
+ const nextArgs = { ...args };
86
+ for (const entry of schema.args) {
87
+ const validator = entry.schema.standard;
88
+ const value = args[entry.name];
89
+ if (validator === void 0 || value === void 0) continue;
90
+ if (entry.schema.variadic && Array.isArray(value)) {
91
+ const nextValue = [];
92
+ for (const [index, element] of value.entries()) {
93
+ const result = await validateValue(`<${entry.name}>[${index}]`, element, validator);
94
+ if (result.ok) nextValue.push(result.value);
95
+ else {
96
+ nextValue.push(element);
97
+ errors.push(result.error);
98
+ }
99
+ }
100
+ nextArgs[entry.name] = nextValue;
101
+ continue;
102
+ }
103
+ const result = await validateValue(`<${entry.name}>`, value, validator);
104
+ if (result.ok) nextArgs[entry.name] = result.value;
105
+ else errors.push(result.error);
106
+ }
107
+ return {
108
+ flags: nextFlags,
109
+ args: nextArgs,
110
+ errors
111
+ };
112
+ }
113
+ //#endregion
114
+ export { applyStandardValidators };
@@ -1,7 +1,8 @@
1
1
  import { NumberConstraints } from "./number-constraints.mjs";
2
+ import { InferStandardOutput, StandardSchemaV1 } from "./standard.mjs";
2
3
  //#region src/core/schema/arg.d.ts
3
4
  /** All arg presence states as a runtime array. */
4
- declare const ARG_PRESENCES: readonly ['required', 'optional', 'defaulted'];
5
+ declare const ARG_PRESENCES: readonly ["required", "optional", "defaulted"];
5
6
  /**
6
7
  * Presence describes whether a positional arg is guaranteed to exist when the
7
8
  * action handler runs:
@@ -61,7 +62,7 @@ type InferArg<B> = B extends ArgBuilder<infer C extends ArgConfig> ? ResolvedArg
61
62
  /** Extract resolved value types from a record of builders. */
62
63
  type InferArgs<T extends Record<string, ArgBuilder<ArgConfig>>> = { [K in keyof T]: InferArg<T[K]>; };
63
64
  /** All arg kind discriminators as a runtime array. */
64
- declare const ARG_KINDS: readonly ['string', 'number', 'enum', 'custom'];
65
+ declare const ARG_KINDS: readonly ["string", "number", "enum", "custom"];
65
66
  /** Discriminator for the kind of value an arg accepts. */
66
67
  type ArgKind = (typeof ARG_KINDS)[number];
67
68
  /** Custom parse function for `arg.custom()`. */
@@ -107,6 +108,15 @@ interface ArgSchema {
107
108
  readonly numberConstraints: NumberConstraints | undefined;
108
109
  /** Custom parse function (only when `kind === 'custom'`). */
109
110
  readonly parseFn: ArgParseFn<unknown> | undefined;
111
+ /**
112
+ * Standard Schema v1 validator applied to the resolved value.
113
+ *
114
+ * When set, the value from any source (CLI, env, stdin, default) is
115
+ * validated after resolution via `~standard.validate`. Sync and async
116
+ * validators are both awaited; issues surface as a `CONSTRAINT_VIOLATED`
117
+ * {@link ValidationError}. Only meaningful when `kind === 'custom'`.
118
+ */
119
+ readonly standard: StandardSchemaV1 | undefined;
110
120
  /**
111
121
  * Deprecation marker.
112
122
  *
@@ -573,6 +583,31 @@ interface ArgFactory {
573
583
  readonly variadic: false;
574
584
  readonly argKind: 'enum';
575
585
  }>;
586
+ /**
587
+ * Custom positional argument validated by a Standard Schema v1 validator
588
+ * (zod, valibot, arktype, …). The resolved value from any source is
589
+ * validated after resolution; the arg's value type is the validator's
590
+ * output type.
591
+ *
592
+ * Sync and async validators are both supported. Validation issues surface
593
+ * as a `CONSTRAINT_VIOLATED` error naming the argument.
594
+ *
595
+ * @example
596
+ * ```ts
597
+ * import { z } from 'zod';
598
+ * arg.custom(z.string().uuid())
599
+ * // inferred type: string
600
+ * ```
601
+ *
602
+ * @param schema - A Standard Schema v1 validator.
603
+ * @returns A required custom {@link ArgBuilder} typed to the validator's output.
604
+ */
605
+ custom<S extends StandardSchemaV1>(schema: S): ArgBuilder<{
606
+ readonly valueType: InferStandardOutput<S>;
607
+ readonly presence: 'required';
608
+ readonly variadic: false;
609
+ readonly argKind: 'custom';
610
+ }>;
576
611
  /**
577
612
  * Custom-parsed positional argument. Required by default.
578
613
  *
@@ -1,4 +1,5 @@
1
1
  import { assertNumberConstraints } from "./number-constraints.mjs";
2
+ import { isStandardSchemaV1 } from "./standard.mjs";
2
3
  //#region src/core/schema/arg.ts
3
4
  /**
4
5
  * Positional argument schema builder with full type inference.
@@ -45,6 +46,7 @@ function createArgSchema(kind, overrides) {
45
46
  enumValues: void 0,
46
47
  numberConstraints: void 0,
47
48
  parseFn: void 0,
49
+ standard: void 0,
48
50
  deprecated: void 0,
49
51
  ...overrides
50
52
  };
@@ -455,8 +457,9 @@ const arg = {
455
457
  enum(values) {
456
458
  return new ArgBuilder(createArgSchema("enum", { enumValues: values }));
457
459
  },
458
- custom(parseFn) {
459
- return new ArgBuilder(createArgSchema("custom", { parseFn }));
460
+ custom(parseFnOrSchema) {
461
+ if (isStandardSchemaV1(parseFnOrSchema)) return new ArgBuilder(createArgSchema("custom", { standard: parseFnOrSchema }));
462
+ return new ArgBuilder(createArgSchema("custom", { parseFn: parseFnOrSchema }));
460
463
  }
461
464
  };
462
465
  //#endregion