@shell-shock/core 0.5.0 → 0.6.0

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

@@ -36,7 +36,7 @@ function getAppName(context) {
 * @returns The application title in title-case format.
 */
 function getAppTitle(context) {
-	return (0, __stryke_string_format_title_case.titleCase)(context.config.name || getAppName(context));
+	return context.config.title || (0, __stryke_string_format_title_case.titleCase)(context.config.name || getAppName(context));
 }
 /**
 * Retrieves the application description from the context and configuration.
@@ -59,28 +59,129 @@ function getAppBin(context) {
 /**
 * Determines if a given command path segment is variable (enclosed in square brackets).
 *
+* @example
+* ```typescript
+* isDynamicPathSegment("[user]"); // true
+* isDynamicPathSegment("user"); // false
+* isDynamicPathSegment("[[...user]]"); // true
+* isDynamicPathSegment("[...user]"); // true
+* ```
+*
 * @param path - The command path segment to check.
 * @returns True if the path is variable, false otherwise.
 */
-function isPositionalCommandOption(path) {
+function isDynamicPathSegment(path) {
 	return path.startsWith("[") && path.endsWith("]");
 }
 /**
+* Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
+*
+* @example
+* ```typescript
+* isOptionalCatchAllPathSegment("[[...user]]"); // true
+* isOptionalCatchAllPathSegment("[...user]"); // false
+* isOptionalCatchAllPathSegment("[user]"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is an optional catch-all segment, false otherwise.
+*/
+function isOptionalCatchAllPathSegment(path) {
+	return path.startsWith("[[...") && path.endsWith("]]");
+}
+/**
+* Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
+*
+* @example
+* ```typescript
+* isCatchAllPathSegment("[[...user]]"); // true
+* isCatchAllPathSegment("[...user]"); // true
+* isCatchAllPathSegment("[user]"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is a catch-all segment, false otherwise.
+*/
+function isCatchAllPathSegment(path) {
+	return path.startsWith("[...") && path.endsWith("]") || isOptionalCatchAllPathSegment(path);
+}
+/**
 * Extracts the variable name from a command path segment by removing enclosing square brackets.
 *
+* @example
+* ```typescript
+* getDynamicPathSegmentName("[user]"); // "user"
+* getDynamicPathSegmentName("[[...user]]"); // "user"
+* getDynamicPathSegmentName("[...user]"); // "user"
+* ```
+*
 * @param path - The command path segment.
 * @returns The variable name without square brackets.
 */
-function getPositionalCommandOptionName(path) {
+function getDynamicPathSegmentName(path) {
 	return path.replaceAll(/^\[+(?:\.\.\.)*/g, "").replaceAll(/\]+$/g, "");
 }
+/**
+* Determines if a given command path segment is a path segment group (enclosed in parentheses).
+*
+* @example
+* ```typescript
+* isPathSegmentGroup("(user)"); // true
+* isPathSegmentGroup("[[...user]]"); // false
+* isPathSegmentGroup("[...user]"); // false
+* isPathSegmentGroup("[user]"); // false
+* isPathSegmentGroup("user"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is a path segment group, false otherwise.
+*/
+function isPathSegmentGroup(path) {
+	return path.startsWith("(") && path.endsWith(")");
+}
+/**
+* Extracts the group name from a command path segment by removing enclosing parentheses.
+*
+* @example
+* ```typescript
+* getPathSegmentGroupName("(admin)"); // "admin"
+* getPathSegmentGroupName("((group))"); // "group"
+* ```
+*
+* @param path - The command path segment.
+* @returns The group name without parentheses.
+*/
+function getPathSegmentGroupName(path) {
+	return path.replaceAll(/^\(+/g, "").replaceAll(/\)+$/g, "");
+}
+/**
+* Extracts the variable name from a command path segment by removing enclosing square brackets.
+*
+* @example
+* ```typescript
+* getDynamicPathSegmentName("[user]"); // "user"
+* getDynamicPathSegmentName("[[...user]]"); // "user"
+* getDynamicPathSegmentName("[...user]"); // "user"
+* ```
+*
+* @param path - The command path segment.
+* @returns The variable name without square brackets.
+*/
+function getPathSegmentName(path) {
+	return getPathSegmentGroupName(getDynamicPathSegmentName(path));
+}
 
 //#endregion
 exports.getAppBin = getAppBin;
 exports.getAppDescription = getAppDescription;
 exports.getAppName = getAppName;
 exports.getAppTitle = getAppTitle;
-exports.getPositionalCommandOptionName = getPositionalCommandOptionName;
-exports.isPositionalCommandOption = isPositionalCommandOption;
+exports.getDynamicPathSegmentName = getDynamicPathSegmentName;
+exports.getPathSegmentGroupName = getPathSegmentGroupName;
+exports.getPathSegmentName = getPathSegmentName;
+exports.isCatchAllPathSegment = isCatchAllPathSegment;
+exports.isDynamicPathSegment = isDynamicPathSegment;
+exports.isOptionalCatchAllPathSegment = isOptionalCatchAllPathSegment;
+exports.isPathSegmentGroup = isPathSegmentGroup;
 exports.sortArgAliases = sortArgAliases;
 //# sourceMappingURL=context-helpers.cjs.map

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

@@ -1 +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","isPositionalCommandOption","path","startsWith","endsWith","getPositionalCommandOptionName","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 isPositionalCommandOption(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 getPositionalCommandOptionName(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,0BAA0BC,MAAuB;AAC/D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;AASnD,SAAgBC,+BAA+BH,MAAsB;AACnE,QAAOA,KAAKI,WAAW,oBAAoB,GAAG,CAACA,WAAW,SAAS,GAAG"}
+{"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","title","getAppDescription","description","getAppBin","Object","keys","isDynamicPathSegment","path","startsWith","endsWith","isOptionalCatchAllPathSegment","isCatchAllPathSegment","getDynamicPathSegmentName","replaceAll","isPathSegmentGroup","getPathSegmentGroupName","getPathSegmentName"],"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 (\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context))\n  );\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 * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * isDynamicPathSegment(\"[[...user]]\"); // true\n * isDynamicPathSegment(\"[...user]\"); // true\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).\n *\n * @example\n * ```typescript\n * isOptionalCatchAllPathSegment(\"[[...user]]\"); // true\n * isOptionalCatchAllPathSegment(\"[...user]\"); // false\n * isOptionalCatchAllPathSegment(\"[user]\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is an optional catch-all segment, false otherwise.\n */\nexport function isOptionalCatchAllPathSegment(path: string): boolean {\n  return path.startsWith(\"[[...\") && path.endsWith(\"]]\");\n}\n\n/**\n * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).\n *\n * @example\n * ```typescript\n * isCatchAllPathSegment(\"[[...user]]\"); // true\n * isCatchAllPathSegment(\"[...user]\"); // true\n * isCatchAllPathSegment(\"[user]\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a catch-all segment, false otherwise.\n */\nexport function isCatchAllPathSegment(path: string): boolean {\n  return (\n    (path.startsWith(\"[...\") && path.endsWith(\"]\")) ||\n    isOptionalCatchAllPathSegment(path)\n  );\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * getDynamicPathSegmentName(\"[[...user]]\"); // \"user\"\n * getDynamicPathSegmentName(\"[...user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+(?:\\.\\.\\.)*/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[[...user]]\"); // false\n * isPathSegmentGroup(\"[...user]\"); // false\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return path.startsWith(\"(\") && path.endsWith(\")\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path.replaceAll(/^\\(+/g, \"\").replaceAll(/\\)+$/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * getDynamicPathSegmentName(\"[[...user]]\"); // \"user\"\n * getDynamicPathSegmentName(\"[...user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\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,QACEA,QAAQC,OAAOQ,0DACLT,QAAQC,OAAOC,QAAQH,WAAWC,QAAQ,CAAC;;;;;;;;AAUzD,SAAgBU,kBACdV,SACQ;AACR,QACEA,QAAQC,OAAOU,eACfX,QAAQM,aAAaK,eACrB,OAAOH,YAAYR,QAAQ,CAAA;;;;;;;;AAU/B,SAAgBY,UAAUZ,SAA0B;AAClD,4DAAmBA,QAAQC,OAAOE,IAAI,GAClCU,OAAOC,KAAKd,QAAQC,OAAOE,IAAI,CAAC,sDACtBJ,WAAWC,QAAQ,CAAC;;;;;;;;;;;;;;;;AAiBpC,SAAgBe,qBAAqBC,MAAuB;AAC1D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;;;AAgBnD,SAAgBC,8BAA8BH,MAAuB;AACnE,QAAOA,KAAKC,WAAW,QAAQ,IAAID,KAAKE,SAAS,KAAK;;;;;;;;;;;;;;;AAgBxD,SAAgBE,sBAAsBJ,MAAuB;AAC3D,QACGA,KAAKC,WAAW,OAAO,IAAID,KAAKE,SAAS,IAAI,IAC9CC,8BAA8BH,KAAK;;;;;;;;;;;;;;;AAiBvC,SAAgBK,0BAA0BL,MAAsB;AAC9D,QAAOA,KAAKM,WAAW,oBAAoB,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;;;AAkBxE,SAAgBC,mBAAmBP,MAAuB;AACxD,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;;AAenD,SAAgBM,wBAAwBR,MAAsB;AAC5D,QAAOA,KAAKM,WAAW,SAAS,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;AAgB7D,SAAgBG,mBAAmBT,MAAsB;AACvD,QAAOQ,wBAAwBH,0BAA0BL,KAAK,CAAC"}

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

@@ -42,17 +42,103 @@ declare function getAppBin(context: Context): string;
 /**
  * Determines if a given command path segment is variable (enclosed in square brackets).
  *
+ * @example
+ * ```typescript
+ * isDynamicPathSegment("[user]"); // true
+ * isDynamicPathSegment("user"); // false
+ * isDynamicPathSegment("[[...user]]"); // true
+ * isDynamicPathSegment("[...user]"); // true
+ * ```
+ *
  * @param path - The command path segment to check.
  * @returns True if the path is variable, false otherwise.
  */
-declare function isPositionalCommandOption(path: string): boolean;
+declare function isDynamicPathSegment(path: string): boolean;
+/**
+ * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
+ *
+ * @example
+ * ```typescript
+ * isOptionalCatchAllPathSegment("[[...user]]"); // true
+ * isOptionalCatchAllPathSegment("[...user]"); // false
+ * isOptionalCatchAllPathSegment("[user]"); // false
+ * ```
+ *
+ * @param path - The command path segment to check.
+ * @returns True if the path is an optional catch-all segment, false otherwise.
+ */
+declare function isOptionalCatchAllPathSegment(path: string): boolean;
+/**
+ * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
+ *
+ * @example
+ * ```typescript
+ * isCatchAllPathSegment("[[...user]]"); // true
+ * isCatchAllPathSegment("[...user]"); // true
+ * isCatchAllPathSegment("[user]"); // false
+ * ```
+ *
+ * @param path - The command path segment to check.
+ * @returns True if the path is a catch-all segment, false otherwise.
+ */
+declare function isCatchAllPathSegment(path: string): boolean;
 /**
  * Extracts the variable name from a command path segment by removing enclosing square brackets.
  *
+ * @example
+ * ```typescript
+ * getDynamicPathSegmentName("[user]"); // "user"
+ * getDynamicPathSegmentName("[[...user]]"); // "user"
+ * getDynamicPathSegmentName("[...user]"); // "user"
+ * ```
+ *
+ * @param path - The command path segment.
+ * @returns The variable name without square brackets.
+ */
+declare function getDynamicPathSegmentName(path: string): string;
+/**
+ * Determines if a given command path segment is a path segment group (enclosed in parentheses).
+ *
+ * @example
+ * ```typescript
+ * isPathSegmentGroup("(user)"); // true
+ * isPathSegmentGroup("[[...user]]"); // false
+ * isPathSegmentGroup("[...user]"); // false
+ * isPathSegmentGroup("[user]"); // false
+ * isPathSegmentGroup("user"); // false
+ * ```
+ *
+ * @param path - The command path segment to check.
+ * @returns True if the path is a path segment group, false otherwise.
+ */
+declare function isPathSegmentGroup(path: string): boolean;
+/**
+ * Extracts the group name from a command path segment by removing enclosing parentheses.
+ *
+ * @example
+ * ```typescript
+ * getPathSegmentGroupName("(admin)"); // "admin"
+ * getPathSegmentGroupName("((group))"); // "group"
+ * ```
+ *
+ * @param path - The command path segment.
+ * @returns The group name without parentheses.
+ */
+declare function getPathSegmentGroupName(path: string): string;
+/**
+ * Extracts the variable name from a command path segment by removing enclosing square brackets.
+ *
+ * @example
+ * ```typescript
+ * getDynamicPathSegmentName("[user]"); // "user"
+ * getDynamicPathSegmentName("[[...user]]"); // "user"
+ * getDynamicPathSegmentName("[...user]"); // "user"
+ * ```
+ *
  * @param path - The command path segment.
  * @returns The variable name without square brackets.
  */
-declare function getPositionalCommandOptionName(path: string): string;
+declare function getPathSegmentName(path: string): string;
 //#endregion
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getPositionalCommandOptionName, isPositionalCommandOption, sortArgAliases };
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCatchAllPathSegment, isDynamicPathSegment, isOptionalCatchAllPathSegment, isPathSegmentGroup, sortArgAliases };
 //# sourceMappingURL=context-helpers.d.cts.map

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

@@ -1 +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,yBAAA;;;;;;;iBAUA,8BAAA"}
+{"version":3,"file":"context-helpers.d.cts","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8BA;AAkBA;AA0BA;AAagB,iBAzDA,cAAA,CA0DL,OAAA,EAAA,MAAA,EAAoB,CAAA,EAAA,MAAO,EAAA;AAetC;AAoBA;AAiBA;AAiBA;AAoBA;AAmBA;AAgBA;AAiBgB,iBArLA,UAAA,CAqLkB,OAAA,EArLE,iBAqLF,GArLsB,OAqLtB,CAAA,EAAA,MAAA;;;;;;;iBA3JlB,WAAA,UAAqB,oBAAoB;;;;;;;iBAazC,iBAAA,UACL,oBAAoB;;;;;;;iBAef,SAAA,UAAmB;;;;;;;;;;;;;;;iBAoBnB,oBAAA;;;;;;;;;;;;;;iBAiBA,6BAAA;;;;;;;;;;;;;;iBAiBA,qBAAA;;;;;;;;;;;;;;iBAoBA,yBAAA;;;;;;;;;;;;;;;;iBAmBA,kBAAA;;;;;;;;;;;;;iBAgBA,uBAAA;;;;;;;;;;;;;;iBAiBA,kBAAA"}

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

@@ -42,17 +42,103 @@ declare function getAppBin(context: Context): string;
 /**
  * Determines if a given command path segment is variable (enclosed in square brackets).
  *
+ * @example
+ * ```typescript
+ * isDynamicPathSegment("[user]"); // true
+ * isDynamicPathSegment("user"); // false
+ * isDynamicPathSegment("[[...user]]"); // true
+ * isDynamicPathSegment("[...user]"); // true
+ * ```
+ *
  * @param path - The command path segment to check.
  * @returns True if the path is variable, false otherwise.
  */
-declare function isPositionalCommandOption(path: string): boolean;
+declare function isDynamicPathSegment(path: string): boolean;
+/**
+ * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
+ *
+ * @example
+ * ```typescript
+ * isOptionalCatchAllPathSegment("[[...user]]"); // true
+ * isOptionalCatchAllPathSegment("[...user]"); // false
+ * isOptionalCatchAllPathSegment("[user]"); // false
+ * ```
+ *
+ * @param path - The command path segment to check.
+ * @returns True if the path is an optional catch-all segment, false otherwise.
+ */
+declare function isOptionalCatchAllPathSegment(path: string): boolean;
+/**
+ * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
+ *
+ * @example
+ * ```typescript
+ * isCatchAllPathSegment("[[...user]]"); // true
+ * isCatchAllPathSegment("[...user]"); // true
+ * isCatchAllPathSegment("[user]"); // false
+ * ```
+ *
+ * @param path - The command path segment to check.
+ * @returns True if the path is a catch-all segment, false otherwise.
+ */
+declare function isCatchAllPathSegment(path: string): boolean;
 /**
  * Extracts the variable name from a command path segment by removing enclosing square brackets.
  *
+ * @example
+ * ```typescript
+ * getDynamicPathSegmentName("[user]"); // "user"
+ * getDynamicPathSegmentName("[[...user]]"); // "user"
+ * getDynamicPathSegmentName("[...user]"); // "user"
+ * ```
+ *
+ * @param path - The command path segment.
+ * @returns The variable name without square brackets.
+ */
+declare function getDynamicPathSegmentName(path: string): string;
+/**
+ * Determines if a given command path segment is a path segment group (enclosed in parentheses).
+ *
+ * @example
+ * ```typescript
+ * isPathSegmentGroup("(user)"); // true
+ * isPathSegmentGroup("[[...user]]"); // false
+ * isPathSegmentGroup("[...user]"); // false
+ * isPathSegmentGroup("[user]"); // false
+ * isPathSegmentGroup("user"); // false
+ * ```
+ *
+ * @param path - The command path segment to check.
+ * @returns True if the path is a path segment group, false otherwise.
+ */
+declare function isPathSegmentGroup(path: string): boolean;
+/**
+ * Extracts the group name from a command path segment by removing enclosing parentheses.
+ *
+ * @example
+ * ```typescript
+ * getPathSegmentGroupName("(admin)"); // "admin"
+ * getPathSegmentGroupName("((group))"); // "group"
+ * ```
+ *
+ * @param path - The command path segment.
+ * @returns The group name without parentheses.
+ */
+declare function getPathSegmentGroupName(path: string): string;
+/**
+ * Extracts the variable name from a command path segment by removing enclosing square brackets.
+ *
+ * @example
+ * ```typescript
+ * getDynamicPathSegmentName("[user]"); // "user"
+ * getDynamicPathSegmentName("[[...user]]"); // "user"
+ * getDynamicPathSegmentName("[...user]"); // "user"
+ * ```
+ *
  * @param path - The command path segment.
  * @returns The variable name without square brackets.
  */
-declare function getPositionalCommandOptionName(path: string): string;
+declare function getPathSegmentName(path: string): string;
 //#endregion
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getPositionalCommandOptionName, isPositionalCommandOption, sortArgAliases };
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCatchAllPathSegment, isDynamicPathSegment, isOptionalCatchAllPathSegment, isPathSegmentGroup, sortArgAliases };
 //# sourceMappingURL=context-helpers.d.mts.map

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

