@powerlines/core 0.14.5 → 0.15.1

package/dist/lib/typescript/ts-morph.mjs

@@ -0,0 +1,102 @@
+import defu from "defu";
+import { InMemoryFileSystemHost, Project } from "ts-morph";
+
+//#region src/lib/typescript/ts-morph.ts
+var VirtualFileSystemHost = class extends InMemoryFileSystemHost {
+	#context;
+	constructor(context) {
+		super();
+		this.#context = context;
+	}
+	deleteSync(path) {
+		this.#context.fs.removeSync(path);
+	}
+	readDirSync(dirPath) {
+		if (!this.#context.fs.isDirectorySync(dirPath)) return [];
+		return this.#context.fs.listSync(dirPath).reduce((ret, entry) => {
+			const fullPath = this.#context.fs.resolveSync(entry);
+			if (fullPath) ret.push({
+				name: entry,
+				isDirectory: this.#context.fs.isDirectorySync(fullPath),
+				isFile: this.#context.fs.isFileSync(fullPath),
+				isSymlink: false
+			});
+			return ret;
+		}, []);
+	}
+	async readFile(filePath) {
+		if (!this.#context.fs.isFileSync(filePath)) return "";
+		return await this.#context.fs.read(filePath);
+	}
+	readFileSync(filePath) {
+		if (!this.#context.fs.isFileSync(filePath)) return "";
+		return this.#context.fs.readSync(filePath);
+	}
+	async writeFile(filePath, fileText) {
+		return this.#context.fs.write(filePath, fileText);
+	}
+	writeFileSync(filePath, fileText) {
+		this.#context.fs.writeSync(filePath, fileText);
+	}
+	async mkdir(dirPath) {
+		await this.#context.fs.mkdir(dirPath);
+	}
+	mkdirSync(dirPath) {
+		this.#context.fs.mkdirSync(dirPath);
+	}
+	async move(srcPath, destPath) {
+		await this.#context.fs.move(srcPath, destPath);
+	}
+	moveSync(srcPath, destPath) {
+		this.#context.fs.moveSync(srcPath, destPath);
+	}
+	async copy(srcPath, destPath) {
+		await this.#context.fs.copy(srcPath, destPath);
+	}
+	copySync(srcPath, destPath) {
+		this.#context.fs.copySync(srcPath, destPath);
+	}
+	async fileExists(filePath) {
+		return this.#context.fs.isFile(filePath);
+	}
+	fileExistsSync(filePath) {
+		return this.#context.fs.isFileSync(filePath);
+	}
+	async directoryExists(dirPath) {
+		return this.#context.fs.isDirectory(dirPath);
+	}
+	directoryExistsSync(dirPath) {
+		return this.#context.fs.isDirectorySync(dirPath);
+	}
+	realpathSync(path) {
+		return this.#context.fs.resolveSync(path) || path;
+	}
+	getCurrentDirectory() {
+		return this.#context.config.cwd;
+	}
+	async glob(patterns) {
+		return this.#context.fs.glob(patterns);
+	}
+	globSync(patterns) {
+		return this.#context.fs.globSync(patterns);
+	}
+};
+/**
+* Create a ts-morph {@link Project} instance used for type reflection and module manipulation during processing
+*
+* @param context - The Powerlines context
+* @returns A ts-morph {@link Project} instance
+*/
+function createProgram(context, override) {
+	context.debug(`Creating ts-morph Project instance with configuration from: ${context.tsconfig.tsconfigFilePath}.`);
+	return new Project(defu(override ?? {}, {
+		skipAddingFilesFromTsConfig: false,
+		tsConfigFilePath: context.tsconfig.tsconfigFilePath,
+		fileSystem: new VirtualFileSystemHost(context),
+		compilerOptions: defu(context.tsconfig.options ?? {}, { lib: ["lib.esnext.full.d.ts"] })
+	}));
+}
+
+//#endregion
+export { VirtualFileSystemHost, createProgram };
+//# sourceMappingURL=ts-morph.mjs.map

package/dist/lib/typescript/ts-morph.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-morph.mjs","names":["#context"],"sources":["../../../src/lib/typescript/ts-morph.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 defu from \"defu\";\nimport {\n  CompilerOptions,\n  FileSystemHost,\n  InMemoryFileSystemHost,\n  Project,\n  ProjectOptions,\n  RuntimeDirEntry\n} from \"ts-morph\";\nimport type { Context } from \"../../types/context\";\n\nexport class VirtualFileSystemHost\n  extends InMemoryFileSystemHost\n  implements FileSystemHost\n{\n  #context: Context;\n\n  public constructor(context: Context) {\n    super();\n\n    this.#context = context;\n  }\n\n  public override deleteSync(path: string) {\n    this.#context.fs.removeSync(path);\n  }\n\n  public override readDirSync(dirPath: string): RuntimeDirEntry[] {\n    if (!this.#context.fs.isDirectorySync(dirPath)) {\n      return [];\n    }\n\n    return this.#context.fs.listSync(dirPath).reduce((ret, entry) => {\n      const fullPath = this.#context.fs.resolveSync(entry);\n      if (fullPath) {\n        ret.push({\n          name: entry,\n          isDirectory: this.#context.fs.isDirectorySync(fullPath),\n          isFile: this.#context.fs.isFileSync(fullPath),\n          isSymlink: false\n        });\n      }\n\n      return ret;\n    }, [] as RuntimeDirEntry[]);\n  }\n\n  public override async readFile(filePath: string) {\n    if (!this.#context.fs.isFileSync(filePath)) {\n      return \"\";\n    }\n\n    return (await this.#context.fs.read(filePath))!;\n  }\n\n  public override readFileSync(filePath: string) {\n    if (!this.#context.fs.isFileSync(filePath)) {\n      return \"\";\n    }\n\n    return this.#context.fs.readSync(filePath)!;\n  }\n\n  public override async writeFile(filePath: string, fileText: string) {\n    return this.#context.fs.write(filePath, fileText);\n  }\n\n  public override writeFileSync(filePath: string, fileText: string) {\n    this.#context.fs.writeSync(filePath, fileText);\n  }\n\n  public override async mkdir(dirPath: string) {\n    await this.#context.fs.mkdir(dirPath);\n  }\n\n  public override mkdirSync(dirPath: string) {\n    this.#context.fs.mkdirSync(dirPath);\n  }\n\n  public override async move(srcPath: string, destPath: string) {\n    await this.#context.fs.move(srcPath, destPath);\n  }\n\n  public override moveSync(srcPath: string, destPath: string) {\n    this.#context.fs.moveSync(srcPath, destPath);\n  }\n\n  public override async copy(srcPath: string, destPath: string) {\n    await this.#context.fs.copy(srcPath, destPath);\n  }\n\n  public override copySync(srcPath: string, destPath: string) {\n    this.#context.fs.copySync(srcPath, destPath);\n  }\n\n  public override async fileExists(filePath: string) {\n    return this.#context.fs.isFile(filePath);\n  }\n\n  public override fileExistsSync(filePath: string) {\n    return this.#context.fs.isFileSync(filePath);\n  }\n\n  public override async directoryExists(dirPath: string) {\n    return this.#context.fs.isDirectory(dirPath);\n  }\n\n  public override directoryExistsSync(dirPath: string): boolean {\n    return this.#context.fs.isDirectorySync(dirPath);\n  }\n\n  public override realpathSync(path: string) {\n    return this.#context.fs.resolveSync(path) || path;\n  }\n\n  public override getCurrentDirectory() {\n    return this.#context.config.cwd;\n  }\n\n  public override async glob(\n    patterns: ReadonlyArray<string>\n  ): Promise<string[]> {\n    return this.#context.fs.glob(patterns as string[]);\n  }\n\n  public override globSync(patterns: ReadonlyArray<string>): string[] {\n    return this.#context.fs.globSync(patterns as string[]);\n  }\n}\n\n/**\n * Create a ts-morph {@link Project} instance used for type reflection and module manipulation during processing\n *\n * @param context - The Powerlines context\n * @returns A ts-morph {@link Project} instance\n */\nexport function createProgram(\n  context: Context,\n  override: Partial<ProjectOptions>\n): Project {\n  context.debug(\n    `Creating ts-morph Project instance with configuration from: ${\n      context.tsconfig.tsconfigFilePath\n    }.`\n  );\n\n  const project = new Project(\n    defu(override ?? {}, {\n      skipAddingFilesFromTsConfig: false,\n      tsConfigFilePath: context.tsconfig.tsconfigFilePath,\n      fileSystem: new VirtualFileSystemHost(context),\n      compilerOptions: defu(context.tsconfig.options ?? {}, {\n        lib: [\"lib.esnext.full.d.ts\"]\n      }) as CompilerOptions\n    })\n  );\n\n  return project;\n}\n"],"mappings":"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"}

package/dist/lib/typescript/tsconfig.cjs

@@ -0,0 +1,253 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let _stryke_fs_exists = require("@stryke/fs/exists");
+let _stryke_fs_json = require("@stryke/fs/json");
+let _stryke_path_append = require("@stryke/path/append");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu, 1);
+let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk, 1);
+let _stryke_fs_package_fns = require("@stryke/fs/package-fns");
+let _donedeal0_superdiff = require("@donedeal0/superdiff");
+let _stryke_json_storm_json = require("@stryke/json/storm-json");
+let typescript = require("typescript");
+typescript = require_runtime.__toESM(typescript, 1);
+
+//#region src/lib/typescript/tsconfig.ts
+function getTsconfigDtsPath(context) {
+	return (0, _stryke_path_join_paths.joinPaths)((0, _stryke_path_file_path_fns.relativePath)((0, _stryke_path_join_paths.joinPaths)(context.config.cwd, context.config.root), (0, _stryke_path_file_path_fns.findFilePath)(context.typesPath)), (0, _stryke_path_file_path_fns.findFileName)(context.typesPath));
+}
+async function resolveTsconfigChanges(context) {
+	const tsconfig = getParsedTypeScriptConfig(context.config.cwd, context.config.root, context.config.tsconfig, context.config.tsconfigRaw);
+	const tsconfigJson = await (0, _stryke_fs_json.readJsonFile)(getTsconfigFilePath(context.config.cwd, context.config.root, context.config.tsconfig));
+	tsconfigJson.compilerOptions ??= {};
+	if (context.config.output.dts !== false) {
+		const dtsRelativePath = getTsconfigDtsPath(context);
+		if (!tsconfigJson.include?.some((filePattern) => isIncludeMatchFound(filePattern, [context.typesPath, dtsRelativePath]))) {
+			tsconfigJson.include ??= [];
+			tsconfigJson.include.push(dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath);
+		}
+	}
+	if (!tsconfig.options.lib?.some((lib) => [
+		"lib.esnext.d.ts",
+		"lib.es2021.d.ts",
+		"lib.es2022.d.ts",
+		"lib.es2023.d.ts"
+	].includes(lib.toLowerCase()))) {
+		tsconfigJson.compilerOptions.lib ??= [];
+		tsconfigJson.compilerOptions.lib.push("esnext");
+	}
+	if (tsconfig.options.esModuleInterop !== true) tsconfigJson.compilerOptions.esModuleInterop = true;
+	if (tsconfig.options.isolatedModules !== true) tsconfigJson.compilerOptions.isolatedModules = true;
+	if (context.config.platform === "node") {
+		if (!tsconfig.options.types?.some((type) => type.toLowerCase() === "node" || type.toLowerCase() === "@types/node")) {
+			tsconfigJson.compilerOptions.types ??= [];
+			tsconfigJson.compilerOptions.types.push("node");
+		}
+	}
+	return tsconfigJson;
+}
+async function initializeTsconfig(context) {
+	context.debug("Initializing TypeScript configuration (tsconfig.json) for the Powerlines project.");
+	if (!(0, _stryke_fs_package_fns.isPackageExists)("typescript")) throw new Error("The TypeScript package is not installed. Please install the package using the command: \"npm install typescript --save-dev\"");
+	const tsconfigFilePath = getTsconfigFilePath(context.config.cwd, context.config.root, context.config.tsconfig);
+	context.tsconfig.originalTsconfigJson = await (0, _stryke_fs_json.readJsonFile)(tsconfigFilePath);
+	context.tsconfig.tsconfigJson = await resolveTsconfigChanges(context);
+	context.debug("Writing updated TypeScript configuration (tsconfig.json) file to disk.");
+	await context.fs.write(tsconfigFilePath, _stryke_json_storm_json.StormJSON.stringify(context.tsconfig.tsconfigJson));
+	context.tsconfig = getParsedTypeScriptConfig(context.config.cwd, context.config.root, context.config.tsconfig, context.config.tsconfigRaw, context.tsconfig.originalTsconfigJson);
+}
+async function resolveTsconfig(context) {
+	const updateTsconfigJson = await (0, _stryke_fs_json.readJsonFile)(context.tsconfig.tsconfigFilePath);
+	if (updateTsconfigJson?.compilerOptions?.types && Array.isArray(updateTsconfigJson.compilerOptions.types) && !updateTsconfigJson.compilerOptions.types.length) delete updateTsconfigJson.compilerOptions.types;
+	const result = (0, _donedeal0_superdiff.getObjectDiff)(context.tsconfig.originalTsconfigJson, updateTsconfigJson, {
+		ignoreArrayOrder: true,
+		showOnly: {
+			statuses: [
+				"added",
+				"deleted",
+				"updated"
+			],
+			granularity: "deep"
+		}
+	});
+	const changes = [];
+	const getChanges = (difference, property) => {
+		if (difference.status === "added" || difference.status === "deleted" || difference.status === "updated") if (difference.diff) for (const diff of difference.diff) getChanges(diff, property ? `${property}.${difference.property}` : difference.property);
+		else changes.push({
+			field: property ? `${property}.${difference.property}` : difference.property,
+			status: difference.status,
+			previous: difference.status === "added" ? "---" : _stryke_json_storm_json.StormJSON.stringify(difference.previousValue),
+			current: difference.status === "deleted" ? "---" : _stryke_json_storm_json.StormJSON.stringify(difference.currentValue)
+		});
+	};
+	for (const diff of result.diff) getChanges(diff);
+	if (changes.length > 0) context.warn(`Updating the following configuration values in "${context.tsconfig.tsconfigFilePath}" file:
+
+    ${changes.map((change, i) => `${chalk.default.bold.whiteBright(`${i + 1}. ${(0, _stryke_string_format_title_case.titleCase)(change.status)} the ${change.field} field: `)}
+    ${chalk.default.red(` - Previous: ${change.previous} `)}
+    ${chalk.default.green(` - Updated: ${change.current} `)}
+  `).join("\n")}
+    `);
+	await context.fs.write(context.tsconfig.tsconfigFilePath, _stryke_json_storm_json.StormJSON.stringify(updateTsconfigJson));
+	context.tsconfig = getParsedTypeScriptConfig(context.config.cwd, context.config.root, context.config.tsconfig);
+	if (!context.tsconfig) throw new Error("Failed to parse the TypeScript configuration file.");
+}
+/**
+* Get the path to the tsconfig.json file.
+*
+* @param cwd - The root directory of the workspace.
+* @param root - The root directory of the project.
+* @param tsconfig - The path to the tsconfig.json file.
+* @returns The absolute path to the tsconfig.json file.
+* @throws If the tsconfig.json file does not exist.
+*/
+function getTsconfigFilePath(cwd, root, tsconfig) {
+	let tsconfigFilePath;
+	if (tsconfig) tsconfigFilePath = tryTsconfigFilePath(cwd, root, tsconfig);
+	else {
+		tsconfigFilePath = tryTsconfigFilePath(cwd, root, "tsconfig.app.json");
+		if (!tsconfigFilePath) {
+			tsconfigFilePath = tryTsconfigFilePath(cwd, root, "tsconfig.lib.json");
+			if (!tsconfigFilePath) tsconfigFilePath = tryTsconfigFilePath(cwd, root, "tsconfig.json");
+		}
+	}
+	if (!tsconfigFilePath) throw new Error(`Cannot find the \`tsconfig.json\` configuration file for the project at ${root}.`);
+	return tsconfigFilePath;
+}
+/**
+* Get the path to the tsconfig.json file.
+*
+* @param cwd - The root directory of the workspace.
+* @param root - The root directory of the project.
+* @param tsconfig - The path to the tsconfig.json file.
+* @returns The absolute path to the tsconfig.json file.
+* @throws If the tsconfig.json file does not exist.
+*/
+function tryTsconfigFilePath(cwd, root, tsconfig) {
+	let tsconfigFilePath = tsconfig;
+	if (!(0, _stryke_fs_exists.existsSync)(tsconfigFilePath)) {
+		tsconfigFilePath = (0, _stryke_path_append.appendPath)(tsconfig, root);
+		if (!(0, _stryke_fs_exists.existsSync)(tsconfigFilePath)) {
+			tsconfigFilePath = (0, _stryke_path_append.appendPath)(tsconfig, (0, _stryke_path_append.appendPath)(root, cwd));
+			if (!(0, _stryke_fs_exists.existsSync)(tsconfigFilePath)) return;
+		}
+	}
+	return tsconfigFilePath;
+}
+/**
+* Check if the TypeScript configuration type matches any of the provided types.
+*
+* @param tsconfigType - The type from the TypeScript configuration.
+* @param types - An array of type names to check against.
+* @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+*/
+function findMatch(tsconfigType, types, extensions = [
+	".ts",
+	".tsx",
+	".d.ts"
+]) {
+	return types.find((type) => tsconfigType?.toString().toLowerCase() === type?.toString().toLowerCase() || tsconfigType?.toString().toLowerCase() === `./${type?.toString().toLowerCase()}` || `./${tsconfigType?.toString().toLowerCase()}` === type?.toString().toLowerCase() || extensions.some((ext) => `${tsconfigType?.toString().toLowerCase()}${ext}` === type?.toString().toLowerCase() || `${tsconfigType?.toString().toLowerCase()}${ext}` === `./${type?.toString().toLowerCase()}` || `${type?.toString().toLowerCase()}${ext}` === `./${tsconfigType?.toString().toLowerCase()}` || tsconfigType?.toString().toLowerCase() === `${type?.toString().toLowerCase()}${ext}` || tsconfigType?.toString().toLowerCase() === `./${type?.toString().toLowerCase()}${ext}` || type?.toString().toLowerCase() === `./${tsconfigType?.toString().toLowerCase()}${ext}`));
+}
+/**
+* Check if the TypeScript configuration type matches any of the provided types.
+*
+* @param tsconfigType - The type from the TypeScript configuration.
+* @param types - An array of type names to check against.
+* @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+*/
+function findIncludeMatch(tsconfigType, types) {
+	return findMatch(tsconfigType, types, [
+		".ts",
+		".tsx",
+		".d.ts",
+		".js",
+		".jsx",
+		".mjs",
+		".cjs",
+		".mts",
+		".cts",
+		"/*.ts",
+		"/*.tsx",
+		"/*.d.ts",
+		"/*.js",
+		"/*.jsx",
+		"/*.mjs",
+		"/*.cjs",
+		"/*.mts",
+		"/*.cts",
+		"/**/*.ts",
+		"/**/*.tsx",
+		"/**/*.d.ts",
+		"/**/*.js",
+		"/**/*.jsx",
+		"/**/*.mjs",
+		"/**/*.cjs",
+		"/**/*.mts",
+		"/**/*.cts"
+	]);
+}
+/**
+* Check if the TypeScript configuration type matches any of the provided types.
+*
+* @param tsconfigType - The type from the TypeScript configuration.
+* @param types - An array of type names to check against.
+* @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+*/
+function isMatchFound(tsconfigType, types) {
+	return findMatch(tsconfigType, types) !== void 0;
+}
+/**
+* Check if the TypeScript configuration type matches any of the provided types.
+*
+* @param tsconfigType - The type from the TypeScript configuration.
+* @param types - An array of type names to check against.
+* @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+*/
+function isIncludeMatchFound(tsconfigType, types) {
+	return findIncludeMatch(tsconfigType, types) !== void 0;
+}
+/**
+* Get the parsed TypeScript configuration.
+*
+* @param workspaceRoot - The root directory of the workspace.
+* @param projectRoot - The root directory of the project.
+* @param tsconfig - The path to the tsconfig.json file.
+* @param tsconfigRaw - The raw tsconfig.json content.
+* @param originalTsconfigJson - The original tsconfig.json content.
+* @param host - The TypeScript parse config host.
+* @returns The resolved TypeScript configuration.
+*/
+function getParsedTypeScriptConfig(workspaceRoot, projectRoot, tsconfig, tsconfigRaw = {}, originalTsconfigJson, host = typescript.default.sys) {
+	const tsconfigFilePath = getTsconfigFilePath(workspaceRoot, projectRoot, tsconfig);
+	const tsconfigJson = (0, _stryke_fs_json.readJsonFileSync)(tsconfigFilePath);
+	if (!tsconfigJson) throw new Error(`Cannot find the \`tsconfig.json\` configuration file at ${(0, _stryke_path_join_paths.joinPaths)(projectRoot, tsconfig ?? "tsconfig.json")}`);
+	const parsedCommandLine = typescript.default.parseJsonConfigFileContent((0, defu.default)(tsconfigRaw ?? {}, tsconfigJson), host, (0, _stryke_path_append.appendPath)(projectRoot, workspaceRoot));
+	if (parsedCommandLine.errors.length > 0) {
+		const errorMessage = `Cannot parse the TypeScript compiler options. Please investigate the following issues:
+${parsedCommandLine.errors.map((error) => `- ${(error.category !== void 0 && error.code ? `[${error.category}-${error.code}]: ` : "") + error.messageText.toString()}`).join("\n")}
+      `;
+		throw new Error(errorMessage);
+	}
+	return {
+		...parsedCommandLine,
+		originalTsconfigJson: originalTsconfigJson ?? tsconfigJson,
+		tsconfigJson,
+		tsconfigFilePath
+	};
+}
+
+//#endregion
+exports.findIncludeMatch = findIncludeMatch;
+exports.findMatch = findMatch;
+exports.getParsedTypeScriptConfig = getParsedTypeScriptConfig;
+exports.getTsconfigDtsPath = getTsconfigDtsPath;
+exports.getTsconfigFilePath = getTsconfigFilePath;
+exports.initializeTsconfig = initializeTsconfig;
+exports.isIncludeMatchFound = isIncludeMatchFound;
+exports.isMatchFound = isMatchFound;
+exports.resolveTsconfig = resolveTsconfig;
+exports.tryTsconfigFilePath = tryTsconfigFilePath;

