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

package/dist/superdoc.es.js

@@ -1,5 +1,5 @@
-import { a, E, b, S, d, i, j, n, r, p, q } from "./chunks/super-editor.es-V792hb-6.es.js";
-import { D, H, P, S as S2, m, l } from "./chunks/index-DBmh710D.es.js";
+import { a, E, b, S, d, i, j, n, r, p, q } from "./chunks/super-editor.es-Cj9Sb-Qv.es.js";
+import { D, H, P, S as S2, m, l } from "./chunks/index-DyY842H4.es.js";
 import { B } from "./chunks/blank-docx-ABm6XYAA.es.js";
 export {
   a as AnnotatorHelpers,

package/dist/superdoc.umd.js

@@ -24996,24 +24996,32 @@
   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(node2, params2, isAnchor) {
+    if (!node2) return null;
     const { docx, filename } = params2;
-    const { attributes } = node2;
+    const attributes = node2?.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 = node2.elements.find((el) => el.name === "wp:extent");
+    const extent = node2?.elements?.find((el) => el.name === "wp:extent");
     const size2 = {
       width: emuToPixels(extent?.attributes?.cx),
       height: emuToPixels(extent?.attributes?.cy)
     };
     let transformData = {};
-    const effectExtent = node2.elements.find((el) => el.name === "wp:effectExtent");
+    const effectExtent = node2?.elements?.find((el) => el.name === "wp:effectExtent");
     if (effectExtent) {
       const sanitizeEmuValue = (value) => {
         if (value === null || value === void 0) return 0;
@@ -25027,12 +25035,12 @@
         bottom: emuToPixels(sanitizeEmuValue(effectExtent.attributes?.["b"]))
       };
     }
-    const positionHTag = node2.elements.find((el) => el.name === "wp:positionH");
-    const positionH = positionHTag?.elements.find((el) => el.name === "wp:posOffset");
+    const positionHTag = node2?.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 = node2.elements.find((el) => el.name === "wp:positionV");
+    const alignH = positionHTag?.elements?.find((el) => el.name === "wp:align")?.elements?.[0]?.text;
+    const positionVTag = node2?.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;
@@ -25042,8 +25050,8 @@
       top: positionVValue
     };
     const useSimplePos = attributes["simplePos"] === "1" || attributes["simplePos"] === 1 || attributes["simplePos"] === true;
-    const simplePosNode = node2.elements.find((el) => el.name === "wp:simplePos");
-    const wrapNode = isAnchor ? node2.elements.find(
+    const simplePosNode = node2?.elements?.find((el) => el.name === "wp:simplePos");
+    const wrapNode = isAnchor ? node2?.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" };
@@ -25164,9 +25172,8 @@
     if (!rel) return null;
     const { attributes: relAttributes } = rel;
     const targetPath = relAttributes["Target"];
-    let path2 = `word/${targetPath}`;
-    if (targetPath.startsWith("/word") || targetPath.startsWith("/media")) path2 = targetPath.substring(1);
-    const extension = targetPath.substring(targetPath.lastIndexOf(".") + 1);
+    const path2 = normalizeTargetPath(targetPath);
+    const extension = path2.substring(path2.lastIndexOf(".") + 1);
     return {
       type: "image",
       attrs: {
@@ -25184,8 +25191,8 @@
         transformData,
         ...useSimplePos && {
           simplePos: {
-            x: simplePosNode.attributes?.x,
-            y: simplePosNode.attributes?.y
+            x: simplePosNode?.attributes?.x,
+            y: simplePosNode?.attributes?.y
           }
         },
         wrap: wrap2,
@@ -25195,12 +25202,12 @@
         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: node2.attributes,
+        originalAttributes: node2?.attributes || {},
         rId: relAttributes["Id"]
       }
     };
@@ -25364,11 +25371,8 @@
       const { elements } = relationships || [];
       const rel = elements?.find((el) => el.attributes["Id"] === rEmbed);
       if (!rel) return null;
-      const targetPath = rel.attributes?.["Target"];
-      let path2 = `word/${targetPath}`;
-      if (targetPath.startsWith("/word") || targetPath.startsWith("/media")) {
-        path2 = targetPath.substring(1);
-      }
+      const targetPath = normalizeTargetPath(rel.attributes?.["Target"]);
+      const path2 = 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"];
@@ -36389,7 +36393,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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);
     }
     /**
@@ -61411,7 +61415,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   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) {
@@ -62200,7 +62204,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         { default: remarkStringify2 },
         { default: remarkGfm2 }
       ] = await Promise.all([
-        Promise.resolve().then(() => index895wSAjT),
+        Promise.resolve().then(() => indexDYBG7Xab),
         Promise.resolve().then(() => indexDRCvimau),
         Promise.resolve().then(() => indexC_x_N6Uh),
         Promise.resolve().then(() => indexD_sWOSiG),
@@ -62405,7 +62409,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
      * 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");
@@ -64857,6 +64861,11 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       case "right":
       case "justify":
         return value;
+      case "both":
+      case "distribute":
+      case "numTab":
+      case "thaiDistribute":
+        return "justify";
       case "end":
         return "right";
       case "start":
@@ -67071,6 +67080,11 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     } 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) {
@@ -67288,7 +67302,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           }
         }
         paragraphAttrs.wordLayout = wordLayout;
-        if (enrichedNumberingProps.resolvedLevelIndent) {
+        if (enrichedNumberingProps.resolvedLevelIndent && !hasExplicitIndent) {
           const resolvedIndentPx = convertIndentTwipsToPx(enrichedNumberingProps.resolvedLevelIndent);
           paragraphAttrs.indent = {
             ...paragraphAttrs.indent,
@@ -70654,8 +70668,14 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     });
     return nextSectionPropsAtBreak;
   }
-  function scheduleSectionBreak(block, state2, baseMargins) {
+  function scheduleSectionBreak(block, state2, baseMargins, maxHeaderContentHeight = 0) {
     const next2 = { ...state2 };
+    const calcRequiredTopMargin = (headerDistance, baseTop) => {
+      if (maxHeaderContentHeight > 0) {
+        return Math.max(baseTop, headerDistance + maxHeaderContentHeight);
+      }
+      return Math.max(baseTop, headerDistance);
+    };
     if (block.attrs?.isFirstSection && !next2.hasAnyPages) {
       if (block.pageSize) {
         next2.activePageSize = { w: block.pageSize.w, h: block.pageSize.h };
@@ -70669,7 +70689,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         const headerDistance = Math.max(0, block.margins.header);
         next2.activeHeaderDistance = headerDistance;
         next2.pendingHeaderDistance = headerDistance;
-        next2.activeTopMargin = Math.max(baseMargins.top, headerDistance);
+        next2.activeTopMargin = calcRequiredTopMargin(headerDistance, baseMargins.top);
         next2.pendingTopMargin = next2.activeTopMargin;
       }
       if (block.margins?.footer !== void 0) {
@@ -70691,9 +70711,15 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     const nextBottom = next2.pendingBottomMargin ?? next2.activeBottomMargin;
     const nextHeader = next2.pendingHeaderDistance ?? next2.activeHeaderDistance;
     const nextFooter = next2.pendingFooterDistance ?? next2.activeFooterDistance;
-    next2.pendingTopMargin = typeof headerPx === "number" ? Math.max(baseMargins.top, headerPx) : nextTop;
+    if (typeof headerPx === "number") {
+      const newHeaderDist = Math.max(0, headerPx);
+      next2.pendingHeaderDistance = newHeaderDist;
+      next2.pendingTopMargin = calcRequiredTopMargin(newHeaderDist, baseMargins.top);
+    } else {
+      next2.pendingTopMargin = nextTop;
+      next2.pendingHeaderDistance = nextHeader;
+    }
     next2.pendingBottomMargin = typeof footerPx === "number" ? Math.max(baseMargins.bottom, footerPx) : nextBottom;
-    next2.pendingHeaderDistance = typeof headerPx === "number" ? Math.max(0, headerPx) : nextHeader;
     next2.pendingFooterDistance = typeof footerPx === "number" ? Math.max(0, footerPx) : nextFooter;
     if (block.pageSize) {
       next2.pendingPageSize = { w: block.pageSize.w, h: block.pageSize.h };
@@ -72158,7 +72184,22 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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;
@@ -72182,7 +72223,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     const nextSectionPropsAtBreak = computeNextSectionPropsAtBreak(blocks2);
     const scheduleSectionBreakCompat = (block, state2, baseMargins) => {
       if (typeof scheduleSectionBreak === "function") {
-        return scheduleSectionBreak(block, state2, baseMargins);
+        return scheduleSectionBreak(block, state2, baseMargins, maxHeaderContentHeight);
       }
       const next2 = { ...state2 };
       if (block.attrs?.isFirstSection && !next2.hasAnyPages) {
@@ -72195,10 +72236,11 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           next2.pendingOrientation = null;
         }
         if (block.margins?.header !== void 0) {
-          const headerDistance = Math.max(0, block.margins.header);
-          next2.activeHeaderDistance = headerDistance;
-          next2.pendingHeaderDistance = headerDistance;
-          next2.activeTopMargin = Math.max(baseMargins.top, headerDistance);
+          const headerDist = Math.max(0, block.margins.header);
+          next2.activeHeaderDistance = headerDist;
+          next2.pendingHeaderDistance = headerDist;
+          const requiredTop = maxHeaderContentHeight > 0 ? headerDist + maxHeaderContentHeight : headerDist;
+          next2.activeTopMargin = Math.max(baseMargins.top, requiredTop);
           next2.pendingTopMargin = next2.activeTopMargin;
         }
         if (block.margins?.footer !== void 0) {
@@ -72235,14 +72277,22 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       }
       const headerPx = block.margins?.header;
       const footerPx = block.margins?.footer;
+      const topPx = block.margins?.top;
       const nextTop = next2.pendingTopMargin ?? next2.activeTopMargin;
       const nextBottom = next2.pendingBottomMargin ?? next2.activeBottomMargin;
       const nextHeader = next2.pendingHeaderDistance ?? next2.activeHeaderDistance;
       const nextFooter = next2.pendingFooterDistance ?? next2.activeFooterDistance;
-      next2.pendingTopMargin = typeof headerPx === "number" ? Math.max(baseMargins.top, headerPx) : nextTop;
-      next2.pendingBottomMargin = typeof footerPx === "number" ? Math.max(baseMargins.bottom, footerPx) : nextBottom;
       next2.pendingHeaderDistance = typeof headerPx === "number" ? Math.max(0, headerPx) : nextHeader;
       next2.pendingFooterDistance = typeof footerPx === "number" ? Math.max(0, footerPx) : nextFooter;
+      if (typeof headerPx === "number" || typeof topPx === "number") {
+        const sectionTop = topPx ?? baseMargins.top;
+        const sectionHeader = next2.pendingHeaderDistance;
+        const requiredTop = maxHeaderContentHeight > 0 ? sectionHeader + maxHeaderContentHeight : sectionHeader;
+        next2.pendingTopMargin = Math.max(sectionTop, requiredTop);
+      } else {
+        next2.pendingTopMargin = nextTop;
+      }
+      next2.pendingBottomMargin = typeof footerPx === "number" ? Math.max(baseMargins.bottom, footerPx) : nextBottom;
       if (block.pageSize) next2.pendingPageSize = { w: block.pageSize.w, h: block.pageSize.h };
       if (block.orientation) next2.pendingOrientation = block.orientation;
       const sectionType = block.type ?? "continuous";
@@ -72993,7 +73043,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     }
     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 = (text2) => text2.replace(NORMALIZED_WHITESPACE, " ");
@@ -73093,7 +73143,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       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);
@@ -73167,13 +73217,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
      * 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
@@ -74185,9 +74235,46 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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();
@@ -74234,6 +74321,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         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();
@@ -77283,7 +77372,12 @@ ${l}
     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 {
@@ -78849,7 +78943,8 @@ ${l}
         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;
@@ -81038,6 +81133,61 @@ ${l}
       cache$1$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;
@@ -81085,10 +81235,20 @@ ${l}
     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,
@@ -81096,6 +81256,20 @@ ${l}
       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";
   }
@@ -81141,7 +81315,8 @@ ${l}
     const indentRight = sanitizePositive(indent2?.right);
     const firstLine = indent2?.firstLine ?? 0;
     const hanging = indent2?.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(
@@ -81277,7 +81452,7 @@ ${l}
       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);
@@ -81307,7 +81482,7 @@ ${l}
       }
       if (isLineBreakRun(run2)) {
         if (currentLine) {
-          const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing);
+          const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
           const completedLine = {
             ...currentLine,
             ...metrics
@@ -81420,7 +81595,7 @@ ${l}
         }
         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
@@ -81508,6 +81683,7 @@ ${l}
               toChar: wordEndNoSpace,
               width: wordOnlyWidth,
               maxFontSize: run2.fontSize,
+              maxFontInfo: getFontInfoFromRun(run2),
               maxWidth: getEffectiveWidth(initialAvailableWidth),
               segments: [{ runIndex, fromChar: wordStartChar, toChar: wordEndNoSpace, width: wordOnlyWidth }]
             };
@@ -81524,7 +81700,7 @@ ${l}
           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
@@ -81540,6 +81716,7 @@ ${l}
               toChar: wordEndNoSpace,
               width: wordOnlyWidth,
               maxFontSize: run2.fontSize,
+              maxFontInfo: getFontInfoFromRun(run2),
               maxWidth: getEffectiveWidth(contentWidth),
               segments: [{ runIndex, fromChar: wordStartChar, toChar: wordEndNoSpace, width: wordOnlyWidth }]
             };
@@ -81555,9 +81732,10 @@ ${l}
             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);
@@ -81574,6 +81752,7 @@ ${l}
             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);
           }
@@ -81596,6 +81775,7 @@ ${l}
               toChar: charPosInRun,
               width: 0,
               maxFontSize: run2.fontSize,
+              maxFontInfo: getFontInfoFromRun(run2),
               maxWidth: getEffectiveWidth(initialAvailableWidth),
               segments: []
             };
@@ -81605,6 +81785,7 @@ ${l}
           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;
@@ -81641,7 +81822,7 @@ ${l}
       lines.push(fallbackLine);
     }
     if (currentLine) {
-      const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing);
+      const metrics = calculateTypographyMetrics(currentLine.maxFontSize, spacing, currentLine.maxFontInfo);
       const finalLine = {
         ...currentLine,
         ...metrics
@@ -139965,7 +140146,7 @@ ${style2}
       this.config.colors = shuffleArray(this.config.colors);
       this.userColorMap = /* @__PURE__ */ new Map();
       this.colorIndex = 0;
-      this.version = "1.0.0-beta.22";
+      this.version = "1.0.0-beta.23";
       this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
       this.superdocId = config2.superdocId || v4();
       this.colors = this.config.colors;
@@ -142410,7 +142591,7 @@ ${style2}
       value && typeof value === "object" && "byteLength" in value && "byteOffset" in value
     );
   }
-  const index895wSAjT = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  const indexDYBG7Xab = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     __proto__: null,
     unified
   }, Symbol.toStringTag, { value: "Module" }));