@shell-shock/core 0.17.22 → 0.17.24

package/dist/contexts/options.d.cts

@@ -1,6 +1,5 @@
-import { CommandOption } from "../types/command.cjs";
+import { _ as CommandOption } from "../command-CtfR7hKM.cjs";
 import { ComponentContext } from "@alloy-js/core";
-
 //#region src/contexts/options.d.ts
 /**
  * The reflection parameter context used in template rendering.

package/dist/contexts/options.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.cts","names":[],"sources":["../../src/contexts/options.ts"],"mappings":";;;;;;AA4BA;cAAa,sBAAA,EAAwB,gBAAgB;;;AAAA;AAWrD;;;;AAAkC;iBAAlB,kBAAA;AAAA,iBAIA,eAAA,CAAgB,OAAA,EAAS,aAAA,KAAe,MAAA,SAAA,aAAA"}
+{"version":3,"file":"options.d.cts","names":[],"sources":["../../src/contexts/options.ts"],"mappings":";;;;;;cA4Ba,wBAAwB;;;;;;;;;iBAWrB;iBAIA,gBAAgB,SAAS,kBAAe,eAAA"}

package/dist/contexts/options.d.mts

@@ -1,6 +1,5 @@
-import { CommandOption } from "../types/command.mjs";
+import { _ as CommandOption } from "../command-B6KYexlV.mjs";
 import { ComponentContext } from "@alloy-js/core";
-
 //#region src/contexts/options.d.ts
 /**
  * The reflection parameter context used in template rendering.

package/dist/contexts/options.mjs

@@ -1,17 +1,13 @@
 import { createNamedContext, useContext } from "@alloy-js/core";
 import { camelCase } from "@stryke/string-format/camel-case";
 import { isSetString } from "@stryke/type-checks/is-set-string";
-import defu$1 from "defu";
+import { defu } from "defu";
 
 //#region src/contexts/options.ts
-function __assignType(fn, args) {
-	fn.__type = args;
-	return fn;
-}
 /**
 * The reflection parameter context used in template rendering.
 */
-const ExistingOptionsContext = (createNamedContext.Ω = [["&F"]], createNamedContext("ExistingOptions", []));
+const ExistingOptionsContext = createNamedContext("ExistingOptions", []);
 /**
 * Hook to access the ExistingOptions context.
 *
@@ -21,17 +17,12 @@ const ExistingOptionsContext = (createNamedContext.Ω = [["&F"]], createNamedCon
 * @returns A reactive version of the current reflection.
 */
 function useExistingOptions() {
-	return useContext.Ω = [["&F"]], useContext(ExistingOptionsContext);
+	return useContext(ExistingOptionsContext);
 }
