wiki-graph-core 0.3.1 → 0.4.0

package/dist/reader/chunk-batch/parser.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/reader/chunk-batch/parser.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport {\n  GuaranteedParseValidationError,\n  ParsedJsonError,\n  requestGuaranteedJson,\n} from \"../../guaranteed/index.js\";\nimport type { LLMessage } from \"../../llm/index.js\";\nimport {\n  ChunkImportance,\n  ChunkRetention,\n  expectChunkImportance,\n  expectChunkRetention,\n  type SentenceId,\n} from \"../../document/index.js\";\nimport {\n  resolveEvidenceSelectionList,\n  type EvidenceSelectionCandidate,\n  type EvidenceSelectionList,\n  EvidenceResolver,\n  type EvidenceResolutionFailure,\n  type RankedSentenceCandidate,\n} from \"../../evidence-selection/index.js\";\nimport type {\n  ChunkBatch,\n  ChunkExtractionSentence,\n  ChunkImportanceAnnotation,\n  ChunkLink,\n  CognitiveChunk,\n  SentenceTextSource,\n} from \"./types.js\";\nimport type { FragmentProjection, TextSpan } from \"./fragment-projection.js\";\n\nconst MAX_CHOICE_RETRIES = 3;\n\nconst chunkLinkSchema = z.object({\n  from: z.union([z.number().int(), z.string()]),\n  strength: z.string().optional(),\n  to: z.union([z.number().int(), z.string()]),\n});\nconst evidenceSelectionItemSchema = z\n  .object({\n    quote: z.string().optional(),\n    sentence_id: z.string().optional(),\n  })\n  .passthrough();\nconst chunkEvidenceSchema = z.union([\n  z.record(z.string(), z.unknown()),\n  z.array(evidenceSelectionItemSchema),\n]);\n\nconst userFocusedChunkSchema = z\n  .object({\n    content: z.string(),\n    evidence: chunkEvidenceSchema.nullish(),\n    label: z.string(),\n    retention: z.enum([\n      ChunkRetention.Verbatim,\n      ChunkRetention.Detailed,\n      ChunkRetention.Focused,\n      ChunkRetention.Relevant,\n    ]),\n    temp_id: z.string(),\n  })\n  .passthrough();\n\nexport const userFocusedResponseSchema = z.object({\n  chunks: z.array(userFocusedChunkSchema),\n  fragment_summary: z.string(),\n  links: z.array(chunkLinkSchema),\n});\n\nconst bookCoherenceChunkSchema = z\n  .object({\n    content: z.string(),\n    evidence: chunkEvidenceSchema.nullish(),\n    importance: z.enum([\n      ChunkImportance.Critical,\n      ChunkImportance.Important,\n      ChunkImportance.Helpful,\n    ]),\n    label: z.string(),\n    temp_id: z.string(),\n  })\n  .passthrough();\n\nconst importanceAnnotationSchema = z.object({\n  chunk_id: z.number().int(),\n  importance: z.enum([\n    ChunkImportance.Critical,\n    ChunkImportance.Important,\n    ChunkImportance.Helpful,\n  ]),\n});\n\nexport const bookCoherenceResponseSchema = z.object({\n  chunks: z.array(bookCoherenceChunkSchema),\n  importance_annotations: z.array(importanceAnnotationSchema),\n  links: z.array(chunkLinkSchema),\n});\n\nconst choiceResponseSchema = z.object({\n  choice: z.string(),\n});\n\ntype UserFocusedChunkData = z.infer<typeof userFocusedChunkSchema>;\ntype BookCoherenceChunkData = z.infer<typeof bookCoherenceChunkSchema>;\nexport type UserFocusedResponseData = z.infer<typeof userFocusedResponseSchema>;\nexport type BookCoherenceResponseData = z.infer<\n  typeof bookCoherenceResponseSchema\n>;\ntype ExtractedChunkData = UserFocusedChunkData | BookCoherenceChunkData;\ntype RawChunkLink = z.infer<typeof chunkLinkSchema>;\ntype RawChunkEvidence = z.infer<typeof chunkEvidenceSchema>;\ntype ChoiceFieldName = \"evidence\" | \"start_anchor\" | \"end_anchor\";\n\nexport enum ChunkMetadataField {\n  Retention = \"retention\",\n  Importance = \"importance\",\n}\n\nexport interface ExtractChunksResult {\n  readonly chunkBatch: ChunkBatch;\n  readonly fragmentSummary?: string;\n}\n\ninterface ResolveChunkEvidenceInput {\n  readonly data: ExtractedChunkData;\n  readonly chunkIndex: number;\n  readonly chunkLabel: string;\n  readonly isLastGenerationAttempt: boolean;\n}\n\ninterface SelectAmbiguousCandidateInput {\n  readonly candidates: readonly RankedSentenceCandidate[];\n  readonly chunkData: ExtractedChunkData;\n  readonly chunkIndex: number;\n  readonly chunkLabel: string;\n  readonly fieldName: ChoiceFieldName;\n}\n\ntype GuaranteedChoiceRequest = (\n  messages: readonly LLMessage[],\n  index: number,\n  maxRetries: number,\n) => Promise<string>;\n\nexport class ChunkBatchParser<\n  TData extends UserFocusedResponseData | BookCoherenceResponseData,\n> {\n  readonly #choiceSystemPrompt: string;\n  readonly #evidenceResolver = new EvidenceResolver();\n  readonly #metadataField: ChunkMetadataField;\n  readonly #projection: FragmentProjection;\n  readonly #responseIntentClassifierPrompt: string;\n  readonly #requestChoice: GuaranteedChoiceRequest;\n  readonly #sentenceTextByKey: Readonly<Record<string, string>>;\n  readonly #sentenceTextSource: SentenceTextSource;\n  readonly #wordsCountByKey: Readonly<Record<string, number>>;\n  readonly #validImportanceChunkIds: Readonly<Record<string, true>> | undefined;\n  readonly #visibleChunkIds: readonly number[];\n\n  public constructor(input: {\n    choiceSystemPrompt: string;\n    metadataField: ChunkMetadataField;\n    projection: FragmentProjection;\n    responseIntentClassifierPrompt: string;\n    requestChoice: GuaranteedChoiceRequest;\n    sentenceTextSource: SentenceTextSource;\n    sentences: readonly ChunkExtractionSentence[];\n    validImportanceChunkIds?: readonly number[];\n    visibleChunkIds: readonly number[];\n  }) {\n    this.#choiceSystemPrompt = input.choiceSystemPrompt;\n    this.#metadataField = input.metadataField;\n    this.#projection = input.projection;\n    this.#responseIntentClassifierPrompt = input.responseIntentClassifierPrompt;\n    this.#requestChoice = input.requestChoice;\n    this.#sentenceTextSource = input.sentenceTextSource;\n    this.#visibleChunkIds = input.visibleChunkIds;\n\n    this.#wordsCountByKey = createWordsCountRecord(\n      input.projection.sentences.map((sentence) => ({\n        sentenceId: sentence.sentenceId,\n        wordsCount: sentence.wordsCount,\n      })),\n    );\n    this.#sentenceTextByKey = createSentenceTextRecord(input.projection);\n    this.#validImportanceChunkIds =\n      input.validImportanceChunkIds === undefined\n        ? undefined\n        : createMembershipRecord(input.validImportanceChunkIds);\n  }\n\n  public async parse(\n    parsedData: TData,\n    input: {\n      isLastGenerationAttempt: boolean;\n    },\n  ): Promise<ExtractChunksResult> {\n    const issues: string[] = [];\n    const chunks: ChunkBatch[\"chunks\"] = [];\n    const tempIds: string[] = [];\n    const importanceAnnotations =\n      \"importance_annotations\" in parsedData\n        ? this.#validateImportanceAnnotations(\n            parsedData.importance_annotations,\n            issues,\n          )\n        : undefined;\n    const fragmentSummary =\n      \"fragment_summary\" in parsedData\n        ? parsedData.fragment_summary\n        : undefined;\n    const links = normalizeChunkLinks(parsedData.links);\n\n    for (const [index, data] of parsedData.chunks.entries()) {\n      const chunkIndex = index + 1;\n      const chunkIssues: string[] = [];\n      const label = data.label.trim();\n      const content = data.content.trim();\n\n      if (label === \"\") {\n        chunkIssues.push(\n          `Chunk #${chunkIndex}: Missing or empty \"label\" field`,\n        );\n      }\n\n      if (content === \"\") {\n        chunkIssues.push(\n          `Chunk #${chunkIndex}: Missing or empty \"content\" field`,\n        );\n      }\n\n      const [matchedSentenceIds, evidenceFailure] =\n        await this.#resolveChunkEvidence({\n          chunkIndex,\n          chunkLabel: label,\n          data,\n          isLastGenerationAttempt: input.isLastGenerationAttempt,\n        });\n\n      if (matchedSentenceIds.length === 0) {\n        if (evidenceFailure !== undefined) {\n          chunkIssues.push(\n            `Chunk #${chunkIndex} (\"${label}\"): ${evidenceFailure.message}`,\n          );\n        } else {\n          chunkIssues.push(\n            `Chunk #${chunkIndex} (\"${label}\"): Missing evidence`,\n          );\n        }\n      }\n\n      if (chunkIssues.length > 0) {\n        issues.push(...chunkIssues);\n        continue;\n      }\n\n      const primarySentenceId = matchedSentenceIds[0];\n\n      if (primarySentenceId === undefined) {\n        issues.push(\n          `Chunk #${chunkIndex} (\"${label}\"): Unable to resolve any sentence IDs`,\n        );\n        continue;\n      }\n\n      const totalWordsCount = matchedSentenceIds.reduce((sum, sentenceId) => {\n        return (\n          sum + (this.#wordsCountByKey[createSentenceKey(sentenceId)] ?? 0)\n        );\n      }, 0);\n\n      if (this.#metadataField === ChunkMetadataField.Retention) {\n        const chunkData = data as UserFocusedChunkData;\n\n        chunks.push({\n          content,\n          generation: 0,\n          id: 0,\n          label,\n          links: [],\n          retention: expectChunkRetention(chunkData.retention),\n          sentenceId: primarySentenceId,\n          sentenceIds: [...matchedSentenceIds],\n          wordsCount: totalWordsCount,\n        });\n      } else {\n        const chunkData = data as BookCoherenceChunkData;\n\n        chunks.push({\n          content,\n          generation: 0,\n          id: 0,\n          importance: expectChunkImportance(chunkData.importance),\n          label,\n          links: [],\n          sentenceId: primarySentenceId,\n          sentenceIds: [...matchedSentenceIds],\n          wordsCount: totalWordsCount,\n        });\n      }\n\n      tempIds.push(data.temp_id);\n    }\n\n    const validLinks = this.#filterAndValidateLinks({\n      issues,\n      links,\n      tempIds,\n      visibleChunkIds: this.#visibleChunkIds,\n    });\n\n    if (issues.length > 0) {\n      throw new ParsedJsonError(issues);\n    }\n\n    return {\n      chunkBatch: {\n        chunks,\n        links: validLinks,\n        orderCorrect: true,\n        tempIds,\n        ...(importanceAnnotations === undefined\n          ? {}\n          : { importanceAnnotations }),\n      },\n      ...(fragmentSummary === undefined ? {} : { fragmentSummary }),\n    };\n  }\n\n  public async getChunkSourceSentences(\n    chunk: CognitiveChunk,\n  ): Promise<string[]> {\n    const sourceSentences: string[] = [];\n\n    for (const sentenceId of chunk.sentenceIds) {\n      const sentenceKey = createSentenceKey(sentenceId);\n      const sentenceText = this.#sentenceTextByKey[sentenceKey];\n\n      if (sentenceText !== undefined) {\n        sourceSentences.push(sentenceText);\n        continue;\n      }\n\n      sourceSentences.push(\n        await this.#sentenceTextSource.getSentence(sentenceId),\n      );\n    }\n\n    return sourceSentences;\n  }\n\n  async #resolveChunkEvidence(\n    input: ResolveChunkEvidenceInput,\n  ): Promise<\n    readonly [\n      sentenceIds: readonly SentenceId[],\n      failure: EvidenceResolutionFailure | undefined,\n    ]\n  > {\n    const evidence = input.data.evidence;\n\n    if (evidence === undefined || evidence === null) {\n      return [[], undefined];\n    }\n\n    if (!isRecord(evidence) && !Array.isArray(evidence)) {\n      return [\n        [],\n        {\n          candidates: [],\n          code: \"invalid_evidence\",\n          fieldName: \"evidence\",\n          message: `Chunk #${input.chunkIndex} (\"${input.chunkLabel}\"): evidence must be an object or array`,\n        },\n      ];\n    }\n\n    const projectedSentences = this.#projection.sentences;\n    const candidateSentenceIds = projectedSentences.map(\n      (sentence) => sentence.sentenceId,\n    );\n    const selectionSentences = projectedSentences.map((sentence, index) => ({\n      id: `S${index + 1}`,\n      sentenceId: sentence.sentenceId,\n      text: sentence.projectedText,\n    }));\n    const selectionEvidence = createEvidenceSelectionList(evidence);\n    const [selectionResolution, selectionFailure] =\n      selectionEvidence === undefined\n        ? [undefined, undefined]\n        : resolveEvidenceSelectionList({\n            evidence: selectionEvidence,\n            sentences: selectionSentences,\n          });\n\n    if (selectionResolution !== undefined) {\n      return [selectionResolution.sentenceIds, undefined];\n    }\n\n    const exactMatchSentenceIds = Array.isArray(evidence)\n      ? []\n      : this.#resolveExactProjectionEvidence(evidence);\n\n    if (exactMatchSentenceIds.length > 0) {\n      return [exactMatchSentenceIds, undefined];\n    }\n\n    const candidateTexts = projectedSentences.map(\n      (sentence) => sentence.projectedText,\n    );\n    const [resolution, failure] = Array.isArray(evidence)\n      ? [undefined, undefined]\n      : this.#evidenceResolver.resolve(\n          evidence,\n          candidateSentenceIds,\n          candidateTexts,\n        );\n\n    if (resolution !== undefined) {\n      return [resolution.sentenceIds, undefined];\n    }\n\n    const fallbackFailure =\n      selectionFailure === undefined\n        ? failure\n        : toEvidenceResolutionFailure(selectionFailure, \"evidence\");\n\n    if (fallbackFailure === undefined) {\n      return [[], undefined];\n    }\n\n    const shouldUseChoice =\n      fallbackFailure.code.startsWith(\"ambiguous\") ||\n      (fallbackFailure.code === \"low_confidence\" &&\n        input.isLastGenerationAttempt &&\n        fallbackFailure.candidates.length > 0);\n\n    if (!shouldUseChoice) {\n      return [[], fallbackFailure];\n    }\n\n    const choiceFieldName = toChoiceFieldName(fallbackFailure.fieldName);\n\n    if (choiceFieldName === undefined) {\n      return [[], fallbackFailure];\n    }\n\n    const [choiceCandidate, choiceFailure] =\n      await this.#chooseAmbiguousCandidate({\n        candidates: fallbackFailure.candidates,\n        chunkData: input.data,\n        chunkIndex: input.chunkIndex,\n        chunkLabel: input.chunkLabel,\n        fieldName: choiceFieldName,\n      });\n\n    if (choiceFailure !== undefined) {\n      if (choiceFailure.code === \"choice_parse_failed_full_fragment\") {\n        return [candidateSentenceIds, undefined];\n      }\n\n      return [[], choiceFailure];\n    }\n\n    if (choiceCandidate === undefined) {\n      return [\n        [],\n        {\n          candidates: fallbackFailure.candidates,\n          code: \"choice_failed\",\n          fieldName: fallbackFailure.fieldName,\n          message: `Second-stage choice failed for ${fallbackFailure.fieldName}: no candidate returned.`,\n        },\n      ];\n    }\n\n    if (choiceFieldName === \"evidence\") {\n      return [[choiceCandidate.sentenceId], undefined];\n    }\n\n    if (Array.isArray(evidence)) {\n      return [[], fallbackFailure];\n    }\n\n    if (input.isLastGenerationAttempt) {\n      const [resolved, resolveFailure] =\n        this.#evidenceResolver.resolveWithOverrides({\n          candidateSentenceIds,\n          candidateTexts,\n          evidence,\n          overrides: {\n            [choiceFieldName]: choiceCandidate,\n          },\n        });\n\n      if (resolved !== undefined) {\n        return [resolved.sentenceIds, undefined];\n      }\n\n      return [[], resolveFailure];\n    }\n\n    const repairedEvidence: Record<string, unknown> = {\n      ...evidence,\n      [choiceFieldName]: {\n        mode: \"full\",\n        text: choiceCandidate.text,\n      },\n    };\n    const [resolved, resolveFailure] = this.#evidenceResolver.resolve(\n      repairedEvidence,\n      candidateSentenceIds,\n      candidateTexts,\n    );\n\n    if (resolved !== undefined) {\n      return [resolved.sentenceIds, undefined];\n    }\n\n    return [[], resolveFailure];\n  }\n\n  #resolveExactProjectionEvidence(\n    evidence: Record<string, unknown>,\n  ): SentenceId[] {\n    const startValue = evidence.start_anchor ?? evidence.start;\n    const [startAnchor, startFailure] = this.#evidenceResolver.parseAnchor(\n      startValue,\n      \"start_anchor\",\n    );\n\n    if (startFailure !== undefined || startAnchor?.text === undefined) {\n      return [];\n    }\n\n    const startMatch = expectSingleSpan(\n      this.#projection.findExactMatches(startAnchor.text),\n    );\n\n    if (startMatch === undefined) {\n      return [];\n    }\n\n    const endValue = evidence.end_anchor ?? evidence.end;\n\n    if (endValue === undefined) {\n      return this.#projection.resolveSentenceIds(startMatch);\n    }\n\n    const [endAnchor, endFailure] = this.#evidenceResolver.parseAnchor(\n      endValue,\n      \"end_anchor\",\n    );\n\n    if (endFailure !== undefined || endAnchor?.text === undefined) {\n      return [];\n    }\n\n    const endMatch = expectSingleSpan(\n      this.#projection.findExactMatches(endAnchor.text),\n    );\n\n    if (endMatch === undefined || endMatch.offset < startMatch.offset) {\n      return [];\n    }\n\n    return this.#projection.resolveSentenceIds({\n      length: endMatch.offset + endMatch.length - startMatch.offset,\n      offset: startMatch.offset,\n    });\n  }\n\n  async #chooseAmbiguousCandidate(\n    input: SelectAmbiguousCandidateInput,\n  ): Promise<\n    readonly [\n      candidate: RankedSentenceCandidate | undefined,\n      failure: EvidenceResolutionFailure | undefined,\n    ]\n  > {\n    const messages = this.#buildChoiceMessages(input);\n    const candidateIds = input.candidates.map(\n      (candidate) => candidate.occurrenceId,\n    );\n\n    try {\n      const choice = await requestGuaranteedJson({\n        maxRetries: MAX_CHOICE_RETRIES,\n        messages,\n        parse: (data) => {\n          const candidate = input.candidates.find(\n            (item) => item.occurrenceId === data.choice,\n          );\n\n          if (candidate === undefined) {\n            throw new ParsedJsonError([\n              `Invalid choice \"${data.choice}\". Expected one of: ${candidateIds.join(\", \")}`,\n            ]);\n          }\n\n          return candidate;\n        },\n        responseIntentClassifierPrompt: this.#responseIntentClassifierPrompt,\n        request: this.#requestChoice,\n        schema: choiceResponseSchema,\n      });\n\n      return [choice, undefined];\n    } catch (error) {\n      if (isParsedJsonValidationFailure(error)) {\n        return [\n          undefined,\n          {\n            candidates: input.candidates,\n            code: \"choice_parse_failed_full_fragment\",\n            fieldName: input.fieldName,\n            message:\n              `Second-stage choice parse validation failed for ${input.fieldName}; ` +\n              \"falling back to the full fragment span.\",\n          },\n        ];\n      }\n\n      return [\n        undefined,\n        {\n          candidates: input.candidates,\n          code: \"choice_failed\",\n          fieldName: input.fieldName,\n          message: `Second-stage choice failed for ${input.fieldName}: ${formatError(error)}`,\n        },\n      ];\n    }\n  }\n\n  #buildChoiceMessages(input: SelectAmbiguousCandidateInput): LLMessage[] {\n    return [\n      {\n        content: this.#choiceSystemPrompt,\n        role: \"system\",\n      },\n      {\n        content:\n          `Previously generated chunk (do NOT rewrite it):\\n` +\n          `\\`\\`\\`json\\n${JSON.stringify(input.chunkData, null, 2)}\\n\\`\\`\\`\\n\\n` +\n          `Resolve only this field: \"${input.fieldName}\" for chunk #${input.chunkIndex} [${input.chunkLabel}].\\n` +\n          \"Choose exactly one candidate occurrence ID from the list below.\\n\\n\" +\n          input.candidates.map(formatChoiceCandidate).join(\"\\n\"),\n        role: \"user\",\n      },\n    ];\n  }\n\n  #validateImportanceAnnotations(\n    annotations: readonly {\n      readonly chunk_id: number;\n      readonly importance: ChunkImportance;\n    }[],\n    issues: string[],\n  ): ChunkImportanceAnnotation[] | undefined {\n    if (annotations.length === 0) {\n      return [];\n    }\n\n    if (this.#validImportanceChunkIds === undefined) {\n      return annotations.map((annotation) => ({\n        chunkId: annotation.chunk_id,\n        importance: expectChunkImportance(annotation.importance),\n      }));\n    }\n\n    const result: ChunkImportanceAnnotation[] = [];\n\n    for (const annotation of annotations) {\n      if (!hasMembership(this.#validImportanceChunkIds, annotation.chunk_id)) {\n        issues.push(\n          `importance_annotations references unknown chunk_id ${annotation.chunk_id}`,\n        );\n        continue;\n      }\n\n      result.push({\n        chunkId: annotation.chunk_id,\n        importance: expectChunkImportance(annotation.importance),\n      });\n    }\n\n    return result;\n  }\n\n  #filterAndValidateLinks(input: {\n    issues: string[];\n    links: readonly ChunkLink[];\n    tempIds: readonly string[];\n    visibleChunkIds: readonly number[];\n  }): ChunkLink[] {\n    const validTempIds = createMembershipRecord(input.tempIds);\n    const validChunkIds = createMembershipRecord(input.visibleChunkIds);\n    const retainedLinks: ChunkLink[] = [];\n\n    for (const [index, link] of input.links.entries()) {\n      const fromValid = this.#validateLinkReference({\n        fieldName: \"from\",\n        index: index + 1,\n        issues: input.issues,\n        reference: link.from,\n        validChunkIds,\n        validTempIds,\n      });\n      const toValid = this.#validateLinkReference({\n        fieldName: \"to\",\n        index: index + 1,\n        issues: input.issues,\n        reference: link.to,\n        validChunkIds,\n        validTempIds,\n      });\n\n      if (fromValid && toValid) {\n        retainedLinks.push(link);\n      }\n    }\n\n    return retainedLinks;\n  }\n\n  #validateLinkReference(input: {\n    fieldName: \"from\" | \"to\";\n    index: number;\n    issues: string[];\n    reference: number | string;\n    validChunkIds: Readonly<Record<string, true>>;\n    validTempIds: Readonly<Record<string, true>>;\n  }): boolean {\n    if (typeof input.reference === \"string\") {\n      return hasMembership(input.validTempIds, input.reference);\n    }\n\n    if (!hasMembership(input.validChunkIds, input.reference)) {\n      input.issues.push(\n        `Link #${input.index}: \"${input.fieldName}\" chunk_id ${input.reference} does not exist in visible chunks`,\n      );\n\n      return false;\n    }\n\n    return true;\n  }\n}\n\nfunction createWordsCountRecord(\n  sentences: readonly Pick<\n    ChunkExtractionSentence,\n    \"sentenceId\" | \"wordsCount\"\n  >[],\n): Readonly<Record<string, number>> {\n  const wordsCountByKey = createEmptyRecord<number>();\n\n  for (const sentence of sentences) {\n    const sentenceKey = createSentenceKey(sentence.sentenceId);\n    wordsCountByKey[sentenceKey] = sentence.wordsCount;\n  }\n\n  return wordsCountByKey;\n}\n\nfunction createSentenceTextRecord(\n  projection: FragmentProjection,\n): Readonly<Record<string, string>> {\n  const record = createEmptyRecord<string>();\n\n  for (const sentence of projection.sentences) {\n    record[createSentenceKey(sentence.sentenceId)] = sentence.rawText;\n  }\n\n  return record;\n}\n\nfunction normalizeChunkLinks(links: readonly RawChunkLink[]): ChunkLink[] {\n  return links.map((link) => {\n    if (link.strength === undefined) {\n      return {\n        from: link.from,\n        to: link.to,\n      };\n    }\n\n    return {\n      from: link.from,\n      strength: link.strength,\n      to: link.to,\n    };\n  });\n}\n\nfunction formatChoiceCandidate(candidate: RankedSentenceCandidate): string {\n  return [\n    candidate.occurrenceId,\n    `prev: ${formatChoiceText(candidate.prevText)}`,\n    `text: ${formatChoiceText(candidate.text)}`,\n    `next: ${formatChoiceText(candidate.nextText)}`,\n  ].join(\"\\n\");\n}\n\nfunction formatChoiceText(text: string): string {\n  const collapsed = text.replace(/\\s+/gu, \" \").trim();\n\n  return collapsed === \"\" ? \"(none)\" : collapsed;\n}\n\nfunction toChoiceFieldName(value: string): ChoiceFieldName | undefined {\n  return value === \"evidence\" ||\n    value === \"start_anchor\" ||\n    value === \"end_anchor\"\n    ? value\n    : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction formatError(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n\nfunction isParsedJsonValidationFailure(error: unknown): boolean {\n  return (\n    error instanceof GuaranteedParseValidationError &&\n    error.cause instanceof ParsedJsonError\n  );\n}\n\nfunction createSentenceKey(sentenceId: SentenceId): string {\n  return sentenceId.join(\":\");\n}\n\nfunction createMembershipRecord(\n  values: readonly (number | string)[],\n): Readonly<Record<string, true>> {\n  const record = createEmptyRecord<true>();\n\n  for (const value of values) {\n    record[String(value)] = true;\n  }\n\n  return record;\n}\n\nfunction hasMembership(\n  record: Readonly<Record<string, true>>,\n  value: number | string,\n): boolean {\n  return hasIndexedValue(record, String(value));\n}\n\nfunction hasIndexedValue<TValue>(\n  record: Readonly<Record<string, TValue>>,\n  key: string,\n): boolean {\n  return Object.hasOwn(record, key);\n}\n\nfunction createEmptyRecord<TValue>(): Record<string, TValue> {\n  return Object.create(null) as Record<string, TValue>;\n}\n\nfunction expectSingleSpan(spans: readonly TextSpan[]): TextSpan | undefined {\n  return spans.length === 1 ? spans[0] : undefined;\n}\n\nfunction createEvidenceSelectionList(\n  evidence: RawChunkEvidence,\n): EvidenceSelectionList | undefined {\n  if (Array.isArray(evidence)) {\n    return evidence.map(createEvidenceSelection);\n  }\n\n  const hasSelectionEvidence =\n    typeof evidence.quote === \"string\" ||\n    typeof evidence.sentence_id === \"string\";\n\n  return hasSelectionEvidence ? createEvidenceSelection(evidence) : undefined;\n}\n\nfunction createEvidenceSelection(evidence: {\n  readonly quote?: unknown;\n  readonly sentence_id?: unknown;\n}): {\n  readonly quote?: string;\n  readonly sentence_id?: string;\n} {\n  return {\n    ...(typeof evidence.quote === \"string\" ? { quote: evidence.quote } : {}),\n    ...(typeof evidence.sentence_id === \"string\"\n      ? { sentence_id: evidence.sentence_id }\n      : {}),\n  };\n}\n\nfunction toEvidenceResolutionFailure(\n  failure: {\n    readonly candidates: readonly EvidenceSelectionCandidate[];\n    readonly code: string;\n    readonly message: string;\n  },\n  fieldName: string,\n): EvidenceResolutionFailure {\n  return {\n    candidates: failure.candidates.map(toRankedSentenceCandidate),\n    code: failure.code,\n    fieldName,\n    message: failure.message,\n  };\n}\n\nfunction toRankedSentenceCandidate(\n  candidate: EvidenceSelectionCandidate,\n): RankedSentenceCandidate {\n  return {\n    exactNormalized: candidate.exactNormalized,\n    exactRaw: candidate.exactRaw,\n    exactSubstring: candidate.exactSubstring,\n    index: candidate.index,\n    nextText: candidate.nextText,\n    occurrenceId: candidate.occurrenceId,\n    prevText: candidate.prevText,\n    score: candidate.score,\n    sentenceId: candidate.sentence.sentenceId,\n    text: candidate.sentence.text,\n  };\n}\n"],"mappings":"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","names":["ChunkMetadataField","resolved","resolveFailure"]}

