kviewer 0.3.2 → 0.3.3

package/dist/module.d.mts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-export { ActiveTool, AddFormFieldPayload, CheckboxStyle, ExportPdfOptions, FormFieldDefinition, FormFieldOrigin, FormFieldType, FormFieldValue, KVIEWER_EMBED_PROTOCOL_VERSION, KViewerApi, KViewerEmbedBridgeOptions, KViewerEmbedClient, KViewerEmbedClientOptions, KViewerEmbedEventName, KViewerEmbedEventPayloads, KViewerEmbedMethodName, PlacedFieldDefaults, SignatureData, SignatureFieldStatus, SignatureHandlers, ViewMode, ViewerBottomToolId, ViewerLayoutToolId, ViewerMenuButtonItem, ViewerMenuCheckboxItem, ViewerMenuItem, ViewerMenuSeparatorItem, ViewerState, ViewerToolEntry, ViewerToolId, ViewerToolSlot, ViewerTopToolId, useKViewerEmbedBridge } from '../dist/runtime/public-types.js';
+export { ActiveTool, AddFormFieldPayload, CheckboxStyle, ExportPdfOptions, FormFieldDefinition, FormFieldOrigin, FormFieldType, FormFieldValue, KVIEWER_EMBED_PROTOCOL_VERSION, KVIEWER_EMBED_UNSUPPORTED_METHOD_ERROR_NAME, KViewerApi, KViewerEmbedBridgeOptions, KViewerEmbedClient, KViewerEmbedClientOptions, KViewerEmbedEventName, KViewerEmbedEventPayloads, KViewerEmbedMethodName, KViewerHostApi, PlacedFieldDefaults, SignatureData, SignatureFieldStatus, SignatureHandlers, ViewMode, ViewerBottomToolId, ViewerLayoutToolId, ViewerMenuButtonItem, ViewerMenuCheckboxItem, ViewerMenuItem, ViewerMenuSeparatorItem, ViewerState, ViewerToolEntry, ViewerToolId, ViewerToolSlot, ViewerTopToolId, useKViewerEmbedBridge } from '../dist/runtime/public-types.js';
 
 interface ModuleOptions {
     /**

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "kviewer",
   "configKey": "kviewer",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from 'node:module';
 import { dirname, join } from 'node:path';
 import { defineNuxtModule, createResolver, extendViteConfig, addPlugin, addComponentsDir, addImports } from '@nuxt/kit';
-export { KVIEWER_EMBED_PROTOCOL_VERSION, KViewerEmbedClient, useKViewerEmbedBridge } from '../dist/runtime/public-types.js';
+export { KVIEWER_EMBED_PROTOCOL_VERSION, KVIEWER_EMBED_UNSUPPORTED_METHOD_ERROR_NAME, KViewerEmbedClient, useKViewerEmbedBridge } from '../dist/runtime/public-types.js';
 
 const module$1 = defineNuxtModule({
   meta: {
@@ -34,19 +34,14 @@ const module$1 = defineNuxtModule({
       config.optimizeDeps ||= {};
       config.optimizeDeps.include ||= [];
       config.optimizeDeps.include.push(
-        "konva",
-        "pdf-lib",
-        "pdfjs-dist/legacy/build/pdf.mjs",
-        "pdfjs-dist/web/pdf_viewer.mjs",
-        // unicode-font.ts registers @pdf-lib/fontkit for Unicode font
-        // embedding. Its ESM build does `import pako from 'pako'`, but pako 1.x
-        // is CJS with no `default` export — so unless fontkit is pre-bundled
-        // (where esbuild applies CJS interop and synthesizes the default), the
-        // browser receives the raw pako index.js and throws "does not provide
-        // an export named 'default'". The `kviewer >` prefix anchors resolution
-        // through this module, so it works even when pnpm leaves fontkit
-        // un-hoisted in the consumer (a bare '@pdf-lib/fontkit' entry would not
-        // resolve from the consumer root and Vite would silently skip it).
+        "kviewer > konva",
+        "kviewer > pdf-lib",
+        "kviewer > pdfjs-dist/legacy/build/pdf.mjs",
+        "kviewer > pdfjs-dist/web/pdf_viewer.mjs",
+        // fontkit's ESM build does `import pako from 'pako'`, but pako 1.x is
+        // CJS with no `default` export — without pre-bundling (where esbuild
+        // synthesizes it) the browser throws "does not provide an export named
+        // 'default'".
         "kviewer > @pdf-lib/fontkit"
       );
     });
@@ -71,7 +66,12 @@ const module$1 = defineNuxtModule({
     addImports([
       { name: "useKViewerEmbedBridge", from: resolve("./runtime/embed/bridge-host") },
       { name: "KViewerEmbedClient", from: resolve("./runtime/embed/bridge-client") },
-      { name: "KVIEWER_EMBED_PROTOCOL_VERSION", from: resolve("./runtime/embed/protocol") }
+      { name: "KVIEWER_EMBED_PROTOCOL_VERSION", from: resolve("./runtime/embed/protocol") },
+      {
+        name: "UNSUPPORTED_METHOD_ERROR_NAME",
+        as: "KVIEWER_EMBED_UNSUPPORTED_METHOD_ERROR_NAME",
+        from: resolve("./runtime/embed/protocol")
+      }
     ]);
     const require_ = createRequire(import.meta.url);
     const pdfjsDir = dirname(require_.resolve("pdfjs-dist/package.json"));

package/dist/runtime/annotation/pdf-export/export-form-fields.js

@@ -322,14 +322,7 @@ async function buildSignedSignatureAppearance(pdfDoc, dataUrl, width, height) {
   const mimeType = match[1] ?? "";
   const base64 = match[2] ?? "";
   const image = mimeType.includes("jpeg") || mimeType.includes("jpg") ? await pdfDoc.embedJpg(base64) : await pdfDoc.embedPng(base64);
-  const imgAspect = image.width / image.height;
-  const boxAspect = width / height;
-  let drawW = width;
-  let drawH = height;
-  if (imgAspect > boxAspect) drawH = width / imgAspect;
-  else drawW = height * imgAspect;
-  const drawX = (width - drawW) / 2;
-  const drawY = (height - drawH) / 2;
+  const { drawX, drawY, drawW, drawH } = fitImageInBox(image, width, height);
   const ops = [
     "q",
     `${drawW.toFixed(3)} 0 0 ${drawH.toFixed(3)} ${drawX.toFixed(3)} ${drawY.toFixed(3)} cm`,
@@ -346,6 +339,20 @@ async function buildSignedSignatureAppearance(pdfDoc, dataUrl, width, height) {
   const stream = PDFRawStream.of(dict, new TextEncoder().encode(ops));
   return pdfDoc.context.register(stream);
 }
+function fitImageInBox(image, boxW, boxH) {
+  const imgAspect = image.width / image.height;
+  const boxAspect = boxW / boxH;
+  let drawW = boxW;
+  let drawH = boxH;
+  if (imgAspect > boxAspect) drawH = boxW / imgAspect;
+  else drawW = boxH * imgAspect;
+  return {
+    drawX: (boxW - drawW) / 2,
+    drawY: (boxH - drawH) / 2,
+    drawW,
+    drawH
+  };
+}
 async function embedSignatureImage(pdfDoc, field) {
   const dataUrl = field.value;
   const match = dataUrl.match(/^data:(image\/[a-zA-Z0-9.+-]+);base64,(.+)$/);
@@ -370,11 +377,12 @@ async function embedSignatureImage(pdfDoc, field) {
         const pageRef = page.ref;
         const widgetPage = widget.P();
         if (widgetPage === pageRef || !widgetPage) {
+          const { drawX, drawY, drawW, drawH } = fitImageInBox(image, rect.width, rect.height);
           page.drawImage(image, {
-            x: rect.x,
-            y: rect.y,
-            width: rect.width,
-            height: rect.height
+            x: rect.x + drawX,
+            y: rect.y + drawY,
+            width: drawW,
+            height: drawH
           });
           break;
         }

package/dist/runtime/annotation/pdf-export/print.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Print a PDF by handing the actual (vector) bytes to the browser's native
+ * PDF pipeline, instead of letting the print dialog rasterize the on-screen
+ * canvases: a hidden iframe loads the blob and `contentWindow.print()` opens
+ * the dialog with the full-resolution document.
+ *
+ * On iOS/iPadOS Safari an iframe renders only the first PDF page, so there
+ * the blob opens in a new tab and the user prints from the native preview
+ * (share sheet → Print). Same fallback if `print()` throws (some browsers
+ * refuse to script-print plugin documents).
+ */
+export declare function printPdfBytes(data: Uint8Array): Promise<void>;

package/dist/runtime/annotation/pdf-export/print.js

@@ -0,0 +1,63 @@
+import { isIPad } from "../../annotation/engine/input-device.js";
+let activeFrame = null;
+let activeUrl = null;
+function reclaimPrevious() {
+  activeFrame?.remove();
+  activeFrame = null;
+  if (activeUrl) {
+    URL.revokeObjectURL(activeUrl);
+    activeUrl = null;
+  }
+}
+function openInNewTab(url) {
+  const win = window.open(url, "_blank");
+  if (!win) {
+    throw new Error(
+      "Could not open the PDF for printing \u2014 the popup was blocked. Allow popups for this site and try again."
+    );
+  }
+}
+export async function printPdfBytes(data) {
+  reclaimPrevious();
+  const arrayBuffer = Uint8Array.from(data).buffer;
+  const blob = new Blob([arrayBuffer], { type: "application/pdf" });
+  const url = URL.createObjectURL(blob);
+  activeUrl = url;
+  const isAppleMobile = isIPad() || /iPhone|iPod/.test(navigator.userAgent);
+  if (isAppleMobile) {
+    openInNewTab(url);
+    return;
+  }
+  const frame = document.createElement("iframe");
+  frame.style.position = "fixed";
+  frame.style.right = "0";
+  frame.style.bottom = "0";
+  frame.style.width = "1px";
+  frame.style.height = "1px";
+  frame.style.border = "0";
+  frame.style.visibility = "hidden";
+  frame.src = url;
+  activeFrame = frame;
+  await new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      reject(new Error("Timed out loading the PDF for printing"));
+    }, 15e3);
+    frame.addEventListener(
+      "load",
+      () => {
+        clearTimeout(timer);
+        resolve();
+      },
+      { once: true }
+    );
+    document.body.appendChild(frame);
+  });
+  try {
+    const win = frame.contentWindow;
+    if (!win) throw new Error("Print frame has no window");
+    win.focus();
+    win.print();
+  } catch {
+    openInNewTab(url);
+  }
+}

