@json-to-office/core-docx 0.1.0

package/dist/core/content.d.ts

@@ -0,0 +1,263 @@
+/**
+ * Content Creation Functions
+ * Pure functions for creating Word document elements without layout concerns
+ */
+import { Paragraph, Table, Header, Footer } from 'docx';
+import { ThemeConfig } from '../styles';
+import { ComponentDefinition } from '../types';
+export interface TextOptions {
+    style?: string;
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+    spacing?: {
+        before?: number;
+        after?: number;
+    };
+    lineSpacing?: number | {
+        type: 'single' | 'atLeast' | 'exactly' | 'double' | 'multiple';
+        value?: number;
+    };
+    boldColor?: string;
+    columnBreak?: boolean;
+    fontFamily?: string;
+    fontSize?: number;
+    fontColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    prependChildren?: any[];
+    outlineLevel?: number;
+    bookmarkId?: string;
+    floating?: {
+        horizontalPosition?: {
+            relative?: 'margin' | 'page' | 'text';
+            align?: 'left' | 'center' | 'right' | 'inside' | 'outside';
+            offset?: number;
+        };
+        verticalPosition?: {
+            relative?: 'margin' | 'page' | 'text';
+            align?: 'top' | 'center' | 'bottom' | 'inside' | 'outside' | 'inline';
+            offset?: number;
+        };
+        wrap?: {
+            type: 'around' | 'none' | 'notBeside' | 'through' | 'tight' | 'auto';
+        };
+        lockAnchor?: boolean;
+        width?: number;
+        height?: number;
+    };
+    keepNext?: boolean;
+    keepLines?: boolean;
+}
+export interface ImageOptions {
+    caption?: string;
+    width?: number | string;
+    height?: number | string;
+    widthRelativeTo?: 'content' | 'page';
+    heightRelativeTo?: 'content' | 'page';
+    alignment?: 'left' | 'center' | 'right';
+    spacing?: {
+        before?: number;
+        after?: number;
+    };
+    floating?: {
+        horizontalPosition?: {
+            relative?: 'character' | 'column' | 'margin' | 'page' | 'text';
+            align?: 'left' | 'center' | 'right' | 'inside' | 'outside';
+            offset?: number;
+        };
+        verticalPosition?: {
+            relative?: 'margin' | 'page' | 'paragraph' | 'line' | 'text';
+            align?: 'top' | 'center' | 'bottom' | 'inside' | 'outside';
+            offset?: number;
+        };
+        wrap?: {
+            type: 'none' | 'square' | 'topAndBottom' | 'around' | 'tight' | 'through';
+            side?: 'bothSides' | 'left' | 'right' | 'largest';
+            margins?: {
+                top?: number;
+                bottom?: number;
+                left?: number;
+                right?: number;
+            };
+        };
+        allowOverlap?: boolean;
+        behindDocument?: boolean;
+        lockAnchor?: boolean;
+        layoutInCell?: boolean;
+        zIndex?: number;
+        rotation?: number;
+        visibility?: 'hidden' | 'inherit';
+    };
+    keepNext?: boolean;
+    keepLines?: boolean;
+}
+export interface TableOptions {
+    style?: 'minimal' | 'classic' | 'minimal';
+}
+export interface StatisticData {
+    number: string;
+    description: string;
+    alignment?: 'left' | 'center' | 'right';
+}
+export interface StatisticOptions {
+    spacing?: {
+        before?: number;
+        after?: number;
+    };
+}
+export interface ListOptions {
+    numberingReference?: string;
+    spacing?: {
+        before?: number;
+        after?: number;
+        item?: number;
+    };
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+}
+/**
+ * Create a text paragraph
+ */
+export declare function createText(content: string, theme: ThemeConfig, _themeName: string, options?: TextOptions): Paragraph;
+/**
+ * Create a header paragraph
+ */
+export declare function createHeading(text: string, level: number, theme: ThemeConfig, _themeName: string, options?: TextOptions): Paragraph;
+/**
+ * Create title page content
+ */
+export declare function createTitleContent(title?: string, subtitle?: string): Paragraph[];
+/**
+ * Create an image with optional caption
+ */
+export declare function createImage(path: string, theme: ThemeConfig, options?: ImageOptions): Promise<Paragraph[]>;
+/**
+ * Create a statistic display
+ */
+export declare function createStatistic(data: StatisticData, options?: StatisticOptions): Paragraph[];
+/**
+ * Create a list of items using proper docx numbering
+ */
+export declare function createList(items: (string | {
+    text: string;
+    level?: number;
+})[], _theme: ThemeConfig, _themeName: string, options?: ListOptions): Paragraph[];
+/**
+ * Create a table
+ */
+type TableFontConfig = {
+    family?: string;
+    size?: number;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+};
+type BorderColor = string | {
+    bottom?: string;
+    top?: string;
+    right?: string;
+    left?: string;
+};
+type BorderSize = number | {
+    bottom?: number;
+    top?: number;
+    right?: number;
+    left?: number;
+};
+type Padding = number | {
+    bottom?: number;
+    top?: number;
+    right?: number;
+    left?: number;
+};
+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;
+};
+type HideBorders = boolean | {
+    top?: boolean;
+    right?: boolean;
+    bottom?: boolean;
+    left?: boolean;
+    insideHorizontal?: boolean;
+    insideVertical?: boolean;
+};
+type TableConfig = {
+    borderColor?: BorderColor;
+    borderSize?: BorderSize;
+    hideBorders?: HideBorders;
+    cellDefaults?: CellDefaults;
+    headerCellDefaults?: CellDefaults;
+    width?: number;
+    columns: {
+        width?: number;
+        cellDefaults?: CellDefaults;
+        header?: CellDefaults & {
+            content?: string | ComponentDefinition;
+        };
+        cells?: (CellDefaults & {
+            content?: string | ComponentDefinition;
+        })[];
+    }[];
+    keepInOnePage?: boolean;
+    keepNext?: boolean;
+    repeatHeaderOnPageBreak?: boolean;
+};
+export declare function createTable(columns: TableConfig['columns'], tableConfig: TableConfig, theme: ThemeConfig, themeName: string, _options?: TableOptions): Promise<Table>;
+/**
+ * Create header element from content
+ */
+export declare function createHeaderElement(children: (Paragraph | Table)[], _options?: {
+    position?: 'left' | 'center' | 'right';
+}): Header;
+/**
+ * Create footer element from content
+ */
+export declare function createFooterElement(children: (Paragraph | Table)[], _options?: {
+    position?: 'left' | 'center' | 'right';
+}): Footer;
+/**
+ * Create page number element
+ */
+export declare function createPageNumberElement(format?: string, alignment?: 'left' | 'center' | 'right'): Paragraph;
+/**
+ * Create mixed content paragraph with text and image elements
+ */
+export declare function createMixedContentParagraph(textContent: string, textOptions: {
+    fontSize?: number;
+    color?: string;
+    bold?: boolean;
+    italic?: boolean;
+}, imagePath?: string, imageOptions?: {
+    width?: number;
+    height?: number;
+}, alignment?: 'left' | 'center' | 'right', theme?: import('../styles').ThemeConfig): Promise<Paragraph>;
+/**
+ * Create a table specifically for headers/footers with custom styling
+ */
+export declare function createHeaderFooterTable(rows: (string | ComponentDefinition)[][], options?: {
+    cellAlignments?: ('left' | 'center' | 'right')[];
+    fontSize?: number;
+    bold?: boolean;
+    color?: string;
+    noBorders?: boolean;
+    cellStyling?: {
+        [rowIndex: number]: {
+            [cellIndex: number]: {
+                bold?: boolean;
+                color?: string;
+                fontSize?: number;
+            };
+        };
+    };
+    theme?: ThemeConfig;
+    themeName?: string;
+}): Promise<Table>;
+export {};
+//# sourceMappingURL=content.d.ts.map

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

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

