wiki-graph-core 0.3.1 → 0.4.1

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

@@ -0,0 +1,289 @@
+import { listChapters } from "../../../document/chapter/index.js";
+import {
+  createMentionLexicalHits,
+  scoreLexicalText
+} from "../lexical-search.js";
+import {
+  aggregateEvidenceScores,
+  ARCHIVE_ROOT_ID,
+  compareArchivePositions,
+  compareFindEvidenceHits,
+  createFindMatchFields,
+  createNodePosition,
+  createSnippet,
+  getSnippetNeedle,
+  isDefined,
+  matchText
+} from "./helpers.js";
+import { formatNodeId, formatTextStreamRangeUri } from "./references.js";
+import { createTextStreamIndex } from "./text-streams.js";
+import { formatTripleUri, getMentionForTripleSearch } from "./knowledge.js";
+function findEntities(search, context) {
+  const candidatesByQid = /* @__PURE__ */ new Map();
+  for (const { match, mention } of createMentionLexicalHits(
+    context.mentions,
+    search
+  )) {
+    const candidates = candidatesByQid.get(mention.qid) ?? [];
+    candidates.push({
+      hit: {
+        chapter: mention.chapterId,
+        field: "title",
+        id: `wikg://entity/${mention.qid}`,
+        ...createFindMatchFields(match),
+        position: {
+          chapter: mention.chapterId,
+          sentence: mention.sentenceIndex ?? 0
+        },
+        snippet: mention.note ?? mention.surface,
+        title: mention.surface,
+        type: "entity"
+      },
+      mention
+    });
+    candidatesByQid.set(mention.qid, candidates);
+  }
+  return [...candidatesByQid.values()].map((candidates) => {
+    const rankedCandidates = [...candidates].sort((left, right) => {
+      const scoreComparison = (right.hit.score ?? 0) - (left.hit.score ?? 0);
+      if (scoreComparison !== 0) {
+        return scoreComparison;
+      }
+      if (left.hit.position === void 0) {
+        return right.hit.position === void 0 ? 0 : 1;
+      }
+      if (right.hit.position === void 0) {
+        return -1;
+      }
+      return compareArchivePositions(left.hit.position, right.hit.position);
+    });
+    const [best] = rankedCandidates;
+    if (best === void 0) {
+      throw new Error("Internal error: entity search candidate is empty.");
+    }
+    return {
+      ...best.hit,
+      score: aggregateEvidenceScores(
+        rankedCandidates.map((candidate) => candidate.hit.score ?? 0)
+      ),
+      evidenceMentions: rankedCandidates.map((candidate) => ({
+        match: {
+          matchCount: candidate.hit.matchCount ?? 0,
+          matchedTerms: candidate.hit.matchedTerms ?? [],
+          missingTerms: candidate.hit.missingTerms ?? [],
+          score: candidate.hit.score ?? 0
+        },
+        mention: candidate.mention
+      }))
+    };
+  });
+}
+async function findTriples(document, search, context) {
+  const mentionsById = new Map(
+    context.mentions.map((mention) => [mention.id, mention])
+  );
+  const hitsByTriple = /* @__PURE__ */ new Map();
+  for (const link of await document.mentionLinks.listAll()) {
+    if (!mentionsById.has(link.sourceMentionId) && !mentionsById.has(link.targetMentionId) && scoreLexicalText(link.predicate, search) === void 0) {
+      continue;
+    }
+    const [source, target] = await Promise.all([
+      getMentionForTripleSearch(document, mentionsById, link.sourceMentionId),
+      getMentionForTripleSearch(document, mentionsById, link.targetMentionId)
+    ]);
+    if (source === void 0 || target === void 0) {
+      continue;
+    }
+    const text = `${source.surface} ${link.predicate} ${target.surface}`;
+    const match = scoreLexicalText(text, search);
+    if (match === void 0) {
+      continue;
+    }
+    const id = formatTripleUri(source.qid, link.predicate, target.qid);
+    const next = {
+      chapter: source.chapterId,
+      evidenceLinks: [link],
+      field: "content",
+      id,
+      ...createFindMatchFields(match),
+      position: {
+        chapter: source.chapterId,
+        sentence: source.sentenceIndex ?? 0
+      },
+      snippet: link.note ?? text,
+      title: text,
+      triple: {
+        objectLabel: target.surface,
+        predicate: link.predicate,
+        subjectLabel: source.surface
+      },
+      type: "triple"
+    };
+    const values = hitsByTriple.get(id) ?? [];
+    values.push(next);
+    hitsByTriple.set(id, values);
+  }
+  return [...hitsByTriple.values()].map(groupTripleEvidenceHits);
+}
+function groupTripleEvidenceHits(evidenceHits) {
+  const rankedHits = [...evidenceHits].sort(compareFindEvidenceHits);
+  const [best] = rankedHits;
+  if (best === void 0) {
+    throw new Error("Internal error: triple search candidate is empty.");
+  }
+  return {
+    ...best,
+    evidenceLinks: rankedHits.flatMap((hit) => hit.evidenceLinks ?? []),
+    score: aggregateEvidenceScores(rankedHits.map((hit) => hit.score ?? 0))
+  };
+}
+function filterLexicalHitsByMatch(hits, search, match) {
+  if (match === "any") {
+    return hits;
+  }
+  const requiredTerms = [...search.phrases];
+  if (requiredTerms.length === 0) {
+    return hits;
+  }
+  return hits.filter(
+    (hit) => requiredTerms.every((term) => hit.matchedTerms?.includes(term) === true)
+  );
+}
+async function findChapters(document, search) {
+  const hits = [];
+  for (const chapter of await listChapters(document)) {
+    const title = chapter.title ?? chapter.uri;
+    const titleMatch = matchText(title, search);
+    if (titleMatch !== void 0) {
+      hits.push({
+        chapter: chapter.chapterId,
+        field: "title",
+        id: `${chapter.uri}/title`,
+        ...createFindMatchFields(titleMatch),
+        position: {
+          chapter: chapter.chapterId
+        },
+        snippet: title,
+        title,
+        type: "chapter-title"
+      });
+    }
+    hits.push(
+      ...await findTextStreamSentences(
+        document,
+        chapter.chapterId,
+        "summary",
+        title,
+        search
+      )
+    );
+    hits.push(
+      ...await findTextStreamSentences(
+        document,
+        chapter.chapterId,
+        "source",
+        title,
+        search
+      )
+    );
+  }
+  return hits;
+}
+async function findTextStreamSentences(document, chapterId, stream, title, search) {
+  const index = await createTextStreamIndex(document, chapterId, stream);
+  return index.sentences.flatMap((sentence) => {
+    const match = matchText(sentence.text, search);
+    if (match === void 0) {
+      return [];
+    }
+    return [
+      {
+        chapter: chapterId,
+        field: stream,
+        id: formatTextStreamRangeUri(
+          chapterId,
+          stream,
+          sentence.globalIndex,
+          sentence.globalIndex
+        ),
+        ...createFindMatchFields(match),
+        position: {
+          chapter: chapterId,
+          fragment: sentence.fragmentId,
+          sentence: sentence.localIndex
+        },
+        snippet: createSnippet(sentence.text, getSnippetNeedle(match)),
+        title,
+        type: stream === "source" ? "source" : "summary"
+      }
+    ];
+  });
+}
+function findMeta(meta, search) {
+  if (meta === void 0) {
+    return [];
+  }
+  const fields = [
+    meta.title,
+    ...meta.authors,
+    meta.description,
+    meta.publisher
+  ].filter(isDefined);
+  const content = fields.join("\n");
+  const contentMatch = matchText(content, search);
+  if (contentMatch === void 0) {
+    return [];
+  }
+  return [
+    {
+      field: "metadata",
+      id: ARCHIVE_ROOT_ID,
+      ...createFindMatchFields(contentMatch),
+      snippet: createSnippet(content, getSnippetNeedle(contentMatch)),
+      title: meta.title ?? "Archive metadata",
+      type: "meta"
+    }
+  ];
+}
+async function findNodes(document, search) {
+  const hits = [];
+  for (const node of await document.chunks.listAll()) {
+    const position = createNodePosition(node.sentenceIds);
+    const labelMatch = matchText(node.label, search);
+    if (labelMatch !== void 0) {
+      hits.push({
+        chapter: node.sentenceId[0],
+        field: "title",
+        id: formatNodeId(node.id),
+        ...createFindMatchFields(labelMatch),
+        ...position === void 0 ? {} : { position },
+        snippet: node.label,
+        title: node.label,
+        type: "node"
+      });
+    }
+    const contentMatch = matchText(node.content, search);
+    if (contentMatch !== void 0) {
+      hits.push({
+        chapter: node.sentenceId[0],
+        field: "content",
+        id: formatNodeId(node.id),
+        ...createFindMatchFields(contentMatch),
+        ...position === void 0 ? {} : { position },
+        snippet: createSnippet(node.content, getSnippetNeedle(contentMatch)),
+        title: node.label,
+        type: "node"
+      });
+    }
+  }
+  return hits;
+}
+export {
+  filterLexicalHitsByMatch,
+  findChapters,
+  findEntities,
+  findMeta,
+  findNodes,
+  findTriples
+};
+//# sourceMappingURL=find.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/retrieval/query/archive-view/find.ts"],"sourcesContent":["import type {\n  MentionRecord,\n  ReadonlyDocument,\n} from \"../../../document/index.js\";\nimport type { BookMeta } from \"../../../text/source/index.js\";\nimport { listChapters } from \"../../../document/chapter/index.js\";\n\nimport {\n  createMentionLexicalHits,\n  scoreLexicalText,\n  type LexicalQuery,\n} from \"../lexical-search.js\";\nimport {\n  aggregateEvidenceScores,\n  ARCHIVE_ROOT_ID,\n  compareArchivePositions,\n  compareFindEvidenceHits,\n  createFindMatchFields,\n  createNodePosition,\n  createSnippet,\n  getSnippetNeedle,\n  isDefined,\n  matchText,\n} from \"./helpers.js\";\nimport type { ArchiveTextSearch } from \"./helpers.js\";\nimport { formatNodeId, formatTextStreamRangeUri } from \"./references.js\";\nimport { createTextStreamIndex } from \"./text-streams.js\";\nimport type {\n  ArchiveFindHit,\n  ArchiveFindMatch,\n  ArchiveTextStreamKind,\n} from \"./types.js\";\nimport { formatTripleUri, getMentionForTripleSearch } from \"./knowledge.js\";\n\nexport function findEntities(\n  search: LexicalQuery,\n  context: {\n    readonly mentions: readonly MentionRecord[];\n  },\n): readonly ArchiveFindHit[] {\n  const candidatesByQid = new Map<\n    string,\n    Array<{\n      readonly hit: ArchiveFindHit;\n      readonly mention: MentionRecord;\n    }>\n  >();\n\n  for (const { match, mention } of createMentionLexicalHits(\n    context.mentions,\n    search,\n  )) {\n    const candidates = candidatesByQid.get(mention.qid) ?? [];\n\n    candidates.push({\n      hit: {\n        chapter: mention.chapterId,\n        field: \"title\" as const,\n        id: `wikg://entity/${mention.qid}`,\n        ...createFindMatchFields(match),\n        position: {\n          chapter: mention.chapterId,\n          sentence: mention.sentenceIndex ?? 0,\n        },\n        snippet: mention.note ?? mention.surface,\n        title: mention.surface,\n        type: \"entity\" as const,\n      },\n      mention,\n    });\n    candidatesByQid.set(mention.qid, candidates);\n  }\n\n  return [...candidatesByQid.values()].map((candidates) => {\n    const rankedCandidates = [...candidates].sort((left, right) => {\n      const scoreComparison = (right.hit.score ?? 0) - (left.hit.score ?? 0);\n\n      if (scoreComparison !== 0) {\n        return scoreComparison;\n      }\n      if (left.hit.position === undefined) {\n        return right.hit.position === undefined ? 0 : 1;\n      }\n      if (right.hit.position === undefined) {\n        return -1;\n      }\n      return compareArchivePositions(left.hit.position, right.hit.position);\n    });\n    const [best] = rankedCandidates;\n\n    if (best === undefined) {\n      throw new Error(\"Internal error: entity search candidate is empty.\");\n    }\n\n    return {\n      ...best.hit,\n      score: aggregateEvidenceScores(\n        rankedCandidates.map((candidate) => candidate.hit.score ?? 0),\n      ),\n      evidenceMentions: rankedCandidates.map((candidate) => ({\n        match: {\n          matchCount: candidate.hit.matchCount ?? 0,\n          matchedTerms: candidate.hit.matchedTerms ?? [],\n          missingTerms: candidate.hit.missingTerms ?? [],\n          score: candidate.hit.score ?? 0,\n        },\n        mention: candidate.mention,\n      })),\n    };\n  });\n}\n\nexport async function findTriples(\n  document: ReadonlyDocument,\n  search: LexicalQuery,\n  context: {\n    readonly mentions: readonly MentionRecord[];\n  },\n): Promise<readonly ArchiveFindHit[]> {\n  const mentionsById = new Map(\n    context.mentions.map((mention) => [mention.id, mention]),\n  );\n  const hitsByTriple = new Map<string, ArchiveFindHit[]>();\n\n  for (const link of await document.mentionLinks.listAll()) {\n    if (\n      !mentionsById.has(link.sourceMentionId) &&\n      !mentionsById.has(link.targetMentionId) &&\n      scoreLexicalText(link.predicate, search) === undefined\n    ) {\n      continue;\n    }\n\n    const [source, target] = await Promise.all([\n      getMentionForTripleSearch(document, mentionsById, link.sourceMentionId),\n      getMentionForTripleSearch(document, mentionsById, link.targetMentionId),\n    ]);\n\n    if (source === undefined || target === undefined) {\n      continue;\n    }\n\n    const text = `${source.surface} ${link.predicate} ${target.surface}`;\n    const match = scoreLexicalText(text, search);\n\n    if (match === undefined) {\n      continue;\n    }\n\n    const id = formatTripleUri(source.qid, link.predicate, target.qid);\n    const next = {\n      chapter: source.chapterId,\n      evidenceLinks: [link],\n      field: \"content\" as const,\n      id,\n      ...createFindMatchFields(match),\n      position: {\n        chapter: source.chapterId,\n        sentence: source.sentenceIndex ?? 0,\n      },\n      snippet: link.note ?? text,\n      title: text,\n      triple: {\n        objectLabel: target.surface,\n        predicate: link.predicate,\n        subjectLabel: source.surface,\n      },\n      type: \"triple\" as const,\n    };\n    const values = hitsByTriple.get(id) ?? [];\n\n    values.push(next);\n    hitsByTriple.set(id, values);\n  }\n\n  return [...hitsByTriple.values()].map(groupTripleEvidenceHits);\n}\n\nfunction groupTripleEvidenceHits(\n  evidenceHits: readonly ArchiveFindHit[],\n): ArchiveFindHit {\n  const rankedHits = [...evidenceHits].sort(compareFindEvidenceHits);\n  const [best] = rankedHits;\n\n  if (best === undefined) {\n    throw new Error(\"Internal error: triple search candidate is empty.\");\n  }\n\n  return {\n    ...best,\n    evidenceLinks: rankedHits.flatMap((hit) => hit.evidenceLinks ?? []),\n    score: aggregateEvidenceScores(rankedHits.map((hit) => hit.score ?? 0)),\n  };\n}\n\nexport function filterLexicalHitsByMatch(\n  hits: readonly ArchiveFindHit[],\n  search: LexicalQuery,\n  match: ArchiveFindMatch,\n): readonly ArchiveFindHit[] {\n  if (match === \"any\") {\n    return hits;\n  }\n\n  const requiredTerms = [...search.phrases];\n\n  if (requiredTerms.length === 0) {\n    return hits;\n  }\n\n  return hits.filter((hit) =>\n    requiredTerms.every((term) => hit.matchedTerms?.includes(term) === true),\n  );\n}\n\nexport async function findChapters(\n  document: ReadonlyDocument,\n  search: ArchiveTextSearch,\n): Promise<readonly ArchiveFindHit[]> {\n  const hits: ArchiveFindHit[] = [];\n\n  for (const chapter of await listChapters(document)) {\n    const title = chapter.title ?? chapter.uri;\n    const titleMatch = matchText(title, search);\n\n    if (titleMatch !== undefined) {\n      hits.push({\n        chapter: chapter.chapterId,\n        field: \"title\",\n        id: `${chapter.uri}/title`,\n        ...createFindMatchFields(titleMatch),\n        position: {\n          chapter: chapter.chapterId,\n        },\n        snippet: title,\n        title,\n        type: \"chapter-title\",\n      });\n    }\n\n    hits.push(\n      ...(await findTextStreamSentences(\n        document,\n        chapter.chapterId,\n        \"summary\",\n        title,\n        search,\n      )),\n    );\n\n    hits.push(\n      ...(await findTextStreamSentences(\n        document,\n        chapter.chapterId,\n        \"source\",\n        title,\n        search,\n      )),\n    );\n  }\n\n  return hits;\n}\n\nasync function findTextStreamSentences(\n  document: ReadonlyDocument,\n  chapterId: number,\n  stream: ArchiveTextStreamKind,\n  title: string,\n  search: ArchiveTextSearch,\n): Promise<readonly ArchiveFindHit[]> {\n  const index = await createTextStreamIndex(document, chapterId, stream);\n\n  return index.sentences.flatMap((sentence) => {\n    const match = matchText(sentence.text, search);\n\n    if (match === undefined) {\n      return [];\n    }\n\n    return [\n      {\n        chapter: chapterId,\n        field: stream,\n        id: formatTextStreamRangeUri(\n          chapterId,\n          stream,\n          sentence.globalIndex,\n          sentence.globalIndex,\n        ),\n        ...createFindMatchFields(match),\n        position: {\n          chapter: chapterId,\n          fragment: sentence.fragmentId,\n          sentence: sentence.localIndex,\n        },\n        snippet: createSnippet(sentence.text, getSnippetNeedle(match)),\n        title,\n        type: stream === \"source\" ? (\"source\" as const) : (\"summary\" as const),\n      },\n    ];\n  });\n}\n\nexport function findMeta(\n  meta: BookMeta | undefined,\n  search: ArchiveTextSearch,\n): readonly ArchiveFindHit[] {\n  if (meta === undefined) {\n    return [];\n  }\n\n  const fields = [\n    meta.title,\n    ...meta.authors,\n    meta.description,\n    meta.publisher,\n  ].filter(isDefined);\n  const content = fields.join(\"\\n\");\n  const contentMatch = matchText(content, search);\n\n  if (contentMatch === undefined) {\n    return [];\n  }\n\n  return [\n    {\n      field: \"metadata\",\n      id: ARCHIVE_ROOT_ID,\n      ...createFindMatchFields(contentMatch),\n      snippet: createSnippet(content, getSnippetNeedle(contentMatch)),\n      title: meta.title ?? \"Archive metadata\",\n      type: \"meta\",\n    },\n  ];\n}\n\nexport async function findNodes(\n  document: ReadonlyDocument,\n  search: ArchiveTextSearch,\n): Promise<readonly ArchiveFindHit[]> {\n  const hits: ArchiveFindHit[] = [];\n\n  for (const node of await document.chunks.listAll()) {\n    const position = createNodePosition(node.sentenceIds);\n    const labelMatch = matchText(node.label, search);\n\n    if (labelMatch !== undefined) {\n      hits.push({\n        chapter: node.sentenceId[0],\n        field: \"title\",\n        id: formatNodeId(node.id),\n        ...createFindMatchFields(labelMatch),\n        ...(position === undefined ? {} : { position }),\n        snippet: node.label,\n        title: node.label,\n        type: \"node\",\n      });\n    }\n    const contentMatch = matchText(node.content, search);\n\n    if (contentMatch !== undefined) {\n      hits.push({\n        chapter: node.sentenceId[0],\n        field: \"content\",\n        id: formatNodeId(node.id),\n        ...createFindMatchFields(contentMatch),\n        ...(position === undefined ? {} : { position }),\n        snippet: createSnippet(node.content, getSnippetNeedle(contentMatch)),\n        title: node.label,\n        type: \"node\",\n      });\n    }\n  }\n\n  return hits;\n}\n"],"mappings":"AAKA,SAAS,oBAAoB;AAE7B;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,cAAc,gCAAgC;AACvD,SAAS,6BAA6B;AAMtC,SAAS,iBAAiB,iCAAiC;AAEpD,SAAS,aACd,QACA,SAG2B;AAC3B,QAAM,kBAAkB,oBAAI,IAM1B;AAEF,aAAW,EAAE,OAAO,QAAQ,KAAK;AAAA,IAC/B,QAAQ;AAAA,IACR;AAAA,EACF,GAAG;AACD,UAAM,aAAa,gBAAgB,IAAI,QAAQ,GAAG,KAAK,CAAC;AAExD,eAAW,KAAK;AAAA,MACd,KAAK;AAAA,QACH,SAAS,QAAQ;AAAA,QACjB,OAAO;AAAA,QACP,IAAI,iBAAiB,QAAQ,GAAG;AAAA,QAChC,GAAG,sBAAsB,KAAK;AAAA,QAC9B,UAAU;AAAA,UACR,SAAS,QAAQ;AAAA,UACjB,UAAU,QAAQ,iBAAiB;AAAA,QACrC;AAAA,QACA,SAAS,QAAQ,QAAQ,QAAQ;AAAA,QACjC,OAAO,QAAQ;AAAA,QACf,MAAM;AAAA,MACR;AAAA,MACA;AAAA,IACF,CAAC;AACD,oBAAgB,IAAI,QAAQ,KAAK,UAAU;AAAA,EAC7C;AAEA,SAAO,CAAC,GAAG,gBAAgB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe;AACvD,UAAM,mBAAmB,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,MAAM,UAAU;AAC7D,YAAM,mBAAmB,MAAM,IAAI,SAAS,MAAM,KAAK,IAAI,SAAS;AAEpE,UAAI,oBAAoB,GAAG;AACzB,eAAO;AAAA,MACT;AACA,UAAI,KAAK,IAAI,aAAa,QAAW;AACnC,eAAO,MAAM,IAAI,aAAa,SAAY,IAAI;AAAA,MAChD;AACA,UAAI,MAAM,IAAI,aAAa,QAAW;AACpC,eAAO;AAAA,MACT;AACA,aAAO,wBAAwB,KAAK,IAAI,UAAU,MAAM,IAAI,QAAQ;AAAA,IACtE,CAAC;AACD,UAAM,CAAC,IAAI,IAAI;AAEf,QAAI,SAAS,QAAW;AACtB,YAAM,IAAI,MAAM,mDAAmD;AAAA,IACrE;AAEA,WAAO;AAAA,MACL,GAAG,KAAK;AAAA,MACR,OAAO;AAAA,QACL,iBAAiB,IAAI,CAAC,cAAc,UAAU,IAAI,SAAS,CAAC;AAAA,MAC9D;AAAA,MACA,kBAAkB,iBAAiB,IAAI,CAAC,eAAe;AAAA,QACrD,OAAO;AAAA,UACL,YAAY,UAAU,IAAI,cAAc;AAAA,UACxC,cAAc,UAAU,IAAI,gBAAgB,CAAC;AAAA,UAC7C,cAAc,UAAU,IAAI,gBAAgB,CAAC;AAAA,UAC7C,OAAO,UAAU,IAAI,SAAS;AAAA,QAChC;AAAA,QACA,SAAS,UAAU;AAAA,MACrB,EAAE;AAAA,IACJ;AAAA,EACF,CAAC;AACH;AAEA,eAAsB,YACpB,UACA,QACA,SAGoC;AACpC,QAAM,eAAe,IAAI;AAAA,IACvB,QAAQ,SAAS,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,OAAO,CAAC;AAAA,EACzD;AACA,QAAM,eAAe,oBAAI,IAA8B;AAEvD,aAAW,QAAQ,MAAM,SAAS,aAAa,QAAQ,GAAG;AACxD,QACE,CAAC,aAAa,IAAI,KAAK,eAAe,KACtC,CAAC,aAAa,IAAI,KAAK,eAAe,KACtC,iBAAiB,KAAK,WAAW,MAAM,MAAM,QAC7C;AACA;AAAA,IACF;AAEA,UAAM,CAAC,QAAQ,MAAM,IAAI,MAAM,QAAQ,IAAI;AAAA,MACzC,0BAA0B,UAAU,cAAc,KAAK,eAAe;AAAA,MACtE,0BAA0B,UAAU,cAAc,KAAK,eAAe;AAAA,IACxE,CAAC;AAED,QAAI,WAAW,UAAa,WAAW,QAAW;AAChD;AAAA,IACF;AAEA,UAAM,OAAO,GAAG,OAAO,OAAO,IAAI,KAAK,SAAS,IAAI,OAAO,OAAO;AAClE,UAAM,QAAQ,iBAAiB,MAAM,MAAM;AAE3C,QAAI,UAAU,QAAW;AACvB;AAAA,IACF;AAEA,UAAM,KAAK,gBAAgB,OAAO,KAAK,KAAK,WAAW,OAAO,GAAG;AACjE,UAAM,OAAO;AAAA,MACX,SAAS,OAAO;AAAA,MAChB,eAAe,CAAC,IAAI;AAAA,MACpB,OAAO;AAAA,MACP;AAAA,MACA,GAAG,sBAAsB,KAAK;AAAA,MAC9B,UAAU;AAAA,QACR,SAAS,OAAO;AAAA,QAChB,UAAU,OAAO,iBAAiB;AAAA,MACpC;AAAA,MACA,SAAS,KAAK,QAAQ;AAAA,MACtB,OAAO;AAAA,MACP,QAAQ;AAAA,QACN,aAAa,OAAO;AAAA,QACpB,WAAW,KAAK;AAAA,QAChB,cAAc,OAAO;AAAA,MACvB;AAAA,MACA,MAAM;AAAA,IACR;AACA,UAAM,SAAS,aAAa,IAAI,EAAE,KAAK,CAAC;AAExC,WAAO,KAAK,IAAI;AAChB,iBAAa,IAAI,IAAI,MAAM;AAAA,EAC7B;AAEA,SAAO,CAAC,GAAG,aAAa,OAAO,CAAC,EAAE,IAAI,uBAAuB;AAC/D;AAEA,SAAS,wBACP,cACgB;AAChB,QAAM,aAAa,CAAC,GAAG,YAAY,EAAE,KAAK,uBAAuB;AACjE,QAAM,CAAC,IAAI,IAAI;AAEf,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,eAAe,WAAW,QAAQ,CAAC,QAAQ,IAAI,iBAAiB,CAAC,CAAC;AAAA,IAClE,OAAO,wBAAwB,WAAW,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;AAAA,EACxE;AACF;AAEO,SAAS,yBACd,MACA,QACA,OAC2B;AAC3B,MAAI,UAAU,OAAO;AACnB,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,CAAC,GAAG,OAAO,OAAO;AAExC,MAAI,cAAc,WAAW,GAAG;AAC9B,WAAO;AAAA,EACT;AAEA,SAAO,KAAK;AAAA,IAAO,CAAC,QAClB,cAAc,MAAM,CAAC,SAAS,IAAI,cAAc,SAAS,IAAI,MAAM,IAAI;AAAA,EACzE;AACF;AAEA,eAAsB,aACpB,UACA,QACoC;AACpC,QAAM,OAAyB,CAAC;AAEhC,aAAW,WAAW,MAAM,aAAa,QAAQ,GAAG;AAClD,UAAM,QAAQ,QAAQ,SAAS,QAAQ;AACvC,UAAM,aAAa,UAAU,OAAO,MAAM;AAE1C,QAAI,eAAe,QAAW;AAC5B,WAAK,KAAK;AAAA,QACR,SAAS,QAAQ;AAAA,QACjB,OAAO;AAAA,QACP,IAAI,GAAG,QAAQ,GAAG;AAAA,QAClB,GAAG,sBAAsB,UAAU;AAAA,QACnC,UAAU;AAAA,UACR,SAAS,QAAQ;AAAA,QACnB;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAEA,SAAK;AAAA,MACH,GAAI,MAAM;AAAA,QACR;AAAA,QACA,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,SAAK;AAAA,MACH,GAAI,MAAM;AAAA,QACR;AAAA,QACA,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEA,eAAe,wBACb,UACA,WACA,QACA,OACA,QACoC;AACpC,QAAM,QAAQ,MAAM,sBAAsB,UAAU,WAAW,MAAM;AAErE,SAAO,MAAM,UAAU,QAAQ,CAAC,aAAa;AAC3C,UAAM,QAAQ,UAAU,SAAS,MAAM,MAAM;AAE7C,QAAI,UAAU,QAAW;AACvB,aAAO,CAAC;AAAA,IACV;AAEA,WAAO;AAAA,MACL;AAAA,QACE,SAAS;AAAA,QACT,OAAO;AAAA,QACP,IAAI;AAAA,UACF;AAAA,UACA;AAAA,UACA,SAAS;AAAA,UACT,SAAS;AAAA,QACX;AAAA,QACA,GAAG,sBAAsB,KAAK;AAAA,QAC9B,UAAU;AAAA,UACR,SAAS;AAAA,UACT,UAAU,SAAS;AAAA,UACnB,UAAU,SAAS;AAAA,QACrB;AAAA,QACA,SAAS,cAAc,SAAS,MAAM,iBAAiB,KAAK,CAAC;AAAA,QAC7D;AAAA,QACA,MAAM,WAAW,WAAY,WAAsB;AAAA,MACrD;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEO,SAAS,SACd,MACA,QAC2B;AAC3B,MAAI,SAAS,QAAW;AACtB,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,SAAS;AAAA,IACb,KAAK;AAAA,IACL,GAAG,KAAK;AAAA,IACR,KAAK;AAAA,IACL,KAAK;AAAA,EACP,EAAE,OAAO,SAAS;AAClB,QAAM,UAAU,OAAO,KAAK,IAAI;AAChC,QAAM,eAAe,UAAU,SAAS,MAAM;AAE9C,MAAI,iBAAiB,QAAW;AAC9B,WAAO,CAAC;AAAA,EACV;AAEA,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,IAAI;AAAA,MACJ,GAAG,sBAAsB,YAAY;AAAA,MACrC,SAAS,cAAc,SAAS,iBAAiB,YAAY,CAAC;AAAA,MAC9D,OAAO,KAAK,SAAS;AAAA,MACrB,MAAM;AAAA,IACR;AAAA,EACF;AACF;AAEA,eAAsB,UACpB,UACA,QACoC;AACpC,QAAM,OAAyB,CAAC;AAEhC,aAAW,QAAQ,MAAM,SAAS,OAAO,QAAQ,GAAG;AAClD,UAAM,WAAW,mBAAmB,KAAK,WAAW;AACpD,UAAM,aAAa,UAAU,KAAK,OAAO,MAAM;AAE/C,QAAI,eAAe,QAAW;AAC5B,WAAK,KAAK;AAAA,QACR,SAAS,KAAK,WAAW,CAAC;AAAA,QAC1B,OAAO;AAAA,QACP,IAAI,aAAa,KAAK,EAAE;AAAA,QACxB,GAAG,sBAAsB,UAAU;AAAA,QACnC,GAAI,aAAa,SAAY,CAAC,IAAI,EAAE,SAAS;AAAA,QAC7C,SAAS,KAAK;AAAA,QACd,OAAO,KAAK;AAAA,QACZ,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AACA,UAAM,eAAe,UAAU,KAAK,SAAS,MAAM;AAEnD,QAAI,iBAAiB,QAAW;AAC9B,WAAK,KAAK;AAAA,QACR,SAAS,KAAK,WAAW,CAAC;AAAA,QAC1B,OAAO;AAAA,QACP,IAAI,aAAa,KAAK,EAAE;AAAA,QACxB,GAAG,sBAAsB,YAAY;AAAA,QACrC,GAAI,aAAa,SAAY,CAAC,IAAI,EAAE,SAAS;AAAA,QAC7C,SAAS,cAAc,KAAK,SAAS,iBAAiB,YAAY,CAAC;AAAA,QACnE,OAAO,KAAK;AAAA,QACZ,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/retrieval/query/archive-view/helper/constants.d.ts

