@shell-shock/core 0.17.17 → 0.17.19

package/dist/components/index.mjs

@@ -1,5 +1,5 @@
 import { Usage, __ΩUsageProps } from "./usage.mjs";
-import { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandOptionsDocsProps } from "./docs.mjs";
+import { CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandParametersDocsProps } from "./docs.mjs";
 import { ExecBuiltin, __ΩExecBuiltinProps } from "./exec-builtin.mjs";
 import { BooleanInputParserLogic, CommandParameterType, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, __ΩBooleanInputParserLogicProps } from "./helpers.mjs";
 import { ArgumentsParserLogic, CommandParserLogic, DynamicSegmentsParserLogic, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, __ΩArgumentsParserLogicProps, __ΩCommandParserLogicProps, __ΩDynamicSegmentsParserLogicProps, __ΩOptionsMemberParserConditionProps, __ΩOptionsMemberParserLogicProps, __ΩOptionsParserLogicProps } from "./options-parser-logic.mjs";
@@ -7,4 +7,4 @@ import { ArgsUtilities, ContextUtilities, GlobalTypeDefinitions, StateBuiltin, _
 import { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, TerminalSizeDeclaration, UtilsBuiltin, __ΩUtilsBuiltinProps } from "./utils-builtin.mjs";
 import { CommandValidationLogic, __ΩCommandValidationLogicProps } from "./command-validation-logic.mjs";
 
-export { ArgsUtilities, ArgumentsParserLogic, BooleanInputParserLogic, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, CommandParameterType, CommandParserLogic, CommandValidationLogic, ContextUtilities, DynamicSegmentsParserLogic, EnvSupportUtilities, ExecBuiltin, FindSuggestionsDeclaration, GlobalTypeDefinitions, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, ResolveModuleFunctionDeclaration, StateBuiltin, TerminalSizeDeclaration, Usage, UtilsBuiltin, __ΩArgumentsParserLogicProps, __ΩBooleanInputParserLogicProps, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandOptionsDocsProps, __ΩCommandParserLogicProps, __ΩCommandValidationLogicProps, __ΩDynamicSegmentsParserLogicProps, __ΩExecBuiltinProps, __ΩOptionsMemberParserConditionProps, __ΩOptionsMemberParserLogicProps, __ΩOptionsParserLogicProps, __ΩStateBuiltinProps, __ΩUsageProps, __ΩUtilsBuiltinProps };
+export { ArgsUtilities, ArgumentsParserLogic, BooleanInputParserLogic, ColorSupportUtilities, CommandArgumentDocs, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, CommandParameterType, CommandParserLogic, CommandValidationLogic, ContextUtilities, DynamicSegmentsParserLogic, EnvSupportUtilities, ExecBuiltin, FindSuggestionsDeclaration, GlobalTypeDefinitions, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, ResolveModuleFunctionDeclaration, StateBuiltin, TerminalSizeDeclaration, Usage, UtilsBuiltin, __ΩArgumentsParserLogicProps, __ΩBooleanInputParserLogicProps, __ΩCommandDocsFileProps, __ΩCommandDocsProps, __ΩCommandDocsUsageExampleProps, __ΩCommandParametersDocsProps, __ΩCommandParserLogicProps, __ΩCommandValidationLogicProps, __ΩDynamicSegmentsParserLogicProps, __ΩExecBuiltinProps, __ΩOptionsMemberParserConditionProps, __ΩOptionsMemberParserLogicProps, __ΩOptionsParserLogicProps, __ΩStateBuiltinProps, __ΩUsageProps, __ΩUtilsBuiltinProps };

package/dist/components/usage.cjs

@@ -54,7 +54,7 @@ function Usage(props) {
 			"segment",
 			"",
 			"P\"2!\"/\""
-		])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " [commands]" : ""}${command.args.length > 0 ? ` ${command.args.map(__assignType((param) => `<${(0, _stryke_string_format_snake_case.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) => `<${(0, _stryke_string_format_snake_case.snakeCase)(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
 			"param",
 			"",
 			"P\"2!\"/\""
@@ -66,7 +66,6 @@ function Usage(props) {
 			get children() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					_alloy_js_core.code`$ `,
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Switch, { get children() {
 						return [
 							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Match, {
@@ -91,11 +90,11 @@ function Usage(props) {
 						"segment",
 						"",
 						"P\"2!\"/\""
-					])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options] ${command.args.length > 0 ? ` ${command.args.map(__assignType((param) => `<${(0, _stryke_string_format_snake_case.snakeCase)(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
+					])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " <commands>" : ""} [options] ${command.args.length > 0 ? command.args.map(__assignType((param) => `<${(0, _stryke_string_format_snake_case.snakeCase)(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
 						"param",
 						"",
 						"P\"2!\"/\""
-					])).join(" ")}` : ""}`)
+					])).join(" ") : ""}`)
 				];
 			}
 		})

package/dist/components/usage.mjs

@@ -53,7 +53,7 @@ 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!\"/\""
@@ -65,7 +65,6 @@ function Usage(props) {
 			get children() {
 				return [
 					createIntrinsic("hbr", {}),
-					code`$ `,
 					createComponent(Switch, { get children() {
 						return [
 							createComponent(Match, {
@@ -90,11 +89,11 @@ function Usage(props) {
 						"segment",
 						"",
 						"P\"2!\"/\""
-					])).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options] ${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>" : ""} [options] ${command.args.length > 0 ? command.args.map(__assignType((param) => `<${snakeCase(param.name)}${(param.type === "string" || param.type === "number") && param.variadic ? "..." : ""}>`, [
 						"param",
 						"",
 						"P\"2!\"/\""
-					])).join(" ")}` : ""}`)
+					])).join(" ") : ""}`)
 				];
 			}
 		})

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/package.cjs

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

