@arbidocs/react 0.5.111 → 0.5.113

package/dist/annotations/controller.js

@@ -0,0 +1,49 @@
+const DRAW_TOOLS = ["box", "comment", "stamp", "redact-area"];
+const TEXT_TOOLS = ["highlight", "redact-text"];
+const DEFAULT_SETTINGS = {
+  colors: { highlight: "#ffe066", box: "#e03131", stamp: "#c92a2a" },
+  stampLabel: "[REDACTED]",
+  stampImage: null,
+  redactionReason: "Privileged",
+  strokeWidth: 2
+};
+const HIGHLIGHT_COLORS = ["#ffe066", "#8ce99a", "#74c0fc", "#ffa8a8", "#eebefa"];
+const MARK_COLORS = ["#e03131", "#1c7ed6", "#2f9e44", "#f08c00", "#000000"];
+const STAMP_PRESETS = [
+  "[REDACTED]",
+  "CONFIDENTIAL",
+  "DRAFT",
+  "APPROVED",
+  "FILED",
+  "PRIVILEGED",
+  "COPY"
+];
+const REDACTION_REASONS = [
+  "Privileged",
+  "Confidential",
+  "Personal data",
+  "Commercial",
+  "Irrelevant"
+];
+function layerStatusText(controller) {
+  if (controller.status === "error") return "Could not be loaded";
+  if (controller.readOnly) return "View only";
+  if (controller.offline) {
+    return controller.dirty ? "Offline \u2014 will save when back online" : "Offline";
+  }
+  if (controller.error) return "Not saved \u2014 retrying";
+  if (controller.saving) return "Saving\u2026";
+  if (controller.dirty) return "Unsaved changes";
+  return "Saved";
+}
+export {
+  DEFAULT_SETTINGS,
+  DRAW_TOOLS,
+  HIGHLIGHT_COLORS,
+  MARK_COLORS,
+  REDACTION_REASONS,
+  STAMP_PRESETS,
+  TEXT_TOOLS,
+  layerStatusText
+};
+//# sourceMappingURL=controller.js.map

package/dist/annotations/controller.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/annotations/controller.ts"],
+  "sourcesContent": ["/**\n * The contract between the annotation state (`useAnnotationLayer`) and the UI that draws it\n * (`AnnotationPageOverlay`, `AnnotationToolbar`). Components take a controller as a prop and hold\n * no annotation state of their own beyond transient drags.\n */\n\nimport type { Annotation, AnnotationLayer, RedactionStatus } from './model'\nimport type { AnnotationPatch } from './state'\n\nexport type AnnotationTool =\n  'select' | 'highlight' | 'box' | 'comment' | 'stamp' | 'redact-area' | 'redact-text'\n\nexport const DRAW_TOOLS: readonly AnnotationTool[] = ['box', 'comment', 'stamp', 'redact-area']\nexport const TEXT_TOOLS: readonly AnnotationTool[] = ['highlight', 'redact-text']\n\n/** Tools that colour what they make. */\nexport type ColoredTool = 'highlight' | 'box' | 'stamp'\n\nexport interface ToolSettings {\n  colors: Record<ColoredTool, string>\n  stampLabel: string\n  /** The stamp tool places this picture (one's saved signature or initials) instead of a label. */\n  stampImage: { image: string; label: string } | null\n  redactionReason: string\n  /** Box outline width in points. */\n  strokeWidth: number\n}\n\nexport const DEFAULT_SETTINGS: ToolSettings = {\n  colors: { highlight: '#ffe066', box: '#e03131', stamp: '#c92a2a' },\n  stampLabel: '[REDACTED]',\n  stampImage: null,\n  redactionReason: 'Privileged',\n  strokeWidth: 2,\n}\n\nexport const HIGHLIGHT_COLORS = ['#ffe066', '#8ce99a', '#74c0fc', '#ffa8a8', '#eebefa']\nexport const MARK_COLORS = ['#e03131', '#1c7ed6', '#2f9e44', '#f08c00', '#000000']\nexport const STAMP_PRESETS = [\n  '[REDACTED]',\n  'CONFIDENTIAL',\n  'DRAFT',\n  'APPROVED',\n  'FILED',\n  'PRIVILEGED',\n  'COPY',\n]\nexport const REDACTION_REASONS = [\n  'Privileged',\n  'Confidential',\n  'Personal data',\n  'Commercial',\n  'Irrelevant',\n]\n\n/** A mark as the UI describes it: identity, author and timestamps are added by the controller. */\nexport type NewMark = Annotation extends infer A\n  ? A extends Annotation\n    ? Omit<A, 'id' | 'author' | 'createdAt' | 'updatedAt'>\n    : never\n  : never\n\nexport type LayerStatus = 'loading' | 'ready' | 'error'\n\nexport interface AnnotationController {\n  layer: AnnotationLayer\n  status: LayerStatus\n  /** The last load, save or validation failure, for the UI to show. */\n  error: string | null\n  saving: boolean\n  /** True when edits have not reached the store yet. */\n  dirty: boolean\n  /** The device is offline (or the store unreachable): edits are kept and saved when it is back. */\n  offline: boolean\n  /** View only (e.g. a guest on a shared document): marks show, nothing can be changed. */\n  readOnly: boolean\n  author: string\n\n  tool: AnnotationTool\n  setTool(tool: AnnotationTool): void\n  settings: ToolSettings\n  setSettings(patch: Partial<ToolSettings>): void\n  selectedId: string | null\n  select(id: string | null): void\n\n  add(mark: NewMark): string | null\n  /** Add several marks as ONE undo step (e.g. a selection spanning pages). */\n  addMany(marks: NewMark[]): string[]\n  update(id: string, patch: AnnotationPatch): void\n  remove(id: string): void\n  setRedactionStatus(ids: string[], status: RedactionStatus): void\n  reply(id: string, body: string): void\n  resolve(id: string, resolved: boolean): void\n\n  undo(): void\n  redo(): void\n  canUndo: boolean\n  canRedo: boolean\n  /** Write to the store now (before leaving the page). */\n  flush(): Promise<void>\n}\n\n/** The save state in words, as the toolbar shows it. */\nexport function layerStatusText(controller: AnnotationController): string {\n  if (controller.status === 'error') return 'Could not be loaded'\n  if (controller.readOnly) return 'View only'\n  if (controller.offline) {\n    return controller.dirty ? 'Offline \u2014 will save when back online' : 'Offline'\n  }\n  if (controller.error) return 'Not saved \u2014 retrying'\n  if (controller.saving) return 'Saving\u2026'\n  if (controller.dirty) return 'Unsaved changes'\n  return 'Saved'\n}\n"],
+  "mappings": "AAYO,MAAM,aAAwC,CAAC,OAAO,WAAW,SAAS,aAAa;AACvF,MAAM,aAAwC,CAAC,aAAa,aAAa;AAezE,MAAM,mBAAiC;AAAA,EAC5C,QAAQ,EAAE,WAAW,WAAW,KAAK,WAAW,OAAO,UAAU;AAAA,EACjE,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,aAAa;AACf;AAEO,MAAM,mBAAmB,CAAC,WAAW,WAAW,WAAW,WAAW,SAAS;AAC/E,MAAM,cAAc,CAAC,WAAW,WAAW,WAAW,WAAW,SAAS;AAC1E,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACO,MAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAkDO,SAAS,gBAAgB,YAA0C;AACxE,MAAI,WAAW,WAAW,QAAS,QAAO;AAC1C,MAAI,WAAW,SAAU,QAAO;AAChC,MAAI,WAAW,SAAS;AACtB,WAAO,WAAW,QAAQ,8CAAyC;AAAA,EACrE;AACA,MAAI,WAAW,MAAO,QAAO;AAC7B,MAAI,WAAW,OAAQ,QAAO;AAC9B,MAAI,WAAW,MAAO,QAAO;AAC7B,SAAO;AACT;",
+  "names": []
+}

