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

package/dist/core/render.d.ts

@@ -1,48 +0,0 @@
-/**
- * Render Functions
- * Transform components and layout into Word document elements
- */
-import { Document, Paragraph, Table, TableOfContents, ISectionOptions } from 'docx';
-import { ComponentDefinition, RenderContext } from '../types';
-import { ThemeConfig } from '../styles';
-import { ProcessedDocument } from './structure';
-import { LayoutPlan, SectionLayout } from './layout';
-import { MemoryCache } from '../cache';
-import type { ServicesConfig, RasterizeFontFace } from '@json-to-office/shared';
-import type { GenerationWarning } from '@json-to-office/shared';
-interface RenderDocumentOptions {
-    cache?: MemoryCache;
-    bypassCache?: boolean;
-    services?: ServicesConfig;
-    /**
-     * Directory that relative asset paths (image `path` props) resolve
-     * against. Defaults to `process.cwd()` when absent (#142).
-     */
-    baseDir?: string;
-    /**
-     * Font faces (base64) shipped with every `visual` rasterization so the
-     * out-of-process LibreOffice renders the slide with the document's real
-     * fonts instead of a system fallback. Produced by the caller from
-     * `resolveDocumentFonts` via `toRasterizeFontFaces`.
-     */
-    visualFonts?: RasterizeFontFace[];
-    /**
-     * Collector for warnings raised while rendering, such as an inline SVG the
-     * rasterizer could not turn into a fallback. Absent → `console.warn`.
-     */
-    warnings?: GenerationWarning[];
-}
-/**
- * Render a complete document from structure and layout
- */
-export declare function renderDocument(structure: ProcessedDocument, layout: LayoutPlan, options?: RenderDocumentOptions): Promise<Document>;
-/**
- * Render a section with layout
- */
-export declare function renderSection(section: SectionLayout, theme: ThemeConfig, themeName: string, context: RenderContext, sectionOrdinal?: number, closeBookmark?: boolean, bypassCache?: boolean): Promise<ISectionOptions>;
-/**
- * Render a single component to Word elements
- */
-export declare function renderComponent(component: ComponentDefinition, theme: ThemeConfig, themeName: string, context: RenderContext): Promise<(Paragraph | Table | TableOfContents)[]>;
-export {};
-//# sourceMappingURL=render.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/core/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,KAAK,EACL,eAAe,EAEf,eAAe,EAKhB,MAAM,MAAM,CAAC;AAcd,OAAO,EACL,mBAAmB,EACnB,aAAa,EAed,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC,OAAO,EAEL,iBAAiB,EAElB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKrD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAgChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAOhE,UAAU,qBAAqB;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC;AA8DD;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CA8BnB;AAqZD;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,OAAO,EACvB,WAAW,UAAQ,GAClB,OAAO,CAAC,eAAe,CAAC,CAkH1B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAmClD"}

package/dist/styles/themeToDocxAdapter.d.ts

@@ -1,22 +0,0 @@
-import { IStylesOptions, IRunStylePropertiesOptions, IParagraphStylePropertiesOptions } from 'docx';
-import type { ThemeConfig } from './index';
-export interface WordStyleDefinition {
-    id: string;
-    name: string;
-    basedOn?: string;
-    next?: string;
-    quickFormat?: boolean;
-    run?: IRunStylePropertiesOptions;
-    paragraph?: IParagraphStylePropertiesOptions;
-}
-/**
- * Creates Word document styles from theme configuration
- * @param themeNameOrObject The theme to use for styling (name string or theme object)
- * @returns IStylesOptions for docx Document
- */
-export declare function createWordStyles(themeNameOrObject?: string | ThemeConfig, language?: string): IStylesOptions;
-/**
- * Maps section levels to Word style IDs
- */
-export declare function getStyleIdForLevel(level: number): string;
-//# sourceMappingURL=themeToDocxAdapter.d.ts.map

package/dist/styles/themeToDocxAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"themeToDocxAdapter.d.ts","sourceRoot":"","sources":["../../src/styles/themeToDocxAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,gCAAgC,EAGjC,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA2T3C,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,0BAA0B,CAAC;IACjC,SAAS,CAAC,EAAE,gCAAgC,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,iBAAiB,GAAE,MAAM,GAAG,WAAuB,EACnD,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CA2lBhB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUxD"}

