@powerlines/core 0.15.0 → 0.15.1

package/dist/lib/generate-types.mjs

@@ -0,0 +1,368 @@
+import { format } from "./utilities/format.mjs";
+import { callHook } from "./hooks.mjs";
+import { createProgram } from "./typescript/ts-morph.mjs";
+import { getTypescriptFileHeader } from "./utilities/file-header.mjs";
+import { appendPath } from "@stryke/path/append";
+import { findFileName } from "@stryke/path/file-path-fns";
+import { replaceExtension, replacePath } from "@stryke/path/replace";
+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 { toArray } from "@stryke/convert/to-array";
+import { isObject } from "@stryke/type-checks/is-object";
+import { getUnique } from "@stryke/helpers/get-unique";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { resolvePackage } from "@stryke/fs/resolve";
+import { prettyBytes } from "@stryke/string-format/pretty-bytes";
+import { DiagnosticCategory, Node, Project } from "ts-morph";
+
+//#region src/lib/generate-types.ts
+/**
+* Formats the generated TypeScript types source code.
+*
+* @param code - The generated TypeScript code.
+* @returns The formatted TypeScript code.
+*/
+function formatTypes(code = "") {
+	return code.replaceAll("#private;", "").replace(/__Ω/g, "");
+}
+async function extractModuleDeclarations(ctx, filePath, name, text) {
+	const imports = [];
+	const exports = [];
+	const comment = text.match(new RegExp(`\\/\\*\\*(?s:.)*?@module\\s+${ctx.context.config.framework?.name ?? "powerlines"}:${name}(?s:.)*?\\*\\/\\s+`))?.find((comment) => isSetString(comment?.trim()));
+	const sourceFile = new Project({ useInMemoryFileSystem: true }).createSourceFile("module.d.ts", text);
+	for (const ref of sourceFile.getTypeReferenceDirectives()) if (ref.getFileName() && !ctx.context.builtins.some((builtin) => ref.getFileName().endsWith(builtin))) imports.push({
+		name: ref.getFileName(),
+		ambient: true
+	});
+	for (const statement of sourceFile.getStatements()) if (Node.isImportDeclaration(statement)) {
+		const moduleSpec = statement.getModuleSpecifierValue();
+		if (statement.getNamespaceImport()) imports.push({
+			name: moduleSpec,
+			specifiers: [{ name: statement.getNamespaceImport().getText() }],
+			all: true
+		});
+		else if (statement.getNamedImports().length > 0 || statement.getDefaultImport()) {
+			const specifiers = [];
+			if (statement.getDefaultImport()) specifiers.push({
+				name: statement.getDefaultImport().getText(),
+				default: true,
+				type: statement.isTypeOnly()
+			});
+			statement.getNamedImports().forEach((named) => {
+				specifiers.push({
+					name: named.getName(),
+					alias: named.getAliasNode()?.getText(),
+					type: statement.isTypeOnly()
+				});
+			});
+			imports.push({
+				name: moduleSpec,
+				specifiers
+			});
+		}
+	} else if (Node.isExportDeclaration(statement)) {
+		const moduleSpec = statement.getModuleSpecifierValue();
+		if (moduleSpec) {
+			let resolvedSpec = moduleSpec;
+			if (!ctx.context.builtins.includes(moduleSpec)) if (ctx.emitted.has(moduleSpec)) resolvedSpec = ctx.emitted.get(moduleSpec);
+			else {
+				const resolvedModule = await ctx.context.resolve(moduleSpec, filePath);
+				if (isSetString(resolvedModule?.id)) resolvedSpec = resolvedModule.id;
+			}
+			const namedExports = statement.getNamedExports();
+			if (namedExports.length > 0) exports.push({
+				name: resolvedSpec,
+				text: statement.getText(),
+				fullText: statement.getFullText(),
+				specifiers: namedExports.map((named) => ({
+					name: named.getName(),
+					alias: named.getAliasNode()?.getText(),
+					type: statement.isTypeOnly()
+				})),
+				comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n").trim()
+			});
+			else exports.push({
+				name: resolvedSpec,
+				text: statement.getText(),
+				fullText: statement.getFullText(),
+				all: true,
+				comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n").trim()
+			});
+		} else {
+			const specifiers = statement.getNamedExports().map((named) => ({
+				name: named.getName(),
+				alias: named.getAliasNode()?.getText(),
+				type: statement.isTypeOnly()
+			}));
+			if (specifiers.length > 0) exports.push({
+				text: statement.getText(),
+				fullText: statement.getFullText(),
+				specifiers,
+				comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+			});
+		}
+	} else if (Node.isExportAssignment(statement)) exports.push({
+		text: statement.getText(),
+		fullText: statement.getFullText(),
+		comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+	});
+	else if (Node.isFunctionDeclaration(statement) && statement.isExported() && statement.getNameNode()) exports.push({
+		text: statement.getText(),
+		fullText: statement.getFullText(),
+		specifiers: [{ name: statement.getNameNode().getText() }],
+		comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+	});
+	else if (Node.isVariableStatement(statement) && statement.isExported()) exports.push({
+		text: statement.getText(),
+		fullText: statement.getFullText(),
+		specifiers: statement.getDeclarationList().getDeclarations().filter((decl) => decl.getNameNode() && Node.isIdentifier(decl.getNameNode())).map((decl) => ({ name: decl.getNameNode().getText() })),
+		comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+	});
+	else if (Node.isClassDeclaration(statement) && statement.isExported()) {
+		const nameNode = statement.getNameNode();
+		exports.push({
+			text: statement.getText(),
+			fullText: statement.getFullText(),
+			specifiers: nameNode ? [{ name: nameNode.getText() }] : void 0,
+			comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+		});
+	} else if (Node.isInterfaceDeclaration(statement) && statement.isExported()) {
+		const nameNode = statement.getNameNode();
+		exports.push({
+			text: statement.getText(),
+			fullText: statement.getFullText(),
+			specifiers: nameNode ? [{ name: nameNode.getText() }] : void 0,
+			comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+		});
+	} else if (Node.isTypeAliasDeclaration(statement) && statement.isExported()) {
+		const nameNode = statement.getNameNode();
+		exports.push({
+			text: statement.getText(),
+			fullText: statement.getFullText(),
+			specifiers: nameNode ? [{ name: nameNode.getText() }] : void 0,
+			comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+		});
+	} else if (ctx.context.config.output.sourceMap || !statement.getFullText().includes("//# sourceMappingURL=")) exports.push({
+		text: statement.getText(),
+		fullText: statement.getFullText(),
+		comment: statement.getLeadingCommentRanges().filter((c) => isSetString(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+	});
+	return {
+		name,
+		text,
+		sourceFile,
+		comment,
+		imports,
+		exports
+	};
+}
+/**
+* Emits TypeScript declaration types for the provided files using the given TypeScript configuration.
+*
+* @param context - The context containing options and environment paths.
+* @param files - The list of files to generate types for.
+* @returns A promise that resolves to the generated TypeScript declaration types.
+*/
+async function emitBuiltinTypes(context, files) {
+	if (files.length === 0) {
+		context.debug("No files provided for TypeScript types generation. Typescript compilation for built-in modules will be skipped.");
+		return {
+			code: "",
+			directives: []
+		};
+	}
+	context.debug(`Running the TypeScript compiler for ${files.length} generated built-in module files.`);
+	const program = createProgram(context, {
+		skipAddingFilesFromTsConfig: true,
+		compilerOptions: {
+			declaration: true,
+			declarationMap: false,
+			emitDeclarationOnly: true,
+			sourceMap: false,
+			outDir: replacePath(context.builtinsPath, context.config.cwd),
+			composite: false,
+			incremental: false,
+			tsBuildInfoFile: void 0
+		}
+	});
+	program.addSourceFilesAtPaths(files);
+	const emitResult = program.emitToMemory({ emitOnlyDtsFiles: true });
+	const diagnostics = emitResult.getDiagnostics();
+	if (diagnostics && diagnostics.length > 0) if (diagnostics.some((d) => d.getCategory() === DiagnosticCategory.Error)) throw new Error(`The Typescript emit process failed while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === DiagnosticCategory.Error).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	else if (diagnostics.some((d) => d.getCategory() === DiagnosticCategory.Warning)) context.warn(`The Typescript emit process completed with warnings while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === DiagnosticCategory.Warning).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	else context.debug(`The Typescript emit process completed with diagnostic messages while generating built-in types: \n ${diagnostics.map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	const emittedFiles = emitResult.getFiles();
+	context.debug(`The TypeScript compiler emitted ${emittedFiles.length} files for built-in types.`);
+	if (emittedFiles.length === 0) {
+		context.warn("The TypeScript compiler did not emit any files for built-in types. This may indicate an issue with the TypeScript configuration or the provided files.");
+		return {
+			code: "",
+			directives: []
+		};
+	}
+	const ctx = {
+		context,
+		modules: [],
+		emitted: /* @__PURE__ */ new Map()
+	};
+	await Promise.all(emittedFiles.map(async (emittedFile) => {
+		const filePath = appendPath(emittedFile.filePath, context.config.cwd);
+		if (!filePath.endsWith(".map") && findFileName(filePath) !== "tsconfig.tsbuildinfo" && isParentPath(filePath, context.builtinsPath)) {
+			const moduleName = replaceExtension(replacePath(replacePath(filePath, context.builtinsPath), replacePath(context.builtinsPath, context.config.cwd)), "", { fullExtension: true });
+			if (context.builtins.includes(moduleName)) {
+				ctx.emitted.set(filePath, moduleName);
+				ctx.modules.push(await extractModuleDeclarations(ctx, filePath, moduleName, emittedFile.text));
+			}
+		}
+	}));
+	const commonDeclarations = [];
+	for (const mod of ctx.modules) for (const importRef of mod.imports.filter((importRef) => context.builtins.some((builtin) => importRef.name.endsWith(`:${builtin}`)))) {
+		const moduleRef = ctx.modules.find((moduleRef) => importRef.name.endsWith(`:${moduleRef.name}`));
+		if (moduleRef) {
+			let declaration;
+			for (const decl of moduleRef.exports.filter((decl) => isSetObject(decl))) {
+				const specifiers = decl.specifiers?.filter((specifier) => importRef.specifiers?.some((s) => (specifier.alias ? specifier.alias : specifier.name) === (s.alias ? s.alias : s.name)));
+				if (specifiers && specifiers.length > 0) {
+					importRef.specifiers = importRef.specifiers?.filter((s) => !specifiers.some((specifier) => (specifier.alias ? specifier.alias : specifier.name) === (s.alias ? s.alias : s.name)));
+					if (importRef.specifiers && importRef.specifiers.length === 0 && !importRef.all && !importRef.ambient) mod.imports = mod.imports.filter((imp) => imp.name !== importRef.name);
+					declaration = decl;
+					break;
+				}
+			}
+			if (declaration) {
+				for (const decl of moduleRef.exports.filter((decl) => isSetObject(decl) && !decl.specifiers?.some((s) => declaration?.specifiers?.some((specifier) => (specifier.alias ? specifier.alias : specifier.name) === (s.alias ? s.alias : s.name))))) {
+					const exportModuleRef = decl;
+					if ((exportModuleRef.specifiers?.some((s) => s.alias || s.name) || exportModuleRef.name) && new RegExp(`(^|\\s|\\n|\\r\\n|\\(|\\)|<|>|{|}|\\[|\\]|\\!|\\?|\\.|,|\\*|&|:)(${exportModuleRef.specifiers?.map((s) => `${s.alias ? `${s.alias}|` : ""}${s.name}`).join("|") || exportModuleRef.name})($|\\s|\\n|\\r\\n|\\(|\\)|<|>|{|}|\\[|\\]|\\!|\\?|\\.|,|\\*|&|:|;)`).test(declaration.text)) commonDeclarations.push(exportModuleRef);
+				}
+				commonDeclarations.push(declaration);
+			}
+		}
+	}
+	let code = "";
+	const directives = [];
+	for (const commonDeclaration of commonDeclarations) {
+		code += formatTypes(`${commonDeclaration.comment?.trim() ? commonDeclaration.comment.trim() : ""}${commonDeclaration.comment?.trim() ? "\n" : ""}${formatTypes(commonDeclaration.text.replace(/\s*export\s*/, "").replace(/\s*declare\s*interface\s*/, "interface ").replace(/\s*declare\s*type\s*/, "type "))}`);
+		code += "\n\n";
+	}
+	for (const mod of ctx.modules) {
+		code += mod.comment ? `${mod.comment.trim()}\n` : "";
+		code += `declare module "${context.config.framework?.name ?? "powerlines"}:${mod.name}" { \n`;
+		for (const importRef of mod.imports) if (importRef.ambient) code += directives.push(importRef.name);
+		else if (importRef.all) code += `\timport * as ${findFileName(importRef.name)} from "${importRef.name}";\n`;
+		else if (importRef.specifiers) {
+			const typeOnly = importRef.specifiers.every((s) => s.type) ? " type" : "";
+			const specifiers = importRef.specifiers.map((s) => s.alias ? `${s.name} as ${s.alias}` : s.name).join(", ");
+			code += `\timport${typeOnly} { ${specifiers} } from "${importRef.name}";\n`;
+		}
+		if (mod.imports.length > 0) code += "\n";
+		for (const exportRef of mod.exports.filter((e) => isString(e) || !e.specifiers || !commonDeclarations.some((commonDecl) => commonDecl.specifiers && commonDecl.specifiers.some((specifier) => e.specifiers?.some((s) => (s.alias ? s.alias : s.name) === (specifier.alias ? specifier.alias : specifier.name)))))) if (isSetString(exportRef)) code += `${exportRef}\n`;
+		else if (exportRef.name) {
+			if (exportRef.all) code += `${exportRef.comment?.trim() ? exportRef.comment.trim() : ""}${exportRef.comment?.trim() ? "\n" : ""}export * from "${exportRef.name}";\n`;
+			else if (exportRef.specifiers) {
+				if (exportRef.comment?.trim()) code += `${exportRef.comment.trim()}\n`;
+				code += `\texport${exportRef.specifiers.every((s) => s.type) ? " type" : ""} { ${exportRef.specifiers.map((s) => s.alias ? `${s.name} as ${s.alias}` : s.name).join(", ")} } from "${exportRef.name}";\n`;
+			}
+		} else code += `${exportRef.comment?.trim() ? exportRef.comment.trim() : ""}${exportRef.comment?.trim() ? "\n" : ""}${formatTypes(exportRef.text.replace(/\s*export\s*declare\s*/, "export ").replace(/\s*declare\s*/, " "))}\n`;
+		mod.exports.filter((e) => !isString(e) && e.specifiers && commonDeclarations.some((commonDeclaration) => commonDeclaration.specifiers && commonDeclaration.specifiers.some((specifier) => e.specifiers?.some((s) => (s.alias ? s.alias : s.name) === (specifier.alias ? specifier.alias : specifier.name))))).forEach((e, i, arr) => {
+			if (i === 0) code += "\nexport { ";
+			else code += ", ";
+			code += `${e?.specifiers?.filter((s) => commonDeclarations.some((commonDeclaration) => commonDeclaration.specifiers && commonDeclaration.specifiers.some((specifier) => (s.alias ? s.alias : s.name) === (specifier.alias ? specifier.alias : specifier.name)))).map((s) => s.alias ? `${s.name} as ${s.alias}` : s.name).join(", ") || ""}`;
+			if (i === arr.length - 1) code += ` };\n`;
+		});
+		code += "}";
+		code += "\n\n";
+	}
+	code = await format(context, context.typesPath, code);
+	context.debug(`A TypeScript declaration file (size: ${prettyBytes(new Blob(toArray(code)).size)}) emitted for the built-in modules types.`);
+	return {
+		code,
+		directives
+	};
+}
+/**
+* Generate the Powerlines TypeScript declaration file
+*
+* @param context - The execution context for generating the TypeScript declaration file, which provides access to the project configuration, environment, and utility functions for performing the generation. The context is used to manage the state and behavior of the generation process, allowing for hooks to be called at different stages and for environment-specific configurations to be applied.
+* @param env - The environment context to use for generating the TypeScript declaration file
+*/
+async function handleTypes(context, env) {
+	env.debug(`Preparing the TypeScript definitions for the Powerlines project.`);
+	if (env.fs.existsSync(env.typesPath)) await env.fs.remove(env.typesPath);
+	if (!await resolvePackage("typescript")) throw new Error("Could not resolve TypeScript package location. Please ensure TypeScript is installed.");
+	env.debug("Running TypeScript compiler for built-in runtime module files.");
+	let { code, directives } = await emitBuiltinTypes(env, (await env.getBuiltins()).reduce((ret, builtin) => {
+		const formatted = replacePath(builtin.path, env.config.cwd);
+		if (!ret.includes(formatted)) ret.push(formatted);
+		return ret;
+	}, []));
+	env.debug(`Generating TypeScript declaration file ${env.typesPath}.`);
+	const merge = async (currentResult, previousResult) => {
+		if (!isSetString(currentResult) && !isSetObject(currentResult) && !isSetString(previousResult) && !isSetObject(previousResult)) return {
+			code,
+			directives
+		};
+		const previous = (await format(env, env.typesPath, isSetString(previousResult) ? previousResult : isSetObject(previousResult) ? previousResult.code : "")).trim().replace(code, "").trim();
+		const current = (await format(env, env.typesPath, isSetString(currentResult) ? currentResult : isSetObject(currentResult) ? currentResult.code : "")).trim().replace(previous, "").trim().replace(code, "").trim();
+		return {
+			directives: [...isSetObject(currentResult) && currentResult.directives ? currentResult.directives : [], ...isSetObject(previousResult) && previousResult.directives ? previousResult.directives : []],
+			code: await format(env, env.typesPath, `${!previous.includes(getTypescriptFileHeader(env)) && !current.includes(getTypescriptFileHeader(env)) ? `${code}\n` : ""}${previous}\n${current}`.trim())
+		};
+	};
+	const asNextParam = (previousResult) => isObject(previousResult) ? previousResult.code : previousResult;
+	let result = await callHook(context, "types", {
+		environment: env,
+		sequential: true,
+		order: "pre",
+		result: "merge",
+		merge,
+		asNextParam
+	}, code);
+	if (result) {
+		if (isSetObject(result)) {
+			code = result.code;
+			if (Array.isArray(result.directives) && result.directives.length > 0) directives = getUnique([...directives, ...result.directives]).filter(Boolean);
+		} else if (isSetString(result)) code = result;
+	}
+	result = await callHook(context, "types", {
+		environment: env,
+		sequential: true,
+		order: "normal",
+		result: "merge",
+		merge,
+		asNextParam
+	}, code);
+	if (result) {
+		if (isSetObject(result)) {
+			code = result.code;
+			if (Array.isArray(result.directives) && result.directives.length > 0) directives = getUnique([...directives, ...result.directives]).filter(Boolean);
+		} else if (isSetString(result)) code = result;
+	}
+	result = await callHook(context, "types", {
+		environment: env,
+		sequential: true,
+		order: "post",
+		result: "merge",
+		merge,
+		asNextParam
+	}, code);
+	if (result) {
+		if (isSetObject(result)) {
+			code = result.code;
+			if (Array.isArray(result.directives) && result.directives.length > 0) directives = getUnique([...directives, ...result.directives]).filter(Boolean);
+		} else if (isSetString(result)) code = result;
+	}
+	if (isSetString(code?.trim()) || directives.length > 0) await env.fs.write(env.typesPath, `${directives.length > 0 ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
+
+` : ""}${getTypescriptFileHeader(env, {
+		directive: null,
+		prettierIgnore: false
+	})}
+
+${formatTypes(code)}
+`);
+}
+
+//#endregion
+export { emitBuiltinTypes, formatTypes, handleTypes };
+//# sourceMappingURL=generate-types.mjs.map

package/dist/lib/generate-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-types.mjs","names":[],"sources":["../../src/lib/generate-types.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\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/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\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 { resolvePackage } from \"@stryke/fs/resolve\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { replaceExtension, replacePath } from \"@stryke/path/replace\";\nimport { prettyBytes } from \"@stryke/string-format/pretty-bytes\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { DiagnosticCategory, Node, Project, SourceFile } from \"ts-morph\";\nimport { ResolvedConfig } from \"../types/config\";\nimport {\n  Context,\n  EnvironmentContext,\n  ExecutionContext\n} from \"../types/context\";\nimport { TypesResult } from \"../types/plugin\";\nimport { callHook } from \"./hooks\";\nimport { createProgram } from \"./typescript/ts-morph\";\nimport { getTypescriptFileHeader } from \"./utilities/file-header\";\nimport { format } from \"./utilities/format\";\n\ninterface ModuleExportSpecifier {\n  name: string;\n  alias?: string;\n  default?: boolean;\n  type?: boolean;\n}\n\ninterface ModuleReference {\n  name?: string;\n  specifiers?: ModuleExportSpecifier[];\n  all?: boolean;\n}\n\ninterface ImportModuleReference extends ModuleReference {\n  name: string;\n  ambient?: boolean;\n}\n\ninterface ExportModuleReference extends ModuleReference {\n  text: string;\n  fullText: string;\n  comment?: string;\n}\n\ninterface ModuleDeclaration {\n  name: string;\n  text: string;\n  sourceFile: SourceFile;\n  comment?: string;\n  exports: (ExportModuleReference | string)[];\n  imports: ImportModuleReference[];\n}\n\nexport interface TypegenContext {\n  context: Context;\n  emitted: Map<string, string>;\n  modules: ModuleDeclaration[];\n}\n\n/**\n * Formats the generated TypeScript types source code.\n *\n * @param code - The generated TypeScript code.\n * @returns The formatted TypeScript code.\n */\nexport function formatTypes(code = \"\"): string {\n  return code.replaceAll(\"#private;\", \"\").replace(/__Ω/g, \"\");\n}\n\nasync function extractModuleDeclarations(\n  ctx: TypegenContext,\n  filePath: string,\n  name: string,\n  text: string\n): Promise<ModuleDeclaration> {\n  const imports: ImportModuleReference[] = [];\n  const exports: (ExportModuleReference | string)[] = [];\n\n  const comment = text\n    .match(\n      new RegExp(\n        `\\\\/\\\\*\\\\*(?s:.)*?@module\\\\s+${\n          ctx.context.config.framework?.name ?? \"powerlines\"\n        }:${name}(?s:.)*?\\\\*\\\\/\\\\s+`\n      )\n    )\n    ?.find(comment => isSetString(comment?.trim()));\n\n  // Parse the emitted .d.ts content using an in-memory ts-morph project\n  const project = new Project({ useInMemoryFileSystem: true });\n  const sourceFile = project.createSourceFile(\"module.d.ts\", text);\n\n  // Collect /// <reference types=\"...\" /> directives as ambient dependencies\n  for (const ref of sourceFile.getTypeReferenceDirectives()) {\n    if (\n      ref.getFileName() &&\n      !ctx.context.builtins.some(builtin => ref.getFileName().endsWith(builtin))\n    ) {\n      imports.push({\n        name: ref.getFileName(),\n        ambient: true\n      });\n    }\n  }\n\n  for (const statement of sourceFile.getStatements()) {\n    // --- Import declarations ---\n    if (Node.isImportDeclaration(statement)) {\n      const moduleSpec = statement.getModuleSpecifierValue();\n\n      // Namespace import: import * as X from '...'\n      if (statement.getNamespaceImport()) {\n        imports.push({\n          name: moduleSpec,\n          specifiers: [\n            {\n              name: statement.getNamespaceImport()!.getText()\n            }\n          ],\n          all: true\n        });\n      }\n\n      // Named imports: import X from '...' or import { A, B as C } from '...'\n      else if (\n        statement.getNamedImports().length > 0 ||\n        statement.getDefaultImport()\n      ) {\n        const specifiers: ModuleExportSpecifier[] = [];\n        if (statement.getDefaultImport()) {\n          specifiers.push({\n            name: statement.getDefaultImport()!.getText(),\n            default: true,\n            type: statement.isTypeOnly()\n          });\n        }\n\n        statement.getNamedImports().forEach(named => {\n          specifiers.push({\n            name: named.getName(),\n            alias: named.getAliasNode()?.getText(),\n            type: statement.isTypeOnly()\n          });\n        });\n\n        imports.push({\n          name: moduleSpec,\n          specifiers\n        });\n      }\n    }\n\n    // --- Export declarations ---\n    else if (Node.isExportDeclaration(statement)) {\n      const moduleSpec = statement.getModuleSpecifierValue();\n      if (moduleSpec) {\n        // Resolve the module specifier\n        let resolvedSpec = moduleSpec;\n        if (!ctx.context.builtins.includes(moduleSpec)) {\n          if (ctx.emitted.has(moduleSpec)) {\n            resolvedSpec = ctx.emitted.get(moduleSpec)!;\n          } else {\n            const resolvedModule = await ctx.context.resolve(\n              moduleSpec,\n              filePath\n            );\n            if (isSetString(resolvedModule?.id)) {\n              resolvedSpec = resolvedModule.id;\n            }\n          }\n        }\n\n        // Re-export from another module\n        const namedExports = statement.getNamedExports();\n        if (namedExports.length > 0) {\n          exports.push({\n            name: resolvedSpec,\n            text: statement.getText(),\n            fullText: statement.getFullText(),\n            specifiers: namedExports.map(named => ({\n              name: named.getName(),\n              alias: named.getAliasNode()?.getText(),\n              type: statement.isTypeOnly()\n            })),\n            comment: statement\n              .getLeadingCommentRanges()\n              .filter(\n                c =>\n                  isSetString(c.getText().trim()) &&\n                  !c.getText().includes(\"@module\")\n              )\n              .map(c => c.getText().trim())\n              .join(\"\\n\")\n              .trim()\n          });\n        } else {\n          // export * from '...'\n          exports.push({\n            name: resolvedSpec,\n            text: statement.getText(),\n            fullText: statement.getFullText(),\n            all: true,\n            comment: statement\n              .getLeadingCommentRanges()\n              .filter(\n                c =>\n                  isSetString(c.getText().trim()) &&\n                  !c.getText().includes(\"@module\")\n              )\n              .map(c => c.getText().trim())\n              .join(\"\\n\")\n              .trim()\n          });\n        }\n      } else {\n        const specifiers = statement.getNamedExports().map(named => ({\n          name: named.getName(),\n          alias: named.getAliasNode()?.getText(),\n          type: statement.isTypeOnly()\n        }));\n        if (specifiers.length > 0) {\n          exports.push({\n            text: statement.getText(),\n            fullText: statement.getFullText(),\n            specifiers,\n            comment: statement\n              .getLeadingCommentRanges()\n              .filter(\n                c =>\n                  isSetString(c.getText().trim()) &&\n                  !c.getText().includes(\"@module\")\n              )\n              .map(c => c.getText().trim())\n              .join(\"\\n\")\n          });\n        }\n      }\n    }\n\n    // --- Export assignments (export default ...) ---\n    else if (Node.isExportAssignment(statement)) {\n      exports.push({\n        text: statement.getText(),\n        fullText: statement.getFullText(),\n        comment: statement\n          .getLeadingCommentRanges()\n          .filter(\n            c =>\n              isSetString(c.getText().trim()) &&\n              !c.getText().includes(\"@module\")\n          )\n          .map(c => c.getText().trim())\n          .join(\"\\n\")\n      });\n    }\n\n    // --- Function declarations (export declare function ...) ---\n    else if (\n      Node.isFunctionDeclaration(statement) &&\n      statement.isExported() &&\n      statement.getNameNode()\n    ) {\n      exports.push({\n        text: statement.getText(),\n        fullText: statement.getFullText(),\n        specifiers: [\n          {\n            name: statement.getNameNode()!.getText()\n          }\n        ],\n        comment: statement\n          .getLeadingCommentRanges()\n          .filter(\n            c =>\n              isSetString(c.getText().trim()) &&\n              !c.getText().includes(\"@module\")\n          )\n          .map(c => c.getText().trim())\n          .join(\"\\n\")\n      });\n    }\n\n    // --- Variable statements (export declare const ...) ---\n    else if (Node.isVariableStatement(statement) && statement.isExported()) {\n      exports.push({\n        text: statement.getText(),\n        fullText: statement.getFullText(),\n        specifiers: statement\n          .getDeclarationList()\n          .getDeclarations()\n          .filter(\n            decl => decl.getNameNode() && Node.isIdentifier(decl.getNameNode())\n          )\n          .map(decl => ({ name: decl.getNameNode().getText() })),\n        comment: statement\n          .getLeadingCommentRanges()\n          .filter(\n            c =>\n              isSetString(c.getText().trim()) &&\n              !c.getText().includes(\"@module\")\n          )\n          .map(c => c.getText().trim())\n          .join(\"\\n\")\n      });\n    }\n\n    // --- Class declarations (export declare class ...) ---\n    else if (Node.isClassDeclaration(statement) && statement.isExported()) {\n      const nameNode = statement.getNameNode();\n      exports.push({\n        text: statement.getText(),\n        fullText: statement.getFullText(),\n        specifiers: nameNode ? [{ name: nameNode.getText() }] : undefined,\n        comment: statement\n          .getLeadingCommentRanges()\n          .filter(\n            c =>\n              isSetString(c.getText().trim()) &&\n              !c.getText().includes(\"@module\")\n          )\n          .map(c => c.getText().trim())\n          .join(\"\\n\")\n      });\n    }\n\n    // --- Interface declarations (export declare interface ...) ---\n    else if (Node.isInterfaceDeclaration(statement) && statement.isExported()) {\n      const nameNode = statement.getNameNode();\n      exports.push({\n        text: statement.getText(),\n        fullText: statement.getFullText(),\n        specifiers: nameNode ? [{ name: nameNode.getText() }] : undefined,\n        comment: statement\n          .getLeadingCommentRanges()\n          .filter(\n            c =>\n              isSetString(c.getText().trim()) &&\n              !c.getText().includes(\"@module\")\n          )\n          .map(c => c.getText().trim())\n          .join(\"\\n\")\n      });\n    }\n\n    // --- Type alias declarations (export declare type ...) ---\n    else if (Node.isTypeAliasDeclaration(statement) && statement.isExported()) {\n      const nameNode = statement.getNameNode();\n      exports.push({\n        text: statement.getText(),\n        fullText: statement.getFullText(),\n        specifiers: nameNode ? [{ name: nameNode.getText() }] : undefined,\n        comment: statement\n          .getLeadingCommentRanges()\n          .filter(\n            c =>\n              isSetString(c.getText().trim()) &&\n              !c.getText().includes(\"@module\")\n          )\n          .map(c => c.getText().trim())\n          .join(\"\\n\")\n      });\n    }\n\n    // --- All other statements (declarations) ---\n    else if (\n      ctx.context.config.output.sourceMap ||\n      !statement.getFullText().includes(\"//# sourceMappingURL=\")\n    ) {\n      exports.push({\n        text: statement.getText(),\n        fullText: statement.getFullText(),\n        comment: statement\n          .getLeadingCommentRanges()\n          .filter(\n            c =>\n              isSetString(c.getText().trim()) &&\n              !c.getText().includes(\"@module\")\n          )\n          .map(c => c.getText().trim())\n          .join(\"\\n\")\n      });\n    }\n  }\n\n  return {\n    name,\n    text,\n    sourceFile,\n    comment,\n    imports,\n    exports\n  };\n}\n\n/**\n * Emits TypeScript declaration types for the provided files using the given TypeScript configuration.\n *\n * @param context - The context containing options and environment paths.\n * @param files - The list of files to generate types for.\n * @returns A promise that resolves to the generated TypeScript declaration types.\n */\nexport async function emitBuiltinTypes<TContext extends Context>(\n  context: TContext,\n  files: string[]\n): Promise<{ code: string; directives: string[] }> {\n  if (files.length === 0) {\n    context.debug(\n      \"No files provided for TypeScript types generation. Typescript compilation for built-in modules will be skipped.\"\n    );\n    return { code: \"\", directives: [] };\n  }\n\n  context.debug(\n    `Running the TypeScript compiler for ${\n      files.length\n    } generated built-in module files.`\n  );\n\n  const program = createProgram(context, {\n    skipAddingFilesFromTsConfig: true,\n    compilerOptions: {\n      declaration: true,\n      declarationMap: false,\n      emitDeclarationOnly: true,\n      sourceMap: false,\n      outDir: replacePath(context.builtinsPath, context.config.cwd),\n      composite: false,\n      incremental: false,\n      tsBuildInfoFile: undefined\n    }\n  });\n\n  program.addSourceFilesAtPaths(files);\n  const emitResult = program.emitToMemory({ emitOnlyDtsFiles: true });\n\n  const diagnostics = emitResult.getDiagnostics();\n  if (diagnostics && diagnostics.length > 0) {\n    if (diagnostics.some(d => d.getCategory() === DiagnosticCategory.Error)) {\n      throw new Error(\n        `The Typescript emit process failed while generating built-in types: \\n ${diagnostics\n          .filter(d => d.getCategory() === DiagnosticCategory.Error)\n          .map(\n            d =>\n              `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : \"\"} ${String(\n                d.getMessageText()\n              )} (at ${d.getStart()}:${d.getLength()})`\n          )\n          .join(\"\\n\")}`\n      );\n    } else if (\n      diagnostics.some(d => d.getCategory() === DiagnosticCategory.Warning)\n    ) {\n      context.warn(\n        `The Typescript emit process completed with warnings while generating built-in types: \\n ${diagnostics\n          .filter(d => d.getCategory() === DiagnosticCategory.Warning)\n          .map(\n            d =>\n              `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : \"\"} ${String(\n                d.getMessageText()\n              )} (at ${d.getStart()}:${d.getLength()})`\n          )\n          .join(\"\\n\")}`\n      );\n    } else {\n      context.debug(\n        `The Typescript emit process completed with diagnostic messages while generating built-in types: \\n ${diagnostics\n          .map(\n            d =>\n              `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : \"\"} ${String(\n                d.getMessageText()\n              )} (at ${d.getStart()}:${d.getLength()})`\n          )\n          .join(\"\\n\")}`\n      );\n    }\n  }\n\n  const emittedFiles = emitResult.getFiles();\n  context.debug(\n    `The TypeScript compiler emitted ${\n      emittedFiles.length\n    } files for built-in types.`\n  );\n\n  if (emittedFiles.length === 0) {\n    context.warn(\n      \"The TypeScript compiler did not emit any files for built-in types. This may indicate an issue with the TypeScript configuration or the provided files.\"\n    );\n    return { code: \"\", directives: [] };\n  }\n\n  const ctx = {\n    context,\n    modules: [] as ModuleDeclaration[],\n    emitted: new Map<string, string>()\n  };\n\n  await Promise.all(\n    emittedFiles.map(async emittedFile => {\n      const filePath = appendPath(emittedFile.filePath, context.config.cwd);\n      if (\n        !filePath.endsWith(\".map\") &&\n        findFileName(filePath) !== \"tsconfig.tsbuildinfo\" &&\n        isParentPath(filePath, context.builtinsPath)\n      ) {\n        const moduleName = replaceExtension(\n          replacePath(\n            replacePath(filePath, context.builtinsPath),\n            replacePath(context.builtinsPath, context.config.cwd)\n          ),\n          \"\",\n          {\n            fullExtension: true\n          }\n        );\n        if (context.builtins.includes(moduleName)) {\n          ctx.emitted.set(filePath, moduleName);\n          ctx.modules.push(\n            await extractModuleDeclarations(\n              ctx,\n              filePath,\n              moduleName,\n              emittedFile.text\n            )\n          );\n        }\n      }\n    })\n  );\n\n  const commonDeclarations = [] as ExportModuleReference[];\n  for (const mod of ctx.modules) {\n    for (const importRef of mod.imports.filter(importRef =>\n      context.builtins.some(builtin => importRef.name.endsWith(`:${builtin}`))\n    )) {\n      const moduleRef = ctx.modules.find(moduleRef =>\n        importRef.name.endsWith(`:${moduleRef.name}`)\n      );\n      if (moduleRef) {\n        let declaration: ExportModuleReference | undefined;\n        for (const decl of moduleRef.exports.filter(decl =>\n          isSetObject(decl)\n        )) {\n          const specifiers = decl.specifiers?.filter(specifier =>\n            importRef.specifiers?.some(\n              s =>\n                (specifier.alias ? specifier.alias : specifier.name) ===\n                (s.alias ? s.alias : s.name)\n            )\n          );\n          if (specifiers && specifiers.length > 0) {\n            importRef.specifiers = importRef.specifiers?.filter(\n              s =>\n                !specifiers.some(\n                  specifier =>\n                    (specifier.alias ? specifier.alias : specifier.name) ===\n                    (s.alias ? s.alias : s.name)\n                )\n            );\n            if (\n              importRef.specifiers &&\n              importRef.specifiers.length === 0 &&\n              !importRef.all &&\n              !importRef.ambient\n            ) {\n              mod.imports = mod.imports.filter(\n                imp => imp.name !== importRef.name\n              );\n            }\n\n            declaration = decl;\n            break;\n          }\n        }\n\n        if (declaration) {\n          for (const decl of moduleRef.exports.filter(\n            decl =>\n              isSetObject(decl) &&\n              !decl.specifiers?.some(s =>\n                declaration?.specifiers?.some(\n                  specifier =>\n                    (specifier.alias ? specifier.alias : specifier.name) ===\n                    (s.alias ? s.alias : s.name)\n                )\n              )\n          )) {\n            const exportModuleRef = decl as ExportModuleReference;\n            if (\n              (exportModuleRef.specifiers?.some(s => s.alias || s.name) ||\n                exportModuleRef.name) &&\n              new RegExp(\n                `(^|\\\\s|\\\\n|\\\\r\\\\n|\\\\(|\\\\)|<|>|{|}|\\\\[|\\\\]|\\\\!|\\\\?|\\\\.|,|\\\\*|&|:)(${\n                  exportModuleRef.specifiers\n                    ?.map(s => `${s.alias ? `${s.alias}|` : \"\"}${s.name}`)\n                    .join(\"|\") || exportModuleRef.name\n                })($|\\\\s|\\\\n|\\\\r\\\\n|\\\\(|\\\\)|<|>|{|}|\\\\[|\\\\]|\\\\!|\\\\?|\\\\.|,|\\\\*|&|:|;)`\n              ).test(declaration.text)\n            ) {\n              commonDeclarations.push(exportModuleRef);\n            }\n          }\n          commonDeclarations.push(declaration);\n        }\n      }\n    }\n  }\n\n  let code = \"\";\n  const directives: string[] = [];\n\n  for (const commonDeclaration of commonDeclarations) {\n    code += formatTypes(\n      `${\n        commonDeclaration.comment?.trim()\n          ? commonDeclaration.comment.trim()\n          : \"\"\n      }${commonDeclaration.comment?.trim() ? \"\\n\" : \"\"}${formatTypes(\n        commonDeclaration.text\n          .replace(/\\s*export\\s*/, \"\")\n          .replace(/\\s*declare\\s*interface\\s*/, \"interface \")\n          .replace(/\\s*declare\\s*type\\s*/, \"type \")\n      )}`\n    );\n    code += \"\\n\\n\";\n  }\n\n  for (const mod of ctx.modules) {\n    code += mod.comment ? `${mod.comment.trim()}\\n` : \"\";\n    code += `declare module \"${context.config.framework?.name ?? \"powerlines\"}:${mod.name}\" { \\n`;\n    for (const importRef of mod.imports) {\n      if (importRef.ambient) {\n        code += directives.push(importRef.name);\n      } else if (importRef.all) {\n        code += `\\timport * as ${findFileName(importRef.name)} from \"${importRef.name}\";\\n`;\n      } else if (importRef.specifiers) {\n        const typeOnly = importRef.specifiers.every(s => s.type) ? \" type\" : \"\";\n        const specifiers = importRef.specifiers\n          .map(s => (s.alias ? `${s.name} as ${s.alias}` : s.name))\n          .join(\", \");\n        code += `\\timport${typeOnly} { ${specifiers} } from \"${importRef.name}\";\\n`;\n      }\n    }\n\n    if (mod.imports.length > 0) {\n      code += \"\\n\";\n    }\n\n    for (const exportRef of mod.exports.filter(\n      e =>\n        isString(e) ||\n        !e.specifiers ||\n        !commonDeclarations.some(\n          commonDecl =>\n            commonDecl.specifiers &&\n            commonDecl.specifiers.some(specifier =>\n              e.specifiers?.some(\n                s =>\n                  (s.alias ? s.alias : s.name) ===\n                  (specifier.alias ? specifier.alias : specifier.name)\n              )\n            )\n        )\n    )) {\n      if (isSetString(exportRef)) {\n        code += `${exportRef}\\n`;\n      } else if (exportRef.name) {\n        if (exportRef.all) {\n          code += `${\n            exportRef.comment?.trim() ? exportRef.comment.trim() : \"\"\n          }${\n            exportRef.comment?.trim() ? \"\\n\" : \"\"\n          }export * from \"${exportRef.name}\";\\n`;\n        } else if (exportRef.specifiers) {\n          if (exportRef.comment?.trim()) {\n            code += `${exportRef.comment.trim()}\\n`;\n          }\n\n          code += `\\texport${\n            exportRef.specifiers.every(s => s.type) ? \" type\" : \"\"\n          } { ${exportRef.specifiers\n            .map(s => (s.alias ? `${s.name} as ${s.alias}` : s.name))\n            .join(\", \")} } from \"${exportRef.name}\";\\n`;\n        }\n      } else {\n        code += `${exportRef.comment?.trim() ? exportRef.comment.trim() : \"\"}${\n          exportRef.comment?.trim() ? \"\\n\" : \"\"\n        }${formatTypes(\n          exportRef.text\n            .replace(/\\s*export\\s*declare\\s*/, \"export \")\n            .replace(/\\s*declare\\s*/, \" \")\n        )}\\n`;\n      }\n    }\n\n    mod.exports\n      .filter(\n        e =>\n          !isString(e) &&\n          e.specifiers &&\n          commonDeclarations.some(\n            commonDeclaration =>\n              commonDeclaration.specifiers &&\n              commonDeclaration.specifiers.some(specifier =>\n                e.specifiers?.some(\n                  s =>\n                    (s.alias ? s.alias : s.name) ===\n                    (specifier.alias ? specifier.alias : specifier.name)\n                )\n              )\n          )\n      )\n      .forEach((e, i, arr) => {\n        if (i === 0) {\n          code += \"\\nexport { \";\n        } else {\n          code += \", \";\n        }\n\n        code += `${\n          (e as ExportModuleReference)?.specifiers\n            ?.filter(s =>\n              commonDeclarations.some(\n                commonDeclaration =>\n                  commonDeclaration.specifiers &&\n                  commonDeclaration.specifiers.some(\n                    specifier =>\n                      (s.alias ? s.alias : s.name) ===\n                      (specifier.alias ? specifier.alias : specifier.name)\n                  )\n              )\n            )\n            .map(s => (s.alias ? `${s.name} as ${s.alias}` : s.name))\n            .join(\", \") || \"\"\n        }`;\n\n        if (i === arr.length - 1) {\n          code += ` };\\n`;\n        }\n      });\n\n    code += \"}\";\n    code += \"\\n\\n\";\n  }\n\n  code = await format(context, context.typesPath, code);\n\n  context.debug(\n    `A TypeScript declaration file (size: ${prettyBytes(\n      new Blob(toArray(code)).size\n    )}) emitted for the built-in modules types.`\n  );\n\n  return { code, directives };\n}\n\n/**\n * Generate the Powerlines TypeScript declaration file\n *\n * @param context - The execution context for generating the TypeScript declaration file, which provides access to the project configuration, environment, and utility functions for performing the generation. The context is used to manage the state and behavior of the generation process, allowing for hooks to be called at different stages and for environment-specific configurations to be applied.\n * @param env - The environment context to use for generating the TypeScript declaration file\n */\nexport async function handleTypes<\n  TResolvedConfig extends ResolvedConfig,\n  TSystemContext = unknown\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  env: EnvironmentContext<TResolvedConfig, TSystemContext>\n) {\n  env.debug(`Preparing the TypeScript definitions for the Powerlines project.`);\n\n  if (env.fs.existsSync(env.typesPath)) {\n    await env.fs.remove(env.typesPath);\n  }\n\n  const typescriptPath = await resolvePackage(\"typescript\");\n  if (!typescriptPath) {\n    throw new Error(\n      \"Could not resolve TypeScript package location. Please ensure TypeScript is installed.\"\n    );\n  }\n\n  env.debug(\"Running TypeScript compiler for built-in runtime module files.\");\n\n  let { code, directives } = await emitBuiltinTypes(\n    env,\n    (await env.getBuiltins()).reduce<string[]>((ret, builtin) => {\n      const formatted = replacePath(builtin.path, env.config.cwd);\n      if (!ret.includes(formatted)) {\n        ret.push(formatted);\n      }\n\n      return ret;\n    }, [])\n  );\n\n  env.debug(`Generating TypeScript declaration file ${env.typesPath}.`);\n\n  const merge = async (\n    currentResult: string | TypesResult,\n    previousResult: string | TypesResult\n  ): Promise<string | TypesResult> => {\n    if (\n      !isSetString(currentResult) &&\n      !isSetObject(currentResult) &&\n      !isSetString(previousResult) &&\n      !isSetObject(previousResult)\n    ) {\n      return { code, directives };\n    }\n\n    const previous = (\n      await format(\n        env,\n        env.typesPath,\n        isSetString(previousResult)\n          ? previousResult\n          : isSetObject(previousResult)\n            ? previousResult.code\n            : \"\"\n      )\n    )\n      .trim()\n      .replace(code, \"\")\n      .trim();\n    const current = (\n      await format(\n        env,\n        env.typesPath,\n        isSetString(currentResult)\n          ? currentResult\n          : isSetObject(currentResult)\n            ? currentResult.code\n            : \"\"\n      )\n    )\n      .trim()\n      .replace(previous, \"\")\n      .trim()\n      .replace(code, \"\")\n      .trim();\n\n    return {\n      directives: [\n        ...(isSetObject(currentResult) && currentResult.directives\n          ? currentResult.directives\n          : []),\n        ...(isSetObject(previousResult) && previousResult.directives\n          ? previousResult.directives\n          : [])\n      ],\n      code: await format(\n        env,\n        env.typesPath,\n        `${\n          !previous.includes(getTypescriptFileHeader(env)) &&\n          !current.includes(getTypescriptFileHeader(env))\n            ? `${code}\\n`\n            : \"\"\n        }${previous}\\n${current}`.trim()\n      )\n    };\n  };\n  const asNextParam = (\n    previousResult: string | TypesResult | null | undefined\n  ) => (isObject(previousResult) ? previousResult.code : previousResult);\n\n  let result = await callHook(\n    context,\n    \"types\",\n    {\n      environment: env,\n      sequential: true,\n      order: \"pre\",\n      result: \"merge\",\n      merge,\n      asNextParam\n    },\n    code\n  );\n  if (result) {\n    if (isSetObject(result)) {\n      code = result.code;\n      if (Array.isArray(result.directives) && result.directives.length > 0) {\n        directives = getUnique([...directives, ...result.directives]).filter(\n          Boolean\n        );\n      }\n    } else if (isSetString(result)) {\n      code = result;\n    }\n  }\n\n  result = await callHook(\n    context,\n    \"types\",\n    {\n      environment: env,\n      sequential: true,\n      order: \"normal\",\n      result: \"merge\",\n      merge,\n      asNextParam\n    },\n    code\n  );\n  if (result) {\n    if (isSetObject(result)) {\n      code = result.code;\n      if (Array.isArray(result.directives) && result.directives.length > 0) {\n        directives = getUnique([...directives, ...result.directives]).filter(\n          Boolean\n        );\n      }\n    } else if (isSetString(result)) {\n      code = result;\n    }\n  }\n\n  result = await callHook(\n    context,\n    \"types\",\n    {\n      environment: env,\n      sequential: true,\n      order: \"post\",\n      result: \"merge\",\n      merge,\n      asNextParam\n    },\n    code\n  );\n  if (result) {\n    if (isSetObject(result)) {\n      code = result.code;\n      if (Array.isArray(result.directives) && result.directives.length > 0) {\n        directives = getUnique([...directives, ...result.directives]).filter(\n          Boolean\n        );\n      }\n    } else if (isSetString(result)) {\n      code = result;\n    }\n  }\n\n  if (isSetString(code?.trim()) || directives.length > 0) {\n    await env.fs.write(\n      env.typesPath,\n      `${\n        directives.length > 0\n          ? `${directives.map(directive => `/// <reference types=\"${directive}\" />`).join(\"\\n\")}\n\n`\n          : \"\"\n      }${getTypescriptFileHeader(env, { directive: null, prettierIgnore: false })}\n\n${formatTypes(code)}\n`\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/lib/hooks.cjs

@@ -0,0 +1,152 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_plugin_utils_logging = require('../plugin-utils/logging.cjs');
+const require_plugin_utils_helpers = require('../plugin-utils/helpers.cjs');
+const require_plugin_utils_merge = require('../plugin-utils/merge.cjs');
+require('../plugin-utils/index.cjs');
+let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let defu = require("defu");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let _stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk, 1);
+let _stryke_helpers_get_field = require("@stryke/helpers/get-field");
+let _stryke_type_checks_is_object = require("@stryke/type-checks/is-object");
+let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
+
+//#region src/lib/hooks.ts
+/**
+* Merges the current hook result with the previous results based on their types.
+*
+* @param currentResult - The current hook result to merge with the previous results.
+* @param previousResults - The previous hook results to merge with the current result.
+* @returns The merged result.
+*/
+function mergeResults(currentResult, previousResults) {
+	if (!previousResults || previousResults.length === 0) return [currentResult];
+	if ((0, _stryke_type_checks_is_set_string.isSetString)(currentResult)) previousResults = [`${(0, _stryke_type_checks_is_set_string.isSetString)(previousResults[0]) ? previousResults[0] || "" : ""}\n${(0, _stryke_type_checks_is_set_string.isSetString)(previousResults[0]) ? currentResult.replace(previousResults[0], "") : currentResult}`.trim()];
+	else if ((0, _stryke_type_checks_is_object.isObject)(currentResult)) previousResults = previousResults.length > 0 ? [(0, defu.defu)(currentResult, previousResults[0])] : [currentResult];
+	return previousResults;
+}
+/**
+* Merges multiple hook results together, with special handling for string values and object values.
+*
+* @param currentResult - The current hook result to merge with the previous results.
+* @param previousResults - The previous hook results to merge with the current result.
+* @returns The merged result.
+*/
+function mergeConfigs(currentResult, previousResults) {
+	if ((0, _stryke_type_checks_is_string.isString)(currentResult)) previousResults = `${(0, _stryke_type_checks_is_string.isString)(previousResults) ? previousResults || "" : ""}\n${currentResult || ""}`.trim();
+	else if ((0, _stryke_type_checks_is_object.isObject)(currentResult)) previousResults = require_plugin_utils_merge.mergeConfig(currentResult, previousResults ?? {});
+	return previousResults;
+}
+/**
+* Calls a hook with the given context, options, and arguments.
+*
+* @param context - The context to use when calling the hook.
+* @param key - The hook to call.
+* @param options - Options for calling the hook.
+* @param args - Arguments to pass to the hook.
+* @returns The return value of the hook.
+*/
+async function _callHook(context, key, options, ...args) {
+	const hooks = context.selectHooks(key, options);
+	if (hooks.length > 0) {
+		context.extendLogger({ category: "hooks" }).debug(`🧩 Calling ${hooks.length} ${chalk.default.bold.cyanBright(`${key}${options?.order ? ` (${options.order})` : ""}`)} plugin hook${hooks.length > 1 ? "s" : ""}:\n${hooks.map((hook, index) => ` ${index + 1}. ${require_plugin_utils_logging.colorText(hook.plugin.name)}`).join("\n")}`);
+		const invokeHook = async (hook, hookArgs) => {
+			return Reflect.apply(hook.handler, hook.context, hookArgs);
+		};
+		let results = [];
+		if (options?.sequential === false) results = await Promise.all(hooks.map(async (hook) => {
+			if (!(0, _stryke_type_checks_is_function.isFunction)(hook.handler)) throw new Error(`Plugin hook handler for hook "${key}" is not a function.`);
+			return invokeHook(hook, [...args]);
+		}));
+		else for (const hook of hooks) {
+			if (!(0, _stryke_type_checks_is_function.isFunction)(hook.handler)) throw new Error(`Plugin hook handler for hook "${key}" is not a function.`);
+			if (options?.result === "first" || options?.asNextParam === false) {
+				results.push(await Promise.resolve(invokeHook(hook, [...args])));
+				if (options?.result === "first" && (0, _stryke_type_checks_is_set.isSet)(results[results.length - 1])) break;
+			} else {
+				const sequenceArgs = [...args];
+				if (results.length > 0 && sequenceArgs.length > 0) sequenceArgs[0] = (0, _stryke_type_checks_is_function.isFunction)(options.asNextParam) ? await Promise.resolve(options.asNextParam(results[0])) : results[0];
+				const result = await Promise.resolve(invokeHook(hook, [...sequenceArgs]));
+				if (result) if (options.result === "last") results = [result];
+				else if (options.result === "merge" && options.merge) results = [results.length > 0 && results[0] ? await Promise.resolve(options.merge(result, results[0])) : result];
+				else results = mergeResults(result, results);
+			}
+		}
+		const definedResults = results.filter((result) => (0, _stryke_type_checks_is_set.isSet)(result));
+		if (definedResults.length > 0) {
+			let mergedResult = void 0;
+			for (const result of definedResults) mergedResult = (0, defu.defu)(result, mergedResult ?? {});
+			return mergedResult;
+		}
+	}
+}
+function extractHooks(context, hooks, plugin, key, parentKey) {
+	const combinedKey = parentKey ? `${parentKey}:${key}` : key;
+	const pluginField = (0, _stryke_helpers_get_field.getField)(plugin, combinedKey.replace(/:/g, "."));
+	if (require_plugin_utils_helpers.isPluginHookField(combinedKey) && require_plugin_utils_helpers.isPluginHook(pluginField)) {
+		const pluginHook = pluginField;
+		if (!require_plugin_utils_helpers.isPluginHook(pluginHook)) return hooks;
+		hooks[combinedKey] ??= {
+			preEnforced: [],
+			preOrdered: [],
+			normal: [],
+			postEnforced: [],
+			postOrdered: []
+		};
+		if (plugin.enforce) {
+			const hookListOrder = `${plugin.enforce}Enforced`;
+			hooks[combinedKey][hookListOrder] ??= [];
+			hooks[combinedKey][hookListOrder] = require_plugin_utils_helpers.addPluginHook(context, plugin, pluginHook, hooks[combinedKey][hookListOrder]);
+			return hooks;
+		}
+		if ((0, _stryke_type_checks_is_function.isFunction)(pluginHook) || !pluginHook.order) {
+			hooks[combinedKey].normal ??= [];
+			hooks[combinedKey].normal = require_plugin_utils_helpers.addPluginHook(context, plugin, pluginHook, hooks[combinedKey].normal);
+			return hooks;
+		}
+		const hookListOrder = `${pluginHook.order}Ordered`;
+		hooks[combinedKey][hookListOrder] ??= [];
+		hooks[combinedKey][hookListOrder] = require_plugin_utils_helpers.addPluginHook(context, plugin, pluginHook, hooks[combinedKey][hookListOrder]);
+		return hooks;
+	} else if ((0, _stryke_type_checks_is_set_object.isSetObject)(pluginField)) return Object.keys(pluginField).map((pluginKey) => extractHooks(context, hooks, plugin, pluginKey, combinedKey)).reduce((ret, current) => {
+		Object.keys(current).forEach((key) => {
+			ret[key] ??= {
+				preEnforced: [],
+				preOrdered: [],
+				normal: [],
+				postEnforced: [],
+				postOrdered: []
+			};
+			[
+				"preEnforced",
+				"preOrdered",
+				"normal",
+				"postEnforced",
+				"postOrdered"
+			].forEach((order) => {
+				if (current[key]?.[order]) {
+					ret[key][order] ??= [];
+					ret[key][order] = ret[key][order].concat(current[key][order]);
+				}
+			});
+		});
+		return ret;
+	}, hooks);
+	return hooks;
+}
+async function callHook(context, key, options, ...args) {
+	return _callHook((0, _stryke_type_checks_is_set_object.isSetObject)(options?.environment) ? options.environment : await context.getEnvironment(options?.environment), key, {
+		sequential: true,
+		...options
+	}, ...args);
+}
+
+//#endregion
+exports.callHook = callHook;
+exports.extractHooks = extractHooks;
+exports.mergeConfigs = mergeConfigs;
+exports.mergeResults = mergeResults;