@vyaz/core 0.1.0 → 0.4.0

package/README.md

@@ -46,6 +46,8 @@ console.log(result.lines);
 - **Writing modes** — `horizontal-tb`, `vertical-rl`, `vertical-lr` with text orientation
 - **Auto-fit** — scale text proportionally to fit the container (`AutofitConfig`)
 - **Inline widgets** — embedded objects (icons, images) inside the text flow
+- **`TextRun.data`** — an open-ended metadata bag the layout engine never interprets, for cross-cutting features like a hyperlink's `href` (see `@vyaz/converters`/`@vyaz/renderer`)
+- **Tables** — `TableFrame` grid layout: measured column widths/row heights, `colSpan`/`rowSpan`, per-side borders (solid, dashed, rounded corners), `before`/`after` decorative slots, nested tables
 - **Office-compatible mode** — `mode: 'office'` for PowerPoint/DrawingML rendering
 - **Font metrics** — system font registry with fontkit-based metric extraction
 - **Compiler** — paragraph compilation with token preparation for external renderers
@@ -78,6 +80,40 @@ const result: TextFrameLayoutResult = layoutTextFrame(frame);
 // → { lines: Line[], frameWidth?, frameHeight?, contentWidth, contentHeight, fitHorizontal, fitVertical }
 ```
 
+### Tables
+
+```ts
+import { layoutTableFrame } from '@vyaz/core';
+import type { TableFrame, TableLayoutResult } from '@vyaz/core';
+
+const cell = (text: string) => ({
+  content: {
+    wrap: true,
+    paragraphs: [{
+      style: { alignment: 'left', lineHeight: 1.3, spaceBefore: 0, spaceAfter: 0 },
+      children: [{ type: 'text', text, fontFamily: 'Arial', fontSize: 14, fontWeight: 'normal', fontStyle: 'normal', color: '#000' }],
+    }],
+  },
+});
+
+const table: TableFrame = {
+  defaultCellStyle: { paddings: 8, borderWidths: 1, borderColors: '#ccc' },
+  rows: [
+    { style: { bgColor: '#eee' }, cells: [cell('Name'), cell('Qty')] },
+    { cells: [cell('Widget'), cell('3')] },
+  ],
+};
+
+const result: TableLayoutResult = layoutTableFrame(table);
+// → { width, height, contentBox, rows: [{ y, height, cells: [{ x, y, width, height, content, ... }] }] }
+```
+
+Column widths and row heights are *measured* from cell content unless
+`columnWidths`/`rowHeights`/`width`/`height` override them. A cell's
+`content` can itself be a `TableFrame` (nested tables). `@vyaz/renderer`'s
+`renderTableToSVG` paints the result — see its README, or the
+[Tables guide](https://sedrew.github.io/vyaz/guide/tables).
+
 ### Autofit
 
 ```ts

package/dist/index.browser.d.ts

@@ -19,8 +19,10 @@ export { groupLinesByParagraph } from './utils/groupLinesByParagraph.js';
 export { layoutTextFrame } from './layout/TextFrameLayoutEngine.js';
 export { createLayoutEngine } from './layout/create-engine.js';
 export type { LayoutEngine, LayoutEngineOptions } from './layout/create-engine.js';
-export type { LayoutOptions, TextFrameLayoutResult, AutofitOutcome } from './layout/TextFrameLayoutEngine.js';
+export type { LayoutOptions, TextFrameLayoutResult, AutofitOutcome, FrameTransform } from './layout/TextFrameLayoutEngine.js';
 export type { OnMissingFont } from './layout/resolve-font.js';
+export { layoutTableFrame } from './layout/TableLayoutEngine.js';
+export type { TableLayoutResult, TableRowLayoutResult, TableCellLayoutResult, TableLayoutOptions, ResolvedBorder } from './layout/TableLayoutEngine.js';
 export { applyScale, findScale } from './layout/AutoFitEngine.js';
 export { compileParagraph, getParagraphText, makeFontToken, collapseSegmentWhitespace, splitParagraphByHardBreaks } from './compile/ParagraphCompiler.js';
 export { FontMetricsProvider, fontMetricsProvider } from './measure/FontMetricsProvider.js';

