@shell-shock/core 0.2.1 → 0.4.0

package/dist/plugin-utils/context-helpers.cjs

@@ -0,0 +1,86 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+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_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+
+//#region src/plugin-utils/context-helpers.ts
+/**
+* Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
+*
+* @param aliases - An array of argument aliases to sort.
+* @returns A new array of sorted aliases.
+*/
+function sortArgAliases(aliases) {
+	if (aliases.length === 0) return [];
+	const result = aliases.filter((alias) => alias.length === 1);
+	result.push(...aliases.filter((alias) => alias.length > 1));
+	return result.sort((a, b) => a.localeCompare(b));
+}
+/**
+* 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.name || ((0, __stryke_type_checks_is_set_string.isSetString)(context.config.bin) || Array.isArray(context.config.bin) && context.config.bin.length > 0 && (0, __stryke_type_checks_is_set_string.isSetString)(context.config.bin[0]) ? (0, __stryke_type_checks_is_set_string.isSetString)(context.config.bin) ? context.config.bin : context.config.bin[0] : context.packageJson?.name);
+	if (!(0, __stryke_type_checks_is_set_string.isSetString)(result)) throw new Error("No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.");
+	return (0, __stryke_string_format_kebab_case.kebabCase)(result);
+}
+/**
+* Retrieves the application title from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application title in title-case format.
+*/
+function getAppTitle(context) {
+	return (0, __stryke_string_format_title_case.titleCase)(context.config.name || getAppName(context));
+}
+/**
+* Retrieves the application description from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application description.
+*/
+function getAppDescription(context) {
+	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context)} command-line interface application.`;
+}
+/**
+* Retrieves the primary binary name for the application.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The primary binary name as a string.
+*/
+function getAppBin(context) {
+	return (0, __stryke_type_checks_is_set_object.isSetObject)(context.config.bin) ? Object.keys(context.config.bin)[0] : (0, __stryke_string_format_kebab_case.kebabCase)(getAppName(context));
+}
+/**
+* Determines if a given command path segment is variable (enclosed in square brackets).
+*
+* @param path - The command path segment to check.
+* @returns True if the path is variable, false otherwise.
+*/
+function isVariableCommandPath(path) {
+	return path.startsWith("[") && path.endsWith("]");
+}
+/**
+* Extracts the variable name from a command path segment by removing enclosing square brackets.
+*
+* @param path - The command path segment.
+* @returns The variable name without square brackets.
+*/
+function getVariableCommandPathName(path) {
+	return path.replaceAll(/^\[+/g, "").replaceAll(/\]+$/g, "");
+}
+
+//#endregion
+exports.getAppBin = getAppBin;
+exports.getAppDescription = getAppDescription;
+exports.getAppName = getAppName;
+exports.getAppTitle = getAppTitle;
+exports.getVariableCommandPathName = getVariableCommandPathName;
+exports.isVariableCommandPath = isVariableCommandPath;
+exports.sortArgAliases = sortArgAliases;
+//# sourceMappingURL=context-helpers.cjs.map

package/dist/plugin-utils/context-helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.cjs","names":["kebabCase","titleCase","isSetObject","isSetString","sortArgAliases","aliases","length","result","filter","alias","push","sort","a","b","localeCompare","getAppName","context","config","name","bin","Array","isArray","packageJson","Error","getAppTitle","getAppDescription","description","getAppBin","Object","keys","isVariableCommandPath","path","startsWith","endsWith","getVariableCommandPathName","replaceAll"],"sources":["../../src/plugin-utils/context-helpers.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 { kebabCase } from \"@stryke/string-format/kebab-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 type { Context, UnresolvedContext } from \"../types\";\n\n/**\n * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.\n *\n * @param aliases - An array of argument aliases to sort.\n * @returns A new array of sorted aliases.\n */\nexport function sortArgAliases(aliases: string[]): string[] {\n  if (aliases.length === 0) {\n    return [];\n  }\n\n  const result = aliases.filter(alias => alias.length === 1);\n  result.push(...aliases.filter(alias => alias.length > 1));\n\n  return result.sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Retrieves the application name from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application name in kebab-case format.\n * @throws An error if no valid application name is found.\n */\nexport function getAppName(context: UnresolvedContext | Context): string {\n  const result =\n    context.config.name ||\n    (isSetString(context.config.bin) ||\n    (Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0 &&\n      isSetString(context.config.bin[0]))\n      ? isSetString(context.config.bin)\n        ? context.config.bin\n        : context.config.bin[0]\n      : context.packageJson?.name);\n  if (!isSetString(result)) {\n    throw new Error(\n      \"No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.\"\n    );\n  }\n\n  return kebabCase(result);\n}\n\n/**\n * Retrieves the application title from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(context: UnresolvedContext | Context): string {\n  return titleCase(context.config.name || getAppName(context));\n}\n\n/**\n * Retrieves the application description from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application description.\n */\nexport function getAppDescription(\n  context: UnresolvedContext | Context\n): string {\n  return (\n    context.config.description ||\n    context.packageJson?.description ||\n    `The ${getAppTitle(context)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isVariableCommandPath(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getVariableCommandPathName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgBI,eAAeC,SAA6B;AAC1D,KAAIA,QAAQC,WAAW,EACrB,QAAO,EAAE;CAGX,MAAMC,SAASF,QAAQG,QAAOC,UAASA,MAAMH,WAAW,EAAE;AAC1DC,QAAOG,KAAK,GAAGL,QAAQG,QAAOC,UAASA,MAAMH,SAAS,EAAE,CAAC;AAEzD,QAAOC,OAAOI,MAAMC,GAAGC,MAAMD,EAAEE,cAAcD,EAAE,CAAC;;;;;;;;;AAUlD,SAAgBE,WAAWC,SAA8C;CACvE,MAAMT,SACJS,QAAQC,OAAOC,6DACFF,QAAQC,OAAOE,IAAI,IAC/BC,MAAMC,QAAQL,QAAQC,OAAOE,IAAI,IAChCH,QAAQC,OAAOE,IAAIb,SAAS,yDAChBU,QAAQC,OAAOE,IAAI,GAAI,uDACrBH,QAAQC,OAAOE,IAAI,GAC7BH,QAAQC,OAAOE,MACfH,QAAQC,OAAOE,IAAI,KACrBH,QAAQM,aAAaJ;AAC3B,KAAI,qDAAaX,OAAO,CACtB,OAAM,IAAIgB,MACR,qIACD;AAGH,yDAAiBhB,OAAO;;;;;;;;AAS1B,SAAgBiB,YAAYR,SAA8C;AACxE,yDAAiBA,QAAQC,OAAOC,QAAQH,WAAWC,QAAQ,CAAC;;;;;;;;AAS9D,SAAgBS,kBACdT,SACQ;AACR,QACEA,QAAQC,OAAOS,eACfV,QAAQM,aAAaI,eACrB,OAAOF,YAAYR,QAAQ,CAAA;;;;;;;;AAU/B,SAAgBW,UAAUX,SAA0B;AAClD,4DAAmBA,QAAQC,OAAOE,IAAI,GAClCS,OAAOC,KAAKb,QAAQC,OAAOE,IAAI,CAAC,sDACtBJ,WAAWC,QAAQ,CAAC;;;;;;;;AASpC,SAAgBc,sBAAsBC,MAAuB;AAC3D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;AASnD,SAAgBC,2BAA2BH,MAAsB;AAC/D,QAAOA,KAAKI,WAAW,SAAS,GAAG,CAACA,WAAW,SAAS,GAAG"}

package/dist/plugin-utils/context-helpers.d.cts

@@ -0,0 +1,58 @@
+import { Context, UnresolvedContext } from "../types/context.cjs";
+import "../types/index.cjs";
+
+//#region src/plugin-utils/context-helpers.d.ts
+
+/**
+ * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
+ *
+ * @param aliases - An array of argument aliases to sort.
+ * @returns A new array of sorted aliases.
+ */
+declare function sortArgAliases(aliases: string[]): string[];
+/**
+ * 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.
+ */
+declare function getAppName(context: UnresolvedContext | Context): string;
+/**
+ * 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.
+ */
+declare function getAppTitle(context: UnresolvedContext | Context): string;
+/**
+ * Retrieves the application description from the context and configuration.
+ *
+ * @param context - The build context containing workspace and package information.
+ * @returns The application description.
+ */
+declare function getAppDescription(context: UnresolvedContext | Context): string;
+/**
+ * Retrieves the primary binary name for the application.
+ *
+ * @param context - The build context containing workspace and package information.
+ * @returns The primary binary name as a string.
+ */
+declare function getAppBin(context: Context): string;
+/**
+ * Determines if a given command path segment is variable (enclosed in square brackets).
+ *
+ * @param path - The command path segment to check.
+ * @returns True if the path is variable, false otherwise.
+ */
+declare function isVariableCommandPath(path: string): boolean;
+/**
+ * Extracts the variable name from a command path segment by removing enclosing square brackets.
+ *
+ * @param path - The command path segment.
+ * @returns The variable name without square brackets.
+ */
+declare function getVariableCommandPathName(path: string): string;
+//#endregion
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getVariableCommandPathName, isVariableCommandPath, sortArgAliases };
+//# sourceMappingURL=context-helpers.d.cts.map

package/dist/plugin-utils/context-helpers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.d.cts","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8BA;AAkBA;AA0BA;AAUgB,iBAtDA,cAAA,CAuDL,OAAA,EAAA,MAAA,EAAoB,CAAA,EAAA,MAAO,EAAA;AAetC;AAYA;AAUA;;;;;iBA1EgB,UAAA,UAAoB,oBAAoB;;;;;;;iBA0BxC,WAAA,UAAqB,oBAAoB;;;;;;;iBAUzC,iBAAA,UACL,oBAAoB;;;;;;;iBAef,SAAA,UAAmB;;;;;;;iBAYnB,qBAAA;;;;;;;iBAUA,0BAAA"}

package/dist/plugin-utils/context-helpers.d.mts

@@ -0,0 +1,58 @@
+import { Context, UnresolvedContext } from "../types/context.mjs";
+import "../types/index.mjs";
+
+//#region src/plugin-utils/context-helpers.d.ts
+
+/**
+ * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
+ *
+ * @param aliases - An array of argument aliases to sort.
+ * @returns A new array of sorted aliases.
+ */
+declare function sortArgAliases(aliases: string[]): string[];
+/**
+ * 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.
+ */
+declare function getAppName(context: UnresolvedContext | Context): string;
+/**
+ * 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.
+ */
+declare function getAppTitle(context: UnresolvedContext | Context): string;
+/**
+ * Retrieves the application description from the context and configuration.
+ *
+ * @param context - The build context containing workspace and package information.
+ * @returns The application description.
+ */
+declare function getAppDescription(context: UnresolvedContext | Context): string;
+/**
+ * Retrieves the primary binary name for the application.
+ *
+ * @param context - The build context containing workspace and package information.
+ * @returns The primary binary name as a string.
+ */
+declare function getAppBin(context: Context): string;
+/**
+ * Determines if a given command path segment is variable (enclosed in square brackets).
+ *
+ * @param path - The command path segment to check.
+ * @returns True if the path is variable, false otherwise.
+ */
+declare function isVariableCommandPath(path: string): boolean;
+/**
+ * Extracts the variable name from a command path segment by removing enclosing square brackets.
+ *
+ * @param path - The command path segment.
+ * @returns The variable name without square brackets.
+ */
+declare function getVariableCommandPathName(path: string): string;
+//#endregion
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getVariableCommandPathName, isVariableCommandPath, sortArgAliases };
+//# sourceMappingURL=context-helpers.d.mts.map

