@shell-shock/preset-script 0.6.11 → 0.6.13

package/dist/components/bin-entry.cjs

@@ -129,6 +129,11 @@ function BinEntry(props) {
 			},
 			get builtinImports() {
 				return (0, defu.default)(builtinImports ?? {}, {
+					env: [
+						"env",
+						"isDevelopment",
+						"isDebug"
+					],
 					console: [
 						"error",
 						"verbose",

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.cjs","names":["code","computed","For","Show","FunctionDeclaration","IfStatement","Spacing","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","ExitFunctionDeclaration","RunApplication","_$createComponent","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","each","value","_$mergeProps","path","typeDefinition","file","output","didyoumean2","name","default","entries","commands","filter","command","isVirtual","reduce","ret","alias","console","utils","when","Boolean","heading","async","returnType","condition","packageJson","version","fallback"],"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 { TSDoc } from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\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            skipExit: 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 internal_appContext.run(new Map([[\"args\", getArgs()]]), 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            {\n              didyoumean2: [\n                { name: \"didYouMean\", default: true },\n                { name: \"ReturnTypeEnums\" },\n                { name: \"ThresholdTypeEnums\" }\n              ]\n            },\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            console: [\"error\", \"verbose\", \"table\", \"writeLine\"],\n            utils: [\n              \"hasFlag\",\n              \"isUnicodeSupported\",\n              \"internal_appContext\",\n              \"getArgs\"\n            ]\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            )} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" 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":";;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgBiB,iBAAiB;AAC/B,QAAA;mDAEKX,2DAAO,EAAA,CAAA;EACPN,oBAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDAkEJ,OAAA,EAAA,CAAA;EAAA;;;;;AAkBP,SAAgBoB,SAASC,OAAsB;CAC7C,MAAM,EAAEC,QAAQC,SAASC,gBAAgBC,SAASC,UAAU,GAAGC,SAASN;CAExE,MAAMO,8EAA8C;CACpD,MAAMC,sFAAgCC,OAAOC,OAAOH,QAAQI,OAAOC,IAAI,CAAC,CAAC;AAEzE,yDACG/B,qBAAG;EAAA,IAACgC,OAAI;AAAA,UAAEL,KAAKM;;EAAKT,WAClBO,yDACEzB,kHACKmB,MAAI;GAAA,IACRU,OAAI;AAAA,qGAAgCJ,IAAI,CAAC;;GACzCK,gBAAgB;IACdC,MAAMN;IACNO,QAAQ;IACT;GAAA,IACDf,UAAO;AAAA,6BACL,EACEgB,aAAa;KACX;MAAEC,MAAM;MAAcC,SAAS;MAAM;KACrC,EAAED,MAAM,mBAAmB;KAC3B,EAAEA,MAAM,sBAAsB;KAAA,EAEjC,EACDjB,WAAW,EAAE,EACbK,OAAOc,QAAQhB,QAAQiB,SAAS,CAC7BC,QAAQ,GAAGC,aAAaA,QAAQC,UAAU,CAC1CC,QAAQC,KAAK,CAACR,MAAMK,aAAa;AAChCG,SAAI,KAAKH,QAAQL,UAAU,CACzB;MAAEA,MAAM;MAAWS,OAAO,4DAAoBT,KAAK;MAAI,CACxD;AAED,YAAOQ;OACN,EAA2B,CAClC,CAAC;;GAAA,IACD1B,iBAAc;AAAA,6BAAOA,kBAAkB,EAAE,EAAE;KACzC4B,SAAS;MAAC;MAAS;MAAW;MAAS;MAAY;KACnDC,OAAO;MACL;MACA;MACA;MACA;MAAS;KAEZ,CAAC;;GAAA,IAAA3B,WAAA;AAAA,WAAA;sDACDV,sEAAuB,EAAA,CAAA;sDACvBV,2DAAO,EAAA,CAAA;sDACPH,sBAAI;MAAA,IAACmD,OAAI;AAAA,cAAEC,QAAQjC,OAAO;;MAAA,IAAAI,WAAA;AAAA,cAAA,CACxBJ,yDACAhB,2DAAO,EAAA,CAAA,CAAA;;MAAA,CAAA;sDAETG,6DAAK,EAAA,IACJ+C,UAAO;AAAA,aAAE,+FACP5B,QACD,CAAA;QAAmB,CAAA;sDACrBxB,2CAAmB;MAACqD,OAAK;MAACC,YAAU;MAAOhB,MAAI;MAAA,IAAAhB,WAAA;AAAA,cAAA;yDAC7CrB,mCAAW;SAACsD,WAAW3D,oBAAI;SAA2B,IAAA0B,WAAA;AAAA,iBACpD1B,oBAAI,eACH4B,SAASgC,YAAYC,UACjB,IAAIjC,SAASgC,YAAYC,QAAO,KAChC,QAAO;;;SAET,CAAA;yDAELvD,2DAAO,EAAA,CAAA;QACPoB;yDAAQ,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAMVvB,sBAAI;MAAA,IAACmD,OAAI;AAAA,cAAEC,QAAQhC,QAAQ;;MAAA,IAAEuC,WAAQ;AAAA,+DAAG7C,gBAAc,EAAA,CAAA;;MAAAS,UACpDH;MAAO,CAAA;sDAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA,CAAA;EAIb,CAAA"}
+{"version":3,"file":"bin-entry.cjs","names":["code","computed","For","Show","FunctionDeclaration","IfStatement","Spacing","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","ExitFunctionDeclaration","RunApplication","_$createComponent","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","each","value","_$mergeProps","path","typeDefinition","file","output","didyoumean2","name","default","entries","commands","filter","command","isVirtual","reduce","ret","alias","env","console","utils","when","Boolean","heading","async","returnType","condition","packageJson","version","fallback"],"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 { TSDoc } from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\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            skipExit: 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 internal_appContext.run(new Map([[\"args\", getArgs()]]), 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            {\n              didyoumean2: [\n                { name: \"didYouMean\", default: true },\n                { name: \"ReturnTypeEnums\" },\n                { name: \"ThresholdTypeEnums\" }\n              ]\n            },\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: [\"error\", \"verbose\", \"table\", \"writeLine\"],\n            utils: [\n              \"hasFlag\",\n              \"isUnicodeSupported\",\n              \"internal_appContext\",\n              \"getArgs\"\n            ]\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            )} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" 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":";;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgBiB,iBAAiB;AAC/B,QAAA;mDAEKX,2DAAO,EAAA,CAAA;EACPN,oBAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDAkEJ,OAAA,EAAA,CAAA;EAAA;;;;;AAkBP,SAAgBoB,SAASC,OAAsB;CAC7C,MAAM,EAAEC,QAAQC,SAASC,gBAAgBC,SAASC,UAAU,GAAGC,SAASN;CAExE,MAAMO,8EAA8C;CACpD,MAAMC,sFAAgCC,OAAOC,OAAOH,QAAQI,OAAOC,IAAI,CAAC,CAAC;AAEzE,yDACG/B,qBAAG;EAAA,IAACgC,OAAI;AAAA,UAAEL,KAAKM;;EAAKT,WAClBO,yDACEzB,kHACKmB,MAAI;GAAA,IACRU,OAAI;AAAA,qGAAgCJ,IAAI,CAAC;;GACzCK,gBAAgB;IACdC,MAAMN;IACNO,QAAQ;IACT;GAAA,IACDf,UAAO;AAAA,6BACL,EACEgB,aAAa;KACX;MAAEC,MAAM;MAAcC,SAAS;MAAM;KACrC,EAAED,MAAM,mBAAmB;KAC3B,EAAEA,MAAM,sBAAsB;KAAA,EAEjC,EACDjB,WAAW,EAAE,EACbK,OAAOc,QAAQhB,QAAQiB,SAAS,CAC7BC,QAAQ,GAAGC,aAAaA,QAAQC,UAAU,CAC1CC,QAAQC,KAAK,CAACR,MAAMK,aAAa;AAChCG,SAAI,KAAKH,QAAQL,UAAU,CACzB;MAAEA,MAAM;MAAWS,OAAO,4DAAoBT,KAAK;MAAI,CACxD;AAED,YAAOQ;OACN,EAA2B,CAClC,CAAC;;GAAA,IACD1B,iBAAc;AAAA,6BAAOA,kBAAkB,EAAE,EAAE;KACzC4B,KAAK;MAAC;MAAO;MAAiB;MAAU;KACxCC,SAAS;MAAC;MAAS;MAAW;MAAS;MAAY;KACnDC,OAAO;MACL;MACA;MACA;MACA;MAAS;KAEZ,CAAC;;GAAA,IAAA5B,WAAA;AAAA,WAAA;sDACDV,sEAAuB,EAAA,CAAA;sDACvBV,2DAAO,EAAA,CAAA;sDACPH,sBAAI;MAAA,IAACoD,OAAI;AAAA,cAAEC,QAAQlC,OAAO;;MAAA,IAAAI,WAAA;AAAA,cAAA,CACxBJ,yDACAhB,2DAAO,EAAA,CAAA,CAAA;;MAAA,CAAA;sDAETG,6DAAK,EAAA,IACJgD,UAAO;AAAA,aAAE,+FACP7B,QACD,CAAA;QAAmB,CAAA;sDACrBxB,2CAAmB;MAACsD,OAAK;MAACC,YAAU;MAAOjB,MAAI;MAAA,IAAAhB,WAAA;AAAA,cAAA;yDAC7CrB,mCAAW;SAACuD,WAAW5D,oBAAI;SAA2B,IAAA0B,WAAA;AAAA,iBACpD1B,oBAAI,eACH4B,SAASiC,YAAYC,UACjB,IAAIlC,SAASiC,YAAYC,QAAO,KAChC,QAAO;;;SAET,CAAA;yDAELxD,2DAAO,EAAA,CAAA;QACPoB;yDAAQ,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAMVvB,sBAAI;MAAA,IAACoD,OAAI;AAAA,cAAEC,QAAQjC,QAAQ;;MAAA,IAAEwC,WAAQ;AAAA,+DAAG9C,gBAAc,EAAA,CAAA;;MAAAS,UACpDH;MAAO,CAAA;sDAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA,CAAA;EAIb,CAAA"}

package/dist/components/bin-entry.mjs

@@ -127,6 +127,11 @@ function BinEntry(props) {
 			},
 			get builtinImports() {
 				return defu(builtinImports ?? {}, {
+					env: [
+						"env",
+						"isDevelopment",
+						"isDebug"
+					],
 					console: [
 						"error",
 						"verbose",

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.mjs","names":["code","computed","For","Show","FunctionDeclaration","IfStatement","Spacing","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","ExitFunctionDeclaration","RunApplication","_$createComponent","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","each","value","_$mergeProps","path","typeDefinition","file","output","didyoumean2","name","default","entries","commands","filter","command","isVirtual","reduce","ret","alias","console","utils","when","Boolean","heading","async","returnType","condition","packageJson","version","fallback"],"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 { TSDoc } from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\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            skipExit: 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 internal_appContext.run(new Map([[\"args\", getArgs()]]), 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            {\n              didyoumean2: [\n                { name: \"didYouMean\", default: true },\n                { name: \"ReturnTypeEnums\" },\n                { name: \"ThresholdTypeEnums\" }\n              ]\n            },\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            console: [\"error\", \"verbose\", \"table\", \"writeLine\"],\n            utils: [\n              \"hasFlag\",\n              \"isUnicodeSupported\",\n              \"internal_appContext\",\n              \"getArgs\"\n            ]\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            )} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" 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":";;;;;;;;;;;;;;;;;;;AAuCA,SAAgBiB,iBAAiB;AAC/B,QAAA;EAAAC,gBAEKZ,SAAO,EAAA,CAAA;EACPN,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkEJmB,gBAAA,OAAA,EAAA,CAAA;EAAA;;;;;AAkBP,SAAgBC,SAASC,OAAsB;CAC7C,MAAM,EAAEC,QAAQC,SAASC,gBAAgBC,SAASC,UAAU,GAAGC,SAASN;CAExE,MAAMO,UAAUrB,eAAoC;CACpD,MAAMsB,OAAO5B,eAAeU,UAAUmB,OAAOC,OAAOH,QAAQI,OAAOC,IAAI,CAAC,CAAC;AAEzE,QAAAf,gBACGhB,KAAG;EAAA,IAACgC,OAAI;AAAA,UAAEL,KAAKM;;EAAKT,WAClBO,QAAGf,gBACDV,WAAS4B,WACJT,MAAI;GAAA,IACRU,OAAI;AAAA,WAAEzB,aAAaC,iBAAiBoB,IAAI,CAAC;;GACzCK,gBAAgB;IACdC,MAAMN;IACNO,QAAQ;IACT;GAAA,IACDf,UAAO;AAAA,WAAEV,KACP,EACE0B,aAAa;KACX;MAAEC,MAAM;MAAcC,SAAS;MAAM;KACrC,EAAED,MAAM,mBAAmB;KAC3B,EAAEA,MAAM,sBAAsB;KAAA,EAEjC,EACDjB,WAAW,EAAE,EACbK,OAAOc,QAAQhB,QAAQiB,SAAS,CAC7BC,QAAQ,GAAGC,aAAaA,QAAQC,UAAU,CAC1CC,QAAQC,KAAK,CAACR,MAAMK,aAAa;AAChCG,SAAI,KAAKH,QAAQL,UAAU,CACzB;MAAEA,MAAM;MAAWS,OAAO,SAASrC,WAAW4B,KAAK;MAAI,CACxD;AAED,YAAOQ;OACN,EAA2B,CAClC,CAAC;;GAAA,IACD1B,iBAAc;AAAA,WAAET,KAAKS,kBAAkB,EAAE,EAAE;KACzC4B,SAAS;MAAC;MAAS;MAAW;MAAS;MAAY;KACnDC,OAAO;MACL;MACA;MACA;MACA;MAAS;KAEZ,CAAC;;GAAA,IAAA3B,WAAA;AAAA,WAAA;KAAAR,gBACDF,yBAAuB,EAAA,CAAA;KAAAE,gBACvBZ,SAAO,EAAA,CAAA;KAAAY,gBACPf,MAAI;MAAA,IAACmD,OAAI;AAAA,cAAEC,QAAQjC,OAAO;;MAAA,IAAAI,WAAA;AAAA,cAAA,CACxBJ,QAAMJ,gBACNZ,SAAO,EAAA,CAAA,CAAA;;MAAA,CAAA;KAAAY,gBAETT,OAAK,EAAA,IACJ+C,UAAO;AAAA,aAAE,8BAA8B9C,YACrCkB,QACD,CAAA;QAAmB,CAAA;KAAAV,gBACrBd,qBAAmB;MAACqD,OAAK;MAACC,YAAU;MAAOhB,MAAI;MAAA,IAAAhB,WAAA;AAAA,cAAA;QAAAR,gBAC7Cb,aAAW;SAACsD,WAAW3D,IAAI;SAA2B,IAAA0B,WAAA;AAAA,iBACpD1B,IAAI,eACH4B,SAASgC,YAAYC,UACjB,IAAIjC,SAASgC,YAAYC,QAAO,KAChC,QAAO;;;SAET,CAAA;QAAA3C,gBAELZ,SAAO,EAAA,CAAA;QACPoB;QAAQP,gBAAA,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAD,gBAMVf,MAAI;MAAA,IAACmD,OAAI;AAAA,cAAEC,QAAQhC,QAAQ;;MAAA,IAAEuC,WAAQ;AAAA,cAAA5C,gBAAGD,gBAAc,EAAA,CAAA;;MAAAS,UACpDH;MAAO,CAAA;KAAAJ,gBAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA,CAAA;EAIb,CAAA"}
+{"version":3,"file":"bin-entry.mjs","names":["code","computed","For","Show","FunctionDeclaration","IfStatement","Spacing","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","ExitFunctionDeclaration","RunApplication","_$createComponent","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","each","value","_$mergeProps","path","typeDefinition","file","output","didyoumean2","name","default","entries","commands","filter","command","isVirtual","reduce","ret","alias","env","console","utils","when","Boolean","heading","async","returnType","condition","packageJson","version","fallback"],"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 { TSDoc } from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\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            skipExit: 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 internal_appContext.run(new Map([[\"args\", getArgs()]]), 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            {\n              didyoumean2: [\n                { name: \"didYouMean\", default: true },\n                { name: \"ReturnTypeEnums\" },\n                { name: \"ThresholdTypeEnums\" }\n              ]\n            },\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: [\"error\", \"verbose\", \"table\", \"writeLine\"],\n            utils: [\n              \"hasFlag\",\n              \"isUnicodeSupported\",\n              \"internal_appContext\",\n              \"getArgs\"\n            ]\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            )} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" 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":"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"}

package/dist/components/command-entry.cjs

@@ -1,6 +1,5 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_components_banner_function_declaration = require('./banner-function-declaration.cjs');
-const require_components_helpers = require('./helpers.cjs');
 const require_components_help = require('./help.cjs');
 const require_components_virtual_command_entry = require('./virtual-command-entry.cjs');
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
@@ -15,6 +14,7 @@ let __stryke_path_replace = require("@stryke/path/replace");
 let __stryke_string_format_pascal_case = require("@stryke/string-format/pascal-case");
 let defu = require("defu");
 defu = require_rolldown_runtime.__toESM(defu);
+let __shell_shock_core_components_helpers = require("@shell-shock/core/components/helpers");
 let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let __shell_shock_core_components_options_parser_logic = require("@shell-shock/core/components/options-parser-logic");
 let __stryke_path_find = require("@stryke/path/find");
@@ -105,7 +105,7 @@ function CommandHandlerDeclaration(props) {
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
 						get condition() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_helpers.IsDebug, {});
+							return (0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_helpers.IsDebug, {});
 						},
 						get children() {
 							return __alloy_js_core.code`writeLine("");

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","ReflectionKind","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","IsDebug","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","arguments","length","argument","_$createIntrinsic","CommandHandlerDeclaration","banner","children","context","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","when","Boolean","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","optional","includes","kind","string","number","variadic","fallback","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","child","isVirtual"],"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  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport 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 {\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/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\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 { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { IsDebug } from \"./helpers\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration\n        name=\"__context\"\n        initializer={code`{ path: \\`${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n              : segment\n          )\n          .join(\"/\")}\\`, segments: [${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? camelCase(getDynamicPathSegmentName(segment))\n              : `\"${segment}\"`\n          )\n          .join(\", \")}] }`}\n      />\n      <Spacing />\n      {code`\n\n      return internal_commandContext.run(__context, () => {\n        return Promise.resolve(Reflect.apply(handle${pascalCase(\n          command.name\n        )}, __context, [options${\n          command.arguments.length > 0\n            ? `, ${command.arguments\n                .map(argument => camelCase(argument.name))\n                .join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\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          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\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.arguments.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.arguments\n                  .map(\n                    argument =>\n                      ` - ${kebabCase(argument.name)}: \\${${camelCase(\n                        argument.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        argument.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === ReflectionKind.string ||\n                    option.kind === ReflectionKind.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              <Show\n                when={(option as NumberCommandOption).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.arguments} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === ReflectionKind.string ||\n                    argument.kind === ReflectionKind.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === ReflectionKind.number}>\n              <Show\n                when={(argument as NumberCommandArgument).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\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 command-line process can be executed: \\\\n\\\\n\" + failures.map(failure => \" - \" + failure).join(\"\\\\n\"));\n        options.help = true; `}\n      </IfStatement>\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]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} banner={code`banner(); `}>\n          <CommandValidationLogic command={command} />\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","ReflectionKind","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","IsDebug","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","arguments","length","argument","_$createIntrinsic","CommandHandlerDeclaration","banner","children","context","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","when","Boolean","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","optional","includes","kind","string","number","variadic","fallback","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","child","isVirtual"],"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  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport 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 { 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/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\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 { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration\n        name=\"__context\"\n        initializer={code`{ path: \\`${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n              : segment\n          )\n          .join(\"/\")}\\`, segments: [${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? camelCase(getDynamicPathSegmentName(segment))\n              : `\"${segment}\"`\n          )\n          .join(\", \")}] }`}\n      />\n      <Spacing />\n      {code`\n\n      return internal_commandContext.run(__context, () => {\n        return Promise.resolve(Reflect.apply(handle${pascalCase(\n          command.name\n        )}, __context, [options${\n          command.arguments.length > 0\n            ? `, ${command.arguments\n                .map(argument => camelCase(argument.name))\n                .join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\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          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\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.arguments.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.arguments\n                  .map(\n                    argument =>\n                      ` - ${kebabCase(argument.name)}: \\${${camelCase(\n                        argument.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        argument.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === ReflectionKind.string ||\n                    option.kind === ReflectionKind.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              <Show\n                when={(option as NumberCommandOption).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.arguments} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === ReflectionKind.string ||\n                    argument.kind === ReflectionKind.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === ReflectionKind.number}>\n              <Show\n                when={(argument as NumberCommandArgument).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\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 command-line process can be executed: \\\\n\\\\n\" + failures.map(failure => \" - \" + failure).join(\"\\\\n\"));\n        options.help = true; `}\n      </IfStatement>\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]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} banner={code`banner(); `}>\n          <CommandValidationLogic command={command} />\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/command-entry.mjs

@@ -1,5 +1,4 @@
 import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
-import { IsDebug } from "./helpers.mjs";
 import { CommandHelp } from "./help.mjs";
 import { VirtualCommandEntry } from "./virtual-command-entry.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
@@ -13,6 +12,7 @@ import { TSDoc, TSDocParam, TSDocRemarks, TSDocTitle } from "@powerlines/plugin-
 import { replaceExtension } from "@stryke/path/replace";
 import { pascalCase } from "@stryke/string-format/pascal-case";
 import defu from "defu";
+import { IsDebug } from "@shell-shock/core/components/helpers";
 import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 import { CommandParserLogic, OptionsInterfaceDeclaration } from "@shell-shock/core/components/options-parser-logic";
 import { findFilePath, relativePath } from "@stryke/path/find";

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","ReflectionKind","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","IsDebug","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","arguments","length","argument","_$createIntrinsic","CommandHandlerDeclaration","banner","children","context","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","when","Boolean","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","optional","includes","kind","string","number","variadic","fallback","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","child","isVirtual"],"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  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport 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 {\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/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\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 { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { IsDebug } from \"./helpers\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration\n        name=\"__context\"\n        initializer={code`{ path: \\`${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n              : segment\n          )\n          .join(\"/\")}\\`, segments: [${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? camelCase(getDynamicPathSegmentName(segment))\n              : `\"${segment}\"`\n          )\n          .join(\", \")}] }`}\n      />\n      <Spacing />\n      {code`\n\n      return internal_commandContext.run(__context, () => {\n        return Promise.resolve(Reflect.apply(handle${pascalCase(\n          command.name\n        )}, __context, [options${\n          command.arguments.length > 0\n            ? `, ${command.arguments\n                .map(argument => camelCase(argument.name))\n                .join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\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          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\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.arguments.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.arguments\n                  .map(\n                    argument =>\n                      ` - ${kebabCase(argument.name)}: \\${${camelCase(\n                        argument.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        argument.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === ReflectionKind.string ||\n                    option.kind === ReflectionKind.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              <Show\n                when={(option as NumberCommandOption).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.arguments} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === ReflectionKind.string ||\n                    argument.kind === ReflectionKind.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === ReflectionKind.number}>\n              <Show\n                when={(argument as NumberCommandArgument).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\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 command-line process can be executed: \\\\n\\\\n\" + failures.map(failure => \" - \" + failure).join(\"\\\\n\"));\n        options.help = true; `}\n      </IfStatement>\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]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} banner={code`banner(); `}>\n          <CommandValidationLogic command={command} />\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":["code","computed","For","Show","ElseClause","ElseIfClause","FunctionDeclaration","IfStatement","VarDeclaration","ReflectionKind","Spacing","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","IsDebug","CommandParserLogic","OptionsInterfaceDeclaration","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","kebabCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$createComponent","name","initializer","segments","map","segment","join","_$memo","arguments","length","argument","_$createIntrinsic","CommandHandlerDeclaration","banner","children","context","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","when","Boolean","condition","Object","values","options","option","CommandValidationLogic","each","doubleHardline","optional","includes","kind","string","number","variadic","fallback","CommandEntry","imports","builtinImports","rest","filePath","filter","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","path","env","console","utils","child","isVirtual"],"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  ElseIfClause,\n  FunctionDeclaration,\n  IfStatement,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport 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 { 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/context-helpers\";\nimport type {\n  CommandTree,\n  NumberCommandArgument,\n  NumberCommandOption\n} from \"@shell-shock/core/types/command\";\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 { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandHelp } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration\n        name=\"__context\"\n        initializer={code`{ path: \\`${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? `\\${${camelCase(getDynamicPathSegmentName(segment))}}`\n              : segment\n          )\n          .join(\"/\")}\\`, segments: [${command.segments\n          .map(segment =>\n            isDynamicPathSegment(segment)\n              ? camelCase(getDynamicPathSegmentName(segment))\n              : `\"${segment}\"`\n          )\n          .join(\", \")}] }`}\n      />\n      <Spacing />\n      {code`\n\n      return internal_commandContext.run(__context, () => {\n        return Promise.resolve(Reflect.apply(handle${pascalCase(\n          command.name\n        )}, __context, [options${\n          command.arguments.length > 0\n            ? `, ${command.arguments\n                .map(argument => camelCase(argument.name))\n                .join(\", \")}`\n            : \"\"\n        }]));\n      });\n\n      `}\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          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <IfStatement condition={<IsDebug />}>\n          {code`writeLine(\"\");\n          writeLine(colors.text.body.tertiary(\"Debug mode is enabled. Additional debug information may be logged to the console.\"));\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.arguments.length > 0\n              ? ` \\\\n\\\\nArguments: \\\\n${command.arguments\n                  .map(\n                    argument =>\n                      ` - ${kebabCase(argument.name)}: \\${${camelCase(\n                        argument.name\n                      )} === undefined ? \"\" : JSON.stringify(${camelCase(\n                        argument.name\n                      )})}`\n                  )\n                  .join(\"\\\\n\")}`\n              : \"\"\n          }\\`);\n          writeLine(\"\"); `}\n        </IfStatement>\n        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          <CommandHelp command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandValidationLogicProps {\n  command: CommandTree;\n}\n\n/**\n * A component that generates command validation logic for required options and arguments.\n */\nexport function CommandValidationLogic(props: CommandValidationLogicProps) {\n  const { command } = props;\n\n  return (\n    <>\n      <VarDeclaration name=\"failures\" type=\"string[]\" initializer={code`[];`} />\n      <hbr />\n      <For each={Object.values(command.options ?? {})} doubleHardline>\n        {option => (\n          <>\n            <Show when={!option.optional}>\n              <IfStatement\n                condition={code`!options${\n                  option.name.includes(\"?\")\n                    ? `[\"${option.name}\"]`\n                    : `.${camelCase(option.name)}`\n                }`}>\n                {code`failures.push(\"Missing required \\\\\"${option.name}\\\\\" option\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (option.kind === ReflectionKind.string ||\n                    option.kind === ReflectionKind.number) &&\n                  option.variadic\n                }>\n                <ElseIfClause\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              <Show\n                when={(option as NumberCommandOption).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    } && Number.isNaN(options${\n                      option.name.includes(\"?\")\n                        ? `[\"${option.name}\"]`\n                        : `.${camelCase(option.name)}`\n                    })`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      option.name\n                    }\\\\\" option\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`options${\n                    option.name.includes(\"?\")\n                      ? `[\"${option.name}\"]`\n                      : `.${camelCase(option.name)}`\n                  }.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    option.name\n                  }\\\\\" array option\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\n      <Spacing />\n      <For each={command.arguments} doubleHardline>\n        {argument => (\n          <>\n            <Show when={!argument.optional}>\n              <IfStatement condition={code`!${camelCase(argument.name)}`}>\n                {code`failures.push(\"Missing required \\\\\"${\n                  argument.name\n                }\\\\\" positional argument\");`}\n              </IfStatement>\n              <Show\n                when={\n                  (argument.kind === ReflectionKind.string ||\n                    argument.kind === ReflectionKind.number) &&\n                  argument.variadic\n                }>\n                <ElseIfClause\n                  condition={code`${camelCase(argument.name)}.length === 0`}>\n                  {code`failures.push(\"No values were provided to the required \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </ElseIfClause>\n              </Show>\n            </Show>\n            <Show when={argument.kind === ReflectionKind.number}>\n              <Show\n                when={(argument as NumberCommandArgument).variadic}\n                fallback={\n                  <IfStatement\n                    condition={code`${camelCase(\n                      argument.name\n                    )} && Number.isNaN(${camelCase(argument.name)})`}>\n                    {code`failures.push(\"Invalid numeric value provided for the \\\\\"${\n                      argument.name\n                    }\\\\\" positional argument\");`}\n                  </IfStatement>\n                }>\n                <IfStatement\n                  condition={code`${camelCase(argument.name)}.some(value => Number.isNaN(value))`}>\n                  {code`failures.push(\"Invalid numeric value provided in the \\\\\"${\n                    argument.name\n                  }\\\\\" array positional argument\");`}\n                </IfStatement>\n              </Show>\n            </Show>\n          </>\n        )}\n      </For>\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 command-line process can be executed: \\\\n\\\\n\" + failures.map(failure => \" - \" + failure).join(\"\\\\n\"));\n        options.help = true; `}\n      </IfStatement>\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]: `handle${pascalCase(command.name)}`\n        })}\n        builtinImports={defu(builtinImports ?? {}, {\n          env: [\"env\", \"isDevelopment\", \"isDebug\"],\n          console: [\n            \"debug\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\n            \"useArgs\",\n            \"hasFlag\",\n            \"isMinimal\",\n            \"isUnicodeSupported\",\n            \"internal_commandContext\"\n          ]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} banner={code`banner(); `}>\n          <CommandValidationLogic command={command} />\n        </CommandHandlerDeclaration>\n      </EntryFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

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

@@ -1,11 +1,11 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-const require_components_helpers = require('./helpers.cjs');
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
 let __alloy_js_typescript = require("@alloy-js/typescript");
 let __powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
 let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
 let __shell_shock_core_plugin_utils_context_helpers = require("@shell-shock/core/plugin-utils/context-helpers");
+let __shell_shock_core_components_helpers = require("@shell-shock/core/components/helpers");
 
 //#region src/components/exit-function-declaration.tsx
 /**
@@ -110,7 +110,7 @@ function ExitFunctionDeclaration() {
             const terminate = (force = false) => { `),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
 						get condition() {
-							return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_helpers.IsVerbose, {});
+							return (0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_helpers.IsVerbose, {});
 						},
 						children: __alloy_js_core.code`writeLine("");`
 					}),
@@ -143,7 +143,7 @@ function ExitFunctionDeclaration() {
 
             terminate();
           } catch (err) {
-            error(\`The exit process failed to complete\${(err as Error).message ? \` - (err as Error).message\` : ""}. Please contact the ${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} support team.\`);
+            error(\`The exit process failed to complete\${(err as Error)?.message ? \` - \${(err as Error).message}\` : ""}. Please contact the ${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} support team.\`);
 
             if (!options.skipProcessExit) {
               process.nextTick(() => process.exit(1));

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

@@ -1 +1 @@
-{"version":3,"file":"exit-function-declaration.cjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","getAppTitle","IsVerbose","ExitFunctionDeclaration","context","_$createComponent","name","doc","children","optional","type","_$createIntrinsic","initializer","async","parameters","default","_$memo","condition"],"sources":["../../src/components/exit-function-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { IsVerbose } from \"./helpers\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`);\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error).message ? \\` - (err as Error).message\\` : \"\"}. Please contact the ${getAppTitle(\n              context\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAmCA,SAAgBU,0BAA0B;CACxC,MAAMC,8EAA8C;AAEpD,QAAA;mDAEKR,4CAAoB;GAAA,UAAA;GAEnBU,MAAI;GACJC,KAAG;GAAA,IAAAC,WAAA;AAAA,WAAA;sDACFX,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAA;;GAAA,CAAA;mDAGNR,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,OAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAQ,CAAA;mDAE1BK,sCAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAK,CAAA;mDAEvBK,sCAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAK,CAAA;mDAEvBM,2DAAO,EAAA,CAAA;mDACPL,2CAAmB;GAAA,UAAA;GAElBmB,OAAK;GACLP,MAAI;GACJQ,YAAY,CACV;IACER,MAAM;IACNI,MAAM;IACNK,SAAS;IACV,CACF;GAAA,IAAAP,WAAA;AAAA,WAAA;iDACAf,oBAAI;;;;;;;;;;;;;;;;kKAiBGW,QACD,CAAA;;;qDAGqC;sDAC3CT,mCAAW;MAAA,IACVsB,YAAS;AAAA,+DAAGf,sCAAS,EAAA,CAAA;;MAAAM,UAAMf,oBAAI;MAAgB,CAAA;sDAAA,OAAA,EAAA,CAAA;iDAEhDA,oBAAI;+FAEGW,QACD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;8MA4BDA,QACD,CAAA;;;;;;UAMJ;KAAA;;GAAA,CAAA;EAAA"}
+{"version":3,"file":"exit-function-declaration.cjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","IsVerbose","getAppTitle","ExitFunctionDeclaration","context","_$createComponent","name","doc","children","optional","type","_$createIntrinsic","initializer","async","parameters","default","_$memo","condition"],"sources":["../../src/components/exit-function-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`);\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n              context\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAmCA,SAAgBU,0BAA0B;CACxC,MAAMC,8EAA8C;AAEpD,QAAA;mDAEKR,4CAAoB;GAAA,UAAA;GAEnBU,MAAI;GACJC,KAAG;GAAA,IAAAC,WAAA;AAAA,WAAA;sDACFX,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGJV,uCAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAA;;GAAA,CAAA;mDAGNR,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,OAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAQ,CAAA;mDAE1BK,sCAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAK,CAAA;mDAEvBK,sCAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,oBAAI;GAAK,CAAA;mDAEvBM,2DAAO,EAAA,CAAA;mDACPL,2CAAmB;GAAA,UAAA;GAElBmB,OAAK;GACLP,MAAI;GACJQ,YAAY,CACV;IACER,MAAM;IACNI,MAAM;IACNK,SAAS;IACV,CACF;GAAA,IAAAP,WAAA;AAAA,WAAA;iDACAf,oBAAI;;;;;;;;;;;;;;;;kKAiBGW,QACD,CAAA;;;qDAGqC;sDAC3CT,mCAAW;MAAA,IACVsB,YAAS;AAAA,+DAAGhB,iDAAS,EAAA,CAAA;;MAAAO,UAAMf,oBAAI;MAAgB,CAAA;sDAAA,OAAA,EAAA,CAAA;iDAEhDA,oBAAI;+FAEGW,QACD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;mNA4BDA,QACD,CAAA;;;;;;UAMJ;KAAA;;GAAA,CAAA;EAAA"}

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

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

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

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

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

@@ -1,10 +1,10 @@
-import { IsVerbose } from "./helpers.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
 import { code } from "@alloy-js/core";
 import { FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, VarDeclaration } from "@alloy-js/typescript";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
 import { getAppTitle } from "@shell-shock/core/plugin-utils/context-helpers";
+import { IsVerbose } from "@shell-shock/core/components/helpers";
 
 //#region src/components/exit-function-declaration.tsx
 /**
@@ -142,7 +142,7 @@ function ExitFunctionDeclaration() {
 
             terminate();
           } catch (err) {
-            error(\`The exit process failed to complete\${(err as Error).message ? \` - (err as Error).message\` : ""}. Please contact the ${getAppTitle(context)} support team.\`);
+            error(\`The exit process failed to complete\${(err as Error)?.message ? \` - \${(err as Error).message}\` : ""}. Please contact the ${getAppTitle(context)} support team.\`);
 
             if (!options.skipProcessExit) {
               process.nextTick(() => process.exit(1));

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

@@ -1 +1 @@
-{"version":3,"file":"exit-function-declaration.mjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","getAppTitle","IsVerbose","ExitFunctionDeclaration","context","_$createComponent","name","doc","children","optional","type","_$createIntrinsic","initializer","async","parameters","default","_$memo","condition"],"sources":["../../src/components/exit-function-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { IsVerbose } from \"./helpers\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`);\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error).message ? \\` - (err as Error).message\\` : \"\"}. Please contact the ${getAppTitle(\n              context\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAmCA,SAAgBU,0BAA0B;CACxC,MAAMC,UAAUJ,eAAoC;AAEpD,QAAA;EAAAK,gBAEKT,sBAAoB;GAAA,UAAA;GAEnBU,MAAI;GACJC,KAAG;GAAA,IAAAC,WAAA;AAAA,WAAA;KAAAH,gBACFR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAA;;GAAA,CAAA;EAAAF,gBAGNN,SAAO,EAAA,CAAA;EAAAM,gBACPP,gBAAc;GAAA,OAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAQ,CAAA;EAAAY,gBAE1BP,gBAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAK,CAAA;EAAAY,gBAEvBP,gBAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAK,CAAA;EAAAY,gBAEvBN,SAAO,EAAA,CAAA;EAAAM,gBACPX,qBAAmB;GAAA,UAAA;GAElBmB,OAAK;GACLP,MAAI;GACJQ,YAAY,CACV;IACER,MAAM;IACNI,MAAM;IACNK,SAAS;IACV,CACF;GAAA,IAAAP,WAAA;AAAA,WAAA;KAAAQ,WACAvB,IAAI;;;;;;;;;;;;;;;;iGAgBoFQ,YACjFG,QACD,CAAA;;;qDAGqC;KAAAC,gBAC3CV,aAAW;MAAA,IACVsB,YAAS;AAAA,cAAAZ,gBAAGH,WAAS,EAAA,CAAA;;MAAAM,UAAMf,IAAI;MAAgB,CAAA;KAAAkB,gBAAA,OAAA,EAAA,CAAA;KAAAK,WAEhDvB,IAAI;8BACiBQ,YACdG,QACD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;6IA2B8HH,YAC/HG,QACD,CAAA;;;;;;UAMJ;KAAA;;GAAA,CAAA;EAAA"}
+{"version":3,"file":"exit-function-declaration.mjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","IsVerbose","getAppTitle","ExitFunctionDeclaration","context","_$createComponent","name","doc","children","optional","type","_$createIntrinsic","initializer","async","parameters","default","_$memo","condition"],"sources":["../../src/components/exit-function-declaration.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { IsVerbose } from \"@shell-shock/core/components/helpers\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\n/**\n * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"ExitOptions\"\n        doc=\"Options for the exit handler function.\">\n        <InterfaceMember\n          name=\"exception\"\n          optional\n          type=\"string | Error\"\n          doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"skipProcessExit\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"isSynchronous\"\n          optional\n          type=\"boolean\"\n          doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"signal\"\n          optional\n          type=\"number\"\n          doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"startDate\"\n          optional\n          type=\"Date\"\n          doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        let\n        name=\"isExiting\"\n        type=\"boolean\"\n        initializer={code`false;`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackAsyncQueue\"\n        type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n        initializer={code`[];`}\n      />\n      <VarDeclaration\n        const\n        name=\"callbackSyncQueue\"\n        type=\"Array<(code: number | string) => void>\"\n        initializer={code`[];`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        export\n        async\n        name=\"exit\"\n        parameters={[\n          {\n            name: \"options\",\n            type: \"ExitOptions\",\n            default: \"{}\"\n          }\n        ]}>\n        {code`\n          try {\n            if (isExiting) {\n              return;\n            }\n\n            isExiting = true;\n\n            let exitCode: number | string = 0;\n            if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n              exitCode = 128 + (options.signal ?? 1);\n            } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n              exitCode = process.exitCode;\n            }\n\n            if (options.exception) {\n              error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n                context\n              )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`);\n            }\n\n            const terminate = (force = false) => { `}\n        <IfStatement\n          condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n        <hbr />\n        {code`\n              verbose(\\`The ${getAppTitle(\n                context\n              )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n              if (!options.skipProcessExit) {\n                process.nextTick(() => process.exit(exitCode));\n              }\n            };\n\n            for (const callbackSync of callbackSyncQueue) {\n              callbackSync(exitCode);\n            }\n\n            if (!options.isSynchronous) {\n              const promises = [];\n              let forceAfter = 0;\n              for (const [callbackAsync, wait] of callbackAsyncQueue) {\n                forceAfter = Math.max(forceAfter, wait);\n                promises.push(Promise.resolve(callbackAsync(exitCode)));\n              }\n\n              const asyncTimer = setTimeout(() => {\n                terminate(true);\n              }, forceAfter);\n              await Promise.all(promises);\n              clearTimeout(asyncTimer);\n            }\n\n            terminate();\n          } catch (err) {\n            error(\\`The exit process failed to complete\\${(err as Error)?.message ? \\` - \\${(err as Error).message}\\` : \"\"}. Please contact the ${getAppTitle(\n              context\n            )} support team.\\`);\n\n            if (!options.skipProcessExit) {\n              process.nextTick(() => process.exit(1));\n            }\n          }\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAmCA,SAAgBU,0BAA0B;CACxC,MAAMC,UAAUJ,eAAoC;AAEpD,QAAA;EAAAK,gBAEKT,sBAAoB;GAAA,UAAA;GAEnBU,MAAI;GACJC,KAAG;GAAA,IAAAC,WAAA;AAAA,WAAA;KAAAH,gBACFR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAAI,gBAAA,OAAA,EAAA,CAAA;KAAAN,gBAGJR,iBAAe;MACdS,MAAI;MACJG,UAAQ;MACRC,MAAI;MACJH,KAAG;MAAA,CAAA;KAAA;;GAAA,CAAA;EAAAF,gBAGNN,SAAO,EAAA,CAAA;EAAAM,gBACPP,gBAAc;GAAA,OAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAQ,CAAA;EAAAY,gBAE1BP,gBAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAK,CAAA;EAAAY,gBAEvBP,gBAAc;GAAA,SAAA;GAEbQ,MAAI;GACJI,MAAI;GACJE,aAAanB,IAAI;GAAK,CAAA;EAAAY,gBAEvBN,SAAO,EAAA,CAAA;EAAAM,gBACPX,qBAAmB;GAAA,UAAA;GAElBmB,OAAK;GACLP,MAAI;GACJQ,YAAY,CACV;IACER,MAAM;IACNI,MAAM;IACNK,SAAS;IACV,CACF;GAAA,IAAAP,WAAA;AAAA,WAAA;KAAAQ,WACAvB,IAAI;;;;;;;;;;;;;;;;iGAgBoFS,YACjFE,QACD,CAAA;;;qDAGqC;KAAAC,gBAC3CV,aAAW;MAAA,IACVsB,YAAS;AAAA,cAAAZ,gBAAGJ,WAAS,EAAA,CAAA;;MAAAO,UAAMf,IAAI;MAAgB,CAAA;KAAAkB,gBAAA,OAAA,EAAA,CAAA;KAAAK,WAEhDvB,IAAI;8BACiBS,YACdE,QACD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;kJA2BmIF,YACpIE,QACD,CAAA;;;;;;UAMJ;KAAA;;GAAA,CAAA;EAAA"}

package/dist/components/help.d.mts

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

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

@@ -110,6 +110,7 @@ function VirtualCommandEntry(props) {
 		},
 		get builtinImports() {
 			return (0, defu.default)(builtinImports ?? {}, {
+				env: ["isDevelopment", "isDebug"],
 				console: [
 					"help",
 					"warn",

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-command-entry.cjs","names":["code","computed","For","Show","FunctionDeclaration","usePowerlines","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","TypescriptFile","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","joinPaths","constantCase","pascalCase","defu","BannerFunctionDeclaration","CommandEntry","CommandRouter","VirtualHelp","VirtualCommandHandlerDeclaration","props","command","children","banner","context","_$createComponent","heading","title","segments","map","segment","join","description","replace","_$createIntrinsic","name","async","parameters","type","default","when","Boolean","options","Object","values","commands","VirtualCommandEntry","imports","builtinImports","rest","filePath","entryPath","filter","_$mergeProps","path","value","didyoumean2","entries","child","isVirtual","reduce","ret","alias","console","utils","each","fallback"],"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 { 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/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\nimport { VirtualHelp } from \"./help\";\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        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <VirtualHelp\n          segments={command.segments}\n          options={Object.values(command.options)}\n          commands={command.children ?? {}}\n        />\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          {\n            didyoumean2: [\n              { name: \"didYouMean\", default: true },\n              { name: \"ReturnTypeEnums\" },\n              { name: \"ThresholdTypeEnums\" }\n            ]\n          },\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          console: [\n            \"help\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"writeLine\",\n            \"splitText\",\n            \"stripAnsi\"\n          ],\n          utils: [\"useArgs\", \"hasFlag\", \"isMinimal\", \"isUnicodeSupported\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`banner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"virtual-command-entry.cjs","names":["code","computed","For","Show","FunctionDeclaration","usePowerlines","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","TypescriptFile","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","joinPaths","constantCase","pascalCase","defu","BannerFunctionDeclaration","CommandEntry","CommandRouter","VirtualHelp","VirtualCommandHandlerDeclaration","props","command","children","banner","context","_$createComponent","heading","title","segments","map","segment","join","description","replace","_$createIntrinsic","name","async","parameters","type","default","when","Boolean","options","Object","values","commands","VirtualCommandEntry","imports","builtinImports","rest","filePath","entryPath","filter","_$mergeProps","path","value","didyoumean2","entries","child","isVirtual","reduce","ret","alias","env","console","utils","each","fallback"],"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 { 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/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\nimport { VirtualHelp } from \"./help\";\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        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <VirtualHelp\n          segments={command.segments}\n          options={Object.values(command.options)}\n          commands={command.children ?? {}}\n        />\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          {\n            didyoumean2: [\n              { name: \"didYouMean\", default: true },\n              { name: \"ReturnTypeEnums\" },\n              { name: \"ThresholdTypeEnums\" }\n            ]\n          },\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: [\n            \"help\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"writeLine\",\n            \"splitText\",\n            \"stripAnsi\"\n          ],\n          utils: [\"useArgs\", \"hasFlag\", \"isMinimal\", \"isUnicodeSupported\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`banner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

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

@@ -108,6 +108,7 @@ function VirtualCommandEntry(props) {
 		},
 		get builtinImports() {
 			return defu(builtinImports ?? {}, {
+				env: ["isDevelopment", "isDebug"],
 				console: [
 					"help",
 					"warn",

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-command-entry.mjs","names":["code","computed","For","Show","FunctionDeclaration","usePowerlines","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","TypescriptFile","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","joinPaths","constantCase","pascalCase","defu","BannerFunctionDeclaration","CommandEntry","CommandRouter","VirtualHelp","VirtualCommandHandlerDeclaration","props","command","children","banner","context","_$createComponent","heading","title","segments","map","segment","join","description","replace","_$createIntrinsic","name","async","parameters","type","default","when","Boolean","options","Object","values","commands","VirtualCommandEntry","imports","builtinImports","rest","filePath","entryPath","filter","_$mergeProps","path","value","didyoumean2","entries","child","isVirtual","reduce","ret","alias","console","utils","each","fallback"],"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 { 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/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\nimport { VirtualHelp } from \"./help\";\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        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <VirtualHelp\n          segments={command.segments}\n          options={Object.values(command.options)}\n          commands={command.children ?? {}}\n        />\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          {\n            didyoumean2: [\n              { name: \"didYouMean\", default: true },\n              { name: \"ReturnTypeEnums\" },\n              { name: \"ThresholdTypeEnums\" }\n            ]\n          },\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          console: [\n            \"help\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"writeLine\",\n            \"splitText\",\n            \"stripAnsi\"\n          ],\n          utils: [\"useArgs\", \"hasFlag\", \"isMinimal\", \"isUnicodeSupported\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`banner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"virtual-command-entry.mjs","names":["code","computed","For","Show","FunctionDeclaration","usePowerlines","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","TypescriptFile","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","joinPaths","constantCase","pascalCase","defu","BannerFunctionDeclaration","CommandEntry","CommandRouter","VirtualHelp","VirtualCommandHandlerDeclaration","props","command","children","banner","context","_$createComponent","heading","title","segments","map","segment","join","description","replace","_$createIntrinsic","name","async","parameters","type","default","when","Boolean","options","Object","values","commands","VirtualCommandEntry","imports","builtinImports","rest","filePath","entryPath","filter","_$mergeProps","path","value","didyoumean2","entries","child","isVirtual","reduce","ret","alias","env","console","utils","each","fallback"],"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 { 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/context-helpers\";\nimport type { CommandTree } from \"@shell-shock/core/types/command\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { BannerFunctionDeclaration } from \"./banner-function-declaration\";\nimport { CommandEntry } from \"./command-entry\";\nimport { CommandRouter } from \"./command-router\";\nimport { VirtualHelp } from \"./help\";\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        <hbr />\n        <hbr />\n        {children}\n        <hbr />\n        <hbr />\n        <Show when={Boolean(banner)}>{banner}</Show>\n        <hbr />\n        <hbr />\n        <VirtualHelp\n          segments={command.segments}\n          options={Object.values(command.options)}\n          commands={command.children ?? {}}\n        />\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          {\n            didyoumean2: [\n              { name: \"didYouMean\", default: true },\n              { name: \"ReturnTypeEnums\" },\n              { name: \"ThresholdTypeEnums\" }\n            ]\n          },\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: [\n            \"help\",\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"writeLine\",\n            \"splitText\",\n            \"stripAnsi\"\n          ],\n          utils: [\"useArgs\", \"hasFlag\", \"isMinimal\", \"isUnicodeSupported\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <VirtualCommandHandlerDeclaration\n          command={command}\n          banner={code`banner(); `}>\n          <CommandRouter\n            segments={command.segments}\n            commands={command.children}\n          />\n        </VirtualCommandHandlerDeclaration>\n      </TypescriptFile>\n      <For each={Object.values(command.children)}>\n        {child => (\n          <Show\n            when={child.isVirtual}\n            fallback={<CommandEntry command={child} />}>\n            <VirtualCommandEntry command={child} />\n          </Show>\n        )}\n      </For>\n    </>\n  );\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/preset-script",
-  "version": "0.6.11",
+  "version": "0.6.13",
   "type": "module",
   "description": "A Shell Shock preset that generates a fully-featured script application.",
   "repository": {
@@ -237,23 +237,23 @@
   "dependencies": {
     "@alloy-js/core": "0.23.0-dev.8",
     "@alloy-js/typescript": "0.23.0-dev.4",
-    "@powerlines/deepkit": "^0.6.66",
-    "@powerlines/plugin-alloy": "0.23.16",
-    "@powerlines/plugin-plugin": "^0.12.237",
-    "@shell-shock/core": "^0.8.12",
-    "@shell-shock/plugin-theme": "^0.3.0",
+    "@powerlines/deepkit": "^0.6.67",
+    "@powerlines/plugin-alloy": "^0.23.17",
+    "@powerlines/plugin-plugin": "^0.12.238",
+    "@shell-shock/core": "^0.9.0",
+    "@shell-shock/plugin-theme": "^0.3.2",
     "@stryke/helpers": "^0.9.42",
     "@stryke/path": "0.26.6",
     "@stryke/string-format": "0.14.2",
     "defu": "6.1.4",
-    "powerlines": "^0.38.53",
-    "@shell-shock/plugin-console": "^0.0.2"
+    "powerlines": "^0.38.54",
+    "@shell-shock/plugin-console": "^0.0.4"
   },
   "devDependencies": {
     "@babel/core": "^7.29.0",
-    "@powerlines/plugin-alloy": "0.23.16",
-    "@types/node": "^22.19.11"
+    "@powerlines/plugin-alloy": "^0.23.17",
+    "@types/node": "^25.3.0"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "a802bf947afd12ce5c0f29aae1d4039c9e4f40f7"
+  "gitHead": "cfda8730b7dac0e89647907af8bdf83635eee335"
 }