@plugjs/tsgo 0.0.0

package/dist/projects.js

@@ -0,0 +1,209 @@
+import { assert } from '@plugjs/plug/asserts';
+import { $gry, $p, $ylw, ERROR } from '@plugjs/plug/logging';
+import { assertAbsolutePath, getAbsoluteParent, resolveFile } from '@plugjs/plug/paths';
+import { convertProjectDiagnostics } from './diagnostics.js';
+/* ========================================================================== */
+/**
+ * Find the TypeScript project configuration file for a given path.
+ *
+ * The path specified can be a `tsconfig.json` file name or a directory
+ * containing a `tsconfig.json` file.
+ *
+ * The returned path is the absolute path of the actual `tsconfig.json` file.
+ */
+export function findProjectConfig(path) {
+    // The specified path can be either a file or a directory containing a
+    // "tsconfig.json" file: resolve as a file, then assume it's a directory
+    let file = resolveFile(path);
+    if (!file)
+        file = resolveFile(path, 'tsconfig.json');
+    assert(file, `TypeScript configuration file not found in "${path}"`);
+    return file;
+}
+/**
+ * Read the TypeScript project configuration file for a given path.
+ *
+ * The path specified can be a `tsconfig.json` file name or a directory
+ * containing a `tsconfig.json` file.
+ *
+ * The returned object contains the resolved configuration file name (in `path`)
+ * and the array of resolved project references (the actual resolved files on
+ * disk in `references`).
+ *
+ * Any errors encountered while reading the configuration file or resolving its
+ * references are returned in the `errors` array.
+ */
+export async function readProjectConfig(api, path) {
+    const file = findProjectConfig(path);
+    // Use the TypeScript API to load up this project... We already update the
+    // snapshot here, so we don't need to do it again once we end up compiling
+    // the whole project...
+    const snapshot = await api.updateSnapshot({ openProjects: [file] });
+    const project = snapshot.getProject(file);
+    assert(project, `Failed to open TypeScript project from "${file}"`);
+    assertAbsolutePath(project.configFileName);
+    path = project.configFileName; // rewrite the path to the actual
+    // Get any diagnostics encountered while parsing the configuration file
+    // and any "global" diagnostics (not associated with a specific file)...
+    const diagnostics = await Promise.all([
+        project.program.getGlobalDiagnostics(),
+        project.program.getProgramDiagnostics(),
+        project.program.getConfigFileParsingDiagnostics(),
+    ]).then((results) => results.flat());
+    // Convert the diagnostics to our simplified format
+    const errors = await convertProjectDiagnostics(diagnostics, project.program, path);
+    // Prepare our simplified result object
+    const config = project.parsedCommandLine;
+    const result = { path, errors, config, references: [] };
+    // Resolve the references to absolute paths
+    const directory = getAbsoluteParent(path);
+    for (const reference of config.projectReferences ?? []) {
+        let resolved = resolveFile(directory, reference.path);
+        if (!resolved)
+            resolved = resolveFile(directory, reference.path, 'tsconfig.json');
+        if (resolved)
+            result.references.push(resolved);
+    }
+    // All done
+    return result;
+}
+/**
+ * Find _all_ project references given a set of initial project paths.
+ *
+ * The returned map contains all the projects (resolved configuration file
+ * names) and their referring projects as values.
+ */
+export async function findProjectReferences(api, ...paths) {
+    // The set of *all* projects, whether we have resolved them yet or not.
+    const remainingProjects = new Set(paths);
+    // The set of all *resolved* projects (that is, opened and parsed)
+    const resolvedProjects = new Set();
+    // The map of all our projects, keyed by their resolved configuration file
+    // name and having the set of projects that refer to it as a value
+    const projects = new Map();
+    // An array of all errors encountered while reading the configuration files
+    const errors = [];
+    // Add a referring project to the set of referring projects for a referred project
+    function addProject(referredProject, referringProject) {
+        let referringProjects = projects.get(referredProject);
+        if (!referringProjects) {
+            referringProjects = new Set();
+            projects.set(referredProject, referringProjects);
+        }
+        if (referringProject)
+            referringProjects.add(referringProject);
+    }
+    while (remainingProjects.size > 0) {
+        // Take and remove the next project from the remaining set
+        const project = remainingProjects.values().next().value;
+        remainingProjects.delete(project);
+        // Read the project configuration file and its references
+        const { path, references, errors: e } = await readProjectConfig(api, project);
+        // If we already resolved this project, skip it
+        if (resolvedProjects.has(path))
+            continue;
+        // Push any errors encountered while reading the configuration file
+        errors.push(...e);
+        // Add the project (resolved filename) to the resolved set
+        resolvedProjects.add(path);
+        // Record the project and its references in our map of projects
+        addProject(path);
+        // Look at all the project references
+        for (const reference of references) {
+            // If we haven't resolved this reference yet, add it to the remaining
+            if (!resolvedProjects.has(reference))
+                remainingProjects.add(reference);
+            // Then make sure that we record the referring project for this reference
+            addProject(reference, path);
+        }
+    }
+    // Return our projects map and all errors
+    return { projects, errors };
+}
+/**
+ * Use Kahn's topological-sort algorithm on a map of projects and their
+ * references to determine the order in which they should be built.
+ *
+ * @param projects A map of projects and their referring projects
+ * @returns The order of projects, any unresolved projects, and cycles found
+ */
+export function resolveProjectOrder(projects) {
+    // The number of unresolved dependencies for each project
+    const counts = Object.create(null);
+    // Iterate through all the projects (and their referring projects), counting
+    // the number of unresolved dependencies for each project.
+    for (const [referred, referring] of projects.entries()) {
+        // Ensure the referred project has a dependencies count (even if it is zero)
+        counts[referred] = counts[referred] ?? 0;
+        // For each referring project, increment its count of unresolved dependencies
+        for (const ref of referring)
+            counts[ref] = (counts[ref] ?? 0) + 1;
+    }
+    // The unique set of all known projects (referred and referring)
+    const uniques = Object.keys(counts);
+    // Projects are "ready" when all dependencies have been resolved (zero count)
+    const ready = uniques.filter((project) => counts[project] === 0);
+    // The final order of projects (in dependency order)
+    const order = [];
+    // While there are still projects ready to be processed, take the first one
+    for (let project = ready.shift(); project; project = ready.shift()) {
+        // Add the project to the final order
+        order.push(project);
+        // For each project that depends on this project, decrement its unresolved
+        // dependency count. If it reaches zero, add it to the ready queue.
+        for (const dependent of projects.get(project) ?? /* coverage ignore next */ []) {
+            const remaining = (counts[dependent] = counts[dependent] - 1);
+            if (remaining === 0)
+                ready.push(dependent);
+        }
+    }
+    // When no more projects are "ready", the remaining projects are unresolved
+    const unresolved = uniques.filter((project) => counts[project]);
+    // If we have no unresolved projects, we can return the order (no cycles)
+    if (unresolved.length === 0)
+        return { order, unresolved, cycles: [], errors: [] };
+    // ===== FIND CYCLES =========================================================
+    // Projects we _already_ visited (and thus don't need to visit again)
+    const visited = new Set();
+    // The list of cycles we have found (each cycle is a list of projects)
+    const cycles = [];
+    // Recursively visit a project's dependents, looking for cycles
+    function visit(project, stack = []) {
+        // If this project is already in the current path, we found a cycle
+        const index = stack.indexOf(project);
+        if (index >= 0) {
+            cycles.push([...stack.slice(index), project]);
+            return;
+        }
+        // Don't revisit projects whose dependents have all been processed
+        if (visited.has(project))
+            return;
+        // Add this project to the current path and visit its dependents
+        const next = [...stack, project];
+        for (const dependent of projects.get(project) ?? /* coverage ignore next */ []) {
+            if (unresolved.includes(dependent))
+                visit(dependent, next);
+        }
+        // Mark the project as visited after all its dependents have been processed
+        visited.add(project);
+    }
+    // Visit all the unresolved projects, looking for cycles
+    for (const project of unresolved)
+        visit(project);
+    // Prep our errors
+    const errors = [];
+    errors.push({
+        level: ERROR,
+        message: `Found ${$ylw(unresolved.length)} unresolved projects (${$ylw(cycles.length)} cycles)` +
+            `\n${$gry('-')} ${unresolved.map($p).join(`\n${$gry('-')} `)}`,
+    });
+    for (const cycle of cycles) {
+        errors.push({
+            level: ERROR,
+            message: `Project reference cycle:\n${$gry('-')} ${cycle.map($p).join(`\n${$gry('-')} `)}`,
+        });
+    }
+    // Return the final order, unresolved projects, and cycles found
+    return { order, unresolved, cycles, errors };
+}
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"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"}

