@shell-shock/core 0.8.13 → 0.9.0

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

@@ -5,6 +5,10 @@ let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-str
 let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
 
 //#region src/plugin-utils/context-helpers.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
 *
@@ -13,10 +17,28 @@ let __stryke_string_format_title_case = require("@stryke/string-format/title-cas
 */
 function sortArgAliases(aliases) {
 	if (aliases.length === 0) return [];
-	const result = aliases.filter((alias) => alias.length === 1);
-	result.push(...aliases.filter((alias) => alias.length > 1));
-	return result.sort((a, b) => a.localeCompare(b));
+	const result = aliases.filter(__assignType((alias) => alias.length === 1, [
+		"alias",
+		"",
+		"P\"2!\"/\""
+	]));
+	result.push(...aliases.filter(__assignType((alias) => alias.length > 1, [
+		"alias",
+		"",
+		"P\"2!\"/\""
+	])));
+	return result.sort(__assignType((a, b) => a.localeCompare(b), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	]));
 }
+sortArgAliases.__type = [
+	"aliases",
+	"sortArgAliases",
+	"P&F2!&F/\""
+];
 /**
 * Retrieves the application name from the context and configuration.
 *
@@ -29,6 +51,13 @@ function getAppName(context) {
 	if (!(0, __stryke_type_checks_is_set_string.isSetString)(result)) throw new Error("No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.");
 	return (0, __stryke_string_format_kebab_case.kebabCase)(result);
 }
+getAppName.__type = [
+	"UnresolvedContext",
+	"Context",
+	"context",
+	"getAppName",
+	"PP\"w!\"w\"J2#&/$"
+];
 /**
 * Retrieves the application title from the context and configuration.
 *
@@ -40,6 +69,14 @@ function getAppTitle(context, replaceCLI = false) {
 	const title = context.config.title || (0, __stryke_string_format_title_case.titleCase)(context.config.name || getAppName(context));
 	return (replaceCLI ? title.replace(/(?:cli|command-line|command line)\s*(?:interface\s*)?(?:application|app)?$/gi, "") : title).trim();
 }
+getAppTitle.__type = [
+	"UnresolvedContext",
+	"Context",
+	"context",
+	"replaceCLI",
+	"getAppTitle",
+	"PP\"w!\"w\"J2#\"2$&/%"
+];
 /**
 * Retrieves the application description from the context and configuration.
 *
@@ -49,6 +86,13 @@ function getAppTitle(context, replaceCLI = false) {
 function getAppDescription(context) {
 	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context, true)} command-line interface application.`;
 }
+getAppDescription.__type = [
+	"UnresolvedContext",
+	"Context",
+	"context",
+	"getAppDescription",
+	"PP\"w!\"w\"J2#&/$"
+];
 /**
 * Retrieves the primary binary name for the application.
 *
@@ -58,6 +102,12 @@ function getAppDescription(context) {
 function getAppBin(context) {
 	return (0, __stryke_type_checks_is_set_object.isSetObject)(context.config.bin) ? Object.keys(context.config.bin)[0] : (0, __stryke_string_format_kebab_case.kebabCase)(getAppName(context));
 }
+getAppBin.__type = [
+	"Context",
+	"context",
+	"getAppBin",
+	"P\"w!2\"&/#"
+];
 /**
 * Determines if a given command path segment is variable (enclosed in square brackets).
 *
@@ -73,6 +123,11 @@ function getAppBin(context) {
 function isDynamicPathSegment(path) {
 	return path.startsWith("[") && path.endsWith("]");
 }
+isDynamicPathSegment.__type = [
+	"path",
+	"isDynamicPathSegment",
+	"P&2!)/\""
+];
 /**
 * Extracts the variable name from a command path segment by removing enclosing square brackets.
 *
@@ -87,6 +142,11 @@ function isDynamicPathSegment(path) {
 function getDynamicPathSegmentName(path) {
 	return path.replaceAll(/^\[+/g, "").replaceAll(/\]+$/g, "");
 }
+getDynamicPathSegmentName.__type = [
+	"path",
+	"getDynamicPathSegmentName",
+	"P&2!&/\""
+];
 /**
 * Determines if a given command path segment is a path segment group (enclosed in parentheses).
 *
@@ -103,6 +163,11 @@ function getDynamicPathSegmentName(path) {
 function isPathSegmentGroup(path) {
 	return path.startsWith("(") && path.endsWith(")") || path.startsWith("_");
 }
+isPathSegmentGroup.__type = [
+	"path",
+	"isPathSegmentGroup",
+	"P&2!)/\""
+];
 /**
 * Extracts the group name from a command path segment by removing enclosing parentheses.
 *
@@ -118,6 +183,11 @@ function isPathSegmentGroup(path) {
 function getPathSegmentGroupName(path) {
 	return path.replaceAll(/^\(+/g, "").replaceAll(/\)+$/g, "").replaceAll(/^_+/g, "");
 }
+getPathSegmentGroupName.__type = [
+	"path",
+	"getPathSegmentGroupName",
+	"P&2!&/\""
+];
 /**
 * Extracts the variable name from a command path segment by removing enclosing square brackets.
 *
@@ -132,6 +202,11 @@ function getPathSegmentGroupName(path) {
 function getPathSegmentName(path) {
 	return getPathSegmentGroupName(getDynamicPathSegmentName(path));
 }
+getPathSegmentName.__type = [
+	"path",
+	"getPathSegmentName",
+	"P&2!&/\""
+];
 
 //#endregion
 exports.getAppBin = getAppBin;

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","replaceCLI","title","replace","trim","getAppDescription","description","getAppBin","Object","keys","isDynamicPathSegment","path","startsWith","endsWith","getDynamicPathSegmentName","replaceAll","isPathSegmentGroup","getPathSegmentGroupName","getPathSegmentName"],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type { Context, UnresolvedContext } from \"../types\";\n\n/**\n * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.\n *\n * @param aliases - An array of argument aliases to sort.\n * @returns A new array of sorted aliases.\n */\nexport function sortArgAliases(aliases: string[]): string[] {\n  if (aliases.length === 0) {\n    return [];\n  }\n\n  const result = aliases.filter(alias => alias.length === 1);\n  result.push(...aliases.filter(alias => alias.length > 1));\n\n  return result.sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Retrieves the application name from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application name in kebab-case format.\n * @throws An error if no valid application name is found.\n */\nexport function getAppName(context: UnresolvedContext | Context): string {\n  const result =\n    context.config.name ||\n    (isSetString(context.config.bin) ||\n    (Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0 &&\n      isSetString(context.config.bin[0]))\n      ? isSetString(context.config.bin)\n        ? context.config.bin\n        : context.config.bin[0]\n      : context.packageJson?.name);\n  if (!isSetString(result)) {\n    throw new Error(\n      \"No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.\"\n    );\n  }\n\n  return kebabCase(result);\n}\n\n/**\n * Retrieves the application title from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(\n  context: UnresolvedContext | Context,\n  replaceCLI = false\n): string {\n  const title =\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context));\n\n  return (\n    replaceCLI\n      ? title.replace(\n          /(?:cli|command-line|command line)\\s*(?:interface\\s*)?(?:application|app)?$/gi,\n          \"\"\n        )\n      : title\n  ).trim();\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, true)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return (path.startsWith(\"(\") && path.endsWith(\")\")) || path.startsWith(\"_\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path\n    .replaceAll(/^\\(+/g, \"\")\n    .replaceAll(/\\)+$/g, \"\")\n    .replaceAll(/^_+/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgBI,eAAeC,SAA6B;AAC1D,KAAIA,QAAQC,WAAW,EACrB,QAAO,EAAE;CAGX,MAAMC,SAASF,QAAQG,QAAOC,UAASA,MAAMH,WAAW,EAAE;AAC1DC,QAAOG,KAAK,GAAGL,QAAQG,QAAOC,UAASA,MAAMH,SAAS,EAAE,CAAC;AAEzD,QAAOC,OAAOI,MAAMC,GAAGC,MAAMD,EAAEE,cAAcD,EAAE,CAAC;;;;;;;;;AAUlD,SAAgBE,WAAWC,SAA8C;CACvE,MAAMT,SACJS,QAAQC,OAAOC,6DACFF,QAAQC,OAAOE,IAAI,IAC/BC,MAAMC,QAAQL,QAAQC,OAAOE,IAAI,IAChCH,QAAQC,OAAOE,IAAIb,SAAS,yDAChBU,QAAQC,OAAOE,IAAI,GAAI,uDACrBH,QAAQC,OAAOE,IAAI,GAC7BH,QAAQC,OAAOE,MACfH,QAAQC,OAAOE,IAAI,KACrBH,QAAQM,aAAaJ;AAC3B,KAAI,qDAAaX,OAAO,CACtB,OAAM,IAAIgB,MACR,qIACD;AAGH,yDAAiBhB,OAAO;;;;;;;;;AAU1B,SAAgBiB,YACdR,SACAS,aAAa,OACL;CACR,MAAMC,QACJV,QAAQC,OAAOS,0DACLV,QAAQC,OAAOC,QAAQH,WAAWC,QAAQ,CAAC;AAEvD,SACES,aACIC,MAAMC,QACJ,gFACA,GACD,GACDD,OACJE,MAAM;;;;;;;;AASV,SAAgBC,kBACdb,SACQ;AACR,QACEA,QAAQC,OAAOa,eACfd,QAAQM,aAAaQ,eACrB,OAAON,YAAYR,SAAS,KAAK,CAAA;;;;;;;;AAUrC,SAAgBe,UAAUf,SAA0B;AAClD,4DAAmBA,QAAQC,OAAOE,IAAI,GAClCa,OAAOC,KAAKjB,QAAQC,OAAOE,IAAI,CAAC,sDACtBJ,WAAWC,QAAQ,CAAC;;;;;;;;;;;;;;AAepC,SAAgBkB,qBAAqBC,MAAuB;AAC1D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;AAcnD,SAAgBC,0BAA0BH,MAAsB;AAC9D,QAAOA,KAAKI,WAAW,SAAS,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;AAgB7D,SAAgBC,mBAAmBL,MAAuB;AACxD,QAAQA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI,IAAKF,KAAKC,WAAW,IAAI;;;;;;;;;;;;;;AAe7E,SAAgBK,wBAAwBN,MAAsB;AAC5D,QAAOA,KACJI,WAAW,SAAS,GAAG,CACvBA,WAAW,SAAS,GAAG,CACvBA,WAAW,QAAQ,GAAG;;;;;;;;;;;;;AAc3B,SAAgBG,mBAAmBP,MAAsB;AACvD,QAAOM,wBAAwBH,0BAA0BH,KAAK,CAAC"}
+{"version":3,"file":"context-helpers.cjs","names":[],"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 * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(\n  context: UnresolvedContext | Context,\n  replaceCLI = false\n): string {\n  const title =\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context));\n\n  return (\n    replaceCLI\n      ? title.replace(\n          /(?:cli|command-line|command line)\\s*(?:interface\\s*)?(?:application|app)?$/gi,\n          \"\"\n        )\n      : title\n  ).trim();\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, true)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return (path.startsWith(\"(\") && path.endsWith(\")\")) || path.startsWith(\"_\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path\n    .replaceAll(/^\\(+/g, \"\")\n    .replaceAll(/\\)+$/g, \"\")\n    .replaceAll(/^_+/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\n}\n"],"mappings":";;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA6BX,SAAgB,eAAY,SAAA;AACxB,KAAI,QAAK,WAAA,EACX,QAAA,EAAA;CAEE,MAAM,SAAS,QAAQ,OAAO,cAAa,UAAS,MAAI,WAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;AACxD,QAAO,KAAK,GAAG,QAAQ,OAAO,cAAa,UAAS,MAAG,SAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;;;;;;;AAG3D,eAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQA,SAAE,WAAA,SAAA;CACE,MAAM,SAAS,QAAQ,OAAO,6DACnB,QAAA,OAAA,IAAA,IACF,MAAM,QAAM,QAAA,OAAA,IAAA,IACT,QAAQ,OAAO,IAAI,SAAG,yDACV,QAAQ,OAAI,IAAA,GAAA,uDACd,QAAQ,OAAG,IAAA,GACnB,QAAQ,OAAO,MACf,QAAQ,OAAO,IAAI,KACvB,QAAQ,aAAK;AACvB,KAAI,qDAAa,OAAO,CACpB,OAAM,IAAI,MAAM,qIAAU;AAE9B,yDAAe,OAAA;;AAEnB,WAAK,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQL,SAAC,YAAA,SAAA,aAAA,OAAA;CACG,MAAM,QAAQ,QAAQ,OAAO,0DACf,QAAQ,OAAO,QAAQ,WAAW,QAAQ,CAAC;AACzD,SAAQ,aACV,MAAA,QAAA,gFAAA,GAAA,GACQ,OAAO,MAAM;;AAEvB,YAAY,SAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOnB,SAAa,kBAAA,SAAA;AACT,QAAQ,QAAQ,OAAC,eACb,QAAQ,aAAa,eACrB,OAAG,YAAA,SAAA,KAAA,CAAA;;AAEX,kBAAY,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOZ,SAAgB,UAAU,SAAS;AAC/B,4DAAmB,QAAQ,OAAO,IAAC,GACrC,OAAA,KAAA,QAAA,OAAA,IAAA,CAAA,sDACkB,WAAW,QAAE,CAAA;;AAEjC,UAAU,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;AAaV,SAAE,qBAAA,MAAA;AACE,QAAO,KAAK,WAAW,IAAI,IAAI,KAAK,SAAS,IAAG;;AAEpD,qBAAqB,SAAS;CAAC;CAAQ;CAAC;CAAA;;;;;;;;;;;;AAYxC,SAAC,0BAAA,MAAA;AACG,QAAO,KAAK,WAAW,SAAS,GAAG,CAAC,WAAU,SAAA,GAAA;;AAElD,0BAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAcF,SAAgB,mBAAmB,MAAM;AACvC,QAAA,KAAA,WAAA,IAAA,IAAA,KAAA,SAAA,IAAA,IAAA,KAAA,WAAA,IAAA;;AAEF,mBAAmB,SAAS;CAAC;CAAQ;CAAsB;CAAE;;;;;;;;;;;;;AAa7D,SAAgB,wBAAwB,MAAM;AAC1C,QAAO,KACT,WAAA,SAAA,GAAA,CACO,WAAW,SAAS,GAAG,CACvB,WAAW,QAAQ,GAAG;;;;;;;;;;;;;;;;;;AAc/B,SAAE,mBAAA,MAAA;AACE,QAAO,wBAAwB,0BAA0B,KAAC,CAAA;;AAE9D,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA"}

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

@@ -4,6 +4,10 @@ import { isSetString } from "@stryke/type-checks/is-set-string";
 import { titleCase } from "@stryke/string-format/title-case";
 
 //#region src/plugin-utils/context-helpers.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
 *
@@ -12,10 +16,28 @@ import { titleCase } from "@stryke/string-format/title-case";
 */
 function sortArgAliases(aliases) {
 	if (aliases.length === 0) return [];
-	const result = aliases.filter((alias) => alias.length === 1);
-	result.push(...aliases.filter((alias) => alias.length > 1));
-	return result.sort((a, b) => a.localeCompare(b));
+	const result = aliases.filter(__assignType((alias) => alias.length === 1, [
+		"alias",
+		"",
+		"P\"2!\"/\""
+	]));
+	result.push(...aliases.filter(__assignType((alias) => alias.length > 1, [
+		"alias",
+		"",
+		"P\"2!\"/\""
+	])));
+	return result.sort(__assignType((a, b) => a.localeCompare(b), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	]));
 }
+sortArgAliases.__type = [
+	"aliases",
+	"sortArgAliases",
+	"P&F2!&F/\""
+];
 /**
 * Retrieves the application name from the context and configuration.
 *
@@ -28,6 +50,13 @@ function getAppName(context) {
 	if (!isSetString(result)) throw new Error("No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.");
 	return kebabCase(result);
 }
+getAppName.__type = [
+	"UnresolvedContext",
+	"Context",
+	"context",
+	"getAppName",
+	"PP\"w!\"w\"J2#&/$"
+];
 /**
 * Retrieves the application title from the context and configuration.
 *
@@ -39,6 +68,14 @@ function getAppTitle(context, replaceCLI = false) {
 	const title = context.config.title || titleCase(context.config.name || getAppName(context));
 	return (replaceCLI ? title.replace(/(?:cli|command-line|command line)\s*(?:interface\s*)?(?:application|app)?$/gi, "") : title).trim();
 }
+getAppTitle.__type = [
+	"UnresolvedContext",
+	"Context",
+	"context",
+	"replaceCLI",
+	"getAppTitle",
+	"PP\"w!\"w\"J2#\"2$&/%"
+];
 /**
 * Retrieves the application description from the context and configuration.
 *
@@ -48,6 +85,13 @@ function getAppTitle(context, replaceCLI = false) {
 function getAppDescription(context) {
 	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context, true)} command-line interface application.`;
 }
+getAppDescription.__type = [
+	"UnresolvedContext",
+	"Context",
+	"context",
+	"getAppDescription",
+	"PP\"w!\"w\"J2#&/$"
+];
 /**
 * Retrieves the primary binary name for the application.
 *
@@ -57,6 +101,12 @@ function getAppDescription(context) {
 function getAppBin(context) {
 	return isSetObject(context.config.bin) ? Object.keys(context.config.bin)[0] : kebabCase(getAppName(context));
 }
+getAppBin.__type = [
+	"Context",
+	"context",
+	"getAppBin",
+	"P\"w!2\"&/#"
+];
 /**
 * Determines if a given command path segment is variable (enclosed in square brackets).
 *
@@ -72,6 +122,11 @@ function getAppBin(context) {
 function isDynamicPathSegment(path) {
 	return path.startsWith("[") && path.endsWith("]");
 }
+isDynamicPathSegment.__type = [
+	"path",
+	"isDynamicPathSegment",
+	"P&2!)/\""
+];
 /**
 * Extracts the variable name from a command path segment by removing enclosing square brackets.
 *
@@ -86,6 +141,11 @@ function isDynamicPathSegment(path) {
 function getDynamicPathSegmentName(path) {
 	return path.replaceAll(/^\[+/g, "").replaceAll(/\]+$/g, "");
 }
+getDynamicPathSegmentName.__type = [
+	"path",
+	"getDynamicPathSegmentName",
+	"P&2!&/\""
+];
 /**
 * Determines if a given command path segment is a path segment group (enclosed in parentheses).
 *
@@ -102,6 +162,11 @@ function getDynamicPathSegmentName(path) {
 function isPathSegmentGroup(path) {
 	return path.startsWith("(") && path.endsWith(")") || path.startsWith("_");
 }
+isPathSegmentGroup.__type = [
+	"path",
+	"isPathSegmentGroup",
+	"P&2!)/\""
+];
 /**
 * Extracts the group name from a command path segment by removing enclosing parentheses.
 *
@@ -117,6 +182,11 @@ function isPathSegmentGroup(path) {
 function getPathSegmentGroupName(path) {
 	return path.replaceAll(/^\(+/g, "").replaceAll(/\)+$/g, "").replaceAll(/^_+/g, "");
 }
+getPathSegmentGroupName.__type = [
+	"path",
+	"getPathSegmentGroupName",
+	"P&2!&/\""
+];
 /**
 * Extracts the variable name from a command path segment by removing enclosing square brackets.
 *
@@ -131,6 +201,11 @@ function getPathSegmentGroupName(path) {
 function getPathSegmentName(path) {
 	return getPathSegmentGroupName(getDynamicPathSegmentName(path));
 }
+getPathSegmentName.__type = [
+	"path",
+	"getPathSegmentName",
+	"P&2!&/\""
+];
 
 //#endregion
 export { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases };

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","replaceCLI","title","replace","trim","getAppDescription","description","getAppBin","Object","keys","isDynamicPathSegment","path","startsWith","endsWith","getDynamicPathSegmentName","replaceAll","isPathSegmentGroup","getPathSegmentGroupName","getPathSegmentName"],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type { Context, UnresolvedContext } from \"../types\";\n\n/**\n * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.\n *\n * @param aliases - An array of argument aliases to sort.\n * @returns A new array of sorted aliases.\n */\nexport function sortArgAliases(aliases: string[]): string[] {\n  if (aliases.length === 0) {\n    return [];\n  }\n\n  const result = aliases.filter(alias => alias.length === 1);\n  result.push(...aliases.filter(alias => alias.length > 1));\n\n  return result.sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Retrieves the application name from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application name in kebab-case format.\n * @throws An error if no valid application name is found.\n */\nexport function getAppName(context: UnresolvedContext | Context): string {\n  const result =\n    context.config.name ||\n    (isSetString(context.config.bin) ||\n    (Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0 &&\n      isSetString(context.config.bin[0]))\n      ? isSetString(context.config.bin)\n        ? context.config.bin\n        : context.config.bin[0]\n      : context.packageJson?.name);\n  if (!isSetString(result)) {\n    throw new Error(\n      \"No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.\"\n    );\n  }\n\n  return kebabCase(result);\n}\n\n/**\n * Retrieves the application title from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(\n  context: UnresolvedContext | Context,\n  replaceCLI = false\n): string {\n  const title =\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context));\n\n  return (\n    replaceCLI\n      ? title.replace(\n          /(?:cli|command-line|command line)\\s*(?:interface\\s*)?(?:application|app)?$/gi,\n          \"\"\n        )\n      : title\n  ).trim();\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, true)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return (path.startsWith(\"(\") && path.endsWith(\")\")) || path.startsWith(\"_\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path\n    .replaceAll(/^\\(+/g, \"\")\n    .replaceAll(/\\)+$/g, \"\")\n    .replaceAll(/^_+/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,SAAgBI,eAAeC,SAA6B;AAC1D,KAAIA,QAAQC,WAAW,EACrB,QAAO,EAAE;CAGX,MAAMC,SAASF,QAAQG,QAAOC,UAASA,MAAMH,WAAW,EAAE;AAC1DC,QAAOG,KAAK,GAAGL,QAAQG,QAAOC,UAASA,MAAMH,SAAS,EAAE,CAAC;AAEzD,QAAOC,OAAOI,MAAMC,GAAGC,MAAMD,EAAEE,cAAcD,EAAE,CAAC;;;;;;;;;AAUlD,SAAgBE,WAAWC,SAA8C;CACvE,MAAMT,SACJS,QAAQC,OAAOC,SACdf,YAAYa,QAAQC,OAAOE,IAAI,IAC/BC,MAAMC,QAAQL,QAAQC,OAAOE,IAAI,IAChCH,QAAQC,OAAOE,IAAIb,SAAS,KAC5BH,YAAYa,QAAQC,OAAOE,IAAI,GAAI,GACjChB,YAAYa,QAAQC,OAAOE,IAAI,GAC7BH,QAAQC,OAAOE,MACfH,QAAQC,OAAOE,IAAI,KACrBH,QAAQM,aAAaJ;AAC3B,KAAI,CAACf,YAAYI,OAAO,CACtB,OAAM,IAAIgB,MACR,qIACD;AAGH,QAAOvB,UAAUO,OAAO;;;;;;;;;AAU1B,SAAgBiB,YACdR,SACAS,aAAa,OACL;CACR,MAAMC,QACJV,QAAQC,OAAOS,SACfzB,UAAUe,QAAQC,OAAOC,QAAQH,WAAWC,QAAQ,CAAC;AAEvD,SACES,aACIC,MAAMC,QACJ,gFACA,GACD,GACDD,OACJE,MAAM;;;;;;;;AASV,SAAgBC,kBACdb,SACQ;AACR,QACEA,QAAQC,OAAOa,eACfd,QAAQM,aAAaQ,eACrB,OAAON,YAAYR,SAAS,KAAK,CAAA;;;;;;;;AAUrC,SAAgBe,UAAUf,SAA0B;AAClD,QAAOd,YAAYc,QAAQC,OAAOE,IAAI,GAClCa,OAAOC,KAAKjB,QAAQC,OAAOE,IAAI,CAAC,KAChCnB,UAAUe,WAAWC,QAAQ,CAAC;;;;;;;;;;;;;;AAepC,SAAgBkB,qBAAqBC,MAAuB;AAC1D,QAAOA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI;;;;;;;;;;;;;AAcnD,SAAgBC,0BAA0BH,MAAsB;AAC9D,QAAOA,KAAKI,WAAW,SAAS,GAAG,CAACA,WAAW,SAAS,GAAG;;;;;;;;;;;;;;;AAgB7D,SAAgBC,mBAAmBL,MAAuB;AACxD,QAAQA,KAAKC,WAAW,IAAI,IAAID,KAAKE,SAAS,IAAI,IAAKF,KAAKC,WAAW,IAAI;;;;;;;;;;;;;;AAe7E,SAAgBK,wBAAwBN,MAAsB;AAC5D,QAAOA,KACJI,WAAW,SAAS,GAAG,CACvBA,WAAW,SAAS,GAAG,CACvBA,WAAW,QAAQ,GAAG;;;;;;;;;;;;;AAc3B,SAAgBG,mBAAmBP,MAAsB;AACvD,QAAOM,wBAAwBH,0BAA0BH,KAAK,CAAC"}
+{"version":3,"file":"context-helpers.mjs","names":[],"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 * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(\n  context: UnresolvedContext | Context,\n  replaceCLI = false\n): string {\n  const title =\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context));\n\n  return (\n    replaceCLI\n      ? title.replace(\n          /(?:cli|command-line|command line)\\s*(?:interface\\s*)?(?:application|app)?$/gi,\n          \"\"\n        )\n      : title\n  ).trim();\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, true)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return (path.startsWith(\"(\") && path.endsWith(\")\")) || path.startsWith(\"_\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path\n    .replaceAll(/^\\(+/g, \"\")\n    .replaceAll(/\\)+$/g, \"\")\n    .replaceAll(/^_+/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\n}\n"],"mappings":";;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA6BX,SAAgB,eAAY,SAAA;AACxB,KAAI,QAAK,WAAA,EACX,QAAA,EAAA;CAEE,MAAM,SAAS,QAAQ,OAAO,cAAa,UAAS,MAAI,WAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;AACxD,QAAO,KAAK,GAAG,QAAQ,OAAO,cAAa,UAAS,MAAG,SAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;;;;;;;AAG3D,eAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQA,SAAE,WAAA,SAAA;CACE,MAAM,SAAS,QAAQ,OAAO,SACzB,YAAM,QAAA,OAAA,IAAA,IACF,MAAM,QAAM,QAAA,OAAA,IAAA,IACT,QAAQ,OAAO,IAAI,SAAG,KACtB,YAAY,QAAQ,OAAI,IAAA,GAAA,GAC1B,YAAY,QAAQ,OAAG,IAAA,GACnB,QAAQ,OAAO,MACf,QAAQ,OAAO,IAAI,KACvB,QAAQ,aAAK;AACvB,KAAI,CAAC,YAAY,OAAO,CACpB,OAAM,IAAI,MAAM,qIAAU;AAE9B,QAAO,UAAQ,OAAA;;AAEnB,WAAK,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQL,SAAC,YAAA,SAAA,aAAA,OAAA;CACG,MAAM,QAAQ,QAAQ,OAAO,SACzB,UAAU,QAAQ,OAAO,QAAQ,WAAW,QAAQ,CAAC;AACzD,SAAQ,aACV,MAAA,QAAA,gFAAA,GAAA,GACQ,OAAO,MAAM;;AAEvB,YAAY,SAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOnB,SAAa,kBAAA,SAAA;AACT,QAAQ,QAAQ,OAAC,eACb,QAAQ,aAAa,eACrB,OAAG,YAAA,SAAA,KAAA,CAAA;;AAEX,kBAAY,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOZ,SAAgB,UAAU,SAAS;AAC/B,QAAO,YAAY,QAAQ,OAAO,IAAC,GACrC,OAAA,KAAA,QAAA,OAAA,IAAA,CAAA,KACQ,UAAU,WAAW,QAAE,CAAA;;AAEjC,UAAU,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;AAaV,SAAE,qBAAA,MAAA;AACE,QAAO,KAAK,WAAW,IAAI,IAAI,KAAK,SAAS,IAAG;;AAEpD,qBAAqB,SAAS;CAAC;CAAQ;CAAC;CAAA;;;;;;;;;;;;AAYxC,SAAC,0BAAA,MAAA;AACG,QAAO,KAAK,WAAW,SAAS,GAAG,CAAC,WAAU,SAAA,GAAA;;AAElD,0BAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAcF,SAAgB,mBAAmB,MAAM;AACvC,QAAA,KAAA,WAAA,IAAA,IAAA,KAAA,SAAA,IAAA,IAAA,KAAA,WAAA,IAAA;;AAEF,mBAAmB,SAAS;CAAC;CAAQ;CAAsB;CAAE;;;;;;;;;;;;;AAa7D,SAAgB,wBAAwB,MAAM;AAC1C,QAAO,KACT,WAAA,SAAA,GAAA,CACO,WAAW,SAAS,GAAG,CACvB,WAAW,QAAQ,GAAG;;;;;;;;;;;;;;;;;;AAc/B,SAAE,mBAAA,MAAA;AACE,QAAO,wBAAwB,0BAA0B,KAAC,CAAA;;AAE9D,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA"}

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

@@ -1,6 +1,10 @@
 const require_plugin_utils_context_helpers = require('./context-helpers.cjs');
 
 //#region src/plugin-utils/get-command-tree.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Retrieves a specific command tree based on the provided path.
 *
@@ -12,12 +16,24 @@ 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.isDynamicPathSegment(segment));
+		const segments = path.slice(1).filter(__assignType((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment), [
+			"segment",
+			"",
+			"P\"2!\"/\""
+		]));
 		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
 		else return null;
 	}
 	return currentTree;
 }