@@ -1 +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,yBAAA;;;;;;;iBAUA,8BAAA"}
+{"version":3,"file":"context-helpers.d.mts","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8BA;AAkBA;AA0BA;AAagB,iBAzDA,cAAA,CA0DL,OAAA,EAAA,MAAA,EAAoB,CAAA,EAAA,MAAO,EAAA;AAetC;AAoBA;AAiBA;AAiBA;AAoBA;AAmBA;AAgBA;AAiBgB,iBArLA,UAAA,CAqLkB,OAAA,EArLE,iBAqLF,GArLsB,OAqLtB,CAAA,EAAA,MAAA;;;;;;;iBA3JlB,WAAA,UAAqB,oBAAoB;;;;;;;iBAazC,iBAAA,UACL,oBAAoB;;;;;;;iBAef,SAAA,UAAmB;;;;;;;;;;;;;;;iBAoBnB,oBAAA;;;;;;;;;;;;;;iBAiBA,6BAAA;;;;;;;;;;;;;;iBAiBA,qBAAA;;;;;;;;;;;;;;iBAoBA,yBAAA;;;;;;;;;;;;;;;;iBAmBA,kBAAA;;;;;;;;;;;;;iBAgBA,uBAAA;;;;;;;;;;;;;;iBAiBA,kBAAA"}

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