package/dist/package.mjs

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

package/dist/plugin-utils/reflect.cjs

@@ -8,11 +8,12 @@ function __assignType(fn, args) {
 * Sort command options alphabetically by name, placing boolean options with negatives appropriately.
 *
 * @param options - The array of command options to sort.
+* @param skipNegatives - Whether to skip negative options when sorting (default: true).
 * @returns A new array of sorted command options.
 */
-function sortOptions(options) {
+function sortOptions(options, skipNegatives = true) {
 	if (!options || options.length === 0) return [];
-	return options.filter(__assignType((arg) => arg.type !== "boolean" || arg.variadic || !arg.isNegativeOf, [
+	return options.filter(__assignType((arg) => arg.type !== "boolean" || arg.variadic || !skipNegatives || !arg.isNegativeOf, [
 		"arg",
 		"",
 		"P\"2!\"/\""
@@ -42,9 +43,10 @@ function sortOptions(options) {
 sortOptions.__type = [
 	"CommandOption",
 	"options",
+	"skipNegatives",
 	"sortOptions",
 	"Sort command options alphabetically by name, placing boolean options with negatives appropriately.",
-	"P\"w!F2\"\"w!F/#?$"
+	"P\"w!F2\"\"2#\"w!F/$?%"
 ];
 
 //#endregion

package/dist/plugin-utils/reflect.d.cts

@@ -5,9 +5,10 @@ import { CommandOption } from "../types/command.cjs";
  * Sort command options alphabetically by name, placing boolean options with negatives appropriately.
  *
  * @param options - The array of command options to sort.
+ * @param skipNegatives - Whether to skip negative options when sorting (default: true).
  * @returns A new array of sorted command options.
  */
-declare function sortOptions(options: CommandOption[]): CommandOption[];
+declare function sortOptions(options: CommandOption[], skipNegatives?: boolean): CommandOption[];
 //#endregion
 export { sortOptions };
 //# sourceMappingURL=reflect.d.cts.map

package/dist/plugin-utils/reflect.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.d.cts","names":[],"sources":["../../src/plugin-utils/reflect.ts"],"mappings":";;;;;AA0BA;;;;iBAAgB,WAAA,CAAY,OAAA,EAAS,aAAA,KAAkB,aAAa"}
+{"version":3,"file":"reflect.d.cts","names":[],"sources":["../../src/plugin-utils/reflect.ts"],"mappings":";;;;;AA2BA;;;;;iBAAgB,WAAA,CACd,OAAA,EAAS,aAAA,IACT,aAAA,aACC,aAAa"}

package/dist/plugin-utils/reflect.d.mts

@@ -5,9 +5,10 @@ import { CommandOption } from "../types/command.mjs";
  * Sort command options alphabetically by name, placing boolean options with negatives appropriately.
  *
  * @param options - The array of command options to sort.
+ * @param skipNegatives - Whether to skip negative options when sorting (default: true).
  * @returns A new array of sorted command options.
  */
-declare function sortOptions(options: CommandOption[]): CommandOption[];
+declare function sortOptions(options: CommandOption[], skipNegatives?: boolean): CommandOption[];
 //#endregion
 export { sortOptions };
 //# sourceMappingURL=reflect.d.mts.map

package/dist/plugin-utils/reflect.mjs

@@ -7,11 +7,12 @@ function __assignType(fn, args) {
 * Sort command options alphabetically by name, placing boolean options with negatives appropriately.
 *
 * @param options - The array of command options to sort.
+* @param skipNegatives - Whether to skip negative options when sorting (default: true).
 * @returns A new array of sorted command options.
 */
-function sortOptions(options) {
+function sortOptions(options, skipNegatives = true) {
 	if (!options || options.length === 0) return [];
-	return options.filter(__assignType((arg) => arg.type !== "boolean" || arg.variadic || !arg.isNegativeOf, [
+	return options.filter(__assignType((arg) => arg.type !== "boolean" || arg.variadic || !skipNegatives || !arg.isNegativeOf, [
 		"arg",
 		"",
 		"P\"2!\"/\""
@@ -41,9 +42,10 @@ function sortOptions(options) {
 sortOptions.__type = [
 	"CommandOption",
 	"options",
+	"skipNegatives",
 	"sortOptions",
 	"Sort command options alphabetically by name, placing boolean options with negatives appropriately.",
-	"P\"w!F2\"\"w!F/#?$"
+	"P\"w!F2\"\"2#\"w!F/$?%"
 ];
 
 //#endregion

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),
@@ -125,7 +125,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
 		} }))),
@@ -446,11 +446,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":";;;;;;;AA6FA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/plugin.mjs

@@ -5,7 +5,7 @@ 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";
@@ -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),
@@ -120,7 +120,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
 		} }))),
@@ -441,11 +441,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",
 					"",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.17.17",
+  "version": "0.17.19",
   "private": false,
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "keywords": ["shell-shock", "powerlines", "storm-software"],
@@ -407,5 +407,5 @@
     "typescript": "^6.0.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "8c9f000d243ed0b6ac67b2be112429ddeccd0617"
+  "gitHead": "f65ed318b22c10407fc4f3770b3f1f742d02ab35"
 }