package/dist/typescript.d.ts

@@ -0,0 +1,27 @@
+import { Files } from '@plugjs/plug/files';
+import type { TscOptions, TypeScriptOptions } from './index.ts';
+import type { Pipe } from '@plugjs/plug';
+import type { Context, Plug } from '@plugjs/plug/pipe';
+export declare class TypeScript implements Plug<Files> {
+    private _emitOnly;
+    private _reportDeprecations;
+    private _projectReferences;
+    constructor(options?: TypeScriptOptions);
+    pipe(files: Files, context: Context): Promise<Files>;
+}
+/**
+ * Compile the project identified by the specified configuration file
+ * (either a `tsconfig.json` or a directory containing one).
+ *
+ * This is roughly equivalent to the command line `tsc --project <config>`.
+ */
+export declare function tsc(config: string, options?: TscOptions): Pipe;
+/**
+ * Compile the project identified by the specified configuration file
+ * (either a `tsconfig.json` or a directory containing one) and all of its
+ * references.
+ *
+ * This is roughly equivalent to the command line `tsc --build <config>`.
+ */
+export declare function tsbuild(config: string, options?: TscOptions): Pipe;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../src/typescript.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAQ1C,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAOtD,qBAAa,UAAW,YAAW,IAAI,CAAC,KAAK,CAAC;IAC5C,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,mBAAmB,CAA2B;IACtD,OAAO,CAAC,kBAAkB,CAAS;IAEnC,YAAY,OAAO,GAAE,iBAAsB,EA2C1C;IAEK,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAqGzD;CACF;AAMD;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,IAAI,CAGlE;AAID;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,IAAI,CAGtE"}

