@graphty/algorithms 2.1.2 → 2.2.0

package/dist/src/indexed/eigenvector.d.ts

@@ -0,0 +1,48 @@
+import type { F32, F64, GraphSnapshot } from "@graphty/graph-format";
+/** Options of the index-based eigenvector centrality, matching the legacy `eigenvectorCentrality`. @public */
+export interface EigenvectorOptions {
+    /** Iteration cap; default 100. */
+    readonly maxIterations?: number | undefined;
+    /** Per-node tolerance: the run stops when the L1 change is below `n * tolerance`; default 1e-6. */
+    readonly tolerance?: number | undefined;
+    /** Rescale the unit-length vector to [0, 1] by min-max, as the legacy function does; default true. */
+    readonly normalized?: boolean | undefined;
+    /**
+     * On a directed snapshot, which arcs feed a node: `"in"` (default, as networkx) the nodes pointing
+     * at it, `"out"` the nodes it points at, `"total"` both. Ignored on an undirected snapshot.
+     */
+    readonly mode?: "in" | "out" | "total" | undefined;
+    /** Starting value per node index; default 1 for every node. */
+    readonly startVector?: F32 | F64 | undefined;
+}
+/** Result of the index-based eigenvector centrality. @public */
+export interface EigenvectorResult {
+    /** Score per node index. */
+    readonly scores: F64;
+    /** Iterations actually run; 0 when the relation has no cycle and every score is 0. */
+    readonly iterations: number;
+    /** Always true: a run that does not converge throws `ConvergenceError` instead. */
+    readonly converged: boolean;
+}
+/**
+ * Eigenvector centrality by power iteration on `(A + I)`, as networkx does: the identity shift
+ * leaves the eigenvectors alone and makes the largest eigenvalue the only one of largest magnitude,
+ * so a bipartite or periodic graph converges instead of oscillating. Each node's neighbours are
+ * counted once however many parallel edges join them, as in the legacy neighbour sets. When the
+ * relation has no cycle (no arcs, or a directed acyclic graph) its matrix is nilpotent and every
+ * score is exactly 0.
+ * @param s - The snapshot
+ * @param o - Algorithm options
+ * @returns The scores, the iteration count and the convergence flag
+ * @throws {ConvergenceError} When `maxIterations` passes do not meet the tolerance
+ * @public
+ */
+export declare function eigenvectorCentrality(s: GraphSnapshot, o?: EigenvectorOptions): EigenvectorResult;
+/**
+ * Rescale a score vector in place to [0, 1] by min-max, the legacy eigenvector rule: a flat vector
+ * becomes all 1, or all 0 when its maximum is not positive.
+ * @param x - The scores to rescale
+ * @internal
+ */
+export declare function minMaxRescale(x: F64): void;
+//# sourceMappingURL=eigenvector.d.ts.map

package/dist/src/indexed/eigenvector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eigenvector.d.ts","sourceRoot":"","sources":["../../../src/indexed/eigenvector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,EAAiB,MAAM,uBAAuB,CAAC;AAIpF,8GAA8G;AAC9G,MAAM,WAAW,kBAAkB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,mGAAmG;IACnG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,sGAAsG;IACtG,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;IACnD,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,SAAS,CAAC;CAChD;AAED,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,GAAE,kBAAuB,GAAG,iBAAiB,CAoDrG;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAY1C"}

package/dist/src/indexed/eigenvector.js

