@arbidocs/react 0.5.110 → 0.5.112

package/dist/workspaces/workspace-users.js

@@ -0,0 +1,65 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "../useArbi.js";
+import { arbiMutationKeys, arbiQueryKeys } from "../hooks.js";
+const MEMBERS_STALE_MS = 15 * 60 * 1e3;
+function useWorkspaceUsers(workspaceId, options) {
+  const arbi = useArbi();
+  const workspace = workspaceId ?? (arbi.hasWorkspace ? arbi.getWorkspaceId() : "");
+  return useQuery({
+    queryKey: arbiQueryKeys.workspaceUsers(workspace),
+    enabled: !!workspace && (options?.enabled ?? arbi.hasWorkspace),
+    queryFn: async () => {
+      await options?.beforeFetch?.();
+      return arbi.readInWorkspace(workspace, () => arbi.workspaces.listUsers());
+    },
+    staleTime: MEMBERS_STALE_MS
+  });
+}
+function settleMembership(qc) {
+  return Promise.all([
+    qc.invalidateQueries({ queryKey: arbiQueryKeys.allWorkspaceUsers() }),
+    qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() }),
+    // A project's collaborator quota counts workspace members.
+    qc.invalidateQueries({ queryKey: arbiQueryKeys.projects() })
+  ]);
+}
+function useAddWorkspaceMembers() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationKey: arbiMutationKeys.workspaceMembership(),
+    mutationFn: (request) => arbi.workspaces.addMembers(request),
+    onSuccess: () => Promise.all([
+      settleMembership(qc),
+      qc.invalidateQueries({ queryKey: arbiQueryKeys.contacts() })
+    ])
+  });
+}
+function useRemoveWorkspaceMembers(workspaceId) {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationKey: arbiMutationKeys.workspaceMembership(),
+    mutationFn: (userIds) => workspaceId ? arbi.workspaces.removeUsers(userIds, { workspaceId }) : arbi.workspaces.removeUsers(userIds),
+    onSuccess: () => settleMembership(qc)
+  });
+}
+function useSetWorkspaceMemberRoles() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationKey: arbiMutationKeys.setWorkspaceMemberRoles(),
+    mutationFn: ({ userIds, role }) => arbi.workspaces.setUserRole(userIds, role),
+    onSuccess: () => Promise.all([
+      qc.invalidateQueries({ queryKey: arbiQueryKeys.allWorkspaceUsers() }),
+      qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() })
+    ])
+  });
+}
+export {
+  useAddWorkspaceMembers,
+  useRemoveWorkspaceMembers,
+  useSetWorkspaceMemberRoles,
+  useWorkspaceUsers
+};
+//# sourceMappingURL=workspace-users.js.map