package/dist/annotations/freeze/browser.js

@@ -0,0 +1,21 @@
+import { pdfjs } from "react-pdf";
+import { isEffectiveRedaction } from "../model.js";
+import { freezePdf } from "./freeze.js";
+import { browserCanvasFactory, createPdfJsRasterizer } from "./raster.js";
+async function freezePdfInBrowser(bytes, layer, { assets, password, ...options }) {
+  const needsRaster = options.mode === "image" || layer.annotations.some(isEffectiveRedaction);
+  const rasterizer = needsRaster ? await createPdfJsRasterizer(pdfjs, bytes, browserCanvasFactory(), {
+    password,
+    documentOptions: {
+      cMapUrl: assets?.cMapUrl ?? "/cmaps/",
+      cMapPacked: true,
+      standardFontDataUrl: assets?.standardFontDataUrl ?? "/standard_fonts/",
+      wasmUrl: assets?.wasmUrl ?? "/wasm/"
+    }
+  }) : void 0;
+  return freezePdf(bytes, layer, { ...options, rasterizer });
+}
+export {
+  freezePdfInBrowser
+};
+//# sourceMappingURL=browser.js.map

package/dist/annotations/freeze/browser.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/annotations/freeze/browser.ts"],
+  "sourcesContent": ["/**\n * Freeze in the browser: wires the pdf.js already loaded for viewing (via react-pdf) into the\n * rasteriser, so a frozen copy is produced client-side and the document never leaves the device.\n */\n\nimport { pdfjs } from 'react-pdf'\nimport type { PdfViewerAssets } from '../../viewers/PdfViewer'\nimport { isEffectiveRedaction, type AnnotationLayer } from '../model'\nimport { freezePdf } from './freeze'\nimport { browserCanvasFactory, createPdfJsRasterizer, type PdfJsModule } from './raster'\nimport type { FreezeOptions, FreezeResult } from './types'\n\nexport type BrowserFreezeOptions = Omit<FreezeOptions, 'rasterizer'> & {\n  /** Where the app serves pdf.js cmaps, fonts and wasm from; same shape the viewer takes. */\n  assets?: PdfViewerAssets\n  password?: string\n}\n\nexport async function freezePdfInBrowser(\n  bytes: Uint8Array,\n  layer: AnnotationLayer,\n  { assets, password, ...options }: BrowserFreezeOptions\n): Promise<FreezeResult> {\n  // Redactions always produce an image copy, so a rasteriser is needed whenever they apply.\n  const needsRaster = options.mode === 'image' || layer.annotations.some(isEffectiveRedaction)\n  const rasterizer = needsRaster\n    ? await createPdfJsRasterizer(pdfjs as unknown as PdfJsModule, bytes, browserCanvasFactory(), {\n        password,\n        documentOptions: {\n          cMapUrl: assets?.cMapUrl ?? '/cmaps/',\n          cMapPacked: true,\n          standardFontDataUrl: assets?.standardFontDataUrl ?? '/standard_fonts/',\n          wasmUrl: assets?.wasmUrl ?? '/wasm/',\n        },\n      })\n    : undefined\n  return freezePdf(bytes, layer, { ...options, rasterizer })\n}\n"],
+  "mappings": "AAKA,SAAS,aAAa;AAEtB,SAAS,4BAAkD;AAC3D,SAAS,iBAAiB;AAC1B,SAAS,sBAAsB,6BAA+C;AAS9E,eAAsB,mBACpB,OACA,OACA,EAAE,QAAQ,UAAU,GAAG,QAAQ,GACR;AAEvB,QAAM,cAAc,QAAQ,SAAS,WAAW,MAAM,YAAY,KAAK,oBAAoB;AAC3F,QAAM,aAAa,cACf,MAAM,sBAAsB,OAAiC,OAAO,qBAAqB,GAAG;AAAA,IAC1F;AAAA,IACA,iBAAiB;AAAA,MACf,SAAS,QAAQ,WAAW;AAAA,MAC5B,YAAY;AAAA,MACZ,qBAAqB,QAAQ,uBAAuB;AAAA,MACpD,SAAS,QAAQ,WAAW;AAAA,IAC9B;AAAA,EACF,CAAC,IACD;AACJ,SAAO,UAAU,OAAO,OAAO,EAAE,GAAG,SAAS,WAAW,CAAC;AAC3D;",
+  "names": []
+}

