@shell-shock/core 0.14.3 → 0.14.4

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.14.1-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.14.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)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/dist/plugin.cjs

@@ -156,10 +156,9 @@ const plugin = (options = {}) => {
 				}, this.inputs);
 				this.debug(`Shell Shock will process ${this.inputs.length} command entry files: \n${this.inputs.map((command) => ` - ${command.id}: ${(0, _stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}`).join("\n")}`);
 			},
-			types(code) {
+			types() {
 				this.debug("Generating type definitions for the Shell Shock application.");
-				return `${code}
-
+				return `
 /**
  * The global options available for every command in the ${require_context_helpers.getAppTitle(this, true)} command-line application.
  */

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            framework: \"shell-shock\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: false\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"],\n              skipNodeModulesBundle: true\n            },\n            tsdown: {\n              dts: false,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\n        );\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          if (isSetString(this.config.reference)) {\n            if (this.config.reference.includes(\"{command}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{command}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else {\n              this.config.reference = {\n                app: this.config.reference\n              };\n            }\n          }\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getGlobalOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              tags: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      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                          tags: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${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            framework: \"shell-shock\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: false\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"],\n              skipNodeModulesBundle: true\n            },\n            tsdown: {\n              dts: false,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\n        );\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          if (isSetString(this.config.reference)) {\n            if (this.config.reference.includes(\"{command}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{command}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else {\n              this.config.reference = {\n                app: this.config.reference\n              };\n            }\n          }\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getGlobalOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              tags: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      types() {\n        this.debug(\n          \"Generating type definitions for the Shell Shock application.\"\n        );\n\n        return `\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                          tags: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${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,KA2mBJ,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,KA0mBJ,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,KA2mBJ,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,KA0mBJ,MAAA,CAAO,QAAA"}

package/dist/plugin.mjs

@@ -151,10 +151,9 @@ const plugin = (options = {}) => {
 				}, this.inputs);
 				this.debug(`Shell Shock will process ${this.inputs.length} command entry files: \n${this.inputs.map((command) => ` - ${command.id}: ${replacePath(command.entry.file, this.commandsPath)}`).join("\n")}`);
 			},
-			types(code) {
+			types() {
 				this.debug("Generating type definitions for the Shell Shock application.");
-				return `${code}
-
+				return `
 /**
  * The global options available for every command in the ${getAppTitle(this, true)} command-line application.
  */

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            framework: \"shell-shock\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: false\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"],\n              skipNodeModulesBundle: true\n            },\n            tsdown: {\n              dts: false,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\n        );\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          if (isSetString(this.config.reference)) {\n            if (this.config.reference.includes(\"{command}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{command}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else {\n              this.config.reference = {\n                app: this.config.reference\n              };\n            }\n          }\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getGlobalOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              tags: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      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                          tags: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${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            framework: \"shell-shock\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: false\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"],\n              skipNodeModulesBundle: true\n            },\n            tsdown: {\n              dts: false,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\n        );\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          if (isSetString(this.config.reference)) {\n            if (this.config.reference.includes(\"{command}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{command}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else {\n              this.config.reference = {\n                app: this.config.reference\n              };\n            }\n          }\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getGlobalOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              tags: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      types() {\n        this.debug(\n          \"Generating type definitions for the Shell Shock application.\"\n        );\n\n        return `\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                          tags: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${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

@@ -41,10 +41,7 @@ function resolveCommandOption(ctx, reflection) {
 		default: reflection.getDefaultValue(),
 		variadic: reflection.isArray()
 	};
-	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[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	if (option.variadic) option.kind = extractCommandParameterKind(type.type.kind);
 	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",

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[], 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    !ctx.output.args?.length &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional argument \"${argument.name}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = reflection.getParameters();\n  if (parameters.length > 0) {\n    const hasOptions =\n      parameters[0] &&\n      (parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class);\n    if (hasOptions) {\n      const optionsReflection = ReflectionClass.from(parameters[0]?.type);\n      for (const propertyReflection of optionsReflection.getProperties()) {\n        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    }\n\n    ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(\n      (arg, index) => resolveCommandArgument(ctx, index, arg)\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"deepkit.cjs","names":[],"sources":["../../src/resolver/deepkit.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeArray\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind,\n  Context,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport { mergeCommandParameter } from \"./helpers\";\nimport type { ResolverContext } from \"./types\";\n\nfunction extractCommandParameterKind(\n  type: Type | ReflectionKind\n): CommandParameterKind {\n  const isKind = !(isSetObject(type) && \"kind\" in type);\n  const kind = !isKind ? type.kind : type;\n  if (kind === ReflectionKind.string) {\n    return CommandParameterKinds.string;\n  } else if (\n    kind === ReflectionKind.number ||\n    kind === ReflectionKind.bigint ||\n    (!isKind &&\n      type.kind === ReflectionKind.literal &&\n      (isNumber(type.literal) || isBigInt(type.literal)))\n  ) {\n    return CommandParameterKinds.number;\n  } else if (kind === ReflectionKind.boolean) {\n    return CommandParameterKinds.boolean;\n  } else {\n    return CommandParameterKinds.string;\n  }\n}\n\nfunction resolveCommandOption(\n  ctx: ResolverContext,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n  const existing = (ctx.output.options[reflection.getNameAsString()] ??\n    {}) as Partial<CommandOption>;\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title: reflection.getTags().title?.trim(),\n    description: reflection.getDescription(),\n    kind: extractCommandParameterKind(type),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray()\n  };\n\n  if (option.variadic) {\n    option.kind = extractCommandParameterKind((type as TypeArray).type.kind);\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for positional argument \"${argument.name}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[], number[], or literal[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    argument.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (argument as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (argument as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !ctx.output.args?.length &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional argument \"${argument.name}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = reflection.getParameters();\n  if (parameters.length > 0) {\n    const hasOptions =\n      parameters[0] &&\n      (parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class);\n    if (hasOptions) {\n      const optionsReflection = ReflectionClass.from(parameters[0]?.type);\n      for (const propertyReflection of optionsReflection.getProperties()) {\n        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    }\n\n    ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(\n      (arg, index) => resolveCommandArgument(ctx, index, arg)\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/deepkit.mjs

@@ -40,10 +40,7 @@ function resolveCommandOption(ctx, reflection) {
 		default: reflection.getDefaultValue(),
 		variadic: reflection.isArray()
 	};
-	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[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	if (option.variadic) option.kind = extractCommandParameterKind(type.type.kind);
 	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",

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[], 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    !ctx.output.args?.length &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional argument \"${argument.name}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = reflection.getParameters();\n  if (parameters.length > 0) {\n    const hasOptions =\n      parameters[0] &&\n      (parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class);\n    if (hasOptions) {\n      const optionsReflection = ReflectionClass.from(parameters[0]?.type);\n      for (const propertyReflection of optionsReflection.getProperties()) {\n        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    }\n\n    ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(\n      (arg, index) => resolveCommandArgument(ctx, index, arg)\n    );\n  }\n}\n"],"mappings":";;;;;;;;;AAEA,SAAS,aAAW,IAAM,MAAA;;AAEzB,QAAU;;;CAUV,MAAK,SAAQ,EAAA,YAAmB,KAAG,IAAA,UAAA;;AAEhC,KAAI,SAAS,eAAe;UAG9B,SAAmB,eAAA,UACnB,SAAA,eAAkB,UACd,CAAA,UACJ,KAAA,SAAA,eAAA,YACO,SAAW,KAAO,QAAQ,IAAI,SAAC,KAAA,QAAA,EACjC,QAAA,sBAAA;UAEL,SAAe,eAAA,QACf,QAAA,sBAAkB;KAGZ,QAAC,sBAA0B;;AAGnC,4BAA2B,SAAO;CAAI;OAAW;CAAO;CAAA;CAAA;CAAA;CAAA;AACxD,SAAS,qBAAqB,KAAA,YAAY;CAC1C,MAAO,OAAK,WAAA,SAAA;CACV,MAAA,WAAe,IAAA,OAAA,QAAA,WAAA,iBAAA,KACf,EAAA;CACA,MAAA,SAAA;EACA,MAAO,WAAA,iBAAA;EACP,OAAA,WAAsB,SAAA,CAAA,SAAA,EAAA;EACtB,OAAA,WAAA,SAAA,CAAA,OAAA,MAAA;EACM,aAAS,WAAA,gBAAA;EACT,MAAC,4BAAiC,KAAK;EACvC,UAAC,WAAA,YAAgC;EAClC,SAAO,WAAA,iBAA+B;;EAE7C;AACE,KAAM,WAAO,SAAA,CACZ,KAAA,KAAA,KAAA,SAAqB,eAAA,UAChB,KAAS,KAAE,SAAY,eAAe,QAAQ;AAC1C,SAAI,WACD;AACJ,SAAA,OACC,4BAAA,KAAA,KAAA,KAAA;OAGA,OAAE,IAAA,MAAA,sCAAA,WAAA,iBAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,mEAAA,cAAA,KAAA,CACG,MAAG,CACJ,WAAY,OAAK,QAAS,CAAA,GAAK;UAGlC,KAAK,SAAI,eAAe,OAAS;AAC1C,SAAO,OAAA,KAAA,MAAsB,MAAA,cAAO,MAAA,EAAA,SAAA,eAAA,UAC/B,EAAA,SAAA,eAAA,YACE,SAAA,EAAA,QAAsB,IAAM,SAAA,EAAA,QAAA,GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,GACrC,sBAAA,SACF,sBAAA;mBAES,KAAA,MACF,IAAA,cAAe,MAAA,EAAA,SAAA,eAAA,UACR,SAAA,EAAA,QAAA,GACG,EAAA,UACF,SAAW,EAAO,QAAE,GACX,OAAO,EAAA,QAAQ,GACpB,SAAc,EAAA,QAAA,sBAEhB,OAAA,EAAA,QAAA,GACP,MAAW;GAAA;GAAA;GAAA;GAAiB,CAAA,CAAA,CAC3B,OAAW,QAAU;YAE5B,KAAa,SAAU,eAAe,QAClC,QAAE,UAAA,CACE,SAAE,KAAW,QAAA,GACZ,KAAU,UACT,SAAW,KAAO,QAAC,GAC9B,OAAA,KAAA,QAAA,4BAEuB,KAAE,QAAA,SACrB,OAAA,KAAA,QAAA,CACA,CAAA,OAAQ,QAAU;UAEnB,CAAA,SAAA,QACC,KAAM,SAAI,eAAA,WACT,KAAI,SAAA,eAAA,UACL,KAAM,SAAI,eAAA,OACT,OAAA,IAAA,MAAA,gCAAgD,WAAW,iBAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,4FAAA,cAAA,KAAA,CACtD,MAAM,CACN,WAAO,OAAA,QAAA,CAAA,GAAA;AAEhB,QAAO,sBAAU,UAAA,OAAA;;AAErB,qBAAoB,SAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAC5B,SAAS,uBAAkB,KAAU,OAAG,YAAc;CAClD,MAAM,OAAA,WAAA,SAAA;CACN,MAAI,WAAA,IAAA,OAAA,KAAA,SAAA,QAAA,IAAA,OAAA,KAAA,SAAA,EAAA;CACJ,MAAM,WAAM;EACR,MAAG,WAAc,SAAS,IAAI,WAAC,UAAA;EAChC,OAAA,WAAA,UAAA;EACH,MAAA,4BAAA,KAAA,KAAA;EACI,OAAK,WAAa,UAAC,IAAA,WAAsB,UAAA,MAAA;EAC7C,aAAc,WAAW,UAAK;EAC1B,UAAC,WAAA,YAAA;EACD,SAAS,WAAE,iBAAuB;EACrC;AACD,KAAI,KAAG,SAAW,eAAY,MAC9B,KAAA,KAAA,KAAA,SAAA,eAAA,UACI,KAAA,KAAA,SAAsB,eAAA,QAAA;AACtB,WAAA;AAEI,WAAG,OACJ,4BAAA,KAAA,KAAA,KAAA;OAGC,OAAE,IAAQ,MAAG,mDAAO,SAAA,KAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,mEAAA,cAAA,KAAA,CACf,MAAC,CACF,WAAW,OAAO,QAAA,CAAA,GAAA;UAGrB,KAAK,SAAI,eAAQ,OAAA;AACtB,WAAS,OAAG,KAAS,MAAA,MAAO,cAAA,MAAA,EAAA,SAAA,eAAA,UACvB,EAAC,SAAA,eAAA,YACN,SAAA,EAAA,QAAA,IAAA,SAAA,EAAA,QAAA,GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,GACC,sBAA2B,SACvB,sBAAc;AACtB,WAAU,UACT,KAAS,MACA,IAAA,cAAA,MAAA,EAAA,SAAA,eAAA,UACG,SAAM,EAAA,QAAO,GACZ,EAAK,UACH,SAAK,EAAO,QAAA,GACP,OAAC,EAAA,QAAA,GACD,SAAO,EAAA,QAAA,GACR,EAAO,QAAI,SACxB,OAAA,EAAA,QAAA,GACM,MAAE;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,CACH,OAAC,QAAc;YAEnB,KAAK,SAAA,eAAe,QAC7B,UAAA,UAAA,CACM,SAAS,KAAA,QAAA,GACD,KAAK,UACL,SAAQ,KAAA,QAAA,GACJ,OAAO,KAAE,QAAS,GAChC,SAAA,KAAA,QAAA,GACF,KAAA,QAAA,SACQ,OAAA,KAAA,QAAA,CACL,CAAA,OAAA,QAAgB;UAEvB,CAAA,IAAA,OAAA,MAAA,kDAEM,KAAC,SAAA,eAAsB,UAC/B,KAAA,SAAA,eAAA,0OAES,MAAA,CACF,WAAe,OAAA,QAAA,CAAA,GAAA;AAEpB,QAAA,sBAAY,UAAA,UAAA,EACX,MAAA,MAAgB,SACjB,CAAA;;AAEF,uBAAoB,SAAS;CAAA;CAAuB;CAAO;CAAI;CAAA;CAAA;CAAA;CAAA;CAAA;AAC/D,SAAe,oBAAgB,KAAA;;CAE7B,MAAM,OAAS,QAAE,OAAA;AACf,KAAI,KAAE,SAAW,eAAa,SAC9B,OAAO,IAAA,MAAW,2BAAU,MAAA,QAAA,MAAA,OAAA,QAAA,MAAA,QAAA,KAAA,qCAAA;CAE5B,MAAM,aAAY,IAAA,mBAAwB,KAAC;AAC3C,KAAA,OAAW,gBAAa,IAAA,MAAU,QAAW,eAC7C,WAAU,gBAAqB,IAC/B,KAAS;CACV,MAAA,aAAA,WAAA,eAAA;;EAEG,MAAK,aAAS,WAAe,OAC5B,WAAA,GAAA,KAAA,SAAA,eAAA,iBACS,WAAS,GAAA,KAAA,SAAe,eAAQ;AAC1C,MAAK,YAAa;GAClB,MAAA,oBAAA,gBAAA,KAAA,WAAA,IAAA,KAAA;AACC,QAAS,MAAG,sBAAyB,kBAAA,eAAiC,CACjE,KAAA,OAAA,QAAA,mBAAA,iBAAA,IACO,qBAAsB,KAAG,mBAAA;;AAGtC,MAAM,OAAI,QAAK,aAAA,WAAA,MAAA,EAAA,GAAA,YAAA,IAAA,cAAA,KAAA,UAAA,uBAAA,KAAA,OAAA,IAAA,EAAA;GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;;;AAGrB,oBAAiB,SAAU;CAAA;CAAsB;CAAK;CAAsB;CAAa"}
+{"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 (option.variadic) {\n    option.kind = extractCommandParameterKind((type as TypeArray).type.kind);\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for positional argument \"${argument.name}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[], number[], or literal[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    argument.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (argument as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (argument as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !ctx.output.args?.length &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional argument \"${argument.name}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = reflection.getParameters();\n  if (parameters.length > 0) {\n    const hasOptions =\n      parameters[0] &&\n      (parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class);\n    if (hasOptions) {\n      const optionsReflection = ReflectionClass.from(parameters[0]?.type);\n      for (const propertyReflection of optionsReflection.getProperties()) {\n        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    }\n\n    ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(\n      (arg, index) => resolveCommandArgument(ctx, index, arg)\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/types/command.cjs

@@ -54,8 +54,9 @@ const __ΩBaseCommandParameter = [
 	false,
 	"env",
 	"optional",
+	"variadic",
 	"BaseCommandParameter",
-	"P&4!n\"4#&4$&4%&F4&P&.'J4()4)Mw*y"
+	"P&4!n\"4#&4$&4%&F4&P&.'J4()4))4*Mw+y"
 ];
 const __ΩStringCommandParameter = [
 	() => __ΩBaseCommandParameter,
@@ -72,20 +73,18 @@ const __ΩStringCommandParameter = [
 	"date-time",
 	"duration",
 	"format",
-	"variadic",
 	"choices",
 	"StringCommandParameter",
-	"Pn!.\"4#&4$8P.%.&.'.(.).*.+.,.-J4.8)4/&F408Mw1y"
+	"Pn!.\"4#&4$8P.%.&.'.(.).*.+.,.-J4.8&F4/8Mw0y"
 ];
 const __ΩNumberCommandParameter = [
 	() => __ΩBaseCommandParameter,
 	"number",
 	"kind",
 	"default",
-	"variadic",
 	"choices",
 	"NumberCommandParameter",
-	"Pn!.\"4#'4$8)4%'F4&8Mw'y"
+	"Pn!.\"4#'4$8'F4%8Mw&y"
 ];
 const __ΩBooleanCommandParameter = [
 	() => __ΩBaseCommandParameter,

package/dist/types/command.cjs.map

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

package/dist/types/command.d.cts

@@ -42,6 +42,10 @@ interface BaseCommandParameter {
    * Whether the option is optional.
    */
   optional: boolean;
+  /**
+   * Whether the option accepts multiple values.
+   */
+  variadic: boolean;
 }
 interface StringCommandParameter extends BaseCommandParameter {
   /**
@@ -56,10 +60,6 @@ interface StringCommandParameter extends BaseCommandParameter {
    * A standard string format to validate the option value against.
    */
   format?: "email" | "uri" | "uuid" | "ipv4" | "ipv6" | "date" | "time" | "date-time" | "duration";
-  /**
-   * Whether the option accepts multiple values.
-   */
-  variadic: boolean;
   /**
    * The allowed choices for the option value.
    */
@@ -74,10 +74,6 @@ interface NumberCommandParameter extends BaseCommandParameter {
    * The default value.
    */
   default?: number;
-  /**
-   * Whether the option accepts multiple values.
-   */
-  variadic: boolean;
   /**
    * The allowed choices for the option value.
    */

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.cts","names":[],"sources":["../../src/types/command.ts"],"mappings":";;;;;;;;KAyBY,oBAAA;AAAA,cAMC,qBAAA;EAAA;;;;KAMD,oBAAA,WACF,qBAAA,eAAoC,qBAAA;AAAA,UAE7B,oBAAA;EALP;;;EASR,IAAA;;;;EAKA,IAAA,EAAM,oBAAA;EAZI;;;EAiBV,KAAA;EAhBiE;AAEnE;;EAmBE,WAAA;EAV0B;;;EAe1B,KAAA;EAVA;;;EAeA,GAAA;EAKA;;;EAAA,QAAA;AAAA;AAAA,UAGe,sBAAA,SAA+B,oBAAA;EAAoB;;;EAIlE,IAAA;EAUA;;;EALA,OAAA;EAwBO;AAGT;;EAtBE,MAAA;EAsBkE;;;EARlE,QAAA;EAsBA;;;EAjBA,OAAA;AAAA;AAAA,UAGe,sBAAA,SAA+B,oBAAA;;;;EAI9C,IAAA;EA2BA;;;EAtBA,OAAA;EAyB0B;;;EApB1B,QAAA;EAuBE;;;EAlBF,OAAA;AAAA;AAAA,UAGe,uBAAA,SAAgC,oBAAA;EAetB;;AAE3B;EAbE,IAAA;EAakC;;;EARlC,OAAA;AAAA;AAAA,KAGU,gBAAA,GACR,sBAAA,GACA,sBAAA,GACA,uBAAA;AAAA,KAEQ,wBAAA,WAAmC,oBAAA,IAAwB,IAAA,CACrE,CAAA,sBAGA,OAAA,CAAQ,IAAA,CAAK,CAAA;EACX,KAAA;AAAA;AAAA,KAGQ,4BAAA,GACV,wBAAA,CAAyB,sBAAA;AAAA,KACf,4BAAA,GACV,wBAAA,CAAyB,sBAAA;AAAA,KACf,6BAAA,GACV,wBAAA,CAAyB,uBAAA;AAAA,KAEf,sBAAA,GACR,4BAAA,GACA,4BAAA,GACA,6BAAA;AAAA,UAEa,oBAAA,SAA6B,uBAAA;EAhBpC;;;EAoBR,YAAA;EAnBO;AAGT;;EAqBE,kBAAA;AAAA;AAAA,KAGU,aAAA,GACR,sBAAA,GACA,sBAAA,GACA,oBAAA;AAAA,KACQ,mBAAA,GAAsB,wBAAA,CAAyB,aAAA;AAAA,KAE/C,eAAA,GACR,sBAAA,GACA,sBAAA,GACA,uBAAA;AAAA,KACQ,qBAAA,GAAwB,wBAAA,CAAyB,eAAA;AAAA,UAE5C,WAAA;EAjCgC;AACjD;;EAoCE,EAAA;EAnCA;;AAEF;EAsCE,IAAA;;;;EAKA,IAAA;EAxC+B;;;EA6C/B,QAAA;EA7CE;;;EAkDF,KAAA;EAhDoC;;;EAqDpC,WAAA;EAjDA;;;EAsDA,KAAA;EA9CU;;;EAmDV,IAAA;EAjDE;;;EAsDF,SAAA;EAvDE;;;;;AAGJ;EA4DE,SAAA;AAAA;AAAA,UAGe,aAAA,SAAsB,WAAA;EA/DiC;AAExE;;EAiEE,EAAA;EAhEE;;;EAqEF,KAAA,EAAO,2BAAA;EAnEkB;;;;;;EA2EzB,IAAA;AAAA;AAAA,KAGU,WAAA,GAAc,aAAA;EA7EU;;AAEpC;EA+EE,KAAA;;;;EAKA,WAAA;EAtEA;;;EA2EA,KAAA;EAvDA;;;;;;EA+DA,IAAA;EA1C6B;;;EA+C7B,OAAA,EAAS,MAAA,SAAe,aAAA;EA3CxB;;;EAgDA,IAAA,EAAM,eAAA;EAnCF;;AAGN;EAqCE,MAAA,SAAe,WAAA;;;;EAKf,QAAA,EAAU,MAAA,SAAe,WAAA;AAAA;AAAA,KAGf,qBAAA,GAAwB,IAAA,CAAK,WAAA;EAHd;;;EAOzB,MAAA;EAjDwB;;;EAqDxB,QAAA,EAAU,MAAA,SAAe,qBAAA;AAAA;AAAA,UAGV,eAAA;EA7BN;;;;;;EAoCT,KAAA;EArBU;;;;AAGZ;;EA0BE,WAAA;EA1BuC;;;EA+BvC,KAAA;EAvBgB;;;;;;EA+BhB,IAAA;EA/ByB;;;AAG3B;;;EAoCE,IAAA;EA7BA;;;;;;EAqCA,SAAA;AAAA;AAAA,UAGe,aAAA;EACf,QAAA,GAAW,eAAA;EACX,OAAA,GACI,MAAA,SAAe,mBAAA,IACf,iBAAA,GACA,oBAAA,CAAqB,MAAA,SAAe,oBAAA,KACpC,EAAA,CAAG,YAAA;EACP,IAAA,GACI,qBAAA,KACA,oBAAA,GACA,oBAAA,CAAqB,oBAAA,MACrB,EAAA,CAAG,WAAA;EACP,OAAA,GAAU,WAAA;AAAA"}
+{"version":3,"file":"command.d.cts","names":[],"sources":["../../src/types/command.ts"],"mappings":";;;;;;;;KAyBY,oBAAA;AAAA,cAMC,qBAAA;EAAA;;;;KAMD,oBAAA,WACF,qBAAA,eAAoC,qBAAA;AAAA,UAE7B,oBAAA;EALP;;;EASR,IAAA;;;;EAKA,IAAA,EAAM,oBAAA;EAZI;;;EAiBV,KAAA;EAhBiE;AAEnE;;EAmBE,WAAA;EAV0B;;;EAe1B,KAAA;EAVA;;;EAeA,GAAA;EAKA;;;EAAA,QAAA;EAQe;;;EAHf,QAAA;AAAA;AAAA,UAGe,sBAAA,SAA+B,oBAAA;EAS9C;;;EALA,IAAA;EAwBO;AAGT;;EAtBE,OAAA;EAsBkE;;;EAjBlE,MAAA;EA+BA;;;EAjBA,OAAA;AAAA;AAAA,UAGe,sBAAA,SAA+B,oBAAA;EAiBqB;;;EAbnE,IAAA;EAsBO;;AAGT;EApBE,OAAA;;;;EAKA,OAAA;AAAA;AAAA,UAGe,uBAAA,SAAgC,oBAAA;EAa7C;;;EATF,IAAA;EAWyB;AAE3B;;EARE,OAAA;AAAA;AAAA,KAGU,gBAAA,GACR,sBAAA,GACA,sBAAA,GACA,uBAAA;AAAA,KAEQ,wBAAA,WAAmC,oBAAA,IAAwB,IAAA,CACrE,CAAA,sBAGA,OAAA,CAAQ,IAAA,CAAK,CAAA;EACX,KAAA;AAAA;AAAA,KAGQ,4BAAA,GACV,wBAAA,CAAyB,sBAAA;AAAA,KACf,4BAAA,GACV,wBAAA,CAAyB,sBAAA;AAAA,KACf,6BAAA,GACV,wBAAA,CAAyB,uBAAA;AAAA,KAEf,sBAAA,GACR,4BAAA,GACA,4BAAA,GACA,6BAAA;AAAA,UAEa,oBAAA,SAA6B,uBAAA;EApByB;;;EAwBrE,YAAA;EApBa;;;EAyBb,kBAAA;AAAA;AAAA,KAGU,aAAA,GACR,sBAAA,GACA,sBAAA,GACA,oBAAA;AAAA,KACQ,mBAAA,GAAsB,wBAAA,CAAyB,aAAA;AAAA,KAE/C,eAAA,GACR,sBAAA,GACA,sBAAA,GACA,uBAAA;AAAA,KACQ,qBAAA,GAAwB,wBAAA,CAAyB,eAAA;AAAA,UAE5C,WAAA;EAlCuB;;;EAsCtC,EAAA;EApCU;;;EAyCV,IAAA;EAxCgD;AAElD;;EA2CE,IAAA;EA1CE;;;EA+CF,QAAA;EA7C+B;;;EAkD/B,KAAA;EAlD+B;;AAEjC;EAqDE,WAAA;;;;EAKA,KAAA;EAjDA;;;EAsDA,IAAA;EAnDuB;;;EAwDvB,SAAA;EArDE;;;;;;EA6DF,SAAA;AAAA;AAAA,UAGe,aAAA,SAAsB,WAAA;EA/DR;;;EAmE7B,EAAA;EAjEU;;;EAsEV,KAAA,EAAO,2BAAA;EApEL;;;;;;EA4EF,IAAA;AAAA;AAAA,KAGU,WAAA,GAAc,aAAA;EA7Ed;;;EAiFV,KAAA;EAjF0E;AAE5E;;EAoFE,WAAA;EApF0B;;;EAyF1B,KAAA;EAtEA;;;;;;EA8EA,IAAA;EA7CS;;AAGX;EA+CE,OAAA,EAAS,MAAA,SAAe,aAAA;;;;EAKxB,IAAA,EAAM,eAAA;EA3CN;;;EAgDA,MAAA,SAAe,WAAA;EAxCX;AAGN;;EA0CE,QAAA,EAAU,MAAA,SAAe,WAAA;AAAA;AAAA,KAGf,qBAAA,GAAwB,IAAA,CAAK,WAAA;EAlB9B;;;EAsBT,MAAA;EAPU;;;EAWV,QAAA,EAAU,MAAA,SAAe,qBAAA;AAAA;AAAA,UAGV,eAAA;EA1Cf;;;;;;EAiDA,KAAA;EA1BA;;;;;;EAkCA,WAAA;EA1BU;;;EA+BV,KAAA;EA/BkC;;;;;;EAuClC,IAAA;EAnCA;;;;;;EA2CA,IAAA;EApC8B;;;;;;EA4C9B,SAAA;AAAA;AAAA,UAGe,aAAA;EACf,QAAA,GAAW,eAAA;EACX,OAAA,GACI,MAAA,SAAe,mBAAA,IACf,iBAAA,GACA,oBAAA,CAAqB,MAAA,SAAe,oBAAA,KACpC,EAAA,CAAG,YAAA;EACP,IAAA,GACI,qBAAA,KACA,oBAAA,GACA,oBAAA,CAAqB,oBAAA,MACrB,EAAA,CAAG,WAAA;EACP,OAAA,GAAU,WAAA;AAAA"}

package/dist/types/command.d.mts

@@ -42,6 +42,10 @@ interface BaseCommandParameter {
    * Whether the option is optional.
    */
   optional: boolean;
+  /**
+   * Whether the option accepts multiple values.
+   */
+  variadic: boolean;
 }
 interface StringCommandParameter extends BaseCommandParameter {
   /**
@@ -56,10 +60,6 @@ interface StringCommandParameter extends BaseCommandParameter {
    * A standard string format to validate the option value against.
    */
   format?: "email" | "uri" | "uuid" | "ipv4" | "ipv6" | "date" | "time" | "date-time" | "duration";
-  /**
-   * Whether the option accepts multiple values.
-   */
-  variadic: boolean;
   /**
    * The allowed choices for the option value.
    */
@@ -74,10 +74,6 @@ interface NumberCommandParameter extends BaseCommandParameter {
    * The default value.
    */
   default?: number;
-  /**
-   * Whether the option accepts multiple values.
-   */
-  variadic: boolean;
   /**
    * The allowed choices for the option value.
    */

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.mts","names":[],"sources":["../../src/types/command.ts"],"mappings":"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"}
+{"version":3,"file":"command.d.mts","names":[],"sources":["../../src/types/command.ts"],"mappings":"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"}

package/dist/types/command.mjs

@@ -52,8 +52,9 @@ const __ΩBaseCommandParameter = [
 	false,
 	"env",
 	"optional",
+	"variadic",
 	"BaseCommandParameter",
-	"P&4!n\"4#&4$&4%&F4&P&.'J4()4)Mw*y"
+	"P&4!n\"4#&4$&4%&F4&P&.'J4()4))4*Mw+y"
 ];
 const __ΩStringCommandParameter = [
 	() => __ΩBaseCommandParameter,
@@ -70,20 +71,18 @@ const __ΩStringCommandParameter = [
 	"date-time",
 	"duration",
 	"format",
-	"variadic",
 	"choices",
 	"StringCommandParameter",
-	"Pn!.\"4#&4$8P.%.&.'.(.).*.+.,.-J4.8)4/&F408Mw1y"
+	"Pn!.\"4#&4$8P.%.&.'.(.).*.+.,.-J4.8&F4/8Mw0y"
 ];
 const __ΩNumberCommandParameter = [
 	() => __ΩBaseCommandParameter,
 	"number",
 	"kind",
 	"default",
-	"variadic",
 	"choices",
 	"NumberCommandParameter",
-	"Pn!.\"4#'4$8)4%'F4&8Mw'y"
+	"Pn!.\"4#'4$8'F4%8Mw&y"
 ];
 const __ΩBooleanCommandParameter = [
 	() => __ΩBaseCommandParameter,

package/dist/types/command.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.14.3",
+  "version": "0.14.4",
   "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,12 +350,12 @@
     "@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.162",
-    "@powerlines/plugin-alloy": "^0.25.70",
-    "@powerlines/plugin-automd": "^0.1.383",
-    "@powerlines/plugin-deepkit": "^0.11.262",
-    "@powerlines/plugin-nodejs": "^0.1.306",
-    "@powerlines/plugin-tsdown": "^0.1.325",
+    "@powerlines/deepkit": "^0.6.163",
+    "@powerlines/plugin-alloy": "^0.26.0",
+    "@powerlines/plugin-automd": "^0.1.384",
+    "@powerlines/plugin-deepkit": "^0.11.263",
+    "@powerlines/plugin-nodejs": "^0.1.307",
+    "@powerlines/plugin-tsdown": "^0.1.326",
     "@standard-schema/spec": "^1.1.0",
     "@standard-schema/utils": "^0.3.0",
     "@stryke/cli": "^0.13.36",
@@ -371,18 +371,18 @@
     "automd": "^0.4.3",
     "defu": "^6.1.4",
     "json-schema": "^0.4.0",
-    "tsdown": "^0.21.6"
+    "tsdown": "^0.21.7"
   },
   "devDependencies": {
-    "@powerlines/plugin-plugin": "^0.12.334",
+    "@powerlines/plugin-plugin": "^0.12.335",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.5.0",
-    "powerlines": "^0.42.24",
+    "powerlines": "^0.42.25",
     "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": "27a9e457bd50dd3576a1edf1882f43d82a402743"
+  "gitHead": "d123fb843b98e07d65b61f69f3f6a74b68ddc3b0"
 }