package/dist/typescript.js

@@ -0,0 +1,176 @@
+import { using } from '@plugjs/plug';
+import { assert } from '@plugjs/plug/asserts';
+import { Files } from '@plugjs/plug/files';
+import { ERROR } from '@plugjs/plug/logging';
+import { commonPath, getAbsoluteParent, resolveAbsolutePath } from '@plugjs/plug/paths';
+import { API, EmitOnly } from 'typescript/unstable/async';
+import { convertDiagnostics } from './diagnostics.js';
+import { findProjectConfig, findProjectReferences, readProjectConfig, resolveProjectOrder } from './projects.js';
+/* ========================================================================== *
+ * TYPESCRIPT 7 PLUG IMPLEMENTATION                                           *
+ * ========================================================================== */
+export class TypeScript {
+    _emitOnly;
+    _reportDeprecations;
+    _projectReferences;
+    constructor(options = {}) {
+        const { projectReferences, reportDeprecations, emitOnly } = options;
+        this._projectReferences = !!projectReferences;
+        switch (emitOnly) {
+            // If *none* or *false* we don't emit any files at all
+            case 'none':
+            case false:
+                this._emitOnly = null;
+                break;
+            // If *js* we only emit JavaScript files
+            case 'js':
+                this._emitOnly = EmitOnly.OnlyJs;
+                break;
+            // If *dts* we only emit declaration files
+            case 'dts':
+                this._emitOnly = EmitOnly.OnlyDts;
+                break;
+            // If *all* or *true* (default) we emit all files
+            case 'all':
+            case true:
+            default:
+                this._emitOnly = EmitOnly.All;
+                break;
+        }
+        switch (reportDeprecations) {
+            // If *warn* we report deprecations as warnings
+            case 'warn':
+                this._reportDeprecations = 'warn';
+                break;
+            // If *off* or *false* we don't report deprecations at all
+            case 'off':
+            case false:
+                this._reportDeprecations = 'off';
+                break;
+            // If *notice* or *true* (default) we report deprecations as notices
+            case 'notice':
+            case true:
+            default:
+                this._reportDeprecations = 'notice';
+                break;
+        }
+    }
+    async pipe(files, context) {
+        // Create our TypeScript API and report for this plug
+        const api = new API({ cwd: files.directory });
+        const report = context.log.report('TypeScript Report');
+        // This is the list of emitted files to return to the pipe...
+        const emittedFiles = [];
+        try {
+            // The list of projects to build (in order) and the snapshot used
+            // to build them.
+            let projects;
+            let snapshot;
+            // First of all figure out whether we have to build project references
+            // too or not... This will determine whether we have to resolve them....
+            if (this._projectReferences) {
+                // Find all project references for the given configuration files
+                const projectReferences = await findProjectReferences(api, ...files.absolutePaths());
+                report.add(...projectReferences.errors);
+                if (report.errors)
+                    report.done();
+                // Then determine the build order for all projects and their references
+                const projectOrder = resolveProjectOrder(projectReferences.projects);
+                report.add(...projectOrder.errors);
+                if (report.errors)
+                    report.done();
+                // At this point, our list of projects to build is the "order"
+                snapshot = await api.updateSnapshot({ openProjects: projectOrder.order });
+                projects = [...projectOrder.order];
+            }
+            else {
+                // If we're not building references, then we just build our files
+                const configs = [...files.absolutePaths()].map(findProjectConfig);
+                snapshot = await api.updateSnapshot({ openProjects: configs });
+                projects = [...configs];
+                // When resolving the project references above, we already processed
+                // any configuration files and added any errors to the report...
+                // In this case, we have to do it ourselves by reading each config!
+                for (const config of configs) {
+                    const { errors } = await readProjectConfig(api, config);
+                    report.add(...errors);
+                }
+                // If we have any errors at this point, we can't continue...
+                if (report.errors)
+                    report.done();
+            }
+            // Now build all projects in the order we determined earlier
+            for (const project of projects) {
+                // Get the actual TypeScript program for this project...
+                const program = snapshot.getProject(project)?.program;
+                assert(program, `Project "${project}" not found in snapshot`);
+                // Collect compilation diagnostics for this project (has files)
+                const diagnostics = await Promise.all([
+                    program.getBindDiagnostics(),
+                    program.getSemanticDiagnostics(),
+                    program.getSyntacticDiagnostics(),
+                    program.getSuggestionDiagnostics(),
+                    program.getDeclarationDiagnostics(),
+                ]).then((results) => results.flat());
+                // When emitting, let's emit the files
+                if (this._emitOnly !== null) {
+                    // Emit the files for this program and collect diagnostics
+                    const emitted = await program.emit(this._emitOnly);
+                    diagnostics.push(...emitted.diagnostics);
+                    // Make sure that we add any emitted file to the list to be returned
+                    if (emitted.emittedFiles?.length) {
+                        const directory = getAbsoluteParent(project);
+                        const mapper = resolveAbsolutePath.bind(null, directory);
+                        emittedFiles.push(...emitted.emittedFiles.map((file) => mapper(file)));
+                    }
+                    // Report an error if emitting was skipped for some reason (we should
+                    // have some diagnostics associated with this, but still...)
+                    // coverage ignore if // don't know how to test this...
+                    if (emitted.emitSkipped) {
+                        report.add({
+                            level: ERROR,
+                            message: `Unable to emit files for this project`,
+                            file: project,
+                        });
+                    }
+                }
+                // Add all diagnostics to the report
+                report.add(...(await convertDiagnostics(diagnostics, program, this._reportDeprecations)));
+            }
+        }
+        finally {
+            await api.close();
+        }
+        report.done();
+        const outputPath = commonPath(files.directory, ...emittedFiles);
+        return Files.builder(outputPath)
+            .add(...emittedFiles)
+            .build();
+    }
+}
+/* ========================================================================== *
+ * TYPESCRIPT 7 HELPERS                                                       *
+ * ========================================================================== */
+/**
+ * Compile the project identified by the specified configuration file
+ * (either a `tsconfig.json` or a directory containing one).
+ *
+ * This is roughly equivalent to the command line `tsc --project <config>`.
+ */
+export function tsc(config, options = {}) {
+    const { directory, ...opts } = options;
+    return using(config, { directory }).plug(new TypeScript({ ...opts, projectReferences: false }));
+}
+/* ========================================================================== */
+/**
+ * Compile the project identified by the specified configuration file
+ * (either a `tsconfig.json` or a directory containing one) and all of its
+ * references.
+ *
+ * This is roughly equivalent to the command line `tsc --build <config>`.
+ */
+export function tsbuild(config, options = {}) {
+    const { directory, ...opts } = options;
+    return using(config, { directory }).plug(new TypeScript({ ...opts, projectReferences: true }));
+}
+//# sourceMappingURL=typescript.js.map

