@shell-shock/core 0.2.1 → 0.3.0

package/dist/contexts/command.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.cjs","names":["createNamedContext","useContext","CommandContext","useCommand"],"sources":["../../src/contexts/command.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 type { CommandTree } from \"../types/command\";\n\n/**\n * The reflection parameter context used in template rendering.\n */\nexport const CommandContext: ComponentContext<CommandTree | undefined> =\n  createNamedContext<CommandTree | undefined>(\"Command\");\n\n/**\n * Hook to access the Command context.\n *\n * @returns A reactive version of the current reflection.\n */\nexport function useCommand() {\n  return useContext<CommandTree | undefined>(CommandContext)!;\n}\n"],"mappings":";;;;;;;AAyBA,MAAaE,yDACiC,UAAU;;;;;;AAOxD,SAAgBC,aAAa;AAC3B,wCAA2CD,eAAe"}

package/dist/contexts/command.d.cts

@@ -0,0 +1,18 @@
+import { CommandTree } from "../types/command.cjs";
+import { ComponentContext } from "@alloy-js/core";
+
+//#region src/contexts/command.d.ts
+
+/**
+ * The reflection parameter context used in template rendering.
+ */
+declare const CommandContext: ComponentContext<CommandTree | undefined>;
+/**
+ * Hook to access the Command context.
+ *
+ * @returns A reactive version of the current reflection.
+ */
+declare function useCommand(): CommandTree;
+//#endregion
+export { CommandContext, useCommand };
+//# sourceMappingURL=command.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.cts","names":[],"sources":["../../src/contexts/command.ts"],"sourcesContent":[],"mappings":";;;;;;;AAyBA;AAQgB,cARH,cAQa,EARG,gBAQH,CARoB,WAQpB,GAAA,SAAA,CAAA;;;;;;iBAAV,UAAA,CAAA,GAAU"}

package/dist/contexts/command.d.mts

@@ -0,0 +1,18 @@
+import { CommandTree } from "../types/command.mjs";
+import { ComponentContext } from "@alloy-js/core";
+
+//#region src/contexts/command.d.ts
+
+/**
+ * The reflection parameter context used in template rendering.
+ */
+declare const CommandContext: ComponentContext<CommandTree | undefined>;
+/**
+ * Hook to access the Command context.
+ *
+ * @returns A reactive version of the current reflection.
+ */
+declare function useCommand(): CommandTree;
+//#endregion
+export { CommandContext, useCommand };
+//# sourceMappingURL=command.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.mts","names":[],"sources":["../../src/contexts/command.ts"],"sourcesContent":[],"mappings":";;;;;;;AAyBA;AAQgB,cARH,cAQa,EARG,gBAQH,CARoB,WAQpB,GAAA,SAAA,CAAA;;;;;;iBAAV,UAAA,CAAA,GAAU"}

package/dist/contexts/command.mjs

@@ -0,0 +1,19 @@
+import { createNamedContext, useContext } from "@alloy-js/core";
+
+//#region src/contexts/command.ts
+/**
+* The reflection parameter context used in template rendering.
+*/
+const CommandContext = createNamedContext("Command");
+/**
+* Hook to access the Command context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useCommand() {
+	return useContext(CommandContext);
+}
+
+//#endregion
+export { CommandContext, useCommand };
+//# sourceMappingURL=command.mjs.map

package/dist/contexts/command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.mjs","names":["createNamedContext","useContext","CommandContext","useCommand"],"sources":["../../src/contexts/command.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 type { CommandTree } from \"../types/command\";\n\n/**\n * The reflection parameter context used in template rendering.\n */\nexport const CommandContext: ComponentContext<CommandTree | undefined> =\n  createNamedContext<CommandTree | undefined>(\"Command\");\n\n/**\n * Hook to access the Command context.\n *\n * @returns A reactive version of the current reflection.\n */\nexport function useCommand() {\n  return useContext<CommandTree | undefined>(CommandContext)!;\n}\n"],"mappings":";;;;;;AAyBA,MAAaE,iBACXF,mBAA4C,UAAU;;;;;;AAOxD,SAAgBG,aAAa;AAC3B,QAAOF,WAAoCC,eAAe"}

package/dist/contexts/index.cjs

