@shell-shock/core 0.4.4 → 0.5.0

package/dist/components/usage.cjs

@@ -0,0 +1,41 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_string_format_snake_case = require("@stryke/string-format/snake-case");
+
+//#region src/components/usage.tsx
+/**
+* A component that generates the usage display for a command.
+*/
+function Usage(props) {
+	const { command, bin, packageManager } = props;
+	return [
+		__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, {
+					when: packageManager === "yarn",
+					children: `yarn exec `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+					when: packageManager === "pnpm",
+					children: `pnpm exec `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+					when: packageManager === "bun",
+					children: `bun x `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Match, {
+					"else": true,
+					children: `npx `
+				})
+			];
+		} }),
+		(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`${bin} ${command.path.segments.map((segment) => require_plugin_utils_context_helpers.isPositionalCommandOption(segment) ? `<${(0, __stryke_string_format_snake_case.snakeCase)(command.path.positional[segment]?.name || require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment))}${command.path.positional[segment]?.variadic ? "..." : ""}>` : segment).join(" ")}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options]`)
+	];
+}
+
+//#endregion
+exports.Usage = Usage;
+//# sourceMappingURL=usage.cjs.map

package/dist/components/usage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.cjs","names":["code","Match","Switch","snakeCase","getPositionalCommandOptionName","isPositionalCommandOption","Usage","props","command","bin","packageManager","_$createComponent","children","when","_$memo","path","segments","map","segment","positional","name","variadic","join","Object","values","length"],"sources":["../../src/components/usage.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, Match, Switch } from \"@alloy-js/core\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport {\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types/command\";\n\nexport interface UsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The bin name to use in the usage display.\n   */\n  bin: string;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function Usage(props: UsageProps) {\n  const { command, bin, packageManager } = props;\n\n  return (\n    <>\n      {code`$ `}\n      <Switch>\n        <Match when={packageManager === \"yarn\"}>{`yarn exec `}</Match>\n        <Match when={packageManager === \"pnpm\"}>{`pnpm exec `}</Match>\n        <Match when={packageManager === \"bun\"}>{`bun x `}</Match>\n        <Match else>{`npx `}</Match>\n      </Switch>\n      {code`${bin} ${command.path.segments\n        .map(segment =>\n          isPositionalCommandOption(segment)\n            ? `<${snakeCase(\n                command.path.positional[segment]?.name ||\n                  getPositionalCommandOptionName(segment)\n              )}${command.path.positional[segment]?.variadic ? \"...\" : \"\"}>`\n            : segment\n        )\n        .join(\" \")}${\n        Object.values(command.children).length > 0 ? \" [commands]\" : \"\"\n      } [options]`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;AAmDA,SAAgBM,MAAMC,OAAmB;CACvC,MAAM,EAAEC,SAASC,KAAKC,mBAAmBH;AAEzC,QAAA;EAEKP,oBAAI;mDACJE,wBAAM,EAAA,IAAAU,WAAA;AAAA,UAAA;qDACJX,uBAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;qDACpDX,uBAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;qDACpDX,uBAAK;KAACY,MAAMH,mBAAmB;KAAKE,UAAG;KAAQ,CAAA;qDAC/CX,uBAAK;KAAA,QAAA;KAAAW,UAAO;KAAM,CAAA;IAAA;KAAA,CAAA;8CAEpBZ,oBAAI,GAAGS,IAAG,GAAID,QAAQO,KAAKC,SACzBC,KAAIC,YACHb,+DAA0Ba,QAAQ,GAC9B,qDACEV,QAAQO,KAAKI,WAAWD,UAAUE,QAChChB,oEAA+Bc,QACnC,CAAC,GAAGV,QAAQO,KAAKI,WAAWD,UAAUG,WAAW,QAAQ,GAAE,KAC3DH,QACL,CACAI,KAAK,IAAI,GACVC,OAAOC,OAAOhB,QAAQI,SAAS,CAACa,SAAS,IAAI,gBAAgB,GAAE,YACrD;EAAA"}

package/dist/components/usage.d.cts

@@ -0,0 +1,30 @@
+import { CommandTree } from "../types/command.cjs";
+import * as _alloy_js_core5 from "@alloy-js/core";
+
+//#region src/components/usage.d.ts
+interface UsageProps {
+  /**
+   * The command to generate help for.
+   */
+  command: CommandTree;
+  /**
+   * The package manager to generate the usage example for.
+   *
+   * @remarks
+   * If not specified, examples for all supported package managers will be generated.
+   *
+   * @defaultValue "npm"
+   */
+  packageManager?: "npm" | "yarn" | "pnpm" | "bun";
+  /**
+   * The bin name to use in the usage display.
+   */
+  bin: string;
+}
+/**
+ * A component that generates the usage display for a command.
+ */
+declare function Usage(props: UsageProps): _alloy_js_core5.Children;
+//#endregion
+export { Usage, UsageProps };
+//# sourceMappingURL=usage.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.cts","names":[],"sources":["../../src/components/usage.tsx"],"sourcesContent":[],"mappings":";;;;UA0BiB,UAAA;;;AAAjB;EAyBgB,OAAA,EArBL,WAqBkB;;;;;;;;;;;;;;;;;;iBAAb,KAAA,QAAa,aAAU,eAAA,CAAA"}

