jspdf-utils 0.1.5 → 0.1.7

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

@@ -81,4 +81,15 @@ export interface ImagePDFOptions {
  * 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>;
+export { PAGE_SIZES, PAGE_MARGINS, computeLayout, createPrintClone, normalizeTableAttributes, splitOversizedTables, splitOversizedText, insertPageBreakSpacers, prepare, renderHTML, renderImagePDF, renderPageImages, previewPageImages, };

package/dist/html-to-pdf.js

@@ -1,5 +1,5 @@
-import N from "html2canvas";
-const T = {
+import T from "html2canvas";
+const k = {
   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 = {
+}, L = {
   a0: 40,
   a1: 35,
   a2: 30,
@@ -22,205 +22,276 @@ const T = {
   legal: 25.4,
   tabloid: 25
 };
-function x(i = {}) {
-  const o = i.format ?? "a4", [n, t] = T[o], r = i.pageWidth ?? n, e = i.pageHeight ?? t, a = B[o], c = {
-    top: a,
-    right: a,
-    bottom: a,
-    left: a
+function W(i = {}) {
+  const e = i.format ?? "a4", [o, n] = k[e], r = i.pageWidth ?? o, t = i.pageHeight ?? n, c = L[e], a = {
+    top: c,
+    right: c,
+    bottom: c,
+    left: c
   };
   return {
     unit: i.unit ?? "mm",
-    format: o,
+    format: e,
     pageWidth: r,
-    pageHeight: e,
-    margin: { ...c, ...i.margin }
+    pageHeight: t,
+    margin: { ...a, ...i.margin }
   };
 }
-function A(i, o) {
-  const n = i.offsetWidth, t = o.pageWidth - o.margin.left - o.margin.right, r = t / n, a = (o.pageHeight - o.margin.top - o.margin.bottom) / r;
-  return { renderedWidth: n, scale: r, contentWidthMm: t, pageContentPx: a };
+function M(i, e) {
+  const o = i.offsetWidth, n = e.pageWidth - e.margin.left - e.margin.right, r = n / o, c = (e.pageHeight - e.margin.top - e.margin.bottom) / r;
+  return { renderedWidth: o, scale: r, contentWidthMm: n, pageContentPx: c };
 }
-function v(i, o = 210) {
-  const n = i.cloneNode(!0);
-  return Object.assign(n.style, {
+function A(i, e = 210) {
+  const o = i.cloneNode(!0);
+  return Object.assign(o.style, {
     position: "fixed",
     top: "0",
     left: "0",
     boxSizing: "border-box",
-    width: o + "mm",
+    width: e + "mm",
     opacity: "0.000001",
     pointerEvents: "none"
-  }), document.body.appendChild(n), n;
+  }), document.body.appendChild(o), o;
 }
-function W(i) {
-  for (const o of i.querySelectorAll("table")) {
-    const n = o.getAttribute("cellpadding");
-    if (n) {
-      for (const t of o.querySelectorAll("th, td"))
-        t.style.padding || (t.style.padding = n + "px");
-      o.removeAttribute("cellpadding");
+function S() {
+  const i = document.createElement("style");
+  return i.setAttribute("data-jspdf-utils", ""), i.textContent = "img { display: inline !important; }", document.head.appendChild(i), () => i.remove();
+}
+function E(i) {
+  for (const e of i.querySelectorAll("table")) {
+    const o = e.getAttribute("cellpadding");
+    if (o) {
+      for (const n of e.querySelectorAll("th, td"))
+        n.style.padding || (n.style.padding = o + "px");
+      e.removeAttribute("cellpadding");
     }
   }
 }
-function C(i, o) {
-  for (const n of Array.from(
+function R(i, e) {
+  for (const o of Array.from(
     i.querySelectorAll(":scope > table")
   )) {
-    if (n.offsetHeight <= o) continue;
-    const t = Array.from(n.rows);
-    if (t.length === 0) continue;
-    const r = t[0].querySelector("th") !== null, e = r ? t[0] : null, a = r ? t.slice(1) : t, c = e ? e.offsetHeight : 0, f = o - c - 2, h = [];
-    let l = [], d = 0;
-    for (const s of a) {
-      const g = s.offsetHeight;
-      d + g > f && l.length > 0 && (h.push(l), l = [], d = 0), l.push(s), d += g;
+    if (o.offsetHeight <= e) continue;
+    const n = Array.from(o.rows);
+    if (n.length === 0) continue;
+    const r = n[0].querySelector("th") !== null, t = r ? n[0] : null, c = r ? n.slice(1) : n, a = t ? t.offsetHeight : 0, h = e - a - 2, d = [];
+    let l = [], g = 0;
+    for (const m of c) {
+      const s = m.offsetHeight;
+      g + s > h && l.length > 0 && (d.push(l), l = [], g = 0), l.push(m), g += s;
     }
-    l.length > 0 && h.push(l);
-    for (const s of h) {
-      const g = n.cloneNode(!1);
-      e && g.appendChild(e.cloneNode(!0));
-      for (const m of s) g.appendChild(m.cloneNode(!0));
-      n.parentNode.insertBefore(g, n);
+    l.length > 0 && d.push(l);
+    for (const m of d) {
+      const s = o.cloneNode(!1);
+      t && s.appendChild(t.cloneNode(!0));
+      for (const f of m) s.appendChild(f.cloneNode(!0));
+      o.parentNode.insertBefore(s, o);
     }
-    n.remove();
+    o.remove();
   }
 }
-function P(i, o) {
-  for (const n of Array.from(i.querySelectorAll(":scope > *"))) {
-    const t = n;
-    if (t.offsetHeight <= o || t.tagName === "TABLE")
+function N(i, e) {
+  for (const o of Array.from(i.querySelectorAll(":scope > *"))) {
+    const n = o;
+    if (n.offsetHeight <= e || n.tagName === "TABLE")
       continue;
-    const r = t.tagName, e = t.getAttribute("style") || "", a = getComputedStyle(t).width, c = (t.textContent || "").split(/\s+/).filter(Boolean), f = document.createElement(r);
-    f.setAttribute("style", e), Object.assign(f.style, {
+    const r = n.tagName, t = n.getAttribute("style") || "", c = getComputedStyle(n).width, a = (n.textContent || "").split(/\s+/).filter(Boolean), h = document.createElement(r);
+    h.setAttribute("style", t), Object.assign(h.style, {
       position: "absolute",
       visibility: "hidden",
-      width: a
-    }), i.appendChild(f);
-    const h = [];
+      width: c
+    }), i.appendChild(h);
+    const d = [];
     let l = 0;
-    for (; l < c.length; ) {
-      let d = l + 1, s = c.length;
-      for (; d < s; ) {
-        const m = Math.ceil((d + s) / 2);
-        f.textContent = c.slice(l, m).join(" "), f.offsetHeight <= o ? d = m : s = m - 1;
+    for (; l < a.length; ) {
+      let g = l + 1, m = a.length;
+      for (; g < m; ) {
+        const f = Math.ceil((g + m) / 2);
+        h.textContent = a.slice(l, f).join(" "), h.offsetHeight <= e ? g = f : m = f - 1;
       }
-      const g = document.createElement(r);
-      g.setAttribute("style", e), g.textContent = c.slice(l, d).join(" "), h.push(g), l = d;
+      const s = document.createElement(r);
+      s.setAttribute("style", t), s.textContent = a.slice(l, g).join(" "), d.push(s), l = g;
     }
-    f.remove();
-    for (const d of h)
-      t.parentNode.insertBefore(d, t);
-    t.remove();
+    h.remove();
+    for (const g of d)
+      n.parentNode.insertBefore(g, n);
+    n.remove();
   }
 }
-function M(i, o) {
-  const n = Array.from(i.children);
-  for (const t of n) {
-    const r = t.offsetTop, e = r + t.offsetHeight, a = (Math.floor(r / o) + 1) * o;
-    if (e > a && t.offsetHeight <= o) {
-      const c = document.createElement("div");
-      c.style.height = a - r + 1 + "px", t.parentNode.insertBefore(c, t);
+function j(i, e) {
+  const o = Array.from(i.children);
+  for (const n of o) {
+    const r = n.offsetTop, t = r + n.offsetHeight, c = (Math.floor(r / e) + 1) * e;
+    if (t > c && n.offsetHeight <= e) {
+      const a = document.createElement("div");
+      a.style.height = c - r + 1 + "px", n.parentNode.insertBefore(a, n);
     }
   }
 }
-function j(i, o = {}) {
-  const n = x(o), t = v(i, n.pageWidth);
-  W(t);
-  const r = A(t, n);
-  return C(t, r.pageContentPx), P(t, r.pageContentPx), M(t, r.pageContentPx), {
-    clone: t,
-    layout: r,
-    options: n,
-    cleanup: () => t.remove()
+function B(i, e = {}) {
+  const o = W(e), n = S(), r = A(i, o.pageWidth);
+  E(r);
+  const t = M(r, o);
+  return R(r, t.pageContentPx), N(r, t.pageContentPx), j(r, t.pageContentPx), {
+    clone: r,
+    layout: t,
+    options: o,
+    cleanup: () => {
+      r.remove(), n();
+    }
   };
 }
-async function D(i, o, n = {}) {
-  const { clone: t, layout: r, options: e, cleanup: a } = j(o, n);
+async function D(i, e, o = {}) {
+  const { clone: n, layout: r, options: t, cleanup: c } = B(e, o);
   try {
-    await new Promise((c) => {
-      i.html(t, {
-        callback: () => c(),
+    await new Promise((a) => {
+      i.html(n, {
+        callback: () => a(),
         width: r.contentWidthMm,
         windowWidth: r.renderedWidth,
         margin: [
-          e.margin.top,
-          e.margin.right,
-          e.margin.bottom,
-          e.margin.left
+          t.margin.top,
+          t.margin.right,
+          t.margin.bottom,
+          t.margin.left
         ]
       });
     });
   } finally {
-    a();
+    c();
   }
   return i;
 }
-async function F(i, o = {}) {
-  const { imageFormat: n = "JPEG", imageQuality: t = 1, scale: r = 2 } = o, e = x(o), a = v(i, e.pageWidth);
-  a.style.opacity = "1", a.style.left = "-99999px", W(a);
-  const c = A(a, e);
-  C(a, c.pageContentPx), P(a, c.pageContentPx), M(a, c.pageContentPx);
+async function F(i, e = {}) {
+  const { imageFormat: o = "JPEG", imageQuality: n = 1, scale: r = 2 } = e, t = W(e), c = S(), a = A(i, t.pageWidth);
+  a.style.opacity = "1", a.style.left = "-99999px", E(a);
+  const h = M(a, t);
+  R(a, h.pageContentPx), N(a, h.pageContentPx), j(a, h.pageContentPx);
   try {
-    const f = await N(a, {
+    const d = await T(a, {
       scale: r,
       backgroundColor: "#ffffff"
-    }), { jsPDF: h } = await import("jspdf"), l = e.pageWidth - e.margin.left - e.margin.right, d = e.pageHeight - e.margin.top - e.margin.bottom, s = f.width, g = d / l * s, m = Math.ceil(f.height / g), H = e.pageWidth > e.pageHeight ? "l" : "p", w = new h({
-      orientation: H,
+    }), { jsPDF: l } = await import("jspdf"), g = t.pageWidth - t.margin.left - t.margin.right, m = t.pageHeight - t.margin.top - t.margin.bottom, s = d.width, f = m / g * s, P = Math.ceil(d.height / f), w = t.pageWidth > t.pageHeight ? "l" : "p", H = new l({
+      orientation: w,
       unit: "mm",
-      format: [e.pageWidth, e.pageHeight]
+      format: [t.pageWidth, t.pageHeight]
     });
-    for (let u = 0; u < m; u++) {
-      const p = Math.min(
-        g,
-        f.height - u * g
-      ), y = document.createElement("canvas");
-      y.width = s, 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, s, p), b.drawImage(
+    for (let u = 0; u < P; u++) {
+      const y = Math.min(
         f,
+        d.height - u * f
+      ), b = document.createElement("canvas");
+      b.width = s, b.height = y;
+      const p = b.getContext("2d");
+      if (!p) throw new Error("Could not get canvas context");
+      p.fillStyle = "#ffffff", p.fillRect(0, 0, s, y), p.drawImage(
+        d,
         0,
-        u * g,
+        u * f,
         s,
-        p,
+        y,
         0,
         0,
         s,
-        p
+        y
       );
-      const E = y.toDataURL(
-        `image/${n.toLowerCase()}`,
-        t
+      const v = b.toDataURL(
+        `image/${o.toLowerCase()}`,
+        n
       );
-      u > 0 && w.addPage([e.pageWidth, e.pageHeight], H);
-      const S = p / s * l;
-      w.addImage(
-        E,
-        n,
-        e.margin.left,
-        e.margin.top,
-        l,
-        S,
+      u > 0 && H.addPage([t.pageWidth, t.pageHeight], w);
+      const x = y / s * g;
+      H.addImage(
+        v,
+        o,
+        t.margin.left,
+        t.margin.top,
+        g,
+        x,
         void 0,
         "FAST"
       );
     }
-    return w;
+    return H;
+  } finally {
+    a.remove(), c();
+  }
+}
+async function I(i, e = {}) {
+  const { imageFormat: o = "PNG", imageQuality: n = 1, scale: r = 2 } = e, t = W(e), c = S(), a = A(i, t.pageWidth);
+  a.style.opacity = "1", a.style.left = "-99999px", E(a);
+  const h = M(a, t);
+  R(a, h.pageContentPx), N(a, h.pageContentPx), j(a, h.pageContentPx);
+  try {
+    const d = await T(a, {
+      scale: r,
+      backgroundColor: "#ffffff"
+    }), l = t.pageWidth - t.margin.left - t.margin.right, g = t.pageHeight - t.margin.top - t.margin.bottom, m = d.width, s = g / l * m, f = m / l, P = Math.round(t.pageWidth * f), w = Math.round(t.pageHeight * f), H = Math.round(t.margin.top * f), u = Math.round(t.margin.left * f), y = Math.ceil(d.height / s), b = [];
+    for (let p = 0; p < y; p++) {
+      const v = Math.min(
+        s,
+        d.height - p * s
+      ), x = document.createElement("canvas");
+      x.width = P, x.height = w;
+      const C = x.getContext("2d");
+      if (!C) throw new Error("Could not get canvas context");
+      C.fillStyle = "#ffffff", C.fillRect(0, 0, P, w), C.drawImage(
+        d,
+        0,
+        p * s,
+        m,
+        v,
+        u,
+        H,
+        m,
+        v
+      ), b.push(
+        x.toDataURL(
+          `image/${o.toLowerCase()}`,
+          n
+        )
+      );
+    }
+    return b;
   } finally {
-    a.remove();
+    a.remove(), c();
+  }
+}
+async function q(i, e, o = {}) {
+  const n = W(o), r = await I(i, o);
+  e.innerHTML = "", Object.assign(e.style, {
+    width: "fit-content",
+    height: n.pageHeight + "mm",
+    maxHeight: "100vh",
+    overflowY: "auto",
+    background: "#e0e0e0"
+  });
+  for (let t = 0; t < r.length; t++) {
+    const c = document.createElement("img");
+    c.src = r[t], c.alt = `Page ${t + 1}`, Object.assign(c.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(c);
   }
 }
 export {
-  B as PAGE_MARGINS,
-  T as PAGE_SIZES,
-  A as computeLayout,
-  v as createPrintClone,
-  M as insertPageBreakSpacers,
-  W as normalizeTableAttributes,
-  j as prepare,
+  L as PAGE_MARGINS,
+  k as PAGE_SIZES,
+  M as computeLayout,
+  A as createPrintClone,
+  j as insertPageBreakSpacers,
+  E as normalizeTableAttributes,
+  B as prepare,
+  q as previewPageImages,
   D as renderHTML,
   F as renderImagePDF,
-  C as splitOversizedTables,
-  P as splitOversizedText
+  I as renderPageImages,
+  R as splitOversizedTables,
+  N as splitOversizedText
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jspdf-utils",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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",