@masumdev/markforge 0.2.5 → 0.3.0

package/dist/index.mjs

@@ -1347,6 +1347,67 @@ function normalizeHeaderFooter(raw, meta) {
     dividerColor: raw.dividerColor || "#E2E8F0"
   };
 }
+function normalizeSignatures(raw, meta = {}) {
+  if (!raw) return void 0;
+  let rawItems = [];
+  let rawConfig = {};
+  if (Array.isArray(raw)) {
+    rawItems = raw;
+  } else if (typeof raw === "object" && Array.isArray(raw.items)) {
+    rawItems = raw.items;
+    rawConfig = raw;
+  }
+  if (rawItems.length === 0) return void 0;
+  const cappedItems = rawItems.slice(0, 4);
+  const items = cappedItems.map((item) => {
+    const tokenCtx = meta;
+    const rawName = typeof item.name === "string" ? item.name : "";
+    const name = replaceDocumentTokens(rawName, tokenCtx).trim();
+    const title = item.title ? replaceDocumentTokens(item.title, tokenCtx).trim() : void 0;
+    const role = item.role ? replaceDocumentTokens(item.role, tokenCtx).trim() : void 0;
+    let dateStr;
+    if (typeof item.date === "string") {
+      dateStr = replaceDocumentTokens(item.date, tokenCtx).trim();
+    } else if (item.date === true) {
+      dateStr = meta.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    }
+    let signatureHeight = 60;
+    if (typeof item.signatureHeight === "number") {
+      signatureHeight = item.signatureHeight;
+    } else if (typeof item.signatureHeight === "string") {
+      const parsed = parseFloat(item.signatureHeight);
+      if (!isNaN(parsed)) signatureHeight = parsed;
+    }
+    return {
+      title,
+      name: name || "Authorized Signatory",
+      role,
+      date: dateStr,
+      image: item.image,
+      signatureHeight
+    };
+  });
+  const align = rawConfig.align || (items.length === 1 ? "right" : "space-between");
+  const style = rawConfig.style || "line";
+  const borderColor = rawConfig.borderColor || "#CBD5E1";
+  const titleColor = rawConfig.titleColor || "#64748B";
+  const nameColor = rawConfig.nameColor || "#0F172A";
+  const roleColor = rawConfig.roleColor || "#64748B";
+  const spacingBeforeRaw = rawConfig.spacingBefore ?? "2.5rem";
+  const spacingBefore = formatMarginCss(spacingBeforeRaw, "2.5rem");
+  const spacingBeforeTwip = parseMarginToTwip(spacingBeforeRaw, 600);
+  return {
+    items,
+    align,
+    style,
+    borderColor,
+    titleColor,
+    nameColor,
+    roleColor,
+    spacingBefore,
+    spacingBeforeTwip
+  };
+}
 function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
   const configMeta = userConfig.metadata || {};
   const mergedMeta = { ...configMeta, ...frontmatter };
@@ -1387,6 +1448,8 @@ function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
   const toc = typeof mergedMeta.toc === "boolean" ? mergedMeta.toc : typeof userConfig.toc === "boolean" ? userConfig.toc : DEFAULT_CONFIG.toc;
   const rawWatermark = mergedMeta.watermark !== void 0 ? mergedMeta.watermark : userConfig.watermark !== void 0 ? userConfig.watermark : DEFAULT_CONFIG.watermark;
   const watermark = normalizeWatermark(rawWatermark);