package/dist/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../src/typescript.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@plugjs/tsgo",
+  "version": "0.0.0",
+  "description": "TypeScript 7.1 support for PlugJS",
+  "keywords": [
+    "build",
+    "compile",
+    "ecmascript",
+    "javascript",
+    "node",
+    "plugjs",
+    "typescript"
+  ],
+  "homepage": "https://github.com/plugjs/tsgo#readme",
+  "bugs": {
+    "url": "https://github.com/plugjs/tsgo/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "Juit Developers <developers@juit.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/plugjs/tsgo.git"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "files": [
+    "*.md",
+    "dist/",
+    "src/"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./typescript": {
+      "types": "./dist/typescript.d.ts",
+      "default": "./dist/typescript.js"
+    }
+  },
+  "scripts": {
+    "build": "plug",
+    "coverage": "plug coverage",
+    "dev": "plug coverage -w src -w test",
+    "lint": "plug lint",
+    "lintfix": "plug lint fix=true",
+    "test": "plug test",
+    "transpile": "plug transpile"
+  },
+  "dependencies": {
+    "typescript": "^7.1.0-dev"
+  },
+  "devDependencies": {
+    "@plugjs/cov8": "^0.7.3",
+    "@plugjs/expect5": "^0.7.3",
+    "@plugjs/oxc": "^0.1.3",
+    "@plugjs/plug": "^0.7.3"
+  },
+  "peerDependencies": {
+    "@plugjs/plug": "^0.7.3"
+  }
+}

