@kjanat/dreamcli 4.0.0-rc.3 → 4.1.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 (212) hide show
  1. package/README.md +5 -7
  2. package/dist/{runtime/adapter.d.mts → adapter-YM5QGi3M.d.mts} +4 -4
  3. package/dist/completion-CUMeOnAz.mjs +6 -0
  4. package/dist/completion.d.mts +90 -0
  5. package/dist/completion.mjs +1 -0
  6. package/dist/config-CrlScpYX.mjs +1 -0
  7. package/dist/config.d.mts +2 -0
  8. package/dist/config.mjs +1 -0
  9. package/dist/core-DvXUolc_.mjs +17 -0
  10. package/dist/{core/json-schema/index.d.mts → index-3l8uj16E.d.mts} +43 -34
  11. package/dist/{core/cli/index.d.mts → index-BAj2y70U.d.mts} +116 -57
  12. package/dist/index-BziI2aKc.d.mts +5440 -0
  13. package/dist/index-Cap0MA2V.d.mts +277 -0
  14. package/dist/index-Cp9kt2t-.d.mts +370 -0
  15. package/dist/index-DWsnGZlx.d.mts +831 -0
  16. package/dist/index.d.mts +190 -41
  17. package/dist/index.mjs +1 -26
  18. package/dist/json-schema-DRlrz_IV.mjs +52 -0
  19. package/dist/json-schema.d.mts +2 -0
  20. package/dist/json-schema.mjs +1 -0
  21. package/dist/package-json-BgE9YjjQ.mjs +3 -0
  22. package/dist/prompt.d.mts +48 -0
  23. package/dist/prompt.mjs +1 -0
  24. package/dist/rolldown-runtime-G4Kt5YOX.mjs +1 -0
  25. package/dist/runtime.d.mts +2 -6
  26. package/dist/runtime.mjs +1 -6
  27. package/dist/terminal-C8KTXjv5.mjs +6 -0
  28. package/dist/test-prompter-v__jT2yG.mjs +1 -0
  29. package/dist/testkit.d.mts +54 -6
  30. package/dist/testkit.mjs +1 -5
  31. package/dist/version.mjs +1 -7
  32. package/dreamcli.schema.json +697 -538
  33. package/package.json +29 -7
  34. package/skills/cli-creation/SKILL.md +16 -11
  35. package/CHANGELOG.md +0 -1116
  36. package/dist/core/cli/builtins.d.mts +0 -117
  37. package/dist/core/cli/builtins.mjs +0 -135
  38. package/dist/core/cli/compiled.d.mts +0 -66
  39. package/dist/core/cli/compiled.mjs +0 -76
  40. package/dist/core/cli/dispatch.d.mts +0 -115
  41. package/dist/core/cli/dispatch.mjs +0 -205
  42. package/dist/core/cli/help-links.d.mts +0 -27
  43. package/dist/core/cli/help-links.mjs +0 -41
  44. package/dist/core/cli/index.mjs +0 -1271
  45. package/dist/core/cli/planner.d.mts +0 -174
  46. package/dist/core/cli/planner.mjs +0 -323
  47. package/dist/core/cli/plugin.d.mts +0 -94
  48. package/dist/core/cli/plugin.mjs +0 -41
  49. package/dist/core/cli/propagate.d.mts +0 -39
  50. package/dist/core/cli/propagate.mjs +0 -57
  51. package/dist/core/cli/reserved-flags.d.mts +0 -19
  52. package/dist/core/cli/reserved-flags.mjs +0 -158
  53. package/dist/core/cli/root-help.d.mts +0 -53
  54. package/dist/core/cli/root-help.mjs +0 -221
  55. package/dist/core/cli/root-output-flags.d.mts +0 -74
  56. package/dist/core/cli/root-output-flags.mjs +0 -169
  57. package/dist/core/cli/root-surface.d.mts +0 -64
  58. package/dist/core/cli/root-surface.mjs +0 -28
  59. package/dist/core/cli/runtime-preflight.d.mts +0 -213
  60. package/dist/core/cli/runtime-preflight.mjs +0 -221
  61. package/dist/core/completion/index.d.mts +0 -76
  62. package/dist/core/completion/index.mjs +0 -90
  63. package/dist/core/completion/shells/bash.d.mts +0 -23
  64. package/dist/core/completion/shells/bash.mjs +0 -312
  65. package/dist/core/completion/shells/fish.d.mts +0 -19
  66. package/dist/core/completion/shells/fish.mjs +0 -164
  67. package/dist/core/completion/shells/powershell.d.mts +0 -13
  68. package/dist/core/completion/shells/powershell.mjs +0 -360
  69. package/dist/core/completion/shells/shared.d.mts +0 -164
  70. package/dist/core/completion/shells/shared.mjs +0 -147
  71. package/dist/core/completion/shells/zsh.d.mts +0 -23
  72. package/dist/core/completion/shells/zsh.mjs +0 -256
  73. package/dist/core/config/index.d.mts +0 -191
  74. package/dist/core/config/index.mjs +0 -285
  75. package/dist/core/config/package-json.d.mts +0 -179
  76. package/dist/core/config/package-json.mjs +0 -353
  77. package/dist/core/errors/index.d.mts +0 -125
  78. package/dist/core/errors/index.mjs +0 -87
  79. package/dist/core/execution/index.d.mts +0 -61
  80. package/dist/core/execution/index.mjs +0 -220
  81. package/dist/core/help/ansi.d.mts +0 -84
  82. package/dist/core/help/ansi.mjs +0 -121
  83. package/dist/core/help/index.d.mts +0 -149
  84. package/dist/core/help/index.mjs +0 -418
  85. package/dist/core/help/theme.d.mts +0 -86
  86. package/dist/core/help/theme.mjs +0 -69
  87. package/dist/core/json-schema/index.mjs +0 -1008
  88. package/dist/core/json-schema/meta-descriptions.generated.d.mts +0 -274
  89. package/dist/core/json-schema/meta-descriptions.generated.mjs +0 -136
  90. package/dist/core/output/activity.d.mts +0 -193
  91. package/dist/core/output/activity.mjs +0 -452
  92. package/dist/core/output/bind.d.mts +0 -37
  93. package/dist/core/output/bind.mjs +0 -56
  94. package/dist/core/output/contracts.d.mts +0 -82
  95. package/dist/core/output/contracts.mjs +0 -57
  96. package/dist/core/output/display-value.d.mts +0 -19
  97. package/dist/core/output/display-value.mjs +0 -32
  98. package/dist/core/output/index.d.mts +0 -344
  99. package/dist/core/output/index.mjs +0 -514
  100. package/dist/core/output/renderers.d.mts +0 -45
  101. package/dist/core/output/renderers.mjs +0 -46
  102. package/dist/core/output/writer.d.mts +0 -39
  103. package/dist/core/output/writer.mjs +0 -12
  104. package/dist/core/parse/index.d.mts +0 -178
  105. package/dist/core/parse/index.mjs +0 -850
  106. package/dist/core/parse/occurrences.d.mts +0 -90
  107. package/dist/core/parse/occurrences.mjs +0 -114
  108. package/dist/core/prompt/index.d.mts +0 -213
  109. package/dist/core/prompt/index.mjs +0 -348
  110. package/dist/core/read-flags/index.d.mts +0 -150
  111. package/dist/core/read-flags/index.mjs +0 -217
  112. package/dist/core/resolve/args.d.mts +0 -39
  113. package/dist/core/resolve/args.mjs +0 -182
  114. package/dist/core/resolve/coerce.d.mts +0 -79
  115. package/dist/core/resolve/coerce.mjs +0 -900
  116. package/dist/core/resolve/config.d.mts +0 -10
  117. package/dist/core/resolve/config.mjs +0 -19
  118. package/dist/core/resolve/contracts.d.mts +0 -146
  119. package/dist/core/resolve/errors.d.mts +0 -10
  120. package/dist/core/resolve/errors.mjs +0 -148
  121. package/dist/core/resolve/flags.d.mts +0 -74
  122. package/dist/core/resolve/flags.mjs +0 -246
  123. package/dist/core/resolve/index.d.mts +0 -44
  124. package/dist/core/resolve/index.mjs +0 -123
  125. package/dist/core/resolve/path-checks.d.mts +0 -48
  126. package/dist/core/resolve/path-checks.mjs +0 -102
  127. package/dist/core/resolve/redaction.d.mts +0 -13
  128. package/dist/core/resolve/redaction.mjs +0 -14
  129. package/dist/core/resolve/stages.d.mts +0 -86
  130. package/dist/core/resolve/stages.mjs +0 -170
  131. package/dist/core/resolve/standard.d.mts +0 -26
  132. package/dist/core/resolve/standard.mjs +0 -212
  133. package/dist/core/schema/activity.d.mts +0 -189
  134. package/dist/core/schema/arg.d.mts +0 -1461
  135. package/dist/core/schema/arg.mjs +0 -1139
  136. package/dist/core/schema/brand.d.mts +0 -17
  137. package/dist/core/schema/cardinality.d.mts +0 -302
  138. package/dist/core/schema/cardinality.mjs +0 -514
  139. package/dist/core/schema/command.d.mts +0 -1132
  140. package/dist/core/schema/command.mjs +0 -999
  141. package/dist/core/schema/flag.d.mts +0 -1495
  142. package/dist/core/schema/flag.mjs +0 -1207
  143. package/dist/core/schema/index.d.mts +0 -15
  144. package/dist/core/schema/index.mjs +0 -10
  145. package/dist/core/schema/middleware.d.mts +0 -129
  146. package/dist/core/schema/middleware.mjs +0 -41
  147. package/dist/core/schema/number-constraints.d.mts +0 -96
  148. package/dist/core/schema/number-constraints.mjs +0 -60
  149. package/dist/core/schema/prompt.d.mts +0 -135
  150. package/dist/core/schema/provenance.d.mts +0 -99
  151. package/dist/core/schema/provenance.mjs +0 -28
  152. package/dist/core/schema/run.d.mts +0 -211
  153. package/dist/core/schema/source.d.mts +0 -180
  154. package/dist/core/schema/source.mjs +0 -206
  155. package/dist/core/schema/standard.d.mts +0 -100
  156. package/dist/core/schema/standard.mjs +0 -15
  157. package/dist/core/schema/stdin.d.mts +0 -97
  158. package/dist/core/schema/stdin.mjs +0 -91
  159. package/dist/core/schema/string-constraints.d.mts +0 -108
  160. package/dist/core/schema/string-constraints.mjs +0 -86
  161. package/dist/core/schema/value-parsers.d.mts +0 -150
  162. package/dist/core/schema/value-parsers.mjs +0 -160
  163. package/dist/core/schema/value.d.mts +0 -243
  164. package/dist/core/schema/value.mjs +0 -573
  165. package/dist/core/testkit/index.d.mts +0 -63
  166. package/dist/core/testkit/index.mjs +0 -102
  167. package/dist/runtime/adapter.mjs +0 -92
  168. package/dist/runtime/auto.d.mts +0 -25
  169. package/dist/runtime/auto.mjs +0 -45
  170. package/dist/runtime/deno.d.mts +0 -99
  171. package/dist/runtime/deno.mjs +0 -265
  172. package/dist/runtime/detect.d.mts +0 -86
  173. package/dist/runtime/detect.mjs +0 -45
  174. package/dist/runtime/index.d.mts +0 -6
  175. package/dist/runtime/node.d.mts +0 -71
  176. package/dist/runtime/node.mjs +0 -228
  177. package/dist/runtime/paths.d.mts +0 -31
  178. package/dist/runtime/paths.mjs +0 -48
  179. package/dist/strings.d.mts +0 -27
  180. package/dist/strings.mjs +0 -22
  181. package/examples/basic.ts +0 -37
  182. package/examples/flag-types.ts +0 -79
  183. package/examples/gh/package.json +0 -45
  184. package/examples/gh/src/commands/auth.ts +0 -66
  185. package/examples/gh/src/commands/issue.ts +0 -120
  186. package/examples/gh/src/commands/pr.ts +0 -125
  187. package/examples/gh/src/data/issues.yaml +0 -5
  188. package/examples/gh/src/data/issues.yaml.d.ts +0 -17
  189. package/examples/gh/src/data/pull-requests.yaml +0 -7
  190. package/examples/gh/src/data/pull-requests.yaml.d.ts +0 -18
  191. package/examples/gh/src/docs.ts +0 -11
  192. package/examples/gh/src/lib/auth.ts +0 -37
  193. package/examples/gh/src/lib/utils.ts +0 -17
  194. package/examples/gh/src/main.test.ts +0 -307
  195. package/examples/gh/src/main.ts +0 -46
  196. package/examples/help-config.ts +0 -43
  197. package/examples/interactive.ts +0 -67
  198. package/examples/json-mode.ts +0 -95
  199. package/examples/middleware.ts +0 -71
  200. package/examples/multi-command.ts +0 -66
  201. package/examples/output-extras.ts +0 -46
  202. package/examples/parser-control.ts +0 -40
  203. package/examples/pwsh-demo/README.md +0 -40
  204. package/examples/pwsh-demo/package.json +0 -41
  205. package/examples/pwsh-demo/pwsh-demo.cmd +0 -3
  206. package/examples/pwsh-demo/smoke-powershell.ps1 +0 -218
  207. package/examples/pwsh-demo/src/main.test.ts +0 -45
  208. package/examples/pwsh-demo/src/main.ts +0 -140
  209. package/examples/spinner-progress.ts +0 -49
  210. package/examples/standard-schema.ts +0 -45
  211. package/examples/testing.ts +0 -147
  212. package/examples/transport-launcher.ts +0 -85
