@prose-reader/archive-reader 1.320.0 → 1.322.0

package/dist/index/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/apple/parse.ts","../../src/archives/createArchiveFromArrayBufferList.ts","../../src/archives/createArchiveFromText.ts","../../src/archives/createArchiveFromUrls.ts","../../src/archives/readRecordAsText.ts","../../src/archives/types.ts","../../src/comicInfo/parse.ts","../../src/comicInfo/getArchiveHasComicInfo.ts","../../src/comicInfo/manga.ts","../../src/kobo/parse.ts","../../src/opf/getArchiveOpfInfo.ts","../../src/opf/getSpineItemFilesFromArchive.ts","../../src/opf/isArchiveEpub.ts","../../src/utils/tokenizeXmlSpaceSeparatedList.ts","../../src/opf/spineItemrefProperties.ts","../../src/opf/parse.ts","../../src/opf/readArchiveOpf.ts","../../src/apple/resolve.ts","../../src/utils/normalizeGtin.ts","../../src/utils/normalizeIsbn.ts","../../src/comicInfo/resolve.ts","../../src/kobo/resolve.ts","../../src/utils/parseW3cDtfDate.ts","../../src/opf/resolve.ts","../../src/resolve.ts","../../src/toc/folders.ts","../../src/utils/getXmlElementInnerText.ts","../../src/toc/nav.ts","../../src/toc/ncx.ts","../../src/toc/resolveArchiveToc.ts"],"sourcesContent":["import type { XmlElement } from \"xmldoc\"\nimport { XmlDocument } from \"xmldoc\"\n\nexport const APPLE_IBOOKS_DISPLAY_OPTIONS_FILENAME =\n  \"com.apple.ibooks.display-options.xml\"\n\nexport type AppleDisplayOption = {\n  readonly name?: string\n  readonly value: string\n}\n\nexport type AppleMetadata = {\n  readonly kind: \"apple\"\n  readonly displayOptions?: {\n    readonly platform?: {\n      readonly options: ReadonlyArray<AppleDisplayOption>\n    }\n  }\n}\n\nconst platformOptionsFromElement = (\n  platform: XmlElement,\n): ReadonlyArray<AppleDisplayOption> =>\n  platform.childrenNamed(\"option\").map((option) => ({\n    name: option.attr?.name,\n    value: option.val,\n  }))\n\nexport const parseAppleDisplayOptionsXml = (xml: string): AppleMetadata => {\n  const doc = new XmlDocument(xml)\n  const root = doc.name?.toLowerCase()\n\n  if (root !== \"display_options\") {\n    return { kind: \"apple\" }\n  }\n\n  const platformEl = doc.childNamed(\"platform\")\n\n  return {\n    kind: \"apple\",\n    displayOptions: {\n      ...(platformEl !== undefined\n        ? { platform: { options: platformOptionsFromElement(platformEl) } }\n        : {}),\n    },\n  }\n}\n","import { detectMimeTypeFromName } from \"@prose-reader/shared\"\nimport { createArchiveFromEntries } from \"./createArchiveFromEntries\"\nimport { arrayBufferFileAccessors } from \"./fileAccessors\"\nimport type { Archive } from \"./types\"\n\nexport const createArchiveFromArrayBufferList = async (\n  list: {\n    isDir: boolean\n    name: string\n    size: number\n    data: () => Promise<ArrayBuffer>\n  }[],\n  options: {\n    orderByAlpha?: boolean\n    name?: string\n    encodingFormat?: string\n  } = {},\n): Promise<Archive> =>\n  createArchiveFromEntries(\n    list,\n    (file) =>\n      file.isDir\n        ? { dir: true, uri: file.name }\n        : {\n            dir: false,\n            uri: file.name,\n            size: file.size,\n            ...arrayBufferFileAccessors(\n              file.data,\n              detectMimeTypeFromName(file.name) ?? ``,\n            ),\n          },\n    { ...options, close: () => Promise.resolve() },\n  )\n","import { getUriBasename } from \"@prose-reader/shared\"\nimport { createArchive } from \"./createArchive\"\nimport { blobFileAccessors } from \"./fileAccessors\"\n\n/**\n * Useful to create archive from txt content\n */\nexport const createArchiveFromText = async (\n  content: string | Blob,\n  {\n    mimeType,\n    direction,\n  }: {\n    direction?: `ltr` | `rtl`\n    mimeType?: string\n  } = { mimeType: \"text/plain\" },\n) => {\n  const txtOpfContent = `\n      <?xml version=\"1.0\" encoding=\"UTF-8\"?>\n      <package xmlns=\"http://www.idpf.org/2007/opf\" version=\"3.0\" xml:lang=\"ja\" prefix=\"rendition: http://www.idpf.org/vocab/rendition/#\"\n        unique-identifier=\"ootuya-id\">\n        <metadata xmlns:opf=\"http://www.idpf.org/2007/opf\" xmlns:dc=\"http://purl.org/dc/elements/1.1/\"\n              xmlns:dcterms=\"http://purl.org/dc/terms/\">\n              <meta property=\"rendition:layout\">reflowable</meta>\n        </metadata>\n        <manifest>\n            <item id=\"p01\" href=\"p01.txt\" media-type=\"text/plain\"/>\n        </manifest>\n        <spine page-progression-direction=\"${direction ?? `ltr`}\">\n          <itemref idref=\"p01\" />\n        </spine>\n      </package>\n    `\n\n  const archive = createArchive({\n    filename: `content.txt`,\n    encodingFormat: mimeType,\n    records: [\n      {\n        dir: false,\n        basename: getUriBasename(`generated.opf`),\n        uri: `generated.opf`,\n        size: 0,\n        ...blobFileAccessors(async () => new Blob([txtOpfContent])),\n      },\n      {\n        dir: false,\n        basename: getUriBasename(`p01.txt`),\n        uri: `p01.txt`,\n        size:\n          typeof content === \"string\" ? new Blob([content]).size : content.size,\n        encodingFormat: mimeType,\n        ...blobFileAccessors(async () =>\n          typeof content === \"string\" ? new Blob([content]) : content,\n        ),\n      },\n    ],\n    close: () => Promise.resolve(),\n  })\n\n  return archive\n}\n","import {\n  createXmlSafeIdFactory,\n  detectMimeTypeFromName,\n  escapeXmlAttributeValue,\n  getUriBasename,\n} from \"@prose-reader/shared\"\nimport { createArchive } from \"./createArchive\"\nimport { blobFileAccessors } from \"./fileAccessors\"\nimport type { Archive } from \"./types\"\n\n/**\n * @important\n * Make sure the urls are on the same origin or the cors header is set otherwise\n * the resource cannot be consumed as it is on the web.\n */\nexport const createArchiveFromUrls = async (\n  urls: string[],\n  options?: { useRenditionFlow: boolean },\n): Promise<Archive> => {\n  const createSafeId = createXmlSafeIdFactory()\n  const resources = urls.map((url) => ({\n    id: createSafeId(url),\n    url,\n  }))\n  const opfFileData = `\n    <?xml version=\"1.0\" encoding=\"UTF-8\"?><package xmlns=\"http://www.idpf.org/2007/opf\" version=\"2.0\" unique-identifier=\"bookid\">\n      <metadata>\n        <meta property=\"rendition:layout\">${options?.useRenditionFlow ? `reflowable` : `pre-paginated`}</meta>\n        ${options?.useRenditionFlow ? `<meta property=\"rendition:flow\">scrolled-continuous</meta>` : ``}\n      </metadata>\n      <manifest>\n        ${resources\n          .map(({ id, url }) => {\n            const mediaType = detectMimeTypeFromName(url)\n\n            return `<item id=\"${id}\" href=\"${escapeXmlAttributeValue(url)}\" media-type=\"${escapeXmlAttributeValue(mediaType ?? ``)}\"/>`\n          })\n          .join(`\\n`)}\n      </manifest>\n      <spine>\n        ${resources.map(({ id }) => `<itemref idref=\"${id}\" />`).join(`\\n`)}\n      </spine>\n    </package>\n  `\n\n  const filesFromUrl: Archive[`records`] = urls.map((url) => ({\n    dir: false,\n    basename: getUriBasename(url),\n    encodingFormat: detectMimeTypeFromName(url),\n    uri: url,\n    size: 0,\n    ...blobFileAccessors(async () => {\n      const response = await fetch(url)\n\n      return response.blob()\n    }),\n  }))\n\n  const opfFile: Archive[`records`][number] = {\n    dir: false,\n    basename: `content.opf`,\n    uri: `content.opf`,\n    size: 0,\n    ...blobFileAccessors(async () => new Blob([opfFileData])),\n  }\n\n  return createArchive({\n    records: [opfFile, ...filesFromUrl],\n    close: () => Promise.resolve(),\n  })\n}\n","import type { FileRecord } from \"./types\"\n\n/**\n * Decodes a record's bytes as UTF-8. The caller asserts the record is text;\n * there is intentionally no `string()` accessor on {@link FileRecord} so that\n * decoding a binary record is always a deliberate act at the call site.\n */\nexport const readRecordAsText = async (record: FileRecord): Promise<string> =>\n  new TextDecoder().decode(await record.arrayBuffer())\n","export type FileRecord = {\n  dir: false\n  basename: string\n  uri: string\n  /** Uncompressed byte length of the record, or `0` when unknown. */\n  size: number\n  // @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types\n  encodingFormat?: string\n  blob: () => Promise<Blob>\n  arrayBuffer: () => Promise<ArrayBuffer>\n}\n\nexport type DirectoryRecord = {\n  dir: true\n  basename: string\n  uri: string\n}\n\nexport type ArchiveRecord = FileRecord | DirectoryRecord\n\nexport type Archive = {\n  /**\n   * Container-level filename when known (e.g. the originating `.cbz`/`.epub`\n   * file name). Absent for synthetic archives that have no real source file\n   * (URL lists, raw array buffers). Consumers use it as a detection signal, so\n   * it must never be fabricated.\n   */\n  filename?: string\n  /**\n   * Archive-level media type when known (e.g. `application/vnd.comicbook+zip`\n   * for a CBZ). This is the mime type of the container itself, not of any\n   * individual record; record-level mime types live on {@link FileRecord}.\n   */\n  encodingFormat?: string\n  records: ArchiveRecord[]\n  /**\n   * `uri` → record index built once at construction (see `createArchive`).\n   * Resource resolution is a per-fetched-file hot path, so prefer this (or\n   * {@link getArchiveFileRecordByUri}) over scanning {@link Archive.records}.\n   */\n  recordsByUri: ReadonlyMap<string, ArchiveRecord>\n  close: () => Promise<void>\n}\n\nexport const isFileRecord = (record: ArchiveRecord): record is FileRecord =>\n  !record.dir\n\nexport const isDirectoryRecord = (\n  record: ArchiveRecord,\n): record is DirectoryRecord => record.dir\n\nexport const getArchiveFileRecordByUri = (\n  archive: Pick<Archive, \"recordsByUri\">,\n  uri: string,\n): FileRecord | undefined => {\n  const record = archive.recordsByUri.get(uri)\n\n  return record && isFileRecord(record) ? record : undefined\n}\n","import type { XmlElement } from \"xmldoc\"\nimport { XmlDocument } from \"xmldoc\"\nimport type { ComicInfoManga } from \"./manga\"\n\n/** Canonical top-level filename; real archives may use any casing. */\nexport const COMIC_INFO_FILENAME = \"ComicInfo.xml\"\n\n/**\n * Parsed `ComicInfo.xml` root: one optional string property per child element,\n * using the same names as in the file (e.g. `Title`, `GTIN`, `LanguageISO`).\n * Nested blocks such as `Pages` are skipped. Other simple child elements are\n * still copied onto this object under their tag name.\n *\n * @see https://anansi-project.github.io/docs/comicinfo/intro\n * @see https://github.com/anansi-project/comicinfo/blob/main/drafts/v2.1/ComicInfo.xsd for schema\n */\nexport interface ComicInfo {\n  readonly kind: \"comicInfo\"\n  AgeRating?: string\n  AlternateCount?: string\n  AlternateNumber?: string\n  AlternateSeries?: string\n  BlackAndWhite?: string\n  Characters?: string\n  Colorist?: string\n  CommunityRating?: string\n  Count?: string\n  CoverArtist?: string\n  Day?: string\n  Editor?: string\n  Format?: string\n  Genre?: string\n  GTIN?: string\n  Imprint?: string\n  Inker?: string\n  LanguageISO?: string\n  Letterer?: string\n  Locations?: string\n  MainCharacterOrTeam?: string\n  /** Schema literals per {@link ComicInfoManga}; files may still use other strings. */\n  Manga?: ComicInfoManga | (string & {})\n  Month?: string\n  Notes?: string\n  Number?: string\n  PageCount?: string\n  Penciller?: string\n  Publisher?: string\n  Review?: string\n  ScanInformation?: string\n  Series?: string\n  SeriesGroup?: string\n  StoryArc?: string\n  StoryArcNumber?: string\n  Summary?: string\n  Tags?: string\n  Teams?: string\n  Title?: string\n  Translator?: string\n  Volume?: string\n  Web?: string\n  Writer?: string\n  Year?: string\n  [tag: string]: string | undefined\n}\n\nconst SKIP_ELEMENT_CHILDREN = new Set([\"Pages\", \"ComicInfo\"])\n\nconst hasNestedElement = (el: XmlElement) =>\n  el.children.some((c) => c.type === \"element\")\n\nconst trimmedText = (el: XmlElement): string | undefined => {\n  const t = el.val.trim()\n  return t.length > 0 ? t : undefined\n}\n\n/**\n * Parse a raw `ComicInfo.xml` body. Each direct child element with plain text\n * becomes a property named after that tag. Malformed XML throws; the parser\n * error is attached as `cause`.\n */\nexport const parseComicInfo = (xml: string): ComicInfo => {\n  let doc: XmlDocument\n  try {\n    doc = new XmlDocument(xml)\n  } catch (cause) {\n    const message = cause instanceof Error ? cause.message : String(cause)\n    throw new Error(`${COMIC_INFO_FILENAME} is malformed: ${message}`, {\n      cause,\n    })\n  }\n\n  const fields: Record<string, string> = {}\n\n  doc.eachChild((child) => {\n    if (child.type !== \"element\") return\n    if (SKIP_ELEMENT_CHILDREN.has(child.name)) return\n    if (hasNestedElement(child)) return\n\n    const text = trimmedText(child)\n    if (text === undefined) return\n    if (fields[child.name] !== undefined) return\n\n    fields[child.name] = text\n  })\n\n  // `as ComicInfo`: TS cannot infer that spreading `Record<string, string>` into `{ kind }` satisfies the named optional fields plus `[tag: string]: string | undefined` on `ComicInfo`.\n  return { kind: \"comicInfo\", ...fields } as ComicInfo\n}\n","import { type Archive, type FileRecord, isFileRecord } from \"../archives/types\"\nimport { COMIC_INFO_FILENAME } from \"./parse\"\n\nconst comicInfoFilenameLower = COMIC_INFO_FILENAME.toLowerCase()\n\nexport const getArchiveHasComicInfo = (archive: Archive) =>\n  archive.records.find(\n    (record): record is FileRecord =>\n      isFileRecord(record) &&\n      record.basename.toLowerCase() === comicInfoFilenameLower,\n  )\n","/**\n * Allowed `Manga` element values (ComicInfo 2.0 `Manga` simpleType).\n *\n * @see https://anansi-project.github.io/docs/comicinfo/documentation#manga\n */\nexport const COMIC_INFO_MANGA_VALUES = [\n  \"Unknown\",\n  \"No\",\n  \"Yes\",\n  \"YesAndRightToLeft\",\n] as const\n\nexport type ComicInfoManga = (typeof COMIC_INFO_MANGA_VALUES)[number]\n\nexport const isComicInfoManga = (value: string): value is ComicInfoManga => {\n  for (const v of COMIC_INFO_MANGA_VALUES) {\n    if (v === value) return true\n  }\n  return false\n}\n","import { XmlDocument } from \"xmldoc\"\n\nexport const KOBO_DISPLAY_OPTIONS_FILENAME = \"com.kobobooks.display-options.xml\"\n\n/**\n * Normalized fields from Kobo-specific XML sidecars. Grows as new Kobo\n * document kinds are supported; absent keys mean not present or unknown.\n */\nexport type KoboMetadata = {\n  readonly kind: \"kobo\"\n  renditionLayout?: `reflowable` | `pre-paginated`\n}\n\nconst parseKoboDisplayOptionsDocument = (\n  doc: XmlDocument,\n): { renditionLayout?: \"pre-paginated\" } => {\n  const platform = doc.childNamed(\"platform\")\n  if (!platform) return {}\n\n  for (const option of platform.childrenNamed(\"option\")) {\n    if (option.attr?.name !== \"fixed-layout\") continue\n    if (option.val.trim().toLowerCase() === \"true\") {\n      return { renditionLayout: \"pre-paginated\" }\n    }\n    return {}\n  }\n\n  return {}\n}\n\n/**\n * Parse a Kobo-related XML document. Unsupported or unrecognized roots\n * yield an empty object. Malformed XML throws from the underlying parser.\n */\nexport const parseKoboXml = (xml: string): KoboMetadata => {\n  const doc = new XmlDocument(xml)\n  const root = doc.name?.toLowerCase()\n\n  if (root === \"display_options\") {\n    return { kind: \"kobo\", ...parseKoboDisplayOptionsDocument(doc) }\n  }\n\n  return { kind: \"kobo\" }\n}\n","import type { Archive } from \"../archives/types\"\n\nexport const getArchiveOpfInfo = (archive: Archive) => {\n  const filesAsArray = archive.records.filter((file) => !file.dir)\n  const file = filesAsArray.find((file) => file.uri.endsWith(`.opf`))\n\n  return {\n    data: file,\n    basePath: file?.uri.substring(0, file.uri.lastIndexOf(`/`)) || ``,\n  }\n}\n","import type { Archive } from \"../archives/types\"\nimport type { ArchiveOpfParsed } from \"./readArchiveOpf\"\n\nexport const getSpineItemFilesFromArchive = async ({\n  archive,\n  archiveOpf,\n}: {\n  archive: Archive\n  archiveOpf: ArchiveOpfParsed | undefined\n}) => {\n  if (!archiveOpf) return []\n\n  const { opf, basePath: opfBasePath } = archiveOpf\n  const { spineRows } = opf\n\n  const archiveSpineItems = archive.records.filter((file) => {\n    return spineRows.find((item) => {\n      if (!opfBasePath) return `${item.href}` === file.uri\n      return `${opfBasePath}/${item.href}` === file.uri\n    })\n  })\n\n  return archiveSpineItems\n}\n","import type { Archive } from \"../archives/types\"\n\nconst hasOpfExtension = (path: string) => path.toLowerCase().endsWith(`.opf`)\n\nexport const isArchiveEpub = (archive: Archive) => {\n  return archive.records.some(\n    (file) =>\n      !file.dir &&\n      (hasOpfExtension(file.basename) || hasOpfExtension(file.uri)),\n  )\n}\n","/**\n * EPUB/XML space-separated token lists (e.g. `properties` on `item` / `itemref`).\n * Trims the raw string, splits on ASCII whitespace, drops empty segments.\n */\nexport const tokenizeXmlSpaceSeparatedList = (\n  raw: string | undefined,\n): readonly string[] => {\n  if (raw === undefined || raw.trim().length === 0) {\n    return []\n  }\n\n  return raw\n    .trim()\n    .split(/\\s+/)\n    .filter((t) => t.length > 0)\n}\n","import { tokenizeXmlSpaceSeparatedList } from \"../utils/tokenizeXmlSpaceSeparatedList\"\n\nexport type OpfItemrefLayoutHints = {\n  readonly renditionLayout?: `reflowable` | `pre-paginated`\n  readonly renditionFlow?:\n    | `scrolled-continuous`\n    | `scrolled-doc`\n    | `paginated`\n    | `auto`\n  readonly pageSpreadLeft?: true\n  readonly pageSpreadRight?: true\n}\n\n/**\n * EPUB `itemref` `properties` attribute (space-separated tokens).\n *\n * @see https://www.w3.org/TR/epub/#attrdef-properties\n */\nexport const layoutHintsFromItemrefProperties = (\n  properties: string | undefined,\n): OpfItemrefLayoutHints => {\n  const tokens = tokenizeXmlSpaceSeparatedList(properties)\n  if (tokens.length === 0) {\n    return {}\n  }\n\n  let renditionLayout: `reflowable` | `pre-paginated` | undefined\n  if (tokens.includes(`rendition:layout-reflowable`)) {\n    renditionLayout = `reflowable`\n  }\n  if (tokens.includes(`rendition:layout-pre-paginated`)) {\n    renditionLayout = `pre-paginated`\n  }\n\n  let renditionFlow: OpfItemrefLayoutHints[\"renditionFlow\"]\n  if (tokens.includes(`rendition:flow-auto`)) {\n    renditionFlow = `auto`\n  }\n  if (tokens.includes(`rendition:flow-paginated`)) {\n    renditionFlow = `paginated`\n  }\n  if (tokens.includes(`rendition:flow-scrolled-doc`)) {\n    renditionFlow = `scrolled-doc`\n  }\n  if (tokens.includes(`rendition:flow-scrolled-continuous`)) {\n    renditionFlow = `scrolled-continuous`\n  }\n\n  return {\n    ...(renditionLayout !== undefined ? { renditionLayout } : {}),\n    ...(renditionFlow !== undefined ? { renditionFlow } : {}),\n    ...(tokens.includes(`page-spread-left`)\n      ? { pageSpreadLeft: true as const }\n      : {}),\n    ...(tokens.includes(`page-spread-right`)\n      ? { pageSpreadRight: true as const }\n      : {}),\n  }\n}\n","import type { XmlElement, XmlNodeBase } from \"xmldoc\"\nimport { XmlDocument } from \"xmldoc\"\nimport { tokenizeXmlSpaceSeparatedList } from \"../utils/tokenizeXmlSpaceSeparatedList\"\nimport { layoutHintsFromItemrefProperties } from \"./spineItemrefProperties\"\n\nexport type OpfSpineManifestItem = {\n  readonly id: string\n  readonly href: string\n  readonly mediaType?: string\n  readonly properties?: string\n}\n\nexport type OpfIdentifier = {\n  readonly value: string\n  readonly scheme?: string\n}\n\nexport type OpfSpineRow = {\n  readonly idref: string\n  readonly id: string\n  readonly href: string\n  readonly mediaType?: string\n  readonly properties?: string\n  readonly renditionLayout?: `reflowable` | `pre-paginated`\n  readonly renditionFlow?:\n    | `scrolled-continuous`\n    | `scrolled-doc`\n    | `paginated`\n    | `auto`\n  readonly pageSpreadLeft?: true\n  readonly pageSpreadRight?: true\n}\n\nexport type OpfGuideReference = {\n  readonly href: string\n  readonly title: string\n  readonly type: string\n}\n\nconst elementLocalName = (name: string): string =>\n  name.includes(\":\") ? name.slice(name.lastIndexOf(\":\") + 1) : name\n\nconst localNameEq = (elementName: string, wantLocal: string): boolean =>\n  elementLocalName(elementName).toLowerCase() === wantLocal.toLowerCase()\n\nconst isXmlElement = (node: XmlNodeBase): node is XmlElement =>\n  node.type === \"element\"\n\nconst childNamedLocal = (\n  parent: XmlElement,\n  localName: string,\n): XmlElement | undefined => {\n  for (const node of parent.children) {\n    if (!isXmlElement(node)) continue\n    if (localNameEq(node.name, localName)) return node\n  }\n  return undefined\n}\n\nconst childrenNamedLocal = (\n  parent: XmlElement,\n  localName: string,\n): XmlElement[] => {\n  const out: XmlElement[] = []\n  for (const node of parent.children) {\n    if (!isXmlElement(node)) continue\n    if (localNameEq(node.name, localName)) out.push(node)\n  }\n  return out\n}\n\nconst identifiersFromMetadata = (metadataEl: XmlElement): OpfIdentifier[] => {\n  const identifiers: OpfIdentifier[] = []\n\n  metadataEl.eachChild((child) => {\n    if (elementLocalName(child.name).toLowerCase() !== \"identifier\") return\n\n    const value = child.val.trim()\n    if (value.length === 0) return\n\n    const scheme =\n      child.attr[\"opf:scheme\"] ?? child.attr[\"opf:Scheme\"] ?? child.attr.scheme\n    const schemeTrimmed = scheme?.trim()\n\n    identifiers.push({\n      value,\n      ...(schemeTrimmed !== undefined && schemeTrimmed.length > 0\n        ? { scheme: schemeTrimmed }\n        : {}),\n    })\n  })\n\n  return identifiers\n}\n\nconst firstTextByLocalName = (\n  metadataEl: XmlElement,\n  localName: string,\n): string | undefined => {\n  let found: string | undefined\n  metadataEl.eachChild((child) => {\n    if (found !== undefined) return\n    if (elementLocalName(child.name).toLowerCase() !== localName.toLowerCase())\n      return\n    const t = child.val.trim()\n    if (t.length > 0) found = t\n  })\n  return found\n}\n\nconst textsByLocalName = (\n  metadataEl: XmlElement,\n  localName: string,\n): string[] => {\n  const out: string[] = []\n  metadataEl.eachChild((child) => {\n    if (elementLocalName(child.name).toLowerCase() !== localName.toLowerCase())\n      return\n    const t = child.val.trim()\n    if (t.length > 0) out.push(t)\n  })\n  return out\n}\n\nconst coverContentIdFromMetadata = (\n  metadataEl: XmlElement,\n): string | undefined => {\n  let coverId: string | undefined\n  metadataEl.eachChild((child) => {\n    if (coverId !== undefined) return\n    if (elementLocalName(child.name).toLowerCase() !== \"meta\") return\n    if (child.attr.name?.toLowerCase() !== \"cover\") return\n    const content = child.attr.content?.trim()\n    if (content !== undefined && content.length > 0) coverId = content\n  })\n  return coverId\n}\n\n/**\n * EPUB cover image inside the manifest. Resolution order, matching\n * what the spec lays out and what the bulk of EPUB producers in the\n * wild rely on:\n *\n *  1. EPUB 3 — the manifest item carrying the `cover-image` token in\n *     its `properties` attribute (§ D.6.1).\n *  2. EPUB 2 — `<meta name=\"cover\" content=\"ID\"/>` in `metadata`,\n *     resolved to the manifest item with that `id`.\n *  3. Last-resort fallback — any image manifest item whose `id`\n *     contains the substring `cover` (case-insensitive); covers the\n *     long tail of producers that emit neither the EPUB 3 property\n *     nor the EPUB 2 meta.\n *\n * Each step requires the candidate manifest item to advertise an\n * `image/*` media type so non-image artefacts named `cover` (XHTML\n * cover pages, NCX entries) don't slip through.\n */\nconst coverHrefFromManifestAndMetadata = ({\n  manifestItems,\n  metadataEl,\n}: {\n  manifestItems: ReadonlyArray<OpfSpineManifestItem>\n  metadataEl: XmlElement | undefined\n}): string | undefined => {\n  const isImage = (item: OpfSpineManifestItem): boolean =>\n    item.mediaType?.toLowerCase().includes(\"image/\") === true\n\n  const byCoverImageProperty = manifestItems.find((item) => {\n    if (!isImage(item)) return false\n    return tokenizeXmlSpaceSeparatedList(item.properties).includes(\n      \"cover-image\",\n    )\n  })\n  if (byCoverImageProperty !== undefined) return byCoverImageProperty.href\n\n  if (metadataEl !== undefined) {\n    const coverContentId = coverContentIdFromMetadata(metadataEl)\n    if (coverContentId !== undefined) {\n      const match = manifestItems.find(\n        (item) => item.id === coverContentId && isImage(item),\n      )\n      if (match !== undefined) return match.href\n    }\n  }\n\n  return manifestItems.find(\n    (item) => item.id.toLowerCase().includes(\"cover\") && isImage(item),\n  )?.href\n}\n\nconst metaValByProperty = (\n  metadataEl: XmlElement,\n  property: string,\n): string | undefined => {\n  const meta = childrenNamedLocal(metadataEl, \"meta\").find(\n    (m) => m.attr.property === property,\n  )\n  const raw = meta?.val\n  if (raw === undefined || raw.trim().length === 0) return undefined\n  return raw\n}\n\nconst guideFromPackage = (doc: XmlElement): OpfGuideReference[] => {\n  const guideEl = childNamedLocal(doc, \"guide\")\n  if (guideEl === undefined) return []\n\n  const refs: OpfGuideReference[] = []\n\n  for (const ref of childrenNamedLocal(guideEl, \"reference\")) {\n    const href = ref.attr.href?.trim()\n    if (href === undefined || href.length === 0) continue\n    refs.push({\n      href,\n      title: ref.attr.title?.trim() ?? ``,\n      type: ref.attr.type?.trim() ?? ``,\n    })\n  }\n\n  return refs\n}\n\nconst manifestItemFromXmlElement = (\n  item: XmlElement,\n): OpfSpineManifestItem | undefined => {\n  const id = item.attr.id\n  const href = item.attr.href\n  if (id === undefined || id.length === 0) return undefined\n  if (href === undefined || href.length === 0) return undefined\n\n  const mediaType = item.attr[\"media-type\"]\n  const properties = item.attr.properties?.trim()\n  return {\n    id,\n    href,\n    ...(mediaType !== undefined && mediaType.length > 0 ? { mediaType } : {}),\n    ...(properties !== undefined && properties.length > 0\n      ? { properties }\n      : {}),\n  }\n}\n\nconst manifestItemsAndById = (\n  manifestEl: XmlElement,\n): {\n  items: OpfSpineManifestItem[]\n  byId: Map<string, OpfSpineManifestItem>\n} => {\n  const items: OpfSpineManifestItem[] = []\n  const byId = new Map<string, OpfSpineManifestItem>()\n\n  for (const el of childrenNamedLocal(manifestEl, \"item\")) {\n    const parsed = manifestItemFromXmlElement(el)\n    if (parsed === undefined) continue\n    items.push(parsed)\n    byId.set(parsed.id, parsed)\n  }\n\n  return { items, byId }\n}\n\nconst spineRowsFromByIdAndSpine = (\n  byId: Map<string, OpfSpineManifestItem>,\n  spineEl: XmlElement,\n): OpfSpineRow[] => {\n  const rows: OpfSpineRow[] = []\n\n  for (const itemref of childrenNamedLocal(spineEl, \"itemref\")) {\n    const idref = itemref.attr.idref\n    if (idref === undefined || idref.trim().length === 0) continue\n\n    const manifestItem = byId.get(idref)\n    if (manifestItem === undefined) continue\n\n    const hints = layoutHintsFromItemrefProperties(itemref.attr.properties)\n\n    rows.push({\n      idref,\n      id: manifestItem.id,\n      href: manifestItem.href,\n      ...(manifestItem.mediaType !== undefined\n        ? { mediaType: manifestItem.mediaType }\n        : {}),\n      ...(manifestItem.properties !== undefined\n        ? { properties: manifestItem.properties }\n        : {}),\n      ...(hints.renditionLayout !== undefined\n        ? { renditionLayout: hints.renditionLayout }\n        : {}),\n      ...(hints.renditionFlow !== undefined\n        ? { renditionFlow: hints.renditionFlow }\n        : {}),\n      ...(hints.pageSpreadLeft !== undefined\n        ? { pageSpreadLeft: hints.pageSpreadLeft }\n        : {}),\n      ...(hints.pageSpreadRight !== undefined\n        ? { pageSpreadRight: hints.pageSpreadRight }\n        : {}),\n    })\n  }\n\n  return rows\n}\n\nexport type OpfMetadata = {\n  readonly kind: \"opf\"\n  readonly manifestItems: ReadonlyArray<OpfSpineManifestItem>\n  readonly spineRows: ReadonlyArray<OpfSpineRow>\n  readonly spineTocIdref: string | undefined\n  readonly identifiers: ReadonlyArray<OpfIdentifier>\n  readonly title: string | undefined\n  /** `dc:creator` values, in document order, trimmed; empty when none. */\n  readonly creators: ReadonlyArray<string>\n  /** First non-empty `dc:publisher`, trimmed. */\n  readonly publisher: string | undefined\n  /** First non-empty `dc:rights`, trimmed. */\n  readonly rights: string | undefined\n  /** `dc:language` values, in document order, trimmed; empty when none. */\n  readonly languages: ReadonlyArray<string>\n  /** `dc:subject` values, in document order, trimmed; empty when none. */\n  readonly subjects: ReadonlyArray<string>\n  /**\n   * Raw `dc:date` value as authored. EPUB 3 requires W3CDTF (a profile\n   * of ISO 8601), but real-world publishers also ship free text here,\n   * so the value is exposed verbatim and consumers normalize as needed.\n   */\n  readonly date: string | undefined\n  /**\n   * Manifest-relative `href` of the cover image, when one can be\n   * resolved from `cover-image` properties (EPUB 3), the EPUB 2\n   * `<meta name=\"cover\">` convention, or an `id` that contains\n   * `cover` on an image manifest item. The href is returned exactly\n   * as it appears in the manifest — callers own folder-prefix\n   * resolution against the OPF's location in the archive.\n   */\n  readonly coverHref: string | undefined\n  readonly renditionLayoutMeta: string | undefined\n  readonly renditionFlowMeta: string | undefined\n  readonly renditionSpreadMeta: string | undefined\n  readonly pageProgressionDirection: string | undefined\n  readonly guide: ReadonlyArray<OpfGuideReference>\n}\n\n/**\n * Parses an EPUB package document (OPF) into structured metadata.\n *\n * Direct children of `package` (`metadata`, `manifest`, `spine`, `guide`) and\n * their structural children (`item`, `itemref`, `reference`, `meta`) are\n * matched by **local name** (ASCII case-insensitive), so prefixed tags such as\n * `opf:manifest` are supported the same as unprefixed `manifest`.\n *\n * Attribute names on `spine` / `itemref` are still read as emitted by xmldoc\n * (no QName normalization).\n */\nexport const parseOpf = (opfXml: string): OpfMetadata => {\n  const doc = new XmlDocument(opfXml)\n  const manifestEl = childNamedLocal(doc, \"manifest\")\n  const spineEl = childNamedLocal(doc, \"spine\")\n  const metadataEl = childNamedLocal(doc, \"metadata\")\n\n  let manifestItems: OpfSpineManifestItem[] = []\n  let spineRows: OpfSpineRow[] = []\n\n  if (manifestEl !== undefined) {\n    const { items, byId } = manifestItemsAndById(manifestEl)\n    manifestItems = items\n    if (spineEl !== undefined) {\n      spineRows = spineRowsFromByIdAndSpine(byId, spineEl)\n    }\n  }\n\n  const pageProgressionDirectionRaw =\n    spineEl?.attr[\"page-progression-direction\"]\n  const pageProgressionDirection =\n    pageProgressionDirectionRaw !== undefined &&\n    pageProgressionDirectionRaw.trim().length > 0\n      ? pageProgressionDirectionRaw\n      : undefined\n\n  const spineTocRaw = spineEl?.attr.toc\n  const spineTocIdref =\n    spineTocRaw !== undefined && spineTocRaw.trim().length > 0\n      ? spineTocRaw.trim()\n      : undefined\n\n  let title: string | undefined\n  let publisher: string | undefined\n  let rights: string | undefined\n  let date: string | undefined\n  let creators: string[] = []\n  let languages: string[] = []\n  let subjects: string[] = []\n  let renditionLayoutMeta: string | undefined\n  let renditionFlowMeta: string | undefined\n  let renditionSpreadMeta: string | undefined\n  const identifiers: OpfIdentifier[] = []\n\n  if (metadataEl !== undefined) {\n    title = firstTextByLocalName(metadataEl, \"title\")\n    publisher = firstTextByLocalName(metadataEl, \"publisher\")\n    rights = firstTextByLocalName(metadataEl, \"rights\")\n    date = firstTextByLocalName(metadataEl, \"date\")\n    creators = textsByLocalName(metadataEl, \"creator\")\n    languages = textsByLocalName(metadataEl, \"language\")\n    subjects = textsByLocalName(metadataEl, \"subject\")\n    renditionLayoutMeta = metaValByProperty(metadataEl, \"rendition:layout\")\n    renditionFlowMeta = metaValByProperty(metadataEl, \"rendition:flow\")\n    renditionSpreadMeta = metaValByProperty(metadataEl, \"rendition:spread\")\n    identifiers.push(...identifiersFromMetadata(metadataEl))\n  }\n\n  const coverHref = coverHrefFromManifestAndMetadata({\n    manifestItems,\n    metadataEl,\n  })\n\n  const guide = guideFromPackage(doc)\n\n  return {\n    kind: \"opf\",\n    manifestItems,\n    spineRows,\n    spineTocIdref,\n    identifiers,\n    title,\n    creators,\n    publisher,\n    rights,\n    languages,\n    subjects,\n    date,\n    coverHref,\n    renditionLayoutMeta,\n    renditionFlowMeta,\n    renditionSpreadMeta,\n    pageProgressionDirection,\n    guide,\n  }\n}\n","import { readRecordAsText } from \"../archives/readRecordAsText\"\nimport type { Archive } from \"../archives/types\"\nimport { getArchiveOpfInfo } from \"./getArchiveOpfInfo\"\nimport { type OpfMetadata, parseOpf } from \"./parse\"\n\nexport type ArchiveOpfParsed = {\n  opf: OpfMetadata\n  basePath: string\n}\n\n/**\n * Loads and parses the package OPF from `archive`.\n *\n * **Attention — not memoized:** every call re-reads the OPF record and runs\n * `parseOpf`. Manifest generation already avoids redundant parses by awaiting\n * this once and passing `archiveOpf` into manifest hooks. The resource pipeline\n * (`generateResourceFromArchive` → `defaultHook`) invokes this again per\n * resource unless callers later thread parsed OPF in explicitly (optional\n * parameter, archive open hook, etc.).\n */\nexport async function readArchiveOpf(\n  archive: Archive,\n): Promise<ArchiveOpfParsed | undefined> {\n  const { data: opsFile, basePath } = getArchiveOpfInfo(archive) || {}\n\n  if (!opsFile || opsFile.dir) {\n    return undefined\n  }\n\n  const raw = await readRecordAsText(opsFile)\n\n  return {\n    opf: parseOpf(raw),\n    basePath,\n  }\n}\n","import type { ArchiveResolveResult } from \"../types/archiveResolve\"\nimport type { AppleMetadata } from \"./parse\"\n\nexport const resolveApple = (input: AppleMetadata): ArchiveResolveResult => {\n  const fixedLayout = input.displayOptions?.platform?.options?.find(\n    (o) => o.name === \"fixed-layout\",\n  )?.value\n\n  const renditionLayout =\n    fixedLayout?.trim().toLowerCase() === \"true\" ? \"pre-paginated\" : undefined\n\n  return {\n    gtin: undefined,\n    isbn: undefined,\n    readingDirection: undefined,\n    renditionLayout,\n    title: undefined,\n    authors: undefined,\n    publisher: undefined,\n    rights: undefined,\n    languages: undefined,\n    date: undefined,\n    subjects: undefined,\n  }\n}\n","const GTIN_LENGTHS = new Set([8, 12, 13, 14])\n\n/**\n * Normalize a raw GTIN / EAN / UPC string to digits only when the length\n * matches a GS1 GTIN family size (8, 12, 13, or 14). Does not verify check digits.\n */\nexport const normalizeGtin = (\n  raw: string | number | undefined | null,\n): string | undefined => {\n  if (raw === undefined || raw === null) return undefined\n\n  const digits = String(raw).replace(/\\D/g, \"\")\n  if (digits.length === 0 || !GTIN_LENGTHS.has(digits.length)) return undefined\n\n  return digits\n}\n","const ISBN_CANDIDATE_PATTERN = /(?:97[89])?\\d{9}[\\dXx]/\n\n/**\n * Normalize a raw ISBN-ish string into a canonical 10- or 13-character\n * form, or `undefined` when no recognisable ISBN can be recovered.\n *\n *  - Strips the common `urn:isbn:` / `isbn:` prefixes.\n *  - Drops everything that isn't a digit or `X`.\n *  - Validates the resulting length (10 or 13).\n *  - Falls back to a lax regex scan so publishers that stuff free text\n *    around the number still yield a usable value.\n */\nexport const normalizeIsbn = (\n  raw: string | number | undefined | null,\n): string | undefined => {\n  if (raw === undefined || raw === null) return undefined\n\n  const stripped = String(raw)\n    .trim()\n    .replace(/^urn:isbn:/i, \"\")\n    .replace(/^isbn[:\\s-]*/i, \"\")\n\n  const digitsOnly = stripped.replace(/[^0-9Xx]/g, \"\")\n\n  if (digitsOnly.length === 10 || digitsOnly.length === 13) {\n    return digitsOnly.toUpperCase()\n  }\n\n  const match = stripped.match(ISBN_CANDIDATE_PATTERN)\n  if (match) return match[0].toUpperCase()\n\n  return undefined\n}\n","import type { ArchiveResolveResult } from \"../types/archiveResolve\"\nimport { normalizeGtin } from \"../utils/normalizeGtin\"\nimport { normalizeIsbn } from \"../utils/normalizeIsbn\"\nimport type { ComicInfo } from \"./parse\"\n\nconst readingDirection = (info: ComicInfo): \"ltr\" | \"rtl\" | undefined => {\n  switch (info.Manga) {\n    case \"YesAndRightToLeft\":\n      return \"rtl\"\n    case \"Yes\":\n    case \"No\":\n      return \"ltr\"\n    default:\n      return undefined\n  }\n}\n\nconst trimToUndefined = (raw: string | undefined): string | undefined => {\n  if (raw === undefined) return undefined\n  const trimmed = raw.trim()\n  return trimmed.length > 0 ? trimmed : undefined\n}\n\n/**\n * Split a comma-separated ComicInfo value into its individual tokens.\n * `Writer`, `Genre`, and `Tags` all follow the same de-facto convention:\n * tokens separated by `,`, with whitespace trimmed and empty tokens\n * dropped (real-world files leave trailing commas around).\n */\nconst splitCommaList = (raw: string | undefined): string[] => {\n  if (raw === undefined) return []\n  return raw\n    .split(\",\")\n    .map((token) => token.trim())\n    .filter((token) => token.length > 0)\n}\n\nconst parseNonNegativeInt = (raw: string | undefined): number | undefined => {\n  const trimmed = trimToUndefined(raw)\n  if (trimmed === undefined) return undefined\n  if (!/^\\d+$/.test(trimmed)) return undefined\n  const n = Number.parseInt(trimmed, 10)\n  return Number.isFinite(n) ? n : undefined\n}\n\nconst dateFromYearMonthDay = (\n  info: ComicInfo,\n):\n  | {\n      year?: number\n      month?: number\n      day?: number\n    }\n  | undefined => {\n  const year = parseNonNegativeInt(info.Year)\n  const month = parseNonNegativeInt(info.Month)\n  const day = parseNonNegativeInt(info.Day)\n\n  if (year === undefined && month === undefined && day === undefined) {\n    return undefined\n  }\n\n  return {\n    ...(year !== undefined ? { year } : {}),\n    ...(month !== undefined ? { month } : {}),\n    ...(day !== undefined ? { day } : {}),\n  }\n}\n\nexport const resolveComicInfo = (info: ComicInfo): ArchiveResolveResult => {\n  const raw = info.GTIN\n  const languageIso = trimToUndefined(info.LanguageISO)\n  const authors = splitCommaList(info.Writer)\n  const subjects = [...splitCommaList(info.Genre), ...splitCommaList(info.Tags)]\n\n  return {\n    gtin: normalizeGtin(raw),\n    isbn: normalizeIsbn(raw),\n    readingDirection: readingDirection(info),\n    renditionLayout: undefined,\n    title: trimToUndefined(info.Title),\n    authors: authors.length > 0 ? authors : undefined,\n    publisher: trimToUndefined(info.Publisher),\n    rights: undefined,\n    languages: languageIso !== undefined ? [languageIso] : undefined,\n    date: dateFromYearMonthDay(info),\n    subjects: subjects.length > 0 ? subjects : undefined,\n  }\n}\n","import type { ArchiveResolveResult } from \"../types/archiveResolve\"\nimport type { KoboMetadata } from \"./parse\"\n\nexport const resolveKobo = (input: KoboMetadata): ArchiveResolveResult => ({\n  gtin: undefined,\n  isbn: undefined,\n  readingDirection: undefined,\n  renditionLayout: input.renditionLayout,\n  title: undefined,\n  authors: undefined,\n  publisher: undefined,\n  rights: undefined,\n  languages: undefined,\n  date: undefined,\n  subjects: undefined,\n})\n","/**\n * Extract the calendar components of a W3CDTF literal — the\n * date subset of ISO 8601 that EPUB 3.3 § 5.5.3.2.4 mandates for\n * `dc:date`. Accepted forms: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`, and\n * any of the above followed by a `Thh:mm[:ss[.s]][TZD]` time\n * portion that we ignore.\n *\n * Components are returned as plain integers (`month` is 1-12,\n * `day` is 1-31), independent of the host timezone — using\n * `Date.parse` would shift `2011-01-01` by a day in negative-offset\n * locales, which is the exact bug this regex-based approach exists\n * to avoid. Returns `undefined` when the input doesn't even match\n * a leading 4-digit year so consumers can fall back without\n * branching on partial shapes.\n */\nexport const parseW3cDtfDate = (\n  raw: string | undefined,\n):\n  | {\n      year?: number\n      month?: number\n      day?: number\n    }\n  | undefined => {\n  if (raw === undefined) return undefined\n\n  const match = raw.trim().match(/^(\\d{4})(?:-(\\d{2})(?:-(\\d{2}))?)?/)\n  if (match === null) return undefined\n\n  const [, yearRaw, monthRaw, dayRaw] = match\n\n  return {\n    ...(yearRaw !== undefined ? { year: Number.parseInt(yearRaw, 10) } : {}),\n    ...(monthRaw !== undefined ? { month: Number.parseInt(monthRaw, 10) } : {}),\n    ...(dayRaw !== undefined ? { day: Number.parseInt(dayRaw, 10) } : {}),\n  }\n}\n","import type { ArchiveResolveResult } from \"../types/archiveResolve\"\nimport { normalizeGtin } from \"../utils/normalizeGtin\"\nimport { normalizeIsbn } from \"../utils/normalizeIsbn\"\nimport { parseW3cDtfDate } from \"../utils/parseW3cDtfDate\"\nimport type { OpfIdentifier, OpfMetadata } from \"./parse\"\n\nconst rawIdentifierValueForIsbn = (\n  identifiers: ReadonlyArray<OpfIdentifier>,\n): string | undefined => {\n  for (const i of identifiers) {\n    if (i.scheme !== undefined && i.scheme.trim().toLowerCase() === \"isbn\") {\n      if (normalizeIsbn(i.value) !== undefined) return i.value\n    }\n  }\n\n  for (const i of identifiers) {\n    if (normalizeIsbn(i.value) !== undefined) return i.value\n  }\n\n  return undefined\n}\n\nexport const resolveOpf = (input: OpfMetadata): ArchiveResolveResult => {\n  const ppd = input.pageProgressionDirection?.trim().toLowerCase()\n  const readingDirection = ppd === \"ltr\" || ppd === \"rtl\" ? ppd : undefined\n\n  const rl = input.renditionLayoutMeta?.trim().toLowerCase()\n  const renditionLayout =\n    rl === \"reflowable\" || rl === \"pre-paginated\" ? rl : undefined\n\n  const raw = rawIdentifierValueForIsbn(input.identifiers)\n\n  return {\n    gtin: normalizeGtin(raw),\n    isbn: normalizeIsbn(raw),\n    readingDirection,\n    renditionLayout,\n    title: input.title,\n    authors: input.creators.length > 0 ? [...input.creators] : undefined,\n    publisher: input.publisher,\n    rights: input.rights,\n    languages: input.languages.length > 0 ? [...input.languages] : undefined,\n    date: parseW3cDtfDate(input.date),\n    subjects: input.subjects.length > 0 ? [...input.subjects] : undefined,\n  }\n}\n","import type { AppleMetadata } from \"./apple/parse\"\nimport { resolveApple } from \"./apple/resolve\"\nimport type { ComicInfo } from \"./comicInfo/parse\"\nimport { resolveComicInfo } from \"./comicInfo/resolve\"\nimport type { KoboMetadata } from \"./kobo/parse\"\nimport { resolveKobo } from \"./kobo/resolve\"\nimport type { OpfMetadata } from \"./opf/parse\"\nimport { resolveOpf } from \"./opf/resolve\"\nimport type { ArchiveResolveResult } from \"./types/archiveResolve\"\n\nexport type ResolvedArchiveInput =\n  | ComicInfo\n  | KoboMetadata\n  | AppleMetadata\n  | OpfMetadata\n\nexport const resolveArchiveMetadata = (\n  input: ResolvedArchiveInput,\n): ArchiveResolveResult => {\n  if (input.kind === \"comicInfo\") return resolveComicInfo(input)\n  if (input.kind === \"kobo\") return resolveKobo(input)\n  if (input.kind === \"apple\") return resolveApple(input)\n  return resolveOpf(input)\n}\n","import { sortByTitleComparator } from \"@prose-reader/shared\"\nimport type { Archive } from \"../archives/types\"\nimport type { ArchiveTocItem } from \"./types\"\n\n/**\n * Derive a TOC from the folder hierarchy of the archive (e.g. a CBZ with one\n * folder per chapter). Each folder becomes an entry pointing to its first\n * file in natural sort order.\n */\nexport const buildTocFromFolders = (archive: Archive): ArchiveTocItem[] => {\n  const filesSortedByAlpha = [...archive.records].sort((a, b) =>\n    sortByTitleComparator(a.uri, b.uri),\n  )\n\n  const combineWith = (\n    toc: ArchiveTocItem[],\n    folder: string,\n    subFolders: string[],\n    containerHref: string,\n    path: string,\n  ): ArchiveTocItem[] => {\n    const foundEntry = toc.find((entry) => entry.title === folder)\n    const [nextFolderCursor, ...nextSubFolders] = subFolders\n\n    if (foundEntry) {\n      if (nextFolderCursor) {\n        return [\n          ...toc.filter((entry) => entry !== foundEntry),\n          {\n            ...foundEntry,\n            // combineWith returns the full merged children list already\n            contents: combineWith(\n              foundEntry.contents,\n              nextFolderCursor,\n              nextSubFolders,\n              containerHref,\n              path,\n            ),\n          } satisfies ArchiveTocItem,\n        ]\n      }\n\n      const previousRegisteredPathWasLonger =\n        foundEntry.path.split(\"/\").length > path.split(\"/\").length\n\n      if (previousRegisteredPathWasLonger) {\n        return [\n          ...toc.filter((entry) => entry !== foundEntry),\n          {\n            ...foundEntry,\n            path,\n            containerHref,\n          } satisfies ArchiveTocItem,\n        ]\n      }\n\n      return toc\n    }\n\n    if (nextFolderCursor) {\n      return [\n        ...toc,\n        {\n          contents: combineWith(\n            [],\n            nextFolderCursor,\n            nextSubFolders,\n            containerHref,\n            path,\n          ),\n          containerHref,\n          path,\n          title: folder,\n        },\n      ]\n    }\n\n    return [\n      ...toc,\n      {\n        contents: [],\n        containerHref,\n        path,\n        title: folder,\n      },\n    ]\n  }\n\n  return filesSortedByAlpha.reduce<ArchiveTocItem[]>((acc, file) => {\n    if (file.dir) return acc\n\n    const folders = file.uri.split(\"/\").slice(0, -1)\n    const [firstFolder, ...restFolders] = folders\n\n    if (!firstFolder) return acc\n\n    // encodeURI leaves `#` and `?` untouched (reserved URI delimiters), but in\n    // a raw archive filename they are data and would otherwise be parsed as\n    // fragment/query once joined onto a base URL.\n    const containerHref = encodeURI(file.uri)\n      .replace(/#/g, `%23`)\n      .replace(/\\?/g, `%3F`)\n      .replace(/\\/$/, \"\")\n    const path = file.uri.replace(/\\/$/, \"\")\n\n    return combineWith(acc, firstFolder, restFolders, containerHref, path)\n  }, [])\n}\n","import { XmlElement, XmlTextNode } from \"xmldoc\"\n\nexport const getXmlElementInnerText = (\n  node: XmlElement | undefined,\n): string => {\n  if (!node) return \"\"\n\n  return node.children\n    .map((child) => {\n      if (child instanceof XmlTextNode) return child.text\n      if (child instanceof XmlElement) return getXmlElementInnerText(child)\n      return \"\"\n    })\n    .join(\"\")\n    .trim()\n}\n","import { getUriBasePath, urlJoin } from \"@prose-reader/shared\"\nimport { XmlDocument, XmlElement, type XmlNodeBase } from \"xmldoc\"\nimport { readRecordAsText } from \"../archives/readRecordAsText\"\nimport type { Archive } from \"../archives/types\"\nimport type { OpfMetadata } from \"../opf/parse\"\nimport { getXmlElementInnerText } from \"../utils/getXmlElementInnerText\"\nimport { tokenizeXmlSpaceSeparatedList } from \"../utils/tokenizeXmlSpaceSeparatedList\"\nimport type { ArchiveTocItem } from \"./types\"\n\nconst manifestItemIsNavDocument = (item: {\n  readonly properties?: string\n}): boolean => tokenizeXmlSpaceSeparatedList(item.properties).includes(`nav`)\n\n/**\n * @see https://www.w3.org/TR/epub-33/#sec-nav-def-model\n */\nconst extractNavChapter = (\n  li: XmlElement,\n  { basePath }: { basePath: string },\n) => {\n  const chp: ArchiveTocItem = {\n    contents: [],\n    path: ``,\n    containerHref: ``,\n    title: ``,\n  }\n\n  let contentNode = li.childNamed(`span`) || li.childNamed(`a`)\n\n  chp.title =\n    (contentNode?.attr.title ||\n      contentNode?.val.trim() ||\n      getXmlElementInnerText(contentNode)) ??\n    ``\n\n  let node = contentNode?.name\n\n  if (node !== `a`) {\n    contentNode = li.descendantWithPath(`${node}.a`)\n    if (contentNode) {\n      node = contentNode.name.toLowerCase()\n    }\n  }\n\n  if (node === `a` && contentNode?.attr.href) {\n    chp.path = urlJoin(basePath, contentNode.attr.href)\n    chp.containerHref = chp.path\n  }\n  const sublistNode = li.childNamed(`ol`)\n  if (sublistNode) {\n    const children = sublistNode.childrenNamed(`li`)\n    if (children && children.length > 0) {\n      chp.contents = children.map((child) =>\n        extractNavChapter(child, { basePath }),\n      )\n    }\n  }\n\n  return chp\n}\n\nconst buildTocFromNavDocument = (\n  doc: XmlDocument,\n  { basePath }: { basePath: string },\n) => {\n  const toc: ArchiveTocItem[] = []\n\n  let navDataChildren: XmlNodeBase[] | undefined\n\n  if (doc.descendantWithPath(`body.nav.ol`)) {\n    navDataChildren = doc.descendantWithPath(`body.nav.ol`)?.children\n  } else if (doc.descendantWithPath(`body.section.nav.ol`)) {\n    navDataChildren = doc.descendantWithPath(`body.section.nav.ol`)?.children\n  }\n\n  if (navDataChildren && navDataChildren.length > 0) {\n    navDataChildren\n      .filter(\n        (li): li is XmlElement => li instanceof XmlElement && li.name === `li`,\n      )\n      .forEach((li) => {\n        toc.push(extractNavChapter(li, { basePath }))\n      })\n  }\n\n  return toc\n}\n\nexport const resolveTocFromNav = async (\n  opf: OpfMetadata,\n  archive: Archive,\n): Promise<ArchiveTocItem[] | undefined> => {\n  const navItem = opf.manifestItems.find(manifestItemIsNavDocument)\n\n  if (navItem?.href) {\n    const tocFile = archive.records.find((item) =>\n      item.uri.endsWith(navItem.href),\n    )\n\n    if (tocFile && !tocFile.dir) {\n      const doc = new XmlDocument(await readRecordAsText(tocFile))\n\n      const tocFileBasePath = getUriBasePath(tocFile.uri)\n\n      /**\n       * links inside toc.xhtml are relative to the toc.xhtml file,\n       * not the opf file anymore\n       */\n      return buildTocFromNavDocument(doc, { basePath: tocFileBasePath })\n    }\n  }\n\n  return undefined\n}\n","import { urlJoin } from \"@prose-reader/shared\"\nimport { XmlDocument, type XmlElement } from \"xmldoc\"\nimport { readRecordAsText } from \"../archives/readRecordAsText\"\nimport type { Archive } from \"../archives/types\"\nimport type { OpfMetadata } from \"../opf/parse\"\nimport type { ArchiveTocItem } from \"./types\"\n\nconst mapNcxChapter = (\n  point: XmlElement,\n  { opfBasePath, prefix }: { opfBasePath: string; prefix: string },\n) => {\n  const src = point?.childNamed(`${prefix}content`)?.attr.src || ``\n  const path = urlJoin(opfBasePath, src)\n\n  const out: ArchiveTocItem = {\n    title:\n      point?.descendantWithPath(`${prefix}navLabel.${prefix}text`)?.val || ``,\n    path,\n    containerHref: path,\n    contents: [],\n  }\n  const children = point.childrenNamed(`${prefix}navPoint`)\n  if (children && children.length > 0) {\n    out.contents = children.map((pt) =>\n      mapNcxChapter(pt, { opfBasePath, prefix }),\n    )\n  }\n\n  return out\n}\n\nconst buildTocFromNcxDocument = (\n  ncxData: XmlDocument,\n  { opfBasePath }: { opfBasePath: string },\n) => {\n  const toc: ArchiveTocItem[] = []\n\n  const rootTagName = ncxData.name\n  let prefix = ``\n  if (rootTagName.indexOf(`:`) !== -1) {\n    prefix = `${rootTagName.split(`:`)[0]}:`\n  }\n\n  ncxData\n    .childNamed(`${prefix}navMap`)\n    ?.childrenNamed(`${prefix}navPoint`)\n    .forEach((point) => {\n      toc.push(mapNcxChapter(point, { opfBasePath, prefix }))\n    })\n\n  return toc\n}\n\nexport const resolveTocFromNcx = async ({\n  opf,\n  opfBasePath,\n  archive,\n}: {\n  opf: OpfMetadata\n  opfBasePath: string\n  archive: Archive\n}): Promise<ArchiveTocItem[] | undefined> => {\n  const ncxId = opf.spineTocIdref\n\n  if (ncxId) {\n    const ncxItem = opf.manifestItems.find((item) => item.id === ncxId)\n\n    if (ncxItem) {\n      const ncxPath = `${opfBasePath}${opfBasePath === `` ? `` : `/`}${ncxItem.href}`\n\n      const file = archive.records.find((item) => item.uri.endsWith(ncxPath))\n\n      if (file && !file.dir) {\n        const ncxData = new XmlDocument(await readRecordAsText(file))\n\n        return buildTocFromNcxDocument(ncxData, { opfBasePath })\n      }\n    }\n  }\n\n  return undefined\n}\n","import type { Archive } from \"../archives/types\"\nimport { type ArchiveOpfParsed, readArchiveOpf } from \"../opf/readArchiveOpf\"\nimport { buildTocFromFolders } from \"./folders\"\nimport { resolveTocFromNav } from \"./nav\"\nimport { resolveTocFromNcx } from \"./ncx\"\nimport type { ArchiveTocItem } from \"./types\"\n\n/**\n * Resolve the table of contents of an archive into a generic, container\n * relative JSON structure ({@link ArchiveTocItem}). Consumers never have to\n * deal with the underlying XML (EPUB nav document, NCX) or archive layout.\n *\n * Strategies, in order:\n * - EPUB nav document (`properties=\"nav\"` manifest item)\n * - NCX (`spine@toc` idref)\n * - EPUB-like containers with neither resolve to an explicit empty TOC — the\n *   folder layout of an EPUB zip is not a meaningful TOC.\n * - Anything else falls back to the folder hierarchy, or `undefined` when the\n *   archive is flat (no folder to derive entries from).\n *\n * Pass `opf` when you already hold the parsed OPF (e.g. during manifest\n * generation) to skip the internal lookup.\n */\nexport const resolveArchiveToc = async (\n  archive: Archive,\n  { opf }: { opf?: ArchiveOpfParsed } = {},\n): Promise<ArchiveTocItem[] | undefined> => {\n  const archiveOpf = opf ?? (await readArchiveOpf(archive))\n\n  if (archiveOpf) {\n    const tocFromNav = await resolveTocFromNav(archiveOpf.opf, archive)\n\n    if (tocFromNav) return tocFromNav\n\n    const tocFromNcx = await resolveTocFromNcx({\n      opf: archiveOpf.opf,\n      opfBasePath: archiveOpf.basePath,\n      archive,\n    })\n\n    if (tocFromNcx) return tocFromNcx\n\n    return []\n  }\n\n  const tocFromFolders = buildTocFromFolders(archive)\n\n  return tocFromFolders.length === 0 ? undefined : tocFromFolders\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,15 +1,32 @@
 export type { AppleDisplayOption, AppleMetadata } from './apple/parse';
 export { APPLE_IBOOKS_DISPLAY_OPTIONS_FILENAME, parseAppleDisplayOptionsXml, } from './apple/parse';
