@json-to-office/core-docx 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,158 @@
+import { ISectionOptions } from 'docx';
+import type { ThemeName } from '../styles';
+import type { ComponentDefinition as SharedComponentDefinition, ReportComponent, SectionComponent, ColumnsComponent, HeadingComponent, ParagraphComponent, ImageComponent, HighchartsComponent, StatisticComponent, TableComponent, HeaderComponent, FooterComponent, ListComponent, TocComponent, TextBoxComponent, ReportProps as SharedReportProps, SectionProps as SharedSectionProps, HeadingProps as SharedHeadingProps, ParagraphProps as SharedParagraphProps, ColumnsProps as SharedColumnsProps, ImageProps as SharedImageProps, StatisticProps as SharedStatisticProps, TableProps as SharedTableProps, HeaderProps as SharedHeaderProps, FooterProps as SharedFooterProps, ListProps as SharedListProps, TocProps as SharedTocProps, TextBoxProps as SharedTextBoxProps } from '@json-to-office/shared-docx';
+export { isReportComponent, isSectionComponent, isHeadingComponent, isParagraphComponent, isColumnsComponent, isImageComponent, isTextBoxComponent, isStatisticComponent, isTableComponent, isListComponent, isTocComponent, isHeaderComponent, isFooterComponent, isHighchartsComponent, } from '@json-to-office/shared-docx';
+export type ComponentDefinition = SharedComponentDefinition;
+export type ReportComponentDefinition = ReportComponent & {
+    /** Optional schema field for JSON validation */
+    $schema?: string;
+};
+export type SectionComponentDefinition = SectionComponent;
+export type HeadingComponentDefinition = HeadingComponent;
+export type ParagraphComponentDefinition = ParagraphComponent;
+export type ColumnsComponentDefinition = ColumnsComponent;
+export type ImageComponentDefinition = ImageComponent;
+export type TextBoxComponentDefinition = TextBoxComponent;
+export type StatisticComponentDefinition = StatisticComponent;
+export type TableComponentDefinition = TableComponent;
+export type HeaderComponentDefinition = HeaderComponent;
+export type FooterComponentDefinition = FooterComponent;
+export type ListComponentDefinition = ListComponent;
+export type TocComponentDefinition = TocComponent;
+export type StandardComponentDefinition = ReportComponent | SectionComponent | ColumnsComponent | HeadingComponent | ParagraphComponent | TextBoxComponent | ImageComponent | HighchartsComponent | StatisticComponent | TableComponent | HeaderComponent | FooterComponent | ListComponent | TocComponent;
+export type ReportProps = SharedReportProps;
+export type SectionProps = SharedSectionProps;
+export type HeadingProps = SharedHeadingProps;
+export type ParagraphProps = SharedParagraphProps;
+export type ColumnsProps = SharedColumnsProps;
+export type ImageProps = SharedImageProps;
+export type TextBoxProps = SharedTextBoxProps;
+export type StatisticProps = SharedStatisticProps;
+export type TableProps = SharedTableProps;
+export type HeaderProps = SharedHeaderProps;
+export type FooterProps = SharedFooterProps;
+export type ListProps = SharedListProps;
+export type TocProps = SharedTocProps;
+export type { ThemeName };
+export interface ColumnSettings {
+    count: number;
+    equalWidth?: boolean;
+    space?: number;
+    /** Optional explicit column children with widths/spaces in twips */
+    children?: {
+        width?: number;
+        space?: number;
+    }[];
+}
+export interface PageSizeOptions {
+    width: number;
+    height: number;
+}
+export interface PageMarginOptions {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    header?: number;
+    footer?: number;
+}
+export interface PageNumberOptions {
+    start?: number;
+    formatType?: 'decimal' | 'upperRoman' | 'lowerRoman' | 'upperLetter' | 'lowerLetter';
+}
+export interface PageBorderOptions {
+    top?: {
+        style: string;
+        size: number;
+        color: string;
+    };
+    right?: {
+        style: string;
+        size: number;
+        color: string;
+    };
+    bottom?: {
+        style: string;
+        size: number;
+        color: string;
+    };
+    left?: {
+        style: string;
+        size: number;
+        color: string;
+    };
+}
+export interface SectionProperties {
+    page?: {
+        size?: PageSizeOptions;
+        margin?: PageMarginOptions;
+        pageNumbers?: PageNumberOptions;
+        borders?: PageBorderOptions;
+        textDirection?: 'ltr' | 'rtl';
+    };
+    column?: ColumnSettings;
+    type?: 'continuous' | 'nextColumn' | 'nextPage' | 'evenPage' | 'oddPage';
+    headers?: ISectionOptions['headers'];
+    footers?: ISectionOptions['footers'];
+}
+export interface ImageContent {
+    path: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    alignment?: 'left' | 'center' | 'right';
+}
+export interface StatisticContent {
+    number: string;
+    description: string;
+    alignment?: 'left' | 'center' | 'right';
+}
+export interface TableData {
+    headers: string[];
+    rows: (string | SharedComponentDefinition)[][];
+    style?: 'minimal' | 'classic' | 'minimal';
+}
+/**
+ * Rendering context for components
+ */
+export interface RenderContext {
+    theme: {
+        name: string;
+        colors: Record<string, string>;
+        fonts: Record<string, string>;
+        spacing: Record<string, number>;
+    };
+    /** Full theme configuration for custom components */
+    fullTheme: import('../styles').ThemeConfig;
+    document: {
+        title?: string;
+        subtitle?: string;
+        author?: string;
+        company?: string;
+        date: Date;
+    };
+    section: {
+        currentLayout: 'single' | 'multi-column';
+        columnCount: number;
+        pageNumber: number;
+        level?: number;
+        /** Bookmark ID for section-scoped TOCs (when TOC is inside a section) */
+        sectionBookmarkId?: string;
+        /** Heading level of the parent section title (used to exclude it from section-scoped TOCs) */
+        sectionTitleLevel?: number;
+    };
+    utils: {
+        formatDate: (_date: Date) => string;
+        parseText: (_text: string) => {
+            text: string;
+        }[];
+        getStyle: (_name: string) => {
+            name: string;
+        };
+        [key: string]: unknown;
+    };
+    parent?: SharedComponentDefinition;
+    depth: number;
+    custom?: Record<string, unknown>;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/plugin.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Plugin-specific type definitions
+ */
+import type { TSchema, Static } from '@sinclair/typebox';
+import type { ComponentDefinition } from '@json-to-office/shared-docx';
+import type { AddWarningFunction } from '@json-to-office/shared-docx';
+import type { ThemeConfig } from '../styles';
+/**
+ * Render function context - parameters passed to render
+ */
+export interface PluginRenderContext<T> {
+    /** The validated props for this component */
+    props: T;
+    /** The resolved theme configuration */
+    theme: ThemeConfig;
+    /** Function to add warnings during processing */
+    addWarning: AddWarningFunction;
+    /** For container components: processed nested children */
+    children?: unknown[];
+}
+/**
+ * Render function that transforms custom component props into standard components.
+ * Returns a properly typed array of component definitions with full type inference.
+ */
+export type PluginRenderFunction<T> = (context: PluginRenderContext<T>) => Promise<ComponentDefinition[]>;
+/**
+ * Plugin component definition with automatic props type inference from schema
+ */
+export interface PluginComponent<TPropsSchema extends TSchema = TSchema> {
+    /** Unique name for the component type */
+    name: string;
+    /** TypeBox schema for props validation */
+    propsSchema: TPropsSchema;
+    /** Async render function to transform props into standard components */
+    render: PluginRenderFunction<Static<TPropsSchema>>;
+    /** Whether this component can contain nested `children` */
+    hasChildren?: boolean;
+    /** Optional description for documentation */
+    description?: string;
+    /** Optional version for compatibility tracking */
+    version?: string;
+}
+/**
+ * Plugin validation error details
+ */
+export interface PluginValidationError {
+    /** Path to the error (e.g., "children[2].props.city") */
+    path: string;
+    /** Human-readable error message */
+    message: string;
+    /** Error code for programmatic handling */
+    code: string;
+    /** The actual value that failed validation */
+    value?: unknown;
+}
+/**
+ * Plugin validation result
+ */
+export interface PluginValidationResult<T = unknown> {
+    /** Whether validation succeeded */
+    success: boolean;
+    /** Validated and typed data */
+    data?: T;
+    /** List of validation errors if failed */
+    errors?: PluginValidationError[];
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,6CAA6C;IAC7C,KAAK,EAAE,CAAC,CAAC;IACT,uCAAuC;IACvC,KAAK,EAAE,WAAW,CAAC;IACnB,iDAAiD;IACjD,UAAU,EAAE,kBAAkB,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CACpC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAC5B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,YAAY,SAAS,OAAO,GAAG,OAAO;IACrE,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,EAAE,YAAY,CAAC;IAC1B,wEAAwE;IACxE,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,OAAO;IACjD,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClC"}

package/dist/utils/alignmentUtils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/bookmarkRegistry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Bookmark Registry
+ * Utilities for managing document bookmarks for internal hyperlinks
+ */
+export interface BookmarkInfo {
+    id: string;
+    title: string;
+    type: string;
+}
+/**
+ * Registry for managing document bookmarks
+ * Used to track bookmark IDs and validate internal hyperlink targets
+ */
+export declare class BookmarkRegistry {
+    private bookmarks;
+    private counter;
+    /**
+     * Register a bookmark
+     */
+    register(id: string, title: string, type: string): void;
+    /**
+     * Generate a unique bookmark ID from text
+     * Converts text to a URL-friendly format
+     */
+    generateId(text: string, _type?: string): string;
+    /**
+     * Check if a bookmark exists
+     */
+    exists(id: string): boolean;
+    /**
+     * Get bookmark info by ID
+     */
+    get(id: string): BookmarkInfo | undefined;
+    /**
+     * Get all registered bookmarks
+     */
+    getAll(): BookmarkInfo[];
+    /**
+     * Clear all bookmarks
+     */
+    clear(): void;
+    /**
+     * Validate that all internal hyperlink references exist
+     * Returns array of missing bookmark IDs
+     */
+    validateReferences(referencedIds: string[]): string[];
+}
+export declare const globalBookmarkRegistry: BookmarkRegistry;
+//# sourceMappingURL=bookmarkRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bookmarkRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/bookmarkRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,OAAO,CAAK;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASvD;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM;IAkB5D;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC;;OAEG;IACH,MAAM,IAAI,YAAY,EAAE;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAStD;AAGD,eAAO,MAAM,sBAAsB,kBAAyB,CAAC"}

package/dist/utils/docxImagePositioning.d.ts

@@ -0,0 +1,18 @@
+import type { ImageProps } from '../types';
+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): any | undefined;
+//# sourceMappingURL=docxImagePositioning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docxImagePositioning.d.ts","sourceRoot":"","sources":["../../src/utils/docxImagePositioning.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,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,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,GAAG,GAAG,SAAS,CAyH7E"}

package/dist/utils/environment.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Environment detection utilities
+ */
+/**
+ * Check if the current environment is Node.js
+ * This is used to conditionally load Node.js-only modules
+ */
+export declare function isNodeEnvironment(): boolean;
+/**
+ * Check if Node.js built-in modules are available
+ * More specific check for modules that require Node.js built-ins
+ */
+export declare function hasNodeBuiltins(): boolean;
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/utils/environment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAQ3C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAazC"}

package/dist/utils/exampleRunner.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Universal example runner utility
+ * Provides common functionality for running examples
+ */
+import { ReportComponentDefinition } from '../types';
+export interface ExampleRunnerOptions {
+    outputFilename?: string;
+    outputDir?: string;
+    verbose?: boolean;
+}
+/**
+ * Run an example and generate a document
+ * @param example - The example definition to run
+ * @param options - Options for running the example
+ */
+export declare function runExample(example: ReportComponentDefinition, options?: ExampleRunnerOptions): Promise<void>;
+//# sourceMappingURL=exampleRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exampleRunner.d.ts","sourceRoot":"","sources":["../../src/utils/exampleRunner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAIrD,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/utils/fixFloatingImageIds.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Post-processing utility to fix docx.js floating image bugs
+ *
+ * The docx library (as of v9.5.1) has a known issue with floating images:
+ * 1. Duplicate wp:docPr IDs (GitHub issue #2719)
+ *
+ * Historical note: We previously also post-processed relativeHeight and
+ * wrapTight elements. Those steps were removed because we always provide a
+ * valid zIndex upstream and we do not support 'tight' wrapping.
+ *
+ * This utility extracts the DOCX, fixes duplicate IDs, and re-packages it.
+ */
+/**
+ * Fix floating image issues in a generated DOCX file
+ * @param docxPath - Path to the DOCX file to fix
+ */
+export declare function fixFloatingImageIds(docxPath: string): Promise<void>;
+//# sourceMappingURL=fixFloatingImageIds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixFloatingImageIds.d.ts","sourceRoot":"","sources":["../../src/utils/fixFloatingImageIds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCzE"}

package/dist/utils/formatters.d.ts

@@ -0,0 +1,2 @@
+export declare const formatDate: (date: Date, formatString?: string) => string;
+//# sourceMappingURL=formatters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,SACf,IAAI,iBACI,MAAM,KACnB,MAEF,CAAC"}

package/dist/utils/imageUtils.d.ts

@@ -0,0 +1,84 @@
+/// <reference types="node" />
+export interface ImageDimensions {
+    width: number;
+    height: number;
+}
+export interface CalculatedDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * Parse width value - accepts either number (pixels) or percentage string
+ * @param width - Width value as number or percentage string (e.g., "90%")
+ * @param availableWidthPx - Available document width in pixels
+ * @returns Width in pixels
+ */
+export declare function parseWidthValue(width: number | string, availableWidthPx: number): number;
+/**
+ * Parse a generic dimension value (number in px or percentage string)
+ * @param value - numeric pixels or percentage string (e.g., "100%")
+ * @param availablePx - available pixels for percentage reference
+ */
+export declare function parseDimensionValue(value: number | string, availablePx: number): number;
+/**
+ * Check if a string is a valid URL
+ */
+export declare function isValidUrl(string: string): boolean;
+/**
+ * Check if a string is a base64 data URI
+ * Supports format: data:image/[type];base64,[data]
+ */
+export declare function isBase64Image(string: string): boolean;
+/**
+ * Decode base64 data URI to Buffer
+ * @param dataUri - Base64 data URI (e.g., "data:image/png;base64,iVBORw0KGgo...")
+ * @returns Decoded image buffer
+ */
+export declare function decodeBase64Image(dataUri: string): Buffer;
+/**
+ * Extract MIME type from base64 data URI
+ * @param dataUri - Base64 data URI (e.g., "data:image/svg+xml;base64,...")
+ * @returns MIME type (e.g., "image/svg+xml") or undefined if not found
+ */
+export declare function extractMimeTypeFromDataUri(dataUri: string): string | undefined;
+/**
+ * Detect image type from file extension
+ * @param path - File path or URL
+ * @returns Image type (jpg, png, gif, bmp, svg) or undefined
+ */
+export declare function detectImageTypeFromExtension(path: string): 'jpg' | 'png' | 'gif' | 'bmp' | 'svg' | undefined;
+/**
+ * Detect image type from MIME type
+ * @param mimeType - MIME type string (e.g., "image/svg+xml", "image/png")
+ * @returns Image type (jpg, png, gif, bmp, svg) or undefined
+ */
+export declare function detectImageTypeFromMimeType(mimeType: string): 'jpg' | 'png' | 'gif' | 'bmp' | 'svg' | undefined;
+/**
+ * Detect image type from path or base64 data URI
+ * Prioritizes: MIME type from base64 > file extension > default to 'png'
+ * @param imagePath - File path, URL, or base64 data URI
+ * @returns Image type (jpg, png, gif, bmp, svg)
+ */
+export declare function detectImageType(imagePath: string): 'jpg' | 'png' | 'gif' | 'bmp' | 'svg';
+/**
+ * Download image from URL and return buffer
+ * Uses native fetch with automatic redirect following and proper headers
+ */
+export declare function downloadImageFromUrl(url: string): Promise<Buffer>;
+/**
+ * Get image buffer from base64 data URI, URL, or local file
+ */
+export declare function getImageBuffer(imagePath: string): Promise<Buffer>;
+/**
+ * Get the dimensions of an image file or URL
+ */
+export declare function getImageDimensions(imagePath: string): Promise<ImageDimensions>;
+/**
+ * Calculate missing dimension while preserving aspect ratio
+ */
+export declare function calculateMissingDimension(originalWidth: number, originalHeight: number, targetWidth?: number, targetHeight?: number): CalculatedDimensions;
+/**
+ * Calculate image dimensions with aspect ratio preservation and fallback constraints
+ */
+export declare function calculateImageDimensions(imagePath: string, targetWidth?: number, targetHeight?: number, fallbackWidth?: number, fallbackHeight?: number): Promise<CalculatedDimensions>;
+//# sourceMappingURL=imageUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imageUtils.d.ts","sourceRoot":"","sources":["../../src/utils/imageUtils.ts"],"names":[],"mappings":";AAIA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAuBR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAazD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAGpB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAiBnD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,GACf,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAQnD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAChB,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAgBvC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCvE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWvE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,oBAAoB,CA0BtB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,GAAE,MAAY,EAC3B,cAAc,GAAE,MAAY,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA+B/B"}

package/dist/utils/numberingConfig.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Numbering Configuration Utilities
+ * Utilities for creating and managing docx numbering configurations
+ */
+import type { ILevelsOptions } from 'docx';
+export interface ListLevelConfig {
+    level: number;
+    format?: string;
+    text?: string;
+    alignment?: string;
+    indent?: {
+        left?: number;
+        hanging?: number;
+    };
+    start?: number;
+}
+export interface NumberingConfig {
+    reference: string;
+    levels: ListLevelConfig[];
+}
+/**
+ * Create numbering configuration from list config
+ * Returns a single config item that can be added to INumberingOptions.config array
+ */
+export declare function createNumberingConfig(config: NumberingConfig): {
+    levels: ILevelsOptions[];
+    reference: string;
+};
+/**
+ * Create a simple bullet list configuration
+ */
+export declare function createBulletListConfig(reference: string, bullet?: string): {
+    levels: ILevelsOptions[];
+    reference: string;
+};
+/**
+ * Create a simple numbered list configuration
+ */
+export declare function createNumberedListConfig(reference: string, start?: number): {
+    levels: ILevelsOptions[];
+    reference: string;
+};
+/**
+ * Registry for managing numbering configurations
+ */
+export declare class NumberingRegistry {
+    private configs;
+    private counter;
+    /**
+     * Register a numbering configuration
+     */
+    register(config: {
+        levels: ILevelsOptions[];
+        reference: string;
+    }): string;
+    /**
+     * Generate a unique reference ID
+     */
+    generateReference(prefix?: string): string;
+    /**
+     * Get all registered configurations as an array suitable for INumberingOptions
+     */
+    getAll(): {
+        levels: ILevelsOptions[];
+        reference: string;
+    }[];
+    /**
+     * Clear all configurations
+     */
+    clear(): void;
+    /**
+     * Check if a reference exists
+     */
+    has(reference: string): boolean;
+    /**
+     * Get a configuration by reference
+     */
+    get(reference: string): {
+        levels: ILevelsOptions[];
+        reference: string;
+    } | undefined;
+}
+export declare const globalNumberingRegistry: NumberingRegistry;
+//# sourceMappingURL=numberingConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numberingConfig.d.ts","sourceRoot":"","sources":["../../src/utils/numberingConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAgF3C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAiDD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG;IAC9D,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CA8CA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAY,GACnB;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CASjD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAU,GAChB;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CASjD;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAGD;IACd,OAAO,CAAC,OAAO,CAAK;IAEpB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAMzE;;OAEG;IACH,iBAAiB,CAAC,MAAM,GAAE,MAAe,GAAG,MAAM;IAIlD;;OAEG;IACH,MAAM,IAAI;QAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE;IAI3D;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,GAAG,CACD,SAAS,EAAE,MAAM,GAChB;QAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;CAG/D;AAGD,eAAO,MAAM,uBAAuB,mBAA0B,CAAC"}

package/dist/utils/placeholderImage.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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

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