@powerlines/nx 0.11.294 → 0.11.296

package/dist/src/plugin/index.js

@@ -1,8 +1,302 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_helpers_plugin_utilities = require('../helpers/plugin-utilities.js');
+const require_chunk = require('../chunk-BE-pF4vm.js');
+let _nx_devkit = require("@nx/devkit");
+let _storm_software_workspace_tools_utils_nx_json = require("@storm-software/workspace-tools/utils/nx-json");
+let _storm_software_workspace_tools_utils_plugin_helpers = require("@storm-software/workspace-tools/utils/plugin-helpers");
+let _storm_software_workspace_tools_utils_project_tags = require("@storm-software/workspace-tools/utils/project-tags");
+let _stryke_env_get_env_paths = require("@stryke/env/get-env-paths");
+let _stryke_fs_exists = require("@stryke/fs/exists");
+let _stryke_hash = require("@stryke/hash");
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let _stryke_type_checks_is_error = require("@stryke/type-checks/is-error");
+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 defu = require("defu");
+defu = require_chunk.__toESM(defu);
+let jiti = require("jiti");
+let node_fs_promises = require("node:fs/promises");
+let nx_src_config_nx_json_js = require("nx/src/config/nx-json.js");
+let nx_src_utils_package_json_js = require("nx/src/utils/package-json.js");
+let powerlines_config = require("powerlines/config");
+let powerlines_constants = require("powerlines/constants");
 
