wiki-graph-core 0.3.1 → 0.4.1

package/dist/graph/topology/snake/components.js

@@ -0,0 +1,80 @@
+import { compareNumber } from "./compare.js";
+import { attachChunkAdjacency } from "./graph.js";
+import { createBooleanRecord, createNumberListRecord } from "./records.js";
+function splitConnectedComponents(input) {
+  const sortedChunkIds = [...input.chunkIds].sort(compareNumber);
+  const chunkIdRecord = createBooleanRecord();
+  const adjacentChunkIdsByChunkId = createNumberListRecord();
+  const visitedChunkIds = createBooleanRecord();
+  const components = [];
+  for (const chunkId of sortedChunkIds) {
+    chunkIdRecord[String(chunkId)] = true;
+  }
+  for (const edge of input.edges) {
+    if (chunkIdRecord[String(edge.fromId)] !== true || chunkIdRecord[String(edge.toId)] !== true) {
+      continue;
+    }
+    attachChunkAdjacency(adjacentChunkIdsByChunkId, edge.fromId, edge.toId);
+    attachChunkAdjacency(adjacentChunkIdsByChunkId, edge.toId, edge.fromId);
+  }
+  for (const chunkId of sortedChunkIds) {
+    if (visitedChunkIds[String(chunkId)] === true) {
+      continue;
+    }
+    const stack = [chunkId];
+    const component = [];
+    visitedChunkIds[String(chunkId)] = true;
+    while (stack.length > 0) {
+      const currentChunkId = stack.pop();
+      if (currentChunkId === void 0) {
+        continue;
+      }
+      component.push(currentChunkId);
+      for (const nextChunkId of adjacentChunkIdsByChunkId[String(currentChunkId)] ?? []) {
+        if (visitedChunkIds[String(nextChunkId)] === true) {
+          continue;
+        }
+        visitedChunkIds[String(nextChunkId)] = true;
+        stack.push(nextChunkId);
+      }
+    }
+    component.sort(compareNumber);
+    components.push(component);
+  }
+  components.sort((left, right) => {
+    const leftMinChunkId = left[0] ?? Number.POSITIVE_INFINITY;
+    const rightMinChunkId = right[0] ?? Number.POSITIVE_INFINITY;
+    return leftMinChunkId - rightMinChunkId;
+  });
+  return components;
+}
+function isWeaklyConnected(graph) {
+  const firstChunkId = graph.sortedChunkIds[0];
+  if (firstChunkId === void 0) {
+    return true;
+  }
+  const visitedChunkIds = createBooleanRecord();
+  const stack = [firstChunkId];
+  visitedChunkIds[String(firstChunkId)] = true;
+  while (stack.length > 0) {
+    const currentChunkId = stack.pop();
+    if (currentChunkId === void 0) {
+      continue;
+    }
+    for (const nextChunkId of graph.undirectedAdjacentChunkIdsByChunkId[String(currentChunkId)] ?? []) {
+      if (visitedChunkIds[String(nextChunkId)] === true) {
+        continue;
+      }
+      visitedChunkIds[String(nextChunkId)] = true;
+      stack.push(nextChunkId);
+    }
+  }
+  return graph.sortedChunkIds.every(
+    (chunkId) => visitedChunkIds[String(chunkId)] === true
+  );
+}
+export {
+  isWeaklyConnected,
+  splitConnectedComponents
+};
+//# sourceMappingURL=components.js.map

