wiki-graph-core 0.3.1 → 0.4.0

package/dist/retrieval/query/archive-view/references.js

@@ -0,0 +1,287 @@
+import {
+  parseWikiGraphUriSyntax,
+  WIKI_GRAPH_URI_PREFIX
+} from "../../../runtime/common/wiki-graph/uri.js";
+import {
+  isWikiGraphObjectUri,
+  normalizeWikiGraphObjectUri
+} from "./helpers.js";
+function formatChapterId(chapterId) {
+  return `chapter:${chapterId}`;
+}
+function formatChapterTitleId(chapterId) {
+  return `chapter-title:${chapterId}`;
+}
+function formatEdgeId(edge) {
+  return `edge:${edge.fromId}->${edge.toId}`;
+}
+function formatNodeId(nodeId) {
+  return `node:${nodeId}`;
+}
+function formatSummaryId(chapterId) {
+  return `summary:${chapterId}`;
+}
+function formatFragmentId(serialId, fragmentId) {
+  return `fragment:${serialId}:${fragmentId}`;
+}
+function formatTextStreamRangeUri(chapterPath, stream, startSentenceIndex, endSentenceIndex) {
+  const startSentenceNumber = startSentenceIndex + 1;
+  const endSentenceNumber = endSentenceIndex + 1;
+  const hash = startSentenceIndex === endSentenceIndex ? String(startSentenceNumber) : `${startSentenceNumber}..${endSentenceNumber}`;
+  return `wikg://chapter/${chapterPath}/${stream}#${hash}`;
+}
+function parseWikiGraphReference(uri) {
+  uri = normalizeWikiGraphObjectUri(uri);
+  if (!isWikiGraphObjectUri(uri)) {
+    const archiveReference = parseArchiveReference(uri);
+    switch (archiveReference.type) {
+      case "node":
+        return { id: archiveReference.id, type: "chunk" };
+      case "chapter":
+        return { chapterId: archiveReference.id, type: "chapter" };
+      case "chapter-title":
+        return { chapterId: archiveReference.id, type: "chapter-title" };
+      case "summary":
+        return {
+          chapterId: archiveReference.id,
+          endSentenceIndex: Number.POSITIVE_INFINITY,
+          stream: "summary",
+          startSentenceIndex: 0,
+          type: "text-stream"
+        };
+      case "fragment":
+      case "meta":
+        throw new Error(`Evidence is not available for ${uri}.`);
+    }
+  }
+  if (uri === WIKI_GRAPH_URI_PREFIX) {
+    return { type: "meta" };
+  }
+  const parsedUri = parseWikiGraphUriSyntax(uri);
+  if (parsedUri.protocol !== "wikg") {
+    throw new Error(`Invalid Wiki Graph URI: ${uri}`);
+  }
+  const pathParts = parsedUri.path;
+  const hash = formatParsedFragment(parsedUri.fragment);
+  if (pathParts.length === 0) {
+    return { type: "meta" };
+  }
+  if (pathParts[0] === "chapter-tree" && pathParts.length === 1) {
+    return { type: "chapter-tree" };
+  }
+  switch (pathParts[0]) {
+    case "chapter":
+      if (pathParts.length === 2) {
+        return {
+          chapterId: parsePositiveInteger(pathParts[1], uri),
+          type: "chapter"
+        };
+      }
+      if (pathParts[1] !== void 0) {
+        const chapterId = parsePositiveInteger(pathParts[1], uri);
+        switch (pathParts[2]) {
+          case "state":
+            if (pathParts.length === 3) {
+              return { chapterId, type: "chapter-state" };
+            }
+            if (pathParts.length === 4) {
+              return {
+                chapterId,
+                target: parseChapterStateTarget(pathParts[3], uri),
+                type: "chapter-state"
+              };
+            }
+            break;
+          case "title":
+            if (pathParts.length === 3) {
+              return { chapterId, type: "chapter-title" };
+            }
+            break;
+          case "chunk":
+            if (pathParts.length === 4) {
+              return {
+                chapterId,
+                id: parsePositiveInteger(pathParts[3], uri),
+                type: "chunk"
+              };
+            }
+            break;
+          case "entity":
+            if (pathParts.length === 4) {
+              return {
+                chapterId,
+                qid: parseQid(pathParts[3], uri),
+                type: "entity"
+              };
+            }
+            break;
+          case "source":
+            if (pathParts.length === 3) {
+              const [start, end] = parseSentenceRange(hash);
+              return {
+                chapterId,
+                endSentenceIndex: end,
+                stream: "source",
+                startSentenceIndex: start,
+                type: "text-stream"
+              };
+            }
+            break;
+          case "summary":
+            if (pathParts.length === 3) {
+              const [start, end] = parseSentenceRange(hash);
+              return {
+                chapterId,
+                endSentenceIndex: end,
+                stream: "summary",
+                startSentenceIndex: start,
+                type: "text-stream"
+              };
+            }
+            break;
+          case "tree":
+            if (pathParts.length === 3) {
+              return { chapterId, type: "chapter" };
+            }
+            break;
+          case "triple":
+            if (pathParts.length === 6) {
+              return {
+                chapterId,
+                objectQid: parseQid(pathParts[5], uri),
+                predicate: decodeURIComponent(pathParts[4] ?? ""),
+                subjectQid: parseQid(pathParts[3], uri),
+                type: "triple"
+              };
+            }
+            break;
+        }
+      }
+      break;
+    case "chunk":
+      if (pathParts.length === 2) {
+        return {
+          id: parsePositiveInteger(pathParts[1], uri),
+          type: "chunk"
+        };
+      }
+      break;
+    case "entity":
+      if (pathParts.length === 2) {
+        return {
+          qid: parseQid(pathParts[1], uri),
+          type: "entity"
+        };
+      }
+      if (pathParts.length === 3 && pathParts[2] === "wikipage") {
+        return {
+          qid: parseQid(pathParts[1], uri),
+          type: "entity-wikipage"
+        };
+      }
+      break;
+    case "triple":
+      if (pathParts.length === 4) {
+        return {
+          objectQid: parseQid(pathParts[3], uri),
+          predicate: decodeURIComponent(pathParts[2] ?? ""),
+          subjectQid: parseQid(pathParts[1], uri),
+          type: "triple"
+        };
+      }
+      break;
+  }
+  throw new Error(`Invalid Wiki Graph URI: ${uri}`);
+}
+function parseQid(value, uri) {
+  if (value !== void 0 && /^Q[1-9][0-9]*$/u.test(value)) {
+    return value;
+  }
+  throw new Error(`Invalid Wiki Graph URI: ${uri}`);
+}
+function parseChapterStateTarget(value, uri) {
+  if (value === "source" || value === "reading-graph" || value === "reading-summary" || value === "knowledge-graph") {
+    return value;
+  }
+  throw new Error(`Invalid Wiki Graph URI: ${uri}`);
+}
+function parseSentenceRange(hash) {
+  if (hash === "") {
+    return [0, Number.POSITIVE_INFINITY];
+  }
+  const match = /^([1-9][0-9]*)(?:\.\.([1-9][0-9]*))?$/u.exec(hash);
+  if (match?.[1] === void 0) {
+    throw new Error(`Invalid source sentence range: ${hash}`);
+  }
+  const parsedStart = Number(match[1]) - 1;
+  const parsedEnd = Number(match[2] ?? match[1]) - 1;
+  if (Number.isInteger(parsedStart) && parsedStart >= 0 && Number.isInteger(parsedEnd) && parsedEnd >= parsedStart) {
+    return [parsedStart, parsedEnd];
+  }
+  throw new Error(`Invalid source sentence range: ${hash}`);
+}
+function formatParsedFragment(fragment) {
+  if (fragment === void 0) {
+    return "";
+  }
+  if (typeof fragment === "number") {
+    return String(fragment);
+  }
+  return `${fragment.begin}..${fragment.end}`;
+}
+function parseArchiveReference(id) {
+  const normalized = id.trim();
+  const [type, value] = normalized.split(":", 2);
+  if (type === "meta" && (value === "book" || value === "root")) {
+    return { type: "meta" };
+  }
+  if (type === "chapter" || type === "chapter-title" || type === "summary") {
+    const parsedId = parsePositiveInteger(value, normalized);
+    return { id: parsedId, type };
+  }
+  if (type === "node") {
+    const parsedId = parsePositiveInteger(value, normalized);
+    return {
+      id: parsedId,
+      type: "node"
+    };
+  }
+  if (type === "fragment") {
+    const parts = normalized.slice("fragment:".length).split(":");
+    if (parts.length !== 2) {
+      throw new Error(`Invalid archive object id: ${id}`);
+    }
+    return {
+      fragmentId: parseNonNegativeInteger(parts[1], normalized),
+      serialId: parsePositiveInteger(parts[0], normalized),
+      type: "fragment"
+    };
+  }
+  throw new Error(`Invalid archive object id: ${id}`);
+}
+function parsePositiveInteger(value, id) {
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    throw new Error(`Invalid archive object id: ${id}`);
+  }
+  return parsed;
+}
+function parseNonNegativeInteger(value, id) {
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed < 0) {
+    throw new Error(`Invalid archive object id: ${id}`);
+  }
+  return parsed;
+}
+export {
+  formatChapterId,
+  formatChapterTitleId,
+  formatEdgeId,
+  formatFragmentId,
+  formatNodeId,
+  formatSummaryId,
+  formatTextStreamRangeUri,
+  parseArchiveReference,
+  parseWikiGraphReference
+};
+//# sourceMappingURL=references.js.map