@@ -0,0 +1,162 @@
+import { ConvergenceError } from "../errors.js";
+/**
+ * Eigenvector centrality by power iteration on `(A + I)`, as networkx does: the identity shift
+ * leaves the eigenvectors alone and makes the largest eigenvalue the only one of largest magnitude,
+ * so a bipartite or periodic graph converges instead of oscillating. Each node's neighbours are
+ * counted once however many parallel edges join them, as in the legacy neighbour sets. When the
+ * relation has no cycle (no arcs, or a directed acyclic graph) its matrix is nilpotent and every
+ * score is exactly 0.
+ * @param s - The snapshot
+ * @param o - Algorithm options
+ * @returns The scores, the iteration count and the convergence flag
+ * @throws {ConvergenceError} When `maxIterations` passes do not meet the tolerance
+ * @public
+ */
+export function eigenvectorCentrality(s, o = {}) {
+    const n = s.nodeCount;
+    const maxIter = o.maxIterations ?? 100;
+    const tol = o.tolerance ?? 1e-6;
+    const start = o.startVector;
+    if (start !== undefined && start.length !== n) {
+        throw new Error(`eigenvectorCentrality: startVector has ${String(start.length)} entries for ${String(n)} nodes`);
+    }
+    let x = new Float64Array(n);
+    if (n === 0) {
+        return { scores: x, iterations: 0, converged: true };
+    }
+    const rel = feeders(s, o.mode ?? "in");
+    if (isAcyclic(rel, n)) {
+        return { scores: x, iterations: 0, converged: true };
+    }
+    // A node with nothing feeding it scores exactly 0 once the largest eigenvalue is positive.
+    for (let v = 0; v < n; v++) {
+        if (rel.rowPtr[v + 1] > rel.rowPtr[v]) {
+            x[v] = start === undefined ? 1 : start[v];
+        }
+    }
+    scaleToUnitLength(x);
+    let next = new Float64Array(n);
+    let it = 0;
+    let converged = false;
+    for (; it < maxIter && !converged; it++) {
+        for (let v = 0; v < n; v++) {
+            let sum = x[v];
+            const end = rel.rowPtr[v + 1];
+            for (let a = rel.rowPtr[v]; a < end; a++) {
+                sum += x[rel.colIdx[a]];
+            }
+            next[v] = sum;
+        }
+        scaleToUnitLength(next);
+        let change = 0;
+        for (let v = 0; v < n; v++) {
+            change += Math.abs(next[v] - x[v]);
+        }
+        [x, next] = [next, x];
+        converged = change < n * tol;
+    }
+    if (!converged) {
+        throw new ConvergenceError("eigenvectorCentrality", maxIter, tol);
+    }
+    if (o.normalized !== false) {
+        minMaxRescale(x);
+    }
+    return { scores: x, iterations: it, converged };
+}
+/**
+ * Rescale a score vector in place to [0, 1] by min-max, the legacy eigenvector rule: a flat vector
+ * becomes all 1, or all 0 when its maximum is not positive.
+ * @param x - The scores to rescale
+ * @internal
+ */
+export function minMaxRescale(x) {
+    let min = Infinity;
+    let max = 0;
+    for (const value of x) {
+        min = Math.min(min, value);
+        max = Math.max(max, value);
+    }
+    const range = max - min;
+    const flat = max > 0 ? 1 : 0;
+    for (let v = 0; v < x.length; v++) {
+        x[v] = range > 0 ? (x[v] - min) / range : flat;
+    }
+}
+/**
+ * The feeding relation as a CSR with each neighbour once per row. Snapshot rows are sorted, so a
+ * parallel arc is the previous entry repeated, and the `"total"` row is a merge of two sorted rows.
+ * @param s - The snapshot
+ * @param mode - Which arcs feed a node on a directed snapshot
+ * @returns Row pointers and neighbour indices
+ */
+function feeders(s, mode) {
+    const n = s.nodeCount;
+    const a = !s.directed || mode === "out" ? s : s.reverse();
+    // The second source of a "total" row; an empty row everywhere otherwise.
+    const total = s.directed && mode === "total";
+    const bRowPtr = total ? s.rowPtr : new Uint32Array(n + 1);
+    const bColIdx = total ? s.colIdx : new Uint32Array(0);
+    const rowPtr = new Uint32Array(n + 1);
+    const colIdx = new Uint32Array(a.colIdx.length + bColIdx.length);
+    let k = 0;
+    for (let v = 0; v < n; v++) {
+        let i = a.rowPtr[v];
+        const iEnd = a.rowPtr[v + 1];
+        let j = bRowPtr[v];
+        const jEnd = bRowPtr[v + 1];
+        const rowStart = k;
+        while (i < iEnd || j < jEnd) {
+            const u = j >= jEnd || (i < iEnd && a.colIdx[i] <= bColIdx[j]) ? a.colIdx[i++] : bColIdx[j++];
+            if (k === rowStart || colIdx[k - 1] !== u) {
+                colIdx[k++] = u;
+            }
+        }
+        rowPtr[v + 1] = k;
+    }
+    return { rowPtr, colIdx: colIdx.subarray(0, k) };
+}
+/**
+ * Whether the relation has no cycle (Kahn's algorithm), which makes its matrix nilpotent.
+ * @param rel - The relation
+ * @param n - The node count
+ * @returns True when every node peels off in topological order
+ */
+function isAcyclic(rel, n) {
+    const inDegree = new Uint32Array(n);
+    for (const u of rel.colIdx) {
+        inDegree[u]++;
+    }
+    const queue = new Uint32Array(n);
+    let tail = 0;
+    for (let v = 0; v < n; v++) {
+        if (inDegree[v] === 0) {
+            queue[tail++] = v;
+        }
+    }
+    for (let head = 0; head < tail; head++) {
+        const v = queue[head];
+        for (let a = rel.rowPtr[v]; a < rel.rowPtr[v + 1]; a++) {
+            if (--inDegree[rel.colIdx[a]] === 0) {
+                queue[tail++] = rel.colIdx[a];
+            }
+        }
+    }
+    return tail === n;
+}
+/**
+ * Scale a vector in place to unit Euclidean length; a zero vector is left alone.
+ * @param v - The vector
+ */
+function scaleToUnitLength(v) {
+    let norm = 0;
+    for (const value of v) {
+        norm += value * value;
+    }
+    norm = Math.sqrt(norm);
+    if (norm > 0) {
+        for (let i = 0; i < v.length; i++) {
+            v[i] /= norm;
+        }
+    }
+}
+//# sourceMappingURL=eigenvector.js.map

