@shell-shock/preset-script 0.6.21 → 0.6.22

package/dist/components/exit-function-declaration.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"exit-function-declaration.cjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","IsVerbose","getAppTitle","ExitFunctionDeclaration","context","_$createComponent","name","doc","children","optional","type","_$createIntrinsic","initializer","async","parameters","default","_$memo","condition"],"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/context-helpers\";\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              )} 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            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAmCA,SAAgBU,0BAA0B;CACxC,MAAMC,8EAA8C;AAEpD,QAAA;mDAEKR,4CAAoB;GAAA,UAAA;GAEnBU,MAAI;GACJC,KAAG;GAAA,IAAAC,WAAA;AAAA,WAAA;sDACFX,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAA;;GAAA,CAAA;mDAGNR,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,OAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAQ,CAAA;mDAE1BK,sCAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAK,CAAA;mDAEvBK,sCAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAK,CAAA;mDAEvBM,2DAAO,EAAA,CAAA;mDACPL,2CAAmB;GAAA,UAAA;GAElBmB,OAAK;GACLP,MAAI;GACJQ,YAAY,CACV;IACER,MAAM;IACNI,MAAM;IACNK,SAAS;IACV,CACF;GAAA,IAAAP,WAAA;AAAA,WAAA;iDACAf,oBAAI;;;;;;;;;;;;;;;;kKAiBGW,QACD,CAAA;;;qDAGqC;sDAC3CT,mCAAW;MAAA,IACVsB,YAAS;AAAA,+DAAGhB,iDAAS,EAAA,CAAA;;MAAAO,UAAMf,oBAAI;MAAgB,CAAA;sDAAA,OAAA,EAAA,CAAA;iDAEhDA,oBAAI;+FAEGW,QACD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;mNA4BDA,QACD,CAAA;;;;;;UAMJ;KAAA;;GAAA,CAAA;EAAA"}
+{"version":3,"file":"exit-function-declaration.cjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","IsVerbose","getAppTitle","ExitFunctionDeclaration","context","_$createComponent","name","doc","children","optional","type","_$createIntrinsic","initializer","async","parameters","default","_$memo","condition"],"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              )} 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            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAmCA,SAAgBU,0BAA0B;CACxC,MAAMC,8EAA8C;AAEpD,QAAA;mDAEKR,4CAAoB;GAAA,UAAA;GAEnBU,MAAI;GACJC,KAAG;GAAA,IAAAC,WAAA;AAAA,WAAA;sDACFX,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAA;;GAAA,CAAA;mDAGNR,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,OAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAQ,CAAA;mDAE1BK,sCAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAK,CAAA;mDAEvBK,sCAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAK,CAAA;mDAEvBM,2DAAO,EAAA,CAAA;mDACPL,2CAAmB;GAAA,UAAA;GAElBmB,OAAK;GACLP,MAAI;GACJQ,YAAY,CACV;IACER,MAAM;IACNI,MAAM;IACNK,SAAS;IACV,CACF;GAAA,IAAAP,WAAA;AAAA,WAAA;iDACAf,oBAAI;;;;;;;;;;;;;;;;kJAiBGW,QACD,CAAA;;;qDAGqC;sDAC3CT,mCAAW;MAAA,IACVsB,YAAS;AAAA,+DAAGhB,iDAAS,EAAA,CAAA;;MAAAO,UAAMf,oBAAI;MAAgB,CAAA;sDAAA,OAAA,EAAA,CAAA;iDAEhDA,oBAAI;+EAEGW,QACD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;mMA4BDA,QACD,CAAA;;;;;;UAMJ;KAAA;;GAAA,CAAA;EAAA"}

package/dist/components/exit-function-declaration.d.cts

@@ -1,10 +1,10 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core5 from "@alloy-js/core";
 
 //#region src/components/exit-function-declaration.d.ts
 /**
  * The `exit` handler function declaration code for the Shell Shock project.
  */
-declare function ExitFunctionDeclaration(): _alloy_js_core0.Children;
+declare function ExitFunctionDeclaration(): _alloy_js_core5.Children;
 //#endregion
 export { ExitFunctionDeclaration };
 //# sourceMappingURL=exit-function-declaration.d.cts.map

package/dist/components/exit-function-declaration.d.mts

@@ -1,10 +1,10 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core5 from "@alloy-js/core";
 
 //#region src/components/exit-function-declaration.d.ts
 /**
  * The `exit` handler function declaration code for the Shell Shock project.
  */
-declare function ExitFunctionDeclaration(): _alloy_js_core0.Children;
+declare function ExitFunctionDeclaration(): _alloy_js_core5.Children;
 //#endregion
 export { ExitFunctionDeclaration };
 //# sourceMappingURL=exit-function-declaration.d.mts.map

package/dist/components/exit-function-declaration.mjs

@@ -3,7 +3,7 @@ import { code } from "@alloy-js/core";
 import { FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, VarDeclaration } from "@alloy-js/typescript";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { getAppTitle } from "@shell-shock/core/plugin-utils/context-helpers";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
 import { IsVerbose } from "@shell-shock/core/components/helpers";
 
 //#region src/components/exit-function-declaration.tsx

