@shell-shock/core 0.17.2 → 0.17.3

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

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

@@ -1 +1 @@
-{"version":3,"file":"deepkit.mjs","names":[],"sources":["../../src/plugin-utils/deepkit.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Type } from \"@powerlines/deepkit/vendor/type\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  BaseCommandParameter,\n  CommandParameterKind,\n  StringCommandParameter\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport { isCommandParameterKind } from \"./type-checks\";\n\n/**\n * Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.\n *\n * @param command - The command parameter or kind to extract the reflection kind from.\n * @param checkVariadic - Whether to check for variadic parameters (arrays).\n * @returns The extracted {@link ReflectionKind}.\n */\nexport function extractReflectionKind(\n  command: BaseCommandParameter | CommandParameterKind,\n  checkVariadic = true\n): ReflectionKind {\n  if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.string) ||\n    (isSetObject(command as BaseCommandParameter) &&\n      (command as BaseCommandParameter).kind === CommandParameterKinds.string)\n  ) {\n    return checkVariadic && (command as StringCommandParameter).variadic\n      ? ReflectionKind.array\n      : ReflectionKind.string;\n  } else if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.number) ||\n    (isSetObject(command as BaseCommandParameter) &&\n      (command as BaseCommandParameter).kind === CommandParameterKinds.number)\n  ) {\n    return checkVariadic && (command as any).variadic\n      ? ReflectionKind.array\n      : ReflectionKind.number;\n  } else if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.boolean) ||\n    (isSetObject(command) && command.kind === CommandParameterKinds.boolean)\n  ) {\n    return ReflectionKind.boolean;\n  } else {\n    return ReflectionKind.string;\n  }\n}\n\n/**\n * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.\n *\n * @param command - The command parameter or kind to extract the type from.\n * @param checkVariadic - Whether to check for variadic parameters (arrays).\n * @returns The extracted {@link Type}.\n */\nexport function extractType(\n  command: BaseCommandParameter | CommandParameterKind,\n  checkVariadic = true\n): Type {\n  const reflectionKind = extractReflectionKind(command, checkVariadic);\n  if (reflectionKind === ReflectionKind.string) {\n    return { kind: ReflectionKind.string };\n  } else if (reflectionKind === ReflectionKind.number) {\n    return { kind: ReflectionKind.number };\n  } else if (reflectionKind === ReflectionKind.boolean) {\n    return { kind: ReflectionKind.boolean };\n  } else if (reflectionKind === ReflectionKind.array) {\n    if (isCommandParameterKind(command)) {\n      return {\n        kind: ReflectionKind.array,\n        type: extractType(\n          {\n            kind: command\n          } as BaseCommandParameter,\n          false\n        )\n      };\n    } else if (isSetObject(command)) {\n      return {\n        kind: ReflectionKind.array,\n        type: extractType(\n          {\n            ...command,\n            kind: command.kind\n          } as BaseCommandParameter,\n          false\n        )\n      };\n    } else {\n      return {\n        kind: ReflectionKind.array,\n        type: { kind: ReflectionKind.string }\n      };\n    }\n  } else {\n    return { kind: ReflectionKind.string };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAcC,KAAK,uBAAqB,QAAS,gDAE3B,YAAY,QAAQ,kDAEtB,QAAO,iBAAc,QAAW,WAC9B,eAAiB,QACjB,eAAoB;UAE3B,uBAAoB,QAAA,IACpB,YAAA,sBAAoB,UACpB,YAAA,QAAA,IACS,QAAM,SAAQ,sBAAA,OACjB,QAAC,iBAAuB,QAAQ,WAC/B,eAAA;UAGK,uBAAuB,QAAQ,IAC5C,YAAA,sBAAA,WACQ,YAAW,QAAI,IAAQ,QAAS,SAAS,sBAAe,QAC7D,QAAM,eAAgB;KAGnB,QAAQ,eAAC;;AAGhB,sBAAkB,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;;AAQlB,SAAQ,YAAe,SAAA,gBAAA,MAAA;CACnB,MAAI,iBAAe,sBAAM,SAAA,cAAA;AACzB,KAAI,mBAAI,eAAA,OACP,QAAA,EAAA,MAAA,eAAiC,QAAA;UAEjC,mBAAuB,eAAA,OACrB,QAAQ,EAAE,MAAC,eAAoB,QAAQ;UAEnC,mBAAkB,eAAgB,QACrC,QAAA,EAAA,MAAe,eAAA,SAAA;UAEX,mBAAA,eAAA,MACP,KAAA,uBAA8B,QAAG,CAChC,QAAY;EACF,MAAC,eAAoB;EACjC,MAAA,YAAA,EACO,MAAe,SACjB,EAAA,MAAA;EACE;UAEX,YAAA,QAAA;EAEE,MAAA,eAAA;EACc,MAAK,YAAa;GACjC,GAAA;GACmB,MAAI,QAAQ;GACtB,EAAA,MAAe;EACb;KAGD,QAAA;EACK,MAAE,eAAA;EACV,MAAA,EAAA,MAAA,eAAA,QAAA;EACA;KAIJ,QAAS,EAAI,MAAE,eAAe,QAAQ;;AAG1C,YAAY,SAAC;CAAA;CAAiC;CAAQ;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"deepkit.mjs","names":[],"sources":["../../src/plugin-utils/deepkit.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Type } from \"@powerlines/deepkit/vendor/type\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  BaseCommandParameter,\n  CommandParameterKind,\n  StringCommandParameter\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport { isCommandParameterKind } from \"./type-checks\";\n\n/**\n * Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.\n *\n * @param command - The command parameter or kind to extract the reflection kind from.\n * @param checkVariadic - Whether to check for variadic parameters (arrays).\n * @returns The extracted {@link ReflectionKind}.\n */\nexport function extractReflectionKind(\n  command: BaseCommandParameter | CommandParameterKind,\n  checkVariadic = true\n): ReflectionKind {\n  if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.string) ||\n    (isSetObject(command as BaseCommandParameter) &&\n      (command as BaseCommandParameter).kind === CommandParameterKinds.string)\n  ) {\n    return checkVariadic && (command as StringCommandParameter).variadic\n      ? ReflectionKind.array\n      : ReflectionKind.string;\n  } else if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.number) ||\n    (isSetObject(command as BaseCommandParameter) &&\n      (command as BaseCommandParameter).kind === CommandParameterKinds.number)\n  ) {\n    return checkVariadic && (command as any).variadic\n      ? ReflectionKind.array\n      : ReflectionKind.number;\n  } else if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.boolean) ||\n    (isSetObject(command) && command.kind === CommandParameterKinds.boolean)\n  ) {\n    return ReflectionKind.boolean;\n  } else {\n    return ReflectionKind.string;\n  }\n}\n\n/**\n * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.\n *\n * @param command - The command parameter or kind to extract the type from.\n * @param checkVariadic - Whether to check for variadic parameters (arrays).\n * @returns The extracted {@link Type}.\n */\nexport function extractType(\n  command: BaseCommandParameter | CommandParameterKind,\n  checkVariadic = true\n): Type {\n  const reflectionKind = extractReflectionKind(command, checkVariadic);\n  if (reflectionKind === ReflectionKind.string) {\n    return { kind: ReflectionKind.string };\n  } else if (reflectionKind === ReflectionKind.number) {\n    return { kind: ReflectionKind.number };\n  } else if (reflectionKind === ReflectionKind.boolean) {\n    return { kind: ReflectionKind.boolean };\n  } else if (reflectionKind === ReflectionKind.array) {\n    if (isCommandParameterKind(command)) {\n      return {\n        kind: ReflectionKind.array,\n        type: extractType(\n          {\n            kind: command\n          } as BaseCommandParameter,\n          false\n        )\n      };\n    } else if (isSetObject(command)) {\n      return {\n        kind: ReflectionKind.array,\n        type: extractType(\n          {\n            ...command,\n            kind: command.kind\n          } as BaseCommandParameter,\n          false\n        )\n      };\n    } else {\n      return {\n        kind: ReflectionKind.array,\n        type: { kind: ReflectionKind.string }\n      };\n    }\n  } else {\n    return { kind: ReflectionKind.string };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AA6BE,KAAA,uBAAA,QAAA,IACC,YAAiB,sBAAsB,UACzC,YAAA,QAAA,IACS,QAAU,SAAI,sBAA0B,OAC9C,QAAM,iBAAgB,QAAW,WACzB,eAAgB,QAC1B,eAAA;UAES,uBAAuB,QAAA,IAChC,YAAgB,sBAAA,UACf,YAAe,QAAA,IACb,QAAA,SAAA,sBAAA,OACA,QAAA,iBAAuB,QAAU,WACxB,eAAI,QACb,eAAuB;UAExB,uBAAA,QAAA,IACA,YAAO,sBAA6B,WAChC,YAAA,QAAe,IAAA,QAAA,SAAA,sBAAA,QACf,QAAA,eAAqB;KAGvB,QAAS,eAAG;;AAGlB,sBAAI,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQJ,SAAI,YAAA,SAAA,gBAAA,MAAA;CACA,MAAM,iBAAgB,sBAAO,SAAA,cAAA;AAC7B,KAAI,mBAAC,eAAA,OACL,QAAO,EAAA,MAAA,eAAqB,QAAA;UAEhC,mBAAA,eAAA;UAGa,mBAAmB,eAAS,QACxC,QAAA,EAAA,MAAA,eAAA,SAAA;UAES,mBAAgB,eAAqB,MAC3C,KAAQ,uBAAqB,QAAK,CACpC,QAAA;EACc,MAAA,eAAW;EAChB,MAAA,YAAuB,EAChB,MAAA,SACV,EAAA,MAAA;EACA;UAES,YAAE,QAAe,CACtB,QAAC;EACA,MAAM,eAAe;EACrB,MAAA,YAAmB;GACb,GAAA;GACN,MAAA,QAAmB;GACxB,EAAA,MAAA;EACK;KAGH,QAAA;EACM,MAAE,eAAA;EACH,MAAA,EAAA,MAAA,eAAoB,QAAA;EACzB;KAIJ,QAAO,EAAA,MAAA,eAAA,QAAA;;AAGb,YAAU,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

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

@@ -3,9 +3,11 @@
 const __ΩFormatDescriptionOptions = [
 	"replaceNewlines",
 	true,
+	"If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.",
 	"collapseWhitespace",
+	"If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.",
 	"FormatDescriptionOptions",
-	"P)4!8>\")4#8>\"Mw$y"
+	"P)4!8>\"?#)4$8>\"?%Mw&y"
 ];
 /**
 * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
@@ -28,7 +30,8 @@ formatDescriptionWhitespace.__type = [
 	"options",
 	() => ({}),
 	"formatDescriptionWhitespace",
-	"P&2!n\"2#>$&/%"
+	"Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.",
+	"P&2!n\"2#>$&/%?&"
 ];
 /**
 * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
@@ -45,7 +48,8 @@ function formatDescriptionEscapes(description) {
 formatDescriptionEscapes.__type = [
 	"description",
 	"formatDescriptionEscapes",
-	"P&2!&/\""
+	"Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.",
+	"P&2!&/\"?#"
 ];
 /**
 * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
@@ -65,14 +69,16 @@ formatDescription.__type = [
 	"options",
 	() => ({}),
 	"formatDescription",
-	"P&2!n\"2#>$&/%"
+	"Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.",
+	"P&2!n\"2#>$&/%?&"
 ];
 const __ΩFormatShortDescriptionOptions = [
 	() => __ΩFormatDescriptionOptions,
 	"length",
 	62,
+	"The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.",
 	"FormatShortDescriptionOptions",
-	"Pn!'4\"8>#Mw$y"
+	"Pn!'4\"8>#?$Mw%y"
 ];
 /**
 * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.
@@ -94,12 +100,12 @@ formatShortDescription.__type = [
 	"options",
 	() => ({}),
 	"formatShortDescription",
-	"P&2!n\"2#>$&/%"
+	"Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.",
+	"P&2!n\"2#>$&/%?&"
 ];
 
 //#endregion
 exports.__ΩFormatDescriptionOptions = __ΩFormatDescriptionOptions;
 exports.__ΩFormatShortDescriptionOptions = __ΩFormatShortDescriptionOptions;
 exports.formatDescription = formatDescription;
-exports.formatShortDescription = formatShortDescription;
-//# sourceMappingURL=description-helpers.cjs.map
+exports.formatShortDescription = formatShortDescription;