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

package/dist/index.js

@@ -8454,210 +8454,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();
@@ -8955,33 +8751,47 @@ function compileChromeParagraph(component, scope) {
   const text = String(props.text ?? "");
   if (reportUnlowered(component, props, text, scope)) return [];
   const font = props.font ?? {};
-  const normal = getNormalStyle(ctx.theme);
+  const named = chromeStyle(ctx.theme, props.themeStyle);
+  const base = { ...getNormalStyle(ctx.theme), ...named };
+  const styleId = named ? paragraphStyleId(props.themeStyle) ?? "Normal" : "Normal";
+  if (styleId !== "Normal" && !ctx.styleIds.has(styleId)) {
+    ctx.styleIds.add(styleId);
+  }
   const chromeProps = {
     text,
-    ...props.alignment ? { alignment: props.alignment } : {},
+    ...named ? { themeStyle: props.themeStyle } : {},
+    ...props.alignment ? { alignment: props.alignment } : named?.alignment ? { alignment: named.alignment } : {},
     ...props.spacing ? { spacing: props.spacing } : {},
+    ...props.indent ? { indent: props.indent } : {},
+    ...props.tabStops ? { tabStops: props.tabStops } : {},
     ...props.boldColor ? { boldColor: props.boldColor } : {},
     font: {
-      family: font.family || resolveFontFamily(ctx.theme, normal.font) || getThemeFonts(ctx.theme).body.family,
-      size: font.size ?? normal.size ?? 11,
-      color: font.color || normal.color || "textPrimary",
-      bold: font.bold ?? false,
-      italic: font.italic ?? false,
+      family: font.family || resolveFontFamily(ctx.theme, base.font) || getThemeFonts(ctx.theme).body.family,
+      size: font.size ?? base.size ?? 11,
+      color: font.color || base.color || "textPrimary",
+      bold: font.bold ?? base.bold ?? false,
+      italic: font.italic ?? base.italic ?? false,
       ...font.underline !== void 0 ? { underline: font.underline } : {},
-      ...font.fontWeight !== void 0 ? { fontWeight: font.fontWeight } : {},
-      ...font.case !== void 0 ? { case: font.case } : {},
+      ...(font.fontWeight ?? base.fontWeight) !== void 0 ? { fontWeight: font.fontWeight ?? base.fontWeight } : {},
+      ...(font.case ?? base.case) !== void 0 ? { case: font.case ?? base.case } : {},
+      ...(font.characterSpacing ?? base.characterSpacing) !== void 0 ? { characterSpacing: font.characterSpacing ?? base.characterSpacing } : {},
       ...font.lineSpacing !== void 0 ? { lineSpacing: font.lineSpacing } : {}
     }
   };
   return [
     paragraphNode(scope, compileRuns(chromeProps, text, ctx, scope.path), {
-      styleId: "Normal",
+      styleId,
       formatting: paragraphFormatting(chromeProps, ctx, {
         alwaysSpacing: true
       })
     })
   ];
 }
+function chromeStyle(theme, themeStyle) {
+  if (typeof themeStyle !== "string" || !themeStyle) return void 0;
+  const styles = getThemeStyles(theme);
+  return styles[themeStyle] ?? styles[themeStyle.toLowerCase()];
+}
 function compileChromeImage(component, scope) {
   const { ctx, path: path4 } = scope;
   const props = component.props ?? {};
@@ -9069,7 +8879,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);
       }
@@ -9081,8 +8891,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 [];
   }
