@json-to-office/core-docx 2.5.0 → 2.7.0

package/dist/index.js

@@ -238,43 +238,6 @@ var init_colorUtils = __esm({
   }
 });
 
-// src/utils/generationContext.ts
-import { AsyncLocalStorage } from "async_hooks";
-import { isAbsolute, resolve } from "path";
-function runWithBaseDir(baseDir, callback) {
-  return baseDir === void 0 ? callback() : baseDirStorage.run(resolve(baseDir), callback);
-}
-function resolveFromBaseDir(filePath) {
-  const base = baseDirStorage.getStore();
-  if (!base || isAbsolute(filePath)) return filePath;
-  return resolve(base, filePath);
-}
-function runWithWarnings(warnings, callback) {
-  return warnings === void 0 ? callback() : warningsStorage.run(warnings, callback);
-}
-function reportWarning(component, code, message, context) {
-  const warnings = warningsStorage.getStore();
-  if (warnings) {
-    warnings.push({
-      component,
-      message,
-      severity: "warning",
-      context: { code, ...context }
-    });
-    return;
-  }
-  console.warn(`[json-to-docx] [${code}] ${message}`);
-}
-var generationDateStorage, baseDirStorage, warningsStorage;
-var init_generationContext = __esm({
-  "src/utils/generationContext.ts"() {
-    "use strict";
-    generationDateStorage = new AsyncLocalStorage();
-    baseDirStorage = new AsyncLocalStorage();
-    warningsStorage = new AsyncLocalStorage();
-  }
-});
-
 // src/templates/themes/minimal.docx.theme.json
 var minimal_docx_theme_default;
 var init_minimal_docx_theme = __esm({
@@ -880,6 +843,320 @@ var init_vermilion_docx_theme = __esm({
   }
 });
 
+// src/templates/themes/consulting.docx.theme.json
+var consulting_docx_theme_default;
+var init_consulting_docx_theme = __esm({
+  "src/templates/themes/consulting.docx.theme.json"() {
+    consulting_docx_theme_default = {
+      name: "consulting",
+      displayName: "Consulting House",
+      description: "The house style for client and technical reports \u2014 near-black ink, three greys and one deep-blue accent, Calibri body under Arial headings, hairline rules, no fills behind body text, safe fonts only",
+      version: "1.0.0",
+      colors: {
+        primary: "#1A1F26",
+        secondary: "#4B5563",
+        accent: "#1B4F8A",
+        text: "#1A1F26",
+        background: "#FFFFFF",
+        border: "#C9CED6",
+        textPrimary: "#1A1F26",
+        textSecondary: "#4B5563",
+        textMuted: "#7B8794",
+        borderPrimary: "#C9CED6",
+        borderSecondary: "#E4E7EB",
+        backgroundPrimary: "#FFFFFF",
+        backgroundSecondary: "#F2F4F7",
+        accent4: "#5B8DC9",
+        accent5: "#A9C4E4",
+        accent6: "#7B8794"
+      },
+      palette: {
+        rule: "#C9CED6",
+        textMuted: "#7B8794",
+        onPrimary: "#FFFFFF",
+        surfaceInverse: "#1A1F26",
+        positive: "#1E7F4F",
+        negative: "#B42318",
+        chart: ["accent", "secondary", "accent4", "textMuted", "accent5", "rule"]
+      },
+      fonts: {
+        heading: { family: "Arial", size: 16 },
+        body: { family: "Calibri", size: 10.5 },
+        mono: { family: "Consolas", size: 9.5 },
+        light: { family: "Arial", size: 16 }
+      },
+      page: {
+        size: "A4",
+        margins: {
+          top: 1440,
+          bottom: 1440,
+          left: 1440,
+          right: 1440,
+          header: 680,
+          footer: 680,
+          gutter: 0
+        }
+      },
+      typography: {
+        roles: {
+          eyebrow: {
+            face: "heading",
+            size: 8,
+            weight: 700,
+            case: "upper",
+            tracking: 8,
+            color: "accent",
+            spaceAfter: 4
+          },
+          display: {
+            face: "heading",
+            weight: 700,
+            color: "primary",
+            lineHeight: 1.05,
+            spaceAfter: 8
+          },
+          stat: {
+            face: "heading",
+            weight: 700,
+            color: "accent",
+            lineHeight: 1
+          },
+          quote: {
+            face: "body",
+            color: "textSecondary",
+            lineHeight: 1.3
+          },
+          label: {
+            face: "body",
+            size: 9,
+            weight: 700,
+            color: "textSecondary"
+          },
+          footer: { face: "body", size: 8, color: "textMuted" },
+          tableHeader: {
+            face: "body",
+            size: 9,
+            weight: 700,
+            color: "primary"
+          },
+          tableCell: { face: "body", size: 9.5, color: "textPrimary" },
+          chartLabel: {
+            face: "body",
+            size: 9,
+            weight: 400,
+            color: "textSecondary"
+          },
+          tracker: {
+            face: "body",
+            size: 8,
+            case: "upper",
+            tracking: 6,
+            color: "textMuted"
+          },
+          source: { face: "body", size: 8, color: "textMuted" }
+        },
+        scale: {
+          a4: { base: 10.5, ratio: 1.2, baselinePt: 2 },
+          letter: { base: 10.5, ratio: 1.2, baselinePt: 2 }
+        }
+      },
+      spacing: {
+        basePt: 8,
+        blockGap: { tight: 4, normal: 8, loose: 16 },
+        canvas: {
+          a4: { safeAreaIn: 1, gutterIn: 0, columns: 12 },
+          letter: { safeAreaIn: 1, gutterIn: 0, columns: 12 }
+        }
+      },
+      chrome: {
+        runningHead: {
+          type: "tracker",
+          color: "textMuted",
+          rule: { weightPt: 0.5, color: "rule" },
+          alignment: "right"
+        },
+        tracker: {
+          type: "tracker",
+          color: "textMuted",
+          alignment: "right"
+        },
+        actionTitle: { type: "display", color: "primary" },
+        keyTakeaways: {
+          type: "label",
+          color: "primary",
+          rule: { weightPt: 2, color: "accent" },
+          padPt: 8
+        },
+        sourceLine: { type: "source", color: "textMuted" },
+        confidentialFooter: {
+          type: "footer",
+          color: "textMuted",
+          rule: { weightPt: 0.5, color: "rule" },
+          alignment: "left"
+        },
+        logoSlot: { alignment: "right" },
+        cover: {
+          type: "display",
+          color: "primary",
+          rule: { weightPt: 3, color: "accent" }
+        }
+      },
+      motif: {
+        kind: "rule",
+        color: "accent",
+        weightPt: 3,
+        placement: "top"
+      },
+      styles: {
+        normal: {
+          font: "body",
+          color: "textPrimary",
+          lineSpacing: { type: "multiple", value: 1.2 },
+          alignment: "left",
+          spacing: { after: 8 }
+        },
+        title: {
+          font: "heading",
+          size: 26,
+          bold: true,
+          color: "primary",
+          alignment: "left",
+          lineSpacing: { type: "multiple", value: 1.05 },
+          spacing: { before: 0, after: 6 }
+        },
+        subtitle: {
+          font: "body",
+          size: 13,
+          color: "textSecondary",
+          alignment: "left",
+          lineSpacing: { type: "multiple", value: 1.2 },
+          spacing: { before: 0, after: 18 }
+        },
+        heading1: {
+          font: "heading",
+          size: 16,
+          bold: true,
+          color: "primary",
+          lineSpacing: { type: "multiple", value: 1.1 },
+          spacing: { before: 24, after: 8 },
+          keepNext: true,
+          alignment: "left",
+          borders: {
+            bottom: { style: "single", size: 4, color: "rule", space: 4 }
+          }
+        },
+        heading2: {
+          font: "heading",
+          size: 12.5,
+          bold: true,
+          color: "primary",
+          spacing: { before: 16, after: 6 },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading3: {
+          font: "body",
+          size: 11,
+          bold: true,
+          color: "primary",
+          spacing: { before: 12, after: 4 },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading4: {
+          font: "body",
+          size: 10.5,
+          bold: true,
+          color: "textSecondary",
+          spacing: { before: 10, after: 4 },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading5: {
+          font: "body",
+          size: 10.5,
+          bold: false,
+          italic: true,
+          color: "textSecondary",
+          spacing: { before: 8, after: 4 },
+          keepNext: true,
+          alignment: "left"
+        },
+        heading6: {
+          font: "body",
+          size: 9,
+          bold: true,
+          case: "upper",
+          color: "textMuted",
+          characterSpacing: { type: "expanded", value: 20 },
+          spacing: { before: 8, after: 4 },
+          keepNext: true,
+          alignment: "left"
+        },
+        TOC1: {
+          font: "body",
+          size: 10.5,
+          bold: true,
+          color: "textPrimary",
+          spacing: { before: 4, after: 3 },
+          tabStops: [{ type: "right", position: 9026, leader: "none" }]
+        },
+        TOC2: {
+          font: "body",
+          size: 10.5,
+          color: "textSecondary",
+          indent: { left: 240 },
+          spacing: { after: 2 },
+          tabStops: [{ type: "right", position: 9026, leader: "none" }]
+        },
+        TOC3: {
+          font: "body",
+          size: 10,
+          color: "textMuted",
+          indent: { left: 480 },
+          spacing: { after: 2 },
+          tabStops: [{ type: "right", position: 9026, leader: "none" }]
+        }
+      },
+      componentDefaults: {
+        table: {
+          width: 100,
+          borderColor: "#C9CED6",
+          borderSize: 0.5,
+          hideBorders: { left: true, right: true, insideVertical: true },
+          cellDefaults: {
+            font: { size: 9.5 },
+            padding: { top: 4, bottom: 4 },
+            verticalAlignment: "middle"
+          },
+          headerCellDefaults: {
+            color: "#1A1F26",
+            font: { size: 9, bold: true },
+            padding: { top: 0, bottom: 5 },
+            verticalAlignment: "bottom",
+            borderColor: { bottom: "#1A1F26" },
+            borderSize: { bottom: 0.75 }
+          }
+        },
+        list: {
+          format: "bullet",
+          bullet: "\u2022",
+          spacing: { item: 2 }
+        },
+        image: {
+          alignment: "center"
+        },
+        statistic: {
+          alignment: "left"
+        },
+        section: {
+          pageBreak: false
+        }
+      }
+    };
+  }
+});
+
 // src/templates/themes/index.ts
 import fs from "fs";
 import path from "path";
@@ -894,7 +1171,8 @@ function loadThemesFromJson() {
   const themes2 = {
     minimal: ensureThemeDefaults(minimal_docx_theme_default),
     devportal: ensureThemeDefaults(devportal_docx_theme_default),
-    vermilion: ensureThemeDefaults(vermilion_docx_theme_default)
+    vermilion: ensureThemeDefaults(vermilion_docx_theme_default),
+    consulting: ensureThemeDefaults(consulting_docx_theme_default)
   };
   try {
     const __filename = fileURLToPath(import.meta.url);
@@ -932,7 +1210,7 @@ function loadThemesFromJson() {
   _themesCache = themes2;
   return themes2;
 }
-var _themesCache, themes, getTheme, getThemeWithFallback, hasTheme, getThemeNames, minimalTheme, devportalTheme, vermilionTheme;
+var _themesCache, themes, getTheme, getThemeWithFallback, hasTheme, getThemeNames, minimalTheme, devportalTheme, vermilionTheme, consultingTheme;
 var init_themes = __esm({
   "src/templates/themes/index.ts"() {
     "use strict";
@@ -940,6 +1218,7 @@ var init_themes = __esm({
     init_minimal_docx_theme();
     init_devportal_docx_theme();
     init_vermilion_docx_theme();
+    init_consulting_docx_theme();
     _themesCache = null;
     themes = loadThemesFromJson();
     getTheme = (themeName) => {
@@ -963,6 +1242,7 @@ var init_themes = __esm({
     minimalTheme = themes["minimal"];
     devportalTheme = themes["devportal"];
     vermilionTheme = themes["vermilion"];
+    consultingTheme = themes["consulting"];
   }
 });
 
@@ -1279,6 +1559,43 @@ var init_layoutUtils = __esm({
   }
 });
 
+// src/utils/generationContext.ts
+import { AsyncLocalStorage } from "async_hooks";
+import { isAbsolute, resolve } from "path";
+function runWithBaseDir(baseDir, callback) {
+  return baseDir === void 0 ? callback() : baseDirStorage.run(resolve(baseDir), callback);
+}
+function resolveFromBaseDir(filePath) {
+  const base = baseDirStorage.getStore();
+  if (!base || isAbsolute(filePath)) return filePath;
+  return resolve(base, filePath);
+}
+function runWithWarnings(warnings, callback) {
+  return warnings === void 0 ? callback() : warningsStorage.run(warnings, callback);
+}
+function reportWarning(component, code, message, context) {
+  const warnings = warningsStorage.getStore();
+  if (warnings) {
+    warnings.push({
+      component,
+      message,
+      severity: "warning",
+      context: { code, ...context }
+    });
+    return;
+  }
+  console.warn(`[json-to-docx] [${code}] ${message}`);
+}
+var generationDateStorage, baseDirStorage, warningsStorage;
+var init_generationContext = __esm({
+  "src/utils/generationContext.ts"() {
+    "use strict";
+    generationDateStorage = new AsyncLocalStorage();
+    baseDirStorage = new AsyncLocalStorage();
+    warningsStorage = new AsyncLocalStorage();
+  }
+});
+
 // src/themes/json/parser.ts
 import { validateThemeJson } from "@json-to-office/shared-docx/validation/unified";
 var ThemeValidationError, ThemeParseError, ThemeParser;
@@ -4688,7 +5005,10 @@ async function resolveDocumentFonts(document, theme, fonts, warnings, forceMater
 }
 
 // src/core/generateFromIr.ts
-import { toRasterizeFontFaces } from "@json-to-office/shared/fonts/node";
+import {
+  toChartFontFaces,
+  toRasterizeFontFaces
+} from "@json-to-office/shared/fonts/node";
 
 // src/core/prerasterizeVisuals.ts
 import {
@@ -5106,6 +5426,87 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
   return map;
 }
 
+// src/core/componentTransform.ts
+async function transformComponents(doc, replace) {
+  return await walk(doc, replace);
+}
+async function walk(node, replace) {
+  if (Array.isArray(node)) {
+    return Promise.all(node.map((child) => walk(child, replace)));
+  }
+  if (!node || typeof node !== "object") return node;
+  const obj = node;
+  if (typeof obj.name === "string" && obj.props) {
+    const replacement = await replace(obj);
+    if (replacement) return replacement;
+  }
+  const next = { ...obj };
+  if (Array.isArray(obj.children)) {
+    next.children = await walk(obj.children, replace);
+  }
+  if (obj.props && typeof obj.props === "object") {
+    const props = obj.props;
+    let changed = false;
+    const nextProps = { ...props };
+    for (const key of ["header", "footer"]) {
+      if (Array.isArray(props[key])) {
+        nextProps[key] = await walk(props[key], replace);
+        changed = true;
+      }
+    }
+    if (Array.isArray(props.columns)) {
+      nextProps.columns = await Promise.all(
+        props.columns.map(
+          (column) => walkColumn(column, replace)
+        )
+      );
+      changed = true;
+    }
+    if (changed) next.props = nextProps;
+  }
+  return next;
+}
+async function walkColumn(column, replace) {
+  if (!column || typeof column !== "object") return column;
+  const source = column;
+  const next = { ...source };
+  const header = source.header;
+  if (header && typeof header === "object" && "content" in header) {
+    next.header = { ...header, content: await walk(header.content, replace) };
+  }
+  if (Array.isArray(source.cells)) {
+    next.cells = await Promise.all(
+      source.cells.map(async (cell) => {
+        if (cell && typeof cell === "object" && "content" in cell) {
+          const source2 = cell;
+          return { ...source2, content: await walk(source2.content, replace) };
+        }
+        return cell;
+      })
+    );
+  }
+  return next;
+}
+function withNodeIdentity(original, replacement) {
+  const out = { ...replacement };
+  if (original.id !== void 0) out.id = original.id;
+  if (original.enabled !== void 0) out.enabled = original.enabled;
+  return out;
+}
+function containsComponent(root, name) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  const visit = (node) => {
+    if (!node || typeof node !== "object" || seen.has(node)) return false;
+    seen.add(node);
+    if (Array.isArray(node)) return node.some(visit);
+    const obj = node;
+    if (typeof obj.name === "string" && obj.enabled === false) return false;
+    if (obj.name === name && obj.props !== void 0) return true;
+    return Object.values(obj).some(visit);
+  };
+  return visit(root);
+}
+
 // src/core/desugarExternals.ts
 import {
   clampVisualDpi as clampVisualDpi2,
@@ -5117,6 +5518,14 @@ import {
 
 // src/components/highcharts.ts
 init_colorUtils();
+init_layoutUtils();
+import {
+  chartFamilyResolver,
+  chartPointsPerPixel,
+  POINTS_PER_PIXEL_96DPI,
+  withChartFontFaceCss,
+  withChartTypography
+} from "@json-to-office/shared";
 var DEFAULT_EXPORT_SERVER_URL = "http://localhost:7801";
 async function generateChart(config, servicesConfig) {
   if (!isNodeEnvironment()) {
@@ -5180,84 +5589,81 @@ function withThemeColors(config, theme) {
     options: { ...config.options, colors: palette }
   };
 }
-async function renderChartToImageProps(props, theme, servicesConfig) {
-  const config = withThemeColors(props, theme);
-  const chart = await generateChart(config, servicesConfig);
-  const hasConfigDimensions = config.width !== void 0 || config.height !== void 0;
-  return {
-    base64: chart.base64DataUri,
-    width: hasConfigDimensions ? config.width : chart.width,
-    height: hasConfigDimensions ? config.height : chart.height,
-    alignment: "center"
-  };
-}
-
-// src/core/componentTransform.ts
-async function transformComponents(doc, replace) {
-  return await walk(doc, replace);
-}
-async function walk(node, replace) {
-  if (Array.isArray(node)) {
-    return Promise.all(node.map((child) => walk(child, replace)));
-  }
-  if (!node || typeof node !== "object") return node;
-  const obj = node;
-  if (typeof obj.name === "string" && obj.props) {
-    const replacement = await replace(obj);
-    if (replacement) return replacement;
+var POINTS_PER_TWIP = 1 / 20;
+var POINTS_PER_PIXEL = POINTS_PER_PIXEL_96DPI;
+function placedWidthPt(config, theme) {
+  const { width, height } = config;
+  const chart = config.options.chart;
+  if (typeof width === "number") return width * POINTS_PER_PIXEL;
+  if (typeof width === "string") {
+    const page = getPageSetup(theme);
+    const contentWidthPt = (page.size.width - page.margin.left - page.margin.right) * POINTS_PER_TWIP;
+    return parseFloat(width) / 100 * contentWidthPt;
   }
-  const next = { ...obj };
-  if (Array.isArray(obj.children)) {
-    next.children = await walk(obj.children, replace);
+  if (typeof height === "number" && chart.height > 0) {
+    return height / chart.height * chart.width * POINTS_PER_PIXEL;
   }
-  if (obj.props && typeof obj.props === "object") {
-    const props = obj.props;
-    let changed = false;
-    const nextProps = { ...props };
-    for (const key of ["header", "footer"]) {
-      if (Array.isArray(props[key])) {
-        nextProps[key] = await walk(props[key], replace);
-        changed = true;
-      }
-    }
-    if (Array.isArray(props.columns)) {
-      nextProps.columns = await Promise.all(
-        props.columns.map(
-          (column) => walkColumn(column, replace)
-        )
-      );
-      changed = true;
-    }
-    if (changed) next.props = nextProps;
-  }
-  return next;
+  return void 0;
 }
-async function walkColumn(column, replace) {
-  if (!column || typeof column !== "object") return column;
-  const source = column;
-  const next = { ...source };
-  const header = source.header;
-  if (header && typeof header === "object" && "content" in header) {
-    next.header = { ...header, content: await walk(header.content, replace) };
-  }
-  if (Array.isArray(source.cells)) {
-    next.cells = await Promise.all(
-      source.cells.map(async (cell) => {
-        if (cell && typeof cell === "object" && "content" in cell) {
-          const source2 = cell;
-          return { ...source2, content: await walk(source2.content, replace) };
-        }
-        return cell;
-      })
-    );
+function toHex(token, theme) {
+  return `#${resolveColor(token, theme)}`;
+}
+function themeChartTypography(theme) {
+  const styles = theme.styles ?? {};
+  const family = chartFamilyResolver(theme);
+  const bodyPt = styles.normal?.size ?? theme.fonts.body.size ?? 11;
+  const label = styles.chartLabel;
+  const heading = styles.heading3;
+  const labelPt = label?.size ?? Math.max(bodyPt - 1, 6);
+  return {
+    bodyFamily: family(theme.fonts.body.family),
+    headingFamily: family(theme.fonts.heading.family),
+    textColor: toHex("textPrimary", theme),
+    mutedColor: toHex("textSecondary", theme),
+    labelPt,
+    labelWeight: label?.fontWeight ?? (label?.bold ? 700 : void 0),
+    titlePt: heading?.size ?? bodyPt + 2,
+    titleWeight: heading?.fontWeight ?? (heading?.bold === false ? void 0 : 700),
+    sourcePt: styles.source?.size ?? Math.max(labelPt - 1, 6)
+  };
+}
+function withThemeTypography(config, theme) {
+  if (!theme?.fonts?.body?.family || !theme.fonts.heading?.family) {
+    return config;
   }
-  return next;
+  return {
+    ...config,
+    options: withChartTypography(
+      config.options,
+      themeChartTypography(theme),
+      chartPointsPerPixel(
+        config.options.chart.width,
+        placedWidthPt(config, theme)
+      )
+    )
+  };
 }
-function withNodeIdentity(original, replacement) {
-  const out = { ...replacement };
-  if (original.id !== void 0) out.id = original.id;
-  if (original.enabled !== void 0) out.enabled = original.enabled;
-  return out;
+function withChartFontFaces(config, theme, faces) {
+  if (!faces?.length || !theme?.fonts) return config;
+  return withChartFontFaceCss(config, faces, [
+    theme.fonts.body.family,
+    theme.fonts.heading.family
+  ]);
+}
+async function renderChartToImageProps(props, theme, servicesConfig, chartFonts) {
+  const config = withChartFontFaces(
+    withThemeTypography(withThemeColors(props, theme), theme),
+    theme,
+    chartFonts
+  );
+  const chart = await generateChart(config, servicesConfig);
+  const hasConfigDimensions = config.width !== void 0 || config.height !== void 0;
+  return {
+    base64: chart.base64DataUri,
+    width: hasConfigDimensions ? config.width : chart.width,
+    height: hasConfigDimensions ? config.height : chart.height,
+    alignment: "center"
+  };
 }
 
 // src/core/desugarExternals.ts
@@ -5289,7 +5695,8 @@ async function desugarExternals(document, options) {
         props: await renderChartToImageProps(
           node.props,
           options.theme,
-          options.services?.highcharts
+          options.services?.highcharts,
+          options.chartFonts
         )
       });
     }
@@ -8047,6 +8454,641 @@ function emptyToUndefined(formatting) {
   return entries.length === 0 ? void 0 : Object.fromEntries(entries);
 }
 
+// src/blocks/index.ts
+import {
+  COVER_BUDGET,
+  KEY_TAKEAWAYS_BUDGET,
+  RUNNING_HEAD_BUDGET,
+  SECTION_OPENER_BUDGET
+} from "@json-to-office/shared-docx";
+
+// src/blocks/cover.ts
+init_widthUtils();
+
+// src/blocks/recipe.ts
+var MIN_RULE_PT = 0.25;
+var MAX_RULE_PT = 12;
+function clampRule(weightPt) {
+  return Math.min(MAX_RULE_PT, Math.max(MIN_RULE_PT, weightPt));
+}
+var FALLBACK_EYEBROW_FONT = {
+  size: 9,
+  bold: true,
+  color: "accent",
+  case: "upper"
+};
+function hasStyle(theme, role) {
+  const styles = theme.styles;
+  return styles?.[role] !== void 0;
+}
+function roleProps(theme, role, fallbackFont, color) {
+  if (hasStyle(theme, role)) {
+    return {
+      themeStyle: role,
+      ...color !== void 0 && { font: { color } }
+    };
+  }
+  return { font: { ...fallbackFont, ...color !== void 0 && { color } } };
+}
+
+// src/blocks/cover.ts
+var DROP_SHARE = 0.3;
+var DROP_SHARE_WITH_LOGO = 0.22;
+var DEFAULT_LOGO_WIDTH = "25%";
+var FALLBACK = {
+  ruleWeightPt: 3,
+  ruleColor: "accent",
+  padPt: 12,
+  metaFont: { size: 9, color: "textSecondary" }
+};
+function compileCover(props, theme) {
+  const recipe = theme.chrome?.cover;
+  const ruleWeightPt = recipe?.rule?.weightPt ?? FALLBACK.ruleWeightPt;
+  const padPt = recipe?.padPt ?? FALLBACK.padPt;
+  const heightPt = getAvailableHeightTwips(theme) / 20;
+  const dropPt = Math.round(
+    heightPt * (props.logo ? DROP_SHARE_WITH_LOGO : DROP_SHARE)
+  );
+  const children = [];
+  const sourceMap = {};
+  const emit = (child, slots) => {
+    const index = children.push(child) - 1;
+    sourceMap[`/children/${index}`] = "";
+    for (const [emitted, authored] of Object.entries(slots)) {
+      sourceMap[`/children/${index}${emitted}`] = authored;
+    }
+  };
+  if (props.logo) {
+    const { width, height, ...source } = props.logo;
+    emit(
+      {
+        name: "image",
+        props: {
+          ...source,
+          width: width ?? DEFAULT_LOGO_WIDTH,
+          ...height !== void 0 && { height },
+          alignment: theme.chrome?.logoSlot?.alignment ?? "left",
+          spacing: { before: 0, after: 0 }
+        }
+      },
+      { "/props": "/props/logo" }
+    );
+  }
+  const drawsRule = ruleWeightPt > 0;
+  if (drawsRule) {
+    emit(
+      {
+        name: "divider",
+        props: {
+          thickness: clampRule(ruleWeightPt),
+          color: recipe?.rule?.color ?? FALLBACK.ruleColor,
+          spacing: { before: dropPt, after: padPt }
+        }
+      },
+      {}
+    );
+  }
+  let dropPending = !drawsRule;
+  const before = () => {
+    if (!dropPending) return {};
+    dropPending = false;
+    return { before: dropPt };
+  };
+  if (props.client) {
+    emit(
+      {
+        name: "paragraph",
+        props: {
+          text: props.client,
+          keepNext: true,
+          spacing: { ...before(), after: 4 },
+          ...roleProps(theme, "eyebrow", FALLBACK_EYEBROW_FONT)
+        }
+      },
+      { "/props/text": "/props/client" }
+    );
+  }
+  const titleRole = recipe?.type && hasStyle(theme, recipe.type) ? recipe.type : "title";
+  emit(
+    {
+      name: "paragraph",
+      props: {
+        text: props.title,
+        keepNext: true,
+        ...dropPending && { spacing: before() },
+        ...roleProps(theme, titleRole, { size: 26, bold: true }, recipe?.color)
+      }
+    },
+    { "/props/text": "/props/title" }
+  );
+  if (props.subtitle) {
+    emit(
+      {
+        name: "paragraph",
+        props: {
+          text: props.subtitle,
+          keepNext: true,
+          ...roleProps(theme, "subtitle", { size: 13, color: "textSecondary" })
+        }
+      },
+      { "/props/text": "/props/subtitle" }
+    );
+  }
+  const meta = [props.date, props.confidentiality].filter(
+    (part) => typeof part === "string" && part !== ""
+  );
+  if (meta.length > 0) {
+    emit(
+      {
+        name: "paragraph",
+        props: {
+          text: meta.join("  \xB7  "),
+          spacing: { before: padPt, after: 0 },
+          ...roleProps(theme, "label", FALLBACK.metaFont)
+        }
+      },
+      {
+        "/props/text": props.date ? "/props/date" : "/props/confidentiality"
+      }
+    );
+  }
+  return { children, sourceMap };
+}
+
+// src/blocks/keyTakeaways.ts
+var KEY_TAKEAWAYS_DEFAULT_LABEL = "Key takeaways";
+var FALLBACK_RECIPE = {
+  ruleWeightPt: 1.5,
+  ruleColor: "accent",
+  padPt: 6,
+  type: "label"
+};
+function compileKeyTakeaways(props, theme) {
+  const recipe = theme.chrome?.keyTakeaways;
+  const labelRole = recipe?.type ?? FALLBACK_RECIPE.type;
+  const labelStyle = hasStyle(theme, labelRole);
+  const ruleWeightPt = clampRule(
+    recipe?.rule?.weightPt ?? FALLBACK_RECIPE.ruleWeightPt
+  );
+  const ruleColor = recipe?.rule?.color ?? recipe?.color ?? FALLBACK_RECIPE.ruleColor;
+  const padPt = recipe?.padPt ?? FALLBACK_RECIPE.padPt;
+  const children = [
+    {
+      name: "divider",
+      props: {
+        thickness: ruleWeightPt,
+        color: ruleColor,
+        spacing: { before: 12, after: padPt }
+      }
+    },
+    {
+      name: "paragraph",
+      props: {
+        text: props.label ?? KEY_TAKEAWAYS_DEFAULT_LABEL,
+        keepNext: true,
+        spacing: { after: 4 },
+        // The label role when the theme resolves one; a bold run in the
+        // recipe's colour otherwise, so the label still reads as a label.
+        ...labelStyle ? { themeStyle: labelRole } : {
+          font: {
+            bold: true,
+            ...recipe?.color !== void 0 && { color: recipe.color }
+          }
+        }
+      }
+    },
+    {
+      name: "list",
+      props: { items: [...props.items] }
+    },
+    {
+      name: "divider",
+      props: {
+        thickness: 0.5,
+        color: "borderPrimary",
+        spacing: { before: padPt, after: 12 }
+      }
+    }
+  ];
+  return {
+    children,
+    sourceMap: {
+      "/children/0": "",
+      "/children/1": "",
+      "/children/1/props/text": "/props/label",
+      "/children/2": "",
+      "/children/2/props/items": "/props/items",
+      "/children/3": ""
+    }
+  };
+}
+
+// src/blocks/runningHead.ts
+init_styles();
+init_widthUtils();
+var FALLBACK2 = {
+  headFont: { size: 8, color: "textMuted", case: "upper" },
+  footFont: { size: 8, color: "textMuted" },
+  ruleWeightPt: 0.5,
+  ruleColor: "border"
+};
+var PAGE_OF_TOTAL = "{PAGE} / {TOTAL_PAGES}";
+function sectionMeasureTwips(theme, page) {
+  if (!page || page.size === void 0 && page.margins === void 0) {
+    return getAvailableWidthTwips(theme);
+  }
+  const width = page.size ? getPageDimensions(page.size).width : getPageDimensions(theme.page.size).width;
+  const margins = getDocumentMargins(theme);
+  const left = page.margins?.left ?? margins.left ?? 1440;
+  const right = page.margins?.right ?? margins.right ?? 1440;
+  return Math.max(0, width - left - right);
+}
+function compileRunningHead(props, theme, scope) {
+  const measure = sectionMeasureTwips(theme, scope.page);
+  const head = theme.chrome?.runningHead;
+  const foot = theme.chrome?.confidentialFooter;
+  const slot = (name) => props[name] !== void 0 ? `${scope.block}/props/${name}` : void 0;
+  const header = [];
+  const headerMap = {};
+  const title = props.title ?? scope.documentTitle ?? "";
+  const tracker = scope.opener?.text ?? props.tracker ?? "";
+  if (title !== "" || tracker !== "") {
+    const both = title !== "" && tracker !== "";
+    header.push({
+      name: "paragraph",
+      props: {
+        text: both ? `${title}	${tracker}` : title || tracker,
+        ...both ? { tabStops: [{ type: "right", position: measure }] } : { alignment: title !== "" ? "left" : head?.alignment ?? "right" },
+        spacing: { before: 0, after: 0 },
+        ...roleProps(
+          theme,
+          head?.type ?? "tracker",
+          FALLBACK2.headFont,
+          head?.color
+        )
+      }
+    });
+    headerMap["/0"] = scope.block;
+    headerMap["/0/props/text"] = (tracker !== "" ? scope.opener?.slot ?? slot("tracker") : slot("title")) ?? scope.block;
+  }
+  const headRule = head?.rule?.weightPt ?? FALLBACK2.ruleWeightPt;
+  if (headRule > 0) {
+    header.push({
+      name: "divider",
+      props: {
+        thickness: clampRule(headRule),
+        color: head?.rule?.color ?? FALLBACK2.ruleColor,
+        spacing: { before: 2, after: 0 }
+      }
+    });
+    headerMap[`/${header.length - 1}`] = scope.block;
+  }
+  const footer = [];
+  const footerMap = {};
+  const footRule = foot?.rule?.weightPt ?? FALLBACK2.ruleWeightPt;
+  if (footRule > 0) {
+    footer.push({
+      name: "divider",
+      props: {
+        thickness: clampRule(footRule),
+        color: foot?.rule?.color ?? FALLBACK2.ruleColor,
+        spacing: { before: 0, after: 4 }
+      }
+    });
+    footerMap["/0"] = scope.block;
+  }
+  const parts = [
+    props.confidentiality ?? "",
+    props.pageNumbers === false ? "" : PAGE_OF_TOTAL,
+    props.date ?? ""
+  ];
+  const present = parts.filter((part) => part !== "");
+  if (present.length > 0) {
+    const single = present.length === 1;
+    const alignment2 = present[0] === PAGE_OF_TOTAL ? "center" : foot?.alignment ?? "left";
+    footer.push({
+      name: "paragraph",
+      props: {
+        text: single ? present[0] : parts.join("	").replace(/\t+$/, ""),
+        ...single ? { alignment: alignment2 } : {
+          tabStops: [
+            { type: "center", position: Math.round(measure / 2) },
+            { type: "right", position: measure }
+          ]
+        },
+        spacing: { before: 0, after: 0 },
+        ...roleProps(
+          theme,
+          foot?.type ?? "footer",
+          FALLBACK2.footFont,
+          foot?.color
+        )
+      }
+    });
+    const index = footer.length - 1;
+    footerMap[`/${index}`] = scope.block;
+    footerMap[`/${index}/props/text`] = slot("confidentiality") ?? slot("date") ?? scope.block;
+  }
+  return {
+    header: { children: header, sourceMap: headerMap },
+    footer: { children: footer, sourceMap: footerMap }
+  };
+}
+
+// src/blocks/sectionOpener.ts
+function compileSectionOpener(props, theme) {
+  const children = [];
+  const sourceMap = {};
+  const pageBreak = props.pageBreak === true;
+  if (props.number !== void 0) {
+    children.push({
+      name: "paragraph",
+      props: {
+        text: String(props.number),
+        keepNext: true,
+        spacing: { after: 2 },
+        ...pageBreak && { pageBreak: true },
+        ...roleProps(theme, "eyebrow", FALLBACK_EYEBROW_FONT)
+      }
+    });
+    sourceMap["/children/0"] = "";
+    sourceMap["/children/0/props/text"] = "/props/number";
+  }
+  const index = children.length;
+  children.push({
+    name: "heading",
+    props: {
+      text: props.title,
+      level: 1,
+      ...pageBreak && index === 0 && { pageBreak: true }
+    }
+  });
+  sourceMap[`/children/${index}`] = "";
+  sourceMap[`/children/${index}/props/text`] = "/props/title";
+  return { children, sourceMap };
+}
+function sectionTracker(section2) {
+  if (!Array.isArray(section2.children)) return void 0;
+  for (const [index, child] of section2.children.entries()) {
+    if (typeof child !== "object" || child === null || child.name !== "section-opener" || child.enabled === false) {
+      continue;
+    }
+    const props = child.props;
+    if (!props) continue;
+    if (typeof props.tracker === "string" && props.tracker !== "") {
+      return { text: props.tracker, slot: `/children/${index}/props/tracker` };
+    }
+    if (typeof props.title === "string" && props.title !== "") {
+      return { text: props.title, slot: `/children/${index}/props/title` };
+    }
+  }
+  return void 0;
+}
+
+// src/blocks/index.ts
+var BLOCK_NAMES = [
+  "key-takeaways",
+  "cover",
+  "section-opener",
+  "running-head"
+];
+function slotBudget(block2, props, pointer, slot, maxWords) {
+  const value = props[slot];
+  return typeof value === "string" ? [
+    {
+      block: block2,
+      slot,
+      path: `${pointer}/props/${slot}`,
+      words: wordCount(value),
+      maxWords
+    }
+  ] : [];
+}
+function budgetsOf(block2, budget) {
+  return (props, pointer) => Object.entries(budget).flatMap(
+    ([slot, { maxWords }]) => slotBudget(block2, props, pointer, slot, maxWords)
+  );
+}
+var BLOCKS = {
+  "key-takeaways": {
+    kind: "flow",
+    compile: (props, theme) => compileKeyTakeaways(props, theme),
+    budgets: (props, pointer) => (Array.isArray(props.items) ? props.items : []).flatMap(
+      (item, index) => typeof item === "string" ? [
+        {
+          block: "key-takeaways",
+          slot: "items",
+          path: `${pointer}/props/items/${index}`,
+          words: wordCount(item),
+          maxWords: KEY_TAKEAWAYS_BUDGET.items.maxWords
+        }
+      ] : []
+    )
+  },
+  cover: {
+    kind: "flow",
+    compile: (props, theme) => compileCover(props, theme),
+    budgets: budgetsOf("cover", COVER_BUDGET)
+  },
+  "section-opener": {
+    kind: "flow",
+    compile: (props, theme) => compileSectionOpener(props, theme),
+    budgets: budgetsOf("section-opener", SECTION_OPENER_BUDGET)
+  },
+  "running-head": {
+    kind: "chrome",
+    budgets: budgetsOf("running-head", RUNNING_HEAD_BUDGET)
+  }
+};
+function isBlockName(name) {
+  return BLOCK_NAMES.includes(name);
+}
+function isChromeBlockName(name) {
+  return isBlockName(name) && BLOCKS[name].kind === "chrome";
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var SECTION_CHILD = /^\/children\/\d+\/children\/\d+$/;
+var SECTION = /^\/children\/(\d+)$/;
+function planChrome(document, theme) {
+  const plans = /* @__PURE__ */ new Map();
+  if (!isRecord(document) || document.name !== "docx" || !Array.isArray(document.children)) {
+    return plans;
+  }
+  const metadata = isRecord(document.props) ? document.props.metadata : void 0;
+  const documentTitle = isRecord(metadata) && typeof metadata.title === "string" ? metadata.title : void 0;
+  let inForce;
+  document.children.forEach((section2, index) => {
+    if (!isRecord(section2) || section2.name !== "section" || section2.enabled === false) {
+      return;
+    }
+    const sectionPointer = `/children/${index}`;
+    const children = Array.isArray(section2.children) ? section2.children : [];
+    children.forEach((child, childIndex) => {
+      if (isRecord(child) && isChromeBlockName(child.name) && child.enabled !== false) {
+        inForce = {
+          block: `${sectionPointer}/children/${childIndex}`,
+          props: isRecord(child.props) ? child.props : {}
+        };
+      }
+    });
+    if (!inForce) return;
+    const opener = sectionTracker(section2);
+    const sectionProps = isRecord(section2.props) ? section2.props : {};
+    plans.set(
+      index,
+      compileRunningHead(inForce.props, theme, {
+        block: inForce.block,
+        documentTitle,
+        ...opener && {
+          opener: {
+            text: opener.text,
+            slot: `${sectionPointer}${opener.slot}`
+          }
+        },
+        ...isRecord(sectionProps.page) && {
+          page: sectionProps.page
+        }
+      })
+    );
+  });
+  return plans;
+}
+function expandBlocks(document, theme) {
+  const sourceMap = {};
+  const blocks = [];
+  const chrome = planChrome(document, theme);
+  const walk2 = (node, pointer) => {
+    if (Array.isArray(node)) {
+      return node.map((child, index) => walk2(child, `${pointer}/${index}`));
+    }
+    if (!isRecord(node)) return node;
+    if (typeof node.name === "string" && node.enabled !== false && isBlockName(node.name)) {
+      const definition = BLOCKS[node.name];
+      if (definition.kind === "chrome") {
+        if (!SECTION_CHILD.test(pointer)) return node;
+        blocks.push(pointer);
+        return { ...node, children: [] };
+      }
+      if (isRecord(node.props)) {
+        const compiled = definition.compile(node.props, theme);
+        blocks.push(pointer);
+        for (const [emitted, authored] of Object.entries(compiled.sourceMap)) {
+          sourceMap[`${pointer}${emitted}`] = `${pointer}${authored}`;
+        }
+        return { ...node, children: compiled.children };
+      }
+    }
+    const next = { ...node };
+    if (isRecord(node.props)) {
+      const props = { ...node.props };
+      let changed = false;
+      for (const key of ["header", "footer"]) {
+        if (Array.isArray(props[key])) {
+          props[key] = walk2(props[key], `${pointer}/props/${key}`);
+          changed = true;
+        }
+      }
+      if (Array.isArray(props.columns)) {
+        props.columns = props.columns.map((column, index) => {
+          if (!isRecord(column)) return column;
+          const base = `${pointer}/props/columns/${index}`;
+          const out = { ...column };
+          if (isRecord(column.header) && "content" in column.header) {
+            out.header = {
+              ...column.header,
+              content: walk2(column.header.content, `${base}/header/content`)
+            };
+          }
+          if (Array.isArray(column.cells)) {
+            out.cells = column.cells.map(
+              (cell, cellIndex) => isRecord(cell) && "content" in cell ? {
+                ...cell,
+                content: walk2(
+                  cell.content,
+                  `${base}/cells/${cellIndex}/content`
+                )
+              } : cell
+            );
+          }
+          return out;
+        });
+        changed = true;
+      }
+      if (changed) next.props = props;
+    }
+    if (Array.isArray(node.children)) {
+      next.children = walk2(node.children, `${pointer}/children`);
+    }
+    const section2 = SECTION.exec(pointer);
+    if (section2 && node.name === "section" && node.enabled !== false) {
+      const plan = chrome.get(Number(section2[1]));
+      if (plan) {
+        const props = isRecord(next.props) ? { ...next.props } : {};
+        let changed = false;
+        for (const part of ["header", "footer"]) {
+          const { children, sourceMap: partMap } = plan[part];
+          if (props[part] !== void 0 || children.length === 0) continue;
+          props[part] = children;
+          changed = true;
+          const base = `${pointer}/props/${part}`;
+          sourceMap[base] = partMap["/0"] ?? pointer;
+          for (const [emitted, authored] of Object.entries(partMap)) {
+            sourceMap[`${base}${emitted}`] = authored;
+          }
+        }
+        if (props.pageBreak === void 0) {
+          props.pageBreak = true;
+          changed = true;
+        }
+        if (changed) next.props = props;
+      }
+    }
+    return next;
+  };
+  const expanded = walk2(document, "");
+  return {
+    document: blocks.length > 0 ? expanded : document,
+    sourceMap,
+    blocks
+  };
+}
+function toAuthoredPointer(sourceMap, pointer) {
+  let best;
+  for (const emitted of Object.keys(sourceMap)) {
+    if ((pointer === emitted || pointer.startsWith(`${emitted}/`)) && (best === void 0 || emitted.length > best.length)) {
+      best = emitted;
+    }
+  }
+  if (best === void 0) return pointer;
+  return `${sourceMap[best]}${pointer.slice(best.length)}`;
+}
+function blockSlotBudgets(document, blocks) {
+  return blocks.flatMap((pointer) => {
+    const node = nodeAt(document, pointer);
+    if (!isRecord(node) || !isRecord(node.props) || !isBlockName(node.name)) {
+      return [];
+    }
+    return BLOCKS[node.name].budgets(node.props, pointer);
+  });
+}
+function wordCount(text) {
+  const trimmed = text.trim();
+  return trimmed === "" ? 0 : trimmed.split(/\s+/).length;
+}
+function nodeAt(root, pointer) {
+  if (pointer === "") return root;
+  let current = root;
+  for (const segment of pointer.slice(1).split("/")) {
+    const key = segment.replace(/~1/g, "/").replace(/~0/g, "~");
+    if (Array.isArray(current)) current = current[Number(key)];
+    else if (isRecord(current)) current = current[key];
+    else return void 0;
+  }
+  return current;
+}
+
 // src/ir/compiler.ts
 init_types();
 init_units();
@@ -8344,33 +9386,47 @@ function compileChromeParagraph(component, scope) {
   const text = String(props.text ?? "");
   if (reportUnlowered(component, props, text, scope)) return [];
   const font = props.font ?? {};
-  const normal = getNormalStyle(ctx.theme);
+  const named = chromeStyle(ctx.theme, props.themeStyle);
+  const base = { ...getNormalStyle(ctx.theme), ...named };
+  const styleId = named ? paragraphStyleId(props.themeStyle) ?? "Normal" : "Normal";
+  if (styleId !== "Normal" && !ctx.styleIds.has(styleId)) {
+    ctx.styleIds.add(styleId);
+  }
   const chromeProps = {
     text,
-    ...props.alignment ? { alignment: props.alignment } : {},
+    ...named ? { themeStyle: props.themeStyle } : {},
+    ...props.alignment ? { alignment: props.alignment } : named?.alignment ? { alignment: named.alignment } : {},
     ...props.spacing ? { spacing: props.spacing } : {},
+    ...props.indent ? { indent: props.indent } : {},
+    ...props.tabStops ? { tabStops: props.tabStops } : {},
     ...props.boldColor ? { boldColor: props.boldColor } : {},
     font: {
-      family: font.family || resolveFontFamily(ctx.theme, normal.font) || getThemeFonts(ctx.theme).body.family,
-      size: font.size ?? normal.size ?? 11,
-      color: font.color || normal.color || "textPrimary",
-      bold: font.bold ?? false,
-      italic: font.italic ?? false,
+      family: font.family || resolveFontFamily(ctx.theme, base.font) || getThemeFonts(ctx.theme).body.family,
+      size: font.size ?? base.size ?? 11,
+      color: font.color || base.color || "textPrimary",
+      bold: font.bold ?? base.bold ?? false,
+      italic: font.italic ?? base.italic ?? false,
       ...font.underline !== void 0 ? { underline: font.underline } : {},
-      ...font.fontWeight !== void 0 ? { fontWeight: font.fontWeight } : {},
-      ...font.case !== void 0 ? { case: font.case } : {},
+      ...(font.fontWeight ?? base.fontWeight) !== void 0 ? { fontWeight: font.fontWeight ?? base.fontWeight } : {},
+      ...(font.case ?? base.case) !== void 0 ? { case: font.case ?? base.case } : {},
+      ...(font.characterSpacing ?? base.characterSpacing) !== void 0 ? { characterSpacing: font.characterSpacing ?? base.characterSpacing } : {},
       ...font.lineSpacing !== void 0 ? { lineSpacing: font.lineSpacing } : {}
     }
   };
   return [
     paragraphNode(scope, compileRuns(chromeProps, text, ctx, scope.path), {
-      styleId: "Normal",
+      styleId,
       formatting: paragraphFormatting(chromeProps, ctx, {
         alwaysSpacing: true
       })
     })
   ];
 }
+function chromeStyle(theme, themeStyle) {
+  if (typeof themeStyle !== "string" || !themeStyle) return void 0;
+  const styles = getThemeStyles(theme);
+  return styles[themeStyle] ?? styles[themeStyle.toLowerCase()];
+}
 function compileChromeImage(component, scope) {
   const { ctx, path: path4 } = scope;
   const props = component.props ?? {};
@@ -8458,6 +9514,10 @@ function compileComponent(component, scope) {
     case "table":
       return compileTable(component, scope);
     default:
+      if (isBlockName(component.name)) {
+        if (component.enabled === false) return [];
+        return compileBlock(component, scope);
+      }
       scope.ctx.unsupported.push({
         name: component.name,
         path: scope.path
@@ -8465,6 +9525,20 @@ function compileComponent(component, scope) {
       return [];
   }
 }
+function compileBlock(component, scope) {
+  const children = component.children;
+  if (!Array.isArray(children)) {
+    scope.ctx.unsupported.push({ name: component.name, path: scope.path });
+    return [];
+  }
+  return children.flatMap(
+    (child, index) => compileComponent(child, {
+      ...scope,
+      path: `${scope.path}.children[${index}]`,
+      id: `${scope.id}:b${index}`
+    })
+  );
+}
 var MARKDOWN_LIST_LEVELS = {
   unordered: [
     { level: 0, format: "bullet", text: "\u2022", alignment: "left" },
@@ -12071,11 +13145,13 @@ function walkActive(node, path4, page, visit) {
   );
 }
 function prepareDocxQualityDocument(document, options = {}) {
-  const context = options.context ?? resolveThemeContext(normalizeDocument(document)[0], {
+  const themed = options.context ?? resolveThemeContext(normalizeDocument(document)[0], {
     customThemes: options.customThemes,
     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 resolved = resolveDocumentTree(context.document, context.theme);
   const basePage = pageBox(resolved.theme, context.themeName);
   const typography = {
@@ -12085,13 +13161,28 @@ function prepareDocxQualityDocument(document, options = {}) {
   const facts = [];
   const provenance = {};
   let previousHeadingLevel;
-  const addFact = (fact) => {
+  const authoredPath = (path4) => toAuthoredPointer(expanded.sourceMap, path4);
+  const addFact = (raw) => {
+    const fact = {
+      ...raw,
+      path: authoredPath(raw.path),
+      ...raw.relatedPaths && {
+        relatedPaths: raw.relatedPaths.map(authoredPath)
+      }
+    };
     facts.push(fact);
     provenance[fact.id] = {
       path: fact.path,
       ...fact.relatedPaths && { relatedPaths: fact.relatedPaths }
     };
   };
+  for (const budget of blockSlotBudgets(context.document, expanded.blocks)) {
+    addFact({
+      id: `docx:block-slot:${budget.path}`,
+      kind: "docx/block-slot",
+      ...budget
+    });
+  }
   const paletteHexes = {};
   const visualColors = designColors2(
     resolved.theme.colors,
@@ -12234,7 +13325,16 @@ function prepareDocxQualityDocument(document, options = {}) {
     },
     facts,
     provenance,
-    renderer: options.renderer ?? DEFAULT_DOCX_RENDERER_ID2
+    renderer: options.renderer ?? DEFAULT_DOCX_RENDERER_ID2,
+    ...expanded.blocks.length > 0 && {
+      metadata: {
+        blocks: {
+          sourceMap: expanded.sourceMap,
+          blocks: expanded.blocks,
+          document: context.document
+        }
+      }
+    }
   };
 }
 
@@ -12274,19 +13374,22 @@ async function compileDocumentScoped(document, options, warnings) {
   });
   const { context } = prepared.model;
   const hasVisual = collectVisualProps(context.document).length > 0;
+  const hasHighcharts = containsComponent(context.document, "highcharts");
   const resolvedFonts = await resolveDocumentFonts(
     context.document,
     context.theme,
     options.fonts,
     warnings,
-    hasVisual
+    hasVisual || hasHighcharts
   );
   const visualFonts = hasVisual ? toRasterizeFontFaces(resolvedFonts, warnings) : [];
+  const chartFonts = hasHighcharts ? toChartFontFaces(resolvedFonts) : [];
   const desugared = await desugarExternals(context.document, {
     theme: context.theme,
     ...options.services ? { services: options.services } : {},
     ...options.baseDir !== void 0 ? { baseDir: options.baseDir } : {},
-    ...visualFonts.length > 0 ? { visualFonts } : {}
+    ...visualFonts.length > 0 ? { visualFonts } : {},
+    ...chartFonts.length > 0 ? { chartFonts } : {}
   });
   const resolved = desugared === context.document ? prepared.model.document : resolveDocumentTree(desugared, context.theme);
   const structure = await processResolvedDocument(
@@ -13102,6 +14205,28 @@ var docxPlaceholderRule = {
     })
   )
 };
+var docxSlotBudgetRule = {
+  id: "docx/slot-budget",
+  code: QUALITY_CODES.SLOT_BUDGET,
+  category: "composition",
+  defaultSeverity: "warning",
+  defaultCertainty: "deterministic",
+  formats: ["docx"],
+  evaluate: ({ facts }) => facts.filter(
+    (fact) => fact.kind === "docx/block-slot"
+  ).filter((fact) => fact.words > fact.maxWords).map((fact) => ({
+    path: fact.path,
+    message: `${fact.block} ${fact.slot} entry runs to ${fact.words} words; the slot holds ${fact.maxWords} \u2014 one claim, one sentence.`,
+    suggestion: "Cut it to the conclusion. Move the evidence into the body it summarises.",
+    evidence: {
+      summary: "words in the slot against its budget",
+      actual: fact.words,
+      expected: fact.maxWords,
+      unit: "words"
+    },
+    context: { block: fact.block, slot: fact.slot }
+  }))
+};
 var DEFAULT_MAX_FONT_FAMILIES = 3;
 var docxFontCountRule = {
   id: "docx/font-count",
@@ -13267,6 +14392,7 @@ var DOCX_QUALITY_RULES = {
     docxSvgTextBoundsRule,
     docxLineBoxRule,
     docxPlaceholderRule,
+    docxSlotBudgetRule,
     docxChartRule,
     docxTableDesignRule,
     docxFontCountRule,
@@ -14274,6 +15400,7 @@ function getCoreVersion() {
   return "Core v1.0.0";
 }
 export {
+  BLOCK_NAMES,
   ComponentValidationError2 as ComponentValidationError,
   DocumentGenerator as CoreDocumentGenerator,
   DEFAULT_DOCX_RENDERER_ID,
@@ -14286,7 +15413,13 @@ export {
   UncompiledComponentError,
   UnknownPreservedComponentError,
   analyzeDocxQuality,
+  blockSlotBudgets,
   cleanComponentProps,
+  compileCover,
+  compileKeyTakeaways,
+  compileRunningHead,
+  compileSectionOpener,
+  consultingTheme,
   createComponent,
   createDocumentGenerator,
   createMinimalTheme,
@@ -14296,6 +15429,7 @@ export {
   docxRendererIds,
   docxRendererStatuses,
   examples,
+  expandBlocks,
   exportPluginSchema,
   exportThemeToJson,
   flattenVisuals,
@@ -14315,6 +15449,7 @@ export {
   getExampleNames,
   getVisualPrepassStats,
   hasNodeBuiltins,
+  isChromeBlockName,
   isColumnsComponent,
   isDocxRendererId,
   isHeadingComponent,
@@ -14338,7 +15473,10 @@ export {
   resetVisualPrepassStats,
   resolveDocxQualityProfile,
   runExample,
+  sectionMeasureTwips,
+  sectionTracker,
   themes,
+  toAuthoredPointer,
   validateComponentProps,
   validateDocument,
   validateJsonSchema,