+export { createArchive } from './archives/createArchive';
+export { createArchiveFromArrayBufferList } from './archives/createArchiveFromArrayBufferList';
+export { type ArchiveEntry, type CreateArchiveFromEntriesOptions, createArchiveFromEntries, } from './archives/createArchiveFromEntries';
+export { createArchiveFromText } from './archives/createArchiveFromText';
+export { createArchiveFromUrls } from './archives/createArchiveFromUrls';
+export { arrayBufferFileAccessors, blobFileAccessors, } from './archives/fileAccessors';
+export { readRecordAsText } from './archives/readRecordAsText';
+export type { Archive, ArchiveRecord, DirectoryRecord, FileRecord, } from './archives/types';
+export { getArchiveFileRecordByUri, isDirectoryRecord, isFileRecord, } from './archives/types';
+export { getArchiveHasComicInfo } from './comicInfo/getArchiveHasComicInfo';
 export type { ComicInfoManga } from './comicInfo/manga';
 export { COMIC_INFO_MANGA_VALUES, isComicInfoManga } from './comicInfo/manga';
 export type { ComicInfo } from './comicInfo/parse';
 export { COMIC_INFO_FILENAME, parseComicInfo } from './comicInfo/parse';
 export type { KoboMetadata } from './kobo/parse';
 export { KOBO_DISPLAY_OPTIONS_FILENAME, parseKoboXml } from './kobo/parse';
