omni-viewer-core 0.4.0 → 0.5.0

package/dist/viewers/pdf/controller.js

@@ -1,4 +1,8 @@
-export const PDF_ZOOM_LEVELS = [50, 75, 100, 125, 150, 200, 300];
+export const PDF_ZOOM_LEVELS = [
+    50, 75, 100, 125, 150, 175, 200, 225, 250, 275, 300
+];
+export const PDF_MIN_ZOOM = 25;
+export const PDF_MAX_ZOOM = 400;
 /**
  * PDF.js commonly returns one client rect per text span, even for a single
  * continuous selection. Join neighbouring spans on the same text line so
@@ -41,8 +45,18 @@ export function mergeHighlightRects(rects) {
         return merged;
     });
 }
-function nearestZoom(value) {
-    return PDF_ZOOM_LEVELS.reduce((best, candidate) => Math.abs(candidate - value) < Math.abs(best - value) ? candidate : best);
+function normalizedZoomOptions(options) {
+    const requestedMin = Number.isFinite(options.minZoom) ? Math.round(options.minZoom) : PDF_MIN_ZOOM;
+    const requestedMax = Number.isFinite(options.maxZoom) ? Math.round(options.maxZoom) : PDF_MAX_ZOOM;
+    const min = Math.max(1, Math.min(requestedMin, requestedMax));
+    const max = Math.max(min, Math.max(requestedMin, requestedMax));
+    const source = options.zoomLevels ?? PDF_ZOOM_LEVELS;
+    const levels = [...new Set(source
+            .filter(Number.isFinite)
+            .map((level) => Math.round(level))
+            .filter((level) => level >= min && level <= max))]
+        .sort((a, b) => a - b);
+    return { levels: levels.length > 0 ? levels : [min, max], min, max };
 }
 /** Highest `pdf-a<n>` suffix among seeded ids, so new ids never collide. */
 function maxSequence(annotations) {
@@ -59,10 +73,11 @@ function copyAnnotations(annotations) {
         ? { ...annotation, rects: annotation.rects.map((rect) => ({ ...rect })) }
         : { ...annotation });
 }
