@shell-shock/core 0.2.0 → 0.3.0

package/dist/plugin.mjs.map

@@ -0,0 +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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"}

package/dist/types/command.d.cts

@@ -6,13 +6,13 @@ interface BaseCommandOption {
   name: string;
   kind: ReflectionKind;
   title: string;
-  description?: string;
+  description: string;
   alias: string[];
+  env: string | false;
   optional: boolean;
 }
 interface StringCommandOption extends BaseCommandOption {
   kind: ReflectionKind.string;
-  format?: "path" | "url" | "date" | "time" | "datetime" | "json" | "regex" | string;
   default?: string;
   variadic: boolean;
 }
@@ -35,21 +35,29 @@ interface CommandParam {
   optional: boolean;
   variadic: boolean;
 }
+interface CommandPath {
+  value: string | null;
+  segments: string[];
+}
 interface CommandBase {
   id: string | null;
   name: string;
   title?: string;
   description?: string;
-  path: string[];
+  path: CommandPath;
   isVirtual: boolean;
 }
 interface CommandInput extends CommandBase {
   id: string;
   entry: ResolvedEntryTypeDefinition;
 }
+interface CommandTreePath extends CommandPath {
+  variables: Record<string, CommandParam>;
+}
 type CommandTree = CommandInput & {
   title: string;
   description: string;
+  path: CommandTreePath;
   options: Record<string, CommandOption>;
   params: CommandParam[];
   parent: null | CommandTree;
@@ -60,4 +68,5 @@ type SerializedCommandTree = Omit<CommandTree, "parent" | "children"> & {
   children: Record<string, SerializedCommandTree>;
 };
 //#endregion
-export { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, NumberCommandOption, SerializedCommandTree, StringCommandOption };
+export { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, NumberCommandOption, SerializedCommandTree, StringCommandOption };
+//# sourceMappingURL=command.d.cts.map

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

@@ -0,0 +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"}

package/dist/types/command.d.mts

@@ -6,13 +6,13 @@ interface BaseCommandOption {
   name: string;
   kind: ReflectionKind;
   title: string;
-  description?: string;
+  description: string;
   alias: string[];
+  env: string | false;
   optional: boolean;
 }
 interface StringCommandOption extends BaseCommandOption {
   kind: ReflectionKind.string;
-  format?: "path" | "url" | "date" | "time" | "datetime" | "json" | "regex" | string;
   default?: string;
   variadic: boolean;
 }
@@ -35,21 +35,29 @@ interface CommandParam {
   optional: boolean;
   variadic: boolean;
 }
+interface CommandPath {
+  value: string | null;
+  segments: string[];
+}
 interface CommandBase {
   id: string | null;
   name: string;
   title?: string;
   description?: string;
-  path: string[];
+  path: CommandPath;
   isVirtual: boolean;
 }
 interface CommandInput extends CommandBase {
   id: string;
   entry: ResolvedEntryTypeDefinition;
 }
+interface CommandTreePath extends CommandPath {
+  variables: Record<string, CommandParam>;
+}
 type CommandTree = CommandInput & {
   title: string;
   description: string;
+  path: CommandTreePath;
   options: Record<string, CommandOption>;
   params: CommandParam[];
   parent: null | CommandTree;
@@ -60,4 +68,5 @@ type SerializedCommandTree = Omit<CommandTree, "parent" | "children"> & {
   children: Record<string, SerializedCommandTree>;
 };
 //#endregion
-export { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, NumberCommandOption, SerializedCommandTree, StringCommandOption };
+export { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, NumberCommandOption, SerializedCommandTree, StringCommandOption };
+//# sourceMappingURL=command.d.mts.map

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

@@ -0,0 +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"}

package/dist/types/command.mjs

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

package/dist/types/config.d.cts

@@ -1,40 +1,88 @@
 import { CommandBase, CommandOption } from "./command.cjs";
 import { Context } from "./context.cjs";
-import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown";
+import { OutputConfig as OutputConfig$1 } from "powerlines/types/config";
+import { NodeJsPluginResolvedConfig } from "@powerlines/plugin-nodejs/types/plugin";
+import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown/types/plugin";
 
 //#region src/types/config.d.ts
-interface Options {
+type BaseConfig = Pick<TsdownPluginUserConfig, "root" | "name" | "title" | "description" | "logLevel" | "mode" | "skipCache" | "autoInstall" | "entry" | "plugins" | "tsconfig" | "tsconfigRaw">;
+/**
+ * The plugin options for Shell Shock.
+ */
+type Options = Partial<BaseConfig> & {
   /**
-   * The default interactive mode to apply to commands.
+   * A set of default command options to apply to each command.
    *
    * @remarks
-   * The following modes are available:
-   * - `true`: Enable interactivity when a TTY is detected and no explicit interactive flag is set (default).
-   * - `false`: Disable interactivity unless an explicit interactive flag is set.
-   * - `"never"`: Always disable interactivity, regardless of TTY presence or flags.
+   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.
+   */
+  defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
+  /**
+   * Determines whether commands' name and option names are treated as case-sensitive.
    *
-   * @defaultValue `true`
+   * @defaultValue `false`
    */
-  interactive?: boolean | "never";
+  isCaseSensitive?: boolean;
   /**
-   * A set of default command options to apply to each command.
+   * 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).
    *
    * @remarks
-   * By default, Shell Shock adds the following set of default arguments to each command:
-   * - `--help` (`-h`, `-?`): Show help information.
-   * - `--version` (`-v`): Show the version of the application.
+   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.
    *
-   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.
+   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin
+   * @see https://yarnpkg.com/cli/bin
+   * @see https://pnpm.io/package_json#bin
    */
-  defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
+  bin?: string | string[];
+  /**
+   * An application specific prefix to check for environment variables.
+   *
+   * @remarks
+   * If not provided, Shell Shock will convert {@link Options.name | name} to {@link https://stringcase.org/cases/constant/ | constant case} format and append an underscore (`_`). If the provided {@link Options.name | name} is `"my-app"`, environment variables starting with `"MY_APP_"` will be used - for example: `"MY_APP_CONFIG_NAME"`. If a trailing underscore already exists in the user provided value, it will result in two consecutive underscores - for example: `"MY_APP__CONFIG_NAME"` (this was done intentionally so that users who specifically want multiple underscores have a way to do so).
+   *
+   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa
+   * @see https://stringcase.org/cases/constant/
+   */
+  envPrefix?: string;
+};
+/**
+ * The output configuration options for Shell Shock.
+ */
+type OutputConfig = Pick<OutputConfig$1, "outputPath" | "assets" | "storage"> & {
   /**
-   * The name(s) of the binary that will be generated to run the CLI
+   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.
    */
-  bin?: string | string[];
-}
-type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Options;
-type ResolvedConfig = TsdownPluginResolvedConfig & Required<Omit<Options, "bin"> & {
-  bin: string[];
-}>;
+  dts?: false;
+};
+/**
+ * The user configuration options for Shell Shock.
+ */
+type UserConfig = Options & {
+  /**
+   * Configuration for the output of the build process
+   */
+  output?: OutputConfig;
+};
+/**
+ * The resolved configuration options for Shell Shock.
+ */
+type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & 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).
+   *
+   * @remarks
+   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.
+   *
+   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin
+   * @see https://yarnpkg.com/cli/bin
+   * @see https://pnpm.io/package_json#bin
+   */
+  bin: Record<string, string>;
+  /**
+   * The user configuration for the Shell Shock process.
+   */
+  userConfig: UserConfig & NodeJsPluginResolvedConfig;
+};
 //#endregion
