av6-pdf-engine 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -72,7 +72,7 @@ interface TableBlock extends BaseBlock {
     type: "table";
     headerRows?: number;
     widths: Width[];
-    body: TableCell[][];
+    body: TableCell[][] | TableBodyIterable[] | Array<TableCell[] | TableBodyIterable>;
     layout?: {
         border?: "all" | "none";
         hLineColor?: string;
@@ -83,6 +83,12 @@ interface TableBlock extends BaseBlock {
     marginBottom?: number;
     marginLeft?: number;
     marginRight?: number;
+    [key: string]: unknown;
+}
+interface TableBodyIterable {
+    isIterable: boolean;
+    iterableKey: string;
+    content: Array<TableCell>;
 }
 interface PlacedCell {
     cell: TableCell;
@@ -352,4 +358,4 @@ declare function toPdfEngineError(cause: unknown, fallback: {
 declare function renderCustomPdf(def: CustomDocDefinition, outputPath: string): Promise<void>;
 declare function renderCustomPdfToBuffer(def: CustomDocDefinition): Promise<Buffer>;
 
-export { type Alignment, BARCODE_TYPES, type BarcodeBlock, type BarcodeType, type BaseBlock, type Block, type BuiltInFont, type ColumnsBlock, type CustomDocDefinition, type FontName, type FontRegistration, type FooterDef, type FooterInput, type HeaderDef, type ImageBlock, type InlineTextStyle, type KeyValueGridBlock, type KeyValueItem, type LineBlock, type Orientation, type PDFDoc, type PageBackgroundDef, type PageBreakBlock, type PageContext, type PageMargins, PdfEngineError, PdfEngineErrorCode, type PlacedCell, type QRErrorLevel, QR_ERROR_LEVEL, type QrCodeBlock, type RenderEnv, type SignatureBlock, type StyleDef, type StyleRef, type TableBlock, type TableCell, type TextBlock, type WatermarkDef, type WatermarkMode, type Width, isPdfEngineError, renderCustomPdf, renderCustomPdfToBuffer, toPdfEngineError };
+export { type Alignment, BARCODE_TYPES, type BarcodeBlock, type BarcodeType, type BaseBlock, type Block, type BuiltInFont, type ColumnsBlock, type CustomDocDefinition, type FontName, type FontRegistration, type FooterDef, type FooterInput, type HeaderDef, type ImageBlock, type InlineTextStyle, type KeyValueGridBlock, type KeyValueItem, type LineBlock, type Orientation, type PDFDoc, type PageBackgroundDef, type PageBreakBlock, type PageContext, type PageMargins, PdfEngineError, PdfEngineErrorCode, type PlacedCell, type QRErrorLevel, QR_ERROR_LEVEL, type QrCodeBlock, type RenderEnv, type SignatureBlock, type StyleDef, type StyleRef, type TableBlock, type TableBodyIterable, type TableCell, type TextBlock, type WatermarkDef, type WatermarkMode, type Width, isPdfEngineError, renderCustomPdf, renderCustomPdfToBuffer, toPdfEngineError };

package/dist/index.d.ts

@@ -72,7 +72,7 @@ interface TableBlock extends BaseBlock {
     type: "table";
     headerRows?: number;
     widths: Width[];
-    body: TableCell[][];
+    body: TableCell[][] | TableBodyIterable[] | Array<TableCell[] | TableBodyIterable>;
     layout?: {
         border?: "all" | "none";
         hLineColor?: string;
@@ -83,6 +83,12 @@ interface TableBlock extends BaseBlock {
     marginBottom?: number;
     marginLeft?: number;
     marginRight?: number;
+    [key: string]: unknown;
+}
+interface TableBodyIterable {
+    isIterable: boolean;
+    iterableKey: string;
+    content: Array<TableCell>;
 }
 interface PlacedCell {
     cell: TableCell;
@@ -352,4 +358,4 @@ declare function toPdfEngineError(cause: unknown, fallback: {
 declare function renderCustomPdf(def: CustomDocDefinition, outputPath: string): Promise<void>;
 declare function renderCustomPdfToBuffer(def: CustomDocDefinition): Promise<Buffer>;
 
-export { type Alignment, BARCODE_TYPES, type BarcodeBlock, type BarcodeType, type BaseBlock, type Block, type BuiltInFont, type ColumnsBlock, type CustomDocDefinition, type FontName, type FontRegistration, type FooterDef, type FooterInput, type HeaderDef, type ImageBlock, type InlineTextStyle, type KeyValueGridBlock, type KeyValueItem, type LineBlock, type Orientation, type PDFDoc, type PageBackgroundDef, type PageBreakBlock, type PageContext, type PageMargins, PdfEngineError, PdfEngineErrorCode, type PlacedCell, type QRErrorLevel, QR_ERROR_LEVEL, type QrCodeBlock, type RenderEnv, type SignatureBlock, type StyleDef, type StyleRef, type TableBlock, type TableCell, type TextBlock, type WatermarkDef, type WatermarkMode, type Width, isPdfEngineError, renderCustomPdf, renderCustomPdfToBuffer, toPdfEngineError };
+export { type Alignment, BARCODE_TYPES, type BarcodeBlock, type BarcodeType, type BaseBlock, type Block, type BuiltInFont, type ColumnsBlock, type CustomDocDefinition, type FontName, type FontRegistration, type FooterDef, type FooterInput, type HeaderDef, type ImageBlock, type InlineTextStyle, type KeyValueGridBlock, type KeyValueItem, type LineBlock, type Orientation, type PDFDoc, type PageBackgroundDef, type PageBreakBlock, type PageContext, type PageMargins, PdfEngineError, PdfEngineErrorCode, type PlacedCell, type QRErrorLevel, QR_ERROR_LEVEL, type QrCodeBlock, type RenderEnv, type SignatureBlock, type StyleDef, type StyleRef, type TableBlock, type TableBodyIterable, type TableCell, type TextBlock, type WatermarkDef, type WatermarkMode, type Width, isPdfEngineError, renderCustomPdf, renderCustomPdfToBuffer, toPdfEngineError };

package/dist/index.js

@@ -576,17 +576,100 @@ var getPlacedCellWidth = (colWidths, startCol, colSpan) => {
 var getRowSpanGroupHeight = (rowHeights, rowIndex, rowSpan) => {
   return sum(rowHeights.slice(rowIndex, rowIndex + rowSpan));
 };
+var isTableBodyIterableEntry = (entry) => {
+  if (!entry || typeof entry !== "object") return false;
+  const row = entry;
+  return typeof row.isIterable === "boolean" && typeof row.iterableKey === "string" && Array.isArray(row.content);
+};
+var isTableCellInput = (rawBlock) => !("type" in rawBlock);
+var toTableCell = (rawBlock) => {
+  if ("type" in rawBlock && rawBlock.type !== "text") {
+    return null;
+  }
+  const tableCellInput = isTableCellInput(rawBlock) ? rawBlock : void 0;
+  return {
+    text: rawBlock.text,
+    italic: rawBlock.italic,
+    underline: rawBlock.underline,
+    link: rawBlock.link,
+    strike: rawBlock.strike,
+    bold: rawBlock.bold,
+    fontSize: rawBlock.fontSize,
+    font: rawBlock.font,
+    align: rawBlock.align,
+    color: rawBlock.color,
+    fillColor: tableCellInput?.fillColor,
+    style: rawBlock.style,
+    colSpan: tableCellInput?.colSpan,
+    rowSpan: tableCellInput?.rowSpan,
+    paddingTop: tableCellInput?.paddingTop,
+    paddingRight: tableCellInput?.paddingRight,
+    paddingBottom: tableCellInput?.paddingBottom,
+    paddingLeft: tableCellInput?.paddingLeft
+  };
+};
+var resolvePathValue = (obj, dottedPath) => {
+  if (!obj || typeof obj !== "object") return void 0;
+  return dottedPath.split(".").reduce((acc, key) => {
+    if (!acc || typeof acc !== "object") return void 0;
+    return acc[key];
+  }, obj);
+};
+var interpolateCellText = (text, item, rowIndex) => {
+  return text.replace(/\{\{\s*([^}]+)\s*\}\}/g, (_match, tokenRaw) => {
+    const token = tokenRaw.trim();
+    if (!token) return "";
+    if (token === "index") return String(rowIndex + 1);
+    const normalizedPath = token.startsWith("item.") ? token.slice(5) : token;
+    const value = resolvePathValue(item, normalizedPath);
+    if (value === void 0 || value === null) return "";
+    return typeof value === "string" ? value : String(value);
+  });
+};
+var applyIterableData = (cell, item, rowIndex) => ({
+  ...cell,
+  text: interpolateCellText(cell.text, item, rowIndex)
+});
+var expandIterableRow = (table, bodyDef) => {
+  const templateRow = bodyDef.content.map(toTableCell).filter((cell) => cell !== null);
+  if (!templateRow.length) {
+    return [];
+  }
+  if (!bodyDef.isIterable) {
+    return [templateRow];
+  }
+  const iterableSource = table[bodyDef.iterableKey];
+  if (!Array.isArray(iterableSource) || !iterableSource.length) {
+    return [templateRow];
+  }
+  return iterableSource.map((item, rowIndex) => templateRow.map((cell) => applyIterableData(cell, item, rowIndex)));
+};
+var normalizeTableRows = (table) => {
+  if (!Array.isArray(table.body)) return [];
+  const rows = [];
+  for (const entry of table.body) {
+    if (Array.isArray(entry)) {
+      rows.push(entry);
+      continue;
+    }
+    if (isTableBodyIterableEntry(entry)) {
+      rows.push(...expandIterableRow(table, entry));
+    }
+  }
+  return rows;
+};
 var measureTableHeight = (doc, table, env, styles, computeColumnPixelWidths2) => {
   const localLeft = table.marginLeft ?? 0;
   const localRight = table.marginRight ?? 0;
   const width = Math.max(env.innerWidth - localLeft - localRight, 1);
+  const rows = normalizeTableRows(table);
   const totalCols = table.widths.length;
   const colWidths = computeColumnPixelWidths2(table.widths, width);
   const rowHeights = [];
   const activeRowSpans = Array(totalCols).fill(0);
   const placedRows = [];
-  for (let rowIndex = 0; rowIndex < table.body.length; rowIndex++) {
-    const row = table.body[rowIndex];
+  for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
+    const row = rows[rowIndex];
     const placedRow = buildPlacedRow(row, totalCols, activeRowSpans);
     placedRows.push(placedRow);
     let rowHeight = 12;
@@ -652,12 +735,13 @@ var processTableBlock = (doc, ctx, styles, table, y, env, computeColumnPixelWidt
   };
   const borderAll = layout.border !== "none";
   const headerRows = table.headerRows ?? 0;
-  const buildPlacementAndHeights = (rows) => {
+  const rows = normalizeTableRows(table);
+  const buildPlacementAndHeights = (rows2) => {
     const placedRows = [];
     const rowHeights = [];
     const activeRowSpans = Array(totalCols).fill(0);
-    for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
-      const row = rows[rowIndex];
+    for (let rowIndex = 0; rowIndex < rows2.length; rowIndex++) {
+      const row = rows2[rowIndex];
       const placedRow = buildPlacedRow(row, totalCols, activeRowSpans);
       placedRows.push(placedRow);
       let rowHeight = 12;
@@ -700,7 +784,7 @@ var processTableBlock = (doc, ctx, styles, table, y, env, computeColumnPixelWidt
     }
     return { placedRows, rowHeights };
   };
-  const allLayout = buildPlacementAndHeights(table.body);
+  const allLayout = buildPlacementAndHeights(rows);
   const drawPlacedRow = (placedRow, rowTop2, rowHeight, rowIndex, rowHeights, isHeaderRow, drawTopBorder) => {
     placedRow.forEach(({ cell: rawCell, startCol, colSpan, rowSpan }) => {
       const cell = resolveTableCell(styles, rawCell);
@@ -757,7 +841,7 @@ var processTableBlock = (doc, ctx, styles, table, y, env, computeColumnPixelWidt
     });
     return rowTop2 + rowHeight;
   };
-  const headerRowsSource = table.body.slice(0, headerRows);
+  const headerRowsSource = rows.slice(0, headerRows);
   const drawHeaderRowsOnNewPage = () => {
     if (!headerRows) return doc.page.margins.top + mt;
     const headerLayout = buildPlacementAndHeights(headerRowsSource);
@@ -776,7 +860,7 @@ var processTableBlock = (doc, ctx, styles, table, y, env, computeColumnPixelWidt
     return rowTop2;
   };
   let rowTop = startY;
-  for (let rowIndex = 0; rowIndex < table.body.length; rowIndex++) {
+  for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
     const isHeaderRow = rowIndex < headerRows;
     const placedRow = allLayout.placedRows[rowIndex];
     const rowHeight = allLayout.rowHeights[rowIndex];

package/dist/index.mjs

@@ -533,17 +533,100 @@ var getPlacedCellWidth = (colWidths, startCol, colSpan) => {
 var getRowSpanGroupHeight = (rowHeights, rowIndex, rowSpan) => {
   return sum(rowHeights.slice(rowIndex, rowIndex + rowSpan));
 };
+var isTableBodyIterableEntry = (entry) => {
+  if (!entry || typeof entry !== "object") return false;
+  const row = entry;
+  return typeof row.isIterable === "boolean" && typeof row.iterableKey === "string" && Array.isArray(row.content);
+};
+var isTableCellInput = (rawBlock) => !("type" in rawBlock);
+var toTableCell = (rawBlock) => {
+  if ("type" in rawBlock && rawBlock.type !== "text") {
+    return null;
+  }
+  const tableCellInput = isTableCellInput(rawBlock) ? rawBlock : void 0;
+  return {
+    text: rawBlock.text,
+    italic: rawBlock.italic,
+    underline: rawBlock.underline,
+    link: rawBlock.link,
+    strike: rawBlock.strike,
+    bold: rawBlock.bold,
+    fontSize: rawBlock.fontSize,
+    font: rawBlock.font,
+    align: rawBlock.align,
+    color: rawBlock.color,
+    fillColor: tableCellInput?.fillColor,
+    style: rawBlock.style,
+    colSpan: tableCellInput?.colSpan,
+    rowSpan: tableCellInput?.rowSpan,
+    paddingTop: tableCellInput?.paddingTop,
+    paddingRight: tableCellInput?.paddingRight,
+    paddingBottom: tableCellInput?.paddingBottom,
+    paddingLeft: tableCellInput?.paddingLeft
+  };
+};
+var resolvePathValue = (obj, dottedPath) => {
+  if (!obj || typeof obj !== "object") return void 0;
+  return dottedPath.split(".").reduce((acc, key) => {
+    if (!acc || typeof acc !== "object") return void 0;
+    return acc[key];
+  }, obj);
+};
+var interpolateCellText = (text, item, rowIndex) => {
+  return text.replace(/\{\{\s*([^}]+)\s*\}\}/g, (_match, tokenRaw) => {
+    const token = tokenRaw.trim();
+    if (!token) return "";
+    if (token === "index") return String(rowIndex + 1);
+    const normalizedPath = token.startsWith("item.") ? token.slice(5) : token;
+    const value = resolvePathValue(item, normalizedPath);
+    if (value === void 0 || value === null) return "";
+    return typeof value === "string" ? value : String(value);
+  });
+};
+var applyIterableData = (cell, item, rowIndex) => ({
+  ...cell,
+  text: interpolateCellText(cell.text, item, rowIndex)
+});
+var expandIterableRow = (table, bodyDef) => {
+  const templateRow = bodyDef.content.map(toTableCell).filter((cell) => cell !== null);
+  if (!templateRow.length) {
+    return [];
+  }
+  if (!bodyDef.isIterable) {
+    return [templateRow];
+  }
+  const iterableSource = table[bodyDef.iterableKey];
+  if (!Array.isArray(iterableSource) || !iterableSource.length) {
+    return [templateRow];
+  }
+  return iterableSource.map((item, rowIndex) => templateRow.map((cell) => applyIterableData(cell, item, rowIndex)));
+};
+var normalizeTableRows = (table) => {
+  if (!Array.isArray(table.body)) return [];
+  const rows = [];
+  for (const entry of table.body) {
+    if (Array.isArray(entry)) {
+      rows.push(entry);
+      continue;
+    }
+    if (isTableBodyIterableEntry(entry)) {
+      rows.push(...expandIterableRow(table, entry));
+    }
+  }
+  return rows;
+};
 var measureTableHeight = (doc, table, env, styles, computeColumnPixelWidths2) => {
   const localLeft = table.marginLeft ?? 0;
   const localRight = table.marginRight ?? 0;
   const width = Math.max(env.innerWidth - localLeft - localRight, 1);
+  const rows = normalizeTableRows(table);
   const totalCols = table.widths.length;
   const colWidths = computeColumnPixelWidths2(table.widths, width);
   const rowHeights = [];
   const activeRowSpans = Array(totalCols).fill(0);
   const placedRows = [];
-  for (let rowIndex = 0; rowIndex < table.body.length; rowIndex++) {
-    const row = table.body[rowIndex];
+  for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
+    const row = rows[rowIndex];
     const placedRow = buildPlacedRow(row, totalCols, activeRowSpans);
     placedRows.push(placedRow);
     let rowHeight = 12;
@@ -609,12 +692,13 @@ var processTableBlock = (doc, ctx, styles, table, y, env, computeColumnPixelWidt
   };
   const borderAll = layout.border !== "none";
   const headerRows = table.headerRows ?? 0;
-  const buildPlacementAndHeights = (rows) => {
+  const rows = normalizeTableRows(table);
+  const buildPlacementAndHeights = (rows2) => {
     const placedRows = [];
     const rowHeights = [];
     const activeRowSpans = Array(totalCols).fill(0);
-    for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
-      const row = rows[rowIndex];
+    for (let rowIndex = 0; rowIndex < rows2.length; rowIndex++) {
+      const row = rows2[rowIndex];
       const placedRow = buildPlacedRow(row, totalCols, activeRowSpans);
       placedRows.push(placedRow);
       let rowHeight = 12;
@@ -657,7 +741,7 @@ var processTableBlock = (doc, ctx, styles, table, y, env, computeColumnPixelWidt
     }
     return { placedRows, rowHeights };
   };
-  const allLayout = buildPlacementAndHeights(table.body);
+  const allLayout = buildPlacementAndHeights(rows);
   const drawPlacedRow = (placedRow, rowTop2, rowHeight, rowIndex, rowHeights, isHeaderRow, drawTopBorder) => {
     placedRow.forEach(({ cell: rawCell, startCol, colSpan, rowSpan }) => {
       const cell = resolveTableCell(styles, rawCell);
@@ -714,7 +798,7 @@ var processTableBlock = (doc, ctx, styles, table, y, env, computeColumnPixelWidt
     });
     return rowTop2 + rowHeight;
   };
-  const headerRowsSource = table.body.slice(0, headerRows);
+  const headerRowsSource = rows.slice(0, headerRows);
   const drawHeaderRowsOnNewPage = () => {
     if (!headerRows) return doc.page.margins.top + mt;
     const headerLayout = buildPlacementAndHeights(headerRowsSource);
@@ -733,7 +817,7 @@ var processTableBlock = (doc, ctx, styles, table, y, env, computeColumnPixelWidt
     return rowTop2;
   };
   let rowTop = startY;
-  for (let rowIndex = 0; rowIndex < table.body.length; rowIndex++) {
+  for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
     const isHeaderRow = rowIndex < headerRows;
     const placedRow = allLayout.placedRows[rowIndex];
     const rowHeight = allLayout.rowHeights[rowIndex];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "av6-pdf-engine",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "module": "dist/index.mjs",