@@ -0,0 +1,15 @@
+declare const DEFAULT_FIND_LIMIT = 20;
+declare const TEXT_ONLY_SEARCH_CACHE_WINDOW = 100;
+declare const ARCHIVE_ROOT_ID = "meta:root";
+declare const BROAD_FIND_LENS_HINT: {
+    lenses: {
+        chapter: string;
+        chunk: string;
+        entity: string;
+        node: string;
+        triple: string;
+    };
+    message: string;
+};
+
+export { ARCHIVE_ROOT_ID, BROAD_FIND_LENS_HINT, DEFAULT_FIND_LIMIT, TEXT_ONLY_SEARCH_CACHE_WINDOW };

package/dist/retrieval/query/archive-view/helper/constants.js

@@ -0,0 +1,20 @@
+const DEFAULT_FIND_LIMIT = 20;
+const TEXT_ONLY_SEARCH_CACHE_WINDOW = 100;
+const ARCHIVE_ROOT_ID = "meta:root";
+const BROAD_FIND_LENS_HINT = {
+  lenses: {
+    chapter: "book outline and chapter titles",
+    chunk: "source text ranges",
+    entity: "indexed entities",
+    node: "topology / LLM Wiki structure",
+    triple: "knowledge graph statements"
+  },
+  message: "Choose scope URI lenses such as /chapter, /chunk, /entity, or /triple for broad search."
+};
+export {
+  ARCHIVE_ROOT_ID,
+  BROAD_FIND_LENS_HINT,
+  DEFAULT_FIND_LIMIT,
+  TEXT_ONLY_SEARCH_CACHE_WINDOW
+};
+//# sourceMappingURL=constants.js.map