package/dist/components/usage.d.mts

@@ -0,0 +1,30 @@
+import { CommandTree } from "../types/command.mjs";
+import * as _alloy_js_core5 from "@alloy-js/core";
+
+//#region src/components/usage.d.ts
+interface UsageProps {
+  /**
+   * The command to generate help for.
+   */
+  command: CommandTree;
+  /**
+   * The package manager to generate the usage example for.
+   *
+   * @remarks
+   * If not specified, examples for all supported package managers will be generated.
+   *
+   * @defaultValue "npm"
+   */
+  packageManager?: "npm" | "yarn" | "pnpm" | "bun";
+  /**
+   * The bin name to use in the usage display.
+   */
+  bin: string;
+}
+/**
+ * A component that generates the usage display for a command.
+ */
+declare function Usage(props: UsageProps): _alloy_js_core5.Children;
+//#endregion
+export { Usage, UsageProps };
+//# sourceMappingURL=usage.d.mts.map

package/dist/components/usage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.mts","names":[],"sources":["../../src/components/usage.tsx"],"sourcesContent":[],"mappings":";;;;UA0BiB,UAAA;;;AAAjB;EAyBgB,OAAA,EArBL,WAqBkB;;;;;;;;;;;;;;;;;;iBAAb,KAAA,QAAa,aAAU,eAAA,CAAA"}

package/dist/components/usage.mjs

@@ -0,0 +1,40 @@
+import { getPositionalCommandOptionName, isPositionalCommandOption } from "../plugin-utils/context-helpers.mjs";
+import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
+import { Match, Switch, code } from "@alloy-js/core";
+import { snakeCase } from "@stryke/string-format/snake-case";
+
+//#region src/components/usage.tsx
+/**
+* A component that generates the usage display for a command.
+*/
+function Usage(props) {
+	const { command, bin, packageManager } = props;
+	return [
+		code`$ `,
+		createComponent(Switch, { get children() {
+			return [
+				createComponent(Match, {
+					when: packageManager === "yarn",
+					children: `yarn exec `
+				}),
+				createComponent(Match, {
+					when: packageManager === "pnpm",
+					children: `pnpm exec `
+				}),
+				createComponent(Match, {
+					when: packageManager === "bun",
+					children: `bun x `
+				}),
+				createComponent(Match, {
+					"else": true,
+					children: `npx `
+				})
+			];
+		} }),
+		memo(() => code`${bin} ${command.path.segments.map((segment) => isPositionalCommandOption(segment) ? `<${snakeCase(command.path.positional[segment]?.name || getPositionalCommandOptionName(segment))}${command.path.positional[segment]?.variadic ? "..." : ""}>` : segment).join(" ")}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options]`)
+	];
+}
+
+//#endregion
+export { Usage };
+//# sourceMappingURL=usage.mjs.map

package/dist/components/usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.mjs","names":["code","Match","Switch","snakeCase","getPositionalCommandOptionName","isPositionalCommandOption","Usage","props","command","bin","packageManager","_$createComponent","children","when","_$memo","path","segments","map","segment","positional","name","variadic","join","Object","values","length"],"sources":["../../src/components/usage.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, Match, Switch } from \"@alloy-js/core\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport {\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types/command\";\n\nexport interface UsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The bin name to use in the usage display.\n   */\n  bin: string;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function Usage(props: UsageProps) {\n  const { command, bin, packageManager } = props;\n\n  return (\n    <>\n      {code`$ `}\n      <Switch>\n        <Match when={packageManager === \"yarn\"}>{`yarn exec `}</Match>\n        <Match when={packageManager === \"pnpm\"}>{`pnpm exec `}</Match>\n        <Match when={packageManager === \"bun\"}>{`bun x `}</Match>\n        <Match else>{`npx `}</Match>\n      </Switch>\n      {code`${bin} ${command.path.segments\n        .map(segment =>\n          isPositionalCommandOption(segment)\n            ? `<${snakeCase(\n                command.path.positional[segment]?.name ||\n                  getPositionalCommandOptionName(segment)\n              )}${command.path.positional[segment]?.variadic ? \"...\" : \"\"}>`\n            : segment\n        )\n        .join(\" \")}${\n        Object.values(command.children).length > 0 ? \" [commands]\" : \"\"\n      } [options]`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;AAmDA,SAAgBM,MAAMC,OAAmB;CACvC,MAAM,EAAEC,SAASC,KAAKC,mBAAmBH;AAEzC,QAAA;EAEKP,IAAI;EAAIW,gBACRT,QAAM,EAAA,IAAAU,WAAA;AAAA,UAAA;IAAAD,gBACJV,OAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;IAAAD,gBACpDV,OAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;IAAAD,gBACpDV,OAAK;KAACY,MAAMH,mBAAmB;KAAKE,UAAG;KAAQ,CAAA;IAAAD,gBAC/CV,OAAK;KAAA,QAAA;KAAAW,UAAO;KAAM,CAAA;IAAA;KAAA,CAAA;EAAAE,WAEpBd,IAAI,GAAGS,IAAG,GAAID,QAAQO,KAAKC,SACzBC,KAAIC,YACHb,0BAA0Ba,QAAQ,GAC9B,IAAIf,UACFK,QAAQO,KAAKI,WAAWD,UAAUE,QAChChB,+BAA+Bc,QACnC,CAAC,GAAGV,QAAQO,KAAKI,WAAWD,UAAUG,WAAW,QAAQ,GAAE,KAC3DH,QACL,CACAI,KAAK,IAAI,GACVC,OAAOC,OAAOhB,QAAQI,SAAS,CAACa,SAAS,IAAI,gBAAgB,GAAE,YACrD;EAAA"}

