@shell-shock/core 0.17.8 → 0.17.10

package/dist/plugin-utils/type-checks.mjs

@@ -1,2 +1,89 @@
-import{CommandParameterKinds as e}from"../types/command.mjs";import{isSetString as t}from"@stryke/type-checks/is-set-string";import{isSetObject as n}from"@stryke/type-checks/is-set-object";import{isBoolean as r}from"@stryke/type-checks/is-boolean";function i(n){return t(n)&&[e.string,e.number,e.boolean].includes(n)}i.__type=[`obj`,`isCommandParameterKind`,`Type guard to check if a value is a valid {@link CommandParameterKind} type.`,`P"2!!/"?#`];function a(e){return n(e)&&`kind`in e&&i(e.kind)}a.__type=[`obj`,`isCommandParameterConfig`,`Type guard to check if a value is a valid {@link CommandParameterConfig} type.`,`P"2!!/"?#`];function o(e){return a(e)&&`name`in e&&t(e.name)&&`title`in e&&t(e.title)&&`description`in e&&t(e.description)&&`alias`in e&&Array.isArray(e.alias)&&`env`in e&&(t(e.env)||e.env===!1)&&`optional`in e&&r(e.optional)&&`variadic`in e&&r(e.variadic)}o.__type=[`obj`,`isCommandParameter`,`Type guard to check if a value is a valid {@link CommandParameter} type.`,`P"2!!/"?#`];function s(e){return a(e)&&o(e)&&`default`in e}s.__type=[`obj`,`isCommandOption`,`Type guard to check if a value is a valid {@link CommandOption} type.`,`P"2!!/"?#`];function c(e){return a(e)&&o(e)}c.__type=[`obj`,`isCommandArgument`,`Type guard to check if a value is a valid {@link CommandArgument} type.`,`P"2!!/"?#`];export{c as isCommandArgument,s as isCommandOption,o as isCommandParameter,a as isCommandParameterConfig,i as isCommandParameterKind};
+import { CommandParameterKinds } from "../types/command.mjs";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isBoolean } from "@stryke/type-checks/is-boolean";
+
+//#region src/plugin-utils/type-checks.ts
+/**
+* Type guard to check if a value is a valid {@link CommandParameterKind} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.
+*/
+function isCommandParameterKind(obj) {
+	return isSetString(obj) && [
+		CommandParameterKinds.string,
+		CommandParameterKinds.number,
+		CommandParameterKinds.boolean
+	].includes(obj);
+}
+isCommandParameterKind.__type = [
+	"obj",
+	"isCommandParameterKind",
+	"Type guard to check if a value is a valid {@link CommandParameterKind} type.",
+	"P\"2!!/\"?#"
+];
+/**
+* Type guard to check if a value is a valid {@link CommandParameterConfig} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.
+*/
+function isCommandParameterConfig(obj) {
+	return isSetObject(obj) && "kind" in obj && isCommandParameterKind(obj.kind);
+}
+isCommandParameterConfig.__type = [
+	"obj",
+	"isCommandParameterConfig",
+	"Type guard to check if a value is a valid {@link CommandParameterConfig} type.",
+	"P\"2!!/\"?#"
+];
+/**
+* Type guard to check if a value is a valid {@link CommandParameter} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandParameter} type, false otherwise.
+*/
+function isCommandParameter(obj) {
+	return isCommandParameterConfig(obj) && "name" in obj && isSetString(obj.name) && "title" in obj && isSetString(obj.title) && "description" in obj && isSetString(obj.description) && "alias" in obj && Array.isArray(obj.alias) && "env" in obj && (isSetString(obj.env) || obj.env === false) && "optional" in obj && isBoolean(obj.optional) && "variadic" in obj && isBoolean(obj.variadic);
+}
+isCommandParameter.__type = [
+	"obj",
+	"isCommandParameter",
+	"Type guard to check if a value is a valid {@link CommandParameter} type.",
+	"P\"2!!/\"?#"
+];
+/**
+* Type guard to check if a value is a valid {@link CommandOption} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandOption} type, false otherwise.
+*/
+function isCommandOption(obj) {
+	return isCommandParameterConfig(obj) && isCommandParameter(obj) && "default" in obj;
+}
+isCommandOption.__type = [
+	"obj",
+	"isCommandOption",
+	"Type guard to check if a value is a valid {@link CommandOption} type.",
+	"P\"2!!/\"?#"
+];
+/**
+* Type guard to check if a value is a valid {@link CommandArgument} type.
+*
+* @param obj - The value to check.
+* @returns True if the value is a valid {@link CommandArgument} type, false otherwise.
+*/
+function isCommandArgument(obj) {
+	return isCommandParameterConfig(obj) && isCommandParameter(obj);
+}
+isCommandArgument.__type = [
+	"obj",
+	"isCommandArgument",
+	"Type guard to check if a value is a valid {@link CommandArgument} type.",
+	"P\"2!!/\"?#"
+];
+
+//#endregion
+export { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind };
 //# sourceMappingURL=type-checks.mjs.map