+export { getArchiveOpfInfo } from './opf/getArchiveOpfInfo';
+export { getSpineItemFilesFromArchive } from './opf/getSpineItemFilesFromArchive';
+export { isArchiveEpub } from './opf/isArchiveEpub';
 export type { OpfGuideReference, OpfIdentifier, OpfMetadata, OpfSpineManifestItem, OpfSpineRow, } from './opf/parse';
 export { parseOpf } from './opf/parse';
+export type { ArchiveOpfParsed } from './opf/readArchiveOpf';
+export { readArchiveOpf } from './opf/readArchiveOpf';
 export type { ResolvedArchiveInput } from './resolve';
 export { resolveArchiveMetadata } from './resolve';
+export { resolveArchiveToc } from './toc/resolveArchiveToc';
+export type { ArchiveTocItem } from './toc/types';
 export type { ArchiveResolveResult } from './types/archiveResolve';
 export { normalizeGtin } from './utils/normalizeGtin';
 export { normalizeIsbn } from './utils/normalizeIsbn';

package/dist/opf/getArchiveOpfInfo.d.ts

@@ -0,0 +1,5 @@
+import { Archive } from '../archives/types';
+export declare const getArchiveOpfInfo: (archive: Archive) => {
+    data: import('..').FileRecord | undefined;
+    basePath: string;
+};

