@graphty/algorithms 1.1.0 → 1.3.1

package/dist/src/optimized/csr-graph.js

@@ -0,0 +1,341 @@
+/**
+ * Compressed Sparse Row (CSR) graph representation
+ *
+ * Provides cache-efficient graph storage with sequential memory access patterns.
+ * Optimized for traversal operations and sparse graphs.
+ */
+export class CSRGraph {
+    constructor(adjacencyList, weights, buildReverse = true) {
+        this.data = this.buildCSR(adjacencyList, weights, buildReverse);
+    }
+    /**
+   * Build CSR structure from adjacency list
+   */
+    buildCSR(adjacencyList, weights, buildReverse = true) {
+        // Collect all unique nodes (both sources and targets)
+        const allNodes = new Set();
+        for (const [source, neighbors] of adjacencyList) {
+            allNodes.add(source);
+            for (const neighbor of neighbors) {
+                allNodes.add(neighbor);
+            }
+        }
+        // Sort nodes for consistent ordering. Numeric IDs sort numerically,
+        // string IDs sort lexicographically for predictable iteration order.
+        const nodes = Array.from(allNodes).sort((a, b) => {
+            if (typeof a === "number" && typeof b === "number") {
+                return a - b;
+            }
+            return String(a).localeCompare(String(b));
+        });
+        const nodeCount = nodes.length;
+        // Build node mappings
+        const nodeIdToIndex = new Map();
+        const indexToNodeId = [];
+        nodes.forEach((nodeId, index) => {
+            nodeIdToIndex.set(nodeId, index);
+            indexToNodeId[index] = nodeId;
+        });
+        // Count total edges
+        let edgeCount = 0;
+        for (const neighbors of adjacencyList.values()) {
+            edgeCount += neighbors.length;
+        }
+        // Allocate arrays
+        const rowPointers = new Uint32Array(nodeCount + 1);
+        const columnIndices = new Uint32Array(edgeCount);
+        const edgeWeights = weights ? new Float32Array(edgeCount) : undefined;
+        // Build CSR structure
+        let currentEdge = 0;
+        for (let i = 0; i < nodeCount; i++) {
+            rowPointers[i] = currentEdge;
+            const nodeId = indexToNodeId[i];
+            if (nodeId === undefined) {
+                throw new Error(`Invalid node index ${String(i)}`);
+            }
+            const neighbors = adjacencyList.get(nodeId) ?? [];
+            // Sort neighbors for better cache locality and binary search
+            const sortedNeighbors = neighbors
+                .map((n) => {
+                const index = nodeIdToIndex.get(n);
+                if (index === undefined) {
+                    throw new Error(`Node ${String(n)} not found in nodeIdToIndex map`);
+                }
+                return { id: n, index };
+            })
+                .sort((a, b) => a.index - b.index);
+            for (const neighbor of sortedNeighbors) {
+                columnIndices[currentEdge] = neighbor.index;
+                if (edgeWeights && weights) {
+                    const edgeKey = `${String(nodeId)}-${String(neighbor.id)}`;
+                    const weight = weights.get(edgeKey);
+                    if (weight !== undefined) {
+                        edgeWeights[currentEdge] = weight;
+                    }
+                    else {
+                        edgeWeights[currentEdge] = 1;
+                    }
+                }
+                currentEdge++;
+            }
+        }
+        rowPointers[nodeCount] = currentEdge;
+        const result = {
+            rowPointers,
+            columnIndices,
+            nodeIdToIndex,
+            indexToNodeId,
+        };
+        if (edgeWeights) {
+            result.edgeWeights = edgeWeights;
+        }
+        // Build reverse edges for bottom-up BFS
+        if (buildReverse) {
+            const reverseAdjacency = new Map();
+            for (let i = 0; i < nodeCount; i++) {
+                reverseAdjacency.set(i, []);
+            }
+            // Build reverse adjacency from forward edges
+            for (let i = 0; i < nodeCount; i++) {
+                const start = rowPointers[i];
+                const end = rowPointers[i + 1];
+                if (start !== undefined && end !== undefined) {
+                    for (let j = start; j < end; j++) {
+                        const target = columnIndices[j];
+                        if (target !== undefined) {
+                            reverseAdjacency.get(target)?.push(i);
+                        }
+                    }
+                }
+            }
+            // Build reverse CSR
+            const reverseRowPointers = new Uint32Array(nodeCount + 1);
+            const reverseColumnIndices = new Uint32Array(edgeCount);
+            let reverseEdge = 0;
+            for (let i = 0; i < nodeCount; i++) {
+                reverseRowPointers[i] = reverseEdge;
+                const incoming = reverseAdjacency.get(i) ?? [];
+                incoming.sort((a, b) => a - b);
+                for (const source of incoming) {
+                    reverseColumnIndices[reverseEdge++] = source;
+                }
+            }
+            reverseRowPointers[nodeCount] = reverseEdge;
+            result.reverseRowPointers = reverseRowPointers;
+            result.reverseColumnIndices = reverseColumnIndices;
+        }
+        return result;
+    }
+    // Core API methods
+    nodeCount() {
+        return this.data.indexToNodeId.length;
+    }
+    edgeCount() {
+        return this.data.columnIndices.length;
+    }
+    hasNode(nodeId) {
+        return this.data.nodeIdToIndex.has(nodeId);
+    }
+    hasEdge(source, target) {
+        const sourceIndex = this.data.nodeIdToIndex.get(source);
+        const targetIndex = this.data.nodeIdToIndex.get(target);
+        if (sourceIndex === undefined || targetIndex === undefined) {
+            return false;
+        }
+        const start = this.data.rowPointers[sourceIndex];
+        const end = this.data.rowPointers[sourceIndex + 1];
+        // Binary search for target in sorted neighbors
+        if (start === undefined || end === undefined) {
+            return false;
+        }
+        return this.binarySearch(this.data.columnIndices, targetIndex, start, end) !== -1;
+    }
+    /**
+   * Get neighbors as node IDs
+   */
+    neighbors(nodeId) {
+        const nodeIndex = this.data.nodeIdToIndex.get(nodeId);
+        if (nodeIndex === undefined) {
+            return new Set().values();
+        }
+        const start = this.data.rowPointers[nodeIndex];
+        const end = this.data.rowPointers[nodeIndex + 1];
+        const { columnIndices, indexToNodeId } = this.data;
+        function* generateNeighbors() {
+            if (start !== undefined && end !== undefined) {
+                for (let i = start; i < end; i++) {
+                    const idx = columnIndices[i];
+                    if (idx !== undefined) {
+                        const nodeId = indexToNodeId[idx];
+                        if (nodeId !== undefined) {
+                            yield nodeId;
+                        }
+                    }
+                }
+            }
+        }
+        return generateNeighbors();
+    }
+    /**
+   * Get all nodes
+   */
+    nodes() {
+        return this.data.indexToNodeId.values();
+    }
+    /**
+   * Get neighbors as indices (internal use)
+   */
+    getNeighborIndices(nodeIndex) {
+        if (nodeIndex < 0 || nodeIndex >= this.data.indexToNodeId.length) {
+            return [];
+        }
+        const start = this.data.rowPointers[nodeIndex];
+        const end = this.data.rowPointers[nodeIndex + 1];
+        if (start === undefined || end === undefined) {
+            return [];
+        }
+        return Array.from(this.data.columnIndices.subarray(start, end));
+    }
+    outDegree(nodeId) {
+        const nodeIndex = this.data.nodeIdToIndex.get(nodeId);
+        if (nodeIndex === undefined) {
+            return 0;
+        }
+        return this.outDegreeByIndex(nodeIndex);
+    }
+    /**
+   * Get out-degree by index (internal use)
+   */
+    outDegreeByIndex(nodeIndex) {
+        const start = this.data.rowPointers[nodeIndex];
+        const end = this.data.rowPointers[nodeIndex + 1];
+        if (start !== undefined && end !== undefined) {
+            return end - start;
+        }
+        return 0;
+    }
+    /**
+   * Iterator support for neighbor indices
+   */
+    *iterateNeighborIndices(nodeIndex) {
+        const start = this.data.rowPointers[nodeIndex];
+        const end = this.data.rowPointers[nodeIndex + 1];
+        if (start !== undefined && end !== undefined) {
+            for (let i = start; i < end; i++) {
+                const value = this.data.columnIndices[i];
+                if (value !== undefined) {
+                    yield value;
+                }
+            }
+        }
+    }
+    /**
+   * Iterator support for incoming neighbor indices (for bottom-up BFS)
+   */
+    *iterateIncomingNeighborIndices(nodeIndex) {
+        if (!this.data.reverseRowPointers || !this.data.reverseColumnIndices) {
+            return;
+        }
+        const start = this.data.reverseRowPointers[nodeIndex];
+        const end = this.data.reverseRowPointers[nodeIndex + 1];
+        if (start !== undefined && end !== undefined) {
+            for (let i = start; i < end; i++) {
+                const value = this.data.reverseColumnIndices[i];
+                if (value !== undefined) {
+                    yield value;
+                }
+            }
+        }
+    }
+    /**
+   * Convert node ID to index
+   */
+    nodeToIndex(nodeId) {
+        const index = this.data.nodeIdToIndex.get(nodeId);
+        if (index === undefined) {
+            throw new Error(`Node ${String(nodeId)} not found in graph`);
+        }
+        return index;
+    }
+    /**
+   * Convert index to node ID
+   */
+    indexToNodeId(index) {
+        const nodeId = this.data.indexToNodeId[index];
+        if (nodeId === undefined) {
+            throw new Error(`Index ${String(index)} out of bounds`);
+        }
+        return nodeId;
+    }
+    /**
+   * Get edge weight
+   */
+    getEdgeWeight(source, target) {
+        if (!this.data.edgeWeights) {
+            return undefined;
+        }
+        const sourceIndex = this.data.nodeIdToIndex.get(source);
+        const targetIndex = this.data.nodeIdToIndex.get(target);
+        if (sourceIndex === undefined || targetIndex === undefined) {
+            return undefined;
+        }
+        const start = this.data.rowPointers[sourceIndex];
+        const end = this.data.rowPointers[sourceIndex + 1];
+        if (start === undefined || end === undefined) {
+            return undefined;
+        }
+        const edgeIndex = this.binarySearch(this.data.columnIndices, targetIndex, start, end);
+        if (edgeIndex === -1) {
+            return undefined;
+        }
+        return this.data.edgeWeights[edgeIndex];
+    }
+    /**
+   * Binary search for target in sorted array
+   */
+    binarySearch(arr, target, start, end) {
+        let left = start;
+        let right = end - 1;
+        while (left <= right) {
+            const mid = (left + right) >>> 1;
+            const value = arr[mid];
+            if (value === undefined) {
+                return -1;
+            }
+            if (value === target) {
+                return mid;
+            }
+            if (value < target) {
+                left = mid + 1;
+            }
+            else {
+                right = mid - 1;
+            }
+        }
+        return -1;
+    }
+    /**
+   * Create CSR graph from standard Graph
+   */
+    static fromGraph(graph) {
+        const adjacencyList = new Map();
+        const weights = new Map();
+        // Build adjacency list
+        for (const node of graph.nodes()) {
+            const neighbors = [];
+            for (const neighbor of graph.neighbors(node.id)) {
+                neighbors.push(neighbor);
+                // Get edge weight if available
+                if (graph.getEdge) {
+                    const edge = graph.getEdge(node.id, neighbor);
+                    if (edge?.weight !== undefined) {
+                        weights.set(`${String(node.id)}-${String(neighbor)}`, edge.weight);
+                    }
+                }
+            }
+            adjacencyList.set(node.id, neighbors);
+        }
+        return new CSRGraph(adjacencyList, weights.size > 0 ? weights : undefined);
+    }
+}
+//# sourceMappingURL=csr-graph.js.map