package/dist/lib/typescript/tsconfig.d.cts

@@ -0,0 +1,77 @@
+import { ParsedTypeScriptConfig, TSConfig } from "../../types/tsconfig.cjs";
+import { EnvironmentContext } from "../../types/context.cjs";
+import { ResolvedConfig } from "../../types/config.cjs";
+import { FilterPattern } from "@stryke/types/file";
+import ts from "typescript";
+
+//#region src/lib/typescript/tsconfig.d.ts
+declare function getTsconfigDtsPath<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown>(context: EnvironmentContext<TResolvedConfig, TSystemContext>): string;
+declare function initializeTsconfig<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext>>(context: TContext): Promise<void>;
+declare function resolveTsconfig<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext>>(context: TContext): Promise<void>;
+/**
+ * Get the path to the tsconfig.json file.
+ *
+ * @param cwd - The root directory of the workspace.
+ * @param root - The root directory of the project.
+ * @param tsconfig - The path to the tsconfig.json file.
+ * @returns The absolute path to the tsconfig.json file.
+ * @throws If the tsconfig.json file does not exist.
+ */
+declare function getTsconfigFilePath(cwd: string, root: string, tsconfig?: string): string;
+/**
+ * Get the path to the tsconfig.json file.
+ *
+ * @param cwd - The root directory of the workspace.
+ * @param root - The root directory of the project.
+ * @param tsconfig - The path to the tsconfig.json file.
+ * @returns The absolute path to the tsconfig.json file.
+ * @throws If the tsconfig.json file does not exist.
+ */
+declare function tryTsconfigFilePath(cwd: string, root: string, tsconfig: string): string | undefined;
+/**
+ * Check if the TypeScript configuration type matches any of the provided types.
+ *
+ * @param tsconfigType - The type from the TypeScript configuration.
+ * @param types - An array of type names to check against.
+ * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+ */
+declare function findMatch(tsconfigType: string | RegExp | null, types: (string | RegExp | null)[], extensions?: string[]): string | RegExp | null | undefined;
+/**
+ * Check if the TypeScript configuration type matches any of the provided types.
+ *
+ * @param tsconfigType - The type from the TypeScript configuration.
+ * @param types - An array of type names to check against.
+ * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+ */
+declare function findIncludeMatch(tsconfigType: string | RegExp | null, types: (string | RegExp | null)[]): string | RegExp | null | undefined;
+/**
+ * Check if the TypeScript configuration type matches any of the provided types.
+ *
+ * @param tsconfigType - The type from the TypeScript configuration.
+ * @param types - An array of type names to check against.
+ * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+ */
+declare function isMatchFound(tsconfigType: string | RegExp | null, types: (string | RegExp | null)[]): boolean;
+/**
+ * Check if the TypeScript configuration type matches any of the provided types.
+ *
+ * @param tsconfigType - The type from the TypeScript configuration.
+ * @param types - An array of type names to check against.
+ * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+ */
+declare function isIncludeMatchFound(tsconfigType: FilterPattern, types: FilterPattern[]): boolean;
+/**
+ * Get the parsed TypeScript configuration.
+ *
+ * @param workspaceRoot - The root directory of the workspace.
+ * @param projectRoot - The root directory of the project.
+ * @param tsconfig - The path to the tsconfig.json file.
+ * @param tsconfigRaw - The raw tsconfig.json content.
+ * @param originalTsconfigJson - The original tsconfig.json content.
+ * @param host - The TypeScript parse config host.
+ * @returns The resolved TypeScript configuration.
+ */
+declare function getParsedTypeScriptConfig(workspaceRoot: string, projectRoot: string, tsconfig?: string, tsconfigRaw?: TSConfig, originalTsconfigJson?: TSConfig, host?: ts.ParseConfigHost): ParsedTypeScriptConfig;
+//#endregion
+export { findIncludeMatch, findMatch, getParsedTypeScriptConfig, getTsconfigDtsPath, getTsconfigFilePath, initializeTsconfig, isIncludeMatchFound, isMatchFound, resolveTsconfig, tryTsconfigFilePath };
+//# sourceMappingURL=tsconfig.d.cts.map