package/dist/retrieval/query/archive-view/helper/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/retrieval/query/archive-view/helper/constants.ts"],"sourcesContent":["import type { ArchiveFindLensHint } from \"../types.js\";\n\nexport const DEFAULT_FIND_LIMIT = 20;\nexport const TEXT_ONLY_SEARCH_CACHE_WINDOW = 100;\nexport const ARCHIVE_ROOT_ID = \"meta:root\";\n\nexport const BROAD_FIND_LENS_HINT = {\n  lenses: {\n    chapter: \"book outline and chapter titles\",\n    chunk: \"source text ranges\",\n    entity: \"indexed entities\",\n    node: \"topology / LLM Wiki structure\",\n    triple: \"knowledge graph statements\",\n  },\n  message:\n    \"Choose scope URI lenses such as /chapter, /chunk, /entity, or /triple for broad search.\",\n} satisfies ArchiveFindLensHint;\n"],"mappings":"AAEO,MAAM,qBAAqB;AAC3B,MAAM,gCAAgC;AACtC,MAAM,kBAAkB;AAExB,MAAM,uBAAuB;AAAA,EAClC,QAAQ;AAAA,IACN,SAAS;AAAA,IACT,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,QAAQ;AAAA,EACV;AAAA,EACA,SACE;AACJ;","names":[]}