package/dist/graph/topology/snake/components.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/graph/topology/snake/components.ts"],"sourcesContent":["import type { ReadingEdgeRecord } from \"../../../document/index.js\";\nimport { compareNumber } from \"./compare.js\";\nimport { attachChunkAdjacency } from \"./graph.js\";\nimport { createBooleanRecord, createNumberListRecord } from \"./records.js\";\n\nexport function splitConnectedComponents(input: {\n  chunkIds: readonly number[];\n  edges: readonly ReadingEdgeRecord[];\n}): number[][] {\n  const sortedChunkIds = [...input.chunkIds].sort(compareNumber);\n  const chunkIdRecord = createBooleanRecord();\n  const adjacentChunkIdsByChunkId = createNumberListRecord();\n  const visitedChunkIds = createBooleanRecord();\n  const components: number[][] = [];\n\n  for (const chunkId of sortedChunkIds) {\n    chunkIdRecord[String(chunkId)] = true;\n  }\n\n  for (const edge of input.edges) {\n    if (\n      chunkIdRecord[String(edge.fromId)] !== true ||\n      chunkIdRecord[String(edge.toId)] !== true\n    ) {\n      continue;\n    }\n\n    attachChunkAdjacency(adjacentChunkIdsByChunkId, edge.fromId, edge.toId);\n    attachChunkAdjacency(adjacentChunkIdsByChunkId, edge.toId, edge.fromId);\n  }\n\n  for (const chunkId of sortedChunkIds) {\n    if (visitedChunkIds[String(chunkId)] === true) {\n      continue;\n    }\n\n    const stack = [chunkId];\n    const component: number[] = [];\n    visitedChunkIds[String(chunkId)] = true;\n\n    while (stack.length > 0) {\n      const currentChunkId = stack.pop();\n\n      if (currentChunkId === undefined) {\n        continue;\n      }\n\n      component.push(currentChunkId);\n\n      for (const nextChunkId of adjacentChunkIdsByChunkId[\n        String(currentChunkId)\n      ] ?? []) {\n        if (visitedChunkIds[String(nextChunkId)] === true) {\n          continue;\n        }\n\n        visitedChunkIds[String(nextChunkId)] = true;\n        stack.push(nextChunkId);\n      }\n    }\n\n    component.sort(compareNumber);\n    components.push(component);\n  }\n\n  components.sort((left, right) => {\n    const leftMinChunkId = left[0] ?? Number.POSITIVE_INFINITY;\n    const rightMinChunkId = right[0] ?? Number.POSITIVE_INFINITY;\n\n    return leftMinChunkId - rightMinChunkId;\n  });\n\n  return components;\n}\n\nexport function isWeaklyConnected(graph: {\n  readonly sortedChunkIds: readonly number[];\n  readonly undirectedAdjacentChunkIdsByChunkId: Readonly<\n    Record<string, readonly number[] | undefined>\n  >;\n}): boolean {\n  const firstChunkId = graph.sortedChunkIds[0];\n\n  if (firstChunkId === undefined) {\n    return true;\n  }\n\n  const visitedChunkIds = createBooleanRecord();\n  const stack = [firstChunkId];\n\n  visitedChunkIds[String(firstChunkId)] = true;\n\n  while (stack.length > 0) {\n    const currentChunkId = stack.pop();\n\n    if (currentChunkId === undefined) {\n      continue;\n    }\n\n    for (const nextChunkId of graph.undirectedAdjacentChunkIdsByChunkId[\n      String(currentChunkId)\n    ] ?? []) {\n      if (visitedChunkIds[String(nextChunkId)] === true) {\n        continue;\n      }\n\n      visitedChunkIds[String(nextChunkId)] = true;\n      stack.push(nextChunkId);\n    }\n  }\n\n  return graph.sortedChunkIds.every(\n    (chunkId) => visitedChunkIds[String(chunkId)] === true,\n  );\n}\n"],"mappings":"AACA,SAAS,qBAAqB;AAC9B,SAAS,4BAA4B;AACrC,SAAS,qBAAqB,8BAA8B;AAErD,SAAS,yBAAyB,OAG1B;AACb,QAAM,iBAAiB,CAAC,GAAG,MAAM,QAAQ,EAAE,KAAK,aAAa;AAC7D,QAAM,gBAAgB,oBAAoB;AAC1C,QAAM,4BAA4B,uBAAuB;AACzD,QAAM,kBAAkB,oBAAoB;AAC5C,QAAM,aAAyB,CAAC;AAEhC,aAAW,WAAW,gBAAgB;AACpC,kBAAc,OAAO,OAAO,CAAC,IAAI;AAAA,EACnC;AAEA,aAAW,QAAQ,MAAM,OAAO;AAC9B,QACE,cAAc,OAAO,KAAK,MAAM,CAAC,MAAM,QACvC,cAAc,OAAO,KAAK,IAAI,CAAC,MAAM,MACrC;AACA;AAAA,IACF;AAEA,yBAAqB,2BAA2B,KAAK,QAAQ,KAAK,IAAI;AACtE,yBAAqB,2BAA2B,KAAK,MAAM,KAAK,MAAM;AAAA,EACxE;AAEA,aAAW,WAAW,gBAAgB;AACpC,QAAI,gBAAgB,OAAO,OAAO,CAAC,MAAM,MAAM;AAC7C;AAAA,IACF;AAEA,UAAM,QAAQ,CAAC,OAAO;AACtB,UAAM,YAAsB,CAAC;AAC7B,oBAAgB,OAAO,OAAO,CAAC,IAAI;AAEnC,WAAO,MAAM,SAAS,GAAG;AACvB,YAAM,iBAAiB,MAAM,IAAI;AAEjC,UAAI,mBAAmB,QAAW;AAChC;AAAA,MACF;AAEA,gBAAU,KAAK,cAAc;AAE7B,iBAAW,eAAe,0BACxB,OAAO,cAAc,CACvB,KAAK,CAAC,GAAG;AACP,YAAI,gBAAgB,OAAO,WAAW,CAAC,MAAM,MAAM;AACjD;AAAA,QACF;AAEA,wBAAgB,OAAO,WAAW,CAAC,IAAI;AACvC,cAAM,KAAK,WAAW;AAAA,MACxB;AAAA,IACF;AAEA,cAAU,KAAK,aAAa;AAC5B,eAAW,KAAK,SAAS;AAAA,EAC3B;AAEA,aAAW,KAAK,CAAC,MAAM,UAAU;AAC/B,UAAM,iBAAiB,KAAK,CAAC,KAAK,OAAO;AACzC,UAAM,kBAAkB,MAAM,CAAC,KAAK,OAAO;AAE3C,WAAO,iBAAiB;AAAA,EAC1B,CAAC;AAED,SAAO;AACT;AAEO,SAAS,kBAAkB,OAKtB;AACV,QAAM,eAAe,MAAM,eAAe,CAAC;AAE3C,MAAI,iBAAiB,QAAW;AAC9B,WAAO;AAAA,EACT;AAEA,QAAM,kBAAkB,oBAAoB;AAC5C,QAAM,QAAQ,CAAC,YAAY;AAE3B,kBAAgB,OAAO,YAAY,CAAC,IAAI;AAExC,SAAO,MAAM,SAAS,GAAG;AACvB,UAAM,iBAAiB,MAAM,IAAI;AAEjC,QAAI,mBAAmB,QAAW;AAChC;AAAA,IACF;AAEA,eAAW,eAAe,MAAM,oCAC9B,OAAO,cAAc,CACvB,KAAK,CAAC,GAAG;AACP,UAAI,gBAAgB,OAAO,WAAW,CAAC,MAAM,MAAM;AACjD;AAAA,MACF;AAEA,sBAAgB,OAAO,WAAW,CAAC,IAAI;AACvC,YAAM,KAAK,WAAW;AAAA,IACxB;AAAA,EACF;AAEA,SAAO,MAAM,eAAe;AAAA,IAC1B,CAAC,YAAY,gBAAgB,OAAO,OAAO,CAAC,MAAM;AAAA,EACpD;AACF;","names":[]}

package/dist/graph/topology/snake/constants.d.ts

@@ -0,0 +1,7 @@
+declare const ATTRIBUTE_BONUS_WEIGHT = 3;
+declare const DEFAULT_LINK_STRENGTH_WEIGHT = 1;
+declare const DEFAULT_SNAKE_WORDS_COUNT = 280;
+declare const DECAY_FACTOR = 0.75;
+declare const MIN_EDGE_WEIGHT = 0.1;
+
+export { ATTRIBUTE_BONUS_WEIGHT, DECAY_FACTOR, DEFAULT_LINK_STRENGTH_WEIGHT, DEFAULT_SNAKE_WORDS_COUNT, MIN_EDGE_WEIGHT };

package/dist/graph/topology/snake/constants.js

@@ -0,0 +1,13 @@
+const ATTRIBUTE_BONUS_WEIGHT = 3;
+const DEFAULT_LINK_STRENGTH_WEIGHT = 1;
+const DEFAULT_SNAKE_WORDS_COUNT = 280;
+const DECAY_FACTOR = 0.75;
+const MIN_EDGE_WEIGHT = 0.1;
+export {
+  ATTRIBUTE_BONUS_WEIGHT,
+  DECAY_FACTOR,
+  DEFAULT_LINK_STRENGTH_WEIGHT,
+  DEFAULT_SNAKE_WORDS_COUNT,
+  MIN_EDGE_WEIGHT
+};
+//# sourceMappingURL=constants.js.map

package/dist/graph/topology/snake/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/graph/topology/snake/constants.ts"],"sourcesContent":["export const ATTRIBUTE_BONUS_WEIGHT = 3;\nexport const DEFAULT_LINK_STRENGTH_WEIGHT = 1;\nexport const DEFAULT_SNAKE_WORDS_COUNT = 280;\nexport const DECAY_FACTOR = 0.75;\nexport const MIN_EDGE_WEIGHT = 0.1;\n"],"mappings":"AAAO,MAAM,yBAAyB;AAC/B,MAAM,+BAA+B;AACrC,MAAM,4BAA4B;AAClC,MAAM,eAAe;AACrB,MAAM,kBAAkB;","names":[]}

package/dist/graph/topology/snake/detect.d.ts

@@ -0,0 +1,9 @@
+import { ChunkRecord, ReadingEdgeRecord } from '../../../document/types.js';
+
+declare function detectSnakesInComponent(input: {
+    chunks: readonly ChunkRecord[];
+    edges: readonly ReadingEdgeRecord[];
+    snakeWordsCount?: number;
+}): number[][];
+
+export { detectSnakesInComponent };

package/dist/graph/topology/snake/detect.js

