@json-to-office/core-docx 3.1.0 → 3.2.0

package/dist/blocks/document.d.ts

@@ -1,13 +1,28 @@
 import { JsonBlockEvaluator, toAuthoredBlockPointer, type BlockEvaluatorOptions } from '@json-to-office/shared';
-export { blockSlotBudgets } from '@json-to-office/shared';
+export { blockSlotBudgets, blockSlotRoles } from '@json-to-office/shared';
 export type { BlockSlotBudget, BlockSourceMap, ExpandedBlocks, } from '@json-to-office/shared';
 import type { ExpandedBlocks } from '@json-to-office/shared';
 import type { ThemeConfig } from '../styles';
 type Rec = Record<string, unknown>;
 export declare const toAuthoredPointer: typeof toAuthoredBlockPointer;
+/** One source line the document cites, and the slot it was written in. */
+export interface DocumentSourceLine {
+    text: string;
+    path: string;
+}
+/**
+ * Every `source`-role slot value in document order, once per distinct text —
+ * what a "Notes and sources" block lists. Read from the authored invocations
+ * and their definitions; a block nested inside another's body is not in the
+ * authored document and so is not counted twice. One walk per expansion:
+ * callers compute it once and hand it to every context they build.
+ */
+export declare function documentSourceLines(document: unknown): DocumentSourceLine[];
 /** General document state and page geometry. No report design is registered here. */
-export declare function docxBlockContext(document: unknown, theme: ThemeConfig, path?: string): Rec;
-export declare function createDocxBlockEvaluator(document: unknown, theme: ThemeConfig, extra?: Partial<BlockEvaluatorOptions>): JsonBlockEvaluator;
+export declare function docxBlockContext(document: unknown, theme: ThemeConfig, path: string, sources: readonly DocumentSourceLine[]): Rec;
+/** Where each context value was authored, for findings that land on it. */
+export declare function docxBlockContextSources(sources: readonly DocumentSourceLine[]): Record<string, string>;
+export declare function createDocxBlockEvaluator(document: unknown, theme: ThemeConfig, extra?: Partial<BlockEvaluatorOptions>, sources?: readonly DocumentSourceLine[]): JsonBlockEvaluator;
 export declare function expandBlocks<T>(document: T, theme: ThemeConfig): ExpandedBlocks<T>;
 /** The plugin host supplies registered code; JSON itself never loads code. */
 export declare function expandBlocksWithPlugins<T>(document: T, theme: ThemeConfig, plugins: ReadonlySet<string>, render: (component: Rec, path: string) => Promise<unknown[]>, preserve?: ReadonlySet<string>): Promise<ExpandedBlocks<T> & {

package/dist/blocks/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/blocks/document.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAMlB,sBAAsB,EAEtB,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAO7C,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnC,eAAO,MAAM,iBAAiB,+BAAyB,CAAC;AAExD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,WAAW,EAClB,IAAI,SAAK,GACR,GAAG,CAsCL;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,WAAW,EAClB,KAAK,GAAE,OAAO,CAAC,qBAAqB,CAAM,GACzC,kBAAkB,CAWpB;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,WAAW,GACjB,cAAc,CAAC,CAAC,CAAC,CAOnB;AA6ID,8EAA8E;AAC9E,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,EAC5D,QAAQ,GAAE,WAAW,CAAC,MAAM,CAAa,GACxC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,CAAC,CAwC/C"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/blocks/document.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAMlB,sBAAsB,EAEtB,KAAK,qBAAqB,EAG3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAO7C,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnC,eAAO,MAAM,iBAAiB,+BAAyB,CAAC;AAExD,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,kBAAkB,EAAE,CA0B3E;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,GAAG,CAuCL;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,WAAW,EAClB,KAAK,GAAE,OAAO,CAAC,qBAAqB,CAAM,EAC1C,OAAO,GAAE,SAAS,kBAAkB,EAAkC,GACrE,kBAAkB,CAWpB;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,WAAW,GACjB,cAAc,CAAC,CAAC,CAAC,CAkBnB;AA8ID,8EAA8E;AAC9E,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,EAC5D,QAAQ,GAAE,WAAW,CAAC,MAAM,CAAa,GACxC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,CAAC,CA+C/C"}

package/dist/components/highcharts.d.ts

@@ -8,6 +8,7 @@
  */
 import { ThemeConfig } from '../styles';
 import type { HighchartsProps } from '@json-to-office/shared-docx';
+import type { GenerationWarning } from '@json-to-office/shared';
 import { type HighchartsServiceConfig, type RasterizeFontFace } from '@json-to-office/shared';
 export type { HighchartsProps } from '@json-to-office/shared-docx';
 /**
@@ -18,6 +19,14 @@ export interface ChartGenerationResult {
     width: number;
     height: number;
 }
+/**
+ * Generate chart using Highcharts Export Server
+ */
+/**
+ * Refuse a public export server unless the caller opted in, and say so when
+ * it did: where the request goes is part of the document's confidentiality.
+ */
+export declare function assertExportServerAllowed(serverUrl: string, servicesConfig: HighchartsServiceConfig | undefined, warnings: GenerationWarning[] | undefined): void;
 /**
  * Map a chart's props to the `image` props it desugars to.
  *
@@ -27,5 +36,5 @@ export interface ChartGenerationResult {
  * rather than merging with it — stating one and inheriting the other would
  * distort the chart.
  */
