@docmentis/udoc-viewer 0.1.0

package/dist/layout/LayoutState.d.ts

@@ -0,0 +1,46 @@
+import type { BandLayout, LayoutResult, SlotLayout } from './LayoutCalculator';
+export type DisplayMode = 'single' | 'scroll';
+export interface ScaledSlotLayout extends SlotLayout {
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+}
+export interface ScaledBandLayout {
+    band: BandLayout;
+    width: number;
+    height: number;
+    slots: ScaledSlotLayout[];
+    colWidths: number[];
+    rowHeights: number[];
+}
+interface SlotLookupEntry {
+    bandIndex: number;
+    slot: ScaledSlotLayout;
+}
+export declare class LayoutState {
+    private layout;
+    private scaledBands;
+    private bandOffsets;
+    private totalHeight;
+    private totalWidth;
+    private slotLookup;
+    private zoom;
+    setLayout(layout: LayoutResult, zoom: number): void;
+    getBandCount(): number;
+    getBand(index: number): ScaledBandLayout | null;
+    getBandOffset(index: number): number;
+    getBandOffsets(): number[];
+    getTotalHeight(): number;
+    getTotalWidth(): number;
+    getBandIndexForPage(pageIndex: number): number;
+    getBandIndexForOffset(offsetY: number): number;
+    getSlotForPage(pageIndex: number): SlotLookupEntry | null;
+    getPageCenter(pageIndex: number): {
+        x: number;
+        y: number;
+    } | null;
+    private rebuildScaled;
+}
+export {};
+//# sourceMappingURL=LayoutState.d.ts.map

package/dist/layout/LayoutState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutState.d.ts","sourceRoot":"","sources":["../../src/layout/LayoutState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,UAAU,eAAe;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CAC1B;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,IAAI,CAAK;IAEjB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMnD,YAAY,IAAI,MAAM;IAItB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI/C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIpC,cAAc,IAAI,MAAM,EAAE;IAI1B,cAAc,IAAI,MAAM;IAIxB,aAAa,IAAI,MAAM;IAIvB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAK9C,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAsB9C,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAIzD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAWjE,OAAO,CAAC,aAAa;CAmCxB"}

package/dist/layout/LayoutState.js