package/dist/reader/chunk-batch/prompt-templates.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/reader/chunk-batch/prompt-templates.ts"],"sourcesContent":["export const USER_FOCUSED_PROMPT_TEMPLATE =\n  \"topologization/user_focused_extraction\";\nexport const BOOK_COHERENCE_PROMPT_TEMPLATE =\n  \"topologization/book_coherence_extraction\";\nexport const EVIDENCE_CHOICE_PROMPT_TEMPLATE = \"topologization/evidence_choice\";\nexport const TRANSLATE_CHUNKS_PROMPT_TEMPLATE =\n  \"topologization/translate_chunks\";\n"],"mappings":"AAAO,MAAM,+BACX;AACK,MAAM,iCACX;AACK,MAAM,kCAAkC;AACxC,MAAM,mCACX;","names":[]}

package/dist/reader/chunk-batch/types.d.ts

@@ -1,85 +0,0 @@
-import { Language } from '../../common/language.js';
-import { LLM } from '../../llm/client.js';
-import { SentenceId, ChunkRetention, ChunkImportance } from '../../document/types.js';
-import '../../llm/context.js';
-import '../../llm/cache.js';
-import '../../llm/types.js';
-import 'ai';
-
-interface ChunkLink {
-    readonly from: number | string;
-    readonly strength?: string;
-    readonly to: number | string;
-}
-interface ChunkImportanceAnnotation {
-    readonly chunkId: number;
-    readonly importance: ChunkImportance;
-}
-interface CognitiveChunk {
-    id: number;
-    generation: number;
-    sentenceId: SentenceId;
-    label: string;
-    content: string;
-    sentenceIds: SentenceId[];
-    links: number[];
-    retention?: ChunkRetention;
-    importance?: ChunkImportance;
-    wordsCount: number;
-}
-interface ChunkBatch {
-    readonly chunks: CognitiveChunk[];
-    readonly tempIds: string[];
-    readonly links: readonly ChunkLink[];
-    readonly orderCorrect: boolean;
-    readonly importanceAnnotations?: readonly ChunkImportanceAnnotation[];
-}
-interface ChunkExtractionScopes<S extends string> {
-    readonly choice: S;
-    readonly extraction: S;
-}
-interface SentenceTextSource {
-    getSentence(sentenceId: SentenceId): Promise<string>;
-}
-interface ChunkTranslationInput {
-    readonly content: string;
-    readonly id: number;
-    readonly label: string;
-    readonly sourceSentences: readonly string[];
-}
-interface ChunkTranslationOutput {
-    readonly content: string;
-    readonly id: number;
-    readonly label: string;
-}
-interface ChunkBatchOptions<S extends string> {
-    readonly extractionGuidance: string;
-    readonly llm: LLM<S>;
-    readonly scopes: ChunkExtractionScopes<S>;
-    readonly sentenceTextSource: SentenceTextSource;
-    readonly userLanguage?: Language;
-}
-interface ChunkExtractionSentence {
-    readonly sentenceId: SentenceId;
-    readonly text: string;
-    readonly wordsCount: number;
-}
-interface ExtractUserFocusedInput {
-    readonly text: string;
-    readonly workingMemoryPrompt: string;
-    readonly visibleChunkIds: readonly number[];
-    readonly sentences: readonly ChunkExtractionSentence[];
-}
-interface ExtractUserFocusedResult {
-    readonly chunkBatch: ChunkBatch;
-    readonly fragmentSummary: string;
-}
-interface ExtractBookCoherenceInput {
-    readonly text: string;
-    readonly workingMemoryPrompt: string;
-    readonly visibleChunkIds: readonly number[];
-    readonly sentences: readonly ChunkExtractionSentence[];
-    readonly userFocusedChunks: readonly CognitiveChunk[];
-}
-
-export type { ChunkBatch, ChunkBatchOptions, ChunkExtractionScopes, ChunkExtractionSentence, ChunkImportanceAnnotation, ChunkLink, ChunkTranslationInput, ChunkTranslationOutput, CognitiveChunk, ExtractBookCoherenceInput, ExtractUserFocusedInput, ExtractUserFocusedResult, SentenceTextSource };