+getCommandTree.__type = [
+	"Context",
+	"context",
+	"path",
+	"CommandTree",
+	"getCommandTree",
+	"P\"w!2\"\"2#P\"w$,J/%"
+];
 
 //#endregion
 exports.getCommandTree = getCommandTree;

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.cjs","names":["isDynamicPathSegment","getCommandTree","context","path","length","currentTree","commands","segments","slice","filter","segment","children","Object","prototype","hasOwnProperty","call"],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n"],"mappings":";;;;;;;;;;AA6BA,SAAgBC,eACdC,SACAC,OAAO,EAAc,EACD;AACpB,KAAIA,KAAKC,WAAW,EAClB,QAAO;CAGT,IAAIC,cAAkCH,QAAQI,SAASH,KAAK,OAAQ;AACpE,KAAIA,KAAKC,SAAS,GAAG;EACnB,MAAMG,WAAWJ,KACdK,MAAM,EAAE,CACRC,QAAOC,YAAW,CAACV,0DAAqBU,QAAQ,CAAC;AACpD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}
+{"version":3,"file":"get-command-tree.cjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;AAUX,SAAgB,eAAe,SAAS,OAAO,EAAE,EAAE;uBAE3C,QAAO;CAEX,IAAI,cAAc,QAAQ,SAAS,KAAK,OAAO;;EAE3C,MAAM,WAAW,KACZ,MAAM,EAAE,CACR,OAAO,cAAa,YAAW,CAAC,0DAAW,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAEtD,KAAA,aAAA,YACc,OAAO,UAAU,eAAe,KAAK,YAAU,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAInB,QAAO;;AAEX,eAAe,SAAS;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

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

@@ -1,6 +1,10 @@
 import { isDynamicPathSegment } from "./context-helpers.mjs";
 
 //#region src/plugin-utils/get-command-tree.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Retrieves a specific command tree based on the provided path.
 *
@@ -12,12 +16,24 @@ 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) => !isDynamicPathSegment(segment));
+		const segments = path.slice(1).filter(__assignType((segment) => !isDynamicPathSegment(segment), [
+			"segment",
+			"",
+			"P\"2!\"/\""
+		]));
 		for (const segment of segments) if (currentTree?.children && Object.prototype.hasOwnProperty.call(currentTree.children, segment)) currentTree = currentTree.children[segment] ?? null;
 		else return null;
 	}
 	return currentTree;
 }