@@ -0,0 +1,109 @@
+export class LayoutState {
+    layout = { bands: [], pageToBand: [] };
+    scaledBands = [];
+    bandOffsets = [];
+    totalHeight = 0;
+    totalWidth = 0;
+    slotLookup = [];
+    zoom = 1;
+    setLayout(layout, zoom) {
+        this.layout = layout;
+        this.zoom = zoom;
+        this.rebuildScaled();
+    }
+    getBandCount() {
+        return this.layout.bands.length;
+    }
+    getBand(index) {
+        return this.scaledBands[index] ?? null;
+    }
+    getBandOffset(index) {
+        return this.bandOffsets[index] ?? 0;
+    }
+    getBandOffsets() {
+        return this.bandOffsets.slice();
+    }
+    getTotalHeight() {
+        return this.totalHeight;
+    }
+    getTotalWidth() {
+        return this.totalWidth;
+    }
+    getBandIndexForPage(pageIndex) {
+        const index = this.layout.pageToBand[pageIndex];
+        return index === undefined || index < 0 ? 0 : index;
+    }
+    getBandIndexForOffset(offsetY) {
+        if (this.scaledBands.length === 0)
+            return 0;
+        if (offsetY <= 0)
+            return 0;
+        if (offsetY >= this.totalHeight)
+            return this.scaledBands.length - 1;
+        let low = 0;
+        let high = this.scaledBands.length - 1;
+        while (low <= high) {
+            const mid = Math.floor((low + high) / 2);
+            const top = this.bandOffsets[mid];
+            const bottom = top + this.scaledBands[mid].height;
+            if (offsetY < top) {
+                high = mid - 1;
+            }
+            else if (offsetY > bottom) {
+                low = mid + 1;
+            }
+            else {
+                return mid;
+            }
+        }
+        return Math.max(0, Math.min(low, this.scaledBands.length - 1));
+    }
+    getSlotForPage(pageIndex) {
+        return this.slotLookup[pageIndex] ?? null;
+    }
+    getPageCenter(pageIndex) {
+        const entry = this.getSlotForPage(pageIndex);
+        if (!entry)
+            return null;
+        const { slot, bandIndex } = entry;
+        const bandTop = this.bandOffsets[bandIndex] ?? 0;
+        return {
+            x: slot.x + slot.width / 2,
+            y: bandTop + slot.y + slot.height / 2,
+        };
+    }
+    rebuildScaled() {
+        this.scaledBands = this.layout.bands.map((band) => {
+            const slots = band.slots.map((slot) => ({
+                ...slot,
+                width: slot.baseWidth * this.zoom,
+                height: slot.baseHeight * this.zoom,
+                x: slot.baseX * this.zoom,
+                y: slot.baseY * this.zoom,
+            }));
+            return {
+                band,
+                width: band.baseWidth * this.zoom,
+                height: band.baseHeight * this.zoom,
+                slots,
+                colWidths: band.colWidths.map((width) => width * this.zoom),
+                rowHeights: band.rowHeights.map((height) => height * this.zoom),
+            };
+        });
+        this.bandOffsets = [];
+        this.totalHeight = 0;
+        this.totalWidth = 0;
+        for (const band of this.scaledBands) {
+            this.bandOffsets.push(this.totalHeight);
+            this.totalHeight += band.height;
+            this.totalWidth = Math.max(this.totalWidth, band.width);
+        }
+        this.slotLookup = new Array(this.layout.pageToBand.length).fill(null);
+        this.scaledBands.forEach((band, bandIndex) => {
+            for (const slot of band.slots) {
+                this.slotLookup[slot.pageIndex] = { bandIndex, slot };
+            }
+        });
+    }
+}
+//# sourceMappingURL=LayoutState.js.map

package/dist/layout/LayoutState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutState.js","sourceRoot":"","sources":["../../src/layout/LayoutState.ts"],"names":[],"mappings":"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"}

package/dist/layout/TransitionCoordinator.d.ts

@@ -0,0 +1,11 @@
+import type { DisplayMode } from './LayoutState';
+export interface BandWindow {
+    start: number;
+    end: number;
+}
+export declare class TransitionCoordinator {
+    private windowRadius;
+    constructor(windowRadius?: number);
+    getWindow(currentBandIndex: number, bandCount: number, displayMode: DisplayMode, previousDisplayMode?: DisplayMode): BandWindow;
+}
+//# sourceMappingURL=TransitionCoordinator.d.ts.map

package/dist/layout/TransitionCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransitionCoordinator.d.ts","sourceRoot":"","sources":["../../src/layout/TransitionCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,GAAE,MAAU;IAIpC,SAAS,CACL,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,WAAW,EACxB,mBAAmB,CAAC,EAAE,WAAW,GAClC,UAAU;CAmBhB"}

package/dist/layout/TransitionCoordinator.js

@@ -0,0 +1,22 @@
+export class TransitionCoordinator {
+    windowRadius;
+    constructor(windowRadius = 2) {
+        this.windowRadius = windowRadius;
+    }
+    getWindow(currentBandIndex, bandCount, displayMode, previousDisplayMode) {
+        if (bandCount <= 0) {
+            return { start: 0, end: 0 };
+        }
+        const clampedCurrent = Math.max(0, Math.min(currentBandIndex, bandCount - 1));
+        if (displayMode === 'single') {
+            return { start: clampedCurrent, end: clampedCurrent };
+        }
+        const radius = previousDisplayMode === 'single'
+            ? Math.max(1, this.windowRadius)
+            : this.windowRadius;
+        const start = Math.max(0, clampedCurrent - radius);
+        const end = Math.min(bandCount - 1, clampedCurrent + radius);
+        return { start, end };
+    }
+}
+//# sourceMappingURL=TransitionCoordinator.js.map

