@json-to-office/core-docx 0.38.0 → 1.0.0

package/dist/core/index.d.ts

@@ -2,13 +2,12 @@
  * Core module exports
  * Functional document generation API
  */
-export { generateDocument, generateFromConfig, saveDocument, generateAndSave, DocumentGenerator, } from './generator';
+export { generateBufferFromJson, generateBufferWithWarnings, generateBufferFromConfig, generateBufferFromFile, generateAndSaveFromJson, generateAndSaveFromFile, DocumentGenerator, } from './generator';
 export { processDocument, createDocumentMetadata, extractSections, flattenComponents, createRenderContext, } from './structure';
 export { applyLayout, analyzeLayoutGroups, determineComponentLayout, processLayoutComponents, getColumnSettings, createSectionProperties, calculateColumnDistribution, } from './layout';
-export { createText, createHeading, createTitleContent, createImage, createStatistic, createTable, createHeaderElement, createFooterElement, createHeaderFooterTable, } from './content';
-export { renderDocument, renderSection, renderComponent } from './render';
-export { renderComponentWithCache, initializeComponentCache, getComponentCache, clearComponentCache, getComponentCacheStats, warmComponentCache, } from './cached-render';
+export { compileDocumentToIr, generateBufferViaIr } from './generateFromIr';
+export { desugarExternals } from './desugarExternals';
 export type { ProcessedDocument, DocumentMetadata, ProcessedSection, } from './structure';
 export type { LayoutPlan, SectionLayout, LayoutGroup } from './layout';
-export type { TextOptions, ImageOptions, TableOptions, StatisticData, } from './content';
+export type { ImageOptions } from '../components/visual';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/layout.d.ts

@@ -2,7 +2,6 @@
  * Layout Functions
  * Handle all layout concerns including columns, breaks, and section properties
  */
-import { SectionType, Column as DocxColumn } from 'docx';
 import { ComponentDefinition, ColumnSettings } from '../types';
 import { ThemeConfig } from '../styles';
 import { ProcessedSection } from './structure';
@@ -25,12 +24,25 @@ export interface WordSectionProperties {
             right: number;
             bottom: number;
             left: number;
+            header?: number;
+            footer?: number;
+            gutter?: number;
         };
     };
     column: ColumnSettings & {
-        children?: DocxColumn[];
+        /**
+         * The same explicit columns as `children`, in twips.
+         *
+         * `children` holds docx `Column` instances, which keep their width and
+         * space private, so anything downstream of a renderer boundary cannot read
+         * them back. This is the plain-numbers copy the DocxIR compiler reads.
+         */
+        widths?: Array<{
+            width: number;
+            space?: number;
+        }>;
     };