package/dist/reader/index.d.ts

@@ -1,13 +0,0 @@
-export { Reader } from './reader.js';
-export { segmentTextStream } from './segment/segment.js';
-export { ReaderChunk, ReaderGraphDelta, ReaderGraphEdge, ReaderImportanceAnnotation, ReaderOptions, ReaderSegment, ReaderSegmenter, ReaderSentence, ReaderTextStream } from './types.js';
-import './segment/types.js';
-import './attention/attention.js';
-import './chunk-batch/types.js';
-import '../common/language.js';
-import '../llm/client.js';
-import '../llm/context.js';
-import '../llm/cache.js';
-import '../llm/types.js';
-import 'ai';
-import '../document/types.js';

package/dist/reader/index.js

@@ -1,7 +0,0 @@
-import { Reader } from "./reader.js";
-import { segmentTextStream } from "./segment/segment.js";
-export {
-  Reader,
-  segmentTextStream
-};
-//# sourceMappingURL=index.js.map

package/dist/reader/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/reader/index.ts"],"sourcesContent":["export { Reader } from \"./reader.js\";\nexport { segmentTextStream } from \"./segment/segment.js\";\nexport type {\n  ReaderChunk,\n  ReaderGraphDelta,\n  ReaderGraphEdge,\n  ReaderImportanceAnnotation,\n  ReaderOptions,\n  ReaderSegment,\n  ReaderSegmenter,\n  ReaderSentence,\n  ReaderTextStream,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,cAAc;AACvB,SAAS,yBAAyB;","names":[]}

package/dist/reader/reader.d.ts

@@ -1,37 +0,0 @@
-import { ReaderOptions, ReaderTextStream, ReaderSegment, ReaderSentence, ReaderGraphDelta, ReaderChunk } from './types.js';
-import './attention/attention.js';
-import './chunk-batch/types.js';
-import '../common/language.js';
-import '../llm/client.js';
-import '../llm/context.js';
-import '../llm/cache.js';
-import '../llm/types.js';
-import 'ai';
-import '../document/types.js';
-import './segment/types.js';
-
-declare class Reader<S extends string> {
-    #private;
-    constructor(options: ReaderOptions<S>);
-    get capacity(): number;
-    segment(stream: ReaderTextStream): AsyncIterable<ReaderSegment>;
-    extractUserFocused(input: {
-        readonly sentences: readonly ReaderSentence[];
-        readonly text: string;
-    }): Promise<{
-        readonly delta: ReaderGraphDelta;
-        readonly fragmentSummary: string;
-    }>;
-    extractBookCoherence(input: {
-        readonly sentences: readonly ReaderSentence[];
-        readonly text: string;
-        readonly userFocusedChunks: readonly ReaderChunk[];
-    }): Promise<ReaderGraphDelta>;
-    completeFragment(input: {
-        readonly allChunks: readonly ReaderChunk[];
-        readonly getSuccessorChunkIds: (chunkId: number) => readonly number[];
-    }): void;
-    clear(): void;
-}
-
-export { Reader };

package/dist/reader/reader.js

@@ -1,82 +0,0 @@
-import { Attention } from "./attention/attention.js";
-import {
-  extractBookCoherenceChunkBatch,
-  extractUserFocusedChunkBatch
-} from "./chunk-batch/extract.js";
-import { segmentTextStream } from "./segment/segment.js";
-class Reader {
-  #attention;
-  #chunkBatchOptions;
-  #segmenter;
-  constructor(options) {
-    this.#attention = new Attention(
-      options.attention.capacity,
-      options.attention.generationDecayFactor,
-      options.attention.idGenerator
-    );
-    this.#chunkBatchOptions = {
-      extractionGuidance: options.extractionGuidance,
-      llm: options.llm,
-      scopes: options.scopes,
-      sentenceTextSource: options.sentenceTextSource,
-      ...options.userLanguage === void 0 ? {} : {
-        userLanguage: options.userLanguage
-      }
-    };
-    this.#segmenter = options.segmenter;
-  }
-  get capacity() {
-    return this.#attention.capacity;
-  }
-  segment(stream) {
-    if (this.#segmenter === void 0) {
-      return segmentTextStream(stream);
-    }
-    return segmentTextStream(stream, {
-      adapter: this.#segmenter
-    });
-  }
-  async extractUserFocused(input) {
-    const context = this.#attention.createChunkBatchContext();
-    const result = await extractUserFocusedChunkBatch(this.#chunkBatchOptions, {
-      sentences: input.sentences,
-      text: input.text,
-      visibleChunkIds: context.visibleChunkIds,
-      workingMemoryPrompt: context.workingMemoryPrompt
-    });
-    return {
-      delta: await this.#attention.acceptChunkBatch(result.chunkBatch),
-      fragmentSummary: result.fragmentSummary
-    };
-  }
-  async extractBookCoherence(input) {
-    const context = this.#attention.createChunkBatchContext({
-      includeCurrentFragment: false
-    });
-    const linkableChunkIds = [
-      ...context.visibleChunkIds,
-      ...input.userFocusedChunks.map((chunk) => chunk.id)
-    ];
-    const chunkBatch = await extractBookCoherenceChunkBatch(
-      this.#chunkBatchOptions,
-      {
-        sentences: input.sentences,
-        text: input.text,
-        userFocusedChunks: input.userFocusedChunks,
-        visibleChunkIds: linkableChunkIds,
-        workingMemoryPrompt: context.workingMemoryPrompt
-      }
-    );
-    return await this.#attention.acceptChunkBatch(chunkBatch);
-  }
-  completeFragment(input) {
-    this.#attention.completeFragment(input);
-  }
-  clear() {
-    this.#attention.clear();
-  }
-}
-export {
-  Reader
-};
-//# sourceMappingURL=reader.js.map