@@ -0,0 +1,4 @@
+const require_contexts_command = require('./command.cjs');
+
+exports.CommandContext = require_contexts_command.CommandContext;
+exports.useCommand = require_contexts_command.useCommand;

package/dist/contexts/index.d.cts

@@ -0,0 +1,2 @@
+import { CommandContext, useCommand } from "./command.cjs";
+export { CommandContext, useCommand };

package/dist/contexts/index.d.mts

@@ -0,0 +1,2 @@
+import { CommandContext, useCommand } from "./command.mjs";
+export { CommandContext, useCommand };

package/dist/contexts/index.mjs

@@ -0,0 +1,3 @@
+import { CommandContext, useCommand } from "./command.mjs";
+
+export { CommandContext, useCommand };

package/dist/helpers/docs-helpers.cjs

@@ -0,0 +1,17 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __stryke_path_join = require("@stryke/path/join");
+
+//#region src/helpers/docs-helpers.ts
+/**
+* Gets the output path for the generated documentation.
+*
+* @param context - The Shell Shock context.
+* @returns The output path for the generated documentation.
+*/
+function getDocsOutputPath(context) {
+	return (0, __stryke_path_join.joinPaths)(context.config.projectRoot, "docs", "generated");
+}
+
+//#endregion
+exports.getDocsOutputPath = getDocsOutputPath;
+//# sourceMappingURL=docs-helpers.cjs.map

package/dist/helpers/docs-helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-helpers.cjs","names":["joinPaths","getDocsOutputPath","context","config","projectRoot"],"sources":["../../src/helpers/docs-helpers.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\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Gets the output path for the generated documentation.\n *\n * @param context - The Shell Shock context.\n * @returns The output path for the generated documentation.\n */\nexport function getDocsOutputPath(context: Context): string {\n  return joinPaths(context.config.projectRoot, \"docs\", \"generated\");\n}\n"],"mappings":";;;;;;;;;;AA2BA,SAAgBC,kBAAkBC,SAA0B;AAC1D,0CAAiBA,QAAQC,OAAOC,aAAa,QAAQ,YAAY"}

package/dist/helpers/docs-helpers.mjs

@@ -0,0 +1,16 @@
+import { joinPaths } from "@stryke/path/join";
+
+//#region src/helpers/docs-helpers.ts
+/**
+* Gets the output path for the generated documentation.
+*
+* @param context - The Shell Shock context.
+* @returns The output path for the generated documentation.
+*/
+function getDocsOutputPath(context) {
+	return joinPaths(context.config.projectRoot, "docs", "generated");
+}
+
+//#endregion
+export { getDocsOutputPath };
+//# sourceMappingURL=docs-helpers.mjs.map

package/dist/helpers/docs-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-helpers.mjs","names":["joinPaths","getDocsOutputPath","context","config","projectRoot"],"sources":["../../src/helpers/docs-helpers.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\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Gets the output path for the generated documentation.\n *\n * @param context - The Shell Shock context.\n * @returns The output path for the generated documentation.\n */\nexport function getDocsOutputPath(context: Context): string {\n  return joinPaths(context.config.projectRoot, \"docs\", \"generated\");\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgBC,kBAAkBC,SAA0B;AAC1D,QAAOF,UAAUE,QAAQC,OAAOC,aAAa,QAAQ,YAAY"}

package/dist/helpers/persistence.cjs

@@ -46,4 +46,5 @@ async function writeCommandsPersistence(context) {
 //#endregion
 exports.getCommandsPersistencePath = getCommandsPersistencePath;
 exports.readCommandsPersistence = readCommandsPersistence;
-exports.writeCommandsPersistence = writeCommandsPersistence;
+exports.writeCommandsPersistence = writeCommandsPersistence;
+//# sourceMappingURL=persistence.cjs.map

package/dist/helpers/persistence.cjs.map

@@ -0,0 +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"}

package/dist/helpers/persistence.mjs

@@ -43,4 +43,5 @@ async function writeCommandsPersistence(context) {
 }
 
 //#endregion
-export { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence };
+export { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence };
+//# sourceMappingURL=persistence.mjs.map

package/dist/helpers/persistence.mjs.map

@@ -0,0 +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"}

package/dist/helpers/resolve-command.cjs

@@ -1,19 +1,47 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
+const require_utilities = require('./utilities.cjs');
 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");
 let __stryke_path_resolve_parent_path = require("@stryke/path/resolve-parent-path");
-let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
-let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let __stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
 let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
-let __powerlines_deepkit_reflect_type = require("@powerlines/deepkit/reflect-type");
+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 __stryke_path_common = require("@stryke/path/common");
 let __stryke_path_normalize = require("@stryke/path/normalize");
-let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 
 //#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.
+* @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 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("/", "-");
+}
+/**
+* Finds the command name from the given file path.
+*
+* @param file - The file path to extract the command name from.
+* @returns The command name.
+*/
+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)) {
+		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, "");
 }