@@ -0,0 +1,63 @@
+import { isWeaklyConnected } from "./components.js";
+import { DEFAULT_SNAKE_WORDS_COUNT } from "./constants.js";
+import { compareChunkBySentence } from "./compare.js";
+import {
+  computeAllFingerprints,
+  validateFingerprints
+} from "./fingerprints.js";
+import { createDetectorGraph } from "./graph.js";
+import { greedyMerge } from "./merge.js";
+function detectSnakesInComponent(input) {
+  if (input.chunks.length === 0) {
+    return [];
+  }
+  const graph = createDetectorGraph(input.chunks, input.edges);
+  if (!isWeaklyConnected(graph)) {
+    throw new Error(
+      "Snake detector requires a weakly connected component input"
+    );
+  }
+  const snakeWordsCount = input.snakeWordsCount ?? DEFAULT_SNAKE_WORDS_COUNT;
+  const totalWordsCount = input.chunks.reduce((sum, chunk) => {
+    return sum + chunk.wordsCount;
+  }, 0);
+  if (totalWordsCount <= snakeWordsCount) {
+    return [
+      [...input.chunks].sort(compareChunkBySentence).map((chunk) => chunk.id)
+    ];
+  }
+  const fingerprints = computeAllFingerprints(graph);
+  validateFingerprints(fingerprints);
+  const phaseOneClusters = greedyMerge(
+    graph,
+    fingerprints,
+    {
+      enableBonus: true,
+      snakeWordsCount
+    },
+    void 0
+  );
+  const phaseTwoClusters = greedyMerge(
+    graph,
+    fingerprints,
+    {
+      enableBonus: false,
+      snakeWordsCount
+    },
+    phaseOneClusters
+  );
+  return [...phaseTwoClusters.values()].map(
+    (cluster) => [...cluster].sort((leftId, rightId) => {
+      const leftChunk = graph.chunksById[String(leftId)];
+      const rightChunk = graph.chunksById[String(rightId)];
+      if (leftChunk === void 0 || rightChunk === void 0) {
+        return leftId - rightId;
+      }
+      return compareChunkBySentence(leftChunk, rightChunk);
+    })
+  );
+}
+export {
+  detectSnakesInComponent
+};
+//# sourceMappingURL=detect.js.map

package/dist/graph/topology/snake/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/graph/topology/snake/detect.ts"],"sourcesContent":["import type {\n  ChunkRecord,\n  ReadingEdgeRecord,\n} from \"../../../document/index.js\";\nimport { isWeaklyConnected } from \"./components.js\";\nimport { DEFAULT_SNAKE_WORDS_COUNT } from \"./constants.js\";\nimport { compareChunkBySentence } from \"./compare.js\";\nimport {\n  computeAllFingerprints,\n  validateFingerprints,\n} from \"./fingerprints.js\";\nimport { createDetectorGraph } from \"./graph.js\";\nimport { greedyMerge } from \"./merge.js\";\n\nexport function detectSnakesInComponent(input: {\n  chunks: readonly ChunkRecord[];\n  edges: readonly ReadingEdgeRecord[];\n  snakeWordsCount?: number;\n}): number[][] {\n  if (input.chunks.length === 0) {\n    return [];\n  }\n\n  const graph = createDetectorGraph(input.chunks, input.edges);\n\n  if (!isWeaklyConnected(graph)) {\n    throw new Error(\n      \"Snake detector requires a weakly connected component input\",\n    );\n  }\n\n  const snakeWordsCount = input.snakeWordsCount ?? DEFAULT_SNAKE_WORDS_COUNT;\n  const totalWordsCount = input.chunks.reduce((sum, chunk) => {\n    return sum + chunk.wordsCount;\n  }, 0);\n\n  if (totalWordsCount <= snakeWordsCount) {\n    return [\n      [...input.chunks].sort(compareChunkBySentence).map((chunk) => chunk.id),\n    ];\n  }\n\n  const fingerprints = computeAllFingerprints(graph);\n\n  validateFingerprints(fingerprints);\n\n  const phaseOneClusters = greedyMerge(\n    graph,\n    fingerprints,\n    {\n      enableBonus: true,\n      snakeWordsCount,\n    },\n    undefined,\n  );\n  const phaseTwoClusters = greedyMerge(\n    graph,\n    fingerprints,\n    {\n      enableBonus: false,\n      snakeWordsCount,\n    },\n    phaseOneClusters,\n  );\n\n  return [...phaseTwoClusters.values()].map((cluster) =>\n    [...cluster].sort((leftId, rightId) => {\n      const leftChunk = graph.chunksById[String(leftId)];\n      const rightChunk = graph.chunksById[String(rightId)];\n\n      if (leftChunk === undefined || rightChunk === undefined) {\n        return leftId - rightId;\n      }\n\n      return compareChunkBySentence(leftChunk, rightChunk);\n    }),\n  );\n}\n"],"mappings":"AAIA,SAAS,yBAAyB;AAClC,SAAS,iCAAiC;AAC1C,SAAS,8BAA8B;AACvC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,2BAA2B;AACpC,SAAS,mBAAmB;AAErB,SAAS,wBAAwB,OAIzB;AACb,MAAI,MAAM,OAAO,WAAW,GAAG;AAC7B,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,QAAQ,oBAAoB,MAAM,QAAQ,MAAM,KAAK;AAE3D,MAAI,CAAC,kBAAkB,KAAK,GAAG;AAC7B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,kBAAkB,MAAM,mBAAmB;AACjD,QAAM,kBAAkB,MAAM,OAAO,OAAO,CAAC,KAAK,UAAU;AAC1D,WAAO,MAAM,MAAM;AAAA,EACrB,GAAG,CAAC;AAEJ,MAAI,mBAAmB,iBAAiB;AACtC,WAAO;AAAA,MACL,CAAC,GAAG,MAAM,MAAM,EAAE,KAAK,sBAAsB,EAAE,IAAI,CAAC,UAAU,MAAM,EAAE;AAAA,IACxE;AAAA,EACF;AAEA,QAAM,eAAe,uBAAuB,KAAK;AAEjD,uBAAqB,YAAY;AAEjC,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACA,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb;AAAA,IACF;AAAA,IACA;AAAA,EACF;AAEA,SAAO,CAAC,GAAG,iBAAiB,OAAO,CAAC,EAAE;AAAA,IAAI,CAAC,YACzC,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,QAAQ,YAAY;AACrC,YAAM,YAAY,MAAM,WAAW,OAAO,MAAM,CAAC;AACjD,YAAM,aAAa,MAAM,WAAW,OAAO,OAAO,CAAC;AAEnD,UAAI,cAAc,UAAa,eAAe,QAAW;AACvD,eAAO,SAAS;AAAA,MAClB;AAEA,aAAO,uBAAuB,WAAW,UAAU;AAAA,IACrD,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/graph/topology/snake/detector.d.ts

@@ -0,0 +1,3 @@
+export { detectSnakesInComponent } from './detect.js';
+export { splitConnectedComponents } from './components.js';
+import '../../../document/types.js';

package/dist/graph/topology/snake/detector.js

@@ -0,0 +1,7 @@
+import { detectSnakesInComponent } from "./detect.js";
+import { splitConnectedComponents } from "./components.js";
+export {
+  detectSnakesInComponent,
+  splitConnectedComponents
+};
+//# sourceMappingURL=detector.js.map

package/dist/graph/topology/snake/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/graph/topology/snake/detector.ts"],"sourcesContent":["export { detectSnakesInComponent } from \"./detect.js\";\nexport { splitConnectedComponents } from \"./components.js\";\n"],"mappings":"AAAA,SAAS,+BAA+B;AACxC,SAAS,gCAAgC;","names":[]}

package/dist/graph/topology/snake/fingerprints.d.ts

@@ -0,0 +1,7 @@
+import { DetectorGraph, Fingerprints } from './types.js';
+import '../../../document/types.js';
+
+declare function computeAllFingerprints(graph: DetectorGraph): Fingerprints;
+declare function validateFingerprints(fingerprints: Fingerprints): void;
+
+export { computeAllFingerprints, validateFingerprints };