package/dist/retrieval/query/archive-view/helper/index.d.ts

@@ -0,0 +1,34 @@
+export { ARCHIVE_ROOT_ID, BROAD_FIND_LENS_HINT, DEFAULT_FIND_LIMIT, TEXT_ONLY_SEARCH_CACHE_WINDOW } from './constants.js';
+export { createMetaPage, createSnippet, formatMetaSummary, formatMetaText, formatMetaTitle, formatWeight, isDefined } from './meta.js';
+export { createSearchTerms, decodeFindCursor, encodeFindCursor, isCollectionType, isFindCursor, isFindFilterType, parseFindLens, parseFindMatch, parseFindTypes } from './parse.js';
+export { compareArchivePositions, compareNumbers, compareSentenceIds, createNodePosition, createSentencePosition, getPositionChapter, getPositionDocumentOrder, getPositionFragment, getPositionSentence, getTypeOrder } from './position.js';
+export { createCollectionResult, createFindResult, createRankedFindResult, groupFindHitsByObject, groupObjectEvidenceHits, matchesCollectionType, matchesFindChapter, matchesFindId, matchesFindType, matchesTriplePattern, mergeStringLists, parseTripleHitUri } from './results.js';
+export { compareListBucketItems, compareListHits, compareListPosition, compareSearchHits, getListBucket, getSearchBucket } from './sort.js';
+export { ArchiveTextMatch, ArchiveTextSearch, aggregateEvidenceScores, calculateEvidenceDecayBase, compareFindEvidenceHits, createFindMatchFields, createPhraseSearch, getSnippetNeedle, matchText } from './text.js';
+export { isWikiGraphObjectUri, normalizeWikiGraphObjectUri } from './uri.js';
+import '../../../../text/source/meta.js';
+import 'zod';
+import '../types.js';
+import '../../../../document/types.js';
+import '../../../../graph/reading.js';
+import '../../../../document/directory/types.js';
+import '../../../../text/source/toc.js';
+import '../../../../text/source/types.js';
+import '../../../../document/database.js';
+import 'sqlite3';
+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 '../../../../document/chapter/types.js';