package/dist/components/exit-function-declaration.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"exit-function-declaration.mjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","IsVerbose","getAppTitle","ExitFunctionDeclaration","context","_$createComponent","name","doc","children","optional","type","_$createIntrinsic","initializer","async","parameters","default","_$memo","condition"],"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/context-helpers\";\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              )} 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            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAmCA,SAAgBU,0BAA0B;CACxC,MAAMC,UAAUJ,eAAoC;AAEpD,QAAA;EAAAK,gBAEKT,sBAAoB;GAAA,UAAA;GAEnBU,MAAI;GACJC,KAAG;GAAA,IAAAC,WAAA;AAAA,WAAA;KAAAH,gBACFR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAA;;GAAA,CAAA;EAAAF,gBAGNN,SAAO,EAAA,CAAA;EAAAM,gBACPP,gBAAc;GAAA,OAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAQ,CAAA;EAAAY,gBAE1BP,gBAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAK,CAAA;EAAAY,gBAEvBP,gBAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAK,CAAA;EAAAY,gBAEvBN,SAAO,EAAA,CAAA;EAAAM,gBACPX,qBAAmB;GAAA,UAAA;GAElBmB,OAAK;GACLP,MAAI;GACJQ,YAAY,CACV;IACER,MAAM;IACNI,MAAM;IACNK,SAAS;IACV,CACF;GAAA,IAAAP,WAAA;AAAA,WAAA;KAAAQ,WACAvB,IAAI;;;;;;;;;;;;;;;;iGAgBoFS,YACjFE,QACD,CAAA;;;qDAGqC;KAAAC,gBAC3CV,aAAW;MAAA,IACVsB,YAAS;AAAA,cAAAZ,gBAAGJ,WAAS,EAAA,CAAA;;MAAAO,UAAMf,IAAI;MAAgB,CAAA;KAAAkB,gBAAA,OAAA,EAAA,CAAA;KAAAK,WAEhDvB,IAAI;8BACiBS,YACdE,QACD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2BmIF,YACpIE,QACD,CAAA;;;;;;UAMJ;KAAA;;GAAA,CAAA;EAAA"}
+{"version":3,"file":"exit-function-declaration.mjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","IsVerbose","getAppTitle","ExitFunctionDeclaration","context","_$createComponent","name","doc","children","optional","type","_$createIntrinsic","initializer","async","parameters","default","_$memo","condition"],"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              )} 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            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAmCA,SAAgBU,0BAA0B;CACxC,MAAMC,UAAUJ,eAAoC;AAEpD,QAAA;EAAAK,gBAEKT,sBAAoB;GAAA,UAAA;GAEnBU,MAAI;GACJC,KAAG;GAAA,IAAAC,WAAA;AAAA,WAAA;KAAAH,gBACFR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAA;;GAAA,CAAA;EAAAF,gBAGNN,SAAO,EAAA,CAAA;EAAAM,gBACPP,gBAAc;GAAA,OAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAQ,CAAA;EAAAY,gBAE1BP,gBAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAK,CAAA;EAAAY,gBAEvBP,gBAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAK,CAAA;EAAAY,gBAEvBN,SAAO,EAAA,CAAA;EAAAM,gBACPX,qBAAmB;GAAA,UAAA;GAElBmB,OAAK;GACLP,MAAI;GACJQ,YAAY,CACV;IACER,MAAM;IACNI,MAAM;IACNK,SAAS;IACV,CACF;GAAA,IAAAP,WAAA;AAAA,WAAA;KAAAQ,WACAvB,IAAI;;;;;;;;;;;;;;;;iGAgBoFS,YACjFE,QACD,CAAA;;;qDAGqC;KAAAC,gBAC3CV,aAAW;MAAA,IACVsB,YAAS;AAAA,cAAAZ,gBAAGJ,WAAS,EAAA,CAAA;;MAAAO,UAAMf,IAAI;MAAgB,CAAA;KAAAkB,gBAAA,OAAA,EAAA,CAAA;KAAAK,WAEhDvB,IAAI;8BACiBS,YACdE,QACD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2BmIF,YACpIE,QACD,CAAA;;;;;;UAMJ;KAAA;;GAAA,CAAA;EAAA"}

package/dist/components/help.cjs

@@ -3,11 +3,10 @@ let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
 let __powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
 let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
-let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
+let __shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
 let __shell_shock_plugin_theme_contexts_theme = require("@shell-shock/plugin-theme/contexts/theme");
-let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __shell_shock_core = require("@shell-shock/core");
 let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
-let __shell_shock_core_plugin_utils_reflect = require("@shell-shock/core/plugin-utils/reflect");
 let __stryke_string_format_snake_case = require("@stryke/string-format/snake-case");
 
 //#region src/components/help.tsx
