pdfnative 1.4.0 → 1.5.0

package/dist/index.js

@@ -2322,6 +2322,16 @@ var MYANMAR_EXTENDED_A_END = 43647;
 var MYANMAR_EXTENDED_B_START = 43488;
 var MYANMAR_EXTENDED_B_END = 43519;
 var MYANMAR_VIRAMA = 4153;
+var MATH_OPERATORS_START = 8704;
+var MATH_OPERATORS_END = 8959;
+var SUPPLEMENTAL_MATH_OPERATORS_START = 10752;
+var SUPPLEMENTAL_MATH_OPERATORS_END = 11007;
+var GEOMETRIC_SHAPES_START = 9632;
+var GEOMETRIC_SHAPES_END = 9727;
+var MISC_MATH_SYMBOLS_A_START = 10176;
+var MISC_MATH_SYMBOLS_A_END = 10223;
+var MISC_MATH_SYMBOLS_B_START = 10624;
+var MISC_MATH_SYMBOLS_B_END = 10751;
 var EMOJI_RANGES = [
   [127744, 128511],
   // Miscellaneous Symbols and Pictographs
@@ -2400,6 +2410,9 @@ function isMyanmarCodepoint(cp) {
 function isDevanagariCodepoint(cp) {
   return cp >= DEVANAGARI_START && cp <= DEVANAGARI_END || cp >= DEVANAGARI_EXT_START && cp <= DEVANAGARI_EXT_END;
 }
+function isMathCodepoint(cp) {
+  return cp >= MATH_OPERATORS_START && cp <= MATH_OPERATORS_END || cp >= SUPPLEMENTAL_MATH_OPERATORS_START && cp <= SUPPLEMENTAL_MATH_OPERATORS_END || cp >= GEOMETRIC_SHAPES_START && cp <= GEOMETRIC_SHAPES_END || cp >= MISC_MATH_SYMBOLS_A_START && cp <= MISC_MATH_SYMBOLS_A_END || cp >= MISC_MATH_SYMBOLS_B_START && cp <= MISC_MATH_SYMBOLS_B_END;
+}
 function isEmojiCodepoint(cp) {
   if (cp >= FITZPATRICK_START && cp <= FITZPATRICK_END) return true;
   for (const [lo, hi] of EMOJI_RANGES) {
@@ -2486,10 +2499,16 @@ function containsDevanagari(str) {
   }
   return false;
 }
+function containsMath(str) {
+  for (let i = 0; i < str.length; i++) {
+    if (isMathCodepoint(str.charCodeAt(i))) return true;
+  }
+  return false;
+}
 
 // src/shaping/script-detect.ts
 function needsUnicodeFont(lang) {
-  return ["th", "ja", "zh", "ko", "el", "hi", "te", "tr", "vi", "pl", "ar", "he", "ru", "ka", "hy", "am", "si", "bo", "km", "my", "emoji"].includes(lang);
+  return ["th", "ja", "zh", "ko", "el", "hi", "te", "tr", "vi", "pl", "ar", "he", "ru", "ka", "hy", "am", "si", "bo", "km", "my", "math", "emoji"].includes(lang);
 }
 function detectFallbackLangs(texts, primaryLang) {
   const needed = /* @__PURE__ */ new Set();
@@ -2590,6 +2609,10 @@ function detectFallbackLangs(texts, primaryLang) {
         needed.add("hy");
         continue;
       }
+      if (isMathCodepoint(cp)) {
+        needed.add("math");
+        continue;
+      }
       if (isEmojiCodepoint(cp)) {
         needed.add("emoji");
         continue;
@@ -2620,6 +2643,7 @@ function detectCharLang(cp) {
   if (cp >= 1024 && cp <= 1279 || cp >= 1280 && cp <= 1327) return "ru";
   if (cp >= 4256 && cp <= 4351 || cp >= 11520 && cp <= 11567) return "ka";
   if (cp >= 1328 && cp <= 1423 || cp >= 64275 && cp <= 64279) return "hy";
+  if (isMathCodepoint(cp)) return "math";
   if (isEmojiCodepoint(cp)) return "emoji";
   return null;
 }
@@ -6249,6 +6273,10 @@ function buildTextRunsWithFallback(text, fontRef, fd, sz, trackGid, pdfA = false
   for (let i = 0; i < text.length; ) {
     const rawCp = text.codePointAt(i) ?? 0;
     const charLen = rawCp > 65535 ? 2 : 1;
+    if (rawCp < 32 || rawCp === 127) {
+      i += charLen;
+      continue;
+    }
     const cp = rawCp === 8239 || rawCp === 160 ? 32 : rawCp;
     const char = text.substring(i, i + charLen);
     const gid = fd.cmap[cp] ?? 0;
@@ -8792,6 +8820,61 @@ function buildViewerPreferences(prefs) {
 // src/core/pdf-document.ts
 init_pdf_encrypt();
 
+// src/core/pdf-layout-debug.ts
+function resolveDebugOptions(debug) {
+  if (!debug) return null;
+  if (debug === true) {
+    return { showMargins: true, showContentBounds: true, showCells: true };
+  }
+  const showMargins = debug.showMargins === true;
+  const showContentBounds = debug.showContentBounds === true;
+  const showCells = debug.showCells === true;
+  if (!showMargins && !showContentBounds && !showCells) return null;
+  return { showMargins, showContentBounds, showCells };
+}
+var COL_MARGIN = "0 0.45 0.95";
+var COL_BLOCK = "0.90 0.20 0.30";
+var COL_CELL = "0 0.62 0.30";
+function rectOp(x, y, w, h, color, lineW) {
+  return `q ${color} RG ${fmtNum(lineW)} w ${fmtNum(x)} ${fmtNum(y)} ${fmtNum(w)} ${fmtNum(h)} re S Q`;
+}
+function marginBoxOps(pgW, pgH, mg, footerH) {
+  const x = mg.l;
+  const yBottom = mg.b + footerH;
+  const w = pgW - mg.l - mg.r;
+  const h = pgH - mg.t - yBottom;
+  return rectOp(x, yBottom, w, h, COL_MARGIN, 0.5);
+}
+function blockBoundsOps(x, width, yTop, yBottom) {
+  const h = yTop - yBottom;
+  if (h <= 0) return "";
+  return rectOp(x, yBottom, width, h, COL_BLOCK, 0.4);
+}
+function tableCellOps(plan, slice, yTop) {
+  const drawCaption = slice ? slice.drawCaption : true;
+  const drawHeader = slice ? slice.drawHeader : true;
+  const fromRow = slice ? slice.fromRow : 0;
+  const toRow = slice ? slice.toRow : plan.rowHeights.length;
+  const parts = [];
+  let y = yTop - (drawCaption ? plan.captionHeight : 0);
+  if (drawHeader) {
+    const hBottom = y - plan.headerHeight;
+    for (let c = 0; c < plan.cx.length; c++) {
+      parts.push(rectOp(plan.cx[c], hBottom, plan.cwi[c], plan.headerHeight, COL_CELL, 0.3));
+    }
+    y = hBottom;
+  }
+  for (let r = fromRow; r < toRow; r++) {
+    const rh = plan.rowHeights[r];
+    const rBottom = y - rh;
+    for (let c = 0; c < plan.cx.length; c++) {
+      parts.push(rectOp(plan.cx[c], rBottom, plan.cwi[c], rh, COL_CELL, 0.3));
+    }
+    y = rBottom;
+  }
+  return parts.join("\n");
+}
+
 // src/core/pdf-form.ts
 var DEFAULT_FIELD_HEIGHT_TEXT = 22;
 var DEFAULT_FIELD_HEIGHT_MULTILINE = 60;
@@ -10926,6 +11009,51 @@ function getNum(attrs, name, def = 0) {
   const v = getAttr(attrs, name);
   return v !== void 0 ? +v : def;
 }
+function getLen(attrs, name) {
+  const v = getAttr(attrs, name);
+  if (v === void 0) return void 0;
+  const n2 = parseFloat(v);
+  return Number.isFinite(n2) ? n2 : void 0;
+}
+function decodeSvgEntities(s) {
+  return s.replace(/&(#x[0-9a-fA-F]+|#[0-9]+|[a-zA-Z]+);/g, (_m, ent) => {
+    if (ent[0] === "#") {
+      const cp = ent[1] === "x" || ent[1] === "X" ? parseInt(ent.slice(2), 16) : parseInt(ent.slice(1), 10);
+      return Number.isFinite(cp) && cp >= 0 && cp <= 1114111 ? String.fromCodePoint(cp) : "";
+    }
+    switch (ent) {
+      case "amp":
+        return "&";
+      case "lt":
+        return "<";
+      case "gt":
+        return ">";
+      case "quot":
+        return '"';
+      case "apos":
+        return "'";
+      case "nbsp":
+        return "\xA0";
+      default:
+        return "";
+    }
+  });
+}
+function stripSvgTags(raw) {
+  let out = "";
+  let inTag = false;
+  for (const ch2 of raw) {
+    if (ch2 === "<") inTag = true;
+    else if (ch2 === ">") inTag = false;
+    else if (!inTag) out += ch2;
+  }
+  return out;
+}
+function sanitizeSvgText(raw) {
+  const noTags = stripSvgTags(raw);
+  const decoded = decodeSvgEntities(noTags);
+  return decoded.replace(/[\u0000-\u001F\u007F-\u009F]+/g, " ").replace(/\s+/g, " ").trim();
+}
 function rectToPath(x, y, w, h, rx, ry) {
   if (w <= 0 || h <= 0) return "";
   if (rx <= 0 && ry <= 0) {
@@ -11007,7 +11135,60 @@ function parseSvgMarkup(svg) {
       });
     }
   }
-  return { elements, viewBox };
+  const textElements = parseSvgText(svg);
+  return { elements, textElements, viewBox };
+}
+function parseSvgText(svg) {
+  const out = [];
+  const textRe = /<text\b([^>]*)>([\s\S]*?)<\/text>/gi;
+  let tm;
+  while ((tm = textRe.exec(svg)) !== null) {
+    const attrs = tm[1];
+    const inner = tm[2];
+    const baseX = getLen(attrs, "x") ?? 0;
+    const baseY = getLen(attrs, "y") ?? 0;
+    const baseSize = getLen(attrs, "font-size") ?? 16;
+    const baseFillRaw = getAttr(attrs, "fill");
+    const baseFill = baseFillRaw ? normalizeSvgColor(baseFillRaw) : void 0;
+    const baseAnchor = normalizeAnchor(getAttr(attrs, "text-anchor"));
+    const tspanRe = /<tspan\b([^>]*)>([\s\S]*?)<\/tspan>/gi;
+    let sm;
+    let penX = baseX;
+    let penY = baseY;
+    let found = false;
+    while ((sm = tspanRe.exec(inner)) !== null) {
+      found = true;
+      const sa = sm[1];
+      const text = sanitizeSvgText(sm[2]);
+      const ax = getLen(sa, "x");
+      const ay = getLen(sa, "y");
+      const adx = getLen(sa, "dx");
+      const ady = getLen(sa, "dy");
+      penX = ax !== void 0 ? ax : penX + (adx ?? 0);
+      penY = ay !== void 0 ? ay : penY + (ady ?? 0);
+      if (!text) continue;
+      const fillRaw = getAttr(sa, "fill");
+      out.push({
+        text,
+        x: penX,
+        y: penY,
+        fontSize: getLen(sa, "font-size") ?? baseSize,
+        fill: fillRaw ? normalizeSvgColor(fillRaw) : baseFill,
+        anchor: normalizeAnchor(getAttr(sa, "text-anchor")) ?? baseAnchor
+      });
+    }
+    if (!found) {
+      const text = sanitizeSvgText(inner);
+      if (text) {
+        out.push({ text, x: baseX, y: baseY, fontSize: baseSize, fill: baseFill, anchor: baseAnchor });
+      }
+    }
+  }
+  return out;
+}
+function normalizeAnchor(v) {
+  if (v === "middle" || v === "end" || v === "start") return v;
+  return void 0;
 }
 var fn = (n2) => n2.toFixed(2);
 function resolveColor(color, fallback) {
@@ -11043,36 +11224,62 @@ function buildPathOps(segments, fillRgb, strokeRgb, strokeWidth) {
   ops.push("Q");
   return ops.join("\n");
 }
-function renderSvg(data, x, y, w, h, options) {
+function renderSvg(data, x, y, w, h, options, enc) {
   if (!data || w <= 0 || h <= 0) return "";
   const isSvgMarkup = data.trimStart().charAt(0) === "<";
   let vb;
   let elements;
+  let textElements = [];
   if (isSvgMarkup) {
     const parsed = parseSvgMarkup(data);
     vb = options?.viewBox ?? parsed.viewBox ?? [0, 0, w, h];
     elements = parsed.elements;
+    textElements = parsed.textElements;
   } else {
     vb = options?.viewBox ?? [0, 0, w, h];
     elements = [{ pathData: data }];
   }
-  if (elements.length === 0 || vb[2] <= 0 || vb[3] <= 0) return "";
+  if (elements.length === 0 && textElements.length === 0 || vb[2] <= 0 || vb[3] <= 0) return "";
   const sx = w / vb[2];
   const sy = h / vb[3];
-  const cmOp = `${fn(sx)} 0 0 ${fn(-sy)} ${fn(x - vb[0] * sx)} ${fn(y + vb[1] * sy)} cm`;
+  const tx2 = x - vb[0] * sx;
+  const ty = y + vb[1] * sy;
+  const cmOp = `${fn(sx)} 0 0 ${fn(-sy)} ${fn(tx2)} ${fn(ty)} cm`;
   const defaultFill = resolveColor(options?.fill, "0 0 0");
   const defaultStroke = resolveColor(options?.stroke, null);
   const defaultSw = options?.strokeWidth ?? 1;
-  const allOps = ["q", cmOp];
+  const shapeOps = [];
   for (const elem of elements) {
     const segments = parseSvgPath(elem.pathData);
     if (segments.length === 0) continue;
     const fillRgb = resolveColor(elem.fill, defaultFill);
     const strokeRgb = resolveColor(elem.stroke, defaultStroke);
     const sw = elem.strokeWidth ?? defaultSw;
-    allOps.push(buildPathOps(segments, fillRgb, strokeRgb, sw));
-  }
-  allOps.push("Q");
+    shapeOps.push(buildPathOps(segments, fillRgb, strokeRgb, sw));
+  }
+  const textOps = [];
+  if (enc && textElements.length > 0) {
+    for (const t of textElements) {
+      const szPdf = t.fontSize * sy;
+      if (szPdf <= 0 || !t.text) continue;
+      const pdfBaseX = t.x * sx + tx2;
+      const pdfBaseY = -sy * t.y + ty;
+      const width = enc.tw(t.text, szPdf);
+      const anchorOffset = t.anchor === "middle" ? width / 2 : t.anchor === "end" ? width : 0;
+      const pdfX = pdfBaseX - anchorOffset;
+      const fillRgb = resolveColor(t.fill, "0 0 0");
+      textOps.push("q");
+      if (fillRgb) textOps.push(`${fillRgb} rg`);
+      textOps.push(txt(t.text, pdfX, pdfBaseY, enc.f1, szPdf, enc));
+      textOps.push("Q");
+    }
+  }
+  if (shapeOps.length === 0 && textOps.length === 0) return "";
+  const allOps = [];
+  if (shapeOps.length > 0) {
+    allOps.push("q", cmOp, ...shapeOps, "Q");
+  }
+  allOps.push(...textOps);
   return allOps.join("\n");
 }
 
@@ -11378,7 +11585,7 @@ function planTable(block, enc, mgL, cw) {
     headerLines.push(lines);
     if (lines.length > headerMaxLines) headerMaxLines = lines.length;
   }
-  const headerHeight = headerMaxLines === 1 ? TH_H : Math.max(TH_H, headerMaxLines * fs.th * TABLE_LINE_HEIGHT + CELL_PAD_BOTTOM + 2);
+  const headerHeight = headerMaxLines === 1 ? TH_H : Math.max(TH_H, headerMaxLines * fs.th * TABLE_LINE_HEIGHT + pad + 2);
   const rowLines = [];
   const rowHeights = [];
   for (let r = 0; r < block.rows.length; r++) {
@@ -11391,7 +11598,7 @@ function planTable(block, enc, mgL, cw) {
       if (lines.length > maxLines) maxLines = lines.length;
     }
     rowLines.push(cells);
-    const h = maxLines === 1 ? minRowH : Math.max(minRowH, maxLines * fs.td * TABLE_LINE_HEIGHT + CELL_PAD_BOTTOM + 2);
+    const h = maxLines === 1 ? minRowH : Math.max(minRowH, maxLines * fs.td * TABLE_LINE_HEIGHT + pad + 2);
     rowHeights.push(h);
   }
   const captionLines = block.caption ? wrapText(block.caption, cw, CAPTION_FONT_SIZE, enc) : [];
@@ -11817,7 +12024,7 @@ function renderBarcodeBlock(block, y, mgL, cw, tagCtx, documentChildren) {
   y = by - 6;
   return { ops, y };
 }
-function renderSvgBlock(block, y, mgL, cw, tagCtx, documentChildren) {
+function renderSvgBlock(block, y, mgL, cw, tagCtx, documentChildren, enc) {
   const ops = [];
   const w = block.width ?? DEFAULT_SVG_SIZE;
   const h = block.height ?? DEFAULT_SVG_SIZE;
@@ -11833,7 +12040,7 @@ function renderSvgBlock(block, y, mgL, cw, tagCtx, documentChildren) {
     stroke: block.stroke,
     strokeWidth: block.strokeWidth,
     viewBox: block.viewBox
-  });
+  }, enc);
   if (svgOps) {
     if (tagCtx?.tagged) {
       const mcid = tagCtx.mcidAlloc.next(tagCtx.pageObjNum);
@@ -12015,6 +12222,7 @@ function assembleDocumentParts(params, layoutOptions) {
   if (watermarkOpts) {
     validateWatermark(watermarkOpts, layout?.tagged);
   }
+  const debugOpts = resolveDebugOptions(layout?.debug);
   const attachments = layout?.attachments;
   validateAttachments(attachments, layout?.tagged);
   const mcidAlloc = tagged ? createMCIDAllocator() : void 0;
@@ -12202,6 +12410,10 @@ function assembleDocumentParts(params, layoutOptions) {
     const tagCtx = tagged && mcidAlloc ? { tagged: true, mcidAlloc, pageObjNum} : void 0;
     const ops = [];
     let y = pgH - mg.t;
+    const debugOps = [];
+    if (debugOpts?.showMargins) {
+      debugOps.push(marginBoxOps(pgW, pgH, mg, FT_H));
+    }
     if (headerTpl) {
       const hOps = renderPageTemplate(
         headerTpl,
@@ -12242,6 +12454,7 @@ function assembleDocumentParts(params, layoutOptions) {
     }
     const blocks = pageBlocks[p] ?? [];
     for (const block of blocks) {
+      const yBefore = debugOpts ? y : 0;
       switch (block.type) {
         case "heading": {
           if (headingDestIdx < headingDests.length) {
@@ -12322,7 +12535,7 @@ function assembleDocumentParts(params, layoutOptions) {
           break;
         }
         case "svg": {
-          const result = renderSvgBlock(block, y, mg.l, cw, tagCtx, documentChildren);
+          const result = renderSvgBlock(block, y, mg.l, cw, tagCtx, documentChildren, enc);
           ops.push(...result.ops);
           y = result.y;
           break;
@@ -12334,6 +12547,19 @@ function assembleDocumentParts(params, layoutOptions) {
           break;
         }
       }
+      if (debugOpts) {
+        if (debugOpts.showContentBounds) {
+          const bo = blockBoundsOps(mg.l, cw, yBefore, y);
+          if (bo) debugOps.push(bo);
+        }
+        if (debugOpts.showCells) {
+          if (block.type === "__tableSlice") {
+            debugOps.push(tableCellOps(block.slice.plan, block.slice, yBefore));
+          } else if (block.type === "table") {
+            debugOps.push(tableCellOps(planTable(block, enc, mg.l, cw), void 0, yBefore));
+          }
+        }
+      }
     }
     if (wmState?.foregroundOps) {
       ops.push(wmState.foregroundOps);
@@ -12354,6 +12580,9 @@ function assembleDocumentParts(params, layoutOptions) {
       documentChildren
     );
     ops.push(...ftOps);
+    if (debugOps.length > 0) {
+      ops.push(...debugOps);
+    }
     pageStreams.push(ops.join("\n"));
   }
   const annotsByPage = /* @__PURE__ */ new Map();
@@ -12951,6 +13180,173 @@ function autoOutlineFromHeadings(headings) {
   return root;
 }
 
+// src/core/pdf-layout-inspect.ts
+var TITLE_BAND_H = 22 + 12;
+function inspectDocumentLayout(params, layoutOptions) {
+  if (!params || typeof params !== "object" || !Array.isArray(params.blocks)) {
+    throw new Error("inspectDocumentLayout: params.blocks must be an array");
+  }
+  const layout = layoutOptions ?? params.layout;
+  const pgW = layout?.pageWidth ?? PG_W;
+  const pgH = layout?.pageHeight ?? PG_H;
+  const mg = layout?.margins ?? { ...DEFAULT_MARGINS };
+  const cw = pgW - mg.l - mg.r;
+  const fontEntries = params.fontEntries ? [...params.fontEntries] : [];
+  const tagged = resolvePdfAConfig(layout?.tagged).enabled;
+  const enc = createEncodingContext(fontEntries, tagged, layout?.normalize ?? false);
+  const headerH = layout?.headerTemplate ? HEADER_H : 0;
+  const availableH = pgH - mg.t - mg.b - FT_H - headerH;
+  const pages = [[]];
+  let remainH = availableH;
+  let curY = pgH - mg.t - headerH;
+  if (params.title) {
+    remainH -= TITLE_BAND_H;
+    curY -= TITLE_BAND_H;
+  }
+  const newPage = () => {
+    pages.push([]);
+    remainH = availableH;
+    curY = pgH - mg.t - headerH;
+  };
+  for (const block of params.blocks) {
+    if (block.type === "pageBreak") {
+      newPage();
+      continue;
+    }
+    if (block.type === "table") {
+      const plan = planTable(block, enc, mg.l, cw);
+      const repeatHeader = block.repeatHeader !== false;
+      const totalRows = block.rows.length;
+      if (totalRows === 0) {
+        const totalH = plan.captionHeight + plan.headerHeight + plan.trailerSpacing;
+        if (totalH > remainH && pages[pages.length - 1].length > 0) newPage();
+        pages[pages.length - 1].push({ type: "table", page: pages.length - 1, x: mg.l, top: curY, width: cw, height: totalH });
+        remainH -= totalH;
+        curY -= totalH;
+        continue;
+      }
+      let rowIdx = 0;
+      let isFirstSlice = true;
+      while (rowIdx < totalRows) {
+        const drawCaption = isFirstSlice;
+        const drawHeader = isFirstSlice || repeatHeader;
+        const tCapH = drawCaption ? plan.captionHeight : 0;
+        const tHdrH = drawHeader ? plan.headerHeight : 0;
+        const availableForRows = remainH - tCapH - tHdrH - plan.trailerSpacing;
+        let usedH = 0;
+        let count = 0;
+        while (rowIdx + count < totalRows && usedH + plan.rowHeights[rowIdx + count] <= availableForRows) {
+          usedH += plan.rowHeights[rowIdx + count];
+          count++;
+        }
+        if (count === 0 && pages[pages.length - 1].length > 0) {
+          newPage();
+          continue;
+        }
+        if (count === 0) count = 1;
+        rowIdx += count;
+        const isFinalSlice = rowIdx >= totalRows;
+        const sliceH = tCapH + tHdrH + usedH + (isFinalSlice ? plan.trailerSpacing : 0);
+        pages[pages.length - 1].push({ type: "table", page: pages.length - 1, x: mg.l, top: curY, width: cw, height: sliceH });
+        remainH -= sliceH;
+        curY -= sliceH;
+        isFirstSlice = false;
+        if (!isFinalSlice) newPage();
+      }
+      continue;
+    }
+    const blockH = estimateBlockHeight(block, enc, cw);
+    if (blockH > remainH && pages[pages.length - 1].length > 0) newPage();
+    pages[pages.length - 1].push({ type: block.type, page: pages.length - 1, x: mg.l, top: curY, width: cw, height: blockH });
+    remainH -= blockH;
+    curY -= blockH;
+  }
+  const inspectedPages = pages.map((blocks, index) => ({ index, blocks }));
+  return {
+    pageWidth: pgW,
+    pageHeight: pgH,
+    margins: { t: mg.t, r: mg.r, b: mg.b, l: mg.l },
+    totalPages: Math.max(1, pages.length),
+    pages: inspectedPages
+  };
+}
+
+// src/core/pdf-annot-markup.ts
+var SUBTYPE = {
+  text: "Text",
+  highlight: "Highlight",
+  underline: "Underline",
+  strikeout: "StrikeOut",
+  squiggly: "Squiggly",
+  square: "Square",
+  circle: "Circle",
+  line: "Line",
+  freetext: "FreeText"
+};
+function rectStr(r) {
+  return `[${fmtNum(r[0])} ${fmtNum(r[1])} ${fmtNum(r[2])} ${fmtNum(r[3])}]`;
+}
+function quadFromRect(r) {
+  const [x1, y1, x2, y2] = r;
+  return [x1, y2, x2, y2, x1, y1, x2, y1];
+}
+function commonEntries(a) {
+  const parts = [];
+  if (a.contents !== void 0) parts.push(`/Contents ${encodePdfTextString(a.contents)}`);
+  if (a.title !== void 0) parts.push(`/T ${encodePdfTextString(a.title)}`);
+  if (a.color !== void 0) parts.push(`/C [${parseColor(a.color)}]`);
+  if (a.opacity !== void 0) parts.push(`/CA ${fmtNum(a.opacity)}`);
+  if (a.modified !== void 0) parts.push(`/M ${encodePdfTextString(a.modified)}`);
+  parts.push(`/F ${a.flags ?? 4}`);
+  return parts.join(" ");
+}
+function buildAnnotation(annot, objNum) {
+  return `${objNum} 0 obj
+${buildAnnotationBody(annot)}
+endobj`;
+}
+function buildAnnotationBody(annot) {
+  const entries = [
+    `/Type /Annot`,
+    `/Subtype /${SUBTYPE[annot.type]}`,
+    `/Rect ${rectStr(annot.rect)}`,
+    commonEntries(annot)
+  ];
+  switch (annot.type) {
+    case "text": {
+      if (annot.open !== void 0) entries.push(`/Open ${annot.open ? "true" : "false"}`);
+      if (annot.icon !== void 0) entries.push(`/Name /${annot.icon}`);
+      break;
+    }
+    case "highlight":
+    case "underline":
+    case "strikeout":
+    case "squiggly": {
+      const quad = annot.quadPoints && annot.quadPoints.length >= 8 ? annot.quadPoints : quadFromRect(annot.rect);
+      entries.push(`/QuadPoints [${quad.map(fmtNum).join(" ")}]`);
+      break;
+    }
+    case "square":
+    case "circle": {
+      if (annot.interiorColor !== void 0) entries.push(`/IC [${parseColor(annot.interiorColor)}]`);
+      entries.push(`/BS << /W ${fmtNum(annot.borderWidth ?? 1)} >>`);
+      break;
+    }
+    case "line": {
+      entries.push(`/L [${fmtNum(annot.start[0])} ${fmtNum(annot.start[1])} ${fmtNum(annot.end[0])} ${fmtNum(annot.end[1])}]`);
+      entries.push(`/BS << /W ${fmtNum(annot.borderWidth ?? 1)} >>`);
+      break;
+    }
+    case "freetext": {
+      const sz = annot.fontSize ?? 12;
+      const col = annot.color !== void 0 ? parseColor(annot.color) : "0 0 0";
+      entries.push(`/DA (/Helv ${fmtNum(sz)} Tf ${col} rg)`);
+      break;
+    }
+  }
+  return `<< ${entries.filter(Boolean).join(" ")} >>`;
+}
+
 // src/core/pdf-signature.ts
 init_sha();
 
@@ -14298,6 +14694,28 @@ function openPdf(bytes) {
     if (!entry || entry.type === 0) return null;
     return resolveRef({ num, gen: entry.gen });
   }
+  let _pageRefs;
+  function collectPageRefs() {
+    if (_pageRefs) return _pageRefs;
+    const catalog = getCatalog();
+    const refs = [];
+    const walk = (nodeVal, depth) => {
+      if (depth > 100) return;
+      const node = resolveValue2(nodeVal);
+      if (!isDict(node)) return;
+      if (dictGetName(node, "Type") === "Page") {
+        if (isRef(nodeVal)) refs.push(nodeVal);
+        return;
+      }
+      const kids = node.get("Kids");
+      if (isArray(kids)) {
+        for (const k of kids) walk(k, depth + 1);
+      }
+    };
+    walk(catalog.get("Pages") ?? null, 0);
+    _pageRefs = refs;
+    return refs;
+  }
   function decodeStreamData(stream) {
     let data = stream.data;
     const filterName = dictGetName(stream.dict, "Filter");
@@ -14349,10 +14767,107 @@ function openPdf(bytes) {
       const info = resolveValue2(infoRef);
       return isDict(info) ? info : null;
     },
+    getPageLabels() {
+      const catalog = getCatalog();
+      const plVal = resolveValue2(catalog.get("PageLabels") ?? null);
+      if (!isDict(plVal)) return null;
+      const entries = /* @__PURE__ */ new Map();
+      collectNumberTree(plVal, resolveValue2, entries);
+      if (entries.size === 0) return null;
+      const ranges = [];
+      for (const startPage of [...entries.keys()].sort((a, b) => a - b)) {
+        const dict = resolveValue2(entries.get(startPage) ?? null);
+        if (!isDict(dict)) continue;
+        const range = { startPage };
+        const sOp = dictGetName(dict, "S");
+        range.style = sOp === void 0 ? "none" : STYLE_FROM_OP[sOp] ?? "none";
+        const prefix = dict.get("P");
+        if (typeof prefix === "string") range.prefix = prefix;
+        const start = dictGetNum(dict, "St");
+        if (start !== void 0) range.start = start;
+        ranges.push(range);
+      }
+      return ranges.length > 0 ? ranges : null;
+    },
+    getAnnotations(pageIndex) {
+      const pages = collectPages();
+      if (pageIndex < 0 || pageIndex >= pages.length) return [];
+      const annotsVal = resolveValue2(pages[pageIndex].get("Annots") ?? null);
+      if (!isArray(annotsVal)) return [];
+      const out = [];
+      for (const a of annotsVal) {
+        const d = resolveValue2(a);
+        if (!isDict(d)) continue;
+        const subtype = dictGetName(d, "Subtype") ?? "";
+        const rectVal = resolveValue2(d.get("Rect") ?? null);
+        let rect = null;
+        if (isArray(rectVal) && rectVal.length === 4 && rectVal.every((n2) => typeof n2 === "number")) {
+          rect = [rectVal[0], rectVal[1], rectVal[2], rectVal[3]];
+        }
+        const parsed = { subtype, rect };
+        const contents = d.get("Contents");
+        if (typeof contents === "string") parsed.contents = decodePdfTextString(contents);
+        const title = d.get("T");
+        if (typeof title === "string") parsed.title = decodePdfTextString(title);
+        const c = resolveValue2(d.get("C") ?? null);
+        if (isArray(c)) {
+          const nums = c.filter((x) => typeof x === "number");
+          if (nums.length > 0) parsed.color = nums;
+        }
+        const qp = resolveValue2(d.get("QuadPoints") ?? null);
+        if (isArray(qp)) {
+          parsed.quadPoints = qp.filter((x) => typeof x === "number");
+        }
+        const action = resolveValue2(d.get("A") ?? null);
+        if (isDict(action)) {
+          const uri = action.get("URI");
+          if (typeof uri === "string") parsed.url = uri;
+        }
+        out.push(parsed);
+      }
+      return out;
+    },
+    getPageRef(pageIndex) {
+      const refs = collectPageRefs();
+      return pageIndex >= 0 && pageIndex < refs.length ? refs[pageIndex] : null;
+    },
     decodeStream: decodeStreamData,
     getObject
   };
 }
+function decodePdfTextString(raw) {
+  if (raw.length >= 2 && raw.charCodeAt(0) === 254 && raw.charCodeAt(1) === 255) {
+    let out = "";
+    for (let i = 2; i + 1 < raw.length; i += 2) {
+      out += String.fromCharCode(raw.charCodeAt(i) << 8 | raw.charCodeAt(i + 1));
+    }
+    return out;
+  }
+  return raw;
+}
+var STYLE_FROM_OP = {
+  D: "decimal",
+  r: "roman",
+  R: "Roman",
+  a: "alpha",
+  A: "Alpha"
+};
+function collectNumberTree(node, resolve, out) {
+  const nums = resolve(node.get("Nums") ?? null);
+  if (isArray(nums)) {
+    for (let i = 0; i + 1 < nums.length; i += 2) {
+      const key = resolve(nums[i]);
+      if (typeof key === "number") out.set(key, nums[i + 1]);
+    }
+  }
+  const kids = resolve(node.get("Kids") ?? null);
+  if (isArray(kids)) {
+    for (const kid of kids) {
+      const kd = resolve(kid);
+      if (isDict(kd)) collectNumberTree(kd, resolve, out);
+    }
+  }
+}
 function flattenPageTree(node, resolve, pages) {
   const type = dictGetName(node, "Type");
   if (type === "Page") {
@@ -14487,6 +15002,21 @@ function createModifier(reader) {
     if (modified.has(num)) return modified.get(num) ?? null;
     return reader.getObject(num);
   }
+  function addAnnotation(pageIndex, annotationBody) {
+    const pageRef = reader.getPageRef(pageIndex);
+    if (!pageRef) throw new Error(`addAnnotation: no page at index ${pageIndex}`);
+    const objNum = addRawObject(annotationBody);
+    const page = getObject(pageRef.num);
+    if (!isDict(page)) throw new Error(`addAnnotation: page ${pageIndex} is not a dictionary`);
+    const clone = new Map(page);
+    const existing = clone.get("Annots");
+    const resolved = isRef(existing) ? reader.resolveValue(existing) : existing;
+    const annots = isArray(resolved) ? [...resolved] : [];
+    annots.push({ type: "ref", num: objNum, gen: 0 });
+    clone.set("Annots", annots);
+    setObject(pageRef.num, clone);
+    return objNum;
+  }
   function save() {
     if (modified.size === 0) {
       return reader.bytes;
@@ -14532,6 +15062,7 @@ ${xrefOffset}
     setObject,
     addObject,
     addRawObject,
+    addAnnotation,
     getObject,
     save,
     get nextObjNum() {
@@ -16145,6 +16676,6 @@ async function createPDF(pdfParams, options) {
   return generatePDFMainThread(pdfParams, options?.layoutOptions);
 }
 
-export { BAL_H, DEFAULT_COLORS, DEFAULT_COLUMNS, DEFAULT_CW, DEFAULT_FONT_SIZES, DEFAULT_MARGINS, DEFAULT_MAX_BLOCKS, DEFAULT_MAX_INFLATE_OUTPUT, FT_H, HEADER_H, INFO_LN, KNOWN_DECODE_FILTERS, MAX_PARSE_DEPTH, MAX_XREF_CHAIN, PAGE_SIZES, PDF_A_CONFORMANCE_TARGETS, PG_H, PG_W, ROW_H, TH_H, TITLE_LN, WORKER_THRESHOLD, WORKER_TIMEOUT_MS, addSignaturePlaceholder, applyDecodeFilter, buildAcroFormDict, buildAppearanceStreamDict, buildCmsSignedData, buildDocumentPDF, buildDocumentPDFBytes, buildDocumentPDFStream, buildDocumentPDFStreamPageByPage, buildDocumentPDFStreamTrue, buildEmbeddedFiles, buildFormWidget, buildImageOperators, buildImageXObject, buildInternalLinkAnnotation, buildLinkAnnotation, buildPDF, buildPDFBytes, buildPDFStream, buildPDFStreamPageByPage, buildPDFStreamTrue, buildRadioGroupParent, buildSMaskXObject, buildSigDict, buildWatermarkState, chunkBinaryString, classifyClusters, classifyUseCategory, clearFontCache, computeColumnPositions, concatChunks, containsArabic, containsBengali, containsDevanagari, containsEthiopic, containsHebrew, containsKhmer, containsMyanmar, containsRTL, containsSinhala, containsTamil, containsTelugu, containsThai, containsTibetan, contoursToPath, createEncodingContext, createModifier, createPDF, createTokenizer, decodeASCII85, decodeASCIIHex, decodeEcPublicKey, decodeLZW, decodeRunLength, defaultFieldHeight, derBitString, derDecode, derInteger, derOctetString, derOid, derSequence, detectCharLang, detectFallbackLangs, detectImageFormat, dictGet, dictGetArray, dictGetDict, dictGetName, dictGetNum, dictGetRef, downloadBlob, ean13CheckDigit, ecPublicKeyFromPrivate, ecdsaSign, ecdsaVerify, encodeCode128, encodeEcPublicKey, encodePDF417, encodePdfTextString, estimateCmsSize, estimateContentsSize, extractGlyphContours, extractPages, findStartxref, generateDataMatrix, generatePDFInWorker, generatePDFMainThread, generateQR, getCryptoProvider, getMaxInflateOutputSize, getRegisteredLangs, getTrailerRef, getTrailerValue, hasFontLoader, helveticaBoldWidth, helveticaWidth, hmacSha256, inflateSync, initCrypto, initNodeCompression, initNodeDecompression as initNodeDecompression_parser, isArmenianCodepoint, isArray, isBengaliCodepoint, isCyrillicCodepoint, isDevanagariCodepoint, isDict, isEthiopicCodepoint, isGeorgianCodepoint, isKhmerCodepoint, isLinkAnnotation, isMyanmarCodepoint, isName, isRef, isSelfSigned, isSinhalaCodepoint, isStream, isTamilCodepoint, isTeluguCodepoint, isTibetanCodepoint, isValidPdfRgb, loadFontData, mergePdfs, nameValue, needsUnicodeFont, normalizeBidiEmbeddings, normalizeColors, openPdf, parseCertificate, parseColor, parseColrCpal, parseCpal, parseGlyfFont, parseImage, parseIndirectObject, parseJPEG, parsePNG, parseRsaPrivateKey, parseRsaPublicKey, parseSvgPath, parseValue, parseXrefTable, pdfString, registerFont, registerFonts, renderBarcode, renderCode128, renderColorGlyph, renderDataMatrix, renderEAN13, renderPDF417, renderQR, renderSvg, resetFontRegistry, resolveBidiRuns, resolveLayout, resolvePdfAConfig, resolveTemplate, rsaSign, rsaSignHash, rsaVerify, rsaVerifyHash, setCryptoProvider, setDeflateImpl, setInflateImpl, setMaxInflateOutputSize, sha384, sha512, shapeArabicText, shapeBengaliText, shapeDevanagariText, shapeKhmerText, shapeMyanmarText, shapeSinhalaText, shapeTamilText, shapeTeluguText, shapeThaiText, shapeTibetanText, signPdfBytes, slugify, splitPdf, splitTextByFont, streamByteLength, streamToFile, stripBidiControls, toBytes, toWinAnsi, truncate, truncateToWidth, validateAttachments, validateDocumentStreamable, validateFontData, validatePdfUA, validateTableStreamable, validateURL, validateWatermark, verifyCertSignature, wrapText };
+export { BAL_H, DEFAULT_COLORS, DEFAULT_COLUMNS, DEFAULT_CW, DEFAULT_FONT_SIZES, DEFAULT_MARGINS, DEFAULT_MAX_BLOCKS, DEFAULT_MAX_INFLATE_OUTPUT, FT_H, HEADER_H, INFO_LN, KNOWN_DECODE_FILTERS, MAX_PARSE_DEPTH, MAX_XREF_CHAIN, PAGE_SIZES, PDF_A_CONFORMANCE_TARGETS, PG_H, PG_W, ROW_H, TH_H, TITLE_LN, WORKER_THRESHOLD, WORKER_TIMEOUT_MS, addSignaturePlaceholder, applyDecodeFilter, buildAcroFormDict, buildAnnotation, buildAnnotationBody, buildAppearanceStreamDict, buildCmsSignedData, buildDocumentPDF, buildDocumentPDFBytes, buildDocumentPDFStream, buildDocumentPDFStreamPageByPage, buildDocumentPDFStreamTrue, buildEmbeddedFiles, buildFormWidget, buildImageOperators, buildImageXObject, buildInternalLinkAnnotation, buildLinkAnnotation, buildPDF, buildPDFBytes, buildPDFStream, buildPDFStreamPageByPage, buildPDFStreamTrue, buildRadioGroupParent, buildSMaskXObject, buildSigDict, buildWatermarkState, chunkBinaryString, classifyClusters, classifyUseCategory, clearFontCache, computeColumnPositions, concatChunks, containsArabic, containsBengali, containsDevanagari, containsEthiopic, containsHebrew, containsKhmer, containsMath, containsMyanmar, containsRTL, containsSinhala, containsTamil, containsTelugu, containsThai, containsTibetan, contoursToPath, createEncodingContext, createModifier, createPDF, createTokenizer, decodeASCII85, decodeASCIIHex, decodeEcPublicKey, decodeLZW, decodeRunLength, defaultFieldHeight, derBitString, derDecode, derInteger, derOctetString, derOid, derSequence, detectCharLang, detectFallbackLangs, detectImageFormat, dictGet, dictGetArray, dictGetDict, dictGetName, dictGetNum, dictGetRef, downloadBlob, ean13CheckDigit, ecPublicKeyFromPrivate, ecdsaSign, ecdsaVerify, encodeCode128, encodeEcPublicKey, encodePDF417, encodePdfTextString, estimateCmsSize, estimateContentsSize, extractGlyphContours, extractPages, findStartxref, generateDataMatrix, generatePDFInWorker, generatePDFMainThread, generateQR, getCryptoProvider, getMaxInflateOutputSize, getRegisteredLangs, getTrailerRef, getTrailerValue, hasFontLoader, helveticaBoldWidth, helveticaWidth, hmacSha256, inflateSync, initCrypto, initNodeCompression, initNodeDecompression as initNodeDecompression_parser, inspectDocumentLayout, isArmenianCodepoint, isArray, isBengaliCodepoint, isCyrillicCodepoint, isDevanagariCodepoint, isDict, isEthiopicCodepoint, isGeorgianCodepoint, isKhmerCodepoint, isLinkAnnotation, isMathCodepoint, isMyanmarCodepoint, isName, isRef, isSelfSigned, isSinhalaCodepoint, isStream, isTamilCodepoint, isTeluguCodepoint, isTibetanCodepoint, isValidPdfRgb, loadFontData, mergePdfs, nameValue, needsUnicodeFont, normalizeBidiEmbeddings, normalizeColors, openPdf, parseCertificate, parseColor, parseColrCpal, parseCpal, parseGlyfFont, parseImage, parseIndirectObject, parseJPEG, parsePNG, parseRsaPrivateKey, parseRsaPublicKey, parseSvgPath, parseValue, parseXrefTable, pdfString, registerFont, registerFonts, renderBarcode, renderCode128, renderColorGlyph, renderDataMatrix, renderEAN13, renderPDF417, renderQR, renderSvg, resetFontRegistry, resolveBidiRuns, resolveLayout, resolvePdfAConfig, resolveTemplate, rsaSign, rsaSignHash, rsaVerify, rsaVerifyHash, setCryptoProvider, setDeflateImpl, setInflateImpl, setMaxInflateOutputSize, sha384, sha512, shapeArabicText, shapeBengaliText, shapeDevanagariText, shapeKhmerText, shapeMyanmarText, shapeSinhalaText, shapeTamilText, shapeTeluguText, shapeThaiText, shapeTibetanText, signPdfBytes, slugify, splitPdf, splitTextByFont, streamByteLength, streamToFile, stripBidiControls, toBytes, toWinAnsi, truncate, truncateToWidth, validateAttachments, validateDocumentStreamable, validateFontData, validatePdfUA, validateTableStreamable, validateURL, validateWatermark, verifyCertSignature, wrapText };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map