package/dist/index.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEjG,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAI9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC9G,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAG1J,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAChI,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACrG,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAOnE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnE,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,EAAE,cAA4B,CAAC;AACnE,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAe,CAAC;AAEhE,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAc,CAAC;AACpE,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEjG,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAI9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC9H,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGxJ,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAG1J,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAChI,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACrG,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAOnE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnE,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,EAAE,cAA4B,CAAC;AACnE,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAe,CAAC;AAEhE,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAc,CAAC;AACpE,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.browser.js

@@ -20055,7 +20055,7 @@ function positionLines(pretextLines, items, fontMetricsFn, style, maxWidth, star
     const indent = isFirstLine ? effectiveLeftIndent + (style.indent || 0) : effectiveLeftIndent;
     const rightIndent = style.rightIndent || 0;
     const availableWidth = maxWidth - indent - rightIndent;
-    const slack = Math.max(0, availableWidth - effectiveLineWidth);
+    const slack = Number.isFinite(availableWidth) ? Math.max(0, availableWidth - effectiveLineWidth) : 0;
     let xOffset = indent;
     if (style.alignment === "center") {
       xOffset = indent + slack / 2;
@@ -22776,7 +22776,16 @@ setProfileChangeHook(clearMeasurementCaches);
 function glyphCacheKey(text, fontSize, fontFamily, fontWeight, fontStyle) {
   return `${fontSize}_${fontFamily || ""}_${fontWeight || ""}_${fontStyle || ""}_${text}`;
 }
+function inlineWidgetMetrics(iw, fontSize) {
+  const bo = iw.baselineOffset ?? 0;
+  const ascent = Math.max(0, iw.height - bo);
+  const descent = Math.max(0, bo);
+  return { ascent, descent, capHeight: ascent, unitsPerEm: fontSize || 1, sourceTable: "fallback" };
+}
 function getFontMetricsForItem(item, mode) {
+  if (item.metadata.inlineWidget) {
+    return inlineWidgetMetrics(item.metadata.inlineWidget, item.metadata.effectiveFontSize);
+  }
   return fontMetricsProvider.getMetrics(item.metadata.style.fontFamily, item.metadata.effectiveFontSize, String(item.metadata.style.fontWeight || 400), item.metadata.style.fontStyle || "normal", mode);
 }
 function preparedCacheKey(paragraph) {
@@ -22864,6 +22873,9 @@ class ParagraphLayoutEngine {
       return Math.round(total * 100) / 100;
     };
     const { lines, contentWidth } = positionLines(materializedLines, items, (item) => {
+      if (item.metadata.inlineWidget) {
+        return inlineWidgetMetrics(item.metadata.inlineWidget, item.metadata.effectiveFontSize);
+      }
       if (fontProvider) {
         return fontProvider.getMetrics(item.metadata.style.fontFamily, item.metadata.effectiveFontSize, String(item.metadata.style.fontWeight || 400), item.metadata.style.fontStyle || "normal", renderMode);
       }
@@ -22978,6 +22990,10 @@ function findScale(doc, layoutFn, config, options) {
 }
 
 // src/layout/TextFrameLayoutEngine.ts
+function normalizeDeg(d) {
+  const r = d % 360;
+  return r < 0 ? r + 360 : r;
+}
 function getMarkerTextHelper(listStyle, listIndex) {
   if (listStyle.type === "bullet") {
     return listStyle.bulletChar ?? defaultBulletChar(listStyle.level ?? 0);
@@ -23038,11 +23054,13 @@ function runFlow(frame, options, engine) {
   const mode = options.mode;
   const onMissingFont = options.onMissingFont ?? "throw";
   const warnings = [];
+  const writingMode = frame.writingMode ?? "horizontal-tb";
+  const sideways = writingMode === "sideways-rl" || writingMode === "sideways-lr";
   const leftPad = frame.padding?.left ?? 0;
   const rightPad = frame.padding?.right ?? 0;
   const topPad = frame.padding?.top ?? 0;
   const bottomPad = frame.padding?.bottom ?? 0;
-  const hasColumns = frame.columns != null && frame.columns.count > 1 && frame.width != null;
+  const hasColumns = !sideways && frame.columns != null && frame.columns.count > 1 && frame.width != null;
   let colWidth;
   let colCount = 1;
   let colGap = 0;
@@ -23133,14 +23151,14 @@ function runFlow(frame, options, engine) {
   for (let i2 = 0;i2 < frame.paragraphs.length; i2++) {
     const p = frame.paragraphs[i2];
     const subParagraphs = splitParagraphByHardBreaks(p);
-    const maxWidth = hasColumns ? colWidth : frame.width !== undefined ? frame.width - leftPad - rightPad : Infinity;
-    if (frame.wrap === false) {
-      p.style = { ...p.style, whiteSpace: "nowrap" };
-    }
+    const inlineFrameSize = sideways ? frame.height : frame.width;
+    const inlinePadStart = sideways ? topPad : leftPad;
+    const inlinePadEnd = sideways ? bottomPad : rightPad;
+    const maxWidth = hasColumns ? colWidth : inlineFrameSize !== undefined ? inlineFrameSize - inlinePadStart - inlinePadEnd : Infinity;
     const listIndex = listIndices[i2];
     const listMarkerWidth = listMarkerWidths[i2];
     for (let subIdx = 0;subIdx < subParagraphs.length; subIdx++) {
-      const subPara = subParagraphs[subIdx];
+      const subPara = frame.wrap === false && subParagraphs[subIdx].style.whiteSpace !== "nowrap" ? { ...subParagraphs[subIdx], style: { ...subParagraphs[subIdx].style, whiteSpace: "nowrap" } } : subParagraphs[subIdx];
       if (subIdx === 0) {
         if (hasColumns)
           pendingColGap += p.style.spaceBefore;
@@ -23215,18 +23233,32 @@ function runFlow(frame, options, engine) {
   }
   const lastLine = allLines.length > 0 ? allLines[allLines.length - 1] : null;
   const contentHeight = lastLine ? lastLine.y + lastLine.height + bottomPad : bottomPad;
+  const wmRotate = sideways ? writingMode === "sideways-rl" ? 90 : 270 : 0;
+  const rotate = normalizeDeg(wmRotate + (frame.rotation ?? 0));
+  const quarterTurned = rotate === 90 || rotate === 270;
+  const visualContentWidth = quarterTurned ? contentHeight : contentWidth;
+  const visualContentHeight = quarterTurned ? contentWidth : contentHeight;
+  const transform = rotate === 0 ? undefined : {
+    rotate,
+    layoutBox: {
+      width: (sideways ? frame.height : frame.width) ?? contentWidth,
+      height: (sideways ? frame.width : frame.height) ?? contentHeight
+    }
+  };
   return {
     lines: allLines,
-    content: { width: contentWidth, height: contentHeight },
+    content: { width: visualContentWidth, height: visualContentHeight },
     frame: { width: frame.width, height: frame.height },
     overflow: {
-      horizontal: frame.width !== undefined && contentWidth > frame.width + 0.01,
-      vertical: frame.height !== undefined && contentHeight > frame.height + 0.01
+      horizontal: frame.width !== undefined && visualContentWidth > frame.width + 0.01,
+      vertical: frame.height !== undefined && visualContentHeight > frame.height + 0.01
     },
     fit: {
       horizontal: frame.width !== undefined ? "frame" : "content",
       vertical: frame.height !== undefined ? "frame" : "content"
     },
+    writingMode,
+    ...transform ? { transform } : {},
     ...warnings.length ? { warnings } : {}
   };
 }
@@ -23271,6 +23303,382 @@ function createLayoutEngine(options = {}) {
     clearCache: () => pe.clearCache()
   };
 }
+// src/utils/sides.ts
+function resolveSide(v, side, fallback) {
+  if (v === undefined)
+    return fallback;
+  if (!Array.isArray(v))
+    return v;
+  if (v.length === 2) {
+    const [tb, lr] = v;
+    return side === "top" || side === "bottom" ? tb : lr;
+  }
+  const [t, r, b, l] = v;
+  return side === "top" ? t : side === "right" ? r : side === "bottom" ? b : l;
+}
+function resolveAllSides(v, fallback) {
+  return {
+    top: resolveSide(v, "top", fallback),
+    right: resolveSide(v, "right", fallback),
+    bottom: resolveSide(v, "bottom", fallback),
+    left: resolveSide(v, "left", fallback)
+  };
+}
+function resolveWidths(w, fallback = 0) {
+  return resolveAllSides(w, fallback);
+}
+function resolveColors(c, fallback = "#000") {
+  return resolveAllSides(c, fallback);
+}
+function resolvePatterns(p) {
+  if (p === undefined)
+    return { top: undefined, right: undefined, bottom: undefined, left: undefined };
+  if (p.length === 0 || typeof p[0] === "number") {
+    const flat = p;
+    return { top: flat, right: flat, bottom: flat, left: flat };
+  }
+  const tuples = p;
+  if (tuples.length === 2) {
+    const [tb, lr] = tuples;
+    return { top: tb, right: lr, bottom: tb, left: lr };
+  }
+  const [t, r, b, l] = tuples;
+  return { top: t, right: r, bottom: b, left: l };
+}
+function resolveShapes(s, fallback = "butt") {
+  return resolveAllSides(s, fallback);
+}
+
+// src/layout/TableLayoutEngine.ts
+var MAX_NESTED_TABLE_DEPTH = 50;
+function isNestedTable(content) {
+  return "rows" in content;
+}
+function placeholderContentFor(nested) {
+  return {
+    lines: [],
+    content: { width: nested.width, height: nested.height },
+    frame: { width: nested.width, height: nested.height },
+    overflow: { horizontal: false, vertical: false },
+    fit: { horizontal: "content", vertical: "content" },
+    writingMode: "horizontal-tb"
+  };
+}
+var DEFAULT_PADDING = 8;
+function resolveCellStyle(cell, table) {
+  const d = table.defaultCellStyle ?? {};
+  const s = cell.style ?? {};
+  return {
+    bgColor: s.bgColor ?? d.bgColor ?? "",
+    paddings: s.paddings ?? d.paddings ?? DEFAULT_PADDING,
+    verticalAlign: s.verticalAlign ?? d.verticalAlign ?? "top",
+    cx: s.cx ?? d.cx ?? 0,
+    cy: s.cy ?? d.cy ?? 0,
+    allowOverflow: s.allowOverflow ?? d.allowOverflow ?? false,
+    borderWidths: s.borderWidths ?? d.borderWidths,
+    borderColors: s.borderColors ?? d.borderColors,
+    borderPatterns: s.borderPatterns ?? d.borderPatterns,
+    borderShapes: s.borderShapes ?? d.borderShapes,
+    rx: s.rx ?? d.rx,
+    ry: s.ry ?? d.ry
+  };
+}
+function resolveRowStyle(row, table) {
+  const d = table.defaultRowStyle ?? {};
+  const s = row.style ?? {};
+  return {
+    height: s.height ?? d.height ?? 0,
+    bgColor: s.bgColor ?? d.bgColor ?? "",
+    borderWidths: s.borderWidths ?? d.borderWidths,
+    borderColors: s.borderColors ?? d.borderColors,
+    borderPatterns: s.borderPatterns ?? d.borderPatterns,
+    borderShapes: s.borderShapes ?? d.borderShapes,
+    rx: s.rx ?? d.rx,
+    ry: s.ry ?? d.ry
+  };
+}
+function resolveBorder(raw) {
+  if (!raw)
+    return;
+  const widths = resolveWidths(raw.borderWidths, 0);
+  if (widths.top === 0 && widths.right === 0 && widths.bottom === 0 && widths.left === 0)
+    return;
+  const colors = resolveColors(raw.borderColors, "#000");
+  const border = { widths, colors };
+  if (raw.borderPatterns !== undefined) {
+    const patterns = resolvePatterns(raw.borderPatterns);
+    if (patterns.top?.length || patterns.right?.length || patterns.bottom?.length || patterns.left?.length) {
+      border.patterns = patterns;
+    }
+  }
+  if (raw.borderShapes !== undefined)
+    border.shapes = resolveShapes(raw.borderShapes);
+  if (raw.rx !== undefined || raw.ry !== undefined) {
+    border.rx = raw.rx ?? raw.ry;
+    border.ry = raw.ry ?? raw.rx;
+  }
+  return border;
+}
+function verticalOffsetFor(align, available, content) {
+  const extra = available - content;
+  if (extra <= 0)
+    return 0;
+  if (align === "middle")
+    return extra / 2;
+  if (align === "bottom")
+    return extra;
+  return 0;
+}
+function sumSpan(arr, start, count, gap) {
+  let sum = 0;
+  for (let i = start;i < start + count; i++)
+    sum += arr[i] ?? 0;
+  return sum + gap * Math.max(0, count - 1);
+}
+function placeCells(rows) {
+  const placed = [];
+  const autoLastCell = [];
+  const occupied = new Map;
+  const isOccupied = (r, c) => occupied.get(r)?.has(c) ?? false;
+  const occupy = (r, c) => {
+    let set = occupied.get(r);
+    if (!set)
+      occupied.set(r, set = new Set);
+    set.add(c);
+  };
+  let colCount = 0;
+  for (let ri = 0;ri < rows.length; ri++) {
+    let ci = 0;
+    const cells = rows[ri].cells;
+    for (let idx = 0;idx < cells.length; idx++) {
+      const cell = cells[idx];
+      while (isOccupied(ri, ci))
+        ci++;
+      const isAuto = cell.colSpan === "auto";
+      const colSpan = cell.colSpan === "auto" ? 1 : Math.max(1, cell.colSpan ?? 1);
+      const rowSpan = Math.max(1, cell.rowSpan ?? 1);
+      const p = {
+        cell,
+        startRow: ri,
+        startCol: ci,
+        colSpan,
+        rowSpan,
+        cs: undefined,
+        pad: undefined,
+        inset: undefined,
+        natural: 0,
+        width: 0,
+        content: undefined,
+        cellHeight: 0
+      };
+      placed.push(p);
+      if (isAuto && idx === cells.length - 1)
+        autoLastCell.push(p);
+      for (let dr = 1;dr < rowSpan; dr++) {
+        for (let dc = 0;dc < colSpan; dc++)
+          occupy(ri + dr, ci + dc);
+      }
+      colCount = Math.max(colCount, ci + colSpan);
+      ci += colSpan;
+    }
+  }
+  for (const p of autoLastCell) {
+    if (p.startCol < colCount - 1)
+      p.colSpan = colCount - p.startCol;
+  }
+  return { placed, colCount };
+}
+function layoutTableFrame(table, options = {}) {
+  const depth = options._depth ?? 0;
+  if (depth > MAX_NESTED_TABLE_DEPTH) {
+    throw new Error(`layoutTableFrame: nested table depth exceeded ${MAX_NESTED_TABLE_DEPTH} — likely a cyclic or pathological TableCell.content structure, not a real document.`);
+  }
+  const style = table.style ?? {};
+  const margins = resolveWidths(style.margins, 0);
+  const colGaps = style.colGaps ?? 0;
+  const rowGaps = style.rowGaps ?? 0;
+  const rowCount = table.rows.length;
+  const tableBorder = resolveBorder(style);
+  const { placed, colCount } = placeCells(table.rows);
+  if (colCount === 0 || rowCount === 0) {
+    return {
+      width: margins.left + margins.right,
+      height: margins.top + margins.bottom,
+      bgColor: style.bgColor,
+      ...tableBorder ? { border: tableBorder } : {},
+      contentBox: { x: margins.left, y: margins.top, width: 0, height: 0 },
+      rows: []
+    };
+  }
+  for (const p of placed) {
+    p.cs = resolveCellStyle(p.cell, table);
+    p.pad = resolveWidths(p.cs.paddings, DEFAULT_PADDING);
+    p.border = resolveBorder(p.cs);
+    const bw = p.border?.widths;
+    p.inset = {
+      top: p.pad.top + (bw?.top ?? 0),
+      right: p.pad.right + (bw?.right ?? 0),
+      bottom: p.pad.bottom + (bw?.bottom ?? 0),
+      left: p.pad.left + (bw?.left ?? 0)
+    };
+    const naturalWidth = isNestedTable(p.cell.content) ? layoutTableFrame(p.cell.content, { mode: options.mode, onMissingFont: options.onMissingFont, _depth: depth + 1 }).width : layoutTextFrame({ ...p.cell.content, width: undefined, wrap: false }, { mode: options.mode, onMissingFont: options.onMissingFont }).content.width;
+    p.natural = naturalWidth + p.inset.left + p.inset.right;
+  }
+  const colWidths = new Array(colCount).fill(0);
+  if (table.columnWidths) {
+    for (let c = 0;c < colCount; c++)
+      colWidths[c] = table.columnWidths[c] ?? 0;
+  } else {
+    for (const p of placed)
+      if (p.colSpan === 1)
+        colWidths[p.startCol] = Math.max(colWidths[p.startCol], p.natural);
+    for (const p of placed) {
+      if (p.colSpan <= 1)
+        continue;
+      const covered = sumSpan(colWidths, p.startCol, p.colSpan, colGaps);
+      if (p.natural > covered) {
+        const extra = (p.natural - covered) / p.colSpan;
+        for (let c = p.startCol;c < p.startCol + p.colSpan; c++)
+          colWidths[c] += extra;
+      }
+    }
+  }
+  if (table.width !== undefined) {
+    const budget = table.width - margins.left - margins.right - colGaps * Math.max(0, colCount - 1);
+    const naturalSum = colWidths.reduce((a, b) => a + b, 0);
+    if (naturalSum > 0 && budget > 0) {
+      const scale = budget / naturalSum;
+      for (let i = 0;i < colWidths.length; i++)
+        colWidths[i] *= scale;
+    }
+  }
+  for (const p of placed) {
+    p.width = sumSpan(colWidths, p.startCol, p.colSpan, colGaps);
+    const contentWidth = Math.max(0, p.width - p.inset.left - p.inset.right);
+    if (isNestedTable(p.cell.content)) {
+      const nested = layoutTableFrame({ ...p.cell.content, width: contentWidth }, { mode: options.mode, onMissingFont: options.onMissingFont, _depth: depth + 1 });
+      p.nestedTable = nested;
+      p.content = placeholderContentFor(nested);
+    } else {
+      p.content = layoutTextFrame({ ...p.cell.content, width: contentWidth, wrap: true }, { mode: options.mode, onMissingFont: options.onMissingFont });
+    }
+    p.cellHeight = p.content.content.height + p.inset.top + p.inset.bottom;
+  }
+  const rowHeights = new Array(rowCount).fill(0);
+  if (table.rowHeights) {
+    for (let r = 0;r < rowCount; r++)
+      rowHeights[r] = table.rowHeights[r] ?? 0;
+  } else {
+    for (let ri = 0;ri < rowCount; ri++) {
+      const explicitHeight = resolveRowStyle(table.rows[ri], table).height;
+      if (explicitHeight > 0)
+        rowHeights[ri] = explicitHeight;
+    }
+    for (const p of placed) {
+      if (p.rowSpan === 1 && rowHeights[p.startRow] === 0)
+        rowHeights[p.startRow] = p.cellHeight;
+      else if (p.rowSpan === 1)
+        rowHeights[p.startRow] = Math.max(rowHeights[p.startRow], p.cellHeight);
+    }
+    for (const p of placed) {
+      if (p.rowSpan <= 1)
+        continue;
+      const covered = sumSpan(rowHeights, p.startRow, p.rowSpan, rowGaps);
+      if (p.cellHeight > covered) {
+        const extra = (p.cellHeight - covered) / p.rowSpan;
+        for (let r = p.startRow;r < p.startRow + p.rowSpan; r++)
+          rowHeights[r] += extra;
+      }
+    }
+  }
+  if (table.height !== undefined) {
+    const budget = table.height - margins.top - margins.bottom - rowGaps * Math.max(0, rowCount - 1);
+    const naturalSum = rowHeights.reduce((a, b) => a + b, 0);
+    if (naturalSum > 0 && budget > 0) {
+      const scale = budget / naturalSum;
+      for (let i = 0;i < rowHeights.length; i++)
+        rowHeights[i] *= scale;
+    }
+  }
+  const colX = [];
+  {
+    let acc = margins.left;
+    for (let c = 0;c < colCount; c++) {
+      colX.push(acc);
+      acc += colWidths[c] + colGaps;
+    }
+  }
+  const rowY = [];
+  {
+    let acc = margins.top;
+    for (let r = 0;r < rowCount; r++) {
+      rowY.push(acc);
+      acc += rowHeights[r] + rowGaps;
+    }
+  }
+  const rows = table.rows.map((row, ri) => {
+    const rs = resolveRowStyle(row, table);
+    const rowBorder = resolveBorder(rs);
+    const cells = placed.filter((p) => p.startRow === ri).map((p) => {
+      const height = sumSpan(rowHeights, p.startRow, p.rowSpan, rowGaps);
+      const available = height - p.inset.top - p.inset.bottom;
+      const verticalOffset = verticalOffsetFor(p.cs.verticalAlign, available, p.content.content.height);
+      const cellX = colX[p.startCol];
+      const cellY = rowY[p.startRow];
+      let before;
+      if (p.cell.before) {
+        const bc = layoutTextFrame({ ...p.cell.before, width: undefined, wrap: false }, { mode: options.mode, onMissingFont: options.onMissingFont });
+        before = { content: bc, x: cellX + p.inset.left, y: cellY + (height - bc.content.height) / 2 };
+      }
+      let after;
+      if (p.cell.after) {
+        const ac = layoutTextFrame({ ...p.cell.after, width: undefined, wrap: false }, { mode: options.mode, onMissingFont: options.onMissingFont });
+        after = { content: ac, x: cellX + p.width - p.inset.right - ac.content.width, y: cellY + (height - ac.content.height) / 2 };
+      }
+      return {
+        x: cellX,
+        y: cellY,
+        width: p.width,
+        height,
+        padding: p.pad,
+        verticalOffset,
+        cx: p.cs.cx,
+        cy: p.cs.cy,
+        allowOverflow: p.cs.allowOverflow,
+        ...p.cs.bgColor ? { bgColor: p.cs.bgColor } : {},
+        ...p.border ? { border: p.border } : {},
+        content: p.content,
+        ...p.nestedTable ? { nestedTable: p.nestedTable } : {},
+        ...before ? { before } : {},
+        ...after ? { after } : {},
+        colSpan: p.colSpan,
+        rowSpan: p.rowSpan
+      };
+    });
+    return {
+      y: rowY[ri],
+      height: rowHeights[ri],
+      ...rs.bgColor ? { bgColor: rs.bgColor } : {},
+      ...rowBorder ? { border: rowBorder } : {},
+      cells
+    };
+  });
+  const totalWidth = margins.left + colWidths.reduce((a, b) => a + b, 0) + colGaps * Math.max(0, colCount - 1) + margins.right;
+  const totalHeight = margins.top + rowHeights.reduce((a, b) => a + b, 0) + rowGaps * Math.max(0, rowCount - 1) + margins.bottom;
+  return {
+    width: totalWidth,
+    height: totalHeight,
+    bgColor: style.bgColor,
+    ...tableBorder ? { border: tableBorder } : {},
+    contentBox: {
+      x: margins.left,
+      y: margins.top,
+      width: totalWidth - margins.left - margins.right,
+      height: totalHeight - margins.top - margins.bottom
+    },
+    rows
+  };
+}
 // src/index.browser.ts
 var DEFAULT_PARAGRAPH_STYLE2 = { ...DEFAULT_PARAGRAPH_STYLE };
 var DEFAULT_TEXT_STYLE2 = { ...DEFAULT_TEXT_STYLE };
@@ -23285,6 +23693,7 @@ export {
   measurePx,
   makeFontToken,
   layoutTextFrame,
+  layoutTableFrame,
   isFontEngineAvailable,
   groupLinesByParagraph,
   getParagraphText,

package/dist/index.d.ts

@@ -13,6 +13,7 @@
  * - `index.browser.ts` (browser) — browser-safe subset (no node:fs)
  */
 export type { TextFrame, Paragraph, ParagraphStyle, TextRun, InlineWidget, AutofitConfig, TextAlignment, WritingMode, TextOrientation, VerticalAlignment, ScriptType, WhiteSpace, MultiColumnConfig, DominantBaseline, LineFitEdge, TextAlignLast, WordBreak, LineBreak, OverflowWrap, TextDecorationStyle, TextTransform, ListType, NumberFormat, ListStylePosition, ListStyle, ResolvedTextRun, } from './types/Document.js';
+export type { TableFrame, TableRow, TableCell, TableStyle, TableRowStyle, TableCellStyle, BorderStyles, Widths, ColorsOnWidth, Sides, } from './types/TableTypes.js';
 import type { ParagraphStyle } from './types/Document.js';
 /** @internal */
 export declare const DEFAULT_PARAGRAPH_STYLE: ParagraphStyle;
@@ -29,7 +30,9 @@ export { positionLines } from './layout/PositioningEngine.js';
 export { layoutTextFrame } from './layout/TextFrameLayoutEngine.js';
 export { createLayoutEngine } from './layout/create-engine.js';
 export type { LayoutEngine, LayoutEngineOptions } from './layout/create-engine.js';
-export type { TextFrameLayoutResult, LayoutOptions, AutofitOutcome } from './layout/TextFrameLayoutEngine.js';
+export type { TextFrameLayoutResult, LayoutOptions, AutofitOutcome, FrameTransform } from './layout/TextFrameLayoutEngine.js';
+export { layoutTableFrame } from './layout/TableLayoutEngine.js';
+export type { TableLayoutResult, TableRowLayoutResult, TableCellLayoutResult, TableLayoutOptions, ResolvedBorder } from './layout/TableLayoutEngine.js';
 export type { OnMissingFont } from './layout/resolve-font.js';
 export { applyScale, findScale } from './layout/AutoFitEngine.js';
 export type { AutoFitOptions, AutoFitResult } from './layout/AutoFitEngine.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,YAAY,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,OAAO,EACP,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,EAAE,cAA6B,CAAC;AACpE,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,OAAO,qBAAqB,EAAE,OAAO,CAAgB,CAAC;AAG/F,YAAY,EACV,qBAAqB,EACrB,IAAI,EACJ,IAAI,EACJ,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEjG;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAM9D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC9G,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,gBAAgB;AAChB,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,MAAa,CAAC;AAClF,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAa,CAAC;AACjE,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAe,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC1J,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAG7E,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAChI,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACrG,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5F,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGzF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}