package/dist/retrieval/query/archive-view/helper/index.js

@@ -0,0 +1,9 @@
+export * from "./constants.js";
+export * from "./meta.js";
+export * from "./parse.js";
+export * from "./position.js";
+export * from "./results.js";
+export * from "./sort.js";
+export * from "./text.js";
+export * from "./uri.js";
+//# sourceMappingURL=index.js.map

package/dist/retrieval/query/archive-view/helper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/retrieval/query/archive-view/helper/index.ts"],"sourcesContent":["export * from \"./constants.js\";\nexport * from \"./meta.js\";\nexport * from \"./parse.js\";\nexport * from \"./position.js\";\nexport * from \"./results.js\";\nexport * from \"./sort.js\";\nexport * from \"./text.js\";\nexport * from \"./uri.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/retrieval/query/archive-view/helper/meta.d.ts

@@ -0,0 +1,17 @@
+import { BookMeta } from '../../../../text/source/meta.js';
+import 'zod';
+
+declare function createSnippet(value: string, needle?: string): string;
+declare function formatMetaSummary(meta: BookMeta | undefined): string;
+declare function formatMetaTitle(meta: BookMeta | undefined): string;
+declare function createMetaPage(meta: BookMeta | undefined): {
+    readonly authors?: readonly string[];
+    readonly description?: string;
+    readonly publisher?: string;
+    readonly title: string;
+};
+declare function formatMetaText(meta: BookMeta | undefined): string;
+declare function formatWeight(weight: number): string;
+declare function isDefined<T>(value: T | undefined | null): value is T;
+
+export { createMetaPage, createSnippet, formatMetaSummary, formatMetaText, formatMetaTitle, formatWeight, isDefined };

