@json-to-office/core-docx 3.1.0 → 3.3.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;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"}
+{"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;AAoGD,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,CAiHnB"}

package/dist/ir/inline.d.ts

@@ -110,6 +110,7 @@ export declare function parseInline(text: string, options: ParseInlineOptions):
 export type PlaceholderResolution = {
     kind: 'field';
     instruction: string;
+    cachedText?: string;
 } | {
     kind: 'text';
     text: string;

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

@@ -1 +1 @@
-{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../src/ir/inline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMjE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAY7E;AA8HD,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK1E;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,GAAG,SAAS,CAAC;IACzE;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CACZ,EAAE,EAAE,MAAM,KACP;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IAClE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,CACtB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,MAAM,KACV,YAAY,GAAG,SAAS,CAAC;CAC/B;AAED,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,YAAY,GACZ,cAAc,GACd,MAAM,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,YAAY,EAAE,CAehB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA8FnC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,YAAY,EAAE,CAShB"}
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../src/ir/inline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMjE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAY7E;AA8HD,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK1E;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,GAAG,SAAS,CAAC;IACzE;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CACZ,EAAE,EAAE,MAAM,KACP;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IAClE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,CACtB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,MAAM,KACV,YAAY,GAAG,SAAS,CAAC;CAC/B;AAED,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,YAAY,GACZ,cAAc,GACd,MAAM,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,YAAY,EAAE,CAehB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAiGnC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,YAAY,EAAE,CAShB"}

package/dist/plugin/example/index.js

@@ -2348,7 +2348,7 @@ import {
   WpsShapeRun
 } from "docx";
 import { assertNever } from "@json-to-office/shared/rendering";
-function complexField(instruction, formatting, leading) {
+function complexField(instruction, formatting, leading, cachedText) {
   const options = runOptions(formatting);
   const fieldChar = (type, extra = {}) => new TextRun({
     children: [
@@ -2367,6 +2367,9 @@ function complexField(instruction, formatting, leading) {
     fieldChar("begin", leading),
     new TextRun({ children: [instrText], ...options }),
     fieldChar("separate"),
+    // A sequence number is the one field this pipeline can compute, so its
+    // result is written: a reader that never updates fields shows the count.
+    ...cachedText !== void 0 ? [new TextRun({ text: cachedText, ...options })] : [],
     fieldChar("end")
   ];
 }
@@ -2477,13 +2480,18 @@ function inlineChildren(children, resources = /* @__PURE__ */ new Map()) {
           out.push(new SimpleField(child.instruction, child.cachedText));
           break;
         }
-        if (!PAGE_FIELDS.has(child.instruction)) {
+        if (!PAGE_FIELDS.has(child.instruction) && !isSequenceField(child.instruction)) {
           throw new Error(
             `the docxjs renderer has no emitter for the field "${child.instruction}"`
           );
         }
         out.push(
-          ...complexField(child.instruction, child.formatting, breakOption())
+          ...complexField(
+            child.instruction,
+            child.formatting,
+            breakOption(),
+            child.cachedText
+          )
         );
         break;
       }
@@ -2857,7 +2865,7 @@ function emitBorder(border3) {
     ...border3.spacePoints !== void 0 ? { space: border3.spacePoints } : {}
   };
 }
-var ALIGNMENT2, PAGE_FIELDS, WRAP_TYPE, VERTICAL_ALIGN, TABLE_ANCHOR, HORIZONTAL_POSITION, VERTICAL_POSITION, BORDER_STYLE;
+var ALIGNMENT2, PAGE_FIELDS, isSequenceField, WRAP_TYPE, VERTICAL_ALIGN, TABLE_ANCHOR, HORIZONTAL_POSITION, VERTICAL_POSITION, BORDER_STYLE;
 var init_emit = __esm({
   "src/renderers/docxjs/emit.ts"() {
     "use strict";
@@ -2870,6 +2878,7 @@ var init_emit = __esm({
       end: AlignmentType.END
     };
     PAGE_FIELDS = /* @__PURE__ */ new Set(["PAGE", "NUMPAGES"]);
+    isSequenceField = (instruction) => /^SEQ [A-Za-z][\w-]* \\\* ARABIC$/.test(instruction);
     WRAP_TYPE = {
       none: TextWrappingType.NONE,
       square: TextWrappingType.SQUARE,
@@ -5298,6 +5307,10 @@ function resolveServiceUrl(propsUrl, servicesUrl, defaultUrl) {
   const withScheme = /^https?:\/\//i.test(raw) ? raw : `http://${raw}`;
   return withScheme.replace(/\/+$/, "");
 }
+var SERVICE_UNAVAILABLE_CODE = "SERVICE_UNAVAILABLE";
+function serviceUnavailable(message) {
+  return Object.assign(new Error(message), { code: SERVICE_UNAVAILABLE_CODE });
+}
 async function postJsonToService(opts) {
   const resolvedHeaders = typeof opts.headers === "function" ? await opts.headers(opts.body) : opts.headers;
   const headers = {
@@ -5317,12 +5330,12 @@ async function postJsonToService(opts) {
     });
   } catch (error) {
     if (error?.name === "AbortError") {
-      throw new Error(
+      throw serviceUnavailable(
         `${opts.serviceLabel} timed out after ${timeoutMs}ms at ${opts.url}.`
       );
     }
     const cause = error instanceof Error ? error.message : String(error);
-    throw new Error(opts.onUnreachable(opts.url, cause));
+    throw serviceUnavailable(opts.onUnreachable(opts.url, cause));
   } finally {
     clearTimeout(timer);
   }
@@ -5769,13 +5782,25 @@ init_colorUtils();
 init_layoutUtils();
 import {
   chartFamilyResolver,
+  remoteExportNotice,
+  REMOTE_EXPORT_WARNING,
   chartPointsPerPixel,
   POINTS_PER_PIXEL_96DPI,
   withChartFontFaceCss,
   withChartTypography
 } from "@json-to-office/shared";
 var DEFAULT_EXPORT_SERVER_URL = "http://localhost:7801";
-async function generateChart(config, servicesConfig) {
+function assertExportServerAllowed(serverUrl, servicesConfig, warnings) {
+  const notice = remoteExportNotice(serverUrl, servicesConfig?.allowRemote);
+  if (notice)
+    warnings?.push({
+      component: "highcharts",
+      severity: "warning",
+      message: notice,
+      context: { code: REMOTE_EXPORT_WARNING, serverUrl }
+    });
+}
+async function generateChart(config, servicesConfig, warnings) {
   if (!isNodeEnvironment()) {
     throw new Error(
       "Highcharts export server requires a Node.js environment. Chart generation is not available in browser environments."
@@ -5786,6 +5811,7 @@ async function generateChart(config, servicesConfig) {
     servicesConfig?.serverUrl,
     DEFAULT_EXPORT_SERVER_URL
   );
+  assertExportServerAllowed(serverUrl, servicesConfig, warnings);
   const requestBody = {
     infile: config.options,
     type: "png",
@@ -5898,13 +5924,13 @@ function withChartFontFaces(config, theme, faces) {
     theme.fonts.heading.family
   ]);
 }
-async function renderChartToImageProps(props, theme, servicesConfig, chartFonts) {
+async function renderChartToImageProps(props, theme, servicesConfig, chartFonts, warnings) {
   const config = withChartFontFaces(
     withThemeTypography(withThemeColors(props, theme), theme),
     theme,
     chartFonts
   );
-  const chart = await generateChart(config, servicesConfig);
+  const chart = await generateChart(config, servicesConfig, warnings);
   const hasConfigDimensions = config.width !== void 0 || config.height !== void 0;
   return {
     base64: chart.base64DataUri,
@@ -5944,7 +5970,8 @@ async function desugarExternals(document, options) {
           node.props,
           options.theme,
           options.services?.highcharts,
-          options.chartFonts
+          options.chartFonts,
+          options.warnings
         )
       });
     }
@@ -8495,6 +8522,9 @@ function parsePlaceholders(normalized, parseOptions) {
         out.push({
           kind: "field",
           instruction: resolved.instruction,
+          ...resolved.cachedText !== void 0 && {
+            cachedText: resolved.cachedText
+          },
           ...formatting ? { formatting } : {}
         });
       }
@@ -8721,6 +8751,7 @@ function compileDocument(structure, layout, warnings = [], images = /* @__PURE__
     nextBookmarkId: CONTENT_BOOKMARK_ID_BASE + 1,
     bookmarkNames: /* @__PURE__ */ new Set(),
     usesStatistic: false,
+    sequences: /* @__PURE__ */ new Map(),
     styleIds: /* @__PURE__ */ new Set([
       ...styles.paragraph.map((s) => s.id),
       ...styles.character.map((s) => s.id)
@@ -10116,7 +10147,20 @@ function compileRuns(props, text, ctx, path3, mode = "inline") {
   return children;
 }
 function placeholderResolver(ctx) {
-  return (name) => resolvePlaceholder(name, ctx.generatedAt);
+  return (name) => {
+    const sequence = /^SEQ:([A-Za-z][\w-]*)$/i.exec(name);
+    if (sequence) {
+      const key = sequence[1];
+      const count = (ctx.sequences.get(key) ?? 0) + 1;
+      ctx.sequences.set(key, count);
+      return {
+        kind: "field",
+        instruction: `SEQ ${key} \\* ARABIC`,
+        cachedText: String(count)
+      };
+    }
+    return resolvePlaceholder(name, ctx.generatedAt);
+  };
 }
 function crossReferenceResolver(ctx, path3) {
   return (id, format2, token) => resolveCrossReference(id, format2, token, ctx, path3);
@@ -11986,6 +12030,7 @@ async function processResolvedDocument(document, resolved, themeName, generation
   };
 }
 function createDocumentMetadata(props, generationDate = /* @__PURE__ */ new Date()) {
+  const parsed = props.metadata?.date ? new Date(props.metadata.date) : void 0;
   return {
     title: props.metadata?.title,
     subtitle: props.metadata?.subtitle,
@@ -11994,7 +12039,7 @@ function createDocumentMetadata(props, generationDate = /* @__PURE__ */ new Date
     company: props.metadata?.company,
     version: props.metadata?.version,
     tags: props.metadata?.tags,
-    date: props.metadata?.date ? new Date(props.metadata.date) : generationDate
+    date: parsed && !Number.isNaN(parsed.getTime()) ? parsed : generationDate
   };
 }
 async function extractSections(components, context) {
@@ -12086,7 +12131,10 @@ import {
   normalizeHighchartsChart
 } from "@json-to-office/quality";
 import { DEFAULT_DOCX_RENDERER_ID as DEFAULT_DOCX_RENDERER_ID2 } from "@json-to-office/shared-docx";
-import { designColors as designColors2, resolveDesignColor as resolveDesignColor2 } from "@json-to-office/shared";
+import {
+  designColors as designColors2,
+  resolveDesignColor as resolveDesignColor2
+} from "@json-to-office/shared";
 
 // src/json/normalizer.ts
 function normalizeComponent(component) {
@@ -12180,12 +12228,41 @@ import {
   readBlockDefinitions,
   blockValueAt,
   isBlockRecord,
-  toAuthoredBlockPointer
+  toAuthoredBlockPointer,
+  blockPointerKey,
+  blockSlotRoles
 } from "@json-to-office/shared";
-import { blockSlotBudgets } from "@json-to-office/shared";
+import { blockSlotBudgets, blockSlotRoles as blockSlotRoles2 } from "@json-to-office/shared";
 import { validateDocument as validateDocument2 } from "@json-to-office/shared-docx";
 var toAuthoredPointer = toAuthoredBlockPointer;
-function docxBlockContext(document, theme, path3 = "") {
+function documentSourceLines(document) {
+  if (!isBlockRecord(document)) return [];
+  const invocations = [];
+  const walk2 = (value, path3) => {
+    if (Array.isArray(value)) {
+      value.forEach((item, index) => walk2(item, `${path3}/${index}`));
+      return;
+    }
+    if (!isBlockRecord(value) || value.enabled === false) return;
+    if (value.name === "block") invocations.push(path3);
+    for (const [key, item] of Object.entries(value)) {
+      if (path3 === "/props" && key === "blocks") continue;
+      walk2(item, `${path3}/${blockPointerKey(key)}`);
+    }
+  };
+  walk2(document, "");
+  const seen = /* @__PURE__ */ new Set();
+  const lines = [];
+  for (const slot of blockSlotRoles(document, invocations)) {
+    if (slot.role !== "source" || typeof slot.value !== "string") continue;
+    const text = slot.value.trim();
+    if (text === "" || seen.has(text)) continue;
+    seen.add(text);
+    lines.push({ text, path: slot.path });
+  }
+  return lines;
+}
+function docxBlockContext(document, theme, path3, sources) {
   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 : {};
@@ -12205,26 +12282,46 @@ function docxBlockContext(document, theme, path3 = "") {
   return {
     document: blockValueAt(document, "/props/metadata") ?? {},
     page: { width, height },
-    section: {}
+    section: {},
+    sources: sources.map((line) => line.text)
+  };
+}
+function docxBlockContextSources(sources) {
+  return {
+    "/document": "/props/metadata",
+    ...Object.fromEntries(
+      sources.map((line, index) => [`/sources/${index}`, line.path])
+    )
   };
 }
-function createDocxBlockEvaluator(document, theme, extra = {}) {
+function createDocxBlockEvaluator(document, theme, extra = {}, sources = documentSourceLines(document)) {
   return new JsonBlockEvaluator(readBlockDefinitions(document), {
     format: "docx",
     theme,
-    contextAt: (path3) => docxBlockContext(document, theme, path3),
-    contextSources: { "/document": "/props/metadata" },
+    contextAt: (path3) => docxBlockContext(document, theme, path3, sources),
+    contextSources: docxBlockContextSources(sources),
     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 sources = documentSourceLines(document);
+  const evaluator = createDocxBlockEvaluator(
+    document,
+    theme,
+    { onSection: (effect) => effects.push(effect) },
+    sources
+  );
   const expanded = evaluator.expand(document);
-  return finishDocxBlocks(expanded, document, theme, evaluator, effects);
+  return finishDocxBlocks(
+    expanded,
+    document,
+    theme,
+    evaluator,
+    effects,
+    sources
+  );
 }
 function validateEffects(document, effects) {
   for (const effect of effects) {
@@ -12245,7 +12342,7 @@ function validateEffects(document, effects) {
       ]);
   }
 }
-function finishDocxBlocks(expanded, document, theme, evaluator, effects, validate = true) {
+function finishDocxBlocks(expanded, document, theme, evaluator, effects, sources, validate = true) {
   if (isBlockRecord(expanded) && Array.isArray(expanded.children)) {
     let inherited;
     expanded.children.forEach((section2, index) => {
@@ -12283,11 +12380,11 @@ function finishDocxBlocks(expanded, document, theme, evaluator, effects, validat
         const environment = {
           ...chrome.environment,
           context: {
-            ...docxBlockContext(document, theme, path3),
+            ...docxBlockContext(document, theme, path3, sources),
             section: { tracker }
           },
           contextSources: {
-            "/document": "/props/metadata",
+            ...docxBlockContextSources(sources),
             "/section/tracker": trackerSource
           }
         };
@@ -12331,10 +12428,16 @@ function finishDocxBlocks(expanded, document, theme, evaluator, effects, validat
 }
 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 sources = documentSourceLines(document);
+  const evaluator = createDocxBlockEvaluator(
+    document,
+    theme,
+    {
+      reservedNames: [...plugins],
+      onSection: (effect) => effects.push(effect)
+    },
+    sources
+  );
   const walk2 = (value) => composeBlocksWithPlugins(evaluator, value, {
     plugins,
     render,
@@ -12347,6 +12450,7 @@ async function expandBlocksWithPlugins(document, theme, plugins, render, preserv
     theme,
     evaluator,
     effects,
+    sources,
     false
   );
   const second = await walk2(finished.document);
@@ -12446,7 +12550,8 @@ function chartFact(node, props, path3, paletteTokens) {
     kind: "docx/chart",
     path: path3,
     componentName: typeof node.name === "string" ? node.name : "",
-    paletteTokens
+    paletteTokens,
+    generated: false
   };
   if (node.name === "highcharts") {
     const shape = normalizeHighchartsChart(props.options);
@@ -12457,7 +12562,11 @@ function chartFact(node, props, path3, paletteTokens) {
       threeD: shape.threeD,
       seriesCount: shape.seriesCount,
       categoryCount: shape.categoryCount,
-      seriesColorsStated: shape.seriesColorsStated,
+      // A config that names no `colors` is painted in the theme's chart
+      // palette at render, so the series are the document's whenever the
+      // theme has a palette to give; only a theme with none leaves them to
+      // the export server's default.
+      seriesColorsStated: shape.seriesColorsStated || paletteTokens.length > 0,
       seriesColorsPath: `${path3}/props/options`,
       ...shape.valueAxisMin !== void 0 && {
         valueAxisMin: shape.valueAxisMin
@@ -12829,6 +12938,11 @@ function prepareDocxQualityDocument(document, options = {}) {
       ...fact.relatedPaths && { relatedPaths: fact.relatedPaths }
     };
   };
+  const annotatedInvocations = new Set(
+    blockSlotRoles2(themed.document, expanded.blocks).filter(
+      (slot) => (slot.role === "takeaway" || slot.role === "source") && typeof slot.value === "string" && slot.value.trim() !== ""
+    ).map((slot) => slot.invocation)
+  );
   for (const budget of blockSlotBudgets(themed.document, expanded.blocks)) {
     addFact({
       id: `docx:block-slot:${budget.path}`,
@@ -12836,6 +12950,38 @@ function prepareDocxQualityDocument(document, options = {}) {
       ...budget
     });
   }
+  for (const role of blockSlotRoles2(themed.document, expanded.blocks)) {
+    addFact({
+      id: `docx:chrome-slot:${role.path}`,
+      kind: "docx/chrome-slot",
+      path: role.path,
+      relatedPaths: [role.invocation],
+      block: role.block,
+      slot: role.slot,
+      role: role.role,
+      present: slotIsFilled(role.value),
+      invocation: role.invocation
+    });
+  }
+  const topLevel = Array.isArray(context.document.children) ? context.document.children : [];
+  let inherited = {};
+  topLevel.forEach((node, index) => {
+    if (node?.name !== "section") return;
+    const props = asRecord(node.props) ?? {};
+    const part = (kind) => props[kind] === "linkToPrevious" ? inherited[kind] : props[kind];
+    const header = part("header");
+    const footer = part("footer");
+    inherited = { header, footer };
+    addFact({
+      id: `docx:section-chrome:${index}`,
+      kind: "docx/section-chrome",
+      path: `/children/${index}`,
+      index,
+      header: partPresent(header),
+      footer: partPresent(footer),
+      pageNumber: hasPageField(header) || hasPageField(footer)
+    });
+  });
   const paletteHexes = {};
   const visualColors = designColors2(
     resolved.theme.colors,
@@ -12940,7 +13086,27 @@ function prepareDocxQualityDocument(document, options = {}) {
     }
     if (node.name === "chart" || node.name === "highcharts") {
       const fact = chartFact(node, props, path3, paletteTokens);
-      if (fact) addFact(fact);
+      if (fact) {
+        const authored = authoredPath(path3);
+        const invocation = expanded.blocks.filter(
+          (pointer) => authored === pointer || authored.startsWith(`${pointer}/`)
+        ).sort((a, b) => b.length - a.length)[0];
+        const annotated = invocation !== void 0 && annotatedInvocations.has(invocation);
+        addFact({
+          ...fact,
+          generated: !["chart", "highcharts"].includes(
+            String(asRecord(nodeAtPointer(themed.document, authored))?.name)
+          ),
+          seriesColorsPath: authoredPath(fact.seriesColorsPath),
+          ...fact.annotation && {
+            annotation: {
+              ...fact.annotation,
+              path: authoredPath(fact.annotation.path),
+              stated: fact.annotation.stated || annotated
+            }
+          }
+        });
+      }
     }
     if (node.name === "paragraph" || node.name === "text-box") {
       const floating = asRecord(props.floating);
@@ -13010,6 +13176,17 @@ function prepareDocxQualityDocument(document, options = {}) {
     }
   };
 }
+function slotIsFilled(value) {
+  if (typeof value === "string") return value.trim() !== "";
+  return value !== void 0 && value !== null && value !== false && (!Array.isArray(value) || value.length > 0);
+}
+function partPresent(part) {
+  return Array.isArray(part) && part.length > 0;
+}
+var PAGE_FIELD = /\{(PAGE|PAGE_NUMBER|TOTAL_PAGES|NUMPAGES)\}/;
+function hasPageField(part) {
+  return Array.isArray(part) && PAGE_FIELD.test(JSON.stringify(part));
+}
 
 // src/core/generateFromIr.ts
 var UncompiledComponentError = class extends Error {
@@ -13062,7 +13239,8 @@ async function compileDocumentScoped(document, options, warnings) {
     ...options.services ? { services: options.services } : {},
     ...options.baseDir !== void 0 ? { baseDir: options.baseDir } : {},
     ...visualFonts.length > 0 ? { visualFonts } : {},
-    ...chartFonts.length > 0 ? { chartFonts } : {}
+    ...chartFonts.length > 0 ? { chartFonts } : {},
+    warnings
   });
   const resolved = desugared === context.document ? prepared.model.document : resolveDocumentTree(desugared, context.theme);
   const structure = await processResolvedDocument(