@shell-shock/core 0.17.16 → 0.17.18

package/dist/api.d.cts

@@ -1,4 +1,4 @@
 //#region src/api.d.ts
-declare const _default: (params: import("@powerlines/engine").ExecutionApiParams<import("powerlines").ExecutionOptions, "docs" | "types" | "prepare" | "create" | "clean" | "lint" | "test" | "build" | "deploy">) => Promise<void>;
+declare const _default: (params: import("@powerlines/engine").ExecutionApiParams<import("powerlines").ExecutionOptions, "types" | "docs" | "create" | "clean" | "prepare" | "lint" | "test" | "build" | "deploy">) => Promise<void>;
 export = _default;
 //# sourceMappingURL=api.d.cts.map

package/dist/api.d.mts

@@ -1,5 +1,5 @@
 //#region src/api.d.ts
-declare const _default: (params: import("@powerlines/engine").ExecutionApiParams<import("powerlines").ExecutionOptions, "docs" | "types" | "prepare" | "create" | "clean" | "lint" | "test" | "build" | "deploy">) => Promise<void>;
+declare const _default: (params: import("@powerlines/engine").ExecutionApiParams<import("powerlines").ExecutionOptions, "types" | "docs" | "create" | "clean" | "prepare" | "lint" | "test" | "build" | "deploy">) => Promise<void>;
 //#endregion
 export { _default as default };
 //# sourceMappingURL=api.d.mts.map

package/dist/components/docs.cjs

@@ -13,6 +13,7 @@ let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin
 let _powerlines_plugin_alloy_markdown_components_markdown_file = require("@powerlines/plugin-alloy/markdown/components/markdown-file");
 let _powerlines_plugin_alloy_markdown_components_markdown_table = require("@powerlines/plugin-alloy/markdown/components/markdown-table");
 let _stryke_path_join = require("@stryke/path/join");
+let _stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
 
 //#region src/components/docs.tsx
 const __ΩRequired = [
@@ -43,18 +44,20 @@ function CommandOptionsDocs(props) {
 	const { command } = props;
 	if (Object.keys(command.options).length === 0) return _alloy_js_core.code`This command does not have any options.`;
 	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
-		return require_reflect.sortOptions(Object.values(command.options)).map(__assignType((option) => {
-			return {
+		return require_reflect.sortOptions(Object.values(command.options)).reduce(__assignType((ret, option) => {
+			ret.push({
 				name: option.name.trim(),
 				description: option.description.trim(),
-				defaultValue: option.default ? String(option.default)?.includes("\"") ? option.default : `\`${Array.isArray(option.default) ? option.default.join(", ") : option.default}\`` : "",
+				defaultValue: (0, _stryke_type_checks_is_undefined.isUndefined)(option.default) ? "" : JSON.stringify(option.default),
 				required: !option.required || option.default ? "" : "✔"
-			};
+			});
+			return ret;
 		}, [
+			"ret",
 			"option",
 			"",
-			"P\"2!\"/\""
-		]));
+			"P\"2!\"2\"\"/#"
+		]), []);
 	} });
 }
 CommandOptionsDocs.__type = [
@@ -75,18 +78,26 @@ const __ΩCommandDocsUsageExampleProps = [
 	"CommandTree",
 	"command",
 	"The command to generate the usage example for.",
+	"expand",
+	true,
+	"Whether to add expand/collapse details tags around the usage example. This is useful for hiding long usage examples by default.",
 	"CommandDocsUsageExampleProps",
-	"PP.!.\".#.$J4%8>&?'\"w(4)?*Mw+y"
+	"PP.!.\".#.$J4%8>&?'\"w(4)?*)4+8>,?-Mw.y"
 ];
 /**
 * Generates the markdown documentation for a command.
 */
 function CommandDocsUsageExample(props) {
-	const { packageManager = "npm", command } = props;
+	const { packageManager = "npm", command, expand = true } = props;
 	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)());
 	return [
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		_alloy_js_core.code`\`\`\`bash `,
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			when: expand,
+			fallback: _alloy_js_core.code`\`\`\`bash `,
+			children: _alloy_js_core.code`<details>
+        <summary>Using ${packageManager}</summary>
+        \`\`\`bash `
+		}),
 		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_usage.Usage, {
 			command,
@@ -96,7 +107,12 @@ function CommandDocsUsageExample(props) {
 			packageManager
 		}),
 		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		_alloy_js_core.code`\`\`\``,
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			when: expand,
+			fallback: _alloy_js_core.code`\`\`\` `,
+			children: _alloy_js_core.code`\`\`\`
+        </details> `
+		}),
 		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
 	];
 }

package/dist/components/docs.d.cts

