@d-i-t-a/reader 2.4.10 → 2.5.0

package/dist/types/index.d.ts

@@ -4,4 +4,8 @@ export default D2Reader;
 /** for interop with \<script\> based usage */
 export declare const load: typeof D2Reader.load;
 export { Link } from "./model/Link";
-export { Locator, ReadingPosition } from "./model/Locator";
+export { Locator, Locations, LocatorText, ReadingPosition, Bookmark, Annotation, AnnotationMarker, } from "./model/Locator";
+export type { ReaderConfig, ReaderRights, NavigatorAPI, IFrameAttributes, Injectable, RequestConfig, SampleRead, PublicationServices, InitialAnnotations, } from "./navigator/IFrameNavigator";
+export type { IUserSettings, InitialUserSettings, } from "./model/user-settings/UserSettings";
+export type { UserSettingsIncrementable } from "./model/user-settings/UserProperties";
+export type { LocalStorageStoreConfig } from "./store/LocalStorageStore";

package/dist/types/model/user-settings/ReadiumCSS.d.ts

@@ -4,6 +4,7 @@ export declare class ReadiumCSS {
     static readonly FONT_OVERRIDE_REF = "fontOverride";
     static readonly APPEARANCE_REF = "appearance";
     static readonly SCROLL_REF = "scroll";
+    static readonly ADVANCED_SETTINGS_REF = "advancedSettings";
     static readonly TEXT_ALIGNMENT_REF = "textAlign";
     static readonly COLUMN_COUNT_REF = "colCount";
     static readonly DIRECTION_REF = "direction";
@@ -11,11 +12,18 @@ export declare class ReadiumCSS {
     static readonly LETTER_SPACING_REF = "letterSpacing";
     static readonly PAGE_MARGINS_REF = "pageMargins";
     static readonly LINE_HEIGHT_REF = "lineHeight";
+    static readonly BODY_HYPHENS_REF = "bodyHyphens";
+    static readonly PARA_SPACING_REF = "paraSpacing";
+    static readonly PARA_INDENT_REF = "paraIndent";
+    static readonly TYPE_SCALE_REF = "typeScale";
+    static readonly BACKGROUND_COLOR_REF = "backgroundColor";
+    static readonly TEXT_COLOR_REF = "textColor";
     static readonly FONT_SIZE_KEY: string;
     static readonly FONT_FAMILY_KEY: string;
     static readonly FONT_OVERRIDE_KEY: string;
     static readonly APPEARANCE_KEY: string;
     static readonly SCROLL_KEY: string;
+    static readonly ADVANCED_SETTINGS_KEY: string;
     static readonly TEXT_ALIGNMENT_KEY: string;
     static readonly COLUMN_COUNT_KEY: string;
     static readonly DIRECTION_KEY: string;
@@ -23,4 +31,10 @@ export declare class ReadiumCSS {
     static readonly LETTER_SPACING_KEY: string;
     static readonly PAGE_MARGINS_KEY: string;
     static readonly LINE_HEIGHT_KEY: string;
+    static readonly BODY_HYPHENS_KEY: string;
+    static readonly PARA_SPACING_KEY: string;
+    static readonly PARA_INDENT_KEY: string;
+    static readonly TYPE_SCALE_KEY: string;
+    static readonly BACKGROUND_COLOR_KEY: string;
+    static readonly TEXT_COLOR_KEY: string;
 }

package/dist/types/model/user-settings/UserProperties.d.ts

@@ -20,7 +20,7 @@ export declare class Enumerable extends UserProperty {
     constructor(value: any, values: Array<any>, ref: string, name: string);
     toString(): string;
 }
-export type UserSettingsIncrementable = "fontSize" | "letterSpacing" | "lineHeight" | "wordSpacing";
+export type UserSettingsIncrementable = "fontSize" | "letterSpacing" | "lineHeight" | "wordSpacing" | "paraSpacing" | "paraIndent" | "typeScale";
 export declare class Incremental extends UserProperty {
     value: number;
     min: number;

package/dist/types/model/user-settings/UserSettings.d.ts

@@ -5,7 +5,7 @@ import BookView from "../../views/BookView";
 export interface UserSettingsConfig {
     /** Store to save the user's selections in. */
     store: Store;
-    initialUserSettings: InitialUserSettings;
+    initialUserSettings?: Partial<InitialUserSettings>;
     headerMenu?: HTMLElement | null;
     api?: Partial<NavigatorAPI>;
     injectables?: Array<Injectable>;
@@ -40,6 +40,12 @@ export interface IUserSettings {
     letterSpacing: number;
     pageMargins: number;
     lineHeight: number;
+    bodyHyphens: boolean;
+    paraSpacing: number;
+    paraIndent: number;
+    typeScale: number;
+    backgroundColor: string;
+    textColor: string;
 }
 /**
  * The settings that someone might pass in when instantiating
@@ -59,6 +65,12 @@ export interface InitialUserSettings {
     letterSpacing: number;
     pageMargins: number;
     lineHeight: number;
+    bodyHyphens?: boolean;
+    paraSpacing?: number;
+    paraIndent?: number;
+    typeScale?: number;
+    backgroundColor?: string;
+    textColor?: string;
 }
 export declare class UserSettings implements IUserSettings {
     isPaginated(): Promise<boolean>;
@@ -82,6 +94,12 @@ export declare class UserSettings implements IUserSettings {
     letterSpacing: number;
     pageMargins: number;
     lineHeight: number;
+    bodyHyphens: boolean;
+    paraSpacing: number;
+    paraIndent: number;
+    typeScale: number;
+    backgroundColor: string;
+    textColor: string;
     userProperties?: UserProperties;
     view: BookView;
     private settingsChangeCallback;
@@ -130,6 +148,12 @@ export declare class UserSettings implements IUserSettings {
         letterSpacing: number;
         pageMargins: number;
         lineHeight: number;
+        bodyHyphens: boolean;
+        paraSpacing: number;
+        paraIndent: number;
+        typeScale: number;
+        backgroundColor: string;
+        textColor: string;
     };
     applyUserSettings(userSettings: Partial<UserSettings>): Promise<void>;
     /**
@@ -139,5 +163,5 @@ export declare class UserSettings implements IUserSettings {
     private static parseAppearanceSetting;
     scroll(scroll: boolean): Promise<void>;
     increase(incremental: UserSettingsIncrementable): Promise<void>;
-    decrease(incremental: any): Promise<void>;
+    decrease(incremental: UserSettingsIncrementable): Promise<void>;
 }

package/dist/types/modules/AnnotationModule.d.ts

@@ -23,7 +23,7 @@ export interface AnnotationModuleConfig extends AnnotationModuleProperties {
     headerMenu?: HTMLElement | null;
     rights: Partial<ReaderRights>;
     publication: Publication;
-    initialAnnotations?: any;
+    initialAnnotations?: import("../navigator/IFrameNavigator").InitialAnnotations;
     api?: AnnotationModuleAPI;
     highlighter: TextHighlighter;
 }
@@ -35,7 +35,7 @@ export declare class AnnotationModule implements ReaderModule {
     private commentGutter?;
     private readonly headerMenu?;
     private readonly highlighter?;
-    private readonly initialAnnotations;
+    private readonly initialAnnotations?;
     navigator: IFrameNavigator;
     properties?: AnnotationModuleProperties;
     api?: AnnotationModuleAPI;

package/dist/types/modules/BookmarkModule.d.ts

@@ -16,7 +16,7 @@ export interface BookmarkModuleConfig extends BookmarkModuleProperties {
     headerMenu?: HTMLElement | null;
     rights: Partial<ReaderRights>;
     publication: Publication;
-    initialAnnotations?: any;
+    initialAnnotations?: import("../navigator/IFrameNavigator").InitialAnnotations;
     properties?: BookmarkModuleProperties;
     api?: BookmarkModuleAPI;
 }
@@ -27,7 +27,7 @@ export declare class BookmarkModule implements ReaderModule {
     private bookmarksView;
     private sideNavSectionBookmarks;
     private readonly headerMenu?;
-    private readonly initialAnnotations;
+    private readonly initialAnnotations?;
     navigator: IFrameNavigator;
     private readonly properties;
     private readonly api?;

package/dist/types/modules/ReaderModule.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Base interface for all optional reader feature modules.
+ * Each module must implement `stop()` to clean up event listeners and resources
+ * when the reader is destroyed.
+ */
 export interface ReaderModule {
+    stop(): void;
 }

package/dist/types/modules/citation/CitationModule.d.ts

@@ -25,8 +25,8 @@ export interface CitationModuleProperties {
     published?: string;
 }
 export interface CitationModuleAPI {
-    citationCreated: any;
-    citationFailed: any;
+    citationCreated: (message: string) => void;
+    citationFailed: (message: string) => void;
 }
 export interface CitationModuleConfig extends CitationModuleProperties {
     publication: Publication;
@@ -42,8 +42,24 @@ export default class CitationModule implements ReaderModule {
     private constructor();
     static create(config: CitationModuleConfig): Promise<CitationModule>;
     stop(): Promise<void>;
-    copyToClipboard(textToClipboard: any): void;
-    createElementForExecCommand(textToClipboard: any): HTMLDivElement;
-    selectContent(element: any): void;
+    copyToClipboard(textToClipboard: string): void;
+    /** Fallback clipboard copy using deprecated execCommand — used when the
+     *  Clipboard API is unavailable (e.g. non-secure context). */
+    private legacyCopyToClipboard;
+    selectContent(element: HTMLElement): void;
+    private authorsFormatted;
+    private yearPublishedFormatted;
+    private bookTitleFormatted;
+    private editionFormatted;
+    private publisherFormatted;
+    private contributorsFormatted;
+    private eBookVersionFormatted;
+    private locationFormatted;
+    private libraryFormatted;
+    private appNameFormatted;
+    private appLinkFormatted;
+    private seriesFormatted;
+    private selectedText;
+    private buildCitation;
     protected start(): Promise<void>;
 }

package/dist/types/modules/highlight/TextHighlighter.d.ts

@@ -58,6 +58,7 @@ export interface TextHighlighterProperties {
 export interface TextHighlighterConfig extends TextHighlighterProperties {
     api?: TextSelectorAPI;
     layerSettings: LayerSettings;
+    colors?: string[];
 }
 export declare class TextHighlighter {
     private options;
@@ -68,6 +69,7 @@ export declare class TextHighlighter {
     private api?;
     private hasEventListener;
     activeAnnotationMarkerId?: string;
+    colors: string[];
     static create(config: TextHighlighterConfig): Promise<any>;
     private constructor();
     initialize(iframe: HTMLIFrameElement): Promise<void>;

package/dist/types/modules/mediaoverlays/MediaOverlayModule.d.ts

@@ -45,6 +45,7 @@ export declare class MediaOverlayModule implements ReaderModule {
     private mediaOverlayTextAudioPair;
     private pid;
     private __ontimeupdate;
+    private clickHandler;
     static create(config: MediaOverlayModuleConfig): MediaOverlayModule;
     private constructor();
     stop(): void;
@@ -52,6 +53,9 @@ export declare class MediaOverlayModule implements ReaderModule {
     initialize(): Promise<void>;
     initializeResource(links: Array<Link | undefined>): Promise<void>;
     private playLink;
+    private bindClickHandler;
+    private unbindClickHandler;
+    private handleContentClick;
     startReadAloud(): Promise<void>;
     stopReadAloud(): Promise<void>;
     pauseReadAloud(): void;

package/dist/types/modules/protection/ContentProtectionModule.d.ts

@@ -96,8 +96,7 @@ export declare class ContentProtectionModule implements ReaderModule {
     }): false | undefined;
     restrictCopyKey(event: any): boolean;
     copyToClipboard(textToClipboard: string | undefined): void;
-    createElementForExecCommand(textToClipboard: any): HTMLDivElement;
-    selectContent(element: any): void;
+    private execCommandCopy;
     beforePrint(event: {
         preventDefault: () => void;
         stopPropagation: () => void;

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

@@ -28,17 +28,19 @@ export interface RequestConfig extends RequestInit {
     encoded?: boolean;
 }
 export interface NavigatorAPI {
-    updateSettings: any;
+    updateSettings?: (settings: Record<string, unknown>) => Promise<void>;
     getContent: GetContent;
     getContentBytesLength: GetContentBytesLength;
-    resourceReady: any;
-    resourceAtStart: any;
-    resourceAtEnd: any;
-    resourceFitsScreen: any;
-    updateCurrentLocation: any;
-    keydownFallthrough: any;
-    clickThrough: any;
-    direction: any;
+    resourceReady?: () => void;
+    resourceAtStart?: () => void;
+    resourceAtEnd?: () => void;
+    resourceFitsScreen?: () => void;
+    updateCurrentLocation?: (locator: import("../model/Locator").ReadingPosition) => Promise<void>;
+    positionInfo?: (locator: import("../model/Locator").Locator) => void;
+    chapterInfo?: (title: string | undefined) => void;
+    keydownFallthrough?: (event: KeyboardEvent | undefined) => void;
+    clickThrough?: (event: MouseEvent | TouchEvent) => void;
+    direction?: (dir: string) => void;
     onError?: (e: Error) => void;
 }
 export interface IFrameAttributes {
@@ -47,6 +49,10 @@ export interface IFrameAttributes {
     iframePaddingTop?: number;
     bottomInfoHeight?: number;
     sideNavPosition?: "left" | "right";
+    /** Margin (in px) around fixed-layout content. Defaults to 100. */
+    fixedLayoutMargin?: number;
+    /** Whether to show a drop shadow on fixed-layout spreads. Defaults to true. */
+    fixedLayoutShadow?: boolean;
 }
 export interface IFrameNavigatorConfig {
     mainElement: HTMLElement;
@@ -64,7 +70,7 @@ export interface IFrameNavigatorConfig {
     services?: PublicationServices;
     sample?: SampleRead;
     requestConfig?: RequestConfig;
-    modules: ReaderModule[];
+    modules: Array<ReaderModule | undefined>;
     highlighter: TextHighlighter;
 }
 export interface PublicationServices {
@@ -108,12 +114,21 @@ export interface ReaderRights {
 export interface ReaderUI {
     settings: UserSettingsUIConfig;
 }
+/**
+ * Shape of the initial annotations object passed to `D2Reader.load()`.
+ * Both `bookmarks` and `highlights` are optional arrays of their respective types.
+ */
+export interface InitialAnnotations {
+    bookmarks?: import("../model/Locator").Bookmark[];
+    highlights?: import("../model/Locator").Annotation[];
+}
 export interface ReaderConfig {
-    publication?: any;
+    /** Pre-parsed publication manifest JSON — if omitted the manifest is fetched from `url`. */
+    publication?: Record<string, unknown>;
     url: URL;
-    userSettings?: any;
-    initialAnnotations?: any;
-    lastReadingPosition?: any;
+    userSettings?: Partial<import("../model/user-settings/UserSettings").InitialUserSettings>;
+    initialAnnotations?: InitialAnnotations;
+    lastReadingPosition?: import("../model/Locator").ReadingPosition;
     rights?: Partial<ReaderRights>;
     api?: Partial<NavigatorAPI>;
     tts?: Partial<TTSModuleConfig>;
@@ -136,6 +151,12 @@ export interface ReaderConfig {
     services?: PublicationServices;
     sample?: SampleRead;
     requestConfig?: RequestConfig;
+    /**
+     * Override the PDF.js worker URL (PDF publications only).
+     * Defaults to the unpkg CDN for the bundled pdfjs-dist version.
+     * Set to a local path when self-hosting the worker, e.g. `"/viewer/pdf.worker.min.mjs"`.
+     */
+    workerSrc?: string;
 }
 /** Class that shows webpub resources in an iframe, with navigation controls outside the iframe. */
 export declare class IFrameNavigator extends EventEmitter implements Navigator {
@@ -214,7 +235,7 @@ export declare class IFrameNavigator extends EventEmitter implements Navigator {
     requestConfig?: RequestConfig;
     private didInitKeyboardEventHandler;
     static create(config: IFrameNavigatorConfig): Promise<IFrameNavigator>;
-    protected constructor(settings: UserSettings, annotator: Annotator | undefined, initialLastReadingPosition: ReadingPosition | undefined, publication: Publication, api?: Partial<NavigatorAPI>, rights?: Partial<ReaderRights>, tts?: Partial<TTSModuleConfig>, injectables?: Array<Injectable>, attributes?: IFrameAttributes, services?: PublicationServices, sample?: SampleRead, requestConfig?: RequestConfig, highlighter?: TextHighlighter, modules?: ReaderModule[]);
+    protected constructor(settings: UserSettings, annotator: Annotator | undefined, initialLastReadingPosition: ReadingPosition | undefined, publication: Publication, api?: Partial<NavigatorAPI>, rights?: Partial<ReaderRights>, tts?: Partial<TTSModuleConfig>, injectables?: Array<Injectable>, attributes?: IFrameAttributes, services?: PublicationServices, sample?: SampleRead, requestConfig?: RequestConfig, highlighter?: TextHighlighter, modules?: Array<ReaderModule | undefined>);
     stop(): void;
     spreads: HTMLDivElement;
     firstSpread: HTMLDivElement;
@@ -262,7 +283,7 @@ export declare class IFrameNavigator extends EventEmitter implements Navigator {
     nextResource(): any;
     goTo(locator: Locator): any;
     currentLocator(): Locator;
-    positions(): any;
+    positions(): Locator[];
     goToPosition(position: number): void;
     goToPage(page: number): Promise<void>;
     snapToSelector(selector: any): void;

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

@@ -1,10 +1,12 @@
 import { Locator } from "../model/Locator";
 import { IFrameAttributes } from "./IFrameNavigator";
+import { Publication } from "../model/Publication";
+import { Link } from "../model/Link";
 interface Navigator {
-    publication: any;
-    rights?: any;
-    hasMediaOverlays?: any;
-    addListener?(argument: any, argument2: any): void;
+    publication: Publication;
+    rights?: Record<string, boolean>;
+    hasMediaOverlays?: boolean;
+    addListener?(event: string, handler: (...args: any[]) => void): void;
     startReadAloud?(): void;
     stopReadAloud?(): void;
     pauseReadAloud?(): void;
@@ -13,29 +15,30 @@ interface Navigator {
     stopReadAlong?(): void;
     pauseReadAlong?(): void;
     resumeReadAlong?(): void;
-    hideLayer?(layer: any): any;
-    showLayer?(layer: any): any;
-    activateMarker?(id: string, position: string): any;
-    deactivateMarker?(): any;
-    tableOfContents(): any;
-    landmarks(): any;
-    pageList(): any;
-    readingOrder(): any;
-    currentResource(): any;
-    mostRecentNavigatedTocItem?(): any;
-    totalResources(): any;
-    currentLocator(): any;
-    positions(): any;
+    hideLayer?(layer: string): void;
+    showLayer?(layer: string): void;
+    activateMarker?(id: string, position: string): void;
+    deactivateMarker?(): void;
+    tableOfContents(): Link[];
+    landmarks(): Link[];
+    pageList(): Link[];
+    readingOrder(): Link[];
+    /** Returns the spine index of the current resource, or undefined if not yet loaded. */
+    currentResource(): number | undefined;
+    mostRecentNavigatedTocItem?(): string | undefined;
+    totalResources(): number;
+    currentLocator(): Locator;
+    positions(): Locator[];
     goTo(locator: Locator): void;
-    goToPosition(value: number): any;
-    goToPage(page: number): any;
+    goToPosition(value: number): void;
+    goToPage(page: number): void;
     nextResource(): void;
     previousResource(): void;
     nextPage(): void;
     previousPage(): void;
-    atStart?(): any;
-    atEnd?(): any;
-    snapToSelector?(selector: any): void;
+    atStart?(): boolean;
+    atEnd?(): boolean;
+    snapToSelector?(selector: string): void;
     applyAttributes?(value: IFrameAttributes): void;
     stop(): void;
 }

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

@@ -2,8 +2,13 @@ import EventEmitter from "eventemitter3";
 import Navigator from "./Navigator";
 import { UserSettings } from "../model/user-settings/UserSettings";
 import { Publication } from "../model/Publication";
-import { Locator } from "../model/Locator";
+import { Bookmark, Locator, ReadingPosition } from "../model/Locator";
+import Annotator from "../store/Annotator";
+import Store from "../store/Store";
+import { AnnotationEditorType } from "pdfjs-dist";
+import { EventBus, ScrollMode, SpreadMode } from "pdfjs-dist/web/pdf_viewer.mjs";
 import { NavigatorAPI } from "./IFrameNavigator";
+export { SpreadMode, ScrollMode, AnnotationEditorType };
 export interface PDFNavigatorConfig {
     mainElement: HTMLElement;
     headerMenu?: HTMLElement | null;
@@ -11,6 +16,22 @@ export interface PDFNavigatorConfig {
     publication: Publication;
     settings: UserSettings;
     api?: Partial<NavigatorAPI>;
+    /**
+     * Override the PDF.js worker URL.
+     * Defaults to unpkg CDN for the bundled pdfjs-dist version.
+     * Set this if you want to self-host the worker (copy
+     * node_modules/pdfjs-dist/build/pdf.worker.min.mjs to your server).
+     */
+    workerSrc?: string;
+    /** Annotator used to persist the last reading position and bookmarks across sessions. */
+    annotator?: Annotator;
+    /** Pre-loaded reading position to seed the annotator before navigation. */
+    initialLastReadingPosition?: ReadingPosition;
+    /**
+     * Store used to persist PDF view settings (scroll mode, spread mode, zoom, rotation)
+     * across sessions.  Pass the publication store from D2Reader.load().
+     */
+    store?: Store;
 }
 export declare enum ScaleType {
     Page = 0,
@@ -25,45 +46,147 @@ export declare class PDFNavigator extends EventEmitter implements Navigator {
     pdfContainer: HTMLElement;
     wrapper: HTMLElement;
     api?: Partial<NavigatorAPI>;
-    pdfDoc: any;
     pageNum: number;
-    scaleType: ScaleType;
-    pageRendering: boolean;
-    pageNumPending: any;
-    scale: number;
     resourceIndex: number;
-    resource: any;
+    private pdfDoc;
+    private resource;
+    private workerSrc;
+    private _numPages;
+    private annotator?;
+    private viewStore?;
+    private initialLastReadingPosition?;
+    private _positionRestored;
+    private _pendingAnnotations;
+    private pdfViewer;
+    eventBus: EventBus;
+    private linkService;
+    private findController;
+    private pdfHistory;
     private handTool;
+    private resizeTimeout;
     static create(config: PDFNavigatorConfig): Promise<PDFNavigator>;
-    protected constructor(settings: UserSettings, publication: Publication, api?: Partial<NavigatorAPI>);
+    protected constructor(settings: UserSettings, publication: Publication, api?: Partial<NavigatorAPI>, workerSrc?: string, annotator?: Annotator, initialLastReadingPosition?: ReadingPosition, viewStore?: Store);
     protected start(mainElement: HTMLElement, headerMenu?: HTMLElement | null, footerMenu?: HTMLElement | null): Promise<void>;
-    timeout: any;
-    onResize: () => void;
-    handleResize(): Promise<void>;
-    private setupEvents;
-    loadPDFJS(num: any): void;
-    queueRenderPage(num: any): void;
+    private showLoading;
+    private hideLoading;
+    private loadDocument;
+    private onResize;
     readingOrder(): any;
     tableOfContents(): any;
     landmarks(): any;
     pageList(): any;
-    currentResource(): any;
-    totalResources(): any;
-    currentLocator(): any;
+    atStart(): boolean;
+    atEnd(): boolean;
+    currentResource(): number;
+    totalResources(): number;
+    currentLocator(): Locator;
     positions(): any;
+    /** Total page count of the currently loaded document. */
+    get numPages(): number;
     nextPage(): void;
     previousPage(): void;
     nextResource(): void;
     previousResource(): void;
     goTo(locator: Locator): void;
+    /**
+     * Extract a 1-based page number from an href.
+     * Handles:
+     *   - `#page=N`  — PDF.js / PDF URL fragment convention
+     *   - `?start=N` — Readium webpub-manifest convention
+     *   - `?page=N`  — alternative query param
+     */
+    private pageFromHref;
+    private toAbsoluteHref;
     goToPosition(value: number): void;
     goToPage(page: number): Promise<void>;
+    private static readonly KEY_SCROLL;
+    private static readonly KEY_SPREAD;
+    private static readonly KEY_SCALE;
+    private static readonly KEY_ROTATE;
+    private saveViewSetting;
+    private restoreViewSettings;
+    private annotationKey;
+    /**
+     * Serialize the in-memory AnnotationStorage and write it to the viewStore.
+     * Called via `annotationStorage.onSetModified` whenever an annotation is
+     * added, edited, or deleted.
+     *
+     * Entries with bitmaps (image stamps) are skipped because ImageBitmap
+     * cannot be JSON-serialised — they would need separate binary storage.
+     */
+    /**
+     * Recursively converts TypedArray instances (Float32Array, etc.) to plain
+     * arrays so they survive JSON round-trip. TypedArrays stringify as objects
+     * { "0": n, "1": n, … } which have no .length, breaking pdfjs deserialization.
+     */
+    private static toJsonSafe;
+    private saveAnnotations;
+    /**
+     * Parse saved annotations from the store and group them by page index so
+     * the `annotationeditorlayerrendered` listener can inject each page's
+     * editors as their layer becomes ready.  This must be called right after
+     * `pdfViewer.setDocument()` so the data is in place before pages render.
+     *
+     * We do NOT call `annotationStorage.setValue()` here — that only fills the
+     * raw storage map and is never read back by the AnnotationEditorUIManager.
+     * Instead, `layer.deserialize()` + `layer.addOrRebuild()` reconstructs
+     * proper AnnotationEditor instances from the saved JSON.
+     */
+    private restoreAnnotations;
     fitToWidth(): void;
     fitToPage(): void;
     zoomIn(): void;
     zoomOut(): void;
+    rotateCw(): void;
+    rotateCcw(): void;
+    setSpreadMode(mode: number): void;
+    /**
+     * Activate an annotation editor tool.
+     * Pass an `AnnotationEditorType` value:
+     *   NONE = 0      — editor on, no tool active (cursor / select mode)
+     *   FREETEXT = 3  — add text notes
+     *   HIGHLIGHT = 9 — highlight selected text
+     *   STAMP = 13    — insert image stamps
+     *   INK = 15      — freehand drawing
+     */
+    setAnnotationEditorMode(mode: number): void;
+    /**
+     * The AnnotationStorage instance that holds all user-created annotations
+     * for the current document.  Serialize with `.serializable` to persist them.
+     */
+    get annotationStorage(): import("pdfjs-dist/types/src/display/annotation_storage").AnnotationStorage | undefined;
+    /**
+     * Clear all user-created annotations for the current document and remove
+     * the persisted copy from the store.
+     */
+    /**
+     * Returns every annotation across all pages — both those already deserialized
+     * into live editor objects (in annotationStorage) and those still waiting for
+     * their page to render (in _pendingAnnotations).  The sidebar uses this so it
+     * can show the complete list without requiring every page to be scrolled into view.
+     */
+    getAllAnnotations(): Record<string, unknown>[];
+    clearAnnotations(): void;
+    private makeBookmark;
+    /** Save a bookmark for the current page. Returns null if already bookmarked. */
+    saveBookmark(): Bookmark | null;
+    /** Delete a previously saved bookmark. */
+    deleteBookmark(bookmark: Bookmark): void;
+    /** Return all bookmarks for the current resource. */
+    getBookmarks(): Bookmark[];
+    /** True if the current page already has a bookmark. */
+    isCurrentPageBookmarked(): boolean;
     activateHand(): void;
     deactivateHand(): void;
     scroll(scroll: boolean, direction?: string): Promise<void>;
+    find(query: string, options?: {
+        caseSensitive?: boolean;
+        highlightAll?: boolean;
+        findPrevious?: boolean;
+    }): void;
+    findNext(): void;
+    findPrevious(): void;
+    private saveLastReadingPosition;
+    private restoreLastReadingPosition;
     stop(): void;
 }