package/dist/src/indexed/eigenvector.js.map

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

package/dist/src/indexed/facade.d.ts

@@ -0,0 +1,109 @@
+/**
+ * The conversions a legacy function uses to delegate to its `indexed.*` port and keep its own
+ * signature and result shape (graph-format design 14.1 rule 1 and the 14.2 result table). Internal:
+ * nothing here is exported from the package, and nothing here takes a legacy `Graph` -- a facade
+ * gets its snapshot from `toSnapshot`, or from {@link fromAdjacencyMap} for a Map-of-Maps input.
+ * @module
+ */
+import { type F64, type GraphSnapshot, type NodeIdMap, type NodeMask, type NumericVector, type U32 } from "@graphty/graph-format";
+import type { Edge, NodeId, ShortestPathResult } from "../types/index.js";
+import type { SsspResult } from "./dijkstra.js";
+/**
+ * Resolve a legacy node argument to an index: the id itself first, then -- for a string only --
+ * its spelling, so `"5"` finds numeric id 5 the way the legacy string-typed parameters
+ * (flow `source` / `sink`, seed-label Maps) do today. A number never finds a string id: the
+ * legacy graph's `hasNode(5)` is false for a node `"5"`.
+ * @param ids - The snapshot's id map
+ * @param id - The caller's node argument
+ * @returns The node index, or `INVALID_INDEX` when absent; the facade throws its legacy message
+ */
+export declare function resolveNode(ids: NodeIdMap, id: NodeId): number;
+/**
+ * The per-arc `weights` override a weighted port needs to reproduce legacy f64 results exactly
+ * (design 14.1 rule 4). Undefined when the f32 arc weights are already exact, so the port reads
+ * its own arc array.
+ * @param s - The snapshot
+ * @returns arcCount f64 weights, or undefined
+ */
+export declare function exactArcWeights(s: GraphSnapshot): NumericVector | undefined;
+/**
+ * A traversal's visited nodes to the legacy tree (or predecessor) Map: node id to parent id, null for
+ * the start, in visit order -- the order a legacy walk set its entries in.
+ * @param ids - The snapshot's id map
+ * @param order - The visited node indices, in visit order
+ * @param parent - The parent of every node index, INVALID_INDEX for the start
+ * @returns The tree
+ */
+export declare function orderToTree(ids: NodeIdMap, order: U32, parent: U32): Map<NodeId, NodeId | null>;
+/**
+ * Per-node scores to the legacy `Record<string, number>` keyed by `String(id)`, in index order. A
+ * plain object, as the legacy functions return: `ids.toRecord` gives a null-prototype one, which a
+ * caller's `result.hasOwnProperty(id)` cannot call.
+ * @param ids - The snapshot's id map
+ * @param scores - One score per node index
+ * @returns The keyed scores
+ */
+export declare function scoresToRecord(ids: NodeIdMap, scores: ArrayLike<number>): Record<string, number>;
+/**
+ * Labels to the legacy `NodeId[][]` (components, communities): one group per label in label order,
+ * members in index order. A node labelled `INVALID_INDEX` belongs to no group.
+ * @param ids - The snapshot's id map
+ * @param labels - One label per node, in `[0, count)` or `INVALID_INDEX`
+ * @param count - The number of labels
+ * @returns The groups
+ */
+export declare function labelsToGroups(ids: NodeIdMap, labels: U32, count: number): NodeId[][];
+/**
+ * A node mask to the legacy `Set<string>` (`getKCore`, min-cut partitions), keyed by `String(id)`.
+ * @param ids - The snapshot's id map
+ * @param mask - A node mask over `ids.size` nodes
+ * @returns The included nodes' ids as strings
+ */
+export declare function maskToStringSet(ids: NodeIdMap, mask: NodeMask): Set<string>;
+/**
+ * An `SsspResult` to the legacy `Map<NodeId, ShortestPathResult>`: an entry per reached node in
+ * index order. Each entry gets its own copy of the predecessor Map over every node (null for the
+ * source and the unreached), as legacy `dijkstra` does, so a caller that mutates one entry's Map
+ * does not change the others. That copy is O(n) per reached node, the legacy cost.
+ *
+ * It matches only a legacy `dijkstra` call WITHOUT the `target` option. With `target`, legacy stops
+ * once the target is settled and reports tentative, not final, distances for the nodes it had not
+ * settled; the port has no early stop, so a facade must not route a `target` call through here.
+ * @param s - The snapshot the search ran on
+ * @param result - The port's result
+ * @returns The legacy result
+ */
+export declare function ssspToShortestPaths(s: GraphSnapshot, result: SsspResult): Map<NodeId, ShortestPathResult>;
+/**
+ * Logical edge indices to legacy `Edge` objects, in the given order, each in the orientation the
+ * snapshot stores (the declared one) with its exact f64 weight (1 on an unweighted snapshot). That
+ * is the orientation legacy `kruskalMST` reports. Legacy `primMST` reports tree edges in traversal
+ * orientation instead, so a Prim facade must orient its edges itself.
+ * @param s - The snapshot
+ * @param edges - Logical edge indices
+ * @returns `{ source, target, weight }` per edge
+ */
+export declare function edgesToLegacy(s: GraphSnapshot, edges: U32): Edge[];
+/**
+ * Per-edge scores to the legacy `Map<string, number>` keyed `"source-target"` (edge betweenness):
+ * every edge in declared orientation and edge order, then -- on an undirected snapshot -- every
+ * edge again reversed, with the same score, in edge order. Legacy `edgeBetweennessCentrality`
+ * returns both orientations of an undirected edge with equal values; it adds the reversed keys in
+ * the order its searches first cross them, which this converter does not reproduce.
+ * @param s - The snapshot
+ * @param scores - One score per logical edge
+ * @returns The keyed scores
+ */
+export declare function edgeScoresToPairMap(s: GraphSnapshot, scores: F64): Map<string, number>;
+/**
+ * A legacy Map-of-Maps adjacency (`astar`, `edmondsKarp`, `stoerWagner`, `kargerMinCut` inputs) to
+ * a DIRECTED snapshot: one arc per inner entry, weights kept exactly through the f64 shadow. Every
+ * key is a node in key order, then each target not already a key as it is first met. Not memoised:
+ * a Map has no mutation counter. The snapshot's `weights` view is f32 like every snapshot's, so a
+ * port reads rounded weights (0.1 + 0.2 comes back as 0.30000000447) unless the facade passes
+ * `{ weights: exactArcWeights(s) }`.
+ * @param adjacency - source id to (target id to weight)
+ * @returns The frozen snapshot
+ */
+export declare function fromAdjacencyMap(adjacency: ReadonlyMap<string, ReadonlyMap<string, number>>): GraphSnapshot;
+//# sourceMappingURL=facade.d.ts.map

