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

package/dist/index.d.ts

@@ -71,7 +71,7 @@ export declare function buildParagraphBookmarkAnchor(chapterId: string, localPag
 }): ParagraphBookmark['anchor'];
 
 /** 选区浮窗 card 内置操作 */
-declare type BuiltinSelectionToolbarAction = 'highlight' | 'underline' | 'squiggly' | 'strikeout' | 'note';
+declare type BuiltinSelectionToolbarAction = 'copy' | 'highlight' | 'underline' | 'squiggly' | 'strikeout' | 'note';
 
 /**
  * 回调型：把决策交给业务侧异步函数（最常用）。
@@ -155,8 +155,16 @@ declare interface ChapterManagerCapability {
     getVirtualPageMap(): VirtualPageMap;
     /** ChapterScrollPlugin 在可见页位变化时调用，用以驱动按需加载 */
     setVisibleGlobalPages(visiblePageIndices: number[]): void;
-    /** 显式触发某章节加载（如点击章节标题跳转时） */
+    /** 显式触发某章节加载（分段章节仅加载第 0 段） */
     ensureChapterLoaded(chapterId: string): Promise<ChapterLoadStatus>;
+    /** 加载章内指定分段 PDF */
+    ensureSegmentLoaded(chapterId: string, segmentIndex: number): Promise<ChapterLoadStatus>;
+    /** 加载章内全部分段（导出划线等） */
+    ensureAllSegmentsLoaded(chapterId: string): Promise<ChapterLoadStatus>;
+    /** 将章内 localPageIndex 映射为 documentManager 的 documentId + 段内页码 */
+    resolvePageDocument(chapterId: string, localPageIndex: number): ChapterPageDocumentRef | null;
+    getSegmentPlan(chapterId: string): ChapterSegmentPlan | null;
+    isSegmentLoaded(chapterId: string, segmentIndex: number): boolean;
     /** 状态查询 */
     getChapterStatus(chapterId: string): ChapterLoadStatus;
     getChapter(chapterId: string): ChapterDescriptor | null;