-export { Options, ResolvedConfig, UserConfig };
+export { BaseConfig, Options, OutputConfig, ResolvedConfig, UserConfig };
+//# sourceMappingURL=config.d.cts.map

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

@@ -0,0 +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"}

package/dist/types/config.d.mts

@@ -1,40 +1,88 @@
 import { CommandBase, CommandOption } from "./command.mjs";
 import { Context } from "./context.mjs";
-import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown";
+import { OutputConfig as OutputConfig$1 } from "powerlines/types/config";
+import { NodeJsPluginResolvedConfig } from "@powerlines/plugin-nodejs/types/plugin";
+import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown/types/plugin";
 
 //#region src/types/config.d.ts
-interface Options {
+type BaseConfig = Pick<TsdownPluginUserConfig, "root" | "name" | "title" | "description" | "logLevel" | "mode" | "skipCache" | "autoInstall" | "entry" | "plugins" | "tsconfig" | "tsconfigRaw">;
+/**
+ * The plugin options for Shell Shock.
+ */
+type Options = Partial<BaseConfig> & {
   /**
-   * The default interactive mode to apply to commands.
+   * A set of default command options to apply to each command.
    *
    * @remarks
-   * The following modes are available:
-   * - `true`: Enable interactivity when a TTY is detected and no explicit interactive flag is set (default).
-   * - `false`: Disable interactivity unless an explicit interactive flag is set.
-   * - `"never"`: Always disable interactivity, regardless of TTY presence or flags.
+   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.
+   */
+  defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
+  /**
+   * Determines whether commands' name and option names are treated as case-sensitive.
    *
-   * @defaultValue `true`
+   * @defaultValue `false`
    */
-  interactive?: boolean | "never";
+  isCaseSensitive?: boolean;
   /**
-   * A set of default command options to apply to each command.
+   * 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).
    *
    * @remarks
-   * By default, Shell Shock adds the following set of default arguments to each command:
-   * - `--help` (`-h`, `-?`): Show help information.
-   * - `--version` (`-v`): Show the version of the application.
+   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.
    *
-   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.
+   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin
+   * @see https://yarnpkg.com/cli/bin
+   * @see https://pnpm.io/package_json#bin
    */
-  defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
+  bin?: string | string[];
+  /**
+   * An application specific prefix to check for environment variables.
+   *
+   * @remarks
+   * If not provided, Shell Shock will convert {@link Options.name | name} to {@link https://stringcase.org/cases/constant/ | constant case} format and append an underscore (`_`). If the provided {@link Options.name | name} is `"my-app"`, environment variables starting with `"MY_APP_"` will be used - for example: `"MY_APP_CONFIG_NAME"`. If a trailing underscore already exists in the user provided value, it will result in two consecutive underscores - for example: `"MY_APP__CONFIG_NAME"` (this was done intentionally so that users who specifically want multiple underscores have a way to do so).
+   *
+   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa
+   * @see https://stringcase.org/cases/constant/
+   */
+  envPrefix?: string;
+};
+/**
+ * The output configuration options for Shell Shock.
+ */
+type OutputConfig = Pick<OutputConfig$1, "outputPath" | "assets" | "storage"> & {
   /**
-   * The name(s) of the binary that will be generated to run the CLI
+   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.
    */
-  bin?: string | string[];
-}
-type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Options;
-type ResolvedConfig = TsdownPluginResolvedConfig & Required<Omit<Options, "bin"> & {
-  bin: string[];
-}>;
+  dts?: false;
+};
+/**
+ * The user configuration options for Shell Shock.
+ */
+type UserConfig = Options & {
+  /**
+   * Configuration for the output of the build process
+   */
+  output?: OutputConfig;
+};
+/**
+ * The resolved configuration options for Shell Shock.
+ */
+type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & 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).
+   *
+   * @remarks
+   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.
+   *
+   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin
+   * @see https://yarnpkg.com/cli/bin
+   * @see https://pnpm.io/package_json#bin
+   */
+  bin: Record<string, string>;
+  /**
+   * The user configuration for the Shell Shock process.
+   */
+  userConfig: UserConfig & NodeJsPluginResolvedConfig;
+};
 //#endregion