package/dist/lib/typescript/tsconfig.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.d.cts","names":[],"sources":["../../../src/lib/typescript/tsconfig.ts"],"mappings":";;;;;;;iBAyCgB,kBAAA,yBACU,cAAA,GAAiB,cAAA,2BAAA,CAEzC,OAAA,EAAS,kBAAA,CAAmB,eAAA,EAAiB,cAAA;AAAA,iBAiJzB,kBAAA,yBACI,cAAA,GAAiB,cAAA,6CAExB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACnD,kBAAA,CAAmB,eAAA,EAAiB,cAAA,EAAA,CACtC,OAAA,EAAS,QAAA,GAAW,OAAA;AAAA,iBA2CA,eAAA,yBACI,cAAA,GAAiB,cAAA,6CAExB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACnD,kBAAA,CAAmB,eAAA,EAAiB,cAAA,EAAA,CACtC,OAAA,EAAS,QAAA,GAAW,OAAA;;;;;;;;;;iBA+GN,mBAAA,CACd,GAAA,UACA,IAAA,UACA,QAAA;;;;;;;;;;iBAmCc,mBAAA,CACd,GAAA,UACA,IAAA,UACA,QAAA;;;;;;;;iBAuBc,SAAA,CACd,YAAA,WAAuB,MAAA,SACvB,KAAA,YAAiB,MAAA,YACjB,UAAA,uBACU,MAAA;;;;;;;;iBAkCI,gBAAA,CACd,YAAA,WAAuB,MAAA,SACvB,KAAA,YAAiB,MAAA,sBACP,MAAA;;;;;;;;iBAuCI,YAAA,CACd,YAAA,WAAuB,MAAA,SACvB,KAAA,YAAiB,MAAA;;;;;;;AAtQnB;iBAkRgB,mBAAA,CACd,YAAA,EAAc,aAAA,EACd,KAAA,EAAO,aAAA;;;;;;;;;;;;iBAqBO,yBAAA,CACd,aAAA,UACA,WAAA,UACA,QAAA,WACA,WAAA,GAAa,QAAA,EACb,oBAAA,GAAuB,QAAA,EACvB,IAAA,GAAM,EAAA,CAAG,eAAA,GACR,sBAAA"}

