@powerlines/core 0.15.0 → 0.15.2

package/dist/lib/events.cjs

@@ -0,0 +1,43 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/lib/events.ts
+/**
+* Create event emitter.
+*/
+function createEventEmitter() {
+	const _listeners = {};
+	function emit(event, ...args) {
+		const callbacks = _listeners[event] || [];
+		for (let i = 0, length = callbacks.length; i < length; i++) {
+			const callback = callbacks[i];
+			if (callback) callback(...args);
+		}
+	}
+	function emitOnce(event, ...args) {
+		emit(event, ...args);
+		delete _listeners[event];
+	}
+	function on(event, cb) {
+		(_listeners[event] ||= []).push(cb);
+		return () => {
+			_listeners[event] = _listeners[event]?.filter((i) => cb !== i);
+		};
+	}
+	function once(event, cb) {
+		const unsubscribe = on(event, ((...args) => {
+			unsubscribe();
+			return cb(...args);
+		}));
+		return unsubscribe;
+	}
+	return {
+		_listeners,
+		emit,
+		emitOnce,
+		on,
+		once
+	};
+}
+
+//#endregion
+exports.createEventEmitter = createEventEmitter;

package/dist/lib/events.d.cts

@@ -0,0 +1,10 @@
+import { EventEmitter, EventsMap } from "devframe/types";
+
+//#region src/lib/events.d.ts
+/**
+ * Create event emitter.
+ */
+declare function createEventEmitter<Events extends EventsMap>(): EventEmitter<Events>;
+//#endregion
+export { createEventEmitter };
+//# sourceMappingURL=events.d.cts.map

package/dist/lib/events.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.cts","names":[],"sources":["../../src/lib/events.ts"],"mappings":";;;;;AAuBA;iBAAgB,kBAAA,gBACC,SAAA,CAAA,CAAA,GACZ,YAAA,CAAa,MAAA"}

package/dist/lib/events.d.mts

@@ -0,0 +1,10 @@
+import { EventEmitter, EventsMap } from "devframe/types";
+
+//#region src/lib/events.d.ts
+/**
+ * Create event emitter.
+ */
+declare function createEventEmitter<Events extends EventsMap>(): EventEmitter<Events>;
+//#endregion
+export { createEventEmitter };
+//# sourceMappingURL=events.d.mts.map

package/dist/lib/events.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.mts","names":[],"sources":["../../src/lib/events.ts"],"mappings":";;;;;AAuBA;iBAAgB,kBAAA,gBACC,SAAA,CAAA,CAAA,GACZ,YAAA,CAAa,MAAA"}

package/dist/lib/events.mjs

@@ -0,0 +1,42 @@
+//#region src/lib/events.ts
+/**
+* Create event emitter.
+*/
+function createEventEmitter() {
+	const _listeners = {};
+	function emit(event, ...args) {
+		const callbacks = _listeners[event] || [];
+		for (let i = 0, length = callbacks.length; i < length; i++) {
+			const callback = callbacks[i];
+			if (callback) callback(...args);
+		}
+	}
+	function emitOnce(event, ...args) {
+		emit(event, ...args);
+		delete _listeners[event];
+	}
+	function on(event, cb) {
+		(_listeners[event] ||= []).push(cb);
+		return () => {
+			_listeners[event] = _listeners[event]?.filter((i) => cb !== i);
+		};
+	}
+	function once(event, cb) {
+		const unsubscribe = on(event, ((...args) => {
+			unsubscribe();
+			return cb(...args);
+		}));
+		return unsubscribe;
+	}
+	return {
+		_listeners,
+		emit,
+		emitOnce,
+		on,
+		once
+	};
+}
+
+//#endregion
+export { createEventEmitter };
+//# sourceMappingURL=events.mjs.map