package/dist/retrieval/query/archive-view/helper/meta.js

@@ -0,0 +1,57 @@
+function createSnippet(value, needle) {
+  const collapsed = value.replace(/\s+/g, " ").trim();
+  if (needle === void 0) {
+    return collapsed.length > 180 ? `${collapsed.slice(0, 177)}...` : collapsed;
+  }
+  const index = collapsed.toLowerCase().indexOf(needle);
+  if (index < 0) {
+    return collapsed.length > 180 ? `${collapsed.slice(0, 177)}...` : collapsed;
+  }
+  const start = Math.max(0, index - 60);
+  const end = Math.min(collapsed.length, index + needle.length + 120);
+  const prefix = start === 0 ? "" : "...";
+  const suffix = end === collapsed.length ? "" : "...";
+  return `${prefix}${collapsed.slice(start, end)}${suffix}`;
+}
+function formatMetaSummary(meta) {
+  if (meta === void 0) {
+    return "[missing]";
+  }
+  return [meta.title, meta.authors.join(", "), meta.publisher].filter((value) => value !== null && value !== "").join(" / ");
+}
+function formatMetaTitle(meta) {
+  return meta?.title ?? "Archive metadata";
+}
+function createMetaPage(meta) {
+  return {
+    ...meta?.authors === void 0 || meta.authors.length === 0 ? {} : { authors: meta.authors },
+    ...meta?.description === void 0 || meta.description === null ? {} : { description: meta.description },
+    ...meta?.publisher === void 0 || meta.publisher === null ? {} : { publisher: meta.publisher },
+    title: formatMetaTitle(meta)
+  };
+}
+function formatMetaText(meta) {
+  const page = createMetaPage(meta);
+  return [
+    `title: ${page.title}`,
+    page.authors === void 0 ? void 0 : `authors: ${page.authors.join(", ")}`,
+    page.publisher === void 0 ? void 0 : `publisher: ${page.publisher}`,
+    page.description === void 0 ? void 0 : `description: ${page.description}`
+  ].filter(isDefined).join("\n");
+}
+function formatWeight(weight) {
+  return Number.isInteger(weight) ? String(weight) : weight.toFixed(3);
+}
+function isDefined(value) {
+  return value !== void 0 && value !== null;
+}
+export {
+  createMetaPage,
+  createSnippet,
+  formatMetaSummary,
+  formatMetaText,
+  formatMetaTitle,
+  formatWeight,
+  isDefined
+};
+//# sourceMappingURL=meta.js.map