package/dist/lib/typescript/tsconfig.d.mts

@@ -0,0 +1,77 @@
+import { ParsedTypeScriptConfig, TSConfig } from "../../types/tsconfig.mjs";
+import { EnvironmentContext } from "../../types/context.mjs";
+import { ResolvedConfig } from "../../types/config.mjs";
+import ts from "typescript";
+import { FilterPattern } from "@stryke/types/file";
+
+//#region src/lib/typescript/tsconfig.d.ts
+declare function getTsconfigDtsPath<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown>(context: EnvironmentContext<TResolvedConfig, TSystemContext>): string;
+declare function initializeTsconfig<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext>>(context: TContext): Promise<void>;
+declare function resolveTsconfig<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext>>(context: TContext): Promise<void>;
+/**
+ * Get the path to the tsconfig.json file.
+ *
+ * @param cwd - The root directory of the workspace.
+ * @param root - The root directory of the project.
+ * @param tsconfig - The path to the tsconfig.json file.
+ * @returns The absolute path to the tsconfig.json file.
+ * @throws If the tsconfig.json file does not exist.
+ */
+declare function getTsconfigFilePath(cwd: string, root: string, tsconfig?: string): string;
+/**
+ * Get the path to the tsconfig.json file.
+ *
+ * @param cwd - The root directory of the workspace.
+ * @param root - The root directory of the project.
+ * @param tsconfig - The path to the tsconfig.json file.
+ * @returns The absolute path to the tsconfig.json file.
+ * @throws If the tsconfig.json file does not exist.
+ */
+declare function tryTsconfigFilePath(cwd: string, root: string, tsconfig: string): string | undefined;
+/**
+ * Check if the TypeScript configuration type matches any of the provided types.
+ *
+ * @param tsconfigType - The type from the TypeScript configuration.
+ * @param types - An array of type names to check against.
+ * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+ */
+declare function findMatch(tsconfigType: string | RegExp | null, types: (string | RegExp | null)[], extensions?: string[]): string | RegExp | null | undefined;
+/**
+ * Check if the TypeScript configuration type matches any of the provided types.
+ *
+ * @param tsconfigType - The type from the TypeScript configuration.
+ * @param types - An array of type names to check against.
+ * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+ */
+declare function findIncludeMatch(tsconfigType: string | RegExp | null, types: (string | RegExp | null)[]): string | RegExp | null | undefined;
+/**
+ * Check if the TypeScript configuration type matches any of the provided types.
+ *
+ * @param tsconfigType - The type from the TypeScript configuration.
+ * @param types - An array of type names to check against.
+ * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+ */
+declare function isMatchFound(tsconfigType: string | RegExp | null, types: (string | RegExp | null)[]): boolean;
+/**
+ * Check if the TypeScript configuration type matches any of the provided types.
+ *
+ * @param tsconfigType - The type from the TypeScript configuration.
+ * @param types - An array of type names to check against.
+ * @returns True if the TypeScript configuration type matches any of the provided types, false otherwise.
+ */
+declare function isIncludeMatchFound(tsconfigType: FilterPattern, types: FilterPattern[]): boolean;
+/**
+ * Get the parsed TypeScript configuration.
+ *
+ * @param workspaceRoot - The root directory of the workspace.
+ * @param projectRoot - The root directory of the project.
+ * @param tsconfig - The path to the tsconfig.json file.
+ * @param tsconfigRaw - The raw tsconfig.json content.
+ * @param originalTsconfigJson - The original tsconfig.json content.
+ * @param host - The TypeScript parse config host.
+ * @returns The resolved TypeScript configuration.
+ */
+declare function getParsedTypeScriptConfig(workspaceRoot: string, projectRoot: string, tsconfig?: string, tsconfigRaw?: TSConfig, originalTsconfigJson?: TSConfig, host?: ts.ParseConfigHost): ParsedTypeScriptConfig;
+//#endregion
+export { findIncludeMatch, findMatch, getParsedTypeScriptConfig, getTsconfigDtsPath, getTsconfigFilePath, initializeTsconfig, isIncludeMatchFound, isMatchFound, resolveTsconfig, tryTsconfigFilePath };
+//# sourceMappingURL=tsconfig.d.mts.map