package/dist/retrieval/query/archive-view/references.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/retrieval/query/archive-view/references.ts"],"sourcesContent":["import type { ReadingEdgeRecord } from \"../../../document/index.js\";\nimport {\n  parseWikiGraphUriSyntax,\n  WIKI_GRAPH_URI_PREFIX,\n  type ParsedWikiGraphUri,\n} from \"../../../runtime/common/wiki-graph/uri.js\";\n\nimport {\n  isWikiGraphObjectUri,\n  normalizeWikiGraphObjectUri,\n} from \"./helpers.js\";\nimport type { ArchiveTextStreamKind, ChapterStateTarget } from \"./types.js\";\n\nexport function formatChapterId(chapterId: number): string {\n  return `chapter:${chapterId}`;\n}\n\nexport function formatChapterTitleId(chapterId: number): string {\n  return `chapter-title:${chapterId}`;\n}\n\nexport function formatEdgeId(edge: ReadingEdgeRecord): string {\n  return `edge:${edge.fromId}->${edge.toId}`;\n}\n\nexport function formatNodeId(nodeId: number): string {\n  return `node:${nodeId}`;\n}\n\nexport function formatSummaryId(chapterId: number): string {\n  return `summary:${chapterId}`;\n}\n\nexport function formatFragmentId(serialId: number, fragmentId: number): string {\n  return `fragment:${serialId}:${fragmentId}`;\n}\n\nexport function formatTextStreamRangeUri(\n  chapterPath: number | string,\n  stream: ArchiveTextStreamKind,\n  startSentenceIndex: number,\n  endSentenceIndex: number,\n): string {\n  const startSentenceNumber = startSentenceIndex + 1;\n  const endSentenceNumber = endSentenceIndex + 1;\n  const hash =\n    startSentenceIndex === endSentenceIndex\n      ? String(startSentenceNumber)\n      : `${startSentenceNumber}..${endSentenceNumber}`;\n\n  return `wikg://chapter/${chapterPath}/${stream}#${hash}`;\n}\n\nexport type WikiGraphReference =\n  | {\n      readonly type: \"meta\";\n    }\n  | {\n      readonly chapterId: number;\n      readonly type: \"chapter\";\n    }\n  | {\n      readonly chapterId: number;\n      readonly type: \"chapter-title\";\n    }\n  | {\n      readonly chapterId: number;\n      readonly target?: ChapterStateTarget;\n      readonly type: \"chapter-state\";\n    }\n  | {\n      readonly type: \"chapter-tree\";\n    }\n  | {\n      readonly chapterId?: number;\n      readonly id: number;\n      readonly type: \"chunk\";\n    }\n  | {\n      readonly chapterId: number;\n      readonly endSentenceIndex: number;\n      readonly stream: ArchiveTextStreamKind;\n      readonly startSentenceIndex: number;\n      readonly type: \"text-stream\";\n    }\n  | {\n      readonly chapterId?: number;\n      readonly qid: string;\n      readonly type: \"entity\";\n    }\n  | {\n      readonly qid: string;\n      readonly type: \"entity-wikipage\";\n    }\n  | {\n      readonly chapterId?: number;\n      readonly objectQid: string;\n      readonly predicate: string;\n      readonly subjectQid: string;\n      readonly type: \"triple\";\n    };\n\nexport function parseWikiGraphReference(uri: string): WikiGraphReference {\n  uri = normalizeWikiGraphObjectUri(uri);\n\n  if (!isWikiGraphObjectUri(uri)) {\n    const archiveReference = parseArchiveReference(uri);\n\n    switch (archiveReference.type) {\n      case \"node\":\n        return { id: archiveReference.id, type: \"chunk\" };\n      case \"chapter\":\n        return { chapterId: archiveReference.id, type: \"chapter\" };\n      case \"chapter-title\":\n        return { chapterId: archiveReference.id, type: \"chapter-title\" };\n      case \"summary\":\n        return {\n          chapterId: archiveReference.id,\n          endSentenceIndex: Number.POSITIVE_INFINITY,\n          stream: \"summary\",\n          startSentenceIndex: 0,\n          type: \"text-stream\",\n        };\n      case \"fragment\":\n      case \"meta\":\n        throw new Error(`Evidence is not available for ${uri}.`);\n    }\n  }\n\n  if (uri === WIKI_GRAPH_URI_PREFIX) {\n    return { type: \"meta\" };\n  }\n\n  const parsedUri = parseWikiGraphUriSyntax(uri);\n  if (parsedUri.protocol !== \"wikg\") {\n    throw new Error(`Invalid Wiki Graph URI: ${uri}`);\n  }\n  const pathParts = parsedUri.path;\n  const hash = formatParsedFragment(parsedUri.fragment);\n\n  if (pathParts.length === 0) {\n    return { type: \"meta\" };\n  }\n\n  if (pathParts[0] === \"chapter-tree\" && pathParts.length === 1) {\n    return { type: \"chapter-tree\" };\n  }\n\n  switch (pathParts[0]) {\n    case \"chapter\":\n      if (pathParts.length === 2) {\n        return {\n          chapterId: parsePositiveInteger(pathParts[1], uri),\n          type: \"chapter\",\n        };\n      }\n      if (pathParts[1] !== undefined) {\n        const chapterId = parsePositiveInteger(pathParts[1], uri);\n\n        switch (pathParts[2]) {\n          case \"state\":\n            if (pathParts.length === 3) {\n              return { chapterId, type: \"chapter-state\" };\n            }\n            if (pathParts.length === 4) {\n              return {\n                chapterId,\n                target: parseChapterStateTarget(pathParts[3], uri),\n                type: \"chapter-state\",\n              };\n            }\n            break;\n          case \"title\":\n            if (pathParts.length === 3) {\n              return { chapterId, type: \"chapter-title\" };\n            }\n            break;\n          case \"chunk\":\n            if (pathParts.length === 4) {\n              return {\n                chapterId,\n                id: parsePositiveInteger(pathParts[3], uri),\n                type: \"chunk\",\n              };\n            }\n            break;\n          case \"entity\":\n            if (pathParts.length === 4) {\n              return {\n                chapterId,\n                qid: parseQid(pathParts[3], uri),\n                type: \"entity\",\n              };\n            }\n            break;\n          case \"source\":\n            if (pathParts.length === 3) {\n              const [start, end] = parseSentenceRange(hash);\n\n              return {\n                chapterId,\n                endSentenceIndex: end,\n                stream: \"source\",\n                startSentenceIndex: start,\n                type: \"text-stream\",\n              };\n            }\n            break;\n          case \"summary\":\n            if (pathParts.length === 3) {\n              const [start, end] = parseSentenceRange(hash);\n\n              return {\n                chapterId,\n                endSentenceIndex: end,\n                stream: \"summary\",\n                startSentenceIndex: start,\n                type: \"text-stream\",\n              };\n            }\n            break;\n          case \"tree\":\n            if (pathParts.length === 3) {\n              return { chapterId, type: \"chapter\" };\n            }\n            break;\n          case \"triple\":\n            if (pathParts.length === 6) {\n              return {\n                chapterId,\n                objectQid: parseQid(pathParts[5], uri),\n                predicate: decodeURIComponent(pathParts[4] ?? \"\"),\n                subjectQid: parseQid(pathParts[3], uri),\n                type: \"triple\",\n              };\n            }\n            break;\n        }\n      }\n      break;\n    case \"chunk\":\n      if (pathParts.length === 2) {\n        return {\n          id: parsePositiveInteger(pathParts[1], uri),\n          type: \"chunk\",\n        };\n      }\n      break;\n    case \"entity\":\n      if (pathParts.length === 2) {\n        return {\n          qid: parseQid(pathParts[1], uri),\n          type: \"entity\",\n        };\n      }\n      if (pathParts.length === 3 && pathParts[2] === \"wikipage\") {\n        return {\n          qid: parseQid(pathParts[1], uri),\n          type: \"entity-wikipage\",\n        };\n      }\n      break;\n    case \"triple\":\n      if (pathParts.length === 4) {\n        return {\n          objectQid: parseQid(pathParts[3], uri),\n          predicate: decodeURIComponent(pathParts[2] ?? \"\"),\n          subjectQid: parseQid(pathParts[1], uri),\n          type: \"triple\",\n        };\n      }\n      break;\n  }\n\n  throw new Error(`Invalid Wiki Graph URI: ${uri}`);\n}\n\nfunction parseQid(value: string | undefined, uri: string): string {\n  if (value !== undefined && /^Q[1-9][0-9]*$/u.test(value)) {\n    return value;\n  }\n\n  throw new Error(`Invalid Wiki Graph URI: ${uri}`);\n}\n\nfunction parseChapterStateTarget(\n  value: string | undefined,\n  uri: string,\n): ChapterStateTarget {\n  if (\n    value === \"source\" ||\n    value === \"reading-graph\" ||\n    value === \"reading-summary\" ||\n    value === \"knowledge-graph\"\n  ) {\n    return value;\n  }\n\n  throw new Error(`Invalid Wiki Graph URI: ${uri}`);\n}\n\nfunction parseSentenceRange(hash: string): readonly [number, number] {\n  if (hash === \"\") {\n    return [0, Number.POSITIVE_INFINITY];\n  }\n\n  const match = /^([1-9][0-9]*)(?:\\.\\.([1-9][0-9]*))?$/u.exec(hash);\n\n  if (match?.[1] === undefined) {\n    throw new Error(`Invalid source sentence range: ${hash}`);\n  }\n\n  const parsedStart = Number(match[1]) - 1;\n  const parsedEnd = Number(match[2] ?? match[1]) - 1;\n\n  if (\n    Number.isInteger(parsedStart) &&\n    parsedStart >= 0 &&\n    Number.isInteger(parsedEnd) &&\n    parsedEnd >= parsedStart\n  ) {\n    return [parsedStart, parsedEnd];\n  }\n\n  throw new Error(`Invalid source sentence range: ${hash}`);\n}\n\nfunction formatParsedFragment(\n  fragment: ParsedWikiGraphUri[\"fragment\"],\n): string {\n  if (fragment === undefined) {\n    return \"\";\n  }\n  if (typeof fragment === \"number\") {\n    return String(fragment);\n  }\n\n  return `${fragment.begin}..${fragment.end}`;\n}\n\nexport function parseArchiveReference(id: string):\n  | {\n      readonly id: number;\n      readonly type: \"chapter\" | \"chapter-title\" | \"summary\";\n    }\n  | {\n      readonly id: number;\n      readonly type: \"node\";\n    }\n  | {\n      readonly fragmentId: number;\n      readonly serialId: number;\n      readonly type: \"fragment\";\n    }\n  | {\n      readonly type: \"meta\";\n    } {\n  const normalized = id.trim();\n  const [type, value] = normalized.split(\":\", 2);\n\n  if (type === \"meta\" && (value === \"book\" || value === \"root\")) {\n    return { type: \"meta\" };\n  }\n  if (type === \"chapter\" || type === \"chapter-title\" || type === \"summary\") {\n    const parsedId = parsePositiveInteger(value, normalized);\n\n    return { id: parsedId, type };\n  }\n  if (type === \"node\") {\n    const parsedId = parsePositiveInteger(value, normalized);\n\n    return {\n      id: parsedId,\n      type: \"node\",\n    };\n  }\n  if (type === \"fragment\") {\n    const parts = normalized.slice(\"fragment:\".length).split(\":\");\n\n    if (parts.length !== 2) {\n      throw new Error(`Invalid archive object id: ${id}`);\n    }\n\n    return {\n      fragmentId: parseNonNegativeInteger(parts[1], normalized),\n      serialId: parsePositiveInteger(parts[0], normalized),\n      type: \"fragment\",\n    };\n  }\n  throw new Error(`Invalid archive object id: ${id}`);\n}\n\nfunction parsePositiveInteger(value: string | undefined, id: string): number {\n  const parsed = Number(value);\n\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new Error(`Invalid archive object id: ${id}`);\n  }\n\n  return parsed;\n}\n\nfunction parseNonNegativeInteger(\n  value: string | undefined,\n  id: string,\n): number {\n  const parsed = Number(value);\n\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    throw new Error(`Invalid archive object id: ${id}`);\n  }\n\n  return parsed;\n}\n"],"mappings":"AACA;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAGA,SAAS,gBAAgB,WAA2B;AACzD,SAAO,WAAW,SAAS;AAC7B;AAEO,SAAS,qBAAqB,WAA2B;AAC9D,SAAO,iBAAiB,SAAS;AACnC;AAEO,SAAS,aAAa,MAAiC;AAC5D,SAAO,QAAQ,KAAK,MAAM,KAAK,KAAK,IAAI;AAC1C;AAEO,SAAS,aAAa,QAAwB;AACnD,SAAO,QAAQ,MAAM;AACvB;AAEO,SAAS,gBAAgB,WAA2B;AACzD,SAAO,WAAW,SAAS;AAC7B;AAEO,SAAS,iBAAiB,UAAkB,YAA4B;AAC7E,SAAO,YAAY,QAAQ,IAAI,UAAU;AAC3C;AAEO,SAAS,yBACd,aACA,QACA,oBACA,kBACQ;AACR,QAAM,sBAAsB,qBAAqB;AACjD,QAAM,oBAAoB,mBAAmB;AAC7C,QAAM,OACJ,uBAAuB,mBACnB,OAAO,mBAAmB,IAC1B,GAAG,mBAAmB,KAAK,iBAAiB;AAElD,SAAO,kBAAkB,WAAW,IAAI,MAAM,IAAI,IAAI;AACxD;AAmDO,SAAS,wBAAwB,KAAiC;AACvE,QAAM,4BAA4B,GAAG;AAErC,MAAI,CAAC,qBAAqB,GAAG,GAAG;AAC9B,UAAM,mBAAmB,sBAAsB,GAAG;AAElD,YAAQ,iBAAiB,MAAM;AAAA,MAC7B,KAAK;AACH,eAAO,EAAE,IAAI,iBAAiB,IAAI,MAAM,QAAQ;AAAA,MAClD,KAAK;AACH,eAAO,EAAE,WAAW,iBAAiB,IAAI,MAAM,UAAU;AAAA,MAC3D,KAAK;AACH,eAAO,EAAE,WAAW,iBAAiB,IAAI,MAAM,gBAAgB;AAAA,MACjE,KAAK;AACH,eAAO;AAAA,UACL,WAAW,iBAAiB;AAAA,UAC5B,kBAAkB,OAAO;AAAA,UACzB,QAAQ;AAAA,UACR,oBAAoB;AAAA,UACpB,MAAM;AAAA,QACR;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,cAAM,IAAI,MAAM,iCAAiC,GAAG,GAAG;AAAA,IAC3D;AAAA,EACF;AAEA,MAAI,QAAQ,uBAAuB;AACjC,WAAO,EAAE,MAAM,OAAO;AAAA,EACxB;AAEA,QAAM,YAAY,wBAAwB,GAAG;AAC7C,MAAI,UAAU,aAAa,QAAQ;AACjC,UAAM,IAAI,MAAM,2BAA2B,GAAG,EAAE;AAAA,EAClD;AACA,QAAM,YAAY,UAAU;AAC5B,QAAM,OAAO,qBAAqB,UAAU,QAAQ;AAEpD,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO,EAAE,MAAM,OAAO;AAAA,EACxB;AAEA,MAAI,UAAU,CAAC,MAAM,kBAAkB,UAAU,WAAW,GAAG;AAC7D,WAAO,EAAE,MAAM,eAAe;AAAA,EAChC;AAEA,UAAQ,UAAU,CAAC,GAAG;AAAA,IACpB,KAAK;AACH,UAAI,UAAU,WAAW,GAAG;AAC1B,eAAO;AAAA,UACL,WAAW,qBAAqB,UAAU,CAAC,GAAG,GAAG;AAAA,UACjD,MAAM;AAAA,QACR;AAAA,MACF;AACA,UAAI,UAAU,CAAC,MAAM,QAAW;AAC9B,cAAM,YAAY,qBAAqB,UAAU,CAAC,GAAG,GAAG;AAExD,gBAAQ,UAAU,CAAC,GAAG;AAAA,UACpB,KAAK;AACH,gBAAI,UAAU,WAAW,GAAG;AAC1B,qBAAO,EAAE,WAAW,MAAM,gBAAgB;AAAA,YAC5C;AACA,gBAAI,UAAU,WAAW,GAAG;AAC1B,qBAAO;AAAA,gBACL;AAAA,gBACA,QAAQ,wBAAwB,UAAU,CAAC,GAAG,GAAG;AAAA,gBACjD,MAAM;AAAA,cACR;AAAA,YACF;AACA;AAAA,UACF,KAAK;AACH,gBAAI,UAAU,WAAW,GAAG;AAC1B,qBAAO,EAAE,WAAW,MAAM,gBAAgB;AAAA,YAC5C;AACA;AAAA,UACF,KAAK;AACH,gBAAI,UAAU,WAAW,GAAG;AAC1B,qBAAO;AAAA,gBACL;AAAA,gBACA,IAAI,qBAAqB,UAAU,CAAC,GAAG,GAAG;AAAA,gBAC1C,MAAM;AAAA,cACR;AAAA,YACF;AACA;AAAA,UACF,KAAK;AACH,gBAAI,UAAU,WAAW,GAAG;AAC1B,qBAAO;AAAA,gBACL;AAAA,gBACA,KAAK,SAAS,UAAU,CAAC,GAAG,GAAG;AAAA,gBAC/B,MAAM;AAAA,cACR;AAAA,YACF;AACA;AAAA,UACF,KAAK;AACH,gBAAI,UAAU,WAAW,GAAG;AAC1B,oBAAM,CAAC,OAAO,GAAG,IAAI,mBAAmB,IAAI;AAE5C,qBAAO;AAAA,gBACL;AAAA,gBACA,kBAAkB;AAAA,gBAClB,QAAQ;AAAA,gBACR,oBAAoB;AAAA,gBACpB,MAAM;AAAA,cACR;AAAA,YACF;AACA;AAAA,UACF,KAAK;AACH,gBAAI,UAAU,WAAW,GAAG;AAC1B,oBAAM,CAAC,OAAO,GAAG,IAAI,mBAAmB,IAAI;AAE5C,qBAAO;AAAA,gBACL;AAAA,gBACA,kBAAkB;AAAA,gBAClB,QAAQ;AAAA,gBACR,oBAAoB;AAAA,gBACpB,MAAM;AAAA,cACR;AAAA,YACF;AACA;AAAA,UACF,KAAK;AACH,gBAAI,UAAU,WAAW,GAAG;AAC1B,qBAAO,EAAE,WAAW,MAAM,UAAU;AAAA,YACtC;AACA;AAAA,UACF,KAAK;AACH,gBAAI,UAAU,WAAW,GAAG;AAC1B,qBAAO;AAAA,gBACL;AAAA,gBACA,WAAW,SAAS,UAAU,CAAC,GAAG,GAAG;AAAA,gBACrC,WAAW,mBAAmB,UAAU,CAAC,KAAK,EAAE;AAAA,gBAChD,YAAY,SAAS,UAAU,CAAC,GAAG,GAAG;AAAA,gBACtC,MAAM;AAAA,cACR;AAAA,YACF;AACA;AAAA,QACJ;AAAA,MACF;AACA;AAAA,IACF,KAAK;AACH,UAAI,UAAU,WAAW,GAAG;AAC1B,eAAO;AAAA,UACL,IAAI,qBAAqB,UAAU,CAAC,GAAG,GAAG;AAAA,UAC1C,MAAM;AAAA,QACR;AAAA,MACF;AACA;AAAA,IACF,KAAK;AACH,UAAI,UAAU,WAAW,GAAG;AAC1B,eAAO;AAAA,UACL,KAAK,SAAS,UAAU,CAAC,GAAG,GAAG;AAAA,UAC/B,MAAM;AAAA,QACR;AAAA,MACF;AACA,UAAI,UAAU,WAAW,KAAK,UAAU,CAAC,MAAM,YAAY;AACzD,eAAO;AAAA,UACL,KAAK,SAAS,UAAU,CAAC,GAAG,GAAG;AAAA,UAC/B,MAAM;AAAA,QACR;AAAA,MACF;AACA;AAAA,IACF,KAAK;AACH,UAAI,UAAU,WAAW,GAAG;AAC1B,eAAO;AAAA,UACL,WAAW,SAAS,UAAU,CAAC,GAAG,GAAG;AAAA,UACrC,WAAW,mBAAmB,UAAU,CAAC,KAAK,EAAE;AAAA,UAChD,YAAY,SAAS,UAAU,CAAC,GAAG,GAAG;AAAA,UACtC,MAAM;AAAA,QACR;AAAA,MACF;AACA;AAAA,EACJ;AAEA,QAAM,IAAI,MAAM,2BAA2B,GAAG,EAAE;AAClD;AAEA,SAAS,SAAS,OAA2B,KAAqB;AAChE,MAAI,UAAU,UAAa,kBAAkB,KAAK,KAAK,GAAG;AACxD,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,2BAA2B,GAAG,EAAE;AAClD;AAEA,SAAS,wBACP,OACA,KACoB;AACpB,MACE,UAAU,YACV,UAAU,mBACV,UAAU,qBACV,UAAU,mBACV;AACA,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,2BAA2B,GAAG,EAAE;AAClD;AAEA,SAAS,mBAAmB,MAAyC;AACnE,MAAI,SAAS,IAAI;AACf,WAAO,CAAC,GAAG,OAAO,iBAAiB;AAAA,EACrC;AAEA,QAAM,QAAQ,yCAAyC,KAAK,IAAI;AAEhE,MAAI,QAAQ,CAAC,MAAM,QAAW;AAC5B,UAAM,IAAI,MAAM,kCAAkC,IAAI,EAAE;AAAA,EAC1D;AAEA,QAAM,cAAc,OAAO,MAAM,CAAC,CAAC,IAAI;AACvC,QAAM,YAAY,OAAO,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI;AAEjD,MACE,OAAO,UAAU,WAAW,KAC5B,eAAe,KACf,OAAO,UAAU,SAAS,KAC1B,aAAa,aACb;AACA,WAAO,CAAC,aAAa,SAAS;AAAA,EAChC;AAEA,QAAM,IAAI,MAAM,kCAAkC,IAAI,EAAE;AAC1D;AAEA,SAAS,qBACP,UACQ;AACR,MAAI,aAAa,QAAW;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,aAAa,UAAU;AAChC,WAAO,OAAO,QAAQ;AAAA,EACxB;AAEA,SAAO,GAAG,SAAS,KAAK,KAAK,SAAS,GAAG;AAC3C;AAEO,SAAS,sBAAsB,IAgBhC;AACJ,QAAM,aAAa,GAAG,KAAK;AAC3B,QAAM,CAAC,MAAM,KAAK,IAAI,WAAW,MAAM,KAAK,CAAC;AAE7C,MAAI,SAAS,WAAW,UAAU,UAAU,UAAU,SAAS;AAC7D,WAAO,EAAE,MAAM,OAAO;AAAA,EACxB;AACA,MAAI,SAAS,aAAa,SAAS,mBAAmB,SAAS,WAAW;AACxE,UAAM,WAAW,qBAAqB,OAAO,UAAU;AAEvD,WAAO,EAAE,IAAI,UAAU,KAAK;AAAA,EAC9B;AACA,MAAI,SAAS,QAAQ;AACnB,UAAM,WAAW,qBAAqB,OAAO,UAAU;AAEvD,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,MAAM;AAAA,IACR;AAAA,EACF;AACA,MAAI,SAAS,YAAY;AACvB,UAAM,QAAQ,WAAW,MAAM,YAAY,MAAM,EAAE,MAAM,GAAG;AAE5D,QAAI,MAAM,WAAW,GAAG;AACtB,YAAM,IAAI,MAAM,8BAA8B,EAAE,EAAE;AAAA,IACpD;AAEA,WAAO;AAAA,MACL,YAAY,wBAAwB,MAAM,CAAC,GAAG,UAAU;AAAA,MACxD,UAAU,qBAAqB,MAAM,CAAC,GAAG,UAAU;AAAA,MACnD,MAAM;AAAA,IACR;AAAA,EACF;AACA,QAAM,IAAI,MAAM,8BAA8B,EAAE,EAAE;AACpD;AAEA,SAAS,qBAAqB,OAA2B,IAAoB;AAC3E,QAAM,SAAS,OAAO,KAAK;AAE3B,MAAI,CAAC,OAAO,UAAU,MAAM,KAAK,UAAU,GAAG;AAC5C,UAAM,IAAI,MAAM,8BAA8B,EAAE,EAAE;AAAA,EACpD;AAEA,SAAO;AACT;AAEA,SAAS,wBACP,OACA,IACQ;AACR,QAAM,SAAS,OAAO,KAAK;AAE3B,MAAI,CAAC,OAAO,UAAU,MAAM,KAAK,SAAS,GAAG;AAC3C,UAAM,IAAI,MAAM,8BAA8B,EAAE,EAAE;AAAA,EACpD;AAEA,SAAO;AACT;","names":[]}