-    type?: (typeof SectionType)[keyof typeof SectionType];
+    type?: 'continuous' | 'nextColumn' | 'nextPage' | 'evenPage' | 'oddPage';
 }
 export interface SectionLayout {
     properties: WordSectionProperties;

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

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/core/layout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/core/layout.ts"],"names":[],"mappings":"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"}

package/dist/core/markdownList.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Markdown list syntax inside a paragraph's text.
+ *
+ * A paragraph whose whole text is `- one\n- two` is a list, not prose, and has
+ * always rendered as one. Detecting that is a pure reading of the text with no
+ * renderer in it, so both the pre-IR writer and the DocxIR compiler read it
+ * here rather than each deciding for itself what counts as a list.
+ */
+export interface MarkdownList {
+    type: 'unordered' | 'ordered';
+    items: {
+        text: string;
+        level: number;
+    }[];
+}
+/**
+ * Parse markdown list syntax from paragraph text
+ * Returns null if no list detected, or { type, items } if list found
+ */
+export declare function parseMarkdownList(text: string): MarkdownList | null;
+//# sourceMappingURL=markdownList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdownList.d.ts","sourceRoot":"","sources":["../../src/core/markdownList.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA2CnE"}

package/dist/core/prerasterizeVisuals.d.ts

@@ -30,7 +30,7 @@ export interface PrerasterizeOptions {
      */
     fonts?: readonly RasterizeFontFace[];
 }
-/** Cumulative pre-pass counters for cache observability (#156). */
+/** Cumulative pre-pass counters for visual-work observability (#156). */
 export interface VisualPrepassStats {
     /** Documents that entered the pre-pass with at least one visual. */
     documents: number;
@@ -41,8 +41,7 @@ export interface VisualPrepassStats {
 }
 /**
  * Get cumulative per-document pre-pass counters. `collected - unique` is the
- * work the dedupe saved — the `visual` cache benefit the component cache
- * stats can never show, since `visual` bypasses that cache by design.
+ * work saved by batch-internal deduplication.
  */
 export declare function getVisualPrepassStats(): VisualPrepassStats;
 export declare function resetVisualPrepassStats(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"prerasterizeVisuals.d.ts","sourceRoot":"","sources":["../../src/core/prerasterizeVisuals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAIL,KAAK,iBAAiB,EAEtB,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAkB/D,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACtC;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,CA4B/D;AA6ED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC,CAiOrD"}
+{"version":3,"file":"prerasterizeVisuals.d.ts","sourceRoot":"","sources":["../../src/core/prerasterizeVisuals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAIL,KAAK,iBAAiB,EAEtB,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAkB/D,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACtC;AAED,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,CA4B/D;AA6ED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC,CAiOrD"}

package/dist/core/sectionBookmarks.d.ts

@@ -1,21 +1,16 @@
 /**
- * Section bookmark ids — the single producer.
+ * The bookmark a section is addressable by.
  *
- * `context.section.sectionBookmarkId` is what a section-scoped TOC resolves its
- * `\b` switch against. It used to have two independent producers writing the
- * same field from two different traversal orders: a loop-carried ordinal fold
- * over `layout.sections[]` in `core/render.ts`, and a DFS counter kept on
- * `context.custom.sectionBookmarks` in `components/section.ts`, whose value
- * shadowed the first for everything below a nested section. Consumers read
- * whichever won.
+ * `w:bookmarkStart/@w:name` is what a section-scoped table of contents resolves
+ * its `\b` switch against, so the name has to be derivable identically by
+ * whoever writes the bookmark and whoever points at it. It is derived from the
+ * section's ordinal, and both sides call this.
  *
- * Both call sites now allocate here. Ids stay in two disjoint namespaces
- * (`_Section_*` for layout sections, `_NestedSection_*` for section components
- * rendered inside one) with disjoint numeric link-id ranges, but there is one
- * place that decides both, and one map that remembers what a given section
- * resolved to.
+ * This used to be a registry with per-render state, because the pre-IR writer
+ * had two producers allocating from two different traversal orders. The
+ * compiler has one, so a pure function is enough.
  */
-/** A resolved OOXML bookmark: its name plus the numeric id start/end share. */
+/** A resolved OOXML bookmark: its name plus the numeric id its ends share. */
 export interface SectionBookmark {
     /** `w:bookmarkStart/@w:name`, and the TOC `\b` switch argument. */
     id: string;
@@ -23,31 +18,11 @@ export interface SectionBookmark {
     linkId: number;
 }
 /**
- * Per-render allocation state. Async-local so concurrent document renders each
- * get their own counters, matching the bookmark/revision/numbering registries.
+ * The bookmark for a layout section, derived from its ordinal.
+ *
+ * Every layout chunk of one user-defined section shares an ordinal (see
+ * `computeSectionOrdinals`), so they all resolve to the same bookmark — which
+ * is the point: the start lands in the first chunk and the end in the last.
  */
-declare class SectionBookmarkRegistry {
-    private fallback;
-    private readonly scopes;
-    private get state();
-    /** Run work with an isolated registry that follows its async call chain. */
-    runScoped<T>(callback: () => T): T;
-    /**
-     * The bookmark for a layout section, derived from its ordinal.
-     *
-     * Every layout chunk of one user-defined section shares an ordinal (see
-     * `computeSectionOrdinals`), so they all resolve to the same bookmark — which
-     * is the point: the start lands in the first chunk and the end in the last.
-     */
-    forLayoutSection(ordinal: number): SectionBookmark;
-    /**
-     * The bookmark for a `section` component, allocated on first sight and
-     * remembered so re-resolving the same component never allocates twice.
-     */
-    forSectionComponent(component: object): SectionBookmark;
-    /** Test-only: reset the unscoped fallback counters. */
-    clear(): void;
-}
-export declare const globalSectionBookmarkRegistry: SectionBookmarkRegistry;
-export {};
+export declare function sectionBookmark(ordinal: number): SectionBookmark;
 //# sourceMappingURL=sectionBookmarks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sectionBookmarks.d.ts","sourceRoot":"","sources":["../../src/core/sectionBookmarks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;CAChB;AAmBD;;;GAGG;AACH,cAAM,uBAAuB;IAC3B,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IAExE,OAAO,KAAK,KAAK,GAEhB;IAED,4EAA4E;IAC5E,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAIlC;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAIlD;;;OAGG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe;IAcvD,uDAAuD;IACvD,KAAK,IAAI,IAAI;CAKd;AAED,eAAO,MAAM,6BAA6B,yBAAgC,CAAC"}
+{"version":3,"file":"sectionBookmarks.d.ts","sourceRoot":"","sources":["../../src/core/sectionBookmarks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAEhE"}

package/dist/core/tableModel.d.ts

@@ -0,0 +1,188 @@
+/**
+ * The `table` component, resolved down to plain numbers and colours.
+ *
+ * A table's authoring surface is layered: a value may come from the cell, the
+ * column, the table's header defaults, the table's cell defaults, the table's
+ * own border settings, or the built-in defaults — and borders, sizes and
+ * padding each cascade *per side*, so a cell can take its left border from one
+ * layer and its top from another. Getting that cascade right is the whole job,
+ * and it has nothing to do with any renderer.
+ *
+ * So it lives here, once. Both the pre-IR writer (`createTable`) and the DocxIR
+ * compiler resolve a table through this module and then only translate the
+ * result into their own vocabulary. Two copies of these rules would drift, and
+ * the drift would be invisible until a border quietly changed colour.
+ *
+ * Everything returned is resolved: colours are 6-digit hex without `#`, border
+ * sizes are points, padding and heights are points. Nothing here loads content
+ * or touches the filesystem.
+ */
+import type { ComponentDefinition } from '../types';
+import type { ThemeConfig } from '../styles';
+export type TableCellContent = string | ComponentDefinition;
+export type TableFontConfig = {
+    family?: string;
+    size?: number;
+    bold?: boolean;
+    fontWeight?: number;
+    italic?: boolean;
+    underline?: boolean;
+};
+export type BorderColor = string | {
+    bottom?: string;
+    top?: string;
+    right?: string;
+    left?: string;
+};
+export type BorderSize = number | {
+    bottom?: number;
+    top?: number;
+    right?: number;
+    left?: number;
+};
+export type Padding = number | {
+    bottom?: number;
+    top?: number;
+    right?: number;
+    left?: number;
+};
+export type CellDefaults = {
+    color?: string;
+    backgroundColor?: string;
+    horizontalAlignment?: 'left' | 'center' | 'right' | 'justify';
+    verticalAlignment?: 'top' | 'middle' | 'bottom';
+    font?: TableFontConfig;
+    borderColor?: BorderColor;
+    borderSize?: BorderSize;
+    padding?: Padding;
+    height?: number;
+};
+export type HideBorders = boolean | {
+    top?: boolean;
+    right?: boolean;
+    bottom?: boolean;
+    left?: boolean;
+    insideHorizontal?: boolean;
+    insideVertical?: boolean;
+};
+/** A cell as written, plus the annotations that ride along with it. */
+export type TableCellSource<TComment, TRevision> = CellDefaults & {
+    comment?: TComment;
+    revision?: TRevision;
+    content?: TableCellContent;
+};
+export type TableColumnSource<TComment, TRevision> = {
+    /** Width in points (number) or as a percentage string, e.g. `"40%"`. */
+    width?: number | string;
+    cellDefaults?: CellDefaults;
+    header?: TableCellSource<TComment, TRevision>;
+    cells?: TableCellSource<TComment, TRevision>[];
+};
+export type TableSource<TComment, TRevision, TRowRevision> = {
+    borderColor?: BorderColor;
+    borderSize?: BorderSize;
+    hideBorders?: HideBorders;
+    cellDefaults?: CellDefaults;
+    headerCellDefaults?: CellDefaults;
+    width?: number;
+    columns: TableColumnSource<TComment, TRevision>[];
+    /** Row-parallel properties, indexed like `columns[].cells`. */
+    rows?: {
+        revision?: TRowRevision;
+        cantSplit?: boolean;
+        tableHeader?: boolean;
+    }[];
+    keepInOnePage?: boolean;
+    keepNext?: boolean;
+    repeatHeaderOnPageBreak?: boolean;
+};
+export interface ResolvedSides<T> {
+    top: T;
+    right: T;
+    bottom: T;
+    left: T;
+}
+/** One side of a cell's border, after the cascade and the hide rules. */
+export interface ResolvedBorder {
+    /** Points. Zero means no border. */
+    size: number;
+    /** 6-digit hex, no `#`. */
+    color: string;
+    /** True when `hideBorders` suppressed this side for this cell. */
+    hidden: boolean;
+}
+export interface ResolvedCell<TComment, TRevision> {
+    content?: TableCellContent;
+    comment?: TComment;
+    revision?: TRevision;
+    /** Text colour: hex, `auto`, or undefined to inherit the table style. */
+    color?: string;
+    /** Fill: hex, `auto`, or the `transparent` sentinel meaning "no shading". */
+    backgroundColor?: string;
+    horizontalAlignment: 'left' | 'center' | 'right' | 'justify';
+    verticalAlignment: 'top' | 'middle' | 'bottom';
+    font: TableFontConfig;
+    borders: ResolvedSides<ResolvedBorder>;
+    /** Points, per side. Absent when no layer asked for padding. */
+    padding?: ResolvedSides<number>;
+    /**
+     * A cell the source never wrote, kept only so the grid stays rectangular.
+     *
+     * It draws its borders and nothing else — no fill, no padding, no content —
+     * which is what tells a renderer to leave it empty rather than style it.
+     */
+    missing?: boolean;
+}
+export interface ResolvedRow<TComment, TRevision, TRowRevision> {
+    cells: ResolvedCell<TComment, TRevision>[];
+    /** Points; the tallest height any cell in the row asked for. */
+    height?: number;
+    isHeader: boolean;
+    /** Set only when the source stated it. */
+    tableHeader?: boolean;
+    cantSplit?: boolean;
+    revision?: TRowRevision;
+    /** Every cell paragraph in the row keeps with the next one. */
+    keepNext: boolean;
+}
+/**
+ * The table's column grid.
+ *
+ * `twips` is the real OOXML unit. `percent` is what the pipeline has always
+ * written when no column states a width — the grid then carries a percentage
+ * per column rather than a width, which Word tolerates because the table
+ * itself is sized in percent.
+ */
+export interface ResolvedColumnGrid {
+    unit: 'twips' | 'percent';
+    values: number[];
+}
+export interface ResolvedTable<TComment, TRevision, TRowRevision> {
+    columnGrid: ResolvedColumnGrid;
+    width: {
+        size: number;
+        unit: 'twips' | 'percent';
+    };
+    header: ResolvedRow<TComment, TRevision, TRowRevision>;
+    rows: ResolvedRow<TComment, TRevision, TRowRevision>[];
+    /** Headers repeat across page breaks unless the source disabled it. */
+    repeatHeader: boolean;
+    /** Emitted when the column widths cannot fit the page. */
+    overflow?: {
+        totalTwips: number;
+        availableTwips: number;
+    };
+}
+export interface TableModelOptions {
+    /** Reports a value that could not be used. Deduplicated by the caller. */
+    onWarning?: (code: string, message: string) => void;
+}
+/**
+ * Resolve a whole table.
+ *
+ * The generic parameters keep the annotation types (`comment`, `revision`) out
+ * of this module: it carries them through untouched, so neither the pre-IR
+ * writer's docx-shaped types nor the IR's own have to be known here.
+ */
+export declare function resolveTableModel<TComment, TRevision, TRowRevision>(source: TableSource<TComment, TRevision, TRowRevision>, theme: ThemeConfig, themeName: string, options?: TableModelOptions): ResolvedTable<TComment, TRevision, TRowRevision>;
+//# sourceMappingURL=tableModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tableModel.d.ts","sourceRoot":"","sources":["../../src/core/tableModel.ts"],"names":[],"mappings":"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"}

package/dist/core/tocField.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The `toc` component, resolved into the switches a Word field needs.
+ *
+ * A table of contents is a field: Word repopulates it on open from the outline
+ * and the switches the field carries. Deciding what those switches say — which
+ * outline levels, which extra styles, which region, which levels keep their
+ * page numbers — is a reading of the authoring props with no renderer in it.
+ *
+ * The cached entries are the other half. Word refreshes the field, but headless
+ * LibreOffice does not, so without them a PDF export shows only the title. What
+ * is cached must be exactly what Word would collect, or a reader pressing F9
+ * sees the table change under them — the disagreement caching exists to avoid.
+ */
+import type { ThemeConfig } from '../styles';
+import type { TocHeadingEntry } from './collectTocHeadings';
+export interface TocFieldEntry {
+    text: string;
+    level: number;
+}
+export interface ResolvedTocField {
+    /** `\o` — heading outline levels to include, inclusive. */
+    headingRange: {
+        from: number;
+        to: number;
+    };
+    /** `\t` — extra paragraph styles, by Word display name, with their level. */
+    styleLevels: Array<{
+        styleName: string;
+        level: number;
+    }>;
+    /** `\b` — restrict to a bookmarked region. */
+    bookmarkScope?: string;
+    /** `\n` — level ranges whose entries omit a page number. */
+    omitPageNumbersForLevels: Array<{
+        from: number;
+        to: number;
+    }>;
+    /** What separates an entry's text from its page number. */
+    entrySeparator: string;
+    entries: TocFieldEntry[];
+    /** Things the field cannot express, to be reported by the caller. */
+    warnings: string[];
+}
+/**
+ * The Word display name a theme style key registers under: camelCase and
+ * kebab/snake separators become spaces (`calloutTitle` → `callout Title`).
+ * Mirrors the naming in `themeToDocxAdapter`.
+ */
+export declare function toStyleDisplayName(styleId: string): string;
+export interface TocFieldSource {
+    depth?: unknown;
+    pageNumbersDepth?: unknown;
+    includePageNumbers?: boolean;
+    numberingStyle?: string;
+    numberSeparator?: boolean;
+    scope?: 'auto' | 'document' | 'section';
+    styles?: Array<{
+        styleId: string;
+        level: number;
+    }>;
+    title?: string;
+}
+/** Resolve a `toc` component's props into field switches and cached entries. */
+export declare function resolveTocField(props: TocFieldSource, theme: ThemeConfig, context: {
+    /** The bookmark of the section this TOC sits in, if any. */
+    sectionBookmarkId?: string;
+    /** Every heading and mapped-style paragraph in the document, in order. */
+    collected?: readonly TocHeadingEntry[];
+}): ResolvedTocField;
+//# sourceMappingURL=tocField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tocField.d.ts","sourceRoot":"","sources":["../../src/core/tocField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,6EAA6E;IAC7E,WAAW,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,wBAAwB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM1D;AAwFD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE;IACP,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACxC,GACA,gBAAgB,CAgFlB"}

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 export declare function getCoreVersion(): string;
-export { generateDocument, generateFromConfig, generateDocumentFromJson, generateDocumentFromFile, generateBufferFromJson, generateBufferFromFile, generateAndSaveFromJson, generateAndSaveFromFile, validateJsonSchema, isReportComponentDefinition, saveDocument, generateAndSave, DocumentGenerator as CoreDocumentGenerator, } from './core/generator';
+export { generateBufferFromJson, generateBufferWithWarnings, generateBufferFromConfig, generateBufferFromFile, generateAndSaveFromJson, generateAndSaveFromFile, validateJsonSchema, isReportComponentDefinition, DocumentGenerator as CoreDocumentGenerator, type DocxGenerationResult, } from './core/generator';
+export type { DocxRendererId } from './renderers/types';
+export { DEFAULT_DOCX_RENDERER_ID } from './renderers/types';
+export { docxRendererIds, isDocxRendererId } from './renderers/registry';
+export { UncompiledComponentError } from './core/generateFromIr';
 export { flattenVisuals, type FlattenVisualsOptions, } from './core/flattenVisuals';
-export { MemoryCache, CacheKeyGenerator, DEFAULT_CACHE_CONFIG, getCacheConfigFromEnv, mergeConfigs, ComponentCacheAnalytics, type CacheConfiguration, type CachedComponent, type CacheStatistics, type CacheKeyOptions, type CacheEvents, type CacheAnalyticsReport, type ComponentPerformanceMetrics, type ComponentCacheTrends, type CacheOptimizationRecommendation, type TimeSeriesPoint, } from './cache/index';
-export { initializeComponentCache, getComponentCache, clearComponentCache, getComponentCacheStats, getComponentBypassStats, warmComponentCache, componentBypassReason, type ComponentBypassReason, type ComponentBypassStats, } from './core/cached-render';
 export { getVisualPrepassStats, resetVisualPrepassStats, type VisualPrepassStats, } from './core/prerasterizeVisuals';
 export { isReportComponent, isSectionComponent, isHeadingComponent, isParagraphComponent, isColumnsComponent, isImageComponent, isStatisticComponent, isTableComponent, isListComponent, isHighchartsComponent, isVisualComponent, } from './types/index';
-export type { ImageContent, StatisticContent, TableData, SectionProperties, ColumnSettings, PageSizeOptions, PageMarginOptions, PageNumberOptions, PageBorderOptions, RenderContext, } from './types/index';
+export type { ReportComponentDefinition, ReportComponentDefinitionFor, ImageContent, StatisticContent, TableData, SectionProperties, ColumnSettings, PageSizeOptions, PageMarginOptions, PageNumberOptions, PageBorderOptions, RenderContext, } from './types/index';
 export * from './utils/formatters';
-export { parseTextWithDecorators } from './utils/textParser';
 export { isNodeEnvironment, hasNodeBuiltins } from './utils/environment';
 export { generateWarningsDocument, formatWarningsText, } from './utils/warningsDocument';
 export { themes, minimalTheme, corporateTheme, modernTheme, } from './styles/index';
@@ -17,6 +18,6 @@ export { examples, getExample, getExampleNames, loadJsonExample, } from './templ
 export { runExample } from './utils/exampleRunner';
 import './components/index';
 export type { ChartGenerationResult, } from './components/highcharts';
-export { createComponent, createVersion, createDocumentGenerator, validateComponentProps, validateDocument, cleanComponentProps, ComponentValidationError, UnknownPreservedComponentError, generatePluginDocumentSchema, exportPluginSchema, generateComponentSchemas, mergeSchemas, type CustomComponent, type ComponentVersion, type ComponentVersionMap, type RenderFunction, type RenderContext as ComponentRenderContext, type DocumentGenerator, type DocumentGeneratorOptions, type GenerateOptions, type GenerateFileOptions, type GenerationResult, type BufferGenerationResult, type FileGenerationResult, type StandardDefinitionResult, type ValidationResult, type ValidationError, type ExtractCustomComponentType, type CustomComponentUnion, type ExtendedComponentDefinition, type ExtendedReportComponent, type InferCustomComponents, } from './plugin/index';
+export { createComponent, createVersion, createDocumentGenerator, validateComponentProps, validateDocument, cleanComponentProps, ComponentValidationError, UnknownPreservedComponentError, generatePluginDocumentSchema, exportPluginSchema, generateComponentSchemas, mergeSchemas, type CustomComponent, type ComponentVersion, type ComponentVersionMap, type RenderFunction, type RenderContext as ComponentRenderContext, type DocumentGenerator, type DocumentGeneratorOptions, type GenerateOptions, type GenerateFileOptions, type BufferGenerationResult, type FileGenerationResult, type StandardDefinitionResult, type ValidationResult, type ValidationError, type ExtractCustomComponentType, type CustomComponentUnion, type ExtendedComponentDefinition, type ExtendedReportComponent, type InferCustomComponents, } from './plugin/index';
 export type { PluginComponent, PluginRenderFunction, PluginValidationError, PluginValidationResult, } from './types/plugin';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}