@shell-shock/core 0.17.10 → 0.17.11

package/dist/plugin-utils/compute-bin.mjs

@@ -1,6 +1,5 @@
 import { getAppDescription, getAppName, getAppTitle } from "./context-helpers.mjs";
 import { joinPaths } from "@stryke/path/join-paths";
-import { computed } from "@alloy-js/core";
 
 //#region src/plugin-utils/compute-bin.ts
 function __assignType(fn, args) {
@@ -8,23 +7,22 @@ function __assignType(fn, args) {
 	return fn;
 }
 /**
-* Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.
+* Computes the command tree for the root binary command based on the provided context.
 *
 * @param context - The plugin context containing the necessary information to compute the command tree.
-* @returns The computed command tree for the CLI application, starting from the root bin command. This will include all commands discovered in the project and their respective details, organized in a hierarchical structure based on their segments and paths.
+* @returns The computed command tree for the root binary command.
 */
 function computeBin(context) {
-	return computed(() => ({
+	return {
 		id: "",
 		name: getAppName(context),
 		title: getAppTitle(context),
 		description: getAppDescription(context),
-		isVirtual: true,
+		virtual: true,
 		path: null,
 		segments: [],
 		alias: [],
 		tags: [],
-		source: "file",
 		options: Object.fromEntries(context.globalOptions.map(__assignType((option) => [option.name, option], [
 			"option",
 			"",
@@ -34,14 +32,14 @@ function computeBin(context) {
 		entry: { file: joinPaths(context.entryPath, "bin.ts") },
 		parent: null,
 		children: context.commands
-	})).value;
+	};
 }
 computeBin.__type = [
 	"Context",
 	"context",
 	"CommandTree",
 	"computeBin",
-	"Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.",
+	"Computes the command tree for the root binary command based on the provided context.",
 	"P\"w!2\"\"w#/$?%"
 ];
 

package/dist/plugin-utils/compute-bin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"compute-bin.mjs","names":[],"sources":["../../src/plugin-utils/compute-bin.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 { computed } from \"@alloy-js/core\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport type { CommandTree, Context } from \"../types\";\nimport { getAppDescription, getAppName, getAppTitle } from \"./context-helpers\";\n\n/**\n * Compute the command tree for the CLI application, starting from the root bin command. This will be used to determine which commands are available in the CLI application and their respective details.\n *\n * @param context - The plugin context containing the necessary information to compute the command tree.\n * @returns The computed command tree for the CLI application, starting from the root bin command. This will include all commands discovered in the project and their respective details, organized in a hierarchical structure based on their segments and paths.\n */\nexport function computeBin(context: Context): CommandTree {\n  const bin = computed(() => ({\n    id: \"\",\n    name: getAppName(context),\n    title: getAppTitle(context),\n    description: getAppDescription(context),\n    isVirtual: true,\n    path: null,\n    segments: [],\n    alias: [],\n    tags: [],\n    source: \"file\",\n    options: Object.fromEntries(\n      context.globalOptions.map(option => [option.name, option])\n    ),\n    args: [],\n    entry: {\n      file: joinPaths(context.entryPath, \"bin.ts\")\n    },\n    parent: null,\n    children: context.commands\n  }));\n\n  return bin.value;\n}\n"],"mappings":";;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE9B,QAAO;;;;;;;;AA4BT,SAAc,WAAa,SAAG;AAoB5B,QAnBQ,gBAAA;EACN,IAAI;EACJ,MAAM,WAAC,QAAY;EACnB,OAAA,YAAa,QAAA;EACb,aAAW,kBAAI,QAAA;EACf,WAAU;EACV,MAAA;EACA,UAAS,EAAA;EACT,OAAO,EAAC;EACR,MAAM,EAAE;EACR,QAAQ;EACR,SAAS,OAAC,YAAkB,QAAQ,cAAc,IAAE,cAAO,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,CAAA;EAC3D,MAAC,EAAA;EACD,OAAO,EACP,MAAO,UAAA,QAAA,WAAA,SAAA,EACN;EACD,QAAC;EACD,UAAQ,QAAI;EACb,EACE,CAAA;;AAEL,WAAS,SAAS;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"compute-bin.mjs","names":[],"sources":[],"mappings":""}

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

@@ -1,8 +1,7 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
-let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 
 //#region src/plugin-utils/context-helpers.ts
 function __assignType(fn, args) {
@@ -53,12 +52,10 @@ function getAppName(context) {
 	return (0, _stryke_string_format_kebab_case.kebabCase)(result);
 }
 getAppName.__type = [
-	"UnresolvedContext",
-	"Context",
 	"context",
 	"getAppName",
 	"Retrieves the application name from the context and configuration.",
-	"PP\"w!\"w\"J2#&/$?%"
+	"P\"2!&/\"?#"
 ];
 /**
 * Retrieves the application title from the context and configuration.
@@ -72,13 +69,11 @@ function getAppTitle(context, replaceCLI = false) {
 	return (replaceCLI ? title.replace(/(?:cli|command-line|command line)\s*(?:interface\s*)?(?:application|app)?$/gi, "") : title).trim();
 }
 getAppTitle.__type = [
-	"UnresolvedContext",
-	"Context",
 	"context",
 	"replaceCLI",
 	"getAppTitle",
 	"Retrieves the application title from the context and configuration.",
-	"PP\"w!\"w\"J2#\"2$&/%?&"
+	"P\"2!\"2\"&/#?$"
 ];
 /**
 * Retrieves the application description from the context and configuration.
@@ -90,12 +85,10 @@ function getAppDescription(context) {
 	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context, true)} command-line interface application.`;
 }
 getAppDescription.__type = [
-	"UnresolvedContext",
-	"Context",
 	"context",
 	"getAppDescription",
 	"Retrieves the application description from the context and configuration.",
-	"PP\"w!\"w\"J2#&/$?%"
+	"P\"2!&/\"?#"
 ];
 /**
 * Retrieves the primary binary name for the application.
@@ -107,11 +100,10 @@ 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",
 	"Retrieves the primary binary name for the application.",
-	"P\"w!2\"&/#?$"
+	"P\"2!&/\"?#"
 ];
 /**
 * Determines if a given command path segment is variable (enclosed in square brackets).
@@ -228,4 +220,5 @@ exports.getPathSegmentGroupName = getPathSegmentGroupName;
 exports.getPathSegmentName = getPathSegmentName;
 exports.isDynamicPathSegment = isDynamicPathSegment;
 exports.isPathSegmentGroup = isPathSegmentGroup;
-exports.sortArgAliases = sortArgAliases;
+exports.sortArgAliases = sortArgAliases;
+//# sourceMappingURL=context-helpers.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.cjs","names":[],"sources":[],"mappings":""}

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

@@ -14,7 +14,7 @@ declare function sortArgAliases(aliases: string[]): string[];
  * @returns The application name in kebab-case format.
  * @throws An error if no valid application name is found.
  */
-declare function getAppName(context: UnresolvedContext | Context): string;
+declare function getAppName<TContext extends UnresolvedContext | Context>(context: TContext): string;
 /**
  * Retrieves the application title from the context and configuration.
  *
@@ -22,21 +22,21 @@ declare function getAppName(context: UnresolvedContext | Context): string;
  * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.
  * @returns The application title in title-case format.
  */
-declare function getAppTitle(context: UnresolvedContext | Context, replaceCLI?: boolean): string;
+declare function getAppTitle<TContext extends UnresolvedContext | Context>(context: TContext, replaceCLI?: boolean): string;
 /**
  * Retrieves the application description from the context and configuration.
  *
  * @param context - The build context containing workspace and package information.
  * @returns The application description.
  */
-declare function getAppDescription(context: UnresolvedContext | Context): string;
+declare function getAppDescription<TContext extends UnresolvedContext | Context>(context: TContext): string;
 /**
  * Retrieves the primary binary name for the application.
  *
  * @param context - The build context containing workspace and package information.
  * @returns The primary binary name as a string.
  */
-declare function getAppBin(context: Context): string;
+declare function getAppBin<TContext extends UnresolvedContext | Context>(context: TContext): string;
 /**
  * Determines if a given command path segment is variable (enclosed in square brackets).
  *

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"],"mappings":";;;;;AA8BA;;;iBAAgB,cAAA,CAAe,OAAA;;AAkB/B;;;;;;iBAAgB,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA;;;AA2BxD;;;;;iBAAgB,WAAA,CACd,OAAA,EAAS,iBAAA,GAAoB,OAAA,EAC7B,UAAA;;;;;AAsBF;;iBAAgB,iBAAA,CACd,OAAA,EAAS,iBAAA,GAAoB,OAAA;;;;;;;iBAef,SAAA,CAAU,OAAA,EAAS,OAAA;;;;;AAkBnC;;;;;AAeA;;;iBAfgB,oBAAA,CAAqB,IAAA;;AAgCrC;;;;;AAgBA;;;;;iBAjCgB,yBAAA,CAA0B,IAAA;;;;;;;;;;;;;;iBAiB1B,kBAAA,CAAmB,IAAA;;;;;;;;;;;;;iBAgBnB,uBAAA,CAAwB,IAAA;;;;;;;;;;;;iBAkBxB,kBAAA,CAAmB,IAAA"}
+{"version":3,"file":"context-helpers.d.cts","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"mappings":";;;;;AA8BA;;;iBAAgB,cAAA,CAAe,OAAiB;AAAA;AAkBhD;;;;;;AAlBgD,iBAkBhC,UAAA,kBAA4B,iBAAA,GAAoB,OAAA,EAC9D,OAAA,EAAS,QAAA;;;;;;;;iBA4BK,WAAA,kBAA6B,iBAAA,GAAoB,OAAA,EAC/D,OAAA,EAAS,QAAA,EACT,UAAA;AAFF;;;;;;AAAA,iBAwBgB,iBAAA,kBAAmC,iBAAA,GAAoB,OAAA,EACrE,OAAA,EAAS,QAAA;;;;;;;iBAeK,SAAA,kBAA2B,iBAAA,GAAoB,OAAA,EAC7D,OAAA,EAAS,QAAA;;AAvCS;AAsBpB;;;;;;;;;;iBAoCgB,oBAAA,CAAqB,IAAY;;;;AAnC9B;AAenB;;;;;;;iBAmCgB,yBAAA,CAA0B,IAAY;;;;;;;AAlCnC;AAmBnB;;;;AAAiD;AAejD;iBAiBgB,kBAAA,CAAmB,IAAY;;;AAjBO;AAiBtD;;;;AAA+C;AAgB/C;;;;iBAAgB,uBAAA,CAAwB,IAAY;AAkBpD;;;;AAA+C;;;;;;;AAA/C,iBAAgB,kBAAA,CAAmB,IAAY"}

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

@@ -14,7 +14,7 @@ declare function sortArgAliases(aliases: string[]): string[];
  * @returns The application name in kebab-case format.
  * @throws An error if no valid application name is found.
  */
-declare function getAppName(context: UnresolvedContext | Context): string;
+declare function getAppName<TContext extends UnresolvedContext | Context>(context: TContext): string;
 /**
  * Retrieves the application title from the context and configuration.
  *
@@ -22,21 +22,21 @@ declare function getAppName(context: UnresolvedContext | Context): string;
  * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.
  * @returns The application title in title-case format.
  */
-declare function getAppTitle(context: UnresolvedContext | Context, replaceCLI?: boolean): string;
+declare function getAppTitle<TContext extends UnresolvedContext | Context>(context: TContext, replaceCLI?: boolean): string;
 /**
  * Retrieves the application description from the context and configuration.
  *
  * @param context - The build context containing workspace and package information.
  * @returns The application description.
  */
-declare function getAppDescription(context: UnresolvedContext | Context): string;
+declare function getAppDescription<TContext extends UnresolvedContext | Context>(context: TContext): string;
 /**
  * Retrieves the primary binary name for the application.
  *
  * @param context - The build context containing workspace and package information.
  * @returns The primary binary name as a string.
  */
-declare function getAppBin(context: Context): string;
+declare function getAppBin<TContext extends UnresolvedContext | Context>(context: TContext): string;
 /**
  * Determines if a given command path segment is variable (enclosed in square brackets).
  *

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"],"mappings":";;;;;AA8BA;;;iBAAgB,cAAA,CAAe,OAAA;;AAkB/B;;;;;;iBAAgB,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA;;;AA2BxD;;;;;iBAAgB,WAAA,CACd,OAAA,EAAS,iBAAA,GAAoB,OAAA,EAC7B,UAAA;;;;;AAsBF;;iBAAgB,iBAAA,CACd,OAAA,EAAS,iBAAA,GAAoB,OAAA;;;;;;;iBAef,SAAA,CAAU,OAAA,EAAS,OAAA;;;;;AAkBnC;;;;;AAeA;;;iBAfgB,oBAAA,CAAqB,IAAA;;AAgCrC;;;;;AAgBA;;;;;iBAjCgB,yBAAA,CAA0B,IAAA;;;;;;;;;;;;;;iBAiB1B,kBAAA,CAAmB,IAAA;;;;;;;;;;;;;iBAgBnB,uBAAA,CAAwB,IAAA;;;;;;;;;;;;iBAkBxB,kBAAA,CAAmB,IAAA"}
+{"version":3,"file":"context-helpers.d.mts","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"mappings":""}

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

@@ -1,7 +1,7 @@
 import { kebabCase } from "@stryke/string-format/kebab-case";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { titleCase } from "@stryke/string-format/title-case";
-import { isSetObject } from "@stryke/type-checks/is-set-object";
 
 //#region src/plugin-utils/context-helpers.ts
 function __assignType(fn, args) {
@@ -52,12 +52,10 @@ function getAppName(context) {
 	return kebabCase(result);
 }
 getAppName.__type = [
-	"UnresolvedContext",
-	"Context",
 	"context",
 	"getAppName",
 	"Retrieves the application name from the context and configuration.",
-	"PP\"w!\"w\"J2#&/$?%"
+	"P\"2!&/\"?#"
 ];
 /**
 * Retrieves the application title from the context and configuration.
@@ -71,13 +69,11 @@ function getAppTitle(context, replaceCLI = false) {
 	return (replaceCLI ? title.replace(/(?:cli|command-line|command line)\s*(?:interface\s*)?(?:application|app)?$/gi, "") : title).trim();
 }
 getAppTitle.__type = [
-	"UnresolvedContext",
-	"Context",
 	"context",
 	"replaceCLI",
 	"getAppTitle",
 	"Retrieves the application title from the context and configuration.",
-	"PP\"w!\"w\"J2#\"2$&/%?&"
+	"P\"2!\"2\"&/#?$"
 ];
 /**
 * Retrieves the application description from the context and configuration.
@@ -89,12 +85,10 @@ function getAppDescription(context) {
 	return context.config.description || context.packageJson?.description || `The ${getAppTitle(context, true)} command-line interface application.`;
 }
 getAppDescription.__type = [
-	"UnresolvedContext",
-	"Context",
 	"context",
 	"getAppDescription",
 	"Retrieves the application description from the context and configuration.",
-	"PP\"w!\"w\"J2#&/$?%"
+	"P\"2!&/\"?#"
 ];
 /**
 * Retrieves the primary binary name for the application.
@@ -106,11 +100,10 @@ function getAppBin(context) {
 	return isSetObject(context.config.bin) ? Object.keys(context.config.bin)[0] : kebabCase(getAppName(context));
 }
 getAppBin.__type = [
-	"Context",
 	"context",
 	"getAppBin",
 	"Retrieves the primary binary name for the application.",
-	"P\"w!2\"&/#?$"
+	"P\"2!&/\"?#"
 ];
 /**
 * Determines if a given command path segment is variable (enclosed in square brackets).

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

@@ -1 +1 @@
-{"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;;AAE9B,QAAO;;;;;;;;AA6BT,SAAc,eAAc,SAAA;AAC1B,KAAE,QAAS,WAAA,EACX,QAAA,EAAA;CAEA,MAAM,SAAS,QAAQ,OAAO,cAAS,UAAa,MAAM,WAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;AAC1D,QAAO,KAAK,GAAG,QAAQ,OAAO,cAAS,UAAa,MAAK,SAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;;;;;;;AAG3D,eAAA,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQA,SAAE,WAAA,SAAA;CACF,MAAO,SAAS,QAAA,OAAW,SAAS,YAAiB,QAAG,OAAU,IAAM,IAAC,MAAA,QAAA,QAAA,OAAA,IAAA,IAAA,QAAA,OAAA,IAAA,SAAA,KAAA,YAAA,QAAA,OAAA,IAAA,GAAA,GAAA,YAAA,QAAA,OAAA,IAAA,GAAA,QAAA,OAAA,MAAA,QAAA,OAAA,IAAA,KAAA,QAAA,aAAA;AACvE,KAAA,CAAK,YAAQ,OAAA,CACX,OAAA,IAAQ,MAAO,qIAAM;AAEvB,QAAG,UAAc,OAAO;;AAE1B,WAAM,SAAY;CAAA;CAAsB;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQxC,SAAK,YAAA,SAAA,aAAA,OAAA;CACH,MAAA,QAAA,QAAA,OAAA,SAAA,UAAA,QAAA,OAAA,QAAA,WAAA,QAAA,CAAA;;;AAGF,YAAA,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOA,SAAgB,kBAAkB,SAAS;AACzC,QAAA,QAAA,OAAA,eAAA,QAAA,aAAA,eAAA,OAAA,YAAA,SAAA,KAAA,CAAA;;AAEF,kBAAW,SAAA;CAAiB;CAAU;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOtC,SAAS,UAAA,SAAA;AACP,QAAE,YAAA,QAAA,OAAA,IAAA,GAAA,OAAA,KAAA,QAAA,OAAA,IAAA,CAAA,KAAA,UAAA,WAAA,QAAA,CAAA;;AAEJ,UAAU,SAAQ;CAAA;CAAa;CAAQ;CAAW;CAAsC;CAAA;;;;;;;;;;;;;AAaxF,SAAgB,qBAAiB,MAAA;AAC/B,QAAO,KAAE,WAAA,IAAkB,IAAE,KAAA,SAAA,IAAA;;AAE/B,qBAAS,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;AAYT,SAAE,0BAAA,MAAA;AACF,QAAO,KAAA,WAAkB,SAAS,GAAC,CAAA,WAAU,SAAO,GAAA;;AAEpD,0BAA0B,SAAO;CAAG;CAAI;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAcxC,SAAgB,mBAAgB,MAAS;AACvC,QAAA,KAAA,WAAA,IAAA,IAAA,KAAA,SAAA,IAAA,IAAA,KAAA,WAAA,IAAA;;AAEF,mBAAc,SAAc;CAAC;CAAQ;CAAc;CAAA;CAAA;;;;;;;;;;;;;AAanD,SAAE,wBAAA,MAAA;AACF,QAAO,KAAA,WAAS,SAAA,GAAA,CAAA,WAAgC,SAAS,GAAA,CAAA,WAAO,QAAA,GAAA;;AAEhE,wBAAA,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;AAYA,SAAgB,mBAAkB,MAAO;AACvC,QAAE,wBAA6B,0BAA0B,KAAC,CAAA;;AAE5D,mBAAgB,SAAA;CAAA;CAAmB;CAAuB;CAAA;CAAA"}
+{"version":3,"file":"context-helpers.mjs","names":[],"sources":[],"mappings":""}

package/dist/plugin-utils/deepkit.cjs

@@ -1,34 +1,32 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_types_command = require('../types/command.cjs');
 const require_type_checks = require('./type-checks.cjs');
-let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 
 //#region src/plugin-utils/deepkit.ts
 /**
-* Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
+* Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
 *
 * @param command - The command parameter or kind to extract the reflection kind from.
 * @param checkVariadic - Whether to check for variadic parameters (arrays).
 * @returns The extracted {@link ReflectionKind}.
 */
 function extractReflectionKind(command, checkVariadic = true) {
-	if (require_type_checks.isCommandParameterKind(command) && command === require_types_command.CommandParameterKinds.string || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.kind === require_types_command.CommandParameterKinds.string) return checkVariadic && command.variadic ? _powerlines_deepkit_vendor_type.ReflectionKind.array : _powerlines_deepkit_vendor_type.ReflectionKind.string;
-	else if (require_type_checks.isCommandParameterKind(command) && command === require_types_command.CommandParameterKinds.number || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.kind === require_types_command.CommandParameterKinds.number) return checkVariadic && command.variadic ? _powerlines_deepkit_vendor_type.ReflectionKind.array : _powerlines_deepkit_vendor_type.ReflectionKind.number;
-	else if (require_type_checks.isCommandParameterKind(command) && command === require_types_command.CommandParameterKinds.boolean || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.kind === require_types_command.CommandParameterKinds.boolean) return _powerlines_deepkit_vendor_type.ReflectionKind.boolean;
+	if (require_type_checks.isCommandParameterType(command) && command === "string" || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.type === "string") return checkVariadic && command.variadic ? _powerlines_deepkit_vendor_type.ReflectionKind.array : _powerlines_deepkit_vendor_type.ReflectionKind.string;
+	else if (require_type_checks.isCommandParameterType(command) && command === "number" || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.type === "number") return checkVariadic && command.variadic ? _powerlines_deepkit_vendor_type.ReflectionKind.array : _powerlines_deepkit_vendor_type.ReflectionKind.number;
+	else if (require_type_checks.isCommandParameterType(command) && command === "boolean" || (0, _stryke_type_checks_is_set_object.isSetObject)(command) && command.type === "boolean") return _powerlines_deepkit_vendor_type.ReflectionKind.boolean;
 	else return _powerlines_deepkit_vendor_type.ReflectionKind.string;
 }
 extractReflectionKind.__type = [
 	"BaseCommandParameter",
-	"CommandParameterKind",
+	"CommandParameterType",
 	"command",
 	"checkVariadic",
 	"extractReflectionKind",
-	"Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.",
+	"Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterType}.",
 	"PP\"w!\"w\"J2#\"2$!/%?&"
 ];
 /**
-* Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
+* Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
 *
 * @param command - The command parameter or kind to extract the type from.
 * @param checkVariadic - Whether to check for variadic parameters (arrays).
@@ -39,15 +37,15 @@ function extractType(command, checkVariadic = true) {
 	if (reflectionKind === _powerlines_deepkit_vendor_type.ReflectionKind.string) return { kind: _powerlines_deepkit_vendor_type.ReflectionKind.string };
 	else if (reflectionKind === _powerlines_deepkit_vendor_type.ReflectionKind.number) return { kind: _powerlines_deepkit_vendor_type.ReflectionKind.number };
 	else if (reflectionKind === _powerlines_deepkit_vendor_type.ReflectionKind.boolean) return { kind: _powerlines_deepkit_vendor_type.ReflectionKind.boolean };
-	else if (reflectionKind === _powerlines_deepkit_vendor_type.ReflectionKind.array) if (require_type_checks.isCommandParameterKind(command)) return {
+	else if (reflectionKind === _powerlines_deepkit_vendor_type.ReflectionKind.array) if (require_type_checks.isCommandParameterType(command)) return {
 		kind: _powerlines_deepkit_vendor_type.ReflectionKind.array,
-		type: extractType({ kind: command }, false)
+		type: extractType({ type: command }, false)
 	};
 	else if ((0, _stryke_type_checks_is_set_object.isSetObject)(command)) return {
 		kind: _powerlines_deepkit_vendor_type.ReflectionKind.array,
 		type: extractType({
 			...command,
-			kind: command.kind
+			type: command.type
 		}, false)
 	};
 	else return {
@@ -58,14 +56,15 @@ function extractType(command, checkVariadic = true) {
 }
 extractType.__type = [
 	"BaseCommandParameter",
-	"CommandParameterKind",
+	"CommandParameterType",
 	"command",
 	"checkVariadic",
 	"extractType",
-	"Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.",
+	"Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterType}.",
 	"PP\"w!\"w\"J2#\"2$!/%?&"
 ];
 
 //#endregion
 exports.extractReflectionKind = extractReflectionKind;
-exports.extractType = extractType;
+exports.extractType = extractType;
+//# sourceMappingURL=deepkit.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deepkit.cjs","names":[],"sources":[],"mappings":""}

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

@@ -1,23 +1,23 @@
-import { BaseCommandParameter, CommandParameterKind } from "../types/command.cjs";
+import { BaseCommandParameter, CommandParameterType } from "../types/command.cjs";
 import { ReflectionKind, Type } from "@powerlines/deepkit/vendor/type";
 
 //#region src/plugin-utils/deepkit.d.ts
 /**
- * Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
+ * Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
  *
  * @param command - The command parameter or kind to extract the reflection kind from.
  * @param checkVariadic - Whether to check for variadic parameters (arrays).
  * @returns The extracted {@link ReflectionKind}.
  */
-declare function extractReflectionKind(command: BaseCommandParameter | CommandParameterKind, checkVariadic?: boolean): ReflectionKind;
+declare function extractReflectionKind(command: BaseCommandParameter | CommandParameterType, checkVariadic?: boolean): ReflectionKind;
 /**
- * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
+ * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
  *
  * @param command - The command parameter or kind to extract the type from.
  * @param checkVariadic - Whether to check for variadic parameters (arrays).
  * @returns The extracted {@link Type}.
  */
-declare function extractType(command: BaseCommandParameter | CommandParameterKind, checkVariadic?: boolean): Type;
+declare function extractType(command: BaseCommandParameter | CommandParameterType, checkVariadic?: boolean): Type;
 //#endregion
 export { extractReflectionKind, extractType };
 //# sourceMappingURL=deepkit.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deepkit.d.cts","names":[],"sources":["../../src/plugin-utils/deepkit.ts"],"mappings":";;;;;AAoCA;;;;;;iBAAgB,qBAAA,CACd,OAAA,EAAS,oBAAA,GAAuB,oBAAA,EAChC,aAAA,aACC,cAAA;;;;;;;;iBAqCa,WAAA,CACd,OAAA,EAAS,oBAAA,GAAuB,oBAAA,EAChC,aAAA,aACC,IAAA"}
+{"version":3,"file":"deepkit.d.cts","names":[],"sources":["../../src/plugin-utils/deepkit.ts"],"mappings":";;;;;AAmCA;;;;;;iBAAgB,qBAAA,CACd,OAAA,EAAS,oBAAA,GAAuB,oBAAA,EAChC,aAAA,aACC,cAAA;;;;;;;;iBAgCa,WAAA,CACd,OAAA,EAAS,oBAAA,GAAuB,oBAAA,EAChC,aAAA,aACC,IAAA"}

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

@@ -1,23 +1,23 @@
-import { BaseCommandParameter, CommandParameterKind } from "../types/command.mjs";
+import { BaseCommandParameter, CommandParameterType } from "../types/command.mjs";
 import { ReflectionKind, Type } from "@powerlines/deepkit/vendor/type";
 
 //#region src/plugin-utils/deepkit.d.ts
 /**
- * Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
+ * Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
  *
  * @param command - The command parameter or kind to extract the reflection kind from.
  * @param checkVariadic - Whether to check for variadic parameters (arrays).
  * @returns The extracted {@link ReflectionKind}.
  */
-declare function extractReflectionKind(command: BaseCommandParameter | CommandParameterKind, checkVariadic?: boolean): ReflectionKind;
+declare function extractReflectionKind(command: BaseCommandParameter | CommandParameterType, checkVariadic?: boolean): ReflectionKind;
 /**
- * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
+ * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
  *
  * @param command - The command parameter or kind to extract the type from.
  * @param checkVariadic - Whether to check for variadic parameters (arrays).
  * @returns The extracted {@link Type}.
  */
-declare function extractType(command: BaseCommandParameter | CommandParameterKind, checkVariadic?: boolean): Type;
+declare function extractType(command: BaseCommandParameter | CommandParameterType, checkVariadic?: boolean): Type;
 //#endregion
 export { extractReflectionKind, extractType };
 //# sourceMappingURL=deepkit.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deepkit.d.mts","names":[],"sources":["../../src/plugin-utils/deepkit.ts"],"mappings":";;;;;AAoCA;;;;;;iBAAgB,qBAAA,CACd,OAAA,EAAS,oBAAA,GAAuB,oBAAA,EAChC,aAAA,aACC,cAAA;;;;;;;;iBAqCa,WAAA,CACd,OAAA,EAAS,oBAAA,GAAuB,oBAAA,EAChC,aAAA,aACC,IAAA"}
+{"version":3,"file":"deepkit.d.mts","names":[],"sources":["../../src/plugin-utils/deepkit.ts"],"mappings":""}

package/dist/plugin-utils/deepkit.mjs

@@ -1,33 +1,32 @@
-import { CommandParameterKinds } from "../types/command.mjs";
-import { isCommandParameterKind } from "./type-checks.mjs";
-import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { isCommandParameterType } from "./type-checks.mjs";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 
 //#region src/plugin-utils/deepkit.ts
 /**
-* Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
+* Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
 *
 * @param command - The command parameter or kind to extract the reflection kind from.
 * @param checkVariadic - Whether to check for variadic parameters (arrays).
 * @returns The extracted {@link ReflectionKind}.
 */
 function extractReflectionKind(command, checkVariadic = true) {
-	if (isCommandParameterKind(command) && command === CommandParameterKinds.string || isSetObject(command) && command.kind === CommandParameterKinds.string) return checkVariadic && command.variadic ? ReflectionKind.array : ReflectionKind.string;
-	else if (isCommandParameterKind(command) && command === CommandParameterKinds.number || isSetObject(command) && command.kind === CommandParameterKinds.number) return checkVariadic && command.variadic ? ReflectionKind.array : ReflectionKind.number;
-	else if (isCommandParameterKind(command) && command === CommandParameterKinds.boolean || isSetObject(command) && command.kind === CommandParameterKinds.boolean) return ReflectionKind.boolean;
+	if (isCommandParameterType(command) && command === "string" || isSetObject(command) && command.type === "string") return checkVariadic && command.variadic ? ReflectionKind.array : ReflectionKind.string;
+	else if (isCommandParameterType(command) && command === "number" || isSetObject(command) && command.type === "number") return checkVariadic && command.variadic ? ReflectionKind.array : ReflectionKind.number;
+	else if (isCommandParameterType(command) && command === "boolean" || isSetObject(command) && command.type === "boolean") return ReflectionKind.boolean;
 	else return ReflectionKind.string;
 }
 extractReflectionKind.__type = [
 	"BaseCommandParameter",
-	"CommandParameterKind",
+	"CommandParameterType",
 	"command",
 	"checkVariadic",
 	"extractReflectionKind",
-	"Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.",
+	"Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterType}.",
 	"PP\"w!\"w\"J2#\"2$!/%?&"
 ];
 /**
-* Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
+* Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterType}.
 *
 * @param command - The command parameter or kind to extract the type from.
 * @param checkVariadic - Whether to check for variadic parameters (arrays).
@@ -38,15 +37,15 @@ function extractType(command, checkVariadic = true) {
 	if (reflectionKind === ReflectionKind.string) return { kind: ReflectionKind.string };
 	else if (reflectionKind === ReflectionKind.number) return { kind: ReflectionKind.number };
 	else if (reflectionKind === ReflectionKind.boolean) return { kind: ReflectionKind.boolean };
-	else if (reflectionKind === ReflectionKind.array) if (isCommandParameterKind(command)) return {
+	else if (reflectionKind === ReflectionKind.array) if (isCommandParameterType(command)) return {
 		kind: ReflectionKind.array,
-		type: extractType({ kind: command }, false)
+		type: extractType({ type: command }, false)
 	};
 	else if (isSetObject(command)) return {
 		kind: ReflectionKind.array,
 		type: extractType({
 			...command,
-			kind: command.kind
+			type: command.type
 		}, false)
 	};
 	else return {
@@ -57,11 +56,11 @@ function extractType(command, checkVariadic = true) {
 }
 extractType.__type = [
 	"BaseCommandParameter",
-	"CommandParameterKind",
+	"CommandParameterType",
 	"command",
 	"checkVariadic",
 	"extractType",
-	"Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.",
+	"Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterType}.",
 	"PP\"w!\"w\"J2#\"2$!/%?&"
 ];
 

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

@@ -1 +1 @@
-{"version":3,"file":"deepkit.mjs","names":[],"sources":["../../src/plugin-utils/deepkit.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 { Type } from \"@powerlines/deepkit/vendor/type\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  BaseCommandParameter,\n  CommandParameterKind,\n  StringCommandParameter\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport { isCommandParameterKind } from \"./type-checks\";\n\n/**\n * Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.\n *\n * @param command - The command parameter or kind to extract the reflection kind from.\n * @param checkVariadic - Whether to check for variadic parameters (arrays).\n * @returns The extracted {@link ReflectionKind}.\n */\nexport function extractReflectionKind(\n  command: BaseCommandParameter | CommandParameterKind,\n  checkVariadic = true\n): ReflectionKind {\n  if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.string) ||\n    (isSetObject(command as BaseCommandParameter) &&\n      (command as BaseCommandParameter).kind === CommandParameterKinds.string)\n  ) {\n    return checkVariadic && (command as StringCommandParameter).variadic\n      ? ReflectionKind.array\n      : ReflectionKind.string;\n  } else if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.number) ||\n    (isSetObject(command as BaseCommandParameter) &&\n      (command as BaseCommandParameter).kind === CommandParameterKinds.number)\n  ) {\n    return checkVariadic && (command as any).variadic\n      ? ReflectionKind.array\n      : ReflectionKind.number;\n  } else if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.boolean) ||\n    (isSetObject(command) && command.kind === CommandParameterKinds.boolean)\n  ) {\n    return ReflectionKind.boolean;\n  } else {\n    return ReflectionKind.string;\n  }\n}\n\n/**\n * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.\n *\n * @param command - The command parameter or kind to extract the type from.\n * @param checkVariadic - Whether to check for variadic parameters (arrays).\n * @returns The extracted {@link Type}.\n */\nexport function extractType(\n  command: BaseCommandParameter | CommandParameterKind,\n  checkVariadic = true\n): Type {\n  const reflectionKind = extractReflectionKind(command, checkVariadic);\n  if (reflectionKind === ReflectionKind.string) {\n    return { kind: ReflectionKind.string };\n  } else if (reflectionKind === ReflectionKind.number) {\n    return { kind: ReflectionKind.number };\n  } else if (reflectionKind === ReflectionKind.boolean) {\n    return { kind: ReflectionKind.boolean };\n  } else if (reflectionKind === ReflectionKind.array) {\n    if (isCommandParameterKind(command)) {\n      return {\n        kind: ReflectionKind.array,\n        type: extractType(\n          {\n            kind: command\n          } as BaseCommandParameter,\n          false\n        )\n      };\n    } else if (isSetObject(command)) {\n      return {\n        kind: ReflectionKind.array,\n        type: extractType(\n          {\n            ...command,\n            kind: command.kind\n          } as BaseCommandParameter,\n          false\n        )\n      };\n    } else {\n      return {\n        kind: ReflectionKind.array,\n        type: { kind: ReflectionKind.string }\n      };\n    }\n  } else {\n    return { kind: ReflectionKind.string };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AA6BE,KAAA,uBAAA,QAAA,IAAA,YAAA,sBAAA,UAAA,YAAA,QAAA,IAAA,QAAA,SAAA,sBAAA,OACC,QAAQ,iBAAU,QAAe,WAAU,eAAK,QAAA,eAAgC;UAClF,uBAAA,QAAA,IAAA,YAAA,sBAAA,UAAA,YAAA,QAAA,IAAA,QAAA,SAAA,sBAAA,OACG,QAAM,iBAAc,QAAQ,WAAa,eAAgB,QAAI,eAAoB;UAC3E,uBAA0B,QAAO,IAAI,YAAS,sBAAmB,WAAA,YAAA,QAAA,IAAA,QAAA,SAAA,sBAAA,QACvE,QAAO,eAAe;KAE1B,QAAO,eAAS;;AAGhB,sBAAkB,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQlB,SAAQ,YAAe,SAAA,gBAAA,MAAA;CACrB,MAAM,iBAAe,sBAAM,SAAA,cAAA;AAC3B,KAAE,mBAAQ,eAAA,OACR,QAAC,EACC,MAAA,eAAY,QACb;UACE,mBAAW,eAA6B,OAC3C,QAAA,EACA,MAAO,eAAgB,QACtB;UACG,mBAAqB,eAAA,QACzB,QAAO,EACN,MAAA,eAAsB,SACtB;UACA,mBAAwB,eAAiB,MAC1C,KAAA,uBAAA,QAAA,CACA,QAAO;EACH,MAAC,eAAA;EACL,MAAO,YAAe,EACxB,MAAA,SACF,EAAA,MAAA;;UAEE,YAAA,QAAA,CACC,QAAU;EACZ,MAAA,eAAA;EACG,MAAM,YAAc;GACd,GAAA;GACN,MAAY,QAAA;GACd,EAAA,MAAA;EACK;KAEL,QAAA;EACM,MAAA,eAAA;EACA,MAAA,EACF,MAAA,eAAmB,QACrB;EACA;KAGA,QAAO,EACP,MAAQ,eAAe,QACvB;;AAGJ,YAAY,SAAE;CAAA;CAAW;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"deepkit.mjs","names":[],"sources":[],"mappings":""}

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

@@ -108,4 +108,5 @@ formatShortDescription.__type = [
 exports.__ΩFormatDescriptionOptions = __ΩFormatDescriptionOptions;
 exports.__ΩFormatShortDescriptionOptions = __ΩFormatShortDescriptionOptions;
 exports.formatDescription = formatDescription;
-exports.formatShortDescription = formatShortDescription;
+exports.formatShortDescription = formatShortDescription;
+//# sourceMappingURL=description-helpers.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"description-helpers.cjs","names":[],"sources":[],"mappings":""}

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

@@ -1 +1 @@
-{"version":3,"file":"description-helpers.d.cts","names":[],"sources":["../../src/plugin-utils/description-helpers.ts"],"mappings":";UAkBiB,wBAAA;EAAA;;;;;EAMf,eAAA;EA4D+B;;;;;EArD/B,kBAAA;AAAA;;AA8DF;;;;;AAgBA;;;iBAzBgB,iBAAA,CACd,WAAA,UACA,OAAA,GAAS,wBAAA;AAAA,UAOM,6BAAA,SAAsC,wBAAA;EAkB5C;;;;;EAZT,MAAA;AAAA;;;;;;;;iBAUc,sBAAA,CACd,WAAA,UACA,OAAA,GAAS,6BAAA"}
+{"version":3,"file":"description-helpers.d.cts","names":[],"sources":["../../src/plugin-utils/description-helpers.ts"],"mappings":";UAkBiB,wBAAA;EAAA;;;;AAaG;EAPlB,eAAA;EA4D+B;;;;;EArD/B,kBAAkB;AAAA;AAuDoB;AAOxC;;;;AAMQ;AAUR;;;AAvBwC,iBAFxB,iBAAA,CACd,WAAA,UACA,OAAA,GAAS,wBAA6B;AAAA,UAOvB,6BAAA,SAAsC,wBAAwB;EAkBpE;;;AAAkC;;EAZ3C,MAAM;AAAA;;;;;;;;iBAUQ,sBAAA,CACd,WAAA,UACA,OAAA,GAAS,6BAAkC"}

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

@@ -1 +1 @@
-{"version":3,"file":"description-helpers.d.mts","names":[],"sources":["../../src/plugin-utils/description-helpers.ts"],"mappings":";UAkBiB,wBAAA;EAAA;;;;;EAMf,eAAA;EA4D+B;;;;;EArD/B,kBAAA;AAAA;;AA8DF;;;;;AAgBA;;;iBAzBgB,iBAAA,CACd,WAAA,UACA,OAAA,GAAS,wBAAA;AAAA,UAOM,6BAAA,SAAsC,wBAAA;EAkB5C;;;;;EAZT,MAAA;AAAA;;;;;;;;iBAUc,sBAAA,CACd,WAAA,UACA,OAAA,GAAS,6BAAA"}
+{"version":3,"file":"description-helpers.d.mts","names":[],"sources":["../../src/plugin-utils/description-helpers.ts"],"mappings":""}

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

@@ -1 +1 @@
-{"version":3,"file":"description-helpers.mjs","names":[],"sources":["../../src/plugin-utils/description-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\nexport interface FormatDescriptionOptions {\n  /**\n   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.\n   *\n   * @defaultValue false\n   */\n  replaceNewlines?: boolean;\n\n  /**\n   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.\n   *\n   * @defaultValue false\n   */\n  collapseWhitespace?: boolean;\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionWhitespace(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  let formattedDescription = description.trim();\n  if (options.replaceNewlines) {\n    formattedDescription = formattedDescription.replace(/\\s*\\n\\s*/g, \" \");\n  }\n  if (options.collapseWhitespace) {\n    formattedDescription = formattedDescription.replace(/\\s{2,}/g, \" \");\n  }\n\n  return formattedDescription.trim();\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionEscapes(description: string): string {\n  return description\n    .replaceAll(\"'\", \"\\\\'\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"`\", \"\\\\`\")\n    .replace(/\\$\\{/g, \"\\\\${\");\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nexport function formatDescription(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  return formatDescriptionEscapes(\n    formatDescriptionWhitespace(description, options)\n  );\n}\n\nexport interface FormatShortDescriptionOptions extends FormatDescriptionOptions {\n  /**\n   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.\n   *\n   * @defaultValue 62\n   */\n  length?: number;\n}\n\n/**\n * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.\n *\n * @param description - The full description string.\n * @param options - Options for formatting the short description, including the maximum length.\n * @returns The extracted short description.\n */\nexport function formatShortDescription(\n  description: string,\n  options: FormatShortDescriptionOptions = {}\n): string {\n  const length = options.length ?? 62;\n  const formattedDescription = formatDescriptionWhitespace(\n    description,\n    options\n  );\n\n  const firstSentenceMatch =\n    formattedDescription.indexOf(\"\\n\") < length - 3 ||\n    formattedDescription.search(/[.!?\\n]\\s*\\S/) > length - 3\n      ? formattedDescription\n          .match(/^.*[.!?\\n]\\s?\\S/)?.[0]\n          ?.trim()\n          ?.slice(0, -1)\n          ?.trim()\n      : undefined;\n\n  let result = (firstSentenceMatch || formattedDescription).trim();\n  if (result.trim().length > length) {\n    result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;\n  }\n\n  return formatDescriptionEscapes(result);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA4BA,SAAG,4BAAA,aAAA,UAAA,EAAA,EAAA;CACD,IAAI,uBAAa,YAAA,MAAA;AACjB,KAAE,QAAA,gBACF,wBAAqB,qBAAO,QAAA,aAAA,IAAA;gCAG5B,wBAAA,qBAAA,QAAA,WAAA,IAAA;AAED,QAAA,qBAAA,MAAA;;AAED,4BAAsB,SAAc;CAAA;OAAiB;CAAgC;QAAqB,EAAE;CAAC;CAAa;CAAA;CAAA;;;;;;;;;;AAU1H,SAAM,yBAAyB,aAAA;AAC7B,QAAE,YAAA,WAAuB,KAAA,MAAA,CAAA,WAA4B,MAAK,OAAM,CAAC,WAAM,KAAA,MAAA,CAAA,QAAA,SAAA,OAAA;;AAEzE,yBAAc,SAAoB;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;AAUlC,SAAI,kBAAA,aAAA,UAAA,EAAA,EAAA;AACF,QAAM,yBAAuB,4BAA8B,aAAS,QAAU,CAAI;;AAEpF,kBAAU,SAAiB;CAAC;OAAiB;CAAM;QAAA,EAAA;CAAA;CAAA;CAAA;CAAA;AACnD,MAAI,mCAAkC;OAAM;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;CAU1C,MAAA,SAAA,QAAA,UAAA;CACA,MAAC,uBAA4B,4BAAyB,aAAU,QAAc;CAE9E,IAAE,WADH,qBAAA,QAAA,KAAA,GAAA,SAAA,KAAA,qBAAA,OAAA,eAAA,GAAA,SAAA,IAAA,qBAAA,MAAA,kBAAA,GAAA,IAAA,MAAA,EAAA,MAAA,GAAA,GAAA,EAAA,MAAA,GAAA,WACG,sBAAA,MAAA;AACF,KAAC,OAAQ,MAAO,CAAA,SAAI,OACrB,UAAA,GAAA,OAAA,UAAA,GAAA,KAAA,IAAA,GAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA;AAEC,QAAE,yBAAsB,OAAY;;AAEtC,uBAAgB,SAAA;CAAiB;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"description-helpers.mjs","names":[],"sources":[],"mappings":""}

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

@@ -114,4 +114,5 @@ getCommandSegments.__type = [
 exports.getCommandList = getCommandList;
 exports.getCommandPaths = getCommandPaths;
 exports.getCommandSegments = getCommandSegments;
-exports.getCommandTree = getCommandTree;
+exports.getCommandTree = getCommandTree;
+//# sourceMappingURL=get-command-tree.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-command-tree.cjs","names":[],"sources":[],"mappings":""}

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

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.d.cts","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"mappings":";;;;;;AA8BA;;;;;iBAAgB,cAAA,CACd,OAAA,EAAS,OAAA,EACT,IAAA,cACC,WAAA;;;;;AA+BH;;iBAAsB,cAAA,CAAe,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,WAAA;;;;;;;iBAe1C,eAAA,CAAgB,OAAA,EAAS,OAAA,GAAU,OAAA;;;;;AAAzD;;iBAiBsB,kBAAA,CACpB,OAAA,EAAS,OAAA,GACR,OAAA"}
+{"version":3,"file":"get-command-tree.d.cts","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"mappings":";;;;;;AA8BA;;;;;iBAAgB,cAAA,CACd,OAAA,EAAS,OAAA,EACT,IAAA,cACC,WAAW;;;;AAAA;AA+Bd;;iBAAsB,cAAA,CAAe,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,WAAA;;;;;;;iBAe1C,eAAA,CAAgB,OAAA,EAAS,OAAA,GAAU,OAAO;;;;AAfW;AAe3E;;iBAiBsB,kBAAA,CACpB,OAAA,EAAS,OAAA,GACR,OAAO"}