@@ -171,10 +179,8 @@ declare interface ChapterManagerCapability {
 /**
  * 章节生命周期管理：以章节为粒度懒加载/预取/卸载 PDF 文件，并屏蔽密码协议细节。
  *
- * 关键不变量：
- * - 每个章节对 DocumentManager 用 `documentId === chapterId`，从而保持 1:1 缓存。
- * - 视觉上的「activeDocumentId」由本插件根据当前可见页位维护；上层无须感知。
- * - 渲染层最终始终通过 `(chapterId, localPageIndex)` 索引到 owner 章节的 PDF 文档。
+ * - 单 URL：`documentId === chapterId`
+ * - 多段 URL：`documentId === chapterId#s{index}`，滚动时按段加载
  */
 export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPluginConfig, ChapterManagerCapability> {
     static readonly id: "chapter-manager";
@@ -186,15 +192,11 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     private manifest;
     private overlapStrategy;
     private virtualPageMap;
-    /** 每个章节当前状态（in-memory；不需要 redux 同步） */
     private readonly chapterStatus;
-    /** 章节最近一次进入视口或被显式请求的时间戳，用于卸载判断 */
     private readonly chapterLastUsed;
-    /** 章节密码累计尝试次数 */
     private readonly passwordAttempts;
-    /** 等待 ensureChapterLoaded 完成的 Promise 列表（按章节去重） */
-    private readonly pendingLoadPromises;
-    /** unload tick 句柄 */
+    private readonly pendingChapterLoadPromises;
+    private readonly pendingSegmentLoadPromises;
     private unloadTimer;
     private documentManagerUnsubs;
     constructor(id: string, registry: PluginRegistry);
@@ -202,16 +204,19 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     protected buildCapability(): ChapterManagerCapability;
     destroy(): void;
     private setManifestInternal;
-    /** manifest 就绪后预取前 N 章（不依赖滚动视口是否已算出可见页） */
     private eagerPrefetchFromManifest;
     private findChapter;
-    private isOwnedChapter;
+    private getSegmentPlanForChapter;
+    private isSegmentDocumentOpen;
+    private syncChapterStatusFromDocuments;
     private handleVisibleChange;
     private collectIdleChapters;
     ensureChapterLoaded(chapterId: string): Promise<ChapterLoadStatus>;
+    ensureAllSegmentsLoaded(chapterId: string): Promise<ChapterLoadStatus>;
+    ensureSegmentLoaded(chapterId: string, segmentIndex: number): Promise<ChapterLoadStatus>;
+    private ensureSingleDocumentChapter;
     private resolvePdfPayload;
-    private startLoad;
-    /** 阻塞等待该章节状态进入 loaded / error / password-required / closed */
+    private startLoadSegment;
     private waitForTerminalStatus;
     private handleDocumentError;
     private closeChapter;
@@ -241,6 +246,11 @@ export declare interface ChapterManifest {
     totalGlobalPages?: number;
 }
 
+declare interface ChapterPageDocumentRef {
+    documentId: string;
+    pageIndex: number;
+}
+
 /**
  * Backend-supplied chapter contract.
  *
@@ -277,6 +287,21 @@ export declare interface ChapterPdfViewerProps {
     viewportClassName?: string;
 }
 
+declare interface ChapterSegmentInfo {
+    index: number;
+    url: string;
+    localPageStart: number;
+    localPageEnd: number;
+    documentId: string;
+}
+
+declare interface ChapterSegmentPlan {
+    chapterId: string;
+    threshold: number;
+    pageCount: number;
+    segments: ChapterSegmentInfo[];
+}
+
 /**
  * 章节 PDF 来源（由业务在 manifest 中提供）：
  * - `url`：直接打开该地址
@@ -291,6 +316,14 @@ export declare type ChapterSource = {
 /** 按章预处理：拉取、解密、转换后返回 url 或 buffer */
 | {
     load: () => Promise<ChapterPdfPayload>;
+}
+/**
+* 章内多 PDF 分段（后端已按段拆分）。
+* `urls.length` 须为 ceil(章页数 / segmentPageThreshold)。
+*/
+| {
+    urls: string[];
+    segmentPageThreshold: number;
 };
 
 declare interface ChapterStatusEvent {
@@ -424,6 +457,9 @@ declare interface ChapterViewerZoomConfig {
     pageWidth?: number;
 }
 
+/** 将划选文本写入系统剪贴板（Clipboard API，失败时回退 execCommand） */
+export declare function copyTextToClipboard(text: string): Promise<boolean>;
+
 /** 生成插件列表 + 规范化后的 features（供 EmbedPDF / PdfChapterViewport 使用） */
 export declare function createChapterViewerBundle(input: ChapterViewerOptions | CreateChapterViewerEditorOptionsInput): {
     plugins: PluginBatchRegistration<any, any, any, any>[];
@@ -555,7 +591,10 @@ declare interface HoverBookmarkUiConfig_2 {
  * 适合：所有章节走同一套 API、在内存中解密后再以 buffer 打开、动态签名 URL 等。
  */
 export declare interface IChapterPdfLoader {
-    loadPdf(chapter: ChapterDescriptor): Promise<ChapterPdfPayload>;
+    /**
+     * @param segmentIndex 章内分段索引；单 URL 章节为 0 或省略
+     */
+    loadPdf(chapter: ChapterDescriptor, segmentIndex?: number): Promise<ChapterPdfPayload>;
 }
 
 /**
@@ -839,6 +878,8 @@ declare interface SelectionToolbarConfig {
     enabled?: boolean;
     /** 隐藏部分内置按钮 */
     hiddenBuiltinActions?: BuiltinSelectionToolbarAction[];
+    /** 自定义复制按钮图标；不提供则使用默认图标 */
+    renderCopyIcon?: () => unknown;
     /** 扩展操作（由宿主在 buildSelectionMenu 或 onExtraAction 中处理） */
     extraActions?: SelectionToolbarExtraAction[];
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,QAAQ,EACR,aAAa,GACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,gCAAgC,EAChC,mCAAmC,EACnC,iCAAiC,EACjC,kCAAkC,EAClC,gBAAgB,EAChB,mCAAmC,EACnC,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,GACrC,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,qCAAqC,EACrC,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,EAC/B,aAAa,EACb,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,QAAQ,EACR,aAAa,GACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,gCAAgC,EAChC,mCAAmC,EACnC,iCAAiC,EACjC,kCAAkC,EAClC,gBAAgB,EAChB,mCAAmC,EACnC,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,GACrC,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,qCAAqC,EACrC,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,EAC/B,aAAa,EACb,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC"}