@shell-shock/core 0.2.1 → 0.4.0

package/dist/components/docs.mjs

@@ -0,0 +1,171 @@
+import { CommandContext } from "../contexts/command.mjs";
+import { getDocsOutputPath } from "../helpers/docs-helpers.mjs";
+import { getAppBin, getVariableCommandPathName, isVariableCommandPath } from "../plugin-utils/context-helpers.mjs";
+import { sortOptions } from "../plugin-utils/reflect.mjs";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+import { For, Match, Show, Switch, code, memo as memo$1 } from "@alloy-js/core";
+import { Heading } from "@alloy-js/markdown";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { MarkdownFile } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
+import { MarkdownTable } from "@powerlines/plugin-alloy/markdown/components/markdown-table";
+import { joinPaths } from "@stryke/path/join";
+
+//#region src/components/docs.tsx
+/**
+* Generates the options markdown documentation for a command.
+*/
+function CommandOptionsDocs(props) {
+	const { command } = props;
+	if (Object.keys(command.options).length === 0) return code`This command does not have any options.`;
+	return createComponent(MarkdownTable, { get data() {
+		return sortOptions(Object.values(command.options)).map((option) => {
+			return {
+				name: option.name.trim(),
+				description: option.description.trim(),
+				defaultValue: option.default ? String(option.default)?.includes("\"") ? option.default : `\`${option.default}\`` : "",
+				required: option.optional || option.default ? "" : "✔"
+			};
+		});
+	} });
+}
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocsUsageExample(props) {
+	const { packageManager = "npm", command } = props;
+	const context = usePowerlines();
+	return [
+		createIntrinsic("hbr", {}),
+		code`\`\`\`bash `,
+		createIntrinsic("hbr", {}),
+		createComponent(Switch, { get children() {
+			return [
+				createComponent(Match, {
+					when: packageManager === "yarn",
+					children: `yarn exec `
+				}),
+				createComponent(Match, {
+					when: packageManager === "pnpm",
+					children: `pnpm exec `
+				}),
+				createComponent(Match, {
+					when: packageManager === "bun",
+					children: `bun x `
+				}),
+				createComponent(Match, {
+					"else": true,
+					children: `npx `
+				})
+			];
+		} }),
+		memo(() => `${getAppBin(context)} `),
+		createComponent(For, {
+			get each() {
+				return command.path.segments;
+			},
+			joiner: " ",
+			children: (segment) => isVariableCommandPath(segment) ? `<${command.path.variables[segment]?.variadic ? "..." : ""}${kebabCase(getVariableCommandPathName(segment))}>` : segment
+		}),
+		code` [options] `,
+		createIntrinsic("hbr", {}),
+		code`\`\`\``,
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Generates the markdown documentation for a command.
+*/
+function CommandDocs(props) {
+	const { levelOffset = 0, command, usageExamples } = props;
+	return [
+		createComponent(Heading, {
+			level: 1 + levelOffset,
+			get children() {
+				return command.title;
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		memo(() => code`${command.description}`),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		createComponent(Heading, {
+			level: 2 + levelOffset,
+			children: "Usage"
+		}),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		memo(() => code`The ${command.name} command can be executed using the following syntax: `),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			get when() {
+				return usageExamples && usageExamples.length > 0;
+			},
+			get fallback() {
+				return createComponent(CommandDocsUsageExample, {
+					packageManager: "npm",
+					command
+				});
+			},
+			get children() {
+				return createComponent(For, {
+					each: usageExamples,
+					hardline: true,
+					children: (packageManager) => createComponent(CommandDocsUsageExample, {
+						packageManager,
+						command
+					})
+				});
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		createComponent(Heading, {
+			level: 2 + levelOffset,
+			children: "Options"
+		}),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		memo(() => code`The following options are available for the ${command.name} command:`),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		createComponent(CommandOptionsDocs, { command }),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Generates the markdown documentation file for a command.
+*/
+function CommandDocsFile(props) {
+	const { levelOffset = 0, command, ...rest } = props;
+	const context = usePowerlines();
+	const usageExamples = memo$1(() => [
+		"npm",
+		"yarn",
+		"pnpm",
+		"bun"
+	]);
+	return createComponent(CommandContext.Provider, {
+		value: command,
+		get children() {
+			return createComponent(MarkdownFile, mergeProps({ get path() {
+				return joinPaths(getDocsOutputPath(context), `${command.path.value}.md`);
+			} }, rest, { get children() {
+				return createComponent(CommandDocs, {
+					levelOffset,
+					command,
+					get usageExamples() {
+						return usageExamples();
+					}
+				});
+			} }));
+		}
+	});
+}
+
+//#endregion
+export { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs };
+//# sourceMappingURL=docs.mjs.map

package/dist/components/docs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.mjs","names":["code","For","Match","memo","Show","Switch","Heading","usePowerlines","MarkdownFile","MarkdownTable","joinPaths","kebabCase","CommandContext","getDocsOutputPath","getAppBin","getVariableCommandPathName","isVariableCommandPath","sortOptions","CommandOptionsDocs","props","command","Object","keys","options","length","_$createComponent","data","values","map","option","name","trim","description","defaultValue","default","String","includes","required","optional","CommandDocsUsageExample","packageManager","context","_$createIntrinsic","children","when","_$memo","each","path","segments","joiner","segment","variables","variadic","CommandDocs","levelOffset","usageExamples","level","title","fallback","hardline","CommandDocsFile","rest","Provider","value","_$mergeProps"],"sources":["../../src/components/docs.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, For, Match, memo, Show, Switch } from \"@alloy-js/core\";\nimport { Heading } from \"@alloy-js/markdown\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { MarkdownFileProps } from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownFile } from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownTable } from \"@powerlines/plugin-alloy/markdown/components/markdown-table\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { CommandContext } from \"../contexts/command\";\nimport { getDocsOutputPath } from \"../helpers/docs-helpers\";\nimport {\n  getAppBin,\n  getVariableCommandPathName,\n  isVariableCommandPath\n} from \"../plugin-utils/context-helpers\";\nimport { sortOptions } from \"../plugin-utils/reflect\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nexport interface CommandOptionsDocsProps {\n  /**\n   * The command to generate options documentation for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the options markdown documentation for a command.\n */\nexport function CommandOptionsDocs(props: CommandOptionsDocsProps) {\n  const { command } = props;\n  if (Object.keys(command.options).length === 0) {\n    return code`This command does not have any options.`;\n  }\n\n  return (\n    <MarkdownTable\n      data={sortOptions(Object.values(command.options)).map(option => {\n        return {\n          name: option.name.trim(),\n          description: option.description.trim(),\n          defaultValue: option.default\n            ? String(option.default)?.includes('\"')\n              ? option.default\n              : `\\`${option.default}\\``\n            : \"\",\n          required: option.optional || option.default ? \"\" : \"✔\"\n        };\n      })}\n    />\n  );\n}\n\nexport interface CommandDocsUsageExampleProps {\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 command to generate the usage example for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the markdown documentation for a command.\n */\nexport function CommandDocsUsageExample(props: CommandDocsUsageExampleProps) {\n  const { packageManager = \"npm\", command } = props;\n\n  const context = usePowerlines<Context>();\n\n  return (\n    <>\n      <hbr />\n      {code`\\`\\`\\`bash `}\n      <hbr />\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      {`${getAppBin(context)} `}\n      <For each={command.path.segments} joiner=\" \">\n        {segment =>\n          isVariableCommandPath(segment)\n            ? `<${command.path.variables[segment]?.variadic ? \"...\" : \"\"}${kebabCase(\n                getVariableCommandPathName(segment)\n              )}>`\n            : segment\n        }\n      </For>\n      {code` [options] `}\n      <hbr />\n      {code`\\`\\`\\``}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandDocsProps {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  /**\n   * The command to generate options documentation for.\n   */\n  command: CommandTree;\n\n  /**\n   * Optional usage examples to include in the documentation.\n   *\n   * @defaultValue `[\"npm\"]`\n   */\n  usageExamples?: Required<CommandDocsUsageExampleProps>[\"packageManager\"][];\n}\n\n/**\n * Generates the markdown documentation for a command.\n */\nexport function CommandDocs(props: CommandDocsProps) {\n  const { levelOffset = 0, command, usageExamples } = props;\n\n  return (\n    <>\n      <Heading level={1 + levelOffset}>{command.title}</Heading>\n      <hbr />\n      <hbr />\n      {code`${command.description}`}\n      <hbr />\n      <hbr />\n      <Heading level={2 + levelOffset}>Usage</Heading>\n      <hbr />\n      <hbr />\n      {code`The ${command.name} command can be executed using the following syntax: `}\n      <hbr />\n      <hbr />\n      <Show\n        when={usageExamples && usageExamples.length > 0}\n        fallback={\n          <CommandDocsUsageExample packageManager=\"npm\" command={command} />\n        }>\n        <For each={usageExamples!} hardline>\n          {packageManager => (\n            <CommandDocsUsageExample\n              packageManager={packageManager}\n              command={command}\n            />\n          )}\n        </For>\n      </Show>\n      <hbr />\n      <hbr />\n      <Heading level={2 + levelOffset}>Options</Heading>\n      <hbr />\n      <hbr />\n      {code`The following options are available for the ${\n        command.name\n      } command:`}\n      <hbr />\n      <hbr />\n      <CommandOptionsDocs command={command} />\n      <hbr />\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandDocsFileProps extends Partial<MarkdownFileProps> {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  /**\n   * The command to generate documentation for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the markdown documentation file for a command.\n */\nexport function CommandDocsFile(props: CommandDocsFileProps) {\n  const { levelOffset = 0, command, ...rest } = props;\n\n  const context = usePowerlines<Context>();\n  const usageExamples = memo(\n    () => [\"npm\", \"yarn\", \"pnpm\", \"bun\"] as CommandDocsProps[\"usageExamples\"]\n  );\n\n  return (\n    <CommandContext.Provider value={command}>\n      <MarkdownFile\n        path={joinPaths(getDocsOutputPath(context), `${command.path.value}.md`)}\n        {...rest}>\n        <CommandDocs\n          levelOffset={levelOffset}\n          command={command}\n          usageExamples={usageExamples()}\n        />\n      </MarkdownFile>\n    </CommandContext.Provider>\n  );\n}\n"],"mappings":"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"}

package/dist/components/index.cjs

@@ -1,7 +1,6 @@
-const require_components_utils_builtin = require('./utils-builtin.cjs');
+const require_components_docs = require('./docs.cjs');
 
-exports.ArgsUtilities = require_components_utils_builtin.ArgsUtilities;
-exports.ColorSupportUtilities = require_components_utils_builtin.ColorSupportUtilities;
-exports.EnvSupportUtilities = require_components_utils_builtin.EnvSupportUtilities;
-exports.HyperlinkSupportUtilities = require_components_utils_builtin.HyperlinkSupportUtilities;
-exports.UtilsBuiltin = require_components_utils_builtin.UtilsBuiltin;
+exports.CommandDocs = require_components_docs.CommandDocs;
+exports.CommandDocsFile = require_components_docs.CommandDocsFile;
+exports.CommandDocsUsageExample = require_components_docs.CommandDocsUsageExample;
+exports.CommandOptionsDocs = require_components_docs.CommandOptionsDocs;

package/dist/components/index.d.cts

@@ -1,2 +1,2 @@
-import { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.cjs";
-export { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };
+import { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps } from "./docs.cjs";
+export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };

package/dist/components/index.d.mts

@@ -1,2 +1,2 @@
-import { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.mjs";
-export { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };
+import { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps } from "./docs.mjs";
+export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };

package/dist/components/index.mjs

@@ -1,3 +1,3 @@
-import { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin } from "./utils-builtin.mjs";
+import { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs } from "./docs.mjs";
 
-export { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin };
+export { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs };

package/dist/config.cjs

@@ -14,4 +14,5 @@ function defineConfig(config) {
 }
 
 //#endregion
-exports.defineConfig = defineConfig;
+exports.defineConfig = defineConfig;
+//# sourceMappingURL=config.cjs.map

package/dist/config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.cjs","names":["defineConfig","config"],"sources":["../src/config.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 { UserConfig } from \"./types/config\";\n\n/**\n * A utility function to define a Shell Shock user configuration.\n *\n * @remarks\n * This function is used to create a user configuration object for Shell Shock projects. It ensures that the configuration adheres to the expected structure.\n *\n * @param config - A partial user configuration object.\n * @returns A complete user configuration object.\n */\nexport function defineConfig(config: Partial<UserConfig>): UserConfig {\n  return config;\n}\n"],"mappings":";;;;;;;;;;;AA6BA,SAAgBA,aAAaC,QAAyC;AACpE,QAAOA"}

package/dist/config.d.cts

@@ -13,4 +13,5 @@ import { UserConfig } from "./types/config.cjs";
  */
 declare function defineConfig(config: Partial<UserConfig>): UserConfig;
 //#endregion
-export { defineConfig };
+export { defineConfig };
+//# sourceMappingURL=config.d.cts.map

package/dist/config.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;;AA6BA;;;;;;;iBAAgB,YAAA,SAAqB,QAAQ,cAAc"}

package/dist/config.d.mts

@@ -13,4 +13,5 @@ import { UserConfig } from "./types/config.mjs";
  */
 declare function defineConfig(config: Partial<UserConfig>): UserConfig;
 //#endregion
-export { defineConfig };
+export { defineConfig };
+//# sourceMappingURL=config.d.mts.map

package/dist/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;;AA6BA;;;;;;;iBAAgB,YAAA,SAAqB,QAAQ,cAAc"}

package/dist/config.mjs

@@ -13,4 +13,5 @@ function defineConfig(config) {
 }
 
 //#endregion
-export { defineConfig };
+export { defineConfig };
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":["defineConfig","config"],"sources":["../src/config.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 { UserConfig } from \"./types/config\";\n\n/**\n * A utility function to define a Shell Shock user configuration.\n *\n * @remarks\n * This function is used to create a user configuration object for Shell Shock projects. It ensures that the configuration adheres to the expected structure.\n *\n * @param config - A partial user configuration object.\n * @returns A complete user configuration object.\n */\nexport function defineConfig(config: Partial<UserConfig>): UserConfig {\n  return config;\n}\n"],"mappings":";;;;;;;;;;AA6BA,SAAgBA,aAAaC,QAAyC;AACpE,QAAOA"}

package/dist/contexts/command.cjs

@@ -0,0 +1,21 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core = require("@alloy-js/core");
+
+//#region src/contexts/command.ts
+/**
+* The reflection parameter context used in template rendering.
+*/
+const CommandContext = (0, __alloy_js_core.createNamedContext)("Command");
+/**
+* Hook to access the Command context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useCommand() {
+	return (0, __alloy_js_core.useContext)(CommandContext);
+}
+
+//#endregion
+exports.CommandContext = CommandContext;
+exports.useCommand = useCommand;
+//# sourceMappingURL=command.cjs.map

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

@@ -0,0 +1,59 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
+const require_components_docs = require('../components/docs.cjs');
+require('../plugin-utils/index.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core_components = require("@alloy-js/core/components");
+let __powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
+let __alloy_js_core = require("@alloy-js/core");
+let __alloy_js_markdown = require("@alloy-js/markdown");
+let automd = require("automd");
+
+//#region src/helpers/automd.tsx
+/**
+* AutoMD generator to generate CLI command documentation
+*
+* @see https://automd.unjs.io/
+*
+* @param context - The generator context.
+* @returns The generated documentation content.
+*/
+const commands = (context) => (0, automd.defineGenerator)({
+	name: "commands",
+	async generate() {
+		return { contents: (0, __powerlines_plugin_alloy_render.renderString)(context, [
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+				level: 2,
+				children: "Commands"
+			}),
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`The following commands are available in the ${require_plugin_utils_context_helpers.getAppTitle(context)} CLI application:`),
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core_components.For, {
+				get each() {
+					return Object.values(context.commands);
+				},
+				doubleHardline: true,
+				children: (child) => (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core_components.Show, {
+					get when() {
+						return !child.isVirtual;
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocs, {
+							command: child,
+							levelOffset: 2
+						});
+					}
+				})
+			}),
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+		]) };
+	}
+});
+
+//#endregion
+exports.commands = commands;
+//# sourceMappingURL=automd.cjs.map