+  const rawSignatures = mergedMeta.signatures || userConfig.signatures;
+  const signatures = normalizeSignatures(rawSignatures, tokenContext);
   const cssList = [];
   const addCss = (item) => {
     if (!item) return;
@@ -1414,6 +1477,7 @@ function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
     header,
     footer,
     toc,
+    signatures,
     watermark,
     css: cssList,
     embedImages,
@@ -1636,26 +1700,160 @@ ${escapeHtml(node.text || "")}
     watermarkCss = `
   .document-watermark {
     position: fixed;
-    top: 50%;
-    left: 50%;
-    transform: translate(-50%, -50%) rotate(${wm.rotate}deg);
-    font-size: ${wm.fontSize}pt;
-    font-weight: 900;
-    color: ${wm.color};
-    opacity: ${wm.opacity};
+    top: 0;
+    left: 0;
+    width: 100vw;
+    height: 100vh;
     pointer-events: none;
     z-index: 0;
     user-select: none;
-    text-transform: uppercase;
-    letter-spacing: 0.15em;
-    white-space: nowrap;
+    -webkit-user-select: none;
   }
   .document-container {
     position: relative;
     z-index: 1;
   }
+  @media print {
+    .document-watermark {
+      position: fixed;
+      top: 0;
+      left: 0;
+      width: 100vw;
+      height: 100vh;
+      -webkit-print-color-adjust: exact;
+      print-color-adjust: exact;
+    }
+  }
+  `;
+    watermarkHtml = `  <div id="markforge-watermark" class="document-watermark" aria-hidden="true"></div>
+  <script>
+  (function() {
+    try {
+      var canvas = document.createElement('canvas');
+      var dpr = 3;
+      var width = 800;
+      var height = 1100;
+      canvas.width = Math.round(width * dpr);
+      canvas.height = Math.round(height * dpr);
+      var ctx = canvas.getContext('2d');
+      if (ctx) {
+        ctx.scale(dpr, dpr);
+        ctx.translate(width / 2, height / 2);
+        ctx.rotate((${wm.rotate} * Math.PI) / 180);
+        ctx.textAlign = 'center';
+        ctx.textBaseline = 'middle';
+        ctx.font = '900 ${wm.fontSize * 1.5}px system-ui, -apple-system, sans-serif';
+        ctx.fillStyle = '${wm.color}';
+        ctx.globalAlpha = ${wm.opacity};
+        try { ctx.letterSpacing = '0.15em'; } catch(e) {}
+        ctx.fillText(${JSON.stringify(wm.text.toUpperCase())}, 0, 0);
+        var dataUrl = canvas.toDataURL('image/png');
+        var wmEl = document.getElementById('markforge-watermark');
+        if (wmEl) {
+          wmEl.style.backgroundImage = 'url("' + dataUrl + '")';
+          wmEl.style.backgroundRepeat = 'no-repeat';
+          wmEl.style.backgroundPosition = 'center center';
+          wmEl.style.backgroundSize = 'contain';
+        }
+      }
+    } catch(err) {}
+  })();
+  </script>
+`;
+  }
+  let signaturesHtml = "";
+  let signaturesCss = "";
+  if (resolved.signatures && resolved.signatures.items.length > 0) {
+    const sig = resolved.signatures;
+    const numItems = sig.items.length;
+    let justifyCss = "flex-end";
+    if (sig.align === "left") justifyCss = "flex-start";
+    else if (sig.align === "center") justifyCss = "center";
+    else if (sig.align === "space-between") justifyCss = "space-between";
+    signaturesCss = `
+  .markforge-signatures {
+    margin-top: ${sig.spacingBefore};
+    display: grid;
+    grid-template-columns: ${numItems === 1 ? sig.align === "left" ? "minmax(200px, 280px) 1fr" : sig.align === "center" ? "1fr minmax(200px, 280px) 1fr" : "1fr minmax(200px, 280px)" : `repeat(${numItems}, minmax(0, 1fr))`};
+    gap: 2rem;
+    page-break-inside: avoid;
+    break-inside: avoid;
+  }
+  .markforge-signature-card {
+    ${numItems === 1 && sig.align === "center" ? "grid-column: 2;" : ""}
+    ${numItems === 1 && sig.align === "right" ? "grid-column: 2;" : ""}
+    display: flex;
+    flex-direction: column;
+    ${sig.style === "box" ? `border: 1px solid ${sig.borderColor}; border-radius: 6px; padding: 14px 18px; background-color: var(--mf-card-bg, #F8FAFC);` : ""}
+  }
+  .markforge-sig-title {
+    font-size: 0.85rem;
+    color: ${sig.titleColor};
+    font-weight: 600;
+    margin-bottom: 6px;
+  }
+  .markforge-sig-space {
+    height: var(--sig-height, 60px);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    margin-bottom: 6px;
+  }
+  .markforge-sig-space img {
+    max-height: 100%;
+    max-width: 100%;
+    object-fit: contain;
+  }
+  .markforge-sig-line {
+    ${sig.style === "line" ? `border-bottom: 1.5px solid ${sig.borderColor}; margin-bottom: 8px;` : ""}
+  }
+  .markforge-sig-name {
+    font-size: 0.95rem;
+    font-weight: 700;
+    color: ${sig.nameColor};
+  }
+  .markforge-sig-role {
+    font-size: 0.82rem;
+    color: ${sig.roleColor};
+    margin-top: 2px;
+  }
+  .markforge-sig-date {
+    font-size: 0.78rem;
+    color: ${sig.roleColor};
+    margin-top: 2px;
+  }
+  @media print {
+    .markforge-signatures {
+      page-break-inside: avoid;
+      break-inside: avoid;
+    }
+  }
   `;
-    watermarkHtml = `  <div class="document-watermark">${escapeHtml(wm.text)}</div>
+    const itemCards = sig.items.map((item) => {
+      const titleHtml = item.title ? `<div class="markforge-sig-title">${escapeHtml(item.title)}</div>` : "";
+      let signSpaceHtml = "";
+      if (item.image) {
+        signSpaceHtml = `<div class="markforge-sig-space" style="--sig-height: ${item.signatureHeight}px;"><img src="${escapeHtml(item.image)}" alt="Signature" /></div>`;
+      } else {
+        signSpaceHtml = `<div class="markforge-sig-space" style="--sig-height: ${item.signatureHeight}px;"></div>`;
+      }
+      const lineHtml = sig.style === "line" ? `<div class="markforge-sig-line"></div>` : "";
+      const nameHtml = `<div class="markforge-sig-name">${escapeHtml(item.name)}</div>`;
+      const roleHtml = item.role ? `<div class="markforge-sig-role">${escapeHtml(item.role)}</div>` : "";
+      const dateHtml = item.date ? `<div class="markforge-sig-date">Date: ${escapeHtml(item.date)}</div>` : "";
+      return `    <div class="markforge-signature-card">
+      ${titleHtml}
+      ${signSpaceHtml}
+      ${lineHtml}
+      ${nameHtml}
+      ${roleHtml}
+      ${dateHtml}
+    </div>`;
+    }).join("\n");
+    signaturesHtml = `
+  <div class="markforge-signatures">
+${itemCards}
+  </div>
 `;
   }
   const hasMermaid = doc.nodes.some((n) => n.type === "mermaid");
