@shell-shock/core 0.17.2 → 0.17.4

package/dist/contexts/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","names":[],"sources":["../../src/contexts/options.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 { ComponentContext } from \"@alloy-js/core\";\nimport { createNamedContext, useContext } from \"@alloy-js/core\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport defu from \"defu\";\nimport type { BooleanCommandOption, CommandOption } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * The reflection parameter context used in template rendering.\n */\nexport const ExistingOptionsContext: ComponentContext<string[]> =\n  createNamedContext<string[]>(\"ExistingOptions\", []);\n\n/**\n * Hook to access the ExistingOptions context.\n *\n * @remarks\n * This context provides a list of option names that already exist on the interface definition.\n *\n * @returns A reactive version of the current reflection.\n */\nexport function useExistingOptions() {\n  return useContext<string[]>(ExistingOptionsContext)!;\n}\n\nexport function computedOptions(options: CommandOption[]) {\n  return options.reduce(\n    (ret, option) => {\n      ret[camelCase(option.name)] ??= defu(\n        {\n          name: camelCase(option.name)\n        },\n        ret[option.name] ?? {},\n        option\n      ) as CommandOption;\n\n      if (\n        option.kind === CommandParameterKinds.boolean &&\n        option.isNegativeOf\n      ) {\n        ret[camelCase(option.isNegativeOf)] = defu(\n          {\n            name: camelCase(option.isNegativeOf)\n          },\n          ret[option.isNegativeOf] ?? {},\n          {\n            ...option,\n            env: isSetString(option.env) ? `NO_${option.env}` : false,\n            description: `${option.description.replace(\n              /\\.+$/,\n              \"\"\n            )}. This property is the negative form of ${option.name}.`,\n            isNegativeOf: camelCase(option.name),\n            default: !option.default\n          }\n        ) as BooleanCommandOption;\n      }\n\n      return ret;\n    },\n    {} as Record<string, CommandOption>\n  );\n}\n"],"mappings":";;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;AAUX,MAAa,0BAAsB,mBAAkB,IAAA,CAAA,CAAA,KAAA,CAAA,EAAA,mBAAA,mBAAA,EAAA,CAAA;;;;;;;;;AASrD,SAAS,qBAA4B;AACrC,QAAY,WAAW,IAAA,CAAA,CAAA,KAAA,CAAA,EAAA,WAAA,uBAAA;;AAEvB,mBAAS,SAAA,CAAA,sBAAuC,QAAQ;;AAEtD,QAAA,QAAA,OAAA,cAAA,KAAA,WAAA;AACK,MAAA,UAAW,OAAU,KAAA,MAAY,OAAI,EAC1C,MAAA,UAAA,OAAA,KAAA,EACK,EAAA,IAAM,OAAA,SAAA,EAAA,EAAsB,OAAE;AACnC,MAAA,OAAA,SAA0B,sBAAsB,+BAEhD,KAAA,UAAA,OAAA,aAAA,IAAA,OAAA,EACS,MAAW,UAAA,OAAgB,aAAO,EAC5C,EAAA,IAAA,OAAA,iBAAA,EAAA,EAAA;GACG,GAAA;GACY,KAAA,YAAgB,OAAG,IAAO,GAAK,MAAM,OAAO,QAAO;GAClE,aAAA,GAAA,OAAA,YAAA,QAAA,QAAA,GAAA,CAAA,0CAAA,OAAA,KAAA;GACa,cAAgB,UAAQ,OAAQ,KAAA;GAC5C,SAAA,CAAA,OAAA;GACK,CAAA;AAEP,SAAA;;;;;;;;AAGA,gBAAgB,SAAO;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"options.mjs","names":[],"sources":["../../src/contexts/options.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 { ComponentContext } from \"@alloy-js/core\";\nimport { createNamedContext, useContext } from \"@alloy-js/core\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport defu from \"defu\";\nimport type { BooleanCommandOption, CommandOption } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * The reflection parameter context used in template rendering.\n */\nexport const ExistingOptionsContext: ComponentContext<string[]> =\n  createNamedContext<string[]>(\"ExistingOptions\", []);\n\n/**\n * Hook to access the ExistingOptions context.\n *\n * @remarks\n * This context provides a list of option names that already exist on the interface definition.\n *\n * @returns A reactive version of the current reflection.\n */\nexport function useExistingOptions() {\n  return useContext<string[]>(ExistingOptionsContext)!;\n}\n\nexport function computedOptions(options: CommandOption[]) {\n  return options.reduce(\n    (ret, option) => {\n      ret[camelCase(option.name)] ??= defu(\n        {\n          name: camelCase(option.name)\n        },\n        ret[option.name] ?? {},\n        option\n      ) as CommandOption;\n\n      if (\n        option.kind === CommandParameterKinds.boolean &&\n        option.isNegativeOf\n      ) {\n        ret[camelCase(option.isNegativeOf)] = defu(\n          {\n            name: camelCase(option.isNegativeOf)\n          },\n          ret[option.isNegativeOf] ?? {},\n          {\n            ...option,\n            env: isSetString(option.env) ? `NO_${option.env}` : false,\n            description: `${option.description.replace(\n              /\\.+$/,\n              \"\"\n            )}. This property is the negative form of ${option.name}.`,\n            isNegativeOf: camelCase(option.name),\n            default: !option.default\n          }\n        ) as BooleanCommandOption;\n      }\n\n      return ret;\n    },\n    {} as Record<string, CommandOption>\n  );\n}\n"],"mappings":";;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;AAUX,MAAa,0BAAsB,mBAAkB,IAAA,CAAA,CAAA,KAAA,CAAA,EAAA,mBAAA,mBAAA,EAAA,CAAA;;;;;;;;;AASrD,SAAS,qBAA4B;AACrC,QAAY,WAAW,IAAA,CAAA,CAAA,KAAA,CAAA,EAAA,WAAA,uBAAA;;AAEvB,mBAAS,SAAA;CAAA;CAAuC;CAAQ;CAAA;;AAEtD,QAAA,QAAA,OAAA,cAAA,KAAA,WAAA;AACK,MAAA,UAAW,OAAU,KAAA,MAAY,OAAI,EAC1C,MAAA,UAAA,OAAA,KAAA,EACK,EAAA,IAAM,OAAA,SAAA,EAAA,EAAsB,OAAE;AACnC,MAAA,OAAA,SAA0B,sBAAsB,+BAEhD,KAAA,UAAA,OAAA,aAAA,IAAA,OAAA,EACS,MAAW,UAAA,OAAgB,aAAO,EAC5C,EAAA,IAAA,OAAA,iBAAA,EAAA,EAAA;GACG,GAAA;GACY,KAAA,YAAgB,OAAG,IAAO,GAAK,MAAM,OAAO,QAAO;GAClE,aAAA,GAAA,OAAA,YAAA,QAAA,QAAA,GAAA,CAAA,0CAAA,OAAA,KAAA;GACa,cAAgB,UAAQ,OAAQ,KAAA;GAC5C,SAAA,CAAA,OAAA;GACK,CAAA;AAEP,SAAA;;;;;;;;AAGA,gBAAgB,SAAO;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/helpers/automd.cjs

