@shell-shock/core 0.17.10 → 0.17.11

package/dist/engine.mjs

@@ -0,0 +1,136 @@
+import { getFramework } from "./helpers/get-framework.mjs";
+import { createEngine as createEngine$1 } from "@powerlines/engine";
+
+//#region src/engine.ts
+/**
+* The Shell Shock Engine class.
+*
+* @remarks
+* This class provides methods to interact with the Shell Shock build system, including cleaning, preparing, linting, building, generating documentation, and finalizing projects.
+*/
+var Engine = class Engine {
+	#powerlines;
+	/**
+	* Creates a new instance of the {@link Engine} class using the provided configuration options. This method initializes the underlying Powerlines API with the appropriate plugins and settings for Shell Shock.
+	*
+	* @param options - The user configuration options.
+	* @returns A promise that resolves to a {@link Engine} instance.
+	*/
+	static async from(options) {
+		return new Engine(await createEngine$1({
+			...options,
+			framework: getFramework()
+		}, "@shell-shock/core/api"));
+	}
+	/**
+	* Gets the current build context, which includes information about the project, environment, and configuration. This context is used internally by the Shell Shock API to manage the build process and provide relevant data to plugins and other components.
+	*
+	* @returns The current build context.
+	*/
+	get context() {
+		return this.#powerlines.context;
+	}
+	constructor(powerlines) {
+		this.#powerlines = powerlines;
+	}
+	/**
+	* Executes the clean phase of the build process, which typically involves removing generated files and resetting the build environment. The `inlineConfig` parameter allows users to specify additional options or overrides for the clean operation.
+	*
+	* @param inlineConfig - The inline configuration options for the clean operation.
+	* @returns A promise that resolves when the clean operation is complete.
+	*/
+	async clean(inlineConfig) {
+		return this.#powerlines.clean(inlineConfig);
+	}
+	/**
+	* Executes the prepare phase of the build process, which typically involves setting up the build environment and installing dependencies. The `inlineConfig` parameter allows users to specify additional options or overrides for the prepare operation.
+	*
+	* @param inlineConfig - The inline configuration options for the prepare operation.
+	* @returns A promise that resolves when the prepare operation is complete.
+	*/
+	async prepare(inlineConfig) {
+		return this.#powerlines.prepare(inlineConfig);
+	}
+	/**
+	* Executes the lint phase of the build process, which typically involves analyzing code for quality and style issues. The `inlineConfig` parameter allows users to specify additional options or overrides for the lint operation.
+	*
+	* @param inlineConfig - The inline configuration options for the lint operation.
+	* @returns A promise that resolves when the lint operation is complete.
+	*/
+	async lint(inlineConfig) {
+		return this.#powerlines.lint(inlineConfig);
+	}
+	/**
+	* Executes the build phase of the build process, which typically involves compiling source code and generating output artifacts. The `inlineConfig` parameter allows users to specify additional options or overrides for the build operation.
+	*
+	* @param inlineConfig - The inline configuration options for the build operation.
+	* @returns A promise that resolves when the build operation is complete.
+	*/
+	async build(inlineConfig) {
+		return this.#powerlines.build(inlineConfig);
+	}
+	/**
+	* Executes the documentation generation phase of the build process, which typically involves creating API documentation and other project documentation. The `inlineConfig` parameter allows users to specify additional options or overrides for the documentation operation.
+	*
+	* @param inlineConfig - The inline configuration options for the documentation operation.
+	* @returns A promise that resolves when the documentation generation is complete.
+	*/
+	async docs(inlineConfig) {
+		return this.#powerlines.docs(inlineConfig);
+	}
+	/**
+	* Executes the finalize phase of the build process, which typically involves cleanup tasks and final reporting. This method should be called after all other build phases have completed.
+	*
+	* @returns A promise that resolves when the finalize operation is complete.
+	*/
+	async finalize() {
+		return this.#powerlines.finalize();
+	}
+	static __type = [
+		"#powerlines",
+		"EngineOptions",
+		"options",
+		() => Engine,
+		"from",
+		"Creates a new instance of the {@link Engine} class using the provided configuration options. This method initializes the underlying Powerlines API with the appropriate plugins and settings for Shell Shock.",
+		"powerlines",
+		"constructor",
+		"inlineConfig",
+		"clean",
+		"Executes the clean phase of the build process, which typically involves removing generated files and resetting the build environment. The `inlineConfig` parameter allows users to specify additional options or overrides for the clean operation.",
+		"prepare",
+		"Executes the prepare phase of the build process, which typically involves setting up the build environment and installing dependencies. The `inlineConfig` parameter allows users to specify additional options or overrides for the prepare operation.",
+		"lint",
+		"Executes the lint phase of the build process, which typically involves analyzing code for quality and style issues. The `inlineConfig` parameter allows users to specify additional options or overrides for the lint operation.",
+		"build",
+		"Executes the build phase of the build process, which typically involves compiling source code and generating output artifacts. The `inlineConfig` parameter allows users to specify additional options or overrides for the build operation.",
+		"docs",
+		"Executes the documentation generation phase of the build process, which typically involves creating API documentation and other project documentation. The `inlineConfig` parameter allows users to specify additional options or overrides for the documentation operation.",
+		"finalize",
+		"Executes the finalize phase of the build process, which typically involves cleanup tasks and final reporting. This method should be called after all other build phases have completed.",
+		"Engine",
+		"The Shell Shock Engine class.",
+		"!3!P\"w\"2#P7$`0%s?&!P!2'\"0(P!2)$`0*?+P!2)$`0,?-P!2)$`0.?/P!2)$`00?1P!2)$`02?3P$`04?55w6?7"
+	];
+};
+/**
+* Creates a new {@link Engine} instance.
+*
+* @param options - The user configuration options.
+* @returns A promise that resolves to a {@link Engine} instance.
+*/
+async function createEngine(options) {
+	return Engine.from(options);
+}
+createEngine.__type = [
+	"EngineOptions",
+	"options",
+	() => Engine,
+	"createEngine",
+	"Creates a new {@link Engine} instance.",
+	"P\"w!2\"P7#`/$?%"
+];
+
+//#endregion
+export { Engine, createEngine };
+//# sourceMappingURL=engine.mjs.map