package/dist/plugin-utils/type-checks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-checks.mjs","names":[],"sources":["../../src/plugin-utils/type-checks.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":"wPA2BA,SAAgB,EAAS,EAAA,CACzB,OAAS,EAAA,EAAA,EAAA,CAAqB,EAAkB,OAAQ,EAAA,OAAA,EAAA,QAAA,CAAA,SAAA,EAAA,CAExD,EAAE,OAAA,CAAA,MAAA,yBAAA,+EAAA,YAAA,CAOF,SAAS,EAAA,EAAA,CACP,OAAE,EAAiB,EAAC,EAAA,SAAA,GAAA,EAAA,EAAA,KAAA,CAEtB,EAAM,OAA4B,CAAA,MAAA,2BAAA,iFAAA,YAAA,CAOlC,SAAE,EAAA,EAAA,CACA,OAAM,EAA0B,EAAI,EAAC,SAAa,GAAA,EAAA,EAAuB,KAAK,EAAA,UAAA,GAAA,EAAA,EAAA,MAAA,EAAA,gBAAA,GAAA,EAAA,EAAA,YAAA,EAAA,UAAA,GAAA,MAAA,QAAA,EAAA,MAAA,EAAA,QAAA,IAAA,EAAA,EAAA,IAAA,EAAA,EAAA,MAAA,KAAA,aAAA,GAAA,EAAA,EAAA,SAAA,EAAA,aAAA,GAAA,EAAA,EAAA,SAAA,CAEhF,EAAmB,OAAS,CAAC,MAAK,qBAAA,2EAAA,YAAA,CAOlC,SAAA,EAAA,EAAA,kCAGA,EAAgB,OAAS,CAAC,MAAO,kBAAmB,wEAAsB,YAAA,CAO1E,SAAI,EAA8B,EAAC,CACjC,OAAO,EAAU,EAAA,EAAA,EAAA,EAAA,CAEnB,EAAkB,OAAE,CAAA,MAAA,oBAAA,0EAAA,YAAA"}
+{"version":3,"file":"type-checks.mjs","names":[],"sources":["../../src/plugin-utils/type-checks.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":";;;;;;;;;;;;AA2BA,SAAgB,uBAAS,KAAA;AACzB,QAAS,YAAA,IAAA,IAAA;EAAqB,sBAAkB;EAAQ,sBAAA;EAAA,sBAAA;EAAA,CAAA,SAAA,IAAA;;AAExD,uBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,SAAS,yBAAA,KAAA;AACP,QAAE,YAAiB,IAAC,IAAA,UAAA,OAAA,uBAAA,IAAA,KAAA;;AAEtB,yBAAM,SAA4B;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOlC,SAAE,mBAAA,KAAA;AACA,QAAM,yBAA0B,IAAI,IAAC,UAAa,OAAA,YAAA,IAAuB,KAAK,IAAA,WAAA,OAAA,YAAA,IAAA,MAAA,IAAA,iBAAA,OAAA,YAAA,IAAA,YAAA,IAAA,WAAA,OAAA,MAAA,QAAA,IAAA,MAAA,IAAA,SAAA,QAAA,YAAA,IAAA,IAAA,IAAA,IAAA,QAAA,UAAA,cAAA,OAAA,UAAA,IAAA,SAAA,IAAA,cAAA,OAAA,UAAA,IAAA,SAAA;;AAEhF,mBAAmB,SAAS;CAAC;CAAK;CAAA;CAAA;CAAA;;;;;;;AAOlC,SAAA,gBAAA,KAAA;;;AAGA,gBAAgB,SAAS;CAAC;CAAO;CAAmB;CAAsB;CAAA;;;;;;;AAO1E,SAAI,kBAA8B,KAAC;AACjC,QAAO,yBAAU,IAAA,IAAA,mBAAA,IAAA;;AAEnB,kBAAkB,SAAE;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/plugin.cjs

@@ -1,4 +1,471 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require(`./_virtual/_rolldown/runtime.cjs`),t=require(`./plugin-utils/context-helpers.cjs`),n=require(`./components/docs.cjs`),r=require(`./components/exec-builtin.cjs`),i=require(`./plugin-utils/deepkit.cjs`),a=require(`./plugin-utils/traverse-command-tree.cjs`),o=require(`./plugin-utils/get-command-tree.cjs`);require(`./plugin-utils/index.cjs`);const s=require(`./components/state-builtin.cjs`),c=require(`./components/utils-builtin.cjs`),l=require(`./helpers/automd.cjs`),u=require(`./helpers/paths.cjs`),d=require(`./helpers/persistence.cjs`),f=require(`./helpers/update-package-json.cjs`),p=require(`./helpers/utilities.cjs`),m=require(`./helpers/validations.cjs`),h=require(`./resolver/resolve.cjs`);let g=require(`@alloy-js/core/jsx-runtime`),_=require(`@alloy-js/core/components`),v=require(`@powerlines/deepkit/vendor/type`),y=require(`@powerlines/plugin-alloy`);y=e.__toESM(y);let b=require(`@powerlines/plugin-alloy/render`),x=require(`@powerlines/plugin-automd`);x=e.__toESM(x);let S=require(`@powerlines/plugin-env/helpers`),C=require(`@powerlines/plugin-nodejs`);C=e.__toESM(C);let w=require(`@powerlines/plugin-tsdown`);w=e.__toESM(w);let T=require(`@stryke/convert/to-array`),E=require(`@stryke/fs/chmod-x`),D=require(`@stryke/path/append`),O=require(`@stryke/path/file-path-fns`),k=require(`@stryke/path/is-parent-path`),A=require(`@stryke/path/join-paths`),j=require(`@stryke/path/replace`),M=require(`@stryke/path/resolve-parent-path`),N=require(`@stryke/string-format/camel-case`),P=require(`@stryke/string-format/constant-case`),F=require(`@stryke/string-format/kebab-case`),I=require(`@stryke/type-checks/is-object`),L=require(`@stryke/type-checks/is-set-string`),R=require(`defu`),z=require(`powerlines/utils`);function B(e,t){return e.__type=t,e}const V=B((e={})=>[...(y.default.Ω=[[`Context`,`"w!`]],(0,y.default)()),(w.default.Ω=[[`Context`,`"w!`]],(0,w.default)()),(x.default.Ω=[[`Context`,`"w!`]],(0,x.default)()),{name:`shell-shock:config`,config:B(async function(){return this.debug(`Resolving the Shell Shock configuration.`),(0,R.defu)(e,{name:t.getAppName(this),title:t.getAppTitle(this),description:t.getAppDescription(this),platform:`node`,projectType:`application`,framework:`shell-shock`,isCaseSensitive:!1,output:{format:`esm`,dts:!1},input:!this.config.input||Array.isArray(this.config.input)&&this.config.input.length===0||(0,I.isObject)(this.config.input)&&Object.keys(this.config.input).length===0?[`src/**/command.ts`,`src/**/command.tsx`]:void 0,resolve:{external:[`@powerlines/deepkit`],skipNodeModulesBundle:!0},tsdown:{dts:!1,nodeProtocol:!0,unbundle:!1}})},[`config`,`P"/!`]),configResolved:{order:`pre`,async handler(){this.debug(`Shell Shock configuration has been resolved.`),await f.updatePackageJsonBinary(this),this.config.appSpecificEnvPrefix=(0,L.isSetString)(this.config.autoAssignEnv)?this.config.autoAssignEnv:(0,P.constantCase)(t.getAppName(this)),(!this.config.env.prefix||!Array.isArray(this.config.env.prefix))&&(this.config.env.prefix=(0,T.toArray)(this.config.env.prefix)),this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)||this.config.env.prefix.push(this.config.appSpecificEnvPrefix),this.config.bin=((0,L.isSetString)(this.packageJson.bin)?{[(0,F.kebabCase)(this.config.name)]:this.packageJson.bin}:this.packageJson.bin)??{[(0,F.kebabCase)(this.config.name)]:f.formatBinaryPath(this.config.output.format)},(0,L.isSetString)(this.config.reference)&&(this.config.reference.includes(`{command}`)?this.config.reference={app:this.config.reference.substring(0,this.config.reference.indexOf(`{command}`)).replace(/\/?$/,`/`),commands:this.config.reference}:this.config.reference.includes(`{commands}`)?this.config.reference={app:this.config.reference.substring(0,this.config.reference.indexOf(`{commands}`)).replace(/\/?$/,`/`),commands:this.config.reference}:this.config.reference={app:this.config.reference}),this.inputs??=[],this.globalOptions=Object.values(p.getGlobalOptions(this,{id:null,name:this.config.name,path:null,segments:[],title:this.config.title,description:this.config.description,alias:[],isVirtual:!1})),this.globalOptions=this.globalOptions.map(B(e=>({...e,name:(0,N.camelCase)(e.name),alias:e.alias??[],optional:e.optional??!1}),[`option`,``,`P"2!"/"`]))}}},...(C.default.Ω=[[`Context`,`"w!`]],(0,C.default)((0,R.defu)(e??{},{env:{types:`@shell-shock/core/types/env#ShellShockEnv`,validate:!1}}))),{name:`shell-shock:inputs`,async configResolved(){this.debug(`Checking for commands using input: ${JSON.stringify(this.config.input)}`),this.commandsPath=await u.findCommandsRoot(this),this.debug(`Resolved commands root path: ${this.commandsPath}`);let e=await(0,z.resolveInputs)(this,this.config.input);this.debug(`Found ${e.length} entry points specified in the configuration options.`),this.inputs=e.reduce(B((e,n)=>{if(n.file!==this.commandsPath&&!(0,k.isParentPath)(n.file,this.commandsPath))throw Error(`Command entry point "${n.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);let r=u.resolveCommandId(this,n.file);if(!e.some(B(e=>e.id===r,[`existing`,``,`P"2!"/"`]))){let i=u.resolveCommandName(n.file),a=u.resolveCommandPath(this,n.file).split(`/`).filter(Boolean);a=a.map(B((e,n)=>{let r=a.findIndex(B(t=>t===e,[`existing`,``,`P"2!"/"`]));return r!==-1&&r!==n&&(e+=`_${a.filter(B(e=>t.isDynamicPathSegment(e)&&t.getDynamicPathSegmentName(e).replace(/_\d+$/,``)===e,[`segment`,``,`P"2!"/"`])).length}`),e},[`segment`,`index`,``,`P"2!"2""/#`])),e.push({id:r,path:a.join(`/`),segments:a,name:i,alias:[],tags:[],isVirtual:!1,source:`file`,entry:{...n,file:n.file,input:{file:n.file,name:n.name},output:i}})}return e},[`ret`,`entry`,``,`P"2!"2""/#`]),this.inputs),this.debug(`Shell Shock will process ${this.inputs.length} command entry files: \n${this.inputs.map(B(e=>` - ${e.id}: ${(0,j.replacePath)(e.entry.file,this.commandsPath)}`,[`command`,``,`P"2!"/"`])).join(`
-`)}`)},prepare:B(async function(){return this.debug(`Rendering base built-in modules for the Shell Shock application.`),(0,b.render)(this,[(0,g.createComponent)(s.StateBuiltin,{}),(0,g.createComponent)(c.UtilsBuiltin,{}),(0,g.createComponent)(r.ExecBuiltin,{})])},[`prepare`,`P"/!`])},{name:`shell-shock:virtual-inputs`,configResolved:{order:`post`,async handler(){this.inputs.length===0?this.warn(`No commands were found in the project. Please ensure at least one command exists.`):(this.debug(`Finding and adding virtual command inputs for each command previously found.`),this.inputs=this.inputs.reduce(B((e,n)=>{let r=0,i=(0,M.resolveParentPath)((0,O.findFilePath)(n.entry.file));if((0,k.isParentPath)(i,this.commandsPath))for(;i!==this.commandsPath;){if(r++>50)throw Error(`Unable to process virtual commands for ${n.name} \n\nPlease ensure ${n.entry.file} is a valid command entry file and does not have an invalid path.`);if(!e.some(B(e=>(0,O.findFilePath)(e.entry.file)===i,[`existing`,``,`P"2!"/"`]))){let n=(0,A.joinPaths)(i,`command.ts`),r=u.resolveCommandId(this,n);if(!e.some(B(e=>e.id===r,[`existing`,``,`P"2!"/"`]))){let i=u.resolveCommandName(n),a=u.resolveCommandPath(this,n).split(`/`).filter(Boolean);a=a.map(B((e,n)=>{let r=a.findIndex(B(t=>t===e,[`existing`,``,`P"2!"/"`]));return r!==-1&&r!==n&&(e+=`_${a.filter(B(e=>t.isDynamicPathSegment(e)&&t.getDynamicPathSegmentName(e).replace(/_\d+$/,``)===e,[`segment`,``,`P"2!"/"`])).length}`),e},[`segment`,`index`,``,`P"2!"2""/#`])),e.push({id:r,path:a.join(`/`),segments:a,name:i,alias:[],tags:[],isVirtual:!0,entry:{file:n},source:`file`})}}i=(0,M.resolveParentPath)(i)}return e},[`ret`,`command`,``,`P"2!"2""/#`]),this.inputs).sort(B((e,t)=>e.segments.length-t.segments.length,[`a`,`b`,``,`P"2!"2""/#`])),this.debug(`Final command input list: \n${this.inputs.map(B(e=>` - ${e.id}${e.isVirtual?` (virtual)`:``}: ${e.source===`file`?(0,j.replacePath)(e.entry.file,this.commandsPath):`added by ${e.source}`}`,[`command`,``,`P"2!"/"`])).join(`
-`)}`))}}},{name:`shell-shock:update-env`,configResolved:{order:`post`,async handler(){this.debug(`Adding global options to the CLI application's environment variables.`);for(let e of Object.values(this.globalOptions).filter(B(e=>!!e.env,[`option`,``,`P"2!"/"`])).filter(B(e=>!this.env.types.env.getPropertyOrUndefined(e.env),[`option`,``,`P"2!"/"`])))this.env.types.env.addProperty({name:e.env,optional:e.optional?!0:void 0,description:e.description,visibility:v.ReflectionVisibility.public,type:i.extractType(e),default:e.default,tags:{title:e.title,alias:e.alias.filter(B(e=>e.length>1,[`alias`,``,`P"2!"/"`])).map(B(e=>(0,P.constantCase)(e),[`alias`,``,`P"2!"/"`])),domain:`cli`}});await(0,S.writeEnvTypeReflection)(this,this.env.types.env,`env`)}}},{name:`shell-shock:resolve-commands`,prepare:{order:`post`,async handler(){if(this.debug(`Initializing the CLI application's command tree.`),this.commands={},this.config.command!==`prepare`&&this.config.skipCache!==!0&&this.persistedMeta?.checksum===this.meta.checksum&&this.fs.existsSync(d.getCommandsPersistencePath(this)))this.debug(`Skipping command resolution as the meta checksum has not changed.`),await d.readCommandsPersistence(this);else{for(let e of this.inputs.filter(B(e=>e.segments.filter(B(e=>!t.isDynamicPathSegment(e)&&!t.isPathSegmentGroup(e),[`segment`,``,`P"2!"/"`])).length===1,[`input`,``,`P"2!"/"`])))this.commands[e.name]=await h.resolve({context:this,command:e});this.debug(`Post-processing commands to ensure proper reflection.`),await a.traverseCommands(this,B(e=>{e.options=Object.fromEntries(Object.entries(e.options).map(B(([e,t])=>[(0,N.camelCase)(e),{...t,name:(0,N.camelCase)(e),alias:t.alias??[],optional:t.optional??!1}],[`param0`,``,`P"2!"/"`])))},[`command`,``,`P"2!"/"`])),await d.writeCommandsPersistence(this)}this.debug(`Validating the CLI applications command tree.`);let e=!0;if(await a.traverseCommands(this,B(t=>{let n=m.validateCommand(t);n.length>0&&(this.error(`Found ${n.length} issue${n.length>1?`s`:``} with the ${t.title} command: \n${n.map(B(e=>` - ${e.code}: ${e.details}`,[`failure`,``,`P"2!"/"`])).join(`
-`)}\n`),e=!1)},[`command`,``,`P"2!"/"`])),!e)throw Error(`One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`);this.info(`\nCreating an application with the following command tree: \n${p.formatCommandTree(this)}\n`)}}},{name:`shell-shock:chmod+x`,configResolved(){this.config.tsdown.hooks??={},this.config.tsdown.hooks[`build:done`]=B(async e=>{await Promise.all(Object.values(this.config.bin).map(B(async e=>{let t=(0,D.appendPath)(e,(0,A.joinPaths)(this.config.cwd,this.config.root));if(this.fs.existsSync(t)){this.debug(`Adding hashbang to binary executable output file: ${t}`);let e=await this.fs.read(t);e&&!e.startsWith(`#!`)&&await this.fs.write(t,`#!/usr/bin/env ${this.config.mode===`development`?`-S NODE_OPTIONS=--enable-source-maps`:``} node\n\n${e}`),this.debug(`Adding executable permissions (chmod+x) to binary executable output file: ${t}`),await(0,E.chmodX)(t)}else this.warn(`Expected binary output file not found at path: ${t}. Skipping adding hashbang and executable permissions (chmod+x).`)},[`bin`,``,`P"2!"/"`])))},[`chunks`,`_`,``,`PP!P!F4!MK2""/#`])}},{name:`shell-shock:docs`,configResolved:B(function(){this.config.automd??={},this.config.automd.generators={...this.config.automd.generators??{},commands:l.commands(this)}},[`configResolved`,`P"/!`]),async docs(){this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");let e=this.inputs.map(B(e=>o.getCommandTree(this,e.segments),[`input`,``,`P"2!"/"`])).filter(Boolean);return(0,b.render)(this,(0,g.createComponent)(_.For,{get each(){return Object.values(e)},doubleHardline:!0,get children(){return B(e=>(0,g.createComponent)(_.Show,{get when(){return!e.isVirtual},get children(){return(0,g.createComponent)(n.CommandDocsFile,{command:e})}}),[`child`,``,`P"2!"/"`])}}))}}],[`Options`,`options`,()=>({}),``,`P"w!2">#!F/$`]);exports.default=V,exports.plugin=V;
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_context_helpers = require('./plugin-utils/context-helpers.cjs');
+const require_components_docs = require('./components/docs.cjs');
+const require_components_exec_builtin = require('./components/exec-builtin.cjs');
+const require_deepkit = require('./plugin-utils/deepkit.cjs');
+const require_traverse_command_tree = require('./plugin-utils/traverse-command-tree.cjs');
+const require_get_command_tree = require('./plugin-utils/get-command-tree.cjs');
+require('./plugin-utils/index.cjs');
+const require_components_state_builtin = require('./components/state-builtin.cjs');
+const require_components_utils_builtin = require('./components/utils-builtin.cjs');
+const require_automd = require('./helpers/automd.cjs');
+const require_paths = require('./helpers/paths.cjs');
+const require_persistence = require('./helpers/persistence.cjs');
+const require_update_package_json = require('./helpers/update-package-json.cjs');
+const require_utilities = require('./helpers/utilities.cjs');
+const require_validations = require('./helpers/validations.cjs');
+const require_resolve = require('./resolver/resolve.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core_components = require("@alloy-js/core/components");
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
+let _powerlines_plugin_automd = require("@powerlines/plugin-automd");
+_powerlines_plugin_automd = require_runtime.__toESM(_powerlines_plugin_automd);
+let _powerlines_plugin_env_helpers = require("@powerlines/plugin-env/helpers");
+let _powerlines_plugin_nodejs = require("@powerlines/plugin-nodejs");
+_powerlines_plugin_nodejs = require_runtime.__toESM(_powerlines_plugin_nodejs);
+let _powerlines_plugin_tsdown = require("@powerlines/plugin-tsdown");
+_powerlines_plugin_tsdown = require_runtime.__toESM(_powerlines_plugin_tsdown);
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
+let _stryke_fs_chmod_x = require("@stryke/fs/chmod-x");
+let _stryke_path_append = require("@stryke/path/append");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let _stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_path_resolve_parent_path = require("@stryke/path/resolve-parent-path");
+let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+let _stryke_type_checks_is_object = require("@stryke/type-checks/is-object");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let defu = require("defu");
+let powerlines_utils = require("powerlines/utils");
+
+//#region src/plugin.tsx
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const MAX_DEPTH = 50;
+/**
+* The core Powerlines plugin to build Shell Shock projects.
+*/
+const plugin = __assignType((options = {}) => {
+	return [
+		(_powerlines_plugin_tsdown.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_tsdown.default)()),
+		(_powerlines_plugin_automd.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_automd.default)()),
+		{
+			name: "shell-shock:config",
+			config: __assignType(async function config() {
+				this.debug("Resolving the Shell Shock configuration.");
+				return (0, defu.defu)(options, {
+					name: require_context_helpers.getAppName(this),
+					title: require_context_helpers.getAppTitle(this),
+					description: require_context_helpers.getAppDescription(this),
+					platform: "node",
+					projectType: "application",
+					framework: "shell-shock",
+					isCaseSensitive: false,
+					output: {
+						format: "esm",
+						dts: false
+					},
+					input: !this.config.input || Array.isArray(this.config.input) && this.config.input.length === 0 || (0, _stryke_type_checks_is_object.isObject)(this.config.input) && Object.keys(this.config.input).length === 0 ? ["src/**/command.ts", "src/**/command.tsx"] : void 0,
+					resolve: {
+						external: ["@powerlines/deepkit"],
+						skipNodeModulesBundle: true
+					},
+					tsdown: {
+						dts: false,
+						nodeProtocol: true,
+						unbundle: false
+					}
+				});
+			}, ["config", "P\"/!"]),
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.debug("Shell Shock configuration has been resolved.");
+					await require_update_package_json.updatePackageJsonBinary(this);
+					this.config.appSpecificEnvPrefix = (0, _stryke_type_checks_is_set_string.isSetString)(this.config.autoAssignEnv) ? this.config.autoAssignEnv : (0, _stryke_string_format_constant_case.constantCase)(require_context_helpers.getAppName(this));
+					if (!this.config.env.prefix || !Array.isArray(this.config.env.prefix)) this.config.env.prefix = (0, _stryke_convert_to_array.toArray)(this.config.env.prefix);
+					if (!this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)) this.config.env.prefix.push(this.config.appSpecificEnvPrefix);
+					this.config.bin = ((0, _stryke_type_checks_is_set_string.isSetString)(this.packageJson.bin) ? { [(0, _stryke_string_format_kebab_case.kebabCase)(this.config.name)]: this.packageJson.bin } : this.packageJson.bin) ?? { [(0, _stryke_string_format_kebab_case.kebabCase)(this.config.name)]: require_update_package_json.formatBinaryPath(this.config.output.format) };
+					if ((0, _stryke_type_checks_is_set_string.isSetString)(this.config.reference)) if (this.config.reference.includes("{command}")) this.config.reference = {
+						app: this.config.reference.substring(0, this.config.reference.indexOf("{command}")).replace(/\/?$/, "/"),
+						commands: this.config.reference
+					};
+					else if (this.config.reference.includes("{commands}")) this.config.reference = {
+						app: this.config.reference.substring(0, this.config.reference.indexOf("{commands}")).replace(/\/?$/, "/"),
+						commands: this.config.reference
+					};
+					else this.config.reference = { app: this.config.reference };
+					this.inputs ??= [];
+					this.globalOptions = Object.values(require_utilities.getGlobalOptions(this, {
+						id: null,
+						name: this.config.name,
+						path: null,
+						segments: [],
+						title: this.config.title,
+						description: this.config.description,
+						alias: [],
+						isVirtual: false
+					}));
+					this.globalOptions = this.globalOptions.map(__assignType((option) => ({
+						...option,
+						name: (0, _stryke_string_format_camel_case.camelCase)(option.name),
+						alias: option.alias ?? [],
+						optional: option.optional ?? false
+					}), [
+						"option",
+						"",
+						"P\"2!\"/\""
+					]));
+				}
+			}
+		},
+		...(_powerlines_plugin_nodejs.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_nodejs.default)((0, defu.defu)(options ?? {}, { env: {
+			types: "@shell-shock/core/types/env#ShellShockEnv",
+			validate: false
+		} }))),
+		{
+			name: "shell-shock:inputs",
+			async configResolved() {
+				this.debug(`Checking for commands using input: ${JSON.stringify(this.config.input)}`);
+				this.commandsPath = await require_paths.findCommandsRoot(this);
+				this.debug(`Resolved commands root path: ${this.commandsPath}`);
+				const inputs = await (0, powerlines_utils.resolveInputs)(this, this.config.input);
+				this.debug(`Found ${inputs.length} entry points specified in the configuration options.`);
+				this.inputs = inputs.reduce(__assignType((ret, entry) => {
+					if (entry.file !== this.commandsPath && !(0, _stryke_path_is_parent_path.isParentPath)(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+					const id = require_paths.resolveCommandId(this, entry.file);
+					if (!ret.some(__assignType((existing) => existing.id === id, [
+						"existing",
+						"",
+						"P\"2!\"/\""
+					]))) {
+						const name = require_paths.resolveCommandName(entry.file);
+						let segments = require_paths.resolveCommandPath(this, entry.file).split("/").filter(Boolean);
+						segments = segments.map(__assignType((segment, index) => {
+							const found = segments.findIndex(__assignType((existing) => existing === segment, [
+								"existing",
+								"",
+								"P\"2!\"/\""
+							]));
+							if (found !== -1 && found !== index) segment += `_${segments.filter(__assignType((segment) => require_context_helpers.isDynamicPathSegment(segment) && require_context_helpers.getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === segment, [
+								"segment",
+								"",
+								"P\"2!\"/\""
+							])).length}`;
+							return segment;
+						}, [
+							"segment",
+							"index",
+							"",
+							"P\"2!\"2\"\"/#"
+						]));
+						ret.push({
+							id,
+							path: segments.join("/"),
+							segments,
+							name,
+							alias: [],
+							tags: [],
+							isVirtual: false,
+							source: "file",
+							entry: {
+								...entry,
+								file: entry.file,
+								input: {
+									file: entry.file,
+									name: entry.name
+								},
+								output: name
+							}
+						});
+					}
+					return ret;
+				}, [
+					"ret",
+					"entry",
+					"",
+					"P\"2!\"2\"\"/#"
+				]), this.inputs);
+				this.debug(`Shell Shock will process ${this.inputs.length} command entry files: \n${this.inputs.map(__assignType((command) => ` - ${command.id}: ${(0, _stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}`, [
+					"command",
+					"",
+					"P\"2!\"/\""
+				])).join("\n")}`);
+			},
+			prepare: __assignType(async function prepare() {
+				this.debug("Rendering base built-in modules for the Shell Shock application.");
+				return (0, _powerlines_plugin_alloy_render.render)(this, [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_state_builtin.StateBuiltin, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_utils_builtin.UtilsBuiltin, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_exec_builtin.ExecBuiltin, {})
+				]);
+			}, ["prepare", "P\"/!"])
+		},
+		{
+			name: "shell-shock:virtual-inputs",
+			configResolved: {
+				order: "post",
+				async handler() {
+					if (this.inputs.length === 0) this.warn("No commands were found in the project. Please ensure at least one command exists.");
+					else {
+						this.debug("Finding and adding virtual command inputs for each command previously found.");
+						this.inputs = this.inputs.reduce(__assignType((ret, command) => {
+							let depth = 0;
+							let parentPath = (0, _stryke_path_resolve_parent_path.resolveParentPath)((0, _stryke_path_file_path_fns.findFilePath)(command.entry.file));
+							if ((0, _stryke_path_is_parent_path.isParentPath)(parentPath, this.commandsPath)) while (parentPath !== this.commandsPath) {
+								if (depth++ > MAX_DEPTH) throw new Error(`Unable to process virtual commands for ${command.name} \n\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`);
+								if (!ret.some(__assignType((existing) => (0, _stryke_path_file_path_fns.findFilePath)(existing.entry.file) === parentPath, [
+									"existing",
+									"",
+									"P\"2!\"/\""
+								]))) {
+									const file = (0, _stryke_path_join_paths.joinPaths)(parentPath, "command.ts");
+									const id = require_paths.resolveCommandId(this, file);
+									if (!ret.some(__assignType((existing) => existing.id === id, [
+										"existing",
+										"",
+										"P\"2!\"/\""
+									]))) {
+										const name = require_paths.resolveCommandName(file);
+										let segments = require_paths.resolveCommandPath(this, file).split("/").filter(Boolean);
+										segments = segments.map(__assignType((segment, index) => {
+											const found = segments.findIndex(__assignType((existing) => existing === segment, [
+												"existing",
+												"",
+												"P\"2!\"/\""
+											]));
+											if (found !== -1 && found !== index) segment += `_${segments.filter(__assignType((segment) => require_context_helpers.isDynamicPathSegment(segment) && require_context_helpers.getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === segment, [
+												"segment",
+												"",
+												"P\"2!\"/\""
+											])).length}`;
+											return segment;
+										}, [
+											"segment",
+											"index",
+											"",
+											"P\"2!\"2\"\"/#"
+										]));
+										ret.push({
+											id,
+											path: segments.join("/"),
+											segments,
+											name,
+											alias: [],
+											tags: [],
+											isVirtual: true,
+											entry: { file },
+											source: "file"
+										});
+									}
+								}
+								parentPath = (0, _stryke_path_resolve_parent_path.resolveParentPath)(parentPath);
+							}
+							return ret;
+						}, [
+							"ret",
+							"command",
+							"",
+							"P\"2!\"2\"\"/#"
+						]), this.inputs).sort(__assignType((a, b) => a.segments.length - b.segments.length, [
+							"a",
+							"b",
+							"",
+							"P\"2!\"2\"\"/#"
+						]));
+						this.debug(`Final command input list: \n${this.inputs.map(__assignType((command) => ` - ${command.id}${command.isVirtual ? " (virtual)" : ""}: ${command.source === "file" ? (0, _stryke_path_replace.replacePath)(command.entry.file, this.commandsPath) : `added by ${command.source}`}`, [
+							"command",
+							"",
+							"P\"2!\"/\""
+						])).join("\n")}`);
+					}
+				}
+			}
+		},
+		{
+			name: "shell-shock:update-env",
+			configResolved: {
+				order: "post",
+				async handler() {
+					this.debug("Adding global options to the CLI application's environment variables.");
+					for (const option of Object.values(this.globalOptions).filter(__assignType((option) => Boolean(option.env), [
+						"option",
+						"",
+						"P\"2!\"/\""
+					])).filter(__assignType((option) => !this.env.types.env.getPropertyOrUndefined(option.env), [
+						"option",
+						"",
+						"P\"2!\"/\""
+					]))) this.env.types.env.addProperty({
+						name: option.env,
+						optional: option.optional ? true : void 0,
+						description: option.description,
+						visibility: _powerlines_deepkit_vendor_type.ReflectionVisibility.public,
+						type: require_deepkit.extractType(option),
+						default: option.default,
+						tags: {
+							title: option.title,
+							alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							])),
+							domain: "cli"
+						}
+					});
+					await (0, _powerlines_plugin_env_helpers.writeEnvTypeReflection)(this, this.env.types.env, "env");
+				}
+			}
+		},
+		{
+			name: "shell-shock:resolve-commands",
+			prepare: {
+				order: "post",
+				async handler() {
+					this.debug("Initializing the CLI application's command tree.");
+					this.commands = {};
+					if (this.config.command !== "prepare" && this.config.skipCache !== true && this.persistedMeta?.checksum === this.meta.checksum && this.fs.existsSync(require_persistence.getCommandsPersistencePath(this))) {
+						this.debug(`Skipping command resolution as the meta checksum has not changed.`);
+						await require_persistence.readCommandsPersistence(this);
+					} else {
+						for (const input of this.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment) && !require_context_helpers.isPathSegmentGroup(segment), [
+							"segment",
+							"",
+							"P\"2!\"/\""
+						])).length === 1, [
+							"input",
+							"",
+							"P\"2!\"/\""
+						]))) this.commands[input.name] = await require_resolve.resolve({
+							context: this,
+							command: input
+						});
+						this.debug("Post-processing commands to ensure proper reflection.");
+						await require_traverse_command_tree.traverseCommands(this, __assignType((command) => {
+							command.options = Object.fromEntries(Object.entries(command.options).map(__assignType(([name, option]) => [(0, _stryke_string_format_camel_case.camelCase)(name), {
+								...option,
+								name: (0, _stryke_string_format_camel_case.camelCase)(name),
+								alias: option.alias ?? [],
+								optional: option.optional ?? false
+							}], [
+								"param0",
+								"",
+								"P\"2!\"/\""
+							])));
+						}, [
+							"command",
+							"",
+							"P\"2!\"/\""
+						]));
+						await require_persistence.writeCommandsPersistence(this);
+					}
+					this.debug("Validating the CLI applications command tree.");
+					let isValid = true;
+					await require_traverse_command_tree.traverseCommands(this, __assignType((command) => {
+						const failures = require_validations.validateCommand(command);
+						if (failures.length > 0) {
+							this.error(`Found ${failures.length} issue${failures.length > 1 ? "s" : ""} with the ${command.title} command: \n${failures.map(__assignType((failure) => ` - ${failure.code}: ${failure.details}`, [
+								"failure",
+								"",
+								"P\"2!\"/\""
+							])).join("\n")}\n`);
+							isValid = false;
+						}
+					}, [
+						"command",
+						"",
+						"P\"2!\"/\""
+					]));
+					if (!isValid) throw new Error(`One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`);
+					this.info(`\nCreating an application with the following command tree: \n${require_utilities.formatCommandTree(this)}\n`);
+				}
+			}
+		},
+		{
+			name: "shell-shock:chmod+x",
+			configResolved() {
+				this.config.tsdown.hooks ??= {};
+				this.config.tsdown.hooks["build:done"] = __assignType(async (_) => {
+					await Promise.all(Object.values(this.config.bin).map(__assignType(async (bin) => {
+						const path = (0, _stryke_path_append.appendPath)(bin, (0, _stryke_path_join_paths.joinPaths)(this.config.cwd, this.config.root));
+						if (this.fs.existsSync(path)) {
+							this.debug(`Adding hashbang to binary executable output file: ${path}`);
+							const content = await this.fs.read(path);
+							if (content && !content.startsWith("#!")) await this.fs.write(path, `#!/usr/bin/env ${this.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node\n\n${content}`);
+							this.debug(`Adding executable permissions (chmod+x) to binary executable output file: ${path}`);
+							await (0, _stryke_fs_chmod_x.chmodX)(path);
+						} else this.warn(`Expected binary output file not found at path: ${path}. Skipping adding hashbang and executable permissions (chmod+x).`);
+					}, [
+						"bin",
+						"",
+						"P\"2!\"/\""
+					])));
+				}, [
+					"chunks",
+					"_",
+					"",
+					"PP!P!F4!MK2\"\"/#"
+				]);
+			}
+		},
+		{
+			name: "shell-shock:docs",
+			configResolved: __assignType(function configResolved() {
+				this.config.automd ??= {};
+				this.config.automd.generators = {
+					...this.config.automd.generators ?? {},
+					commands: require_automd.commands(this)
+				};
+			}, ["configResolved", "P\"/!"]),
+			async docs() {
+				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
+				const commands = this.inputs.map(__assignType((input) => require_get_command_tree.getCommandTree(this, input.segments), [
+					"input",
+					"",
+					"P\"2!\"/\""
+				])).filter(Boolean);
+				return (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core_components.For, {
+					get each() {
+						return Object.values(commands);
+					},
+					doubleHardline: true,
+					get children() {
+						return __assignType((child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core_components.Show, {
+							get when() {
+								return !child.isVirtual;
+							},
+							get children() {
+								return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocsFile, { command: child });
+							}
+						}), [
+							"child",
+							"",
+							"P\"2!\"/\""
+						]);
+					}
+				}));
+			}
+		}
+	];
+}, [
+	"Options",
+	"options",
+	() => ({}),
+	"",
+	"P\"w!2\">#!F/$"
+]);
+
+//#endregion
+exports.default = plugin;
+exports.plugin = plugin;

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAsFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAqFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAsFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAqFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}