package/dist/core/generator.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Document Generator
+ * Main orchestration functions that compose the document generation pipeline
+ */
+/// <reference types="node" />
+import { Document } from 'docx';
+import { ComponentDefinition, ReportProps, ReportComponentDefinition } from '../types';
+import { ThemeConfig } from '../styles';
+import { DocumentValidationResult } from '@json-to-office/shared-docx';
+export interface JsonGenerationOptions {
+    outputPath?: string;
+    validation?: {
+        strict?: boolean;
+        allowUnknownFields?: boolean;
+    };
+    customThemes?: {
+        [key: string]: ThemeConfig;
+    };
+}
+/**
+ * Type guard to check if input is a report component definition
+ */
+export declare function isReportComponentDefinition(definition: unknown): definition is ReportComponentDefinition;
+/**
+ * Generate a Word document from a report component definition
+ * This is the main entry point for document generation
+ */
+export declare function generateDocument(document: ReportComponentDefinition): Promise<Document>;
+/**
+ * Generate document from report props and components
+ * Convenience function that constructs the report component
+ */
+export declare function generateFromConfig(props: ReportProps, components: ComponentDefinition[]): Promise<Document>;
+/**
+ * Generate a Word document from JSON report definition
+ * Handles parsing, validation, and conversion to internal components
+ */
+export declare function generateDocumentFromJson(jsonConfig: string | ComponentDefinition | ReportComponentDefinition, options?: JsonGenerationOptions): Promise<Document>;
+/**
+ * Validate JSON schema without generating document
+ */
+export declare function validateJsonSchema(jsonConfig: string | object): DocumentValidationResult;
+/**
+ * Generate document buffer from JSON (commonly used for API responses)
+ */
+export declare function generateBufferFromJson(jsonConfig: string | ReportComponentDefinition, options?: JsonGenerationOptions): Promise<Buffer>;
+/**
+ * Generate and save document from JSON in one operation
+ */
+export declare function generateAndSaveFromJson(jsonConfig: string | ReportComponentDefinition, filename: string, options?: JsonGenerationOptions): Promise<void>;
+/**
+ * Generate document from JSON file
+ */
+export declare function generateDocumentFromFile(filePath: string, options?: JsonGenerationOptions): Promise<Document>;
+/**
+ * Generate document buffer from JSON file
+ */
+export declare function generateBufferFromFile(filePath: string, options?: JsonGenerationOptions): Promise<Buffer>;
+/**
+ * Generate and save document from JSON file in one operation
+ */
+export declare function generateAndSaveFromFile(inputFilePath: string, outputFilePath: string, options?: JsonGenerationOptions): Promise<void>;
+/**
+ * Save a document to file
+ */
+export declare function saveDocument(document: Document, filename: string): Promise<void>;
+/**
+ * Generate and save document in one operation
+ */
+export declare function generateAndSave(document: ReportComponentDefinition, filename: string): Promise<void>;
+/**
+ * Compose multiple transform functions
+ * Utility for creating custom pipelines
+ */
+export declare function pipe<T>(...fns: Array<(_arg: T) => T>): (_arg: T) => T;
+/**
+ * Export the main API
+ */
+export declare const DocumentGenerator: {
+    generate: typeof generateDocument;
+    generateFromConfig: typeof generateFromConfig;
+    generateFromJson: typeof generateDocumentFromJson;
+    generateFromFile: typeof generateDocumentFromFile;
+    generateBufferFromJson: typeof generateBufferFromJson;
+    generateBufferFromFile: typeof generateBufferFromFile;
+    generateAndSaveFromJson: typeof generateAndSaveFromJson;
+    generateAndSaveFromFile: typeof generateAndSaveFromFile;
+    validateJsonSchema: typeof validateJsonSchema;
+    save: typeof saveDocument;
+    generateAndSave: typeof generateAndSave;
+    isReportComponentDefinition: typeof isReportComponentDefinition;
+};
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/core/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;;AAEH,OAAO,EAAE,QAAQ,EAAU,MAAM,MAAM,CAAC;AAExC,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,yBAAyB,EAE1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAwB,WAAW,EAAE,MAAM,WAAW,CAAC;AAM9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAMvE,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,CAAC;IACF,YAAY,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,OAAO,GAClB,UAAU,IAAI,yBAAyB,CASzC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,QAAQ,CAAC,CAuBnB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,mBAAmB,EAAE,GAChC,OAAO,CAAC,QAAQ,CAAC,CAQnB;AA6CD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,GAAG,mBAAmB,GAAG,yBAAyB,EACpE,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAuBnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,wBAAwB,CAE1B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GAAG,yBAAyB,EAC9C,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,GAAG,yBAAyB,EAC9C,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAKnB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,yBAAyB,EACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAErE;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAa7B,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Core module exports
+ * Functional document generation API
+ */
+export { generateDocument, generateFromConfig, saveDocument, generateAndSave, 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 type { ProcessedDocument, DocumentMetadata, ProcessedSection, } from './structure';
+export type { LayoutPlan, SectionLayout, LayoutGroup } from './layout';
+export type { TextOptions, ImageOptions, TableOptions, StatisticData, } from './content';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/layout.d.ts

@@ -0,0 +1,107 @@
+/**
+ * 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';
+export interface LayoutPlan {
+    sections: SectionLayout[];
+}
+export interface WordSectionProperties {
+    page: {
+        size: {
+            width: number;
+            height: number;
+        };
+        margin: {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        };
+    };
+    column: ColumnSettings & {
+        children?: DocxColumn[];
+    };
+    type?: (typeof SectionType)[keyof typeof SectionType];
+}
+export interface SectionLayout {
+    properties: WordSectionProperties;
+    components: ComponentDefinition[];
+    layoutType: 'single' | 'multi-column';
+    breakBefore: boolean;
+    header?: ComponentDefinition[] | 'linkToPrevious';
+    footer?: ComponentDefinition[] | 'linkToPrevious';
+    /** True if this layout section comes from a user-defined Section component */
+    isUserSection: boolean;
+    /** True if this layout chunk belongs to a user-defined Section (all chunks of that section) */
+    belongsToUserSection: boolean;
+    /** The heading level of the section title (e.g., 1 for Heading1) - used by TOCs to exclude section title from section-scoped TOCs */
+    sectionTitleLevel?: number;
+    /** Page configuration override for this section */
+    pageOverride?: {
+        size?: 'A4' | 'A3' | 'LETTER' | 'LEGAL' | {
+            width: number;
+            height: number;
+        };
+        margins?: {
+            top?: number;
+            bottom?: number;
+            left?: number;
+            right?: number;
+            header?: number;
+            footer?: number;
+            gutter?: number;
+        };
+    };
+}
+export interface LayoutGroup {
+    layout: 'single' | 'multi-column';
+    components: ComponentDefinition[];
+    breakBefore: boolean;
+}
+/**
+ * Apply layout to processed sections
+ */
+export declare function applyLayout(sections: ProcessedSection[], theme: ThemeConfig, themeName: string): LayoutPlan;
+/**
+ * Analyze components to determine layout groups
+ */
+export declare function analyzeLayoutGroups(components: ComponentDefinition[]): LayoutGroup[];
+/**
+ * Determine layout type for a component
+ */
+export declare function determineComponentLayout(component: ComponentDefinition): 'single' | 'multi-column';
+/**
+ * Process components for layout (insert breaks where needed)
+ */
+export declare function processLayoutComponents(components: ComponentDefinition[]): ComponentDefinition[];
+/**
+ * Get column settings for layout type
+ */
+export declare function getColumnSettings(layout: 'single' | 'multi-column'): ColumnSettings;
+/**
+ * Create Word section properties
+ */
+export declare function createSectionProperties(columnSettings: ColumnSettings, theme: ThemeConfig, themeName: string, sectionType?: 'continuous' | 'nextPage', pageOverride?: {
+    size?: 'A4' | 'A3' | 'LETTER' | 'LEGAL' | {
+        width: number;
+        height: number;
+    };
+    margins?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+        header?: number;
+        footer?: number;
+        gutter?: number;
+    };
+}): WordSectionProperties;
+/**
+ * Calculate optimal column distribution for content
+ */
+export declare function calculateColumnDistribution(components: ComponentDefinition[], columnCount: number): ComponentDefinition[][];
+//# sourceMappingURL=layout.d.ts.map

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

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