package/dist/contexts/index.cjs

@@ -1,4 +1,8 @@
 const require_contexts_command = require('./command.cjs');
+const require_contexts_options = require('./options.cjs');
 
 exports.CommandContext = require_contexts_command.CommandContext;
-exports.useCommand = require_contexts_command.useCommand;
+exports.ExistingOptionsContext = require_contexts_options.ExistingOptionsContext;
+exports.computedOptions = require_contexts_options.computedOptions;
+exports.useCommand = require_contexts_command.useCommand;
+exports.useExistingOptions = require_contexts_options.useExistingOptions;

package/dist/contexts/index.d.cts

@@ -1,2 +1,3 @@
 import { CommandContext, useCommand } from "./command.cjs";
-export { CommandContext, useCommand };
+import { ExistingOptionsContext, computedOptions, useExistingOptions } from "./options.cjs";
+export { CommandContext, ExistingOptionsContext, computedOptions, useCommand, useExistingOptions };

package/dist/contexts/index.d.mts

@@ -1,2 +1,3 @@
 import { CommandContext, useCommand } from "./command.mjs";
-export { CommandContext, useCommand };
+import { ExistingOptionsContext, computedOptions, useExistingOptions } from "./options.mjs";
+export { CommandContext, ExistingOptionsContext, computedOptions, useCommand, useExistingOptions };

package/dist/contexts/index.mjs

@@ -1,3 +1,4 @@
 import { CommandContext, useCommand } from "./command.mjs";
+import { ExistingOptionsContext, computedOptions, useExistingOptions } from "./options.mjs";
 
-export { CommandContext, useCommand };
+export { CommandContext, ExistingOptionsContext, computedOptions, useCommand, useExistingOptions };

package/dist/contexts/options.cjs