package/dist/reader/reader.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/reader/reader.ts"],"sourcesContent":["import { Attention } from \"./attention/attention.js\";\nimport {\n  extractBookCoherenceChunkBatch,\n  extractUserFocusedChunkBatch,\n} from \"./chunk-batch/extract.js\";\nimport { segmentTextStream } from \"./segment/segment.js\";\nimport type { ChunkBatchOptions } from \"./chunk-batch/types.js\";\nimport type {\n  ReaderChunk,\n  ReaderGraphDelta,\n  ReaderOptions,\n  ReaderSegment,\n  ReaderSentence,\n  ReaderTextStream,\n} from \"./types.js\";\n\nexport class Reader<S extends string> {\n  readonly #attention: Attention;\n  readonly #chunkBatchOptions: ChunkBatchOptions<S>;\n  readonly #segmenter: ReaderOptions<S>[\"segmenter\"];\n\n  public constructor(options: ReaderOptions<S>) {\n    this.#attention = new Attention(\n      options.attention.capacity,\n      options.attention.generationDecayFactor,\n      options.attention.idGenerator,\n    );\n    this.#chunkBatchOptions = {\n      extractionGuidance: options.extractionGuidance,\n      llm: options.llm,\n      scopes: options.scopes,\n      sentenceTextSource: options.sentenceTextSource,\n      ...(options.userLanguage === undefined\n        ? {}\n        : {\n            userLanguage: options.userLanguage,\n          }),\n    };\n    this.#segmenter = options.segmenter;\n  }\n\n  public get capacity(): number {\n    return this.#attention.capacity;\n  }\n\n  public segment(stream: ReaderTextStream): AsyncIterable<ReaderSegment> {\n    if (this.#segmenter === undefined) {\n      return segmentTextStream(stream);\n    }\n\n    return segmentTextStream(stream, {\n      adapter: this.#segmenter,\n    });\n  }\n\n  public async extractUserFocused(input: {\n    readonly sentences: readonly ReaderSentence[];\n    readonly text: string;\n  }): Promise<{\n    readonly delta: ReaderGraphDelta;\n    readonly fragmentSummary: string;\n  }> {\n    const context = this.#attention.createChunkBatchContext();\n    const result = await extractUserFocusedChunkBatch(this.#chunkBatchOptions, {\n      sentences: input.sentences,\n      text: input.text,\n      visibleChunkIds: context.visibleChunkIds,\n      workingMemoryPrompt: context.workingMemoryPrompt,\n    });\n\n    return {\n      delta: await this.#attention.acceptChunkBatch(result.chunkBatch),\n      fragmentSummary: result.fragmentSummary,\n    };\n  }\n\n  public async extractBookCoherence(input: {\n    readonly sentences: readonly ReaderSentence[];\n    readonly text: string;\n    readonly userFocusedChunks: readonly ReaderChunk[];\n  }): Promise<ReaderGraphDelta> {\n    const context = this.#attention.createChunkBatchContext({\n      includeCurrentFragment: false,\n    });\n    const linkableChunkIds = [\n      ...context.visibleChunkIds,\n      ...input.userFocusedChunks.map((chunk) => chunk.id),\n    ];\n    const chunkBatch = await extractBookCoherenceChunkBatch(\n      this.#chunkBatchOptions,\n      {\n        sentences: input.sentences,\n        text: input.text,\n        userFocusedChunks: input.userFocusedChunks,\n        visibleChunkIds: linkableChunkIds,\n        workingMemoryPrompt: context.workingMemoryPrompt,\n      },\n    );\n\n    return await this.#attention.acceptChunkBatch(chunkBatch);\n  }\n\n  public completeFragment(input: {\n    readonly allChunks: readonly ReaderChunk[];\n    readonly getSuccessorChunkIds: (chunkId: number) => readonly number[];\n  }): void {\n    this.#attention.completeFragment(input);\n  }\n\n  public clear(): void {\n    this.#attention.clear();\n  }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,yBAAyB;AAW3B,MAAM,OAAyB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EAEF,YAAY,SAA2B;AAC5C,SAAK,aAAa,IAAI;AAAA,MACpB,QAAQ,UAAU;AAAA,MAClB,QAAQ,UAAU;AAAA,MAClB,QAAQ,UAAU;AAAA,IACpB;AACA,SAAK,qBAAqB;AAAA,MACxB,oBAAoB,QAAQ;AAAA,MAC5B,KAAK,QAAQ;AAAA,MACb,QAAQ,QAAQ;AAAA,MAChB,oBAAoB,QAAQ;AAAA,MAC5B,GAAI,QAAQ,iBAAiB,SACzB,CAAC,IACD;AAAA,QACE,cAAc,QAAQ;AAAA,MACxB;AAAA,IACN;AACA,SAAK,aAAa,QAAQ;AAAA,EAC5B;AAAA,EAEA,IAAW,WAAmB;AAC5B,WAAO,KAAK,WAAW;AAAA,EACzB;AAAA,EAEO,QAAQ,QAAwD;AACrE,QAAI,KAAK,eAAe,QAAW;AACjC,aAAO,kBAAkB,MAAM;AAAA,IACjC;AAEA,WAAO,kBAAkB,QAAQ;AAAA,MAC/B,SAAS,KAAK;AAAA,IAChB,CAAC;AAAA,EACH;AAAA,EAEA,MAAa,mBAAmB,OAM7B;AACD,UAAM,UAAU,KAAK,WAAW,wBAAwB;AACxD,UAAM,SAAS,MAAM,6BAA6B,KAAK,oBAAoB;AAAA,MACzE,WAAW,MAAM;AAAA,MACjB,MAAM,MAAM;AAAA,MACZ,iBAAiB,QAAQ;AAAA,MACzB,qBAAqB,QAAQ;AAAA,IAC/B,CAAC;AAED,WAAO;AAAA,MACL,OAAO,MAAM,KAAK,WAAW,iBAAiB,OAAO,UAAU;AAAA,MAC/D,iBAAiB,OAAO;AAAA,IAC1B;AAAA,EACF;AAAA,EAEA,MAAa,qBAAqB,OAIJ;AAC5B,UAAM,UAAU,KAAK,WAAW,wBAAwB;AAAA,MACtD,wBAAwB;AAAA,IAC1B,CAAC;AACD,UAAM,mBAAmB;AAAA,MACvB,GAAG,QAAQ;AAAA,MACX,GAAG,MAAM,kBAAkB,IAAI,CAAC,UAAU,MAAM,EAAE;AAAA,IACpD;AACA,UAAM,aAAa,MAAM;AAAA,MACvB,KAAK;AAAA,MACL;AAAA,QACE,WAAW,MAAM;AAAA,QACjB,MAAM,MAAM;AAAA,QACZ,mBAAmB,MAAM;AAAA,QACzB,iBAAiB;AAAA,QACjB,qBAAqB,QAAQ;AAAA,MAC/B;AAAA,IACF;AAEA,WAAO,MAAM,KAAK,WAAW,iBAAiB,UAAU;AAAA,EAC1D;AAAA,EAEO,iBAAiB,OAGf;AACP,SAAK,WAAW,iBAAiB,KAAK;AAAA,EACxC;AAAA,EAEO,QAAc;AACnB,SAAK,WAAW,MAAM;AAAA,EACxB;AACF;","names":[]}

package/dist/reader/segment/index.d.ts

@@ -1,2 +0,0 @@
-export { segmentTextStream } from './segment.js';
-export { SegmentTextStreamOptions, SentenceStreamAdapter, SentenceStreamItem, TextStream } from './types.js';

package/dist/reader/segment/index.js

@@ -1,5 +0,0 @@
-import { segmentTextStream } from "./segment.js";
-export {
-  segmentTextStream
-};
-//# sourceMappingURL=index.js.map

package/dist/reader/segment/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/reader/segment/index.ts"],"sourcesContent":["export { segmentTextStream } from \"./segment.js\";\nexport type {\n  SegmentTextStreamOptions,\n  SentenceStreamAdapter,\n  SentenceStreamItem,\n  TextStream,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,yBAAyB;","names":[]}

package/dist/reader/segment/intl-segmenter.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/reader/segment/intl-segmenter.ts"],"sourcesContent":["import type {\n  SentenceStreamAdapter,\n  SentenceStreamItem,\n  TextStream,\n} from \"./types.js\";\n\nconst SENTENCE_BOUNDARY_PATTERN =\n  /(?:[.!?。！？…]+|(?:\\r?\\n)\\s*(?:\\r?\\n)?|[.!?。！？…]+[\"'”’」』】）》〉〕〗]*)$/u;\n\nclass IntlSegmenterSentenceStreamAdapter implements SentenceStreamAdapter {\n  readonly #graphemeSegmenter = new Intl.Segmenter(undefined, {\n    granularity: \"grapheme\",\n  });\n  readonly #sentenceSegmenter = new Intl.Segmenter(undefined, {\n    granularity: \"sentence\",\n  });\n  readonly #wordSegmenter = new Intl.Segmenter(undefined, {\n    granularity: \"word\",\n  });\n\n  public async *pipe(stream: TextStream): AsyncIterable<SentenceStreamItem> {\n    let buffer = \"\";\n    let offset = 0;\n\n    for await (const chunk of stream) {\n      if (chunk === \"\") {\n        continue;\n      }\n\n      buffer += chunk;\n\n      const { remainder, sentences } = this.#drainSentences(buffer, false);\n      buffer = remainder;\n\n      for (const sentenceText of sentences) {\n        yield {\n          offset,\n          text: sentenceText,\n          wordsCount: this.#countWords(sentenceText),\n        };\n        offset += sentenceText.length;\n      }\n    }\n\n    const { sentences } = this.#drainSentences(buffer, true);\n\n    for (const sentenceText of sentences) {\n      yield {\n        offset,\n        text: sentenceText,\n        wordsCount: this.#countWords(sentenceText),\n      };\n      offset += sentenceText.length;\n    }\n  }\n\n  #drainSentences(\n    buffer: string,\n    flushAll: boolean,\n  ): {\n    readonly remainder: string;\n    readonly sentences: readonly string[];\n  } {\n    if (buffer.trim() === \"\") {\n      return {\n        remainder: \"\",\n        sentences: [],\n      };\n    }\n\n    const segments = Array.from(this.#sentenceSegmenter.segment(buffer));\n\n    if (segments.length === 0) {\n      return {\n        remainder: buffer,\n        sentences: [],\n      };\n    }\n\n    if (flushAll || this.#endsWithSentenceBoundary(buffer)) {\n      return {\n        remainder: \"\",\n        sentences: segments\n          .map((segment) => segment.segment.trim())\n          .filter((segment) => segment !== \"\"),\n      };\n    }\n\n    const lastSegment = segments[segments.length - 1];\n\n    if (lastSegment === undefined) {\n      return {\n        remainder: buffer,\n        sentences: [],\n      };\n    }\n\n    return {\n      remainder: buffer.slice(lastSegment.index),\n      sentences: segments\n        .slice(0, -1)\n        .map((segment) => segment.segment.trim())\n        .filter((segment) => segment !== \"\"),\n    };\n  }\n\n  #countWords(text: string): number {\n    let wordsCount = 0;\n\n    for (const segment of this.#wordSegmenter.segment(text)) {\n      if (\"isWordLike\" in segment && segment.isWordLike) {\n        wordsCount += 1;\n      }\n    }\n\n    if (wordsCount > 0) {\n      return wordsCount;\n    }\n\n    return this.#countGraphemes(text);\n  }\n\n  #countGraphemes(text: string): number {\n    let unitCount = 0;\n\n    for (const _segment of this.#graphemeSegmenter.segment(text)) {\n      unitCount += 1;\n    }\n\n    return unitCount;\n  }\n\n  #endsWithSentenceBoundary(buffer: string): boolean {\n    return SENTENCE_BOUNDARY_PATTERN.test(buffer.trimEnd());\n  }\n}\n\nexport function createDefaultSentenceStreamAdapter(): SentenceStreamAdapter {\n  return new IntlSegmenterSentenceStreamAdapter();\n}\n"],"mappings":"AAMA,MAAM,4BACJ;AAEF,MAAM,mCAAoE;AAAA,EAC/D,qBAAqB,IAAI,KAAK,UAAU,QAAW;AAAA,IAC1D,aAAa;AAAA,EACf,CAAC;AAAA,EACQ,qBAAqB,IAAI,KAAK,UAAU,QAAW;AAAA,IAC1D,aAAa;AAAA,EACf,CAAC;AAAA,EACQ,iBAAiB,IAAI,KAAK,UAAU,QAAW;AAAA,IACtD,aAAa;AAAA,EACf,CAAC;AAAA,EAED,OAAc,KAAK,QAAuD;AACxE,QAAI,SAAS;AACb,QAAI,SAAS;AAEb,qBAAiB,SAAS,QAAQ;AAChC,UAAI,UAAU,IAAI;AAChB;AAAA,MACF;AAEA,gBAAU;AAEV,YAAM,EAAE,WAAW,WAAAA,WAAU,IAAI,KAAK,gBAAgB,QAAQ,KAAK;AACnE,eAAS;AAET,iBAAW,gBAAgBA,YAAW;AACpC,cAAM;AAAA,UACJ;AAAA,UACA,MAAM;AAAA,UACN,YAAY,KAAK,YAAY,YAAY;AAAA,QAC3C;AACA,kBAAU,aAAa;AAAA,MACzB;AAAA,IACF;AAEA,UAAM,EAAE,UAAU,IAAI,KAAK,gBAAgB,QAAQ,IAAI;AAEvD,eAAW,gBAAgB,WAAW;AACpC,YAAM;AAAA,QACJ;AAAA,QACA,MAAM;AAAA,QACN,YAAY,KAAK,YAAY,YAAY;AAAA,MAC3C;AACA,gBAAU,aAAa;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,gBACE,QACA,UAIA;AACA,QAAI,OAAO,KAAK,MAAM,IAAI;AACxB,aAAO;AAAA,QACL,WAAW;AAAA,QACX,WAAW,CAAC;AAAA,MACd;AAAA,IACF;AAEA,UAAM,WAAW,MAAM,KAAK,KAAK,mBAAmB,QAAQ,MAAM,CAAC;AAEnE,QAAI,SAAS,WAAW,GAAG;AACzB,aAAO;AAAA,QACL,WAAW;AAAA,QACX,WAAW,CAAC;AAAA,MACd;AAAA,IACF;AAEA,QAAI,YAAY,KAAK,0BAA0B,MAAM,GAAG;AACtD,aAAO;AAAA,QACL,WAAW;AAAA,QACX,WAAW,SACR,IAAI,CAAC,YAAY,QAAQ,QAAQ,KAAK,CAAC,EACvC,OAAO,CAAC,YAAY,YAAY,EAAE;AAAA,MACvC;AAAA,IACF;AAEA,UAAM,cAAc,SAAS,SAAS,SAAS,CAAC;AAEhD,QAAI,gBAAgB,QAAW;AAC7B,aAAO;AAAA,QACL,WAAW;AAAA,QACX,WAAW,CAAC;AAAA,MACd;AAAA,IACF;AAEA,WAAO;AAAA,MACL,WAAW,OAAO,MAAM,YAAY,KAAK;AAAA,MACzC,WAAW,SACR,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,YAAY,QAAQ,QAAQ,KAAK,CAAC,EACvC,OAAO,CAAC,YAAY,YAAY,EAAE;AAAA,IACvC;AAAA,EACF;AAAA,EAEA,YAAY,MAAsB;AAChC,QAAI,aAAa;AAEjB,eAAW,WAAW,KAAK,eAAe,QAAQ,IAAI,GAAG;AACvD,UAAI,gBAAgB,WAAW,QAAQ,YAAY;AACjD,sBAAc;AAAA,MAChB;AAAA,IACF;AAEA,QAAI,aAAa,GAAG;AAClB,aAAO;AAAA,IACT;AAEA,WAAO,KAAK,gBAAgB,IAAI;AAAA,EAClC;AAAA,EAEA,gBAAgB,MAAsB;AACpC,QAAI,YAAY;AAEhB,eAAW,YAAY,KAAK,mBAAmB,QAAQ,IAAI,GAAG;AAC5D,mBAAa;AAAA,IACf;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,0BAA0B,QAAyB;AACjD,WAAO,0BAA0B,KAAK,OAAO,QAAQ,CAAC;AAAA,EACxD;AACF;AAEO,SAAS,qCAA4D;AAC1E,SAAO,IAAI,mCAAmC;AAChD;","names":["sentences"]}

