@shell-shock/core 0.5.1 → 0.7.0

package/dist/helpers/validations.cjs

@@ -1,35 +1,35 @@
 const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
 
 //#region src/helpers/validations.ts
-function validateCommandPositionalOptions(command) {
+function validateDynamicPathSegments(command) {
 	const failures = [];
 	if (!command.isVirtual && command.path.segments.length > 0) {
-		const positionalOptionPathNames = /* @__PURE__ */ new Set();
-		for (const segment of command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption) ?? []) {
-			if (positionalOptionPathNames.has(segment)) failures.push({
-				code: "DUPLICATE_POSITIONAL_OPTION_PATH_NAME",
-				details: `Duplicate positional option path name "${require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)}" found in command.`
+		const dynamicPathSegmentNames = /* @__PURE__ */ new Set();
+		for (const segment of command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment) ?? []) {
+			if (dynamicPathSegmentNames.has(segment)) failures.push({
+				code: "DUPLICATE_DYNAMIC_PATH_SEGMENT_NAME",
+				details: `Duplicate dynamic path segment name "${require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)}" found in command.`
 			});
-			positionalOptionPathNames.add(require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment));
+			dynamicPathSegmentNames.add(require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment));
 		}
-		if (command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption).length !== Object.keys(command.path.positional ?? {}).length) failures.push({
-			code: "POSITIONAL_OPTION_PATH_MISMATCH",
-			details: `Mismatch between positional options path segments and defined path positional options in command (found ${command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption).length} positional options in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.positional ?? {}).length} potential positional option path(s) could be determined from the command's function signature).`
+		if (command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment).length !== Object.keys(command.path.dynamics ?? {}).length) failures.push({
+			code: "DYNAMIC_PATH_SEGMENT_MISMATCH",
+			details: `Mismatch between dynamic path segments and defined dynamic path segments in command (found ${command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment).length} dynamic path segments in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.dynamics ?? {}).length} potential dynamic path segment(s) could be determined from the command's function signature).`
 		});
-		const missing = command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.positional ?? {}, require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)) === false);
+		const missing = command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.dynamics ?? {}, require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)) === false);
 		if (missing.length > 0) failures.push({
-			code: "MISSING_POSITIONAL_OPTION_PATH",
-			details: `${missing.length} positional option path segment${missing.length > 1 ? "s" : ""} in the command folder path "${command.path.segments.join("/")}" do${missing.length > 1 ? "" : "es"} not have corresponding entr${missing.length > 1 ? "ies" : "y"} in the command's path positional options: \n- ${missing.map((segment) => `"${require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)}"`).join("\n- ")}`
+			code: "MISSING_DYNAMIC_PATH_SEGMENT_DEFINITION",
+			details: `${missing.length} dynamic path segment${missing.length > 1 ? "s" : ""} in the command folder path "${command.path.segments.join("/")}" do${missing.length > 1 ? "" : "es"} not have corresponding entr${missing.length > 1 ? "ies" : "y"} in the command's path dynamic segments: \n- ${missing.map((segment) => `"${require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)}"`).join("\n- ")}`
 		});
 		else {
-			for (const varName of Object.keys(command.path.positional ?? {})) if (!command.path.segments.filter(require_plugin_utils_context_helpers.isPositionalCommandOption).find((segment) => require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment) === varName)) failures.push({
-				code: "UNUSED_POSITIONAL_OPTION_PATH",
-				details: `The positional option path name "${varName}" defined in the command's path positional options is not used in the command folder path "${command.path.segments.join("/")}".`
+			for (const varName of Object.keys(command.path.dynamics ?? {})) if (!command.path.segments.filter(require_plugin_utils_context_helpers.isDynamicPathSegment).find((segment) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === varName)) failures.push({
+				code: "UNUSED_DYNAMIC_PATH_SEGMENT",
+				details: `The dynamic path segment name "${varName}" defined in the command's path dynamic segments is not used in the command folder path "${command.path.segments.join("/")}".`
 			});
 			command.path.segments.forEach((segment, index) => {
-				if (require_plugin_utils_context_helpers.isPositionalCommandOption(segment) && command.path.positional[require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)]?.variadic === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.positional[require_plugin_utils_context_helpers.getPositionalCommandOptionName(command.path.segments[index + 1])]?.variadic === true) failures.push({
-					code: "MULTIPLE_VARIADIC_POSITIONAL_OPTION_PATHS",
-					details: `The positional option path segment "${require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as variadic, and it is followed by another variadic positional option path segment "${require_plugin_utils_context_helpers.getPositionalCommandOptionName(command.path.segments[index + 1])}". Only one variadic positional option path segment is allowed per command, and it must be the final path segment.`
+				if (require_plugin_utils_context_helpers.isDynamicPathSegment(segment) && command.path.dynamics[require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)]?.catchAll === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.dynamics[require_plugin_utils_context_helpers.getDynamicPathSegmentName(command.path.segments[index + 1])]?.catchAll === true) failures.push({
+					code: "MULTIPLE_CATCH_ALL_PATH_SEGMENTS",
+					details: `The catch-all path segment "${require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as catch-all, and it is followed by another catch-all dynamic path segment "${require_plugin_utils_context_helpers.getDynamicPathSegmentName(command.path.segments[index + 1])}". Only one catch-all path segment is allowed per command, and it must be the final path segment.`
 				});
 			});
 		}
@@ -57,7 +57,7 @@ function validateCommandOptions(command) {
 }
 function validateCommand(command) {
 	const results = [];
-	let failures = validateCommandPositionalOptions(command);
+	let failures = validateDynamicPathSegments(command);
 	if (failures.length > 0) results.push(...failures);
 	failures = validateCommandOptions(command);
 	if (failures.length > 0) results.push(...failures);

package/dist/helpers/validations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validations.cjs","names":["getPositionalCommandOptionName","isPositionalCommandOption","validateCommandPositionalOptions","command","failures","isVirtual","path","segments","length","positionalOptionPathNames","Set","segment","filter","has","push","code","details","add","Object","keys","positional","join","missing","prototype","hasOwnProperty","call","map","varName","find","forEach","index","variadic","validateCommandOptions","optionNames","option","values","options","name","alias","validateCommand","results"],"sources":["../../src/helpers/validations.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 {\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateCommandPositionalOptions(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.path.segments.length > 0) {\n    const positionalOptionPathNames = new Set<string>();\n    for (const segment of command.path.segments.filter(\n      isPositionalCommandOption\n    ) ?? []) {\n      if (positionalOptionPathNames.has(segment)) {\n        failures.push({\n          code: \"DUPLICATE_POSITIONAL_OPTION_PATH_NAME\",\n          details: `Duplicate positional option path name \"${getPositionalCommandOptionName(segment)}\" found in command.`\n        });\n      }\n      positionalOptionPathNames.add(getPositionalCommandOptionName(segment));\n    }\n\n    if (\n      command.path.segments.filter(isPositionalCommandOption).length !==\n      Object.keys(command.path.positional ?? {}).length\n    ) {\n      failures.push({\n        code: \"POSITIONAL_OPTION_PATH_MISMATCH\",\n        details: `Mismatch between positional options path segments and defined path positional options in command (found ${\n          command.path.segments.filter(isPositionalCommandOption).length\n        } positional options in the command folder path \"${command.path.segments.join(\"/\")}\", but ${\n          Object.keys(command.path.positional ?? {}).length\n        } potential positional option path(s) could be determined from the command's function signature).`\n      });\n    }\n\n    const missing = command.path.segments\n      .filter(isPositionalCommandOption)\n      .filter(\n        segment =>\n          Object.prototype.hasOwnProperty.call(\n            command.path.positional ?? {},\n            getPositionalCommandOptionName(segment)\n          ) === false\n      );\n    if (missing.length > 0) {\n      failures.push({\n        code: \"MISSING_POSITIONAL_OPTION_PATH\",\n        details: `${missing.length} positional option path segment${missing.length > 1 ? \"s\" : \"\"} in the command folder path \"${command.path.segments.join(\n          \"/\"\n        )}\" do${missing.length > 1 ? \"\" : \"es\"} not have corresponding entr${\n          missing.length > 1 ? \"ies\" : \"y\"\n        } in the command's path positional options: \\n- ${missing\n          .map(segment => `\"${getPositionalCommandOptionName(segment)}\"`)\n          .join(\"\\n- \")}`\n      });\n    } else {\n      for (const varName of Object.keys(command.path.positional ?? {})) {\n        if (\n          !command.path.segments\n            .filter(isPositionalCommandOption)\n            .find(\n              segment => getPositionalCommandOptionName(segment) === varName\n            )\n        ) {\n          failures.push({\n            code: \"UNUSED_POSITIONAL_OPTION_PATH\",\n            details: `The positional option path name \"${varName}\" defined in the command's path positional options is not used in the command folder path \"${command.path.segments.join(\n              \"/\"\n            )}\".`\n          });\n        }\n      }\n\n      command.path.segments.forEach((segment, index) => {\n        if (\n          isPositionalCommandOption(segment) &&\n          command.path.positional[getPositionalCommandOptionName(segment)]\n            ?.variadic === true &&\n          index + 1 < command.path.segments.length &&\n          command.path.segments[index + 1] &&\n          command.path.positional[\n            getPositionalCommandOptionName(command.path.segments[index + 1]!)\n          ]?.variadic === true\n        ) {\n          failures.push({\n            code: \"MULTIPLE_VARIADIC_POSITIONAL_OPTION_PATHS\",\n            details: `The positional option path segment \"${getPositionalCommandOptionName(\n              segment\n            )}\" in the command at path \"${command.path.segments.join(\n              \"/\"\n            )}\" is marked as variadic, and it is followed by another variadic positional option path segment \"${getPositionalCommandOptionName(\n              command.path.segments[index + 1]!\n            )}\". Only one variadic positional option path segment is allowed per command, and it must be the final path segment.`\n          });\n        }\n      });\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommandOptions(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateCommandPositionalOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateCommandOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":"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"}
+{"version":3,"file":"validations.cjs","names":["getDynamicPathSegmentName","isDynamicPathSegment","validateDynamicPathSegments","command","failures","isVirtual","path","segments","length","dynamicPathSegmentNames","Set","segment","filter","has","push","code","details","add","Object","keys","dynamics","join","missing","prototype","hasOwnProperty","call","map","varName","find","forEach","index","catchAll","validateCommandOptions","optionNames","option","values","options","name","alias","validateCommand","results"],"sources":["../../src/helpers/validations.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 {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateDynamicPathSegments(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.path.segments.length > 0) {\n    const dynamicPathSegmentNames = new Set<string>();\n    for (const segment of command.path.segments.filter(isDynamicPathSegment) ??\n      []) {\n      if (dynamicPathSegmentNames.has(segment)) {\n        failures.push({\n          code: \"DUPLICATE_DYNAMIC_PATH_SEGMENT_NAME\",\n          details: `Duplicate dynamic path segment name \"${getDynamicPathSegmentName(segment)}\" found in command.`\n        });\n      }\n      dynamicPathSegmentNames.add(getDynamicPathSegmentName(segment));\n    }\n\n    if (\n      command.path.segments.filter(isDynamicPathSegment).length !==\n      Object.keys(command.path.dynamics ?? {}).length\n    ) {\n      failures.push({\n        code: \"DYNAMIC_PATH_SEGMENT_MISMATCH\",\n        details: `Mismatch between dynamic path segments and defined dynamic path segments in command (found ${\n          command.path.segments.filter(isDynamicPathSegment).length\n        } dynamic path segments in the command folder path \"${command.path.segments.join(\"/\")}\", but ${\n          Object.keys(command.path.dynamics ?? {}).length\n        } potential dynamic path segment(s) could be determined from the command's function signature).`\n      });\n    }\n\n    const missing = command.path.segments\n      .filter(isDynamicPathSegment)\n      .filter(\n        segment =>\n          Object.prototype.hasOwnProperty.call(\n            command.path.dynamics ?? {},\n            getDynamicPathSegmentName(segment)\n          ) === false\n      );\n    if (missing.length > 0) {\n      failures.push({\n        code: \"MISSING_DYNAMIC_PATH_SEGMENT_DEFINITION\",\n        details: `${missing.length} dynamic path segment${missing.length > 1 ? \"s\" : \"\"} in the command folder path \"${command.path.segments.join(\n          \"/\"\n        )}\" do${missing.length > 1 ? \"\" : \"es\"} not have corresponding entr${\n          missing.length > 1 ? \"ies\" : \"y\"\n        } in the command's path dynamic segments: \\n- ${missing\n          .map(segment => `\"${getDynamicPathSegmentName(segment)}\"`)\n          .join(\"\\n- \")}`\n      });\n    } else {\n      for (const varName of Object.keys(command.path.dynamics ?? {})) {\n        if (\n          !command.path.segments\n            .filter(isDynamicPathSegment)\n            .find(segment => getDynamicPathSegmentName(segment) === varName)\n        ) {\n          failures.push({\n            code: \"UNUSED_DYNAMIC_PATH_SEGMENT\",\n            details: `The dynamic path segment name \"${\n              varName\n            }\" defined in the command's path dynamic segments is not used in the command folder path \"${command.path.segments.join(\n              \"/\"\n            )}\".`\n          });\n        }\n      }\n\n      command.path.segments.forEach((segment, index) => {\n        if (\n          isDynamicPathSegment(segment) &&\n          command.path.dynamics[getDynamicPathSegmentName(segment)]\n            ?.catchAll === true &&\n          index + 1 < command.path.segments.length &&\n          command.path.segments[index + 1] &&\n          command.path.dynamics[\n            getDynamicPathSegmentName(command.path.segments[index + 1]!)\n          ]?.catchAll === true\n        ) {\n          failures.push({\n            code: \"MULTIPLE_CATCH_ALL_PATH_SEGMENTS\",\n            details: `The catch-all path segment \"${getDynamicPathSegmentName(\n              segment\n            )}\" in the command at path \"${command.path.segments.join(\n              \"/\"\n            )}\" is marked as catch-all, and it is followed by another catch-all dynamic path segment \"${getDynamicPathSegmentName(\n              command.path.segments[index + 1]!\n            )}\". Only one catch-all path segment is allowed per command, and it must be the final path segment.`\n          });\n        }\n      });\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommandOptions(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateDynamicPathSegments(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateCommandOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":"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"}

package/dist/helpers/validations.mjs

@@ -1,35 +1,35 @@
-import { getPositionalCommandOptionName, isPositionalCommandOption } from "../plugin-utils/context-helpers.mjs";
+import { getDynamicPathSegmentName, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
 
 //#region src/helpers/validations.ts
-function validateCommandPositionalOptions(command) {
+function validateDynamicPathSegments(command) {
 	const failures = [];
 	if (!command.isVirtual && command.path.segments.length > 0) {
-		const positionalOptionPathNames = /* @__PURE__ */ new Set();
-		for (const segment of command.path.segments.filter(isPositionalCommandOption) ?? []) {
-			if (positionalOptionPathNames.has(segment)) failures.push({
-				code: "DUPLICATE_POSITIONAL_OPTION_PATH_NAME",
-				details: `Duplicate positional option path name "${getPositionalCommandOptionName(segment)}" found in command.`
+		const dynamicPathSegmentNames = /* @__PURE__ */ new Set();
+		for (const segment of command.path.segments.filter(isDynamicPathSegment) ?? []) {
+			if (dynamicPathSegmentNames.has(segment)) failures.push({
+				code: "DUPLICATE_DYNAMIC_PATH_SEGMENT_NAME",
+				details: `Duplicate dynamic path segment name "${getDynamicPathSegmentName(segment)}" found in command.`
 			});
-			positionalOptionPathNames.add(getPositionalCommandOptionName(segment));
+			dynamicPathSegmentNames.add(getDynamicPathSegmentName(segment));
 		}
-		if (command.path.segments.filter(isPositionalCommandOption).length !== Object.keys(command.path.positional ?? {}).length) failures.push({
-			code: "POSITIONAL_OPTION_PATH_MISMATCH",
-			details: `Mismatch between positional options path segments and defined path positional options in command (found ${command.path.segments.filter(isPositionalCommandOption).length} positional options in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.positional ?? {}).length} potential positional option path(s) could be determined from the command's function signature).`
+		if (command.path.segments.filter(isDynamicPathSegment).length !== Object.keys(command.path.dynamics ?? {}).length) failures.push({
+			code: "DYNAMIC_PATH_SEGMENT_MISMATCH",
+			details: `Mismatch between dynamic path segments and defined dynamic path segments in command (found ${command.path.segments.filter(isDynamicPathSegment).length} dynamic path segments in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.dynamics ?? {}).length} potential dynamic path segment(s) could be determined from the command's function signature).`
 		});
-		const missing = command.path.segments.filter(isPositionalCommandOption).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.positional ?? {}, getPositionalCommandOptionName(segment)) === false);
+		const missing = command.path.segments.filter(isDynamicPathSegment).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.dynamics ?? {}, getDynamicPathSegmentName(segment)) === false);
 		if (missing.length > 0) failures.push({
-			code: "MISSING_POSITIONAL_OPTION_PATH",
-			details: `${missing.length} positional option path segment${missing.length > 1 ? "s" : ""} in the command folder path "${command.path.segments.join("/")}" do${missing.length > 1 ? "" : "es"} not have corresponding entr${missing.length > 1 ? "ies" : "y"} in the command's path positional options: \n- ${missing.map((segment) => `"${getPositionalCommandOptionName(segment)}"`).join("\n- ")}`
+			code: "MISSING_DYNAMIC_PATH_SEGMENT_DEFINITION",
+			details: `${missing.length} dynamic path segment${missing.length > 1 ? "s" : ""} in the command folder path "${command.path.segments.join("/")}" do${missing.length > 1 ? "" : "es"} not have corresponding entr${missing.length > 1 ? "ies" : "y"} in the command's path dynamic segments: \n- ${missing.map((segment) => `"${getDynamicPathSegmentName(segment)}"`).join("\n- ")}`
 		});
 		else {
-			for (const varName of Object.keys(command.path.positional ?? {})) if (!command.path.segments.filter(isPositionalCommandOption).find((segment) => getPositionalCommandOptionName(segment) === varName)) failures.push({
-				code: "UNUSED_POSITIONAL_OPTION_PATH",
-				details: `The positional option path name "${varName}" defined in the command's path positional options is not used in the command folder path "${command.path.segments.join("/")}".`
+			for (const varName of Object.keys(command.path.dynamics ?? {})) if (!command.path.segments.filter(isDynamicPathSegment).find((segment) => getDynamicPathSegmentName(segment) === varName)) failures.push({
+				code: "UNUSED_DYNAMIC_PATH_SEGMENT",
+				details: `The dynamic path segment name "${varName}" defined in the command's path dynamic segments is not used in the command folder path "${command.path.segments.join("/")}".`
 			});
 			command.path.segments.forEach((segment, index) => {
-				if (isPositionalCommandOption(segment) && command.path.positional[getPositionalCommandOptionName(segment)]?.variadic === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.positional[getPositionalCommandOptionName(command.path.segments[index + 1])]?.variadic === true) failures.push({
-					code: "MULTIPLE_VARIADIC_POSITIONAL_OPTION_PATHS",
-					details: `The positional option path segment "${getPositionalCommandOptionName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as variadic, and it is followed by another variadic positional option path segment "${getPositionalCommandOptionName(command.path.segments[index + 1])}". Only one variadic positional option path segment is allowed per command, and it must be the final path segment.`
+				if (isDynamicPathSegment(segment) && command.path.dynamics[getDynamicPathSegmentName(segment)]?.catchAll === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.dynamics[getDynamicPathSegmentName(command.path.segments[index + 1])]?.catchAll === true) failures.push({
+					code: "MULTIPLE_CATCH_ALL_PATH_SEGMENTS",
+					details: `The catch-all path segment "${getDynamicPathSegmentName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as catch-all, and it is followed by another catch-all dynamic path segment "${getDynamicPathSegmentName(command.path.segments[index + 1])}". Only one catch-all path segment is allowed per command, and it must be the final path segment.`
 				});
 			});
 		}
@@ -57,7 +57,7 @@ function validateCommandOptions(command) {
 }
 function validateCommand(command) {
 	const results = [];
-	let failures = validateCommandPositionalOptions(command);
+	let failures = validateDynamicPathSegments(command);
 	if (failures.length > 0) results.push(...failures);
 	failures = validateCommandOptions(command);
 	if (failures.length > 0) results.push(...failures);

package/dist/helpers/validations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validations.mjs","names":["getPositionalCommandOptionName","isPositionalCommandOption","validateCommandPositionalOptions","command","failures","isVirtual","path","segments","length","positionalOptionPathNames","Set","segment","filter","has","push","code","details","add","Object","keys","positional","join","missing","prototype","hasOwnProperty","call","map","varName","find","forEach","index","variadic","validateCommandOptions","optionNames","option","values","options","name","alias","validateCommand","results"],"sources":["../../src/helpers/validations.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 {\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateCommandPositionalOptions(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.path.segments.length > 0) {\n    const positionalOptionPathNames = new Set<string>();\n    for (const segment of command.path.segments.filter(\n      isPositionalCommandOption\n    ) ?? []) {\n      if (positionalOptionPathNames.has(segment)) {\n        failures.push({\n          code: \"DUPLICATE_POSITIONAL_OPTION_PATH_NAME\",\n          details: `Duplicate positional option path name \"${getPositionalCommandOptionName(segment)}\" found in command.`\n        });\n      }\n      positionalOptionPathNames.add(getPositionalCommandOptionName(segment));\n    }\n\n    if (\n      command.path.segments.filter(isPositionalCommandOption).length !==\n      Object.keys(command.path.positional ?? {}).length\n    ) {\n      failures.push({\n        code: \"POSITIONAL_OPTION_PATH_MISMATCH\",\n        details: `Mismatch between positional options path segments and defined path positional options in command (found ${\n          command.path.segments.filter(isPositionalCommandOption).length\n        } positional options in the command folder path \"${command.path.segments.join(\"/\")}\", but ${\n          Object.keys(command.path.positional ?? {}).length\n        } potential positional option path(s) could be determined from the command's function signature).`\n      });\n    }\n\n    const missing = command.path.segments\n      .filter(isPositionalCommandOption)\n      .filter(\n        segment =>\n          Object.prototype.hasOwnProperty.call(\n            command.path.positional ?? {},\n            getPositionalCommandOptionName(segment)\n          ) === false\n      );\n    if (missing.length > 0) {\n      failures.push({\n        code: \"MISSING_POSITIONAL_OPTION_PATH\",\n        details: `${missing.length} positional option path segment${missing.length > 1 ? \"s\" : \"\"} in the command folder path \"${command.path.segments.join(\n          \"/\"\n        )}\" do${missing.length > 1 ? \"\" : \"es\"} not have corresponding entr${\n          missing.length > 1 ? \"ies\" : \"y\"\n        } in the command's path positional options: \\n- ${missing\n          .map(segment => `\"${getPositionalCommandOptionName(segment)}\"`)\n          .join(\"\\n- \")}`\n      });\n    } else {\n      for (const varName of Object.keys(command.path.positional ?? {})) {\n        if (\n          !command.path.segments\n            .filter(isPositionalCommandOption)\n            .find(\n              segment => getPositionalCommandOptionName(segment) === varName\n            )\n        ) {\n          failures.push({\n            code: \"UNUSED_POSITIONAL_OPTION_PATH\",\n            details: `The positional option path name \"${varName}\" defined in the command's path positional options is not used in the command folder path \"${command.path.segments.join(\n              \"/\"\n            )}\".`\n          });\n        }\n      }\n\n      command.path.segments.forEach((segment, index) => {\n        if (\n          isPositionalCommandOption(segment) &&\n          command.path.positional[getPositionalCommandOptionName(segment)]\n            ?.variadic === true &&\n          index + 1 < command.path.segments.length &&\n          command.path.segments[index + 1] &&\n          command.path.positional[\n            getPositionalCommandOptionName(command.path.segments[index + 1]!)\n          ]?.variadic === true\n        ) {\n          failures.push({\n            code: \"MULTIPLE_VARIADIC_POSITIONAL_OPTION_PATHS\",\n            details: `The positional option path segment \"${getPositionalCommandOptionName(\n              segment\n            )}\" in the command at path \"${command.path.segments.join(\n              \"/\"\n            )}\" is marked as variadic, and it is followed by another variadic positional option path segment \"${getPositionalCommandOptionName(\n              command.path.segments[index + 1]!\n            )}\". Only one variadic positional option path segment is allowed per command, and it must be the final path segment.`\n          });\n        }\n      });\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommandOptions(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateCommandPositionalOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateCommandOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":"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"}
+{"version":3,"file":"validations.mjs","names":["getDynamicPathSegmentName","isDynamicPathSegment","validateDynamicPathSegments","command","failures","isVirtual","path","segments","length","dynamicPathSegmentNames","Set","segment","filter","has","push","code","details","add","Object","keys","dynamics","join","missing","prototype","hasOwnProperty","call","map","varName","find","forEach","index","catchAll","validateCommandOptions","optionNames","option","values","options","name","alias","validateCommand","results"],"sources":["../../src/helpers/validations.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 {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateDynamicPathSegments(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.path.segments.length > 0) {\n    const dynamicPathSegmentNames = new Set<string>();\n    for (const segment of command.path.segments.filter(isDynamicPathSegment) ??\n      []) {\n      if (dynamicPathSegmentNames.has(segment)) {\n        failures.push({\n          code: \"DUPLICATE_DYNAMIC_PATH_SEGMENT_NAME\",\n          details: `Duplicate dynamic path segment name \"${getDynamicPathSegmentName(segment)}\" found in command.`\n        });\n      }\n      dynamicPathSegmentNames.add(getDynamicPathSegmentName(segment));\n    }\n\n    if (\n      command.path.segments.filter(isDynamicPathSegment).length !==\n      Object.keys(command.path.dynamics ?? {}).length\n    ) {\n      failures.push({\n        code: \"DYNAMIC_PATH_SEGMENT_MISMATCH\",\n        details: `Mismatch between dynamic path segments and defined dynamic path segments in command (found ${\n          command.path.segments.filter(isDynamicPathSegment).length\n        } dynamic path segments in the command folder path \"${command.path.segments.join(\"/\")}\", but ${\n          Object.keys(command.path.dynamics ?? {}).length\n        } potential dynamic path segment(s) could be determined from the command's function signature).`\n      });\n    }\n\n    const missing = command.path.segments\n      .filter(isDynamicPathSegment)\n      .filter(\n        segment =>\n          Object.prototype.hasOwnProperty.call(\n            command.path.dynamics ?? {},\n            getDynamicPathSegmentName(segment)\n          ) === false\n      );\n    if (missing.length > 0) {\n      failures.push({\n        code: \"MISSING_DYNAMIC_PATH_SEGMENT_DEFINITION\",\n        details: `${missing.length} dynamic path segment${missing.length > 1 ? \"s\" : \"\"} in the command folder path \"${command.path.segments.join(\n          \"/\"\n        )}\" do${missing.length > 1 ? \"\" : \"es\"} not have corresponding entr${\n          missing.length > 1 ? \"ies\" : \"y\"\n        } in the command's path dynamic segments: \\n- ${missing\n          .map(segment => `\"${getDynamicPathSegmentName(segment)}\"`)\n          .join(\"\\n- \")}`\n      });\n    } else {\n      for (const varName of Object.keys(command.path.dynamics ?? {})) {\n        if (\n          !command.path.segments\n            .filter(isDynamicPathSegment)\n            .find(segment => getDynamicPathSegmentName(segment) === varName)\n        ) {\n          failures.push({\n            code: \"UNUSED_DYNAMIC_PATH_SEGMENT\",\n            details: `The dynamic path segment name \"${\n              varName\n            }\" defined in the command's path dynamic segments is not used in the command folder path \"${command.path.segments.join(\n              \"/\"\n            )}\".`\n          });\n        }\n      }\n\n      command.path.segments.forEach((segment, index) => {\n        if (\n          isDynamicPathSegment(segment) &&\n          command.path.dynamics[getDynamicPathSegmentName(segment)]\n            ?.catchAll === true &&\n          index + 1 < command.path.segments.length &&\n          command.path.segments[index + 1] &&\n          command.path.dynamics[\n            getDynamicPathSegmentName(command.path.segments[index + 1]!)\n          ]?.catchAll === true\n        ) {\n          failures.push({\n            code: \"MULTIPLE_CATCH_ALL_PATH_SEGMENTS\",\n            details: `The catch-all path segment \"${getDynamicPathSegmentName(\n              segment\n            )}\" in the command at path \"${command.path.segments.join(\n              \"/\"\n            )}\" is marked as catch-all, and it is followed by another catch-all dynamic path segment \"${getDynamicPathSegmentName(\n              command.path.segments[index + 1]!\n            )}\". Only one catch-all path segment is allowed per command, and it must be the final path segment.`\n          });\n        }\n      });\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommandOptions(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateDynamicPathSegments(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateCommandOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandModule, CommandOption, CommandPath, CommandPositionalOption, CommandTree, CommandTreePath, Metadata, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./types/command.cjs";
+import { BaseCommandArgument, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandBase, CommandDynamicSegment, CommandInput, CommandModule, CommandOption, CommandParameter, CommandPath, CommandTree, CommandTreePath, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, SerializedCommandDynamicSegment, SerializedCommandOption, SerializedCommandParameter, SerializedCommandTree, SerializedCommandTreePath, StringCommandArgument, StringCommandOption, StringCommandParameter } from "./types/command.cjs";
 import { Context, UnresolvedContext } from "./types/context.cjs";
 import { BaseConfig, Options, OutputConfig, ResolvedConfig, UserConfig } from "./types/config.cjs";
 import { ShellShockAPI, createShellShock } from "./api.cjs";
@@ -6,4 +6,4 @@ import { defineConfig } from "./config.cjs";
 import { BaseCommandOptions } from "./types/options.cjs";
 import "./types/index.cjs";
 import plugin from "./plugin.cjs";
-export { BaseCommandOption, BaseCommandOptions, BaseConfig, BooleanCommandOption, CommandBase, CommandInput, CommandModule, CommandOption, CommandPath, CommandPositionalOption, CommandTree, CommandTreePath, Context, Metadata, NumberCommandOption, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandOption, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };
+export { BaseCommandArgument, BaseCommandOptions, BaseConfig, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandBase, CommandDynamicSegment, CommandInput, CommandModule, CommandOption, CommandParameter, CommandPath, CommandTree, CommandTreePath, Context, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, Options, OutputConfig, ResolvedConfig, SerializedCommandDynamicSegment, SerializedCommandOption, SerializedCommandParameter, SerializedCommandTree, SerializedCommandTreePath, ShellShockAPI, ShellShockAPI as default, StringCommandArgument, StringCommandOption, StringCommandParameter, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandModule, CommandOption, CommandPath, CommandPositionalOption, CommandTree, CommandTreePath, Metadata, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./types/command.mjs";
+import { BaseCommandArgument, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandBase, CommandDynamicSegment, CommandInput, CommandModule, CommandOption, CommandParameter, CommandPath, CommandTree, CommandTreePath, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, SerializedCommandDynamicSegment, SerializedCommandOption, SerializedCommandParameter, SerializedCommandTree, SerializedCommandTreePath, StringCommandArgument, StringCommandOption, StringCommandParameter } from "./types/command.mjs";
 import { Context, UnresolvedContext } from "./types/context.mjs";
 import { BaseConfig, Options, OutputConfig, ResolvedConfig, UserConfig } from "./types/config.mjs";
 import { ShellShockAPI, createShellShock } from "./api.mjs";
@@ -6,4 +6,4 @@ import { defineConfig } from "./config.mjs";
 import { BaseCommandOptions } from "./types/options.mjs";
 import "./types/index.mjs";
 import plugin from "./plugin.mjs";
-export { BaseCommandOption, BaseCommandOptions, BaseConfig, BooleanCommandOption, CommandBase, CommandInput, CommandModule, CommandOption, CommandPath, CommandPositionalOption, CommandTree, CommandTreePath, Context, Metadata, NumberCommandOption, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandOption, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };
+export { BaseCommandArgument, BaseCommandOptions, BaseConfig, BooleanCommandArgument, BooleanCommandOption, BooleanCommandParameter, CommandBase, CommandDynamicSegment, CommandInput, CommandModule, CommandOption, CommandParameter, CommandPath, CommandTree, CommandTreePath, Context, Metadata, NumberCommandArgument, NumberCommandOption, NumberCommandParameter, Options, OutputConfig, ResolvedConfig, SerializedCommandDynamicSegment, SerializedCommandOption, SerializedCommandParameter, SerializedCommandTree, SerializedCommandTreePath, ShellShockAPI, ShellShockAPI as default, StringCommandArgument, StringCommandOption, StringCommandParameter, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };

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

@@ -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","title","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 (\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 * @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,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;;;;;;;;AASpC,SAAgBe,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;AAagB,iBAzDA,cAAA,CA0DL,OAAA,EAAA,MAAA,EAAoB,CAAA,EAAA,MAAO,EAAA;AAetC;AAYA;AAUA;;;;;iBA7EgB,UAAA,UAAoB,oBAAoB;;;;;;;iBA0BxC,WAAA,UAAqB,oBAAoB;;;;;;;iBAazC,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"}