+//#region src/helpers/constants.ts
+/**
+* A list of Nx input strings that describe the Powerlines configuration file
+*/
+const CONFIG_INPUTS = [
+	"{projectRoot}/{framework}.json",
+	"{projectRoot}/{framework}.*.json",
+	"{projectRoot}/{framework}.jsonc",
+	"{projectRoot}/{framework}.*.jsonc",
+	"{projectRoot}/{framework}.json5",
+	"{projectRoot}/{framework}.*.json5",
+	"{projectRoot}/{framework}.yaml",
+	"{projectRoot}/{framework}.*.yaml",
+	"{projectRoot}/{framework}.yml",
+	"{projectRoot}/{framework}.*.yml",
+	"{projectRoot}/{framework}.toml",
+	"{projectRoot}/{framework}.*.toml",
+	"{projectRoot}/{framework}.config.js",
+	"{projectRoot}/{framework}.*.config.js",
+	"{projectRoot}/{framework}.config.cjs",
+	"{projectRoot}/{framework}.*.config.cjs",
+	"{projectRoot}/{framework}.config.mjs",
+	"{projectRoot}/{framework}.*.config.mjs",
+	"{projectRoot}/{framework}.config.ts",
+	"{projectRoot}/{framework}.*.config.ts",
+	"{projectRoot}/{framework}.config.cts",
+	"{projectRoot}/{framework}.*.config.cts",
+	"{projectRoot}/{framework}.config.mts",
+	"{projectRoot}/{framework}.*.config.mts"
+];
+
+//#endregion
+//#region src/helpers/plugin-utilities.ts
+/**
+* Generates Nx input strings for the Powerlines configuration file, replacing the `{framework}` placeholder with the specified framework name.
+*
+* @param framework - The framework name to use in the input strings
+* @returns An array of Nx input strings for the configuration file
+*/
+function getNxTargetInputs(framework) {
+	return CONFIG_INPUTS.map((input) => input.replace("{framework}", framework));
+}
+/**
+* Generates Nx input strings for the Powerlines configuration file, replacing the `{framework}` placeholder with the specified framework name.
+*
+* @param framework - The framework name to use in the input strings
+* @returns An array of Nx input strings for the configuration file
+*/
+function getNxPluginInputs(framework) {
+	return `**/{${getNxTargetInputs(framework).map((input) => input.replace("{projectRoot}/", "")).join(",")}}`;
+}
+/**
+* Creates an Nx plugin that integrates Powerlines into the Nx build process.
+*
+* @param opts - Options for creating the Nx plugin
+* @returns A CreateNodesV2 function that can be used as an Nx plugin
+*/
+function createNxPlugin(opts) {
+	const framework = opts?.framework || "powerlines";
+	const title = `${(0, _stryke_string_format_title_case.titleCase)(framework)} Nx Plugin`;
+	try {
+		const name = opts?.name || `${framework}/nx/plugin`;
+		const artifactsFolder = opts?.artifactsFolder || `{projectRoot}/.${framework}`;
+		const targetInputs = getNxTargetInputs(framework);
+		const pluginInputs = getNxPluginInputs(framework);
+		return [pluginInputs, async (configFiles, options, contextV2) => {
+			if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Initializing the ${title} for the following inputs: ${pluginInputs}`);
+			const envPaths = (0, _stryke_env_get_env_paths.getEnvPaths)({
+				orgId: "storm-software",
+				appId: framework,
+				workspaceRoot: contextV2.workspaceRoot
+			});
+			if (!envPaths.cache) throw new Error("The cache directory could not be determined.");
+			const nxJson = (0, nx_src_config_nx_json_js.readNxJson)(contextV2.workspaceRoot);
+			const resolver = (0, jiti.createJiti)(contextV2.workspaceRoot, {
+				debug: !!options?.debug,
+				interopDefault: true,
+				fsCache: (0, _stryke_path_join_paths.joinPaths)(envPaths.cache, "nx-plugin", (0, _stryke_hash.murmurhash)(contextV2.workspaceRoot, { maxLength: powerlines_constants.ROOT_HASH_LENGTH }), "jiti"),
+				moduleCache: true
+			});
+			return (0, _nx_devkit.createNodesFromFiles)(async (configFile, _, context) => {
+				try {
+					const projectRoot = (0, _storm_software_workspace_tools_utils_plugin_helpers.getProjectRoot)(configFile, contextV2.workspaceRoot);
+					if (!projectRoot) {
+						console.error(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - package.json and ${framework} configuration files (i.e. ${framework}.config.ts) must be located in the project root directory: ${configFile}`);
+						return {};
+					}
+					const root = (0, _storm_software_workspace_tools_utils_plugin_helpers.getRoot)(projectRoot, context);
+					if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Loading ${framework} user configuration for project in root directory ${projectRoot}.`);
+					let userConfig = {};
+					try {
+						userConfig = await (0, powerlines_config.loadUserConfigFile)(projectRoot, contextV2.workspaceRoot, resolver, "build", "development", configFile, framework);
+					} catch (error) {
+						console.warn(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Failed to load user configuration for project in ${projectRoot} - ${(0, _stryke_type_checks_is_error.isError)(error) ? error.message : (0, _stryke_type_checks_is_set_string.isSetString)(error) ? error : "Unknown error"} \n\nThis error can occur if the project depends on another package in the workspace and the dependent package has not been built yet. To resolve this issue, please ensure that all dependent packages have been built successfully.`);
+					}
+					if (!(0, _stryke_fs_exists.existsSync)((0, _stryke_path_join_paths.joinPaths)(contextV2.workspaceRoot, projectRoot, "package.json"))) {
+						if (options?.verboseOutput) console.warn(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Cannot find \`package.json\` file in the project's root directory (path: "${(0, _stryke_path_join_paths.joinPaths)(contextV2.workspaceRoot, projectRoot)}"). Skipping project configuration.`);
+						return {};
+					}
+					const packageJsonContent = await (0, node_fs_promises.readFile)((0, _stryke_path_join_paths.joinPaths)(contextV2.workspaceRoot, projectRoot, "package.json"), "utf8");
+					if (!packageJsonContent) {
+						if (options?.verboseOutput) console.warn(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - No package.json file found for project in root directory ${projectRoot}`);
+						return {};
+					}
+					const packageJson = JSON.parse(packageJsonContent);
+					if (!userConfig.configFile && !packageJson?.[(0, _stryke_string_format_camel_case.camelCase)(framework)]) {
+						if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Skipping ${projectRoot} - no ${framework} configuration found for project in root directory.`);
+						return {};
+					}
+					const projectConfig = (0, _storm_software_workspace_tools_utils_plugin_helpers.getProjectConfigFromProjectRoot)(projectRoot, packageJson);
+					if (!projectConfig) {
+						if (options?.verboseOutput) console.warn(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - No project configuration found for project in root directory ${projectRoot}`);
+						return {};
+					}
+					const targets = (0, nx_src_utils_package_json_js.readTargetsFromPackageJson)(packageJson, nxJson, projectRoot, context.workspaceRoot);
+					if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Preparing Nx targets for project in root directory ${projectRoot}.`);
+					if (options?.clean !== false && !targets[options?.clean?.targetName || "clean"]) targets[options?.clean?.targetName || "clean"] = {
+						cache: true,
+						inputs: Array.isArray(options?.clean?.inputs) ? options.clean.inputs : (0, _storm_software_workspace_tools_utils_nx_json.withNamedInputs)(targetInputs, [options?.clean?.inputs || "typescript"]),
+						outputs: options?.clean?.outputs,
+						executor: options?.clean?.executor || `@${framework}/nx:${options?.clean?.targetName || "clean"}`,
+						dependsOn: options?.clean?.dependsOn ?? [`^${options?.clean?.targetName || "clean"}`],
+						defaultConfiguration: options?.clean?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.prepare !== false && !targets[options?.prepare?.targetName || "prepare"]) targets[options?.prepare?.targetName || "prepare"] = {
+						cache: true,
+						inputs: Array.isArray(options?.prepare?.inputs) ? options.prepare.inputs : (0, _storm_software_workspace_tools_utils_nx_json.withNamedInputs)(targetInputs, [options?.prepare?.inputs || "typescript"]),
+						outputs: options?.prepare?.outputs ?? [artifactsFolder],
+						executor: options?.prepare?.executor || `@${framework}/nx:${options?.prepare?.targetName || "prepare"}`,
+						dependsOn: options?.prepare?.dependsOn ?? [`^${options?.prepare?.targetName || "build"}`, options?.clean !== false && `${options?.clean?.targetName || "clean"}`].filter(Boolean),
+						defaultConfiguration: options?.prepare?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.build !== false && !targets[options?.build?.targetName || "build"]) targets[options?.build?.targetName || "build"] = {
+						cache: true,
+						inputs: Array.isArray(options?.build?.inputs) ? options.build.inputs : (0, _storm_software_workspace_tools_utils_nx_json.withNamedInputs)(targetInputs, [options?.build?.inputs || "typescript"]),
+						outputs: options?.build?.outputs ?? ["{options.outputPath}"],
+						executor: options?.build?.executor || `@${framework}/nx:${options?.build?.targetName || "build"}`,
+						dependsOn: options?.build?.dependsOn ?? [`^${options?.build?.targetName || "build"}`, userConfig.skipCache ? void 0 : (0, _stryke_type_checks_is_set_object.isSetObject)(options?.prepare) && options?.prepare?.targetName ? options?.prepare?.targetName : "prepare"].filter(Boolean),
+						defaultConfiguration: options?.build?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.lint !== false && !targets[options?.lint?.targetName || "lint"]) targets[options?.lint?.targetName || "lint"] = {
+						cache: true,
+						inputs: Array.isArray(options?.lint?.inputs) ? options.lint.inputs : (0, _storm_software_workspace_tools_utils_nx_json.withNamedInputs)([...targetInputs, artifactsFolder], options?.lint?.inputs ? [options.lint.inputs] : ["linting", "typescript"]),
+						outputs: options?.lint?.outputs ?? ["{options.outputPath}"],
+						executor: options?.lint?.executor || `@${framework}/nx:${options?.lint?.targetName || "lint"}`,
+						dependsOn: options?.lint?.dependsOn ?? [`^${options?.lint?.targetName || "lint"}`, userConfig.skipCache ? void 0 : (0, _stryke_type_checks_is_set_object.isSetObject)(options?.prepare) && options?.prepare?.targetName ? options?.prepare?.targetName : "prepare"].filter(Boolean),
+						defaultConfiguration: options?.lint?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.docs !== false && !targets[options?.docs?.targetName || "docs"]) targets[options?.docs?.targetName || "docs"] = {
+						cache: true,
+						inputs: Array.isArray(options?.docs?.inputs) ? options.docs.inputs : (0, _storm_software_workspace_tools_utils_nx_json.withNamedInputs)([...targetInputs, artifactsFolder], options?.docs?.inputs ? [options.docs.inputs] : ["documentation", "typescript"]),
+						outputs: options?.docs?.outputs ?? ["{options.outputPath}"],
+						executor: options?.docs?.executor || `@${framework}/nx:${options?.docs?.targetName || "docs"}`,
+						dependsOn: options?.docs?.dependsOn ?? [
+							`^${options?.docs?.targetName || "docs"}`,
+							options?.build !== false && `${options?.build?.targetName || "build"}`,
+							userConfig.skipCache ? void 0 : (0, _stryke_type_checks_is_set_object.isSetObject)(options?.prepare) && options?.prepare?.targetName ? options?.prepare?.targetName : "prepare"
+						].filter(Boolean),
+						defaultConfiguration: options?.docs?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.deploy !== false && !targets[options?.deploy?.targetName || "deploy"]) targets[options?.deploy?.targetName || "deploy"] = {
+						inputs: Array.isArray(options?.deploy?.inputs) ? options.deploy.inputs : (0, _storm_software_workspace_tools_utils_nx_json.withNamedInputs)([...targetInputs, artifactsFolder], options?.deploy?.inputs ? [options.deploy.inputs] : ["documentation", "typescript"]),
+						outputs: options?.deploy?.outputs ?? ["{options.outputPath}"],
+						executor: options?.deploy?.executor || `@${framework}/nx:${options?.deploy?.targetName || "deploy"}`,
+						dependsOn: options?.deploy?.dependsOn ?? [
+							`^${options?.deploy?.targetName || "deploy"}`,
+							options?.build !== false && `${options?.build?.targetName || "build"}`,
+							userConfig.skipCache ? void 0 : (0, _stryke_type_checks_is_set_object.isSetObject)(options?.prepare) && options?.prepare?.targetName ? options?.prepare?.targetName : "prepare"
+						].filter(Boolean),
+						defaultConfiguration: options?.deploy?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					(0, _storm_software_workspace_tools_utils_project_tags.setDefaultProjectTags)(projectConfig, name);
+					(0, _storm_software_workspace_tools_utils_project_tags.addProjectTag)(projectConfig, framework, projectConfig.projectType || "library", { overwrite: true });
+					if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Completed preparing Nx configuration for project in root directory ${projectRoot}.`);
+					return { projects: { [root]: (0, defu.default)(projectConfig, {
+						name: (0, _stryke_string_format_kebab_case.kebabCase)(userConfig.name),
+						projectType: projectConfig.projectType || "library",
+						root,
+						sourceRoot: (0, _stryke_path_join_paths.joinPaths)(root, "src"),
+						targets
+					}) } };
+				} catch (error) {
+					console.error(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Failed to process the project configuration for file "${configFile}" - ${(0, _stryke_type_checks_is_error.isError)(error) ? error.message : (0, _stryke_type_checks_is_set_string.isSetString)(error) ? error : "Unknown fatal error"}`);
+					return {};
+				}
+			}, configFiles, options, contextV2);
+		}];
+	} catch (error) {
+		console.error(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - ${(0, _stryke_type_checks_is_error.isError)(error) ? error.message : (0, _stryke_type_checks_is_set_string.isSetString)(error) ? error : "Unknown fatal error during plugin initialization"}`);
+		throw new Error(`Failed to initialize the ${title} - ${(0, _stryke_type_checks_is_error.isError)(error) ? error.message : (0, _stryke_type_checks_is_set_string.isSetString)(error) ? error : "See previous logs for more details"}`, { cause: error instanceof Error ? error : void 0 });
+	}
+}
+
+//#endregion
 //#region src/plugin/index.ts
-const createNodesV2 = require_helpers_plugin_utilities.createNxPlugin({ framework: "powerlines" });
+const createNodesV2 = createNxPlugin({ framework: "powerlines" });
 
 //#endregion
 exports.createNodesV2 = createNodesV2;

package/dist/src/plugin/index.mjs

@@ -1,5 +1,297 @@
-import { createNxPlugin } from "../helpers/plugin-utilities.mjs";
+import { createNodesFromFiles } from "@nx/devkit";
+import { withNamedInputs } from "@storm-software/workspace-tools/utils/nx-json";
+import { getProjectConfigFromProjectRoot, getProjectRoot, getRoot } from "@storm-software/workspace-tools/utils/plugin-helpers";
+import { addProjectTag, setDefaultProjectTags } from "@storm-software/workspace-tools/utils/project-tags";
+import { getEnvPaths } from "@stryke/env/get-env-paths";
+import { existsSync } from "@stryke/fs/exists";
+import { murmurhash } from "@stryke/hash";
+import { joinPaths } from "@stryke/path/join-paths";
+import { camelCase } from "@stryke/string-format/camel-case";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isError } from "@stryke/type-checks/is-error";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import defu from "defu";
+import { createJiti } from "jiti";
+import { readFile } from "node:fs/promises";
+import { readNxJson as readNxJson$1 } from "nx/src/config/nx-json.js";
+import { readTargetsFromPackageJson } from "nx/src/utils/package-json.js";
+import { loadUserConfigFile } from "powerlines/config";
+import { ROOT_HASH_LENGTH } from "powerlines/constants";
 
+//#region src/helpers/constants.ts
+/**
+* A list of Nx input strings that describe the Powerlines configuration file
+*/
+const CONFIG_INPUTS = [
+	"{projectRoot}/{framework}.json",
+	"{projectRoot}/{framework}.*.json",
+	"{projectRoot}/{framework}.jsonc",
+	"{projectRoot}/{framework}.*.jsonc",
+	"{projectRoot}/{framework}.json5",
+	"{projectRoot}/{framework}.*.json5",
+	"{projectRoot}/{framework}.yaml",
+	"{projectRoot}/{framework}.*.yaml",
+	"{projectRoot}/{framework}.yml",
+	"{projectRoot}/{framework}.*.yml",
+	"{projectRoot}/{framework}.toml",
+	"{projectRoot}/{framework}.*.toml",
+	"{projectRoot}/{framework}.config.js",
+	"{projectRoot}/{framework}.*.config.js",
+	"{projectRoot}/{framework}.config.cjs",
+	"{projectRoot}/{framework}.*.config.cjs",
+	"{projectRoot}/{framework}.config.mjs",
+	"{projectRoot}/{framework}.*.config.mjs",
+	"{projectRoot}/{framework}.config.ts",
+	"{projectRoot}/{framework}.*.config.ts",
+	"{projectRoot}/{framework}.config.cts",
+	"{projectRoot}/{framework}.*.config.cts",
+	"{projectRoot}/{framework}.config.mts",
+	"{projectRoot}/{framework}.*.config.mts"
+];
+
+//#endregion
+//#region src/helpers/plugin-utilities.ts
+/**
+* Generates Nx input strings for the Powerlines configuration file, replacing the `{framework}` placeholder with the specified framework name.
+*
+* @param framework - The framework name to use in the input strings
+* @returns An array of Nx input strings for the configuration file
+*/
+function getNxTargetInputs(framework) {
+	return CONFIG_INPUTS.map((input) => input.replace("{framework}", framework));
+}
+/**
+* Generates Nx input strings for the Powerlines configuration file, replacing the `{framework}` placeholder with the specified framework name.
+*
+* @param framework - The framework name to use in the input strings
+* @returns An array of Nx input strings for the configuration file
+*/
+function getNxPluginInputs(framework) {
+	return `**/{${getNxTargetInputs(framework).map((input) => input.replace("{projectRoot}/", "")).join(",")}}`;
+}
+/**
+* Creates an Nx plugin that integrates Powerlines into the Nx build process.
+*
+* @param opts - Options for creating the Nx plugin
+* @returns A CreateNodesV2 function that can be used as an Nx plugin
+*/
+function createNxPlugin(opts) {
+	const framework = opts?.framework || "powerlines";
+	const title = `${titleCase(framework)} Nx Plugin`;
+	try {
+		const name = opts?.name || `${framework}/nx/plugin`;
+		const artifactsFolder = opts?.artifactsFolder || `{projectRoot}/.${framework}`;
+		const targetInputs = getNxTargetInputs(framework);
+		const pluginInputs = getNxPluginInputs(framework);
+		return [pluginInputs, async (configFiles, options, contextV2) => {
+			if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Initializing the ${title} for the following inputs: ${pluginInputs}`);
+			const envPaths = getEnvPaths({
+				orgId: "storm-software",
+				appId: framework,
+				workspaceRoot: contextV2.workspaceRoot
+			});
+			if (!envPaths.cache) throw new Error("The cache directory could not be determined.");
+			const nxJson = readNxJson$1(contextV2.workspaceRoot);
+			const resolver = createJiti(contextV2.workspaceRoot, {
+				debug: !!options?.debug,
+				interopDefault: true,
+				fsCache: joinPaths(envPaths.cache, "nx-plugin", murmurhash(contextV2.workspaceRoot, { maxLength: ROOT_HASH_LENGTH }), "jiti"),
+				moduleCache: true
+			});
+			return createNodesFromFiles(async (configFile, _, context) => {
+				try {
+					const projectRoot = getProjectRoot(configFile, contextV2.workspaceRoot);
+					if (!projectRoot) {
+						console.error(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - package.json and ${framework} configuration files (i.e. ${framework}.config.ts) must be located in the project root directory: ${configFile}`);
+						return {};
+					}
+					const root = getRoot(projectRoot, context);
+					if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Loading ${framework} user configuration for project in root directory ${projectRoot}.`);
+					let userConfig = {};
+					try {
+						userConfig = await loadUserConfigFile(projectRoot, contextV2.workspaceRoot, resolver, "build", "development", configFile, framework);
+					} catch (error) {
+						console.warn(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Failed to load user configuration for project in ${projectRoot} - ${isError(error) ? error.message : isSetString(error) ? error : "Unknown error"} \n\nThis error can occur if the project depends on another package in the workspace and the dependent package has not been built yet. To resolve this issue, please ensure that all dependent packages have been built successfully.`);
+					}
+					if (!existsSync(joinPaths(contextV2.workspaceRoot, projectRoot, "package.json"))) {
+						if (options?.verboseOutput) console.warn(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Cannot find \`package.json\` file in the project's root directory (path: "${joinPaths(contextV2.workspaceRoot, projectRoot)}"). Skipping project configuration.`);
+						return {};
+					}
+					const packageJsonContent = await readFile(joinPaths(contextV2.workspaceRoot, projectRoot, "package.json"), "utf8");
+					if (!packageJsonContent) {
+						if (options?.verboseOutput) console.warn(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - No package.json file found for project in root directory ${projectRoot}`);
+						return {};
+					}
+					const packageJson = JSON.parse(packageJsonContent);
+					if (!userConfig.configFile && !packageJson?.[camelCase(framework)]) {
+						if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Skipping ${projectRoot} - no ${framework} configuration found for project in root directory.`);
+						return {};
+					}
+					const projectConfig = getProjectConfigFromProjectRoot(projectRoot, packageJson);
+					if (!projectConfig) {
+						if (options?.verboseOutput) console.warn(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - No project configuration found for project in root directory ${projectRoot}`);
+						return {};
+					}
+					const targets = readTargetsFromPackageJson(packageJson, nxJson, projectRoot, context.workspaceRoot);
+					if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Preparing Nx targets for project in root directory ${projectRoot}.`);
+					if (options?.clean !== false && !targets[options?.clean?.targetName || "clean"]) targets[options?.clean?.targetName || "clean"] = {
+						cache: true,
+						inputs: Array.isArray(options?.clean?.inputs) ? options.clean.inputs : withNamedInputs(targetInputs, [options?.clean?.inputs || "typescript"]),
+						outputs: options?.clean?.outputs,
+						executor: options?.clean?.executor || `@${framework}/nx:${options?.clean?.targetName || "clean"}`,
+						dependsOn: options?.clean?.dependsOn ?? [`^${options?.clean?.targetName || "clean"}`],
+						defaultConfiguration: options?.clean?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.prepare !== false && !targets[options?.prepare?.targetName || "prepare"]) targets[options?.prepare?.targetName || "prepare"] = {
+						cache: true,
+						inputs: Array.isArray(options?.prepare?.inputs) ? options.prepare.inputs : withNamedInputs(targetInputs, [options?.prepare?.inputs || "typescript"]),
+						outputs: options?.prepare?.outputs ?? [artifactsFolder],
+						executor: options?.prepare?.executor || `@${framework}/nx:${options?.prepare?.targetName || "prepare"}`,
+						dependsOn: options?.prepare?.dependsOn ?? [`^${options?.prepare?.targetName || "build"}`, options?.clean !== false && `${options?.clean?.targetName || "clean"}`].filter(Boolean),
+						defaultConfiguration: options?.prepare?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.build !== false && !targets[options?.build?.targetName || "build"]) targets[options?.build?.targetName || "build"] = {
+						cache: true,
+						inputs: Array.isArray(options?.build?.inputs) ? options.build.inputs : withNamedInputs(targetInputs, [options?.build?.inputs || "typescript"]),
+						outputs: options?.build?.outputs ?? ["{options.outputPath}"],
+						executor: options?.build?.executor || `@${framework}/nx:${options?.build?.targetName || "build"}`,
+						dependsOn: options?.build?.dependsOn ?? [`^${options?.build?.targetName || "build"}`, userConfig.skipCache ? void 0 : isSetObject(options?.prepare) && options?.prepare?.targetName ? options?.prepare?.targetName : "prepare"].filter(Boolean),
+						defaultConfiguration: options?.build?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.lint !== false && !targets[options?.lint?.targetName || "lint"]) targets[options?.lint?.targetName || "lint"] = {
+						cache: true,
+						inputs: Array.isArray(options?.lint?.inputs) ? options.lint.inputs : withNamedInputs([...targetInputs, artifactsFolder], options?.lint?.inputs ? [options.lint.inputs] : ["linting", "typescript"]),
+						outputs: options?.lint?.outputs ?? ["{options.outputPath}"],
+						executor: options?.lint?.executor || `@${framework}/nx:${options?.lint?.targetName || "lint"}`,
+						dependsOn: options?.lint?.dependsOn ?? [`^${options?.lint?.targetName || "lint"}`, userConfig.skipCache ? void 0 : isSetObject(options?.prepare) && options?.prepare?.targetName ? options?.prepare?.targetName : "prepare"].filter(Boolean),
+						defaultConfiguration: options?.lint?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.docs !== false && !targets[options?.docs?.targetName || "docs"]) targets[options?.docs?.targetName || "docs"] = {
+						cache: true,
+						inputs: Array.isArray(options?.docs?.inputs) ? options.docs.inputs : withNamedInputs([...targetInputs, artifactsFolder], options?.docs?.inputs ? [options.docs.inputs] : ["documentation", "typescript"]),
+						outputs: options?.docs?.outputs ?? ["{options.outputPath}"],
+						executor: options?.docs?.executor || `@${framework}/nx:${options?.docs?.targetName || "docs"}`,
+						dependsOn: options?.docs?.dependsOn ?? [
+							`^${options?.docs?.targetName || "docs"}`,
+							options?.build !== false && `${options?.build?.targetName || "build"}`,
+							userConfig.skipCache ? void 0 : isSetObject(options?.prepare) && options?.prepare?.targetName ? options?.prepare?.targetName : "prepare"
+						].filter(Boolean),
+						defaultConfiguration: options?.docs?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					if (options?.deploy !== false && !targets[options?.deploy?.targetName || "deploy"]) targets[options?.deploy?.targetName || "deploy"] = {
+						inputs: Array.isArray(options?.deploy?.inputs) ? options.deploy.inputs : withNamedInputs([...targetInputs, artifactsFolder], options?.deploy?.inputs ? [options.deploy.inputs] : ["documentation", "typescript"]),
+						outputs: options?.deploy?.outputs ?? ["{options.outputPath}"],
+						executor: options?.deploy?.executor || `@${framework}/nx:${options?.deploy?.targetName || "deploy"}`,
+						dependsOn: options?.deploy?.dependsOn ?? [
+							`^${options?.deploy?.targetName || "deploy"}`,
+							options?.build !== false && `${options?.build?.targetName || "build"}`,
+							userConfig.skipCache ? void 0 : isSetObject(options?.prepare) && options?.prepare?.targetName ? options?.prepare?.targetName : "prepare"
+						].filter(Boolean),
+						defaultConfiguration: options?.deploy?.defaultConfiguration || "production",
+						options: {
+							projectType: projectConfig.projectType,
+							outputPath: `{workspaceRoot}/${projectRoot}/dist`,
+							copyPath: `{workspaceRoot}/dist/${projectRoot}`
+						},
+						configurations: {
+							production: { mode: "production" },
+							test: { mode: "test" },
+							development: {
+								mode: "development",
+								skipCache: true
+							}
+						}
+					};
+					setDefaultProjectTags(projectConfig, name);
+					addProjectTag(projectConfig, framework, projectConfig.projectType || "library", { overwrite: true });
+					if (options?.verboseOutput) console.debug(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Completed preparing Nx configuration for project in root directory ${projectRoot}.`);
+					return { projects: { [root]: defu(projectConfig, {
+						name: kebabCase(userConfig.name),
+						projectType: projectConfig.projectType || "library",
+						root,
+						sourceRoot: joinPaths(root, "src"),
+						targets
+					}) } };
+				} catch (error) {
+					console.error(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - Failed to process the project configuration for file "${configFile}" - ${isError(error) ? error.message : isSetString(error) ? error : "Unknown fatal error"}`);
+					return {};
+				}
+			}, configFiles, options, contextV2);
+		}];
+	} catch (error) {
+		console.error(`[${title}] - ${(/* @__PURE__ */ new Date()).toISOString()} - ${isError(error) ? error.message : isSetString(error) ? error : "Unknown fatal error during plugin initialization"}`);
+		throw new Error(`Failed to initialize the ${title} - ${isError(error) ? error.message : isSetString(error) ? error : "See previous logs for more details"}`, { cause: error instanceof Error ? error : void 0 });
+	}
+}
+
+//#endregion
 //#region src/plugin/index.ts
 const createNodesV2 = createNxPlugin({ framework: "powerlines" });