@embedpdf-editor/vue3-chapter-viewer 1.0.5 → 1.0.7-beta.1

package/dist/index.d.ts

@@ -158,7 +158,10 @@ declare interface ChapterManagerCapability {
     setManifest(manifest: ChapterManifest, strategy?: OverlapOwnerStrategy): void;
     getManifest(): ChapterManifest;
     getVirtualPageMap(): VirtualPageMap;
-    /** ChapterScrollPlugin 在可见页位变化时调用，用以驱动按需加载 */
+    /**
+     * ChapterScroll 在可见区变化时调用，用以驱动按需加载。
+     * 索引含上下 buffer（与 layout.items 范围一致），不仅是严格视口内页。
+     */
     setVisibleGlobalPages(visiblePageIndices: number[]): void;
     /** 显式触发某章节加载（分段章节仅加载第 0 段） */
     ensureChapterLoaded(chapterId: string): Promise<ChapterLoadStatus>;
@@ -210,6 +213,11 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     private readonly pendingChapterUrlsPromises;
     private unloadTimer;
     private documentManagerUnsubs;
+    private segmentScheduler;
+    /** 视口内下一段预取，优先级 = 视口距离 + 该值 */
+    private readonly SEG_PRIO_PREFETCH_NEXT;
+    /** 相邻章仅预取第 0 段 */
+    private readonly SEG_PRIO_CHAPTER_PREFETCH_BASE;
     constructor(id: string, registry: PluginRegistry);
     initialize(config: ChapterManagerPluginConfig): Promise<void>;
     protected buildCapability(): ChapterManagerCapability;
@@ -218,15 +226,19 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     private eagerPrefetchFromManifest;
     private findChapter;
     private getSegmentPlanForChapter;
+    private anySegmentOpen;
     private isSegmentDocumentOpen;
     private resolveSegmentDocumentId;
     private isSegmentLoadPending;
     private syncChapterStatusFromDocuments;
+    private lastVisibleIndicesKey;
     private handleVisibleChange;
     private collectIdleChapters;
     ensureChapterLoaded(chapterId: string): Promise<ChapterLoadStatus>;
     ensureAllSegmentsLoaded(chapterId: string): Promise<ChapterLoadStatus>;
+    /** 显式加载（跳转/导出等），不走可见区调度队列 */
     ensureSegmentLoaded(chapterId: string, segmentIndex: number): Promise<ChapterLoadStatus>;
+    private loadSegmentNow;
     private ensureSingleDocumentChapter;
     private resolveChapterUrls;
     private openPayloadFromUrl;
@@ -246,6 +258,8 @@ declare interface ChapterManagerPluginConfig extends BasePluginConfig {
     chapterPdfLoader?: IChapterPdfLoader;
     /** 视口前后预取多少章节，默认 1 */
     prefetchChapters?: number;
+    /** 同时 open 的分段 PDF 上限，默认 2（避免多段并行 WASM 卡主线程） */
+    maxConcurrentSegmentLoads?: number;
     /** 章节空闲多久后卸载（毫秒），默认 60s。设为 0 关闭卸载 */
     unloadTimeoutMs?: number;
     /** 第一个加载的章节是否自动设为 active，默认 true */
@@ -545,6 +559,8 @@ export declare interface CreatePdfChapterEditorOptions {
     toolbar?: PdfChapterEditorToolbarConfig;
     /** 传给 chapter-manager；manifest 就绪后预取前 N 章 */
     prefetchChapters?: number;
+    /** 同时 open 的分段 PDF 数，默认 2 */
+    maxConcurrentSegmentLoads?: number;
     /** 为 false 时不拉取 CDN 默认图章库（@embedpdf/default-stamps） */
     loadDefaultStampLibrary?: boolean;
     unloadTimeoutMs?: number;