@cplieger/deadset-ts 8.0.0-dev.2 → 8.0.0-dev.21

package/src/{graph.ts → liveness/graph.ts}

@@ -1,13 +1,14 @@
 /**
- * One project's declarations, the references between them and the roots that seed
- * reachability, indexed for the sweep. The graph reads no file and asks the compiler
- * nothing, so a sweep over it is a function of the values it was built from, and the
- * inventory's order is the order every set a sweep answers reads in.
+ * The run's declarations, the references every configuration makes between them and the
+ * roots that seed reachability, indexed for the sweep. The graph reads no file and asks the
+ * compiler nothing, so a sweep over it is a function of the values it was built from, and
+ * the inventory's order is the order every set a sweep answers reads in.
  */
 
-import type { InventorySymbol, SymbolKind } from "./inventory.ts";
-import type { Reference } from "./references.ts";
-import type { Root, RootKind } from "./roots.ts";
+import type { InventorySymbol, SymbolKind } from "../inventory.ts";
+import type { Reference } from "../references.ts";
+import { madeByTestCode } from "../tests/file-class.ts";
+import type { Root, RootKind } from "../roots/root-set.ts";
 
 /** The position of a declaration the inventory does not hold. */
 export const OUTSIDE = -1;
@@ -39,11 +40,11 @@ const SWEPT: Readonly<Record<SymbolKind, boolean>> = {
 
 /**
  * Whether a root of each kind names a caller, which holds it live under both relations: a
- * tool reads what it loads and what its strings name, a runtime runs a test, setup or
- * worker file, a page's module script, a command, a script or a workflow step, the manifest
- * names what enters the package, an alias global stands for its export, and an entry file,
- * a configured root and a pattern assert a caller. A library's published API only supposes
- * an unseen consumer, so it is live under reachability alone.
+ * tool reads what it loads and what its strings name, a runtime runs a test or setup
+ * file, a page's module script, a command, a script or a workflow step, the manifest
+ * names what enters the package, an alias global stands for its export, an outside
+ * declaration names a global interface merging into it, and an entry file, a configured root
+ * and a pattern assert a caller. A published API supposes a consumer: reachability alone.
  */
 const NAMES_A_CALLER: Readonly<Record<RootKind, boolean>> = {
   "entry-file": true,
@@ -56,14 +57,13 @@ const NAMES_A_CALLER: Readonly<Record<RootKind, boolean>> = {
   pattern: true,
   "type-error": true,
   "type-query-alias": true,
+  "global-augmentation": true,
   "configuration-file": true,
   "configuration-string": true,
+  "bundler-entry": true,
   "test-runner": true,
-  "browser-tests": true,
-  worker: true,
   "html-entry": true,
   "workflow-step": true,
-  "computed-import": true,
   "document-import": true,
 };
 
@@ -80,24 +80,40 @@ export function namesACaller(kind: RootKind): boolean {
 /** One reference as the sweep reads it: the declaration named, and whether a test file made it. */
 export interface Edge {
   readonly to: number;
+  /** The reference's place in {@link Graph.references}. */
+  readonly reference: number;
   readonly test: boolean;
+  /** Whether only the name answered, which counts at the sweep's guessed tier alone. */
+  readonly guessed: boolean;
   /**
    * Whether the reference evaluates the module whose file it names, which reaches the
    * module's top level and none of what it exports.
    */
   readonly evaluation: boolean;
+  /**
+   * Whether a loaded consumer made it, whose test references a mode may class as
+   * production. Only a consumed edge can be one.
+   */
+  readonly consumer: boolean;
 }
 
-/** How many references one declaration carries, split by the classification of the file that made each. */
-interface Counts {
+/**
+ * How many references one declaration carries, split by the classification of the file that
+ * made each; `consumerTest` counts the test references a loaded consumer's test files made,
+ * which a mode may class as production (`sweep.ts` `countedRefs`).
+ */
+export interface Counts {
   readonly production: number;
   readonly test: number;
+  readonly consumerTest: number;
 }
 
 /** One root the inventory holds, at the position of the declaration it names. */
-interface Rooted {
+export interface Rooted {
   readonly at: number;
   readonly kind: RootKind;
+  /** What names the root, as the root set spells it. */
+  readonly source: string;
 }
 
 /** The index the sweep and the component pass read. */
@@ -108,6 +124,12 @@ export interface Graph {
   readonly out: readonly (readonly Edge[])[];
   /** Per declaration, the references made to it, whoever made them. */
   readonly made: readonly Counts[];
+  /** Per declaration, those of {@link Graph.made} only a name answered. */
+  readonly guessedMade: readonly Counts[];
+  /** The references the graph was built from, in the order given. */
+  readonly references: readonly Reference[];
+  /** Per reference, the configurations that make it, in the run's order. */
+  readonly configurations: readonly (readonly string[])[];
   /** Per declaration, the position of its container, or {@link OUTSIDE} for a file. */
   readonly parent: readonly number[];
   /** Per declaration, whether a test file holds it. */
@@ -127,17 +149,44 @@ export interface Graph {
   /** Every root naming a declaration the inventory holds, in the order the root set gives them. */
   readonly rooted: readonly Rooted[];
   /**
-   * Every reference a loaded consumer or an unheld file makes to a declaration the
-   * inventory holds, in the order given. Such a file is a caller the analysis read, so the
-   * sweep holds what it names live under both relations and reaches on from there.
+   * Every reference a loaded consumer, an unheld file or a declaration no configuration
+   * judges makes to a declaration the inventory holds, in the order given. Such code is a
+   * caller the analysis read, so the sweep holds what it names live under both relations
+   * and reaches on from there.
    */
   readonly consumed: readonly Edge[];
   /** The position of the declaration one identifier names, or {@link OUTSIDE}. */
   at(id: string): number;
 }
 
+/** What the run says of a graph's references beyond the references themselves. */
+interface Sources {
+  /**
+   * The declarations a configuration holds only for their references, judged by none: each
+   * reference one makes enters as a consumer's does, since deleting what it names breaks
+   * that configuration's compile (matrix.5).
+   */
+  readonly unjudged?: ReadonlySet<string>;
+  /** Per reference, in the order given, the configurations that make it. */
+  readonly configurations?: readonly (readonly string[])[];
+}
+
+/** Adds one reference's count to the counts of the declaration it names. */
+function count(
+  counts: { production: number; test: number; consumerTest: number },
+  test: boolean,
+  consumer: boolean,
+): void {
+  if (test) {
+    counts.test += 1;
+    counts.consumerTest += consumer ? 1 : 0;
+  } else {
+    counts.production += 1;
+  }
+}
+
 /**
- * Indexes one project's inventory, references and roots. `testFiles` are the paths the
+ * Indexes the run's inventory, references and roots. `testFiles` are the paths the
  * reference pass classified as test files, so a declaration one holds is a test
  * declaration. A reference to a declaration the inventory does not hold is dropped; one
  * from such a declaration still counts toward its target, because reference counting
@@ -150,35 +199,48 @@ export function graphOf(
   testFiles: readonly string[],
   supportFiles: readonly string[] = [],
   ambient: ReadonlySet<string> = new Set(),
+  sources: Sources = {},
 ): Graph {
   const supports = new Set(supportFiles);
   const index = new Map(symbols.map((symbol, at) => [symbol.id, at]));
   const at = (id: string): number => index.get(id) ?? OUTSIDE;
   const tests = new Set(testFiles);
+  const unjudged = sources.unjudged ?? new Set<string>();
 
   const out: Edge[][] = symbols.map(() => []);
-  const made = symbols.map(() => ({ production: 0, test: 0 }));
+  const made = symbols.map(() => ({ production: 0, test: 0, consumerTest: 0 }));
+  const guessedMade = symbols.map(() => ({ production: 0, test: 0, consumerTest: 0 }));
   const consumed: Edge[] = [];
-  for (const reference of references) {
+  references.forEach((reference, place) => {
     const to = at(reference.to);
     if (to === OUTSIDE) {
-      continue;
+      return;
     }
+    const test = madeByTestCode(reference, supports);
+    const consumer = reference.consumer !== undefined;
+    const guessed = reference.guessed === true;
     const counts = made[to];
     if (counts !== undefined) {
-      if (reference.test) {
-        counts.test += 1;
-      } else {
-        counts.production += 1;
-      }
+      count(counts, test, consumer);
     }
-    const edge = { to, test: reference.test, evaluation: reference.use === "evaluation" };
-    if (reference.consumer !== undefined || reference.unheld === true) {
+    const guesses = guessedMade[to];
+    if (guessed && guesses !== undefined) {
+      count(guesses, test, consumer);
+    }
+    const edge = {
+      to,
+      reference: place,
+      test,
+      guessed,
+      evaluation: reference.use === "evaluation",
+      consumer,
+    };
+    if (consumer || reference.unheld === true || unjudged.has(reference.from)) {
       consumed.push(edge);
-      continue;
+      return;
     }
     out[at(reference.from)]?.push(edge);
-  }
+  });
 
   const parent = symbols.map((symbol) => at(symbol.parent));
   const exportsOf: number[][] = symbols.map(() => []);
@@ -193,7 +255,7 @@ export function graphOf(
   for (const root of roots) {
     const position = at(root.id);
     if (position !== OUTSIDE) {
-      rooted.push({ at: position, kind: root.kind });
+      rooted.push({ at: position, kind: root.kind, source: root.source });
     }
   }
 
@@ -201,6 +263,9 @@ export function graphOf(
     symbols,
     out,
     made,
+    guessedMade,
+    references,
+    configurations: sources.configurations ?? references.map(() => []),
     parent,
     test: symbols.map((symbol) => tests.has(symbol.position.path)),
     support: symbols.map((symbol) => supports.has(symbol.position.path)),

package/src/liveness/matrix.ts

@@ -0,0 +1,162 @@
+/**
+ * One run's projects as one matrix: every declaration any project judges, keyed by its
+ * position and carrying the configurations that hold it, and one graph over every
+ * configuration's references and roots, which the sweep judges once (matrix.4, matrix.5).
+ */
+
+import { graphOf, swept, type Graph } from "./graph.ts";
+import type { InventorySymbol } from "../inventory.ts";
+import { byPosition } from "../position.ts";
+import type { Reference } from "../references.ts";
+import type { Root } from "../roots/root-set.ts";
+
+/** What the passes answered for one configuration of the run. */
+export interface Configured {
+  /** The name discovery gives the configuration's project. */
+  readonly configuration: string;
+  readonly symbols: readonly InventorySymbol[];
+  readonly references: readonly Reference[];
+  readonly roots: readonly Root[];
+  /** The paths the reference pass classified as test files. */
+  readonly testFiles: readonly string[];
+  /** The paths of the test-support files, which only test code imports. */
+  readonly supportFiles?: readonly string[] | undefined;
+  /** The paths of the files only tests reach that are no test-support file. */
+  readonly testUsedFiles?: readonly string[] | undefined;
+  /** The ids of the ambient declarations, which describe code the target does not implement. */
+  readonly ambient?: ReadonlySet<string> | undefined;
+  /**
+   * The paths of the workspace-package files the configuration holds but does not
+   * compile itself. Their declarations count in its graph and its verdict on them is no
+   * finding.
+   */
+  readonly referenceOnly?: readonly string[] | undefined;
+  /** Each declaration's dependents, by id, as the configuration's inventory states them. */
+  readonly dependents?: ReadonlyMap<string, readonly string[]> | undefined;
+}
+
+/** The run's configurations, indexed for the sweep. */
+export interface Matrix {
+  /** The configurations, in the run's order. */
+  readonly configurations: readonly string[];
+  /**
+   * The graph over every configuration at once: every declaration a configuration
+   * holds in a file it does not hold only for its references, once per position and in
+   * site order, and every reference any configuration makes, a reference several
+   * configurations make at one position counted once and tagged with each of them.
+   */
+  readonly union: Graph;
+  /**
+   * Per declaration of {@link Matrix.union}, at its position there, the configurations
+   * whose project holds it, in the run's order.
+   */
+  readonly heldIn: readonly (readonly string[])[];
+  /**
+   * Per declaration of {@link Matrix.union}, whether a file only tests reach that is no
+   * test-support file holds it in some configuration: production code only tests use.
+   */
+  readonly testUsed: readonly boolean[];
+  /** Each declaration's dependents, by id, as the first configuration holding it states them. */
+  readonly dependents: ReadonlyMap<string, readonly string[]>;
+}
+
+/**
+ * What makes one reference one reference, whichever configuration made it. A consumer's
+ * position is rendered against its own root, so the consumer is part of what it names.
+ */
+export function referenceKey(reference: Reference): string {
+  const { path, line, column } = reference.position;
+  return [
+    reference.consumer ?? "",
+    reference.from,
+    reference.to,
+    path,
+    String(line),
+    String(column),
+    reference.use,
+  ].join("\u0000");
+}
+
+/**
+ * Indexes what the passes answered for each configuration of one run, in the run's order.
+ * A declaration is keyed by its rendered position, with the fields of the first
+ * configuration that judges it; one in a file every holder holds only for its references
+ * is judged by none and is not in the union, and a reference it makes enters the union as a
+ * consumer's does. One reference at one position of a file several configurations compile
+ * is one reference; two one configuration makes are two.
+ */
+export function matrixOf(per: readonly Configured[]): Matrix {
+  const symbols: InventorySymbol[] = [];
+  const holders = new Map<string, string[]>();
+  const references: Reference[] = [];
+  const makers: string[][] = [];
+  const firstSeen = new Map<string, { readonly index: number; readonly places: number[] }>();
+  const judged = new Set<string>();
+  const unjudged = new Set<string>();
+  const dependents = new Map<string, readonly string[]>();
+  per.forEach((one, index) => {
+    for (const [id, after] of one.dependents ?? []) {
+      if (!dependents.has(id)) {
+        dependents.set(id, after);
+      }
+    }
+    const referenceOnly = new Set(one.referenceOnly);
+    for (const symbol of one.symbols) {
+      const held = holders.get(symbol.id);
+      if (held === undefined) {
+        holders.set(symbol.id, [one.configuration]);
+      } else if (!held.includes(one.configuration)) {
+        held.push(one.configuration);
+      }
+      if (referenceOnly.has(symbol.position.path)) {
+        if (swept(symbol.kind)) {
+          unjudged.add(symbol.id);
+        }
+      } else if (!judged.has(symbol.id)) {
+        judged.add(symbol.id);
+        symbols.push(symbol);
+      }
+    }
+    for (const reference of one.references) {
+      const key = referenceKey(reference);
+      const seen = firstSeen.get(key);
+      if (seen !== undefined && seen.index !== index) {
+        for (const place of seen.places) {
+          const making = makers[place];
+          if (making !== undefined && !making.includes(one.configuration)) {
+            making.push(one.configuration);
+          }
+        }
+        continue;
+      }
+      const places = seen?.places ?? [];
+      if (seen === undefined) {
+        firstSeen.set(key, { index, places });
+      }
+      places.push(references.length);
+      references.push(reference);
+      makers.push([one.configuration]);
+    }
+  });
+  for (const id of judged) {
+    unjudged.delete(id);
+  }
+  symbols.sort((a, b) => byPosition(a.position, b.position));
+  const testUsed = new Set(per.flatMap((one) => one.testUsedFiles ?? []));
+
+  return {
+    configurations: per.map((one) => one.configuration),
+    union: graphOf(
+      symbols,
+      references,
+      per.flatMap((one) => one.roots),
+      [...new Set(per.flatMap((one) => one.testFiles))],
+      [...new Set(per.flatMap((one) => one.supportFiles ?? []))],
+      new Set(per.flatMap((one) => [...(one.ambient ?? [])])),
+      { unjudged, configurations: makers },
+    ),
+    heldIn: symbols.map((symbol) => holders.get(symbol.id) ?? []),
+    testUsed: symbols.map((symbol) => testUsed.has(symbol.position.path)),
+    dependents,
+  };
+}