@shell-shock/core 0.17.21 → 0.17.23

package/dist/components/utils-builtin.mjs

@@ -1,45 +1,17 @@
+import { BuiltinFile, usePowerlines } from "../contexts/power-plant.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { Show, code, splitProps } from "@alloy-js/core";
-import defu$1 from "defu";
-import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
-import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { defu } from "defu";
+import { Spacing } from "@power-plant/alloy-js/core/components/spacing";
 import { FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, VarDeclaration } from "@alloy-js/typescript";
-import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
-import { TSDoc, TSDocInternal, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { TSDoc, TSDocInternal, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns } from "@power-plant/alloy-js/typescript/components/tsdoc";
 
 //#region src/components/utils-builtin.tsx
-const __ΩOmit = [
-	"T",
-	"K",
-	() => __ΩPick,
-	() => __ΩExclude,
-	"Omit",
-	"b!b\"e!!e!!ge!\"o$#o##w%y"
-];
-const __ΩPick = [
-	"T",
-	"K",
-	"Pick",
-	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
-];
-const __ΩExclude = [
-	"T",
-	"U",
-	"Exclude",
-	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
-];
-const __ΩUtilsBuiltinProps = [
-	() => __ΩOmit,
-	"id",
-	"description",
-	"UtilsBuiltinProps",
-	"P!P.\".#Jo!#Mw$y"
-];
 /**
 * Generates the `findSuggestions` function for suggesting corrections for potentially misspelled options or commands.
 */
 function FindSuggestionsDeclaration() {
-	const context = (usePowerlines.Ω = [["Context", "\"w!"]], usePowerlines());
+	const context = usePowerlines();
 	return [
 		createComponent(VarDeclaration, {
 			"const": true,
@@ -233,11 +205,6 @@ function FindSuggestionsDeclaration() {
 		})
 	];
 }
-FindSuggestionsDeclaration.__type = [
-	"FindSuggestionsDeclaration",
-	"Generates the `findSuggestions` function for suggesting corrections for potentially misspelled options or commands.",
-	"P\"/!?\""
-];
 /**
 * Generates utilities for detecting terminal size and whether the process is running in the foreground, which can be used to determine how to render output (e.g., whether to use a progress bar or spinner).
 */
@@ -381,11 +348,6 @@ function TerminalSizeDeclaration() {
 		})
 	];
 }
-TerminalSizeDeclaration.__type = [
-	"TerminalSizeDeclaration",
-	"Generates utilities for detecting terminal size and whether the process is running in the foreground, which can be used to determine how to render output (e.g., whether to use a progress bar or spinner).",
-	"P\"/!?\""
-];
 /**
 * Generates utilities for detecting terminal color support.
 */
@@ -416,11 +378,6 @@ function EnvSupportUtilities() {
 		})
 	];
 }
-EnvSupportUtilities.__type = [
-	"EnvSupportUtilities",
-	"Generates utilities for detecting terminal color support.",
-	"P\"/!?\""
-];
 /**
 * Generates utilities for detecting terminal color support.
 */
@@ -618,11 +575,6 @@ function ColorSupportUtilities() {
 		})
 	];
 }
-ColorSupportUtilities.__type = [
-	"ColorSupportUtilities",
-	"Generates utilities for detecting terminal color support.",
-	"P\"/!?\""
-];
 /**
 * Generates utilities for detecting terminal color support.
 */
@@ -731,16 +683,11 @@ function HyperlinkSupportUtilities() {
 		})
 	];
 }
