@json-to-office/core-docx 4.4.4 → 5.3.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"
@@ -12322,6 +12790,7 @@ function finishDocxBlocks(expanded, document, theme, evaluator, effects, sources
       }
       const props = isBlockRecord(section2.props) ? { ...section2.props } : {};
       if (chrome) {
+        const declaring = local.includes(chrome);
         const environment = {
           ...chrome.environment,
           context: {
@@ -12344,7 +12813,7 @@ function finishDocxBlocks(expanded, document, theme, evaluator, effects, sources
           );
           props[part] = evaluator.expand(compiled, `${path4}/props/${part}`);
         }
-        if (props.pageBreak === void 0)
+        if (props.pageBreak === void 0 && declaring)
           props.pageBreak = chrome.settings.pageBreak ?? true;
       }
       for (const effect of local)
@@ -14631,6 +15100,39 @@ var docxRequiredChromeRule = {
     }));
   }
 };
+var docxExhibitRequiredRule = {
+  id: "docx/exhibit-required",
+  description: "Fewer data exhibits \u2014 charts, or tables of two or more columns \u2014 than a profile or policy expects. Off until one sets a minimum.",
+  code: QUALITY_CODES.EXHIBIT_MISSING,
+  category: "composition",
+  defaultSeverity: "warning",
+  defaultCertainty: "deterministic",
+  formats: ["docx"],
+  defaultEnabled: false,
+  defaultParameters: { minimumExhibits: 1 },
+  evaluate: ({ facts, configuration, profile }) => {
+    const minimum = numberParameter(
+      configuration.parameters,
+      "minimumExhibits",
+      1
+    );
+    if (minimum <= 0) return [];
+    const charts = facts.filter((fact) => fact.kind === "docx/chart").length;
+    const tables = facts.filter(
+      (fact) => fact.kind === "docx/table" && fact.columns.length >= 2
+    ).length;
+    const exhibits = charts + tables;
+    if (exhibits >= minimum) return [];
+    return [
+      {
+        path: themeFact(facts)?.path ?? "/props",
+        message: exhibits === 0 ? `The document carries no data exhibit \u2014 no chart, no table of two or more columns; the ${profile?.id ?? "selected"} profile expects at least ${minimum}.` : `The document carries ${exhibits} data exhibit(s); the ${profile?.id ?? "selected"} profile expects at least ${minimum}.`,
+        suggestion: "Put the numbers the argument leans on into a chart-figure or a data-table block, with a takeaway and a source, where the text discusses them. A kpi-row summarises; it does not count.",
+        context: { charts, tables, minimum }
+      }
+    ];
+  }
+};
 var SECTION_CHROME_PARTS = ["header", "footer", "pageNumber"];
 var docxRunningHeadRule = {
   id: "docx/running-head",
@@ -14660,7 +15162,7 @@ var docxRunningHeadRule = {
         {
           path: fact.path,
           message: `Section ${fact.index + 1} carries no ${parts}; the ${profile?.id ?? "selected"} profile expects a running head on every section after the cover.`,
-          suggestion: "Invoke a running-head block at the top of the first body section: its section effect fills every later section with the tracker and n / N.",
+          suggestion: "Invoke a running-head block at the top of the first body section: its section effect fills every later section with the title and n / N.",
           context: { section: fact.index, missing }
         }
       ];
@@ -14848,6 +15350,7 @@ var DOCX_QUALITY_RULES = {
     docxPaletteRule,
     docxRequiredChromeRule,
     docxRunningHeadRule,
+    docxExhibitRequiredRule,
     docxTypeScaleRule,
     docxSizeCountRule,
     docxRoleDriftRule
@@ -14857,7 +15360,7 @@ var DOCX_QUALITY_PROFILES = {
   "client-report": {
     id: "client-report",
     formats: ["docx"],
-    description: "Client or public-administration report: a running head with page numbers on every section after the cover, a takeaway and a source wherever a block declares them, no heading skipped, every size on the theme scale with at most eight in play, and no page rendered empty or left half blank under the running head.",
+    description: "Client or public-administration report: a running head with page numbers on every section after the cover, a takeaway and a source wherever a block declares them, no heading skipped, every size on the theme scale with at most eight in play, no page rendered empty or left half blank under the running head, and at least one chart or table.",
     rules: {
       "docx/required-chrome": {
         parameters: { required: ["takeaway", "source"] }
@@ -14879,7 +15382,9 @@ var DOCX_QUALITY_PROFILES = {
       "rendered/empty-page": { severity: "warning" },
       // A section that ends early on its own page reads as unfinished; the
       // judge calls a page two-thirds blank a defect.
-      "rendered/page-underfilled": { severity: "warning" }
+      "rendered/page-underfilled": { severity: "warning" },
+      // A client report argues numbers: at least one chart or real table.
+      "docx/exhibit-required": { enabled: true }
     }
   },
   "executive-report": {
@@ -14893,7 +15398,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",
@@ -14901,7 +15433,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;
@@ -15068,8 +15600,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";
@@ -15140,8 +15673,7 @@ var client_report_docx_blueprint_default = {
                 ref: "section-opener",
                 slots: {
                   number: "01",
-                  title: "{{Section title: the finding, as a statement}}",
-                  tracker: "{{Tracker: one word}}"
+                  title: "{{Section title: the finding, as a statement}}"
                 }
               }
             },
@@ -15198,8 +15730,7 @@ var client_report_docx_blueprint_default = {
                 ref: "section-opener",
                 slots: {
                   number: "02",
-                  title: "{{Section title: the finding, as a statement}}",
-                  tracker: "{{Tracker: one word}}"
+                  title: "{{Section title: the finding, as a statement}}"
                 }
               }
             },
@@ -15271,15 +15802,529 @@ var client_report_docx_blueprint_default = {
                 ref: "section-opener",
                 slots: {
                   number: "03",
-                  title: "{{Section title: the finding, as a statement}}",
-                  tracker: "{{Tracker: one word}}"
+                  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: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: the evidence for the sub-heading, with its numbers}}"
               }
             },
             {
@@ -15287,8 +16332,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: the runs or cases, and their conditions}}",
+                  labelHeader: "{{Run or case}}",
                   labels: ["{{Row 1}}", "{{Row 2}}", "{{Row 3}}"],
                   columns: [
                     {
@@ -15296,21 +16341,43 @@ 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: "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}}",
-                  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}}"
                 }
               }
             }
