@embedpdf-editor/vue3-chapter-viewer 1.0.7-beta.2 → 1.0.7-beta.4

package/dist/index.d.ts

@@ -163,6 +163,10 @@ declare interface ChapterManagerCapability {
      * 索引含上下 buffer（与 layout.items 范围一致），不仅是严格视口内页。
      */
     setVisibleGlobalPages(visiblePageIndices: number[]): void;
+    /** 可见区内是否仍有未 open 的分段（用于滚动侧避免误跳过加载） */
+    visibleRangeNeedsSegmentLoad(visiblePageIndices: number[]): boolean;
+    /** 占位槽是否应显示章级失败（排除仍在排队/加载中的情况） */
+    shouldShowChapterLoadError(chapterId: string, segmentIndex: number): boolean;
     /** 显式触发某章节加载（分段章节仅加载第 0 段） */
     ensureChapterLoaded(chapterId: string): Promise<ChapterLoadStatus>;
     /** 加载章内指定分段 PDF */
@@ -213,7 +217,9 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     private readonly pendingChapterUrlsPromises;
     private unloadTimer;
     private documentManagerUnsubs;
-    private segmentScheduler;
+    /** 可见区驱动的分段加载 backlog（限制并发 open，避免仅缓存 URL 却不请求 PDF） */
+    private visibleSegmentBacklog;
+    private activeVisibleSegmentLoads;
     /** 视口内下一段预取，优先级 = 视口距离 + 该值 */
     private readonly SEG_PRIO_PREFETCH_NEXT;
     /** 相邻章仅预取第 0 段 */
@@ -229,9 +235,17 @@ export declare class ChapterManagerPlugin extends BasePlugin<ChapterManagerPlugi
     private anySegmentOpen;
     private isSegmentDocumentOpen;
     private resolveSegmentDocumentId;
+    private isAnySegmentWorkPending;
     private isSegmentLoadPending;
     private syncChapterStatusFromDocuments;
     private lastVisibleIndicesKey;
+    visibleRangeNeedsSegmentLoad(visibleGlobalPageIndices: number[]): boolean;
+    shouldShowChapterLoadError(chapterId: string, segmentIndex: number): boolean;
+    private clearVisibleSegmentBacklog;
+    /** 按优先级排队并立即 pump，确保在 loadChapterUrls 缓存后会 open PDF */
+    private scheduleVisibleSegmentLoads;
+    private pumpVisibleSegmentBacklog;
+    private prepareChapterForSegmentLoad;
     private handleVisibleChange;
     private collectIdleChapters;
     ensureChapterLoaded(chapterId: string): Promise<ChapterLoadStatus>;