-export function createPdfController(pageCount, seed) {
+export function createPdfController(pageCount, seed, options = {}) {
     const original = Array.from({ length: Math.max(0, Math.floor(pageCount)) }, (_, i) => i + 1);
     const listeners = new Set();
-    let zoom = 100;
+    const zoomOptions = normalizedZoomOptions(options);
+    let zoom = Math.max(zoomOptions.min, Math.min(zoomOptions.max, 100));
     // A seeded order may only reference pages that still exist; an empty result
     // falls back to the natural order so the document is never left blank.
     const seededOrder = seed?.pageOrder?.filter((page) => page >= 1 && page <= original.length) ?? [];
@@ -95,6 +110,9 @@ export function createPdfController(pageCount, seed) {
     savedSignature = signature();
     return {
         get state() { return state(); },
+        zoomLevels: zoomOptions.levels,
+        minZoom: zoomOptions.min,
+        maxZoom: zoomOptions.max,
         subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); },
         dispatch(action) {
             if (action.type === 'undo') {
@@ -125,19 +143,19 @@ export function createPdfController(pageCount, seed) {
             const beforeSignature = tracksHistory ? signature() : undefined;
             switch (action.type) {
                 case 'zoom-in': {
-                    zoom = PDF_ZOOM_LEVELS.find((level) => level > zoom)
-                        ?? PDF_ZOOM_LEVELS[PDF_ZOOM_LEVELS.length - 1];
+                    zoom = zoomOptions.levels.find((level) => level > zoom)
+                        ?? zoomOptions.max;
                     break;
                 }
                 case 'zoom-out': {
-                    zoom = [...PDF_ZOOM_LEVELS].reverse().find((level) => level < zoom)
-                        ?? PDF_ZOOM_LEVELS[0];
+                    zoom = [...zoomOptions.levels].reverse().find((level) => level < zoom)
+                        ?? zoomOptions.min;
                     break;
                 }
                 case 'set-zoom': {
                     if (!Number.isFinite(action.zoom))
                         return;
-                    zoom = Math.max(25, Math.min(400, Math.round(action.zoom)));
+                    zoom = Math.max(zoomOptions.min, Math.min(zoomOptions.max, Math.round(action.zoom)));
                     break;
                 }
                 case 'reorder-pages': {

package/dist/viewers/pdf/index.d.ts

@@ -1,12 +1,73 @@
-import type { FilePickService, FileSaveService, FileWritebackService, HostContext } from '../../host/index.js';
+import type { FilePickService, FileSaveResult, FileSaveService, FileWritebackService, HostContext } from '../../host/index.js';
 import { type MountOptions, type ViewerHandle, type ViewerInput } from '../types.js';
-import { type PdfController } from './controller.js';
+import { type PdfController, type PdfControllerOptions, type PdfViewState } from './controller.js';
 import { type PdfLibModule } from './editing.js';
-export { createPdfController, PDF_ZOOM_LEVELS } from './controller.js';
-export type { PdfController, PdfAction, PdfViewState, PdfAnnotation } from './controller.js';
+export { createPdfController, PDF_MAX_ZOOM, PDF_MIN_ZOOM, PDF_ZOOM_LEVELS } from './controller.js';
+export type { PdfController, PdfControllerOptions, PdfAction, PdfViewState, PdfAnnotation } from './controller.js';
 export { pdfViewerCss } from './styles.js';
-export { buildEditedPdf, mergePdfBytes, savedPdfName } from './editing.js';
-export type { PdfLibModule } from './editing.js';
+export { buildEditedPdf, buildSavedPdf, mergePdfBytes, parseLayer, savedPdfName, SIDECAR_BASE_NAME, SIDECAR_LAYER_NAME } from './editing.js';
+export type { ParsedLayer, PdfLibModule } from './editing.js';
+/** Asset key passed to `HostContext.assets.resolveAssetUrl` by default. */
+export declare const PDF_WORKER_ASSET_KEY = "assets/pdfjs/pdf.worker.min.mjs";
+export type PdfSaveMode = 'hybrid' | 'flattened';
+export type PdfProcessingMode = 'auto' | 'host' | 'browser';
+export interface PdfToolbarAction {
+    id: string;
+    label: string;
+    title?: string;
+    ariaLabel?: string;
+    disabled?: boolean | (() => boolean);
+    onClick(): void | Promise<void>;
+}
+export interface PdfProcessingControl {
+    signal: AbortSignal;
+    onProgress(progress: number | undefined): void;
+}
+/** Optional host/Worker implementation for byte-heavy PDF operations. */
+export interface PdfProcessingService {
+    /** Request byte arrays are borrowed: implementations must not mutate or
+     * detach their buffers. A Worker adapter may copy/transfer internally. */
+    buildPdf?(request: {
+        source: Uint8Array;
+        state: PdfViewState;
+        mode: PdfSaveMode;
+    }, control: PdfProcessingControl): Promise<Uint8Array>;
+    mergePdfs?(request: {
+        first: Uint8Array;
+        second: Uint8Array;
+    }, control: PdfProcessingControl): Promise<Uint8Array>;
+}
+export type PdfOperationState = {
+    status: 'idle';
+} | {
+    status: 'running';
+    kind: 'save' | 'save-as' | 'merge';
+    progress?: number;
+} | {
+    status: 'succeeded';
+    kind: 'save' | 'save-as' | 'merge';
+} | {
+    status: 'failed';
+    kind: 'save' | 'save-as' | 'merge';
+    error: string;
+} | {
+    status: 'cancelled';
+    kind: 'save' | 'save-as' | 'merge';
+};
+export interface PdfMountOptions extends MountOptions, PdfControllerOptions {
+    /** Defaults to `hybrid` for v0.4 compatibility. */
+    saveMode?: PdfSaveMode;
+    /** `auto` delegates when a service method exists, `browser` always uses pdf-lib. */
+    processingMode?: PdfProcessingMode;
+    /** Maximum merge input requested from FilePickService. */
+    maxMergeBytes?: number;
+    toolbarActions?: readonly PdfToolbarAction[];
+    /** Safe default for VS Code CSP is false. */
+    isEvalSupported?: boolean;
+    /** Host-provided worker URL. Omit to resolve {@link PDF_WORKER_ASSET_KEY}. */
+    workerSrc?: string;
+    onSaveAsComplete?(result: FileSaveResult | void): void | Promise<void>;
+}
 /** Viewer metadata — single source for the registry codegen (DESIGN.md §7). */
 export declare const PDF_VIEWER_META: {
     id: string;
@@ -58,12 +119,13 @@ export interface PdfJsDocument {
 }
 export interface PdfJsLoadingTask {
     promise: Promise<PdfJsDocument>;
-    destroy(): void;
+    destroy(): void | Promise<void>;
 }
 export interface PdfJsModule {
     getDocument(options: {
         data: Uint8Array;
         password?: string;
+        isEvalSupported?: boolean;
     }): PdfJsLoadingTask;
     GlobalWorkerOptions: {
         workerSrc: string;
@@ -80,9 +142,18 @@ export interface PdfViewerDeps {
     /** Editing dependency (save / save-as / merge / annotation stamping).
      *  Absent -> editing controls disabled with a reason. */
     loadPdfLib?(): Promise<PdfLibModule>;
+    /** Host/extension-host/Web Worker implementation for large byte operations. */
+    processing?: PdfProcessingService;
 }
 export interface PdfViewerHandle extends ViewerHandle {
     readonly controller: PdfController;
+    readonly operation: PdfOperationState;
     isDirty(): boolean;
+    cancelOperation(): void;
+    refreshToolbarActions(): void;
 }
-export declare function mountPdfViewer(input: ViewerInput, container: HTMLElement, ctx: PdfViewerContext, deps: PdfViewerDeps, options?: MountOptions): Promise<PdfViewerHandle>;
+export declare function containPdfSignatureSize(width: number, height: number, maxWidth?: number, maxHeight?: number): {
+    width: number;
+    height: number;
+};
+export declare function mountPdfViewer(input: ViewerInput, container: HTMLElement, ctx: PdfViewerContext, deps: PdfViewerDeps, options?: PdfMountOptions): Promise<PdfViewerHandle>;