@@ -26,6 +26,12 @@ interface CommandDocsUsageExampleProps {
    * The command to generate the usage example for.
    */
   command: CommandTree;
+  /**
+   * Whether to add expand/collapse details tags around the usage example. This is useful for hiding long usage examples by default.
+   *
+   * @defaultValue true
+   */
+  expand?: boolean;
 }
 /**
  * Generates the markdown documentation for a command.

package/dist/components/docs.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.cts","names":[],"sources":["../../src/components/docs.tsx"],"mappings":";;;;UAmCiB,uBAAA;;AAAjB;;EAIE,OAAA,EAAS,WAAW;AAAA;AAAA;AAMtB;;AANsB,iBAMN,kBAAA,CAAmB,KAAA,EAAO,uBAAuB,4BAAA,QAAA;AAAA,UA4BhD,4BAAA;EA5ByB;;;;AAAuB;AA4BjE;;;EASE,cAAA;EAAA;;;EAKA,OAAA,EAAS,WAAW;AAAA;AAMtB;;;AAAA,iBAAgB,uBAAA,CAAwB,KAAA,EAAO,4BAA4B,4BAAA,QAAA;AAAA,UAsB1D,gBAAA;EAtBuB;;;AAAmC;AAsB3E;;;;EASE,WAAA;EAYgB;;;EAPhB,OAAA,EAAS,WAAA;EAAT;;;;;EAOA,aAAA,GAAgB,QAAA,CAAS,4BAAA;AAAA;AAM3B;;;AAAA,iBAAgB,WAAA,CAAY,KAAA,EAAO,gBAAgB,4BAAA,QAAA;AAAA,UAwClC,oBAAA,SAA6B,OAAA,CAAQ,iBAAA;EAxC1B;;;AAAuB;AAwCnD;;;;EASE,WAAA;EAT4C;;;EAc5C,OAAA,EAAS,WAAA;AAAA;;;;iBAMK,eAAA,CAAgB,KAAA,EAAO,oBAAoB,4BAAA,QAAA"}
+{"version":3,"file":"docs.d.cts","names":[],"sources":["../../src/components/docs.tsx"],"mappings":";;;;UAoCiB,uBAAA;;AAAjB;;EAIE,OAAA,EAAS,WAAW;AAAA;AAAA;AAMtB;;AANsB,iBAMN,kBAAA,CAAmB,KAAA,EAAO,uBAAuB,4BAAA,QAAA;AAAA,UAgChD,4BAAA;EAhCyB;;;;AAAuB;AAgCjE;;;EASE,cAAA;EAAA;;;EAKA,OAAA,EAAS,WAAW;EAOd;AAAA;AAMR;;;EANE,MAAA;AAAA;;;;iBAMc,uBAAA,CAAwB,KAAA,EAAO,4BAA4B,4BAAA,QAAA;AAAA,UA4B1D,gBAAA;EAAgB;;;;;;;;EAS/B,WAAA;EAKS;;;EAAT,OAAA,EAAS,WAAA;EAO4C;AAAA;AAMvD;;;EANE,aAAA,GAAgB,QAAA,CAAS,4BAAA;AAAA;;;;iBAMX,WAAA,CAAY,KAAA,EAAO,gBAAgB,4BAAA,QAAA;AAAA,UAwClC,oBAAA,SAA6B,OAAA,CAAQ,iBAAA;EAAhB;;;;;;;;EASpC,WAAA;EAAA;;;EAKA,OAAA,EAAS,WAAA;AAAA;AAMX;;;AAAA,iBAAgB,eAAA,CAAgB,KAAA,EAAO,oBAAoB,4BAAA,QAAA"}

package/dist/components/docs.d.mts

@@ -26,6 +26,12 @@ interface CommandDocsUsageExampleProps {
    * The command to generate the usage example for.
    */
   command: CommandTree;
