@shell-shock/preset-script 0.3.3 → 0.4.0

package/dist/components/command-entry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","OptionsInterfaceDeclaration","OptionsParserLogic","PositionalOptionsParserLogic","getAppBin","getAppTitle","getPositionalCommandOptionName","isPositionalCommandOption","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","pascalCase","defu","Help","VirtualCommandEntry","CommandInvocation","props","command","_$memo","name","path","segments","filter","segment","length","map","join","_$createIntrinsic","CommandHandlerDeclaration","context","_$createComponent","heading","title","children","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","CommandEntry","imports","builtinImports","rest","filePath","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","env","console","utils","each","Object","values","child","when","isVirtual","fallback"],"sources":["../../src/components/command-entry.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  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport {\n  OptionsInterfaceDeclaration,\n  OptionsParserLogic,\n  PositionalOptionsParserLogic\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getAppTitle,\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { Help } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code`return Promise.resolve(handle${pascalCase(command.name)}(options${\n        command.path.segments.filter(segment =>\n          isPositionalCommandOption(segment)\n        ).length > 0\n          ? `, ${command.path.segments\n              .filter(segment => isPositionalCommandOption(segment))\n              .map(segment =>\n                camelCase(getPositionalCommandOptionName(segment))\n              )\n              .join(\", \")}`\n          : \"\"\n      }));`}\n      <hbr />\n    </>\n  );\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(props: { command: CommandTree }) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(\n          context\n        )} ${command.path.segments\n          .map(segment =>\n            isPositionalCommandOption(segment)\n              ? `[${constantCase(getPositionalCommandOptionName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"getArgs()\" }]}>\n        <PositionalOptionsParserLogic\n          path={command.path}\n          envPrefix={context.config.envPrefix}\n        />\n        <hbr />\n        <hbr />\n        <OptionsParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          {code`\n        writeLine(\"\");\n        writeLine(colors.text.heading.primary(\"${getAppTitle(context)} - ${\n          command.title\n        }\"));\n        writeLine(\"\");\n        writeLine(colors.text.body.primary(\"${command.description.replace(\n          /\\.+$/,\n          \"\"\n        )}.\"));\n        writeLine(\"\");`}\n          <hbr />\n          <Help command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.path.segments\n        .filter(segment => !isPositionalCommandOption(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isCI\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\"getArgs\", \"isMinimal\"]\n        })}>\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} />\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","OptionsInterfaceDeclaration","OptionsParserLogic","PositionalOptionsParserLogic","getAppBin","getPositionalCommandOptionName","isPositionalCommandOption","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$memo","name","path","segments","filter","segment","length","map","join","_$createIntrinsic","CommandHandlerDeclaration","children","context","_$createComponent","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","CommandEntry","imports","builtinImports","rest","filePath","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","env","console","utils","each","Object","values","child","when","isVirtual","fallback"],"sources":["../../src/components/command-entry.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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport {\n  OptionsInterfaceDeclaration,\n  OptionsParserLogic,\n  PositionalOptionsParserLogic\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code`return Promise.resolve(handle${pascalCase(command.name)}(options${\n        command.path.segments.filter(segment =>\n          isPositionalCommandOption(segment)\n        ).length > 0\n          ? `, ${command.path.segments\n              .filter(segment => isPositionalCommandOption(segment))\n              .map(segment =>\n                camelCase(getPositionalCommandOptionName(segment))\n              )\n              .join(\", \")}`\n          : \"\"\n      }));`}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(\n          context\n        )} ${command.path.segments\n          .map(segment =>\n            isPositionalCommandOption(segment)\n              ? `[${constantCase(getPositionalCommandOptionName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"getArgs()\" }]}>\n        <PositionalOptionsParserLogic\n          path={command.path}\n          envPrefix={context.config.envPrefix}\n        />\n        <hbr />\n        <hbr />\n        <OptionsParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        {code`writeLine(\"\");\n        banner();`}\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.path.segments\n        .filter(segment => !isPositionalCommandOption(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isCI\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\"getArgs\", \"hasFlag\", \"isMinimal\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} />\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/command-entry.d.cts

@@ -1,24 +1,26 @@
-import * as _alloy_js_core13 from "@alloy-js/core";
-import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
+import { Children } from "@alloy-js/core";
 import { CommandTree } from "@shell-shock/core/types/command";
+import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 
 //#region src/components/command-entry.d.ts
 declare function CommandInvocation(props: {
   command: CommandTree;
-}): _alloy_js_core13.Children;
+}): Children;
+interface CommandHandlerDeclarationProps {
+  command: CommandTree;
+  children?: Children;
+}
 /**
  * A component that generates the `handler` function declaration for a command.
  */
-declare function CommandHandlerDeclaration(props: {
-  command: CommandTree;
-}): _alloy_js_core13.Children;
+declare function CommandHandlerDeclaration(props: CommandHandlerDeclarationProps): Children;
 interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinition"> {
   command: CommandTree;
 }
 /**
  * The command entry point for the Shell Shock project.
  */
-declare function CommandEntry(props: CommandEntryProps): _alloy_js_core13.Children;
+declare function CommandEntry(props: CommandEntryProps): Children;
 //#endregion
-export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation };
+export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandHandlerDeclarationProps, CommandInvocation };
 //# sourceMappingURL=command-entry.d.cts.map

package/dist/components/command-entry.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAwDgB,iBAAA;WAAoC;IAAW,gBAAA,CAAE;AAAjE;AAyBA;AAgEA;AACE,iBAjEc,yBAAA,CAiEd,KAAA,EAAA;EAGS,OAAA,EApEiD,WAoEjD;CAJgC,CAAA,EAhE4B,gBAAA,CAAE,QAgE9B;AAAI,UAA9B,iBAAA,SAA0B,IAAI,CAC7C,cAD6C,EAAA,MAAA,GAAA,gBAAA,CAAA,CAAA;EAU/B,OAAA,EANL,WAMiB;;;;;iBAAZ,YAAA,QAAoB,oBAAiB,gBAAA,CAAA"}
+{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAyDgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AAsBC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA6DC,QAAA,CAAA,EAnEJ,QAmEI;;;;;AAUD,iBAvEA,yBAAA,CAuEqC,KAAA,EAtE5C,8BAsE4C,CAAA,EAtEd,QAsEc;UAVpC,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}

package/dist/components/command-entry.d.mts

@@ -1,24 +1,26 @@
-import * as _alloy_js_core12 from "@alloy-js/core";
+import { Children } from "@alloy-js/core";
 import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { CommandTree } from "@shell-shock/core/types/command";
 
 //#region src/components/command-entry.d.ts
 declare function CommandInvocation(props: {
   command: CommandTree;
-}): _alloy_js_core12.Children;
+}): Children;
+interface CommandHandlerDeclarationProps {
+  command: CommandTree;
+  children?: Children;
+}
 /**
  * A component that generates the `handler` function declaration for a command.
  */
-declare function CommandHandlerDeclaration(props: {
-  command: CommandTree;
-}): _alloy_js_core12.Children;
+declare function CommandHandlerDeclaration(props: CommandHandlerDeclarationProps): Children;
 interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinition"> {
   command: CommandTree;
 }
 /**
  * The command entry point for the Shell Shock project.
  */
-declare function CommandEntry(props: CommandEntryProps): _alloy_js_core12.Children;
+declare function CommandEntry(props: CommandEntryProps): Children;
 //#endregion
-export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation };
+export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandHandlerDeclarationProps, CommandInvocation };
 //# sourceMappingURL=command-entry.d.mts.map

package/dist/components/command-entry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAwDgB,iBAAA;WAAoC;IAAW,gBAAA,CAAE;AAAjE;AAyBA;AAgEA;AACE,iBAjEc,yBAAA,CAiEd,KAAA,EAAA;EAGS,OAAA,EApEiD,WAoEjD;CAJgC,CAAA,EAhE4B,gBAAA,CAAE,QAgE9B;AAAI,UAA9B,iBAAA,SAA0B,IAAI,CAC7C,cAD6C,EAAA,MAAA,GAAA,gBAAA,CAAA,CAAA;EAU/B,OAAA,EANL,WAMiB;;;;;iBAAZ,YAAA,QAAoB,oBAAiB,gBAAA,CAAA"}
+{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAyDgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AAsBC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA6DC,QAAA,CAAA,EAnEJ,QAmEI;;;;;AAUD,iBAvEA,yBAAA,CAuEqC,KAAA,EAtE5C,8BAsE4C,CAAA,EAtEd,QAsEc;UAVpC,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}

package/dist/components/command-entry.mjs

@@ -1,10 +1,11 @@
-import { Help } from "./help.mjs";
+import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
+import { CommandHelp } from "./help.mjs";
 import { VirtualCommandEntry } from "./virtual-command-entry.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code, computed } from "@alloy-js/core";
 import { ElseClause, FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { getAppBin, getAppTitle, getPositionalCommandOptionName, isPositionalCommandOption } from "@shell-shock/core/plugin-utils/context-helpers";
+import { getAppBin, getPositionalCommandOptionName, isPositionalCommandOption } from "@shell-shock/core/plugin-utils/context-helpers";
 import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { TSDoc, TSDocParam, TSDocRemarks, TSDocTitle } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
 import { replaceExtension } from "@stryke/path/replace";
@@ -25,7 +26,7 @@ function CommandInvocation(props) {
 * A component that generates the `handler` function declaration for a command.
 */
 function CommandHandlerDeclaration(props) {
-	const { command } = props;
+	const { command, children } = props;
 	const context = usePowerlines();
 	return [createComponent(TSDoc, {
 		get heading() {
@@ -78,19 +79,17 @@ function CommandHandlerDeclaration(props) {
 				}),
 				createIntrinsic("hbr", {}),
 				createIntrinsic("hbr", {}),
+				code`writeLine("");
+        banner();`,
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				children,
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
 				createComponent(IfStatement, {
 					condition: code`options.help`,
 					get children() {
-						return [
-							memo(() => code`
-        writeLine("");
-        writeLine(colors.text.heading.primary("${getAppTitle(context)} - ${command.title}"));
-        writeLine("");
-        writeLine(colors.text.body.primary("${command.description.replace(/\.+$/, "")}."));
-        writeLine("");`),
-							createIntrinsic("hbr", {}),
-							createComponent(Help, { command })
-						];
+						return createComponent(CommandHelp, { command });
 					}
 				}),
 				createComponent(ElseClause, { get children() {
@@ -134,11 +133,18 @@ function CommandEntry(props) {
 					"writeLine",
 					"splitText"
 				],
-				utils: ["getArgs", "isMinimal"]
+				utils: [
+					"getArgs",
+					"hasFlag",
+					"isMinimal"
+				]
 			});
 		},
 		get children() {
 			return [
+				createComponent(BannerFunctionDeclaration, { command }),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
 				createComponent(OptionsInterfaceDeclaration, { command }),
 				createIntrinsic("hbr", {}),
 				createIntrinsic("hbr", {}),

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Show","ElseClause","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","OptionsInterfaceDeclaration","OptionsParserLogic","PositionalOptionsParserLogic","getAppBin","getAppTitle","getPositionalCommandOptionName","isPositionalCommandOption","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","pascalCase","defu","Help","VirtualCommandEntry","CommandInvocation","props","command","_$memo","name","path","segments","filter","segment","length","map","join","_$createIntrinsic","CommandHandlerDeclaration","context","_$createComponent","heading","title","children","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","CommandEntry","imports","builtinImports","rest","filePath","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","env","console","utils","each","Object","values","child","when","isVirtual","fallback"],"sources":["../../src/components/command-entry.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  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport {\n  OptionsInterfaceDeclaration,\n  OptionsParserLogic,\n  PositionalOptionsParserLogic\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getAppTitle,\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { Help } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code`return Promise.resolve(handle${pascalCase(command.name)}(options${\n        command.path.segments.filter(segment =>\n          isPositionalCommandOption(segment)\n        ).length > 0\n          ? `, ${command.path.segments\n              .filter(segment => isPositionalCommandOption(segment))\n              .map(segment =>\n                camelCase(getPositionalCommandOptionName(segment))\n              )\n              .join(\", \")}`\n          : \"\"\n      }));`}\n      <hbr />\n    </>\n  );\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(props: { command: CommandTree }) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(\n          context\n        )} ${command.path.segments\n          .map(segment =>\n            isPositionalCommandOption(segment)\n              ? `[${constantCase(getPositionalCommandOptionName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"getArgs()\" }]}>\n        <PositionalOptionsParserLogic\n          path={command.path}\n          envPrefix={context.config.envPrefix}\n        />\n        <hbr />\n        <hbr />\n        <OptionsParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          {code`\n        writeLine(\"\");\n        writeLine(colors.text.heading.primary(\"${getAppTitle(context)} - ${\n          command.title\n        }\"));\n        writeLine(\"\");\n        writeLine(colors.text.body.primary(\"${command.description.replace(\n          /\\.+$/,\n          \"\"\n        )}.\"));\n        writeLine(\"\");`}\n          <hbr />\n          <Help command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.path.segments\n        .filter(segment => !isPositionalCommandOption(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isCI\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\"getArgs\", \"isMinimal\"]\n        })}>\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} />\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Show","ElseClause","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","OptionsInterfaceDeclaration","OptionsParserLogic","PositionalOptionsParserLogic","getAppBin","getPositionalCommandOptionName","isPositionalCommandOption","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$memo","name","path","segments","filter","segment","length","map","join","_$createIntrinsic","CommandHandlerDeclaration","children","context","_$createComponent","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","CommandEntry","imports","builtinImports","rest","filePath","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","env","console","utils","each","Object","values","child","when","isVirtual","fallback"],"sources":["../../src/components/command-entry.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 type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport {\n  OptionsInterfaceDeclaration,\n  OptionsParserLogic,\n  PositionalOptionsParserLogic\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code`return Promise.resolve(handle${pascalCase(command.name)}(options${\n        command.path.segments.filter(segment =>\n          isPositionalCommandOption(segment)\n        ).length > 0\n          ? `, ${command.path.segments\n              .filter(segment => isPositionalCommandOption(segment))\n              .map(segment =>\n                camelCase(getPositionalCommandOptionName(segment))\n              )\n              .join(\", \")}`\n          : \"\"\n      }));`}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(\n          context\n        )} ${command.path.segments\n          .map(segment =>\n            isPositionalCommandOption(segment)\n              ? `[${constantCase(getPositionalCommandOptionName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"getArgs()\" }]}>\n        <PositionalOptionsParserLogic\n          path={command.path}\n          envPrefix={context.config.envPrefix}\n        />\n        <hbr />\n        <hbr />\n        <OptionsParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        {code`writeLine(\"\");\n        banner();`}\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.path.segments\n        .filter(segment => !isPositionalCommandOption(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isCI\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\"getArgs\", \"hasFlag\", \"isMinimal\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} />\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/command-router.cjs

@@ -3,10 +3,10 @@ let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
 let __alloy_js_typescript = require("@alloy-js/typescript");
 let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
-let __shell_shock_core_contexts_command = require("@shell-shock/core/contexts/command");
 let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
 let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
 let __powerlines_plugin_alloy_typescript_components_dynamic_import_statement = require("@powerlines/plugin-alloy/typescript/components/dynamic-import-statement");
+let __shell_shock_core_contexts_command = require("@shell-shock/core/contexts/command");
 
 //#region src/components/command-router.tsx
 function CommandRouterRoute() {

package/dist/components/command-router.mjs

@@ -2,10 +2,10 @@ import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runti
 import { For, Show, code, computed } from "@alloy-js/core";
 import { ElseIfClause, IfStatement, VarDeclaration } from "@alloy-js/typescript";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { CommandContext, useCommand } from "@shell-shock/core/contexts/command";
 import { isPositionalCommandOption } from "@shell-shock/core/plugin-utils/context-helpers";
 import { pascalCase } from "@stryke/string-format/pascal-case";
 import { DynamicImportStatement } from "@powerlines/plugin-alloy/typescript/components/dynamic-import-statement";
+import { CommandContext, useCommand } from "@shell-shock/core/contexts/command";
 
 //#region src/components/command-router.tsx
 function CommandRouterRoute() {

package/dist/components/help.cjs

@@ -90,11 +90,11 @@ function HelpCommands(props) {
 /**
 * A component that generates the `help` function declaration for a command.
 */
-function Help(props) {
-	const { command, indent = 1 } = props;
+function BaseHelp(props) {
+	const { command, indent = 1, filterGlobalOptions = false } = props;
 	const theme = require_contexts_theme.useTheme();
 	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const options = (0, __alloy_js_core.computed)(() => Object.values(command.options).filter((option) => !context.options.some((globalOption) => globalOption.name === option.name || option.alias.includes(globalOption.name) || globalOption.alias?.includes(option.name) || globalOption.alias?.some((alias) => option.alias.includes(alias)))) ?? []);
+	const options = (0, __alloy_js_core.computed)(() => filterGlobalOptions ? Object.values(command.options).filter((option) => !context.options.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));
 	return [
 		(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`writeLine(colors.bold(colors.text.heading.secondary("Usage:"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
@@ -143,13 +143,11 @@ function Help(props) {
 /**
 * A component that generates the invocation of the `help` function for a command.
 */
-function HelpInvoke(props) {
-	const { options, commands } = props;
+function VirtualHelp(props) {
+	const { options, path, commands } = props;
 	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
 	return [
 		__alloy_js_core.code`
-      writeLine("");
-      banner();
       writeLine(""); `,
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
@@ -184,15 +182,73 @@ function HelpInvoke(props) {
                 writeLine("");
                 `),
 							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(Help, {
+							(0, __alloy_js_core_jsx_runtime.createComponent)(BaseHelp, {
 								command: child,
-								indent: 2
+								indent: 2,
+								filterGlobalOptions: true
 							}),
 							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
 						]
 					}),
-					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`help("Running a specific command with the help flag (via: '${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)} <specific command> --help') will provide additional information that is specific to that command.");
-                  writeLine("");`)
+					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`help("Running a specific command with the help flag (via: '${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)}${path?.segments && path.segments.length > 0 ? ` ${path.segments.join(" ")}` : ""} <specific command> --help') will provide additional information that is specific to that command.");
+        writeLine("");`)
+				];
+			}
+		})
+	];
+}
+/**
+* A component that generates the invocation of the `help` function for a command.
+*/
+function CommandHelp(props) {
+	const { command } = props;
+	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return [
+		__alloy_js_core.code`writeLine(""); `,
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(BaseHelp, {
+			command,
+			filterGlobalOptions: false
+		}),
+		__alloy_js_core.code`writeLine(""); `,
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Object.keys(command.children).length > 0;
+			},
+			get children() {
+				return [
+					__alloy_js_core.code`writeLine(colors.text.body.secondary("The following sub-commands are available:"));
+        writeLine(""); `,
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+						get each() {
+							return Object.values(command.children);
+						},
+						doubleHardline: true,
+						joiner: __alloy_js_core.code`writeLine(""); `,
+						ender: __alloy_js_core.code`writeLine(""); `,
+						children: (child) => [
+							(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
+                writeLine(colors.text.heading.primary("${child.title} ${child.isVirtual ? "" : "Command"}"));
+                writeLine("");
+                writeLine(colors.text.body.secondary("${child.description}"));
+                writeLine("");
+                `),
+							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(BaseHelp, {
+								command: child,
+								indent: 2,
+								filterGlobalOptions: true
+							}),
+							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+						]
+					}),
+					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`help("Running a specific command with the help flag (via: '${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)} ${command.path.segments.join(" ")} <specific command> --help') will provide additional information that is specific to that command.");
+        writeLine("");`)
 				];
 			}
 		})
@@ -200,9 +256,10 @@ function HelpInvoke(props) {
 }
 
 //#endregion
-exports.Help = Help;
+exports.BaseHelp = BaseHelp;
+exports.CommandHelp = CommandHelp;
 exports.HelpCommands = HelpCommands;
-exports.HelpInvoke = HelpInvoke;
 exports.HelpOptions = HelpOptions;
 exports.HelpUsage = HelpUsage;
+exports.VirtualHelp = VirtualHelp;
 //# sourceMappingURL=help.cjs.map

package/dist/components/help.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.cjs","names":["code","computed","For","Show","ReflectionKind","usePowerlines","Usage","getAppBin","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","padding","app","_$createIntrinsic","HelpOptions","options","option","flags","names","name","length","push","alias","forEach","sort","join","kind","string","variadic","number","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","values","child","Help","filter","some","globalOption","includes","when","value","HelpInvoke","doubleHardline","joiner","ender","title","isVirtual"],"sources":["../../src/components/help.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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { Usage } from \"@shell-shock/core/components/usage\";\nimport { getAppBin } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n  CommandOption,\n  CommandTree\n} from \"@shell-shock/core/types/command\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { useTheme } from \"../contexts\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\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 HelpUsage(props: HelpUsageProps) {\n  const { command, indent = 2 } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const theme = useTheme();\n\n  return (\n    <For each={Object.keys(context.config.bin)} hardline>\n      {bin => (\n        <>\n          {code`\n      writeLine(\n        colors.text.body.primary(\"`}\n          <Usage bin={bin} command={command} />\n          {code`\"), { padding: ${theme.padding.app * indent} }\n      );`}\n          <hbr />\n        </>\n      )}\n    </For>\n  );\n}\n\nexport interface HelpOptionsProps {\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 HelpOptions(props: HelpOptionsProps) {\n  const { options } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\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: colors.text.body.primary(\"${\n            flags.length > 0\n              ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n              : \"\"\n          }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n            option.kind === ReflectionKind.string\n              ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === ReflectionKind.number\n                ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n            /\\.+$/,\n            \"\"\n          )} ${\n            option.env || option.default !== undefined\n              ? `(${\n                  option.env\n                    ? `env: ${context.config.envPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default)}`\n                    : \"\"\n                })`\n              : \"\"\n          }.\"), align: \"left\", border: \"none\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpCommandsProps {\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 HelpCommands(props: HelpCommandsProps) {\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: colors.text.body.primary(\"${\n            child.name\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpProps {\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 1\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function Help(props: HelpProps) {\n  const { command, indent = 1 } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(\n    () =>\n      Object.values(command.options).filter(\n        option =>\n          !context.options.some(\n            globalOption =>\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  );\n\n  return (\n    <>\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpUsage command={command} indent={indent} />\n      <hbr />\n      <hbr />\n      <Show when={options.value.length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpOptions options={options.value} />\n        <hbr />\n        <hbr />\n      </Show>\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpCommands commands={command.children} />\n        <hbr />\n        <hbr />\n      </Show>\n    </>\n  );\n}\n\nexport interface HelpInvokeProps {\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/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function HelpInvoke(props: HelpInvokeProps) {\n  const { options, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`\n      writeLine(\"\");\n      banner();\n      writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      <Show when={Object.keys(commands).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(commands)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(\"${child.title} ${\n                  child.isVirtual ? \"\" : \"Command\"\n                }\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <Help command={child} indent={2} />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\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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"}
+{"version":3,"file":"help.cjs","names":["code","computed","For","Show","ReflectionKind","usePowerlines","Usage","getAppBin","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","padding","app","_$createIntrinsic","HelpOptions","options","option","flags","names","name","length","push","alias","forEach","sort","join","kind","string","variadic","number","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","values","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","when","value","VirtualHelp","path","doubleHardline","joiner","ender","title","isVirtual","segments","CommandHelp"],"sources":["../../src/components/help.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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { Usage } from \"@shell-shock/core/components/usage\";\nimport { getAppBin } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n  CommandOption,\n  CommandTree,\n  CommandTreePath\n} from \"@shell-shock/core/types/command\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { useTheme } from \"../contexts\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\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 HelpUsage(props: HelpUsageProps) {\n  const { command, indent = 2 } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const theme = useTheme();\n\n  return (\n    <For each={Object.keys(context.config.bin)} hardline>\n      {bin => (\n        <>\n          {code`\n      writeLine(\n        colors.text.body.primary(\"`}\n          <Usage bin={bin} command={command} />\n          {code`\"), { padding: ${theme.padding.app * indent} }\n      );`}\n          <hbr />\n        </>\n      )}\n    </For>\n  );\n}\n\nexport interface HelpOptionsProps {\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 HelpOptions(props: HelpOptionsProps) {\n  const { options } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\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: colors.text.body.primary(\"${\n            flags.length > 0\n              ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n              : \"\"\n          }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n            option.kind === ReflectionKind.string\n              ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === ReflectionKind.number\n                ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n            /\\.+$/,\n            \"\"\n          )} ${\n            option.env || option.default !== undefined\n              ? `(${\n                  option.env\n                    ? `env: ${context.config.envPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default)}`\n                    : \"\"\n                })`\n              : \"\"\n          }.\"), align: \"left\", border: \"none\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpCommandsProps {\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 HelpCommands(props: HelpCommandsProps) {\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: colors.text.body.primary(\"${\n            child.name\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface BaseHelpProps {\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 BaseHelp(props: BaseHelpProps) {\n  const { command, indent = 1, filterGlobalOptions = false } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(() =>\n    filterGlobalOptions\n      ? Object.values(command.options).filter(\n          option =>\n            !context.options.some(\n              globalOption =>\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(colors.bold(colors.text.heading.secondary(\"Usage:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpUsage command={command} indent={indent} />\n      <hbr />\n      <hbr />\n      <Show when={options.value.length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpOptions options={options.value} />\n        <hbr />\n        <hbr />\n      </Show>\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpCommands commands={command.children} />\n        <hbr />\n        <hbr />\n      </Show>\n    </>\n  );\n}\n\nexport interface VirtualHelpProps {\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  path?: CommandTreePath;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n  const { options, path, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`\n      writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      <Show when={Object.keys(commands).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(commands)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(\"${child.title} ${\n                  child.isVirtual ? \"\" : \"Command\"\n                }\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )}${\n          path?.segments && path.segments.length > 0\n            ? ` ${path.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\nexport interface CommandHelpProps {\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 CommandHelp(props: CommandHelpProps) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      <BaseHelp command={command} filterGlobalOptions={false} />\n      {code`writeLine(\"\"); `}\n      <hbr />\n      <hbr />\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(command.children)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(\"${child.title} ${\n                  child.isVirtual ? \"\" : \"Command\"\n                }\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} ${command.path.segments.join(\" \")} <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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"}

package/dist/components/help.d.cts

@@ -1,5 +1,5 @@
-import * as _alloy_js_core7 from "@alloy-js/core";
-import { CommandOption, CommandTree } from "@shell-shock/core/types/command";
+import * as _alloy_js_core5 from "@alloy-js/core";
+import { CommandOption, CommandTree, CommandTreePath } from "@shell-shock/core/types/command";
 
 //#region src/components/help.d.ts
 interface HelpUsageProps {
@@ -20,7 +20,7 @@ interface HelpUsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function HelpUsage(props: HelpUsageProps): _alloy_js_core7.Children;
+declare function HelpUsage(props: HelpUsageProps): _alloy_js_core5.Children;
 interface HelpOptionsProps {
   /**
    * The options to display help for.
@@ -30,7 +30,7 @@ interface HelpOptionsProps {
 /**
  * A component that generates the options table display for a command.
  */
-declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core7.Children;
+declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core5.Children;
 interface HelpCommandsProps {
   /**
    * A mapping of command names to their command definitions.
@@ -40,12 +40,21 @@ interface HelpCommandsProps {
 /**
  * A component that generates the commands table display for a command.
  */
-declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core7.Children;
-interface HelpProps {
+declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core5.Children;
+interface BaseHelpProps {
   /**
    * The command to generate help for.
    */
   command: CommandTree;
+  /**
+   * Whether to filter out global options from the help display.
+   *
+   * @remarks
+   * 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.
+   *
+   * @defaultValue false
+   */
+  filterGlobalOptions?: boolean;
   /**
    * The padding scale to apply to the help display headings.
    *
@@ -59,8 +68,8 @@ interface HelpProps {
 /**
  * A component that generates the `help` function declaration for a command.
  */
-declare function Help(props: HelpProps): _alloy_js_core7.Children;
-interface HelpInvokeProps {
+declare function BaseHelp(props: BaseHelpProps): _alloy_js_core5.Children;
+interface VirtualHelpProps {
   /**
    * The options to display help for.
    */
@@ -69,11 +78,28 @@ interface HelpInvokeProps {
    * A mapping of command names to their command definitions.
    */
   commands: Record<string, CommandTree>;
+  /**
+   * The command path to generate help for, used for generating the help invocation instructions.
+   *
+   * @remarks
+   * 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).
+   */
+  path?: CommandTreePath;
+}
+/**
+ * A component that generates the invocation of the `help` function for a command.
+ */
+declare function VirtualHelp(props: VirtualHelpProps): _alloy_js_core5.Children;
+interface CommandHelpProps {
+  /**
+   * A mapping of command names to their command definitions.
+   */
+  command: CommandTree;
 }
 /**
  * A component that generates the invocation of the `help` function for a command.
  */
-declare function HelpInvoke(props: HelpInvokeProps): _alloy_js_core7.Children;
+declare function CommandHelp(props: CommandHelpProps): _alloy_js_core5.Children;
 //#endregion
-export { Help, HelpCommands, HelpCommandsProps, HelpInvoke, HelpInvokeProps, HelpOptions, HelpOptionsProps, HelpProps, HelpUsage, HelpUsageProps };
+export { BaseHelp, BaseHelpProps, CommandHelp, CommandHelpProps, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpUsage, HelpUsageProps, VirtualHelp, VirtualHelpProps };
 //# sourceMappingURL=help.d.cts.map

package/dist/components/help.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAiCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAuBR;AAUjB;AA+DA;AAUA;AAuBA;AAoBA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAM3B;;iBAzNgB,SAAA,QAAiB,iBAAc,eAAA,CAAA;UAuB9B,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,SAAA;;;;WAIN;;;;;;;;;;;;;;iBAgBK,IAAA,QAAY,YAAS,eAAA,CAAA;UAqDpB,eAAA;;;;WAIN;;;;YAKC,eAAe;;;;;iBAMX,UAAA,QAAkB,kBAAe,eAAA,CAAA"}
+{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAkCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAuBR;AAUjB;AA+DA;AAUA;AAuBA;AA8BA;AAsDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;;AAc3B;AAwDiB,iBApSD,SAAA,CAoSiB,KAItB,EAxSsB,cAwSX,CAAA,EAxSyB,eAAA,CAAA,QAwSzB;AAMN,UAvRC,gBAAA,CAuRkB;;;;WAnRxB;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAsD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;SAQlB;;;;;iBAMO,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAwDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}