package/dist/src/optimized/csr-graph.js.map

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

package/dist/src/optimized/direction-optimized-bfs.d.ts

@@ -0,0 +1,74 @@
+import type { NodeId } from "../types/index.js";
+import { CSRGraph } from "./csr-graph.js";
+/**
+ * Options for Direction-Optimized BFS
+ */
+export interface DirectionOptimizedBFSOptions {
+    alpha?: number;
+    beta?: number;
+}
+/**
+ * Result of BFS traversal
+ */
+export interface BFSResult<TNodeId> {
+    distances: Map<TNodeId, number>;
+    parents: Map<TNodeId, TNodeId | null>;
+    visitedCount: number;
+}
+/**
+ * Direction-Optimized Breadth-First Search
+ *
+ * Dynamically switches between top-down and bottom-up search strategies
+ * based on the size of the frontier. Particularly effective for low-diameter
+ * graphs like social networks.
+ *
+ * Based on: Beamer, S., Asanović, K., & Patterson, D. (2012).
+ * "Direction-optimizing breadth-first search." SC'12.
+ */
+export declare class DirectionOptimizedBFS<TNodeId = NodeId> {
+    private graph;
+    private alpha;
+    private beta;
+    private parent;
+    private frontier;
+    private nextFrontier;
+    private distances;
+    constructor(graph: CSRGraph<TNodeId>, options?: DirectionOptimizedBFSOptions);
+    /**
+   * Perform BFS from a single source
+   */
+    search(source: TNodeId): BFSResult<TNodeId>;
+    /**
+   * Top-down BFS step - explore from frontier
+   */
+    private topDownStep;
+    /**
+   * Bottom-up BFS step - check unvisited nodes
+   */
+    private bottomUpStep;
+    /**
+   * Calculate edges to check for switching heuristic
+   */
+    private calculateEdgesToCheck;
+    /**
+   * Build result map from internal data structures
+   */
+    private buildResult;
+    /**
+   * Perform multi-source BFS
+   */
+    searchMultiple(sources: TNodeId[]): BFSResult<TNodeId>;
+    /**
+   * Reset internal state for reuse
+   */
+    reset(): void;
+}
+/**
+ * Convenience function for single-source BFS
+ */
+export declare function directionOptimizedBFS<TNodeId = NodeId>(graph: CSRGraph<TNodeId>, source: TNodeId, options?: DirectionOptimizedBFSOptions): BFSResult<TNodeId>;
+/**
+ * Convenience function for multi-source BFS
+ */
+export declare function directionOptimizedBFSMultiple<TNodeId = NodeId>(graph: CSRGraph<TNodeId>, sources: TNodeId[], options?: DirectionOptimizedBFSOptions): BFSResult<TNodeId>;
+//# sourceMappingURL=direction-optimized-bfs.d.ts.map

