@json-to-office/core-docx 6.8.1 → 7.0.1

package/dist/index.js

@@ -1389,7 +1389,8 @@ var init_consulting_docx_theme = __esm({
           },
           stat: {
             face: "heading",
-            weight: 700,
+            size: 22,
+            weight: 400,
             color: "accent",
             lineHeight: 1
           },
@@ -1696,7 +1697,7 @@ var init_themes = __esm({
     getTheme = (themeName) => {
       return themes[themeName];
     };
-    getThemeWithFallback = (themeName, fallbackTheme = "minimal") => {
+    getThemeWithFallback = (themeName, fallbackTheme = "consulting") => {
       const theme = getTheme(themeName) || getTheme(fallbackTheme);
       if (!theme) {
         throw new Error(
@@ -1729,7 +1730,7 @@ function resolveTheme(theme, themeName) {
   if (themeName) {
     return getTheme(themeName);
   }
-  return getTheme("minimal");
+  return getTheme("consulting");
 }
 function resolveFontFamily(theme, fontRef) {
   if (!theme?.fonts?.body?.family) {
@@ -1846,6 +1847,21 @@ function getPageDimensions(size) {
   }
   return { width: size.width, height: size.height };
 }
+function themeForSectionPage(theme, page) {
+  if (!page || !page.size && !page.margins) return theme;
+  const base = getPageSetup(theme);
+  return {
+    ...theme,
+    page: {
+      ...theme.page,
+      size: page.size ?? theme.page?.size ?? "A4",
+      margins: { ...theme.page?.margins, ...base.margin, ...page.margins }
+    }
+  };
+}
+function pageSizeDiffers(a, b) {
+  return a.width !== b.width || a.height !== b.height;
+}
 var resolveTableParagraphSpacing, PAGE_SIZES, getTableStyle, getDocumentMargins, getPageSetup;
 var init_layoutUtils = __esm({
   "src/styles/utils/layoutUtils.ts"() {
@@ -3231,7 +3247,7 @@ function emitBlock(block2, resources = /* @__PURE__ */ new Map()) {
   }
 }
 function emitToc(block2) {
-  return new TableOfContents(block2.alias ?? "Table of Contents", {
+  return new ThemedTableOfContents(block2.alias ?? "Table of Contents", {
     ...block2.hyperlink !== void 0 ? { hyperlink: block2.hyperlink } : {},
     ...block2.headingRange ? {
       headingStyleRange: `${block2.headingRange.from}-${block2.headingRange.to}`
@@ -3363,7 +3379,7 @@ function emitBorder(border3) {
     ...border3.spacePoints !== void 0 ? { space: border3.spacePoints } : {}
   };
 }
-var ALIGNMENT2, PAGE_FIELDS, isSequenceField, WRAP_TYPE, VERTICAL_ALIGN, TABLE_ANCHOR, HORIZONTAL_POSITION, VERTICAL_POSITION, BORDER_STYLE;
+var ALIGNMENT2, PAGE_FIELDS, isSequenceField, WRAP_TYPE, ThemedTableOfContents, VERTICAL_ALIGN, TABLE_ANCHOR, HORIZONTAL_POSITION, VERTICAL_POSITION, BORDER_STYLE;
 var init_emit = __esm({
   "src/renderers/docxjs/emit.ts"() {
     "use strict";
@@ -3383,6 +3399,11 @@ var init_emit = __esm({
       tight: TextWrappingType.TIGHT,
       topAndBottom: TextWrappingType.TOP_AND_BOTTOM
     };
+    ThemedTableOfContents = class extends TableOfContents {
+    };
+    Object.defineProperty(ThemedTableOfContents.prototype, "getTabStopsForLevel", {
+      value: () => []
+    });
     VERTICAL_ALIGN = {
       top: VerticalAlign.TOP,
       center: VerticalAlign.CENTER,
@@ -4143,13 +4164,30 @@ import {
   spliceChartXml
 } from "@json-to-office/shared/rendering";
 function spliceInput(chart) {
+  const { bold, ...rest } = chart.textFont;
+  const textFont = rest;
+  const axisTitleFont = { ...rest, bold };
+  const chartTitleFont = {
+    ...rest,
+    fontSize: Math.round(rest.fontSize * CHART_TITLE_SCALE),
+    bold: true
+  };
   return {
     chartType: chart.chartType,
     series: chart.series,
     colors: chart.colors,
+    textFont,
+    titleFont: chartTitleFont,
     ...chart.legendPosition ? { legendPosition: chart.legendPosition } : {},
-    ...chart.categoryAxisTitle ? { categoryAxis: { title: chart.categoryAxisTitle } } : {},
-    ...chart.valueAxisTitle ? { valueAxis: { title: chart.valueAxisTitle } } : {}
+    ...chart.categoryAxisTitle ? {
+      categoryAxis: {
+        title: chart.categoryAxisTitle,
+        titleFont: axisTitleFont
+      }
+    } : {},
+    ...chart.valueAxisTitle ? {
+      valueAxis: { title: chart.valueAxisTitle, titleFont: axisTitleFont }
+    } : {}
   };
 }
 function declareWorkbookContentType(zip) {
@@ -4193,10 +4231,12 @@ function spliceChartParts(zip, charts) {
   }
   declareWorkbookContentType(zip);
 }
+var CHART_TITLE_SCALE;
 var init_chartParts = __esm({
   "src/renderers/office-open/chartParts.ts"() {
     "use strict";
     init_chartWorkbook();
+    CHART_TITLE_SCALE = 1.4;
   }
 });
 
@@ -4742,9 +4782,6 @@ function tocEntry(entry) {
   return {
     paragraph: {
       style: `TOC${entry.level}`,
-      tabStops: [
-        { type: "right", position: TOC_PAGE_TAB_TWIPS, leader: "dot" }
-      ],
       children: [{ text: entry.text }, { children: [{ tab: true }] }]
     }
   };
@@ -4774,13 +4811,18 @@ function table(value, ctx) {
   return {
     rows: value.rows.map((row) => tableRow(row, ctx)),
     width: {
-      size: value.width.kind === "auto" ? 0 : value.width.value,
+      // `w:w` is an integer in OOXML. A grid that splits a remainder between
+      // unstated columns comes out fractional, and the XML would carry it
+      // verbatim; floored here, as the docxjs backend floors it.
+      size: value.width.kind === "auto" ? 0 : value.width.kind === "twips" ? Math.floor(value.width.value) : value.width.value,
       type: value.width.kind === "twips" ? "dxa" : value.width.kind === "percent" ? "pct" : "auto"
     },
     layout: value.layout,
     // An empty grid is a table with nothing to say about its columns, which is
     // not the same as one whose columns are all zero wide.
-    ...value.columnGrid.values.length > 0 ? { columnWidths: value.columnGrid.values } : {},
+    ...value.columnGrid.values.length > 0 ? {
+      columnWidths: value.columnGrid.unit === "twips" ? value.columnGrid.values.map(Math.floor) : value.columnGrid.values
+    } : {},
     ...value.alignment ? { alignment: alignment(value.alignment) } : {},
     ...value.borders ? { borders: borders2(value.borders) } : {},
     ...value.cellMargins ? { margins: cellMargins(value.cellMargins) } : {},
@@ -4972,7 +5014,7 @@ function numberingConfig2(numbering) {
     }))
   };
 }
-var WRAP_TYPE2, BODY_ANCHOR, TOC_PAGE_TAB_TWIPS;
+var WRAP_TYPE2, BODY_ANCHOR;
 var init_emit2 = __esm({
   "src/renderers/office-open/emit.ts"() {
     "use strict";
@@ -4988,7 +5030,6 @@ var init_emit2 = __esm({
       middle: "ctr",
       bottom: "b"
     };
-    TOC_PAGE_TAB_TWIPS = 9025;
   }
 });
 
@@ -5269,7 +5310,9 @@ function addPngTextChunk(data, marker) {
     }
     offset = chunkEnd;
   }
-  return Buffer.concat([data, marker]);
+  throw new Error(
+    "Cannot mark a PNG that has no intact IEND chunk; its bytes were not checked to decode before rendering"
+  );
 }
 function addJpegComment(data, marker) {
   if (data.length < 2 || data[0] !== 255 || data[1] !== 216) {
@@ -5968,6 +6011,7 @@ function containsComponent(root, name) {
 }
 
 // src/core/desugarExternals.ts
+init_layoutUtils();
 import {
   clampVisualDpi as clampVisualDpi2,
   DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI2,
@@ -6171,8 +6215,18 @@ async function desugarExternals(document, options) {
     }
   ).catch(() => /* @__PURE__ */ new Map());
   const chartCache = /* @__PURE__ */ new Map();
-  return transformComponents(document, async (node) => {
+  const replace = (theme, inSection) => async function replaceNode(node) {
     if (node.enabled === false) return void 0;
+    if (node.name === "section" && !inSection) {
+      const page = node.props.page;
+      return transformComponents(
+        node,
+        replace(themeForSectionPage(theme, page), true)
+      );
+    }
+    return replaceExternal(node, theme);
+  };
+  const replaceExternal = async (node, theme) => {
     if (node.name === "visual") {
       if (isNativeVisualProps2(node.props)) return void 0;
       return withNodeIdentity(node, {
@@ -6190,7 +6244,7 @@ async function desugarExternals(document, options) {
         name: "image",
         props: await renderChartToImageProps(
           node.props,
-          options.theme,
+          theme,
           options.services?.highcharts,
           options.chartFonts,
           options.warnings,
@@ -6199,7 +6253,8 @@ async function desugarExternals(document, options) {
       });
     }
     return void 0;
-  });
+  };
+  return transformComponents(document, replace(options.theme, false));
 }
 async function visualImageProps(props, prerastered, options) {
   const serviceConfig = options.services?.pptx;
@@ -6234,6 +6289,7 @@ init_imageUtils();
 import {
   isNativeVisualProps as isNativeVisualProps3
 } from "@json-to-office/shared-docx";
+import { imageIntegrityDefect } from "@json-to-office/shared/images/node";
 async function loadImageResources(components) {
   const sources = /* @__PURE__ */ new Set();
   for (const component of components) collectSources(component, sources);
@@ -6243,6 +6299,8 @@ async function loadImageResources(components) {
     [...sources].map(async (source) => {
       try {
         const result = await getImageBuffer(source);
+        const defect = imageIntegrityDefect(result.buffer);
+        if (defect) throw new Error(defect);
         const intrinsic = readIntrinsic(result.buffer, source);
         loaded.set(source, {
           bytes: result.buffer,
@@ -6843,7 +6901,12 @@ function resolveColors(entries, at, deps) {
 init_themes();
 init_colorUtils();
 init_styleHelpers();
-import { capsFormatting, synthesizeFamilyName } from "@json-to-office/shared";
+import {
+  capsFormatting,
+  designCanvas,
+  synthesizeFamilyName,
+  typeScaleSizes
+} from "@json-to-office/shared";
 var RIGHT_MARGIN_TAB_TWIPS = 9026 * 2;
 var STATISTIC_NUMBER_STYLE_ID = "StatisticNumber";
 var STATISTIC_DESCRIPTION_STYLE_ID = "StatisticDescription";
@@ -6852,6 +6915,27 @@ var STATISTIC_SIZE_POINTS = {
   medium: 28,
   large: 40
 };
+function statisticSizes(theme, size) {
+  const sizeOf = (style) => {
+    const value = theme.styles?.[style]?.size;
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+  };
+  const role = sizeOf("stat");
+  const medium = sizeOf(STATISTIC_NUMBER_STYLE_ID) ?? role ?? STATISTIC_SIZE_POINTS.medium;
+  const scale = role === void 0 ? void 0 : theme.typography?.scale?.[designCanvas("docx", theme.page?.size)];
+  const steps = scale ? typeScaleSizes(scale) : [];
+  const below = [...steps].reverse().find((step) => step < medium - 0.01);
+  const above = steps.find((step) => step > medium + 0.01);
+  const number = size === "small" ? role !== void 0 && below !== void 0 ? below : STATISTIC_SIZE_POINTS.small : size === "large" ? role !== void 0 && above !== void 0 ? above : STATISTIC_SIZE_POINTS.large : medium;
+  const label = sizeOf("label");
+  return {
+    number,
+    medium,
+    // Half-points in the document, floored at 6pt.
+    suffix: label ?? Math.max(12, Math.round(number)) / 2,
+    description: sizeOf(STATISTIC_DESCRIPTION_STYLE_ID) ?? label ?? 10
+  };
+}
 function getStyleSafe(theme, styleName) {
   return theme.styles && Object.hasOwn(theme.styles, styleName) ? theme.styles[styleName] : void 0;
 }
@@ -7027,8 +7111,8 @@ function chromeRun(fontProps, theme, sizeHalfPoints) {
     ...fontProps.italic !== void 0 && { italic: fontProps.italic }
   };
 }
-function createDocumentStyles(themeNameOrObject = "minimal", language) {
-  const theme = typeof themeNameOrObject === "string" ? getTheme(themeNameOrObject) || getTheme("minimal") : themeNameOrObject;
+function createDocumentStyles(themeNameOrObject = "consulting", language) {
+  const theme = typeof themeNameOrObject === "string" ? getTheme(themeNameOrObject) || getTheme("consulting") : themeNameOrObject;
   const paragraphStyles = [
     // Normal body text style
     {
@@ -7499,14 +7583,19 @@ function createDocumentStyles(themeNameOrObject = "minimal", language) {
   };
 }
 function createStatisticStyles(theme) {
+  const sizes = statisticSizes(theme, "medium");
+  const stat = theme.styles?.stat;
+  const faces = ["heading", "body", "mono", "light"];
+  const face = faces.find((candidate) => candidate === stat?.font) ?? "heading";
+  const weight = typeof stat?.fontWeight === "number" ? stat.fontWeight : void 0;
   const definitions = [
     {
       id: STATISTIC_NUMBER_STYLE_ID,
       name: "Statistic Number",
-      font: "heading",
-      sizePoints: STATISTIC_SIZE_POINTS.medium,
-      color: theme.colors.primary,
-      bold: true,
+      font: face,
+      sizePoints: sizes.medium,
+      color: typeof stat?.color === "string" ? stat.color : theme.colors.primary,
+      bold: weight === void 0 ? true : weight >= 600,
       // Space above separates the figure from whatever preceded it; none below,
       // because the description is the other half of the same block.
       spacing: { before: 12, after: 0 },
@@ -7519,7 +7608,7 @@ function createStatisticStyles(theme) {
       id: STATISTIC_DESCRIPTION_STYLE_ID,
       name: "Statistic Description",
       font: "body",
-      sizePoints: 10,
+      sizePoints: sizes.description,
       color: theme.colors.textMuted,
       bold: false,
       spacing: { before: 0, after: 12 },
@@ -9138,8 +9227,25 @@ function resolveSectionChrome(sections) {
   });
 }
 function compileSection(section2, index, ordinal, chrome, ctx) {
+  const documentTheme = ctx.theme;
+  ctx.theme = themeForSectionPage(documentTheme, section2.pageOverride);
+  try {
+    return compileSectionBody(section2, index, ordinal, chrome, ctx);
+  } finally {
+    ctx.theme = documentTheme;
+  }
+}
+function compileSectionBody(section2, index, ordinal, chrome, ctx) {
   const path4 = `sections[${index}]`;
   const { page, column } = section2.properties;
+  if (section2.forcedPageBreak) {
+    warnOnce(
+      ctx,
+      "section",
+      `${path4} is set to continue on the page but changes the paper size or orientation, which a continuous section break cannot do, so it starts on a new page instead. Set pageBreak: true on the section to say so, or keep the page size of the section before it.`,
+      "W_SECTION_PAGE_BREAK_FORCED"
+    );
+  }
   if (column && column.count > 1) {
     ctx.features.require("columns", `${path4}.properties.columns`);
   }
@@ -10091,9 +10197,10 @@ function compileStatistic(component, scope) {
     );
   }
   const text = (value) => normalizeUnicodeText(String(value ?? ""));
-  const numberPoints = STATISTIC_SIZE_POINTS[String(props.size)] ?? STATISTIC_SIZE_POINTS.medium;
-  const resized = numberPoints !== STATISTIC_SIZE_POINTS.medium;
-  const suffixHalfPoints = Math.max(12, Math.round(numberPoints));
+  const sizes = statisticSizes(ctx.theme, props.size);
+  const numberPoints = sizes.number;
+  const resized = numberPoints !== sizes.medium;
+  const suffixHalfPoints = Math.round(sizes.suffix * 2);
   const numberRuns = [];
   const numberText = text(props.number);
   if (numberText) {
@@ -10993,6 +11100,24 @@ function compileImage2(component, scope) {
   return blocks;
 }
 var DEFAULT_CHART_HEIGHT_INCHES = 3;
+var MAX_CHART_TEXT_POINTS = 10;
+function chartTextFont(theme) {
+  const bodySize = getThemeFonts(theme).body?.size;
+  let color = "000000";
+  try {
+    color = resolveColor("textPrimary", theme);
+  } catch {
+  }
+  return {
+    fontFamily: resolveFontFamily(theme, "body"),
+    fontSize: Math.min(
+      typeof bodySize === "number" && bodySize > 0 ? bodySize : 11,
+      MAX_CHART_TEXT_POINTS
+    ),
+    bold: false,
+    color
+  };
+}
 function compileChart(component, scope) {
   const { ctx, path: path4 } = scope;
   const props = component.props ?? {};
@@ -11061,6 +11186,7 @@ function compileChart(component, scope) {
     ...props.legendPos ? { legendPosition: props.legendPos } : {},
     ...typeof props.catAxisTitle === "string" ? { categoryAxisTitle: props.catAxisTitle } : {},
     ...typeof props.valAxisTitle === "string" ? { valueAxisTitle: props.valAxisTitle } : {},
+    textFont: chartTextFont(ctx.theme),
     ...typeof props.alt === "string" && props.alt ? { altText: props.alt } : {},
     ...props.floating ? { floating: compileFloating(props.floating, ctx, path4) } : {}
   };
@@ -11799,6 +11925,18 @@ init_styles();
 init_widthUtils();
 function applyLayout(sections, theme, themeName) {
   const layoutSections = [];
+  const push = (layoutSection) => {
+    const previous = layoutSections[layoutSections.length - 1];
+    if (previous && layoutSection.properties.type === "continuous" && pageSizeDiffers(
+      previous.properties.page.size,
+      layoutSection.properties.page.size
+    )) {
+      layoutSection.properties.type = "nextPage";
+      layoutSection.breakBefore = true;
+      layoutSection.forcedPageBreak = true;
+    }
+    layoutSections.push(layoutSection);
+  };
   for (let i = 0; i < sections.length; i++) {
     const section2 = sections[i];
     const layoutGroups = analyzeLayoutGroups(section2.components);
@@ -11807,7 +11945,7 @@ function applyLayout(sections, theme, themeName) {
       const isFirstSection = i === 0;
       const breakBefore = isFirstSection || Boolean(section2.pageBreak);
       const sectionType2 = breakBefore ? "nextPage" : "continuous";
-      layoutSections.push({
+      push({
         properties: createSectionProperties(
           getColumnSettings("single"),
           theme,
@@ -11829,7 +11967,12 @@ function applyLayout(sections, theme, themeName) {
     for (let j = 0; j < layoutGroups.length; j++) {
       const group = layoutGroups[j];
       const isSingleColumnsGroup = group.components.length === 1 && isColumnsComponent(group.components[0]);
-      const columnSettings = isSingleColumnsGroup ? createColumnSettingsFromConfig(group.components[0], theme, themeName) : getColumnSettings(group.layout);
+      const columnSettings = isSingleColumnsGroup ? createColumnSettingsFromConfig(
+        group.components[0],
+        // Percentages are of this section's text measure, not the theme's.
+        theme ? themeForSectionPage(theme, section2.page) : theme,
+        themeName
+      ) : getColumnSettings(group.layout);
       const isFirstSection = i === 0 && j === 0;
       const titlelessSectionBreak = Boolean(section2.pageBreak && j === 0);
       const breakBefore = group.breakBefore || isFirstSection || titlelessSectionBreak;
@@ -11837,7 +11980,7 @@ function applyLayout(sections, theme, themeName) {
       const contentComponents = isSingleColumnsGroup ? processLayoutComponents(
         group.components[0].children || []
       ) : processLayoutComponents(group.components);
-      layoutSections.push({
+      push({
         properties: createSectionProperties(
           columnSettings,
           theme,
@@ -12384,10 +12527,10 @@ import {
 } from "@json-to-office/quality";
 import { DEFAULT_DOCX_RENDERER_ID as DEFAULT_DOCX_RENDERER_ID2 } from "@json-to-office/shared-docx";
 import {
-  designCanvas as designCanvas2,
+  designCanvas as designCanvas3,
   designColors as designColors2,
   resolveDesignColor as resolveDesignColor2,
-  typeScaleSizes
+  typeScaleSizes as typeScaleSizes2
 } from "@json-to-office/shared";
 
 // src/core/generationContext.ts
@@ -12443,7 +12586,7 @@ function applyThemeOverrides(theme, overrides) {
 // src/themes/design-system.ts
 init_defaults();
 import {
-  designCanvas,
+  designCanvas as designCanvas2,
   resolveMotif,
   resolveTypeRoles,
   validateDesignColors
@@ -12453,7 +12596,7 @@ function resolveDocxDesignSystem(theme) {
   const motif = resolveMotif(theme.motif);
   if (!theme.typography && !theme.spacing)
     return motif === theme.motif ? theme : withMotif(theme, motif);
-  const canvas = designCanvas("docx", theme.page.size);
+  const canvas = designCanvas2("docx", theme.page.size);
   const roles = resolveTypeRoles(theme, canvas, theme.fonts.body.size ?? 11);
   const styles = { ...theme.styles };
   for (const [name, role] of Object.entries(roles)) {
@@ -12538,7 +12681,7 @@ function resolveThemeContext(documentIn, options = {}) {
   }
   const document = documentIn.props === void 0 ? { ...documentIn, props: {} } : documentIn;
   const authoredThemeName = document.props.theme || void 0;
-  const baseThemeName = authoredThemeName ?? "minimal";
+  const baseThemeName = authoredThemeName ?? "consulting";
   let theme = resolveNamedTheme ? resolveNamedTheme(
     baseThemeName,
     warnings,
@@ -12902,7 +13045,8 @@ async function expandBlocksWithPlugins(document, theme, plugins, render, preserv
     document: second.standard,
     preserved: first.preserved,
     sourceMap: evaluator.sourceMap,
-    blocks: evaluator.blocks
+    blocks: evaluator.blocks,
+    pluginOutputs: evaluator.pluginOutputs
   };
 }
 
@@ -13713,10 +13857,7 @@ function textSizeFact(node, props, path4, typography, role) {
   };
 }
 function statisticSizeFacts(props, path4, typography) {
-  const named = STATISTIC_SIZE_POINTS[String(props.size)];
-  const styled = (id) => finiteNumber(asRecord2(typography.styles[id])?.size);
-  const numberPoints = named ?? STATISTIC_SIZE_POINTS.medium;
-  const painted = props.size === "small" || props.size === "large" ? numberPoints : styled("StatisticNumber") ?? numberPoints;
+  const sizes = statisticSizes(typography.theme, props.size);
   const present = (value) => value !== void 0 && value !== null && String(value).trim() !== "";
   const facts = [];
   const add = (suffix, role, fontSizePt) => facts.push({
@@ -13727,19 +13868,11 @@ function statisticSizeFacts(props, path4, typography) {
     fontSizePt,
     authored: false
   });
-  if (present(props.number)) add("number", "statistic", painted);
+  if (present(props.number)) add("number", "statistic", sizes.number);
   if (present(props.unit) || present(props.trend) || present(props.trendValue))
-    add(
-      "suffix",
-      "statistic-suffix",
-      Math.max(12, Math.round(numberPoints)) / 2
-    );
+    add("suffix", "statistic-suffix", sizes.suffix);
   if (present(props.description))
-    add(
-      "description",
-      "statistic-description",
-      styled("StatisticDescription") ?? 10
-    );
+    add("description", "statistic-description", sizes.description);
   return facts;
 }
 function tocSizeFacts(props, path4, typography) {
@@ -13841,8 +13974,8 @@ function prepareDocxQualityDocument(document, options = {}) {
     fonts: options.fonts,
     warnings: options.warnings
   });
-  const expanded = expandBlocks(themed.document, themed.theme);
-  const context = expanded.blocks.length > 0 ? { ...themed, document: expanded.document } : themed;
+  const expanded = options.expanded ?? expandBlocks(themed.document, themed.theme);
+  const context = options.expanded !== void 0 || expanded.blocks.length > 0 ? { ...themed, document: expanded.document } : themed;
   const resolved = resolveDocumentTree(context.document, context.theme);
   const basePage = pageBox(resolved.theme, context.themeName);
   const typography = {
@@ -13854,7 +13987,7 @@ function prepareDocxQualityDocument(document, options = {}) {
   let previousHeadingLevel;
   const authoredPath = (path4) => toAuthoredPointer(
     themed.sourceMap ?? {},
-    toAuthoredPointer(expanded.sourceMap, path4)
+    toAuthoredPointer(expanded.sourceMap, path4, expanded.pluginOutputs)
   );
   const addFact = (raw) => {
     const fact = {
@@ -13993,7 +14126,7 @@ function prepareDocxQualityDocument(document, options = {}) {
     );
     if (size) roleSizesPt[key] = size.fontSizePt;
   }
-  const scale = resolved.theme.typography?.scale?.[designCanvas2("docx", resolved.theme.page?.size)];
+  const scale = resolved.theme.typography?.scale?.[designCanvas3("docx", resolved.theme.page?.size)];
   const typeScalePt = [
     .../* @__PURE__ */ new Set([
       ...Object.values(roleSizesPt),
@@ -14001,7 +14134,7 @@ function prepareDocxQualityDocument(document, options = {}) {
         const size = resolveFontSize(resolved.theme, role);
         return size === void 0 ? [] : [size];
       }),
-      ...scale ? typeScaleSizes(scale) : []
+      ...scale ? typeScaleSizes2(scale) : []
     ])
   ].sort((a, b) => a - b);
   addFact({
@@ -14157,6 +14290,7 @@ function prepareDocxQualityDocument(document, options = {}) {
       for (const fact of svgTextFacts(props, path4)) addFact(fact);
       const drawn = drawnRatio(props);
       const natural = readableRatio(props);
+      const authored = authoredPropsAt(path4);
       addFact({
         id: `docx:image:${path4}`,
         kind: "docx/image",
@@ -14164,7 +14298,13 @@ function prepareDocxQualityDocument(document, options = {}) {
         ...typeof props.alt === "string" && props.alt.trim() !== "" && { alt: props.alt },
         captioned: isCaptioned(facts, authoredPath(path4)),
         ...drawn !== void 0 && { drawnRatio: drawn },
-        ...natural !== void 0 && { naturalRatio: natural }
+        ...natural !== void 0 && { naturalRatio: natural },
+        ...authoredPath(path4) === path4 && finiteNumber(authored?.width) !== void 0 && finiteNumber(authored?.height) !== void 0 && {
+          authoredSizePx: {
+            width: authored.width,
+            height: authored.height
+          }
+        }
       });
     }
     if (node.name === "heading") {
@@ -14730,6 +14870,8 @@ import {
 // src/quality/rules.ts
 import {
   chartInfoDesignFindings,
+  configurationLabel,
+  configurationSource,
   DEFAULT_MAXIMUM_CHART_SERIES,
   DEFAULT_MAXIMUM_PIE_SLICES,
   fontCountFinding,
@@ -15329,18 +15471,21 @@ var docxRequiredChromeRule = {
     if (required.length === 0) return [];
     return facts.filter(
       (fact) => fact.kind === "docx/chrome-slot"
-    ).filter((fact) => required.includes(fact.role) && !fact.present).map((fact) => ({
-      path: fact.path,
-      relatedPaths: [fact.invocation],
-      message: `${fact.block} states no ${fact.role} in its "${fact.slot}" slot; the ${profile?.id ?? "selected"} profile expects one on every ${fact.block}.`,
-      suggestion: `Fill the "${fact.slot}" slot. The theme already styles it.`,
-      context: { block: fact.block, slot: fact.slot, role: fact.role },
-      evidence: {
-        actual: "empty",
-        expected: fact.role,
-        values: { source: "profile", required }
-      }
-    }));
+    ).filter((fact) => required.includes(fact.role) && !fact.present).map((fact) => {
+      const source = configurationSource(configuration, "required");
+      return {
+        path: fact.path,
+        relatedPaths: [fact.invocation],
+        message: `${fact.block} states no ${fact.role} in its "${fact.slot}" slot; ${configurationLabel(source, profile)} expects one on every ${fact.block}.`,
+        suggestion: `Fill the "${fact.slot}" slot. The theme already styles it.`,
+        context: { block: fact.block, slot: fact.slot, role: fact.role },
+        evidence: {
+          actual: "empty",
+          expected: fact.role,
+          values: { source, required }
+        }
+      };
+    });
   }
 };
 var docxExhibitRequiredRule = {
@@ -15401,16 +15546,21 @@ var docxRunningHeadRule = {
       const missing = required.filter((part) => !fact[part]);
       if (missing.length === 0) return [];
       const parts = missing.map((part) => part === "pageNumber" ? "page-number field" : part).join(", ");
+      const source = configurationSource(
+        configuration,
+        "required",
+        "fromSection"
+      );
       return [
         {
           path: fact.path,
-          message: `Section ${fact.index + 1} carries no ${parts}; the ${profile?.id ?? "selected"} profile expects a running head on every section after the cover.`,
+          message: `Section ${fact.index + 1} carries no ${parts}; ${configurationLabel(source, profile)} expects a running head ` + (from === 0 ? "on every section." : `on every section from section ${from + 1} on.`),
           suggestion: "Invoke a running-head block at the top of the first body section: its section effect fills every later section with the title and n / N.",
           context: { section: fact.index, missing },
           evidence: {
             actual: required.filter((part) => fact[part]),
             expected: required,
-            values: { source: "profile", fromSection: from }
+            values: { source, fromSection: from }
           }
         }
       ];
@@ -15467,13 +15617,16 @@ var docxSizeCountRule = {
   formats: ["docx"],
   defaultEnabled: false,
   defaultParameters: { maximumSizes: 8 },
-  evaluate: ({ facts, configuration, profile }) => sizeCountFinding(
-    paintedSizes(facts),
-    numberParameter(configuration.parameters, "maximumSizes", 8),
-    themeFact(facts)?.path ?? "/props",
-    profile?.id,
-    DOCX_TYPE_VOCABULARY
-  )
+  evaluate: ({ facts, configuration, profile }) => {
+    const source = configurationSource(configuration, "maximumSizes");
+    return sizeCountFinding(
+      paintedSizes(facts),
+      numberParameter(configuration.parameters, "maximumSizes", 8),
+      themeFact(facts)?.path ?? "/props",
+      { source, label: configurationLabel(source, profile) },
+      DOCX_TYPE_VOCABULARY
+    );
+  }
 };
 var docxRoleDriftRule = {
   id: "docx/role-drift",
@@ -15530,7 +15683,12 @@ var docxBodyMeasureRule = {
           actual: fact.charactersPerLine,
           expected: wide ? maximum : minimum,
           unit: "characters",
-          values: { source: "profile" }
+          values: {
+            source: configurationSource(
+              configuration,
+              wide ? "maximumCharacters" : "minimumCharacters"
+            )
+          }
         }
       };
     });
@@ -15578,7 +15736,12 @@ var docxSectionContentRule = {
               actual: 0,
               expected: 1,
               unit: "headings",
-              values: { source: "profile" }
+              values: {
+                source: configurationSource(
+                  configuration,
+                  "minimumWordsForHeading"
+                )
+              }
             }
           }
         ];
@@ -15595,7 +15758,7 @@ var docxHeadingKeepNextRule = {
   defaultCertainty: "deterministic",
   formats: ["docx"],
   defaultEnabled: false,
-  evaluate: ({ facts }) => facts.filter(
+  evaluate: ({ facts, configuration }) => facts.filter(
     (fact) => fact.kind === "docx/heading" && !fact.keepNext
   ).map((fact) => {
     const heading = /\/props\/level$/.test(fact.path) ? fact.path.replace(/\/props\/level$/, "") : void 0;
@@ -15604,7 +15767,7 @@ var docxHeadingKeepNextRule = {
       message: "This heading is not bound to the content under it: a page break can leave it alone at the foot of a page.",
       suggestion: heading ? "Set keepNext on the heading, or give the theme\u2019s heading style keepNext so every level is bound." : "Give the theme\u2019s heading style keepNext, or set it in the block definition that draws this heading.",
       context: { level: fact.level },
-      evidence: { values: { source: "profile" } },
+      evidence: { values: { source: configurationSource(configuration) } },
       ...heading && {
         fixes: [
           {
@@ -15657,7 +15820,20 @@ var docxImageAspectRule = {
         {
           path: fact.path,
           drawn: fact.drawnRatio,
-          natural: fact.naturalRatio
+          natural: fact.naturalRatio,
+          ...fact.authoredSizePx && {
+            sides: {
+              width: {
+                path: `${fact.path}/props/width`,
+                value: fact.authoredSizePx.width
+              },
+              height: {
+                path: `${fact.path}/props/height`,
+                value: fact.authoredSizePx.height
+              },
+              decimals: 0
+            }
+          }
         },
         "page",
         tolerance
@@ -15686,17 +15862,18 @@ var docxContentsRule = {
       (fact) => fact.kind === "docx/outline"
     );
     if (!outline || outline.contents || outline.headings < minimum) return [];
+    const source = configurationSource(configuration, "minimumHeadings");
     return [
       {
         path: outline.path,
-        message: `The document carries ${outline.headings} headings and no table of contents; the ${profile?.id ?? "selected"} profile expects one from ${minimum}.`,
+        message: `The document carries ${outline.headings} headings and no table of contents; ${configurationLabel(source, profile)} expects one from ${minimum}.`,
         suggestion: "Add a `toc` component after the cover. Word fills it from the headings already there.",
         context: { headings: outline.headings, minimum },
         evidence: {
           actual: outline.headings,
           expected: minimum,
           unit: "headings",
-          values: { source: "profile" }
+          values: { source }
         }
       }
     ];
@@ -15741,7 +15918,7 @@ var DOCX_QUALITY_PROFILES = {
   "client-report": {
     id: "client-report",
     formats: ["docx"],
-    description: "Client or public-administration report: a running head with page numbers on every section after the cover, a takeaway and a source wherever a block declares them, no heading skipped, every size on the theme scale with at most eleven in play, a readable measure, no empty or untitled section, every heading bound to what follows and every figure named, no page rendered empty or left half blank under the running head, and at least one chart or table.",
+    description: "Client or public-administration report: a running head with page numbers on every section after the cover, a takeaway and a source wherever a block declares them, no heading skipped, every size on the theme scale with at most nine in play, a readable measure, no empty or untitled section, every heading bound to what follows and every figure named, no page rendered empty or left half blank under the running head, and at least one chart or table.",
     rules: {
       "docx/required-chrome": {
         parameters: { required: ["takeaway", "source"] }
@@ -15754,14 +15931,15 @@ var DOCX_QUALITY_PROFILES = {
       },
       "docx/heading-hierarchy": { severity: "warning" },
       "docx/type-scale": { enabled: true },
-      // Measured 2026-09-15 with statistics, lists and contents counted: a
-      // client report built from the house blocks paints up to eleven sizes —
-      // body, heading 1 and 2, subtitle, display, table cells and headers,
-      // source and chrome, and the kpi-row's figure, its unit and its label
-      // (28, 14 and 10pt, or 20 and 10 in a row of four). Every one of the
-      // reports of the #360 checkpoint and the #409 verification set came in
-      // at eleven or fewer; a size past the house set is an ad-hoc one.
-      "docx/size-count": { enabled: true, parameters: { maximumSizes: 11 } },
+      // Measured 2026-09-16 with statistics, lists and contents counted, once
+      // a statistic paints in the theme's roles (#454): a client report built
+      // from the house blocks paints up to nine sizes — 8 (source, chrome),
+      // 9 (labels, the kpi-row's unit and caption), 9.5 (table cells), 10.5
+      // (body), 12.5 and 16 (headings), 13 (subtitle), 18 (a four-up kpi
+      // figure) and 22 (display, the kpi figure). The 155 client reports of
+      // the checkpoint, host-study and verification runs came in at nine or
+      // fewer; a size past the house set is an ad-hoc one.
+      "docx/size-count": { enabled: true, parameters: { maximumSizes: 9 } },
       "docx/role-drift": { enabled: true },
       // The report blocks place every figure in a captioned block, so a page
       // with no text under the running head is a stray break or an empty
@@ -17811,7 +17989,7 @@ function createBuilderImpl(state) {
     }
     return new Set(list);
   }
-  async function expandDocument(document, options) {
+  async function expandDocument(document, options, provenance = false) {
     const preserveSet = resolvePreserveSet(options);
     const rootIn = document;
     const internalDocument = rootIn.props === void 0 ? { ...rootIn, props: {} } : rootIn;
@@ -17871,7 +18049,7 @@ function createBuilderImpl(state) {
       warnings,
       resolveNamedTheme: resolveDocumentTheme
     });
-    if (modedRoot.props.blocks !== void 0) {
+    if (modedRoot.props.blocks !== void 0 || provenance) {
       const expanded = await expandBlocksWithPlugins(
         modedRoot,
         modedTheme,
@@ -17919,6 +18097,7 @@ function createBuilderImpl(state) {
         modedDoc: modedDoc2,
         sourceMap: expanded.sourceMap,
         blockPaths: expanded.blocks,
+        pluginOutputs: expanded.pluginOutputs,
         warnings,
         preserveSet,
         processed: {
@@ -17967,8 +18146,64 @@ function createBuilderImpl(state) {
       throw error;
     }
   }
+  async function prepareQuality(document, options) {
+    const {
+      modedRoot,
+      modedTheme,
+      themeName,
+      modedDoc,
+      sourceMap,
+      blockPaths,
+      pluginOutputs,
+      warnings
+    } = await expandDocument(document, options, true);
+    const prepared = prepareDocxQualityDocument(
+      document,
+      {
+        context: { document: modedRoot, theme: modedTheme, themeName },
+        expanded: {
+          document: modedDoc,
+          sourceMap: sourceMap ?? {},
+          blocks: blockPaths ?? [],
+          ...pluginOutputs && { pluginOutputs }
+        },
+        customThemes: state.customThemes,
+        fonts: state.fonts,
+        renderer: options?.renderer ?? state.renderer ?? modedRoot.renderer,
+        warnings
+      }
+    );
+    return { prepared, warnings: warnings.length > 0 ? warnings : null };
+  }
+  async function generateBufferFromPrepared(prepared, options) {
+    const { context } = prepared.model;
+    const warnings = [];
+    const baseDir = options?.baseDir ?? state.baseDir;
+    const deterministic = options?.deterministic ?? state.deterministic;
+    const generatedAt = options?.generatedAt ?? state.generatedAt;
+    const renderer = options?.renderer ?? state.renderer ?? prepared.renderer;
+    const { buffer } = await generateBufferViaIr(context.document, {
+      context,
+      prepared,
+      ...state.services ? { services: state.services } : {},
+      ...state.fonts ? { fonts: state.fonts } : {},
+      ...baseDir !== void 0 ? { baseDir } : {},
+      ...deterministic !== void 0 ? { deterministic } : {},
+      ...generatedAt !== void 0 ? { generatedAt } : {},
+      ...renderer !== void 0 ? { renderer } : {},
+      warnings
+    });
+    return {
+      buffer,
+      warnings: warnings.length > 0 ? warnings : null,
+      standardDefinition: context.document,
+      preservedDefinition: void 0
+    };
+  }
   async function generateBuffer(document, options) {
     try {
+      const reused = options?.prepared && resolvePreserveSet(options) === void 0 ? options.prepared : void 0;
+      if (reused) return await generateBufferFromPrepared(reused, options);
       const {
         modedRoot,
         modedTheme,
@@ -18098,6 +18333,7 @@ function createBuilderImpl(state) {
     generateBuffer,
     generateFile,
     expandStandardDefinition,
+    prepareQuality,
     getComponentNames,
     validate,
     generateSchema,