@shell-shock/core 0.2.0 → 0.2.1

package/dist/helpers/resolve-command.cjs

@@ -1 +1,92 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`),t=require(`./get-default-options.cjs`);let n=require(`@stryke/path/append`),r=require(`@stryke/path/file-path-fns`),i=require(`@stryke/path/replace`),a=require(`@stryke/path/resolve-parent-path`),o=require(`@stryke/string-format/title-case`),s=require(`@stryke/type-checks/is-set-object`),c=require(`@powerlines/deepkit/vendor/type`),l=require(`@powerlines/deepkit/reflect-type`),u=require(`@stryke/path/common`),d=require(`@stryke/path/normalize`),f=require(`@stryke/type-checks/is-set-string`);function p(e,t){return(0,i.replacePath)((0,r.findFilePath)(t),e.commandsPath).replaceAll(/^\/+/g,``).replaceAll(/\/+$/g,``)}function m(e){return(0,f.isSetString)(e.config.entry)?(0,n.appendPath)((0,n.appendPath)((0,d.stripStars)(e.config.entry),e.config.projectRoot),e.workspaceConfig.workspaceRoot):(0,s.isSetObject)(e.config.entry)&&`file`in e.config.entry?(0,n.appendPath)((0,n.appendPath)((0,d.stripStars)(e.config.entry.file),e.config.projectRoot),e.workspaceConfig.workspaceRoot):Array.isArray(e.config.entry)&&e.config.entry.length>0?(0,u.commonPath)(e.config.entry.map(t=>(0,n.appendPath)((0,n.appendPath)((0,d.stripStars)((0,f.isSetString)(t)?t:t.file),e.config.projectRoot),e.workspaceConfig.workspaceRoot))):(0,n.appendPath)(e.config.sourceRoot||e.config.projectRoot,e.workspaceConfig.workspaceRoot)}function h(e){let t=(0,r.findFolderName)(e),n=1;for(;t.startsWith(`[`)&&t.endsWith(`]`);)t=(0,r.findFolderName)((0,a.resolveParentPath)(e,n++));return t}async function g(e,n,r){let i=n.title||`${r?.title?`${r.title} - `:``}${(0,o.titleCase)(n.name)}`,a={...n,title:i,description:n.description||`The ${i} ${r?`sub-`:``}command.`,options:Object.fromEntries(t.getDefaultOptions(e,n).map(e=>[e.name,e])),params:[],parent:r??null,children:{}};if(n.isVirtual)e.trace(`Adding reflection for virtual command: ${n.id}`);else{if(!n.entry.input?.file||!e.fs.existsSync(n.entry.input.file))throw Error(`${n.entry.input?.file?`Non-existent`:`Missing`} command entry file for "${n.name}"`);e.trace(`Adding reflection for user-defined command: ${n.id} (file: ${n.entry.input.file})`);let t=await(0,l.reflectType)(e,n.entry.input);if(t.kind!==c.ReflectionKind.function)throw Error(`The command entry file "${n.entry.input.file}" does not export a valid function.`);if(t.parameters.length>0&&t.parameters[0]){let e=t.parameters[0];if(e.type.kind===c.ReflectionKind.objectLiteral||e.type.kind===c.ReflectionKind.class){let t=c.ReflectionClass.from(e.type);for(let e of t.getProperties()){let t=e.getType();if(a.options[e.getNameAsString()]={name:e.getNameAsString(),alias:e.getTags().alias??[],title:e.getTags().title||(0,o.titleCase)(e.getNameAsString()),description:e.getDescription(),kind:t.kind,optional:e.isOptional(),default:e.getDefaultValue(),variadic:!1},a.options[e.getNameAsString()].description??=`The ${a.options[e.getNameAsString()].title} option.`,t.kind===c.ReflectionKind.array)if(t.type.kind===c.ReflectionKind.string||t.type.kind===c.ReflectionKind.number)a.options[e.getNameAsString()].variadic=!0,a.options[e.getNameAsString()].kind=t.type.kind;else throw Error(`Unsupported array type for option "${e.getNameAsString()}" in command "${n.name}". Only string[] and number[] are supported.`);else if(t.kind!==c.ReflectionKind.boolean&&t.kind!==c.ReflectionKind.string&&t.kind!==c.ReflectionKind.number)throw Error(`Unsupported type for option "${e.getNameAsString()}" in command "${n.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0,c.stringifyType)(t).trim().replaceAll(` | `,`, or `)}.`)}}}}for(let t of e.inputs.filter(e=>e.path.length===n.path.length+1&&e.path.slice(0,n.path.length).every((e,t)=>e===n.path[t])))a.children[t.name]=await g(e,t,a);return a}exports.findCommandName=h,exports.findCommandsRoot=m,exports.reflectCommandTree=g,exports.resolveCommandPath=p;
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+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_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 __powerlines_deepkit_reflect_type = require("@powerlines/deepkit/reflect-type");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __stryke_path_common = require("@stryke/path/common");
+let __stryke_path_normalize = require("@stryke/path/normalize");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+
+//#region src/helpers/resolve-command.ts
+function resolveCommandPath(context, file) {
+	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "");
+}
+function findCommandsRoot(context) {
+	if ((0, __stryke_type_checks_is_set_string.isSetString)(context.config.entry)) return (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)(context.config.entry), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
+	else if ((0, __stryke_type_checks_is_set_object.isSetObject)(context.config.entry) && "file" in context.config.entry) return (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)(context.config.entry.file), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
+	else if (Array.isArray(context.config.entry) && context.config.entry.length > 0) return (0, __stryke_path_common.commonPath)(context.config.entry.map((entry) => (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)((0, __stryke_type_checks_is_set_string.isSetString)(entry) ? entry : entry.file), context.config.projectRoot), context.workspaceConfig.workspaceRoot)));
+	return (0, __stryke_path_append.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 = (0, __stryke_path_file_path_fns.findFolderName)(file);
+	let count = 1;
+	while (name.startsWith("[") && name.endsWith("]")) name = (0, __stryke_path_file_path_fns.findFolderName)((0, __stryke_path_resolve_parent_path.resolveParentPath)(file, count++));
+	return name;
+}
+async function reflectCommandTree(context, command, parent) {
+	const title = command.title || `${parent?.title ? `${parent.title} - ` : ""}${(0, __stryke_string_format_title_case.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((0, __stryke_helpers_get_unique.getUniqueBy)(context.config.defaultOptions, (item) => item.name).map((option) => [option.name, option]));
+	else if ((0, __stryke_type_checks_is_function.isFunction)(context.config.defaultOptions)) commandTree.options = Object.fromEntries((0, __stryke_helpers_get_unique.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 (0, __powerlines_deepkit_reflect_type.reflectType)(context, command.entry.input);
+		if (type.kind !== __powerlines_deepkit_vendor_type.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 === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral || firstParam.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class) {
+				const optionsReflection = __powerlines_deepkit_vendor_type.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 || (0, __stryke_string_format_title_case.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 === __powerlines_deepkit_vendor_type.ReflectionKind.array) if (propertyType.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || propertyType.type.kind === __powerlines_deepkit_vendor_type.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 !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean && propertyType.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && propertyType.kind !== __powerlines_deepkit_vendor_type.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 ${(0, __powerlines_deepkit_vendor_type.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
+exports.findCommandName = findCommandName;
+exports.findCommandsRoot = findCommandsRoot;
+exports.reflectCommandTree = reflectCommandTree;
+exports.resolveCommandPath = resolveCommandPath;

package/dist/helpers/resolve-command.mjs

@@ -1 +1,88 @@
-import{getDefaultOptions as e}from"./get-default-options.mjs";import{appendPath as t}from"@stryke/path/append";import{findFilePath as n,findFolderName as r}from"@stryke/path/file-path-fns";import{replacePath as i}from"@stryke/path/replace";import{resolveParentPath as a}from"@stryke/path/resolve-parent-path";import{titleCase as o}from"@stryke/string-format/title-case";import{isSetObject as s}from"@stryke/type-checks/is-set-object";import{ReflectionClass as c,ReflectionKind as l,stringifyType as u}from"@powerlines/deepkit/vendor/type";import{reflectType as d}from"@powerlines/deepkit/reflect-type";import{commonPath as f}from"@stryke/path/common";import{stripStars as p}from"@stryke/path/normalize";import{isSetString as m}from"@stryke/type-checks/is-set-string";function h(e,t){return i(n(t),e.commandsPath).replaceAll(/^\/+/g,``).replaceAll(/\/+$/g,``)}function g(e){return m(e.config.entry)?t(t(p(e.config.entry),e.config.projectRoot),e.workspaceConfig.workspaceRoot):s(e.config.entry)&&`file`in e.config.entry?t(t(p(e.config.entry.file),e.config.projectRoot),e.workspaceConfig.workspaceRoot):Array.isArray(e.config.entry)&&e.config.entry.length>0?f(e.config.entry.map(n=>t(t(p(m(n)?n:n.file),e.config.projectRoot),e.workspaceConfig.workspaceRoot))):t(e.config.sourceRoot||e.config.projectRoot,e.workspaceConfig.workspaceRoot)}function _(e){let t=r(e),n=1;for(;t.startsWith(`[`)&&t.endsWith(`]`);)t=r(a(e,n++));return t}async function v(t,n,r){let i=n.title||`${r?.title?`${r.title} - `:``}${o(n.name)}`,a={...n,title:i,description:n.description||`The ${i} ${r?`sub-`:``}command.`,options:Object.fromEntries(e(t,n).map(e=>[e.name,e])),params:[],parent:r??null,children:{}};if(n.isVirtual)t.trace(`Adding reflection for virtual command: ${n.id}`);else{if(!n.entry.input?.file||!t.fs.existsSync(n.entry.input.file))throw Error(`${n.entry.input?.file?`Non-existent`:`Missing`} command entry file for "${n.name}"`);t.trace(`Adding reflection for user-defined command: ${n.id} (file: ${n.entry.input.file})`);let e=await d(t,n.entry.input);if(e.kind!==l.function)throw Error(`The command entry file "${n.entry.input.file}" does not export a valid function.`);if(e.parameters.length>0&&e.parameters[0]){let t=e.parameters[0];if(t.type.kind===l.objectLiteral||t.type.kind===l.class){let e=c.from(t.type);for(let t of e.getProperties()){let e=t.getType();if(a.options[t.getNameAsString()]={name:t.getNameAsString(),alias:t.getTags().alias??[],title:t.getTags().title||o(t.getNameAsString()),description:t.getDescription(),kind:e.kind,optional:t.isOptional(),default:t.getDefaultValue(),variadic:!1},a.options[t.getNameAsString()].description??=`The ${a.options[t.getNameAsString()].title} option.`,e.kind===l.array)if(e.type.kind===l.string||e.type.kind===l.number)a.options[t.getNameAsString()].variadic=!0,a.options[t.getNameAsString()].kind=e.type.kind;else throw Error(`Unsupported array type for option "${t.getNameAsString()}" in command "${n.name}". Only string[] and number[] are supported.`);else if(e.kind!==l.boolean&&e.kind!==l.string&&e.kind!==l.number)throw Error(`Unsupported type for option "${t.getNameAsString()}" in command "${n.name}". Only string, number, boolean, string[] and number[] are supported, received ${u(e).trim().replaceAll(` | `,`, or `)}.`)}}}}for(let e of t.inputs.filter(e=>e.path.length===n.path.length+1&&e.path.slice(0,n.path.length).every((e,t)=>e===n.path[t])))a.children[e.name]=await v(t,e,a);return a}export{_ as findCommandName,g as findCommandsRoot,v as reflectCommandTree,h 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/path/replace`),r=require(`@stryke/type-checks/is-set-object`),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,n.replaceExtension)(e))}.${t===`cjs`||Array.isArray(t)&&t.includes(`cjs`)?`cjs`:`mjs`}`}async function l(e){let n=(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(n,o.StormJSON.stringify(e.packageJson))):!(0,r.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(n,o.StormJSON.stringify(e.packageJson))),!(0,r.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{replaceExtension as t}from"@stryke/path/replace";import{isSetObject as n}from"@stryke/type-checks/is-set-object";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,n){return`./bin/${o(t(e))}.${n===`cjs`||Array.isArray(n)&&n.includes(`cjs`)?`cjs`:`mjs`}`}async function c(t){let o=e(t.workspaceConfig.workspaceRoot,t.config.projectRoot,`package.json`);if(t.config.bin&&Array.isArray(t.config.bin)&&t.config.bin.length>0?(t.packageJson.bin=Object.fromEntries(i(r(t.config.bin)).map(e=>[e,s(e,t.config.output.format)])),await t.fs.write(o,a.stringify(t.packageJson))):!n(t.packageJson.bin)&&(t.config.name||t.packageJson.name)&&(t.packageJson.bin={[t.config.name||t.packageJson.name]:s(t.config.name||t.packageJson.name,t.config.output.format)},await t.fs.write(o,a.stringify(t.packageJson))),!n(t.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.");t.config.bin=Object.keys(t.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

@@ -1 +1,41 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/string-format/title-case`),n=require(`@stryke/type-checks/is-set-string`),r=require(`@stryke/string-format/kebab-case`);function i(e){let t=e.config.bin&&((0,n.isSetString)(e.config.bin)||Array.isArray(e.config.bin)&&e.config.bin.length>0&&e.config.bin[0])?(0,n.isSetString)(e.config.bin)?e.config.bin:e.config.bin[0]:e.config.name||e.packageJson?.name;if(!(0,n.isSetString)(t))throw 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,r.kebabCase)(t)}function a(e){return(0,t.titleCase)(e.config.name||i(e))}function o(e){return e.config.description||e.packageJson?.description||`The ${a(e)} command-line interface application.`}exports.getAppDescription=o,exports.getAppName=i,exports.getAppTitle=a;
+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