package/dist/core/render.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Render Functions
+ * Transform components and layout into Word document elements
+ */
+import { Document, Paragraph, Table, TableOfContents, ISectionOptions, Textbox } from 'docx';
+import { ComponentDefinition, RenderContext } from '../types';
+import { ThemeConfig } from '../styles';
+import { ProcessedDocument } from './structure';
+import { LayoutPlan, SectionLayout } from './layout';
+import { MemoryCache } from '../cache';
+/**
+ * Render a complete document from structure and layout
+ */
+export declare function renderDocument(structure: ProcessedDocument, layout: LayoutPlan, options?: {
+    cache?: MemoryCache;
+    bypassCache?: boolean;
+}): Promise<Document>;
+/**
+ * Render a section with layout
+ */
+export declare function renderSection(section: SectionLayout, theme: ThemeConfig, themeName: string, context: RenderContext, sectionOrdinal?: number, closeBookmark?: 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 | Textbox)[]>;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"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,EACf,eAAe,EAMf,OAAO,EACR,MAAM,MAAM,CAAC;AAWd,OAAO,EACL,mBAAmB,EACnB,aAAa,EAgBd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAMxC,OAAO,EAAE,iBAAiB,EAAuB,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKrD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAqCvC;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,OAAO,CAAC,QAAQ,CAAC,CAiJnB;AA+MD;;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,GACtB,OAAO,CAAC,eAAe,CAAC,CAiH1B;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,GAAG,OAAO,CAAC,EAAE,CAAC,CAgC5D"}

