@shell-shock/core 0.1.1 → 0.2.1

package/dist/helpers/resolve-command.mjs

@@ -1 +1,88 @@
-import{appendPath as e}from"@stryke/path/append";import{findFilePath as t}from"@stryke/path/file-path-fns";import{isSetObject as n}from"@stryke/type-checks/is-set-object";import{commonPath as r}from"@stryke/path/common";import{stripStars as i}from"@stryke/path/normalize";import{replacePath as a}from"@stryke/path/replace";import{isSetString as o}from"@stryke/type-checks/is-set-string";function s(e,n){return a(t(n),e.commandsRoot).replaceAll(/^\/+/g,``).replaceAll(/\/+$/g,``)}function c(t){return o(t.config.entry)?e(e(i(t.config.entry),t.config.projectRoot),t.workspaceConfig.workspaceRoot):n(t.config.entry)&&`file`in t.config.entry?e(e(i(t.config.entry.file),t.config.projectRoot),t.workspaceConfig.workspaceRoot):Array.isArray(t.config.entry)&&t.config.entry.length>0?r(t.config.entry.map(n=>e(e(i(o(n)?n:n.file),t.config.projectRoot),t.workspaceConfig.workspaceRoot))):e(t.config.sourceRoot||t.config.projectRoot,t.workspaceConfig.workspaceRoot)}export{c as findCommandsRoot,s as resolveCommandPath};
+import { getUniqueBy } from "@stryke/helpers/get-unique";
+import { appendPath } from "@stryke/path/append";
+import { findFilePath, findFolderName } from "@stryke/path/file-path-fns";
+import { replacePath } from "@stryke/path/replace";
+import { resolveParentPath } from "@stryke/path/resolve-parent-path";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { reflectType } from "@powerlines/deepkit/reflect-type";
+import { ReflectionClass, ReflectionKind, stringifyType } from "@powerlines/deepkit/vendor/type";
+import { commonPath } from "@stryke/path/common";
+import { stripStars } from "@stryke/path/normalize";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+
+//#region src/helpers/resolve-command.ts
+function resolveCommandPath(context, file) {
+	return replacePath(findFilePath(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "");
+}
+function findCommandsRoot(context) {
+	if (isSetString(context.config.entry)) return appendPath(appendPath(stripStars(context.config.entry), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
+	else if (isSetObject(context.config.entry) && "file" in context.config.entry) return appendPath(appendPath(stripStars(context.config.entry.file), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
+	else if (Array.isArray(context.config.entry) && context.config.entry.length > 0) return commonPath(context.config.entry.map((entry) => appendPath(appendPath(stripStars(isSetString(entry) ? entry : entry.file), context.config.projectRoot), context.workspaceConfig.workspaceRoot)));
+	return appendPath(context.config.sourceRoot || context.config.projectRoot, context.workspaceConfig.workspaceRoot);
+}
+/**
+* Finds the command name from the given file path.
+*
+* @param file - The file path to extract the command name from.
+* @returns The command name.
+*/
+function findCommandName(file) {
+	let name = findFolderName(file);
+	let count = 1;
+	while (name.startsWith("[") && name.endsWith("]")) name = findFolderName(resolveParentPath(file, count++));
+	return name;
+}
+async function reflectCommandTree(context, command, parent) {
+	const title = command.title || `${parent?.title ? `${parent.title} - ` : ""}${titleCase(command.name)}`;
+	const commandTree = {
+		...command,
+		title,
+		description: command.description || `The ${title} ${parent ? "sub-" : ""}command.`,
+		options: {},
+		params: [],
+		parent: parent ?? null,
+		children: {}
+	};
+	if (context.config.defaultOptions === false) commandTree.options = {};
+	else if (Array.isArray(context.config.defaultOptions)) commandTree.options = Object.fromEntries(getUniqueBy(context.config.defaultOptions, (item) => item.name).map((option) => [option.name, option]));
+	else if (isFunction(context.config.defaultOptions)) commandTree.options = Object.fromEntries(getUniqueBy(context.config.defaultOptions(context, command), (item) => item.name).map((option) => [option.name, option]));
+	if (command.isVirtual) context.trace(`Adding reflection for virtual command: ${command.id}`);
+	else {
+		if (!command.entry.input?.file || !context.fs.existsSync(command.entry.input.file)) throw new Error(`${!command.entry.input?.file ? "Missing" : "Non-existent"} command entry file for "${command.name}"`);
+		context.trace(`Adding reflection for user-defined command: ${command.id} (file: ${command.entry.input.file})`);
+		const type = await reflectType(context, command.entry.input);
+		if (type.kind !== ReflectionKind.function) throw new Error(`The command entry file "${command.entry.input.file}" does not export a valid function.`);
+		if (type.parameters.length > 0 && type.parameters[0]) {
+			const firstParam = type.parameters[0];
+			if (firstParam.type.kind === ReflectionKind.objectLiteral || firstParam.type.kind === ReflectionKind.class) {
+				const optionsReflection = ReflectionClass.from(firstParam.type);
+				for (const propertyReflection of optionsReflection.getProperties()) {
+					const propertyType = propertyReflection.getType();
+					commandTree.options[propertyReflection.getNameAsString()] = {
+						name: propertyReflection.getNameAsString(),
+						alias: propertyReflection.getTags().alias ?? [],
+						title: propertyReflection.getTags().title || titleCase(propertyReflection.getNameAsString()),
+						description: propertyReflection.getDescription(),
+						kind: propertyType.kind,
+						optional: propertyReflection.isOptional(),
+						default: propertyReflection.getDefaultValue(),
+						variadic: false
+					};
+					commandTree.options[propertyReflection.getNameAsString()].description ??= `The ${commandTree.options[propertyReflection.getNameAsString()].title} option.`;
+					if (propertyType.kind === ReflectionKind.array) if (propertyType.type.kind === ReflectionKind.string || propertyType.type.kind === ReflectionKind.number) {
+						commandTree.options[propertyReflection.getNameAsString()].variadic = true;
+						commandTree.options[propertyReflection.getNameAsString()].kind = propertyType.type.kind;
+					} else throw new Error(`Unsupported array type for option "${propertyReflection.getNameAsString()}" in command "${command.name}". Only string[] and number[] are supported.`);
+					else if (propertyType.kind !== ReflectionKind.boolean && propertyType.kind !== ReflectionKind.string && propertyType.kind !== ReflectionKind.number) throw new Error(`Unsupported type for option "${propertyReflection.getNameAsString()}" in command "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(propertyType).trim().replaceAll(" | ", ", or ")}.`);
+				}
+			}
+		}
+	}
+	for (const input of context.inputs.filter((input$1) => input$1.path.length === command.path.length + 1 && input$1.path.slice(0, command.path.length).every((value, index) => value === command.path[index]))) commandTree.children[input.name] = await reflectCommandTree(context, input, commandTree);
+	return commandTree;
+}
+
+//#endregion
+export { findCommandName, findCommandsRoot, reflectCommandTree, resolveCommandPath };

package/dist/helpers/update-package-json.cjs

@@ -1 +1,28 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/path/join-paths`),n=require(`@stryke/type-checks/is-set-object`),r=require(`@stryke/path/replace`),i=require(`@stryke/convert/to-array`),a=require(`@stryke/helpers/get-unique`),o=require(`@stryke/json/storm-json`),s=require(`@stryke/string-format/kebab-case`);function c(e,t){return`./bin/${(0,s.kebabCase)((0,r.replaceExtension)(e))}.${t===`cjs`||Array.isArray(t)&&t.includes(`cjs`)?`cjs`:`mjs`}`}async function l(e){let r=(0,t.joinPaths)(e.workspaceConfig.workspaceRoot,e.config.projectRoot,`package.json`);if(e.config.bin&&Array.isArray(e.config.bin)&&e.config.bin.length>0?(e.packageJson.bin=Object.fromEntries((0,a.getUnique)((0,i.toArray)(e.config.bin)).map(t=>[t,c(t,e.config.output.format)])),await e.fs.write(r,o.StormJSON.stringify(e.packageJson))):!(0,n.isSetObject)(e.packageJson.bin)&&(e.config.name||e.packageJson.name)&&(e.packageJson.bin={[e.config.name||e.packageJson.name]:c(e.config.name||e.packageJson.name,e.config.output.format)},await e.fs.write(r,o.StormJSON.stringify(e.packageJson))),!(0,n.isSetObject)(e.packageJson.bin))throw Error("Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.");e.config.bin=Object.keys(e.packageJson.bin)}exports.updatePackageJsonBinary=l;
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_path_replace = require("@stryke/path/replace");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_json_storm_json = require("@stryke/json/storm-json");
+let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+
+//#region src/helpers/update-package-json.ts
+function formatBinaryPath(name, format) {
+	return `./bin/${(0, __stryke_string_format_kebab_case.kebabCase)((0, __stryke_path_replace.replaceExtension)(name))}.${format === "cjs" || Array.isArray(format) && format.includes("cjs") ? "cjs" : "mjs"}`;
+}
+async function updatePackageJsonBinary(context) {
+	const packageJsonPath = (0, __stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.projectRoot, "package.json");
+	if (context.config.bin && Array.isArray(context.config.bin) && context.config.bin.length > 0) {
+		context.packageJson.bin = Object.fromEntries((0, __stryke_helpers_get_unique.getUnique)((0, __stryke_convert_to_array.toArray)(context.config.bin)).map((bin) => [bin, formatBinaryPath(bin, context.config.output.format)]));
+		await context.fs.write(packageJsonPath, __stryke_json_storm_json.StormJSON.stringify(context.packageJson));
+	} else if (!(0, __stryke_type_checks_is_set_object.isSetObject)(context.packageJson.bin) && (context.config.name || context.packageJson.name)) {
+		context.packageJson.bin = { [context.config.name || context.packageJson.name]: formatBinaryPath(context.config.name || context.packageJson.name, context.config.output.format) };
+		await context.fs.write(packageJsonPath, __stryke_json_storm_json.StormJSON.stringify(context.packageJson));
+	}
+	if (!(0, __stryke_type_checks_is_set_object.isSetObject)(context.packageJson.bin)) throw new Error("Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.");
+	context.config.bin = Object.keys(context.packageJson.bin);
+}
+
+//#endregion
+exports.updatePackageJsonBinary = updatePackageJsonBinary;

package/dist/helpers/update-package-json.mjs

@@ -1 +1,27 @@
-import{joinPaths as e}from"@stryke/path/join-paths";import{isSetObject as t}from"@stryke/type-checks/is-set-object";import{replaceExtension as n}from"@stryke/path/replace";import{toArray as r}from"@stryke/convert/to-array";import{getUnique as i}from"@stryke/helpers/get-unique";import{StormJSON as a}from"@stryke/json/storm-json";import{kebabCase as o}from"@stryke/string-format/kebab-case";function s(e,t){return`./bin/${o(n(e))}.${t===`cjs`||Array.isArray(t)&&t.includes(`cjs`)?`cjs`:`mjs`}`}async function c(n){let o=e(n.workspaceConfig.workspaceRoot,n.config.projectRoot,`package.json`);if(n.config.bin&&Array.isArray(n.config.bin)&&n.config.bin.length>0?(n.packageJson.bin=Object.fromEntries(i(r(n.config.bin)).map(e=>[e,s(e,n.config.output.format)])),await n.fs.write(o,a.stringify(n.packageJson))):!t(n.packageJson.bin)&&(n.config.name||n.packageJson.name)&&(n.packageJson.bin={[n.config.name||n.packageJson.name]:s(n.config.name||n.packageJson.name,n.config.output.format)},await n.fs.write(o,a.stringify(n.packageJson))),!t(n.packageJson.bin))throw Error("Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.");n.config.bin=Object.keys(n.packageJson.bin)}export{c as updatePackageJsonBinary};
+import { getUnique } from "@stryke/helpers/get-unique";
+import { joinPaths } from "@stryke/path/join-paths";
+import { replaceExtension } from "@stryke/path/replace";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { toArray } from "@stryke/convert/to-array";
+import { StormJSON } from "@stryke/json/storm-json";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+
+//#region src/helpers/update-package-json.ts
+function formatBinaryPath(name, format) {
+	return `./bin/${kebabCase(replaceExtension(name))}.${format === "cjs" || Array.isArray(format) && format.includes("cjs") ? "cjs" : "mjs"}`;
+}
+async function updatePackageJsonBinary(context) {
+	const packageJsonPath = joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot, "package.json");
+	if (context.config.bin && Array.isArray(context.config.bin) && context.config.bin.length > 0) {
+		context.packageJson.bin = Object.fromEntries(getUnique(toArray(context.config.bin)).map((bin) => [bin, formatBinaryPath(bin, context.config.output.format)]));
+		await context.fs.write(packageJsonPath, StormJSON.stringify(context.packageJson));
+	} else if (!isSetObject(context.packageJson.bin) && (context.config.name || context.packageJson.name)) {
+		context.packageJson.bin = { [context.config.name || context.packageJson.name]: formatBinaryPath(context.config.name || context.packageJson.name, context.config.output.format) };
+		await context.fs.write(packageJsonPath, StormJSON.stringify(context.packageJson));
+	}
+	if (!isSetObject(context.packageJson.bin)) throw new Error("Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.");
+	context.config.bin = Object.keys(context.packageJson.bin);
+}
+
+//#endregion
+export { updatePackageJsonBinary };

package/dist/helpers/utilities.cjs

@@ -0,0 +1,41 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+
+//#region src/helpers/utilities.ts
+/**
+* Retrieves the application name from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application name in kebab-case format.
+* @throws An error if no valid application name is found.
+*/
+function getAppName(context) {
+	const result = context.config.bin && ((0, __stryke_type_checks_is_set_string.isSetString)(context.config.bin) || Array.isArray(context.config.bin) && context.config.bin.length > 0 && context.config.bin[0]) ? (0, __stryke_type_checks_is_set_string.isSetString)(context.config.bin) ? context.config.bin : context.config.bin[0] : context.config.name || context.packageJson?.name;
+	if (!(0, __stryke_type_checks_is_set_string.isSetString)(result)) throw new Error("No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.");
+	return (0, __stryke_string_format_kebab_case.kebabCase)(result);
+}
+/**
+* Retrieves the application title from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application title in title-case format.
+*/
+function getAppTitle(context) {
+	return (0, __stryke_string_format_title_case.titleCase)(context.config.name || getAppName(context));
+}
+/**
+* Retrieves the application description from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application description.
+*/
+function getAppDescription(context) {
+	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context)} command-line interface application.`;
+}
+
+//#endregion
+exports.getAppDescription = getAppDescription;
+exports.getAppName = getAppName;
+exports.getAppTitle = getAppTitle;

package/dist/helpers/utilities.mjs

@@ -0,0 +1,38 @@
+import { titleCase } from "@stryke/string-format/title-case";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+
+//#region src/helpers/utilities.ts
+/**
+* Retrieves the application name from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application name in kebab-case format.
+* @throws An error if no valid application name is found.
+*/
+function getAppName(context) {
+	const result = context.config.bin && (isSetString(context.config.bin) || Array.isArray(context.config.bin) && context.config.bin.length > 0 && context.config.bin[0]) ? isSetString(context.config.bin) ? context.config.bin : context.config.bin[0] : context.config.name || context.packageJson?.name;
+	if (!isSetString(result)) throw new Error("No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.");
+	return kebabCase(result);
+}
+/**
+* Retrieves the application title from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application title in title-case format.
+*/
+function getAppTitle(context) {
+	return titleCase(context.config.name || getAppName(context));
+}
+/**
+* Retrieves the application description from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application description.
+*/
+function getAppDescription(context) {
+	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context)} command-line interface application.`;
+}
+
+//#endregion
+export { getAppDescription, getAppName, getAppTitle };

package/dist/index.cjs

@@ -1 +1,24 @@
-const e=require(`./powerlines.cjs`),t=require(`./api.cjs`),n=require(`./config.cjs`);exports.ShellShockAPI=t.ShellShockAPI,exports.defineConfig=n.defineConfig,exports.shellShock=e.shellShock;
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_powerlines = require('./powerlines.cjs');
+const require_api = require('./api.cjs');
+const require_config = require('./config.cjs');
+
+//#region src/index.ts
+/**
+* Creates a new {@link ShellShockAPI} instance.
+*
+* @param options - The user configuration options.
+* @returns A promise that resolves to a {@link ShellShockAPI} instance.
+*/
+async function createShellShock(options = {}) {
+	options.root ??= process.cwd();
+	return require_api.ShellShockAPI.from(options);
+}
+var src_default = require_api.ShellShockAPI;
+
+//#endregion
+exports.ShellShockAPI = require_api.ShellShockAPI;
+exports.createShellShock = createShellShock;
+exports.default = src_default;
+exports.defineConfig = require_config.defineConfig;
+exports.shellShock = require_powerlines.shellShock;

package/dist/index.d.cts

@@ -1,6 +1,20 @@
+import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./types/command.cjs";
+import { Context } from "./types/context.cjs";
 import { Options, ResolvedConfig, UserConfig } from "./types/config.cjs";
 import { ShellShockAPI } from "./api.cjs";
 import { defineConfig } from "./config.cjs";
-import { BuildContext, CommandArg, CommandEntry, CommandRelations, CommandTree } from "./types/build.cjs";
 import shellShock from "./powerlines.cjs";
-export { BuildContext, CommandArg, CommandEntry, CommandRelations, CommandTree, Options, ResolvedConfig, ShellShockAPI, UserConfig, defineConfig, shellShock };
+import { BaseCommandOptions } from "./types/options.cjs";
+import "./types/index.cjs";
+
+//#region src/index.d.ts
+
+/**
+ * Creates a new {@link ShellShockAPI} instance.
+ *
+ * @param options - The user configuration options.
+ * @returns A promise that resolves to a {@link ShellShockAPI} instance.
+ */
+declare function createShellShock(options?: Partial<UserConfig>): Promise<ShellShockAPI>;
+//#endregion
+export { BaseCommandOption, BaseCommandOptions, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, Context, NumberCommandOption, Options, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandOption, UserConfig, createShellShock, defineConfig, shellShock };

package/dist/index.d.mts

@@ -1,7 +1,20 @@
+import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./types/command.mjs";
+import { Context } from "./types/context.mjs";
 import { Options, ResolvedConfig, UserConfig } from "./types/config.mjs";
 import { ShellShockAPI } from "./api.mjs";
 import { defineConfig } from "./config.mjs";
-import { BuildContext, CommandArg, CommandEntry, CommandRelations, CommandTree } from "./types/build.mjs";
 import shellShock from "./powerlines.mjs";
+import { BaseCommandOptions } from "./types/options.mjs";
 import "./types/index.mjs";
-export { BuildContext, CommandArg, CommandEntry, CommandRelations, CommandTree, Options, ResolvedConfig, ShellShockAPI, UserConfig, defineConfig, shellShock };
+
+//#region src/index.d.ts
+
+/**
+ * Creates a new {@link ShellShockAPI} instance.
+ *
+ * @param options - The user configuration options.
+ * @returns A promise that resolves to a {@link ShellShockAPI} instance.
+ */
+declare function createShellShock(options?: Partial<UserConfig>): Promise<ShellShockAPI>;
+//#endregion
+export { BaseCommandOption, BaseCommandOptions, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, Context, NumberCommandOption, Options, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandOption, UserConfig, createShellShock, defineConfig, shellShock };

package/dist/index.mjs

@@ -1 +1,19 @@
-import{shellShock as e}from"./powerlines.mjs";import{ShellShockAPI as t}from"./api.mjs";import{defineConfig as n}from"./config.mjs";export{t as ShellShockAPI,n as defineConfig,e as shellShock};
+import { shellShock } from "./powerlines.mjs";
+import { ShellShockAPI } from "./api.mjs";
+import { defineConfig } from "./config.mjs";
+
+//#region src/index.ts
+/**
+* Creates a new {@link ShellShockAPI} instance.
+*
+* @param options - The user configuration options.
+* @returns A promise that resolves to a {@link ShellShockAPI} instance.
+*/
+async function createShellShock(options = {}) {
+	options.root ??= process.cwd();
+	return ShellShockAPI.from(options);
+}
+var src_default = ShellShockAPI;
+
+//#endregion
+export { ShellShockAPI, createShellShock, src_default as default, defineConfig, shellShock };

package/dist/plugin-utils/get-command-tree.cjs

@@ -0,0 +1,22 @@
+
+//#region src/plugin-utils/get-command-tree.ts
+/**
+* Retrieves a specific command tree based on the provided path.
+*
+* @param context - The build context containing the command definitions.
+* @param path - An array of strings representing the command path.
+* @returns The command tree at the specified path, or null if not found.
+*/
+function getCommandTree(context, path = []) {
+	if (path.length === 0) return null;
+	let currentTree = context.commands[path[0]] ?? null;
+	if (path.length > 1) {
+		const segments = path.slice(1);
+		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
+		else return null;
+	}
+	return currentTree;
+}
+
+//#endregion
+exports.getCommandTree = getCommandTree;

package/dist/plugin-utils/get-command-tree.d.cts

@@ -0,0 +1,15 @@
+import { CommandTree } from "../types/command.cjs";
+import { Context } from "../types/context.cjs";
+
+//#region src/plugin-utils/get-command-tree.d.ts
+
+/**
+ * Retrieves a specific command tree based on the provided path.
+ *
+ * @param context - The build context containing the command definitions.
+ * @param path - An array of strings representing the command path.
+ * @returns The command tree at the specified path, or null if not found.
+ */
+declare function getCommandTree(context: Context, path?: string[]): CommandTree | null;
+//#endregion
+export { getCommandTree };

package/dist/plugin-utils/get-command-tree.d.mts

@@ -0,0 +1,15 @@
+import { CommandTree } from "../types/command.mjs";
+import { Context } from "../types/context.mjs";
+
+//#region src/plugin-utils/get-command-tree.d.ts
+
+/**
+ * Retrieves a specific command tree based on the provided path.
+ *
+ * @param context - The build context containing the command definitions.
+ * @param path - An array of strings representing the command path.
+ * @returns The command tree at the specified path, or null if not found.
+ */
+declare function getCommandTree(context: Context, path?: string[]): CommandTree | null;
+//#endregion
+export { getCommandTree };

package/dist/plugin-utils/get-command-tree.mjs

@@ -0,0 +1,21 @@
+//#region src/plugin-utils/get-command-tree.ts
+/**
+* Retrieves a specific command tree based on the provided path.
+*
+* @param context - The build context containing the command definitions.
+* @param path - An array of strings representing the command path.
+* @returns The command tree at the specified path, or null if not found.
+*/
+function getCommandTree(context, path = []) {
+	if (path.length === 0) return null;
+	let currentTree = context.commands[path[0]] ?? null;
+	if (path.length > 1) {
+		const segments = path.slice(1);
+		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
+		else return null;
+	}
+	return currentTree;
+}
+
+//#endregion
+export { getCommandTree };

package/dist/plugin-utils/index.cjs

@@ -0,0 +1,3 @@
+const require_plugin_utils_get_command_tree = require('./get-command-tree.cjs');
+
+exports.getCommandTree = require_plugin_utils_get_command_tree.getCommandTree;

package/dist/plugin-utils/index.d.cts

@@ -0,0 +1,2 @@
+import { getCommandTree } from "./get-command-tree.cjs";
+export { getCommandTree };

package/dist/plugin-utils/index.d.mts

@@ -0,0 +1,2 @@
+import { getCommandTree } from "./get-command-tree.mjs";
+export { getCommandTree };

package/dist/plugin-utils/index.mjs

@@ -0,0 +1,3 @@
+import { getCommandTree } from "./get-command-tree.mjs";
+
+export { getCommandTree };

package/dist/powerlines.cjs

@@ -1,2 +1,172 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./helpers/resolve-command.cjs`),n=require(`./helpers/update-package-json.cjs`);let r=require(`@powerlines/plugin-tsdown`);r=e.__toESM(r);let i=require(`@stryke/fs/chmod-x`),a=require(`@stryke/path/append`),o=require(`@stryke/path/file-path-fns`),s=require(`@stryke/path/is-parent-path`),c=require(`@stryke/path/join-paths`),l=require(`@stryke/path/resolve-parent-path`),u=require(`@stryke/string-format/title-case`),d=require(`@stryke/type-checks/is-set-object`),f=require(`defu`),p=require(`node:fs`);const m=50,h=(e={})=>({name:`shell-shock`,dependsOn:[(0,r.default)()],async config(){return this.trace(`Resolving the Shell Shock configuration.`),(0,f.defu)(e,{entry:!this.config.entry||Array.isArray(this.config.entry)&&this.config.entry.length===0?[(0,c.joinPaths)(this.config.sourceRoot,`**/*`)]:void 0,build:{variant:`tsdown`},interactive:!0,skipDefaultArgs:!1,type:`application`,framework:`shell-shock`,singleBuild:!0})},async configResolved(){this.trace(`Shell Shock configuration has been resolved.`),await n.updatePackageJsonBinary(this),this.commandsRoot=t.findCommandsRoot(this),this.commands??=[],this.commands=this.entry.filter(e=>(0,o.findFileName)(e.file,{withExtension:!1})===`command`).reduce((e,n)=>{let r=(0,a.appendPath)((0,a.appendPath)(n.file,this.config.projectRoot),this.workspaceConfig.workspaceRoot);if(!(0,s.isParentPath)(r,this.commandsRoot))throw Error(`Command entry point "${r}" is not located within the commands root "${this.commandsRoot}". Please ensure that all command entry points are located within the current project.`);let i=t.resolveCommandPath(this,r),o=i.replaceAll(`/`,`-`);return e.some(e=>e.name===o)||e.push({path:i.split(`/`).filter(Boolean),name:o,title:(0,u.titleCase)(o),isVirtual:!1,entry:{...n,file:r,input:n,output:o}}),e},this.commands)},async prepare(){if(this.trace(`Finding and adding virtual commands to the entry points.`),this.commands=this.commands.reduce((e,n)=>{let r=0,i=(0,l.resolveParentPath)((0,o.findFilePath)(n.entry.file));for(;i!==this.commandsRoot;){if(r++>50)throw Error(`Maximum command virtual parent depth of 50 exceeded while processing command: ${n.name}`);let a=(0,o.findFolderName)(i);if(!e.some(e=>(0,o.findFilePath)(e.entry.file)===i)&&(!a.startsWith(`[`)||!a.endsWith(`]`))){let n=t.resolveCommandPath(this,i),r=n.replaceAll(`/`,`-`);e.push({path:n.split(`/`).filter(Boolean),name:r,title:(0,u.titleCase)(r),isVirtual:!0,entry:{file:(0,c.joinPaths)(i,`command.ts`),input:{file:(0,c.joinPaths)(i,`command.ts`)},output:a}})}i=(0,l.resolveParentPath)(i)}return e},this.commands).sort((e,t)=>e.name.localeCompare(t.name)),this.commands.length===0){this.warn(`No commands were found in the project. Please ensure at least one command exists.`);return}this.info(`Creating an application with the following commands: \n${this.commands.map(e=>` - ${e.title} (${e.name}): ${e.entry.file}${e.isVirtual?` (virtual)`:``}`).join(`
-`)}`),this.entry=[]},async buildEnd(){if(!(0,d.isSetObject)(this.packageJson.bin)){this.warn(`No binaries were found in package.json. Please ensure the binaries are correctly configured.`);return}this.debug(`Adding executable permissions to binaries.`);for(let e of Object.values(this.packageJson.bin))(0,p.existsSync)((0,a.appendPath)(e,this.config.output.buildPath))&&await(0,i.chmodX)((0,a.appendPath)(e,this.config.output.buildPath))}});var g=h;exports.default=g,exports.shellShock=h;
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_persistence = require('./helpers/persistence.cjs');
+const require_resolve_command = require('./helpers/resolve-command.cjs');
+const require_update_package_json = require('./helpers/update-package-json.cjs');
+const require_utilities = require('./helpers/utilities.cjs');
+let __powerlines_plugin_tsdown = require("@powerlines/plugin-tsdown");
+__powerlines_plugin_tsdown = require_rolldown_runtime.__toESM(__powerlines_plugin_tsdown);
+let __stryke_fs_chmod_x = require("@stryke/fs/chmod-x");
+let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+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_title_case = require("@stryke/string-format/title-case");
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let defu = require("defu");
+
+//#region src/powerlines.ts
+const MAX_DEPTH = 50;
+/**
+* The core Powerlines plugin to build Shell Shock projects.
+*/
+const shellShock = (options = {}) => {
+	return [
+		(0, __powerlines_plugin_tsdown.default)(),
+		{
+			name: "shell-shock:config",
+			async config() {
+				this.trace("Resolving the Shell Shock configuration.");
+				return (0, defu.defu)(options, {
+					entry: !this.config.entry || Array.isArray(this.config.entry) && this.config.entry.length === 0 ? [(0, __stryke_path_join_paths.joinPaths)(this.config.sourceRoot, "**/*")] : void 0,
+					build: {
+						target: "node22",
+						platform: "node"
+					},
+					type: "application",
+					framework: "shell-shock"
+				});
+			},
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.trace("Shell Shock configuration has been resolved.");
+					await require_update_package_json.updatePackageJsonBinary(this);
+					this.config.name = require_utilities.getAppName(this);
+					this.config.title = require_utilities.getAppTitle(this);
+					this.config.description = require_utilities.getAppDescription(this);
+					if (this.config.defaultOptions === false) this.options = [];
+					else if (Array.isArray(this.config.defaultOptions)) this.options = (0, __stryke_helpers_get_unique.getUniqueBy)(this.config.defaultOptions, (item) => item.name);
+					else if ((0, __stryke_type_checks_is_function.isFunction)(this.config.defaultOptions)) this.options = (0, __stryke_helpers_get_unique.getUniqueBy)(this.config.defaultOptions(this, {
+						id: null,
+						name: this.config.name,
+						title: this.config.title,
+						description: this.config.description,
+						path: [],
+						isVirtual: false
+					}), (item) => item.name);
+					this.inputs ??= [];
+				}
+			}
+		},
+		{
+			name: "shell-shock:inputs",
+			async configResolved() {
+				this.trace("Finding command entry points.");
+				this.commandsPath = require_resolve_command.findCommandsRoot(this);
+				this.inputs = this.entry.filter((entry) => (0, __stryke_path_file_path_fns.findFileName)(entry.file, { withExtension: false }) === "command").reduce((ret, entry) => {
+					const file = (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)(entry.file, this.config.projectRoot), this.workspaceConfig.workspaceRoot);
+					if (!(0, __stryke_path_is_parent_path.isParentPath)(file, this.commandsPath)) throw new Error(`Command entry point "${file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+					const path = require_resolve_command.resolveCommandPath(this, file);
+					const id = path.replaceAll("/", "-");
+					if (!ret.some((existing) => existing.id === id)) {
+						const name = require_resolve_command.findCommandName(file);
+						ret.push({
+							id,
+							path: path.split("/").filter(Boolean),
+							name,
+							title: (0, __stryke_string_format_title_case.titleCase)(name),
+							isVirtual: false,
+							entry: {
+								...entry,
+								file,
+								input: {
+									file: entry.file,
+									name: entry.name
+								},
+								output: name
+							}
+						});
+					}
+					return ret;
+				}, this.inputs);
+			}
+		},
+		{
+			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.info(`Shell Shock will create an application with the following commands: \n${this.inputs.filter((cmd) => !cmd.isVirtual).map((command) => ` - ${command.id}: ${(0, __stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+						this.trace("Finding and adding virtual command inputs for each command previously found.");
+						this.inputs = this.inputs.reduce((ret, command) => {
+							let depth = 0;
+							let parentPath = (0, __stryke_path_resolve_parent_path.resolveParentPath)((0, __stryke_path_file_path_fns.findFilePath)(command.entry.file));
+							while (parentPath !== this.commandsPath) {
+								if (depth++ > MAX_DEPTH) throw new Error(`Maximum command virtual parent depth of ${MAX_DEPTH} exceeded while processing command: ${command.name}`);
+								if (!ret.some((existing) => (0, __stryke_path_file_path_fns.findFilePath)(existing.entry.file) === parentPath)) {
+									const file = (0, __stryke_path_join_paths.joinPaths)(parentPath, "command.ts");
+									const path = require_resolve_command.resolveCommandPath(this, file);
+									const id = path.replaceAll("/", "-");
+									if (!ret.some((existing) => existing.id === id)) {
+										const name = require_resolve_command.findCommandName(file);
+										ret.push({
+											id,
+											path: path.split("/").filter(Boolean),
+											name,
+											title: (0, __stryke_string_format_title_case.titleCase)(name),
+											isVirtual: true,
+											entry: {
+												file,
+												input: { file }
+											}
+										});
+									}
+								}
+								parentPath = (0, __stryke_path_resolve_parent_path.resolveParentPath)(parentPath);
+							}
+							return ret;
+						}, this.inputs).sort((a, b) => a.path.length - b.path.length);
+						this.trace(`Final command input list: \n${this.inputs.map((command) => ` - ${command.id}: ${(0, __stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+					}
+				}
+			}
+		},
+		{
+			name: "shell-shock:reflect-commands",
+			async prepare() {
+				this.entry = [];
+				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 reflection initialization as the meta checksum has not changed.`);
+					await require_persistence.readCommandsPersistence(this);
+				} else {
+					for (const input of this.inputs.filter((input$1) => input$1.path.length === 1)) this.commands[input.name] = await require_resolve_command.reflectCommandTree(this, input);
+					await require_persistence.writeCommandsPersistence(this);
+				}
+			}
+		},
+		{
+			name: "shell-shock:chmod+x",
+			async buildEnd() {
+				if (!(0, __stryke_type_checks_is_set_object.isSetObject)(this.packageJson.bin)) {
+					this.warn("No binaries were found in package.json. Please ensure the binaries are correctly configured.");
+					return;
+				}
+				this.debug("Adding executable permissions to binaries.");
+				for (const executablePath of Object.values(this.packageJson.bin)) if (this.fs.existsSync((0, __stryke_path_append.appendPath)(executablePath, this.config.output.buildPath))) await (0, __stryke_fs_chmod_x.chmodX)((0, __stryke_path_append.appendPath)(executablePath, this.config.output.buildPath));
+			}
+		}
+	];
+};
+var powerlines_default = shellShock;
+
+//#endregion
+exports.default = powerlines_default;
+exports.shellShock = shellShock;

package/dist/powerlines.d.cts

@@ -1,5 +1,5 @@
+import { Context } from "./types/context.cjs";
 import { Options } from "./types/config.cjs";
-import { BuildContext } from "./types/build.cjs";
 import { Plugin } from "powerlines";
 
 //#region src/powerlines.d.ts
@@ -7,6 +7,6 @@ import { Plugin } from "powerlines";
 /**
  * The core Powerlines plugin to build Shell Shock projects.
  */
-declare const shellShock: <TContext extends BuildContext = BuildContext>(options?: Options) => Plugin<TContext>;
+declare const shellShock: <TContext extends Context = Context>(options?: Options) => Plugin<TContext>[];
 //#endregion
 export { shellShock as default, shellShock };