@embedpdf-editor/vue3-chapter-viewer 1.0.9-beta.2 → 1.1.1

package/dist/index.d.ts

@@ -162,7 +162,7 @@ declare interface ChapterManagerCapability {
      * ChapterScroll 在可见区变化时调用，用以驱动按需加载。
      * 索引含上下 buffer（与 layout.items 范围一致），不仅是严格视口内页。
      */
-    setVisibleGlobalPages(visiblePageIndices: number[]): void;
+    setVisibleGlobalPages(visiblePageIndices: number[], options?: SetVisibleGlobalPagesOptions): void;
     /** 可见区内是否仍有未 open 的分段（用于滚动侧避免误跳过加载） */
     visibleRangeNeedsSegmentLoad(visiblePageIndices: number[]): boolean;
     /** 占位槽是否应显示章级失败（排除仍在排队/加载中的情况） */
@@ -221,6 +221,8 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     private documentManagerUnsubs;
     /** 可见区驱动的分段加载 backlog（限制并发 open，避免仅缓存 URL 却不请求 PDF） */
     private visibleSegmentBacklog;
+    /** 最近一次 setVisibleGlobalPages 覆盖的章（含 buffer） */
+    private visibleChapterIds;
     private activeVisibleSegmentLoads;
     constructor(id: string, registry: PluginRegistry);
     initialize(config: ChapterManagerPluginConfig): Promise<void>;
@@ -249,6 +251,8 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     private scheduleVisibleSegmentLoads;
     private pumpVisibleSegmentBacklog;
     private prepareChapterForSegmentLoad;
+    private unloadChaptersOutside;
+    private isChapterVisibleForLoad;
     private handleVisibleChange;
     private collectIdleChapters;
     ensureChapterLoaded(chapterId: string): Promise<ChapterLoadStatus>;
@@ -498,7 +502,7 @@ export declare interface ChapterViewerOptions {
     overlapStrategy?: OverlapOwnerStrategy;
     /** manifest 就绪后预取前 N 章第 0 段；滚动时另会预取视口相邻章。默认 1 */
     prefetchChapters?: number;
-    /** 滚动按需同时 open 的分段 PDF 上限。默认 2 */
+    /** 滚动按需同时 open 的分段 PDF 上限。默认 1 */
     maxConcurrentSegmentLoads?: number;
     /** 章节空闲卸载超时（ms）。默认 120000 */
     unloadTimeoutMs?: number;
@@ -993,6 +997,14 @@ export declare interface SerializableAnnotationTransferItem {
     };
 }
 
+declare interface SetVisibleGlobalPagesOptions {
+    /**
+     * 目录/书签等大跨度跳转：清空旧队列、卸载视口外已 open 章，仅保留目标附近 buffer。
+     * 避免途经章 PDF 继续加载或占用并发槽。
+     */
+    jump?: boolean;
+}
+
 export declare function toChapterTreeNodes(nodes: ChapterTreeInput[]): ChapterTreeNode_2[];
 
 export { useCapability }