package/dist/workspaces/workspace-users.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/workspaces/workspace-users.ts"],
+  "sourcesContent": ["/**\n * A workspace's members and the writes that change them: adding people (standing membership, a\n * session-scoped grant, an invitation, a resource share), removing them, changing their role.\n *\n * The member list is read when shown and kept for 15 minutes; members change rarely and every\n * write here re-reads it, so it is not polled.\n */\n\nimport { useMutation, useQuery, useQueryClient, type QueryClient } from '@tanstack/react-query'\nimport type { components } from '@arbidocs/client'\nimport type { workspaces } from '@arbidocs/sdk/browser'\nimport { useArbi } from '../useArbi'\nimport { arbiMutationKeys, arbiQueryKeys } from '../hooks'\n\nexport type WorkspaceMember = components['schemas']['WorkspaceUserResponse']\nexport type AddWorkspaceMembersRequest = workspaces.AddWorkspaceMembersRequest\nexport type WorkspaceRole = 'owner' | 'collaborator' | 'guest'\n\n/** How long a member list is trusted before it is read again on use. */\nconst MEMBERS_STALE_MS = 15 * 60 * 1000\n\n/**\n * A workspace's members (default: the open one). `beforeFetch` runs first (e.g. to re-open the\n * workspace on the session); `enabled` overrides the \"a workspace is open\" gate.\n */\nexport function useWorkspaceUsers(\n  workspaceId?: string | null,\n  options?: {\n    enabled?: boolean\n    beforeFetch?: () => Promise<unknown>\n  }\n) {\n  const arbi = useArbi()\n  const workspace = workspaceId ?? (arbi.hasWorkspace ? arbi.getWorkspaceId() : '')\n  return useQuery({\n    queryKey: arbiQueryKeys.workspaceUsers(workspace),\n    enabled: !!workspace && (options?.enabled ?? arbi.hasWorkspace),\n    queryFn: async (): Promise<WorkspaceMember[]> => {\n      await options?.beforeFetch?.()\n      return arbi.readInWorkspace(workspace, () => arbi.workspaces.listUsers())\n    },\n    staleTime: MEMBERS_STALE_MS,\n  })\n}\n\n/** What a membership change affects: the member lists and the workspaces (their member counts). */\nfunction settleMembership(qc: QueryClient): Promise<unknown> {\n  return Promise.all([\n    qc.invalidateQueries({ queryKey: arbiQueryKeys.allWorkspaceUsers() }),\n    qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() }),\n    // A project's collaborator quota counts workspace members.\n    qc.invalidateQueries({ queryKey: arbiQueryKeys.projects() }),\n  ])\n}\n\n/**\n * Add people to a workspace, with the whole request: the open workspace, or `workspace_ext_id`\n * with its key sealed to this session; a session-scoped grant (`session_pubkey_b64`); an invitation\n * to people not on the platform (`confirm_invite`, which also leaves a pending grant on their\n * contact); a share of one resource (`resource_type`, `resource_ext_id`). Resolves with the\n * memberships added (someone already a member, or not on the platform, is missing from it).\n */\nexport function useAddWorkspaceMembers() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationKey: arbiMutationKeys.workspaceMembership(),\n    mutationFn: (request: AddWorkspaceMembersRequest): Promise<WorkspaceMember[]> =>\n      arbi.workspaces.addMembers(request),\n    onSuccess: () =>\n      Promise.all([\n        settleMembership(qc),\n        qc.invalidateQueries({ queryKey: arbiQueryKeys.contacts() }),\n      ]),\n  })\n}\n\n/**\n * Remove people from `workspaceId` (default: the open workspace, read when the removal is sent),\n * owners only; anyone may remove themselves: leaving. The request names the workspace, so a\n * switch meanwhile cannot move the removal to another one.\n */\nexport function useRemoveWorkspaceMembers(workspaceId?: string | null) {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationKey: arbiMutationKeys.workspaceMembership(),\n    mutationFn: (userIds: string[]) =>\n      workspaceId\n        ? arbi.workspaces.removeUsers(userIds, { workspaceId })\n        : arbi.workspaces.removeUsers(userIds),\n    onSuccess: () => settleMembership(qc),\n  })\n}\n\n/** Change people's role in the open workspace (owners). */\nexport function useSetWorkspaceMemberRoles() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationKey: arbiMutationKeys.setWorkspaceMemberRoles(),\n    mutationFn: ({ userIds, role }: { userIds: string[]; role: WorkspaceRole }) =>\n      arbi.workspaces.setUserRole(userIds, role),\n    onSuccess: () =>\n      Promise.all([\n        qc.invalidateQueries({ queryKey: arbiQueryKeys.allWorkspaceUsers() }),\n        qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() }),\n      ]),\n  })\n}\n"],
+  "mappings": "AAQA,SAAS,aAAa,UAAU,sBAAwC;AAGxE,SAAS,eAAe;AACxB,SAAS,kBAAkB,qBAAqB;AAOhD,MAAM,mBAAmB,KAAK,KAAK;AAM5B,SAAS,kBACd,aACA,SAIA;AACA,QAAM,OAAO,QAAQ;AACrB,QAAM,YAAY,gBAAgB,KAAK,eAAe,KAAK,eAAe,IAAI;AAC9E,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,eAAe,SAAS;AAAA,IAChD,SAAS,CAAC,CAAC,cAAc,SAAS,WAAW,KAAK;AAAA,IAClD,SAAS,YAAwC;AAC/C,YAAM,SAAS,cAAc;AAC7B,aAAO,KAAK,gBAAgB,WAAW,MAAM,KAAK,WAAW,UAAU,CAAC;AAAA,IAC1E;AAAA,IACA,WAAW;AAAA,EACb,CAAC;AACH;AAGA,SAAS,iBAAiB,IAAmC;AAC3D,SAAO,QAAQ,IAAI;AAAA,IACjB,GAAG,kBAAkB,EAAE,UAAU,cAAc,kBAAkB,EAAE,CAAC;AAAA,IACpE,GAAG,kBAAkB,EAAE,UAAU,cAAc,WAAW,EAAE,CAAC;AAAA;AAAA,IAE7D,GAAG,kBAAkB,EAAE,UAAU,cAAc,SAAS,EAAE,CAAC;AAAA,EAC7D,CAAC;AACH;AASO,SAAS,yBAAyB;AACvC,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAK,eAAe;AAC1B,SAAO,YAAY;AAAA,IACjB,aAAa,iBAAiB,oBAAoB;AAAA,IAClD,YAAY,CAAC,YACX,KAAK,WAAW,WAAW,OAAO;AAAA,IACpC,WAAW,MACT,QAAQ,IAAI;AAAA,MACV,iBAAiB,EAAE;AAAA,MACnB,GAAG,kBAAkB,EAAE,UAAU,cAAc,SAAS,EAAE,CAAC;AAAA,IAC7D,CAAC;AAAA,EACL,CAAC;AACH;AAOO,SAAS,0BAA0B,aAA6B;AACrE,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAK,eAAe;AAC1B,SAAO,YAAY;AAAA,IACjB,aAAa,iBAAiB,oBAAoB;AAAA,IAClD,YAAY,CAAC,YACX,cACI,KAAK,WAAW,YAAY,SAAS,EAAE,YAAY,CAAC,IACpD,KAAK,WAAW,YAAY,OAAO;AAAA,IACzC,WAAW,MAAM,iBAAiB,EAAE;AAAA,EACtC,CAAC;AACH;AAGO,SAAS,6BAA6B;AAC3C,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAK,eAAe;AAC1B,SAAO,YAAY;AAAA,IACjB,aAAa,iBAAiB,wBAAwB;AAAA,IACtD,YAAY,CAAC,EAAE,SAAS,KAAK,MAC3B,KAAK,WAAW,YAAY,SAAS,IAAI;AAAA,IAC3C,WAAW,MACT,QAAQ,IAAI;AAAA,MACV,GAAG,kBAAkB,EAAE,UAAU,cAAc,kBAAkB,EAAE,CAAC;AAAA,MACpE,GAAG,kBAAkB,EAAE,UAAU,cAAc,WAAW,EAAE,CAAC;AAAA,IAC/D,CAAC;AAAA,EACL,CAAC;AACH;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/react",
-  "version": "0.5.110",
+  "version": "0.5.112",
   "description": "React hooks and provider for the ARBI SDK",
   "type": "module",
   "sideEffects": false,