package/src/diagnostics.ts

@@ -0,0 +1,123 @@
+import { ERROR, NOTICE, WARN } from '@plugjs/plug/logging'
+import { assertAbsolutePath } from '@plugjs/plug/paths'
+import { DiagnosticCategory } from 'typescript/unstable/async'
+
+import type { ReportRecord } from '@plugjs/plug/logging'
+import type { AbsolutePath } from '@plugjs/plug/paths'
+import type { SourceFile } from 'typescript/unstable/ast'
+import type { Diagnostic, Program } from 'typescript/unstable/async'
+
+function convertDiagnostic(diagnostic: Diagnostic, sourceFile?: SourceFile): ReportRecord {
+  const record: ReportRecord & { tags: string[] } = {
+    level: NOTICE,
+    message: diagnostic.text,
+    tags: [`ts${diagnostic.code}`],
+  }
+
+  switch (diagnostic.category) {
+    case DiagnosticCategory.Error:
+      record.level = ERROR
+      break
+    case DiagnosticCategory.Warning:
+      record.level = WARN
+      break
+  }
+
+  if (diagnostic.reportsDeprecated) record.tags.push('deprecated')
+  if (diagnostic.reportsUnnecessary) record.tags.push('unnecessary')
+
+  if (diagnostic.fileName) {
+    assertAbsolutePath(diagnostic.fileName)
+    record.file = diagnostic.fileName
+  }
+
+  if (sourceFile) {
+    const pos = sourceFile.getLineAndCharacterOfPosition(diagnostic.pos)
+    record.line = pos.line + 1
+    record.column = pos.character + 1
+    record.length = diagnostic.end - diagnostic.pos
+    record.source = sourceFile.getFullText()
+  }
+
+  return record
+}
+
+export async function convertDiagnostics(
+  diagnostics: readonly Diagnostic[],
+  program: Program,
+  deprecations: 'warn' | 'notice' | 'off' = 'notice',
+): Promise<ReportRecord[]> {
+  // Filter out any duplicate diagnostic *before* we convert them to report
+  // records (that might be expensive because of source file lookups)
+  const seen = new Set<string>()
+  const unique = diagnostics.filter((diagnostic) => {
+    const key = JSON.stringify([
+      diagnostic.category,
+      diagnostic.code,
+      diagnostic.text,
+      diagnostic.pos,
+      diagnostic.end,
+      diagnostic.fileName,
+    ])
+    if (seen.has(key)) return false
+    seen.add(key)
+    return true
+  })
+
+  // Convert all diagnostics to report records
+  const converted = await Promise.all(
+    unique.map(async (diagnostic) => {
+      // Anything not an error is not critical
+      const isNonCritical = diagnostic.category !== DiagnosticCategory.Error
+
+      // First of all see how we need to handle non-error deprecations: when
+      // "off" we suppress them, when "warn" we convert them to warnings...
+      if (diagnostic.reportsDeprecated && isNonCritical) {
+        if (deprecations === 'off') return // simply filter this out...
+        if (deprecations === 'warn') {
+          diagnostic = { ...diagnostic, category: DiagnosticCategory.Warning }
+        }
+      }
+
+      // First figure out where this diagnostic came from...
+      const sourceFileMetadata = diagnostic.fileName
+        ? await program.getSourceFileMetadata(diagnostic.fileName)
+        : /* coverage ignore next */ undefined
+
+      // If the source file is in the default library (e.g. "lib.dom.ts") or
+      // from an external library (in "node_modules") then we ONLY keep errors
+      // and (we ignore things like warnings, suggestions, ...)
+      const isExternal = sourceFileMetadata?.isDefaultLibrary || sourceFileMetadata?.isFromExternalLibrary
+      if (isExternal && isNonCritical) return
+
+      // Get the source file and its metadata (if any) for the diagnostic...
+      // We do this *after* the external check above as getting the source file
+      // is quite expensive (especially for things like "lib.es5.dts")...
+      const sourceFile = diagnostic.fileName
+        ? ((await program.getSourceFile(diagnostic.fileName)) ??
+          (await program.getConfigSourceFile(diagnostic.fileName)))
+        : /* coverage ignore next */ undefined
+
+      // Convert our diagnostic to a report record and return it
+      return convertDiagnostic(diagnostic, sourceFile)
+    }),
+  )
+
+  // Filter out any null/undefined records
+  return converted.filter((record): record is ReportRecord => !!record)
+}
+
+export async function convertProjectDiagnostics(
+  diagnostics: readonly Diagnostic[],
+  program: Program,
+  fileName: AbsolutePath,
+): Promise<ReportRecord[]> {
+  // Make sure that we have a file name for the diagnostics
+  const fileDiagnostics = diagnostics.map((diagnostic) => {
+    if (diagnostic.fileName) return diagnostic
+    return { ...diagnostic, fileName }
+  })
+
+  // Convert the diagnostics to report records and return them
+  return convertDiagnostics(fileDiagnostics, program)
+}