package/dist/src/indexed/facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["../../../src/indexed/facade.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEH,KAAK,GAAG,EAER,KAAK,aAAa,EAGlB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,GAAG,EACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAM9D;AAiBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,CAG3E;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAM/F;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhG;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAQrF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAM3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAgBzG;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,EAAE,CAQlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAatF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,aAAa,CAW3G"}

package/dist/src/indexed/facade.js

@@ -0,0 +1,204 @@
+/**
+ * The conversions a legacy function uses to delegate to its `indexed.*` port and keep its own
+ * signature and result shape (graph-format design 14.1 rule 1 and the 14.2 result table). Internal:
+ * nothing here is exported from the package, and nothing here takes a legacy `Graph` -- a facade
+ * gets its snapshot from `toSnapshot`, or from {@link fromAdjacencyMap} for a Map-of-Maps input.
+ * @module
+ */
+import { expandEdges, GraphBuilder, INVALID_INDEX, maskToIndices, } from "@graphty/graph-format";
+/**
+ * Resolve a legacy node argument to an index: the id itself first, then -- for a string only --
+ * its spelling, so `"5"` finds numeric id 5 the way the legacy string-typed parameters
+ * (flow `source` / `sink`, seed-label Maps) do today. A number never finds a string id: the
+ * legacy graph's `hasNode(5)` is false for a node `"5"`.
+ * @param ids - The snapshot's id map
+ * @param id - The caller's node argument
+ * @returns The node index, or `INVALID_INDEX` when absent; the facade throws its legacy message
+ */
+export function resolveNode(ids, id) {
+    const index = ids.indexOf(id);
+    if (index !== INVALID_INDEX || typeof id !== "string") {
+        return index;
+    }
+    return ids.stringIndex().get(id) ?? INVALID_INDEX;
+}
+/**
+ * The snapshot's per-edge weights at full f64 precision: the role-`weight` f64 shadow column
+ * `toSnapshot` keeps when a legacy weight is not f32-exact, else the f32 per-edge weights (exact by
+ * definition then), else null for an unweighted snapshot.
+ * @param s - The snapshot
+ * @returns One weight per logical edge, or null
+ */
+function exactEdgeWeights(s) {
+    const shadow = s.edges.byRole("weight");
+    if (shadow?.dtype === "f64") {
+        return shadow.data;
+    }
+    return s.edgeList().weights;
+}
+/**
+ * The per-arc `weights` override a weighted port needs to reproduce legacy f64 results exactly
+ * (design 14.1 rule 4). Undefined when the f32 arc weights are already exact, so the port reads
+ * its own arc array.
+ * @param s - The snapshot
+ * @returns arcCount f64 weights, or undefined
+ */
+export function exactArcWeights(s) {
+    const shadow = s.edges.byRole("weight");
+    return shadow?.dtype === "f64" ? expandEdges(s, shadow.data) : undefined;
+}
+/**
+ * A traversal's visited nodes to the legacy tree (or predecessor) Map: node id to parent id, null for
+ * the start, in visit order -- the order a legacy walk set its entries in.
+ * @param ids - The snapshot's id map
+ * @param order - The visited node indices, in visit order
+ * @param parent - The parent of every node index, INVALID_INDEX for the start
+ * @returns The tree
+ */
+export function orderToTree(ids, order, parent) {
+    const tree = new Map();
+    for (const i of order) {
+        tree.set(ids.idOf(i), parent[i] === INVALID_INDEX ? null : ids.idOf(parent[i]));
+    }
+    return tree;
+}
+/**
+ * Per-node scores to the legacy `Record<string, number>` keyed by `String(id)`, in index order. A
+ * plain object, as the legacy functions return: `ids.toRecord` gives a null-prototype one, which a
+ * caller's `result.hasOwnProperty(id)` cannot call.
+ * @param ids - The snapshot's id map
+ * @param scores - One score per node index
+ * @returns The keyed scores
+ */
+export function scoresToRecord(ids, scores) {
+    const out = {};
+    for (let i = 0; i < ids.size; i++) {
+        out[String(ids.idOf(i))] = scores[i];
+    }
+    return out;
+}
+/**
+ * Labels to the legacy `NodeId[][]` (components, communities): one group per label in label order,
+ * members in index order. A node labelled `INVALID_INDEX` belongs to no group.
+ * @param ids - The snapshot's id map
+ * @param labels - One label per node, in `[0, count)` or `INVALID_INDEX`
+ * @param count - The number of labels
+ * @returns The groups
+ */
+export function labelsToGroups(ids, labels, count) {
+    const groups = Array.from({ length: count }, () => []);
+    for (let i = 0; i < labels.length; i++) {
+        if (labels[i] !== INVALID_INDEX) {
+            groups[labels[i]].push(ids.idOf(i));
+        }
+    }
+    return groups;
+}
+/**
+ * A node mask to the legacy `Set<string>` (`getKCore`, min-cut partitions), keyed by `String(id)`.
+ * @param ids - The snapshot's id map
+ * @param mask - A node mask over `ids.size` nodes
+ * @returns The included nodes' ids as strings
+ */
+export function maskToStringSet(ids, mask) {
+    const out = new Set();
+    for (const i of maskToIndices(mask, ids.size)) {
+        out.add(String(ids.idOf(i)));
+    }
+    return out;
+}
+/**
+ * An `SsspResult` to the legacy `Map<NodeId, ShortestPathResult>`: an entry per reached node in
+ * index order. Each entry gets its own copy of the predecessor Map over every node (null for the
+ * source and the unreached), as legacy `dijkstra` does, so a caller that mutates one entry's Map
+ * does not change the others. That copy is O(n) per reached node, the legacy cost.
+ *
+ * It matches only a legacy `dijkstra` call WITHOUT the `target` option. With `target`, legacy stops
+ * once the target is settled and reports tentative, not final, distances for the nodes it had not
+ * settled; the port has no early stop, so a facade must not route a `target` call through here.
+ * @param s - The snapshot the search ran on
+ * @param result - The port's result
+ * @returns The legacy result
+ */
+export function ssspToShortestPaths(s, result) {
+    const { ids } = s;
+    const predecessor = new Map();
+    for (let v = 0; v < s.nodeCount; v++) {
+        const arc = result.predArc[v];
+        predecessor.set(ids.idOf(v), arc === INVALID_INDEX ? null : ids.idOf(s.arcSource(arc)));
+    }
+    const out = new Map();
+    for (let v = 0; v < s.nodeCount; v++) {
+        const distance = result.dist[v];
+        if (distance < Infinity) {
+            const path = Array.from(result.pathTo(v), (i) => ids.idOf(i));
+            out.set(ids.idOf(v), { distance, path, predecessor: new Map(predecessor) });
+        }
+    }
+    return out;
+}
+/**
+ * Logical edge indices to legacy `Edge` objects, in the given order, each in the orientation the
+ * snapshot stores (the declared one) with its exact f64 weight (1 on an unweighted snapshot). That
+ * is the orientation legacy `kruskalMST` reports. Legacy `primMST` reports tree edges in traversal
+ * orientation instead, so a Prim facade must orient its edges itself.
+ * @param s - The snapshot
+ * @param edges - Logical edge indices
+ * @returns `{ source, target, weight }` per edge
+ */
+export function edgesToLegacy(s, edges) {
+    const { src, dst } = s.edgeList();
+    const weights = exactEdgeWeights(s);
+    return Array.from(edges, (e) => ({
+        source: s.ids.idOf(src[e]),
+        target: s.ids.idOf(dst[e]),
+        weight: weights === null ? 1 : weights[e],
+    }));
+}
+/**
+ * Per-edge scores to the legacy `Map<string, number>` keyed `"source-target"` (edge betweenness):
+ * every edge in declared orientation and edge order, then -- on an undirected snapshot -- every
+ * edge again reversed, with the same score, in edge order. Legacy `edgeBetweennessCentrality`
+ * returns both orientations of an undirected edge with equal values; it adds the reversed keys in
+ * the order its searches first cross them, which this converter does not reproduce.
+ * @param s - The snapshot
+ * @param scores - One score per logical edge
+ * @returns The keyed scores
+ */
+export function edgeScoresToPairMap(s, scores) {
+    const { src, dst } = s.edgeList();
+    const key = (from, to) => `${String(s.ids.idOf(from))}-${String(s.ids.idOf(to))}`;
+    const out = new Map();
+    for (let e = 0; e < s.edgeCount; e++) {
+        out.set(key(src[e], dst[e]), scores[e]);
+    }
+    if (!s.directed) {
+        for (let e = 0; e < s.edgeCount; e++) {
+            out.set(key(dst[e], src[e]), scores[e]);
+        }
+    }
+    return out;
+}
+/**
+ * A legacy Map-of-Maps adjacency (`astar`, `edmondsKarp`, `stoerWagner`, `kargerMinCut` inputs) to
+ * a DIRECTED snapshot: one arc per inner entry, weights kept exactly through the f64 shadow. Every
+ * key is a node in key order, then each target not already a key as it is first met. Not memoised:
+ * a Map has no mutation counter. The snapshot's `weights` view is f32 like every snapshot's, so a
+ * port reads rounded weights (0.1 + 0.2 comes back as 0.30000000447) unless the facade passes
+ * `{ weights: exactArcWeights(s) }`.
+ * @param adjacency - source id to (target id to weight)
+ * @returns The frozen snapshot
+ */
+export function fromAdjacencyMap(adjacency) {
+    const builder = new GraphBuilder({ directed: true, weightDtype: "f64" });
+    for (const id of adjacency.keys()) {
+        builder.addNode(id);
+    }
+    for (const [source, row] of adjacency) {
+        for (const [target, weight] of row) {
+            builder.addEdge(source, target, weight);
+        }
+    }
+    return builder.freeze({ label: "algorithms.fromAdjacencyMap" });
+}
+//# sourceMappingURL=facade.js.map

package/dist/src/indexed/facade.js.map

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