@shell-shock/core 0.13.8 → 0.13.9

package/README.md

@@ -27,7 +27,7 @@ This package is part of the ⚡<b>Shell Shock</b> monorepo. The Shell Shock pack
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-0.13.2-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://stormsoftware.com/projects/shell-shock/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/shell-shock/release.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-0.13.8-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://stormsoftware.com/projects/shell-shock/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/shell-shock/release.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/dist/plugin.cjs

@@ -66,7 +66,10 @@ const plugin = (options = {}) => {
 						dts: false
 					},
 					input: !this.config.input || Array.isArray(this.config.input) && this.config.input.length === 0 || (0, _stryke_type_checks_is_object.isObject)(this.config.input) && Object.keys(this.config.input).length === 0 ? [(0, _stryke_path_join_paths.joinPaths)(this.config.root, "src/**/command.ts"), (0, _stryke_path_join_paths.joinPaths)(this.config.root, "src/**/command.tsx")] : void 0,
-					resolve: { external: ["@powerlines/deepkit"] },
+					resolve: {
+						external: ["@powerlines/deepkit"],
+						skipNodeModulesBundle: true
+					},
 					tsdown: {
 						dts: false,
 						nodeProtocol: true,

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"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 deepkit from \"@powerlines/plugin-deepkit\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\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 { tsdown } from \"powerlines/tsdown\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\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 { CommandParameterKinds } 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) => {\n  return [\n    tsdown(),\n    deepkit(),\n    automd(),\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            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            },\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      }\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              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      types(code: string) {\n        this.debug(\n          \"Generating type definitions for the Shell Shock application.\"\n        );\n\n        return `${code}\n\n/**\n * The global options available for every command in the ${getAppTitle(\n   this,\n   true\n )} command-line application.\n */\nexport interface GlobalOptions {\n  ${this.options\n    .map(\n      option =>\n        `${\n          option.description\n            ? `\n/**\n * ${option.description}${\n   option.default\n     ? `\n *\n * @defaultValue ${\n   option.kind === CommandParameterKinds.string\n     ? `\"${option.default}\"`\n     : option.default\n }`\n     : \"\"\n }\n */\n`\n            : \"\"\n        }${option.name}${option.optional ? \"?\" : \"\"}: ${\n          option.kind === CommandParameterKinds.boolean\n            ? \"boolean\"\n            : `${option.variadic ? \"(\" : \"\"}${\n                option.choices\n                  ? option.choices\n                      .map(choice =>\n                        option.kind === CommandParameterKinds.number\n                          ? `${choice}`\n                          : `\"${choice}\"`\n                      )\n                      .join(\" | \")\n                  : option.kind === CommandParameterKinds.number\n                    ? \"number\"\n                    : \"string\"\n              }${option.variadic ? \")[]\" : \"\"}`\n        };${\n          option.alias && option.alias.length > 0\n            ? option.alias\n                .map(\n                  alias =>\n                    `${alias}${option.optional ? \"?\" : \"\"}: ${\n                      option.kind === CommandParameterKinds.boolean\n                        ? \"boolean\"\n                        : `${option.variadic ? \"(\" : \"\"}${\n                            option.choices\n                              ? option.choices\n                                  .map(choice =>\n                                    option.kind === CommandParameterKinds.number\n                                      ? `${choice}`\n                                      : `\"${choice}\"`\n                                  )\n                                  .join(\" | \")\n                              : option.kind === CommandParameterKinds.number\n                                ? \"number\"\n                                : \"string\"\n                          }${option.variadic ? \")[]\" : \"\"}`\n                    };`\n                )\n                .join(\"\\n\\n\")\n            : \"\"\n        }`\n    )\n    .join(\"\\n\\n\")}\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            <UtilsBuiltin />\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 ${command.name} \\n\\nPlease ensure ${command.entry.file} 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                          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}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\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            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            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  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}
+{"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 deepkit from \"@powerlines/plugin-deepkit\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\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 { tsdown } from \"powerlines/tsdown\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\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 { CommandParameterKinds } 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) => {\n  return [\n    tsdown(),\n    deepkit(),\n    automd(),\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            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      }\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              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      types(code: string) {\n        this.debug(\n          \"Generating type definitions for the Shell Shock application.\"\n        );\n\n        return `${code}\n\n/**\n * The global options available for every command in the ${getAppTitle(\n   this,\n   true\n )} command-line application.\n */\nexport interface GlobalOptions {\n  ${this.options\n    .map(\n      option =>\n        `${\n          option.description\n            ? `\n/**\n * ${option.description}${\n   option.default\n     ? `\n *\n * @defaultValue ${\n   option.kind === CommandParameterKinds.string\n     ? `\"${option.default}\"`\n     : option.default\n }`\n     : \"\"\n }\n */\n`\n            : \"\"\n        }${option.name}${option.optional ? \"?\" : \"\"}: ${\n          option.kind === CommandParameterKinds.boolean\n            ? \"boolean\"\n            : `${option.variadic ? \"(\" : \"\"}${\n                option.choices\n                  ? option.choices\n                      .map(choice =>\n                        option.kind === CommandParameterKinds.number\n                          ? `${choice}`\n                          : `\"${choice}\"`\n                      )\n                      .join(\" | \")\n                  : option.kind === CommandParameterKinds.number\n                    ? \"number\"\n                    : \"string\"\n              }${option.variadic ? \")[]\" : \"\"}`\n        };${\n          option.alias && option.alias.length > 0\n            ? option.alias\n                .map(\n                  alias =>\n                    `${alias}${option.optional ? \"?\" : \"\"}: ${\n                      option.kind === CommandParameterKinds.boolean\n                        ? \"boolean\"\n                        : `${option.variadic ? \"(\" : \"\"}${\n                            option.choices\n                              ? option.choices\n                                  .map(choice =>\n                                    option.kind === CommandParameterKinds.number\n                                      ? `${choice}`\n                                      : `\"${choice}\"`\n                                  )\n                                  .join(\" | \")\n                              : option.kind === CommandParameterKinds.number\n                                ? \"number\"\n                                : \"string\"\n                          }${option.variadic ? \")[]\" : \"\"}`\n                    };`\n                )\n                .join(\"\\n\\n\")\n            : \"\"\n        }`\n    )\n    .join(\"\\n\\n\")}\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            <UtilsBuiltin />\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 ${command.name} \\n\\nPlease ensure ${command.entry.file} 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                          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}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\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            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            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  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAkFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KAumBJ,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAkFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KAwmBJ,MAAA,CAAO,QAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAkFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KAumBJ,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAkFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KAwmBJ,MAAA,CAAO,QAAA"}

package/dist/plugin.mjs

@@ -61,7 +61,10 @@ const plugin = (options = {}) => {
 						dts: false
 					},
 					input: !this.config.input || Array.isArray(this.config.input) && this.config.input.length === 0 || isObject(this.config.input) && Object.keys(this.config.input).length === 0 ? [joinPaths(this.config.root, "src/**/command.ts"), joinPaths(this.config.root, "src/**/command.tsx")] : void 0,
-					resolve: { external: ["@powerlines/deepkit"] },
+					resolve: {
+						external: ["@powerlines/deepkit"],
+						skipNodeModulesBundle: true
+					},
 					tsdown: {
 						dts: false,
 						nodeProtocol: true,

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","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 deepkit from \"@powerlines/plugin-deepkit\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\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 { tsdown } from \"powerlines/tsdown\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\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 { CommandParameterKinds } 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) => {\n  return [\n    tsdown(),\n    deepkit(),\n    automd(),\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            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            },\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      }\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              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      types(code: string) {\n        this.debug(\n          \"Generating type definitions for the Shell Shock application.\"\n        );\n\n        return `${code}\n\n/**\n * The global options available for every command in the ${getAppTitle(\n   this,\n   true\n )} command-line application.\n */\nexport interface GlobalOptions {\n  ${this.options\n    .map(\n      option =>\n        `${\n          option.description\n            ? `\n/**\n * ${option.description}${\n   option.default\n     ? `\n *\n * @defaultValue ${\n   option.kind === CommandParameterKinds.string\n     ? `\"${option.default}\"`\n     : option.default\n }`\n     : \"\"\n }\n */\n`\n            : \"\"\n        }${option.name}${option.optional ? \"?\" : \"\"}: ${\n          option.kind === CommandParameterKinds.boolean\n            ? \"boolean\"\n            : `${option.variadic ? \"(\" : \"\"}${\n                option.choices\n                  ? option.choices\n                      .map(choice =>\n                        option.kind === CommandParameterKinds.number\n                          ? `${choice}`\n                          : `\"${choice}\"`\n                      )\n                      .join(\" | \")\n                  : option.kind === CommandParameterKinds.number\n                    ? \"number\"\n                    : \"string\"\n              }${option.variadic ? \")[]\" : \"\"}`\n        };${\n          option.alias && option.alias.length > 0\n            ? option.alias\n                .map(\n                  alias =>\n                    `${alias}${option.optional ? \"?\" : \"\"}: ${\n                      option.kind === CommandParameterKinds.boolean\n                        ? \"boolean\"\n                        : `${option.variadic ? \"(\" : \"\"}${\n                            option.choices\n                              ? option.choices\n                                  .map(choice =>\n                                    option.kind === CommandParameterKinds.number\n                                      ? `${choice}`\n                                      : `\"${choice}\"`\n                                  )\n                                  .join(\" | \")\n                              : option.kind === CommandParameterKinds.number\n                                ? \"number\"\n                                : \"string\"\n                          }${option.variadic ? \")[]\" : \"\"}`\n                    };`\n                )\n                .join(\"\\n\\n\")\n            : \"\"\n        }`\n    )\n    .join(\"\\n\\n\")}\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            <UtilsBuiltin />\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 ${command.name} \\n\\nPlease ensure ${command.entry.file} 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                          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}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\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            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            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  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"plugin.mjs","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 deepkit from \"@powerlines/plugin-deepkit\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\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 { tsdown } from \"powerlines/tsdown\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\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 { CommandParameterKinds } 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) => {\n  return [\n    tsdown(),\n    deepkit(),\n    automd(),\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            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      }\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              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      types(code: string) {\n        this.debug(\n          \"Generating type definitions for the Shell Shock application.\"\n        );\n\n        return `${code}\n\n/**\n * The global options available for every command in the ${getAppTitle(\n   this,\n   true\n )} command-line application.\n */\nexport interface GlobalOptions {\n  ${this.options\n    .map(\n      option =>\n        `${\n          option.description\n            ? `\n/**\n * ${option.description}${\n   option.default\n     ? `\n *\n * @defaultValue ${\n   option.kind === CommandParameterKinds.string\n     ? `\"${option.default}\"`\n     : option.default\n }`\n     : \"\"\n }\n */\n`\n            : \"\"\n        }${option.name}${option.optional ? \"?\" : \"\"}: ${\n          option.kind === CommandParameterKinds.boolean\n            ? \"boolean\"\n            : `${option.variadic ? \"(\" : \"\"}${\n                option.choices\n                  ? option.choices\n                      .map(choice =>\n                        option.kind === CommandParameterKinds.number\n                          ? `${choice}`\n                          : `\"${choice}\"`\n                      )\n                      .join(\" | \")\n                  : option.kind === CommandParameterKinds.number\n                    ? \"number\"\n                    : \"string\"\n              }${option.variadic ? \")[]\" : \"\"}`\n        };${\n          option.alias && option.alias.length > 0\n            ? option.alias\n                .map(\n                  alias =>\n                    `${alias}${option.optional ? \"?\" : \"\"}: ${\n                      option.kind === CommandParameterKinds.boolean\n                        ? \"boolean\"\n                        : `${option.variadic ? \"(\" : \"\"}${\n                            option.choices\n                              ? option.choices\n                                  .map(choice =>\n                                    option.kind === CommandParameterKinds.number\n                                      ? `${choice}`\n                                      : `\"${choice}\"`\n                                  )\n                                  .join(\" | \")\n                              : option.kind === CommandParameterKinds.number\n                                ? \"number\"\n                                : \"string\"\n                          }${option.variadic ? \")[]\" : \"\"}`\n                    };`\n                )\n                .join(\"\\n\\n\")\n            : \"\"\n        }`\n    )\n    .join(\"\\n\\n\")}\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            <UtilsBuiltin />\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 ${command.name} \\n\\nPlease ensure ${command.entry.file} 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                          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}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\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            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            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  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}

package/dist/resolver/deepkit.cjs

@@ -44,7 +44,7 @@ function resolveCommandOption(ctx, reflection) {
 	if (reflection.isArray()) if (type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number) {
 		option.variadic = true;
 		option.kind = extractCommandParameterKind(type.type.kind);
-	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string[] and number[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
 	else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.union) {
 		option.kind = type.types.every(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number || t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, _stryke_type_checks_is_number.isNumber)(t.literal) || (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal)), [
 			"t",
@@ -57,7 +57,7 @@ function resolveCommandOption(ctx, reflection) {
 			"P\"2!\"/\""
 		])).filter(Boolean);
 	} else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal) option.choices = [(0, _stryke_type_checks_is_number.isNumber)(type.literal) ? type.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(type.literal) ? Number(type.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
-	else if (!existing.kind && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (!existing.kind && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
 	return require_helpers.mergeCommandParameter(existing, option);
 }
 resolveCommandOption.__type = [
@@ -72,7 +72,6 @@ resolveCommandOption.__type = [
 function resolveCommandArgument(ctx, index, reflection) {
 	const type = reflection.getType();
 	const existing = ctx.output.args.length > index ? ctx.output.args[index] : {};
-	if (!existing.kind && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && !(type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.array && (type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number))) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string types (or an array of strings) are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
 	const argument = {
 		name: reflection.getName() || reflection.parameter.name,
 		alias: reflection.getAlias(),
@@ -82,12 +81,23 @@ function resolveCommandArgument(ctx, index, reflection) {
 		optional: reflection.isOptional(),
 		default: reflection.getDefaultValue()
 	};
-	if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.array) {
-		if (type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number) {
-			argument.variadic = true;
-			argument.kind = extractCommandParameterKind(type.type.kind);
-		} else if (!existing.kind) throw new Error(`Unsupported array type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string[] and number[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
-	} else if (!existing.kind && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.array) if (type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number) {
+		argument.variadic = true;
+		argument.kind = extractCommandParameterKind(type.type.kind);
+	} else throw new Error(`Unsupported array type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.union) {
+		argument.kind = type.types.every(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number || t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, _stryke_type_checks_is_number.isNumber)(t.literal) || (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? require_types_command.CommandParameterKinds.number : require_types_command.CommandParameterKinds.string;
+		argument.choices = type.types.map(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal ? (0, _stryke_type_checks_is_number.isNumber)(t.literal) ? t.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal) ? Number(t.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal) argument.choices = [(0, _stryke_type_checks_is_number.isNumber)(type.literal) ? type.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(type.literal) ? Number(type.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!existing.kind && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
 	return require_helpers.mergeCommandParameter(existing, argument, { name: `arg${index}` });
 }
 resolveCommandArgument.__type = [

package/dist/resolver/deepkit.cjs.map

@@ -1 +1 @@
-{"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 (reflection.isArray()) {\n    if (\n      (type as TypeArray).type.kind === ReflectionKind.string ||\n      (type as TypeArray).type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\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[] and number[] 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  if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\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 if (!existing.kind) {\n      throw new Error(\n        `Unsupported array type for argument \"${reflection.getName()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\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 argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[] and number[] 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 && parameters[0]) {\n    if (\n      parameters[0].type.kind === ReflectionKind.objectLiteral ||\n      parameters[0].type.kind === ReflectionKind.class\n    ) {\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    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}
+{"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 (reflection.isArray()) {\n    if (\n      (type as TypeArray).type.kind === ReflectionKind.string ||\n      (type as TypeArray).type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" 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    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    !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 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 && parameters[0]) {\n    if (\n      parameters[0].type.kind === ReflectionKind.objectLiteral ||\n      parameters[0].type.kind === ReflectionKind.class\n    ) {\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    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/deepkit.mjs

@@ -43,7 +43,7 @@ function resolveCommandOption(ctx, reflection) {
 	if (reflection.isArray()) if (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number) {
 		option.variadic = true;
 		option.kind = extractCommandParameterKind(type.type.kind);
-	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
 	else if (type.kind === ReflectionKind.union) {
 		option.kind = type.types.every(__assignType((t) => t.kind === ReflectionKind.number || t.kind === ReflectionKind.literal && (isNumber(t.literal) || isBigInt(t.literal)), [
 			"t",
@@ -56,7 +56,7 @@ function resolveCommandOption(ctx, reflection) {
 			"P\"2!\"/\""
 		])).filter(Boolean);
 	} else if (type.kind === ReflectionKind.literal) option.choices = [isNumber(type.literal) ? type.literal : isBigInt(type.literal) ? Number(type.literal) : isRegExp(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
-	else if (!existing.kind && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (!existing.kind && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
 	return mergeCommandParameter(existing, option);
 }
 resolveCommandOption.__type = [
@@ -71,7 +71,6 @@ resolveCommandOption.__type = [
 function resolveCommandArgument(ctx, index, reflection) {
 	const type = reflection.getType();
 	const existing = ctx.output.args.length > index ? ctx.output.args[index] : {};
-	if (!existing.kind && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number && type.kind !== ReflectionKind.boolean && !(type.kind === ReflectionKind.array && (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number))) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string types (or an array of strings) are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
 	const argument = {
 		name: reflection.getName() || reflection.parameter.name,
 		alias: reflection.getAlias(),
@@ -81,12 +80,23 @@ function resolveCommandArgument(ctx, index, reflection) {
 		optional: reflection.isOptional(),
 		default: reflection.getDefaultValue()
 	};
-	if (type.kind === ReflectionKind.array) {
-		if (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number) {
-			argument.variadic = true;
-			argument.kind = extractCommandParameterKind(type.type.kind);
-		} else if (!existing.kind) throw new Error(`Unsupported array type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
-	} else if (!existing.kind && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	if (type.kind === ReflectionKind.array) if (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number) {
+		argument.variadic = true;
+		argument.kind = extractCommandParameterKind(type.type.kind);
+	} else throw new Error(`Unsupported array type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind === ReflectionKind.union) {
+		argument.kind = type.types.every(__assignType((t) => t.kind === ReflectionKind.number || t.kind === ReflectionKind.literal && (isNumber(t.literal) || isBigInt(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? CommandParameterKinds.number : CommandParameterKinds.string;
+		argument.choices = type.types.map(__assignType((t) => t.kind === ReflectionKind.literal ? isNumber(t.literal) ? t.literal : isBigInt(t.literal) ? Number(t.literal) : isRegExp(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === ReflectionKind.literal) argument.choices = [isNumber(type.literal) ? type.literal : isBigInt(type.literal) ? Number(type.literal) : isRegExp(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!existing.kind && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
 	return mergeCommandParameter(existing, argument, { name: `arg${index}` });
 }
 resolveCommandArgument.__type = [

package/dist/resolver/deepkit.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deepkit.mjs","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 (reflection.isArray()) {\n    if (\n      (type as TypeArray).type.kind === ReflectionKind.string ||\n      (type as TypeArray).type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\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[] and number[] 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  if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number &&\n    type.kind !== ReflectionKind.boolean &&\n    !(\n      type.kind === ReflectionKind.array &&\n      (type.type.kind === ReflectionKind.string ||\n        type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\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 if (!existing.kind) {\n      throw new Error(\n        `Unsupported array type for argument \"${reflection.getName()}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[] and number[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\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 argument \"${reflection.getName()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[] and number[] 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 && parameters[0]) {\n    if (\n      parameters[0].type.kind === ReflectionKind.objectLiteral ||\n      parameters[0].type.kind === ReflectionKind.class\n    ) {\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    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"deepkit.mjs","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 (reflection.isArray()) {\n    if (\n      (type as TypeArray).type.kind === ReflectionKind.string ||\n      (type as TypeArray).type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (option as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind((type as TypeArray).type.kind) as\n          | \"string\"\n          | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" 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    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    !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 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 && parameters[0]) {\n    if (\n      parameters[0].type.kind === ReflectionKind.objectLiteral ||\n      parameters[0].type.kind === ReflectionKind.class\n    ) {\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    } else if (!ctx.module?.options) {\n      throw new Error(\n        `The first parameter of the command handler function in \"${\n          ctx.input.command.entry.input?.file || ctx.input.command.path\n        }\" must be an object literal or class type representing the command options.`\n      );\n    }\n\n    ctx.output.args = parameters\n      .slice(1)\n      .map((arg, index) => resolveCommandArgument(ctx, index, arg));\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/resolve.cjs

@@ -143,7 +143,7 @@ async function postprocess(ctx) {
 			"P\"2!\"/\""
 		]));
 	}
-	for (const input of ctx.input.context.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment), [
+	await Promise.all(ctx.input.context.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment), [
 		"segment",
 		"",
 		"P\"2!\"/\""
@@ -160,15 +160,21 @@ async function postprocess(ctx) {
 		"input",
 		"",
 		"P\"2!\"/\""
-	]))) ctx.output.children[input.name] = await (resolve.Ω = [[
-		() => ctx,
-		"ResolverContext",
-		"Pi!\"w\"q\"!j"
-	]], resolve({
-		context: ctx.input.context,
-		command: input,
-		parent: ctx.output
-	}));
+	])).map(__assignType(async (input) => {
+		ctx.output.children[input.name] = await (resolve.Ω = [[
+			() => ctx,
+			"ResolverContext",
+			"Pi!\"w\"q\"!j"
+		]], resolve({
+			context: ctx.input.context,
+			command: input,
+			parent: ctx.output
+		}));
+	}, [
+		"input",
+		"",
+		"P\"2!\"/\""
+	])));
 	return ctx.output;
 }
 postprocess.__type = [

package/dist/resolver/resolve.cjs.map

@@ -1 +1 @@
-{"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    ...command,\n    title,\n    options: 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 user-defined 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        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  for (const input of ctx.input.context.inputs.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((value, index) => value === ctx.input.command.segments[index])\n  )) {\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  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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"}
+{"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    ...command,\n    title,\n    options: 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 user-defined 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        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/resolver/resolve.mjs

@@ -142,7 +142,7 @@ async function postprocess(ctx) {
 			"P\"2!\"/\""
 		]));
 	}
-	for (const input of ctx.input.context.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
+	await Promise.all(ctx.input.context.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
 		"segment",
 		"",
 		"P\"2!\"/\""
@@ -159,15 +159,21 @@ async function postprocess(ctx) {
 		"input",
 		"",
 		"P\"2!\"/\""
-	]))) ctx.output.children[input.name] = await (resolve.Ω = [[
-		() => ctx,
-		"ResolverContext",
-		"Pi!\"w\"q\"!j"
-	]], resolve({
-		context: ctx.input.context,
-		command: input,
-		parent: ctx.output
-	}));
+	])).map(__assignType(async (input) => {
+		ctx.output.children[input.name] = await (resolve.Ω = [[
+			() => ctx,
+			"ResolverContext",
+			"Pi!\"w\"q\"!j"
+		]], resolve({
+			context: ctx.input.context,
+			command: input,
+			parent: ctx.output
+		}));
+	}, [
+		"input",
+		"",
+		"P\"2!\"/\""
+	])));
 	return ctx.output;
 }
 postprocess.__type = [

package/dist/resolver/resolve.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.mjs","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    ...command,\n    title,\n    options: 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 user-defined 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        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  for (const input of ctx.input.context.inputs.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((value, index) => value === ctx.input.command.segments[index])\n  )) {\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  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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"}
+{"version":3,"file":"resolve.mjs","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    ...command,\n    title,\n    options: 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 user-defined 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        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/env.cjs

@@ -4,8 +4,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const __ΩShellShockEnv = [
 	"PATHEXT",
 	"PATH",
+	"npm_config_user_agent",
+	"npm_execpath",
+	"comspec",
 	"ShellShockEnv",
-	"P&4!8&4\"8Mw#y"
+	"P&4!8&4\"8&4#8&4$8&4%8Mw&y"
 ];
 
 //#endregion

package/dist/types/env.cjs.map

@@ -1 +1 @@
-{"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  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   */\n  PATH?: string;\n}\n"],"mappings":""}
+{"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   * @internal\n   */\n  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   *\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   * @internal\n   */\n  npm_config_user_agent?: 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   * @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   * @internal\n   */\n  comspec?: string;\n}\n"],"mappings":""}

package/dist/types/env.d.cts

@@ -5,12 +5,43 @@ interface ShellShockEnv {
    *
    * @remarks
    * 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.
+   *
+   * @internal
    */
   PATHEXT?: string;
   /**
    * The system PATH variable, used to locate executable files.
+   *
+   * @internal
    */
   PATH?: string;
+  /**
+   * The npm user agent string, which can be used to detect if the environment is running within an npm script.
+   *
+   * @remarks
+   * 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.
+   *
+   * @internal
+   */
+  npm_config_user_agent?: string;
+  /**
+   * The npm execution path, which can be used to determine the location of the npm executable.
+   *
+   * @remarks
+   * 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.
+   *
+   * @internal
+   */
+  npm_execpath?: string;
+  /**
+   * The COMSPEC environment variable, which specifies the command-line interpreter to use on Windows.
+   *
+   * @remarks
+   * 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.
+   *
+   * @internal
+   */
+  comspec?: string;
 }
 //#endregion
 export { ShellShockEnv };

package/dist/types/env.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.cts","names":[],"sources":["../../src/types/env.ts"],"mappings":";UAkBiB,aAAA;EAAA;;;;;;EAOf,OAAA;;;;EAKA,IAAA;AAAA"}
+{"version":3,"file":"env.d.cts","names":[],"sources":["../../src/types/env.ts"],"mappings":";UAkBiB,aAAA;EAAA;;;;;;;;EASf,OAAA;EAqCO;;;;;EA9BP,IAAA;;;;;;;;;EAUA,qBAAA;;;;;;;;;EAUA,YAAA;;;;;;;;;EAUA,OAAA;AAAA"}

package/dist/types/env.d.mts

@@ -5,12 +5,43 @@ interface ShellShockEnv {
    *
    * @remarks
    * 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.
+   *
+   * @internal
    */
   PATHEXT?: string;
   /**
    * The system PATH variable, used to locate executable files.
+   *
+   * @internal
    */
   PATH?: string;
+  /**
+   * The npm user agent string, which can be used to detect if the environment is running within an npm script.
+   *
+   * @remarks
+   * 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.
+   *
+   * @internal
+   */
+  npm_config_user_agent?: string;
+  /**
+   * The npm execution path, which can be used to determine the location of the npm executable.
+   *
+   * @remarks
+   * 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.
+   *
+   * @internal
+   */
+  npm_execpath?: string;
+  /**
+   * The COMSPEC environment variable, which specifies the command-line interpreter to use on Windows.
+   *
+   * @remarks
+   * 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.
+   *
+   * @internal
+   */
+  comspec?: string;
 }
 //#endregion
 export { ShellShockEnv };

package/dist/types/env.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/types/env.ts"],"mappings":";UAkBiB,aAAA;EAAA;;;;;;EAOf,OAAA;;;;EAKA,IAAA;AAAA"}
+{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/types/env.ts"],"mappings":";UAkBiB,aAAA;EAAA;;;;;;;;EASf,OAAA;EAqCO;;;;;EA9BP,IAAA;;;;;;;;;EAUA,qBAAA;;;;;;;;;EAUA,YAAA;;;;;;;;;EAUA,OAAA;AAAA"}

package/dist/types/env.mjs

@@ -2,8 +2,11 @@
 const __ΩShellShockEnv = [
 	"PATHEXT",
 	"PATH",
+	"npm_config_user_agent",
+	"npm_execpath",
+	"comspec",
 	"ShellShockEnv",
-	"P&4!8&4\"8Mw#y"
+	"P&4!8&4\"8&4#8&4$8&4%8Mw&y"
 ];
 
 //#endregion

package/dist/types/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","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  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   */\n  PATH?: string;\n}\n"],"mappings":""}
+{"version":3,"file":"env.mjs","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   * @internal\n   */\n  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   *\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   * @internal\n   */\n  npm_config_user_agent?: 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   * @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   * @internal\n   */\n  comspec?: string;\n}\n"],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.13.8",
+  "version": "0.13.9",
   "private": false,
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "keywords": ["shell-shock", "powerlines", "storm-software"],
@@ -350,39 +350,39 @@
     "@alloy-js/core": "0.23.0-dev.8",
     "@alloy-js/markdown": "0.23.0-dev.1",
     "@alloy-js/typescript": "0.23.0-dev.4",
-    "@powerlines/deepkit": "^0.6.149",
-    "@powerlines/plugin-alloy": "^0.25.57",
-    "@powerlines/plugin-automd": "^0.1.370",
-    "@powerlines/plugin-deepkit": "^0.11.249",
-    "@powerlines/plugin-nodejs": "^0.1.293",
-    "@powerlines/plugin-tsdown": "^0.1.318",
+    "@powerlines/deepkit": "^0.6.160",
+    "@powerlines/plugin-alloy": "^0.25.68",
+    "@powerlines/plugin-automd": "^0.1.381",
+    "@powerlines/plugin-deepkit": "^0.11.260",
+    "@powerlines/plugin-nodejs": "^0.1.304",
+    "@powerlines/plugin-tsdown": "^0.1.323",
     "@standard-schema/spec": "^1.1.0",
     "@standard-schema/utils": "^0.3.0",
-    "@stryke/cli": "^0.13.35",
-    "@stryke/convert": "^0.6.56",
-    "@stryke/fs": "^0.33.63",
-    "@stryke/helpers": "^0.10.6",
-    "@stryke/json": "^0.14.10",
-    "@stryke/path": "^0.27.2",
-    "@stryke/string-format": "^0.17.6",
-    "@stryke/type-checks": "^0.5.41",
-    "@stryke/types": "^0.11.1",
-    "@stryke/zod": "^0.3.11",
+    "@stryke/cli": "^0.13.36",
+    "@stryke/convert": "^0.6.57",
+    "@stryke/fs": "^0.33.64",
+    "@stryke/helpers": "^0.10.7",
+    "@stryke/json": "^0.14.11",
+    "@stryke/path": "^0.27.3",
+    "@stryke/string-format": "^0.17.7",
+    "@stryke/type-checks": "^0.6.0",
+    "@stryke/types": "^0.11.2",
+    "@stryke/zod": "^0.3.12",
     "automd": "^0.4.3",
     "defu": "^6.1.4",
     "json-schema": "^0.4.0",
-    "tsdown": "^0.21.4"
+    "tsdown": "^0.21.5"
   },
   "devDependencies": {
-    "@powerlines/plugin-plugin": "^0.12.321",
+    "@powerlines/plugin-plugin": "^0.12.332",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.5.0",
-    "powerlines": "^0.42.11",
+    "powerlines": "^0.42.22",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },
   "peerDependencies": { "powerlines": ">=0.42.10", "zod": "^3.25.0 || ^4.0.0" },
   "peerDependenciesMeta": { "zod": { "optional": true } },
   "publishConfig": { "access": "public" },
-  "gitHead": "ce5a0050c63b47111d5b663c65141fe3eb56dba2"
+  "gitHead": "036578a29fdeedf3a93c53a1ea4cf0a180b8f5bb"
 }

package/dist/_virtual/_rolldown/runtime.mjs

@@ -1,3 +0,0 @@
-import "node:module";
-
-export {  };