frond-js 0.4.0

package/dist/types-CPUqTEPW.d.cts

@@ -0,0 +1,379 @@
+import { O as OperationOptions } from './types-DQYmArgv.cjs';
+
+/**
+ * 可注入的字节源与资源加载抽象（REQ-CORE-005）。
+ *
+ * 通过实现这些接口，宿主可以接入任意存储后端（内存、OPFS、远端分片、加密容器），
+ * core 无需感知网络与文件系统差异 —— 测试里因此可以注入纯内存实现，
+ * **不触碰网络与文件系统**。
+ *
+ * 本模块属于 `frond-js/core`，**不得依赖 DOM，也不得依赖 render / reader**
+ * （ARCHITECTURE §1 依赖方向单向，H4）。
+ */
+
+/**
+ * 可注入的字节源抽象。
+ *
+ * 实现者必须满足以下契约（`createMemoryBookSource` 是内置参考实现）：
+ *
+ * 1. **区间语义**：`read({ start, end })` 返回覆盖**闭开区间** `[start, end)`
+ *    的字节，长度恒为 `end - start`；`[0, 0)` 是合法输入，返回零长度数组。
+ * 2. **取消（H6 / H7）**：`options.signal` 已 abort 时必须抛 `AbortError`，
+ *    **且不得返回任何字节**。
+ * 3. **关闭后不可读**：`close()` 之后调用 `read` 必须抛 `StateError`
+ *    —— 「已释放」与「读到空数据」是两回事，静默返回空会让缺陷延后暴露。
+ * 4. **区间越界即报错**：越界、起止倒置、非整数一律抛 `FormatError`，
+ *    **不截断、不补齐**（对照 FI-005 的「不静默降级」）。
+ */
+interface BookSource {
+    /** 总字节数；未知时为 `null`。 */
+    readonly size: number | null;
+    /**
+     * 按需读取指定字节区间。
+     *
+     * @param range 闭开区间 `[start, end)`
+     * @param options 取消信号
+     * @throws {AbortError} 操作被取消
+     * @throws {StateError} 源已 `close()`
+     * @throws {FormatError} 区间非法（越界 / 起止倒置 / 非整数）
+     */
+    read(range: {
+        readonly start: number;
+        readonly end: number;
+    }, options?: OperationOptions): Promise<Uint8Array>;
+    /** 释放底层资源。必须幂等（重复调用不抛错）。 */
+    close(): void;
+}
+/**
+ * 书内资源的加载抽象（图片、样式、字体等）。
+ *
+ * 与 {@link BookSource} 的分工：`BookSource` 面向**整本书的字节流**（可按偏移随机读），
+ * `ResourceIO` 面向**书内已定位的资源**（按 `href` 取整块）。
+ *
+ * ## 契约（自 T2.8 起生效）
+ *
+ * 1. **`href` 是归档路径**，不是相对路径、也不是 URL —— 相对引用的解析由渲染层
+ *    按「引用所在文档」完成（`core/archive-path`），实现方拿到的已经是可直接查表的形式。
+ * 2. **取不到时抛 `FormatError`**（不是返回空、也不是 `undefined`）—— 「归档里没有
+ *    这个条目」与「读到了零字节」是两回事，静默返回空会把缺陷延后到「图片不显示」才暴露。
+ *    ⚠️ 与 `ResourceLoader` 的分工正在此处：后者用 `undefined` 表示「没有」，
+ *    适配层负责把 `FormatError` 翻译成 `undefined`（见 `src/reader/reader.ts`）。
+ * 3. **只对内置默认渲染器生效**：调用方自备 `renderer` 时，`Reader` **不**透传 `io`
+ *    —— `Renderer` 契约里没有承载资源来源的位置，「谁渲染、谁负责取资源」。
+ * 4. **只管书内资源，不管章节**：章节是 XML 文本，走归档的 `readText`
+ *    （自带 UTF-8 解码与 BOM 处理），不经过这里。
+ *
+ * 存在的意义是让宿主接远端分片或加密容器（见本模块头部）。
+ */
+interface ResourceIO {
+    /**
+     * 读取指定资源对应的字节。
+     *
+     * @param href **归档路径**（如 `OPS/images/cover.png`）
+     * @param options 取消信号
+     * @throws {AbortError} 操作被取消（H6 / H7）
+     * @throws {FormatError} 归档里没有这个路径
+     */
+    load(href: string, options?: OperationOptions): Promise<Uint8Array>;
+}
+/** {@link createMemoryBookSource} 的选项。 */
+interface MemoryBookSourceOptions {
+    /**
+     * 源标识，**仅用于错误 message**，便于定位是哪个源出的问题
+     * （与 `ParseZipOptions.source` 同口径）。缺省为 `'<anonymous>'`。
+     */
+    readonly source?: string;
+}
+/**
+ * 用一段已有字节造一个内存 {@link BookSource}（REQ-CORE-005 的内置参考实现）。
+ *
+ * 用途：让宿主（尤其**测试**）在不触碰网络与文件系统的前提下注入字节源 ——
+ * REQ-CORE-005 的验收标准「测试中可注入内存 IO，无需网络」正是由它满足。
+ *
+ * 两处刻意的实现选择：
+ *
+ * - **零复制**：`read` 返回 `subarray` 视图而非副本，与 T1.8「`archive` 不复制字节」
+ *   同一口径。代价是调用方修改返回的数组会穿透到底层字节 —— 需要隔离时请自行传入副本。
+ * - **`close()` 有实义**：关闭后 `read` 抛 `StateError`，而不是静默返回空数组。
+ *   「已释放」与「读到空数据」是两回事，静默返回空会让缺陷延后到很难定位的地方。
+ *
+ * @param bytes - 底层字节。**不被复制**，返回的源持有其视图。
+ * @param options - 仅 `source`（错误 message 用的标签）。
+ */
+declare function createMemoryBookSource(bytes: Uint8Array, options?: MemoryBookSourceOptions): BookSource;
+
+/**
+ * 通用书籍模型（`frond-js/core`）。
+ *
+ * 这是**跨格式契约**：EPUB、FB2、CBZ、MOBI 最终都产出同一个 `Book`，
+ * 渲染层与 Reader 只面向本模型编程，不感知格式差异
+ * （ARCHITECTURE §1 / §3.4 的数据流终点）。
+ *
+ * 设计约束：
+ * - **只读**：模型一旦产出即不可变，禁止渲染层反向修改
+ * - **零 DOM、零运行时依赖**（H4 / H12）
+ * - 本文件**只有类型**，不产生运行时代码，因此不计入覆盖率分母
+ */
+/**
+ * 出版元数据。字段口径见 T1.5 决策 + **FI-X38 修订**（2026-09-22）：三个字段**类型上恒为 `string`**
+ * （无来源就给空串，不改成可选）；而「**缺了就拒开**」只适用于该格式既有判据本就要求它的场合 ——
+ * EPUB 的 `dc:identifier`、FB2 的 `document-info/id` 判红不变；MOBI 的 EXTH 104（ISBN）/ 113（ASIN）
+ * 是 **Kindle 产物**、规范不要求 ⇒ 缺失给 `""`（**不再拒开**）；PDF / CBZ 本无标识符来源 ⇒ 恒 `""`。
+ * ⚠️ 三条不变：不拿 PalmDB 名 / 文件名顶替标识符（那是造假不是回退）；`creators` 仍非必填；
+ * `title` 在 MOBI 侧仍要求「EXTH 503 与完整书名至少有一个」。
+ */
+interface BookMetadata {
+    /** `dc:title`。EPUB 3 要求至少一个，取**第一个**。 */
+    readonly title: string;
+    /** 全部 `dc:creator`，按文档顺序。可为空数组（创作者非必填）。 */
+    readonly creators: readonly string[];
+    /** `dc:language`。EPUB 3 要求至少一个，取**第一个**。 */
+    readonly language: string;
+    /** `dc:identifier`（优先取 `unique-identifier` 指向的那条）。 */
+    readonly identifier: string;
+    /**
+     * `dcterms:modified`。
+     *
+     * ⚠️ EPUB 3 规范要求该字段，但真实文件常缺失。缺失**不报错**（T1.5 决策）：
+     * 为合规而拒掉现实中能正常阅读的书，代价高于收益。
+     */
+    readonly modified?: string;
+}
+/** manifest 中的一个资源条目。 */
+interface ManifestItem {
+    /** `id`。在同一个 OPF 内必须唯一。 */
+    readonly id: string;
+    /**
+     * `href`，**已相对 OPF 所在目录规范化**（不含前导 `/`，可直接交给归档读取层）。
+     *
+     * 有意处理：`#` 之后的 fragment 被剥离（manifest href 的 fragment 无意义，
+     * 保留会导致资源读取失败）；**不做**百分号解码（ZIP 条目名本身不编码）。
+     */
+    readonly href: string;
+    /** `media-type`。 */
+    readonly mediaType: string;
+    /**
+     * `properties`，按空白拆分后的数组。
+     *
+     * EPUB 3 的 `nav`、`scripted`、`svg` 等标记在此。EPUB 2 无该属性 → 空数组。
+     */
+    readonly properties: readonly string[];
+}
+/** spine 中的一个阅读顺序项。 */
+interface SpineItem {
+    /** `idref`，指向 manifest 条目。 */
+    readonly idref: string;
+    /** `linear`：`false` 表示 `linear="no"`（辅助内容，如封面、版权页）。默认 `true`。 */
+    readonly linear: boolean;
+    /** 在 spine 中的顺序，从 0 开始。 */
+    readonly index: number;
+    /** 已解析的 manifest 条目。**解析期已校验存在性**，调用方无需再查表。 */
+    readonly item: ManifestItem;
+}
+/**
+ * 目录中的一个条目。
+ *
+ * **跨格式契约**：EPUB（NAV / NCX）、FB2（`<section>` 嵌套标题）、
+ * MOBI（索引）最终都产出同一模型，渲染层与 Reader 只面向它编程。
+ *
+ * 与 {@link ManifestItem} 的关系：两者的 `href` **口径一致** —— 都**不含** fragment。
+ * 目录项多出来的 fragment 单独成字段，因此 `href` 可以直接交给归档读取层，
+ * 调用方不必再判断「这个 href 要不要拆」。这是 T1.6 的取舍：
+ * 拆解在**解析时做一次**，而不是让每个消费方各拆一次。
+ */
+interface TocItem {
+    /** 显示文本。取源文档原文（仅折叠两侧空白）。 */
+    readonly label: string;
+    /**
+     * 目标文档在归档内的路径，**已规范化且不含 fragment**。
+     *
+     * 相对链接按**引用它的文档**（NAV / NCX 文件）所在目录解析。
+     * 该目录通常与 OPF 同目录，此时等价于 {@link Book.basePath}。
+     */
+    readonly href: string;
+    /**
+     * `#` 之后的定位信息，**不含 `#`**。无 fragment（或 fragment 为空串）时该字段不存在。
+     *
+     * 内容可能是元素 id（`"s2"`）、EPUB CFI（`"epubcfi(/6/4!/4/2)"`）—— 本模型**不解释**它，
+     * 交由 CFI 解析（`src/core/cfi/**`）与渲染层按需处理。
+     *
+     * ✅ **MOBI 的两个版本都已收编为元素 id**（MOBI6 见 T3.2b ④，KF8 见 T3.2b ③b）：
+     *
+     * - **MOBI6**：正文是**单个** HTML 文档，目录靠 `guide` 的 `<reference type="toc" filepos=N>`
+     *   指向**目录页**，目录页里的锚点又是 `<a filepos=N>` —— `N` 是**字节**偏移（不是字符下标）。
+     *   `openMobi` 先用 `shiftOffset` 把它换算到改写后的空间，再在目标开标签上**就地**
+     *   注入 `id="mobi-toc-N"`（`src/formats/mobi/anchors.ts`）⇒ 本字段拿到的是**元素 id**。
+     *   落点不是开标签时**保留原字节偏移字符串**（降级，不抛错）⇒ 那一条仍定位不到。
+     * - **KF8**：目录数据来自 **INDX 表**（不是正文超链接）。`parseKf8Toc` 把
+     *   `insertpos + off − skelpos(章)` 换算成全局 `flow[0]` 偏移，再在**重写之前**的章节字节里
+     *   反搜最近的 `id=` / `name=` ⇒ 本字段拿到的是**元素 id**（`src/formats/mobi/kf8toc.ts`）。
+     *   反搜不到时该字段**不写**（而非写空串）。
+     *
+     * ⇒ **消费方不要把 `fragment` 无条件当元素 id 用**：取不到就只是「定位不到」，
+     * 而不是「文档有问题」。形态只剩**两种**（元素 id / CFI 字符串），
+     * 判据是**前缀**（见 `src/reader/navigation.ts` 的 `locationForTocItem`）。
+     */
+    readonly fragment?: string;
+    /** 子条目，按文档顺序。无子项时为空数组。 */
+    readonly children: readonly TocItem[];
+}
+/**
+ * 支持的书籍格式。**`Book` 的判别字段**（T3.0.2 / ADR-0014 新增）。
+ *
+ * 有了它，调用方不必靠「哪些字段是 `undefined`」反推拿到的是什么格式。
+ */
+type BookFormat = 'epub' | 'fb2' | 'mobi' | 'cbz' | 'pdf';
+/**
+ * 书级**阅读方向**（D-7 新增）—— {@link Book.direction} 的取值。
+ *
+ * ## 为什么不含 `'default'`
+ *
+ * EPUB 的 `spine@page-progression-direction` 合法值是 `ltr` / `rtl` / `default`，
+ * 而 `default` 的语义是「**没有声明方向**」。把它收进类型会让每个消费方都要处理
+ * 一个「第三种方向」，而它其实等价于「没有值」⇒ 解析时直接映射为 `undefined`，
+ * 本类型只留两个**真的方向**。
+ *
+ * ## 与 CSS `direction` 的关系
+ *
+ * 消费方把它写成内容文档的 `<html dir="…">`，浏览器据此映射出 CSS `direction`
+ * （`src/render/default/sandbox.ts`）。⚠️ 它是**书的元数据**，与 `paginator.ts`
+ * 从 `getComputedStyle()` 读到的**计算值**是两件事 —— 后者是前者的下游结果。
+ */
+type ReadingDirection = 'ltr' | 'rtl';
+/**
+ * 通用资源条目（跨格式）。
+ *
+ * **EPUB 的 {@link ManifestItem} 是它的超集**（多 `id` 与 `properties`）——
+ * 非 OPF 格式（CBZ 的图片序列、MOBI 的记录表）只需给出「归档内路径 + 媒体类型」。
+ */
+interface ResourceItem {
+    /** 归档内路径，**已规范化**（口径同 {@link ManifestItem.href}）。 */
+    readonly href: string;
+    /** 媒体类型。 */
+    readonly mediaType: string;
+}
+/**
+ * 通用阅读顺序条目（跨格式）。
+ *
+ * **EPUB 的 {@link SpineItem} 是它的超集**（多 `idref` / `index` / 已解析的 `item`）。
+ */
+interface ChapterItem {
+    /** 归档内路径，**已规范化**（口径同 {@link ManifestItem.href}）。 */
+    readonly href: string;
+    /** 媒体类型。 */
+    readonly mediaType: string;
+    /** 是否属主阅读顺序（EPUB 的 `linear="no"` 对应 `false`）。 */
+    readonly linear: boolean;
+}
+/**
+ * 一本已解析的书。
+ *
+ * 数据流（规格 §3）：
+ * `BookInput/BookSource → ZIP → container.xml → OPF → metadata + manifest + spine
+ *  → NAV or NCX → Book + CFI → Renderer → Reader`
+ *
+ * ## 字段分层（T3.0.2 / ADR-0014）
+ *
+ * `Book` 是**跨格式契约**，但字段里混着两套口径，现显式分层：
+ *
+ * | 层            | 字段                                                                   | 非 OPF 格式下的取值             |
+ * | ------------- | ---------------------------------------------------------------------- | ------------------------------- |
+ * | **通用**      | `format` / `metadata` / `resources` / `chapters`                       | **必须有值**                    |
+ * | **通用（可选）** | `direction`                                                          | **不存在**（`undefined`）       |
+ * | **EPUB 专属** | `opfPath` / `basePath`                                                 | **不存在**（`undefined`）       |
+ * | **EPUB 专属** | `manifest` / `spine` / `manifestIndex` / `tocItem` / `ncxPath`         | 空数组 / 空 `Map` / `undefined` |
+ *
+ * ⚠️ **「本格式没有这个概念」≠「解析失败」** —— 前者是**如实为空**，后者抛错。
+ *
+ * ### 可选化的判据：该字段的「没有」**有没有诚实的空值**（T3.2a 定稿）
+ *
+ * - `opfPath` / `basePath`：**没有**。填 `''` 会被读成「OPF 在归档根目录」，
+ *   那是**假信息** —— 非 OPF 格式根本没有 OPF。故改为可选：`undefined`
+ *   表示「本格式没有 OPF 这个概念」，与「解析失败」区分开。
+ * - `manifest` / `spine` / `manifestIndex`：**有**。`[]` / `new Map()` 直白地
+ *   表示「没有条目」，不指认任何具体位置，故保持必填、取空值。
+ *
+ * ⚠️ **`spine` 保持必填**另有一条独立理由：`reader/` 仍有一处读它 ——
+ * `spineIndexFromCfi`，因为 CFI 的 `/6/2n` 描述的就是 **EPUB package 文档内**的
+ * 位置，本就是 OPF 概念（非 OPF 格式收到 CFI 报 `FormatError` 是**诚实**的）。
+ * **导航面（定位 / 翻页）自 T3.2a 起读 `chapters`**（`reader/navigation.ts`），
+ * 非 OPF 格式因此可读 —— 这条由 `tests/reader/navigation.test.ts` 守住。
+ */
+interface Book {
+    /**
+     * 本 `Book` 的来源格式（**判别字段**）。
+     *
+     * **必填**：EPUB 解析器产出 `'epub'`；后续 FB2 / CBZ / MOBI / PDF 适配器各自产出自己的值。
+     */
+    readonly format: BookFormat;
+    readonly metadata: BookMetadata;
+    /**
+     * 通用资源表，按文档顺序。
+     *
+     * EPUB 下由 {@link manifest} **派生** —— 由**同一个函数**产出（ADR-0014 的「单一事实来源」）。
+     */
+    readonly resources: readonly ResourceItem[];
+    /**
+     * 通用阅读顺序，按阅读顺序。
+     *
+     * EPUB 下由 {@link spine} **派生**：`chapters[i].href === spine[i].item.href`
+     * 由单测**逐项断言**守住 —— **不靠约定靠断言**（同 ADR-0008 的「唯一写入点」思路）。
+     */
+    readonly chapters: readonly ChapterItem[];
+    /**
+     * 书级阅读方向（`ltr` / `rtl`）。**未声明时为 `undefined`**（D-7 新增）。
+     *
+     * 唯一来源是 EPUB 的 `spine@page-progression-direction`（`formats/epub/opf.ts`）：
+     * `ltr` / `rtl` 原样取值，`default` 与**任何非法值**都映射为 `undefined`
+     * —— 「非法方向 = 没有方向」，与 `spine@toc` 悬空时 `ncxPath` 置空同一口径
+     * （T1.5 对**可选线索**的处置：不因一个可选线索有瑕疵就拒掉整本能读的书）。
+     *
+     * ⚠️ **它是「书的元数据」，不是「内容文档的排版结果」**：消费方（渲染层）把它写成
+     * `<html dir="…">`，浏览器再据此得出 CSS `direction`。`paginator.ts` 读的是后者
+     * （计算值）—— 两者不在同一层，别把这里的值当成排版事实。
+     *
+     * ⚠️ **竖排（`writing-mode: vertical-rl`）不在本字段的表达范围内**：那是 CSS 的事，
+     * 由书籍自己的样式表声明，`Book` 不解析样式表（详见 `paginator.ts` 的镜像轴说明）。
+     */
+    readonly direction?: ReadingDirection;
+    /**
+     * package document（OPF）在归档内的路径。**非 OPF 格式下不存在**（T3.2a 可选化）。
+     *
+     * ⚠️ **与 `spine` 的取舍相反**（那里刻意保持必填）：`spine` 的「没有」有**诚实的空值**
+     * （空数组，语义是「没有阅读顺序项」）；而 `opfPath` 的「没有」**没有** ——
+     * 填 `''` 会被读成「OPF 在归档根目录」，那是**假信息**。
+     * 因此这里可选：`undefined` 表示「本格式没有 OPF 这个概念」，与「解析失败」区分开。
+     */
+    readonly opfPath?: string;
+    /**
+     * OPF 所在目录，用于解析书内其他相对引用。根目录时为 `''`。
+     *
+     * **非 OPF 格式下不存在**（理由同 {@link opfPath}）。
+     */
+    readonly basePath?: string;
+    /** 全部 manifest 条目，按文档顺序。 */
+    readonly manifest: readonly ManifestItem[];
+    /** 全部 spine 项，按阅读顺序（`index` 递增）。 */
+    readonly spine: readonly SpineItem[];
+    /**
+     * 按 `id` 索引的 manifest，用于 O(1) 查找。
+     *
+     * 键与 {@link manifest} 中的条目一一对应。**重复 id 在解析期即抛错**，
+     * 因此这里不会出现覆盖。
+     */
+    readonly manifestIndex: ReadonlyMap<string, ManifestItem>;
+    /**
+     * EPUB 3 的导航文档条目（manifest 中 `properties` 含 `nav` 者）。
+     *
+     * 仅**识别**，不解析 —— 目录解析属 T1.6。
+     */
+    readonly tocItem?: ManifestItem;
+    /**
+     * EPUB 2 的 NCX 路径（已规范化，相对归档根），来自 `spine@toc`。
+     *
+     * 仅**识别**，不解析 —— 目录解析属 T1.6。
+     */
+    readonly ncxPath?: string;
+}
+
+export { type BookSource as B, type ChapterItem as C, type ManifestItem as M, type ResourceIO as R, type SpineItem as S, type TocItem as T, type Book as a, type BookFormat as b, type BookMetadata as c, type MemoryBookSourceOptions as d, type ReadingDirection as e, type ResourceItem as f, createMemoryBookSource as g };