package/dist/styles/utils/cellUtils.d.ts

@@ -1,55 +0,0 @@
-/**
- * Cell utilities for building table cell configurations
- */
-import { Paragraph, Table } from 'docx';
-import { ThemeConfig } from '../index';
-import { BordersConfig } from './borderUtils';
-/**
- * Padding configuration for all four sides
- */
-export interface PaddingConfig {
-    top?: number;
-    right?: number;
-    bottom?: number;
-    left?: number;
-}
-/**
- * Shading configuration
- */
-export interface ShadingConfig {
-    fill?: string;
-}
-/**
- * Complete cell style configuration
- */
-export interface CellStyleConfig {
-    padding?: PaddingConfig;
-    border?: BordersConfig;
-    shading?: ShadingConfig;
-}
-/**
- * Builds cell options object for TableCell constructor
- * Handles margins (padding), shading, and borders consistently
- * @param children - Child elements to include in the cell
- * @param styleCfg - Style configuration for the cell
- * @param theme - Theme configuration for color resolution
- * @returns Cell options object ready for TableCell constructor
- */
-export declare function buildCellOptions(children: (Paragraph | Table)[], styleCfg: CellStyleConfig | undefined, theme: ThemeConfig): {
-    children: (Paragraph | Table)[];
-    margins: {
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    };
-    shading?: {
-        fill: string;
-    };
-    borders?: Record<string, {
-        style: any;
-        size: number;
-        color: string;
-    }>;
-};
-//# sourceMappingURL=cellUtils.d.ts.map

package/dist/styles/utils/cellUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cellUtils.d.ts","sourceRoot":"","sources":["../../../src/styles/utils/cellUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAkB,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,EAC/B,QAAQ,EAAE,eAAe,GAAG,SAAS,EACrC,KAAK,EAAE,WAAW,GACjB;IACD,QAAQ,EAAE,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC;IAChC,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE,CA6BA"}

package/dist/utils/alignmentUtils.d.ts

@@ -1,10 +0,0 @@
-/**
- * Alignment Utilities
- * Shared utilities for converting alignment strings to docx AlignmentType
- */
-import { AlignmentType } from 'docx';
-/**
- * Convert alignment string to docx AlignmentType
- */
-export declare function getAlignment(alignment: string): (typeof AlignmentType)[keyof typeof AlignmentType];
-//# sourceMappingURL=alignmentUtils.d.ts.map

package/dist/utils/alignmentUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alignmentUtils.d.ts","sourceRoot":"","sources":["../../src/utils/alignmentUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAErC;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,GAChB,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAWpD"}

package/dist/utils/commentAnchors.d.ts

@@ -1,39 +0,0 @@
-/**
- * Comment anchors — the `word/document.xml` half of a review comment.
- *
- * Word expects, in this order inside the commented paragraph(s):
- *
- *   <w:commentRangeStart w:id="N"/> …runs… <w:commentRangeEnd w:id="N"/>
- *   <w:r><w:commentReference w:id="N"/></w:r>
- *
- * The range may span several paragraphs, in which case the start sits in the
- * first and the end plus reference in the last — which is how a list-level
- * comment is anchored.
- */
-import type { ParagraphChild } from 'docx';
-import type { Comment } from '@json-to-office/shared-docx';
-export interface CommentAnchor {
-    /** Every comment in the thread: the root first, then its replies. */
-    ids: number[];
-    /** Range-start elements to place before the commented content. */
-    start: ParagraphChild[];
-}
-/**
- * Register `comment` (and its replies) and return the opening anchors, or
- * undefined when there is no comment. Callers must pair this with
- * `closeCommentRange`.
- *
- * A thread anchors every one of its comments over the same range, which is how
- * Word writes threads and how it groups them in the review pane.
- */
-export declare function openCommentRange(comment: Comment | undefined): CommentAnchor | undefined;
-/**
- * The closing anchors: each range end followed by its reference run.
- *
- * `w:commentReference` is run-inner content, so it has to sit inside a `w:r`.
- * docx's `CommentReference` is the bare element; emitted as a direct child of
- * `w:p` it is schema-invalid and readers drop the comment silently (verified in
- * LibreOffice, which showed zero annotations before this wrapping).
- */
-export declare function closeCommentRange(ids: readonly number[]): ParagraphChild[];
-//# sourceMappingURL=commentAnchors.d.ts.map