package/dist/opf/getSpineItemFilesFromArchive.d.ts

@@ -0,0 +1,6 @@
+import { Archive } from '../archives/types';
+import { ArchiveOpfParsed } from './readArchiveOpf';
+export declare const getSpineItemFilesFromArchive: ({ archive, archiveOpf, }: {
+    archive: Archive;
+    archiveOpf: ArchiveOpfParsed | undefined;
+}) => Promise<import('..').ArchiveRecord[]>;

package/dist/opf/isArchiveEpub.d.ts

@@ -0,0 +1,2 @@
+import { Archive } from '../archives/types';
+export declare const isArchiveEpub: (archive: Archive) => boolean;

package/dist/opf/readArchiveOpf.d.ts

@@ -0,0 +1,7 @@
+import { Archive } from '../archives/types';
+import { OpfMetadata } from './parse';
+export type ArchiveOpfParsed = {
+    opf: OpfMetadata;
+    basePath: string;
+};
+export declare function readArchiveOpf(archive: Archive): Promise<ArchiveOpfParsed | undefined>;

package/dist/report.d.ts

@@ -0,0 +1,2 @@
+import { Report as SharedReport } from '@prose-reader/shared';
+export declare const Report: SharedReport;

package/dist/toc/folders.d.ts

@@ -0,0 +1,3 @@
+import { Archive } from '../archives/types';
+import { ArchiveTocItem } from './types';
+export declare const buildTocFromFolders: (archive: Archive) => ArchiveTocItem[];