package/dist/retrieval/query/archive-view/helper/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/retrieval/query/archive-view/helper/meta.ts"],"sourcesContent":["import type { BookMeta } from \"../../../../text/source/index.js\";\n\nexport function createSnippet(value: string, needle?: string): string {\n  const collapsed = value.replace(/\\s+/g, \" \").trim();\n\n  if (needle === undefined) {\n    return collapsed.length > 180 ? `${collapsed.slice(0, 177)}...` : collapsed;\n  }\n\n  const index = collapsed.toLowerCase().indexOf(needle);\n\n  if (index < 0) {\n    return collapsed.length > 180 ? `${collapsed.slice(0, 177)}...` : collapsed;\n  }\n\n  const start = Math.max(0, index - 60);\n  const end = Math.min(collapsed.length, index + needle.length + 120);\n  const prefix = start === 0 ? \"\" : \"...\";\n  const suffix = end === collapsed.length ? \"\" : \"...\";\n\n  return `${prefix}${collapsed.slice(start, end)}${suffix}`;\n}\n\nexport function formatMetaSummary(meta: BookMeta | undefined): string {\n  if (meta === undefined) {\n    return \"[missing]\";\n  }\n\n  return [meta.title, meta.authors.join(\", \"), meta.publisher]\n    .filter((value) => value !== null && value !== \"\")\n    .join(\" / \");\n}\n\nexport function formatMetaTitle(meta: BookMeta | undefined): string {\n  return meta?.title ?? \"Archive metadata\";\n}\n\nexport function createMetaPage(meta: BookMeta | undefined): {\n  readonly authors?: readonly string[];\n  readonly description?: string;\n  readonly publisher?: string;\n  readonly title: string;\n} {\n  return {\n    ...(meta?.authors === undefined || meta.authors.length === 0\n      ? {}\n      : { authors: meta.authors }),\n    ...(meta?.description === undefined || meta.description === null\n      ? {}\n      : { description: meta.description }),\n    ...(meta?.publisher === undefined || meta.publisher === null\n      ? {}\n      : { publisher: meta.publisher }),\n    title: formatMetaTitle(meta),\n  };\n}\n\nexport function formatMetaText(meta: BookMeta | undefined): string {\n  const page = createMetaPage(meta);\n\n  return [\n    `title: ${page.title}`,\n    page.authors === undefined\n      ? undefined\n      : `authors: ${page.authors.join(\", \")}`,\n    page.publisher === undefined ? undefined : `publisher: ${page.publisher}`,\n    page.description === undefined\n      ? undefined\n      : `description: ${page.description}`,\n  ]\n    .filter(isDefined)\n    .join(\"\\n\");\n}\n\nexport function formatWeight(weight: number): string {\n  return Number.isInteger(weight) ? String(weight) : weight.toFixed(3);\n}\n\nexport function isDefined<T>(value: T | undefined | null): value is T {\n  return value !== undefined && value !== null;\n}\n"],"mappings":"AAEO,SAAS,cAAc,OAAe,QAAyB;AACpE,QAAM,YAAY,MAAM,QAAQ,QAAQ,GAAG,EAAE,KAAK;AAElD,MAAI,WAAW,QAAW;AACxB,WAAO,UAAU,SAAS,MAAM,GAAG,UAAU,MAAM,GAAG,GAAG,CAAC,QAAQ;AAAA,EACpE;AAEA,QAAM,QAAQ,UAAU,YAAY,EAAE,QAAQ,MAAM;AAEpD,MAAI,QAAQ,GAAG;AACb,WAAO,UAAU,SAAS,MAAM,GAAG,UAAU,MAAM,GAAG,GAAG,CAAC,QAAQ;AAAA,EACpE;AAEA,QAAM,QAAQ,KAAK,IAAI,GAAG,QAAQ,EAAE;AACpC,QAAM,MAAM,KAAK,IAAI,UAAU,QAAQ,QAAQ,OAAO,SAAS,GAAG;AAClE,QAAM,SAAS,UAAU,IAAI,KAAK;AAClC,QAAM,SAAS,QAAQ,UAAU,SAAS,KAAK;AAE/C,SAAO,GAAG,MAAM,GAAG,UAAU,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM;AACzD;AAEO,SAAS,kBAAkB,MAAoC;AACpE,MAAI,SAAS,QAAW;AACtB,WAAO;AAAA,EACT;AAEA,SAAO,CAAC,KAAK,OAAO,KAAK,QAAQ,KAAK,IAAI,GAAG,KAAK,SAAS,EACxD,OAAO,CAAC,UAAU,UAAU,QAAQ,UAAU,EAAE,EAChD,KAAK,KAAK;AACf;AAEO,SAAS,gBAAgB,MAAoC;AAClE,SAAO,MAAM,SAAS;AACxB;AAEO,SAAS,eAAe,MAK7B;AACA,SAAO;AAAA,IACL,GAAI,MAAM,YAAY,UAAa,KAAK,QAAQ,WAAW,IACvD,CAAC,IACD,EAAE,SAAS,KAAK,QAAQ;AAAA,IAC5B,GAAI,MAAM,gBAAgB,UAAa,KAAK,gBAAgB,OACxD,CAAC,IACD,EAAE,aAAa,KAAK,YAAY;AAAA,IACpC,GAAI,MAAM,cAAc,UAAa,KAAK,cAAc,OACpD,CAAC,IACD,EAAE,WAAW,KAAK,UAAU;AAAA,IAChC,OAAO,gBAAgB,IAAI;AAAA,EAC7B;AACF;AAEO,SAAS,eAAe,MAAoC;AACjE,QAAM,OAAO,eAAe,IAAI;AAEhC,SAAO;AAAA,IACL,UAAU,KAAK,KAAK;AAAA,IACpB,KAAK,YAAY,SACb,SACA,YAAY,KAAK,QAAQ,KAAK,IAAI,CAAC;AAAA,IACvC,KAAK,cAAc,SAAY,SAAY,cAAc,KAAK,SAAS;AAAA,IACvE,KAAK,gBAAgB,SACjB,SACA,gBAAgB,KAAK,WAAW;AAAA,EACtC,EACG,OAAO,SAAS,EAChB,KAAK,IAAI;AACd;AAEO,SAAS,aAAa,QAAwB;AACnD,SAAO,OAAO,UAAU,MAAM,IAAI,OAAO,MAAM,IAAI,OAAO,QAAQ,CAAC;AACrE;AAEO,SAAS,UAAa,OAAyC;AACpE,SAAO,UAAU,UAAa,UAAU;AAC1C;","names":[]}

package/dist/retrieval/query/archive-view/helper/parse.d.ts

@@ -0,0 +1,38 @@
+import { ArchiveFindObjectType, ArchiveCollectionType, ArchiveFindFilterType, ArchiveFindLens, ArchiveFindMatch } from '../types.js';
+import '../../../../document/types.js';
+import '../../../../text/source/meta.js';
+import 'zod';
+import '../../../../graph/reading.js';
+import '../../../../document/directory/types.js';
+import '../../../../text/source/toc.js';
+import '../../../../text/source/types.js';
+import '../../../../document/database.js';
+import 'sqlite3';
+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 '../../../../document/chapter/types.js';
+
+declare function createSearchTerms(query: string): readonly string[];
+declare function isFindFilterType(type: ArchiveFindObjectType): type is ArchiveFindFilterType;
+declare function isCollectionType(type: ArchiveFindObjectType): type is ArchiveCollectionType;
+declare function parseFindLens(value: string): ArchiveFindLens;
+declare function parseFindMatch(value: string): ArchiveFindMatch;
+declare function parseFindTypes(values: readonly string[] | null): readonly ArchiveFindFilterType[] | null;
+declare function encodeFindCursor(offset: number): string;
+declare function decodeFindCursor(cursor: string | undefined): number;
+declare function isFindCursor(cursor: string): boolean;
+
+export { createSearchTerms, decodeFindCursor, encodeFindCursor, isCollectionType, isFindCursor, isFindFilterType, parseFindLens, parseFindMatch, parseFindTypes };

package/dist/retrieval/query/archive-view/helper/parse.js