package/dist/utils/commentAnchors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commentAnchors.d.ts","sourceRoot":"","sources":["../../src/utils/commentAnchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAG3D,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,kEAAkE;IAClE,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,GAAG,SAAS,GAC3B,aAAa,GAAG,SAAS,CAI3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,EAAE,CAK1E"}

package/dist/utils/componentAnnotations.d.ts

@@ -1,23 +0,0 @@
-/**
- * Detection of per-instance annotation props anywhere in a component subtree.
- *
- * `revision` and `comment` both render as document-scoped OOXML ids allocated
- * from a per-render counter. A component carrying either must never be served
- * from the cross-document component cache, or a cached subtree replays dead ids
- * into a later document.
- *
- * The walk has to reach every place a component can hide: list items, table
- * cells (the table model is column-major, so cells are only reachable through
- * `props.columns[]`), components nested in a cell's `content`, and ordinary
- * children.
- */
-export type MaybeComponent = {
-    props?: unknown;
-    children?: unknown[];
-};
-/**
- * True when `key` appears anywhere in the component subtree: its own props,
- * list items, row-parallel structural entries, table cells, or any descendant.
- */
-export declare function componentHasAnnotation(component: MaybeComponent, key: string): boolean;
-//# sourceMappingURL=componentAnnotations.d.ts.map

package/dist/utils/componentAnnotations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"componentAnnotations.d.ts","sourceRoot":"","sources":["../../src/utils/componentAnnotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAqBvE;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,cAAc,EACzB,GAAG,EAAE,MAAM,GACV,OAAO,CAyCT"}

package/dist/utils/docxImagePositioning.d.ts

@@ -1,19 +0,0 @@
-import type { ImageProps } from '../types';
-import type { ThemeConfig } from '../styles';
-export type FloatingConfig = NonNullable<ImageProps['floating']>;
-export declare function mapHorizontalRelative(rel?: FloatingConfig['horizontalPosition'] extends infer T ? T extends {
-    relative?: infer R;
-} ? R : never : never): "page" | "margin" | "character" | "column" | undefined;
-export declare function mapVerticalRelative(rel?: FloatingConfig['verticalPosition'] extends infer T ? T extends {
-    relative?: infer R;
-} ? R : never : never): "page" | "paragraph" | "margin" | "line" | undefined;
-export declare function mapHorizontalAlign(align?: 'left' | 'center' | 'right' | 'inside' | 'outside'): "left" | "right" | "center" | "inside" | "outside" | undefined;
-export declare function mapVerticalAlign(align?: 'top' | 'center' | 'bottom' | 'inside' | 'outside'): "top" | "bottom" | "center" | "inside" | "outside" | undefined;
-export declare function mapWrapType(type?: 'none' | 'square' | 'topAndBottom' | 'around' | 'through'): 0 | 1 | 2 | 3 | undefined;
-export declare function mapWrapSide(side?: 'bothSides' | 'left' | 'right' | 'largest'): "left" | "right" | "bothSides" | "largest" | undefined;
-/**
- * Map shared floating config to docx ImageRun floating options.
- * Also lifts wrap.margins (if present) to floating.margins as expected by docx.
- */
-export declare function mapFloatingOptions(floating?: FloatingConfig, theme?: ThemeConfig, themeName?: string): any | undefined;
-//# sourceMappingURL=docxImagePositioning.d.ts.map

package/dist/utils/docxImagePositioning.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docxImagePositioning.d.ts","sourceRoot":"","sources":["../../src/utils/docxImagePositioning.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAS7C,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;AAajE,wBAAgB,qBAAqB,CACnC,GAAG,CAAC,EAAE,cAAc,CAAC,oBAAoB,CAAC,SAAS,MAAM,CAAC,GACtD,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAC9B,CAAC,GACD,KAAK,GACP,KAAK,0DAcV;AAED,wBAAgB,mBAAmB,CACjC,GAAG,CAAC,EAAE,cAAc,CAAC,kBAAkB,CAAC,SAAS,MAAM,CAAC,GACpD,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAC9B,CAAC,GACD,KAAK,GACP,KAAK,wDAcV;AAED,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,kEAgB3D;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,kEAgB3D;AAED,wBAAgB,WAAW,CACzB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,6BAgBjE;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,0DAa5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EAAE,cAAc,EACzB,KAAK,CAAC,EAAE,WAAW,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,GAAG,GAAG,SAAS,CA2IjB"}

