@shell-shock/core 0.17.5 → 0.17.6

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { CommandParameterKinds, __ΩAsCommandParameterConfig, __ΩBaseCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩSerializedCommandTree, __ΩStringCommandParameter, __ΩStringCommandParameterConfig } from "./types/command.mjs";
+import { CommandParameterKinds, __ΩAsCommandParameterConfig, __ΩBaseBooleanCommandParameter, __ΩBaseCommandParameter, __ΩBaseNumberCommandParameter, __ΩBaseSingleCommandParameter, __ΩBaseStringCommandParameter, __ΩBaseVariadicCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩSerializedCommandTree, __ΩSingleBooleanCommandParameter, __ΩSingleNumberCommandParameter, __ΩSingleStringCommandParameter, __ΩStringCommandParameter, __ΩStringCommandParameterConfig, __ΩVariadicBooleanCommandParameter, __ΩVariadicNumberCommandParameter, __ΩVariadicStringCommandParameter } from "./types/command.mjs";
 import { __ΩOptions, __ΩOutputConfig, __ΩReferenceOptions, __ΩResolvedConfig, __ΩUserConfig } from "./types/config.mjs";
 import { __ΩContext, __ΩUnresolvedContext } from "./types/context.mjs";
 import { __ΩBaseCommandOptions } from "./types/options.mjs";
 import { ShellShockAPI, createShellShock } from "./api.mjs";
 
-export { CommandParameterKinds, ShellShockAPI, __ΩAsCommandParameterConfig, __ΩBaseCommandOptions, __ΩBaseCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩContext, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩOptions, __ΩOutputConfig, __ΩReferenceOptions, __ΩResolvedConfig, __ΩSerializedCommandTree, __ΩStringCommandParameter, __ΩStringCommandParameterConfig, __ΩUnresolvedContext, __ΩUserConfig, createShellShock };
+export { CommandParameterKinds, ShellShockAPI, __ΩAsCommandParameterConfig, __ΩBaseBooleanCommandParameter, __ΩBaseCommandOptions, __ΩBaseCommandParameter, __ΩBaseNumberCommandParameter, __ΩBaseSingleCommandParameter, __ΩBaseStringCommandParameter, __ΩBaseVariadicCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩContext, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩOptions, __ΩOutputConfig, __ΩReferenceOptions, __ΩResolvedConfig, __ΩSerializedCommandTree, __ΩSingleBooleanCommandParameter, __ΩSingleNumberCommandParameter, __ΩSingleStringCommandParameter, __ΩStringCommandParameter, __ΩStringCommandParameterConfig, __ΩUnresolvedContext, __ΩUserConfig, __ΩVariadicBooleanCommandParameter, __ΩVariadicNumberCommandParameter, __ΩVariadicStringCommandParameter, createShellShock };

package/dist/plugin-utils/compute-bin.cjs

@@ -0,0 +1,50 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_context_helpers = require('./context-helpers.cjs');
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _alloy_js_core = require("@alloy-js/core");
+
+//#region src/plugin-utils/compute-bin.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.
+*
+* @param context - The plugin context containing the necessary information to compute the command tree.
+* @returns The computed command tree for the CLI application, starting from the root bin command. This will include all commands discovered in the project and their respective details, organized in a hierarchical structure based on their segments and paths.
+*/
+function computeBin(context) {
+	return (0, _alloy_js_core.computed)(() => ({
+		id: "",
+		name: require_context_helpers.getAppName(context),
+		title: require_context_helpers.getAppTitle(context),
+		description: require_context_helpers.getAppDescription(context),
+		isVirtual: true,
+		path: null,
+		segments: [],
+		alias: [],
+		tags: [],
+		source: "file",
+		options: Object.fromEntries(context.options.map(__assignType((option) => [option.name, option], [
+			"option",
+			"",
+			"P\"2!\"/\""
+		]))),
+		args: [],
+		entry: { file: (0, _stryke_path_join_paths.joinPaths)(context.entryPath, "bin.ts") },
+		parent: null,
+		children: context.commands
+	})).value;
+}
+computeBin.__type = [
+	"Context",
+	"context",
+	"CommandTree",
+	"computeBin",
+	"Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.",
+	"P\"w!2\"\"w#/$?%"
+];
+
+//#endregion
+exports.computeBin = computeBin;

package/dist/plugin-utils/compute-bin.d.cts