package/dist/graph/topology/snake/fingerprints.js

@@ -0,0 +1,86 @@
+import { getReadingEdgeKey } from "../weights.js";
+import { DECAY_FACTOR, DEFAULT_LINK_STRENGTH_WEIGHT } from "./constants.js";
+import {
+  createBooleanRecord,
+  createNumberMatrixRecord,
+  createNumberRecord
+} from "./records.js";
+function computeAllFingerprints(graph) {
+  const fingerprints = createNumberMatrixRecord();
+  for (const startChunkId of graph.sortedChunkIds) {
+    const concentrations = createNumberRecord();
+    let currentLayer = [startChunkId];
+    const visitedChunkIds = createBooleanRecord();
+    concentrations[String(startChunkId)] = 1;
+    visitedChunkIds[String(startChunkId)] = true;
+    while (currentLayer.length > 0) {
+      const nextLayerConcentrations = createNumberRecord();
+      for (const currentChunkId of currentLayer) {
+        const currentConcentration = concentrations[String(currentChunkId)] ?? 0;
+        let totalWeight = 0;
+        const neighbors = [];
+        for (const edge of graph.incomingEdgesByChunkId[String(currentChunkId)] ?? []) {
+          if (visitedChunkIds[String(edge.fromId)] === true) {
+            continue;
+          }
+          const weight = graph.fingerprintEdgeWeightsByKey[getReadingEdgeKey(edge.fromId, currentChunkId)] ?? graph.fingerprintEdgeWeightsByKey[getReadingEdgeKey(currentChunkId, edge.fromId)] ?? DEFAULT_LINK_STRENGTH_WEIGHT;
+          neighbors.push([edge.fromId, weight]);
+          totalWeight += weight;
+        }
+        for (const edge of graph.outgoingEdgesByChunkId[String(currentChunkId)] ?? []) {
+          if (visitedChunkIds[String(edge.toId)] === true) {
+            continue;
+          }
+          const weight = graph.fingerprintEdgeWeightsByKey[getReadingEdgeKey(currentChunkId, edge.toId)] ?? graph.fingerprintEdgeWeightsByKey[getReadingEdgeKey(edge.toId, currentChunkId)] ?? DEFAULT_LINK_STRENGTH_WEIGHT;
+          neighbors.push([edge.toId, weight]);
+          totalWeight += weight;
+        }
+        if (totalWeight <= 0) {
+          continue;
+        }
+        for (const [neighborChunkId, weight] of neighbors) {
+          const contribution = currentConcentration * (weight / totalWeight) * DECAY_FACTOR;
+          nextLayerConcentrations[String(neighborChunkId)] = (nextLayerConcentrations[String(neighborChunkId)] ?? 0) + contribution;
+        }
+      }
+      currentLayer = Object.keys(nextLayerConcentrations).map(Number);
+      for (const nextChunkId of currentLayer) {
+        concentrations[String(nextChunkId)] = nextLayerConcentrations[String(nextChunkId)] ?? 0;
+        visitedChunkIds[String(nextChunkId)] = true;
+      }
+    }
+    const totalConcentration = Object.values(concentrations).reduce(
+      (sum, concentration) => sum + concentration,
+      0
+    );
+    if (totalConcentration > 0) {
+      for (const chunkId of Object.keys(concentrations)) {
+        concentrations[chunkId] = (concentrations[chunkId] ?? 0) / totalConcentration;
+      }
+    }
+    fingerprints[String(startChunkId)] = concentrations;
+  }
+  return fingerprints;
+}
+function validateFingerprints(fingerprints) {
+  const firstChunkId = Object.keys(fingerprints)[0];
+  if (firstChunkId === void 0) {
+    return;
+  }
+  const referenceChunkIds = Object.keys(
+    fingerprints[firstChunkId] ?? {}
+  ).sort();
+  for (const [chunkId, fingerprint] of Object.entries(fingerprints)) {
+    const fingerprintChunkIds = Object.keys(fingerprint).sort();
+    if (fingerprintChunkIds.length !== referenceChunkIds.length || fingerprintChunkIds.some(
+      (targetChunkId, index) => targetChunkId !== referenceChunkIds[index]
+    )) {
+      throw new Error(`Fingerprint structure mismatch for chunk ${chunkId}`);
+    }
+  }
+}
+export {
+  computeAllFingerprints,
+  validateFingerprints
+};
+//# sourceMappingURL=fingerprints.js.map

package/dist/graph/topology/snake/fingerprints.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/graph/topology/snake/fingerprints.ts"],"sourcesContent":["import { getReadingEdgeKey } from \"../weights.js\";\nimport { DECAY_FACTOR, DEFAULT_LINK_STRENGTH_WEIGHT } from \"./constants.js\";\nimport {\n  createBooleanRecord,\n  createNumberMatrixRecord,\n  createNumberRecord,\n} from \"./records.js\";\nimport type { DetectorGraph, Fingerprints } from \"./types.js\";\n\nexport function computeAllFingerprints(graph: DetectorGraph): Fingerprints {\n  const fingerprints = createNumberMatrixRecord();\n\n  for (const startChunkId of graph.sortedChunkIds) {\n    const concentrations = createNumberRecord();\n    let currentLayer = [startChunkId];\n    const visitedChunkIds = createBooleanRecord();\n\n    concentrations[String(startChunkId)] = 1;\n    visitedChunkIds[String(startChunkId)] = true;\n\n    while (currentLayer.length > 0) {\n      const nextLayerConcentrations = createNumberRecord();\n\n      for (const currentChunkId of currentLayer) {\n        const currentConcentration =\n          concentrations[String(currentChunkId)] ?? 0;\n        let totalWeight = 0;\n        const neighbors: Array<readonly [number, number]> = [];\n\n        for (const edge of graph.incomingEdgesByChunkId[\n          String(currentChunkId)\n        ] ?? []) {\n          if (visitedChunkIds[String(edge.fromId)] === true) {\n            continue;\n          }\n\n          const weight =\n            graph.fingerprintEdgeWeightsByKey[\n              getReadingEdgeKey(edge.fromId, currentChunkId)\n            ] ??\n            graph.fingerprintEdgeWeightsByKey[\n              getReadingEdgeKey(currentChunkId, edge.fromId)\n            ] ??\n            DEFAULT_LINK_STRENGTH_WEIGHT;\n\n          neighbors.push([edge.fromId, weight]);\n          totalWeight += weight;\n        }\n\n        for (const edge of graph.outgoingEdgesByChunkId[\n          String(currentChunkId)\n        ] ?? []) {\n          if (visitedChunkIds[String(edge.toId)] === true) {\n            continue;\n          }\n\n          const weight =\n            graph.fingerprintEdgeWeightsByKey[\n              getReadingEdgeKey(currentChunkId, edge.toId)\n            ] ??\n            graph.fingerprintEdgeWeightsByKey[\n              getReadingEdgeKey(edge.toId, currentChunkId)\n            ] ??\n            DEFAULT_LINK_STRENGTH_WEIGHT;\n\n          neighbors.push([edge.toId, weight]);\n          totalWeight += weight;\n        }\n\n        if (totalWeight <= 0) {\n          continue;\n        }\n\n        for (const [neighborChunkId, weight] of neighbors) {\n          const contribution =\n            currentConcentration * (weight / totalWeight) * DECAY_FACTOR;\n\n          nextLayerConcentrations[String(neighborChunkId)] =\n            (nextLayerConcentrations[String(neighborChunkId)] ?? 0) +\n            contribution;\n        }\n      }\n\n      currentLayer = Object.keys(nextLayerConcentrations).map(Number);\n\n      for (const nextChunkId of currentLayer) {\n        concentrations[String(nextChunkId)] =\n          nextLayerConcentrations[String(nextChunkId)] ?? 0;\n        visitedChunkIds[String(nextChunkId)] = true;\n      }\n    }\n\n    const totalConcentration = Object.values(concentrations).reduce(\n      (sum, concentration) => sum + concentration,\n      0,\n    );\n\n    if (totalConcentration > 0) {\n      for (const chunkId of Object.keys(concentrations)) {\n        concentrations[chunkId] =\n          (concentrations[chunkId] ?? 0) / totalConcentration;\n      }\n    }\n\n    fingerprints[String(startChunkId)] = concentrations;\n  }\n\n  return fingerprints;\n}\n\nexport function validateFingerprints(fingerprints: Fingerprints): void {\n  const firstChunkId = Object.keys(fingerprints)[0];\n\n  if (firstChunkId === undefined) {\n    return;\n  }\n\n  const referenceChunkIds = Object.keys(\n    fingerprints[firstChunkId] ?? {},\n  ).sort();\n\n  for (const [chunkId, fingerprint] of Object.entries(fingerprints)) {\n    const fingerprintChunkIds = Object.keys(fingerprint).sort();\n\n    if (\n      fingerprintChunkIds.length !== referenceChunkIds.length ||\n      fingerprintChunkIds.some(\n        (targetChunkId, index) => targetChunkId !== referenceChunkIds[index],\n      )\n    ) {\n      throw new Error(`Fingerprint structure mismatch for chunk ${chunkId}`);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/graph/topology/snake/graph-builder.d.ts