package/dist/reader/segment/segment.js

@@ -1,9 +0,0 @@
-import { createDefaultSentenceStreamAdapter } from "./intl-segmenter.js";
-function segmentTextStream(stream, options) {
-  const adapter = options?.adapter ?? createDefaultSentenceStreamAdapter();
-  return adapter.pipe(stream);
-}
-export {
-  segmentTextStream
-};
-//# sourceMappingURL=segment.js.map

package/dist/reader/segment/segment.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/reader/segment/segment.ts"],"sourcesContent":["import { createDefaultSentenceStreamAdapter } from \"./intl-segmenter.js\";\nimport type {\n  SegmentTextStreamOptions,\n  SentenceStreamItem,\n  TextStream,\n} from \"./types.js\";\n\nexport function segmentTextStream(\n  stream: TextStream,\n  options?: SegmentTextStreamOptions,\n): AsyncIterable<SentenceStreamItem> {\n  const adapter = options?.adapter ?? createDefaultSentenceStreamAdapter();\n\n  return adapter.pipe(stream);\n}\n"],"mappings":"AAAA,SAAS,0CAA0C;AAO5C,SAAS,kBACd,QACA,SACmC;AACnC,QAAM,UAAU,SAAS,WAAW,mCAAmC;AAEvE,SAAO,QAAQ,KAAK,MAAM;AAC5B;","names":[]}

package/dist/reader/types.d.ts

@@ -1,29 +0,0 @@
-import { ChunkGraphDelta, ChunkGraphEdge } from './attention/attention.js';
-import { ChunkBatchOptions, ChunkExtractionSentence, CognitiveChunk, ChunkImportanceAnnotation } from './chunk-batch/types.js';
-import { TextStream, SentenceStreamAdapter, SentenceStreamItem } from './segment/types.js';
-import '../common/language.js';
-import '../llm/client.js';
-import '../llm/context.js';
-import '../llm/cache.js';
-import '../llm/types.js';
-import 'ai';
-import '../document/types.js';
-
-type ReaderTextStream = TextStream;
-type ReaderSegment = SentenceStreamItem;
-type ReaderSegmenter = SentenceStreamAdapter;
-type ReaderSentence = ChunkExtractionSentence;
-type ReaderChunk = CognitiveChunk;
-type ReaderGraphEdge = ChunkGraphEdge;
-type ReaderImportanceAnnotation = ChunkImportanceAnnotation;
-type ReaderGraphDelta = ChunkGraphDelta;
-interface ReaderOptions<S extends string> extends ChunkBatchOptions<S> {
-    readonly attention: {
-        readonly capacity: number;
-        readonly generationDecayFactor: number;
-        readonly idGenerator: () => Promise<number>;
-    };
-    readonly segmenter?: ReaderSegmenter;
-}
-
-export type { ReaderChunk, ReaderGraphDelta, ReaderGraphEdge, ReaderImportanceAnnotation, ReaderOptions, ReaderSegment, ReaderSegmenter, ReaderSentence, ReaderTextStream };

package/dist/source/epub/archive.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/source/epub/archive.ts"],"sourcesContent":["import { createHash } from \"crypto\";\nimport { posix } from \"path\";\nimport { PassThrough, type Readable } from \"stream\";\nimport type { Entry, ZipFile } from \"yauzl\";\nimport { open } from \"yauzl\";\n\nexport class EpubArchive {\n  readonly #path: string;\n  readonly #zipFile: ZipFile;\n  readonly #entries: ReadonlyMap<string, Entry>;\n  #closed = false;\n\n  public constructor(\n    path: string,\n    zipFile: ZipFile,\n    entries: ReadonlyMap<string, Entry>,\n  ) {\n    this.#path = path;\n    this.#zipFile = zipFile;\n    this.#entries = entries;\n  }\n\n  public static async open(path: string): Promise<EpubArchive> {\n    const zipFile = await openZipFile(path);\n    const entries = await indexEntries(zipFile);\n\n    return new EpubArchive(path, zipFile, entries);\n  }\n\n  public close(): Promise<void> {\n    if (this.#closed) {\n      return Promise.resolve();\n    }\n\n    this.#closed = true;\n    this.#zipFile.close();\n\n    return Promise.resolve();\n  }\n\n  public hasEntry(path: string): boolean {\n    return this.#entries.has(normalizeArchivePath(path));\n  }\n\n  public listEntries(): readonly string[] {\n    return [...this.#entries.keys()];\n  }\n\n  public async openReadStream(path: string): Promise<Readable> {\n    const entry = this.#getEntry(path);\n\n    return await openEntryStream(this.#zipFile, entry);\n  }\n\n  public async readText(path: string): Promise<string> {\n    const stream = await this.openReadStream(path);\n    return (await readStreamToBuffer(stream)).toString(\"utf8\");\n  }\n\n  public async readBuffer(path: string): Promise<Buffer> {\n    const stream = await this.openReadStream(path);\n    return await readStreamToBuffer(stream);\n  }\n\n  public resolveRelativePath(basePath: string, href: string): string {\n    const normalizedHref = normalizeHref(href);\n    if (normalizedHref === \"\") {\n      throw new Error(`Invalid EPUB href: ${href}`);\n    }\n\n    return normalizeArchivePath(\n      posix.join(posix.dirname(normalizeArchivePath(basePath)), normalizedHref),\n    );\n  }\n\n  public createSectionId(path: string, fragment?: string): string {\n    const normalizedPath = normalizeArchivePath(path);\n\n    if (fragment === undefined || fragment === \"\") {\n      return normalizedPath;\n    }\n\n    return `${normalizedPath}#${fragment}`;\n  }\n\n  public createSyntheticSectionId(path: string, title?: string): string {\n    const normalizedPath = normalizeArchivePath(path);\n    const hash = createHash(\"sha1\")\n      .update(`${normalizedPath}:${title ?? \"\"}`)\n      .digest(\"hex\")\n      .slice(0, 10);\n\n    return `toc:${hash}`;\n  }\n\n  public get path(): string {\n    return this.#path;\n  }\n\n  #getEntry(path: string): Entry {\n    const normalizedPath = normalizeArchivePath(path);\n    const entry = this.#entries.get(normalizedPath);\n\n    if (entry === undefined) {\n      throw new Error(`EPUB entry does not exist: ${normalizedPath}`);\n    }\n\n    return entry;\n  }\n}\n\nexport function normalizeArchivePath(path: string): string {\n  const normalized = path.replaceAll(\"\\\\\", \"/\").trim();\n  const withoutFragment = normalized.startsWith(\"/\")\n    ? normalized.slice(1)\n    : normalized;\n\n  return posix\n    .normalize(withoutFragment)\n    .replace(/^(\\.\\/)+/, \"\")\n    .replace(/^\\/+/, \"\");\n}\n\nexport function normalizeHref(href: string): string {\n  const [path] = href.split(\"#\", 1);\n\n  return normalizeArchivePath(path ?? \"\");\n}\n\nexport function normalizeFragment(\n  fragment: string | undefined,\n): string | undefined {\n  if (fragment === undefined) {\n    return undefined;\n  }\n\n  const normalized = fragment.startsWith(\"#\") ? fragment.slice(1) : fragment;\n\n  return normalized === \"\" ? undefined : normalized;\n}\n\nexport function splitHref(href: string): {\n  readonly path: string;\n  readonly fragment: string | undefined;\n} {\n  const [pathPart, fragmentPart] = href.split(\"#\", 2);\n\n  return {\n    path: normalizeArchivePath(pathPart ?? \"\"),\n    fragment: normalizeFragment(fragmentPart),\n  };\n}\n\nasync function openZipFile(path: string): Promise<ZipFile> {\n  return await new Promise((resolve, reject) => {\n    open(path, { autoClose: false, lazyEntries: true }, (error, zipFile) => {\n      if (error !== null || zipFile === undefined) {\n        reject(error ?? new Error(`Cannot open EPUB archive: ${path}`));\n        return;\n      }\n\n      resolve(zipFile);\n    });\n  });\n}\n\nasync function indexEntries(\n  zipFile: ZipFile,\n): Promise<ReadonlyMap<string, Entry>> {\n  return await new Promise((resolve, reject) => {\n    const entries = new Map<string, Entry>();\n\n    zipFile.on(\"entry\", (entry: Entry) => {\n      if (entry.fileName.endsWith(\"/\")) {\n        zipFile.readEntry();\n        return;\n      }\n\n      entries.set(normalizeArchivePath(entry.fileName), entry);\n      zipFile.readEntry();\n    });\n    zipFile.once(\"end\", () => {\n      resolve(entries);\n    });\n    zipFile.once(\"error\", (error: Error) => {\n      reject(error);\n    });\n\n    zipFile.readEntry();\n  });\n}\n\nfunction toBuffer(chunk: unknown): Buffer {\n  if (Buffer.isBuffer(chunk)) {\n    return chunk;\n  }\n\n  if (typeof chunk === \"string\") {\n    return Buffer.from(chunk, \"utf8\");\n  }\n\n  throw new Error(\"Unexpected ZIP stream chunk type\");\n}\n\nasync function readStreamToBuffer(stream: Readable): Promise<Buffer> {\n  return await new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n\n    stream.on(\"data\", (chunk: unknown) => {\n      chunks.push(toBuffer(chunk));\n    });\n    stream.once(\"end\", () => {\n      resolve(Buffer.concat(chunks));\n    });\n    stream.once(\"error\", (error: Error) => {\n      reject(error);\n    });\n    stream.resume();\n  });\n}\n\nasync function openEntryStream(\n  zipFile: ZipFile,\n  entry: Entry,\n): Promise<Readable> {\n  return await new Promise((resolve, reject) => {\n    zipFile.openReadStream(entry, (error, stream) => {\n      if (error !== null || stream === undefined) {\n        reject(error ?? new Error(`Cannot open EPUB entry: ${entry.fileName}`));\n        return;\n      }\n\n      resolve(normalizeEntryStream(stream));\n    });\n  });\n}\n\nfunction normalizeEntryStream(stream: Readable): Readable {\n  const normalized = new PassThrough();\n\n  stream.once(\"error\", (error: Error) => {\n    normalized.destroy(error);\n  });\n  normalized.once(\"close\", () => {\n    stream.unpipe(normalized);\n\n    if (!stream.destroyed) {\n      stream.destroy();\n    }\n  });\n\n  stream.pipe(normalized);\n\n  return normalized;\n}\n"],"mappings":"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","names":[]}

