@shell-shock/plugin-help 0.2.25 → 0.2.26

package/dist/components/help-builtin.mjs

@@ -1,97 +1,2 @@
-import { CommandHelpDisplay, VirtualCommandHelpDisplay } from "./display.mjs";
-import { createComponent, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { Show, splitProps } from "@alloy-js/core";
-import { getAppTitle, isDynamicPathSegment } from "@shell-shock/core/plugin-utils";
-import defu from "defu";
-import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
-import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { FunctionDeclaration } from "@alloy-js/typescript";
-import { TSDoc, TSDocRemarks } from "@powerlines/plugin-alloy/typescript";
-import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
-import { joinPaths } from "@stryke/path";
-
-//#region src/components/help-builtin.tsx
-/**
-* A built-in help module for Shell Shock.
-*/
-function HelpBuiltin(props) {
-	const [{ command, children }, rest] = splitProps(props, ["command", "children"]);
-	const context = usePowerlines();
-	return createComponent(BuiltinFile, mergeProps({
-		get id() {
-			return joinPaths("help", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)));
-		},
-		get description() {
-			return 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 ${getAppTitle(context, true)} command-line interface application.`;
-		}
-	}, rest, {
-		get builtinImports() {
-			return defu(rest.builtinImports ?? {}, {
-				utils: ["isUnicodeSupported"],
-				console: [
-					"splitText",
-					"writeLine",
-					"inlineCode",
-					"textColors",
-					"inverse",
-					"bold",
-					"help",
-					"table",
-					"link"
-				]
-			});
-		},
-		get children() {
-			return [
-				createComponent(TSDoc, {
-					get heading() {
-						return `Utility functions for displaying help information for the ${command.path ? `${command.title} command` : `${getAppTitle(context, true)} application`}.`;
-					},
-					get children() {
-						return createComponent(TSDocRemarks, { get children() {
-							return `This module contains utility functions that assist in displaying help information for the ${command.path ? `${command.title} command` : `${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.`;
-						} });
-					}
-				}),
-				createComponent(FunctionDeclaration, {
-					"export": true,
-					name: "showHelp",
-					get doc() {
-						return `Display help information for the ${command.path ? `${command.title} command` : `${getAppTitle(context, true)} application`}.`;
-					},
-					get children() {
-						return createComponent(Show, {
-							get when() {
-								return !command.isVirtual;
-							},
-							get fallback() {
-								return createComponent(VirtualCommandHelpDisplay, {
-									get options() {
-										return Object.values(command.options);
-									},
-									get commands() {
-										return command.children ?? {};
-									}
-								});
-							},
-							get children() {
-								return createComponent(CommandHelpDisplay, { command });
-							}
-						});
-					}
-				}),
-				createComponent(Spacing, {}),
-				createComponent(Show, {
-					get when() {
-						return Boolean(children);
-					},
-					children
-				})
-			];
-		}
-	}));
-}
-
-//#endregion
-export { HelpBuiltin };
+import{CommandHelpDisplay as e,VirtualCommandHelpDisplay as t}from"./display.mjs";import{createComponent as n,memo as r,mergeProps as i}from"@alloy-js/core/jsx-runtime";import{Show as a,splitProps as o}from"@alloy-js/core";import{getAppTitle as s,isDynamicPathSegment as c}from"@shell-shock/core/plugin-utils";import l from"defu";import{Spacing as u}from"@powerlines/plugin-alloy/core/components/spacing";import{usePowerlines as d}from"@powerlines/plugin-alloy/core/contexts/context";import{FunctionDeclaration as f}from"@alloy-js/typescript";import{TSDoc as p,TSDocRemarks as m}from"@powerlines/plugin-alloy/typescript";import{BuiltinFile as h}from"@powerlines/plugin-alloy/typescript/components/builtin-file";import{joinPaths as g}from"@stryke/path";function _(_){let[{command:v,children:y},b]=o(_,[`command`,`children`]),x=d();return n(h,i({get id(){return g(`help`,...v.segments.filter(e=>!c(e)))},get description(){return r(()=>!!v.path)()?`A collection of utility functions that assist in displaying help information for the ${v.title} command.`:`A collection of utility functions that assist in displaying help information for the ${s(x,!0)} command-line interface application.`}},b,{get builtinImports(){return l(b.builtinImports??{},{utils:[`isUnicodeSupported`],console:[`splitText`,`writeLine`,`inlineCode`,`textColors`,`inverse`,`bold`,`help`,`table`,`link`]})},get children(){return[n(p,{get heading(){return`Utility functions for displaying help information for the ${v.path?`${v.title} command`:`${s(x,!0)} application`}.`},get children(){return n(m,{get children(){return`This module contains utility functions that assist in displaying help information for the ${v.path?`${v.title} command`:`${s(x,!0)} 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.`}})}}),n(f,{export:!0,name:`showHelp`,get doc(){return`Display help information for the ${v.path?`${v.title} command`:`${s(x,!0)} application`}.`},get children(){return n(a,{get when(){return!v.isVirtual},get fallback(){return n(t,{get options(){return Object.values(v.options)},get commands(){return v.children??{}}})},get children(){return n(e,{command:v})}})}}),n(u,{}),n(a,{get when(){return!!y},children:y})]}}))}export{_ as HelpBuiltin};
 //# sourceMappingURL=help-builtin.mjs.map

package/dist/components/help-builtin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"help-builtin.mjs","names":[],"sources":["../../src/components/help-builtin.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 { Show, splitProps } from \"@alloy-js/core\";\nimport { FunctionDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { TSDoc, TSDocRemarks } from \"@powerlines/plugin-alloy/typescript\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport {\n  getAppTitle,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { joinPaths } from \"@stryke/path\";\nimport defu from \"defu\";\nimport type { HelpPluginContext } from \"../types\";\nimport { CommandHelpDisplay, VirtualCommandHelpDisplay } from \"./display\";\n\nexport interface HelpBuiltinProps extends Omit<\n  BuiltinFileProps,\n  \"id\" | \"description\"\n> {\n  /**\n   * The command to generate the `help` function declaration for.\n   */\n  command: CommandTree;\n}\n\n/**\n * A built-in help module for Shell Shock.\n */\nexport function HelpBuiltin(props: HelpBuiltinProps) {\n  const [{ command, children }, rest] = splitProps(props, [\n    \"command\",\n    \"children\"\n  ]);\n  const context = usePowerlines<HelpPluginContext>();\n\n  return (\n    <BuiltinFile\n      id={joinPaths(\n        \"help\",\n        ...command.segments.filter(segment => !isDynamicPathSegment(segment))\n      )}\n      description={\n        command.path\n          ? `A collection of utility functions that assist in displaying help information for the ${\n              command.title\n            } command.`\n          : `A collection of utility functions that assist in displaying help information for the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application.`\n      }\n      {...rest}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        utils: [\"isUnicodeSupported\"],\n        console: [\n          \"splitText\",\n          \"writeLine\",\n          \"inlineCode\",\n          \"textColors\",\n          \"inverse\",\n          \"bold\",\n          \"help\",\n          \"table\",\n          \"link\"\n        ]\n      })}>\n      <TSDoc\n        heading={`Utility functions for displaying help information for the ${\n          command.path\n            ? `${command.title} command`\n            : `${getAppTitle(context, true)} application`\n        }.`}>\n        <TSDocRemarks>\n          {`This module contains utility functions that assist in displaying help information for the ${\n            command.path\n              ? `${command.title} command`\n              : `${getAppTitle(context, true)} application`\n          }. 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.`}\n        </TSDocRemarks>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"showHelp\"\n        doc={`Display help information for the ${\n          command.path\n            ? `${command.title} command`\n            : `${getAppTitle(context, true)} application`\n        }.`}>\n        <Show\n          when={!command.isVirtual}\n          fallback={\n            <VirtualCommandHelpDisplay\n              options={Object.values(command.options)}\n              commands={command.children ?? {}}\n            />\n          }>\n          <CommandHelpDisplay command={command} />\n        </Show>\n      </FunctionDeclaration>\n      <Spacing />\n      <Show when={Boolean(children)}>{children}</Show>\n    </BuiltinFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA0CA,SAAW,YAAW,OAAA;CACtB,MAAA,CAAA,WAEE,YACG,QAAQ,WAAM,OAAW,CAAA,WAAW,WAAA,CAAA;CACvC,MAAA,UAAA,eAAA;AACF,QAAO,gBAAoB,aAAQ,WAAkB;EACnD,IAAM,KAAG;AACN,UAAQ,UAAA,QAAA,GAAA,QAAA,SAAA,QAAA,YAAA,CAAA,qBAAA,QAAA,CAAA,CAAA;;EAET,IAAA,cAAA;AACF,UAAM,WAAU,CAAA,CAAA,QAAc,KAAA,EAAA,GAAA,wFAAoB,QAAA,MAAA,aAAA,wFAAA,YAAA,SAAA,KAAA,CAAA;;EAElD,EAAA,MAAO;EACL,IAAC,iBAAA;AACC,UAAI,KAAA,KAAS,kBAAA,EAAA,EAAA;IACX,OAAM,CAAA,qBAAA;IACN,SAAG;KAAO;KAAU;KAAgB;KAAG;KAAqB;KAAQ;KAAA;KAAA;KAAA;KAAA;IACrE,CAAA;;EAEH,IAAI,WAAQ;AACV,UAAO;IAAC,gBAAe,OAAQ;KAC7B,IAAI,UAAU;AACZ,aAAI,6DAAQ,QAAA,OAAA,GAAA,QAAA,MAAA,YAAA,GAAA,YAAA,SAAA,KAAA,CAAA,cAAA;;KAEd,IAAI,WAAS;AACX,aAAI,gBAAA,cAAA,EACF,IAAG,WAAY;AACrB,cAAA,6FAAA,QAAA,OAAA,GAAA,QAAA,MAAA,YAAA,GAAA,YAAA,SAAA,KAAA,CAAA,cAAA;SAEA,CAAA;;KAEC,CAAC;IAAA,gBAAS,qBAAA;KACT,UAAG;KACH,MAAG;KACH,IAAG,MAAA;AACD,aAAC,oCAAW,QAAA,OAAA,GAAA,QAAA,MAAA,YAAA,GAAA,YAAA,SAAA,KAAA,CAAA,cAAA;;KAEd,IAAG,WAAK;AACN,aAAM,gBAAA,MAAA;OACL,IAAK,OAAC;AACN,eAAI,CAAA,QAAA;;OAEN,IAAA,WAAA;AACF,eAAA,gBAAA,2BAAA;SACS,IAAE,UAAQ;AACR,iBAAA,OAAA,OAAA,QAAA,QAAA;;SAEF,IAAC,WAAY;AACjB,iBAAA,QAAA,YAAA,EAAA;;SAEA,CAAI;;OAEJ,IAAI,WAAW;AACb,eAAK,gBAAoB,oBAAmB,EACpC,SACZ,CAAA;;OAEH,CAAA;;KAEA,CAAC;IAAA,gBAAc,SAAA,EAAA,CAAA;IAAA,gBAAA,MAAA;KACd,IAAI,OAAE;AACJ,aAAO,QAAC,SAAA;;KAED;KACV,CAAC;IAAC;;EAEN,CAAC,CAAC"}
+{"version":3,"file":"help-builtin.mjs","names":[],"sources":["../../src/components/help-builtin.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 { Show, splitProps } from \"@alloy-js/core\";\nimport { FunctionDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { TSDoc, TSDocRemarks } from \"@powerlines/plugin-alloy/typescript\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport {\n  getAppTitle,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { joinPaths } from \"@stryke/path\";\nimport defu from \"defu\";\nimport type { HelpPluginContext } from \"../types\";\nimport { CommandHelpDisplay, VirtualCommandHelpDisplay } from \"./display\";\n\nexport interface HelpBuiltinProps extends Omit<\n  BuiltinFileProps,\n  \"id\" | \"description\"\n> {\n  /**\n   * The command to generate the `help` function declaration for.\n   */\n  command: CommandTree;\n}\n\n/**\n * A built-in help module for Shell Shock.\n */\nexport function HelpBuiltin(props: HelpBuiltinProps) {\n  const [{ command, children }, rest] = splitProps(props, [\n    \"command\",\n    \"children\"\n  ]);\n  const context = usePowerlines<HelpPluginContext>();\n\n  return (\n    <BuiltinFile\n      id={joinPaths(\n        \"help\",\n        ...command.segments.filter(segment => !isDynamicPathSegment(segment))\n      )}\n      description={\n        command.path\n          ? `A collection of utility functions that assist in displaying help information for the ${\n              command.title\n            } command.`\n          : `A collection of utility functions that assist in displaying help information for the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application.`\n      }\n      {...rest}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        utils: [\"isUnicodeSupported\"],\n        console: [\n          \"splitText\",\n          \"writeLine\",\n          \"inlineCode\",\n          \"textColors\",\n          \"inverse\",\n          \"bold\",\n          \"help\",\n          \"table\",\n          \"link\"\n        ]\n      })}>\n      <TSDoc\n        heading={`Utility functions for displaying help information for the ${\n          command.path\n            ? `${command.title} command`\n            : `${getAppTitle(context, true)} application`\n        }.`}>\n        <TSDocRemarks>\n          {`This module contains utility functions that assist in displaying help information for the ${\n            command.path\n              ? `${command.title} command`\n              : `${getAppTitle(context, true)} application`\n          }. 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.`}\n        </TSDocRemarks>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"showHelp\"\n        doc={`Display help information for the ${\n          command.path\n            ? `${command.title} command`\n            : `${getAppTitle(context, true)} application`\n        }.`}>\n        <Show\n          when={!command.isVirtual}\n          fallback={\n            <VirtualCommandHelpDisplay\n              options={Object.values(command.options)}\n              commands={command.children ?? {}}\n            />\n          }>\n          <CommandHelpDisplay command={command} />\n        </Show>\n      </FunctionDeclaration>\n      <Spacing />\n      <Show when={Boolean(children)}>{children}</Show>\n    </BuiltinFile>\n  );\n}\n"],"mappings":"gvBAgCA,SAAc,EAAA,EAAoB,CAClC,GAAQ,CAAC,CAAA,UAET,YACE,GAAA,EAAgB,EAAA,CAAA,UAAA,WAAA,CAAA,CACV,EAAE,GAAW,CACnB,OAAA,EAAA,EAAA,EAAA,CACE,IAAA,IAAA,CACC,OAAI,EAAW,OAAS,GAAK,EAAM,SAAS,OAAA,GAAe,CAAA,EAAA,EAAA,CAAA,CAAA,EAE9D,IAAA,aAAoB,CACtB,OAAA,MAAA,CAAA,CAAA,EAAA,KAAA,EAAA,CAAA,wFAAA,EAAA,MAAA,WAAA,wFAAA,EAAA,EAAA,GAAA,CAAA,uCAEE,CAAA,EAAA,CACE,IAAC,gBAAoB,CACvB,OAAA,EAAA,EAAA,gBAAA,EAAA,CAAA,CACK,MAAQ,CAAC,qBAAmB,CAC3B,QAAG,CAAO,YAAa,YAAS,aAAkB,aAAA,UAAA,OAAA,OAAA,QAAA,OAAA,CACrD,CAAA,EAED,IAAA,UAAA,CACF,MAAM,CAAA,EAAwB,EAAA,eAEvB,MAAA,6DAAA,EAAA,KAAA,GAAA,EAAA,MAAA,UAAA,GAAA,EAAA,EAAA,GAAA,CAAA,cAAA,IAED,IAAE,UAAS,CACV,OAAK,EAAA,EAAA,CACH,IAAA,UAAgB,CACpB,MAAA,6FAAA,EAAA,KAAA,GAAA,EAAA,MAAA,UAAA,GAAA,EAAA,EAAA,GAAA,CAAA,cAAA,0TAEC,CAAA,EAED,CAAC,CAAE,EAAY,EAAA,CACd,OAAM,GACN,KAAM,WACN,IAAI,KAAE,CACJ,MAAI,oCAAA,EAAA,KAAA,GAAA,EAAA,MAAA,UAAA,GAAA,EAAA,EAAA,GAAA,CAAA,cAAA,IAER,IAAA,UAAA,CACI,OAAI,EAAA,EAAA,CACR,IAAA,MAAgB,CACR,MAAG,CAAA,EAAA,WAEN,IAAA,UAAU,CACV,OAAU,EAAA,EAAA,CACV,IAAA,SAAW,CACX,OAAW,OAAA,OAAA,EAAA,QAAA,EAEN,IAAA,UAAA,CACA,OAAA,EAAA,UAAA,EAAA,EAED,CAAA,EAEN,IAAA,UAAA,CACF,OAAA,EAAA,EAAA,CACkB,UACf,CAAA,EAEC,CAAC,EAEL,CAAC,CAAC,EAAY,EAAA,EAAA,CAAA,CAAA,EAAA,EAAA,CACb,IAAI,MAAK,CACP,MAAE,EAAQ,GAEF,WACX,CAAC,CAAC,EAEN,CAAC,CAAC"}

package/dist/components/help-command.cjs

@@ -1,152 +1 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let _alloy_js_core = require("@alloy-js/core");
-let _powerlines_plugin_alloy_core_components = require("@powerlines/plugin-alloy/core/components");
-let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
-let _alloy_js_typescript = require("@alloy-js/typescript");
-let _powerlines_plugin_alloy_typescript = require("@powerlines/plugin-alloy/typescript");
-let _stryke_path = require("@stryke/path");
-let _powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
-let _stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
-
-//#region src/components/help-command.tsx
-/**
-* A temporary placeholder component for the help command. The actual content of this component will be rendered in the `prepare` step of the help plugin, after the command list has been fully resolved. This is necessary to ensure that the help command's entry file is generated, and to avoid any issues with missing files or circular dependencies during the rendering process.
-*/
-function TemporaryHelpCommand() {
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TypescriptFile, {
-		get path() {
-			return (0, _stryke_path.joinPaths)(context.entryPath, "help", "command.ts");
-		},
-		get children() {
-			return [
-				_alloy_js_core.code` // Temporary placeholder file to ensure the help command's entry file is generated. The actual content of this file will be rendered in the \`prepare\` step of this plugin, after the command list has been fully resolved. `,
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-					heading: "Display command usage details and other useful information to the user.",
-					get children() {
-						return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
-							name: "segments",
-							children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`
-						});
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
-					"export": true,
-					"default": true,
-					async: true,
-					name: "handler",
-					parameters: [{
-						name: "segments",
-						type: "string[]",
-						default: "[]"
-					}]
-				})
-			];
-		}
-	});
-}
-/**
-* The Help command's handler wrapper for the Shell Shock project.
-*/
-function HelpCommand(props) {
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const helpImports = (0, _alloy_js_core.computed)(() => props.segments ? props.segments.reduce((ret, segments) => {
-		ret[(0, _stryke_path.joinPaths)("help", ...segments)] = [{
-			name: "showHelp",
-			alias: `showHelp${segments.map((segment) => (0, _stryke_string_format_pascal_case.pascalCase)(segment.replace(/-/g, ""))).join("")}`
-		}];
-		return ret;
-	}, {}) : {});
-	const commandSegmentsList = props.segments ?? [];
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TypescriptFile, {
-		get path() {
-			return (0, _stryke_path.joinPaths)(context.entryPath, "help", "command.ts");
-		},
-		imports: {
-			"node:os": "os",
-			"node:fs/promises": ["readFile", "writeFile"]
-		},
-		get builtinImports() {
-			return {
-				...helpImports.value,
-				help: ["showHelp"],
-				console: [
-					"splitText",
-					"writeLine",
-					"inlineCode",
-					"textColors",
-					"inverse",
-					"bold",
-					"help",
-					"table",
-					"link"
-				]
-			};
-		},
-		get children() {
-			return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-				heading: "Display command usage details and other useful information to the user.",
-				get children() {
-					return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
-						name: "segments",
-						children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`
-					});
-				}
-			}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
-				"export": true,
-				"default": true,
-				async: true,
-				name: "handler",
-				parameters: [{
-					name: "segments",
-					type: "string[]",
-					default: "[]"
-				}],
-				get children() {
-					return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-						get when() {
-							return commandSegmentsList.length > 0;
-						},
-						fallback: _alloy_js_core.code`showHelp(); `,
-						get children() {
-							return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-								each: commandSegmentsList,
-								doubleHardline: true,
-								children: (segments, index) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-									when: index > 0,
-									get fallback() {
-										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
-											get condition() {
-												return _alloy_js_core.code`segments.join("/").toLowerCase() === "${segments.join("/").toLowerCase()}"`;
-											},
-											get children() {
-												return _alloy_js_core.code` showHelp${segments.map((segment) => (0, _stryke_string_format_pascal_case.pascalCase)(segment)).join("")}(); `;
-											}
-										});
-									},
-									get children() {
-										return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
-											get condition() {
-												return _alloy_js_core.code`segments.join("/").toLowerCase() === "${segments.join("/").toLowerCase()}"`;
-											},
-											get children() {
-												return _alloy_js_core.code` showHelp${segments.map((segment) => (0, _stryke_string_format_pascal_case.pascalCase)(segment)).join("")}(); `;
-											}
-										});
-									}
-								})
-							}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseClause, { children: _alloy_js_core.code`showHelp(); ` })];
-						}
-					});
-				}
-			})];
-		}
-	});
-}
-
-//#endregion
-exports.HelpCommand = HelpCommand;
-exports.TemporaryHelpCommand = TemporaryHelpCommand;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`@alloy-js/core/jsx-runtime`),t=require(`@alloy-js/core`),n=require(`@powerlines/plugin-alloy/core/components`),r=require(`@powerlines/plugin-alloy/core/contexts/context`),i=require(`@alloy-js/typescript`),a=require(`@powerlines/plugin-alloy/typescript`),o=require(`@stryke/path`),s=require(`@powerlines/plugin-alloy/typescript/components/tsdoc`),c=require(`@stryke/string-format/pascal-case`);function l(){let c=(0,r.usePowerlines)();return(0,e.createComponent)(a.TypescriptFile,{get path(){return(0,o.joinPaths)(c.entryPath,`help`,`command.ts`)},get children(){return[t.code` // Temporary placeholder file to ensure the help command's entry file is generated. The actual content of this file will be rendered in the \`prepare\` step of this plugin, after the command list has been fully resolved. `,(0,e.createComponent)(n.Spacing,{}),(0,e.createComponent)(s.TSDoc,{heading:`Display command usage details and other useful information to the user.`,get children(){return(0,e.createComponent)(s.TSDocParam,{name:`segments`,children:`The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`})}}),(0,e.createComponent)(i.FunctionDeclaration,{export:!0,default:!0,async:!0,name:`handler`,parameters:[{name:`segments`,type:`string[]`,default:`[]`}]})]}})}function u(n){let l=(0,r.usePowerlines)(),u=(0,t.computed)(()=>n.segments?n.segments.reduce((e,t)=>(e[(0,o.joinPaths)(`help`,...t)]=[{name:`showHelp`,alias:`showHelp${t.map(e=>(0,c.pascalCase)(e.replace(/-/g,``))).join(``)}`}],e),{}):{}),d=n.segments??[];return(0,e.createComponent)(a.TypescriptFile,{get path(){return(0,o.joinPaths)(l.entryPath,`help`,`command.ts`)},imports:{"node:os":`os`,"node:fs/promises":[`readFile`,`writeFile`]},get builtinImports(){return{...u.value,help:[`showHelp`],console:[`splitText`,`writeLine`,`inlineCode`,`textColors`,`inverse`,`bold`,`help`,`table`,`link`]}},get children(){return[(0,e.createComponent)(s.TSDoc,{heading:`Display command usage details and other useful information to the user.`,get children(){return(0,e.createComponent)(s.TSDocParam,{name:`segments`,children:`The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`})}}),(0,e.createComponent)(i.FunctionDeclaration,{export:!0,default:!0,async:!0,name:`handler`,parameters:[{name:`segments`,type:`string[]`,default:`[]`}],get children(){return(0,e.createComponent)(t.Show,{get when(){return d.length>0},fallback:t.code`showHelp(); `,get children(){return[(0,e.createComponent)(t.For,{each:d,doubleHardline:!0,children:(n,r)=>(0,e.createComponent)(t.Show,{when:r>0,get fallback(){return(0,e.createComponent)(i.IfStatement,{get condition(){return t.code`segments.join("/").toLowerCase() === "${n.join(`/`).toLowerCase()}"`},get children(){return t.code` showHelp${n.map(e=>(0,c.pascalCase)(e)).join(``)}(); `}})},get children(){return(0,e.createComponent)(i.ElseIfClause,{get condition(){return t.code`segments.join("/").toLowerCase() === "${n.join(`/`).toLowerCase()}"`},get children(){return t.code` showHelp${n.map(e=>(0,c.pascalCase)(e)).join(``)}(); `}})}})}),(0,e.createComponent)(i.ElseClause,{children:t.code`showHelp(); `})]}})}})]}})}exports.HelpCommand=u,exports.TemporaryHelpCommand=l;