@@ -0,0 +1,71 @@
+function createSearchTerms(query) {
+  return query.trim().toLowerCase().split(/\s+/u).filter((term) => term !== "");
+}
+function isFindFilterType(type) {
+  return type === "chapter" || type === "chapter-title" || type === "entity" || type === "fragment" || type === "meta" || type === "node" || type === "source" || type === "summary" || type === "triple";
+}
+function isCollectionType(type) {
+  return type === "chapter" || type === "chapter-title" || type === "entity" || type === "fragment" || type === "meta" || type === "node" || type === "source" || type === "summary" || type === "triple";
+}
+function parseFindLens(value) {
+  if (value === "broad" || value === "exact" || value === "typed") {
+    return value;
+  }
+  throw new Error("Invalid cached search session.");
+}
+function parseFindMatch(value) {
+  if (value === "all" || value === "any") {
+    return value;
+  }
+  throw new Error("Invalid cached search session.");
+}
+function parseFindTypes(values) {
+  if (values === null) {
+    return null;
+  }
+  return values.map((value) => {
+    if (value === "entity" || value === "fragment" || value === "meta" || value === "node" || value === "source" || value === "summary" || value === "chapter" || value === "chapter-title" || value === "triple") {
+      return value;
+    }
+    throw new Error("Invalid cached search session.");
+  });
+}
+function encodeFindCursor(offset) {
+  return Buffer.from(JSON.stringify({ offset, v: 1 })).toString("base64url");
+}
+function decodeFindCursor(cursor) {
+  if (cursor === void 0) {
+    return 0;
+  }
+  try {
+    const parsed = JSON.parse(
+      Buffer.from(cursor, "base64url").toString("utf8")
+    );
+    if (typeof parsed === "object" && parsed !== null && "v" in parsed && "offset" in parsed && parsed.v === 1 && Number.isInteger(parsed.offset) && typeof parsed.offset === "number" && parsed.offset >= 0) {
+      return parsed.offset;
+    }
+  } catch {
+    throw new Error("Invalid search cursor.");
+  }
+  throw new Error("Invalid search cursor.");
+}
+function isFindCursor(cursor) {
+  try {
+    decodeFindCursor(cursor);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  createSearchTerms,
+  decodeFindCursor,
+  encodeFindCursor,
+  isCollectionType,
+  isFindCursor,
+  isFindFilterType,
+  parseFindLens,
+  parseFindMatch,
+  parseFindTypes
+};
+//# sourceMappingURL=parse.js.map

package/dist/retrieval/query/archive-view/helper/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/retrieval/query/archive-view/helper/parse.ts"],"sourcesContent":["import type {\n  ArchiveCollectionType,\n  ArchiveFindFilterType,\n  ArchiveFindLens,\n  ArchiveFindMatch,\n  ArchiveFindObjectType,\n} from \"../types.js\";\n\nexport function createSearchTerms(query: string): readonly string[] {\n  return query\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/u)\n    .filter((term) => term !== \"\");\n}\n\nexport function isFindFilterType(\n  type: ArchiveFindObjectType,\n): type is ArchiveFindFilterType {\n  return (\n    type === \"chapter\" ||\n    type === \"chapter-title\" ||\n    type === \"entity\" ||\n    type === \"fragment\" ||\n    type === \"meta\" ||\n    type === \"node\" ||\n    type === \"source\" ||\n    type === \"summary\" ||\n    type === \"triple\"\n  );\n}\n\nexport function isCollectionType(\n  type: ArchiveFindObjectType,\n): type is ArchiveCollectionType {\n  return (\n    type === \"chapter\" ||\n    type === \"chapter-title\" ||\n    type === \"entity\" ||\n    type === \"fragment\" ||\n    type === \"meta\" ||\n    type === \"node\" ||\n    type === \"source\" ||\n    type === \"summary\" ||\n    type === \"triple\"\n  );\n}\n\nexport function parseFindLens(value: string): ArchiveFindLens {\n  if (value === \"broad\" || value === \"exact\" || value === \"typed\") {\n    return value;\n  }\n\n  throw new Error(\"Invalid cached search session.\");\n}\n\nexport function parseFindMatch(value: string): ArchiveFindMatch {\n  if (value === \"all\" || value === \"any\") {\n    return value;\n  }\n\n  throw new Error(\"Invalid cached search session.\");\n}\n\nexport function parseFindTypes(\n  values: readonly string[] | null,\n): readonly ArchiveFindFilterType[] | null {\n  if (values === null) {\n    return null;\n  }\n\n  return values.map((value) => {\n    if (\n      value === \"entity\" ||\n      value === \"fragment\" ||\n      value === \"meta\" ||\n      value === \"node\" ||\n      value === \"source\" ||\n      value === \"summary\" ||\n      value === \"chapter\" ||\n      value === \"chapter-title\" ||\n      value === \"triple\"\n    ) {\n      return value;\n    }\n\n    throw new Error(\"Invalid cached search session.\");\n  });\n}\n\nexport function encodeFindCursor(offset: number): string {\n  return Buffer.from(JSON.stringify({ offset, v: 1 })).toString(\"base64url\");\n}\n\nexport function decodeFindCursor(cursor: string | undefined): number {\n  if (cursor === undefined) {\n    return 0;\n  }\n\n  try {\n    const parsed: unknown = JSON.parse(\n      Buffer.from(cursor, \"base64url\").toString(\"utf8\"),\n    );\n\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      \"v\" in parsed &&\n      \"offset\" in parsed &&\n      parsed.v === 1 &&\n      Number.isInteger(parsed.offset) &&\n      typeof parsed.offset === \"number\" &&\n      parsed.offset >= 0\n    ) {\n      return parsed.offset;\n    }\n  } catch {\n    throw new Error(\"Invalid search cursor.\");\n  }\n\n  throw new Error(\"Invalid search cursor.\");\n}\n\nexport function isFindCursor(cursor: string): boolean {\n  try {\n    decodeFindCursor(cursor);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"AAQO,SAAS,kBAAkB,OAAkC;AAClE,SAAO,MACJ,KAAK,EACL,YAAY,EACZ,MAAM,MAAM,EACZ,OAAO,CAAC,SAAS,SAAS,EAAE;AACjC;AAEO,SAAS,iBACd,MAC+B;AAC/B,SACE,SAAS,aACT,SAAS,mBACT,SAAS,YACT,SAAS,cACT,SAAS,UACT,SAAS,UACT,SAAS,YACT,SAAS,aACT,SAAS;AAEb;AAEO,SAAS,iBACd,MAC+B;AAC/B,SACE,SAAS,aACT,SAAS,mBACT,SAAS,YACT,SAAS,cACT,SAAS,UACT,SAAS,UACT,SAAS,YACT,SAAS,aACT,SAAS;AAEb;AAEO,SAAS,cAAc,OAAgC;AAC5D,MAAI,UAAU,WAAW,UAAU,WAAW,UAAU,SAAS;AAC/D,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,gCAAgC;AAClD;AAEO,SAAS,eAAe,OAAiC;AAC9D,MAAI,UAAU,SAAS,UAAU,OAAO;AACtC,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,gCAAgC;AAClD;AAEO,SAAS,eACd,QACyC;AACzC,MAAI,WAAW,MAAM;AACnB,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,IAAI,CAAC,UAAU;AAC3B,QACE,UAAU,YACV,UAAU,cACV,UAAU,UACV,UAAU,UACV,UAAU,YACV,UAAU,aACV,UAAU,aACV,UAAU,mBACV,UAAU,UACV;AACA,aAAO;AAAA,IACT;AAEA,UAAM,IAAI,MAAM,gCAAgC;AAAA,EAClD,CAAC;AACH;AAEO,SAAS,iBAAiB,QAAwB;AACvD,SAAO,OAAO,KAAK,KAAK,UAAU,EAAE,QAAQ,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,WAAW;AAC3E;AAEO,SAAS,iBAAiB,QAAoC;AACnE,MAAI,WAAW,QAAW;AACxB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,SAAkB,KAAK;AAAA,MAC3B,OAAO,KAAK,QAAQ,WAAW,EAAE,SAAS,MAAM;AAAA,IAClD;AAEA,QACE,OAAO,WAAW,YAClB,WAAW,QACX,OAAO,UACP,YAAY,UACZ,OAAO,MAAM,KACb,OAAO,UAAU,OAAO,MAAM,KAC9B,OAAO,OAAO,WAAW,YACzB,OAAO,UAAU,GACjB;AACA,aAAO,OAAO;AAAA,IAChB;AAAA,EACF,QAAQ;AACN,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AAEA,QAAM,IAAI,MAAM,wBAAwB;AAC1C;AAEO,SAAS,aAAa,QAAyB;AACpD,MAAI;AACF,qBAAiB,MAAM;AACvB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}