@shell-shock/core 0.17.7 → 0.17.8

package/dist/plugin.cjs

@@ -1,429 +1,4 @@
-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_traverse_command_tree = require('./plugin-utils/traverse-command-tree.cjs');
-const require_get_command_tree = require('./plugin-utils/get-command-tree.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_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_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.");
-				await require_update_package_json.updatePackageJsonBinary(this);
-				return (0, defu.defu)({ output: { path: (0, _stryke_path_join_paths.joinPaths)(this.config.root, "dist") } }, 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 ? [(0, _stryke_path_join_paths.joinPaths)(this.config.root, "src/**/command.ts"), (0, _stryke_path_join_paths.joinPaths)(this.config.root, "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.");
-					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.options = 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.options = this.options.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("Finding command entry point files.");
-				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: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.workspaceConfig.workspaceRoot, 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;
+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;

package/dist/plugin.d.cts.map

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