package/dist/retrieval/query/archive-view/related/core.d.ts

@@ -0,0 +1,37 @@
+import { ReadonlyDocument } from '../../../../document/directory/types.js';
+import { GraphNeighbor } from '../../../../graph/reading.js';
+export { resolveEntityWikipage } from './wikipage.js';
+import { ArchiveRelatedOptions, ArchiveRelatedResult } from '../types.js';
+import '../../../../text/source/meta.js';
+import 'zod';
+import '../../../../text/source/toc.js';
+import '../../../../text/source/types.js';
+import '../../../../document/database.js';
+import 'sqlite3';
+import '../../../../document/types.js';
+import '../../../../document/text-streams/serial.js';
+import '../../../../document/text-streams/draft.js';
+import '../../../../document/text-streams/types.js';
+import '../../../../document/stores/chunk.js';
+import '../../../../document/stores/types.js';
+import '../../../../document/stores/fragment-group.js';
+import '../../../../document/stores/graph-build-parameter.js';
+import '../../../../document/stores/mention-link.js';
+import '../../../../document/stores/mention.js';
+import '../../../../document/stores/object-metadata.js';
+import '../../../../document/stores/reading-edge.js';
+import '../../../../document/stores/serial.js';
+import '../../../../document/stores/snake/chunk.js';
+import '../../../../document/stores/snake/core.js';
+import '../../../../document/stores/snake/edge.js';
+import '../pages.js';
+import '../../../../external/wikipage/types.js';
+import '../../../../external/wikipage/wikimedia-client/wiki.js';
+import '../../../../external/wikipage/fetch-log.js';
+import '../../../../document/chapter/types.js';
+
+declare function listArchiveLinks(document: ReadonlyDocument, id: string, direction: "backlinks" | "links"): Promise<readonly GraphNeighbor[]>;
+declare function listAllArchiveLinks(document: ReadonlyDocument, id: string): Promise<readonly GraphNeighbor[]>;
+declare function listRelatedArchiveObjects(document: ReadonlyDocument, id: string, options?: ArchiveRelatedOptions): Promise<ArchiveRelatedResult>;
+
+export { listAllArchiveLinks, listArchiveLinks, listRelatedArchiveObjects };

