@d-i-t-a/reader 3.0.0-alpha.19 → 3.0.0-alpha.20

package/dist/types/navigator/types.d.ts

@@ -180,6 +180,18 @@ export interface IFrameAttributes {
         top?: () => Element | null;
         bottom?: () => Element | null;
     };
+    /**
+     * Scroll-mode viewport model. Opt-in.
+     *
+     * - `"host"` (default): iframe grows to its content height and
+     *   `#iframe-wrapper` provides the scrollbar. Existing behaviour.
+     * - `"iframe"`: iframe stays at viewport height and scrolls internally.
+     *   Prevents the feedback loop when injected styles create a 100%
+     *   height chain (e.g. `body { height: 100% }` on cover pages).
+     *
+     * Only affects scroll mode. Paginated and fixed-layout are unchanged.
+     */
+    scrollContainer?: "host" | "iframe";
     /** Margin (in px) around fixed-layout content. Defaults to 100. */
     fixedLayoutMargin?: number;
     /** Whether to show a drop shadow on fixed-layout spreads. Defaults to true. */

package/dist/types/views/ReflowableBookView.d.ts

@@ -34,6 +34,23 @@ export default class ReflowableBookView implements BookView {
     isScrollMode(): boolean;
     getProperty(name: string): Promise<UserProperty | null>;
     getScreenHeight(): number;
+    /**
+     * Which element provides the scrollbar in scroll mode.
+     *
+     * - `"host"` (default): `#iframe-wrapper` scrolls; iframe grows to content.
+     * - `"iframe"`: iframe's own document scrolls; iframe stays at viewport.
+     */
+    private get scrollContainerMode();
+    /** Current scroll offset (px from top) of the active scroll container. */
+    private getScrollOffset;
+    /** Set scroll offset on the active scroll container. */
+    private setScrollOffset;
+    /**
+     * Total scrollable height. Same value in both modes — iframe's internal
+     * document `scrollHeight`, because the iframe's document is always the
+     * source of truth for "how much content is there."
+     */
+    private getScrollExtent;
     setIframeHeight(iframe: any): void;
     protected hasFixedScrollWidth: boolean;
     protected checkForFixedScrollWidth(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d-i-t-a/reader",
-  "version": "3.0.0-alpha.19",
+  "version": "3.0.0-alpha.20",
   "description": "A viewer application for EPUB files.",
   "repository": "https://github.com/d-i-t-a/R2D2BC",
   "license": "Apache-2.0",