@shell-shock/core 0.17.8 → 0.17.10

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

@@ -1,2 +1,50 @@
-import{getAppDescription as e,getAppName as t,getAppTitle as n}from"./context-helpers.mjs";import{joinPaths as r}from"@stryke/path/join-paths";import{computed as i}from"@alloy-js/core";function a(e,t){return e.__type=t,e}function o(o){return i(()=>({id:``,name:t(o),title:n(o),description:e(o),isVirtual:!0,path:null,segments:[],alias:[],tags:[],source:`file`,options:Object.fromEntries(o.globalOptions.map(a(e=>[e.name,e],[`option`,``,`P"2!"/"`]))),args:[],entry:{file:r(o.entryPath,`bin.ts`)},parent:null,children:o.commands})).value}o.__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.`,`P"w!2""w#/$?%`];export{o as computeBin};
+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) {
+	fn.__type = 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.
+*
+* @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.
+*/
+function computeBin(context) {
+	return computed(() => ({
+		id: "",
+		name: getAppName(context),
+		title: getAppTitle(context),
+		description: getAppDescription(context),
+		isVirtual: true,
+		path: null,
+		segments: [],
+		alias: [],
+		tags: [],
+		source: "file",
+		options: Object.fromEntries(context.globalOptions.map(__assignType((option) => [option.name, option], [
+			"option",
+			"",
+			"P\"2!\"/\""
+		]))),
+		args: [],
+		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.",
+	"P\"w!2\"\"w#/$?%"
+];
+
+//#endregion
+export { computeBin };
 //# sourceMappingURL=compute-bin.mjs.map

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":"yLAAA,SAAS,EAAa,EAAI,EAAM,CAE9B,kBAAO,EA4BT,SAAc,EAAa,EAAG,CAoB5B,OAnBQ,OAAA,CACN,GAAI,GACJ,KAAM,EAAC,EAAY,CACnB,MAAA,EAAa,EAAA,CACb,YAAW,EAAI,EAAA,CACf,UAAU,GACV,KAAA,KACA,SAAS,EAAA,CACT,MAAO,EAAC,CACR,KAAM,EAAE,CACR,OAAQ,OACR,QAAS,OAAC,YAAkB,EAAQ,cAAc,IAAE,EAAO,GAAA,CAAA,EAAA,KAAA,EAAA,CAAA,CAAA,SAAA,GAAA,UAAA,CAAA,CAAA,CAAA,CAC3D,KAAC,EAAA,CACD,MAAO,CACP,KAAO,EAAA,EAAA,UAAA,SAAA,CACN,CACD,OAAC,KACD,SAAQ,EAAI,SACb,EACE,CAAA,MAEL,EAAS,OAAS,CAAA,UAAA,UAAA,cAAA,aAAA,yMAAA,gBAAA"}
+{"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"}

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

@@ -1 +1,231 @@
-require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`@stryke/string-format/kebab-case`),t=require(`@stryke/type-checks/is-set-string`),n=require(`@stryke/string-format/title-case`),r=require(`@stryke/type-checks/is-set-object`);function i(e,t){return e.__type=t,e}function a(e){if(e.length===0)return[];let t=e.filter(i(e=>e.length===1,[`alias`,``,`P"2!"/"`]));return t.push(...e.filter(i(e=>e.length>1,[`alias`,``,`P"2!"/"`]))),t.sort(i((e,t)=>e.localeCompare(t),[`a`,`b`,``,`P"2!"2""/#`]))}a.__type=[`aliases`,`sortArgAliases`,`Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.`,`P&F2!&F/"?#`];function o(n){let r=n.config.name||((0,t.isSetString)(n.config.bin)||Array.isArray(n.config.bin)&&n.config.bin.length>0&&(0,t.isSetString)(n.config.bin[0])?(0,t.isSetString)(n.config.bin)?n.config.bin:n.config.bin[0]:n.packageJson?.name);if(!(0,t.isSetString)(r))throw 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,e.kebabCase)(r)}o.__type=[`UnresolvedContext`,`Context`,`context`,`getAppName`,`Retrieves the application name from the context and configuration.`,`PP"w!"w"J2#&/$?%`];function s(e,t=!1){let r=e.config.title||(0,n.titleCase)(e.config.name||o(e));return(t?r.replace(/(?:cli|command-line|command line)\s*(?:interface\s*)?(?:application|app)?$/gi,``):r).trim()}s.__type=[`UnresolvedContext`,`Context`,`context`,`replaceCLI`,`getAppTitle`,`Retrieves the application title from the context and configuration.`,`PP"w!"w"J2#"2$&/%?&`];function c(e){return e.config.description||e.packageJson?.description||`The ${s(e,!0)} command-line interface application.`}c.__type=[`UnresolvedContext`,`Context`,`context`,`getAppDescription`,`Retrieves the application description from the context and configuration.`,`PP"w!"w"J2#&/$?%`];function l(t){return(0,r.isSetObject)(t.config.bin)?Object.keys(t.config.bin)[0]:(0,e.kebabCase)(o(t))}l.__type=[`Context`,`context`,`getAppBin`,`Retrieves the primary binary name for the application.`,`P"w!2"&/#?$`];function u(e){return e.startsWith(`[`)&&e.endsWith(`]`)}u.__type=[`path`,`isDynamicPathSegment`,`Determines if a given command path segment is variable (enclosed in square brackets).`,`P&2!)/"?#`];function d(e){return e.replaceAll(/^\[+/g,``).replaceAll(/\]+$/g,``)}d.__type=[`path`,`getDynamicPathSegmentName`,`Extracts the variable name from a command path segment by removing enclosing square brackets.`,`P&2!&/"?#`];function f(e){return e.startsWith(`(`)&&e.endsWith(`)`)||e.startsWith(`_`)}f.__type=[`path`,`isPathSegmentGroup`,`Determines if a given command path segment is a path segment group (enclosed in parentheses).`,`P&2!)/"?#`];function p(e){return e.replaceAll(/^\(+/g,``).replaceAll(/\)+$/g,``).replaceAll(/^_+/g,``)}p.__type=[`path`,`getPathSegmentGroupName`,`Extracts the group name from a command path segment by removing enclosing parentheses.`,`P&2!&/"?#`];function m(e){return p(d(e))}m.__type=[`path`,`getPathSegmentName`,`Extracts the variable name from a command path segment by removing enclosing square brackets.`,`P&2!&/"?#`],exports.getAppBin=l,exports.getAppDescription=c,exports.getAppName=o,exports.getAppTitle=s,exports.getDynamicPathSegmentName=d,exports.getPathSegmentGroupName=p,exports.getPathSegmentName=m,exports.isDynamicPathSegment=u,exports.isPathSegmentGroup=f,exports.sortArgAliases=a;
+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_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) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
+*
+* @param aliases - An array of argument aliases to sort.
+* @returns A new array of sorted aliases.
+*/
+function sortArgAliases(aliases) {
+	if (aliases.length === 0) return [];
+	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",
+	"Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.",
+	"P&F2!&F/\"?#"
+];
+/**
+* Retrieves the application name from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application name in kebab-case format.
+* @throws An error if no valid application name is found.
+*/
+function getAppName(context) {
+	const result = context.config.name || ((0, _stryke_type_checks_is_set_string.isSetString)(context.config.bin) || Array.isArray(context.config.bin) && context.config.bin.length > 0 && (0, _stryke_type_checks_is_set_string.isSetString)(context.config.bin[0]) ? (0, _stryke_type_checks_is_set_string.isSetString)(context.config.bin) ? context.config.bin : context.config.bin[0] : context.packageJson?.name);
+	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",
+	"Retrieves the application name from the context and configuration.",
+	"PP\"w!\"w\"J2#&/$?%"
+];
+/**
+* Retrieves the application title from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.
+* @returns The application title in title-case format.
+*/
+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",
+	"Retrieves the application title from the context and configuration.",
+	"PP\"w!\"w\"J2#\"2$&/%?&"
+];
+/**
+* Retrieves the application description from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application description.
+*/
+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#&/$?%"
+];
+/**
+* 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.
+*/
+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\"&/#?$"
+];
+/**
+* Determines if a given command path segment is variable (enclosed in square brackets).
+*
+* @example
+* ```typescript
+* isDynamicPathSegment("[user]"); // true
+* isDynamicPathSegment("user"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is variable, false otherwise.
+*/
+function isDynamicPathSegment(path) {
+	return path.startsWith("[") && path.endsWith("]");
+}
+isDynamicPathSegment.__type = [
+	"path",
+	"isDynamicPathSegment",
+	"Determines if a given command path segment is variable (enclosed in square brackets).",
+	"P&2!)/\"?#"
+];
+/**
+* Extracts the variable name from a command path segment by removing enclosing square brackets.
+*
+* @example
+* ```typescript
+* getDynamicPathSegmentName("[user]"); // "user"
+* ```
+*
+* @param path - The command path segment.
+* @returns The variable name without square brackets.
+*/
+function getDynamicPathSegmentName(path) {
+	return path.replaceAll(/^\[+/g, "").replaceAll(/\]+$/g, "");
+}
+getDynamicPathSegmentName.__type = [
+	"path",
+	"getDynamicPathSegmentName",
+	"Extracts the variable name from a command path segment by removing enclosing square brackets.",
+	"P&2!&/\"?#"
+];
+/**
+* Determines if a given command path segment is a path segment group (enclosed in parentheses).
+*
+* @example
+* ```typescript
+* isPathSegmentGroup("(user)"); // true
+* isPathSegmentGroup("[user]"); // false
+* isPathSegmentGroup("user"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is a path segment group, false otherwise.
+*/
+function isPathSegmentGroup(path) {
+	return path.startsWith("(") && path.endsWith(")") || path.startsWith("_");
+}
+isPathSegmentGroup.__type = [
+	"path",
+	"isPathSegmentGroup",
+	"Determines if a given command path segment is a path segment group (enclosed in parentheses).",
+	"P&2!)/\"?#"
+];
+/**
+* Extracts the group name from a command path segment by removing enclosing parentheses.
+*
+* @example
+* ```typescript
+* getPathSegmentGroupName("(admin)"); // "admin"
+* getPathSegmentGroupName("((group))"); // "group"
+* ```
+*
+* @param path - The command path segment.
+* @returns The group name without parentheses.
+*/
+function getPathSegmentGroupName(path) {
+	return path.replaceAll(/^\(+/g, "").replaceAll(/\)+$/g, "").replaceAll(/^_+/g, "");
+}
+getPathSegmentGroupName.__type = [
+	"path",
+	"getPathSegmentGroupName",
+	"Extracts the group name from a command path segment by removing enclosing parentheses.",
+	"P&2!&/\"?#"
+];
+/**
+* Extracts the variable name from a command path segment by removing enclosing square brackets.
+*
+* @example
+* ```typescript
+* getDynamicPathSegmentName("[user]"); // "user"
+* ```
+*
+* @param path - The command path segment.
+* @returns The variable name without square brackets.
+*/
+function getPathSegmentName(path) {
+	return getPathSegmentGroupName(getDynamicPathSegmentName(path));
+}
+getPathSegmentName.__type = [
+	"path",
+	"getPathSegmentName",
+	"Extracts the variable name from a command path segment by removing enclosing square brackets.",
+	"P&2!&/\"?#"
+];
+
+//#endregion
+exports.getAppBin = getAppBin;
+exports.getAppDescription = getAppDescription;
+exports.getAppName = getAppName;
+exports.getAppTitle = getAppTitle;
+exports.getDynamicPathSegmentName = getDynamicPathSegmentName;
+exports.getPathSegmentGroupName = getPathSegmentGroupName;
+exports.getPathSegmentName = getPathSegmentName;
+exports.isDynamicPathSegment = isDynamicPathSegment;
+exports.isPathSegmentGroup = isPathSegmentGroup;
+exports.sortArgAliases = sortArgAliases;

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