@@ -53,5 +53,4 @@ const commands = (context) => (0, automd.defineGenerator)({
 });
 
 //#endregion
-exports.commands = commands;
-//# sourceMappingURL=automd.cjs.map
+exports.commands = commands;

package/dist/helpers/docs-helpers.cjs

@@ -15,9 +15,9 @@ getDocsOutputPath.__type = [
 	"Context",
 	"context",
 	"getDocsOutputPath",
-	"P\"w!2\"&/#"
+	"Gets the output path for the generated documentation.",
+	"P\"w!2\"&/#?$"
 ];
 
 //#endregion
-exports.getDocsOutputPath = getDocsOutputPath;
-//# sourceMappingURL=docs-helpers.cjs.map
+exports.getDocsOutputPath = getDocsOutputPath;

package/dist/helpers/docs-helpers.mjs

@@ -14,7 +14,8 @@ getDocsOutputPath.__type = [
 	"Context",
 	"context",
 	"getDocsOutputPath",
-	"P\"w!2\"&/#"
+	"Gets the output path for the generated documentation.",
+	"P\"w!2\"&/#?$"
 ];
 
 //#endregion

package/dist/helpers/docs-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"docs-helpers.mjs","names":[],"sources":["../../src/helpers/docs-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 { joinPaths } from \"@stryke/path/join\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Gets the output path for the generated documentation.\n *\n * @param context - The Shell Shock context.\n * @returns The output path for the generated documentation.\n */\nexport function getDocsOutputPath(context: Context): string {\n  return joinPaths(context.config.root, \"docs\", \"generated\");\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAU,kBAAoB,SAAa;AACvC,QAAO,UAAK,QAAY,OAAQ,MAAA,QAAU,YAAa;;AAE3D,kBAAgB,SAAA;CAAA;CAAkB;CAAgB;CAAU;CAAA"}
+{"version":3,"file":"docs-helpers.mjs","names":[],"sources":["../../src/helpers/docs-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 { joinPaths } from \"@stryke/path/join\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Gets the output path for the generated documentation.\n *\n * @param context - The Shell Shock context.\n * @returns The output path for the generated documentation.\n */\nexport function getDocsOutputPath(context: Context): string {\n  return joinPaths(context.config.root, \"docs\", \"generated\");\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAU,kBAAoB,SAAa;AACvC,QAAO,UAAK,QAAY,OAAQ,MAAA,QAAU,YAAa;;AAE3D,kBAAgB,SAAA;CAAA;CAAkB;CAAgB;CAAU;CAAA;CAAA"}

package/dist/helpers/paths.cjs

@@ -49,7 +49,8 @@ function resolveCommandName(file) {
 resolveCommandName.__type = [
 	"file",
 	"resolveCommandName",
-	"P&2!\"/\""
+	"Finds the command name from the given file path.",
+	"P&2!\"/\"?#"
 ];
 function resolveCommandPath(context, file) {
 	return (0, _stryke_path_replace.replacePath)((0, _stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").split("/").filter(__assignType((path) => path && !require_context_helpers.isPathSegmentGroup(path), [
@@ -133,5 +134,4 @@ findCommandsRoot.__type = [
 exports.findCommandsRoot = findCommandsRoot;
 exports.resolveCommandId = resolveCommandId;
 exports.resolveCommandName = resolveCommandName;
-exports.resolveCommandPath = resolveCommandPath;
-//# sourceMappingURL=paths.cjs.map
+exports.resolveCommandPath = resolveCommandPath;

package/dist/helpers/paths.mjs

@@ -48,7 +48,8 @@ function resolveCommandName(file) {
 resolveCommandName.__type = [
 	"file",
 	"resolveCommandName",
-	"P&2!\"/\""
+	"Finds the command name from the given file path.",
+	"P&2!\"/\"?#"
 ];
 function resolveCommandPath(context, file) {
 	return replacePath(findFilePath(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").split("/").filter(__assignType((path) => path && !isPathSegmentGroup(path), [

package/dist/helpers/paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/helpers/paths.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 { listFiles } from \"@stryke/fs/list-files\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { existsSync } from \"node:fs\";\nimport { isTypeDefinition } from \"powerlines/utils\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"../plugin-utils/context-helpers\";\nimport type { Context } from \"../types/context\";\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isDynamicPathSegment(p))\n    .join(\"/\")\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .replaceAll(\"/\", \"-\");\n}\n\n/**\n * Finds the command name from the given file path.\n *\n * @param file - The file path to extract the command name from.\n * @returns The command name.\n */\nexport function resolveCommandName(file: string) {\n  let path = findFilePath(file);\n  let name = findFolderName(file, {\n    requireExtension: true\n  });\n\n  while (isDynamicPathSegment(name)) {\n    path = resolveParentPath(path);\n    name = findFolderName(path, {\n      requireExtension: true\n    });\n  }\n\n  return name;\n}\n\nexport function resolveCommandPath(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .split(\"/\")\n    .filter(path => path && !isPathSegmentGroup(path))\n    .join(\"/\");\n}\n\nexport function resolveCommandDynamicPathSegments(\n  context: Context,\n  file: string\n): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(path => Boolean(path) && isDynamicPathSegment(path))\n    .map(path => getDynamicPathSegmentName(path));\n}\n\nexport async function findCommandsRoot(context: Context): Promise<string> {\n  let paths = [] as string[];\n  if (isSetString(context.config.input)) {\n    paths = await listFiles(\n      appendPath(\n        appendPath(context.config.input, context.config.root),\n        context.workspaceConfig.workspaceRoot\n      )\n    );\n  } else if (isTypeDefinition(context.config.input)) {\n    paths = await listFiles(\n      appendPath(\n        appendPath(context.config.input.file, context.config.root),\n        context.workspaceConfig.workspaceRoot\n      )\n    );\n  } else if (\n    Array.isArray(context.config.input) &&\n    context.config.input.length > 0\n  ) {\n    paths = (\n      await Promise.all(\n        context.config.input.map(async input =>\n          listFiles(\n            appendPath(\n              appendPath(\n                isSetString(input) ? input : input.file,\n                context.config.root\n              ),\n              context.workspaceConfig.workspaceRoot\n            )\n          )\n        )\n      )\n    ).flat();\n  } else if (isSetObject(context.config.input)) {\n    paths = (\n      await Promise.all(\n        Object.values(context.config.input).map(async input =>\n          Array.isArray(input)\n            ? (\n                await Promise.all(\n                  input.map(async i =>\n                    listFiles(\n                      appendPath(\n                        appendPath(\n                          isSetString(i) ? i : i.file,\n                          context.config.root\n                        ),\n                        context.workspaceConfig.workspaceRoot\n                      )\n                    )\n                  )\n                )\n              ).flat()\n            : listFiles(\n                appendPath(\n                  appendPath(\n                    isSetString(input) ? input : input.file,\n                    context.config.root\n                  ),\n                  context.workspaceConfig.workspaceRoot\n                )\n              )\n        )\n      )\n    ).flat();\n  }\n\n  if (paths.length > 0) {\n    return commonPath(paths.map(p => findFilePath(p)));\n  }\n\n  let commandsPath = joinPaths(context.config.root, \"src/commands\");\n  if (!existsSync(commandsPath)) {\n    commandsPath = joinPaths(context.config.root, \"commands\");\n    if (!existsSync(commandsPath)) {\n      commandsPath = joinPaths(context.config.root, \"src\");\n      if (!existsSync(commandsPath)) {\n        commandsPath = context.config.root;\n      }\n    }\n  }\n\n  paths = (\n    await Promise.all([\n      listFiles(\n        joinPaths(\n          appendPath(commandsPath, context.workspaceConfig.workspaceRoot),\n          \"**/command.ts\"\n        )\n      ),\n      listFiles(\n        joinPaths(\n          appendPath(commandsPath, context.workspaceConfig.workspaceRoot),\n          \"**/command.tsx\"\n        )\n      )\n    ])\n  ).flat();\n  if (paths.length > 0) {\n    return commonPath(paths.map(p => findFilePath(p)));\n  }\n\n  return appendPath(commandsPath, context.workspaceConfig.workspaceRoot);\n}\n"],"mappings":"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"}
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/helpers/paths.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 { listFiles } from \"@stryke/fs/list-files\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { existsSync } from \"node:fs\";\nimport { isTypeDefinition } from \"powerlines/utils\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"../plugin-utils/context-helpers\";\nimport type { Context } from \"../types/context\";\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isDynamicPathSegment(p))\n    .join(\"/\")\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .replaceAll(\"/\", \"-\");\n}\n\n/**\n * Finds the command name from the given file path.\n *\n * @param file - The file path to extract the command name from.\n * @returns The command name.\n */\nexport function resolveCommandName(file: string) {\n  let path = findFilePath(file);\n  let name = findFolderName(file, {\n    requireExtension: true\n  });\n\n  while (isDynamicPathSegment(name)) {\n    path = resolveParentPath(path);\n    name = findFolderName(path, {\n      requireExtension: true\n    });\n  }\n\n  return name;\n}\n\nexport function resolveCommandPath(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .split(\"/\")\n    .filter(path => path && !isPathSegmentGroup(path))\n    .join(\"/\");\n}\n\nexport function resolveCommandDynamicPathSegments(\n  context: Context,\n  file: string\n): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(path => Boolean(path) && isDynamicPathSegment(path))\n    .map(path => getDynamicPathSegmentName(path));\n}\n\nexport async function findCommandsRoot(context: Context): Promise<string> {\n  let paths = [] as string[];\n  if (isSetString(context.config.input)) {\n    paths = await listFiles(\n      appendPath(\n        appendPath(context.config.input, context.config.root),\n        context.workspaceConfig.workspaceRoot\n      )\n    );\n  } else if (isTypeDefinition(context.config.input)) {\n    paths = await listFiles(\n      appendPath(\n        appendPath(context.config.input.file, context.config.root),\n        context.workspaceConfig.workspaceRoot\n      )\n    );\n  } else if (\n    Array.isArray(context.config.input) &&\n    context.config.input.length > 0\n  ) {\n    paths = (\n      await Promise.all(\n        context.config.input.map(async input =>\n          listFiles(\n            appendPath(\n              appendPath(\n                isSetString(input) ? input : input.file,\n                context.config.root\n              ),\n              context.workspaceConfig.workspaceRoot\n            )\n          )\n        )\n      )\n    ).flat();\n  } else if (isSetObject(context.config.input)) {\n    paths = (\n      await Promise.all(\n        Object.values(context.config.input).map(async input =>\n          Array.isArray(input)\n            ? (\n                await Promise.all(\n                  input.map(async i =>\n                    listFiles(\n                      appendPath(\n                        appendPath(\n                          isSetString(i) ? i : i.file,\n                          context.config.root\n                        ),\n                        context.workspaceConfig.workspaceRoot\n                      )\n                    )\n                  )\n                )\n              ).flat()\n            : listFiles(\n                appendPath(\n                  appendPath(\n                    isSetString(input) ? input : input.file,\n                    context.config.root\n                  ),\n                  context.workspaceConfig.workspaceRoot\n                )\n              )\n        )\n      )\n    ).flat();\n  }\n\n  if (paths.length > 0) {\n    return commonPath(paths.map(p => findFilePath(p)));\n  }\n\n  let commandsPath = joinPaths(context.config.root, \"src/commands\");\n  if (!existsSync(commandsPath)) {\n    commandsPath = joinPaths(context.config.root, \"commands\");\n    if (!existsSync(commandsPath)) {\n      commandsPath = joinPaths(context.config.root, \"src\");\n      if (!existsSync(commandsPath)) {\n        commandsPath = context.config.root;\n      }\n    }\n  }\n\n  paths = (\n    await Promise.all([\n      listFiles(\n        joinPaths(\n          appendPath(commandsPath, context.workspaceConfig.workspaceRoot),\n          \"**/command.ts\"\n        )\n      ),\n      listFiles(\n        joinPaths(\n          appendPath(commandsPath, context.workspaceConfig.workspaceRoot),\n          \"**/command.tsx\"\n        )\n      )\n    ])\n  ).flat();\n  if (paths.length > 0) {\n    return commonPath(paths.map(p => findFilePath(p)));\n  }\n\n  return appendPath(commandsPath, context.workspaceConfig.workspaceRoot);\n}\n"],"mappings":"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"}

package/dist/helpers/persistence.cjs

@@ -59,7 +59,8 @@ getCommandsPersistencePath.__type = [
 	"Context",
 	"context",
 	"getCommandsPersistencePath",
-	"P\"w!2\"&/#"
+	"Gets the file path for persisting CLI command reflections.",
+	"P\"w!2\"&/#?$"
 ];
 /**
 * Reads the persisted CLI command reflections from the file system and populates the context's commands.
@@ -80,7 +81,8 @@ readCommandsPersistence.__type = [
 	"Context",
 	"context",
 	"readCommandsPersistence",
-	"P\"w!2\"\"/#"
+	"Reads the persisted CLI command reflections from the file system and populates the context's commands.",
+	"P\"w!2\"\"/#?$"
 ];
 /**
 * Writes the current CLI command reflections from the context to the file system for persistence.
@@ -101,11 +103,11 @@ writeCommandsPersistence.__type = [
 	"Context",
 	"context",
 	"writeCommandsPersistence",
-	"P\"w!2\"\"/#"
+	"Writes the current CLI command reflections from the context to the file system for persistence.",
+	"P\"w!2\"\"/#?$"
 ];
 
 //#endregion
 exports.getCommandsPersistencePath = getCommandsPersistencePath;
 exports.readCommandsPersistence = readCommandsPersistence;
-exports.writeCommandsPersistence = writeCommandsPersistence;
-//# sourceMappingURL=persistence.cjs.map
+exports.writeCommandsPersistence = writeCommandsPersistence;

package/dist/helpers/persistence.mjs

@@ -58,7 +58,8 @@ getCommandsPersistencePath.__type = [
 	"Context",
 	"context",
 	"getCommandsPersistencePath",
-	"P\"w!2\"&/#"
+	"Gets the file path for persisting CLI command reflections.",
+	"P\"w!2\"&/#?$"
 ];
 /**
 * Reads the persisted CLI command reflections from the file system and populates the context's commands.
@@ -79,7 +80,8 @@ readCommandsPersistence.__type = [
 	"Context",
 	"context",
 	"readCommandsPersistence",
-	"P\"w!2\"\"/#"
+	"Reads the persisted CLI command reflections from the file system and populates the context's commands.",
+	"P\"w!2\"\"/#?$"
 ];
 /**
 * Writes the current CLI command reflections from the context to the file system for persistence.
@@ -100,7 +102,8 @@ writeCommandsPersistence.__type = [
 	"Context",
 	"context",
 	"writeCommandsPersistence",
-	"P\"w!2\"\"/#"
+	"Writes the current CLI command reflections from the context to the file system for persistence.",
+	"P\"w!2\"\"/#?$"
 ];
 
 //#endregion

package/dist/helpers/persistence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.mjs","names":[],"sources":["../../src/helpers/persistence.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 { joinPaths } from \"@stryke/path/join-paths\";\nimport type { CommandTree, SerializedCommandTree } from \"../types\";\nimport type { Context } from \"../types/context\";\n\nfunction serialize(command: CommandTree): SerializedCommandTree {\n  return {\n    ...command,\n    parent: command.parent?.name ? command.parent.name : null,\n    children: Object.fromEntries(\n      Object.entries(command.children || {}).map(([name, child]) => [\n        name,\n        serialize(child)\n      ])\n    )\n  };\n}\n\nfunction deserialize(\n  command: SerializedCommandTree,\n  parent: CommandTree | null = null\n): CommandTree {\n  const result: CommandTree = {\n    ...command,\n    parent: parent ?? null,\n    children: {}\n  };\n\n  result.children = Object.fromEntries(\n    Object.entries(command.children || {}).map(([name, child]) => [\n      name,\n      deserialize(child, result)\n    ])\n  );\n\n  return result;\n}\n\n/**\n * Gets the file path for persisting CLI command reflections.\n *\n * @param context - The Shell Shock context.\n * @returns The file path for persisting CLI command reflections.\n */\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, \"reflections\", \"commands.json\");\n}\n\n/**\n * Reads the persisted CLI command reflections from the file system and populates the context's commands.\n *\n * @param context - The Shell Shock context.\n * @throws Will throw an error if the reflections file is empty or cannot be read.\n */\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = Object.fromEntries(\n    Object.entries(\n      (JSON.parse(reflections) ?? {}) as Record<string, SerializedCommandTree>\n    ).map(([name, command]) => [name, deserialize(command)])\n  );\n}\n\n/**\n * Writes the current CLI command reflections from the context to the file system for persistence.\n *\n * @param context - The Shell Shock context.\n * @returns A promise that resolves when the reflections have been successfully written to the file system.\n * @throws Will throw an error if there is an issue writing the reflections to the file system.\n */\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      Object.fromEntries(\n        Object.entries(context.commands).map(([name, command]) => [\n          name,\n          serialize(command)\n        ])\n      ),\n      null,\n      context.config.mode === \"production\" ? 0 : 2\n    )\n  );\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AAoBX,SAAS,UAAU,SAAS;AAC1B,QAAO;EACF,GAAA;EACH,QAAQ,QAAQ,QAAY,OAAG,QAAQ,OAAW,OAAO;EACzD,UAAU,OAAO,YAAW,OAAA,QAAA,QAAA,YAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,WAAA,CACpB,MACA,UAAA,MAAA,CACJ,EAAA;GAAA;GAAU;GAAK;GAAA,CAAA,CAAA,CAAA;EAClB;;AAEL,UAAG,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACH,SAAA,YAAA,SAAA,SAAA,MAAA;;EAEQ,GAAC;EACP,QAAS,UAAA;EACH,UAAE,EAAA;EACP;AACD,QAAM,WAAQ,OAAa,YAAC,OAAA,QAAA,QAAA,YAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,WAAA,CACvB,MACH,YAAgB,OAAM,OAAA,CACtB,EAAA;EAAA;EAAW;EAAA;EAAA,CAAA,CAAA,CAAA;AACZ,QAAA;;AAEH,YAAS,SAAW;CAAA;CAAkB;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;AAOtC,SAAe,2BAAA,SAAA;AACf,QAAA,UAAA,QAAA,UAAA,eAAA,gBAAA;;AAEA,2BAAE,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,eAAmB,wBAAmB,SAAe;CACrD,MAAA,cAAA,MAAA,QAAA,GAAA,KAAA,2BAAA,QAAA,CAAA;yCAEE,OAAA,IAAA,MAAA,+BAAA,2BAAA,QAAA,CAAA,WAAA;AAED,SAAA,WAAA,OAAA,YAAA,OAAA,QAAA,KAAA,MAAA,YAAA,IAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,aAAA,CAAA,MAAA,YAAA,QAAA,CAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAED,wBAAwB,SAAS;CAAC;CAAI;CAAiB;CAA0B;CAAA;;;;;;;;AAQjF,eAAmB,yBAAkB,SAAA;CACjC,MAAC,WAAA,2BAAA,QAAA;AACH,OAAA,QAAA,GAAA,MAAA,UAAA,KAAA,UAAA,OAAA,YAAA,OAAA,QAAA,QAAA,SAAA,CAAA,IAAA,cAAA,CAAA,MAAA,aAAA,OAEA,UAAgB,QAAG,CACjB,EAAA;EAAA;EAAc;EAAA;EAAA,CAAA,CAAA,CAAA,EAAA,MAAA,QAAA,OAAA,SAAA,eAAA,IAAA,EAAA,CAAA;;AAElB,yBAAyB,SAAO;CAAA;CAAM;CAAmB;CAAE;CAAA"}
+{"version":3,"file":"persistence.mjs","names":[],"sources":["../../src/helpers/persistence.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 { joinPaths } from \"@stryke/path/join-paths\";\nimport type { CommandTree, SerializedCommandTree } from \"../types\";\nimport type { Context } from \"../types/context\";\n\nfunction serialize(command: CommandTree): SerializedCommandTree {\n  return {\n    ...command,\n    parent: command.parent?.name ? command.parent.name : null,\n    children: Object.fromEntries(\n      Object.entries(command.children || {}).map(([name, child]) => [\n        name,\n        serialize(child)\n      ])\n    )\n  };\n}\n\nfunction deserialize(\n  command: SerializedCommandTree,\n  parent: CommandTree | null = null\n): CommandTree {\n  const result: CommandTree = {\n    ...command,\n    parent: parent ?? null,\n    children: {}\n  };\n\n  result.children = Object.fromEntries(\n    Object.entries(command.children || {}).map(([name, child]) => [\n      name,\n      deserialize(child, result)\n    ])\n  );\n\n  return result;\n}\n\n/**\n * Gets the file path for persisting CLI command reflections.\n *\n * @param context - The Shell Shock context.\n * @returns The file path for persisting CLI command reflections.\n */\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, \"reflections\", \"commands.json\");\n}\n\n/**\n * Reads the persisted CLI command reflections from the file system and populates the context's commands.\n *\n * @param context - The Shell Shock context.\n * @throws Will throw an error if the reflections file is empty or cannot be read.\n */\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = Object.fromEntries(\n    Object.entries(\n      (JSON.parse(reflections) ?? {}) as Record<string, SerializedCommandTree>\n    ).map(([name, command]) => [name, deserialize(command)])\n  );\n}\n\n/**\n * Writes the current CLI command reflections from the context to the file system for persistence.\n *\n * @param context - The Shell Shock context.\n * @returns A promise that resolves when the reflections have been successfully written to the file system.\n * @throws Will throw an error if there is an issue writing the reflections to the file system.\n */\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      Object.fromEntries(\n        Object.entries(context.commands).map(([name, command]) => [\n          name,\n          serialize(command)\n        ])\n      ),\n      null,\n      context.config.mode === \"production\" ? 0 : 2\n    )\n  );\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AAoBX,SAAS,UAAU,SAAS;AAC1B,QAAO;EACF,GAAA;EACH,QAAQ,QAAQ,QAAY,OAAG,QAAQ,OAAW,OAAO;EACzD,UAAU,OAAO,YAAW,OAAA,QAAA,QAAA,YAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,WAAA,CACpB,MACA,UAAA,MAAA,CACJ,EAAA;GAAA;GAAU;GAAK;GAAA,CAAA,CAAA,CAAA;EAClB;;AAEL,UAAG,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACH,SAAA,YAAA,SAAA,SAAA,MAAA;;EAEQ,GAAC;EACP,QAAS,UAAA;EACH,UAAE,EAAA;EACP;AACD,QAAM,WAAQ,OAAa,YAAC,OAAA,QAAA,QAAA,YAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,WAAA,CACvB,MACH,YAAgB,OAAM,OAAA,CACtB,EAAA;EAAA;EAAW;EAAA;EAAA,CAAA,CAAA,CAAA;AACZ,QAAA;;AAEH,YAAS,SAAW;CAAA;CAAkB;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;AAOtC,SAAe,2BAAA,SAAA;AACf,QAAA,UAAA,QAAA,UAAA,eAAA,gBAAA;;AAEA,2BAAE,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,eAAmB,wBAAmB,SAAe;CACrD,MAAA,cAAA,MAAA,QAAA,GAAA,KAAA,2BAAA,QAAA,CAAA;yCAEE,OAAA,IAAA,MAAA,+BAAA,2BAAA,QAAA,CAAA,WAAA;AAED,SAAA,WAAA,OAAA,YAAA,OAAA,QAAA,KAAA,MAAA,YAAA,IAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,aAAA,CAAA,MAAA,YAAA,QAAA,CAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAED,wBAAwB,SAAS;CAAC;CAAI;CAAiB;CAA0B;CAAA;CAAA;;;;;;;;AAQjF,eAAmB,yBAAkB,SAAA;CACjC,MAAC,WAAA,2BAAA,QAAA;AACH,OAAA,QAAA,GAAA,MAAA,UAAA,KAAA,UAAA,OAAA,YAAA,OAAA,QAAA,QAAA,SAAA,CAAA,IAAA,cAAA,CAAA,MAAA,aAAA,OAEA,UAAgB,QAAG,CACjB,EAAA;EAAA;EAAc;EAAA;EAAA,CAAA,CAAA,CAAA,EAAA,MAAA,QAAA,OAAA,SAAA,eAAA,IAAA,EAAA,CAAA;;AAElB,yBAAyB,SAAO;CAAA;CAAM;CAAmB;CAAE;CAAA;CAAA"}

package/dist/helpers/update-package-json.cjs

@@ -56,5 +56,4 @@ updatePackageJsonBinary.__type = [
 
 //#endregion
 exports.formatBinaryPath = formatBinaryPath;
-exports.updatePackageJsonBinary = updatePackageJsonBinary;
-//# sourceMappingURL=update-package-json.cjs.map
+exports.updatePackageJsonBinary = updatePackageJsonBinary;

package/dist/helpers/utilities.cjs

@@ -86,10 +86,10 @@ getGlobalOptions.__type = [
 	() => __ΩRecord,
 	"CommandOption",
 	"getGlobalOptions",
-	"P\"w!2\"\"w#2$&\"w&o%#/'"
+	"Retrieves the global command options based on the context configuration.",
+	"P\"w!2\"\"w#2$&\"w&o%#/'?("
 ];
 
 //#endregion
 exports.formatCommandTree = formatCommandTree;
-exports.getGlobalOptions = getGlobalOptions;
-//# sourceMappingURL=utilities.cjs.map
+exports.getGlobalOptions = getGlobalOptions;

package/dist/helpers/utilities.mjs

@@ -85,7 +85,8 @@ getGlobalOptions.__type = [
 	() => __ΩRecord,
 	"CommandOption",
 	"getGlobalOptions",
-	"P\"w!2\"\"w#2$&\"w&o%#/'"
+	"Retrieves the global command options based on the context configuration.",
+	"P\"w!2\"\"w#2$&\"w&o%#/'?("
 ];
 
 //#endregion

package/dist/helpers/utilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.mjs","names":[],"sources":["../../src/helpers/utilities.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 { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the global command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve global options.\n * @returns A record of global command options.\n */\nexport function getGlobalOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE5D,IAAG,SAAS;;;AAOhB,SAAS,uBAAuB,SAAG;AAClC,QAAU;EACV,MAAa,GAAG,QAAQ,OAAO,QAAQ,YAAA,eAA2B;EAC3D,UAAU,OAAO,OAAO,QAAG,YAAiB,EAAC,CAAA,CAAA,IAAA,uBAAA;;;;;;;;;AAIrD,SAAgB,kBAAkB,SAAS;;EAEpC,MAAO,QAAQ,OAAO;EACrB,UAAC,OAAa,OAAO,QAAW,YAAW,EAAA,CAAA,CAAA,IAAA,uBAAA;EACnD,CAAM;;AAEN,kBAAS,SAAkB;CAAC;CAAQ;CAAc;CAAU;CAAA;;;;;;;;AAQ5D,SAAG,iBAAA,SAAA,SAAA;CACH,IAAA;iDAEO,WAAS,OAAA,YAAkB,YAAS,QAAU,OAAO,eAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;UAElD,WAAc,QAAK,OAAA,cAAA,CACzB,WAAU,OAAO,YAAe,YAAa,QAAO,OAAA,cAAsB,SAAA,QAAA,EAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAK3E,QAAA,OAAc,YAAO,OAAQ,QAAa,QAAQ,CAAA,IAAA,cAAQ,CAAA,KAAa,WAAA,CACzE,KACG;EAAM,GAAA;EAAU,KAAI,MAAM,OAAO,aAAA,IAAA;EAAA,CACjC,EAAA;EAAA;EAAc;EAAE;EAAY,CAAA,CAAA,CAAG;;AAEnC,iBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"utilities.mjs","names":[],"sources":["../../src/helpers/utilities.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 { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the global command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve global options.\n * @returns A record of global command options.\n */\nexport function getGlobalOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE5D,IAAG,SAAS;;;AAOhB,SAAS,uBAAuB,SAAG;AAClC,QAAU;EACV,MAAa,GAAG,QAAQ,OAAO,QAAQ,YAAA,eAA2B;EAC3D,UAAU,OAAO,OAAO,QAAG,YAAiB,EAAC,CAAA,CAAA,IAAA,uBAAA;;;;;;;;;AAIrD,SAAgB,kBAAkB,SAAS;;EAEpC,MAAO,QAAQ,OAAO;EACrB,UAAC,OAAa,OAAO,QAAW,YAAW,EAAA,CAAA,CAAA,IAAA,uBAAA;EACnD,CAAM;;AAEN,kBAAS,SAAkB;CAAC;CAAQ;CAAc;CAAU;CAAA;;;;;;;;AAQ5D,SAAG,iBAAA,SAAA,SAAA;CACH,IAAA;iDAEO,WAAS,OAAA,YAAkB,YAAS,QAAU,OAAO,eAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;UAElD,WAAc,QAAK,OAAA,cAAA,CACzB,WAAU,OAAO,YAAe,YAAa,QAAO,OAAA,cAAsB,SAAA,QAAA,EAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAK3E,QAAA,OAAc,YAAO,OAAQ,QAAa,QAAQ,CAAA,IAAA,cAAQ,CAAA,KAAa,WAAA,CACzE,KACG;EAAM,GAAA;EAAU,KAAI,MAAM,OAAO,aAAA,IAAA;EAAA,CACjC,EAAA;EAAA;EAAc;EAAE;EAAY,CAAA,CAAA,CAAG;;AAEnC,iBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/helpers/validations.cjs

@@ -68,5 +68,4 @@ validateCommand.__type = [
 ];
 
 //#endregion
-exports.validateCommand = validateCommand;
-//# sourceMappingURL=validations.cjs.map
+exports.validateCommand = validateCommand;

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

@@ -37,7 +37,8 @@ function sortArgAliases(aliases) {
 sortArgAliases.__type = [
 	"aliases",
 	"sortArgAliases",
-	"P&F2!&F/\""
+	"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.
@@ -56,7 +57,8 @@ getAppName.__type = [
 	"Context",
 	"context",
 	"getAppName",
-	"PP\"w!\"w\"J2#&/$"
+	"Retrieves the application name from the context and configuration.",
+	"PP\"w!\"w\"J2#&/$?%"
 ];
 /**
 * Retrieves the application title from the context and configuration.
@@ -75,7 +77,8 @@ getAppTitle.__type = [
 	"context",
 	"replaceCLI",
 	"getAppTitle",
-	"PP\"w!\"w\"J2#\"2$&/%"
+	"Retrieves the application title from the context and configuration.",
+	"PP\"w!\"w\"J2#\"2$&/%?&"
 ];
 /**
 * Retrieves the application description from the context and configuration.
@@ -91,7 +94,8 @@ getAppDescription.__type = [
 	"Context",
 	"context",
 	"getAppDescription",
-	"PP\"w!\"w\"J2#&/$"
+	"Retrieves the application description from the context and configuration.",
+	"PP\"w!\"w\"J2#&/$?%"
 ];
 /**
 * Retrieves the primary binary name for the application.
@@ -106,7 +110,8 @@ getAppBin.__type = [
 	"Context",
 	"context",
 	"getAppBin",
-	"P\"w!2\"&/#"
+	"Retrieves the primary binary name for the application.",
+	"P\"w!2\"&/#?$"
 ];
 /**
 * Determines if a given command path segment is variable (enclosed in square brackets).
@@ -126,7 +131,8 @@ function isDynamicPathSegment(path) {
 isDynamicPathSegment.__type = [
 	"path",
 	"isDynamicPathSegment",
-	"P&2!)/\""
+	"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.
@@ -145,7 +151,8 @@ function getDynamicPathSegmentName(path) {
 getDynamicPathSegmentName.__type = [
 	"path",
 	"getDynamicPathSegmentName",
-	"P&2!&/\""
+	"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).
@@ -166,7 +173,8 @@ function isPathSegmentGroup(path) {
 isPathSegmentGroup.__type = [
 	"path",
 	"isPathSegmentGroup",
-	"P&2!)/\""
+	"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.
@@ -186,7 +194,8 @@ function getPathSegmentGroupName(path) {
 getPathSegmentGroupName.__type = [
 	"path",
 	"getPathSegmentGroupName",
-	"P&2!&/\""
+	"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.
@@ -205,7 +214,8 @@ function getPathSegmentName(path) {
 getPathSegmentName.__type = [
 	"path",
 	"getPathSegmentName",
-	"P&2!&/\""
+	"Extracts the variable name from a command path segment by removing enclosing square brackets.",
+	"P&2!&/\"?#"
 ];
 
 //#endregion
@@ -218,5 +228,4 @@ exports.getPathSegmentGroupName = getPathSegmentGroupName;
 exports.getPathSegmentName = getPathSegmentName;
 exports.isDynamicPathSegment = isDynamicPathSegment;
 exports.isPathSegmentGroup = isPathSegmentGroup;
-exports.sortArgAliases = sortArgAliases;
-//# sourceMappingURL=context-helpers.cjs.map
+exports.sortArgAliases = sortArgAliases;

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

@@ -36,7 +36,8 @@ function sortArgAliases(aliases) {
 sortArgAliases.__type = [
 	"aliases",
 	"sortArgAliases",
-	"P&F2!&F/\""
+	"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.
@@ -55,7 +56,8 @@ getAppName.__type = [
 	"Context",
 	"context",
 	"getAppName",
-	"PP\"w!\"w\"J2#&/$"
+	"Retrieves the application name from the context and configuration.",
+	"PP\"w!\"w\"J2#&/$?%"
 ];
 /**
 * Retrieves the application title from the context and configuration.
@@ -74,7 +76,8 @@ getAppTitle.__type = [
 	"context",
 	"replaceCLI",
 	"getAppTitle",
-	"PP\"w!\"w\"J2#\"2$&/%"
+	"Retrieves the application title from the context and configuration.",
+	"PP\"w!\"w\"J2#\"2$&/%?&"
 ];
 /**
 * Retrieves the application description from the context and configuration.
@@ -90,7 +93,8 @@ getAppDescription.__type = [
 	"Context",
 	"context",
 	"getAppDescription",
-	"PP\"w!\"w\"J2#&/$"
+	"Retrieves the application description from the context and configuration.",
+	"PP\"w!\"w\"J2#&/$?%"
 ];
 /**
 * Retrieves the primary binary name for the application.
@@ -105,7 +109,8 @@ getAppBin.__type = [
 	"Context",
 	"context",
 	"getAppBin",
-	"P\"w!2\"&/#"
+	"Retrieves the primary binary name for the application.",
+	"P\"w!2\"&/#?$"
 ];
 /**
 * Determines if a given command path segment is variable (enclosed in square brackets).
@@ -125,7 +130,8 @@ function isDynamicPathSegment(path) {
 isDynamicPathSegment.__type = [
 	"path",
 	"isDynamicPathSegment",
-	"P&2!)/\""
+	"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.
@@ -144,7 +150,8 @@ function getDynamicPathSegmentName(path) {
 getDynamicPathSegmentName.__type = [
 	"path",
 	"getDynamicPathSegmentName",
-	"P&2!&/\""
+	"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).
@@ -165,7 +172,8 @@ function isPathSegmentGroup(path) {
 isPathSegmentGroup.__type = [
 	"path",
 	"isPathSegmentGroup",
-	"P&2!)/\""
+	"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.
@@ -185,7 +193,8 @@ function getPathSegmentGroupName(path) {
 getPathSegmentGroupName.__type = [
 	"path",
 	"getPathSegmentGroupName",
-	"P&2!&/\""
+	"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.
@@ -204,7 +213,8 @@ function getPathSegmentName(path) {
 getPathSegmentName.__type = [
 	"path",
 	"getPathSegmentName",
-	"P&2!&/\""
+	"Extracts the variable name from a command path segment by removing enclosing square brackets.",
+	"P&2!&/\"?#"
 ];
 
 //#endregion

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;;AAE5B,QAAO;;;;;;;;AA6BX,SAAc,eAAc,SAAA;AACxB,KAAA,QAAS,WAAA,EACX,QAAA,EAAA;CAEA,MAAM,SAAS,QAAQ,OAAO,cAAe,UAAS,MAAI,WAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;AAC1D,QAAO,KAAO,GAAC,QAAQ,OAAO,cAAe,UAAS,MAAG,SAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;;;;;;;AAG3D,eAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQA,SAAE,WAAA,SAAA;CACF,MAAO,SAAS,QAAW,OAAO,SAC1B,YAAO,QAAA,OAAA,IAAA,IACH,MAAO,QAAM,QAAA,OAAA,IAAA,IACT,QAAQ,OAAO,IAAI,SAAG,KAC3B,YAAgB,QAAO,OAAM,IAAA,GAAA,GAC1B,YAAW,QAAS,OAAG,IAAA,GACnB,QAAQ,OAAO,MACzB,QAAY,OAAQ,IAAO,KACzB,QAAQ,aAAO;AACrB,KAAI,CAAC,YAAS,OAAU,CACpB,OAAA,IAAQ,MAAA,qIAAkB;AAE9B,QAAM,UAAS,OAAA;;AAEnB,WAAK,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQL,SAAC,YAAA,SAAA,aAAA,OAAA;CACG,MAAM,QAAQ,QAAM,OAAM,SAC1B,UAAM,QAAa,OAAU,QAAQ,WAAK,QAAc,CAAA;AACxD,SAAQ,aACV,MAAA,QAAA,gFAAA,GAAA,GACK,OAAS,MAAA;;AAEhB,YAAY,SAAG;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOf,SAAI,kBAAA,SAAA;AACA,QAAI,QAAM,OAAO,eACb,QAAM,aAAY,eAClB,OAAG,YAAA,SAAA,KAAA,CAAA;;AAEX,kBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOR,SAAU,UAAc,SAAM;AAC1B,QAAO,YAAK,QAAY,OAAA,IAAW,GACrC,OAAA,KAAA,QAAA,OAAA,IAAA,CAAA,KACK,UAAS,WAAA,QAAiB,CAAA;;AAEjC,UAAU,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;AAaV,SAAE,qBAAA,MAAA;AACF,QAAO,KAAS,WAAU,IAAA,IAAS,KAAA,SAAU,IAAO;;AAEpD,qBAAkB,SAAQ;CAAA;CAAa;CAAC;CAAA;;;;;;;;;;;;AAYxC,SAAC,0BAAA,MAAA;AACG,QAAM,KAAM,WAAK,SAAa,GAAA,CAAA,WAAgB,SAAA,GAAA;;AAElD,0BAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAcF,SAAgB,mBAAc,MAAQ;AACpC,QAAA,KAAA,WAAA,IAAA,IAAA,KAAA,SAAA,IAAA,IAAA,KAAA,WAAA,IAAA;;AAEF,mBAAc,SAAc;CAAC;CAAQ;CAAsB;CAAE;;;;;;;;;;;;;AAa7D,SAAgB,wBAAkB,MAAW;AACzC,QAAO,KACT,WAAA,SAAA,GAAA,CACK,WAAS,SAAA,GAAA,CACP,WAAM,QAAa,GAAG;;;;;;;;;;;;;;;;;;AAc/B,SAAE,mBAAA,MAAA;AACF,QAAO,wBAAS,0BAA6C,KAAC,CAAA;;AAE9D,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"context-helpers.mjs","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type { Context, UnresolvedContext } from \"../types\";\n\n/**\n * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.\n *\n * @param aliases - An array of argument aliases to sort.\n * @returns A new array of sorted aliases.\n */\nexport function sortArgAliases(aliases: string[]): string[] {\n  if (aliases.length === 0) {\n    return [];\n  }\n\n  const result = aliases.filter(alias => alias.length === 1);\n  result.push(...aliases.filter(alias => alias.length > 1));\n\n  return result.sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Retrieves the application name from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application name in kebab-case format.\n * @throws An error if no valid application name is found.\n */\nexport function getAppName(context: UnresolvedContext | Context): string {\n  const result =\n    context.config.name ||\n    (isSetString(context.config.bin) ||\n    (Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0 &&\n      isSetString(context.config.bin[0]))\n      ? isSetString(context.config.bin)\n        ? context.config.bin\n        : context.config.bin[0]\n      : context.packageJson?.name);\n  if (!isSetString(result)) {\n    throw new Error(\n      \"No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.\"\n    );\n  }\n\n  return kebabCase(result);\n}\n\n/**\n * Retrieves the application title from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(\n  context: UnresolvedContext | Context,\n  replaceCLI = false\n): string {\n  const title =\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context));\n\n  return (\n    replaceCLI\n      ? title.replace(\n          /(?:cli|command-line|command line)\\s*(?:interface\\s*)?(?:application|app)?$/gi,\n          \"\"\n        )\n      : title\n  ).trim();\n}\n\n/**\n * Retrieves the application description from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application description.\n */\nexport function getAppDescription(\n  context: UnresolvedContext | Context\n): string {\n  return (\n    context.config.description ||\n    context.packageJson?.description ||\n    `The ${getAppTitle(context, true)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return (path.startsWith(\"(\") && path.endsWith(\")\")) || path.startsWith(\"_\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path\n    .replaceAll(/^\\(+/g, \"\")\n    .replaceAll(/\\)+$/g, \"\")\n    .replaceAll(/^_+/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\n}\n"],"mappings":";;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA6BX,SAAc,eAAc,SAAA;AACxB,KAAA,QAAS,WAAA,EACX,QAAA,EAAA;CAEA,MAAM,SAAS,QAAQ,OAAO,cAAe,UAAS,MAAI,WAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;AAC1D,QAAO,KAAO,GAAC,QAAQ,OAAO,cAAe,UAAS,MAAG,SAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;;;;;;;AAG3D,eAAA,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQA,SAAE,WAAA,SAAA;CACF,MAAO,SAAS,QAAW,OAAO,SAC1B,YAAO,QAAA,OAAA,IAAA,IACH,MAAO,QAAM,QAAA,OAAA,IAAA,IACT,QAAQ,OAAO,IAAI,SAAG,KAC3B,YAAgB,QAAO,OAAM,IAAA,GAAA,GAC1B,YAAW,QAAS,OAAG,IAAA,GACnB,QAAQ,OAAO,MACzB,QAAY,OAAQ,IAAO,KACzB,QAAQ,aAAO;AACrB,KAAI,CAAC,YAAS,OAAU,CACpB,OAAA,IAAQ,MAAA,qIAAkB;AAE9B,QAAM,UAAS,OAAA;;AAEnB,WAAK,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQL,SAAC,YAAA,SAAA,aAAA,OAAA;CACG,MAAM,QAAQ,QAAM,OAAM,SAC1B,UAAM,QAAa,OAAU,QAAQ,WAAK,QAAc,CAAA;AACxD,SAAQ,aACV,MAAA,QAAA,gFAAA,GAAA,GACK,OAAS,MAAA;;AAEhB,YAAY,SAAG;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOf,SAAI,kBAAA,SAAA;AACA,QAAI,QAAM,OAAO,eACb,QAAM,aAAY,eAClB,OAAG,YAAA,SAAA,KAAA,CAAA;;AAEX,kBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOR,SAAU,UAAc,SAAM;AAC1B,QAAO,YAAK,QAAY,OAAA,IAAW,GACrC,OAAA,KAAA,QAAA,OAAA,IAAA,CAAA,KACK,UAAS,WAAA,QAAiB,CAAA;;AAEjC,UAAU,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;AAaV,SAAE,qBAAA,MAAA;AACF,QAAO,KAAS,WAAU,IAAA,IAAS,KAAA,SAAU,IAAO;;AAEpD,qBAAkB,SAAQ;CAAA;CAAa;CAAC;CAAA;CAAA;;;;;;;;;;;;AAYxC,SAAC,0BAAA,MAAA;AACG,QAAM,KAAM,WAAK,SAAa,GAAA,CAAA,WAAgB,SAAA,GAAA;;AAElD,0BAAE,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAcF,SAAgB,mBAAc,MAAQ;AACpC,QAAA,KAAA,WAAA,IAAA,IAAA,KAAA,SAAA,IAAA,IAAA,KAAA,WAAA,IAAA;;AAEF,mBAAc,SAAc;CAAC;CAAQ;CAAsB;CAAE;CAAA;;;;;;;;;;;;;AAa7D,SAAgB,wBAAkB,MAAW;AACzC,QAAO,KACT,WAAA,SAAA,GAAA,CACK,WAAS,SAAA,GAAA,CACP,WAAM,QAAa,GAAG;;;;;;;;;;;;;;;;;;;AAc/B,SAAE,mBAAA,MAAA;AACF,QAAO,wBAAS,0BAA6C,KAAC,CAAA;;AAE9D,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/deepkit.cjs

@@ -23,9 +23,9 @@ extractReflectionKind.__type = [
 	"CommandParameterKind",
 	"command",
 	"checkVariadic",
-	() => _powerlines_deepkit_vendor_type.__ΩReflectionKind,
 	"extractReflectionKind",
-	"PP\"w!\"w\"J2#\"2$n%/&"
+	"Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.",
+	"PP\"w!\"w\"J2#\"2$!/%?&"
 ];
 /**
 * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
@@ -61,12 +61,11 @@ extractType.__type = [
 	"CommandParameterKind",
 	"command",
 	"checkVariadic",
-	"Type",
 	"extractType",
-	"PP\"w!\"w\"J2#\"2$\"w%/&"
+	"Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.",
+	"PP\"w!\"w\"J2#\"2$!/%?&"
 ];
 
 //#endregion
 exports.extractReflectionKind = extractReflectionKind;
-exports.extractType = extractType;
-//# sourceMappingURL=deepkit.cjs.map
+exports.extractType = extractType;

package/dist/plugin-utils/deepkit.mjs

@@ -1,7 +1,7 @@
 import { CommandParameterKinds } from "../types/command.mjs";
 import { isCommandParameterKind } from "./type-checks.mjs";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
-import { ReflectionKind, __ΩReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 
 //#region src/plugin-utils/deepkit.ts
 /**
@@ -22,9 +22,9 @@ extractReflectionKind.__type = [
 	"CommandParameterKind",
 	"command",
 	"checkVariadic",
-	() => __ΩReflectionKind,
 	"extractReflectionKind",
-	"PP\"w!\"w\"J2#\"2$n%/&"
+	"Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.",
+	"PP\"w!\"w\"J2#\"2$!/%?&"
 ];
 /**
 * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.
@@ -60,9 +60,9 @@ extractType.__type = [
 	"CommandParameterKind",
 	"command",
 	"checkVariadic",
-	"Type",
 	"extractType",
-	"PP\"w!\"w\"J2#\"2$\"w%/&"
+	"Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.",
+	"PP\"w!\"w\"J2#\"2$!/%?&"
 ];
 
 //#endregion