dynamic-docx-generator 1.0.0

package/dist/DocxGenerator.js

@@ -0,0 +1,365 @@
+"use strict";
+/**
+ * DocxGenerator - Main class for dynamic DOCX document generation
+ *
+ * @example
+ * ```typescript
+ * const generator = new DocxGenerator();
+ * await generator.loadTemplate('./template.docx');
+ * generator.setData({ name: 'John', company: 'Acme' });
+ * await generator.save('./output.docx');
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocxGenerator = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const string_1 = require("./utils/string");
+const xml_1 = require("./utils/xml");
+const image_1 = require("./utils/image");
+const constants_1 = require("./utils/constants");
+class DocxGenerator {
+    /**
+     * Create a new DocxGenerator instance
+     * @param options - Configuration options
+     */
+    constructor(options = {}) {
+        this.zip = null;
+        this.templateLoaded = false;
+        this.data = {};
+        this.headerData = {};
+        this.footerData = {};
+        this.images = [];
+        this.tables = [];
+        this.options = options;
+        this.tempDir = options.tempDir || os.tmpdir();
+    }
+    /**
+     * Load a DOCX template from file path or buffer
+     * @param source - Path to template file or Buffer containing template
+     * @returns this for method chaining
+     */
+    async loadTemplate(source) {
+        try {
+            if (typeof source === 'string') {
+                // Load from file path
+                if (!fs.existsSync(source)) {
+                    throw new Error(`Template file not found: ${source}`);
+                }
+                this.zip = new adm_zip_1.default(source);
+            }
+            else {
+                // Load from buffer
+                this.zip = new adm_zip_1.default(source);
+            }
+            this.templateLoaded = true;
+            return this;
+        }
+        catch (error) {
+            throw new Error(`Failed to load template: ${error.message}`);
+        }
+    }
+    /**
+     * Set placeholder data for document body
+     * @param data - Key-value pairs where key is placeholder name and value is replacement text
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * generator.setData({
+     *   companyName: 'Acme Corp',
+     *   productName: 'Widget Pro',
+     *   date: '2026-01-09'
+     * });
+     * ```
+     */
+    setData(data) {
+        this.data = { ...this.data, ...data };
+        return this;
+    }
+    /**
+     * Set placeholder data for document header
+     * @param data - Key-value pairs for header placeholders
+     * @returns this for method chaining
+     */
+    setHeader(data) {
+        this.headerData = { ...this.headerData, ...data };
+        return this;
+    }
+    /**
+     * Set placeholder data for document footer
+     * @param data - Key-value pairs for footer placeholders
+     * @returns this for method chaining
+     */
+    setFooter(data) {
+        this.footerData = { ...this.footerData, ...data };
+        return this;
+    }
+    /**
+     * Add images to be inserted into the document
+     * @param images - Array of image configurations
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * generator.setImages([
+     *   { placeholder: '{{logo}}', path: './logo.png', width: 200 }
+     * ]);
+     * ```
+     */
+    setImages(images) {
+        this.images = [...this.images, ...images];
+        return this;
+    }
+    /**
+     * Add a dynamic table to the document
+     * @param config - Table configuration
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * generator.addTable({
+     *   placeholder: '{{itemsTable}}',
+     *   headers: [
+     *     { name: 'Item', key: 'item', width: 3000 },
+     *     { name: 'Quantity', key: 'qty', width: 1500 }
+     *   ],
+     *   rows: [['Widget A', '10'], ['Widget B', '5']]
+     * });
+     * ```
+     */
+    addTable(config) {
+        this.tables.push(config);
+        return this;
+    }
+    /**
+     * Process placeholders in XML content
+     */
+    processPlaceholders(content, data) {
+        let result = content;
+        for (const [key, value] of Object.entries(data)) {
+            result = (0, string_1.replacePlaceholder)(result, key, value);
+        }
+        // Fix any double escaping issues
+        result = (0, string_1.fixDoubleEscaping)(result);
+        return result;
+    }
+    /**
+     * Process tables in XML content
+     */
+    processTables(content) {
+        let result = content;
+        for (const table of this.tables) {
+            const headers = table.headers.map(h => ({
+                name: h.name,
+                width: h.width
+            }));
+            const style = {
+                ...constants_1.DEFAULT_TABLE_STYLE,
+                ...table.style
+            };
+            const tableXml = (0, constants_1.generateTable)(headers, table.rows, style);
+            // Replace placeholder with table
+            result = (0, string_1.replaceAll)(result, table.placeholder, tableXml);
+            result = (0, string_1.replaceAll)(result, `{{${table.placeholder}}}`, tableXml);
+        }
+        return result;
+    }
+    /**
+     * Process images and add them to the document
+     */
+    async processImages() {
+        if (!this.zip || this.images.length === 0) {
+            return [];
+        }
+        // Get existing relationship IDs
+        const relsEntry = this.zip.getEntry('word/_rels/document.xml.rels');
+        const relsContent = relsEntry ? relsEntry.getData().toString('utf8') : '';
+        const existingIds = (0, xml_1.extractRelationshipIds)(relsContent);
+        // Prepare all images
+        const preparedImages = [];
+        for (let i = 0; i < this.images.length; i++) {
+            const prepared = await (0, image_1.prepareImage)(this.images[i], i, [
+                ...existingIds,
+                ...preparedImages.map(p => p.id)
+            ]);
+            preparedImages.push(prepared);
+        }
+        return preparedImages;
+    }
+    /**
+     * Update document relationships with images
+     */
+    updateRelationships(images) {
+        if (!this.zip || images.length === 0)
+            return;
+        // Update document.xml.rels
+        const relsPath = 'word/_rels/document.xml.rels';
+        const relsEntry = this.zip.getEntry(relsPath);
+        if (relsEntry) {
+            let relsContent = relsEntry.getData().toString('utf8');
+            for (const image of images) {
+                relsContent = (0, xml_1.addRelationship)(relsContent, image.relationshipXml);
+            }
+            this.zip.updateFile(relsPath, Buffer.from(relsContent, 'utf8'));
+        }
+        // Update [Content_Types].xml for image types
+        const contentTypesPath = '[Content_Types].xml';
+        const contentTypesEntry = this.zip.getEntry(contentTypesPath);
+        if (contentTypesEntry) {
+            let contentTypesXml = contentTypesEntry.getData().toString('utf8');
+            const extensions = new Set(images.map(img => img.extension));
+            for (const ext of extensions) {
+                contentTypesXml = (0, xml_1.addContentType)(contentTypesXml, ext, (0, xml_1.getImageContentType)(ext));
+            }
+            this.zip.updateFile(contentTypesPath, Buffer.from(contentTypesXml, 'utf8'));
+        }
+    }
+    /**
+     * Add image files to the media folder
+     */
+    addImageFiles(images) {
+        if (!this.zip || images.length === 0)
+            return;
+        // Ensure media folder exists
+        for (const image of images) {
+            this.zip.addFile(`word/media/${image.fileName}`, image.buffer);
+        }
+    }
+    /**
+     * Replace image placeholders in document content
+     */
+    replaceImagePlaceholders(content, images) {
+        let result = content;
+        for (const image of images) {
+            // Replace {{placeholder}} with image XML
+            result = (0, string_1.replaceAll)(result, image.placeholder, image.inlineXml);
+            result = (0, string_1.replaceAll)(result, `{{${image.placeholder}}}`, image.inlineXml);
+        }
+        return result;
+    }
+    /**
+     * Generate the final DOCX document as a Buffer
+     * @returns Buffer containing the generated DOCX file
+     */
+    async generate() {
+        if (!this.templateLoaded || !this.zip) {
+            throw new Error('No template loaded. Call loadTemplate() first.');
+        }
+        try {
+            // Process images first
+            const preparedImages = await this.processImages();
+            // Process document.xml
+            const documentPath = 'word/document.xml';
+            const documentEntry = this.zip.getEntry(documentPath);
+            if (documentEntry) {
+                let documentXml = documentEntry.getData().toString('utf8');
+                // Replace placeholders
+                documentXml = this.processPlaceholders(documentXml, this.data);
+                // Replace tables
+                documentXml = this.processTables(documentXml);
+                // Replace image placeholders
+                documentXml = this.replaceImagePlaceholders(documentXml, preparedImages);
+                this.zip.updateFile(documentPath, Buffer.from(documentXml, 'utf8'));
+            }
+            // Process header files
+            const headerFiles = this.zip.getEntries()
+                .filter(entry => entry.entryName.match(/word\/header\d+\.xml/));
+            for (const headerEntry of headerFiles) {
+                let headerXml = headerEntry.getData().toString('utf8');
+                headerXml = this.processPlaceholders(headerXml, { ...this.data, ...this.headerData });
+                headerXml = this.replaceImagePlaceholders(headerXml, preparedImages);
+                this.zip.updateFile(headerEntry.entryName, Buffer.from(headerXml, 'utf8'));
+            }
+            // Process footer files
+            const footerFiles = this.zip.getEntries()
+                .filter(entry => entry.entryName.match(/word\/footer\d+\.xml/));
+            for (const footerEntry of footerFiles) {
+                let footerXml = footerEntry.getData().toString('utf8');
+                footerXml = this.processPlaceholders(footerXml, { ...this.data, ...this.footerData });
+                footerXml = this.replaceImagePlaceholders(footerXml, preparedImages);
+                this.zip.updateFile(footerEntry.entryName, Buffer.from(footerXml, 'utf8'));
+            }
+            // Add images to document
+            if (preparedImages.length > 0) {
+                this.updateRelationships(preparedImages);
+                this.addImageFiles(preparedImages);
+            }
+            // Generate the final buffer
+            return this.zip.toBuffer();
+        }
+        catch (error) {
+            throw new Error(`Failed to generate document: ${error.message}`);
+        }
+    }
+    /**
+     * Save the generated document to a file
+     * @param outputPath - Path where the document should be saved
+     */
+    async save(outputPath) {
+        const buffer = await this.generate();
+        // Ensure directory exists
+        const dir = path.dirname(outputPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        await fs.promises.writeFile(outputPath, buffer);
+    }
+    /**
+     * Reset the generator state (keeps template loaded)
+     */
+    reset() {
+        this.data = {};
+        this.headerData = {};
+        this.footerData = {};
+        this.images = [];
+        this.tables = [];
+        return this;
+    }
+    /**
+     * Check if a template has been loaded
+     */
+    isTemplateLoaded() {
+        return this.templateLoaded;
+    }
+}
+exports.DocxGenerator = DocxGenerator;
+//# sourceMappingURL=DocxGenerator.js.map

