@plugjs/tsgo 0.0.6 → 0.1.1

package/src/utils.ts

@@ -0,0 +1,64 @@
+import { assert } from '@plugjs/plug/asserts'
+import { resolveFile } from '@plugjs/plug/paths'
+import { EmitOnly } from 'typescript/async'
+
+import type { TypeScriptOptions } from './index.ts'
+import type { AbsolutePath } from '@plugjs/plug/paths'
+
+/**
+ * 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: AbsolutePath): AbsolutePath {
+  // 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
+}
+
+/** Convert a diagnostic level option for deprecations into a consistent value. */
+export function diagnosticDeprecationLevel(
+  deprecations?: TypeScriptOptions['reportDeprecations'],
+): 'warn' | 'notice' | 'off' {
+  switch (deprecations) {
+    // If *warn* we report deprecations as warnings
+    case 'warn':
+      return 'warn'
+    // If *off* or *false* we don't report deprecations at all
+    case 'off':
+    case false:
+      return 'off'
+    // If *notice* or *true* (default) we report deprecations as notices
+    /* coverage ignore next */ case 'notice':
+    /* coverage ignore next */ case true:
+    default:
+      return 'notice'
+  }
+}
+
+/** Convert a emit only option into its corresponding enum value. */
+export function emitOnlyOption(emitOnly?: TypeScriptOptions['emitOnly']): EmitOnly | null {
+  switch (emitOnly) {
+    // If *none* or *false* we don't emit anything
+    case 'none':
+    case false:
+      return null // This is "none"
+    // If *js* we only emit JavaScript files
+    case 'js':
+      return EmitOnly.OnlyJs
+    // If *dts* we only emit declaration files
+    case 'dts':
+      return EmitOnly.OnlyDts
+    // In all other cases we emit all files
+    /* coverage ignore next */ case 'all':
+    /* coverage ignore next */ case true:
+    default:
+      return EmitOnly.All
+  }
+}

package/dist/projects.d.ts