package/dist/utils/noteRegistry.d.ts

@@ -1,43 +0,0 @@
-/**
- * Note registry — footnote and endnote bodies collected while rendering their
- * markers.
- *
- * A note has two halves in the package: a reference run in
- * `word/document.xml` and a body in `word/footnotes.xml` or
- * `word/endnotes.xml`, joined by a numeric id that is document-scoped.
- * Async-local state gives each render its own counters, so concurrent
- * generations cannot interleave ids and point a reference at another
- * document's body.
- *
- * Footnotes and endnotes are separate id spaces — they are separate parts —
- * so each gets its own counter. Both start at 1: docx writes the reserved
- * separator (-1) and continuationSeparator (0) notes itself.
- */
-import { Paragraph } from 'docx';
-/** docx's shape for the `footnotes` / `endnotes` document options. */
-export type NoteBodies = Record<string, {
-    children: Paragraph[];
-}>;
-declare class NoteRegistry {
-    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;
-    /**
-     * Register a footnote body and return the id its reference must use. Ids are
-     * unique and monotonic within a render.
-     */
-    registerFootnote(text: string): number;
-    /** Register an endnote body and return the id its reference must use. */
-    registerEndnote(text: string): number;
-    /** Every footnote registered in this scope, keyed by id. */
-    getFootnotes(): NoteBodies;
-    /** Every endnote registered in this scope, keyed by id. */
-    getEndnotes(): NoteBodies;
-    /** Test-only: reset the current scope's counters and bodies. */
-    clear(): void;
-}
-export declare const globalNoteRegistry: NoteRegistry;
-export {};
-//# sourceMappingURL=noteRegistry.d.ts.map

package/dist/utils/noteRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"noteRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/noteRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAW,MAAM,MAAM,CAAC;AAI1C,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC,CAAC;AA+BnE,cAAM,YAAY;IAChB,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D,OAAO,KAAK,KAAK,GAEhB;IAED,4EAA4E;IAC5E,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAIlC;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAStC,yEAAyE;IACzE,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASrC,4DAA4D;IAC5D,YAAY,IAAI,UAAU;IAI1B,2DAA2D;IAC3D,WAAW,IAAI,UAAU;IAIzB,gEAAgE;IAChE,KAAK,IAAI,IAAI;CAed;AAED,eAAO,MAAM,kBAAkB,cAAqB,CAAC"}

package/dist/utils/noteResolver.d.ts

@@ -1,31 +0,0 @@
-/**
- * Bind a paragraph's declared note bodies to the `[^id]` markers in its text.
- *
- * Footnotes and endnotes share the marker syntax and differ only in where Word
- * puts the body, so one resolver serves both: an id is looked up in
- * `footnotes` first, then `endnotes`.
- *
- * Registration is lazy — a body reaches its part only when a marker actually
- * resolves to it — and memoized, so repeating `[^id]` points both references at
- * the same note rather than duplicating the body.
- */
-import type { Note } from '@json-to-office/shared-docx';
-export interface NoteResolver {
-    /** Called by the text parser for each `[^id]` marker it finds. */
-    resolve: (id: string) => {
-        id: number;
-        endnote: boolean;
-    } | undefined;
-    /**
-     * Report declared bodies that never made it into the document. Call once the
-     * paragraph's text has been fully parsed.
-     */
-    reportUnemitted: (text: string) => void;
-}
-/**
- * Build the resolver `parseTextWithDecorators` consults for each marker, or
- * undefined when the paragraph declares no notes (which leaves `[^…]` as
- * ordinary text).
- */
-export declare function createNoteResolver(footnotes: readonly Note[] | undefined, endnotes: readonly Note[] | undefined): NoteResolver | undefined;
-//# sourceMappingURL=noteResolver.d.ts.map

package/dist/utils/noteResolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"noteResolver.d.ts","sourceRoot":"","sources":["../../src/utils/noteResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGxD,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IACtE;;;OAGG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAyCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,EACtC,QAAQ,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,GACpC,YAAY,GAAG,SAAS,CAiD1B"}

package/dist/utils/numberedItemsRegistry.d.ts