package/dist/lib/typescript/tsconfig.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.d.mts","names":[],"sources":["../../../src/lib/typescript/tsconfig.ts"],"mappings":";;;;;;;iBAyCgB,kBAAA,yBACU,cAAA,GAAiB,cAAA,2BAAA,CAEzC,OAAA,EAAS,kBAAA,CAAmB,eAAA,EAAiB,cAAA;AAAA,iBAiJzB,kBAAA,yBACI,cAAA,GAAiB,cAAA,6CAExB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACnD,kBAAA,CAAmB,eAAA,EAAiB,cAAA,EAAA,CACtC,OAAA,EAAS,QAAA,GAAW,OAAA;AAAA,iBA2CA,eAAA,yBACI,cAAA,GAAiB,cAAA,6CAExB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACnD,kBAAA,CAAmB,eAAA,EAAiB,cAAA,EAAA,CACtC,OAAA,EAAS,QAAA,GAAW,OAAA;;;;;;;;;;iBA+GN,mBAAA,CACd,GAAA,UACA,IAAA,UACA,QAAA;;;;;;;;;;iBAmCc,mBAAA,CACd,GAAA,UACA,IAAA,UACA,QAAA;;;;;;;;iBAuBc,SAAA,CACd,YAAA,WAAuB,MAAA,SACvB,KAAA,YAAiB,MAAA,YACjB,UAAA,uBACU,MAAA;;;;;;;;iBAkCI,gBAAA,CACd,YAAA,WAAuB,MAAA,SACvB,KAAA,YAAiB,MAAA,sBACP,MAAA;;;;;;;;iBAuCI,YAAA,CACd,YAAA,WAAuB,MAAA,SACvB,KAAA,YAAiB,MAAA;;;;;;;AAtQnB;iBAkRgB,mBAAA,CACd,YAAA,EAAc,aAAA,EACd,KAAA,EAAO,aAAA;;;;;;;;;;;;iBAqBO,yBAAA,CACd,aAAA,UACA,WAAA,UACA,QAAA,WACA,WAAA,GAAa,QAAA,EACb,oBAAA,GAAuB,QAAA,EACvB,IAAA,GAAM,EAAA,CAAG,eAAA,GACR,sBAAA"}