@@ -35,7 +35,7 @@ function getAppName(context) {
 * @returns The application title in title-case format.
 */
 function getAppTitle(context) {
-	return titleCase(context.config.name || getAppName(context));
+	return context.config.title || titleCase(context.config.name || getAppName(context));
 }
 /**
 * Retrieves the application description from the context and configuration.
@@ -58,22 +58,118 @@ function getAppBin(context) {
 /**
 * Determines if a given command path segment is variable (enclosed in square brackets).
 *
+* @example
+* ```typescript
+* isDynamicPathSegment("[user]"); // true
+* isDynamicPathSegment("user"); // false
+* isDynamicPathSegment("[[...user]]"); // true
+* isDynamicPathSegment("[...user]"); // true
+* ```
+*
 * @param path - The command path segment to check.
 * @returns True if the path is variable, false otherwise.
 */
-function isPositionalCommandOption(path) {
+function isDynamicPathSegment(path) {
 	return path.startsWith("[") && path.endsWith("]");
 }
 /**
+* Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
+*
+* @example
+* ```typescript
+* isOptionalCatchAllPathSegment("[[...user]]"); // true
+* isOptionalCatchAllPathSegment("[...user]"); // false
+* isOptionalCatchAllPathSegment("[user]"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is an optional catch-all segment, false otherwise.
+*/
+function isOptionalCatchAllPathSegment(path) {
+	return path.startsWith("[[...") && path.endsWith("]]");
+}
+/**
+* Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).
+*
+* @example
+* ```typescript
+* isCatchAllPathSegment("[[...user]]"); // true
+* isCatchAllPathSegment("[...user]"); // true
+* isCatchAllPathSegment("[user]"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is a catch-all segment, false otherwise.
+*/
+function isCatchAllPathSegment(path) {
+	return path.startsWith("[...") && path.endsWith("]") || isOptionalCatchAllPathSegment(path);
+}
+/**
 * Extracts the variable name from a command path segment by removing enclosing square brackets.
 *
+* @example
+* ```typescript
+* getDynamicPathSegmentName("[user]"); // "user"
+* getDynamicPathSegmentName("[[...user]]"); // "user"
+* getDynamicPathSegmentName("[...user]"); // "user"
+* ```
+*
 * @param path - The command path segment.
 * @returns The variable name without square brackets.
 */
-function getPositionalCommandOptionName(path) {
+function getDynamicPathSegmentName(path) {
 	return path.replaceAll(/^\[+(?:\.\.\.)*/g, "").replaceAll(/\]+$/g, "");
 }
+/**
+* Determines if a given command path segment is a path segment group (enclosed in parentheses).
+*
+* @example
+* ```typescript
+* isPathSegmentGroup("(user)"); // true
+* isPathSegmentGroup("[[...user]]"); // false
+* isPathSegmentGroup("[...user]"); // false
+* isPathSegmentGroup("[user]"); // false
+* isPathSegmentGroup("user"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is a path segment group, false otherwise.
+*/
+function isPathSegmentGroup(path) {
+	return path.startsWith("(") && path.endsWith(")");
+}
+/**
+* Extracts the group name from a command path segment by removing enclosing parentheses.
+*
+* @example
+* ```typescript
+* getPathSegmentGroupName("(admin)"); // "admin"
+* getPathSegmentGroupName("((group))"); // "group"
+* ```
+*
+* @param path - The command path segment.
+* @returns The group name without parentheses.
+*/
+function getPathSegmentGroupName(path) {
+	return path.replaceAll(/^\(+/g, "").replaceAll(/\)+$/g, "");
+}
+/**
+* Extracts the variable name from a command path segment by removing enclosing square brackets.
+*
+* @example
+* ```typescript
+* getDynamicPathSegmentName("[user]"); // "user"
+* getDynamicPathSegmentName("[[...user]]"); // "user"
+* getDynamicPathSegmentName("[...user]"); // "user"
+* ```
+*
+* @param path - The command path segment.
+* @returns The variable name without square brackets.
+*/
+function getPathSegmentName(path) {
+	return getPathSegmentGroupName(getDynamicPathSegmentName(path));
+}
 
 //#endregion
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getPositionalCommandOptionName, isPositionalCommandOption, sortArgAliases };
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCatchAllPathSegment, isDynamicPathSegment, isOptionalCatchAllPathSegment, isPathSegmentGroup, sortArgAliases };
 //# sourceMappingURL=context-helpers.mjs.map

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

@@ -1 +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","isPositionalCommandOption","path","startsWith","endsWith","getPositionalCommandOptionName","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 isPositionalCommandOption(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 getPositionalCommandOptionName(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,0BAA0BC,MAAuB;AAC/D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;AASnD,SAAgBC,+BAA+BH,MAAsB;AACnE,QAAOA,KAAKI,WAAW,oBAAoB,GAAG,CAACA,WAAW,SAAS,GAAG"}
+{"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","title","getAppDescription","description","getAppBin","Object","keys","isDynamicPathSegment","path","startsWith","endsWith","isOptionalCatchAllPathSegment","isCatchAllPathSegment","getDynamicPathSegmentName","replaceAll","isPathSegmentGroup","getPathSegmentGroupName","getPathSegmentName"],"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 (\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context))\n  );\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 * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * isDynamicPathSegment(\"[[...user]]\"); // true\n * isDynamicPathSegment(\"[...user]\"); // true\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).\n *\n * @example\n * ```typescript\n * isOptionalCatchAllPathSegment(\"[[...user]]\"); // true\n * isOptionalCatchAllPathSegment(\"[...user]\"); // false\n * isOptionalCatchAllPathSegment(\"[user]\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is an optional catch-all segment, false otherwise.\n */\nexport function isOptionalCatchAllPathSegment(path: string): boolean {\n  return path.startsWith(\"[[...\") && path.endsWith(\"]]\");\n}\n\n/**\n * Determines if a given command path segment is an optional catch-all segment (enclosed in square brackets with a leading ellipsis).\n *\n * @example\n * ```typescript\n * isCatchAllPathSegment(\"[[...user]]\"); // true\n * isCatchAllPathSegment(\"[...user]\"); // true\n * isCatchAllPathSegment(\"[user]\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a catch-all segment, false otherwise.\n */\nexport function isCatchAllPathSegment(path: string): boolean {\n  return (\n    (path.startsWith(\"[...\") && path.endsWith(\"]\")) ||\n    isOptionalCatchAllPathSegment(path)\n  );\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * getDynamicPathSegmentName(\"[[...user]]\"); // \"user\"\n * getDynamicPathSegmentName(\"[...user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+(?:\\.\\.\\.)*/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[[...user]]\"); // false\n * isPathSegmentGroup(\"[...user]\"); // false\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return path.startsWith(\"(\") && path.endsWith(\")\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path.replaceAll(/^\\(+/g, \"\").replaceAll(/\\)+$/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * getDynamicPathSegmentName(\"[[...user]]\"); // \"user\"\n * getDynamicPathSegmentName(\"[...user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\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,QACEA,QAAQC,OAAOQ,SACfxB,UAAUe,QAAQC,OAAOC,QAAQH,WAAWC,QAAQ,CAAC;;;;;;;;AAUzD,SAAgBU,kBACdV,SACQ;AACR,QACEA,QAAQC,OAAOU,eACfX,QAAQM,aAAaK,eACrB,OAAOH,YAAYR,QAAQ,CAAA;;;;;;;;AAU/B,SAAgBY,UAAUZ,SAA0B;AAClD,QAAOd,YAAYc,QAAQC,OAAOE,IAAI,GAClCU,OAAOC,KAAKd,QAAQC,OAAOE,IAAI,CAAC,KAChCnB,UAAUe,WAAWC,QAAQ,CAAC;;;;;;;;;;;;;;;;AAiBpC,SAAgBe,qBAAqBC,MAAuB;AAC1D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;;;AAgBnD,SAAgBC,8BAA8BH,MAAuB;AACnE,QAAOA,KAAKC,WAAW,QAAQ,IAAID,KAAKE,SAAS,KAAK;;;;;;;;;;;;;;;AAgBxD,SAAgBE,sBAAsBJ,MAAuB;AAC3D,QACGA,KAAKC,WAAW,OAAO,IAAID,KAAKE,SAAS,IAAI,IAC9CC,8BAA8BH,KAAK;;;;;;;;;;;;;;;AAiBvC,SAAgBK,0BAA0BL,MAAsB;AAC9D,QAAOA,KAAKM,WAAW,oBAAoB,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;;;AAkBxE,SAAgBC,mBAAmBP,MAAuB;AACxD,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;;AAenD,SAAgBM,wBAAwBR,MAAsB;AAC5D,QAAOA,KAAKM,WAAW,SAAS,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;AAgB7D,SAAgBG,mBAAmBT,MAAsB;AACvD,QAAOQ,wBAAwBH,0BAA0BL,KAAK,CAAC"}

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

@@ -12,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).filter((segment) => !require_plugin_utils_context_helpers.isPositionalCommandOption(segment));
+		const segments = path.slice(1).filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment));
 		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
 		else return null;
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.cjs","names":["isPositionalCommandOption","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 { isPositionalCommandOption } 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 => !isPositionalCommandOption(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,+DAA0BU,QAAQ,CAAC;AACzD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}
+{"version":3,"file":"get-command-tree.cjs","names":["isDynamicPathSegment","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 { isDynamicPathSegment } 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 => !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"],"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,0DAAqBU,QAAQ,CAAC;AACpD,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.mjs

@@ -1,4 +1,4 @@
-import { isPositionalCommandOption } from "./context-helpers.mjs";
+import { isDynamicPathSegment } from "./context-helpers.mjs";
 
 //#region src/plugin-utils/get-command-tree.ts
 /**
@@ -12,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).filter((segment) => !isPositionalCommandOption(segment));
+		const segments = path.slice(1).filter((segment) => !isDynamicPathSegment(segment));
 		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
 		else return null;
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.mjs","names":["isPositionalCommandOption","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 { isPositionalCommandOption } 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 => !isPositionalCommandOption(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,0BAA0BU,QAAQ,CAAC;AACzD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}
+{"version":3,"file":"get-command-tree.mjs","names":["isDynamicPathSegment","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 { isDynamicPathSegment } 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 => !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"],"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,qBAAqBU,QAAQ,CAAC;AACpD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}