package/dist/toc/nav.d.ts

@@ -0,0 +1,4 @@
+import { Archive } from '../archives/types';
+import { OpfMetadata } from '../opf/parse';
+import { ArchiveTocItem } from './types';
+export declare const resolveTocFromNav: (opf: OpfMetadata, archive: Archive) => Promise<ArchiveTocItem[] | undefined>;

package/dist/toc/ncx.d.ts

@@ -0,0 +1,8 @@
+import { Archive } from '../archives/types';
+import { OpfMetadata } from '../opf/parse';
+import { ArchiveTocItem } from './types';
+export declare const resolveTocFromNcx: ({ opf, opfBasePath, archive, }: {
+    opf: OpfMetadata;
+    opfBasePath: string;
+    archive: Archive;
+}) => Promise<ArchiveTocItem[] | undefined>;

package/dist/toc/resolveArchiveToc.d.ts

@@ -0,0 +1,6 @@
+import { Archive } from '../archives/types';
+import { ArchiveOpfParsed } from '../opf/readArchiveOpf';
+import { ArchiveTocItem } from './types';
+export declare const resolveArchiveToc: (archive: Archive, { opf }?: {
+    opf?: ArchiveOpfParsed;
+}) => Promise<ArchiveTocItem[] | undefined>;

package/dist/toc/resolveArchiveToc.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/toc/types.d.ts

