@json-to-office/core-docx 4.5.0 → 5.4.0

package/dist/index.js

@@ -456,17 +456,38 @@ var init_devportal_docx_theme = __esm({
         accent5: "#8A9299",
         accent6: "#E8A18D"
       },
+      palette: {
+        rule: "#D8D5D1",
+        textMuted: "#737373",
+        onPrimary: "#FFFFFF",
+        surfaceInverse: "#12191F",
+        positive: "#2E7D4F",
+        negative: "#B42318",
+        chart: ["accent", "primary", "accent4", "accent5", "accent6", "rule"]
+      },
       fonts: {
-        heading: { family: "Helvetica", size: 23 },
-        body: { family: "Helvetica", size: 9.5 },
-        mono: { family: "Courier New", size: 10 },
-        light: { family: "Helvetica", size: 23 }
+        heading: {
+          family: "Helvetica",
+          size: 23
+        },
+        body: {
+          family: "Helvetica",
+          size: 9.5
+        },
+        mono: {
+          family: "Courier New",
+          size: 10
+        },
+        light: {
+          family: "Helvetica",
+          size: 23
+        }
       },
       page: {
         size: "A4",
         margins: {
-          top: 1440,
-          bottom: 1440,
+          top: 1080,
+          bottom: 1080,
           left: 1080,
           right: 1080,
           header: 720,
@@ -474,13 +495,183 @@ var init_devportal_docx_theme = __esm({
           gutter: 0
         }
       },
+      typography: {
+        roles: {
+          eyebrow: {
+            face: "heading",
+            size: 8,
+            weight: 700,
+            case: "upper",
+            tracking: 10,
+            color: "accent",
+            spaceAfter: 4
+          },
+          display: {
+            face: "heading",
+            weight: 700,
+            color: "primary",
+            lineHeight: 1.05,
+            spaceAfter: 8,
+            tracking: -2
+          },
+          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",
+            case: "upper",
+            tracking: 6
+          },
+          footer: {
+            face: "body",
+            size: 8,
+            color: "textMuted"
+          },
+          tableHeader: {
+            face: "body",
+            size: 9,
+            weight: 700,
+            color: "secondary"
+          },
+          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: 9.5,
+            ratio: 1.2,
+            baselinePt: 2
+          },
+          letter: {
+            base: 9.5,
+            ratio: 1.2,
+            baselinePt: 2
+          }
+        }
+      },
+      spacing: {
+        basePt: 7,
+        blockGap: {
+          tight: 3,
+          normal: 7,
+          loose: 14
+        },
+        canvas: {
+          a4: {
+            safeAreaIn: 0.75,
+            gutterIn: 0,
+            columns: 12
+          },
+          letter: {
+            safeAreaIn: 0.75,
+            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: 1,
+            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: 2,
+        placement: "top"
+      },
       styles: {
         normal: {
           font: "body",
           color: "textPrimary",
-          lineSpacing: { type: "multiple", value: 1.3 },
+          lineSpacing: {
+            type: "multiple",
+            value: 1.3
+          },
           alignment: "left",
-          spacing: { after: 7 }
+          spacing: {
+            after: 7
+          }
         },
         title: {
           font: "heading",
@@ -488,9 +679,18 @@ var init_devportal_docx_theme = __esm({
           bold: true,
           color: "primary",
           alignment: "left",
-          lineSpacing: { type: "multiple", value: 1.02 },
-          characterSpacing: { type: "condensed", value: 8 },
-          spacing: { before: 0, after: 10 }
+          lineSpacing: {
+            type: "multiple",
+            value: 1.02
+          },
+          characterSpacing: {
+            type: "condensed",
+            value: 8
+          },
+          spacing: {
+            before: 0,
+            after: 10
+          }
         },
         subtitle: {
           font: "body",
@@ -498,16 +698,28 @@ var init_devportal_docx_theme = __esm({
           italic: false,
           color: "textSecondary",
           alignment: "left",
-          lineSpacing: { type: "multiple", value: 1.25 },
-          spacing: { before: 0, after: 12 }
+          lineSpacing: {
+            type: "multiple",
+            value: 1.25
+          },
+          spacing: {
+            before: 0,
+            after: 12
+          }
         },
         heading1: {
           font: "heading",
           size: 21,
           bold: true,
           color: "primary",
-          lineSpacing: { type: "multiple", value: 1.15 },
-          spacing: { before: 26, after: 12 },
+          lineSpacing: {
+            type: "multiple",
+            value: 1.15
+          },
+          spacing: {
+            before: 26,
+            after: 12
+          },
           keepNext: true,
           alignment: "left",
           borders: {
@@ -524,8 +736,14 @@ var init_devportal_docx_theme = __esm({
           size: 15.5,
           bold: true,
           color: "secondary",
-          lineSpacing: { type: "multiple", value: 1.15 },
-          spacing: { before: 20, after: 8 },
+          lineSpacing: {
+            type: "multiple",
+            value: 1.15
+          },
+          spacing: {
+            before: 20,
+            after: 8
+          },
           keepNext: true,
           alignment: "left"
         },
@@ -534,7 +752,10 @@ var init_devportal_docx_theme = __esm({
           size: 12.5,
           bold: true,
           color: "secondary",
-          spacing: { before: 14, after: 6 },
+          spacing: {
+            before: 14,
+            after: 6
+          },
           keepNext: true,
           alignment: "left"
         },
@@ -543,7 +764,10 @@ var init_devportal_docx_theme = __esm({
           size: 11.5,
           bold: true,
           color: "textPrimary",
-          spacing: { before: 12, after: 4 },
+          spacing: {
+            before: 12,
+            after: 4
+          },
           keepNext: true,
           alignment: "left"
         },
@@ -552,7 +776,10 @@ var init_devportal_docx_theme = __esm({
           size: 10.5,
           bold: true,
           color: "secondary",
-          spacing: { before: 10, after: 4 },
+          spacing: {
+            before: 10,
+            after: 4
+          },
           keepNext: true,
           alignment: "left"
         },
@@ -561,8 +788,14 @@ var init_devportal_docx_theme = __esm({
           size: 10.5,
           bold: false,
           color: "textSecondary",
-          characterSpacing: { type: "expanded", value: 20 },
-          spacing: { before: 10, after: 4 },
+          characterSpacing: {
+            type: "expanded",
+            value: 20
+          },
+          spacing: {
+            before: 10,
+            after: 4
+          },
           keepNext: true,
           alignment: "left"
         },
@@ -571,24 +804,53 @@ var init_devportal_docx_theme = __esm({
           size: 11,
           bold: true,
           color: "primary",
-          spacing: { before: 5, after: 3 },
-          tabStops: [{ type: "right", position: 9746, leader: "dot" }]
+          spacing: {
+            before: 5,
+            after: 3
+          },
+          tabStops: [
+            {
+              type: "right",
+              position: 9746,
+              leader: "dot"
+            }
+          ]
         },
         TOC2: {
           font: "body",
           size: 10.5,
           color: "textPrimary",
-          indent: { left: 240 },
-          spacing: { after: 2 },
-          tabStops: [{ type: "right", position: 9746, leader: "dot" }]
+          indent: {
+            left: 240
+          },
+          spacing: {
+            after: 2
+          },
+          tabStops: [
+            {
+              type: "right",
+              position: 9746,
+              leader: "dot"
+            }
+          ]
         },
         TOC3: {
           font: "body",
           size: 10,
           color: "textSecondary",
-          indent: { left: 480 },
-          spacing: { after: 2 },
-          tabStops: [{ type: "right", position: 9746, leader: "dot" }]
+          indent: {
+            left: 480
+          },
+          spacing: {
+            after: 2
+          },
+          tabStops: [
+            {
+              type: "right",
+              position: 9746,
+              leader: "dot"
+            }
+          ]
         }
       },
       componentDefaults: {
@@ -596,22 +858,37 @@ var init_devportal_docx_theme = __esm({
           width: 100,
           borderColor: "#E2E0DD",
           borderSize: 0.5,
-          hideBorders: { left: true, right: true, insideVertical: true },
+          hideBorders: {
+            left: true,
+            right: true,
+            insideVertical: true
+          },
           cellDefaults: {
-            padding: { top: 3, bottom: 3 }
+            padding: {
+              top: 3,
+              bottom: 3
+            }
           },
           headerCellDefaults: {
-            font: { bold: true },
+            font: {
+              bold: true
+            },
             color: "#172028",
             backgroundColor: "#F7ECE7",
-            borderColor: { bottom: "#D8D5D1" },
-            borderSize: { bottom: 1 }
+            borderColor: {
+              bottom: "#D8D5D1"
+            },
+            borderSize: {
+              bottom: 1
+            }
           }
         },
         list: {
           format: "bullet",
           bullet: "\u2014",
-          spacing: { item: 2 }
+          spacing: {
+            item: 2
+          }
         },
         image: {
           alignment: "center"
@@ -650,7 +927,19 @@ var init_vermilion_docx_theme = __esm({
         borderPrimary: "#C7C8CA",
         borderSecondary: "#EFEAE4",
         backgroundPrimary: "#FFFFFF",
-        backgroundSecondary: "#FAF7F5"
+        backgroundSecondary: "#FAF7F5",
+        accent4: "#F4857A",
+        accent5: "#F9C4BE",
+        accent6: "#939598"
+      },
+      palette: {
+        rule: "#C7C8CA",
+        textMuted: "#939598",
+        onPrimary: "#FFFFFF",
+        surfaceInverse: "#282829",
+        positive: "#2E7D4F",
+        negative: "#B42318",
+        chart: ["accent", "primary", "textMuted", "accent4", "rule", "accent5"]
       },
       fonts: {
         heading: {
@@ -673,28 +962,190 @@ var init_vermilion_docx_theme = __esm({
       page: {
         size: "A4",
         margins: {
-          top: 1360,
-          bottom: 1360,
-          left: 1180,
-          right: 1180,
+          top: 1152,
+          bottom: 1152,
+          left: 1152,
+          right: 1152,
           header: 620,
           footer: 620,
           gutter: 0
         }
       },
-      styles: {
-        normal: {
-          font: "body",
-          color: "textPrimary",
-          lineSpacing: {
-            type: "multiple",
-            value: 1.3
+      typography: {
+        roles: {
+          eyebrow: {
+            face: "heading",
+            size: 8,
+            weight: 700,
+            case: "upper",
+            tracking: 8,
+            color: "accent",
+            spaceAfter: 4
           },
-          alignment: "left",
-          spacing: {
-            after: 8
-          }
-        },
+          display: {
+            face: "heading",
+            weight: 700,
+            color: "accent",
+            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.5,
+            weight: 700,
+            color: "accent"
+          },
+          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.25,
+            baselinePt: 2
+          },
+          letter: {
+            base: 10.5,
+            ratio: 1.25,
+            baselinePt: 2
+          }
+        }
+      },
+      spacing: {
+        basePt: 8,
+        blockGap: {
+          tight: 4,
+          normal: 8,
+          loose: 16
+        },
+        canvas: {
+          a4: {
+            safeAreaIn: 0.8,
+            gutterIn: 0,
+            columns: 12
+          },
+          letter: {
+            safeAreaIn: 0.8,
+            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: 1.5,
+            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: 4,
+            color: "accent"
+          }
+        }
+      },
+      motif: {
+        kind: "rule",
+        color: "accent",
+        weightPt: 4,
+        placement: "top"
+      },
+      styles: {
+        normal: {
+          font: "body",
+          color: "textPrimary",
+          lineSpacing: {
+            type: "multiple",
+            value: 1.3
+          },
+          alignment: "left",
+          spacing: {
+            after: 8
+          }
+        },
         heading1: {
           font: "heading",
           size: 25,
@@ -814,23 +1265,40 @@ var init_vermilion_docx_theme = __esm({
             insideVertical: true
           },
           cellDefaults: {
-            font: { size: 9.5 },
-            padding: { top: 7, bottom: 7 },
+            font: {
+              size: 9.5
+            },
+            padding: {
+              top: 7,
+              bottom: 7
+            },
             verticalAlignment: "middle"
           },
           headerCellDefaults: {
             color: "#EF4130",
-            font: { size: 9.5, bold: true },
-            padding: { top: 0, bottom: 8 },
+            font: {
+              size: 9.5,
+              bold: true
+            },
+            padding: {
+              top: 0,
+              bottom: 8
+            },
             verticalAlignment: "bottom",
-            borderColor: { bottom: "#EF4130" },
-            borderSize: { bottom: 0.5 }
+            borderColor: {
+              bottom: "#EF4130"
+            },
+            borderSize: {
+              bottom: 0.5
+            }
           }
         },
         list: {
           format: "bullet",
           bullet: "\u2014",
-          spacing: { item: 2 }
+          spacing: {
+            item: 2
+          }
         },
         image: {
           alignment: "center"
@@ -5040,7 +5508,10 @@ import {
 import {
   clampVisualDpi,
   DEFAULT_VISUAL_DPI,
-  MAX_RASTERIZE_BATCH_SLIDES
+  MAX_RASTERIZE_BATCH_SLIDES,
+  createLimiter,
+  resolveServiceUrl as resolveServiceUrl2,
+  postJsonToService as postJsonToService2
 } from "@json-to-office/shared";
 import {
   isNativeVisualProps
@@ -5061,54 +5532,8 @@ function hasNodeBuiltins() {
   }
 }
 
-// src/utils/serviceClient.ts
-var DEFAULT_TIMEOUT_MS = 3e4;
-function resolveServiceUrl(propsUrl, servicesUrl, defaultUrl) {
-  const raw = (propsUrl || servicesUrl || defaultUrl).trim();
-  const withScheme = /^https?:\/\//i.test(raw) ? raw : `http://${raw}`;
-  return withScheme.replace(/\/+$/, "");
-}
-var SERVICE_UNAVAILABLE_CODE = "SERVICE_UNAVAILABLE";
-function serviceUnavailable(message) {
-  return Object.assign(new Error(message), { code: SERVICE_UNAVAILABLE_CODE });
-}
-async function postJsonToService(opts) {
-  const resolvedHeaders = typeof opts.headers === "function" ? await opts.headers(opts.body) : opts.headers;
-  const headers = {
-    "Content-Type": "application/json",
-    ...resolvedHeaders
-  };
-  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  let response;
-  try {
-    response = await fetch(`${opts.url}${opts.path}`, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(opts.body),
-      signal: controller.signal
-    });
-  } catch (error) {
-    if (error?.name === "AbortError") {
-      throw serviceUnavailable(
-        `${opts.serviceLabel} timed out after ${timeoutMs}ms at ${opts.url}.`
-      );
-    }
-    const cause = error instanceof Error ? error.message : String(error);
-    throw serviceUnavailable(opts.onUnreachable(opts.url, cause));
-  } finally {
-    clearTimeout(timer);
-  }
-  if (!response.ok) {
-    throw new Error(
-      `${opts.serviceLabel} returned ${response.status}: ${response.statusText}`
-    );
-  }
-  return response;
-}
-
 // src/components/visual.ts
+import { resolveServiceUrl, postJsonToService } from "@json-to-office/shared";
 var DEFAULT_RASTERIZE_SERVER_URL = "http://localhost:7802";
 var PIXELS_PER_INCH = 96;
 function buildVisualPresentation(props) {
@@ -5210,26 +5635,6 @@ Cause: ${cause}`
   return result;
 }
 
-// src/utils/promiseLimiter.ts
-function createLimiter(max) {
-  let active = 0;
-  const queue = [];
-  const release = () => {
-    active--;
-    queue.shift()?.();
-  };
-  return async function limit(fn) {
-    while (active >= max)
-      await new Promise((resolve4) => queue.push(resolve4));
-    active++;
-    try {
-      return await fn();
-    } finally {
-      release();
-    }
-  };
-}
-
 // src/core/prerasterizeVisuals.ts
 var DEFAULT_FALLBACK_CONCURRENCY = 4;
 var BATCH_TIMEOUT_BASE_MS = 3e4;
@@ -5406,7 +5811,7 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
     await rasterizeIndividually(unique);
     return map;
   }
-  const serverUrl = resolveServiceUrl(
+  const serverUrl = resolveServiceUrl2(
     void 0,
     serviceConfig?.serverUrl,
     DEFAULT_RASTERIZE_SERVER_URL
@@ -5414,7 +5819,7 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
   const postBatch = async (chunk, fonts) => {
     let response;
     try {
-      response = await postJsonToService({
+      response = await postJsonToService2({
         url: serverUrl,
         path: "/rasterize/batch",
         body: {
@@ -5540,7 +5945,8 @@ function containsComponent(root, name) {
 // src/core/desugarExternals.ts
 import {
   clampVisualDpi as clampVisualDpi2,
-  DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI2
+  DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI2,
+  limitChartRequest
 } from "@json-to-office/shared";
 import {
   isNativeVisualProps as isNativeVisualProps2
@@ -5556,30 +5962,42 @@ import {
   chartPointsPerPixel,
   POINTS_PER_PIXEL_96DPI,
   withChartFontFaceCss,
-  withChartTypography
+  withChartTypography,
+  resolveServiceUrl as resolveServiceUrl3,
+  postJsonToService as postJsonToService3,
+  chartRequestKey,
+  dedupeChartRequest,
+  recordChartRetry
 } from "@json-to-office/shared";
 var DEFAULT_EXPORT_SERVER_URL = "http://localhost:7801";
+function effectiveChartServerUrl(props, servicesConfig) {
+  return resolveServiceUrl3(
+    props.serverUrl,
+    servicesConfig?.serverUrl,
+    DEFAULT_EXPORT_SERVER_URL
+  );
+}
 function assertExportServerAllowed(serverUrl, servicesConfig, warnings) {
   const notice = remoteExportNotice(serverUrl, servicesConfig?.allowRemote);
-  if (notice)
-    warnings?.push({
-      component: "highcharts",
-      severity: "warning",
-      message: notice,
-      context: { code: REMOTE_EXPORT_WARNING, serverUrl }
-    });
+  if (!notice || !warnings) return;
+  const alreadySaid = warnings.some(
+    (warning) => warning.context?.code === REMOTE_EXPORT_WARNING && warning.context?.serverUrl === serverUrl
+  );
+  if (alreadySaid) return;
+  warnings.push({
+    component: "highcharts",
+    severity: "warning",
+    message: notice,
+    context: { code: REMOTE_EXPORT_WARNING, serverUrl }
+  });
 }
-async function generateChart(config, servicesConfig, warnings) {
+async function generateChart(config, servicesConfig, warnings, cache) {
   if (!isNodeEnvironment()) {
     throw new Error(
       "Highcharts export server requires a Node.js environment. Chart generation is not available in browser environments."
     );
   }
-  const serverUrl = resolveServiceUrl(
-    config.serverUrl,
-    servicesConfig?.serverUrl,
-    DEFAULT_EXPORT_SERVER_URL
-  );
+  const serverUrl = effectiveChartServerUrl(config, servicesConfig);
   assertExportServerAllowed(serverUrl, servicesConfig, warnings);
   const requestBody = {
     infile: config.options,
@@ -5590,11 +6008,21 @@ async function generateChart(config, servicesConfig, warnings) {
     // byte-identical to before for callers that omit it.
     ...config.resources ? { resources: config.resources } : {}
   };
-  const response = await postJsonToService({
+  return dedupeChartRequest(
+    cache,
+    chartRequestKey(serverUrl, requestBody),
+    () => postChart(serverUrl, requestBody, config, servicesConfig)
+  );
+}
+async function postChart(serverUrl, requestBody, config, servicesConfig) {
+  const response = await postJsonToService3({
     url: serverUrl,
     path: "/export",
     body: requestBody,
     headers: servicesConfig?.headers,
+    timeoutMs: servicesConfig?.timeoutMs,
+    retries: servicesConfig?.retries,
+    onRetry: recordChartRetry,
     serviceLabel: "Highcharts export server",
     onUnreachable: (url, cause) => `Highcharts Export Server is not running at ${url}. Start it with: npx highcharts-export-server --enableServer true
 Cause: ${cause}`
@@ -5693,13 +6121,13 @@ function withChartFontFaces(config, theme, faces) {
     theme.fonts.heading.family
   ]);
 }
-async function renderChartToImageProps(props, theme, servicesConfig, chartFonts, warnings) {
+async function renderChartToImageProps(props, theme, servicesConfig, chartFonts, warnings, cache) {
   const config = withChartFontFaces(
     withThemeTypography(withThemeColors(props, theme), theme),
     theme,
     chartFonts
   );
-  const chart = await generateChart(config, servicesConfig, warnings);
+  const chart = await generateChart(config, servicesConfig, warnings, cache);
   const hasConfigDimensions = config.width !== void 0 || config.height !== void 0;
   return {
     base64: chart.base64DataUri,
@@ -5719,6 +6147,7 @@ async function desugarExternals(document, options) {
       ...options.visualFonts ? { fonts: options.visualFonts } : {}
     }
   ).catch(() => /* @__PURE__ */ new Map());
+  const chartCache = /* @__PURE__ */ new Map();
   return transformComponents(document, async (node) => {
     if (node.enabled === false) return void 0;
     if (node.name === "visual") {
@@ -5733,14 +6162,21 @@ async function desugarExternals(document, options) {
       });
     }
     if (node.name === "highcharts") {
+      const props = node.props;
+      const chartConfig = options.services?.highcharts;
       return withNodeIdentity(node, {
         name: "image",
-        props: await renderChartToImageProps(
-          node.props,
-          options.theme,
-          options.services?.highcharts,
-          options.chartFonts,
-          options.warnings
+        props: await limitChartRequest(
+          effectiveChartServerUrl(props, chartConfig),
+          chartConfig?.concurrency,
+          () => renderChartToImageProps(
+            props,
+            options.theme,
+            chartConfig,
+            options.chartFonts,
+            options.warnings,
+            chartCache
+          )
         )
       });
     }
@@ -13839,7 +14275,8 @@ var DocumentGenerator = {
 // src/core/flattenVisuals.ts
 import {
   clampVisualDpi as clampVisualDpi3,
-  DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI3
+  DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI3,
+  createLimiter as createLimiter2
 } from "@json-to-office/shared";
 import {
   isNativeVisualProps as isNativeVisualProps5
@@ -13881,7 +14318,7 @@ async function flattenVisuals(doc, options) {
     dpi: options.dpi,
     baseDir: options.baseDir,
     fonts: options.fonts,
-    limit: createLimiter(
+    limit: createLimiter2(
       Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY)
     )
   };
@@ -13913,6 +14350,12 @@ async function rasterizeVisual(obj, ctx) {
   });
 }
 
+// src/index.ts
+import {
+  getChartRequestStats,
+  resetChartRequestStats
+} from "@json-to-office/shared";
+
 // src/quality/preflight.ts
 import {
   assertValidQualityPolicy,
@@ -14930,7 +15373,34 @@ var DOCX_QUALITY_PROFILES = {
   "technical-report": {
     id: "technical-report",
     formats: ["docx"],
-    description: "Portable professional report defaults."
+    description: "Technical report or memo: numbered sections under a running head with page numbers on every section after the cover, a source wherever a block declares one, no heading skipped, every size on the theme scale with at most nine in play, no page rendered empty or left half blank, and at least one chart or table.",
+    rules: {
+      // A figure or table in a technical report cites where its numbers come
+      // from; the takeaway is the client report's ask, the caption is the
+      // block's own.
+      "docx/required-chrome": { parameters: { required: ["source"] } },
+      "docx/running-head": {
+        parameters: {
+          required: ["header", "footer", "pageNumber"],
+          fromSection: 1
+        }
+      },
+      "docx/heading-hierarchy": { severity: "warning" },
+      "docx/type-scale": { enabled: true },
+      // One more than the client report: the contents list paints TOC2 and
+      // the sub-headings paint heading 2.
+      "docx/size-count": { enabled: true, parameters: { maximumSizes: 9 } },
+      "docx/role-drift": { enabled: true },
+      "rendered/empty-page": { severity: "warning" },
+      "rendered/page-underfilled": { severity: "warning" },
+      // A technical report argues from measurements: a runs table, a chart.
+      "docx/exhibit-required": { enabled: true }
+    }
+  },
+  general: {
+    id: "general",
+    formats: ["docx"],
+    description: "Any document that names no archetype: integrity and information-design rules at their defaults, nothing required by structure."
   },
   "legal-appendix": {
     id: "legal-appendix",
@@ -14938,7 +15408,7 @@ var DOCX_QUALITY_PROFILES = {
     description: "Dense appendix: preserve integrity without editorial taste."
   }
 };
-var DOCX_DEFAULT_QUALITY_PROFILE = DOCX_QUALITY_PROFILES["technical-report"];
+var DOCX_DEFAULT_QUALITY_PROFILE = DOCX_QUALITY_PROFILES["general"];
 var DOCX_PROFILES_BY_ID = DOCX_QUALITY_PROFILES;
 function declaredDocxQualityProfile(document) {
   const props = document?.props;
@@ -15105,8 +15575,9 @@ init_styles();
 
 // src/blueprints/index.ts
 import {
-  blockDependencies,
-  validateBlueprint
+  instantiateBlueprint,
+  registerBlueprints,
+  valueAt
 } from "@json-to-office/shared";
 import { collectPlaceholders as collectPlaceholders2 } from "@json-to-office/quality";
 import { existsSync, readdirSync, readFileSync as readFileSync2 } from "fs";
@@ -15220,7 +15691,789 @@ var client_report_docx_blueprint_default = {
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "02",
+                  title: "{{Section title: the finding, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "chart-figure",
+                slots: {
+                  chart: {
+                    name: "highcharts",
+                    props: {
+                      width: "100%",
+                      options: {
+                        chart: {
+                          type: "column",
+                          width: 900,
+                          height: 460
+                        },
+                        title: {
+                          text: null
+                        },
+                        xAxis: {
+                          categories: [
+                            "{{Period 1}}",
+                            "{{Period 2}}",
+                            "{{Period 3}}"
+                          ]
+                        },
+                        yAxis: {
+                          title: {
+                            text: "{{Measure (unit)}}"
+                          }
+                        },
+                        series: [
+                          {
+                            name: "{{Series name}}",
+                            data: [0, 0, 0]
+                          }
+                        ]
+                      }
+                    }
+                  },
+                  caption: "{{Caption: what the chart shows, as a statement}}",
+                  takeaway: "{{Takeaway: the one sentence the reader should keep}}",
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "03",
+                  title: "{{Section title: the finding, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "data-table",
+                slots: {
+                  title: "{{Table title: what it compares, and the period}}",
+                  labelHeader: "{{Row label}}",
+                  labels: ["{{Row 1}}", "{{Row 2}}", "{{Row 3}}"],
+                  columns: [
+                    {
+                      header: "{{Measure (unit)}}",
+                      cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
+                    },
+                    {
+                      header: "{{Change}}",
+                      cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
+                    }
+                  ],
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "callout",
+                slots: {
+                  label: "{{Note label}}",
+                  text: "{{Note: a caveat about the numbers, a definition or the method}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "04",
+                  title: "{{Section title: the finding, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "footnotes"
+              }
+            }
+          ]
+        }
+      ]
+    },
+    narrative: {
+      description: "Argument-led: takeaways, then three sections of prose with one KPI row and one note as evidence, next steps last; one data table in the analysis section carries the numbers the argument leans on.",
+      whenToUse: "The brief is a position, an assessment or a recommendation with few numbers; the reader follows an argument.",
+      pages: {
+        min: 3,
+        max: 6
+      },
+      metadata: {
+        title: "{{Title: as on the cover}}",
+        author: "{{Author or team}}",
+        company: "{{Client name}}",
+        date: "{{Month YYYY}}"
+      },
+      children: [
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "cover",
+                slots: {
+                  title: "{{Title: the report's conclusion in one sentence}}",
+                  subtitle: "{{Subtitle: what the report answers, for whom}}",
+                  client: "{{Client name}}",
+                  date: "{{Month YYYY}}",
+                  confidentiality: "{{Confidentiality: Confidential, or For internal use}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "running-head",
+                slots: {
+                  confidentiality: "{{Confidentiality: as on the cover}}",
+                  date: "{{Month YYYY}}"
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "01",
+                  title: "{{Section title: the finding, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "key-takeaways",
+                slots: {
+                  items: [
+                    "{{Takeaway 1: one claim, one sentence, with its number}}",
+                    "{{Takeaway 2: one claim, one sentence, with its number}}",
+                    "{{Takeaway 3: the recommendation that follows}}"
+                  ]
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "02",
+                  title: "{{Section title: the finding, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "callout",
+                slots: {
+                  label: "{{Note label}}",
+                  text: "{{Note: a caveat about the numbers, a definition or the method}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "03",
+                  title: "{{Section title: the finding, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "data-table",
+                slots: {
+                  title: "{{Table title: what it compares, and the period}}",
+                  labelHeader: "{{Row label}}",
+                  labels: ["{{Row 1}}", "{{Row 2}}", "{{Row 3}}"],
+                  columns: [
+                    {
+                      header: "{{Measure (unit)}}",
+                      cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
+                    },
+                    {
+                      header: "{{Change}}",
+                      cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
+                    }
+                  ],
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "kpi-row",
+                slots: {
+                  items: [
+                    {
+                      value: "{{0.0}}",
+                      label: "{{What it measures}}"
+                    },
+                    {
+                      value: "{{0.0}}",
+                      label: "{{What it measures}}"
+                    },
+                    {
+                      value: "{{0.0}}",
+                      label: "{{What it measures}}"
+                    }
+                  ],
+                  source: "{{Source: system or document, date}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "04",
+                  title: "{{Section title: the finding, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "footnotes"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  }
+};
+
+// src/templates/blueprints/technical-report.docx.blueprint.json
+var technical_report_docx_blueprint_default = {
+  id: "technical-report",
+  format: "docx",
+  title: "Technical report",
+  description: "A technical report or memo for engineers and their managers: numbered sections under a running head that numbers the pages, a contents list, a summary first, method and results with a chart and a runs table, recommendations, a readiness or decision statement, references last; or a memo that opens with To, From, Date and Subject and argues one recommendation in two pages.",
+  whenToUse: "A load-test or audit report, a migration or capacity plan, a post-incident report, a standard, a security review, or a short memo recommending one option. Not for a client's periodic report, which reads for the conclusion first and rarely cites a method.",
+  theme: "consulting",
+  profile: "technical-report",
+  definitions: "technical-report-blocks.docx.json",
+  numbering: "sections",
+  toc: true,
+  variants: {
+    "data-heavy": {
+      description: "Evidence-led: summary, scope and method with its assumptions, results with a chart and two sub-headed findings and a runs table, recommendations with a risk note, a readiness statement, references.",
+      whenToUse: "The brief comes with measurements: runs, findings, incidents, timings, anything the reader will check against a figure.",
+      pages: {
+        min: 4,
+        max: 10
+      },
+      metadata: {
+        title: "{{Title: as on the cover}}",
+        author: "{{Author or team}}",
+        company: "{{Team or client name}}",
+        date: "{{Month YYYY}}"
+      },
+      children: [
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "cover",
+                slots: {
+                  title: "{{Title: the report's conclusion in one sentence}}",
+                  subtitle: "{{Subtitle: what was examined, for whom}}",
+                  client: "{{Team or client name}}",
+                  date: "{{Month YYYY}}",
+                  confidentiality: "{{Confidentiality: Internal, or Confidential}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "running-head",
+                slots: {
+                  confidentiality: "{{Confidentiality: as on the cover}}",
+                  date: "{{Month YYYY}}"
+                }
+              }
+            },
+            {
+              name: "toc",
+              props: {
+                scope: "document",
+                title: "Contents",
+                depth: {
+                  from: 1,
+                  to: 2
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "1",
+                  title: "{{Section title: the conclusion, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "key-takeaways",
+                slots: {
+                  label: "Summary",
+                  items: [
+                    "{{Finding 1: one claim, one sentence, with its number}}",
+                    "{{Finding 2: one claim, one sentence, with its number}}",
+                    "{{Finding 3: the recommendation that follows}}"
+                  ]
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: what was examined, what was found and what is recommended, in one paragraph}}"
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "2",
+                  title: "{{Section title: scope and method}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: what was measured, under which conditions, with which instruments, and what was left out}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "callout",
+                slots: {
+                  label: "{{Note label: Assumptions, or Limitations}}",
+                  text: "{{Note: the assumption or limit the results rest on}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "3",
+                  title: "{{Section title: results, as the headline finding}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: what the figure shows and the number that matters}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "chart-figure",
+                slots: {
+                  chart: {
+                    name: "highcharts",
+                    props: {
+                      width: "100%",
+                      options: {
+                        chart: {
+                          type: "column",
+                          width: 900,
+                          height: 460
+                        },
+                        title: {
+                          text: null
+                        },
+                        xAxis: {
+                          categories: [
+                            "{{Condition 1}}",
+                            "{{Condition 2}}",
+                            "{{Condition 3}}"
+                          ],
+                          title: {
+                            text: "{{Independent variable (unit)}}"
+                          }
+                        },
+                        yAxis: {
+                          min: 0,
+                          title: {
+                            text: "{{Measure (unit)}}"
+                          }
+                        },
+                        series: [
+                          {
+                            name: "{{Series name}}",
+                            data: [0, 0, 0]
+                          }
+                        ],
+                        credits: {
+                          enabled: false
+                        }
+                      }
+                    }
+                  },
+                  caption: "{{Caption: what the chart shows, as a statement}}",
+                  takeaway: "{{Takeaway: the one sentence the reader should keep}}",
+                  source: "{{Source: system, run or document, date}}"
+                }
+              }
+            },
+            {
+              name: "heading",
+              props: {
+                level: 2,
+                text: "{{Sub-heading 3.1: the first result, as a statement}}"
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: the evidence for the sub-heading, with its numbers}}"
+              }
+            },
+            {
+              name: "heading",
+              props: {
+                level: 2,
+                text: "{{Sub-heading 3.2: the second result, as a statement}}"
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: the evidence for the sub-heading, with its numbers}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "data-table",
+                slots: {
+                  title: "{{Table title: the runs or cases, and their conditions}}",
+                  labelHeader: "{{Run or case}}",
+                  labels: ["{{Row 1}}", "{{Row 2}}", "{{Row 3}}"],
+                  columns: [
+                    {
+                      header: "{{Measure (unit)}}",
+                      cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
+                    },
+                    {
+                      header: "{{Measure (unit)}}",
+                      cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
+                    }
+                  ],
+                  notes: "{{Notes: definitions, conditions, exclusions the reader needs to read the figures}}",
+                  source: "{{Source: system, run or document, date}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "4",
+                  title: "{{Section title: recommendations, as what to do}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: each recommendation with its expected effect, cost and owner}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "callout",
+                slots: {
+                  label: "{{Note label: Risk, or Open question}}",
+                  text: "{{Note: what could invalidate the recommendation and how it will be checked}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "5",
+                  title: "{{Section title: the readiness or decision statement}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: the answer to the brief's question, with its condition}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "footnotes",
+                slots: {
+                  title: "References"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    narrative: {
+      description: "Argument-led: summary, context and constraints, an analysis section built on one comparison table, options and risks, a recommendation with next steps, references.",
+      whenToUse: "The brief is a plan, a policy, a standard or an assessment with few numbers; the reader follows an argument to a decision.",
+      pages: {
+        min: 3,
+        max: 8
+      },
+      metadata: {
+        title: "{{Title: as on the cover}}",
+        author: "{{Author or team}}",
+        company: "{{Team or client name}}",
+        date: "{{Month YYYY}}"
+      },
+      children: [
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "cover",
+                slots: {
+                  title: "{{Title: the report's conclusion in one sentence}}",
+                  subtitle: "{{Subtitle: what was examined, for whom}}",
+                  client: "{{Team or client name}}",
+                  date: "{{Month YYYY}}",
+                  confidentiality: "{{Confidentiality: Internal, or Confidential}}"
+                }
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "running-head",
+                slots: {
+                  confidentiality: "{{Confidentiality: as on the cover}}",
+                  date: "{{Month YYYY}}"
+                }
+              }
+            },
+            {
+              name: "toc",
+              props: {
+                scope: "document",
+                title: "Contents",
+                depth: {
+                  from: 1,
+                  to: 2
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "1",
+                  title: "{{Section title: the conclusion, as a statement}}"
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "key-takeaways",
+                slots: {
+                  label: "Summary",
+                  items: [
+                    "{{Finding 1: one claim, one sentence, with its number}}",
+                    "{{Finding 2: one claim, one sentence, with its number}}",
+                    "{{Finding 3: the recommendation that follows}}"
+                  ]
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: what was examined, what was found and what is recommended, in one paragraph}}"
               }
             }
           ]
@@ -15233,66 +16486,21 @@ var client_report_docx_blueprint_default = {
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "02",
-                  title: "{{Section title: the finding, as a statement}}"
+                  number: "2",
+                  title: "{{Section title: context and constraints}}"
                 }
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
-              }
-            },
-            {
-              name: "block",
-              props: {
-                ref: "chart-figure",
-                slots: {
-                  chart: {
-                    name: "highcharts",
-                    props: {
-                      width: "100%",
-                      options: {
-                        chart: {
-                          type: "column",
-                          width: 900,
-                          height: 460
-                        },
-                        title: {
-                          text: null
-                        },
-                        xAxis: {
-                          categories: [
-                            "{{Period 1}}",
-                            "{{Period 2}}",
-                            "{{Period 3}}"
-                          ]
-                        },
-                        yAxis: {
-                          title: {
-                            text: "{{Measure (unit)}}"
-                          }
-                        },
-                        series: [
-                          {
-                            name: "{{Series name}}",
-                            data: [0, 0, 0]
-                          }
-                        ]
-                      }
-                    }
-                  },
-                  caption: "{{Caption: what the chart shows, as a statement}}",
-                  takeaway: "{{Takeaway: the one sentence the reader should keep}}",
-                  source: "{{Source: system or document, date}}"
-                }
+                text: "{{Body: the system or situation as it is, with the numbers that bound it}}"
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: the requirement or question this report answers}}"
               }
             }
           ]
@@ -15305,15 +16513,15 @@ var client_report_docx_blueprint_default = {
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "03",
-                  title: "{{Section title: the finding, as a statement}}"
+                  number: "3",
+                  title: "{{Section title: analysis, as the headline finding}}"
                 }
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: the argument, opening with its claim}}"
               }
             },
             {
@@ -15321,8 +16529,8 @@ var client_report_docx_blueprint_default = {
               props: {
                 ref: "data-table",
                 slots: {
-                  title: "{{Table title: what it compares, and the period}}",
-                  labelHeader: "{{Row label}}",
+                  title: "{{Table title: what it compares, and the conditions}}",
+                  labelHeader: "{{Option or case}}",
                   labels: ["{{Row 1}}", "{{Row 2}}", "{{Row 3}}"],
                   columns: [
                     {
@@ -15330,21 +16538,49 @@ var client_report_docx_blueprint_default = {
                       cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
                     },
                     {
-                      header: "{{Change}}",
+                      header: "{{Measure (unit)}}",
                       cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
                     }
                   ],
-                  source: "{{Source: system or document, date}}"
+                  notes: "{{Notes: definitions, conditions, exclusions the reader needs to read the figures}}",
+                  source: "{{Source: system, run or document, date}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: what the table settles and what it leaves open}}"
+              }
+            }
+          ]
+        },
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "4",
+                  title: "{{Section title: options and risks}}"
                 }
               }
             },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: each option with its cost, its risk and what it forecloses}}"
+              }
+            },
             {
               name: "block",
               props: {
                 ref: "callout",
                 slots: {
-                  label: "{{Note label}}",
-                  text: "{{Note: a caveat about the numbers, a definition or the method}}"
+                  label: "{{Note label: Risk, or Open question}}",
+                  text: "{{Note: what could invalidate the recommendation and how it will be checked}}"
                 }
               }
             }
@@ -15358,38 +16594,41 @@ var client_report_docx_blueprint_default = {
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "04",
-                  title: "{{Section title: the finding, as a statement}}"
+                  number: "5",
+                  title: "{{Section title: recommendation and next steps}}"
                 }
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: the recommendation, its condition and the first three steps with owners and dates}}"
               }
             },
             {
               name: "block",
               props: {
-                ref: "footnotes"
+                ref: "footnotes",
+                slots: {
+                  title: "References"
+                }
               }
             }
           ]
         }
       ]
     },
-    narrative: {
-      description: "Argument-led: takeaways, then three sections of prose with one KPI row and one note as evidence, next steps last; one data table in the analysis section carries the numbers the argument leans on.",
-      whenToUse: "The brief is a position, an assessment or a recommendation with few numbers; the reader follows an argument.",
+    memo: {
+      description: "A memo in one flowing section: To, From, Date and Subject in place of a cover, the recommendation first, then the question, the options against the requirements in one table, and what would change the answer; references last. No contents list.",
+      whenToUse: "One decision for one reader, argued in under three pages: a vendor or option choice, a go or no-go, a change of approach.",
       pages: {
-        min: 3,
-        max: 6
+        min: 1,
+        max: 3
       },
       metadata: {
-        title: "{{Title: as on the cover}}",
+        title: "{{Title: the subject line}}",
         author: "{{Author or team}}",
-        company: "{{Client name}}",
+        company: "{{Team or client name}}",
         date: "{{Month YYYY}}"
       },
       children: [
@@ -15399,131 +16638,72 @@ var client_report_docx_blueprint_default = {
             {
               name: "block",
               props: {
-                ref: "cover",
+                ref: "memo-header",
                 slots: {
-                  title: "{{Title: the report's conclusion in one sentence}}",
-                  subtitle: "{{Subtitle: what the report answers, for whom}}",
-                  client: "{{Client name}}",
-                  date: "{{Month YYYY}}",
-                  confidentiality: "{{Confidentiality: Confidential, or For internal use}}"
+                  subject: "{{Subject: the recommendation in one line}}",
+                  to: "{{To: the person or group who decides}}",
+                  from: "{{From: author or team}}",
+                  date: "{{D Month YYYY}}"
                 }
               }
-            }
-          ]
-        },
-        {
-          name: "section",
-          children: [
+            },
             {
               name: "block",
               props: {
                 ref: "running-head",
                 slots: {
-                  confidentiality: "{{Confidentiality: as on the cover}}",
+                  confidentiality: "{{Confidentiality: Internal, or Confidential}}",
                   date: "{{Month YYYY}}"
                 }
               }
             },
-            {
-              name: "block",
-              props: {
-                ref: "section-opener",
-                slots: {
-                  number: "01",
-                  title: "{{Section title: the finding, as a statement}}"
-                }
-              }
-            },
             {
               name: "block",
               props: {
                 ref: "key-takeaways",
                 slots: {
+                  label: "Recommendation",
                   items: [
-                    "{{Takeaway 1: one claim, one sentence, with its number}}",
-                    "{{Takeaway 2: one claim, one sentence, with its number}}",
-                    "{{Takeaway 3: the recommendation that follows}}"
+                    "{{Recommendation: what to do, in one sentence}}",
+                    "{{Reason 1: the requirement it meets, with its number}}",
+                    "{{Reason 2: the cost or risk accepted, with its number}}"
                   ]
                 }
               }
             },
-            {
-              name: "paragraph",
-              props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
-              }
-            },
-            {
-              name: "paragraph",
-              props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
-              }
-            }
-          ]
-        },
-        {
-          name: "section",
-          children: [
             {
               name: "block",
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "02",
-                  title: "{{Section title: the finding, as a statement}}"
+                  number: "1",
+                  title: "{{Section title: the question and its constraints}}"
                 }
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
-              }
-            },
-            {
-              name: "block",
-              props: {
-                ref: "callout",
-                slots: {
-                  label: "{{Note label}}",
-                  text: "{{Note: a caveat about the numbers, a definition or the method}}"
-                }
+                text: "{{Body: the requirements, each with its number, and what was considered}}"
               }
             },
-            {
-              name: "paragraph",
-              props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
-              }
-            }
-          ]
-        },
-        {
-          name: "section",
-          children: [
             {
               name: "block",
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "03",
-                  title: "{{Section title: the finding, as a statement}}"
+                  number: "2",
+                  title: "{{Section title: the options against the requirements}}"
                 }
               }
             },
-            {
-              name: "paragraph",
-              props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
-              }
-            },
             {
               name: "block",
               props: {
                 ref: "data-table",
                 slots: {
-                  title: "{{Table title: what it compares, and the period}}",
-                  labelHeader: "{{Row label}}",
+                  title: "{{Table title: options against the requirements}}",
+                  labelHeader: "{{Option}}",
                   labels: ["{{Row 1}}", "{{Row 2}}", "{{Row 3}}"],
                   columns: [
                     {
@@ -15531,68 +16711,54 @@ var client_report_docx_blueprint_default = {
                       cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
                     },
                     {
-                      header: "{{Change}}",
+                      header: "{{Measure (unit)}}",
                       cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
                     }
                   ],
-                  source: "{{Source: system or document, date}}"
+                  notes: "{{Notes: definitions, conditions, exclusions the reader needs to read the figures}}",
+                  source: "{{Source: system, run or document, date}}"
                 }
               }
             },
             {
-              name: "block",
+              name: "paragraph",
               props: {
-                ref: "kpi-row",
-                slots: {
-                  items: [
-                    {
-                      value: "{{0.0}}",
-                      label: "{{What it measures}}"
-                    },
-                    {
-                      value: "{{0.0}}",
-                      label: "{{What it measures}}"
-                    },
-                    {
-                      value: "{{0.0}}",
-                      label: "{{What it measures}}"
-                    }
-                  ],
-                  source: "{{Source: system or document, date}}"
-                }
+                text: "{{Body: why the recommended option wins and what the others lose on}}"
               }
             },
             {
-              name: "paragraph",
+              name: "block",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                ref: "callout",
+                slots: {
+                  label: "{{Note label: Assumption}}",
+                  text: "{{Note: the assumption the recommendation rests on}}"
+                }
               }
-            }
-          ]
-        },
-        {
-          name: "section",
-          children: [
+            },
             {
               name: "block",
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "04",
-                  title: "{{Section title: the finding, as a statement}}"
+                  number: "3",
+                  title: "{{Section title: what would change the answer}}"
                 }
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: the two or three facts that would reverse the recommendation, and who checks them}}"
               }
             },
             {
               name: "block",
               props: {
-                ref: "footnotes"
+                ref: "footnotes",
+                slots: {
+                  title: "References"
+                }
               }
             }
           ]
@@ -15603,25 +16769,6 @@ var client_report_docx_blueprint_default = {
 };
 
 // src/blueprints/index.ts
-function register(...candidates) {
-  const registry2 = {};
-  for (const candidate of candidates) {
-    const issues = validateBlueprint(candidate);
-    if (issues.length > 0)
-      throw new Error(
-        `Invalid bundled blueprint: ${issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ")}`
-      );
-    const blueprint = candidate;
-    if (blueprint.format !== "docx")
-      throw new Error(`Blueprint ${blueprint.id} is not a DOCX blueprint.`);
-    if (registry2[blueprint.id])
-      throw new Error(
-        `Two bundled blueprints share the id "${blueprint.id}"; the later one would silently replace the earlier.`
-      );
-    registry2[blueprint.id] = blueprint;
-  }
-  return registry2;
-}
 function scanned(known) {
   let here;
   try {
@@ -15639,119 +16786,23 @@ function scanned(known) {
     return !(typeof id === "string" && id in known);
   });
 }
-var bundled = register(client_report_docx_blueprint_default);
+var bundled = registerBlueprints("docx", [client_report_docx_blueprint_default, technical_report_docx_blueprint_default]);
 var DOCX_BLUEPRINTS = {
   ...bundled,
-  ...register(...scanned(bundled))
+  ...registerBlueprints("docx", scanned(bundled))
 };
 function docxBlueprint(id) {
   return DOCX_BLUEPRINTS[id];
 }
-var MARKER = /^\{\{\s*([\s\S]*?)\s*\}\}$/;
 function instantiateDocxBlueprint(blueprint, options) {
-  if (blueprint.format !== "docx")
-    throw new Error(
-      `Blueprint ${blueprint.id} is a ${blueprint.format} blueprint; this instantiates DOCX ones.`
-    );
-  const variantId = options.variant ?? Object.keys(blueprint.variants)[0];
-  const variant = blueprint.variants[variantId];
-  if (!variant)
-    throw new Error(
-      `Blueprint ${blueprint.id} has no variant "${variantId}"; it has ${Object.keys(
-        blueprint.variants
-      ).join(", ")}.`
-    );
-  const children = structuredClone(variant.children);
-  const blocks = definitionsFor(children, options.definitions, blueprint);
-  const document = {
-    name: "docx",
-    props: {
-      theme: options.theme ?? blueprint.theme,
-      qualityProfile: blueprint.profile,
-      ...Object.keys(blocks).length > 0 && { blocks },
-      metadata: { ...variant.metadata, ...options.metadata }
-    },
-    children
-  };
-  return { document, fillMap: fillMap(document, blocks), variant: variantId };
-}
-function definitionsFor(children, available, blueprint) {
-  const refs = /* @__PURE__ */ new Set();
-  const visit = (node) => {
-    if (Array.isArray(node)) return node.forEach(visit);
-    if (!node || typeof node !== "object") return;
-    const record = node;
-    const props = record.props;
-    if (record.name === "block" && typeof props?.ref === "string")
-      refs.add(props.ref);
-    Object.values(record).forEach(visit);
-  };
-  visit(children);
-  const result = {};
-  for (const ref of refs) {
-    if (!available[ref])
-      throw new Error(
-        `Blueprint ${blueprint.id} invokes "${ref}", which ${blueprint.definitions} does not define.`
-      );
-    for (const name of [...blockDependencies(available, ref), ref])
-      result[name] ??= structuredClone(available[name]);
-  }
-  return result;
-}
-function fillMap(document, blocks) {
-  return collectPlaceholders2(document).filter((occurrence) => occurrence.match.kind === "scaffold-marker").map((occurrence) => {
-    const guidance = occurrence.text.match(MARKER)?.[1] ?? occurrence.text;
-    const base = { path: occurrence.path, marker: occurrence.text, guidance };
-    if (occurrence.path.startsWith("/props/metadata/"))
-      return { ...base, kind: "metadata" };
-    const slot = slotAt(document, occurrence.path, blocks);
-    return slot ? { ...base, kind: "slot", ...slot } : { ...base, kind: "text" };
+  return instantiateBlueprint(blueprint, options, {
+    format: "docx",
+    metadataPointer: "/props/metadata",
+    markers: (document) => collectPlaceholders2(document).filter(
+      (occurrence) => occurrence.match.kind === "scaffold-marker"
+    )
   });
 }
-function slotAt(document, pointer, blocks) {
-  const at = pointer.lastIndexOf("/props/slots/");
-  if (at < 0) return void 0;
-  const invocation = valueAt(document, pointer.slice(0, at));
-  const ref = invocation?.props?.ref;
-  if (typeof ref !== "string" || !blocks[ref]) return void 0;
-  const segments = pointer.slice(at + "/props/slots/".length).split("/").map(unescape);
-  let slot = blocks[ref].slots[segments[0]];
-  const names = [segments[0]];
-  for (const segment of segments.slice(1)) {
-    if (!slot) break;
-    if (slot.type === "array" && /^\d+$/.test(segment)) slot = slot.items;
-    else if (slot.type === "object") {
-      slot = slot.properties?.[segment];
-      names.push(segment);
-    } else if (slot.type === "component")
-      break;
-    else slot = void 0;
-  }
-  if (!slot) return void 0;
-  return {
-    block: ref,
-    slot: names.join("."),
-    type: slot.type,
-    ...slot.maxWords !== void 0 && { maxWords: slot.maxWords },
-    ...slot.maxLength !== void 0 && { maxLength: slot.maxLength },
-    ...slot.oneLine !== void 0 && { oneLine: slot.oneLine },
-    ...slot.required !== void 0 && { required: slot.required }
-  };
-}
-function unescape(segment) {
-  return segment.replace(/~1/g, "/").replace(/~0/g, "~");
-}
-function valueAt(root, pointer) {
-  if (pointer === "") return root;
-  let current = root;
-  for (const segment of pointer.split("/").slice(1).map(unescape)) {
-    if (Array.isArray(current)) current = current[Number(segment)];
-    else if (current && typeof current === "object")
-      current = current[segment];
-    else return void 0;
-  }
-  return current;
-}
 
 // src/index.ts
 init_json();
@@ -16690,6 +17741,7 @@ export {
   generateComponentSchemas,
   generatePluginDocumentSchema,
   generateWarningsDocument,
+  getChartRequestStats,
   getCoreVersion,
   getExample,
   getExampleNames,
@@ -16716,6 +17768,7 @@ export {
   mergeSchemas,
   minimalTheme,
   prepareDocxQualityDocument,
+  resetChartRequestStats,
   resetVisualPrepassStats,
   resolveDocxQualityProfile,
   runExample,