@json-to-office/core-docx 2.6.0 → 3.0.0

package/dist/ir/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/ir/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA6C3D,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,wBAAwB,CAAC;AAuC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAEL,KAAK,MAAM,EAqCZ,MAAM,SAAS,CAAC;AAiBjB,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IACrD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B;;;;OAIG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AA8FD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,QAAQ,GAAE,iBAAiB,EAAO,EAClC,MAAM,GAAE,cAA0B,EAClC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,iBAAiB,CAgHnB"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/ir/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAiD3D,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,wBAAwB,CAAC;AAuC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAEL,KAAK,MAAM,EAqCZ,MAAM,SAAS,CAAC;AAiBjB,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IACrD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B;;;;OAIG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AA8FD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,QAAQ,GAAE,iBAAiB,EAAO,EAClC,MAAM,GAAE,cAA0B,EAClC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,iBAAiB,CAgHnB"}

package/dist/plugin/createDocumentGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createDocumentGenerator.d.ts","sourceRoot":"","sources":["../../src/plugin/createDocumentGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAEV,wBAAwB,EAOxB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAajB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,oFAAoF;IACpF,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AA4sBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAkBvC"}
+{"version":3,"file":"createDocumentGenerator.d.ts","sourceRoot":"","sources":["../../src/plugin/createDocumentGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAEV,wBAAwB,EAOxB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAejB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,oFAAoF;IACpF,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAoyBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAkBvC"}

package/dist/plugin/example/index.js

@@ -8702,210 +8702,6 @@ function emptyToUndefined(formatting) {
   return entries.length === 0 ? void 0 : Object.fromEntries(entries);
 }
 
-// src/blocks/index.ts
-import { KEY_TAKEAWAYS_BUDGET } from "@json-to-office/shared-docx";
-
-// src/blocks/keyTakeaways.ts
-var MIN_RULE_PT = 0.25;
-var MAX_RULE_PT = 12;
-var KEY_TAKEAWAYS_DEFAULT_LABEL = "Key takeaways";
-var FALLBACK_RECIPE = {
-  ruleWeightPt: 1.5,
-  ruleColor: "accent",
-  padPt: 6,
-  type: "label"
-};
-function compileKeyTakeaways(props, theme) {
-  const recipe = theme.chrome?.keyTakeaways;
-  const labelRole = recipe?.type ?? FALLBACK_RECIPE.type;
-  const labelStyle = theme.styles?.[labelRole];
-  const ruleWeightPt = Math.min(
-    MAX_RULE_PT,
-    Math.max(
-      MIN_RULE_PT,
-      recipe?.rule?.weightPt ?? FALLBACK_RECIPE.ruleWeightPt
-    )
-  );
-  const ruleColor = recipe?.rule?.color ?? recipe?.color ?? FALLBACK_RECIPE.ruleColor;
-  const padPt = recipe?.padPt ?? FALLBACK_RECIPE.padPt;
-  const children = [
-    {
-      name: "divider",
-      props: {
-        thickness: ruleWeightPt,
-        color: ruleColor,
-        spacing: { before: 12, after: padPt }
-      }
-    },
-    {
-      name: "paragraph",
-      props: {
-        text: props.label ?? KEY_TAKEAWAYS_DEFAULT_LABEL,
-        keepNext: true,
-        spacing: { after: 4 },
-        // The label role when the theme resolves one; a bold run in the
-        // recipe's colour otherwise, so the label still reads as a label.
-        ...labelStyle ? { themeStyle: labelRole } : {
-          font: {
-            bold: true,
-            ...recipe?.color !== void 0 && { color: recipe.color }
-          }
-        }
-      }
-    },
-    {
-      name: "list",
-      props: { items: [...props.items] }
-    },
-    {
-      name: "divider",
-      props: {
-        thickness: 0.5,
-        color: "borderPrimary",
-        spacing: { before: padPt, after: 12 }
-      }
-    }
-  ];
-  return {
-    children,
-    sourceMap: {
-      "/children/0": "",
-      "/children/1": "",
-      "/children/1/props/text": "/props/label",
-      "/children/2": "",
-      "/children/2/props/items": "/props/items",
-      "/children/3": ""
-    }
-  };
-}
-
-// src/blocks/index.ts
-var BLOCK_NAMES = ["key-takeaways"];
-var BLOCKS = {
-  "key-takeaways": {
-    compile: (props, theme) => compileKeyTakeaways(props, theme),
-    budgets: (props, pointer) => (Array.isArray(props.items) ? props.items : []).flatMap(
-      (item, index) => typeof item === "string" ? [
-        {
-          block: "key-takeaways",
-          slot: "items",
-          path: `${pointer}/props/items/${index}`,
-          words: wordCount(item),
-          maxWords: KEY_TAKEAWAYS_BUDGET.items.maxWords
-        }
-      ] : []
-    )
-  }
-};
-function isBlockName(name) {
-  return BLOCK_NAMES.includes(name);
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function expandBlocks(document, theme) {
-  const sourceMap = {};
-  const blocks = [];
-  const walk2 = (node, pointer) => {
-    if (Array.isArray(node)) {
-      return node.map((child, index) => walk2(child, `${pointer}/${index}`));
-    }
-    if (!isRecord(node)) return node;
-    if (typeof node.name === "string" && isRecord(node.props)) {
-      if (node.enabled !== false && isBlockName(node.name)) {
-        const compiled = BLOCKS[node.name].compile(node.props, theme);
-        blocks.push(pointer);
-        for (const [emitted, authored] of Object.entries(compiled.sourceMap)) {
-          sourceMap[`${pointer}${emitted}`] = `${pointer}${authored}`;
-        }
-        return { ...node, children: compiled.children };
-      }
-    }
-    const next = { ...node };
-    if (isRecord(node.props)) {
-      const props = { ...node.props };
-      let changed = false;
-      for (const key of ["header", "footer"]) {
-        if (Array.isArray(props[key])) {
-          props[key] = walk2(props[key], `${pointer}/props/${key}`);
-          changed = true;
-        }
-      }
-      if (Array.isArray(props.columns)) {
-        props.columns = props.columns.map((column, index) => {
-          if (!isRecord(column)) return column;
-          const base = `${pointer}/props/columns/${index}`;
-          const out = { ...column };
-          if (isRecord(column.header) && "content" in column.header) {
-            out.header = {
-              ...column.header,
-              content: walk2(column.header.content, `${base}/header/content`)
-            };
-          }
-          if (Array.isArray(column.cells)) {
-            out.cells = column.cells.map(
-              (cell, cellIndex) => isRecord(cell) && "content" in cell ? {
-                ...cell,
-                content: walk2(
-                  cell.content,
-                  `${base}/cells/${cellIndex}/content`
-                )
-              } : cell
-            );
-          }
-          return out;
-        });
-        changed = true;
-      }
-      if (changed) next.props = props;
-    }
-    if (Array.isArray(node.children)) {
-      next.children = walk2(node.children, `${pointer}/children`);
-    }
-    return next;
-  };
-  const expanded = walk2(document, "");
-  return {
-    document: blocks.length > 0 ? expanded : document,
-    sourceMap,
-    blocks
-  };
-}
-function toAuthoredPointer(sourceMap, pointer) {
-  let best;
-  for (const emitted of Object.keys(sourceMap)) {
-    if ((pointer === emitted || pointer.startsWith(`${emitted}/`)) && (best === void 0 || emitted.length > best.length)) {
-      best = emitted;
-    }
-  }
-  if (best === void 0) return pointer;
-  return `${sourceMap[best]}${pointer.slice(best.length)}`;
-}
-function blockSlotBudgets(document, blocks) {
-  return blocks.flatMap((pointer) => {
-    const node = nodeAt(document, pointer);
-    if (!isRecord(node) || !isRecord(node.props) || !isBlockName(node.name)) {
-      return [];
-    }
-    return BLOCKS[node.name].budgets(node.props, pointer);
-  });
-}
-function wordCount(text) {
-  const trimmed = text.trim();
-  return trimmed === "" ? 0 : trimmed.split(/\s+/).length;
-}
-function nodeAt(root, pointer) {
-  if (pointer === "") return root;
-  let current = root;
-  for (const segment of pointer.slice(1).split("/")) {
-    const key = segment.replace(/~1/g, "/").replace(/~0/g, "~");
-    if (Array.isArray(current)) current = current[Number(key)];
-    else if (isRecord(current)) current = current[key];
-    else return void 0;
-  }
-  return current;
-}
-
 // src/ir/compiler.ts
 init_types();
 init_units();
@@ -9203,33 +8999,47 @@ function compileChromeParagraph(component, scope) {
   const text = String(props.text ?? "");
   if (reportUnlowered(component, props, text, scope)) return [];
   const font = props.font ?? {};
-  const normal = getNormalStyle(ctx.theme);
+  const named = chromeStyle(ctx.theme, props.themeStyle);
+  const base = { ...getNormalStyle(ctx.theme), ...named };
+  const styleId = named ? paragraphStyleId(props.themeStyle) ?? "Normal" : "Normal";
+  if (styleId !== "Normal" && !ctx.styleIds.has(styleId)) {
+    ctx.styleIds.add(styleId);
+  }
   const chromeProps = {
     text,
-    ...props.alignment ? { alignment: props.alignment } : {},
+    ...named ? { themeStyle: props.themeStyle } : {},
+    ...props.alignment ? { alignment: props.alignment } : named?.alignment ? { alignment: named.alignment } : {},
     ...props.spacing ? { spacing: props.spacing } : {},
+    ...props.indent ? { indent: props.indent } : {},
+    ...props.tabStops ? { tabStops: props.tabStops } : {},
     ...props.boldColor ? { boldColor: props.boldColor } : {},
     font: {
-      family: font.family || resolveFontFamily(ctx.theme, normal.font) || getThemeFonts(ctx.theme).body.family,
-      size: font.size ?? normal.size ?? 11,
-      color: font.color || normal.color || "textPrimary",
-      bold: font.bold ?? false,
-      italic: font.italic ?? false,
+      family: font.family || resolveFontFamily(ctx.theme, base.font) || getThemeFonts(ctx.theme).body.family,
+      size: font.size ?? base.size ?? 11,
+      color: font.color || base.color || "textPrimary",
+      bold: font.bold ?? base.bold ?? false,
+      italic: font.italic ?? base.italic ?? false,
       ...font.underline !== void 0 ? { underline: font.underline } : {},
-      ...font.fontWeight !== void 0 ? { fontWeight: font.fontWeight } : {},
-      ...font.case !== void 0 ? { case: font.case } : {},
+      ...(font.fontWeight ?? base.fontWeight) !== void 0 ? { fontWeight: font.fontWeight ?? base.fontWeight } : {},
+      ...(font.case ?? base.case) !== void 0 ? { case: font.case ?? base.case } : {},
+      ...(font.characterSpacing ?? base.characterSpacing) !== void 0 ? { characterSpacing: font.characterSpacing ?? base.characterSpacing } : {},
       ...font.lineSpacing !== void 0 ? { lineSpacing: font.lineSpacing } : {}
     }
   };
   return [
     paragraphNode(scope, compileRuns(chromeProps, text, ctx, scope.path), {
-      styleId: "Normal",
+      styleId,
       formatting: paragraphFormatting(chromeProps, ctx, {
         alwaysSpacing: true
       })
     })
   ];
 }
+function chromeStyle(theme, themeStyle) {
+  if (typeof themeStyle !== "string" || !themeStyle) return void 0;
+  const styles = getThemeStyles(theme);
+  return styles[themeStyle] ?? styles[themeStyle.toLowerCase()];
+}
 function compileChromeImage(component, scope) {
   const { ctx, path: path3 } = scope;
   const props = component.props ?? {};
@@ -9317,7 +9127,7 @@ function compileComponent(component, scope) {
     case "table":
       return compileTable(component, scope);
     default:
-      if (isBlockName(component.name)) {
+      if (component.name === "group") {
         if (component.enabled === false) return [];
         return compileBlock(component, scope);
       }
@@ -9329,8 +9139,8 @@ function compileComponent(component, scope) {
   }
 }
 function compileBlock(component, scope) {
-  const children = component.children ?? [];
-  if (children.length === 0) {
+  const children = component.children;
+  if (!Array.isArray(children)) {
     scope.ctx.unsupported.push({ name: component.name, path: scope.path });
     return [];
   }
@@ -12360,6 +12170,204 @@ function normalizeDocument(document) {
   return [normalized];
 }
 
+// src/blocks/document.ts
+init_styles();
+init_widthUtils();
+import {
+  JsonBlockEvaluator,
+  BlockEvaluationError,
+  composeBlocksWithPlugins,
+  readBlockDefinitions,
+  blockValueAt,
+  isBlockRecord,
+  toAuthoredBlockPointer
+} from "@json-to-office/shared";
+import { blockSlotBudgets } from "@json-to-office/shared";
+import { validateDocument as validateDocument2 } from "@json-to-office/shared-docx";
+var toAuthoredPointer = toAuthoredBlockPointer;
+function docxBlockContext(document, theme, path3 = "") {
+  const index = /^\/children\/(\d+)/.exec(path3)?.[1];
+  const section2 = index === void 0 ? void 0 : blockValueAt(document, `/children/${index}`);
+  const page = isBlockRecord(section2) && isBlockRecord(section2.props) && isBlockRecord(section2.props.page) ? section2.props.page : {};
+  const margins = getDocumentMargins(theme);
+  const dimensions = getPageDimensions(
+    page.size ?? theme.page.size
+  );
+  const overrides = isBlockRecord(page.margins) ? page.margins : {};
+  const width = Object.keys(page).length ? Math.max(
+    0,
+    dimensions.width - Number(overrides.left ?? margins.left ?? 1440) - Number(overrides.right ?? margins.right ?? 1440)
+  ) : getAvailableWidthTwips(theme);
+  const height = Object.keys(page).length ? Math.max(
+    0,
+    dimensions.height - Number(overrides.top ?? margins.top ?? 1440) - Number(overrides.bottom ?? margins.bottom ?? 1440)
+  ) : getAvailableHeightTwips(theme);
+  return {
+    document: blockValueAt(document, "/props/metadata") ?? {},
+    page: { width, height },
+    section: {}
+  };
+}
+function createDocxBlockEvaluator(document, theme, extra = {}) {
+  return new JsonBlockEvaluator(readBlockDefinitions(document), {
+    format: "docx",
+    theme,
+    contextAt: (path3) => docxBlockContext(document, theme, path3),
+    contextSources: { "/document": "/props/metadata" },
+    measure: (axis, unit, context) => Number(blockValueAt(context, `/page/${axis}`)) / (unit === "twip" ? 1 : unit === "in" ? 1440 : 20),
+    ...extra
+  });
+}
+function expandBlocks(document, theme) {
+  const effects = [];
+  const evaluator = createDocxBlockEvaluator(document, theme, {
+    onSection: (effect) => effects.push(effect)
+  });
+  const expanded = evaluator.expand(document);
+  return finishDocxBlocks(expanded, document, theme, evaluator, effects);
+}
+function validateEffects(document, effects) {
+  for (const effect of effects) {
+    const parts = effect.path.split("/").slice(1);
+    const section2 = blockValueAt(document, "/" + parts.slice(0, 2).join("/"));
+    let valid = parts.length >= 4 && parts[0] === "children" && parts[2] === "children" && isBlockRecord(section2) && section2.name === "section";
+    for (let i = 4; i < parts.length; i += 2) {
+      const parent = blockValueAt(document, "/" + parts.slice(0, i).join("/"));
+      valid &&= parts[i] === "children" && isBlockRecord(parent) && parent.name === "group";
+    }
+    if (!valid)
+      throw new BlockEvaluationError([
+        {
+          path: effect.environment.source,
+          code: "invalid_placement",
+          message: "Section effects require a block in a top-level section body, optionally nested in transparent groups."
+        }
+      ]);
+  }
+}
+function finishDocxBlocks(expanded, document, theme, evaluator, effects, validate = true) {
+  if (isBlockRecord(expanded) && Array.isArray(expanded.children)) {
+    let inherited;
+    expanded.children.forEach((section2, index) => {
+      if (!isBlockRecord(section2) || section2.name !== "section" || section2.enabled === false)
+        return;
+      const path3 = `/children/${index}`;
+      const local = effects.filter(
+        (e) => e.path.startsWith(`${path3}/children/`)
+      );
+      let tracker;
+      let trackerSource = path3;
+      for (const effect of local) {
+        if (effect.settings.tracker !== void 0) {
+          tracker = evaluator.evaluate(
+            effect.settings.tracker,
+            effect.environment,
+            `${path3}/props/tracker`,
+            `${effect.environment.definition}/section/tracker`
+          );
+          trackerSource = toAuthoredPointer(
+            evaluator.sourceMap,
+            `${path3}/props/tracker`
+          );
+        }
+      }
+      let chrome = inherited;
+      for (const effect of local) {
+        if (effect.settings.header !== void 0 || effect.settings.footer !== void 0) {
+          chrome = effect;
+          if (effect.settings.scope === "following") inherited = effect;
+        }
+      }
+      const props = isBlockRecord(section2.props) ? { ...section2.props } : {};
+      if (chrome) {
+        const environment = {
+          ...chrome.environment,
+          context: {
+            ...docxBlockContext(document, theme, path3),
+            section: { tracker }
+          },
+          contextSources: {
+            "/document": "/props/metadata",
+            "/section/tracker": trackerSource
+          }
+        };
+        for (const part of ["header", "footer"]) {
+          if (props[part] !== void 0 || chrome.settings[part] === void 0)
+            continue;
+          const compiled = evaluator.evaluate(
+            chrome.settings[part],
+            environment,
+            `${path3}/props/${part}`,
+            `${environment.definition}/section/${part}`
+          );
+          props[part] = evaluator.expand(compiled, `${path3}/props/${part}`);
+        }
+        if (props.pageBreak === void 0)
+          props.pageBreak = chrome.settings.pageBreak ?? true;
+      }
+      for (const effect of local)
+        if (effect.settings.pageBreak !== void 0 && props.pageBreak === void 0)
+          props.pageBreak = effect.settings.pageBreak;
+      section2.props = props;
+    });
+  }
+  validateEffects(expanded, effects);
+  if (evaluator.blocks.length && validate) {
+    const result = validateDocument2(expanded);
+    if (!result.valid)
+      throw new BlockEvaluationError(
+        result.errors.map((issue) => ({
+          path: toAuthoredPointer(evaluator.sourceMap, issue.path),
+          code: issue.code ?? "block_invalid_output",
+          message: issue.message
+        }))
+      );
+  }
+  return {
+    document: expanded,
+    sourceMap: evaluator.sourceMap,
+    blocks: evaluator.blocks
+  };
+}
+async function expandBlocksWithPlugins(document, theme, plugins, render, preserve = /* @__PURE__ */ new Set()) {
+  const effects = [];
+  const evaluator = createDocxBlockEvaluator(document, theme, {
+    reservedNames: [...plugins],
+    onSection: (effect) => effects.push(effect)
+  });
+  const walk2 = (value) => composeBlocksWithPlugins(evaluator, value, {
+    plugins,
+    render,
+    preserve
+  });
+  const first = await walk2(document);
+  const finished = finishDocxBlocks(
+    first.standard,
+    document,
+    theme,
+    evaluator,
+    effects,
+    false
+  );
+  const second = await walk2(finished.document);
+  validateEffects(second.standard, effects);
+  const result = validateDocument2(second.standard);
+  if (!result.valid)
+    throw new BlockEvaluationError(
+      result.errors.map((issue) => ({
+        path: toAuthoredPointer(evaluator.sourceMap, issue.path),
+        code: issue.code ?? "block_invalid_output",
+        message: issue.message
+      }))
+    );
+  return {
+    document: second.standard,
+    preserved: first.preserved,
+    sourceMap: evaluator.sourceMap,
+    blocks: evaluator.blocks
+  };
+}
+
 // src/quality/facts.ts
 init_styleHelpers();
 init_defaults();
@@ -12802,7 +12810,10 @@ function prepareDocxQualityDocument(document, options = {}) {
   const facts = [];
   const provenance = {};
   let previousHeadingLevel;
-  const authoredPath = (path3) => toAuthoredPointer(expanded.sourceMap, path3);
+  const authoredPath = (path3) => toAuthoredPointer(
+    themed.sourceMap ?? {},
+    toAuthoredPointer(expanded.sourceMap, path3)
+  );
   const addFact = (raw) => {
     const fact = {
       ...raw,
@@ -12817,7 +12828,7 @@ function prepareDocxQualityDocument(document, options = {}) {
       ...fact.relatedPaths && { relatedPaths: fact.relatedPaths }
     };
   };
-  for (const budget of blockSlotBudgets(context.document, expanded.blocks)) {
+  for (const budget of blockSlotBudgets(themed.document, expanded.blocks)) {
     addFact({
       id: `docx:block-slot:${budget.path}`,
       kind: "docx/block-slot",
@@ -12967,11 +12978,19 @@ function prepareDocxQualityDocument(document, options = {}) {
     facts,
     provenance,
     renderer: options.renderer ?? DEFAULT_DOCX_RENDERER_ID2,
-    ...expanded.blocks.length > 0 && {
+    ...(expanded.blocks.length > 0 || (themed.blockPaths?.length ?? 0) > 0) && {
       metadata: {
         blocks: {
-          sourceMap: expanded.sourceMap,
-          blocks: expanded.blocks,
+          sourceMap: {
+            ...themed.sourceMap,
+            ...Object.fromEntries(
+              Object.entries(expanded.sourceMap).map(([key, value]) => [
+                key,
+                toAuthoredPointer(themed.sourceMap ?? {}, value)
+              ])
+            )
+          },
+          blocks: [...themed.blockPaths ?? [], ...expanded.blocks],
           document: context.document
         }
       }
@@ -13309,12 +13328,12 @@ function createBuilderImpl(state) {
         );
       }
     }
-    const validateEmitted = vOpts.enabled === false ? void 0 : (emitted, componentLabel) => {
+    const validateEmitted = vOpts.enabled === false ? void 0 : (emitted, componentLabel, sourcePath) => {
       const result = validateDocument(
         {
           ...internalDocument,
           ...renderer !== void 0 ? { renderer } : {},
-          children: emitted
+          children: sourcePath === void 0 ? emitted : [{ name: "section", props: {}, children: emitted }]
         },
         state.components,
         { allowUnknownFields: vOpts.allowUnknownFields }
@@ -13322,7 +13341,10 @@ function createBuilderImpl(state) {
       if (!result.valid) {
         throw new ComponentValidationError2(
           (result.errors ?? []).map((e) => ({
-            path: e.path ?? "",
+            path: sourcePath === void 0 ? e.path ?? "" : (e.path ?? "").replace(
+              /^\/children\/0\/children\/\d+/,
+              sourcePath
+            ),
             message: `custom component '${componentLabel}' emitted invalid output \u2014 ${e.message}`
           })),
           emitted
@@ -13340,6 +13362,62 @@ function createBuilderImpl(state) {
       warnings,
       resolveNamedTheme: resolveDocumentTheme
     });
+    if (modedRoot.props.blocks !== void 0) {
+      const expanded = await expandBlocksWithPlugins(
+        modedRoot,
+        modedTheme,
+        new Set(componentMap.keys()),
+        async (component, path3) => {
+          const custom = componentMap.get(String(component.name));
+          const version = resolveComponentVersion(
+            custom.name,
+            custom.versions,
+            component.version
+          );
+          const checked = validateComponentProps(
+            version,
+            component.props ?? {},
+            custom.name,
+            { clean: vOpts.allowUnknownFields === true }
+          );
+          if (!checked.valid)
+            throw new ComponentValidationError2(
+              (checked.errors ?? []).map((e) => ({ path: path3, message: e.message })),
+              component
+            );
+          const output = await version.render({
+            props: cleanComponentProps(version, component.props ?? {}),
+            theme: modedTheme,
+            children: component.children,
+            addWarning: (message, context) => warnings.push({
+              component: custom.name,
+              message,
+              severity: "warning",
+              context
+            })
+          });
+          const emitted = Array.isArray(output) ? output : [output];
+          validateEmitted?.(emitted, custom.name, path3);
+          return emitted;
+        },
+        preserveSet
+      );
+      const [modedDoc2] = normalizeDocument(expanded.document);
+      return {
+        modedRoot,
+        modedTheme,
+        themeName,
+        modedDoc: modedDoc2,
+        sourceMap: expanded.sourceMap,
+        blockPaths: expanded.blocks,
+        warnings,
+        preserveSet,
+        processed: {
+          standard: modedDoc2.children ?? [],
+          preserved: expanded.preserved.children ?? []
+        }
+      };
+    }
     const processed = await processDocumentComponents(
       modedRoot.children || [],
       preserveSet,
@@ -13364,9 +13442,13 @@ function createBuilderImpl(state) {
   }
   async function expandStandardDefinition(document, options) {
     try {
-      const { modedDoc, warnings } = await expandDocument(document, options);
+      const { modedDoc, warnings, sourceMap } = await expandDocument(
+        document,
+        options
+      );
       return {
         standardDefinition: modedDoc,
+        ...sourceMap && { sourceMap },
         warnings: warnings.length > 0 ? warnings : null
       };
     } catch (error) {
@@ -13384,6 +13466,8 @@ function createBuilderImpl(state) {
         themeName,
         processed,
         modedDoc,
+        sourceMap,
+        blockPaths,
         warnings,
         preserveSet
       } = await expandDocument(document, options);
@@ -13394,7 +13478,13 @@ function createBuilderImpl(state) {
       const { buffer } = await generateBufferViaIr(modedDoc, {
         // The prologue already ran: the theme had to be resolved before custom
         // components expanded, because each one's `render` is handed it.
-        context: { document: modedDoc, theme: modedTheme, themeName },
+        context: {
+          document: modedDoc,
+          theme: modedTheme,
+          themeName,
+          ...sourceMap !== void 0 && { sourceMap },
+          ...blockPaths !== void 0 && { blockPaths }
+        },
         ...state.services ? { services: state.services } : {},
         ...state.fonts ? { fonts: state.fonts } : {},
         ...baseDir !== void 0 ? { baseDir } : {},