-export { Options, ResolvedConfig, UserConfig };
+export { BaseConfig, Options, OutputConfig, ResolvedConfig, UserConfig };
+//# sourceMappingURL=config.d.mts.map

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

@@ -0,0 +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"}

package/dist/types/config.mjs

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

package/dist/types/context.d.cts

@@ -1,9 +1,11 @@
 import { CommandInput, CommandOption, CommandTree } from "./command.cjs";
 import { ResolvedConfig } from "./config.cjs";
-import { TsdownPluginContext } from "@powerlines/plugin-tsdown";
+import { NodeJsPluginContext } from "@powerlines/plugin-nodejs/types/plugin";
+import { TsdownPluginContext } from "@powerlines/plugin-tsdown/types/plugin";
+import { UnresolvedContext as UnresolvedContext$1 } from "powerlines/types/context";
 
 //#region src/types/context.d.ts
-type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & {
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & NodeJsPluginContext<TResolvedConfig> & {
   /**
    * The root path where commands are located.
    */
@@ -21,5 +23,7 @@ type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPl
    */
   commands: Record<string, CommandTree>;
 };
+type UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = UnresolvedContext$1<TResolvedConfig>;
 //#endregion
-export { Context };
+export { Context, UnresolvedContext };
+//# sourceMappingURL=context.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.cts","names":[],"sources":["../../src/types/context.ts"],"sourcesContent":[],"mappings":";;;;;;;KAwBY,gCAAgC,iBAAiB,kBAC3D,oBAAoB,mBAClB,oBAAoB;;AAFxB;;EAA6D,YAAA,EAAA,MAAA;EACvC;;;EAClB,OAAA,EASW,aATX,EAAA;EASW;;;EAUC,MAAA,EALF,YAKE,EAAA;EAAM;AAGtB;;EAC2C,QAAA,EAJ3B,MAI2B,CAAA,MAAA,EAJZ,WAIY,CAAA;CACX;AAA5B,KAFQ,iBAER,CAAA,wBADsB,cACtB,GADuC,cACvC,CAAA,GAAA,mBAAA,CAA4B,eAA5B,CAAA"}

package/dist/types/context.d.mts

@@ -1,9 +1,11 @@
 import { CommandInput, CommandOption, CommandTree } from "./command.mjs";
 import { ResolvedConfig } from "./config.mjs";
-import { TsdownPluginContext } from "@powerlines/plugin-tsdown";
+import { NodeJsPluginContext } from "@powerlines/plugin-nodejs/types/plugin";
+import { TsdownPluginContext } from "@powerlines/plugin-tsdown/types/plugin";
+import { UnresolvedContext as UnresolvedContext$1 } from "powerlines/types/context";
 
 //#region src/types/context.d.ts
-type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & {
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & NodeJsPluginContext<TResolvedConfig> & {
   /**
    * The root path where commands are located.
    */
@@ -21,5 +23,7 @@ type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPl
    */
   commands: Record<string, CommandTree>;
 };
+type UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = UnresolvedContext$1<TResolvedConfig>;
 //#endregion
-export { Context };
+export { Context, UnresolvedContext };
+//# sourceMappingURL=context.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.mts","names":[],"sources":["../../src/types/context.ts"],"sourcesContent":[],"mappings":";;;;;;;KAwBY,gCAAgC,iBAAiB,kBAC3D,oBAAoB,mBAClB,oBAAoB;;AAFxB;;EAA6D,YAAA,EAAA,MAAA;EACvC;;;EAClB,OAAA,EASW,aATX,EAAA;EASW;;;EAUC,MAAA,EALF,YAKE,EAAA;EAAM;AAGtB;;EAC2C,QAAA,EAJ3B,MAI2B,CAAA,MAAA,EAJZ,WAIY,CAAA;CACX;AAA5B,KAFQ,iBAER,CAAA,wBADsB,cACtB,GADuC,cACvC,CAAA,GAAA,mBAAA,CAA4B,eAA5B,CAAA"}

package/dist/types/context.mjs

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

package/dist/types/index.d.cts

@@ -1,5 +1,5 @@
-import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./command.cjs";
-import { Context } from "./context.cjs";
-import { Options, ResolvedConfig, UserConfig } from "./config.cjs";
+import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./command.cjs";
+import { Context, UnresolvedContext } from "./context.cjs";
+import { BaseConfig, Options, OutputConfig, ResolvedConfig, UserConfig } from "./config.cjs";
 import { BaseCommandOptions } from "./options.cjs";
-export { BaseCommandOption, BaseCommandOptions, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, Context, NumberCommandOption, Options, ResolvedConfig, SerializedCommandTree, StringCommandOption, UserConfig };
+export { BaseCommandOption, BaseCommandOptions, BaseConfig, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, Context, NumberCommandOption, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, StringCommandOption, UnresolvedContext, UserConfig };

package/dist/types/index.d.mts

@@ -1,5 +1,5 @@
-import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./command.mjs";
-import { Context } from "./context.mjs";
-import { Options, ResolvedConfig, UserConfig } from "./config.mjs";
+import { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, NumberCommandOption, SerializedCommandTree, StringCommandOption } from "./command.mjs";
+import { Context, UnresolvedContext } from "./context.mjs";
+import { BaseConfig, Options, OutputConfig, ResolvedConfig, UserConfig } from "./config.mjs";
 import { BaseCommandOptions } from "./options.mjs";
-export { BaseCommandOption, BaseCommandOptions, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, Context, NumberCommandOption, Options, ResolvedConfig, SerializedCommandTree, StringCommandOption, UserConfig };
+export { BaseCommandOption, BaseCommandOptions, BaseConfig, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandPath, CommandTree, CommandTreePath, Context, NumberCommandOption, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, StringCommandOption, UnresolvedContext, UserConfig };

package/dist/types/index.mjs

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

package/dist/types/internal.d.cts

@@ -0,0 +1,24 @@
+import { Context } from "./context.cjs";
+import { ResolvedConfig } from "./config.cjs";
+
+//#region src/types/internal.d.ts
+
+/**
+ * An internal representation of the plugin context, used for managing hooks and environment data.
+ *
+ * @internal
+ */
+interface UNSAFE_ContextInternal {
+  id: string;
+}
+/**
+ * An internal representation of the plugin context, used for managing hooks and environment data.
+ *
+ * @internal
+ */
+interface UNSAFE_Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
+  $$internal: UNSAFE_ContextInternal;
+}
+//#endregion
+export { UNSAFE_Context, UNSAFE_ContextInternal };
+//# sourceMappingURL=internal.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.cts","names":[],"sources":["../../src/types/internal.ts"],"sourcesContent":[],"mappings":";;;;;;;AA4BA;AASA;;AAC2C,UAV1B,sBAAA,CAU0B;EACzB,EAAA,EAAA,MAAA;;;;;;;UAFD,uCACS,iBAAiB,wBACjC,QAAQ;cACJ"}

package/dist/types/internal.d.mts

@@ -0,0 +1,24 @@
+import { Context } from "./context.mjs";
+import { ResolvedConfig } from "./config.mjs";
+
+//#region src/types/internal.d.ts
+
+/**
+ * An internal representation of the plugin context, used for managing hooks and environment data.
+ *
+ * @internal
+ */
+interface UNSAFE_ContextInternal {
+  id: string;
+}
+/**
+ * An internal representation of the plugin context, used for managing hooks and environment data.
+ *
+ * @internal
+ */
+interface UNSAFE_Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
+  $$internal: UNSAFE_ContextInternal;
+}
+//#endregion
+export { UNSAFE_Context, UNSAFE_ContextInternal };
+//# sourceMappingURL=internal.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.mts","names":[],"sources":["../../src/types/internal.ts"],"sourcesContent":[],"mappings":";;;;;;;AA4BA;AASA;;AAC2C,UAV1B,sBAAA,CAU0B;EACzB,EAAA,EAAA,MAAA;;;;;;;UAFD,uCACS,iBAAiB,wBACjC,QAAQ;cACJ"}

package/dist/types/internal.mjs

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

package/dist/types/options.d.cts

@@ -4,4 +4,5 @@ interface BaseCommandOptions {
   version: boolean;
 }
 //#endregion
-export { BaseCommandOptions };
+export { BaseCommandOptions };
+//# sourceMappingURL=options.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.cts","names":[],"sources":["../../src/types/options.ts"],"sourcesContent":[],"mappings":";UAkBiB,kBAAA;EAAA,IAAA,EAAA,OAAA"}

package/dist/types/options.d.mts

@@ -4,4 +4,5 @@ interface BaseCommandOptions {
   version: boolean;
 }
 //#endregion
-export { BaseCommandOptions };
+export { BaseCommandOptions };
+//# sourceMappingURL=options.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.mts","names":[],"sources":["../../src/types/options.ts"],"sourcesContent":[],"mappings":";UAkBiB,kBAAA;EAAA,IAAA,EAAA,OAAA"}

package/dist/types/options.mjs

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