-HyperlinkSupportUtilities.__type = [
-	"HyperlinkSupportUtilities",
-	"Generates utilities for detecting terminal color support.",
-	"P\"/!?\""
-];
 /**
 * Generates the `resolveModule` function declaration, which is a utility for resolving file paths across different platforms.
 */
 function ResolveModuleFunctionDeclaration() {
-	const context = (usePowerlines.Ω = [["Context", "\"w!"]], usePowerlines());
+	const context = usePowerlines();
 	return [
 		createComponent(Spacing, {}),
 		createComponent(InterfaceDeclaration, {
@@ -1730,11 +1677,6 @@ function ResolveModuleFunctionDeclaration() {
 		})
 	];
 }
-ResolveModuleFunctionDeclaration.__type = [
-	"ResolveModuleFunctionDeclaration",
-	"Generates the `resolveModule` function declaration, which is a utility for resolving file paths across different platforms.",
-	"P\"/!?\""
-];
 /**
 * A built-in utilities module for Shell Shock.
 */
@@ -1745,7 +1687,7 @@ function UtilsBuiltin(props) {
 		description: "A collection of helper utilities that ease command-line application development."
 	}, rest, {
 		get imports() {
-			return defu$1(rest.imports ?? {}, {
+			return defu(rest.imports ?? {}, {
 				"node:os": "os",
 				"node:process": "process",
 				"node:path": [
@@ -1771,7 +1713,7 @@ function UtilsBuiltin(props) {
 			});
 		},
 		get builtinImports() {
-			return defu$1(rest.builtinImports ?? {}, {
+			return defu(rest.builtinImports ?? {}, {
 				env: [
 					"env",
 					"isCI",
@@ -1828,14 +1770,7 @@ function UtilsBuiltin(props) {
 		}
 	}));
 }
-UtilsBuiltin.__type = [
-	() => __ΩUtilsBuiltinProps,
-	"props",
-	"UtilsBuiltin",
-	"A built-in utilities module for Shell Shock.",
-	"Pn!2\"\"/#?$"
-];
 
 //#endregion
-export { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, TerminalSizeDeclaration, UtilsBuiltin, __ΩUtilsBuiltinProps };
+export { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, TerminalSizeDeclaration, UtilsBuiltin };
 //# sourceMappingURL=utils-builtin.mjs.map

package/dist/config-BIF9mEz0.d.cts

@@ -0,0 +1,157 @@
+import { S as CommandTree, _ as CommandOption, m as CommandConfig, p as CommandBase } from "./command-CtfR7hKM.cjs";
+import { RequiredKeys } from "@stryke/types/base";
+import { ConfigParams, ExecutionContext, OutputConfig, PluginContext, UnresolvedContext, UserConfig } from "powerlines";
+import { AlloyPluginResolvedConfig } from "@powerlines/plugin-alloy/types/plugin";
+import { AutoMDPluginResolvedConfig } from "@powerlines/plugin-automd";
+import { NodeJsPluginOptions, NodeJsPluginResolvedConfig } from "@powerlines/plugin-nodejs/types/plugin";
+import { TsdownPluginResolvedConfig } from "@powerlines/plugin-tsdown/types/plugin";
+import { PackageJson } from "@stryke/types/package-json";
+import { EngineOptions } from "powerlines/engine";
+import { AlloyPluginContext } from "@powerlines/plugin-alloy";
+import { NodeJsPluginContext } from "@powerlines/plugin-nodejs/types";
+import { TsdownPluginContext } from "@powerlines/plugin-tsdown";
+//#region src/types/context.d.ts
+/**
+ * Options passed to Shell Shock Power Plant generators.
+ */
+interface CommandGeneratorOptions {
+  context: PluginContext;
+  template?: unknown;
+}
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & AlloyPluginContext<TResolvedConfig> & NodeJsPluginContext<TResolvedConfig> & {
+  /**
+   * The root path where commands are located.
+   */
+  commandsPath: string;
+  /**
+   * The default command arguments to apply to all application commands.
+   */
+  globalOptions: CommandOption[];
+  /**
+   * The list of commands discovered in the project.
+   */
+  inputs: CommandConfig[];
+  /**
+   * The command-line application structure.
+   */
+  commands: Record<string, CommandTree>;
+};
+type ExecutionContext$1<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = ExecutionContext<TResolvedConfig>;
+type UnresolvedContext$1<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = UnresolvedContext<TResolvedConfig>;
+//#endregion
+//#region src/types/config.d.ts
+type BuildOptions = Pick<UserConfig, "name" | "title" | "description" | "input" | "output" | "logLevel" | "mode" | "define" | "inject" | "resolve" | "organization" | "skipCache" | "autoInstall" | "plugins" | "tsconfig" | "tsconfigRaw">;
+interface DocsOptions {
+  /**
+   * A URL to the application documentation or reference.
+   */
+  app: string;
+  /**
+   * A URL to the application command specific documentation or reference.
+   *
+   * @remarks
+   * This URL is expected to contain the token `{command}` or `{cmd}`, which will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{docs}/command/subcommand`.
+   */
+  commands?: string;
+}
+interface BaseOptions {
+  /**
+   * A set of global command options to apply to each command.
+   *
+   * @remarks
+   * Each command will inherit these global options. To disable the addition of these global options, set this property to `false`, or provide a custom set of options/a function that returns them. A `GlobalOptions` interface will be created by the `shell-shock types` command and added to the generated `shell-shock.d.ts` file.
+   */
+  globalOptions?: CommandOption[] | ((context: Context<any>, input: CommandBase) => CommandOption[]) | false;
+  /**
+   * Determines whether commands and option names are treated as case-sensitive.
+   *
+   * @defaultValue `false`
+   */
+  isCaseSensitive?: boolean;
+  /**
+   * 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?: string | string[];
+  /**
+   * Should Shell Shock attempt to automatically assign environment variables to manipulate default values for command options based on the option name?
+   *
+   * @remarks
+   * If set to a string, Shell Shock will use the provided string as an application specific environment variable prefix, convert the option name to {@link https://stringcase.org/cases/constant/ | constant case}, and prepend the provided `string` value to determine the corresponding environment variable name. For example, if an option is named `"configPath"` and the `autoAssignEnv` is `"MY_APP"`, Shell Shock will look for an environment variable named `"MY_APP_CONFIG_PATH"` and assign its value to the option if it exists. If set to `true`, Shell Shock will use a default environment variable prefix derived from the {@link Options.name | application name}.
+   *
+   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa
+   * @see https://stringcase.org/cases/constant/
+   */
+  autoAssignEnv?: true | string;
+  /**
+   * A URL to the command-line interface application's reference documentation.
+   *
+   * @remarks
+   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` (or `{cmd}`) is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{docs}/command/subcommand`.
+   */
+  docs?: DocsOptions | string;
+}
+/**
+ * The plugin options for Shell Shock.
+ */
+type Options = BaseOptions & Partial<NodeJsPluginOptions>;
+/**
+ * The output configuration options for Shell Shock.
+ */
+type OutputConfig$1 = Pick<OutputConfig, "path" | "copy" | "storage" | "sourceMap"> & {
+  /**
+   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.
+   */
+  dts?: false;
+};
+/**
+ * The user configuration options for Shell Shock.
+ */
+type UserConfig$1 = BaseOptions & RequiredKeys<BuildOptions, "name"> & {
+  /**
+   * Configuration for the output of the build process
+   */
+  output?: OutputConfig$1;
+};
+type UserConfigFnObject = (env: ConfigParams) => UserConfig$1 | UserConfig$1[];
+type UserConfigFnPromise = (env: ConfigParams) => Promise<UserConfig$1 | UserConfig$1[]>;
+type UserConfigFn = (env: ConfigParams) => UserConfig$1 | UserConfig$1[] | Promise<UserConfig$1 | UserConfig$1[]>;
+type UserConfigExport = UserConfig$1 | UserConfig$1[] | Promise<UserConfig$1 | UserConfig$1[]> | UserConfigFnObject | UserConfigFnPromise | UserConfigFn;
+type EngineOptions$1 = Omit<EngineOptions, "root" | "name" | "framework">;
+/**
+ * The resolved configuration options for Shell Shock.
+ */
+type ResolvedConfig = TsdownPluginResolvedConfig & AlloyPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "docs">> & {
+  /**
+   * 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: PackageJson["bin"];
+  /**
+   * The URL(s) to the command-line interface application's reference documentation.
+   */
+  docs: DocsOptions;
+  /**
+   * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.
+   */
+  appSpecificEnvPrefix: string;
+  /**
+   * The user configuration for the Shell Shock process.
+   */
+  userConfig: UserConfig$1;
+};
+//#endregion
+export { ResolvedConfig as a, UserConfigFn as c, CommandGeneratorOptions as d, Context as f, OutputConfig$1 as i, UserConfigFnObject as l, UnresolvedContext$1 as m, EngineOptions$1 as n, UserConfig$1 as o, ExecutionContext$1 as p, Options as r, UserConfigExport as s, DocsOptions as t, UserConfigFnPromise as u };
+//# sourceMappingURL=config-BIF9mEz0.d.cts.map

package/dist/config-BIF9mEz0.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-BIF9mEz0.d.cts","names":[],"sources":["../src/types/context.ts","../src/types/config.ts"],"mappings":";;;;;;;;;;;;;;;;UAgCiB;EACf,SAAS;EACT;;KAGU,QAAQ,wBAAwB,iBAAiB,kBAC3D,oBAAoB,mBAClB,mBAAmB,mBACnB,oBAAoB;;;;EAIlB;;;;EAKA,eAAe;;;;EAKf,QAAQ;;;;EAKR,UAAU,eAAe;;KAGnB,mBACV,wBAAwB,iBAAiB,kBACvC,iBAA2B;KAEnB,oBACV,wBAAwB,iBAAiB,kBACvC,kBAA4B;;;KChC3B,eAAe,KAClB;UAmBe;;;;EAIf;;;;;;;EAQA;;UAGQ;;;;;;;EAOR,gBACI,oBACE,SAAS,cAAc,OAAO,gBAAgB;;;;;;EAQpD;;;;;;;;;;;EAYA;;;;;;;;;;EAWA;;;;;;;EAQA,OAAO;;;;;KAMG,UAAU,cAAc,QAAQ;;;;KAKhC,iBAAe,KACzB;;;;EAMA;;;;;KAMU,eAAa,cACvB,aAAa;;;;EAIX,SAAS;;KAGD,sBACV,KAAK,iBACF,eAAa;KACN,uBACV,KAAK,iBACF,QAAQ,eAAa;KACd,gBACV,KAAK,iBACF,eAAa,iBAAe,QAAQ,eAAa;KAE1C,mBACR,eACA,iBACA,QAAQ,eAAa,kBACrB,qBACA,sBACA;KAEQ,kBAAgB,KAC1B;;;;KAOU,iBAAiB,6BAC3B,4BACA,6BACA,6BACA,SAAS,KAAK;;;;;;;;;;;EAWZ,KAAK;;;;EAKL,MAAM;;;;EAKN;;;;EAKA,YAAY"}

package/dist/config-CnNYdfsL.d.mts

@@ -0,0 +1,157 @@
+import { S as CommandTree, _ as CommandOption, m as CommandConfig, p as CommandBase } from "./command-B6KYexlV.mjs";
+import { AutoMDPluginResolvedConfig } from "@powerlines/plugin-automd";
+import { TsdownPluginContext } from "@powerlines/plugin-tsdown";
+import { ConfigParams, ExecutionContext, OutputConfig, PluginContext, UnresolvedContext, UserConfig } from "powerlines";
+import { RequiredKeys } from "@stryke/types/base";
+import { AlloyPluginResolvedConfig } from "@powerlines/plugin-alloy/types/plugin";
+import { NodeJsPluginOptions, NodeJsPluginResolvedConfig } from "@powerlines/plugin-nodejs/types/plugin";
+import { TsdownPluginResolvedConfig } from "@powerlines/plugin-tsdown/types/plugin";
+import { PackageJson } from "@stryke/types/package-json";
+import { EngineOptions } from "powerlines/engine";
+import { AlloyPluginContext } from "@powerlines/plugin-alloy";
+import { NodeJsPluginContext } from "@powerlines/plugin-nodejs/types";
+//#region src/types/context.d.ts
+/**
+ * Options passed to Shell Shock Power Plant generators.
+ */
+interface CommandGeneratorOptions {
+  context: PluginContext;
+  template?: unknown;
+}
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & AlloyPluginContext<TResolvedConfig> & NodeJsPluginContext<TResolvedConfig> & {
+  /**
+   * The root path where commands are located.
+   */
+  commandsPath: string;
+  /**
+   * The default command arguments to apply to all application commands.
+   */
+  globalOptions: CommandOption[];
+  /**
+   * The list of commands discovered in the project.
+   */
+  inputs: CommandConfig[];
+  /**
+   * The command-line application structure.
+   */
+  commands: Record<string, CommandTree>;
+};
+type ExecutionContext$1<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = ExecutionContext<TResolvedConfig>;
+type UnresolvedContext$1<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = UnresolvedContext<TResolvedConfig>;
+//#endregion
+//#region src/types/config.d.ts
+type BuildOptions = Pick<UserConfig, "name" | "title" | "description" | "input" | "output" | "logLevel" | "mode" | "define" | "inject" | "resolve" | "organization" | "skipCache" | "autoInstall" | "plugins" | "tsconfig" | "tsconfigRaw">;
+interface DocsOptions {
+  /**
+   * A URL to the application documentation or reference.
+   */
+  app: string;
+  /**
+   * A URL to the application command specific documentation or reference.
+   *
+   * @remarks
+   * This URL is expected to contain the token `{command}` or `{cmd}`, which will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{docs}/command/subcommand`.
+   */
+  commands?: string;
+}
+interface BaseOptions {
+  /**
+   * A set of global command options to apply to each command.
+   *
+   * @remarks
+   * Each command will inherit these global options. To disable the addition of these global options, set this property to `false`, or provide a custom set of options/a function that returns them. A `GlobalOptions` interface will be created by the `shell-shock types` command and added to the generated `shell-shock.d.ts` file.
+   */
+  globalOptions?: CommandOption[] | ((context: Context<any>, input: CommandBase) => CommandOption[]) | false;
+  /**
+   * Determines whether commands and option names are treated as case-sensitive.
+   *
+   * @defaultValue `false`
+   */
+  isCaseSensitive?: boolean;
+  /**
+   * 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?: string | string[];
+  /**
+   * Should Shell Shock attempt to automatically assign environment variables to manipulate default values for command options based on the option name?
+   *
+   * @remarks
+   * If set to a string, Shell Shock will use the provided string as an application specific environment variable prefix, convert the option name to {@link https://stringcase.org/cases/constant/ | constant case}, and prepend the provided `string` value to determine the corresponding environment variable name. For example, if an option is named `"configPath"` and the `autoAssignEnv` is `"MY_APP"`, Shell Shock will look for an environment variable named `"MY_APP_CONFIG_PATH"` and assign its value to the option if it exists. If set to `true`, Shell Shock will use a default environment variable prefix derived from the {@link Options.name | application name}.
+   *
+   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa
+   * @see https://stringcase.org/cases/constant/
+   */
+  autoAssignEnv?: true | string;
+  /**
+   * A URL to the command-line interface application's reference documentation.
+   *
+   * @remarks
+   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` (or `{cmd}`) is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{docs}/command/subcommand`.
+   */
+  docs?: DocsOptions | string;
+}
+/**
+ * The plugin options for Shell Shock.
+ */
+type Options = BaseOptions & Partial<NodeJsPluginOptions>;
+/**
+ * The output configuration options for Shell Shock.
+ */
+type OutputConfig$1 = Pick<OutputConfig, "path" | "copy" | "storage" | "sourceMap"> & {
+  /**
+   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.
+   */
+  dts?: false;
+};
+/**
+ * The user configuration options for Shell Shock.
+ */
+type UserConfig$1 = BaseOptions & RequiredKeys<BuildOptions, "name"> & {
+  /**
+   * Configuration for the output of the build process
+   */
+  output?: OutputConfig$1;
+};
+type UserConfigFnObject = (env: ConfigParams) => UserConfig$1 | UserConfig$1[];
+type UserConfigFnPromise = (env: ConfigParams) => Promise<UserConfig$1 | UserConfig$1[]>;
+type UserConfigFn = (env: ConfigParams) => UserConfig$1 | UserConfig$1[] | Promise<UserConfig$1 | UserConfig$1[]>;
+type UserConfigExport = UserConfig$1 | UserConfig$1[] | Promise<UserConfig$1 | UserConfig$1[]> | UserConfigFnObject | UserConfigFnPromise | UserConfigFn;
+type EngineOptions$1 = Omit<EngineOptions, "root" | "name" | "framework">;
+/**
+ * The resolved configuration options for Shell Shock.
+ */
+type ResolvedConfig = TsdownPluginResolvedConfig & AlloyPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "docs">> & {
+  /**
+   * 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: PackageJson["bin"];
+  /**
+   * The URL(s) to the command-line interface application's reference documentation.
+   */
+  docs: DocsOptions;
+  /**
+   * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.
+   */
+  appSpecificEnvPrefix: string;
+  /**
+   * The user configuration for the Shell Shock process.
+   */
+  userConfig: UserConfig$1;
+};
+//#endregion
+export { ResolvedConfig as a, UserConfigFn as c, CommandGeneratorOptions as d, Context as f, OutputConfig$1 as i, UserConfigFnObject as l, UnresolvedContext$1 as m, EngineOptions$1 as n, UserConfig$1 as o, ExecutionContext$1 as p, Options as r, UserConfigExport as s, DocsOptions as t, UserConfigFnPromise as u };
+//# sourceMappingURL=config-CnNYdfsL.d.mts.map

package/dist/config-CnNYdfsL.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-CnNYdfsL.d.mts","names":[],"sources":["../src/types/context.ts","../src/types/config.ts"],"mappings":""}

package/dist/config.cjs

@@ -1,65 +1,31 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
 //#region src/config.ts
-defineConfig.__type = [
-	"UserConfig",
-	"config",
-	"defineConfig",
-	"Type helper to make it easier to use `shell-shock.config.ts` files. Accepts a direct {@link UserConfig} object, or a function that returns it. The function receives a {@link ConfigParams} object.",
-	"P\"w!2\"\"w!/#?$"
-];
-defineConfig.__type = [
-	"UserConfig",
-	"config",
-	"defineConfig",
-	"P\"w!F2\"\"w!F/#"
-];
-defineConfig.__type = [
-	"UserConfig",
-	"config",
-	"defineConfig",
-	"P\"w!`2\"\"w!`/#"
-];
-defineConfig.__type = [
-	"UserConfig",
-	"config",
-	"defineConfig",
-	"P\"w!F`2\"\"w!F`/#"
-];
-defineConfig.__type = [
-	"UserConfigFnObject",
-	"config",
-	"defineConfig",
-	"P\"w!2\"\"w!/#"
-];
-defineConfig.__type = [
-	"UserConfigFnPromise",
-	"config",
-	"defineConfig",
-	"P\"w!2\"\"w!/#"
-];
-defineConfig.__type = [
-	"UserConfigFn",
-	"config",
-	"defineConfig",
-	"P\"w!2\"\"w!/#"
-];
-defineConfig.__type = [
-	"UserConfigExport",
-	"config",
-	"defineConfig",
-	"P\"w!2\"\"w!/#"
-];
+/**
+* Type helper to make it easier to use `shell-shock.config.ts` files. Accepts a direct {@link UserConfig} object, or a function that returns it. The function receives a {@link ConfigParams} object.
+*
+* @example
+* ```ts
+* import { defineConfig } from '@shell-shock/core/config';
+*
+* export default defineConfig({
+*   // Your configuration here
+* });
+*
+* // Or with a function
+* export default defineConfig((env) => {
+*   console.log(`Running command: ${env.command} in mode: ${env.mode}`);
+*   return {
+*     // Your configuration here
+*   };
+* });
+* ```
+*
+* @param config - The user configuration object or a function that returns it.
+* @returns The provided configuration, unmodified.
+*/
 function defineConfig(config) {
 	return config;
 }
-defineConfig.__type = [
-	"UserConfigExport",
-	"config",
-	"defineConfig",
-	"P\"w!2\"\"w!/#"
-];
 
 //#endregion
-exports.defineConfig = defineConfig;
-//# sourceMappingURL=config.cjs.map
+exports.defineConfig = defineConfig;

package/dist/config.d.cts

@@ -1,5 +1,4 @@
-import { DocsOptions, EngineOptions, Options, OutputConfig, ResolvedConfig, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnObject, UserConfigFnPromise } from "./types/config.cjs";
-
+import { a as ResolvedConfig, c as UserConfigFn, i as OutputConfig, l as UserConfigFnObject, n as EngineOptions, o as UserConfig, r as Options, s as UserConfigExport, t as DocsOptions, u as UserConfigFnPromise } from "./config-BIF9mEz0.cjs";
 //#region src/config.d.ts
 /**
  * Type helper to make it easier to use `shell-shock.config.ts` files. Accepts a direct {@link UserConfig} object, or a function that returns it. The function receives a {@link ConfigParams} object.

package/dist/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":";;;;AAmDA;;;;;;;;AAA4D;AAC5D;;;;;;;;AAA8D;AAC9D;;;;iBAFgB,YAAA,CAAa,MAAA,EAAQ,UAAA,GAAa,UAAU;AAAA,iBAC5C,YAAA,CAAa,MAAA,EAAQ,UAAA,KAAe,UAAU;AAAA,iBAC9C,YAAA,CAAa,MAAA,EAAQ,OAAA,CAAQ,UAAA,IAAc,OAAA,CAAQ,UAAA;AAAA,iBACnD,YAAA,CACd,MAAA,EAAQ,OAAA,CAAQ,UAAA,MACf,OAAA,CAAQ,UAAA;AAAA,iBACK,YAAA,CAAa,MAAA,EAAQ,kBAAA,GAAqB,kBAAkB;AAAA,iBAC5D,YAAA,CAAa,MAAA,EAAQ,mBAAA,GAAsB,mBAAmB;AAAA,iBAC9D,YAAA,CAAa,MAAA,EAAQ,YAAA,GAAe,YAAY;AAAA,iBAChD,YAAA,CAAa,MAAA,EAAQ,gBAAA,GAAmB,gBAAgB"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;iBAmDgB,aAAa,QAAQ,aAAa;iBAClC,aAAa,QAAQ,eAAe;iBACpC,aAAa,QAAQ,QAAQ,cAAc,QAAQ;iBACnD,aACd,QAAQ,QAAQ,gBACf,QAAQ;iBACK,aAAa,QAAQ,qBAAqB;iBAC1C,aAAa,QAAQ,sBAAsB;iBAC3C,aAAa,QAAQ,eAAe;iBACpC,aAAa,QAAQ,mBAAmB"}

package/dist/config.d.mts

@@ -1,5 +1,4 @@
-import { DocsOptions, EngineOptions, Options, OutputConfig, ResolvedConfig, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnObject, UserConfigFnPromise } from "./types/config.mjs";
-
+import { a as ResolvedConfig, c as UserConfigFn, i as OutputConfig, l as UserConfigFnObject, n as EngineOptions, o as UserConfig, r as Options, s as UserConfigExport, t as DocsOptions, u as UserConfigFnPromise } from "./config-CnNYdfsL.mjs";
 //#region src/config.d.ts
 /**
  * Type helper to make it easier to use `shell-shock.config.ts` files. Accepts a direct {@link UserConfig} object, or a function that returns it. The function receives a {@link ConfigParams} object.