frond-js 0.4.0

package/dist/chunk-EZTIZO6R.cjs

@@ -0,0 +1,430 @@
+'use strict';
+
+var chunkWCZTTQ7Z_cjs = require('./chunk-WCZTTQ7Z.cjs');
+var chunkNABYHI6X_cjs = require('./chunk-NABYHI6X.cjs');
+var chunkSLI2YL25_cjs = require('./chunk-SLI2YL25.cjs');
+var chunkIIV6VIUJ_cjs = require('./chunk-IIV6VIUJ.cjs');
+var chunkG7DLWGBW_cjs = require('./chunk-G7DLWGBW.cjs');
+
+// src/formats/epub/container.ts
+var EPUB_PACKAGE_MEDIA_TYPE = "application/oebps-package+xml";
+var DEFAULT_CONTAINER_PATH = "META-INF/container.xml";
+function formatError(message, source) {
+  return new chunkG7DLWGBW_cjs.FormatError(`${message}\uFF08\u6E90: ${source}\uFF09`);
+}
+function toContainerError(error, source, containerPath) {
+  const detail = error instanceof Error ? error.message : "\u672A\u77E5\u9519\u8BEF";
+  const message = `${detail}\uFF08container: ${containerPath}\uFF0C\u6E90: ${source}\uFF09`;
+  return error instanceof chunkG7DLWGBW_cjs.ParseError ? new chunkG7DLWGBW_cjs.ParseError(message, { cause: error }) : new chunkG7DLWGBW_cjs.FormatError(message, { cause: error });
+}
+async function parseContainer(archive, options = {}) {
+  const containerPath = options.containerPath ?? DEFAULT_CONTAINER_PATH;
+  const source = options.source ?? containerPath;
+  chunkG7DLWGBW_cjs.throwIfAborted(options.signal);
+  let xml;
+  try {
+    xml = await archive.readText(
+      containerPath,
+      options.signal === void 0 ? {} : { signal: options.signal }
+    );
+  } catch (error) {
+    if (chunkG7DLWGBW_cjs.isAbortError(error)) throw error;
+    throw toContainerError(error, source, containerPath);
+  }
+  chunkG7DLWGBW_cjs.throwIfAborted(options.signal);
+  const document = chunkNABYHI6X_cjs.parseXml(xml, { source });
+  for (const rootfile of chunkNABYHI6X_cjs.findAll(document, "rootfile")) {
+    if (chunkNABYHI6X_cjs.getAttribute(rootfile, "media-type") !== EPUB_PACKAGE_MEDIA_TYPE) continue;
+    const rawPath = chunkNABYHI6X_cjs.getAttribute(rootfile, "full-path");
+    if (rawPath === void 0) {
+      throw formatError("rootfile \u7F3A\u5C11 full-path \u5C5E\u6027", source);
+    }
+    return {
+      opfPath: chunkIIV6VIUJ_cjs.resolveArchivePath("", rawPath, {
+        label: "rootfile \u7684 full-path",
+        source
+      }),
+      mediaType: EPUB_PACKAGE_MEDIA_TYPE
+    };
+  }
+  throw formatError(
+    `container \u4E2D\u6CA1\u6709\u53D7\u652F\u6301\u7684 package rootfile\uFF08\u671F\u671B media-type="${EPUB_PACKAGE_MEDIA_TYPE}"\uFF09`,
+    source
+  );
+}
+
+// src/formats/epub/opf.ts
+var PACKAGE_LOCAL_NAME = "package";
+function formatError2(message, source) {
+  return new chunkG7DLWGBW_cjs.FormatError(`${message}\uFF08\u6E90: ${source}\uFF09`);
+}
+function toOpfError(error, source, opfPath) {
+  const detail = error instanceof Error ? error.message : "\u672A\u77E5\u9519\u8BEF";
+  const message = `${detail}\uFF08OPF: ${opfPath}\uFF0C\u6E90: ${source}\uFF09`;
+  return error instanceof chunkG7DLWGBW_cjs.ParseError ? new chunkG7DLWGBW_cjs.ParseError(message, { cause: error }) : new chunkG7DLWGBW_cjs.FormatError(message, { cause: error });
+}
+function textOf(element) {
+  return chunkNABYHI6X_cjs.getText(element).trim();
+}
+function firstNonEmptyText(root, localName) {
+  for (const element of chunkNABYHI6X_cjs.findAll(root, localName)) {
+    const text = textOf(element);
+    if (text !== "") return text;
+  }
+  return void 0;
+}
+function stripFragment(href) {
+  const index = href.indexOf("#");
+  return index === -1 ? href : href.slice(0, index);
+}
+function resolveIdentifier(metadataElement, packageElement, source) {
+  const identifiers = chunkNABYHI6X_cjs.findAll(metadataElement, "identifier");
+  if (identifiers.length === 0) {
+    throw formatError2("\u7F3A\u5C11\u5FC5\u9700\u7684 dc:identifier", source);
+  }
+  const uniqueId = chunkNABYHI6X_cjs.getAttribute(packageElement, "unique-identifier");
+  if (uniqueId !== void 0 && uniqueId !== "") {
+    const matched = identifiers.find((element) => chunkNABYHI6X_cjs.getAttribute(element, "id") === uniqueId);
+    if (matched === void 0) {
+      throw formatError2(
+        `package@unique-identifier \u6307\u5411\u4E0D\u5B58\u5728\u7684 dc:identifier\uFF08id="${uniqueId}"\uFF09`,
+        source
+      );
+    }
+    const text = textOf(matched);
+    if (text === "") {
+      throw formatError2(`dc:identifier\uFF08id="${uniqueId}"\uFF09\u4E3A\u7A7A`, source);
+    }
+    return text;
+  }
+  const fallback = identifiers.map(textOf).find((text) => text !== "");
+  if (fallback === void 0) {
+    throw formatError2("\u7F3A\u5C11\u5FC5\u9700\u7684 dc:identifier", source);
+  }
+  return fallback;
+}
+function resolveModified(metadataElement) {
+  for (const element of chunkNABYHI6X_cjs.findAll(metadataElement, "meta")) {
+    if (chunkNABYHI6X_cjs.getAttribute(element, "property") !== "dcterms:modified") continue;
+    const text = textOf(element);
+    if (text !== "") return text;
+  }
+  return void 0;
+}
+function buildMetadata(metadataElement, packageElement, source) {
+  const title = firstNonEmptyText(metadataElement, "title");
+  if (title === void 0) {
+    throw formatError2("\u7F3A\u5C11\u5FC5\u9700\u7684 dc:title", source);
+  }
+  const language = firstNonEmptyText(metadataElement, "language");
+  if (language === void 0) {
+    throw formatError2("\u7F3A\u5C11\u5FC5\u9700\u7684 dc:language", source);
+  }
+  const creators = chunkNABYHI6X_cjs.findAll(metadataElement, "creator").map(textOf).filter((text) => text !== "");
+  const identifier = resolveIdentifier(metadataElement, packageElement, source);
+  const modified = resolveModified(metadataElement);
+  return {
+    title,
+    creators,
+    language,
+    identifier,
+    ...modified === void 0 ? {} : { modified }
+  };
+}
+function buildManifest(manifestElement, basePath, source, signal) {
+  const items = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  for (const element of chunkNABYHI6X_cjs.findAll(manifestElement, "item")) {
+    chunkG7DLWGBW_cjs.throwIfAborted(signal);
+    const id = chunkNABYHI6X_cjs.getAttribute(element, "id");
+    if (id === void 0 || id === "") {
+      throw formatError2("manifest \u7684 <item> \u7F3A\u5C11 id \u5C5E\u6027", source);
+    }
+    if (seenIds.has(id)) {
+      throw formatError2(`manifest \u4E2D\u5B58\u5728\u91CD\u590D id="${id}"`, source);
+    }
+    seenIds.add(id);
+    const rawHref = chunkNABYHI6X_cjs.getAttribute(element, "href");
+    if (rawHref === void 0 || rawHref === "") {
+      throw formatError2(`manifest item "${id}" \u7F3A\u5C11 href \u5C5E\u6027`, source);
+    }
+    const mediaType = chunkNABYHI6X_cjs.getAttribute(element, "media-type");
+    if (mediaType === void 0 || mediaType === "") {
+      throw formatError2(`manifest item "${id}" \u7F3A\u5C11 media-type \u5C5E\u6027`, source);
+    }
+    const properties = (chunkNABYHI6X_cjs.getAttribute(element, "properties") ?? "").split(/\s+/).filter((property) => property !== "");
+    const href = chunkIIV6VIUJ_cjs.resolveArchivePath(basePath, stripFragment(rawHref), {
+      label: `manifest item "${id}" \u7684 href`,
+      source
+    });
+    items.push({ id, href, mediaType, properties });
+  }
+  return items;
+}
+function buildSpine(spineElement, manifestIndex, source, signal) {
+  const spine = [];
+  let index = 0;
+  for (const element of chunkNABYHI6X_cjs.findAll(spineElement, "itemref")) {
+    chunkG7DLWGBW_cjs.throwIfAborted(signal);
+    const idref = chunkNABYHI6X_cjs.getAttribute(element, "idref");
+    if (idref === void 0 || idref === "") {
+      throw formatError2("spine \u7684 <itemref> \u7F3A\u5C11 idref \u5C5E\u6027", source);
+    }
+    const item = manifestIndex.get(idref);
+    if (item === void 0) {
+      throw formatError2(`spine \u7684 <itemref> \u5F15\u7528\u4E86\u4E0D\u5B58\u5728\u7684 manifest id="${idref}"`, source);
+    }
+    const linear = chunkNABYHI6X_cjs.getAttribute(element, "linear") !== "no";
+    spine.push({ idref, linear, index, item });
+    index += 1;
+  }
+  return spine;
+}
+function resolveNcxPath(spineElement, manifestIndex) {
+  const tocId = chunkNABYHI6X_cjs.getAttribute(spineElement, "toc");
+  if (tocId === void 0 || tocId === "") return void 0;
+  return manifestIndex.get(tocId)?.href;
+}
+function resolveDirection(spineElement) {
+  const raw = chunkNABYHI6X_cjs.getAttribute(spineElement, "page-progression-direction")?.trim().toLowerCase();
+  return raw === "ltr" || raw === "rtl" ? raw : void 0;
+}
+function buildBook(document, opfPath, source, signal) {
+  if (document.localName !== PACKAGE_LOCAL_NAME) {
+    throw formatError2(`OPF \u6839\u5143\u7D20\u5E94\u4E3A <package>\uFF0C\u5B9E\u9645\u4E3A <${document.name}>`, source);
+  }
+  const metadataElement = chunkNABYHI6X_cjs.findFirst(document, "metadata");
+  if (metadataElement === void 0) {
+    throw formatError2("\u7F3A\u5C11 <metadata> \u5143\u7D20", source);
+  }
+  const manifestElement = chunkNABYHI6X_cjs.findFirst(document, "manifest");
+  if (manifestElement === void 0) {
+    throw formatError2("\u7F3A\u5C11 <manifest> \u5143\u7D20", source);
+  }
+  const spineElement = chunkNABYHI6X_cjs.findFirst(document, "spine");
+  if (spineElement === void 0) {
+    throw formatError2("\u7F3A\u5C11 <spine> \u5143\u7D20", source);
+  }
+  const basePath = chunkIIV6VIUJ_cjs.directoryOf(opfPath);
+  const metadata = buildMetadata(metadataElement, document, source);
+  const manifest = buildManifest(manifestElement, basePath, source, signal);
+  const manifestIndex = new Map(manifest.map((item) => [item.id, item]));
+  const spine = buildSpine(spineElement, manifestIndex, source, signal);
+  const ncxPath = resolveNcxPath(spineElement, manifestIndex);
+  const direction = resolveDirection(spineElement);
+  const tocItem = manifest.find((item) => item.properties.includes("nav"));
+  const resources = manifest.map(({ href, mediaType }) => ({ href, mediaType }));
+  const chapters = spine.map(({ item, linear }) => ({
+    href: item.href,
+    mediaType: item.mediaType,
+    linear
+  }));
+  return {
+    format: "epub",
+    metadata,
+    resources,
+    chapters,
+    opfPath,
+    basePath,
+    manifest,
+    spine,
+    manifestIndex,
+    // exactOptionalPropertyTypes：可选字段不能显式传 `undefined`。
+    ...tocItem === void 0 ? {} : { tocItem },
+    ...ncxPath === void 0 ? {} : { ncxPath },
+    // 同上。`direction` 在「缺省 / `default` / 非法值」三种情况下都缺席（见 `resolveDirection`）。
+    ...direction === void 0 ? {} : { direction }
+  };
+}
+async function parseOpf(archive, opfPath, options = {}) {
+  const source = options.source ?? opfPath;
+  chunkG7DLWGBW_cjs.throwIfAborted(options.signal);
+  let xml;
+  try {
+    xml = await archive.readText(
+      opfPath,
+      options.signal === void 0 ? {} : { signal: options.signal }
+    );
+  } catch (error) {
+    if (chunkG7DLWGBW_cjs.isAbortError(error)) throw error;
+    throw toOpfError(error, source, opfPath);
+  }
+  chunkG7DLWGBW_cjs.throwIfAborted(options.signal);
+  const document = chunkNABYHI6X_cjs.parseXml(xml, { source });
+  return buildBook(document, opfPath, source, options.signal);
+}
+
+// src/formats/epub/nav.ts
+function formatError3(message, source) {
+  return new chunkG7DLWGBW_cjs.FormatError(`${message}\uFF08\u6E90: ${source}\uFF09`);
+}
+function toTocError(error, source, documentPath) {
+  const detail = error instanceof Error ? error.message : "\u672A\u77E5\u9519\u8BEF";
+  const message = `${detail}\uFF08\u76EE\u5F55: ${documentPath}\uFF0C\u6E90: ${source}\uFF09`;
+  return error instanceof chunkG7DLWGBW_cjs.ParseError ? new chunkG7DLWGBW_cjs.ParseError(message, { cause: error }) : new chunkG7DLWGBW_cjs.FormatError(message, { cause: error });
+}
+function directChildren(element, localName) {
+  const matched = [];
+  for (const child of element.children) {
+    if (child.type !== "element") continue;
+    if (child.localName === localName) matched.push(child);
+  }
+  return matched;
+}
+function firstDirectChild(element, localName) {
+  for (const child of element.children) {
+    if (child.type === "element" && child.localName === localName) return child;
+  }
+  return void 0;
+}
+function typeTokens(element) {
+  for (const [name, value] of element.attributes) {
+    if (name === "epub:type" || name.endsWith(":type")) {
+      return value.split(/\s+/).filter((token) => token !== "");
+    }
+  }
+  return [];
+}
+function textOf2(element) {
+  return chunkNABYHI6X_cjs.getText(element).trim();
+}
+function splitReference(raw) {
+  const index = raw.indexOf("#");
+  if (index === -1) return { path: raw };
+  const fragment = raw.slice(index + 1);
+  return { path: raw.slice(0, index), ...fragment === "" ? {} : { fragment } };
+}
+function resolveTarget(raw, context, label) {
+  const { path, fragment } = splitReference(raw);
+  const href = path === "" ? context.documentPath : chunkIIV6VIUJ_cjs.resolveArchivePath(chunkIIV6VIUJ_cjs.directoryOf(context.documentPath), path, {
+    label,
+    source: context.source
+  });
+  return { href, ...fragment === void 0 ? {} : { fragment } };
+}
+function buildItem(label, target, children) {
+  return {
+    label,
+    href: target.href,
+    ...target.fragment === void 0 ? {} : { fragment: target.fragment },
+    children
+  };
+}
+function selectTocNav(document) {
+  const navs = chunkNABYHI6X_cjs.findAll(document, "nav");
+  if (navs.length === 0) return void 0;
+  return navs.find((nav) => typeTokens(nav).includes("toc")) ?? navs[0];
+}
+function parseNavList(olElement, context) {
+  const items = [];
+  for (const li of directChildren(olElement, "li")) {
+    chunkG7DLWGBW_cjs.throwIfAborted(context.signal);
+    items.push(parseNavItem(li, context));
+  }
+  return items;
+}
+function parseNavItem(li, context) {
+  const anchor = firstDirectChild(li, "a");
+  if (anchor === void 0) {
+    const span = firstDirectChild(li, "span");
+    throw formatError3(
+      span === void 0 ? "\u76EE\u5F55\u9879\u7684 <li> \u5185\u7F3A\u5C11 <a> \u5143\u7D20" : "\u76EE\u5F55\u9879\u53EA\u6709 <span>\uFF08\u65E0\u76EE\u6807\u94FE\u63A5\uFF09\uFF0C\u672C\u5B9E\u73B0\u8981\u6C42\u76EE\u5F55\u9879\u5FC5\u987B\u6307\u5411\u5177\u4F53\u6587\u6863",
+      context.source
+    );
+  }
+  const label = textOf2(anchor);
+  const rawHref = chunkNABYHI6X_cjs.getAttribute(anchor, "href");
+  if (rawHref === void 0 || rawHref === "") {
+    throw formatError3(`\u76EE\u5F55\u9879\u7684 <a> \u7F3A\u5C11 href \u5C5E\u6027\uFF08label: "${label}"\uFF09`, context.source);
+  }
+  const target = resolveTarget(rawHref, context, `\u76EE\u5F55\u9879 "${label}" \u7684 href`);
+  const children = [];
+  for (const nested of directChildren(li, "ol")) {
+    children.push(...parseNavList(nested, context));
+  }
+  return buildItem(label, target, children);
+}
+function parseNavDocument(document, context) {
+  const nav = selectTocNav(document);
+  if (nav === void 0) return [];
+  const items = [];
+  for (const ol of directChildren(nav, "ol")) {
+    items.push(...parseNavList(ol, context));
+  }
+  return items;
+}
+function parseNcxPoints(points, context) {
+  const items = [];
+  for (const point of points) {
+    chunkG7DLWGBW_cjs.throwIfAborted(context.signal);
+    const labelElement = firstDirectChild(point, "navLabel");
+    const label = labelElement === void 0 ? "" : textOf2(labelElement);
+    const content = firstDirectChild(point, "content");
+    const rawSrc = content === void 0 ? void 0 : chunkNABYHI6X_cjs.getAttribute(content, "src");
+    if (rawSrc === void 0 || rawSrc === "") {
+      throw formatError3(`navPoint \u7F3A\u5C11 content@src\uFF08label: "${label}"\uFF09`, context.source);
+    }
+    const target = resolveTarget(rawSrc, context, `navPoint "${label}" \u7684 content@src`);
+    const children = parseNcxPoints(directChildren(point, "navPoint"), context);
+    items.push(buildItem(label, target, children));
+  }
+  return items;
+}
+function parseNcxDocument(document, context) {
+  const navMap = firstDirectChild(document, "navMap");
+  if (navMap === void 0) return [];
+  return parseNcxPoints(directChildren(navMap, "navPoint"), context);
+}
+async function readAndParse(archive, documentPath, context, parse) {
+  chunkG7DLWGBW_cjs.throwIfAborted(context.signal);
+  let xml;
+  try {
+    xml = await archive.readText(
+      documentPath,
+      context.signal === void 0 ? {} : { signal: context.signal }
+    );
+  } catch (error) {
+    if (chunkG7DLWGBW_cjs.isAbortError(error)) throw error;
+    throw toTocError(error, context.source, documentPath);
+  }
+  chunkG7DLWGBW_cjs.throwIfAborted(context.signal);
+  return parse(chunkNABYHI6X_cjs.parseXml(xml, { source: context.source }), context);
+}
+async function parseToc(archive, book, options = {}) {
+  const navItem = book.tocItem;
+  if (navItem !== void 0) {
+    const context = {
+      documentPath: navItem.href,
+      source: options.source ?? navItem.href,
+      signal: options.signal
+    };
+    return readAndParse(archive, navItem.href, context, parseNavDocument);
+  }
+  const ncxPath = book.ncxPath;
+  if (ncxPath !== void 0) {
+    const context = {
+      documentPath: ncxPath,
+      source: options.source ?? ncxPath,
+      signal: options.signal
+    };
+    return readAndParse(archive, ncxPath, context, parseNcxDocument);
+  }
+  chunkG7DLWGBW_cjs.throwIfAborted(options.signal);
+  return [];
+}
+
+// src/formats/epub/open.ts
+async function openBook(source, options = {}) {
+  chunkG7DLWGBW_cjs.throwIfAborted(options.signal);
+  const bytes = await chunkWCZTTQ7Z_cjs.resolveBookBytes(source, options);
+  const archive = chunkSLI2YL25_cjs.parseZip(bytes, options);
+  const container = await parseContainer(archive, options);
+  const book = await parseOpf(archive, container.opfPath, options);
+  const toc = await parseToc(archive, book, options);
+  return { archive, book, toc };
+}
+
+exports.openBook = openBook;
+exports.parseContainer = parseContainer;
+exports.parseOpf = parseOpf;
+exports.parseToc = parseToc;

