@shell-shock/core 0.17.2 → 0.17.4

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

@@ -1 +0,0 @@
-{"version":3,"file":"description-helpers.cjs","names":[],"sources":["../../src/plugin-utils/description-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface FormatDescriptionOptions {\n  /**\n   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.\n   *\n   * @defaultValue false\n   */\n  replaceNewlines?: boolean;\n\n  /**\n   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.\n   *\n   * @defaultValue false\n   */\n  collapseWhitespace?: boolean;\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionWhitespace(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  let formattedDescription = description.trim();\n  if (options.replaceNewlines) {\n    formattedDescription = formattedDescription.replace(/\\s*\\n\\s*/g, \" \");\n  }\n  if (options.collapseWhitespace) {\n    formattedDescription = formattedDescription.replace(/\\s{2,}/g, \" \");\n  }\n\n  return formattedDescription.trim();\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionEscapes(description: string): string {\n  return description\n    .replaceAll(\"'\", \"\\\\'\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"`\", \"\\\\`\")\n    .replace(/\\$\\{/g, \"\\\\${\");\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nexport function formatDescription(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  return formatDescriptionEscapes(\n    formatDescriptionWhitespace(description, options)\n  );\n}\n\nexport interface FormatShortDescriptionOptions extends FormatDescriptionOptions {\n  /**\n   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.\n   *\n   * @defaultValue 62\n   */\n  length?: number;\n}\n\n/**\n * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.\n *\n * @param description - The full description string.\n * @param options - Options for formatting the short description, including the maximum length.\n * @returns The extracted short description.\n */\nexport function formatShortDescription(\n  description: string,\n  options: FormatShortDescriptionOptions = {}\n): string {\n  const length = options.length ?? 62;\n  const formattedDescription = formatDescriptionWhitespace(\n    description,\n    options\n  );\n\n  const firstSentenceMatch =\n    formattedDescription.indexOf(\"\\n\") < length - 3 ||\n    formattedDescription.search(/[.!?\\n]\\s*\\S/) > length - 3\n      ? formattedDescription\n          .match(/^.*[.!?\\n]\\s?\\S/)?.[0]\n          ?.trim()\n          ?.slice(0, -1)\n          ?.trim()\n      : undefined;\n\n  let result = (firstSentenceMatch || formattedDescription).trim();\n  if (result.trim().length > length) {\n    result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;\n  }\n\n  return formatDescriptionEscapes(result);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA4BA,SAAG,4BAAA,aAAA,UAAA,EAAA,EAAA;CACC,IAAE,uBAAa,YAAA,MAAA;AACf,KAAA,QAAA,gBACF,wBAA4B,qBAAA,QAAA,aAAA,IAAA;gCAG5B,wBAAA,qBAAA,QAAA,WAAA,IAAA;AAED,QAAA,qBAAA,MAAA;;AAED,4BAAsB,SAAc;CAAA;OAAiB;CAAgC;QAAqB,EAAE;CAAC;CAAa;CAAA;;;;;;;;;;AAU1H,SAAM,yBAAyB,aAAA;AAC3B,QAAA,YACF,WAAA,KAAA,MAAA,CACI,WAAQ,MAAA,OAAA,CACV,WAAA,KAAqB,MAAE,CACzB,QAAA,SAAA,OAAA;;AAEF,yBAAS,SAAyB;CAAC;CAAC;CAAA;CAAA;;;;;;;;;;AAUpC,SAAgB,kBAAU,aAAkB,UAAA,EAAA,EAAA;AAC1C,QAAA,yBAAA,4BAAA,aAAA,QAAA,CAAA;;AAEF,kBAAS,SAAA;CAAA;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA;AACT,MAAK,mCAAqB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAS1B,SAAI,uBAAA,aAAA,UAAA,EAAA,EAAA;CACD,MAAO,SAAQ,QAAI,UAAc;CACnC,MAAA,uBAAA,4BAAA,aAAA,QAAA;CASG,IAAA,WARwB,qBAAuB,QAAA,KAAA,GAAA,SAAA,KAC/C,qBAAsB,OAAA,eAAkB,GAAA,SAAA,IAC1C,qBACK,MAAS,kBAAiB,GAAA,IACnB,MAAC,EACJ,MAAA,GAAA,GAAA,EACD,MAAA,GACD,WACuB,sBAAoB,MAAA;AACjD,KAAA,OAAA,MAAA,CAAA,SAAA,OACH,UAAA,GAAA,OAAA,UAAA,GAAA,KAAA,IAAA,GAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA;AAEA,QAAO,yBAAU,OAAA;;AAEjB,uBAAuB,SAAQ;CAAA;OAAsB;CAAgC;QAAmB,EAAA;CAAA;CAAS;CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"get-command-tree.cjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\nimport { traverseCommands } from \"./traverse-command-tree\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n\n/**\n * Retrieves a list of all command trees defined in the context.\n *\n * @param context - The build context containing the command definitions.\n * @returns A promise that resolves to an array of all command trees in the context.\n */\nexport async function getCommandList(context: Context): Promise<CommandTree[]> {\n  const commandList: CommandTree[] = [];\n  await traverseCommands(context, commandTree => {\n    commandList.push(commandTree);\n  });\n\n  return commandList;\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;;AAYV,KAAK,KAAO,WAAW;;AAIxB,KAAO,KAAM,SAAC,GAAW;EAClB,MAAO,WAAU,KACf,MAAA,EAAA,CACA,OAAA,cAAwB,YAAW,CAAC,6CAAa,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAExD,KAAA,aAAA,YACa,OAAQ,UAAS,eAAc,KAAI,YAAa,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAIrB,QAAS;;AAEX,eAAW,SAAa;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOzB,eAAc,eAAA,SAAA;CACV,MAAG,cAAiB,EAAE;AACtB,OAAK,+CAAiB,SAAU,cAAA,gBAAA;AAC5B,cAAC,KAAA,YAAA;IACF;EAAC;EAAa;EAAA;EAAU,CAAA,CAAA;AAC3B,QAAI;;AAER,eAAQ,SAAc;CAAA;CAAY;CAAS;CAAgB;CAAA;CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"reflect.cjs","names":[],"sources":["../../src/plugin-utils/reflect.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandOption } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(\n      arg => arg.kind !== CommandParameterKinds.boolean || !arg.isNegativeOf\n    )\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === CommandParameterKinds.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a =>\n            a.kind === CommandParameterKinds.boolean &&\n            a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AASX,SAAgB,YAAW,SAAQ;AAClC,KAAO,CAAC,WAAW,QAAO,WAAQ;gBAI1B,OAAO,cAAa,QAAO,IAAI,SAAS,4CAAqB,WAAA,CAAA,IAAA,cAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;;;;;KAE/D,OAAO,cAAgB,KAAK,QAAI;AAC/B,MAAC,KAAA,IAAA;;GAGD,MAAQ,cAAQ,QAAe,KAAG,cAAc,MAAO,EAAC,SAAQ,4CAAe,WACtF,EAAA,iBAAA,IAAA,MAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;AACS,OAAA,YACI,KAAI,KAAM,YAAU;;AAG3B,SAAQ;IACX;EAAA;EAAS;EAAA;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"traverse-command-tree.cjs","names":[],"sources":["../../src/plugin-utils/traverse-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AAQX,eAAsB,oBAAoB,aAAU,SAAS;AAC5D,KAAA,CAAA,YAAoB,SACb;AAEP,OAAK,QAAQ,IAAA,OAAa,OAAS,YAAA,SAAA,CAAA,IAAA,aAAA,OAAA,cAAA;;AAE5B,QAAM,oBAAoB,WAAW,QAAQ;;;;;;;AAGrD,oBAAc,SAAc;CAAA;CAAe;CAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOnD,eAAoB,iBAAY,SAAY,SAAa;AACvD,KAAA,CAAA,QAAA,SACK;AAEL,OAAQ,QAAQ,IAAA,OAAW,OAAK,QAAA,SAAiB,CAAA,IAAA,aAAA,OAAA,cAAA;AAChD,QAAQ,QAAM,QAAA,QAAA,UAAA,CAAA;AACV,QAAA,oBAAsB,WAAA,QAAA;IACzB;EAAA;EAAM;EAAA;EAAA,CAAA,CAAA,CAAA"}

package/dist/plugin-utils/type-checks.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-checks.cjs","names":[],"sources":["../../src/plugin-utils/type-checks.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 { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":";;;;;;;;;;;;;AA2BA,SAAgB,uBAAS,KAAA;AACzB,2DAAS,IAAA;EAEP,4CAAA;EACM,4CAA0B;EACjC,4CAAA;EACQ,CAAC,SAAS,IAAC;;AAEpB,uBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,SAAM,yBAAsB,KAAA;AACxB,2DAAkB,IAAA,IAAA,UAAA,OAAoB,uBAAA,IAAA,KAAA;;AAE1C,yBAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOA,SAAE,mBAAA,KAAA;AACF,QAAO,yBAAS,IAAwB,IACjC,UAAA,0DACG,IAAA,KAAA,IACF,WAAC,0DACT,IAAA,MAAA,+EAEE,IAAA,YAAA,IACM,WAAS,OAChB,MAAA,QAAA,IAAA,MAAA,IACG,SAAY,2DACI,IAAI,IAAK,IAAI,IAAE,QAAQ,UACzC,cAAA,qDACc,IAAA,SAAA,IACR,cAAC,qDACL,IAAA,SAAyB;;AAE7B,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA;;;;;;;AAO3B,SAAgB,gBAAE,KAAA;AACd,QAAC,yBAAgC,IAAI,IAAA,mBAAQ,IAAA,IAAA,aAAA;;AAEjD,gBAAc,SAAI;CAAQ;CAAG;CAAA;CAAA;;;;;;;AAO7B,SAAgB,kBAAkB,KAAK;AACtC,QAAA,yBAAA,IAAA,IAAA,mBAAA,IAAA;;AAED,kBAAiB,SAAO;CAAA;CAAW;CAAa;CAAe"}

package/dist/plugin.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.cjs","names":[],"sources":["../src/plugin.tsx"],"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 { For, Show } from \"@alloy-js/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { ExecBuiltin } from \"./components/exec-builtin\";\nimport { StateBuiltin } from \"./components/state-builtin\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  findCommandsRoot,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/paths\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getGlobalOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport { resolve } from \"./resolver/resolve\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n): Plugin<TContext>[] => {\n  return [\n    tsdown<TContext>(),\n    automd<TContext>(),\n    {\n      name: \"shell-shock:config\",\n      async config() {\n        this.debug(\"Resolving the Shell Shock configuration.\");\n\n        await updatePackageJsonBinary(this);\n\n        const result = defu(\n          {\n            output: {\n              path: joinPaths(this.config.root, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            platform: \"node\",\n            projectType: \"application\",\n            framework: \"shell-shock\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: false\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"],\n              skipNodeModulesBundle: true\n            },\n            tsdown: {\n              dts: false,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\n        );\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          if (isSetString(this.config.reference)) {\n            if (this.config.reference.includes(\"{command}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{command}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else {\n              this.config.reference = {\n                app: this.config.reference\n              };\n            }\n          }\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getGlobalOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n\n          this.options = this.options.map(\n            option =>\n              ({\n                ...option,\n                name: camelCase(option.name),\n                alias: option.alias ?? [],\n                optional: option.optional ?? false\n              }) as CommandOption\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              tags: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <StateBuiltin />\n            <UtilsBuiltin />\n            <ExecBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${\n                          command.name\n                        } \\n\\nPlease ensure ${\n                          command.entry.file\n                        } is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          tags: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : replacePath(command.entry.file, this.config.root)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:resolve-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping command resolution as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await resolve({\n                context: this,\n                command: input\n              });\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.tsdown.hooks ??= {} as TsdownHooks;\n        (this.config.tsdown.hooks as TsdownHooks)[\"build:done\"] = async (\n          _: BuildContext & {\n            chunks: RolldownChunk[];\n          }\n        ) => {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(this.workspaceConfig.workspaceRoot, this.config.root)\n              );\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding hashbang to binary executable output file: ${path}`\n                );\n\n                const content = await this.fs.read(path);\n                if (content && !content.startsWith(\"#!\")) {\n                  await this.fs.write(\n                    path,\n                    `#!/usr/bin/env ${\n                      this.config.mode === \"development\"\n                        ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                        : \"\"\n                    } node\\n\\n${content}`\n                  );\n                }\n\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${\n                    path\n                  }`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Expected binary output file not found at path: ${\n                    path\n                  }. Skipping adding hashbang and executable permissions (chmod+x).`\n                );\n              }\n            })\n          );\n        };\n      }\n    },\n    {\n      name: \"shell-shock:docs\",\n      configResolved() {\n        this.config.automd ??= {};\n        this.config.automd.generators = {\n          ...(this.config.automd.generators ?? {}),\n          commands: commands(this)\n        };\n      },\n      async docs() {\n        this.debug(\n          \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n        );\n\n        const commands = this.inputs\n          .map(input => getCommandTree(this, input.segments))\n          .filter(Boolean) as CommandTree[];\n\n        return render(\n          this,\n          <For each={Object.values(commands)} doubleHardline>\n            {child => (\n              <Show when={!child.isVirtual}>\n                <CommandDocsFile command={child} />\n              </Show>\n            )}\n          </For>\n        );\n      }\n    }\n  ];\n};\n\nexport default plugin;\n"],"mappings":"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"}

package/dist/resolver/deepkit.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"deepkit.cjs","names":[],"sources":["../../src/resolver/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 {\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeArray\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind,\n  Context,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport { mergeCommandParameter } from \"./helpers\";\nimport type { ResolverContext } from \"./types\";\n\nfunction extractCommandParameterKind(\n  type: Type | ReflectionKind\n): CommandParameterKind {\n  const isKind = !(isSetObject(type) && \"kind\" in type);\n  const kind = !isKind ? type.kind : type;\n  if (kind === ReflectionKind.string) {\n    return CommandParameterKinds.string;\n  } else if (\n    kind === ReflectionKind.number ||\n    kind === ReflectionKind.bigint ||\n    (!isKind &&\n      type.kind === ReflectionKind.literal &&\n      (isNumber(type.literal) || isBigInt(type.literal)))\n  ) {\n    return CommandParameterKinds.number;\n  } else if (kind === ReflectionKind.boolean) {\n    return CommandParameterKinds.boolean;\n  } else {\n    return CommandParameterKinds.string;\n  }\n}\n\nfunction resolveCommandOption(\n  ctx: ResolverContext,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n  const existing = (ctx.output.options[reflection.getNameAsString()] ??\n    {}) as Partial<CommandOption>;\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title: reflection.getTags().title?.trim(),\n    description: reflection.getDescription(),\n    kind: extractCommandParameterKind(type),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray()\n  };\n\n  if (option.variadic) {\n    option.kind = extractCommandParameterKind((type as TypeArray).type.kind);\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for positional argument \"${argument.name}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[], number[], or literal[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    argument.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (argument as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (argument as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !ctx.output.args?.length &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional argument \"${argument.name}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = reflection.getParameters();\n  if (parameters.length > 0) {\n    const hasOptions =\n      parameters[0] &&\n      (parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class);\n    if (hasOptions) {\n      const optionsReflection = ReflectionClass.from(parameters[0]?.type);\n      for (const propertyReflection of optionsReflection.getProperties()) {\n        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    }\n\n    ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(\n      (arg, index) => resolveCommandArgument(ctx, index, arg)\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/helpers.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.cjs","names":[],"sources":["../../src/resolver/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 { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport {\n  getAppTitle,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandArgument, CommandParameterKind } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(ctx: ResolverContext) {\n  return Object.fromEntries(\n    Object.entries(ctx.output.options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env:\n            option.env || option.env === false\n              ? option.env\n              : ctx.input.context.config.autoAssignEnv\n                ? constantCase(name)\n                : false\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(ctx: ResolverContext): CommandArgument[] {\n  return ctx.output.args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(name)\n            : false\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(ctx: ResolverContext) {\n  ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n  if (\n    isSetString(ctx.input.context.config.reference?.commands) &&\n    ctx.input.context.config.reference.commands.includes(\"{command}\")\n  ) {\n    ctx.output.reference ??= ctx.input.context.config.reference.commands\n      ? ctx.input.context.config.reference.commands.replace(\n          \"{command}\",\n          ctx.input.command.segments\n            .filter(segment => !isDynamicPathSegment(segment))\n            .join(\"/\")\n        )\n      : undefined;\n  }\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context,\n    true\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":"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"}

package/dist/resolver/module.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"module.cjs","names":[],"sources":["../../src/resolver/module.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 { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport type {\n  JsonSchema7EnumType,\n  JsonSchema7ObjectType,\n  JsonSchema7Type\n} from \"@stryke/json\";\nimport {\n  isJsonSchema7ArrayType,\n  isJsonSchema7BooleanType,\n  isJsonSchema7NumberType,\n  isJsonSchema7ObjectType,\n  isJsonSchema7StringType,\n  isJsonSchema7TupleType,\n  isStandardJsonSchema\n} from \"@stryke/json\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { extractJsonSchema7, isZod3Type } from \"@stryke/zod\";\nimport { isCommandParameterConfig } from \"../plugin-utils\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterConfig,\n  Context,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport type { ResolverContext } from \"./types\";\n\nfunction resolveCommandOption(\n  name: string,\n  parent: JsonSchema7ObjectType,\n  schema: JsonSchema7Type\n): Partial<CommandOption> {\n  const result = {\n    name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    optional: !parent.required?.includes(name),\n    default: schema.default\n  } as Partial<CommandOption>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  } else if (result.kind === CommandParameterKinds.boolean) {\n    result.skipAddingNegative = (\n      schema as { skipAddingNegative?: boolean }\n    ).skipAddingNegative;\n    result.isNegativeOf = (schema as { isNegativeOf?: string }).isNegativeOf;\n  }\n\n  return result;\n}\n\nfunction resolveCommandArgument(\n  schema: JsonSchema7Type\n): Partial<CommandArgument> {\n  const result = {\n    name: (schema as { name?: string }).name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    default: schema.default\n  } as Partial<CommandArgument>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  }\n\n  return result;\n}\n\nexport async function resolveFromExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  validateExports(ctx);\n\n  const metadata = ctx.module?.metadata ?? {};\n  if (isSetString(metadata.title)) {\n    ctx.output.title = metadata.title;\n  }\n  if (isSetString(metadata.description)) {\n    ctx.output.description = metadata.description;\n  }\n  if (\n    isSetString(metadata.alias) ||\n    (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n  ) {\n    ctx.output.alias = toArray(metadata.alias);\n  }\n  if (isSetString(metadata.icon)) {\n    ctx.output.icon = metadata.icon;\n  }\n  if (isSetString(metadata.tags)) {\n    ctx.output.tags = getUnique(ctx.output.tags.concat(toArray(metadata.tags)));\n  }\n\n  if (isSetObject(ctx.module?.options)) {\n    if (\n      isZod3Type(ctx.module.options) ||\n      isStandardJsonSchema(ctx.module.options) ||\n      isJsonSchema7ObjectType(ctx.module.options)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.options)) {\n        jsonSchema = extractJsonSchema7(ctx.module.options);\n      } else if (isStandardJsonSchema(ctx.module.options)) {\n        jsonSchema = ctx.module.options[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.options as JsonSchema7ObjectType;\n      }\n\n      if (!isJsonSchema7ObjectType(jsonSchema)) {\n        throw new TypeError(\n          `Command options for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod object schema, a standard JSON Schema object, or a JSON Schema object.`\n        );\n      }\n\n      ctx.output.options = Object.fromEntries(\n        Object.entries((jsonSchema as JsonSchema7ObjectType).properties)\n          .map(([name, property]) => [\n            name,\n            resolveCommandOption(name, jsonSchema, property)\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else if (\n      Object.values(ctx.module.options).every(isCommandParameterConfig)\n    ) {\n      ctx.output.options = Object.fromEntries(\n        Object.entries(\n          ctx.module.options as Record<string, CommandParameterConfig>\n        )\n          .map(([name, option]) => [\n            name,\n            { name, ...option, alias: toArray(option.alias) }\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else {\n      throw new TypeError(\n        `Command options for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`\n      );\n    }\n  }\n\n  if (isSetObject(ctx.module?.args)) {\n    if (\n      isZod3Type(ctx.module.args) ||\n      isStandardJsonSchema(ctx.module.args) ||\n      isJsonSchema7TupleType(ctx.module.args)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.args)) {\n        jsonSchema = extractJsonSchema7(ctx.module.args);\n      } else if (isStandardJsonSchema(ctx.module.args)) {\n        jsonSchema = ctx.module.args[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.args;\n      }\n\n      if (!isJsonSchema7TupleType(jsonSchema)) {\n        throw new TypeError(\n          `Command arguments for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod tuple schema, a standard JSON Schema tuple object, or a JSON Schema tuple object.`\n        );\n      }\n\n      ctx.output.args = jsonSchema.items.map(item =>\n        resolveCommandArgument(item)\n      ) as CommandArgument[];\n    } else if (Object.values(ctx.module.args).every(isCommandParameterConfig)) {\n      ctx.output.args = ctx.module.args.map(arg => ({\n        ...arg,\n        alias: toArray(arg.alias)\n      })) as CommandArgument[];\n    } else {\n      throw new TypeError(\n        `Command arguments for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandArgument objects, a Zod tuple schema, or a standard JSON Schema tuple object.`\n      );\n    }\n  }\n}\n\nfunction validateExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  if (!ctx.module) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is undefined or null. Please ensure the module exports a valid command.`\n    );\n  } else if (!isSetObject(ctx.module)) {\n    throw new TypeError(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is not an object. Please ensure the module exports a valid command.`\n    );\n  } else if (!(\"default\" in ctx.module)) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" does not appear to be valid. Please ensure the module's default export is a valid command handler function.`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;AAE3D,IAAG,SAAS;;;AA4BhB,SAAE,qBAAuB,MAAA,QAAA,QAAA;CACvB,MAAA,SAAA;EACA;EACM,+CAAa,OAAA,IAAA,OAAA,kDACgB,OAAK,MAAS,GAC1C,4CAA4B,SAC5B,4CAA+B,oDACJ,OAAS,GACjC,4CAAA,oDACK,OAAA,GACF,4CAAA,SACb,4CAAsB;EACtB,OAAO,OAAA;EACP,aAAA,OAAA;EACM,6CAAS,OAAA,SAAA,EAAA,CAAA;EACT,KAAC,OAAA;EACF,UAAO,CAAA,OAAA,UAAsB,SAAS,KAAC;;EAE9C;AACE,KAAM,OAAM,SAAA,4CAAA,UACN,OAAE,SAAA,4CAAqB,QAAA;AACvB,SAAE,oDAAA,OAAA;AACP,MAAQ,OAAA,SAAe,4CAAA,OAClB,QAAS,SAAA,OAAA;AAET,iDAAA,OAAA,8CAAA,OAAA,KACF,OAAA,KACI,QAAA,UAAA,OAAwB;YAGxB,OAAA,SAAA,4CAA+B,SAAA;AACjC,SAAI,qBAAsB,OAAA;AAC1B,SAAI,eAAA,OAAwB;;AAEhC,QAAO;;AAEX,qBAAiB,SAAO;CAAA;CAAW;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AACnC,SAAS,uBAAuB,QAAQ;CACpC,MAAM,SAAS;EACf,MAAU,OAAO;EACjB,+CAAgB,OAAA,IAAA,OAAA,kDACS,OAAA,MAAA,GACxB,4CAAA,SACa,4CAAE,oDACA,OAAsB,GACtC,4CAAA,oDACkB,OAAuB,GACvB,4CAAE,SACF,4CAAA;EACd,OAAO,OAAK;EACZ,aAAM,OAAA;EACV,6CAAA,OAAA,SAAA,EAAA,CAAA;;EAEG,SAAA,OAAA;EACF;AACD,KAAG,OAAO,SAAG,4CAAqB,UAChC,OAAA,SAAA,4CAAA,QAAA;AACA,SAAO,oDAAqB,OAAqB;AACnD,MAAA,OAAA,SAAA,4CAAA,OACQ,QAAO,SAAS,OAAC;AAEvB,iDAA+B,OAAE,8CAAQ,OAAA,KACzC,OAAA,KACK,QAAA,UAAgB,OAAS;;AAGlC,QAAO;;;;;;;;;AAGT,eAAS,mBAAsB,KAAA;AAC7B,iBAAQ,IAAA;CACP,MAAO,WAAC,IAAA,QAAiB,YAAA,EAAA;AAC1B,wDAAe,SAAA,MAAA,CACT,KAAG,OAAO,QAAS,SAAS;AAEhC,wDAAE,SAAuB,YAAW,CAChC,KAAE,OAAA,cAAuB,SAAQ;AAErC,wDAAQ,SAAA,MAAsB,IACzB,MAAC,QAAA,SAAA,MAAyB,IAAM,SAAA,MAAA,SAAA,EACjC,KAAI,OAAA,8CAAsB,SAAA,MAAA;AAE9B,wDAAU,SAAA,KAAA,CACN,KAAI,OAAE,OAAA,SAAqB;AAE/B,wDAAa,SAAO,KAAA,CACpB,KAAO,OAAQ,iDAAa,IAAQ,OAAO,KAAE,6CAAkB,SAAM,KAAA,CAAA,CAAA;AAErE,wDAAgB,IAAA,QAAA,QAAA,CACb,iCAAQ,IAAA,OAAgB,QAAA,2CAC1B,IAAA,OAAA,QAAA,8CACe,IAAA,OAAsB,QAAQ,EAAA;EACvC,IAAK;AACZ,kCAAA,IAAA,OAAA,QAAA,CACO,kDAAkC,IAAO,OAAA,QAAA;kDAE9B,IAAA,OAAA,QAAA,CACP,cAAc,IAAA,OAAA,QAAA,aAAgC,WAAC,MAAA,EAChD,QAAA,YACV,CAAA;MAGG,cAAA,IAAwB,OAAS;AAElC,MAAA,2CAAA,WAAA,CACO,OAAS,IAAE,UAAU,wCAAyB,IAAA,MAAA,QAAA,KAAA,mGAAA;AAEzD,MAAA,OAAA,UAAA,OAAA,YAAA,OAAA,QAAA,WAAA,WAAA,yCAEa,MACf,qBAAA,MAAA,YAAA,SAAA;;;;MAEa,OAAS,OAAA,QAAA,IAAmB,OAAS,QAAQ,CAAA,CAAA;YAExD,OAAA,OAAA,IAAA,OAAA,QAAA,CAAA,MAAA,6CAAA,CACA,KAAA,OAAoB,UAAA,OAAA,YAAA,OAAA,QAAA,IAAA,OAAA,QAAA,uCAEN,MACV;EAAY;EAAA,GAAS;EAAQ,6CAAA,OAAA,MAAA;EAAA,CAC3B,EAAO;EAAA;EAAQ;EAAA;EAAc,CAAA,CAAA,CACnC,OAAA,OAAA,QAAA,IAAA,OAAA,QAAA,CAAA,CAAA;KAGA,OAAA,IAAA,UAAA,wCAAA,IAAA,MAAA,QAAA,KAAA,sHAAA;AAGE,wDAAe,IAAA,QAAS,KAAS,CACjC,iCAAA,IAAA,OAAA,KAAA,2CAC2B,IAAA,OAAS,KAAM,6CAC5C,IAAA,OAAA,KAAA,EAAA;EACI,IAAA;AACE,kCAAc,IAAS,OAAI,KAAA,CACjC,kDAAA,IAAA,OAAA,KAAA;kDAEwC,IAAC,OAAK,KAAO,CACrD,cAAA,IAAA,OAAA,KAAA,aAAA,WAAA,MAAA,sBAEe,CAAC;MAGZ,cAAqB,IAAI,OAAO;AAEhC,MAAA,0CAAA,WAAA,CACI,OAAY,IAAA,UAAA,0CAAe,IAAA,MAAA,QAAA,KAAA,8GAAA;AAE7B,MAAA,OAAa,OAAA,WAAmB,MAAI,IAAO,cAAQ,SAAA,uBAAA,KAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;YAEnD,OAAgB,OAAO,IAAC,OAAU,KAAA,CAAA,MAAW,6CAAiB,CAC5D,KAAM,OAAG,OAAQ,IAAA,OAAA,KAAA,IAAA,cAAA,SAAA;EACjB,GAAA;EACG,6CAAA,IAAA,MAAA;EACL,GAAA;EAAA;EAAgB;EAAC;EAAO,CAAO,CAAC;KAG7B,OAAA,IAAA,UAAA,0CAAqC,IAAA,MAAA,QAAA,KAAA,6HAAA;;AAIhD,mBAAkB,SAAU;CAAC;CAAgB;CAAU;CAAqB;CAAa;AACzF,SAAS,gBAAA,KAAA;AACL,KAAE,CAAA,IAAA;UAGE,oDAAgB,IAAA,OAAa,CAC7B,OAAM,IAAG,UAAM,2BAAc,IAAA,MAAA,QAAA,KAAA,uEAAA;UAEzB,EAAA,aAAA,IAAoB,QACxB,OAAG,IAAA,MAAA,2BAAA,IAAA,MAAA,QAAA,KAAA,+GAAA;;AAGX,gBAAc,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/resolver/resolve.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve.cjs","names":[],"sources":["../../src/resolver/resolve.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 { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getGlobalOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    tags: parent?.tags ?? [],\n    ...command,\n    title,\n    options: parent === null ? getGlobalOptions(context, command) : {},\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for application command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        name: command.title || titleCase(command.name),\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  await Promise.all(\n    ctx.input.context.inputs\n      .filter(\n        input =>\n          input.segments.filter(segment => !isDynamicPathSegment(segment))\n            .length ===\n            ctx.input.command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            ).length +\n              1 &&\n          input.segments\n            .slice(0, ctx.input.command.segments.length)\n            .every(\n              (value, index) => value === ctx.input.command.segments[index]\n            )\n      )\n      .map(async input => {\n        ctx.output.children[input.name] = await resolve<TContext>({\n          context: ctx.input.context,\n          command: input,\n          parent: ctx.output\n        });\n      })\n  );\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}

package/dist/types/command.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.cjs","names":[],"sources":["../../src/types/command.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 { StandardJSONSchemaV1 } from \"@standard-schema/spec\";\nimport type { JsonSchema7TupleType } from \"@stryke/json\";\nimport type { AnyFunction } from \"@stryke/types/base\";\nimport type { JSONSchema7Object } from \"json-schema\";\nimport type { ResolvedEntryTypeDefinition } from \"powerlines\";\nimport type * as z3 from \"zod/v3\";\n\nexport type CommandParameterType =\n  | string\n  | number\n  | boolean\n  | (string | number)[];\n\nexport const CommandParameterKinds = {\n  string: \"string\",\n  number: \"number\",\n  boolean: \"boolean\"\n} as const;\n\nexport type CommandParameterKind =\n  (typeof CommandParameterKinds)[keyof typeof CommandParameterKinds];\n\nexport interface BaseCommandParameter {\n  /**\n   * The option name.\n   */\n  name: string;\n\n  /**\n   * The option kind.\n   */\n  kind: CommandParameterKind;\n\n  /**\n   * The display title.\n   */\n  title: string;\n\n  /**\n   * The option description.\n   */\n  description: string;\n\n  /**\n   * Alternative option names.\n   */\n  alias: string[];\n\n  /**\n   * The environment variable name or false to disable.\n   */\n  env: string | false;\n\n  /**\n   * Whether the option is optional.\n   */\n  optional: boolean;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n}\n\nexport interface StringCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"string\";\n\n  /**\n   * The default value.\n   */\n  default?: string;\n\n  /**\n   * A standard string format to validate the option value against.\n   */\n  format?:\n    | \"email\"\n    | \"uri\"\n    | \"uuid\"\n    | \"ipv4\"\n    | \"ipv6\"\n    | \"date\"\n    | \"time\"\n    | \"date-time\"\n    | \"duration\";\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: string[];\n}\n\nexport interface NumberCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"number\";\n\n  /**\n   * The default value.\n   */\n  default?: number;\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: number[];\n}\n\nexport interface BooleanCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"boolean\";\n\n  /**\n   * The default value.\n   */\n  default?: boolean;\n}\n\nexport type CommandParameter =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\n\nexport type AsCommandParameterConfig<T extends BaseCommandParameter> = Pick<\n  T,\n  \"kind\" | \"alias\"\n> &\n  Partial<Omit<T, \"kind\" | \"alias\">> & {\n    alias?: string | string[];\n  };\n\nexport type StringCommandParameterConfig =\n  AsCommandParameterConfig<StringCommandParameter>;\nexport type NumberCommandParameterConfig =\n  AsCommandParameterConfig<NumberCommandParameter>;\nexport type BooleanCommandParameterConfig =\n  AsCommandParameterConfig<BooleanCommandParameter>;\n\nexport type CommandParameterConfig =\n  | StringCommandParameterConfig\n  | NumberCommandParameterConfig\n  | BooleanCommandParameterConfig;\n\nexport interface BooleanCommandOption extends BooleanCommandParameter {\n  /**\n   * The option this negates.\n   */\n  isNegativeOf?: string;\n\n  /**\n   * Whether to skip adding a negative option.\n   */\n  skipAddingNegative?: boolean;\n}\n\nexport type CommandOption =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandOption;\nexport type CommandOptionConfig = AsCommandParameterConfig<CommandOption>;\n\nexport type CommandArgument =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\nexport type CommandArgumentConfig = AsCommandParameterConfig<CommandArgument>;\n\nexport interface CommandBase {\n  /**\n   * The command id.\n   */\n  id: string | null;\n\n  /**\n   * The command name.\n   */\n  name: string;\n\n  /**\n   * The full command path value.\n   */\n  path: string | null;\n\n  /**\n   * The path segments.\n   */\n  segments: string[];\n\n  /**\n   * The display title.\n   */\n  title?: string;\n\n  /**\n   * The command description.\n   */\n  description?: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias?: string[];\n\n  /**\n   * The command icon.\n   */\n  icon?: string;\n\n  /**\n   * A URL to the command documentation or reference.\n   */\n  reference?: string;\n\n  /**\n   * Whether the command is virtual.\n   *\n   * @remarks\n   * Virtual commands are considered forks in the command tree and are not directly executable. They are used to group related subcommands together without having an actual command handler or entry point.\n   */\n  isVirtual: boolean;\n}\n\nexport interface CommandConfig extends CommandBase {\n  /**\n   * The command id.\n   */\n  id: string;\n\n  /**\n   * The resolved entry definition.\n   */\n  entry: ResolvedEntryTypeDefinition;\n\n  /**\n   * Optional tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags?: string[];\n}\n\nexport type CommandTree = CommandConfig & {\n  /**\n   * The display title.\n   */\n  title: string;\n\n  /**\n   * The command description.\n   */\n  description: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias: string[];\n\n  /**\n   * Optional tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags: string[];\n\n  /**\n   * The command options.\n   */\n  options: Record<string, CommandOption>;\n\n  /**\n   * The positional arguments provided to the command.\n   */\n  args: CommandArgument[];\n\n  /**\n   * The parent command.\n   */\n  parent: null | CommandTree;\n\n  /**\n   * Child commands.\n   */\n  children: Record<string, CommandTree>;\n};\n\nexport type SerializedCommandTree = Omit<CommandTree, \"parent\" | \"children\"> & {\n  /**\n   * The parent command id.\n   */\n  parent: null | string;\n  /**\n   * Serialized child commands.\n   */\n  children: Record<string, SerializedCommandTree>;\n};\n\nexport interface CommandMetadata {\n  /**\n   * The display name of the command.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a formatted value of the command name will be used.\n   */\n  title?: string;\n\n  /**\n   * A brief description of what the command does.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a default message may be shown.\n   */\n  description?: string;\n\n  /**\n   * One or more alternative names for the command.\n   */\n  alias?: string | string[];\n\n  /**\n   * Optional tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags?: string[];\n\n  /**\n   * An optional icon to visually represent the command in user interfaces.\n   *\n   * @remarks\n   * This can be a string containing an emoji, a Unicode character, or any other symbol that helps to visually identify the command. If not provided, no icon will be displayed.\n   */\n  icon?: string;\n\n  /**\n   * A URL to the command documentation or reference.\n   *\n   * @remarks\n   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the command. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.\n   */\n  reference?: string;\n}\n\nexport interface CommandModule {\n  metadata?: CommandMetadata;\n  options?:\n    | Record<string, CommandOptionConfig>\n    | JSONSchema7Object\n    | StandardJSONSchemaV1<Record<string, CommandParameterType>>\n    | z3.AnyZodObject;\n  args?:\n    | CommandArgumentConfig[]\n    | JsonSchema7TupleType\n    | StandardJSONSchemaV1<CommandParameterType[]>\n    | z3.AnyZodTuple;\n  default?: AnyFunction;\n}\n"],"mappings":";;;AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,UAAU;CAAC;CAAG;OAAM;OAAiB;CAAA;CAAA;CAAA;;;;;;;AAE3C,MAAM,aAAS;CAAA;CAAS;CAAG;CAAY;CAA2B;AAClE,MAAI,0BAA4B,CAAC,wBAAqB,gBAAa;AAEnE,MAAK,wBAA0B;;CAE9B,QAAW;CACX,SAAY;CACZ;AACD,MAAC,0BAA+B;OAAG;OAAkB;CAAA;CAAA;CAAA;AAErD,MAAM,0BAAqB;CAAM;OAAG;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpC,MAAM,4BAA4B;OAAO;CAAyB;CAAI;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtE,MAAM,4BAA4B;OAAO;CAAwB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEjE,MAAM,6BAA6B;OAAO;CAAW;CAAA;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,sBAAQ;OAAA;OAA+C;OAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAI7D,MAAI,kCAAA;OAAA;OAAA;CAAA;CAAA;CAAA;AAEJ,MAAI,kCAAA;OAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;AAIJ,MAAE,4BAAgB;OAAA;OAAA;OAAA;CAAA;CAAA;CAAA;AAElB,MAAE,0BAAiB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAInB,MAAG,yBAA4B;OAAO;OAA8B;CAAA;CAAA;CAAA;AAEpE,MAAM,qBAAW;OAAA;OAAqB;OAAA;CAAA;CAAA;CAAA;AAEtC,MAAK,2BAAe;OAAA;OAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,iBAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEd,MAAI,mBAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEJ,MAAI,iBAAA;OAAA;CAAA;CAAA;CAAA;CAAA;OAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;AAIJ,MAAK,qBAAiB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtB,MAAE,mBAAa;OAAA;CAAA;OAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/types/config.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../../src/types/config.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 { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\nexport interface ReferenceOptions {\n  /**\n   * A URL to the application documentation or reference.\n   */\n  app: string;\n\n  /**\n   * A URL to the application command specific documentation or reference.\n   *\n   * @remarks\n   * This URL is expected to contain the token `{command}`, which will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{reference}/command/subcommand`.\n   */\n  commands?: string;\n}\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of global command options to apply to each command.\n   *\n   * @remarks\n   * Each command will inherit these global options. To disable the addition of these global options, set this property to `false`, or provide a custom set of options/a function that returns them. A `GlobalOptions` interface will be created by the `shell-shock types` command and added to the generated `shell-shock.d.ts` file.\n   */\n  globalOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * Should Shell Shock attempt to automatically assign environment variables to manipulate default values for command options based on the option name?\n   *\n   * @remarks\n   * If set to a string, Shell Shock will use the provided string as an application specific environment variable prefix, convert the option name to {@link https://stringcase.org/cases/constant/ | constant case}, and prepend the provided `string` value to determine the corresponding environment variable name. For example, if an option is named `\"configPath\"` and the `autoAssignEnv` is `\"MY_APP_\"`, Shell Shock will look for an environment variable named `\"MY_APP_CONFIG_PATH\"` and assign its value to the option if it exists. If set to `true`, Shell Shock will use a default environment variable prefix derived from the {@link Options.name | application name}.\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  autoAssignEnv?: true | string;\n\n  /**\n   * A URL to the application documentation or reference.\n   *\n   * @remarks\n   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{reference}/command/subcommand`.\n   */\n  reference?: ReferenceOptions | string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & Partial<NodeJsPluginOptions>;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"path\" | \"copy\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  Partial<NodeJsPluginUserConfig> &\n  Pick<NodeJsPluginUserConfig, \"root\"> & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\" | \"reference\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The URL(s) to the application documentation or reference.\n     */\n    reference: ReferenceOptions;\n\n    /**\n     * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.\n     */\n    appSpecificEnvPrefix: string;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";;;AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAA;CAAM;CAAW;CAAM;;;;;;;;;AAE3C,MAAM,YAAS;CAAA;CAAS;CAAG;CAAY;CAAqB;AAC5D,MAAI,aAAc;CAAA;CAAM;CAAA;CAAe;CAA4B;AACnE,MAAM,kBAAkB;OAAC;CAAa;CAAS;CAAA;CAAa;CAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACnE,MAAK,sBAAuB;CAAC;CAAE;CAAiB;CAAmB;CAAW;AAE9E,MAAC,iBAAsB;OAAI;OAAqB;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AACjD,MAAC,aAAkB;OAAO;OAAoB;CAAc;CAAO;CAAA;AAEnE,MAAC,kBAAuB;OAAG;CAAQ;CAAa;CAAK;CAAA;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,gBAAQ;OAAa;OAAS;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AAEpC,MAAM,oBAAoB;OAAO;OAAmB;OAAe;CAAG;CAAA;OAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/types/context.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.cjs","names":[],"sources":["../../src/types/context.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 { NodeJsPluginContext } from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type { TsdownPluginContext } from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { UnresolvedContext as PowerlinesUnresolvedContext } from \"powerlines\";\nimport type { CommandConfig, CommandOption, CommandTree } from \"./command\";\nimport type { ResolvedConfig } from \"./config\";\n\nexport type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> =\n  TsdownPluginContext<TResolvedConfig> &\n    NodeJsPluginContext<TResolvedConfig> & {\n      /**\n       * The root path where commands are located.\n       */\n      commandsPath: string;\n\n      /**\n       * The default command arguments to apply to all application commands.\n       */\n      options: CommandOption[];\n\n      /**\n       * The list of commands discovered in the project.\n       */\n      inputs: CommandConfig[];\n\n      /**\n       * The command-line application structure.\n       */\n      commands: Record<string, CommandTree>;\n    };\n\nexport type UnresolvedContext<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig\n> = PowerlinesUnresolvedContext<TResolvedConfig>;\n"],"mappings":";;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB"}