@@ -1,38 +0,0 @@
-/**
- * Numbered Item Registry
- *
- * Cross-reference targets — numbered headings and list items — resolved by the
- * document-outline pre-pass and read back while rendering inline text.
- *
- * It is a registry rather than a field on `RenderContext` because the consumer
- * is `textParser`, which is reached through `createText`/`createHeading`/
- * `createList` and never sees the context.
- */
-export interface NumberedItemInfo {
-    kind: 'heading' | 'list-item';
-    /** Rendered text of the target, for a `:none` (text) reference. */
-    text: string;
-    /** Full multilevel number ("2.1.3"), absent when the target is unnumbered. */
-    full?: string;
-    /** The target's own level counter ("3"), absent when unnumbered. */
-    own?: string;
-}
-export declare class NumberedItemsRegistry {
-    private readonly fallback;
-    private readonly scopes;
-    private get state();
-    /** Run work with an isolated registry that follows its async call chain. */
-    runScoped<T>(callback: () => T): T;
-    /** Replace the contents with the pre-pass result. */
-    seed(items: ReadonlyMap<string, NumberedItemInfo>): void;
-    /**
-     * False outside a render (a unit test calling `createText` directly). An
-     * unresolved reference is then expected rather than an authoring mistake, so
-     * the caller stays quiet about it.
-     */
-    isSeeded(): boolean;
-    get(id: string): NumberedItemInfo | undefined;
-    clear(): void;
-}
-export declare const globalNumberedItemsRegistry: NumberedItemsRegistry;
-//# sourceMappingURL=numberedItemsRegistry.d.ts.map

package/dist/utils/numberedItemsRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"numberedItemsRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/numberedItemsRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC;IAC9B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAOD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGvB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IAEtE,OAAO,KAAK,KAAK,GAEhB;IAED,4EAA4E;IAC5E,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAIlC,qDAAqD;IACrD,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,IAAI;IAMxD;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7C,KAAK,IAAI,IAAI;CAId;AAED,eAAO,MAAM,2BAA2B,uBAA8B,CAAC"}

package/dist/utils/placeholderImage.d.ts

@@ -1,31 +0,0 @@
-/**
- * Placeholder Image Utility
- * Provides an embedded placeholder image for charts when generation fails or assets are missing
- */
-/// <reference types="node" />
-/**
- * Generate a placeholder image as a Buffer
- * Returns a PNG buffer for compatibility with docx format
- */
-export declare function getPlaceholderImageBuffer(): Buffer;
-/**
- * Generate a placeholder image and save it to a temporary file
- * Returns the path to the generated placeholder file (reuses existing if available)
- */
-export declare function createPlaceholderImageFile(): Promise<string>;
-/**
- * Get a PNG placeholder as base64-encoded data URL
- * This is a minimal 1x1 transparent PNG for fallback scenarios
- */
-export declare function getPlaceholderDataUrl(): string;
-/**
- * Get a more detailed PNG placeholder as Buffer
- * This creates a simple gray box with "Chart" text
- */
-export declare function getPlaceholderPngBuffer(): Buffer;
-/**
- * Clean up placeholder files and cached paths
- * Call this when the document generation is complete
- */
-export declare function cleanupPlaceholders(): Promise<void>;
-//# sourceMappingURL=placeholderImage.d.ts.map

package/dist/utils/placeholderImage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"placeholderImage.d.ts","sourceRoot":"","sources":["../../src/utils/placeholderImage.ts"],"names":[],"mappings":"AAAA;;;GAGG;;AASH;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CA4ClE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BzD"}

package/dist/utils/placeholderProcessor.d.ts