@@ -15324,22 +16391,24 @@ var client_report_docx_blueprint_default = {
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "04",
-                  title: "{{Section title: the finding, as a statement}}",
-                  tracker: "{{Tracker: one word}}"
+                  number: "5",
+                  title: "{{Section title: the readiness or decision statement}}"
                 }
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: the answer to the brief's question, with its condition}}"
               }
             },
             {
               name: "block",
               props: {
-                ref: "footnotes"
+                ref: "footnotes",
+                slots: {
+                  title: "References"
+                }
               }
             }
           ]
@@ -15347,16 +16416,16 @@ var client_report_docx_blueprint_default = {
       ]
     },
     narrative: {
-      description: "Argument-led: takeaways, then three sections of prose with one KPI row and one note as evidence, next steps last.",
-      whenToUse: "The brief is a position, an assessment or a recommendation with few numbers; the reader follows an argument.",
+      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: 6
+        max: 8
       },
       metadata: {
         title: "{{Title: as on the cover}}",
         author: "{{Author or team}}",
-        company: "{{Client name}}",
+        company: "{{Team or client name}}",
         date: "{{Month YYYY}}"
       },
       children: [
@@ -15369,10 +16438,10 @@ var client_report_docx_blueprint_default = {
                 ref: "cover",
                 slots: {
                   title: "{{Title: the report's conclusion in one sentence}}",
-                  subtitle: "{{Subtitle: what the report answers, for whom}}",
-                  client: "{{Client name}}",
+                  subtitle: "{{Subtitle: what was examined, for whom}}",
+                  client: "{{Team or client name}}",
                   date: "{{Month YYYY}}",
-                  confidentiality: "{{Confidentiality: Confidential, or For internal use}}"
+                  confidentiality: "{{Confidentiality: Internal, or Confidential}}"
                 }
               }
             }
@@ -15391,14 +16460,24 @@ var client_report_docx_blueprint_default = {
                 }
               }
             },
+            {
+              name: "toc",
+              props: {
+                scope: "document",
+                title: "Contents",
+                depth: {
+                  from: 1,
+                  to: 2
+                }
+              }
+            },
             {
               name: "block",
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "01",
-                  title: "{{Section title: the finding, as a statement}}",
-                  tracker: "{{Tracker: one word}}"
+                  number: "1",
+                  title: "{{Section title: the conclusion, as a statement}}"
                 }
               }
             },