package/dist/components/help-command.mjs

@@ -1,150 +1,2 @@
-import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
-import { For, Show, code, computed } from "@alloy-js/core";
-import { Spacing } from "@powerlines/plugin-alloy/core/components";
-import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { ElseClause, ElseIfClause, FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
-import { TypescriptFile } from "@powerlines/plugin-alloy/typescript";
-import { joinPaths } from "@stryke/path";
-import { TSDoc as TSDoc$1, TSDocParam } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
-import { pascalCase } from "@stryke/string-format/pascal-case";
-
-//#region src/components/help-command.tsx
-/**
-* A temporary placeholder component for the help command. The actual content of this component will be rendered in the `prepare` step of the help plugin, after the command list has been fully resolved. This is necessary to ensure that the help command's entry file is generated, and to avoid any issues with missing files or circular dependencies during the rendering process.
-*/
-function TemporaryHelpCommand() {
-	const context = usePowerlines();
-	return createComponent(TypescriptFile, {
-		get path() {
-			return joinPaths(context.entryPath, "help", "command.ts");
-		},
-		get children() {
-			return [
-				code` // Temporary placeholder file to ensure the help command's entry file is generated. The actual content of this file will be rendered in the \`prepare\` step of this plugin, after the command list has been fully resolved. `,
-				createComponent(Spacing, {}),
-				createComponent(TSDoc$1, {
-					heading: "Display command usage details and other useful information to the user.",
-					get children() {
-						return createComponent(TSDocParam, {
-							name: "segments",
-							children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`
-						});
-					}
-				}),
-				createComponent(FunctionDeclaration, {
-					"export": true,
-					"default": true,
-					async: true,
-					name: "handler",
-					parameters: [{
-						name: "segments",
-						type: "string[]",
-						default: "[]"
-					}]
-				})
-			];
-		}
-	});
-}
-/**
-* The Help command's handler wrapper for the Shell Shock project.
-*/
-function HelpCommand(props) {
-	const context = usePowerlines();
-	const helpImports = computed(() => props.segments ? props.segments.reduce((ret, segments) => {
-		ret[joinPaths("help", ...segments)] = [{
-			name: "showHelp",
-			alias: `showHelp${segments.map((segment) => pascalCase(segment.replace(/-/g, ""))).join("")}`
-		}];
-		return ret;
-	}, {}) : {});
-	const commandSegmentsList = props.segments ?? [];
-	return createComponent(TypescriptFile, {
-		get path() {
-			return joinPaths(context.entryPath, "help", "command.ts");
-		},
-		imports: {
-			"node:os": "os",
-			"node:fs/promises": ["readFile", "writeFile"]
-		},
-		get builtinImports() {
-			return {
-				...helpImports.value,
-				help: ["showHelp"],
-				console: [
-					"splitText",
-					"writeLine",
-					"inlineCode",
-					"textColors",
-					"inverse",
-					"bold",
-					"help",
-					"table",
-					"link"
-				]
-			};
-		},
-		get children() {
-			return [createComponent(TSDoc$1, {
-				heading: "Display command usage details and other useful information to the user.",
-				get children() {
-					return createComponent(TSDocParam, {
-						name: "segments",
-						children: `The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`
-					});
-				}
-			}), createComponent(FunctionDeclaration, {
-				"export": true,
-				"default": true,
-				async: true,
-				name: "handler",
-				parameters: [{
-					name: "segments",
-					type: "string[]",
-					default: "[]"
-				}],
-				get children() {
-					return createComponent(Show, {
-						get when() {
-							return commandSegmentsList.length > 0;
-						},
-						fallback: code`showHelp(); `,
-						get children() {
-							return [createComponent(For, {
-								each: commandSegmentsList,
-								doubleHardline: true,
-								children: (segments, index) => createComponent(Show, {
-									when: index > 0,
-									get fallback() {
-										return createComponent(IfStatement, {
-											get condition() {
-												return code`segments.join("/").toLowerCase() === "${segments.join("/").toLowerCase()}"`;
-											},
-											get children() {
-												return code` showHelp${segments.map((segment) => pascalCase(segment)).join("")}(); `;
-											}
-										});
-									},
-									get children() {
-										return createComponent(ElseIfClause, {
-											get condition() {
-												return code`segments.join("/").toLowerCase() === "${segments.join("/").toLowerCase()}"`;
-											},
-											get children() {
-												return code` showHelp${segments.map((segment) => pascalCase(segment)).join("")}(); `;
-											}
-										});
-									}
-								})
-							}), createComponent(ElseClause, { children: code`showHelp(); ` })];
-						}
-					});
-				}
-			})];
-		}
-	});
-}
-
-//#endregion
-export { HelpCommand, TemporaryHelpCommand };
+import{createComponent as e}from"@alloy-js/core/jsx-runtime";import{For as t,Show as n,code as r,computed as i}from"@alloy-js/core";import{Spacing as a}from"@powerlines/plugin-alloy/core/components";import{usePowerlines as o}from"@powerlines/plugin-alloy/core/contexts/context";import{ElseClause as s,ElseIfClause as c,FunctionDeclaration as l,IfStatement as u}from"@alloy-js/typescript";import{TypescriptFile as d}from"@powerlines/plugin-alloy/typescript";import{joinPaths as f}from"@stryke/path";import{TSDoc as p,TSDocParam as m}from"@powerlines/plugin-alloy/typescript/components/tsdoc";import{pascalCase as h}from"@stryke/string-format/pascal-case";function g(){let t=o();return e(d,{get path(){return f(t.entryPath,`help`,`command.ts`)},get children(){return[r` // Temporary placeholder file to ensure the help command's entry file is generated. The actual content of this file will be rendered in the \`prepare\` step of this plugin, after the command list has been fully resolved. `,e(a,{}),e(p,{heading:`Display command usage details and other useful information to the user.`,get children(){return e(m,{name:`segments`,children:`The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`})}}),e(l,{export:!0,default:!0,async:!0,name:`handler`,parameters:[{name:`segments`,type:`string[]`,default:`[]`}]})]}})}function _(a){let g=o(),_=i(()=>a.segments?a.segments.reduce((e,t)=>(e[f(`help`,...t)]=[{name:`showHelp`,alias:`showHelp${t.map(e=>h(e.replace(/-/g,``))).join(``)}`}],e),{}):{}),v=a.segments??[];return e(d,{get path(){return f(g.entryPath,`help`,`command.ts`)},imports:{"node:os":`os`,"node:fs/promises":[`readFile`,`writeFile`]},get builtinImports(){return{..._.value,help:[`showHelp`],console:[`splitText`,`writeLine`,`inlineCode`,`textColors`,`inverse`,`bold`,`help`,`table`,`link`]}},get children(){return[e(p,{heading:`Display command usage details and other useful information to the user.`,get children(){return e(m,{name:`segments`,children:`The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`})}}),e(l,{export:!0,default:!0,async:!0,name:`handler`,parameters:[{name:`segments`,type:`string[]`,default:`[]`}],get children(){return e(n,{get when(){return v.length>0},fallback:r`showHelp(); `,get children(){return[e(t,{each:v,doubleHardline:!0,children:(t,i)=>e(n,{when:i>0,get fallback(){return e(u,{get condition(){return r`segments.join("/").toLowerCase() === "${t.join(`/`).toLowerCase()}"`},get children(){return r` showHelp${t.map(e=>h(e)).join(``)}(); `}})},get children(){return e(c,{get condition(){return r`segments.join("/").toLowerCase() === "${t.join(`/`).toLowerCase()}"`},get children(){return r` showHelp${t.map(e=>h(e)).join(``)}(); `}})}})}),e(s,{children:r`showHelp(); `})]}})}})]}})}export{_ as HelpCommand,g as TemporaryHelpCommand};
 //# sourceMappingURL=help-command.mjs.map

package/dist/components/help-command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"help-command.mjs","names":[],"sources":["../../src/components/help-command.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 {\n  ElseClause,\n  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { TypescriptFile } from \"@powerlines/plugin-alloy/typescript\";\nimport {\n  TSDoc,\n  TSDocParam\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { joinPaths } from \"@stryke/path\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { HelpPluginContext } from \"../types/plugin\";\n\n/**\n * A temporary placeholder component for the help command. The actual content of this component will be rendered in the `prepare` step of the help plugin, after the command list has been fully resolved. This is necessary to ensure that the help command's entry file is generated, and to avoid any issues with missing files or circular dependencies during the rendering process.\n */\nexport function TemporaryHelpCommand() {\n  const context = usePowerlines<HelpPluginContext>();\n\n  return (\n    <TypescriptFile path={joinPaths(context.entryPath, \"help\", \"command.ts\")}>\n      {code` // Temporary placeholder file to ensure the help command's entry file is generated. The actual content of this file will be rendered in the \\`prepare\\` step of this plugin, after the command list has been fully resolved. `}\n      <Spacing />\n      <TSDoc heading=\"Display command usage details and other useful information to the user.\">\n        <TSDocParam name=\"segments\">\n          {`The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`}\n        </TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[\n          { name: \"segments\", type: \"string[]\", default: \"[]\" }\n        ]}></FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n\nexport interface HelpCommandsProps {\n  segments: string[][];\n}\n\n/**\n * The Help command's handler wrapper for the Shell Shock project.\n */\nexport function HelpCommand(props: HelpCommandsProps) {\n  const context = usePowerlines<HelpPluginContext>();\n\n  const helpImports = computed(() =>\n    props.segments\n      ? props.segments.reduce(\n          (ret, segments) => {\n            ret[joinPaths(\"help\", ...segments)] = [\n              {\n                name: \"showHelp\",\n                alias: `showHelp${segments\n                  .map(segment => pascalCase(segment.replace(/-/g, \"\")))\n                  .join(\"\")}`\n              }\n            ];\n            return ret;\n          },\n          {} as Record<string, { name: string; alias: string }[]>\n        )\n      : {}\n  );\n\n  const commandSegmentsList = props.segments ?? [];\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"help\", \"command.ts\")}\n      imports={{\n        \"node:os\": \"os\",\n        \"node:fs/promises\": [\"readFile\", \"writeFile\"]\n      }}\n      builtinImports={{\n        ...helpImports.value,\n        help: [\"showHelp\"],\n        console: [\n          \"splitText\",\n          \"writeLine\",\n          \"inlineCode\",\n          \"textColors\",\n          \"inverse\",\n          \"bold\",\n          \"help\",\n          \"table\",\n          \"link\"\n        ]\n      }}>\n      <TSDoc heading=\"Display command usage details and other useful information to the user.\">\n        <TSDocParam name=\"segments\">\n          {`The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`}\n        </TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"segments\", type: \"string[]\", default: \"[]\" }]}>\n        <Show\n          when={commandSegmentsList.length > 0}\n          fallback={code`showHelp(); `}>\n          <For each={commandSegmentsList} doubleHardline>\n            {(segments, index) => (\n              <Show\n                when={index > 0}\n                fallback={\n                  <IfStatement\n                    condition={code`segments.join(\"/\").toLowerCase() === \"${segments\n                      .join(\"/\")\n                      .toLowerCase()}\"`}>\n                    {code` showHelp${segments\n                      .map(segment => pascalCase(segment))\n                      .join(\"\")}(); `}\n                  </IfStatement>\n                }>\n                <ElseIfClause\n                  condition={code`segments.join(\"/\").toLowerCase() === \"${segments\n                    .join(\"/\")\n                    .toLowerCase()}\"`}>\n                  {code` showHelp${segments\n                    .map(segment => pascalCase(segment))\n                    .join(\"\")}(); `}\n                </ElseIfClause>\n              </Show>\n            )}\n          </For>\n          <ElseClause>{code`showHelp(); `}</ElseClause>\n        </Show>\n      </FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;AAgCA,SAAS,uBAA8B;CACvC,MAAQ,UAAC,eAAyC;AAClD,QAAO,gBAAO,gBAA6B;;AAEzC,UAAA,UAAA,QAAA,WAAA,QAAA,aAAA;;EAEA,IAAA,WAAA;AACI,UAAC;IAAA,IAAS;IAAuB,gBAAA,SAAA,EAAA,CAAA;IAAA,gBAAA,SAAA;KAC/B,SAAS;;AAER,aAAA,gBAAA,YAAA;OACJ,MAAA;OACO,UAAI;OACT,CAAA;;KAEA,CAAC;IAAC,gBAAiB,qBAAS;KAC3B,UAAQ;KACR,WAAE;KACF,OAAK;KACN,MAAA;KACC,YAAA,CAAA;MACA,MAAA;MACA,MAAA;MACA,SAAM;MACN,CAAA;KACD,CAAC;IAAC;;EAEN,CAAC;;;;;AASJ,SAAY,YAAU,OAA8B;CAClD,MAAA,UAAA,eAAA;CACF,MAAO,cAAS,eAAmB,MAAA,WAAmB,MAAA,SAAA,QAAA,KAAA,aAAA;AACpD,MAAM,UAAU,QAAA,GAAA,SAAc,IAAA,CAAA;;GAE9B,OAAM,WAAc,SAAW,KAAE,YAAA,WAAA,QAAA,QAAA,MAAA,GAAA,CAAA,CAAA,CAAA,KAAA,GAAA;GAC/B,CAAA;AACA,SAAI;IACH,EAAE,CAGA,GAAG,EAAE,CAAC;CACX,MAAM,sBAAgB,MAAU,YAAA,EAAA;AAChC,QAAO,gBAAc,gBAAW;EAC9B,IAAI,OAAO;AACT,UAAO,UAAC,QAAA,WAAA,QAAA,aAAA;;EAEV,SAAQ;GACN,WAAK;GACL,oBAAiB,CAAA,YAAgB,YAAQ;GAC1C;EACD,IAAI,iBAAC;AACN,UAAA;;IAEK,MAAA,CAAA,WAAA;;;;;;;;;;;;IAEN;;EAEE,IAAE,WAAM;AACN,UAAO,CAAC,gBAAC,SAAA;IACP,SAAS;IACT,IAAC,WAAQ;AACV,YAAA,gBAAA,YAAA;MACD,MAAA;MACK,UAAW;MACd,CAAI;;IAEL,CAAC,EAAE,gBAAW,qBAAA;IACb,UAAG;IACH,WAAG;IACH,OAAG;IACH,MAAG;IACH,YAAQ,CAAA;KACN,MAAM;KACN,MAAM;KACN,SAAK;KACP,CAAA;IACA,IAAA,WAAA;AACD,YAAM,gBAAiB,MAAQ;MAC7B,IAAA,OAAW;AACR,cAAI,oBAAyB,SAAQ;;MAEzC,UAAK,IAAA;MACN,IAAA,WAAA;AACC,cAAA,CAAA,gBAAA,KAAA;QACA,MAAA;QACA,gBAAA;QACM,WAAO,UAAA,UAAA,gBAAA,MAAA;SACH,MAAK,QAAO;SACrB,IAAA,WAAA;AACO,iBAAA,gBAA6B,aAAC;WAC1B,IAAK,YAAa;AACjB,mBAAA,IAAA,yCAAmC,SAAA,KAAA,IAAA,CAAA,aAAA,CAAA;;WAEzC,IAAA,WAAA;AACO,mBAAS,IAAA,YAAA,SAAA,KAAA,YAAA,WAAA,QAAA,CAAA,CAAA,KAAA,GAAA,CAAA;;WAEZ,CAAA;;SAED,IAAI,WAAS;AACX,iBAAG,gBAAiB,cAAA;WACnB,IAAK,YAAW;AACd,mBAAI,IAAQ,yCAAsB,SAAA,KAAA,IAAA,CAAA,aAAA,CAAA;;WAErC,IAAA,WAAW;AACd,mBAAA,IAAA,YAAA,SAAA,KAAA,YAAA,WAAA,QAAA,CAAA,CAAA,KAAA,GAAA,CAAA;;WAEC,CAAA;;SAED,CAAC;QACH,CAAC,EAAE,gBAAiB,YAAA,EACnB,UAAS,IAAA,gBACV,CAAC,CAAC;;MAEN,CAAC;;IAEL,CAAC,CAAC;;EAEN,CAAC"}
+{"version":3,"file":"help-command.mjs","names":[],"sources":["../../src/components/help-command.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 {\n  ElseClause,\n  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { TypescriptFile } from \"@powerlines/plugin-alloy/typescript\";\nimport {\n  TSDoc,\n  TSDocParam\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { joinPaths } from \"@stryke/path\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { HelpPluginContext } from \"../types/plugin\";\n\n/**\n * A temporary placeholder component for the help command. The actual content of this component will be rendered in the `prepare` step of the help plugin, after the command list has been fully resolved. This is necessary to ensure that the help command's entry file is generated, and to avoid any issues with missing files or circular dependencies during the rendering process.\n */\nexport function TemporaryHelpCommand() {\n  const context = usePowerlines<HelpPluginContext>();\n\n  return (\n    <TypescriptFile path={joinPaths(context.entryPath, \"help\", \"command.ts\")}>\n      {code` // Temporary placeholder file to ensure the help command's entry file is generated. The actual content of this file will be rendered in the \\`prepare\\` step of this plugin, after the command list has been fully resolved. `}\n      <Spacing />\n      <TSDoc heading=\"Display command usage details and other useful information to the user.\">\n        <TSDocParam name=\"segments\">\n          {`The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`}\n        </TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[\n          { name: \"segments\", type: \"string[]\", default: \"[]\" }\n        ]}></FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n\nexport interface HelpCommandsProps {\n  segments: string[][];\n}\n\n/**\n * The Help command's handler wrapper for the Shell Shock project.\n */\nexport function HelpCommand(props: HelpCommandsProps) {\n  const context = usePowerlines<HelpPluginContext>();\n\n  const helpImports = computed(() =>\n    props.segments\n      ? props.segments.reduce(\n          (ret, segments) => {\n            ret[joinPaths(\"help\", ...segments)] = [\n              {\n                name: \"showHelp\",\n                alias: `showHelp${segments\n                  .map(segment => pascalCase(segment.replace(/-/g, \"\")))\n                  .join(\"\")}`\n              }\n            ];\n            return ret;\n          },\n          {} as Record<string, { name: string; alias: string }[]>\n        )\n      : {}\n  );\n\n  const commandSegmentsList = props.segments ?? [];\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"help\", \"command.ts\")}\n      imports={{\n        \"node:os\": \"os\",\n        \"node:fs/promises\": [\"readFile\", \"writeFile\"]\n      }}\n      builtinImports={{\n        ...helpImports.value,\n        help: [\"showHelp\"],\n        console: [\n          \"splitText\",\n          \"writeLine\",\n          \"inlineCode\",\n          \"textColors\",\n          \"inverse\",\n          \"bold\",\n          \"help\",\n          \"table\",\n          \"link\"\n        ]\n      }}>\n      <TSDoc heading=\"Display command usage details and other useful information to the user.\">\n        <TSDocParam name=\"segments\">\n          {`The command segments for the command to show help for. This is used to determine which command's help information to display. If no segments are provided, general help information about the CLI application will be displayed.`}\n        </TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"segments\", type: \"string[]\", default: \"[]\" }]}>\n        <Show\n          when={commandSegmentsList.length > 0}\n          fallback={code`showHelp(); `}>\n          <For each={commandSegmentsList} doubleHardline>\n            {(segments, index) => (\n              <Show\n                when={index > 0}\n                fallback={\n                  <IfStatement\n                    condition={code`segments.join(\"/\").toLowerCase() === \"${segments\n                      .join(\"/\")\n                      .toLowerCase()}\"`}>\n                    {code` showHelp${segments\n                      .map(segment => pascalCase(segment))\n                      .join(\"\")}(); `}\n                  </IfStatement>\n                }>\n                <ElseIfClause\n                  condition={code`segments.join(\"/\").toLowerCase() === \"${segments\n                    .join(\"/\")\n                    .toLowerCase()}\"`}>\n                  {code` showHelp${segments\n                    .map(segment => pascalCase(segment))\n                    .join(\"\")}(); `}\n                </ElseIfClause>\n              </Show>\n            )}\n          </For>\n          <ElseClause>{code`showHelp(); `}</ElseClause>\n        </Show>\n      </FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n"],"mappings":"8oBA8BA,SAAE,GAAA,CACA,IAAM,EAAC,GAAwB,CACjC,OAAS,EAAkB,EAAa,CACxC,IAAQ,MAAC,CACH,OAAO,EAAC,EAAiB,UAAW,OAAO,aAAO,EAEtD,IAAA,UAAA,CACG,MAAA,CAAS,CAAC,iOAAqO,EAAiB,EAAQ,EAAA,CAAA,CAAA,EAAwB,EAAI,CACvS,QAAA,0EACK,IAAA,UAAS,CACR,OAAS,EAAe,EAAA,iBAEvB,SAAA,mOACJ,CAAA,EAEE,CAAA,CAAA,EAAS,EAAA,CACT,OAAM,GACL,QAAW,GACX,MAAO,GACP,KAAE,UACF,WAAK,CAAA,CACN,KAAA,WACC,KAAA,WACA,QAAA,KACA,CAAA,CACD,CAAC,CAAA,EAEL,CAAC,eAMJ,IAAO,EAAU,GAAA,CACf,EAAoB,MAAA,EAAA,SAAA,EAAA,SAAA,QAAA,EAAA,KACtB,EAAA,EAAA,OAAA,GAAA,EAAA,EAAA,CAAA,iBAEE,MAAA,WAAA,EAAA,IAAA,GAAA,EAAA,EAAA,QAAA,KAAA,GAAA,CAAA,CAAA,CAAA,KAAA,GAAA,GACC,CAAG,CACJ,GACF,EAAO,CAAA,CAAA,EAAA,CAAA,CACC,EAAU,EAAc,UAAA,EAAkB,aAEhD,IAAM,MAAA,CACJ,OAAM,EAAA,EAAA,UAAA,OAAA,aAAA,EAEN,QAAO,CACL,UAAU,KACV,mBAAQ,CAAA,WAAA,YAAA,CACT,CACD,IAAI,gBAAgB,CAClB,MAAO,CACL,GAAG,EAAY,MACf,KAAM,CAAA,WAAA,CACN,QAAK,CAAA,YAAA,YAAA,aAAA,aAAA,UAAA,OAAA,OAAA,QAAA,OAAA,CACN,EAEH,IAAI,UAAQ,CACV,MAAE,CAAA,EAAA,EAAA,CACA,QAAC,0EACN,IAAA,UAAA,aAEK,KAAA,uPAEC,CAAA,EAEH,CAAA,CAAI,EAAY,EAA2B,CAC3C,OAAS,GACP,QAAW,GACX,MAAM,GACP,KAAA,UACD,WAAc,CAAC,CACX,KAAC,WACH,KAAQ,WACR,QAAS,KACR,CAAC,CACF,IAAG,UAAU,CACX,OAAC,EAAW,EAAA,CACX,IAAA,MAAW,CACX,OAAQ,EAAA,OAAA,GAER,SAAK,CAAA,eACL,IAAK,UAAC,CACN,MAAI,CAAA,EAAA,EAAA,CACP,KAAA,EACA,eAAA,GACK,UAAS,EAAe,IAAO,EAAkB,EAAO,CAC5D,KAAe,EAAE,EACV,IAAA,UAAiB,CACb,OAAA,EAAA,EAAA,CACP,IAAA,WAAA,CACN,MAAA,EAAA,yCAAA,EAAA,KAAA,IAAA,CAAA,aAAA,CAAA,IAEC,IAAA,UAAA,CACA,MAAA,EAAA,YAAA,EAAA,IAAA,GAAA,EAAA,EAAA,CAAA,CAAA,KAAA,GAAA,CAAA,OAEa,CAAC,EAEN,IAAA,UAAA,CACI,OAAK,EAAc,EAAA,CAClB,IAAA,WAAA,CACG,MAAO,EAAG,yCAAA,EAAA,KAAA,IAAA,CAAA,aAAA,CAAA,IAEZ,IAAA,UAAS,CACP,MAAC,EAAA,YAAA,EAAA,IAAA,GAAA,EAAA,EAAA,CAAA,CAAA,KAAA,GAAA,CAAA,OAEL,CAAA,EAEH,CAAC,CACH,CAAC,CAAE,EAAkB,EAAC,CACrB,SAAU,CAAC,eACZ,CAAC,CAAC,EAEN,CAAC,EAEL,CAAC,CAAC,EAEN,CAAC"}

package/dist/components/index.cjs

@@ -1,14 +1 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_components_display = require('./display.cjs');
-const require_components_help_builtin = require('./help-builtin.cjs');
-const require_components_help_command = require('./help-command.cjs');
-
-exports.BaseHelpDisplay = require_components_display.BaseHelpDisplay;
-exports.CommandHelpDisplay = require_components_display.CommandHelpDisplay;
-exports.HelpBuiltin = require_components_help_builtin.HelpBuiltin;
-exports.HelpCommand = require_components_help_command.HelpCommand;
-exports.HelpCommandsDisplay = require_components_display.HelpCommandsDisplay;
-exports.HelpOptionsDisplay = require_components_display.HelpOptionsDisplay;
-exports.HelpUsageDisplay = require_components_display.HelpUsageDisplay;
-exports.TemporaryHelpCommand = require_components_help_command.TemporaryHelpCommand;
-exports.VirtualCommandHelpDisplay = require_components_display.VirtualCommandHelpDisplay;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./display.cjs`),t=require(`./help-builtin.cjs`),n=require(`./help-command.cjs`);exports.BaseHelpDisplay=e.BaseHelpDisplay,exports.CommandHelpDisplay=e.CommandHelpDisplay,exports.HelpBuiltin=t.HelpBuiltin,exports.HelpCommand=n.HelpCommand,exports.HelpCommandsDisplay=e.HelpCommandsDisplay,exports.HelpOptionsDisplay=e.HelpOptionsDisplay,exports.HelpUsageDisplay=e.HelpUsageDisplay,exports.TemporaryHelpCommand=n.TemporaryHelpCommand,exports.VirtualCommandHelpDisplay=e.VirtualCommandHelpDisplay;

package/dist/components/index.mjs

@@ -1,5 +1 @@
-import { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay } from "./display.mjs";
-import { HelpBuiltin } from "./help-builtin.mjs";
-import { HelpCommand, TemporaryHelpCommand } from "./help-command.mjs";
-
-export { BaseHelpDisplay, CommandHelpDisplay, HelpBuiltin, HelpCommand, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, TemporaryHelpCommand, VirtualCommandHelpDisplay };
+import{BaseHelpDisplay as e,CommandHelpDisplay as t,HelpCommandsDisplay as n,HelpOptionsDisplay as r,HelpUsageDisplay as i,VirtualCommandHelpDisplay as a}from"./display.mjs";import{HelpBuiltin as o}from"./help-builtin.mjs";import{HelpCommand as s,TemporaryHelpCommand as c}from"./help-command.mjs";export{e as BaseHelpDisplay,t as CommandHelpDisplay,o as HelpBuiltin,s as HelpCommand,n as HelpCommandsDisplay,r as HelpOptionsDisplay,i as HelpUsageDisplay,c as TemporaryHelpCommand,a as VirtualCommandHelpDisplay};