@@ -1,58 +0,0 @@
-/**
- * Placeholder Processing System
- * Handles dynamic content replacement in text with support for rich text formatting
- */
-import { TextRun, ExternalHyperlink, InternalHyperlink, FootnoteReferenceRun, EndnoteReferenceRun, SimpleField } from 'docx';
-import { TextStyle } from './textParser';
-export type PlaceholderChild = TextRun | ExternalHyperlink | InternalHyperlink | FootnoteReferenceRun | EndnoteReferenceRun | SimpleField;
-/**
- * Placeholder handler function type
- */
-export type PlaceholderHandler = (_context?: PlaceholderContext) => PlaceholderChild | PlaceholderChild[] | string;
-/**
- * Context passed to placeholder handlers
- */
-export interface PlaceholderContext {
-    style?: TextStyle;
-    date?: Date;
-    [key: string]: unknown;
-}
-/**
- * Placeholder registry for managing dynamic content
- */
-export declare class PlaceholderRegistry {
-    private static handlers;
-    /**
-     * Register a placeholder handler
-     */
-    static register(name: string, handler: PlaceholderHandler): void;
-    /**
-     * Get a placeholder handler
-     */
-    static get(name: string): PlaceholderHandler | undefined;
-    /**
-     * Check if a placeholder is registered
-     */
-    static has(name: string): boolean;
-    /**
-     * Get all registered placeholder names
-     */
-    static getRegisteredNames(): string[];
-    /**
-     * Clear all registered placeholders
-     */
-    static clear(): void;
-}
-/**
- * Process text containing placeholders and return array of paragraph children
- */
-export declare function processPlaceholders(text: string, baseStyle?: TextStyle, context?: PlaceholderContext): PlaceholderChild[];
-/**
- * Process text with both decorators and placeholders
- */
-export declare function processTextWithPlaceholders(text: string, baseStyle?: TextStyle, context?: PlaceholderContext, noProofWords?: string[]): PlaceholderChild[];
-/**
- * Initialize built-in placeholders
- */
-export declare function initializeBuiltinPlaceholders(): void;
-//# sourceMappingURL=placeholderProcessor.d.ts.map

package/dist/utils/placeholderProcessor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"placeholderProcessor.d.ts","sourceRoot":"","sources":["../../src/utils/placeholderProcessor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,OAAO,EAEP,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACZ,MAAM,MAAM,CAAC;AACd,OAAO,EAIL,SAAS,EACV,MAAM,cAAc,CAAC;AAKtB,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,iBAAiB,GACjB,iBAAiB,GAEjB,oBAAoB,GACpB,mBAAmB,GAEnB,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,QAAQ,CAAC,EAAE,kBAAkB,KAC1B,gBAAgB,GAAG,gBAAgB,EAAE,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAkCD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyC;IAEhE;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIhE;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIxD;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAIrC;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAAc,EACzB,OAAO,GAAE,kBAAuB,GAC/B,gBAAgB,EAAE,CAgDpB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAAc,EACzB,OAAO,GAAE,kBAAuB,EAChC,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,gBAAgB,EAAE,CAyGpB;AAgBD;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CA4CpD"}

package/dist/utils/textParser.d.ts