package/dist/types-DQYmArgv.d.cts

@@ -0,0 +1,17 @@
+/**
+ * core 层的公共类型。
+ *
+ * 本模块属于 `frond-js/core`，**不得依赖 DOM，也不得依赖 render / reader**
+ * （ARCHITECTURE §1 依赖方向单向，H4）。
+ */
+/**
+ * 所有异步 API 的统一选项（H6）。
+ *
+ * 约定（H7）：signal abort 后，操作必须抛出 `AbortError` 并释放已占用的资源。
+ */
+interface OperationOptions {
+    /** 取消信号。 */
+    readonly signal?: AbortSignal;
+}
+
+export type { OperationOptions as O };

package/dist/types-DQYmArgv.d.ts

@@ -0,0 +1,17 @@
+/**
+ * core 层的公共类型。
+ *
+ * 本模块属于 `frond-js/core`，**不得依赖 DOM，也不得依赖 render / reader**
+ * （ARCHITECTURE §1 依赖方向单向，H4）。
+ */
+/**
+ * 所有异步 API 的统一选项（H6）。
+ *
+ * 约定（H7）：signal abort 后，操作必须抛出 `AbortError` 并释放已占用的资源。
+ */
+interface OperationOptions {
+    /** 取消信号。 */
+    readonly signal?: AbortSignal;
+}
+
+export type { OperationOptions as O };

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "frond-js",
+  "version": "0.4.0",
+  "description": "零 DOM 依赖的浏览器端电子书引擎：解析、建模、渲染、阅读",
+  "keywords": [
+    "epub",
+    "ebook",
+    "reader",
+    "epub3",
+    "cfi",
+    "pagination"
+  ],
+  "author": "frond-js contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/eltongu/frond-js.git"
+  },
+  "homepage": "https://gitee.com/eltongu/frond-js",
+  "bugs": {
+    "url": "https://gitee.com/eltongu/frond-js/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "pnpm@11.25.0",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.cjs"
+    },
+    "./render": {
+      "types": "./dist/render/index.d.ts",
+      "import": "./dist/render/index.js",
+      "require": "./dist/render/index.cjs"
+    },
+    "./formats/epub": {
+      "types": "./dist/formats/epub/index.d.ts",
+      "import": "./dist/formats/epub/index.js",
+      "require": "./dist/formats/epub/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.core.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:browser": "vitest run --config vitest.browser.config.ts",
+    "e2e": "node scripts/fixtures/build-large-epub.mjs && node scripts/fixtures/build-large-epub.mjs --chapters=11 --paragraphs-per-chapter=8000 --out=large-11x8000.epub && playwright test",
+    "size": "node scripts/check-size.mjs",
+    "api:check": "node scripts/check-api.mjs && node scripts/check-dom-surface.mjs && node scripts/check-dom-surface.controls.mjs && node scripts/check-dom-surface.mutation.mjs && node scripts/check-api-doc.mjs && node scripts/check-api-doc.controls.mjs && node scripts/check-api-doc.mutation.mjs",
+    "docs:check": "node scripts/check-doc-head-version.controls.mjs && node scripts/probe/table-shape-mutation.mjs && node scripts/probe/surface-map-mutation.mjs && node scripts/probe/roster-gate-mutation.mjs && node scripts/probe/heading-shapes.mjs && node scripts/check-doc-head-version.mjs",
+    "release:check": "node scripts/check-release.controls.mjs && node scripts/check-release.mutation.mjs && node scripts/check-release.mjs",
+    "release:verify-tag": "node scripts/verify-release-tag.controls.mjs && node scripts/verify-release-tag.mjs",
+    "release:diff-surface": "node scripts/diff-surface.controls.mjs && node scripts/diff-surface.mutation.mjs && node scripts/diff-surface.mjs",
+    "api:update": "node scripts/check-api.mjs --update",
+    "serve": "node scripts/serve.mjs",
+    "env:check": "node scripts/env-check.mjs",
+    "gate:local": "node scripts/gate-local.controls.mjs && node scripts/gate-local.mjs",
+    "gate:local:list": "node scripts/gate-local.mjs --list",
+    "verify": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm test:browser && pnpm build && pnpm size && pnpm release:check && pnpm api:check && pnpm docs:check && pnpm e2e",
+    "prepare": "simple-git-hooks"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm lint"
+  },
+  "peerDependencies": {
+    "pdfjs-dist": ">=5.0.375 <7"
+  },
+  "peerDependenciesMeta": {
+    "pdfjs-dist": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@playwright/test": "^1.63.0",
+    "@types/node": "^22.20.2",
+    "@vitest/browser": "5.0.0",
+    "@vitest/browser-playwright": "5.0.0",
+    "@vitest/coverage-v8": "^5.0.0",
+    "eslint": "^10.10.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.12.0",
+    "pdfjs-dist": "6.3.289",
+    "prettier": "^3.9.6",
+    "simple-git-hooks": "^2.14.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.70.0",
+    "vitest": "^5.0.0"
+  }
+}