-export declare function renderChartToImageProps(props: HighchartsProps, theme: ThemeConfig, servicesConfig?: HighchartsServiceConfig, chartFonts?: readonly RasterizeFontFace[]): Promise<Record<string, unknown>>;
+export declare function renderChartToImageProps(props: HighchartsProps, theme: ThemeConfig, servicesConfig?: HighchartsServiceConfig, chartFonts?: readonly RasterizeFontFace[], warnings?: GenerationWarning[]): Promise<Record<string, unknown>>;
 //# sourceMappingURL=highcharts.d.ts.map

package/dist/components/highcharts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"highcharts.d.ts","sourceRoot":"","sources":["../../src/components/highcharts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAOxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAOL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AA8ND;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,WAAW,EAClB,cAAc,CAAC,EAAE,uBAAuB,EACxC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,GACxC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiBlC"}
+{"version":3,"file":"highcharts.d.ts","sourceRoot":"","sources":["../../src/components/highcharts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAOxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EASL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;GAEG;AACH;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,uBAAuB,GAAG,SAAS,EACnD,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACxC,IAAI,CASN;AA2ND;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,WAAW,EAClB,cAAc,CAAC,EAAE,uBAAuB,EACxC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,EACzC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiBlC"}

package/dist/core/desugarExternals.d.ts

@@ -12,7 +12,7 @@
  * fail, block on a network call or depend on a machine's LibreOffice happens in
  * this pass; what comes out is a document that builds anywhere.
  */
-import { type RasterizeFontFace, type ServicesConfig } from '@json-to-office/shared';
+import { type RasterizeFontFace, type ServicesConfig, type GenerationWarning } from '@json-to-office/shared';
 import type { ThemeConfig } from '../styles';
 export interface DesugarExternalsOptions {
     theme: ThemeConfig;
@@ -23,6 +23,8 @@ export interface DesugarExternalsOptions {
     visualFonts?: readonly RasterizeFontFace[];
     /** Font faces a chart's export server is handed as inline `@font-face`. */
     chartFonts?: readonly RasterizeFontFace[];
+    /** Where a chart posted to a remote export server is reported. */
+    warnings?: GenerationWarning[];
 }
 /**
  * Replace every `visual` and `highcharts` in `document` with its image.

package/dist/core/desugarExternals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"desugarExternals.d.ts","sourceRoot":"","sources":["../../src/core/desugarExternals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAY7C,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC3C,2EAA2E;IAC3E,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,CAAC,CAAC,CA6CZ"}
+{"version":3,"file":"desugarExternals.d.ts","sourceRoot":"","sources":["../../src/core/desugarExternals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAY7C,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC3C,2EAA2E;IAC3E,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,CAAC,CAAC,CA8CZ"}

package/dist/core/generateFromIr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateFromIr.d.ts","sourceRoot":"","sources":["../../src/core/generateFromIr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAKlE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,IAAI,0BAA0B;IAC9C,SAAgB,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;gBAEhD,UAAU,EAAE,SAAS,oBAAoB,EAAE;CAiBxD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC;IACzD,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,EACrC,SAAS,CAAC,EAAE,iBAAiB,EAAE,GAC9B,OAAO,CAAC,YAAY,CAAC,CAOvB;AAyGD,0EAA0E;AAC1E,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}
+{"version":3,"file":"generateFromIr.d.ts","sourceRoot":"","sources":["../../src/core/generateFromIr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAKlE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,IAAI,0BAA0B;IAC9C,SAAgB,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;gBAEhD,UAAU,EAAE,SAAS,oBAAoB,EAAE;CAiBxD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC;IACzD,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,EACrC,SAAS,CAAC,EAAE,iBAAiB,EAAE,GAC9B,OAAO,CAAC,YAAY,CAAC,CAOvB;AA0GD,0EAA0E;AAC1E,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}

package/dist/index.js

@@ -2376,7 +2376,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: [
@@ -2395,6 +2395,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")
   ];
 }
@@ -2505,13 +2508,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;
       }
@@ -2885,7 +2893,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";
@@ -2898,6 +2906,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,
@@ -5521,13 +5530,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."
@@ -5538,6 +5559,7 @@ async function generateChart(config, servicesConfig) {
     servicesConfig?.serverUrl,
     DEFAULT_EXPORT_SERVER_URL
   );
+  assertExportServerAllowed(serverUrl, servicesConfig, warnings);
   const requestBody = {
     infile: config.options,
     type: "png",
@@ -5650,13 +5672,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,
@@ -5696,7 +5718,8 @@ async function desugarExternals(document, options) {
           node.props,
           options.theme,
           options.services?.highcharts,
-          options.chartFonts
+          options.chartFonts,
+          options.warnings
         )
       });
     }
@@ -8247,6 +8270,9 @@ function parsePlaceholders(normalized, parseOptions) {
         out.push({
           kind: "field",
           instruction: resolved.instruction,
+          ...resolved.cachedText !== void 0 && {
+            cachedText: resolved.cachedText
+          },
           ...formatting ? { formatting } : {}
         });
       }
@@ -8473,6 +8499,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)
@@ -9868,7 +9895,20 @@ function compileRuns(props, text, ctx, path4, 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, path4) {
   return (id, format2, token) => resolveCrossReference(id, format2, token, ctx, path4);
@@ -12094,12 +12134,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 } from "@json-to-office/shared-docx";
 var toAuthoredPointer = toAuthoredBlockPointer;
-function docxBlockContext(document, theme, path4 = "") {
+function documentSourceLines(document) {
+  if (!isBlockRecord(document)) return [];
+  const invocations = [];
+  const walk2 = (value, path4) => {
+    if (Array.isArray(value)) {
+      value.forEach((item, index) => walk2(item, `${path4}/${index}`));
+      return;
+    }
+    if (!isBlockRecord(value) || value.enabled === false) return;
+    if (value.name === "block") invocations.push(path4);
+    for (const [key, item] of Object.entries(value)) {
+      if (path4 === "/props" && key === "blocks") continue;
+      walk2(item, `${path4}/${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, path4, sources) {
   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 : {};
@@ -12119,26 +12188,46 @@ function docxBlockContext(document, theme, path4 = "") {
   return {
     document: blockValueAt(document, "/props/metadata") ?? {},
     page: { width, height },
-    section: {}
+    section: {},
+    sources: sources.map((line) => line.text)
   };
 }
-function createDocxBlockEvaluator(document, theme, extra = {}) {
+function docxBlockContextSources(sources) {
+  return {
+    "/document": "/props/metadata",
+    ...Object.fromEntries(
+      sources.map((line, index) => [`/sources/${index}`, line.path])
+    )
+  };
+}
+function createDocxBlockEvaluator(document, theme, extra = {}, sources = documentSourceLines(document)) {
   return new JsonBlockEvaluator(readBlockDefinitions(document), {
     format: "docx",
     theme,
-    contextAt: (path4) => docxBlockContext(document, theme, path4),
-    contextSources: { "/document": "/props/metadata" },
+    contextAt: (path4) => docxBlockContext(document, theme, path4, 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) {
@@ -12159,7 +12248,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) => {
@@ -12197,11 +12286,11 @@ function finishDocxBlocks(expanded, document, theme, evaluator, effects, validat
         const environment = {
           ...chrome.environment,
           context: {
-            ...docxBlockContext(document, theme, path4),
+            ...docxBlockContext(document, theme, path4, sources),
             section: { tracker }
           },
           contextSources: {
-            "/document": "/props/metadata",
+            ...docxBlockContextSources(sources),
             "/section/tracker": trackerSource
           }
         };
@@ -12245,10 +12334,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,
@@ -12261,6 +12356,7 @@ async function expandBlocksWithPlugins(document, theme, plugins, render, preserv
     theme,
     evaluator,
     effects,
+    sources,
     false
   );
   const second = await walk2(finished.document);
@@ -12360,7 +12456,8 @@ function chartFact(node, props, path4, paletteTokens) {
     kind: "docx/chart",
     path: path4,
     componentName: typeof node.name === "string" ? node.name : "",
-    paletteTokens
+    paletteTokens,
+    generated: false
   };
   if (node.name === "highcharts") {
     const shape = normalizeHighchartsChart(props.options);
@@ -12371,7 +12468,11 @@ function chartFact(node, props, path4, 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: `${path4}/props/options`,
       ...shape.valueAxisMin !== void 0 && {
         valueAxisMin: shape.valueAxisMin
@@ -12743,6 +12844,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}`,
@@ -12854,7 +12960,27 @@ function prepareDocxQualityDocument(document, options = {}) {
     }
     if (node.name === "chart" || node.name === "highcharts") {
       const fact = chartFact(node, props, path4, paletteTokens);
-      if (fact) addFact(fact);
+      if (fact) {
+        const authored = authoredPath(path4);
+        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);
@@ -12976,7 +13102,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(
@@ -13909,7 +14036,7 @@ var docxChartRule = {
   }
 };
 function seriesColorFix(fact) {
-  if (fact.componentName !== "chart") return void 0;
+  if (fact.componentName !== "chart" || fact.generated) return void 0;
   if (fact.seriesCount < 1 || fact.paletteTokens.length === 0) return void 0;
   const tokens = Array.from(
     { length: fact.seriesCount },