@@ -1,72 +0,0 @@
-import type { ReportRecord } from '@plugjs/plug/logging';
-import type { AbsolutePath } from '@plugjs/plug/paths';
-import type { API, ParsedCommandLine } from 'typescript/unstable/async';
-/** Interface describing the actual (resolved) config file and its references */
-interface ProjectReferences {
-    /** The actual path of the configuration file containing the references */
-    path: AbsolutePath;
-    /** The actual configuration parsed from the configuration file */
-    config: ParsedCommandLine;
-    /** The actual paths of all configuration files referenced by this project */
-    references: AbsolutePath[];
-    /** Any errors encountered while reading the configuration file */
-    errors: ReportRecord[];
-}
-/** Interface describing a group of cross-referencing projects */
-interface Projects {
-    /** All projects to build, each associated with its referencing projects */
-    projects: Map<AbsolutePath, Set<AbsolutePath>>;
-    /** Any errors encountered while reading the configuration files */
-    errors: ReportRecord[];
-}
-/** Interface describing the order of projects, including any cycles and unresolved projects */
-interface ProjectOrder {
-    /** The order in which projects should be built */
-    order: AbsolutePath[];
-    /** Array of project reference cycles */
-    cycles: AbsolutePath[][];
-    /** Array containing all projects that could not be ordered because of cyclical dependencies */
-    unresolved: AbsolutePath[];
-    /** Any errors encountered while resolving the project order */
-    errors: ReportRecord[];
-}
-/**
- * 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 declare function findProjectConfig(path: AbsolutePath): AbsolutePath;
-/**
- * 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 declare function readProjectConfig(api: API, path: AbsolutePath): Promise<ProjectReferences>;
-/**
- * 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 declare function findProjectReferences(api: API, ...paths: AbsolutePath[]): Promise<Projects>;
-/**
- * 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 declare function resolveProjectOrder(projects: ReadonlyMap<AbsolutePath, Set<AbsolutePath>>): ProjectOrder;
-export {};
-//# sourceMappingURL=projects.d.ts.map

package/dist/projects.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAEvE,gFAAgF;AAChF,UAAU,iBAAiB;IACzB,0EAA0E;IAC1E,IAAI,EAAE,YAAY,CAAA;IAClB,kEAAkE;IAClE,MAAM,EAAE,iBAAiB,CAAA;IACzB,6EAA6E;IAC7E,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,kEAAkE;IAClE,MAAM,EAAE,YAAY,EAAE,CAAA;CACvB;AAED,iEAAiE;AACjE,UAAU,QAAQ;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAA;IAC9C,mEAAmE;IACnE,MAAM,EAAE,YAAY,EAAE,CAAA;CACvB;AAED,+FAA+F;AAC/F,UAAU,YAAY;IACpB,kDAAkD;IAClD,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,wCAAwC;IACxC,MAAM,EAAE,YAAY,EAAE,EAAE,CAAA;IACxB,+FAA+F;IAC/F,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,+DAA+D;IAC/D,MAAM,EAAE,YAAY,EAAE,CAAA;CACvB;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAOlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqChG;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkDjG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,YAAY,CA4FxG"}

package/dist/projects.js

@@ -1,209 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"projects.js","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAsC5D,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAkB;IAClD,sEAAsE;IACtE,wEAAwE;IACxE,IAAI,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,IAAI;QAAE,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IACpD,MAAM,CAAC,IAAI,EAAE,+CAA+C,IAAI,GAAG,CAAC,CAAA;IACpE,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAQ,EAAE,IAAkB;IAClE,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAEpC,0EAA0E;IAC1E,0EAA0E;IAC1E,uBAAuB;IACvB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnE,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACzC,MAAM,CAAC,OAAO,EAAE,2CAA2C,IAAI,GAAG,CAAC,CAAA;IACnE,kBAAkB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IAC1C,IAAI,GAAG,OAAO,CAAC,cAAc,CAAA,CAAC,iCAAiC;IAE/D,uEAAuE;IACvE,wEAAwE;IACxE,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpC,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE;QACtC,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE;QACvC,OAAO,CAAC,OAAO,CAAC,+BAA+B,EAAE;KAClD,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAEpC,mDAAmD;IACnD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAElF,uCAAuC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAA;IACxC,MAAM,MAAM,GAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;IAE1E,2CAA2C;IAC3C,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACzC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACvD,IAAI,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QACrD,IAAI,CAAC,QAAQ;YAAE,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;QACjF,IAAI,QAAQ;YAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAChD,CAAC;IAED,WAAW;IACX,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAQ,EAAE,GAAG,KAAqB;IAC5E,uEAAuE;IACvE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAe,KAAK,CAAC,CAAA;IACtD,kEAAkE;IAClE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAgB,CAAA;IAEhD,0EAA0E;IAC1E,kEAAkE;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmC,CAAA;IAE3D,2EAA2E;IAC3E,MAAM,MAAM,GAAmB,EAAE,CAAA;IAEjC,kFAAkF;IAClF,SAAS,UAAU,CAAC,eAA6B,EAAE,gBAA+B;QAChF,IAAI,iBAAiB,GAAG,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QACrD,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,iBAAiB,GAAG,IAAI,GAAG,EAAE,CAAA;YAC7B,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAA;QAClD,CAAC;QACD,IAAI,gBAAgB;YAAE,iBAAiB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,iBAAiB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAClC,0DAA0D;QAC1D,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAA;QACxD,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAEjC,yDAAyD;QACzD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC7E,+CAA+C;QAC/C,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAQ;QACxC,mEAAmE;QACnE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACjB,0DAA0D;QAC1D,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1B,+DAA+D;QAC/D,UAAU,CAAC,IAAI,CAAC,CAAA;QAEhB,qCAAqC;QACrC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,qEAAqE;YACrE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;YACtE,yEAAyE;YACzE,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAsD;IACxF,yDAAyD;IACzD,MAAM,MAAM,GAAiC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAEhE,4EAA4E;IAC5E,0DAA0D;IAC1D,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,4EAA4E;QAC5E,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACxC,6EAA6E;QAC7E,KAAK,MAAM,GAAG,IAAI,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IACnE,CAAC;IAED,gEAAgE;IAChE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,CAAA;IAErD,6EAA6E;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAEhE,oDAAoD;IACpD,MAAM,KAAK,GAAmB,EAAE,CAAA;IAEhC,2EAA2E;IAC3E,KAAK,IAAI,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QACnE,qCAAqC;QACrC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAEnB,0EAA0E;QAC1E,mEAAmE;QACnE,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,0BAA0B,CAAC,EAAE,EAAE,CAAC;YAC/E,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,SAAS,CAAE,GAAG,CAAC,CAAC,CAAA;YAC9D,IAAI,SAAS,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAE/D,yEAAyE;IACzE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAEjF,8EAA8E;IAE9E,qEAAqE;IACrE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAA;IAEvC,sEAAsE;IACtE,MAAM,MAAM,GAAqB,EAAE,CAAA;IAEnC,+DAA+D;IAC/D,SAAS,KAAK,CAAC,OAAqB,EAAE,KAAK,GAAmB,EAAE;QAC9D,mEAAmE;QACnE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;YAC7C,OAAM;QACR,CAAC;QAED,kEAAkE;QAClE,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAM;QAEhC,gEAAgE;QAChE,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,CAAA;QAChC,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,0BAA0B,CAAC,EAAE,EAAE,CAAC;YAC/E,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC5D,CAAC;QAED,2EAA2E;QAC3E,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACtB,CAAC;IAED,wDAAwD;IACxD,KAAK,MAAM,OAAO,IAAI,UAAU;QAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAEhD,kBAAkB;IAClB,MAAM,MAAM,GAAmB,EAAE,CAAA;IACjC,MAAM,CAAC,IAAI,CAAC;QACV,KAAK,EAAE,KAAK;QACZ,OAAO,EACL,SAAS,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU;YACtF,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;KACjE,CAAC,CAAA;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,6BAA6B,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;SAC3F,CAAC,CAAA;IACJ,CAAC;IAED,gEAAgE;IAChE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAC9C,CAAC"}

package/src/projects.ts

@@ -1,271 +0,0 @@
-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.ts'
-
-import type { ReportRecord } from '@plugjs/plug/logging'
-import type { AbsolutePath } from '@plugjs/plug/paths'
-import type { API, ParsedCommandLine } from 'typescript/unstable/async'
-
-/** Interface describing the actual (resolved) config file and its references */
-interface ProjectReferences {
-  /** The actual path of the configuration file containing the references */
-  path: AbsolutePath
-  /** The actual configuration parsed from the configuration file */
-  config: ParsedCommandLine
-  /** The actual paths of all configuration files referenced by this project */
-  references: AbsolutePath[]
-  /** Any errors encountered while reading the configuration file */
-  errors: ReportRecord[]
-}
-
-/** Interface describing a group of cross-referencing projects */
-interface Projects {
-  /** All projects to build, each associated with its referencing projects */
-  projects: Map<AbsolutePath, Set<AbsolutePath>>
-  /** Any errors encountered while reading the configuration files */
-  errors: ReportRecord[]
-}
-
-/** Interface describing the order of projects, including any cycles and unresolved projects */
-interface ProjectOrder {
-  /** The order in which projects should be built */
-  order: AbsolutePath[]
-  /** Array of project reference cycles */
-  cycles: AbsolutePath[][]
-  /** Array containing all projects that could not be ordered because of cyclical dependencies */
-  unresolved: AbsolutePath[]
-  /** Any errors encountered while resolving the project order */
-  errors: ReportRecord[]
-}
-
-/* ========================================================================== */
-
-/**
- * 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: AbsolutePath): AbsolutePath {
-  // 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: API, path: AbsolutePath): Promise<ProjectReferences> {
-  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: ProjectReferences = { 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: API, ...paths: AbsolutePath[]): Promise<Projects> {
-  // The set of *all* projects, whether we have resolved them yet or not.
-  const remainingProjects = new Set<AbsolutePath>(paths)
-  // The set of all *resolved* projects (that is, opened and parsed)
-  const resolvedProjects = new Set<AbsolutePath>()
-
-  // 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<AbsolutePath, Set<AbsolutePath>>()
-
-  // An array of all errors encountered while reading the configuration files
-  const errors: ReportRecord[] = []
-
-  // Add a referring project to the set of referring projects for a referred project
-  function addProject(referredProject: AbsolutePath, referringProject?: AbsolutePath): void {
-    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: ReadonlyMap<AbsolutePath, Set<AbsolutePath>>): ProjectOrder {
-  // The number of unresolved dependencies for each project
-  const counts: Record<AbsolutePath, number> = 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) as AbsolutePath[]
-
-  // 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: AbsolutePath[] = []
-
-  // 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<AbsolutePath>()
-
-  // The list of cycles we have found (each cycle is a list of projects)
-  const cycles: AbsolutePath[][] = []
-
-  // Recursively visit a project's dependents, looking for cycles
-  function visit(project: AbsolutePath, stack: AbsolutePath[] = []): void {
-    // 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: ReportRecord[] = []
-  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 }
-}