@shell-shock/core 0.9.7 → 0.11.0

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs","names":["For","Show","render","automd","deepkit","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","UtilsBuiltin","commands","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","noExternal","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","input","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","option","optional","fromEntries","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 tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { 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 { resolveEntries } from \"powerlines/lib/entry\";\nimport type { OutputOptions, RenderedChunk } from \"rolldown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  findCommandsRoot,\n  reflectCommandTree,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/resolve-command\";\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 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.projectRoot, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\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            entry:\n              !this.config.entry ||\n              (Array.isArray(this.config.entry) &&\n                this.config.entry.length === 0)\n                ? [\n                    joinPaths(this.config.sourceRoot, \"**/*.ts\"),\n                    joinPaths(this.config.sourceRoot, \"**/*.tsx\")\n                  ]\n                : undefined,\n            build: {\n              dts: false,\n              platform: \"node\",\n              nodeProtocol: true,\n              unbundle: false,\n              noExternal: [\"@powerlines/deepkit\"]\n            },\n            type: \"application\",\n            framework: \"shell-shock\"\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 entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\n        );\n\n        this.debug(\n          `Found ${\n            entries.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = entries.reduce((ret, entry) => {\n          if (!isParentPath(entry.file, this.commandsPath)) {\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:reflect-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 reflection initialization 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 reflectCommandTree(this, input);\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.build.outputOptions ??= {} as OutputOptions;\n        (this.config.build.outputOptions as OutputOptions).banner = (\n          chunk: RenderedChunk\n        ) => {\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: ${chunk.fileName}`\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      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(\n                  this.workspaceConfig.workspaceRoot,\n                  this.config.projectRoot\n                )\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","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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"}

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAiFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAofjC,MApfiC,CAof1B,QApf0B,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,GA2fjC,MA3fiC,CA2f1B,QA3f0B,CAAA,EAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAiFA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAofjC,MApfiC,CAof1B,QApf0B,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,GA2fjC,MA3fiC,CA2f1B,QA3f0B,CAAA,EAAA"}

package/dist/plugin.mjs

@@ -4,18 +4,18 @@ 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 { commands } from "./helpers/automd.mjs";
+import { findCommandsRoot, resolveCommandId, resolveCommandName, resolveCommandPath } from "./helpers/paths.mjs";
 import { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence } from "./helpers/persistence.mjs";
-import { formatCommandTree, getDefaultOptions } from "./helpers/utilities.mjs";
-import { findCommandsRoot, reflectCommandTree, resolveCommandId, resolveCommandName, resolveCommandPath } from "./helpers/resolve-command.mjs";
 import { formatBinaryPath, updatePackageJsonBinary } from "./helpers/update-package-json.mjs";
+import { formatCommandTree, getDefaultOptions } from "./helpers/utilities.mjs";
 import { validateCommand } from "./helpers/validations.mjs";
+import { resolve } from "./resolver/resolve.mjs";
 import { createComponent } from "@alloy-js/core/jsx-runtime";
 import { For, Show } from "@alloy-js/core/components";
 import { render } from "@powerlines/plugin-alloy/render";
 import automd from "@powerlines/plugin-automd";
 import deepkit from "@powerlines/plugin-deepkit";
 import nodejs from "@powerlines/plugin-nodejs";
-import tsdown from "@powerlines/plugin-tsdown";
 import { toArray } from "@stryke/convert/to-array";
 import { chmodX } from "@stryke/fs/chmod-x";
 import { appendPath } from "@stryke/path/append";
@@ -27,10 +27,12 @@ import { resolveParentPath } from "@stryke/path/resolve-parent-path";
 import { camelCase } from "@stryke/string-format/camel-case";
 import { constantCase } from "@stryke/string-format/constant-case";
 import { kebabCase } from "@stryke/string-format/kebab-case";
+import { isObject } from "@stryke/type-checks/is-object";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isSetString } from "@stryke/type-checks/is-set-string";
-import { defu } from "defu";
-import { resolveEntries } from "powerlines/lib/entry";
+import { defu as defu$1 } from "defu";
+import { tsdown } from "powerlines/tsdown";
+import { resolveInputs } from "powerlines/utils";
 
 //#region src/plugin.tsx
 const MAX_DEPTH = 50;