@@ -0,0 +1,6 @@
+export type ArchiveTocItem = {
+    title: string;
+    path: string;
+    containerHref: string;
+    contents: ArchiveTocItem[];
+};

package/dist/utils/getXmlElementInnerText.d.ts

@@ -0,0 +1,2 @@
+import { XmlElement } from 'xmldoc';
+export declare const getXmlElementInnerText: (node: XmlElement | undefined) => string;

package/package.json

@@ -1,17 +1,43 @@
 {
   "name": "@prose-reader/archive-reader",
-  "version": "1.320.0",
+  "version": "1.322.0",
   "type": "module",
-  "main": "./dist/index.umd.cjs",
-  "module": "./dist/index.js",
+  "main": "./dist/index/index.cjs",
+  "module": "./dist/index/index.js",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.umd.cjs"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index/index.js",
+      "require": "./dist/index/index.cjs"
+    },
+    "./archives/createArchiveFromJszip": {
+      "types": "./dist/archives/createArchiveFromJszip.d.ts",
+      "import": "./dist/archives/createArchiveFromJszip/index.js",
+      "require": "./dist/archives/createArchiveFromJszip/index.cjs"
+    },
+    "./archives/createArchiveFromLibArchive": {
+      "types": "./dist/archives/createArchiveFromLibArchive.d.ts",
+      "import": "./dist/archives/createArchiveFromLibArchive/index.js",
+      "require": "./dist/archives/createArchiveFromLibArchive/index.cjs"
+    },
+    "./archives/createArchiveFromUnzipper": {
+      "types": "./dist/archives/createArchiveFromUnzipper.d.ts",
+      "import": "./dist/archives/createArchiveFromUnzipper/index.js",
+      "require": "./dist/archives/createArchiveFromUnzipper/index.cjs"
+    },
+    "./archives/createArchiveFromNodeUnrarJs": {
+      "types": "./dist/archives/createArchiveFromNodeUnrarJs.d.ts",
+      "import": "./dist/archives/createArchiveFromNodeUnrarJs/index.js",
+      "require": "./dist/archives/createArchiveFromNodeUnrarJs/index.cjs"
+    },
+    "./archives/createArchiveFromZipJs": {
+      "types": "./dist/archives/createArchiveFromZipJs.d.ts",
+      "import": "./dist/archives/createArchiveFromZipJs/index.js",
+      "require": "./dist/archives/createArchiveFromZipJs/index.cjs"
     }
   },
   "types": "./dist/index.d.ts",