@@ -1686,11 +1884,12 @@ ${baseThemeCss}
 ${customCss}
 ${inlinedCss}
 ${watermarkCss}
+${signaturesCss}
   </style>
 </head>
 <body>
 ${watermarkHtml}  <div class="document-container">
-${bodyHtml}  </div>
+${bodyHtml}${signaturesHtml}  </div>
   ${mermaidScript}
 </body>
 </html>`;
@@ -2778,6 +2977,59 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
       continue;
     }
   }
+  if (resolved.signatures && resolved.signatures.items.length > 0) {
+    const sig = resolved.signatures;
+    const numItems = sig.items.length;
+    const contentWidth = Math.max(
+      1e3,
+      resolved.paperDimensions.widthTwip - resolved.margins.leftTwip - resolved.margins.rightTwip
+    );
+    docElements.push(new Paragraph({ spacing: { before: sig.spacingBeforeTwip } }));
+    const sigCells = [];
+    const colWidths = [];
+    if (numItems === 1) {
+      const cardWidth = Math.min(3400, Math.floor(contentWidth * 0.42));
+      const spacerWidth = contentWidth - cardWidth;
+      const cardCell = await buildDocxSignatureCell(sig.items[0], sig, cardWidth, defaultFont, baseDir);
+      if (sig.align === "left") {
+        colWidths.push(cardWidth, spacerWidth);
+        sigCells.push(cardCell, createEmptyDocxCell(spacerWidth));
+      } else if (sig.align === "center") {
+        const sideWidth = Math.floor(spacerWidth / 2);
+        colWidths.push(sideWidth, cardWidth, sideWidth);
+        sigCells.push(createEmptyDocxCell(sideWidth), cardCell, createEmptyDocxCell(sideWidth));
+      } else {
+        colWidths.push(spacerWidth, cardWidth);
+        sigCells.push(createEmptyDocxCell(spacerWidth), cardCell);
+      }
+    } else {
+      const colWidth = Math.floor(contentWidth / numItems);
+      for (let i = 0; i < numItems; i++) {
+        colWidths.push(colWidth);
+        const cell = await buildDocxSignatureCell(sig.items[i], sig, colWidth, defaultFont, baseDir);
+        sigCells.push(cell);
+      }
+    }
+    const sigTable = new Table({
+      width: { size: 100, type: WidthType.PERCENTAGE },
+      columnWidths: colWidths,
+      borders: {
+        top: { style: BorderStyle.NONE, size: 0, color: "auto" },
+        bottom: { style: BorderStyle.NONE, size: 0, color: "auto" },
+        left: { style: BorderStyle.NONE, size: 0, color: "auto" },
+        right: { style: BorderStyle.NONE, size: 0, color: "auto" },
+        insideHorizontal: { style: BorderStyle.NONE, size: 0, color: "auto" },
+        insideVertical: { style: BorderStyle.NONE, size: 0, color: "auto" }
+      },
+      rows: [
+        new TableRow({
+          cantSplit: true,
+          children: sigCells
+        })
+      ]
+    });
+    docElements.push(sigTable);
+  }
   const contentWidthTwip = Math.max(
     1e3,
     resolved.paperDimensions.widthTwip - resolved.margins.leftTwip - resolved.margins.rightTwip
@@ -3008,6 +3260,140 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
   });
   return await Packer.toBuffer(document);
 }
+async function buildDocxSignatureCell(item, sig, widthDxa, defaultFont, baseDir) {
+  const cellParagraphs = [];
+  if (item.title) {
+    cellParagraphs.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: item.title,
+            font: defaultFont,
+            size: 18,
+            // 9pt
+            color: sig.titleColor.replace("#", ""),
+            bold: true
+          })
+        ],
+        spacing: { after: 60 }
+      })
+    );
+  }
+  if (item.image) {
+    const resolvedImg = await resolveImage(item.image, baseDir);
+    if (resolvedImg) {
+      cellParagraphs.push(
+        new Paragraph({
+          children: [
+            new ImageRun({
+              data: resolvedImg.buffer,
+              transformation: {
+                width: 140,
+                height: 60
+              },
+              type: "png"
+            })
+          ],
+          spacing: { before: 40, after: 40 }
+        })
+      );
+    } else {
+      cellParagraphs.push(new Paragraph({ spacing: { before: 240, after: 240 } }));
+    }
+  } else {
+    cellParagraphs.push(new Paragraph({ spacing: { before: 240, after: 240 } }));
+  }
+  if (sig.style === "line") {
+    cellParagraphs.push(
+      new Paragraph({
+        border: {
+          bottom: {
+            style: BorderStyle.SINGLE,
+            size: 6,
+            space: 2,
+            color: sig.borderColor.replace("#", "")
+          }
+        },
+        spacing: { after: 60 }
+      })
+    );
+  }
+  cellParagraphs.push(
+    new Paragraph({
+      children: [
+        new TextRun({
+          text: item.name,
+          font: defaultFont,
+          size: 21,
+          // 10.5pt
+          bold: true,
+          color: sig.nameColor.replace("#", "")
+        })
+      ],
+      spacing: { before: sig.style === "line" ? 40 : 20, after: 20 }
+    })
+  );
+  if (item.role) {
+    cellParagraphs.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: item.role,
+            font: defaultFont,
+            size: 18,
+            // 9pt
+            color: sig.roleColor.replace("#", "")
+          })
+        ],
+        spacing: { after: 20 }
+      })
+    );
+  }
+  if (item.date) {
+    cellParagraphs.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: `Date: ${item.date}`,
+            font: defaultFont,
+            size: 17,
+            // 8.5pt
+            color: sig.roleColor.replace("#", "")
+          })
+        ],
+        spacing: { after: 20 }
+      })
+    );
+  }
+  const isBox = sig.style === "box";
+  const boxBorder = { style: BorderStyle.SINGLE, size: 4, color: sig.borderColor.replace("#", "") };
+  const noneBorder = { style: BorderStyle.NONE, size: 0, color: "auto" };
+  return new TableCell({
+    width: { size: widthDxa, type: WidthType.DXA },
+    shading: isBox ? { fill: "F8FAFC", type: ShadingType.CLEAR } : void 0,
+    margins: isBox ? { top: 140, bottom: 140, left: 160, right: 160 } : { top: 60, bottom: 60, left: 60, right: 60 },
+    borders: {
+      top: isBox ? boxBorder : noneBorder,
+      bottom: isBox ? boxBorder : noneBorder,
+      left: isBox ? boxBorder : noneBorder,
+      right: isBox ? boxBorder : noneBorder
+    },
+    children: cellParagraphs
+  });
+}
+function createEmptyDocxCell(widthDxa) {
+  const noneBorder = { style: BorderStyle.NONE, size: 0, color: "auto" };
+  return new TableCell({
+    width: { size: widthDxa, type: WidthType.DXA },
+    borders: {
+      top: noneBorder,
+      bottom: noneBorder,
+      left: noneBorder,
+      right: noneBorder
+    },
+    children: [new Paragraph({})]
+  });
+}
 
 // src/core/engine.ts
 function formatServerTimestamp(date = /* @__PURE__ */ new Date()) {
@@ -3130,7 +3516,7 @@ try {
   }
 } catch {
 }
-var FALLBACK_VERSION = "0.2.2";
+var FALLBACK_VERSION = "0.3.0";
 function readVersionFromPackageJson(fromDir) {
   let currentDir = fromDir;
   for (let i = 0; i < 6; i++) {
@@ -3196,6 +3582,7 @@ export {
   compileMarkdown as markforge,
   normalizeHeaderFooter,
   normalizeHeaderFooterSlot,
+  normalizeSignatures,
   normalizeWatermark,
   parseInlineSpans,
   parseMarginToTwip2 as parseMarginToTwip,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masumdev/markforge",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Modern, high-performance Markdown & MDX multi-format document publishing engine and CLI (DOCX, PDF, HTML, and Images) with embedded HTML/CSS, image inliner, and Ink terminal UI.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",