@embedpdf-editor/vue3-chapter-viewer 1.0.2 → 1.0.4

package/README.md

@@ -140,7 +140,8 @@ type ChapterManifest = {
       | { url: string }
       | { buffer: ArrayBuffer }
       | { load: () => Promise<{ url: string } | { buffer: ArrayBuffer }> }
-      | { urls: string[]; segmentPageThreshold: number };
+      | { urls: string[]; segmentPageThreshold: number }; // legacy
+    segmentPageThreshold?: number;
     encrypted?: boolean;
     ownedGlobalPages?: number[];
   }>;
@@ -210,64 +211,40 @@ const options: ChapterViewerOptions = {
 
 ### PDF 加载与预处理
 
-打开章节前，引擎按以下优先级解析 PDF（`ChapterManagerPlugin.resolvePdfPayload`）：
-
-1. `chapter.source.url` / `source.buffer` — 直接使用  
-2. `chapter.source.load()` — **按章**异步预处理，返回 `{ url }` 或 `{ buffer }`  
-3. `chapterPdfLoader.loadPdf(chapter)` — **全局**统一逻辑  
-
-**按章 `source.load`（单章解密、鉴权 URL）：**
-
-```ts
-{
-  chapterId: 'ch-1',
-  title: '第一章',
-  globalPageRange: [1, 10],
-  localPageRange: [0, 9],
-  source: {
-    load: async () => {
-      const bytes = await fetchDecryptedPdf('ch-1');
-      return { buffer: bytes };
-      // 或 return { url: URL.createObjectURL(blob) };
-    },
-  },
-}
-```
-
-**全局 `chapterPdfLoader`（所有章走同一套 API）：**
+与 React 包一致，推荐 **三步 `chapterPdfLoader`**：`loadChapterUrls` → 可选 `openPdf`。  
+`loadChapterUrls` **每章只请求一次**（引擎缓存）；PDF 按段各打开一次。
 
 ```ts
-import type { ChapterViewerOptions, IChapterPdfLoader } from '@embedpdf-editor/vue3-chapter-viewer';
-
-const loader: IChapterPdfLoader = {
-  async loadPdf(chapter, segmentIndex) {
-    const res = await api.getChapterPdf(chapter.chapterId, segmentIndex ?? 0);
-    return { url: res.signedUrl };
-    // 或 return { buffer: await res.arrayBuffer() };
-  },
-};
+import type { ChapterViewerOptions, ChapterPdfLoadContext } from '@embedpdf-editor/vue3-chapter-viewer';
 
 const options: ChapterViewerOptions = {
-  manifest: { chapters: [/* 可省略各条 source */] },
-  chapterPdfLoader: loader,
+  manifest: {
+    chapters: [
+      {
+        chapterId: 'ch-1',
+        title: '第一章',
+        globalPageRange: [1, 13],
+        localPageRange: [0, 12],
+        segmentPageThreshold: 5,
+      },
+    ],
+  },
+  chapterPdfLoader: {
+    async loadChapterUrls(chapter) {
+      const res = await getOneChap(chapter.chapterId);
+      const raw = res.data.resourceUrl;
+      return Array.isArray(raw) ? raw : raw ? [raw] : [];
+    },
+    async openPdf(ctx: ChapterPdfLoadContext) {
+      return { url: ctx.url };
+    },
+  },
   notes: { /* ... */ },
   bookmarks: { /* ... */ },
 };
 ```
 
-### 章内多 PDF 分段（`source.urls[]`）
-
-```ts
-source: {
-  urls: [part0Url, part1Url, part2Url],
-  segmentPageThreshold: 5, // 13 页 → 3 段
-},
-```
-
-- 先加载 `urls[0]`，滚动时懒加载后续段。
-- `localPageIndex` 为章内 0-based 连续页；Vue 侧无需为分段改 `features`。
-- 业务持久化：**`chapterId` + `localPageIndex`**，勿存 `chapterId#sN`。
-- 导出划线会加载全部分段并合并页码。
+静态单文件仍可用 `source.url` / `load()`。兼容 `loadPdf(chapter, segmentIndex)`。
 
 [03-manifest.md](../../docs/get-started/03-manifest.md) · [12-segmented-pdf-and-per-chapter-storage.md](../../docs/get-started/12-segmented-pdf-and-per-chapter-storage.md)
 
@@ -299,7 +276,7 @@ const passwordProvider = new CallbackPasswordProvider(async (chapter, attempt) =
 | `notes` | `enabled`、`marker`（`renderIcon`、`renderMenuActions`、`iconSize`、`highlightColor`） |
 | `zoom` | `enabled`（默认 true）、`min` 0.5、`max` 3、`initial` 1、`pageWidth`；实际上限由 `[data-chapter-scroll-viewport]` 宽度决定，resize 时自动更新 |
 | `scrollViewport` | `background`（默认 `#f1f5f9`），滚动视口背景 |
-| `selectionToolbar` | `enabled`、`hiddenBuiltinActions`（含 `copy`）、`renderCopyIcon`、`extraActions` |
+| `selectionToolbar` | `enabled`、`selectionBackground`（划词底色）、`hiddenBuiltinActions`（含 `copy`）、`renderCopyIcon`、`extraActions` |
 
 默认划线 `offsetY`：`squiggly` 为 **4**。内置工具条顺序：**`copy`** → 划线类 → 扩展 → **`note`**。
 
@@ -417,6 +394,7 @@ import { h } from 'vue';
 
 features: {
   selectionToolbar: {
+    selectionBackground: 'rgba(255, 193, 7, 0.35)',
     // hiddenBuiltinActions: ['copy'],
     renderCopyIcon: () =>
       h('span', { 'aria-hidden': true, style: { fontSize: '18px' } }, '📋'),