@shell-shock/preset-script 0.6.58 → 0.6.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/dist/components/command-entry.cjs +2 -2
  2. package/dist/components/command-entry.cjs.map +1 -1
  3. package/dist/components/command-entry.mjs +2 -2
  4. package/dist/components/command-entry.mjs.map +1 -1
  5. package/dist/components/exit-function-declaration.cjs +3 -1
  6. package/dist/components/exit-function-declaration.cjs.map +1 -1
  7. package/dist/components/exit-function-declaration.mjs +3 -1
  8. package/dist/components/exit-function-declaration.mjs.map +1 -1
  9. package/dist/index.cjs +0 -1
  10. package/dist/index.cjs.map +1 -1
  11. package/dist/index.mjs +0 -1
  12. package/dist/index.mjs.map +1 -1
  13. package/package.json +12 -12
package/dist/components/command-entry.cjs CHANGED
@@ -92,10 +92,10 @@ function CommandHandlerDeclaration(props) {
92
92
  return _alloy_js_core.code`writeLine("");
93
93
  writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
94
94
  writeLine("");
95
- debug(\`Command path: ${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `\${${(0, _stryke_string_format_camel_case.camelCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${(0, _stryke_string_format_kebab_case.kebabCase)(option.name)}: \${options.${(0, _stryke_string_format_camel_case.camelCase)(option.name)} === undefined ? "" : JSON.stringify(options.${(0, _stryke_string_format_camel_case.camelCase)(option.name)})}`).join("\\n")}${command.args.length > 0 ? ` \\n\\nArguments: \\n${command.args.map((arg) => ` - ${(0, _stryke_string_format_kebab_case.kebabCase)(arg.name)}: \${${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} === undefined ? "" : JSON.stringify(${(0, _stryke_string_format_camel_case.camelCase)(arg.name)})}`).join("\\n")}` : ""}\`);
96
- writeLine(""); `;
95
+ debug(\`Command path: ${command.segments.map((segment) => (0, _shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `\${${(0, _stryke_string_format_camel_case.camelCase)((0, _shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${(0, _stryke_string_format_kebab_case.kebabCase)(option.name)}: \${options.${(0, _stryke_string_format_camel_case.camelCase)(option.name)} === undefined ? "" : JSON.stringify(options.${(0, _stryke_string_format_camel_case.camelCase)(option.name)})}`).join("\\n")}${command.args.length > 0 ? ` \\n\\nArguments: \\n${command.args.map((arg) => ` - ${(0, _stryke_string_format_kebab_case.kebabCase)(arg.name)}: \${${(0, _stryke_string_format_camel_case.camelCase)(arg.name)} === undefined ? "" : JSON.stringify(${(0, _stryke_string_format_camel_case.camelCase)(arg.name)})}`).join("\\n")}` : ""}\`); `;
97
96
  }
98
97
  }),
98
+ (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseClause, { children: _alloy_js_core.code`writeLine("");` }),
99
99
  (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
100
100
  children,
101
101
  (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
package/dist/components/command-entry.cjs.map CHANGED
@@ -1 +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 \"GlobalOptions\",\n \"useGlobalOptions\",\n \"useArgs\",\n \"hasFlag\",\n \"withCommand\"\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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"}
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 </IfStatement>\n <ElseClause>{code`writeLine(\"\");`}</ElseClause>\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 \"GlobalOptions\",\n \"useGlobalOptions\",\n \"useArgs\",\n \"hasFlag\",\n \"withCommand\"\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 CHANGED
@@ -89,10 +89,10 @@ function CommandHandlerDeclaration(props) {
89
89
  return code`writeLine("");
90
90
  writeLine(textColors.body.tertiary("Debug mode is enabled. Additional debug information may be logged to the console."));
91
91
  writeLine("");
92
- debug(\`Command path: ${command.segments.map((segment) => isDynamicPathSegment(segment) ? `\${${camelCase(getDynamicPathSegmentName(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${kebabCase(option.name)}: \${options.${camelCase(option.name)} === undefined ? "" : JSON.stringify(options.${camelCase(option.name)})}`).join("\\n")}${command.args.length > 0 ? ` \\n\\nArguments: \\n${command.args.map((arg) => ` - ${kebabCase(arg.name)}: \${${camelCase(arg.name)} === undefined ? "" : JSON.stringify(${camelCase(arg.name)})}`).join("\\n")}` : ""}\`);
93
- writeLine(""); `;
92
+ debug(\`Command path: ${command.segments.map((segment) => isDynamicPathSegment(segment) ? `\${${camelCase(getDynamicPathSegmentName(segment))}}` : segment).join(" / ")} \\n\\nOptions: \\n${Object.values(command.options).map((option) => ` - ${kebabCase(option.name)}: \${options.${camelCase(option.name)} === undefined ? "" : JSON.stringify(options.${camelCase(option.name)})}`).join("\\n")}${command.args.length > 0 ? ` \\n\\nArguments: \\n${command.args.map((arg) => ` - ${kebabCase(arg.name)}: \${${camelCase(arg.name)} === undefined ? "" : JSON.stringify(${camelCase(arg.name)})}`).join("\\n")}` : ""}\`); `;
94
93
  }
95
94
  }),
95
+ createComponent(ElseClause, { children: code`writeLine("");` }),
96
96
  createComponent(Spacing, {}),
97
97
  children,
98
98
  createComponent(Spacing, {}),
package/dist/components/command-entry.mjs.map CHANGED
@@ -1 +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 \"GlobalOptions\",\n \"useGlobalOptions\",\n \"useArgs\",\n \"hasFlag\",\n \"withCommand\"\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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"}
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 </IfStatement>\n <ElseClause>{code`writeLine(\"\");`}</ElseClause>\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 \"GlobalOptions\",\n \"useGlobalOptions\",\n \"useArgs\",\n \"hasFlag\",\n \"withCommand\"\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/exit-function-declaration.cjs CHANGED
@@ -105,7 +105,9 @@ function ExitFunctionDeclaration() {
105
105
  }
106
106
 
107
107
  if (options.exception) {
108
- error(\`A fatal error occured while running the application - please contact the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`);
108
+ error({ message: \`A fatal error occured while running the application - please contact the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`,
109
+ ...(options.exception && typeof options.exception === "object" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})
110
+ });
109
111
  }
110
112
 
111
113
  const terminate = (force = false) => { `),
package/dist/components/exit-function-declaration.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"exit-function-declaration.cjs","names":[],"sources":["../../src/components/exit-function-declaration.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 } from \"@alloy-js/core\";\nimport {\n FunctionDeclaration,\n IfStatement,\n InterfaceDeclaration,\n InterfaceMember,\n VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <InterfaceDeclaration\n export\n name=\"ExitOptions\"\n doc=\"Options for the exit handler function.\">\n <InterfaceMember\n name=\"exception\"\n optional\n type=\"string | Error\"\n doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n />\n <hbr />\n <InterfaceMember\n name=\"skipProcessExit\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n />\n <hbr />\n <InterfaceMember\n name=\"isSynchronous\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n />\n <hbr />\n <InterfaceMember\n name=\"signal\"\n optional\n type=\"number\"\n doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n />\n <hbr />\n <InterfaceMember\n name=\"startDate\"\n optional\n type=\"Date\"\n doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n />\n </InterfaceDeclaration>\n <Spacing />\n <VarDeclaration\n let\n name=\"isExiting\"\n type=\"boolean\"\n initializer={code`false;`}\n />\n <VarDeclaration\n const\n name=\"callbackAsyncQueue\"\n type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n initializer={code`[];`}\n />\n <VarDeclaration\n const\n name=\"callbackSyncQueue\"\n type=\"Array<(code: number | string) => void>\"\n initializer={code`[];`}\n />\n <Spacing />\n <FunctionDeclaration\n export\n async\n name=\"exit\"\n parameters={[\n {\n name: \"options\",\n type: \"ExitOptions\",\n default: \"{}\"\n }\n ]}>\n {code`\n try {\n if (isExiting) {\n return;\n }\n\n isExiting = true;\n\n let exitCode: number | string = 0;\n if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n exitCode = 128 + (options.signal ?? 1);\n } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n exitCode = process.exitCode;\n }\n\n if (options.exception) {\n error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n context\n )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`);\n }\n\n const terminate = (force = false) => { `}\n <IfStatement\n condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n <hbr />\n {code`\n verbose(\\`The ${getAppTitle(\n context,\n true\n )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(exitCode));\n }\n };\n\n for (const callbackSync of callbackSyncQueue) {\n callbackSync(exitCode);\n }\n\n if (!options.isSynchronous) {\n const promises = [];\n let forceAfter = 0;\n for (const [callbackAsync, wait] of callbackAsyncQueue) {\n forceAfter = Math.max(forceAfter, wait);\n promises.push(Promise.resolve(callbackAsync(exitCode)));\n }\n\n const asyncTimer = setTimeout(() => {\n terminate(true);\n }, forceAfter);\n await Promise.all(promises);\n clearTimeout(asyncTimer);\n }\n\n terminate();\n } catch (err) {\n error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n context,\n true\n )} support team.\\`);\n\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(1));\n }\n }\n `}\n </FunctionDeclaration>\n </>\n );\n}\n"],"mappings":";;;;;;;;;;;;;;AA8BA,SAAc,0BAA4B;;AAExC,QAAA;kDAAA,2CAAA;GACC,UAAW;GACZ,MAAA;GACF,KAAO;GACL,IAAM,WAAU;;;MAEV,MAAC;MACJ,UAAA;MACE,MAAA;MACC,KAAA;MACD,CAAC;qDAAiB,OAAA,EAAA,CAAA;qDAAA,sCAAA;MACjB,MAAK;MACL,UAAC;MACD,MAAM;MACN,KAAE;MACH,CAAC;qDAAiB,OAAK,EAAA,CAAA;qDAAA,sCAAA;MACtB,MAAM;MACN,UAAC;MACD,MAAM;MACN,KAAC;MACF,CAAC;qDAAQ,OAAe,EAAA,CAAA;qDAAA,sCAAA;MACvB,MAAE;MACF,UAAQ;MACR,MAAM;MACN,KAAC;MACF,CAAC;qDAAM,OAAA,EAAA,CAAA;qDAAA,sCAAA;MACN,MAAC;MACD,UAAQ;MACR,MAAE;MACF,KAAE;MACH,CAAC;KAAC;;GAEN,CAAC;kDAAU,0DAAA,EAAA,CAAA;kDAAA,qCAAA;GACV,OAAK;GACL,MAAM;GACN,MAAM;GACN,aAAY,mBAAA;GACb,CAAC;kDAAe,qCAAmB;GAClC,SAAK;GACL,MAAK;GACL,MAAK;GACL,aAAY,mBAAA;GACb,CAAC;kDAAM,qCAAA;GACN,SAAM;GACN,MAAM;GACN,MAAK;GACL,aAAI,mBAAA;GACL,CAAC;kDAAY,0DAAA,EAAA,CAAA;kDAAA,0CAAA;GACZ,UAAG;GACH,OAAI;GACJ,MAAI;GACJ,YAAU,CAAA;IACR,MAAE;IACF,MAAC;IACD,SAAC;IACF,CAAC;GACF,IAAI,WAAM;AACR,WAAO;gDAAc,mBAAC;;;;;;;;;;;;;;;;iJAgBD,QAAA,CAAA;;;qDAGjB;qDAAA,kCAAA;MACF,IAAE,YAAA;AACD,8DAAI,gDAAA,EAAA,CAAA;;MAEL,UAAQ,mBAAA;MACT,CAAC;qDAAY,OAAA,EAAA,CAAA;gDAAA,mBAAA;8EACR,SAAA,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kMA2BkD,SAAA,KAAA,CAAA;;;;;;UAMpD;KAAC;;GAER,CAAC;EAAC"}
1
+ {"version":3,"file":"exit-function-declaration.cjs","names":[],"sources":["../../src/components/exit-function-declaration.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 } from \"@alloy-js/core\";\nimport {\n FunctionDeclaration,\n IfStatement,\n InterfaceDeclaration,\n InterfaceMember,\n VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <InterfaceDeclaration\n export\n name=\"ExitOptions\"\n doc=\"Options for the exit handler function.\">\n <InterfaceMember\n name=\"exception\"\n optional\n type=\"string | Error\"\n doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n />\n <hbr />\n <InterfaceMember\n name=\"skipProcessExit\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n />\n <hbr />\n <InterfaceMember\n name=\"isSynchronous\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n />\n <hbr />\n <InterfaceMember\n name=\"signal\"\n optional\n type=\"number\"\n doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n />\n <hbr />\n <InterfaceMember\n name=\"startDate\"\n optional\n type=\"Date\"\n doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n />\n </InterfaceDeclaration>\n <Spacing />\n <VarDeclaration\n let\n name=\"isExiting\"\n type=\"boolean\"\n initializer={code`false;`}\n />\n <VarDeclaration\n const\n name=\"callbackAsyncQueue\"\n type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n initializer={code`[];`}\n />\n <VarDeclaration\n const\n name=\"callbackSyncQueue\"\n type=\"Array<(code: number | string) => void>\"\n initializer={code`[];`}\n />\n <Spacing />\n <FunctionDeclaration\n export\n async\n name=\"exit\"\n parameters={[\n {\n name: \"options\",\n type: \"ExitOptions\",\n default: \"{}\"\n }\n ]}>\n {code`\n try {\n if (isExiting) {\n return;\n }\n\n isExiting = true;\n\n let exitCode: number | string = 0;\n if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n exitCode = 128 + (options.signal ?? 1);\n } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n exitCode = process.exitCode;\n }\n\n if (options.exception) {\n error({ message: \\`A fatal error occured while running the application - please contact the ${getAppTitle(\n context\n )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`,\n ...(options.exception && typeof options.exception === \"object\" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})\n });\n }\n\n const terminate = (force = false) => { `}\n <IfStatement\n condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n <hbr />\n {code`\n verbose(\\`The ${getAppTitle(\n context,\n true\n )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(exitCode));\n }\n };\n\n for (const callbackSync of callbackSyncQueue) {\n callbackSync(exitCode);\n }\n\n if (!options.isSynchronous) {\n const promises = [];\n let forceAfter = 0;\n for (const [callbackAsync, wait] of callbackAsyncQueue) {\n forceAfter = Math.max(forceAfter, wait);\n promises.push(Promise.resolve(callbackAsync(exitCode)));\n }\n\n const asyncTimer = setTimeout(() => {\n terminate(true);\n }, forceAfter);\n await Promise.all(promises);\n clearTimeout(asyncTimer);\n }\n\n terminate();\n } catch (err) {\n error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n context,\n true\n )} support team.\\`);\n\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(1));\n }\n }\n `}\n </FunctionDeclaration>\n </>\n );\n}\n"],"mappings":";;;;;;;;;;;;;;AA8BA,SAAc,0BAA4B;;AAExC,QAAA;kDAAA,2CAAA;GACC,UAAW;GACZ,MAAA;GACF,KAAO;GACL,IAAM,WAAU;;;MAEV,MAAC;MACJ,UAAA;MACE,MAAA;MACC,KAAA;MACD,CAAC;qDAAiB,OAAA,EAAA,CAAA;qDAAA,sCAAA;MACjB,MAAK;MACL,UAAC;MACD,MAAM;MACN,KAAE;MACH,CAAC;qDAAiB,OAAK,EAAA,CAAA;qDAAA,sCAAA;MACtB,MAAM;MACN,UAAC;MACD,MAAM;MACN,KAAC;MACF,CAAC;qDAAQ,OAAe,EAAA,CAAA;qDAAA,sCAAA;MACvB,MAAE;MACF,UAAQ;MACR,MAAM;MACN,KAAC;MACF,CAAC;qDAAM,OAAA,EAAA,CAAA;qDAAA,sCAAA;MACN,MAAC;MACD,UAAQ;MACR,MAAE;MACF,KAAE;MACH,CAAC;KAAC;;GAEN,CAAC;kDAAU,0DAAA,EAAA,CAAA;kDAAA,qCAAA;GACV,OAAK;GACL,MAAM;GACN,MAAM;GACN,aAAY,mBAAA;GACb,CAAC;kDAAe,qCAAmB;GAClC,SAAK;GACL,MAAK;GACL,MAAK;GACL,aAAY,mBAAA;GACb,CAAC;kDAAM,qCAAA;GACN,SAAM;GACN,MAAM;GACN,MAAK;GACL,aAAI,mBAAA;GACL,CAAC;kDAAY,0DAAA,EAAA,CAAA;kDAAA,0CAAA;GACZ,UAAG;GACH,OAAI;GACJ,MAAI;GACJ,YAAU,CAAA;IACR,MAAE;IACF,MAAC;IACD,SAAC;IACF,CAAC;GACF,IAAI,WAAM;AACR,WAAO;gDAAc,mBAAC;;;;;;;;;;;;;;;;4JAgBD,QAAA,CAAA;;;;;qDAKd;qDAAA,kCAAA;MACL,IAAE,YAAI;AACJ,8DAAiB,gDAAA,EAAA,CAAA;;MAEnB,UAAI,mBAAA;;;;8EAEgB,SAAA,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kMA2BkC,SAAA,KAAA,CAAA;;;;;;UAMpD;KAAC;;GAER,CAAC;EAAC"}
package/dist/components/exit-function-declaration.mjs CHANGED
@@ -103,7 +103,9 @@ function ExitFunctionDeclaration() {
103
103
  }
104
104
 
105
105
  if (options.exception) {
106
- error(\`A fatal error occured while running the application - please contact the ${getAppTitle(context)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`);
106
+ error({ message: \`A fatal error occured while running the application - please contact the ${getAppTitle(context)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`,
107
+ ...(options.exception && typeof options.exception === "object" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})
108
+ });
107
109
  }