package/dist/core/structure.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Document Structure Functions
+ * Handle document hierarchy and organization without layout concerns
+ */
+import { ComponentDefinition, ReportProps, ReportComponentDefinition, RenderContext } from '../types';
+import { ThemeConfig } from '../styles';
+export interface ProcessedDocument {
+    metadata: DocumentMetadata;
+    sections: ProcessedSection[];
+    theme: ThemeConfig;
+    themeName: string;
+}
+export interface DocumentMetadata {
+    title?: string;
+    subtitle?: string;
+    author?: string;
+    company?: string;
+    date: Date;
+}
+export interface ProcessedSection {
+    title?: string;
+    level?: number;
+    components: ComponentDefinition[];
+    header?: ComponentDefinition[] | 'linkToPrevious';
+    footer?: ComponentDefinition[] | 'linkToPrevious';
+    /** True if this section originates from an explicit Section component */
+    isExplicitSection?: boolean;
+    /** Whether this section should start on a new page */
+    pageBreak?: boolean;
+    /** Page configuration override for this section */
+    page?: {
+        size?: 'A4' | 'A3' | 'LETTER' | 'LEGAL' | {
+            width: number;
+            height: number;
+        };
+        margins?: {
+            top?: number;
+            bottom?: number;
+            left?: number;
+            right?: number;
+            header?: number;
+            footer?: number;
+            gutter?: number;
+        };
+    };
+}
+/**
+ * Process document definition into structured format
+ */
+export declare function processDocument(document: ReportComponentDefinition, theme: ThemeConfig, themeName: string): Promise<ProcessedDocument>;
+/**
+ * Extract document metadata from report props
+ */
+export declare function createDocumentMetadata(props: ReportProps): DocumentMetadata;
+/**
+ * Extract and flatten sections from component hierarchy
+ */
+export declare function extractSections(components: ComponentDefinition[], context: RenderContext): Promise<ProcessedSection[]>;
+/**
+ * Flatten nested container components while preserving content components
+ */
+export declare function flattenComponents(components: ComponentDefinition[], context: RenderContext): Promise<ComponentDefinition[]>;
+/**
+ * Create render context from processed document
+ */
+export declare function createRenderContext(document: ProcessedDocument, theme: ThemeConfig, themeName: string): RenderContext;
+//# sourceMappingURL=structure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/core/structure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,yBAAyB,EACzB,aAAa,EAGd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,mBAAmB,EAAE,GAAG,gBAAgB,CAAC;IAClD,MAAM,CAAC,EAAE,mBAAmB,EAAE,GAAG,gBAAgB,CAAC;IAClD,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5E,OAAO,CAAC,EAAE;YACR,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAwB5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAQ3E;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA+D7B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA8ChC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,GAChB,aAAa,CA0Bf"}