package/dist/plugin-utils/context-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.d.mts","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8BA;AAkBA;AA0BA;AAUgB,iBAtDA,cAAA,CAuDL,OAAA,EAAA,MAAA,EAAoB,CAAA,EAAA,MAAO,EAAA;AAetC;AAYA;AAUA;;;;;iBA1EgB,UAAA,UAAoB,oBAAoB;;;;;;;iBA0BxC,WAAA,UAAqB,oBAAoB;;;;;;;iBAUzC,iBAAA,UACL,oBAAoB;;;;;;;iBAef,SAAA,UAAmB;;;;;;;iBAYnB,qBAAA;;;;;;;iBAUA,0BAAA"}

package/dist/plugin-utils/context-helpers.mjs

@@ -0,0 +1,79 @@
+import { kebabCase } from "@stryke/string-format/kebab-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";
+
+//#region src/plugin-utils/context-helpers.ts
+/**
+* Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
+*
+* @param aliases - An array of argument aliases to sort.
+* @returns A new array of sorted aliases.
+*/
+function sortArgAliases(aliases) {
+	if (aliases.length === 0) return [];
+	const result = aliases.filter((alias) => alias.length === 1);
+	result.push(...aliases.filter((alias) => alias.length > 1));
+	return result.sort((a, b) => a.localeCompare(b));
+}
+/**
+* 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.name || (isSetString(context.config.bin) || Array.isArray(context.config.bin) && context.config.bin.length > 0 && isSetString(context.config.bin[0]) ? isSetString(context.config.bin) ? context.config.bin : context.config.bin[0] : context.packageJson?.name);
+	if (!isSetString(result)) throw new Error("No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.");
+	return kebabCase(result);
+}
+/**
+* Retrieves the application title from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application title in title-case format.
+*/
+function getAppTitle(context) {
+	return titleCase(context.config.name || getAppName(context));
+}
+/**
+* Retrieves the application description from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application description.
+*/
+function getAppDescription(context) {
+	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context)} command-line interface application.`;
+}
+/**
+* Retrieves the primary binary name for the application.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The primary binary name as a string.
+*/
+function getAppBin(context) {
+	return isSetObject(context.config.bin) ? Object.keys(context.config.bin)[0] : kebabCase(getAppName(context));
+}
+/**
+* Determines if a given command path segment is variable (enclosed in square brackets).
+*
+* @param path - The command path segment to check.
+* @returns True if the path is variable, false otherwise.
+*/
+function isVariableCommandPath(path) {
+	return path.startsWith("[") && path.endsWith("]");
+}
+/**
+* Extracts the variable name from a command path segment by removing enclosing square brackets.
+*
+* @param path - The command path segment.
+* @returns The variable name without square brackets.
+*/
+function getVariableCommandPathName(path) {
+	return path.replaceAll(/^\[+/g, "").replaceAll(/\]+$/g, "");
+}
+
+//#endregion
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getVariableCommandPathName, isVariableCommandPath, sortArgAliases };
+//# sourceMappingURL=context-helpers.mjs.map

package/dist/plugin-utils/context-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.mjs","names":["kebabCase","titleCase","isSetObject","isSetString","sortArgAliases","aliases","length","result","filter","alias","push","sort","a","b","localeCompare","getAppName","context","config","name","bin","Array","isArray","packageJson","Error","getAppTitle","getAppDescription","description","getAppBin","Object","keys","isVariableCommandPath","path","startsWith","endsWith","getVariableCommandPathName","replaceAll"],"sources":["../../src/plugin-utils/context-helpers.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 { kebabCase } from \"@stryke/string-format/kebab-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 type { Context, UnresolvedContext } from \"../types\";\n\n/**\n * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.\n *\n * @param aliases - An array of argument aliases to sort.\n * @returns A new array of sorted aliases.\n */\nexport function sortArgAliases(aliases: string[]): string[] {\n  if (aliases.length === 0) {\n    return [];\n  }\n\n  const result = aliases.filter(alias => alias.length === 1);\n  result.push(...aliases.filter(alias => alias.length > 1));\n\n  return result.sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Retrieves the application name from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application name in kebab-case format.\n * @throws An error if no valid application name is found.\n */\nexport function getAppName(context: UnresolvedContext | Context): string {\n  const result =\n    context.config.name ||\n    (isSetString(context.config.bin) ||\n    (Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0 &&\n      isSetString(context.config.bin[0]))\n      ? isSetString(context.config.bin)\n        ? context.config.bin\n        : context.config.bin[0]\n      : context.packageJson?.name);\n  if (!isSetString(result)) {\n    throw new Error(\n      \"No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.\"\n    );\n  }\n\n  return kebabCase(result);\n}\n\n/**\n * Retrieves the application title from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(context: UnresolvedContext | Context): string {\n  return titleCase(context.config.name || getAppName(context));\n}\n\n/**\n * Retrieves the application description from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application description.\n */\nexport function getAppDescription(\n  context: UnresolvedContext | Context\n): string {\n  return (\n    context.config.description ||\n    context.packageJson?.description ||\n    `The ${getAppTitle(context)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isVariableCommandPath(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getVariableCommandPathName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,SAAgBI,eAAeC,SAA6B;AAC1D,KAAIA,QAAQC,WAAW,EACrB,QAAO,EAAE;CAGX,MAAMC,SAASF,QAAQG,QAAOC,UAASA,MAAMH,WAAW,EAAE;AAC1DC,QAAOG,KAAK,GAAGL,QAAQG,QAAOC,UAASA,MAAMH,SAAS,EAAE,CAAC;AAEzD,QAAOC,OAAOI,MAAMC,GAAGC,MAAMD,EAAEE,cAAcD,EAAE,CAAC;;;;;;;;;AAUlD,SAAgBE,WAAWC,SAA8C;CACvE,MAAMT,SACJS,QAAQC,OAAOC,SACdf,YAAYa,QAAQC,OAAOE,IAAI,IAC/BC,MAAMC,QAAQL,QAAQC,OAAOE,IAAI,IAChCH,QAAQC,OAAOE,IAAIb,SAAS,KAC5BH,YAAYa,QAAQC,OAAOE,IAAI,GAAI,GACjChB,YAAYa,QAAQC,OAAOE,IAAI,GAC7BH,QAAQC,OAAOE,MACfH,QAAQC,OAAOE,IAAI,KACrBH,QAAQM,aAAaJ;AAC3B,KAAI,CAACf,YAAYI,OAAO,CACtB,OAAM,IAAIgB,MACR,qIACD;AAGH,QAAOvB,UAAUO,OAAO;;;;;;;;AAS1B,SAAgBiB,YAAYR,SAA8C;AACxE,QAAOf,UAAUe,QAAQC,OAAOC,QAAQH,WAAWC,QAAQ,CAAC;;;;;;;;AAS9D,SAAgBS,kBACdT,SACQ;AACR,QACEA,QAAQC,OAAOS,eACfV,QAAQM,aAAaI,eACrB,OAAOF,YAAYR,QAAQ,CAAA;;;;;;;;AAU/B,SAAgBW,UAAUX,SAA0B;AAClD,QAAOd,YAAYc,QAAQC,OAAOE,IAAI,GAClCS,OAAOC,KAAKb,QAAQC,OAAOE,IAAI,CAAC,KAChCnB,UAAUe,WAAWC,QAAQ,CAAC;;;;;;;;AASpC,SAAgBc,sBAAsBC,MAAuB;AAC3D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;AASnD,SAAgBC,2BAA2BH,MAAsB;AAC/D,QAAOA,KAAKI,WAAW,SAAS,GAAG,CAACA,WAAW,SAAS,GAAG"}

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

@@ -1,3 +1,4 @@
+const require_plugin_utils_context_helpers = require('./context-helpers.cjs');
 
 //#region src/plugin-utils/get-command-tree.ts
 /**
@@ -11,7 +12,7 @@ function getCommandTree(context, path = []) {
 	if (path.length === 0) return null;
 	let currentTree = context.commands[path[0]] ?? null;
 	if (path.length > 1) {
-		const segments = path.slice(1);
+		const segments = path.slice(1).filter((segment) => !require_plugin_utils_context_helpers.isVariableCommandPath(segment));
 		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
 		else return null;
 	}
@@ -19,4 +20,5 @@ function getCommandTree(context, path = []) {
 }
 
 //#endregion
-exports.getCommandTree = getCommandTree;
+exports.getCommandTree = getCommandTree;
+//# sourceMappingURL=get-command-tree.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-command-tree.cjs","names":["isVariableCommandPath","getCommandTree","context","path","length","currentTree","commands","segments","slice","filter","segment","children","Object","prototype","hasOwnProperty","call"],"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 { isVariableCommandPath } from \"./context-helpers\";\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 => !isVariableCommandPath(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"],"mappings":";;;;;;;;;;AA6BA,SAAgBC,eACdC,SACAC,OAAO,EAAc,EACD;AACpB,KAAIA,KAAKC,WAAW,EAClB,QAAO;CAGT,IAAIC,cAAkCH,QAAQI,SAASH,KAAK,OAAQ;AACpE,KAAIA,KAAKC,SAAS,GAAG;EACnB,MAAMG,WAAWJ,KACdK,MAAM,EAAE,CACRC,QAAOC,YAAW,CAACV,2DAAsBU,QAAQ,CAAC;AACrD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}

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

@@ -12,4 +12,5 @@ import { Context } from "../types/context.cjs";
  */
 declare function getCommandTree(context: Context, path?: string[]): CommandTree | null;
 //#endregion
-export { getCommandTree };
+export { getCommandTree };
+//# sourceMappingURL=get-command-tree.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-command-tree.d.cts","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6BA;;;;;iBAAgB,cAAA,UACL,2BAER"}

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

@@ -12,4 +12,5 @@ import { Context } from "../types/context.mjs";
  */
 declare function getCommandTree(context: Context, path?: string[]): CommandTree | null;
 //#endregion
-export { getCommandTree };
+export { getCommandTree };
+//# sourceMappingURL=get-command-tree.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-command-tree.d.mts","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6BA;;;;;iBAAgB,cAAA,UACL,2BAER"}

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

@@ -1,3 +1,5 @@
+import { isVariableCommandPath } from "./context-helpers.mjs";
+
 //#region src/plugin-utils/get-command-tree.ts
 /**
 * Retrieves a specific command tree based on the provided path.
@@ -10,7 +12,7 @@ function getCommandTree(context, path = []) {
 	if (path.length === 0) return null;
 	let currentTree = context.commands[path[0]] ?? null;
 	if (path.length > 1) {
-		const segments = path.slice(1);
+		const segments = path.slice(1).filter((segment) => !isVariableCommandPath(segment));
 		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
 		else return null;
 	}
@@ -18,4 +20,5 @@ function getCommandTree(context, path = []) {
 }
 
 //#endregion
-export { getCommandTree };
+export { getCommandTree };
+//# sourceMappingURL=get-command-tree.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-command-tree.mjs","names":["isVariableCommandPath","getCommandTree","context","path","length","currentTree","commands","segments","slice","filter","segment","children","Object","prototype","hasOwnProperty","call"],"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 { isVariableCommandPath } from \"./context-helpers\";\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 => !isVariableCommandPath(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"],"mappings":";;;;;;;;;;AA6BA,SAAgBC,eACdC,SACAC,OAAO,EAAc,EACD;AACpB,KAAIA,KAAKC,WAAW,EAClB,QAAO;CAGT,IAAIC,cAAkCH,QAAQI,SAASH,KAAK,OAAQ;AACpE,KAAIA,KAAKC,SAAS,GAAG;EACnB,MAAMG,WAAWJ,KACdK,MAAM,EAAE,CACRC,QAAOC,YAAW,CAACV,sBAAsBU,QAAQ,CAAC;AACrD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}

package/dist/plugin-utils/index.cjs

@@ -1,3 +1,16 @@
+const require_plugin_utils_context_helpers = require('./context-helpers.cjs');
+const require_plugin_utils_reflect = require('./reflect.cjs');
 const require_plugin_utils_get_command_tree = require('./get-command-tree.cjs');
+const require_plugin_utils_traverse_command_tree = require('./traverse-command-tree.cjs');
 
-exports.getCommandTree = require_plugin_utils_get_command_tree.getCommandTree;
+exports.getAppBin = require_plugin_utils_context_helpers.getAppBin;
+exports.getAppDescription = require_plugin_utils_context_helpers.getAppDescription;
+exports.getAppName = require_plugin_utils_context_helpers.getAppName;
+exports.getAppTitle = require_plugin_utils_context_helpers.getAppTitle;
+exports.getCommandTree = require_plugin_utils_get_command_tree.getCommandTree;
+exports.getVariableCommandPathName = require_plugin_utils_context_helpers.getVariableCommandPathName;
+exports.isVariableCommandPath = require_plugin_utils_context_helpers.isVariableCommandPath;
+exports.sortArgAliases = require_plugin_utils_context_helpers.sortArgAliases;
+exports.sortOptions = require_plugin_utils_reflect.sortOptions;
+exports.traverseCommandTree = require_plugin_utils_traverse_command_tree.traverseCommandTree;
+exports.traverseCommands = require_plugin_utils_traverse_command_tree.traverseCommands;

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

@@ -1,2 +1,5 @@
+import { getAppBin, getAppDescription, getAppName, getAppTitle, getVariableCommandPathName, isVariableCommandPath, sortArgAliases } from "./context-helpers.cjs";
 import { getCommandTree } from "./get-command-tree.cjs";
-export { getCommandTree };
+import { sortOptions } from "./reflect.cjs";
+import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.cjs";
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getVariableCommandPathName, isVariableCommandPath, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };

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

@@ -1,2 +1,5 @@
+import { getAppBin, getAppDescription, getAppName, getAppTitle, getVariableCommandPathName, isVariableCommandPath, sortArgAliases } from "./context-helpers.mjs";
 import { getCommandTree } from "./get-command-tree.mjs";
-export { getCommandTree };
+import { sortOptions } from "./reflect.mjs";
+import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.mjs";
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getVariableCommandPathName, isVariableCommandPath, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };

package/dist/plugin-utils/index.mjs

@@ -1,3 +1,6 @@
+import { getAppBin, getAppDescription, getAppName, getAppTitle, getVariableCommandPathName, isVariableCommandPath, sortArgAliases } from "./context-helpers.mjs";
+import { sortOptions } from "./reflect.mjs";
 import { getCommandTree } from "./get-command-tree.mjs";
+import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.mjs";
 
-export { getCommandTree };
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getVariableCommandPathName, isVariableCommandPath, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };

package/dist/plugin-utils/reflect.cjs

@@ -0,0 +1,25 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+
+//#region src/plugin-utils/reflect.ts
+/**
+* Sort command options alphabetically by name, placing boolean options with negatives appropriately.
+*
+* @param options - The array of command options to sort.
+* @returns A new array of sorted command options.
+*/
+function sortOptions(options) {
+	if (!options || options.length === 0) return [];
+	return options.filter((arg) => arg.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean || !arg.isNegativeOf).sort((a, b) => a.name.localeCompare(b.name)).reduce((ret, arg) => {
+		ret.push(arg);
+		if (arg.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean) {
+			const negativeArg = options.find((a) => a.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean && a.isNegativeOf === arg.name);
+			if (negativeArg) ret.push(negativeArg);
+		}
+		return ret;
+	}, []);
+}
+
+//#endregion
+exports.sortOptions = sortOptions;
+//# sourceMappingURL=reflect.cjs.map

package/dist/plugin-utils/reflect.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.cjs","names":["ReflectionKind","sortOptions","options","length","filter","arg","kind","boolean","isNegativeOf","sort","a","b","name","localeCompare","reduce","ret","push","negativeArg","find"],"sources":["../../src/plugin-utils/reflect.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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandOption } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(arg => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf)\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === ReflectionKind.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;;;;;;;;AA2BA,SAAgBC,YAAYC,SAA2C;AACrE,KAAI,CAACA,WAAWA,QAAQC,WAAW,EACjC,QAAO,EAAE;AAGX,QAAOD,QACJE,QAAOC,QAAOA,IAAIC,SAASN,gDAAeO,WAAW,CAACF,IAAIG,aAAa,CACvEC,MAAMC,GAAGC,MAAMD,EAAEE,KAAKC,cAAcF,EAAEC,KAAK,CAAC,CAC5CE,QAAQC,KAAKV,QAAQ;AACpBU,MAAIC,KAAKX,IAAI;AAEb,MAAIA,IAAIC,SAASN,gDAAeO,SAAS;GAEvC,MAAMU,cAAcf,QAAQgB,MAC1BR,MAAKA,EAAEJ,SAASN,gDAAeO,WAAWG,EAAEF,iBAAiBH,IAAIO,KAClE;AACD,OAAIK,YACFF,KAAIC,KAAKC,YAAY;;AAIzB,SAAOF;IACN,EAAqB,CAAC"}

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

@@ -0,0 +1,14 @@
+import { CommandOption } from "../types/command.cjs";
+
+//#region src/plugin-utils/reflect.d.ts
+
+/**
+ * Sort command options alphabetically by name, placing boolean options with negatives appropriately.
+ *
+ * @param options - The array of command options to sort.
+ * @returns A new array of sorted command options.
+ */
+declare function sortOptions(options: CommandOption[]): CommandOption[];
+//#endregion
+export { sortOptions };
+//# sourceMappingURL=reflect.d.cts.map

package/dist/plugin-utils/reflect.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.d.cts","names":[],"sources":["../../src/plugin-utils/reflect.ts"],"sourcesContent":[],"mappings":";;;;;;AA2BA;;;;iBAAgB,WAAA,UAAqB,kBAAkB"}

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

@@ -0,0 +1,14 @@
+import { CommandOption } from "../types/command.mjs";
+
+//#region src/plugin-utils/reflect.d.ts
+
+/**
+ * Sort command options alphabetically by name, placing boolean options with negatives appropriately.
+ *
+ * @param options - The array of command options to sort.
+ * @returns A new array of sorted command options.
+ */
+declare function sortOptions(options: CommandOption[]): CommandOption[];
+//#endregion
+export { sortOptions };
+//# sourceMappingURL=reflect.d.mts.map

package/dist/plugin-utils/reflect.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.d.mts","names":[],"sources":["../../src/plugin-utils/reflect.ts"],"sourcesContent":[],"mappings":";;;;;;AA2BA;;;;iBAAgB,WAAA,UAAqB,kBAAkB"}

package/dist/plugin-utils/reflect.mjs

@@ -0,0 +1,24 @@
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+
+//#region src/plugin-utils/reflect.ts
+/**
+* Sort command options alphabetically by name, placing boolean options with negatives appropriately.
+*
+* @param options - The array of command options to sort.
+* @returns A new array of sorted command options.
+*/
+function sortOptions(options) {
+	if (!options || options.length === 0) return [];
+	return options.filter((arg) => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf).sort((a, b) => a.name.localeCompare(b.name)).reduce((ret, arg) => {
+		ret.push(arg);
+		if (arg.kind === ReflectionKind.boolean) {
+			const negativeArg = options.find((a) => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name);
+			if (negativeArg) ret.push(negativeArg);
+		}
+		return ret;
+	}, []);
+}
+
+//#endregion
+export { sortOptions };
+//# sourceMappingURL=reflect.mjs.map

package/dist/plugin-utils/reflect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.mjs","names":["ReflectionKind","sortOptions","options","length","filter","arg","kind","boolean","isNegativeOf","sort","a","b","name","localeCompare","reduce","ret","push","negativeArg","find"],"sources":["../../src/plugin-utils/reflect.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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandOption } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(arg => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf)\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === ReflectionKind.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgBC,YAAYC,SAA2C;AACrE,KAAI,CAACA,WAAWA,QAAQC,WAAW,EACjC,QAAO,EAAE;AAGX,QAAOD,QACJE,QAAOC,QAAOA,IAAIC,SAASN,eAAeO,WAAW,CAACF,IAAIG,aAAa,CACvEC,MAAMC,GAAGC,MAAMD,EAAEE,KAAKC,cAAcF,EAAEC,KAAK,CAAC,CAC5CE,QAAQC,KAAKV,QAAQ;AACpBU,MAAIC,KAAKX,IAAI;AAEb,MAAIA,IAAIC,SAASN,eAAeO,SAAS;GAEvC,MAAMU,cAAcf,QAAQgB,MAC1BR,MAAKA,EAAEJ,SAASN,eAAeO,WAAWG,EAAEF,iBAAiBH,IAAIO,KAClE;AACD,OAAIK,YACFF,KAAIC,KAAKC,YAAY;;AAIzB,SAAOF;IACN,EAAqB,CAAC"}

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

