@unlev/exeq 0.3.1 → 0.3.3

package/dist/index.js

@@ -30,7 +30,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib/index.ts
 var lib_exports = {};
 __export(lib_exports, {
+  A4: () => A4,
   BUILTIN_TRANSFORMS: () => BUILTIN_TRANSFORMS,
+  DEFAULT_CALIBRATION: () => DEFAULT_CALIBRATION,
   DEFAULT_SIGNER_ROLES: () => DEFAULT_SIGNER_ROLES,
   DesignerView: () => DesignerView,
   FIELD_DEFAULTS: () => FIELD_DEFAULTS,
@@ -42,7 +44,11 @@ __export(lib_exports, {
   SignatureCanvas: () => SignatureCanvas,
   SignerRoleSelector: () => SignerRoleSelector,
   SignerView: () => SignerView,
+  US_LEGAL: () => US_LEGAL,
+  US_LETTER: () => US_LETTER,
+  applyCalibration: () => applyCalibration,
   createField: () => createField,
+  createPdfBuilder: () => createPdfBuilder,
   downloadPdf: () => downloadPdf,
   generateFilledPdf: () => generateFilledPdf,
   generateId: () => generateId,
@@ -671,6 +677,13 @@ function FieldPropertyPanel({ field, signerRoles, onUpdate, onDelete, prefillCon
           /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("input", { type: "number", min: "0", max: "9999", value: field.maxLength || 0, onChange: (e) => onUpdate(field.id, { maxLength: Number(e.target.value) }) })
         ] })
       ] }),