package/dist/retrieval/query/archive-view/related/core.js

@@ -0,0 +1,163 @@
+import { listGraphNeighbors } from "../../../../graph/reading.js";
+import {
+  isWikiGraphObjectUri,
+  normalizeWikiGraphObjectUri
+} from "../helpers.js";
+import { requireChapter, requireNode } from "../core.js";
+import {
+  hydrateRelatedItemsEvidence,
+  paginateRelatedItems
+} from "./pagination.js";
+import { listRelatedEntityObjects } from "./entity.js";
+import { filterAndSortChunkRelatedItemsByQuery } from "./query.js";
+import { sortGraphNeighborsByListMode } from "./sort.js";
+import { resolveEntityWikipage } from "./wikipage.js";
+import {
+  formatChapterId,
+  formatNodeId,
+  parseArchiveReference,
+  parseWikiGraphReference
+} from "../references.js";
+async function listArchiveLinks(document, id, direction) {
+  return (await listAllArchiveLinks(document, id)).filter(
+    (neighbor) => direction === "links" ? neighbor.direction === "outgoing" : neighbor.direction === "incoming"
+  );
+}
+async function listAllArchiveLinks(document, id) {
+  if (isWikiGraphObjectUri(id)) {
+    id = normalizeWikiGraphObjectUri(id);
+    const reference2 = parseWikiGraphReference(id);
+    if (reference2.type !== "chunk") {
+      return [];
+    }
+    const { chapterId: chapterId2 } = await requireNode(document, reference2.id);
+    if (reference2.chapterId !== void 0 && reference2.chapterId !== chapterId2) {
+      throw new Error(`Chunk ${id} was not found in this archive.`);
+    }
+    return await listGraphNeighbors(document, chapterId2, reference2.id);
+  }
+  const reference = parseArchiveReference(id);
+  if (reference.type !== "node") {
+    return [];
+  }
+  const { chapterId } = await requireNode(document, reference.id);
+  return await listGraphNeighbors(document, chapterId, reference.id);
+}
+async function listRelatedArchiveObjects(document, id, options = {}) {
+  if (isWikiGraphObjectUri(id)) {
+    return await listRelatedWikiGraphObjects(
+      document,
+      normalizeWikiGraphObjectUri(id),
+      options
+    );
+  }
+  const reference = parseArchiveReference(id);
+  if (reference.type !== "node") {
+    rejectRelatedRole(options.role, id);
+    return paginateRelatedItems([], options);
+  }
+  rejectRelatedRole(options.role, id);
+  const documentOrders = await document.serials.listDocumentOrders();
+  const { chapterId } = await requireNode(document, reference.id);
+  const items = sortGraphNeighborsByListMode(
+    await listGraphNeighbors(document, chapterId, reference.id),
+    documentOrders,
+    options.order ?? "doc-asc"
+  ).map((neighbor) => ({
+    id: formatNodeId(neighbor.node.id),
+    label: neighbor.node.label,
+    summary: neighbor.node.content,
+    type: "node"
+  }));
+  return await hydrateRelatedItemsEvidence(
+    document,
+    await filterAndSortChunkRelatedItemsByQuery(document, items, options.query),
+    options
+  );
+}
+async function listRelatedWikiGraphObjects(document, uri, options) {
+  const reference = parseWikiGraphReference(uri);
+  switch (reference.type) {
+    case "chapter": {
+      throw new Error(`Related is not available for scope URI: ${uri}`);
+    }
+    case "chapter-title":
+      rejectRelatedRole(options.role, uri);
+      return paginateRelatedItems([], options);
+    case "chunk": {
+      rejectRelatedRole(options.role, uri);
+      const { chapterId } = await requireNode(document, reference.id);
+      if (reference.chapterId !== void 0 && reference.chapterId !== chapterId) {
+        throw new Error(`Chunk ${uri} was not found in this archive.`);
+      }
+      const items = sortGraphNeighborsByListMode(
+        await listGraphNeighbors(document, chapterId, reference.id),
+        await document.serials.listDocumentOrders(),
+        options.order ?? "doc-asc"
+      ).map((neighbor) => ({
+        id: formatNodeId(neighbor.node.id),
+        label: neighbor.node.label,
+        summary: neighbor.node.content,
+        type: "node"
+      }));
+      return await hydrateRelatedItemsEvidence(
+        document,
+        await filterAndSortChunkRelatedItemsByQuery(
+          document,
+          items,
+          options.query
+        ),
+        options
+      );
+    }
+    case "text-stream": {
+      rejectRelatedQuery(options.query, uri);
+      rejectRelatedRole(options.role, uri);
+      const chapter = await requireChapter(document, reference.chapterId);
+      return await hydrateRelatedItemsEvidence(
+        document,
+        [
+          {
+            id: formatChapterId(reference.chapterId),
+            label: chapter.title ?? `[chapter ${reference.chapterId}]`,
+            summary: `${chapter.stage}; ${chapter.fragmentCount} fragments`,
+            type: "chapter"
+          }
+        ],
+        options
+      );
+    }
+    case "entity":
+      return await listRelatedEntityObjects(document, reference, options);
+    case "triple":
+      throw new Error(
+        `Related is only available for chunk and entity objects: ${uri}`
+      );
+    case "chapter-tree":
+    case "entity-wikipage":
+    case "meta":
+    case "chapter-state":
+      rejectRelatedQuery(options.query, uri);
+      rejectRelatedRole(options.role, uri);
+      return paginateRelatedItems([], options);
+  }
+}
+function rejectRelatedRole(role, id) {
+  if (role !== void 0 && role !== "any") {
+    throw new Error(`--role is only available for entity related: ${id}`);
+  }
+}
+function rejectRelatedQuery(query, id) {
+  if (query !== void 0) {
+    throw new Error(
+      `Related query is only available for chunk and entity: ${id}`
+    );
+  }
+}
+export {
+  listAllArchiveLinks,
+  listArchiveLinks,
+  listRelatedArchiveObjects,
+  resolveEntityWikipage
+};
+//# sourceMappingURL=core.js.map