package/dist/source/epub/content.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/source/epub/content.ts"],"sourcesContent":["import type { Readable } from \"stream\";\n\nimport { Parser } from \"htmlparser2\";\n\nimport type { SourceTextStream } from \"../types.js\";\nimport type { EpubArchive } from \"./archive.js\";\n\nconst BLOCK_TAGS = new Set([\n  \"address\",\n  \"article\",\n  \"aside\",\n  \"blockquote\",\n  \"br\",\n  \"dd\",\n  \"div\",\n  \"dl\",\n  \"dt\",\n  \"figcaption\",\n  \"figure\",\n  \"footer\",\n  \"h1\",\n  \"h2\",\n  \"h3\",\n  \"h4\",\n  \"h5\",\n  \"h6\",\n  \"header\",\n  \"hr\",\n  \"li\",\n  \"main\",\n  \"nav\",\n  \"ol\",\n  \"p\",\n  \"pre\",\n  \"section\",\n  \"table\",\n  \"td\",\n  \"th\",\n  \"tr\",\n  \"ul\",\n]);\n\nconst SKIPPED_TAGS = new Set([\"script\", \"style\"]);\n\nexport interface EpubSectionTarget {\n  readonly id: string;\n  readonly path: string;\n  readonly fragment: string | undefined;\n}\n\nexport interface EpubSectionAnalysis {\n  readonly hasContent: boolean;\n  readonly wordsCount: number;\n}\n\nexport class EpubContentLoader {\n  readonly #archive: EpubArchive;\n  readonly #targetsBySectionId: ReadonlyMap<\n    string,\n    {\n      readonly path: string;\n      readonly targets: readonly EpubSectionTarget[];\n    }\n  >;\n\n  public constructor(\n    archive: EpubArchive,\n    targetsByPath: ReadonlyMap<string, readonly EpubSectionTarget[]>,\n  ) {\n    this.#archive = archive;\n    this.#targetsBySectionId = createTargetsBySectionId(targetsByPath);\n  }\n\n  public async openSection(sectionId: string): Promise<SourceTextStream> {\n    const target = this.#targetsBySectionId.get(sectionId);\n\n    if (target === undefined) {\n      return [];\n    }\n\n    const sections = await this.#parseSections(target.path, target.targets);\n\n    return [sections.get(sectionId) ?? \"\"];\n  }\n\n  async #parseSections(\n    path: string,\n    targets: readonly EpubSectionTarget[],\n  ): Promise<ReadonlyMap<string, string>> {\n    const stream = await this.#archive.openReadStream(path);\n    stream.setEncoding(\"utf8\");\n\n    return await parseHtmlSections(stream, targets);\n  }\n}\n\nexport async function analyzeSectionTargets(\n  archive: Pick<EpubArchive, \"openReadStream\">,\n  targetsByPath: ReadonlyMap<string, readonly EpubSectionTarget[]>,\n): Promise<ReadonlyMap<string, EpubSectionAnalysis>> {\n  const analyses = new Map<string, EpubSectionAnalysis>();\n\n  for (const [path, targets] of targetsByPath.entries()) {\n    const stream = await archive.openReadStream(path);\n    stream.setEncoding(\"utf8\");\n    const sections = await parseHtmlSectionTexts(stream, targets);\n\n    for (const target of targets) {\n      const text = sections.get(target.id) ?? \"\";\n\n      analyses.set(target.id, {\n        hasContent: text.trim() !== \"\",\n        wordsCount: countWords(text),\n      });\n    }\n  }\n\n  return analyses;\n}\n\nfunction createTargetsBySectionId(\n  targetsByPath: ReadonlyMap<string, readonly EpubSectionTarget[]>,\n): ReadonlyMap<\n  string,\n  {\n    readonly path: string;\n    readonly targets: readonly EpubSectionTarget[];\n  }\n> {\n  const targetsBySectionId = new Map<\n    string,\n    {\n      readonly path: string;\n      readonly targets: readonly EpubSectionTarget[];\n    }\n  >();\n\n  for (const [path, targets] of targetsByPath.entries()) {\n    for (const target of targets) {\n      targetsBySectionId.set(target.id, { path, targets });\n    }\n  }\n\n  return targetsBySectionId;\n}\n\nasync function parseHtmlSections(\n  stream: Readable,\n  targets: readonly EpubSectionTarget[],\n): Promise<ReadonlyMap<string, string>> {\n  return await parseHtmlSectionTexts(stream, targets);\n}\n\nasync function parseHtmlSectionTexts(\n  stream: Readable,\n  targets: readonly EpubSectionTarget[],\n): Promise<ReadonlyMap<string, string>> {\n  const fragments = new Map<string, number>();\n  const sections = new Map<string, string>();\n  const orderedTargets = [...targets];\n  const buffers = orderedTargets.map(() => \"\");\n  const rootSectionIndex =\n    orderedTargets[0]?.fragment === undefined && orderedTargets[0] !== undefined\n      ? 0\n      : -1;\n  let currentIndex = rootSectionIndex;\n  let skippedTagDepth = 0;\n\n  orderedTargets.forEach((target, index) => {\n    sections.set(target.id, \"\");\n    if (target.fragment !== undefined && !fragments.has(target.fragment)) {\n      fragments.set(target.fragment, index);\n    }\n  });\n\n  const parser = new Parser(\n    {\n      onopentag(name, attributes) {\n        const tagName = name.toLowerCase();\n        if (SKIPPED_TAGS.has(tagName)) {\n          skippedTagDepth += 1;\n          return;\n        }\n\n        const anchorId = attributes.id ?? attributes[\"xml:id\"];\n        if (anchorId !== undefined) {\n          const nextIndex = fragments.get(anchorId);\n          if (nextIndex !== undefined && nextIndex > currentIndex) {\n            currentIndex = nextIndex;\n          }\n        }\n\n        if (tagName === \"br\") {\n          appendText(buffers, currentIndex, \"\\n\");\n        }\n      },\n      ontext(text) {\n        if (skippedTagDepth > 0) {\n          return;\n        }\n\n        appendText(buffers, currentIndex, text);\n      },\n      onclosetag(name) {\n        const tagName = name.toLowerCase();\n        if (SKIPPED_TAGS.has(tagName)) {\n          skippedTagDepth = Math.max(0, skippedTagDepth - 1);\n          return;\n        }\n\n        if (BLOCK_TAGS.has(tagName)) {\n          appendText(buffers, currentIndex, \"\\n\\n\");\n        }\n      },\n    },\n    { decodeEntities: true },\n  );\n\n  for await (const chunk of stream as AsyncIterable<unknown>) {\n    parser.write(toTextChunk(chunk));\n  }\n\n  parser.end();\n\n  orderedTargets.forEach((target, index) => {\n    sections.set(target.id, normalizeSectionText(buffers[index] ?? \"\"));\n  });\n\n  return sections;\n}\n\nfunction appendText(\n  buffers: string[],\n  currentIndex: number,\n  text: string,\n): void {\n  if (currentIndex < 0 || currentIndex >= buffers.length) {\n    return;\n  }\n\n  buffers[currentIndex] += text;\n}\n\nfunction normalizeSectionText(text: string): string {\n  return text\n    .replace(/\\r\\n/gu, \"\\n\")\n    .replace(/\\n{3,}/gu, \"\\n\\n\")\n    .trim();\n}\n\nfunction toTextChunk(chunk: unknown): string {\n  if (typeof chunk === \"string\") {\n    return chunk;\n  }\n\n  if (Buffer.isBuffer(chunk)) {\n    return chunk.toString(\"utf8\");\n  }\n\n  throw new Error(\"Unexpected HTML stream chunk type\");\n}\n\nfunction countWords(text: string): number {\n  return [...createWordSegmenter().segment(text)].filter(\n    (segment) => segment.isWordLike,\n  ).length;\n}\n\nlet WORD_SEGMENTER: Intl.Segmenter | undefined;\n\nfunction createWordSegmenter(): Intl.Segmenter {\n  if (WORD_SEGMENTER === undefined) {\n    WORD_SEGMENTER = new Intl.Segmenter(undefined, {\n      granularity: \"word\",\n    });\n  }\n\n  return WORD_SEGMENTER;\n}\n"],"mappings":"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","names":[]}

package/dist/source/epub/document.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/source/epub/document.ts"],"sourcesContent":["import type { SourceAdapter, SourceDocument } from \"../adapter.js\";\nimport type { SourceAsset, SourceSection, SourceTextStream } from \"../types.js\";\nimport { normalizeFragment } from \"./archive.js\";\nimport { EpubArchive } from \"./archive.js\";\nimport {\n  analyzeSectionTargets,\n  EpubContentLoader,\n  type EpubSectionAnalysis,\n  type EpubSectionTarget,\n} from \"./content.js\";\nimport { readEpubNavigation, type EpubNavigationItem } from \"./navigation.js\";\nimport { readEpubPackage, type EpubPackageData } from \"./package.js\";\n\ninterface SectionDefinition {\n  readonly hasContent: boolean;\n  readonly id: string;\n  readonly title: string | undefined;\n  readonly path: string | undefined;\n  readonly fragment: string | undefined;\n  readonly wordsCount: number;\n  readonly children: readonly SectionDefinition[];\n}\n\nclass EpubSourceSection implements SourceSection {\n  readonly #document: EpubSourceDocument;\n  readonly #definition: SectionDefinition;\n\n  public constructor(\n    document: EpubSourceDocument,\n    definition: SectionDefinition,\n  ) {\n    this.#document = document;\n    this.#definition = definition;\n  }\n\n  public get id(): string {\n    return this.#definition.id;\n  }\n\n  public get hasContent(): boolean {\n    return this.#definition.hasContent;\n  }\n\n  public get title(): string | undefined {\n    return this.#definition.title;\n  }\n\n  public get wordsCount(): number {\n    return this.#definition.wordsCount;\n  }\n\n  public get children(): readonly SourceSection[] {\n    return this.#definition.children.map(\n      (child) => new EpubSourceSection(this.#document, child),\n    );\n  }\n\n  public async open(): Promise<SourceTextStream> {\n    return await this.#document.openSection(this.#definition.id);\n  }\n}\n\nexport class EpubSourceDocument implements SourceDocument {\n  readonly #packageData: EpubPackageData;\n  readonly #cover: SourceAsset | undefined;\n  readonly #sections: readonly SectionDefinition[];\n  readonly #contentLoader: EpubContentLoader;\n\n  public constructor(\n    packageData: EpubPackageData,\n    cover: SourceAsset | undefined,\n    sections: readonly SectionDefinition[],\n    contentLoader: EpubContentLoader,\n  ) {\n    this.#packageData = packageData;\n    this.#cover = cover;\n    this.#sections = sections;\n    this.#contentLoader = contentLoader;\n  }\n\n  public static async open(archive: EpubArchive): Promise<EpubSourceDocument> {\n    assertArchiveIsSupported(archive);\n    const packageData = await readEpubPackage(archive);\n    const navigation = await readEpubNavigation(archive, packageData);\n    const rawSections = buildSections(archive, navigation);\n    const targetsByPath = groupTargetsByPath(rawSections);\n    const sectionAnalyses = await analyzeSectionTargets(archive, targetsByPath);\n    const sections = hydrateSectionAnalyses(rawSections, sectionAnalyses);\n    const cover = await readCoverAsset(archive, packageData);\n\n    return new EpubSourceDocument(\n      packageData,\n      cover,\n      sections,\n      new EpubContentLoader(archive, targetsByPath),\n    );\n  }\n\n  public readMeta() {\n    return Promise.resolve(this.#packageData.metadata);\n  }\n\n  public readCover() {\n    return Promise.resolve(this.#cover);\n  }\n\n  public readSections() {\n    return Promise.resolve(\n      this.#sections.map((section) => new EpubSourceSection(this, section)),\n    );\n  }\n\n  public async openSection(sectionId: string): Promise<SourceTextStream> {\n    return await this.#contentLoader.openSection(sectionId);\n  }\n}\n\nexport class EpubSourceAdapter implements SourceAdapter {\n  public get format() {\n    return \"epub\" as const;\n  }\n\n  public async openSession<T>(\n    path: string,\n    operation: (document: SourceDocument) => Promise<T>,\n  ): Promise<T> {\n    const archive = await EpubArchive.open(path);\n\n    try {\n      const document = await EpubSourceDocument.open(archive);\n\n      return await operation(document);\n    } finally {\n      await archive.close();\n    }\n  }\n}\n\nexport const EPUB_SOURCE_ADAPTER = new EpubSourceAdapter();\n\nfunction assertArchiveIsSupported(archive: EpubArchive): void {\n  if (!archive.hasEntry(\"META-INF/encryption.xml\")) {\n    return;\n  }\n\n  throw new Error(\n    \"Encrypted EPUB is not supported: found META-INF/encryption.xml.\",\n  );\n}\n\nasync function readCoverAsset(\n  archive: EpubArchive,\n  packageData: EpubPackageData,\n): Promise<SourceAsset | undefined> {\n  if (\n    packageData.coverPath === undefined ||\n    packageData.coverMediaType === undefined\n  ) {\n    return undefined;\n  }\n\n  return {\n    path: packageData.coverPath,\n    mediaType: packageData.coverMediaType,\n    data: await archive.readBuffer(packageData.coverPath),\n  };\n}\n\nfunction buildSections(\n  archive: EpubArchive,\n  items: readonly EpubNavigationItem[],\n): readonly SectionDefinition[] {\n  const idCounts = new Map<string, number>();\n\n  return items.map((item, index) =>\n    buildSection(archive, item, [index], idCounts),\n  );\n}\n\nfunction buildSection(\n  archive: EpubArchive,\n  item: EpubNavigationItem,\n  indexPath: readonly number[],\n  idCounts: Map<string, number>,\n): SectionDefinition {\n  const fragment = normalizeFragment(item.fragment);\n  const baseId =\n    item.path === undefined\n      ? `toc:${indexPath.join(\".\")}`\n      : archive.createSectionId(item.path, fragment);\n  const id = createUniqueId(baseId, idCounts);\n\n  return {\n    hasContent: item.path !== undefined,\n    id,\n    title: item.title,\n    path: item.path,\n    fragment,\n    wordsCount: 0,\n    children: item.children.map((child, index) =>\n      buildSection(archive, child, [...indexPath, index], idCounts),\n    ),\n  };\n}\n\nfunction hydrateSectionAnalyses(\n  sections: readonly SectionDefinition[],\n  sectionAnalyses: ReadonlyMap<string, EpubSectionAnalysis>,\n): readonly SectionDefinition[] {\n  return sections.map((section) => {\n    const analysis = sectionAnalyses.get(section.id);\n\n    return {\n      ...section,\n      hasContent: analysis?.hasContent ?? false,\n      wordsCount: analysis?.wordsCount ?? 0,\n      children: hydrateSectionAnalyses(section.children, sectionAnalyses),\n    };\n  });\n}\n\nfunction createUniqueId(baseId: string, idCounts: Map<string, number>): string {\n  const currentCount = idCounts.get(baseId) ?? 0;\n  idCounts.set(baseId, currentCount + 1);\n\n  return currentCount === 0 ? baseId : `${baseId}~${currentCount + 1}`;\n}\n\nfunction groupTargetsByPath(\n  sections: readonly SectionDefinition[],\n): ReadonlyMap<string, readonly EpubSectionTarget[]> {\n  const targetsByPath = new Map<string, EpubSectionTarget[]>();\n\n  for (const section of flattenSections(sections)) {\n    if (section.path === undefined) {\n      continue;\n    }\n\n    const targets = targetsByPath.get(section.path) ?? [];\n    targets.push({\n      id: section.id,\n      path: section.path,\n      fragment: section.fragment,\n    });\n    targetsByPath.set(section.path, targets);\n  }\n\n  return targetsByPath;\n}\n\nfunction flattenSections(\n  sections: readonly SectionDefinition[],\n): readonly SectionDefinition[] {\n  const flattened: SectionDefinition[] = [];\n\n  for (const section of sections) {\n    flattened.push(section);\n    flattened.push(...flattenSections(section.children));\n  }\n\n  return flattened;\n}\n"],"mappings":"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","names":[]}

