@shell-shock/core 0.4.3 → 0.5.0

package/dist/helpers/validations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validations.cjs","names":["getVariableCommandPathName","isVariableCommandPath","validateCommandVariablePaths","command","failures","isVirtual","path","segments","length","variablePathNames","Set","segment","filter","has","push","code","details","add","Object","keys","variables","join","missing","prototype","hasOwnProperty","call","map","varName","find","forEach","index","variadic","validateCommandOptions","optionNames","option","values","options","name","alias","validateCommandParams","params","paramNames","param","optional","slice","nextParam","default","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  getVariableCommandPathName,\n  isVariableCommandPath\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 validateCommandVariablePaths(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.path.segments.length > 0) {\n    const variablePathNames = new Set<string>();\n    for (const segment of command.path.segments.filter(isVariableCommandPath) ??\n      []) {\n      if (variablePathNames.has(segment)) {\n        failures.push({\n          code: \"DUPLICATE_VARIABLE_PATH_NAME\",\n          details: `Duplicate variable path name \"${getVariableCommandPathName(segment)}\" found in command.`\n        });\n      }\n      variablePathNames.add(getVariableCommandPathName(segment));\n    }\n\n    if (\n      command.path.segments.filter(isVariableCommandPath).length !==\n      Object.keys(command.path.variables ?? {}).length\n    ) {\n      failures.push({\n        code: \"VARIABLE_PATH_MISMATCH\",\n        details: `Mismatch between variable path segments and defined path variables in command (found ${\n          command.path.segments.filter(isVariableCommandPath).length\n        } variables in the command folder path \"${command.path.segments.join(\"/\")}\", but ${\n          Object.keys(command.path.variables ?? {}).length\n        } potential variable path(s) could be determined from the command's function signature).`\n      });\n    }\n\n    const missing = command.path.segments\n      .filter(isVariableCommandPath)\n      .filter(\n        segment =>\n          Object.prototype.hasOwnProperty.call(\n            command.path.variables ?? {},\n            getVariableCommandPathName(segment)\n          ) === false\n      );\n    if (missing.length > 0) {\n      failures.push({\n        code: \"MISSING_VARIABLE_PATH\",\n        details: `${missing.length} variable 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 variables: \\n- ${missing\n          .map(segment => `\"${getVariableCommandPathName(segment)}\"`)\n          .join(\"\\n- \")}`\n      });\n    } else {\n      for (const varName of Object.keys(command.path.variables ?? {})) {\n        if (\n          !command.path.segments\n            .filter(isVariableCommandPath)\n            .find(segment => getVariableCommandPathName(segment) === varName)\n        ) {\n          failures.push({\n            code: \"UNUSED_VARIABLE_PATH\",\n            details: `The variable path name \"${varName}\" defined in the command's path variables 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          isVariableCommandPath(segment) &&\n          command.path.variables[getVariableCommandPathName(segment)]\n            ?.variadic === true &&\n          index + 1 < command.path.segments.length &&\n          command.path.segments[index + 1] &&\n          command.path.variables[\n            getVariableCommandPathName(command.path.segments[index + 1]!)\n          ]?.variadic === true\n        ) {\n          failures.push({\n            code: \"MULTIPLE_VARIADIC_VARIABLE_PATHS\",\n            details: `The variable path segment \"${getVariableCommandPathName(\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 variable path segment \"${getVariableCommandPathName(\n              command.path.segments[index + 1]!\n            )}\". Only one variadic variable 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 validateCommandParams(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.params.length > 0) {\n    const paramNames = new Set<string>();\n    command.params.forEach((param, index) => {\n      if (paramNames.has(param.name)) {\n        failures.push({\n          code: \"DUPLICATE_PARAM_NAME\",\n          details: `Duplicate parameter name \"${param.name}\" found in command.`\n        });\n      }\n      paramNames.add(param.name);\n\n      if (param.optional) {\n        command.params.slice(index + 1).forEach(nextParam => {\n          if (nextParam.optional && !nextParam.default) {\n            failures.push({\n              code: \"OPTIONAL_PARAM_NOT_LAST\",\n              details: `The parameter \"${nextParam.name}\" in the command at path \"${command.path.segments.join(\n                \"/\"\n              )}\" is required, but it follows an optional parameter \"${\n                param.name\n              }\". All required parameters must come before any optional parameters.`\n            });\n          }\n        });\n      }\n\n      if (param.variadic && index + 1 < command.params.length) {\n        if (command.params[index + 1]?.variadic) {\n          failures.push({\n            code: \"MULTIPLE_VARIADIC_PARAMS\",\n            details: `The parameter \"${param.name}\" in the command at path \"${command.path.segments.join(\n              \"/\"\n            )}\" is variadic, and it is followed by another variadic parameter \"${\n              command.params[index + 1]?.name\n            }\". Only one variadic parameter is allowed per command, and it must be the final parameter.`\n          });\n        }\n      }\n    });\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateCommandVariablePaths(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateCommandParams(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":["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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"}

package/dist/helpers/validations.mjs

@@ -1,35 +1,35 @@
-import { getVariableCommandPathName, isVariableCommandPath } from "../plugin-utils/context-helpers.mjs";
+import { getPositionalCommandOptionName, isPositionalCommandOption } from "../plugin-utils/context-helpers.mjs";
 
 //#region src/helpers/validations.ts
-function validateCommandVariablePaths(command) {
+function validateCommandPositionalOptions(command) {
 	const failures = [];
 	if (!command.isVirtual && command.path.segments.length > 0) {
-		const variablePathNames = /* @__PURE__ */ new Set();
-		for (const segment of command.path.segments.filter(isVariableCommandPath) ?? []) {
-			if (variablePathNames.has(segment)) failures.push({
-				code: "DUPLICATE_VARIABLE_PATH_NAME",
-				details: `Duplicate variable path name "${getVariableCommandPathName(segment)}" found in command.`
+		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.`
 			});
-			variablePathNames.add(getVariableCommandPathName(segment));
+			positionalOptionPathNames.add(getPositionalCommandOptionName(segment));
 		}
-		if (command.path.segments.filter(isVariableCommandPath).length !== Object.keys(command.path.variables ?? {}).length) failures.push({
-			code: "VARIABLE_PATH_MISMATCH",
-			details: `Mismatch between variable path segments and defined path variables in command (found ${command.path.segments.filter(isVariableCommandPath).length} variables in the command folder path "${command.path.segments.join("/")}", but ${Object.keys(command.path.variables ?? {}).length} potential variable path(s) could be determined from the command's function signature).`
+		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).`
 		});
-		const missing = command.path.segments.filter(isVariableCommandPath).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.variables ?? {}, getVariableCommandPathName(segment)) === false);
+		const missing = command.path.segments.filter(isPositionalCommandOption).filter((segment) => Object.prototype.hasOwnProperty.call(command.path.positional ?? {}, getPositionalCommandOptionName(segment)) === false);
 		if (missing.length > 0) failures.push({
-			code: "MISSING_VARIABLE_PATH",
-			details: `${missing.length} variable 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 variables: \n- ${missing.map((segment) => `"${getVariableCommandPathName(segment)}"`).join("\n- ")}`
+			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- ")}`
 		});
 		else {
-			for (const varName of Object.keys(command.path.variables ?? {})) if (!command.path.segments.filter(isVariableCommandPath).find((segment) => getVariableCommandPathName(segment) === varName)) failures.push({
-				code: "UNUSED_VARIABLE_PATH",
-				details: `The variable path name "${varName}" defined in the command's path variables is not used in the command folder path "${command.path.segments.join("/")}".`
+			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("/")}".`
 			});
 			command.path.segments.forEach((segment, index) => {
-				if (isVariableCommandPath(segment) && command.path.variables[getVariableCommandPathName(segment)]?.variadic === true && index + 1 < command.path.segments.length && command.path.segments[index + 1] && command.path.variables[getVariableCommandPathName(command.path.segments[index + 1])]?.variadic === true) failures.push({
-					code: "MULTIPLE_VARIADIC_VARIABLE_PATHS",
-					details: `The variable path segment "${getVariableCommandPathName(segment)}" in the command at path "${command.path.segments.join("/")}" is marked as variadic, and it is followed by another variadic variable path segment "${getVariableCommandPathName(command.path.segments[index + 1])}". Only one variadic variable path segment is allowed per command, and it must be the final path segment.`
+				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.`
 				});
 			});
 		}
@@ -55,37 +55,9 @@ function validateCommandOptions(command) {
 	}
 	return failures;
 }
-function validateCommandParams(command) {
-	const failures = [];
-	if (!command.isVirtual && command.params.length > 0) {
-		const paramNames = /* @__PURE__ */ new Set();
-		command.params.forEach((param, index) => {
-			if (paramNames.has(param.name)) failures.push({
-				code: "DUPLICATE_PARAM_NAME",
-				details: `Duplicate parameter name "${param.name}" found in command.`
-			});
-			paramNames.add(param.name);
-			if (param.optional) command.params.slice(index + 1).forEach((nextParam) => {
-				if (nextParam.optional && !nextParam.default) failures.push({
-					code: "OPTIONAL_PARAM_NOT_LAST",
-					details: `The parameter "${nextParam.name}" in the command at path "${command.path.segments.join("/")}" is required, but it follows an optional parameter "${param.name}". All required parameters must come before any optional parameters.`
-				});
-			});
-			if (param.variadic && index + 1 < command.params.length) {
-				if (command.params[index + 1]?.variadic) failures.push({
-					code: "MULTIPLE_VARIADIC_PARAMS",
-					details: `The parameter "${param.name}" in the command at path "${command.path.segments.join("/")}" is variadic, and it is followed by another variadic parameter "${command.params[index + 1]?.name}". Only one variadic parameter is allowed per command, and it must be the final parameter.`
-				});
-			}
-		});
-	}
-	return failures;
-}
 function validateCommand(command) {
 	const results = [];
-	let failures = validateCommandVariablePaths(command);
-	if (failures.length > 0) results.push(...failures);
-	failures = validateCommandParams(command);
+	let failures = validateCommandPositionalOptions(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":["getVariableCommandPathName","isVariableCommandPath","validateCommandVariablePaths","command","failures","isVirtual","path","segments","length","variablePathNames","Set","segment","filter","has","push","code","details","add","Object","keys","variables","join","missing","prototype","hasOwnProperty","call","map","varName","find","forEach","index","variadic","validateCommandOptions","optionNames","option","values","options","name","alias","validateCommandParams","params","paramNames","param","optional","slice","nextParam","default","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  getVariableCommandPathName,\n  isVariableCommandPath\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 validateCommandVariablePaths(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.path.segments.length > 0) {\n    const variablePathNames = new Set<string>();\n    for (const segment of command.path.segments.filter(isVariableCommandPath) ??\n      []) {\n      if (variablePathNames.has(segment)) {\n        failures.push({\n          code: \"DUPLICATE_VARIABLE_PATH_NAME\",\n          details: `Duplicate variable path name \"${getVariableCommandPathName(segment)}\" found in command.`\n        });\n      }\n      variablePathNames.add(getVariableCommandPathName(segment));\n    }\n\n    if (\n      command.path.segments.filter(isVariableCommandPath).length !==\n      Object.keys(command.path.variables ?? {}).length\n    ) {\n      failures.push({\n        code: \"VARIABLE_PATH_MISMATCH\",\n        details: `Mismatch between variable path segments and defined path variables in command (found ${\n          command.path.segments.filter(isVariableCommandPath).length\n        } variables in the command folder path \"${command.path.segments.join(\"/\")}\", but ${\n          Object.keys(command.path.variables ?? {}).length\n        } potential variable path(s) could be determined from the command's function signature).`\n      });\n    }\n\n    const missing = command.path.segments\n      .filter(isVariableCommandPath)\n      .filter(\n        segment =>\n          Object.prototype.hasOwnProperty.call(\n            command.path.variables ?? {},\n            getVariableCommandPathName(segment)\n          ) === false\n      );\n    if (missing.length > 0) {\n      failures.push({\n        code: \"MISSING_VARIABLE_PATH\",\n        details: `${missing.length} variable 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 variables: \\n- ${missing\n          .map(segment => `\"${getVariableCommandPathName(segment)}\"`)\n          .join(\"\\n- \")}`\n      });\n    } else {\n      for (const varName of Object.keys(command.path.variables ?? {})) {\n        if (\n          !command.path.segments\n            .filter(isVariableCommandPath)\n            .find(segment => getVariableCommandPathName(segment) === varName)\n        ) {\n          failures.push({\n            code: \"UNUSED_VARIABLE_PATH\",\n            details: `The variable path name \"${varName}\" defined in the command's path variables 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          isVariableCommandPath(segment) &&\n          command.path.variables[getVariableCommandPathName(segment)]\n            ?.variadic === true &&\n          index + 1 < command.path.segments.length &&\n          command.path.segments[index + 1] &&\n          command.path.variables[\n            getVariableCommandPathName(command.path.segments[index + 1]!)\n          ]?.variadic === true\n        ) {\n          failures.push({\n            code: \"MULTIPLE_VARIADIC_VARIABLE_PATHS\",\n            details: `The variable path segment \"${getVariableCommandPathName(\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 variable path segment \"${getVariableCommandPathName(\n              command.path.segments[index + 1]!\n            )}\". Only one variadic variable 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 validateCommandParams(\n  command: CommandTree\n): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n  if (!command.isVirtual && command.params.length > 0) {\n    const paramNames = new Set<string>();\n    command.params.forEach((param, index) => {\n      if (paramNames.has(param.name)) {\n        failures.push({\n          code: \"DUPLICATE_PARAM_NAME\",\n          details: `Duplicate parameter name \"${param.name}\" found in command.`\n        });\n      }\n      paramNames.add(param.name);\n\n      if (param.optional) {\n        command.params.slice(index + 1).forEach(nextParam => {\n          if (nextParam.optional && !nextParam.default) {\n            failures.push({\n              code: \"OPTIONAL_PARAM_NOT_LAST\",\n              details: `The parameter \"${nextParam.name}\" in the command at path \"${command.path.segments.join(\n                \"/\"\n              )}\" is required, but it follows an optional parameter \"${\n                param.name\n              }\". All required parameters must come before any optional parameters.`\n            });\n          }\n        });\n      }\n\n      if (param.variadic && index + 1 < command.params.length) {\n        if (command.params[index + 1]?.variadic) {\n          failures.push({\n            code: \"MULTIPLE_VARIADIC_PARAMS\",\n            details: `The parameter \"${param.name}\" in the command at path \"${command.path.segments.join(\n              \"/\"\n            )}\" is variadic, and it is followed by another variadic parameter \"${\n              command.params[index + 1]?.name\n            }\". Only one variadic parameter is allowed per command, and it must be the final parameter.`\n          });\n        }\n      }\n    });\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateCommandVariablePaths(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateCommandParams(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":["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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"}

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./types/command.cjs";
+import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandModule, CommandOption, CommandPath, CommandPositionalOption, CommandTree, CommandTreePath, Metadata, NumberCommandOption, SerializedCommandTree, StringCommandOption } 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";
 import { defineConfig } from "./config.cjs";
-import plugin from "./plugin.cjs";
 import { BaseCommandOptions } from "./types/options.cjs";
 import "./types/index.cjs";
-export { BaseCommandOption, BaseCommandOptions, BaseConfig, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, Context, NumberCommandOption, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandOption, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };
+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 };

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./types/command.mjs";
+import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandModule, CommandOption, CommandPath, CommandPositionalOption, CommandTree, CommandTreePath, Metadata, NumberCommandOption, SerializedCommandTree, StringCommandOption } 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";
 import { defineConfig } from "./config.mjs";
-import plugin from "./plugin.mjs";
 import { BaseCommandOptions } from "./types/options.mjs";
 import "./types/index.mjs";
-export { BaseCommandOption, BaseCommandOptions, BaseConfig, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, Context, NumberCommandOption, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, ShellShockAPI, ShellShockAPI as default, StringCommandOption, UnresolvedContext, UserConfig, createShellShock, defineConfig, plugin, plugin as shellShock };
+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 };

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

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

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

@@ -45,14 +45,14 @@ declare function getAppBin(context: Context): string;
  * @param path - The command path segment to check.
  * @returns True if the path is variable, false otherwise.
  */
-declare function isVariableCommandPath(path: string): boolean;
+declare function isPositionalCommandOption(path: string): boolean;
 /**
  * Extracts the variable name from a command path segment by removing enclosing square brackets.
  *
  * @param path - The command path segment.
  * @returns The variable name without square brackets.
  */
-declare function getVariableCommandPathName(path: string): string;
+declare function getPositionalCommandOptionName(path: string): string;
 //#endregion
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getVariableCommandPathName, isVariableCommandPath, sortArgAliases };
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getPositionalCommandOptionName, isPositionalCommandOption, 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,qBAAA;;;;;;;iBAUA,0BAAA"}
+{"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"}

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

@@ -45,14 +45,14 @@ declare function getAppBin(context: Context): string;
  * @param path - The command path segment to check.
  * @returns True if the path is variable, false otherwise.
  */
-declare function isVariableCommandPath(path: string): boolean;
+declare function isPositionalCommandOption(path: string): boolean;
 /**
  * Extracts the variable name from a command path segment by removing enclosing square brackets.
  *
  * @param path - The command path segment.
  * @returns The variable name without square brackets.
  */
-declare function getVariableCommandPathName(path: string): string;
+declare function getPositionalCommandOptionName(path: string): string;
 //#endregion
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getVariableCommandPathName, isVariableCommandPath, sortArgAliases };
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getPositionalCommandOptionName, isPositionalCommandOption, 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,qBAAA;;;;;;;iBAUA,0BAAA"}
+{"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"}

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

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

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.isVariableCommandPath(segment));
+		const segments = path.slice(1).filter((segment) => !require_plugin_utils_context_helpers.isPositionalCommandOption(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":["isVariableCommandPath","getCommandTree","context","path","length","currentTree","commands","segments","slice","filter","segment","children","Object","prototype","hasOwnProperty","call"],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isVariableCommandPath } from \"./context-helpers\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isVariableCommandPath(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n"],"mappings":";;;;;;;;;;AA6BA,SAAgBC,eACdC,SACAC,OAAO,EAAc,EACD;AACpB,KAAIA,KAAKC,WAAW,EAClB,QAAO;CAGT,IAAIC,cAAkCH,QAAQI,SAASH,KAAK,OAAQ;AACpE,KAAIA,KAAKC,SAAS,GAAG;EACnB,MAAMG,WAAWJ,KACdK,MAAM,EAAE,CACRC,QAAOC,YAAW,CAACV,2DAAsBU,QAAQ,CAAC;AACrD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}
+{"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"}

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

@@ -1,4 +1,4 @@
-import { isVariableCommandPath } from "./context-helpers.mjs";
+import { isPositionalCommandOption } 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) => !isVariableCommandPath(segment));
+		const segments = path.slice(1).filter((segment) => !isPositionalCommandOption(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":["isVariableCommandPath","getCommandTree","context","path","length","currentTree","commands","segments","slice","filter","segment","children","Object","prototype","hasOwnProperty","call"],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isVariableCommandPath } from \"./context-helpers\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isVariableCommandPath(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n"],"mappings":";;;;;;;;;;AA6BA,SAAgBC,eACdC,SACAC,OAAO,EAAc,EACD;AACpB,KAAIA,KAAKC,WAAW,EAClB,QAAO;CAGT,IAAIC,cAAkCH,QAAQI,SAASH,KAAK,OAAQ;AACpE,KAAIA,KAAKC,SAAS,GAAG;EACnB,MAAMG,WAAWJ,KACdK,MAAM,EAAE,CACRC,QAAOC,YAAW,CAACV,sBAAsBU,QAAQ,CAAC;AACrD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}
+{"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"}

package/dist/plugin-utils/index.cjs

@@ -8,8 +8,8 @@ exports.getAppDescription = require_plugin_utils_context_helpers.getAppDescripti
 exports.getAppName = require_plugin_utils_context_helpers.getAppName;
 exports.getAppTitle = require_plugin_utils_context_helpers.getAppTitle;
 exports.getCommandTree = require_plugin_utils_get_command_tree.getCommandTree;
-exports.getVariableCommandPathName = require_plugin_utils_context_helpers.getVariableCommandPathName;
-exports.isVariableCommandPath = require_plugin_utils_context_helpers.isVariableCommandPath;
+exports.getPositionalCommandOptionName = require_plugin_utils_context_helpers.getPositionalCommandOptionName;
+exports.isPositionalCommandOption = require_plugin_utils_context_helpers.isPositionalCommandOption;
 exports.sortArgAliases = require_plugin_utils_context_helpers.sortArgAliases;
 exports.sortOptions = require_plugin_utils_reflect.sortOptions;
 exports.traverseCommandTree = require_plugin_utils_traverse_command_tree.traverseCommandTree;

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

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

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

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

package/dist/plugin-utils/index.mjs

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

package/dist/plugin.cjs

@@ -190,7 +190,7 @@ const plugin = (options = {}) => {
 						this.debug(`Skipping reflection initialization as the meta checksum has not changed.`);
 						await require_persistence.readCommandsPersistence(this);
 					} else {
-						for (const input of this.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isVariableCommandPath(segment)).length === 1)) this.commands[input.name] = await require_resolve_command.reflectCommandTree(this, input);
+						for (const input of this.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isPositionalCommandOption(segment)).length === 1)) this.commands[input.name] = await require_resolve_command.reflectCommandTree(this, input);
 						this.debug("Post-processing commands to ensure proper reflection.");
 						this.options = this.options.map((option) => ({
 							...option,