@@ -47,10 +49,12 @@ const plugin = (options = {}) => {
 			async config() {
 				this.debug("Resolving the Shell Shock configuration.");
 				await updatePackageJsonBinary(this);
-				const result = defu({ output: { buildPath: joinPaths(this.config.projectRoot, "dist") } }, options, {
+				const result = 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,
@@ -58,16 +62,13 @@ const plugin = (options = {}) => {
 						format: "esm",
 						dts: true
 					},
-					entry: !this.config.entry || Array.isArray(this.config.entry) && this.config.entry.length === 0 ? [joinPaths(this.config.sourceRoot, "**/*.ts"), joinPaths(this.config.sourceRoot, "**/*.tsx")] : void 0,
-					build: {
-						dts: false,
-						platform: "node",
+					input: !this.config.input || Array.isArray(this.config.input) && this.config.input.length === 0 || isObject(this.config.input) && Object.keys(this.config.input).length === 0 ? [joinPaths(this.config.root, "src/**/command.ts"), joinPaths(this.config.root, "src/**/command.tsx")] : void 0,
+					resolve: { external: ["@powerlines/deepkit"] },
+					tsdown: {
+						dts: true,
 						nodeProtocol: true,
-						unbundle: false,
-						noExternal: ["@powerlines/deepkit"]
-					},
-					type: "application",
-					framework: "shell-shock"
+						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);
@@ -92,7 +93,7 @@ const plugin = (options = {}) => {
 				}
 			}
 		},
-		...nodejs(defu(options ?? {}, { env: {
+		...nodejs(defu$1(options ?? {}, { env: {
 			types: "@shell-shock/core/types/env#ShellShockEnv",
 			validate: false
 		} })),
@@ -101,10 +102,10 @@ const plugin = (options = {}) => {
 			async configResolved() {
 				this.debug("Finding command entry point files.");
 				this.commandsPath = findCommandsRoot(this);
-				const entries = await resolveEntries(this, toArray(this.config.entry || []));
-				this.debug(`Found ${entries.length} entry points specified in the configuration options.`);
-				this.inputs = entries.reduce((ret, entry) => {
-					if (!isParentPath(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+				const inputs = await resolveInputs(this, this.config.input);
+				this.debug(`Found ${inputs.length} entry points specified in the configuration options.`);
+				this.inputs = inputs.reduce((ret, entry) => {
+					if (entry.file !== this.commandsPath && !isParentPath(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
 					const id = resolveCommandId(this, entry.file);
 					if (!ret.some((existing) => existing.id === id)) {
 						const name = resolveCommandName(entry.file);
@@ -187,17 +188,20 @@ const plugin = (options = {}) => {
 			}
 		},
 		{
-			name: "shell-shock:reflect-commands",
+			name: "shell-shock:resolve-commands",
 			prepare: {
 				order: "post",
 				async handler() {
 					this.debug("Initializing the CLI application's command tree.");
 					this.commands = {};
 					if (this.config.command !== "prepare" && this.config.skipCache !== true && this.persistedMeta?.checksum === this.meta.checksum && this.fs.existsSync(getCommandsPersistencePath(this))) {
-						this.debug(`Skipping reflection initialization as the meta checksum has not changed.`);
+						this.debug(`Skipping command resolution as the meta checksum has not changed.`);
 						await readCommandsPersistence(this);
 					} else {
-						for (const input of this.inputs.filter((input$1) => input$1.segments.filter((segment) => !isDynamicPathSegment(segment) && !isPathSegmentGroup(segment)).length === 1)) this.commands[input.name] = await reflectCommandTree(this, input);
+						for (const input of this.inputs.filter((input$1) => input$1.segments.filter((segment) => !isDynamicPathSegment(segment) && !isPathSegmentGroup(segment)).length === 1)) this.commands[input.name] = await resolve({
+							context: this,
+							command: input
+						});
 						this.debug("Post-processing commands to ensure proper reflection.");
 						this.options = this.options.map((option) => ({
 							...option,
@@ -232,8 +236,8 @@ const plugin = (options = {}) => {
 		{
 			name: "shell-shock:chmod+x",
 			configResolved() {
-				this.config.build.outputOptions ??= {};
-				this.config.build.outputOptions.banner = (chunk) => {
+				this.config.tsdown.outputOptions ??= {};
+				if (isObject(this.config.tsdown.outputOptions)) this.config.tsdown.outputOptions.banner = (chunk) => {
 					if (chunk.isEntry && joinPaths(this.entryPath, "bin.ts") === chunk.facadeModuleId) {
 						this.debug(`Adding hashbang to binary executable output file: ${chunk.fileName}`);
 						return `#!/usr/bin/env ${this.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node\n`;
@@ -244,7 +248,7 @@ const plugin = (options = {}) => {
 			async buildEnd() {
 				if (!isSetObject(this.config.bin)) this.warn(`No binaries were found for the ${this.config.name} application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`);
 				else await Promise.all(Object.values(this.config.bin).map(async (bin) => {
-					const path = appendPath(bin, joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot));
+					const path = appendPath(bin, joinPaths(this.workspaceConfig.workspaceRoot, this.config.root));
 					if (this.fs.existsSync(path)) {
 						this.debug(`Adding executable permissions (chmod+x) to binary executable output file: ${path}`);
 						await chmodX(path);

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":["For","Show","render","automd","deepkit","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","relativePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","UtilsBuiltin","commands","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","getDynamicPathSegmentName","isDynamicPathSegment","isPathSegmentGroup","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","noExternal","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","segments","alias","isVirtual","types","validate","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","map","segment","index","found","findIndex","replace","join","input","command","prepare","_$createComponent","warn","cmd","depth","parentPath","sort","a","b","skipCache","persistedMeta","checksum","meta","fs","existsSync","option","optional","fromEntries","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 tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { 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 { resolveEntries } from \"powerlines/lib/entry\";\nimport type { OutputOptions, RenderedChunk } from \"rolldown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  findCommandsRoot,\n  reflectCommandTree,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/resolve-command\";\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 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.projectRoot, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\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            entry:\n              !this.config.entry ||\n              (Array.isArray(this.config.entry) &&\n                this.config.entry.length === 0)\n                ? [\n                    joinPaths(this.config.sourceRoot, \"**/*.ts\"),\n                    joinPaths(this.config.sourceRoot, \"**/*.tsx\")\n                  ]\n                : undefined,\n            build: {\n              dts: false,\n              platform: \"node\",\n              nodeProtocol: true,\n              unbundle: false,\n              noExternal: [\"@powerlines/deepkit\"]\n            },\n            type: \"application\",\n            framework: \"shell-shock\"\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 entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\n        );\n\n        this.debug(\n          `Found ${\n            entries.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = entries.reduce((ret, entry) => {\n          if (!isParentPath(entry.file, this.commandsPath)) {\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:reflect-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 reflection initialization 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 reflectCommandTree(this, input);\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.build.outputOptions ??= {} as OutputOptions;\n        (this.config.build.outputOptions as OutputOptions).banner = (\n          chunk: RenderedChunk\n        ) => {\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: ${chunk.fileName}`\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      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(\n                  this.workspaceConfig.workspaceRoot,\n                  this.config.projectRoot\n                )\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","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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"}

package/dist/resolver/deepkit.cjs

@@ -0,0 +1,129 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_types_command = require('../types/command.cjs');
+const require_helpers = require('./helpers.cjs');
+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");
+let __stryke_type_checks_is_regexp = require("@stryke/type-checks/is-regexp");
+
+//#region src/resolver/deepkit.ts
+function __assignType(fn, args) {
+	fn.__type = 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;
+	else return require_types_command.CommandParameterKinds.string;
+}
+extractCommandParameterKind.__type = [
+	"Type",
+	() => __powerlines_deepkit_vendor_type.__ΩReflectionKind,
+	"type",
+	"CommandParameterKind",
+	"extractCommandParameterKind",
+	"PP\"w!n\"J2#\"w$/%"
+];
+function resolveCommandOption(ctx, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.options[reflection.getNameAsString()] ?? {};
+	const option = {
+		name: reflection.getNameAsString(),
+		alias: reflection.getTags().alias ?? [],
+		title: reflection.getTags().title?.trim(),
+		description: reflection.getDescription(),
+		kind: extractCommandParameterKind(type),
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: reflection.isArray()
+	};
+	if (reflection.isArray()) if (type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) {
+		option.variadic = true;
+		option.kind = extractCommandParameterKind(type.type.kind);
+	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.union) {
+		option.kind = type.types.every(__assignType((t) => t.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number || t.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, __stryke_type_checks_is_number.isNumber)(t.literal) || (0, __stryke_type_checks_is_bigint.isBigInt)(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? require_types_command.CommandParameterKinds.number : require_types_command.CommandParameterKinds.string;
+		option.choices = type.types.map(__assignType((t) => t.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal ? (0, __stryke_type_checks_is_number.isNumber)(t.literal) ? t.literal : (0, __stryke_type_checks_is_bigint.isBigInt)(t.literal) ? Number(t.literal) : (0, __stryke_type_checks_is_regexp.isRegExp)(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal) option.choices = [(0, __stryke_type_checks_is_number.isNumber)(type.literal) ? type.literal : (0, __stryke_type_checks_is_bigint.isBigInt)(type.literal) ? Number(type.literal) : (0, __stryke_type_checks_is_regexp.isRegExp)(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!existing.kind && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	return require_helpers.mergeCommandParameter(existing, option);
+}
+resolveCommandOption.__type = [
+	"ResolverContext",
+	"ctx",
+	"ReflectionProperty",
+	"reflection",
+	"CommandOption",
+	"resolveCommandOption",
+	"P\"w!2\"\"w#2$\"w%/&"
+];
+function resolveCommandArgument(ctx, index, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.args.length > index ? ctx.output.args[index] : {};
+	if (!existing.kind && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean && !(type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array && (type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number))) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string types (or an array of strings) are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	const argument = {
+		name: reflection.getName() || reflection.parameter.name,
+		alias: reflection.getAlias(),
+		kind: extractCommandParameterKind(type.kind),
+		title: reflection.getTitle() || reflection.parameter.tags?.title,
+		description: reflection.parameter.description,
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue()
+	};
+	if (type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) {
+		if (type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) {
+			argument.variadic = true;
+			argument.kind = extractCommandParameterKind(type.type.kind);
+		} else if (!existing.kind) throw new Error(`Unsupported array type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	} else if (!existing.kind && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for argument "${reflection.getName()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	return require_helpers.mergeCommandParameter(existing, argument, { name: `arg${index}` });
+}
+resolveCommandArgument.__type = [
+	"ResolverContext",
+	"ctx",
+	"index",
+	"ReflectionParameter",
+	"reflection",
+	"CommandArgument",
+	"resolveCommandArgument",
+	"P\"w!2\"'2#\"w$2%\"w&/'"
+];
+function resolveFromBytecode(ctx) {
+	const { input, module: module$1 } = ctx;
+	const type = (0, __powerlines_deepkit_vendor_type.reflect)(module$1);
+	if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.function) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not export a valid function.`);
+	const reflection = new __powerlines_deepkit_vendor_type.ReflectionFunction(type);
+	ctx.output.description ??= ctx.input.command.description || reflection.getDescription() || type.description;
+	const parameters = reflection.getParameters();
+	if (parameters.length > 0 && parameters[0]) {
+		if (parameters[0].type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral || parameters[0].type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class) {
+			const optionsReflection = __powerlines_deepkit_vendor_type.ReflectionClass.from(parameters[0].type);
+			for (const propertyReflection of optionsReflection.getProperties()) ctx.output.options[propertyReflection.getNameAsString()] = resolveCommandOption(ctx, propertyReflection);
+		} else if (!ctx.module?.options) throw new Error(`The first parameter of the command handler function in "${ctx.input.command.entry.input?.file || ctx.input.command.path}" must be an object literal or class type representing the command options.`);
+		ctx.output.args = parameters.slice(1).map(__assignType((arg, index) => resolveCommandArgument(ctx, index, arg), [
+			"arg",
+			"index",
+			"",
+			"P\"2!\"2\"\"/#"
+		]));
+	}
+}
+resolveFromBytecode.__type = [
+	"ResolverContext",
+	"ctx",
+	"resolveFromBytecode",
+	"P\"w!2\"\"/#"
+];
+
+//#endregion
+exports.resolveFromBytecode = resolveFromBytecode;
+//# sourceMappingURL=deepkit.cjs.map