@@ -1,2 +1,222 @@
-import{kebabCase as e}from"@stryke/string-format/kebab-case";import{isSetString as t}from"@stryke/type-checks/is-set-string";import{titleCase as n}from"@stryke/string-format/title-case";import{isSetObject as r}from"@stryke/type-checks/is-set-object";function i(e,t){return e.__type=t,e}function a(e){if(e.length===0)return[];let t=e.filter(i(e=>e.length===1,[`alias`,``,`P"2!"/"`]));return t.push(...e.filter(i(e=>e.length>1,[`alias`,``,`P"2!"/"`]))),t.sort(i((e,t)=>e.localeCompare(t),[`a`,`b`,``,`P"2!"2""/#`]))}a.__type=[`aliases`,`sortArgAliases`,`Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.`,`P&F2!&F/"?#`];function o(n){let r=n.config.name||(t(n.config.bin)||Array.isArray(n.config.bin)&&n.config.bin.length>0&&t(n.config.bin[0])?t(n.config.bin)?n.config.bin:n.config.bin[0]:n.packageJson?.name);if(!t(r))throw Error(`No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.`);return e(r)}o.__type=[`UnresolvedContext`,`Context`,`context`,`getAppName`,`Retrieves the application name from the context and configuration.`,`PP"w!"w"J2#&/$?%`];function s(e,t=!1){let r=e.config.title||n(e.config.name||o(e));return(t?r.replace(/(?:cli|command-line|command line)\s*(?:interface\s*)?(?:application|app)?$/gi,``):r).trim()}s.__type=[`UnresolvedContext`,`Context`,`context`,`replaceCLI`,`getAppTitle`,`Retrieves the application title from the context and configuration.`,`PP"w!"w"J2#"2$&/%?&`];function c(e){return e.config.description||e.packageJson?.description||`The ${s(e,!0)} command-line interface application.`}c.__type=[`UnresolvedContext`,`Context`,`context`,`getAppDescription`,`Retrieves the application description from the context and configuration.`,`PP"w!"w"J2#&/$?%`];function l(t){return r(t.config.bin)?Object.keys(t.config.bin)[0]:e(o(t))}l.__type=[`Context`,`context`,`getAppBin`,`Retrieves the primary binary name for the application.`,`P"w!2"&/#?$`];function u(e){return e.startsWith(`[`)&&e.endsWith(`]`)}u.__type=[`path`,`isDynamicPathSegment`,`Determines if a given command path segment is variable (enclosed in square brackets).`,`P&2!)/"?#`];function d(e){return e.replaceAll(/^\[+/g,``).replaceAll(/\]+$/g,``)}d.__type=[`path`,`getDynamicPathSegmentName`,`Extracts the variable name from a command path segment by removing enclosing square brackets.`,`P&2!&/"?#`];function f(e){return e.startsWith(`(`)&&e.endsWith(`)`)||e.startsWith(`_`)}f.__type=[`path`,`isPathSegmentGroup`,`Determines if a given command path segment is a path segment group (enclosed in parentheses).`,`P&2!)/"?#`];function p(e){return e.replaceAll(/^\(+/g,``).replaceAll(/\)+$/g,``).replaceAll(/^_+/g,``)}p.__type=[`path`,`getPathSegmentGroupName`,`Extracts the group name from a command path segment by removing enclosing parentheses.`,`P&2!&/"?#`];function m(e){return p(d(e))}m.__type=[`path`,`getPathSegmentName`,`Extracts the variable name from a command path segment by removing enclosing square brackets.`,`P&2!&/"?#`];export{l as getAppBin,c as getAppDescription,o as getAppName,s as getAppTitle,d as getDynamicPathSegmentName,p as getPathSegmentGroupName,m as getPathSegmentName,u as isDynamicPathSegment,f as isPathSegmentGroup,a as sortArgAliases};
+import { kebabCase } from "@stryke/string-format/kebab-case";
+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) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
+*
+* @param aliases - An array of argument aliases to sort.
+* @returns A new array of sorted aliases.
+*/
+function sortArgAliases(aliases) {
+	if (aliases.length === 0) return [];
+	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",
+	"Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.",
+	"P&F2!&F/\"?#"
+];
+/**
+* Retrieves the application name from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application name in kebab-case format.
+* @throws An error if no valid application name is found.
+*/
+function getAppName(context) {
+	const result = context.config.name || (isSetString(context.config.bin) || Array.isArray(context.config.bin) && context.config.bin.length > 0 && isSetString(context.config.bin[0]) ? isSetString(context.config.bin) ? context.config.bin : context.config.bin[0] : context.packageJson?.name);
+	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",
+	"Retrieves the application name from the context and configuration.",
+	"PP\"w!\"w\"J2#&/$?%"
+];
+/**
+* Retrieves the application title from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.
+* @returns The application title in title-case format.
+*/
+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",
+	"Retrieves the application title from the context and configuration.",
+	"PP\"w!\"w\"J2#\"2$&/%?&"
+];
+/**
+* Retrieves the application description from the context and configuration.
+*
+* @param context - The build context containing workspace and package information.
+* @returns The application description.
+*/
+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#&/$?%"
+];
+/**
+* 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.
+*/
+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\"&/#?$"
+];
+/**
+* Determines if a given command path segment is variable (enclosed in square brackets).
+*
+* @example
+* ```typescript
+* isDynamicPathSegment("[user]"); // true
+* isDynamicPathSegment("user"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is variable, false otherwise.
+*/
+function isDynamicPathSegment(path) {
+	return path.startsWith("[") && path.endsWith("]");
+}
+isDynamicPathSegment.__type = [
+	"path",
+	"isDynamicPathSegment",
+	"Determines if a given command path segment is variable (enclosed in square brackets).",
+	"P&2!)/\"?#"
+];
+/**
+* Extracts the variable name from a command path segment by removing enclosing square brackets.
+*
+* @example
+* ```typescript
+* getDynamicPathSegmentName("[user]"); // "user"
+* ```
+*
+* @param path - The command path segment.
+* @returns The variable name without square brackets.
+*/
+function getDynamicPathSegmentName(path) {
+	return path.replaceAll(/^\[+/g, "").replaceAll(/\]+$/g, "");
+}
+getDynamicPathSegmentName.__type = [
+	"path",
+	"getDynamicPathSegmentName",
+	"Extracts the variable name from a command path segment by removing enclosing square brackets.",
+	"P&2!&/\"?#"
+];
+/**
+* Determines if a given command path segment is a path segment group (enclosed in parentheses).
+*
+* @example
+* ```typescript
+* isPathSegmentGroup("(user)"); // true
+* isPathSegmentGroup("[user]"); // false
+* isPathSegmentGroup("user"); // false
+* ```
+*
+* @param path - The command path segment to check.
+* @returns True if the path is a path segment group, false otherwise.
+*/
+function isPathSegmentGroup(path) {
+	return path.startsWith("(") && path.endsWith(")") || path.startsWith("_");
+}
+isPathSegmentGroup.__type = [
+	"path",
+	"isPathSegmentGroup",
+	"Determines if a given command path segment is a path segment group (enclosed in parentheses).",
+	"P&2!)/\"?#"
+];
+/**
+* Extracts the group name from a command path segment by removing enclosing parentheses.
+*
+* @example
+* ```typescript
+* getPathSegmentGroupName("(admin)"); // "admin"
+* getPathSegmentGroupName("((group))"); // "group"
+* ```
+*
+* @param path - The command path segment.
+* @returns The group name without parentheses.
+*/
+function getPathSegmentGroupName(path) {
+	return path.replaceAll(/^\(+/g, "").replaceAll(/\)+$/g, "").replaceAll(/^_+/g, "");
+}
+getPathSegmentGroupName.__type = [
+	"path",
+	"getPathSegmentGroupName",
+	"Extracts the group name from a command path segment by removing enclosing parentheses.",
+	"P&2!&/\"?#"
+];
+/**
+* Extracts the variable name from a command path segment by removing enclosing square brackets.
+*
+* @example
+* ```typescript
+* getDynamicPathSegmentName("[user]"); // "user"
+* ```
+*
+* @param path - The command path segment.
+* @returns The variable name without square brackets.
+*/
+function getPathSegmentName(path) {
+	return getPathSegmentGroupName(getDynamicPathSegmentName(path));
+}
+getPathSegmentName.__type = [
+	"path",
+	"getPathSegmentName",
+	"Extracts the variable name from a command path segment by removing enclosing square brackets.",
+	"P&2!&/\"?#"
+];
+
+//#endregion
+export { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases };
 //# sourceMappingURL=context-helpers.mjs.map

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":"0PAAA,SAAS,EAAa,EAAI,EAAM,CAE9B,kBAAO,EA6BT,SAAc,EAAc,EAAA,CAC1B,GAAE,EAAS,SAAA,EACX,MAAA,EAAA,CAEA,IAAM,EAAS,EAAQ,OAAO,EAAS,GAAa,EAAM,SAAA,EAAA,CAAA,QAAA,GAAA,UAAA,CAAA,CAAA,QAC1D,EAAO,KAAK,GAAG,EAAQ,OAAO,EAAS,GAAa,EAAK,OAAA,EAAA,CAAA,QAAA,GAAA,UAAA,CAAA,CAAA,CAAA,gEAG3D,EAAA,OAAA,CAAA,UAAA,iBAAA,qJAAA,cAAA,CAQA,SAAE,EAAA,EAAA,CACF,IAAO,EAAS,EAAA,OAAW,OAAS,EAAiB,EAAG,OAAU,IAAM,EAAC,MAAA,QAAA,EAAA,OAAA,IAAA,EAAA,EAAA,OAAA,IAAA,OAAA,GAAA,EAAA,EAAA,OAAA,IAAA,GAAA,CAAA,EAAA,EAAA,OAAA,IAAA,CAAA,EAAA,OAAA,IAAA,EAAA,OAAA,IAAA,GAAA,EAAA,aAAA,MACvE,GAAA,CAAK,EAAQ,EAAA,CACX,MAAQ,MAAO,qIAAM,CAEvB,OAAG,EAAc,EAAO,CAE1B,EAAM,OAAY,CAAA,oBAAsB,UAAA,UAAA,aAAA,qEAAA,mBAAA,CAQxC,SAAK,EAAA,EAAA,EAAA,GAAA,CACH,IAAA,EAAA,EAAA,OAAA,OAAA,EAAA,EAAA,OAAA,MAAA,EAAA,EAAA,CAAA,iHAGF,EAAA,OAAA,CAAA,oBAAA,UAAA,UAAA,aAAA,cAAA,sEAAA,sBAAA,CAOA,SAAgB,EAAkB,EAAS,CACzC,OAAA,EAAA,OAAA,aAAA,EAAA,aAAA,aAAA,OAAA,EAAA,EAAA,GAAA,CAAA,sCAEF,EAAW,OAAA,CAAiB,oBAAU,UAAA,UAAA,oBAAA,4EAAA,mBAAA,CAOtC,SAAS,EAAA,EAAA,CACP,OAAE,EAAA,EAAA,OAAA,IAAA,CAAA,OAAA,KAAA,EAAA,OAAA,IAAA,CAAA,GAAA,EAAA,EAAA,EAAA,CAAA,CAEJ,EAAU,OAAQ,CAAA,UAAa,UAAQ,YAAW,yDAAsC,cAAA,CAaxF,SAAgB,EAAiB,EAAA,CAC/B,OAAO,EAAE,WAAA,IAAkB,EAAE,EAAA,SAAA,IAAA,CAE/B,EAAS,OAAA,CAAA,OAAA,uBAAA,wFAAA,YAAA,CAYT,SAAE,EAAA,EAAA,CACF,OAAO,EAAA,WAAkB,QAAS,GAAC,CAAA,WAAU,QAAO,GAAA,CAEpD,EAA0B,OAAO,CAAG,OAAI,4BAAA,gGAAA,YAAA,CAcxC,SAAgB,EAAgB,EAAS,CACvC,OAAA,EAAA,WAAA,IAAA,EAAA,EAAA,SAAA,IAAA,EAAA,EAAA,WAAA,IAAA,CAEF,EAAc,OAAc,CAAC,OAAQ,qBAAc,gGAAA,YAAA,CAanD,SAAE,EAAA,EAAA,CACF,OAAO,EAAA,WAAS,QAAA,GAAA,CAAA,WAAgC,QAAS,GAAA,CAAA,WAAO,OAAA,GAAA,CAEhE,EAAA,OAAA,CAAA,OAAA,0BAAA,yFAAA,YAAA,CAYA,SAAgB,EAAkB,EAAO,CACvC,OAAE,EAA6B,EAA0B,EAAC,CAAA,CAE5D,EAAgB,OAAA,CAAA,OAAmB,qBAAuB,gGAAA,YAAA"}
+{"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"}