@@ -0,0 +1,33 @@
+
+//#region src/plugin-utils/traverse-command-tree.ts
+/**
+* Traverses a command tree and applies a visitor function to each node.
+*
+* @param commandTree - The command tree to traverse.
+* @param visitor - The visitor function to apply to each node.
+*/
+async function traverseCommandTree(commandTree, visitor) {
+	if (!commandTree.children) return;
+	await Promise.all(Object.values(commandTree.children).map(async (childTree) => {
+		await Promise.resolve(visitor(childTree));
+		await traverseCommandTree(childTree, visitor);
+	}));
+}
+/**
+* Traverses all commands in the context and applies a visitor function to each command tree.
+*
+* @param context - The build context containing the command definitions.
+* @param visitor - The visitor function to apply to each command tree.
+*/
+async function traverseCommands(context, visitor) {
+	if (!context.commands) return;
+	await Promise.all(Object.values(context.commands).map(async (childTree) => {
+		await Promise.resolve(visitor(childTree));
+		await traverseCommandTree(childTree, visitor);
+	}));
+}
+
+//#endregion
+exports.traverseCommandTree = traverseCommandTree;
+exports.traverseCommands = traverseCommands;
+//# sourceMappingURL=traverse-command-tree.cjs.map

package/dist/plugin-utils/traverse-command-tree.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse-command-tree.cjs","names":["traverseCommandTree","commandTree","visitor","children","Promise","all","Object","values","map","childTree","resolve","traverseCommands","context","commands"],"sources":["../../src/plugin-utils/traverse-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 { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";;;;;;;;AA4BA,eAAsBA,oBACpBC,aACAC,SACe;AACf,KAAI,CAACD,YAAYE,SACf;AAGF,OAAMC,QAAQC,IACZC,OAAOC,OAAON,YAAYE,SAAS,CAACK,IAAI,OAAMC,cAAa;AACzD,QAAML,QAAQM,QAAQR,QAAQO,UAAU,CAAC;AACzC,QAAMT,oBAAoBS,WAAWP,QAAQ;GAEjD,CAAC;;;;;;;;AASH,eAAsBS,iBACpBC,SACAV,SACe;AACf,KAAI,CAACU,QAAQC,SACX;AAGF,OAAMT,QAAQC,IACZC,OAAOC,OAAOK,QAAQC,SAAS,CAACL,IAAI,OAAMC,cAAa;AACrD,QAAML,QAAQM,QAAQR,QAAQO,UAAU,CAAC;AACzC,QAAMT,oBAAoBS,WAAWP,QAAQ;GAEjD,CAAC"}

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

@@ -0,0 +1,23 @@
+import { CommandTree } from "../types/command.cjs";
+import { Context } from "../types/context.cjs";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region src/plugin-utils/traverse-command-tree.d.ts
+
+/**
+ * Traverses a command tree and applies a visitor function to each node.
+ *
+ * @param commandTree - The command tree to traverse.
+ * @param visitor - The visitor function to apply to each node.
+ */
+declare function traverseCommandTree(commandTree: CommandTree, visitor: (node: CommandTree) => MaybePromise<void>): Promise<void>;
+/**
+ * Traverses all commands in the context and applies a visitor function to each command tree.
+ *
+ * @param context - The build context containing the command definitions.
+ * @param visitor - The visitor function to apply to each command tree.
+ */
+declare function traverseCommands<TContext extends Context>(context: TContext, visitor: (node: CommandTree) => MaybePromise<void>): Promise<void>;
+//#endregion
+export { traverseCommandTree, traverseCommands };
+//# sourceMappingURL=traverse-command-tree.d.cts.map