@@ -0,0 +1,13 @@
+import { CommandTree } from "../types/command.cjs";
+import { Context } from "../types/context.cjs";
+//#region src/plugin-utils/compute-bin.d.ts
+/**
+ * Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.
+ *
+ * @param context - The plugin context containing the necessary information to compute the command tree.
+ * @returns The computed command tree for the CLI application, starting from the root bin command. This will include all commands discovered in the project and their respective details, organized in a hierarchical structure based on their segments and paths.
+ */
+declare function computeBin(context: Context): CommandTree;
+//#endregion
+export { computeBin };
+//# sourceMappingURL=compute-bin.d.cts.map

package/dist/plugin-utils/compute-bin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-bin.d.cts","names":[],"sources":["../../src/plugin-utils/compute-bin.ts"],"mappings":";;;;;;;AA6BA;;iBAAgB,UAAA,CAAW,OAAA,EAAS,OAAA,GAAU,WAAA"}

package/dist/plugin-utils/compute-bin.d.mts

@@ -0,0 +1,13 @@
+import { CommandTree } from "../types/command.mjs";
+import { Context } from "../types/context.mjs";
+//#region src/plugin-utils/compute-bin.d.ts
+/**
+ * Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.
+ *
+ * @param context - The plugin context containing the necessary information to compute the command tree.
+ * @returns The computed command tree for the CLI application, starting from the root bin command. This will include all commands discovered in the project and their respective details, organized in a hierarchical structure based on their segments and paths.
+ */
+declare function computeBin(context: Context): CommandTree;
+//#endregion
+export { computeBin };
+//# sourceMappingURL=compute-bin.d.mts.map

package/dist/plugin-utils/compute-bin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-bin.d.mts","names":[],"sources":["../../src/plugin-utils/compute-bin.ts"],"mappings":";;;;;;;AA6BA;;iBAAgB,UAAA,CAAW,OAAA,EAAS,OAAA,GAAU,WAAA"}

package/dist/plugin-utils/compute-bin.mjs

@@ -0,0 +1,50 @@
+import { getAppDescription, getAppName, getAppTitle } from "./context-helpers.mjs";
+import { joinPaths } from "@stryke/path/join-paths";
+import { computed } from "@alloy-js/core";
+
+//#region src/plugin-utils/compute-bin.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.
+*
+* @param context - The plugin context containing the necessary information to compute the command tree.
+* @returns The computed command tree for the CLI application, starting from the root bin command. This will include all commands discovered in the project and their respective details, organized in a hierarchical structure based on their segments and paths.
+*/
+function computeBin(context) {
+	return computed(() => ({
+		id: "",
+		name: getAppName(context),
+		title: getAppTitle(context),
+		description: getAppDescription(context),
+		isVirtual: true,
+		path: null,
+		segments: [],
+		alias: [],
+		tags: [],
+		source: "file",
+		options: Object.fromEntries(context.options.map(__assignType((option) => [option.name, option], [
+			"option",
+			"",
+			"P\"2!\"/\""
+		]))),
+		args: [],
+		entry: { file: joinPaths(context.entryPath, "bin.ts") },
+		parent: null,
+		children: context.commands
+	})).value;
+}
+computeBin.__type = [
+	"Context",
+	"context",
+	"CommandTree",
+	"computeBin",
+	"Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.",
+	"P\"w!2\"\"w#/$?%"
+];
+
+//#endregion
+export { computeBin };
+//# sourceMappingURL=compute-bin.mjs.map

package/dist/plugin-utils/compute-bin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-bin.mjs","names":[],"sources":["../../src/plugin-utils/compute-bin.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 { computed } from \"@alloy-js/core\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport type { CommandTree, Context } from \"../types\";\nimport { getAppDescription, getAppName, getAppTitle } from \"./context-helpers\";\n\n/**\n * Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.\n *\n * @param context - The plugin context containing the necessary information to compute the command tree.\n * @returns The computed command tree for the CLI application, starting from the root bin command. This will include all commands discovered in the project and their respective details, organized in a hierarchical structure based on their segments and paths.\n */\nexport function computeBin(context: Context): CommandTree {\n  const bin = computed(() => ({\n    id: \"\",\n    name: getAppName(context),\n    title: getAppTitle(context),\n    description: getAppDescription(context),\n    isVirtual: true,\n    path: null,\n    segments: [],\n    alias: [],\n    tags: [],\n    source: \"file\",\n    options: Object.fromEntries(\n      context.options.map(option => [option.name, option])\n    ),\n    args: [],\n    entry: {\n      file: joinPaths(context.entryPath, \"bin.ts\")\n    },\n    parent: null,\n    children: context.commands\n  }));\n\n  return bin.value;\n}\n"],"mappings":";;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA4BX,SAAc,WAAa,SAAG;AAoB1B,QAnBM,gBAAA;EACF,IAAE;EACN,MAAO,WAAY,QAAQ;EAC3B,OAAW,YAAE,QAAkB;EAC/B,aAAe,kBAAA,QAAA;EACX,WAAM;EACV,MAAU;EACV,UAAS,EAAA;EACL,OAAI,EAAA;EACR,MAAS,EAAA;EACT,QAAS;EACP,SAAQ,OAAQ,YAAc,QAAQ,QAAM,IAAM,cAAC,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,CAAA;EACpD,MAAA,EAAA;EACG,OAAI,EACD,MAAA,UAAA,QAAA,WAAA,SAAA,EACL;EACD,QAAA;EACD,UAAY,QAAA;EACZ,EAAA,CACC;;AAEL,WAAS,SAAS;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

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