108
110
 
109
111
  const terminate = (force = false) => { `),
package/dist/components/exit-function-declaration.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"exit-function-declaration.mjs","names":[],"sources":["../../src/components/exit-function-declaration.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 } from \"@alloy-js/core\";\nimport {\n FunctionDeclaration,\n IfStatement,\n InterfaceDeclaration,\n InterfaceMember,\n VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <InterfaceDeclaration\n export\n name=\"ExitOptions\"\n doc=\"Options for the exit handler function.\">\n <InterfaceMember\n name=\"exception\"\n optional\n type=\"string | Error\"\n doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n />\n <hbr />\n <InterfaceMember\n name=\"skipProcessExit\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n />\n <hbr />\n <InterfaceMember\n name=\"isSynchronous\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n />\n <hbr />\n <InterfaceMember\n name=\"signal\"\n optional\n type=\"number\"\n doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n />\n <hbr />\n <InterfaceMember\n name=\"startDate\"\n optional\n type=\"Date\"\n doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n />\n </InterfaceDeclaration>\n <Spacing />\n <VarDeclaration\n let\n name=\"isExiting\"\n type=\"boolean\"\n initializer={code`false;`}\n />\n <VarDeclaration\n const\n name=\"callbackAsyncQueue\"\n type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n initializer={code`[];`}\n />\n <VarDeclaration\n const\n name=\"callbackSyncQueue\"\n type=\"Array<(code: number | string) => void>\"\n initializer={code`[];`}\n />\n <Spacing />\n <FunctionDeclaration\n export\n async\n name=\"exit\"\n parameters={[\n {\n name: \"options\",\n type: \"ExitOptions\",\n default: \"{}\"\n }\n ]}>\n {code`\n try {\n if (isExiting) {\n return;\n }\n\n isExiting = true;\n\n let exitCode: number | string = 0;\n if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n exitCode = 128 + (options.signal ?? 1);\n } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n exitCode = process.exitCode;\n }\n\n if (options.exception) {\n error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n context\n )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`);\n }\n\n const terminate = (force = false) => { `}\n <IfStatement\n condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n <hbr />\n {code`\n verbose(\\`The ${getAppTitle(\n context,\n true\n )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(exitCode));\n }\n };\n\n for (const callbackSync of callbackSyncQueue) {\n callbackSync(exitCode);\n }\n\n if (!options.isSynchronous) {\n const promises = [];\n let forceAfter = 0;\n for (const [callbackAsync, wait] of callbackAsyncQueue) {\n forceAfter = Math.max(forceAfter, wait);\n promises.push(Promise.resolve(callbackAsync(exitCode)));\n }\n\n const asyncTimer = setTimeout(() => {\n terminate(true);\n }, forceAfter);\n await Promise.all(promises);\n clearTimeout(asyncTimer);\n }\n\n terminate();\n } catch (err) {\n error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n context,\n true\n )} support team.\\`);\n\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(1));\n }\n }\n `}\n </FunctionDeclaration>\n </>\n );\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,SAAc,0BAA4B;;AAExC,QAAA;EAAA,gBAAA,sBAAA;GACC,UAAW;GACZ,MAAA;GACF,KAAO;GACL,IAAM,WAAU;;;MAEV,MAAC;MACJ,UAAA;MACE,MAAA;MACC,KAAA;MACD,CAAC;KAAA,gBAAiB,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACjB,MAAK;MACL,UAAC;MACD,MAAM;MACN,KAAE;MACH,CAAC;KAAE,gBAAe,OAAK,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACtB,MAAM;MACN,UAAC;MACD,MAAM;MACN,KAAC;MACF,CAAC;KAAE,gBAAM,OAAe,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACvB,MAAE;MACF,UAAQ;MACR,MAAM;MACN,KAAC;MACF,CAAC;KAAC,gBAAK,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACN,MAAC;MACD,UAAQ;MACR,MAAE;MACF,KAAE;MACH,CAAC;KAAC;;GAEN,CAAC;EAAE,gBAAQ,SAAA,EAAA,CAAA;EAAA,gBAAA,gBAAA;GACV,OAAK;GACL,MAAM;GACN,MAAM;GACN,aAAY,IAAA;GACb,CAAC;EAAE,gBAAa,gBAAmB;GAClC,SAAK;GACL,MAAK;GACL,MAAK;GACL,aAAY,IAAA;GACb,CAAC;EAAE,gBAAI,gBAAA;GACN,SAAM;GACN,MAAM;GACN,MAAK;GACL,aAAI,IAAA;GACL,CAAC;EAAE,gBAAU,SAAA,EAAA,CAAA;EAAA,gBAAA,qBAAA;GACZ,UAAG;GACH,OAAI;GACJ,MAAI;GACJ,YAAU,CAAA;IACR,MAAE;IACF,MAAC;IACD,SAAC;IACF,CAAC;GACF,IAAI,WAAM;AACR,WAAO;KAAC,WAAa,IAAC;;;;;;;;;;;;;;;;iGAgBD,YAAA,QAAA,CAAA;;;qDAGjB;KAAA,gBAAA,aAAA;MACF,IAAE,YAAA;AACD,cAAI,gBAAA,WAAA,EAAA,CAAA;;MAEL,UAAQ,IAAA;MACT,CAAC;KAAE,gBAAU,OAAA,EAAA,CAAA;KAAA,WAAA,IAAA;8BACR,YAAA,SAAA,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2BkD,YAAA,SAAA,KAAA,CAAA;;;;;;UAMpD;KAAC;;GAER,CAAC;EAAC"}
1
+ {"version":3,"file":"exit-function-declaration.mjs","names":[],"sources":["../../src/components/exit-function-declaration.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 } from \"@alloy-js/core\";\nimport {\n FunctionDeclaration,\n IfStatement,\n InterfaceDeclaration,\n InterfaceMember,\n VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <InterfaceDeclaration\n export\n name=\"ExitOptions\"\n doc=\"Options for the exit handler function.\">\n <InterfaceMember\n name=\"exception\"\n optional\n type=\"string | Error\"\n doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n />\n <hbr />\n <InterfaceMember\n name=\"skipProcessExit\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n />\n <hbr />\n <InterfaceMember\n name=\"isSynchronous\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n />\n <hbr />\n <InterfaceMember\n name=\"signal\"\n optional\n type=\"number\"\n doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n />\n <hbr />\n <InterfaceMember\n name=\"startDate\"\n optional\n type=\"Date\"\n doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n />\n </InterfaceDeclaration>\n <Spacing />\n <VarDeclaration\n let\n name=\"isExiting\"\n type=\"boolean\"\n initializer={code`false;`}\n />\n <VarDeclaration\n const\n name=\"callbackAsyncQueue\"\n type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n initializer={code`[];`}\n />\n <VarDeclaration\n const\n name=\"callbackSyncQueue\"\n type=\"Array<(code: number | string) => void>\"\n initializer={code`[];`}\n />\n <Spacing />\n <FunctionDeclaration\n export\n async\n name=\"exit\"\n parameters={[\n {\n name: \"options\",\n type: \"ExitOptions\",\n default: \"{}\"\n }\n ]}>\n {code`\n try {\n if (isExiting) {\n return;\n }\n\n isExiting = true;\n\n let exitCode: number | string = 0;\n if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n exitCode = 128 + (options.signal ?? 1);\n } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n exitCode = process.exitCode;\n }\n\n if (options.exception) {\n error({ message: \\`A fatal error occured while running the application - please contact the ${getAppTitle(\n context\n )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`,\n ...(options.exception && typeof options.exception === \"object\" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})\n });\n }\n\n const terminate = (force = false) => { `}\n <IfStatement\n condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n <hbr />\n {code`\n verbose(\\`The ${getAppTitle(\n context,\n true\n )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(exitCode));\n }\n };\n\n for (const callbackSync of callbackSyncQueue) {\n callbackSync(exitCode);\n }\n\n if (!options.isSynchronous) {\n const promises = [];\n let forceAfter = 0;\n for (const [callbackAsync, wait] of callbackAsyncQueue) {\n forceAfter = Math.max(forceAfter, wait);\n promises.push(Promise.resolve(callbackAsync(exitCode)));\n }\n\n const asyncTimer = setTimeout(() => {\n terminate(true);\n }, forceAfter);\n await Promise.all(promises);\n clearTimeout(asyncTimer);\n }\n\n terminate();\n } catch (err) {\n error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n context,\n true\n )} support team.\\`);\n\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(1));\n }\n }\n `}\n </FunctionDeclaration>\n </>\n );\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,SAAc,0BAA4B;;AAExC,QAAA;EAAA,gBAAA,sBAAA;GACC,UAAW;GACZ,MAAA;GACF,KAAO;GACL,IAAM,WAAU;;;MAEV,MAAC;MACJ,UAAA;MACE,MAAA;MACC,KAAA;MACD,CAAC;KAAA,gBAAiB,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACjB,MAAK;MACL,UAAC;MACD,MAAM;MACN,KAAE;MACH,CAAC;KAAE,gBAAe,OAAK,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACtB,MAAM;MACN,UAAC;MACD,MAAM;MACN,KAAC;MACF,CAAC;KAAE,gBAAM,OAAe,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACvB,MAAE;MACF,UAAQ;MACR,MAAM;MACN,KAAC;MACF,CAAC;KAAC,gBAAK,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACN,MAAC;MACD,UAAQ;MACR,MAAE;MACF,KAAE;MACH,CAAC;KAAC;;GAEN,CAAC;EAAE,gBAAQ,SAAA,EAAA,CAAA;EAAA,gBAAA,gBAAA;GACV,OAAK;GACL,MAAM;GACN,MAAM;GACN,aAAY,IAAA;GACb,CAAC;EAAE,gBAAa,gBAAmB;GAClC,SAAK;GACL,MAAK;GACL,MAAK;GACL,aAAY,IAAA;GACb,CAAC;EAAE,gBAAI,gBAAA;GACN,SAAM;GACN,MAAM;GACN,MAAK;GACL,aAAI,IAAA;GACL,CAAC;EAAE,gBAAU,SAAA,EAAA,CAAA;EAAA,gBAAA,qBAAA;GACZ,UAAG;GACH,OAAI;GACJ,MAAI;GACJ,YAAU,CAAA;IACR,MAAE;IACF,MAAC;IACD,SAAC;IACF,CAAC;GACF,IAAI,WAAM;AACR,WAAO;KAAC,WAAa,IAAC;;;;;;;;;;;;;;;;4GAgBD,YAAA,QAAA,CAAA;;;;;qDAKd;KAAA,gBAAA,aAAA;MACL,IAAE,YAAI;AACJ,cAAM,gBAAW,WAAA,EAAA,CAAA;;MAEnB,UAAI,IAAA;;;;8BAEgB,YAAA,SAAA,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2BkC,YAAA,SAAA,KAAA,CAAA;;;;;;UAMpD;KAAC;;GAER,CAAC;EAAC"}
package/dist/index.cjs CHANGED
@@ -55,7 +55,6 @@ const plugin = (options = {}) => {
55
55
  ],
56
56
  utils: ["isMinimal"],
57
57
  state: [
58
- "useGlobal",
59
58
  "useArgs",
60
59
  "hasFlag",
61
60
  "isHelp"
package/dist/index.cjs.map CHANGED
@@ -1 +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 banner from \"@shell-shock/plugin-banner\";\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 { getGlobalOptions } from \"./helpers/get-global-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<TContext>(options),\n ...help<TContext>(options),\n ...banner<TContext>(options.banner),\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 globalOptions: getGlobalOptions,\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 \"help\"\n ],\n utils: [\"isMinimal\"],\n state: [\"useGlobal\", \"useArgs\", \"hasFlag\", \"isHelp\"]\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":";;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;EAAA,4CAAA,QAAA;EAAA,yCAAA,QAAA;EAAA,2CAAA,QAAA,OAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACH,WAAC;KACA,eAAe;KACf,iBAAiB;KACpB,GAAA;KACE;;GAEH;EAAE;GACD,MAAM;GACN,SAAK;;IAEH,MAAE,UAAO;KACP,MAAE,SAAa;AACf,UAAE,MAAA,oEAAsB;AACxB,wDAAK,MAAA,iDAAA,uCAAA;MACJ,gBAAA;OACH,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA,CAAA,YAAA;OACD,OAAA;QAAA;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;wDAAK,kDAAA,EAAA,CAAA;QAAA,mBAAA;wDAAA,kDAAA,EAAA,CAAA;QAAA,mBAAA;QAAA;;MAEV,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"}
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 banner from \"@shell-shock/plugin-banner\";\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 { getGlobalOptions } from \"./helpers/get-global-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<TContext>(options),\n ...help<TContext>(options),\n ...banner<TContext>(options.banner),\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 globalOptions: getGlobalOptions,\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 \"help\"\n ],\n utils: [\"isMinimal\"],\n state: [\"useArgs\", \"hasFlag\", \"isHelp\"]\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":";;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;EAAA,4CAAA,QAAA;EAAA,yCAAA,QAAA;EAAA,2CAAA,QAAA,OAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACH,WAAC;KACA,eAAe;KACf,iBAAiB;KACpB,GAAA;KACE;;GAEH;EAAE;GACD,MAAM;GACN,SAAK;;IAEH,MAAE,UAAO;KACP,MAAE,SAAa;AACf,UAAE,MAAA,oEAAsB;AACxB,wDAAK,MAAA,iDAAA,uCAAA;MACJ,gBAAA;OACH,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA,CAAA,YAAA;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;wDAAK,kDAAA,EAAA,CAAA;QAAA,mBAAA;wDAAA,kDAAA,EAAA,CAAA;QAAA,mBAAA;QAAA;;MAEV,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.mjs CHANGED
@@ -50,7 +50,6 @@ const plugin = (options = {}) => {
50
50
  ],
51
51
  utils: ["isMinimal"],
52
52
  state: [
53
- "useGlobal",
54
53
  "useArgs",
55
54
  "hasFlag",
56
55
  "isHelp"
package/dist/index.mjs.map CHANGED
@@ -1 +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 banner from \"@shell-shock/plugin-banner\";\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 { getGlobalOptions } from \"./helpers/get-global-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<TContext>(options),\n ...help<TContext>(options),\n ...banner<TContext>(options.banner),\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 globalOptions: getGlobalOptions,\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 \"help\"\n ],\n utils: [\"isMinimal\"],\n state: [\"useGlobal\", \"useArgs\", \"hasFlag\", \"isHelp\"]\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":";;;;;;;;;;;;;;;;;;AAqCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;EAAA,GAAA,QAAA,QAAA;EAAA,GAAA,KAAA,QAAA;EAAA,GAAA,OAAA,QAAA,OAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACH,WAAC;KACA,eAAe;KACf,iBAAiB;KACpB,GAAA;KACE;;GAEH;EAAE;GACD,MAAM;GACN,SAAK;;IAEH,MAAE,UAAO;KACP,MAAE,SAAa;AACf,UAAE,MAAA,oEAAsB;AACxB,YAAK,OAAA,MAAA,CAAA,gBAAA,UAAA;MACJ,gBAAA;OACH,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA,CAAA,YAAA;OACD,OAAA;QAAA;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,gBAAG,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA,gBAAA,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA;;MAEV,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"}
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 banner from \"@shell-shock/plugin-banner\";\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 { getGlobalOptions } from \"./helpers/get-global-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<TContext>(options),\n ...help<TContext>(options),\n ...banner<TContext>(options.banner),\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 globalOptions: getGlobalOptions,\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 \"help\"\n ],\n utils: [\"isMinimal\"],\n state: [\"useArgs\", \"hasFlag\", \"isHelp\"]\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":";;;;;;;;;;;;;;;;;;AAqCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;EAAA,GAAA,QAAA,QAAA;EAAA,GAAA,KAAA,QAAA;EAAA,GAAA,OAAA,QAAA,OAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACH,WAAC;KACA,eAAe;KACf,iBAAiB;KACpB,GAAA;KACE;;GAEH;EAAE;GACD,MAAM;GACN,SAAK;;IAEH,MAAE,UAAO;KACP,MAAE,SAAa;AACf,UAAE,MAAA,oEAAsB;AACxB,YAAK,OAAA,MAAA,CAAA,gBAAA,UAAA;MACJ,gBAAA;OACH,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA,CAAA,YAAA;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,gBAAG,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA,gBAAA,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA;;MAEV,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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shell-shock/preset-script",
3
- "version": "0.6.58",
3
+ "version": "0.6.59",
4
4
  "private": false,
5
5
  "description": "A Shell Shock preset that generates a fully-featured script application.",
6
6
  "keywords": [
@@ -195,25 +195,25 @@
195
195
  "dependencies": {
196
196
  "@alloy-js/core": "0.23.0-dev.8",
197
197
  "@alloy-js/typescript": "0.23.0-dev.4",
198
- "@powerlines/deepkit": "^0.8.0",
199
- "@powerlines/plugin-alloy": "^0.26.15",
200
- "@powerlines/plugin-plugin": "^0.12.347",
201
- "@shell-shock/core": "^0.17.3",
202
- "@shell-shock/plugin-banner": "^0.1.30",
203
- "@shell-shock/plugin-help": "^0.2.21",
204
- "@shell-shock/plugin-console": "^0.2.7",
205
- "@shell-shock/plugin-theme": "^0.4.16",
198
+ "@powerlines/deepkit": "^0.8.1",
199
+ "@powerlines/plugin-alloy": "^0.26.16",
200
+ "@powerlines/plugin-plugin": "^0.12.348",
201
+ "@shell-shock/core": "^0.17.4",
202
+ "@shell-shock/plugin-banner": "^0.1.31",
203
+ "@shell-shock/plugin-help": "^0.2.22",
204
+ "@shell-shock/plugin-console": "^0.2.8",
205
+ "@shell-shock/plugin-theme": "^0.4.17",
206
206
  "@stryke/helpers": "^0.10.8",
207
207
  "@stryke/path": "^0.27.4",
208
208
  "@stryke/string-format": "^0.17.9",
209
209
  "defu": "^6.1.7",
210
- "powerlines": "^0.42.37"
210
+ "powerlines": "^0.42.38"
211
211
  },
212
212
  "devDependencies": {
213
213
  "@babel/core": "^7.29.0",
214
- "@powerlines/plugin-alloy": "^0.26.15",
214
+ "@powerlines/plugin-alloy": "^0.26.16",
215
215
  "@types/node": "^25.6.0"
216
216
  },
217
217
  "publishConfig": { "access": "public" },
218
- "gitHead": "d6ec6746792a83206915332c4eb87c9da70a5148"
218
+ "gitHead": "1364666ac28f03cca26271afb582c71a2fe12ecd"
219
219
  }