wiki-graph-core 0.3.1

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,10 @@
+export { EPUB_SOURCE_ADAPTER, EpubSourceAdapter } from './document.js';
+import '../adapter.js';
+import '../meta.js';
+import 'zod';
+import '../types.js';
+import './archive.js';
+import 'stream';
+import 'yauzl';
+import './content.js';
+import './package.js';

package/dist/source/epub/index.js

@@ -0,0 +1,6 @@
+import { EpubSourceAdapter, EPUB_SOURCE_ADAPTER } from "./document.js";
+export {
+  EPUB_SOURCE_ADAPTER,
+  EpubSourceAdapter
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,16 @@
+import { EpubArchive } from './archive.js';
+import { EpubPackageData } from './package.js';
+import 'stream';
+import 'yauzl';
+import '../meta.js';
+import 'zod';
+
+interface EpubNavigationItem {
+    readonly title: string | undefined;
+    readonly path: string | undefined;
+    readonly fragment: string | undefined;
+    readonly children: readonly EpubNavigationItem[];
+}
+declare function readEpubNavigation(archive: EpubArchive, packageData: EpubPackageData): Promise<readonly EpubNavigationItem[]>;
+
+export { type EpubNavigationItem, readEpubNavigation };

package/dist/source/epub/navigation.js

@@ -0,0 +1,215 @@
+import { basename, extname, posix } from "path";
+import { parseDocument } from "htmlparser2";
+import { splitHref } from "./archive.js";
+import {} from "./package.js";
+import {
+  findChild,
+  findChildren,
+  getAttribute,
+  getDescendantText,
+  parseXml
+} from "./xml.js";
+const NON_CONTENT_FILE_NAMES = /* @__PURE__ */ new Set([
+  "toc.xhtml",
+  "nav.xhtml",
+  "contents.xhtml",
+  "tableofcontents.xhtml",
+  "cover.xhtml",
+  "titlepage.xhtml"
+]);
+async function readEpubNavigation(archive, packageData) {
+  const navigation = await readNavDocument(archive, packageData) ?? await readNcxDocument(archive, packageData) ?? [];
+  if (navigation.length === 0) {
+    return buildSpineNavigation(packageData, /* @__PURE__ */ new Set());
+  }
+  const referencedPaths = collectReferencedPaths(navigation);
+  const extras = buildSpineNavigation(packageData, referencedPaths);
+  return extras.length === 0 ? navigation : [...navigation, ...extras];
+}
+async function readNavDocument(archive, packageData) {
+  if (packageData.navPath === void 0) {
+    return void 0;
+  }
+  const document = parseDocument(await archive.readText(packageData.navPath), {
+    decodeEntities: true
+  });
+  const nav = findFirstHtmlElement(document, (element) => {
+    if (getHtmlTagName(element) !== "nav") {
+      return false;
+    }
+    const type = (element.attribs?.["epub:type"] ?? element.attribs?.type ?? "").split(/\s+/u).map((value) => value.trim().toLowerCase());
+    return type.includes("toc");
+  });
+  if (nav === void 0) {
+    return void 0;
+  }
+  const ol = findFirstHtmlElement(
+    nav,
+    (element) => getHtmlTagName(element) === "ol"
+  );
+  if (ol === void 0) {
+    return void 0;
+  }
+  const items = getHtmlElementChildren(ol).filter((child) => getHtmlTagName(child) === "li").map((li) => parseNavListItem(archive, packageData.navPath, li)).filter((item) => item !== void 0);
+  return items.length === 0 ? void 0 : items;
+}
+async function readNcxDocument(archive, packageData) {
+  if (packageData.ncxPath === void 0) {
+    return void 0;
+  }
+  const root = parseXml(await archive.readText(packageData.ncxPath));
+  const navMap = findChild(root, "navMap");
+  if (navMap === void 0) {
+    return void 0;
+  }
+  const items = findChildren(navMap, "navPoint").map(
+    (navPoint) => parseNcxNavPoint(archive, packageData.ncxPath, navPoint)
+  ).filter((item) => item !== void 0);
+  return items.length === 0 ? void 0 : items;
+}
+function parseNavListItem(archive, navPath, item) {
+  const label = findHtmlLabelNode(item);
+  const title = label === void 0 ? void 0 : normalizeText(collectHtmlText(label));
+  const href = label !== void 0 && getHtmlTagName(label) === "a" ? label.attribs?.href : void 0;
+  const resolved = resolveHtmlHref(archive, navPath, href);
+  const children = getHtmlElementChildren(item).filter((child) => getHtmlTagName(child) === "ol").flatMap((ol) => getHtmlElementChildren(ol)).filter((child) => getHtmlTagName(child) === "li").map((li) => parseNavListItem(archive, navPath, li)).filter((child) => child !== void 0);
+  if (title === void 0 && resolved.path === void 0 && children.length === 0) {
+    return void 0;
+  }
+  return {
+    title,
+    path: resolved.path,
+    fragment: resolved.fragment,
+    children
+  };
+}
+function parseNcxNavPoint(archive, ncxPath, navPoint) {
+  const navLabel = findChild(navPoint, "navLabel");
+  const textElement = navLabel === void 0 ? void 0 : findChild(navLabel, "text");
+  const title = textElement === void 0 ? void 0 : normalizeText(getDescendantText(textElement));
+  const contentElement = findChild(navPoint, "content");
+  const resolved = resolveXmlHref(
+    archive,
+    ncxPath,
+    getAttribute(contentElement ?? navPoint, "src")
+  );
+  const children = findChildren(navPoint, "navPoint").map((child) => parseNcxNavPoint(archive, ncxPath, child)).filter((child) => child !== void 0);
+  if (title === void 0 && resolved.path === void 0 && children.length === 0) {
+    return void 0;
+  }
+  return {
+    title,
+    path: resolved.path,
+    fragment: resolved.fragment,
+    children
+  };
+}
+function buildSpineNavigation(packageData, referencedPaths) {
+  return packageData.spine.filter(
+    (item) => !isNonContentSpineItem(packageData, item.path, referencedPaths)
+  ).filter((item) => !referencedPaths.has(item.path)).map((item) => ({
+    title: getFallbackTitle(item.path),
+    path: item.path,
+    fragment: void 0,
+    children: []
+  }));
+}
+function isNonContentSpineItem(packageData, path, referencedPaths) {
+  if (packageData.guideNonContentPaths.has(path)) {
+    return true;
+  }
+  const lowerName = posix.basename(path).toLowerCase();
+  if (packageData.navPath === path) {
+    return true;
+  }
+  return NON_CONTENT_FILE_NAMES.has(lowerName) && !referencedPaths.has(path);
+}
+function collectReferencedPaths(items) {
+  const paths = /* @__PURE__ */ new Set();
+  for (const item of items) {
+    if (item.path !== void 0) {
+      paths.add(item.path);
+    }
+    for (const childPath of collectReferencedPaths(item.children)) {
+      paths.add(childPath);
+    }
+  }
+  return paths;
+}
+function resolveHtmlHref(archive, basePath, href) {
+  if (href === void 0 || href.trim() === "") {
+    return { path: void 0, fragment: void 0 };
+  }
+  const { path, fragment } = splitHref(href);
+  return {
+    path: path === "" ? void 0 : archive.resolveRelativePath(basePath, path),
+    fragment
+  };
+}
+function resolveXmlHref(archive, basePath, href) {
+  if (href === void 0 || href.trim() === "") {
+    return { path: void 0, fragment: void 0 };
+  }
+  const { path, fragment } = splitHref(href);
+  return {
+    path: path === "" ? void 0 : archive.resolveRelativePath(basePath, path),
+    fragment
+  };
+}
+function findFirstHtmlElement(node, predicate) {
+  if (isHtmlElement(node) && predicate(node)) {
+    return node;
+  }
+  for (const child of node.children ?? []) {
+    const found = findFirstHtmlElement(child, predicate);
+    if (found !== void 0) {
+      return found;
+    }
+  }
+  return void 0;
+}
+function findHtmlLabelNode(node) {
+  for (const child of getHtmlElementChildren(node)) {
+    const tagName = getHtmlTagName(child);
+    if (tagName === "a" || tagName === "span") {
+      return child;
+    }
+  }
+  for (const child of getHtmlElementChildren(node)) {
+    if (getHtmlTagName(child) === "ol") {
+      continue;
+    }
+    const nested = findHtmlLabelNode(child);
+    if (nested !== void 0) {
+      return nested;
+    }
+  }
+  return void 0;
+}
+function collectHtmlText(node) {
+  if (node.type === "text") {
+    return node.data ?? "";
+  }
+  return (node.children ?? []).map(collectHtmlText).join("");
+}
+function getHtmlElementChildren(node) {
+  return (node.children ?? []).filter(isHtmlElement);
+}
+function isHtmlElement(node) {
+  return node.type === "tag" || node.type === "script" || node.type === "style";
+}
+function getHtmlTagName(node) {
+  return node.name?.toLowerCase();
+}
+function getFallbackTitle(path) {
+  const stem = basename(path, extname(path)).trim();
+  return stem === "" ? void 0 : stem;
+}
+function normalizeText(text) {
+  const normalized = text.replace(/\s+/gu, " ").trim();
+  return normalized === "" ? void 0 : normalized;
+}
+export {
+  readEpubNavigation
+};
+//# sourceMappingURL=navigation.js.map

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,33 @@
+import { BookMeta } from '../meta.js';
+import { EpubArchive } from './archive.js';
+import 'zod';
+import 'stream';
+import 'yauzl';
+
+interface EpubManifestItem {
+    readonly id: string;
+    readonly path: string;
+    readonly mediaType: string;
+    readonly properties: ReadonlySet<string>;
+}
+interface EpubSpineItem {
+    readonly idref: string;
+    readonly path: string;
+    readonly mediaType: string;
+}
+interface EpubPackageData {
+    readonly version: 2 | 3;
+    readonly opfPath: string;
+    readonly metadata: BookMeta;
+    readonly manifest: ReadonlyMap<string, EpubManifestItem>;
+    readonly manifestByPath: ReadonlyMap<string, EpubManifestItem>;
+    readonly spine: readonly EpubSpineItem[];
+    readonly navPath: string | undefined;
+    readonly ncxPath: string | undefined;
+    readonly coverPath: string | undefined;
+    readonly coverMediaType: string | undefined;
+    readonly guideNonContentPaths: ReadonlySet<string>;
+}
+declare function readEpubPackage(archive: EpubArchive): Promise<EpubPackageData>;
+
+export { type EpubManifestItem, type EpubPackageData, type EpubSpineItem, readEpubPackage };

package/dist/source/epub/package.js

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

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,16 @@
+interface XmlElement {
+    readonly name: string;
+    readonly attributes: Readonly<Record<string, string>>;
+    readonly children: readonly XmlElement[];
+    readonly text: string;
+}
+declare function parseXml(content: string): XmlElement;
+declare function findChild(element: XmlElement, localName: string): XmlElement | undefined;
+declare function findChildren(element: XmlElement, localName: string): readonly XmlElement[];
+declare function findDescendant(element: XmlElement, localName: string): XmlElement | undefined;
+declare function findDescendants(element: XmlElement, localName: string): readonly XmlElement[];
+declare function getAttribute(element: XmlElement, name: string): string | undefined;
+declare function getDescendantText(element: XmlElement): string;
+declare function getLocalName(name: string): string;
+
+export { type XmlElement, findChild, findChildren, findDescendant, findDescendants, getAttribute, getDescendantText, getLocalName, parseXml };