@@ -0,0 +1,14 @@
+import { ChunkRecord, ReadingEdgeRecord } from '../../../document/types.js';
+
+interface SnakeGraphEdge {
+    readonly fromSnakeIndex: number;
+    readonly toSnakeIndex: number;
+    readonly weight: number;
+}
+declare function buildSnakeGraph(input: {
+    chunksById: Readonly<Record<string, ChunkRecord | undefined>>;
+    edges: readonly ReadingEdgeRecord[];
+    snakes: readonly (readonly number[])[];
+}): SnakeGraphEdge[];
+
+export { type SnakeGraphEdge, buildSnakeGraph };

package/dist/graph/topology/snake/graph-builder.js

@@ -0,0 +1,76 @@
+import { getReadingEdgeKey } from "../weights.js";
+function buildSnakeGraph(input) {
+  const chunkIdToSnakeIndex = createOptionalNumberRecord();
+  const interSnakeWeightByKey = createNumberRecord();
+  for (const [snakeIndex, snakeChunkIds] of input.snakes.entries()) {
+    for (const chunkId of snakeChunkIds) {
+      chunkIdToSnakeIndex[String(chunkId)] = snakeIndex;
+    }
+  }
+  for (const edge of input.edges) {
+    const fromSnakeIndex = chunkIdToSnakeIndex[String(edge.fromId)];
+    const toSnakeIndex = chunkIdToSnakeIndex[String(edge.toId)];
+    if (fromSnakeIndex === void 0 || toSnakeIndex === void 0 || fromSnakeIndex === toSnakeIndex) {
+      continue;
+    }
+    const edgeKey = getReadingEdgeKey(fromSnakeIndex, toSnakeIndex);
+    interSnakeWeightByKey[edgeKey] = (interSnakeWeightByKey[edgeKey] ?? 0) + edge.weight;
+  }
+  const normalizedSnakeWeightByKey = createNumberRecord();
+  for (const [edgeKey, weight] of Object.entries(interSnakeWeightByKey)) {
+    const [fromSnakeIndexText = "", toSnakeIndexText = ""] = edgeKey.split(":");
+    const fromSnakeIndex = Number(fromSnakeIndexText);
+    const toSnakeIndex = Number(toSnakeIndexText);
+    const fromSnakeStartChunkId = input.snakes[fromSnakeIndex]?.[0];
+    const toSnakeStartChunkId = input.snakes[toSnakeIndex]?.[0];
+    if (fromSnakeStartChunkId === void 0 || toSnakeStartChunkId === void 0) {
+      continue;
+    }
+    const fromChunk = input.chunksById[String(fromSnakeStartChunkId)];
+    const toChunk = input.chunksById[String(toSnakeStartChunkId)];
+    if (fromChunk === void 0 || toChunk === void 0) {
+      continue;
+    }
+    const normalizedEdgeKey = compareChunkBySentence(fromChunk, toChunk) < 0 ? getReadingEdgeKey(fromSnakeIndex, toSnakeIndex) : getReadingEdgeKey(toSnakeIndex, fromSnakeIndex);
+    normalizedSnakeWeightByKey[normalizedEdgeKey] = (normalizedSnakeWeightByKey[normalizedEdgeKey] ?? 0) + weight;
+  }
+  return Object.keys(normalizedSnakeWeightByKey).sort(compareEdgeKey).map((edgeKey) => {
+    const [fromSnakeIndexText = "", toSnakeIndexText = ""] = edgeKey.split(":");
+    return {
+      fromSnakeIndex: Number(fromSnakeIndexText),
+      toSnakeIndex: Number(toSnakeIndexText),
+      weight: normalizedSnakeWeightByKey[edgeKey] ?? 0
+    };
+  });
+}
+function compareChunkBySentence(left, right) {
+  const [leftSerialId, leftSentenceIndex] = left.sentenceId;
+  const [rightSerialId, rightSentenceIndex] = right.sentenceId;
+  if (leftSerialId !== rightSerialId) {
+    return leftSerialId - rightSerialId;
+  }
+  if (leftSentenceIndex !== rightSentenceIndex) {
+    return leftSentenceIndex - rightSentenceIndex;
+  }
+  return left.id - right.id;
+}
+function compareEdgeKey(left, right) {
+  const [leftFromIdText = "", leftToIdText = ""] = left.split(":");
+  const [rightFromIdText = "", rightToIdText = ""] = right.split(":");
+  const leftFromId = Number(leftFromIdText);
+  const rightFromId = Number(rightFromIdText);
+  if (leftFromId !== rightFromId) {
+    return leftFromId - rightFromId;
+  }
+  return Number(leftToIdText) - Number(rightToIdText);
+}
+function createNumberRecord() {
+  return /* @__PURE__ */ Object.create(null);
+}
+function createOptionalNumberRecord() {
+  return /* @__PURE__ */ Object.create(null);
+}
+export {
+  buildSnakeGraph
+};
+//# sourceMappingURL=graph-builder.js.map