@@ -12274,6 +12084,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 } from "@json-to-office/shared-docx";
+var toAuthoredPointer = toAuthoredBlockPointer;
+function docxBlockContext(document, theme, path4 = "") {
+  const index = /^\/children\/(\d+)/.exec(path4)?.[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: (path4) => docxBlockContext(document, theme, path4),
+    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 path4 = `/children/${index}`;
+      const local = effects.filter(
+        (e) => e.path.startsWith(`${path4}/children/`)
+      );
+      let tracker;
+      let trackerSource = path4;
+      for (const effect of local) {
+        if (effect.settings.tracker !== void 0) {
+          tracker = evaluator.evaluate(
+            effect.settings.tracker,
+            effect.environment,
+            `${path4}/props/tracker`,
+            `${effect.environment.definition}/section/tracker`
+          );
+          trackerSource = toAuthoredPointer(
+            evaluator.sourceMap,
+            `${path4}/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, path4),
+            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,
+            `${path4}/props/${part}`,
+            `${environment.definition}/section/${part}`
+          );
+          props[part] = evaluator.expand(compiled, `${path4}/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 = validateDocument(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 = validateDocument(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();
@@ -12716,7 +12724,10 @@ function prepareDocxQualityDocument(document, options = {}) {
   const facts = [];
   const provenance = {};
   let previousHeadingLevel;
-  const authoredPath = (path4) => toAuthoredPointer(expanded.sourceMap, path4);
+  const authoredPath = (path4) => toAuthoredPointer(
+    themed.sourceMap ?? {},
+    toAuthoredPointer(expanded.sourceMap, path4)
+  );
   const addFact = (raw) => {
     const fact = {
       ...raw,
@@ -12731,7 +12742,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",
@@ -12881,11 +12892,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
         }
       }
@@ -14315,7 +14334,7 @@ function validateComponentProps(schema, props, componentName, opts) {
     componentName
   });
 }
-function validateDocument(document, customComponents, options) {
+function validateDocument2(document, customComponents, options) {
   const knownCustomNames = new Set(customComponents.map((c) => c.name));
   const documentResult = validateDocumentUnified(document, {
     knownCustomNames,
@@ -14719,7 +14738,7 @@ function createBuilderImpl(state) {
       ...options?.validation
     };
     if (vOpts.enabled !== false) {
-      const result = validateDocument(
+      const result = validateDocument2(
         validationDocument,
         state.components,
         { allowUnknownFields: vOpts.allowUnknownFields }
@@ -14734,12 +14753,12 @@ function createBuilderImpl(state) {
         );
       }
     }
-    const validateEmitted = vOpts.enabled === false ? void 0 : (emitted, componentLabel) => {
-      const result = validateDocument(
+    const validateEmitted = vOpts.enabled === false ? void 0 : (emitted, componentLabel, sourcePath) => {
+      const result = validateDocument2(
         {
           ...internalDocument,
           ...renderer !== void 0 ? { renderer } : {},
-          children: emitted
+          children: sourcePath === void 0 ? emitted : [{ name: "section", props: {}, children: emitted }]
         },
         state.components,
         { allowUnknownFields: vOpts.allowUnknownFields }
@@ -14747,7 +14766,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
@@ -14765,6 +14787,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, path4) => {
+          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: path4, 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, path4);
+          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,
@@ -14789,9 +14867,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) {
@@ -14809,6 +14891,8 @@ function createBuilderImpl(state) {
         themeName,
         processed,
         modedDoc,
+        sourceMap,
+        blockPaths,
         warnings,
         preserveSet
       } = await expandDocument(document, options);
@@ -14819,7 +14903,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 } : {},
@@ -14876,7 +14966,7 @@ function createBuilderImpl(state) {
   function validate(document) {
     try {
       const internalDocument = document;
-      const result = validateDocument(
+      const result = validateDocument2(
         internalDocument,
         state.components
       );
@@ -14955,7 +15045,6 @@ function getCoreVersion() {
   return "Core v1.0.0";
 }
 export {
-  BLOCK_NAMES,
   ComponentValidationError2 as ComponentValidationError,
   DocumentGenerator as CoreDocumentGenerator,
   DEFAULT_DOCX_RENDERER_ID,
@@ -14970,7 +15059,6 @@ export {
   analyzeDocxQuality,
   blockSlotBudgets,
   cleanComponentProps,
-  compileKeyTakeaways,
   consultingTheme,
   createComponent,
   createDocumentGenerator,
@@ -15027,7 +15115,7 @@ export {
   themes,
   toAuthoredPointer,
   validateComponentProps,
-  validateDocument,
+  validateDocument2 as validateDocument,
   validateJsonSchema,
   validateThemeJsonString,
   vermilionTheme