@shell-shock/preset-script 0.3.3 → 0.4.1

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.cjs","names":["code","computed","For","Show","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","RunApplication","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","_$createComponent","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 { 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\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <hbr />\n      <hbr />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        try {\n          process.on(\"exit\", () => exit({\n            skipExit: true,\n            isSynchronous: true,\n            signal: 0\n          }));\n          process.on(\"beforeExit\", () => exit({\n            signal: 0\n          }));\n          process.on(\"message\", message => {\n            if (message === 'shutdown') {\n              exit({\n                isSynchronous: true,\n                signal: -128\n              });\n            }\n          });\n\n          process.once(\"SIGTERM\", () => exit({\n            signal: 15\n          }));\n          process.once(\"SIGINT\", () => exit({\n            signal: 2\n          }));\n          process.once(\"SIGUSR2\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              signal: 12\n            });\n          });\n          process.once(\"SIGQUIT\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              signal: 12\n            });\n          });\n\n          for (const type of [\"unhandledRejection\", \"uncaughtException\"]) {\n            process.on(type, err => exit({\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          const result = await main();\n          if (result?.error) {\n            error(result.error);\n          }\n\n          exit();\n        } catch (err) {\n          exit({ 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\"],\n            utils: [\"hasFlag\", \"exit\"]\n          })}>\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <hbr />\n            <hbr />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(context)} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${context?.packageJson.version ? `\"${context?.packageJson.version}\"` : \"0.0.1\"});\n          return;`}\n            </IfStatement>\n            <hbr />\n            <hbr />\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":";;;;;;;;;;;;;;;;;;;AAqCA,SAAgBe,iBAAiB;AAC/B,QAAA;mDAAA,OAAA,EAAA,CAAA;mDAAA,OAAA,EAAA,CAAA;EAIKf,oBAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDAuDJ,OAAA,EAAA,CAAA;EAAA;;;;;AAkBP,SAAgBiB,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,yDACG5B,qBAAG;EAAA,IAAC8B,OAAI;AAAA,UAAEN,KAAKO;;EAAKV,WAClBO,yDACEvB,kHACKiB,MAAI;GAAA,IACRW,OAAI;AAAA,qGAAgCL,IAAI,CAAC;;GACzCM,gBAAgB;IACdC,MAAMP;IACNQ,QAAQ;IACT;GAAA,IACDhB,UAAO;AAAA,6BACL,EACEiB,aAAa;KACX;MAAEC,MAAM;MAAcC,SAAS;MAAM;KACrC,EAAED,MAAM,mBAAmB;KAC3B,EAAEA,MAAM,sBAAsB;KAAA,EAEjC,EACDlB,WAAW,EAAE,EACbK,OAAOe,QAAQjB,QAAQkB,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,IACD3B,iBAAc;AAAA,6BAAOA,kBAAkB,EAAE,EAAE;KACzC6B,SAAS;MAAC;MAAS;MAAW;MAAQ;KACtCC,OAAO,CAAC,WAAW,OAAM;KAC1B,CAAC;;GAAA,IAAA5B,WAAA;AAAA,WAAA;sDACDpB,sBAAI;MAAA,IAACiD,OAAI;AAAA,cAAEC,QAAQlC,OAAO;;MAAA,IAAAI,WAAA;AAAA,cAAA;QACxBJ;yDAAM,OAAA,EAAA,CAAA;yDAAA,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;sDAIRX,6DAAK,EAAA,IACJ8C,UAAO;AAAA,aAAE,+FAA0C7B,QAAQ,CAAA;QAAmB,CAAA;sDAC/ErB,2CAAmB;MAACmD,OAAK;MAACC,YAAU;MAAOhB,MAAI;MAAA,IAAAjB,WAAA;AAAA,cAAA;yDAC7ClB,mCAAW;SAACoD,WAAWzD,oBAAI;SAA2B,IAAAuB,WAAA;AAAA,iBACpDvB,oBAAI,eAAeyB,SAASiC,YAAYC,UAAU,IAAIlC,SAASiC,YAAYC,QAAO,KAAM,QAAO;;;SAC5F,CAAA;yDAAA,OAAA,EAAA,CAAA;yDAAA,OAAA,EAAA,CAAA;QAILpC;yDAAQ,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAMVpB,sBAAI;MAAA,IAACiD,OAAI;AAAA,cAAEC,QAAQjC,QAAQ;;MAAA,IAAEwC,WAAQ;AAAA,+DAAG7C,gBAAc,EAAA,CAAA;;MAAAQ,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","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","RunApplication","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","_$createComponent","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 { 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\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <hbr />\n      <hbr />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        try {\n          const startDate = new Date();\n\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          const result = await main();\n          if (result?.error) {\n            error(result.error);\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\"],\n            utils: [\"hasFlag\", \"exit\"]\n          })}>\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <hbr />\n            <hbr />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(context)} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${context?.packageJson.version ? `\"${context?.packageJson.version}\"` : \"0.0.1\"});\n          return;`}\n            </IfStatement>\n            <hbr />\n            <hbr />\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":";;;;;;;;;;;;;;;;;;;AAqCA,SAAgBe,iBAAiB;AAC/B,QAAA;mDAAA,OAAA,EAAA,CAAA;mDAAA,OAAA,EAAA,CAAA;EAIKf,oBAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDAiEJ,OAAA,EAAA,CAAA;EAAA;;;;;AAkBP,SAAgBiB,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,yDACG5B,qBAAG;EAAA,IAAC8B,OAAI;AAAA,UAAEN,KAAKO;;EAAKV,WAClBO,yDACEvB,kHACKiB,MAAI;GAAA,IACRW,OAAI;AAAA,qGAAgCL,IAAI,CAAC;;GACzCM,gBAAgB;IACdC,MAAMP;IACNQ,QAAQ;IACT;GAAA,IACDhB,UAAO;AAAA,6BACL,EACEiB,aAAa;KACX;MAAEC,MAAM;MAAcC,SAAS;MAAM;KACrC,EAAED,MAAM,mBAAmB;KAC3B,EAAEA,MAAM,sBAAsB;KAAA,EAEjC,EACDlB,WAAW,EAAE,EACbK,OAAOe,QAAQjB,QAAQkB,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,IACD3B,iBAAc;AAAA,6BAAOA,kBAAkB,EAAE,EAAE;KACzC6B,SAAS;MAAC;MAAS;MAAW;MAAQ;KACtCC,OAAO,CAAC,WAAW,OAAM;KAC1B,CAAC;;GAAA,IAAA5B,WAAA;AAAA,WAAA;sDACDpB,sBAAI;MAAA,IAACiD,OAAI;AAAA,cAAEC,QAAQlC,OAAO;;MAAA,IAAAI,WAAA;AAAA,cAAA;QACxBJ;yDAAM,OAAA,EAAA,CAAA;yDAAA,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;sDAIRX,6DAAK,EAAA,IACJ8C,UAAO;AAAA,aAAE,+FAA0C7B,QAAQ,CAAA;QAAmB,CAAA;sDAC/ErB,2CAAmB;MAACmD,OAAK;MAACC,YAAU;MAAOhB,MAAI;MAAA,IAAAjB,WAAA;AAAA,cAAA;yDAC7ClB,mCAAW;SAACoD,WAAWzD,oBAAI;SAA2B,IAAAuB,WAAA;AAAA,iBACpDvB,oBAAI,eAAeyB,SAASiC,YAAYC,UAAU,IAAIlC,SAASiC,YAAYC,QAAO,KAAM,QAAO;;;SAC5F,CAAA;yDAAA,OAAA,EAAA,CAAA;yDAAA,OAAA,EAAA,CAAA;QAILpC;yDAAQ,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAMVpB,sBAAI;MAAA,IAACiD,OAAI;AAAA,cAAEC,QAAQjC,QAAQ;;MAAA,IAAEwC,WAAQ;AAAA,+DAAG7C,gBAAc,EAAA,CAAA;;MAAAQ,UACpDH;MAAO,CAAA;sDAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA,CAAA;EAIb,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.d.cts","names":[],"sources":["../../src/components/bin-entry.tsx"],"sourcesContent":[],"mappings":";;;;;;;AAqCA;AAkEiB,iBAlED,cAAA,CAAA,CAkEe,EAlED,QAkEC;AAC7B,UADe,aAAA,SAAsB,IACrC,CAAA,cAAA,EAAA,MAAA,GAAA,UAAA,CAAA,CAAA;EAGS,MAAA,CAAA,EAAA,QAAA;EACC,OAAA,CAAA,EAAA,QAAA;EACA,QAAA,EAAA,QAAA;;;AAMZ;;iBAAgB,QAAA,QAAgB,gBAAa"}
+{"version":3,"file":"bin-entry.d.cts","names":[],"sources":["../../src/components/bin-entry.tsx"],"sourcesContent":[],"mappings":";;;;;;;AAqCA;AA4EiB,iBA5ED,cAAA,CAAA,CA4Ee,EA5ED,QA4EC;AAC7B,UADe,aAAA,SAAsB,IACrC,CAAA,cAAA,EAAA,MAAA,GAAA,UAAA,CAAA,CAAA;EAGS,MAAA,CAAA,EAAA,QAAA;EACC,OAAA,CAAA,EAAA,QAAA;EACA,QAAA,EAAA,QAAA;;;AAMZ;;iBAAgB,QAAA,QAAgB,gBAAa"}

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.d.mts","names":[],"sources":["../../src/components/bin-entry.tsx"],"sourcesContent":[],"mappings":";;;;;;;AAqCA;AAkEiB,iBAlED,cAAA,CAAA,CAkEe,EAlED,QAkEC;AAC7B,UADe,aAAA,SAAsB,IACrC,CAAA,cAAA,EAAA,MAAA,GAAA,UAAA,CAAA,CAAA;EAGS,MAAA,CAAA,EAAA,QAAA;EACC,OAAA,CAAA,EAAA,QAAA;EACA,QAAA,EAAA,QAAA;;;AAMZ;;iBAAgB,QAAA,QAAgB,gBAAa"}
+{"version":3,"file":"bin-entry.d.mts","names":[],"sources":["../../src/components/bin-entry.tsx"],"sourcesContent":[],"mappings":";;;;;;;AAqCA;AA4EiB,iBA5ED,cAAA,CAAA,CA4Ee,EA5ED,QA4EC;AAC7B,UADe,aAAA,SAAsB,IACrC,CAAA,cAAA,EAAA,MAAA,GAAA,UAAA,CAAA,CAAA;EAGS,MAAA,CAAA,EAAA,QAAA;EACC,OAAA,CAAA,EAAA,QAAA;EACA,QAAA,EAAA,QAAA;;;AAMZ;;iBAAgB,QAAA,QAAgB,gBAAa"}

package/dist/components/bin-entry.mjs

@@ -22,17 +22,22 @@ function RunApplication() {
 		code`// Run the application main logic inside an asynchronous IIFE
       (async () => {
         try {
+          const startDate = new Date();
+
           process.on("exit", () => exit({
+            startDate,
             skipExit: true,
             isSynchronous: true,
             signal: 0
           }));
           process.on("beforeExit", () => exit({
+            startDate,
             signal: 0
           }));
           process.on("message", message => {
             if (message === 'shutdown') {
               exit({
+                startDate,
                 isSynchronous: true,
                 signal: -128
               });
@@ -40,26 +45,31 @@ function RunApplication() {
           });
 
           process.once("SIGTERM", () => exit({
+            startDate,
             signal: 15
           }));
           process.once("SIGINT", () => exit({
+            startDate,
             signal: 2
           }));
           process.once("SIGUSR2", () => {
             verbose("The application was terminated by the user");
             return exit({
+              startDate,
               signal: 12
             });
           });
           process.once("SIGQUIT", () => {
             verbose("The application was terminated by the user");
             return exit({
+              startDate,
               signal: 12
             });
           });
 
           for (const type of ["unhandledRejection", "uncaughtException"]) {
             process.on(type, err => exit({
+              startDate,
               exception: err || new Error(\`An \${type === "unhandledRejection" ? "unhandled promise rejection" : "uncaught exception"} occurred during processing - the application is shutting down.\`)
             }));
           }
@@ -69,9 +79,9 @@ function RunApplication() {
             error(result.error);
           }
 
-          exit();
+          exit({ startDate });
         } catch (err) {
-          exit({ exception: err as Error });
+          exit({ startDate, exception: err as Error });
         }
       })();
       `,

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

@@ -1 +1 @@
-{"version":3,"file":"bin-entry.mjs","names":["code","computed","For","Show","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","RunApplication","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","_$createComponent","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 { 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\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <hbr />\n      <hbr />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        try {\n          process.on(\"exit\", () => exit({\n            skipExit: true,\n            isSynchronous: true,\n            signal: 0\n          }));\n          process.on(\"beforeExit\", () => exit({\n            signal: 0\n          }));\n          process.on(\"message\", message => {\n            if (message === 'shutdown') {\n              exit({\n                isSynchronous: true,\n                signal: -128\n              });\n            }\n          });\n\n          process.once(\"SIGTERM\", () => exit({\n            signal: 15\n          }));\n          process.once(\"SIGINT\", () => exit({\n            signal: 2\n          }));\n          process.once(\"SIGUSR2\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              signal: 12\n            });\n          });\n          process.once(\"SIGQUIT\", () => {\n            verbose(\"The application was terminated by the user\");\n            return exit({\n              signal: 12\n            });\n          });\n\n          for (const type of [\"unhandledRejection\", \"uncaughtException\"]) {\n            process.on(type, err => exit({\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          const result = await main();\n          if (result?.error) {\n            error(result.error);\n          }\n\n          exit();\n        } catch (err) {\n          exit({ 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\"],\n            utils: [\"hasFlag\", \"exit\"]\n          })}>\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <hbr />\n            <hbr />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(context)} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${context?.packageJson.version ? `\"${context?.packageJson.version}\"` : \"0.0.1\"});\n          return;`}\n            </IfStatement>\n            <hbr />\n            <hbr />\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":";;;;;;;;;;;;;;;;;AAqCA,SAAgBe,iBAAiB;AAC/B,QAAA;EAAAC,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAIKhB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDJgB,gBAAA,OAAA,EAAA,CAAA;EAAA;;;;;AAkBP,SAAgBC,SAASC,OAAsB;CAC7C,MAAM,EAAEC,QAAQC,SAASC,gBAAgBC,SAASC,UAAU,GAAGC,SAASN;CAExE,MAAMO,UAAUnB,eAAoC;CACpD,MAAMoB,OAAOzB,eAAeS,UAAUiB,OAAOC,OAAOH,QAAQI,OAAOC,IAAI,CAAC,CAAC;AAEzE,QAAAC,gBACG7B,KAAG;EAAA,IAAC8B,OAAI;AAAA,UAAEN,KAAKO;;EAAKV,WAClBO,QAAGC,gBACDxB,WAAS2B,WACJV,MAAI;GAAA,IACRW,OAAI;AAAA,WAAExB,aAAaC,iBAAiBkB,IAAI,CAAC;;GACzCM,gBAAgB;IACdC,MAAMP;IACNQ,QAAQ;IACT;GAAA,IACDhB,UAAO;AAAA,WAAER,KACP,EACEyB,aAAa;KACX;MAAEC,MAAM;MAAcC,SAAS;MAAM;KACrC,EAAED,MAAM,mBAAmB;KAC3B,EAAEA,MAAM,sBAAsB;KAAA,EAEjC,EACDlB,WAAW,EAAE,EACbK,OAAOe,QAAQjB,QAAQkB,SAAS,CAC7BC,QAAQ,GAAGC,aAAaA,QAAQC,UAAU,CAC1CC,QAAQC,KAAK,CAACR,MAAMK,aAAa;AAChCG,SAAI,KAAKH,QAAQL,UAAU,CACzB;MAAEA,MAAM;MAAWS,OAAO,SAASpC,WAAW2B,KAAK;MAAI,CACxD;AAED,YAAOQ;OACN,EAA2B,CAClC,CAAC;;GAAA,IACD3B,iBAAc;AAAA,WAAEP,KAAKO,kBAAkB,EAAE,EAAE;KACzC6B,SAAS;MAAC;MAAS;MAAW;MAAQ;KACtCC,OAAO,CAAC,WAAW,OAAM;KAC1B,CAAC;;GAAA,IAAA5B,WAAA;AAAA,WAAA;KAAAQ,gBACD5B,MAAI;MAAA,IAACiD,OAAI;AAAA,cAAEC,QAAQlC,OAAO;;MAAA,IAAAI,WAAA;AAAA,cAAA;QACxBJ;QAAMH,gBAAA,OAAA,EAAA,CAAA;QAAAA,gBAAA,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;KAAAe,gBAIRvB,OAAK,EAAA,IACJ8C,UAAO;AAAA,aAAE,8BAA8B7C,YAAYgB,QAAQ,CAAA;QAAmB,CAAA;KAAAM,gBAC/E3B,qBAAmB;MAACmD,OAAK;MAACC,YAAU;MAAOhB,MAAI;MAAA,IAAAjB,WAAA;AAAA,cAAA;QAAAQ,gBAC7C1B,aAAW;SAACoD,WAAWzD,IAAI;SAA2B,IAAAuB,WAAA;AAAA,iBACpDvB,IAAI,eAAeyB,SAASiC,YAAYC,UAAU,IAAIlC,SAASiC,YAAYC,QAAO,KAAM,QAAO;;;SAC5F,CAAA;QAAA3C,gBAAA,OAAA,EAAA,CAAA;QAAAA,gBAAA,OAAA,EAAA,CAAA;QAILO;QAAQP,gBAAA,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAe,gBAMV5B,MAAI;MAAA,IAACiD,OAAI;AAAA,cAAEC,QAAQjC,QAAQ;;MAAA,IAAEwC,WAAQ;AAAA,cAAA7B,gBAAGhB,gBAAc,EAAA,CAAA;;MAAAQ,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","usePowerlines","EntryFile","TSDoc","getAppTitle","getUnique","findFileName","replaceExtension","pascalCase","defu","RunApplication","_$createIntrinsic","BinEntry","props","prefix","postfix","builtinImports","imports","children","rest","context","bins","Object","values","config","bin","_$createComponent","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 { 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\";\n\n/**\n * Runs the application main logic with proper exit handling.\n */\nexport function RunApplication() {\n  return (\n    <>\n      <hbr />\n      <hbr />\n      {code`// Run the application main logic inside an asynchronous IIFE\n      (async () => {\n        try {\n          const startDate = new Date();\n\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          const result = await main();\n          if (result?.error) {\n            error(result.error);\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\"],\n            utils: [\"hasFlag\", \"exit\"]\n          })}>\n          <Show when={Boolean(prefix)}>\n            {prefix}\n            <hbr />\n            <hbr />\n          </Show>\n          <TSDoc\n            heading={`Binary entry point for the ${getAppTitle(context)} CLI application.`}></TSDoc>\n          <FunctionDeclaration async returnType=\"any\" name=\"main\">\n            <IfStatement condition={code`hasFlag([\"version\", \"v\"])`}>\n              {code`console.log(${context?.packageJson.version ? `\"${context?.packageJson.version}\"` : \"0.0.1\"});\n          return;`}\n            </IfStatement>\n            <hbr />\n            <hbr />\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":";;;;;;;;;;;;;;;;;AAqCA,SAAgBe,iBAAiB;AAC/B,QAAA;EAAAC,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAIKhB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiEJgB,gBAAA,OAAA,EAAA,CAAA;EAAA;;;;;AAkBP,SAAgBC,SAASC,OAAsB;CAC7C,MAAM,EAAEC,QAAQC,SAASC,gBAAgBC,SAASC,UAAU,GAAGC,SAASN;CAExE,MAAMO,UAAUnB,eAAoC;CACpD,MAAMoB,OAAOzB,eAAeS,UAAUiB,OAAOC,OAAOH,QAAQI,OAAOC,IAAI,CAAC,CAAC;AAEzE,QAAAC,gBACG7B,KAAG;EAAA,IAAC8B,OAAI;AAAA,UAAEN,KAAKO;;EAAKV,WAClBO,QAAGC,gBACDxB,WAAS2B,WACJV,MAAI;GAAA,IACRW,OAAI;AAAA,WAAExB,aAAaC,iBAAiBkB,IAAI,CAAC;;GACzCM,gBAAgB;IACdC,MAAMP;IACNQ,QAAQ;IACT;GAAA,IACDhB,UAAO;AAAA,WAAER,KACP,EACEyB,aAAa;KACX;MAAEC,MAAM;MAAcC,SAAS;MAAM;KACrC,EAAED,MAAM,mBAAmB;KAC3B,EAAEA,MAAM,sBAAsB;KAAA,EAEjC,EACDlB,WAAW,EAAE,EACbK,OAAOe,QAAQjB,QAAQkB,SAAS,CAC7BC,QAAQ,GAAGC,aAAaA,QAAQC,UAAU,CAC1CC,QAAQC,KAAK,CAACR,MAAMK,aAAa;AAChCG,SAAI,KAAKH,QAAQL,UAAU,CACzB;MAAEA,MAAM;MAAWS,OAAO,SAASpC,WAAW2B,KAAK;MAAI,CACxD;AAED,YAAOQ;OACN,EAA2B,CAClC,CAAC;;GAAA,IACD3B,iBAAc;AAAA,WAAEP,KAAKO,kBAAkB,EAAE,EAAE;KACzC6B,SAAS;MAAC;MAAS;MAAW;MAAQ;KACtCC,OAAO,CAAC,WAAW,OAAM;KAC1B,CAAC;;GAAA,IAAA5B,WAAA;AAAA,WAAA;KAAAQ,gBACD5B,MAAI;MAAA,IAACiD,OAAI;AAAA,cAAEC,QAAQlC,OAAO;;MAAA,IAAAI,WAAA;AAAA,cAAA;QACxBJ;QAAMH,gBAAA,OAAA,EAAA,CAAA;QAAAA,gBAAA,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;KAAAe,gBAIRvB,OAAK,EAAA,IACJ8C,UAAO;AAAA,aAAE,8BAA8B7C,YAAYgB,QAAQ,CAAA;QAAmB,CAAA;KAAAM,gBAC/E3B,qBAAmB;MAACmD,OAAK;MAACC,YAAU;MAAOhB,MAAI;MAAA,IAAAjB,WAAA;AAAA,cAAA;QAAAQ,gBAC7C1B,aAAW;SAACoD,WAAWzD,IAAI;SAA2B,IAAAuB,WAAA;AAAA,iBACpDvB,IAAI,eAAeyB,SAASiC,YAAYC,UAAU,IAAIlC,SAASiC,YAAYC,QAAO,KAAM,QAAO;;;SAC5F,CAAA;QAAA3C,gBAAA,OAAA,EAAA,CAAA;QAAAA,gBAAA,OAAA,EAAA,CAAA;QAILO;QAAQP,gBAAA,OAAA,EAAA,CAAA;QAAA;;MAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAe,gBAMV5B,MAAI;MAAA,IAACiD,OAAI;AAAA,cAAEC,QAAQjC,QAAQ;;MAAA,IAAEwC,WAAQ;AAAA,cAAA7B,gBAAGhB,gBAAc,EAAA,CAAA;;MAAAQ,UACpDH;MAAO,CAAA;KAAAJ,gBAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA,CAAA;EAIb,CAAA"}

package/dist/components/command-entry.cjs

@@ -1,4 +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_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");
@@ -21,17 +22,17 @@ let __stryke_string_format_constant_case = require("@stryke/string-format/consta
 //#region src/components/command-entry.tsx
 function CommandInvocation(props) {
 	const { command } = props;
-	return [(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`return Promise.resolve(handle${(0, __stryke_string_format_pascal_case.pascalCase)(command.name)}(options${command.path.segments.filter((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isPositionalCommandOption)(segment)).length > 0 ? `, ${command.path.segments.filter((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isPositionalCommandOption)(segment)).map((segment) => (0, __stryke_string_format_camel_case.camelCase)((0, __shell_shock_core_plugin_utils_context_helpers.getPositionalCommandOptionName)(segment))).join(", ")}` : ""}));`), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+	return [(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`return Promise.resolve(handle${(0, __stryke_string_format_pascal_case.pascalCase)(command.name)}(options${command.path.segments.filter((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment)).length > 0 ? `, ${command.path.segments.filter((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment)).map((segment) => (0, __stryke_string_format_camel_case.camelCase)((0, __shell_shock_core_plugin_utils_context_helpers.getDynamicPathSegmentName)(segment))).join(", ")}` : ""}));`), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
 }
 /**
 * A component that generates the `handler` function declaration for a command.
 */
 function CommandHandlerDeclaration(props) {
-	const { command } = props;
+	const { command, children } = props;
 	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
 	return [(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
 		get heading() {
-			return `The ${command.title} (${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)} ${command.path.segments.map((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isPositionalCommandOption)(segment) ? `[${(0, __stryke_string_format_constant_case.constantCase)((0, __shell_shock_core_plugin_utils_context_helpers.getPositionalCommandOptionName)(segment))}]` : segment).join(" ")}) command.`;
+			return `The ${command.title} (${(0, __shell_shock_core_plugin_utils_context_helpers.getAppBin)(context)} ${command.path.segments.map((segment) => (0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment) ? `[${(0, __stryke_string_format_constant_case.constantCase)((0, __shell_shock_core_plugin_utils_context_helpers.getDynamicPathSegmentName)(segment))}]` : segment).join(" ")}) command.`;
 		},
 		get children() {
 			return [
@@ -59,7 +60,7 @@ function CommandHandlerDeclaration(props) {
 		}],
 		get children() {
 			return [
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_options_parser_logic.PositionalOptionsParserLogic, {
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_options_parser_logic.DynamicPathSegmentsParserLogic, {
 					get path() {
 						return command.path;
 					},
@@ -80,19 +81,17 @@ function CommandHandlerDeclaration(props) {
 				}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				__alloy_js_core.code`writeLine("");
+        banner();`,
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				children,
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
 					condition: __alloy_js_core.code`options.help`,
 					get children() {
-						return [
-							(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
-        writeLine("");
-        writeLine(colors.text.heading.primary("${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} - ${command.title}"));
-        writeLine("");
-        writeLine(colors.text.body.primary("${command.description.replace(/\.+$/, "")}."));
-        writeLine("");`),
-							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_help.Help, { command })
-						];
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_help.CommandHelp, { command });
 					}
 				}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseClause, { get children() {
@@ -108,7 +107,7 @@ function CommandHandlerDeclaration(props) {
 function CommandEntry(props) {
 	const { command, imports, builtinImports, ...rest } = props;
 	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const filePath = (0, __alloy_js_core.computed)(() => (0, __stryke_path_join.joinPaths)(command.path.segments.filter((segment) => !(0, __shell_shock_core_plugin_utils_context_helpers.isPositionalCommandOption)(segment)).join("/"), "index.ts"));
+	const filePath = (0, __alloy_js_core.computed)(() => (0, __stryke_path_join.joinPaths)(command.path.segments.filter((segment) => !(0, __shell_shock_core_plugin_utils_context_helpers.isDynamicPathSegment)(segment)).join("/"), "index.ts"));
 	const commandSourcePath = (0, __alloy_js_core.computed)(() => (0, __stryke_path_replace.replaceExtension)((0, __stryke_path_find.relativePath)((0, __stryke_path_join.joinPaths)(context.entryPath, (0, __stryke_path_find.findFilePath)(filePath.value)), command.entry.input?.file || command.entry.file)));
 	const typeDefinition = (0, __alloy_js_core.computed)(() => ({
 		...command.entry,
@@ -136,11 +135,18 @@ function CommandEntry(props) {
 					"writeLine",
 					"splitText"
 				],
-				utils: ["getArgs", "isMinimal"]
+				utils: [
+					"getArgs",
+					"hasFlag",
+					"isMinimal"
+				]
 			});
 		},
 		get children() {
 			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_banner_function_declaration.BannerFunctionDeclaration, { command }),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__shell_shock_core_components_options_parser_logic.OptionsInterfaceDeclaration, { command }),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.cjs","names":["code","computed","For","Show","ElseClause","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","OptionsInterfaceDeclaration","OptionsParserLogic","PositionalOptionsParserLogic","getAppBin","getAppTitle","getPositionalCommandOptionName","isPositionalCommandOption","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","pascalCase","defu","Help","VirtualCommandEntry","CommandInvocation","props","command","_$memo","name","path","segments","filter","segment","length","map","join","_$createIntrinsic","CommandHandlerDeclaration","context","_$createComponent","heading","title","children","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","CommandEntry","imports","builtinImports","rest","filePath","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","env","console","utils","each","Object","values","child","when","isVirtual","fallback"],"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 { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\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  OptionsInterfaceDeclaration,\n  OptionsParserLogic,\n  PositionalOptionsParserLogic\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getAppTitle,\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } 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 { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { Help } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code`return Promise.resolve(handle${pascalCase(command.name)}(options${\n        command.path.segments.filter(segment =>\n          isPositionalCommandOption(segment)\n        ).length > 0\n          ? `, ${command.path.segments\n              .filter(segment => isPositionalCommandOption(segment))\n              .map(segment =>\n                camelCase(getPositionalCommandOptionName(segment))\n              )\n              .join(\", \")}`\n          : \"\"\n      }));`}\n      <hbr />\n    </>\n  );\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(props: { command: CommandTree }) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(\n          context\n        )} ${command.path.segments\n          .map(segment =>\n            isPositionalCommandOption(segment)\n              ? `[${constantCase(getPositionalCommandOptionName(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: \"getArgs()\" }]}>\n        <PositionalOptionsParserLogic\n          path={command.path}\n          envPrefix={context.config.envPrefix}\n        />\n        <hbr />\n        <hbr />\n        <OptionsParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          {code`\n        writeLine(\"\");\n        writeLine(colors.text.heading.primary(\"${getAppTitle(context)} - ${\n          command.title\n        }\"));\n        writeLine(\"\");\n        writeLine(colors.text.body.primary(\"${command.description.replace(\n          /\\.+$/,\n          \"\"\n        )}.\"));\n        writeLine(\"\");`}\n          <hbr />\n          <Help command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.path.segments\n        .filter(segment => !isPositionalCommandOption(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\", \"isCI\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\"getArgs\", \"isMinimal\"]\n        })}>\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} />\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","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","DynamicPathSegmentsParserLogic","OptionsInterfaceDeclaration","OptionsParserLogic","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$memo","name","path","segments","filter","segment","length","map","join","_$createIntrinsic","CommandHandlerDeclaration","children","context","_$createComponent","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","CommandEntry","imports","builtinImports","rest","filePath","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","env","console","utils","each","Object","values","child","when","isVirtual","fallback"],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { 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  DynamicPathSegmentsParserLogic,\n  OptionsInterfaceDeclaration,\n  OptionsParserLogic\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 { CommandTree } 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 { 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      {code`return Promise.resolve(handle${pascalCase(command.name)}(options${\n        command.path.segments.filter(segment => isDynamicPathSegment(segment))\n          .length > 0\n          ? `, ${command.path.segments\n              .filter(segment => isDynamicPathSegment(segment))\n              .map(segment => camelCase(getDynamicPathSegmentName(segment)))\n              .join(\", \")}`\n          : \"\"\n      }));`}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\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, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(\n          context\n        )} ${command.path.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: \"getArgs()\" }]}>\n        <DynamicPathSegmentsParserLogic\n          path={command.path}\n          envPrefix={context.config.envPrefix}\n        />\n        <hbr />\n        <hbr />\n        <OptionsParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        {code`writeLine(\"\");\n        banner();`}\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 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.path.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\", \"isCI\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\"getArgs\", \"hasFlag\", \"isMinimal\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} />\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.d.cts

@@ -1,24 +1,26 @@
-import * as _alloy_js_core13 from "@alloy-js/core";
-import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
+import { Children } from "@alloy-js/core";
 import { CommandTree } from "@shell-shock/core/types/command";
+import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 
 //#region src/components/command-entry.d.ts
 declare function CommandInvocation(props: {
   command: CommandTree;
-}): _alloy_js_core13.Children;
+}): Children;
+interface CommandHandlerDeclarationProps {
+  command: CommandTree;
+  children?: Children;
+}
 /**
  * A component that generates the `handler` function declaration for a command.
  */
-declare function CommandHandlerDeclaration(props: {
-  command: CommandTree;
-}): _alloy_js_core13.Children;
+declare function CommandHandlerDeclaration(props: CommandHandlerDeclarationProps): Children;
 interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinition"> {
   command: CommandTree;
 }
 /**
  * The command entry point for the Shell Shock project.
  */
-declare function CommandEntry(props: CommandEntryProps): _alloy_js_core13.Children;
+declare function CommandEntry(props: CommandEntryProps): Children;
 //#endregion
-export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation };
+export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandHandlerDeclarationProps, CommandInvocation };
 //# sourceMappingURL=command-entry.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAwDgB,iBAAA;WAAoC;IAAW,gBAAA,CAAE;AAAjE;AAyBA;AAgEA;AACE,iBAjEc,yBAAA,CAiEd,KAAA,EAAA;EAGS,OAAA,EApEiD,WAoEjD;CAJgC,CAAA,EAhE4B,gBAAA,CAAE,QAgE9B;AAAI,UAA9B,iBAAA,SAA0B,IAAI,CAC7C,cAD6C,EAAA,MAAA,GAAA,gBAAA,CAAA,CAAA;EAU/B,OAAA,EANL,WAMiB;;;;;iBAAZ,YAAA,QAAoB,oBAAiB,gBAAA,CAAA"}
+{"version":3,"file":"command-entry.d.cts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAyDgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AAmBC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA6DC,QAAA,CAAA,EAnEJ,QAmEI;;;;;AAUD,iBAvEA,yBAAA,CAuEqC,KAAA,EAtE5C,8BAsE4C,CAAA,EAtEd,QAsEc;UAVpC,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}

package/dist/components/command-entry.d.mts

@@ -1,24 +1,26 @@
-import * as _alloy_js_core12 from "@alloy-js/core";
+import { Children } from "@alloy-js/core";
 import { EntryFileProps } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { CommandTree } from "@shell-shock/core/types/command";
 
 //#region src/components/command-entry.d.ts
 declare function CommandInvocation(props: {
   command: CommandTree;
-}): _alloy_js_core12.Children;
+}): Children;
+interface CommandHandlerDeclarationProps {
+  command: CommandTree;
+  children?: Children;
+}
 /**
  * A component that generates the `handler` function declaration for a command.
  */
-declare function CommandHandlerDeclaration(props: {
-  command: CommandTree;
-}): _alloy_js_core12.Children;
+declare function CommandHandlerDeclaration(props: CommandHandlerDeclarationProps): Children;
 interface CommandEntryProps extends Omit<EntryFileProps, "path" | "typeDefinition"> {
   command: CommandTree;
 }
 /**
  * The command entry point for the Shell Shock project.
  */
-declare function CommandEntry(props: CommandEntryProps): _alloy_js_core12.Children;
+declare function CommandEntry(props: CommandEntryProps): Children;
 //#endregion
-export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandInvocation };
+export { CommandEntry, CommandEntryProps, CommandHandlerDeclaration, CommandHandlerDeclarationProps, CommandInvocation };
 //# sourceMappingURL=command-entry.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAwDgB,iBAAA;WAAoC;IAAW,gBAAA,CAAE;AAAjE;AAyBA;AAgEA;AACE,iBAjEc,yBAAA,CAiEd,KAAA,EAAA;EAGS,OAAA,EApEiD,WAoEjD;CAJgC,CAAA,EAhE4B,gBAAA,CAAE,QAgE9B;AAAI,UAA9B,iBAAA,SAA0B,IAAI,CAC7C,cAD6C,EAAA,MAAA,GAAA,gBAAA,CAAA,CAAA;EAU/B,OAAA,EANL,WAMiB;;;;;iBAAZ,YAAA,QAAoB,oBAAiB,gBAAA,CAAA"}
+{"version":3,"file":"command-entry.d.mts","names":[],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":[],"mappings":";;;;;iBAyDgB,iBAAA;WAAoC;AAApD,CAAA,CAAA,EAAiE,QAAjD;AAmBC,UAAA,8BAAA,CAA8B;EAQ/B,OAAA,EAPL,WAOK;EA6DC,QAAA,CAAA,EAnEJ,QAmEI;;;;;AAUD,iBAvEA,yBAAA,CAuEqC,KAAA,EAtE5C,8BAsE4C,CAAA,EAtEd,QAsEc;UAVpC,iBAAA,SAA0B,KACzC;WAGS;;;;;iBAMK,YAAA,QAAoB,oBAAiB"}

package/dist/components/command-entry.mjs

@@ -1,16 +1,17 @@
-import { Help } from "./help.mjs";
+import { BannerFunctionDeclaration } from "./banner-function-declaration.mjs";
+import { CommandHelp } from "./help.mjs";
 import { VirtualCommandEntry } from "./virtual-command-entry.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code, computed } from "@alloy-js/core";
 import { ElseClause, FunctionDeclaration, IfStatement } from "@alloy-js/typescript";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { getAppBin, getAppTitle, getPositionalCommandOptionName, isPositionalCommandOption } from "@shell-shock/core/plugin-utils/context-helpers";
+import { getAppBin, getDynamicPathSegmentName, isDynamicPathSegment } from "@shell-shock/core/plugin-utils/context-helpers";
 import { EntryFile } from "@powerlines/plugin-alloy/typescript/components/entry-file";
 import { TSDoc, TSDocParam, TSDocRemarks, TSDocTitle } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
 import { replaceExtension } from "@stryke/path/replace";
 import { pascalCase } from "@stryke/string-format/pascal-case";
 import defu from "defu";
-import { OptionsInterfaceDeclaration, OptionsParserLogic, PositionalOptionsParserLogic } from "@shell-shock/core/components/options-parser-logic";
+import { DynamicPathSegmentsParserLogic, OptionsInterfaceDeclaration, OptionsParserLogic } from "@shell-shock/core/components/options-parser-logic";
 import { findFilePath, relativePath } from "@stryke/path/find";
 import { joinPaths } from "@stryke/path/join";
 import { camelCase } from "@stryke/string-format/camel-case";
@@ -19,17 +20,17 @@ import { constantCase } from "@stryke/string-format/constant-case";
 //#region src/components/command-entry.tsx
 function CommandInvocation(props) {
 	const { command } = props;
-	return [memo(() => code`return Promise.resolve(handle${pascalCase(command.name)}(options${command.path.segments.filter((segment) => isPositionalCommandOption(segment)).length > 0 ? `, ${command.path.segments.filter((segment) => isPositionalCommandOption(segment)).map((segment) => camelCase(getPositionalCommandOptionName(segment))).join(", ")}` : ""}));`), createIntrinsic("hbr", {})];
+	return [memo(() => code`return Promise.resolve(handle${pascalCase(command.name)}(options${command.path.segments.filter((segment) => isDynamicPathSegment(segment)).length > 0 ? `, ${command.path.segments.filter((segment) => isDynamicPathSegment(segment)).map((segment) => camelCase(getDynamicPathSegmentName(segment))).join(", ")}` : ""}));`), createIntrinsic("hbr", {})];
 }
 /**
 * A component that generates the `handler` function declaration for a command.
 */
 function CommandHandlerDeclaration(props) {
-	const { command } = props;
+	const { command, children } = props;
 	const context = usePowerlines();
 	return [createComponent(TSDoc, {
 		get heading() {
-			return `The ${command.title} (${getAppBin(context)} ${command.path.segments.map((segment) => isPositionalCommandOption(segment) ? `[${constantCase(getPositionalCommandOptionName(segment))}]` : segment).join(" ")}) command.`;
+			return `The ${command.title} (${getAppBin(context)} ${command.path.segments.map((segment) => isDynamicPathSegment(segment) ? `[${constantCase(getDynamicPathSegmentName(segment))}]` : segment).join(" ")}) command.`;
 		},
 		get children() {
 			return [
@@ -57,7 +58,7 @@ function CommandHandlerDeclaration(props) {
 		}],
 		get children() {
 			return [
-				createComponent(PositionalOptionsParserLogic, {
+				createComponent(DynamicPathSegmentsParserLogic, {
 					get path() {
 						return command.path;
 					},
@@ -78,19 +79,17 @@ function CommandHandlerDeclaration(props) {
 				}),
 				createIntrinsic("hbr", {}),
 				createIntrinsic("hbr", {}),
+				code`writeLine("");
+        banner();`,
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				children,
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
 				createComponent(IfStatement, {
 					condition: code`options.help`,
 					get children() {
-						return [
-							memo(() => code`
-        writeLine("");
-        writeLine(colors.text.heading.primary("${getAppTitle(context)} - ${command.title}"));
-        writeLine("");
-        writeLine(colors.text.body.primary("${command.description.replace(/\.+$/, "")}."));
-        writeLine("");`),
-							createIntrinsic("hbr", {}),
-							createComponent(Help, { command })
-						];
+						return createComponent(CommandHelp, { command });
 					}
 				}),
 				createComponent(ElseClause, { get children() {
@@ -106,7 +105,7 @@ function CommandHandlerDeclaration(props) {
 function CommandEntry(props) {
 	const { command, imports, builtinImports, ...rest } = props;
 	const context = usePowerlines();
-	const filePath = computed(() => joinPaths(command.path.segments.filter((segment) => !isPositionalCommandOption(segment)).join("/"), "index.ts"));
+	const filePath = computed(() => joinPaths(command.path.segments.filter((segment) => !isDynamicPathSegment(segment)).join("/"), "index.ts"));
 	const commandSourcePath = computed(() => replaceExtension(relativePath(joinPaths(context.entryPath, findFilePath(filePath.value)), command.entry.input?.file || command.entry.file)));
 	const typeDefinition = computed(() => ({
 		...command.entry,
@@ -134,11 +133,18 @@ function CommandEntry(props) {
 					"writeLine",
 					"splitText"
 				],
-				utils: ["getArgs", "isMinimal"]
+				utils: [
+					"getArgs",
+					"hasFlag",
+					"isMinimal"
+				]
 			});
 		},
 		get children() {
 			return [
+				createComponent(BannerFunctionDeclaration, { command }),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
 				createComponent(OptionsInterfaceDeclaration, { command }),
 				createIntrinsic("hbr", {}),
 				createIntrinsic("hbr", {}),

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

@@ -1 +1 @@
-{"version":3,"file":"command-entry.mjs","names":["code","computed","For","Show","ElseClause","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","OptionsInterfaceDeclaration","OptionsParserLogic","PositionalOptionsParserLogic","getAppBin","getAppTitle","getPositionalCommandOptionName","isPositionalCommandOption","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","pascalCase","defu","Help","VirtualCommandEntry","CommandInvocation","props","command","_$memo","name","path","segments","filter","segment","length","map","join","_$createIntrinsic","CommandHandlerDeclaration","context","_$createComponent","heading","title","children","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","CommandEntry","imports","builtinImports","rest","filePath","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","env","console","utils","each","Object","values","child","when","isVirtual","fallback"],"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 { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\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  OptionsInterfaceDeclaration,\n  OptionsParserLogic,\n  PositionalOptionsParserLogic\n} from \"@shell-shock/core/components/options-parser-logic\";\nimport {\n  getAppBin,\n  getAppTitle,\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport type { CommandTree } 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 { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { Help } from \"./help\";\nimport { VirtualCommandEntry } from \"./virtual-command-entry\";\n\nexport function CommandInvocation(props: { command: CommandTree }) {\n  const { command } = props;\n\n  return (\n    <>\n      {code`return Promise.resolve(handle${pascalCase(command.name)}(options${\n        command.path.segments.filter(segment =>\n          isPositionalCommandOption(segment)\n        ).length > 0\n          ? `, ${command.path.segments\n              .filter(segment => isPositionalCommandOption(segment))\n              .map(segment =>\n                camelCase(getPositionalCommandOptionName(segment))\n              )\n              .join(\", \")}`\n          : \"\"\n      }));`}\n      <hbr />\n    </>\n  );\n}\n\n/**\n * A component that generates the `handler` function declaration for a command.\n */\nexport function CommandHandlerDeclaration(props: { command: CommandTree }) {\n  const { command } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(\n          context\n        )} ${command.path.segments\n          .map(segment =>\n            isPositionalCommandOption(segment)\n              ? `[${constantCase(getPositionalCommandOptionName(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: \"getArgs()\" }]}>\n        <PositionalOptionsParserLogic\n          path={command.path}\n          envPrefix={context.config.envPrefix}\n        />\n        <hbr />\n        <hbr />\n        <OptionsParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        <IfStatement condition={code`options.help`}>\n          {code`\n        writeLine(\"\");\n        writeLine(colors.text.heading.primary(\"${getAppTitle(context)} - ${\n          command.title\n        }\"));\n        writeLine(\"\");\n        writeLine(colors.text.body.primary(\"${command.description.replace(\n          /\\.+$/,\n          \"\"\n        )}.\"));\n        writeLine(\"\");`}\n          <hbr />\n          <Help command={command} />\n        </IfStatement>\n        <ElseClause>\n          <hbr />\n          <CommandInvocation command={command} />\n        </ElseClause>\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport interface CommandEntryProps extends Omit<\n  EntryFileProps,\n  \"path\" | \"typeDefinition\"\n> {\n  command: CommandTree;\n}\n\n/**\n * The command entry point for the Shell Shock project.\n */\nexport function CommandEntry(props: CommandEntryProps) {\n  const { command, imports, builtinImports, ...rest } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n  const filePath = computed(() =>\n    joinPaths(\n      command.path.segments\n        .filter(segment => !isPositionalCommandOption(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\", \"isCI\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\"getArgs\", \"isMinimal\"]\n        })}>\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} />\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","FunctionDeclaration","IfStatement","usePowerlines","EntryFile","TSDoc","TSDocParam","TSDocRemarks","TSDocTitle","DynamicPathSegmentsParserLogic","OptionsInterfaceDeclaration","OptionsParserLogic","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","findFilePath","relativePath","joinPaths","replaceExtension","camelCase","constantCase","pascalCase","defu","BannerFunctionDeclaration","CommandHelp","VirtualCommandEntry","CommandInvocation","props","command","_$memo","name","path","segments","filter","segment","length","map","join","_$createIntrinsic","CommandHandlerDeclaration","children","context","_$createComponent","heading","title","description","replace","async","parameters","type","default","envPrefix","config","isCaseSensitive","condition","CommandEntry","imports","builtinImports","rest","filePath","commandSourcePath","entryPath","value","entry","input","file","typeDefinition","output","id","_$mergeProps","env","console","utils","each","Object","values","child","when","isVirtual","fallback"],"sources":["../../src/components/command-entry.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Children } from \"@alloy-js/core\";\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  FunctionDeclaration,\n  IfStatement\n} from \"@alloy-js/typescript\";\nimport { 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  DynamicPathSegmentsParserLogic,\n  OptionsInterfaceDeclaration,\n  OptionsParserLogic\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 { CommandTree } 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 { 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      {code`return Promise.resolve(handle${pascalCase(command.name)}(options${\n        command.path.segments.filter(segment => isDynamicPathSegment(segment))\n          .length > 0\n          ? `, ${command.path.segments\n              .filter(segment => isDynamicPathSegment(segment))\n              .map(segment => camelCase(getDynamicPathSegmentName(segment)))\n              .join(\", \")}`\n          : \"\"\n      }));`}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandHandlerDeclarationProps {\n  command: CommandTree;\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, children } = props;\n\n  const context = usePowerlines<ScriptPresetContext>();\n\n  return (\n    <>\n      <TSDoc\n        heading={`The ${command.title} (${getAppBin(\n          context\n        )} ${command.path.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: \"getArgs()\" }]}>\n        <DynamicPathSegmentsParserLogic\n          path={command.path}\n          envPrefix={context.config.envPrefix}\n        />\n        <hbr />\n        <hbr />\n        <OptionsParserLogic\n          command={command}\n          envPrefix={context.config.envPrefix}\n          isCaseSensitive={context.config.isCaseSensitive}\n        />\n        <hbr />\n        <hbr />\n        {code`writeLine(\"\");\n        banner();`}\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 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.path.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\", \"isCI\"],\n          console: [\n            \"warn\",\n            \"error\",\n            \"table\",\n            \"colors\",\n            \"stripAnsi\",\n            \"writeLine\",\n            \"splitText\"\n          ],\n          utils: [\"getArgs\", \"hasFlag\", \"isMinimal\"]\n        })}>\n        <BannerFunctionDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <OptionsInterfaceDeclaration command={command} />\n        <hbr />\n        <hbr />\n        <CommandHandlerDeclaration command={command} />\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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"}