@@ -27,7 +53,45 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
+    "@prose-reader/shared": "^1.322.0",
     "xmldoc": "^2.0.0"
   },
-  "gitHead": "dc464fdb493dbe767dc2012462ea4a74b45872a7"
+  "peerDependencies": {
+    "@zip.js/zip.js": "^2.8.26",
+    "buffer": "^6.0.3",
+    "jszip": "^3.10.0",
+    "libarchive.js": "^2.0.2",
+    "node-unrar-js": "^2.0.2",
+    "unzipper": "^0.12.3"
+  },
+  "peerDependenciesMeta": {
+    "@zip.js/zip.js": {
+      "optional": true
+    },
+    "buffer": {
+      "optional": true
+    },
+    "jszip": {
+      "optional": true
+    },
+    "unzipper": {
+      "optional": true
+    },
+    "libarchive.js": {
+      "optional": true
+    },
+    "node-unrar-js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/unzipper": "^0.10.11",
+    "@zip.js/zip.js": "^2.8.26",
+    "buffer": "^6.0.3",
+    "jszip": "^3.10.0",
+    "libarchive.js": "^2.0.2",
+    "node-unrar-js": "^2.0.2",
+    "unzipper": "^0.12.3"
+  },
+  "gitHead": "feb6bfbbae662045d9e4e10e45dfc129040e86ad"
 }