@readium/navigator-html-injectables 2.3.1-alpha.2 → 2.4.0-beta.1

package/src/protection/BulkCopyProtector.ts

@@ -1,4 +1,4 @@
-import { ReadiumWindow } from "../helpers/dom";
+import { ReadiumWindow } from "../helpers/dom.ts";
 
 interface CopyAttempt {
     timestamp: number;
@@ -33,7 +33,7 @@ export class BulkCopyProtector {
         this.copyHistory = this.copyHistory.filter(
             attempt => now - attempt.timestamp < historyWindow
         );
-        
+
         // Trim to max history size
         if (this.copyHistory.length > this.options.historySize) {
             this.copyHistory = this.copyHistory.slice(-this.options.historySize);
@@ -42,17 +42,17 @@ export class BulkCopyProtector {
 
     private isSuspiciousPattern(now: number): boolean {
         if (this.copyHistory.length < 3) return false;
-        
+
         // Check for rapid successive copy attempts
         const recentAttempts = this.copyHistory.filter(
             attempt => now - attempt.timestamp < 2000 // Last 2 seconds
         );
-        
+
         if (recentAttempts.length >= 3) {
             // If multiple rapid copy attempts, it's suspicious
             return true;
         }
-        
+
         // Check for increasing selection sizes (bulk copy pattern)
         const increasingSelections = this.copyHistory
             .slice()
@@ -61,7 +61,7 @@ export class BulkCopyProtector {
                 if (i === 0) return true;
                 return attempt.length > arr[i - 1].length * 1.5; // Each selection is significantly larger
             });
-            
+
         return increasingSelections;
     }
 
@@ -70,7 +70,7 @@ export class BulkCopyProtector {
 
         const selection = this.window.getSelection();
         if (!selection) return true;
-        
+
         const selectedText = selection.toString();
         const selectedLength = selectedText.length;
         const docLength = this.window.document.body.innerText.length;
@@ -90,12 +90,12 @@ export class BulkCopyProtector {
         }
 
         const timeSinceLastSelection = now - this.lastSelectionTime;
-        
+
         // Check for rapid successive selections
-        const isRapidSelection = 
-            timeSinceLastSelection < 100 && 
+        const isRapidSelection =
+            timeSinceLastSelection < 100 &&
             selectedLength > this.lastSelectionLength * 1.5;
-            
+
         const maxAllowedSelection = Math.min(
             docLength * this.options.maxSelectionPercent,
             this.options.absoluteMaxChars
@@ -103,9 +103,9 @@ export class BulkCopyProtector {
 
         // Check if this matches a suspicious pattern
         const isSuspicious = this.isSuspiciousPattern(now);
-        
-        const shouldBlock = selectedLength > maxAllowedSelection || 
-                          isRapidSelection || 
+
+        const shouldBlock = selectedLength > maxAllowedSelection ||
+                          isRapidSelection ||
                           isSuspicious;
 
         // Record this attempt in history
@@ -119,7 +119,7 @@ export class BulkCopyProtector {
             event?.preventDefault();
             return false;
         }
-        
+
         this.lastSelectionLength = selectedLength;
         this.lastSelectionTime = now;
         return true;

package/src/protection/KeyCombinationManager.ts

@@ -1,6 +1,6 @@
-import { KeyCombo, KeyboardPeripheral } from "./KeyboardCombinations";
-import { BaseKeyboardPeripheralEvent, KeyboardEventData, BasicTextSelection } from "../modules/Peripherals";
-import { ReadiumWindow } from "../helpers/dom";
+import { KeyCombo, KeyboardPeripheral } from "./KeyboardCombinations.ts";
+import { BaseKeyboardPeripheralEvent, KeyboardEventData, BasicTextSelection } from "../modules/Peripherals.ts";
+import { ReadiumWindow } from "../helpers/dom.ts";
 
 export type KeyHandler = (event: KeyboardEvent) => void;
 export type ActivityEventDispatcher = (event: KeyboardPeripheralEvent) => void;
@@ -24,7 +24,7 @@ export class KeyCombinationManager {
             const shiftMatch = combo.shift === undefined || event.shiftKey === combo.shift;
             const altMatch = combo.alt === undefined || event.altKey === combo.alt;
             const metaMatch = combo.meta === undefined || event.metaKey === combo.meta;
-            
+
             if (keyMatch && ctrlMatch && shiftMatch && altMatch && metaMatch) {
                 return true;
             }
@@ -49,7 +49,7 @@ export class KeyCombinationManager {
      * Creates a standardized activity event for keyboard shortcuts
      */
     private createActivityEvent(
-        event: KeyboardEvent, 
+        event: KeyboardEvent,
         type: string,
         targetFrameSrc: string,
         wnd?: ReadiumWindow,
@@ -61,7 +61,7 @@ export class KeyCombinationManager {
             const selectedTextStr = selection?.toString() || '';
             const domRectList = (selectedTextStr && selection?.rangeCount) ? selection.getRangeAt(0)?.getClientRects() : null;
             const rect = domRectList?.[0];
-            
+
             if (rect && selectedTextStr) {
                 selectedText = {
                     text: selectedTextStr,
@@ -124,7 +124,7 @@ export class KeyCombinationManager {
         wnd?: ReadiumWindow,
     ): (event: KeyboardEvent) => void {
         const handlers = this.createKeyboardHandlers(targetFrameSrc, shortcuts, dispatcher, wnd);
-        
+
         return (event: KeyboardEvent) => {
             for (const handlerConfig of handlers) {
                 if (this.match(event, [handlerConfig])) {
@@ -136,4 +136,4 @@ export class KeyCombinationManager {
             }
         };
     }
-}
+}

package/src/protection/PatternAnalyzer.ts

@@ -1,4 +1,4 @@
-import { DEFAULT_PATTERN_ANALYZER_CONFIG } from "./config";
+import { DEFAULT_PATTERN_ANALYZER_CONFIG } from "./config.ts";
 
 type Direction = "left" | "right" | "up" | "down";
 
@@ -10,7 +10,7 @@ export interface PatternAnalyzerOptions {
     maxConsistentScrolls?: number; // Maximum number of consistent scrolls before flagging
 }
 
-// TODO: Improve for scroll protection, 
+// TODO: Improve for scroll protection,
 // currently disabled because of false positives
 export class PatternAnalyzer {
     private options: PatternAnalyzerOptions;
@@ -20,9 +20,9 @@ export class PatternAnalyzer {
         velocity: number;
         distance: number;
     }> = [];
-    
+
     private consistentScrollCount = 0;
-    
+
     constructor(
         options: Partial<PatternAnalyzerOptions> = {}
     ) {
@@ -32,18 +32,18 @@ export class PatternAnalyzer {
 
     analyze(direction: Direction, distance: number, timeDelta: number): boolean {
         if (timeDelta <= 0) return false;
-        
+
         const velocity = Math.abs(distance) / timeDelta;
         const now = Date.now();
-        
+
         // Add new event
-        this.history.push({ 
-            timestamp: now, 
-            direction, 
+        this.history.push({
+            timestamp: now,
+            direction,
             velocity,
             distance: Math.abs(distance)
         });
-        
+
         // Clean up old events (keep last 2 seconds of data or historySize, whichever is smaller)
         this.history = this.history
             .filter(h => now - h.timestamp < 2000)
@@ -61,19 +61,19 @@ export class PatternAnalyzer {
         // 2. Check for consistent scrolling patterns
         const velocities = this.history.map(h => h.velocity);
         const distances = this.history.map(h => h.distance);
-        
+
         // Calculate mean and variance of velocities and distances
         const meanVelocity = velocities.reduce((a, b) => a + b, 0) / velocities.length;
         const meanDistance = distances.reduce((a, b) => a + b, 0) / distances.length;
-        
+
         const velocityVariance = velocities.reduce((a, b) => a + Math.pow(b - meanVelocity, 2), 0) / velocities.length;
         const distanceVariance = distances.reduce((a, b) => a + Math.pow(b - meanDistance, 2), 0) / distances.length;
 
         // Check for suspiciously consistent scrolling (low variance in speed and distance)
-        if (velocityVariance < this.options.minVariance && 
+        if (velocityVariance < this.options.minVariance &&
             distanceVariance < (meanDistance * 0.1)) { // Allow 10% variance in distance
             this.consistentScrollCount++;
-            
+
             // Only trigger if we've seen consistent scrolling for a while
             if (this.consistentScrollCount >= (this.options.maxConsistentScrolls || 10)) {
                 this.resetAfterDetection();
@@ -87,14 +87,14 @@ export class PatternAnalyzer {
         // 3. Check for rapid direction changes (unnatural back-and-forth scrolling)
         let directionChanges = 0;
         let lastDirection = this.history[0].direction;
-        
+
         for (let i = 1; i < this.history.length; i++) {
             if (this.history[i].direction !== lastDirection) {
                 directionChanges++;
                 lastDirection = this.history[i].direction;
             }
         }
-        
+
         const directionChangeRatio = directionChanges / this.history.length;
         if (directionChangeRatio > (this.options.minDirectionChanges || 0.3)) {
             this.resetAfterDetection();
@@ -109,9 +109,9 @@ export class PatternAnalyzer {
         this.history = this.history.slice(-3);
         this.consistentScrollCount = 0;
     }
-    
+
     clear(): void {
         this.history = [];
         this.consistentScrollCount = 0;
     }
-}
+}

package/src/protection/PrintProtector.ts

@@ -1,7 +1,7 @@
-import { Comms } from "../comms";
-import { ReadiumWindow } from "../helpers/dom";
-import { Module } from "../modules/Module";
-import { ModuleName } from "../modules/ModuleLibrary";
+import { Comms } from "../comms/index.ts";
+import { ReadiumWindow } from "../helpers/dom.ts";
+import { Module } from "../modules/Module.ts";
+import { ModuleName } from "../modules/ModuleLibrary.ts";
 
 export interface PrintProtectionConfig {
     disable?: boolean;
@@ -10,7 +10,7 @@ export interface PrintProtectionConfig {
 
 export class PrintProtector extends Module {
     static readonly moduleName: ModuleName = "print_protection";
-    
+
     private comms!: Comms;
     private wnd!: ReadiumWindow;
     private styleElement: HTMLStyleElement | null = null;
@@ -46,16 +46,16 @@ export class PrintProtector extends Module {
         wnd.addEventListener("beforeprint", this.beforePrintHandler);
     }
 
-    private registerPrintHandlers() {        
+    private registerPrintHandlers() {
         this.comms?.register("print_protection", PrintProtector.moduleName, (data: unknown) => {
             const config = data as PrintProtectionConfig;
-            
+
             if (!this.configApplied) {
                 this.configApplied = true;
                 this.setupPrintProtection(this.wnd, config);
                 this.comms?.log("Print protection configuration applied");
             }
-            
+
             return true;
         });
     }
@@ -72,16 +72,16 @@ export class PrintProtector extends Module {
             wnd.removeEventListener("beforeprint", this.beforePrintHandler);
             this.beforePrintHandler = null;
         }
-        
+
         if (this.styleElement?.parentNode) {
             this.styleElement.parentNode.removeChild(this.styleElement);
             this.styleElement = null;
         }
-        
+
         // Unregister all print protection handlers
         this.comms?.unregisterAll(PrintProtector.moduleName);
-        
+
         this.configApplied = false;
         return true;
     }
-}
+}

package/src/protection/SelectionAnalyzer.ts

@@ -10,7 +10,7 @@ export interface SelectionAnalyzerOptions {
     historySize: number;
 }
 
-import { SELECTION_ANALYZER_CONFIG } from './config';
+import { SELECTION_ANALYZER_CONFIG } from './config.ts';
 
 export class SelectionAnalyzer {
     private events: SelectionEvent[] = [];

package/src/protection/config.ts

@@ -1,6 +1,6 @@
-import { BulkCopyProtectionOptions } from "./BulkCopyProtector";
-import { PatternAnalyzerOptions } from "./PatternAnalyzer";
-import { SelectionAnalyzerOptions } from "./SelectionAnalyzer";
+import { BulkCopyProtectionOptions } from "./BulkCopyProtector.ts";
+import { PatternAnalyzerOptions } from "./PatternAnalyzer.ts";
+import { SelectionAnalyzerOptions } from "./SelectionAnalyzer.ts";
 
 export const DEFAULT_PATTERN_ANALYZER_CONFIG: PatternAnalyzerOptions = {
     maxVelocity: 200,         // Reasonable default for human-like scrolling (pixels/ms)
@@ -30,4 +30,4 @@ export const BULK_COPY_CONFIG: BulkCopyProtectionOptions = {
     minThreshold: 100,
     absoluteMaxChars: 5000,
     historySize: 20
-}
+}

package/src/protection/index.ts

@@ -1,6 +1,6 @@
-export * from "./BulkCopyProtector";
-export * from "./KeyCombinationManager";
-export * from "./KeyboardCombinations";
-export * from "./PatternAnalyzer";
-export * from "./SelectionAnalyzer";
-export * from "./PrintProtector";
+export * from "./BulkCopyProtector.ts";
+export * from "./KeyCombinationManager.ts";
+export * from "./KeyboardCombinations.ts";
+export * from "./PatternAnalyzer.ts";
+export * from "./SelectionAnalyzer.ts";
+export * from "./PrintProtector.ts";

package/src/vendor/hypothesis/anchoring/html.ts

@@ -4,7 +4,7 @@ import type {
   Selector,
   TextPositionSelector,
   TextQuoteSelector,
-} from './api-types';
+} from './api-types.ts';
 import {
   MediaTimeAnchor,
   RangeAnchor,

package/src/vendor/hypothesis/anchoring/types.ts

@@ -12,7 +12,7 @@ import type {
   RangeSelector,
   TextPositionSelector,
   TextQuoteSelector,
-} from './api-types';
+} from './api-types.ts';
 import { matchQuote } from './match-quote';
 import { TextRange, TextPosition } from './text-range';
 import { nodeFromXPath, xpathFromNode } from './xpath';

package/types/src/Loader.d.ts

@@ -1,5 +1,5 @@
-import { ReadiumWindow } from "./helpers/dom";
-import { ModuleName } from "./modules";
+import { ReadiumWindow } from "./helpers/dom.ts";
+import { ModuleName } from "./modules/index.ts";
 /**
  * The Module loader. Handles initialization of the HTML injectables
  * in the target Window, which could be an IFrame, or the current window).

package/types/src/comms/comms.d.ts

@@ -1,5 +1,5 @@
-import { ReadiumWindow } from "../helpers/dom";
-import { CommsEventKey, CommsCommandKey } from "./keys";
+import { ReadiumWindow } from "../helpers/dom.ts";
+import { CommsEventKey, CommsCommandKey } from "./keys.ts";
 export declare const COMMS_VERSION = 1;
 export interface CommsMessage {
     _readium: number;

package/types/src/comms/index.d.ts

@@ -1,3 +1,3 @@
-export * from './comms';
-export * from './keys';
-export * from './mid';
+export * from './comms.ts';
+export * from './keys.ts';
+export * from './mid.ts';

package/types/src/helpers/css.d.ts

@@ -1,5 +1,4 @@
-import { ReadiumWindow } from "./dom";
-export declare const isTypedOMSupported: () => boolean;
+import { ReadiumWindow } from "./dom.ts";
 export declare function getProperties(wnd: ReadiumWindow): {
     [key: string]: string;
 };

package/types/src/helpers/document.d.ts

@@ -1,4 +1,4 @@
-import { ReadiumWindow } from "./dom";
+import { ReadiumWindow } from "./dom.ts";
 export declare function isRTL(wnd: ReadiumWindow): boolean;
 export declare function getColumnCountPerScreen(wnd: ReadiumWindow): number;
 /**

package/types/src/index.d.ts

@@ -1,4 +1,4 @@
-export * from './comms';
-export * from './modules';
-export * from './Loader';
-export * from './protection';
+export * from './comms/index.ts';
+export * from './modules/index.ts';
+export * from './Loader.ts';
+export * from './protection/index.ts';

package/types/src/modules/Decorator.d.ts

@@ -1,8 +1,8 @@
 import { Locator } from "@readium/shared";
-import { Comms } from "../comms/comms";
-import { Module } from "./Module";
-import { ModuleName } from "./ModuleLibrary";
-import { ReadiumWindow } from "../helpers/dom";
+import { Comms } from "../comms/comms.ts";
+import { Module } from "./Module.ts";
+import { ModuleName } from "./ModuleLibrary.ts";
+import { ReadiumWindow } from "../helpers/dom.ts";
 export declare enum Width {
     Wrap = "wrap",// Smallest width fitting the CSS border box.
     Viewport = "viewport",// Fills the whole viewport.

package/types/src/modules/Module.d.ts

@@ -1,6 +1,6 @@
-import { Comms } from "../comms";
-import { ReadiumWindow } from "../helpers/dom";
-import { ModuleName } from "./ModuleLibrary";
+import { Comms } from "../comms/index.ts";
+import { ReadiumWindow } from "../helpers/dom.ts";
+import { ModuleName } from "./ModuleLibrary.ts";
 export declare abstract class Module {
     static readonly moduleName: ModuleName;
     abstract mount(wnd: ReadiumWindow, comms: Comms): boolean;

package/types/src/modules/ModuleLibrary.d.ts

@@ -1,5 +1,5 @@
-import { ModuleDerived } from "./Module";
-export type ModuleName = "setup" | "snapper" | "column_snapper" | "scroll_snapper" | "webpub_snapper" | "fixed_setup" | "decorator" | "reflowable_setup" | "peripherals" | "webpub_setup" | "print_protection";
+import { ModuleDerived } from "./Module.ts";
+export type ModuleName = "setup" | "snapper" | "column_snapper" | "scroll_snapper" | "cjk_vertical_snapper" | "webpub_snapper" | "fixed_setup" | "decorator" | "reflowable_setup" | "peripherals" | "webpub_setup" | "print_protection";
 export declare const FXLModules: ModuleName[];
 export declare const ReflowableModules: ModuleName[];
 export declare const WebPubModules: ModuleName[];

package/types/src/modules/Peripherals.d.ts

@@ -1,12 +1,12 @@
-import { Comms } from "../comms/comms";
-import { Module } from "./Module";
-import { ReadiumWindow } from "../helpers/dom";
-import { BulkCopyProtectionOptions } from "../protection/BulkCopyProtector";
-import { SelectionAnalyzerOptions } from "../protection/SelectionAnalyzer";
-import { SuspiciousActivityType } from "../comms";
-import { KeyboardPeripheralEvent } from "../protection/KeyCombinationManager";
-import { SuspiciousScrollingEvent } from "./snapper/ScrollSnapper";
-import { SuspiciousSnappingEvent } from "./snapper/ColumnSnapper";
+import { Comms } from "../comms/comms.ts";
+import { Module } from "./Module.ts";
+import { ReadiumWindow } from "../helpers/dom.ts";
+import { BulkCopyProtectionOptions } from "../protection/BulkCopyProtector.ts";
+import { SelectionAnalyzerOptions } from "../protection/SelectionAnalyzer.ts";
+import { SuspiciousActivityType } from "../comms/index.ts";
+import { KeyboardPeripheralEvent } from "../protection/KeyCombinationManager.ts";
+import { SuspiciousScrollingEvent } from "./snapper/ScrollSnapper.ts";
+import { SuspiciousSnappingEvent } from "./snapper/ColumnSnapper.ts";
 export interface FrameClickEvent {
     defaultPrevented: boolean;
     doNotDisturb: boolean;
@@ -122,6 +122,7 @@ export declare class Peripherals extends Module {
     private handleSelection;
     private addSelectionMonitoring;
     private removeSelectionMonitoring;
+    private onDragOver;
     private onDragStart;
     private onDrop;
     private onContext;

package/types/src/modules/index.d.ts

@@ -1,4 +1,4 @@
-export * from './Decorator';
-export * from './Module';
-export * from './ModuleLibrary';
-export * from './Peripherals';
+export * from './Decorator.ts';
+export * from './Module.ts';
+export * from './ModuleLibrary.ts';
+export * from './Peripherals.ts';

package/types/src/modules/setup/FixedSetup.d.ts

@@ -1,7 +1,7 @@
-import { Comms } from "../../comms/comms";
-import { Setup } from "./Setup";
-import { ModuleName } from "../ModuleLibrary";
-import { ReadiumWindow } from "../../helpers/dom";
+import { Comms } from "../../comms/comms.ts";
+import { Setup } from "./Setup.ts";
+import { ModuleName } from "../ModuleLibrary.ts";
+import { ReadiumWindow } from "../../helpers/dom.ts";
 export declare class FixedSetup extends Setup {
     static readonly moduleName: ModuleName;
     mount(wnd: ReadiumWindow, comms: Comms): boolean;

package/types/src/modules/setup/ReflowableSetup.d.ts

@@ -1,6 +1,6 @@
-import { Comms } from "../../comms/comms";
-import { Setup } from "./Setup";
-import { ReadiumWindow } from "../../helpers/dom";
+import { Comms } from "../../comms/comms.ts";
+import { Setup } from "./Setup.ts";
+import { ReadiumWindow } from "../../helpers/dom.ts";
 export declare class ReflowableSetup extends Setup {
     static readonly moduleName = "reflowable_setup";
     onViewportWidthChanged(event: Event): void;

package/types/src/modules/setup/Setup.d.ts

@@ -1,7 +1,7 @@
-import { Comms } from "../../comms/comms";
-import { ReadiumWindow } from "../../helpers/dom";
-import { Module } from "../Module";
-import { ModuleName } from "../ModuleLibrary";
+import { Comms } from "../../comms/comms.ts";
+import { ReadiumWindow } from "../../helpers/dom.ts";
+import { Module } from "../Module.ts";
+import { ModuleName } from "../ModuleLibrary.ts";
 export declare abstract class Setup extends Module {
     static readonly moduleName: ModuleName;
     private comms;

package/types/src/modules/setup/WebPubSetup.d.ts

@@ -1,6 +1,6 @@
-import { Comms } from "../../comms/comms";
-import { ReadiumWindow } from "../../helpers/dom";
-import { Module } from "../Module";
+import { Comms } from "../../comms/comms.ts";
+import { ReadiumWindow } from "../../helpers/dom.ts";
+import { Module } from "../Module.ts";
 export declare class WebPubSetup extends Module {
     static readonly moduleName = "webpub_setup";
     private comms;

package/types/src/modules/snapper/CJKVerticalSnapper.d.ts

@@ -0,0 +1,57 @@
+import { Comms } from "../../comms/comms.ts";
+import { ReadiumWindow } from "../../helpers/dom.ts";
+import { ModuleName } from "../ModuleLibrary.ts";
+import { Snapper } from "./Snapper.ts";
+import { BaseSuspiciousActivityEvent } from "../Peripherals.ts";
+export interface SuspiciousCJKScrollingEvent extends BaseSuspiciousActivityEvent {
+    type: "suspicious_scrolling";
+    scrollDelta: number;
+    scrollDirection: "left" | "right";
+    targetElement: {
+        tagName: string;
+    } | null;
+}
+/**
+ * Snapper for CJK vertical writing (writing-mode: vertical-rl).
+ *
+ * In vertical-rl, content overflows on the X axis, flowing from right (start)
+ * to left (end). This snapper is the horizontal counterpart of ScrollSnapper:
+ * it tracks scrollLeft / scrollWidth / innerWidth and reports progress
+ * accordingly.
+ *
+ * Progress convention:
+ *   scrollLeft = 0 (right edge, document start)  →  progress 0
+ *   scrollLeft = ±(scrollWidth − clientWidth)    →  progress 1 (document end, left edge)
+ *
+ * All modern browsers use negative scrollLeft for vertical-rl (range: [−scrollable, 0]).
+ * Read it with Math.abs() to get a non-negative offset from document start.
+ * Write absolute positions as negative values (go_progression, go_end).
+ * Write relative adjustments as viewport-coordinate deltas (go_id, go_text) — this
+ * is sign-agnostic and works regardless of browser convention.
+ *
+ * go_next / go_prev always return false so that the navigator advances to the
+ * next or previous spine item — this snapper intentionally provides free
+ * horizontal scroll without intra-resource page fragmentation.
+ */
+export declare class CJKVerticalSnapper extends Snapper {
+    static readonly moduleName: ModuleName;
+    private wnd;
+    private comms;
+    private resizeObserver;
+    private patternAnalyzer;
+    private lastScrollTime;
+    private isScrollProtectionEnabled;
+    private initialScrollHandled;
+    private isScrolling;
+    private lastScrollLeft;
+    private isResizing;
+    private resizeDebounce;
+    private doc;
+    /** Total horizontally scrollable distance (magnitude). */
+    private scrollable;
+    private reportProgress;
+    private handleScroll;
+    private enableScrollProtection;
+    mount(wnd: ReadiumWindow, comms: Comms): boolean;
+    unmount(wnd: ReadiumWindow, comms: Comms): boolean;
+}

package/types/src/modules/snapper/ColumnSnapper.d.ts

@@ -1,8 +1,8 @@
-import { Comms } from "../../comms";
-import { Snapper } from "./Snapper";
-import { ModuleName } from "../ModuleLibrary";
-import { ReadiumWindow } from "../../helpers/dom";
-import { BaseSuspiciousActivityEvent } from "../Peripherals";
+import { Comms } from "../../comms/index.ts";
+import { Snapper } from "./Snapper.ts";
+import { ModuleName } from "../ModuleLibrary.ts";
+import { ReadiumWindow } from "../../helpers/dom.ts";
+import { BaseSuspiciousActivityEvent } from "../Peripherals.ts";
 export interface SuspiciousSnappingEvent extends BaseSuspiciousActivityEvent {
     type: "suspicious_snapping";
     event: null;
@@ -22,6 +22,17 @@ export declare class ColumnSnapper extends Snapper {
     private doc;
     private scrollOffset;
     snapOffset(offset: number): number;
+    /**
+     * Snap a non-negative normalized offset (distance from document start) to
+     * the nearest page boundary. Works identically regardless of reading direction.
+     */
+    private snapNormOffset;
+    /**
+     * Normalized scroll position: distance from document start, always in
+     * [0, scrollWidth - innerWidth] regardless of reading direction.
+     * scrollLeft may be negative depending on the browser — Math.abs() normalizes it.
+     */
+    private normScroll;
     reportProgress(): void;
     private shakeTimeout;
     shake(): void;

package/types/src/modules/snapper/ScrollSnapper.d.ts

@@ -1,8 +1,8 @@
-import { Comms } from "../../comms";
-import { ReadiumWindow } from "../../helpers/dom";
-import { ModuleName } from "../ModuleLibrary";
-import { Snapper } from "./Snapper";
-import { BaseSuspiciousActivityEvent } from "../Peripherals";
+import { Comms } from "../../comms/index.ts";
+import { ReadiumWindow } from "../../helpers/dom.ts";
+import { ModuleName } from "../ModuleLibrary.ts";
+import { Snapper } from "./Snapper.ts";
+import { BaseSuspiciousActivityEvent } from "../Peripherals.ts";
 export interface SuspiciousScrollingEvent extends BaseSuspiciousActivityEvent {
     type: "suspicious_scrolling";
     scrollDelta: number;