@shell-shock/core 0.17.18 → 0.17.20

package/dist/components/usage.mjs

@@ -53,20 +53,17 @@ function Usage(props) {
 			"segment",
 			"",
 			"P\"2!\"/\""
-		])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " <commands>" : ""}${command.args.length > 0 ? command.args.map(__assignType((param) => `<${snakeCase(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
+		])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " <commands>" : ""}${command.args.length > 0 ? ` ${command.args.map(__assignType((param) => `<${snakeCase(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
 			"param",
 			"",
 			"P\"2!\"/\""
-		])).join(" ") : ""} [options]`),
+		])).join(" ")}` : ""} [options]`),
 		createComponent(Show, {
 			get when() {
 				return command.args.length > 0;
 			},
 			get children() {
 				return [
-					createIntrinsic("hbr", {}),
-					createIntrinsic("hbr", {}),
-					code`# or with options before arguments: `,
 					createIntrinsic("hbr", {}),
 					createComponent(Switch, { get children() {
 						return [

package/dist/helpers/automd.cjs

@@ -23,19 +23,35 @@ function __assignType(fn, args) {
 */
 const commands = __assignType((context) => (0, automd.defineGenerator)({
 	name: "commands",
-	async generate() {
+	async generate(ctx) {
+		let commands = Object.values(context.commands).filter(__assignType((cmd) => !cmd.virtual, [
+			"cmd",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (ctx.args.command) {
+			if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+			commands = [context.commands[ctx.args.command]];
+		}
 		return { contents: (0, _powerlines_plugin_alloy_render.renderString)(context, [
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
-				level: 2,
-				children: "Commands"
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+				get when() {
+					return !ctx.args.command;
+				},
+				get children() {
+					return [
+						(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+							level: 2,
+							children: "Commands"
+						}),
+						(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+						(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following commands are available in the ${require_context_helpers.getAppTitle(context, true)} command-line interface application:`),
+						(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
+					];
+				}
 			}),
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-			(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following commands are available in the ${require_context_helpers.getAppTitle(context, true)} command-line interface application:`),
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-				get each() {
-					return Object.values(context.commands);
-				},
+				each: commands,
 				doubleHardline: true,
 				get children() {
 					return __assignType((child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
@@ -64,7 +80,114 @@ const commands = __assignType((context) => (0, automd.defineGenerator)({
 	"",
 	"P\"w!2\"\"/#"
 ]);
+/**
+* AutoMD generator to generate usage examples for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated usage content.
+*/
+const usage = __assignType((context) => (0, automd.defineGenerator)({
+	name: "usage",
+	async generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'usage' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		let packageManagers = [
+			"npm",
+			"yarn",
+			"pnpm",
+			"bun"
+		];
+		if (ctx.args.packageManager) packageManagers = [String(ctx.args.packageManager)];
+		if (packageManagers.some(__assignType((pm) => ![
+			"npm",
+			"yarn",
+			"pnpm",
+			"bun"
+		].includes(pm), [
+			"pm",
+			"",
+			"P\"2!\"/\""
+		]))) throw new Error(`Invalid package manager specified. Supported package managers are: npm, yarn, pnpm, and bun.`);
+		return { contents: (0, _powerlines_plugin_alloy_render.renderString)(context, [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+			each: packageManagers,
+			doubleHardline: true,
+			get children() {
+				return __assignType((packageManager) => [(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocsUsageExample, {
+					packageManager,
+					get command() {
+						return context.commands[ctx.args.command];
+					},
+					get expand() {
+						return packageManagers && packageManagers.length > 1;
+					}
+				})], [
+					"packageManager",
+					"",
+					"P\"2!\"/\""
+				]);
+			}
+		})]) };
+	}
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
+/**
+* AutoMD generator to generate options for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated options content.
+*/
+const options = __assignType((context) => (0, automd.defineGenerator)({
+	name: "options",
+	generate: __assignType(async function generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'options' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		return { contents: (0, _powerlines_plugin_alloy_render.renderString)(context, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandOptionsDocs, { get command() {
+			return context.commands[ctx.args.command];
+		} })) };
+	}, [
+		"ctx",
+		"generate",
+		"P\"2!\"/\""
+	])
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
+/**
+* AutoMD generator to generate arguments for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated arguments content.
+*/
+const args = __assignType((context) => (0, automd.defineGenerator)({
+	name: "args",
+	generate: __assignType(async function generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'args' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		return { contents: (0, _powerlines_plugin_alloy_render.renderString)(context, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandArgumentDocs, { get command() {
+			return context.commands[ctx.args.command];
+		} })) };
+	}, [
+		"ctx",
+		"generate",
+		"P\"2!\"/\""
+	])
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
 
 //#endregion
+exports.args = args;
 exports.commands = commands;
+exports.options = options;
+exports.usage = usage;
 //# sourceMappingURL=automd.cjs.map

package/dist/helpers/automd.mjs

@@ -1,5 +1,5 @@
 import { getAppTitle } from "../plugin-utils/context-helpers.mjs";
-import { CommandDocs } from "../components/docs.mjs";
+import { CommandArgumentDocs, CommandDocs, CommandDocsUsageExample, CommandOptionsDocs } from "../components/docs.mjs";
 import "../plugin-utils/index.mjs";
 import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code } from "@alloy-js/core";
@@ -23,19 +23,35 @@ function __assignType(fn, args) {
 */
 const commands = __assignType((context) => defineGenerator({
 	name: "commands",
-	async generate() {
+	async generate(ctx) {
+		let commands = Object.values(context.commands).filter(__assignType((cmd) => !cmd.virtual, [
+			"cmd",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (ctx.args.command) {
+			if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+			commands = [context.commands[ctx.args.command]];
+		}
 		return { contents: renderString(context, [
-			createComponent(Heading, {
-				level: 2,
-				children: "Commands"
+			createComponent(Show, {
+				get when() {
+					return !ctx.args.command;
+				},
+				get children() {
+					return [
+						createComponent(Heading, {
+							level: 2,
+							children: "Commands"
+						}),
+						createComponent(Spacing, {}),
+						memo(() => code`The following commands are available in the ${getAppTitle(context, true)} command-line interface application:`),
+						createComponent(Spacing, {})
+					];
+				}
 			}),
-			createComponent(Spacing, {}),
-			memo(() => code`The following commands are available in the ${getAppTitle(context, true)} command-line interface application:`),
-			createComponent(Spacing, {}),
 			createComponent(For, {
-				get each() {
-					return Object.values(context.commands);
-				},
+				each: commands,
 				doubleHardline: true,
 				get children() {
 					return __assignType((child) => createComponent(Show, {
@@ -64,7 +80,111 @@ const commands = __assignType((context) => defineGenerator({
 	"",
 	"P\"w!2\"\"/#"
 ]);
+/**
+* AutoMD generator to generate usage examples for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated usage content.
+*/
+const usage = __assignType((context) => defineGenerator({
+	name: "usage",
+	async generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'usage' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		let packageManagers = [
+			"npm",
+			"yarn",
+			"pnpm",
+			"bun"
+		];
+		if (ctx.args.packageManager) packageManagers = [String(ctx.args.packageManager)];
+		if (packageManagers.some(__assignType((pm) => ![
+			"npm",
+			"yarn",
+			"pnpm",
+			"bun"
+		].includes(pm), [
+			"pm",
+			"",
+			"P\"2!\"/\""
+		]))) throw new Error(`Invalid package manager specified. Supported package managers are: npm, yarn, pnpm, and bun.`);
+		return { contents: renderString(context, [createComponent(For, {
+			each: packageManagers,
+			doubleHardline: true,
+			get children() {
+				return __assignType((packageManager) => [createComponent(CommandDocsUsageExample, {
+					packageManager,
+					get command() {
+						return context.commands[ctx.args.command];
+					},
+					get expand() {
+						return packageManagers && packageManagers.length > 1;
+					}
+				})], [
+					"packageManager",
+					"",
+					"P\"2!\"/\""
+				]);
+			}
+		})]) };
+	}
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
+/**
+* AutoMD generator to generate options for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated options content.
+*/
+const options = __assignType((context) => defineGenerator({
+	name: "options",
+	generate: __assignType(async function generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'options' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		return { contents: renderString(context, createComponent(CommandOptionsDocs, { get command() {
+			return context.commands[ctx.args.command];
+		} })) };
+	}, [
+		"ctx",
+		"generate",
+		"P\"2!\"/\""
+	])
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
+/**
+* AutoMD generator to generate arguments for a specific command.
+*
+* @param context - The generator context.
+* @returns The generated arguments content.
+*/
+const args = __assignType((context) => defineGenerator({
+	name: "args",
+	generate: __assignType(async function generate(ctx) {
+		if (!ctx.args.command) throw new Error("The 'args' generator requires the \"command\" argument.");
+		if (!context.commands[ctx.args.command]) throw new Error(`The command "${ctx.args.command}" does not exist in the application.`);
+		return { contents: renderString(context, createComponent(CommandArgumentDocs, { get command() {
+			return context.commands[ctx.args.command];
+		} })) };
+	}, [
+		"ctx",
+		"generate",
+		"P\"2!\"/\""
+	])
+}), [
+	"Context",
+	"context",
+	"",
+	"P\"w!2\"\"/#"
+]);
 
 //#endregion
-export { commands };
+export { args, commands, options, usage };
 //# sourceMappingURL=automd.mjs.map

package/dist/helpers/persistence.cjs

@@ -109,5 +109,6 @@ writeCommandsPersistence.__type = [
 ];
 
 //#endregion
+exports.readCommandsPersistence = readCommandsPersistence;
 exports.writeCommandsPersistence = writeCommandsPersistence;
 //# sourceMappingURL=persistence.cjs.map

package/dist/helpers/persistence.mjs

@@ -109,5 +109,5 @@ writeCommandsPersistence.__type = [
 ];
 
 //#endregion
-export { writeCommandsPersistence };
+export { readCommandsPersistence, writeCommandsPersistence };
 //# sourceMappingURL=persistence.mjs.map

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { AsCommandParameterConfig, BaseBooleanCommandParameter, BaseCommandParameter, BaseNumberCommandParameter, BaseSingleCommandParameter, BaseStringCommandParameter, BaseVariadicCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterType, CommandTree, NumberCommandParameter, NumberCommandParameterConfig, SerializedCommandTree, SingleBooleanCommandParameter, SingleNumberCommandParameter, SingleStringCommandParameter, StringCommandParameter, StringCommandParameterConfig, VariadicBooleanCommandParameter, VariadicNumberCommandParameter, VariadicStringCommandParameter } from "./types/command.cjs";
 import { Context, ExecutionContext, UnresolvedContext } from "./types/context.cjs";
 import { DocsOptions, EngineOptions, Options, OutputConfig, ResolvedConfig, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnObject, UserConfigFnPromise } from "./types/config.cjs";
-import { BaseCommandOptions } from "./types/options.cjs";
+import { ShellShockEnv } from "./types/env.cjs";
 import { defineConfig } from "./config.cjs";
 
 //#region src/index.d.ts
@@ -77,5 +77,5 @@ declare function defineOptions(options: Record<string, CommandOptionConfig>): Re
  */
 declare function defineArguments(args: CommandArgumentConfig[]): CommandArgumentConfig[];
 //#endregion
-export { type AsCommandParameterConfig, type BaseBooleanCommandParameter, type BaseCommandOptions, type BaseCommandParameter, type BaseNumberCommandParameter, type BaseSingleCommandParameter, type BaseStringCommandParameter, type BaseVariadicCommandParameter, type BooleanCommandOption, type BooleanCommandParameter, type BooleanCommandParameterConfig, type CommandArgument, type CommandArgumentConfig, type CommandBase, type CommandConfig, type CommandMetadata, type CommandModule, type CommandOption, type CommandOptionConfig, type CommandParameter, type CommandParameterConfig, type CommandParameterType, type CommandTree, type Context, type DocsOptions, type EngineOptions, type ExecutionContext, type NumberCommandParameter, type NumberCommandParameterConfig, type Options, type OutputConfig, type ResolvedConfig, type SerializedCommandTree, type SingleBooleanCommandParameter, type SingleNumberCommandParameter, type SingleStringCommandParameter, type StringCommandParameter, type StringCommandParameterConfig, type UnresolvedContext, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type VariadicBooleanCommandParameter, type VariadicNumberCommandParameter, type VariadicStringCommandParameter, defineArguments, defineConfig, defineMetadata, defineOptions };
+export { type AsCommandParameterConfig, type BaseBooleanCommandParameter, type BaseCommandParameter, type BaseNumberCommandParameter, type BaseSingleCommandParameter, type BaseStringCommandParameter, type BaseVariadicCommandParameter, type BooleanCommandOption, type BooleanCommandParameter, type BooleanCommandParameterConfig, type CommandArgument, type CommandArgumentConfig, type CommandBase, type CommandConfig, type CommandMetadata, type CommandModule, type CommandOption, type CommandOptionConfig, type CommandParameter, type CommandParameterConfig, type CommandParameterType, type CommandTree, type Context, type DocsOptions, type EngineOptions, type ExecutionContext, type NumberCommandParameter, type NumberCommandParameterConfig, type Options, type OutputConfig, type ResolvedConfig, type SerializedCommandTree, type ShellShockEnv, type SingleBooleanCommandParameter, type SingleNumberCommandParameter, type SingleStringCommandParameter, type StringCommandParameter, type StringCommandParameterConfig, type UnresolvedContext, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type VariadicBooleanCommandParameter, type VariadicNumberCommandParameter, type VariadicStringCommandParameter, defineArguments, defineConfig, defineMetadata, defineOptions };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { AsCommandParameterConfig, BaseBooleanCommandParameter, BaseCommandParameter, BaseNumberCommandParameter, BaseSingleCommandParameter, BaseStringCommandParameter, BaseVariadicCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterType, CommandTree, NumberCommandParameter, NumberCommandParameterConfig, SerializedCommandTree, SingleBooleanCommandParameter, SingleNumberCommandParameter, SingleStringCommandParameter, StringCommandParameter, StringCommandParameterConfig, VariadicBooleanCommandParameter, VariadicNumberCommandParameter, VariadicStringCommandParameter } from "./types/command.mjs";
 import { Context, ExecutionContext, UnresolvedContext } from "./types/context.mjs";
 import { DocsOptions, EngineOptions, Options, OutputConfig, ResolvedConfig, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnObject, UserConfigFnPromise } from "./types/config.mjs";
-import { BaseCommandOptions } from "./types/options.mjs";
+import { ShellShockEnv } from "./types/env.mjs";
 import { defineConfig } from "./config.mjs";
 
 //#region src/index.d.ts
@@ -77,5 +77,5 @@ declare function defineOptions(options: Record<string, CommandOptionConfig>): Re
  */
 declare function defineArguments(args: CommandArgumentConfig[]): CommandArgumentConfig[];
 //#endregion
-export { type AsCommandParameterConfig, type BaseBooleanCommandParameter, type BaseCommandOptions, type BaseCommandParameter, type BaseNumberCommandParameter, type BaseSingleCommandParameter, type BaseStringCommandParameter, type BaseVariadicCommandParameter, type BooleanCommandOption, type BooleanCommandParameter, type BooleanCommandParameterConfig, type CommandArgument, type CommandArgumentConfig, type CommandBase, type CommandConfig, type CommandMetadata, type CommandModule, type CommandOption, type CommandOptionConfig, type CommandParameter, type CommandParameterConfig, type CommandParameterType, type CommandTree, type Context, type DocsOptions, type EngineOptions, type ExecutionContext, type NumberCommandParameter, type NumberCommandParameterConfig, type Options, type OutputConfig, type ResolvedConfig, type SerializedCommandTree, type SingleBooleanCommandParameter, type SingleNumberCommandParameter, type SingleStringCommandParameter, type StringCommandParameter, type StringCommandParameterConfig, type UnresolvedContext, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type VariadicBooleanCommandParameter, type VariadicNumberCommandParameter, type VariadicStringCommandParameter, defineArguments, defineConfig, defineMetadata, defineOptions };
+export { type AsCommandParameterConfig, type BaseBooleanCommandParameter, type BaseCommandParameter, type BaseNumberCommandParameter, type BaseSingleCommandParameter, type BaseStringCommandParameter, type BaseVariadicCommandParameter, type BooleanCommandOption, type BooleanCommandParameter, type BooleanCommandParameterConfig, type CommandArgument, type CommandArgumentConfig, type CommandBase, type CommandConfig, type CommandMetadata, type CommandModule, type CommandOption, type CommandOptionConfig, type CommandParameter, type CommandParameterConfig, type CommandParameterType, type CommandTree, type Context, type DocsOptions, type EngineOptions, type ExecutionContext, type NumberCommandParameter, type NumberCommandParameterConfig, type Options, type OutputConfig, type ResolvedConfig, type SerializedCommandTree, type ShellShockEnv, type SingleBooleanCommandParameter, type SingleNumberCommandParameter, type SingleStringCommandParameter, type StringCommandParameter, type StringCommandParameterConfig, type UnresolvedContext, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type VariadicBooleanCommandParameter, type VariadicNumberCommandParameter, type VariadicStringCommandParameter, defineArguments, defineConfig, defineMetadata, defineOptions };
 //# sourceMappingURL=index.d.mts.map

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "0.17.17";
+var version = "0.17.19";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.17.17";
+var version = "0.17.19";
 
 //#endregion
 export { version };

package/dist/plugin.cjs

@@ -53,7 +53,7 @@ const MAX_DEPTH = 50;
 /**
 * The core Powerlines plugin to build Shell Shock projects.
 */
-const plugin = __assignType((options = {}) => {
+const plugin = __assignType((options$1 = {}) => {
 	return [
 		(_powerlines_plugin_tsdown.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_tsdown.default)()),
 		(_powerlines_plugin_automd.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_automd.default)()),
@@ -61,7 +61,7 @@ const plugin = __assignType((options = {}) => {
 			name: "shell-shock/core:config",
 			config: __assignType(async function config() {
 				this.debug("Resolving the Shell Shock configuration.");
-				return (0, defu.defu)(options, {
+				return (0, defu.defu)(options$1, {
 					name: require_context_helpers.getAppName(this),
 					title: require_context_helpers.getAppTitle(this),
 					description: require_context_helpers.getAppDescription(this),
@@ -111,8 +111,7 @@ const plugin = __assignType((options = {}) => {
 						description: this.config.description,
 						alias: [],
 						virtual: false
-					}));
-					this.globalOptions = this.globalOptions.map(__assignType((option) => ({
+					})).map(__assignType((option) => ({
 						...option,
 						name: (0, _stryke_string_format_camel_case.camelCase)(option.name),
 						alias: option.alias ?? [],
@@ -125,7 +124,7 @@ const plugin = __assignType((options = {}) => {
 				}
 			}
 		},
-		...(_powerlines_plugin_nodejs.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_nodejs.default)((0, defu.defu)(options ?? {}, { env: {
+		...(_powerlines_plugin_nodejs.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_nodejs.default)((0, defu.defu)(options$1 ?? {}, { env: {
 			config: "@shell-shock/core/types/env#ShellShockEnv",
 			validate: false
 		} }))),
@@ -324,27 +323,29 @@ const plugin = __assignType((options = {}) => {
 					}
 					if (!(0, _powerlines_schema.isJsonSchemaObject)(this.env.config.schema)) throw new Error("Invalid environment variable schema extracted.");
 					const env = (0, _powerlines_schema.getProperties)(this.env.config);
-					for (const option of Object.values(this.globalOptions).filter(__assignType((option) => Boolean(option.env), [
+					this.globalOptions.filter(__assignType((option) => (0, _stryke_type_checks_is_set_string.isSetString)(option.env) && !env[option.env], [
 						"option",
 						"",
 						"P\"2!\"/\""
-					])).filter(__assignType((option) => (0, _stryke_type_checks_is_set_string.isSetString)(option.env) && !env[option.env], [
+					])).forEach(__assignType((option) => {
+						(0, _powerlines_schema.addProperty)(this.env.config, option.env, {
+							...option,
+							name: option.env,
+							alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]))
+						});
+					}, [
 						"option",
 						"",
 						"P\"2!\"/\""
-					]))) (0, _powerlines_schema.addProperty)(this.env.config, option.env, {
-						...option,
-						name: option.env,
-						alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
-							"alias",
-							"",
-							"P\"2!\"/\""
-						])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
-							"alias",
-							"",
-							"P\"2!\"/\""
-						]))
-					});
+					]));
 					await (0, _powerlines_plugin_env_helpers_schema.writeEnv)(this);
 				}
 			}
@@ -359,6 +360,7 @@ const plugin = __assignType((options = {}) => {
 					if (this.config.command !== "prepare" && this.config.skipCache !== true && this.persistedMeta?.checksum === this.meta.checksum && this.fs.existsSync((0, _powerlines_schema.getCacheFilePath)(this, this.env.config))) {
 						this.debug(`Skipping command resolution as the meta checksum has not changed.`);
 						await (0, _powerlines_plugin_env_helpers_schema.extractEnv)(this);
+						await require_persistence.readCommandsPersistence(this);
 					} else {
 						for (const input of this.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment) && !require_context_helpers.isPathSegmentGroup(segment), [
 							"segment",
@@ -446,11 +448,14 @@ const plugin = __assignType((options = {}) => {
 				this.config.automd ??= {};
 				this.config.automd.generators = {
 					...this.config.automd.generators ?? {},
-					commands: require_automd.commands(this)
+					commands: require_automd.commands(this),
+					usage: require_automd.usage(this),
+					options: require_automd.options(this),
+					args: require_automd.args(this)
 				};
 			}, ["configResolved", "P\"/!"]),
 			async docs() {
-				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
+				this.debug("Rendering CLI command reference documentation and writing to the output directory.");
 				const commands = this.inputs.map(__assignType((input) => require_get_command_tree.getCommandTree(this, input.segments), [
 					"input",
 					"",

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAwFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAgGA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/plugin.mjs

@@ -5,10 +5,10 @@ import { traverseCommands } from "./plugin-utils/traverse-command-tree.mjs";
 import { getCommandTree } from "./plugin-utils/get-command-tree.mjs";
 import { StateBuiltin } from "./components/state-builtin.mjs";
 import { UtilsBuiltin } from "./components/utils-builtin.mjs";
-import { commands } from "./helpers/automd.mjs";
+import { args, commands, options, usage } from "./helpers/automd.mjs";
 import { getFramework } from "./helpers/get-framework.mjs";
 import { findCommandsRoot, resolveCommandId, resolveCommandName, resolveCommandPath } from "./helpers/paths.mjs";
-import { writeCommandsPersistence } from "./helpers/persistence.mjs";
+import { readCommandsPersistence, writeCommandsPersistence } from "./helpers/persistence.mjs";
 import { formatBinaryPath, updatePackageJsonBinary } from "./helpers/update-package-json.mjs";
 import { formatCommandTree, getGlobalOptions } from "./helpers/utilities.mjs";
 import { validateCommand } from "./helpers/validations.mjs";
@@ -48,7 +48,7 @@ const MAX_DEPTH = 50;
 /**
 * The core Powerlines plugin to build Shell Shock projects.
 */
-const plugin = __assignType((options = {}) => {
+const plugin = __assignType((options$1 = {}) => {
 	return [
 		(tsdown.Ω = [["Context", "\"w!"]], tsdown()),
 		(automd.Ω = [["Context", "\"w!"]], automd()),
@@ -56,7 +56,7 @@ const plugin = __assignType((options = {}) => {
 			name: "shell-shock/core:config",
 			config: __assignType(async function config() {
 				this.debug("Resolving the Shell Shock configuration.");
-				return defu(options, {
+				return defu(options$1, {
 					name: getAppName(this),
 					title: getAppTitle(this),
 					description: getAppDescription(this),
@@ -106,8 +106,7 @@ const plugin = __assignType((options = {}) => {
 						description: this.config.description,
 						alias: [],
 						virtual: false
-					}));
-					this.globalOptions = this.globalOptions.map(__assignType((option) => ({
+					})).map(__assignType((option) => ({
 						...option,
 						name: camelCase(option.name),
 						alias: option.alias ?? [],
@@ -120,7 +119,7 @@ const plugin = __assignType((options = {}) => {
 				}
 			}
 		},
-		...(nodejs.Ω = [["Context", "\"w!"]], nodejs(defu(options ?? {}, { env: {
+		...(nodejs.Ω = [["Context", "\"w!"]], nodejs(defu(options$1 ?? {}, { env: {
 			config: "@shell-shock/core/types/env#ShellShockEnv",
 			validate: false
 		} }))),
@@ -319,27 +318,29 @@ const plugin = __assignType((options = {}) => {
 					}
 					if (!isJsonSchemaObject(this.env.config.schema)) throw new Error("Invalid environment variable schema extracted.");
 					const env = getProperties(this.env.config);
-					for (const option of Object.values(this.globalOptions).filter(__assignType((option) => Boolean(option.env), [
+					this.globalOptions.filter(__assignType((option) => isSetString(option.env) && !env[option.env], [
 						"option",
 						"",
 						"P\"2!\"/\""
-					])).filter(__assignType((option) => isSetString(option.env) && !env[option.env], [
+					])).forEach(__assignType((option) => {
+						addProperty(this.env.config, option.env, {
+							...option,
+							name: option.env,
+							alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							])).map(__assignType((alias) => constantCase(alias), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]))
+						});
+					}, [
 						"option",
 						"",
 						"P\"2!\"/\""
-					]))) addProperty(this.env.config, option.env, {
-						...option,
-						name: option.env,
-						alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
-							"alias",
-							"",
-							"P\"2!\"/\""
-						])).map(__assignType((alias) => constantCase(alias), [
-							"alias",
-							"",
-							"P\"2!\"/\""
-						]))
-					});
+					]));
 					await writeEnv(this);
 				}
 			}
@@ -354,6 +355,7 @@ const plugin = __assignType((options = {}) => {
 					if (this.config.command !== "prepare" && this.config.skipCache !== true && this.persistedMeta?.checksum === this.meta.checksum && this.fs.existsSync(getCacheFilePath(this, this.env.config))) {
 						this.debug(`Skipping command resolution as the meta checksum has not changed.`);
 						await extractEnv(this);
+						await readCommandsPersistence(this);
 					} else {
 						for (const input of this.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment) && !isPathSegmentGroup(segment), [
 							"segment",
@@ -441,11 +443,14 @@ const plugin = __assignType((options = {}) => {
 				this.config.automd ??= {};
 				this.config.automd.generators = {
 					...this.config.automd.generators ?? {},
-					commands: commands(this)
+					commands: commands(this),
+					usage: usage(this),
+					options: options(this),
+					args: args(this)
 				};
 			}, ["configResolved", "P\"/!"]),
 			async docs() {
-				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
+				this.debug("Rendering CLI command reference documentation and writing to the output directory.");
 				const commands = this.inputs.map(__assignType((input) => getCommandTree(this, input.segments), [
 					"input",
 					"",