-useExistingOptions.__type = [
-	"useExistingOptions",
-	"Hook to access the ExistingOptions context.",
-	"P\"/!?\""
-];
 function computedOptions(options) {
-	return options.reduce(__assignType((ret, option) => {
-		ret[camelCase(option.name)] ??= defu$1({ name: camelCase(option.name) }, ret[option.name] ?? {}, option);
-		if (option.type === "boolean" && !option.variadic && option.isNegativeOf) ret[camelCase(option.isNegativeOf)] = defu$1({ name: camelCase(option.isNegativeOf) }, ret[option.isNegativeOf] ?? {}, {
+	return options.reduce((ret, option) => {
+		ret[camelCase(option.name)] ??= defu({ name: camelCase(option.name) }, ret[option.name] ?? {}, option);
+		if (option.type === "boolean" && !option.variadic && option.isNegativeOf) ret[camelCase(option.isNegativeOf)] = defu({ name: camelCase(option.isNegativeOf) }, ret[option.isNegativeOf] ?? {}, {
 			...option,
 			env: isSetString(option.env) ? `NO_${option.env}` : false,
 			description: `${option.description.replace(/\.+$/, "")}. This property is the negative form of ${option.name}.`,
@@ -39,19 +30,8 @@ function computedOptions(options) {
 			default: !option.default
 		});
 		return ret;
-	}, [
-		"ret",
-		"option",
-		"",
-		"P\"2!\"2\"\"/#"
-	]), {});
+	}, {});
 }
-computedOptions.__type = [
-	"CommandOption",
-	"options",
-	"computedOptions",
-	"P\"w!F2\"\"/#"
-];
 
 //#endregion
 export { ExistingOptionsContext, computedOptions, useExistingOptions };

package/dist/contexts/power-plant.cjs

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
+let _powerlines_plugin_alloy_typescript_components_entry_file = require("@powerlines/plugin-alloy/typescript/components/entry-file");
+
+Object.defineProperty(exports, 'BuiltinFile', {
+  enumerable: true,
+  get: function () {
+    return _powerlines_plugin_alloy_typescript_components_builtin_file.BuiltinFile;
+  }
+});
+Object.defineProperty(exports, 'EntryFile', {
+  enumerable: true,
+  get: function () {
+    return _powerlines_plugin_alloy_typescript_components_entry_file.EntryFile;
+  }
+});
+exports.usePowerlines = _powerlines_plugin_alloy_core_contexts_context.usePowerlines;
+exports.usePowerlinesSafe = _powerlines_plugin_alloy_core_contexts_context.usePowerlinesSafe;

package/dist/contexts/power-plant.d.cts

@@ -0,0 +1,2 @@
+import { a as usePowerlines, i as EntryFileProps, n as BuiltinFileProps, o as usePowerlinesSafe, r as EntryFile, t as BuiltinFile } from "../power-plant-LgxcvlMN.cjs";
+export { BuiltinFile, type BuiltinFileProps, EntryFile, type EntryFileProps, usePowerlines, usePowerlinesSafe };

package/dist/contexts/power-plant.d.mts

@@ -0,0 +1,2 @@
+import { a as usePowerlines, i as EntryFileProps, n as BuiltinFileProps, o as usePowerlinesSafe, r as EntryFile, t as BuiltinFile } from "../power-plant-LgxcvlMN.mjs";
+export { BuiltinFile, type BuiltinFileProps, EntryFile, type EntryFileProps, usePowerlines, usePowerlinesSafe };

package/dist/contexts/power-plant.mjs

@@ -0,0 +1,5 @@
+import { usePowerlines, usePowerlinesSafe } from "@powerlines/plugin-alloy/core/contexts/context";
+import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
+
+export { BuiltinFile, EntryFile, usePowerlines, usePowerlinesSafe };

package/dist/docs-C6ZvsVMu.cjs

@@ -0,0 +1,278 @@
+const require_contexts_command = require('./contexts/command.cjs');
+require('./contexts/power-plant.cjs');
+const require_context_helpers = require('./context-helpers-_wUuFRB8.cjs');
+const require_reflect = require('./reflect-CSiffeL9.cjs');
+const require_components_usage = require('./components/usage.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let defu = require("defu");
+let _alloy_js_markdown = require("@alloy-js/markdown");
+let _power_plant_alloy_js_core_components_spacing = require("@power-plant/alloy-js/core/components/spacing");
+let _power_plant_alloy_js_markdown_components_markdown_file = require("@power-plant/alloy-js/markdown/components/markdown-file");
+let _power_plant_alloy_js_markdown_components_markdown_table = require("@power-plant/alloy-js/markdown/components/markdown-table");
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_string_format_list = require("@stryke/string-format/list");
+let _stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
+let powerlines_plugin_utils = require("powerlines/plugin-utils");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+
+//#region src/helpers/docs-helpers.ts
+/**
+* Gets the output path for the generated documentation.
+*
+* @param context - The Shell Shock context.
+* @returns The output path for the generated documentation.
+*/
+function getDocsOutputPath(context) {
+	return (0, _stryke_path_join.joinPaths)((0, powerlines_plugin_utils.getDocsOutputPath)(context.config.root), "cli");
+}
+
+//#endregion
+//#region src/components/docs.tsx
+/**
+* Generates the arguments markdown documentation for a command.
+*/
+function CommandArgumentDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return _alloy_js_core.code`This command does not have any arguments.`;
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_markdown_components_markdown_table.MarkdownTable, { get data() {
+		return require_reflect.sortOptions(Object.values(command.options)).reduce((ret, option) => {
+			ret.push({
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: (0, _stryke_type_checks_is_undefined.isUndefined)(option.default) ? "" : JSON.stringify(option.default),
+				required: !option.required || option.default ? "" : "✔"
+			});
+			return ret;
+		}, []);
+	} });
+}
+/**
+* Generates the options markdown documentation for a command.
+*/
+function CommandOptionsDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return _alloy_js_core.code`This command does not have any options.`;
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_markdown_components_markdown_table.MarkdownTable, { get data() {
+		return require_reflect.sortOptions(Object.values(command.options)).reduce((ret, option) => {
+			ret.push({
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: (0, _stryke_type_checks_is_undefined.isUndefined)(option.default) ? "" : JSON.stringify(option.default),
+				required: !option.required || option.default ? "" : "✔"
+			});
+			return ret;
+		}, []);
+	} });
+}
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocsUsageExample(props) {
+	const { packageManager = "npm", command, expand = false } = props;
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			when: expand,
+			fallback: _alloy_js_core.code`\`\`\`sh `,
+			get children() {
+				return [
+					_alloy_js_core.code`<details>
+        <summary>Using ${packageManager}:</summary>`,
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					_alloy_js_core.code`\`\`\`sh `
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_usage.Usage, {
+			command,
+			get bin() {
+				return require_context_helpers.getAppBin(context);
+			},
+			packageManager
+		}),
+		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			when: expand,
+			fallback: _alloy_js_core.code`\`\`\` `,
+			get children() {
+				return [
+					_alloy_js_core.code`\`\`\``,
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					_alloy_js_core.code`</details>`
+				];
+			}
+		})
+	];
+}
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocs(props) {
+	const { levelOffset = 0, command, usageExamples } = props;
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 1 + levelOffset,
+			get children() {
+				return `${command.title}${command.tags.includes("deprecated") ? " (Deprecated)" : command.tags.includes("beta") ? " (Beta)" : command.tags.includes("alpha") ? " (Alpha)" : command.tags.includes("experimental") ? " (Experimental)" : ""}`;
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`${command.description}`),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return command.alias && command.alias.length > 0;
+			},
+			get children() {
+				return [(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+					get when() {
+						return command.alias.length > 1;
+					},
+					get fallback() {
+						return _alloy_js_core.code`The \`${command.name}\` command can also be invoked using the alias \`${command.alias[0]}\`.`;
+					},
+					get children() {
+						return _alloy_js_core.code`The \`${command.name}\` command can also be invoked using the following aliases: ${(0, _stryke_string_format_list.list)(command.alias.map((alias) => `\`${alias}\``), { conjunction: "or" })}.`;
+					}
+				})];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 2 + levelOffset,
+			children: "Usage"
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The \`${command.name}\` command can be executed using the following syntax: `),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return usageExamples && usageExamples.length > 0;
+			},
+			get fallback() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocsUsageExample, {
+					packageManager: "npm",
+					command
+				});
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+					each: usageExamples,
+					doubleHardline: true,
+					children: (packageManager) => (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocsUsageExample, {
+						packageManager,
+						command,
+						get expand() {
+							return usageExamples && usageExamples.length > 1;
+						}
+					})
+				});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return command.args.length > 0;
+			},
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+						level: 2 + levelOffset,
+						children: "Positional Arguments"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following positional arguments are available for the \`${command.name}\` command:`),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(CommandArgumentDocs, { command }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {})
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			level: 2 + levelOffset,
+			children: "Options"
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following options are available for the \`${command.name}\` command:`),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(CommandOptionsDocs, { command }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {})
+	];
+}
+/**
+* Generates the markdown documentation file for a command.
+*/
+function CommandDocsFile(props) {
+	const { levelOffset = 0, command, frontMatter, ...rest } = props;
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	const usageExamples = (0, _alloy_js_core.memo)(() => [
+		"npm",
+		"yarn",
+		"pnpm",
+		"bun"
+	]);
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_contexts_command.CommandContext.Provider, {
+		value: command,
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_markdown_components_markdown_file.MarkdownFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({ get path() {
+				return (0, _stryke_path_join.joinPaths)(getDocsOutputPath(context), `${command.path}.md`);
+			} }, rest, {
+				get frontMatter() {
+					return (0, defu.defu)(frontMatter ?? {}, {
+						id: command.id,
+						name: command.name,
+						path: command.path,
+						reference: command.docs,
+						virtual: command.virtual,
+						title: command.title,
+						description: command.description,
+						tags: command.tags
+					});
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(CommandDocs, {
+						levelOffset,
+						command,
+						get usageExamples() {
+							return usageExamples();
+						}
+					});
+				}
+			}));
+		}
+	});
+}
+
+//#endregion
+Object.defineProperty(exports, 'CommandArgumentDocs', {
+  enumerable: true,
+  get: function () {
+    return CommandArgumentDocs;
+  }
+});
+Object.defineProperty(exports, 'CommandDocs', {
+  enumerable: true,
+  get: function () {
+    return CommandDocs;
+  }
+});
+Object.defineProperty(exports, 'CommandDocsFile', {
+  enumerable: true,
+  get: function () {
+    return CommandDocsFile;
+  }
+});
+Object.defineProperty(exports, 'CommandDocsUsageExample', {
+  enumerable: true,
+  get: function () {
+    return CommandDocsUsageExample;
+  }
+});
+Object.defineProperty(exports, 'CommandOptionsDocs', {
+  enumerable: true,
+  get: function () {
+    return CommandOptionsDocs;
+  }
+});