+      isTextField && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "panel-field", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("label", { className: "panel-checkbox-label", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("input", { type: "checkbox", checked: field.autoShrink || false, onChange: (e) => onUpdate(field.id, { autoShrink: e.target.checked }) }),
+          "Auto-shrink to fit"
+        ] }),
+        field.autoShrink && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "panel-hint", children: "Font size reduces to fit text within the field width" })
+      ] }),
       (field.type === "text" || field.type === "dropdown") && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "panel-field", children: [
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("label", { children: field.type === "dropdown" ? "Options" : "Predefined Options" }),
         /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "panel-options-list", children: [
@@ -2040,33 +2053,132 @@ var import_react7 = require("react");
 
 // src/utils/pdfFiller.ts
 var import_pdf_lib = require("pdf-lib");
+
+// src/utils/formulaResolver.ts
+var BUILTIN_TRANSFORMS = {
+  // Date transforms (expects a parseable date string)
+  month: (v) => {
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? "" : String(d.getMonth() + 1);
+  },
+  month2: (v) => {
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? "" : String(d.getMonth() + 1).padStart(2, "0");
+  },
+  monthname: (v) => {
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? "" : d.toLocaleString("en", { month: "long" });
+  },
+  monthshort: (v) => {
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? "" : d.toLocaleString("en", { month: "short" });
+  },
+  day: (v) => {
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? "" : String(d.getDate());
+  },
+  day2: (v) => {
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? "" : String(d.getDate()).padStart(2, "0");
+  },
+  year: (v) => {
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? "" : String(d.getFullYear());
+  },
+  year2: (v) => {
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? "" : String(d.getFullYear()).slice(-2);
+  },
+  // String transforms
+  upper: (v) => v.toUpperCase(),
+  lower: (v) => v.toLowerCase(),
+  trim: (v) => v.trim(),
+  first: (v) => v.split(/\s+/)[0] || "",
+  last: (v) => {
+    const parts = v.split(/\s+/);
+    return parts[parts.length - 1] || "";
+  },
+  initials: (v) => v.split(/\s+/).map((w) => w[0] || "").join("").toUpperCase(),
+  // Numeric / substring
+  last4: (v) => v.slice(-4),
+  last2: (v) => v.slice(-2),
+  first4: (v) => v.slice(0, 4),
+  first2: (v) => v.slice(0, 2),
+  digits: (v) => v.replace(/\D/g, ""),
+  number: (v) => {
+    const n = parseFloat(v);
+    return isNaN(n) ? "" : String(n);
+  },
+  currency: (v) => {
+    const n = parseFloat(v.replace(/[^0-9.-]/g, ""));
+    return isNaN(n) ? "" : `$${n.toFixed(2)}`;
+  }
+};
+var FORMULA_RE = /\{\{(.+?)\}\}/g;
+var PIPE_RE = /^(.+?)\s*\|\s*(.+)$/;
+function resolveFormula(formula, fields, customTransforms) {
+  const transforms = { ...BUILTIN_TRANSFORMS, ...customTransforms };
+  return formula.replace(FORMULA_RE, (_match, expr) => {
+    const pipeMatch = expr.match(PIPE_RE);
+    const sourceLabel = (pipeMatch ? pipeMatch[1] : expr).trim();
+    const transformName = pipeMatch ? pipeMatch[2].trim() : null;
+    const sourceField = fields.find((f) => f.label.toLowerCase() === sourceLabel.toLowerCase()) || fields.find((f) => f.id === sourceLabel);
+    if (!sourceField) return "";
+    const rawValue = sourceField.value || "";
+    if (!transformName) return rawValue;
+    const fn = transforms[transformName];
+    if (!fn) return rawValue;
+    try {
+      return fn(rawValue);
+    } catch {
+      return rawValue;
+    }
+  });
+}
+function resolveAllFormulas(fields, customTransforms) {
+  return fields.map((f) => {
+    if (!f.formula) return f;
+    const computed = resolveFormula(f.formula, fields, customTransforms);
+    return computed !== f.value ? { ...f, value: computed } : f;
+  });
+}
+
+// src/utils/pdfFiller.ts
 var FONT_MAP = {
-  "Helvetica": import_pdf_lib.StandardFonts.Helvetica,
-  "Courier": import_pdf_lib.StandardFonts.Courier,
-  "TimesRoman": import_pdf_lib.StandardFonts.TimesRoman
+  Helvetica: import_pdf_lib.StandardFonts.Helvetica,
+  Courier: import_pdf_lib.StandardFonts.Courier,
+  TimesRoman: import_pdf_lib.StandardFonts.TimesRoman
 };
-async function generateFilledPdf(pdfSource, fields) {
-  let pdfBytes;
-  if (typeof pdfSource === "string") {
-    const res = await fetch(pdfSource);
-    pdfBytes = await res.arrayBuffer();
-  } else {
-    pdfBytes = pdfSource;
-  }
-  const pdfDoc = await import_pdf_lib.PDFDocument.load(pdfBytes);
-  const fontCache = /* @__PURE__ */ new Map();
-  const usedFontKeys = new Set(fields.map((f) => f.fontFamily || "Helvetica"));
-  for (const key of usedFontKeys) {
-    const stdFont = FONT_MAP[key] || import_pdf_lib.StandardFonts.Helvetica;
-    fontCache.set(key, await pdfDoc.embedFont(stdFont));
-  }
-  const pages = pdfDoc.getPages();
-  function hexToRgb(hex) {
-    const r = parseInt(hex.slice(1, 3), 16) / 255;
-    const g = parseInt(hex.slice(3, 5), 16) / 255;
-    const b = parseInt(hex.slice(5, 7), 16) / 255;
-    return (0, import_pdf_lib.rgb)(r, g, b);
+var US_LETTER = [612, 792];
+var US_LEGAL = [612, 1008];
+var A4 = [595.28, 841.89];
+var DEFAULT_CALIBRATION = {
+  xOffset: 0,
+  yOffset: 0,
+  xScale: 1,
+  yScale: 1
+};
+function applyCalibration(fields, calibration, pageSize = US_LETTER) {
+  if (calibration.xOffset === 0 && calibration.yOffset === 0 && calibration.xScale === 1 && calibration.yScale === 1) {
+    return fields;
   }
+  const xPctOff = calibration.xOffset / pageSize[0] * 100;
+  const yPctOff = calibration.yOffset / pageSize[1] * 100;
+  return fields.map((f) => ({
+    ...f,
+    x: f.x * calibration.xScale + xPctOff,
+    y: f.y * calibration.yScale + yPctOff,
+    width: f.width * calibration.xScale,
+    height: f.height * calibration.yScale
+  }));
+}
+function hexToRgb(hex) {
+  const r = parseInt(hex.slice(1, 3), 16) / 255;
+  const g = parseInt(hex.slice(3, 5), 16) / 255;
+  const b = parseInt(hex.slice(5, 7), 16) / 255;
+  return (0, import_pdf_lib.rgb)(r, g, b);
+}
+async function renderFieldsOnPages(pages, fields, getFont, getSignature) {
   for (const field of fields) {
     const page = pages[field.page];
     if (!page) continue;
@@ -2107,37 +2219,32 @@ async function generateFilledPdf(pdfSource, fields) {
       }
     } else if (field.type === "signature" || field.type === "initials") {
       if (field.value.startsWith("data:image/png")) {
-        const pngBytes = Uint8Array.from(
-          atob(field.value.split(",")[1]),
-          (c) => c.charCodeAt(0)
-        );
-        const pngImage = await pdfDoc.embedPng(pngBytes);
-        page.drawImage(pngImage, {
-          x,
-          y,
-          width: w,
-          height: h
-        });
+        const img = await getSignature(field.value);
+        page.drawImage(img, { x, y, width: w, height: h });
       }
     } else {
-      const font = fontCache.get(field.fontFamily || "Helvetica");
+      const font = await getFont(field.fontFamily || "Helvetica");
       const spacing = field.letterSpacing || 0;
-      const textWidthAtSize = (text, size) => {
-        const baseWidth = font.widthOfTextAtSize(text, size);
-        return baseWidth + spacing * (text.length - 1);
-      };
-      const maxFontSize = Math.min(field.fontSize, h * 0.7);
-      let fontSize = maxFontSize;
-      const padding = 4;
-      while (fontSize > 4) {
-        if (textWidthAtSize(field.value, fontSize) <= w - padding) break;
-        fontSize -= 0.5;
+      const textWidthAtSize = (text, size) => font.widthOfTextAtSize(text, size) + spacing * (text.length - 1);
+      let fontSize = field.autoShrink ? Math.min(field.fontSize, h * 0.7) : field.fontSize;
+      if (field.autoShrink) {
+        const padding = 4;
+        while (fontSize > 4) {
+          if (textWidthAtSize(field.value, fontSize) <= w - padding) break;
+          fontSize -= 0.5;
+        }
       }
       if (spacing > 0) {
         let cx = x + 2;
         const cy = y + h * 0.3;
         for (const char of field.value) {
-          page.drawText(char, { x: cx, y: cy, size: fontSize, font, color: inkColor });
+          page.drawText(char, {
+            x: cx,
+            y: cy,
+            size: fontSize,
+            font,
+            color: inkColor
+          });
           cx += font.widthOfTextAtSize(char, fontSize) + spacing;
         }
       } else {
@@ -2151,7 +2258,98 @@ async function generateFilledPdf(pdfSource, fields) {
       }
     }
   }
-  return pdfDoc.save();
+}
+async function generateFilledPdf(opts) {
+  const builder = await createPdfBuilder({ pageSize: opts.pageSize });
+  await builder.addRecord(opts);
+  return builder.save();
+}
+async function createPdfBuilder(defaults = {}) {
+  const doc = await import_pdf_lib.PDFDocument.create();
+  const fontCache = /* @__PURE__ */ new Map();
+  const embeddedPagesByUrl = /* @__PURE__ */ new Map();
+  const signatureCache = /* @__PURE__ */ new Map();
+  async function getFont(family) {
+    let f = fontCache.get(family);
+    if (!f) {
+      const stdName = FONT_MAP[family] || import_pdf_lib.StandardFonts.Helvetica;
+      f = await doc.embedFont(stdName);
+      fontCache.set(family, f);
+    }
+    return f;
+  }
+  async function ensureFonts(fields) {
+    const keys = new Set(fields.map((f) => f.fontFamily || "Helvetica"));
+    for (const k of keys) await getFont(k);
+  }
+  async function embedSource(source) {
+    if (typeof source === "string") {
+      let pages = embeddedPagesByUrl.get(source);
+      if (!pages) {
+        const res = await fetch(source);
+        const bytes = await res.arrayBuffer();
+        const srcDoc2 = await import_pdf_lib.PDFDocument.load(bytes);
+        pages = await Promise.all(
+          srcDoc2.getPages().map((p) => doc.embedPage(p))
+        );
+        embeddedPagesByUrl.set(source, pages);
+      }
+      return pages;
+    }
+    const srcDoc = await import_pdf_lib.PDFDocument.load(source);
+    return Promise.all(srcDoc.getPages().map((p) => doc.embedPage(p)));
+  }
+  async function getSignature(dataUrl) {
+    let img = signatureCache.get(dataUrl);
+    if (!img) {
+      const b64 = dataUrl.split(",")[1] ?? "";
+      const pngBytes = Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
+      img = await doc.embedPng(pngBytes);
+      signatureCache.set(dataUrl, img);
+    }
+    return img;
+  }
+  return {
+    doc,
+    async addRecord(opts) {
+      const pageSize = opts.pageSize ?? defaults.pageSize;
+      let fields = opts.resolveFormulas ? resolveAllFormulas(opts.fields, opts.customTransforms) : opts.fields;
+      if (opts.calibration) {
+        fields = applyCalibration(
+          fields,
+          opts.calibration,
+          pageSize ?? US_LETTER
+        );
+      }
+      await ensureFonts(fields);
+      let sourcePages = [];
+      let pageCount;
+      if (opts.pdfSource !== null) {
+        sourcePages = await embedSource(opts.pdfSource);
+        pageCount = sourcePages.length;
+      } else {
+        pageCount = opts.pageCount ?? 1;
+      }
+      const newPages = [];
+      for (let i = 0; i < pageCount; i++) {
+        const size = pageSize ? pageSize : sourcePages[i] ? [sourcePages[i].width, sourcePages[i].height] : US_LETTER;
+        const page = doc.addPage(size);
+        newPages.push(page);
+        if (sourcePages[i]) {
+          page.drawPage(sourcePages[i], {
+            x: 0,
+            y: 0,
+            width: size[0],
+            height: size[1]
+          });
+        }
+      }
+      await renderFieldsOnPages(newPages, fields, getFont, getSignature);
+    },
+    async save() {
+      return doc.save();
+    }
+  };
 }
 function downloadPdf(bytes, filename) {
   const blob = new Blob([bytes.slice().buffer], { type: "application/pdf" });
@@ -2263,95 +2461,6 @@ function FieldNavigator({
   ] });
 }
 
-// src/utils/formulaResolver.ts
-var BUILTIN_TRANSFORMS = {
-  // Date transforms (expects a parseable date string)
-  month: (v) => {
-    const d = new Date(v);
-    return isNaN(d.getTime()) ? "" : String(d.getMonth() + 1);
-  },
-  month2: (v) => {
-    const d = new Date(v);
-    return isNaN(d.getTime()) ? "" : String(d.getMonth() + 1).padStart(2, "0");
-  },
-  monthname: (v) => {
-    const d = new Date(v);
-    return isNaN(d.getTime()) ? "" : d.toLocaleString("en", { month: "long" });
-  },
-  monthshort: (v) => {
-    const d = new Date(v);
-    return isNaN(d.getTime()) ? "" : d.toLocaleString("en", { month: "short" });
-  },
-  day: (v) => {
-    const d = new Date(v);
-    return isNaN(d.getTime()) ? "" : String(d.getDate());
-  },
-  day2: (v) => {
-    const d = new Date(v);
-    return isNaN(d.getTime()) ? "" : String(d.getDate()).padStart(2, "0");
-  },
-  year: (v) => {
-    const d = new Date(v);
-    return isNaN(d.getTime()) ? "" : String(d.getFullYear());
-  },
-  year2: (v) => {
-    const d = new Date(v);
-    return isNaN(d.getTime()) ? "" : String(d.getFullYear()).slice(-2);
-  },
-  // String transforms
-  upper: (v) => v.toUpperCase(),
-  lower: (v) => v.toLowerCase(),
-  trim: (v) => v.trim(),
-  first: (v) => v.split(/\s+/)[0] || "",
-  last: (v) => {
-    const parts = v.split(/\s+/);
-    return parts[parts.length - 1] || "";
-  },
-  initials: (v) => v.split(/\s+/).map((w) => w[0] || "").join("").toUpperCase(),
-  // Numeric / substring
-  last4: (v) => v.slice(-4),
-  last2: (v) => v.slice(-2),
-  first4: (v) => v.slice(0, 4),
-  first2: (v) => v.slice(0, 2),
-  digits: (v) => v.replace(/\D/g, ""),
-  number: (v) => {
-    const n = parseFloat(v);
-    return isNaN(n) ? "" : String(n);
-  },
-  currency: (v) => {
-    const n = parseFloat(v.replace(/[^0-9.-]/g, ""));
-    return isNaN(n) ? "" : `$${n.toFixed(2)}`;
-  }
-};
-var FORMULA_RE = /\{\{(.+?)\}\}/g;
-var PIPE_RE = /^(.+?)\s*\|\s*(.+)$/;
-function resolveFormula(formula, fields, customTransforms) {
-  const transforms = { ...BUILTIN_TRANSFORMS, ...customTransforms };
-  return formula.replace(FORMULA_RE, (_match, expr) => {
-    const pipeMatch = expr.match(PIPE_RE);
-    const sourceLabel = (pipeMatch ? pipeMatch[1] : expr).trim();
-    const transformName = pipeMatch ? pipeMatch[2].trim() : null;
-    const sourceField = fields.find((f) => f.label.toLowerCase() === sourceLabel.toLowerCase()) || fields.find((f) => f.id === sourceLabel);
-    if (!sourceField) return "";
-    const rawValue = sourceField.value || "";
-    if (!transformName) return rawValue;
-    const fn = transforms[transformName];
-    if (!fn) return rawValue;
-    try {
-      return fn(rawValue);
-    } catch {
-      return rawValue;
-    }
-  });
-}
-function resolveAllFormulas(fields, customTransforms) {
-  return fields.map((f) => {
-    if (!f.formula) return f;
-    const computed = resolveFormula(f.formula, fields, customTransforms);
-    return computed !== f.value ? { ...f, value: computed } : f;
-  });
-}
-
 // src/components/pdf-builder/SignerView.tsx
 var import_jsx_runtime6 = require("react/jsx-runtime");
 function SignerView({
@@ -2569,7 +2678,7 @@ function SignerView({
       let pdfBytes;
       if (includeAuditTrail) {
         const { PDFDocument: PDFDocument2, StandardFonts: StandardFonts2, rgb: rgb2 } = await import("pdf-lib");
-        const basePdf = await generateFilledPdf(pdfSource, finalFields);
+        const basePdf = await generateFilledPdf({ pdfSource, fields: finalFields });
         const pdfDoc = await PDFDocument2.load(basePdf);
         const font = await pdfDoc.embedFont(StandardFonts2.Helvetica);
         const boldFont = await pdfDoc.embedFont(StandardFonts2.HelveticaBold);
@@ -2586,7 +2695,7 @@ function SignerView({
         }
         pdfBytes = await pdfDoc.save();
       } else {
-        pdfBytes = await generateFilledPdf(pdfSource, finalFields);
+        pdfBytes = await generateFilledPdf({ pdfSource, fields: finalFields });
       }
       const blob = new Blob([pdfBytes.slice().buffer], { type: "application/pdf" });
       if (onExport && exportFormat) {
@@ -2694,9 +2803,9 @@ ${row.join(",")}`, "csv");
     );
   }, [signer, handleFieldUpdate, setSelectedFieldId]);
   (0, import_react7.useEffect)(() => {
-    const sigFields = fields.filter((f) => f.assignee === signer && f.type === "signature" && f.value);
-    if (sigFields.length > 0) {
-      const dateStr = (/* @__PURE__ */ new Date()).toLocaleDateString();
+    const dateStr = (/* @__PURE__ */ new Date()).toLocaleDateString();
+    const needsFill = fields.some((f) => f.assignee === signer && f.type === "signed-date" && !f.value);
+    if (needsFill) {
       setFields((prev) => prev.map((f) => {
         if (f.assignee === signer && f.type === "signed-date" && !f.value) {
           return { ...f, value: dateStr };
@@ -2704,7 +2813,7 @@ ${row.join(",")}`, "csv");
         return f;
       }));
     }
-  }, [fields.filter((f) => f.type === "signature" && f.value).length]);
+  }, [signer, fields.filter((f) => f.type === "signature" && f.value).length]);
   (0, import_react7.useEffect)(() => {
     const hasFormulas = fields.some((f) => f.formula);
     if (!hasFormulas) return;
@@ -2909,7 +3018,9 @@ function SignerRoleSelector({
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  A4,
   BUILTIN_TRANSFORMS,
+  DEFAULT_CALIBRATION,
   DEFAULT_SIGNER_ROLES,
   DesignerView,
   FIELD_DEFAULTS,
@@ -2921,7 +3032,11 @@ function SignerRoleSelector({
   SignatureCanvas,
   SignerRoleSelector,
   SignerView,
+  US_LEGAL,
+  US_LETTER,
+  applyCalibration,
   createField,
+  createPdfBuilder,
   downloadPdf,
   generateFilledPdf,
   generateId,