@@ -1 +1,38 @@
-import{titleCase as e}from"@stryke/string-format/title-case";import{isSetString as t}from"@stryke/type-checks/is-set-string";import{kebabCase as n}from"@stryke/string-format/kebab-case";function r(e){let r=e.config.bin&&(t(e.config.bin)||Array.isArray(e.config.bin)&&e.config.bin.length>0&&e.config.bin[0])?t(e.config.bin)?e.config.bin:e.config.bin[0]:e.config.name||e.packageJson?.name;if(!t(r))throw Error(`No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.`);return n(r)}function i(t){return e(t.config.name||r(t))}function a(e){return e.config.description||e.packageJson?.description||`The ${i(e)} command-line interface application.`}export{a as getAppDescription,r as getAppName,i as getAppTitle};
+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 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./helpers/get-default-options.cjs`),t=require(`./powerlines.cjs`),n=require(`./api.cjs`),r=require(`./config.cjs`);async function i(e={}){return e.root??=process.cwd(),n.ShellShockAPI.from(e)}var a=n.ShellShockAPI;exports.ShellShockAPI=n.ShellShockAPI,exports.createShellShock=i,exports.default=a,exports.defineConfig=r.defineConfig,exports.getDefaultOptions=e.getDefaultOptions,exports.shellShock=t.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

@@ -3,9 +3,9 @@ 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 { getDefaultOptions } from "./helpers/get-default-options.cjs";
 import shellShock from "./powerlines.cjs";
 import { BaseCommandOptions } from "./types/options.cjs";
+import "./types/index.cjs";
 
 //#region src/index.d.ts
 
@@ -17,4 +17,4 @@ import { BaseCommandOptions } from "./types/options.cjs";
  */
 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, getDefaultOptions, shellShock };
+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

@@ -3,7 +3,6 @@ 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 { getDefaultOptions } from "./helpers/get-default-options.mjs";
 import shellShock from "./powerlines.mjs";
 import { BaseCommandOptions } from "./types/options.mjs";
 import "./types/index.mjs";
@@ -18,4 +17,4 @@ import "./types/index.mjs";
  */
 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, getDefaultOptions, shellShock };
+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{getDefaultOptions as e}from"./helpers/get-default-options.mjs";import{shellShock as t}from"./powerlines.mjs";import{ShellShockAPI as n}from"./api.mjs";import{defineConfig as r}from"./config.mjs";async function i(e={}){return e.root??=process.cwd(),n.from(e)}var a=n;export{n as ShellShockAPI,i as createShellShock,a as default,r as defineConfig,e as getDefaultOptions,t 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 };