@json-to-office/core-docx 1.4.0 → 1.6.0

package/dist/plugin/example/index.js

@@ -864,6 +864,143 @@ var init_devportal_docx_theme = __esm({
   }
 });
 
+// src/templates/themes/vermilion.docx.theme.json
+var vermilion_docx_theme_default;
+var init_vermilion_docx_theme = __esm({
+  "src/templates/themes/vermilion.docx.theme.json"() {
+    vermilion_docx_theme_default = {
+      name: "vermilion",
+      displayName: "Vermilion Editorial",
+      description: "Poster-red editorial system \u2014 vermilion display headings, ink text, warm creams and hairline rules",
+      version: "1.0.0",
+      colors: {
+        primary: "#282829",
+        secondary: "#58595B",
+        accent: "#EF4130",
+        text: "#282829",
+        background: "#FFFFFF",
+        border: "#E8E2DC",
+        textPrimary: "#282829",
+        textSecondary: "#58595B",
+        textMuted: "#939598",
+        borderPrimary: "#C7C8CA",
+        borderSecondary: "#EFEAE4",
+        backgroundPrimary: "#FFFFFF",
+        backgroundSecondary: "#FAF7F5"
+      },
+      fonts: {
+        heading: {
+          family: "Arial",
+          size: 24
+        },
+        body: {
+          family: "Calibri",
+          size: 10.5
+        },
+        mono: {
+          family: "Consolas",
+          size: 10
+        },
+        light: {
+          family: "Arial",
+          size: 24
+        }
+      },
+      page: {
+        size: "A4",
+        margins: {
+          top: 1360,
+          bottom: 1360,
+          left: 1180,
+          right: 1180,
+          header: 620,
+          footer: 620,
+          gutter: 0
+        }
+      },
+      styles: {
+        normal: {
+          font: "body",
+          color: "textPrimary",
+          lineSpacing: {
+            type: "multiple",
+            value: 1.3
+          },
+          alignment: "left",
+          spacing: {
+            after: 8
+          }
+        },
+        heading1: {
+          font: "heading",
+          size: 25,
+          bold: false,
+          color: "accent",
+          characterSpacing: {
+            type: "expanded",
+            value: 50
+          },
+          spacing: {
+            before: 22,
+            after: 12
+          },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading2: {
+          font: "heading",
+          size: 12.5,
+          bold: true,
+          color: "accent",
+          characterSpacing: {
+            type: "expanded",
+            value: 30
+          },
+          spacing: {
+            before: 16,
+            after: 7
+          },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading3: {
+          font: "body",
+          size: 11,
+          bold: true,
+          color: "textPrimary",
+          spacing: {
+            before: 12,
+            after: 5
+          },
+          keepNext: true,
+          alignment: "left"
+        },
+        title: {
+          font: "heading",
+          size: 38,
+          bold: true,
+          color: "primary",
+          alignment: "left",
+          spacing: {
+            before: 0,
+            after: 14
+          }
+        },
+        subtitle: {
+          font: "body",
+          size: 14,
+          color: "textSecondary",
+          alignment: "left",
+          spacing: {
+            before: 0,
+            after: 10
+          }
+        }
+      }
+    };
+  }
+});
+
 // src/templates/themes/index.ts
 import fs from "fs";
 import path from "path";
@@ -880,7 +1017,8 @@ function loadThemesFromJson() {
     corporate: ensureThemeDefaults(corporate_docx_theme_default),
     modern: ensureThemeDefaults(modern_docx_theme_default),
     apex: ensureThemeDefaults(apex_docx_theme_default),
-    devportal: ensureThemeDefaults(devportal_docx_theme_default)
+    devportal: ensureThemeDefaults(devportal_docx_theme_default),
+    vermilion: ensureThemeDefaults(vermilion_docx_theme_default)
   };
   try {
     const __filename2 = fileURLToPath(import.meta.url);
@@ -928,6 +1066,7 @@ var init_themes = __esm({
     init_modern_docx_theme();
     init_apex_docx_theme();
     init_devportal_docx_theme();
+    init_vermilion_docx_theme();
     _themesCache = null;
     themes = loadThemesFromJson();
     getTheme = (themeName) => {
@@ -1718,6 +1857,14 @@ async function rasterizeSvgFallback(svg, transformation) {
   }
   try {
     const markup = svg.toString("utf-8");
+    if (/<(?:[A-Za-z][\w.-]*:)?text[\s>/]/.test(markup)) {
+      reportWarning(
+        "image",
+        "IMAGE_SVG_RASTER_SKIPPED",
+        "Inline SVG contains <text>, which would rasterize with machine-dependent fonts, so its fallback only renders in Word 2016+. Convert the text to paths for a portable fallback."
+      );
+      return void 0;
+    }
     const probeImage = new Resvg(markup);
     const wide = probeImage.width / probeImage.height > transformation.width / transformation.height;
     const mode = wide ? "height" : "width";
@@ -5206,88 +5353,6 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
   return map;
 }
 
-// src/json/normalizer.ts
-function normalizeComponent(component) {
-  if (component.name === "columns") {
-    return normalizeColumnsComponent(component);
-  }
-  if ("children" in component && component.children) {
-    return {
-      ...component,
-      // Preserve ALL properties from validated component
-      children: component.children.map(normalizeComponent)
-    };
-  }
-  if (component.name === "section") {
-    return normalizeSectionComponent(component);
-  }
-  return component;
-}
-function normalizeColumnsComponent(component) {
-  const cfg = component.props || {};
-  const applyTopLevelGap = (cols, topGap) => cols.map((c, i) => {
-    const isLast = i === cols.length - 1;
-    if (!isLast && c.gap === void 0 && topGap !== void 0) {
-      return { ...c, gap: topGap };
-    }
-    return c;
-  });
-  const normalizeAutoWidth = (cols) => cols.map((c) => ({
-    ...c,
-    width: c.width === "auto" ? void 0 : c.width
-  }));
-  let columnsArray;
-  if (typeof cfg.columns === "number" && cfg.columns > 0) {
-    const n = cfg.columns;
-    const base = Array.from(
-      { length: n },
-      () => ({})
-    );
-    const topLevelGap = cfg.gap !== void 0 ? cfg.gap : "5%";
-    columnsArray = applyTopLevelGap(base, topLevelGap);
-  } else if (Array.isArray(cfg.columns)) {
-    columnsArray = cfg.columns;
-    const topLevelGap = cfg.gap !== void 0 ? cfg.gap : "5%";
-    columnsArray = applyTopLevelGap(columnsArray, topLevelGap);
-    columnsArray = normalizeAutoWidth(columnsArray);
-  } else {
-    columnsArray = [{}];
-  }
-  const normalizedProps = {
-    columns: columnsArray
-  };
-  return {
-    ...component,
-    // Preserve any additional properties
-    name: "columns",
-    props: normalizedProps,
-    children: component.children ? component.children.map(normalizeComponent) : void 0
-  };
-}
-function normalizeSectionComponent(component) {
-  const props = component.props || {};
-  return {
-    ...component,
-    // Preserve ALL properties
-    props: {
-      ...props,
-      // Preserve ALL props properties
-      header: props.header ? props.header === "linkToPrevious" ? "linkToPrevious" : props.header.map((m) => normalizeComponent(m)) : void 0,
-      footer: props.footer ? props.footer === "linkToPrevious" ? "linkToPrevious" : props.footer.map((m) => normalizeComponent(m)) : void 0
-    },
-    children: component.children ? component.children.map(normalizeComponent) : void 0
-  };
-}
-function normalizeDocument(document) {
-  if (document.name !== "docx") {
-    throw new Error(
-      'Top-level document must be a docx component with name="docx"'
-    );
-  }
-  const normalized = normalizeComponent(document);
-  return [normalized];
-}
-
 // src/core/desugarExternals.ts
 import {
   clampVisualDpi as clampVisualDpi2,
@@ -7061,6 +7126,17 @@ function mergeBorderSizePerSide(...borders3) {
     left: pick("left")
   };
 }
+function statedSides(colors, sizes) {
+  const namedColors = colors.filter((value) => typeof value === "object").map(normalizeBorderColor);
+  const namedSizes = sizes.filter((value) => typeof value === "object").map(normalizeBorderSize);
+  const stated = (side) => namedColors.some((c) => c !== void 0 && c[side] !== UNSET_COLOR) || namedSizes.some((s) => s !== void 0 && s[side] !== UNSET_SIZE);
+  return {
+    top: stated("top"),
+    right: stated("right"),
+    bottom: stated("bottom"),
+    left: stated("left")
+  };
+}
 function mergePaddingPerSide(...paddings) {
   const normalized = paddings.map(normalizePadding);
   if (!normalized.some((p) => p !== void 0)) return void 0;
@@ -7200,6 +7276,10 @@ function mergeCellDefaults(tableDef, columnDef, cellDef, position, tableOuterBor
       tableDef?.borderSize,
       tableOuterBorder.borderSize
     ),
+    borderExplicit: statedSides(
+      [cellDef?.borderColor, columnDef?.borderColor],
+      [cellDef?.borderSize, columnDef?.borderSize]
+    ),
     padding: mergePaddingPerSide(
       cellDef?.padding,
       columnDef?.padding,
@@ -7257,6 +7337,10 @@ function mergeHeaderCellDefaults(tableDef, headerTableDef, columnDef, headerDef,
       tableDef?.borderSize,
       tableOuterBorder.borderSize
     ),
+    borderExplicit: statedSides(
+      [headerDef?.borderColor, columnDef?.borderColor],
+      [headerDef?.borderSize, columnDef?.borderSize]
+    ),
     padding: mergePaddingPerSide(
       headerDef?.padding,
       headerTableDef?.padding,
@@ -7287,28 +7371,20 @@ function resolveTableModel(source, theme, themeName, options = {}) {
         return position.isLastCol ? hidden.right : hidden.insideVertical;
     }
   };
-  const borders3 = (merged, position) => ({
-    top: {
-      size: merged.borderSize.top,
-      color: merged.borderColor.top,
-      hidden: isHidden("top", position)
-    },
-    right: {
-      size: merged.borderSize.right,
-      color: merged.borderColor.right,
-      hidden: isHidden("right", position)
-    },
-    bottom: {
-      size: merged.borderSize.bottom,
-      color: merged.borderColor.bottom,
-      hidden: isHidden("bottom", position)
-    },
-    left: {
-      size: merged.borderSize.left,
-      color: merged.borderColor.left,
-      hidden: isHidden("left", position)
-    }
-  });
+  const borders3 = (merged, position) => {
+    const side = (name) => ({
+      size: merged.borderSize[name],
+      color: merged.borderColor[name],
+      hidden: isHidden(name, position) && !merged.borderExplicit[name],
+      explicit: merged.borderExplicit[name]
+    });
+    return {
+      top: side("top"),
+      right: side("right"),
+      bottom: side("bottom"),
+      left: side("left")
+    };
+  };
   const tallest = (heights) => heights.reduce(
     (max, height) => height === void 0 ? max : max === void 0 ? height : Math.max(max, height),
     void 0
@@ -7418,6 +7494,7 @@ function resolveTableModel(source, theme, themeName, options = {}) {
     };
     return row;
   });
+  adjudicateInteriorEdges([header, ...rows]);
   return {
     ...resolveWidths(source, columns, theme, themeName),
     header,
@@ -7425,6 +7502,54 @@ function resolveTableModel(source, theme, themeName, options = {}) {
     repeatHeader: source.repeatHeaderOnPageBreak ?? true
   };
 }
+function drawsNothing(border3) {
+  return border3.hidden || border3.size <= 0;
+}
+function channels(hex) {
+  const digits = hex.startsWith("#") ? hex.slice(1) : hex;
+  return [
+    parseInt(digits.slice(0, 2), 16) || 0,
+    parseInt(digits.slice(2, 4), 16) || 0,
+    parseInt(digits.slice(4, 6), 16) || 0
+  ];
+}
+function outweighs(a, b) {
+  if (drawsNothing(a)) return false;
+  if (drawsNothing(b)) return true;
+  if (a.size !== b.size) return a.size > b.size;
+  const [redA, greenA, blueA] = channels(a.color);
+  const [redB, greenB, blueB] = channels(b.color);
+  const brightness = [
+    [redA + blueA + 2 * greenA, redB + blueB + 2 * greenB],
+    [blueA + 2 * greenA, blueB + 2 * greenB],
+    [greenA, greenB]
+  ];
+  for (const [ours, theirs] of brightness) {
+    if (ours !== theirs) return ours < theirs;
+  }
+  return false;
+}
+function adjudicateInteriorEdges(rows) {
+  const settle = (earlier, later) => {
+    if (drawsNothing(earlier) && drawsNothing(later)) return;
+    if (earlier.hidden === later.hidden && earlier.size === later.size && earlier.color === later.color) {
+      return;
+    }
+    const winner = earlier.explicit !== later.explicit ? earlier.explicit ? earlier : later : outweighs(later, earlier) ? later : earlier;
+    const loser = winner === earlier ? later : earlier;
+    loser.size = winner.size;
+    loser.color = winner.color;
+    loser.hidden = winner.hidden;
+  };
+  rows.forEach((row, rowIndex) => {
+    row.cells.forEach((cell, colIndex) => {
+      const right = row.cells[colIndex + 1];
+      if (right) settle(cell.borders.right, right.borders.left);
+      const below = rows[rowIndex + 1]?.cells[colIndex];
+      if (below) settle(cell.borders.bottom, below.borders.top);
+    });
+  });
+}
 function resolveWidths(source, columns, theme, themeName) {
   const hasExplicitWidths = columns.some((col) => col.width !== void 0);
   if (!hasExplicitWidths) {
@@ -10441,6 +10566,7 @@ function compileTableRow(row, spacing, baseStyle, scope) {
   };
 }
 function compileTableCell(cell, spacing, baseStyle, keepNext, scope, rowRevision, markRevision) {
+  const cellLine = compileLineSpacing(cell.font?.lineSpacing);
   const paragraph2 = {
     kind: "paragraph",
     id: scope.id,
@@ -10454,7 +10580,10 @@ function compileTableCell(cell, spacing, baseStyle, keepNext, scope, rowRevision
       spacing: {
         beforeTwips: spacing.before,
         afterTwips: spacing.after,
-        ...spacing.line !== void 0 ? { lineTwips: spacing.line, lineRule: lineRule(spacing.lineRule) } : {}
+        ...cellLine ? {
+          ...cellLine.lineTwips !== void 0 ? { lineTwips: cellLine.lineTwips } : {},
+          lineRule: cellLine.lineRule
+        } : spacing.line !== void 0 ? { lineTwips: spacing.line, lineRule: lineRule(spacing.lineRule) } : {}
       },
       ...keepNext ? { keepNext: true } : {}
     },
@@ -11198,8 +11327,7 @@ function resolveComponentTree(components, theme) {
 }
 
 // src/core/structure.ts
-async function processDocument(document, theme, themeName, generationDate) {
-  const metadata = createDocumentMetadata(document.props, generationDate);
+function resolveDocumentTree(document, theme) {
   const docDefaults = document.props.componentDefaults;
   const mergedComponentDefaults = docDefaults ? mergeWithDefaults2(docDefaults, theme.componentDefaults || {}) : void 0;
   const docNoProofWords = document.props.noProofWords;
@@ -11213,6 +11341,14 @@ async function processDocument(document, theme, themeName, generationDate) {
     },
     ...mergedNoProofWords && { noProofWords: mergedNoProofWords }
   } : theme;
+  return {
+    theme: effectiveTheme,
+    children: resolveComponentTree(document.children || [], effectiveTheme)
+  };
+}
+async function processResolvedDocument(document, resolved, themeName, generationDate) {
+  const metadata = createDocumentMetadata(document.props, generationDate);
+  const effectiveTheme = resolved.theme;
   const context = createRenderContext(
     {
       metadata,
@@ -11223,11 +11359,7 @@ async function processDocument(document, theme, themeName, generationDate) {
     effectiveTheme,
     themeName
   );
-  const resolvedChildren = resolveComponentTree(
-    document.children || [],
-    effectiveTheme
-  );
-  const sections = await extractSections(resolvedChildren, context);
+  const sections = await extractSections(resolved.children, context);
   return {
     metadata,
     sections,
@@ -11327,6 +11459,365 @@ function createRenderContext(document, theme, themeName) {
   };
 }
 
+// src/quality/facts.ts
+import { DEFAULT_DOCX_RENDERER_ID as DEFAULT_DOCX_RENDERER_ID2 } from "@json-to-office/shared-docx";
+
+// src/json/normalizer.ts
+function normalizeComponent(component) {
+  if (component.name === "columns") {
+    return normalizeColumnsComponent(component);
+  }
+  if ("children" in component && component.children) {
+    return {
+      ...component,
+      // Preserve ALL properties from validated component
+      children: component.children.map(normalizeComponent)
+    };
+  }
+  if (component.name === "section") {
+    return normalizeSectionComponent(component);
+  }
+  return component;
+}
+function normalizeColumnsComponent(component) {
+  const cfg = component.props || {};
+  const applyTopLevelGap = (cols, topGap) => cols.map((c, i) => {
+    const isLast = i === cols.length - 1;
+    if (!isLast && c.gap === void 0 && topGap !== void 0) {
+      return { ...c, gap: topGap };
+    }
+    return c;
+  });
+  const normalizeAutoWidth = (cols) => cols.map((c) => ({
+    ...c,
+    width: c.width === "auto" ? void 0 : c.width
+  }));
+  let columnsArray;
+  if (typeof cfg.columns === "number" && cfg.columns > 0) {
+    const n = cfg.columns;
+    const base = Array.from(
+      { length: n },
+      () => ({})
+    );
+    const topLevelGap = cfg.gap !== void 0 ? cfg.gap : "5%";
+    columnsArray = applyTopLevelGap(base, topLevelGap);
+  } else if (Array.isArray(cfg.columns)) {
+    columnsArray = cfg.columns;
+    const topLevelGap = cfg.gap !== void 0 ? cfg.gap : "5%";
+    columnsArray = applyTopLevelGap(columnsArray, topLevelGap);
+    columnsArray = normalizeAutoWidth(columnsArray);
+  } else {
+    columnsArray = [{}];
+  }
+  const normalizedProps = {
+    columns: columnsArray
+  };
+  return {
+    ...component,
+    // Preserve any additional properties
+    name: "columns",
+    props: normalizedProps,
+    children: component.children ? component.children.map(normalizeComponent) : void 0
+  };
+}
+function normalizeSectionComponent(component) {
+  const props = component.props || {};
+  return {
+    ...component,
+    // Preserve ALL properties
+    props: {
+      ...props,
+      // Preserve ALL props properties
+      header: props.header ? props.header === "linkToPrevious" ? "linkToPrevious" : props.header.map((m) => normalizeComponent(m)) : void 0,
+      footer: props.footer ? props.footer === "linkToPrevious" ? "linkToPrevious" : props.footer.map((m) => normalizeComponent(m)) : void 0
+    },
+    children: component.children ? component.children.map(normalizeComponent) : void 0
+  };
+}
+function normalizeDocument(document) {
+  if (document.name !== "docx") {
+    throw new Error(
+      'Top-level document must be a docx component with name="docx"'
+    );
+  }
+  const normalized = normalizeComponent(document);
+  return [normalized];
+}
+
+// src/quality/facts.ts
+init_widthUtils();
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function pageBox(theme, themeName, pageOverride) {
+  const page = createSectionProperties(
+    getColumnSettings("single"),
+    theme,
+    themeName,
+    "nextPage",
+    pageOverride
+  ).page;
+  return {
+    availableWidthTwips: Math.max(
+      0,
+      page.size.width - page.margin.left - page.margin.right
+    ),
+    pageBottomTwips: page.size.height
+  };
+}
+function tableFact(props, path3, availableWidthTwips) {
+  const columns = Array.isArray(props.columns) ? props.columns : void 0;
+  if (!columns) return void 0;
+  let totalWidthTwips = 0;
+  let hasExplicitWidth = false;
+  let pointSum = 0;
+  let percentSum = 0;
+  const explicitWidths = [];
+  columns.forEach((column, index) => {
+    const width = asRecord(column)?.width;
+    if (typeof width === "number" && Number.isFinite(width)) {
+      hasExplicitWidth = true;
+      explicitWidths.push({ index, width });
+      totalWidthTwips += relativeLengthToTwips(width, availableWidthTwips);
+      pointSum += width;
+    } else if (typeof width === "string") {
+      hasExplicitWidth = true;
+      const percent = width.trim().endsWith("%") ? Number(width.trim().slice(0, -1)) : Number.NaN;
+      if (Number.isFinite(percent)) {
+        explicitWidths.push({ index, width });
+        percentSum += percent;
+        totalWidthTwips += Math.max(
+          0,
+          Math.round(availableWidthTwips * percent / 100)
+        );
+      }
+    }
+  });
+  return {
+    id: `docx:table-width:${path3}`,
+    kind: "docx/table-width",
+    path: `${path3}/props/columns`,
+    totalWidthTwips,
+    availableWidthTwips,
+    hasExplicitWidth,
+    allColumnsExplicit: explicitWidths.length === columns.length,
+    pointSum,
+    percentSum,
+    explicitWidths
+  };
+}
+var TWIPS_PER_POINT3 = 20;
+var SINGLE_LINE_RATIO = 1.2;
+function finiteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function lineHeightPt(fontSizePt, spacing) {
+  const rule = asRecord(spacing);
+  const value = finiteNumber(rule?.value);
+  switch (rule?.type) {
+    // `exactly` is an absolute line box, and display type routinely sets it
+    // below the font size — reading it as a multiplier would inflate every
+    // estimate on exactly the headings that matter most.
+    case "exactly":
+      return value ?? fontSizePt * SINGLE_LINE_RATIO;
+    case "atLeast":
+      return Math.max(value ?? 0, fontSizePt * SINGLE_LINE_RATIO);
+    case "multiple":
+      return fontSizePt * SINGLE_LINE_RATIO * (value ?? 1);
+    default:
+      return fontSizePt * SINGLE_LINE_RATIO;
+  }
+}
+function characterSpacingPt(spacing) {
+  const rule = asRecord(spacing);
+  const value = finiteNumber(rule?.value);
+  if (rule === void 0 || value === void 0) return 0;
+  return rule.type === "condensed" ? -value / TWIPS_PER_POINT3 : value / TWIPS_PER_POINT3;
+}
+function frameSignature(floating) {
+  const horizontal = asRecord(floating.horizontalPosition);
+  const vertical = asRecord(floating.verticalPosition);
+  return JSON.stringify([
+    floating.width ?? null,
+    floating.height ?? null,
+    horizontal?.offset ?? null,
+    horizontal?.relative ?? null,
+    horizontal?.align ?? null,
+    vertical?.offset ?? null,
+    vertical?.relative ?? null,
+    vertical?.align ?? null,
+    asRecord(floating.wrap)?.type ?? null
+  ]);
+}
+function frameTextFact(props, path3, page, frameChainId, flowIndex) {
+  const floating = asRecord(props.floating);
+  const frameWidthTwips = finiteNumber(floating?.width);
+  if (frameWidthTwips === void 0) return void 0;
+  const text = typeof props.text === "string" ? props.text : "";
+  if (text.trim() === "") return void 0;
+  const font = asRecord(props.font);
+  const fontSizePt = finiteNumber(font?.size);
+  if (fontSizePt === void 0) return void 0;
+  const longestWord = text.split(/\s+/).reduce(
+    (longest, word) => word.length > longest.length ? word : longest,
+    ""
+  );
+  const horizontal = asRecord(floating?.horizontalPosition);
+  const vertical = asRecord(floating?.verticalPosition);
+  const offsetX = finiteNumber(horizontal?.offset);
+  const offsetY = finiteNumber(vertical?.offset);
+  const absolutelyPinned = horizontal?.offset !== void 0 || vertical?.offset !== void 0;
+  const resolvable = (horizontal?.offset === void 0 || offsetX !== void 0) && (vertical?.offset === void 0 || offsetY !== void 0);
+  return {
+    id: `docx:frame-text:${path3}`,
+    kind: "docx/frame-text",
+    path: path3,
+    text,
+    fontSizePt,
+    lineHeightPt: lineHeightPt(fontSizePt, font?.lineSpacing),
+    characterSpacingPt: characterSpacingPt(font?.characterSpacing),
+    frameWidthTwips,
+    ...finiteNumber(floating?.height) !== void 0 && {
+      frameHeightTwips: finiteNumber(floating?.height)
+    },
+    ...offsetY !== void 0 && { offsetYTwips: offsetY },
+    pageBottomTwips: page.pageBottomTwips,
+    longestWord,
+    ...absolutelyPinned && resolvable && {
+      absoluteOffsetTwips: { x: offsetX ?? 0, y: offsetY ?? 0 }
+    },
+    anchorHorizontal: typeof horizontal?.relative === "string" ? horizontal.relative : "page",
+    anchorVertical: typeof vertical?.relative === "string" ? vertical.relative : "page",
+    frameChainId,
+    flowIndex
+  };
+}
+var SVG_VIEWBOX = /viewBox\s*=\s*"\s*(-?[\d.]+)[\s,]+(-?[\d.]+)[\s,]+(-?[\d.]+)[\s,]+(-?[\d.]+)\s*"/;
+var SVG_TEXT = /<text\b([^>]*)>([^<]*)<\/text>/g;
+var SVG_ATTR = (name) => new RegExp(`\\b${name}\\s*=\\s*"(-?[\\d.]+)"`);
+function svgTextFacts(props, path3) {
+  const svg = typeof props.svg === "string" ? props.svg : void 0;
+  if (!svg) return [];
+  const box = SVG_VIEWBOX.exec(svg);
+  if (!box) return [];
+  const viewBoxMinY = Number(box[2]);
+  const viewBoxHeight = Number(box[4]);
+  if (!Number.isFinite(viewBoxMinY) || !Number.isFinite(viewBoxHeight)) {
+    return [];
+  }
+  const facts = [];
+  let match;
+  SVG_TEXT.lastIndex = 0;
+  let index = 0;
+  while ((match = SVG_TEXT.exec(svg)) !== null) {
+    const [, attributes, content] = match;
+    const baselineY = Number(SVG_ATTR("y").exec(attributes)?.[1]);
+    if (!Number.isFinite(baselineY)) {
+      index += 1;
+      continue;
+    }
+    const fontSizeUnits = Number(
+      SVG_ATTR("font-size").exec(attributes)?.[1] ?? 0
+    );
+    facts.push({
+      id: `docx:svg-text:${path3}:${index}`,
+      kind: "docx/svg-text",
+      path: `${path3}/props/svg`,
+      content: content.trim(),
+      baselineY,
+      fontSizeUnits: Number.isFinite(fontSizeUnits) ? fontSizeUnits : 0,
+      viewBoxMinY,
+      viewBoxHeight
+    });
+    index += 1;
+  }
+  return facts;
+}
+function walkActive(node, path3, page, visit) {
+  const rec = asRecord(node);
+  if (!rec || rec.enabled === false) return;
+  visit(rec, path3, page);
+  const children = Array.isArray(rec.children) ? rec.children : [];
+  children.forEach(
+    (child, index) => walkActive(child, `${path3}/children/${index}`, page, visit)
+  );
+}
+function prepareDocxQualityDocument(document, options = {}) {
+  const context = options.context ?? resolveThemeContext(normalizeDocument(document)[0], {
+    customThemes: options.customThemes,
+    fonts: options.fonts,
+    warnings: options.warnings
+  });
+  const resolved = resolveDocumentTree(context.document, context.theme);
+  const basePage = pageBox(resolved.theme, context.themeName);
+  const facts = [];
+  const provenance = {};
+  let previousHeadingLevel;
+  const addFact = (fact) => {
+    facts.push(fact);
+    provenance[fact.id] = {
+      path: fact.path,
+      ...fact.relatedPaths && { relatedPaths: fact.relatedPaths }
+    };
+  };
+  let previousVisitPath;
+  let lastFrame;
+  let flowIndex = 0;
+  const parentOf = (path3) => path3.slice(0, path3.lastIndexOf("/"));
+  const visit = (node, path3, page) => {
+    const props = asRecord(node.props) ?? {};
+    if (node.name === "table") {
+      const fact = tableFact(props, path3, page.availableWidthTwips);
+      if (fact) addFact(fact);
+    }
+    if (node.name === "paragraph" || node.name === "text-box") {
+      const floating = asRecord(props.floating);
+      if (floating) {
+        const signature = frameSignature(floating);
+        const chainId = lastFrame !== void 0 && previousVisitPath === lastFrame.path && parentOf(lastFrame.path) === parentOf(path3) && lastFrame.signature === signature ? lastFrame.chainId : `docx:frame-chain:${path3}`;
+        lastFrame = { path: path3, signature, chainId };
+        const fact = frameTextFact(props, path3, page, chainId, flowIndex);
+        if (fact) addFact(fact);
+      }
+    }
+    if (node.name === "image" || node.name === "visual") {
+      for (const fact of svgTextFacts(props, path3)) addFact(fact);
+    }
+    if (node.name === "heading") {
+      const level = typeof props.level === "number" && Number.isFinite(props.level) ? props.level : 1;
+      addFact({
+        id: `docx:heading:${path3}`,
+        kind: "docx/heading",
+        path: `${path3}/props/level`,
+        level,
+        ...previousHeadingLevel !== void 0 && {
+          previousLevel: previousHeadingLevel
+        }
+      });
+      previousHeadingLevel = level;
+    }
+    previousVisitPath = path3;
+  };
+  resolved.children.forEach((component, index) => {
+    const rec = component;
+    if (rec.name === "section") flowIndex += 1;
+    const page = rec.name === "section" ? pageBox(resolved.theme, context.themeName, rec.props?.page) : basePage;
+    walkActive(component, `/children/${index}`, page, visit);
+  });
+  return {
+    format: "docx",
+    model: {
+      authored: document,
+      context,
+      document: resolved,
+      themeName: context.themeName
+    },
+    facts,
+    provenance,
+    renderer: options.renderer ?? DEFAULT_DOCX_RENDERER_ID2
+  };
+}
+
 // src/core/generateFromIr.ts
 var UncompiledComponentError = class extends Error {
   code = "UNCOMPILED_COMPONENT";
@@ -11354,11 +11845,14 @@ async function compileDocumentToIr(document, options = {}, collector) {
   );
 }
 async function compileDocumentScoped(document, options, warnings) {
-  const context = options.context ?? resolveThemeContext(normalizeDocument(document)[0], {
+  const prepared = options.prepared ?? prepareDocxQualityDocument(document, {
     customThemes: options.customThemes,
     fonts: options.fonts,
-    warnings
+    warnings,
+    context: options.context,
+    renderer: options.renderer
   });
+  const { context } = prepared.model;
   const hasVisual = collectVisualProps(context.document).length > 0;
   const resolvedFonts = await resolveDocumentFonts(
     context.document,
@@ -11374,9 +11868,10 @@ async function compileDocumentScoped(document, options, warnings) {
     ...options.baseDir !== void 0 ? { baseDir: options.baseDir } : {},
     ...visualFonts.length > 0 ? { visualFonts } : {}
   });
-  const structure = await processDocument(
+  const resolved = desugared === context.document ? prepared.model.document : resolveDocumentTree(desugared, context.theme);
+  const structure = await processResolvedDocument(
     desugared,
-    context.theme,
+    resolved,
     context.themeName,
     resolveGenerationDate(options)
   );