package/dist/source/epub/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/source/epub/index.ts"],"sourcesContent":["export { EpubSourceAdapter, EPUB_SOURCE_ADAPTER } from \"./document.js\";\n"],"mappings":"AAAA,SAAS,mBAAmB,2BAA2B;","names":[]}

package/dist/source/epub/navigation.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/source/epub/navigation.ts"],"sourcesContent":["import { basename, extname, posix } from \"path\";\n\nimport { parseDocument } from \"htmlparser2\";\n\nimport { splitHref } from \"./archive.js\";\nimport type { EpubArchive } from \"./archive.js\";\nimport { type EpubPackageData } from \"./package.js\";\nimport {\n  findChild,\n  findChildren,\n  getAttribute,\n  getDescendantText,\n  parseXml,\n  type XmlElement,\n} from \"./xml.js\";\n\nconst NON_CONTENT_FILE_NAMES = new Set([\n  \"toc.xhtml\",\n  \"nav.xhtml\",\n  \"contents.xhtml\",\n  \"tableofcontents.xhtml\",\n  \"cover.xhtml\",\n  \"titlepage.xhtml\",\n]);\n\ninterface HtmlNode {\n  readonly type?: string;\n  readonly name?: string;\n  readonly data?: string;\n  readonly attribs?: Readonly<Record<string, string>>;\n  readonly children?: readonly HtmlNode[];\n}\n\nexport interface EpubNavigationItem {\n  readonly title: string | undefined;\n  readonly path: string | undefined;\n  readonly fragment: string | undefined;\n  readonly children: readonly EpubNavigationItem[];\n}\n\nexport async function readEpubNavigation(\n  archive: EpubArchive,\n  packageData: EpubPackageData,\n): Promise<readonly EpubNavigationItem[]> {\n  const navigation =\n    (await readNavDocument(archive, packageData)) ??\n    (await readNcxDocument(archive, packageData)) ??\n    [];\n\n  if (navigation.length === 0) {\n    return buildSpineNavigation(packageData, new Set());\n  }\n\n  const referencedPaths = collectReferencedPaths(navigation);\n  const extras = buildSpineNavigation(packageData, referencedPaths);\n\n  return extras.length === 0 ? navigation : [...navigation, ...extras];\n}\n\nasync function readNavDocument(\n  archive: EpubArchive,\n  packageData: EpubPackageData,\n): Promise<readonly EpubNavigationItem[] | undefined> {\n  if (packageData.navPath === undefined) {\n    return undefined;\n  }\n\n  const document = parseDocument(await archive.readText(packageData.navPath), {\n    decodeEntities: true,\n  }) as HtmlNode;\n  const nav = findFirstHtmlElement(document, (element) => {\n    if (getHtmlTagName(element) !== \"nav\") {\n      return false;\n    }\n\n    const type = (element.attribs?.[\"epub:type\"] ?? element.attribs?.type ?? \"\")\n      .split(/\\s+/u)\n      .map((value) => value.trim().toLowerCase());\n\n    return type.includes(\"toc\");\n  });\n\n  if (nav === undefined) {\n    return undefined;\n  }\n\n  const ol = findFirstHtmlElement(\n    nav,\n    (element) => getHtmlTagName(element) === \"ol\",\n  );\n  if (ol === undefined) {\n    return undefined;\n  }\n\n  const items = getHtmlElementChildren(ol)\n    .filter((child) => getHtmlTagName(child) === \"li\")\n    .map((li) => parseNavListItem(archive, packageData.navPath!, li))\n    .filter((item): item is EpubNavigationItem => item !== undefined);\n\n  return items.length === 0 ? undefined : items;\n}\n\nasync function readNcxDocument(\n  archive: EpubArchive,\n  packageData: EpubPackageData,\n): Promise<readonly EpubNavigationItem[] | undefined> {\n  if (packageData.ncxPath === undefined) {\n    return undefined;\n  }\n\n  const root = parseXml(await archive.readText(packageData.ncxPath));\n  const navMap = findChild(root, \"navMap\");\n  if (navMap === undefined) {\n    return undefined;\n  }\n\n  const items = findChildren(navMap, \"navPoint\")\n    .map((navPoint) =>\n      parseNcxNavPoint(archive, packageData.ncxPath!, navPoint),\n    )\n    .filter((item): item is EpubNavigationItem => item !== undefined);\n\n  return items.length === 0 ? undefined : items;\n}\n\nfunction parseNavListItem(\n  archive: EpubArchive,\n  navPath: string,\n  item: HtmlNode,\n): EpubNavigationItem | undefined {\n  const label = findHtmlLabelNode(item);\n  const title =\n    label === undefined ? undefined : normalizeText(collectHtmlText(label));\n  const href =\n    label !== undefined && getHtmlTagName(label) === \"a\"\n      ? label.attribs?.href\n      : undefined;\n  const resolved = resolveHtmlHref(archive, navPath, href);\n  const children = getHtmlElementChildren(item)\n    .filter((child) => getHtmlTagName(child) === \"ol\")\n    .flatMap((ol) => getHtmlElementChildren(ol))\n    .filter((child) => getHtmlTagName(child) === \"li\")\n    .map((li) => parseNavListItem(archive, navPath, li))\n    .filter((child): child is EpubNavigationItem => child !== undefined);\n\n  if (\n    title === undefined &&\n    resolved.path === undefined &&\n    children.length === 0\n  ) {\n    return undefined;\n  }\n\n  return {\n    title,\n    path: resolved.path,\n    fragment: resolved.fragment,\n    children,\n  };\n}\n\nfunction parseNcxNavPoint(\n  archive: EpubArchive,\n  ncxPath: string,\n  navPoint: XmlElement,\n): EpubNavigationItem | undefined {\n  const navLabel = findChild(navPoint, \"navLabel\");\n  const textElement =\n    navLabel === undefined ? undefined : findChild(navLabel, \"text\");\n  const title =\n    textElement === undefined\n      ? undefined\n      : normalizeText(getDescendantText(textElement));\n  const contentElement = findChild(navPoint, \"content\");\n  const resolved = resolveXmlHref(\n    archive,\n    ncxPath,\n    getAttribute(contentElement ?? navPoint, \"src\"),\n  );\n  const children = findChildren(navPoint, \"navPoint\")\n    .map((child) => parseNcxNavPoint(archive, ncxPath, child))\n    .filter((child): child is EpubNavigationItem => child !== undefined);\n\n  if (\n    title === undefined &&\n    resolved.path === undefined &&\n    children.length === 0\n  ) {\n    return undefined;\n  }\n\n  return {\n    title,\n    path: resolved.path,\n    fragment: resolved.fragment,\n    children,\n  };\n}\n\nfunction buildSpineNavigation(\n  packageData: EpubPackageData,\n  referencedPaths: ReadonlySet<string>,\n): readonly EpubNavigationItem[] {\n  return packageData.spine\n    .filter(\n      (item) => !isNonContentSpineItem(packageData, item.path, referencedPaths),\n    )\n    .filter((item) => !referencedPaths.has(item.path))\n    .map((item) => ({\n      title: getFallbackTitle(item.path),\n      path: item.path,\n      fragment: undefined,\n      children: [],\n    }));\n}\n\nfunction isNonContentSpineItem(\n  packageData: EpubPackageData,\n  path: string,\n  referencedPaths: ReadonlySet<string>,\n): boolean {\n  if (packageData.guideNonContentPaths.has(path)) {\n    return true;\n  }\n\n  const lowerName = posix.basename(path).toLowerCase();\n  if (packageData.navPath === path) {\n    return true;\n  }\n\n  return NON_CONTENT_FILE_NAMES.has(lowerName) && !referencedPaths.has(path);\n}\n\nfunction collectReferencedPaths(\n  items: readonly EpubNavigationItem[],\n): ReadonlySet<string> {\n  const paths = new Set<string>();\n\n  for (const item of items) {\n    if (item.path !== undefined) {\n      paths.add(item.path);\n    }\n\n    for (const childPath of collectReferencedPaths(item.children)) {\n      paths.add(childPath);\n    }\n  }\n\n  return paths;\n}\n\nfunction resolveHtmlHref(\n  archive: EpubArchive,\n  basePath: string,\n  href: string | undefined,\n): {\n  readonly path: string | undefined;\n  readonly fragment: string | undefined;\n} {\n  if (href === undefined || href.trim() === \"\") {\n    return { path: undefined, fragment: undefined };\n  }\n\n  const { path, fragment } = splitHref(href);\n\n  return {\n    path: path === \"\" ? undefined : archive.resolveRelativePath(basePath, path),\n    fragment,\n  };\n}\n\nfunction resolveXmlHref(\n  archive: EpubArchive,\n  basePath: string,\n  href: string | undefined,\n): {\n  readonly path: string | undefined;\n  readonly fragment: string | undefined;\n} {\n  if (href === undefined || href.trim() === \"\") {\n    return { path: undefined, fragment: undefined };\n  }\n\n  const { path, fragment } = splitHref(href);\n\n  return {\n    path: path === \"\" ? undefined : archive.resolveRelativePath(basePath, path),\n    fragment,\n  };\n}\n\nfunction findFirstHtmlElement(\n  node: HtmlNode,\n  predicate: (element: HtmlNode) => boolean,\n): HtmlNode | undefined {\n  if (isHtmlElement(node) && predicate(node)) {\n    return node;\n  }\n\n  for (const child of node.children ?? []) {\n    const found = findFirstHtmlElement(child, predicate);\n    if (found !== undefined) {\n      return found;\n    }\n  }\n\n  return undefined;\n}\n\nfunction findHtmlLabelNode(node: HtmlNode): HtmlNode | undefined {\n  for (const child of getHtmlElementChildren(node)) {\n    const tagName = getHtmlTagName(child);\n    if (tagName === \"a\" || tagName === \"span\") {\n      return child;\n    }\n  }\n\n  for (const child of getHtmlElementChildren(node)) {\n    if (getHtmlTagName(child) === \"ol\") {\n      continue;\n    }\n\n    const nested = findHtmlLabelNode(child);\n    if (nested !== undefined) {\n      return nested;\n    }\n  }\n\n  return undefined;\n}\n\nfunction collectHtmlText(node: HtmlNode): string {\n  if (node.type === \"text\") {\n    return node.data ?? \"\";\n  }\n\n  return (node.children ?? []).map(collectHtmlText).join(\"\");\n}\n\nfunction getHtmlElementChildren(node: HtmlNode): readonly HtmlNode[] {\n  return (node.children ?? []).filter(isHtmlElement);\n}\n\nfunction isHtmlElement(node: HtmlNode): boolean {\n  return node.type === \"tag\" || node.type === \"script\" || node.type === \"style\";\n}\n\nfunction getHtmlTagName(node: HtmlNode): string | undefined {\n  return node.name?.toLowerCase();\n}\n\nfunction getFallbackTitle(path: string): string | undefined {\n  const stem = basename(path, extname(path)).trim();\n\n  return stem === \"\" ? undefined : stem;\n}\n\nfunction normalizeText(text: string): string | undefined {\n  const normalized = text.replace(/\\s+/gu, \" \").trim();\n\n  return normalized === \"\" ? undefined : normalized;\n}\n"],"mappings":"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","names":[]}