package/dist/src/optimized/direction-optimized-bfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction-optimized-bfs.d.ts","sourceRoot":"","sources":["../../../src/optimized/direction-optimized-bfs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,OAAO;IAC9B,SAAS,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,qBAAqB,CAAC,OAAO,GAAG,MAAM;IAC/C,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;IAGrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,SAAS,CAAuB;gBAE5B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,4BAA4B;IAY5E;;KAEC;IACD,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;IAkD3C;;KAEC;IACD,OAAO,CAAC,WAAW;IAoBnB;;KAEC;IACD,OAAO,CAAC,YAAY;IAwBpB;;KAEC;IACD,OAAO,CAAC,qBAAqB;IAQ7B;;KAEC;IACD,OAAO,CAAC,WAAW;IA4BnB;;KAEC;IACD,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC;IAuDtD;;KAEC;IACD,KAAK,IAAI,IAAI;CAMhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAG,MAAM,EAClD,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,4BAA4B,GACvC,SAAS,CAAC,OAAO,CAAC,CAGpB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,GAAG,MAAM,EAC1D,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,CAAC,EAAE,4BAA4B,GACvC,SAAS,CAAC,OAAO,CAAC,CAGpB"}

package/dist/src/optimized/direction-optimized-bfs.js

@@ -0,0 +1,223 @@
+import { CompactDistanceArray, GraphBitSet } from "./bit-packed.js";
+/**
+ * Direction-Optimized Breadth-First Search
+ *
+ * Dynamically switches between top-down and bottom-up search strategies
+ * based on the size of the frontier. Particularly effective for low-diameter
+ * graphs like social networks.
+ *
+ * Based on: Beamer, S., Asanović, K., & Patterson, D. (2012).
+ * "Direction-optimizing breadth-first search." SC'12.
+ */
+export class DirectionOptimizedBFS {
+    constructor(graph, options) {
+        this.graph = graph;
+        this.alpha = options?.alpha ?? 15;
+        this.beta = options?.beta ?? 18;
+        const nodeCount = graph.nodeCount();
+        this.parent = new Int32Array(nodeCount).fill(-1);
+        this.frontier = new GraphBitSet(nodeCount);
+        this.nextFrontier = new GraphBitSet(nodeCount);
+        this.distances = new CompactDistanceArray(nodeCount);
+    }
+    /**
+   * Perform BFS from a single source
+   */
+    search(source) {
+        const sourceIndex = this.graph.nodeToIndex(source);
+        this.parent[sourceIndex] = -2; // Mark as source
+        this.frontier.add(sourceIndex);
+        this.distances.set(sourceIndex, 0);
+        // let currentDistance = 0; // Variable not used
+        // Initialize edgesToCheck to total edges to prevent immediate switch to bottom-up
+        let edgesToCheck = this.graph.edgeCount();
+        let scoutCount = 0; // Will be set after first top-down step
+        let awakeCount = 1; // Number of nodes in current frontier
+        let oldAwakeCount = 0;
+        // Direction tracking
+        let useBottomUp = false;
+        while (!this.frontier.isEmpty()) {
+            oldAwakeCount = awakeCount;
+            if (useBottomUp) {
+                // Check if we should switch back to top-down
+                if (awakeCount >= oldAwakeCount ||
+                    awakeCount > this.graph.nodeCount() / this.beta) {
+                    useBottomUp = false;
+                }
+            }
+            else {
+                // Check if we should switch to bottom-up
+                if (scoutCount > edgesToCheck / this.alpha) {
+                    useBottomUp = true;
+                }
+            }
+            if (useBottomUp) {
+                awakeCount = this.bottomUpStep();
+            }
+            else {
+                scoutCount = this.topDownStep();
+                awakeCount = this.nextFrontier.size();
+            }
+            // Swap frontiers
+            this.frontier.swap(this.nextFrontier);
+            this.nextFrontier.clear();
+            // currentDistance++; // Variable not used
+            edgesToCheck = this.calculateEdgesToCheck();
+        }
+        return this.buildResult();
+    }
+    /**
+   * Top-down BFS step - explore from frontier
+   */
+    topDownStep() {
+        let scoutCount = 0;
+        // Iterate through frontier nodes
+        for (const node of this.frontier) {
+            const currentDistance = this.distances.get(node);
+            for (const neighbor of this.graph.iterateNeighborIndices(node)) {
+                if (this.parent[neighbor] === -1) {
+                    this.parent[neighbor] = node;
+                    this.distances.set(neighbor, currentDistance + 1);
+                    this.nextFrontier.add(neighbor);
+                    scoutCount += this.graph.outDegreeByIndex(neighbor);
+                }
+            }
+        }
+        return scoutCount;
+    }
+    /**
+   * Bottom-up BFS step - check unvisited nodes
+   */
+    bottomUpStep() {
+        const nodeCount = this.graph.nodeCount();
+        let awakeCount = 0;
+        // Check all unvisited nodes
+        for (let node = 0; node < nodeCount; node++) {
+            if (this.parent[node] === -1) {
+                // Use incoming edges for bottom-up traversal
+                for (const neighbor of this.graph.iterateIncomingNeighborIndices(node)) {
+                    if (this.frontier.has(neighbor)) {
+                        this.parent[node] = neighbor;
+                        const neighborDist = this.distances.get(neighbor);
+                        this.distances.set(node, neighborDist + 1);
+                        this.nextFrontier.add(node);
+                        awakeCount++;
+                        break; // Found a parent, no need to check more
+                    }
+                }
+            }
+        }
+        return awakeCount;
+    }
+    /**
+   * Calculate edges to check for switching heuristic
+   */
+    calculateEdgesToCheck() {
+        let count = 0;
+        for (const node of this.frontier) {
+            count += this.graph.outDegreeByIndex(node);
+        }
+        return count;
+    }
+    /**
+   * Build result map from internal data structures
+   */
+    buildResult() {
+        const distances = new Map();
+        const parents = new Map();
+        let visitedCount = 0;
+        for (let i = 0; i < this.graph.nodeCount(); i++) {
+            if (this.parent[i] !== -1) {
+                const nodeId = this.graph.indexToNodeId(i);
+                distances.set(nodeId, this.distances.get(i));
+                if (this.parent[i] === -2) {
+                    // Source node
+                    parents.set(nodeId, null);
+                }
+                else {
+                    // Regular node with parent
+                    const parentIndex = this.parent[i];
+                    if (parentIndex !== undefined && parentIndex >= 0) {
+                        parents.set(nodeId, this.graph.indexToNodeId(parentIndex));
+                    }
+                }
+                visitedCount++;
+            }
+        }
+        return { distances, parents, visitedCount };
+    }
+    /**
+   * Perform multi-source BFS
+   */
+    searchMultiple(sources) {
+        // Initialize multiple sources
+        for (const source of sources) {
+            const sourceIndex = this.graph.nodeToIndex(source);
+            this.parent[sourceIndex] = -2; // Mark as source
+            this.frontier.add(sourceIndex);
+            this.distances.set(sourceIndex, 0);
+        }
+        // let currentDistance = 0; // Variable not used
+        let edgesToCheck = 0;
+        let scoutCount = 0;
+        // Calculate initial edges to check
+        for (const node of this.frontier) {
+            const degree = this.graph.outDegreeByIndex(node);
+            edgesToCheck += degree;
+            scoutCount += degree;
+        }
+        let awakeCount = sources.length;
+        let oldAwakeCount = 0;
+        let useBottomUp = false;
+        while (!this.frontier.isEmpty()) {
+            oldAwakeCount = awakeCount;
+            if (useBottomUp) {
+                if (awakeCount >= oldAwakeCount ||
+                    awakeCount > this.graph.nodeCount() / this.beta) {
+                    useBottomUp = false;
+                }
+            }
+            else {
+                if (scoutCount > edgesToCheck / this.alpha) {
+                    useBottomUp = true;
+                }
+            }
+            if (useBottomUp) {
+                awakeCount = this.bottomUpStep();
+            }
+            else {
+                scoutCount = this.topDownStep();
+                awakeCount = this.nextFrontier.size();
+            }
+            this.frontier.swap(this.nextFrontier);
+            this.nextFrontier.clear();
+            // currentDistance++; // Variable not used
+            edgesToCheck = this.calculateEdgesToCheck();
+        }
+        return this.buildResult();
+    }
+    /**
+   * Reset internal state for reuse
+   */
+    reset() {
+        this.parent.fill(-1);
+        this.frontier.clear();
+        this.nextFrontier.clear();
+        this.distances.clear();
+    }
+}
+/**
+ * Convenience function for single-source BFS
+ */
+export function directionOptimizedBFS(graph, source, options) {
+    const bfs = new DirectionOptimizedBFS(graph, options);
+    return bfs.search(source);
+}
+/**
+ * Convenience function for multi-source BFS
+ */
+export function directionOptimizedBFSMultiple(graph, sources, options) {
+    const bfs = new DirectionOptimizedBFS(graph, options);
+    return bfs.searchMultiple(sources);
+}
+//# sourceMappingURL=direction-optimized-bfs.js.map

package/dist/src/optimized/direction-optimized-bfs.js.map

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