package/dist/graph/topology/snake/graph-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/graph/topology/snake/graph-builder.ts"],"sourcesContent":["import type {\n  ChunkRecord,\n  ReadingEdgeRecord,\n} from \"../../../document/index.js\";\nimport { getReadingEdgeKey } from \"../weights.js\";\n\nexport interface SnakeGraphEdge {\n  readonly fromSnakeIndex: number;\n  readonly toSnakeIndex: number;\n  readonly weight: number;\n}\n\nexport function buildSnakeGraph(input: {\n  chunksById: Readonly<Record<string, ChunkRecord | undefined>>;\n  edges: readonly ReadingEdgeRecord[];\n  snakes: readonly (readonly number[])[];\n}): SnakeGraphEdge[] {\n  const chunkIdToSnakeIndex = createOptionalNumberRecord();\n  const interSnakeWeightByKey = createNumberRecord();\n\n  for (const [snakeIndex, snakeChunkIds] of input.snakes.entries()) {\n    for (const chunkId of snakeChunkIds) {\n      chunkIdToSnakeIndex[String(chunkId)] = snakeIndex;\n    }\n  }\n\n  for (const edge of input.edges) {\n    const fromSnakeIndex = chunkIdToSnakeIndex[String(edge.fromId)];\n    const toSnakeIndex = chunkIdToSnakeIndex[String(edge.toId)];\n\n    if (\n      fromSnakeIndex === undefined ||\n      toSnakeIndex === undefined ||\n      fromSnakeIndex === toSnakeIndex\n    ) {\n      continue;\n    }\n\n    const edgeKey = getReadingEdgeKey(fromSnakeIndex, toSnakeIndex);\n\n    interSnakeWeightByKey[edgeKey] =\n      (interSnakeWeightByKey[edgeKey] ?? 0) + edge.weight;\n  }\n\n  const normalizedSnakeWeightByKey = createNumberRecord();\n\n  for (const [edgeKey, weight] of Object.entries(interSnakeWeightByKey)) {\n    const [fromSnakeIndexText = \"\", toSnakeIndexText = \"\"] = edgeKey.split(\":\");\n    const fromSnakeIndex = Number(fromSnakeIndexText);\n    const toSnakeIndex = Number(toSnakeIndexText);\n    const fromSnakeStartChunkId = input.snakes[fromSnakeIndex]?.[0];\n    const toSnakeStartChunkId = input.snakes[toSnakeIndex]?.[0];\n\n    if (\n      fromSnakeStartChunkId === undefined ||\n      toSnakeStartChunkId === undefined\n    ) {\n      continue;\n    }\n\n    const fromChunk = input.chunksById[String(fromSnakeStartChunkId)];\n    const toChunk = input.chunksById[String(toSnakeStartChunkId)];\n\n    if (fromChunk === undefined || toChunk === undefined) {\n      continue;\n    }\n\n    const normalizedEdgeKey =\n      compareChunkBySentence(fromChunk, toChunk) < 0\n        ? getReadingEdgeKey(fromSnakeIndex, toSnakeIndex)\n        : getReadingEdgeKey(toSnakeIndex, fromSnakeIndex);\n\n    normalizedSnakeWeightByKey[normalizedEdgeKey] =\n      (normalizedSnakeWeightByKey[normalizedEdgeKey] ?? 0) + weight;\n  }\n\n  return Object.keys(normalizedSnakeWeightByKey)\n    .sort(compareEdgeKey)\n    .map((edgeKey) => {\n      const [fromSnakeIndexText = \"\", toSnakeIndexText = \"\"] =\n        edgeKey.split(\":\");\n\n      return {\n        fromSnakeIndex: Number(fromSnakeIndexText),\n        toSnakeIndex: Number(toSnakeIndexText),\n        weight: normalizedSnakeWeightByKey[edgeKey] ?? 0,\n      };\n    });\n}\n\nfunction compareChunkBySentence(left: ChunkRecord, right: ChunkRecord): number {\n  const [leftSerialId, leftSentenceIndex] = left.sentenceId;\n  const [rightSerialId, rightSentenceIndex] = right.sentenceId;\n\n  if (leftSerialId !== rightSerialId) {\n    return leftSerialId - rightSerialId;\n  }\n\n  if (leftSentenceIndex !== rightSentenceIndex) {\n    return leftSentenceIndex - rightSentenceIndex;\n  }\n\n  return left.id - right.id;\n}\n\nfunction compareEdgeKey(left: string, right: string): number {\n  const [leftFromIdText = \"\", leftToIdText = \"\"] = left.split(\":\");\n  const [rightFromIdText = \"\", rightToIdText = \"\"] = right.split(\":\");\n  const leftFromId = Number(leftFromIdText);\n  const rightFromId = Number(rightFromIdText);\n\n  if (leftFromId !== rightFromId) {\n    return leftFromId - rightFromId;\n  }\n\n  return Number(leftToIdText) - Number(rightToIdText);\n}\n\nfunction createNumberRecord(): Record<string, number> {\n  return Object.create(null) as Record<string, number>;\n}\n\nfunction createOptionalNumberRecord(): Record<string, number | undefined> {\n  return Object.create(null) as Record<string, number | undefined>;\n}\n"],"mappings":"AAIA,SAAS,yBAAyB;AAQ3B,SAAS,gBAAgB,OAIX;AACnB,QAAM,sBAAsB,2BAA2B;AACvD,QAAM,wBAAwB,mBAAmB;AAEjD,aAAW,CAAC,YAAY,aAAa,KAAK,MAAM,OAAO,QAAQ,GAAG;AAChE,eAAW,WAAW,eAAe;AACnC,0BAAoB,OAAO,OAAO,CAAC,IAAI;AAAA,IACzC;AAAA,EACF;AAEA,aAAW,QAAQ,MAAM,OAAO;AAC9B,UAAM,iBAAiB,oBAAoB,OAAO,KAAK,MAAM,CAAC;AAC9D,UAAM,eAAe,oBAAoB,OAAO,KAAK,IAAI,CAAC;AAE1D,QACE,mBAAmB,UACnB,iBAAiB,UACjB,mBAAmB,cACnB;AACA;AAAA,IACF;AAEA,UAAM,UAAU,kBAAkB,gBAAgB,YAAY;AAE9D,0BAAsB,OAAO,KAC1B,sBAAsB,OAAO,KAAK,KAAK,KAAK;AAAA,EACjD;AAEA,QAAM,6BAA6B,mBAAmB;AAEtD,aAAW,CAAC,SAAS,MAAM,KAAK,OAAO,QAAQ,qBAAqB,GAAG;AACrE,UAAM,CAAC,qBAAqB,IAAI,mBAAmB,EAAE,IAAI,QAAQ,MAAM,GAAG;AAC1E,UAAM,iBAAiB,OAAO,kBAAkB;AAChD,UAAM,eAAe,OAAO,gBAAgB;AAC5C,UAAM,wBAAwB,MAAM,OAAO,cAAc,IAAI,CAAC;AAC9D,UAAM,sBAAsB,MAAM,OAAO,YAAY,IAAI,CAAC;AAE1D,QACE,0BAA0B,UAC1B,wBAAwB,QACxB;AACA;AAAA,IACF;AAEA,UAAM,YAAY,MAAM,WAAW,OAAO,qBAAqB,CAAC;AAChE,UAAM,UAAU,MAAM,WAAW,OAAO,mBAAmB,CAAC;AAE5D,QAAI,cAAc,UAAa,YAAY,QAAW;AACpD;AAAA,IACF;AAEA,UAAM,oBACJ,uBAAuB,WAAW,OAAO,IAAI,IACzC,kBAAkB,gBAAgB,YAAY,IAC9C,kBAAkB,cAAc,cAAc;AAEpD,+BAA2B,iBAAiB,KACzC,2BAA2B,iBAAiB,KAAK,KAAK;AAAA,EAC3D;AAEA,SAAO,OAAO,KAAK,0BAA0B,EAC1C,KAAK,cAAc,EACnB,IAAI,CAAC,YAAY;AAChB,UAAM,CAAC,qBAAqB,IAAI,mBAAmB,EAAE,IACnD,QAAQ,MAAM,GAAG;AAEnB,WAAO;AAAA,MACL,gBAAgB,OAAO,kBAAkB;AAAA,MACzC,cAAc,OAAO,gBAAgB;AAAA,MACrC,QAAQ,2BAA2B,OAAO,KAAK;AAAA,IACjD;AAAA,EACF,CAAC;AACL;AAEA,SAAS,uBAAuB,MAAmB,OAA4B;AAC7E,QAAM,CAAC,cAAc,iBAAiB,IAAI,KAAK;AAC/C,QAAM,CAAC,eAAe,kBAAkB,IAAI,MAAM;AAElD,MAAI,iBAAiB,eAAe;AAClC,WAAO,eAAe;AAAA,EACxB;AAEA,MAAI,sBAAsB,oBAAoB;AAC5C,WAAO,oBAAoB;AAAA,EAC7B;AAEA,SAAO,KAAK,KAAK,MAAM;AACzB;AAEA,SAAS,eAAe,MAAc,OAAuB;AAC3D,QAAM,CAAC,iBAAiB,IAAI,eAAe,EAAE,IAAI,KAAK,MAAM,GAAG;AAC/D,QAAM,CAAC,kBAAkB,IAAI,gBAAgB,EAAE,IAAI,MAAM,MAAM,GAAG;AAClE,QAAM,aAAa,OAAO,cAAc;AACxC,QAAM,cAAc,OAAO,eAAe;AAE1C,MAAI,eAAe,aAAa;AAC9B,WAAO,aAAa;AAAA,EACtB;AAEA,SAAO,OAAO,YAAY,IAAI,OAAO,aAAa;AACpD;AAEA,SAAS,qBAA6C;AACpD,SAAO,uBAAO,OAAO,IAAI;AAC3B;AAEA,SAAS,6BAAiE;AACxE,SAAO,uBAAO,OAAO,IAAI;AAC3B;","names":[]}

