@shell-shock/core 0.3.0 → 0.4.0

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs","names":["For","Show","render","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","isVariableCommandPath","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","automd","generators","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","value","segments","isVirtual","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","input","map","command","join","warn","cmd","depth","parentPath","sort","a","b","prepare","commands","skipCache","persistedMeta","checksum","meta","fs","existsSync","segment","option","alias","optional","fromEntries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","docs","_$createComponent","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 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 } 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 { RenderedChunk } from \"rolldown\";\nimport type { OutputOptions } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\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  isVariableCommandPath\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    {\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            automd: {\n              generators: {}\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            },\n            type: \"application\",\n            framework: \"shell-shock\"\n          }\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              title: this.config.title,\n              description: this.config.description,\n              path: {\n                value: null,\n                segments: []\n              },\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\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 path = resolveCommandPath(this, entry.file);\n            const name = resolveCommandName(entry.file);\n\n            ret.push({\n              id,\n              path: {\n                value: path,\n                segments: path.split(\"/\").filter(Boolean)\n              },\n              name,\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    },\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}: ${replacePath(\n                      command.entry.file,\n                      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                while (parentPath !== this.commandsPath) {\n                  if (depth++ > MAX_DEPTH) {\n                    throw new Error(\n                      `Maximum command virtual parent depth of ${\n                        MAX_DEPTH\n                      } exceeded while processing command: ${command.name}`\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                      const path = resolveCommandPath(this, file);\n\n                      ret.push({\n                        id,\n                        path: {\n                          value: path,\n                          segments: path.split(\"/\").filter(Boolean)\n                        },\n                        name,\n                        isVirtual: true,\n                        entry: {\n                          file\n                        }\n                      });\n                    }\n                  }\n\n                  parentPath = resolveParentPath(parentPath);\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.path.segments.length - b.path.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          this.commands = {};\n\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.path.segments.filter(\n                  segment => !isVariableCommandPath(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      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.path.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","tsdown","toArray","chmodX","appendPath","findFilePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","commands","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","isVariableCommandPath","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","alias","path","value","segments","isVirtual","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","input","map","command","join","warn","cmd","depth","parentPath","sort","a","b","prepare","skipCache","persistedMeta","checksum","meta","fs","existsSync","segment","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","_$createComponent","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 } 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 { 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  isVariableCommandPath\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        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              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              path: {\n                value: null,\n                segments: []\n              },\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\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 path = resolveCommandPath(this, entry.file);\n            const name = resolveCommandName(entry.file);\n\n            ret.push({\n              id,\n              path: {\n                value: path,\n                segments: path.split(\"/\").filter(Boolean)\n              },\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    },\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}: ${replacePath(\n                      command.entry.file,\n                      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                while (parentPath !== this.commandsPath) {\n                  if (depth++ > MAX_DEPTH) {\n                    throw new Error(\n                      `Maximum command virtual parent depth of ${\n                        MAX_DEPTH\n                      } exceeded while processing command: ${command.name}`\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                      const path = resolveCommandPath(this, file);\n\n                      ret.push({\n                        id,\n                        path: {\n                          value: path,\n                          segments: path.split(\"/\").filter(Boolean)\n                        },\n                        name,\n                        alias: [],\n                        isVirtual: true,\n                        entry: {\n                          file\n                        }\n                      });\n                    }\n                  }\n\n                  parentPath = resolveParentPath(parentPath);\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.path.segments.length - b.path.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          this.commands = {};\n\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.path.segments.filter(\n                  segment => !isVariableCommandPath(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.path.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":";;;;;;;;AA4EA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAuajC,MAvaiC,CAua1B,QAva0B,CAAA,EAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA8EA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAibjC,MAjbiC,CAib1B,QAjb0B,CAAA,EAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA4EA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAuajC,MAvaiC,CAua1B,QAva0B,CAAA,EAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA8EA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAibjC,MAjbiC,CAib1B,QAjb0B,CAAA,EAAA"}

package/dist/plugin.mjs