@@ -25,11 +24,11 @@ function HelpUsage(props) {
 		hardline: true,
 		children: (bin) => [(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
       writeLine(
-        colors.text.body.secondary(\`\$ \${colors.text.usage.bin("${bin}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${colors.text.usage.${(0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? `[${(0, __stryke_string_format_snake_case.snakeCase)((0, __shell_shock_core_plugin_utils_context_helpers.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${colors.text.usage.dynamic("[command]")}` : ""}${command.arguments.length > 0 ? ` ${command.arguments.map((argument) => `\${colors.text.usage.arguments("<${(0, __stryke_string_format_snake_case.snakeCase)(argument.name)}${(argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) && argument.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${colors.text.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
+        colors.text.body.secondary(\`\$ \${colors.text.usage.bin("${bin}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${colors.text.usage.${(0, __shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, __shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, __stryke_string_format_snake_case.snakeCase)((0, __shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${colors.text.usage.dynamic("[command]")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${colors.text.usage.args("<${(0, __stryke_string_format_snake_case.snakeCase)((arg.kind === __shell_shock_core.CommandParameterKinds.string || arg.kind === __shell_shock_core.CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join("|") : arg.kind === __shell_shock_core.CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === __shell_shock_core.CommandParameterKinds.string || arg.kind === __shell_shock_core.CommandParameterKinds.number) && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${colors.text.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
       );`), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})]
 	}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 		get when() {
-			return command.arguments.length > 0;
+			return command.args.length > 0;
 		},
 		get children() {
 			return [(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
@@ -39,7 +38,7 @@ function HelpUsage(props) {
 				hardline: true,
 				children: (bin) => [(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
       writeLine(
-        colors.text.body.secondary(\`\$ \${colors.text.usage.bin("${bin}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${colors.text.usage.${(0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? `[${(0, __stryke_string_format_snake_case.snakeCase)((0, __shell_shock_core_plugin_utils_context_helpers.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${colors.text.usage.dynamic("[command]")}` : ""} \${colors.text.usage.options("[options]")}${command.arguments.length > 0 ? ` ${command.arguments.map((argument) => `\${colors.text.usage.arguments("<${(0, __stryke_string_format_snake_case.snakeCase)(argument.name)}${(argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || argument.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) && argument.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${theme.padding.app * indent} }
+        colors.text.body.secondary(\`\$ \${colors.text.usage.bin("${bin}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${colors.text.usage.${(0, __shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? "dynamic" : "command"}("${(0, __shell_shock_core_plugin_utils.isDynamicPathSegment)(segment) ? `[${(0, __stryke_string_format_snake_case.snakeCase)((0, __shell_shock_core_plugin_utils.getDynamicPathSegmentName)(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${colors.text.usage.dynamic("[command]")}` : ""} \${colors.text.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${colors.text.usage.args("<${(0, __stryke_string_format_snake_case.snakeCase)((arg.kind === __shell_shock_core.CommandParameterKinds.string || arg.kind === __shell_shock_core.CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join("|") : arg.kind === __shell_shock_core.CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === __shell_shock_core.CommandParameterKinds.string || arg.kind === __shell_shock_core.CommandParameterKinds.number) && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${theme.padding.app * indent} }
       );`), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})]
 			})];
 		}
@@ -56,7 +55,7 @@ function HelpOptions(props) {
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
 			get each() {
-				return (0, __shell_shock_core_plugin_utils_reflect.sortOptions)(options);
+				return (0, __shell_shock_core_plugin_utils.sortOptions)(options);
 			},
 			hardline: true,
 			children: (option) => {
@@ -68,7 +67,7 @@ function HelpOptions(props) {
 					if (alias.length === 1) flags.push(`-${alias}`);
 					else names.push(`--${(0, __stryke_string_format_kebab_case.kebabCase)(alias)}`);
 				});
-				return __alloy_js_core.code`[{ value: colors.text.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.name)}${option.variadic ? "..." : ""}>` : option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: colors.text.body.tertiary("${option.description.replace(/\.+$/, "")} ${option.env || option.default !== void 0 ? `(${option.env ? `env: ${context.config.envPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/"/g, "\\\"")}` : ""})` : ""}."), align: "left", border: "none" }], `;
+				return __alloy_js_core.code`[{ value: colors.text.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === __shell_shock_core.CommandParameterKinds.string ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.format ? option.format : option.name)}${option.variadic ? "..." : ""}>` : option.kind === __shell_shock_core.CommandParameterKinds.number ? ` <${(0, __stryke_string_format_snake_case.snakeCase)(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: colors.text.body.tertiary("${option.description.replace(/\.+$/, "")} ${option.env || option.default !== void 0 ? `(${option.env ? `env: ${context.config.envPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/"/g, "\\\"")}` : ""})` : ""}."), align: "left", border: "none" }], `;
 			}
 		}),
 		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
@@ -192,7 +191,7 @@ function VirtualHelp(props) {
 							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
 						]
 					}),
-					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`help("Running a specific command with the help flag (via: '${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)}${segments && segments.length > 0 ? ` ${segments.join(" ")}` : ""} <specific command> --help') will provide additional information that is specific to that command.");
+					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`help("Running a specific command with the help flag (via: '${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}${segments && segments.length > 0 ? ` ${segments.join(" ")}` : ""} <specific command> --help') will provide additional information that is specific to that command.");
         writeLine("");`)
 				];
 			}
@@ -247,7 +246,7 @@ function CommandHelp(props) {
 							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
 						]
 					}),
-					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`help("Running a specific command with the help flag (via: '${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)} ${command.segments.join(" ")} <specific command> --help') will provide additional information that is specific to that command.");
+					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`help("Running a specific command with the help flag (via: '${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} ${command.segments.join(" ")} <specific command> --help') will provide additional information that is specific to that command.");
         writeLine("");`)
 				];
 			}

package/dist/components/help.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"help.cjs","names":["code","computed","For","Show","ReflectionKind","Spacing","usePowerlines","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","sortOptions","useTheme","kebabCase","snakeCase","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","segments","length","map","segment","join","values","arguments","argument","name","kind","string","number","variadic","padding","app","_$createIntrinsic","when","HelpOptions","options","option","flags","names","push","alias","forEach","sort","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","value","VirtualHelp","doubleHardline","joiner","ender","icon","title","isVirtual","CommandHelp"],"sources":["../../src/components/help.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n  CommandOption,\n  CommandTree\n} from \"@shell-shock/core/types/command\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 2\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsage(props: HelpUsageProps) {\n  const { command, indent = 2 } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const theme = useTheme();\n\n  return (\n    <>\n      <For each={Object.keys(context.config.bin)} hardline>\n        {bin => (\n          <>\n            {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${\n          command.arguments.length > 0\n            ? ` ${command.arguments\n                .map(\n                  argument =>\n                    `\\${colors.text.usage.arguments(\"<${snakeCase(argument.name)}${\n                      (argument.kind === ReflectionKind.string ||\n                        argument.kind === ReflectionKind.number) &&\n                      argument.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        } \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n            <hbr />\n          </>\n        )}\n      </For>\n      <Show when={command.arguments.length > 0}>\n        <hbr />\n        <For each={Object.keys(context.config.bin)} hardline>\n          {bin => (\n            <>\n              {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${\n          command.arguments.length > 0\n            ? ` ${command.arguments\n                .map(\n                  argument =>\n                    `\\${colors.text.usage.arguments(\"<${snakeCase(argument.name)}${\n                      (argument.kind === ReflectionKind.string ||\n                        argument.kind === ReflectionKind.number) &&\n                      argument.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n              <hbr />\n            </>\n          )}\n        </For>\n      </Show>\n    </>\n  );\n}\n\nexport interface HelpOptionsProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: HelpOptionsProps) {\n  const { options } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={sortOptions(options)} hardline>\n        {option => {\n          const flags = [] as string[];\n          const names = [] as string[];\n          if (option.name.length === 1) {\n            flags.push(`-${option.name}`);\n          } else {\n            names.push(`--${kebabCase(option.name)}`);\n          }\n\n          option.alias.forEach((alias: string) => {\n            if (alias.length === 1) {\n              flags.push(`-${alias}`);\n            } else {\n              names.push(`--${kebabCase(alias)}`);\n            }\n          });\n\n          return code`[{ value: colors.text.body.primary(\"${\n            flags.length > 0\n              ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n              : \"\"\n          }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n            option.kind === ReflectionKind.string\n              ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === ReflectionKind.number\n                ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n            /\\.+$/,\n            \"\"\n          )} ${\n            option.env || option.default !== undefined\n              ? `(${\n                  option.env\n                    ? `env: ${context.config.envPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default).replace(/\"/g, '\\\\\"')}`\n                    : \"\"\n                })`\n              : \"\"\n          }.\"), align: \"left\", border: \"none\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpCommandsProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: HelpCommandsProps) {\n  const { commands } = props;\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={Object.values(commands)} hardline>\n        {child =>\n          code`[{ value: colors.text.body.primary(\"${\n            child.name\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface BaseHelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * Whether to filter out global options from the help display.\n   *\n   * @remarks\n   * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n   *\n   * @defaultValue false\n   */\n  filterGlobalOptions?: boolean;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 1\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function BaseHelp(props: BaseHelpProps) {\n  const { command, indent = 1, filterGlobalOptions = false } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(() =>\n    filterGlobalOptions\n      ? Object.values(command.options).filter(\n          option =>\n            !context.options.some(\n              globalOption =>\n                globalOption.name === option.name ||\n                option.alias.includes(globalOption.name) ||\n                globalOption.alias?.includes(option.name) ||\n                globalOption.alias?.some(alias => option.alias.includes(alias))\n            )\n        )\n      : Object.values(command.options)\n  );\n\n  return (\n    <>\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpUsage command={command} indent={indent} />\n      <Spacing />\n      <Show when={options.value.length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpOptions options={options.value} />\n        <hbr />\n        <hbr />\n      </Show>\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpCommands commands={command.children} />\n        <hbr />\n        <hbr />\n      </Show>\n    </>\n  );\n}\n\nexport interface VirtualHelpProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n\n  /**\n   * The command path to generate help for, used for generating the help invocation instructions.\n   *\n   * @remarks\n   * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n   */\n  segments?: string[];\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n  const { options, segments, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <Show when={Object.keys(commands).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(commands)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )}${\n          segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n        } <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n\nexport interface CommandHelpProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelp(props: CommandHelpProps) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <BaseHelp command={command} filterGlobalOptions={false} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(command.children)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} ${command.segments.join(\n          \" \"\n        )} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"help.cjs","names":["code","computed","For","Show","Spacing","usePowerlines","CommandParameterKinds","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","sortOptions","useTheme","kebabCase","snakeCase","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","segments","length","map","segment","join","values","args","arg","kind","string","number","choices","format","name","variadic","padding","app","_$createIntrinsic","when","HelpOptions","options","option","flags","names","push","alias","forEach","sort","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","value","VirtualHelp","doubleHardline","joiner","ender","icon","title","isVirtual","CommandHelp"],"sources":["../../src/components/help.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { CommandOption, CommandTree } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  sortOptions\n} from \"@shell-shock/core/plugin-utils\";\nimport { useTheme } from \"@shell-shock/plugin-theme/contexts/theme\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 2\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsage(props: HelpUsageProps) {\n  const { command, indent = 2 } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const theme = useTheme();\n\n  return (\n    <>\n      <For each={Object.keys(context.config.bin)} hardline>\n        {bin => (\n          <>\n            {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        } \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n            <hbr />\n          </>\n        )}\n      </For>\n      <Show when={command.args.length > 0}>\n        <hbr />\n        <For each={Object.keys(context.config.bin)} hardline>\n          {bin => (\n            <>\n              {code`\n      writeLine(\n        colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n          command.segments.length > 0\n            ? ` ${command.segments\n                .map(\n                  segment =>\n                    `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n                      isDynamicPathSegment(segment)\n                        ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n                        : segment\n                    }\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${\n          command.args.length > 0\n            ? ` ${command.args\n                .map(\n                  arg =>\n                    `\\${colors.text.usage.args(\"<${snakeCase(\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                        arg.choices &&\n                        arg.choices.length > 0\n                        ? arg.choices.join(\"|\")\n                        : arg.kind === CommandParameterKinds.string &&\n                            arg.format\n                          ? arg.format\n                          : arg.name\n                    )}${\n                      (arg.kind === CommandParameterKinds.string ||\n                        arg.kind === CommandParameterKinds.number) &&\n                      arg.variadic\n                        ? \"...\"\n                        : \"\"\n                    }>\")}`\n                )\n                .join(\" \")}`\n            : \"\"\n        }\\`), { padding: ${theme.padding.app * indent} }\n      );`}\n              <hbr />\n            </>\n          )}\n        </For>\n      </Show>\n    </>\n  );\n}\n\nexport interface HelpOptionsProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: HelpOptionsProps) {\n  const { options } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={sortOptions(options)} hardline>\n        {option => {\n          const flags = [] as string[];\n          const names = [] as string[];\n          if (option.name.length === 1) {\n            flags.push(`-${option.name}`);\n          } else {\n            names.push(`--${kebabCase(option.name)}`);\n          }\n\n          option.alias.forEach((alias: string) => {\n            if (alias.length === 1) {\n              flags.push(`-${alias}`);\n            } else {\n              names.push(`--${kebabCase(alias)}`);\n            }\n          });\n\n          return code`[{ value: colors.text.body.primary(\"${\n            flags.length > 0\n              ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n              : \"\"\n          }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n            option.kind === CommandParameterKinds.string\n              ? ` <${snakeCase(\n                  option.choices && option.choices.length > 0\n                    ? option.choices.join(\"|\")\n                    : option.format\n                      ? option.format\n                      : option.name\n                )}${option.variadic ? \"...\" : \"\"}>`\n              : option.kind === CommandParameterKinds.number\n                ? ` <${snakeCase(\n                    option.choices && option.choices.length > 0\n                      ? option.choices.join(\"|\")\n                      : option.name\n                  )}${option.variadic ? \"...\" : \"\"}>`\n                : \"\"\n          }\"), align: \"right\", border: \"none\", maxWidth: \"1/3\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n            /\\.+$/,\n            \"\"\n          )} ${\n            option.env || option.default !== undefined\n              ? `(${\n                  option.env\n                    ? `env: ${context.config.envPrefix}_${option.env}${\n                        option.default !== undefined ? \", \" : \"\"\n                      }`\n                    : \"\"\n                }${\n                  option.default !== undefined\n                    ? `default: ${JSON.stringify(option.default).replace(/\"/g, '\\\\\"')}`\n                    : \"\"\n                })`\n              : \"\"\n          }.\"), align: \"left\", border: \"none\" }], `;\n        }}\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface HelpCommandsProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: HelpCommandsProps) {\n  const { commands } = props;\n\n  return (\n    <>\n      {code`table([ `}\n      <hbr />\n      <For each={Object.values(commands)} hardline>\n        {child =>\n          code`[{ value: colors.text.body.primary(\"${\n            child.name\n          }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n            /\\.+$/,\n            \"\"\n          )}\"), align: \"left\", border: \"none\" }], `\n        }\n      </For>\n      <hbr />\n      {code` ]); `}\n    </>\n  );\n}\n\nexport interface BaseHelpProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * Whether to filter out global options from the help display.\n   *\n   * @remarks\n   * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n   *\n   * @defaultValue false\n   */\n  filterGlobalOptions?: boolean;\n\n  /**\n   * The padding scale to apply to the help display headings.\n   *\n   * @remarks\n   * This value is multiplied by the theme's app padding to determine the final padding.\n   *\n   * @defaultValue 1\n   */\n  indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function BaseHelp(props: BaseHelpProps) {\n  const { command, indent = 1, filterGlobalOptions = false } = props;\n\n  const theme = useTheme();\n  const context = usePowerlines<ScriptPresetContext>();\n\n  const options = computed(() =>\n    filterGlobalOptions\n      ? Object.values(command.options).filter(\n          option =>\n            !context.options.some(\n              globalOption =>\n                globalOption.name === option.name ||\n                option.alias.includes(globalOption.name) ||\n                globalOption.alias?.includes(option.name) ||\n                globalOption.alias?.some(alias => option.alias.includes(alias))\n            )\n        )\n      : Object.values(command.options)\n  );\n\n  return (\n    <>\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n      <hbr />\n      <HelpUsage command={command} indent={indent} />\n      <Spacing />\n      <Show when={options.value.length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpOptions options={options.value} />\n        <hbr />\n        <hbr />\n      </Show>\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(\"\");\n      writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${\n        indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n      });`}\n        <hbr />\n        <HelpCommands commands={command.children} />\n        <hbr />\n        <hbr />\n      </Show>\n    </>\n  );\n}\n\nexport interface VirtualHelpProps {\n  /**\n   * The options to display help for.\n   */\n  options: CommandOption[];\n\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  commands: Record<string, CommandTree>;\n\n  /**\n   * The command path to generate help for, used for generating the help invocation instructions.\n   *\n   * @remarks\n   * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n   */\n  segments?: string[];\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n  const { options, segments, commands } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <hbr />\n      {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n      <hbr />\n      <HelpOptions options={options} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <Show when={Object.keys(commands).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(commands)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )}${\n          segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n        } <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n\nexport interface CommandHelpProps {\n  /**\n   * A mapping of command names to their command definitions.\n   */\n  command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelp(props: CommandHelpProps) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <BaseHelp command={command} filterGlobalOptions={false} />\n      {code`writeLine(\"\"); `}\n      <Spacing />\n      <Show when={Object.keys(command.children).length > 0}>\n        {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n        writeLine(\"\"); `}\n        <hbr />\n        <hbr />\n        <For\n          each={Object.values(command.children)}\n          doubleHardline\n          joiner={code`writeLine(\"\"); `}\n          ender={code`writeLine(\"\"); `}>\n          {child => (\n            <>\n              {code`\n                writeLine(colors.text.heading.primary(${\n                  child.icon\n                    ? `(isUnicodeSupported ? \" ${child.icon}  \" : \"\") + `\n                    : \"\"\n                }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n                writeLine(\"\");\n                writeLine(colors.text.body.secondary(\"${child.description}\"));\n                writeLine(\"\");\n                `}\n              <hbr />\n              <BaseHelp command={child} indent={2} filterGlobalOptions />\n              <hbr />\n            </>\n          )}\n        </For>\n        {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n          context\n        )} ${command.segments.join(\n          \" \"\n        )} <specific command> --help') will provide additional information that is specific to that command.\");\n        writeLine(\"\");`}\n      </Show>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/help.d.cts

@@ -1,5 +1,5 @@
-import * as _alloy_js_core4 from "@alloy-js/core";
-import { CommandOption, CommandTree } from "@shell-shock/core/types/command";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { CommandOption, CommandTree } from "@shell-shock/core";
 
 //#region src/components/help.d.ts
 interface HelpUsageProps {
@@ -20,7 +20,7 @@ interface HelpUsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function HelpUsage(props: HelpUsageProps): _alloy_js_core4.Children;
+declare function HelpUsage(props: HelpUsageProps): _alloy_js_core0.Children;
 interface HelpOptionsProps {
   /**
    * The options to display help for.
@@ -30,7 +30,7 @@ interface HelpOptionsProps {
 /**
  * A component that generates the options table display for a command.
  */
-declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core4.Children;
+declare function HelpOptions(props: HelpOptionsProps): _alloy_js_core0.Children;
 interface HelpCommandsProps {
   /**
    * A mapping of command names to their command definitions.
@@ -40,7 +40,7 @@ interface HelpCommandsProps {
 /**
  * A component that generates the commands table display for a command.
  */
-declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core4.Children;
+declare function HelpCommands(props: HelpCommandsProps): _alloy_js_core0.Children;
 interface BaseHelpProps {
   /**
    * The command to generate help for.
@@ -68,7 +68,7 @@ interface BaseHelpProps {
 /**
  * A component that generates the `help` function declaration for a command.
  */
-declare function BaseHelp(props: BaseHelpProps): _alloy_js_core4.Children;
+declare function BaseHelp(props: BaseHelpProps): _alloy_js_core0.Children;
 interface VirtualHelpProps {
   /**
    * The options to display help for.
@@ -89,7 +89,7 @@ interface VirtualHelpProps {
 /**
  * A component that generates the invocation of the `help` function for a command.
  */
-declare function VirtualHelp(props: VirtualHelpProps): _alloy_js_core4.Children;
+declare function VirtualHelp(props: VirtualHelpProps): _alloy_js_core0.Children;
 interface CommandHelpProps {
   /**
    * A mapping of command names to their command definitions.
@@ -99,7 +99,7 @@ interface CommandHelpProps {
 /**
  * A component that generates the invocation of the `help` function for a command.
  */
-declare function CommandHelp(props: CommandHelpProps): _alloy_js_core4.Children;
+declare function CommandHelp(props: CommandHelpProps): _alloy_js_core0.Children;
 //#endregion
 export { BaseHelp, BaseHelpProps, CommandHelp, CommandHelpProps, HelpCommands, HelpCommandsProps, HelpOptions, HelpOptionsProps, HelpUsage, HelpUsageProps, VirtualHelp, VirtualHelpProps };
 //# sourceMappingURL=help.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAqCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EA6FR;AAUjB;AA+DA;AAUA;AAuBA;AA8BA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAoDA;AAUgB,iBA/WA,SAAA,CA+WmB,KAAA,EA/WF,cA+WkB,CAAA,EA/WJ,eAAA,CAAA,QA+WI;UAlRlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAqD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAoDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}
+{"version":3,"file":"help.d.cts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAkCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAiHR;AAUjB;AAyEA;AAUA;AAuBA;AA8BA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAoDA;AAUgB,iBA7YA,SAAA,CA6YmB,KAAA,EA7YF,cA6YkB,CAAA,EA7YJ,eAAA,CAAA,QA6YI;UA5RlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAyElC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAqD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAoDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}

package/dist/components/help.d.mts

@@ -1,5 +1,5 @@
 import * as _alloy_js_core0 from "@alloy-js/core";
-import { CommandOption, CommandTree } from "@shell-shock/core/types/command";
+import { CommandOption, CommandTree } from "@shell-shock/core";
 
 //#region src/components/help.d.ts
 interface HelpUsageProps {

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.mts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAqCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EA6FR;AAUjB;AA+DA;AAUA;AAuBA;AA8BA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAoDA;AAUgB,iBA/WA,SAAA,CA+WmB,KAAA,EA/WF,cA+WkB,CAAA,EA/WJ,eAAA,CAAA,QA+WI;UAlRlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UA+DlC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAqD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAoDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}
+{"version":3,"file":"help.d.mts","names":[],"sources":["../../src/components/help.tsx"],"sourcesContent":[],"mappings":";;;;UAkCiB,cAAA;;;AAAjB;EAoBgB,OAAA,EAhBL,WAgBc;EAiHR;AAUjB;AAyEA;AAUA;AAuBA;AA8BA;AAqDA;;EAS2B,MAAA,CAAA,EAAA,MAAA;;;AAc3B;AAoDA;AAUgB,iBA7YA,SAAA,CA6YmB,KAAA,EA7YF,cA6YkB,CAAA,EA7YJ,eAAA,CAAA,QA6YI;UA5RlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAyElC,iBAAA;;;;YAIL,eAAe;;;;;iBAMX,YAAA,QAAoB,oBAAiB,eAAA,CAAA;UAuBpC,aAAA;;;;WAIN;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,QAAA,QAAgB,gBAAa,eAAA,CAAA;UAqD5B,gBAAA;;;;WAIN;;;;YAKC,eAAe;;;;;;;;;;;;iBAcX,WAAA,QAAmB,mBAAgB,eAAA,CAAA;UAoDlC,gBAAA;;;;WAIN;;;;;iBAMK,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}

package/dist/components/help.mjs

@@ -2,11 +2,10 @@ import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runti
 import { For, Show, code, computed } from "@alloy-js/core";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { getAppBin, getDynamicPathSegmentName, isDynamicPathSegment } from "@shell-shock/core/plugin-utils/context-helpers";
+import { getAppBin, getDynamicPathSegmentName, isDynamicPathSegment, sortOptions } from "@shell-shock/core/plugin-utils";
 import { useTheme } from "@shell-shock/plugin-theme/contexts/theme";
-import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { CommandParameterKinds } from "@shell-shock/core";
 import { kebabCase } from "@stryke/string-format/kebab-case";
-import { sortOptions } from "@shell-shock/core/plugin-utils/reflect";
 import { snakeCase } from "@stryke/string-format/snake-case";
 
 //#region src/components/help.tsx
@@ -24,11 +23,11 @@ function HelpUsage(props) {
 		hardline: true,
 		children: (bin) => [memo(() => code`
       writeLine(
-        colors.text.body.secondary(\`\$ \${colors.text.usage.bin("${bin}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${colors.text.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${colors.text.usage.dynamic("[command]")}` : ""}${command.arguments.length > 0 ? ` ${command.arguments.map((argument) => `\${colors.text.usage.arguments("<${snakeCase(argument.name)}${(argument.kind === ReflectionKind.string || argument.kind === ReflectionKind.number) && argument.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${colors.text.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
+        colors.text.body.secondary(\`\$ \${colors.text.usage.bin("${bin}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${colors.text.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${colors.text.usage.dynamic("[command]")}` : ""}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${colors.text.usage.args("<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join("|") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""} \${colors.text.usage.options("[options]")}\`), { padding: ${theme.padding.app * indent} }
       );`), createIntrinsic("hbr", {})]
 	}), createComponent(Show, {
 		get when() {
-			return command.arguments.length > 0;
+			return command.args.length > 0;
 		},
 		get children() {
 			return [createIntrinsic("hbr", {}), createComponent(For, {
@@ -38,7 +37,7 @@ function HelpUsage(props) {
 				hardline: true,
 				children: (bin) => [memo(() => code`
       writeLine(
-        colors.text.body.secondary(\`\$ \${colors.text.usage.bin("${bin}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${colors.text.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${colors.text.usage.dynamic("[command]")}` : ""} \${colors.text.usage.options("[options]")}${command.arguments.length > 0 ? ` ${command.arguments.map((argument) => `\${colors.text.usage.arguments("<${snakeCase(argument.name)}${(argument.kind === ReflectionKind.string || argument.kind === ReflectionKind.number) && argument.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${theme.padding.app * indent} }
+        colors.text.body.secondary(\`\$ \${colors.text.usage.bin("${bin}")}${command.segments.length > 0 ? ` ${command.segments.map((segment) => `\${colors.text.usage.${isDynamicPathSegment(segment) ? "dynamic" : "command"}("${isDynamicPathSegment(segment) ? `[${snakeCase(getDynamicPathSegmentName(segment))}]` : segment}")}`).join(" ")}` : ""}${Object.values(command.children).length > 0 ? ` \${colors.text.usage.dynamic("[command]")}` : ""} \${colors.text.usage.options("[options]")}${command.args.length > 0 ? ` ${command.args.map((arg) => `\${colors.text.usage.args("<${snakeCase((arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.choices && arg.choices.length > 0 ? arg.choices.join("|") : arg.kind === CommandParameterKinds.string && arg.format ? arg.format : arg.name)}${(arg.kind === CommandParameterKinds.string || arg.kind === CommandParameterKinds.number) && arg.variadic ? "..." : ""}>")}`).join(" ")}` : ""}\`), { padding: ${theme.padding.app * indent} }
       );`), createIntrinsic("hbr", {})]
 			})];
 		}
@@ -67,7 +66,7 @@ function HelpOptions(props) {
 					if (alias.length === 1) flags.push(`-${alias}`);
 					else names.push(`--${kebabCase(alias)}`);
 				});
-				return code`[{ value: colors.text.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === ReflectionKind.string ? ` <${snakeCase(option.name)}${option.variadic ? "..." : ""}>` : option.kind === ReflectionKind.number ? ` <${snakeCase(option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: colors.text.body.tertiary("${option.description.replace(/\.+$/, "")} ${option.env || option.default !== void 0 ? `(${option.env ? `env: ${context.config.envPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/"/g, "\\\"")}` : ""})` : ""}."), align: "left", border: "none" }], `;
+				return code`[{ value: colors.text.body.primary("${flags.length > 0 ? `${flags.sort().join(", ")}${names.length > 0 ? ", " : ""}` : ""}${names.length > 0 ? names.sort().join(", ") : ""}${option.kind === CommandParameterKinds.string ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.format ? option.format : option.name)}${option.variadic ? "..." : ""}>` : option.kind === CommandParameterKinds.number ? ` <${snakeCase(option.choices && option.choices.length > 0 ? option.choices.join("|") : option.name)}${option.variadic ? "..." : ""}>` : ""}"), align: "right", border: "none", maxWidth: "1/3" }, { value: colors.text.body.tertiary("${option.description.replace(/\.+$/, "")} ${option.env || option.default !== void 0 ? `(${option.env ? `env: ${context.config.envPrefix}_${option.env}${option.default !== void 0 ? ", " : ""}` : ""}${option.default !== void 0 ? `default: ${JSON.stringify(option.default).replace(/"/g, "\\\"")}` : ""})` : ""}."), align: "left", border: "none" }], `;
 			}
 		}),
 		createIntrinsic("hbr", {}),