+  /**
+   * Whether to add expand/collapse details tags around the usage example. This is useful for hiding long usage examples by default.
+   *
+   * @defaultValue true
+   */
+  expand?: boolean;
 }
 /**
  * Generates the markdown documentation for a command.

package/dist/components/docs.mjs

@@ -12,6 +12,7 @@ import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
 import { MarkdownFile } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 import { MarkdownTable } from "@powerlines/plugin-alloy/markdown/components/markdown-table";
 import { joinPaths } from "@stryke/path/join";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
 
 //#region src/components/docs.tsx
 const __ΩRequired = [
@@ -42,18 +43,20 @@ function CommandOptionsDocs(props) {
 	const { command } = props;
 	if (Object.keys(command.options).length === 0) return code`This command does not have any options.`;
 	return createComponent(MarkdownTable, { get data() {
-		return sortOptions(Object.values(command.options)).map(__assignType((option) => {
-			return {
+		return sortOptions(Object.values(command.options)).reduce(__assignType((ret, option) => {
+			ret.push({
 				name: option.name.trim(),
 				description: option.description.trim(),
-				defaultValue: option.default ? String(option.default)?.includes("\"") ? option.default : `\`${Array.isArray(option.default) ? option.default.join(", ") : option.default}\`` : "",
+				defaultValue: isUndefined(option.default) ? "" : JSON.stringify(option.default),
 				required: !option.required || option.default ? "" : "✔"
-			};
+			});
+			return ret;
 		}, [
+			"ret",
 			"option",
 			"",
-			"P\"2!\"/\""
-		]));
+			"P\"2!\"2\"\"/#"
+		]), []);
 	} });
 }
 CommandOptionsDocs.__type = [
@@ -74,18 +77,26 @@ const __ΩCommandDocsUsageExampleProps = [
 	"CommandTree",
 	"command",
 	"The command to generate the usage example for.",
+	"expand",
+	true,
+	"Whether to add expand/collapse details tags around the usage example. This is useful for hiding long usage examples by default.",
 	"CommandDocsUsageExampleProps",
-	"PP.!.\".#.$J4%8>&?'\"w(4)?*Mw+y"
+	"PP.!.\".#.$J4%8>&?'\"w(4)?*)4+8>,?-Mw.y"
 ];
 /**
 * Generates the markdown documentation for a command.
 */
 function CommandDocsUsageExample(props) {
-	const { packageManager = "npm", command } = props;
+	const { packageManager = "npm", command, expand = true } = props;
 	const context = (usePowerlines.Ω = [["Context", "\"w!"]], usePowerlines());
 	return [
-		createIntrinsic("hbr", {}),
-		code`\`\`\`bash `,
+		createComponent(Show, {
+			when: expand,
+			fallback: code`\`\`\`bash `,
+			children: code`<details>
+        <summary>Using ${packageManager}</summary>
+        \`\`\`bash `
+		}),
 		createIntrinsic("hbr", {}),
 		createComponent(Usage, {
 			command,
@@ -95,7 +106,12 @@ function CommandDocsUsageExample(props) {
 			packageManager
 		}),
 		createIntrinsic("hbr", {}),
-		code`\`\`\``,
+		createComponent(Show, {
+			when: expand,
+			fallback: code`\`\`\` `,
+			children: code`\`\`\`
+        </details> `
+		}),
 		createIntrinsic("hbr", {})
 	];
 }

package/dist/components/usage.cjs

@@ -54,11 +54,11 @@ 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!\"/\""
-		])).join(" ")}` : ""} [options]`),
+		])).join(" ") : ""} [options]`),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 			get when() {
 				return command.args.length > 0;
@@ -66,7 +66,9 @@ function Usage(props) {
 			get children() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					_alloy_js_core.code`$ `,
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					_alloy_js_core.code`# or with options before arguments: `,
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(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 +93,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,11 +53,11 @@ 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;
@@ -65,7 +65,9 @@ function Usage(props) {
 			get children() {
 				return [
 					createIntrinsic("hbr", {}),
-					code`$ `,
+					createIntrinsic("hbr", {}),
+					code`# or with options before arguments: `,
+					createIntrinsic("hbr", {}),
 					createComponent(Switch, { get children() {
 						return [
 							createComponent(Match, {
@@ -90,11 +92,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/package.cjs

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

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.17.15";
+var version = "0.17.17";
 
 //#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/resolver/deepkit.cjs

@@ -0,0 +1,110 @@
+const require_helpers = require('./helpers.cjs');
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _stryke_type_checks_is_bigint = require("@stryke/type-checks/is-bigint");
+let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+let _stryke_type_checks_is_regexp = require("@stryke/type-checks/is-regexp");
+
+//#region src/resolver/deepkit.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+function resolveCommandParameterType(type) {
+	const isKind = !((0, _stryke_type_checks_is_set_object.isSetObject)(type) && "kind" in type);
+	const kind = !isKind ? type.kind : type;
+	if (kind === _powerlines_deepkit_vendor_type.ReflectionKind.string) return "string";
+	else if (kind === _powerlines_deepkit_vendor_type.ReflectionKind.number || kind === _powerlines_deepkit_vendor_type.ReflectionKind.bigint || !isKind && type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, _stryke_type_checks_is_number.isNumber)(type.literal) || (0, _stryke_type_checks_is_bigint.isBigInt)(type.literal))) return "number";
+	else if (kind === _powerlines_deepkit_vendor_type.ReflectionKind.boolean) return "boolean";
+	else return "string";
+}
+resolveCommandParameterType.__type = [
+	"type",
+	"string",
+	"number",
+	"boolean",
+	"resolveCommandParameterType",
+	"PP!!J2!P.\".#.$J/%"
+];
+function resolveCommandOption(ctx, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.options[reflection.getNameAsString()] ?? {};
+	const option = {
+		name: reflection.getNameAsString(),
+		alias: reflection.getTags().alias ?? [],
+		title: reflection.getTags().title?.trim(),
+		description: reflection.getDescription(),
+		type: resolveCommandParameterType(type),
+		required: !reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: reflection.isArray()
+	};
+	if (option.variadic) option.type = resolveCommandParameterType(type.type.kind);
+	else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.union) {
+		option.type = type.types.every(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number || t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, _stryke_type_checks_is_number.isNumber)(t.literal) || (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? "number" : "string";
+		option.choices = type.types.map(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal ? (0, _stryke_type_checks_is_number.isNumber)(t.literal) ? t.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal) ? Number(t.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal) option.choices = [(0, _stryke_type_checks_is_number.isNumber)(type.literal) ? type.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(type.literal) ? Number(type.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!existing.type && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	return require_helpers.mergeCommandParameter(existing, option);
+}
+resolveCommandOption.__type = [
+	"ResolverContext",
+	"ctx",
+	"reflection",
+	"CommandOption",
+	"resolveCommandOption",
+	"P\"w!2\"!2#\"w$/%"
+];
+function resolveCommandArgument(ctx, index, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.args.length > index ? ctx.output.args[index] : {};
+	const argument = {
+		name: reflection.getName() || reflection.parameter.name,
+		alias: reflection.getAlias(),
+		type: resolveCommandParameterType(type.kind),
+		title: reflection.getTitle() || reflection.parameter.tags?.title,
+		description: reflection.parameter.description,
+		required: !reflection.isOptional(),
+		default: reflection.getDefaultValue()
+	};
+	if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.array) if (type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number) {
+		argument.variadic = true;
+		argument.type = resolveCommandParameterType(type.type.kind);
+	} else throw new Error(`Unsupported array type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.union) {
+		argument.type = type.types.every(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.number || t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal && ((0, _stryke_type_checks_is_number.isNumber)(t.literal) || (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? "number" : "string";
+		argument.choices = type.types.map(__assignType((t) => t.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal ? (0, _stryke_type_checks_is_number.isNumber)(t.literal) ? t.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(t.literal) ? Number(t.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.literal) argument.choices = [(0, _stryke_type_checks_is_number.isNumber)(type.literal) ? type.literal : (0, _stryke_type_checks_is_bigint.isBigInt)(type.literal) ? Number(type.literal) : (0, _stryke_type_checks_is_regexp.isRegExp)(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!ctx.output.args?.length && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.boolean && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${(0, _powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	return require_helpers.mergeCommandParameter(existing, argument, { name: `arg${index}` });
+}
+resolveCommandArgument.__type = [
+	"ResolverContext",
+	"ctx",
+	"index",
+	"reflection",
+	"CommandArgument",
+	"resolveCommandArgument",
+	"P\"w!2\"'2#!2$\"w%/&"
+];
+
+//#endregion
+exports.resolveCommandArgument = resolveCommandArgument;
+exports.resolveCommandOption = resolveCommandOption;
+//# sourceMappingURL=deepkit.cjs.map

package/dist/resolver/deepkit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepkit.cjs","names":[],"sources":[],"mappings":""}

package/dist/resolver/deepkit.mjs

@@ -0,0 +1,109 @@
+import { mergeCommandParameter } from "./helpers.mjs";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { ReflectionKind, stringifyType } from "@powerlines/deepkit/vendor/type";
+import { isBigInt } from "@stryke/type-checks/is-bigint";
+import { isNumber } from "@stryke/type-checks/is-number";
+import { isRegExp } from "@stryke/type-checks/is-regexp";
+
+//#region src/resolver/deepkit.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+function resolveCommandParameterType(type) {
+	const isKind = !(isSetObject(type) && "kind" in type);
+	const kind = !isKind ? type.kind : type;
+	if (kind === ReflectionKind.string) return "string";
+	else if (kind === ReflectionKind.number || kind === ReflectionKind.bigint || !isKind && type.kind === ReflectionKind.literal && (isNumber(type.literal) || isBigInt(type.literal))) return "number";
+	else if (kind === ReflectionKind.boolean) return "boolean";
+	else return "string";
+}
+resolveCommandParameterType.__type = [
+	"type",
+	"string",
+	"number",
+	"boolean",
+	"resolveCommandParameterType",
+	"PP!!J2!P.\".#.$J/%"
+];
+function resolveCommandOption(ctx, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.options[reflection.getNameAsString()] ?? {};
+	const option = {
+		name: reflection.getNameAsString(),
+		alias: reflection.getTags().alias ?? [],
+		title: reflection.getTags().title?.trim(),
+		description: reflection.getDescription(),
+		type: resolveCommandParameterType(type),
+		required: !reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: reflection.isArray()
+	};
+	if (option.variadic) option.type = resolveCommandParameterType(type.type.kind);
+	else if (type.kind === ReflectionKind.union) {
+		option.type = type.types.every(__assignType((t) => t.kind === ReflectionKind.number || t.kind === ReflectionKind.literal && (isNumber(t.literal) || isBigInt(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? "number" : "string";
+		option.choices = type.types.map(__assignType((t) => t.kind === ReflectionKind.literal ? isNumber(t.literal) ? t.literal : isBigInt(t.literal) ? Number(t.literal) : isRegExp(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === ReflectionKind.literal) option.choices = [isNumber(type.literal) ? type.literal : isBigInt(type.literal) ? Number(type.literal) : isRegExp(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!existing.type && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	return mergeCommandParameter(existing, option);
+}
+resolveCommandOption.__type = [
+	"ResolverContext",
+	"ctx",
+	"reflection",
+	"CommandOption",
+	"resolveCommandOption",
+	"P\"w!2\"!2#\"w$/%"
+];
+function resolveCommandArgument(ctx, index, reflection) {
+	const type = reflection.getType();
+	const existing = ctx.output.args.length > index ? ctx.output.args[index] : {};
+	const argument = {
+		name: reflection.getName() || reflection.parameter.name,
+		alias: reflection.getAlias(),
+		type: resolveCommandParameterType(type.kind),
+		title: reflection.getTitle() || reflection.parameter.tags?.title,
+		description: reflection.parameter.description,
+		required: !reflection.isOptional(),
+		default: reflection.getDefaultValue()
+	};
+	if (type.kind === ReflectionKind.array) if (type.type.kind === ReflectionKind.string || type.type.kind === ReflectionKind.number) {
+		argument.variadic = true;
+		argument.type = resolveCommandParameterType(type.type.kind);
+	} else throw new Error(`Unsupported array type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (type.kind === ReflectionKind.union) {
+		argument.type = type.types.every(__assignType((t) => t.kind === ReflectionKind.number || t.kind === ReflectionKind.literal && (isNumber(t.literal) || isBigInt(t.literal)), [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])) ? "number" : "string";
+		argument.choices = type.types.map(__assignType((t) => t.kind === ReflectionKind.literal ? isNumber(t.literal) ? t.literal : isBigInt(t.literal) ? Number(t.literal) : isRegExp(t.literal) ? t.literal.source : String(t.literal) : null, [
+			"t",
+			"",
+			"P\"2!\"/\""
+		])).filter(Boolean);
+	} else if (type.kind === ReflectionKind.literal) argument.choices = [isNumber(type.literal) ? type.literal : isBigInt(type.literal) ? Number(type.literal) : isRegExp(type.literal) ? type.literal.source : String(type.literal)].filter(Boolean);
+	else if (!ctx.output.args?.length && type.kind !== ReflectionKind.boolean && type.kind !== ReflectionKind.string && type.kind !== ReflectionKind.number) throw new Error(`Unsupported type for positional argument "${argument.name}" in command "${ctx.input.command.name}". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(type).trim().replaceAll(" | ", ", or ")}.`);
+	return mergeCommandParameter(existing, argument, { name: `arg${index}` });
+}
+resolveCommandArgument.__type = [
+	"ResolverContext",
+	"ctx",
+	"index",
+	"reflection",
+	"CommandArgument",
+	"resolveCommandArgument",
+	"P\"w!2\"'2#!2$\"w%/&"
+];
+
+//#endregion
+export { resolveCommandArgument, resolveCommandOption };
+//# sourceMappingURL=deepkit.mjs.map

package/dist/resolver/deepkit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepkit.mjs","names":[],"sources":[],"mappings":""}

package/dist/resolver/helpers.cjs

@@ -179,5 +179,6 @@ const mergeCommandParameter = (0, defu.createDefu)(__assignType((obj, key, value
 exports.applyArgsDefaults = applyArgsDefaults;
 exports.applyDefaults = applyDefaults;
 exports.applyOptionsDefaults = applyOptionsDefaults;
+exports.mergeCommandParameter = mergeCommandParameter;
 exports.resolveVirtualCommand = resolveVirtualCommand;
 //# sourceMappingURL=helpers.cjs.map

package/dist/resolver/helpers.mjs

@@ -176,5 +176,5 @@ const mergeCommandParameter = createDefu(__assignType((obj, key, value) => {
 ]));
 
 //#endregion
-export { applyArgsDefaults, applyDefaults, applyOptionsDefaults, resolveVirtualCommand };
+export { applyArgsDefaults, applyDefaults, applyOptionsDefaults, mergeCommandParameter, resolveVirtualCommand };
 //# sourceMappingURL=helpers.mjs.map

package/dist/resolver/resolve.cjs

@@ -1,6 +1,7 @@
 const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
 const require_utilities = require('../helpers/utilities.cjs');
 const require_helpers = require('./helpers.cjs');
+const require_deepkit = require('./deepkit.cjs');
 let _powerlines_schema = require("@powerlines/schema");
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_path_replace = require("@stryke/path/replace");
@@ -8,8 +9,10 @@ let _stryke_string_format_constant_case = require("@stryke/string-format/constan
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let _stryke_type_checks_is_boolean = require("@stryke/type-checks/is-boolean");
 let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
 let _powerlines_deepkit_esbuild_plugin = require("@powerlines/deepkit/esbuild-plugin");
 let _stryke_json = require("@stryke/json");
 
@@ -223,44 +226,6 @@ resolveCommandParameter.__type = [
 	"resolveCommandParameter",
 	"P#2!P)4\")4#M2$P\"w%\"w&J/'"
 ];
-/**
-* Resolves a command option from the given schema.
-*
-* @param schema - The command option schema, which can be a command option configuration or a JSON schema input.
-* @returns The resolved command option definition.
-*/
-function resolveCommandOption(schema) {
-	return resolveCommandParameter(schema, {
-		fallbackRequired: false,
-		includeBooleanOptionFields: true
-	});
-}
-resolveCommandOption.__type = [
-	"schema",
-	"CommandOption",
-	"resolveCommandOption",
-	"Resolves a command option from the given schema.",
-	"P#2!\"w\"/#?$"
-];
-/**
-* Resolves a command argument from the given schema.
-*
-* @param schema - The command argument schema, which can be a command argument configuration or a JSON schema input.
-* @returns The resolved command argument definition.
-*/
-function resolveCommandArgument(schema) {
-	return resolveCommandParameter(schema, {
-		fallbackRequired: true,
-		includeBooleanOptionFields: false
-	});
-}
-resolveCommandArgument.__type = [
-	"schema",
-	"CommandArgument",
-	"resolveCommandArgument",
-	"Resolves a command argument from the given schema.",
-	"P#2!\"w\"/#?$"
-];
 async function preprocess(input) {
 	const { context, command, parent } = input;
 	const title = command.title || `${parent?.title ? `${parent.virtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${(0, _stryke_string_format_title_case.titleCase)(command.name)}${command.virtual ? " Commands" : ""}`;
@@ -270,7 +235,6 @@ async function preprocess(input) {
 			alias: [],
 			icon: parent?.icon,
 			tags: parent?.tags ?? [],
-			source: "file",
 			...command,
 			title,
 			options: parent === null ? require_utilities.getGlobalOptions(context, command) : {},
@@ -291,6 +255,12 @@ async function preprocess(input) {
 			resolve: { skipNodeModulesBundle: true }
 		}));
 	}
+	if (!command.virtual) {
+		if (!result.module?.default) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not include a handler function as its default export - this is required for command resolution and execution.`);
+		const type = (0, _powerlines_deepkit_vendor_type.reflect)(result.module.default);
+		if (type.kind !== _powerlines_deepkit_vendor_type.ReflectionKind.function) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not have a valid function as its default export - this is required for command resolution and execution.`);
+		result.reflection = new _powerlines_deepkit_vendor_type.ReflectionFunction(type);
+	}
 	return result;
 }
 preprocess.__type = [
@@ -441,11 +411,15 @@ async function resolve(input) {
 		if ((0, _stryke_type_checks_is_set_string.isSetString)(metadata.alias) || Array.isArray(metadata.alias) && metadata.alias.length > 0) ctx.output.alias = (0, _stryke_convert_to_array.toArray)(metadata.alias);
 		if ((0, _stryke_type_checks_is_set_string.isSetString)(metadata.icon)) ctx.output.icon = metadata.icon;
 		if ((0, _stryke_type_checks_is_set_string.isSetString)(metadata.tags)) ctx.output.tags = (0, _stryke_helpers_get_unique.getUnique)(ctx.output.tags.concat((0, _stryke_convert_to_array.toArray)(metadata.tags)));
-		if ((0, _stryke_type_checks_is_set_object.isSetObject)(ctx.module.options)) {
+		ctx.output.description ??= ctx.input.command.description || (0, _stryke_type_checks_is_function.isFunction)(ctx.reflection?.getDescription) ? ctx.reflection?.getDescription() : ctx.reflection?.description;
+		if (ctx.module.options) {
 			const options = await (0, _powerlines_schema.extract)(ctx.input.context, ctx.module.options);
 			if (!(0, _stryke_type_checks_is_set_object.isSetObject)(options) || !(0, _stryke_json.isJsonSchemaObjectType)(options.schema)) throw new TypeError(`Command options for command at path "${ctx.input.command.path}" must resolve to an object.`);
 			ctx.output.options = (0, _powerlines_schema.getPropertiesList)(options).reduce(__assignType((ret, property) => {
-				ret[property.name] = resolveCommandOption(property);
+				ret[property.name] = resolveCommandParameter(property, {
+					fallbackRequired: false,
+					includeBooleanOptionFields: true
+				});
 				return ret;
 			}, [
 				"ret",
@@ -454,13 +428,32 @@ async function resolve(input) {
 				"P\"2!\"2\"\"/#"
 			]), {});
 		}
-		if (ctx.module.args && Array.isArray(ctx.module.args)) {
+		if (ctx.module.args) {
 			const args = await (0, _powerlines_schema.extract)(ctx.input.context, ctx.module.args);
-			if (!(0, _stryke_type_checks_is_set_object.isSetObject)(args) || !(0, _stryke_json.isJsonSchemaTupleType)(args.schema)) throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must resolve to a tuple.`);
-			ctx.output.args = args.schema.items.map(__assignType((item) => resolveCommandArgument(item), [
-				"item",
+			if ((0, _stryke_type_checks_is_set_object.isSetObject)(args)) {
+				if (!(0, _stryke_json.isJsonSchemaTupleType)(args.schema) && !(0, _powerlines_schema.isJsonSchemaArray)(args.schema)) throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must resolve to a tuple${args?.schema?.type ? `, instead received ${JSON.stringify(args.schema.type)}` : ""}.`);
+				if (Array.isArray(args.schema.items)) ctx.output.args = args.schema.items.map(__assignType((item) => resolveCommandParameter(item, {
+					fallbackRequired: true,
+					includeBooleanOptionFields: false
+				}), [
+					"item",
+					"",
+					"P\"2!\"/\""
+				]));
+			}
+		}
+		const parameters = ctx.reflection?.getParameters() ?? [];
+		if (parameters.length > 0) {
+			const hasOptions = parameters[0] && (parameters[0].type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral || parameters[0].type.kind === _powerlines_deepkit_vendor_type.ReflectionKind.class);
+			if (hasOptions && !ctx.module.options) {
+				const optionsReflection = _powerlines_deepkit_vendor_type.ReflectionClass.from(parameters[0]?.type);
+				for (const property of optionsReflection.getProperties()) ctx.output.options[property.getNameAsString()] = require_deepkit.resolveCommandOption(ctx, property);
+			}
+			if (!ctx.module.args) ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(__assignType((arg, index) => require_deepkit.resolveCommandArgument(ctx, index, arg), [
+				"arg",
+				"index",
 				"",
-				"P\"2!\"/\""
+				"P\"2!\"2\"\"/#"
 			]));
 		}
 	} else require_helpers.resolveVirtualCommand(ctx);

package/dist/resolver/resolve.mjs

@@ -1,15 +1,18 @@
 import { getDynamicPathSegmentName, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
 import { getGlobalOptions } from "../helpers/utilities.mjs";
 import { applyArgsDefaults, applyDefaults, applyOptionsDefaults, resolveVirtualCommand } from "./helpers.mjs";
-import { addProperty, extract, getPropertiesList, resolveModule } from "@powerlines/schema";
+import { resolveCommandArgument, resolveCommandOption } from "./deepkit.mjs";
+import { addProperty, extract, getPropertiesList, isJsonSchemaArray, resolveModule } from "@powerlines/schema";
 import { toArray } from "@stryke/convert/to-array";
 import { replacePath } from "@stryke/path/replace";
 import { constantCase } from "@stryke/string-format/constant-case";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { titleCase } from "@stryke/string-format/title-case";
+import { ReflectionClass, ReflectionFunction, ReflectionKind, reflect } from "@powerlines/deepkit/vendor/type";
 import { isBoolean } from "@stryke/type-checks/is-boolean";
 import { getUnique } from "@stryke/helpers/get-unique";
+import { isFunction } from "@stryke/type-checks/is-function";
 import { esbuildPlugin } from "@powerlines/deepkit/esbuild-plugin";
 import { isJsonSchemaObjectType, isJsonSchemaTupleType } from "@stryke/json";
 
@@ -223,44 +226,6 @@ resolveCommandParameter.__type = [
 	"resolveCommandParameter",
 	"P#2!P)4\")4#M2$P\"w%\"w&J/'"
 ];
-/**
-* Resolves a command option from the given schema.
-*
-* @param schema - The command option schema, which can be a command option configuration or a JSON schema input.
-* @returns The resolved command option definition.
-*/
-function resolveCommandOption(schema) {
-	return resolveCommandParameter(schema, {
-		fallbackRequired: false,
-		includeBooleanOptionFields: true
-	});
-}
-resolveCommandOption.__type = [
-	"schema",
-	"CommandOption",
-	"resolveCommandOption",
-	"Resolves a command option from the given schema.",
-	"P#2!\"w\"/#?$"
-];
-/**
-* Resolves a command argument from the given schema.
-*
-* @param schema - The command argument schema, which can be a command argument configuration or a JSON schema input.
-* @returns The resolved command argument definition.
-*/
-function resolveCommandArgument(schema) {
-	return resolveCommandParameter(schema, {
-		fallbackRequired: true,
-		includeBooleanOptionFields: false
-	});
-}
-resolveCommandArgument.__type = [
-	"schema",
-	"CommandArgument",
-	"resolveCommandArgument",
-	"Resolves a command argument from the given schema.",
-	"P#2!\"w\"/#?$"
-];
 async function preprocess(input) {
 	const { context, command, parent } = input;
 	const title = command.title || `${parent?.title ? `${parent.virtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${titleCase(command.name)}${command.virtual ? " Commands" : ""}`;
@@ -270,7 +235,6 @@ async function preprocess(input) {
 			alias: [],
 			icon: parent?.icon,
 			tags: parent?.tags ?? [],
-			source: "file",
 			...command,
 			title,
 			options: parent === null ? getGlobalOptions(context, command) : {},
@@ -291,6 +255,12 @@ async function preprocess(input) {
 			resolve: { skipNodeModulesBundle: true }
 		}));
 	}
+	if (!command.virtual) {
+		if (!result.module?.default) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not include a handler function as its default export - this is required for command resolution and execution.`);
+		const type = reflect(result.module.default);
+		if (type.kind !== ReflectionKind.function) throw new Error(`The command entry file "${input.command.entry.input?.file || input.command.path}" does not have a valid function as its default export - this is required for command resolution and execution.`);
+		result.reflection = new ReflectionFunction(type);
+	}
 	return result;
 }
 preprocess.__type = [
@@ -441,11 +411,15 @@ async function resolve(input) {
 		if (isSetString(metadata.alias) || Array.isArray(metadata.alias) && metadata.alias.length > 0) ctx.output.alias = toArray(metadata.alias);
 		if (isSetString(metadata.icon)) ctx.output.icon = metadata.icon;
 		if (isSetString(metadata.tags)) ctx.output.tags = getUnique(ctx.output.tags.concat(toArray(metadata.tags)));
-		if (isSetObject(ctx.module.options)) {
+		ctx.output.description ??= ctx.input.command.description || isFunction(ctx.reflection?.getDescription) ? ctx.reflection?.getDescription() : ctx.reflection?.description;
+		if (ctx.module.options) {
 			const options = await extract(ctx.input.context, ctx.module.options);
 			if (!isSetObject(options) || !isJsonSchemaObjectType(options.schema)) throw new TypeError(`Command options for command at path "${ctx.input.command.path}" must resolve to an object.`);
 			ctx.output.options = getPropertiesList(options).reduce(__assignType((ret, property) => {
-				ret[property.name] = resolveCommandOption(property);
+				ret[property.name] = resolveCommandParameter(property, {
+					fallbackRequired: false,
+					includeBooleanOptionFields: true
+				});
 				return ret;
 			}, [
 				"ret",
@@ -454,13 +428,32 @@ async function resolve(input) {
 				"P\"2!\"2\"\"/#"
 			]), {});
 		}
-		if (ctx.module.args && Array.isArray(ctx.module.args)) {
+		if (ctx.module.args) {
 			const args = await extract(ctx.input.context, ctx.module.args);
-			if (!isSetObject(args) || !isJsonSchemaTupleType(args.schema)) throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must resolve to a tuple.`);
-			ctx.output.args = args.schema.items.map(__assignType((item) => resolveCommandArgument(item), [
-				"item",
+			if (isSetObject(args)) {
+				if (!isJsonSchemaTupleType(args.schema) && !isJsonSchemaArray(args.schema)) throw new TypeError(`Command arguments for command at path "${ctx.input.command.path}" must resolve to a tuple${args?.schema?.type ? `, instead received ${JSON.stringify(args.schema.type)}` : ""}.`);
+				if (Array.isArray(args.schema.items)) ctx.output.args = args.schema.items.map(__assignType((item) => resolveCommandParameter(item, {
+					fallbackRequired: true,
+					includeBooleanOptionFields: false
+				}), [
+					"item",
+					"",
+					"P\"2!\"/\""
+				]));
+			}
+		}
+		const parameters = ctx.reflection?.getParameters() ?? [];
+		if (parameters.length > 0) {
+			const hasOptions = parameters[0] && (parameters[0].type.kind === ReflectionKind.objectLiteral || parameters[0].type.kind === ReflectionKind.class);
+			if (hasOptions && !ctx.module.options) {
+				const optionsReflection = ReflectionClass.from(parameters[0]?.type);
+				for (const property of optionsReflection.getProperties()) ctx.output.options[property.getNameAsString()] = resolveCommandOption(ctx, property);
+			}
+			if (!ctx.module.args) ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(__assignType((arg, index) => resolveCommandArgument(ctx, index, arg), [
+				"arg",
+				"index",
 				"",
-				"P\"2!\"/\""
+				"P\"2!\"2\"\"/#"
 			]));
 		}
 	} else resolveVirtualCommand(ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.17.16",
+  "version": "0.17.18",
   "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": "fb690df8ec51cb881e90d3bb9b347f7f15b06e07"
+  "gitHead": "4ca0ac0ff9ada03aea6667c89a04b54dc73ff40b"
 }