package/dist/graph/topology/snake/graph.d.ts

@@ -0,0 +1,7 @@
+import { ChunkRecord, ReadingEdgeRecord } from '../../../document/types.js';
+import { DetectorGraph } from './types.js';
+
+declare function attachChunkAdjacency(adjacentChunkIdsByChunkId: Record<string, number[] | undefined>, fromId: number, toId: number): void;
+declare function createDetectorGraph(chunks: readonly ChunkRecord[], edges: readonly ReadingEdgeRecord[]): DetectorGraph;
+
+export { attachChunkAdjacency, createDetectorGraph };

package/dist/graph/topology/snake/graph.js

@@ -0,0 +1,105 @@
+import { getReadingEdgeKey } from "../weights.js";
+import { MIN_EDGE_WEIGHT } from "./constants.js";
+import { compareNumber } from "./compare.js";
+import {
+  createChunkRecord,
+  createEdgeRecord,
+  createNumberListRecord,
+  createNumberRecord,
+  createReadingEdgeListRecord
+} from "./records.js";
+import { getLinkStrengthWeight } from "./weights.js";
+function attachChunkAdjacency(adjacentChunkIdsByChunkId, fromId, toId) {
+  const existingAdjacentChunkIds = adjacentChunkIdsByChunkId[String(fromId)] ?? [];
+  if (existingAdjacentChunkIds.includes(toId)) {
+    return;
+  }
+  adjacentChunkIdsByChunkId[String(fromId)] = [
+    ...existingAdjacentChunkIds,
+    toId
+  ];
+}
+function createDetectorGraph(chunks, edges) {
+  const chunksById = createChunkRecord();
+  const edgeByKey = createEdgeRecord();
+  const incomingEdgesByChunkId = createReadingEdgeListRecord();
+  const outgoingEdgesByChunkId = createReadingEdgeListRecord();
+  const sortedChunkIds = [...chunks].map((chunk) => chunk.id).sort(compareNumber);
+  const undirectedAdjacentChunkIdsByChunkId = createNumberListRecord();
+  for (const chunk of chunks) {
+    chunksById[String(chunk.id)] = chunk;
+  }
+  for (const edge of edges) {
+    if (chunksById[String(edge.fromId)] === void 0 || chunksById[String(edge.toId)] === void 0) {
+      continue;
+    }
+    const edgeKey = getReadingEdgeKey(edge.fromId, edge.toId);
+    edgeByKey[edgeKey] = edge;
+    if (incomingEdgesByChunkId[String(edge.toId)] === void 0) {
+      incomingEdgesByChunkId[String(edge.toId)] = [];
+    }
+    if (outgoingEdgesByChunkId[String(edge.fromId)] === void 0) {
+      outgoingEdgesByChunkId[String(edge.fromId)] = [];
+    }
+    incomingEdgesByChunkId[String(edge.toId)]?.push(edge);
+    outgoingEdgesByChunkId[String(edge.fromId)]?.push(edge);
+    attachChunkAdjacency(
+      undirectedAdjacentChunkIdsByChunkId,
+      edge.fromId,
+      edge.toId
+    );
+    attachChunkAdjacency(
+      undirectedAdjacentChunkIdsByChunkId,
+      edge.toId,
+      edge.fromId
+    );
+  }
+  return {
+    chunksById,
+    edgeByKey,
+    fingerprintEdgeWeightsByKey: computeFingerprintEdgeWeights(
+      chunksById,
+      edges
+    ),
+    incomingEdgesByChunkId,
+    outgoingEdgesByChunkId,
+    sortedChunkIds,
+    undirectedAdjacentChunkIdsByChunkId
+  };
+}
+function computeFingerprintEdgeWeights(chunksById, edges) {
+  const totalStrengthsByChunkId = createNumberRecord();
+  for (const edge of edges) {
+    if (chunksById[String(edge.fromId)] === void 0 || chunksById[String(edge.toId)] === void 0) {
+      continue;
+    }
+    const strengthWeight = getLinkStrengthWeight(edge.strength);
+    totalStrengthsByChunkId[String(edge.fromId)] = (totalStrengthsByChunkId[String(edge.fromId)] ?? 0) + strengthWeight;
+    totalStrengthsByChunkId[String(edge.toId)] = (totalStrengthsByChunkId[String(edge.toId)] ?? 0) + strengthWeight;
+  }
+  const edgeWeightsByKey = createNumberRecord();
+  for (const edge of edges) {
+    const fromChunk = chunksById[String(edge.fromId)];
+    const toChunk = chunksById[String(edge.toId)];
+    if (fromChunk === void 0 || toChunk === void 0) {
+      continue;
+    }
+    const strengthWeight = getLinkStrengthWeight(edge.strength);
+    const fromTotalStrength = totalStrengthsByChunkId[String(edge.fromId)] ?? 0;
+    const toTotalStrength = totalStrengthsByChunkId[String(edge.toId)] ?? 0;
+    const fromHalfWeight = fromTotalStrength === 0 ? 0 : fromChunk.weight * (strengthWeight / fromTotalStrength);
+    const toHalfWeight = toTotalStrength === 0 ? 0 : toChunk.weight * (strengthWeight / toTotalStrength);
+    const finalWeight = Math.max(
+      fromHalfWeight + toHalfWeight,
+      MIN_EDGE_WEIGHT
+    );
+    edgeWeightsByKey[getReadingEdgeKey(edge.fromId, edge.toId)] = finalWeight;
+    edgeWeightsByKey[getReadingEdgeKey(edge.toId, edge.fromId)] = finalWeight;
+  }
+  return edgeWeightsByKey;
+}
+export {
+  attachChunkAdjacency,
+  createDetectorGraph
+};
+//# sourceMappingURL=graph.js.map