package/dist/helpers/automd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"automd.cjs","names":["code","For","Show","Heading","renderString","defineGenerator","CommandDocs","getAppTitle","commands","context","name","generate","contents","_$createComponent","level","children","_$createIntrinsic","_$memo","each","Object","values","doubleHardline","child","when","isVirtual","command","levelOffset"],"sources":["../../src/helpers/automd.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 } from \"@alloy-js/core\";\nimport { For, Show } from \"@alloy-js/core/components\";\nimport { Heading } from \"@alloy-js/markdown\";\nimport { renderString } from \"@powerlines/plugin-alloy/render\";\nimport { defineGenerator } from \"automd\";\nimport { CommandDocs } from \"../components/docs\";\nimport { getAppTitle } from \"../plugin-utils\";\nimport type { Context } from \"../types/context\";\n\n/**\n * AutoMD generator to generate CLI command documentation\n *\n * @see https://automd.unjs.io/\n *\n * @param context - The generator context.\n * @returns The generated documentation content.\n */\nexport const commands = (context: Context) =>\n  defineGenerator({\n    name: \"commands\",\n    async generate() {\n      return {\n        contents: renderString(\n          context,\n          <>\n            <Heading level={2}>Commands</Heading>\n            <hbr />\n            <hbr />\n            {code`The following commands are available in the ${getAppTitle(\n              context\n            )} CLI application:`}\n            <hbr />\n            <hbr />\n            <For each={Object.values(context.commands)} doubleHardline>\n              {child => (\n                <Show when={!child.isVirtual}>\n                  <CommandDocs command={child} levelOffset={2} />\n                </Show>\n              )}\n            </For>\n            <hbr />\n            <hbr />\n          </>\n        )\n      };\n    }\n  });\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmCA,MAAaQ,YAAYC,wCACP;CACdC,MAAM;CACN,MAAMC,WAAW;AACf,SAAO,EACLC,6DACEH,SAAO;oDAEJN,6BAAO;IAACW,OAAO;IAACC,UAAA;IAAA,CAAA;oDAAA,OAAA,EAAA,CAAA;oDAAA,OAAA,EAAA,CAAA;+CAGhBf,oBAAI,+CAA+CO,iDAClDE,QACD,CAAA,mBAAmB;oDAAA,OAAA,EAAA,CAAA;oDAAA,OAAA,EAAA,CAAA;oDAGnBR,gCAAG;IAAA,IAACiB,OAAI;AAAA,YAAEC,OAAOC,OAAOX,QAAQD,SAAS;;IAAEa,gBAAc;IAAAN,WACvDO,2DACEpB,iCAAI;KAAA,IAACqB,OAAI;AAAA,aAAE,CAACD,MAAME;;KAAS,IAAAT,WAAA;AAAA,8DACzBT,qCAAW;OAACmB,SAASH;OAAOI,aAAa;OAAC,CAAA;;KAAA,CAAA;IAE9C,CAAA;oDAAA,OAAA,EAAA,CAAA;oDAAA,OAAA,EAAA,CAAA;GAKP,CAAA,EACD;;CAEJ,CAAC"}