@@ -61,7 +61,57 @@ getCommandList.__type = [
 	"Retrieves a list of all command trees defined in the context.",
 	"P\"w!2\"\"w#F`/$?%"
 ];
+/**
+* Retrieves a list of all command paths defined in the context.
+*
+* @param context - The build context containing the command definitions.
+* @returns A promise that resolves to an array of all command paths in the context.
+*/
+async function getCommandPaths(context) {
+	const commandPaths = [];
+	await require_traverse_command_tree.traverseCommands(context, __assignType((commandTree) => {
+		if (commandTree.path) commandPaths.push(commandTree.path);
+	}, [
+		"commandTree",
+		"",
+		"P\"2!\"/\""
+	]));
+	return commandPaths;
+}
+getCommandPaths.__type = [
+	"Context",
+	"context",
+	"getCommandPaths",
+	"Retrieves a list of all command paths defined in the context.",
+	"P\"w!2\"&F`/#?$"
+];
+/**
+* Retrieves a list of all command segments defined in the context.
+*
+* @param context - The build context containing the command definitions.
+* @returns A promise that resolves to an array of all command segments in the context.
+*/
+async function getCommandSegments(context) {
+	const commandSegments = [];
+	await require_traverse_command_tree.traverseCommands(context, __assignType((commandTree) => {
+		if (commandTree.path) commandSegments.push(commandTree.segments);
+	}, [
+		"commandTree",
+		"",
+		"P\"2!\"/\""
+	]));
+	return commandSegments;
+}
+getCommandSegments.__type = [
+	"Context",
+	"context",
+	"getCommandSegments",
+	"Retrieves a list of all command segments defined in the context.",
+	"P\"w!2\"&FF`/#?$"
+];
 
 //#endregion
 exports.getCommandList = getCommandList;
+exports.getCommandPaths = getCommandPaths;
+exports.getCommandSegments = getCommandSegments;
 exports.getCommandTree = getCommandTree;

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

@@ -17,6 +17,20 @@ declare function getCommandTree(context: Context, path?: string[]): CommandTree
  * @returns A promise that resolves to an array of all command trees in the context.
  */
 declare function getCommandList(context: Context): Promise<CommandTree[]>;
+/**
+ * Retrieves a list of all command paths defined in the context.
+ *
+ * @param context - The build context containing the command definitions.
+ * @returns A promise that resolves to an array of all command paths in the context.
+ */
+declare function getCommandPaths(context: Context): Promise<string[]>;
+/**
+ * Retrieves a list of all command segments defined in the context.
+ *
+ * @param context - The build context containing the command definitions.
+ * @returns A promise that resolves to an array of all command segments in the context.
+ */
+declare function getCommandSegments(context: Context): Promise<string[][]>;
 //#endregion
-export { getCommandList, getCommandTree };
+export { getCommandList, getCommandPaths, getCommandSegments, getCommandTree };
 //# sourceMappingURL=get-command-tree.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.d.cts","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"mappings":";;;;;;AA8BA;;;;;iBAAgB,cAAA,CACd,OAAA,EAAS,OAAA,EACT,IAAA,cACC,WAAA;;;;;AA+BH;;iBAAsB,cAAA,CAAe,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,WAAA"}
