@shell-shock/core 0.5.1 → 0.7.0

package/dist/components/usage.mjs

@@ -1,6 +1,7 @@
-import { getPositionalCommandOptionName, isPositionalCommandOption } from "../plugin-utils/context-helpers.mjs";
+import { getDynamicPathSegmentName, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
 import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
 import { Match, Switch, code } from "@alloy-js/core";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
 import { snakeCase } from "@stryke/string-format/snake-case";
 
 //#region src/components/usage.tsx
@@ -13,6 +14,10 @@ function Usage(props) {
 		code`$ `,
 		createComponent(Switch, { get children() {
 			return [
+				createComponent(Match, {
+					when: packageManager === "npm",
+					children: `npx `
+				}),
 				createComponent(Match, {
 					when: packageManager === "yarn",
 					children: `yarn exec `
@@ -24,14 +29,10 @@ function Usage(props) {
 				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]`)
+		memo(() => code`${bin}${command.path.segments.length > 0 ? ` ${command.path.segments.map((segment) => isDynamicPathSegment(segment) ? `[${snakeCase(command.path.dynamics[segment]?.name || getDynamicPathSegmentName(segment))}${command.path.dynamics[segment]?.variadic ? "..." : ""}]` : segment).join(" ")}` : ""}${Object.values(command.children).length > 0 ? " [commands]" : ""}${command.params.length > 0 ? ` ${command.params.map((param) => `<${snakeCase(param.name)}${(param.kind === ReflectionKind.string || param.kind === ReflectionKind.number) && param.variadic ? "..." : ""}>`).join(" ")}` : ""} [options]`)
 	];
 }
 

package/dist/components/usage.mjs.map

@@ -1 +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"}
+{"version":3,"file":"usage.mjs","names":["code","Match","Switch","ReflectionKind","snakeCase","getDynamicPathSegmentName","isDynamicPathSegment","Usage","props","command","bin","packageManager","_$createComponent","children","when","_$memo","path","segments","length","map","segment","dynamics","name","variadic","join","Object","values","params","param","kind","string","number"],"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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\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  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 === \"npm\"}>{`npx `}</Match>\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      </Switch>\n      {code`${bin}${\n        command.path.segments.length > 0\n          ? ` ${command.path.segments\n              .map(segment =>\n                isDynamicPathSegment(segment)\n                  ? `[${snakeCase(\n                      command.path.dynamics[segment]?.name ||\n                        getDynamicPathSegmentName(segment)\n                    )}${command.path.dynamics[segment]?.variadic ? \"...\" : \"\"}]`\n                  : segment\n              )\n              .join(\" \")}`\n          : \"\"\n      }${Object.values(command.children).length > 0 ? \" [commands]\" : \"\"}${\n        command.params.length > 0\n          ? ` ${command.params\n              .map(\n                param =>\n                  `<${snakeCase(param.name)}${\n                    (param.kind === ReflectionKind.string ||\n                      param.kind === ReflectionKind.number) &&\n                    param.variadic\n                      ? \"...\"\n                      : \"\"\n                  }>`\n              )\n              .join(\" \")}`\n          : \"\"\n      } [options]`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;AAkDA,SAAgBO,MAAMC,OAAmB;CACvC,MAAM,EAAEC,SAASC,KAAKC,mBAAmBH;AAEzC,QAAA;EAEKR,IAAI;EAAIY,gBACRV,QAAM,EAAA,IAAAW,WAAA;AAAA,UAAA;IAAAD,gBACJX,OAAK;KAACa,MAAMH,mBAAmB;KAAKE,UAAG;KAAM,CAAA;IAAAD,gBAC7CX,OAAK;KAACa,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;IAAAD,gBACpDX,OAAK;KAACa,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;IAAAD,gBACpDX,OAAK;KAACa,MAAMH,mBAAmB;KAAKE,UAAG;KAAQ,CAAA;IAAA;KAAA,CAAA;EAAAE,WAEjDf,IAAI,GAAGU,MACND,QAAQO,KAAKC,SAASC,SAAS,IAC3B,IAAIT,QAAQO,KAAKC,SACdE,KAAIC,YACHd,qBAAqBc,QAAQ,GACzB,IAAIhB,UACFK,QAAQO,KAAKK,SAASD,UAAUE,QAC9BjB,0BAA0Be,QAC9B,CAAC,GAAGX,QAAQO,KAAKK,SAASD,UAAUG,WAAW,QAAQ,GAAE,KACzDH,QACL,CACAI,KAAK,IAAI,KACZ,KACHC,OAAOC,OAAOjB,QAAQI,SAAS,CAACK,SAAS,IAAI,gBAAgB,KAC9DT,QAAQkB,OAAOT,SAAS,IACpB,IAAIT,QAAQkB,OACTR,KACCS,UACE,IAAIxB,UAAUwB,MAAMN,KAAK,IACtBM,MAAMC,SAAS1B,eAAe2B,UAC7BF,MAAMC,SAAS1B,eAAe4B,WAChCH,MAAML,WACF,QACA,GAAE,GAEX,CACAC,KAAK,IAAI,KACZ,GAAE,YACI;EAAA"}

package/dist/helpers/persistence.cjs

@@ -1,16 +1,31 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __stryke_helpers_omit = require("@stryke/helpers/omit");
 
 //#region src/helpers/persistence.ts
 function getCommandsPersistencePath(context) {
-	return (0, __stryke_path_join_paths.joinPaths)(context.dataPath, `commands.json`);
+	return (0, __stryke_path_join_paths.joinPaths)(context.dataPath, "reflections", "commands.json");
 }
 function serializedCommandTree(commands) {
 	const serialize = (node, parent = null) => {
 		const serializedNode = {
 			...node,
+			options: Object.entries(node.options).reduce((ret, [key, option]) => {
+				ret[key] = { ...(0, __stryke_helpers_omit.omit)(option, ["reflection"]) };
+				return ret;
+			}, {}),
+			path: {
+				...node.path,
+				dynamics: Object.entries(node.path.dynamics).reduce((ret, [key, dynamic]) => {
+					ret[key] = { ...(0, __stryke_helpers_omit.omit)(dynamic, ["reflection"]) };
+					return ret;
+				}, {})
+			},
+			params: node.params.map((param) => ({ ...(0, __stryke_helpers_omit.omit)(param, ["reflection"]) })),
 			parent,
-			children: {}
+			children: {},
+			reflection: node.reflection ? (0, __powerlines_deepkit_vendor_type.serializeType)(node.reflection.type) : void 0
 		};
 		for (const [key, child] of Object.entries(node.children || {})) serializedNode.children[key] = serialize(child, node.id);
 		return serializedNode;
@@ -21,10 +36,40 @@ function serializedCommandTree(commands) {
 }
 function deserializeCommandTree(serializedCommands) {
 	const deserialize = (node, parent = null) => {
+		const type = (0, __powerlines_deepkit_vendor_type.deserializeType)(node.reflection);
+		if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.function) throw new Error(`Failed to deserialize persisted data - invalid command handler reflection type for command ${node.id}`);
+		const reflection = new __powerlines_deepkit_vendor_type.ReflectionFunction(type);
+		let optionsReflection;
+		if (reflection.getParameters().length > 0 && reflection.getParameters()[0]) {
+			const optionsType = reflection.getParameters()[0].type;
+			if (optionsType.kind === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral) optionsReflection = (0, __powerlines_deepkit_vendor_type.resolveClassType)(optionsType);
+		}
 		const deserializedNode = {
 			...node,
+			options: optionsReflection ? Object.entries(node.options).reduce((ret, [key, option]) => {
+				ret[key] = {
+					...option,
+					reflection: optionsReflection.getProperty(option.name)
+				};
+				return ret;
+			}, {}) : {},
+			path: {
+				...node.path,
+				dynamics: Object.entries(node.path.dynamics).reduce((ret, [key, dynamic]) => {
+					ret[key] = {
+						...dynamic,
+						reflection: reflection.getParameter(dynamic.name)
+					};
+					return ret;
+				}, {})
+			},
+			params: node.params.map((param) => ({
+				...param,
+				reflection: reflection.getParameter(param.name)
+			})),
 			parent,
-			children: {}
+			children: {},
+			reflection
 		};
 		for (const [key, child] of Object.entries(node.children || {})) deserializedNode.children[key] = deserialize(child, deserializedNode);
 		return deserializedNode;

package/dist/helpers/persistence.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.cjs","names":["joinPaths","getCommandsPersistencePath","context","dataPath","serializedCommandTree","commands","serialize","node","parent","serializedNode","children","key","child","Object","entries","id","result","deserializeCommandTree","serializedCommands","deserialize","deserializedNode","readCommandsPersistence","reflections","fs","read","length","Error","JSON","parse","writeCommandsPersistence","filePath","write","stringify","config","mode"],"sources":["../../src/helpers/persistence.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 { joinPaths } from \"@stryke/path/join-paths\";\nimport type { CommandTree, SerializedCommandTree } from \"../types\";\nimport type { Context } from \"../types/context\";\n\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, `commands.json`);\n}\n\nfunction serializedCommandTree(\n  commands: Record<string, CommandTree>\n): Record<string, SerializedCommandTree> {\n  const serialize = (\n    node: CommandTree,\n    parent: string | null = null\n  ): SerializedCommandTree => {\n    const serializedNode: SerializedCommandTree = {\n      ...node,\n      parent,\n      children: {}\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      serializedNode.children[key] = serialize(child, node.id);\n    }\n\n    return serializedNode;\n  };\n\n  const result: Record<string, SerializedCommandTree> = {};\n  for (const [key, child] of Object.entries(commands)) {\n    result[key] = serialize(child, null);\n  }\n\n  return result;\n}\n\nfunction deserializeCommandTree(\n  serializedCommands: Record<string, SerializedCommandTree>\n): Record<string, CommandTree> {\n  const deserialize = (\n    node: SerializedCommandTree,\n    parent: CommandTree | null = null\n  ): CommandTree => {\n    const deserializedNode: CommandTree = {\n      ...node,\n      parent,\n      children: {}\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      deserializedNode.children[key] = deserialize(child, deserializedNode);\n    }\n\n    return deserializedNode;\n  };\n\n  const result: Record<string, CommandTree> = {};\n  for (const [key, child] of Object.entries(serializedCommands)) {\n    result[key] = deserialize(child, null);\n  }\n\n  return result;\n}\n\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = deserializeCommandTree(JSON.parse(reflections));\n}\n\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      serializedCommandTree(context.commands),\n      null,\n      context.config.mode === \"development\" ? 2 : 0\n    )\n  );\n}\n"],"mappings":";;;;AAsBA,SAAgBC,2BAA2BC,SAA0B;AACnE,gDAAiBA,QAAQC,UAAU,gBAAgB;;AAGrD,SAASC,sBACPC,UACuC;CACvC,MAAMC,aACJC,MACAC,SAAwB,SACE;EAC1B,MAAMC,iBAAwC;GAC5C,GAAGF;GACHC;GACAE,UAAU,EAAC;GACZ;AAED,OAAK,MAAM,CAACC,KAAKC,UAAUC,OAAOC,QAAQP,KAAKG,YAAY,EAAE,CAAC,CAC5DD,gBAAeC,SAASC,OAAOL,UAAUM,OAAOL,KAAKQ,GAAG;AAG1D,SAAON;;CAGT,MAAMO,SAAgD,EAAE;AACxD,MAAK,MAAM,CAACL,KAAKC,UAAUC,OAAOC,QAAQT,SAAS,CACjDW,QAAOL,OAAOL,UAAUM,OAAO,KAAK;AAGtC,QAAOI;;AAGT,SAASC,uBACPC,oBAC6B;CAC7B,MAAMC,eACJZ,MACAC,SAA6B,SACb;EAChB,MAAMY,mBAAgC;GACpC,GAAGb;GACHC;GACAE,UAAU,EAAC;GACZ;AAED,OAAK,MAAM,CAACC,KAAKC,UAAUC,OAAOC,QAAQP,KAAKG,YAAY,EAAE,CAAC,CAC5DU,kBAAiBV,SAASC,OAAOQ,YAAYP,OAAOQ,iBAAiB;AAGvE,SAAOA;;CAGT,MAAMJ,SAAsC,EAAE;AAC9C,MAAK,MAAM,CAACL,KAAKC,UAAUC,OAAOC,QAAQI,mBAAmB,CAC3DF,QAAOL,OAAOQ,YAAYP,OAAO,KAAK;AAGxC,QAAOI;;AAGT,eAAsBK,wBAAwBnB,SAAkB;CAC9D,MAAMoB,cAAc,MAAMpB,QAAQqB,GAAGC,KACnCvB,2BAA2BC,QAC7B,CAAC;AACD,KAAI,CAACoB,eAAe,CAACA,YAAYG,OAC/B,OAAM,IAAIC,MACR,+BAA+BzB,2BAA2BC,QAAQ,CAAA,WACnE;AAGHA,SAAQG,WAAWY,uBAAuBU,KAAKC,MAAMN,YAAY,CAAC;;AAGpE,eAAsBO,yBAAyB3B,SAAkB;CAC/D,MAAM4B,WAAW7B,2BAA2BC,QAAQ;AAEpD,OAAMA,QAAQqB,GAAGQ,MACfD,UACAH,KAAKK,UACH5B,sBAAsBF,QAAQG,SAAS,EACvC,MACAH,QAAQ+B,OAAOC,SAAS,gBAAgB,IAAI,EAEhD,CAAC"}
+{"version":3,"file":"persistence.cjs","names":["deserializeType","ReflectionFunction","ReflectionKind","resolveClassType","serializeType","omit","joinPaths","getCommandsPersistencePath","context","dataPath","serializedCommandTree","commands","serialize","node","parent","serializedNode","options","Object","entries","reduce","ret","key","option","path","dynamics","dynamic","params","map","param","children","reflection","type","undefined","child","id","result","deserializeCommandTree","serializedCommands","deserialize","kind","function","Error","optionsReflection","getParameters","length","optionsType","objectLiteral","deserializedNode","getProperty","name","getParameter","readCommandsPersistence","reflections","fs","read","JSON","parse","writeCommandsPersistence","filePath","write","stringify","config","mode"],"sources":["../../src/helpers/persistence.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 { ReflectionClass } from \"@powerlines/deepkit/vendor/type\";\nimport {\n  deserializeType,\n  ReflectionFunction,\n  ReflectionKind,\n  resolveClassType,\n  serializeType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport type {\n  CommandDynamicSegment,\n  CommandOption,\n  CommandParameter,\n  CommandTree,\n  SerializedCommandDynamicSegment,\n  SerializedCommandOption,\n  SerializedCommandTree\n} from \"../types\";\nimport type { Context } from \"../types/context\";\n\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, \"reflections\", \"commands.json\");\n}\n\nexport function serializedCommandTree(\n  commands: Record<string, CommandTree>\n): Record<string, SerializedCommandTree> {\n  const serialize = (\n    node: CommandTree,\n    parent: string | null = null\n  ): SerializedCommandTree => {\n    const serializedNode: SerializedCommandTree = {\n      ...node,\n      options: Object.entries(node.options).reduce(\n        (ret, [key, option]) => {\n          ret[key] = {\n            ...omit(option, [\"reflection\"])\n          };\n          return ret;\n        },\n        {} as Record<string, SerializedCommandOption>\n      ),\n      path: {\n        ...node.path,\n        dynamics: Object.entries(node.path.dynamics).reduce(\n          (ret, [key, dynamic]) => {\n            ret[key] = {\n              ...omit(dynamic, [\"reflection\"])\n            };\n            return ret;\n          },\n          {} as Record<string, SerializedCommandDynamicSegment>\n        )\n      },\n      params: node.params.map(param => ({\n        ...omit(param, [\"reflection\"])\n      })),\n      parent,\n      children: {},\n      reflection: node.reflection\n        ? serializeType(node.reflection.type)\n        : undefined\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      serializedNode.children[key] = serialize(child, node.id);\n    }\n\n    return serializedNode;\n  };\n\n  const result: Record<string, SerializedCommandTree> = {};\n  for (const [key, child] of Object.entries(commands)) {\n    result[key] = serialize(child, null);\n  }\n\n  return result;\n}\n\nexport function deserializeCommandTree(\n  serializedCommands: Record<string, SerializedCommandTree>\n): Record<string, CommandTree> {\n  const deserialize = (\n    node: SerializedCommandTree,\n    parent: CommandTree | null = null\n  ): CommandTree => {\n    const type = deserializeType(node.reflection);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `Failed to deserialize persisted data - invalid command handler reflection type for command ${node.id}`\n      );\n    }\n\n    const reflection = new ReflectionFunction(type);\n\n    let optionsReflection: ReflectionClass<any> | undefined;\n    if (\n      reflection.getParameters().length > 0 &&\n      reflection.getParameters()[0]\n    ) {\n      const optionsType = reflection.getParameters()[0]!.type;\n      if (optionsType.kind === ReflectionKind.objectLiteral) {\n        optionsReflection = resolveClassType(optionsType);\n      }\n    }\n\n    const deserializedNode: CommandTree = {\n      ...node,\n      options: optionsReflection\n        ? Object.entries(node.options).reduce(\n            (ret, [key, option]) => {\n              ret[key] = {\n                ...option,\n                reflection: optionsReflection.getProperty(option.name)\n              } as CommandOption;\n              return ret;\n            },\n            {} as Record<string, CommandOption>\n          )\n        : {},\n      path: {\n        ...node.path,\n        dynamics: Object.entries(node.path.dynamics).reduce(\n          (ret, [key, dynamic]) => {\n            ret[key] = {\n              ...dynamic,\n              reflection: reflection.getParameter(dynamic.name)\n            } as CommandDynamicSegment;\n            return ret;\n          },\n          {} as Record<string, CommandDynamicSegment>\n        )\n      },\n      params: node.params.map(param => ({\n        ...param,\n        reflection: reflection.getParameter(param.name)\n      })) as CommandParameter[],\n      parent,\n      children: {},\n      reflection\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      deserializedNode.children[key] = deserialize(child, deserializedNode);\n    }\n\n    return deserializedNode;\n  };\n\n  const result: Record<string, CommandTree> = {};\n  for (const [key, child] of Object.entries(serializedCommands)) {\n    result[key] = deserialize(child, null);\n  }\n\n  return result;\n}\n\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = deserializeCommandTree(JSON.parse(reflections));\n}\n\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      serializedCommandTree(context.commands),\n      null,\n      context.config.mode === \"development\" ? 2 : 0\n    )\n  );\n}\n"],"mappings":"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"}

package/dist/helpers/persistence.mjs

@@ -1,15 +1,30 @@
 import { joinPaths } from "@stryke/path/join-paths";
+import { ReflectionFunction, ReflectionKind, deserializeType, resolveClassType, serializeType } from "@powerlines/deepkit/vendor/type";
+import { omit } from "@stryke/helpers/omit";
 
 //#region src/helpers/persistence.ts
 function getCommandsPersistencePath(context) {
-	return joinPaths(context.dataPath, `commands.json`);
+	return joinPaths(context.dataPath, "reflections", "commands.json");
 }
 function serializedCommandTree(commands) {
 	const serialize = (node, parent = null) => {
 		const serializedNode = {
 			...node,
+			options: Object.entries(node.options).reduce((ret, [key, option]) => {
+				ret[key] = { ...omit(option, ["reflection"]) };
+				return ret;
+			}, {}),
+			path: {
+				...node.path,
+				dynamics: Object.entries(node.path.dynamics).reduce((ret, [key, dynamic]) => {
+					ret[key] = { ...omit(dynamic, ["reflection"]) };
+					return ret;
+				}, {})
+			},
+			params: node.params.map((param) => ({ ...omit(param, ["reflection"]) })),
 			parent,
-			children: {}
+			children: {},
+			reflection: node.reflection ? serializeType(node.reflection.type) : void 0
 		};
 		for (const [key, child] of Object.entries(node.children || {})) serializedNode.children[key] = serialize(child, node.id);
 		return serializedNode;
@@ -20,10 +35,40 @@ function serializedCommandTree(commands) {
 }
 function deserializeCommandTree(serializedCommands) {
 	const deserialize = (node, parent = null) => {
+		const type = deserializeType(node.reflection);
+		if (type.kind !== ReflectionKind.function) throw new Error(`Failed to deserialize persisted data - invalid command handler reflection type for command ${node.id}`);
+		const reflection = new ReflectionFunction(type);
+		let optionsReflection;
+		if (reflection.getParameters().length > 0 && reflection.getParameters()[0]) {
+			const optionsType = reflection.getParameters()[0].type;
+			if (optionsType.kind === ReflectionKind.objectLiteral) optionsReflection = resolveClassType(optionsType);
+		}
 		const deserializedNode = {
 			...node,
+			options: optionsReflection ? Object.entries(node.options).reduce((ret, [key, option]) => {
+				ret[key] = {
+					...option,
+					reflection: optionsReflection.getProperty(option.name)
+				};
+				return ret;
+			}, {}) : {},
+			path: {
+				...node.path,
+				dynamics: Object.entries(node.path.dynamics).reduce((ret, [key, dynamic]) => {
+					ret[key] = {
+						...dynamic,
+						reflection: reflection.getParameter(dynamic.name)
+					};
+					return ret;
+				}, {})
+			},
+			params: node.params.map((param) => ({
+				...param,
+				reflection: reflection.getParameter(param.name)
+			})),
 			parent,
-			children: {}
+			children: {},
+			reflection
 		};
 		for (const [key, child] of Object.entries(node.children || {})) deserializedNode.children[key] = deserialize(child, deserializedNode);
 		return deserializedNode;

package/dist/helpers/persistence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.mjs","names":["joinPaths","getCommandsPersistencePath","context","dataPath","serializedCommandTree","commands","serialize","node","parent","serializedNode","children","key","child","Object","entries","id","result","deserializeCommandTree","serializedCommands","deserialize","deserializedNode","readCommandsPersistence","reflections","fs","read","length","Error","JSON","parse","writeCommandsPersistence","filePath","write","stringify","config","mode"],"sources":["../../src/helpers/persistence.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 { joinPaths } from \"@stryke/path/join-paths\";\nimport type { CommandTree, SerializedCommandTree } from \"../types\";\nimport type { Context } from \"../types/context\";\n\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, `commands.json`);\n}\n\nfunction serializedCommandTree(\n  commands: Record<string, CommandTree>\n): Record<string, SerializedCommandTree> {\n  const serialize = (\n    node: CommandTree,\n    parent: string | null = null\n  ): SerializedCommandTree => {\n    const serializedNode: SerializedCommandTree = {\n      ...node,\n      parent,\n      children: {}\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      serializedNode.children[key] = serialize(child, node.id);\n    }\n\n    return serializedNode;\n  };\n\n  const result: Record<string, SerializedCommandTree> = {};\n  for (const [key, child] of Object.entries(commands)) {\n    result[key] = serialize(child, null);\n  }\n\n  return result;\n}\n\nfunction deserializeCommandTree(\n  serializedCommands: Record<string, SerializedCommandTree>\n): Record<string, CommandTree> {\n  const deserialize = (\n    node: SerializedCommandTree,\n    parent: CommandTree | null = null\n  ): CommandTree => {\n    const deserializedNode: CommandTree = {\n      ...node,\n      parent,\n      children: {}\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      deserializedNode.children[key] = deserialize(child, deserializedNode);\n    }\n\n    return deserializedNode;\n  };\n\n  const result: Record<string, CommandTree> = {};\n  for (const [key, child] of Object.entries(serializedCommands)) {\n    result[key] = deserialize(child, null);\n  }\n\n  return result;\n}\n\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = deserializeCommandTree(JSON.parse(reflections));\n}\n\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      serializedCommandTree(context.commands),\n      null,\n      context.config.mode === \"development\" ? 2 : 0\n    )\n  );\n}\n"],"mappings":";;;AAsBA,SAAgBC,2BAA2BC,SAA0B;AACnE,QAAOF,UAAUE,QAAQC,UAAU,gBAAgB;;AAGrD,SAASC,sBACPC,UACuC;CACvC,MAAMC,aACJC,MACAC,SAAwB,SACE;EAC1B,MAAMC,iBAAwC;GAC5C,GAAGF;GACHC;GACAE,UAAU,EAAC;GACZ;AAED,OAAK,MAAM,CAACC,KAAKC,UAAUC,OAAOC,QAAQP,KAAKG,YAAY,EAAE,CAAC,CAC5DD,gBAAeC,SAASC,OAAOL,UAAUM,OAAOL,KAAKQ,GAAG;AAG1D,SAAON;;CAGT,MAAMO,SAAgD,EAAE;AACxD,MAAK,MAAM,CAACL,KAAKC,UAAUC,OAAOC,QAAQT,SAAS,CACjDW,QAAOL,OAAOL,UAAUM,OAAO,KAAK;AAGtC,QAAOI;;AAGT,SAASC,uBACPC,oBAC6B;CAC7B,MAAMC,eACJZ,MACAC,SAA6B,SACb;EAChB,MAAMY,mBAAgC;GACpC,GAAGb;GACHC;GACAE,UAAU,EAAC;GACZ;AAED,OAAK,MAAM,CAACC,KAAKC,UAAUC,OAAOC,QAAQP,KAAKG,YAAY,EAAE,CAAC,CAC5DU,kBAAiBV,SAASC,OAAOQ,YAAYP,OAAOQ,iBAAiB;AAGvE,SAAOA;;CAGT,MAAMJ,SAAsC,EAAE;AAC9C,MAAK,MAAM,CAACL,KAAKC,UAAUC,OAAOC,QAAQI,mBAAmB,CAC3DF,QAAOL,OAAOQ,YAAYP,OAAO,KAAK;AAGxC,QAAOI;;AAGT,eAAsBK,wBAAwBnB,SAAkB;CAC9D,MAAMoB,cAAc,MAAMpB,QAAQqB,GAAGC,KACnCvB,2BAA2BC,QAC7B,CAAC;AACD,KAAI,CAACoB,eAAe,CAACA,YAAYG,OAC/B,OAAM,IAAIC,MACR,+BAA+BzB,2BAA2BC,QAAQ,CAAA,WACnE;AAGHA,SAAQG,WAAWY,uBAAuBU,KAAKC,MAAMN,YAAY,CAAC;;AAGpE,eAAsBO,yBAAyB3B,SAAkB;CAC/D,MAAM4B,WAAW7B,2BAA2BC,QAAQ;AAEpD,OAAMA,QAAQqB,GAAGQ,MACfD,UACAH,KAAKK,UACH5B,sBAAsBF,QAAQG,SAAS,EACvC,MACAH,QAAQ+B,OAAOC,SAAS,gBAAgB,IAAI,EAEhD,CAAC"}
+{"version":3,"file":"persistence.mjs","names":["deserializeType","ReflectionFunction","ReflectionKind","resolveClassType","serializeType","omit","joinPaths","getCommandsPersistencePath","context","dataPath","serializedCommandTree","commands","serialize","node","parent","serializedNode","options","Object","entries","reduce","ret","key","option","path","dynamics","dynamic","params","map","param","children","reflection","type","undefined","child","id","result","deserializeCommandTree","serializedCommands","deserialize","kind","function","Error","optionsReflection","getParameters","length","optionsType","objectLiteral","deserializedNode","getProperty","name","getParameter","readCommandsPersistence","reflections","fs","read","JSON","parse","writeCommandsPersistence","filePath","write","stringify","config","mode"],"sources":["../../src/helpers/persistence.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 { ReflectionClass } from \"@powerlines/deepkit/vendor/type\";\nimport {\n  deserializeType,\n  ReflectionFunction,\n  ReflectionKind,\n  resolveClassType,\n  serializeType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport type {\n  CommandDynamicSegment,\n  CommandOption,\n  CommandParameter,\n  CommandTree,\n  SerializedCommandDynamicSegment,\n  SerializedCommandOption,\n  SerializedCommandTree\n} from \"../types\";\nimport type { Context } from \"../types/context\";\n\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, \"reflections\", \"commands.json\");\n}\n\nexport function serializedCommandTree(\n  commands: Record<string, CommandTree>\n): Record<string, SerializedCommandTree> {\n  const serialize = (\n    node: CommandTree,\n    parent: string | null = null\n  ): SerializedCommandTree => {\n    const serializedNode: SerializedCommandTree = {\n      ...node,\n      options: Object.entries(node.options).reduce(\n        (ret, [key, option]) => {\n          ret[key] = {\n            ...omit(option, [\"reflection\"])\n          };\n          return ret;\n        },\n        {} as Record<string, SerializedCommandOption>\n      ),\n      path: {\n        ...node.path,\n        dynamics: Object.entries(node.path.dynamics).reduce(\n          (ret, [key, dynamic]) => {\n            ret[key] = {\n              ...omit(dynamic, [\"reflection\"])\n            };\n            return ret;\n          },\n          {} as Record<string, SerializedCommandDynamicSegment>\n        )\n      },\n      params: node.params.map(param => ({\n        ...omit(param, [\"reflection\"])\n      })),\n      parent,\n      children: {},\n      reflection: node.reflection\n        ? serializeType(node.reflection.type)\n        : undefined\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      serializedNode.children[key] = serialize(child, node.id);\n    }\n\n    return serializedNode;\n  };\n\n  const result: Record<string, SerializedCommandTree> = {};\n  for (const [key, child] of Object.entries(commands)) {\n    result[key] = serialize(child, null);\n  }\n\n  return result;\n}\n\nexport function deserializeCommandTree(\n  serializedCommands: Record<string, SerializedCommandTree>\n): Record<string, CommandTree> {\n  const deserialize = (\n    node: SerializedCommandTree,\n    parent: CommandTree | null = null\n  ): CommandTree => {\n    const type = deserializeType(node.reflection);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `Failed to deserialize persisted data - invalid command handler reflection type for command ${node.id}`\n      );\n    }\n\n    const reflection = new ReflectionFunction(type);\n\n    let optionsReflection: ReflectionClass<any> | undefined;\n    if (\n      reflection.getParameters().length > 0 &&\n      reflection.getParameters()[0]\n    ) {\n      const optionsType = reflection.getParameters()[0]!.type;\n      if (optionsType.kind === ReflectionKind.objectLiteral) {\n        optionsReflection = resolveClassType(optionsType);\n      }\n    }\n\n    const deserializedNode: CommandTree = {\n      ...node,\n      options: optionsReflection\n        ? Object.entries(node.options).reduce(\n            (ret, [key, option]) => {\n              ret[key] = {\n                ...option,\n                reflection: optionsReflection.getProperty(option.name)\n              } as CommandOption;\n              return ret;\n            },\n            {} as Record<string, CommandOption>\n          )\n        : {},\n      path: {\n        ...node.path,\n        dynamics: Object.entries(node.path.dynamics).reduce(\n          (ret, [key, dynamic]) => {\n            ret[key] = {\n              ...dynamic,\n              reflection: reflection.getParameter(dynamic.name)\n            } as CommandDynamicSegment;\n            return ret;\n          },\n          {} as Record<string, CommandDynamicSegment>\n        )\n      },\n      params: node.params.map(param => ({\n        ...param,\n        reflection: reflection.getParameter(param.name)\n      })) as CommandParameter[],\n      parent,\n      children: {},\n      reflection\n    };\n\n    for (const [key, child] of Object.entries(node.children || {})) {\n      deserializedNode.children[key] = deserialize(child, deserializedNode);\n    }\n\n    return deserializedNode;\n  };\n\n  const result: Record<string, CommandTree> = {};\n  for (const [key, child] of Object.entries(serializedCommands)) {\n    result[key] = deserialize(child, null);\n  }\n\n  return result;\n}\n\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = deserializeCommandTree(JSON.parse(reflections));\n}\n\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      serializedCommandTree(context.commands),\n      null,\n      context.config.mode === \"development\" ? 2 : 0\n    )\n  );\n}\n"],"mappings":"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"}

package/dist/helpers/resolve-command.cjs

@@ -30,8 +30,21 @@ let powerlines_lib_utilities_resolve = require("powerlines/lib/utilities/resolve
 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.`;
 }
+/**
+* Resolves the description for a command parameter based on its reflection.
+*
+* @param kind - The reflection kind of the command parameter.
+* @param optional - Whether the command parameter is optional.
+* @param name - The name of the command parameter.
+* @param title - The title of the command parameter, if any.
+* @param defaultValue - The default value of the command parameter, if any.
+* @returns The resolved description for the command parameter.
+*/
+function resolveCommandParameterDescription(kind, optional, name, title, defaultValue) {
+	return `A${optional && !defaultValue ? "n optional" : ""} command-line positional parameter 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.isPositionalCommandOption(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.isDynamicPathSegment(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
 }
 /**
 * Finds the command name from the given file path.
@@ -42,14 +55,14 @@ 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.isPositionalCommandOption(name)) {
+	while (require_plugin_utils_context_helpers.isDynamicPathSegment(name)) {
 		path = (0, __stryke_path_resolve_parent_path.resolveParentPath)(path);
 		name = (0, __stryke_path_file_path_fns.findFolderName)(path, { requireExtension: true });
 	}
 	return name;
 }
 function resolveCommandPath(context, file) {
-	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "");
+	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").split("/").filter((path) => path && !require_plugin_utils_context_helpers.isPathSegmentGroup(path)).join("/");
 }
 function findCommandsRoot(context) {
 	if ((0, __stryke_type_checks_is_set_string.isSetString)(context.config.entry)) return (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)(context.config.entry), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
@@ -65,50 +78,81 @@ function findCommandsRoot(context) {
 * @returns The extracted command option information.
 */
 function extractCommandOption(command, reflection) {
-	const propertyType = reflection.getType();
+	const type = 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,
+		kind: type.kind,
 		optional: reflection.isOptional(),
 		default: reflection.getDefaultValue(),
-		variadic: false
+		variadic: reflection.isArray(),
+		reflection
 	};
-	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) {
+	if (reflection.isArray()) if (type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.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 ")}.`);
+		option.kind = type.type.kind;
+	} else throw new Error(`Unsupported array type for option "${reflection.getNameAsString()}" in command "${command.name}". Only string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (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 "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
 	return option;
 }
 /**
-* Extracts command parameter information from a type parameter reflection.
+* Extracts command dynamic path segment 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.
+* @returns The extracted command dynamic segment 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 ")}.`);
+function extractCommandDynamicSegment(command, segment, reflection) {
+	const type = reflection.getType();
+	if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && !(type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array && type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string)) throw new Error(`Unsupported type for dynamic path segment "${segment}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(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
+		name: reflection.getName(),
+		segment,
+		title: reflection.getTags().title || (0, __stryke_string_format_title_case.titleCase)(segment),
+		description: reflection.parameter.description || resolveCommandOptionDescription(type.kind, !!reflection.isOptional(), segment, (0, __stryke_string_format_title_case.titleCase)(segment), reflection.getDefaultValue()),
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		catchAll: command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isCatchAllPathSegment(seg)),
+		reflection
 	};
-	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) {
+	if (type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) {
+		if (!option.catchAll) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" is an array type but is not defined as a catch-all segment. To use an array type for a dynamic path segment, it must be defined as a catch-all segment using the "[...segment]" syntax.`);
 		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.`);
+	}
+	if (option.catchAll) {
+		if (!option.optional && command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isOptionalCatchAllPathSegment(seg))) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" is defined as a catch-all segment but is not optional. To define an optional catch-all segment, use the "[[...segment]]" syntax.`);
+		else if (option.optional && !command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isOptionalCatchAllPathSegment(seg))) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" is defined as an optional segment but is not defined as an optional catch-all segment. To define an optional catch-all segment, use the "[[...segment]]" syntax.`);
+	}
+	return option;
+}
+/**
+* Extracts command positional parameter information from a type parameter reflection.
+*
+* @param command - The command tree to which the parameter belongs.
+* @param reflection - The type parameter reflection to extract information from.
+* @returns The extracted command positional parameter information.
+*/
+function extractCommandParameter(command, reflection) {
+	const type = reflection.getType();
+	if (type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number && type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean && !(type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array && (type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number))) throw new Error(`Unsupported type for positional parameter "${reflection.getName()}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	const option = {
+		name: reflection.getName(),
+		title: (0, __stryke_string_format_title_case.titleCase)(reflection.getName()),
+		description: reflection.parameter.description || resolveCommandParameterDescription(type.kind, !!reflection.isOptional(), reflection.getName(), (0, __stryke_string_format_title_case.titleCase)(reflection.getName()), reflection.getDefaultValue()),
+		env: (0, __stryke_string_format_constant_case.constantCase)(reflection.getName()),
+		optional: reflection.isOptional(),
+		default: reflection.getDefaultValue(),
+		reflection
+	};
+	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) {
+		option.variadic = true;
+		option.kind = type.type.kind;
+	} else throw new Error(`Unsupported array type for positional parameter "${reflection.getName()}" in command "${command.name}". Only string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
+	else if (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 parameter "${reflection.getName()}" in command "${command.name}". Only string, number, boolean, string[] and number[] are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(type).trim().replaceAll(" | ", ", or ")}.`);
 	return option;
 }
 /**
@@ -127,11 +171,13 @@ async function reflectCommandTree(context, command, parent) {
 		title,
 		path: {
 			...command.path,
-			positional: {}
+			dynamics: {}
 		},
 		options: require_utilities.getDefaultOptions(context, command),
+		params: [],
 		parent: parent ?? null,
-		children: {}
+		children: {},
+		reflection: null
 	};
 	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}"`);
@@ -144,24 +190,27 @@ async function reflectCommandTree(context, command, parent) {
 		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);
+		if ((0, __stryke_type_checks_is_set_string.isSetString)(metadata.icon)) tree.icon = metadata.icon;
 		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);
+		tree.reflection = new __powerlines_deepkit_vendor_type.ReflectionFunction(type);
+		tree.description ??= command.description || type.description || `The ${tree.title} executable command line interface.`;
+		const parameters = tree.reflection.getParameters();
+		if (parameters.length > 0 && parameters[0]) {
+			if (parameters[0].type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral || parameters[0].type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.class) {
+				const optionsReflection = __powerlines_deepkit_vendor_type.ReflectionClass.from(parameters[0].type);
 				for (const propertyReflection of optionsReflection.getProperties()) tree.options[propertyReflection.getNameAsString()] = extractCommandOption(command, propertyReflection);
-			}
-			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.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.`;
+			} else throw new Error(`The first parameter of the command handler function in "${command.entry.input.file}" must be an object literal or class type representing the command options.`);
+			tree.path.dynamics = tree.path.segments.filter((segment) => require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).reduce((obj, segment, index) => {
+				if (parameters.length < index + 2 || !parameters[index + 1]) return obj;
+				const paramName = require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment);
+				obj[paramName] = extractCommandDynamicSegment(command, paramName, parameters[index + 1]);
+				obj[paramName].description = obj[paramName].description || `The ${paramName} ${obj[paramName].catchAll ? `${obj[paramName].optional ? "optional " : ""}catch-all` : "dynamic "} segment for the ${command.name} command.`;
 				return obj;
 			}, {});
+			if (parameters.length > Object.keys(tree.path.dynamics).length + 1) tree.params = parameters.slice(Object.keys(tree.path.dynamics).length + 1).map((param) => extractCommandParameter(command, 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.`;
+	} 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({
@@ -169,32 +218,33 @@ async function reflectCommandTree(context, command, parent) {
 				optional: option.optional ? true : void 0,
 				description: option.description,
 				visibility: __powerlines_deepkit_vendor_type.ReflectionVisibility.public,
-				type: option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || option.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? option.variadic ? {
+				type: option.reflection?.getType() ?? (option.variadic ? {
 					kind: __powerlines_deepkit_vendor_type.ReflectionKind.array,
 					type: { kind: option.kind }
-				} : { kind: option.kind } : { kind: __powerlines_deepkit_vendor_type.ReflectionKind.boolean },
+				} : { kind: option.kind }),
 				default: option.default,
 				tags: {
+					...option.reflection?.getTags(),
 					title: option.title,
 					alias: option.alias.filter((alias) => alias.length > 0).map((alias) => (0, __stryke_string_format_constant_case.constantCase)(alias)),
 					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,
+		Object.values(tree.params).filter((param) => param.env !== false).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: 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" }
+			type: param.reflection.getType(),
+			default: param.default,
+			tags: {
+				...param.reflection.getTags(),
+				domain: "cli"
+			}
 		}));
 	}
-	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);
+	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).length === command.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(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;
 }