@@ -24,35 +52,46 @@ function findCommandsRoot(context) {
 	return (0, __stryke_path_append.appendPath)(context.config.sourceRoot || context.config.projectRoot, context.workspaceConfig.workspaceRoot);
 }
 /**
-* Finds the command name from the given file path.
+* Extracts command parameter information from a type parameter reflection.
 *
-* @param file - The file path to extract the command name from.
-* @returns The command name.
+* @param param - The type parameter reflection to extract information from.
+* @returns The extracted command parameter information.
 */
-function findCommandName(file) {
-	let name = (0, __stryke_path_file_path_fns.findFolderName)(file);
-	let count = 1;
-	while (name.startsWith("[") && name.endsWith("]")) name = (0, __stryke_path_file_path_fns.findFolderName)((0, __stryke_path_resolve_parent_path.resolveParentPath)(file, count++));
-	return name;
+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
+	};
 }
+/**
+* Reflects the command tree for a given command input.
+*
+* @param context - The context in which the command is being reflected.
+* @param command - The command input to reflect.
+* @param parent - The parent command tree, if any.
+* @returns The reflected command tree.
+*/
 async function reflectCommandTree(context, command, parent) {
-	const title = command.title || `${parent?.title ? `${parent.title} - ` : ""}${(0, __stryke_string_format_title_case.titleCase)(command.name)}`;
-	const commandTree = {
+	const title = command.title || `${parent?.title ? `${parent.title} - ` : ""}${(0, __stryke_string_format_title_case.titleCase)(command.name)}${command.isVirtual ? " Commands" : ""}`;
+	const tree = {
 		...command,
 		title,
-		description: command.description || `The ${title} ${parent ? "sub-" : ""}command.`,
-		options: {},
+		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: {}
+		},
+		options: require_utilities.getDefaultOptions(context, command),
 		params: [],
 		parent: parent ?? null,
 		children: {}
 	};
-	if (context.config.defaultOptions === false) commandTree.options = {};
-	else if (Array.isArray(context.config.defaultOptions)) commandTree.options = Object.fromEntries((0, __stryke_helpers_get_unique.getUniqueBy)(context.config.defaultOptions, (item) => item.name).map((option) => [option.name, option]));
-	else if ((0, __stryke_type_checks_is_function.isFunction)(context.config.defaultOptions)) commandTree.options = Object.fromEntries((0, __stryke_helpers_get_unique.getUniqueBy)(context.config.defaultOptions(context, command), (item) => item.name).map((option) => [option.name, option]));
-	if (command.isVirtual) context.trace(`Adding reflection for virtual command: ${command.id}`);
-	else {
+	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.trace(`Adding reflection for user-defined command: ${command.id} (file: ${command.entry.input.file})`);
+		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);
 		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.`);
 		if (type.parameters.length > 0 && type.parameters[0]) {
@@ -61,32 +100,78 @@ async function reflectCommandTree(context, command, parent) {
 				const optionsReflection = __powerlines_deepkit_vendor_type.ReflectionClass.from(firstParam.type);
 				for (const propertyReflection of optionsReflection.getProperties()) {
 					const propertyType = propertyReflection.getType();
-					commandTree.options[propertyReflection.getNameAsString()] = {
+					tree.options[propertyReflection.getNameAsString()] = {
 						name: propertyReflection.getNameAsString(),
 						alias: propertyReflection.getTags().alias ?? [],
-						title: propertyReflection.getTags().title || (0, __stryke_string_format_title_case.titleCase)(propertyReflection.getNameAsString()),
-						description: propertyReflection.getDescription(),
+						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
 					};
-					commandTree.options[propertyReflection.getNameAsString()].description ??= `The ${commandTree.options[propertyReflection.getNameAsString()].title} option.`;
 					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) {
-						commandTree.options[propertyReflection.getNameAsString()].variadic = true;
-						commandTree.options[propertyReflection.getNameAsString()].kind = propertyType.type.kind;
+						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 ")}.`);
 				}
 			}