package/dist/lib/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","names":[],"sources":["../../src/lib/events.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 type { EventEmitter, EventsMap, EventUnsubscribe } from \"devframe/types\";\n\n/**\n * Create event emitter.\n */\nexport function createEventEmitter<\n  Events extends EventsMap\n>(): EventEmitter<Events> {\n  const _listeners: Partial<{ [E in keyof Events]: Events[E][] }> = {};\n\n  function emit<K extends keyof Events>(\n    event: K,\n    ...args: Parameters<Events[K]>\n  ) {\n    const callbacks = _listeners[event] || [];\n    for (let i = 0, length = callbacks.length; i < length; i++) {\n      const callback = callbacks[i];\n      if (callback) {\n        // eslint-disable-next-line ts/no-unsafe-call\n        callback(...args);\n      }\n    }\n  }\n  function emitOnce<K extends keyof Events>(\n    event: K,\n    ...args: Parameters<Events[K]>\n  ) {\n    emit(event, ...args);\n    delete _listeners[event];\n  }\n  function on<K extends keyof Events>(\n    event: K,\n    cb: Events[K]\n  ): EventUnsubscribe {\n    (_listeners[event] ||= [] as Events[K][]).push(cb);\n    return () => {\n      _listeners[event] = _listeners[event]?.filter(i => cb !== i);\n    };\n  }\n  function once<K extends keyof Events>(event: K, cb: Events[K]) {\n    const unsubscribe = on(event, ((...args: Parameters<Events[K]>) => {\n      unsubscribe();\n\n      // eslint-disable-next-line ts/no-unsafe-call\n      return cb(...args);\n    }) as Events[K]);\n\n    return unsubscribe;\n  }\n\n  return {\n    _listeners,\n    emit,\n    emitOnce,\n    on,\n    once\n  };\n}\n"],"mappings":";;;;AAuBA,SAAgB,qBAEU;CACxB,MAAM,aAA4D,EAAE;CAEpE,SAAS,KACP,OACA,GAAG,MACH;EACA,MAAM,YAAY,WAAW,UAAU,EAAE;AACzC,OAAK,IAAI,IAAI,GAAG,SAAS,UAAU,QAAQ,IAAI,QAAQ,KAAK;GAC1D,MAAM,WAAW,UAAU;AAC3B,OAAI,SAEF,UAAS,GAAG,KAAK;;;CAIvB,SAAS,SACP,OACA,GAAG,MACH;AACA,OAAK,OAAO,GAAG,KAAK;AACpB,SAAO,WAAW;;CAEpB,SAAS,GACP,OACA,IACkB;AAClB,GAAC,WAAW,WAAW,EAAE,EAAiB,KAAK,GAAG;AAClD,eAAa;AACX,cAAW,SAAS,WAAW,QAAQ,QAAO,MAAK,OAAO,EAAE;;;CAGhE,SAAS,KAA6B,OAAU,IAAe;EAC7D,MAAM,cAAc,GAAG,SAAS,GAAG,SAAgC;AACjE,gBAAa;AAGb,UAAO,GAAG,GAAG,KAAK;KACJ;AAEhB,SAAO;;AAGT,QAAO;EACL;EACA;EACA;EACA;EACA;EACD"}

package/dist/lib/generate-types.cjs

