@docmentis/udoc-viewer 0.6.34 → 0.6.36

package/README.md

@@ -383,6 +383,100 @@ for (let i = 0; i < viewer.pageCount; i++) {
 const fullText = pages.join("\n\n");
 ```
 
+### Annotations
+
+Read, create, modify, and delete annotations on PDF documents. Each annotation has a stable `name` (the PDF NM identifier) that survives save/reload, so you can use it as a foreign key from your own data store.
+
+**Read.** `getPageAnnotations` returns every annotation on a page — including any in-memory edits and ephemeral overlays — so a single call always reflects what the user is currently seeing.
+
+```typescript
+const annotations = await viewer.getPageAnnotations(0); // 0-based page index
+
+for (const a of annotations) {
+    console.log(a.type, a.name, a.bounds, a.metadata?.author);
+}
+```
+
+**Add.** Pass any `Annotation` shape (highlight, underline, ink, freeText, square, etc.) along with a `bounds` rectangle in PDF points. If `name` is omitted the viewer assigns a UUID and returns it on the resolved annotation, so you can keep referencing the new annotation immediately.
+
+```typescript
+const created = await viewer.addPageAnnotation(0, {
+    type: "highlight",
+    bounds: { x: 100, y: 700, width: 200, height: 20 },
+    quads: [
+        {
+            points: [
+                { x: 100, y: 700 },
+                { x: 300, y: 700 },
+                { x: 300, y: 720 },
+                { x: 100, y: 720 },
+            ],
+        },
+    ],
+    color: { r: 1, g: 1, b: 0 },
+    metadata: { author: "Alice", contents: "Important" },
+});
+
+console.log(created.name); // generated UUID, stable across save/reload
+```
+
+**Update / remove.** Both are keyed by `name`. `updatePageAnnotation` replaces the whole annotation but preserves the `name` even if you accidentally pass a different one in the body.
+
+```typescript
+await viewer.updatePageAnnotation(0, created.name, {
+    ...created,
+    color: { r: 0, g: 1, b: 0 },
+    metadata: { ...created.metadata, contents: "Reviewed" },
+});
+
+await viewer.removePageAnnotation(0, created.name);
+```
+
+**Save.** PDF write-back happens automatically on `toBytes()` and `download()` whenever there are pending edits — there is no separate save call.
+
+```typescript
+const bytes = await viewer.toBytes(); // pending edits flushed into the returned PDF
+await viewer.download("annotated.pdf");
+```
+
+**Ephemeral annotations.** Pass `ephemeral: true` to create a viewer-only annotation. Ephemeral annotations render in the canvas like any other, but are excluded from saved PDF bytes and from print output. Use them for live cursors, preview shapes, or transient review markers that shouldn't survive a reload.
+
+```typescript
+const cursor = await viewer.addPageAnnotation(0, {
+    type: "square",
+    bounds: { x: 50, y: 50, width: 30, height: 30 },
+    color: { r: 1, g: 0, b: 0 },
+    ephemeral: true, // not written on save, not printed
+});
+
+// Promote an ephemeral preview into a saved annotation:
+await viewer.updatePageAnnotation(0, cursor.name, { ...cursor, ephemeral: false });
+```
+
+**Events.** All four annotation events fire for both UI-driven changes (drawing/markup tools) and API-driven changes, so a single listener covers both.
+
+```typescript
+viewer.on("annotation:add", ({ pageIndex, annotation }) => {
+    if (annotation.ephemeral) return;
+    syncToBackend({ kind: "create", pageIndex, annotation });
+});
+
+viewer.on("annotation:update", ({ pageIndex, annotation }) => {
+    syncToBackend({ kind: "update", pageIndex, annotation });
+});
+
+viewer.on("annotation:remove", ({ pageIndex, annotation }) => {
+    syncToBackend({ kind: "delete", pageIndex, name: annotation.name });
+});
+
+viewer.on("annotation:select", (selection) => {
+    if (!selection) return; // null = deselect
+    showInspector(selection.annotation);
+});
+```
+
+> Annotation editing currently requires UI mode (a `container` was passed to `createViewer`) and is supported on PDF documents only.
+
 ### Programmatic Viewer Control
 
 Control zoom, view modes, and fullscreen programmatically — useful when toolbars are hidden:
@@ -417,6 +511,33 @@ viewer.setFullscreen(true);
 console.log(viewer.isFullscreen);
 ```
 
+### Tools
+
+Switch the active tool programmatically. The active tool is a tagged union: simple tools (`pointer`, `hand`, `zoom`) carry no sub-tool, while tool sets (`annotate`, `markup`) carry a `sub` for the active sub-tool.
+
+```typescript
+// Simple tools
+viewer.setActiveTool({ kind: "pointer" });
+viewer.setActiveTool({ kind: "hand" });
+viewer.setActiveTool({ kind: "zoom" });
+
+// Tool sets — sub-tool is required
+viewer.setActiveTool({ kind: "annotate", sub: "freehand" });
+viewer.setActiveTool({ kind: "annotate", sub: "rectangle" });
+viewer.setActiveTool({ kind: "markup", sub: "highlight" });
+
+// Calling with the same tool-set kind that's already active toggles back to pointer
+
+// Read current tool
+const t = viewer.activeTool;
+if (t.kind === "annotate") {
+    console.log("annotating with", t.sub); // "freehand" | "rectangle" | ...
+}
+```
+
+`AnnotateSubTool`: `select`, `freehand`, `line`, `arrow`, `rectangle`, `ellipse`, `polygon`, `polyline`.
+`MarkupSubTool`: `select`, `highlight`, `underline`, `strikethrough`, `squiggly`.
+
 ### UI Visibility Control
 
 Show, hide, or disable UI components at runtime:
@@ -614,6 +735,13 @@ viewer.on("page:change", ({ page, previousPage }) => {
     console.log(`Page ${previousPage} -> ${page}`);
 });
 
+// Viewport changed (scroll, zoom, layout, or scroll-mode change).
+// Throttled to one fire per animation frame and de-duped — adjacent
+// identical payloads are coalesced. Page indices are 0-based.
+viewer.on("viewport:change", ({ firstVisiblePage, lastVisiblePage, zoom, scrollTop }) => {
+    console.log(`Visible: ${firstVisiblePage}–${lastVisiblePage} @ ${zoom}x, scrollTop=${scrollTop}`);
+});
+
 // Panel opened/closed
 viewer.on("panel:change", ({ panel, previousPanel }) => {
     console.log(`Panel: ${previousPanel} -> ${panel}`);
@@ -634,6 +762,15 @@ viewer.on("search:change", ({ matches, activeIndex }) => {
     console.log(`${matches.length} matches, active: ${activeIndex}`);
 });
 
+// Annotation lifecycle (fired for both UI- and API-driven changes; see the
+// Annotations section above for full payloads)
+viewer.on("annotation:add", ({ pageIndex, annotation }) => {});
+viewer.on("annotation:update", ({ pageIndex, annotation }) => {});
+viewer.on("annotation:remove", ({ pageIndex, annotation }) => {});
+viewer.on("annotation:select", (selection) => {
+    // null when the selection is cleared
+});
+
 // Error occurred
 viewer.on("error", ({ error, phase }) => {
     console.error(`Error during ${phase}:`, error);

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@docmentis/udoc-viewer",
-    "version": "0.6.34",
+    "version": "0.6.36",
     "type": "module",
     "license": "MIT",
     "description": "Universal document viewer for the web — open-source, framework-agnostic viewer powered by a built-from-scratch WebAssembly engine for high-fidelity rendering across PDF, DOCX, PPTX, SVG, and images.",

package/dist/src/UDocClient.js

@@ -14,7 +14,7 @@ export class UDocClient {
     /**
      * SDK version string (replaced at build time).
      */
-    static version = "0.6.34";
+    static version = "0.6.36";
     workerClient;
     options;
     viewers = new Set();

package/dist/src/UDocViewer.d.ts

@@ -12,7 +12,7 @@ import { type Annotation } from "./ui/viewer/annotation/index.js";
 export type { Annotation } from "./ui/viewer/annotation/index.js";
 export type { SearchMatch } from "./ui/viewer/state.js";
 import type { LayoutPage } from "./worker/index.js";
-import { type ViewMode, type PanelTab, type ScrollMode, type LayoutMode, type ZoomMode, type PageRotation, type SpacingMode, type ThemeMode, type SearchMatch } from "./ui/viewer/state.js";
+import { type ViewMode, type PanelTab, type ScrollMode, type LayoutMode, type ZoomMode, type PageRotation, type SpacingMode, type ThemeMode, type SearchMatch, type ActiveTool } from "./ui/viewer/state.js";
 import { type IPerformanceCounter } from "./performance/index.js";
 /**
  * Options for rendering a page.
@@ -126,6 +126,38 @@ export interface ViewerEventMap {
         matches: SearchMatch[];
         activeIndex: number;
     };
+    "annotation:add": {
+        pageIndex: number;
+        annotation: Annotation;
+    };
+    "annotation:update": {
+        pageIndex: number;
+        annotation: Annotation;
+    };
+    "annotation:remove": {
+        pageIndex: number;
+        annotation: Annotation;
+    };
+    "annotation:select": {
+        pageIndex: number;
+        annotation: Annotation;
+    } | null;
+    /**
+     * Fires when the user's view of the document changes — scroll position,
+     * zoom, layout, or scroll-mode changes that affect which pages are
+     * visible. Throttled to once per animation frame, and de-duped so
+     * adjacent identical payloads are coalesced.
+     */
+    "viewport:change": {
+        /** First page index (0-based) at least partially visible. */
+        firstVisiblePage: number;
+        /** Last page index (0-based) at least partially visible. */
+        lastVisiblePage: number;
+        /** Current zoom factor (1 = 100%). */
+        zoom: number;
+        /** Vertical scroll offset of the viewport in CSS pixels. */
+        scrollTop: number;
+    };
 }
 type EventHandler<K extends keyof ViewerEventMap> = (payload: ViewerEventMap[K]) => void;
 /**
@@ -148,6 +180,7 @@ export declare class UDocViewer {
     private currentFormat;
     private sourceFilename;
     private storeUnsub;
+    private actionUnsub;
     private fontUsageUnsub;
     private sdkVersion;
     /**
@@ -228,9 +261,64 @@ export declare class UDocViewer {
     getPageInfo(page: number): Promise<PageInfo>;
     /**
      * Get annotations on a specific page.
+     *
+     * Returns the in-memory state if the page has been edited in this
+     * session; otherwise reads from the worker.
+     *
      * @param page - Page index (0-based)
      */
     getPageAnnotations(page: number): Promise<Annotation[]>;
+    /**
+     * Add a new annotation to a page.
+     *
+     * If `annotation.name` is omitted, a UUID is generated and assigned. The
+     * returned value is the annotation as inserted (with `name` populated),
+     * which is the same identifier the engine will write to the PDF's NM
+     * entry on save.
+     *
+     * Pass `ephemeral: true` to create a viewer-only annotation that renders
+     * but is excluded from saved PDF bytes and from print output. The same
+     * `updatePageAnnotation` / `removePageAnnotation` calls work for both kinds, and
+     * `updatePageAnnotation` can flip the `ephemeral` flag to promote a preview
+     * into a saved annotation (or demote a saved one to viewer-only).
+     *
+     * Annotation editing currently requires UI mode (a `container` was passed
+     * to `client.createViewer`) and is supported on PDF documents only.
+     *
+     * @param page - Page index (0-based)
+     * @returns The inserted annotation (with `name` populated).
+     */
+    addPageAnnotation(page: number, annotation: Annotation): Promise<Annotation>;
+    /**
+     * Update an existing annotation, identified by its `name` (NM).
+     *
+     * Looks up the annotation on the given page by `name` and replaces it
+     * with the supplied value. The replacement keeps the same `name` even
+     * if a different one is passed in `annotation.name`.
+     *
+     * @param page - Page index (0-based)
+     * @param name - The annotation's `name` (NM).
+     * @param annotation - The replacement annotation.
+     * @returns The updated annotation.
+     * @throws If no annotation with the given `name` is found on the page.
+     */
+    updatePageAnnotation(page: number, name: string, annotation: Annotation): Promise<Annotation>;
+    /**
+     * Remove an annotation, identified by its `name` (NM).
+     *
+     * @param page - Page index (0-based)
+     * @param name - The annotation's `name` (NM).
+     * @throws If no annotation with the given `name` is found on the page.
+     */
+    removePageAnnotation(page: number, name: string): Promise<void>;
+    /**
+     * Ensure pageAnnotations is populated for a page so that mutator actions
+     * have a baseline list to operate on. The reducer's ADD path tolerates a
+     * missing page, but UPDATE/REMOVE need the existing annotations loaded
+     * so we don't silently lose what the worker has.
+     */
+    private ensurePageAnnotationsLoaded;
+    private findAnnotationIndex;
     /**
      * Get the layout structure for a specific page.
      * Returns frames, parcels, lines, runs, glyphs, tables, and grids
@@ -360,6 +448,19 @@ export declare class UDocViewer {
      * Show or hide the floating toolbar (page navigation, zoom, view mode controls).
      */
     setFloatingToolbarVisible(visible: boolean): void;
+    /**
+     * Currently active tool, as a tagged union. The `kind` is one of `"pointer"`,
+     * `"hand"`, `"zoom"`, `"annotate"`, `"markup"`; for `"annotate"` and `"markup"`
+     * a `sub` field carries the active sub-tool (`"freehand"`, `"highlight"`, etc.).
+     */
+    get activeTool(): ActiveTool;
+    /**
+     * Switch the currently active tool. Tool-set kinds (`"annotate"`, `"markup"`)
+     * require a `sub`, e.g. `{ kind: "annotate", sub: "freehand" }`. Calling
+     * this with the same tool-set kind that's already active toggles back to
+     * the pointer tool, matching the toolbar UI.
+     */
+    setActiveTool(tool: ActiveTool): void;
     /**
      * Enable or disable the fullscreen button.
      */

package/dist/src/UDocViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UDocViewer.d.ts","sourceRoot":"","sources":["../../src/UDocViewer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"UDocViewer.d.ts","sourceRoot":"","sources":["../../src/UDocViewer.ts"],"names":[],"mappings":"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"}

package/dist/src/UDocViewer.js

@@ -9,6 +9,21 @@ import { renderAnnotationsToLayer } from "./ui/viewer/annotation/index.js";
 import { extractPageText } from "./ui/viewer/search/index.js";
 import { getFormatDefaults, } from "./ui/viewer/state.js";
 import { PerformanceCounter, NoOpPerformanceCounter } from "./performance/index.js";
+/**
+ * Generate a unique annotation identifier suitable for the PDF NM entry.
+ * Uses crypto.randomUUID() when available, falling back to a Math.random
+ * shim for environments (older Safari, Node < 19) without it.
+ */
+function generateAnnotationId() {
+    const cryptoObj = globalThis.crypto;
+    if (cryptoObj?.randomUUID)
+        return cryptoObj.randomUUID();
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
 /**
  * Document viewer component.
  *
@@ -29,13 +44,14 @@ export class UDocViewer {
     currentFormat = null;
     sourceFilename = null;
     storeUnsub = null;
+    actionUnsub = null;
     fontUsageUnsub = null;
     sdkVersion;
     /**
      * @internal
      * Use `client.createViewer()` instead.
      */
-    constructor(workerClient, options = {}, showAttribution = true, showLoadingOverlay = true, sdkVersion = "0.6.34") {
+    constructor(workerClient, options = {}, showAttribution = true, showLoadingOverlay = true, sdkVersion = "0.6.36") {
         this.workerClient = workerClient;
         this.sdkVersion = sdkVersion;
         this.viewOverrides = this.buildViewModeOverrides(options);
@@ -73,6 +89,7 @@ export class UDocViewer {
                 onPasswordSubmit: (password) => this.handlePasswordSubmit(password),
                 onDownload: () => this.download(),
                 onPrint: (options) => this.print(options),
+                onViewportChange: (payload) => this.emit("viewport:change", payload),
             });
             // Subscribe to store state changes to emit public events
             this.storeUnsub = this.uiShell.store.subscribeEffect((prev, next) => {
@@ -148,6 +165,49 @@ export class UDocViewer {
                     }
                 }
             });
+            // Forward annotation mutations as public events. Subscribing at the
+            // action layer (rather than diffing state) lets us include the
+            // exact affected annotation in the payload — including the removed
+            // one, which we look up in `prev` before the reducer dropped it.
+            this.actionUnsub = this.uiShell.store.subscribeAction((action, prev, next) => {
+                switch (action.type) {
+                    case "ADD_ANNOTATION":
+                        this.emit("annotation:add", {
+                            pageIndex: action.pageIndex,
+                            annotation: action.annotation,
+                        });
+                        break;
+                    case "UPDATE_ANNOTATION":
+                        this.emit("annotation:update", {
+                            pageIndex: action.pageIndex,
+                            annotation: action.annotation,
+                        });
+                        break;
+                    case "REMOVE_ANNOTATION": {
+                        const removed = prev.pageAnnotations.get(action.pageIndex)?.[action.annotationIndex];
+                        if (removed) {
+                            this.emit("annotation:remove", {
+                                pageIndex: action.pageIndex,
+                                annotation: removed,
+                            });
+                        }
+                        break;
+                    }
+                    case "SELECT_ANNOTATION": {
+                        const ann = next.pageAnnotations.get(action.pageIndex)?.[action.annotationIndex];
+                        if (ann) {
+                            this.emit("annotation:select", {
+                                pageIndex: action.pageIndex,
+                                annotation: ann,
+                            });
+                        }
+                        break;
+                    }
+                    case "DESELECT_ANNOTATION":
+                        this.emit("annotation:select", null);
+                        break;
+                }
+            });
         }
     }
     /**
@@ -528,13 +588,109 @@ export class UDocViewer {
     }
     /**
      * Get annotations on a specific page.
+     *
+     * Returns the in-memory state if the page has been edited in this
+     * session; otherwise reads from the worker.
+     *
      * @param page - Page index (0-based)
      */
     async getPageAnnotations(page) {
         this.ensureLoaded();
+        const fromState = this.uiShell?.store.getState().pageAnnotations.get(page);
+        if (fromState)
+            return fromState;
         const raw = await this.workerClient.getPageAnnotations(this.documentId, page);
         return raw;
     }
+    /**
+     * Add a new annotation to a page.
+     *
+     * If `annotation.name` is omitted, a UUID is generated and assigned. The
+     * returned value is the annotation as inserted (with `name` populated),
+     * which is the same identifier the engine will write to the PDF's NM
+     * entry on save.
+     *
+     * Pass `ephemeral: true` to create a viewer-only annotation that renders
+     * but is excluded from saved PDF bytes and from print output. The same
+     * `updatePageAnnotation` / `removePageAnnotation` calls work for both kinds, and
+     * `updatePageAnnotation` can flip the `ephemeral` flag to promote a preview
+     * into a saved annotation (or demote a saved one to viewer-only).
+     *
+     * Annotation editing currently requires UI mode (a `container` was passed
+     * to `client.createViewer`) and is supported on PDF documents only.
+     *
+     * @param page - Page index (0-based)
+     * @returns The inserted annotation (with `name` populated).
+     */
+    async addPageAnnotation(page, annotation) {
+        this.ensureLoaded();
+        this.ensureUiMode();
+        await this.ensurePageAnnotationsLoaded(page);
+        const withId = annotation.name ? annotation : { ...annotation, name: generateAnnotationId() };
+        this.uiShell.dispatch({ type: "ADD_ANNOTATION", pageIndex: page, annotation: withId });
+        return withId;
+    }
+    /**
+     * Update an existing annotation, identified by its `name` (NM).
+     *
+     * Looks up the annotation on the given page by `name` and replaces it
+     * with the supplied value. The replacement keeps the same `name` even
+     * if a different one is passed in `annotation.name`.
+     *
+     * @param page - Page index (0-based)
+     * @param name - The annotation's `name` (NM).
+     * @param annotation - The replacement annotation.
+     * @returns The updated annotation.
+     * @throws If no annotation with the given `name` is found on the page.
+     */
+    async updatePageAnnotation(page, name, annotation) {
+        this.ensureLoaded();
+        this.ensureUiMode();
+        const index = await this.findAnnotationIndex(page, name);
+        const updated = { ...annotation, name };
+        this.uiShell.dispatch({
+            type: "UPDATE_ANNOTATION",
+            pageIndex: page,
+            annotationIndex: index,
+            annotation: updated,
+        });
+        return updated;
+    }
+    /**
+     * Remove an annotation, identified by its `name` (NM).
+     *
+     * @param page - Page index (0-based)
+     * @param name - The annotation's `name` (NM).
+     * @throws If no annotation with the given `name` is found on the page.
+     */
+    async removePageAnnotation(page, name) {
+        this.ensureLoaded();
+        this.ensureUiMode();
+        const index = await this.findAnnotationIndex(page, name);
+        this.uiShell.dispatch({ type: "REMOVE_ANNOTATION", pageIndex: page, annotationIndex: index });
+    }
+    /**
+     * Ensure pageAnnotations is populated for a page so that mutator actions
+     * have a baseline list to operate on. The reducer's ADD path tolerates a
+     * missing page, but UPDATE/REMOVE need the existing annotations loaded
+     * so we don't silently lose what the worker has.
+     */
+    async ensurePageAnnotationsLoaded(page) {
+        const state = this.uiShell.store.getState();
+        if (state.pageAnnotations.has(page))
+            return;
+        const raw = (await this.workerClient.getPageAnnotations(this.documentId, page));
+        this.uiShell.dispatch({ type: "SET_PAGE_ANNOTATIONS", pageIndex: page, annotations: raw });
+    }
+    async findAnnotationIndex(page, name) {
+        await this.ensurePageAnnotationsLoaded(page);
+        const list = this.uiShell.store.getState().pageAnnotations.get(page) ?? [];
+        const index = list.findIndex((a) => a.name === name);
+        if (index < 0) {
+            throw new Error(`No annotation with name "${name}" on page ${page}`);
+        }
+        return index;
+    }
     /**
      * Get the layout structure for a specific page.
      * Returns frames, parcels, lines, runs, glyphs, tables, and grids
@@ -813,6 +969,25 @@ export class UDocViewer {
         this.ensureUiMode();
         this.uiShell.dispatch({ type: "SET_FLOATING_TOOLBAR_VISIBLE", visible });
     }
+    /**
+     * Currently active tool, as a tagged union. The `kind` is one of `"pointer"`,
+     * `"hand"`, `"zoom"`, `"annotate"`, `"markup"`; for `"annotate"` and `"markup"`
+     * a `sub` field carries the active sub-tool (`"freehand"`, `"highlight"`, etc.).
+     */
+    get activeTool() {
+        return this.uiShell?.getState().activeTool ?? { kind: "pointer" };
+    }
+    /**
+     * Switch the currently active tool. Tool-set kinds (`"annotate"`, `"markup"`)
+     * require a `sub`, e.g. `{ kind: "annotate", sub: "freehand" }`. Calling
+     * this with the same tool-set kind that's already active toggles back to
+     * the pointer tool, matching the toolbar UI.
+     */
+    setActiveTool(tool) {
+        this.ensureNotDestroyed();
+        this.ensureUiMode();
+        this.uiShell.dispatch({ type: "SET_ACTIVE_TOOL", tool });
+    }
     /**
      * Enable or disable the fullscreen button.
      */
@@ -1153,12 +1328,14 @@ export class UDocViewer {
      */
     async toBytes() {
         this.ensureLoaded();
-        // If there are dirty annotation pages, save them into the PDF first
+        // If there are dirty annotation pages, save them into the PDF first.
+        // Ephemeral annotations are excluded — they're viewer-only and never persist.
         const state = this.uiShell?.store.getState();
         if (state && state.annotationsDirtyPages.size > 0 && this.currentFormat === "pdf") {
             const annotationsByPage = {};
             for (const [pageIndex, annotations] of state.pageAnnotations) {
-                annotationsByPage[String(pageIndex)] = annotations;
+                const persistable = annotations.filter((a) => !a.ephemeral);
+                annotationsByPage[String(pageIndex)] = persistable;
             }
             return this.workerClient.pdfSaveAnnotations(this.documentId, annotationsByPage);
         }
@@ -1296,7 +1473,9 @@ export class UDocViewer {
                 // is sized in inches (1in = 96 CSS px), so we scale by 96/72 to convert
                 // PDF points to CSS pixels.
                 const state = this.uiShell?.store.getState();
-                const pageAnnotations = state?.pageAnnotations.get(pageIndex);
+                // Exclude ephemeral annotations from print output — they're
+                // viewer-only overlays.
+                const pageAnnotations = state?.pageAnnotations.get(pageIndex)?.filter((a) => !a.ephemeral);
                 let annotationLayer = "";
                 if (pageAnnotations && pageAnnotations.length > 0) {
                     const tempLayer = document.createElement("div");
@@ -1447,6 +1626,10 @@ img { display: block; }
             this.storeUnsub();
             this.storeUnsub = null;
         }
+        if (this.actionUnsub) {
+            this.actionUnsub();
+            this.actionUnsub = null;
+        }
         if (this.fontUsageUnsub) {
             this.fontUsageUnsub();
             this.fontUsageUnsub = null;