@@ -1,15 +1,18 @@
 import { getAppDescription, getAppName, getAppTitle, isVariableCommandPath } from "./plugin-utils/context-helpers.mjs";
 import { CommandDocsFile } from "./components/docs.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 { 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 { validateCommand } from "./helpers/validations.mjs";
-import { getCommandTree } from "./plugin-utils/get-command-tree.mjs";
-import { traverseCommands } from "./plugin-utils/traverse-command-tree.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";
@@ -36,6 +39,8 @@ const MAX_DEPTH = 50;
 const plugin = (options = {}) => {
 	return [
 		tsdown(),
+		deepkit(),
+		automd(),
 		{
 			name: "shell-shock:config",
 			async config() {
@@ -47,7 +52,6 @@ const plugin = (options = {}) => {
 					description: getAppDescription(this),
 					envPrefix: constantCase(getAppName(this)),
 					env: { prefix: [] },
-					automd: { generators: {} },
 					isCaseSensitive: false,
 					output: {
 						format: "esm",
@@ -58,7 +62,8 @@ const plugin = (options = {}) => {
 						dts: false,
 						platform: "node",
 						nodeProtocol: true,
-						unbundle: false
+						unbundle: false,
+						noExternal: ["@powerlines/deepkit"]
 					},
 					type: "application",
 					framework: "shell-shock"
@@ -77,6 +82,7 @@ const plugin = (options = {}) => {
 						name: this.config.name,
 						title: this.config.title,
 						description: this.config.description,
+						alias: [],
 						path: {
 							value: null,
 							segments: []
@@ -107,6 +113,7 @@ const plugin = (options = {}) => {
 								segments: path.split("/").filter(Boolean)
 							},
 							name,
+							alias: [],
 							isVirtual: false,
 							entry: {
 								...entry,
@@ -151,6 +158,7 @@ const plugin = (options = {}) => {
 												segments: path.split("/").filter(Boolean)
 											},
 											name,
+											alias: [],
 											isVirtual: true,
 											entry: { file }
 										});
@@ -233,12 +241,19 @@ const plugin = (options = {}) => {
 		},
 		{
 			name: "shell-shock:docs",
+			configResolved() {
+				this.config.automd ??= {};
+				this.config.automd.generators = {
+					...this.config.automd.generators ?? {},
+					commands: commands(this)
+				};
+			},
 			async docs() {
 				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
-				const commands = this.inputs.map((input) => getCommandTree(this, input.path.segments)).filter(Boolean);
+				const commands$1 = this.inputs.map((input) => getCommandTree(this, input.path.segments)).filter(Boolean);
 				return render(this, createComponent(For, {
 					get each() {
-						return Object.values(commands);
+						return Object.values(commands$1);
 					},
 					doubleHardline: true,
 					children: (child) => createComponent(Show, {

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":["For","Show","render","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","isVariableCommandPath","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","automd","generators","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","value","segments","isVirtual","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","input","map","command","join","warn","cmd","depth","parentPath","sort","a","b","prepare","commands","skipCache","persistedMeta","checksum","meta","fs","existsSync","segment","option","alias","optional","fromEntries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","docs","_$createComponent","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 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 } 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 { RenderedChunk } from \"rolldown\";\nimport type { OutputOptions } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\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  isVariableCommandPath\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    {\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            automd: {\n              generators: {}\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            },\n            type: \"application\",\n            framework: \"shell-shock\"\n          }\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              title: this.config.title,\n              description: this.config.description,\n              path: {\n                value: null,\n                segments: []\n              },\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\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 path = resolveCommandPath(this, entry.file);\n            const name = resolveCommandName(entry.file);\n\n            ret.push({\n              id,\n              path: {\n                value: path,\n                segments: path.split(\"/\").filter(Boolean)\n              },\n              name,\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    },\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}: ${replacePath(\n                      command.entry.file,\n                      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                while (parentPath !== this.commandsPath) {\n                  if (depth++ > MAX_DEPTH) {\n                    throw new Error(\n                      `Maximum command virtual parent depth of ${\n                        MAX_DEPTH\n                      } exceeded while processing command: ${command.name}`\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                      const path = resolveCommandPath(this, file);\n\n                      ret.push({\n                        id,\n                        path: {\n                          value: path,\n                          segments: path.split(\"/\").filter(Boolean)\n                        },\n                        name,\n                        isVirtual: true,\n                        entry: {\n                          file\n                        }\n                      });\n                    }\n                  }\n\n                  parentPath = resolveParentPath(parentPath);\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.path.segments.length - b.path.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          this.commands = {};\n\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.path.segments.filter(\n                  segment => !isVariableCommandPath(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      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.path.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","tsdown","toArray","chmodX","appendPath","findFilePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","commands","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","isVariableCommandPath","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","alias","path","value","segments","isVirtual","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","input","map","command","join","warn","cmd","depth","parentPath","sort","a","b","prepare","skipCache","persistedMeta","checksum","meta","fs","existsSync","segment","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","_$createComponent","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 } 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 { 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  isVariableCommandPath\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        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              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              path: {\n                value: null,\n                segments: []\n              },\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\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 path = resolveCommandPath(this, entry.file);\n            const name = resolveCommandName(entry.file);\n\n            ret.push({\n              id,\n              path: {\n                value: path,\n                segments: path.split(\"/\").filter(Boolean)\n              },\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    },\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}: ${replacePath(\n                      command.entry.file,\n                      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                while (parentPath !== this.commandsPath) {\n                  if (depth++ > MAX_DEPTH) {\n                    throw new Error(\n                      `Maximum command virtual parent depth of ${\n                        MAX_DEPTH\n                      } exceeded while processing command: ${command.name}`\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                      const path = resolveCommandPath(this, file);\n\n                      ret.push({\n                        id,\n                        path: {\n                          value: path,\n                          segments: path.split(\"/\").filter(Boolean)\n                        },\n                        name,\n                        alias: [],\n                        isVirtual: true,\n                        entry: {\n                          file\n                        }\n                      });\n                    }\n                  }\n\n                  parentPath = resolveParentPath(parentPath);\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.path.segments.length - b.path.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          this.commands = {};\n\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.path.segments.filter(\n                  segment => !isVariableCommandPath(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.path.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/types/command.d.cts

@@ -44,6 +44,7 @@ interface CommandBase {
   name: string;
   title?: string;
   description?: string;
+  alias: string[];
   path: CommandPath;
   isVirtual: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.cts","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":[],"mappings":";;;;UAqBiB,iBAAA;;EAAA,IAAA,EAET,cAF0B;EAUjB,KAAA,EAAA,MAAA;EAMA,WAAA,EAAA,MAAA;EAMA,KAAA,EAAA,MAAA,EAAA;EAOL,GAAA,EAAA,MAAA,GAAA,KAAa;EACrB,QAAA,EAAA,OAAA;;AAEA,UAtBa,mBAAA,SAA4B,iBAsBzC,CAAA;EAAoB,IAAA,EArBhB,cAAA,CAAe,MAqBC;EAEP,OAAA,CAAA,EAAA,MAAY;EAQZ,QAAA,EAAA,OAAW;AAK5B;AASiB,UAxCA,mBAAA,SAA4B,iBAwCP,CAAA;EAKrB,IAAA,EA5CT,cAAA,CAAe,MA4CU;EACL,OAAA,CAAA,EAAA,MAAA;EAAf,QAAA,EAAA,OAAA;;AADuC,UAvCnC,oBAAA,SAA6B,iBAuCM,CAAA;EAIxC,IAAA,EA1CJ,cAAA,CAAe,OA0CA;EAAG,OAAA,CAAA,EAAA,OAAA;EAGlB,YAAA,CAAA,EAAA,MAAA;EACkB,kBAAA,CAAA,EAAA,OAAA;;AAChB,KAzCE,aAAA,GACR,mBAwCM,GAvCN,mBAuCM,GAtCN,oBAsCM;AACO,UArCA,YAAA,CAqCA;EACU,IAAA,EAAA,MAAA;EAAf,WAAA,CAAA,EAAA,MAAA;EAAM,OAAA,CAAA,EAAA,MAAA;EAGN,QAAA,EAAA,OAAA;EAA6B,QAAA,EAAA,OAAA;;AAEd,UAnCV,WAAA,CAmCU;EAAf,KAAA,EAAA,MAAA,GAAA,IAAA;EAAM,QAAA,EAAA,MAAA,EAAA;;UA9BD,WAAA;;;;;QAKT;;;UAIS,YAAA,SAAqB;;SAE7B;;UAGQ,eAAA,SAAwB;aAC5B,eAAe;;KAGhB,WAAA,GAAc;;;QAGlB;WACG,eAAe;UAChB;iBACO;YACL,eAAe;;KAGf,qBAAA,GAAwB,KAAK;;YAE7B,eAAe"}
+{"version":3,"file":"command.d.cts","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":[],"mappings":";;;;UAqBiB,iBAAA;;EAAA,IAAA,EAET,cAF0B;EAUjB,KAAA,EAAA,MAAA;EAMA,WAAA,EAAA,MAAA;EAMA,KAAA,EAAA,MAAA,EAAA;EAOL,GAAA,EAAA,MAAA,GAAA,KAAa;EACrB,QAAA,EAAA,OAAA;;AAEA,UAtBa,mBAAA,SAA4B,iBAsBzC,CAAA;EAAoB,IAAA,EArBhB,cAAA,CAAe,MAqBC;EAEP,OAAA,CAAA,EAAA,MAAY;EAQZ,QAAA,EAAA,OAAW;AAK5B;AAUiB,UAzCA,mBAAA,SAA4B,iBAyCP,CAAA;EAKrB,IAAA,EA7CT,cAAA,CAAe,MA6CU;EACL,OAAA,CAAA,EAAA,MAAA;EAAf,QAAA,EAAA,OAAA;;AADuC,UAxCnC,oBAAA,SAA6B,iBAwCM,CAAA;EAIxC,IAAA,EA3CJ,cAAA,CAAe,OA2CA;EAAG,OAAA,CAAA,EAAA,OAAA;EAGlB,YAAA,CAAA,EAAA,MAAA;EACkB,kBAAA,CAAA,EAAA,OAAA;;AAChB,KA1CE,aAAA,GACR,mBAyCM,GAxCN,mBAwCM,GAvCN,oBAuCM;AACO,UAtCA,YAAA,CAsCA;EACU,IAAA,EAAA,MAAA;EAAf,WAAA,CAAA,EAAA,MAAA;EAAM,OAAA,CAAA,EAAA,MAAA;EAGN,QAAA,EAAA,OAAA;EAA6B,QAAA,EAAA,OAAA;;AAEd,UApCV,WAAA,CAoCU;EAAf,KAAA,EAAA,MAAA,GAAA,IAAA;EAAM,QAAA,EAAA,MAAA,EAAA;;UA/BD,WAAA;;;;;;QAMT;;;UAIS,YAAA,SAAqB;;SAE7B;;UAGQ,eAAA,SAAwB;aAC5B,eAAe;;KAGhB,WAAA,GAAc;;;QAGlB;WACG,eAAe;UAChB;iBACO;YACL,eAAe;;KAGf,qBAAA,GAAwB,KAAK;;YAE7B,eAAe"}

package/dist/types/command.d.mts

@@ -44,6 +44,7 @@ interface CommandBase {
   name: string;
   title?: string;
   description?: string;
+  alias: string[];
   path: CommandPath;
   isVirtual: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.mts","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":[],"mappings":";;;;UAqBiB,iBAAA;;EAAA,IAAA,EAET,cAF0B;EAUjB,KAAA,EAAA,MAAA;EAMA,WAAA,EAAA,MAAA;EAMA,KAAA,EAAA,MAAA,EAAA;EAOL,GAAA,EAAA,MAAA,GAAA,KAAa;EACrB,QAAA,EAAA,OAAA;;AAEA,UAtBa,mBAAA,SAA4B,iBAsBzC,CAAA;EAAoB,IAAA,EArBhB,cAAA,CAAe,MAqBC;EAEP,OAAA,CAAA,EAAA,MAAY;EAQZ,QAAA,EAAA,OAAW;AAK5B;AASiB,UAxCA,mBAAA,SAA4B,iBAwCP,CAAA;EAKrB,IAAA,EA5CT,cAAA,CAAe,MA4CU;EACL,OAAA,CAAA,EAAA,MAAA;EAAf,QAAA,EAAA,OAAA;;AADuC,UAvCnC,oBAAA,SAA6B,iBAuCM,CAAA;EAIxC,IAAA,EA1CJ,cAAA,CAAe,OA0CA;EAAG,OAAA,CAAA,EAAA,OAAA;EAGlB,YAAA,CAAA,EAAA,MAAA;EACkB,kBAAA,CAAA,EAAA,OAAA;;AAChB,KAzCE,aAAA,GACR,mBAwCM,GAvCN,mBAuCM,GAtCN,oBAsCM;AACO,UArCA,YAAA,CAqCA;EACU,IAAA,EAAA,MAAA;EAAf,WAAA,CAAA,EAAA,MAAA;EAAM,OAAA,CAAA,EAAA,MAAA;EAGN,QAAA,EAAA,OAAA;EAA6B,QAAA,EAAA,OAAA;;AAEd,UAnCV,WAAA,CAmCU;EAAf,KAAA,EAAA,MAAA,GAAA,IAAA;EAAM,QAAA,EAAA,MAAA,EAAA;;UA9BD,WAAA;;;;;QAKT;;;UAIS,YAAA,SAAqB;;SAE7B;;UAGQ,eAAA,SAAwB;aAC5B,eAAe;;KAGhB,WAAA,GAAc;;;QAGlB;WACG,eAAe;UAChB;iBACO;YACL,eAAe;;KAGf,qBAAA,GAAwB,KAAK;;YAE7B,eAAe"}
+{"version":3,"file":"command.d.mts","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":[],"mappings":";;;;UAqBiB,iBAAA;;EAAA,IAAA,EAET,cAF0B;EAUjB,KAAA,EAAA,MAAA;EAMA,WAAA,EAAA,MAAA;EAMA,KAAA,EAAA,MAAA,EAAA;EAOL,GAAA,EAAA,MAAA,GAAA,KAAa;EACrB,QAAA,EAAA,OAAA;;AAEA,UAtBa,mBAAA,SAA4B,iBAsBzC,CAAA;EAAoB,IAAA,EArBhB,cAAA,CAAe,MAqBC;EAEP,OAAA,CAAA,EAAA,MAAY;EAQZ,QAAA,EAAA,OAAW;AAK5B;AAUiB,UAzCA,mBAAA,SAA4B,iBAyCP,CAAA;EAKrB,IAAA,EA7CT,cAAA,CAAe,MA6CU;EACL,OAAA,CAAA,EAAA,MAAA;EAAf,QAAA,EAAA,OAAA;;AADuC,UAxCnC,oBAAA,SAA6B,iBAwCM,CAAA;EAIxC,IAAA,EA3CJ,cAAA,CAAe,OA2CA;EAAG,OAAA,CAAA,EAAA,OAAA;EAGlB,YAAA,CAAA,EAAA,MAAA;EACkB,kBAAA,CAAA,EAAA,OAAA;;AAChB,KA1CE,aAAA,GACR,mBAyCM,GAxCN,mBAwCM,GAvCN,oBAuCM;AACO,UAtCA,YAAA,CAsCA;EACU,IAAA,EAAA,MAAA;EAAf,WAAA,CAAA,EAAA,MAAA;EAAM,OAAA,CAAA,EAAA,MAAA;EAGN,QAAA,EAAA,OAAA;EAA6B,QAAA,EAAA,OAAA;;AAEd,UApCV,WAAA,CAoCU;EAAf,KAAA,EAAA,MAAA,GAAA,IAAA;EAAM,QAAA,EAAA,MAAA,EAAA;;UA/BD,WAAA;;;;;;QAMT;;;UAIS,YAAA,SAAqB;;SAE7B;;UAGQ,eAAA,SAAwB;aAC5B,eAAe;;KAGhB,WAAA,GAAc;;;QAGlB;WACG,eAAe;UAChB;iBACO;YACL,eAAe;;KAGf,qBAAA,GAAwB,KAAK;;YAE7B,eAAe"}

package/dist/types/config.d.cts

@@ -1,6 +1,7 @@
 import { CommandBase, CommandOption } from "./command.cjs";
 import { Context } from "./context.cjs";
 import { OutputConfig as OutputConfig$1 } from "powerlines/types/config";
+import { AutoMDPluginResolvedConfig } from "@powerlines/plugin-automd/types/plugin";
 import { NodeJsPluginResolvedConfig } from "@powerlines/plugin-nodejs/types/plugin";
 import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown/types/plugin";
 
@@ -18,7 +19,7 @@ type Options = Partial<BaseConfig> & {
    */
   defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
   /**
-   * Determines whether commands' name and option names are treated as case-sensitive.
+   * Determines whether commands and option names are treated as case-sensitive.
    *
    * @defaultValue `false`
    */
@@ -66,7 +67,7 @@ type UserConfig = Options & {
 /**
  * The resolved configuration options for Shell Shock.
  */
-type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin">> & {
+type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & AutoMDPluginResolvedConfig & Required<Omit<Options, "bin">> & {
   /**
    * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | "bin" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).
    *

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":[],"mappings":";;;;;;;KA2BY,UAAA,GAAa,KACvB;;AADF;AAmBA;AAA8B,KAAlB,OAAA,GAAU,OAAQ,CAAA,UAAA,CAAA,GAAA;EAAR;;;;;;EA8CV,cAAA,CAAY,EAtClB,aAuCJ,EAAA,GAAA,CAAA,CAAA,OADyB,EArCV,OAqCc,EAAA,KAAA,EArCE,WAqCF,EAAA,GArCkB,aAqClB,EAAA,CAAA,GAAA,KAAA;EAanB;AAUZ;;;;EAEW,eAAA,CAAA,EAAA,OAAA;EAAT;;;;;;;;;;;;;;;;;;;;;;;;;KAzBU,YAAA,GAAe,KACzB;;;;;;;;;KAYU,UAAA,GAAa;;;;WAId;;;;;KAMC,cAAA,GAAiB,6BAC3B,6BACA,SAAS,KAAK;;;;;;;;;;;OAWP;;;;cAKO,aAAa"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;KA4BY,UAAA,GAAa,KACvB;;AADF;AAmBA;AAA8B,KAAlB,OAAA,GAAU,OAAQ,CAAA,UAAA,CAAA,GAAA;EAAR;;;;;;EA8CV,cAAA,CAAY,EAtClB,aAuCJ,EAAA,GAAA,CAAA,CAAA,OADyB,EArCV,OAqCc,EAAA,KAAA,EArCE,WAqCF,EAAA,GArCkB,aAqClB,EAAA,CAAA,GAAA,KAAA;EAanB;AAUZ;;;;EAGgB,eAAA,CAAA,EAAA,OAAA;EAAL;;;;;;;;;;;;;;;;;;;;;;;;;KA1BC,YAAA,GAAe,KACzB;;;;;;;;;KAYU,UAAA,GAAa;;;;WAId;;;;;KAMC,cAAA,GAAiB,6BAC3B,6BACA,6BACA,SAAS,KAAK;;;;;;;;;;;OAWP;;;;cAKO,aAAa"}

package/dist/types/config.d.mts

@@ -1,6 +1,7 @@
 import { CommandBase, CommandOption } from "./command.mjs";
 import { Context } from "./context.mjs";
 import { OutputConfig as OutputConfig$1 } from "powerlines/types/config";
+import { AutoMDPluginResolvedConfig } from "@powerlines/plugin-automd/types/plugin";
 import { NodeJsPluginResolvedConfig } from "@powerlines/plugin-nodejs/types/plugin";
 import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown/types/plugin";
 
@@ -18,7 +19,7 @@ type Options = Partial<BaseConfig> & {
    */
   defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
   /**
-   * Determines whether commands' name and option names are treated as case-sensitive.
+   * Determines whether commands and option names are treated as case-sensitive.
    *
    * @defaultValue `false`
    */
@@ -66,7 +67,7 @@ type UserConfig = Options & {
 /**
  * The resolved configuration options for Shell Shock.
  */
-type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin">> & {
+type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & AutoMDPluginResolvedConfig & Required<Omit<Options, "bin">> & {
   /**
    * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | "bin" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).
    *

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":[],"mappings":";;;;;;;KA2BY,UAAA,GAAa,KACvB;;AADF;AAmBA;AAA8B,KAAlB,OAAA,GAAU,OAAQ,CAAA,UAAA,CAAA,GAAA;EAAR;;;;;;EA8CV,cAAA,CAAY,EAtClB,aAuCJ,EAAA,GAAA,CAAA,CAAA,OADyB,EArCV,OAqCc,EAAA,KAAA,EArCE,WAqCF,EAAA,GArCkB,aAqClB,EAAA,CAAA,GAAA,KAAA;EAanB;AAUZ;;;;EAEW,eAAA,CAAA,EAAA,OAAA;EAAT;;;;;;;;;;;;;;;;;;;;;;;;;KAzBU,YAAA,GAAe,KACzB;;;;;;;;;KAYU,UAAA,GAAa;;;;WAId;;;;;KAMC,cAAA,GAAiB,6BAC3B,6BACA,SAAS,KAAK;;;;;;;;;;;OAWP;;;;cAKO,aAAa"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;KA4BY,UAAA,GAAa,KACvB;;AADF;AAmBA;AAA8B,KAAlB,OAAA,GAAU,OAAQ,CAAA,UAAA,CAAA,GAAA;EAAR;;;;;;EA8CV,cAAA,CAAY,EAtClB,aAuCJ,EAAA,GAAA,CAAA,CAAA,OADyB,EArCV,OAqCc,EAAA,KAAA,EArCE,WAqCF,EAAA,GArCkB,aAqClB,EAAA,CAAA,GAAA,KAAA;EAanB;AAUZ;;;;EAGgB,eAAA,CAAA,EAAA,OAAA;EAAL;;;;;;;;;;;;;;;;;;;;;;;;;KA1BC,YAAA,GAAe,KACzB;;;;;;;;;KAYU,UAAA,GAAa;;;;WAId;;;;;KAMC,cAAA,GAAiB,6BAC3B,6BACA,6BACA,SAAS,KAAK;;;;;;;;;;;OAWP;;;;cAKO,aAAa"}

package/dist/types/runtime.d.cts

@@ -0,0 +1,24 @@
+//#region src/types/runtime.d.ts
+interface RuntimePath {
+  /**
+   * The full path as a string value.
+   */
+  value: string;
+  /**
+   * The individual segments that make up the path.
+   */
+  segments: (string | string[])[];
+}
+interface RuntimeContext<TOptions extends Record<string, string | number | boolean | string[] | number[]> = Record<string, string | number | boolean | string[] | number[]>, TPath extends RuntimePath = RuntimePath> {
+  /**
+   * The parsed command-line options.
+   */
+  options: TOptions;
+  /**
+   * The current command path within the runtime context.
+   */
+  path: TPath;
+}
+//#endregion
+export { RuntimeContext, RuntimePath };
+//# sourceMappingURL=runtime.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.cts","names":[],"sources":["../../src/types/runtime.ts"],"sourcesContent":[],"mappings":";UAkBiB,WAAA;EAAA;AAYjB;;EAIM,KAAA,EAAA,MAAA;EACU;;;EAUR,QAAA,EAAA,CAAA,MAAA,GAAA,MAAA,EAAA,CAAA,EAAA;;UAfS,gCACE,kEAGb,+EACU,cAAc;;;;WAKnB;;;;QAKH"}

package/dist/types/runtime.d.mts

@@ -0,0 +1,24 @@
+//#region src/types/runtime.d.ts
+interface RuntimePath {
+  /**
+   * The full path as a string value.
+   */
+  value: string;
+  /**
+   * The individual segments that make up the path.
+   */
+  segments: (string | string[])[];
+}
+interface RuntimeContext<TOptions extends Record<string, string | number | boolean | string[] | number[]> = Record<string, string | number | boolean | string[] | number[]>, TPath extends RuntimePath = RuntimePath> {
+  /**
+   * The parsed command-line options.
+   */
+  options: TOptions;
+  /**
+   * The current command path within the runtime context.
+   */
+  path: TPath;
+}
+//#endregion
+export { RuntimeContext, RuntimePath };
+//# sourceMappingURL=runtime.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../../src/types/runtime.ts"],"sourcesContent":[],"mappings":";UAkBiB,WAAA;EAAA;AAYjB;;EAIM,KAAA,EAAA,MAAA;EACU;;;EAUR,QAAA,EAAA,CAAA,MAAA,GAAA,MAAA,EAAA,CAAA,EAAA;;UAfS,gCACE,kEAGb,+EACU,cAAc;;;;WAKnB;;;;QAKH"}

package/dist/types/runtime.mjs

@@ -0,0 +1 @@
+export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "repository": {
@@ -298,6 +298,20 @@
         "types": "./dist/types/options.d.mts",
         "default": "./dist/types/options.mjs"
       }
+    },
+    "./types/runtime": {
+      "require": {
+        "types": "./dist/types/runtime.d.cts",
+        "default": "./dist/types/runtime.cjs"
+      },
+      "import": {
+        "types": "./dist/types/runtime.d.mts",
+        "default": "./dist/types/runtime.mjs"
+      },
+      "default": {
+        "types": "./dist/types/runtime.d.mts",
+        "default": "./dist/types/runtime.mjs"
+      }
     }
   },
   "types": "./dist/index.d.cts",
@@ -305,10 +319,15 @@
   "files": ["dist/**/*"],
   "keywords": ["shell-shock", "powerlines", "storm-software"],
   "dependencies": {
-    "@powerlines/deepkit": "^0.6.37",
-    "@powerlines/plugin-nodejs": "^0.1.160",
-    "@powerlines/plugin-plugin": "^0.12.208",
-    "@powerlines/plugin-tsdown": "^0.1.210",
+    "@alloy-js/core": "0.22.0",
+    "@alloy-js/markdown": "0.22.0",
+    "@powerlines/deepkit": "^0.6.43",
+    "@powerlines/plugin-alloy": "^0.20.6",
+    "@powerlines/plugin-automd": "^0.1.263",
+    "@powerlines/plugin-deepkit": "^0.11.142",
+    "@powerlines/plugin-nodejs": "^0.1.167",
+    "@powerlines/plugin-plugin": "^0.12.214",
+    "@powerlines/plugin-tsdown": "^0.1.216",
     "@stryke/cli": "^0.13.12",
     "@stryke/convert": "^0.6.38",
     "@stryke/fs": "^0.33.40",
@@ -320,12 +339,10 @@
     "@stryke/types": "^0.10.37",
     "automd": "0.4.2",
     "defu": "^6.1.4",
-    "powerlines": "^0.38.24",
-    "@alloy-js/core": "0.22.0",
-    "@alloy-js/markdown": "0.22.0",
-    "@powerlines/plugin-alloy": "^0.19.37"
+    "powerlines": "^0.38.30",
+    "rolldown": "1.0.0-beta.52"
   },
   "devDependencies": { "@types/node": "^22.19.7", "typescript": "^5.9.3" },
   "publishConfig": { "access": "public" },
-  "gitHead": "150522912ecb85c5d409659bc146c2c6ae635923"
+  "gitHead": "ad8f1104e63a42de787eb5c5ec5c57e27f8a682e"
 }