@powerlines/plugin-webpack 0.5.131 → 0.5.133

package/dist/powerlines/src/lib/contexts/context.mjs

@@ -0,0 +1,931 @@
+import { createProgram } from "../typescript/ts-morph.mjs";
+import { getTsconfigFilePath } from "../typescript/tsconfig.mjs";
+import { loadUserConfigFile, loadWorkspaceConfig } from "../config-file.mjs";
+import { createResolver } from "../../internal/helpers/resolver.mjs";
+import { checkDedupe, isPlugin } from "../../plugin-utils/helpers.mjs";
+import { replacePathTokens } from "../../plugin-utils/paths.mjs";
+import { getUniqueEntries, resolveEntriesSync } from "../entry.mjs";
+import { createLog, extendLog } from "../logger.mjs";
+import { VirtualFileSystem } from "../fs/vfs.mjs";
+import { CACHE_HASH_LENGTH, PROJECT_ROOT_HASH_LENGTH, getPrefixedProjectRootHash } from "../utilities/meta.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import defu$1 from "defu";
+import { omit } from "@stryke/helpers/omit";
+import { relativeToWorkspaceRoot } from "@stryke/fs/get-workspace-root";
+import { toArray } from "@stryke/convert/to-array";
+import { resolvePackage } from "@stryke/fs/resolve";
+import { appendPath } from "@stryke/path/append";
+import { replacePath } from "@stryke/path/replace";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isString } from "@stryke/type-checks/is-string";
+import { readJsonFile } from "@stryke/fs/json";
+import { StormJSON } from "@stryke/json/storm-json";
+import { titleCase } from "@stryke/string-format/title-case";
+import { existsSync } from "@stryke/fs/exists";
+import { getEnvPaths } from "@stryke/env/get-env-paths";
+import { hashDirectory } from "@stryke/hash/hash-files";
+import { murmurhash } from "@stryke/hash/murmurhash";
+import { getUnique, getUniqueBy } from "@stryke/helpers/get-unique";
+import { fetchRequest } from "@stryke/http/fetch";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { isAbsolute } from "@stryke/path/is-type";
+import { joinPaths } from "@stryke/path/join";
+import { isNull } from "@stryke/type-checks/is-null";
+import { uuid } from "@stryke/unique-id/uuid";
+import { match, tsconfigPathsToRegExp } from "bundle-require";
+import { create } from "flat-cache";
+import { parse } from "oxc-parser";
+import { Agent, Response, interceptors, setGlobalDispatcher } from "undici";
+
+//#region ../powerlines/src/lib/contexts/context.ts
+const configCache = /* @__PURE__ */ new WeakMap();
+const envPathCache = /* @__PURE__ */ new WeakMap();
+setGlobalDispatcher(new Agent({ keepAliveTimeout: 1e4 }).compose(interceptors.retry({
+	maxRetries: 3,
+	minTimeout: 1e3,
+	maxTimeout: 1e4,
+	timeoutFactor: 2,
+	retryAfter: true
+})));
+var PowerlinesContext = class PowerlinesContext {
+	/**
+	* Internal references storage
+	*
+	* @danger
+	* This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+	*
+	* @internal
+	*/
+	#internal = {};
+	#workspaceConfig;
+	#checksum = null;
+	#buildId = uuid();
+	#releaseId = uuid();
+	#timestamp = Date.now();
+	#entry = null;
+	#fs;
+	#tsconfig;
+	#program;
+	#parserCache;
+	#requestCache;
+	#getConfigProps(config = {}) {
+		return defu$1({
+			variant: config.build?.variant,
+			projectType: config.type,
+			projectRoot: config.root,
+			name: config.name,
+			title: config.title,
+			organization: config.organization,
+			compatibilityDate: config.compatibilityDate,
+			description: config.description,
+			sourceRoot: config.sourceRoot,
+			configFile: config.configFile,
+			customLogger: config.customLogger,
+			logLevel: config.logLevel,
+			tsconfig: config.tsconfig,
+			tsconfigRaw: config.tsconfigRaw,
+			skipCache: config.skipCache,
+			skipInstalls: config.skipInstalls,
+			entry: config.entry,
+			output: config.output,
+			plugins: config.plugins,
+			mode: config.mode,
+			lint: config.lint,
+			transform: config.transform,
+			build: config.build,
+			framework: config.framework,
+			...config
+		}, { output: config.framework ? {
+			artifactsPath: joinPaths(config.root ?? this.config.projectRoot, `.${config.framework ?? "powerlines"}`),
+			dts: joinPaths(config.root ?? this.config.projectRoot, `${config.framework ?? "powerlines"}.d.ts`),
+			builtinPrefix: config.framework ?? "powerlines"
+		} : {} });
+	}
+	/**
+	* Create a new Storm context from the workspace root and user config.
+	*
+	* @param workspaceRoot - The root directory of the workspace.
+	* @param config - The user configuration options.
+	* @returns A promise that resolves to the new context.
+	*/
+	static async from(workspaceRoot, config) {
+		const context = new PowerlinesContext(await loadWorkspaceConfig(workspaceRoot, config.root));
+		await context.withUserConfig(config);
+		const powerlinesPath = await resolvePackage("powerlines");
+		if (!powerlinesPath) throw new Error("Could not resolve `powerlines` package location.");
+		context.powerlinesPath = powerlinesPath;
+		return context;
+	}
+	/**
+	* An object containing the dependencies that should be installed for the project
+	*/
+	dependencies = {};
+	/**
+	* An object containing the development dependencies that should be installed for the project
+	*/
+	devDependencies = {};
+	/**
+	* The persisted meta information about the current build
+	*/
+	persistedMeta = void 0;
+	/**
+	* The path to the Powerlines package
+	*/
+	powerlinesPath;
+	/**
+	* The parsed `package.json` file for the project
+	*/
+	packageJson;
+	/**
+	* The parsed `project.json` file for the project
+	*/
+	projectJson = void 0;
+	/**
+	* The module resolver for the project
+	*/
+	resolver;
+	/**
+	* The resolved configuration options
+	*/
+	resolvePatterns = [];
+	/**
+	* Internal context fields and methods
+	*
+	* @danger
+	* This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+	*
+	* @internal
+	*/
+	get $$internal() {
+		return this.#internal;
+	}
+	/**
+	* Internal context fields and methods
+	*
+	* @danger
+	* This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+	*
+	* @internal
+	*/
+	set $$internal(value) {
+		this.#internal = value;
+	}
+	/**
+	* The resolved entry type definitions for the project
+	*/
+	get entry() {
+		return resolveEntriesSync(this, !this.#entry ? toArray(this.config.entry) : this.#entry);
+	}
+	/**
+	* Sets the resolved entry type definitions for the project
+	*/
+	set entry(value) {
+		this.#entry = value;
+	}
+	/**
+	* The TypeScript configuration parsed from the tsconfig file
+	*/
+	get tsconfig() {
+		if (!this.#tsconfig) this.tsconfig = { tsconfigFilePath: this.config.tsconfig };
+		return this.#tsconfig;
+	}
+	/**
+	* Sets the TypeScript configuration parsed from the tsconfig file
+	*/
+	set tsconfig(value) {
+		this.#tsconfig = value;
+		this.resolvePatterns = tsconfigPathsToRegExp(value?.options?.paths ?? {});
+	}
+	/**
+	* The virtual file system interface for the project
+	*/
+	get fs() {
+		if (!this.#fs) this.#fs = VirtualFileSystem.createSync(this);
+		return this.#fs;
+	}
+	/**
+	* Get the checksum of the project's current state
+	*/
+	get checksum() {
+		return this.#checksum;
+	}
+	/**
+	* The meta information about the current build
+	*/
+	get meta() {
+		return {
+			buildId: this.#buildId,
+			releaseId: this.#releaseId,
+			checksum: this.#checksum,
+			timestamp: this.#timestamp,
+			projectRootHash: murmurhash({
+				workspaceRoot: this.workspaceConfig?.workspaceRoot,
+				projectRoot: this.config?.projectRoot
+			}, { maxLength: PROJECT_ROOT_HASH_LENGTH }),
+			configHash: murmurhash(this.config, { maxLength: CACHE_HASH_LENGTH })
+		};
+	}
+	/**
+	* The resolved configuration options
+	*/
+	get config() {
+		return this.resolvedConfig ?? {};
+	}
+	/**
+	* The logger function
+	*/
+	get log() {
+		if (!this.logFn) this.logFn = this.createLog();
+		return this.logFn;
+	}
+	/**
+	* The workspace configuration
+	*/
+	get workspaceConfig() {
+		return this.#workspaceConfig;
+	}
+	/**
+	* The environment paths for the project
+	*/
+	get envPaths() {
+		if (envPathCache.has({
+			workspaceRoot: this.workspaceConfig.workspaceRoot,
+			framework: this.config?.framework || "powerlines"
+		})) return envPathCache.get({
+			workspaceRoot: this.workspaceConfig.workspaceRoot,
+			framework: this.config?.framework || "powerlines"
+		});
+		const envPaths = getEnvPaths({
+			orgId: "storm-software",
+			appId: this.config?.framework || "powerlines",
+			workspaceRoot: this.workspaceConfig.workspaceRoot
+		});
+		envPathCache.set({
+			workspaceRoot: this.workspaceConfig.workspaceRoot,
+			framework: this.config?.framework || "powerlines"
+		}, envPaths);
+		return envPaths;
+	}
+	/**
+	* Get the path to the artifacts directory for the project
+	*/
+	get artifactsPath() {
+		return joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot, this.config.output.artifactsPath);
+	}
+	/**
+	* Get the path to the builtin modules used by the project
+	*/
+	get builtinsPath() {
+		return joinPaths(this.artifactsPath, "builtins");
+	}
+	/**
+	* Get the path to the entry directory for the project
+	*/
+	get entryPath() {
+		return joinPaths(this.artifactsPath, "entry");
+	}
+	/**
+	* Get the path to the data directory for the project
+	*/
+	get dataPath() {
+		return joinPaths(this.envPaths.data, "projects", getPrefixedProjectRootHash(this.config.name, this.meta.projectRootHash));
+	}
+	/**
+	* Get the path to the cache directory for the project
+	*/
+	get cachePath() {
+		return joinPaths(this.envPaths.cache, "projects", murmurhash({
+			checksum: this.#checksum,
+			config: this.meta.configHash
+		}, { maxLength: CACHE_HASH_LENGTH }));
+	}
+	/**
+	* Get the path to the generated declaration file for the project
+	*/
+	get dtsPath() {
+		return this.config.output.dts ? appendPath(this.config.output.dts, this.workspaceConfig.workspaceRoot) : joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot, "powerlines.d.ts");
+	}
+	/**
+	* Get the project root relative to the workspace root
+	*/
+	get relativeToWorkspaceRoot() {
+		return relativeToWorkspaceRoot(this.config.projectRoot);
+	}
+	/**
+	* The builtin module id that exist in the Powerlines virtual file system
+	*/
+	get builtins() {
+		return Object.values(this.fs.metadata).filter((meta) => meta && meta.type === "builtin").map((meta) => meta?.id).filter(Boolean);
+	}
+	/**
+	* The {@link Project} instance used for type reflection and module manipulation
+	*
+	* @see https://ts-morph.com/
+	*
+	* @remarks
+	* This instance is created lazily on first access.
+	*/
+	get program() {
+		if (!this.#program) this.#program = createProgram(this, { skipAddingFilesFromTsConfig: true });
+		return this.#program;
+	}
+	/**
+	* Gets the parser cache.
+	*/
+	get parserCache() {
+		if (!this.#parserCache) this.#parserCache = create({
+			cacheId: "parser",
+			cacheDir: this.cachePath,
+			ttl: 7200 * 1e3,
+			lruSize: 5e3,
+			persistInterval: 250
+		});
+		return this.#parserCache;
+	}
+	/**
+	* Gets the request cache.
+	*/
+	get requestCache() {
+		if (!this.#requestCache) this.#requestCache = create({
+			cacheId: "http",
+			cacheDir: this.cachePath,
+			ttl: 360 * 60 * 1e3,
+			lruSize: 5e3,
+			persistInterval: 250
+		});
+		return this.#requestCache;
+	}
+	/**
+	* A function to perform HTTP fetch requests
+	*
+	* @remarks
+	* This function uses a caching layer to avoid duplicate requests during the Powerlines process.
+	*
+	* @example
+	* ```ts
+	* const response = await context.fetch("https://api.example.com/data");
+	* const data = await response.json();
+	* ```
+	*
+	* @see https://github.com/nodejs/undici
+	*
+	* @param input - The URL to fetch.
+	* @param options - The fetch request options.
+	* @returns A promise that resolves to a response returned by the fetch.
+	*/
+	async fetch(input, options = {}) {
+		const cacheKey = murmurhash({
+			input: input.toString(),
+			options: JSON.stringify(options)
+		});
+		if (!this.config.skipCache && !options.skipCache) {
+			const cached = this.requestCache.get(cacheKey);
+			if (cached) return new Response(cached.body, {
+				status: cached.status,
+				statusText: cached.statusText,
+				headers: cached.headers
+			});
+		}
+		const response = await fetchRequest(input, {
+			timeout: 12e3,
+			...options
+		});
+		const result = {
+			body: await response.text(),
+			status: response.status,
+			statusText: response.statusText,
+			headers: Object.fromEntries(response.headers.entries())
+		};
+		if (!this.config.skipCache && !options.skipCache) try {
+			this.requestCache.set(cacheKey, result);
+		} catch {}
+		return new Response(result.body, {
+			status: result.status,
+			statusText: result.statusText,
+			headers: result.headers
+		});
+	}
+	/**
+	* Parse code using [Oxc-Parser](https://github.com/oxc/oxc) into an (ESTree-compatible)[https://github.com/estree/estree] AST object.
+	*
+	* @remarks
+	* This function can be used to parse TypeScript code into an AST for further analysis or transformation.
+	*
+	* @example
+	* ```ts
+	* const ast = context.parse("const x: number = 42;");
+	* ```
+	*
+	* @see https://rollupjs.org/plugin-development/#this-parse
+	* @see https://github.com/oxc/oxc
+	*
+	* @param code - The source code to parse.
+	* @param options - The options to pass to the parser.
+	* @returns An (ESTree-compatible)[https://github.com/estree/estree] AST object.
+	*/
+	async parse(code, options = {}) {
+		const cacheKey = murmurhash({
+			code,
+			options
+		});
+		let result;
+		if (!this.config.skipCache) {
+			result = this.parserCache.get(cacheKey);
+			if (result) return result;
+		}
+		result = await parse(`source.${options.lang || "ts"}`, code, {
+			...options,
+			sourceType: "module",
+			showSemanticErrors: this.config.mode === "development"
+		});
+		if (!this.config.skipCache) this.parserCache.set(cacheKey, result);
+		return result;
+	}
+	/**
+	* A helper function to resolve modules in the Virtual File System
+	*
+	* @remarks
+	* This function can be used to resolve modules relative to the project root directory.
+	*
+	* @example
+	* ```ts
+	* const resolved = await context.resolve("some-module", "/path/to/importer");
+	* ```
+	*
+	* @param id - The module to resolve.
+	* @param importer - An optional path to the importer module.
+	* @param options - Additional resolution options.
+	* @returns A promise that resolves to the resolved module path.
+	*/
+	async resolve(id, importer, options = {}) {
+		let moduleId = id;
+		if (this.config.build.alias) {
+			if (Array.isArray(this.config.build.alias)) {
+				const alias = this.config.build.alias.find((a) => match(moduleId, [a.find]));
+				if (alias) moduleId = alias.replacement;
+			} else if (isSetObject(this.config.build.alias) && this.config.build.alias[id]) moduleId = this.config.build.alias[id];
+		}
+		if (this.fs.isVirtual(moduleId)) {
+			const result = await this.fs.resolve(moduleId, importer, {
+				conditions: this.config.build.conditions,
+				extensions: this.config.build.extensions,
+				...options
+			});
+			if (!result) return;
+			return {
+				id: `\0${result}`,
+				external: this.config.projectType !== "application"
+			};
+		}
+		if (this.config.build.skipNodeModulesBundle) {
+			if (match(moduleId, this.resolvePatterns) || match(moduleId, this.config.build.noExternal)) return;
+			if (match(moduleId, this.config.build.external) || moduleId.startsWith("node:")) return {
+				id: moduleId,
+				external: true
+			};
+			if (!/^[A-Z]:[/\\]|^\.{0,2}\/|^\.{1,2}$/.test(moduleId)) return {
+				id: moduleId,
+				external: true
+			};
+		} else {
+			if (match(moduleId, this.config.build.noExternal)) return;
+			if (match(moduleId, this.config.build.external) || moduleId.startsWith("node:")) return {
+				id: moduleId,
+				external: true
+			};
+		}
+	}
+	/**
+	* A helper function to load modules from the Virtual File System
+	*
+	* @remarks
+	* This function can be used to load modules relative to the project root directory.
+	*
+	* @example
+	* ```ts
+	* const module = await context.load("some-module", "/path/to/importer");
+	* ```
+	*
+	* @param id - The module to load.
+	* @returns A promise that resolves to the loaded module.
+	*/
+	async load(id) {
+		const resolvedId = await this.fs.resolve(id);
+		if (!resolvedId) return;
+		const code = await this.fs.read(resolvedId);
+		if (!code) return;
+		return {
+			code,
+			map: null
+		};
+	}
+	/**
+	* Get the builtin virtual files that exist in the Powerlines virtual file system
+	*/
+	async getBuiltins() {
+		return Promise.all(Object.entries(this.fs.metadata).filter(([, meta]) => meta && meta.type === "builtin").map(async ([path, meta]) => {
+			const code = await this.fs.read(path);
+			return {
+				...meta,
+				path,
+				code
+			};
+		}));
+	}
+	/**
+	* Resolves a file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the file
+	* @param path - The path to write the file to
+	* @param options - Additional options for writing the file
+	*/
+	async emit(code, path, options = {}) {
+		if (isFunction(this.emitFile) && options.emitWithBundler) return this.emitFile({
+			needsCodeReference: options.needsCodeReference,
+			originalFileName: options.originalFileName,
+			fileName: path,
+			source: code,
+			type: "asset"
+		});
+		return this.fs.write(path, code, options);
+	}
+	/**
+	* Synchronously resolves a file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the file
+	* @param path - The path to write the file to
+	* @param options - Additional options for writing the file
+	*/
+	emitSync(code, path, options = {}) {
+		if (isFunction(this.emitFile) && options.emitWithBundler) return this.emitFile({
+			needsCodeReference: options.needsCodeReference,
+			originalFileName: options.originalFileName,
+			fileName: path,
+			source: code,
+			type: "asset"
+		});
+		return this.fs.writeSync(path, code, options);
+	}
+	/**
+	* Resolves a entry virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the entry file
+	* @param path - A path to write the entry file to
+	* @param options - Optional write file options
+	*/
+	async emitEntry(code, path, options = {}) {
+		const entryPath = isAbsolute(path) ? path : appendPath(path, this.entryPath);
+		this.entry ??= [];
+		this.entry.push({
+			name: options.name,
+			file: entryPath,
+			input: options.input,
+			output: options.output
+		});
+		return this.emit(code, entryPath, defu$1(omit(options, ["name"]), { meta: {
+			type: "entry",
+			properties: {
+				name: options.name,
+				output: options.output,
+				"input.file": options.input?.file,
+				"input.name": options.input?.name
+			}
+		} }));
+	}
+	/**
+	* Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the entry file
+	* @param path - A path to write the entry file to
+	* @param options - Optional write file options
+	*/
+	emitEntrySync(code, path, options = {}) {
+		const entryPath = isAbsolute(path) ? path : appendPath(path, this.entryPath);
+		this.entry ??= [];
+		this.entry.push({
+			name: options?.name,
+			file: entryPath,
+			input: options?.input,
+			output: options?.output
+		});
+		return this.emitSync(code, entryPath, defu$1(omit(options, ["name"]), { meta: {
+			type: "entry",
+			properties: {
+				name: options?.name,
+				output: options?.output,
+				"input.file": options?.input?.file,
+				"input.name": options?.input?.name
+			}
+		} }));
+	}
+	/**
+	* Resolves a builtin virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the builtin file
+	* @param id - The unique identifier of the builtin file
+	* @param path - An optional path to write the builtin file to
+	* @param options - Optional write file options
+	*/
+	async emitBuiltin(code, id, path, options = {}) {
+		return this.emit(code, path ? isAbsolute(path) ? path : joinPaths(this.builtinsPath, path) : appendPath(id, this.builtinsPath), defu$1(options, { meta: { type: "builtin" } }));
+	}
+	/**
+	* Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the builtin file
+	* @param id - The unique identifier of the builtin file
+	* @param path - An optional path to write the builtin file to
+	* @param options - Optional write file options
+	*/
+	emitBuiltinSync(code, id, path, options = {}) {
+		return this.emitSync(code, path ? isAbsolute(path) ? path : joinPaths(this.builtinsPath, path) : appendPath(id, this.builtinsPath), defu$1(options, { meta: { type: "builtin" } }));
+	}
+	/**
+	* Update the context using a new user configuration options
+	*
+	* @param userConfig - The new user configuration options.
+	*/
+	async withUserConfig(userConfig, options = { isHighPriority: true }) {
+		this.mergeUserConfig(userConfig);
+		await this.init(this.config.userConfig, options);
+	}
+	/**
+	* Update the context using a new inline configuration options
+	*
+	* @param inlineConfig - The new inline configuration options.
+	*/
+	async withInlineConfig(inlineConfig, options = { isHighPriority: true }) {
+		this.config.inlineConfig = inlineConfig;
+		if (inlineConfig.command === "new") {
+			const workspacePackageJsonPath = joinPaths(this.workspaceConfig.workspaceRoot, "package.json");
+			if (!existsSync(workspacePackageJsonPath)) throw new Error(`The workspace package.json file could not be found at ${workspacePackageJsonPath}`);
+			this.packageJson = await readJsonFile(workspacePackageJsonPath);
+			this.workspaceConfig.repository ??= isSetString(this.packageJson?.repository) ? this.packageJson.repository : this.packageJson?.repository?.url;
+		}
+		await this.init(this.config.inlineConfig, options);
+	}
+	/**
+	* A logging function for fatal messages
+	*
+	* @param message - The message to log.
+	*/
+	fatal(message) {
+		this.log(LogLevelLabel.FATAL, isString(message) ? message : StormJSON.stringify(message));
+	}
+	/**
+	* A logging function for error messages
+	*
+	* @param message - The message to log.
+	*/
+	error(message) {
+		this.log(LogLevelLabel.ERROR, isString(message) ? message : StormJSON.stringify(message));
+	}
+	/**
+	* A logging function for warning messages
+	*
+	* @param message - The message to log.
+	*/
+	warn(message) {
+		this.log(LogLevelLabel.WARN, isString(message) ? message : StormJSON.stringify(message));
+	}
+	/**
+	* A logging function for informational messages
+	*
+	* @param message - The message to log.
+	*/
+	info(message) {
+		this.log(LogLevelLabel.INFO, isString(message) ? message : StormJSON.stringify(message));
+	}
+	/**
+	* A logging function for debug messages
+	*
+	* @param message - The message to log.
+	*/
+	debug(message) {
+		this.log(LogLevelLabel.DEBUG, isString(message) ? message : StormJSON.stringify(message));
+	}
+	/**
+	* A logging function for trace messages
+	*
+	* @param message - The message to log.
+	*/
+	trace(message) {
+		this.log(LogLevelLabel.TRACE, isString(message) ? message : StormJSON.stringify(message));
+	}
+	/**
+	* Create a new logger instance
+	*
+	* @param name - The name to use for the logger instance
+	* @returns A logger function
+	*/
+	createLog(name = null) {
+		return createLog(name, {
+			...this.config,
+			logLevel: isNull(this.config.logLevel) ? "silent" : this.config.logLevel
+		});
+	}
+	/**
+	* Extend the current logger instance with a new name
+	*
+	* @param name - The name to use for the extended logger instance
+	* @returns A logger function
+	*/
+	extendLog(name) {
+		return extendLog(this.log, name);
+	}
+	/**
+	* Generates a checksum representing the current context state
+	*
+	* @param root - The root directory of the project to generate the checksum for
+	* @returns A promise that resolves to a string representing the checksum
+	*/
+	async generateChecksum(root = this.config.projectRoot) {
+		this.#checksum = await hashDirectory(root, { ignore: [
+			"node_modules",
+			".git",
+			".nx",
+			".cache",
+			".storm",
+			"tmp",
+			"dist"
+		] });
+		return this.#checksum;
+	}
+	/**
+	* Creates a new StormContext instance.
+	*
+	* @param workspaceConfig - The workspace configuration.
+	*/
+	constructor(workspaceConfig) {
+		this.#workspaceConfig = workspaceConfig;
+		envPathCache.set({
+			workspaceRoot: workspaceConfig.workspaceRoot,
+			framework: "powerlines"
+		}, getEnvPaths({
+			orgId: (isSetObject(workspaceConfig.organization) ? workspaceConfig.organization.name : workspaceConfig.organization) || "storm-software",
+			appId: "powerlines",
+			workspaceRoot: workspaceConfig.workspaceRoot
+		}));
+	}
+	/**
+	* The resolved configuration for this context
+	*/
+	resolvedConfig = {};
+	/**
+	* A logger function specific to this context
+	*/
+	logFn;
+	/**
+	* Initialize the context with the provided configuration options
+	*
+	* @param config - The partial user configuration to use for initialization.
+	*/
+	async init(config = {}, options = { isHighPriority: true }) {
+		const cacheKey = {
+			projectRoot: config.root ?? this.config.projectRoot ?? this.config.userConfig?.root ?? this.config.inlineConfig?.root,
+			mode: (config.mode ?? this.config.mode) || this.workspaceConfig.mode,
+			skipCache: config.skipCache ?? this.config.skipCache ?? false,
+			configFile: config.configFile ?? this.config.configFile,
+			framework: config.framework ?? this.config.framework ?? "powerlines",
+			command: this.config.inlineConfig?.command
+		};
+		if (configCache.has(cacheKey)) {
+			const result = configCache.get(cacheKey);
+			this.projectJson = result.projectJson;
+			this.packageJson = result.packageJson;
+			this.#checksum = result.checksum;
+			this.resolver = result.resolver;
+			this.mergeUserConfig(result.userConfig.config, this.config.userConfig);
+		} else {
+			const projectJsonPath = joinPaths(cacheKey.projectRoot, "project.json");
+			if (existsSync(projectJsonPath)) this.projectJson = await readJsonFile(projectJsonPath);
+			const packageJsonPath = joinPaths(cacheKey.projectRoot, "package.json");
+			if (existsSync(packageJsonPath)) this.packageJson = await readJsonFile(packageJsonPath);
+			this.#checksum = await this.generateChecksum(cacheKey.projectRoot);
+			this.resolver = createResolver({
+				workspaceRoot: this.workspaceConfig.workspaceRoot,
+				projectRoot: cacheKey.projectRoot,
+				cacheDir: this.cachePath,
+				mode: cacheKey.mode,
+				logLevel: config.logLevel || this.config?.logLevel || this.workspaceConfig.logLevel || "info",
+				skipCache: cacheKey.skipCache
+			});
+			const userConfig = await loadUserConfigFile(cacheKey.projectRoot, this.workspaceConfig.workspaceRoot, this.resolver, cacheKey.command, cacheKey.mode, cacheKey.configFile, cacheKey.framework);
+			this.mergeUserConfig(userConfig.config);
+			configCache.set(cacheKey, {
+				projectJson: this.projectJson,
+				packageJson: this.packageJson,
+				checksum: this.#checksum,
+				resolver: this.resolver,
+				userConfig
+			});
+		}
+		config.tsconfig ??= getTsconfigFilePath(this.workspaceConfig.workspaceRoot, cacheKey.projectRoot, config.tsconfig);
+		if (isSetObject(config)) this.resolvedConfig = defu$1({
+			inlineConfig: this.config.inlineConfig,
+			userConfig: this.config.userConfig
+		}, options.isHighPriority ? this.#getConfigProps(config) : {}, {
+			command: this.config.inlineConfig?.command,
+			...this.#getConfigProps(this.config.inlineConfig)
+		}, this.#getConfigProps(this.config.userConfig), {
+			mode: this.workspaceConfig?.mode,
+			logLevel: this.workspaceConfig?.logLevel,
+			skipCache: this.workspaceConfig?.skipCache
+		}, {
+			name: this.projectJson?.name || this.packageJson?.name,
+			version: this.packageJson?.version,
+			description: this.packageJson?.description,
+			sourceRoot: this.projectJson?.sourceRoot || appendPath("src", cacheKey.projectRoot),
+			output: defu$1(config.output ?? {}, {
+				outputPath: cacheKey.projectRoot ? joinPaths(this.workspaceConfig?.directories?.build || "dist", cacheKey.projectRoot) : this.workspaceConfig?.directories?.build || "dist",
+				artifactsPath: joinPaths(cacheKey.projectRoot, `.${config.framework ?? "powerlines"}`),
+				dts: joinPaths(cacheKey.projectRoot, `${config.framework ?? "powerlines"}.d.ts`),
+				builtinPrefix: config.framework ?? "powerlines",
+				assets: [
+					{ glob: "LICENSE" },
+					{
+						input: cacheKey.projectRoot,
+						glob: "*.md"
+					},
+					{
+						input: cacheKey.projectRoot,
+						glob: "package.json"
+					}
+				]
+			})
+		}, options.isHighPriority ? {} : this.#getConfigProps(config), {
+			inlineConfig: {},
+			userConfig: {},
+			framework: "powerlines",
+			platform: "neutral",
+			mode: "production",
+			projectType: "application",
+			logLevel: "info",
+			preview: false,
+			environments: {},
+			transform: { babel: {
+				plugins: [],
+				presets: []
+			} },
+			lint: { eslint: {} },
+			build: {
+				target: "esnext",
+				override: {}
+			}
+		});
+		this.config.entry = getUniqueEntries(this.config.entry);
+		if (this.config.name?.startsWith("@") && this.config.name.split("/").filter(Boolean).length > 1) this.config.name = this.config.name.split("/").filter(Boolean)[1];
+		this.config.title ??= titleCase(this.config.name);
+		this.config.organization ??= (isSetObject(this.workspaceConfig.organization) ? this.workspaceConfig.organization.name : this.workspaceConfig.organization) || (isSetObject(this.packageJson?.author) ? this.packageJson?.author?.name : this.packageJson?.author) || this.config.name;
+		if (this.config.userConfig.build?.external) this.config.userConfig.build.external = getUnique(this.config.userConfig.build.external);
+		if (this.config.userConfig.build?.noExternal) this.config.userConfig.build.noExternal = getUnique(this.config.userConfig.build.noExternal);
+		if (this.config.build.external) this.config.build.external = getUnique(this.config.build.external);
+		if (this.config.build.noExternal) this.config.build.noExternal = getUnique(this.config.build.noExternal);
+		this.config.output.format = getUnique(toArray(this.config.output?.format ?? (this.config.projectType === "library" ? ["cjs", "esm"] : ["esm"])));
+		if (this.config.projectRoot && this.config.projectRoot !== "." && this.config.projectRoot !== "./" && this.config.projectRoot !== this.workspaceConfig.workspaceRoot) {
+			this.config.output.outputPath ??= joinPaths("dist", this.config.projectRoot);
+			this.config.output.buildPath ??= joinPaths(this.config.projectRoot, "dist");
+		} else {
+			this.config.output.outputPath ??= "dist";
+			this.config.output.buildPath ??= "dist";
+		}
+		this.config.output.assets = getUniqueBy(this.config.output.assets.map((asset) => {
+			return {
+				glob: isSetObject(asset) ? asset.glob : asset,
+				input: isString(asset) || !asset.input || asset.input === "." || asset.input === "/" || asset.input === "./" ? this.workspaceConfig.workspaceRoot : isParentPath(asset.input, this.workspaceConfig.workspaceRoot) || asset.input === this.workspaceConfig.workspaceRoot ? asset.input : appendPath(asset.input, this.workspaceConfig.workspaceRoot),
+				output: isSetObject(asset) && asset.output ? isParentPath(asset.output, this.workspaceConfig.workspaceRoot) ? asset.output : appendPath(joinPaths(this.config.output.outputPath, replacePath(replacePath(asset.output, replacePath(this.config.output.outputPath, this.workspaceConfig.workspaceRoot)), this.config.output.outputPath)), this.workspaceConfig.workspaceRoot) : appendPath(this.config.output.outputPath, this.workspaceConfig.workspaceRoot),
+				ignore: isSetObject(asset) && asset.ignore ? toArray(asset.ignore) : void 0
+			};
+		}), (a) => `${a.input}-${a.glob}-${a.output}`);
+		this.config.plugins = (this.config.plugins ?? []).filter(Boolean).reduce((ret, plugin) => {
+			if (isPlugin(plugin) && checkDedupe(plugin, ret.filter((p) => isPlugin(p)))) return ret;
+			ret.push(plugin);
+			return ret;
+		}, []);
+		if (this.config.tsconfig) this.config.tsconfig = replacePathTokens(this, this.config.tsconfig);
+		if (this.config.output.dts) this.config.output.dts = replacePathTokens(this, this.config.output.dts);
+		if (this.config.build.polyfill) this.config.build.polyfill = this.config.build.polyfill.map((polyfill) => replacePathTokens(this, polyfill));
+		if (this.config.output.assets) this.config.output.assets = this.config.output.assets.map((asset) => ({
+			...asset,
+			glob: replacePathTokens(this, asset.glob),
+			ignore: asset.ignore ? asset.ignore.map((ignore) => replacePathTokens(this, ignore)) : void 0,
+			input: replacePathTokens(this, asset.input),
+			output: replacePathTokens(this, asset.output)
+		}));
+		this.#fs ??= await VirtualFileSystem.create(this);
+	}
+	mergeUserConfig(from = {}, into = this.config.userConfig ?? {}) {
+		this.config.userConfig = defu$1({ entry: Array.isArray(from.entry) && from.entry.length > 0 ? from.entry : Array.isArray(into?.entry) && into.entry.length > 0 ? into.entry : [] }, omit(from ?? {}, ["entry"]), omit(into ?? {}, ["entry"]));
+		if (this.config.userConfig.output?.format) this.config.userConfig.output.format = getUnique(toArray(this.config.userConfig.output?.format));
+		this.config.userConfig.plugins = (this.config.userConfig.plugins ?? []).filter(Boolean).reduce((ret, plugin) => {
+			if (isPlugin(plugin) && checkDedupe(plugin, ret.filter((p) => isPlugin(p)))) return ret;
+			ret.push(plugin);
+			return ret;
+		}, []);
+	}
+};
+
+//#endregion
+export { PowerlinesContext };