package/dist/layout/TransitionCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransitionCoordinator.js","sourceRoot":"","sources":["../../src/layout/TransitionCoordinator.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,qBAAqB;IACtB,YAAY,CAAS;IAE7B,YAAY,eAAuB,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;IAED,SAAS,CACL,gBAAwB,EACxB,SAAiB,EACjB,WAAwB,EACxB,mBAAiC;QAEjC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QAChC,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;QAE9E,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;QAC1D,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,KAAK,QAAQ;YAC3C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC;YAChC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;QAExB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,CAAC;QAC7D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAC1B,CAAC;CACJ"}

package/dist/layout/index.d.ts

@@ -0,0 +1,7 @@
+export { LayoutCalculator } from './LayoutCalculator';
+export type { PageSize, SlotLayout, BandLayout, LayoutResult, } from './LayoutCalculator';
+export { LayoutState } from './LayoutState';
+export type { ScaledBandLayout, ScaledSlotLayout } from './LayoutState';
+export { BandManager } from './BandManager';
+export type { BandManagerDeps, BandPageCallbacks } from './BandManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/layout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/layout/index.js

@@ -0,0 +1,4 @@
+export { LayoutCalculator } from './LayoutCalculator';
+export { LayoutState } from './LayoutState';
+export { BandManager } from './BandManager';
+//# sourceMappingURL=index.js.map

package/dist/layout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAOtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/rendering/BandManager.d.ts

@@ -0,0 +1,87 @@
+import type { ViewerState } from '../core/ViewerState';
+import type { LayoutState } from '../layout/LayoutState';
+import type { AnnotationLayer } from '../ui/annotation';
+/**
+ * Dependencies required by BandManager.
+ */
+export interface BandManagerDeps {
+    state: ViewerState;
+    layoutState: LayoutState;
+    bandContainer: HTMLDivElement;
+    content: HTMLDivElement;
+    topSpacer: HTMLDivElement;
+    bottomSpacer: HTMLDivElement;
+    annotationLayer: AnnotationLayer;
+    getEffectivePadding: () => number;
+    getEffectiveTotalHeight: () => number;
+    getCurrentBandIndex: () => number;
+}
+/**
+ * Callbacks for page-related operations during band updates.
+ */
+export interface BandPageCallbacks {
+    ensurePageView: (pageIndex: number) => HTMLElement;
+    preparePageRender: (pageIndex: number, width: number, height: number, token: number) => void;
+    getDisplaySize: (pageIndex: number) => {
+        width: number;
+        height: number;
+    };
+    cleanupInactivePages: (activePages: Set<number>) => void;
+}
+/**
+ * Manages band virtualization and DOM rendering.
+ *
+ * Bands are horizontal rows of pages that are rendered into the viewport.
+ * This class handles:
+ * - Creating and updating band DOM elements
+ * - Managing band positioning with pixel-snapping to avoid gaps
+ * - Coordinating with page rendering through callbacks
+ */
+export declare class BandManager {
+    private deps;
+    private callbacks;
+    private bandElements;
+    private isApplyingLayout;
+    constructor(deps: BandManagerDeps, callbacks: BandPageCallbacks);
+    /**
+     * Check if layout is currently being applied.
+     */
+    isApplying(): boolean;
+    /**
+     * Get the band elements map (for external management if needed).
+     */
+    getBandElements(): Map<number, HTMLDivElement>;
+    /**
+     * Clear all band elements.
+     */
+    clearBandElements(): void;
+    /**
+     * Snap a value to device pixel boundaries to eliminate sub-pixel rendering gaps.
+     */
+    private snapToPixel;
+    /**
+     * Get the snapped top position for a band by accumulating snapped heights.
+     * This ensures no gaps between adjacent bands regardless of zoom level.
+     */
+    getSnappedBandTop(bandIndex: number): number;
+    /**
+     * Apply layout to the DOM for the given window of bands.
+     */
+    applyLayoutToDom(window: {
+        start: number;
+        end: number;
+    }, token: number): void;
+    /**
+     * Create a new band element.
+     */
+    private createBandElement;
+    /**
+     * Update a band element with current slot content.
+     */
+    private updateBandElement;
+    /**
+     * Clear the display - reset all band-related DOM elements.
+     */
+    clearDisplay(): void;
+}
+//# sourceMappingURL=BandManager.d.ts.map

