@shell-shock/plugin-help 0.2.26 → 0.2.28
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/dist/_virtual/_rolldown/runtime.cjs +29 -1
- package/dist/components/display.cjs +278 -18
- package/dist/components/display.mjs +271 -18
- package/dist/components/display.mjs.map +1 -1
- package/dist/components/help-builtin.cjs +99 -1
- package/dist/components/help-builtin.mjs +96 -1
- package/dist/components/help-builtin.mjs.map +1 -1
- package/dist/components/help-command.cjs +152 -1
- package/dist/components/help-command.d.cts +1 -1
- package/dist/components/help-command.d.mts +1 -1
- package/dist/components/help-command.mjs +149 -1
- package/dist/components/help-command.mjs.map +1 -1
- package/dist/components/index.cjs +14 -1
- package/dist/components/index.mjs +5 -1
- package/dist/index.cjs +98 -1
- package/dist/index.mjs +92 -1
- package/dist/index.mjs.map +1 -1
- package/dist/types/index.mjs +1 -1
- package/dist/types/plugin.mjs +1 -1
- package/package.json +15 -15
|
@@ -1,23 +1,276 @@
|
|
|
1
|
-
import{createComponent
|
|
1
|
+
import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
|
|
2
|
+
import { For, Show, code, computed } from "@alloy-js/core";
|
|
3
|
+
import { formatDescription, formatShortDescription, getAppBin, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from "@shell-shock/core/plugin-utils";
|
|
4
|
+
import { isSetString } from "@stryke/type-checks/is-set-string";
|
|
5
|
+
import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
|
|
6
|
+
import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
|
|
7
|
+
import { CommandParameterKinds } from "@shell-shock/core";
|
|
8
|
+
import { useTheme } from "@shell-shock/plugin-theme/contexts/theme";
|
|
9
|
+
import { camelCase } from "@stryke/string-format/camel-case";
|
|
10
|
+
import { kebabCase } from "@stryke/string-format/kebab-case";
|
|
11
|
+
import { snakeCase } from "@stryke/string-format/snake-case";
|
|
12
|
+
|
|
13
|
+
//#region src/components/display.tsx
|
|
14
|
+
/**
|
|
15
|
+
* A component that generates the usage display for a command.
|
|
16
|
+
*/
|
|
17
|
+
function HelpUsageDisplay(props) {
|
|
18
|
+
const { command, indent = 2 } = props;
|
|
19
|
+
const context = usePowerlines();
|
|
20
|
+
const theme = useTheme();
|
|
21
|
+
return [
|
|
22
|
+
memo(() => code`
|
|
2
23
|
writeLine(
|
|
3
|
-
textColors.body.secondary(\`\${textColors.usage.bin("$_ ${
|
|
4
|
-
);`),
|
|
24
|
+
textColors.body.secondary(\`\${textColors.usage.bin("$_ ${getAppBin(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("[command]")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join("|") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${textColors.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
|
|
25
|
+
);`),
|
|
26
|
+
createIntrinsic("hbr", {}),
|
|
27
|
+
createComponent(Show, {
|
|
28
|
+
get when() {
|
|
29
|
+
return command.args.length > 0;
|
|
30
|
+
},
|
|
31
|
+
get children() {
|
|
32
|
+
return [
|
|
33
|
+
createIntrinsic("hbr", {}),
|
|
34
|
+
memo(() => code`
|
|
5
35
|
writeLine(
|
|
6
|
-
textColors.body.secondary(\`\${textColors.usage.bin("$_ ${
|
|
7
|
-
);`),
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
36
|
+
textColors.body.secondary(\`\${textColors.usage.bin("$_ ${getAppBin(context)}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${textColors.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${textColors.usage.dynamic("[command]")}` : ""} \${textColors.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${textColors.usage.args("<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join("|") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${theme.padding.app * indent} }
|
|
37
|
+
);`),
|
|
38
|
+
createIntrinsic("hbr", {})
|
|
39
|
+
];
|
|
40
|
+
}
|
|
41
|
+
})
|
|
42
|
+
];
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* A component that generates the options table display for a command.
|
|
46
|
+
*/
|
|
47
|
+
function HelpOptionsDisplay(props) {
|
|
48
|
+
const { options } = props;
|
|
49
|
+
const context = usePowerlines();
|
|
50
|
+
return [
|
|
51
|
+
code`table([ `,
|
|
52
|
+
createIntrinsic("hbr", {}),
|
|
53
|
+
createComponent(For, {
|
|
54
|
+
get each() {
|
|
55
|
+
return sortOptions(options);
|
|
56
|
+
},
|
|
57
|
+
hardline: true,
|
|
58
|
+
children: (option) => {
|
|
59
|
+
const flags = [];
|
|
60
|
+
const names = [];
|
|
61
|
+
if (option.name.length === 1) flags.push(`-${option.name}`);
|
|
62
|
+
else names.push(`--${kebabCase(option.name)}`);
|
|
63
|
+
option.alias.forEach((alias) => {
|
|
64
|
+
if (alias.length === 1) flags.push(`-${alias}`);
|
|
65
|
+
else names.push(`--${kebabCase(alias)}`);
|
|
66
|
+
});
|
|
67
|
+
return code`[{ value: textColors.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.format ? option.format : option.name)}${option.variadic ? "..." : ""}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: textColors.body.tertiary(\`${formatShortDescription(option.description, { length: 200 }).replace(/\.+$/, "").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/"/g, "\\\"")}` : ""})` : ""}.\`), align: "left", border: "none" }], `;
|
|
68
|
+
}
|
|
69
|
+
}),
|
|
70
|
+
createIntrinsic("hbr", {}),
|
|
71
|
+
code` ]); `
|
|
72
|
+
];
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* A component that generates the commands table display for a command.
|
|
76
|
+
*/
|
|
77
|
+
function HelpCommandsDisplay(props) {
|
|
78
|
+
const { commands } = props;
|
|
79
|
+
return [
|
|
80
|
+
code`table([ `,
|
|
81
|
+
createIntrinsic("hbr", {}),
|
|
82
|
+
createComponent(For, {
|
|
83
|
+
get each() {
|
|
84
|
+
return Object.values(commands);
|
|
85
|
+
},
|
|
86
|
+
hardline: true,
|
|
87
|
+
children: (child) => code`[{ value: textColors.body.primary("${child.name}"), align: "right", border: "none" }, { value: textColors.body.tertiary(\`${formatShortDescription(child.description, { length: 200 }).replace(/\.+$/, "").trim()}.\`), align: "left", border: "none" }], `
|
|
88
|
+
}),
|
|
89
|
+
createIntrinsic("hbr", {}),
|
|
90
|
+
code` ]); `
|
|
91
|
+
];
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* A component that generates the `help` function declaration for a command.
|
|
95
|
+
*/
|
|
96
|
+
function BaseHelpDisplay(props) {
|
|
97
|
+
const { command, indent = 1, filterGlobalOptions = false } = props;
|
|
98
|
+
const theme = useTheme();
|
|
99
|
+
const context = usePowerlines();
|
|
100
|
+
const options = computed(() => filterGlobalOptions ? Object.values(command.options).filter((option) => !context.globalOptions.some((globalOption) => globalOption.name === option.name || option.alias.includes(globalOption.name) || globalOption.alias?.includes(option.name) || globalOption.alias?.some((alias) => option.alias.includes(alias)))) : Object.values(command.options));
|
|
101
|
+
return [
|
|
102
|
+
memo(() => code`writeLine(bold(textColors.heading.secondary("Usage:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
|
|
103
|
+
createIntrinsic("hbr", {}),
|
|
104
|
+
createComponent(HelpUsageDisplay, {
|
|
105
|
+
command,
|
|
106
|
+
indent
|
|
107
|
+
}),
|
|
108
|
+
createComponent(Spacing, {}),
|
|
109
|
+
createComponent(Show, {
|
|
110
|
+
get when() {
|
|
111
|
+
return options.value.length > 0;
|
|
112
|
+
},
|
|
113
|
+
get children() {
|
|
114
|
+
return [
|
|
115
|
+
memo(() => code`writeLine("");
|
|
116
|
+
writeLine(bold(textColors.heading.secondary("Options:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
|
|
117
|
+
createIntrinsic("hbr", {}),
|
|
118
|
+
createComponent(HelpOptionsDisplay, { get options() {
|
|
119
|
+
return options.value;
|
|
120
|
+
} }),
|
|
121
|
+
createComponent(Spacing, {})
|
|
122
|
+
];
|
|
123
|
+
}
|
|
124
|
+
}),
|
|
125
|
+
createComponent(Show, {
|
|
126
|
+
get when() {
|
|
127
|
+
return Object.keys(command.children).length > 0;
|
|
128
|
+
},
|
|
129
|
+
get children() {
|
|
130
|
+
return [
|
|
131
|
+
memo(() => code`writeLine("");
|
|
132
|
+
writeLine(bold(textColors.heading.secondary("Commands:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
|
|
133
|
+
createIntrinsic("hbr", {}),
|
|
134
|
+
createComponent(HelpCommandsDisplay, { get commands() {
|
|
135
|
+
return command.children;
|
|
136
|
+
} }),
|
|
137
|
+
createComponent(Spacing, {})
|
|
138
|
+
];
|
|
139
|
+
}
|
|
140
|
+
}),
|
|
141
|
+
createComponent(Show, {
|
|
142
|
+
get when() {
|
|
143
|
+
return isSetString(command.reference);
|
|
144
|
+
},
|
|
145
|
+
get children() {
|
|
146
|
+
return [
|
|
147
|
+
memo(() => code`writeLine("");
|
|
148
|
+
writeLine(textColors.heading.tertiary(\`More information about this command can be found in the reference documentation at \${link("${command.reference}")}\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
|
|
149
|
+
createIntrinsic("hbr", {}),
|
|
150
|
+
createComponent(Spacing, {})
|
|
151
|
+
];
|
|
152
|
+
}
|
|
153
|
+
})
|
|
154
|
+
];
|
|
155
|
+
}
|
|
156
|
+
function sortCommands(commands) {
|
|
157
|
+
return Object.values(commands).sort((a, b) => {
|
|
158
|
+
if (a.tags.some((tag) => tag.toLowerCase() === "deprecated") && !b.tags.some((tag) => tag.toLowerCase() === "deprecated")) return 1;
|
|
159
|
+
else if (!a.tags.some((tag) => tag.toLowerCase() === "deprecated") && b.tags.some((tag) => tag.toLowerCase() === "deprecated")) return -1;
|
|
160
|
+
else if (a.tags.some((tag) => tag.toLowerCase() === "experimental") && !b.tags.some((tag) => tag.toLowerCase() === "experimental")) return 1;
|
|
161
|
+
else if (!a.tags.some((tag) => tag.toLowerCase() === "experimental") && b.tags.some((tag) => tag.toLowerCase() === "experimental")) return -1;
|
|
162
|
+
else if (a.tags.some((tag) => tag.toLowerCase() === "utility") && !b.tags.some((tag) => tag.toLowerCase() === "utility")) return 1;
|
|
163
|
+
else if (!a.tags.some((tag) => tag.toLowerCase() === "utility") && b.tags.some((tag) => tag.toLowerCase() === "utility")) return -1;
|
|
164
|
+
return a.name.localeCompare(b.name);
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* A component that generates the invocation of the `help` function for a command.
|
|
169
|
+
*/
|
|
170
|
+
function VirtualCommandHelpDisplay(props) {
|
|
171
|
+
const { options, segments, commands } = props;
|
|
172
|
+
const context = usePowerlines();
|
|
173
|
+
return [
|
|
174
|
+
createIntrinsic("hbr", {}),
|
|
175
|
+
code`writeLine(bold(textColors.heading.secondary("Common Options:")));`,
|
|
176
|
+
createIntrinsic("hbr", {}),
|
|
177
|
+
createComponent(HelpOptionsDisplay, { options }),
|
|
178
|
+
code`writeLine(""); `,
|
|
179
|
+
createComponent(Spacing, {}),
|
|
180
|
+
createComponent(Show, {
|
|
181
|
+
get when() {
|
|
182
|
+
return Object.keys(commands).length > 0;
|
|
183
|
+
},
|
|
184
|
+
get children() {
|
|
185
|
+
return [
|
|
186
|
+
memo(() => code`writeLine(textColors.body.tertiary("The following commands are available through the ${getAppTitle(context, true)} command-line interface:"));
|
|
187
|
+
writeLine(""); `),
|
|
188
|
+
createComponent(Spacing, {}),
|
|
189
|
+
createComponent(For, {
|
|
190
|
+
get each() {
|
|
191
|
+
return sortCommands(commands);
|
|
192
|
+
},
|
|
193
|
+
doubleHardline: true,
|
|
194
|
+
joiner: code`writeLine(""); `,
|
|
195
|
+
ender: code`writeLine(""); `,
|
|
196
|
+
children: (child) => [
|
|
197
|
+
createIntrinsic("hbr", {}),
|
|
198
|
+
memo(() => code`
|
|
199
|
+
writeLine(textColors.heading.primary(${child.icon ? `(isUnicodeSupported ? " ${child.icon} " : "") + ` : ""}\`${child.title} ${child.isVirtual ? "" : "Command"}${child.tags?.length > 0 ? ` - ${child.tags.map((tag) => `\${textColors.tags.${camelCase(tag)} ? textColors.tags.${camelCase(tag)}(inverse(" ${tag} ")) : textColors.tags.$default(inverse(" ${tag} "))}`).join(" ")}` : ""}\`));
|
|
13
200
|
writeLine("");
|
|
14
|
-
writeLine(textColors.body.tertiary(splitText(\`${
|
|
15
|
-
writeLine(""); `),
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
201
|
+
writeLine(textColors.body.tertiary(splitText(\`${formatDescription(child.description).replace(/\.+$/, "").trim()}.\`)));
|
|
202
|
+
writeLine(""); `),
|
|
203
|
+
createIntrinsic("hbr", {}),
|
|
204
|
+
createComponent(BaseHelpDisplay, {
|
|
205
|
+
command: child,
|
|
206
|
+
indent: 2,
|
|
207
|
+
filterGlobalOptions: true
|
|
208
|
+
}),
|
|
209
|
+
createIntrinsic("hbr", {})
|
|
210
|
+
]
|
|
211
|
+
}),
|
|
212
|
+
memo(() => code`help(\`Running a specific command with the help flag (via: \${inlineCode("${getAppBin(context)} ${segments && segments.length > 0 ? ` ${segments.join(" ")}` : ""} <specific command> --help")}) or the help command with the specific command as arguments (via: \${inlineCode("${getAppBin(context)} ${segments && segments.length > 0 ? ` ${segments.join(" ")}` : ""} help <specific command>")}) will provide additional information that is specific to that command.\`);
|
|
213
|
+
writeLine("");`)
|
|
214
|
+
];
|
|
215
|
+
}
|
|
216
|
+
})
|
|
217
|
+
];
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* A component that generates the invocation of the `help` function for a command.
|
|
221
|
+
*/
|
|
222
|
+
function CommandHelpDisplay(props) {
|
|
223
|
+
const { command } = props;
|
|
224
|
+
const context = usePowerlines();
|
|
225
|
+
return [
|
|
226
|
+
code`writeLine(""); `,
|
|
227
|
+
createComponent(Spacing, {}),
|
|
228
|
+
createComponent(BaseHelpDisplay, {
|
|
229
|
+
command,
|
|
230
|
+
filterGlobalOptions: false
|
|
231
|
+
}),
|
|
232
|
+
code`writeLine(""); `,
|
|
233
|
+
createComponent(Spacing, {}),
|
|
234
|
+
createComponent(Show, {
|
|
235
|
+
get when() {
|
|
236
|
+
return Object.keys(command.children).length > 0;
|
|
237
|
+
},
|
|
238
|
+
get children() {
|
|
239
|
+
return [
|
|
240
|
+
code`writeLine(textColors.body.tertiary("The following sub-commands are available:"));
|
|
241
|
+
writeLine(""); `,
|
|
242
|
+
createComponent(Spacing, {}),
|
|
243
|
+
createComponent(For, {
|
|
244
|
+
get each() {
|
|
245
|
+
return sortCommands(command.children);
|
|
246
|
+
},
|
|
247
|
+
doubleHardline: true,
|
|
248
|
+
joiner: code`writeLine(""); `,
|
|
249
|
+
ender: code`writeLine(""); `,
|
|
250
|
+
children: (child) => [
|
|
251
|
+
createIntrinsic("hbr", {}),
|
|
252
|
+
memo(() => code`
|
|
253
|
+
writeLine(textColors.heading.primary(${child.icon ? `(isUnicodeSupported ? " ${child.icon} " : "") + ` : ""}\`${child.title} ${child.isVirtual ? "" : "Command"}${child.tags?.length > 0 ? ` - ${child.tags.map((tag) => `\${textColors.tags.${camelCase(tag)} ? textColors.tags.${camelCase(tag)}(inverse(" ${tag} ")) : textColors.tags.$default(inverse(" ${tag} "))}`).join(" ")}` : ""}\`));
|
|
19
254
|
writeLine("");
|
|
20
|
-
writeLine(textColors.body.tertiary(splitText(\`${
|
|
21
|
-
writeLine(""); `),
|
|
22
|
-
|
|
255
|
+
writeLine(textColors.body.tertiary(splitText(\`${formatDescription(child.description).replace(/\.+$/, "").trim()}.\`)));
|
|
256
|
+
writeLine(""); `),
|
|
257
|
+
createIntrinsic("hbr", {}),
|
|
258
|
+
createComponent(BaseHelpDisplay, {
|
|
259
|
+
command: child,
|
|
260
|
+
indent: 2,
|
|
261
|
+
filterGlobalOptions: true
|
|
262
|
+
}),
|
|
263
|
+
createIntrinsic("hbr", {})
|
|
264
|
+
]
|
|
265
|
+
}),
|
|
266
|
+
memo(() => code`help(\`Running a specific command with the help flag (via: \${inlineCode("${getAppBin(context)} ${command.segments.join(" ")} <specific command> --help")}) will provide additional information that is specific to that command.\`);
|
|
267
|
+
writeLine("");`)
|
|
268
|
+
];
|
|
269
|
+
}
|
|
270
|
+
})
|
|
271
|
+
];
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
//#endregion
|
|
275
|
+
export { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay };
|
|
23
276
|
//# sourceMappingURL=display.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"display.mjs","names":[],"sources":["../../src/components/display.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website: https://stormsoftware.com\n Repository: https://github.com/storm-software/shell-shock\n Documentation: https://docs.stormsoftware.com/projects/shell-shock\n Contact: https://stormsoftware.com/contact\n\n SPDX-License-Identifier: Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { CommandOption, CommandTree } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport {\n formatDescription,\n formatShortDescription,\n getAppBin,\n getAppTitle,\n getDynamicPathSegmentName,\n isDynamicPathSegment,\n sortOptions\n} from \"@shell-shock/core/plugin-utils\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type { HelpPluginContext } from \"../types/plugin\";\n\nexport interface HelpUsageDisplayProps {\n /**\n * The command to generate help for.\n */\n command: CommandTree;\n\n /**\n * The padding scale to apply to the help display headings.\n *\n * @remarks\n * This value is multiplied by the theme's app padding to determine the final padding.\n *\n * @defaultValue 2\n */\n indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsageDisplay(props: HelpUsageDisplayProps) {\n const { command, indent = 2 } = props;\n\n const context = usePowerlines<HelpPluginContext>();\n const theme = useTheme();\n\n return (\n <>\n {code`\n writeLine(\n textColors.body.secondary(\\`\\${textColors.usage.bin(\"$_ ${getAppBin(\n context\n )}\")}${\n command.segments.length > 0\n ? ` ${command.segments\n .map(\n segment =>\n `\\${textColors.usage.${\n isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"\n }(\"${\n isDynamicPathSegment(segment)\n ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n : segment\n }\")}`\n )\n .join(\" \")}`\n : \"\"\n }${\n Object.values(command.children).length > 0\n ? ` \\${textColors.usage.dynamic(\"[command]\")}`\n : \"\"\n }${\n command.args.length > 0\n ? ` ${command.args\n .map(\n arg =>\n `\\${textColors.usage.args(\"<${snakeCase(\n (arg.kind === CommandParameterKinds.string ||\n arg.kind === CommandParameterKinds.number) &&\n arg.choices &&\n arg.choices.length > 0\n ? arg.choices.join(\"|\")\n : arg.kind === CommandParameterKinds.string &&\n arg.format\n ? arg.format\n : arg.name\n )}${\n (arg.kind === CommandParameterKinds.string ||\n arg.kind === CommandParameterKinds.number) &&\n arg.variadic\n ? \"...\"\n : \"\"\n }>\")}`\n )\n .join(\" \")}`\n : \"\"\n } \\${textColors.usage.options(\"[options]\")}\\`), { padding: ${\n theme.padding.app * indent\n } }\n );`}\n <hbr />\n <Show when={command.args.length > 0}>\n <hbr />\n {code`\n writeLine(\n textColors.body.secondary(\\`\\${textColors.usage.bin(\"$_ ${getAppBin(context)}\")}${\n command.segments.length > 0\n ? ` ${command.segments\n .map(\n segment =>\n `\\${textColors.usage.${\n isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"\n }(\"${\n isDynamicPathSegment(segment)\n ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n : segment\n }\")}`\n )\n .join(\" \")}`\n : \"\"\n }${\n Object.values(command.children).length > 0\n ? ` \\${textColors.usage.dynamic(\"[command]\")}`\n : \"\"\n } \\${textColors.usage.options(\"[options]\")}${\n command.args.length > 0\n ? ` ${command.args\n .map(\n arg =>\n `\\${textColors.usage.args(\"<${snakeCase(\n (arg.kind === CommandParameterKinds.string ||\n arg.kind === CommandParameterKinds.number) &&\n arg.choices &&\n arg.choices.length > 0\n ? arg.choices.join(\"|\")\n : arg.kind === CommandParameterKinds.string &&\n arg.format\n ? arg.format\n : arg.name\n )}${\n (arg.kind === CommandParameterKinds.string ||\n arg.kind === CommandParameterKinds.number) &&\n arg.variadic\n ? \"...\"\n : \"\"\n }>\")}`\n )\n .join(\" \")}`\n : \"\"\n }\\`), { padding: ${theme.padding.app * indent} }\n );`}\n <hbr />\n </Show>\n </>\n );\n}\n\nexport interface HelpOptionsDisplayProps {\n /**\n * The options to display help for.\n */\n options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptionsDisplay(props: HelpOptionsDisplayProps) {\n const { options } = props;\n\n const context = usePowerlines<HelpPluginContext>();\n\n return (\n <>\n {code`table([ `}\n <hbr />\n <For each={sortOptions(options)} hardline>\n {option => {\n const flags = [] as string[];\n const names = [] as string[];\n if (option.name.length === 1) {\n flags.push(`-${option.name}`);\n } else {\n names.push(`--${kebabCase(option.name)}`);\n }\n\n option.alias.forEach((alias: string) => {\n if (alias.length === 1) {\n flags.push(`-${alias}`);\n } else {\n names.push(`--${kebabCase(alias)}`);\n }\n });\n\n return code`[{ value: textColors.body.primary(\"${\n flags.length > 0\n ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n : \"\"\n }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n option.kind === CommandParameterKinds.string\n ? ` <${snakeCase(\n option.choices && option.choices.length > 0\n ? option.choices.join(\"|\")\n : option.format\n ? option.format\n : option.name\n )}${option.variadic ? \"...\" : \"\"}>`\n : option.kind === CommandParameterKinds.number\n ? ` <${snakeCase(\n option.choices && option.choices.length > 0\n ? option.choices.join(\"|\")\n : option.name\n )}${option.variadic ? \"...\" : \"\"}>`\n : \"\"\n }\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: textColors.body.tertiary(\\`${formatShortDescription(\n option.description,\n {\n length: 200\n }\n )\n .replace(/\\.+$/, \"\")\n .trim()}${\n option.env || option.default !== undefined\n ? ` (${\n option.env\n ? `env: ${context.config.appSpecificEnvPrefix}_${\n option.env\n }${option.default !== undefined ? \", \" : \"\"}`\n : \"\"\n }${\n option.default !== undefined\n ? `default: ${JSON.stringify(option.default).replace(\n /\"/g,\n '\\\\\"'\n )}`\n : \"\"\n })`\n : \"\"\n }.\\`), align: \"left\", border: \"none\" }], `;\n }}\n </For>\n <hbr />\n {code` ]); `}\n </>\n );\n}\n\nexport interface HelpCommandsDisplayProps {\n /**\n * A mapping of command names to their command definitions.\n */\n commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommandsDisplay(props: HelpCommandsDisplayProps) {\n const { commands } = props;\n\n return (\n <>\n {code`table([ `}\n <hbr />\n <For each={Object.values(commands)} hardline>\n {child =>\n code`[{ value: textColors.body.primary(\"${\n child.name\n }\"), align: \"right\", border: \"none\" }, { value: textColors.body.tertiary(\\`${formatShortDescription(\n child.description,\n {\n length: 200\n }\n )\n .replace(/\\.+$/, \"\")\n .trim()}.\\`), align: \"left\", border: \"none\" }], `\n }\n </For>\n <hbr />\n {code` ]); `}\n </>\n );\n}\n\nexport interface BaseHelpDisplayProps {\n /**\n * The command to generate help for.\n */\n command: CommandTree;\n\n /**\n * Whether to filter out global options from the help display.\n *\n * @remarks\n * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n *\n * @defaultValue false\n */\n filterGlobalOptions?: boolean;\n\n /**\n * The padding scale to apply to the help display headings.\n *\n * @remarks\n * This value is multiplied by the theme's app padding to determine the final padding.\n *\n * @defaultValue 1\n */\n indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function BaseHelpDisplay(props: BaseHelpDisplayProps) {\n const { command, indent = 1, filterGlobalOptions = false } = props;\n\n const theme = useTheme();\n const context = usePowerlines<HelpPluginContext>();\n\n const options = computed(() =>\n filterGlobalOptions\n ? Object.values(command.options).filter(\n option =>\n !context.globalOptions.some(\n (globalOption: CommandOption) =>\n globalOption.name === option.name ||\n option.alias.includes(globalOption.name) ||\n globalOption.alias?.includes(option.name) ||\n globalOption.alias?.some(alias => option.alias.includes(alias))\n )\n )\n : Object.values(command.options)\n );\n\n return (\n <>\n {code`writeLine(bold(textColors.heading.secondary(\"Usage:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpUsageDisplay command={command} indent={indent} />\n <Spacing />\n <Show when={options.value.length > 0}>\n {code`writeLine(\"\");\n writeLine(bold(textColors.heading.secondary(\"Options:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpOptionsDisplay options={options.value} />\n <Spacing />\n </Show>\n <Show when={Object.keys(command.children).length > 0}>\n {code`writeLine(\"\");\n writeLine(bold(textColors.heading.secondary(\"Commands:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpCommandsDisplay commands={command.children} />\n <Spacing />\n </Show>\n <Show when={isSetString(command.reference)}>\n {code`writeLine(\"\");\n writeLine(textColors.heading.tertiary(\\`More information about this command can be found in the reference documentation at \\${link(\"${\n command.reference\n }\")}\\`)${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <Spacing />\n </Show>\n </>\n );\n}\n\nexport interface VirtualCommandHelpDisplayProps {\n /**\n * The options to display help for.\n */\n options: CommandOption[];\n\n /**\n * A mapping of command names to their command definitions.\n */\n commands: Record<string, CommandTree>;\n\n /**\n * The command path to generate help for, used for generating the help invocation instructions.\n *\n * @remarks\n * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n */\n segments?: string[];\n}\n\nfunction sortCommands(commands: Record<string, CommandTree>) {\n return Object.values(commands).sort((a, b) => {\n if (\n a.tags.some(tag => tag.toLowerCase() === \"deprecated\") &&\n !b.tags.some(tag => tag.toLowerCase() === \"deprecated\")\n ) {\n return 1;\n } else if (\n !a.tags.some(tag => tag.toLowerCase() === \"deprecated\") &&\n b.tags.some(tag => tag.toLowerCase() === \"deprecated\")\n ) {\n return -1;\n } else if (\n a.tags.some(tag => tag.toLowerCase() === \"experimental\") &&\n !b.tags.some(tag => tag.toLowerCase() === \"experimental\")\n ) {\n return 1;\n } else if (\n !a.tags.some(tag => tag.toLowerCase() === \"experimental\") &&\n b.tags.some(tag => tag.toLowerCase() === \"experimental\")\n ) {\n return -1;\n } else if (\n a.tags.some(tag => tag.toLowerCase() === \"utility\") &&\n !b.tags.some(tag => tag.toLowerCase() === \"utility\")\n ) {\n return 1;\n } else if (\n !a.tags.some(tag => tag.toLowerCase() === \"utility\") &&\n b.tags.some(tag => tag.toLowerCase() === \"utility\")\n ) {\n return -1;\n }\n\n return a.name.localeCompare(b.name);\n });\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualCommandHelpDisplay(\n props: VirtualCommandHelpDisplayProps\n) {\n const { options, segments, commands } = props;\n\n const context = usePowerlines<HelpPluginContext>();\n\n return (\n <>\n <hbr />\n {code`writeLine(bold(textColors.heading.secondary(\"Common Options:\")));`}\n <hbr />\n <HelpOptionsDisplay options={options} />\n {code`writeLine(\"\"); `}\n <Spacing />\n <Show when={Object.keys(commands).length > 0}>\n {code`writeLine(textColors.body.tertiary(\"The following commands are available through the ${getAppTitle(\n context,\n true\n )} command-line interface:\"));\n writeLine(\"\"); `}\n <Spacing />\n <For\n each={sortCommands(commands)}\n doubleHardline\n joiner={code`writeLine(\"\"); `}\n ender={code`writeLine(\"\"); `}>\n {child => (\n <>\n <hbr />\n {code`\n writeLine(textColors.heading.primary(${\n child.icon\n ? `(isUnicodeSupported ? \" ${child.icon} \" : \"\") + `\n : \"\"\n }\\`${child.title} ${child.isVirtual ? \"\" : \"Command\"}${\n child.tags?.length > 0\n ? ` - ${child.tags\n .map(\n tag =>\n `\\${textColors.tags.${camelCase(tag)} ? textColors.tags.${camelCase(tag)}(inverse(\" ${tag} \")) : textColors.tags.$default(inverse(\" ${tag} \"))}`\n )\n .join(\" \")}`\n : \"\"\n }\\`));\n writeLine(\"\");\n writeLine(textColors.body.tertiary(splitText(\\`${formatDescription(\n child.description\n )\n .replace(/\\.+$/, \"\")\n .trim()}.\\`)));\n writeLine(\"\"); `}\n <hbr />\n <BaseHelpDisplay command={child} indent={2} filterGlobalOptions />\n <hbr />\n </>\n )}\n </For>\n {code`help(\\`Running a specific command with the help flag (via: \\${inlineCode(\"${getAppBin(\n context\n )} ${\n segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n } <specific command> --help\")}) or the help command with the specific command as arguments (via: \\${inlineCode(\"${getAppBin(\n context\n )} ${\n segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n } help <specific command>\")}) will provide additional information that is specific to that command.\\`);\n writeLine(\"\");`}\n </Show>\n </>\n );\n}\n\nexport interface CommandHelpDisplayProps {\n /**\n * A mapping of command names to their command definitions.\n */\n command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelpDisplay(props: CommandHelpDisplayProps) {\n const { command } = props;\n\n const context = usePowerlines<HelpPluginContext>();\n\n return (\n <>\n {code`writeLine(\"\"); `}\n <Spacing />\n <BaseHelpDisplay command={command} filterGlobalOptions={false} />\n {code`writeLine(\"\"); `}\n <Spacing />\n <Show when={Object.keys(command.children).length > 0}>\n {code`writeLine(textColors.body.tertiary(\"The following sub-commands are available:\"));\n writeLine(\"\"); `}\n <Spacing />\n <For\n each={sortCommands(command.children)}\n doubleHardline\n joiner={code`writeLine(\"\"); `}\n ender={code`writeLine(\"\"); `}>\n {child => (\n <>\n <hbr />\n {code`\n writeLine(textColors.heading.primary(${\n child.icon\n ? `(isUnicodeSupported ? \" ${child.icon} \" : \"\") + `\n : \"\"\n }\\`${child.title} ${child.isVirtual ? \"\" : \"Command\"}${\n child.tags?.length > 0\n ? ` - ${child.tags\n .map(\n tag =>\n `\\${textColors.tags.${camelCase(tag)} ? textColors.tags.${camelCase(tag)}(inverse(\" ${tag} \")) : textColors.tags.$default(inverse(\" ${tag} \"))}`\n )\n .join(\" \")}`\n : \"\"\n }\\`));\n writeLine(\"\");\n writeLine(textColors.body.tertiary(splitText(\\`${formatDescription(\n child.description\n )\n .replace(/\\.+$/, \"\")\n .trim()}.\\`)));\n writeLine(\"\"); `}\n <hbr />\n <BaseHelpDisplay command={child} indent={2} filterGlobalOptions />\n <hbr />\n </>\n )}\n </For>\n {code`help(\\`Running a specific command with the help flag (via: \\${inlineCode(\"${getAppBin(\n context\n )} ${command.segments.join(\n \" \"\n )} <specific command> --help\")}) will provide additional information that is specific to that command.\\`);\n writeLine(\"\");`}\n </Show>\n </>\n );\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"display.mjs","names":[],"sources":["../../src/components/display.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website: https://stormsoftware.com\n Repository: https://github.com/storm-software/shell-shock\n Documentation: https://docs.stormsoftware.com/projects/shell-shock\n Contact: https://stormsoftware.com/contact\n\n SPDX-License-Identifier: Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { CommandOption, CommandTree } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport {\n formatDescription,\n formatShortDescription,\n getAppBin,\n getAppTitle,\n getDynamicPathSegmentName,\n isDynamicPathSegment,\n sortOptions\n} from \"@shell-shock/core/plugin-utils\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type { HelpPluginContext } from \"../types/plugin\";\n\nexport interface HelpUsageDisplayProps {\n /**\n * The command to generate help for.\n */\n command: CommandTree;\n\n /**\n * The padding scale to apply to the help display headings.\n *\n * @remarks\n * This value is multiplied by the theme's app padding to determine the final padding.\n *\n * @defaultValue 2\n */\n indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsageDisplay(props: HelpUsageDisplayProps) {\n const { command, indent = 2 } = props;\n\n const context = usePowerlines<HelpPluginContext>();\n const theme = useTheme();\n\n return (\n <>\n {code`\n writeLine(\n textColors.body.secondary(\\`\\${textColors.usage.bin(\"$_ ${getAppBin(\n context\n )}\")}${\n command.segments.length > 0\n ? ` ${command.segments\n .map(\n segment =>\n `\\${textColors.usage.${\n isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"\n }(\"${\n isDynamicPathSegment(segment)\n ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n : segment\n }\")}`\n )\n .join(\" \")}`\n : \"\"\n }${\n Object.values(command.children).length > 0\n ? ` \\${textColors.usage.dynamic(\"[command]\")}`\n : \"\"\n }${\n command.args.length > 0\n ? ` ${command.args\n .map(\n arg =>\n `\\${textColors.usage.args(\"<${snakeCase(\n (arg.kind === CommandParameterKinds.string ||\n arg.kind === CommandParameterKinds.number) &&\n arg.choices &&\n arg.choices.length > 0\n ? arg.choices.join(\"|\")\n : arg.kind === CommandParameterKinds.string &&\n arg.format\n ? arg.format\n : arg.name\n )}${\n (arg.kind === CommandParameterKinds.string ||\n arg.kind === CommandParameterKinds.number) &&\n arg.variadic\n ? \"...\"\n : \"\"\n }>\")}`\n )\n .join(\" \")}`\n : \"\"\n } \\${textColors.usage.options(\"[options]\")}\\`), { padding: ${\n theme.padding.app * indent\n } }\n );`}\n <hbr />\n <Show when={command.args.length > 0}>\n <hbr />\n {code`\n writeLine(\n textColors.body.secondary(\\`\\${textColors.usage.bin(\"$_ ${getAppBin(context)}\")}${\n command.segments.length > 0\n ? ` ${command.segments\n .map(\n segment =>\n `\\${textColors.usage.${\n isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"\n }(\"${\n isDynamicPathSegment(segment)\n ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n : segment\n }\")}`\n )\n .join(\" \")}`\n : \"\"\n }${\n Object.values(command.children).length > 0\n ? ` \\${textColors.usage.dynamic(\"[command]\")}`\n : \"\"\n } \\${textColors.usage.options(\"[options]\")}${\n command.args.length > 0\n ? ` ${command.args\n .map(\n arg =>\n `\\${textColors.usage.args(\"<${snakeCase(\n (arg.kind === CommandParameterKinds.string ||\n arg.kind === CommandParameterKinds.number) &&\n arg.choices &&\n arg.choices.length > 0\n ? arg.choices.join(\"|\")\n : arg.kind === CommandParameterKinds.string &&\n arg.format\n ? arg.format\n : arg.name\n )}${\n (arg.kind === CommandParameterKinds.string ||\n arg.kind === CommandParameterKinds.number) &&\n arg.variadic\n ? \"...\"\n : \"\"\n }>\")}`\n )\n .join(\" \")}`\n : \"\"\n }\\`), { padding: ${theme.padding.app * indent} }\n );`}\n <hbr />\n </Show>\n </>\n );\n}\n\nexport interface HelpOptionsDisplayProps {\n /**\n * The options to display help for.\n */\n options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptionsDisplay(props: HelpOptionsDisplayProps) {\n const { options } = props;\n\n const context = usePowerlines<HelpPluginContext>();\n\n return (\n <>\n {code`table([ `}\n <hbr />\n <For each={sortOptions(options)} hardline>\n {option => {\n const flags = [] as string[];\n const names = [] as string[];\n if (option.name.length === 1) {\n flags.push(`-${option.name}`);\n } else {\n names.push(`--${kebabCase(option.name)}`);\n }\n\n option.alias.forEach((alias: string) => {\n if (alias.length === 1) {\n flags.push(`-${alias}`);\n } else {\n names.push(`--${kebabCase(alias)}`);\n }\n });\n\n return code`[{ value: textColors.body.primary(\"${\n flags.length > 0\n ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n : \"\"\n }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n option.kind === CommandParameterKinds.string\n ? ` <${snakeCase(\n option.choices && option.choices.length > 0\n ? option.choices.join(\"|\")\n : option.format\n ? option.format\n : option.name\n )}${option.variadic ? \"...\" : \"\"}>`\n : option.kind === CommandParameterKinds.number\n ? ` <${snakeCase(\n option.choices && option.choices.length > 0\n ? option.choices.join(\"|\")\n : option.name\n )}${option.variadic ? \"...\" : \"\"}>`\n : \"\"\n }\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: textColors.body.tertiary(\\`${formatShortDescription(\n option.description,\n {\n length: 200\n }\n )\n .replace(/\\.+$/, \"\")\n .trim()}${\n option.env || option.default !== undefined\n ? ` (${\n option.env\n ? `env: ${context.config.appSpecificEnvPrefix}_${\n option.env\n }${option.default !== undefined ? \", \" : \"\"}`\n : \"\"\n }${\n option.default !== undefined\n ? `default: ${JSON.stringify(option.default).replace(\n /\"/g,\n '\\\\\"'\n )}`\n : \"\"\n })`\n : \"\"\n }.\\`), align: \"left\", border: \"none\" }], `;\n }}\n </For>\n <hbr />\n {code` ]); `}\n </>\n );\n}\n\nexport interface HelpCommandsDisplayProps {\n /**\n * A mapping of command names to their command definitions.\n */\n commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommandsDisplay(props: HelpCommandsDisplayProps) {\n const { commands } = props;\n\n return (\n <>\n {code`table([ `}\n <hbr />\n <For each={Object.values(commands)} hardline>\n {child =>\n code`[{ value: textColors.body.primary(\"${\n child.name\n }\"), align: \"right\", border: \"none\" }, { value: textColors.body.tertiary(\\`${formatShortDescription(\n child.description,\n {\n length: 200\n }\n )\n .replace(/\\.+$/, \"\")\n .trim()}.\\`), align: \"left\", border: \"none\" }], `\n }\n </For>\n <hbr />\n {code` ]); `}\n </>\n );\n}\n\nexport interface BaseHelpDisplayProps {\n /**\n * The command to generate help for.\n */\n command: CommandTree;\n\n /**\n * Whether to filter out global options from the help display.\n *\n * @remarks\n * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n *\n * @defaultValue false\n */\n filterGlobalOptions?: boolean;\n\n /**\n * The padding scale to apply to the help display headings.\n *\n * @remarks\n * This value is multiplied by the theme's app padding to determine the final padding.\n *\n * @defaultValue 1\n */\n indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function BaseHelpDisplay(props: BaseHelpDisplayProps) {\n const { command, indent = 1, filterGlobalOptions = false } = props;\n\n const theme = useTheme();\n const context = usePowerlines<HelpPluginContext>();\n\n const options = computed(() =>\n filterGlobalOptions\n ? Object.values(command.options).filter(\n option =>\n !context.globalOptions.some(\n (globalOption: CommandOption) =>\n globalOption.name === option.name ||\n option.alias.includes(globalOption.name) ||\n globalOption.alias?.includes(option.name) ||\n globalOption.alias?.some(alias => option.alias.includes(alias))\n )\n )\n : Object.values(command.options)\n );\n\n return (\n <>\n {code`writeLine(bold(textColors.heading.secondary(\"Usage:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpUsageDisplay command={command} indent={indent} />\n <Spacing />\n <Show when={options.value.length > 0}>\n {code`writeLine(\"\");\n writeLine(bold(textColors.heading.secondary(\"Options:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpOptionsDisplay options={options.value} />\n <Spacing />\n </Show>\n <Show when={Object.keys(command.children).length > 0}>\n {code`writeLine(\"\");\n writeLine(bold(textColors.heading.secondary(\"Commands:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpCommandsDisplay commands={command.children} />\n <Spacing />\n </Show>\n <Show when={isSetString(command.reference)}>\n {code`writeLine(\"\");\n writeLine(textColors.heading.tertiary(\\`More information about this command can be found in the reference documentation at \\${link(\"${\n command.reference\n }\")}\\`)${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <Spacing />\n </Show>\n </>\n );\n}\n\nexport interface VirtualCommandHelpDisplayProps {\n /**\n * The options to display help for.\n */\n options: CommandOption[];\n\n /**\n * A mapping of command names to their command definitions.\n */\n commands: Record<string, CommandTree>;\n\n /**\n * The command path to generate help for, used for generating the help invocation instructions.\n *\n * @remarks\n * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n */\n segments?: string[];\n}\n\nfunction sortCommands(commands: Record<string, CommandTree>) {\n return Object.values(commands).sort((a, b) => {\n if (\n a.tags.some(tag => tag.toLowerCase() === \"deprecated\") &&\n !b.tags.some(tag => tag.toLowerCase() === \"deprecated\")\n ) {\n return 1;\n } else if (\n !a.tags.some(tag => tag.toLowerCase() === \"deprecated\") &&\n b.tags.some(tag => tag.toLowerCase() === \"deprecated\")\n ) {\n return -1;\n } else if (\n a.tags.some(tag => tag.toLowerCase() === \"experimental\") &&\n !b.tags.some(tag => tag.toLowerCase() === \"experimental\")\n ) {\n return 1;\n } else if (\n !a.tags.some(tag => tag.toLowerCase() === \"experimental\") &&\n b.tags.some(tag => tag.toLowerCase() === \"experimental\")\n ) {\n return -1;\n } else if (\n a.tags.some(tag => tag.toLowerCase() === \"utility\") &&\n !b.tags.some(tag => tag.toLowerCase() === \"utility\")\n ) {\n return 1;\n } else if (\n !a.tags.some(tag => tag.toLowerCase() === \"utility\") &&\n b.tags.some(tag => tag.toLowerCase() === \"utility\")\n ) {\n return -1;\n }\n\n return a.name.localeCompare(b.name);\n });\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualCommandHelpDisplay(\n props: VirtualCommandHelpDisplayProps\n) {\n const { options, segments, commands } = props;\n\n const context = usePowerlines<HelpPluginContext>();\n\n return (\n <>\n <hbr />\n {code`writeLine(bold(textColors.heading.secondary(\"Common Options:\")));`}\n <hbr />\n <HelpOptionsDisplay options={options} />\n {code`writeLine(\"\"); `}\n <Spacing />\n <Show when={Object.keys(commands).length > 0}>\n {code`writeLine(textColors.body.tertiary(\"The following commands are available through the ${getAppTitle(\n context,\n true\n )} command-line interface:\"));\n writeLine(\"\"); `}\n <Spacing />\n <For\n each={sortCommands(commands)}\n doubleHardline\n joiner={code`writeLine(\"\"); `}\n ender={code`writeLine(\"\"); `}>\n {child => (\n <>\n <hbr />\n {code`\n writeLine(textColors.heading.primary(${\n child.icon\n ? `(isUnicodeSupported ? \" ${child.icon} \" : \"\") + `\n : \"\"\n }\\`${child.title} ${child.isVirtual ? \"\" : \"Command\"}${\n child.tags?.length > 0\n ? ` - ${child.tags\n .map(\n tag =>\n `\\${textColors.tags.${camelCase(tag)} ? textColors.tags.${camelCase(tag)}(inverse(\" ${tag} \")) : textColors.tags.$default(inverse(\" ${tag} \"))}`\n )\n .join(\" \")}`\n : \"\"\n }\\`));\n writeLine(\"\");\n writeLine(textColors.body.tertiary(splitText(\\`${formatDescription(\n child.description\n )\n .replace(/\\.+$/, \"\")\n .trim()}.\\`)));\n writeLine(\"\"); `}\n <hbr />\n <BaseHelpDisplay command={child} indent={2} filterGlobalOptions />\n <hbr />\n </>\n )}\n </For>\n {code`help(\\`Running a specific command with the help flag (via: \\${inlineCode(\"${getAppBin(\n context\n )} ${\n segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n } <specific command> --help\")}) or the help command with the specific command as arguments (via: \\${inlineCode(\"${getAppBin(\n context\n )} ${\n segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n } help <specific command>\")}) will provide additional information that is specific to that command.\\`);\n writeLine(\"\");`}\n </Show>\n </>\n );\n}\n\nexport interface CommandHelpDisplayProps {\n /**\n * A mapping of command names to their command definitions.\n */\n command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelpDisplay(props: CommandHelpDisplayProps) {\n const { command } = props;\n\n const context = usePowerlines<HelpPluginContext>();\n\n return (\n <>\n {code`writeLine(\"\"); `}\n <Spacing />\n <BaseHelpDisplay command={command} filterGlobalOptions={false} />\n {code`writeLine(\"\"); `}\n <Spacing />\n <Show when={Object.keys(command.children).length > 0}>\n {code`writeLine(textColors.body.tertiary(\"The following sub-commands are available:\"));\n writeLine(\"\"); `}\n <Spacing />\n <For\n each={sortCommands(command.children)}\n doubleHardline\n joiner={code`writeLine(\"\"); `}\n ender={code`writeLine(\"\"); `}>\n {child => (\n <>\n <hbr />\n {code`\n writeLine(textColors.heading.primary(${\n child.icon\n ? `(isUnicodeSupported ? \" ${child.icon} \" : \"\") + `\n : \"\"\n }\\`${child.title} ${child.isVirtual ? \"\" : \"Command\"}${\n child.tags?.length > 0\n ? ` - ${child.tags\n .map(\n tag =>\n `\\${textColors.tags.${camelCase(tag)} ? textColors.tags.${camelCase(tag)}(inverse(\" ${tag} \")) : textColors.tags.$default(inverse(\" ${tag} \"))}`\n )\n .join(\" \")}`\n : \"\"\n }\\`));\n writeLine(\"\");\n writeLine(textColors.body.tertiary(splitText(\\`${formatDescription(\n child.description\n )\n .replace(/\\.+$/, \"\")\n .trim()}.\\`)));\n writeLine(\"\"); `}\n <hbr />\n <BaseHelpDisplay command={child} indent={2} filterGlobalOptions />\n <hbr />\n </>\n )}\n </For>\n {code`help(\\`Running a specific command with the help flag (via: \\${inlineCode(\"${getAppBin(\n context\n )} ${command.segments.join(\n \" \"\n )} <specific command> --help\")}) will provide additional information that is specific to that command.\\`);\n writeLine(\"\");`}\n </Show>\n </>\n );\n}\n"],"mappings":"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"}
|
|
@@ -1 +1,99 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
+
const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
|
|
3
|
+
const require_components_display = require('./display.cjs');
|
|
4
|
+
let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
|
|
5
|
+
let _alloy_js_core = require("@alloy-js/core");
|
|
6
|
+
let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
|
|
7
|
+
let defu = require("defu");
|
|
8
|
+
defu = require_runtime.__toESM(defu);
|
|
9
|
+
let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
|
|
10
|
+
let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
|
|
11
|
+
let _alloy_js_typescript = require("@alloy-js/typescript");
|
|
12
|
+
let _powerlines_plugin_alloy_typescript = require("@powerlines/plugin-alloy/typescript");
|
|
13
|
+
let _powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
|
|
14
|
+
let _stryke_path = require("@stryke/path");
|
|
15
|
+
|
|
16
|
+
//#region src/components/help-builtin.tsx
|
|
17
|
+
/**
|
|
18
|
+
* A built-in help module for Shell Shock.
|
|
19
|
+
*/
|
|
20
|
+
function HelpBuiltin(props) {
|
|
21
|
+
const [{ command, children }, rest] = (0, _alloy_js_core.splitProps)(props, ["command", "children"]);
|
|
22
|
+
const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
|
|
23
|
+
return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_builtin_file.BuiltinFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({
|
|
24
|
+
get id() {
|
|
25
|
+
return (0, _stryke_path.joinPaths)("help", ...command.segments.filter((segment) => !(0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment)));
|
|
26
|
+
},
|
|
27
|
+
get description() {
|
|
28
|
+
return (0, _alloy_js_core_jsx_runtime.memo)(() => !!command.path)() ? `A collection of utility functions that assist in displaying help information for the ${command.title} command.` : `A collection of utility functions that assist in displaying help information for the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} command-line interface application.`;
|
|
29
|
+
}
|
|
30
|
+
}, rest, {
|
|
31
|
+
get builtinImports() {
|
|
32
|
+
return (0, defu.default)(rest.builtinImports ?? {}, {
|
|
33
|
+
utils: ["isUnicodeSupported"],
|
|
34
|
+
console: [
|
|
35
|
+
"splitText",
|
|
36
|
+
"writeLine",
|
|
37
|
+
"inlineCode",
|
|
38
|
+
"textColors",
|
|
39
|
+
"inverse",
|
|
40
|
+
"bold",
|
|
41
|
+
"help",
|
|
42
|
+
"table",
|
|
43
|
+
"link"
|
|
44
|
+
]
|
|
45
|
+
});
|
|
46
|
+
},
|
|
47
|
+
get children() {
|
|
48
|
+
return [
|
|
49
|
+
(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TSDoc, {
|
|
50
|
+
get heading() {
|
|
51
|
+
return `Utility functions for displaying help information for the ${command.path ? `${command.title} command` : `${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} application`}.`;
|
|
52
|
+
},
|
|
53
|
+
get children() {
|
|
54
|
+
return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TSDocRemarks, { get children() {
|
|
55
|
+
return `This module contains utility functions that assist in displaying help information for the ${command.path ? `${command.title} command` : `${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} application`}. The main function exported by this module is the \`showHelp\` function, which can be used to display help information for the specified command or application. This function can be called from within the command's handler or from any other part of the application where help information needs to be displayed.`;
|
|
56
|
+
} });
|
|
57
|
+
}
|
|
58
|
+
}),
|
|
59
|
+
(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
|
|
60
|
+
"export": true,
|
|
61
|
+
name: "showHelp",
|
|
62
|
+
get doc() {
|
|
63
|
+
return `Display help information for the ${command.path ? `${command.title} command` : `${(0, _shell_shock_core_plugin_utils.getAppTitle)(context, true)} application`}.`;
|
|
64
|
+
},
|
|
65
|
+
get children() {
|
|
66
|
+
return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
|
|
67
|
+
get when() {
|
|
68
|
+
return !command.isVirtual;
|
|
69
|
+
},
|
|
70
|
+
get fallback() {
|
|
71
|
+
return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_display.VirtualCommandHelpDisplay, {
|
|
72
|
+
get options() {
|
|
73
|
+
return Object.values(command.options);
|
|
74
|
+
},
|
|
75
|
+
get commands() {
|
|
76
|
+
return command.children ?? {};
|
|
77
|
+
}
|
|
78
|
+
});
|
|
79
|
+
},
|
|
80
|
+
get children() {
|
|
81
|
+
return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_display.CommandHelpDisplay, { command });
|
|
82
|
+
}
|
|
83
|
+
});
|
|
84
|
+
}
|
|
85
|
+
}),
|
|
86
|
+
(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
|
|
87
|
+
(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
|
|
88
|
+
get when() {
|
|
89
|
+
return Boolean(children);
|
|
90
|
+
},
|
|
91
|
+
children
|
|
92
|
+
})
|
|
93
|
+
];
|
|
94
|
+
}
|
|
95
|
+
}));
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
//#endregion
|
|
99
|
+
exports.HelpBuiltin = HelpBuiltin;
|