package/dist/source/epub/package.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/source/epub/package.ts"],"sourcesContent":["import { posix } from \"path\";\n\nimport { BOOK_META_VERSION, type BookMeta } from \"../meta.js\";\nimport { splitHref } from \"./archive.js\";\nimport type { EpubArchive } from \"./archive.js\";\nimport {\n  findChild,\n  findChildren,\n  getAttribute,\n  getDescendantText,\n  getLocalName,\n  parseXml,\n  type XmlElement,\n} from \"./xml.js\";\n\nconst COVER_ITEM_IDS = [\"cover-image\", \"coverimg\", \"cover-img\", \"cover\"];\nconst GUIDE_NON_CONTENT_TYPES = new Set([\n  \"cover\",\n  \"titlepage\",\n  \"other.titlepage\",\n]);\n\nexport interface EpubManifestItem {\n  readonly id: string;\n  readonly path: string;\n  readonly mediaType: string;\n  readonly properties: ReadonlySet<string>;\n}\n\nexport interface EpubSpineItem {\n  readonly idref: string;\n  readonly path: string;\n  readonly mediaType: string;\n}\n\nexport interface EpubPackageData {\n  readonly version: 2 | 3;\n  readonly opfPath: string;\n  readonly metadata: BookMeta;\n  readonly manifest: ReadonlyMap<string, EpubManifestItem>;\n  readonly manifestByPath: ReadonlyMap<string, EpubManifestItem>;\n  readonly spine: readonly EpubSpineItem[];\n  readonly navPath: string | undefined;\n  readonly ncxPath: string | undefined;\n  readonly coverPath: string | undefined;\n  readonly coverMediaType: string | undefined;\n  readonly guideNonContentPaths: ReadonlySet<string>;\n}\n\nexport async function readEpubPackage(\n  archive: EpubArchive,\n): Promise<EpubPackageData> {\n  const opfPath = await findOpfPath(archive);\n  const opf = parseXml(await archive.readText(opfPath));\n  const version = parsePackageVersion(getAttribute(opf, \"version\"));\n  const metadataElement = findChild(opf, \"metadata\");\n  const manifestElement = findChild(opf, \"manifest\");\n  const spineElement = findChild(opf, \"spine\");\n  const guideElement = findChild(opf, \"guide\");\n\n  const manifest = buildManifest(archive, opfPath, manifestElement);\n  const manifestByPath = new Map(\n    [...manifest.values()].map((item) => [item.path, item]),\n  );\n  const spine = buildSpine(spineElement, manifest);\n  const guideNonContentPaths = buildGuideNonContentPaths(\n    archive,\n    opfPath,\n    guideElement,\n  );\n  const metadata = buildMetadata(metadataElement);\n  const navPath = findNavPath(manifest);\n  const ncxPath = findNcxPath(manifest, spineElement);\n  const coverItem = findCoverItem(manifest, metadataElement);\n\n  return {\n    version,\n    opfPath,\n    metadata: {\n      ...metadata,\n      version: BOOK_META_VERSION,\n      sourceFormat: \"epub\",\n    },\n    manifest,\n    manifestByPath,\n    spine,\n    navPath,\n    ncxPath,\n    coverPath: coverItem?.path,\n    coverMediaType: coverItem?.mediaType,\n    guideNonContentPaths,\n  };\n}\n\nasync function findOpfPath(archive: EpubArchive): Promise<string> {\n  const container = parseXml(await archive.readText(\"META-INF/container.xml\"));\n  const rootfiles = findChild(container, \"rootfiles\");\n  const rootfile = rootfiles?.children.find(\n    (child) => getLocalName(child.name) === \"rootfile\",\n  );\n  const fullPath =\n    rootfile === undefined ? undefined : getAttribute(rootfile, \"full-path\");\n\n  if (fullPath === undefined || fullPath.trim() === \"\") {\n    throw new Error(\"EPUB container.xml does not contain an OPF rootfile\");\n  }\n\n  return fullPath;\n}\n\nfunction parsePackageVersion(version: string | undefined): 2 | 3 {\n  return version?.trim().startsWith(\"3\") === true ? 3 : 2;\n}\n\nfunction buildMetadata(metadataElement: XmlElement | undefined): BookMeta {\n  if (metadataElement === undefined) {\n    return createEmptyMetadata();\n  }\n\n  const titles = readMetadataValues(metadataElement, \"title\");\n  const creators = readMetadataValues(metadataElement, \"creator\");\n  const languages = readMetadataValues(metadataElement, \"language\");\n  const identifiers = readMetadataValues(metadataElement, \"identifier\");\n  const publishers = readMetadataValues(metadataElement, \"publisher\");\n  const dates = readMetadataValues(metadataElement, \"date\");\n  const descriptions = readMetadataValues(metadataElement, \"description\");\n\n  return {\n    ...createEmptyMetadata(),\n    title: titles[0] ?? null,\n    authors: [...creators],\n    language: languages[0] ?? null,\n    identifier: identifiers[0] ?? null,\n    publisher: publishers[0] ?? null,\n    publishedAt: dates[0] ?? null,\n    description: descriptions[0] ?? null,\n  };\n}\n\nfunction createEmptyMetadata(): BookMeta {\n  return {\n    version: BOOK_META_VERSION,\n    sourceFormat: \"epub\",\n    title: null,\n    authors: [],\n    language: null,\n    identifier: null,\n    publisher: null,\n    publishedAt: null,\n    description: null,\n  };\n}\n\nfunction readMetadataValues(\n  metadataElement: XmlElement,\n  localName: string,\n): readonly string[] {\n  return metadataElement.children\n    .filter((child) => getLocalName(child.name) === localName)\n    .map((child) => normalizeText(getDescendantText(child)))\n    .filter((value): value is string => value !== undefined);\n}\n\nfunction buildManifest(\n  archive: EpubArchive,\n  opfPath: string,\n  manifestElement: XmlElement | undefined,\n): ReadonlyMap<string, EpubManifestItem> {\n  const manifest = new Map<string, EpubManifestItem>();\n\n  if (manifestElement === undefined) {\n    return manifest;\n  }\n\n  for (const item of findChildren(manifestElement, \"item\")) {\n    const id = getAttribute(item, \"id\");\n    const href = getAttribute(item, \"href\");\n    const mediaType = getAttribute(item, \"media-type\") ?? \"\";\n\n    if (id === undefined || href === undefined) {\n      continue;\n    }\n\n    manifest.set(id, {\n      id,\n      path: archive.resolveRelativePath(opfPath, href),\n      mediaType,\n      properties: new Set(\n        (getAttribute(item, \"properties\") ?? \"\")\n          .split(/\\s+/u)\n          .map((value) => value.trim().toLowerCase())\n          .filter((value) => value !== \"\"),\n      ),\n    });\n  }\n\n  return manifest;\n}\n\nfunction buildSpine(\n  spineElement: XmlElement | undefined,\n  manifest: ReadonlyMap<string, EpubManifestItem>,\n): readonly EpubSpineItem[] {\n  if (spineElement === undefined) {\n    return [];\n  }\n\n  return findChildren(spineElement, \"itemref\")\n    .map((itemref) => getAttribute(itemref, \"idref\"))\n    .filter((idref): idref is string => idref !== undefined)\n    .map((idref) => {\n      const item = manifest.get(idref);\n\n      if (\n        item === undefined ||\n        (item.mediaType !== \"application/xhtml+xml\" &&\n          item.mediaType !== \"text/html\")\n      ) {\n        return undefined;\n      }\n\n      return {\n        idref,\n        path: item.path,\n        mediaType: item.mediaType,\n      } satisfies EpubSpineItem;\n    })\n    .filter((item): item is EpubSpineItem => item !== undefined);\n}\n\nfunction buildGuideNonContentPaths(\n  archive: EpubArchive,\n  opfPath: string,\n  guideElement: XmlElement | undefined,\n): ReadonlySet<string> {\n  const paths = new Set<string>();\n\n  if (guideElement === undefined) {\n    return paths;\n  }\n\n  for (const reference of findChildren(guideElement, \"reference\")) {\n    const type = (getAttribute(reference, \"type\") ?? \"\").trim().toLowerCase();\n    if (!GUIDE_NON_CONTENT_TYPES.has(type)) {\n      continue;\n    }\n\n    const href = getAttribute(reference, \"href\");\n    if (href === undefined || href.trim() === \"\") {\n      continue;\n    }\n\n    paths.add(archive.resolveRelativePath(opfPath, splitHref(href).path));\n  }\n\n  return paths;\n}\n\nfunction findNavPath(\n  manifest: ReadonlyMap<string, EpubManifestItem>,\n): string | undefined {\n  for (const item of manifest.values()) {\n    if (item.properties.has(\"nav\")) {\n      return item.path;\n    }\n  }\n\n  return undefined;\n}\n\nfunction findNcxPath(\n  manifest: ReadonlyMap<string, EpubManifestItem>,\n  spineElement: XmlElement | undefined,\n): string | undefined {\n  const tocId =\n    spineElement === undefined ? undefined : getAttribute(spineElement, \"toc\");\n\n  if (tocId !== undefined) {\n    return manifest.get(tocId)?.path;\n  }\n\n  for (const item of manifest.values()) {\n    if (item.mediaType === \"application/x-dtbncx+xml\") {\n      return item.path;\n    }\n  }\n\n  return undefined;\n}\n\nfunction findCoverItem(\n  manifest: ReadonlyMap<string, EpubManifestItem>,\n  metadataElement: XmlElement | undefined,\n): EpubManifestItem | undefined {\n  for (const item of manifest.values()) {\n    if (\n      item.properties.has(\"cover-image\") &&\n      item.mediaType.startsWith(\"image/\")\n    ) {\n      return item;\n    }\n  }\n\n  const coverId = readCoverIdFromMetadata(metadataElement);\n  if (coverId !== undefined) {\n    const coverItem = manifest.get(coverId);\n    if (coverItem?.mediaType.startsWith(\"image/\") === true) {\n      return coverItem;\n    }\n  }\n\n  for (const coverItemId of COVER_ITEM_IDS) {\n    const coverItem = manifest.get(coverItemId);\n    if (coverItem?.mediaType.startsWith(\"image/\") === true) {\n      return coverItem;\n    }\n  }\n\n  for (const item of manifest.values()) {\n    if (\n      item.mediaType.startsWith(\"image/\") &&\n      posix.basename(item.path).toLowerCase().includes(\"cover\")\n    ) {\n      return item;\n    }\n  }\n\n  return undefined;\n}\n\nfunction readCoverIdFromMetadata(\n  metadataElement: XmlElement | undefined,\n): string | undefined {\n  if (metadataElement === undefined) {\n    return undefined;\n  }\n\n  for (const meta of findChildren(metadataElement, \"meta\")) {\n    const name = (getAttribute(meta, \"name\") ?? \"\").trim().toLowerCase();\n    if (name !== \"cover\") {\n      continue;\n    }\n\n    const content = getAttribute(meta, \"content\");\n    if (content !== undefined && content.trim() !== \"\") {\n      return content.trim();\n    }\n  }\n\n  return undefined;\n}\n\nfunction normalizeText(text: string): string | undefined {\n  const normalized = text.replace(/\\s+/gu, \" \").trim();\n\n  return normalized === \"\" ? undefined : normalized;\n}\n"],"mappings":"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","names":[]}

package/dist/source/epub/xml.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/source/epub/xml.ts"],"sourcesContent":["import { SaxesParser, type SaxesTagPlain } from \"saxes\";\n\nexport interface XmlElement {\n  readonly name: string;\n  readonly attributes: Readonly<Record<string, string>>;\n  readonly children: readonly XmlElement[];\n  readonly text: string;\n}\n\ninterface MutableXmlElement {\n  readonly name: string;\n  readonly attributes: Record<string, string>;\n  readonly children: MutableXmlElement[];\n  text: string;\n}\n\nexport function parseXml(content: string): XmlElement {\n  const parser = new SaxesParser({ xmlns: false });\n  const stack: MutableXmlElement[] = [];\n  let root: MutableXmlElement | undefined;\n\n  parser.on(\"opentag\", (tag: SaxesTagPlain) => {\n    const element: MutableXmlElement = {\n      name: tag.name,\n      attributes: Object.fromEntries(\n        Object.entries(tag.attributes).map(([name, value]) => [\n          name,\n          String(value),\n        ]),\n      ),\n      children: [],\n      text: \"\",\n    };\n\n    const parent = stack[stack.length - 1];\n    if (parent === undefined) {\n      root = element;\n    } else {\n      parent.children.push(element);\n    }\n\n    stack.push(element);\n  });\n\n  parser.on(\"text\", (text: string) => {\n    const current = stack[stack.length - 1];\n    if (current !== undefined) {\n      current.text += text;\n    }\n  });\n\n  parser.on(\"cdata\", (text: string) => {\n    const current = stack[stack.length - 1];\n    if (current !== undefined) {\n      current.text += text;\n    }\n  });\n\n  parser.on(\"closetag\", () => {\n    stack.pop();\n  });\n\n  parser.write(content).close();\n\n  if (root === undefined) {\n    throw new Error(\"XML document is empty\");\n  }\n\n  return freezeXmlElement(root);\n}\n\nexport function findChild(\n  element: XmlElement,\n  localName: string,\n): XmlElement | undefined {\n  return element.children.find(\n    (child) => getLocalName(child.name) === localName,\n  );\n}\n\nexport function findChildren(\n  element: XmlElement,\n  localName: string,\n): readonly XmlElement[] {\n  return element.children.filter(\n    (child) => getLocalName(child.name) === localName,\n  );\n}\n\nexport function findDescendant(\n  element: XmlElement,\n  localName: string,\n): XmlElement | undefined {\n  for (const child of element.children) {\n    if (getLocalName(child.name) === localName) {\n      return child;\n    }\n\n    const descendant = findDescendant(child, localName);\n    if (descendant !== undefined) {\n      return descendant;\n    }\n  }\n\n  return undefined;\n}\n\nexport function findDescendants(\n  element: XmlElement,\n  localName: string,\n): readonly XmlElement[] {\n  const descendants: XmlElement[] = [];\n\n  for (const child of element.children) {\n    if (getLocalName(child.name) === localName) {\n      descendants.push(child);\n    }\n\n    descendants.push(...findDescendants(child, localName));\n  }\n\n  return descendants;\n}\n\nexport function getAttribute(\n  element: XmlElement,\n  name: string,\n): string | undefined {\n  return element.attributes[name];\n}\n\nexport function getDescendantText(element: XmlElement): string {\n  let text = element.text;\n\n  for (const child of element.children) {\n    text += getDescendantText(child);\n  }\n\n  return text;\n}\n\nexport function getLocalName(name: string): string {\n  const index = name.indexOf(\":\");\n\n  return index === -1 ? name : name.slice(index + 1);\n}\n\nfunction freezeXmlElement(element: MutableXmlElement): XmlElement {\n  return {\n    name: element.name,\n    attributes: Object.freeze({ ...element.attributes }),\n    children: Object.freeze(element.children.map(freezeXmlElement)),\n    text: element.text,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/source/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/source/index.ts"],"sourcesContent":["export {\n  BOOK_META_VERSION,\n  SOURCE_FORMATS,\n  bookMetaSchema,\n  sourceFormatSchema,\n  type BookMeta,\n  type SourceFormat,\n} from \"./meta.js\";\nexport type { SourceAdapter, SourceDocument } from \"./adapter.js\";\nexport { EpubSourceAdapter, EPUB_SOURCE_ADAPTER } from \"./epub/index.js\";\nexport {\n  MARKDOWN_SOURCE_ADAPTER,\n  PlainTextSourceAdapter,\n  TXT_SOURCE_ADAPTER,\n} from \"./plain-text.js\";\nexport {\n  TOC_FILE_VERSION,\n  tocFileSchema,\n  tocItemSchema,\n  type TocFile,\n  type TocItem,\n} from \"./toc.js\";\nexport type { SourceAsset, SourceSection, SourceTextStream } from \"./types.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,mBAAmB,2BAA2B;AACvD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;","names":[]}