package/dist/rendering/BandManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BandManager.d.ts","sourceRoot":"","sources":["../../src/rendering/BandManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,cAAc,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,cAAc,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC,uBAAuB,EAAE,MAAM,MAAM,CAAC;IACtC,mBAAmB,EAAE,MAAM,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,WAAW,CAAC;IACnD,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7F,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,oBAAoB,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;CAC5D;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,gBAAgB,CAAS;gBAErB,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB;IAK/D;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAI9C;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAW5C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgE7E;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2DzB;;OAEG;IACH,YAAY,IAAI,IAAI;CAUvB"}

package/dist/rendering/BandManager.js

@@ -0,0 +1,185 @@
+import { PAGE_GAP_SIZE } from '../core/types';
+/**
+ * Manages band virtualization and DOM rendering.
+ *
+ * Bands are horizontal rows of pages that are rendered into the viewport.
+ * This class handles:
+ * - Creating and updating band DOM elements
+ * - Managing band positioning with pixel-snapping to avoid gaps
+ * - Coordinating with page rendering through callbacks
+ */
+export class BandManager {
+    deps;
+    callbacks;
+    bandElements = new Map();
+    isApplyingLayout = false;
+    constructor(deps, callbacks) {
+        this.deps = deps;
+        this.callbacks = callbacks;
+    }
+    /**
+     * Check if layout is currently being applied.
+     */
+    isApplying() {
+        return this.isApplyingLayout;
+    }
+    /**
+     * Get the band elements map (for external management if needed).
+     */
+    getBandElements() {
+        return this.bandElements;
+    }
+    /**
+     * Clear all band elements.
+     */
+    clearBandElements() {
+        this.bandElements.clear();
+    }
+    /**
+     * Snap a value to device pixel boundaries to eliminate sub-pixel rendering gaps.
+     */
+    snapToPixel(value) {
+        const dpr = globalThis.devicePixelRatio || 1;
+        return Math.round(value * dpr) / dpr;
+    }
+    /**
+     * Get the snapped top position for a band by accumulating snapped heights.
+     * This ensures no gaps between adjacent bands regardless of zoom level.
+     */
+    getSnappedBandTop(bandIndex) {
+        const { state, layoutState } = this.deps;
+        const gap = this.snapToPixel(state.get('seamless') ? 0 : PAGE_GAP_SIZE * state.get('zoom'));
+        let top = 0;
+        for (let i = 0; i < bandIndex; i++) {
+            const band = layoutState.getBand(i);
+            if (band)
+                top += this.snapToPixel(band.height) + gap;
+        }
+        return top;
+    }
+    /**
+     * Apply layout to the DOM for the given window of bands.
+     */
+    applyLayoutToDom(window, token) {
+        const { state, layoutState, bandContainer, content, topSpacer, bottomSpacer, annotationLayer } = this.deps;
+        const bandCount = layoutState.getBandCount();
+        if (bandCount === 0)
+            return;
+        this.isApplyingLayout = true;
+        const gapSize = state.get('seamless') ? 0 : PAGE_GAP_SIZE * state.get('zoom');
+        const snappedGap = this.snapToPixel(gapSize);
+        const currentBandIndex = this.deps.getCurrentBandIndex();
+        const displayMode = state.get('displayMode');
+        const activeWindow = displayMode === 'single'
+            ? { start: currentBandIndex, end: currentBandIndex }
+            : window;
+        let totalHeight = layoutState.getTotalHeight();
+        let totalWidth = layoutState.getTotalWidth();
+        if (displayMode === 'single') {
+            const band = layoutState.getBand(currentBandIndex);
+            if (band) {
+                totalHeight = band.height;
+                totalWidth = band.width;
+            }
+        }
+        else {
+            totalHeight = this.deps.getEffectiveTotalHeight();
+        }
+        const effectivePadding = this.deps.getEffectivePadding();
+        content.style.width = `${Math.max(0, totalWidth) + effectivePadding * 2}px`;
+        content.style.height = `${Math.max(0, totalHeight) + effectivePadding * 2}px`;
+        content.style.padding = `${effectivePadding}px`;
+        topSpacer.style.height = '0px';
+        bottomSpacer.style.height = '0px';
+        bandContainer.style.height = `${Math.max(0, totalHeight)}px`;
+        const fragment = document.createDocumentFragment();
+        const activePages = new Set();
+        // Compute band positions from accumulated snapped heights to eliminate sub-pixel gaps
+        let bandTop = this.getSnappedBandTop(activeWindow.start);
+        for (let i = activeWindow.start; i <= activeWindow.end; i++) {
+            const band = layoutState.getBand(i);
+            if (!band)
+                continue;
+            for (const slot of band.slots) {
+                activePages.add(slot.pageIndex);
+            }
+            const bandEl = this.bandElements.get(i) ?? this.createBandElement(i);
+            bandEl.style.top = displayMode === 'scroll' ? `${bandTop}px` : '0px';
+            this.updateBandElement(bandEl, band, gapSize, token);
+            fragment.appendChild(bandEl);
+            bandTop += this.snapToPixel(band.height) + snappedGap;
+        }
+        bandContainer.replaceChildren(fragment);
+        this.callbacks.cleanupInactivePages(activePages);
+        this.isApplyingLayout = false;
+    }
+    /**
+     * Create a new band element.
+     */
+    createBandElement(bandIndex) {
+        const bandEl = document.createElement('div');
+        bandEl.className = 'udoc-band';
+        bandEl.dataset.bandIndex = String(bandIndex);
+        const inner = document.createElement('div');
+        inner.className = 'udoc-band-inner';
+        bandEl.appendChild(inner);
+        this.bandElements.set(bandIndex, bandEl);
+        return bandEl;
+    }
+    /**
+     * Update a band element with current slot content.
+     */
+    updateBandElement(bandEl, band, gapSize, token) {
+        const inner = bandEl.firstElementChild;
+        if (!inner)
+            return;
+        const { state, annotationLayer } = this.deps;
+        const snappedHeight = this.snapToPixel(band.height);
+        const snappedWidth = this.snapToPixel(band.width);
+        const snappedGap = this.snapToPixel(gapSize);
+        bandEl.style.height = `${snappedHeight}px`;
+        inner.style.width = `${snappedWidth}px`;
+        inner.style.height = `${snappedHeight}px`;
+        inner.style.gridTemplateColumns = band.colWidths.map((w) => `${this.snapToPixel(w)}px`).join(' ');
+        inner.style.gridTemplateRows = band.rowHeights.map((h) => `${this.snapToPixel(h)}px`).join(' ');
+        inner.style.columnGap = `${snappedGap}px`;
+        inner.style.rowGap = `${snappedGap}px`;
+        // Update annotation layer zoom before rendering
+        annotationLayer.setZoom(state.get('zoom'));
+        const fragment = document.createDocumentFragment();
+        for (const slot of band.slots) {
+            const slotEl = document.createElement('div');
+            slotEl.className = 'udoc-slot';
+            slotEl.style.gridColumn = String(slot.col + 1);
+            slotEl.style.gridRow = String(slot.row + 1);
+            // Create a wrapper to hold both the page and annotation overlay
+            const wrapper = document.createElement('div');
+            wrapper.className = 'udoc-page-wrapper';
+            wrapper.style.position = 'relative';
+            wrapper.dataset.pageIndex = String(slot.pageIndex);
+            const viewElement = this.callbacks.ensurePageView(slot.pageIndex);
+            wrapper.appendChild(viewElement);
+            // Render annotations into the wrapper
+            annotationLayer.renderPageAnnotations(wrapper, slot.pageIndex);
+            slotEl.appendChild(wrapper);
+            fragment.appendChild(slotEl);
+            const displaySize = this.callbacks.getDisplaySize(slot.pageIndex);
+            this.callbacks.preparePageRender(slot.pageIndex, displaySize.width || slot.width, displaySize.height || slot.height, token);
+        }
+        inner.replaceChildren(fragment);
+    }
+    /**
+     * Clear the display - reset all band-related DOM elements.
+     */
+    clearDisplay() {
+        const { bandContainer, topSpacer, bottomSpacer, content } = this.deps;
+        this.bandElements.clear();
+        bandContainer.replaceChildren();
+        topSpacer.style.height = '0px';
+        bottomSpacer.style.height = '0px';
+        bandContainer.style.height = '';
+        content.style.width = '';
+        content.style.height = '';
+    }
+}
+//# sourceMappingURL=BandManager.js.map