@@ -1,205 +0,0 @@
1
- import { buildFlagLookup, flagExpectsValue } from "../parse/index.mjs";
2
- //#region src/core/cli/dispatch.ts
3
- /**
4
- * Recursively walk argv, consuming command name segments from the front.
5
- *
6
- * At each level, the first non-flag token is tested as a command name
7
- * against the provided command map. If matched and the matched command
8
- * has subcommands, dispatch recurses into the child level with the
9
- * remaining argv.
10
- *
11
- * Ambiguity resolution for commands that have both an action handler AND
12
- * subcommands (e.g. `git remote` lists remotes, `git remote add` dispatches):
13
- * - If the next token matches a subcommand → descend
14
- * - If the next token is unknown and the command has a handler → match here
15
- * - If the next token is unknown and no handler → propagate unknown error
16
- * - If no next token and command has a handler → match here
17
- * - If no next token and no handler → needs-subcommand
18
- *
19
- * @param argv - Remaining argv tokens (command names + flags + args).
20
- * @param commands - Command map at the current tree level.
21
- * @param ancestorPath - Schema path from root to current level (exclusive).
22
- * @param valueFlags - Lookup of flags valid at this level, used so a
23
- * space-separated value-flag's value (`--region eu`) is not mistaken for a
24
- * command name. Empty by default (arity-unaware, legacy behaviour).
25
- * @param parseOptions - Parser toggles (case parity) applied to descent-level
26
- * flag lookups built inside dispatch.
27
- * @returns Discriminated dispatch result.
28
- *
29
- * @internal
30
- */
31
- function dispatch(argv, commands, ancestorPath = [], valueFlags = /* @__PURE__ */ new Map(), parseOptions) {
32
- let cmdIdx = -1;
33
- for (let i = 0; i < argv.length; i++) {
34
- const token = argv[i];
35
- if (token === void 0) continue;
36
- if (token === "--") {
37
- if (i + 1 < argv.length) cmdIdx = i + 1;
38
- break;
39
- }
40
- if (token.startsWith("-")) {
41
- if (consumesFollowingToken(token, valueFlags)) i++;
42
- continue;
43
- }
44
- cmdIdx = i;
45
- break;
46
- }
47
- if (cmdIdx === -1) return {
48
- kind: "unknown",
49
- input: "",
50
- candidates: uniqueCommands(commands),
51
- parentPath: ancestorPath
52
- };
53
- const cmdName = argv[cmdIdx];
54
- if (cmdName === void 0) return {
55
- kind: "unknown",
56
- input: "",
57
- candidates: uniqueCommands(commands),
58
- parentPath: ancestorPath
59
- };
60
- const matched = commands.get(cmdName);
61
- if (matched === void 0) return {
62
- kind: "unknown",
63
- input: cmdName,
64
- candidates: uniqueCommands(commands),
65
- parentPath: ancestorPath
66
- };
67
- const remaining = [...argv.slice(0, cmdIdx), ...argv.slice(cmdIdx + 1)];
68
- const currentPath = [...ancestorPath, matched.schema];
69
- if (matched.subcommands.size > 0) {
70
- const subResult = dispatch(remaining, matched.subcommands, currentPath, buildFlagLookup(matched.schema.flags, parseOptions), parseOptions);
71
- switch (subResult.kind) {
72
- case "match": return subResult;
73
- case "unknown":
74
- if (subResult.input === "") {
75
- if (matched.schema.hasAction) return {
76
- kind: "match",
77
- command: matched,
78
- commandPath: currentPath,
79
- remainingArgv: remaining
80
- };
81
- return {
82
- kind: "needs-subcommand",
83
- command: matched,
84
- commandPath: currentPath
85
- };
86
- }
87
- if (matched.schema.hasAction) return {
88
- kind: "match",
89
- command: matched,
90
- commandPath: currentPath,
91
- remainingArgv: remaining
92
- };
93
- return subResult;
94
- case "needs-subcommand": return subResult;
95
- default: return subResult;
96
- }
97
- }
98
- return {
99
- kind: "match",
100
- command: matched,
101
- commandPath: currentPath,
102
- remainingArgv: remaining
103
- };
104
- }
105
- /**
106
- * Whether a flag token consumes the following argv token as its value.
107
- *
108
- * Mirrors the parser's value-consumption rules (`parseLongFlag` /
109
- * `parseShortFlags`) so the command-name scan skips exactly the tokens the
110
- * parser would treat as flag values:
111
- * - `--flag value` → consumes when `--flag` is a known value-flag.
112
- * - `--flag=value` → self-contained, consumes nothing.
113
- * - `-abc value` → consumes only when the trailing short flag is a value-flag;
114
- * an earlier value-flag char takes the rest of the group as an inline value.
115
- *
116
- * Unknown flags conservatively consume nothing (the parser reports them later).
117
- *
118
- * @internal
119
- */
120
- function consumesFollowingToken(token, valueFlags) {
121
- if (token.startsWith("--")) {
122
- if (token.includes("=")) return false;
123
- const entry = valueFlags.get(token.slice(2));
124
- return entry !== void 0 && flagExpectsValue(entry.schema);
125
- }
126
- const chars = token.slice(1);
127
- for (let i = 0; i < chars.length; i++) {
128
- const entry = valueFlags.get(chars.charAt(i));
129
- if (entry === void 0) return false;
130
- if (!flagExpectsValue(entry.schema)) continue;
131
- return i === chars.length - 1;
132
- }
133
- return false;
134
- }
135
- /**
136
- * Levenshtein distance between two strings.
137
- * @internal
138
- */
139
- function levenshtein(a, b) {
140
- const m = a.length;
141
- const n = b.length;
142
- const w = n + 1;
143
- let prev = new Uint16Array(w);
144
- let curr = new Uint16Array(w);
145
- for (let j = 0; j <= n; j++) prev[j] = j;
146
- for (let i = 1; i <= m; i++) {
147
- curr[0] = i;
148
- for (let j = 1; j <= n; j++) {
149
- const cost = a.charAt(i - 1) === b.charAt(j - 1) ? 0 : 1;
150
- const del = prev[j] ?? 0;
151
- const ins = curr[j - 1] ?? 0;
152
- const sub = prev[j - 1] ?? 0;
153
- curr[j] = Math.min(del + 1, ins + 1, sub + cost);
154
- }
155
- [prev, curr] = [curr, prev];
156
- }
157
- return prev[n] ?? Math.max(m, n);
158
- }
159
- /**
160
- * Find the closest command name match for a "did you mean?" suggestion.
161
- *
162
- * Searches command names and aliases. Returns `undefined` if no
163
- * sufficiently close match exists (threshold: 3).
164
- *
165
- * @internal
166
- */
167
- function findClosestCommand(input, commands) {
168
- const MAX_DISTANCE = 3;
169
- let bestName;
170
- let bestDist = 4;
171
- for (const cmd of commands) {
172
- const nameDist = levenshtein(input, cmd.schema.name);
173
- if (nameDist < bestDist) {
174
- bestDist = nameDist;
175
- bestName = cmd.schema.name;
176
- }
177
- for (const alias of cmd.schema.aliases) {
178
- const aliasDist = levenshtein(input, alias);
179
- if (aliasDist < bestDist) {
180
- bestDist = aliasDist;
181
- bestName = cmd.schema.name;
182
- }
183
- }
184
- }
185
- return bestDist <= MAX_DISTANCE ? bestName : void 0;
186
- }
187
- /**
188
- * Deduplicate commands from a name+alias map.
189
- *
190
- * A map keyed by name *and* alias contains duplicate entries for aliased
191
- * commands. This returns unique commands (by schema identity).
192
- *
193
- * @internal
194
- */
195
- function uniqueCommands(commands) {
196
- const seen = /* @__PURE__ */ new Set();
197
- const result = [];
198
- for (const cmd of commands.values()) if (!seen.has(cmd)) {
199
- seen.add(cmd);
200
- result.push(cmd);
201
- }
202
- return result;
203
- }
204
- //#endregion
205
- export { consumesFollowingToken, dispatch, findClosestCommand, levenshtein, uniqueCommands };
@@ -1,27 +0,0 @@
1
- import { PackageJsonData } from "../config/package-json.mjs";
2
- //#region src/core/cli/help-links.d.ts
3
- /**
4
- * OSC 8 hyperlink targets for the root-help header.
5
- *
6
- * Set via `CLIBuilder.links()`; fields left `undefined` are derived from
7
- * manifest metadata when `.manifest()` is active.
8
- */
9
- interface HelpLinks {
10
- /** URL the program name links to (e.g. the repository or homepage). */
11
- readonly name: string | undefined;
12
- /** URL the version links to (e.g. the release tag). */
13
- readonly version: string | undefined;
14
- }
15
- /**
16
- * Fill `undefined` link fields from package.json metadata.
17
- *
18
- * Explicit URLs always win. The name falls back to the normalized
19
- * `repository` URL, then `homepage`; the version falls back to the forge
20
- * release-tag URL when both a repository and a version are known.
21
- * Idempotent — already-resolved fields pass through unchanged.
22
- *
23
- * @internal
24
- */
25
- declare function deriveHelpLinks(links: HelpLinks | undefined, pkg: PackageJsonData | undefined, version: string | undefined): HelpLinks | undefined;
26
- //#endregion
27
- export { type HelpLinks, deriveHelpLinks };
@@ -1,41 +0,0 @@
1
- import { packageRepositoryUrl } from "../config/package-json.mjs";
2
- //#region src/core/cli/help-links.ts
3
- /**
4
- * Build the release-tag URL for a version on a known forge.
5
- *
6
- * GitHub and GitLab have stable release-tag routes; other hosts return
7
- * `undefined` rather than guessing.
8
- *
9
- * @internal
10
- */
11
- function releaseTagUrl(repoUrl, version) {
12
- let hostname;
13
- try {
14
- hostname = new URL(repoUrl).hostname;
15
- } catch {
16
- return;
17
- }
18
- if (hostname === "github.com") return `${repoUrl}/releases/tag/v${version}`;
19
- if (hostname === "gitlab.com") return `${repoUrl}/-/releases/v${version}`;
20
- }
21
- /**
22
- * Fill `undefined` link fields from package.json metadata.
23
- *
24
- * Explicit URLs always win. The name falls back to the normalized
25
- * `repository` URL, then `homepage`; the version falls back to the forge
26
- * release-tag URL when both a repository and a version are known.
27
- * Idempotent — already-resolved fields pass through unchanged.
28
- *
29
- * @internal
30
- */
31
- function deriveHelpLinks(links, pkg, version) {
32
- if (links === void 0) return void 0;
33
- if (pkg === void 0 || links.name !== void 0 && links.version !== void 0) return links;
34
- const repoUrl = packageRepositoryUrl(pkg);
35
- return {
36
- name: links.name ?? repoUrl ?? pkg.homepage,
37
- version: links.version ?? (repoUrl !== void 0 && version !== void 0 ? releaseTagUrl(repoUrl, version) : void 0)
38
- };
39
- }
40
- //#endregion
41
- export { deriveHelpLinks };