package/dist/engine.mjs.map

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

package/dist/helpers/automd.cjs

@@ -1,11 +1,9 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_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 _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
 let _alloy_js_markdown = require("@alloy-js/markdown");
 let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
 let automd = require("automd");
@@ -34,15 +32,15 @@ const commands = __assignType((context) => (0, automd.defineGenerator)({
 			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 			(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`The following commands are available in the ${require_context_helpers.getAppTitle(context, true)} command-line interface application:`),
 			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core_components.For, {
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 				get each() {
 					return Object.values(context.commands);
 				},
 				doubleHardline: true,
 				get children() {
-					return __assignType((child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core_components.Show, {
+					return __assignType((child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 						get when() {
-							return !child.isVirtual;
+							return !child.virtual;
 						},
 						get children() {
 							return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocs, {
@@ -68,4 +66,5 @@ const commands = __assignType((context) => (0, automd.defineGenerator)({
 ]);
 
 //#endregion
-exports.commands = commands;
+exports.commands = commands;
+//# sourceMappingURL=automd.cjs.map

package/dist/helpers/automd.cjs.map

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

package/dist/helpers/automd.mjs

@@ -2,9 +2,8 @@ import { getAppTitle } from "../plugin-utils/context-helpers.mjs";
 import { CommandDocs } from "../components/docs.mjs";
 import "../plugin-utils/index.mjs";
 import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
-import { For, Show } from "@alloy-js/core/components";
+import { For, Show, code } from "@alloy-js/core";
 import { renderString } from "@powerlines/plugin-alloy/render";
-import { code } from "@alloy-js/core";
 import { Heading } from "@alloy-js/markdown";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { defineGenerator } from "automd";
@@ -41,7 +40,7 @@ const commands = __assignType((context) => defineGenerator({
 				get children() {
 					return __assignType((child) => createComponent(Show, {
 						get when() {
-							return !child.isVirtual;
+							return !child.virtual;
 						},
 						get children() {
 							return createComponent(CommandDocs, {

package/dist/helpers/automd.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"automd.mjs","names":[],"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 { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\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            <Spacing />\n            {code`The following commands are available in the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application:`}\n            <Spacing />\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            <Spacing />\n          </>\n        )\n      };\n    }\n  });\n"],"mappings":";;;;;;;;;;;;;AAEE,IAAG,SAAS;;;;;;;;;;;AAoCd,MAAW,WAAS,cAAA,YAAA,gBAAA;CAClB,MAAE;CACF,MAAI,WAAO;AACT,SAAI,EACF,UAAI,aAAO,SAAA;GAAA,gBAAA,SAAA;IACT,OAAG;IACH,UAAK;IACN,CAAC;GAAE,gBAAY,SAAA,EAAA,CAAA;GAAA,WAAA,IAAA,+CAAA,YAAA,SAAA,KAAA,CAAA,sCAAA;GAAA,gBAAA,SAAA,EAAA,CAAA;GAAA,gBAAA,KAAA;IACd,IAAI,OAAM;AACR,YAAI,OAAO,OAAA,QAAA,SAAA;;IAEb,gBAAe;IACf,IAAI,WAAU;AACZ,YAAO,cAAa,UAAO,gBAAmB,MAAA;MAC5C,IAAG,OAAQ;AACT,cAAO,CAAC,MAAM;;MAEhB,IAAI,WAAM;AACR,cAAC,gBAAA,aAAA;QACD,SAAG;QACJ,aAAS;QACV,CAAA;;MAEL,CAAA,EAAA;MAAA;MAAA;MAAA;MAAA,CAAA;;IAEH,CAAA;GAAA,gBAAA,SAAA,EAAA,CAAA;GAAA,CAAA"}
+{"version":3,"file":"automd.mjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/docs-helpers.cjs

@@ -1,4 +1,3 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let _stryke_path_join = require("@stryke/path/join");
 
 //#region src/helpers/docs-helpers.ts
@@ -20,4 +19,5 @@ getDocsOutputPath.__type = [
 ];
 
 //#endregion
-exports.getDocsOutputPath = getDocsOutputPath;
+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":[],"sources":[],"mappings":""}

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

@@ -1 +1 @@
-{"version":3,"file":"docs-helpers.mjs","names":[],"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.root, \"docs\", \"generated\");\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAU,kBAAoB,SAAa;AACzC,QAAE,UAAY,QAAW,OAAK,MAAI,QAAU,YAAa;;AAE3D,kBAAgB,SAAA;CAAA;CAAkB;CAAgB;CAAU;CAAA;CAAA"}
+{"version":3,"file":"docs-helpers.mjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/get-framework.cjs

@@ -0,0 +1,24 @@
+const require_package = require('../package.cjs');
+
+//#region src/helpers/get-framework.ts
+/**
+* Retrieves the framework information for Shell Shock.
+*
+* @returns An object containing the name, version, and organization ID of the Shell Shock framework.
+*/
+function getFramework() {
+	return {
+		name: "shell-shock",
+		version: require_package.version,
+		orgId: "storm-software"
+	};
+}
+getFramework.__type = [
+	"getFramework",
+	"Retrieves the framework information for Shell Shock.",
+	"P!/!?\""
+];
+
+//#endregion
+exports.getFramework = getFramework;
+//# sourceMappingURL=get-framework.cjs.map

package/dist/helpers/get-framework.cjs.map

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

package/dist/helpers/get-framework.mjs

@@ -0,0 +1,24 @@
+import { version } from "../package.mjs";
+
+//#region src/helpers/get-framework.ts
+/**
+* Retrieves the framework information for Shell Shock.
+*
+* @returns An object containing the name, version, and organization ID of the Shell Shock framework.
+*/
+function getFramework() {
+	return {
+		name: "shell-shock",
+		version,
+		orgId: "storm-software"
+	};
+}
+getFramework.__type = [
+	"getFramework",
+	"Retrieves the framework information for Shell Shock.",
+	"P!/!?\""
+];
+
+//#endregion
+export { getFramework };
+//# sourceMappingURL=get-framework.mjs.map

package/dist/helpers/get-framework.mjs.map

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

package/dist/helpers/paths.cjs

@@ -1,15 +1,14 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
 let _stryke_path_append = require("@stryke/path/append");
-let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
 let _stryke_path_join_paths = require("@stryke/path/join-paths");
 let _stryke_path_replace = require("@stryke/path/replace");
 let _stryke_path_resolve_parent_path = require("@stryke/path/resolve-parent-path");
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let powerlines_utils = require("powerlines/utils");
-let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let _stryke_fs_list_files = require("@stryke/fs/list-files");
 let _stryke_path_common = require("@stryke/path/common");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
 let node_fs = require("node:fs");
 
 //#region src/helpers/paths.ts
@@ -87,7 +86,7 @@ resolveCommandDynamicPathSegments.__type = [
 async function findCommandsRoot(context) {
 	let paths = [];
 	if ((0, _stryke_type_checks_is_set_string.isSetString)(context.config.input)) paths = await (0, _stryke_fs_list_files.listFiles)((0, _stryke_path_append.appendPath)((0, _stryke_path_append.appendPath)(context.config.input, context.config.root), context.config.cwd));
-	else if ((0, powerlines_utils.isTypeDefinition)(context.config.input)) paths = await (0, _stryke_fs_list_files.listFiles)((0, _stryke_path_append.appendPath)((0, _stryke_path_append.appendPath)(context.config.input.file, context.config.root), context.config.cwd));
+	else if ((0, powerlines_utils.isFileReference)(context.config.input)) paths = await (0, _stryke_fs_list_files.listFiles)((0, _stryke_path_append.appendPath)((0, _stryke_path_append.appendPath)(context.config.input.file, context.config.root), context.config.cwd));
 	else if (Array.isArray(context.config.input) && context.config.input.length > 0) paths = (await Promise.all(context.config.input.map(__assignType(async (input) => (0, _stryke_fs_list_files.listFiles)((0, _stryke_path_append.appendPath)((0, _stryke_path_append.appendPath)((0, _stryke_type_checks_is_set_string.isSetString)(input) ? input : input.file, context.config.root), context.config.cwd)), [
 		"input",
 		"",
@@ -134,4 +133,5 @@ findCommandsRoot.__type = [
 exports.findCommandsRoot = findCommandsRoot;
 exports.resolveCommandId = resolveCommandId;
 exports.resolveCommandName = resolveCommandName;
-exports.resolveCommandPath = resolveCommandPath;
+exports.resolveCommandPath = resolveCommandPath;
+//# sourceMappingURL=paths.cjs.map

package/dist/helpers/paths.cjs.map

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

package/dist/helpers/paths.mjs

@@ -1,14 +1,14 @@
 import { getDynamicPathSegmentName, isDynamicPathSegment, isPathSegmentGroup } from "../plugin-utils/context-helpers.mjs";
 import { appendPath } from "@stryke/path/append";
-import { findFilePath, findFolderName } from "@stryke/path/file-path-fns";
 import { joinPaths } from "@stryke/path/join-paths";
 import { replacePath } from "@stryke/path/replace";
 import { resolveParentPath } from "@stryke/path/resolve-parent-path";
-import { isSetString } from "@stryke/type-checks/is-set-string";
-import { isTypeDefinition } from "powerlines/utils";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isFileReference } from "powerlines/utils";
 import { listFiles } from "@stryke/fs/list-files";
 import { commonPath } from "@stryke/path/common";
+import { findFilePath, findFolderName } from "@stryke/path/file-path-fns";
 import { existsSync } from "node:fs";
 
 //#region src/helpers/paths.ts
@@ -86,7 +86,7 @@ resolveCommandDynamicPathSegments.__type = [
 async function findCommandsRoot(context) {
 	let paths = [];
 	if (isSetString(context.config.input)) paths = await listFiles(appendPath(appendPath(context.config.input, context.config.root), context.config.cwd));
-	else if (isTypeDefinition(context.config.input)) paths = await listFiles(appendPath(appendPath(context.config.input.file, context.config.root), context.config.cwd));
+	else if (isFileReference(context.config.input)) paths = await listFiles(appendPath(appendPath(context.config.input.file, context.config.root), context.config.cwd));
 	else if (Array.isArray(context.config.input) && context.config.input.length > 0) paths = (await Promise.all(context.config.input.map(__assignType(async (input) => listFiles(appendPath(appendPath(isSetString(input) ? input : input.file, context.config.root), context.config.cwd)), [
 		"input",
 		"",

package/dist/helpers/paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/helpers/paths.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 { listFiles } from \"@stryke/fs/list-files\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { existsSync } from \"node:fs\";\nimport { isTypeDefinition } from \"powerlines/utils\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"../plugin-utils/context-helpers\";\nimport type { Context } from \"../types/context\";\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isDynamicPathSegment(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 (isDynamicPathSegment(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    .split(\"/\")\n    .filter(path => path && !isPathSegmentGroup(path))\n    .join(\"/\");\n}\n\nexport function resolveCommandDynamicPathSegments(\n  context: Context,\n  file: string\n): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(path => Boolean(path) && isDynamicPathSegment(path))\n    .map(path => getDynamicPathSegmentName(path));\n}\n\nexport async function findCommandsRoot(context: Context): Promise<string> {\n  let paths = [] as string[];\n  if (isSetString(context.config.input)) {\n    paths = await listFiles(\n      appendPath(\n        appendPath(context.config.input, context.config.root),\n        context.config.cwd\n      )\n    );\n  } else if (isTypeDefinition(context.config.input)) {\n    paths = await listFiles(\n      appendPath(\n        appendPath(context.config.input.file, context.config.root),\n        context.config.cwd\n      )\n    );\n  } else if (\n    Array.isArray(context.config.input) &&\n    context.config.input.length > 0\n  ) {\n    paths = (\n      await Promise.all(\n        context.config.input.map(async input =>\n          listFiles(\n            appendPath(\n              appendPath(\n                isSetString(input) ? input : input.file,\n                context.config.root\n              ),\n              context.config.cwd\n            )\n          )\n        )\n      )\n    ).flat();\n  } else if (isSetObject(context.config.input)) {\n    paths = (\n      await Promise.all(\n        Object.values(context.config.input).map(async input =>\n          Array.isArray(input)\n            ? (\n                await Promise.all(\n                  input.map(async i =>\n                    listFiles(\n                      appendPath(\n                        appendPath(\n                          isSetString(i) ? i : i.file,\n                          context.config.root\n                        ),\n                        context.config.cwd\n                      )\n                    )\n                  )\n                )\n              ).flat()\n            : listFiles(\n                appendPath(\n                  appendPath(\n                    isSetString(input) ? input : input.file,\n                    context.config.root\n                  ),\n                  context.config.cwd\n                )\n              )\n        )\n      )\n    ).flat();\n  }\n\n  if (paths.length > 0) {\n    return commonPath(paths.map(p => findFilePath(p)));\n  }\n\n  let commandsPath = joinPaths(context.config.root, \"src/commands\");\n  if (!existsSync(commandsPath)) {\n    commandsPath = joinPaths(context.config.root, \"commands\");\n    if (!existsSync(commandsPath)) {\n      commandsPath = joinPaths(context.config.root, \"src\");\n      if (!existsSync(commandsPath)) {\n        commandsPath = context.config.root;\n      }\n    }\n  }\n\n  paths = (\n    await Promise.all([\n      listFiles(\n        joinPaths(appendPath(commandsPath, context.config.cwd), \"**/command.ts\")\n      ),\n      listFiles(\n        joinPaths(\n          appendPath(commandsPath, context.config.cwd),\n          \"**/command.tsx\"\n        )\n      )\n    ])\n  ).flat();\n  if (paths.length > 0) {\n    return commonPath(paths.map(p => findFilePath(p)));\n  }\n\n  return appendPath(commandsPath, context.config.cwd);\n}\n"],"mappings":"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"}
+{"version":3,"file":"paths.mjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/persistence.cjs

@@ -1,6 +1,5 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-let _powerlines_plugin_env_helpers = require("@powerlines/plugin-env/helpers");
 let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _powerlines_plugin_env_helpers = require("@powerlines/plugin-env/helpers");
 
 //#region src/helpers/persistence.ts
 function __assignType(fn, args) {
@@ -94,7 +93,7 @@ readCommandsPersistence.__type = [
 */
 async function writeCommandsPersistence(context) {
 	const filePath = getCommandsPersistencePath(context);
-	await (0, _powerlines_plugin_env_helpers.writeEnvTypeReflection)(context, context.env.types.env, "env");
+	await (0, _powerlines_plugin_env_helpers.writeEnv)(context);
 	await context.fs.write(filePath, JSON.stringify(Object.fromEntries(Object.entries(context.commands).map(__assignType(([name, command]) => [name, serialize(command)], [
 		"param0",
 		"",
@@ -110,6 +109,5 @@ writeCommandsPersistence.__type = [
 ];
 
 //#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":[],"sources":[],"mappings":""}

package/dist/helpers/persistence.mjs

@@ -1,5 +1,5 @@
-import { writeEnvTypeReflection } from "@powerlines/plugin-env/helpers";
 import { joinPaths } from "@stryke/path/join-paths";
+import { writeEnv } from "@powerlines/plugin-env/helpers";
 
 //#region src/helpers/persistence.ts
 function __assignType(fn, args) {
@@ -93,7 +93,7 @@ readCommandsPersistence.__type = [
 */
 async function writeCommandsPersistence(context) {
 	const filePath = getCommandsPersistencePath(context);
-	await writeEnvTypeReflection(context, context.env.types.env, "env");
+	await writeEnv(context);
 	await context.fs.write(filePath, JSON.stringify(Object.fromEntries(Object.entries(context.commands).map(__assignType(([name, command]) => [name, serialize(command)], [
 		"param0",
 		"",
@@ -109,5 +109,5 @@ writeCommandsPersistence.__type = [
 ];
 
 //#endregion
-export { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence };
+export { writeCommandsPersistence };
 //# sourceMappingURL=persistence.mjs.map

package/dist/helpers/persistence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.mjs","names":[],"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 { writeEnvTypeReflection } from \"@powerlines/plugin-env/helpers\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport type { CommandTree, SerializedCommandTree } from \"../types\";\nimport type { Context } from \"../types/context\";\n\nfunction serialize(command: CommandTree): SerializedCommandTree {\n  return {\n    ...command,\n    parent: command.parent?.name ? command.parent.name : null,\n    children: Object.fromEntries(\n      Object.entries(command.children || {}).map(([name, child]) => [\n        name,\n        serialize(child)\n      ])\n    )\n  };\n}\n\nfunction deserialize(\n  command: SerializedCommandTree,\n  parent: CommandTree | null = null\n): CommandTree {\n  const result: CommandTree = {\n    ...command,\n    parent: parent ?? null,\n    children: {}\n  };\n\n  result.children = Object.fromEntries(\n    Object.entries(command.children || {}).map(([name, child]) => [\n      name,\n      deserialize(child, result)\n    ])\n  );\n\n  return result;\n}\n\n/**\n * Gets the file path for persisting CLI command reflections.\n *\n * @param context - The Shell Shock context.\n * @returns The file path for persisting CLI command reflections.\n */\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, \"reflections\", \"commands.json\");\n}\n\n/**\n * Reads the persisted CLI command reflections from the file system and populates the context's commands.\n *\n * @param context - The Shell Shock context.\n * @throws Will throw an error if the reflections file is empty or cannot be read.\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 = Object.fromEntries(\n    Object.entries(\n      (JSON.parse(reflections) ?? {}) as Record<string, SerializedCommandTree>\n    ).map(([name, command]) => [name, deserialize(command)])\n  );\n}\n\n/**\n * Writes the current CLI command reflections from the context to the file system for persistence.\n *\n * @param context - The Shell Shock context.\n * @returns A promise that resolves when the reflections have been successfully written to the file system.\n * @throws Will throw an error if there is an issue writing the reflections to the file system.\n */\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  // Also update the environment type reflections whenever we write the command reflections, to ensure they stay in sync.\n  await writeEnvTypeReflection(context, context.env.types.env, \"env\");\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      Object.fromEntries(\n        Object.entries(context.commands).map(([name, command]) => [\n          name,\n          serialize(command)\n        ])\n      ),\n      null,\n      context.config.mode === \"production\" ? 0 : 2\n    )\n  );\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE9B,QAAO;;AAqBT,SAAS,UAAU,SAAS;AAC1B,QAAO;EACL,GAAG;EACH,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,OAAO,OAAO;EACrD,UAAU,OAAO,YAAW,OAAA,QAAA,QAAA,YAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,WAAA,CAAA,MAAA,UAAA,MAAA,CAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,CAAA;EAC7B;;AAEH,UAAQ,SAAU;CAAA;CAAK;CAAA;CAAA;CAAA;CAAA;AACvB,SAAO,YAAA,SAAA,SAAA,MAAA;CACL,MAAE,SAAA;EACD,GAAA;EACH,QAAA,UAAA;;EAEA;AACE,QAAO,WAAE,OAAA,YAAqB,OAAA,QAAA,QAAA,YAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,WAAA,CAAA,MAAA,YAAA,OAAA,OAAA,CAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;AAC9B,QAAO;;AAET,YAAQ,SAAQ;CAAA;CAAc;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;AAO9B,SAAW,2BAAgC,SAAM;AAC/C,QAAI,UAAI,QAAA,UAAA,eAAA,gBAAA;;AAEV,2BAAK,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOL,eAAsB,wBAAmB,SAAQ;CAChD,MAAA,cAAA,MAAA,QAAA,GAAA,KAAA,2BAAA,QAAA,CAAA;AACC,KAAE,CAAA,eAAgB,CAAG,YAAY,OAC/B,OAAA,IAAQ,MAAQ,+BAAyB,2BAAmB,QAAA,CAAA,WAAA;AAEhE,SAAO,WAAS,OAAA,YAAA,OAA2B,QAAS,KAAQ,MAAE,YAAO,IAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,aAAA,CAAA,MAAA,YAAA,QAAA,CAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAErE,wBAAA,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQA,eAAsB,yBAAwB,SAAS;CACrD,MAAM,WAAW,2BAAwB,QAAA;AAEzC,OAAC,uBAAA,SAAA,QAAA,IAAA,MAAA,KAAA,MAAA;AACD,OAAK,QAAA,GAAY,MAAI,UAAY,KAAA,UAAQ,OAAA,YAAA,OAAA,QAAA,QAAA,SAAA,CAAA,IAAA,cAAA,CAAA,MAAA,aAAA,CAAA,MAAA,UAAA,QAAA,CAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,EAAA,MAAA,QAAA,OAAA,SAAA,eAAA,IAAA,EAAA,CAAA;;AAE3C,yBAAmB,SAAe;CAAC;CAAE;CAAA;CAA6C;CAAA;CAAA"}
+{"version":3,"file":"persistence.mjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/update-package-json.cjs

@@ -1,4 +1,3 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_path_join_paths = require("@stryke/path/join-paths");
@@ -62,4 +61,5 @@ updatePackageJsonBinary.__type = [
 
 //#endregion
 exports.formatBinaryPath = formatBinaryPath;
-exports.updatePackageJsonBinary = updatePackageJsonBinary;
+exports.updatePackageJsonBinary = updatePackageJsonBinary;
+//# sourceMappingURL=update-package-json.cjs.map

package/dist/helpers/update-package-json.cjs.map

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

package/dist/helpers/update-package-json.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"update-package-json.mjs","names":[],"sources":["../../src/helpers/update-package-json.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 { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getAppName } from \"../plugin-utils/context-helpers\";\nimport type { Context } from \"../types/context\";\n\nexport function formatBinaryPath(\n  format: string | string[] | undefined\n): string {\n  return `./dist/bin.${\n    format === \"cjs\" || (Array.isArray(format) && format.includes(\"cjs\"))\n      ? \"cjs\"\n      : \"mjs\"\n  }`;\n}\n\nexport async function updatePackageJsonBinary(context: Context): Promise<void> {\n  const packageJsonPath = joinPaths(\n    context.config.cwd,\n    context.config.root,\n    \"package.json\"\n  );\n\n  if (!context.packageJson) {\n    const packageJson = await context.fs.read(packageJsonPath);\n    if (packageJson) {\n      context.packageJson ??= JSON.parse(packageJson);\n    }\n  }\n\n  if (context.packageJson) {\n    if (\n      context.config.bin &&\n      Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0\n    ) {\n      context.packageJson.bin = Object.fromEntries(\n        getUnique(toArray(context.config.bin)).map(bin => [\n          bin,\n          formatBinaryPath(context.config.output.format)\n        ])\n      );\n\n      await context.fs.write(\n        packageJsonPath,\n        StormJSON.stringify(context.packageJson)\n      );\n    } else {\n      if (\n        Array.isArray(context.config.output.format) &&\n        context.config.output.format.length > 1\n      ) {\n        context.packageJson.bin = {\n          [kebabCase(getAppName(context))]: formatBinaryPath(\n            toArray(context.config.output.format)[0]\n          )\n        };\n        context.packageJson.bin = toArray(context.config.output.format).reduce(\n          (ret, format) => {\n            ret[`${kebabCase(getAppName(context))}-${format}`] =\n              formatBinaryPath(format);\n\n            return ret;\n          },\n          context.packageJson.bin\n        );\n      } else {\n        context.packageJson.bin = {\n          [kebabCase(getAppName(context))]: formatBinaryPath(\n            context.config.output.format\n          )\n        };\n      }\n\n      await context.fs.write(\n        packageJsonPath,\n        StormJSON.stringify(context.packageJson)\n      );\n    }\n\n    if (!isSetObject(context.packageJson.bin)) {\n      throw new Error(\n        \"Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.\"\n      );\n    }\n\n    context.config.bin = context.packageJson.bin;\n  }\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE9B,QAAO;;AA0BT,SAAgB,iBAAc,QAAA;AAC5B,QAAO,cAAC,WAAA,SAAA,MAAA,QAAA,OAAA,IAAA,OAAA,SAAA,MAAA,GAAA,QAAA;;AAEV,iBAAgB,SAAS;CAAA;CAAM;CAA0B;CAAe;AACxE,eAAY,wBAAA,SAAA;CACV,MAAM,kBAAI,UAAA,QAAA,OAAA,KAAA,QAAA,OAAA,MAAA,eAAA;AACV,KAAE,CAAA,QAAA,aAAA;EACJ,MAAA,cAAA,MAAA,QAAA,GAAA,KAAA,gBAAA;kBAEM,SAAO,gBAAS,KAAA,MAAA,YAA+B;;AAGnD,KAAE,QAAQ,aAAW;AACnB,MAAC,QAAQ,OAAI,OAAA,MAAA,QAAA,QAAA,OAAA,IAAA,IAAA,QAAA,OAAA,IAAA,SAAA,GAAA;AACd,WAAA,YAAA,MAAA,OAAA,YAAA,UAAA,QAAA,QAAA,OAAA,IAAA,CAAA,CAAA,IAAA,cAAA,QAAA,CAAA,KAAA,iBAAA,QAAA,OAAA,OAAA,OAAA,CAAA,EAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA,CAAA;;SAEI;AACH,OAAM,MAAA,QAAc,QAAM,OAAQ,OAAQ,OAAA,IAAA,QAAgB,OAAA,OAAA,OAAA,SAAA,GAAA;AACtD,YAAA,YAAa,MAAA,GACf,UAAQ,WAAgB,QAAU,CAAC,GAAA,iBAAY,QAAA,QAAA,OAAA,OAAA,OAAA,CAAA,GAAA,EACjD;AACF,YAAA,YAAA,MAAA,QAAA,QAAA,OAAA,OAAA,OAAA,CAAA,OAAA,cAAA,KAAA,WAAA;;AAEI,YAAQ;OACP;KAAA;KAAA;KAAA;KAAA;KAAA,CAAA,EAAA,QAAA,YAAA,IAAA;SAED,SAAM,YAAgB,MAAM,GAC5B,UAAe,WAAW,QAAE,CAAA,GAAA,iBAAA,QAAA,OAAA,OAAA,OAAA,EAC5B;AAEA,SAAE,QAAU,GAAA,MAAQ,iBAAoB,UAAU,UAAE,QAAA,YAAA,CAAA;;AAEtD,MAAI,CAAC,YAAC,QAAiB,YAAc,IAAC,CACpC,OAAG,IAAA,MAAA,0KAAA;;;;AAKT,wBAAkB,SAAU;CAAA;CAAQ;CAAW;CAAA;CAAA"}
+{"version":3,"file":"update-package-json.mjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/utilities.cjs

@@ -1,4 +1,3 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
 let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
 let _stryke_cli_utils_tree = require("@stryke/cli/utils/tree");
@@ -17,7 +16,7 @@ function __assignType(fn, args) {
 }
 function innerFormatCommandTree(command) {
 	return {
-		name: `${command.name}${command.isVirtual ? " (virtual)" : ""}`,
+		name: `${command.name}${command.virtual ? " (virtual)" : ""}`,
 		children: Object.values(command.children ?? {}).map(innerFormatCommandTree)
 	};
 }
@@ -92,4 +91,5 @@ getGlobalOptions.__type = [
 
 //#endregion
 exports.formatCommandTree = formatCommandTree;
-exports.getGlobalOptions = getGlobalOptions;
+exports.getGlobalOptions = getGlobalOptions;
+//# sourceMappingURL=utilities.cjs.map

package/dist/helpers/utilities.cjs.map

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

package/dist/helpers/utilities.mjs

@@ -16,7 +16,7 @@ function __assignType(fn, args) {
 }
 function innerFormatCommandTree(command) {
 	return {
-		name: `${command.name}${command.isVirtual ? " (virtual)" : ""}`,
+		name: `${command.name}${command.virtual ? " (virtual)" : ""}`,
 		children: Object.values(command.children ?? {}).map(innerFormatCommandTree)
 	};
 }

package/dist/helpers/utilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.mjs","names":[],"sources":["../../src/helpers/utilities.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 { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the global command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve global options.\n * @returns A record of global command options.\n */\nexport function getGlobalOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE9D,IAAG,SAAS;;;AAOd,SAAS,uBAAuB,SAAG;AAClC,QAAA;EACA,MAAA,GAAA,QAAoB,OAAM,QAAQ,YAAK,eAAkB;EACzD,UAAa,OAAO,OAAM,QAAQ,YAAa,EAAC,CAAA,CAAG,IAAC,uBAAA;;;;;;;;;AAIrD,SAAgB,kBAAkB,SAAS;;EAE3C,MAAO,QAAO,OAAW;EACzB,UAAS,OAAY,OAAO,QAAQ,YAAU,EAAI,CAAC,CAAA,IAAA,uBAAA;EACnD,CAAA;;AAEA,kBAAS,SAAkB;CAAC;CAAQ;CAAc;CAAU;CAAA;;;;;;;;AAQ5D,SAAG,iBAAA,SAAA,SAAA;CACH,IAAA;iDAEA,WAAO,OAAS,YAAiB,YAAU,QAAU,OAAO,eAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;UACnD,WAAW,QAAA,OAAA,cAAA,CAChB,WAAM,OAAQ,YAAW,YAAA,QAAA,OAAA,cAAA,SAAA,QAAA,EAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;KAEzB,WAAA,EAAA;;EAGF,GAAA;EACC,KAAA,MAAU,OAAI,aAAe,IAAO;EACtC,CAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAED,iBAAiB,SAAO;CAAA;CAAY;CAAS;CAAgB;OAAO;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"utilities.mjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/validations.cjs

@@ -1,4 +1,3 @@
-const require_types_command = require('../types/command.cjs');
 
 //#region src/helpers/validations.ts
 const __ΩValidationFailure = [
@@ -10,7 +9,7 @@ const __ΩValidationFailure = [
 function validateArguments(command) {
 	const failures = [];
 	let sequential = false;
-	for (const argument of command.args ?? []) if ((argument.kind === require_types_command.CommandParameterKinds.string || argument.kind === require_types_command.CommandParameterKinds.number) && argument.variadic) if (!sequential) sequential = true;
+	for (const argument of command.args ?? []) if ((argument.type === "string" || argument.type === "number") && argument.variadic) if (!sequential) sequential = true;
 	else failures.push({
 		code: "SEQUENTIAL_VARIADIC_ARGUMENTS",
 		details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`
@@ -68,4 +67,5 @@ validateCommand.__type = [
 ];
 
 //#endregion
-exports.validateCommand = validateCommand;
+exports.validateCommand = validateCommand;
+//# sourceMappingURL=validations.cjs.map

package/dist/helpers/validations.cjs.map

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

package/dist/helpers/validations.mjs

@@ -1,5 +1,3 @@
-import { CommandParameterKinds } from "../types/command.mjs";
-
 //#region src/helpers/validations.ts
 const __ΩValidationFailure = [
 	"code",
@@ -10,7 +8,7 @@ const __ΩValidationFailure = [
 function validateArguments(command) {
 	const failures = [];
 	let sequential = false;
-	for (const argument of command.args ?? []) if ((argument.kind === CommandParameterKinds.string || argument.kind === CommandParameterKinds.number) && argument.variadic) if (!sequential) sequential = true;
+	for (const argument of command.args ?? []) if ((argument.type === "string" || argument.type === "number") && argument.variadic) if (!sequential) sequential = true;
 	else failures.push({
 		code: "SEQUENTIAL_VARIADIC_ARGUMENTS",
 		details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`

package/dist/helpers/validations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validations.mjs","names":[],"sources":["../../src/helpers/validations.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 { CommandTree } from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateArguments(command: CommandTree): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  let sequential = false;\n  for (const argument of command.args ?? []) {\n    if (\n      (argument.kind === CommandParameterKinds.string ||\n        argument.kind === CommandParameterKinds.number) &&\n      argument.variadic\n    ) {\n      if (!sequential) {\n        sequential = true;\n      } else {\n        failures.push({\n          code: \"SEQUENTIAL_VARIADIC_ARGUMENTS\",\n          details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`\n        });\n      }\n    } else {\n      sequential = false;\n    }\n  }\n\n  return failures;\n}\n\nexport function validateOptions(command: CommandTree): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateArguments(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":";;;AAkBA,MAAM,uBAAsB;CAAA;CAAS;CAAM;CAAA;CAAA;;CAG3C,MAAO,WAAU,EAAA;CACf,IAAI,aAAQ;AACZ,MAAA,MAAS,YAAM,QAAA,QAAA,EAAA,CACjB,MAAA,SAAA,SAAA,sBAAA,UAAA,SAAA,SAAA,sBAAA,WAAA,SAAA,0BAEO,cAAS;;EAGV,MAAU;EACT,SAAM,gFAAgC,SAAA,KAAA;EACtC,CAAA;KAGD,cAAS;AAGb,QAAM;;AAER,kBAAiB,SAAK;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;AACtB,SAAgB,gBAAC,SAAA;CACf,MAAM,WAAW,EAAC;CAClB,MAAM,eAAE,IAAA,IAAA,CAAA,CAAA,IAAA,CAAA,kBAAA,IAAA,KAAA;AACR,MAAI,MAAA,UAAA,OAAA,OAAA,QAAA,WAAA,EAAA,CAAA,EAAA;AACF,MAAE,YAAK,IAAA,OAAA,KAAA,CACL,UAAA,KAAa;GACf,MAAA;GACF,SAAA,0BAAA,OAAA,KAAA;;AAGF,cAAA,IAAA,OAAA,KAAA;;AAEM,OAAC,YAAS,IAAA,MAAgB,CACxB,UAAS,KAAC;;IAEV,SAAW,0BAAoB,MAAA,kBAAA,OAAA,KAAA;IAChC,CAAA;AAED,eAAS,IAAK,MAAA;;;AAGlB,QAAM;;AAER,gBAAgB,SAAI;CAAM;CAAM;OAAA;CAAA;CAAA;CAAA;;CAE9B,MAAM,UAAO,EAAK;CAClB,IAAI,WAAI,gBAAuB,QAAC;AAChC,KAAI,SAAE,SAAc,EAClB,SAAM,KAAO,GAAA,SAAA;AAEf,YAAU,kBAAO,QAAA;AACjB,KAAI,SAAQ,SAAS,EACnB,SAAM,KAAA,GAAA,SAAA;AAER,QAAI;;AAEN,gBAAE,SAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"validations.mjs","names":[],"sources":[],"mappings":""}