package/dist/retrieval/query/archive-view/related/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/retrieval/query/archive-view/related/core.ts"],"sourcesContent":["import type { ReadonlyDocument } from \"../../../../document/index.js\";\nimport type { GraphNeighbor } from \"../../../../graph/reading.js\";\nimport { listGraphNeighbors } from \"../../../../graph/reading.js\";\n\nimport {\n  isWikiGraphObjectUri,\n  normalizeWikiGraphObjectUri,\n} from \"../helpers.js\";\nimport { requireChapter, requireNode } from \"../core.js\";\nimport {\n  hydrateRelatedItemsEvidence,\n  paginateRelatedItems,\n} from \"./pagination.js\";\nimport { listRelatedEntityObjects } from \"./entity.js\";\nimport { filterAndSortChunkRelatedItemsByQuery } from \"./query.js\";\nimport { sortGraphNeighborsByListMode } from \"./sort.js\";\nexport { resolveEntityWikipage } from \"./wikipage.js\";\nimport {\n  formatChapterId,\n  formatNodeId,\n  parseArchiveReference,\n  parseWikiGraphReference,\n} from \"../references.js\";\nimport type {\n  ArchiveRelatedOptions,\n  ArchiveRelatedResult,\n  ArchiveRelatedRole,\n} from \"../types.js\";\n\nexport async function listArchiveLinks(\n  document: ReadonlyDocument,\n  id: string,\n  direction: \"backlinks\" | \"links\",\n): Promise<readonly GraphNeighbor[]> {\n  return (await listAllArchiveLinks(document, id)).filter((neighbor) =>\n    direction === \"links\"\n      ? neighbor.direction === \"outgoing\"\n      : neighbor.direction === \"incoming\",\n  );\n}\n\nexport async function listAllArchiveLinks(\n  document: ReadonlyDocument,\n  id: string,\n): Promise<readonly GraphNeighbor[]> {\n  if (isWikiGraphObjectUri(id)) {\n    id = normalizeWikiGraphObjectUri(id);\n    const reference = parseWikiGraphReference(id);\n\n    if (reference.type !== \"chunk\") {\n      return [];\n    }\n\n    const { chapterId } = await requireNode(document, reference.id);\n\n    if (\n      reference.chapterId !== undefined &&\n      reference.chapterId !== chapterId\n    ) {\n      throw new Error(`Chunk ${id} was not found in this archive.`);\n    }\n\n    return await listGraphNeighbors(document, chapterId, reference.id);\n  }\n\n  const reference = parseArchiveReference(id);\n\n  if (reference.type !== \"node\") {\n    return [];\n  }\n\n  const { chapterId } = await requireNode(document, reference.id);\n  return await listGraphNeighbors(document, chapterId, reference.id);\n}\n\nexport async function listRelatedArchiveObjects(\n  document: ReadonlyDocument,\n  id: string,\n  options: ArchiveRelatedOptions = {},\n): Promise<ArchiveRelatedResult> {\n  if (isWikiGraphObjectUri(id)) {\n    return await listRelatedWikiGraphObjects(\n      document,\n      normalizeWikiGraphObjectUri(id),\n      options,\n    );\n  }\n\n  const reference = parseArchiveReference(id);\n  if (reference.type !== \"node\") {\n    rejectRelatedRole(options.role, id);\n    return paginateRelatedItems([], options);\n  }\n  rejectRelatedRole(options.role, id);\n\n  const documentOrders = await document.serials.listDocumentOrders();\n  const { chapterId } = await requireNode(document, reference.id);\n  const items = sortGraphNeighborsByListMode(\n    await listGraphNeighbors(document, chapterId, reference.id),\n    documentOrders,\n    options.order ?? \"doc-asc\",\n  ).map((neighbor) => ({\n    id: formatNodeId(neighbor.node.id),\n    label: neighbor.node.label,\n    summary: neighbor.node.content,\n    type: \"node\" as const,\n  }));\n\n  return await hydrateRelatedItemsEvidence(\n    document,\n    await filterAndSortChunkRelatedItemsByQuery(document, items, options.query),\n    options,\n  );\n}\n\nasync function listRelatedWikiGraphObjects(\n  document: ReadonlyDocument,\n  uri: string,\n  options: ArchiveRelatedOptions,\n): Promise<ArchiveRelatedResult> {\n  const reference = parseWikiGraphReference(uri);\n\n  switch (reference.type) {\n    case \"chapter\": {\n      throw new Error(`Related is not available for scope URI: ${uri}`);\n    }\n    case \"chapter-title\":\n      rejectRelatedRole(options.role, uri);\n      return paginateRelatedItems([], options);\n    case \"chunk\": {\n      rejectRelatedRole(options.role, uri);\n      const { chapterId } = await requireNode(document, reference.id);\n\n      if (\n        reference.chapterId !== undefined &&\n        reference.chapterId !== chapterId\n      ) {\n        throw new Error(`Chunk ${uri} was not found in this archive.`);\n      }\n\n      const items = sortGraphNeighborsByListMode(\n        await listGraphNeighbors(document, chapterId, reference.id),\n        await document.serials.listDocumentOrders(),\n        options.order ?? \"doc-asc\",\n      ).map((neighbor) => ({\n        id: formatNodeId(neighbor.node.id),\n        label: neighbor.node.label,\n        summary: neighbor.node.content,\n        type: \"node\" as const,\n      }));\n\n      return await hydrateRelatedItemsEvidence(\n        document,\n        await filterAndSortChunkRelatedItemsByQuery(\n          document,\n          items,\n          options.query,\n        ),\n        options,\n      );\n    }\n    case \"text-stream\": {\n      rejectRelatedQuery(options.query, uri);\n      rejectRelatedRole(options.role, uri);\n      const chapter = await requireChapter(document, reference.chapterId);\n\n      return await hydrateRelatedItemsEvidence(\n        document,\n        [\n          {\n            id: formatChapterId(reference.chapterId),\n            label: chapter.title ?? `[chapter ${reference.chapterId}]`,\n            summary: `${chapter.stage}; ${chapter.fragmentCount} fragments`,\n            type: \"chapter\",\n          },\n        ],\n        options,\n      );\n    }\n    case \"entity\":\n      return await listRelatedEntityObjects(document, reference, options);\n    case \"triple\":\n      throw new Error(\n        `Related is only available for chunk and entity objects: ${uri}`,\n      );\n    case \"chapter-tree\":\n    case \"entity-wikipage\":\n    case \"meta\":\n    case \"chapter-state\":\n      rejectRelatedQuery(options.query, uri);\n      rejectRelatedRole(options.role, uri);\n      return paginateRelatedItems([], options);\n  }\n}\n\nfunction rejectRelatedRole(\n  role: ArchiveRelatedRole | undefined,\n  id: string,\n): void {\n  if (role !== undefined && role !== \"any\") {\n    throw new Error(`--role is only available for entity related: ${id}`);\n  }\n}\n\nfunction rejectRelatedQuery(query: string | undefined, id: string): void {\n  if (query !== undefined) {\n    throw new Error(\n      `Related query is only available for chunk and entity: ${id}`,\n    );\n  }\n}\n"],"mappings":"AAEA,SAAS,0BAA0B;AAEnC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,gBAAgB,mBAAmB;AAC5C;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,gCAAgC;AACzC,SAAS,6CAA6C;AACtD,SAAS,oCAAoC;AAC7C,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOP,eAAsB,iBACpB,UACA,IACA,WACmC;AACnC,UAAQ,MAAM,oBAAoB,UAAU,EAAE,GAAG;AAAA,IAAO,CAAC,aACvD,cAAc,UACV,SAAS,cAAc,aACvB,SAAS,cAAc;AAAA,EAC7B;AACF;AAEA,eAAsB,oBACpB,UACA,IACmC;AACnC,MAAI,qBAAqB,EAAE,GAAG;AAC5B,SAAK,4BAA4B,EAAE;AACnC,UAAMA,aAAY,wBAAwB,EAAE;AAE5C,QAAIA,WAAU,SAAS,SAAS;AAC9B,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,EAAE,WAAAC,WAAU,IAAI,MAAM,YAAY,UAAUD,WAAU,EAAE;AAE9D,QACEA,WAAU,cAAc,UACxBA,WAAU,cAAcC,YACxB;AACA,YAAM,IAAI,MAAM,SAAS,EAAE,iCAAiC;AAAA,IAC9D;AAEA,WAAO,MAAM,mBAAmB,UAAUA,YAAWD,WAAU,EAAE;AAAA,EACnE;AAEA,QAAM,YAAY,sBAAsB,EAAE;AAE1C,MAAI,UAAU,SAAS,QAAQ;AAC7B,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,EAAE,UAAU,IAAI,MAAM,YAAY,UAAU,UAAU,EAAE;AAC9D,SAAO,MAAM,mBAAmB,UAAU,WAAW,UAAU,EAAE;AACnE;AAEA,eAAsB,0BACpB,UACA,IACA,UAAiC,CAAC,GACH;AAC/B,MAAI,qBAAqB,EAAE,GAAG;AAC5B,WAAO,MAAM;AAAA,MACX;AAAA,MACA,4BAA4B,EAAE;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAAY,sBAAsB,EAAE;AAC1C,MAAI,UAAU,SAAS,QAAQ;AAC7B,sBAAkB,QAAQ,MAAM,EAAE;AAClC,WAAO,qBAAqB,CAAC,GAAG,OAAO;AAAA,EACzC;AACA,oBAAkB,QAAQ,MAAM,EAAE;AAElC,QAAM,iBAAiB,MAAM,SAAS,QAAQ,mBAAmB;AACjE,QAAM,EAAE,UAAU,IAAI,MAAM,YAAY,UAAU,UAAU,EAAE;AAC9D,QAAM,QAAQ;AAAA,IACZ,MAAM,mBAAmB,UAAU,WAAW,UAAU,EAAE;AAAA,IAC1D;AAAA,IACA,QAAQ,SAAS;AAAA,EACnB,EAAE,IAAI,CAAC,cAAc;AAAA,IACnB,IAAI,aAAa,SAAS,KAAK,EAAE;AAAA,IACjC,OAAO,SAAS,KAAK;AAAA,IACrB,SAAS,SAAS,KAAK;AAAA,IACvB,MAAM;AAAA,EACR,EAAE;AAEF,SAAO,MAAM;AAAA,IACX;AAAA,IACA,MAAM,sCAAsC,UAAU,OAAO,QAAQ,KAAK;AAAA,IAC1E;AAAA,EACF;AACF;AAEA,eAAe,4BACb,UACA,KACA,SAC+B;AAC/B,QAAM,YAAY,wBAAwB,GAAG;AAE7C,UAAQ,UAAU,MAAM;AAAA,IACtB,KAAK,WAAW;AACd,YAAM,IAAI,MAAM,2CAA2C,GAAG,EAAE;AAAA,IAClE;AAAA,IACA,KAAK;AACH,wBAAkB,QAAQ,MAAM,GAAG;AACnC,aAAO,qBAAqB,CAAC,GAAG,OAAO;AAAA,IACzC,KAAK,SAAS;AACZ,wBAAkB,QAAQ,MAAM,GAAG;AACnC,YAAM,EAAE,UAAU,IAAI,MAAM,YAAY,UAAU,UAAU,EAAE;AAE9D,UACE,UAAU,cAAc,UACxB,UAAU,cAAc,WACxB;AACA,cAAM,IAAI,MAAM,SAAS,GAAG,iCAAiC;AAAA,MAC/D;AAEA,YAAM,QAAQ;AAAA,QACZ,MAAM,mBAAmB,UAAU,WAAW,UAAU,EAAE;AAAA,QAC1D,MAAM,SAAS,QAAQ,mBAAmB;AAAA,QAC1C,QAAQ,SAAS;AAAA,MACnB,EAAE,IAAI,CAAC,cAAc;AAAA,QACnB,IAAI,aAAa,SAAS,KAAK,EAAE;AAAA,QACjC,OAAO,SAAS,KAAK;AAAA,QACrB,SAAS,SAAS,KAAK;AAAA,QACvB,MAAM;AAAA,MACR,EAAE;AAEF,aAAO,MAAM;AAAA,QACX;AAAA,QACA,MAAM;AAAA,UACJ;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,QACV;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IACA,KAAK,eAAe;AAClB,yBAAmB,QAAQ,OAAO,GAAG;AACrC,wBAAkB,QAAQ,MAAM,GAAG;AACnC,YAAM,UAAU,MAAM,eAAe,UAAU,UAAU,SAAS;AAElE,aAAO,MAAM;AAAA,QACX;AAAA,QACA;AAAA,UACE;AAAA,YACE,IAAI,gBAAgB,UAAU,SAAS;AAAA,YACvC,OAAO,QAAQ,SAAS,YAAY,UAAU,SAAS;AAAA,YACvD,SAAS,GAAG,QAAQ,KAAK,KAAK,QAAQ,aAAa;AAAA,YACnD,MAAM;AAAA,UACR;AAAA,QACF;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IACA,KAAK;AACH,aAAO,MAAM,yBAAyB,UAAU,WAAW,OAAO;AAAA,IACpE,KAAK;AACH,YAAM,IAAI;AAAA,QACR,2DAA2D,GAAG;AAAA,MAChE;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,yBAAmB,QAAQ,OAAO,GAAG;AACrC,wBAAkB,QAAQ,MAAM,GAAG;AACnC,aAAO,qBAAqB,CAAC,GAAG,OAAO;AAAA,EAC3C;AACF;AAEA,SAAS,kBACP,MACA,IACM;AACN,MAAI,SAAS,UAAa,SAAS,OAAO;AACxC,UAAM,IAAI,MAAM,gDAAgD,EAAE,EAAE;AAAA,EACtE;AACF;AAEA,SAAS,mBAAmB,OAA2B,IAAkB;AACvE,MAAI,UAAU,QAAW;AACvB,UAAM,IAAI;AAAA,MACR,yDAAyD,EAAE;AAAA,IAC7D;AAAA,EACF;AACF;","names":["reference","chapterId"]}