package/dist/examples/test-spacing-debug.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-spacing-debug.d.ts.map

package/dist/examples/test-spacing-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-spacing-debug.d.ts","sourceRoot":"","sources":["../../src/examples/test-spacing-debug.ts"],"names":[],"mappings":""}

package/dist/examples/test-spacing.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Test Spacing Example
+ * Generate document to test that spacing values are in points
+ */
+export {};
+//# sourceMappingURL=test-spacing.d.ts.map

package/dist/examples/test-spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-spacing.d.ts","sourceRoot":"","sources":["../../src/examples/test-spacing.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+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 { 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, warmComponentCache, } from './core/cached-render';
+export { isReportComponent, isSectionComponent, isHeadingComponent, isParagraphComponent, isColumnsComponent, isImageComponent, isStatisticComponent, isTableComponent, isListComponent, isHeaderComponent, isFooterComponent, isHighchartsComponent, } from './types/index';
+export type { 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';
+export type { ThemeName } from './styles/index';
+export { loadThemeFromJson, loadThemeFromFile, exportThemeToJson, validateThemeJsonString, ThemeValidationError, ThemeParseError, ThemeFileError, createMinimalTheme, } from './themes/json/index';
+export { examples, getExample, getExampleNames, loadJsonExample, } from './templates/documents/index';
+export { runExample } from './utils/exampleRunner';
+import './components/index';
+export type { ChartGenerationResult, } from './components/highcharts';
+export { createComponent, createVersion, createDocumentGenerator, validateComponentProps, validateDocument, cleanComponentProps, ComponentValidationError, generatePluginDocumentSchema, exportPluginSchema, generateComponentSchemas, mergeSchemas, type CustomComponent, type ComponentVersion, type ComponentVersionMap, type RenderFunction, type RenderContext as ComponentRenderContext, type DocumentGenerator, type DocumentGeneratorOptions, type GenerationResult, type BufferGenerationResult, type FileGenerationResult, 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