@embedpdf-editor/vue3-chapter-viewer 1.0.7-beta.3 → 1.0.7-beta.5

package/dist/index.d.ts

@@ -217,11 +217,9 @@ 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;
+    /** 可见区驱动的分段加载 backlog（限制并发 open，避免仅缓存 URL 却不请求 PDF） */
+    private visibleSegmentBacklog;
+    private activeVisibleSegmentLoads;
     constructor(id: string, registry: PluginRegistry);
     initialize(config: ChapterManagerPluginConfig): Promise<void>;
     protected buildCapability(): ChapterManagerCapability;
@@ -239,6 +237,12 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     private lastVisibleIndicesKey;
     visibleRangeNeedsSegmentLoad(visibleGlobalPageIndices: number[]): boolean;
     shouldShowChapterLoadError(chapterId: string, segmentIndex: number): boolean;
+    private clearVisibleSegmentBacklog;
+    /** 分段在整本中的阅读顺序（globalPageIndex 升序 → 按章按段依次 open PDF） */
+    private globalSegmentSortKey;
+    /** 按阅读顺序重建队列并立即 pump（替换旧 backlog，避免末尾多章同时 loading） */
+    private scheduleVisibleSegmentLoads;
+    private pumpVisibleSegmentBacklog;
     private prepareChapterForSegmentLoad;
     private handleVisibleChange;
     private collectIdleChapters;
@@ -487,6 +491,12 @@ export declare interface ChapterViewerOptions {
      * 亦可用 `overlapStrategyForSamePageOwner('first' | 'last')`（chapter-core 包）
      */
     overlapStrategy?: OverlapOwnerStrategy;
+    /** manifest 就绪后预取前 N 章第 0 段；滚动时另会预取视口相邻章。默认 1 */
+    prefetchChapters?: number;
+    /** 滚动按需同时 open 的分段 PDF 上限。默认 2 */
+    maxConcurrentSegmentLoads?: number;
+    /** 章节空闲卸载超时（ms）。默认 120000 */
+    unloadTimeoutMs?: number;
     /** 功能开关与样式；省略则全开 */
     features?: ChapterViewerConfig;
 }