flipbookengine 0.3.0 → 0.5.0

package/dist/core/LayoutManager.d.ts

@@ -1,15 +1,33 @@
+import { FlipbookStore } from '../state/store';
+
+/**
+ * @license FlipbookEngine v0.2.4
+ * Copyright (c) 2026 Murat Dogan
+ *
+ * This source code is dual-licensed under the AGPLv3 and a Commercial License.
+ *
+ * 1. Open Source (AGPLv3): You may use, modify, and distribute this software
+ *    under the terms of the GNU Affero General Public License v3.0.
+ *
+ * 2. Commercial License: If you wish to use this software in commercial,
+ *    closed-source, or SaaS products without the AGPLv3 obligations,
+ *    you must purchase a Commercial License from:
+ *    https://flipbookengine.com/pricing
+ */
 export declare class LayoutManager {
     private wrapperElement;
     private sizerElement;
     private pageViewport;
+    private store;
     private resizeObserver;
     private orientationMediaQuery;
+    private orientationChangeHandler;
     private unsubs;
     onResizeCallback?: () => void;
     constructor(pageViewport: {
         width: number;
         height: number;
-    });
+    }, store: FlipbookStore);
     init(wrapperElement: HTMLElement, sizerElement: HTMLElement): void;
     private setupStateSync;
     private setupResizeObserver;

package/dist/core/PdfRenderCache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Small LRU cache for rendered PDF page data URLs.
+ * The cache is intentionally owned by one PdfRenderer instance so pages from
+ * different engine instances or documents can never be mixed.
+ */
+export declare class PdfRenderCache {
+    private readonly maxEntries;
+    private readonly entries;
+    private hits;
+    private misses;
+    constructor(maxEntries?: number);
+    get(pageNumber: number): string | undefined;
+    set(pageNumber: number, dataUrl: string): void;
+    clear(): void;
+    get size(): number;
+    getStats(): {
+        size: number;
+        maxEntries: number;
+        hits: number;
+        misses: number;
+    };
+}

package/dist/core/PdfRenderer.d.ts

@@ -1,34 +1,41 @@
 import { NormalizedFlipbookPage } from '../model/pages';
 
+export interface PdfRenderProgress {
+    completed: number;
+    total: number;
+}
 export interface PdfRenderOptions {
     scale?: number;
     quality?: number;
     format?: string;
+    workerSrc?: string;
+    concurrency?: number;
+    cacheSize?: number;
 }
 export declare class PdfRenderer {
     private pdfDoc;
+    private loadingTask;
     private options;
+    private readonly cache;
     constructor(options?: PdfRenderOptions);
-    /**
-     * Loads the PDF document from the given URL.
-     */
-    loadDocument(pdfUrl: string): Promise<number>;
-    /**
-     * Renders a specific page to a Data URL.
-     * @param pageIndex 1-based page index
-     */
-    renderPageToDataUrl(pageIndex: number): Promise<string>;
-    /**
-     * Calculates the best viewport dimensions based on the first page.
-     * Used for determining the overall flipbook dimensions.
-     */
+    /** Loads a PDF document and cancels PDF.js loading when the signal aborts. */
+    loadDocument(pdfUrl: string, signal?: AbortSignal): Promise<number>;
+    /** Renders a specific page to a Data URL. The page index is 1-based. */
+    renderPageToDataUrl(pageIndex: number, signal?: AbortSignal): Promise<string>;
+    /** Calculates the best viewport dimensions based on the first page. */
     calculateViewportDimensions(baseShortSide?: number): Promise<{
         width: number;
         height: number;
     }>;
-    /**
-     * Renders all pages sequentially and returns an array of NormalizedFlipbookPage.
-     */
-    renderAllPages(): Promise<NormalizedFlipbookPage[]>;
+    /** Renders pages concurrently with a bounded worker pool and preserves page order. */
+    renderAllPages(signal?: AbortSignal, onProgress?: (progress: PdfRenderProgress) => void): Promise<NormalizedFlipbookPage[]>;
+    getCacheStats(): {
+        size: number;
+        maxEntries: number;
+        hits: number;
+        misses: number;
+    };
+    private throwIfAborted;
+    private createAbortError;
     destroy(): void;
 }