package/dist/annotations/freeze/bundle.js

@@ -0,0 +1,201 @@
+import { PDFDocument, PDFHexString, PDFName, StandardFonts } from "pdf-lib";
+import { loadPdfDocument, readProvenance } from "./freeze.js";
+import {
+  batesLabel,
+  buildQr,
+  drawBatesLabel,
+  drawQr,
+  validateBates
+} from "./stamp.js";
+import { insertIndexPages } from "./index-page.js";
+import { FreezeError } from "./types.js";
+import { TextSanitiser } from "./vector.js";
+const BUNDLE_KEY = "ArbiBundle";
+const DEFAULT_QR_CORNER = "bottom-left";
+const DEFAULT_BATES_CORNER = "bottom-right";
+function checkAborted(signal) {
+  if (signal?.aborted) throw new DOMException("Bundle aborted", "AbortError");
+}
+function outputName(name, used) {
+  const base = (name.replace(/\.pdf$/i, "").replace(/[\\/:*?"<>|]+/g, "_").trim() || "document") + ".pdf";
+  let candidate = base;
+  for (let n = 2; used.has(candidate); n++) candidate = base.replace(/\.pdf$/, `-${n}.pdf`);
+  used.add(candidate);
+  return candidate;
+}
+function validate(items, options) {
+  if (items.length === 0)
+    throw new FreezeError("invalid-option", "A bundle needs at least one document");
+  validateBates(options.bates);
+  if (options.qr) {
+    const missing = items.find((i) => !i.qrUrl);
+    if (missing) {
+      throw new FreezeError("invalid-option", `"${missing.name}" has no link for its QR code`);
+    }
+  }
+  const corner = options.bates.corner ?? DEFAULT_BATES_CORNER;
+  if (options.qr && (options.qrCorner ?? DEFAULT_QR_CORNER) === corner) {
+    throw new FreezeError(
+      "invalid-option",
+      "The Bates label and the QR code need different corners"
+    );
+  }
+}
+async function stampPages(doc, items, firstIndex, options) {
+  const font = await doc.embedFont(StandardFonts.Helvetica);
+  const sanitiser = new TextSanitiser(font);
+  const label = batesLabel(options.bates, firstIndex);
+  if (!sanitiser.supports(label)) {
+    throw new FreezeError(
+      "unsupported-text",
+      `Bates prefix "${options.bates.prefix}" uses characters the built-in font cannot draw`
+    );
+  }
+  const pages = doc.getPages();
+  const corner = options.bates.corner ?? DEFAULT_BATES_CORNER;
+  let at = 0;
+  for (const item of items) {
+    const qr = options.qr && item.qrUrl ? buildQr(item.qrUrl) : void 0;
+    for (let p = 0; p < item.pages; p++, at++) {
+      const page = pages[at];
+      drawBatesLabel(page, batesLabel(options.bates, firstIndex + at), font, corner);
+      if (qr) drawQr(page, qr, options.qrCorner ?? DEFAULT_QR_CORNER);
+    }
+  }
+}
+function setBundleRecord(doc, record) {
+  const info = doc.context.lookup(doc.context.trailerInfo.Info);
+  if (!info || !("set" in info)) return;
+  info.set(
+    PDFName.of(BUNDLE_KEY),
+    PDFHexString.fromText(JSON.stringify(record))
+  );
+}
+async function buildBundle(items, options) {
+  validate(items, options);
+  const now = options.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const used = /* @__PURE__ */ new Set();
+  const files = [];
+  const index = [];
+  const loaded = [];
+  for (const item of items) {
+    checkAborted(options.signal);
+    const doc = await loadPdfDocument(item.bytes);
+    loaded.push({ item, doc, pages: doc.getPageCount() });
+  }
+  if (options.layout === "merged") {
+    const out = await PDFDocument.create();
+    out.setProducer("ARBI");
+    out.setCreator("ARBI");
+    out.setCreationDate(new Date(now));
+    out.setModificationDate(new Date(now));
+    const provenance = {};
+    for (const { item, doc } of loaded) {
+      checkAborted(options.signal);
+      for (const page of await out.copyPages(doc, doc.getPageIndices())) out.addPage(page);
+      provenance[item.documentId] = await readProvenance(item.bytes).catch(() => null);
+    }
+    await stampPages(
+      out,
+      loaded.map(({ item, pages }) => ({ pages, qrUrl: item.qrUrl })),
+      0,
+      options
+    );
+    const file = outputName(options.mergedName ?? "production.pdf", used);
+    let first2 = 0;
+    for (const { item, pages } of loaded) {
+      index.push({
+        documentId: item.documentId,
+        name: item.name,
+        file,
+        pages,
+        firstLabel: batesLabel(options.bates, first2),
+        lastLabel: batesLabel(options.bates, first2 + pages - 1)
+      });
+      first2 += pages;
+    }
+    const indexPages2 = options.indexPage ? await insertIndexPages(out, index, {
+      size: pageSize(loaded[0].doc),
+      producedAt: now,
+      producedBy: options.author
+    }) : 0;
+    setBundleRecord(out, {
+      schema: 1,
+      producedAt: now,
+      ...indexPages2 ? { indexPages: indexPages2 } : {},
+      ...options.author ? { producedBy: options.author } : {},
+      layout: "merged",
+      items: index.map((e) => ({
+        documentId: e.documentId,
+        name: e.name,
+        pages: e.pages,
+        firstLabel: e.firstLabel,
+        lastLabel: e.lastLabel,
+        frozen: provenance[e.documentId] ?? null
+      }))
+    });
+    const total = first2;
+    files.push({
+      name: file,
+      bytes: await out.save(),
+      pages: total + indexPages2,
+      firstLabel: batesLabel(options.bates, 0),
+      lastLabel: batesLabel(options.bates, total - 1)
+    });
+    options.onProgress?.(loaded.length, loaded.length);
+    return { files, index, indexPages: indexPages2 };
+  }
+  let first = 0;
+  for (const [n, { item, doc, pages }] of loaded.entries()) {
+    checkAborted(options.signal);
+    await stampPages(doc, [{ pages, qrUrl: item.qrUrl }], first, options);
+    doc.setModificationDate(new Date(now));
+    const file = outputName(item.name, used);
+    const entry = {
+      documentId: item.documentId,
+      name: item.name,
+      file,
+      pages,
+      firstLabel: batesLabel(options.bates, first),
+      lastLabel: batesLabel(options.bates, first + pages - 1)
+    };
+    index.push(entry);
+    files.push({
+      name: file,
+      bytes: await doc.save(),
+      pages,
+      firstLabel: entry.firstLabel,
+      lastLabel: entry.lastLabel
+    });
+    first += pages;
+    options.onProgress?.(n + 1, loaded.length);
+  }
+  if (!options.indexPage) return { files, index, indexPages: 0 };
+  const cover = await PDFDocument.create();
+  cover.setProducer("ARBI");
+  cover.setCreator("ARBI");
+  cover.setCreationDate(new Date(now));
+  const indexPages = await insertIndexPages(cover, index, {
+    size: pageSize(loaded[0].doc),
+    producedAt: now,
+    producedBy: options.author
+  });
+  files.unshift({
+    name: outputName("index.pdf", used),
+    bytes: await cover.save(),
+    pages: indexPages,
+    firstLabel: "",
+    lastLabel: ""
+  });
+  return { files, index, indexPages };
+}
+function pageSize(doc) {
+  const page = doc.getPage(0);
+  const { width, height } = page.getSize();
+  const turned = page.getRotation().angle % 180 !== 0;
+  return turned ? [height, width] : [width, height];
+}
+export {
+  buildBundle
+};
+//# sourceMappingURL=bundle.js.map

package/dist/annotations/freeze/bundle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/annotations/freeze/bundle.ts"],
+  "sourcesContent": ["/**\n * Production bundle: take documents that are ALREADY frozen (or never needed freezing) and number\n * them consecutively with a Bates label, optionally adding a QR code that links back to the\n * document in ARBI.\n *\n * `merged` joins the documents into one PDF; `per-document` keeps one PDF each. Either way the\n * numbering runs on across the whole set in the order given, so a label is unique within the\n * production. Splitting a document is deliberately not part of this.\n *\n * `indexPage` adds an index first (every document with its Bates range): the first page(s) of a\n * merged file, or an `index.pdf` of its own ahead of the per-document files. It is not numbered.\n */\n\nimport { PDFDocument, PDFHexString, PDFName, StandardFonts } from 'pdf-lib'\nimport { loadPdfDocument, readProvenance } from './freeze'\nimport {\n  batesLabel,\n  buildQr,\n  drawBatesLabel,\n  drawQr,\n  validateBates,\n  type BatesOptions,\n  type StampCorner,\n} from './stamp'\nimport { insertIndexPages } from './index-page'\nimport { FreezeError, type FreezeProvenance } from './types'\nimport { TextSanitiser } from './vector'\n\nconst BUNDLE_KEY = 'ArbiBundle'\nconst DEFAULT_QR_CORNER: StampCorner = 'bottom-left'\nconst DEFAULT_BATES_CORNER: StampCorner = 'bottom-right'\n\nexport type BundleLayout = 'merged' | 'per-document'\n\nexport interface BundleItem {\n  /** Shown in the index and used to name the output file. */\n  name: string\n  /** External id of the document this PDF represents. */\n  documentId: string\n  /** PDF bytes, normally the output of `freezePdf`. */\n  bytes: Uint8Array\n  /** What the QR code opens. Required for every item when `qr` is on. */\n  qrUrl?: string\n}\n\nexport interface BundleOptions {\n  layout: BundleLayout\n  bates: BatesOptions\n  /** Add a QR code (to each item's `qrUrl`) on every page. Default false. */\n  qr?: boolean\n  qrCorner?: StampCorner\n  /** Name of the merged file. Default `production.pdf`. */\n  mergedName?: string\n  /** Put an index page (documents and Bates ranges) at the start. Default false. */\n  indexPage?: boolean\n  /** ISO timestamp; defaults to now. Injectable for deterministic tests. */\n  now?: string\n  /** Who produced the set; recorded in a merged file's metadata. */\n  author?: string\n  onProgress?: (done: number, total: number) => void\n  signal?: AbortSignal\n}\n\nexport interface BundleIndexEntry {\n  documentId: string\n  name: string\n  /** The output file that holds this document. */\n  file: string\n  pages: number\n  firstLabel: string\n  lastLabel: string\n}\n\nexport interface BundleFile {\n  name: string\n  bytes: Uint8Array\n  pages: number\n  firstLabel: string\n  lastLabel: string\n}\n\nexport interface BundleResult {\n  files: BundleFile[]\n  index: BundleIndexEntry[]\n  /** Index pages added at the start (0 without `indexPage`). */\n  indexPages: number\n}\n\nfunction checkAborted(signal?: AbortSignal) {\n  if (signal?.aborted) throw new DOMException('Bundle aborted', 'AbortError')\n}\n\nfunction outputName(name: string, used: Set<string>): string {\n  const base =\n    (name\n      .replace(/\\.pdf$/i, '')\n      .replace(/[\\\\/:*?\"<>|]+/g, '_')\n      .trim() || 'document') + '.pdf'\n  let candidate = base\n  for (let n = 2; used.has(candidate); n++) candidate = base.replace(/\\.pdf$/, `-${n}.pdf`)\n  used.add(candidate)\n  return candidate\n}\n\nfunction validate(items: BundleItem[], options: BundleOptions) {\n  if (items.length === 0)\n    throw new FreezeError('invalid-option', 'A bundle needs at least one document')\n  validateBates(options.bates)\n  if (options.qr) {\n    const missing = items.find((i) => !i.qrUrl)\n    if (missing) {\n      throw new FreezeError('invalid-option', `\"${missing.name}\" has no link for its QR code`)\n    }\n  }\n  const corner = options.bates.corner ?? DEFAULT_BATES_CORNER\n  if (options.qr && (options.qrCorner ?? DEFAULT_QR_CORNER) === corner) {\n    throw new FreezeError(\n      'invalid-option',\n      'The Bates label and the QR code need different corners'\n    )\n  }\n}\n\n/** Stamp the pages of `doc`, item by item, numbering from `firstIndex`. */\nasync function stampPages(\n  doc: PDFDocument,\n  items: { pages: number; qrUrl?: string }[],\n  firstIndex: number,\n  options: BundleOptions\n): Promise<void> {\n  const font = await doc.embedFont(StandardFonts.Helvetica)\n  const sanitiser = new TextSanitiser(font)\n  const label = batesLabel(options.bates, firstIndex)\n  if (!sanitiser.supports(label)) {\n    throw new FreezeError(\n      'unsupported-text',\n      `Bates prefix \"${options.bates.prefix}\" uses characters the built-in font cannot draw`\n    )\n  }\n  const pages = doc.getPages()\n  const corner = options.bates.corner ?? DEFAULT_BATES_CORNER\n  let at = 0\n  for (const item of items) {\n    const qr = options.qr && item.qrUrl ? buildQr(item.qrUrl) : undefined\n    for (let p = 0; p < item.pages; p++, at++) {\n      const page = pages[at]\n      drawBatesLabel(page, batesLabel(options.bates, firstIndex + at), font, corner)\n      if (qr) drawQr(page, qr, options.qrCorner ?? DEFAULT_QR_CORNER)\n    }\n  }\n}\n\nfunction setBundleRecord(doc: PDFDocument, record: unknown) {\n  const info = doc.context.lookup(doc.context.trailerInfo.Info)\n  if (!info || !('set' in info)) return\n  ;(info as unknown as { set(k: PDFName, v: PDFHexString): void }).set(\n    PDFName.of(BUNDLE_KEY),\n    PDFHexString.fromText(JSON.stringify(record))\n  )\n}\n\nexport async function buildBundle(\n  items: BundleItem[],\n  options: BundleOptions\n): Promise<BundleResult> {\n  validate(items, options)\n  const now = options.now ?? new Date().toISOString()\n  const used = new Set<string>()\n  const files: BundleFile[] = []\n  const index: BundleIndexEntry[] = []\n\n  // Load everything first: a bad PDF fails the whole set before any output exists.\n  const loaded: { item: BundleItem; doc: PDFDocument; pages: number }[] = []\n  for (const item of items) {\n    checkAborted(options.signal)\n    const doc = await loadPdfDocument(item.bytes)\n    loaded.push({ item, doc, pages: doc.getPageCount() })\n  }\n\n  if (options.layout === 'merged') {\n    const out = await PDFDocument.create()\n    out.setProducer('ARBI')\n    out.setCreator('ARBI')\n    out.setCreationDate(new Date(now))\n    out.setModificationDate(new Date(now))\n    const provenance: Record<string, FreezeProvenance | null> = {}\n    for (const { item, doc } of loaded) {\n      checkAborted(options.signal)\n      for (const page of await out.copyPages(doc, doc.getPageIndices())) out.addPage(page)\n      provenance[item.documentId] = await readProvenance(item.bytes).catch(() => null)\n    }\n    await stampPages(\n      out,\n      loaded.map(({ item, pages }) => ({ pages, qrUrl: item.qrUrl })),\n      0,\n      options\n    )\n\n    const file = outputName(options.mergedName ?? 'production.pdf', used)\n    let first = 0\n    for (const { item, pages } of loaded) {\n      index.push({\n        documentId: item.documentId,\n        name: item.name,\n        file,\n        pages,\n        firstLabel: batesLabel(options.bates, first),\n        lastLabel: batesLabel(options.bates, first + pages - 1),\n      })\n      first += pages\n    }\n    const indexPages = options.indexPage\n      ? await insertIndexPages(out, index, {\n          size: pageSize(loaded[0].doc),\n          producedAt: now,\n          producedBy: options.author,\n        })\n      : 0\n    setBundleRecord(out, {\n      schema: 1,\n      producedAt: now,\n      ...(indexPages ? { indexPages } : {}),\n      ...(options.author ? { producedBy: options.author } : {}),\n      layout: 'merged',\n      items: index.map((e) => ({\n        documentId: e.documentId,\n        name: e.name,\n        pages: e.pages,\n        firstLabel: e.firstLabel,\n        lastLabel: e.lastLabel,\n        frozen: provenance[e.documentId] ?? null,\n      })),\n    })\n    const total = first\n    files.push({\n      name: file,\n      bytes: await out.save(),\n      pages: total + indexPages,\n      firstLabel: batesLabel(options.bates, 0),\n      lastLabel: batesLabel(options.bates, total - 1),\n    })\n    options.onProgress?.(loaded.length, loaded.length)\n    return { files, index, indexPages }\n  }\n\n  let first = 0\n  for (const [n, { item, doc, pages }] of loaded.entries()) {\n    checkAborted(options.signal)\n    await stampPages(doc, [{ pages, qrUrl: item.qrUrl }], first, options)\n    doc.setModificationDate(new Date(now))\n    const file = outputName(item.name, used)\n    const entry: BundleIndexEntry = {\n      documentId: item.documentId,\n      name: item.name,\n      file,\n      pages,\n      firstLabel: batesLabel(options.bates, first),\n      lastLabel: batesLabel(options.bates, first + pages - 1),\n    }\n    index.push(entry)\n    files.push({\n      name: file,\n      bytes: await doc.save(),\n      pages,\n      firstLabel: entry.firstLabel,\n      lastLabel: entry.lastLabel,\n    })\n    first += pages\n    options.onProgress?.(n + 1, loaded.length)\n  }\n  if (!options.indexPage) return { files, index, indexPages: 0 }\n  const cover = await PDFDocument.create()\n  cover.setProducer('ARBI')\n  cover.setCreator('ARBI')\n  cover.setCreationDate(new Date(now))\n  const indexPages = await insertIndexPages(cover, index, {\n    size: pageSize(loaded[0].doc),\n    producedAt: now,\n    producedBy: options.author,\n  })\n  files.unshift({\n    name: outputName('index.pdf', used),\n    bytes: await cover.save(),\n    pages: indexPages,\n    firstLabel: '',\n    lastLabel: '',\n  })\n  return { files, index, indexPages }\n}\n\n/** The displayed size of a document's first page, for an index page that matches it. */\nfunction pageSize(doc: PDFDocument): [number, number] {\n  const page = doc.getPage(0)\n  const { width, height } = page.getSize()\n  const turned = page.getRotation().angle % 180 !== 0\n  return turned ? [height, width] : [width, height]\n}\n"],
+  "mappings": "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",
+  "names": ["first", "indexPages"]
+}

package/dist/annotations/freeze/coords.js

@@ -0,0 +1,37 @@
+function normaliseRotation(angle) {
+  const a = (Math.round(angle / 90) * 90 % 360 + 360) % 360;
+  return a;
+}
+function displayedSize(g) {
+  return g.rotation === 90 || g.rotation === 270 ? { width: g.height, height: g.width } : { width: g.width, height: g.height };
+}
+function displayedToUser(g, dx, dy) {
+  switch (g.rotation) {
+    case 0:
+      return { x: g.x + dx, y: g.y + g.height - dy };
+    case 90:
+      return { x: g.x + dy, y: g.y + dx };
+    case 180:
+      return { x: g.x + g.width - dx, y: g.y + dy };
+    case 270:
+      return { x: g.x + g.width - dy, y: g.y + g.height - dx };
+  }
+}
+function normToUserRect(g, r) {
+  const size = displayedSize(g);
+  const a = displayedToUser(g, r.x * size.width, r.y * size.height);
+  const b = displayedToUser(g, (r.x + r.w) * size.width, (r.y + r.h) * size.height);
+  return {
+    x: Math.min(a.x, b.x),
+    y: Math.min(a.y, b.y),
+    width: Math.abs(b.x - a.x),
+    height: Math.abs(b.y - a.y)
+  };
+}
+export {
+  displayedSize,
+  displayedToUser,
+  normToUserRect,
+  normaliseRotation
+};
+//# sourceMappingURL=coords.js.map

package/dist/annotations/freeze/coords.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/annotations/freeze/coords.ts"],
+  "sourcesContent": ["/**\n * Mapping between the DISPLAYED page (what a viewer shows: crop box, then /Rotate) and the PDF's\n * unrotated user space (origin bottom-left of the media box, points). Marks are stored in the\n * displayed frame; this is the only place that knows how to leave it.\n */\n\nimport type { NormRect } from '../model'\n\nexport type PageRotation = 0 | 90 | 180 | 270\n\n/** The visible box of a page in user space, plus its /Rotate. */\nexport interface PageGeometry {\n  /** Crop box origin and size in user-space points. */\n  x: number\n  y: number\n  width: number\n  height: number\n  rotation: PageRotation\n}\n\nexport interface Point {\n  x: number\n  y: number\n}\n\nexport interface UserRect {\n  x: number\n  y: number\n  width: number\n  height: number\n}\n\nexport function normaliseRotation(angle: number): PageRotation {\n  const a = (((Math.round(angle / 90) * 90) % 360) + 360) % 360\n  return a as PageRotation\n}\n\n/** Size of the page as displayed, in points (width and height swap at 90/270). */\nexport function displayedSize(g: PageGeometry): { width: number; height: number } {\n  return g.rotation === 90 || g.rotation === 270\n    ? { width: g.height, height: g.width }\n    : { width: g.width, height: g.height }\n}\n\n/** A point given in displayed points from the top-left, as a user-space point. */\nexport function displayedToUser(g: PageGeometry, dx: number, dy: number): Point {\n  switch (g.rotation) {\n    case 0:\n      return { x: g.x + dx, y: g.y + g.height - dy }\n    case 90:\n      return { x: g.x + dy, y: g.y + dx }\n    case 180:\n      return { x: g.x + g.width - dx, y: g.y + dy }\n    case 270:\n      return { x: g.x + g.width - dy, y: g.y + g.height - dx }\n  }\n}\n\n/** The user-space bounding box of a normalised displayed rectangle. */\nexport function normToUserRect(g: PageGeometry, r: NormRect): UserRect {\n  const size = displayedSize(g)\n  const a = displayedToUser(g, r.x * size.width, r.y * size.height)\n  const b = displayedToUser(g, (r.x + r.w) * size.width, (r.y + r.h) * size.height)\n  return {\n    x: Math.min(a.x, b.x),\n    y: Math.min(a.y, b.y),\n    width: Math.abs(b.x - a.x),\n    height: Math.abs(b.y - a.y),\n  }\n}\n"],
+  "mappings": "AAgCO,SAAS,kBAAkB,OAA6B;AAC7D,QAAM,KAAO,KAAK,MAAM,QAAQ,EAAE,IAAI,KAAM,MAAO,OAAO;AAC1D,SAAO;AACT;AAGO,SAAS,cAAc,GAAoD;AAChF,SAAO,EAAE,aAAa,MAAM,EAAE,aAAa,MACvC,EAAE,OAAO,EAAE,QAAQ,QAAQ,EAAE,MAAM,IACnC,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,OAAO;AACzC;AAGO,SAAS,gBAAgB,GAAiB,IAAY,IAAmB;AAC9E,UAAQ,EAAE,UAAU;AAAA,IAClB,KAAK;AACH,aAAO,EAAE,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,EAAE,SAAS,GAAG;AAAA,IAC/C,KAAK;AACH,aAAO,EAAE,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,GAAG;AAAA,IACpC,KAAK;AACH,aAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,IAAI,GAAG,EAAE,IAAI,GAAG;AAAA,IAC9C,KAAK;AACH,aAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,IAAI,GAAG,EAAE,IAAI,EAAE,SAAS,GAAG;AAAA,EAC3D;AACF;AAGO,SAAS,eAAe,GAAiB,GAAuB;AACrE,QAAM,OAAO,cAAc,CAAC;AAC5B,QAAM,IAAI,gBAAgB,GAAG,EAAE,IAAI,KAAK,OAAO,EAAE,IAAI,KAAK,MAAM;AAChE,QAAM,IAAI,gBAAgB,IAAI,EAAE,IAAI,EAAE,KAAK,KAAK,QAAQ,EAAE,IAAI,EAAE,KAAK,KAAK,MAAM;AAChF,SAAO;AAAA,IACL,GAAG,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;AAAA,IACpB,GAAG,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;AAAA,IACpB,OAAO,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC;AAAA,IACzB,QAAQ,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC;AAAA,EAC5B;AACF;",
+  "names": []
+}

package/dist/annotations/freeze/freeze.js

@@ -0,0 +1,261 @@
+import { EncryptedPDFError, PDFDocument, PDFHexString, PDFName, StandardFonts, rgb } from "pdf-lib";
+import {
+  isEffectiveRedaction,
+  parseLayer
+} from "../model.js";
+import { displayedSize } from "./coords.js";
+import { hashLayer, sha256Hex } from "./hash.js";
+import { burnMarks } from "./raster.js";
+import {
+  ENCRYPTED_MESSAGE,
+  FreezeError
+} from "./types.js";
+import {
+  TextSanitiser,
+  appendCommentAppendix,
+  createVectorContext,
+  drawVectorMark,
+  numberComments,
+  pageGeometry
+} from "./vector.js";
+const DEFAULT_DPI = 200;
+const DEFAULT_JPEG_QUALITY = 0.92;
+const DEFAULT_REDACTION_PADDING_PT = 1.5;
+const MIN_DPI = 72;
+const MAX_DPI = 600;
+const FALLBACK_PAGE = [595.28, 841.89];
+const PROVENANCE_KEY = "ArbiProvenance";
+const KINDS = ["highlight", "box", "comment", "stamp", "redaction"];
+async function freezePdf(original, rawLayer, options) {
+  const layer = parseLayer(rawLayer);
+  const now = options.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const comments = options.comments ?? "omit";
+  const dpi = options.dpi ?? DEFAULT_DPI;
+  if (!(dpi >= MIN_DPI && dpi <= MAX_DPI)) {
+    throw new FreezeError("invalid-option", `dpi must be between ${MIN_DPI} and ${MAX_DPI}`);
+  }
+  const redactions = layer.annotations.filter(isEffectiveRedaction);
+  const pending = redactions.filter((r) => r.status === "pending");
+  if (pending.length > 0 && (options.pendingRedactions ?? "error") === "error") {
+    throw new FreezeError(
+      "pending-redactions",
+      `${pending.length} redaction mark(s) have not been approved or rejected`
+    );
+  }
+  const marks = layer.annotations.filter((a) => a.kind !== "redaction" || isEffectiveRedaction(a));
+  const modeApplied = redactions.length > 0 ? "image" : options.mode;
+  const [originalSha256, layerSha256] = await Promise.all([sha256Hex(original), hashLayer(layer)]);
+  const warnings = [];
+  if (redactions.length > 0 && comments !== "omit" && marks.some((a) => a.kind === "comment")) {
+    warnings.push(
+      "Comments are included in a document with redactions and may repeat redacted text"
+    );
+  }
+  let built;
+  if (modeApplied === "image") {
+    built = await freezeAsImage(marks, options, comments, dpi, now, warnings);
+  } else {
+    built = await freezeAsVector(original, marks, comments, now, warnings);
+  }
+  const provenance = {
+    schema: 1,
+    derivedFrom: layer.documentId,
+    originalSha256,
+    layerSha256,
+    modeRequested: options.mode,
+    modeApplied,
+    ...modeApplied !== options.mode ? { modeChangedBecause: "redactions-present" } : {},
+    frozenAt: now,
+    frozenBy: options.author,
+    pages: built.pages,
+    ...built.dpi === void 0 ? {} : { dpi: built.dpi },
+    counts: countKinds(marks),
+    redactions: summariseRedactions(redactions)
+  };
+  setProvenance(built.doc, provenance);
+  return { bytes: await built.doc.save(), provenance, warnings };
+}
+function countKinds(marks) {
+  const counts = Object.fromEntries(KINDS.map((k) => [k, 0]));
+  for (const a of marks) counts[a.kind]++;
+  return counts;
+}
+function summariseRedactions(redactions) {
+  const reasons = {};
+  const pages = /* @__PURE__ */ new Set();
+  for (const r of redactions) {
+    if (r.kind !== "redaction") continue;
+    pages.add(r.page);
+    reasons[r.reason] = (reasons[r.reason] ?? 0) + 1;
+  }
+  return { count: redactions.length, pages: [...pages].sort((a, b) => a - b), reasons };
+}
+function checkPages(marks, pages) {
+  for (const a of marks) {
+    if (a.page > pages) {
+      throw new FreezeError(
+        "page-out-of-range",
+        `mark ${a.id} is on page ${a.page}; the document has ${pages}`
+      );
+    }
+  }
+}
+function checkAborted(signal) {
+  if (signal?.aborted) throw new DOMException("Freeze aborted", "AbortError");
+}
+async function loadPdfDocument(bytes) {
+  try {
+    return await PDFDocument.load(bytes);
+  } catch (error) {
+    if (error instanceof EncryptedPDFError || /is encrypted/i.test(error?.message ?? "")) {
+      throw new FreezeError("encrypted", ENCRYPTED_MESSAGE);
+    }
+    throw new FreezeError("invalid-pdf", `The PDF could not be read: ${error.message}`);
+  }
+}
+async function freezeAsVector(original, marks, comments, now, warnings) {
+  const doc = await loadPdfDocument(original);
+  const pages = doc.getPages();
+  checkPages(marks, pages.length);
+  const ctx = await createVectorContext(doc, marks, comments);
+  for (const a of marks) drawVectorMark(pages[a.page - 1], a, ctx);
+  if (comments === "appendix") {
+    const first = pages[0] ? displayedSize(pageGeometry(pages[0])) : void 0;
+    const size = first ? [first.width, first.height] : FALLBACK_PAGE;
+    appendCommentAppendix(
+      ctx,
+      marks.filter((a) => a.kind === "comment"),
+      size
+    );
+  }
+  reportReplaced(ctx.sanitiser, warnings);
+  doc.setProducer("ARBI");
+  doc.setModificationDate(new Date(now));
+  return { doc, pages: pages.length };
+}
+async function freezeAsImage(marks, options, comments, dpi, now, warnings) {
+  const rasterizer = options.rasterizer;
+  if (!rasterizer) {
+    throw new FreezeError("rasterizer-required", "Image freeze needs a page rasterizer");
+  }
+  try {
+    checkPages(marks, rasterizer.numPages);
+    const out = await PDFDocument.create();
+    out.setProducer("ARBI");
+    out.setCreator("ARBI");
+    out.setCreationDate(new Date(now));
+    out.setModificationDate(new Date(now));
+    const numbers = numberComments(marks);
+    const format = options.imageFormat ?? "jpeg";
+    const quality = options.jpegQuality ?? DEFAULT_JPEG_QUALITY;
+    const burn = {
+      paddingPt: options.redactionPaddingPt ?? DEFAULT_REDACTION_PADDING_PT,
+      labels: options.redactionLabels ?? true,
+      comments,
+      numbers,
+      images: await stampImages(marks)
+    };
+    const ocrFont = options.ocr ? await out.embedFont(StandardFonts.Helvetica) : void 0;
+    const ocrSanitiser = ocrFont ? new TextSanitiser(ocrFont) : void 0;
+    let lowestDpi = dpi;
+    let firstSize;
+    for (let n = 1; n <= rasterizer.numPages; n++) {
+      checkAborted(options.signal);
+      const page = await rasterizer.renderPage(n, dpi);
+      try {
+        burnMarks(
+          page,
+          marks.filter((a) => a.page === n),
+          burn
+        );
+        const bytes = await page.encode(format, quality);
+        const image = format === "png" ? await out.embedPng(bytes) : await out.embedJpg(bytes);
+        const outPage = out.addPage([page.widthPt, page.heightPt]);
+        outPage.drawImage(image, { x: 0, y: 0, width: page.widthPt, height: page.heightPt });
+        lowestDpi = Math.min(lowestDpi, page.dpi);
+        firstSize ??= [page.widthPt, page.heightPt];
+        if (options.ocr && ocrFont && ocrSanitiser) {
+          const words = await options.ocr({
+            pageNumber: n,
+            bytes,
+            format,
+            widthPx: page.widthPx,
+            heightPx: page.heightPx
+          });
+          drawInvisibleText(outPage, words, page.widthPt, page.heightPt, ocrFont, ocrSanitiser);
+        }
+      } finally {
+        page.release();
+      }
+      options.onProgress?.(n, rasterizer.numPages);
+    }
+    if (comments === "appendix") {
+      const ctx = await createVectorContext(out, marks, comments);
+      appendCommentAppendix(
+        ctx,
+        marks.filter((a) => a.kind === "comment"),
+        firstSize ?? FALLBACK_PAGE
+      );
+      reportReplaced(ctx.sanitiser, warnings);
+    }
+    return { doc: out, pages: rasterizer.numPages, dpi: Math.round(lowestDpi) };
+  } finally {
+    await rasterizer.destroy();
+  }
+}
+function drawInvisibleText(page, words, widthPt, heightPt, font, sanitiser) {
+  for (const w of words) {
+    if (!w.text || !sanitiser.supports(w.text)) continue;
+    const size = Math.max(1, w.h * heightPt * 0.8);
+    page.drawText(w.text, {
+      x: w.x * widthPt,
+      y: heightPt - (w.y + w.h) * heightPt,
+      size,
+      font,
+      color: rgb(0, 0, 0),
+      opacity: 0
+    });
+  }
+}
+function reportReplaced(sanitiser, warnings) {
+  if (sanitiser.replaced.size > 0) {
+    warnings.push(
+      `${sanitiser.replaced.size} character(s) in comments cannot be drawn by the built-in font and were replaced with "?"`
+    );
+  }
+}
+function setProvenance(doc, provenance) {
+  const info = doc.context.lookup(doc.context.trailerInfo.Info);
+  if (!info || !("set" in info)) throw new Error("document has no info dictionary");
+  info.set(
+    PDFName.of(PROVENANCE_KEY),
+    PDFHexString.fromText(JSON.stringify(provenance))
+  );
+}
+async function readProvenance(bytes) {
+  const doc = await PDFDocument.load(bytes);
+  const info = doc.context.lookup(doc.context.trailerInfo.Info);
+  if (!info || !("get" in info)) return null;
+  const value = info.get(PDFName.of(PROVENANCE_KEY));
+  if (!(value instanceof PDFHexString)) return null;
+  return JSON.parse(value.decodeText());
+}
+async function stampImages(marks) {
+  const out = /* @__PURE__ */ new Map();
+  if (typeof createImageBitmap !== "function") return out;
+  for (const a of marks) {
+    if (a.kind !== "stamp" || !a.image) continue;
+    const raw = atob(a.image);
+    const bytes = new Uint8Array(raw.length);
+    for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
+    out.set(a.id, await createImageBitmap(new Blob([bytes], { type: "image/png" })));
+  }
+  return out;
+}
+export {
+  DEFAULT_DPI,
+  freezePdf,
+  loadPdfDocument,
+  readProvenance
+};
+//# sourceMappingURL=freeze.js.map