@json-to-office/core-docx 2.5.0 → 2.6.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,8 +5589,73 @@ function withThemeColors(config, theme) {
     options: { ...config.options, colors: palette }
   };
 }
-async function renderChartToImageProps(props, theme, servicesConfig) {
-  const config = withThemeColors(props, theme);
+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;
+  }
+  if (typeof height === "number" && chart.height > 0) {
+    return height / chart.height * chart.width * POINTS_PER_PIXEL;
+  }
+  return void 0;
+}
+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 {
+    ...config,
+    options: withChartTypography(
+      config.options,
+      themeChartTypography(theme),
+      chartPointsPerPixel(
+        config.options.chart.width,
+        placedWidthPt(config, theme)
+      )
+    )
+  };
+}
+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 {
@@ -5192,74 +5666,6 @@ async function renderChartToImageProps(props, theme, servicesConfig) {
   };
 }
 
-// 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;
-}
-
 // src/core/desugarExternals.ts
 async function desugarExternals(document, options) {
   const prerastered = await prerasterizeVisuals(
@@ -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,210 @@ function emptyToUndefined(formatting) {
   return entries.length === 0 ? void 0 : Object.fromEntries(entries);
 }
 
+// src/blocks/index.ts
+import { KEY_TAKEAWAYS_BUDGET } from "@json-to-office/shared-docx";
+
+// src/blocks/keyTakeaways.ts
+var MIN_RULE_PT = 0.25;
+var MAX_RULE_PT = 12;
+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 = theme.styles?.[labelRole];
+  const ruleWeightPt = Math.min(
+    MAX_RULE_PT,
+    Math.max(
+      MIN_RULE_PT,
+      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/index.ts
+var BLOCK_NAMES = ["key-takeaways"];
+var BLOCKS = {
+  "key-takeaways": {
+    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
+        }
+      ] : []
+    )
+  }
+};
+function isBlockName(name) {
+  return BLOCK_NAMES.includes(name);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function expandBlocks(document, theme) {
+  const sourceMap = {};
+  const blocks = [];
+  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" && isRecord(node.props)) {
+      if (node.enabled !== false && isBlockName(node.name)) {
+        const compiled = BLOCKS[node.name].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`);
+    }
+    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();
@@ -8458,6 +9069,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 +9080,20 @@ function compileComponent(component, scope) {
       return [];
   }
 }
+function compileBlock(component, scope) {
+  const children = component.children ?? [];
+  if (children.length === 0) {
+    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 +12700,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 +12716,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 +12880,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 +12929,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 +13760,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 +13947,7 @@ var DOCX_QUALITY_RULES = {
     docxSvgTextBoundsRule,
     docxLineBoxRule,
     docxPlaceholderRule,
+    docxSlotBudgetRule,
     docxChartRule,
     docxTableDesignRule,
     docxFontCountRule,
@@ -14274,6 +14955,7 @@ function getCoreVersion() {
   return "Core v1.0.0";
 }
 export {
+  BLOCK_NAMES,
   ComponentValidationError2 as ComponentValidationError,
   DocumentGenerator as CoreDocumentGenerator,
   DEFAULT_DOCX_RENDERER_ID,
@@ -14286,7 +14968,10 @@ export {
   UncompiledComponentError,
   UnknownPreservedComponentError,
   analyzeDocxQuality,
+  blockSlotBudgets,
   cleanComponentProps,
+  compileKeyTakeaways,
+  consultingTheme,
   createComponent,
   createDocumentGenerator,
   createMinimalTheme,
@@ -14296,6 +14981,7 @@ export {
   docxRendererIds,
   docxRendererStatuses,
   examples,
+  expandBlocks,
   exportPluginSchema,
   exportThemeToJson,
   flattenVisuals,
@@ -14339,6 +15025,7 @@ export {
   resolveDocxQualityProfile,
   runExample,
   themes,
+  toAuthoredPointer,
   validateComponentProps,
   validateDocument,
   validateJsonSchema,