superdoc 1.0.0-beta.22 → 1.0.0-beta.23

package/dist/chunks/{super-editor.es-BkRizaIE.cjs → super-editor.es-49DW4_-r.cjs}

@@ -24995,24 +24995,32 @@ function extractGradientFill(gradFill) {
 const DRAWING_XML_TAG = "w:drawing";
 const SHAPE_URI = "http://schemas.microsoft.com/office/word/2010/wordprocessingShape";
 const GROUP_URI = "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup";
+const normalizeTargetPath = (targetPath = "") => {
+  if (!targetPath) return targetPath;
+  const trimmed = targetPath.replace(/^\/+/, "");
+  if (trimmed.startsWith("word/")) return trimmed;
+  if (trimmed.startsWith("media/")) return `word/${trimmed}`;
+  return `word/${trimmed}`;
+};
 const DEFAULT_SHAPE_WIDTH = 100;
 const DEFAULT_SHAPE_HEIGHT = 100;
 function handleImageNode$1(node, params2, isAnchor) {
+  if (!node) return null;
   const { docx, filename } = params2;
-  const { attributes } = node;
+  const attributes = node?.attributes || {};
   const padding = {
-    top: emuToPixels(attributes["distT"]),
-    bottom: emuToPixels(attributes["distB"]),
-    left: emuToPixels(attributes["distL"]),
-    right: emuToPixels(attributes["distR"])
+    top: emuToPixels(attributes?.["distT"]),
+    bottom: emuToPixels(attributes?.["distB"]),
+    left: emuToPixels(attributes?.["distL"]),
+    right: emuToPixels(attributes?.["distR"])
   };
-  const extent = node.elements.find((el) => el.name === "wp:extent");
+  const extent = node?.elements?.find((el) => el.name === "wp:extent");
   const size2 = {
     width: emuToPixels(extent?.attributes?.cx),
     height: emuToPixels(extent?.attributes?.cy)
   };
   let transformData = {};
-  const effectExtent = node.elements.find((el) => el.name === "wp:effectExtent");
+  const effectExtent = node?.elements?.find((el) => el.name === "wp:effectExtent");
   if (effectExtent) {
     const sanitizeEmuValue = (value) => {
       if (value === null || value === void 0) return 0;
@@ -25026,12 +25034,12 @@ function handleImageNode$1(node, params2, isAnchor) {
       bottom: emuToPixels(sanitizeEmuValue(effectExtent.attributes?.["b"]))
     };
   }
-  const positionHTag = node.elements.find((el) => el.name === "wp:positionH");
-  const positionH = positionHTag?.elements.find((el) => el.name === "wp:posOffset");
+  const positionHTag = node?.elements?.find((el) => el.name === "wp:positionH");
+  const positionH = positionHTag?.elements?.find((el) => el.name === "wp:posOffset");
   const positionHValue = emuToPixels(positionH?.elements[0]?.text);
   const hRelativeFrom = positionHTag?.attributes?.relativeFrom;
-  const alignH = positionHTag?.elements.find((el) => el.name === "wp:align")?.elements?.[0]?.text;
-  const positionVTag = node.elements.find((el) => el.name === "wp:positionV");
+  const alignH = positionHTag?.elements?.find((el) => el.name === "wp:align")?.elements?.[0]?.text;
+  const positionVTag = node?.elements?.find((el) => el.name === "wp:positionV");
   const positionV = positionVTag?.elements?.find((el) => el.name === "wp:posOffset");
   const positionVValue = emuToPixels(positionV?.elements[0]?.text);
   const vRelativeFrom = positionVTag?.attributes?.relativeFrom;
@@ -25041,8 +25049,8 @@ function handleImageNode$1(node, params2, isAnchor) {
     top: positionVValue
   };
   const useSimplePos = attributes["simplePos"] === "1" || attributes["simplePos"] === 1 || attributes["simplePos"] === true;
-  const simplePosNode = node.elements.find((el) => el.name === "wp:simplePos");
-  const wrapNode = isAnchor ? node.elements.find(
+  const simplePosNode = node?.elements?.find((el) => el.name === "wp:simplePos");
+  const wrapNode = isAnchor ? node?.elements?.find(
     (el) => ["wp:wrapNone", "wp:wrapSquare", "wp:wrapThrough", "wp:wrapTight", "wp:wrapTopAndBottom"].includes(el.name)
   ) : null;
   const wrap2 = isAnchor ? { type: wrapNode?.name.slice(7) || "None", attrs: {} } : { type: "Inline" };
@@ -25163,9 +25171,8 @@ function handleImageNode$1(node, params2, isAnchor) {
   if (!rel) return null;
   const { attributes: relAttributes } = rel;
   const targetPath = relAttributes["Target"];
-  let path = `word/${targetPath}`;
-  if (targetPath.startsWith("/word") || targetPath.startsWith("/media")) path = targetPath.substring(1);
-  const extension = targetPath.substring(targetPath.lastIndexOf(".") + 1);
+  const path = normalizeTargetPath(targetPath);
+  const extension = path.substring(path.lastIndexOf(".") + 1);
   return {
     type: "image",
     attrs: {
@@ -25183,8 +25190,8 @@ function handleImageNode$1(node, params2, isAnchor) {
       transformData,
       ...useSimplePos && {
         simplePos: {
-          x: simplePosNode.attributes?.x,
-          y: simplePosNode.attributes?.y
+          x: simplePosNode?.attributes?.x,
+          y: simplePosNode?.attributes?.y
         }
       },
       wrap: wrap2,
@@ -25194,12 +25201,12 @@ function handleImageNode$1(node, params2, isAnchor) {
       wrapTopAndBottom: wrap2.type === "TopAndBottom",
       shouldStretch,
       originalPadding: {
-        distT: attributes["distT"],
-        distB: attributes["distB"],
-        distL: attributes["distL"],
-        distR: attributes["distR"]
+        distT: attributes?.["distT"],
+        distB: attributes?.["distB"],
+        distL: attributes?.["distL"],
+        distR: attributes?.["distR"]
       },
-      originalAttributes: node.attributes,
+      originalAttributes: node?.attributes || {},
       rId: relAttributes["Id"]
     }
   };
@@ -25363,11 +25370,8 @@ const handleShapeGroup = (params2, node, graphicData, size2, padding, marginOffs
     const { elements } = relationships || [];
     const rel = elements?.find((el) => el.attributes["Id"] === rEmbed);
     if (!rel) return null;
-    const targetPath = rel.attributes?.["Target"];
-    let path = `word/${targetPath}`;
-    if (targetPath.startsWith("/word") || targetPath.startsWith("/media")) {
-      path = targetPath.substring(1);
-    }
+    const targetPath = normalizeTargetPath(rel.attributes?.["Target"]);
+    const path = targetPath;
     const nvPicPr = pic.elements?.find((el) => el.name === "pic:nvPicPr");
     const cNvPr = nvPicPr?.elements?.find((el) => el.name === "pic:cNvPr");
     const picId = cNvPr?.attributes?.["id"];
@@ -36388,7 +36392,7 @@ const _SuperConverter = class _SuperConverter2 {
   static getStoredSuperdocVersion(docx) {
     return _SuperConverter2.getStoredCustomProperty(docx, "SuperdocVersion");
   }
-  static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.0.0-beta.22") {
+  static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.0.0-beta.23") {
     return _SuperConverter2.setStoredCustomProperty(docx, "SuperdocVersion", version2, false);
   }
   /**
@@ -53553,7 +53557,7 @@ const isHeadless = (editor) => {
 const shouldSkipNodeView = (editor) => {
   return isHeadless(editor);
 };
-const summaryVersion = "1.0.0-beta.22";
+const summaryVersion = "1.0.0-beta.23";
 const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
 const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
 function mapAttributes(attrs) {
@@ -54342,7 +54346,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
       { default: remarkStringify },
       { default: remarkGfm }
     ] = await Promise.all([
-      Promise.resolve().then(() => require("./index-895wSAjT-CWlZl8zz.cjs")),
+      Promise.resolve().then(() => require("./index-DYBG7Xab-CoI6fike.cjs")),
       Promise.resolve().then(() => require("./index-DRCvimau-H4Ck3S9a.cjs")),
       Promise.resolve().then(() => require("./index-C_x_N6Uh-Db3CUJMX.cjs")),
       Promise.resolve().then(() => require("./index-D_sWOSiG-BtDZzJ6I.cjs")),
@@ -54547,7 +54551,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
    * Process collaboration migrations
    */
   processCollaborationMigrations() {
-    console.debug("[checkVersionMigrations] Current editor version", "1.0.0-beta.22");
+    console.debug("[checkVersionMigrations] Current editor version", "1.0.0-beta.23");
     if (!this.options.ydoc) return;
     const metaMap = this.options.ydoc.getMap("meta");
     let docVersion = metaMap.get("version");
@@ -56999,6 +57003,11 @@ const normalizeAlignment = (value) => {
     case "right":
     case "justify":
       return value;
+    case "both":
+    case "distribute":
+    case "numTab":
+    case "thaiDistribute":
+      return "justify";
     case "end":
       return "right";
     case "start":
@@ -59213,6 +59222,11 @@ const computeParagraphAttrs = (para, styleContext, listCounterContext, converter
   } else if (computed2.paragraph.alignment) {
     paragraphAttrs.alignment = computed2.paragraph.alignment;
   }
+  const isJustified = paragraphAttrs.alignment === "justify" || paragraphAttrs.alignment === "both";
+  const hasFirstLineIndent = normalizedIndent?.firstLine && normalizedIndent.firstLine > 0;
+  if (isJustified && hasFirstLineIndent) {
+    paragraphAttrs.suppressFirstLineIndent = true;
+  }
   const spacingPx = spacingPtToPx(spacing, normalizedSpacing);
   if (spacingPx) paragraphAttrs.spacing = spacingPx;
   if (normalizedSpacing?.beforeAutospacing != null || normalizedSpacing?.afterAutospacing != null) {
@@ -59430,7 +59444,7 @@ const computeParagraphAttrs = (para, styleContext, listCounterContext, converter
         }
       }
       paragraphAttrs.wordLayout = wordLayout;
-      if (enrichedNumberingProps.resolvedLevelIndent) {
+      if (enrichedNumberingProps.resolvedLevelIndent && !hasExplicitIndent) {
         const resolvedIndentPx = convertIndentTwipsToPx(enrichedNumberingProps.resolvedLevelIndent);
         paragraphAttrs.indent = {
           ...paragraphAttrs.indent,
@@ -62796,8 +62810,14 @@ function computeNextSectionPropsAtBreak(blocks) {
   });
   return nextSectionPropsAtBreak;
 }
-function scheduleSectionBreak(block, state2, baseMargins) {
+function scheduleSectionBreak(block, state2, baseMargins, maxHeaderContentHeight = 0) {
   const next = { ...state2 };
+  const calcRequiredTopMargin = (headerDistance, baseTop) => {
+    if (maxHeaderContentHeight > 0) {
+      return Math.max(baseTop, headerDistance + maxHeaderContentHeight);
+    }
+    return Math.max(baseTop, headerDistance);
+  };
   if (block.attrs?.isFirstSection && !next.hasAnyPages) {
     if (block.pageSize) {
       next.activePageSize = { w: block.pageSize.w, h: block.pageSize.h };
@@ -62811,7 +62831,7 @@ function scheduleSectionBreak(block, state2, baseMargins) {
       const headerDistance = Math.max(0, block.margins.header);
       next.activeHeaderDistance = headerDistance;
       next.pendingHeaderDistance = headerDistance;
-      next.activeTopMargin = Math.max(baseMargins.top, headerDistance);
+      next.activeTopMargin = calcRequiredTopMargin(headerDistance, baseMargins.top);
       next.pendingTopMargin = next.activeTopMargin;
     }
     if (block.margins?.footer !== void 0) {
@@ -62833,9 +62853,15 @@ function scheduleSectionBreak(block, state2, baseMargins) {
   const nextBottom = next.pendingBottomMargin ?? next.activeBottomMargin;
   const nextHeader = next.pendingHeaderDistance ?? next.activeHeaderDistance;
   const nextFooter = next.pendingFooterDistance ?? next.activeFooterDistance;
-  next.pendingTopMargin = typeof headerPx === "number" ? Math.max(baseMargins.top, headerPx) : nextTop;
+  if (typeof headerPx === "number") {
+    const newHeaderDist = Math.max(0, headerPx);
+    next.pendingHeaderDistance = newHeaderDist;
+    next.pendingTopMargin = calcRequiredTopMargin(newHeaderDist, baseMargins.top);
+  } else {
+    next.pendingTopMargin = nextTop;
+    next.pendingHeaderDistance = nextHeader;
+  }
   next.pendingBottomMargin = typeof footerPx === "number" ? Math.max(baseMargins.bottom, footerPx) : nextBottom;
-  next.pendingHeaderDistance = typeof headerPx === "number" ? Math.max(0, headerPx) : nextHeader;
   next.pendingFooterDistance = typeof footerPx === "number" ? Math.max(0, footerPx) : nextFooter;
   if (block.pageSize) {
     next.pendingPageSize = { w: block.pageSize.w, h: block.pageSize.h };
@@ -64300,7 +64326,22 @@ function layoutDocument(blocks, measures, options = {}) {
   if (contentWidth <= 0) {
     throw new Error("layoutDocument: pageSize and margins yield non-positive content area");
   }
-  let activeTopMargin = margins.top;
+  const validateHeaderHeight = (height) => {
+    if (height === void 0) return 0;
+    if (!Number.isFinite(height) || height < 0) return 0;
+    return height;
+  };
+  const headerContentHeights = options.headerContentHeights;
+  const maxHeaderContentHeight = headerContentHeights ? Math.max(
+    0,
+    validateHeaderHeight(headerContentHeights.default),
+    validateHeaderHeight(headerContentHeights.first),
+    validateHeaderHeight(headerContentHeights.even),
+    validateHeaderHeight(headerContentHeights.odd)
+  ) : 0;
+  const headerDistance = margins.header ?? margins.top;
+  const effectiveTopMargin = maxHeaderContentHeight > 0 ? Math.max(margins.top, headerDistance + maxHeaderContentHeight) : margins.top;
+  let activeTopMargin = effectiveTopMargin;
   let activeBottomMargin = margins.bottom;
   let pendingTopMargin = null;
   let pendingBottomMargin = null;
@@ -64324,7 +64365,7 @@ function layoutDocument(blocks, measures, options = {}) {
   const nextSectionPropsAtBreak = computeNextSectionPropsAtBreak(blocks);
   const scheduleSectionBreakCompat = (block, state2, baseMargins) => {
     if (typeof scheduleSectionBreak === "function") {
-      return scheduleSectionBreak(block, state2, baseMargins);
+      return scheduleSectionBreak(block, state2, baseMargins, maxHeaderContentHeight);
     }
     const next = { ...state2 };
     if (block.attrs?.isFirstSection && !next.hasAnyPages) {
@@ -64337,10 +64378,11 @@ function layoutDocument(blocks, measures, options = {}) {
         next.pendingOrientation = null;
       }
       if (block.margins?.header !== void 0) {
-        const headerDistance = Math.max(0, block.margins.header);
-        next.activeHeaderDistance = headerDistance;
-        next.pendingHeaderDistance = headerDistance;
-        next.activeTopMargin = Math.max(baseMargins.top, headerDistance);
+        const headerDist = Math.max(0, block.margins.header);
+        next.activeHeaderDistance = headerDist;
+        next.pendingHeaderDistance = headerDist;
+        const requiredTop = maxHeaderContentHeight > 0 ? headerDist + maxHeaderContentHeight : headerDist;
+        next.activeTopMargin = Math.max(baseMargins.top, requiredTop);
         next.pendingTopMargin = next.activeTopMargin;
       }
       if (block.margins?.footer !== void 0) {
@@ -64377,14 +64419,22 @@ function layoutDocument(blocks, measures, options = {}) {
     }
     const headerPx = block.margins?.header;
     const footerPx = block.margins?.footer;
+    const topPx = block.margins?.top;
     const nextTop = next.pendingTopMargin ?? next.activeTopMargin;
     const nextBottom = next.pendingBottomMargin ?? next.activeBottomMargin;
     const nextHeader = next.pendingHeaderDistance ?? next.activeHeaderDistance;
     const nextFooter = next.pendingFooterDistance ?? next.activeFooterDistance;
-    next.pendingTopMargin = typeof headerPx === "number" ? Math.max(baseMargins.top, headerPx) : nextTop;
-    next.pendingBottomMargin = typeof footerPx === "number" ? Math.max(baseMargins.bottom, footerPx) : nextBottom;
     next.pendingHeaderDistance = typeof headerPx === "number" ? Math.max(0, headerPx) : nextHeader;
     next.pendingFooterDistance = typeof footerPx === "number" ? Math.max(0, footerPx) : nextFooter;
+    if (typeof headerPx === "number" || typeof topPx === "number") {
+      const sectionTop = topPx ?? baseMargins.top;
+      const sectionHeader = next.pendingHeaderDistance;
+      const requiredTop = maxHeaderContentHeight > 0 ? sectionHeader + maxHeaderContentHeight : sectionHeader;
+      next.pendingTopMargin = Math.max(sectionTop, requiredTop);
+    } else {
+      next.pendingTopMargin = nextTop;
+    }
+    next.pendingBottomMargin = typeof footerPx === "number" ? Math.max(baseMargins.bottom, footerPx) : nextBottom;
     if (block.pageSize) next.pendingPageSize = { w: block.pageSize.w, h: block.pageSize.h };
     if (block.orientation) next.pendingOrientation = block.orientation;
     const sectionType = block.type ?? "continuous";
@@ -65135,7 +65185,7 @@ const resolveTrackedChangesEnabled = (attrs, defaultEnabled = true) => {
   }
   return attrs.trackedChangesEnabled !== false;
 };
-const MAX_CACHE_SIZE = 1e4;
+const MAX_CACHE_SIZE$1 = 1e4;
 const BYTES_PER_ENTRY_ESTIMATE = 5e3;
 const NORMALIZED_WHITESPACE = /\s+/g;
 const normalizeText = (text) => text.replace(NORMALIZED_WHITESPACE, " ");
@@ -65235,7 +65285,7 @@ class MeasureCache {
     if (this.cache.has(key2)) {
       this.cache.delete(key2);
     }
-    if (this.cache.size >= MAX_CACHE_SIZE) {
+    if (this.cache.size >= MAX_CACHE_SIZE$1) {
       const oldestKey = this.cache.keys().next().value;
       if (oldestKey !== void 0) {
         this.cache.delete(oldestKey);
@@ -65309,13 +65359,13 @@ class MeasureCache {
    * Get maximum cache size
    */
   getMaxSize() {
-    return MAX_CACHE_SIZE;
+    return MAX_CACHE_SIZE$1;
   }
   /**
    * Check if cache is near capacity
    */
   isNearCapacity(threshold = 0.9) {
-    return this.cache.size >= MAX_CACHE_SIZE * threshold;
+    return this.cache.size >= MAX_CACHE_SIZE$1 * threshold;
   }
   /**
    * Update size statistics
@@ -66327,9 +66377,46 @@ async function incrementalLayout(previousBlocks, _previousLayout, nextBlocks, op
   perfLog(
     `[Perf] 4.1 Measure all blocks: ${(measureEnd - measureStart).toFixed(2)}ms (${cacheMisses} measured, ${cacheHits} cached)`
   );
+  let headerContentHeights;
+  if (headerFooter?.constraints && headerFooter.headerBlocks) {
+    const hfPreStart = performance.now();
+    const measureFn = headerFooter.measure ?? measureBlock2;
+    invalidateHeaderFooterCache(
+      headerMeasureCache,
+      headerFooterCacheState,
+      headerFooter.headerBlocks,
+      headerFooter.footerBlocks,
+      headerFooter.constraints,
+      options.sectionMetadata
+    );
+    const HEADER_PRELAYOUT_PLACEHOLDER_PAGE_COUNT = 1;
+    const preHeaderLayouts = await layoutHeaderFooterWithCache(
+      headerFooter.headerBlocks,
+      headerFooter.constraints,
+      measureFn,
+      headerMeasureCache,
+      HEADER_PRELAYOUT_PLACEHOLDER_PAGE_COUNT,
+      void 0
+      // No page resolver needed for height calculation
+    );
+    const isValidHeaderType = (key2) => {
+      return ["default", "first", "even", "odd"].includes(key2);
+    };
+    headerContentHeights = {};
+    for (const [type2, value] of Object.entries(preHeaderLayouts)) {
+      if (!isValidHeaderType(type2)) continue;
+      if (value?.layout && typeof value.layout.height === "number") {
+        headerContentHeights[type2] = value.layout.height;
+      }
+    }
+    const hfPreEnd = performance.now();
+    perfLog(`[Perf] 4.1.5 Pre-layout headers for height: ${(hfPreEnd - hfPreStart).toFixed(2)}ms`);
+  }
   const layoutStart = performance.now();
   let layout = layoutDocument(nextBlocks, measures, {
     ...options,
+    headerContentHeights,
+    // Pass header heights to prevent overlap
     remeasureParagraph: (block, maxWidth) => remeasureParagraph(block, maxWidth)
   });
   const layoutEnd = performance.now();
@@ -66376,6 +66463,8 @@ async function incrementalLayout(previousBlocks, _previousLayout, nextBlocks, op
       const relayoutStart = performance.now();
       layout = layoutDocument(currentBlocks, currentMeasures, {
         ...options,
+        headerContentHeights,
+        // Pass header heights to prevent overlap
         remeasureParagraph: (block, maxWidth) => remeasureParagraph(block, maxWidth)
       });
       const relayoutEnd = performance.now();
@@ -69425,7 +69514,12 @@ const lineStyles = (lineHeight2) => ({
   height: `${lineHeight2}px`,
   position: "relative",
   display: "block",
-  whiteSpace: "pre"
+  whiteSpace: "pre",
+  // Allow text to overflow the line container as a safety net.
+  // The primary fix uses accurate font metrics from Canvas API, but this
+  // provides defense-in-depth against any remaining sub-pixel rendering
+  // differences between measurement and display.
+  overflow: "visible"
 });
 const PRINT_STYLES = `
 @media print {
@@ -70991,7 +71085,8 @@ const _DomPainter = class _DomPainter2 {
       const paraIndent = block.attrs?.indent;
       const paraIndentLeft = paraIndent?.left ?? 0;
       const paraIndentRight = paraIndent?.right ?? 0;
-      const firstLineOffset = (paraIndent?.firstLine ?? 0) - (paraIndent?.hanging ?? 0);
+      const suppressFirstLineIndent = block.attrs?.suppressFirstLineIndent === true;
+      const firstLineOffset = suppressFirstLineIndent ? 0 : (paraIndent?.firstLine ?? 0) - (paraIndent?.hanging ?? 0);
       lines.forEach((line, index2) => {
         const lineEl = this.renderLine(block, line, context);
         const isListFirstLine = index2 === 0 && !fragment.continuesFromPrev && fragment.markerWidth && wordLayout?.marker;
@@ -73180,6 +73275,61 @@ function evictIfNeeded() {
     cache$1.delete(oldestKey);
   }
 }
+const fontMetricsCache = /* @__PURE__ */ new Map();
+const MAX_CACHE_SIZE = 1e3;
+const METRICS_TEST_STRING = "MHgypbdlÁÉÍ";
+function getFontKey(fontInfo) {
+  return `${fontInfo.fontFamily}|${fontInfo.fontSize}|${fontInfo.bold ?? false}|${fontInfo.italic ?? false}`;
+}
+function buildFontStringForMetrics(fontInfo, mode, fonts) {
+  const parts = [];
+  if (fontInfo.italic) parts.push("italic");
+  if (fontInfo.bold) parts.push("bold");
+  parts.push(`${fontInfo.fontSize}px`);
+  {
+    parts.push(fontInfo.fontFamily);
+  }
+  return parts.join(" ");
+}
+function getFontMetrics(ctx2, fontInfo, mode, fonts) {
+  if (!ctx2 || typeof ctx2 !== "object") {
+    throw new TypeError("Canvas context must be a valid CanvasRenderingContext2D object");
+  }
+  if (typeof fontInfo.fontSize !== "number" || !Number.isFinite(fontInfo.fontSize) || fontInfo.fontSize <= 0) {
+    throw new TypeError(
+      `Font size must be a positive finite number, got: ${typeof fontInfo.fontSize === "number" ? fontInfo.fontSize : typeof fontInfo.fontSize}`
+    );
+  }
+  if (typeof fontInfo.fontFamily !== "string" || fontInfo.fontFamily.trim().length === 0) {
+    throw new TypeError("Font family must be a non-empty string");
+  }
+  const key2 = getFontKey(fontInfo);
+  const cached = fontMetricsCache.get(key2);
+  if (cached) {
+    return cached;
+  }
+  const font = buildFontStringForMetrics(fontInfo);
+  ctx2.font = font;
+  const textMetrics = ctx2.measureText(METRICS_TEST_STRING);
+  let ascent;
+  let descent;
+  if (typeof textMetrics.actualBoundingBoxAscent === "number" && typeof textMetrics.actualBoundingBoxDescent === "number" && textMetrics.actualBoundingBoxAscent > 0) {
+    ascent = textMetrics.actualBoundingBoxAscent;
+    descent = textMetrics.actualBoundingBoxDescent;
+  } else {
+    ascent = fontInfo.fontSize * 0.8;
+    descent = fontInfo.fontSize * 0.2;
+  }
+  const result = { ascent, descent };
+  if (fontMetricsCache.size >= MAX_CACHE_SIZE) {
+    const firstKey = fontMetricsCache.keys().next().value;
+    if (firstKey) {
+      fontMetricsCache.delete(firstKey);
+    }
+  }
+  fontMetricsCache.set(key2, result);
+  return result;
+}
 const { computeTabStops } = Engines;
 let canvasContext = null;
 const DEFAULT_TAB_INTERVAL_TWIPS = 720;
@@ -73227,10 +73377,20 @@ function measureText(text, font, ctx2, _fontFamily, _letterSpacing) {
   return Math.max(advanceWidth, paintedWidth);
 }
 const MIN_SINGLE_LINE_PX = 12 * 96 / 72;
-function calculateTypographyMetrics(fontSize2, spacing) {
-  const ascent = roundValue(fontSize2 * 0.8);
-  const descent = roundValue(fontSize2 * 0.2);
-  const baseLineHeight = Math.max(fontSize2, MIN_SINGLE_LINE_PX);
+const LINE_HEIGHT_SAFETY_MARGIN_PX = 1;
+function calculateTypographyMetrics(fontSize2, spacing, fontInfo) {
+  let ascent;
+  let descent;
+  if (fontInfo) {
+    const ctx2 = getCanvasContext();
+    const metrics = getFontMetrics(ctx2, fontInfo);
+    ascent = roundValue(metrics.ascent);
+    descent = roundValue(metrics.descent);
+  } else {
+    ascent = roundValue(fontSize2 * 0.8);
+    descent = roundValue(fontSize2 * 0.2);
+  }
+  const baseLineHeight = Math.max(ascent + descent + LINE_HEIGHT_SAFETY_MARGIN_PX, MIN_SINGLE_LINE_PX);
   const lineHeight2 = roundValue(resolveLineHeight(spacing, baseLineHeight));
   return {
     ascent,
@@ -73238,6 +73398,20 @@ function calculateTypographyMetrics(fontSize2, spacing) {
     lineHeight: lineHeight2
   };
 }
+function getFontInfoFromRun(run2) {
+  return {
+    fontFamily: run2.fontFamily,
+    fontSize: run2.fontSize,
+    bold: run2.bold,
+    italic: run2.italic
+  };
+}
+function updateMaxFontInfo(currentMaxSize, currentMaxInfo, newRun) {
+  if (newRun.fontSize >= currentMaxSize) {
+    return getFontInfoFromRun(newRun);
+  }
+  return currentMaxInfo;
+}
 function isTabRun(run2) {
   return run2.kind === "tab";
 }
@@ -73283,7 +73457,8 @@ async function measureParagraphBlock(block, maxWidth) {
   const indentRight = sanitizePositive(indent?.right);
   const firstLine = indent?.firstLine ?? 0;
   const hanging = indent?.hanging ?? 0;
-  const firstLineOffset = firstLine - hanging;
+  const suppressFirstLine = block.attrs?.suppressFirstLineIndent === true;
+  const firstLineOffset = suppressFirstLine ? 0 : firstLine - hanging;
   const contentWidth = Math.max(1, maxWidth - indentLeft - indentRight);
   const initialAvailableWidth = Math.max(1, contentWidth - firstLineOffset);
   const tabStops = buildTabStopsPx(
@@ -73419,7 +73594,7 @@ async function measureParagraphBlock(block, maxWidth) {
     const run2 = runsToProcess[runIndex];
     if (run2.kind === "break") {
       if (currentLine) {
-        const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing);
+        const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
         const completedLine = { ...currentLine, ...metrics };
         addBarTabsToLine(completedLine);
         lines.push(completedLine);
@@ -73449,7 +73624,7 @@ async function measureParagraphBlock(block, maxWidth) {
     }
     if (isLineBreakRun(run2)) {
       if (currentLine) {
-        const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing);
+        const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
         const completedLine = {
           ...currentLine,
           ...metrics
@@ -73562,7 +73737,7 @@ async function measureParagraphBlock(block, maxWidth) {
       }
       const appliedTabAlign = lastAppliedTabAlign;
       if (currentLine.width + imageWidth > currentLine.maxWidth && currentLine.width > 0) {
-        const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing);
+        const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
         const completedLine = {
           ...currentLine,
           ...metrics
@@ -73650,6 +73825,7 @@ async function measureParagraphBlock(block, maxWidth) {
             toChar: wordEndNoSpace,
             width: wordOnlyWidth,
             maxFontSize: run2.fontSize,
+            maxFontInfo: getFontInfoFromRun(run2),
             maxWidth: getEffectiveWidth(initialAvailableWidth),
             segments: [{ runIndex, fromChar: wordStartChar, toChar: wordEndNoSpace, width: wordOnlyWidth }]
           };
@@ -73666,7 +73842,7 @@ async function measureParagraphBlock(block, maxWidth) {
         const isTocEntry = block.attrs?.isTocEntry;
         const boundarySpacing = currentLine.width > 0 ? run2.letterSpacing ?? 0 : 0;
         if (currentLine.width + boundarySpacing + wordOnlyWidth > currentLine.maxWidth - WIDTH_FUDGE_PX && currentLine.width > 0 && !isTocEntry) {
-          const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing);
+          const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
           const completedLine = {
             ...currentLine,
             ...metrics
@@ -73682,6 +73858,7 @@ async function measureParagraphBlock(block, maxWidth) {
             toChar: wordEndNoSpace,
             width: wordOnlyWidth,
             maxFontSize: run2.fontSize,
+            maxFontInfo: getFontInfoFromRun(run2),
             maxWidth: getEffectiveWidth(contentWidth),
             segments: [{ runIndex, fromChar: wordStartChar, toChar: wordEndNoSpace, width: wordOnlyWidth }]
           };
@@ -73697,9 +73874,10 @@ async function measureParagraphBlock(block, maxWidth) {
           if (!isLastWord && currentLine.width + boundarySpacing + wordOnlyWidth + spaceWidth > currentLine.maxWidth - WIDTH_FUDGE_PX) {
             currentLine.toChar = wordEndNoSpace;
             currentLine.width = roundValue(currentLine.width + boundarySpacing + wordOnlyWidth);
+            currentLine.maxFontInfo = updateMaxFontInfo(currentLine.maxFontSize, currentLine.maxFontInfo, run2);
             currentLine.maxFontSize = Math.max(currentLine.maxFontSize, run2.fontSize);
             appendSegment(currentLine.segments, runIndex, wordStartChar, wordEndNoSpace, wordOnlyWidth, segmentStartX);
-            const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing);
+            const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
             const completedLine = { ...currentLine, ...metrics };
             addBarTabsToLine(completedLine);
             lines.push(completedLine);
@@ -73716,6 +73894,7 @@ async function measureParagraphBlock(block, maxWidth) {
           currentLine.width = roundValue(
             currentLine.width + boundarySpacing + wordCommitWidth + (isLastWord ? 0 : run2.letterSpacing ?? 0)
           );
+          currentLine.maxFontInfo = updateMaxFontInfo(currentLine.maxFontSize, currentLine.maxFontInfo, run2);
           currentLine.maxFontSize = Math.max(currentLine.maxFontSize, run2.fontSize);
           appendSegment(currentLine.segments, runIndex, wordStartChar, newToChar, wordCommitWidth, explicitX);
         }
@@ -73738,6 +73917,7 @@ async function measureParagraphBlock(block, maxWidth) {
             toChar: charPosInRun,
             width: 0,
             maxFontSize: run2.fontSize,
+            maxFontInfo: getFontInfoFromRun(run2),
             maxWidth: getEffectiveWidth(initialAvailableWidth),
             segments: []
           };
@@ -73747,6 +73927,7 @@ async function measureParagraphBlock(block, maxWidth) {
         tabStopCursor = nextIndex;
         const tabAdvance = Math.max(0, target - currentLine.width);
         currentLine.width = roundValue(currentLine.width + tabAdvance);
+        currentLine.maxFontInfo = updateMaxFontInfo(currentLine.maxFontSize, currentLine.maxFontInfo, run2);
         currentLine.maxFontSize = Math.max(currentLine.maxFontSize, run2.fontSize);
         currentLine.toRun = runIndex;
         currentLine.toChar = charPosInRun;
@@ -73783,7 +73964,7 @@ async function measureParagraphBlock(block, maxWidth) {
     lines.push(fallbackLine);
   }
   if (currentLine) {
-    const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing);
+    const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
     const finalLine = {
       ...currentLine,
       ...metrics