@json-to-office/core-docx 6.8.0 → 7.0.0

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) {
@@ -3792,7 +3793,9 @@ function createDocxJsRenderer() {
 function buildDocument(ir, resources = /* @__PURE__ */ new Map()) {
   return new Document({
     styles: emitStyles(ir.styles),
-    sections: ir.sections.map((section2) => sectionOptions(section2, resources)),
+    sections: ir.sections.map(
+      (section2, index) => sectionOptions(section2, resources, index === ir.sections.length - 1)
+    ),
     ...coreProperties(ir),
     features: {
       updateFields: ir.settings.updateFields,
@@ -3948,7 +3951,7 @@ function collectImagePlacements(ir) {
   }
   return placements;
 }
-function sectionOptions(section2, resources) {
+function sectionOptions(section2, resources, closesDocument = false) {
   const { page, columns } = section2.properties;
   const options = {
     properties: {
@@ -3987,7 +3990,7 @@ function sectionOptions(section2, resources) {
         }
       } : {}
     },
-    children: sectionChildren(section2, resources)
+    children: sectionChildren(section2, resources, closesDocument)
   };
   const headers = chromeSlots(section2.headers, Header, resources);
   if (headers) options.headers = headers;
@@ -4009,12 +4012,13 @@ function chromeSlots(set, Part, resources) {
 function partChildren(part, resources) {
   return part.children.map((block2) => emitBlock(block2, resources));
 }
-function sectionChildren(section2, resources) {
+function sectionChildren(section2, resources, closesDocument = false) {
   const blocks = section2.children.map((block2) => emitBlock(block2, resources));
   const bookmark = section2.bookmark;
-  if (!bookmark) return blocks;
+  const endsInFrame = closesDocument && lastBlockIsFrame(section2);
+  if (!bookmark && !endsInFrame) return blocks;
   const out = [...blocks];
-  if (bookmark.opens) {
+  if (bookmark?.opens) {
     const start = new BookmarkStart2(bookmark.name, bookmark.id);
     const first = out[0];
     if (first instanceof Paragraph2) {
@@ -4023,20 +4027,26 @@ function sectionChildren(section2, resources) {
       out.unshift(anchorParagraph(start));
     }
   }
-  if (bookmark.closes) {
+  if (bookmark?.closes) {
     const end = new BookmarkEnd2(bookmark.id);
     const last = out[out.length - 1];
-    if (last instanceof Paragraph2) {
+    if (last instanceof Paragraph2 && !endsInFrame) {
       last.addChildElement(end);
     } else {
       out.push(anchorParagraph(end));
     }
+  } else if (endsInFrame) {
+    out.push(anchorParagraph());
   }
   return out;
 }
+function lastBlockIsFrame(section2) {
+  const last = section2.children[section2.children.length - 1];
+  return last?.kind === "paragraph" && last.frame !== void 0;
+}
 function anchorParagraph(anchor) {
   return new Paragraph2({
-    children: [anchor],
+    children: anchor ? [anchor] : [],
     spacing: { before: 0, after: 0, line: 20, lineRule: LineRuleType2.EXACT }
   });
 }
@@ -4855,7 +4865,7 @@ function borders2(value) {
   }
   return out;
 }
-function section(value, ctx) {
+function section(value, ctx, closesDocument = false) {
   const { page, columns } = value.properties;
   return {
     properties: {
@@ -4907,7 +4917,7 @@ function section(value, ctx) {
         }
       } : {}
     },
-    children: sectionChildren2(value, ctx),
+    children: sectionChildren2(value, ctx, closesDocument),
     ...value.headers ? { headers: headerFooterSet(value.headers, ctx) } : {},
     ...value.footers ? { footers: headerFooterSet(value.footers, ctx) } : {}
   };
@@ -4920,8 +4930,16 @@ function headerFooterSet(set, ctx) {
   }
   return out;
 }
-function sectionChildren2(value, ctx) {
+function sectionChildren2(value, ctx, closesDocument = false) {
   const blocks = value.children.map((child) => block(child, ctx));
+  const last = value.children[value.children.length - 1];
+  if (closesDocument && last?.kind === "paragraph" && last.frame !== void 0)
+    blocks.push({
+      paragraph: {
+        children: [],
+        spacing: { before: 0, after: 0, line: 20, lineRule: "exact" }
+      }
+    });
   const bookmark = value.bookmark;
   if (!bookmark) return blocks;
   return [
@@ -5090,7 +5108,9 @@ async function buildDocumentOptions(ir, charts = [], svgRasterFallback) {
   };
   return {
     styles: emitStyles2(ir.styles),
-    sections: ir.sections.map((value) => section(value, ctx)),
+    sections: ir.sections.map(
+      (value, index) => section(value, ctx, index === ir.sections.length - 1)
+    ),
     ...coreProperties2(ir),
     features: {
       updateFields: ir.settings.updateFields,
@@ -6824,7 +6844,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";
@@ -6833,6 +6858,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;
 }
@@ -7008,8 +7054,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
     {
@@ -7480,14 +7526,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 },
@@ -7500,7 +7551,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 },
@@ -10072,9 +10123,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) {
@@ -12365,10 +12417,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
@@ -12424,7 +12476,7 @@ function applyThemeOverrides(theme, overrides) {
 // src/themes/design-system.ts
 init_defaults();
 import {
-  designCanvas,
+  designCanvas as designCanvas2,
   resolveMotif,
   resolveTypeRoles,
   validateDesignColors
@@ -12434,7 +12486,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)) {
@@ -12519,7 +12571,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,
@@ -12883,7 +12935,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
   };
 }
 
@@ -13694,10 +13747,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({
@@ -13708,19 +13758,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) {
@@ -13822,8 +13864,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 = {
@@ -13835,7 +13877,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 = {
@@ -13974,7 +14016,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),
@@ -13982,7 +14024,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({
@@ -14138,6 +14180,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",
@@ -14145,7 +14188,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") {
@@ -14711,6 +14760,8 @@ import {
 // src/quality/rules.ts
 import {
   chartInfoDesignFindings,
+  configurationLabel,
+  configurationSource,
   DEFAULT_MAXIMUM_CHART_SERIES,
   DEFAULT_MAXIMUM_PIE_SLICES,
   fontCountFinding,
@@ -15310,18 +15361,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 = {
@@ -15382,16 +15436,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 }
           }
         }
       ];
@@ -15448,13 +15507,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",
@@ -15511,7 +15573,12 @@ var docxBodyMeasureRule = {
           actual: fact.charactersPerLine,
           expected: wide ? maximum : minimum,
           unit: "characters",
-          values: { source: "profile" }
+          values: {
+            source: configurationSource(
+              configuration,
+              wide ? "maximumCharacters" : "minimumCharacters"
+            )
+          }
         }
       };
     });
@@ -15559,7 +15626,12 @@ var docxSectionContentRule = {
               actual: 0,
               expected: 1,
               unit: "headings",
-              values: { source: "profile" }
+              values: {
+                source: configurationSource(
+                  configuration,
+                  "minimumWordsForHeading"
+                )
+              }
             }
           }
         ];
@@ -15576,7 +15648,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;
@@ -15585,7 +15657,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: [
           {
@@ -15638,7 +15710,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
@@ -15667,17 +15752,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 }
         }
       }
     ];
@@ -15722,7 +15808,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"] }
@@ -15735,14 +15821,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
@@ -17792,7 +17879,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;
@@ -17852,7 +17939,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,
@@ -17900,6 +17987,7 @@ function createBuilderImpl(state) {
         modedDoc: modedDoc2,
         sourceMap: expanded.sourceMap,
         blockPaths: expanded.blocks,
+        pluginOutputs: expanded.pluginOutputs,
         warnings,
         preserveSet,
         processed: {
@@ -17948,8 +18036,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,
@@ -18079,6 +18223,7 @@ function createBuilderImpl(state) {
     generateBuffer,
     generateFile,
     expandStandardDefinition,
+    prepareQuality,
     getComponentNames,
     validate,
     generateSchema,