+			tree.path.variables = tree.path.segments.filter((segment) => require_plugin_utils_context_helpers.isVariableCommandPath(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.`;
+				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));
+			});
 		}
 	}
-	for (const input of context.inputs.filter((input$1) => input$1.path.length === command.path.length + 1 && input$1.path.slice(0, command.path.length).every((value, index) => value === command.path[index]))) commandTree.children[input.name] = await reflectCommandTree(context, input, commandTree);
-	return commandTree;
+	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({
+				name: option.env,
+				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 ? {
+					kind: __powerlines_deepkit_vendor_type.ReflectionKind.array,
+					type: { kind: option.kind }
+				} : { kind: option.kind } : { kind: __powerlines_deepkit_vendor_type.ReflectionKind.boolean },
+				default: option.default,
+				tags: {
+					title: option.title,
+					alias: option.alias.filter((alias) => alias.length > 0).map((alias) => (0, __stryke_string_format_constant_case.constantCase)(alias)),
+					domain: "cli"
+				}
+			});
+		});
+		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" }
+			});
+		});
+	}
+	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);
+	return tree;
 }
 
 //#endregion
-exports.findCommandName = findCommandName;
 exports.findCommandsRoot = findCommandsRoot;
 exports.reflectCommandTree = reflectCommandTree;
-exports.resolveCommandPath = resolveCommandPath;
+exports.resolveCommandId = resolveCommandId;
+exports.resolveCommandName = resolveCommandName;
+exports.resolveCommandPath = resolveCommandPath;
+//# sourceMappingURL=resolve-command.cjs.map

package/dist/helpers/resolve-command.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-command.cjs","names":["reflectType","ReflectionClass","ReflectionKind","ReflectionVisibility","stringifyType","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","getAppTitle","getVariableCommandPathName","isVariableCommandPath","getDefaultOptions","resolveCommandDescription","propertyReflection","getDescription","trim","isOptional","getDefaultValue","getType","kind","boolean","array","getTags","title","getNameAsString","number","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","name","requireExtension","resolveCommandPath","resolveCommandParams","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandParameters","param","description","optional","variadic","type","default","reflectCommandTree","command","parent","isVirtual","tree","variables","options","params","children","input","fs","existsSync","Error","debug","id","function","parameters","firstParam","objectLiteral","class","optionsReflection","from","getProperties","propertyType","alias","env","string","segments","segment","reduce","obj","index","paramName","slice","forEach","push","Object","values","option","types","addProperty","undefined","visibility","public","tags","domain","inputs","every","value"],"sources":["../../src/helpers/resolve-command.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 { reflectType } from \"@powerlines/deepkit/reflect-type\";\nimport type {\n  ReflectionProperty,\n  TypeParameter\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  ReflectionClass,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { stripStars } from \"@stryke/path/normalize\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport {\n  getAppTitle,\n  getVariableCommandPathName,\n  isVariableCommandPath\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandInput,\n  CommandParam,\n  CommandTree,\n  NumberCommandOption,\n  StringCommandOption\n} from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { getDefaultOptions } from \"./utilities\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param propertyReflection - The reflection property of the command option.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandDescription(\n  propertyReflection: ReflectionProperty\n): string {\n  return (\n    propertyReflection.getDescription()?.trim() ||\n    `A${\n      propertyReflection.isOptional() && !propertyReflection.getDefaultValue()\n        ? \"n optional\"\n        : \"\"\n    } ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"flag provided via the command-line\"\n        : \"command-line option\"\n    } that allows the user to ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"set the\"\n        : propertyReflection.getType().kind === ReflectionKind.array\n          ? \"specify custom\"\n          : \"specify a custom\"\n    } ${\n      propertyReflection.getTags().title?.trim() ||\n      titleCase(propertyReflection.getNameAsString())\n    } ${\n      propertyReflection.getType().kind === ReflectionKind.boolean\n        ? \"indicator\"\n        : `${propertyReflection.getType().kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n            propertyReflection.getType().kind === ReflectionKind.array\n              ? \"s\"\n              : \"\"\n          }`\n    } that will be used in the application.`\n  );\n}\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isVariableCommandPath(p))\n    .join(\"/\")\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .replaceAll(\"/\", \"-\");\n}\n\n/**\n * Finds the command name from the given file path.\n *\n * @param file - The file path to extract the command name from.\n * @returns The command name.\n */\nexport function resolveCommandName(file: string) {\n  let path = findFilePath(file);\n  let name = findFolderName(file, {\n    requireExtension: true\n  });\n\n  while (isVariableCommandPath(name)) {\n    path = resolveParentPath(path);\n    name = findFolderName(path, {\n      requireExtension: true\n    });\n  }\n\n  return name;\n}\n\nexport function resolveCommandPath(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\");\n}\n\nexport function resolveCommandParams(context: Context, file: string): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && isVariableCommandPath(p))\n    .map(p => p.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\"));\n}\n\nexport function findCommandsRoot(context: Context): string {\n  if (isSetString(context.config.entry)) {\n    return appendPath(\n      appendPath(stripStars(context.config.entry), context.config.projectRoot),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    isSetObject(context.config.entry) &&\n    \"file\" in context.config.entry\n  ) {\n    return appendPath(\n      appendPath(\n        stripStars(context.config.entry.file),\n        context.config.projectRoot\n      ),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    Array.isArray(context.config.entry) &&\n    context.config.entry.length > 0\n  ) {\n    return commonPath(\n      context.config.entry.map(entry =>\n        appendPath(\n          appendPath(\n            stripStars(isSetString(entry) ? entry : entry.file),\n            context.config.projectRoot\n          ),\n          context.workspaceConfig.workspaceRoot\n        )\n      )\n    );\n  }\n\n  return appendPath(\n    context.config.sourceRoot || context.config.projectRoot,\n    context.workspaceConfig.workspaceRoot\n  );\n}\n\n/**\n * Extracts command parameter information from a type parameter reflection.\n *\n * @param param - The type parameter reflection to extract information from.\n * @returns The extracted command parameter information.\n */\nexport function extractCommandParameters(param: TypeParameter): CommandParam {\n  return {\n    name: param.name,\n    description: param.description,\n    optional: !!param.optional,\n    variadic: param.type.kind === ReflectionKind.array,\n    default: param.default\n  } as CommandParam;\n}\n\n/**\n * Reflects the command tree for a given command input.\n *\n * @param context - The context in which the command is being reflected.\n * @param command - The command input to reflect.\n * @param parent - The parent command tree, if any.\n * @returns The reflected command tree.\n */\nexport async function reflectCommandTree<TContext extends Context = Context>(\n  context: TContext,\n  command: CommandInput,\n  parent?: CommandTree\n): Promise<CommandTree> {\n  const title =\n    command.title ||\n    `${parent?.title ? `${parent.title} - ` : \"\"}${titleCase(command.name)}${\n      command.isVirtual ? \" Commands\" : \"\"\n    }`;\n\n  const tree = {\n    ...command,\n    title,\n    description:\n      command.description ||\n      (command.isVirtual\n        ? `A collection of available ${command.title || titleCase(command.name)} commands that are included in the ${getAppTitle(\n            context\n          )} command-line application.`\n        : `The ${title} executable command-line interface.`),\n    path: {\n      ...command.path,\n      variables: {}\n    },\n    options: getDefaultOptions(context, command),\n    params: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    const type = await reflectType<TContext>(context, command.entry.input);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `The command entry file \"${command.entry.input.file}\" does not export a valid function.`\n      );\n    }\n\n    if (type.parameters.length > 0 && type.parameters[0]) {\n      const firstParam = type.parameters[0];\n      if (\n        firstParam.type.kind === ReflectionKind.objectLiteral ||\n        firstParam.type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(firstParam.type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          const propertyType = propertyReflection.getType();\n\n          tree.options[propertyReflection.getNameAsString()] = {\n            name: propertyReflection.getNameAsString(),\n            alias: propertyReflection.getTags().alias ?? [],\n            title:\n              propertyReflection.getTags().title?.trim() ||\n              titleCase(propertyReflection.getNameAsString()),\n            description: resolveCommandDescription(propertyReflection),\n            env: constantCase(propertyReflection.getNameAsString()),\n            kind: propertyType.kind as\n              | ReflectionKind.string\n              | ReflectionKind.number\n              | ReflectionKind.boolean,\n            optional: propertyReflection.isOptional(),\n            default: propertyReflection.getDefaultValue(),\n            variadic: false\n          };\n          if (propertyType.kind === ReflectionKind.array) {\n            if (\n              propertyType.type.kind === ReflectionKind.string ||\n              propertyType.type.kind === ReflectionKind.number\n            ) {\n              (\n                tree.options[propertyReflection.getNameAsString()] as\n                  | StringCommandOption\n                  | NumberCommandOption\n              ).variadic = true;\n              (\n                tree.options[propertyReflection.getNameAsString()] as\n                  | StringCommandOption\n                  | NumberCommandOption\n              ).kind = propertyType.type.kind;\n            } else {\n              throw new Error(\n                `Unsupported array type for option \"${propertyReflection.getNameAsString()}\" in command \"${\n                  command.name\n                }\". Only string[] and number[] are supported.`\n              );\n            }\n          } else if (\n            propertyType.kind !== ReflectionKind.boolean &&\n            propertyType.kind !== ReflectionKind.string &&\n            propertyType.kind !== ReflectionKind.number\n          ) {\n            throw new Error(\n              `Unsupported type for option \"${propertyReflection.getNameAsString()}\" in command \"${\n                command.name\n              }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n                propertyType\n              )\n                .trim()\n                .replaceAll(\" | \", \", or \")}.`\n            );\n          }\n        }\n      }\n\n      tree.path.variables = tree.path.segments\n        .filter(segment => isVariableCommandPath(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (\n              type.parameters.length < index + 2 ||\n              !type.parameters[index + 1]\n            ) {\n              return obj;\n            }\n\n            const paramName = getVariableCommandPathName(segment);\n            obj[paramName] = extractCommandParameters(\n              type.parameters[index + 1]!\n            );\n            obj[paramName].description =\n              obj[paramName].description ||\n              `The ${paramName} variable for the ${command.name} command.`;\n\n            return obj;\n          },\n          {} as Record<string, CommandParam>\n        );\n\n      if (type.parameters.length > 1) {\n        type.parameters\n          .slice(\n            tree.path.segments.filter(segment => isVariableCommandPath(segment))\n              .length + 1\n          )\n          .forEach(param => {\n            tree.params.push(extractCommandParameters(param));\n          });\n      }\n    }\n  }\n\n  if (context.env) {\n    if (isSetObject(tree.options)) {\n      Object.values(tree.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type:\n              option.kind === ReflectionKind.string ||\n              option.kind === ReflectionKind.number\n                ? option.variadic\n                  ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                  : { kind: option.kind }\n                : { kind: ReflectionKind.boolean },\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    if (tree.params) {\n      tree.params.forEach(param => {\n        context.env.types.env.addProperty({\n          name: constantCase(param.name),\n          optional: param.optional ? true : undefined,\n          description: param.description,\n          visibility: ReflectionVisibility.public,\n          type: param.variadic\n            ? {\n                kind: ReflectionKind.array,\n                type: { kind: ReflectionKind.string }\n              }\n            : { kind: ReflectionKind.string },\n          default: param.default,\n          tags: {\n            domain: \"cli\"\n          }\n        });\n      });\n    }\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.path.segments.filter(segment => !isVariableCommandPath(segment))\n        .length ===\n        command.path.segments.filter(segment => !isVariableCommandPath(segment))\n          .length +\n          1 &&\n      input.path.segments\n        .slice(0, command.path.segments.length)\n        .every((value, index) => value === command.path.segments[index])\n  )) {\n    tree.children[input.name] = await reflectCommandTree(context, input, tree);\n  }\n\n  return tree;\n}\n"],"mappings":"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"}