@@ -0,0 +1,43 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __alloy_js_core = require("@alloy-js/core");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+
+//#region src/contexts/options.ts
+/**
+* The reflection parameter context used in template rendering.
+*/
+const ExistingOptionsContext = (0, __alloy_js_core.createNamedContext)("ExistingOptions", []);
+/**
+* Hook to access the ExistingOptions context.
+*
+* @remarks
+* This context provides a list of option names that already exist on the interface definition.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useExistingOptions() {
+	return (0, __alloy_js_core.useContext)(ExistingOptionsContext);
+}
+function computedOptions(command) {
+	return Object.entries(command.options).reduce((ret, [name, option]) => {
+		ret[(0, __stryke_string_format_camel_case.camelCase)(name)] ??= (0, defu.default)({ name: (0, __stryke_string_format_camel_case.camelCase)(name) }, ret[name] ?? {}, option);
+		if (option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean && option.isNegativeOf) ret[(0, __stryke_string_format_camel_case.camelCase)(option.isNegativeOf)] = (0, defu.default)({ name: (0, __stryke_string_format_camel_case.camelCase)(option.isNegativeOf) }, ret[option.isNegativeOf] ?? {}, {
+			...option,
+			env: (0, __stryke_type_checks_is_set_string.isSetString)(option.env) ? `NO_${option.env}` : false,
+			description: `${option.description.replace(/\.+$/, "")}. This property is the negative form of ${name}.`,
+			isNegativeOf: (0, __stryke_string_format_camel_case.camelCase)(name),
+			default: !option.default
+		});
+		return ret;
+	}, {});
+}
+
+//#endregion
+exports.ExistingOptionsContext = ExistingOptionsContext;
+exports.computedOptions = computedOptions;
+exports.useExistingOptions = useExistingOptions;
+//# sourceMappingURL=options.cjs.map

package/dist/contexts/options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.cjs","names":["createNamedContext","useContext","ReflectionKind","camelCase","isSetString","defu","ExistingOptionsContext","useExistingOptions","computedOptions","command","Object","entries","options","reduce","ret","name","option","kind","boolean","isNegativeOf","env","description","replace","default"],"sources":["../../src/contexts/options.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ComponentContext } from \"@alloy-js/core\";\nimport { createNamedContext, useContext } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport defu from \"defu\";\nimport type {\n  BooleanCommandOption,\n  CommandOption,\n  CommandTree\n} from \"../types\";\n\n/**\n * The reflection parameter context used in template rendering.\n */\nexport const ExistingOptionsContext: ComponentContext<string[]> =\n  createNamedContext<string[]>(\"ExistingOptions\", []);\n\n/**\n * Hook to access the ExistingOptions context.\n *\n * @remarks\n * This context provides a list of option names that already exist on the interface definition.\n *\n * @returns A reactive version of the current reflection.\n */\nexport function useExistingOptions() {\n  return useContext<string[]>(ExistingOptionsContext)!;\n}\n\nexport function computedOptions(command: CommandTree) {\n  return Object.entries(command.options).reduce(\n    (ret, [name, option]) => {\n      ret[camelCase(name)] ??= defu(\n        {\n          name: camelCase(name)\n        },\n        ret[name] ?? {},\n        option\n      ) as CommandOption;\n\n      if (option.kind === ReflectionKind.boolean && option.isNegativeOf) {\n        ret[camelCase(option.isNegativeOf)] = defu(\n          {\n            name: camelCase(option.isNegativeOf)\n          },\n          ret[option.isNegativeOf] ?? {},\n          {\n            ...option,\n            env: isSetString(option.env) ? `NO_${option.env}` : false,\n            description: `${option.description.replace(\n              /\\.+$/,\n              \"\"\n            )}. This property is the negative form of ${name}.`,\n            isNegativeOf: camelCase(name),\n            default: !option.default\n          }\n        ) as BooleanCommandOption;\n      }\n\n      return ret;\n    },\n    {} as Record<string, CommandOption>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAiCA,MAAaM,iEACkB,mBAAmB,EAAE,CAAC;;;;;;;;;AAUrD,SAAgBC,qBAAqB;AACnC,wCAA4BD,uBAAuB;;AAGrD,SAAgBE,gBAAgBC,SAAsB;AACpD,QAAOC,OAAOC,QAAQF,QAAQG,QAAQ,CAACC,QACpCC,KAAK,CAACC,MAAMC,YAAY;AACvBF,uDAAcC,KAAK,wBACjB,EACEA,uDAAgBA,KAAI,EACrB,EACDD,IAAIC,SAAS,EAAE,EACfC,OACgB;AAElB,MAAIA,OAAOC,SAASf,gDAAegB,WAAWF,OAAOG,aACnDL,sDAAcE,OAAOG,aAAa,sBAChC,EACEJ,uDAAgBC,OAAOG,aAAY,EACpC,EACDL,IAAIE,OAAOG,iBAAiB,EAAE,EAC9B;GACE,GAAGH;GACHI,yDAAiBJ,OAAOI,IAAI,GAAG,MAAMJ,OAAOI,QAAQ;GACpDC,aAAa,GAAGL,OAAOK,YAAYC,QACjC,QACA,GACD,CAAA,0CAA2CP,KAAI;GAChDI,+DAAwBJ,KAAK;GAC7BQ,SAAS,CAACP,OAAOO;GAErB,CAAyB;AAG3B,SAAOT;IAET,EACF,CAAC"}

package/dist/contexts/options.d.cts

@@ -0,0 +1,22 @@
+import { CommandOption, CommandTree } from "../types/command.cjs";
+import "../types/index.cjs";
+import { ComponentContext } from "@alloy-js/core";
+
+//#region src/contexts/options.d.ts
+/**
+ * The reflection parameter context used in template rendering.
+ */
+declare const ExistingOptionsContext: ComponentContext<string[]>;
+/**
+ * Hook to access the ExistingOptions context.
+ *
+ * @remarks
+ * This context provides a list of option names that already exist on the interface definition.
+ *
+ * @returns A reactive version of the current reflection.
+ */
+declare function useExistingOptions(): string[];
+declare function computedOptions(command: CommandTree): Record<string, CommandOption>;
+//#endregion
+export { ExistingOptionsContext, computedOptions, useExistingOptions };
+//# sourceMappingURL=options.d.cts.map

package/dist/contexts/options.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.cts","names":[],"sources":["../../src/contexts/options.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAiCa,cAAA,sBAAwB,EAAA,gBAAgB,CAAA,MAAA,EAAA,CAAA;AAWrD;AAIA;;;;;;;iBAJgB,kBAAA,CAAA;iBAIA,eAAA,UAAyB,cAAW,eAAA"}

package/dist/contexts/options.d.mts

@@ -0,0 +1,22 @@
+import { CommandOption, CommandTree } from "../types/command.mjs";
+import "../types/index.mjs";
+import { ComponentContext } from "@alloy-js/core";
+
+//#region src/contexts/options.d.ts
+/**
+ * The reflection parameter context used in template rendering.
+ */
+declare const ExistingOptionsContext: ComponentContext<string[]>;
+/**
+ * Hook to access the ExistingOptions context.
+ *
+ * @remarks
+ * This context provides a list of option names that already exist on the interface definition.
+ *
+ * @returns A reactive version of the current reflection.
+ */
+declare function useExistingOptions(): string[];
+declare function computedOptions(command: CommandTree): Record<string, CommandOption>;
+//#endregion
+export { ExistingOptionsContext, computedOptions, useExistingOptions };
+//# sourceMappingURL=options.d.mts.map

package/dist/contexts/options.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.mts","names":[],"sources":["../../src/contexts/options.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAiCa,cAAA,sBAAwB,EAAA,gBAAgB,CAAA,MAAA,EAAA,CAAA;AAWrD;AAIA;;;;;;;iBAJgB,kBAAA,CAAA;iBAIA,eAAA,UAAyB,cAAW,eAAA"}

package/dist/contexts/options.mjs

@@ -0,0 +1,39 @@
+import { camelCase } from "@stryke/string-format/camel-case";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import defu$1 from "defu";
+import { createNamedContext, useContext } from "@alloy-js/core";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+
+//#region src/contexts/options.ts
+/**
+* The reflection parameter context used in template rendering.
+*/
+const ExistingOptionsContext = createNamedContext("ExistingOptions", []);
+/**
+* Hook to access the ExistingOptions context.
+*
+* @remarks
+* This context provides a list of option names that already exist on the interface definition.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useExistingOptions() {
+	return useContext(ExistingOptionsContext);
+}
+function computedOptions(command) {
+	return Object.entries(command.options).reduce((ret, [name, option]) => {
+		ret[camelCase(name)] ??= defu$1({ name: camelCase(name) }, ret[name] ?? {}, option);
+		if (option.kind === ReflectionKind.boolean && option.isNegativeOf) ret[camelCase(option.isNegativeOf)] = defu$1({ name: camelCase(option.isNegativeOf) }, ret[option.isNegativeOf] ?? {}, {
+			...option,
+			env: isSetString(option.env) ? `NO_${option.env}` : false,
+			description: `${option.description.replace(/\.+$/, "")}. This property is the negative form of ${name}.`,
+			isNegativeOf: camelCase(name),
+			default: !option.default
+		});
+		return ret;
+	}, {});
+}
+
+//#endregion
+export { ExistingOptionsContext, computedOptions, useExistingOptions };
+//# sourceMappingURL=options.mjs.map

package/dist/contexts/options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.mjs","names":["createNamedContext","useContext","ReflectionKind","camelCase","isSetString","defu","ExistingOptionsContext","useExistingOptions","computedOptions","command","Object","entries","options","reduce","ret","name","option","kind","boolean","isNegativeOf","env","description","replace","default"],"sources":["../../src/contexts/options.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ComponentContext } from \"@alloy-js/core\";\nimport { createNamedContext, useContext } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport defu from \"defu\";\nimport type {\n  BooleanCommandOption,\n  CommandOption,\n  CommandTree\n} from \"../types\";\n\n/**\n * The reflection parameter context used in template rendering.\n */\nexport const ExistingOptionsContext: ComponentContext<string[]> =\n  createNamedContext<string[]>(\"ExistingOptions\", []);\n\n/**\n * Hook to access the ExistingOptions context.\n *\n * @remarks\n * This context provides a list of option names that already exist on the interface definition.\n *\n * @returns A reactive version of the current reflection.\n */\nexport function useExistingOptions() {\n  return useContext<string[]>(ExistingOptionsContext)!;\n}\n\nexport function computedOptions(command: CommandTree) {\n  return Object.entries(command.options).reduce(\n    (ret, [name, option]) => {\n      ret[camelCase(name)] ??= defu(\n        {\n          name: camelCase(name)\n        },\n        ret[name] ?? {},\n        option\n      ) as CommandOption;\n\n      if (option.kind === ReflectionKind.boolean && option.isNegativeOf) {\n        ret[camelCase(option.isNegativeOf)] = defu(\n          {\n            name: camelCase(option.isNegativeOf)\n          },\n          ret[option.isNegativeOf] ?? {},\n          {\n            ...option,\n            env: isSetString(option.env) ? `NO_${option.env}` : false,\n            description: `${option.description.replace(\n              /\\.+$/,\n              \"\"\n            )}. This property is the negative form of ${name}.`,\n            isNegativeOf: camelCase(name),\n            default: !option.default\n          }\n        ) as BooleanCommandOption;\n      }\n\n      return ret;\n    },\n    {} as Record<string, CommandOption>\n  );\n}\n"],"mappings":";;;;;;;;;;AAiCA,MAAaM,yBACXN,mBAA6B,mBAAmB,EAAE,CAAC;;;;;;;;;AAUrD,SAAgBO,qBAAqB;AACnC,QAAON,WAAqBK,uBAAuB;;AAGrD,SAAgBE,gBAAgBC,SAAsB;AACpD,QAAOC,OAAOC,QAAQF,QAAQG,QAAQ,CAACC,QACpCC,KAAK,CAACC,MAAMC,YAAY;AACvBF,MAAIX,UAAUY,KAAK,MAAMV,OACvB,EACEU,MAAMZ,UAAUY,KAAI,EACrB,EACDD,IAAIC,SAAS,EAAE,EACfC,OACgB;AAElB,MAAIA,OAAOC,SAASf,eAAegB,WAAWF,OAAOG,aACnDL,KAAIX,UAAUa,OAAOG,aAAa,IAAId,OACpC,EACEU,MAAMZ,UAAUa,OAAOG,aAAY,EACpC,EACDL,IAAIE,OAAOG,iBAAiB,EAAE,EAC9B;GACE,GAAGH;GACHI,KAAKhB,YAAYY,OAAOI,IAAI,GAAG,MAAMJ,OAAOI,QAAQ;GACpDC,aAAa,GAAGL,OAAOK,YAAYC,QACjC,QACA,GACD,CAAA,0CAA2CP,KAAI;GAChDI,cAAchB,UAAUY,KAAK;GAC7BQ,SAAS,CAACP,OAAOO;GAErB,CAAyB;AAG3B,SAAOT;IAET,EACF,CAAC"}

package/dist/helpers/resolve-command.cjs

@@ -1,6 +1,7 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
 const require_utilities = require('./utilities.cjs');
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
 let __stryke_path_append = require("@stryke/path/append");
 let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
 let __stryke_path_replace = require("@stryke/path/replace");
@@ -10,22 +11,27 @@ let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-obj
 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 __powerlines_deepkit_reflect_type = require("@powerlines/deepkit/reflect-type");
+let __powerlines_deepkit_esbuild_plugin = require("@powerlines/deepkit/esbuild-plugin");
 let __stryke_path_common = require("@stryke/path/common");
 let __stryke_path_normalize = require("@stryke/path/normalize");
+let powerlines_lib_utilities_resolve = require("powerlines/lib/utilities/resolve");
 
 //#region src/helpers/resolve-command.ts
 /**
 * Resolves the description for a command option based on its reflection.
 *
-* @param propertyReflection - The reflection property of the command option.
+* @param kind - The reflection kind of the command option.
+* @param optional - Whether the command option is optional.
+* @param name - The name of the command option.
+* @param title - The title of the command option, if any.
+* @param defaultValue - The default value of the command option, if any.
 * @returns The resolved description for the command option.
 */
-function resolveCommandDescription(propertyReflection) {
-	return propertyReflection.getDescription()?.trim() || `A${propertyReflection.isOptional() && !propertyReflection.getDefaultValue() ? "n optional" : ""} ${propertyReflection.getType().kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "flag provided via the command-line" : "command-line option"} that allows the user to ${propertyReflection.getType().kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "set the" : propertyReflection.getType().kind === __powerlines_deepkit_vendor_type.ReflectionKind.array ? "specify custom" : "specify a custom"} ${propertyReflection.getTags().title?.trim() || (0, __stryke_string_format_title_case.titleCase)(propertyReflection.getNameAsString())} ${propertyReflection.getType().kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "indicator" : `${propertyReflection.getType().kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? "numeric" : "string"} value${propertyReflection.getType().kind === __powerlines_deepkit_vendor_type.ReflectionKind.array ? "s" : ""}`} that will be used in the application.`;
+function resolveCommandOptionDescription(kind, optional, name, title, defaultValue) {
+	return `A${optional && !defaultValue ? "n optional" : ""} ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "flag provided via the command-line" : "command-line option"} that allows the user to ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "set the" : kind === __powerlines_deepkit_vendor_type.ReflectionKind.array ? "specify custom" : "specify a custom"} ${title?.trim() || (0, __stryke_string_format_title_case.titleCase)(name)} ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "indicator" : `${kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? "numeric" : "string"} value${kind === __powerlines_deepkit_vendor_type.ReflectionKind.array ? "s" : ""}`} that will be used in the application.`;
 }
 function resolveCommandId(context, file) {
-	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).split("/").filter((p) => Boolean(p) && !require_plugin_utils_context_helpers.isVariableCommandPath(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
+	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).split("/").filter((p) => Boolean(p) && !require_plugin_utils_context_helpers.isPositionalCommandOption(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
 }
 /**
 * Finds the command name from the given file path.
@@ -36,7 +42,7 @@ function resolveCommandId(context, file) {
 function resolveCommandName(file) {
 	let path = (0, __stryke_path_file_path_fns.findFilePath)(file);
 	let name = (0, __stryke_path_file_path_fns.findFolderName)(file, { requireExtension: true });
-	while (require_plugin_utils_context_helpers.isVariableCommandPath(name)) {
+	while (require_plugin_utils_context_helpers.isPositionalCommandOption(name)) {
 		path = (0, __stryke_path_resolve_parent_path.resolveParentPath)(path);
 		name = (0, __stryke_path_file_path_fns.findFolderName)(path, { requireExtension: true });
 	}
@@ -54,17 +60,56 @@ function findCommandsRoot(context) {
 /**
 * Extracts command parameter information from a type parameter reflection.
 *
-* @param param - The type parameter reflection to extract information from.
-* @returns The extracted command parameter information.
+* @param command - The command tree to which the parameter belongs.
+* @param reflection - The type parameter reflection to extract information from.
+* @returns The extracted command option information.
 */
-function extractCommandParameters(param) {
-	return {
-		name: param.name,
-		description: param.description,
-		optional: !!param.optional,
-		variadic: param.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array,
-		default: param.default
+function extractCommandOption(command, reflection) {
+	const propertyType = reflection.getType();
+	const option = {
+		name: reflection.getNameAsString(),
+		alias: reflection.getTags().alias ?? [],
+		title: reflection.getTags().title?.trim() || (0, __stryke_string_format_title_case.titleCase)(reflection.getNameAsString()),
+		description: reflection.getDescription() || resolveCommandOptionDescription(reflection.getKind(), reflection.isOptional(), reflection.getNameAsString(), reflection.getTags().title, reflection.getDefaultValue()),
+		env: (0, __stryke_string_format_constant_case.constantCase)(reflection.getNameAsString()),
+		kind: propertyType.kind,
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		variadic: false
 	};
+	if (propertyType.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) if (propertyType.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || propertyType.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) {
+		option.variadic = true;
+		option.kind = propertyType.type.kind;
+	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${command.name}". Only string[] and number[] are supported.`);
+	else if (propertyType.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean && propertyType.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && propertyType.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for option "${reflection.getNameAsString()}" in command "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(propertyType).trim().replaceAll(" | ", ", or ")}.`);
+	return option;
+}
+/**
+* Extracts command parameter information from a type parameter reflection.
+*
+* @param command - The command tree to which the parameter belongs.
+* @param segment - The command path segment corresponding to the parameter.
+* @param reflection - The type parameter reflection to extract information from.
+* @returns The extracted command option information.
+*/
+function extractCommandPositionalOption(command, segment, reflection) {
+	if (reflection.type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && reflection.type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number && !(reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array && (reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number))) throw new Error(`Unsupported type for positional option "${segment}" in command "${command.name}". Only string and number types (or string[] and number[]) are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(reflection.type).trim().replaceAll(" | ", ", or ")}.`);
+	const option = {
+		name: segment,
+		alias: [],
+		title: (0, __stryke_string_format_title_case.titleCase)(segment),
+		description: reflection.description || resolveCommandOptionDescription(reflection.type.kind, !!reflection.optional, segment, (0, __stryke_string_format_title_case.titleCase)(segment), reflection.default),
+		env: (0, __stryke_string_format_constant_case.constantCase)(segment),
+		kind: reflection.type.kind,
+		optional: reflection.optional,
+		default: reflection.default,
+		variadic: false
+	};
+	if (reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) if (reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) {
+		option.variadic = true;
+		option.kind = reflection.type.type.kind;
+	} else throw new Error(`Unsupported array type for option "${segment}" in command "${command.name}". Only string[] and number[] are supported.`);
+	return option;
 }
 /**
 * Reflects the command tree for a given command input.
@@ -77,59 +122,46 @@ function extractCommandParameters(param) {
 async function reflectCommandTree(context, command, parent) {
 	const title = command.title || `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, "") : parent.title} - ` : ""}${(0, __stryke_string_format_title_case.titleCase)(command.name)}${command.isVirtual ? " Commands" : ""}`;
 	const tree = {
+		alias: [],
 		...command,
 		title,
-		description: command.description || (command.isVirtual ? `A collection of available ${command.title || (0, __stryke_string_format_title_case.titleCase)(command.name)} commands that are included in the ${require_plugin_utils_context_helpers.getAppTitle(context)} command-line application.` : `The ${title} executable command-line interface.`),
 		path: {
 			...command.path,
-			variables: {}
+			positional: {}
 		},
 		options: require_utilities.getDefaultOptions(context, command),
-		params: [],
 		parent: parent ?? null,
 		children: {}
 	};
 	if (!command.isVirtual) {
 		if (!command.entry.input?.file || !context.fs.existsSync(command.entry.input.file)) throw new Error(`${!command.entry.input?.file ? "Missing" : "Non-existent"} command entry file for "${command.name}"`);
 		context.debug(`Adding reflection for user-defined command: ${command.id} (file: ${command.entry.input.file})`);
-		const type = await (0, __powerlines_deepkit_reflect_type.reflectType)(context, command.entry.input);
+		const resolved = await (0, powerlines_lib_utilities_resolve.resolveModule)(context, command.entry.input, { plugins: [(0, __powerlines_deepkit_esbuild_plugin.esbuildPlugin)(context, {
+			reflection: "default",
+			reflectionLevel: "verbose"
+		})] });
+		const metadata = resolved.metadata ?? {};
+		if ((0, __stryke_type_checks_is_set_string.isSetString)(metadata.title)) tree.title = metadata.title;
+		if ((0, __stryke_type_checks_is_set_string.isSetString)(metadata.description)) tree.description = metadata.description;
+		if ((0, __stryke_type_checks_is_set_string.isSetString)(metadata.alias) || Array.isArray(metadata.alias) && metadata.alias.length > 0) tree.alias = (0, __stryke_convert_to_array.toArray)(metadata.alias);
+		const type = (0, __powerlines_deepkit_vendor_type.reflect)(resolved);
 		if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.function) throw new Error(`The command entry file "${command.entry.input.file}" does not export a valid function.`);
+		tree.description ??= command.description || type.description || `The ${tree.title} executable command-line interface.`;
 		if (type.parameters.length > 0 && type.parameters[0]) {
 			const firstParam = type.parameters[0];
 			if (firstParam.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral || firstParam.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class) {
 				const optionsReflection = __powerlines_deepkit_vendor_type.ReflectionClass.from(firstParam.type);
-				for (const propertyReflection of optionsReflection.getProperties()) {
-					const propertyType = propertyReflection.getType();
-					tree.options[propertyReflection.getNameAsString()] = {
-						name: propertyReflection.getNameAsString(),
-						alias: propertyReflection.getTags().alias ?? [],
-						title: propertyReflection.getTags().title?.trim() || (0, __stryke_string_format_title_case.titleCase)(propertyReflection.getNameAsString()),
-						description: resolveCommandDescription(propertyReflection),
-						env: (0, __stryke_string_format_constant_case.constantCase)(propertyReflection.getNameAsString()),
-						kind: propertyType.kind,
-						optional: propertyReflection.isOptional(),
-						default: propertyReflection.getDefaultValue(),
-						variadic: false
-					};
-					if (propertyType.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) if (propertyType.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || propertyType.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) {
-						tree.options[propertyReflection.getNameAsString()].variadic = true;
-						tree.options[propertyReflection.getNameAsString()].kind = propertyType.type.kind;
-					} else throw new Error(`Unsupported array type for option "${propertyReflection.getNameAsString()}" in command "${command.name}". Only string[] and number[] are supported.`);
-					else if (propertyType.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean && propertyType.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && propertyType.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number) throw new Error(`Unsupported type for option "${propertyReflection.getNameAsString()}" in command "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(propertyType).trim().replaceAll(" | ", ", or ")}.`);
-				}
+				for (const propertyReflection of optionsReflection.getProperties()) tree.options[propertyReflection.getNameAsString()] = extractCommandOption(command, propertyReflection);
 			}
-			tree.path.variables = tree.path.segments.filter((segment) => require_plugin_utils_context_helpers.isVariableCommandPath(segment)).reduce((obj, segment, index) => {
+			tree.path.positional = tree.path.segments.filter((segment) => require_plugin_utils_context_helpers.isPositionalCommandOption(segment)).reduce((obj, segment, index) => {
 				if (type.parameters.length < index + 2 || !type.parameters[index + 1]) return obj;
-				const paramName = require_plugin_utils_context_helpers.getVariableCommandPathName(segment);
-				obj[paramName] = extractCommandParameters(type.parameters[index + 1]);
-				obj[paramName].description = obj[paramName].description || `The ${paramName} variable for the ${command.name} command.`;
+				const paramName = require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment);
+				obj[paramName] = extractCommandPositionalOption(command, paramName, type.parameters[index + 1]);
+				obj[paramName].description = obj[paramName].description || `The ${paramName} positional option for the ${command.name} command.`;
 				return obj;
 			}, {});
-			if (type.parameters.length > 1) type.parameters.slice(tree.path.segments.filter((segment) => require_plugin_utils_context_helpers.isVariableCommandPath(segment)).length + 1).forEach((param) => {
-				tree.params.push(extractCommandParameters(param));
-			});
 		}
-	}
+	} else tree.description ??= `A collection of available ${tree.title || (0, __stryke_string_format_title_case.titleCase)(tree.name)} commands that are included in the ${require_plugin_utils_context_helpers.getAppTitle(context)} command-line application.`;
 	if (context.env) {
 		if ((0, __stryke_type_checks_is_set_object.isSetObject)(tree.options)) Object.values(tree.options).filter((option) => option.env !== false).forEach((option) => {
 			context.env.types.env.addProperty({
@@ -149,22 +181,20 @@ async function reflectCommandTree(context, command, parent) {
 				}
 			});
 		});
-		if (tree.params) tree.params.forEach((param) => {
-			context.env.types.env.addProperty({
-				name: (0, __stryke_string_format_constant_case.constantCase)(param.name),
-				optional: param.optional ? true : void 0,
-				description: param.description,
-				visibility: __powerlines_deepkit_vendor_type.ReflectionVisibility.public,
-				type: param.variadic ? {
-					kind: __powerlines_deepkit_vendor_type.ReflectionKind.array,
-					type: { kind: __powerlines_deepkit_vendor_type.ReflectionKind.string }
-				} : { kind: __powerlines_deepkit_vendor_type.ReflectionKind.string },
-				default: param.default,
-				tags: { domain: "cli" }
-			});
-		});
+		if (Object.values(tree.path.positional).filter((option) => option.env !== false).length > 0) Object.values(tree.path.positional).filter((option) => option.env !== false).forEach((option) => context.env.types.env.addProperty({
+			name: (0, __stryke_string_format_constant_case.constantCase)(option.name),
+			optional: option.optional ? true : void 0,
+			description: option.description,
+			visibility: __powerlines_deepkit_vendor_type.ReflectionVisibility.public,
+			type: option.variadic ? {
+				kind: __powerlines_deepkit_vendor_type.ReflectionKind.array,
+				type: { kind: __powerlines_deepkit_vendor_type.ReflectionKind.string }
+			} : { kind: __powerlines_deepkit_vendor_type.ReflectionKind.string },
+			default: option.default,
+			tags: { domain: "cli" }
+		}));
 	}
-	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isVariableCommandPath(segment)).length === command.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isVariableCommandPath(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
+	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isPositionalCommandOption(segment)).length === command.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isPositionalCommandOption(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
 	return tree;
 }