+{"version":3,"file":"get-command-tree.d.cts","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"mappings":";;;;;;AA8BA;;;;;iBAAgB,cAAA,CACd,OAAA,EAAS,OAAA,EACT,IAAA,cACC,WAAA;;;;;AA+BH;;iBAAsB,cAAA,CAAe,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,WAAA;;;;;;;iBAe1C,eAAA,CAAgB,OAAA,EAAS,OAAA,GAAU,OAAA;;;;;AAAzD;;iBAiBsB,kBAAA,CACpB,OAAA,EAAS,OAAA,GACR,OAAA"}

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

@@ -17,6 +17,20 @@ declare function getCommandTree(context: Context, path?: string[]): CommandTree
  * @returns A promise that resolves to an array of all command trees in the context.
  */
 declare function getCommandList(context: Context): Promise<CommandTree[]>;
+/**
+ * Retrieves a list of all command paths defined in the context.
+ *
+ * @param context - The build context containing the command definitions.
+ * @returns A promise that resolves to an array of all command paths in the context.
+ */
+declare function getCommandPaths(context: Context): Promise<string[]>;
+/**
+ * Retrieves a list of all command segments defined in the context.
+ *
+ * @param context - The build context containing the command definitions.
+ * @returns A promise that resolves to an array of all command segments in the context.
+ */
+declare function getCommandSegments(context: Context): Promise<string[][]>;
 //#endregion
-export { getCommandList, getCommandTree };
+export { getCommandList, getCommandPaths, getCommandSegments, getCommandTree };
 //# sourceMappingURL=get-command-tree.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.d.mts","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"mappings":";;;;;;AA8BA;;;;;iBAAgB,cAAA,CACd,OAAA,EAAS,OAAA,EACT,IAAA,cACC,WAAA;;;;;AA+BH;;iBAAsB,cAAA,CAAe,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,WAAA"}
+{"version":3,"file":"get-command-tree.d.mts","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"mappings":";;;;;;AA8BA;;;;;iBAAgB,cAAA,CACd,OAAA,EAAS,OAAA,EACT,IAAA,cACC,WAAA;;;;;AA+BH;;iBAAsB,cAAA,CAAe,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,WAAA;;;;;;;iBAe1C,eAAA,CAAgB,OAAA,EAAS,OAAA,GAAU,OAAA;;;;;AAAzD;;iBAiBsB,kBAAA,CACpB,OAAA,EAAS,OAAA,GACR,OAAA"}

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

@@ -61,7 +61,55 @@ getCommandList.__type = [
 	"Retrieves a list of all command trees defined in the context.",
 	"P\"w!2\"\"w#F`/$?%"
 ];
+/**
+* Retrieves a list of all command paths defined in the context.
+*
+* @param context - The build context containing the command definitions.
+* @returns A promise that resolves to an array of all command paths in the context.
+*/
+async function getCommandPaths(context) {
+	const commandPaths = [];
+	await traverseCommands(context, __assignType((commandTree) => {
+		if (commandTree.path) commandPaths.push(commandTree.path);
+	}, [
+		"commandTree",
+		"",
+		"P\"2!\"/\""
+	]));
+	return commandPaths;
+}
+getCommandPaths.__type = [
+	"Context",
+	"context",
+	"getCommandPaths",
+	"Retrieves a list of all command paths defined in the context.",
+	"P\"w!2\"&F`/#?$"
+];
+/**
+* Retrieves a list of all command segments defined in the context.
+*
+* @param context - The build context containing the command definitions.
+* @returns A promise that resolves to an array of all command segments in the context.
+*/
+async function getCommandSegments(context) {
+	const commandSegments = [];
+	await traverseCommands(context, __assignType((commandTree) => {
+		if (commandTree.path) commandSegments.push(commandTree.segments);
+	}, [
+		"commandTree",
+		"",
+		"P\"2!\"/\""
+	]));
+	return commandSegments;
+}
+getCommandSegments.__type = [
+	"Context",
+	"context",
+	"getCommandSegments",
+	"Retrieves a list of all command segments defined in the context.",
+	"P\"w!2\"&FF`/#?$"
+];
 
 //#endregion
-export { getCommandList, getCommandTree };
+export { getCommandList, getCommandPaths, getCommandSegments, getCommandTree };
 //# sourceMappingURL=get-command-tree.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.mjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.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 { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\nimport { traverseCommands } from \"./traverse-command-tree\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n\n/**\n * Retrieves a list of all command trees defined in the context.\n *\n * @param context - The build context containing the command definitions.\n * @returns A promise that resolves to an array of all command trees in the context.\n */\nexport async function getCommandList(context: Context): Promise<CommandTree[]> {\n  const commandList: CommandTree[] = [];\n  await traverseCommands(context, commandTree => {\n    commandList.push(commandTree);\n  });\n\n  return commandList;\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;;AAYV,KAAK,KAAO,WAAW;;AAIxB,KAAO,KAAM,SAAC,GAAW;EAClB,MAAO,WAAU,KACf,MAAA,EAAA,CACA,OAAA,cAAwB,YAAW,CAAC,qBAAa,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAExD,KAAA,aAAA,YACa,OAAQ,UAAS,eAAc,KAAI,YAAa,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAIrB,QAAS;;AAEX,eAAW,SAAa;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOzB,eAAc,eAAA,SAAA;CACV,MAAG,cAAiB,EAAE;AACtB,OAAK,iBAAiB,SAAU,cAAA,gBAAA;AAC5B,cAAC,KAAA,YAAA;IACF;EAAC;EAAa;EAAA;EAAU,CAAA,CAAA;AAC3B,QAAI;;AAER,eAAQ,SAAc;CAAA;CAAY;CAAS;CAAgB;CAAA;CAAA;CAAA"}
+{"version":3,"file":"get-command-tree.mjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.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 { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\nimport { traverseCommands } from \"./traverse-command-tree\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n\n/**\n * Retrieves a list of all command trees defined in the context.\n *\n * @param context - The build context containing the command definitions.\n * @returns A promise that resolves to an array of all command trees in the context.\n */\nexport async function getCommandList(context: Context): Promise<CommandTree[]> {\n  const commandList: CommandTree[] = [];\n  await traverseCommands(context, commandTree => {\n    commandList.push(commandTree);\n  });\n\n  return commandList;\n}\n\n/**\n * Retrieves a list of all command paths defined in the context.\n *\n * @param context - The build context containing the command definitions.\n * @returns A promise that resolves to an array of all command paths in the context.\n */\nexport async function getCommandPaths(context: Context): Promise<string[]> {\n  const commandPaths: string[] = [];\n  await traverseCommands(context, commandTree => {\n    if (commandTree.path) {\n      commandPaths.push(commandTree.path);\n    }\n  });\n\n  return commandPaths;\n}\n\n/**\n * Retrieves a list of all command segments defined in the context.\n *\n * @param context - The build context containing the command definitions.\n * @returns A promise that resolves to an array of all command segments in the context.\n */\nexport async function getCommandSegments(\n  context: Context\n): Promise<string[][]> {\n  const commandSegments: string[][] = [];\n  await traverseCommands(context, commandTree => {\n    if (commandTree.path) {\n      commandSegments.push(commandTree.segments);\n    }\n  });\n\n  return commandSegments;\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;;AAYV,KAAK,KAAO,WAAW;;AAIxB,KAAO,KAAM,SAAC,GAAW;EAClB,MAAO,WAAU,KACf,MAAA,EAAA,CACA,OAAA,cAAwB,YAAW,CAAC,qBAAa,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAExD,KAAA,aAAA,YACa,OAAQ,UAAS,eAAc,KAAI,YAAa,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAIrB,QAAS;;AAEX,eAAW,SAAa;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOzB,eAAc,eAAA,SAAA;CACV,MAAG,cAAiB,EAAE;AACtB,OAAK,iBAAiB,SAAU,cAAA,gBAAA;AAC5B,cAAC,KAAA,YAAA;IACF;EAAC;EAAa;EAAA;EAAU,CAAA,CAAA;AAC3B,QAAI;;AAER,eAAQ,SAAc;CAAA;CAAY;CAAS;CAAgB;CAAA;CAAA;CAAA;;;;;;;AAO3D,eAAoB,gBAAA,SAAA;CACpB,MAAA,eAAA,EAAA;;AAEE,MAAA,YAAA,KACU,cAAW,KAAI,YAAc,KAAA;IAErC;EAAA;EAAmB;EAAC;EAAa,CAAC,CAAA;AAClC,QAAO;;AAEX,gBAAa,SAAS;CAAA;CAAe;CAAS;CAAkB;CAAe;CAAA;;;;;;;AAO/E,eAAA,mBAAA,SAAA;;AAEE,OAAA,iBAAA,SAAA,cAAA,gBAAA;AACC,MAAS,YAAW,KACtB,iBAAA,KAAA,YAAA,SAAA;IAEG;EAAA;EAAkB;EAAK;EAAS,CAAE,CAAC;AACrC,QAAA;;AAEF,mBAAQ,SAAoB;CAAC;CAAM;CAAA;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_context_helpers = require('./context-helpers.cjs');
 const require_reflect = require('./reflect.cjs');
+const require_compute_bin = require('./compute-bin.cjs');
 const require_type_checks = require('./type-checks.cjs');
 const require_deepkit = require('./deepkit.cjs');
 const require_description_helpers = require('./description-helpers.cjs');
@@ -9,6 +10,7 @@ const require_get_command_tree = require('./get-command-tree.cjs');
 
 exports.__ΩFormatDescriptionOptions = require_description_helpers.__ΩFormatDescriptionOptions;
 exports.__ΩFormatShortDescriptionOptions = require_description_helpers.__ΩFormatShortDescriptionOptions;
+exports.computeBin = require_compute_bin.computeBin;
 exports.extractReflectionKind = require_deepkit.extractReflectionKind;
 exports.extractType = require_deepkit.extractType;
 exports.formatDescription = require_description_helpers.formatDescription;
@@ -18,6 +20,8 @@ exports.getAppDescription = require_context_helpers.getAppDescription;
 exports.getAppName = require_context_helpers.getAppName;
 exports.getAppTitle = require_context_helpers.getAppTitle;
 exports.getCommandList = require_get_command_tree.getCommandList;
+exports.getCommandPaths = require_get_command_tree.getCommandPaths;
+exports.getCommandSegments = require_get_command_tree.getCommandSegments;
 exports.getCommandTree = require_get_command_tree.getCommandTree;
 exports.getDynamicPathSegmentName = require_context_helpers.getDynamicPathSegmentName;
 exports.getPathSegmentGroupName = require_context_helpers.getPathSegmentGroupName;

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

@@ -1,8 +1,9 @@
+import { computeBin } from "./compute-bin.cjs";
 import { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases } from "./context-helpers.cjs";
 import { extractReflectionKind, extractType } from "./deepkit.cjs";
 import { FormatDescriptionOptions, FormatShortDescriptionOptions, formatDescription, formatShortDescription } from "./description-helpers.cjs";
-import { getCommandList, getCommandTree } from "./get-command-tree.cjs";
+import { getCommandList, getCommandPaths, getCommandSegments, getCommandTree } from "./get-command-tree.cjs";
 import { sortOptions } from "./reflect.cjs";
 import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.cjs";
 import { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind } from "./type-checks.cjs";
-export { FormatDescriptionOptions, FormatShortDescriptionOptions, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandList, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };
+export { FormatDescriptionOptions, FormatShortDescriptionOptions, computeBin, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandList, getCommandPaths, getCommandSegments, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };

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

@@ -1,8 +1,9 @@
+import { computeBin } from "./compute-bin.mjs";
 import { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases } from "./context-helpers.mjs";
 import { extractReflectionKind, extractType } from "./deepkit.mjs";
 import { FormatDescriptionOptions, FormatShortDescriptionOptions, formatDescription, formatShortDescription } from "./description-helpers.mjs";
-import { getCommandList, getCommandTree } from "./get-command-tree.mjs";
+import { getCommandList, getCommandPaths, getCommandSegments, getCommandTree } from "./get-command-tree.mjs";
 import { sortOptions } from "./reflect.mjs";
 import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.mjs";
 import { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind } from "./type-checks.mjs";
-export { FormatDescriptionOptions, FormatShortDescriptionOptions, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandList, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };
+export { FormatDescriptionOptions, FormatShortDescriptionOptions, computeBin, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandList, getCommandPaths, getCommandSegments, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };

package/dist/plugin-utils/index.mjs

@@ -1,9 +1,10 @@
 import { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases } from "./context-helpers.mjs";
 import { sortOptions } from "./reflect.mjs";
+import { computeBin } from "./compute-bin.mjs";
 import { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind } from "./type-checks.mjs";
 import { extractReflectionKind, extractType } from "./deepkit.mjs";
 import { __ΩFormatDescriptionOptions, __ΩFormatShortDescriptionOptions, formatDescription, formatShortDescription } from "./description-helpers.mjs";
 import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.mjs";
-import { getCommandList, getCommandTree } from "./get-command-tree.mjs";
+import { getCommandList, getCommandPaths, getCommandSegments, getCommandTree } from "./get-command-tree.mjs";
 
-export { __ΩFormatDescriptionOptions, __ΩFormatShortDescriptionOptions, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandList, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };
+export { __ΩFormatDescriptionOptions, __ΩFormatShortDescriptionOptions, computeBin, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandList, getCommandPaths, getCommandSegments, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };