@shell-shock/preset-script 0.6.26 → 0.6.28

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

@@ -1,4 +1,3 @@
-import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
 import { CommandRouter } from "./command-router.mjs";
 import { CommandEntry } from "./command-entry.mjs";
 import { createComponent, createIntrinsic, mergeProps } from "@alloy-js/core/jsx-runtime";
@@ -103,28 +102,25 @@ function VirtualCommandEntry(props) {
 					"isUnicodeSupported",
 					"findSuggestions"
 				],
-				[joinPaths("help", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showHelp"]
+				[joinPaths("help", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showHelp"],
+				[joinPaths("banner", ...command.segments.filter((segment) => !isDynamicPathSegment(segment)))]: ["showBanner"]
 			});
 		},
 		get children() {
-			return [
-				createComponent(BannerFunctionDeclaration, { command }),
-				createComponent(Spacing, {}),
-				createComponent(VirtualCommandHandlerDeclaration, {
-					command,
-					banner: code`banner(); `,
-					get children() {
-						return createComponent(CommandRouter, {
-							get segments() {
-								return command.segments;
-							},
-							get commands() {
-								return command.children;
-							}
-						});
-					}
-				})
-			];
+			return [createComponent(Spacing, {}), createComponent(VirtualCommandHandlerDeclaration, {
+				command,
+				banner: code`await showBanner(); `,
+				get children() {
+					return createComponent(CommandRouter, {
+						get segments() {
+							return command.segments;
+						},
+						get commands() {
+							return command.children;
+						}
+					});
+				}
+			})];
 		}
 	})), createComponent(For, {
 		get each() {

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-command-entry.mjs","names":[],"sources":["../../src/components/virtual-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 { FunctionDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } 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 { TypescriptFile } from \"@powerlines/plugin-alloy/typescript/components/typescript-file\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\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 { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\n\nexport interface VirtualCommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function VirtualCommandHandlerDeclaration(\n  props: VirtualCommandHandlerDeclarationProps\n) {\n  const { command, children, banner } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) virtual 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: \"useArgs()\" }]}>\n        <Spacing />\n        {children}\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        {code`return showHelp(); `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface VirtualCommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The virtual command entry point for the Shell Shock project.\n */\nexport function VirtualCommandEntry(props: VirtualCommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      context.entryPath,\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n\n  return (\n    <>\n      <TypescriptFile\n        {...rest}\n        path={filePath.value}\n        imports={defu(\n          imports ?? {},\n          Object.entries(command.children)\n            .filter(([, child]) => child.isVirtual)\n            .reduce((ret, [name, child]) => {\n              ret[`./${child.name}`] = [\n                { name: \"handler\", alias: `handle${pascalCase(name)}` }\n              ];\n\n              return ret;\n            }, {} as TypescriptFileImports)\n        )}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"isDevelopment\", \"isDebug\"],\n          console: [\"warn\", \"error\", \"colors\", \"writeLine\"],\n          utils: [\n            \"useApp\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"findSuggestions\"\n          ],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <Spacing />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`banner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\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":";;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,iCAAC,OAAsC;CACrD,MAAA,EACA,SACA,UACF;CAEE,MAAA,UAAA,eAAA;AACA,QAAG,CAAA,gBAAe,OAAe;EACjC,IAAA,UAAA;AACI,UAAC,OAAS,QAAA,MAAA,IAAA,UAAgC,QAAA,CAAA,GAAA,QAAA,SAAA,KAAA,YAAA,qBAAA,QAAA,GAAA,IAAA,aAAA,0BAAA,QAAA,CAAA,CAAA,KAAA,QAAA,CAAA,KAAA,IAAA,CAAA;;EAE9C,IAAA,WAAA;AACA,UAAQ;IAAA,gBAAmB,cAAgB;AAErC,YAAS,GAAC,QAAA,YAAc,QAAA,QAAsB,GAAA,CAAA;OAEpD,CAAM;IAAC,gBAAA,OAAA,EAAA,CAAA;IAAA,gBAAA,YAAA,EACJ,IAAA,WAAA;AACE,YAAA,QAAA;OAEA,CAAC;IAAE,gBAAc,YAAA;KAChB,MAAI;KACJ,UAAU;KACX,CAAC;IAAC;;EAEN,CAAC,EAAE,gBAAiB,qBAAkB;EACrC,UAAK;EACL,OAAK;EACL,MAAK;EACL,YAAK,CAAA;GACH,MAAE;GACF,MAAC;GACD,SAAE;GACH,CAAC;EACF,IAAI,WAAM;AACR,UAAE;IAAA,gBAAsB,SAAW,EAAE,CAAC;IAAA;IAAW,gBAAmB,SAAK,EAAA,CAAA;IAAA,gBAAA,MAAA;KACvE,IAAC,OAAS;AACT,aAAQ,QAAA,OAAA;;KAET,UAAU;KACX,CAAC;IAAC,gBAAS,SAAA,EAAA,CAAA;IAAA,IAAA;IAAA;;EAEf,CAAC,CAAC;;;;;AASL,SAAW,oBAAW,OAAA;CACtB,MAAA,WAEE,SACC,gBACD,GAAA,SACI;CACJ,MAAM,UAAU,eAAoC;;AAEpD,QAAM,CAAA,gBAAU,gBAAc,WAAsB,MAAA;EACpD,IAAM,OAAA;AACJ,UAAS,SAAA;;EAET,IAAE,UAAQ;AACR,UAAG,KAAO,WAAY,EAAA,EAAA,OAAA,QAAoB,QAAQ,SAAC,CAAA,QAAA,GAAA,WAAA,MAAA,UAAA,CAAA,QAAA,KAAA,CAAA,MAAA,WAAA;AACjD,QAAC,KAAQ,MAAC,UAAA,CAAA;KACX,MAAQ;KACX,OAAA,SAAA,WAAA,KAAA;KACD,CAAA;;MAEM,EAAA,CAAA,CAAA;;EAEL,IAAG,iBAAA;AACD,UAAM,KAAI,kBAAA,EAAA,EAAA;IACR,KAAK,CAAC,iBAAc,UAAA;IACpB,SAAS;KAAA;KAAI;KAAA;KAAA;KAAA;IACb,OAAE;KAAA;KAAa;KAAA;KAAA;KAAA;KAAA;KAAA;KACd,UAAQ,QAAQ,GAAA,QAAQ,SAAQ,QAAA,YAAA,CAAA,qBAAA,QAAA,CAAA,CAAA,GAAA,CAAA,WAAA;IAClC,CAAC;;EAEJ,IAAI,WAAW;AACb,UAAO;IAAC,gBAAkB,2BAAmB,EACpC;;;KAED;KACN,QAAQ,IAAI;KACZ,IAAC,WAAA;AACD,aAAA,gBAAqB,eAAqB;OACxC,IAAM,WAAC;AACP,eAAW,QAAQ;;OAEjB,IAAC,WAAO;AACP,eAAQ,QAAA;;OAEV,CAAC;;KAEL,CAAC;IAAC;;EAEN,CAAC,CAAC,EAAE,gBAAa,KAAA;EAChB,IAAI,OAAK;AACP,UAAO,OAAE,OAAQ,QAAS,SAAM;;EAElC,WAAQ,UAAA,gBAAA,MAAA;GACN,IAAI,OAAM;AACR,WAAG,MAAA;;GAEL,IAAG,WAAS;AACV,WAAC,gBAAA,cAAA,EACC,SAAS,OACV,CAAC;;GAEJ,IAAI,WAAW;AACb,WAAI,gBAAkB,qBAAQ,EAC5B,SAAC,OACF,CAAC;;GAEL,CAAC;EACH,CAAC,CAAC"}
+{"version":3,"file":"virtual-command-entry.mjs","names":[],"sources":["../../src/components/virtual-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 { FunctionDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } 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 { TypescriptFile } from \"@powerlines/plugin-alloy/typescript/components/typescript-file\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\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 { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\n\nexport interface VirtualCommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function VirtualCommandHandlerDeclaration(\n  props: VirtualCommandHandlerDeclarationProps\n) {\n  const { command, children, banner } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) virtual 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: \"useArgs()\" }]}>\n        <Spacing />\n        {children}\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        {code`return showHelp(); `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface VirtualCommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The virtual command entry point for the Shell Shock project.\n */\nexport function VirtualCommandEntry(props: VirtualCommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      context.entryPath,\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n\n  return (\n    <>\n      <TypescriptFile\n        {...rest}\n        path={filePath.value}\n        imports={defu(\n          imports ?? {},\n          Object.entries(command.children)\n            .filter(([, child]) => child.isVirtual)\n            .reduce((ret, [name, child]) => {\n              ret[`./${child.name}`] = [\n                { name: \"handler\", alias: `handle${pascalCase(name)}` }\n              ];\n\n              return ret;\n            }, {} as TypescriptFileImports)\n        )}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"isDevelopment\", \"isDebug\"],\n          console: [\"warn\", \"error\", \"colors\", \"writeLine\"],\n          utils: [\n            \"useApp\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"findSuggestions\"\n          ],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"],\n          [joinPaths(\n            \"banner\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showBanner\"]\n        })}>\n        <Spacing />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\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/index.cjs

@@ -1,12 +1,10 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_index = require('./plugin-help/dist/index.cjs');
-const require_components_banner_function_declaration = require('./components/banner-function-declaration.cjs');
 const require_components_bin_entry = require('./components/bin-entry.cjs');
 const require_components_command_router = require('./components/command-router.cjs');
 const require_components_virtual_command_entry = require('./components/virtual-command-entry.cjs');
 const require_components_command_entry = require('./components/command-entry.cjs');
-require('./components/index.cjs');
 const require_helpers_get_default_options = require('./helpers/get-default-options.cjs');
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let _alloy_js_core = require("@alloy-js/core");
@@ -58,9 +56,6 @@ const plugin = (options = {}) => {
 								"isMinimal"
 							]
 						},
-						get prefix() {
-							return [(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_banner_function_declaration.BannerFunctionDeclaration, {}), (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components.Spacing, {})];
-						},
 						get children() {
 							return [
 								(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
@@ -87,7 +82,7 @@ const plugin = (options = {}) => {
 									}
 								}),
 								(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components.Spacing, {}),
-								_alloy_js_core.code`banner();`,
+								_alloy_js_core.code`await showBanner();`,
 								(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components.Spacing, {}),
 								_alloy_js_core.code`return showHelp();`
 							];

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.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, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport type { Plugin } from \"powerlines\";\nimport { BannerFunctionDeclaration } from \"./components\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    console(options),\n    ...help(options),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"colors\",\n                    \"help\"\n                  ],\n                  utils: [\"useApp\", \"useArgs\", \"isMinimal\"]\n                }}\n                prefix={\n                  <>\n                    <BannerFunctionDeclaration />\n                    <Spacing />\n                  </>\n                }>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <Spacing />\n                {code`banner();`}\n                <Spacing />\n                {code`return showHelp();`}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;2CAAA,QAAA;EAAA,GAAA,qBAAA,QAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACL,WAAQ;KACL,gBAAa;KAChB,iBAAA;KACE,GAAK;KACL;;GAEH;EAAE;GACD,MAAK;;IAEH,OAAE;IACF,MAAI,UAAA;KACF,MAAE,SAAA;AACF,UAAK,MAAA,oEAAA;AACL,wDAAC,MAAA,iDAAA,uCAAA;MACH,gBAAA;OACD,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA;QAAA;QAAA;QAAA;QAAA;OACO;MACL,IAAQ,SAAC;AACP,cAAQ,iDAAK,0EAAA,EAAA,CAAA,kDAAA,kDAAA,EAAA,CAAA,CAAA;;MAEX,IAAI,WAAM;AACR,cAAC;wDAAqB,qBAAQ;SAC/B,IAAA,OAAA;;;SAGC,IAAI,WAAA;AACH,iBAAA;2DAAA,qCAAA;YACE,SAAA;YACC,MAAA;YACE,MAAA;YACA,aAAW,mBAAA;YACZ,CAAC;2DAAa,OAAA,EAAA,CAAA;2DAAA,iDAAA;YACb,UAAG,EAAS;YACZ,IAAG,WAAU;AACX,oBAAO,OAAC,YAAA,EAAA;;YAEX,CAAC;2DAAC,OAAA,EAAA,CAAA;WAAA;;SAEN,CAAC;wDAAG,kDAAA,EAAA,CAAA;QAAA,mBAAA;wDAAA,kDAAA,EAAA,CAAA;QAAA,mBAAA;QAAA;;MAER,CAAC,kDAAS,qBAAA;MACT,IAAI,OAAO;AACT,cAAO,OAAE,OAAS,OAAA,SAAA,CAAA,SAAA;;MAEpB,IAAI,WAAG;AACL,8DAAuB,oBAAK;QAC1B,IAAI,OAAC;AACH,gBAAI,OAAA,OAAA,OAAA,SAAA;;QAEN,gBAAY;QACZ,WAAM,0DAA6B,qBAAA;SACjC,IAAG,OAAA;AACD,iBAAM,MAAA;;SAER,IAAG,WAAK;AACN,iEAAI,+CAAA,EACL,SAAS,OACT,CAAA;;SAED,IAAC,WAAY;AACb,iEAAQ,8DAAA,EACJ,SAAM,OACT,CAAG;;SAEL,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.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, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport type { Plugin } from \"powerlines\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    console(options),\n    ...help(options),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"colors\",\n                    \"help\"\n                  ],\n                  utils: [\"useApp\", \"useArgs\", \"isMinimal\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <Spacing />\n                {code`await showBanner();`}\n                <Spacing />\n                {code`return showHelp();`}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;2CAAA,QAAA;EAAA,GAAA,qBAAA,QAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACL,WAAQ;KACL,gBAAa;KAChB,iBAAA;KACE,GAAK;KACL;;GAEH;EAAE;GACD,MAAK;;IAEH,OAAE;IACF,MAAI,UAAA;KACF,MAAE,SAAA;AACF,UAAK,MAAA,oEAAA;AACL,wDAAC,MAAA,iDAAA,uCAAA;MACH,gBAAA;OACD,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA;QAAA;QAAA;QAAA;QAAA;OACO;MACL,IAAQ,WAAC;AACP,cAAQ;wDAAK,qBAAA;SACP,IAAA,OAAU;AACT,iBAAK,OAAA,KAAA,OAAA,SAAA,CAAA,SAAA;;SAET,IAAA,WAAA;;;YAEM,SAAM;YACP,MAAA;YACH,MAAA;YACE,aAAA,mBAAA;YACC,CAAA;2DAAgB,OAAA,EAAA,CAAA;2DAAA,iDAAA;YACd,UAAS,EAAA;YACT,IAAG,WAAQ;AACT,oBAAC,OAAU,YAAA,EAAA;;YAEd,CAAC;2DAAa,OAAA,EAAA,CAAA;WAAA;;SAElB,CAAC;wDAAW,kDAAA,EAAA,CAAA;QAAA,mBAAA;wDAAA,kDAAA,EAAA,CAAA;QAAA,mBAAA;QAAA;;MAEhB,CAAC,kDAAiB,qBAAS;MAC1B,IAAI,OAAI;AACN,cAAK,OAAS,OAAE,OAAY,SAAK,CAAA,SAAU;;MAE7C,IAAI,WAAM;AACR,8DAAkB,oBAAA;QAChB,IAAI,OAAO;AACT,gBAAI,OAAA,OAAiB,OAAC,SAAW;;QAEnC,gBAAU;QACV,WAAK,0DAA4B,qBAAU;SACzC,IAAG,OAAK;AACN,iBAAI,MAAA;;SAEN,IAAC,WAAW;AACX,iEAAS,+CAAA,EACT,SAAY,OACb,CAAA;;SAEA,IAAI,WAAO;AACT,iEAAU,8DAAA,EACR,SAAC,OACF,CAAC;;SAEL,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAoCA;cAAa,MAAA,oBACM,mBAAA,GAAsB,mBAAA,EAEvC,OAAA,GAAS,mBAAA,KAiFJ,MAAA,CAAO,QAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAmCA;cAAa,MAAA,oBACM,mBAAA,GAAsB,mBAAA,EAEvC,OAAA,GAAS,mBAAA,KA2EJ,MAAA,CAAO,QAAA"}

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAoCA;cAAa,MAAA,oBACM,mBAAA,GAAsB,mBAAA,EAEvC,OAAA,GAAS,mBAAA,KAiFJ,MAAA,CAAO,QAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAmCA;cAAa,MAAA,oBACM,mBAAA,GAAsB,mBAAA,EAEvC,OAAA,GAAS,mBAAA,KA2EJ,MAAA,CAAO,QAAA"}

package/dist/index.mjs

@@ -1,10 +1,8 @@
 import { plugin as plugin$1 } from "./plugin-help/dist/index.mjs";
-import { BannerFunctionDeclaration } from "./components/banner-function-declaration.mjs";
 import { BinEntry } from "./components/bin-entry.mjs";
 import { CommandRouter } from "./components/command-router.mjs";
 import { VirtualCommandEntry } from "./components/virtual-command-entry.mjs";
 import { CommandEntry } from "./components/command-entry.mjs";
-import "./components/index.mjs";
 import { getDefaultOptions } from "./helpers/get-default-options.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code } from "@alloy-js/core";
@@ -55,9 +53,6 @@ const plugin = (options = {}) => {
 								"isMinimal"
 							]
 						},
-						get prefix() {
-							return [createComponent(BannerFunctionDeclaration, {}), createComponent(Spacing, {})];
-						},
 						get children() {
 							return [
 								createComponent(Show, {
@@ -84,7 +79,7 @@ const plugin = (options = {}) => {
 									}
 								}),
 								createComponent(Spacing, {}),
-								code`banner();`,
+								code`await showBanner();`,
 								createComponent(Spacing, {}),
 								code`return showHelp();`
 							];

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.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, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport type { Plugin } from \"powerlines\";\nimport { BannerFunctionDeclaration } from \"./components\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    console(options),\n    ...help(options),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"colors\",\n                    \"help\"\n                  ],\n                  utils: [\"useApp\", \"useArgs\", \"isMinimal\"]\n                }}\n                prefix={\n                  <>\n                    <BannerFunctionDeclaration />\n                    <Spacing />\n                  </>\n                }>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <Spacing />\n                {code`banner();`}\n                <Spacing />\n                {code`return showHelp();`}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;EAAA,QAAA,QAAA;EAAA,GAAA,SAAA,QAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACL,WAAQ;KACL,gBAAa;KAChB,iBAAA;KACE,GAAK;KACL;;GAEH;EAAE;GACD,MAAK;;IAEH,OAAE;IACF,MAAI,UAAA;KACF,MAAE,SAAA;AACF,UAAK,MAAA,oEAAA;AACL,YAAC,OAAA,MAAA,CAAA,gBAAA,UAAA;MACH,gBAAA;OACD,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA;QAAA;QAAA;QAAA;QAAA;OACO;MACL,IAAQ,SAAC;AACP,cAAQ,CAAI,gBAAC,2BAAA,EAAA,CAAA,EAAA,gBAAA,SAAA,EAAA,CAAA,CAAA;;MAEX,IAAI,WAAM;AACR,cAAC;QAAA,gBAAqB,MAAQ;SAC/B,IAAA,OAAA;;;SAGC,IAAI,WAAA;AACH,iBAAA;WAAA,gBAAA,gBAAA;YACE,SAAA;YACC,MAAA;YACE,MAAA;YACA,aAAW,IAAA;YACZ,CAAC;WAAE,gBAAW,OAAA,EAAA,CAAA;WAAA,gBAAA,eAAA;YACb,UAAG,EAAS;YACZ,IAAG,WAAU;AACX,oBAAO,OAAC,YAAA,EAAA;;YAEX,CAAC;WAAC,gBAAA,OAAA,EAAA,CAAA;WAAA;;SAEN,CAAC;QAAE,gBAAC,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA,gBAAA,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA;;MAER,CAAC,EAAE,gBAAO,MAAA;MACT,IAAI,OAAO;AACT,cAAO,OAAE,OAAS,OAAA,SAAA,CAAA,SAAA;;MAEpB,IAAI,WAAG;AACL,cAAK,gBAAkB,KAAK;QAC1B,IAAI,OAAC;AACH,gBAAI,OAAA,OAAA,OAAA,SAAA;;QAEN,gBAAY;QACZ,WAAM,UAAa,gBAAgB,MAAA;SACjC,IAAG,OAAA;AACD,iBAAM,MAAA;;SAER,IAAG,WAAK;AACN,iBAAI,gBAAA,cAAA,EACL,SAAS,OACT,CAAA;;SAED,IAAC,WAAY;AACb,iBAAQ,gBAAA,qBAAA,EACJ,SAAM,OACT,CAAG;;SAEL,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.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, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport type { Plugin } from \"powerlines\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    console(options),\n    ...help(options),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"colors\",\n                    \"help\"\n                  ],\n                  utils: [\"useApp\", \"useArgs\", \"isMinimal\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <Spacing />\n                {code`await showBanner();`}\n                <Spacing />\n                {code`return showHelp();`}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;AAoCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;EAAA,QAAA,QAAA;EAAA,GAAA,SAAA,QAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACL,WAAQ;KACL,gBAAa;KAChB,iBAAA;KACE,GAAK;KACL;;GAEH;EAAE;GACD,MAAK;;IAEH,OAAE;IACF,MAAI,UAAA;KACF,MAAE,SAAA;AACF,UAAK,MAAA,oEAAA;AACL,YAAC,OAAA,MAAA,CAAA,gBAAA,UAAA;MACH,gBAAA;OACD,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA;QAAA;QAAA;QAAA;QAAA;OACO;MACL,IAAQ,WAAC;AACP,cAAQ;QAAI,gBAAC,MAAA;SACP,IAAA,OAAU;AACT,iBAAK,OAAA,KAAA,OAAA,SAAA,CAAA,SAAA;;SAET,IAAA,WAAA;;;YAEM,SAAM;YACP,MAAA;YACH,MAAA;YACE,aAAA,IAAA;YACC,CAAA;WAAA,gBAAgB,OAAA,EAAA,CAAA;WAAA,gBAAA,eAAA;YACd,UAAS,EAAA;YACT,IAAG,WAAQ;AACT,oBAAC,OAAU,YAAA,EAAA;;YAEd,CAAC;WAAE,gBAAW,OAAA,EAAA,CAAA;WAAA;;SAElB,CAAC;QAAE,gBAAS,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA,gBAAA,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA;;MAEhB,CAAC,EAAE,gBAAe,MAAS;MAC1B,IAAI,OAAI;AACN,cAAK,OAAS,OAAE,OAAY,SAAK,CAAA,SAAU;;MAE7C,IAAI,WAAM;AACR,cAAO,gBAAW,KAAA;QAChB,IAAI,OAAO;AACT,gBAAI,OAAA,OAAiB,OAAC,SAAW;;QAEnC,gBAAU;QACV,WAAK,UAAc,gBAAc,MAAU;SACzC,IAAG,OAAK;AACN,iBAAI,MAAA;;SAEN,IAAC,WAAW;AACX,iBAAQ,gBAAC,cAAA,EACT,SAAY,OACb,CAAA;;SAEA,IAAI,WAAO;AACT,iBAAO,gBAAG,qBAAA,EACR,SAAC,OACF,CAAC;;SAEL,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}

package/dist/plugin-help/dist/components/display.cjs

@@ -1,6 +1,7 @@
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_kebab_case = require('../node_modules/.pnpm/@stryke_string-format@0.17.4/node_modules/@stryke/string-format/dist/kebab-case.cjs');
-const require_snake_case = require('../node_modules/.pnpm/@stryke_string-format@0.17.4/node_modules/@stryke/string-format/dist/snake-case.cjs');
+const require_is_set_string = require('../node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.cjs');
+const require_kebab_case = require('../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.cjs');
+const require_snake_case = require('../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.cjs');
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let _alloy_js_core = require("@alloy-js/core");
 let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
@@ -140,6 +141,19 @@ function BaseHelpDisplay(props) {
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
 				];
 			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return require_is_set_string.isSetString(command.reference);
+			},
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine("");
+      writeLine(colors.text.heading.tertiary(\`More information about this command can be found in the reference documentation at ${command.reference}\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
+				];
+			}
 		})
 	];
 }

package/dist/plugin-help/dist/components/display.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"display.cjs","names":["For","snakeCase","CommandParameterKinds","Show","kebabCase","Spacing"],"sources":["../../../../../plugin-help/dist/components/display.mjs"],"sourcesContent":["import { kebabCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.4/node_modules/@stryke/string-format/dist/kebab-case.mjs\";\nimport { snakeCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.4/node_modules/@stryke/string-format/dist/snake-case.mjs\";\nimport { createComponent, createIntrinsic, memo } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, code, computed } from \"@alloy-js/core\";\nimport { formatDescription, formatShortDescription, getAppBin, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from \"@shell-shock/core/plugin-utils\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\n\n//#region src/components/display.tsx\n/**\n* A component that generates the usage display for a command.\n*/\nfunction HelpUsageDisplay(props) {\n\tconst { command, indent = 2 } = props;\n\tconst context = usePowerlines();\n\tconst theme = useTheme();\n\treturn [createComponent(For, {\n\t\tget each() {\n\t\t\treturn Object.keys(context.config.bin);\n\t\t},\n\t\thardline: true,\n\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t}), createComponent(Show, {\n\t\tget when() {\n\t\t\treturn command.args.length > 0;\n\t\t},\n\t\tget children() {\n\t\t\treturn [createIntrinsic(\"hbr\", {}), createComponent(For, {\n\t\t\t\tget each() {\n\t\t\t\t\treturn Object.keys(context.config.bin);\n\t\t\t\t},\n\t\t\t\thardline: true,\n\t\t\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t\t\t})];\n\t\t}\n\t})];\n}\n/**\n* A component that generates the options table display for a command.\n*/\nfunction HelpOptionsDisplay(props) {\n\tconst { options } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn sortOptions(options);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (option) => {\n\t\t\t\tconst flags = [];\n\t\t\t\tconst names = [];\n\t\t\t\tif (option.name.length === 1) flags.push(`-${option.name}`);\n\t\t\t\telse names.push(`--${kebabCase(option.name)}`);\n\t\t\t\toption.alias.forEach((alias) => {\n\t\t\t\t\tif (alias.length === 1) flags.push(`-${alias}`);\n\t\t\t\t\telse names.push(`--${kebabCase(alias)}`);\n\t\t\t\t});\n\t\t\t\treturn code`[{ value: colors.text.body.primary(\"${flags.length > 0 ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}` : \"\"}${names.length > 0 ? names.sort().join(\", \") : \"\"}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.format ? option.format : option.name)}${option.variadic ? \"...\" : \"\"}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.name)}${option.variadic ? \"...\" : \"\"}>` : \"\"}\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(option.description).replace(/\\.+$/, \"\").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? \", \" : \"\"}` : \"\"}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/\"/g, \"\\\\\\\"\")}` : \"\"})` : \"\"}.\\`), align: \"left\", border: \"none\" }], `;\n\t\t\t}\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the commands table display for a command.\n*/\nfunction HelpCommandsDisplay(props) {\n\tconst { commands } = props;\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn Object.values(commands);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (child) => code`[{ value: colors.text.body.primary(\"${child.name}\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`), align: \"left\", border: \"none\" }], `\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the `help` function declaration for a command.\n*/\nfunction BaseHelpDisplay(props) {\n\tconst { command, indent = 1, filterGlobalOptions = false } = props;\n\tconst theme = useTheme();\n\tconst context = usePowerlines();\n\tconst options = 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));\n\treturn [\n\t\tmemo(() => code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpUsageDisplay, {\n\t\t\tcommand,\n\t\t\tindent\n\t\t}),\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn options.value.length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpOptionsDisplay, { get options() {\n\t\t\t\t\t\treturn options.value;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpCommandsDisplay, { get commands() {\n\t\t\t\t\t\treturn command.children;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction VirtualCommandHelpDisplay(props) {\n\tconst { options, segments, commands } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpOptionsDisplay, { options }),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(commands).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(colors.text.body.secondary(\"The following commands are available through the ${getAppTitle(context, true)} command-line interface:\"));\n        writeLine(\"\"); `),\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(commands);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)}${segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction CommandHelpDisplay(props) {\n\tconst { command } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\tcommand,\n\t\t\tfilterGlobalOptions: false\n\t\t}),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tcode`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `,\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(command.children);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)} ${command.segments.join(\" \")} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n\n//#endregion\nexport { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay };\n//# sourceMappingURL=display.mjs.map"],"mappings":"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"}
+{"version":3,"file":"display.cjs","names":["For","snakeCase","CommandParameterKinds","Show","kebabCase","Spacing","isSetString"],"sources":["../../../../../plugin-help/dist/components/display.mjs"],"sourcesContent":["import { isSetString } from \"../node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs\";\nimport { kebabCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs\";\nimport { snakeCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.mjs\";\nimport { createComponent, createIntrinsic, memo } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, code, computed } from \"@alloy-js/core\";\nimport { formatDescription, formatShortDescription, getAppBin, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from \"@shell-shock/core/plugin-utils\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\n\n//#region src/components/display.tsx\n/**\n* A component that generates the usage display for a command.\n*/\nfunction HelpUsageDisplay(props) {\n\tconst { command, indent = 2 } = props;\n\tconst context = usePowerlines();\n\tconst theme = useTheme();\n\treturn [createComponent(For, {\n\t\tget each() {\n\t\t\treturn Object.keys(context.config.bin);\n\t\t},\n\t\thardline: true,\n\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t}), createComponent(Show, {\n\t\tget when() {\n\t\t\treturn command.args.length > 0;\n\t\t},\n\t\tget children() {\n\t\t\treturn [createIntrinsic(\"hbr\", {}), createComponent(For, {\n\t\t\t\tget each() {\n\t\t\t\t\treturn Object.keys(context.config.bin);\n\t\t\t\t},\n\t\t\t\thardline: true,\n\t\t\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t\t\t})];\n\t\t}\n\t})];\n}\n/**\n* A component that generates the options table display for a command.\n*/\nfunction HelpOptionsDisplay(props) {\n\tconst { options } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn sortOptions(options);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (option) => {\n\t\t\t\tconst flags = [];\n\t\t\t\tconst names = [];\n\t\t\t\tif (option.name.length === 1) flags.push(`-${option.name}`);\n\t\t\t\telse names.push(`--${kebabCase(option.name)}`);\n\t\t\t\toption.alias.forEach((alias) => {\n\t\t\t\t\tif (alias.length === 1) flags.push(`-${alias}`);\n\t\t\t\t\telse names.push(`--${kebabCase(alias)}`);\n\t\t\t\t});\n\t\t\t\treturn code`[{ value: colors.text.body.primary(\"${flags.length > 0 ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}` : \"\"}${names.length > 0 ? names.sort().join(\", \") : \"\"}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.format ? option.format : option.name)}${option.variadic ? \"...\" : \"\"}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.name)}${option.variadic ? \"...\" : \"\"}>` : \"\"}\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(option.description).replace(/\\.+$/, \"\").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? \", \" : \"\"}` : \"\"}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/\"/g, \"\\\\\\\"\")}` : \"\"})` : \"\"}.\\`), align: \"left\", border: \"none\" }], `;\n\t\t\t}\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the commands table display for a command.\n*/\nfunction HelpCommandsDisplay(props) {\n\tconst { commands } = props;\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn Object.values(commands);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (child) => code`[{ value: colors.text.body.primary(\"${child.name}\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`), align: \"left\", border: \"none\" }], `\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the `help` function declaration for a command.\n*/\nfunction BaseHelpDisplay(props) {\n\tconst { command, indent = 1, filterGlobalOptions = false } = props;\n\tconst theme = useTheme();\n\tconst context = usePowerlines();\n\tconst options = 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));\n\treturn [\n\t\tmemo(() => code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpUsageDisplay, {\n\t\t\tcommand,\n\t\t\tindent\n\t\t}),\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn options.value.length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpOptionsDisplay, { get options() {\n\t\t\t\t\t\treturn options.value;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpCommandsDisplay, { get commands() {\n\t\t\t\t\t\treturn command.children;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn isSetString(command.reference);\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.text.heading.tertiary(\\`More information about this command can be found in the reference documentation at ${command.reference}\\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction VirtualCommandHelpDisplay(props) {\n\tconst { options, segments, commands } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpOptionsDisplay, { options }),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(commands).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(colors.text.body.secondary(\"The following commands are available through the ${getAppTitle(context, true)} command-line interface:\"));\n        writeLine(\"\"); `),\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(commands);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)}${segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction CommandHelpDisplay(props) {\n\tconst { command } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\tcommand,\n\t\t\tfilterGlobalOptions: false\n\t\t}),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tcode`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `,\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(command.children);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)} ${command.segments.join(\" \")} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n\n//#endregion\nexport { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay };\n//# sourceMappingURL=display.mjs.map"],"mappings":"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"}

package/dist/plugin-help/dist/components/display.mjs

@@ -1,5 +1,6 @@
-import { kebabCase } from "../node_modules/.pnpm/@stryke_string-format@0.17.4/node_modules/@stryke/string-format/dist/kebab-case.mjs";
-import { snakeCase } from "../node_modules/.pnpm/@stryke_string-format@0.17.4/node_modules/@stryke/string-format/dist/snake-case.mjs";
+import { isSetString } from "../node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs";
+import { kebabCase } from "../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs";
+import { snakeCase } from "../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code, computed } from "@alloy-js/core";
 import { formatDescription, formatShortDescription, getAppBin, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from "@shell-shock/core/plugin-utils";
@@ -139,6 +140,19 @@ function BaseHelpDisplay(props) {
 					createComponent(Spacing, {})
 				];
 			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return isSetString(command.reference);
+			},
+			get children() {
+				return [
+					memo(() => code`writeLine("");
+      writeLine(colors.text.heading.tertiary(\`More information about this command can be found in the reference documentation at ${command.reference}\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : ""});`),
+					createIntrinsic("hbr", {}),
+					createComponent(Spacing, {})
+				];
+			}
 		})
 	];
 }

package/dist/plugin-help/dist/components/display.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"display.mjs","names":[],"sources":["../../../../../plugin-help/dist/components/display.mjs"],"sourcesContent":["import { kebabCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.4/node_modules/@stryke/string-format/dist/kebab-case.mjs\";\nimport { snakeCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.4/node_modules/@stryke/string-format/dist/snake-case.mjs\";\nimport { createComponent, createIntrinsic, memo } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, code, computed } from \"@alloy-js/core\";\nimport { formatDescription, formatShortDescription, getAppBin, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from \"@shell-shock/core/plugin-utils\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\n\n//#region src/components/display.tsx\n/**\n* A component that generates the usage display for a command.\n*/\nfunction HelpUsageDisplay(props) {\n\tconst { command, indent = 2 } = props;\n\tconst context = usePowerlines();\n\tconst theme = useTheme();\n\treturn [createComponent(For, {\n\t\tget each() {\n\t\t\treturn Object.keys(context.config.bin);\n\t\t},\n\t\thardline: true,\n\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t}), createComponent(Show, {\n\t\tget when() {\n\t\t\treturn command.args.length > 0;\n\t\t},\n\t\tget children() {\n\t\t\treturn [createIntrinsic(\"hbr\", {}), createComponent(For, {\n\t\t\t\tget each() {\n\t\t\t\t\treturn Object.keys(context.config.bin);\n\t\t\t\t},\n\t\t\t\thardline: true,\n\t\t\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t\t\t})];\n\t\t}\n\t})];\n}\n/**\n* A component that generates the options table display for a command.\n*/\nfunction HelpOptionsDisplay(props) {\n\tconst { options } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn sortOptions(options);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (option) => {\n\t\t\t\tconst flags = [];\n\t\t\t\tconst names = [];\n\t\t\t\tif (option.name.length === 1) flags.push(`-${option.name}`);\n\t\t\t\telse names.push(`--${kebabCase(option.name)}`);\n\t\t\t\toption.alias.forEach((alias) => {\n\t\t\t\t\tif (alias.length === 1) flags.push(`-${alias}`);\n\t\t\t\t\telse names.push(`--${kebabCase(alias)}`);\n\t\t\t\t});\n\t\t\t\treturn code`[{ value: colors.text.body.primary(\"${flags.length > 0 ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}` : \"\"}${names.length > 0 ? names.sort().join(\", \") : \"\"}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.format ? option.format : option.name)}${option.variadic ? \"...\" : \"\"}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.name)}${option.variadic ? \"...\" : \"\"}>` : \"\"}\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(option.description).replace(/\\.+$/, \"\").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? \", \" : \"\"}` : \"\"}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/\"/g, \"\\\\\\\"\")}` : \"\"})` : \"\"}.\\`), align: \"left\", border: \"none\" }], `;\n\t\t\t}\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the commands table display for a command.\n*/\nfunction HelpCommandsDisplay(props) {\n\tconst { commands } = props;\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn Object.values(commands);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (child) => code`[{ value: colors.text.body.primary(\"${child.name}\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`), align: \"left\", border: \"none\" }], `\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the `help` function declaration for a command.\n*/\nfunction BaseHelpDisplay(props) {\n\tconst { command, indent = 1, filterGlobalOptions = false } = props;\n\tconst theme = useTheme();\n\tconst context = usePowerlines();\n\tconst options = 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));\n\treturn [\n\t\tmemo(() => code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpUsageDisplay, {\n\t\t\tcommand,\n\t\t\tindent\n\t\t}),\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn options.value.length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpOptionsDisplay, { get options() {\n\t\t\t\t\t\treturn options.value;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpCommandsDisplay, { get commands() {\n\t\t\t\t\t\treturn command.children;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction VirtualCommandHelpDisplay(props) {\n\tconst { options, segments, commands } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpOptionsDisplay, { options }),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(commands).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(colors.text.body.secondary(\"The following commands are available through the ${getAppTitle(context, true)} command-line interface:\"));\n        writeLine(\"\"); `),\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(commands);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)}${segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction CommandHelpDisplay(props) {\n\tconst { command } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\tcommand,\n\t\t\tfilterGlobalOptions: false\n\t\t}),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tcode`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `,\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(command.children);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)} ${command.segments.join(\" \")} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n\n//#endregion\nexport { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay };\n//# sourceMappingURL=display.mjs.map"],"mappings":"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"}
+{"version":3,"file":"display.mjs","names":[],"sources":["../../../../../plugin-help/dist/components/display.mjs"],"sourcesContent":["import { isSetString } from \"../node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs\";\nimport { kebabCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs\";\nimport { snakeCase } from \"../node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.mjs\";\nimport { createComponent, createIntrinsic, memo } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, code, computed } from \"@alloy-js/core\";\nimport { formatDescription, formatShortDescription, getAppBin, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from \"@shell-shock/core/plugin-utils\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\n\n//#region src/components/display.tsx\n/**\n* A component that generates the usage display for a command.\n*/\nfunction HelpUsageDisplay(props) {\n\tconst { command, indent = 2 } = props;\n\tconst context = usePowerlines();\n\tconst theme = useTheme();\n\treturn [createComponent(For, {\n\t\tget each() {\n\t\t\treturn Object.keys(context.config.bin);\n\t\t},\n\t\thardline: true,\n\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t}), createComponent(Show, {\n\t\tget when() {\n\t\t\treturn command.args.length > 0;\n\t\t},\n\t\tget children() {\n\t\t\treturn [createIntrinsic(\"hbr\", {}), createComponent(For, {\n\t\t\t\tget each() {\n\t\t\t\t\treturn Object.keys(context.config.bin);\n\t\t\t\t},\n\t\t\t\thardline: true,\n\t\t\t\tchildren: (bin) => [memo(() => code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}\")}`).join(\" \")}` : \"\"}${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\\${colors.text.usage.args(\"<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join(\"|\") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? \"...\" : \"\"}>\")}`).join(\" \")}` : \"\"}\\`), { padding: ${theme.padding.app * indent} }\n      );`), createIntrinsic(\"hbr\", {})]\n\t\t\t})];\n\t\t}\n\t})];\n}\n/**\n* A component that generates the options table display for a command.\n*/\nfunction HelpOptionsDisplay(props) {\n\tconst { options } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn sortOptions(options);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (option) => {\n\t\t\t\tconst flags = [];\n\t\t\t\tconst names = [];\n\t\t\t\tif (option.name.length === 1) flags.push(`-${option.name}`);\n\t\t\t\telse names.push(`--${kebabCase(option.name)}`);\n\t\t\t\toption.alias.forEach((alias) => {\n\t\t\t\t\tif (alias.length === 1) flags.push(`-${alias}`);\n\t\t\t\t\telse names.push(`--${kebabCase(alias)}`);\n\t\t\t\t});\n\t\t\t\treturn code`[{ value: colors.text.body.primary(\"${flags.length > 0 ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}` : \"\"}${names.length > 0 ? names.sort().join(\", \") : \"\"}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.format ? option.format : option.name)}${option.variadic ? \"...\" : \"\"}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join(\"|\") : option.name)}${option.variadic ? \"...\" : \"\"}>` : \"\"}\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(option.description).replace(/\\.+$/, \"\").trim()}${option.env || option.default !== void 0 ? ` (${option.env ? `env: ${context.config.appSpecificEnvPrefix}_${option.env}${option.default !== void 0 ? \", \" : \"\"}` : \"\"}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/\"/g, \"\\\\\\\"\")}` : \"\"})` : \"\"}.\\`), align: \"left\", border: \"none\" }], `;\n\t\t\t}\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the commands table display for a command.\n*/\nfunction HelpCommandsDisplay(props) {\n\tconst { commands } = props;\n\treturn [\n\t\tcode`table([ `,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(For, {\n\t\t\tget each() {\n\t\t\t\treturn Object.values(commands);\n\t\t\t},\n\t\t\thardline: true,\n\t\t\tchildren: (child) => code`[{ value: colors.text.body.primary(\"${child.name}\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\\`${formatShortDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`), align: \"left\", border: \"none\" }], `\n\t\t}),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode` ]); `\n\t];\n}\n/**\n* A component that generates the `help` function declaration for a command.\n*/\nfunction BaseHelpDisplay(props) {\n\tconst { command, indent = 1, filterGlobalOptions = false } = props;\n\tconst theme = useTheme();\n\tconst context = usePowerlines();\n\tconst options = 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));\n\treturn [\n\t\tmemo(() => code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpUsageDisplay, {\n\t\t\tcommand,\n\t\t\tindent\n\t\t}),\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn options.value.length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpOptionsDisplay, { get options() {\n\t\t\t\t\t\treturn options.value;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(HelpCommandsDisplay, { get commands() {\n\t\t\t\t\t\treturn command.children;\n\t\t\t\t\t} }),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn isSetString(command.reference);\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(\"\");\n      writeLine(colors.text.heading.tertiary(\\`More information about this command can be found in the reference documentation at ${command.reference}\\`)${indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"});`),\n\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\tcreateComponent(Spacing, {})\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction VirtualCommandHelpDisplay(props) {\n\tconst { options, segments, commands } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcode`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`,\n\t\tcreateIntrinsic(\"hbr\", {}),\n\t\tcreateComponent(HelpOptionsDisplay, { options }),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(commands).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tmemo(() => code`writeLine(colors.text.body.secondary(\"The following commands are available through the ${getAppTitle(context, true)} command-line interface:\"));\n        writeLine(\"\"); `),\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(commands);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)}${segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n/**\n* A component that generates the invocation of the `help` function for a command.\n*/\nfunction CommandHelpDisplay(props) {\n\tconst { command } = props;\n\tconst context = usePowerlines();\n\treturn [\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\tcommand,\n\t\t\tfilterGlobalOptions: false\n\t\t}),\n\t\tcode`writeLine(\"\"); `,\n\t\tcreateComponent(Spacing, {}),\n\t\tcreateComponent(Show, {\n\t\t\tget when() {\n\t\t\t\treturn Object.keys(command.children).length > 0;\n\t\t\t},\n\t\t\tget children() {\n\t\t\t\treturn [\n\t\t\t\t\tcode`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `,\n\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\treturn Object.values(command.children);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\tjoiner: code`writeLine(\"\"); `,\n\t\t\t\t\t\tender: code`writeLine(\"\"); `,\n\t\t\t\t\t\tchildren: (child) => [\n\t\t\t\t\t\t\tmemo(() => code`\n                writeLine(colors.text.heading.primary(${child.icon ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + ` : \"\"}\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(splitText(\\`${formatDescription(child.description).replace(/\\.+$/, \"\").trim()}.\\`)));\n                writeLine(\"\");\n                `),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {}),\n\t\t\t\t\t\t\tcreateComponent(BaseHelpDisplay, {\n\t\t\t\t\t\t\t\tcommand: child,\n\t\t\t\t\t\t\t\tindent: 2,\n\t\t\t\t\t\t\t\tfilterGlobalOptions: true\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateIntrinsic(\"hbr\", {})\n\t\t\t\t\t\t]\n\t\t\t\t\t}),\n\t\t\t\t\tmemo(() => code`help(\"Running a specific command with the help flag (via: '${getAppBin(context)} ${command.segments.join(\" \")} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`)\n\t\t\t\t];\n\t\t\t}\n\t\t})\n\t];\n}\n\n//#endregion\nexport { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay };\n//# sourceMappingURL=display.mjs.map"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAS,iBAAiB,OAAO;CAChC,MAAM,EAAE,SAAS,SAAS,MAAM;CAChC,MAAM,UAAU,eAAe;CAC/B,MAAM,QAAQ,UAAU;AACxB,QAAO,CAAC,gBAAgB,KAAK;EAC5B,IAAI,OAAO;AACV,UAAO,OAAO,KAAK,QAAQ,OAAO,IAAI;;EAEvC,UAAU;EACV,WAAW,QAAQ,CAAC,WAAW,IAAI;;oEAE+B,IAAI,KAAK,QAAQ,SAAS,SAAS,IAAI,IAAI,QAAQ,SAAS,KAAK,YAAY,wBAAwB,qBAAqB,QAAQ,GAAG,YAAY,UAAU,IAAI,qBAAqB,QAAQ,GAAG,IAAI,UAAU,0BAA0B,QAAQ,CAAC,CAAC,KAAK,QAAQ,KAAK,CAAC,KAAK,IAAI,KAAK,KAAK,OAAO,OAAO,QAAQ,SAAS,CAAC,SAAS,IAAI,gDAAgD,KAAK,QAAQ,KAAK,SAAS,IAAI,IAAI,QAAQ,KAAK,KAAK,QAAQ,+BAA+B,WAAW,IAAI,SAAS,sBAAsB,UAAU,IAAI,SAAS,sBAAsB,WAAW,IAAI,WAAW,IAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,KAAK,IAAI,GAAG,IAAI,SAAS,sBAAsB,UAAU,IAAI,SAAS,IAAI,SAAS,IAAI,KAAK,IAAI,IAAI,SAAS,sBAAsB,UAAU,IAAI,SAAS,sBAAsB,WAAW,IAAI,WAAW,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,KAAK,GAAG,6DAA6D,MAAM,QAAQ,MAAM,OAAO;UACz+B,EAAE,gBAAgB,OAAO,EAAE,CAAC,CAAC;EACrC,CAAC,EAAE,gBAAgB,MAAM;EACzB,IAAI,OAAO;AACV,UAAO,QAAQ,KAAK,SAAS;;EAE9B,IAAI,WAAW;AACd,UAAO,CAAC,gBAAgB,OAAO,EAAE,CAAC,EAAE,gBAAgB,KAAK;IACxD,IAAI,OAAO;AACV,YAAO,OAAO,KAAK,QAAQ,OAAO,IAAI;;IAEvC,UAAU;IACV,WAAW,QAAQ,CAAC,WAAW,IAAI;;oEAE6B,IAAI,KAAK,QAAQ,SAAS,SAAS,IAAI,IAAI,QAAQ,SAAS,KAAK,YAAY,wBAAwB,qBAAqB,QAAQ,GAAG,YAAY,UAAU,IAAI,qBAAqB,QAAQ,GAAG,IAAI,UAAU,0BAA0B,QAAQ,CAAC,CAAC,KAAK,QAAQ,KAAK,CAAC,KAAK,IAAI,KAAK,KAAK,OAAO,OAAO,QAAQ,SAAS,CAAC,SAAS,IAAI,gDAAgD,GAAG,6CAA6C,QAAQ,KAAK,SAAS,IAAI,IAAI,QAAQ,KAAK,KAAK,QAAQ,+BAA+B,WAAW,IAAI,SAAS,sBAAsB,UAAU,IAAI,SAAS,sBAAsB,WAAW,IAAI,WAAW,IAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,KAAK,IAAI,GAAG,IAAI,SAAS,sBAAsB,UAAU,IAAI,SAAS,IAAI,SAAS,IAAI,KAAK,IAAI,IAAI,SAAS,sBAAsB,UAAU,IAAI,SAAS,sBAAsB,WAAW,IAAI,WAAW,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,KAAK,GAAG,kBAAkB,MAAM,QAAQ,MAAM,OAAO;UACz+B,EAAE,gBAAgB,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC;;EAEJ,CAAC,CAAC;;;;;AAKJ,SAAS,mBAAmB,OAAO;CAClC,MAAM,EAAE,YAAY;CACpB,MAAM,UAAU,eAAe;AAC/B,QAAO;EACN,IAAI;EACJ,gBAAgB,OAAO,EAAE,CAAC;EAC1B,gBAAgB,KAAK;GACpB,IAAI,OAAO;AACV,WAAO,YAAY,QAAQ;;GAE5B,UAAU;GACV,WAAW,WAAW;IACrB,MAAM,QAAQ,EAAE;IAChB,MAAM,QAAQ,EAAE;AAChB,QAAI,OAAO,KAAK,WAAW,EAAG,OAAM,KAAK,IAAI,OAAO,OAAO;QACtD,OAAM,KAAK,KAAK,UAAU,OAAO,KAAK,GAAG;AAC9C,WAAO,MAAM,SAAS,UAAU;AAC/B,SAAI,MAAM,WAAW,EAAG,OAAM,KAAK,IAAI,QAAQ;SAC1C,OAAM,KAAK,KAAK,UAAU,MAAM,GAAG;MACvC;AACF,WAAO,IAAI,uCAAuC,MAAM,SAAS,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,KAAK,GAAG,MAAM,SAAS,IAAI,OAAO,OAAO,KAAK,MAAM,SAAS,IAAI,MAAM,MAAM,CAAC,KAAK,KAAK,GAAG,KAAK,OAAO,SAAS,sBAAsB,SAAS,KAAK,UAAU,OAAO,WAAW,OAAO,QAAQ,SAAS,IAAI,OAAO,QAAQ,KAAK,IAAI,GAAG,OAAO,SAAS,OAAO,SAAS,OAAO,KAAK,GAAG,OAAO,WAAW,QAAQ,GAAG,KAAK,OAAO,SAAS,sBAAsB,SAAS,KAAK,UAAU,OAAO,WAAW,OAAO,QAAQ,SAAS,IAAI,OAAO,QAAQ,KAAK,IAAI,GAAG,OAAO,KAAK,GAAG,OAAO,WAAW,QAAQ,GAAG,KAAK,GAAG,8FAA8F,uBAAuB,OAAO,YAAY,CAAC,QAAQ,QAAQ,GAAG,CAAC,MAAM,GAAG,OAAO,OAAO,OAAO,YAAY,KAAK,IAAI,KAAK,OAAO,MAAM,QAAQ,QAAQ,OAAO,qBAAqB,GAAG,OAAO,MAAM,OAAO,YAAY,KAAK,IAAI,OAAO,OAAO,KAAK,OAAO,YAAY,KAAK,IAAI,YAAY,KAAK,UAAU,OAAO,QAAQ,CAAC,QAAQ,MAAM,OAAO,KAAK,GAAG,KAAK,GAAG;;GAEvgC,CAAC;EACF,gBAAgB,OAAO,EAAE,CAAC;EAC1B,IAAI;EACJ;;;;;AAKF,SAAS,oBAAoB,OAAO;CACnC,MAAM,EAAE,aAAa;AACrB,QAAO;EACN,IAAI;EACJ,gBAAgB,OAAO,EAAE,CAAC;EAC1B,gBAAgB,KAAK;GACpB,IAAI,OAAO;AACV,WAAO,OAAO,OAAO,SAAS;;GAE/B,UAAU;GACV,WAAW,UAAU,IAAI,uCAAuC,MAAM,KAAK,6EAA6E,uBAAuB,MAAM,YAAY,CAAC,QAAQ,QAAQ,GAAG,CAAC,MAAM,CAAC;GAC7N,CAAC;EACF,gBAAgB,OAAO,EAAE,CAAC;EAC1B,IAAI;EACJ;;;;;AAKF,SAAS,gBAAgB,OAAO;CAC/B,MAAM,EAAE,SAAS,SAAS,GAAG,sBAAsB,UAAU;CAC7D,MAAM,QAAQ,UAAU;CACxB,MAAM,UAAU,eAAe;CAC/B,MAAM,UAAU,eAAe,sBAAsB,OAAO,OAAO,QAAQ,QAAQ,CAAC,QAAQ,WAAW,CAAC,QAAQ,QAAQ,MAAM,iBAAiB,aAAa,SAAS,OAAO,QAAQ,OAAO,MAAM,SAAS,aAAa,KAAK,IAAI,aAAa,OAAO,SAAS,OAAO,KAAK,IAAI,aAAa,OAAO,MAAM,UAAU,OAAO,MAAM,SAAS,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,QAAQ,QAAQ,CAAC;AAClX,QAAO;EACN,WAAW,IAAI,iEAAiE,SAAS,IAAI,gBAAgB,MAAM,QAAQ,MAAM,OAAO,MAAM,GAAG,IAAI;EACrJ,gBAAgB,OAAO,EAAE,CAAC;EAC1B,gBAAgB,kBAAkB;GACjC;GACA;GACA,CAAC;EACF,gBAAgB,SAAS,EAAE,CAAC;EAC5B,gBAAgB,MAAM;GACrB,IAAI,OAAO;AACV,WAAO,QAAQ,MAAM,SAAS;;GAE/B,IAAI,WAAW;AACd,WAAO;KACN,WAAW,IAAI;wEACoD,SAAS,IAAI,gBAAgB,MAAM,QAAQ,MAAM,OAAO,MAAM,GAAG,IAAI;KACxI,gBAAgB,OAAO,EAAE,CAAC;KAC1B,gBAAgB,oBAAoB,EAAE,IAAI,UAAU;AACnD,aAAO,QAAQ;QACb,CAAC;KACJ,gBAAgB,SAAS,EAAE,CAAC;KAC5B;;GAEF,CAAC;EACF,gBAAgB,MAAM;GACrB,IAAI,OAAO;AACV,WAAO,OAAO,KAAK,QAAQ,SAAS,CAAC,SAAS;;GAE/C,IAAI,WAAW;AACd,WAAO;KACN,WAAW,IAAI;yEACqD,SAAS,IAAI,gBAAgB,MAAM,QAAQ,MAAM,OAAO,MAAM,GAAG,IAAI;KACzI,gBAAgB,OAAO,EAAE,CAAC;KAC1B,gBAAgB,qBAAqB,EAAE,IAAI,WAAW;AACrD,aAAO,QAAQ;QACb,CAAC;KACJ,gBAAgB,SAAS,EAAE,CAAC;KAC5B;;GAEF,CAAC;EACF,gBAAgB,MAAM;GACrB,IAAI,OAAO;AACV,WAAO,YAAY,QAAQ,UAAU;;GAEtC,IAAI,WAAW;AACd,WAAO;KACN,WAAW,IAAI;oIACgH,QAAQ,UAAU,KAAK,SAAS,IAAI,gBAAgB,MAAM,QAAQ,MAAM,OAAO,MAAM,GAAG,IAAI;KAC3N,gBAAgB,OAAO,EAAE,CAAC;KAC1B,gBAAgB,SAAS,EAAE,CAAC;KAC5B;;GAEF,CAAC;EACF;;;;;AAKF,SAAS,0BAA0B,OAAO;CACzC,MAAM,EAAE,SAAS,UAAU,aAAa;CACxC,MAAM,UAAU,eAAe;AAC/B,QAAO;EACN,gBAAgB,OAAO,EAAE,CAAC;EAC1B,IAAI;EACJ,gBAAgB,OAAO,EAAE,CAAC;EAC1B,gBAAgB,oBAAoB,EAAE,SAAS,CAAC;EAChD,IAAI;EACJ,gBAAgB,SAAS,EAAE,CAAC;EAC5B,gBAAgB,MAAM;GACrB,IAAI,OAAO;AACV,WAAO,OAAO,KAAK,SAAS,CAAC,SAAS;;GAEvC,IAAI,WAAW;AACd,WAAO;KACN,WAAW,IAAI,0FAA0F,YAAY,SAAS,KAAK,CAAC;yBAChH;KACpB,gBAAgB,SAAS,EAAE,CAAC;KAC5B,gBAAgB,KAAK;MACpB,IAAI,OAAO;AACV,cAAO,OAAO,OAAO,SAAS;;MAE/B,gBAAgB;MAChB,QAAQ,IAAI;MACZ,OAAO,IAAI;MACX,WAAW,UAAU;OACpB,WAAW,IAAI;wDACkC,MAAM,OAAO,2BAA2B,MAAM,KAAK,gBAAgB,GAAG,GAAG,MAAM,MAAM,GAAG,MAAM,YAAY,KAAK,UAAU;;mEAE9G,kBAAkB,MAAM,YAAY,CAAC,QAAQ,QAAQ,GAAG,CAAC,MAAM,CAAC;;kBAEjH;OACX,gBAAgB,OAAO,EAAE,CAAC;OAC1B,gBAAgB,iBAAiB;QAChC,SAAS;QACT,QAAQ;QACR,qBAAqB;QACrB,CAAC;OACF,gBAAgB,OAAO,EAAE,CAAC;OAC1B;MACD,CAAC;KACF,WAAW,IAAI,8DAA8D,UAAU,QAAQ,GAAG,YAAY,SAAS,SAAS,IAAI,IAAI,SAAS,KAAK,IAAI,KAAK,GAAG;wBAC/I;KACnB;;GAEF,CAAC;EACF;;;;;AAKF,SAAS,mBAAmB,OAAO;CAClC,MAAM,EAAE,YAAY;CACpB,MAAM,UAAU,eAAe;AAC/B,QAAO;EACN,IAAI;EACJ,gBAAgB,SAAS,EAAE,CAAC;EAC5B,gBAAgB,iBAAiB;GAChC;GACA,qBAAqB;GACrB,CAAC;EACF,IAAI;EACJ,gBAAgB,SAAS,EAAE,CAAC;EAC5B,gBAAgB,MAAM;GACrB,IAAI,OAAO;AACV,WAAO,OAAO,KAAK,QAAQ,SAAS,CAAC,SAAS;;GAE/C,IAAI,WAAW;AACd,WAAO;KACN,IAAI;;KAEJ,gBAAgB,SAAS,EAAE,CAAC;KAC5B,gBAAgB,KAAK;MACpB,IAAI,OAAO;AACV,cAAO,OAAO,OAAO,QAAQ,SAAS;;MAEvC,gBAAgB;MAChB,QAAQ,IAAI;MACZ,OAAO,IAAI;MACX,WAAW,UAAU;OACpB,WAAW,IAAI;wDACkC,MAAM,OAAO,2BAA2B,MAAM,KAAK,gBAAgB,GAAG,GAAG,MAAM,MAAM,GAAG,MAAM,YAAY,KAAK,UAAU;;mEAE9G,kBAAkB,MAAM,YAAY,CAAC,QAAQ,QAAQ,GAAG,CAAC,MAAM,CAAC;;kBAEjH;OACX,gBAAgB,OAAO,EAAE,CAAC;OAC1B,gBAAgB,iBAAiB;QAChC,SAAS;QACT,QAAQ;QACR,qBAAqB;QACrB,CAAC;OACF,gBAAgB,OAAO,EAAE,CAAC;OAC1B;MACD,CAAC;KACF,WAAW,IAAI,8DAA8D,UAAU,QAAQ,CAAC,GAAG,QAAQ,SAAS,KAAK,IAAI,CAAC;wBAC3G;KACnB;;GAEF,CAAC;EACF"}

package/dist/plugin-help/dist/index.cjs

@@ -1,5 +1,5 @@
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-const require_is_set_string = require('./node_modules/.pnpm/@stryke_type-checks@0.5.39/node_modules/@stryke/type-checks/dist/is-set-string.cjs');
+const require_is_set_string = require('./node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.cjs');
 const require_help_builtin = require('./components/help-builtin.cjs');
 const require_help_command = require('./components/help-command.cjs');
 require('./components/index.cjs');

package/dist/plugin-help/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["isSetString","HelpCommand","Show","HelpBuiltin","Spacing","For"],"sources":["../../../../plugin-help/dist/index.mjs"],"sourcesContent":["import { isSetString } from \"./node_modules/.pnpm/@stryke_type-checks@0.5.39/node_modules/@stryke/type-checks/dist/is-set-string.mjs\";\nimport { HelpBuiltin } from \"./components/help-builtin.mjs\";\nimport { HelpCommand } from \"./components/help-command.mjs\";\nimport \"./components/index.mjs\";\nimport { createComponent } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, computed } from \"@alloy-js/core\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getAppDescription, getAppName, getAppTitle, getCommandList } from \"@shell-shock/core/plugin-utils\";\nimport console from \"@shell-shock/plugin-console\";\nimport theme from \"@shell-shock/plugin-theme\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport defu from \"defu\";\n\n//#region src/index.tsx\n/**\n* The Help - Shell Shock plugin to add a help command to the application.\n*/\nconst plugin = (options = {}) => {\n\treturn [\n\t\t...theme(options.theme),\n\t\tconsole(options.console),\n\t\t{\n\t\t\tname: \"shell-shock:help\",\n\t\t\tenforce: \"post\",\n\t\t\tconfig() {\n\t\t\t\tthis.debug(\"Providing default configuration for the Shell Shock `help` plugin.\");\n\t\t\t\treturn { help: defu({ command: options.command === false ? false : isSetString(options.command) ? options.command : \"help\" }, options, { builtins: true }) };\n\t\t\t},\n\t\t\tasync configResolved() {\n\t\t\t\tthis.debug(\"Adding the Help command to the application context.\");\n\t\t\t\tif (this.config.help.command !== false) {\n\t\t\t\t\tthis.inputs ??= [];\n\t\t\t\t\tif (this.inputs.some((input) => input.name === this.config.help.command)) this.info(\"The `help` command already exists in the commands list. If you would like the help command to be managed by the `@shell-shock/plugin-help` package, please remove or rename the command.\");\n\t\t\t\t\telse this.inputs.push({\n\t\t\t\t\t\tid: this.config.help.command,\n\t\t\t\t\t\tname: this.config.help.command,\n\t\t\t\t\t\tpath: this.config.help.command,\n\t\t\t\t\t\tsegments: [this.config.help.command],\n\t\t\t\t\t\ttitle: \"Help\",\n\t\t\t\t\t\tdescription: `A command for displaying help information to assist in using the ${getAppTitle(this, true)} command-line interface application.`,\n\t\t\t\t\t\tentry: {\n\t\t\t\t\t\t\tfile: joinPaths(this.entryPath, \"help\", \"index.ts\"),\n\t\t\t\t\t\t\tinput: { file: joinPaths(this.entryPath, \"help\", \"command.ts\") }\n\t\t\t\t\t\t},\n\t\t\t\t\t\tisVirtual: false\n\t\t\t\t\t});\n\t\t\t\t\tawait render(this, createComponent(HelpCommand, {}));\n\t\t\t\t}\n\t\t\t},\n\t\t\tprepare: {\n\t\t\t\torder: \"post\",\n\t\t\t\tasync handler() {\n\t\t\t\t\tconst _self$ = this;\n\t\t\t\t\tconst commands = await getCommandList(this);\n\t\t\t\t\tthis.debug(`Rendering \\`help\\` built-ins for each of the ${commands.length} command modules.`);\n\t\t\t\t\tconst bin = computed(() => ({\n\t\t\t\t\t\tid: \"\",\n\t\t\t\t\t\tname: getAppName(this),\n\t\t\t\t\t\ttitle: getAppTitle(this),\n\t\t\t\t\t\tdescription: getAppDescription(this),\n\t\t\t\t\t\tisVirtual: true,\n\t\t\t\t\t\tpath: null,\n\t\t\t\t\t\tsegments: [],\n\t\t\t\t\t\talias: [],\n\t\t\t\t\t\toptions: Object.fromEntries(this.options.map((option) => [option.name, option])),\n\t\t\t\t\t\tentry: { file: joinPaths(this.entryPath, \"bin.ts\") },\n\t\t\t\t\t\targs: [],\n\t\t\t\t\t\tparent: null,\n\t\t\t\t\t\tchildren: this.commands\n\t\t\t\t\t}));\n\t\t\t\t\treturn render(this, [createComponent(Show, {\n\t\t\t\t\t\tget when() {\n\t\t\t\t\t\t\treturn _self$.config.help.builtins !== false;\n\t\t\t\t\t\t},\n\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\treturn [\n\t\t\t\t\t\t\t\tcreateComponent(HelpBuiltin, { get command() {\n\t\t\t\t\t\t\t\t\treturn bin.value;\n\t\t\t\t\t\t\t\t} }),\n\t\t\t\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\t\t\t\treturn commands.sort((a, b) => a.name.localeCompare(b.name));\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\t\t\t\tchildren: (command) => createComponent(HelpBuiltin, { command })\n\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t];\n\t\t\t\t\t\t}\n\t\t\t\t\t})]);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t];\n};\n\n//#endregion\nexport { plugin as default, plugin };\n//# sourceMappingURL=index.mjs.map"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkBA,MAAM,UAAU,UAAU,EAAE,KAAK;AAChC,QAAO;EACN,0CAAS,QAAQ,MAAM;2CACf,QAAQ,QAAQ;EACxB;GACC,MAAM;GACN,SAAS;GACT,SAAS;AACR,SAAK,MAAM,qEAAqE;AAChF,WAAO,EAAE,wBAAW,EAAE,SAAS,QAAQ,YAAY,QAAQ,QAAQA,kCAAY,QAAQ,QAAQ,GAAG,QAAQ,UAAU,QAAQ,EAAE,SAAS,EAAE,UAAU,MAAM,CAAC,EAAE;;GAE7J,MAAM,iBAAiB;AACtB,SAAK,MAAM,sDAAsD;AACjE,QAAI,KAAK,OAAO,KAAK,YAAY,OAAO;AACvC,UAAK,WAAW,EAAE;AAClB,SAAI,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,KAAK,OAAO,KAAK,QAAQ,CAAE,MAAK,KAAK,2LAA2L;SAC1Q,MAAK,OAAO,KAAK;MACrB,IAAI,KAAK,OAAO,KAAK;MACrB,MAAM,KAAK,OAAO,KAAK;MACvB,MAAM,KAAK,OAAO,KAAK;MACvB,UAAU,CAAC,KAAK,OAAO,KAAK,QAAQ;MACpC,OAAO;MACP,aAAa,oHAAgF,MAAM,KAAK,CAAC;MACzG,OAAO;OACN,uCAAgB,KAAK,WAAW,QAAQ,WAAW;OACnD,OAAO,EAAE,uCAAgB,KAAK,WAAW,QAAQ,aAAa,EAAE;OAChE;MACD,WAAW;MACX,CAAC;AACF,uDAAa,sDAAsBC,kCAAa,EAAE,CAAC,CAAC;;;GAGtD,SAAS;IACR,OAAO;IACP,MAAM,UAAU;KACf,MAAM,SAAS;KACf,MAAM,WAAW,yDAAqB,KAAK;AAC3C,UAAK,MAAM,gDAAgD,SAAS,OAAO,mBAAmB;KAC9F,MAAM,0CAAsB;MAC3B,IAAI;MACJ,qDAAiB,KAAK;MACtB,uDAAmB,KAAK;MACxB,mEAA+B,KAAK;MACpC,WAAW;MACX,MAAM;MACN,UAAU,EAAE;MACZ,OAAO,EAAE;MACT,SAAS,OAAO,YAAY,KAAK,QAAQ,KAAK,WAAW,CAAC,OAAO,MAAM,OAAO,CAAC,CAAC;MAChF,OAAO,EAAE,uCAAgB,KAAK,WAAW,SAAS,EAAE;MACpD,MAAM,EAAE;MACR,QAAQ;MACR,UAAU,KAAK;MACf,EAAE;AACH,wDAAc,MAAM,iDAAiBC,qBAAM;MAC1C,IAAI,OAAO;AACV,cAAO,OAAO,OAAO,KAAK,aAAa;;MAExC,IAAI,WAAW;AACd,cAAO;wDACUC,kCAAa,EAAE,IAAI,UAAU;AAC5C,gBAAO,IAAI;WACT,CAAC;wDACYC,kDAAS,EAAE,CAAC;wDACZC,oBAAK;SACpB,IAAI,OAAO;AACV,iBAAO,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC;;SAE7D,gBAAgB;SAChB,WAAW,4DAA4BF,kCAAa,EAAE,SAAS,CAAC;SAChE,CAAC;QACF;;MAEF,CAAC,CAAC,CAAC;;IAEL;GACD;EACD"}
+{"version":3,"file":"index.cjs","names":["isSetString","HelpCommand","Show","HelpBuiltin","Spacing","For"],"sources":["../../../../plugin-help/dist/index.mjs"],"sourcesContent":["import { isSetString } from \"./node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs\";\nimport { HelpBuiltin } from \"./components/help-builtin.mjs\";\nimport { HelpCommand } from \"./components/help-command.mjs\";\nimport \"./components/index.mjs\";\nimport { createComponent } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, computed } from \"@alloy-js/core\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getAppDescription, getAppName, getAppTitle, getCommandList } from \"@shell-shock/core/plugin-utils\";\nimport console from \"@shell-shock/plugin-console\";\nimport theme from \"@shell-shock/plugin-theme\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport defu from \"defu\";\n\n//#region src/index.tsx\n/**\n* The Help - Shell Shock plugin to add a help command to the application.\n*/\nconst plugin = (options = {}) => {\n\treturn [\n\t\t...theme(options.theme),\n\t\tconsole(options.console),\n\t\t{\n\t\t\tname: \"shell-shock:help\",\n\t\t\tenforce: \"post\",\n\t\t\tconfig() {\n\t\t\t\tthis.debug(\"Providing default configuration for the Shell Shock `help` plugin.\");\n\t\t\t\treturn { help: defu({ command: options.command === false ? false : isSetString(options.command) ? options.command : \"help\" }, options, { builtins: true }) };\n\t\t\t},\n\t\t\tasync configResolved() {\n\t\t\t\tthis.debug(\"Adding the Help command to the application context.\");\n\t\t\t\tif (this.config.help.command !== false) {\n\t\t\t\t\tthis.inputs ??= [];\n\t\t\t\t\tif (this.inputs.some((input) => input.name === this.config.help.command)) this.info(\"The `help` command already exists in the commands list. If you would like the help command to be managed by the `@shell-shock/plugin-help` package, please remove or rename the command.\");\n\t\t\t\t\telse this.inputs.push({\n\t\t\t\t\t\tid: this.config.help.command,\n\t\t\t\t\t\tname: this.config.help.command,\n\t\t\t\t\t\tpath: this.config.help.command,\n\t\t\t\t\t\tsegments: [this.config.help.command],\n\t\t\t\t\t\ttitle: \"Help\",\n\t\t\t\t\t\tdescription: `A command for displaying help information to assist in using the ${getAppTitle(this, true)} command-line interface application.`,\n\t\t\t\t\t\tentry: {\n\t\t\t\t\t\t\tfile: joinPaths(this.entryPath, \"help\", \"index.ts\"),\n\t\t\t\t\t\t\tinput: { file: joinPaths(this.entryPath, \"help\", \"command.ts\") }\n\t\t\t\t\t\t},\n\t\t\t\t\t\tisVirtual: false\n\t\t\t\t\t});\n\t\t\t\t\tawait render(this, createComponent(HelpCommand, {}));\n\t\t\t\t}\n\t\t\t},\n\t\t\tprepare: {\n\t\t\t\torder: \"post\",\n\t\t\t\tasync handler() {\n\t\t\t\t\tconst _self$ = this;\n\t\t\t\t\tconst commands = await getCommandList(this);\n\t\t\t\t\tthis.debug(`Rendering \\`help\\` built-ins for each of the ${commands.length} command modules.`);\n\t\t\t\t\tconst bin = computed(() => ({\n\t\t\t\t\t\tid: \"\",\n\t\t\t\t\t\tname: getAppName(this),\n\t\t\t\t\t\ttitle: getAppTitle(this),\n\t\t\t\t\t\tdescription: getAppDescription(this),\n\t\t\t\t\t\tisVirtual: true,\n\t\t\t\t\t\tpath: null,\n\t\t\t\t\t\tsegments: [],\n\t\t\t\t\t\talias: [],\n\t\t\t\t\t\toptions: Object.fromEntries(this.options.map((option) => [option.name, option])),\n\t\t\t\t\t\tentry: { file: joinPaths(this.entryPath, \"bin.ts\") },\n\t\t\t\t\t\targs: [],\n\t\t\t\t\t\tparent: null,\n\t\t\t\t\t\tchildren: this.commands\n\t\t\t\t\t}));\n\t\t\t\t\treturn render(this, [createComponent(Show, {\n\t\t\t\t\t\tget when() {\n\t\t\t\t\t\t\treturn _self$.config.help.builtins !== false;\n\t\t\t\t\t\t},\n\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\treturn [\n\t\t\t\t\t\t\t\tcreateComponent(HelpBuiltin, { get command() {\n\t\t\t\t\t\t\t\t\treturn bin.value;\n\t\t\t\t\t\t\t\t} }),\n\t\t\t\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\t\t\t\treturn commands.sort((a, b) => a.name.localeCompare(b.name));\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\t\t\t\tchildren: (command) => createComponent(HelpBuiltin, { command })\n\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t];\n\t\t\t\t\t\t}\n\t\t\t\t\t})]);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t];\n};\n\n//#endregion\nexport { plugin as default, plugin };\n//# sourceMappingURL=index.mjs.map"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkBA,MAAM,UAAU,UAAU,EAAE,KAAK;AAChC,QAAO;EACN,0CAAS,QAAQ,MAAM;2CACf,QAAQ,QAAQ;EACxB;GACC,MAAM;GACN,SAAS;GACT,SAAS;AACR,SAAK,MAAM,qEAAqE;AAChF,WAAO,EAAE,wBAAW,EAAE,SAAS,QAAQ,YAAY,QAAQ,QAAQA,kCAAY,QAAQ,QAAQ,GAAG,QAAQ,UAAU,QAAQ,EAAE,SAAS,EAAE,UAAU,MAAM,CAAC,EAAE;;GAE7J,MAAM,iBAAiB;AACtB,SAAK,MAAM,sDAAsD;AACjE,QAAI,KAAK,OAAO,KAAK,YAAY,OAAO;AACvC,UAAK,WAAW,EAAE;AAClB,SAAI,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,KAAK,OAAO,KAAK,QAAQ,CAAE,MAAK,KAAK,2LAA2L;SAC1Q,MAAK,OAAO,KAAK;MACrB,IAAI,KAAK,OAAO,KAAK;MACrB,MAAM,KAAK,OAAO,KAAK;MACvB,MAAM,KAAK,OAAO,KAAK;MACvB,UAAU,CAAC,KAAK,OAAO,KAAK,QAAQ;MACpC,OAAO;MACP,aAAa,oHAAgF,MAAM,KAAK,CAAC;MACzG,OAAO;OACN,uCAAgB,KAAK,WAAW,QAAQ,WAAW;OACnD,OAAO,EAAE,uCAAgB,KAAK,WAAW,QAAQ,aAAa,EAAE;OAChE;MACD,WAAW;MACX,CAAC;AACF,uDAAa,sDAAsBC,kCAAa,EAAE,CAAC,CAAC;;;GAGtD,SAAS;IACR,OAAO;IACP,MAAM,UAAU;KACf,MAAM,SAAS;KACf,MAAM,WAAW,yDAAqB,KAAK;AAC3C,UAAK,MAAM,gDAAgD,SAAS,OAAO,mBAAmB;KAC9F,MAAM,0CAAsB;MAC3B,IAAI;MACJ,qDAAiB,KAAK;MACtB,uDAAmB,KAAK;MACxB,mEAA+B,KAAK;MACpC,WAAW;MACX,MAAM;MACN,UAAU,EAAE;MACZ,OAAO,EAAE;MACT,SAAS,OAAO,YAAY,KAAK,QAAQ,KAAK,WAAW,CAAC,OAAO,MAAM,OAAO,CAAC,CAAC;MAChF,OAAO,EAAE,uCAAgB,KAAK,WAAW,SAAS,EAAE;MACpD,MAAM,EAAE;MACR,QAAQ;MACR,UAAU,KAAK;MACf,EAAE;AACH,wDAAc,MAAM,iDAAiBC,qBAAM;MAC1C,IAAI,OAAO;AACV,cAAO,OAAO,OAAO,KAAK,aAAa;;MAExC,IAAI,WAAW;AACd,cAAO;wDACUC,kCAAa,EAAE,IAAI,UAAU;AAC5C,gBAAO,IAAI;WACT,CAAC;wDACYC,kDAAS,EAAE,CAAC;wDACZC,oBAAK;SACpB,IAAI,OAAO;AACV,iBAAO,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC;;SAE7D,gBAAgB;SAChB,WAAW,4DAA4BF,kCAAa,EAAE,SAAS,CAAC;SAChE,CAAC;QACF;;MAEF,CAAC,CAAC,CAAC;;IAEL;GACD;EACD"}

package/dist/plugin-help/dist/index.mjs

@@ -1,4 +1,4 @@
-import { isSetString } from "./node_modules/.pnpm/@stryke_type-checks@0.5.39/node_modules/@stryke/type-checks/dist/is-set-string.mjs";
+import { isSetString } from "./node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs";
 import { HelpBuiltin } from "./components/help-builtin.mjs";
 import { HelpCommand } from "./components/help-command.mjs";
 import "./components/index.mjs";