@prose-reader/core 1.240.0 → 1.242.0

package/dist/navigation/InternalNavigator.d.ts

@@ -8,19 +8,20 @@ import { ControlledNavigationController } from './controllers/ControlledNavigati
 import { ScrollNavigationController } from './controllers/ScrollNavigationController';
 import { Locker } from './Locker';
 import { createNavigationResolver } from './resolvers/NavigationResolver';
-import { InternalNavigationEntry, UserNavigationEntry, DeprecatedViewportPosition, NavigationConsolidation } from './types';
+import { InternalNavigationEntry, UserNavigationEntry, NavigationConsolidation } from './types';
+import { UnboundSpinePosition } from '..';
 export declare class InternalNavigator extends DestroyableClass {
     protected settings: ReaderSettingsManager;
     protected context: Context;
     protected userNavigation$: Observable<UserNavigationEntry>;
-    protected viewportController: ControlledNavigationController;
+    protected controlledNavigationController: ControlledNavigationController;
     protected scrollNavigationController: ScrollNavigationController;
     protected navigationResolver: ReturnType<typeof createNavigationResolver>;
     protected spine: Spine;
     protected isUserLocked$: Observable<boolean>;
     navigationSubject: BehaviorSubject<InternalNavigationEntry>;
     navigated$: Observable<{
-        position: SpinePosition | DeprecatedViewportPosition;
+        position: SpinePosition | UnboundSpinePosition;
         id: symbol;
         meta: {
             triggeredBy: `user` | `restoration` | `pagination`;
@@ -32,10 +33,10 @@ export declare class InternalNavigator extends DestroyableClass {
         cfi?: string;
     } & NavigationConsolidation>;
     navigation$: Observable<{
-        position: SpinePosition;
+        position: SpinePosition | UnboundSpinePosition;
         id: symbol;
     }>;
     locker: Locker;
-    constructor(settings: ReaderSettingsManager, context: Context, userNavigation$: Observable<UserNavigationEntry>, viewportController: ControlledNavigationController, scrollNavigationController: ScrollNavigationController, navigationResolver: ReturnType<typeof createNavigationResolver>, spine: Spine, isUserLocked$: Observable<boolean>);
+    constructor(settings: ReaderSettingsManager, context: Context, userNavigation$: Observable<UserNavigationEntry>, controlledNavigationController: ControlledNavigationController, scrollNavigationController: ScrollNavigationController, navigationResolver: ReturnType<typeof createNavigationResolver>, spine: Spine, isUserLocked$: Observable<boolean>);
     get navigation(): InternalNavigationEntry;
 }

package/dist/navigation/Navigator.d.ts

@@ -8,9 +8,9 @@ import { ControlledNavigationController } from './controllers/ControlledNavigati
 import { ScrollNavigationController } from './controllers/ScrollNavigationController';
 import { InternalNavigator } from './InternalNavigator';
 import { Locker } from './Locker';
-import { UserNavigationEntry, InternalNavigationEntry, DeprecatedViewportPosition } from './types';
+import { UserNavigationEntry, InternalNavigationEntry } from './types';
 import { Observable } from 'rxjs';
-import { SpinePosition, SpineItemPosition, SpineItem } from '..';
+import { SpinePosition, SpineItemPosition, SpineItem, UnboundSpinePosition } from '..';
 import { getNavigationForSpineItemPage } from './resolvers/getNavigationForSpineItemPage';
 export declare const createNavigator: ({ spineItemsManager, context, hookManager, spine, settings, viewport, }: {
     spineItemsManager: SpineItemsManager;
@@ -39,13 +39,14 @@ export declare const createNavigator: ({ spineItemsManager, context, hookManager
             spineItemPosition: SpineItemPosition;
             spineItem: SpineItem;
         }) => 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;
+        getNavigationForCfi: (cfi: string) => SpinePosition | undefined;
+        getNavigationForLastPage: (spineItem: SpineItem) => SpinePosition;
+        getNavigationForSpineIndexOrId: (indexOrId: number | string | SpineItem) => SpinePosition;
+        getNavigationForPosition: (viewportPosition: SpinePosition | UnboundSpinePosition) => SpinePosition;
+        getMostPredominantNavigationForPosition: (viewportPosition: SpinePosition) => SpinePosition;
+        fromUnboundSpinePosition: (position: SpinePosition | UnboundSpinePosition) => SpinePosition;
+        fromOutOfBoundsSpinePosition: (position: SpinePosition | UnboundSpinePosition) => SpinePosition | UnboundSpinePosition;
+        isNavigationGoingForwardFrom: (to: SpinePosition, from: SpinePosition) => boolean;
         arePositionsDifferent: (a: {
             x: number;
             y: number;
@@ -53,7 +54,7 @@ export declare const createNavigator: ({ spineItemsManager, context, hookManager
             x: number;
             y: number;
         }) => boolean;
-        getAdjustedPositionForSpread: (position: DeprecatedViewportPosition | SpinePosition) => SpinePosition;
+        getAdjustedPositionForSpread: (position: SpinePosition | UnboundSpinePosition) => SpinePosition;
         spineItemNavigator: {
             getNavigationForLastPage: (spineItem: SpineItem) => SpineItemPosition;
             getNavigationForPosition: (spineItem: SpineItem, position: SpineItemPosition) => SpineItemPosition;
@@ -61,7 +62,7 @@ export declare const createNavigator: ({ spineItemsManager, context, hookManager
         };
     };
     navigation$: Observable<{
-        position: SpinePosition;
+        position: SpinePosition | UnboundSpinePosition;
         id: symbol;
     }>;
 };

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

@@ -1,13 +1,13 @@
 import { Observable } from 'rxjs';
 import { Context } from '../../context/Context';
 import { Spine } from '../../spine/Spine';
-import { InternalNavigationEntry, DeprecatedViewportPosition } from '../types';
-import { SpinePosition, SpineItemPosition } from '../..';
+import { InternalNavigationEntry } from '../types';
+import { SpinePosition, UnboundSpinePosition, SpineItemPosition, UnboundSpineItemPagePosition } from '../..';
 export declare const consolidateWithPagination: (context: Context, navigation$: Observable<InternalNavigationEntry>, spine: Spine) => Observable<{
     meta: {
         triggeredBy: "pagination";
     };
-    position: SpinePosition | DeprecatedViewportPosition;
+    position: SpinePosition | UnboundSpinePosition;
     id: symbol;
     type: `api` | `scroll`;
     animation?: boolean | `turn` | `snap`;
@@ -21,6 +21,6 @@ export declare const consolidateWithPagination: (context: Context, navigation$:
     spineItemIsReady?: boolean;
     spineItemIsUsingVerticalWriting?: boolean;
     paginationBeginCfi?: string;
-    positionInSpineItem?: SpineItemPosition;
+    positionInSpineItem?: SpineItemPosition | UnboundSpineItemPagePosition;
     directionFromLastNavigation?: "forward" | "backward" | "anchor";
 }>;

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

@@ -1,6 +1,9 @@
 import { Observable } from 'rxjs';
+import { NavigationResolver } from '../resolvers/NavigationResolver';
 import { InternalNavigationEntry, InternalNavigationInput, UserNavigationEntry } from '../types';
-export declare const mapUserNavigationToInternal: (stream: Observable<[UserNavigationEntry, InternalNavigationEntry]>) => Observable<{
+export declare const mapUserNavigationToInternal: ({ navigationResolver }: {
+    navigationResolver: NavigationResolver;
+}) => (stream: Observable<[UserNavigationEntry, InternalNavigationEntry]>) => Observable<{
     navigation: InternalNavigationInput;
     previousNavigation: InternalNavigationEntry;
 }>;

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

@@ -1,12 +1,15 @@
 import { Observable } from 'rxjs';
+import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
 import { NavigationResolver } from '../resolvers/NavigationResolver';
 import { InternalNavigationEntry, InternalNavigationInput } from '../types';
-export declare const withFallbackPosition: ({ spineItemsManager, navigationResolver, }: {
+export declare const withFallbackPosition: ({ spineItemsManager, navigationResolver, settings, }: {
     spineItemsManager: SpineItemsManager;
     navigationResolver: NavigationResolver;
+    settings: ReaderSettingsManager;
 }) => <Navigation extends {
     navigation: InternalNavigationInput;
+    previousNavigation: InternalNavigationEntry;
 }>(stream: Observable<Navigation>) => Observable<Omit<Navigation, "navigation"> & {
     navigation: InternalNavigationEntry;
 }>;

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

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

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

@@ -1,7 +1,7 @@
 import { Observable } from 'rxjs';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
-import { SpineItemsManager } from '../../spine/SpineItemsManager';
 import { SpineLocator } from '../../spine/locator/SpineLocator';
+import { SpineItemsManager } from '../../spine/SpineItemsManager';
 import { NavigationResolver } from '../resolvers/NavigationResolver';
 import { InternalNavigationEntry, InternalNavigationInput } from '../types';
 type Navigation = {

package/dist/navigation/controllers/ScrollNavigationController.d.ts

@@ -3,13 +3,15 @@ import { Context } from '../../context/Context';
 import { HookManager } from '../../hooks/HookManager';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { Spine } from '../../spine/Spine';
-import { SpinePosition } from '../../spine/types';
+import { SpinePosition, UnboundSpinePosition } from '../../spine/types';
 import { AbstractPosition } from '../../types';
 import { ReactiveEntity } from '../../utils/ReactiveEntity';
 import { Viewport } from '../../viewport/Viewport';
-import { ViewportNavigationEntry } from './ControlledNavigationController';
 export declare class ScrollPosition extends AbstractPosition {
 }
+export type ScrollNavigationViewportNavigationEntry = {
+    position: UnboundSpinePosition | SpinePosition;
+};
 export declare class ScrollNavigationController extends ReactiveEntity<{
     element: HTMLElement | undefined;
 }> {
@@ -18,18 +20,18 @@ export declare class ScrollNavigationController extends ReactiveEntity<{
     protected hookManager: HookManager;
     protected spine: Spine;
     protected context: Context;
-    protected navigateSubject: Subject<ViewportNavigationEntry>;
+    protected navigateSubject: Subject<ScrollNavigationViewportNavigationEntry>;
     protected scrollingSubject: BehaviorSubject<boolean>;
     isScrolling$: Observable<boolean>;
     isNavigating$: Observable<boolean>;
     userScroll$: Observable<Event>;
     constructor(viewport: Viewport, settings: ReaderSettingsManager, hookManager: HookManager, spine: Spine, context: Context);
-    protected setViewportPosition: ({ position }: ViewportNavigationEntry) => void;
+    protected setViewportPosition: ({ position, }: ScrollNavigationViewportNavigationEntry) => void;
     update(value: Partial<{
         element: HTMLElement | undefined;
     }>): void;
-    navigate(navigation: ViewportNavigationEntry): void;
-    fromScrollPosition(position: ScrollPosition): SpinePosition;
-    fromSpinePosition(position: SpinePosition): ScrollPosition;
+    navigate(navigation: ScrollNavigationViewportNavigationEntry): void;
+    fromScrollPosition(position: ScrollPosition): UnboundSpinePosition;
+    fromSpinePosition(position: UnboundSpinePosition | SpinePosition): ScrollPosition;
     get scrollPosition(): ScrollPosition;
 }

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

@@ -3,11 +3,10 @@ import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { SpineLocator } from '../../spine/locator/SpineLocator';
 import { Spine } from '../../spine/Spine';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
-import { SpinePosition } from '../../spine/types';
+import { SpinePosition, UnboundSpinePosition } from '../../spine/types';
 import { SpineItem } from '../../spineItem/SpineItem';
 import { SpineItemPosition } from '../../spineItem/types';
 import { Viewport } from '../../viewport/Viewport';
-import { DeprecatedViewportPosition } from '../types';
 import { getNavigationForSpineItemPage } from './getNavigationForSpineItemPage';
 export declare const NAMESPACE = "spineNavigator";
 export type NavigationResolver = ReturnType<typeof createNavigationResolver>;
@@ -28,13 +27,14 @@ export declare const createNavigationResolver: ({ context, spineItemsManager, lo
         spineItemPosition: SpineItemPosition;
         spineItem: SpineItem;
     }) => 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;
+    getNavigationForCfi: (cfi: string) => SpinePosition | undefined;
+    getNavigationForLastPage: (spineItem: SpineItem) => SpinePosition;
+    getNavigationForSpineIndexOrId: (indexOrId: number | string | SpineItem) => SpinePosition;
+    getNavigationForPosition: (viewportPosition: SpinePosition | UnboundSpinePosition) => SpinePosition;
+    getMostPredominantNavigationForPosition: (viewportPosition: SpinePosition) => SpinePosition;
+    fromUnboundSpinePosition: (position: SpinePosition | UnboundSpinePosition) => SpinePosition;
+    fromOutOfBoundsSpinePosition: (position: SpinePosition | UnboundSpinePosition) => SpinePosition | UnboundSpinePosition;
+    isNavigationGoingForwardFrom: (to: SpinePosition, from: SpinePosition) => boolean;
     arePositionsDifferent: (a: {
         x: number;
         y: number;
@@ -42,7 +42,7 @@ export declare const createNavigationResolver: ({ context, spineItemsManager, lo
         x: number;
         y: number;
     }) => boolean;
-    getAdjustedPositionForSpread: (position: DeprecatedViewportPosition | SpinePosition) => SpinePosition;
+    getAdjustedPositionForSpread: (position: SpinePosition | UnboundSpinePosition) => SpinePosition;
     spineItemNavigator: {
         getNavigationForLastPage: (spineItem: SpineItem) => SpineItemPosition;
         getNavigationForPosition: (spineItem: SpineItem, position: SpineItemPosition) => SpineItemPosition;

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

@@ -0,0 +1,20 @@
+import { Spine } from '../../spine/Spine';
+import { SpineItemsManager } from '../../spine/SpineItemsManager';
+import { SpinePosition, UnboundSpinePosition } from '../../spine/types';
+export declare const NAMESPACE = "spineNavigator";
+type SharedParams = {
+    isRTL: boolean;
+    spineItemsManager: SpineItemsManager;
+    spine: Spine;
+    viewportWidth: number;
+};
+export declare function fromOutOfBoundsSpinePosition(params: SharedParams & {
+    position: SpinePosition;
+}): SpinePosition;
+export declare function fromOutOfBoundsSpinePosition(params: SharedParams & {
+    position: UnboundSpinePosition;
+}): UnboundSpinePosition;
+export declare function fromOutOfBoundsSpinePosition(params: SharedParams & {
+    position: UnboundSpinePosition | SpinePosition;
+}): UnboundSpinePosition | SpinePosition;
+export {};

package/dist/navigation/resolvers/{getAdjustedPositionWithSafeEdge.d.ts → fromUnboundSpinePosition.d.ts}

@@ -1,10 +1,9 @@
 import { Spine } from '../../spine/Spine';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
-import { SpinePosition } from '../../spine/types';
-import { DeprecatedViewportPosition } from '../types';
+import { SpinePosition, UnboundSpinePosition } from '../../spine/types';
 export declare const NAMESPACE = "spineNavigator";
-export declare const getAdjustedPositionWithSafeEdge: ({ position, isRTL, pageSizeHeight, spineItemsManager, visibleAreaRectWidth, spine, }: {
-    position: DeprecatedViewportPosition | SpinePosition;
+export declare const fromUnboundSpinePosition: ({ position, isRTL, pageSizeHeight, spineItemsManager, visibleAreaRectWidth, spine, }: {
+    position: SpinePosition | UnboundSpinePosition;
     isRTL: boolean;
     pageSizeHeight: number;
     spineItemsManager: SpineItemsManager;

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

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

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

@@ -1,10 +1,9 @@
 import { SpineLocator } from '../../spine/locator/SpineLocator';
-import { SpinePosition } from '../../spine/types';
+import { SpinePosition, UnboundSpinePosition } from '../../spine/types';
 import { SpineItemNavigationResolver } from '../../spineItem/navigationResolver';
 import { Viewport } from '../../viewport/Viewport';
-import { DeprecatedViewportPosition } from '../types';
 export declare const getNavigationForPosition: ({ viewportPosition, spineLocator, spineItemNavigationResolver, viewport, }: {
-    viewportPosition: DeprecatedViewportPosition | SpinePosition;
+    viewportPosition: SpinePosition | UnboundSpinePosition;
     spineLocator: SpineLocator;
     spineItemNavigationResolver: SpineItemNavigationResolver;
     viewport: Viewport;

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

@@ -1,9 +1,9 @@
 import { SpineLocator } from '../../spine/locator/SpineLocator';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
+import { SpinePosition } from '../../spine/types';
 import { SpineItemNavigationResolver } from '../../spineItem/navigationResolver';
 import { SpineItem } from '../../spineItem/SpineItem';
 import { Viewport } from '../../viewport/Viewport';
-import { DeprecatedViewportPosition } from '../types';
 export declare const getNavigationForSpineItemPage: ({ pageIndex, spineItemsManager, spineItemId, spineLocator, spineItemNavigationResolver, viewport, }: {
     pageIndex: number;
     spineItemId: SpineItem | number | string;
@@ -11,4 +11,4 @@ export declare const getNavigationForSpineItemPage: ({ pageIndex, spineItemsMana
     spineItemNavigationResolver: SpineItemNavigationResolver;
     spineLocator: SpineLocator;
     viewport: Viewport;
-}) => DeprecatedViewportPosition;
+}) => SpinePosition;

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

@@ -1,13 +1,13 @@
 import { Observable } from 'rxjs';
 import { Context } from '../../context/Context';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
+import { SpineLocator } from '../../spine/locator/SpineLocator';
 import { Spine } from '../../spine/Spine';
 import { SpineItemsManager } from '../../spine/SpineItemsManager';
-import { SpineLocator } from '../../spine/locator/SpineLocator';
-import { SpinePosition } from '../../spine/types';
+import { SpinePosition, UnboundSpinePosition } from '../../spine/types';
 import { SpineItemLocator } from '../../spineItem/locationResolver';
 import { NavigationResolver } from '../resolvers/NavigationResolver';
-import { DeprecatedViewportPosition, InternalNavigationEntry } from '../types';
+import { InternalNavigationEntry } from '../types';
 export declare const restorePosition: ({ navigation, spineItemsManager, settings, spineLocator, navigationResolver, spine, }: {
     spineLocator: SpineLocator;
     settings: ReaderSettingsManager;
@@ -17,4 +17,4 @@ export declare const restorePosition: ({ navigation, spineItemsManager, settings
     spineItemLocator: SpineItemLocator;
     context: Context;
     spine: Spine;
-}) => Observable<DeprecatedViewportPosition | SpinePosition>;
+}) => Observable<SpinePosition | UnboundSpinePosition>;

package/dist/navigation/types.d.ts

@@ -1,8 +1,7 @@
-import { SpinePosition, UnsafeSpinePosition } from '../spine/types';
-import { SpineItemPosition } from '../spineItem/types';
-export type DeprecatedViewportPosition = SpinePosition;
+import { SpinePosition, UnboundSpinePosition } from '../spine/types';
+import { SpineItemPosition, UnboundSpineItemPagePosition } from '../spineItem/types';
 export type UserNavigationEntry = {
-    position?: DeprecatedViewportPosition | SpinePosition | UnsafeSpinePosition;
+    position?: SpinePosition | UnboundSpinePosition;
     spineItem?: number | string;
     url?: string | URL;
     cfi?: string;
@@ -18,11 +17,11 @@ export type NavigationConsolidation = {
     spineItemIsReady?: boolean;
     spineItemIsUsingVerticalWriting?: boolean;
     paginationBeginCfi?: string;
-    positionInSpineItem?: SpineItemPosition;
+    positionInSpineItem?: SpineItemPosition | UnboundSpineItemPagePosition;
     directionFromLastNavigation?: "forward" | "backward" | "anchor";
 };
 export type InternalNavigationEntry = {
-    position: SpinePosition | DeprecatedViewportPosition;
+    position: SpinePosition | UnboundSpinePosition;
     id: symbol;
     meta: {
         triggeredBy: `user` | `restoration` | `pagination`;
@@ -34,6 +33,6 @@ export type InternalNavigationEntry = {
     cfi?: string;
 } & NavigationConsolidation;
 export type InternalNavigationInput = Omit<InternalNavigationEntry, "position"> & {
-    position?: SpinePosition | DeprecatedViewportPosition;
+    position?: SpinePosition | UnboundSpinePosition;
 };
 export type Navigation = Pick<InternalNavigationEntry, "position" | "id">;

package/dist/reader.d.ts

@@ -12,7 +12,7 @@ import { SpineItem, SpineItemReference } from './spineItem/SpineItem';
 import { Viewport } from './viewport/Viewport';
 import { CoreHook } from './hooks';
 import { Manifest } from '@prose-reader/shared';
-import { InternalNavigationEntry, InternalNavigator, ScrollNavigationController, ControlledNavigationController, Locker, UserNavigationEntry, SpinePosition, SpineItemPosition, DeprecatedViewportPosition, SpineItemsObserver, CoreOutputSettings } from '.';
+import { InternalNavigationEntry, InternalNavigator, ScrollNavigationController, ControlledNavigationController, Locker, UserNavigationEntry, SpinePosition, SpineItemPosition, UnboundSpinePosition, SpineItemsObserver, CoreOutputSettings } from '.';
 import { getNavigationForSpineItemPage } from './navigation/resolvers/getNavigationForSpineItemPage';
 import { PaginationInfo } from './pagination';
 export type CreateReaderOptions = Partial<CoreInputSettings>;
@@ -67,13 +67,14 @@ export declare const createReader: (inputSettings: CreateReaderOptions) => {
                 spineItemPosition: SpineItemPosition;
                 spineItem: SpineItem;
             }) => 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;
+            getNavigationForCfi: (cfi: string) => SpinePosition | undefined;
+            getNavigationForLastPage: (spineItem: SpineItem) => SpinePosition;
+            getNavigationForSpineIndexOrId: (indexOrId: number | string | SpineItem) => SpinePosition;
+            getNavigationForPosition: (viewportPosition: SpinePosition | UnboundSpinePosition) => SpinePosition;
+            getMostPredominantNavigationForPosition: (viewportPosition: SpinePosition) => SpinePosition;
+            fromUnboundSpinePosition: (position: SpinePosition | UnboundSpinePosition) => SpinePosition;
+            fromOutOfBoundsSpinePosition: (position: SpinePosition | UnboundSpinePosition) => SpinePosition | UnboundSpinePosition;
+            isNavigationGoingForwardFrom: (to: SpinePosition, from: SpinePosition) => boolean;
             arePositionsDifferent: (a: {
                 x: number;
                 y: number;
@@ -81,7 +82,7 @@ export declare const createReader: (inputSettings: CreateReaderOptions) => {
                 x: number;
                 y: number;
             }) => boolean;
-            getAdjustedPositionForSpread: (position: DeprecatedViewportPosition | SpinePosition) => SpinePosition;
+            getAdjustedPositionForSpread: (position: SpinePosition | UnboundSpinePosition) => SpinePosition;
             spineItemNavigator: {
                 getNavigationForLastPage: (spineItem: SpineItem) => SpineItemPosition;
                 getNavigationForPosition: (spineItem: SpineItem, position: SpineItemPosition) => SpineItemPosition;
@@ -89,7 +90,7 @@ export declare const createReader: (inputSettings: CreateReaderOptions) => {
             };
         };
         navigation$: Observable<{
-            position: SpinePosition;
+            position: SpinePosition | UnboundSpinePosition;
             id: symbol;
         }>;
     };

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

@@ -2,9 +2,9 @@ import { Context } from '../../context/Context';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { SpineItem } from '../../spineItem/SpineItem';
 import { DestroyableClass } from '../../utils/DestroyableClass';
+import { SpineLocator } from '../locator/SpineLocator';
 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

@@ -7,10 +7,10 @@ import { ViewportSlicePosition } from '../../viewport/types';
 import { Viewport } from '../../viewport/Viewport';
 import { SpineItemsManager } from '../SpineItemsManager';
 import { SpineLayout } from '../SpineLayout';
-import { SpinePosition, UnsafeSpinePosition } from '../types';
+import { SpinePosition, UnboundSpinePosition } from '../types';
 import { getAbsolutePageIndexFromPageIndex } from './getAbsolutePageIndexFromPageIndex';
 import { getVisibleSpineItemsFromPosition } from './getVisibleSpineItemsFromPosition';
-import { UnsafeSpineItemPagePosition } from '../..';
+import { UnboundSpineItemPagePosition } from '../..';
 export type SpineLocator = ReturnType<typeof createSpineLocator>;
 export declare const createSpineLocator: ({ spineItemsManager, context, spineItemLocator, settings, spineLayout, viewport, }: {
     spineItemsManager: SpineItemsManager;
@@ -25,18 +25,18 @@ export declare const createSpineLocator: ({ spineItemsManager, context, spineIte
         spineItem: SpineItem;
     }) => SpinePosition;
     _getAbsolutePageIndexFromPageIndex: (params: Omit<Parameters<typeof getAbsolutePageIndexFromPageIndex>[0], "context" | "settings" | "spineLayout" | "spineItemsManager">) => number | undefined;
-    getSpineItemPagePositionFromSpinePosition: (spinePosition: UnsafeSpinePosition | SpinePosition) => {
+    getSpineItemPagePositionFromSpinePosition: (spinePosition: UnboundSpinePosition | SpinePosition) => {
         spineItem: SpineItem;
         spineItemPageIndex: number;
-        spineItemPagePosition: UnsafeSpineItemPagePosition;
+        spineItemPagePosition: UnboundSpineItemPagePosition;
         pageSize: {
             width: number;
             height: number;
         };
     } | undefined;
     getSpinePositionFromSpineItem: (spineItem: SpineItem) => SpinePosition;
-    getSpineItemPositionFromSpinePosition: (position: SpinePosition | UnsafeSpinePosition, spineItem: SpineItem) => SpineItemPosition;
-    getSpineItemFromPosition: (position: SpinePosition) => SpineItem | undefined;
+    getSpineItemPositionFromSpinePosition: (position: SpinePosition | UnboundSpinePosition, spineItem: SpineItem) => SpineItemPosition;
+    getSpineItemFromPosition: (position: SpinePosition | UnboundSpinePosition) => 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], "spineItemsManager" | "settings" | "spineLayout" | "viewport">) => {
@@ -44,7 +44,7 @@ export declare const createSpineLocator: ({ spineItemsManager, context, spineIte
         endIndex: number;
     } | undefined;
     getVisiblePagesFromViewportPosition: (params: Omit<Parameters<({ position, threshold, spineItem, restrictToScreen, useAbsoluteViewport, viewport, }: {
-        position: SpinePosition;
+        position: SpinePosition | UnboundSpinePosition;
         threshold: {
             type: "percentage";
             value: number;
@@ -63,7 +63,7 @@ export declare const createSpineLocator: ({ spineItemsManager, context, spineIte
         beginPageIndex: number;
         endPageIndex: number;
     } | undefined;
-    isPositionWithinSpineItem: (position: ViewportSlicePosition | SpinePosition, spineItem: SpineItem) => boolean;
+    isPositionWithinSpineItem: (position: ViewportSlicePosition | SpinePosition | UnboundSpinePosition, spineItem: SpineItem) => boolean;
     spineItemLocator: {
         getSpineItemPositionFromNode: (node: Node, offset: number, spineItem: SpineItem) => SpineItemPosition | undefined;
         getSpineItemPositionFromPageIndex: ({ pageIndex, spineItem, }: {
@@ -78,7 +78,7 @@ export declare const createSpineLocator: ({ spineItemsManager, context, spineIte
         }) => number;
         getSpineItemPageIndexFromNode: (node: Node, offset: number, spineItem: SpineItem) => number | undefined;
         getSpineItemClosestPositionFromUnsafePosition: (unsafePosition: SpineItemPosition, spineItem: SpineItem) => SpineItemPosition;
-        getSpineItemPagePositionFromSpineItemPosition: (position: SpineItemPosition, pageIndex: number, spineItem: SpineItem) => UnsafeSpineItemPagePosition;
+        getSpineItemPagePositionFromSpineItemPosition: (position: SpineItemPosition, pageIndex: number, spineItem: SpineItem) => UnboundSpineItemPagePosition;
     };
     getSafeSpineItemPositionFromUnsafeSpineItemPosition: (unsafePosition: SpineItemPosition, spineItem: SpineItem) => SpineItemPosition;
 };

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

@@ -1,10 +1,9 @@
-import { DeprecatedViewportPosition } from '../../navigation/types';
 import { SpineItemsManager } from '../SpineItemsManager';
 import { SpineLayout } from '../SpineLayout';
-import { SpinePosition, UnsafeSpinePosition } from '../types';
+import { SpinePosition, UnboundSpinePosition } from '../types';
 import { SpineItem } from '../..';
 export declare const getSpineItemFromPosition: ({ position, spineItemsManager, spineLayout, }: {
-    position: DeprecatedViewportPosition | SpinePosition | UnsafeSpinePosition;
+    position: SpinePosition | SpinePosition | UnboundSpinePosition;
     spineItemsManager: SpineItemsManager;
     spineLayout: SpineLayout;
 }) => SpineItem | undefined;

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

@@ -1,11 +1,10 @@
-import { DeprecatedViewportPosition } from '../../navigation/types';
 import { ReaderSettingsManager } from '../../settings/ReaderSettingsManager';
 import { Viewport } from '../../viewport/Viewport';
 import { SpineItemsManager } from '../SpineItemsManager';
 import { SpineLayout } from '../SpineLayout';
-import { SpinePosition } from '../types';
+import { SpinePosition, UnboundSpinePosition } from '../types';
 export declare const getVisibleSpineItemsFromPosition: ({ position, threshold, restrictToScreen, spineItemsManager, spineLayout, useAbsoluteViewport, viewport, }: {
-    position: DeprecatedViewportPosition | SpinePosition;
+    position: SpinePosition | UnboundSpinePosition;
     threshold: {
         type: "percentage";
         value: number;

package/dist/spine/types.d.ts

@@ -15,9 +15,9 @@ export declare class AbstractSpinePosition {
 }
 export declare class SpinePosition extends AbstractSpinePosition {
     readonly __symbol = "SpinePosition";
-    static from(position: UnsafeSpinePosition | SpinePosition): SpinePosition;
+    static from(position: UnboundSpinePosition | SpinePosition): SpinePosition;
 }
-export declare class UnsafeSpinePosition extends AbstractSpinePosition {
-    readonly __symbol = "UnsafeSpinePosition";
-    static from(position: SpinePosition): UnsafeSpinePosition;
+export declare class UnboundSpinePosition extends AbstractSpinePosition {
+    readonly __symbol = "UnboundSpinePosition";
+    static from(position: SpinePosition): UnboundSpinePosition;
 }

package/dist/spineItem/locationResolver.d.ts

@@ -2,7 +2,7 @@ import { Context } from '../context/Context';
 import { ReaderSettingsManager } from '../settings/ReaderSettingsManager';
 import { Viewport } from '../viewport/Viewport';
 import { SpineItem } from './SpineItem';
-import { SpineItemPosition, UnsafeSpineItemPagePosition } from './types';
+import { SpineItemPosition, UnboundSpineItemPagePosition } from './types';
 export type SpineItemLocator = ReturnType<typeof createSpineItemLocator>;
 export declare const createSpineItemLocator: ({ context, settings, viewport, }: {
     context: Context;
@@ -22,5 +22,5 @@ export declare const createSpineItemLocator: ({ context, settings, viewport, }:
     }) => number;
     getSpineItemPageIndexFromNode: (node: Node, offset: number, spineItem: SpineItem) => number | undefined;
     getSpineItemClosestPositionFromUnsafePosition: (unsafePosition: SpineItemPosition, spineItem: SpineItem) => SpineItemPosition;
-    getSpineItemPagePositionFromSpineItemPosition: (position: SpineItemPosition, pageIndex: number, spineItem: SpineItem) => UnsafeSpineItemPagePosition;
+    getSpineItemPagePositionFromSpineItemPosition: (position: SpineItemPosition, pageIndex: number, spineItem: SpineItem) => UnboundSpineItemPagePosition;
 };

package/dist/spineItem/types.d.ts

@@ -27,7 +27,7 @@ export declare class SpineItemPosition {
         y: number;
     });
 }
-export declare class UnsafeSpineItemPagePosition {
+export declare class UnboundSpineItemPagePosition {
     readonly x: number;
     readonly y: number;
     readonly __symbol: symbol;

package/dist/viewport/translateSpinePositionToRelativeViewport.d.ts

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

package/dist/viewport/types.d.ts

@@ -1,4 +1,4 @@
-import { SpinePosition, UnsafeSpinePosition } from '../spine/types';
+import { SpinePosition, UnboundSpinePosition } from '../spine/types';
 export declare class ViewportSlicePosition extends DOMRect {
     readonly __symbol: symbol;
     static from(rect: {
@@ -7,7 +7,7 @@ export declare class ViewportSlicePosition extends DOMRect {
         width: number;
         height: number;
     }): ViewportSlicePosition;
-    static from(position: SpinePosition | UnsafeSpinePosition, viewport: AbsoluteViewport | RelativeViewport): ViewportSlicePosition;
+    static from(position: SpinePosition | UnboundSpinePosition, viewport: AbsoluteViewport | RelativeViewport): ViewportSlicePosition;
 }
 export declare class AbsoluteViewport {
     width: number;