@shell-shock/preset-script 0.6.62 → 0.6.65

package/dist/components/bin-entry.cjs

@@ -110,7 +110,8 @@ function BinEntry(props) {
 			},
 			typeDefinition: {
 				file: bin,
-				output: "bin"
+				output: "bin",
+				input: { file: bin }
 			},
 			get imports() {
 				return (0, defu.default)(imports ?? {}, Object.entries(context.commands).filter(([, command]) => command.isVirtual).reduce((ret, [name, command]) => {
@@ -210,5 +211,4 @@ function BinEntry(props) {
 
 //#endregion
 exports.BinEntry = BinEntry;
-exports.RunApplication = RunApplication;
-//# sourceMappingURL=bin-entry.cjs.map
+exports.RunApplication = RunApplication;

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.d.cts","names":[],"sources":["../../src/components/bin-entry.tsx"],"mappings":";;;;;;AA2CA;iBAAgB,cAAA,CAAA,GAAc,QAAA;AAAA,UA4Eb,aAAA,SAAsB,IAAA,CACrC,cAAA;EAGA,MAAA,GAAS,QAAA;EACT,OAAA,GAAU,QAAA;EACV,QAAA,EAAU,QAAA;AAAA;;;;iBAMI,QAAA,CAAS,KAAA,EAAO,aAAA,GAAa,QAAA"}
+{"version":3,"file":"bin-entry.d.cts","names":[],"sources":["../../src/components/bin-entry.tsx"],"mappings":";;;;;;AA4CA;iBAAgB,cAAA,CAAA,GAAc,QAAA;AAAA,UA4Eb,aAAA,SAAsB,IAAA,CACrC,cAAA;EAGA,MAAA,GAAS,QAAA;EACT,OAAA,GAAU,QAAA;EACV,QAAA,EAAU,QAAA;AAAA;;;;iBAMI,QAAA,CAAS,KAAA,EAAO,aAAA,GAAa,QAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.d.mts","names":[],"sources":["../../src/components/bin-entry.tsx"],"mappings":";;;;;;AA2CA;iBAAgB,cAAA,CAAA,GAAc,QAAA;AAAA,UA4Eb,aAAA,SAAsB,IAAA,CACrC,cAAA;EAGA,MAAA,GAAS,QAAA;EACT,OAAA,GAAU,QAAA;EACV,QAAA,EAAU,QAAA;AAAA;;;;iBAMI,QAAA,CAAS,KAAA,EAAO,aAAA,GAAa,QAAA"}
+{"version":3,"file":"bin-entry.d.mts","names":[],"sources":["../../src/components/bin-entry.tsx"],"mappings":";;;;;;AA4CA;iBAAgB,cAAA,CAAA,GAAc,QAAA;AAAA,UA4Eb,aAAA,SAAsB,IAAA,CACrC,cAAA;EAGA,MAAA,GAAS,QAAA;EACT,OAAA,GAAU,QAAA;EACV,QAAA,EAAU,QAAA;AAAA;;;;iBAMI,QAAA,CAAS,KAAA,EAAO,aAAA,GAAa,QAAA"}

package/dist/components/bin-entry.mjs

@@ -107,7 +107,8 @@ function BinEntry(props) {
 			},
 			typeDefinition: {
 				file: bin,
-				output: "bin"
+				output: "bin",
+				input: { file: bin }
 			},
 			get imports() {
 				return defu(imports ?? {}, Object.entries(context.commands).filter(([, command]) => command.isVirtual).reduce((ret, [name, command]) => {

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.mjs","names":[],"sources":["../../src/components/bin-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { FunctionDeclaration, IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocRemarks,\n  TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { ExitFunctionDeclaration } from \"./exit-function-declaration\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <Spacing />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        const startDate = new Date();\n        try {\n          process.on(\"exit\", () => exit({\n            startDate,\n            skipProcessExit: true,\n            isSynchronous: true,\n            signal: 0\n          }));\n          process.on(\"beforeExit\", () => exit({\n            startDate,\n            signal: 0\n          }));\n          process.on(\"message\", message => {\n            if (message === 'shutdown') {\n              exit({\n                startDate,\n                isSynchronous: true,\n                signal: -128\n              });\n            }\n          });\n\n          process.once(\"SIGTERM\", () => exit({\n            startDate,\n            signal: 15\n          }));\n          process.once(\"SIGINT\", () => exit({\n            startDate,\n            signal: 2\n          }));\n          process.once(\"SIGUSR2\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n          process.once(\"SIGQUIT\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n\n          for (const type of [\"unhandledRejection\", \"uncaughtException\"]) {\n            process.on(type, err => exit({\n              startDate,\n              exception: err || new Error(\\`An \\${type === \"unhandledRejection\" ? \"unhandled promise rejection\" : \"uncaught exception\"} occurred during processing - the application is shutting down.\\`)\n            }));\n          }\n\n          await withGlobal(async () => {\n            const result = await main();\n            if (result?.error) {\n              error(result.error);\n            }\n          });\n\n          exit({ startDate });\n        } catch (err) {\n          exit({ startDate, exception: err as Error });\n        }\n      })();\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface BinEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"hashbang\"\n> {\n  prefix?: Children;\n  postfix?: Children;\n  children: Children;\n}\n\n/**\n * The binary entry point for the Shell Shock project.\n */\nexport function BinEntry(props: BinEntryProps) {\n  const { prefix, postfix, builtinImports, imports, children, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const bins = computed(() => getUnique(Object.values(context.config.bin)));\n\n  return (\n    <For each={bins.value}>\n      {bin => (\n        <EntryFile\n          {...rest}\n          path={findFileName(replaceExtension(bin))}\n          typeDefinition={{\n            file: bin,\n            output: \"bin\"\n          }}\n          imports={defu(\n            imports ?? {},\n            Object.entries(context.commands)\n              .filter(([, command]) => command.isVirtual)\n              .reduce((ret, [name, command]) => {\n                ret[`./${command.name}`] = [\n                  { name: \"handler\", alias: `handle${pascalCase(name)}` }\n                ];\n\n                return ret;\n              }, {} as TypescriptFileImports)\n          )}\n          builtinImports={defu(builtinImports ?? {}, {\n            env: [\"env\", \"isDevelopment\", \"isDebug\"],\n            console: [\n              \"verbose\",\n              \"table\",\n              \"writeLine\",\n              \"borderColors\",\n              \"textColors\",\n              \"stripAnsi\",\n              \"error\",\n              \"warn\"\n            ],\n            utils: [\"isUnicodeSupported\", \"findSuggestions\"],\n            state: [\"withGlobal\", \"useGlobal\", \"hasFlag\"],\n            help: [\"showHelp\"],\n            banner: [\"showBanner\"]\n          })}>\n          <ExitFunctionDeclaration />\n          <Spacing />\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <Spacing />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application.`}>\n            <TSDocRemarks>\n              {`This file serves as the main entry point for the binary executable of the ${getAppTitle(\n                context,\n                true\n              )} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`}\n            </TSDocRemarks>\n            <TSDocReturns>\n              {`Returns a promise that resolves to either a successful result or an error object.`}\n            </TSDocReturns>\n          </TSDoc>\n          <FunctionDeclaration\n            async\n            returnType=\"any | { error: string | Error }\"\n            name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${\n                context?.packageJson.version\n                  ? `\"${context?.packageJson.version}\"`\n                  : \"0.0.1\"\n              });\n              return; `}\n            </IfStatement>\n            <Spacing />\n            {children}\n            <hbr />\n          </FunctionDeclaration>\n          <hbr />\n          <hbr />\n          <hbr />\n          <Show when={Boolean(postfix)} fallback={<RunApplication />}>\n            {postfix}\n          </Show>\n          <hbr />\n        </EntryFile>\n      )}\n    </For>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwCA,SAAE,iBAAA;AACA,QAAM;EAAA,gBAAoB,SAAO,EAAI,CAAC;EAAA,IAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8E9C,MAAO,EACL,QACC,SACD,gBACA,SACA,UACA,GAAA,SACF;;CAEE,MAAA,OAAA,eAAA,UAAA,OAAA,OAAA,QAAA,OAAA,IAAA,CAAA,CAAA;AACA,QAAK,gBAAmB,KAAI;EAC5B,IAAA,OAAA;AACI,UAAC,KAAS;;;GAGd,IAAM,OAAS;AACT,WAAO,aAAa,iBAAY,IAAO,CAAA;;GAE7C,gBAAO;IACD,MAAM;IACP,QAAO;IACP;GACD,IAAI,UAAQ;AACV,WAAO,KAAC,WAAa,EAAA,EAAA,OAAA,QAAqB,QAAC,SAAA,CAAA,QAAA,GAAA,aAAA,QAAA,UAAA,CAAA,QAAA,KAAA,CAAA,MAAA,aAAA;AACzC,SAAA,KAAA,QAAgB,UAAA,CAAA;MACd,MAAM;MACN,OAAO,SAAK,WAAA,KAAA;MACb,CAAA;AACD,YAAO;OACN,EAAC,CAAa,CAAA;;GAEnB,IAAI,iBAAgB;AAClB,WAAO,KAAA,kBAAoB,EAAA,EAAO;KAChC,KAAK;MAAC;MAAO;MAAiB;MAAG;KACjC,SAAS;MAAC;MAAO;MAAU;MAAgB;MAAgB;MAAG;MAAA;MAAA;MAAA;KAC9D,OAAO,CAAA,sBAAA,kBAAA;;;;;;KAEP,MAAM,CAAA,WAAU;KAChB,QAAQ,CAAC,aAAI;KACd,CAAC;;GAEJ,IAAI,WAAS;AACX,WAAI;KAAA,gBAAS,yBAAA,EAAA,CAAA;KAAA,gBAAA,SAAA,EAAA,CAAA;KAAA,gBAAA,MAAA;MACX,IAAI,OAAC;AACH,cAAG,QAAM,OAAA;;MAEX,IAAI,WAAC;AACH,cAAG,CAAA,QAAW,gBAAA,SAAA,EAAA,CAAA,CAAA;;MAEjB,CAAC;KAAE,gBAAS,OAAA;MACX,IAAI,UAAK;AACP,cAAC,8BAAA,YAAA,SAAA,KAAA,CAAA;;MAEH,IAAE,WAAS;AACT,cAAO,CAAC,gBAAU,cAAA,EAClB,IAAM,WAAI;AACT,eAAA,6EAAA,YAAA,SAAA,KAAA,CAAA;UAEF,CAAA,EAAA,gBAAS,cAAA,EACT,UAAW,qFACT,CAAA,CAAA;;MAEJ,CAAC;KAAE,gBAAI,qBAAA;MACN,OAAC;MACD,YAAY;MACZ,MAAI;MACJ,IAAI,WAAA;AACF,cAAG;QAAA,gBAAuB,aAAa;SACtC,WAAY,IAAA;SACX,IAAE,WAAU;AACV,iBAAO,IAAA,eAAA,SAAA,YAAA,UAAA,IAAA,SAAA,YAAA,QAAA,KAAA,QAAA;;;SAGV,CAAC;QAAA,gBAAY,SAAA,EAAA,CAAA;QAAA;QAAA,gBAAA,OAAA,EAAA,CAAA;QAAA;;MAEjB,CAAC;KAAE,gBAAc,OAAQ,EAAK,CAAA;KAAA,gBAAqB,OAAA,EAAA,CAAU;KAAC,gBAAmB,OAAO,EAAC,CAAA;KAAA,gBAAA,MAAA;MACxF,IAAI,OAAA;AACF,cAAK,QAAA,QAAA;;MAEP,IAAE,WAAA;AACA,cAAA,gBAAyB,gBAAgB,EAAE,CAAA;;MAE7C,UAAG;MACJ,CAAC;KAAE,gBAAgB,OAAK,EAAA,CAAA;KAAA;;GAE5B,CAAC,CAAC;EACJ,CAAC"}
+{"version":3,"file":"bin-entry.mjs","names":[],"sources":["../../src/components/bin-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { FunctionDeclaration, IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocRemarks,\n  TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { ExitFunctionDeclaration } from \"./exit-function-declaration\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <Spacing />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        const startDate = new Date();\n        try {\n          process.on(\"exit\", () => exit({\n            startDate,\n            skipProcessExit: true,\n            isSynchronous: true,\n            signal: 0\n          }));\n          process.on(\"beforeExit\", () => exit({\n            startDate,\n            signal: 0\n          }));\n          process.on(\"message\", message => {\n            if (message === 'shutdown') {\n              exit({\n                startDate,\n                isSynchronous: true,\n                signal: -128\n              });\n            }\n          });\n\n          process.once(\"SIGTERM\", () => exit({\n            startDate,\n            signal: 15\n          }));\n          process.once(\"SIGINT\", () => exit({\n            startDate,\n            signal: 2\n          }));\n          process.once(\"SIGUSR2\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n          process.once(\"SIGQUIT\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n\n          for (const type of [\"unhandledRejection\", \"uncaughtException\"]) {\n            process.on(type, err => exit({\n              startDate,\n              exception: err || new Error(\\`An \\${type === \"unhandledRejection\" ? \"unhandled promise rejection\" : \"uncaught exception\"} occurred during processing - the application is shutting down.\\`)\n            }));\n          }\n\n          await withGlobal(async () => {\n            const result = await main();\n            if (result?.error) {\n              error(result.error);\n            }\n          });\n\n          exit({ startDate });\n        } catch (err) {\n          exit({ startDate, exception: err as Error });\n        }\n      })();\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface BinEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"hashbang\"\n> {\n  prefix?: Children;\n  postfix?: Children;\n  children: Children;\n}\n\n/**\n * The binary entry point for the Shell Shock project.\n */\nexport function BinEntry(props: BinEntryProps) {\n  const { prefix, postfix, builtinImports, imports, children, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const bins = computed<string[]>(() =>\n    getUnique(Object.values(context.config.bin))\n  );\n\n  return (\n    <For each={bins.value}>\n      {bin => (\n        <EntryFile\n          {...rest}\n          path={findFileName(replaceExtension(bin))}\n          typeDefinition={{\n            file: bin,\n            output: \"bin\",\n            input: {\n              file: bin\n            }\n          }}\n          imports={defu(\n            imports ?? {},\n            Object.entries(context.commands as Record<string, CommandTree>)\n              .filter(([, command]) => command.isVirtual)\n              .reduce((ret, [name, command]) => {\n                ret[`./${command.name}`] = [\n                  { name: \"handler\", alias: `handle${pascalCase(name)}` }\n                ];\n\n                return ret;\n              }, {} as TypescriptFileImports)\n          )}\n          builtinImports={defu(builtinImports ?? {}, {\n            env: [\"env\", \"isDevelopment\", \"isDebug\"],\n            console: [\n              \"verbose\",\n              \"table\",\n              \"writeLine\",\n              \"borderColors\",\n              \"textColors\",\n              \"stripAnsi\",\n              \"error\",\n              \"warn\"\n            ],\n            utils: [\"isUnicodeSupported\", \"findSuggestions\"],\n            state: [\"withGlobal\", \"useGlobal\", \"hasFlag\"],\n            help: [\"showHelp\"],\n            banner: [\"showBanner\"]\n          })}>\n          <ExitFunctionDeclaration />\n          <Spacing />\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <Spacing />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application.`}>\n            <TSDocRemarks>\n              {`This file serves as the main entry point for the binary executable of the ${getAppTitle(\n                context,\n                true\n              )} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`}\n            </TSDocRemarks>\n            <TSDocReturns>\n              {`Returns a promise that resolves to either a successful result or an error object.`}\n            </TSDocReturns>\n          </TSDoc>\n          <FunctionDeclaration\n            async\n            returnType=\"any | { error: string | Error }\"\n            name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${\n                context?.packageJson.version\n                  ? `\"${context?.packageJson.version}\"`\n                  : \"0.0.1\"\n              });\n              return; `}\n            </IfStatement>\n            <Spacing />\n            {children}\n            <hbr />\n          </FunctionDeclaration>\n          <hbr />\n          <hbr />\n          <hbr />\n          <Show when={Boolean(postfix)} fallback={<RunApplication />}>\n            {postfix}\n          </Show>\n          <hbr />\n        </EntryFile>\n      )}\n    </For>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoCA,SAAS,iBAAoB;AAC7B,QAAO;EAAA,gBAAgB,SAAA,EAAA,CAAA;EAAA,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkEd,gBAAkB,OAAM,EAAA,CAAI;EAAC;;;;;;CAMpC,MAAM,EACJ,QACA,SACA,gBACA,SACA,UACA,GAAG,SACD;CACJ,MAAC,UAAA,eAAA;CACH,MAAA,OAAA,eAAA,UAAA,OAAA,OAAA,QAAA,OAAA,IAAA,CAAA,CAAA;;EAEA,IAAO,OAAA;AACL,UAAA,KAAc;;EAEd,WAAA,QAAA,gBAAA,WAAA,WAAA,MAAA;GACA,IAAQ,OAAC;AACT,WAAU,aAAQ,iBAAA,IAAA,CAAA;;GAEpB,gBAAA;;IAEE,QAAA;IACK,OAAO,EACZ,MAAA,KACK;IACA;;AAEC,WAAO,KAAG,WAAa,EAAC,EAAA,OAAA,QAAA,QAAsB,SAAA,CAAA,QAAA,GAAA,aAAA,QAAA,UAAA,CAAA,QAAA,KAAA,CAAA,MAAA,aAAA;AAC9C,SAAM,KAAC,QAAS,UAAa,CAAC;MAClC,MAAU;MACX,OAAA,SAAA,WAAA,KAAA;;AAEM,YAAA;OACA,EAAI,CAAC,CAAC;;GAET,IAAG,iBAAA;AACD,WAAM,KAAI,kBAAA,EAAA,EAAA;KACR,KAAK;MAAC;MAAA;MAAa;MAAqB;KACxC,SAAA;MAAA;MAAgB;MAAA;MAAA;MAAA;MAAA;MAAA;MAAA;MAAA;KAChB,OAAO,CAAC,sBAAG,kBAAA;KACX,OAAE;MAAM;MAAO;MAAA;MAAA;KACf,MAAE,CAAK,WAAE;KACT,QAAQ,CAAC,aAAC;KACX,CAAC;;GAEJ,IAAI,WAAS;AACX,WAAI;KAAA,gBAAa,yBAAA,EAAA,CAAA;KAAA,gBAAA,SAAA,EAAA,CAAA;KAAA,gBAAA,MAAA;MACf,IAAE,OAAO;AACP,cAAG,QAAW,OAAQ;;MAExB,IAAI,WAAW;AACb,cAAO,CAAC,QAAO,gBAAkB,SAAQ,EAAA,CAAA,CAAA;;;;MAG3C,IAAI,UAAS;AACX,cAAO,8BAAyB,YAAA,SAAA,KAAA,CAAA;;MAElC,IAAA,WAAe;AACb,cAAO,CAAA,gBAAO,cAA0B,EACxC,IAAA,WAAS;AACN,eAAQ,6EAAA,YAAA,SAAA,KAAA,CAAA;UAEV,CAAC,EAAC,gBAAU,cAAA,EACX,UAAC,qFACF,CAAC,CAAC;;MAEN,CAAC;KAAE,gBAAS,qBAAA;MACX,OAAK;MACL,YAAG;MACH,MAAE;MACF,IAAE,WAAS;AACT,cAAO;QAAC,gBAAU,aAAA;SAClB,WAAU,IAAA;SACT,IAAA,WAAA;AACF,iBAAA,IAAA,eAAyB,SAAA,YAAA,UAAA,IAAA,SAAA,YAAA,QAAA,KAAA,QAAA;;;SAGvB,CAAA;QAAA,gBAAM,SAAA,EAAA,CAAA;QAAA;QAAA,gBAAA,OAAA,EAAA,CAAA;QAAA;;MAEV,CAAC;KAAE,gBAAI,OAAA,EAAA,CAAA;KAAA,gBAAA,OAAA,EAAA,CAAA;KAAA,gBAAA,OAAA,EAAA,CAAA;KAAA,gBAAA,MAAA;MACN,IAAC,OAAA;AACC,cAAO,QAAG,QAAa;;MAEzB,IAAI,WAAA;AACF,cAAG,gBAAsB,gBAAe,EAAA,CAAA;;MAE1C,UAAU;MACX,CAAC;KAAE,gBAAW,OAAA,EAAA,CAAA;KAAA;;GAElB,CAAC,CAAC;EACJ,CAAC"}

package/dist/components/command-entry.cjs

@@ -148,8 +148,11 @@ function CommandEntry(props) {
 				],
 				utils: ["isMinimal", "isUnicodeSupported"],
 				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
 					"useGlobal",
-					"GlobalOptions",
 					"useGlobalOptions",
 					"useArgs",
 					"hasFlag",
@@ -200,5 +203,4 @@ function CommandEntry(props) {
 //#endregion
 exports.CommandEntry = CommandEntry;
 exports.CommandHandlerDeclaration = CommandHandlerDeclaration;
-exports.CommandInvocation = CommandInvocation;
-//# sourceMappingURL=command-entry.cjs.map
+exports.CommandInvocation = CommandInvocation;

package/dist/components/command-entry.mjs

@@ -145,8 +145,11 @@ function CommandEntry(props) {
 				],
 				utils: ["isMinimal", "isUnicodeSupported"],
 				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
 					"useGlobal",
-					"GlobalOptions",
 					"useGlobalOptions",
 					"useArgs",
 					"hasFlag",

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

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

package/dist/components/command-router.cjs

@@ -157,5 +157,4 @@ function CommandRouterBody(props) {
 //#endregion
 exports.CommandRouter = CommandRouter;
 exports.CommandRouterBody = CommandRouterBody;
-exports.CommandRouterRoute = CommandRouterRoute;
-//# sourceMappingURL=command-router.cjs.map
+exports.CommandRouterRoute = CommandRouterRoute;

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

@@ -1 +1 @@
-{"version":3,"file":"command-router.mjs","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\n  IfStatement,\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 { DynamicImportStatement } from \"@powerlines/plugin-alloy/typescript/components/dynamic-import-statement\";\nimport { CommandContext, useCommand } from \"@shell-shock/core/contexts/command\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport function CommandRouterRoute() {\n  const command = useCommand();\n\n  return (\n    <>\n      <Show when={!command.isVirtual}>\n        <DynamicImportStatement\n          name={`handle${pascalCase(command.name)}`}\n          importPath={`./${\n            command.segments.filter(segment => !isDynamicPathSegment(segment))[\n              command.segments.filter(segment => !isDynamicPathSegment(segment))\n                .length - 1\n            ]\n          }`}\n          exportName=\"handler\"\n        />\n      </Show>\n      <hbr />\n      {code`return handle${pascalCase(command.name)}(args);`}\n    </>\n  );\n}\n\nexport interface CommandRouterProps {\n  segments: string[];\n  commands?: Record<string, CommandTree>;\n  route?: Children;\n}\n\n/**\n * The command router component.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands, route } = props;\n\n  const index = computed(() => 2 + (segments.length ?? 0));\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <VarDeclaration\n        let\n        name=\"command\"\n        type=\"string\"\n        initializer={code`\"\";`}\n      />\n      <Spacing />\n      <Show when={commands && Object.keys(commands).length > 0}>\n        <IfStatement\n          condition={code`args.length > ${\n            index.value\n          } && args[${index.value}]`}>{code`command = args[${\n          index.value\n        }];`}</IfStatement>\n        <Spacing />\n      </Show>\n      <CommandRouterBody\n        segments={segments}\n        commands={commands}\n        route={route}\n      />\n    </Show>\n  );\n}\n\n/**\n * The internal command router body logic component.\n */\nexport function CommandRouterBody(props: CommandRouterProps) {\n  const { commands, route } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <IfStatement condition={code`!command.startsWith(\"-\")`}>\n        <For each={Object.values(commands ?? {})}>\n          {(subcommand, idx) => (\n            <CommandContext.Provider value={subcommand}>\n              <Show\n                when={Boolean(idx)}\n                fallback={\n                  <IfStatement\n                    condition={code`${\n                      context.config.isCaseSensitive\n                        ? \"command\"\n                        : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                    } === \"${\n                      context.config.isCaseSensitive\n                        ? subcommand.name\n                        : subcommand.name\n                            .toLowerCase()\n                            .replaceAll(\"-\", \"\")\n                            .replaceAll(\"_\", \"\")\n                    }\"${\n                      subcommand.alias && subcommand.alias.length > 0\n                        ? ` || ${subcommand.alias\n                            .map(\n                              alias =>\n                                `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                  context.config.isCaseSensitive\n                                    ? alias\n                                    : alias\n                                        .toLowerCase()\n                                        .replaceAll(\"-\", \"\")\n                                        .replaceAll(\"_\", \"\")\n                                }\"`\n                            )\n                            .join(\" || \")}`\n                        : \"\"\n                    }`}>\n                    <Show\n                      when={Boolean(route)}\n                      fallback={<CommandRouterRoute />}>\n                      {route}\n                    </Show>\n                  </IfStatement>\n                }>\n                <ElseIfClause\n                  condition={code`${\n                    context.config.isCaseSensitive\n                      ? \"command\"\n                      : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                  } === \"${\n                    context.config.isCaseSensitive\n                      ? subcommand.name\n                      : subcommand.name\n                          .toLowerCase()\n                          .replaceAll(\"-\", \"\")\n                          .replaceAll(\"_\", \"\")\n                  }\"${\n                    subcommand.alias && subcommand.alias.length > 0\n                      ? ` || ${subcommand.alias\n                          .map(\n                            alias =>\n                              `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                context.config.isCaseSensitive\n                                  ? alias\n                                  : alias\n                                      .toLowerCase()\n                                      .replaceAll(\"-\", \"\")\n                                      .replaceAll(\"_\", \"\")\n                              }\"`\n                          )\n                          .join(\" || \")}`\n                      : \"\"\n                  }`}>\n                  <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                    {route}\n                  </Show>\n                </ElseIfClause>\n              </Show>\n            </CommandContext.Provider>\n          )}\n        </For>\n        <ElseIfClause\n          condition={code`Boolean(command) && !command.startsWith(\"-\")`}>{code`const suggestions = findSuggestions(command, [${Object.values(\n          commands ?? {}\n        )\n          .map(\n            cmd =>\n              `\"${cmd.name}\"${(cmd.alias ?? []).map(alias => `, \"${alias}\"`).join(\"\")}`\n          )\n          .join(\", \")}]).slice(0, 3);\n        error(\\`Unknown command: \"\\${command}\"\\${suggestions && suggestions.length > 0 ? \\`, did you mean: \\${suggestions.length === 1 ? \\`\"\\${suggestions[0]}\"\\` : suggestions.map((suggestion, i) => i < suggestions.length - 1 ? \\`\"\\${suggestion}\", \\` : \\`or \"\\${suggestion}\"\\`)}?\\` : \"\"} \\`);`}</ElseIfClause>\n      </IfStatement>\n    </Show>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-router.mjs","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\n  IfStatement,\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 { DynamicImportStatement } from \"@powerlines/plugin-alloy/typescript/components/dynamic-import-statement\";\nimport { CommandContext, useCommand } from \"@shell-shock/core/contexts/command\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport function CommandRouterRoute() {\n  const command = useCommand();\n\n  return (\n    <>\n      <Show when={!command.isVirtual}>\n        <DynamicImportStatement\n          name={`handle${pascalCase(command.name)}`}\n          importPath={`./${\n            command.segments.filter(segment => !isDynamicPathSegment(segment))[\n              command.segments.filter(segment => !isDynamicPathSegment(segment))\n                .length - 1\n            ]\n          }`}\n          exportName=\"handler\"\n        />\n      </Show>\n      <hbr />\n      {code`return handle${pascalCase(command.name)}(args);`}\n    </>\n  );\n}\n\nexport interface CommandRouterProps {\n  segments: string[];\n  commands?: Record<string, CommandTree>;\n  route?: Children;\n}\n\n/**\n * The command router component.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands, route } = props;\n\n  const index = computed(() => 2 + (segments.length ?? 0));\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <VarDeclaration\n        let\n        name=\"command\"\n        type=\"string\"\n        initializer={code`\"\";`}\n      />\n      <Spacing />\n      <Show when={commands && Object.keys(commands).length > 0}>\n        <IfStatement\n          condition={code`args.length > ${\n            index.value\n          } && args[${index.value}]`}>{code`command = args[${\n          index.value\n        }];`}</IfStatement>\n        <Spacing />\n      </Show>\n      <CommandRouterBody\n        segments={segments}\n        commands={commands}\n        route={route}\n      />\n    </Show>\n  );\n}\n\n/**\n * The internal command router body logic component.\n */\nexport function CommandRouterBody(props: CommandRouterProps) {\n  const { commands, route } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <IfStatement condition={code`!command.startsWith(\"-\")`}>\n        <For each={Object.values(commands ?? {})}>\n          {(subcommand, idx) => (\n            <CommandContext.Provider value={subcommand}>\n              <Show\n                when={Boolean(idx)}\n                fallback={\n                  <IfStatement\n                    condition={code`${\n                      context.config.isCaseSensitive\n                        ? \"command\"\n                        : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                    } === \"${\n                      context.config.isCaseSensitive\n                        ? subcommand.name\n                        : subcommand.name\n                            .toLowerCase()\n                            .replaceAll(\"-\", \"\")\n                            .replaceAll(\"_\", \"\")\n                    }\"${\n                      subcommand.alias && subcommand.alias.length > 0\n                        ? ` || ${subcommand.alias\n                            .map(\n                              alias =>\n                                `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                  context.config.isCaseSensitive\n                                    ? alias\n                                    : alias\n                                        .toLowerCase()\n                                        .replaceAll(\"-\", \"\")\n                                        .replaceAll(\"_\", \"\")\n                                }\"`\n                            )\n                            .join(\" || \")}`\n                        : \"\"\n                    }`}>\n                    <Show\n                      when={Boolean(route)}\n                      fallback={<CommandRouterRoute />}>\n                      {route}\n                    </Show>\n                  </IfStatement>\n                }>\n                <ElseIfClause\n                  condition={code`${\n                    context.config.isCaseSensitive\n                      ? \"command\"\n                      : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                  } === \"${\n                    context.config.isCaseSensitive\n                      ? subcommand.name\n                      : subcommand.name\n                          .toLowerCase()\n                          .replaceAll(\"-\", \"\")\n                          .replaceAll(\"_\", \"\")\n                  }\"${\n                    subcommand.alias && subcommand.alias.length > 0\n                      ? ` || ${subcommand.alias\n                          .map(\n                            alias =>\n                              `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                context.config.isCaseSensitive\n                                  ? alias\n                                  : alias\n                                      .toLowerCase()\n                                      .replaceAll(\"-\", \"\")\n                                      .replaceAll(\"_\", \"\")\n                              }\"`\n                          )\n                          .join(\" || \")}`\n                      : \"\"\n                  }`}>\n                  <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                    {route}\n                  </Show>\n                </ElseIfClause>\n              </Show>\n            </CommandContext.Provider>\n          )}\n        </For>\n        <ElseIfClause\n          condition={code`Boolean(command) && !command.startsWith(\"-\")`}>{code`const suggestions = findSuggestions(command, [${Object.values(\n          commands ?? {}\n        )\n          .map(\n            cmd =>\n              `\"${cmd.name}\"${(cmd.alias ?? []).map(alias => `, \"${alias}\"`).join(\"\")}`\n          )\n          .join(\", \")}]).slice(0, 3);\n        error(\\`Unknown command: \"\\${command}\"\\${suggestions && suggestions.length > 0 ? \\`, did you mean: \\${suggestions.length === 1 ? \\`\"\\${suggestions[0]}\"\\` : suggestions.map((suggestion, i) => i < suggestions.length - 1 ? \\`\"\\${suggestion}\", \\` : \\`or \"\\${suggestion}\"\\`)}?\\` : \"\"} \\`);`}</ElseIfClause>\n      </IfStatement>\n    </Show>\n  );\n}\n"],"mappings":";;;;;;;;;;;AA2BA,SAAS,qBAAyB;CAClC,MAAQ,UAAC,YAAgB;AACzB,QAAS;EAAA,gBAAA,MAAuB;GAChC,IAAO,OAAO;AACR,WAAG,CAAA,QAAa;;;AAGhB,WAAC,gBAAS,wBAAqB;KAC7B,IAAA,OAAU;;;KAGb,IAAA,aAAA;AACE,aAAU,KAAE,QAAQ,SAAU,QAAA,YAAA,CAAA,qBAAA,QAAA,CAAA,CAAA,QAAA,SAAA,QAAA,YAAA,CAAA,qBAAA,QAAA,CAAA,CAAA,SAAA;;KAE7B,YAAS;KACV,CAAC;;GAEL,CAAC;EAAE,gBAAgB,OAAS,EAAA,CAAA;EAAA,WAAkB,IAAC,gBAAA,WAA6B,QAAA,KAAA,CAAA,SAAA;EAAA;;;;;AAK/E,SAAS,cAAA,OAAA;CACP,MAAM,EACJ,UACA,UACA,UACD;CACH,MAAA,QAAA,eAAA,KAAA,SAAA,UAAA,GAAA;;EAEA,IAAO,OAAA;AACL,UAAU,YAAQ,OAAA,KAAA,SAAA,CAAA,SAAA;;EAElB,IAAM,WAAU;AAClB,UAAA;IAAA,gBAAA,gBAAA;;KAEE,MAAA;KACK,MAAO;KACZ,aAAA,IAAA;KACK,CAAA;IAAA,gBAAS,SAAqB,EAAA,CAAA;IAAA,gBAAoB,MAAA;KACjD,IAAE,OAAS;;;;AAIV,aAAA,CAAA,gBAAA,aAAA;OACC,IAAM,YAAY;AACrB,eAAA,IAAA,iBAAA,MAAA,MAAA,WAAA,MAAA,MAAA;;OAEK,IAAE,WAAO;AACP,eAAM,IAAA,kBAAA,MAAA,MAAA;;OAEb,CAAA,EAAA,gBAAA,SAAA,EAAA,CAAA,CAAA;;KAEA,CAAA;IAAA,gBAAqB,mBAAc;KACjC;KACC;KACE;KACL,CAAC;IAAC;;EAEN,CAAC;;;;;AAMJ,SAAe,kBAAK,OAAA;CAClB,MAAK,EACH,UACD,UACH;;AAEE,QAAA,gBAAA,MAAA;EACC,IAAI,OAAQ;AACb,UAAA,YAAA,OAAA,KAAA,SAAA,CAAA,SAAA;;EAEA,IAAM,WAAW;;IAEX,WAAU,IAAA;;AAET,YAAA,CAAA,gBAAA,KAAA;MACC,IAAM,OAAA;AACT,cAAY,OAAS,OAAO,YAAS,EAAA,CAAA;;MAEhC,WAAW,YAAS,QAAA,gBAAA,eAAA,UAAA;OACnB,OAAA;OACC,IAAC,WAAA;AACC,eAAM,gBAAY,MAAA;SAClB,IAAA,OAAS;AACN,iBAAA,QAAA,IAAA;;SAED,IAAI,WAAQ;AACV,iBAAO,gBAAO,aAAA;WACZ,IAAI,YAAS;AACX,mBAAI,IAAA,GAAA,QAAA,OAAA,kBAAA,YAAA,wEAAA,QAAA,QAAA,OAAA,kBAAA,WAAA,OAAA,WAAA,KAAA,aAAA,CAAA,WAAA,KAAA,GAAA,CAAA,WAAA,KAAA,GAAA,CAAA,GAAA,WAAA,SAAA,WAAA,MAAA,SAAA,IAAA,OAAA,WAAA,MAAA,KAAA,UAAA,GAAA,QAAA,OAAA,kBAAA,YAAA,wEAAA,QAAA,QAAA,OAAA,kBAAA,QAAA,MAAA,aAAA,CAAA,WAAA,KAAA,GAAA,CAAA,WAAA,KAAA,GAAA,CAAA,GAAA,CAAA,KAAA,OAAA,KAAA;;WAEN,IAAI,WAAW;AACb,mBAAE,gBAAW,MAAA;aACX,IAAG,OAAA;AACD,qBAAC,QAAc,MAAI;;aAExB,IAAA,WAAA;AACD,qBAAW,gBAAoB,oBAAe,EAAA,CAAA;;aAE1C,UAAM;aACP,CAAC;;WAEL,CAAC;;SAEJ,IAAI,WAAW;AACb,iBAAO,gBAAc,cAAY;WAC/B,IAAI,YAAY;AACd,mBAAO,IAAI,GAAG,QAAG,OAAY,kBAAM,YAAA,wEAAA,QAAA,QAAA,OAAA,kBAAA,WAAA,OAAA,WAAA,KAAA,aAAA,CAAA,WAAA,KAAA,GAAA,CAAA,WAAA,KAAA,GAAA,CAAA,GAAA,WAAA,SAAA,WAAA,MAAA,SAAA,IAAA,OAAA,WAAA,MAAA,KAAA,UAAA,GAAA,QAAA,OAAA,kBAAA,YAAA,wEAAA,QAAA,QAAA,OAAA,kBAAA,QAAA,MAAA,aAAA,CAAA,WAAA,KAAA,GAAA,CAAA,WAAA,KAAA,GAAA,CAAA,GAAA,CAAA,KAAA,OAAA,KAAA;;WAErC,IAAI,WAAE;AACJ,mBAAK,gBAAa,MAAA;aAChB,IAAC,OAAA;AACJ,qBAAA,QAAA,MAAA;;aAEG,IAAE,WAAa;AACnB,qBAAW,gBAAoB,oBAAE,EAAA,CAAA;;aAE7B,UAAA;aACN,CAAA;;WAEH,CAAA;;SAEA,CAAC;;OAEL,CAAC;MACH,CAAC,EAAE,gBAAY,cAAA;MACd,WAAQ,IAAO;MACf,IAAI,WAAQ;AACV,cAAO,IAAG,iDAAW,OAAA,OAAA,YAAA,EAAA,CAAA,CAAA,KAAA,QAAA,IAAA,IAAA,KAAA,IAAA,IAAA,SAAA,EAAA,EAAA,KAAA,UAAA,MAAA,MAAA,GAAA,CAAA,KAAA,GAAA,GAAA,CAAA,KAAA,KAAA,CAAA;;;MAGxB,CAAC,CAAC;;IAEN,CAAC;;EAEL,CAAC"}

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

@@ -160,5 +160,4 @@ function ExitFunctionDeclaration() {
 }
 
 //#endregion
-exports.ExitFunctionDeclaration = ExitFunctionDeclaration;
-//# sourceMappingURL=exit-function-declaration.cjs.map
+exports.ExitFunctionDeclaration = ExitFunctionDeclaration;

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

@@ -1 +1 @@
-{"version":3,"file":"exit-function-declaration.mjs","names":[],"sources":["../../src/components/exit-function-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error({ message: \\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`,\n                ...(options.exception && typeof options.exception === \"object\" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})\n              });\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context,\n                true\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n              context,\n              true\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,SAAc,0BAA4B;;AAExC,QAAA;EAAA,gBAAA,sBAAA;GACC,UAAW;GACZ,MAAA;GACF,KAAO;GACL,IAAM,WAAU;;;MAEV,MAAC;MACJ,UAAA;MACE,MAAA;MACC,KAAA;MACD,CAAC;KAAA,gBAAiB,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACjB,MAAK;MACL,UAAC;MACD,MAAM;MACN,KAAE;MACH,CAAC;KAAE,gBAAe,OAAK,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACtB,MAAM;MACN,UAAC;MACD,MAAM;MACN,KAAC;MACF,CAAC;KAAE,gBAAM,OAAe,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACvB,MAAE;MACF,UAAQ;MACR,MAAM;MACN,KAAC;MACF,CAAC;KAAC,gBAAK,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACN,MAAC;MACD,UAAQ;MACR,MAAE;MACF,KAAE;MACH,CAAC;KAAC;;GAEN,CAAC;EAAE,gBAAQ,SAAA,EAAA,CAAA;EAAA,gBAAA,gBAAA;GACV,OAAK;GACL,MAAM;GACN,MAAM;GACN,aAAY,IAAA;GACb,CAAC;EAAE,gBAAa,gBAAmB;GAClC,SAAK;GACL,MAAK;GACL,MAAK;GACL,aAAY,IAAA;GACb,CAAC;EAAE,gBAAI,gBAAA;GACN,SAAM;GACN,MAAM;GACN,MAAK;GACL,aAAI,IAAA;GACL,CAAC;EAAE,gBAAU,SAAA,EAAA,CAAA;EAAA,gBAAA,qBAAA;GACZ,UAAG;GACH,OAAI;GACJ,MAAI;GACJ,YAAU,CAAA;IACR,MAAE;IACF,MAAC;IACD,SAAC;IACF,CAAC;GACF,IAAI,WAAM;AACR,WAAO;KAAC,WAAa,IAAC;;;;;;;;;;;;;;;;4GAgBD,YAAA,QAAA,CAAA;;;;;qDAKd;KAAA,gBAAA,aAAA;MACL,IAAE,YAAI;AACJ,cAAM,gBAAW,WAAA,EAAA,CAAA;;MAEnB,UAAI,IAAA;;;;8BAEgB,YAAA,SAAA,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2BkC,YAAA,SAAA,KAAA,CAAA;;;;;;UAMpD;KAAC;;GAER,CAAC;EAAC"}
+{"version":3,"file":"exit-function-declaration.mjs","names":[],"sources":["../../src/components/exit-function-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error({ message: \\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`,\n                ...(options.exception && typeof options.exception === \"object\" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})\n              });\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context,\n                true\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n              context,\n              true\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AA4BA,SAAS,0BAA+B;CACxC,MAAQ,UAAC,eAAqB;AAC9B,QAAO;EAAA,gBAAO,sBAAoC;;GAEhD,MAAA;GACC,KAAK;GACN,IAAA,WAAA;AACI,WAAC;KAAA,gBAAS,iBAA0B;MAClC,MAAA;;MAEA,MAAC;MACJ,KAAA;MACE,CAAA;KAAA,gBAAA,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACC,MAAA;MACA,UAAM;MACN,MAAK;MACL,KAAC;MACF,CAAC;KAAE,gBAAe,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACjB,MAAE;MACF,UAAQ;MACR,MAAM;MACN,KAAC;MACF,CAAC;KAAC,gBAAK,OAAA,EAAA,CAAA;KAAA,gBAAA,iBAAA;MACN,MAAC;MACD,UAAQ;MACR,MAAE;MACF,KAAE;MACH,CAAC;KAAE,gBAAe,OAAQ,EAAI,CAAA;KAAA,gBAAqB,iBAAiB;MACnE,MAAC;MACD,UAAM;MACN,MAAC;MACD,KAAE;MACH,CAAC;KAAC;;GAEN,CAAC;EAAE,gBAAkB,SAAS,EAAA,CAAG;EAAC,gBAAc,gBAAe;GAC9D,OAAK;GACL,MAAK;GACL,MAAK;GACL,aAAY,IAAA;GACb,CAAC;EAAE,gBAAI,gBAAA;GACN,SAAM;GACN,MAAM;GACN,MAAK;GACL,aAAU,IAAA;GACX,CAAC;EAAE,gBAAG,gBAAA;GACL,SAAM;GACN,MAAM;GACN,MAAM;GACN,aAAa,IAAI;GAClB,CAAC;EAAE,gBAAG,SAAA,EAAA,CAAA;EAAA,gBAAA,qBAAA;GACL,UAAI;GACJ,OAAG;GACH,MAAG;GACH,YAAI,CAAA;IACF,MAAM;IACN,MAAM;IACN,SAAE;IACH,CAAC;GACF,IAAG,WAAA;AACD,WAAE;KAAA,WAAA,IAAA;;;;;;;;;;;;;;;;4GAgBY,YAAA,QAAA,CAAA;;;;;qDAKV;KAAA,gBAAA,aAAA;MACF,IAAE,YAAA;AACD,cAAI,gBAAA,WAAA,EAAA,CAAA;;MAEL,UAAQ,IAAA;MACT,CAAC;KAAE,gBAAU,OAAA,EAAA,CAAA;KAAA,WAAA,IAAA;8BACR,YAAA,SAAA,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2B+H,YAAmB,SAAQ,KAAM,CAAC;;;;;;UAMnK;KAAC;;GAER,CAAC;EAAC"}

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

@@ -103,8 +103,11 @@ function VirtualCommandEntry(props) {
 					"findSuggestions"
 				],
 				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
 					"useGlobal",
-					"GlobalOptions",
 					"useGlobalOptions",
 					"withCommand",
 					"useArgs",
@@ -150,5 +153,4 @@ function VirtualCommandEntry(props) {
 
 //#endregion
 exports.VirtualCommandEntry = VirtualCommandEntry;
-exports.VirtualCommandHandlerDeclaration = VirtualCommandHandlerDeclaration;
-//# sourceMappingURL=virtual-command-entry.cjs.map
+exports.VirtualCommandHandlerDeclaration = VirtualCommandHandlerDeclaration;

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

@@ -100,8 +100,11 @@ function VirtualCommandEntry(props) {
 					"findSuggestions"
 				],
 				state: [
+					{
+						name: "GlobalOptions",
+						type: true
+					},
 					"useGlobal",
-					"GlobalOptions",
 					"useGlobalOptions",
 					"withCommand",
 					"useArgs",

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-command-entry.mjs","names":[],"sources":["../../src/components/virtual-command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { FunctionDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { TypescriptFile } from \"@powerlines/plugin-alloy/typescript/components/typescript-file\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\n\nexport interface VirtualCommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function VirtualCommandHandlerDeclaration(\n  props: VirtualCommandHandlerDeclarationProps\n) {\n  const { command, children, banner } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) virtual command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <Spacing />\n        {children}\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        {code`return showHelp(); `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface VirtualCommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The virtual command entry point for the Shell Shock project.\n */\nexport function VirtualCommandEntry(props: VirtualCommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      context.entryPath,\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n\n  return (\n    <>\n      <TypescriptFile\n        {...rest}\n        path={filePath.value}\n        imports={defu(\n          imports ?? {},\n          Object.entries(command.children)\n            .filter(([, child]) => child.isVirtual)\n            .reduce((ret, [name, child]) => {\n              ret[`./${child.name}`] = [\n                { name: \"handler\", alias: `handle${pascalCase(name)}` }\n              ];\n\n              return ret;\n            }, {} as TypescriptFileImports)\n        )}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"isDevelopment\", \"isDebug\"],\n          console: [\"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\", \"findSuggestions\"],\n          state: [\n            \"useGlobal\",\n            \"GlobalOptions\",\n            \"useGlobalOptions\",\n            \"withCommand\",\n            \"useArgs\",\n            \"hasFlag\"\n          ],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"],\n          [joinPaths(\n            \"banner\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showBanner\"]\n        })}>\n        <Spacing />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"virtual-command-entry.mjs","names":[],"sources":["../../src/components/virtual-command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { FunctionDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { TypescriptFile } from \"@powerlines/plugin-alloy/typescript/components/typescript-file\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\n\nexport interface VirtualCommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function VirtualCommandHandlerDeclaration(\n  props: VirtualCommandHandlerDeclarationProps\n) {\n  const { command, children, banner } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) virtual command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <Spacing />\n        {children}\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        {code`return showHelp(); `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface VirtualCommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The virtual command entry point for the Shell Shock project.\n */\nexport function VirtualCommandEntry(props: VirtualCommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      context.entryPath,\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n\n  return (\n    <>\n      <TypescriptFile\n        {...rest}\n        path={filePath.value}\n        imports={defu(\n          imports ?? {},\n          Object.entries(command.children)\n            .filter(([, child]) => child.isVirtual)\n            .reduce((ret, [name, child]) => {\n              ret[`./${child.name}`] = [\n                { name: \"handler\", alias: `handle${pascalCase(name)}` }\n              ];\n\n              return ret;\n            }, {} as TypescriptFileImports)\n        )}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"isDevelopment\", \"isDebug\"],\n          console: [\"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\", \"findSuggestions\"],\n          state: [\n            { name: \"GlobalOptions\", type: true },\n            \"useGlobal\",\n            \"useGlobalOptions\",\n            \"withCommand\",\n            \"useArgs\",\n            \"hasFlag\"\n          ],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"],\n          [joinPaths(\n            \"banner\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showBanner\"]\n        })}>\n        <Spacing />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/helpers/get-global-options.cjs

@@ -72,5 +72,4 @@ function getGlobalOptions() {
 }
 
 //#endregion
-exports.getGlobalOptions = getGlobalOptions;
-//# sourceMappingURL=get-global-options.cjs.map
+exports.getGlobalOptions = getGlobalOptions;

package/dist/helpers/get-global-options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"get-global-options.mjs","names":[],"sources":["../../src/helpers/get-global-options.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandOption } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\n\n/**\n * Get the default command options.\n *\n * @returns The default command options.\n */\nexport function getGlobalOptions(): CommandOption[] {\n  return [\n    {\n      name: \"help\",\n      title: \"Help\",\n      description: \"Show help information.\",\n      env: false,\n      alias: [\"h\", \"?\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"version\",\n      title: \"Version\",\n      description: \"Show the version of the application.\",\n      env: false,\n      alias: [\"v\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"verbose\",\n      title: \"Verbose\",\n      description: \"Enable verbose output.\",\n      env: \"VERBOSE\",\n      alias: [\"V\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"color\",\n      title: \"Color\",\n      description: \"Enable colored terminal output.\",\n      env: \"COLOR\",\n      alias: [\"colors\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      variadic: false,\n      skipAddingNegative: false\n    },\n    {\n      name: \"no-banner\",\n      title: \"Hide Banner\",\n      description:\n        \"Do not display the application banner displayed while running the CLI - will be set to true if running in a CI pipeline.\",\n      env: \"NO_BANNER\",\n      alias: [\"hide-banner\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      variadic: false,\n      default: false\n    }\n  ];\n}\n"],"mappings":";;;;;;;;AA0BA,SAAgB,mBAAoC;AAClD,QAAO;EACL;GACE,MAAM;GACN,OAAO;GACP,aAAa;GACb,KAAK;GACL,OAAO,CAAC,KAAK,IAAI;GACjB,MAAM,sBAAsB;GAC5B,UAAU;GACV,SAAS;GACT,UAAU;GACV,oBAAoB;GACrB;EACD;GACE,MAAM;GACN,OAAO;GACP,aAAa;GACb,KAAK;GACL,OAAO,CAAC,IAAI;GACZ,MAAM,sBAAsB;GAC5B,UAAU;GACV,SAAS;GACT,UAAU;GACV,oBAAoB;GACrB;EACD;GACE,MAAM;GACN,OAAO;GACP,aAAa;GACb,KAAK;GACL,OAAO,CAAC,IAAI;GACZ,MAAM,sBAAsB;GAC5B,UAAU;GACV,SAAS;GACT,UAAU;GACV,oBAAoB;GACrB;EACD;GACE,MAAM;GACN,OAAO;GACP,aAAa;GACb,KAAK;GACL,OAAO,CAAC,SAAS;GACjB,MAAM,sBAAsB;GAC5B,UAAU;GACV,UAAU;GACV,oBAAoB;GACrB;EACD;GACE,MAAM;GACN,OAAO;GACP,aACE;GACF,KAAK;GACL,OAAO,CAAC,cAAc;GACtB,MAAM,sBAAsB;GAC5B,UAAU;GACV,UAAU;GACV,SAAS;GACV;EACF"}
+{"version":3,"file":"get-global-options.mjs","names":[],"sources":["../../src/helpers/get-global-options.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandOption } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\n\n/**\n * Get the default command options.\n *\n * @returns The default command options.\n */\nexport function getGlobalOptions(): CommandOption[] {\n  return [\n    {\n      name: \"help\",\n      title: \"Help\",\n      description: \"Show help information.\",\n      env: false,\n      alias: [\"h\", \"?\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"version\",\n      title: \"Version\",\n      description: \"Show the version of the application.\",\n      env: false,\n      alias: [\"v\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"verbose\",\n      title: \"Verbose\",\n      description: \"Enable verbose output.\",\n      env: \"VERBOSE\",\n      alias: [\"V\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"color\",\n      title: \"Color\",\n      description: \"Enable colored terminal output.\",\n      env: \"COLOR\",\n      alias: [\"colors\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      variadic: false,\n      skipAddingNegative: false\n    },\n    {\n      name: \"no-banner\",\n      title: \"Hide Banner\",\n      description:\n        \"Do not display the application banner displayed while running the CLI - will be set to true if running in a CI pipeline.\",\n      env: \"NO_BANNER\",\n      alias: [\"hide-banner\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      variadic: false,\n      default: false\n    }\n  ];\n}\n"],"mappings":";;;;;;;;AAyBA,SAAE,mBAAA;AACF,QAAO;EAAA;GACL,MAAO;GACL,OAAA;GACA,aAAa;GACb,KAAE;GACF,OAAE,CAAA,KAAW,IAAG;GAChB,MAAM,sBAAM;GACZ,UAAU;GACV,SAAQ;GACR,UAAU;GACV,oBAAgB;GACjB;EAAE;GACD,MAAE;GACF,OAAC;GACD,aAAA;GACA,KAAE;GACF,OAAO,CAAC,IAAE;GACV,MAAE,sBAAuB;GACzB,UAAO;GACP,SAAS;GACT,UAAQ;GACR,oBAAgB;GACjB;EAAE;GACD,MAAE;GACF,OAAE;GACF,aAAC;GACD,KAAA;GACA,OAAO,CAAC,IAAC;GACT,MAAE,sBAAgB;GAClB,UAAE;GACF,SAAQ;GACR,UAAU;GACV,oBAAQ;GACT;EAAE;GACD,MAAE;GACF,OAAE;GACF,aAAE;GACF,KAAC;GACD,OAAA,CAAA,SAAA;GACA,MAAM,sBAAS;GACf,UAAU;GACV,UAAE;GACF,oBAAc;GACf;EAAE;GACD,MAAM;GACN,OAAE;GACF,aAAY;GACZ,KAAE;GACF,OAAC,CAAA,cAAA;GACD,MAAA,sBAAA;GACA,UAAS;GACT,UAAU;GACV,SAAE;GACH;EAAC"}

package/dist/index.cjs

@@ -35,10 +35,7 @@ const plugin = (options = {}) => {
 					isCaseSensitive: false,
 					...options
 				};
-			}
-		},
-		{
-			name: "shell-shock:script-preset:generate-entrypoint",
+			},
 			prepare: {
 				order: "post",
 				async handler() {
@@ -123,5 +120,4 @@ const plugin = (options = {}) => {
 
 //#endregion
 exports.default = plugin;
-exports.plugin = plugin;
-//# sourceMappingURL=index.cjs.map
+exports.plugin = plugin;

package/dist/index.d.cts.map

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

package/dist/index.d.mts.map

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

package/dist/index.mjs

@@ -30,10 +30,7 @@ const plugin = (options = {}) => {
 					isCaseSensitive: false,
 					...options
 				};
-			}
-		},
-		{
-			name: "shell-shock:script-preset:generate-entrypoint",
+			},
 			prepare: {
 				order: "post",
 				async handler() {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport banner from \"@shell-shock/plugin-banner\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport type { Plugin } from \"powerlines\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getGlobalOptions } from \"./helpers/get-global-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    ...console<TContext>(options),\n    ...help<TContext>(options),\n    ...banner<TContext>(options.banner),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          globalOptions: getGlobalOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"help\"\n                  ],\n                  utils: [\"isMinimal\"],\n                  state: [\"useArgs\", \"hasFlag\", \"isHelp\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <Spacing />\n                {code`await showBanner();`}\n                <Spacing />\n                {code`return showHelp();`}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;EAAA,GAAA,QAAA,QAAA;EAAA,GAAA,KAAA,QAAA;EAAA,GAAA,OAAA,QAAA,OAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACH,WAAC;KACA,eAAe;KACf,iBAAiB;KACpB,GAAA;KACE;;GAEH;EAAE;GACD,MAAM;GACN,SAAK;;IAEH,MAAE,UAAO;KACP,MAAE,SAAa;AACf,UAAE,MAAA,oEAAsB;AACxB,YAAK,OAAA,MAAA,CAAA,gBAAA,UAAA;MACJ,gBAAA;OACH,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA,CAAA,YAAA;OACD,OAAA;QAAA;QAAA;QAAA;QAAA;OACO;MACL,IAAQ,WAAC;AACP,cAAQ;QAAI,gBAAC,MAAA;SACP,IAAA,OAAU;AACT,iBAAK,OAAA,KAAA,OAAA,SAAA,CAAA,SAAA;;SAET,IAAA,WAAA;;;YAEM,SAAM;YACP,MAAA;YACH,MAAA;YACE,aAAA,IAAA;YACC,CAAA;WAAA,gBAAgB,OAAA,EAAA,CAAA;WAAA,gBAAA,eAAA;YACd,UAAS,EAAA;YACT,IAAG,WAAQ;AACT,oBAAC,OAAU,YAAA,EAAA;;YAEd,CAAC;WAAE,gBAAW,OAAA,EAAA,CAAA;WAAA;;SAElB,CAAC;QAAE,gBAAG,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA,gBAAA,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA;;MAEV,CAAC,EAAE,gBAAe,MAAS;MAC1B,IAAI,OAAI;AACN,cAAK,OAAS,OAAE,OAAY,SAAK,CAAA,SAAU;;MAE7C,IAAI,WAAM;AACR,cAAO,gBAAW,KAAA;QAChB,IAAI,OAAO;AACT,gBAAI,OAAA,OAAiB,OAAC,SAAW;;QAEnC,gBAAU;QACV,WAAK,UAAc,gBAAc,MAAU;SACzC,IAAG,OAAK;AACN,iBAAI,MAAA;;SAEN,IAAC,WAAW;AACX,iBAAQ,gBAAC,cAAA,EACT,SAAY,OACb,CAAA;;SAEA,IAAI,WAAO;AACT,iBAAO,gBAAG,qBAAA,EACR,SAAC,OACF,CAAC;;SAEL,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport banner from \"@shell-shock/plugin-banner\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport type { Plugin } from \"powerlines\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getGlobalOptions } from \"./helpers/get-global-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n): Plugin<TContext>[] => {\n  return [\n    ...console<TContext>(options),\n    ...help<TContext>(options),\n    ...banner<TContext>(options.banner),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          globalOptions: getGlobalOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"help\"\n                  ],\n                  utils: [\"isMinimal\"],\n                  state: [\"useArgs\", \"hasFlag\", \"isHelp\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <Spacing />\n                {code`await showBanner();`}\n                <Spacing />\n                {code`return showHelp();`}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For\n                  each={Object.values(\n                    this.commands as Record<string, CommandTree>\n                  )}\n                  doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkCA,MAAE,UAAA,UAAA,EAAA,KAAA;AACA,QAAK;EAAA,GAAM,QAAM,QAAK;EAAM,GAAA,KAAA,QAAA;EAAA,GAAA,OAAA,QAAA,OAAA;EAAA;GAC5B,MAAA;GACF,SAAa;AACX,SAAS,MAAA,uEAA8B;AACxC,WAAA;KACC,eAAS;KACR,iBAAsB;KACjB,GAAC;KACF;;GAEH,SAAS;IACT,OAAA;IACE,MAAM,UAAO;KACb,MAAQ,SAAC;AACP,UAAK,MAAK,oEAAA;AACV,YAAG,OAAU,MAAO,CAAC,gBAAkB,UAAU;MAChD,gBAAA;;;;;;;;OAED,OAAO,CAAA,YAAA;OACL,OAAA;QAAA;QAAe;QAAgB;QAAA;OAC/B;MACA,IAAG,WAAA;AACJ,cAAA;QAAA,gBAAA,MAAA;SACF,IAAA,OAAA;AACQ,iBAAA,OAAA,KAAA,OAAA,SAAA,CAAA,SAAA;;SAED,IAAA,WAAU;AACT,iBAAK;WAAA,gBAAA,gBAAA;YACP,SAAU;YACZ,MAAA;;YAEM,aAAM,IAAA;YACP,CAAA;WAAA,gBAAA,OAAA,EAAA,CAAA;WAAA,gBAAA,eAAA;YACH,UAAA,EAAA;YACE,IAAA,WAAA;AACC,oBAAA,OAAgB,YAAA,EAAA;;YAEf,CAAC;WAAE,gBAAS,OAAA,EAAA,CAAA;WAAA;;SAEhB,CAAC;QAAE,gBAAe,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA,gBAAA,SAAA,EAAA,CAAA;QAAA,IAAA;QAAA;;MAEtB,CAAC,EAAE,gBAAa,MAAA;MACf,IAAI,OAAK;AACP,cAAM,OAAQ,OAAC,OAAW,SAAA,CAAA,SAAA;;MAE5B,IAAI,WAAI;AACN,cAAK,gBAAkB,KAAK;QAC1B,IAAI,OAAC;AACH,gBAAI,OAAA,OAAA,OAAA,SAAA;;QAEN,gBAAY;QACZ,WAAM,UAAa,gBAAgB,MAAA;SACjC,IAAG,OAAA;AACD,iBAAM,MAAA;;SAER,IAAG,WAAK;AACN,iBAAI,gBAAA,cAAA,EACL,SAAS,OACT,CAAA;;SAED,IAAC,WAAY;AACb,iBAAQ,gBAAA,qBAAA,EACJ,SAAM,OACT,CAAA;;SAEF,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-script",
-  "version": "0.6.62",
+  "version": "0.6.65",
   "private": false,
   "description": "A Shell Shock preset that generates a fully-featured script application.",
   "keywords": [
@@ -195,25 +195,21 @@
   "dependencies": {
     "@alloy-js/core": "0.23.0-dev.8",
     "@alloy-js/typescript": "0.23.0-dev.4",
-    "@powerlines/deepkit": "^0.8.2",
-    "@powerlines/plugin-alloy": "^0.26.18",
-    "@powerlines/plugin-plugin": "^0.12.350",
-    "@shell-shock/core": "^0.17.7",
-    "@shell-shock/plugin-banner": "^0.1.34",
-    "@shell-shock/plugin-help": "^0.2.25",
-    "@shell-shock/plugin-console": "^0.2.11",
-    "@shell-shock/plugin-theme": "^0.4.20",
-    "@stryke/helpers": "^0.10.8",
-    "@stryke/path": "^0.27.4",
-    "@stryke/string-format": "^0.17.9",
+    "@powerlines/deepkit": "^0.8.64",
+    "@powerlines/plugin-alloy": "^0.26.84",
+    "@powerlines/plugin-plugin": "^0.12.416",
+    "@shell-shock/core": "^0.17.10",
+    "@shell-shock/plugin-banner": "^0.1.37",
+    "@shell-shock/plugin-console": "^0.2.14",
+    "@shell-shock/plugin-help": "^0.2.28",
+    "@shell-shock/plugin-theme": "^0.4.23",
+    "@stryke/helpers": "^0.10.12",
+    "@stryke/path": "^0.28.2",
+    "@stryke/string-format": "^0.17.13",
     "defu": "^6.1.7",
-    "powerlines": "^0.42.40"
-  },
-  "devDependencies": {
-    "@babel/core": "^7.29.0",
-    "@powerlines/plugin-alloy": "^0.26.18",
-    "@types/node": "^25.6.0"
+    "powerlines": "^0.47.4"
   },
+  "devDependencies": { "@types/node": "^25.6.0" },
   "publishConfig": { "access": "public" },
-  "gitHead": "dcc6ef2c66de17416af3242b25b977c49974b4a1"
+  "gitHead": "7b4030fd6be000c960e8cc4c4f7b4db205054e69"
 }

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

@@ -1 +0,0 @@
-{"version":3,"file":"bin-entry.cjs","names":[],"sources":["../../src/components/bin-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { FunctionDeclaration, IfStatement } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocRemarks,\n  TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { ExitFunctionDeclaration } from \"./exit-function-declaration\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <Spacing />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        const startDate = new Date();\n        try {\n          process.on(\"exit\", () => exit({\n            startDate,\n            skipProcessExit: true,\n            isSynchronous: true,\n            signal: 0\n          }));\n          process.on(\"beforeExit\", () => exit({\n            startDate,\n            signal: 0\n          }));\n          process.on(\"message\", message => {\n            if (message === 'shutdown') {\n              exit({\n                startDate,\n                isSynchronous: true,\n                signal: -128\n              });\n            }\n          });\n\n          process.once(\"SIGTERM\", () => exit({\n            startDate,\n            signal: 15\n          }));\n          process.once(\"SIGINT\", () => exit({\n            startDate,\n            signal: 2\n          }));\n          process.once(\"SIGUSR2\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n          process.once(\"SIGQUIT\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              startDate,\n              signal: 12\n            });\n          });\n\n          for (const type of [\"unhandledRejection\", \"uncaughtException\"]) {\n            process.on(type, err => exit({\n              startDate,\n              exception: err || new Error(\\`An \\${type === \"unhandledRejection\" ? \"unhandled promise rejection\" : \"uncaught exception\"} occurred during processing - the application is shutting down.\\`)\n            }));\n          }\n\n          await withGlobal(async () => {\n            const result = await main();\n            if (result?.error) {\n              error(result.error);\n            }\n          });\n\n          exit({ startDate });\n        } catch (err) {\n          exit({ startDate, exception: err as Error });\n        }\n      })();\n      `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface BinEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"hashbang\"\n> {\n  prefix?: Children;\n  postfix?: Children;\n  children: Children;\n}\n\n/**\n * The binary entry point for the Shell Shock project.\n */\nexport function BinEntry(props: BinEntryProps) {\n  const { prefix, postfix, builtinImports, imports, children, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const bins = computed(() => getUnique(Object.values(context.config.bin)));\n\n  return (\n    <For each={bins.value}>\n      {bin => (\n        <EntryFile\n          {...rest}\n          path={findFileName(replaceExtension(bin))}\n          typeDefinition={{\n            file: bin,\n            output: \"bin\"\n          }}\n          imports={defu(\n            imports ?? {},\n            Object.entries(context.commands)\n              .filter(([, command]) => command.isVirtual)\n              .reduce((ret, [name, command]) => {\n                ret[`./${command.name}`] = [\n                  { name: \"handler\", alias: `handle${pascalCase(name)}` }\n                ];\n\n                return ret;\n              }, {} as TypescriptFileImports)\n          )}\n          builtinImports={defu(builtinImports ?? {}, {\n            env: [\"env\", \"isDevelopment\", \"isDebug\"],\n            console: [\n              \"verbose\",\n              \"table\",\n              \"writeLine\",\n              \"borderColors\",\n              \"textColors\",\n              \"stripAnsi\",\n              \"error\",\n              \"warn\"\n            ],\n            utils: [\"isUnicodeSupported\", \"findSuggestions\"],\n            state: [\"withGlobal\", \"useGlobal\", \"hasFlag\"],\n            help: [\"showHelp\"],\n            banner: [\"showBanner\"]\n          })}>\n          <ExitFunctionDeclaration />\n          <Spacing />\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <Spacing />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application.`}>\n            <TSDocRemarks>\n              {`This file serves as the main entry point for the binary executable of the ${getAppTitle(\n                context,\n                true\n              )} command-line interface application. It sets up the necessary environment and runs the application logic with proper exit handling. The main function is defined within this file, and the application is executed inside an asynchronous IIFE to allow for the use of async/await syntax. The file also includes signal handling for graceful shutdowns and error handling for uncaught exceptions and unhandled promise rejections.`}\n            </TSDocRemarks>\n            <TSDocReturns>\n              {`Returns a promise that resolves to either a successful result or an error object.`}\n            </TSDocReturns>\n          </TSDoc>\n          <FunctionDeclaration\n            async\n            returnType=\"any | { error: string | Error }\"\n            name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${\n                context?.packageJson.version\n                  ? `\"${context?.packageJson.version}\"`\n                  : \"0.0.1\"\n              });\n              return; `}\n            </IfStatement>\n            <Spacing />\n            {children}\n            <hbr />\n          </FunctionDeclaration>\n          <hbr />\n          <hbr />\n          <hbr />\n          <Show when={Boolean(postfix)} fallback={<RunApplication />}>\n            {postfix}\n          </Show>\n          <hbr />\n        </EntryFile>\n      )}\n    </For>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAE,iBAAA;AACA,QAAM;kDAAoB,0DAAO,EAAI,CAAC;EAAA,mBAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8E9C,MAAO,EACL,QACC,SACD,gBACA,SACA,UACA,GAAA,SACF;;CAEE,MAAA,oFAAA,OAAA,OAAA,QAAA,OAAA,IAAA,CAAA,CAAA;AACA,wDAAwB,oBAAI;EAC5B,IAAA,OAAA;AACI,UAAC,KAAS;;;GAGd,IAAM,OAAS;AACT,mGAAgC,IAAO,CAAA;;GAE7C,gBAAO;IACD,MAAM;IACP,QAAO;IACP;GACD,IAAI,UAAQ;AACV,6BAAQ,WAAa,EAAA,EAAA,OAAA,QAAqB,QAAC,SAAA,CAAA,QAAA,GAAA,aAAA,QAAA,UAAA,CAAA,QAAA,KAAA,CAAA,MAAA,aAAA;AACzC,SAAA,KAAA,QAAgB,UAAA,CAAA;MACd,MAAM;MACN,OAAO,2DAAK,KAAA;MACb,CAAA;AACD,YAAO;OACN,EAAC,CAAa,CAAA;;GAEnB,IAAI,iBAAgB;AAClB,6BAAO,kBAAoB,EAAA,EAAO;KAChC,KAAK;MAAC;MAAO;MAAiB;MAAG;KACjC,SAAS;MAAC;MAAO;MAAU;MAAgB;MAAgB;MAAG;MAAA;MAAA;MAAA;KAC9D,OAAO,CAAA,sBAAA,kBAAA;;;;;;KAEP,MAAM,CAAA,WAAU;KAChB,QAAQ,CAAC,aAAI;KACd,CAAC;;GAEJ,IAAI,WAAS;AACX,WAAI;qDAAS,sEAAA,EAAA,CAAA;qDAAA,0DAAA,EAAA,CAAA;qDAAA,qBAAA;MACX,IAAI,OAAC;AACH,cAAG,QAAM,OAAA;;MAEX,IAAI,WAAC;AACH,cAAG,CAAA,wDAAW,0DAAA,EAAA,CAAA,CAAA;;MAEjB,CAAC;qDAAW,4DAAA;MACX,IAAI,UAAK;AACP,cAAC,8EAAA,SAAA,KAAA,CAAA;;MAEH,IAAE,WAAS;AACT,cAAO,iDAAW,mEAAA,EAClB,IAAM,WAAI;AACT,eAAA,6HAAA,SAAA,KAAA,CAAA;UAEF,CAAA,kDAAS,mEAAA,EACT,UAAW,qFACT,CAAA,CAAA;;MAEJ,CAAC;qDAAM,0CAAA;MACN,OAAC;MACD,YAAY;MACZ,MAAI;MACJ,IAAI,WAAA;AACF,cAAG;wDAAuB,kCAAa;SACtC,WAAY,mBAAA;SACX,IAAE,WAAU;AACV,iBAAO,mBAAA,eAAA,SAAA,YAAA,UAAA,IAAA,SAAA,YAAA,QAAA,KAAA,QAAA;;;SAGV,CAAC;wDAAY,0DAAA,EAAA,CAAA;QAAA;wDAAA,OAAA,EAAA,CAAA;QAAA;;MAEjB,CAAC;qDAAgB,OAAQ,EAAK,CAAA;qDAAqB,OAAA,EAAA,CAAU;qDAAoB,OAAO,EAAC,CAAA;qDAAA,qBAAA;MACxF,IAAI,OAAA;AACF,cAAK,QAAA,QAAA;;MAEP,IAAE,WAAA;AACA,8DAAyB,gBAAgB,EAAE,CAAA;;MAE7C,UAAG;MACJ,CAAC;qDAAkB,OAAK,EAAA,CAAA;KAAA;;GAE5B,CAAC,CAAC;EACJ,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"command-entry.cjs","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport { EntryFile } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport type { CommandTree } from \"@shell-shock/core\";\nimport { CommandValidationLogic } from \"@shell-shock/core/components/command-validation-logic\";\nimport { IsDebug } from \"@shell-shock/core/components/helpers\";\nimport {\n  CommandParserLogic,\n  OptionsInterfaceDeclaration\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport { findFilePath, relativePath } from \"@stryke/path/find\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replaceExtension } from \"@stryke/path/replace\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code` return withCommand(\"${command.path}\", [${command.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? camelCase(getDynamicPathSegmentName(segment))\n            : `\"${segment}\"`\n        )\n        .join(\", \")}], [${\n        Object.keys(command.options).length > 0 ? `options` : \"\"\n      }${\n        command.args.length > 0\n          ? `${\n              Object.keys(command.options).length > 0 ? \", \" : \"\"\n            }${command.args.map(arg => camelCase(arg.name)).join(\", \")}`\n          : \"\"\n      }], handle${pascalCase(command.name)}); `}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(\n  props: CommandHandlerDeclarationProps\n) {\n  const { command, banner, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <OptionsInterfaceDeclaration command={command} />\n      <Spacing />\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <CommandParserLogic\n          command={command}\n          appSpecificEnvPrefix={context.config.appSpecificEnvPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        {code`writeLine(\"\");`}\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(textColors.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\n          writeLine(\"\");\n          debug(\\`Command path: ${command.segments\n            .map(segment =>\n              isDynamicPathSegment(segment)\n                ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n                : segment\n            )\n            .join(\" / \")} \\\\n\\\\nOptions: \\\\n${Object.values(command.options)\n            .map(\n              option =>\n                ` - ${kebabCase(option.name)}: \\${options.${camelCase(\n                  option.name\n                )} === undefined ? \"\" : JSON.stringify(options.${camelCase(\n                  option.name\n                )})}`\n            )\n            .join(\"\\\\n\")}${\n            command.args.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.args\n                  .map(\n                    arg =>\n                      ` - ${kebabCase(arg.name)}: \\${${camelCase(\n                        arg.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        arg.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`); `}\n        </IfStatement>\n        <Spacing />\n        {children}\n        <Spacing />\n        <IfStatement condition={code`options.help`}>\n          {code`return showHelp(); `}\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n  const commandSourcePath = computed(() =>\n    replaceExtension(\n      relativePath(\n        joinPaths(context.entryPath, findFilePath(filePath.value)),\n        command.entry.input?.file || command.entry.file\n      )\n    )\n  );\n  const typeDefinition = computed(() => ({\n    ...command.entry,\n    output: command.id\n  }));\n\n  return (\n    <>\n      <EntryFile\n        {...rest}\n        path={filePath.value}\n        typeDefinition={typeDefinition.value}\n        imports={defu(imports ?? {}, {\n          [commandSourcePath.value.startsWith(\".\")\n            ? commandSourcePath.value\n            : `./${commandSourcePath.value}`]:\n            `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\"debug\", \"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\"],\n          state: [\n            \"useGlobal\",\n            \"GlobalOptions\",\n            \"useGlobalOptions\",\n            \"useArgs\",\n            \"hasFlag\",\n            \"withCommand\"\n          ],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"],\n          [joinPaths(\n            \"banner\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showBanner\"]\n        })}>\n        <Spacing />\n        <OptionsInterfaceDeclaration command={command} />\n        <Spacing />\n        <CommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandValidationLogic command={command} />\n          <IfStatement condition={code`failures.length > 0`}>\n            {code`error(\\`The following validation failures were found while processing the user provided input, and must be corrected before the \\${italic(\"${\n              command.title\n            }\")} command can be executed: \\\\n\\\\n\\${failures.map(failure => \" - \" + failure).join(\"\\\\n\")}\\`);\n                options.help = true; `}\n          </IfStatement>\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAO,kBAAA,OAEL;CACA,MAAA,EACA,YACI;AACN,QAAS,4CAAY,mBAAM,wBAAkB,QAAA,KAAA,MAAA,QAAA,SAAA,KAAA,qEAAA,QAAA,iHAAA,QAAA,CAAA,GAAA,IAAA,QAAA,GAAA,CAAA,KAAA,KAAA,CAAA,MAAA,OAAA,KAAA,QAAA,QAAA,CAAA,SAAA,IAAA,YAAA,KAAA,QAAA,KAAA,SAAA,IAAA,GAAA,OAAA,KAAA,QAAA,QAAA,CAAA,SAAA,IAAA,OAAA,KAAA,QAAA,KAAA,KAAA,wDAAA,IAAA,KAAA,CAAA,CAAA,KAAA,KAAA,KAAA,GAAA,6DAAA,QAAA,KAAA,CAAA,KAAA,kDAAA,OAAA,EAAA,CAAA,CAAA;;;;;AAW7C,SAAU,0BAAiB,OAAA;SAEzB,SACE,QACA,aACE;CACJ,MAAM,6EAA8B;AACpC,QAAO;kDAAe,+EAAiC,EAC5C,SACV,CAAC;kDAAI,0DAAA,EAAA,CAAA;kDAAA,4DAAA;GACJ,IAAI,UAAU;AACZ,WAAE,OAAY,QAAQ,MAAA,kDAAoB,QAAG,CAAA,GAAS,QAAG,SAAA,KAAA,qEAAA,QAAA,GAAA,wHAAA,QAAA,CAAA,CAAA,KAAA,QAAA,CAAA,KAAA,IAAA,CAAA;;GAE3D,IAAI,WAAQ;AACV,WAAO;qDAAC,mEAAA,EACN,IAAI,WAAS;AACX,aAAK,GAAA,QAAa,YAAW,QAAS,QAAK,GAAM,CAAC;QAErD,CAAC;qDAAoB,OAAC,EAAQ,CAAA;qDAAU,iEAAA,EACxC,IAAK,WAAA;AACN,aAAA,QAAA;QAEN,CAAA;qDAAA,iEAAA;;MAEO,UAAU;MACf,CAAA;KAAO;;GAEP,CAAA;kDAAmB,0CAAA;GACrB,UAAA;;GAEE,MAAA;GACE,YAAW,CAAA;IACb,MAAA;IACI,MAAC;IACL,SAAO;IACP,CAAA;GACA,IAAM,WAAW;;;MAEF;;AAER,cAAA,QAAA,OAAA;;MAEF,IAAA,kBAAA;AACA,cAAS,QAAA,OAAA;;MAET,CAAC;qDAAgB,0DAAa,EAAE,CAAC;qDAAoB,qBAAI;MACxD,IAAG,OAAI;AACL,cAAE,QAAA,OAAoB;;MAExB,UAAQ;MACT,CAAC;qDAAE,0DAAA,EAAA,CAAA;KAAA,mBAAA;qDAAA,kCAAA;MACF,IAAG,YAAY;AACd,8DAAyB,8CAAA,EAAY,CAAA;;MAEtC,IAAC,WAAY;AACZ,cAAA,mBAAW;;kCAEb,QAAA,SAAA,KAAA,qEAAA,QAAA,GAAA,oHAAA,QAAA,CAAA,CAAA,KAAA,QAAA,CAAA,KAAA,MAAA,CAAA,qBAAA,OAAA,OAAA,QAAA,QAAA,CAAA,KAAA,WAAA,sDAAA,OAAA,KAAA,CAAA,+DAAA,OAAA,KAAA,CAAA,+FAAA,OAAA,KAAA,CAAA,IAAA,CAAA,KAAA,MAAA,GAAA,QAAA,KAAA,SAAA,IAAA,wBAAA,QAAA,KAAA,KAAA,QAAA,sDAAA,IAAA,KAAA,CAAA,uDAAA,IAAA,KAAA,CAAA,uFAAA,IAAA,KAAA,CAAA,IAAA,CAAA,KAAA,MAAA,KAAA,GAAA;;MAEA,CAAC;qDAAA,0DAAA,EAAA,CAAA;KAAA;qDAAA,0DAAA,EAAA,CAAA;qDAAA,kCAAA;MACA,WAAM,mBAAO;MACb,UAAU,mBAAI;MACf,CAAC;qDAAC,iCAAA,EACD,IAAE,WAAS;AACT,aAAA,iDAAsB,OAAQ,EAAA,CAAM,kDAAC,mBAAoB,EACzD,SACD,CAAA,CAAA;QAEF,CAAC;KAAC;;GAEN,CAAC;EAAC;;;;;AASL,SAAY,aAAA,OAAA;CACV,MAAM,EACJ,SACA,SACA,gBACA,GAAG,SACD;CACJ,MAAM,6EAAiB;CACvB,MAAM,+EAAY,QAAA,SAAA,QAAA,YAAA,0DAAA,QAAA,CAAA,CAAA,KAAA,IAAA,EAAA,WAAA,CAAA;CAClB,MAAM,uKAAI,QAAA,+CAAA,SAAA,MAAA,CAAA,EAAA,QAAA,MAAA,OAAA,QAAA,QAAA,MAAA,KAAA,CAAA,CAAA;CACV,MAAM,qDAAkB;EACtB,GAAG,QAAK;EACR,QAAQ,QAAQ;EACjB,EAAE;AACH,QAAO,iDAAgB,gHAAA,MAAA;EACrB,IAAI,OAAO;AACT,UAAO,SAAS;;EAElB,IAAI,iBAAgB;AAClB,UAAO,eAAa;;EAEtB,IAAI,UAAU;AACZ,4BAAW,WAAA,EAAA,EAAA,GACR,kBAAQ,MAAA,WAAA,IAAA,GAAA,kBAAA,QAAA,KAAA,kBAAA,UAAA,2DAAA,QAAA,KAAA,IACV,CAAC;;EAEJ,IAAI,iBAAS;AACX,4BAAY,kBAAA,EAAA,EAAA;IACV,KAAC;KAAA;KAAY;KAAgB;KAAQ;IACrC,SAAQ;KAAA;KAAO;KAAY;KAAC;KAAA;KAAA;IAC5B,OAAE,CAAA,aAAW,qBAAA;IACb,OAAC;KAAA;KAAU;KAAA;KAAA;KAAA;KAAA;KAAA;sCACH,QAAA,GAAA,QAAA,SAAA,QAAA,YAAA,0DAAA,QAAA,CAAA,CAAA,GAAA,CAAA,WAAA;sCACL,UAAkB,GAAA,QAAS,SAAU,QAAA,YAAA,0DAAA,QAAA,CAAA,CAAA,GAAA,CAAA,aAAA;IACzC,CAAC;;EAEJ,IAAE,WAAA;AACH,UAAA;oDAAA,0DAAA,EAAA,CAAA;oDAAA,+EAAA,EACH;;;KAEiB;KACf,QAAc,mBAAA;KACR,IAAI,WAAA;AACV,aAAA,iDAAA,8EAAA,EACS,SACX,CAAA,kDAAA,kCAAA;;OAEE,IAAA,WAAA;AACY,eAAO,mBAAA,8IAAiC,QAAA,MAAA;;;OAG5C,CAAA,CAAA;;KAEH,CAAC;IAAA;;EAEL,CAAC,CAAA,kDAAS,oBAAA;EACT,IAAE,OAAQ;AACR,UAAG,OAAO,OAAW,QAAC,SAAA;;EAExB,WAAS,0DAAE,qBAAA;GACX,IAAA,OAAA;AACD,WAAA,MAAA;;GAEC,IAAA,WAAgB;AACd,2DAAY,cAAA,EACV,SAAU,OACV,CAAA;;GAEJ,IAAA,WAAA;AACD,2DAAA,8DAAA,EACK,SAAA,OACD,CAAA;;GAEF,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"command-router.cjs","names":[],"sources":["../../src/components/command-router.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseIfClause,\n  IfStatement,\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 { DynamicImportStatement } from \"@powerlines/plugin-alloy/typescript/components/dynamic-import-statement\";\nimport { CommandContext, useCommand } from \"@shell-shock/core/contexts/command\";\nimport { isDynamicPathSegment } from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport function CommandRouterRoute() {\n  const command = useCommand();\n\n  return (\n    <>\n      <Show when={!command.isVirtual}>\n        <DynamicImportStatement\n          name={`handle${pascalCase(command.name)}`}\n          importPath={`./${\n            command.segments.filter(segment => !isDynamicPathSegment(segment))[\n              command.segments.filter(segment => !isDynamicPathSegment(segment))\n                .length - 1\n            ]\n          }`}\n          exportName=\"handler\"\n        />\n      </Show>\n      <hbr />\n      {code`return handle${pascalCase(command.name)}(args);`}\n    </>\n  );\n}\n\nexport interface CommandRouterProps {\n  segments: string[];\n  commands?: Record<string, CommandTree>;\n  route?: Children;\n}\n\n/**\n * The command router component.\n */\nexport function CommandRouter(props: CommandRouterProps) {\n  const { segments, commands, route } = props;\n\n  const index = computed(() => 2 + (segments.length ?? 0));\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <VarDeclaration\n        let\n        name=\"command\"\n        type=\"string\"\n        initializer={code`\"\";`}\n      />\n      <Spacing />\n      <Show when={commands && Object.keys(commands).length > 0}>\n        <IfStatement\n          condition={code`args.length > ${\n            index.value\n          } && args[${index.value}]`}>{code`command = args[${\n          index.value\n        }];`}</IfStatement>\n        <Spacing />\n      </Show>\n      <CommandRouterBody\n        segments={segments}\n        commands={commands}\n        route={route}\n      />\n    </Show>\n  );\n}\n\n/**\n * The internal command router body logic component.\n */\nexport function CommandRouterBody(props: CommandRouterProps) {\n  const { commands, route } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <Show when={commands && Object.keys(commands).length > 0}>\n      <IfStatement condition={code`!command.startsWith(\"-\")`}>\n        <For each={Object.values(commands ?? {})}>\n          {(subcommand, idx) => (\n            <CommandContext.Provider value={subcommand}>\n              <Show\n                when={Boolean(idx)}\n                fallback={\n                  <IfStatement\n                    condition={code`${\n                      context.config.isCaseSensitive\n                        ? \"command\"\n                        : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                    } === \"${\n                      context.config.isCaseSensitive\n                        ? subcommand.name\n                        : subcommand.name\n                            .toLowerCase()\n                            .replaceAll(\"-\", \"\")\n                            .replaceAll(\"_\", \"\")\n                    }\"${\n                      subcommand.alias && subcommand.alias.length > 0\n                        ? ` || ${subcommand.alias\n                            .map(\n                              alias =>\n                                `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                  context.config.isCaseSensitive\n                                    ? alias\n                                    : alias\n                                        .toLowerCase()\n                                        .replaceAll(\"-\", \"\")\n                                        .replaceAll(\"_\", \"\")\n                                }\"`\n                            )\n                            .join(\" || \")}`\n                        : \"\"\n                    }`}>\n                    <Show\n                      when={Boolean(route)}\n                      fallback={<CommandRouterRoute />}>\n                      {route}\n                    </Show>\n                  </IfStatement>\n                }>\n                <ElseIfClause\n                  condition={code`${\n                    context.config.isCaseSensitive\n                      ? \"command\"\n                      : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'\n                  } === \"${\n                    context.config.isCaseSensitive\n                      ? subcommand.name\n                      : subcommand.name\n                          .toLowerCase()\n                          .replaceAll(\"-\", \"\")\n                          .replaceAll(\"_\", \"\")\n                  }\"${\n                    subcommand.alias && subcommand.alias.length > 0\n                      ? ` || ${subcommand.alias\n                          .map(\n                            alias =>\n                              `${context.config.isCaseSensitive ? \"command\" : 'command.toLowerCase().replaceAll(\"-\", \"\").replaceAll(\"_\", \"\")'} === \"${\n                                context.config.isCaseSensitive\n                                  ? alias\n                                  : alias\n                                      .toLowerCase()\n                                      .replaceAll(\"-\", \"\")\n                                      .replaceAll(\"_\", \"\")\n                              }\"`\n                          )\n                          .join(\" || \")}`\n                      : \"\"\n                  }`}>\n                  <Show when={Boolean(route)} fallback={<CommandRouterRoute />}>\n                    {route}\n                  </Show>\n                </ElseIfClause>\n              </Show>\n            </CommandContext.Provider>\n          )}\n        </For>\n        <ElseIfClause\n          condition={code`Boolean(command) && !command.startsWith(\"-\")`}>{code`const suggestions = findSuggestions(command, [${Object.values(\n          commands ?? {}\n        )\n          .map(\n            cmd =>\n              `\"${cmd.name}\"${(cmd.alias ?? []).map(alias => `, \"${alias}\"`).join(\"\")}`\n          )\n          .join(\", \")}]).slice(0, 3);\n        error(\\`Unknown command: \"\\${command}\"\\${suggestions && suggestions.length > 0 ? \\`, did you mean: \\${suggestions.length === 1 ? \\`\"\\${suggestions[0]}\"\\` : suggestions.map((suggestion, i) => i < suggestions.length - 1 ? \\`\"\\${suggestion}\", \\` : \\`or \"\\${suggestion}\"\\`)}?\\` : \"\"} \\`);`}</ElseIfClause>\n      </IfStatement>\n    </Show>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAc,qBAAqB;CACnC,MAAQ,8DAAqB;AAC7B,QAAO;kDAAO,qBAAoB;;AAE5B,WAAC,CAAA,QAAS;;;AAGd,2DAAO,gGAAA;KACJ,IAAA,OAAA;AACE,aAAU,2DAAoB,QAAA,KAAA;;KAE7B,IAAE,aAAe;AACf,aAAA,KAAY,QAAI,SAAA,QAAA,YAAA,0DAAA,QAAA,CAAA,CAAA,QAAA,SAAA,QAAA,YAAA,0DAAA,QAAA,CAAA,CAAA,SAAA;;KAElB,YAAM;KACP,CAAC;;GAEL,CAAC;kDAAQ,OAAA,EAAA,CAAA;6CAAA,mBAAA,kEAAA,QAAA,KAAA,CAAA,SAAA;EAAA;;;;;AAWZ,SAAY,cAAQ,OAAA;CAClB,MAAA,EACA,UACF,oBAEE;CACA,MAAK,2CAAwB,KAAA,SAAA,UAAA,GAAA;AAC7B,wDAAA,qBAAA;EACF,IAAO,OAAQ;AACb,UAAQ,YAAU,OAAU,KAAO,SAAQ,CAAA,SAAA;;EAE3C,IAAM,WAAQ;;;KAER,OAAC;KACJ,MAAS;KACP,MAAA;KACC,aAAA,mBAAA;KACD,CAAC;oDAAa,0DAAA,EAAA,CAAA;oDAAA,qBAAA;KACb,IAAI,OAAE;AACN,aAAA,YAAqB,OAAC,KAAA,SAAA,CAAA,SAAA;;KAEvB,IAAA,WAAS;AACT,aAAU,iDAAmB,kCAAM;OACjC,IAAA,YAAA;AACC,eAAW,mBAAI,iBAAgB,MAAA,MAAA,WAAA,MAAA,MAAA;;OAE7B,IAAG,WAAY;AACjB,eAAM,mBAAA,kBAAA,MAAA,MAAA;;OAEP,CAAA,kDAAS,0DAAA,EAAA,CAAA,CAAA;;KAEX,CAAA;oDAAA,mBAAA;KACW;KACA;KACH;KACR,CAAA;IAAA;;EAEJ,CAAA;;;;;AAMH,SAAgB,kBAAkB,OAA2B;CAC3D,MAAM,YAEN;CAEA,MAAM,6EAAC;AACP,wDAAyB,qBAAC;EACxB,IAAG,OAAA;AACD,UAAO,YAAY,OAAO,KAAC,SAAa,CAAC,SAAE;;EAE7C,IAAI,WAAK;AACP,0DAAS,kCAAA;IACP,WAAQ,mBAAM;IACd,IAAI,WAAI;AACN,YAAO,iDAAE,oBAAA;MACP,IAAI,OAAI;AACN,cAAO,OAAC,OAAQ,YAAO,EAAA,CAAA;;MAEzB,WAAW,YAAY,wDAA0B,kDAAQ,UAAiB;OACxE,OAAO;OACP,IAAI,WAAW;AACb,+DAAqB,qBAAA;SACnB,IAAI,OAAI;AACN,iBAAO,QAAE,IAAA;;SAEX,IAAI,WAAO;AACT,iEAAG,kCAAA;WACD,IAAA,YAAgB;AACd,mBAAO,mBAAE,GAAA,QAAW,OAAA,kBAAA,YAAA,wEAAA,QAAA,QAAA,OAAA,kBAAA,WAAA,OAAA,WAAA,KAAA,aAAA,CAAA,WAAA,KAAA,GAAA,CAAA,WAAA,KAAA,GAAA,CAAA,GAAA,WAAA,SAAA,WAAA,MAAA,SAAA,IAAA,OAAA,WAAA,MAAA,KAAA,UAAA,GAAA,QAAA,OAAA,kBAAA,YAAA,wEAAA,QAAA,QAAA,OAAA,kBAAA,QAAA,MAAA,aAAA,CAAA,WAAA,KAAA,GAAA,CAAA,WAAA,KAAA,GAAA,CAAA,GAAA,CAAA,KAAA,OAAA,KAAA;;WAEtB,IAAI,WAAW;AACb,mEAAyB,qBAAC;aACxB,IAAI,OAAI;AACN,qBAAO,QAAG,MAAA;;aAEZ,IAAI,WAAW;AACb,qEAAyB,oBAAM,EAAA,CAAA;;aAEjC,UAAQ;aACT,CAAC;;WAEL,CAAC;;SAEJ,IAAG,WAAA;AACD,iEAAsB,mCAAA;WACpB,IAAA,YAAW;AACV,mBAAK,mBAAA,GAAA,QAAA,OAAA,kBAAA,YAAA,wEAAA,QAAA,QAAA,OAAA,kBAAA,WAAA,OAAA,WAAA,KAAA,aAAA,CAAA,WAAA,KAAA,GAAA,CAAA,WAAA,KAAA,GAAA,CAAA,GAAA,WAAA,SAAA,WAAA,MAAA,SAAA,IAAA,OAAA,WAAA,MAAA,KAAA,UAAA,GAAA,QAAA,OAAA,kBAAA,YAAA,wEAAA,QAAA,QAAA,OAAA,kBAAA,QAAA,MAAA,aAAA,CAAA,WAAA,KAAA,GAAA,CAAA,WAAA,KAAA,GAAA,CAAA,GAAA,CAAA,KAAA,OAAA,KAAA;;WAER,IAAA,WAAW;AACd,mEAAA,qBAAA;aACA,IAAA,OAAA;AACW,qBAAO,QAAA,MAAA;;aAEV,IAAA,WAAO;AACP,qEAAsB,oBAAoB,EAAA,CAAA;;aAE/C,UAAe;aACX,CAAA;;WAEH,CAAC;;SAEL,CAAC;;OAEL,CAAC;MACH,CAAC,kDAAmB,mCAAW;MAC9B,WAAW,mBAAI;MACf,IAAI,WAAW;AACb,cAAO,mBAAI,iDAAiD,OAAK,OAAQ,YAAa,EAAC,CAAA,CAAA,KAAA,QAAc,IAAI,IAAE,KAAA,IAAW,IAAI,SAAS,EAAE,EAAE,KAAA,UAAA,MAAA,MAAA,GAAA,CAAA,KAAA,GAAA,GAAA,CAAA,KAAA,KAAA,CAAA;;;MAG1I,CAAC,CAAC;;IAEN,CAAC;;EAEL,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"exit-function-declaration.cjs","names":[],"sources":["../../src/components/exit-function-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error({ message: \\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`,\n                ...(options.exception && typeof options.exception === \"object\" ? { stack: (options.exception as { message: string; stack?: string }).stack } : {})\n              });\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context,\n                true\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n              context,\n              true\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;AA8BA,SAAc,0BAA4B;;AAExC,QAAA;kDAAA,2CAAA;GACC,UAAW;GACZ,MAAA;GACF,KAAO;GACL,IAAM,WAAU;;;MAEV,MAAC;MACJ,UAAA;MACE,MAAA;MACC,KAAA;MACD,CAAC;qDAAiB,OAAA,EAAA,CAAA;qDAAA,sCAAA;MACjB,MAAK;MACL,UAAC;MACD,MAAM;MACN,KAAE;MACH,CAAC;qDAAiB,OAAK,EAAA,CAAA;qDAAA,sCAAA;MACtB,MAAM;MACN,UAAC;MACD,MAAM;MACN,KAAC;MACF,CAAC;qDAAQ,OAAe,EAAA,CAAA;qDAAA,sCAAA;MACvB,MAAE;MACF,UAAQ;MACR,MAAM;MACN,KAAC;MACF,CAAC;qDAAM,OAAA,EAAA,CAAA;qDAAA,sCAAA;MACN,MAAC;MACD,UAAQ;MACR,MAAE;MACF,KAAE;MACH,CAAC;KAAC;;GAEN,CAAC;kDAAU,0DAAA,EAAA,CAAA;kDAAA,qCAAA;GACV,OAAK;GACL,MAAM;GACN,MAAM;GACN,aAAY,mBAAA;GACb,CAAC;kDAAe,qCAAmB;GAClC,SAAK;GACL,MAAK;GACL,MAAK;GACL,aAAY,mBAAA;GACb,CAAC;kDAAM,qCAAA;GACN,SAAM;GACN,MAAM;GACN,MAAK;GACL,aAAI,mBAAA;GACL,CAAC;kDAAY,0DAAA,EAAA,CAAA;kDAAA,0CAAA;GACZ,UAAG;GACH,OAAI;GACJ,MAAI;GACJ,YAAU,CAAA;IACR,MAAE;IACF,MAAC;IACD,SAAC;IACF,CAAC;GACF,IAAI,WAAM;AACR,WAAO;gDAAc,mBAAC;;;;;;;;;;;;;;;;4JAgBD,QAAA,CAAA;;;;;qDAKd;qDAAA,kCAAA;MACL,IAAE,YAAI;AACJ,8DAAiB,gDAAA,EAAA,CAAA;;MAEnB,UAAI,mBAAA;;;;8EAEgB,SAAA,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kMA2BkC,SAAA,KAAA,CAAA;;;;;;UAMpD;KAAC;;GAER,CAAC;EAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"virtual-command-entry.cjs","names":[],"sources":["../../src/components/virtual-command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { FunctionDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { TypescriptFileImports } from \"@powerlines/plugin-alloy/types/components\";\nimport type { EntryFileProps } from \"@powerlines/plugin-alloy/typescript/components/entry-file\";\nimport {\n  TSDoc,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocTitle\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { TypescriptFile } from \"@powerlines/plugin-alloy/typescript/components/typescript-file\";\nimport {\n  getAppBin,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\n\nexport interface VirtualCommandHandlerDeclarationProps {\n  command: CommandTree;\n  banner?: Children;\n  children?: Children;\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function VirtualCommandHandlerDeclaration(\n  props: VirtualCommandHandlerDeclarationProps\n) {\n  const { command, children, banner } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(context)} ${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `[${constantCase(getDynamicPathSegmentName(segment))}]`\n              : segment\n          )\n          .join(\" \")}) virtual command.`}>\n        <TSDocRemarks>{`${command.description.replace(/\\.+$/, \"\")}.`}</TSDocRemarks>\n        <hbr />\n        <TSDocTitle>{command.title}</TSDocTitle>\n        <TSDocParam name=\"args\">{`The command-line arguments passed to the command.`}</TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"handler\"\n        parameters={[{ name: \"args\", type: \"string[]\", default: \"useArgs()\" }]}>\n        <Spacing />\n        {children}\n        <Spacing />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <Spacing />\n        {code`return showHelp(); `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface VirtualCommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The virtual command entry point for the Shell Shock project.\n */\nexport function VirtualCommandEntry(props: VirtualCommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      context.entryPath,\n      command.segments\n        .filter(segment => !isDynamicPathSegment(segment))\n        .join(\"/\"),\n      \"index.ts\"\n    )\n  );\n\n  return (\n    <>\n      <TypescriptFile\n        {...rest}\n        path={filePath.value}\n        imports={defu(\n          imports ?? {},\n          Object.entries(command.children)\n            .filter(([, child]) => child.isVirtual)\n            .reduce((ret, [name, child]) => {\n              ret[`./${child.name}`] = [\n                { name: \"handler\", alias: `handle${pascalCase(name)}` }\n              ];\n\n              return ret;\n            }, {} as TypescriptFileImports)\n        )}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"isDevelopment\", \"isDebug\"],\n          console: [\"warn\", \"error\", \"writeLine\", \"textColors\"],\n          utils: [\"isMinimal\", \"isUnicodeSupported\", \"findSuggestions\"],\n          state: [\n            \"useGlobal\",\n            \"GlobalOptions\",\n            \"useGlobalOptions\",\n            \"withCommand\",\n            \"useArgs\",\n            \"hasFlag\"\n          ],\n          [joinPaths(\n            \"help\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showHelp\"],\n          [joinPaths(\n            \"banner\",\n            ...command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            )\n          )]: [\"showBanner\"]\n        })}>\n        <Spacing />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`await showBanner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,iCAAC,OAAsC;CACrD,MAAA,EACA,SACA,UACF;CAEE,MAAA,6EAAA;AACA,QAAG,iDAAe,4DAAe;EACjC,IAAA,UAAA;AACI,UAAC,OAAS,QAAA,MAAA,kDAAgC,QAAA,CAAA,GAAA,QAAA,SAAA,KAAA,qEAAA,QAAA,GAAA,wHAAA,QAAA,CAAA,CAAA,KAAA,QAAA,CAAA,KAAA,IAAA,CAAA;;EAE9C,IAAA,WAAA;AACA,UAAQ;oDAAmB,mEAAgB;AAErC,YAAS,GAAC,QAAA,YAAc,QAAA,QAAsB,GAAA,CAAA;OAEpD,CAAM;oDAAC,OAAA,EAAA,CAAA;oDAAA,iEAAA,EACJ,IAAA,WAAA;AACE,YAAA,QAAA;OAEA,CAAC;oDAAgB,iEAAA;KAChB,MAAI;KACJ,UAAU;KACX,CAAC;IAAC;;EAEN,CAAC,kDAAmB,0CAAkB;EACrC,UAAK;EACL,OAAK;EACL,MAAK;EACL,YAAK,CAAA;GACH,MAAE;GACF,MAAC;GACD,SAAE;GACH,CAAC;EACF,IAAI,WAAM;AACR,UAAE;oDAAsB,kDAAW,EAAE,CAAC;IAAA;oDAA8B,kDAAK,EAAA,CAAA;oDAAA,qBAAA;KACvE,IAAC,OAAS;AACT,aAAQ,QAAA,OAAA;;KAET,UAAU;KACX,CAAC;oDAAU,kDAAA,EAAA,CAAA;IAAA,mBAAA;IAAA;;EAEf,CAAC,CAAC;;;;;AASL,SAAW,oBAAW,OAAA;CACtB,MAAA,WAEE,SACC,gBACD,GAAA,SACI;CACJ,MAAM,6EAA8C;;AAEpD,QAAM,iDAAU,0HAAoC,MAAA;EACpD,IAAM,OAAA;AACJ,UAAS,SAAA;;EAET,IAAE,UAAQ;AACR,4BAAU,WAAY,EAAA,EAAA,OAAA,QAAoB,QAAQ,SAAC,CAAA,QAAA,GAAA,WAAA,MAAA,UAAA,CAAA,QAAA,KAAA,CAAA,MAAA,WAAA;AACjD,QAAC,KAAQ,MAAC,UAAA,CAAA;KACX,MAAQ;KACX,OAAA,2DAAA,KAAA;KACD,CAAA;;MAEM,EAAA,CAAA,CAAA;;EAEL,IAAG,iBAAA;AACD,4BAAU,kBAAA,EAAA,EAAA;IACR,KAAK,CAAC,iBAAc,UAAA;IACpB,SAAS;KAAA;KAAI;KAAA;KAAA;KAAA;IACb,OAAE;KAAA;KAAa;KAAA;KAAA;IACf,OAAE;KAAM;KAAS;KAAgB;KAAA;KAAA;KAAA;KAAA;sCACtB,QAAK,GAAM,QAAK,SAAM,QAAS,YAAA,0DAAA,QAAA,CAAA,CAAA,GAAA,CAAA,WAAA;sCAC/B,UAAQ,GAAK,QAAQ,SAAI,QAAA,YAAA,0DAAA,QAAA,CAAA,CAAA,GAAA,CAAA,aAAA;IACrC,CAAC;;EAEJ,IAAI,WAAO;;IAED;IACN,QAAQ,mBAAI;IACZ,IAAC,WAAA;AACD,4DAAqB,iDAAqB;MACxC,IAAM,WAAC;AACP,cAAW,QAAQ;;MAEnB,IAAM,WAAC;AACJ,cAAA,QAAU;;MAEZ,CAAC;;IAEL,CAAC,CAAC;;EAEN,CAAC,CAAC,kDAAM,oBAAA;EACP,IAAI,OAAG;AACL,UAAO,OAAK,OAAA,QAAA,SAAA;;EAEd,WAAU,0DAAY,qBAAqB;GACzC,IAAI,OAAE;AACJ,WAAO,MAAC;;GAEV,IAAI,WAAU;AACZ,2DAAwB,+CAAM,EAC5B,SAAI,OACL,CAAC;;GAEJ,IAAI,WAAC;AACH,2DAAU,qBAAA,EACT,SAAA,OACA,CAAC;;GAEL,CAAC;EACH,CAAC,CAAC"}

package/dist/helpers/get-global-options.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-global-options.cjs","names":["CommandParameterKinds"],"sources":["../../src/helpers/get-global-options.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandOption } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\n\n/**\n * Get the default command options.\n *\n * @returns The default command options.\n */\nexport function getGlobalOptions(): CommandOption[] {\n  return [\n    {\n      name: \"help\",\n      title: \"Help\",\n      description: \"Show help information.\",\n      env: false,\n      alias: [\"h\", \"?\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"version\",\n      title: \"Version\",\n      description: \"Show the version of the application.\",\n      env: false,\n      alias: [\"v\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"verbose\",\n      title: \"Verbose\",\n      description: \"Enable verbose output.\",\n      env: \"VERBOSE\",\n      alias: [\"V\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      default: false,\n      variadic: false,\n      skipAddingNegative: true\n    },\n    {\n      name: \"color\",\n      title: \"Color\",\n      description: \"Enable colored terminal output.\",\n      env: \"COLOR\",\n      alias: [\"colors\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      variadic: false,\n      skipAddingNegative: false\n    },\n    {\n      name: \"no-banner\",\n      title: \"Hide Banner\",\n      description:\n        \"Do not display the application banner displayed while running the CLI - will be set to true if running in a CI pipeline.\",\n      env: \"NO_BANNER\",\n      alias: [\"hide-banner\"],\n      kind: CommandParameterKinds.boolean,\n      optional: true,\n      variadic: false,\n      default: false\n    }\n  ];\n}\n"],"mappings":";;;;;;;;;;AA0BA,SAAgB,mBAAoC;AAClD,QAAO;EACL;GACE,MAAM;GACN,OAAO;GACP,aAAa;GACb,KAAK;GACL,OAAO,CAAC,KAAK,IAAI;GACjB,MAAMA,wCAAsB;GAC5B,UAAU;GACV,SAAS;GACT,UAAU;GACV,oBAAoB;GACrB;EACD;GACE,MAAM;GACN,OAAO;GACP,aAAa;GACb,KAAK;GACL,OAAO,CAAC,IAAI;GACZ,MAAMA,wCAAsB;GAC5B,UAAU;GACV,SAAS;GACT,UAAU;GACV,oBAAoB;GACrB;EACD;GACE,MAAM;GACN,OAAO;GACP,aAAa;GACb,KAAK;GACL,OAAO,CAAC,IAAI;GACZ,MAAMA,wCAAsB;GAC5B,UAAU;GACV,SAAS;GACT,UAAU;GACV,oBAAoB;GACrB;EACD;GACE,MAAM;GACN,OAAO;GACP,aAAa;GACb,KAAK;GACL,OAAO,CAAC,SAAS;GACjB,MAAMA,wCAAsB;GAC5B,UAAU;GACV,UAAU;GACV,oBAAoB;GACrB;EACD;GACE,MAAM;GACN,OAAO;GACP,aACE;GACF,KAAK;GACL,OAAO,CAAC,cAAc;GACtB,MAAMA,wCAAsB;GAC5B,UAAU;GACV,UAAU;GACV,SAAS;GACV;EACF"}

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport banner from \"@shell-shock/plugin-banner\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport type { Plugin } from \"powerlines\";\nimport { BinEntry } from \"./components/bin-entry\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getGlobalOptions } from \"./helpers/get-global-options\";\nimport type { ScriptPresetContext, ScriptPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock base plugin.\n */\nexport const plugin = <\n  TContext extends ScriptPresetContext = ScriptPresetContext\n>(\n  options: ScriptPresetOptions = {}\n) => {\n  return [\n    ...console<TContext>(options),\n    ...help<TContext>(options),\n    ...banner<TContext>(options.banner),\n    {\n      name: \"shell-shock:script-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `script` preset.\"\n        );\n\n        return {\n          globalOptions: getGlobalOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      }\n    },\n    {\n      name: \"shell-shock:script-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"help\"\n                  ],\n                  utils: [\"isMinimal\"],\n                  state: [\"useArgs\", \"hasFlag\", \"isHelp\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    const\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <Spacing />\n                {code`await showBanner();`}\n                <Spacing />\n                {code`return showHelp();`}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAW,UAA8B,UAAA,EAAA,KAAA;AACxC,QAAA;EAAA,4CAAA,QAAA;EAAA,yCAAA,QAAA;EAAA,2CAAA,QAAA,OAAA;EAAA;GACC,MAAQ;GACN,SAAC;AACH,SAAO,MAAA,uEAAA;AACH,WAAC;KACA,eAAe;KACf,iBAAiB;KACpB,GAAA;KACE;;GAEH;EAAE;GACD,MAAM;GACN,SAAK;;IAEH,MAAE,UAAO;KACP,MAAE,SAAa;AACf,UAAE,MAAA,oEAAsB;AACxB,wDAAK,MAAA,iDAAA,uCAAA;MACJ,gBAAA;OACH,SAAA;QAAA;QAAA;QAAA;QAAA;QAAA;QAAA;OACD,OAAA,CAAA,YAAA;OACD,OAAA;QAAA;QAAA;QAAA;QAAA;OACO;MACL,IAAQ,WAAC;AACP,cAAQ;wDAAK,qBAAA;SACP,IAAA,OAAU;AACT,iBAAK,OAAA,KAAA,OAAA,SAAA,CAAA,SAAA;;SAET,IAAA,WAAA;;;YAEM,SAAM;YACP,MAAA;YACH,MAAA;YACE,aAAA,mBAAA;YACC,CAAA;2DAAgB,OAAA,EAAA,CAAA;2DAAA,iDAAA;YACd,UAAS,EAAA;YACT,IAAG,WAAQ;AACT,oBAAC,OAAU,YAAA,EAAA;;YAEd,CAAC;2DAAa,OAAA,EAAA,CAAA;WAAA;;SAElB,CAAC;wDAAK,kDAAA,EAAA,CAAA;QAAA,mBAAA;wDAAA,kDAAA,EAAA,CAAA;QAAA,mBAAA;QAAA;;MAEV,CAAC,kDAAiB,qBAAS;MAC1B,IAAI,OAAI;AACN,cAAK,OAAS,OAAE,OAAY,SAAK,CAAA,SAAU;;MAE7C,IAAI,WAAM;AACR,8DAAkB,oBAAA;QAChB,IAAI,OAAO;AACT,gBAAI,OAAA,OAAiB,OAAC,SAAW;;QAEnC,gBAAU;QACV,WAAK,0DAA4B,qBAAU;SACzC,IAAG,OAAK;AACN,iBAAI,MAAA;;SAEN,IAAC,WAAW;AACX,iEAAS,+CAAA,EACT,SAAY,OACb,CAAA;;SAEA,IAAI,WAAO;AACT,iEAAU,8DAAA,EACR,SAAC,OACF,CAAC;;SAEL,CAAC;QACH,CAAC;;MAEL,CAAC,CAAC,CAAC;;IAEP;GACF;EAAC"}