+getCommandTree.__type = [
+	"Context",
+	"context",
+	"path",
+	"CommandTree",
+	"getCommandTree",
+	"P\"w!2\"\"2#P\"w$,J/%"
+];
 
 //#endregion
 export { getCommandTree };

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.mjs","names":["isDynamicPathSegment","getCommandTree","context","path","length","currentTree","commands","segments","slice","filter","segment","children","Object","prototype","hasOwnProperty","call"],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n"],"mappings":";;;;;;;;;;AA6BA,SAAgBC,eACdC,SACAC,OAAO,EAAc,EACD;AACpB,KAAIA,KAAKC,WAAW,EAClB,QAAO;CAGT,IAAIC,cAAkCH,QAAQI,SAASH,KAAK,OAAQ;AACpE,KAAIA,KAAKC,SAAS,GAAG;EACnB,MAAMG,WAAWJ,KACdK,MAAM,EAAE,CACRC,QAAOC,YAAW,CAACV,qBAAqBU,QAAQ,CAAC;AACpD,OAAK,MAAMA,WAAWH,SACpB,KACEF,aAAaM,YACbC,OAAOC,UAAUC,eAAeC,KAAKV,YAAYM,UAAUD,QAAQ,CAEnEL,eAAcA,YAAYM,SAASD,YAAY;MAE/C,QAAO;;AAKb,QAAOL"}
+{"version":3,"file":"get-command-tree.mjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;AAUX,SAAgB,eAAe,SAAS,OAAO,EAAE,EAAE;uBAE3C,QAAO;CAEX,IAAI,cAAc,QAAQ,SAAS,KAAK,OAAO;;EAE3C,MAAM,WAAW,KACZ,MAAM,EAAE,CACR,OAAO,cAAa,YAAW,CAAC,qBAAW,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAEtD,KAAA,aAAA,YACc,OAAO,UAAU,eAAe,KAAK,YAAU,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAInB,QAAO;;AAEX,eAAe,SAAS;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/reflect.cjs

@@ -2,6 +2,10 @@ const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 
 //#region src/plugin-utils/reflect.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Sort command options alphabetically by name, placing boolean options with negatives appropriately.
 *
@@ -10,15 +14,39 @@ let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type"
 */
 function sortOptions(options) {
 	if (!options || options.length === 0) return [];
-	return options.filter((arg) => arg.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean || !arg.isNegativeOf).sort((a, b) => a.name.localeCompare(b.name)).reduce((ret, arg) => {
+	return options.filter(__assignType((arg) => arg.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean || !arg.isNegativeOf, [
+		"arg",
+		"",
+		"P\"2!\"/\""
+	])).sort(__assignType((a, b) => a.name.localeCompare(b.name), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	])).reduce(__assignType((ret, arg) => {
 		ret.push(arg);
 		if (arg.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean) {
-			const negativeArg = options.find((a) => a.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean && a.isNegativeOf === arg.name);
+			const negativeArg = options.find(__assignType((a) => a.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean && a.isNegativeOf === arg.name, [
+				"a",
+				"",
+				"P\"2!\"/\""
+			]));
 			if (negativeArg) ret.push(negativeArg);
 		}
 		return ret;
-	}, []);
+	}, [
+		"ret",
+		"arg",
+		"",
+		"P\"2!\"2\"\"/#"
+	]), []);
 }