package/dist/helpers/automd.mjs

@@ -0,0 +1,58 @@
+import { getAppTitle } from "../plugin-utils/context-helpers.mjs";
+import { CommandDocs } from "../components/docs.mjs";
+import "../plugin-utils/index.mjs";
+import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
+import { For, Show } from "@alloy-js/core/components";
+import { renderString } from "@powerlines/plugin-alloy/render";
+import { code } from "@alloy-js/core";
+import { Heading } from "@alloy-js/markdown";
+import { defineGenerator } from "automd";
+
+//#region src/helpers/automd.tsx
+/**
+* AutoMD generator to generate CLI command documentation
+*
+* @see https://automd.unjs.io/
+*
+* @param context - The generator context.
+* @returns The generated documentation content.
+*/
+const commands = (context) => defineGenerator({
+	name: "commands",
+	async generate() {
+		return { contents: renderString(context, [
+			createComponent(Heading, {
+				level: 2,
+				children: "Commands"
+			}),
+			createIntrinsic("hbr", {}),
+			createIntrinsic("hbr", {}),
+			memo(() => code`The following commands are available in the ${getAppTitle(context)} CLI application:`),
+			createIntrinsic("hbr", {}),
+			createIntrinsic("hbr", {}),
+			createComponent(For, {
+				get each() {
+					return Object.values(context.commands);
+				},
+				doubleHardline: true,
+				children: (child) => createComponent(Show, {
+					get when() {
+						return !child.isVirtual;
+					},
+					get children() {
+						return createComponent(CommandDocs, {
+							command: child,
+							levelOffset: 2
+						});
+					}
+				})
+			}),
+			createIntrinsic("hbr", {}),
+			createIntrinsic("hbr", {})
+		]) };
+	}
+});
+
+//#endregion
+export { commands };
+//# sourceMappingURL=automd.mjs.map

