@shell-shock/core 0.2.1 → 0.3.0

package/dist/helpers/resolve-command.mjs

@@ -1,18 +1,46 @@
-import { getUniqueBy } from "@stryke/helpers/get-unique";
+import { getAppTitle, getVariableCommandPathName, isVariableCommandPath } from "../plugin-utils/context-helpers.mjs";
+import { getDefaultOptions } from "./utilities.mjs";
 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 { constantCase } from "@stryke/string-format/constant-case";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { titleCase } from "@stryke/string-format/title-case";
+import { ReflectionClass, ReflectionKind, ReflectionVisibility, stringifyType } from "@powerlines/deepkit/vendor/type";
 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
+/**
+* Resolves the description for a command option based on its reflection.
+*
+* @param propertyReflection - The reflection property of the command option.
+* @returns The resolved description for the command option.
+*/
+function resolveCommandDescription(propertyReflection) {
+	return propertyReflection.getDescription()?.trim() || `A${propertyReflection.isOptional() && !propertyReflection.getDefaultValue() ? "n optional" : ""} ${propertyReflection.getType().kind === ReflectionKind.boolean ? "flag provided via the command-line" : "command-line option"} that allows the user to ${propertyReflection.getType().kind === ReflectionKind.boolean ? "set the" : propertyReflection.getType().kind === ReflectionKind.array ? "specify custom" : "specify a custom"} ${propertyReflection.getTags().title?.trim() || titleCase(propertyReflection.getNameAsString())} ${propertyReflection.getType().kind === ReflectionKind.boolean ? "indicator" : `${propertyReflection.getType().kind === ReflectionKind.number ? "numeric" : "string"} value${propertyReflection.getType().kind === ReflectionKind.array ? "s" : ""}`} that will be used in the application.`;
+}
+function resolveCommandId(context, file) {
+	return replacePath(findFilePath(file), context.commandsPath).split("/").filter((p) => Boolean(p) && !isVariableCommandPath(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
+}
+/**
+* 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 resolveCommandName(file) {
+	let path = findFilePath(file);
+	let name = findFolderName(file, { requireExtension: true });
+	while (isVariableCommandPath(name)) {
+		path = resolveParentPath(path);
+		name = findFolderName(path, { requireExtension: true });
+	}
+	return name;
+}
 function resolveCommandPath(context, file) {
 	return replacePath(findFilePath(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "");
 }
@@ -23,35 +51,46 @@ function findCommandsRoot(context) {
 	return appendPath(context.config.sourceRoot || context.config.projectRoot, context.workspaceConfig.workspaceRoot);
 }
 /**
-* Finds the command name from the given file path.
+* Extracts command parameter information from a type parameter reflection.
 *
-* @param file - The file path to extract the command name from.
-* @returns The command name.
+* @param param - The type parameter reflection to extract information from.
+* @returns The extracted command parameter information.
 */
-function findCommandName(file) {
-	let name = findFolderName(file);
-	let count = 1;
-	while (name.startsWith("[") && name.endsWith("]")) name = findFolderName(resolveParentPath(file, count++));
-	return name;
+function extractCommandParameters(param) {
+	return {
+		name: param.name,
+		description: param.description,
+		optional: !!param.optional,
+		variadic: param.type.kind === ReflectionKind.array,
+		default: param.default
+	};
 }
+/**
+* Reflects the command tree for a given command input.
+*
+* @param context - The context in which the command is being reflected.
+* @param command - The command input to reflect.
+* @param parent - The parent command tree, if any.
+* @returns The reflected command tree.
+*/
 async function reflectCommandTree(context, command, parent) {
-	const title = command.title || `${parent?.title ? `${parent.title} - ` : ""}${titleCase(command.name)}`;
-	const commandTree = {
+	const title = command.title || `${parent?.title ? `${parent.title} - ` : ""}${titleCase(command.name)}${command.isVirtual ? " Commands" : ""}`;
+	const tree = {
 		...command,
 		title,
-		description: command.description || `The ${title} ${parent ? "sub-" : ""}command.`,
-		options: {},
+		description: command.description || (command.isVirtual ? `A collection of available ${command.title || titleCase(command.name)} commands that are included in the ${getAppTitle(context)} command-line application.` : `The ${title} executable command-line interface.`),
+		path: {
+			...command.path,
+			variables: {}
+		},
+		options: getDefaultOptions(context, command),
 		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.isVirtual) {
 		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})`);
+		context.debug(`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]) {
@@ -60,29 +99,74 @@ async function reflectCommandTree(context, command, parent) {
 				const optionsReflection = ReflectionClass.from(firstParam.type);
 				for (const propertyReflection of optionsReflection.getProperties()) {
 					const propertyType = propertyReflection.getType();
-					commandTree.options[propertyReflection.getNameAsString()] = {
+					tree.options[propertyReflection.getNameAsString()] = {
 						name: propertyReflection.getNameAsString(),
 						alias: propertyReflection.getTags().alias ?? [],
-						title: propertyReflection.getTags().title || titleCase(propertyReflection.getNameAsString()),
-						description: propertyReflection.getDescription(),
+						title: propertyReflection.getTags().title?.trim() || titleCase(propertyReflection.getNameAsString()),
+						description: resolveCommandDescription(propertyReflection),
+						env: constantCase(propertyReflection.getNameAsString()),
 						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;
+						tree.options[propertyReflection.getNameAsString()].variadic = true;
+						tree.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 ")}.`);
 				}
 			}
+			tree.path.variables = tree.path.segments.filter((segment) => isVariableCommandPath(segment)).reduce((obj, segment, index) => {
+				if (type.parameters.length < index + 2 || !type.parameters[index + 1]) return obj;
+				const paramName = getVariableCommandPathName(segment);
+				obj[paramName] = extractCommandParameters(type.parameters[index + 1]);
+				obj[paramName].description = obj[paramName].description || `The ${paramName} variable for the ${command.name} command.`;
+				return obj;
+			}, {});
+			if (type.parameters.length > 1) type.parameters.slice(tree.path.segments.filter((segment) => isVariableCommandPath(segment)).length + 1).forEach((param) => {
+				tree.params.push(extractCommandParameters(param));
+			});
 		}
 	}
-	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;
+	if (context.env) {
+		if (isSetObject(tree.options)) Object.values(tree.options).filter((option) => option.env !== false).forEach((option) => {
+			context.env.types.env.addProperty({
+				name: option.env,
+				optional: option.optional ? true : void 0,
+				description: option.description,
+				visibility: ReflectionVisibility.public,
+				type: option.kind === ReflectionKind.string || option.kind === ReflectionKind.number ? option.variadic ? {
+					kind: ReflectionKind.array,
+					type: { kind: option.kind }
+				} : { kind: option.kind } : { kind: ReflectionKind.boolean },
+				default: option.default,
+				tags: {
+					title: option.title,
+					alias: option.alias.filter((alias) => alias.length > 0).map((alias) => constantCase(alias)),
+					domain: "cli"
+				}
+			});
+		});
+		if (tree.params) tree.params.forEach((param) => {
+			context.env.types.env.addProperty({
+				name: constantCase(param.name),
+				optional: param.optional ? true : void 0,
+				description: param.description,
+				visibility: ReflectionVisibility.public,
+				type: param.variadic ? {
+					kind: ReflectionKind.array,
+					type: { kind: ReflectionKind.string }
+				} : { kind: ReflectionKind.string },
+				default: param.default,
+				tags: { domain: "cli" }
+			});
+		});
+	}
+	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !isVariableCommandPath(segment)).length === command.path.segments.filter((segment) => !isVariableCommandPath(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
+	return tree;
 }
 
 //#endregion
-export { findCommandName, findCommandsRoot, reflectCommandTree, resolveCommandPath };
+export { findCommandsRoot, reflectCommandTree, resolveCommandId, resolveCommandName, resolveCommandPath };
+//# sourceMappingURL=resolve-command.mjs.map

package/dist/helpers/resolve-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-command.mjs","names":["reflectType","ReflectionClass","ReflectionKind","ReflectionVisibility","stringifyType","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","getAppTitle","getVariableCommandPathName","isVariableCommandPath","getDefaultOptions","resolveCommandDescription","propertyReflection","getDescription","trim","isOptional","getDefaultValue","getType","kind","boolean","array","getTags","title","getNameAsString","number","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","name","requireExtension","resolveCommandPath","resolveCommandParams","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandParameters","param","description","optional","variadic","type","default","reflectCommandTree","command","parent","isVirtual","tree","variables","options","params","children","input","fs","existsSync","Error","debug","id","function","parameters","firstParam","objectLiteral","class","optionsReflection","from","getProperties","propertyType","alias","env","string","segments","segment","reduce","obj","index","paramName","slice","forEach","push","Object","values","option","types","addProperty","undefined","visibility","public","tags","domain","inputs","every","value"],"sources":["../../src/helpers/resolve-command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { reflectType } from \"@powerlines/deepkit/reflect-type\";\nimport type {\n  ReflectionProperty,\n  TypeParameter\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  ReflectionClass,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { stripStars } from \"@stryke/path/normalize\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport {\n  getAppTitle,\n  getVariableCommandPathName,\n  isVariableCommandPath\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandInput,\n  CommandParam,\n  CommandTree,\n  NumberCommandOption,\n  StringCommandOption\n} from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { getDefaultOptions } from \"./utilities\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param propertyReflection - The reflection property of the command option.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandDescription(\n  propertyReflection: ReflectionProperty\n): string {\n  return (\n    propertyReflection.getDescription()?.trim() ||\n    `A${\n      propertyReflection.isOptional() && !propertyReflection.getDefaultValue()\n        ? \"n optional\"\n        : \"\"\n    } ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"flag provided via the command-line\"\n        : \"command-line option\"\n    } that allows the user to ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"set the\"\n        : propertyReflection.getType().kind === ReflectionKind.array\n          ? \"specify custom\"\n          : \"specify a custom\"\n    } ${\n      propertyReflection.getTags().title?.trim() ||\n      titleCase(propertyReflection.getNameAsString())\n    } ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"indicator\"\n        : `${propertyReflection.getType().kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n            propertyReflection.getType().kind === ReflectionKind.array\n              ? \"s\"\n              : \"\"\n          }`\n    } that will be used in the application.`\n  );\n}\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isVariableCommandPath(p))\n    .join(\"/\")\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .replaceAll(\"/\", \"-\");\n}\n\n/**\n * Finds the command name from the given file path.\n *\n * @param file - The file path to extract the command name from.\n * @returns The command name.\n */\nexport function resolveCommandName(file: string) {\n  let path = findFilePath(file);\n  let name = findFolderName(file, {\n    requireExtension: true\n  });\n\n  while (isVariableCommandPath(name)) {\n    path = resolveParentPath(path);\n    name = findFolderName(path, {\n      requireExtension: true\n    });\n  }\n\n  return name;\n}\n\nexport function resolveCommandPath(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\");\n}\n\nexport function resolveCommandParams(context: Context, file: string): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && isVariableCommandPath(p))\n    .map(p => p.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\"));\n}\n\nexport function findCommandsRoot(context: Context): string {\n  if (isSetString(context.config.entry)) {\n    return appendPath(\n      appendPath(stripStars(context.config.entry), context.config.projectRoot),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    isSetObject(context.config.entry) &&\n    \"file\" in context.config.entry\n  ) {\n    return appendPath(\n      appendPath(\n        stripStars(context.config.entry.file),\n        context.config.projectRoot\n      ),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    Array.isArray(context.config.entry) &&\n    context.config.entry.length > 0\n  ) {\n    return commonPath(\n      context.config.entry.map(entry =>\n        appendPath(\n          appendPath(\n            stripStars(isSetString(entry) ? entry : entry.file),\n            context.config.projectRoot\n          ),\n          context.workspaceConfig.workspaceRoot\n        )\n      )\n    );\n  }\n\n  return appendPath(\n    context.config.sourceRoot || context.config.projectRoot,\n    context.workspaceConfig.workspaceRoot\n  );\n}\n\n/**\n * Extracts command parameter information from a type parameter reflection.\n *\n * @param param - The type parameter reflection to extract information from.\n * @returns The extracted command parameter information.\n */\nexport function extractCommandParameters(param: TypeParameter): CommandParam {\n  return {\n    name: param.name,\n    description: param.description,\n    optional: !!param.optional,\n    variadic: param.type.kind === ReflectionKind.array,\n    default: param.default\n  } as CommandParam;\n}\n\n/**\n * Reflects the command tree for a given command input.\n *\n * @param context - The context in which the command is being reflected.\n * @param command - The command input to reflect.\n * @param parent - The parent command tree, if any.\n * @returns The reflected command tree.\n */\nexport async function reflectCommandTree<TContext extends Context = Context>(\n  context: TContext,\n  command: CommandInput,\n  parent?: CommandTree\n): Promise<CommandTree> {\n  const title =\n    command.title ||\n    `${parent?.title ? `${parent.title} - ` : \"\"}${titleCase(command.name)}${\n      command.isVirtual ? \" Commands\" : \"\"\n    }`;\n\n  const tree = {\n    ...command,\n    title,\n    description:\n      command.description ||\n      (command.isVirtual\n        ? `A collection of available ${command.title || titleCase(command.name)} commands that are included in the ${getAppTitle(\n            context\n          )} command-line application.`\n        : `The ${title} executable command-line interface.`),\n    path: {\n      ...command.path,\n      variables: {}\n    },\n    options: getDefaultOptions(context, command),\n    params: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    const type = await reflectType<TContext>(context, command.entry.input);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `The command entry file \"${command.entry.input.file}\" does not export a valid function.`\n      );\n    }\n\n    if (type.parameters.length > 0 && type.parameters[0]) {\n      const firstParam = type.parameters[0];\n      if (\n        firstParam.type.kind === ReflectionKind.objectLiteral ||\n        firstParam.type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(firstParam.type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          const propertyType = propertyReflection.getType();\n\n          tree.options[propertyReflection.getNameAsString()] = {\n            name: propertyReflection.getNameAsString(),\n            alias: propertyReflection.getTags().alias ?? [],\n            title:\n              propertyReflection.getTags().title?.trim() ||\n              titleCase(propertyReflection.getNameAsString()),\n            description: resolveCommandDescription(propertyReflection),\n            env: constantCase(propertyReflection.getNameAsString()),\n            kind: propertyType.kind as\n              | ReflectionKind.string\n              | ReflectionKind.number\n              | ReflectionKind.boolean,\n            optional: propertyReflection.isOptional(),\n            default: propertyReflection.getDefaultValue(),\n            variadic: false\n          };\n          if (propertyType.kind === ReflectionKind.array) {\n            if (\n              propertyType.type.kind === ReflectionKind.string ||\n              propertyType.type.kind === ReflectionKind.number\n            ) {\n              (\n                tree.options[propertyReflection.getNameAsString()] as\n                  | StringCommandOption\n                  | NumberCommandOption\n              ).variadic = true;\n              (\n                tree.options[propertyReflection.getNameAsString()] as\n                  | StringCommandOption\n                  | NumberCommandOption\n              ).kind = propertyType.type.kind;\n            } else {\n              throw new Error(\n                `Unsupported array type for option \"${propertyReflection.getNameAsString()}\" in command \"${\n                  command.name\n                }\". Only string[] and number[] are supported.`\n              );\n            }\n          } else if (\n            propertyType.kind !== ReflectionKind.boolean &&\n            propertyType.kind !== ReflectionKind.string &&\n            propertyType.kind !== ReflectionKind.number\n          ) {\n            throw new Error(\n              `Unsupported type for option \"${propertyReflection.getNameAsString()}\" in command \"${\n                command.name\n              }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n                propertyType\n              )\n                .trim()\n                .replaceAll(\" | \", \", or \")}.`\n            );\n          }\n        }\n      }\n\n      tree.path.variables = tree.path.segments\n        .filter(segment => isVariableCommandPath(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (\n              type.parameters.length < index + 2 ||\n              !type.parameters[index + 1]\n            ) {\n              return obj;\n            }\n\n            const paramName = getVariableCommandPathName(segment);\n            obj[paramName] = extractCommandParameters(\n              type.parameters[index + 1]!\n            );\n            obj[paramName].description =\n              obj[paramName].description ||\n              `The ${paramName} variable for the ${command.name} command.`;\n\n            return obj;\n          },\n          {} as Record<string, CommandParam>\n        );\n\n      if (type.parameters.length > 1) {\n        type.parameters\n          .slice(\n            tree.path.segments.filter(segment => isVariableCommandPath(segment))\n              .length + 1\n          )\n          .forEach(param => {\n            tree.params.push(extractCommandParameters(param));\n          });\n      }\n    }\n  }\n\n  if (context.env) {\n    if (isSetObject(tree.options)) {\n      Object.values(tree.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type:\n              option.kind === ReflectionKind.string ||\n              option.kind === ReflectionKind.number\n                ? option.variadic\n                  ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                  : { kind: option.kind }\n                : { kind: ReflectionKind.boolean },\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    if (tree.params) {\n      tree.params.forEach(param => {\n        context.env.types.env.addProperty({\n          name: constantCase(param.name),\n          optional: param.optional ? true : undefined,\n          description: param.description,\n          visibility: ReflectionVisibility.public,\n          type: param.variadic\n            ? {\n                kind: ReflectionKind.array,\n                type: { kind: ReflectionKind.string }\n              }\n            : { kind: ReflectionKind.string },\n          default: param.default,\n          tags: {\n            domain: \"cli\"\n          }\n        });\n      });\n    }\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.path.segments.filter(segment => !isVariableCommandPath(segment))\n        .length ===\n        command.path.segments.filter(segment => !isVariableCommandPath(segment))\n          .length +\n          1 &&\n      input.path.segments\n        .slice(0, command.path.segments.length)\n        .every((value, index) => value === command.path.segments[index])\n  )) {\n    tree.children[input.name] = await reflectCommandTree(context, input, tree);\n  }\n\n  return tree;\n}\n"],"mappings":"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"}

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

@@ -1,23 +1,29 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
 let __stryke_path_join_paths = require("@stryke/path/join-paths");
-let __stryke_path_replace = require("@stryke/path/replace");
+let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 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_helpers_get_unique = require("@stryke/helpers/get-unique");
 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"}`;
+function formatBinaryPath(format) {
+	return `./dist/bin.${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)]));
+		context.packageJson.bin = Object.fromEntries((0, __stryke_helpers_get_unique.getUnique)((0, __stryke_convert_to_array.toArray)(context.config.bin)).map((bin) => [bin, formatBinaryPath(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) };
+	} else {
+		if (Array.isArray(context.config.output.format) && context.config.output.format.length > 1) {
+			context.packageJson.bin = { [(0, __stryke_string_format_kebab_case.kebabCase)(require_plugin_utils_context_helpers.getAppName(context))]: formatBinaryPath((0, __stryke_convert_to_array.toArray)(context.config.output.format)[0]) };
+			context.packageJson.bin = (0, __stryke_convert_to_array.toArray)(context.config.output.format).reduce((ret, format) => {
+				ret[`${(0, __stryke_string_format_kebab_case.kebabCase)(require_plugin_utils_context_helpers.getAppName(context))}-${format}`] = formatBinaryPath(format);
+				return ret;
+			}, context.packageJson.bin);
+		} else context.packageJson.bin = { [(0, __stryke_string_format_kebab_case.kebabCase)(require_plugin_utils_context_helpers.getAppName(context))]: formatBinaryPath(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.");
@@ -25,4 +31,6 @@ async function updatePackageJsonBinary(context) {
 }
 
 //#endregion
-exports.updatePackageJsonBinary = updatePackageJsonBinary;
+exports.formatBinaryPath = formatBinaryPath;
+exports.updatePackageJsonBinary = updatePackageJsonBinary;
+//# sourceMappingURL=update-package-json.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-package-json.cjs","names":["toArray","getUnique","StormJSON","joinPaths","kebabCase","isSetObject","getAppName","formatBinaryPath","format","Array","isArray","includes","updatePackageJsonBinary","context","packageJsonPath","workspaceConfig","workspaceRoot","config","projectRoot","bin","length","packageJson","Object","fromEntries","map","output","fs","write","stringify","reduce","ret","Error","keys"],"sources":["../../src/helpers/update-package-json.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getAppName } from \"../plugin-utils/context-helpers\";\nimport type { UnresolvedContext } from \"../types/context\";\n\nexport function formatBinaryPath(\n  format: string | string[] | undefined\n): string {\n  return `./dist/bin.${\n    format === \"cjs\" || (Array.isArray(format) && format.includes(\"cjs\"))\n      ? \"cjs\"\n      : \"mjs\"\n  }`;\n}\n\nexport async function updatePackageJsonBinary(\n  context: UnresolvedContext\n): Promise<void> {\n  const packageJsonPath = joinPaths(\n    context.workspaceConfig.workspaceRoot,\n    context.config.projectRoot,\n    \"package.json\"\n  );\n  if (\n    context.config.bin &&\n    Array.isArray(context.config.bin) &&\n    context.config.bin.length > 0\n  ) {\n    context.packageJson.bin = Object.fromEntries(\n      getUnique(toArray(context.config.bin)).map(bin => [\n        bin,\n        formatBinaryPath(context.config.output.format)\n      ])\n    );\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  } else {\n    if (\n      Array.isArray(context.config.output.format) &&\n      context.config.output.format.length > 1\n    ) {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          toArray(context.config.output.format)[0]\n        )\n      };\n      context.packageJson.bin = toArray(context.config.output.format).reduce(\n        (ret, format) => {\n          ret[`${kebabCase(getAppName(context))}-${format}`] =\n            formatBinaryPath(format);\n\n          return ret;\n        },\n        context.packageJson.bin\n      );\n    } else {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          context.config.output.format\n        )\n      };\n    }\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  }\n\n  if (!isSetObject(context.packageJson.bin)) {\n    throw new Error(\n      \"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    );\n  }\n\n  context.config.bin = Object.keys(context.packageJson.bin);\n}\n"],"mappings":";;;;;;;;;;AA2BA,SAAgBO,iBACdC,QACQ;AACR,QAAO,cACLA,WAAW,SAAUC,MAAMC,QAAQF,OAAO,IAAIA,OAAOG,SAAS,MAAO,GACjE,QACA;;AAIR,eAAsBC,wBACpBC,SACe;CACf,MAAMC,0DACJD,QAAQE,gBAAgBC,eACxBH,QAAQI,OAAOC,aACf,eACD;AACD,KACEL,QAAQI,OAAOE,OACfV,MAAMC,QAAQG,QAAQI,OAAOE,IAAI,IACjCN,QAAQI,OAAOE,IAAIC,SAAS,GAC5B;AACAP,UAAQQ,YAAYF,MAAMG,OAAOC,8FACbV,QAAQI,OAAOE,IAAI,CAAC,CAACK,KAAIL,QAAO,CAChDA,KACAZ,iBAAiBM,QAAQI,OAAOQ,OAAOjB,OAAO,CAC/C,CACH,CAAC;AAED,QAAMK,QAAQa,GAAGC,MACfb,iBACAZ,mCAAU0B,UAAUf,QAAQQ,YAC9B,CAAC;QACI;AACL,MACEZ,MAAMC,QAAQG,QAAQI,OAAOQ,OAAOjB,OAAO,IAC3CK,QAAQI,OAAOQ,OAAOjB,OAAOY,SAAS,GACtC;AACAP,WAAQQ,YAAYF,MAAM,oDACbb,gDAAWO,QAAQ,CAAC,GAAGN,wDACxBM,QAAQI,OAAOQ,OAAOjB,OAAO,CAAC,GACxC,EACD;AACDK,WAAQQ,YAAYF,6CAAcN,QAAQI,OAAOQ,OAAOjB,OAAO,CAACqB,QAC7DC,KAAKtB,WAAW;AACfsB,QAAI,oDAAaxB,gDAAWO,QAAQ,CAAC,CAAA,GAAIL,YACvCD,iBAAiBC,OAAO;AAE1B,WAAOsB;MAETjB,QAAQQ,YAAYF,IACrB;QAEDN,SAAQQ,YAAYF,MAAM,oDACbb,gDAAWO,QAAQ,CAAC,GAAGN,iBAChCM,QAAQI,OAAOQ,OAAOjB,OACxB,EACD;AAGH,QAAMK,QAAQa,GAAGC,MACfb,iBACAZ,mCAAU0B,UAAUf,QAAQQ,YAC9B,CAAC;;AAGH,KAAI,qDAAaR,QAAQQ,YAAYF,IAAI,CACvC,OAAM,IAAIY,MACR,0KACD;AAGHlB,SAAQI,OAAOE,MAAMG,OAAOU,KAAKnB,QAAQQ,YAAYF,IAAI"}

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

@@ -1,22 +1,28 @@
-import { getUnique } from "@stryke/helpers/get-unique";
+import { getAppName } from "../plugin-utils/context-helpers.mjs";
+import { toArray } from "@stryke/convert/to-array";
 import { joinPaths } from "@stryke/path/join-paths";
-import { replaceExtension } from "@stryke/path/replace";
+import { kebabCase } from "@stryke/string-format/kebab-case";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
-import { toArray } from "@stryke/convert/to-array";
+import { getUnique } from "@stryke/helpers/get-unique";
 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"}`;
+function formatBinaryPath(format) {
+	return `./dist/bin.${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)]));
+		context.packageJson.bin = Object.fromEntries(getUnique(toArray(context.config.bin)).map((bin) => [bin, formatBinaryPath(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) };
+	} else {
+		if (Array.isArray(context.config.output.format) && context.config.output.format.length > 1) {
+			context.packageJson.bin = { [kebabCase(getAppName(context))]: formatBinaryPath(toArray(context.config.output.format)[0]) };
+			context.packageJson.bin = toArray(context.config.output.format).reduce((ret, format) => {
+				ret[`${kebabCase(getAppName(context))}-${format}`] = formatBinaryPath(format);
+				return ret;
+			}, context.packageJson.bin);
+		} else context.packageJson.bin = { [kebabCase(getAppName(context))]: formatBinaryPath(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.");
@@ -24,4 +30,5 @@ async function updatePackageJsonBinary(context) {
 }
 
 //#endregion
-export { updatePackageJsonBinary };
+export { formatBinaryPath, updatePackageJsonBinary };
+//# sourceMappingURL=update-package-json.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-package-json.mjs","names":["toArray","getUnique","StormJSON","joinPaths","kebabCase","isSetObject","getAppName","formatBinaryPath","format","Array","isArray","includes","updatePackageJsonBinary","context","packageJsonPath","workspaceConfig","workspaceRoot","config","projectRoot","bin","length","packageJson","Object","fromEntries","map","output","fs","write","stringify","reduce","ret","Error","keys"],"sources":["../../src/helpers/update-package-json.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getAppName } from \"../plugin-utils/context-helpers\";\nimport type { UnresolvedContext } from \"../types/context\";\n\nexport function formatBinaryPath(\n  format: string | string[] | undefined\n): string {\n  return `./dist/bin.${\n    format === \"cjs\" || (Array.isArray(format) && format.includes(\"cjs\"))\n      ? \"cjs\"\n      : \"mjs\"\n  }`;\n}\n\nexport async function updatePackageJsonBinary(\n  context: UnresolvedContext\n): Promise<void> {\n  const packageJsonPath = joinPaths(\n    context.workspaceConfig.workspaceRoot,\n    context.config.projectRoot,\n    \"package.json\"\n  );\n  if (\n    context.config.bin &&\n    Array.isArray(context.config.bin) &&\n    context.config.bin.length > 0\n  ) {\n    context.packageJson.bin = Object.fromEntries(\n      getUnique(toArray(context.config.bin)).map(bin => [\n        bin,\n        formatBinaryPath(context.config.output.format)\n      ])\n    );\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  } else {\n    if (\n      Array.isArray(context.config.output.format) &&\n      context.config.output.format.length > 1\n    ) {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          toArray(context.config.output.format)[0]\n        )\n      };\n      context.packageJson.bin = toArray(context.config.output.format).reduce(\n        (ret, format) => {\n          ret[`${kebabCase(getAppName(context))}-${format}`] =\n            formatBinaryPath(format);\n\n          return ret;\n        },\n        context.packageJson.bin\n      );\n    } else {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          context.config.output.format\n        )\n      };\n    }\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  }\n\n  if (!isSetObject(context.packageJson.bin)) {\n    throw new Error(\n      \"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    );\n  }\n\n  context.config.bin = Object.keys(context.packageJson.bin);\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgBO,iBACdC,QACQ;AACR,QAAO,cACLA,WAAW,SAAUC,MAAMC,QAAQF,OAAO,IAAIA,OAAOG,SAAS,MAAO,GACjE,QACA;;AAIR,eAAsBC,wBACpBC,SACe;CACf,MAAMC,kBAAkBX,UACtBU,QAAQE,gBAAgBC,eACxBH,QAAQI,OAAOC,aACf,eACD;AACD,KACEL,QAAQI,OAAOE,OACfV,MAAMC,QAAQG,QAAQI,OAAOE,IAAI,IACjCN,QAAQI,OAAOE,IAAIC,SAAS,GAC5B;AACAP,UAAQQ,YAAYF,MAAMG,OAAOC,YAC/BtB,UAAUD,QAAQa,QAAQI,OAAOE,IAAI,CAAC,CAACK,KAAIL,QAAO,CAChDA,KACAZ,iBAAiBM,QAAQI,OAAOQ,OAAOjB,OAAO,CAC/C,CACH,CAAC;AAED,QAAMK,QAAQa,GAAGC,MACfb,iBACAZ,UAAU0B,UAAUf,QAAQQ,YAC9B,CAAC;QACI;AACL,MACEZ,MAAMC,QAAQG,QAAQI,OAAOQ,OAAOjB,OAAO,IAC3CK,QAAQI,OAAOQ,OAAOjB,OAAOY,SAAS,GACtC;AACAP,WAAQQ,YAAYF,MAAM,GACvBf,UAAUE,WAAWO,QAAQ,CAAC,GAAGN,iBAChCP,QAAQa,QAAQI,OAAOQ,OAAOjB,OAAO,CAAC,GACxC,EACD;AACDK,WAAQQ,YAAYF,MAAMnB,QAAQa,QAAQI,OAAOQ,OAAOjB,OAAO,CAACqB,QAC7DC,KAAKtB,WAAW;AACfsB,QAAI,GAAG1B,UAAUE,WAAWO,QAAQ,CAAC,CAAA,GAAIL,YACvCD,iBAAiBC,OAAO;AAE1B,WAAOsB;MAETjB,QAAQQ,YAAYF,IACrB;QAEDN,SAAQQ,YAAYF,MAAM,GACvBf,UAAUE,WAAWO,QAAQ,CAAC,GAAGN,iBAChCM,QAAQI,OAAOQ,OAAOjB,OACxB,EACD;AAGH,QAAMK,QAAQa,GAAGC,MACfb,iBACAZ,UAAU0B,UAAUf,QAAQQ,YAC9B,CAAC;;AAGH,KAAI,CAAChB,YAAYQ,QAAQQ,YAAYF,IAAI,CACvC,OAAM,IAAIY,MACR,0KACD;AAGHlB,SAAQI,OAAOE,MAAMG,OAAOU,KAAKnB,QAAQQ,YAAYF,IAAI"}

package/dist/helpers/utilities.cjs

@@ -1,41 +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");
+let __stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+let __stryke_cli_utils_tree = require("@stryke/cli/utils/tree");
+let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
 
 //#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);
+function innerFormatCommandTree(command) {
+	return {
+		name: `${command.name}${command.isVirtual ? " (virtual)" : ""}`,
+		children: Object.values(command.children ?? {}).map(innerFormatCommandTree)
+	};
 }
-/**
-* 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));
+function formatCommandTree(context) {
+	return (0, __stryke_cli_utils_tree.formatTree)({
+		name: context.config.name,
+		children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)
+	});
 }
 /**
-* Retrieves the application description from the context and configuration.
+* Retrieves the default command options based on the context configuration.
 *
-* @param context - The build context containing workspace and package information.
-* @returns The application description.
+* @param context - The build context.
+* @param command - The command for which to retrieve default options.
+* @returns A record of default command options.
 */
-function getAppDescription(context) {
-	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context)} command-line interface application.`;
+function getDefaultOptions(context, command) {
+	let options;
+	if (Array.isArray(context.config.defaultOptions)) 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)) options = Object.fromEntries((0, __stryke_helpers_get_unique.getUniqueBy)(context.config.defaultOptions(context, command), (item) => item.name).map((option) => [option.name, option]));
+	else options = {};
+	return Object.fromEntries(Object.entries(options).map(([key, value]) => [key, {
+		...value,
+		env: value.env ?? (0, __stryke_string_format_constant_case.constantCase)(key)
+	}]));
 }
 
 //#endregion
-exports.getAppDescription = getAppDescription;
-exports.getAppName = getAppName;
-exports.getAppTitle = getAppTitle;
+exports.formatCommandTree = formatCommandTree;
+exports.getDefaultOptions = getDefaultOptions;
+//# sourceMappingURL=utilities.cjs.map

package/dist/helpers/utilities.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.cjs","names":["formatTree","getUniqueBy","constantCase","isFunction","innerFormatCommandTree","command","name","isVirtual","children","Object","values","map","formatCommandTree","context","config","commands","getDefaultOptions","options","Array","isArray","defaultOptions","fromEntries","item","option","entries","key","value","env"],"sources":["../../src/helpers/utilities.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the default command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve default options.\n * @returns A record of default command options.\n */\nexport function getDefaultOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.defaultOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.defaultOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.defaultOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.defaultOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;;AA0BA,SAASI,uBAAuBC,SAAgC;AAC9D,QAAO;EACLC,MAAM,GAAGD,QAAQC,OAAOD,QAAQE,YAAY,eAAe;EAC3DC,UAAUC,OAAOC,OAAOL,QAAQG,YAAY,EAAE,CAAC,CAACG,IAAIP,uBAAsB;EAC3E;;AAGH,SAAgBQ,kBAAkBC,SAA0B;AAC1D,gDAAkB;EAChBP,MAAMO,QAAQC,OAAOR;EACrBE,UAAUC,OAAOC,OAAOG,QAAQE,YAAY,EAAE,CAAC,CAACJ,IAAIP,uBAAsB;EAC3E,CAAC;;;;;;;;;AAUJ,SAAgBY,kBACdH,SACAR,SAC+B;CAC/B,IAAIY;AACJ,KAAIC,MAAMC,QAAQN,QAAQC,OAAOM,eAAe,CAC9CH,WAAUR,OAAOY,yDAEbR,QAAQC,OAAOM,iBACdE,SAAwBA,KAAKhB,KAC/B,CAACK,KAAIY,WAAU,CAACA,OAAOjB,MAAMiB,OAAO,CACvC,CAAC;2DACmBV,QAAQC,OAAOM,eAAe,CAClDH,WAAUR,OAAOY,yDAEbR,QAAQC,OAAOM,eAAeP,SAASR,QAAQ,GAC9CiB,SAAwBA,KAAKhB,KAC/B,CAACK,KAAIY,WAAU,CAACA,OAAOjB,MAAMiB,OAAO,CACvC,CAAC;KAEDN,WAAU,EAAE;AAGd,QAAOR,OAAOY,YACZZ,OAAOe,QAAQP,QAAQ,CAACN,KAAK,CAACc,KAAKC,WAAW,CAC5CD,KACA;EAAE,GAAGC;EAAOC,KAAKD,MAAMC,8DAAoBF,IAAG;EAAG,CAClD,CACH,CAAC"}

package/dist/helpers/utilities.mjs

@@ -1,38 +1,39 @@
-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";
+import { constantCase } from "@stryke/string-format/constant-case";
+import { formatTree } from "@stryke/cli/utils/tree";
+import { getUniqueBy } from "@stryke/helpers/get-unique";
+import { isFunction } from "@stryke/type-checks/is-function";
 
 //#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);
+function innerFormatCommandTree(command) {
+	return {
+		name: `${command.name}${command.isVirtual ? " (virtual)" : ""}`,
+		children: Object.values(command.children ?? {}).map(innerFormatCommandTree)
+	};
 }
-/**
-* 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));
+function formatCommandTree(context) {
+	return formatTree({
+		name: context.config.name,
+		children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)
+	});
 }
 /**
-* Retrieves the application description from the context and configuration.
+* Retrieves the default command options based on the context configuration.
 *
-* @param context - The build context containing workspace and package information.
-* @returns The application description.
+* @param context - The build context.
+* @param command - The command for which to retrieve default options.
+* @returns A record of default command options.
 */
-function getAppDescription(context) {
-	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context)} command-line interface application.`;
+function getDefaultOptions(context, command) {
+	let options;
+	if (Array.isArray(context.config.defaultOptions)) options = Object.fromEntries(getUniqueBy(context.config.defaultOptions, (item) => item.name).map((option) => [option.name, option]));
+	else if (isFunction(context.config.defaultOptions)) options = Object.fromEntries(getUniqueBy(context.config.defaultOptions(context, command), (item) => item.name).map((option) => [option.name, option]));
+	else options = {};
+	return Object.fromEntries(Object.entries(options).map(([key, value]) => [key, {
+		...value,
+		env: value.env ?? constantCase(key)
+	}]));
 }
 
 //#endregion
-export { getAppDescription, getAppName, getAppTitle };
+export { formatCommandTree, getDefaultOptions };
+//# sourceMappingURL=utilities.mjs.map

package/dist/helpers/utilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.mjs","names":["formatTree","getUniqueBy","constantCase","isFunction","innerFormatCommandTree","command","name","isVirtual","children","Object","values","map","formatCommandTree","context","config","commands","getDefaultOptions","options","Array","isArray","defaultOptions","fromEntries","item","option","entries","key","value","env"],"sources":["../../src/helpers/utilities.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the default command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve default options.\n * @returns A record of default command options.\n */\nexport function getDefaultOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.defaultOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.defaultOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.defaultOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.defaultOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;AA0BA,SAASI,uBAAuBC,SAAgC;AAC9D,QAAO;EACLC,MAAM,GAAGD,QAAQC,OAAOD,QAAQE,YAAY,eAAe;EAC3DC,UAAUC,OAAOC,OAAOL,QAAQG,YAAY,EAAE,CAAC,CAACG,IAAIP,uBAAsB;EAC3E;;AAGH,SAAgBQ,kBAAkBC,SAA0B;AAC1D,QAAOb,WAAW;EAChBM,MAAMO,QAAQC,OAAOR;EACrBE,UAAUC,OAAOC,OAAOG,QAAQE,YAAY,EAAE,CAAC,CAACJ,IAAIP,uBAAsB;EAC3E,CAAC;;;;;;;;;AAUJ,SAAgBY,kBACdH,SACAR,SAC+B;CAC/B,IAAIY;AACJ,KAAIC,MAAMC,QAAQN,QAAQC,OAAOM,eAAe,CAC9CH,WAAUR,OAAOY,YACfpB,YACEY,QAAQC,OAAOM,iBACdE,SAAwBA,KAAKhB,KAC/B,CAACK,KAAIY,WAAU,CAACA,OAAOjB,MAAMiB,OAAO,CACvC,CAAC;UACQpB,WAAWU,QAAQC,OAAOM,eAAe,CAClDH,WAAUR,OAAOY,YACfpB,YACEY,QAAQC,OAAOM,eAAeP,SAASR,QAAQ,GAC9CiB,SAAwBA,KAAKhB,KAC/B,CAACK,KAAIY,WAAU,CAACA,OAAOjB,MAAMiB,OAAO,CACvC,CAAC;KAEDN,WAAU,EAAE;AAGd,QAAOR,OAAOY,YACZZ,OAAOe,QAAQP,QAAQ,CAACN,KAAK,CAACc,KAAKC,WAAW,CAC5CD,KACA;EAAE,GAAGC;EAAOC,KAAKD,MAAMC,OAAOzB,aAAauB,IAAG;EAAG,CAClD,CACH,CAAC"}