package/dist/docs-CGQ2HtEY.mjs

@@ -0,0 +1,249 @@
+import { CommandContext } from "./contexts/command.mjs";
+import { usePowerlines } from "./contexts/power-plant.mjs";
+import { t as getAppBin } from "./context-helpers-D3EJxwbq.mjs";
+import { t as sortOptions } from "./reflect-DXKSFgvS.mjs";
+import { Usage } from "./components/usage.mjs";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { For, Show, code, memo as memo$1 } from "@alloy-js/core";
+import { defu } from "defu";
+import { Heading } from "@alloy-js/markdown";
+import { Spacing } from "@power-plant/alloy-js/core/components/spacing";
+import { MarkdownFile } from "@power-plant/alloy-js/markdown/components/markdown-file";
+import { MarkdownTable } from "@power-plant/alloy-js/markdown/components/markdown-table";
+import { joinPaths } from "@stryke/path/join";
+import { list } from "@stryke/string-format/list";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
+import { getDocsOutputPath } from "powerlines/plugin-utils";
+
+//#region src/helpers/docs-helpers.ts
+/**
+* Gets the output path for the generated documentation.
+*
+* @param context - The Shell Shock context.
+* @returns The output path for the generated documentation.
+*/
+function getDocsOutputPath$1(context) {
+	return joinPaths(getDocsOutputPath(context.config.root), "cli");
+}
+
+//#endregion
+//#region src/components/docs.tsx
+/**
+* Generates the arguments markdown documentation for a command.
+*/
+function CommandArgumentDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return code`This command does not have any arguments.`;
+	return createComponent(MarkdownTable, { get data() {
+		return sortOptions(Object.values(command.options)).reduce((ret, option) => {
+			ret.push({
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: isUndefined(option.default) ? "" : JSON.stringify(option.default),
+				required: !option.required || option.default ? "" : "✔"
+			});
+			return ret;
+		}, []);
+	} });
+}
+/**
+* Generates the options markdown documentation for a command.
+*/
+function CommandOptionsDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return code`This command does not have any options.`;
+	return createComponent(MarkdownTable, { get data() {
+		return sortOptions(Object.values(command.options)).reduce((ret, option) => {
+			ret.push({
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: isUndefined(option.default) ? "" : JSON.stringify(option.default),
+				required: !option.required || option.default ? "" : "✔"
+			});
+			return ret;
+		}, []);
+	} });
+}
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocsUsageExample(props) {
+	const { packageManager = "npm", command, expand = false } = props;
+	const context = usePowerlines();
+	return [
+		createComponent(Show, {
+			when: expand,
+			fallback: code`\`\`\`sh `,
+			get children() {
+				return [
+					code`<details>
+        <summary>Using ${packageManager}:</summary>`,
+					createComponent(Spacing, {}),
+					code`\`\`\`sh `
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		createComponent(Usage, {
+			command,
+			get bin() {
+				return getAppBin(context);
+			},
+			packageManager
+		}),
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			when: expand,
+			fallback: code`\`\`\` `,
+			get children() {
+				return [
+					code`\`\`\``,
+					createComponent(Spacing, {}),
+					code`</details>`
+				];
+			}
+		})
+	];
+}
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocs(props) {
+	const { levelOffset = 0, command, usageExamples } = props;
+	return [
+		createComponent(Heading, {
+			level: 1 + levelOffset,
+			get children() {
+				return `${command.title}${command.tags.includes("deprecated") ? " (Deprecated)" : command.tags.includes("beta") ? " (Beta)" : command.tags.includes("alpha") ? " (Alpha)" : command.tags.includes("experimental") ? " (Experimental)" : ""}`;
+			}
+		}),
+		createComponent(Spacing, {}),
+		memo(() => code`${command.description}`),
+		createComponent(Show, {
+			get when() {
+				return command.alias && command.alias.length > 0;
+			},
+			get children() {
+				return [createComponent(Spacing, {}), createComponent(Show, {
+					get when() {
+						return command.alias.length > 1;
+					},
+					get fallback() {
+						return code`The \`${command.name}\` command can also be invoked using the alias \`${command.alias[0]}\`.`;
+					},
+					get children() {
+						return code`The \`${command.name}\` command can also be invoked using the following aliases: ${list(command.alias.map((alias) => `\`${alias}\``), { conjunction: "or" })}.`;
+					}
+				})];
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(Heading, {
+			level: 2 + levelOffset,
+			children: "Usage"
+		}),
+		createComponent(Spacing, {}),
+		memo(() => code`The \`${command.name}\` command can be executed using the following syntax: `),
+		createComponent(Spacing, {}),
+		createComponent(Show, {
+			get when() {
+				return usageExamples && usageExamples.length > 0;
+			},
+			get fallback() {
+				return createComponent(CommandDocsUsageExample, {
+					packageManager: "npm",
+					command
+				});
+			},
+			get children() {
+				return createComponent(For, {
+					each: usageExamples,
+					doubleHardline: true,
+					children: (packageManager) => createComponent(CommandDocsUsageExample, {
+						packageManager,
+						command,
+						get expand() {
+							return usageExamples && usageExamples.length > 1;
+						}
+					})
+				});
+			}
+		}),
+		createComponent(Spacing, {}),
+		createComponent(Show, {
+			get when() {
+				return command.args.length > 0;
+			},
+			get children() {
+				return [
+					createComponent(Spacing, {}),
+					createComponent(Heading, {
+						level: 2 + levelOffset,
+						children: "Positional Arguments"
+					}),
+					createComponent(Spacing, {}),
+					memo(() => code`The following positional arguments are available for the \`${command.name}\` command:`),
+					createComponent(Spacing, {}),
+					createComponent(CommandArgumentDocs, { command }),
+					createComponent(Spacing, {})
+				];
+			}
+		}),
+		createComponent(Heading, {
+			level: 2 + levelOffset,
+			children: "Options"
+		}),
+		createComponent(Spacing, {}),
+		memo(() => code`The following options are available for the \`${command.name}\` command:`),
+		createComponent(Spacing, {}),
+		createComponent(CommandOptionsDocs, { command }),
+		createComponent(Spacing, {})
+	];
+}
+/**
+* Generates the markdown documentation file for a command.
+*/
+function CommandDocsFile(props) {
+	const { levelOffset = 0, command, frontMatter, ...rest } = props;
+	const context = usePowerlines();
+	const usageExamples = memo$1(() => [
+		"npm",
+		"yarn",
+		"pnpm",
+		"bun"
+	]);
+	return createComponent(CommandContext.Provider, {
+		value: command,
+		get children() {
+			return createComponent(MarkdownFile, mergeProps({ get path() {
+				return joinPaths(getDocsOutputPath$1(context), `${command.path}.md`);
+			} }, rest, {
+				get frontMatter() {
+					return defu(frontMatter ?? {}, {
+						id: command.id,
+						name: command.name,
+						path: command.path,
+						reference: command.docs,
+						virtual: command.virtual,
+						title: command.title,
+						description: command.description,
+						tags: command.tags
+					});
+				},
+				get children() {
+					return createComponent(CommandDocs, {
+						levelOffset,
+						command,
+						get usageExamples() {
+							return usageExamples();
+						}
+					});
+				}
+			}));
+		}
+	});
+}
+
+//#endregion
+export { CommandOptionsDocs as a, CommandDocsUsageExample as i, CommandDocs as n, CommandDocsFile as r, CommandArgumentDocs as t };
+//# sourceMappingURL=docs-CGQ2HtEY.mjs.map

package/dist/docs-CGQ2HtEY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-CGQ2HtEY.mjs","names":[],"sources":[],"mappings":""}