@shell-shock/core 0.11.0 → 0.12.1

package/dist/plugin.cjs

@@ -3,8 +3,8 @@ const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
 const require_context_helpers = require('./plugin-utils/context-helpers.cjs');
 const require_components_docs = require('./components/docs.cjs');
 const require_components_utils_builtin = require('./components/utils-builtin.cjs');
-const require_get_command_tree = require('./plugin-utils/get-command-tree.cjs');
 const require_traverse_command_tree = require('./plugin-utils/traverse-command-tree.cjs');
+const require_get_command_tree = require('./plugin-utils/get-command-tree.cjs');
 const require_automd = require('./helpers/automd.cjs');
 const require_paths = require('./helpers/paths.cjs');
 const require_persistence = require('./helpers/persistence.cjs');
@@ -54,14 +54,12 @@ const plugin = (options = {}) => {
 			async config() {
 				this.debug("Resolving the Shell Shock configuration.");
 				await require_update_package_json.updatePackageJsonBinary(this);
-				const result = (0, defu.defu)({ output: { buildPath: (0, __stryke_path_join_paths.joinPaths)(this.config.root, "dist") } }, options, {
+				return (0, defu.defu)({ output: { buildPath: (0, __stryke_path_join_paths.joinPaths)(this.config.root, "dist") } }, options, {
 					name: require_context_helpers.getAppName(this),
 					title: require_context_helpers.getAppTitle(this),
 					description: require_context_helpers.getAppDescription(this),
 					platform: "node",
 					projectType: "application",
-					envPrefix: (0, __stryke_string_format_constant_case.constantCase)(require_context_helpers.getAppName(this)),
-					env: { prefix: [] },
 					isCaseSensitive: false,
 					output: {
 						format: "esm",
@@ -75,14 +73,14 @@ const plugin = (options = {}) => {
 						unbundle: false
 					}
 				});
-				if (!result.env.prefix || !Array.isArray(result.env.prefix)) result.env.prefix = (0, __stryke_convert_to_array.toArray)(result.env.prefix);
-				if (!result.env.prefix.includes(result.envPrefix)) result.env.prefix.push(result.envPrefix);
-				return result;
 			},
 			configResolved: {
 				order: "pre",
 				async handler() {
 					this.debug("Shell Shock configuration has been resolved.");
+					this.config.appSpecificEnvPrefix = (0, __stryke_type_checks_is_set_string.isSetString)(this.config.autoAssignEnv) ? this.config.autoAssignEnv : (0, __stryke_string_format_constant_case.constantCase)(require_context_helpers.getAppName(this));
+					if (!this.config.env.prefix || !Array.isArray(this.config.env.prefix)) this.config.env.prefix = (0, __stryke_convert_to_array.toArray)(this.config.env.prefix);
+					if (!this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)) this.config.env.prefix.push(this.config.appSpecificEnvPrefix);
 					this.config.bin = ((0, __stryke_type_checks_is_set_string.isSetString)(this.packageJson.bin) ? { [(0, __stryke_string_format_kebab_case.kebabCase)(this.config.name)]: this.packageJson.bin } : this.packageJson.bin) ?? { [(0, __stryke_string_format_kebab_case.kebabCase)(this.config.name)]: require_update_package_json.formatBinaryPath(this.config.output.format) };
 					this.inputs ??= [];
 					this.options = Object.values(require_utilities.getDefaultOptions(this, {

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs","names":["For","Show","render","automd","deepkit","nodejs","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isObject","isSetObject","isSetString","defu","tsdown","resolveInputs","CommandDocsFile","UtilsBuiltin","commands","findCommandsRoot","resolveCommandId","resolveCommandName","resolveCommandPath","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","resolve","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","root","title","description","platform","projectType","envPrefix","env","prefix","isCaseSensitive","format","dts","input","Array","isArray","length","Object","keys","undefined","external","nodeProtocol","unbundle","includes","push","configResolved","order","handler","bin","packageJson","inputs","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","reduce","ret","entry","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","context","option","optional","fromEntries","entries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","generators","docs","each","doubleHardline","children","child","when","shellShock"],"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 { isSetObject } from \"@stryke/type-checks/is-set-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 { OutputOptions, RenderedChunk } from \"rolldown\";\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, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport { resolve } from \"./resolver/resolve\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n) => {\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              buildPath: 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            envPrefix: constantCase(getAppName(this)),\n            env: {\n              prefix: [] as string[]\n            },\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"]\n            },\n            tsdown: {\n              dts: true,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\n        );\n\n        if (!result.env.prefix || !Array.isArray(result.env.prefix)) {\n          result.env.prefix = toArray(result.env.prefix);\n        }\n        if (!result.env.prefix.includes(result.envPrefix)) {\n          result.env.prefix.push(result.envPrefix);\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.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          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(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.commandsPath = findCommandsRoot(this);\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${command.name} \\n\\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:resolve-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping command resolution as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await resolve({\n                context: this,\n                command: input\n              });\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.tsdown.outputOptions ??= {} as any;\n        if (isObject(this.config.tsdown.outputOptions)) {\n          (\n            this.config.tsdown.outputOptions as NonNullable<OutputOptions>\n          ).banner = (chunk: RenderedChunk) => {\n            if (\n              chunk.isEntry &&\n              joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n            ) {\n              this.debug(\n                `Adding hashbang to binary executable output file: ${\n                  chunk.fileName\n                }`\n              );\n\n              return `#!/usr/bin/env ${\n                this.config.mode === \"development\"\n                  ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                  : \"\"\n              } node\\n`;\n            }\n            return \"\";\n          };\n        }\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\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\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\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":["For","Show","render","automd","deepkit","nodejs","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isObject","isSetObject","isSetString","defu","tsdown","resolveInputs","CommandDocsFile","UtilsBuiltin","commands","findCommandsRoot","resolveCommandId","resolveCommandName","resolveCommandPath","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","resolve","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","root","title","description","platform","projectType","isCaseSensitive","format","dts","input","Array","isArray","length","Object","keys","undefined","external","nodeProtocol","unbundle","configResolved","order","handler","appSpecificEnvPrefix","autoAssignEnv","env","prefix","includes","push","bin","packageJson","inputs","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","reduce","ret","entry","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","context","option","optional","fromEntries","entries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","generators","docs","each","doubleHardline","children","child","when","shellShock"],"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 { isSetObject } from \"@stryke/type-checks/is-set-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 { OutputOptions, RenderedChunk } from \"rolldown\";\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, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport { resolve } from \"./resolver/resolve\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n) => {\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              buildPath: joinPaths(this.config.root, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            platform: \"node\",\n            projectType: \"application\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"]\n            },\n            tsdown: {\n              dts: true,\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          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(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.commandsPath = findCommandsRoot(this);\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${command.name} \\n\\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:resolve-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping command resolution as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await resolve({\n                context: this,\n                command: input\n              });\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.tsdown.outputOptions ??= {} as any;\n        if (isObject(this.config.tsdown.outputOptions)) {\n          (\n            this.config.tsdown.outputOptions as NonNullable<OutputOptions>\n          ).banner = (chunk: RenderedChunk) => {\n            if (\n              chunk.isEntry &&\n              joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n            ) {\n              this.debug(\n                `Adding hashbang to binary executable output file: ${\n                  chunk.fileName\n                }`\n              );\n\n              return `#!/usr/bin/env ${\n                this.config.mode === \"development\"\n                  ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                  : \"\"\n              } node\\n`;\n            }\n            return \"\";\n          };\n        }\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\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\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\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"],"sourcesContent":[],"mappings":";;;;;;;;AAkFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GA2fjC,MA3fiC,CA2f1B,QA3f0B,CAAA,EAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAkFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAkgBjC,MAlgBiC,CAkgB1B,QAlgB0B,CAAA,EAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAkFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GA2fjC,MA3fiC,CA2f1B,QA3f0B,CAAA,EAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAkFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAkgBjC,MAlgBiC,CAkgB1B,QAlgB0B,CAAA,EAAA"}

package/dist/plugin.mjs

@@ -1,8 +1,8 @@
 import { getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, isPathSegmentGroup } from "./plugin-utils/context-helpers.mjs";
 import { CommandDocsFile } from "./components/docs.mjs";
 import { UtilsBuiltin } from "./components/utils-builtin.mjs";
-import { getCommandTree } from "./plugin-utils/get-command-tree.mjs";
 import { traverseCommands } from "./plugin-utils/traverse-command-tree.mjs";
+import { getCommandTree } from "./plugin-utils/get-command-tree.mjs";
 import { commands } from "./helpers/automd.mjs";
 import { findCommandsRoot, resolveCommandId, resolveCommandName, resolveCommandPath } from "./helpers/paths.mjs";
 import { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence } from "./helpers/persistence.mjs";
@@ -49,14 +49,12 @@ const plugin = (options = {}) => {
 			async config() {
 				this.debug("Resolving the Shell Shock configuration.");
 				await updatePackageJsonBinary(this);
-				const result = defu$1({ output: { buildPath: joinPaths(this.config.root, "dist") } }, options, {
+				return defu$1({ output: { buildPath: joinPaths(this.config.root, "dist") } }, options, {
 					name: getAppName(this),
 					title: getAppTitle(this),
 					description: getAppDescription(this),
 					platform: "node",
 					projectType: "application",
-					envPrefix: constantCase(getAppName(this)),
-					env: { prefix: [] },
 					isCaseSensitive: false,
 					output: {
 						format: "esm",
@@ -70,14 +68,14 @@ const plugin = (options = {}) => {
 						unbundle: false
 					}
 				});
-				if (!result.env.prefix || !Array.isArray(result.env.prefix)) result.env.prefix = toArray(result.env.prefix);
-				if (!result.env.prefix.includes(result.envPrefix)) result.env.prefix.push(result.envPrefix);
-				return result;
 			},
 			configResolved: {
 				order: "pre",
 				async handler() {
 					this.debug("Shell Shock configuration has been resolved.");
+					this.config.appSpecificEnvPrefix = isSetString(this.config.autoAssignEnv) ? this.config.autoAssignEnv : constantCase(getAppName(this));
+					if (!this.config.env.prefix || !Array.isArray(this.config.env.prefix)) this.config.env.prefix = toArray(this.config.env.prefix);
+					if (!this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)) this.config.env.prefix.push(this.config.appSpecificEnvPrefix);
 					this.config.bin = (isSetString(this.packageJson.bin) ? { [kebabCase(this.config.name)]: this.packageJson.bin } : this.packageJson.bin) ?? { [kebabCase(this.config.name)]: formatBinaryPath(this.config.output.format) };
 					this.inputs ??= [];
 					this.options = Object.values(getDefaultOptions(this, {

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":["For","Show","render","automd","deepkit","nodejs","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isObject","isSetObject","isSetString","defu","tsdown","resolveInputs","CommandDocsFile","UtilsBuiltin","commands","findCommandsRoot","resolveCommandId","resolveCommandName","resolveCommandPath","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","resolve","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","root","title","description","platform","projectType","envPrefix","env","prefix","isCaseSensitive","format","dts","input","Array","isArray","length","Object","keys","undefined","external","nodeProtocol","unbundle","includes","push","configResolved","order","handler","bin","packageJson","inputs","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","reduce","ret","entry","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","context","option","optional","fromEntries","entries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","generators","docs","each","doubleHardline","children","child","when","shellShock"],"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 { isSetObject } from \"@stryke/type-checks/is-set-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 { OutputOptions, RenderedChunk } from \"rolldown\";\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, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport { resolve } from \"./resolver/resolve\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n) => {\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              buildPath: 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            envPrefix: constantCase(getAppName(this)),\n            env: {\n              prefix: [] as string[]\n            },\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"]\n            },\n            tsdown: {\n              dts: true,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\n        );\n\n        if (!result.env.prefix || !Array.isArray(result.env.prefix)) {\n          result.env.prefix = toArray(result.env.prefix);\n        }\n        if (!result.env.prefix.includes(result.envPrefix)) {\n          result.env.prefix.push(result.envPrefix);\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.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          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(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.commandsPath = findCommandsRoot(this);\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${command.name} \\n\\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:resolve-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping command resolution as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await resolve({\n                context: this,\n                command: input\n              });\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.tsdown.outputOptions ??= {} as any;\n        if (isObject(this.config.tsdown.outputOptions)) {\n          (\n            this.config.tsdown.outputOptions as NonNullable<OutputOptions>\n          ).banner = (chunk: RenderedChunk) => {\n            if (\n              chunk.isEntry &&\n              joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n            ) {\n              this.debug(\n                `Adding hashbang to binary executable output file: ${\n                  chunk.fileName\n                }`\n              );\n\n              return `#!/usr/bin/env ${\n                this.config.mode === \"development\"\n                  ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                  : \"\"\n              } node\\n`;\n            }\n            return \"\";\n          };\n        }\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\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\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\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":["For","Show","render","automd","deepkit","nodejs","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isObject","isSetObject","isSetString","defu","tsdown","resolveInputs","CommandDocsFile","UtilsBuiltin","commands","findCommandsRoot","resolveCommandId","resolveCommandName","resolveCommandPath","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","resolve","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","root","title","description","platform","projectType","isCaseSensitive","format","dts","input","Array","isArray","length","Object","keys","undefined","external","nodeProtocol","unbundle","configResolved","order","handler","appSpecificEnvPrefix","autoAssignEnv","env","prefix","includes","push","bin","packageJson","inputs","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","reduce","ret","entry","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","context","option","optional","fromEntries","entries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","generators","docs","each","doubleHardline","children","child","when","shellShock"],"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 { isSetObject } from \"@stryke/type-checks/is-set-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 { OutputOptions, RenderedChunk } from \"rolldown\";\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, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport { resolve } from \"./resolver/resolve\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n) => {\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              buildPath: joinPaths(this.config.root, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            platform: \"node\",\n            projectType: \"application\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"]\n            },\n            tsdown: {\n              dts: true,\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          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(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.commandsPath = findCommandsRoot(this);\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <UtilsBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${command.name} \\n\\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:resolve-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping command resolution as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await resolve({\n                context: this,\n                command: input\n              });\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.tsdown.outputOptions ??= {} as any;\n        if (isObject(this.config.tsdown.outputOptions)) {\n          (\n            this.config.tsdown.outputOptions as NonNullable<OutputOptions>\n          ).banner = (chunk: RenderedChunk) => {\n            if (\n              chunk.isEntry &&\n              joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n            ) {\n              this.debug(\n                `Adding hashbang to binary executable output file: ${\n                  chunk.fileName\n                }`\n              );\n\n              return `#!/usr/bin/env ${\n                this.config.mode === \"development\"\n                  ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                  : \"\"\n              } node\\n`;\n            }\n            return \"\";\n          };\n        }\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\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\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\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

@@ -1,6 +1,7 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_types_command = require('../types/command.cjs');
 const require_helpers = require('./helpers.cjs');
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let __stryke_type_checks_is_bigint = require("@stryke/type-checks/is-bigint");
 let __stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
@@ -12,9 +13,11 @@ function __assignType(fn, args) {
 	return fn;
 }
 function extractCommandParameterKind(type) {
-	if (type === __powerlines_deepkit_vendor_type.ReflectionKind.string) return require_types_command.CommandParameterKinds.string;
-	else if (type === __powerlines_deepkit_vendor_type.ReflectionKind.number || type === __powerlines_deepkit_vendor_type.ReflectionKind.bigint || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, __stryke_type_checks_is_number.isNumber)(type.literal) || (0, __stryke_type_checks_is_bigint.isBigInt)(type.literal))) return require_types_command.CommandParameterKinds.number;
-	else if (type === __powerlines_deepkit_vendor_type.ReflectionKind.boolean) return require_types_command.CommandParameterKinds.boolean;
+	const isKind = !((0, __stryke_type_checks_is_set_object.isSetObject)(type) && "kind" in type);
+	const kind = !isKind ? type.kind : type;
+	if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.string) return require_types_command.CommandParameterKinds.string;
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.number || kind === __powerlines_deepkit_vendor_type.ReflectionKind.bigint || !isKind && type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, __stryke_type_checks_is_number.isNumber)(type.literal) || (0, __stryke_type_checks_is_bigint.isBigInt)(type.literal))) return require_types_command.CommandParameterKinds.number;
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean) return require_types_command.CommandParameterKinds.boolean;
 	else return require_types_command.CommandParameterKinds.string;
 }
 extractCommandParameterKind.__type = [

package/dist/resolver/deepkit.cjs.map

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

package/dist/resolver/deepkit.mjs

@@ -1,5 +1,6 @@
 import { CommandParameterKinds } from "../types/command.mjs";
 import { mergeCommandParameter } from "./helpers.mjs";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { ReflectionClass, ReflectionFunction, ReflectionKind, __ΩReflectionKind, reflect, stringifyType } from "@powerlines/deepkit/vendor/type";
 import { isBigInt } from "@stryke/type-checks/is-bigint";
 import { isNumber } from "@stryke/type-checks/is-number";
@@ -11,9 +12,11 @@ function __assignType(fn, args) {
 	return fn;
 }
 function extractCommandParameterKind(type) {
-	if (type === ReflectionKind.string) return CommandParameterKinds.string;
-	else if (type === ReflectionKind.number || type === ReflectionKind.bigint || type.kind === ReflectionKind.literal && (isNumber(type.literal) || isBigInt(type.literal))) return CommandParameterKinds.number;
-	else if (type === ReflectionKind.boolean) return CommandParameterKinds.boolean;
+	const isKind = !(isSetObject(type) && "kind" in type);
+	const kind = !isKind ? type.kind : type;
+	if (kind === ReflectionKind.string) return CommandParameterKinds.string;
+	else if (kind === ReflectionKind.number || kind === ReflectionKind.bigint || !isKind && type.kind === ReflectionKind.literal && (isNumber(type.literal) || isBigInt(type.literal))) return CommandParameterKinds.number;
+	else if (kind === ReflectionKind.boolean) return CommandParameterKinds.boolean;
 	else return CommandParameterKinds.string;
 }
 extractCommandParameterKind.__type = [