@@ -0,0 +1,371 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_lib_utilities_format = require('./utilities/format.cjs');
+const require_lib_hooks = require('./hooks.cjs');
+const require_lib_typescript_ts_morph = require('./typescript/ts-morph.cjs');
+const require_lib_utilities_file_header = require('./utilities/file-header.cjs');
+let _stryke_path_append = require("@stryke/path/append");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let _stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
+let _stryke_type_checks_is_object = require("@stryke/type-checks/is-object");
+let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+let _stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
+let _stryke_fs_resolve = require("@stryke/fs/resolve");
+let _stryke_string_format_pretty_bytes = require("@stryke/string-format/pretty-bytes");
+let ts_morph = require("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) => (0, _stryke_type_checks_is_set_string.isSetString)(comment?.trim()));
+	const sourceFile = new ts_morph.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 (ts_morph.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 (ts_morph.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 ((0, _stryke_type_checks_is_set_string.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) => (0, _stryke_type_checks_is_set_string.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) => (0, _stryke_type_checks_is_set_string.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) => (0, _stryke_type_checks_is_set_string.isSetString)(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+			});
+		}
+	} else if (ts_morph.Node.isExportAssignment(statement)) exports.push({
+		text: statement.getText(),
+		fullText: statement.getFullText(),
+		comment: statement.getLeadingCommentRanges().filter((c) => (0, _stryke_type_checks_is_set_string.isSetString)(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+	});
+	else if (ts_morph.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) => (0, _stryke_type_checks_is_set_string.isSetString)(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+	});
+	else if (ts_morph.Node.isVariableStatement(statement) && statement.isExported()) exports.push({
+		text: statement.getText(),
+		fullText: statement.getFullText(),
+		specifiers: statement.getDeclarationList().getDeclarations().filter((decl) => decl.getNameNode() && ts_morph.Node.isIdentifier(decl.getNameNode())).map((decl) => ({ name: decl.getNameNode().getText() })),
+		comment: statement.getLeadingCommentRanges().filter((c) => (0, _stryke_type_checks_is_set_string.isSetString)(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+	});
+	else if (ts_morph.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) => (0, _stryke_type_checks_is_set_string.isSetString)(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+		});
+	} else if (ts_morph.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) => (0, _stryke_type_checks_is_set_string.isSetString)(c.getText().trim()) && !c.getText().includes("@module")).map((c) => c.getText().trim()).join("\n")
+		});
+	} else if (ts_morph.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) => (0, _stryke_type_checks_is_set_string.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) => (0, _stryke_type_checks_is_set_string.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 = require_lib_typescript_ts_morph.createProgram(context, {
+		skipAddingFilesFromTsConfig: true,
+		compilerOptions: {
+			declaration: true,
+			declarationMap: false,
+			emitDeclarationOnly: true,
+			sourceMap: false,
+			outDir: (0, _stryke_path_replace.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() === ts_morph.DiagnosticCategory.Error)) throw new Error(`The Typescript emit process failed while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === ts_morph.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() === ts_morph.DiagnosticCategory.Warning)) context.warn(`The Typescript emit process completed with warnings while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === ts_morph.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 = (0, _stryke_path_append.appendPath)(emittedFile.filePath, context.config.cwd);
+		if (!filePath.endsWith(".map") && (0, _stryke_path_file_path_fns.findFileName)(filePath) !== "tsconfig.tsbuildinfo" && (0, _stryke_path_is_parent_path.isParentPath)(filePath, context.builtinsPath)) {
+			const moduleName = (0, _stryke_path_replace.replaceExtension)((0, _stryke_path_replace.replacePath)((0, _stryke_path_replace.replacePath)(filePath, context.builtinsPath), (0, _stryke_path_replace.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) => (0, _stryke_type_checks_is_set_object.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) => (0, _stryke_type_checks_is_set_object.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 ${(0, _stryke_path_file_path_fns.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) => (0, _stryke_type_checks_is_string.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 ((0, _stryke_type_checks_is_set_string.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) => !(0, _stryke_type_checks_is_string.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 require_lib_utilities_format.format(context, context.typesPath, code);
+	context.debug(`A TypeScript declaration file (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new Blob((0, _stryke_convert_to_array.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 (0, _stryke_fs_resolve.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 = (0, _stryke_path_replace.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 (!(0, _stryke_type_checks_is_set_string.isSetString)(currentResult) && !(0, _stryke_type_checks_is_set_object.isSetObject)(currentResult) && !(0, _stryke_type_checks_is_set_string.isSetString)(previousResult) && !(0, _stryke_type_checks_is_set_object.isSetObject)(previousResult)) return {
+			code,
+			directives
+		};
+		const previous = (await require_lib_utilities_format.format(env, env.typesPath, (0, _stryke_type_checks_is_set_string.isSetString)(previousResult) ? previousResult : (0, _stryke_type_checks_is_set_object.isSetObject)(previousResult) ? previousResult.code : "")).trim().replace(code, "").trim();
+		const current = (await require_lib_utilities_format.format(env, env.typesPath, (0, _stryke_type_checks_is_set_string.isSetString)(currentResult) ? currentResult : (0, _stryke_type_checks_is_set_object.isSetObject)(currentResult) ? currentResult.code : "")).trim().replace(previous, "").trim().replace(code, "").trim();
+		return {
+			directives: [...(0, _stryke_type_checks_is_set_object.isSetObject)(currentResult) && currentResult.directives ? currentResult.directives : [], ...(0, _stryke_type_checks_is_set_object.isSetObject)(previousResult) && previousResult.directives ? previousResult.directives : []],
+			code: await require_lib_utilities_format.format(env, env.typesPath, `${!previous.includes(require_lib_utilities_file_header.getTypescriptFileHeader(env)) && !current.includes(require_lib_utilities_file_header.getTypescriptFileHeader(env)) ? `${code}\n` : ""}${previous}\n${current}`.trim())
+		};
+	};
+	const asNextParam = (previousResult) => (0, _stryke_type_checks_is_object.isObject)(previousResult) ? previousResult.code : previousResult;
+	let result = await require_lib_hooks.callHook(context, "types", {
+		environment: env,
+		sequential: true,
+		order: "pre",
+		result: "merge",
+		merge,
+		asNextParam
+	}, code);
+	if (result) {
+		if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
+			code = result.code;
+			if (Array.isArray(result.directives) && result.directives.length > 0) directives = (0, _stryke_helpers_get_unique.getUnique)([...directives, ...result.directives]).filter(Boolean);
+		} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) code = result;
+	}
+	result = await require_lib_hooks.callHook(context, "types", {
+		environment: env,
+		sequential: true,
+		order: "normal",
+		result: "merge",
+		merge,
+		asNextParam
+	}, code);
+	if (result) {
+		if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
+			code = result.code;
+			if (Array.isArray(result.directives) && result.directives.length > 0) directives = (0, _stryke_helpers_get_unique.getUnique)([...directives, ...result.directives]).filter(Boolean);
+		} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) code = result;
+	}
+	result = await require_lib_hooks.callHook(context, "types", {
+		environment: env,
+		sequential: true,
+		order: "post",
+		result: "merge",
+		merge,
+		asNextParam
+	}, code);
+	if (result) {
+		if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
+			code = result.code;
+			if (Array.isArray(result.directives) && result.directives.length > 0) directives = (0, _stryke_helpers_get_unique.getUnique)([...directives, ...result.directives]).filter(Boolean);
+		} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) code = result;
+	}
+	if ((0, _stryke_type_checks_is_set_string.isSetString)(code?.trim()) || directives.length > 0) await env.fs.write(env.typesPath, `${directives.length > 0 ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
+
+` : ""}${require_lib_utilities_file_header.getTypescriptFileHeader(env, {
+		directive: null,
+		prettierIgnore: false
+	})}
+
+${formatTypes(code)}
+`);
+}
+
+//#endregion
+exports.emitBuiltinTypes = emitBuiltinTypes;
+exports.formatTypes = formatTypes;
+exports.handleTypes = handleTypes;

package/dist/lib/generate-types.d.cts

@@ -0,0 +1,67 @@
+import { Context, EnvironmentContext, ExecutionContext } from "../types/context.cjs";
+import { ResolvedConfig } from "../types/config.cjs";
+import { SourceFile } from "ts-morph";
+
+//#region src/lib/generate-types.d.ts
+interface ModuleExportSpecifier {
+  name: string;
+  alias?: string;
+  default?: boolean;
+  type?: boolean;
+}
+interface ModuleReference {
+  name?: string;
+  specifiers?: ModuleExportSpecifier[];
+  all?: boolean;
+}
+interface ImportModuleReference extends ModuleReference {
+  name: string;
+  ambient?: boolean;
+}
+interface ExportModuleReference extends ModuleReference {
+  text: string;
+  fullText: string;
+  comment?: string;
+}
+interface ModuleDeclaration {
+  name: string;
+  text: string;
+  sourceFile: SourceFile;
+  comment?: string;
+  exports: (ExportModuleReference | string)[];
+  imports: ImportModuleReference[];
+}
+interface TypegenContext {
+  context: Context;
+  emitted: Map<string, string>;
+  modules: ModuleDeclaration[];
+}
+/**
+ * Formats the generated TypeScript types source code.
+ *
+ * @param code - The generated TypeScript code.
+ * @returns The formatted TypeScript code.
+ */
+declare function formatTypes(code?: string): string;
+/**
+ * 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.
+ */
+declare function emitBuiltinTypes<TContext extends Context>(context: TContext, files: string[]): Promise<{
+  code: string;
+  directives: string[];
+}>;
+/**
+ * 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
+ */
+declare function handleTypes<TResolvedConfig extends ResolvedConfig, TSystemContext = unknown>(context: ExecutionContext<TResolvedConfig, TSystemContext>, env: EnvironmentContext<TResolvedConfig, TSystemContext>): Promise<void>;
+declare type __ΩTypegenContext = any[];
+//#endregion
+export { TypegenContext, __ΩTypegenContext, emitBuiltinTypes, formatTypes, handleTypes };
+//# sourceMappingURL=generate-types.d.cts.map

package/dist/lib/generate-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-types.d.cts","names":[],"sources":["../../src/lib/generate-types.ts"],"mappings":";;;;;UA2CU,qBAAA;EACR,IAAA;EACA,KAAA;EACA,OAAA;EACA,IAAA;AAAA;AAAA,UAGQ,eAAA;EACR,IAAA;EACA,UAAA,GAAa,qBAAA;EACb,GAAA;AAAA;AAAA,UAGQ,qBAAA,SAA8B,eAAA;EACtC,IAAA;EACA,OAAA;AAAA;AAAA,UAGQ,qBAAA,SAA8B,eAAA;EACtC,IAAA;EACA,QAAA;EACA,OAAA;AAAA;AAAA,UAGQ,iBAAA;EACR,IAAA;EACA,IAAA;EACA,UAAA,EAAY,UAAA;EACZ,OAAA;EACA,OAAA,GAAU,qBAAA;EACV,OAAA,EAAS,qBAAA;AAAA;AAAA,UAGM,cAAA;EACf,OAAA,EAAS,OAAA;EACT,OAAA,EAAS,GAAA;EACT,OAAA,EAAS,iBAAA;AAAA;;;;;;;iBASK,WAAA,CAAY,IAAA;;AAxBnB;;;;;;iBAwWa,gBAAA,kBAAkC,OAAA,CAAA,CACtD,OAAA,EAAS,QAAA,EACT,KAAA,aACC,OAAA;EAAU,IAAA;EAAc,UAAA;AAAA;;;;;;;iBAsWL,WAAA,yBACI,cAAA,2BAAA,CAGxB,OAAA,EAAS,gBAAA,CAAiB,eAAA,EAAiB,cAAA,GAC3C,GAAA,EAAK,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IAAe,OAAA;AAAA"}

package/dist/lib/generate-types.d.mts

@@ -0,0 +1,67 @@
+import { Context, EnvironmentContext, ExecutionContext } from "../types/context.mjs";
+import { ResolvedConfig } from "../types/config.mjs";
+import { SourceFile } from "ts-morph";
+
+//#region src/lib/generate-types.d.ts
+interface ModuleExportSpecifier {
+  name: string;
+  alias?: string;
+  default?: boolean;
+  type?: boolean;
+}
+interface ModuleReference {
+  name?: string;
+  specifiers?: ModuleExportSpecifier[];
+  all?: boolean;
+}
+interface ImportModuleReference extends ModuleReference {
+  name: string;
+  ambient?: boolean;
+}
+interface ExportModuleReference extends ModuleReference {
+  text: string;
+  fullText: string;
+  comment?: string;
+}
+interface ModuleDeclaration {
+  name: string;
+  text: string;
+  sourceFile: SourceFile;
+  comment?: string;
+  exports: (ExportModuleReference | string)[];
+  imports: ImportModuleReference[];
+}
+interface TypegenContext {
+  context: Context;
+  emitted: Map<string, string>;
+  modules: ModuleDeclaration[];
+}
+/**
+ * Formats the generated TypeScript types source code.
+ *
+ * @param code - The generated TypeScript code.
+ * @returns The formatted TypeScript code.
+ */
+declare function formatTypes(code?: string): string;
+/**
+ * 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.
+ */
+declare function emitBuiltinTypes<TContext extends Context>(context: TContext, files: string[]): Promise<{
+  code: string;
+  directives: string[];
+}>;
+/**
+ * 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
+ */
+declare function handleTypes<TResolvedConfig extends ResolvedConfig, TSystemContext = unknown>(context: ExecutionContext<TResolvedConfig, TSystemContext>, env: EnvironmentContext<TResolvedConfig, TSystemContext>): Promise<void>;
+declare type __ΩTypegenContext = any[];
+//#endregion
+export { TypegenContext, __ΩTypegenContext, emitBuiltinTypes, formatTypes, handleTypes };
+//# sourceMappingURL=generate-types.d.mts.map

package/dist/lib/generate-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-types.d.mts","names":[],"sources":["../../src/lib/generate-types.ts"],"mappings":";;;;;UA2CU,qBAAA;EACR,IAAA;EACA,KAAA;EACA,OAAA;EACA,IAAA;AAAA;AAAA,UAGQ,eAAA;EACR,IAAA;EACA,UAAA,GAAa,qBAAA;EACb,GAAA;AAAA;AAAA,UAGQ,qBAAA,SAA8B,eAAA;EACtC,IAAA;EACA,OAAA;AAAA;AAAA,UAGQ,qBAAA,SAA8B,eAAA;EACtC,IAAA;EACA,QAAA;EACA,OAAA;AAAA;AAAA,UAGQ,iBAAA;EACR,IAAA;EACA,IAAA;EACA,UAAA,EAAY,UAAA;EACZ,OAAA;EACA,OAAA,GAAU,qBAAA;EACV,OAAA,EAAS,qBAAA;AAAA;AAAA,UAGM,cAAA;EACf,OAAA,EAAS,OAAA;EACT,OAAA,EAAS,GAAA;EACT,OAAA,EAAS,iBAAA;AAAA;;;;;;;iBASK,WAAA,CAAY,IAAA;;AAxBnB;;;;;;iBAwWa,gBAAA,kBAAkC,OAAA,CAAA,CACtD,OAAA,EAAS,QAAA,EACT,KAAA,aACC,OAAA;EAAU,IAAA;EAAc,UAAA;AAAA;;;;;;;iBAsWL,WAAA,yBACI,cAAA,2BAAA,CAGxB,OAAA,EAAS,gBAAA,CAAiB,eAAA,EAAiB,cAAA,GAC3C,GAAA,EAAK,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IAAe,OAAA;AAAA"}