package/dist/retrieval/query/archive-view/related/entity.d.ts

@@ -0,0 +1,33 @@
+import { ReadonlyDocument } from '../../../../document/directory/types.js';
+import { WikiGraphReference } from '../references.js';
+import { ArchiveRelatedOptions, ArchiveRelatedResult } from '../types.js';
+import '../../../../text/source/meta.js';
+import 'zod';
+import '../../../../text/source/toc.js';
+import '../../../../text/source/types.js';
+import '../../../../document/database.js';
+import 'sqlite3';
+import '../../../../document/types.js';
+import '../../../../document/text-streams/serial.js';
+import '../../../../document/text-streams/draft.js';
+import '../../../../document/text-streams/types.js';
+import '../../../../document/stores/chunk.js';
+import '../../../../document/stores/types.js';
+import '../../../../document/stores/fragment-group.js';
+import '../../../../document/stores/graph-build-parameter.js';
+import '../../../../document/stores/mention-link.js';
+import '../../../../document/stores/mention.js';
+import '../../../../document/stores/object-metadata.js';
+import '../../../../document/stores/reading-edge.js';
+import '../../../../document/stores/serial.js';
+import '../../../../document/stores/snake/chunk.js';
+import '../../../../document/stores/snake/core.js';
+import '../../../../document/stores/snake/edge.js';
+import '../../../../graph/reading.js';
+import '../../../../document/chapter/types.js';
+
+declare function listRelatedEntityObjects(document: ReadonlyDocument, reference: Extract<WikiGraphReference, {
+    readonly type: "entity";
+}>, options: ArchiveRelatedOptions): Promise<ArchiveRelatedResult>;
+
+export { listRelatedEntityObjects };