@shell-shock/core 0.1.1 → 0.2.1

package/dist/powerlines.d.mts

@@ -1,5 +1,5 @@
+import { Context } from "./types/context.mjs";
 import { Options } from "./types/config.mjs";
-import { BuildContext } from "./types/build.mjs";
 import { Plugin } from "powerlines";
 
 //#region src/powerlines.d.ts
@@ -7,6 +7,6 @@ import { Plugin } from "powerlines";
 /**
  * The core Powerlines plugin to build Shell Shock projects.
  */
-declare const shellShock: <TContext extends BuildContext = BuildContext>(options?: Options) => Plugin<TContext>;
+declare const shellShock: <TContext extends Context = Context>(options?: Options) => Plugin<TContext>[];
 //#endregion
 export { shellShock as default, shellShock };

package/dist/powerlines.mjs

@@ -1,2 +1,168 @@
-import{findCommandsRoot as e,resolveCommandPath as t}from"./helpers/resolve-command.mjs";import{updatePackageJsonBinary as n}from"./helpers/update-package-json.mjs";import r from"@powerlines/plugin-tsdown";import{chmodX as i}from"@stryke/fs/chmod-x";import{appendPath as a}from"@stryke/path/append";import{findFileName as o,findFilePath as s,findFolderName as c}from"@stryke/path/file-path-fns";import{isParentPath as l}from"@stryke/path/is-parent-path";import{joinPaths as u}from"@stryke/path/join-paths";import{resolveParentPath as d}from"@stryke/path/resolve-parent-path";import{titleCase as f}from"@stryke/string-format/title-case";import{isSetObject as p}from"@stryke/type-checks/is-set-object";import{defu as m}from"defu";import{existsSync as h}from"node:fs";const g=(g={})=>({name:`shell-shock`,dependsOn:[r()],async config(){return this.trace(`Resolving the Shell Shock configuration.`),m(g,{entry:!this.config.entry||Array.isArray(this.config.entry)&&this.config.entry.length===0?[u(this.config.sourceRoot,`**/*`)]:void 0,build:{variant:`tsdown`},interactive:!0,skipDefaultArgs:!1,type:`application`,framework:`shell-shock`,singleBuild:!0})},async configResolved(){this.trace(`Shell Shock configuration has been resolved.`),await n(this),this.commandsRoot=e(this),this.commands??=[],this.commands=this.entry.filter(e=>o(e.file,{withExtension:!1})===`command`).reduce((e,n)=>{let r=a(a(n.file,this.config.projectRoot),this.workspaceConfig.workspaceRoot);if(!l(r,this.commandsRoot))throw Error(`Command entry point "${r}" is not located within the commands root "${this.commandsRoot}". Please ensure that all command entry points are located within the current project.`);let i=t(this,r),o=i.replaceAll(`/`,`-`);return e.some(e=>e.name===o)||e.push({path:i.split(`/`).filter(Boolean),name:o,title:f(o),isVirtual:!1,entry:{...n,file:r,input:n,output:o}}),e},this.commands)},async prepare(){if(this.trace(`Finding and adding virtual commands to the entry points.`),this.commands=this.commands.reduce((e,n)=>{let r=0,i=d(s(n.entry.file));for(;i!==this.commandsRoot;){if(r++>50)throw Error(`Maximum command virtual parent depth of 50 exceeded while processing command: ${n.name}`);let a=c(i);if(!e.some(e=>s(e.entry.file)===i)&&(!a.startsWith(`[`)||!a.endsWith(`]`))){let n=t(this,i),r=n.replaceAll(`/`,`-`);e.push({path:n.split(`/`).filter(Boolean),name:r,title:f(r),isVirtual:!0,entry:{file:u(i,`command.ts`),input:{file:u(i,`command.ts`)},output:a}})}i=d(i)}return e},this.commands).sort((e,t)=>e.name.localeCompare(t.name)),this.commands.length===0){this.warn(`No commands were found in the project. Please ensure at least one command exists.`);return}this.info(`Creating an application with the following commands: \n${this.commands.map(e=>` - ${e.title} (${e.name}): ${e.entry.file}${e.isVirtual?` (virtual)`:``}`).join(`
-`)}`),this.entry=[]},async buildEnd(){if(!p(this.packageJson.bin)){this.warn(`No binaries were found in package.json. Please ensure the binaries are correctly configured.`);return}this.debug(`Adding executable permissions to binaries.`);for(let e of Object.values(this.packageJson.bin))h(a(e,this.config.output.buildPath))&&await i(a(e,this.config.output.buildPath))}});var _=g;export{_ as default,g as shellShock};
+import { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence } from "./helpers/persistence.mjs";
+import { findCommandName, findCommandsRoot, reflectCommandTree, resolveCommandPath } from "./helpers/resolve-command.mjs";
+import { updatePackageJsonBinary } from "./helpers/update-package-json.mjs";
+import { getAppDescription, getAppName, getAppTitle } from "./helpers/utilities.mjs";
+import tsdown from "@powerlines/plugin-tsdown";
+import { chmodX } from "@stryke/fs/chmod-x";
+import { getUniqueBy } from "@stryke/helpers/get-unique";
+import { appendPath } from "@stryke/path/append";
+import { findFileName, findFilePath } from "@stryke/path/file-path-fns";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { joinPaths } from "@stryke/path/join-paths";
+import { replacePath } from "@stryke/path/replace";
+import { resolveParentPath } from "@stryke/path/resolve-parent-path";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { defu } from "defu";
+
+//#region src/powerlines.ts
+const MAX_DEPTH = 50;
+/**
+* The core Powerlines plugin to build Shell Shock projects.
+*/
+const shellShock = (options = {}) => {
+	return [
+		tsdown(),
+		{
+			name: "shell-shock:config",
+			async config() {
+				this.trace("Resolving the Shell Shock configuration.");
+				return defu(options, {
+					entry: !this.config.entry || Array.isArray(this.config.entry) && this.config.entry.length === 0 ? [joinPaths(this.config.sourceRoot, "**/*")] : void 0,
+					build: {
+						target: "node22",
+						platform: "node"
+					},
+					type: "application",
+					framework: "shell-shock"
+				});
+			},
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.trace("Shell Shock configuration has been resolved.");
+					await updatePackageJsonBinary(this);
+					this.config.name = getAppName(this);
+					this.config.title = getAppTitle(this);
+					this.config.description = getAppDescription(this);
+					if (this.config.defaultOptions === false) this.options = [];
+					else if (Array.isArray(this.config.defaultOptions)) this.options = getUniqueBy(this.config.defaultOptions, (item) => item.name);
+					else if (isFunction(this.config.defaultOptions)) this.options = getUniqueBy(this.config.defaultOptions(this, {
+						id: null,
+						name: this.config.name,
+						title: this.config.title,
+						description: this.config.description,
+						path: [],
+						isVirtual: false
+					}), (item) => item.name);
+					this.inputs ??= [];
+				}
+			}
+		},
+		{
+			name: "shell-shock:inputs",
+			async configResolved() {
+				this.trace("Finding command entry points.");
+				this.commandsPath = findCommandsRoot(this);
+				this.inputs = this.entry.filter((entry) => findFileName(entry.file, { withExtension: false }) === "command").reduce((ret, entry) => {
+					const file = appendPath(appendPath(entry.file, this.config.projectRoot), this.workspaceConfig.workspaceRoot);
+					if (!isParentPath(file, this.commandsPath)) throw new Error(`Command entry point "${file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+					const path = resolveCommandPath(this, file);
+					const id = path.replaceAll("/", "-");
+					if (!ret.some((existing) => existing.id === id)) {
+						const name = findCommandName(file);
+						ret.push({
+							id,
+							path: path.split("/").filter(Boolean),
+							name,
+							title: titleCase(name),
+							isVirtual: false,
+							entry: {
+								...entry,
+								file,
+								input: {
+									file: entry.file,
+									name: entry.name
+								},
+								output: name
+							}
+						});
+					}
+					return ret;
+				}, this.inputs);
+			}
+		},
+		{
+			name: "shell-shock:virtual-inputs",
+			configResolved: {
+				order: "post",
+				async handler() {
+					if (this.inputs.length === 0) this.warn("No commands were found in the project. Please ensure at least one command exists.");
+					else {
+						this.info(`Shell Shock will create an application with the following commands: \n${this.inputs.filter((cmd) => !cmd.isVirtual).map((command) => ` - ${command.id}: ${replacePath(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+						this.trace("Finding and adding virtual command inputs for each command previously found.");
+						this.inputs = this.inputs.reduce((ret, command) => {
+							let depth = 0;
+							let parentPath = resolveParentPath(findFilePath(command.entry.file));
+							while (parentPath !== this.commandsPath) {
+								if (depth++ > MAX_DEPTH) throw new Error(`Maximum command virtual parent depth of ${MAX_DEPTH} exceeded while processing command: ${command.name}`);
+								if (!ret.some((existing) => findFilePath(existing.entry.file) === parentPath)) {
+									const file = joinPaths(parentPath, "command.ts");
+									const path = resolveCommandPath(this, file);
+									const id = path.replaceAll("/", "-");
+									if (!ret.some((existing) => existing.id === id)) {
+										const name = findCommandName(file);
+										ret.push({
+											id,
+											path: path.split("/").filter(Boolean),
+											name,
+											title: titleCase(name),
+											isVirtual: true,
+											entry: {
+												file,
+												input: { file }
+											}
+										});
+									}
+								}
+								parentPath = resolveParentPath(parentPath);
+							}
+							return ret;
+						}, this.inputs).sort((a, b) => a.path.length - b.path.length);
+						this.trace(`Final command input list: \n${this.inputs.map((command) => ` - ${command.id}: ${replacePath(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+					}
+				}
+			}
+		},
+		{
+			name: "shell-shock:reflect-commands",
+			async prepare() {
+				this.entry = [];
+				this.commands = {};
+				if (this.config.command !== "prepare" && this.config.skipCache !== true && this.persistedMeta?.checksum === this.meta.checksum && this.fs.existsSync(getCommandsPersistencePath(this))) {
+					this.debug(`Skipping reflection initialization as the meta checksum has not changed.`);
+					await readCommandsPersistence(this);
+				} else {
+					for (const input of this.inputs.filter((input$1) => input$1.path.length === 1)) this.commands[input.name] = await reflectCommandTree(this, input);
+					await writeCommandsPersistence(this);
+				}
+			}
+		},
+		{
+			name: "shell-shock:chmod+x",
+			async buildEnd() {
+				if (!isSetObject(this.packageJson.bin)) {
+					this.warn("No binaries were found in package.json. Please ensure the binaries are correctly configured.");
+					return;
+				}
+				this.debug("Adding executable permissions to binaries.");
+				for (const executablePath of Object.values(this.packageJson.bin)) if (this.fs.existsSync(appendPath(executablePath, this.config.output.buildPath))) await chmodX(appendPath(executablePath, this.config.output.buildPath));
+			}
+		}
+	];
+};
+var powerlines_default = shellShock;
+
+//#endregion
+export { powerlines_default as default, shellShock };

package/dist/types/command.d.cts

@@ -0,0 +1,63 @@
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { ResolvedEntryTypeDefinition } from "powerlines/types/resolved";
+
+//#region src/types/command.d.ts
+interface BaseCommandOption {
+  name: string;
+  kind: ReflectionKind;
+  title: string;
+  description?: string;
+  alias: string[];
+  optional: boolean;
+}
+interface StringCommandOption extends BaseCommandOption {
+  kind: ReflectionKind.string;
+  format?: "path" | "url" | "date" | "time" | "datetime" | "json" | "regex" | string;
+  default?: string;
+  variadic: boolean;
+}
+interface NumberCommandOption extends BaseCommandOption {
+  kind: ReflectionKind.number;
+  default?: number;
+  variadic: boolean;
+}
+interface BooleanCommandOption extends BaseCommandOption {
+  kind: ReflectionKind.boolean;
+  default?: boolean;
+  isNegativeOf?: string;
+  skipAddingNegative?: boolean;
+}
+type CommandOption = StringCommandOption | NumberCommandOption | BooleanCommandOption;
+interface CommandParam {
+  name: string;
+  description?: string;
+  default?: string;
+  optional: boolean;
+  variadic: boolean;
+}
+interface CommandBase {
+  id: string | null;
+  name: string;
+  title?: string;
+  description?: string;
+  path: string[];
+  isVirtual: boolean;
+}
+interface CommandInput extends CommandBase {
+  id: string;
+  entry: ResolvedEntryTypeDefinition;
+}
+type CommandTree = CommandInput & {
+  title: string;
+  description: string;
+  options: Record<string, CommandOption>;
+  params: CommandParam[];
+  parent: null | CommandTree;
+  children: Record<string, CommandTree>;
+};
+type SerializedCommandTree = Omit<CommandTree, "parent" | "children"> & {
+  parent: null | string;
+  children: Record<string, SerializedCommandTree>;
+};
+//#endregion
+export { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, NumberCommandOption, SerializedCommandTree, StringCommandOption };

package/dist/types/command.d.mts

@@ -0,0 +1,63 @@
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { ResolvedEntryTypeDefinition } from "powerlines/types/resolved";
+
+//#region src/types/command.d.ts
+interface BaseCommandOption {
+  name: string;
+  kind: ReflectionKind;
+  title: string;
+  description?: string;
+  alias: string[];
+  optional: boolean;
+}
+interface StringCommandOption extends BaseCommandOption {
+  kind: ReflectionKind.string;
+  format?: "path" | "url" | "date" | "time" | "datetime" | "json" | "regex" | string;
+  default?: string;
+  variadic: boolean;
+}
+interface NumberCommandOption extends BaseCommandOption {
+  kind: ReflectionKind.number;
+  default?: number;
+  variadic: boolean;
+}
+interface BooleanCommandOption extends BaseCommandOption {
+  kind: ReflectionKind.boolean;
+  default?: boolean;
+  isNegativeOf?: string;
+  skipAddingNegative?: boolean;
+}
+type CommandOption = StringCommandOption | NumberCommandOption | BooleanCommandOption;
+interface CommandParam {
+  name: string;
+  description?: string;
+  default?: string;
+  optional: boolean;
+  variadic: boolean;
+}
+interface CommandBase {
+  id: string | null;
+  name: string;
+  title?: string;
+  description?: string;
+  path: string[];
+  isVirtual: boolean;
+}
+interface CommandInput extends CommandBase {
+  id: string;
+  entry: ResolvedEntryTypeDefinition;
+}
+type CommandTree = CommandInput & {
+  title: string;
+  description: string;
+  options: Record<string, CommandOption>;
+  params: CommandParam[];
+  parent: null | CommandTree;
+  children: Record<string, CommandTree>;
+};
+type SerializedCommandTree = Omit<CommandTree, "parent" | "children"> & {
+  parent: null | string;
+  children: Record<string, SerializedCommandTree>;
+};
+//#endregion
+export { BaseCommandOption, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, NumberCommandOption, SerializedCommandTree, StringCommandOption };

package/dist/types/command.mjs

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

package/dist/types/config.d.cts

@@ -1,41 +1,24 @@
+import { CommandBase, CommandOption } from "./command.cjs";
+import { Context } from "./context.cjs";
+import { NodeJsPluginOptions, NodeJsPluginResolvedConfig, NodeJsPluginUserConfig } from "@powerlines/plugin-nodejs/types/plugin";
 import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown";
 
 //#region src/types/config.d.ts
-interface Options {
+interface Options extends NodeJsPluginOptions {
   /**
-   * 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.
-   *
-   * @defaultValue `true`
-   */
-  interactive?: boolean | "never";
-  /**
-   * Whether to skip adding the default arguments to commands.
-   *
-   * @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.
-   * - `--interactive` (`-i`, `--interact`): Enable interactive mode.
-   * - `--no-interactive`: Disable interactive mode.
-   * - `--no-banner`: Hide the banner displayed while running the CLI application.
-   * - `--verbose`: Enable verbose output.
-   *
-   * @defaultValue `false`
+   * 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.
    */
-  skipDefaultArgs?: boolean;
+  defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
   /**
    * The name(s) of the binary that will be generated to run the CLI
    */
   bin?: string | string[];
 }
-type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Options;
-type ResolvedConfig = TsdownPluginResolvedConfig & Required<Omit<Options, "bin"> & {
+type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Partial<NodeJsPluginUserConfig> & Omit<Options, "env">;
+type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "env"> & {
   bin: string[];
 }>;
 //#endregion

package/dist/types/config.d.mts

@@ -1,41 +1,24 @@
+import { CommandBase, CommandOption } from "./command.mjs";
+import { Context } from "./context.mjs";
 import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown";
+import { NodeJsPluginOptions, NodeJsPluginResolvedConfig, NodeJsPluginUserConfig } from "@powerlines/plugin-nodejs/types/plugin";
 
 //#region src/types/config.d.ts
-interface Options {
+interface Options extends NodeJsPluginOptions {
   /**
-   * 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.
-   *
-   * @defaultValue `true`
-   */
-  interactive?: boolean | "never";
-  /**
-   * Whether to skip adding the default arguments to commands.
-   *
-   * @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.
-   * - `--interactive` (`-i`, `--interact`): Enable interactive mode.
-   * - `--no-interactive`: Disable interactive mode.
-   * - `--no-banner`: Hide the banner displayed while running the CLI application.
-   * - `--verbose`: Enable verbose output.
-   *
-   * @defaultValue `false`
+   * 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.
    */
-  skipDefaultArgs?: boolean;
+  defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
   /**
    * The name(s) of the binary that will be generated to run the CLI
    */
   bin?: string | string[];
 }
-type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Options;
-type ResolvedConfig = TsdownPluginResolvedConfig & Required<Omit<Options, "bin"> & {
+type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Partial<NodeJsPluginUserConfig> & Omit<Options, "env">;
+type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "env"> & {
   bin: string[];
 }>;
 //#endregion

package/dist/types/config.mjs

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

package/dist/types/context.d.cts

@@ -0,0 +1,26 @@
+import { CommandInput, CommandOption, CommandTree } from "./command.cjs";
+import { ResolvedConfig } from "./config.cjs";
+import { TsdownPluginContext } from "@powerlines/plugin-tsdown";
+import { EnvPluginContext } from "@powerlines/plugin-env/types/plugin";
+
+//#region src/types/context.d.ts
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & EnvPluginContext<TResolvedConfig> & {
+  /**
+   * The root path where commands are located.
+   */
+  commandsPath: string;
+  /**
+   * The default command arguments to apply to all application commands.
+   */
+  options: CommandOption[];
+  /**
+   * The list of commands discovered in the project.
+   */
+  inputs: CommandInput[];
+  /**
+   * The command-line application structure.
+   */
+  commands: Record<string, CommandTree>;
+};
+//#endregion
+export { Context };

package/dist/types/context.d.mts

@@ -0,0 +1,26 @@
+import { CommandInput, CommandOption, CommandTree } from "./command.mjs";
+import { ResolvedConfig } from "./config.mjs";
+import { TsdownPluginContext } from "@powerlines/plugin-tsdown";
+import { EnvPluginContext } from "@powerlines/plugin-env/types/plugin";
+
+//#region src/types/context.d.ts
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & EnvPluginContext<TResolvedConfig> & {
+  /**
+   * The root path where commands are located.
+   */
+  commandsPath: string;
+  /**
+   * The default command arguments to apply to all application commands.
+   */
+  options: CommandOption[];
+  /**
+   * The list of commands discovered in the project.
+   */
+  inputs: CommandInput[];
+  /**
+   * The command-line application structure.
+   */
+  commands: Record<string, CommandTree>;
+};
+//#endregion
+export { Context };

package/dist/types/context.mjs

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

package/dist/types/index.d.cts

@@ -1,3 +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 { BuildContext, CommandArg, CommandEntry, CommandRelations, CommandTree } from "./build.cjs";
-export { BuildContext, CommandArg, CommandEntry, CommandRelations, CommandTree, Options, ResolvedConfig, UserConfig };
+import { BaseCommandOptions } from "./options.cjs";
+export { BaseCommandOption, BaseCommandOptions, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, Context, NumberCommandOption, Options, ResolvedConfig, SerializedCommandTree, StringCommandOption, UserConfig };

package/dist/types/index.d.mts

@@ -1,3 +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 { BuildContext, CommandArg, CommandEntry, CommandRelations, CommandTree } from "./build.mjs";
-export { BuildContext, CommandArg, CommandEntry, CommandRelations, CommandTree, Options, ResolvedConfig, UserConfig };
+import { BaseCommandOptions } from "./options.mjs";
+export { BaseCommandOption, BaseCommandOptions, BooleanCommandOption, CommandBase, CommandInput, CommandOption, CommandParam, CommandTree, Context, NumberCommandOption, Options, ResolvedConfig, SerializedCommandTree, StringCommandOption, UserConfig };

package/dist/types/index.mjs

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

package/dist/types/options.d.cts

@@ -0,0 +1,7 @@
+//#region src/types/options.d.ts
+interface BaseCommandOptions {
+  help: boolean;
+  version: boolean;
+}
+//#endregion
+export { BaseCommandOptions };

package/dist/types/options.d.mts

@@ -0,0 +1,7 @@
+//#region src/types/options.d.ts
+interface BaseCommandOptions {
+  help: boolean;
+  version: boolean;
+}
+//#endregion
+export { BaseCommandOptions };

package/dist/types/options.mjs

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "type": "module",
-  "description": "A package containing a Shell Shock plugin to generate source code given a list design tokens.",
+  "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "repository": {
     "type": "github",
     "url": "https://github.com/storm-software/shell-shock.git",
@@ -131,23 +131,86 @@
         "types": "./dist/types/*.d.mts",
         "default": "./dist/types/*.mjs"
       }
+    },
+    "./plugin-utils": {
+      "import": {
+        "types": "./dist/plugin-utils/index.d.mts",
+        "default": "./dist/plugin-utils/index.mjs"
+      },
+      "require": {
+        "types": "./dist/plugin-utils/index.d.cts",
+        "default": "./dist/plugin-utils/index.cjs"
+      },
+      "default": {
+        "types": "./dist/plugin-utils/index.d.mts",
+        "default": "./dist/plugin-utils/index.mjs"
+      }
+    },
+    "./plugin-utils/*": {
+      "import": {
+        "types": "./dist/plugin-utils/*.d.mts",
+        "default": "./dist/plugin-utils/*.mjs"
+      },
+      "require": {
+        "types": "./dist/plugin-utils/*.d.cts",
+        "default": "./dist/plugin-utils/*.cjs"
+      },
+      "default": {
+        "types": "./dist/plugin-utils/*.d.mts",
+        "default": "./dist/plugin-utils/*.mjs"
+      }
+    },
+    "./components": {
+      "import": {
+        "types": "./dist/components/index.d.mts",
+        "default": "./dist/components/index.mjs"
+      },
+      "require": {
+        "types": "./dist/components/index.d.cts",
+        "default": "./dist/components/index.cjs"
+      },
+      "default": {
+        "types": "./dist/components/index.d.mts",
+        "default": "./dist/components/index.mjs"
+      }
+    },
+    "./components/*": {
+      "import": {
+        "types": "./dist/components/*.d.mts",
+        "default": "./dist/components/*.mjs"
+      },
+      "require": {
+        "types": "./dist/components/*.d.cts",
+        "default": "./dist/components/*.cjs"
+      },
+      "default": {
+        "types": "./dist/components/*.d.mts",
+        "default": "./dist/components/*.mjs"
+      }
     }
   },
   "files": ["dist/**/*"],
   "keywords": ["shell-shock", "powerlines", "storm-software"],
   "dependencies": {
-    "@powerlines/plugin-plugin": "^0.12.36",
-    "@powerlines/plugin-tsdown": "^0.1.36",
-    "@stryke/convert": "^0.6.29",
-    "@stryke/helpers": "^0.9.31",
-    "@stryke/json": "^0.9.32",
-    "@stryke/path": "^0.24.0",
-    "@stryke/string-format": "^0.12.29",
-    "@stryke/type-checks": "^0.5.14",
+    "@alloy-js/core": "^0.22.0",
+    "@alloy-js/typescript": "^0.22.0",
+    "@powerlines/deepkit": "^0.5.56",
+    "@powerlines/plugin-alloy": "^0.18.24",
+    "@powerlines/plugin-plugin": "^0.12.92",
+    "@powerlines/plugin-tsdown": "^0.1.93",
+    "@stryke/convert": "^0.6.30",
+    "@stryke/fs": "^0.33.27",
+    "@stryke/helpers": "^0.9.32",
+    "@stryke/json": "^0.9.33",
+    "@stryke/path": "^0.24.1",
+    "@stryke/string-format": "^0.12.30",
+    "@stryke/type-checks": "^0.5.15",
     "defu": "^6.1.4",
-    "powerlines": "^0.34.2"
+    "powerlines": "^0.37.14",
+    "@powerlines/plugin-env": "^0.15.27",
+    "@powerlines/plugin-nodejs": "^0.1.22"
   },
-  "devDependencies": { "@types/node": "^24.10.4", "typescript": "^5.9.3" },
+  "devDependencies": { "@types/node": "^22.19.3", "typescript": "^5.9.3" },
   "publishConfig": { "access": "public" },
-  "gitHead": "eb0dac424b96e6169aa9a39b4c72272d9243f9ac"
+  "gitHead": "5a8ce9d8f2cefeec8df5147bf80b5c3af71c6c16"
 }