@arbidocs/react 0.5.111 → 0.5.113

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/annotations/freeze/freeze.ts"],
+  "sourcesContent": ["/**\n * Freeze: derive a NEW document from an immutable original plus its annotation layer.\n *\n * - `vector`: marks are drawn into the original pages; text stays searchable.\n * - `image`: every page is rasterised with the marks burned in and the PDF is rebuilt from the\n *   images alone. Required whenever a redaction applies, because only a rebuild leaves nothing\n *   behind the box: no text, no metadata, no annotations, no attachments, no old revisions.\n *\n * The layer itself is never embedded. The output carries a provenance record (counts and reasons,\n * never the redacted text).\n */\n\nimport { EncryptedPDFError, PDFDocument, PDFHexString, PDFName, StandardFonts, rgb } from 'pdf-lib'\nimport {\n  isEffectiveRedaction,\n  parseLayer,\n  type Annotation,\n  type AnnotationKind,\n  type AnnotationLayer,\n  type CommentAnnotation,\n} from '../model'\nimport { displayedSize } from './coords'\nimport { hashLayer, sha256Hex } from './hash'\nimport { burnMarks } from './raster'\nimport {\n  ENCRYPTED_MESSAGE,\n  FreezeError,\n  type FreezeMode,\n  type FreezeOptions,\n  type FreezeProvenance,\n  type FreezeResult,\n  type OcrWord,\n} from './types'\nimport {\n  TextSanitiser,\n  appendCommentAppendix,\n  createVectorContext,\n  drawVectorMark,\n  numberComments,\n  pageGeometry,\n} from './vector'\n\nexport const DEFAULT_DPI = 200\nconst DEFAULT_JPEG_QUALITY = 0.92\nconst DEFAULT_REDACTION_PADDING_PT = 1.5\nconst MIN_DPI = 72\nconst MAX_DPI = 600\nconst FALLBACK_PAGE: [number, number] = [595.28, 841.89]\nconst PROVENANCE_KEY = 'ArbiProvenance'\n\nconst KINDS: AnnotationKind[] = ['highlight', 'box', 'comment', 'stamp', 'redaction']\n\nexport async function freezePdf(\n  original: Uint8Array,\n  rawLayer: AnnotationLayer,\n  options: FreezeOptions\n): Promise<FreezeResult> {\n  // The layer may have come from storage or an agent: validate before anything is drawn.\n  const layer = parseLayer(rawLayer)\n  const now = options.now ?? new Date().toISOString()\n  const comments = options.comments ?? 'omit'\n  const dpi = options.dpi ?? DEFAULT_DPI\n  if (!(dpi >= MIN_DPI && dpi <= MAX_DPI)) {\n    throw new FreezeError('invalid-option', `dpi must be between ${MIN_DPI} and ${MAX_DPI}`)\n  }\n\n  const redactions = layer.annotations.filter(isEffectiveRedaction)\n  const pending = redactions.filter((r) => r.status === 'pending')\n  if (pending.length > 0 && (options.pendingRedactions ?? 'error') === 'error') {\n    throw new FreezeError(\n      'pending-redactions',\n      `${pending.length} redaction mark(s) have not been approved or rejected`\n    )\n  }\n\n  // Rejected redactions are dropped; every other mark is applied.\n  const marks = layer.annotations.filter((a) => a.kind !== 'redaction' || isEffectiveRedaction(a))\n  const modeApplied: FreezeMode = redactions.length > 0 ? 'image' : options.mode\n\n  const [originalSha256, layerSha256] = await Promise.all([sha256Hex(original), hashLayer(layer)])\n  const warnings: string[] = []\n  if (redactions.length > 0 && comments !== 'omit' && marks.some((a) => a.kind === 'comment')) {\n    warnings.push(\n      'Comments are included in a document with redactions and may repeat redacted text'\n    )\n  }\n\n  let built: { doc: PDFDocument; pages: number; dpi?: number }\n  if (modeApplied === 'image') {\n    built = await freezeAsImage(marks, options, comments, dpi, now, warnings)\n  } else {\n    built = await freezeAsVector(original, marks, comments, now, warnings)\n  }\n\n  const provenance: FreezeProvenance = {\n    schema: 1,\n    derivedFrom: layer.documentId,\n    originalSha256,\n    layerSha256,\n    modeRequested: options.mode,\n    modeApplied,\n    ...(modeApplied !== options.mode ? { modeChangedBecause: 'redactions-present' as const } : {}),\n    frozenAt: now,\n    frozenBy: options.author,\n    pages: built.pages,\n    ...(built.dpi === undefined ? {} : { dpi: built.dpi }),\n    counts: countKinds(marks),\n    redactions: summariseRedactions(redactions),\n  }\n\n  setProvenance(built.doc, provenance)\n  return { bytes: await built.doc.save(), provenance, warnings }\n}\n\nfunction countKinds(marks: Annotation[]): Record<AnnotationKind, number> {\n  const counts = Object.fromEntries(KINDS.map((k) => [k, 0])) as Record<AnnotationKind, number>\n  for (const a of marks) counts[a.kind]++\n  return counts\n}\n\nfunction summariseRedactions(redactions: Annotation[]): FreezeProvenance['redactions'] {\n  const reasons: Record<string, number> = {}\n  const pages = new Set<number>()\n  for (const r of redactions) {\n    if (r.kind !== 'redaction') continue\n    pages.add(r.page)\n    reasons[r.reason] = (reasons[r.reason] ?? 0) + 1\n  }\n  return { count: redactions.length, pages: [...pages].sort((a, b) => a - b), reasons }\n}\n\nfunction checkPages(marks: Annotation[], pages: number) {\n  for (const a of marks) {\n    if (a.page > pages) {\n      throw new FreezeError(\n        'page-out-of-range',\n        `mark ${a.id} is on page ${a.page}; the document has ${pages}`\n      )\n    }\n  }\n}\n\nfunction checkAborted(signal?: AbortSignal) {\n  if (signal?.aborted) throw new DOMException('Freeze aborted', 'AbortError')\n}\n\n/** Load a PDF for editing, turning pdf-lib's failures into the one FreezeError the UI shows. */\nexport async function loadPdfDocument(bytes: Uint8Array): Promise<PDFDocument> {\n  try {\n    return await PDFDocument.load(bytes)\n  } catch (error) {\n    // pdf-lib is compiled to ES5, where a subclass of Error loses its prototype, so `instanceof`\n    // can be false for its own EncryptedPDFError; its message is the dependable signal.\n    if (\n      error instanceof EncryptedPDFError ||\n      /is encrypted/i.test((error as Error)?.message ?? '')\n    ) {\n      throw new FreezeError('encrypted', ENCRYPTED_MESSAGE)\n    }\n    throw new FreezeError('invalid-pdf', `The PDF could not be read: ${(error as Error).message}`)\n  }\n}\n\nasync function freezeAsVector(\n  original: Uint8Array,\n  marks: Annotation[],\n  comments: NonNullable<FreezeOptions['comments']>,\n  now: string,\n  warnings: string[]\n) {\n  const doc = await loadPdfDocument(original)\n  const pages = doc.getPages()\n  checkPages(marks, pages.length)\n\n  const ctx = await createVectorContext(doc, marks, comments)\n  for (const a of marks) drawVectorMark(pages[a.page - 1], a, ctx)\n\n  if (comments === 'appendix') {\n    const first = pages[0] ? displayedSize(pageGeometry(pages[0])) : undefined\n    const size: [number, number] = first ? [first.width, first.height] : FALLBACK_PAGE\n    appendCommentAppendix(\n      ctx,\n      marks.filter((a): a is CommentAnnotation => a.kind === 'comment'),\n      size\n    )\n  }\n  reportReplaced(ctx.sanitiser, warnings)\n  doc.setProducer('ARBI')\n  doc.setModificationDate(new Date(now))\n  return { doc, pages: pages.length }\n}\n\nasync function freezeAsImage(\n  marks: Annotation[],\n  options: FreezeOptions,\n  comments: NonNullable<FreezeOptions['comments']>,\n  dpi: number,\n  now: string,\n  warnings: string[]\n) {\n  const rasterizer = options.rasterizer\n  if (!rasterizer) {\n    throw new FreezeError('rasterizer-required', 'Image freeze needs a page rasterizer')\n  }\n  try {\n    checkPages(marks, rasterizer.numPages)\n    const out = await PDFDocument.create()\n    // A fresh document: nothing from the original (title, author, XMP, attachments) is carried over.\n    out.setProducer('ARBI')\n    out.setCreator('ARBI')\n    out.setCreationDate(new Date(now))\n    out.setModificationDate(new Date(now))\n\n    const numbers = numberComments(marks)\n    const format = options.imageFormat ?? 'jpeg'\n    const quality = options.jpegQuality ?? DEFAULT_JPEG_QUALITY\n    const burn = {\n      paddingPt: options.redactionPaddingPt ?? DEFAULT_REDACTION_PADDING_PT,\n      labels: options.redactionLabels ?? true,\n      comments,\n      numbers,\n      images: await stampImages(marks),\n    }\n    const ocrFont = options.ocr ? await out.embedFont(StandardFonts.Helvetica) : undefined\n    const ocrSanitiser = ocrFont ? new TextSanitiser(ocrFont) : undefined\n\n    let lowestDpi = dpi\n    let firstSize: [number, number] | undefined\n    for (let n = 1; n <= rasterizer.numPages; n++) {\n      checkAborted(options.signal)\n      const page = await rasterizer.renderPage(n, dpi)\n      try {\n        burnMarks(\n          page,\n          marks.filter((a) => a.page === n),\n          burn\n        )\n        const bytes = await page.encode(format, quality)\n        const image = format === 'png' ? await out.embedPng(bytes) : await out.embedJpg(bytes)\n        const outPage = out.addPage([page.widthPt, page.heightPt])\n        outPage.drawImage(image, { x: 0, y: 0, width: page.widthPt, height: page.heightPt })\n        lowestDpi = Math.min(lowestDpi, page.dpi)\n        firstSize ??= [page.widthPt, page.heightPt]\n\n        if (options.ocr && ocrFont && ocrSanitiser) {\n          const words = await options.ocr({\n            pageNumber: n,\n            bytes,\n            format,\n            widthPx: page.widthPx,\n            heightPx: page.heightPx,\n          })\n          drawInvisibleText(outPage, words, page.widthPt, page.heightPt, ocrFont, ocrSanitiser)\n        }\n      } finally {\n        page.release()\n      }\n      options.onProgress?.(n, rasterizer.numPages)\n    }\n\n    if (comments === 'appendix') {\n      const ctx = await createVectorContext(out, marks, comments)\n      appendCommentAppendix(\n        ctx,\n        marks.filter((a): a is CommentAnnotation => a.kind === 'comment'),\n        firstSize ?? FALLBACK_PAGE\n      )\n      reportReplaced(ctx.sanitiser, warnings)\n    }\n    return { doc: out, pages: rasterizer.numPages, dpi: Math.round(lowestDpi) }\n  } finally {\n    await rasterizer.destroy()\n  }\n}\n\n/** Invisible words over the burned image, so the page is searchable without the redacted text. */\nfunction drawInvisibleText(\n  page: ReturnType<PDFDocument['addPage']>,\n  words: OcrWord[],\n  widthPt: number,\n  heightPt: number,\n  font: Awaited<ReturnType<PDFDocument['embedFont']>>,\n  sanitiser: TextSanitiser\n) {\n  for (const w of words) {\n    if (!w.text || !sanitiser.supports(w.text)) continue\n    const size = Math.max(1, w.h * heightPt * 0.8)\n    page.drawText(w.text, {\n      x: w.x * widthPt,\n      y: heightPt - (w.y + w.h) * heightPt,\n      size,\n      font,\n      color: rgb(0, 0, 0),\n      opacity: 0,\n    })\n  }\n}\n\nfunction reportReplaced(sanitiser: TextSanitiser, warnings: string[]) {\n  if (sanitiser.replaced.size > 0) {\n    warnings.push(\n      `${sanitiser.replaced.size} character(s) in comments cannot be drawn by the built-in font and were replaced with \"?\"`\n    )\n  }\n}\n\nfunction setProvenance(doc: PDFDocument, provenance: FreezeProvenance) {\n  // The info dictionary exists once any metadata setter has run (both builders call one).\n  const info = doc.context.lookup(doc.context.trailerInfo.Info)\n  if (!info || !('set' in info)) throw new Error('document has no info dictionary')\n  ;(info as unknown as { set(k: PDFName, v: PDFHexString): void }).set(\n    PDFName.of(PROVENANCE_KEY),\n    PDFHexString.fromText(JSON.stringify(provenance))\n  )\n}\n\n/** Read the provenance record back out of a frozen PDF, or null if it has none. */\nexport async function readProvenance(bytes: Uint8Array): Promise<FreezeProvenance | null> {\n  const doc = await PDFDocument.load(bytes)\n  const info = doc.context.lookup(doc.context.trailerInfo.Info)\n  if (!info || !('get' in info)) return null\n  const value = (info as unknown as { get(k: PDFName): unknown }).get(PDFName.of(PROVENANCE_KEY))\n  if (!(value instanceof PDFHexString)) return null\n  return JSON.parse(value.decodeText()) as FreezeProvenance\n}\n\n/** The picture stamps' images, decoded for drawing onto rendered pages (none where unsupported). */\nasync function stampImages(marks: Annotation[]) {\n  const out = new Map<string, ImageBitmap>()\n  if (typeof createImageBitmap !== 'function') return out\n  for (const a of marks) {\n    if (a.kind !== 'stamp' || !a.image) continue\n    const raw = atob(a.image)\n    const bytes = new Uint8Array(raw.length)\n    for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i)\n    out.set(a.id, await createImageBitmap(new Blob([bytes], { type: 'image/png' })))\n  }\n  return out\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/annotations/freeze/hash.js

@@ -0,0 +1,28 @@
+async function sha256Hex(bytes) {
+  const copy = new Uint8Array(bytes.byteLength);
+  copy.set(bytes);
+  const digest = await globalThis.crypto.subtle.digest("SHA-256", copy.buffer);
+  return Array.from(new Uint8Array(digest), (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function canonicalJson(value) {
+  if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
+  if (value && typeof value === "object") {
+    const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+    return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonicalJson(v)}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+function layerFingerprint(layer) {
+  return {
+    ...layer,
+    annotations: layer.annotations.map((a) => {
+      return a.kind === "redaction" ? { ...a, text: void 0 } : a;
+    })
+  };
+}
+const hashLayer = (layer) => sha256Hex(new TextEncoder().encode(canonicalJson(layerFingerprint(layer))));
+export {
+  hashLayer,
+  sha256Hex
+};
+//# sourceMappingURL=hash.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/annotations/freeze/hash.ts"],
+  "sourcesContent": ["import type { AnnotationLayer } from '../model'\n\nexport async function sha256Hex(bytes: Uint8Array): Promise<string> {\n  // Copy into a plain ArrayBuffer: `bytes` may be a view over a larger or shared buffer.\n  const copy = new Uint8Array(bytes.byteLength)\n  copy.set(bytes)\n  const digest = await globalThis.crypto.subtle.digest('SHA-256', copy.buffer)\n  return Array.from(new Uint8Array(digest), (b) => b.toString(16).padStart(2, '0')).join('')\n}\n\n/** JSON with object keys sorted, so equal data always hashes equally. */\nfunction canonicalJson(value: unknown): string {\n  if (Array.isArray(value)) return `[${value.map(canonicalJson).join(',')}]`\n  if (value && typeof value === 'object') {\n    const entries = Object.entries(value as Record<string, unknown>)\n      .filter(([, v]) => v !== undefined)\n      .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n    return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonicalJson(v)}`).join(',')}}`\n  }\n  return JSON.stringify(value)\n}\n\n/** The layer as hashed for provenance: the text under redactions is dropped first. */\nfunction layerFingerprint(layer: AnnotationLayer): unknown {\n  return {\n    ...layer,\n    annotations: layer.annotations.map((a) => {\n      // `text: undefined` is dropped by canonicalJson, so the text never reaches the hash.\n      return a.kind === 'redaction' ? { ...a, text: undefined } : a\n    }),\n  }\n}\n\nexport const hashLayer = (layer: AnnotationLayer) =>\n  sha256Hex(new TextEncoder().encode(canonicalJson(layerFingerprint(layer))))\n"],
+  "mappings": "AAEA,eAAsB,UAAU,OAAoC;AAElE,QAAM,OAAO,IAAI,WAAW,MAAM,UAAU;AAC5C,OAAK,IAAI,KAAK;AACd,QAAM,SAAS,MAAM,WAAW,OAAO,OAAO,OAAO,WAAW,KAAK,MAAM;AAC3E,SAAO,MAAM,KAAK,IAAI,WAAW,MAAM,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AAC3F;AAGA,SAAS,cAAc,OAAwB;AAC7C,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,IAAI,MAAM,IAAI,aAAa,EAAE,KAAK,GAAG,CAAC;AACvE,MAAI,SAAS,OAAO,UAAU,UAAU;AACtC,UAAM,UAAU,OAAO,QAAQ,KAAgC,EAC5D,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,EACjC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAO,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAE;AAClD,WAAO,IAAI,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,UAAU,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC;AAAA,EAC1F;AACA,SAAO,KAAK,UAAU,KAAK;AAC7B;AAGA,SAAS,iBAAiB,OAAiC;AACzD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa,MAAM,YAAY,IAAI,CAAC,MAAM;AAExC,aAAO,EAAE,SAAS,cAAc,EAAE,GAAG,GAAG,MAAM,OAAU,IAAI;AAAA,IAC9D,CAAC;AAAA,EACH;AACF;AAEO,MAAM,YAAY,CAAC,UACxB,UAAU,IAAI,YAAY,EAAE,OAAO,cAAc,iBAAiB,KAAK,CAAC,CAAC,CAAC;",
+  "names": []
+}

package/dist/annotations/freeze/index-page.js

@@ -0,0 +1,78 @@
+import { StandardFonts, rgb } from "pdf-lib";
+import { TextSanitiser, wrap } from "./vector.js";
+const A4 = [595.28, 841.89];
+const MARGIN = 54;
+const LINE = 13;
+const TEXT = rgb(0.1, 0.1, 0.1);
+const MUTED = rgb(0.4, 0.4, 0.4);
+async function insertIndexPages(doc, entries, options) {
+  const regular = await doc.embedFont(StandardFonts.Helvetica);
+  const bold = await doc.embedFont(StandardFonts.HelveticaBold);
+  const sanitiser = new TextSanitiser(regular);
+  const [width, height] = options.size ?? A4;
+  const columns = {
+    number: MARGIN,
+    name: MARGIN + 28,
+    range: width - MARGIN - 190,
+    pages: width - MARGIN - 30
+  };
+  const nameWidth = columns.range - columns.name - 12;
+  let inserted = 0;
+  let page;
+  let y = 0;
+  const newPage = () => {
+    page = doc.insertPage(inserted++, [width, height]);
+    y = height - MARGIN;
+  };
+  const text = (value, x, font, size, color = TEXT) => page.drawText(sanitiser.clean(value), { x, y: y - size, size, font, color });
+  const header = () => {
+    text("#", columns.number, bold, 9, MUTED);
+    text("Document", columns.name, bold, 9, MUTED);
+    text("Bates range", columns.range, bold, 9, MUTED);
+    text("Pages", columns.pages, bold, 9, MUTED);
+    y -= LINE + 4;
+  };
+  newPage();
+  text("Production index", MARGIN, bold, 16);
+  y -= 24;
+  const first = entries[0]?.firstLabel;
+  const last = entries[entries.length - 1]?.lastLabel;
+  const total = entries.reduce((n, e) => n + e.pages, 0);
+  const summary = [
+    `${entries.length} document${entries.length === 1 ? "" : "s"}, ${total} page${total === 1 ? "" : "s"}`,
+    first && last ? `${first} to ${last}` : "",
+    `produced ${options.producedAt.slice(0, 10)}`,
+    options.producedBy ? `by ${options.producedBy}` : ""
+  ].filter(Boolean).join(", ");
+  text(summary, MARGIN, regular, 10, MUTED);
+  y -= LINE + 10;
+  header();
+  const rangeWidth = columns.pages - columns.range - 8;
+  entries.forEach((entry, i) => {
+    const lines = wrap(regular, sanitiser.clean(entry.name), 10, nameWidth);
+    const single = entry.firstLabel === entry.lastLabel ? entry.firstLabel : `${entry.firstLabel} - ${entry.lastLabel}`;
+    const range = regular.widthOfTextAtSize(sanitiser.clean(single), 10) <= rangeWidth ? [single] : [`${entry.firstLabel} -`, entry.lastLabel];
+    const rows = Math.max(lines.length, range.length);
+    if (y - rows * LINE < MARGIN) {
+      newPage();
+      header();
+    }
+    const top = y;
+    text(String(i + 1), columns.number, regular, 10);
+    text(String(entry.pages), columns.pages, regular, 10);
+    range.forEach((line, n) => {
+      y = top - n * LINE;
+      text(line, columns.range, regular, 10);
+    });
+    lines.forEach((line, n) => {
+      y = top - n * LINE;
+      text(line, columns.name, regular, 10);
+    });
+    y = top - rows * LINE - 4;
+  });
+  return inserted;
+}
+export {
+  insertIndexPages
+};
+//# sourceMappingURL=index-page.js.map

package/dist/annotations/freeze/index-page.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/annotations/freeze/index-page.ts"],
+  "sourcesContent": ["/**\n * The index (cover) page of a production: every document in numbering order with its Bates range\n * and page count. Plain vector text, so it is searchable; it carries no Bates label of its own.\n */\n\nimport { PDFDocument, StandardFonts, rgb, type PDFFont, type PDFPage } from 'pdf-lib'\nimport { TextSanitiser, wrap } from './vector'\n\nexport interface IndexEntry {\n  name: string\n  pages: number\n  firstLabel: string\n  lastLabel: string\n}\n\nexport interface IndexPageOptions {\n  /** Page size in points; defaults to A4. */\n  size?: [number, number]\n  /** ISO timestamp printed as the production date. */\n  producedAt: string\n  producedBy?: string\n}\n\nconst A4: [number, number] = [595.28, 841.89]\nconst MARGIN = 54\nconst LINE = 13\nconst TEXT = rgb(0.1, 0.1, 0.1)\nconst MUTED = rgb(0.4, 0.4, 0.4)\n\n/**\n * Insert the index as the first page(s) of `doc` (more than one when the list is long). Returns the\n * number of pages inserted.\n */\nexport async function insertIndexPages(\n  doc: PDFDocument,\n  entries: IndexEntry[],\n  options: IndexPageOptions\n): Promise<number> {\n  const regular = await doc.embedFont(StandardFonts.Helvetica)\n  const bold = await doc.embedFont(StandardFonts.HelveticaBold)\n  const sanitiser = new TextSanitiser(regular)\n  const [width, height] = options.size ?? A4\n  const columns = {\n    number: MARGIN,\n    name: MARGIN + 28,\n    range: width - MARGIN - 190,\n    pages: width - MARGIN - 30,\n  }\n  const nameWidth = columns.range - columns.name - 12\n\n  let inserted = 0\n  let page: PDFPage\n  let y = 0\n  const newPage = () => {\n    page = doc.insertPage(inserted++, [width, height])\n    y = height - MARGIN\n  }\n  const text = (value: string, x: number, font: PDFFont, size: number, color = TEXT) =>\n    page.drawText(sanitiser.clean(value), { x, y: y - size, size, font, color })\n  const header = () => {\n    text('#', columns.number, bold, 9, MUTED)\n    text('Document', columns.name, bold, 9, MUTED)\n    text('Bates range', columns.range, bold, 9, MUTED)\n    text('Pages', columns.pages, bold, 9, MUTED)\n    y -= LINE + 4\n  }\n\n  newPage()\n  text('Production index', MARGIN, bold, 16)\n  y -= 24\n  const first = entries[0]?.firstLabel\n  const last = entries[entries.length - 1]?.lastLabel\n  const total = entries.reduce((n, e) => n + e.pages, 0)\n  const summary = [\n    `${entries.length} document${entries.length === 1 ? '' : 's'}, ${total} page${total === 1 ? '' : 's'}`,\n    first && last ? `${first} to ${last}` : '',\n    `produced ${options.producedAt.slice(0, 10)}`,\n    options.producedBy ? `by ${options.producedBy}` : '',\n  ]\n    .filter(Boolean)\n    .join(', ')\n  text(summary, MARGIN, regular, 10, MUTED)\n  y -= LINE + 10\n  header()\n\n  const rangeWidth = columns.pages - columns.range - 8\n  entries.forEach((entry, i) => {\n    const lines = wrap(regular, sanitiser.clean(entry.name), 10, nameWidth)\n    const single =\n      entry.firstLabel === entry.lastLabel\n        ? entry.firstLabel\n        : `${entry.firstLabel} - ${entry.lastLabel}`\n    // A long prefix does not fit on one line: first label, then the last below it.\n    const range =\n      regular.widthOfTextAtSize(sanitiser.clean(single), 10) <= rangeWidth\n        ? [single]\n        : [`${entry.firstLabel} -`, entry.lastLabel]\n    const rows = Math.max(lines.length, range.length)\n    if (y - rows * LINE < MARGIN) {\n      newPage()\n      header()\n    }\n    const top = y\n    text(String(i + 1), columns.number, regular, 10)\n    text(String(entry.pages), columns.pages, regular, 10)\n    range.forEach((line, n) => {\n      y = top - n * LINE\n      text(line, columns.range, regular, 10)\n    })\n    lines.forEach((line, n) => {\n      y = top - n * LINE\n      text(line, columns.name, regular, 10)\n    })\n    y = top - rows * LINE - 4\n  })\n  return inserted\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/annotations/freeze/index.js

@@ -1,23 +1,29 @@
-import { createPdfJsRasterizer, browserCanvasFactory, freezePdf } from '../../chunk-NIKPG4PW.js';
-export { DEFAULT_DPI, FreezeError, MAX_PAGE_PIXELS, batesLabel, browserCanvasFactory, buildBundle, burnMarks, createPdfJsRasterizer, freezePdf, readProvenance } from '../../chunk-NIKPG4PW.js';
-import '../../chunk-PTOP7OHG.js';
-import { isEffectiveRedaction } from '../../chunk-T3USOSVN.js';
-import { pdfjs } from 'react-pdf';
-
-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 };
+import { freezePdf, readProvenance, DEFAULT_DPI } from "./freeze.js";
+import { freezePdfInBrowser } from "./browser.js";
+import {
+  buildBundle
+} from "./bundle.js";
+import { batesLabel } from "./stamp.js";
+import {
+  browserCanvasFactory,
+  burnMarks,
+  createPdfJsRasterizer,
+  MAX_PAGE_PIXELS
+} from "./raster.js";
+import {
+  FreezeError
+} from "./types.js";
+export {
+  DEFAULT_DPI,
+  FreezeError,
+  MAX_PAGE_PIXELS,
+  batesLabel,
+  browserCanvasFactory,
+  buildBundle,
+  burnMarks,
+  createPdfJsRasterizer,
+  freezePdf,
+  freezePdfInBrowser,
+  readProvenance
+};
 //# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

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

@@ -1 +1,7 @@
-{"version":3,"sources":["../../../src/annotations/freeze/browser.ts"],"names":[],"mappings":";;;;;;AAkBA,eAAsB,kBAAA,CACpB,OACA,KAAA,EACA,EAAE,QAAQ,QAAA,EAAU,GAAG,SAAQ,EACR;AAEvB,EAAA,MAAM,cAAc,OAAA,CAAQ,IAAA,KAAS,WAAW,KAAA,CAAM,WAAA,CAAY,KAAK,oBAAoB,CAAA;AAC3F,EAAA,MAAM,aAAa,WAAA,GACf,MAAM,sBAAsB,KAAA,EAAiC,KAAA,EAAO,sBAAqB,EAAG;AAAA,IAC1F,QAAA;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,OAAA,EAAS,QAAQ,OAAA,IAAW,SAAA;AAAA,MAC5B,UAAA,EAAY,IAAA;AAAA,MACZ,mBAAA,EAAqB,QAAQ,mBAAA,IAAuB,kBAAA;AAAA,MACpD,OAAA,EAAS,QAAQ,OAAA,IAAW;AAAA;AAC9B,GACD,CAAA,GACD,MAAA;AACJ,EAAA,OAAO,UAAU,KAAA,EAAO,KAAA,EAAO,EAAE,GAAG,OAAA,EAAS,YAAY,CAAA;AAC3D","file":"index.js","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"]}
+{
+  "version": 3,
+  "sources": ["../../../src/annotations/freeze/index.ts"],
+  "sourcesContent": ["/**\n * `@arbidocs/react/annotations/freeze` \u2014 derive a new document from an immutable original and its\n * annotation layer: flattened with text kept (`vector`), or rebuilt from page images (`image`,\n * always used when redactions apply).\n *\n * `buildBundle` then turns frozen PDFs into a production set: one merged file or one file per\n * document, numbered consecutively with a Bates label, optionally with a QR code on every page that\n * links back to the document in ARBI. Splitting documents is not part of it.\n *\n * A SEPARATE ENTRY on purpose: it needs `pdf-lib` and `react-pdf`, both optional peer dependencies,\n * so an app that only draws annotations installs and bundles neither.\n */\n\nexport { freezePdf, readProvenance, DEFAULT_DPI } from './freeze'\nexport { freezePdfInBrowser, type BrowserFreezeOptions } from './browser'\nexport {\n  buildBundle,\n  type BundleFile,\n  type BundleIndexEntry,\n  type BundleItem,\n  type BundleLayout,\n  type BundleOptions,\n  type BundleResult,\n} from './bundle'\nexport { batesLabel, type BatesOptions, type StampCorner } from './stamp'\nexport {\n  browserCanvasFactory,\n  burnMarks,\n  createPdfJsRasterizer,\n  MAX_PAGE_PIXELS,\n  type BurnOptions,\n  type CanvasFactory,\n  type CanvasHandle,\n  type PdfJsModule,\n  type PdfJsRasterizerOptions,\n} from './raster'\nexport {\n  FreezeError,\n  type CommentOutput,\n  type FreezeErrorCode,\n  type FreezeMode,\n  type FreezeOptions,\n  type FreezeProvenance,\n  type FreezeResult,\n  type OcrInput,\n  type OcrWord,\n  type PageRasterizer,\n  type RenderedPage,\n} from './types'\n"],
+  "mappings": "AAaA,SAAS,WAAW,gBAAgB,mBAAmB;AACvD,SAAS,0BAAqD;AAC9D;AAAA,EACE;AAAA,OAOK;AACP,SAAS,kBAAuD;AAChE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP;AAAA,EACE;AAAA,OAWK;",
+  "names": []
+}

package/dist/annotations/freeze/raster.js

@@ -0,0 +1,208 @@
+import { isEffectiveRedaction } from "../model.js";
+import { installPdfjsPolyfills } from "../../viewers/pdfjs-polyfills.js";
+import { HIGHLIGHT_OPACITY, MARKER_SIZE_PT } from "./vector.js";
+import {
+  ENCRYPTED_MESSAGE,
+  FreezeError
+} from "./types.js";
+const MAX_PAGE_PIXELS = 36e6;
+const MARKER_FILL = "#ffd43b";
+const MARKER_INK = "#7a5c00";
+function browserCanvasFactory() {
+  return (width, height) => {
+    if (typeof OffscreenCanvas !== "undefined") {
+      const canvas2 = new OffscreenCanvas(width, height);
+      const ctx2 = canvas2.getContext("2d");
+      return {
+        canvas: canvas2,
+        ctx: ctx2,
+        async encode(format, quality) {
+          const blob = await canvas2.convertToBlob({ type: `image/${format}`, quality });
+          return new Uint8Array(await blob.arrayBuffer());
+        },
+        release() {
+          canvas2.width = 0;
+          canvas2.height = 0;
+        }
+      };
+    }
+    const canvas = document.createElement("canvas");
+    canvas.width = width;
+    canvas.height = height;
+    const ctx = canvas.getContext("2d");
+    return {
+      canvas,
+      ctx,
+      encode(format, quality) {
+        return new Promise((resolve, reject) => {
+          canvas.toBlob(
+            (blob) => {
+              if (!blob) return reject(new Error("canvas could not be encoded"));
+              void blob.arrayBuffer().then((buf) => resolve(new Uint8Array(buf)), reject);
+            },
+            `image/${format}`,
+            quality
+          );
+        });
+      },
+      release() {
+        canvas.width = 0;
+        canvas.height = 0;
+      }
+    };
+  };
+}
+async function createPdfJsRasterizer(pdfjs, data, canvases, options = {}) {
+  installPdfjsPolyfills();
+  const task = pdfjs.getDocument({
+    data: data.slice(),
+    password: options.password,
+    ...options.documentOptions
+  });
+  let doc;
+  try {
+    doc = await task.promise;
+  } catch (error) {
+    await task.destroy().catch(() => {
+    });
+    if (error?.name === "PasswordException") {
+      throw new FreezeError("encrypted", ENCRYPTED_MESSAGE);
+    }
+    throw error;
+  }
+  return {
+    numPages: doc.numPages,
+    async renderPage(pageNumber, dpi) {
+      const page = await doc.getPage(pageNumber);
+      try {
+        const base = page.getViewport({ scale: 1 });
+        let scale = dpi / 72;
+        const pixels = base.width * scale * (base.height * scale);
+        if (pixels > MAX_PAGE_PIXELS) scale *= Math.sqrt(MAX_PAGE_PIXELS / pixels);
+        const viewport = page.getViewport({ scale });
+        const widthPx = Math.max(1, Math.ceil(viewport.width));
+        const heightPx = Math.max(1, Math.ceil(viewport.height));
+        const handle = canvases(widthPx, heightPx);
+        handle.ctx.fillStyle = "#ffffff";
+        handle.ctx.fillRect(0, 0, widthPx, heightPx);
+        await page.render({ canvasContext: handle.ctx, canvas: handle.canvas, viewport }).promise;
+        return {
+          widthPt: base.width,
+          heightPt: base.height,
+          widthPx,
+          heightPx,
+          dpi: scale * 72,
+          ctx: handle.ctx,
+          encode: handle.encode,
+          release: handle.release
+        };
+      } finally {
+        page.cleanup();
+      }
+    },
+    destroy: () => task.destroy()
+  };
+}
+function burnMarks(page, marks, options) {
+  const { ctx } = page;
+  const w = page.widthPx;
+  const h = page.heightPx;
+  const pxPerPt = page.widthPx / page.widthPt;
+  ctx.save();
+  for (const a of marks) {
+    if (a.kind === "highlight") {
+      ctx.globalCompositeOperation = "multiply";
+      ctx.globalAlpha = HIGHLIGHT_OPACITY;
+      ctx.fillStyle = a.color;
+      for (const r of a.rects) ctx.fillRect(r.x * w, r.y * h, r.w * w, r.h * h);
+      ctx.globalCompositeOperation = "source-over";
+      ctx.globalAlpha = 1;
+    }
+  }
+  for (const a of marks) {
+    if (a.kind === "box") {
+      ctx.strokeStyle = a.color;
+      ctx.lineWidth = a.strokeWidth * pxPerPt;
+      ctx.strokeRect(a.rect.x * w, a.rect.y * h, a.rect.w * w, a.rect.h * h);
+    } else if (a.kind === "stamp" && options.images?.get(a.id)) {
+      const picture = options.images.get(a.id);
+      const box = { x: a.rect.x * w, y: a.rect.y * h, w: a.rect.w * w, h: a.rect.h * h };
+      const scale = Math.min(box.w / picture.width, box.h / picture.height);
+      const dw = picture.width * scale;
+      const dh = picture.height * scale;
+      ctx.drawImage(picture, box.x + (box.w - dw) / 2, box.y + (box.h - dh) / 2, dw, dh);
+    } else if (a.kind === "stamp") {
+      drawStampOnCanvas(
+        ctx,
+        a.label,
+        a.color,
+        { x: a.rect.x * w, y: a.rect.y * h, w: a.rect.w * w, h: a.rect.h * h },
+        pxPerPt
+      );
+    } else if (a.kind === "comment" && options.comments !== "omit") {
+      drawMarkerOnCanvas(ctx, a, options.numbers.get(a.id), w, h, pxPerPt);
+    }
+  }
+  for (const a of marks) {
+    if (!isEffectiveRedaction(a)) continue;
+    const pad = options.paddingPt * pxPerPt;
+    a.rects.forEach((r, i) => {
+      const x0 = Math.max(0, Math.floor(r.x * w - pad));
+      const y0 = Math.max(0, Math.floor(r.y * h - pad));
+      const x1 = Math.min(w, Math.ceil((r.x + r.w) * w + pad));
+      const y1 = Math.min(h, Math.ceil((r.y + r.h) * h + pad));
+      ctx.fillStyle = "#000000";
+      ctx.fillRect(x0, y0, x1 - x0, y1 - y0);
+      if (options.labels && i === 0)
+        drawLabel(ctx, "[REDACTED]", { x: x0, y: y0, w: x1 - x0, h: y1 - y0 });
+    });
+  }
+  ctx.restore();
+}
+function drawStampOnCanvas(ctx, label, color, box, pxPerPt) {
+  ctx.strokeStyle = color;
+  ctx.lineWidth = 2 * pxPerPt;
+  ctx.strokeRect(box.x, box.y, box.w, box.h);
+  ctx.fillStyle = color;
+  ctx.textAlign = "center";
+  ctx.textBaseline = "middle";
+  ctx.font = "bold 100px Helvetica, Arial, sans-serif";
+  const probe = ctx.measureText(label).width;
+  const size = Math.max(1, Math.min(box.h * 0.6, probe > 0 ? box.w * 0.9 * 100 / probe : box.h));
+  ctx.font = `bold ${size}px Helvetica, Arial, sans-serif`;
+  ctx.fillText(label, box.x + box.w / 2, box.y + box.h / 2);
+}
+function drawMarkerOnCanvas(ctx, a, n, w, h, pxPerPt) {
+  if (n === void 0) return;
+  const size = MARKER_SIZE_PT * pxPerPt;
+  const x = Math.min(a.rect.x * w, w - size);
+  const y = Math.min(a.rect.y * h, h - size);
+  ctx.fillStyle = MARKER_FILL;
+  ctx.fillRect(x, y, size, size);
+  ctx.strokeStyle = MARKER_INK;
+  ctx.lineWidth = 0.75 * pxPerPt;
+  ctx.strokeRect(x, y, size, size);
+  ctx.fillStyle = MARKER_INK;
+  ctx.textAlign = "center";
+  ctx.textBaseline = "middle";
+  ctx.font = `bold ${7 * pxPerPt}px Helvetica, Arial, sans-serif`;
+  ctx.fillText(String(n), x + size / 2, y + size / 2);
+}
+function drawLabel(ctx, text, box) {
+  const size = Math.min(box.h * 0.7, 14);
+  if (size < 6) return;
+  ctx.font = `${size}px Helvetica, Arial, sans-serif`;
+  const width = ctx.measureText(text).width;
+  if (width > box.w - 4) return;
+  ctx.fillStyle = "#ffffff";
+  ctx.textAlign = "center";
+  ctx.textBaseline = "middle";
+  ctx.fillText(text, box.x + box.w / 2, box.y + box.h / 2);
+}
+export {
+  MAX_PAGE_PIXELS,
+  browserCanvasFactory,
+  burnMarks,
+  createPdfJsRasterizer
+};
+//# sourceMappingURL=raster.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/annotations/freeze/raster.ts"],
+  "sourcesContent": ["/**\n * Image-only freeze: render each page onto a canvas, burn the marks into the pixels, and encode.\n * Once a redaction rectangle is painted black the original pixels are gone, and the rebuilt PDF\n * has no text layer, so nothing sits behind the box.\n */\n\nimport type { Annotation, CommentAnnotation } from '../model'\nimport { isEffectiveRedaction } from '../model'\nimport { installPdfjsPolyfills } from '../../viewers/pdfjs-polyfills'\nimport { HIGHLIGHT_OPACITY, MARKER_SIZE_PT } from './vector'\nimport {\n  ENCRYPTED_MESSAGE,\n  FreezeError,\n  type CommentOutput,\n  type PageRasterizer,\n  type RenderedPage,\n} from './types'\n\n/** A canvas the freeze code can draw on, produced by the host's environment. */\nexport interface CanvasHandle {\n  canvas: unknown\n  ctx: CanvasRenderingContext2D\n  encode(format: 'jpeg' | 'png', quality: number): Promise<Uint8Array>\n  release(): void\n}\nexport type CanvasFactory = (width: number, height: number) => CanvasHandle\n\n/** Pages beyond this many pixels are rendered at a lower DPI (mobile Safari fails near 16.7M). */\nexport const MAX_PAGE_PIXELS = 36_000_000\nconst MARKER_FILL = '#ffd43b'\nconst MARKER_INK = '#7a5c00'\n\nexport function browserCanvasFactory(): CanvasFactory {\n  return (width, height) => {\n    if (typeof OffscreenCanvas !== 'undefined') {\n      const canvas = new OffscreenCanvas(width, height)\n      const ctx = canvas.getContext('2d') as unknown as CanvasRenderingContext2D\n      return {\n        canvas,\n        ctx,\n        async encode(format, quality) {\n          const blob = await canvas.convertToBlob({ type: `image/${format}`, quality })\n          return new Uint8Array(await blob.arrayBuffer())\n        },\n        release() {\n          canvas.width = 0\n          canvas.height = 0\n        },\n      }\n    }\n    const canvas = document.createElement('canvas')\n    canvas.width = width\n    canvas.height = height\n    const ctx = canvas.getContext('2d') as CanvasRenderingContext2D\n    return {\n      canvas,\n      ctx,\n      encode(format, quality) {\n        return new Promise((resolve, reject) => {\n          canvas.toBlob(\n            (blob) => {\n              if (!blob) return reject(new Error('canvas could not be encoded'))\n              void blob.arrayBuffer().then((buf) => resolve(new Uint8Array(buf)), reject)\n            },\n            `image/${format}`,\n            quality\n          )\n        })\n      },\n      release() {\n        canvas.width = 0\n        canvas.height = 0\n      },\n    }\n  }\n}\n\ninterface PdfJsViewport {\n  width: number\n  height: number\n}\ninterface PdfJsPage {\n  getViewport(options: { scale: number }): PdfJsViewport\n  render(params: {\n    canvasContext: CanvasRenderingContext2D\n    canvas: unknown\n    viewport: PdfJsViewport\n  }): { promise: Promise<void> }\n  cleanup(): void\n}\ninterface PdfJsDocument {\n  numPages: number\n  getPage(n: number): Promise<PdfJsPage>\n}\ninterface PdfJsLoadingTask {\n  promise: Promise<PdfJsDocument>\n  /** pdf.js 6 removed `PDFDocumentProxy.destroy()`; the loading task owns teardown. */\n  destroy(): Promise<void>\n}\n/** The slice of `pdfjs-dist` the rasteriser needs, so the host decides which build to pass. */\nexport interface PdfJsModule {\n  getDocument(source: Record<string, unknown>): PdfJsLoadingTask\n}\n\nexport interface PdfJsRasterizerOptions {\n  password?: string\n  /** Extra `getDocument` options: cMapUrl, standardFontDataUrl, wasmUrl... */\n  documentOptions?: Record<string, unknown>\n}\n\nexport async function createPdfJsRasterizer(\n  pdfjs: PdfJsModule,\n  data: Uint8Array,\n  canvases: CanvasFactory,\n  options: PdfJsRasterizerOptions = {}\n): Promise<PageRasterizer> {\n  installPdfjsPolyfills()\n  // pdf.js takes ownership of the buffer, so hand it a copy and keep the caller's bytes intact.\n  const task = pdfjs.getDocument({\n    data: data.slice(),\n    password: options.password,\n    ...options.documentOptions,\n  })\n  let doc: PdfJsDocument\n  try {\n    doc = await task.promise\n  } catch (error) {\n    await task.destroy().catch(() => {})\n    if ((error as { name?: string })?.name === 'PasswordException') {\n      throw new FreezeError('encrypted', ENCRYPTED_MESSAGE)\n    }\n    throw error\n  }\n\n  return {\n    numPages: doc.numPages,\n    async renderPage(pageNumber, dpi): Promise<RenderedPage> {\n      const page = await doc.getPage(pageNumber)\n      try {\n        const base = page.getViewport({ scale: 1 })\n        let scale = dpi / 72\n        const pixels = base.width * scale * (base.height * scale)\n        if (pixels > MAX_PAGE_PIXELS) scale *= Math.sqrt(MAX_PAGE_PIXELS / pixels)\n        const viewport = page.getViewport({ scale })\n        const widthPx = Math.max(1, Math.ceil(viewport.width))\n        const heightPx = Math.max(1, Math.ceil(viewport.height))\n        const handle = canvases(widthPx, heightPx)\n        handle.ctx.fillStyle = '#ffffff'\n        handle.ctx.fillRect(0, 0, widthPx, heightPx)\n        await page.render({ canvasContext: handle.ctx, canvas: handle.canvas, viewport }).promise\n        return {\n          widthPt: base.width,\n          heightPt: base.height,\n          widthPx,\n          heightPx,\n          dpi: scale * 72,\n          ctx: handle.ctx,\n          encode: handle.encode,\n          release: handle.release,\n        }\n      } finally {\n        page.cleanup()\n      }\n    },\n    destroy: () => task.destroy(),\n  }\n}\n\nexport interface BurnOptions {\n  /** Margin added around each redaction rectangle, in points. */\n  paddingPt: number\n  labels: boolean\n  comments: CommentOutput\n  numbers: Map<string, number>\n  /** Picture stamps' images, decoded, by mark id (a stamp without one draws its label). */\n  images?: Map<string, CanvasImageSource & { width: number; height: number }>\n}\n\n/** Paint every mark for one page onto its rendered pixels. Redactions go last, on top. */\nexport function burnMarks(page: RenderedPage, marks: Annotation[], options: BurnOptions) {\n  const { ctx } = page\n  const w = page.widthPx\n  const h = page.heightPx\n  const pxPerPt = page.widthPx / page.widthPt\n\n  ctx.save()\n  for (const a of marks) {\n    if (a.kind === 'highlight') {\n      ctx.globalCompositeOperation = 'multiply'\n      ctx.globalAlpha = HIGHLIGHT_OPACITY\n      ctx.fillStyle = a.color\n      for (const r of a.rects) ctx.fillRect(r.x * w, r.y * h, r.w * w, r.h * h)\n      ctx.globalCompositeOperation = 'source-over'\n      ctx.globalAlpha = 1\n    }\n  }\n  for (const a of marks) {\n    if (a.kind === 'box') {\n      ctx.strokeStyle = a.color\n      ctx.lineWidth = a.strokeWidth * pxPerPt\n      ctx.strokeRect(a.rect.x * w, a.rect.y * h, a.rect.w * w, a.rect.h * h)\n    } else if (a.kind === 'stamp' && options.images?.get(a.id)) {\n      const picture = options.images.get(a.id)!\n      const box = { x: a.rect.x * w, y: a.rect.y * h, w: a.rect.w * w, h: a.rect.h * h }\n      const scale = Math.min(box.w / picture.width, box.h / picture.height)\n      const dw = picture.width * scale\n      const dh = picture.height * scale\n      ctx.drawImage(picture, box.x + (box.w - dw) / 2, box.y + (box.h - dh) / 2, dw, dh)\n    } else if (a.kind === 'stamp') {\n      drawStampOnCanvas(\n        ctx,\n        a.label,\n        a.color,\n        { x: a.rect.x * w, y: a.rect.y * h, w: a.rect.w * w, h: a.rect.h * h },\n        pxPerPt\n      )\n    } else if (a.kind === 'comment' && options.comments !== 'omit') {\n      drawMarkerOnCanvas(ctx, a, options.numbers.get(a.id), w, h, pxPerPt)\n    }\n  }\n  for (const a of marks) {\n    if (!isEffectiveRedaction(a)) continue\n    const pad = options.paddingPt * pxPerPt\n    a.rects.forEach((r, i) => {\n      // Floor/ceil so anti-aliased edge pixels are covered rather than left half-grey.\n      const x0 = Math.max(0, Math.floor(r.x * w - pad))\n      const y0 = Math.max(0, Math.floor(r.y * h - pad))\n      const x1 = Math.min(w, Math.ceil((r.x + r.w) * w + pad))\n      const y1 = Math.min(h, Math.ceil((r.y + r.h) * h + pad))\n      ctx.fillStyle = '#000000'\n      ctx.fillRect(x0, y0, x1 - x0, y1 - y0)\n      if (options.labels && i === 0)\n        drawLabel(ctx, '[REDACTED]', { x: x0, y: y0, w: x1 - x0, h: y1 - y0 })\n    })\n  }\n  ctx.restore()\n}\n\nfunction drawStampOnCanvas(\n  ctx: CanvasRenderingContext2D,\n  label: string,\n  color: string,\n  box: { x: number; y: number; w: number; h: number },\n  pxPerPt: number\n) {\n  ctx.strokeStyle = color\n  ctx.lineWidth = 2 * pxPerPt\n  ctx.strokeRect(box.x, box.y, box.w, box.h)\n  ctx.fillStyle = color\n  ctx.textAlign = 'center'\n  ctx.textBaseline = 'middle'\n  ctx.font = 'bold 100px Helvetica, Arial, sans-serif'\n  const probe = ctx.measureText(label).width\n  const size = Math.max(1, Math.min(box.h * 0.6, probe > 0 ? (box.w * 0.9 * 100) / probe : box.h))\n  ctx.font = `bold ${size}px Helvetica, Arial, sans-serif`\n  ctx.fillText(label, box.x + box.w / 2, box.y + box.h / 2)\n}\n\nfunction drawMarkerOnCanvas(\n  ctx: CanvasRenderingContext2D,\n  a: CommentAnnotation,\n  n: number | undefined,\n  w: number,\n  h: number,\n  pxPerPt: number\n) {\n  if (n === undefined) return\n  const size = MARKER_SIZE_PT * pxPerPt\n  const x = Math.min(a.rect.x * w, w - size)\n  const y = Math.min(a.rect.y * h, h - size)\n  ctx.fillStyle = MARKER_FILL\n  ctx.fillRect(x, y, size, size)\n  ctx.strokeStyle = MARKER_INK\n  ctx.lineWidth = 0.75 * pxPerPt\n  ctx.strokeRect(x, y, size, size)\n  ctx.fillStyle = MARKER_INK\n  ctx.textAlign = 'center'\n  ctx.textBaseline = 'middle'\n  ctx.font = `bold ${7 * pxPerPt}px Helvetica, Arial, sans-serif`\n  ctx.fillText(String(n), x + size / 2, y + size / 2)\n}\n\n/** Print the redaction reason in white on the black box, only when it fits legibly. */\nfunction drawLabel(\n  ctx: CanvasRenderingContext2D,\n  text: string,\n  box: { x: number; y: number; w: number; h: number }\n) {\n  const size = Math.min(box.h * 0.7, 14)\n  if (size < 6) return\n  ctx.font = `${size}px Helvetica, Arial, sans-serif`\n  const width = ctx.measureText(text).width\n  if (width > box.w - 4) return\n  ctx.fillStyle = '#ffffff'\n  ctx.textAlign = 'center'\n  ctx.textBaseline = 'middle'\n  ctx.fillText(text, box.x + box.w / 2, box.y + box.h / 2)\n}\n"],
+  "mappings": "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",
+  "names": ["canvas", "ctx"]
+}

package/dist/annotations/freeze/stamp.js

@@ -0,0 +1,117 @@
+import qrcode from "qrcode-generator";
+import { degrees, rgb } from "pdf-lib";
+import { displayedSize, displayedToUser, normToUserRect } from "./coords.js";
+import { pageGeometry } from "./vector.js";
+import { FreezeError } from "./types.js";
+const EDGE_MARGIN_PT = 18;
+const BATES_FONT_SIZE_PT = 9;
+const QR_SIZE_PT = 56;
+const QR_QUIET_MODULES = 2;
+const PLATE_PADDING_PT = 2;
+function batesLabel(options, index) {
+  const digits = options.digits ?? 6;
+  const number = String(Math.floor((options.start ?? 1) + index)).padStart(digits, "0");
+  return `${options.prefix ?? ""}${number}`;
+}
+function validateBates(options) {
+  const { start = 1, digits = 6 } = options;
+  if (!Number.isInteger(start) || start < 0) {
+    throw new FreezeError("invalid-option", "Bates start must be a whole number, 0 or more");
+  }
+  if (!Number.isInteger(digits) || digits < 1 || digits > 12) {
+    throw new FreezeError("invalid-option", "Bates digits must be a whole number from 1 to 12");
+  }
+}
+function plateOrigin(g, corner, w, h) {
+  const size = displayedSize(g);
+  return {
+    x: corner.endsWith("left") ? EDGE_MARGIN_PT : size.width - EDGE_MARGIN_PT - w,
+    y: corner.startsWith("top") ? EDGE_MARGIN_PT : size.height - EDGE_MARGIN_PT - h
+  };
+}
+function drawPlate(page, g, box) {
+  const size = displayedSize(g);
+  const u = normToUserRect(g, {
+    x: box.x / size.width,
+    y: box.y / size.height,
+    w: box.w / size.width,
+    h: box.h / size.height
+  });
+  page.drawRectangle({ x: u.x, y: u.y, width: u.width, height: u.height, color: rgb(1, 1, 1) });
+}
+function drawBatesLabel(page, label, font, corner) {
+  const g = pageGeometry(page);
+  const textWidth = font.widthOfTextAtSize(label, BATES_FONT_SIZE_PT);
+  const w = textWidth + PLATE_PADDING_PT * 2;
+  const h = BATES_FONT_SIZE_PT + PLATE_PADDING_PT * 2;
+  const { x, y } = plateOrigin(g, corner, w, h);
+  drawPlate(page, g, { x, y, w, h });
+  const origin = displayedToUser(
+    g,
+    x + PLATE_PADDING_PT,
+    y + PLATE_PADDING_PT + BATES_FONT_SIZE_PT * 0.8
+  );
+  page.drawText(label, {
+    x: origin.x,
+    y: origin.y,
+    size: BATES_FONT_SIZE_PT,
+    font,
+    color: rgb(0, 0, 0),
+    rotate: degrees(g.rotation)
+  });
+}
+function buildQr(text) {
+  try {
+    const qr = qrcode(0, "M");
+    qr.addData(text, "Byte");
+    qr.make();
+    return { modules: qr.getModuleCount(), isDark: (r, c) => qr.isDark(r, c) };
+  } catch (error) {
+    throw new FreezeError(
+      "invalid-option",
+      `The QR link could not be encoded: ${error.message}`
+    );
+  }
+}
+function drawQr(page, qr, corner) {
+  const g = pageGeometry(page);
+  const total = qr.modules + QR_QUIET_MODULES * 2;
+  const module = QR_SIZE_PT / total;
+  const { x, y } = plateOrigin(g, corner, QR_SIZE_PT, QR_SIZE_PT);
+  drawPlate(page, g, { x, y, w: QR_SIZE_PT, h: QR_SIZE_PT });
+  const size = displayedSize(g);
+  for (let row = 0; row < qr.modules; row++) {
+    let col = 0;
+    while (col < qr.modules) {
+      if (!qr.isDark(row, col)) {
+        col++;
+        continue;
+      }
+      const startCol = col;
+      while (col < qr.modules && qr.isDark(row, col)) col++;
+      const u = normToUserRect(g, {
+        x: (x + (QR_QUIET_MODULES + startCol) * module) / size.width,
+        y: (y + (QR_QUIET_MODULES + row) * module) / size.height,
+        w: (col - startCol) * module / size.width,
+        h: module / size.height
+      });
+      page.drawRectangle({
+        x: u.x,
+        y: u.y,
+        width: u.width,
+        height: u.height,
+        color: rgb(0, 0, 0)
+      });
+    }
+  }
+}
+export {
+  EDGE_MARGIN_PT,
+  QR_SIZE_PT,
+  batesLabel,
+  buildQr,
+  drawBatesLabel,
+  drawQr,
+  validateBates
+};
+//# sourceMappingURL=stamp.js.map