@prose-reader/core 1.199.0 → 1.200.0

package/dist/navigation/InternalNavigator.d.ts

@@ -8,7 +8,7 @@ import { DestroyableClass } from '../utils/DestroyableClass';
 import { Locker } from './Locker';
 import { UserNavigationEntry } from './UserNavigator';
 import { createNavigationResolver } from './resolvers/NavigationResolver';
-import { ViewportNavigator, ViewportPosition } from './viewport/ViewportNavigator';
+import { DeprecatedViewportPosition, ViewportNavigator } from './viewport/ViewportNavigator';
 export type NavigationConsolidation = {
     spineItemHeight?: number;
     spineItemWidth?: number;
@@ -21,7 +21,7 @@ export type NavigationConsolidation = {
     directionFromLastNavigation?: "forward" | "backward" | "anchor";
 };
 export type InternalNavigationEntry = {
-    position: SpinePosition | ViewportPosition;
+    position: SpinePosition | DeprecatedViewportPosition;
     id: symbol;
     meta: {
         triggeredBy: `user` | `restoration` | `pagination`;
@@ -32,7 +32,9 @@ export type InternalNavigationEntry = {
     spineItem?: string | number;
     cfi?: string;
 } & NavigationConsolidation;
-export type InternalNavigationInput = Omit<InternalNavigationEntry, "position"> & Partial<InternalNavigationEntry>;
+export type InternalNavigationInput = Omit<InternalNavigationEntry, "position"> & {
+    position?: SpinePosition | DeprecatedViewportPosition;
+};
 export type Navigation = Pick<InternalNavigationEntry, "position" | "id">;
 export declare class InternalNavigator extends DestroyableClass {
     protected settings: ReaderSettingsManager;
@@ -45,7 +47,7 @@ export declare class InternalNavigator extends DestroyableClass {
     protected isUserLocked$: Observable<boolean>;
     navigationSubject: BehaviorSubject<InternalNavigationEntry>;
     navigated$: Observable<{
-        position: SpinePosition | ViewportPosition;
+        position: SpinePosition | DeprecatedViewportPosition;
         id: symbol;
         meta: {
             triggeredBy: `user` | `restoration` | `pagination`;
@@ -57,7 +59,7 @@ export declare class InternalNavigator extends DestroyableClass {
         cfi?: string;
     } & NavigationConsolidation>;
     navigation$: Observable<{
-        position: SpinePosition | ViewportPosition;
+        position: SpinePosition;
         id: symbol;
     }>;
     locker: Locker;

package/dist/navigation/Navigator.d.ts

@@ -25,25 +25,21 @@ export declare const createNavigator: ({ spineItemsManager, context, parentEleme
     lock(): () => void;
     navigationResolver: {
         getNavigationForUrl: (url: string | URL) => {
-            position: import('./viewport/ViewportNavigator').ViewportPosition;
+            position: import('./viewport/ViewportNavigator').DeprecatedViewportPosition;
             spineItemId: string;
         } | undefined;
-        getNavigationForSpineItemPage: (params: Omit<Parameters<typeof import('./resolvers/getNavigationForSpineItemPage').getNavigationForSpineItemPage>[0], "context" | "spineItemsManager" | "spineItemNavigationResolver" | "spineLocator">) => import('./viewport/ViewportNavigator').ViewportPosition;
+        getNavigationForSpineItemPage: (params: Omit<Parameters<typeof import('./resolvers/getNavigationForSpineItemPage').getNavigationForSpineItemPage>[0], "context" | "spineItemsManager" | "spineItemNavigationResolver" | "spineLocator">) => import('../spine/types').SpinePosition;
         getNavigationFromSpineItemPosition: (params: {
             spineItemPosition: import('../spineItem/types').SpineItemPosition;
             spineItem: import('..').SpineItem;
-        }) => import('./viewport/ViewportNavigator').ViewportPosition;
-        getNavigationForCfi: (cfi: string) => import('./viewport/ViewportNavigator').ViewportPosition | undefined;
-        getNavigationForLastPage: (spineItem: import('..').SpineItem) => import('./viewport/ViewportNavigator').ViewportPosition;
-        getNavigationForSpineIndexOrId: (indexOrId: number | string | import('..').SpineItem) => import('./viewport/ViewportNavigator').ViewportPosition;
-        getNavigationForPosition: (viewportPosition: import('./viewport/ViewportNavigator').ViewportPosition | import('../spine/types').SpinePosition) => import('./viewport/ViewportNavigator').ViewportPosition;
-        getMostPredominantNavigationForPosition: (viewportPosition: import('./viewport/ViewportNavigator').ViewportPosition) => import('./viewport/ViewportNavigator').ViewportPosition;
-        getAdjustedPositionWithSafeEdge: (position: import('./viewport/ViewportNavigator').ViewportPosition | import('../spine/types').SpinePosition) => {
-            x: number;
-            y: number;
-        };
-        isNavigationGoingForwardFrom: (to: import('./viewport/ViewportNavigator').ViewportPosition, from: import('./viewport/ViewportNavigator').ViewportPosition) => boolean;
-        areNavigationDifferent: (a: import('./viewport/ViewportNavigator').ViewportPosition, b: import('./viewport/ViewportNavigator').ViewportPosition) => boolean;
+        }) => import('../spine/types').SpinePosition;
+        getNavigationForCfi: (cfi: string) => import('./viewport/ViewportNavigator').DeprecatedViewportPosition | undefined;
+        getNavigationForLastPage: (spineItem: import('..').SpineItem) => import('./viewport/ViewportNavigator').DeprecatedViewportPosition;
+        getNavigationForSpineIndexOrId: (indexOrId: number | string | import('..').SpineItem) => import('./viewport/ViewportNavigator').DeprecatedViewportPosition;
+        getNavigationForPosition: (viewportPosition: import('./viewport/ViewportNavigator').DeprecatedViewportPosition | import('../spine/types').SpinePosition) => import('../spine/types').SpinePosition;
+        getMostPredominantNavigationForPosition: (viewportPosition: import('./viewport/ViewportNavigator').DeprecatedViewportPosition) => import('./viewport/ViewportNavigator').DeprecatedViewportPosition;
+        getAdjustedPositionWithSafeEdge: (position: import('./viewport/ViewportNavigator').DeprecatedViewportPosition | import('../spine/types').SpinePosition) => import('../spine/types').SpinePosition;
+        isNavigationGoingForwardFrom: (to: import('./viewport/ViewportNavigator').DeprecatedViewportPosition, from: import('./viewport/ViewportNavigator').DeprecatedViewportPosition) => boolean;
         arePositionsDifferent: (a: {
             x: number;
             y: number;
@@ -51,7 +47,7 @@ export declare const createNavigator: ({ spineItemsManager, context, parentEleme
             x: number;
             y: number;
         }) => boolean;
-        getAdjustedPositionForSpread: (position: import('./viewport/ViewportNavigator').ViewportPosition | import('../spine/types').SpinePosition) => import('./viewport/ViewportNavigator').ViewportPosition;
+        getAdjustedPositionForSpread: (position: import('./viewport/ViewportNavigator').DeprecatedViewportPosition | import('../spine/types').SpinePosition) => import('../spine/types').SpinePosition;
         spineItemNavigator: {
             getNavigationForLastPage: (spineItem: import('..').SpineItem) => import('../spineItem/types').SpineItemPosition;
             getNavigationForPosition: (spineItem: import('..').SpineItem, position: import('../spineItem/types').SpineItemPosition) => import('../spineItem/types').SpineItemPosition;
@@ -59,7 +55,7 @@ export declare const createNavigator: ({ spineItemsManager, context, parentEleme
         };
     };
     navigation$: import('rxjs').Observable<{
-        position: import('../spine/types').SpinePosition | import('./viewport/ViewportNavigator').ViewportPosition;
+        position: import('../spine/types').SpinePosition;
         id: symbol;
     }>;
     getElement: () => HTMLElement;

package/dist/navigation/UserNavigator.d.ts

@@ -1,12 +1,13 @@
 import { Observable, Subject } from 'rxjs';
-import { ReaderSettingsManager } from '../settings/ReaderSettingsManager';
-import { ViewportPosition } from './viewport/ViewportNavigator';
 import { Context } from '../context/Context';
+import { ReaderSettingsManager } from '../settings/ReaderSettingsManager';
+import { Spine } from '../spine/Spine';
+import { SpinePosition } from '../spine/types';
 import { DestroyableClass } from '../utils/DestroyableClass';
 import { Locker } from './Locker';
-import { Spine } from '../spine/Spine';
+import { DeprecatedViewportPosition } from './viewport/ViewportNavigator';
 export type UserNavigationEntry = {
-    position?: ViewportPosition;
+    position?: DeprecatedViewportPosition | SpinePosition;
     spineItem?: number | string;
     url?: string | URL;
     cfi?: string;

package/dist/navigation/consolidation/consolidateWithPagination.d.ts

@@ -6,7 +6,7 @@ export declare const consolidateWithPagination: (context: Context, navigation$:
     meta: {
         triggeredBy: "pagination";
     };
-    position: import('../../spine/types').SpinePosition | import('../viewport/ViewportNavigator').ViewportPosition;
+    position: import('../../spine/types').SpinePosition | import('../viewport/ViewportNavigator').DeprecatedViewportPosition;
     id: symbol;
     type: `api` | `scroll`;
     animation?: boolean | `turn` | `snap`;

package/dist/navigation/consolidation/withFallbackPosition.d.ts

@@ -1,6 +1,6 @@
 import { Observable } from 'rxjs';
-import { InternalNavigationEntry, InternalNavigationInput } from '../InternalNavigator';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
+import { InternalNavigationEntry, InternalNavigationInput } from '../InternalNavigator';
 import { NavigationResolver } from '../resolvers/NavigationResolver';
 export declare const withFallbackPosition: ({ spineItemsManager, navigationResolver, }: {
     spineItemsManager: SpineItemsManager;

package/dist/navigation/consolidation/withSpineItem.d.ts

@@ -1,10 +1,10 @@
 import { Observable } from 'rxjs';
-import { InternalNavigationInput } from '../InternalNavigator';
 import { Context } from '../../context/Context';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
-import { NavigationResolver } from '../resolvers/NavigationResolver';
 import { SpineLocator } from '../../spine/locator/SpineLocator';
+import { InternalNavigationInput } from '../InternalNavigator';
+import { NavigationResolver } from '../resolvers/NavigationResolver';
 type Navigation = {
     navigation: InternalNavigationInput;
 };

package/dist/navigation/resolvers/NavigationResolver.d.ts

@@ -6,7 +6,7 @@ import { SpineLocator } from '../../spine/locator/SpineLocator';
 import { SpinePosition } from '../../spine/types';
 import { SpineItem } from '../../spineItem/SpineItem';
 import { SpineItemPosition } from '../../spineItem/types';
-import { ViewportPosition } from '../viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../viewport/ViewportNavigator';
 import { getNavigationForSpineItemPage } from './getNavigationForSpineItemPage';
 export declare const NAMESPACE = "spineNavigator";
 export type NavigationResolver = ReturnType<typeof createNavigationResolver>;
@@ -18,25 +18,21 @@ export declare const createNavigationResolver: ({ context, spineItemsManager, lo
     spineLayout: SpineLayout;
 }) => {
     getNavigationForUrl: (url: string | URL) => {
-        position: ViewportPosition;
+        position: DeprecatedViewportPosition;
         spineItemId: string;
     } | undefined;
-    getNavigationForSpineItemPage: (params: Omit<Parameters<typeof getNavigationForSpineItemPage>[0], "context" | "spineItemsManager" | "spineItemNavigationResolver" | "spineLocator">) => ViewportPosition;
+    getNavigationForSpineItemPage: (params: Omit<Parameters<typeof getNavigationForSpineItemPage>[0], "context" | "spineItemsManager" | "spineItemNavigationResolver" | "spineLocator">) => SpinePosition;
     getNavigationFromSpineItemPosition: (params: {
         spineItemPosition: SpineItemPosition;
         spineItem: SpineItem;
-    }) => ViewportPosition;
-    getNavigationForCfi: (cfi: string) => ViewportPosition | undefined;
-    getNavigationForLastPage: (spineItem: SpineItem) => ViewportPosition;
-    getNavigationForSpineIndexOrId: (indexOrId: number | string | SpineItem) => ViewportPosition;
-    getNavigationForPosition: (viewportPosition: ViewportPosition | SpinePosition) => ViewportPosition;
-    getMostPredominantNavigationForPosition: (viewportPosition: ViewportPosition) => ViewportPosition;
-    getAdjustedPositionWithSafeEdge: (position: ViewportPosition | SpinePosition) => {
-        x: number;
-        y: number;
-    };
-    isNavigationGoingForwardFrom: (to: ViewportPosition, from: ViewportPosition) => boolean;
-    areNavigationDifferent: (a: ViewportPosition, b: ViewportPosition) => boolean;
+    }) => SpinePosition;
+    getNavigationForCfi: (cfi: string) => DeprecatedViewportPosition | undefined;
+    getNavigationForLastPage: (spineItem: SpineItem) => DeprecatedViewportPosition;
+    getNavigationForSpineIndexOrId: (indexOrId: number | string | SpineItem) => DeprecatedViewportPosition;
+    getNavigationForPosition: (viewportPosition: DeprecatedViewportPosition | SpinePosition) => SpinePosition;
+    getMostPredominantNavigationForPosition: (viewportPosition: DeprecatedViewportPosition) => DeprecatedViewportPosition;
+    getAdjustedPositionWithSafeEdge: (position: DeprecatedViewportPosition | SpinePosition) => SpinePosition;
+    isNavigationGoingForwardFrom: (to: DeprecatedViewportPosition, from: DeprecatedViewportPosition) => boolean;
     arePositionsDifferent: (a: {
         x: number;
         y: number;
@@ -44,7 +40,7 @@ export declare const createNavigationResolver: ({ context, spineItemsManager, lo
         x: number;
         y: number;
     }) => boolean;
-    getAdjustedPositionForSpread: (position: ViewportPosition | SpinePosition) => ViewportPosition;
+    getAdjustedPositionForSpread: (position: DeprecatedViewportPosition | SpinePosition) => SpinePosition;
     spineItemNavigator: {
         getNavigationForLastPage: (spineItem: SpineItem) => SpineItemPosition;
         getNavigationForPosition: (spineItem: SpineItem, position: SpineItemPosition) => SpineItemPosition;

package/dist/navigation/resolvers/getAdjustedPositionForSpread.d.ts

@@ -1,7 +1,7 @@
 import { SpinePosition } from '../../spine/types';
-import { ViewportPosition } from '../viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../viewport/ViewportNavigator';
 export declare const getAdjustedPositionForSpread: ({ position: { x, y }, pageSizeWidth, visibleAreaRectWidth, }: {
-    position: ViewportPosition | SpinePosition;
+    position: DeprecatedViewportPosition | SpinePosition;
     pageSizeWidth: number;
     visibleAreaRectWidth: number;
-}) => ViewportPosition;
+}) => DeprecatedViewportPosition;

package/dist/navigation/resolvers/getAdjustedPositionWithSafeEdge.d.ts

@@ -1,16 +1,13 @@
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
 import { SpineLayout } from '../../spine/SpineLayout';
 import { SpinePosition } from '../../spine/types';
-import { ViewportPosition } from '../viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../viewport/ViewportNavigator';
 export declare const NAMESPACE = "spineNavigator";
 export declare const getAdjustedPositionWithSafeEdge: ({ position, isRTL, pageSizeHeight, spineItemsManager, visibleAreaRectWidth, spineLayout, }: {
-    position: ViewportPosition | SpinePosition;
+    position: DeprecatedViewportPosition | SpinePosition;
     isRTL: boolean;
     pageSizeHeight: number;
     spineItemsManager: SpineItemsManager;
     visibleAreaRectWidth: number;
     spineLayout: SpineLayout;
-}) => {
-    x: number;
-    y: number;
-};
+}) => SpinePosition;

package/dist/navigation/resolvers/getNavigationForPosition.d.ts

@@ -2,10 +2,10 @@ import { Context } from '../../context/Context';
 import { SpineLocator } from '../../spine/locator/SpineLocator';
 import { SpinePosition } from '../../spine/types';
 import { SpineItemNavigationResolver } from '../../spineItem/navigationResolver';
-import { ViewportPosition } from '../viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../viewport/ViewportNavigator';
 export declare const getNavigationForPosition: ({ viewportPosition, spineLocator, context, spineItemNavigationResolver, }: {
-    viewportPosition: ViewportPosition | SpinePosition;
+    viewportPosition: DeprecatedViewportPosition | SpinePosition;
     spineLocator: SpineLocator;
     context: Context;
     spineItemNavigationResolver: SpineItemNavigationResolver;
-}) => ViewportPosition;
+}) => SpinePosition;

package/dist/navigation/resolvers/getNavigationForSpineItemPage.d.ts

@@ -3,7 +3,7 @@ import { SpineItemsManager } from '../../spine/SpineItemsManager';
 import { SpineLocator } from '../../spine/locator/SpineLocator';
 import { SpineItem } from '../../spineItem/SpineItem';
 import { SpineItemNavigationResolver } from '../../spineItem/navigationResolver';
-import { ViewportPosition } from '../viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../viewport/ViewportNavigator';
 export declare const getNavigationForSpineItemPage: ({ pageIndex, spineItemsManager, spineItemId, context, spineLocator, spineItemNavigationResolver, }: {
     pageIndex: number;
     spineItemId: SpineItem | number | string;
@@ -11,4 +11,4 @@ export declare const getNavigationForSpineItemPage: ({ pageIndex, spineItemsMana
     spineItemNavigationResolver: SpineItemNavigationResolver;
     spineLocator: SpineLocator;
     context: Context;
-}) => ViewportPosition;
+}) => DeprecatedViewportPosition;

package/dist/navigation/resolvers/getNavigationForUrl.d.ts

@@ -1,7 +1,7 @@
 import { Context } from '../../context/Context';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
 import { SpineLocator } from '../../spine/locator/SpineLocator';
-import { ViewportPosition } from '../viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../viewport/ViewportNavigator';
 export declare const getNavigationForUrl: ({ context, spineItemsManager, spineLocator, url, pageSizeWidth, visibleAreaRectWidth, }: {
     url: string | URL;
     spineItemsManager: SpineItemsManager;
@@ -10,6 +10,6 @@ export declare const getNavigationForUrl: ({ context, spineItemsManager, spineLo
     pageSizeWidth: number;
     visibleAreaRectWidth: number;
 }) => {
-    position: ViewportPosition;
+    position: DeprecatedViewportPosition;
     spineItemId: string;
 } | undefined;

package/dist/navigation/resolvers/getNavigationFromSpineItemPosition.d.ts

@@ -9,4 +9,4 @@ export declare const getNavigationFromSpineItemPosition: ({ spineItem, spineItem
     spineLocator: SpineLocator;
     spineItemLocator: SpineItemLocator;
     context: Context;
-}) => import('../viewport/ViewportNavigator').ViewportPosition;
+}) => import('../../spine/types').SpinePosition;

package/dist/navigation/restoration/restoreNavigationForControlledPageTurnMode.d.ts

@@ -1,6 +1,8 @@
+import { Observable } from 'rxjs';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
 import { SpineLayout } from '../../spine/SpineLayout';
 import { SpineLocator } from '../../spine/locator/SpineLocator';
+import { SpinePosition } from '../../spine/types';
 import { InternalNavigationEntry } from '../InternalNavigator';
 import { NavigationResolver } from '../resolvers/NavigationResolver';
 export declare const restoreNavigationForControlledPageTurnMode: ({ spineLocator, navigation, navigationResolver, spineItemsManager, spineLayout, }: {
@@ -9,7 +11,4 @@ export declare const restoreNavigationForControlledPageTurnMode: ({ spineLocator
     navigationResolver: NavigationResolver;
     spineItemsManager: SpineItemsManager;
     spineLayout: SpineLayout;
-}) => import('rxjs').Observable<{
-    x: number;
-    y: number;
-}>;
+}) => Observable<SpinePosition>;

package/dist/navigation/restoration/restorePosition.d.ts

@@ -8,7 +8,7 @@ import { SpinePosition } from '../../spine/types';
 import { SpineItemLocator } from '../../spineItem/locationResolver';
 import { InternalNavigationEntry } from '../InternalNavigator';
 import { NavigationResolver } from '../resolvers/NavigationResolver';
-import { ViewportPosition } from '../viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../viewport/ViewportNavigator';
 export declare const restorePosition: ({ navigation, spineItemsManager, settings, spineLocator, navigationResolver, spineLayout, }: {
     spineLocator: SpineLocator;
     settings: ReaderSettingsManager;
@@ -18,4 +18,4 @@ export declare const restorePosition: ({ navigation, spineItemsManager, settings
     spineItemLocator: SpineItemLocator;
     context: Context;
     spineLayout: SpineLayout;
-}) => Observable<ViewportPosition | SpinePosition>;
+}) => Observable<DeprecatedViewportPosition | SpinePosition>;

package/dist/navigation/viewport/ViewportNavigator.d.ts

@@ -5,14 +5,9 @@ import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { Spine } from '../../spine/Spine';
 import { SpinePosition } from '../../spine/types';
 import { DestroyableClass } from '../../utils/DestroyableClass';
-export type ViewportPosition = {
-    x: number;
-    y: number;
-    __symbol?: `ViewportPosition`;
-    spineItem?: false;
-};
+export type DeprecatedViewportPosition = SpinePosition;
 export type ViewportNavigationEntry = {
-    position: ViewportPosition | SpinePosition;
+    position: SpinePosition;
     animation?: boolean | "turn" | "snap";
 };
 export declare class ViewportNavigator extends DestroyableClass {
@@ -27,10 +22,7 @@ export declare class ViewportNavigator extends DestroyableClass {
     isScrolling$: Observable<boolean>;
     layout$: Observable<unknown>;
     constructor(settings: ReaderSettingsManager, viewportElement$: BehaviorSubject<HTMLElement>, hookManager: HookManager, context: Context, spine: Spine);
-    protected setViewportPosition({ x, y }: ViewportPosition | SpinePosition): void;
+    protected setViewportPosition(position: SpinePosition): void;
     navigate(navigation: ViewportNavigationEntry): void;
-    get viewportPosition(): {
-        x: number;
-        y: number;
-    };
+    get viewportPosition(): SpinePosition;
 }

package/dist/navigation/viewport/getScaledDownPosition.d.ts

@@ -1,9 +1,7 @@
-import { ViewportPosition } from './ViewportNavigator';
+import { SpinePosition } from '../../spine/types';
+import { DeprecatedViewportPosition } from './ViewportNavigator';
 export declare const getScaledDownPosition: ({ position: { x, y }, spineElement, element, }: {
-    position: ViewportPosition;
+    position: DeprecatedViewportPosition;
     spineElement: HTMLElement;
     element: HTMLElement;
-}) => {
-    x: number;
-    y: number;
-};
+}) => SpinePosition;

package/dist/navigation/viewport/positions.d.ts

@@ -0,0 +1,9 @@
+import { SpinePosition } from '../../spine/types';
+export declare const spinePositionToTranslation: (position: SpinePosition) => {
+    x: number;
+    y: number;
+};
+export declare const translationToSpinePosition: (translation: {
+    x: number;
+    y: number;
+} | DOMMatrix) => SpinePosition;

package/dist/reader.d.ts

@@ -48,35 +48,28 @@ export declare const createReader: (inputSettings: CreateReaderOptions) => {
     };
     navigation: {
         viewportBusy$: import('rxjs').Observable<"busy">;
-        getViewportPosition: () => {
-            x: number;
-            y: number;
-        };
+        getViewportPosition: () => import('./spine/types').SpinePosition;
         getNavigation: () => import('./navigation/InternalNavigator').InternalNavigationEntry;
         getElement: () => HTMLElement;
         navigate: (to: import('./navigation/UserNavigator').UserNavigationEntry) => void;
         lock: () => () => void;
         navigationResolver: {
             getNavigationForUrl: (url: string | URL) => {
-                position: import('./navigation/viewport/ViewportNavigator').ViewportPosition;
+                position: import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition;
                 spineItemId: string;
             } | undefined;
-            getNavigationForSpineItemPage: (params: Omit<Parameters<typeof import('./navigation/resolvers/getNavigationForSpineItemPage').getNavigationForSpineItemPage>[0], "context" | "spineItemsManager" | "spineItemNavigationResolver" | "spineLocator">) => import('./navigation/viewport/ViewportNavigator').ViewportPosition;
+            getNavigationForSpineItemPage: (params: Omit<Parameters<typeof import('./navigation/resolvers/getNavigationForSpineItemPage').getNavigationForSpineItemPage>[0], "context" | "spineItemsManager" | "spineItemNavigationResolver" | "spineLocator">) => import('./spine/types').SpinePosition;
             getNavigationFromSpineItemPosition: (params: {
                 spineItemPosition: import('./spineItem/types').SpineItemPosition;
                 spineItem: SpineItem;
-            }) => import('./navigation/viewport/ViewportNavigator').ViewportPosition;
-            getNavigationForCfi: (cfi: string) => import('./navigation/viewport/ViewportNavigator').ViewportPosition | undefined;
-            getNavigationForLastPage: (spineItem: SpineItem) => import('./navigation/viewport/ViewportNavigator').ViewportPosition;
-            getNavigationForSpineIndexOrId: (indexOrId: number | string | SpineItem) => import('./navigation/viewport/ViewportNavigator').ViewportPosition;
-            getNavigationForPosition: (viewportPosition: import('./navigation/viewport/ViewportNavigator').ViewportPosition | import('./spine/types').SpinePosition) => import('./navigation/viewport/ViewportNavigator').ViewportPosition;
-            getMostPredominantNavigationForPosition: (viewportPosition: import('./navigation/viewport/ViewportNavigator').ViewportPosition) => import('./navigation/viewport/ViewportNavigator').ViewportPosition;
-            getAdjustedPositionWithSafeEdge: (position: import('./navigation/viewport/ViewportNavigator').ViewportPosition | import('./spine/types').SpinePosition) => {
-                x: number;
-                y: number;
-            };
-            isNavigationGoingForwardFrom: (to: import('./navigation/viewport/ViewportNavigator').ViewportPosition, from: import('./navigation/viewport/ViewportNavigator').ViewportPosition) => boolean;
-            areNavigationDifferent: (a: import('./navigation/viewport/ViewportNavigator').ViewportPosition, b: import('./navigation/viewport/ViewportNavigator').ViewportPosition) => boolean;
+            }) => import('./spine/types').SpinePosition;
+            getNavigationForCfi: (cfi: string) => import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition | undefined;
+            getNavigationForLastPage: (spineItem: SpineItem) => import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition;
+            getNavigationForSpineIndexOrId: (indexOrId: number | string | SpineItem) => import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition;
+            getNavigationForPosition: (viewportPosition: import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition | import('./spine/types').SpinePosition) => import('./spine/types').SpinePosition;
+            getMostPredominantNavigationForPosition: (viewportPosition: import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition) => import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition;
+            getAdjustedPositionWithSafeEdge: (position: import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition | import('./spine/types').SpinePosition) => import('./spine/types').SpinePosition;
+            isNavigationGoingForwardFrom: (to: import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition, from: import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition) => boolean;
             arePositionsDifferent: (a: {
                 x: number;
                 y: number;
@@ -84,7 +77,7 @@ export declare const createReader: (inputSettings: CreateReaderOptions) => {
                 x: number;
                 y: number;
             }) => boolean;
-            getAdjustedPositionForSpread: (position: import('./navigation/viewport/ViewportNavigator').ViewportPosition | import('./spine/types').SpinePosition) => import('./navigation/viewport/ViewportNavigator').ViewportPosition;
+            getAdjustedPositionForSpread: (position: import('./navigation/viewport/ViewportNavigator').DeprecatedViewportPosition | import('./spine/types').SpinePosition) => import('./spine/types').SpinePosition;
             spineItemNavigator: {
                 getNavigationForLastPage: (spineItem: SpineItem) => import('./spineItem/types').SpineItemPosition;
                 getNavigationForPosition: (spineItem: SpineItem, position: import('./spineItem/types').SpineItemPosition) => import('./spineItem/types').SpineItemPosition;

package/dist/spine/loader/SpineItemsLoader.d.ts

@@ -1,9 +1,9 @@
-import { SpineItemsManager } from '../SpineItemsManager';
-import { SpineLocator } from '../locator/SpineLocator';
 import { Context } from '../../context/Context';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { DestroyableClass } from '../../utils/DestroyableClass';
+import { SpineItemsManager } from '../SpineItemsManager';
 import { SpineLayout } from '../SpineLayout';
+import { SpineLocator } from '../locator/SpineLocator';
 export declare class SpineItemsLoader extends DestroyableClass {
     protected context: Context;
     protected spineItemsManager: SpineItemsManager;

package/dist/spine/locator/SpineLocator.d.ts

@@ -1,9 +1,9 @@
 import { Context } from '../../context/Context';
-import { ViewportPosition } from '../../navigation/viewport/ViewportNavigator';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { SpineItem } from '../../spineItem/SpineItem';
 import { createSpineItemLocator } from '../../spineItem/locationResolver';
 import { SpineItemPosition } from '../../spineItem/types';
+import { ViewportSlicePosition } from '../../viewport/types';
 import { SpineItemsManager } from '../SpineItemsManager';
 import { SpineLayout } from '../SpineLayout';
 import { SpinePosition } from '../types';
@@ -30,24 +30,25 @@ export declare const createSpineLocator: ({ spineItemsManager, context, spineIte
         currentAbsolutePage: number;
     } | undefined;
     getSpinePositionFromSpineItem: (spineItem: SpineItem) => SpinePosition;
-    getSpineItemPositionFromSpinePosition: ((position: ViewportPosition | SpinePosition, spineItem: SpineItem) => SpineItemPosition) | ((position: SpinePosition | ViewportPosition, spineItem: SpineItem) => SpineItemPosition);
-    getSpineItemFromPosition: (position: ViewportPosition | SpinePosition) => SpineItem | undefined;
+    getSpineItemPositionFromSpinePosition: (position: SpinePosition, spineItem: SpineItem) => SpineItemPosition;
+    getSpineItemFromPosition: (position: SpinePosition) => SpineItem | undefined;
     getSpineItemFromIframe: (iframe: Element) => SpineItem | undefined;
     getSpineItemPageIndexFromNode: (node: Node, offset: number | undefined, spineItemOrIndex: SpineItem | number) => number | undefined;
     getVisibleSpineItemsFromPosition: (params: Omit<Parameters<typeof getVisibleSpineItemsFromPosition>[0], "context" | "spineItemsManager" | "settings" | "spineLayout">) => {
         beginIndex: number;
         endIndex: number;
     } | undefined;
-    getVisiblePagesFromViewportPosition: ({ position, threshold, spineItem, restrictToScreen, }: {
-        position: ViewportPosition | SpinePosition;
+    getVisiblePagesFromViewportPosition: ({ position, threshold, spineItem, restrictToScreen, useAbsoluteViewport, }: {
+        position: SpinePosition;
         threshold: number;
         spineItem: SpineItem;
         restrictToScreen?: boolean;
+        useAbsoluteViewport?: boolean;
     }) => {
         beginPageIndex: number;
         endPageIndex: number;
     } | undefined;
-    isPositionWithinSpineItem: (position: ViewportPosition | SpinePosition, spineItem: SpineItem) => boolean;
+    isPositionWithinSpineItem: (position: ViewportSlicePosition | SpinePosition, spineItem: SpineItem) => boolean;
     spineItemLocator: {
         getSpineItemPositionFromNode: (node: Node, offset: number, spineItem: SpineItem) => SpineItemPosition | undefined;
         getSpineItemPositionFromPageIndex: ({ pageIndex, spineItem, }: {

package/dist/spine/locator/getItemVisibilityForPosition.d.ts

@@ -1,7 +1,5 @@
-import { Context } from '../../context/Context';
-import { ViewportPosition } from '../../navigation/viewport/ViewportNavigator';
-import { SpinePosition } from '../types';
-export declare const getItemVisibilityForPosition: ({ itemPosition: { bottom, left, right, top, width: itemWidth, height: itemHeight, }, threshold, viewportPosition, restrictToScreen, context, }: {
+import { ViewportSlicePosition } from '../../viewport/types';
+export declare const getItemVisibilityForPosition: ({ itemPosition: { bottom, left, right, top, width: itemWidth, height: itemHeight, }, threshold, viewportPosition, restrictToScreen, }: {
     itemPosition: {
         right: number;
         left: number;
@@ -10,10 +8,9 @@ export declare const getItemVisibilityForPosition: ({ itemPosition: { bottom, le
         height: number;
         width: number;
     };
-    viewportPosition: ViewportPosition | SpinePosition;
+    viewportPosition: ViewportSlicePosition;
     threshold: number;
     restrictToScreen?: boolean;
-    context: Context;
 }) => {
     visible: boolean;
 };

package/dist/spine/locator/getSpineItemFromPosition.d.ts

@@ -1,10 +1,10 @@
-import { ViewportPosition } from '../../navigation/viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../../navigation/viewport/ViewportNavigator';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { SpineItemsManager } from '../SpineItemsManager';
 import { SpineLayout } from '../SpineLayout';
 import { SpinePosition } from '../types';
 export declare const getSpineItemFromPosition: ({ position, spineItemsManager, spineLayout, settings, }: {
-    position: ViewportPosition | SpinePosition;
+    position: DeprecatedViewportPosition | SpinePosition;
     spineItemsManager: SpineItemsManager;
     spineLayout: SpineLayout;
     settings: ReaderSettingsManager;

package/dist/spine/locator/getVisibleSpineItemsFromPosition.d.ts

@@ -1,17 +1,18 @@
 import { Context } from '../../context/Context';
-import { ViewportPosition } from '../../navigation/viewport/ViewportNavigator';
+import { DeprecatedViewportPosition } from '../../navigation/viewport/ViewportNavigator';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { SpineItemsManager } from '../SpineItemsManager';
 import { SpineLayout } from '../SpineLayout';
 import { SpinePosition } from '../types';
-export declare const getVisibleSpineItemsFromPosition: ({ position, threshold, restrictToScreen, spineItemsManager, context, settings, spineLayout, }: {
-    position: ViewportPosition | SpinePosition;
+export declare const getVisibleSpineItemsFromPosition: ({ position, threshold, restrictToScreen, spineItemsManager, context, settings, spineLayout, useAbsoluteViewport, }: {
+    position: DeprecatedViewportPosition | SpinePosition;
     threshold: number;
     restrictToScreen?: boolean;
     spineItemsManager: SpineItemsManager;
     context: Context;
     settings: ReaderSettingsManager;
     spineLayout: SpineLayout;
+    useAbsoluteViewport?: boolean;
 }) => {
     beginIndex: number;
     endIndex: number;

package/dist/spine/types.d.ts

@@ -19,17 +19,27 @@ export declare class SpineElementLayout {
     });
 }
 export declare class SpineItemSpineLayout extends SpineElementLayout {
-    readonly __symbol: symbol;
+    readonly __symbol = "SpineItemSpineLayout";
 }
 export declare class SpineItemPageSpineLayout extends SpineElementLayout {
-    readonly __symbol: symbol;
+    readonly __symbol = "SpineItemPageSpineLayout";
 }
 export declare class SpinePosition {
     readonly x: number;
     readonly y: number;
-    readonly __symbol: symbol;
+    readonly __symbol = "SpinePosition";
     constructor(position: {
         x: number;
         y: number;
     });
 }
+export declare class UnsafeSpinePosition {
+    readonly x: number;
+    readonly y: number;
+    readonly __symbol = "UnsafeSpinePosition";
+    constructor(position: {
+        x: number;
+        y: number;
+    });
+    static from(position: SpinePosition): UnsafeSpinePosition;
+}

package/dist/viewport/translateSpinePositionToRelativeViewport.d.ts

@@ -0,0 +1,4 @@
+import { DeprecatedViewportPosition } from '../navigation/viewport/ViewportNavigator';
+import { SpinePosition, UnsafeSpinePosition } from '../spine/types';
+import { AbsoluteViewport, RelativeViewport } from './types';
+export declare const translateSpinePositionToRelativeViewport: (absolutePosition: DeprecatedViewportPosition | SpinePosition, absoluteViewport: AbsoluteViewport, relativeViewport: RelativeViewport | AbsoluteViewport) => UnsafeSpinePosition;