package/dist/types/env.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"env.cjs","names":[],"sources":["../../src/types/env.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface ShellShockEnv {\n  /**\n   * The system PATHEXT variable, used to determine which file extensions are considered executable on Windows.\n   *\n   * @remarks\n   * If not provided, it will default to '.EXE;.CMD;.BAT;.COM' on Windows, and will be ignored on other platforms. This variable is used to locate executable files when running commands, and is only relevant on Windows platforms. On non-Windows platforms, the system's executable file resolution will be used, and this variable will have no effect.\n   *\n   * @hidden\n   * @runtime\n   * @internal\n   */\n  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   *\n   * @hidden\n   * @runtime\n   * @internal\n   */\n  PATH?: string;\n\n  /**\n   * The npm user agent string, which can be used to detect if the environment is running within an npm script.\n   *\n   * @remarks\n   * This variable is set by npm when running scripts defined in package.json. It can be used to conditionally adjust behavior when running within an npm script context, such as modifying logging output or adjusting command execution. If this variable is not set, it can be assumed that the environment is not running within an npm script.\n   *\n   * @hidden\n   * @runtime\n   * @internal\n   */\n  npm_config_user_agent?: string;\n\n  /**\n   * The npm_config_fund environment variable, which can be used to control npm's funding behavior.\n   *\n   * @remarks\n   * This variable is set by npm when running scripts defined in package.json, and can be used to control npm's funding behavior. If set to 'false', it will disable npm's funding messages. If not set, npm will use its default funding behavior. This variable is only relevant when running within an npm script context, and has no effect on command execution or behavior outside of that context.\n   *\n   * @hidden\n   * @runtime\n   * @internal\n   */\n  npm_config_fund?: string;\n\n  /**\n   * The npm execution path, which can be used to determine the location of the npm executable.\n   *\n   * @remarks\n   * This variable is set by npm when running scripts defined in package.json. It provides the absolute path to the npm executable being used to run the script. This can be useful for resolving the location of npm or for debugging purposes. If this variable is not set, it may indicate that the environment is not running within an npm script context, or that npm is not available in the PATH.\n   *\n   * @hidden\n   * @runtime\n   * @internal\n   */\n  npm_execpath?: string;\n\n  /**\n   * The COMSPEC environment variable, which specifies the command-line interpreter to use on Windows.\n   *\n   * @remarks\n   * This variable is used on Windows platforms to determine which command-line interpreter to use when executing commands. It typically points to cmd.exe, but can be customized by the user. If this variable is not set on Windows, it will default to 'cmd.exe'. On non-Windows platforms, this variable is ignored and has no effect on command execution.\n   *\n   * @hidden\n   * @runtime\n   * @internal\n   */\n  COMSPEC?: string;\n}\n"],"mappings":""}

package/dist/types/options.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"options.cjs","names":[],"sources":["../../src/types/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\nexport interface BaseCommandOptions {\n  help: boolean;\n  version: boolean;\n}\n"],"mappings":""}