package/dist/DocxGenerator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * dynamic-docx-generator
+ *
+ * Generate dynamic DOCX documents from templates with placeholder replacement,
+ * tables, and images.
+ *
+ * @packageDocumentation
+ */
+export { DocxGenerator } from './DocxGenerator';
+export * from './types';
+export * as StringUtils from './utils/string';
+export * as XmlUtils from './utils/xml';
+export * as ImageUtils from './utils/image';
+export { generateTable, generateInlineImage, DEFAULT_TABLE_STYLE, escapeXml } from './utils/constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,EACH,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACZ,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * dynamic-docx-generator
+ *
+ * Generate dynamic DOCX documents from templates with placeholder replacement,
+ * tables, and images.
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeXml = exports.DEFAULT_TABLE_STYLE = exports.generateInlineImage = exports.generateTable = exports.ImageUtils = exports.XmlUtils = exports.StringUtils = exports.DocxGenerator = void 0;
+// Main class
+var DocxGenerator_1 = require("./DocxGenerator");
+Object.defineProperty(exports, "DocxGenerator", { enumerable: true, get: function () { return DocxGenerator_1.DocxGenerator; } });
+// Types
+__exportStar(require("./types"), exports);
+// Utilities (for advanced usage)
+exports.StringUtils = __importStar(require("./utils/string"));
+exports.XmlUtils = __importStar(require("./utils/xml"));
+exports.ImageUtils = __importStar(require("./utils/image"));
+var constants_1 = require("./utils/constants");
+Object.defineProperty(exports, "generateTable", { enumerable: true, get: function () { return constants_1.generateTable; } });
+Object.defineProperty(exports, "generateInlineImage", { enumerable: true, get: function () { return constants_1.generateInlineImage; } });
+Object.defineProperty(exports, "DEFAULT_TABLE_STYLE", { enumerable: true, get: function () { return constants_1.DEFAULT_TABLE_STYLE; } });
+Object.defineProperty(exports, "escapeXml", { enumerable: true, get: function () { return constants_1.escapeXml; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,aAAa;AACb,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,QAAQ;AACR,0CAAwB;AAExB,iCAAiC;AACjC,8DAA8C;AAC9C,wDAAwC;AACxC,4DAA4C;AAC5C,+CAK2B;AAJvB,0GAAA,aAAa,OAAA;AACb,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,sGAAA,SAAS,OAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Configuration options for DocxGenerator
+ */
+export interface GeneratorOptions {
+    /** Custom temporary directory for processing */
+    tempDir?: string;
+}
+/**
+ * Configuration for an image to be inserted into the document
+ */
+export interface ImageConfig {
+    /** The placeholder text in the template to replace (e.g., "{{logo}}") */
+    placeholder: string;
+    /** Path to the image file */
+    path?: string;
+    /** Image data as a Buffer */
+    buffer?: Buffer;
+    /** URL to download the image from */
+    url?: string;
+    /** Width of the image in EMUs (914400 EMUs = 1 inch). Default: 914400 */
+    width?: number;
+    /** Height of the image in EMUs (914400 EMUs = 1 inch). Default: auto */
+    height?: number;
+    /** Unique ID for the image relationship */
+    id?: string;
+}
+/**
+ * Table styling options
+ */
+export interface TableStyle {
+    /** Header row background color (hex without #) */
+    headerBgColor?: string;
+    /** Header text color (hex without #) */
+    headerTextColor?: string;
+    /** Border color (hex without #) */
+    borderColor?: string;
+    /** Font size in half-points (24 = 12pt) */
+    fontSize?: number;
+    /** Font family */
+    fontFamily?: string;
+}
+/**
+ * Configuration for a dynamic table
+ */
+export interface TableConfig {
+    /** The placeholder text in the template to replace */
+    placeholder: string;
+    /** Array of header column names */
+    headers: TableHeader[];
+    /** 2D array of row data */
+    rows: string[][];
+    /** Optional styling */
+    style?: TableStyle;
+}
+/**
+ * Table header configuration
+ */
+export interface TableHeader {
+    /** Header display name */
+    name: string;
+    /** Data key for mapping */
+    key: string;
+    /** Column width in twips (1440 twips = 1 inch) */
+    width?: number;
+}
+/**
+ * Placeholder data for simple text replacement
+ */
+export type PlaceholderData = Record<string, string>;
+/**
+ * Result of document generation
+ */
+export interface GenerationResult {
+    /** Whether generation was successful */
+    success: boolean;
+    /** Output file path or buffer */
+    output?: string | Buffer;
+    /** Error message if failed */
+    error?: string;
+}
+//# 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":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,uBAAuB;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/constants.d.ts

@@ -0,0 +1,44 @@
+/**
+ * XML template constants for Office Open XML (OOXML) DOCX format
+ */
+/**
+ * Generate XML for image relationship entry in .rels file
+ */
+export declare const generateImageRelationship: (imageId: string, imageName: string) => string;
+/**
+ * Generate XML for inline image in document
+ */
+export declare const generateInlineImage: (imageId: string, width?: number, height?: number, name?: string) => string;
+/**
+ * Default table style values
+ */
+export declare const DEFAULT_TABLE_STYLE: {
+    headerBgColor: string;
+    headerTextColor: string;
+    borderColor: string;
+    fontSize: number;
+    fontFamily: string;
+};
+/**
+ * Generate table header row XML
+ */
+export declare const generateTableHeaderRow: (headers: {
+    name: string;
+    width?: number;
+}[], style?: typeof DEFAULT_TABLE_STYLE) => string;
+/**
+ * Generate a single table data row XML
+ */
+export declare const generateTableDataRow: (cells: string[], widths: number[], style?: typeof DEFAULT_TABLE_STYLE) => string;
+/**
+ * Generate complete table XML
+ */
+export declare const generateTable: (headers: {
+    name: string;
+    width?: number;
+}[], rows: string[][], style?: typeof DEFAULT_TABLE_STYLE) => string;
+/**
+ * Escape special XML characters
+ */
+export declare const escapeXml: (text: string) => string;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,EAAE,WAAW,MAAM,KAAG,MAE9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC5B,SAAS,MAAM,EACf,QAAO,MAAe,EACtB,SAAQ,MAAe,EACvB,OAAM,MAAkB,KACzB,MAoCF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;CAM/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAC/B,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3C,QAAO,OAAO,mBAAyC,KACxD,MAyCF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC7B,OAAO,MAAM,EAAE,EACf,QAAQ,MAAM,EAAE,EAChB,QAAO,OAAO,mBAAyC,KACxD,MAmCF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GACtB,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3C,MAAM,MAAM,EAAE,EAAE,EAChB,QAAO,OAAO,mBAAyC,KACxD,MA8BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAQxC,CAAC"}