@kjanat/dreamcli 4.0.0-rc.3 → 4.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.
- package/README.md +5 -7
- package/dist/{runtime/adapter.d.mts → adapter-D0hbBNVB.d.mts} +2 -4
- package/dist/completion-D4mz6axB.mjs +6 -0
- package/dist/completion.d.mts +90 -0
- package/dist/completion.mjs +1 -0
- package/dist/config-B9ddC-Kb.mjs +1 -0
- package/dist/config.d.mts +2 -0
- package/dist/config.mjs +1 -0
- package/dist/core-Cp2w8vRq.mjs +17 -0
- package/dist/index-BziI2aKc.d.mts +5440 -0
- package/dist/index-DOfClfYR.d.mts +370 -0
- package/dist/index-DWsnGZlx.d.mts +831 -0
- package/dist/{core/cli/index.d.mts → index-DXROeDPC.d.mts} +116 -57
- package/dist/index-DndPmT8J.d.mts +275 -0
- package/dist/{core/json-schema/index.d.mts → index-DyoaS234.d.mts} +43 -34
- package/dist/index.d.mts +190 -41
- package/dist/index.mjs +1 -26
- package/dist/json-schema-C9SzZ7jY.mjs +52 -0
- package/dist/json-schema.d.mts +2 -0
- package/dist/json-schema.mjs +1 -0
- package/dist/package-json-BgE9YjjQ.mjs +3 -0
- package/dist/prompt.d.mts +48 -0
- package/dist/prompt.mjs +1 -0
- package/dist/rolldown-runtime-G4Kt5YOX.mjs +1 -0
- package/dist/runtime.d.mts +2 -6
- package/dist/runtime.mjs +1 -6
- package/dist/terminal-C8KTXjv5.mjs +6 -0
- package/dist/test-prompter-v__jT2yG.mjs +1 -0
- package/dist/testkit.d.mts +54 -6
- package/dist/testkit.mjs +1 -5
- package/dist/version.mjs +1 -7
- package/dreamcli.schema.json +697 -538
- package/package.json +29 -7
- package/skills/cli-creation/SKILL.md +16 -11
- package/CHANGELOG.md +0 -1116
- package/dist/core/cli/builtins.d.mts +0 -117
- package/dist/core/cli/builtins.mjs +0 -135
- package/dist/core/cli/compiled.d.mts +0 -66
- package/dist/core/cli/compiled.mjs +0 -76
- package/dist/core/cli/dispatch.d.mts +0 -115
- package/dist/core/cli/dispatch.mjs +0 -205
- package/dist/core/cli/help-links.d.mts +0 -27
- package/dist/core/cli/help-links.mjs +0 -41
- package/dist/core/cli/index.mjs +0 -1271
- package/dist/core/cli/planner.d.mts +0 -174
- package/dist/core/cli/planner.mjs +0 -323
- package/dist/core/cli/plugin.d.mts +0 -94
- package/dist/core/cli/plugin.mjs +0 -41
- package/dist/core/cli/propagate.d.mts +0 -39
- package/dist/core/cli/propagate.mjs +0 -57
- package/dist/core/cli/reserved-flags.d.mts +0 -19
- package/dist/core/cli/reserved-flags.mjs +0 -158
- package/dist/core/cli/root-help.d.mts +0 -53
- package/dist/core/cli/root-help.mjs +0 -221
- package/dist/core/cli/root-output-flags.d.mts +0 -74
- package/dist/core/cli/root-output-flags.mjs +0 -169
- package/dist/core/cli/root-surface.d.mts +0 -64
- package/dist/core/cli/root-surface.mjs +0 -28
- package/dist/core/cli/runtime-preflight.d.mts +0 -213
- package/dist/core/cli/runtime-preflight.mjs +0 -221
- package/dist/core/completion/index.d.mts +0 -76
- package/dist/core/completion/index.mjs +0 -90
- package/dist/core/completion/shells/bash.d.mts +0 -23
- package/dist/core/completion/shells/bash.mjs +0 -312
- package/dist/core/completion/shells/fish.d.mts +0 -19
- package/dist/core/completion/shells/fish.mjs +0 -164
- package/dist/core/completion/shells/powershell.d.mts +0 -13
- package/dist/core/completion/shells/powershell.mjs +0 -360
- package/dist/core/completion/shells/shared.d.mts +0 -164
- package/dist/core/completion/shells/shared.mjs +0 -147
- package/dist/core/completion/shells/zsh.d.mts +0 -23
- package/dist/core/completion/shells/zsh.mjs +0 -256
- package/dist/core/config/index.d.mts +0 -191
- package/dist/core/config/index.mjs +0 -285
- package/dist/core/config/package-json.d.mts +0 -179
- package/dist/core/config/package-json.mjs +0 -353
- package/dist/core/errors/index.d.mts +0 -125
- package/dist/core/errors/index.mjs +0 -87
- package/dist/core/execution/index.d.mts +0 -61
- package/dist/core/execution/index.mjs +0 -220
- package/dist/core/help/ansi.d.mts +0 -84
- package/dist/core/help/ansi.mjs +0 -121
- package/dist/core/help/index.d.mts +0 -149
- package/dist/core/help/index.mjs +0 -418
- package/dist/core/help/theme.d.mts +0 -86
- package/dist/core/help/theme.mjs +0 -69
- package/dist/core/json-schema/index.mjs +0 -1008
- package/dist/core/json-schema/meta-descriptions.generated.d.mts +0 -274
- package/dist/core/json-schema/meta-descriptions.generated.mjs +0 -136
- package/dist/core/output/activity.d.mts +0 -193
- package/dist/core/output/activity.mjs +0 -452
- package/dist/core/output/bind.d.mts +0 -37
- package/dist/core/output/bind.mjs +0 -56
- package/dist/core/output/contracts.d.mts +0 -82
- package/dist/core/output/contracts.mjs +0 -57
- package/dist/core/output/display-value.d.mts +0 -19
- package/dist/core/output/display-value.mjs +0 -32
- package/dist/core/output/index.d.mts +0 -344
- package/dist/core/output/index.mjs +0 -514
- package/dist/core/output/renderers.d.mts +0 -45
- package/dist/core/output/renderers.mjs +0 -46
- package/dist/core/output/writer.d.mts +0 -39
- package/dist/core/output/writer.mjs +0 -12
- package/dist/core/parse/index.d.mts +0 -178
- package/dist/core/parse/index.mjs +0 -850
- package/dist/core/parse/occurrences.d.mts +0 -90
- package/dist/core/parse/occurrences.mjs +0 -114
- package/dist/core/prompt/index.d.mts +0 -213
- package/dist/core/prompt/index.mjs +0 -348
- package/dist/core/read-flags/index.d.mts +0 -150
- package/dist/core/read-flags/index.mjs +0 -217
- package/dist/core/resolve/args.d.mts +0 -39
- package/dist/core/resolve/args.mjs +0 -182
- package/dist/core/resolve/coerce.d.mts +0 -79
- package/dist/core/resolve/coerce.mjs +0 -900
- package/dist/core/resolve/config.d.mts +0 -10
- package/dist/core/resolve/config.mjs +0 -19
- package/dist/core/resolve/contracts.d.mts +0 -146
- package/dist/core/resolve/errors.d.mts +0 -10
- package/dist/core/resolve/errors.mjs +0 -148
- package/dist/core/resolve/flags.d.mts +0 -74
- package/dist/core/resolve/flags.mjs +0 -246
- package/dist/core/resolve/index.d.mts +0 -44
- package/dist/core/resolve/index.mjs +0 -123
- package/dist/core/resolve/path-checks.d.mts +0 -48
- package/dist/core/resolve/path-checks.mjs +0 -102
- package/dist/core/resolve/redaction.d.mts +0 -13
- package/dist/core/resolve/redaction.mjs +0 -14
- package/dist/core/resolve/stages.d.mts +0 -86
- package/dist/core/resolve/stages.mjs +0 -170
- package/dist/core/resolve/standard.d.mts +0 -26
- package/dist/core/resolve/standard.mjs +0 -212
- package/dist/core/schema/activity.d.mts +0 -189
- package/dist/core/schema/arg.d.mts +0 -1461
- package/dist/core/schema/arg.mjs +0 -1139
- package/dist/core/schema/brand.d.mts +0 -17
- package/dist/core/schema/cardinality.d.mts +0 -302
- package/dist/core/schema/cardinality.mjs +0 -514
- package/dist/core/schema/command.d.mts +0 -1132
- package/dist/core/schema/command.mjs +0 -999
- package/dist/core/schema/flag.d.mts +0 -1495
- package/dist/core/schema/flag.mjs +0 -1207
- package/dist/core/schema/index.d.mts +0 -15
- package/dist/core/schema/index.mjs +0 -10
- package/dist/core/schema/middleware.d.mts +0 -129
- package/dist/core/schema/middleware.mjs +0 -41
- package/dist/core/schema/number-constraints.d.mts +0 -96
- package/dist/core/schema/number-constraints.mjs +0 -60
- package/dist/core/schema/prompt.d.mts +0 -135
- package/dist/core/schema/provenance.d.mts +0 -99
- package/dist/core/schema/provenance.mjs +0 -28
- package/dist/core/schema/run.d.mts +0 -211
- package/dist/core/schema/source.d.mts +0 -180
- package/dist/core/schema/source.mjs +0 -206
- package/dist/core/schema/standard.d.mts +0 -100
- package/dist/core/schema/standard.mjs +0 -15
- package/dist/core/schema/stdin.d.mts +0 -97
- package/dist/core/schema/stdin.mjs +0 -91
- package/dist/core/schema/string-constraints.d.mts +0 -108
- package/dist/core/schema/string-constraints.mjs +0 -86
- package/dist/core/schema/value-parsers.d.mts +0 -150
- package/dist/core/schema/value-parsers.mjs +0 -160
- package/dist/core/schema/value.d.mts +0 -243
- package/dist/core/schema/value.mjs +0 -573
- package/dist/core/testkit/index.d.mts +0 -63
- package/dist/core/testkit/index.mjs +0 -102
- package/dist/runtime/adapter.mjs +0 -92
- package/dist/runtime/auto.d.mts +0 -25
- package/dist/runtime/auto.mjs +0 -45
- package/dist/runtime/deno.d.mts +0 -99
- package/dist/runtime/deno.mjs +0 -265
- package/dist/runtime/detect.d.mts +0 -86
- package/dist/runtime/detect.mjs +0 -45
- package/dist/runtime/index.d.mts +0 -6
- package/dist/runtime/node.d.mts +0 -71
- package/dist/runtime/node.mjs +0 -228
- package/dist/runtime/paths.d.mts +0 -31
- package/dist/runtime/paths.mjs +0 -48
- package/dist/strings.d.mts +0 -27
- package/dist/strings.mjs +0 -22
- package/examples/basic.ts +0 -37
- package/examples/flag-types.ts +0 -79
- package/examples/gh/package.json +0 -45
- package/examples/gh/src/commands/auth.ts +0 -66
- package/examples/gh/src/commands/issue.ts +0 -120
- package/examples/gh/src/commands/pr.ts +0 -125
- package/examples/gh/src/data/issues.yaml +0 -5
- package/examples/gh/src/data/issues.yaml.d.ts +0 -17
- package/examples/gh/src/data/pull-requests.yaml +0 -7
- package/examples/gh/src/data/pull-requests.yaml.d.ts +0 -18
- package/examples/gh/src/docs.ts +0 -11
- package/examples/gh/src/lib/auth.ts +0 -37
- package/examples/gh/src/lib/utils.ts +0 -17
- package/examples/gh/src/main.test.ts +0 -307
- package/examples/gh/src/main.ts +0 -46
- package/examples/help-config.ts +0 -43
- package/examples/interactive.ts +0 -67
- package/examples/json-mode.ts +0 -95
- package/examples/middleware.ts +0 -71
- package/examples/multi-command.ts +0 -66
- package/examples/output-extras.ts +0 -46
- package/examples/parser-control.ts +0 -40
- package/examples/pwsh-demo/README.md +0 -40
- package/examples/pwsh-demo/package.json +0 -41
- package/examples/pwsh-demo/pwsh-demo.cmd +0 -3
- package/examples/pwsh-demo/smoke-powershell.ps1 +0 -218
- package/examples/pwsh-demo/src/main.test.ts +0 -45
- package/examples/pwsh-demo/src/main.ts +0 -140
- package/examples/spinner-progress.ts +0 -49
- package/examples/standard-schema.ts +0 -45
- package/examples/testing.ts +0 -147
- 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 };
|