package/dist/chunk-G7DLWGBW.cjs

@@ -0,0 +1,103 @@
+'use strict';
+
+// src/errors.ts
+var FrondError = class extends Error {
+  /** 稳定错误码，用于程序化分支。 */
+  code;
+  constructor(code, message, options) {
+    super(message);
+    this.name = "FrondError";
+    this.code = code;
+    if (options?.cause !== void 0) {
+      this.cause = options.cause;
+    }
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ParseError = class extends FrondError {
+  constructor(message, options) {
+    super("ERR_PARSE", message, options);
+    this.name = "ParseError";
+  }
+};
+var FormatError = class extends FrondError {
+  constructor(message, options) {
+    super("ERR_FORMAT", message, options);
+    this.name = "FormatError";
+  }
+};
+var NetworkError = class extends FrondError {
+  constructor(message, options) {
+    super("ERR_NETWORK", message, options);
+    this.name = "NetworkError";
+  }
+};
+var SecurityError = class extends FrondError {
+  constructor(message, options) {
+    super("ERR_SECURITY", message, options);
+    this.name = "SecurityError";
+  }
+};
+var AbortError = class extends FrondError {
+  constructor(message = "\u64CD\u4F5C\u5DF2\u53D6\u6D88", options) {
+    super("ERR_ABORT", message, options);
+    this.name = "AbortError";
+  }
+};
+var StateError = class extends FrondError {
+  constructor(message, options) {
+    super("ERR_STATE", message, options);
+    this.name = "StateError";
+  }
+};
+function isFrondError(value) {
+  return value instanceof FrondError;
+}
+function isAbortError(value) {
+  if (value instanceof AbortError) return true;
+  return value instanceof Error && value.name === "AbortError";
+}
+
+// src/core/abort.ts
+function createAbortError(reason) {
+  const message = reason instanceof Error && reason.message !== "" ? reason.message : "\u64CD\u4F5C\u5DF2\u53D6\u6D88";
+  return new AbortError(message, reason === void 0 ? void 0 : { cause: reason });
+}
+function throwIfAborted(signal) {
+  if (signal === void 0 || !signal.aborted) return;
+  throw createAbortError(signal.reason);
+}
+function linkSignals(...signals) {
+  const active = signals.filter((signal) => signal !== void 0);
+  if (active.length === 0) return void 0;
+  if (active.length === 1) return active[0];
+  return AbortSignal.any(active);
+}
+function onAbort(signal, handler) {
+  if (signal === void 0) return () => void 0;
+  if (signal.aborted) {
+    handler();
+    return () => void 0;
+  }
+  const listener = () => {
+    handler();
+  };
+  signal.addEventListener("abort", listener, { once: true });
+  return () => {
+    signal.removeEventListener("abort", listener);
+  };
+}
+
+exports.AbortError = AbortError;
+exports.FormatError = FormatError;
+exports.FrondError = FrondError;
+exports.NetworkError = NetworkError;
+exports.ParseError = ParseError;
+exports.SecurityError = SecurityError;
+exports.StateError = StateError;
+exports.createAbortError = createAbortError;
+exports.isAbortError = isAbortError;
+exports.isFrondError = isFrondError;
+exports.linkSignals = linkSignals;
+exports.onAbort = onAbort;
+exports.throwIfAborted = throwIfAborted;