@@ -28,6 +28,11 @@
       "import": "./dist/viewers/index.js",
       "require": "./dist/viewers/index.cjs"
     },
+    "./viewers/pdf": {
+      "types": "./dist/viewers/PdfViewer.d.ts",
+      "import": "./dist/viewers/PdfViewer.js",
+      "require": "./dist/viewers/PdfViewer.cjs"
+    },
     "./artifacts": {
       "types": "./dist/artifacts/index.d.ts",
       "import": "./dist/artifacts/index.js",
@@ -75,6 +80,9 @@
       "viewers": [
         "./dist/viewers/index.d.ts"
       ],
+      "viewers/pdf": [
+        "./dist/viewers/PdfViewer.d.ts"
+      ],
       "artifacts": [
         "./dist/artifacts/index.d.ts"
       ],
@@ -102,15 +110,15 @@
     "dist"
   ],
   "scripts": {
-    "build": "node -e \"require('fs').rmSync('.dts',{recursive:true,force:true})\" && tsc -p tsconfig.build.json && tsup",
+    "build": "node -e \"for (const d of ['.dts','dist']) require('fs').rmSync(d,{recursive:true,force:true})\" && tsc -p tsconfig.build.json && tsup && node ../../scripts/build-esm-modules.mjs && node ../../scripts/check-esm-exports.mjs",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build"
   },
   "dependencies": {
-    "@arbidocs/client": "0.5.110",
-    "@arbidocs/sdk": "0.5.110",
+    "@arbidocs/client": "0.5.112",
+    "@arbidocs/sdk": "0.5.112",
     "@didit-protocol/sdk-web": "0.4.0",
     "@livekit/components-react": "2.9.24",
     "@radix-ui/react-avatar": "^1.2.0",

package/dist/PdfViewer.d-bQH9yxFg.d.ts

@@ -1,55 +0,0 @@
-import * as React from 'react';
-import { ReactNode } from 'react';
-
-/** Where the app serves the pdf.js runtime assets from. */
-interface PdfViewerAssets {
-    /** pdf.js worker bundle. Default `/pdf.worker.min.mjs`. */
-    workerSrc?: string;
-    /** Directory of pdf.js character maps. Default `/cmaps/`. */
-    cMapUrl?: string;
-    /** Directory of pdf.js standard font data. Default `/standard_fonts/`. */
-    standardFontDataUrl?: string;
-    /**
-     * Directory of the pdf.js wasm decoders (openjpeg for JPEG 2000, jbig2,
-     * qcms). Scanned PDFs routinely embed JPX/JBIG2-compressed page images;
-     * without these modules pdf.js fails image decoding with only a console
-     * warning and renders blank white pages. Default `/wasm/`.
-     */
-    wasmUrl?: string;
-}
-interface PdfViewerProps {
-    file: string | Blob;
-    currentPage?: number;
-    onLoadSuccess?: (numPages: number) => void;
-    /** Incremented to trigger scroll to currentPage */
-    scrollTrigger?: number;
-    /** Zoom as a multiplier of the fit-width size (1 = fit width). Default 1. */
-    zoom?: number;
-    /** Called by pinch and double-tap; the host owns the value (its buttons change it too). */
-    onZoomChange?: (zoom: number) => void;
-    /**
-     * Called as the user scrolls, with the page occupying most of the viewport.
-     * This is the reusable form of the monolith's `setViewingDocumentPage`.
-     */
-    onPageChange?: (pageNumber: number) => void;
-    /**
-     * Force pdf.js to rasterise fonts onto the canvas instead of using @font-face.
-     * Required when rendering into a different document (e.g. a popped-out window),
-     * where @font-face rules from the opener do not apply.
-     */
-    disableFontFace?: boolean;
-    /** Where the app serves the pdf.js worker, cmaps and standard fonts from. */
-    assets?: PdfViewerAssets;
-    /**
-     * Content drawn over every page, inside its border box (e.g. the annotation layer). It fills the
-     * page area and moves and scales with it. `pageWidthPt` is the page's width in PDF points once
-     * known, so overlays can size strokes and text to match what a later export draws.
-     */
-    renderPageOverlay?: (page: {
-        pageNumber: number;
-        pageWidthPt: number | undefined;
-    }) => ReactNode;
-}
-declare function PdfViewer({ file, currentPage, onLoadSuccess, scrollTrigger, zoom, onZoomChange, onPageChange, disableFontFace, assets, renderPageOverlay, }: PdfViewerProps): React.JSX.Element;
-
-export { PdfViewer as P, type PdfViewerAssets as a, type PdfViewerProps as b };

package/dist/ProductionDialog.d-CpzslFn0.d.cts

@@ -1,51 +0,0 @@
-import * as React from 'react';
-
-/**
- * Asks how to number and package a set of documents as a production. It only collects choices; the
- * host runs `buildBundle` (see `@arbidocs/react/annotations/freeze`) and saves the result.
- *
- * The documents can be put in order (drag a row, or its up/down buttons from the keyboard): that
- * order is the numbering order.
- */
-type ProductionCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-interface ProductionChoices {
-    layout: 'merged' | 'per-document';
-    prefix: string;
-    start: number;
-    digits: number;
-    /** Corner of the Bates label; the QR code, when on, takes the opposite bottom corner. */
-    corner: ProductionCorner;
-    qr: boolean;
-    /** An index page first: every document with its Bates range. */
-    indexPage: boolean;
-    /** Also save the result as a document in the workspace (it is downloaded either way). */
-    saveToWorkspace: boolean;
-    /** Document ids in numbering order. */
-    order: string[];
-}
-interface ProductionDocument {
-    id: string;
-    name: string;
-}
-interface ProductionDialogProps {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    /** The documents, in the order they are numbered until the user reorders them. */
-    documents: ProductionDocument[];
-    /** Selected documents that cannot be included, with the reason, e.g. "photo.jpg (no PDF)". */
-    leftOut?: string[];
-    onConfirm: (choices: ProductionChoices) => void;
-    busy?: boolean;
-    progress?: {
-        done: number;
-        total: number;
-    } | null;
-    error?: string | null;
-}
-/** The QR code sits in the bottom corner the label is not in (the label may be top or bottom). */
-declare function qrCornerFor(corner: ProductionCorner): ProductionCorner;
-/** `items` with the entry at `from` moved to `to`. */
-declare function moveItem<T>(items: readonly T[], from: number, to: number): T[];
-declare function ProductionDialog({ open, onOpenChange, documents, leftOut, onConfirm, busy, progress, error, }: ProductionDialogProps): React.JSX.Element;
-
-export { type ProductionChoices as P, type ProductionCorner as a, ProductionDialog as b, type ProductionDialogProps as c, type ProductionDocument as d, moveItem as m, qrCornerFor as q };

package/dist/annotations/freeze/index.d.cts

@@ -1,205 +0,0 @@
-import { a as AnnotationKind, b as AnnotationLayer, A as Annotation } from '../../model.d-CNtRWKVK.cjs';
-import { a as PdfViewerAssets } from '../../PdfViewer.d-bQH9yxFg.cjs';
-export { B as BatesOptions, a as BundleFile, b as BundleIndexEntry, c as BundleItem, d as BundleLayout, e as BundleOptions, f as BundleResult, S as StampCorner, g as batesLabel, h as buildBundle } from '../../bundle.d-BnCSbHy2.cjs';
-import 'react';
-
-/**
- * `vector` draws marks into the original pages and keeps the text. `image` rasterises every page
- * with the marks burned in, so nothing sits behind a redaction. A layer with redactions is always
- * frozen as `image`.
- */
-type FreezeMode = 'vector' | 'image';
-/** What happens to comments: leave them out, draw numbered markers, or markers plus a listing. */
-type CommentOutput = 'omit' | 'markers' | 'appendix';
-/** A word recognised on a burned page, in fractions of the displayed page (top-left origin). */
-interface OcrWord {
-    text: string;
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
-interface OcrInput {
-    pageNumber: number;
-    bytes: Uint8Array;
-    format: 'jpeg' | 'png';
-    widthPx: number;
-    heightPx: number;
-}
-/** One page drawn on a canvas, ready for marks to be burned in and the result encoded. */
-interface RenderedPage {
-    widthPt: number;
-    heightPt: number;
-    widthPx: number;
-    heightPx: number;
-    /** Resolution actually used; lower than requested when the page was too large. */
-    dpi: number;
-    ctx: CanvasRenderingContext2D;
-    encode(format: 'jpeg' | 'png', quality: number): Promise<Uint8Array>;
-    release(): void;
-}
-interface PageRasterizer {
-    numPages: number;
-    /** Render `pageNumber` (1-based) at `dpi`. The caller must `release()` the result. */
-    renderPage(pageNumber: number, dpi: number): Promise<RenderedPage>;
-    destroy(): Promise<void> | void;
-}
-interface FreezeOptions {
-    mode: FreezeMode;
-    /** Who is freezing; recorded in the provenance. */
-    author: string;
-    /** ISO timestamp; defaults to now. Injectable for deterministic tests. */
-    now?: string;
-    /**
-     * Redaction marks nobody has approved or rejected. `error` (default) refuses to freeze, so an
-     * unreviewed mark cannot slip through; `burn` redacts them anyway (the safe direction).
-     */
-    pendingRedactions?: 'error' | 'burn';
-    comments?: CommentOutput;
-    /** Image mode only. Default 200. Lowered automatically for very large pages. */
-    dpi?: number;
-    imageFormat?: 'jpeg' | 'png';
-    jpegQuality?: number;
-    /** Extra margin burned around each redaction rectangle, in points. Default 1.5. */
-    redactionPaddingPt?: number;
-    /** Print the reason on each redaction box. Default true. */
-    redactionLabels?: boolean;
-    /** Required for image mode: renders pages onto canvases. */
-    rasterizer?: PageRasterizer;
-    /** Optional: recognise text on the burned pages and add it as an invisible layer. */
-    ocr?: (input: OcrInput) => Promise<OcrWord[]>;
-    onProgress?: (done: number, total: number) => void;
-    signal?: AbortSignal;
-}
-interface FreezeProvenance {
-    schema: 1;
-    /** External id of the immutable original this copy was derived from. */
-    derivedFrom: string;
-    originalSha256: string;
-    /** Hash of the layer snapshot, computed WITHOUT the text under redactions. */
-    layerSha256: string;
-    modeRequested: FreezeMode;
-    modeApplied: FreezeMode;
-    modeChangedBecause?: 'redactions-present';
-    frozenAt: string;
-    frozenBy: string;
-    pages: number;
-    dpi?: number;
-    counts: Record<AnnotationKind, number>;
-    /** Counts and reasons only. The redacted text is never recorded here. */
-    redactions: {
-        count: number;
-        pages: number[];
-        reasons: Record<string, number>;
-    };
-}
-interface FreezeResult {
-    bytes: Uint8Array;
-    provenance: FreezeProvenance;
-    /** Things the caller should surface, e.g. characters a built-in font could not draw. */
-    warnings: string[];
-}
-type FreezeErrorCode = 'pending-redactions' | 'rasterizer-required' | 'page-out-of-range' | 'unsupported-text' | 'invalid-pdf' | 'encrypted' | 'invalid-option';
-declare class FreezeError extends Error {
-    readonly code: FreezeErrorCode;
-    constructor(code: FreezeErrorCode, message: string);
-}
-
-/**
- * Freeze: derive a NEW document from an immutable original plus its annotation layer.
- *
- * - `vector`: marks are drawn into the original pages; text stays searchable.
- * - `image`: every page is rasterised with the marks burned in and the PDF is rebuilt from the
- *   images alone. Required whenever a redaction applies, because only a rebuild leaves nothing
- *   behind the box: no text, no metadata, no annotations, no attachments, no old revisions.
- *
- * The layer itself is never embedded. The output carries a provenance record (counts and reasons,
- * never the redacted text).
- */
-
-declare const DEFAULT_DPI = 200;
-declare function freezePdf(original: Uint8Array, rawLayer: AnnotationLayer, options: FreezeOptions): Promise<FreezeResult>;
-/** Read the provenance record back out of a frozen PDF, or null if it has none. */
-declare function readProvenance(bytes: Uint8Array): Promise<FreezeProvenance | null>;
-
-/**
- * Freeze in the browser: wires the pdf.js already loaded for viewing (via react-pdf) into the
- * rasteriser, so a frozen copy is produced client-side and the document never leaves the device.
- */
-
-type BrowserFreezeOptions = Omit<FreezeOptions, 'rasterizer'> & {
-    /** Where the app serves pdf.js cmaps, fonts and wasm from; same shape the viewer takes. */
-    assets?: PdfViewerAssets;
-    password?: string;
-};
-declare function freezePdfInBrowser(bytes: Uint8Array, layer: AnnotationLayer, { assets, password, ...options }: BrowserFreezeOptions): Promise<FreezeResult>;
-
-/**
- * Image-only freeze: render each page onto a canvas, burn the marks into the pixels, and encode.
- * Once a redaction rectangle is painted black the original pixels are gone, and the rebuilt PDF
- * has no text layer, so nothing sits behind the box.
- */
-
-/** A canvas the freeze code can draw on, produced by the host's environment. */
-interface CanvasHandle {
-    canvas: unknown;
-    ctx: CanvasRenderingContext2D;
-    encode(format: 'jpeg' | 'png', quality: number): Promise<Uint8Array>;
-    release(): void;
-}
-type CanvasFactory = (width: number, height: number) => CanvasHandle;
-/** Pages beyond this many pixels are rendered at a lower DPI (mobile Safari fails near 16.7M). */
-declare const MAX_PAGE_PIXELS = 36000000;
-declare function browserCanvasFactory(): CanvasFactory;
-interface PdfJsViewport {
-    width: number;
-    height: number;
-}
-interface PdfJsPage {
-    getViewport(options: {
-        scale: number;
-    }): PdfJsViewport;
-    render(params: {
-        canvasContext: CanvasRenderingContext2D;
-        canvas: unknown;
-        viewport: PdfJsViewport;
-    }): {
-        promise: Promise<void>;
-    };
-    cleanup(): void;
-}
-interface PdfJsDocument {
-    numPages: number;
-    getPage(n: number): Promise<PdfJsPage>;
-}
-interface PdfJsLoadingTask {
-    promise: Promise<PdfJsDocument>;
-    /** pdf.js 6 removed `PDFDocumentProxy.destroy()`; the loading task owns teardown. */
-    destroy(): Promise<void>;
-}
-/** The slice of `pdfjs-dist` the rasteriser needs, so the host decides which build to pass. */
-interface PdfJsModule {
-    getDocument(source: Record<string, unknown>): PdfJsLoadingTask;
-}
-interface PdfJsRasterizerOptions {
-    password?: string;
-    /** Extra `getDocument` options: cMapUrl, standardFontDataUrl, wasmUrl... */
-    documentOptions?: Record<string, unknown>;
-}
-declare function createPdfJsRasterizer(pdfjs: PdfJsModule, data: Uint8Array, canvases: CanvasFactory, options?: PdfJsRasterizerOptions): Promise<PageRasterizer>;
-interface BurnOptions {
-    /** Margin added around each redaction rectangle, in points. */
-    paddingPt: number;
-    labels: boolean;
-    comments: CommentOutput;
-    numbers: Map<string, number>;
-    /** Picture stamps' images, decoded, by mark id (a stamp without one draws its label). */
-    images?: Map<string, CanvasImageSource & {
-        width: number;
-        height: number;
-    }>;
-}
-/** Paint every mark for one page onto its rendered pixels. Redactions go last, on top. */
-declare function burnMarks(page: RenderedPage, marks: Annotation[], options: BurnOptions): void;
-
-export { type BrowserFreezeOptions, type BurnOptions, type CanvasFactory, type CanvasHandle, type CommentOutput, DEFAULT_DPI, FreezeError, type FreezeErrorCode, type FreezeMode, type FreezeOptions, type FreezeProvenance, type FreezeResult, MAX_PAGE_PIXELS, type OcrInput, type OcrWord, type PageRasterizer, type PdfJsModule, type PdfJsRasterizerOptions, type RenderedPage, browserCanvasFactory, burnMarks, createPdfJsRasterizer, freezePdf, freezePdfInBrowser, readProvenance };