package/dist/helpers/automd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"automd.mjs","names":["code","For","Show","Heading","renderString","defineGenerator","CommandDocs","getAppTitle","commands","context","name","generate","contents","_$createComponent","level","children","_$createIntrinsic","_$memo","each","Object","values","doubleHardline","child","when","isVirtual","command","levelOffset"],"sources":["../../src/helpers/automd.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 } from \"@alloy-js/core\";\nimport { For, Show } from \"@alloy-js/core/components\";\nimport { Heading } from \"@alloy-js/markdown\";\nimport { renderString } from \"@powerlines/plugin-alloy/render\";\nimport { defineGenerator } from \"automd\";\nimport { CommandDocs } from \"../components/docs\";\nimport { getAppTitle } from \"../plugin-utils\";\nimport type { Context } from \"../types/context\";\n\n/**\n * AutoMD generator to generate CLI command documentation\n *\n * @see https://automd.unjs.io/\n *\n * @param context - The generator context.\n * @returns The generated documentation content.\n */\nexport const commands = (context: Context) =>\n  defineGenerator({\n    name: \"commands\",\n    async generate() {\n      return {\n        contents: renderString(\n          context,\n          <>\n            <Heading level={2}>Commands</Heading>\n            <hbr />\n            <hbr />\n            {code`The following commands are available in the ${getAppTitle(\n              context\n            )} CLI application:`}\n            <hbr />\n            <hbr />\n            <For each={Object.values(context.commands)} doubleHardline>\n              {child => (\n                <Show when={!child.isVirtual}>\n                  <CommandDocs command={child} levelOffset={2} />\n                </Show>\n              )}\n            </For>\n            <hbr />\n            <hbr />\n          </>\n        )\n      };\n    }\n  });\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmCA,MAAaQ,YAAYC,YACvBJ,gBAAgB;CACdK,MAAM;CACN,MAAMC,WAAW;AACf,SAAO,EACLC,UAAUR,aACRK,SAAO;GAAAI,gBAEJV,SAAO;IAACW,OAAO;IAACC,UAAA;IAAA,CAAA;GAAAC,gBAAA,OAAA,EAAA,CAAA;GAAAA,gBAAA,OAAA,EAAA,CAAA;GAAAC,WAGhBjB,IAAI,+CAA+CO,YAClDE,QACD,CAAA,mBAAmB;GAAAO,gBAAA,OAAA,EAAA,CAAA;GAAAA,gBAAA,OAAA,EAAA,CAAA;GAAAH,gBAGnBZ,KAAG;IAAA,IAACiB,OAAI;AAAA,YAAEC,OAAOC,OAAOX,QAAQD,SAAS;;IAAEa,gBAAc;IAAAN,WACvDO,UAAKT,gBACHX,MAAI;KAAA,IAACqB,OAAI;AAAA,aAAE,CAACD,MAAME;;KAAS,IAAAT,WAAA;AAAA,aAAAF,gBACzBP,aAAW;OAACmB,SAASH;OAAOI,aAAa;OAAC,CAAA;;KAAA,CAAA;IAE9C,CAAA;GAAAV,gBAAA,OAAA,EAAA,CAAA;GAAAA,gBAAA,OAAA,EAAA,CAAA;GAKP,CAAA,EACD;;CAEJ,CAAC"}

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