@@ -15407,10 +16486,11 @@ var client_report_docx_blueprint_default = {
               props: {
                 ref: "key-takeaways",
                 slots: {
+                  label: "Summary",
                   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}}"
+                    "{{Finding 1: one claim, one sentence, with its number}}",
+                    "{{Finding 2: one claim, one sentence, with its number}}",
+                    "{{Finding 3: the recommendation that follows}}"
                   ]
                 }
               }
@@ -15418,13 +16498,34 @@ 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: 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: context and constraints}}"
+                }
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: the system or situation as it is, with the numbers that bound it}}"
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: the requirement or question this report answers}}"
               }
             }
           ]
@@ -15437,32 +16538,44 @@ var client_report_docx_blueprint_default = {
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "02",
-                  title: "{{Section title: the finding, as a statement}}",
-                  tracker: "{{Tracker: one word}}"
+                  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}}"
               }
             },
             {
               name: "block",
               props: {
-                ref: "callout",
+                ref: "data-table",
                 slots: {
-                  label: "{{Note label}}",
-                  text: "{{Note: a caveat about the numbers, a definition or the method}}"
+                  title: "{{Table title: what it compares, and the conditions}}",
+                  labelHeader: "{{Option 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: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: what the table settles and what it leaves open}}"
               }
             }
           ]
@@ -15475,73 +16588,202 @@ var client_report_docx_blueprint_default = {
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "03",
-                  title: "{{Section title: the finding, as a statement}}",
-                  tracker: "{{Tracker: one word}}"
+                  number: "4",
+                  title: "{{Section title: options and risks}}"
                 }
               }
             },
             {
               name: "paragraph",
               props: {
-                text: "{{Body: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: each option with its cost, its risk and what it forecloses}}"
               }
             },
             {
               name: "block",
               props: {
-                ref: "kpi-row",
+                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: recommendation and next steps}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: the recommendation, its condition and the first three steps with owners and dates}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "footnotes",
+                slots: {
+                  title: "References"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    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: 1,
+        max: 3
+      },
+      metadata: {
+        title: "{{Title: the subject line}}",
+        author: "{{Author or team}}",
+        company: "{{Team or client name}}",
+        date: "{{Month YYYY}}"
+      },
+      children: [
+        {
+          name: "section",
+          children: [
+            {
+              name: "block",
+              props: {
+                ref: "memo-header",
+                slots: {
+                  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: "block",
+              props: {
+                ref: "running-head",
                 slots: {
+                  confidentiality: "{{Confidentiality: Internal, or Confidential}}",
+                  date: "{{Month YYYY}}"
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "key-takeaways",
+                slots: {
+                  label: "Recommendation",
                   items: [
+                    "{{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: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "1",
+                  title: "{{Section title: the question and its constraints}}"
+                }
+              }
+            },
+            {
+              name: "paragraph",
+              props: {
+                text: "{{Body: the requirements, each with its number, and what was considered}}"
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "section-opener",
+                slots: {
+                  number: "2",
+                  title: "{{Section title: the options against the requirements}}"
+                }
+              }
+            },
+            {
+              name: "block",
+              props: {
+                ref: "data-table",
+                slots: {
+                  title: "{{Table title: options against the requirements}}",
+                  labelHeader: "{{Option}}",
+                  labels: ["{{Row 1}}", "{{Row 2}}", "{{Row 3}}"],
+                  columns: [
                     {
-                      value: "{{0.0}}",
-                      label: "{{What it measures}}"
-                    },
-                    {
-                      value: "{{0.0}}",
-                      label: "{{What it measures}}"
+                      header: "{{Measure (unit)}}",
+                      cells: ["{{0.0}}", "{{0.0}}", "{{0.0}}"]
                     },
                     {
-                      value: "{{0.0}}",
-                      label: "{{What it measures}}"
+                      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: two or three short paragraphs of evidence for the section title, each opening with its claim}}"
+                text: "{{Body: why the recommended option wins and what the others lose on}}"
               }
-            }
-          ]
-        },
-        {
-          name: "section",
-          children: [
+            },
+            {
+              name: "block",
+              props: {
+                ref: "callout",
+                slots: {
+                  label: "{{Note label: Assumption}}",
+                  text: "{{Note: the assumption the recommendation rests on}}"
+                }
+              }
+            },
             {
               name: "block",
               props: {
                 ref: "section-opener",
                 slots: {
-                  number: "04",
-                  title: "{{Section title: the finding, as a statement}}",
-                  tracker: "{{Tracker: one word}}"
+                  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"
+                }
               }
             }
           ]
@@ -15552,25 +16794,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 {
@@ -15588,119 +16811,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();