@@ -1,117 +0,0 @@
-import { TextRun } from 'docx';
-import { type PlaceholderChild, type PlaceholderContext } from './placeholderProcessor';
-export interface TextStyle {
-    font?: string;
-    size?: number;
-    color?: string;
-    bold?: boolean;
-    italics?: boolean;
-    underline?: {
-        type?: 'single' | 'double' | 'thick' | 'dotted' | 'dash' | 'dotDash' | 'dotDotDash' | 'wave' | 'none' | 'words' | 'dottedHeavy' | 'dashedHeavy' | 'dashLong' | 'dashLongHeavy' | 'dashDotHeavy' | 'dashDotDotHeavy' | 'wavyHeavy' | 'wavyDouble';
-        color?: string;
-    };
-    scale?: number;
-    characterSpacing?: number;
-    language?: {
-        value?: string;
-        eastAsia?: string;
-        bidirectional?: string;
-    };
-    noProof?: boolean;
-}
-export interface TextDecoratorOptions {
-    boldColor?: string;
-    placeholderContext?: PlaceholderContext;
-    enableHyperlinks?: boolean;
-    /**
-     * "Known words" allowlist: each whole-word, case-insensitive occurrence is
-     * emitted as its own no-proof run so Word never flags it, while surrounding
-     * text stays spell-checked.
-     */
-    noProofWords?: string[];
-    /**
-     * Resolve a `[^id]` note marker to its document-scoped id and kind, or
-     * undefined to leave the marker as literal text.
-     *
-     * Passing a resolver is what turns `[^…]` into syntax at all: without one,
-     * text that merely looks like a marker (a regex character class in a code
-     * sample, say) is untouched.
-     */
-    noteRef?: (id: string) => {
-        id: number;
-        endnote: boolean;
-    } | undefined;
-}
-/**
- * Build a matcher for the known-words allowlist, or null when there's nothing
- * to match. Matches each word as a whole token (no letter/number directly
- * adjacent on either side) so "Wiseair" doesn't match inside "Wiseairy", while
- * internal punctuation like "json-to-office" is matched literally.
- */
-export declare function buildNoProofWordsRegex(noProofWords?: string[]): RegExp | null;
-/**
- * Split a plain string into TextRuns, marking every known-word occurrence as a
- * no-proof run via `makeRun`. When there are no known words, returns a single
- * run for the whole text.
- */
-export declare function splitByNoProofWords(text: string, makeRun: (segment: string, noProof: boolean) => TextRun, noProofWords?: string[]): TextRun[];
-/**
- * Parses text with inline markdown-style decorators, placeholders, and newlines, returning an array of TextRun objects
- * Supports:
- * - **bold** or __bold__
- * - *italic* or _italic_
- * - ***bold italic*** or ___bold italic___
- * - \n for line breaks
- * - {PLACEHOLDER} for dynamic content
- * - [link text](url) for hyperlinks (when enableHyperlinks is true)
- *
- * @param text The text to parse
- * @param baseStyle The base style to apply to all text runs
- * @param options Additional options for text decoration
- * @returns Array of TextRun and hyperlink objects with appropriate styling
- */
-export declare function parseTextWithDecorators(text: string, baseStyle?: TextStyle, options?: TextDecoratorOptions): PlaceholderChild[];
-/**
- * Run-level properties shared by every run produced for a piece of text.
- * Single assembly point for both the plain-text and placeholder paths — a
- * prop forwarded here reaches both, so the two cannot drift (issue #137).
- */
-export declare function buildRunCommonProps(baseStyle: TextStyle, overrides?: {
-    bold?: boolean;
-    italics?: boolean;
-    boldColor?: string;
-}): {
-    language?: {
-        value?: string | undefined;
-        eastAsia?: string | undefined;
-        bidirectional?: string | undefined;
-    } | undefined;
-    characterSpacing?: number | undefined;
-    scale?: number | undefined;
-    underline?: {
-        type?: "single" | "double" | "dotDash" | "dotDotDash" | "dotted" | "none" | "thick" | "wave" | "dash" | "words" | "dottedHeavy" | "dashedHeavy" | "dashLong" | "dashLongHeavy" | "dashDotHeavy" | "dashDotDotHeavy" | "wavyHeavy" | "wavyDouble" | undefined;
-        color?: string | undefined;
-    } | undefined;
-    italics?: boolean | undefined;
-    bold?: boolean | undefined;
-    color?: string | undefined;
-    size?: number | undefined;
-    font?: string | undefined;
-};
-/**
- * Turn multi-line text into TextRuns: `\n` becomes a run break, `\t` a real
- * tab run, no-proof words their own runs. Shared by the plain-text path
- * (textParser) and the placeholder path (placeholderProcessor) so run-level
- * properties cannot diverge between them.
- */
-export declare function buildTextRuns(text: string, commonProps: ReturnType<typeof buildRunCommonProps>, opts?: {
-    noProof?: boolean;
-    noProofWords?: string[];
-}): TextRun[];
-/**
- * True when the text carries a `[@id]` token. `createHeading` renders simple
- * headings through a run builder that never reaches this parser, so it needs to
- * know when a heading is not simple after all.
- */
-export declare function hasCrossReference(text: string): boolean;
-//# sourceMappingURL=textParser.d.ts.map

package/dist/utils/textParser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"textParser.d.ts","sourceRoot":"","sources":["../../src/utils/textParser.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAQR,MAAM,MAAM,CAAC;AACd,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EACD,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,YAAY,GACZ,MAAM,GACN,MAAM,GACN,OAAO,GACP,aAAa,GACb,aAAa,GACb,UAAU,GACV,eAAe,GACf,cAAc,GACd,iBAAiB,GACjB,WAAW,GACX,YAAY,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IAEF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CACxE;AAaD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAY7E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,EACvD,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,EAAE,CAoBX;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAAc,EACzB,OAAO,GAAE,oBAAyB,GACjC,gBAAgB,EAAE,CAoGpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,SAAS,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;EAoBtE;AAyDD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EACnD,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GACxD,OAAO,EAAE,CAiBX;AAoGD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}