jspdf-utils 0.1.6 → 0.1.8

package/dist/html-to-pdf.d.ts

@@ -58,7 +58,11 @@ declare function splitOversizedTables(container: HTMLElement, pageContentPx: num
  * into word-boundary chunks using binary search.
  */
 declare function splitOversizedText(container: HTMLElement, pageContentPx: number): void;
-/** Insert spacer divs so that no direct child straddles a page boundary. */
+/**
+ * Insert spacer divs so that no direct child straddles a page boundary.
+ * For tables and text elements, attempts to split at the boundary first
+ * so content fills the current page before flowing to the next.
+ */
 declare function insertPageBreakSpacers(container: HTMLElement, pageContentPx: number): void;
 /**
  * Prepare an HTML element for doc.html() rendering.
@@ -70,15 +74,79 @@ declare function prepare(source: HTMLElement, opts?: Partial<PageOptions>): Prep
 /**
  * Render an HTML element to PDF using doc.html().
  */
-declare function renderHTML(doc: jsPDF, source: HTMLElement, opts?: Partial<PageOptions>): Promise<jsPDF>;
+declare function renderHTML(doc: jsPDF, source: HTMLElement, opts?: Partial<PageOptions> & Pick<ImagePDFOptions, "marginContent">): Promise<jsPDF>;
+type MarginFactory = (page: number, totalPages: number) => HTMLElement;
+export interface ContentBorder {
+    /** Stroke color (default: "#000000") */
+    color?: string;
+    /** Line width in mm (default: 0.3) */
+    width?: number;
+    /** Distance in mm from the page edge to the border (default: uses page margins). */
+    margin?: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+}
+export interface TextBorder {
+    /** The text to repeat along all four edges. */
+    text: string;
+    /** Text color (default: "#000000") */
+    color?: string;
+    /** Font size in mm (default: 2.5) */
+    fontSize?: number;
+    /** Font family (default: "Arial, sans-serif") */
+    fontFamily?: string;
+    /** Gap between repetitions in mm (default: fontSize * 0.5) */
+    gap?: number;
+    /** Distance in mm from the page edge to the text border (default: uses page margins). */
+    margin?: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+}
+export interface MarginContentInput {
+    top?: HTMLElement | MarginFactory;
+    right?: HTMLElement | MarginFactory;
+    bottom?: HTMLElement | MarginFactory;
+    left?: HTMLElement | MarginFactory;
+    /** Draw a rectangle border around the content area. */
+    contentBorder?: ContentBorder;
+    /** Draw a repeated-text border around the content area. */
+    textBorder?: TextBorder;
+}
 export interface ImagePDFOptions {
     imageFormat?: "JPEG" | "PNG";
     imageQuality?: number;
     scale?: number;
+    marginContent?: MarginContentInput;
 }
 /**
  * Render an HTML element as an image-based PDF. Each page is a rasterized
  * screenshot — no selectable or extractable text in the output.
  */
 declare function renderImagePDF(source: HTMLElement, opts?: Partial<PageOptions> & ImagePDFOptions): Promise<jsPDF>;
-export { PAGE_SIZES, PAGE_MARGINS, computeLayout, createPrintClone, normalizeTableAttributes, splitOversizedTables, splitOversizedText, insertPageBreakSpacers, prepare, renderHTML, renderImagePDF, };
+/**
+ * Render an HTML element to an array of page images (data URLs).
+ * Each image represents a full page with margins, matching the
+ * visual output of renderImagePDF.
+ */
+declare function renderPageImages(source: HTMLElement, opts?: Partial<PageOptions> & ImagePDFOptions): Promise<string[]>;
+/**
+ * Render an HTML element as page images and inject them into a scrollable
+ * container. Each image is sized to match the page format dimensions.
+ */
+declare function previewPageImages(source: HTMLElement, container: HTMLElement, opts?: Partial<PageOptions> & ImagePDFOptions): Promise<void>;
+/**
+ * Add HTML content to the margin areas of each page in a jsPDF document.
+ *
+ * Each slot (top, right, bottom, left) accepts either a static HTMLElement
+ * (rendered once and reused on every page) or a factory function that
+ * receives `(page, totalPages)` and returns an HTMLElement per page
+ * (useful for page numbers or dynamic content).
+ */
+declare function addMarginContent(doc: jsPDF, content: MarginContentInput, opts?: Partial<PageOptions>): Promise<jsPDF>;
+export { PAGE_SIZES, PAGE_MARGINS, computeLayout, createPrintClone, normalizeTableAttributes, splitOversizedTables, splitOversizedText, insertPageBreakSpacers, prepare, renderHTML, renderImagePDF, renderPageImages, previewPageImages, addMarginContent, };

package/dist/html-to-pdf.js

@@ -1,5 +1,5 @@
-import j from "html2canvas";
-const T = {
+import W from "html2canvas";
+const q = {
   a0: [841, 1189],
   a1: [594, 841],
   a2: [420, 594],
@@ -10,7 +10,7 @@ const T = {
   letter: [215.9, 279.4],
   legal: [215.9, 355.6],
   tabloid: [279.4, 431.8]
-}, B = {
+}, $ = {
   a0: 40,
   a1: 35,
   a2: 30,
@@ -22,211 +22,508 @@ const T = {
   legal: 25.4,
   tabloid: 25
 };
-function v(i = {}) {
-  const n = i.format ?? "a4", [o, e] = T[n], a = i.pageWidth ?? o, t = i.pageHeight ?? e, s = B[n], r = {
+function M(t = {}) {
+  const e = t.format ?? "a4", [a, n] = q[e], i = t.pageWidth ?? a, o = t.pageHeight ?? n, s = $[e], r = {
     top: s,
     right: s,
     bottom: s,
     left: s
   };
   return {
-    unit: i.unit ?? "mm",
-    format: n,
-    pageWidth: a,
-    pageHeight: t,
-    margin: { ...r, ...i.margin }
+    unit: t.unit ?? "mm",
+    format: e,
+    pageWidth: i,
+    pageHeight: o,
+    margin: { ...r, ...t.margin }
   };
 }
-function x(i, n) {
-  const o = i.offsetWidth, e = n.pageWidth - n.margin.left - n.margin.right, a = e / o, s = (n.pageHeight - n.margin.top - n.margin.bottom) / a;
-  return { renderedWidth: o, scale: a, contentWidthMm: e, pageContentPx: s };
+function x(t, e) {
+  const a = t.offsetWidth, n = e.pageWidth - e.margin.left - e.margin.right, i = n / a, s = (e.pageHeight - e.margin.top - e.margin.bottom) / i;
+  return { renderedWidth: a, scale: i, contentWidthMm: n, pageContentPx: s };
 }
-function A(i, n = 210) {
-  const o = i.cloneNode(!0);
-  return Object.assign(o.style, {
+function B(t, e = 210) {
+  const a = t.cloneNode(!0);
+  return Object.assign(a.style, {
     position: "fixed",
     top: "0",
     left: "0",
     boxSizing: "border-box",
-    width: n + "mm",
+    width: e + "mm",
     opacity: "0.000001",
     pointerEvents: "none"
-  }), document.body.appendChild(o), o;
-}
-function C() {
-  const i = document.createElement("style");
-  return i.setAttribute("data-jspdf-utils", ""), i.textContent = "img { display: inline !important; }", document.head.appendChild(i), () => i.remove();
-}
-function W(i) {
-  for (const n of i.querySelectorAll("table")) {
-    const o = n.getAttribute("cellpadding");
-    if (o) {
-      for (const e of n.querySelectorAll("th, td"))
-        e.style.padding || (e.style.padding = o + "px");
-      n.removeAttribute("cellpadding");
+  }), document.body.appendChild(a), a;
+}
+function N() {
+  const t = document.createElement("style");
+  return t.setAttribute("data-jspdf-utils", ""), t.textContent = "img { display: inline !important; }", document.head.appendChild(t), () => t.remove();
+}
+function E(t) {
+  for (const e of t.querySelectorAll("table")) {
+    const a = e.getAttribute("cellpadding");
+    if (a) {
+      for (const n of e.querySelectorAll("th, td"))
+        n.style.padding || (n.style.padding = a + "px");
+      e.removeAttribute("cellpadding");
     }
   }
 }
-function P(i, n) {
-  for (const o of Array.from(
-    i.querySelectorAll(":scope > table")
+function T(t, e) {
+  for (const a of Array.from(
+    t.querySelectorAll(":scope > table")
   )) {
-    if (o.offsetHeight <= n) continue;
-    const e = Array.from(o.rows);
-    if (e.length === 0) continue;
-    const a = e[0].querySelector("th") !== null, t = a ? e[0] : null, s = a ? e.slice(1) : e, r = t ? t.offsetHeight : 0, d = n - r - 2, f = [];
-    let g = [], l = 0;
-    for (const h of s) {
-      const c = h.offsetHeight;
-      l + c > d && g.length > 0 && (f.push(g), g = [], l = 0), g.push(h), l += c;
+    if (a.offsetHeight <= e) continue;
+    const n = Array.from(a.rows);
+    if (n.length === 0) continue;
+    const i = n[0].querySelector("th") !== null, o = i ? n[0] : null, s = i ? n.slice(1) : n, r = o ? o.offsetHeight : 0, l = e - r - 2, d = [];
+    let c = [], g = 0;
+    for (const m of s) {
+      const h = m.offsetHeight;
+      g + h > l && c.length > 0 && (d.push(c), c = [], g = 0), c.push(m), g += h;
     }
-    g.length > 0 && f.push(g);
-    for (const h of f) {
-      const c = o.cloneNode(!1);
-      t && c.appendChild(t.cloneNode(!0));
-      for (const m of h) c.appendChild(m.cloneNode(!0));
-      o.parentNode.insertBefore(c, o);
+    c.length > 0 && d.push(c);
+    for (const m of d) {
+      const h = a.cloneNode(!1);
+      o && h.appendChild(o.cloneNode(!0));
+      for (const f of m) h.appendChild(f.cloneNode(!0));
+      a.parentNode.insertBefore(h, a);
     }
-    o.remove();
+    a.remove();
   }
 }
-function S(i, n) {
-  for (const o of Array.from(i.querySelectorAll(":scope > *"))) {
-    const e = o;
-    if (e.offsetHeight <= n || e.tagName === "TABLE")
+function R(t, e) {
+  for (const a of Array.from(t.querySelectorAll(":scope > *"))) {
+    const n = a;
+    if (n.offsetHeight <= e || n.tagName === "TABLE")
       continue;
-    const a = e.tagName, t = e.getAttribute("style") || "", s = getComputedStyle(e).width, r = (e.textContent || "").split(/\s+/).filter(Boolean), d = document.createElement(a);
-    d.setAttribute("style", t), Object.assign(d.style, {
+    const i = n.tagName, o = n.getAttribute("style") || "", s = getComputedStyle(n).width, r = (n.textContent || "").split(/\s+/).filter(Boolean), l = document.createElement(i);
+    l.setAttribute("style", o), Object.assign(l.style, {
       position: "absolute",
       visibility: "hidden",
       width: s
-    }), i.appendChild(d);
-    const f = [];
-    let g = 0;
-    for (; g < r.length; ) {
-      let l = g + 1, h = r.length;
-      for (; l < h; ) {
-        const m = Math.ceil((l + h) / 2);
-        d.textContent = r.slice(g, m).join(" "), d.offsetHeight <= n ? l = m : h = m - 1;
+    }), t.appendChild(l);
+    const d = [];
+    let c = 0;
+    for (; c < r.length; ) {
+      let g = c + 1, m = r.length;
+      for (; g < m; ) {
+        const f = Math.ceil((g + m) / 2);
+        l.textContent = r.slice(c, f).join(" "), l.offsetHeight <= e ? g = f : m = f - 1;
       }
-      const c = document.createElement(a);
-      c.setAttribute("style", t), c.textContent = r.slice(g, l).join(" "), f.push(c), g = l;
+      const h = document.createElement(i);
+      h.setAttribute("style", o), h.textContent = r.slice(c, g).join(" "), d.push(h), c = g;
     }
-    d.remove();
-    for (const l of f)
-      e.parentNode.insertBefore(l, e);
-    e.remove();
-  }
-}
-function M(i, n) {
-  const o = Array.from(i.children);
-  for (const e of o) {
-    const a = e.offsetTop, t = a + e.offsetHeight, s = (Math.floor(a / n) + 1) * n;
-    if (t > s && e.offsetHeight <= n) {
-      const r = document.createElement("div");
-      r.style.height = s - a + 1 + "px", e.parentNode.insertBefore(r, e);
+    l.remove();
+    for (const g of d)
+      n.parentNode.insertBefore(g, n);
+    n.remove();
+  }
+}
+function U(t, e, a) {
+  const n = Array.from(t.rows);
+  if (n.length === 0) return !1;
+  const i = n[0].querySelector("th") !== null, o = i ? n[0] : null, s = i ? n.slice(1) : n, r = o ? o.offsetHeight : 0;
+  if (s.length < 2) return !1;
+  const l = a - r - 2;
+  if (l <= 0) return !1;
+  let d = 0, c = 0;
+  for (const h of s) {
+    if (c + h.offsetHeight > l) break;
+    c += h.offsetHeight, d++;
+  }
+  if (d === 0 || d === s.length) return !1;
+  const g = t.cloneNode(!1);
+  o && g.appendChild(o.cloneNode(!0));
+  for (let h = 0; h < d; h++)
+    g.appendChild(s[h].cloneNode(!0));
+  const m = t.cloneNode(!1);
+  o && m.appendChild(o.cloneNode(!0));
+  for (let h = d; h < s.length; h++)
+    m.appendChild(s[h].cloneNode(!0));
+  return e.insertBefore(g, t), e.insertBefore(m, t), t.remove(), !0;
+}
+function _(t, e, a) {
+  if (t.tagName === "TABLE" || t.tagName === "IMG") return !1;
+  const n = (t.textContent || "").split(/\s+/).filter(Boolean);
+  if (n.length < 2) return !1;
+  const i = t.tagName, o = t.getAttribute("style") || "", s = getComputedStyle(t).width, r = document.createElement(i);
+  if (r.setAttribute("style", o), Object.assign(r.style, {
+    position: "absolute",
+    visibility: "hidden",
+    width: s
+  }), e.appendChild(r), r.textContent = n[0], r.offsetHeight > a)
+    return r.remove(), !1;
+  let l = 1, d = n.length;
+  for (; l < d; ) {
+    const m = Math.ceil((l + d) / 2);
+    r.textContent = n.slice(0, m).join(" "), r.offsetHeight <= a ? l = m : d = m - 1;
+  }
+  if (r.remove(), l >= n.length) return !1;
+  const c = document.createElement(i);
+  c.setAttribute("style", o), c.textContent = n.slice(0, l).join(" ");
+  const g = document.createElement(i);
+  return g.setAttribute("style", o), g.textContent = n.slice(l).join(" "), e.insertBefore(c, t), e.insertBefore(g, t), t.remove(), !0;
+}
+function j(t, e) {
+  let a = 0;
+  for (; a < t.children.length; ) {
+    const n = t.children[a], i = n.offsetTop, o = i + n.offsetHeight, s = (Math.floor(i / e) + 1) * e;
+    if (o > s) {
+      const r = s - i;
+      if (n.tagName === "TABLE") {
+        if (U(
+          n,
+          t,
+          r
+        ))
+          continue;
+      } else if (_(n, t, r))
+        continue;
+      if (n.offsetHeight <= e) {
+        const l = document.createElement("div");
+        l.style.height = s - i + 1 + "px", n.parentNode.insertBefore(l, n), a++;
+      }
     }
+    a++;
   }
 }
-function k(i, n = {}) {
-  const o = v(n), e = C(), a = A(i, o.pageWidth);
-  W(a);
-  const t = x(a, o);
-  return P(a, t.pageContentPx), S(a, t.pageContentPx), M(a, t.pageContentPx), {
-    clone: a,
-    layout: t,
-    options: o,
+function J(t, e = {}) {
+  const a = M(e), n = N(), i = B(t, a.pageWidth);
+  E(i);
+  const o = x(i, a);
+  return T(i, o.pageContentPx), R(i, o.pageContentPx), j(i, o.pageContentPx), {
+    clone: i,
+    layout: o,
+    options: a,
     cleanup: () => {
-      a.remove(), e();
+      i.remove(), n();
     }
   };
 }
-async function F(i, n, o = {}) {
-  const { clone: e, layout: a, options: t, cleanup: s } = k(n, o);
+async function Y(t, e, a = {}) {
+  const { clone: n, layout: i, options: o, cleanup: s } = J(e, a);
   try {
     await new Promise((r) => {
-      i.html(e, {
+      t.html(n, {
         callback: () => r(),
-        width: a.contentWidthMm,
-        windowWidth: a.renderedWidth,
+        width: i.contentWidthMm,
+        windowWidth: i.renderedWidth,
         margin: [
-          t.margin.top,
-          t.margin.right,
-          t.margin.bottom,
-          t.margin.left
+          o.margin.top,
+          o.margin.right,
+          o.margin.bottom,
+          o.margin.left
         ]
       });
     });
   } finally {
     s();
   }
-  return i;
+  return a.marginContent && await z(t, a.marginContent, a), t;
+}
+function k(t, e) {
+  switch (t) {
+    case "top":
+      return { x: 0, y: 0, width: e.pageWidth, height: e.margin.top };
+    case "bottom":
+      return {
+        x: 0,
+        y: e.pageHeight - e.margin.bottom,
+        width: e.pageWidth,
+        height: e.margin.bottom
+      };
+    case "left":
+      return { x: 0, y: 0, width: e.margin.left, height: e.pageHeight };
+    case "right":
+      return {
+        x: e.pageWidth - e.margin.right,
+        y: 0,
+        width: e.margin.right,
+        height: e.pageHeight
+      };
+  }
+}
+async function L(t, e, a, n) {
+  const i = document.createElement("div");
+  Object.assign(i.style, {
+    position: "fixed",
+    left: "-99999px",
+    top: "0",
+    width: e + "mm",
+    height: a + "mm",
+    overflow: "hidden"
+  }), i.appendChild(t), document.body.appendChild(i);
+  try {
+    return await W(i, {
+      scale: n,
+      backgroundColor: null
+    });
+  } finally {
+    i.remove();
+  }
+}
+const D = ["top", "right", "bottom", "left"];
+async function F(t, e, a) {
+  const n = {};
+  for (const i of D) {
+    const o = t[i];
+    if (o && typeof o != "function") {
+      const s = k(i, e);
+      n[i] = await L(
+        o.cloneNode(!0),
+        s.width,
+        s.height,
+        a
+      );
+    }
+  }
+  return n;
+}
+function Q(t, e) {
+  return t == null ? e.margin : typeof t == "number" ? { top: t, right: t, bottom: t, left: t } : {
+    top: t.top ?? e.margin.top,
+    right: t.right ?? e.margin.right,
+    bottom: t.bottom ?? e.margin.bottom,
+    left: t.left ?? e.margin.left
+  };
+}
+function Z(t, e, a, n, i, o, s) {
+  const {
+    text: r,
+    color: l = "#000000",
+    fontSize: d = 2.5,
+    fontFamily: c = "Arial, sans-serif"
+  } = e, g = d * a, m = (e.gap ?? d * 0.5) * a;
+  t.save(), t.fillStyle = l, t.font = `${g}px ${c}`, t.textBaseline = "middle";
+  const h = t.measureText(r).width + m;
+  t.save(), t.beginPath(), t.rect(n, i - g, o, g * 2), t.clip();
+  for (let f = n; f < n + o; f += h)
+    t.fillText(r, f, i);
+  t.restore(), t.save(), t.beginPath(), t.rect(n, i + s - g, o, g * 2), t.clip();
+  for (let f = n; f < n + o; f += h)
+    t.fillText(r, f, i + s);
+  t.restore(), t.save(), t.translate(n, i + s), t.rotate(-Math.PI / 2), t.beginPath(), t.rect(0, -g, s, g * 2), t.clip();
+  for (let f = 0; f < s; f += h)
+    t.fillText(r, f, 0);
+  t.restore(), t.save(), t.translate(n + o, i), t.rotate(Math.PI / 2), t.beginPath(), t.rect(0, -g, s, g * 2), t.clip();
+  for (let f = 0; f < s; f += h)
+    t.fillText(r, f, 0);
+  t.restore(), t.restore();
+}
+function I(t, e) {
+  return Q(t.margin, e);
+}
+async function G(t, e, a, n, i, o, s, r) {
+  for (const l of D) {
+    const d = e[l];
+    if (!d) continue;
+    const c = k(l, n);
+    let g;
+    typeof d == "function" ? g = await L(
+      d(o, s),
+      c.width,
+      c.height,
+      r
+    ) : g = a[l], t.drawImage(
+      g,
+      0,
+      0,
+      g.width,
+      g.height,
+      Math.round(c.x * i),
+      Math.round(c.y * i),
+      Math.round(c.width * i),
+      Math.round(c.height * i)
+    );
+  }
+  if (e.contentBorder) {
+    const { color: l = "#000000", width: d = 0.3 } = e.contentBorder, c = I(e.contentBorder, n);
+    t.strokeStyle = l, t.lineWidth = d * i, t.strokeRect(
+      Math.round(c.left * i),
+      Math.round(c.top * i),
+      Math.round((n.pageWidth - c.left - c.right) * i),
+      Math.round((n.pageHeight - c.top - c.bottom) * i)
+    );
+  }
+  if (e.textBorder) {
+    const l = I(e.textBorder, n);
+    Z(
+      t,
+      e.textBorder,
+      i,
+      Math.round(l.left * i),
+      Math.round(l.top * i),
+      Math.round((n.pageWidth - l.left - l.right) * i),
+      Math.round((n.pageHeight - l.top - l.bottom) * i)
+    );
+  }
 }
-async function O(i, n = {}) {
-  const { imageFormat: o = "JPEG", imageQuality: e = 1, scale: a = 2 } = n, t = v(n), s = C(), r = A(i, t.pageWidth);
-  r.style.opacity = "1", r.style.left = "-99999px", W(r);
-  const d = x(r, t);
-  P(r, d.pageContentPx), S(r, d.pageContentPx), M(r, d.pageContentPx);
+async function X(t, e = {}) {
+  const { imageFormat: a = "JPEG", imageQuality: n = 1, scale: i = 2 } = e, o = M(e), s = N(), r = B(t, o.pageWidth);
+  r.style.opacity = "1", r.style.left = "-99999px", E(r);
+  const l = x(r, o);
+  T(r, l.pageContentPx), R(r, l.pageContentPx), j(r, l.pageContentPx);
   try {
-    const f = await j(r, {
-      scale: a,
+    const d = await W(r, {
+      scale: i,
       backgroundColor: "#ffffff"
-    }), { jsPDF: g } = await import("jspdf"), l = t.pageWidth - t.margin.left - t.margin.right, h = t.pageHeight - t.margin.top - t.margin.bottom, c = f.width, m = h / l * c, E = Math.ceil(f.height / m), H = t.pageWidth > t.pageHeight ? "l" : "p", w = new g({
-      orientation: H,
+    }), { jsPDF: c } = await import("jspdf"), g = o.pageWidth - o.margin.left - o.margin.right, m = o.pageHeight - o.margin.top - o.margin.bottom, h = d.width, f = m / g * h, P = Math.ceil(d.height / f), v = o.pageWidth > o.pageHeight ? "l" : "p", C = new c({
+      orientation: v,
       unit: "mm",
-      format: [t.pageWidth, t.pageHeight]
+      format: [o.pageWidth, o.pageHeight]
     });
-    for (let u = 0; u < E; u++) {
+    for (let y = 0; y < P; y++) {
       const p = Math.min(
-        m,
-        f.height - u * m
-      ), y = document.createElement("canvas");
-      y.width = c, y.height = p;
-      const b = y.getContext("2d");
-      if (!b) throw new Error("Could not get canvas context");
-      b.fillStyle = "#ffffff", b.fillRect(0, 0, c, p), b.drawImage(
         f,
+        d.height - y * f
+      ), w = document.createElement("canvas");
+      w.width = h, w.height = p;
+      const u = w.getContext("2d");
+      if (!u) throw new Error("Could not get canvas context");
+      u.fillStyle = "#ffffff", u.fillRect(0, 0, h, p), u.drawImage(
+        d,
         0,
-        u * m,
-        c,
+        y * f,
+        h,
         p,
         0,
         0,
-        c,
+        h,
         p
       );
-      const N = y.toDataURL(
-        `image/${o.toLowerCase()}`,
-        e
+      const A = w.toDataURL(
+        `image/${a.toLowerCase()}`,
+        n
       );
-      u > 0 && w.addPage([t.pageWidth, t.pageHeight], H);
-      const R = p / c * l;
-      w.addImage(
-        N,
-        o,
-        t.margin.left,
-        t.margin.top,
-        l,
-        R,
+      y > 0 && C.addPage([o.pageWidth, o.pageHeight], v);
+      const b = p / h * g;
+      C.addImage(
+        A,
+        a,
+        o.margin.left,
+        o.margin.top,
+        g,
+        b,
         void 0,
         "FAST"
       );
     }
+    return e.marginContent && await z(C, e.marginContent, e), C;
+  } finally {
+    r.remove(), s();
+  }
+}
+async function K(t, e = {}) {
+  const { imageFormat: a = "PNG", imageQuality: n = 1, scale: i = 2 } = e, o = M(e), s = N(), r = B(t, o.pageWidth);
+  r.style.opacity = "1", r.style.left = "-99999px", E(r);
+  const l = x(r, o);
+  T(r, l.pageContentPx), R(r, l.pageContentPx), j(r, l.pageContentPx);
+  try {
+    const d = await W(r, {
+      scale: i,
+      backgroundColor: "#ffffff"
+    }), c = o.pageWidth - o.margin.left - o.margin.right, g = o.pageHeight - o.margin.top - o.margin.bottom, m = d.width, h = g / c * m, f = m / c, P = Math.round(o.pageWidth * f), v = Math.round(o.pageHeight * f), C = Math.round(o.margin.top * f), y = Math.round(o.margin.left * f), p = Math.ceil(d.height / h), w = [], { marginContent: u } = e, A = u ? await F(u, o, i) : {};
+    for (let b = 0; b < p; b++) {
+      const O = Math.min(
+        h,
+        d.height - b * h
+      ), S = document.createElement("canvas");
+      S.width = P, S.height = v;
+      const H = S.getContext("2d");
+      if (!H) throw new Error("Could not get canvas context");
+      H.fillStyle = "#ffffff", H.fillRect(0, 0, P, v), H.drawImage(
+        d,
+        0,
+        b * h,
+        m,
+        O,
+        y,
+        C,
+        m,
+        O
+      ), u && await G(
+        H,
+        u,
+        A,
+        o,
+        f,
+        b + 1,
+        p,
+        i
+      ), w.push(
+        S.toDataURL(
+          `image/${a.toLowerCase()}`,
+          n
+        )
+      );
+    }
     return w;
   } finally {
     r.remove(), s();
   }
 }
+async function tt(t, e, a = {}) {
+  const n = M(a), i = await K(t, a);
+  e.innerHTML = "", Object.assign(e.style, {
+    width: "fit-content",
+    height: n.pageHeight + "mm",
+    maxHeight: "100vh",
+    overflowY: "auto",
+    background: "#e0e0e0"
+  });
+  for (let o = 0; o < i.length; o++) {
+    const s = document.createElement("img");
+    s.src = i[o], s.alt = `Page ${o + 1}`, Object.assign(s.style, {
+      width: n.pageWidth + "mm",
+      maxWidth: "100%",
+      height: "auto",
+      boxSizing: "border-box",
+      display: "block",
+      border: "1px solid #bbb",
+      boxShadow: "0 2px 8px rgba(0,0,0,0.2)",
+      marginBottom: "16px"
+    }), e.appendChild(s);
+  }
+}
+async function z(t, e, a = {}) {
+  const n = M(a), i = t.getNumberOfPages(), o = 2, s = o * (96 / 25.4), r = Math.round(n.pageWidth * s), l = Math.round(n.pageHeight * s), d = await F(e, n, o);
+  for (let c = 1; c <= i; c++) {
+    t.setPage(c);
+    const g = document.createElement("canvas");
+    g.width = r, g.height = l;
+    const m = g.getContext("2d");
+    m && (await G(
+      m,
+      e,
+      d,
+      n,
+      s,
+      c,
+      i,
+      o
+    ), t.addImage(
+      g.toDataURL("image/png"),
+      "PNG",
+      0,
+      0,
+      n.pageWidth,
+      n.pageHeight
+    ));
+  }
+  return t;
+}
 export {
-  B as PAGE_MARGINS,
-  T as PAGE_SIZES,
+  $ as PAGE_MARGINS,
+  q as PAGE_SIZES,
+  z as addMarginContent,
   x as computeLayout,
-  A as createPrintClone,
-  M as insertPageBreakSpacers,
-  W as normalizeTableAttributes,
-  k as prepare,
-  F as renderHTML,
-  O as renderImagePDF,
-  P as splitOversizedTables,
-  S as splitOversizedText
+  B as createPrintClone,
+  j as insertPageBreakSpacers,
+  E as normalizeTableAttributes,
+  J as prepare,
+  tt as previewPageImages,
+  Y as renderHTML,
+  X as renderImagePDF,
+  K as renderPageImages,
+  T as splitOversizedTables,
+  R as splitOversizedText
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jspdf-utils",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Utility helpers for jsPDF's doc.html() renderer with automatic page breaking, table splitting, and RTL support",
   "type": "module",
   "main": "dist/html-to-pdf.js",