package/dist/graph/topology/snake/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/graph/topology/snake/graph.ts"],"sourcesContent":["import type {\n  ChunkRecord,\n  ReadingEdgeRecord,\n} from \"../../../document/index.js\";\nimport { getReadingEdgeKey } from \"../weights.js\";\nimport { MIN_EDGE_WEIGHT } from \"./constants.js\";\nimport { compareNumber } from \"./compare.js\";\nimport {\n  createChunkRecord,\n  createEdgeRecord,\n  createNumberListRecord,\n  createNumberRecord,\n  createReadingEdgeListRecord,\n} from \"./records.js\";\nimport type { DetectorGraph } from \"./types.js\";\nimport { getLinkStrengthWeight } from \"./weights.js\";\n\nexport function attachChunkAdjacency(\n  adjacentChunkIdsByChunkId: Record<string, number[] | undefined>,\n  fromId: number,\n  toId: number,\n): void {\n  const existingAdjacentChunkIds =\n    adjacentChunkIdsByChunkId[String(fromId)] ?? [];\n\n  if (existingAdjacentChunkIds.includes(toId)) {\n    return;\n  }\n\n  adjacentChunkIdsByChunkId[String(fromId)] = [\n    ...existingAdjacentChunkIds,\n    toId,\n  ];\n}\n\nexport function createDetectorGraph(\n  chunks: readonly ChunkRecord[],\n  edges: readonly ReadingEdgeRecord[],\n): DetectorGraph {\n  const chunksById = createChunkRecord();\n  const edgeByKey = createEdgeRecord();\n  const incomingEdgesByChunkId = createReadingEdgeListRecord();\n  const outgoingEdgesByChunkId = createReadingEdgeListRecord();\n  const sortedChunkIds = [...chunks]\n    .map((chunk) => chunk.id)\n    .sort(compareNumber);\n  const undirectedAdjacentChunkIdsByChunkId = createNumberListRecord();\n\n  for (const chunk of chunks) {\n    chunksById[String(chunk.id)] = chunk;\n  }\n\n  for (const edge of edges) {\n    if (\n      chunksById[String(edge.fromId)] === undefined ||\n      chunksById[String(edge.toId)] === undefined\n    ) {\n      continue;\n    }\n\n    const edgeKey = getReadingEdgeKey(edge.fromId, edge.toId);\n\n    edgeByKey[edgeKey] = edge;\n    if (incomingEdgesByChunkId[String(edge.toId)] === undefined) {\n      incomingEdgesByChunkId[String(edge.toId)] = [];\n    }\n    if (outgoingEdgesByChunkId[String(edge.fromId)] === undefined) {\n      outgoingEdgesByChunkId[String(edge.fromId)] = [];\n    }\n\n    incomingEdgesByChunkId[String(edge.toId)]?.push(edge);\n    outgoingEdgesByChunkId[String(edge.fromId)]?.push(edge);\n    attachChunkAdjacency(\n      undirectedAdjacentChunkIdsByChunkId,\n      edge.fromId,\n      edge.toId,\n    );\n    attachChunkAdjacency(\n      undirectedAdjacentChunkIdsByChunkId,\n      edge.toId,\n      edge.fromId,\n    );\n  }\n\n  return {\n    chunksById,\n    edgeByKey,\n    fingerprintEdgeWeightsByKey: computeFingerprintEdgeWeights(\n      chunksById,\n      edges,\n    ),\n    incomingEdgesByChunkId,\n    outgoingEdgesByChunkId,\n    sortedChunkIds,\n    undirectedAdjacentChunkIdsByChunkId,\n  };\n}\n\nfunction computeFingerprintEdgeWeights(\n  chunksById: Readonly<Record<string, ChunkRecord | undefined>>,\n  edges: readonly ReadingEdgeRecord[],\n): Readonly<Record<string, number>> {\n  const totalStrengthsByChunkId = createNumberRecord();\n\n  for (const edge of edges) {\n    if (\n      chunksById[String(edge.fromId)] === undefined ||\n      chunksById[String(edge.toId)] === undefined\n    ) {\n      continue;\n    }\n\n    const strengthWeight = getLinkStrengthWeight(edge.strength);\n\n    totalStrengthsByChunkId[String(edge.fromId)] =\n      (totalStrengthsByChunkId[String(edge.fromId)] ?? 0) + strengthWeight;\n    totalStrengthsByChunkId[String(edge.toId)] =\n      (totalStrengthsByChunkId[String(edge.toId)] ?? 0) + strengthWeight;\n  }\n\n  const edgeWeightsByKey = createNumberRecord();\n\n  for (const edge of edges) {\n    const fromChunk = chunksById[String(edge.fromId)];\n    const toChunk = chunksById[String(edge.toId)];\n\n    if (fromChunk === undefined || toChunk === undefined) {\n      continue;\n    }\n\n    const strengthWeight = getLinkStrengthWeight(edge.strength);\n    const fromTotalStrength = totalStrengthsByChunkId[String(edge.fromId)] ?? 0;\n    const toTotalStrength = totalStrengthsByChunkId[String(edge.toId)] ?? 0;\n    const fromHalfWeight =\n      fromTotalStrength === 0\n        ? 0\n        : fromChunk.weight * (strengthWeight / fromTotalStrength);\n    const toHalfWeight =\n      toTotalStrength === 0\n        ? 0\n        : toChunk.weight * (strengthWeight / toTotalStrength);\n    const finalWeight = Math.max(\n      fromHalfWeight + toHalfWeight,\n      MIN_EDGE_WEIGHT,\n    );\n\n    edgeWeightsByKey[getReadingEdgeKey(edge.fromId, edge.toId)] = finalWeight;\n    edgeWeightsByKey[getReadingEdgeKey(edge.toId, edge.fromId)] = finalWeight;\n  }\n\n  return edgeWeightsByKey;\n}\n"],"mappings":"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","names":[]}

package/dist/graph/topology/snake/index.d.ts

@@ -0,0 +1,4 @@
+export { detectSnakesInComponent } from './detect.js';
+export { splitConnectedComponents } from './components.js';
+export { SnakeGraphEdge, buildSnakeGraph } from './graph-builder.js';
+import '../../../document/types.js';

package/dist/graph/topology/snake/index.js

@@ -0,0 +1,3 @@
+export * from "./detector.js";
+export * from "./graph-builder.js";
+//# sourceMappingURL=index.js.map

package/dist/graph/topology/snake/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/graph/topology/snake/index.ts"],"sourcesContent":["export * from \"./detector.js\";\nexport * from \"./graph-builder.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}

package/dist/graph/topology/snake/merge.d.ts

@@ -0,0 +1,6 @@
+import { DetectorGraph, Fingerprints, MergeConfig } from './types.js';
+import '../../../document/types.js';
+
+declare function greedyMerge(graph: DetectorGraph, fingerprints: Fingerprints, config: MergeConfig, initialClusters: ReadonlyMap<number, readonly number[]> | undefined): Map<number, number[]>;
+
+export { greedyMerge };