@shell-shock/preset-script 0.6.55 → 0.6.56

package/dist/components/command-entry.cjs

@@ -150,6 +150,7 @@ function CommandEntry(props) {
 				utils: ["isMinimal", "isUnicodeSupported"],
 				state: [
 					"useGlobal",
+					"useGlobalOptions",
 					"useArgs",
 					"hasFlag",
 					"withCommand",

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.cjs","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { CommandValidationLogic } from \"@shell-shock/core/components/command-validation-logic\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code` return withCommand(\"${command.path}\", [${command.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? camelCase(getDynamicPathSegmentName(segment))\n            : `\"${segment}\"`\n        )\n        .join(\", \")}], [options${\n        command.args.length > 0\n          ? `, ${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n          : \"\"\n      }], handle${pascalCase(command.name)}); `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\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 CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\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(\" \")}) 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        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(textColors.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          writeLine(\"\");\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <Spacing />\n        {children}\n        <Spacing />\n        <IfStatement condition={code`options.help`}>\n          {code`return showHelp(); `}\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value.startsWith(\".\")\n            ? commandSourcePath.value\n            : `./${commandSourcePath.value}`]:\n            `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\"debug\", \"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\"],\n          state: [\n            \"useGlobal\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"withCommand\",\n            { name: \"GlobalOptions\", type: true }\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        <OptionsInterfaceDeclaration command={command} />\n        <Spacing />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandValidationLogic command={command} />\n          <IfStatement condition={code`failures.length > 0`}>\n            {code`error(\\`The following validation failures were found while processing the user provided input, and must be corrected before the \\${italic(\"${\n              command.title\n            }\")} command can be executed: \\\\n\\\\n\\${failures.map(failure => \" - \" + failure).join(\"\\\\n\")}\\`);\n                options.help = true; `}\n          </IfStatement>\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.cjs","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { CommandValidationLogic } from \"@shell-shock/core/components/command-validation-logic\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code` return withCommand(\"${command.path}\", [${command.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? camelCase(getDynamicPathSegmentName(segment))\n            : `\"${segment}\"`\n        )\n        .join(\", \")}], [options${\n        command.args.length > 0\n          ? `, ${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n          : \"\"\n      }], handle${pascalCase(command.name)}); `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\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 CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\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(\" \")}) 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        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(textColors.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          writeLine(\"\");\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <Spacing />\n        {children}\n        <Spacing />\n        <IfStatement condition={code`options.help`}>\n          {code`return showHelp(); `}\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value.startsWith(\".\")\n            ? commandSourcePath.value\n            : `./${commandSourcePath.value}`]:\n            `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\"debug\", \"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\"],\n          state: [\n            \"useGlobal\",\n            \"useGlobalOptions\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"withCommand\",\n            { name: \"GlobalOptions\", type: true }\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        <OptionsInterfaceDeclaration command={command} />\n        <Spacing />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandValidationLogic command={command} />\n          <IfStatement condition={code`failures.length > 0`}>\n            {code`error(\\`The following validation failures were found while processing the user provided input, and must be corrected before the \\${italic(\"${\n              command.title\n            }\")} command can be executed: \\\\n\\\\n\\${failures.map(failure => \" - \" + failure).join(\"\\\\n\")}\\`);\n                options.help = true; `}\n          </IfStatement>\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/command-entry.mjs

@@ -147,6 +147,7 @@ function CommandEntry(props) {
 				utils: ["isMinimal", "isUnicodeSupported"],
 				state: [
 					"useGlobal",
+					"useGlobalOptions",
 					"useArgs",
 					"hasFlag",
 					"withCommand",

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { CommandValidationLogic } from \"@shell-shock/core/components/command-validation-logic\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code` return withCommand(\"${command.path}\", [${command.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? camelCase(getDynamicPathSegmentName(segment))\n            : `\"${segment}\"`\n        )\n        .join(\", \")}], [options${\n        command.args.length > 0\n          ? `, ${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n          : \"\"\n      }], handle${pascalCase(command.name)}); `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\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 CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\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(\" \")}) 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        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(textColors.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          writeLine(\"\");\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <Spacing />\n        {children}\n        <Spacing />\n        <IfStatement condition={code`options.help`}>\n          {code`return showHelp(); `}\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value.startsWith(\".\")\n            ? commandSourcePath.value\n            : `./${commandSourcePath.value}`]:\n            `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\"debug\", \"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\"],\n          state: [\n            \"useGlobal\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"withCommand\",\n            { name: \"GlobalOptions\", type: true }\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        <OptionsInterfaceDeclaration command={command} />\n        <Spacing />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandValidationLogic command={command} />\n          <IfStatement condition={code`failures.length > 0`}>\n            {code`error(\\`The following validation failures were found while processing the user provided input, and must be corrected before the \\${italic(\"${\n              command.title\n            }\")} command can be executed: \\\\n\\\\n\\${failures.map(failure => \" - \" + failure).join(\"\\\\n\")}\\`);\n                options.help = true; `}\n          </IfStatement>\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.mjs","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { CommandValidationLogic } from \"@shell-shock/core/components/command-validation-logic\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code` return withCommand(\"${command.path}\", [${command.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? camelCase(getDynamicPathSegmentName(segment))\n            : `\"${segment}\"`\n        )\n        .join(\", \")}], [options${\n        command.args.length > 0\n          ? `, ${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n          : \"\"\n      }], handle${pascalCase(command.name)}); `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\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 CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\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(\" \")}) 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        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(textColors.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          writeLine(\"\");\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <Spacing />\n        {children}\n        <Spacing />\n        <IfStatement condition={code`options.help`}>\n          {code`return showHelp(); `}\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value.startsWith(\".\")\n            ? commandSourcePath.value\n            : `./${commandSourcePath.value}`]:\n            `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\"debug\", \"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\"],\n          state: [\n            \"useGlobal\",\n            \"useGlobalOptions\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"withCommand\",\n            { name: \"GlobalOptions\", type: true }\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        <OptionsInterfaceDeclaration command={command} />\n        <Spacing />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandValidationLogic command={command} />\n          <IfStatement condition={code`failures.length > 0`}>\n            {code`error(\\`The following validation failures were found while processing the user provided input, and must be corrected before the \\${italic(\"${\n              command.title\n            }\")} command can be executed: \\\\n\\\\n\\${failures.map(failure => \" - \" + failure).join(\"\\\\n\")}\\`);\n                options.help = true; `}\n          </IfStatement>\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

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

@@ -104,6 +104,7 @@ function VirtualCommandEntry(props) {
 				],
 				state: [
 					"useGlobal",
+					"useGlobalOptions",
 					"withCommand",
 					"useArgs",
 					"hasFlag",

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-command-entry.cjs","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\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\", \"findSuggestions\"],\n          state: [\n            \"useGlobal\",\n            \"withCommand\",\n            \"useArgs\",\n            \"hasFlag\",\n            { name: \"GlobalOptions\", type: true }\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":";;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,iCAAC,OAAsC;CACrD,MAAA,EACA,SACA,UACF;CAEE,MAAA,6EAAA;AACA,QAAG,iDAAe,4DAAe;EACjC,IAAA,UAAA;AACI,UAAC,OAAS,QAAA,MAAA,kDAAgC,QAAA,CAAA,GAAA,QAAA,SAAA,KAAA,qEAAA,QAAA,GAAA,wHAAA,QAAA,CAAA,CAAA,KAAA,QAAA,CAAA,KAAA,IAAA,CAAA;;EAE9C,IAAA,WAAA;AACA,UAAQ;oDAAmB,mEAAgB;AAErC,YAAS,GAAC,QAAA,YAAc,QAAA,QAAsB,GAAA,CAAA;OAEpD,CAAM;oDAAC,OAAA,EAAA,CAAA;oDAAA,iEAAA,EACJ,IAAA,WAAA;AACE,YAAA,QAAA;OAEA,CAAC;oDAAgB,iEAAA;KAChB,MAAI;KACJ,UAAU;KACX,CAAC;IAAC;;EAEN,CAAC,kDAAmB,0CAAkB;EACrC,UAAK;EACL,OAAK;EACL,MAAK;EACL,YAAK,CAAA;GACH,MAAE;GACF,MAAC;GACD,SAAE;GACH,CAAC;EACF,IAAI,WAAM;AACR,UAAE;oDAAsB,kDAAW,EAAE,CAAC;IAAA;oDAA8B,kDAAK,EAAA,CAAA;oDAAA,qBAAA;KACvE,IAAC,OAAS;AACT,aAAQ,QAAA,OAAA;;KAET,UAAU;KACX,CAAC;oDAAU,kDAAA,EAAA,CAAA;IAAA,mBAAA;IAAA;;EAEf,CAAC,CAAC;;;;;AASL,SAAW,oBAAW,OAAA;CACtB,MAAA,WAEE,SACC,gBACD,GAAA,SACI;CACJ,MAAM,6EAA8C;;AAEpD,QAAM,iDAAU,0HAAoC,MAAA;EACpD,IAAM,OAAA;AACJ,UAAS,SAAA;;EAET,IAAE,UAAQ;AACR,4BAAU,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,2DAAA,KAAA;KACD,CAAA;;MAEM,EAAA,CAAA,CAAA;;EAEL,IAAG,iBAAA;AACD,4BAAU,kBAAA,EAAA,EAAA;IACR,KAAK,CAAC,iBAAc,UAAA;IACpB,SAAS;KAAA;KAAI;KAAA;KAAA;KAAA;IACb,OAAE;KAAA;KAAa;KAAA;KAAA;IACf,OAAE;KAAM;KAAS;KAAgB;KAAA;KAAA;MAC/B,MAAG;MACH,MAAG;MACJ;KAAC;sCACQ,QAAO,GAAA,QAAU,SAAQ,QAAQ,YAAW,0DAAQ,QAAA,CAAA,CAAA,GAAA,CAAA,WAAA;sCACvD,UAAA,GAAA,QAAA,SAAA,QAAA,YAAA,0DAAA,QAAA,CAAA,CAAA,GAAA,CAAA,aAAA;;;EAGX,IAAI,WAAU;AACZ,UAAG,iDAAA,kDAAA,EAAA,CAAA,kDAAA,kCAAA;IACD;IACA,QAAQ,mBAAC;IACT,IAAE,WAAW;AACX,4DAAsB,iDAAkB;MACxC,IAAM,WAAC;AACJ,cAAA,QAAU;;MAEX,IAAC,WAAQ;AACR,cAAQ,QAAA;;MAEV,CAAA;;IAEJ,CAAC,CAAC;;EAEN,CAAC,CAAC,kDAAoB,oBAAC;EACtB,IAAI,OAAI;AACN,UAAO,OAAG,OAAU,QAAA,SAAA;;EAEtB,WAAS,0DAAO,qBAAA;GACd,IAAI,OAAK;AACP,WAAM,MAAO;;GAEf,IAAI,WAAM;AACR,2DAAG,+CAAA,EACF,SAAS,OACT,CAAA;;GAEH,IAAI,WAAQ;AACV,2DAAG,qBAAA,EACD,SAAE,OACH,CAAC;;GAEL,CAAC;EACH,CAAC,CAAC"}
+{"version":3,"file":"virtual-command-entry.cjs","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\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\", \"findSuggestions\"],\n          state: [\n            \"useGlobal\",\n            \"useGlobalOptions\",\n            \"withCommand\",\n            \"useArgs\",\n            \"hasFlag\",\n            { name: \"GlobalOptions\", type: true }\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":";;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,iCAAC,OAAsC;CACrD,MAAA,EACA,SACA,UACF;CAEE,MAAA,6EAAA;AACA,QAAG,iDAAe,4DAAe;EACjC,IAAA,UAAA;AACI,UAAC,OAAS,QAAA,MAAA,kDAAgC,QAAA,CAAA,GAAA,QAAA,SAAA,KAAA,qEAAA,QAAA,GAAA,wHAAA,QAAA,CAAA,CAAA,KAAA,QAAA,CAAA,KAAA,IAAA,CAAA;;EAE9C,IAAA,WAAA;AACA,UAAQ;oDAAmB,mEAAgB;AAErC,YAAS,GAAC,QAAA,YAAc,QAAA,QAAsB,GAAA,CAAA;OAEpD,CAAM;oDAAC,OAAA,EAAA,CAAA;oDAAA,iEAAA,EACJ,IAAA,WAAA;AACE,YAAA,QAAA;OAEA,CAAC;oDAAgB,iEAAA;KAChB,MAAI;KACJ,UAAU;KACX,CAAC;IAAC;;EAEN,CAAC,kDAAmB,0CAAkB;EACrC,UAAK;EACL,OAAK;EACL,MAAK;EACL,YAAK,CAAA;GACH,MAAE;GACF,MAAC;GACD,SAAE;GACH,CAAC;EACF,IAAI,WAAM;AACR,UAAE;oDAAsB,kDAAW,EAAE,CAAC;IAAA;oDAA8B,kDAAK,EAAA,CAAA;oDAAA,qBAAA;KACvE,IAAC,OAAS;AACT,aAAQ,QAAA,OAAA;;KAET,UAAU;KACX,CAAC;oDAAU,kDAAA,EAAA,CAAA;IAAA,mBAAA;IAAA;;EAEf,CAAC,CAAC;;;;;AASL,SAAW,oBAAW,OAAA;CACtB,MAAA,WAEE,SACC,gBACD,GAAA,SACI;CACJ,MAAM,6EAA8C;;AAEpD,QAAM,iDAAU,0HAAoC,MAAA;EACpD,IAAM,OAAA;AACJ,UAAS,SAAA;;EAET,IAAE,UAAQ;AACR,4BAAU,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,2DAAA,KAAA;KACD,CAAA;;MAEM,EAAA,CAAA,CAAA;;EAEL,IAAG,iBAAA;AACD,4BAAU,kBAAA,EAAA,EAAA;IACR,KAAK,CAAC,iBAAc,UAAA;IACpB,SAAS;KAAA;KAAI;KAAA;KAAA;KAAA;IACb,OAAE;KAAA;KAAa;KAAA;KAAA;IACf,OAAE;KAAM;KAAS;KAAgB;KAAA;KAAA;KAAA;MAC/B,MAAG;MACH,MAAG;MACJ;KAAC;sCACQ,QAAO,GAAA,QAAU,SAAQ,QAAQ,YAAW,0DAAQ,QAAA,CAAA,CAAA,GAAA,CAAA,WAAA;sCACvD,UAAA,GAAA,QAAA,SAAA,QAAA,YAAA,0DAAA,QAAA,CAAA,CAAA,GAAA,CAAA,aAAA;;;EAGX,IAAI,WAAU;AACZ,UAAG,iDAAA,kDAAA,EAAA,CAAA,kDAAA,kCAAA;IACD;IACA,QAAQ,mBAAC;IACT,IAAE,WAAW;AACX,4DAAsB,iDAAkB;MACxC,IAAM,WAAC;AACJ,cAAA,QAAU;;MAEX,IAAC,WAAY;AACZ,cAAQ,QAAA;;MAEV,CAAC;;IAEL,CAAC,CAAC;;EAEN,CAAC,CAAC,kDAAkB,oBAAA;EACnB,IAAI,OAAM;AACR,UAAM,OAAA,OAAA,QAAA,SAAA;;EAER,WAAO,0DAAS,qBAAA;GACd,IAAI,OAAG;AACL,WAAO,MAAA;;GAET,IAAI,WAAE;AACJ,2DAAmB,+CAAA,EACjB,SAAC,OACF,CAAA;;GAEH,IAAI,WAAS;AACX,2DAAqB,qBAAgB,EACnC,SAAC,OACF,CAAC;;GAEL,CAAC;EACH,CAAC,CAAC"}

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

@@ -101,6 +101,7 @@ function VirtualCommandEntry(props) {
 				],
 				state: [
 					"useGlobal",
+					"useGlobalOptions",
 					"withCommand",
 					"useArgs",
 					"hasFlag",

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 { 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\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\", \"findSuggestions\"],\n          state: [\n            \"useGlobal\",\n            \"withCommand\",\n            \"useArgs\",\n            \"hasFlag\",\n            { name: \"GlobalOptions\", type: true }\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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"}
+{"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\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\", \"findSuggestions\"],\n          state: [\n            \"useGlobal\",\n            \"useGlobalOptions\",\n            \"withCommand\",\n            \"useArgs\",\n            \"hasFlag\",\n            { name: \"GlobalOptions\", type: true }\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-script",
-  "version": "0.6.55",
+  "version": "0.6.56",
   "private": false,
   "description": "A Shell Shock preset that generates a fully-featured script application.",
   "keywords": [
@@ -198,11 +198,11 @@
     "@powerlines/deepkit": "^0.6.167",
     "@powerlines/plugin-alloy": "^0.26.9",
     "@powerlines/plugin-plugin": "^0.12.343",
-    "@shell-shock/core": "^0.17.0",
-    "@shell-shock/plugin-banner": "^0.1.27",
-    "@shell-shock/plugin-help": "^0.2.18",
-    "@shell-shock/plugin-console": "^0.2.4",
-    "@shell-shock/plugin-theme": "^0.4.13",
+    "@shell-shock/core": "^0.17.1",
+    "@shell-shock/plugin-banner": "^0.1.28",
+    "@shell-shock/plugin-help": "^0.2.19",
+    "@shell-shock/plugin-console": "^0.2.5",
+    "@shell-shock/plugin-theme": "^0.4.14",
     "@stryke/helpers": "^0.10.8",
     "@stryke/path": "^0.27.4",
     "@stryke/string-format": "^0.17.9",
@@ -215,5 +215,5 @@
     "@types/node": "^25.5.2"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "8ca409c1453d9722650670c3df4f4da72abdc308"
+  "gitHead": "0a96451134431381e1d79f85dceaaafd5cf94cfe"
 }