package/dist/runtime/components/Viewer.d.vue.ts

@@ -78,6 +78,11 @@ type __VLS_Props = {
     messages?: KviewerMessageOverrides;
 };
 declare function exportPdf(options?: ExportPdfOptions): Promise<Uint8Array>;
+/** Print via the real PDF instead of the on-screen canvases: export the
+ *  document (annotations + form values baked in) and hand the vector bytes
+ *  to the browser's native PDF print pipeline. Screen canvases are sized
+ *  for the monitor and would come out blurry on paper. */
+declare function printPdf(options?: ExportPdfOptions): Promise<void>;
 type ImportMode = 'replace' | 'merge';
 declare function importAnnotations(annotations: IAnnotationStore[], options?: {
     mode?: ImportMode;
@@ -100,6 +105,10 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     getAnnotations: () => IAnnotationStore[];
     importAnnotations: typeof importAnnotations;
     exportPdf: typeof exportPdf;
+    /** Export the document (same options as `exportPdf`, minus `download`)
+     *  and open the browser's print dialog on the resulting vector PDF —
+     *  full print quality, unlike printing the screen canvases. */
+    printPdf: typeof printPdf;
     getKonvaCanvasState: typeof getKonvaCanvasState;
     getFormFieldValues: () => import("../annotation/engine/types.js").FormFieldValue[];
     setFormFieldValue: (fieldName: string, value: string | boolean | string[]) => void;
@@ -180,6 +189,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     clickToSign: boolean;
     readonly: boolean;
     active: boolean;
+    formEditMode: boolean;
     locale: KviewerLocale;
     menuItems: ViewerMenuItem[];
     tools: ViewerToolEntry[];
@@ -188,7 +198,6 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     signatureHandlers: SignatureHandlers;
     viewMode: ViewMode;
     shapeDetection: boolean;
-    formEditMode: boolean;
     roleColors: Record<string, string>;
     activeRoleId: string | null;
     editablePlacedFields: boolean;

package/dist/runtime/components/Viewer.vue

@@ -214,6 +214,7 @@ import {
 } from "../annotation/pdf-import/decode";
 import { getTimestampString } from "../annotation/engine/utils";
 import { downloadPdfBytes } from "../annotation/pdf-export/download";
+import { printPdfBytes } from "../annotation/pdf-export/print";
 import { exportAnnotationsToPdf } from "../annotation/pdf-export/export";
 import { createPageVirtualization } from "../composables/usePageVirtualization";
 import { createPageProxyCache } from "../composables/usePageProxyCache";
@@ -260,7 +261,7 @@ const fieldPlacedCallbacks = /* @__PURE__ */ new Set();
 const signedStatusCallbacks = /* @__PURE__ */ new Set();
 const viewerRoot = ref(null);
 const scrollContainer = ref(null);
-const { state: viewerState, setScrollToPageFn, setDownloadPdfFn, setApplyScaleFn } = provideViewerState();
+const { state: viewerState, setScrollToPageFn, setDownloadPdfFn, setPrintPdfFn, setApplyScaleFn } = provideViewerState();
 watchEffect(() => {
   viewerState.readonly.value = props.readonly ?? false;
 });
@@ -806,6 +807,18 @@ async function exportPdf(options = {}) {
   }
   return bytes;
 }
+async function printPdf(options = {}) {
+  if (scriptingManager?.isReady()) {
+    await scriptingManager.dispatchWillPrint().catch(() => {
+    });
+  }
+  const bytes = await exportPdf({ ...options, download: false });
+  await printPdfBytes(bytes);
+  if (scriptingManager?.isReady()) {
+    scriptingManager.dispatchDidPrint().catch(() => {
+    });
+  }
+}
 async function importAnnotations(annotations, options) {
   const mode = options?.mode ?? "replace";
   const normalized = normalizeImportedAnnotations(
@@ -1025,6 +1038,9 @@ onMounted(() => {
   setDownloadPdfFn(async () => {
     await exportPdf({ download: true });
   });
+  setPrintPdfFn(async () => {
+    await printPdf();
+  });
   loadDocument();
   window.addEventListener("keydown", onGlobalKeydown);
 });
@@ -1094,6 +1110,10 @@ defineExpose({
   getAnnotations: () => painter?.getData() ?? [],
   importAnnotations,
   exportPdf,
+  /** Export the document (same options as `exportPdf`, minus `download`)
+   *  and open the browser's print dialog on the resulting vector PDF —
+   *  full print quality, unlike printing the screen canvases. */
+  printPdf,
   getKonvaCanvasState,
   getFormFieldValues: () => formFieldsState.getAllFieldValues(),
   setFormFieldValue: (fieldName, value) => formFieldsState.setFieldValueByName(fieldName, value),

package/dist/runtime/components/Viewer.vue.d.ts

@@ -78,6 +78,11 @@ type __VLS_Props = {
     messages?: KviewerMessageOverrides;
 };
 declare function exportPdf(options?: ExportPdfOptions): Promise<Uint8Array>;
+/** Print via the real PDF instead of the on-screen canvases: export the
+ *  document (annotations + form values baked in) and hand the vector bytes
+ *  to the browser's native PDF print pipeline. Screen canvases are sized
+ *  for the monitor and would come out blurry on paper. */
+declare function printPdf(options?: ExportPdfOptions): Promise<void>;
 type ImportMode = 'replace' | 'merge';
 declare function importAnnotations(annotations: IAnnotationStore[], options?: {
     mode?: ImportMode;
@@ -100,6 +105,10 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     getAnnotations: () => IAnnotationStore[];
     importAnnotations: typeof importAnnotations;
     exportPdf: typeof exportPdf;
+    /** Export the document (same options as `exportPdf`, minus `download`)
+     *  and open the browser's print dialog on the resulting vector PDF —
+     *  full print quality, unlike printing the screen canvases. */
+    printPdf: typeof printPdf;
     getKonvaCanvasState: typeof getKonvaCanvasState;
     getFormFieldValues: () => import("../annotation/engine/types.js").FormFieldValue[];
     setFormFieldValue: (fieldName: string, value: string | boolean | string[]) => void;
@@ -180,6 +189,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     clickToSign: boolean;
     readonly: boolean;
     active: boolean;
+    formEditMode: boolean;
     locale: KviewerLocale;
     menuItems: ViewerMenuItem[];
     tools: ViewerToolEntry[];
@@ -188,7 +198,6 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     signatureHandlers: SignatureHandlers;
     viewMode: ViewMode;
     shapeDetection: boolean;
-    formEditMode: boolean;
     roleColors: Record<string, string>;
     activeRoleId: string | null;
     editablePlacedFields: boolean;

package/dist/runtime/components/tools/ToolbarMenu.vue

@@ -13,6 +13,16 @@
           data-testid="viewer-download"
           @click="onDownload"
         />
+        <UButton
+          icon="i-lucide-printer"
+          :label="t('print')"
+          variant="ghost"
+          color="neutral"
+          size="xs"
+          class="w-full justify-start"
+          data-testid="viewer-print"
+          @click="onPrint"
+        />
         <UButton
           :icon="state.shapeDetection.value ? 'i-lucide-square-check-big' : 'i-lucide-square-dashed'"
           :label="state.shapeDetection.value ? t('disableFormFieldDetection') : t('detectFormFields')"
@@ -76,4 +86,11 @@ async function onDownload() {
     console.error("Failed to export PDF from menu action", error);
   }
 }
+async function onPrint() {
+  try {
+    await state.printPdf();
+  } catch (error) {
+    console.error("Failed to print PDF from menu action", error);
+  }
+}
 </script>

package/dist/runtime/composables/useScriptingManager.d.ts

@@ -44,6 +44,11 @@ export interface ScriptingManager {
      *  PageOpen action can fire (the manager's `updatefromsandbox` /
      *  pagerendered handling in pdf_viewer.mjs). */
     notifyPageRendered: (pageNumber: number) => void;
+    /** Run the document's `WillPrint` action and wait for the sandbox to
+     *  finish it (scripts may adjust field values before printing). */
+    dispatchWillPrint: () => Promise<void>;
+    /** Fire the document's `DidPrint` action. */
+    dispatchDidPrint: () => Promise<void>;
     /** Bind a document to the sandbox. Safe to call repeatedly — pass
      *  null to detach (e.g. before swapping documents). */
     setDocument: (pdfDoc: PDFDocumentProxy | null) => Promise<void>;

package/dist/runtime/composables/useScriptingManager.js

@@ -104,6 +104,12 @@ export async function createScriptingManager(deps) {
     notifyPageRendered(pageNumber) {
       eventBus.dispatch("pagerendered", { source: window, pageNumber });
     },
+    async dispatchWillPrint() {
+      await manager.dispatchWillPrint();
+    },
+    async dispatchDidPrint() {
+      await manager.dispatchDidPrint();
+    },
     async setDocument(pdfDoc) {
       await manager.setDocument(pdfDoc);
     },

package/dist/runtime/composables/useViewerState.d.ts

@@ -54,6 +54,7 @@ export interface ViewerState {
     setStylusMode: (enabled: boolean) => void;
     scrollToPage: (pageNumber: number) => void;
     downloadPdf: () => Promise<void>;
+    printPdf: () => Promise<void>;
     history: AnnotationHistory;
     readonly: Ref<boolean>;
     shapeDetection: Ref<boolean>;
@@ -66,6 +67,7 @@ export interface ViewerStateProvider {
     state: ViewerState;
     setScrollToPageFn: (fn: (pageNumber: number) => void) => void;
     setDownloadPdfFn: (fn: () => Promise<void>) => void;
+    setPrintPdfFn: (fn: () => Promise<void>) => void;
     /** Register how custom-scale changes are applied. The Viewer registers a
      *  position-preserving commit (zoom about the viewport centre); without
      *  one, setScale falls back to a plain scale write. */

package/dist/runtime/composables/useViewerState.js

@@ -152,12 +152,16 @@ export function provideViewerState() {
   }
   let _scrollToPageFn = null;
   let _downloadPdfFn = null;
+  let _printPdfFn = null;
   function scrollToPage(pageNumber) {
     _scrollToPageFn?.(pageNumber);
   }
   async function downloadPdf() {
     await _downloadPdfFn?.();
   }
+  async function printPdf() {
+    await _printPdfFn?.();
+  }
   const history = createAnnotationHistory(annotations, painter);
   const state = {
     scale,
@@ -200,6 +204,7 @@ export function provideViewerState() {
     setStylusMode,
     scrollToPage,
     downloadPdf,
+    printPdf,
     history,
     readonly,
     shapeDetection: shapeDetectionEnabled,
@@ -217,6 +222,9 @@ export function provideViewerState() {
     setDownloadPdfFn(fn) {
       _downloadPdfFn = fn;
     },
+    setPrintPdfFn(fn) {
+      _printPdfFn = fn;
+    },
     setApplyScaleFn(fn) {
       _applyScaleFn = fn;
     }

package/dist/runtime/embed/bridge-client.d.ts

@@ -44,6 +44,10 @@ export declare class KViewerEmbedClient {
         skipped: number;
     }>;
     exportPdf(options?: ExportPdfOptions): Promise<Uint8Array>;
+    /** Open the viewer's print dialog on the exported (vector) PDF —
+     *  annotations and form values included, at full print quality.
+     *  Resolves once the dialog is up, not when printing finishes. */
+    printPdf(options?: Omit<ExportPdfOptions, 'download' | 'fileName'>): Promise<void>;
     getFormFieldValues(): Promise<FormFieldValue[]>;
     setFormFieldValue(fieldName: string, value: string | boolean | string[]): Promise<void>;
     addFormField(payload: AddFormFieldPayload): Promise<FormFieldDefinition>;

package/dist/runtime/embed/bridge-client.js

@@ -60,6 +60,12 @@ export class KViewerEmbedClient {
   exportPdf(options) {
     return this.call("exportPdf", options);
   }
+  /** Open the viewer's print dialog on the exported (vector) PDF —
+   *  annotations and form values included, at full print quality.
+   *  Resolves once the dialog is up, not when printing finishes. */
+  printPdf(options) {
+    return this.call("printPdf", options);
+  }
   getFormFieldValues() {
     return this.call("getFormFieldValues");
   }

package/dist/runtime/embed/bridge-host.d.ts

@@ -17,6 +17,7 @@ export interface KViewerApi {
         skipped: number;
     }>;
     exportPdf: (options?: ExportPdfOptions) => Promise<Uint8Array>;
+    printPdf: (options?: ExportPdfOptions) => Promise<void>;
     getFormFieldValues: () => FormFieldValue[];
     setFormFieldValue: (fieldName: string, value: string | boolean | string[]) => void;
     addFormField: (payload: AddFormFieldPayload) => FormFieldDefinition;
@@ -39,6 +40,14 @@ export interface KViewerApi {
     getViewedPages: () => number[];
     resetViewedPages: () => void;
 }
+/**
+ * What the bridge actually requires of a host. Every capability is
+ * optional so an embedding application can hand over an adapter exposing
+ * only the parts it uses — a real `<KViewer>` ref satisfies this too.
+ * Unimplemented methods surface as an `UNSUPPORTED_METHOD_ERROR_NAME`
+ * response instead of breaking initialization.
+ */
+export type KViewerHostApi = Partial<KViewerApi>;
 export interface KViewerEmbedBridgeOptions {
     /**
      * Origin of the parent window that hosts this iframe. Used both as
@@ -67,5 +76,5 @@ interface BridgeHandle {
     /** Manually tear down listeners. Called automatically on scope dispose. */
     unmount: () => void;
 }
-export declare function useKViewerEmbedBridge(viewerRef: Ref<KViewerApi | null | undefined>, options: KViewerEmbedBridgeOptions): BridgeHandle;
+export declare function useKViewerEmbedBridge(viewerRef: Ref<KViewerHostApi | null | undefined>, options: KViewerEmbedBridgeOptions): BridgeHandle;
 export type { MethodName };

package/dist/runtime/embed/bridge-host.js

@@ -3,8 +3,42 @@ import {
   EVENT_KIND,
   KVIEWER_EMBED_PROTOCOL_VERSION,
   RESPONSE_KIND,
+  UNSUPPORTED_METHOD_ERROR_NAME,
   isRequest
 } from "./protocol.js";
+const METHOD_REQUIREMENT = {
+  getAnnotations: "getAnnotations",
+  importAnnotations: "importAnnotations",
+  exportPdf: "exportPdf",
+  printPdf: "printPdf",
+  getFormFieldValues: "getFormFieldValues",
+  setFormFieldValue: "setFormFieldValue",
+  addFormField: "addFormField",
+  updateFormField: "updateFormField",
+  removeFormField: "removeFormField",
+  getFormFields: "getFormFields",
+  setFieldDefaults: "setFieldDefaults",
+  setClickToSign: "setClickToSign",
+  getSignedStatus: "getSignedStatus",
+  getSignatureFieldStatus: "getSignatureFieldStatus",
+  getFormEditMode: "formEditMode",
+  setFormEditMode: "setFormEditMode",
+  toggleFormEditMode: "toggleFormEditMode",
+  allPagesRead: "allPagesRead",
+  getViewedPages: "getViewedPages",
+  resetViewedPages: "resetViewedPages"
+};
+const ALL_METHODS = Object.keys(METHOD_REQUIREMENT);
+function supportsMethod(viewer, method) {
+  const member = METHOD_REQUIREMENT[method];
+  if (!member) return false;
+  return member === "formEditMode" ? viewer.formEditMode !== void 0 : typeof viewer[member] === "function";
+}
+function unsupportedMethodError(method) {
+  const err = new Error(`KViewer embed host does not implement "${method}"`);
+  err.name = UNSUPPORTED_METHOD_ERROR_NAME;
+  return err;
+}
 export function useKViewerEmbedBridge(viewerRef, options) {
   const allowAny = options.parentOrigin === "*";
   const winMaybe = options.windowRef ?? (typeof window !== "undefined" ? window : void 0);
@@ -28,10 +62,17 @@ export function useKViewerEmbedBridge(viewerRef, options) {
     parent.postMessage(message, options.parentOrigin);
   }
   async function dispatch(req) {
-    const viewer = viewerRef.value;
-    if (!viewer) {
+    const host = viewerRef.value;
+    if (!host) {
       throw new Error("KViewer ref is not yet available");
     }
+    if (!(req.method in METHOD_REQUIREMENT)) {
+      throw new Error(`Unknown KViewer embed method: ${req.method}`);
+    }
+    if (!supportsMethod(host, req.method)) {
+      throw unsupportedMethodError(req.method);
+    }
+    const viewer = host;
     switch (req.method) {
       case "getAnnotations":
         return viewer.getAnnotations();
@@ -43,6 +84,11 @@ export function useKViewerEmbedBridge(viewerRef, options) {
         const [opts] = req.args;
         return viewer.exportPdf(opts);
       }
+      case "printPdf": {
+        const [opts] = req.args;
+        await viewer.printPdf(opts);
+        return void 0;
+      }
       case "getFormFieldValues":
         return viewer.getFormFieldValues();
       case "setFormFieldValue": {
@@ -138,32 +184,60 @@ export function useKViewerEmbedBridge(viewerRef, options) {
       for (const stop of stopViewerStateWatches) stop();
       stopViewerStateWatches = [];
       if (!viewer) return;
-      postEvent("ready", { protocolVersion: KVIEWER_EMBED_PROTOCOL_VERSION });
-      stopViewerStateWatches.push(
-        watch(
-          () => unref(viewer.formEditMode),
-          (enabled) => postEvent("formEditMode-changed", { enabled })
-        ),
-        viewer.onFieldPlaced(
-          (field) => postEvent("field-placed", { field })
-        ),
-        viewer.onSignedStatusChanged(
-          (payload) => postEvent("signedStatus-changed", payload)
-        ),
-        // Read-tracking. The getters touch the viewer's reactive viewed-pages
-        // state, so watch re-runs them whenever a page is viewed or tracking
-        // is reset.
-        watch(
-          () => viewer.allPagesRead(),
-          (read, prev) => {
-            if (read && !prev) postEvent("all-pages-read", {});
-          }
-        ),
-        watch(
-          () => viewer.getViewedPages(),
-          (pages) => postEvent("viewedPages-changed", { pages, allRead: viewer.allPagesRead() })
-        )
-      );
+      const events = ["ready"];
+      if (viewer.formEditMode !== void 0) {
+        events.push("formEditMode-changed");
+        stopViewerStateWatches.push(
+          watch(
+            () => unref(viewer.formEditMode),
+            (enabled) => postEvent("formEditMode-changed", { enabled: enabled ?? false })
+          )
+        );
+      }
+      if (typeof viewer.onFieldPlaced === "function") {
+        events.push("field-placed");
+        stopViewerStateWatches.push(
+          viewer.onFieldPlaced(
+            (field) => postEvent("field-placed", { field })
+          )
+        );
+      }
+      if (typeof viewer.onSignedStatusChanged === "function") {
+        events.push("signedStatus-changed");
+        stopViewerStateWatches.push(
+          viewer.onSignedStatusChanged(
+            (payload) => postEvent("signedStatus-changed", payload)
+          )
+        );
+      }
+      if (typeof viewer.allPagesRead === "function") {
+        events.push("all-pages-read");
+        stopViewerStateWatches.push(
+          watch(
+            () => viewer.allPagesRead?.() ?? false,
+            (read, prev) => {
+              if (read && !prev) postEvent("all-pages-read", {});
+            }
+          )
+        );
+      }
+      if (typeof viewer.getViewedPages === "function") {
+        events.push("viewedPages-changed");
+        stopViewerStateWatches.push(
+          watch(
+            () => viewer.getViewedPages?.() ?? [],
+            (pages) => postEvent("viewedPages-changed", {
+              pages,
+              allRead: viewer.allPagesRead?.() ?? false
+            })
+          )
+        );
+      }
+      postEvent("ready", {
+        protocolVersion: KVIEWER_EMBED_PROTOCOL_VERSION,
+        methods: ALL_METHODS.filter((method) => supportsMethod(viewer, method)),
+        events
+      });
     },
     { immediate: true }
   );

package/dist/runtime/embed/protocol.d.ts

@@ -4,6 +4,12 @@ export declare const KVIEWER_EMBED_PROTOCOL_VERSION = 1;
 export declare const REQUEST_KIND: "kviewer:request";
 export declare const RESPONSE_KIND: "kviewer:response";
 export declare const EVENT_KIND: "kviewer:event";
+/**
+ * `error.name` on a response rejected because the embedding host's viewer
+ * adapter does not implement the requested method. Lets a parent tell a
+ * missing capability apart from a genuine failure inside the viewer.
+ */
+export declare const UNSUPPORTED_METHOD_ERROR_NAME = "KViewerUnsupportedMethodError";
 export type ImportAnnotationsMode = 'replace' | 'merge';
 export interface MethodSignatures {
     getAnnotations: {
@@ -23,6 +29,10 @@ export interface MethodSignatures {
         args: [options?: ExportPdfOptions];
         result: Uint8Array;
     };
+    printPdf: {
+        args: [options?: Omit<ExportPdfOptions, 'download' | 'fileName'>];
+        result: undefined;
+    };
     getFormFieldValues: {
         args: [];
         result: FormFieldValue[];
@@ -115,6 +125,13 @@ export type ResponseMessage<M extends MethodName = MethodName> = {
 export interface EventPayloads {
     ready: {
         protocolVersion: number;
+        /** Methods the host's viewer adapter implements. Absent on hosts
+         *  predating capability discovery, where the full API was mandatory —
+         *  treat `undefined` as "assume everything". */
+        methods?: MethodName[];
+        /** Events the host actually subscribed to. Same `undefined` caveat as
+         *  `methods`. */
+        events?: EventName[];
     };
     'formEditMode-changed': {
         enabled: boolean;

package/dist/runtime/embed/protocol.js

@@ -2,6 +2,7 @@ export const KVIEWER_EMBED_PROTOCOL_VERSION = 1;
 export const REQUEST_KIND = "kviewer:request";
 export const RESPONSE_KIND = "kviewer:response";
 export const EVENT_KIND = "kviewer:event";
+export const UNSUPPORTED_METHOD_ERROR_NAME = "KViewerUnsupportedMethodError";
 export function isRequest(msg) {
   return !!msg && typeof msg === "object" && msg.kind === REQUEST_KIND && msg.v === KVIEWER_EMBED_PROTOCOL_VERSION;
 }

package/dist/runtime/i18n/messages.d.ts

@@ -15,6 +15,7 @@ export declare const messages: {
         readonly clear: "Clear";
         readonly delete: "Delete";
         readonly download: "Download";
+        readonly print: "Print";
         readonly search: "Search";
         readonly marqueeSelect: "Marquee select";
         readonly eraser: "Eraser";
@@ -141,6 +142,7 @@ export declare const messages: {
         readonly clear: "Leeren";
         readonly delete: "Löschen";
         readonly download: "Herunterladen";
+        readonly print: "Drucken";
         readonly search: "Suchen";
         readonly marqueeSelect: "Mehrfachauswahl";
         readonly eraser: "Radierer";

package/dist/runtime/i18n/messages.js

@@ -7,6 +7,7 @@ export const messages = {
     clear: "Clear",
     delete: "Delete",
     download: "Download",
+    print: "Print",
     // Toolbar
     search: "Search",
     marqueeSelect: "Marquee select",
@@ -140,6 +141,7 @@ export const messages = {
     clear: "Leeren",
     delete: "L\xF6schen",
     download: "Herunterladen",
+    print: "Drucken",
     search: "Suchen",
     marqueeSelect: "Mehrfachauswahl",
     eraser: "Radierer",

package/dist/runtime/public-types.d.ts

@@ -3,11 +3,11 @@ export type { ViewerTabItem, AddTabOptions } from './components/ViewerTabs.vue.j
 export type { AddFormFieldPayload, CheckboxStyle, FormFieldDefinition, FormFieldOrigin, FormFieldType, FormFieldValue, PlacedFieldDefaultProps, PlacedFieldDefaults, SignatureData, SignatureFieldStatus, SignatureHandlers, } from './annotation/engine/types.js';
 export type { ViewMode } from './composables/viewMode.js';
 export type { ViewerState, ActiveTool } from './composables/useViewerState.js';
-export type { KViewerApi, KViewerEmbedBridgeOptions, } from './embed/bridge-host.js';
+export type { KViewerApi, KViewerHostApi, KViewerEmbedBridgeOptions, } from './embed/bridge-host.js';
 export { useKViewerEmbedBridge } from './embed/bridge-host.js';
 export type { KViewerEmbedClientOptions } from './embed/bridge-client.js';
 export { KViewerEmbedClient } from './embed/bridge-client.js';
 export type { EventName as KViewerEmbedEventName, EventPayloads as KViewerEmbedEventPayloads, MethodName as KViewerEmbedMethodName, } from './embed/protocol.js';
-export { KVIEWER_EMBED_PROTOCOL_VERSION } from './embed/protocol.js';
+export { KVIEWER_EMBED_PROTOCOL_VERSION, UNSUPPORTED_METHOD_ERROR_NAME as KVIEWER_EMBED_UNSUPPORTED_METHOD_ERROR_NAME, } from './embed/protocol.js';
 export type { ViewerMenuItem, ViewerMenuButtonItem, ViewerMenuCheckboxItem, ViewerMenuSeparatorItem, } from './menu-items.js';
 export type { ViewerToolId, ViewerTopToolId, ViewerBottomToolId, ViewerLayoutToolId, ViewerToolEntry, ViewerToolSlot, } from './toolbar-tools.js';

package/dist/runtime/public-types.js

@@ -1,3 +1,6 @@
 export { useKViewerEmbedBridge } from "./embed/bridge-host.js";
 export { KViewerEmbedClient } from "./embed/bridge-client.js";
-export { KVIEWER_EMBED_PROTOCOL_VERSION } from "./embed/protocol.js";
+export {
+  KVIEWER_EMBED_PROTOCOL_VERSION,
+  UNSUPPORTED_METHOD_ERROR_NAME as KVIEWER_EMBED_UNSUPPORTED_METHOD_ERROR_NAME
+} from "./embed/protocol.js";

package/dist/types.d.mts

@@ -1,4 +1,4 @@
-export { type ActiveTool, type AddFormFieldPayload, type CheckboxStyle, type ExportPdfOptions, type FormFieldDefinition, type FormFieldOrigin, type FormFieldType, type FormFieldValue, type KVIEWER_EMBED_PROTOCOL_VERSION, type KViewerApi, type KViewerEmbedBridgeOptions, type KViewerEmbedClient, type KViewerEmbedClientOptions, type KViewerEmbedEventName, type KViewerEmbedEventPayloads, type KViewerEmbedMethodName, type PlacedFieldDefaults, type SignatureData, type SignatureFieldStatus, type SignatureHandlers, type ViewMode, type ViewerBottomToolId, type ViewerLayoutToolId, type ViewerMenuButtonItem, type ViewerMenuCheckboxItem, type ViewerMenuItem, type ViewerMenuSeparatorItem, type ViewerState, type ViewerToolEntry, type ViewerToolId, type ViewerToolSlot, type ViewerTopToolId, type useKViewerEmbedBridge } from '../dist/runtime/public-types.js'
+export { type ActiveTool, type AddFormFieldPayload, type CheckboxStyle, type ExportPdfOptions, type FormFieldDefinition, type FormFieldOrigin, type FormFieldType, type FormFieldValue, type KVIEWER_EMBED_PROTOCOL_VERSION, type KVIEWER_EMBED_UNSUPPORTED_METHOD_ERROR_NAME, type KViewerApi, type KViewerEmbedBridgeOptions, type KViewerEmbedClient, type KViewerEmbedClientOptions, type KViewerEmbedEventName, type KViewerEmbedEventPayloads, type KViewerEmbedMethodName, type KViewerHostApi, type PlacedFieldDefaults, type SignatureData, type SignatureFieldStatus, type SignatureHandlers, type ViewMode, type ViewerBottomToolId, type ViewerLayoutToolId, type ViewerMenuButtonItem, type ViewerMenuCheckboxItem, type ViewerMenuItem, type ViewerMenuSeparatorItem, type ViewerState, type ViewerToolEntry, type ViewerToolId, type ViewerToolSlot, type ViewerTopToolId, type useKViewerEmbedBridge } from '../dist/runtime/public-types.js'
 
 export { default } from './module.mjs'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kviewer",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Kabema PDF Editor",
   "repository": "kabema/kviewer",
   "license": "MIT",