package/dist/rendering/BandManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BandManager.js","sourceRoot":"","sources":["../../src/rendering/BandManager.ts"],"names":[],"mappings":"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"}

package/dist/rendering/PageCache.d.ts

@@ -0,0 +1,75 @@
+/**
+ * LRU cache for rendered page images.
+ *
+ * Caches rendered page images as blob URLs to avoid re-rendering
+ * when scrolling back to previously viewed pages.
+ */
+import type { CachedPage, PageView } from './types';
+/**
+ * Options for the page cache.
+ */
+export interface PageCacheOptions {
+    /** Maximum number of pages to cache. Set to 0 to disable caching. */
+    maxSize: number;
+    /** Render format - only 'png' supports caching */
+    renderFormat: 'png' | 'rgba';
+}
+/**
+ * LRU cache for rendered page images.
+ */
+export declare class PageCache {
+    private cache;
+    private options;
+    constructor(options: PageCacheOptions);
+    /**
+     * Check if caching is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Update cache options.
+     */
+    setOptions(options: Partial<PageCacheOptions>): void;
+    /**
+     * Store a rendered page in the cache.
+     *
+     * @param pageIndex Page index
+     * @param view Page view with blobUrl to cache
+     * @returns true if stored successfully, false if caching not possible
+     */
+    store(pageIndex: number, view: PageView): boolean;
+    /**
+     * Take a cached page from the cache (removes it from cache).
+     *
+     * @param pageIndex Page index
+     * @param renderWidth Render width to match
+     * @param renderHeight Render height to match
+     * @returns The cached page if found, null otherwise
+     */
+    take(pageIndex: number, renderWidth: number, renderHeight: number): CachedPage | null;
+    /**
+     * Check if a page is cached.
+     *
+     * @param pageIndex Page index
+     * @param renderWidth Render width to match
+     * @param renderHeight Render height to match
+     * @returns true if cached
+     */
+    has(pageIndex: number, renderWidth: number, renderHeight: number): boolean;
+    /**
+     * Clear all cached pages and revoke blob URLs.
+     */
+    clear(): void;
+    /**
+     * Get the number of cached pages.
+     */
+    get size(): number;
+    /**
+     * Trim the cache to the maximum size, removing oldest entries.
+     */
+    private trim;
+    /**
+     * Generate a cache key for a page at a specific render size.
+     */
+    private getKey;
+}
+//# sourceMappingURL=PageCache.d.ts.map

package/dist/rendering/PageCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageCache.d.ts","sourceRoot":"","sources":["../../src/rendering/PageCache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,YAAY,EAAE,KAAK,GAAG,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,EAAE,gBAAgB;IAIrC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAMpD;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO;IAwBjD;;;;;;;OAOG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAWrF;;;;;;;OAOG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAK1E;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;IAcZ;;OAEG;IACH,OAAO,CAAC,MAAM;CAGjB"}