+sortOptions.__type = [
+	"CommandOption",
+	"options",
+	"sortOptions",
+	"P\"w!F2\"\"w!F/#"
+];
 
 //#endregion
 exports.sortOptions = sortOptions;

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

@@ -1 +1 @@
-{"version":3,"file":"reflect.cjs","names":["ReflectionKind","sortOptions","options","length","filter","arg","kind","boolean","isNegativeOf","sort","a","b","name","localeCompare","reduce","ret","push","negativeArg","find"],"sources":["../../src/plugin-utils/reflect.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandOption } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(arg => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf)\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === ReflectionKind.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;;;;;;;;AA2BA,SAAgBC,YAAYC,SAA2C;AACrE,KAAI,CAACA,WAAWA,QAAQC,WAAW,EACjC,QAAO,EAAE;AAGX,QAAOD,QACJE,QAAOC,QAAOA,IAAIC,SAASN,gDAAeO,WAAW,CAACF,IAAIG,aAAa,CACvEC,MAAMC,GAAGC,MAAMD,EAAEE,KAAKC,cAAcF,EAAEC,KAAK,CAAC,CAC5CE,QAAQC,KAAKV,QAAQ;AACpBU,MAAIC,KAAKX,IAAI;AAEb,MAAIA,IAAIC,SAASN,gDAAeO,SAAS;GAEvC,MAAMU,cAAcf,QAAQgB,MAC1BR,MAAKA,EAAEJ,SAASN,gDAAeO,WAAWG,EAAEF,iBAAiBH,IAAIO,KAClE;AACD,OAAIK,YACFF,KAAIC,KAAKC,YAAY;;AAIzB,SAAOF;IACN,EAAqB,CAAC"}
+{"version":3,"file":"reflect.cjs","names":[],"sources":["../../src/plugin-utils/reflect.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandOption } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(arg => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf)\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === ReflectionKind.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA0BX,SAAgB,YAAY,SAAS;AACjC,KAAI,CAAC,WAAI,QAAA,WAAA,EACX,QAAA,EAAA;AAEE,QAAO,QACF,OAAO,cAAa,QAAO,IAAI,SAAS,gDAAe,WAAW,CAAA,IAAA,cAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAClE,KAAK,cAAc,GAAG,MAAM,EAAE,KAAK,cAAI,EAAA,KAAA,EAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CACvC,OAAO,cAAU,KAAA,QAAA;AAClB,MAAI,KAAK,IAAE;;GAGP,MAAM,cAAc,QAAQ,KAAK,cAAG,MAAA,EAAA,SAAA,gDAAA,WAAA,EAAA,iBAAA,IAAA,MAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;AACpC,OAAI,YACA,KAAI,KAAK,YAAY;;AAG7B,SAAO;IACR;EAAC;EAAA;EAAA;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA"}