docxmlater 0.28.0 → 0.29.0

package/dist/core/Document.js

@@ -41,16 +41,17 @@ const Table_1 = require("../elements/Table");
 const TableCell_1 = require("../elements/TableCell");
 const Section_1 = require("../elements/Section");
 const ImageManager_1 = require("../elements/ImageManager");
+const ImageRun_1 = require("../elements/ImageRun");
 const HeaderFooterManager_1 = require("../elements/HeaderFooterManager");
 const TableOfContents_1 = require("../elements/TableOfContents");
 const TableOfContentsElement_1 = require("../elements/TableOfContentsElement");
+const Bookmark_1 = require("../elements/Bookmark");
 const BookmarkManager_1 = require("../elements/BookmarkManager");
 const Revision_1 = require("../elements/Revision");
 const RevisionManager_1 = require("../elements/RevisionManager");
 const CommentManager_1 = require("../elements/CommentManager");
 const FootnoteManager_1 = require("../elements/FootnoteManager");
 const EndnoteManager_1 = require("../elements/EndnoteManager");
-const Run_1 = require("../elements/Run");
 const Hyperlink_1 = require("../elements/Hyperlink");
 const XMLParser_1 = require("../xml/XMLParser");
 const StylesManager_1 = require("../formatting/StylesManager");
@@ -61,24 +62,11 @@ const DocumentParser_1 = require("./DocumentParser");
 const DocumentGenerator_1 = require("./DocumentGenerator");
 const DocumentValidator_1 = require("./DocumentValidator");
 const logger_1 = require("../utils/logger");
-class ImageRun extends Run_1.Run {
-    imageElement;
-    constructor(image) {
-        super('');
-        this.imageElement = image;
-    }
-    toXML() {
-        const drawing = this.imageElement.toXML();
-        return {
-            name: 'w:r',
-            children: [drawing]
-        };
-    }
-}
 class Document {
     zipHandler;
     bodyElements = [];
     properties;
+    namespaces = {};
     stylesManager;
     numberingManager;
     section;
@@ -106,7 +94,9 @@ class Document {
             maxRssMB: options.maxRssMB,
             useAbsoluteLimit: options.useAbsoluteMemoryLimit,
         });
-        this.properties = options.properties ? DocumentValidator_1.DocumentValidator.validateProperties(options.properties) : {};
+        this.properties = options.properties
+            ? DocumentValidator_1.DocumentValidator.validateProperties(options.properties)
+            : {};
         this.stylesManager = StylesManager_1.StylesManager.create();
         this.numberingManager = NumberingManager_1.NumberingManager.create();
         this.section = Section_1.Section.createLetter();
@@ -152,21 +142,40 @@ class Document {
     initializeRequiredFiles() {
         this.zipHandler.addFile(types_1.DOCX_PATHS.CONTENT_TYPES, this.generator.generateContentTypes());
         this.zipHandler.addFile(types_1.DOCX_PATHS.RELS, this.generator.generateRels());
-        this.zipHandler.addFile(types_1.DOCX_PATHS.DOCUMENT, this.generator.generateDocumentXml(this.bodyElements, this.section));
-        this.zipHandler.addFile('word/_rels/document.xml.rels', this.relationshipManager.generateXml());
+        this.zipHandler.addFile(types_1.DOCX_PATHS.DOCUMENT, this.generator.generateDocumentXml(this.bodyElements, this.section, this.namespaces));
+        this.zipHandler.addFile("word/_rels/document.xml.rels", this.relationshipManager.generateXml());
         this.zipHandler.addFile(types_1.DOCX_PATHS.STYLES, this.stylesManager.generateStylesXml());
         this.zipHandler.addFile(types_1.DOCX_PATHS.NUMBERING, this.numberingManager.generateNumberingXml());
-        this.zipHandler.addFile('word/fontTable.xml', this.generator.generateFontTable());
-        this.zipHandler.addFile('word/settings.xml', this.generator.generateSettings());
-        this.zipHandler.addFile('word/theme/theme1.xml', this.generator.generateTheme());
+        this.zipHandler.addFile("word/fontTable.xml", this.generator.generateFontTable());
+        this.zipHandler.addFile("word/settings.xml", this.generator.generateSettings());
+        this.zipHandler.addFile("word/theme/theme1.xml", this.generator.generateTheme());
         this.zipHandler.addFile(types_1.DOCX_PATHS.CORE_PROPS, this.generator.generateCoreProps(this.properties));
         this.zipHandler.addFile(types_1.DOCX_PATHS.APP_PROPS, this.generator.generateAppProps());
     }
     async parseDocument() {
-        const result = await this.parser.parseDocument(this.zipHandler, this.relationshipManager);
+        const result = await this.parser.parseDocument(this.zipHandler, this.relationshipManager, this.imageManager);
         this.bodyElements = result.bodyElements;
         this.properties = result.properties;
         this.relationshipManager = result.relationshipManager;
+        this.namespaces = result.namespaces;
+        if (result.section) {
+            this.section = result.section;
+        }
+        if (result.styles && result.styles.length > 0) {
+            for (const style of result.styles) {
+                this.stylesManager.addStyle(style);
+            }
+        }
+        if (result.abstractNumberings && result.abstractNumberings.length > 0) {
+            for (const abstractNum of result.abstractNumberings) {
+                this.numberingManager.addAbstractNumbering(abstractNum);
+            }
+        }
+        if (result.numberingInstances && result.numberingInstances.length > 0) {
+            for (const instance of result.numberingInstances) {
+                this.numberingManager.addInstance(instance);
+            }
+        }
     }
     addParagraph(paragraph) {
         this.bodyElements.push(paragraph);
@@ -258,12 +267,12 @@ class Document {
             this.updateRelationships();
             this.updateContentTypesWithImagesHeadersFootersAndComments();
             await this.zipHandler.save(tempPath);
-            const { promises: fs } = await Promise.resolve().then(() => __importStar(require('fs')));
+            const { promises: fs } = await Promise.resolve().then(() => __importStar(require("fs")));
             await fs.rename(tempPath, filePath);
         }
         catch (error) {
             try {
-                const { promises: fs } = await Promise.resolve().then(() => __importStar(require('fs')));
+                const { promises: fs } = await Promise.resolve().then(() => __importStar(require("fs")));
                 await fs.unlink(tempPath);
             }
             catch {
@@ -307,7 +316,7 @@ class Document {
         }
     }
     updateDocumentXml() {
-        const xml = this.generator.generateDocumentXml(this.bodyElements, this.section);
+        const xml = this.generator.generateDocumentXml(this.bodyElements, this.section, this.namespaces);
         this.zipHandler.updateFile(types_1.DOCX_PATHS.DOCUMENT, xml);
     }
     updateCoreProps() {
@@ -348,11 +357,409 @@ class Document {
             return false;
         }
         const currentProps = style.getProperties();
-        const updatedProps = { ...currentProps, ...properties, styleId };
+        const updatedProps = {
+            ...currentProps,
+            ...properties,
+            styleId,
+            paragraphFormatting: properties.paragraphFormatting
+                ? {
+                    ...currentProps.paragraphFormatting,
+                    ...properties.paragraphFormatting,
+                    spacing: properties.paragraphFormatting.spacing
+                        ? {
+                            ...currentProps.paragraphFormatting?.spacing,
+                            ...properties.paragraphFormatting.spacing,
+                        }
+                        : currentProps.paragraphFormatting?.spacing,
+                    indentation: properties.paragraphFormatting.indentation
+                        ? {
+                            ...currentProps.paragraphFormatting?.indentation,
+                            ...properties.paragraphFormatting.indentation,
+                        }
+                        : currentProps.paragraphFormatting?.indentation,
+                }
+                : currentProps.paragraphFormatting,
+            runFormatting: properties.runFormatting
+                ? { ...currentProps.runFormatting, ...properties.runFormatting }
+                : currentProps.runFormatting,
+        };
         const updatedStyle = Style_1.Style.create(updatedProps);
         this.stylesManager.addStyle(updatedStyle);
         return true;
     }
+    applyStyleToAll(styleId, predicate) {
+        let count = 0;
+        for (const element of this.bodyElements) {
+            if (predicate(element)) {
+                if (element instanceof Paragraph_1.Paragraph) {
+                    element.setStyle(styleId);
+                    count++;
+                }
+            }
+        }
+        for (const table of this.getTables()) {
+            for (const row of table.getRows()) {
+                for (const cell of row.getCells()) {
+                    for (const para of cell.getParagraphs()) {
+                        if (predicate(para)) {
+                            para.setStyle(styleId);
+                            count++;
+                        }
+                    }
+                }
+            }
+        }
+        return count;
+    }
+    findElementsByStyle(styleId) {
+        const results = [];
+        for (const element of this.bodyElements) {
+            if (element instanceof Paragraph_1.Paragraph) {
+                const formatting = element.getFormatting();
+                if (formatting.style === styleId) {
+                    results.push(element);
+                }
+            }
+        }
+        for (const table of this.getTables()) {
+            for (const row of table.getRows()) {
+                for (const cell of row.getCells()) {
+                    for (const para of cell.getParagraphs()) {
+                        const formatting = para.getFormatting();
+                        if (formatting.style === styleId) {
+                            results.push(para);
+                        }
+                    }
+                    const hasStyledParagraph = cell
+                        .getParagraphs()
+                        .some((p) => p.getFormatting().style === styleId);
+                    if (hasStyledParagraph) {
+                        results.push(cell);
+                    }
+                }
+            }
+        }
+        return results;
+    }
+    applyStyleToAllParagraphsWithStyle(currentStyleId, newStyleId) {
+        let count = 0;
+        for (const element of this.bodyElements) {
+            if (element instanceof Paragraph_1.Paragraph) {
+                const formatting = element.getFormatting();
+                if (formatting.style === currentStyleId) {
+                    element.setStyle(newStyleId);
+                    count++;
+                }
+            }
+        }
+        for (const table of this.getTables()) {
+            for (const row of table.getRows()) {
+                for (const cell of row.getCells()) {
+                    for (const para of cell.getParagraphs()) {
+                        const formatting = para.getFormatting();
+                        if (formatting.style === currentStyleId) {
+                            para.setStyle(newStyleId);
+                            count++;
+                        }
+                    }
+                }
+            }
+        }
+        return count;
+    }
+    applyStyleToAllParagraphs(styleId, options) {
+        let count = 0;
+        const clearFormatting = options?.clearFormatting || false;
+        const clearProperties = options?.clearProperties;
+        const currentStyleId = options?.currentStyleId;
+        const applyToParagraph = (para) => {
+            const formatting = para.getFormatting();
+            if (currentStyleId !== undefined && formatting.style !== currentStyleId) {
+                return;
+            }
+            if (clearFormatting) {
+                para.applyStyleAndClearFormatting(styleId, clearProperties === undefined ? [] : clearProperties);
+            }
+            else {
+                para.setStyle(styleId);
+            }
+            count++;
+        };
+        for (const element of this.bodyElements) {
+            if (element instanceof Paragraph_1.Paragraph) {
+                applyToParagraph(element);
+            }
+        }
+        for (const table of this.getTables()) {
+            for (const row of table.getRows()) {
+                for (const cell of row.getCells()) {
+                    for (const para of cell.getParagraphs()) {
+                        applyToParagraph(para);
+                    }
+                }
+            }
+        }
+        return count;
+    }
+    updateAllHyperlinkColors(color) {
+        const hyperlinks = this.getHyperlinks();
+        for (const { hyperlink } of hyperlinks) {
+            const currentFormatting = hyperlink.getFormatting();
+            hyperlink.setFormatting({
+                ...currentFormatting,
+                color: color,
+            });
+        }
+        return hyperlinks.length;
+    }
+    setAllTablesLayout(layout) {
+        const tables = this.getTables();
+        for (const table of tables) {
+            table.setLayout(layout);
+        }
+        return tables.length;
+    }
+    applyTableFormattingBySize(singleCellShading, multiCellFirstRowShading) {
+        const tables = this.getTables();
+        let singleCellCount = 0;
+        let multiCellCount = 0;
+        for (const table of tables) {
+            const rowCount = table.getRowCount();
+            const colCount = table.getColumnCount();
+            if (rowCount === 1 && colCount === 1) {
+                const cell = table.getCell(0, 0);
+                if (cell) {
+                    cell.setShading({ fill: singleCellShading });
+                    singleCellCount++;
+                }
+            }
+            else {
+                const firstRow = table.getRow(0);
+                if (firstRow) {
+                    for (const cell of firstRow.getCells()) {
+                        cell.setShading({ fill: multiCellFirstRowShading });
+                    }
+                    multiCellCount++;
+                }
+            }
+        }
+        return { singleCellCount, multiCellCount };
+    }
+    fixTODHyperlinks() {
+        let count = 0;
+        if (!this.hasBookmark("_top")) {
+            const paragraphs = this.getParagraphs();
+            if (paragraphs.length > 0) {
+                const firstPara = paragraphs[0];
+                if (firstPara) {
+                    const bookmark = new Bookmark_1.Bookmark({ name: "_top" });
+                    const registered = this.bookmarkManager.register(bookmark);
+                    firstPara.addBookmark(registered);
+                }
+            }
+        }
+        const hyperlinks = this.getHyperlinks();
+        for (const { hyperlink, paragraph } of hyperlinks) {
+            const text = hyperlink.getText().toLowerCase();
+            if (text.includes("top") && text.includes("document")) {
+                hyperlink.setText("Top of the Document");
+                hyperlink.setFormatting({
+                    font: "Verdana",
+                    size: 12,
+                    underline: "single",
+                    color: "0000FF",
+                });
+                hyperlink.setAnchor("_top");
+                paragraph.setAlignment("right");
+                count++;
+            }
+        }
+        return count;
+    }
+    setIfColumnWidth() {
+        let count = 0;
+        const tables = this.getTables();
+        for (const table of tables) {
+            const columnCount = table.getColumnCount();
+            if (columnCount < 2)
+                continue;
+            let hasIfColumn = false;
+            const rows = table.getRows();
+            for (const row of rows) {
+                const cells = row.getCells();
+                const firstCell = cells[0];
+                if (firstCell) {
+                    const text = firstCell.getText().toLowerCase();
+                    if (text.includes("if")) {
+                        hasIfColumn = true;
+                        break;
+                    }
+                }
+            }
+            if (hasIfColumn) {
+                const tableWidth = table.getFormatting().width || 12960;
+                const targetWidth = Math.round(tableWidth * 0.05);
+                for (const row of rows) {
+                    const cells = row.getCells();
+                    const firstCell = cells[0];
+                    if (firstCell) {
+                        firstCell.setWidth(targetWidth);
+                        count++;
+                    }
+                }
+            }
+        }
+        return count;
+    }
+    centerLargeImages(minPixels = 100) {
+        let count = 0;
+        const minEmus = Math.round(minPixels * 9525);
+        const images = this.imageManager.getAllImages();
+        const largeImageIds = new Set();
+        for (const entry of images) {
+            const image = entry.image;
+            const width = image.getWidth();
+            const height = image.getHeight();
+            if (width >= minEmus && height >= minEmus) {
+                const relId = image.getRelationshipId();
+                if (relId) {
+                    largeImageIds.add(relId);
+                }
+            }
+        }
+        for (const paragraph of this.getParagraphs()) {
+            const content = paragraph.getContent();
+            for (const item of content) {
+                if (item instanceof ImageRun_1.ImageRun) {
+                    const image = item.getImageElement();
+                    const relId = image.getRelationshipId();
+                    if (relId && largeImageIds.has(relId)) {
+                        paragraph.setAlignment("center");
+                        count++;
+                        break;
+                    }
+                }
+            }
+        }
+        return count;
+    }
+    setListLineSpacing(spacingTwips = 240) {
+        let count = 0;
+        for (const paragraph of this.getParagraphs()) {
+            const numbering = paragraph.getNumbering();
+            if (numbering) {
+                paragraph.setLineSpacing(spacingTwips, "auto");
+                count++;
+            }
+        }
+        return count;
+    }
+    normalizeNumberedLists() {
+        let count = 0;
+        const standardNumId = this.numberingManager.createNumberedList(3, [
+            "decimal",
+            "lowerLetter",
+            "lowerRoman",
+        ]);
+        const paragraphs = this.getParagraphs();
+        const numberedParas = [];
+        for (const para of paragraphs) {
+            const numbering = para.getNumbering();
+            if (!numbering)
+                continue;
+            const instance = this.numberingManager.getInstance(numbering.numId);
+            if (!instance)
+                continue;
+            const abstractNum = this.numberingManager.getAbstractNumbering(instance.getAbstractNumId());
+            if (!abstractNum)
+                continue;
+            const level0 = abstractNum.getLevel(0);
+            if (!level0)
+                continue;
+            const format = level0.getFormat();
+            if (format !== "bullet") {
+                numberedParas.push({ para, level: numbering.level });
+            }
+        }
+        for (const { para, level } of numberedParas) {
+            para.setNumbering(standardNumId, level);
+            count++;
+        }
+        this.cleanupUnusedNumbering();
+        return count;
+    }
+    normalizeBulletLists() {
+        let count = 0;
+        const standardNumId = this.numberingManager.createBulletList(3, [
+            "•",
+            "○",
+            "■",
+        ]);
+        const paragraphs = this.getParagraphs();
+        const bulletParas = [];
+        for (const para of paragraphs) {
+            const numbering = para.getNumbering();
+            if (!numbering)
+                continue;
+            const instance = this.numberingManager.getInstance(numbering.numId);
+            if (!instance)
+                continue;
+            const abstractNum = this.numberingManager.getAbstractNumbering(instance.getAbstractNumId());
+            if (!abstractNum)
+                continue;
+            const level0 = abstractNum.getLevel(0);
+            if (!level0)
+                continue;
+            const format = level0.getFormat();
+            if (format === "bullet") {
+                bulletParas.push({ para, level: numbering.level });
+            }
+        }
+        for (const { para, level } of bulletParas) {
+            para.setNumbering(standardNumId, level);
+            count++;
+        }
+        this.cleanupUnusedNumbering();
+        return count;
+    }
+    cleanupUnusedNumbering() {
+        const usedNumIds = new Set();
+        const paragraphs = this.getParagraphs();
+        for (const para of paragraphs) {
+            const numbering = para.getNumbering();
+            if (numbering) {
+                usedNumIds.add(numbering.numId);
+            }
+        }
+        this.numberingManager.cleanupUnusedNumbering(usedNumIds);
+    }
+    removeAllHeadersFooters() {
+        let totalCount = 0;
+        const headerRels = this.relationshipManager.getRelationshipsByType("http://schemas.openxmlformats.org/officeDocument/2006/relationships/header");
+        const footerRels = this.relationshipManager.getRelationshipsByType("http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer");
+        for (const rel of [...headerRels, ...footerRels]) {
+            this.relationshipManager.removeRelationship(rel.getId());
+            totalCount++;
+        }
+        const allFiles = this.zipHandler.getFilePaths();
+        const headerFooterFiles = allFiles.filter((path) => path.match(/^word\/(header|footer)\d+\.xml$/i));
+        for (const filePath of headerFooterFiles) {
+            this.zipHandler.removeFile(filePath);
+        }
+        this.headerFooterManager.clear();
+        const section = this.section;
+        const sectionProps = section.properties;
+        if (sectionProps.headers) {
+            sectionProps.headers = {};
+        }
+        if (sectionProps.footers) {
+            sectionProps.footers = {};
+        }
+        if (sectionProps.titlePage) {
+            sectionProps.titlePage = false;
+        }
+        return totalCount;
+    }
     getStylesXml() {
         const stylesFile = this.zipHandler.getFileAsString(types_1.DOCX_PATHS.STYLES);
         return stylesFile || this.stylesManager.generateStylesXml();
@@ -376,6 +783,16 @@ class Document {
     createMultiLevelList() {
         return this.numberingManager.createMultiLevelList();
     }
+    getStandardIndentation(level) {
+        return this.numberingManager.getStandardIndentation(level);
+    }
+    setListIndentation(numId, level, leftIndent, hangingIndent) {
+        this.numberingManager.setListIndentation(numId, level, leftIndent, hangingIndent);
+        return this;
+    }
+    normalizeAllListIndentation() {
+        return this.numberingManager.normalizeAllListIndentation();
+    }
     getSection() {
         return this.section;
     }
@@ -398,39 +815,39 @@ class Document {
     setHeader(header) {
         const relationship = this.relationshipManager.addHeader(`${header.getFilename(1)}`);
         this.headerFooterManager.registerHeader(header, relationship.getId());
-        this.section.setHeaderReference('default', relationship.getId());
+        this.section.setHeaderReference("default", relationship.getId());
         return this;
     }
     setFirstPageHeader(header) {
         this.section.setTitlePage(true);
         const relationship = this.relationshipManager.addHeader(`${header.getFilename(this.headerFooterManager.getHeaderCount() + 1)}`);
         this.headerFooterManager.registerHeader(header, relationship.getId());
-        this.section.setHeaderReference('first', relationship.getId());
+        this.section.setHeaderReference("first", relationship.getId());
         return this;
     }
     setEvenPageHeader(header) {
         const relationship = this.relationshipManager.addHeader(`${header.getFilename(this.headerFooterManager.getHeaderCount() + 1)}`);
         this.headerFooterManager.registerHeader(header, relationship.getId());
-        this.section.setHeaderReference('even', relationship.getId());
+        this.section.setHeaderReference("even", relationship.getId());
         return this;
     }
     setFooter(footer) {
         const relationship = this.relationshipManager.addFooter(`${footer.getFilename(1)}`);
         this.headerFooterManager.registerFooter(footer, relationship.getId());
-        this.section.setFooterReference('default', relationship.getId());
+        this.section.setFooterReference("default", relationship.getId());
         return this;
     }
     setFirstPageFooter(footer) {
         this.section.setTitlePage(true);
         const relationship = this.relationshipManager.addFooter(`${footer.getFilename(this.headerFooterManager.getFooterCount() + 1)}`);
         this.headerFooterManager.registerFooter(footer, relationship.getId());
-        this.section.setFooterReference('first', relationship.getId());
+        this.section.setFooterReference("first", relationship.getId());
         return this;
     }
     setEvenPageFooter(footer) {
         const relationship = this.relationshipManager.addFooter(`${footer.getFilename(this.headerFooterManager.getFooterCount() + 1)}`);
         this.headerFooterManager.registerFooter(footer, relationship.getId());
-        this.section.setFooterReference('even', relationship.getId());
+        this.section.setFooterReference("even", relationship.getId());
         return this;
     }
     getHeaderFooterManager() {
@@ -447,7 +864,7 @@ class Document {
         return this;
     }
     createImageRun(image) {
-        return new ImageRun(image);
+        return new ImageRun_1.ImageRun(image);
     }
     getImageManager() {
         return this.imageManager;
@@ -486,17 +903,17 @@ class Document {
     }
     updateRelationships() {
         const xml = this.relationshipManager.generateXml();
-        this.zipHandler.updateFile('word/_rels/document.xml.rels', xml);
+        this.zipHandler.updateFile("word/_rels/document.xml.rels", xml);
     }
     saveComments() {
         if (this.commentManager.getCount() > 0) {
             const xml = this.commentManager.generateCommentsXml();
-            this.zipHandler.addFile('word/comments.xml', xml);
+            this.zipHandler.addFile("word/comments.xml", xml);
             this.relationshipManager.addComments();
         }
     }
     updateContentTypesWithImagesHeadersFootersAndComments() {
-        const contentTypes = this.generator.generateContentTypesWithImagesHeadersFootersAndComments(this.imageManager, this.headerFooterManager, this.commentManager);
+        const contentTypes = this.generator.generateContentTypesWithImagesHeadersFootersAndComments(this.imageManager, this.headerFooterManager, this.commentManager, this.zipHandler);
         this.zipHandler.updateFile(types_1.DOCX_PATHS.CONTENT_TYPES, contentTypes);
     }
     getBookmarkManager() {
@@ -515,7 +932,7 @@ class Document {
         return this.bookmarkManager.hasBookmark(name);
     }
     addBookmarkToParagraph(paragraph, bookmarkOrName) {
-        const bookmark = typeof bookmarkOrName === 'string'
+        const bookmark = typeof bookmarkOrName === "string"
             ? this.createBookmark(bookmarkOrName)
             : bookmarkOrName;
         paragraph.addBookmark(bookmark);
@@ -537,12 +954,12 @@ class Document {
         return this.revisionManager.register(revision);
     }
     trackInsertion(paragraph, author, text, date) {
-        const revision = this.createRevisionFromText('insert', author, text, date);
+        const revision = this.createRevisionFromText("insert", author, text, date);
         paragraph.addRevision(revision);
         return revision;
     }
     trackDeletion(paragraph, author, text, date) {
-        const revision = this.createRevisionFromText('delete', author, text, date);
+        const revision = this.createRevisionFromText("delete", author, text, date);
         paragraph.addRevision(revision);
         return revision;
     }
@@ -568,7 +985,7 @@ class Document {
         return this.commentManager.getAllComments();
     }
     addCommentToParagraph(paragraph, commentOrAuthor, content, initials) {
-        const comment = typeof commentOrAuthor === 'string'
+        const comment = typeof commentOrAuthor === "string"
             ? this.createComment(commentOrAuthor, content, initials)
             : commentOrAuthor;
         paragraph.addComment(comment);
@@ -627,7 +1044,7 @@ class Document {
                         updates.push({
                             hyperlink: content,
                             newUrl,
-                            relationshipId: content.getRelationshipId()
+                            relationshipId: content.getRelationshipId(),
                         });
                     }
                 }
@@ -666,9 +1083,13 @@ class Document {
             if (!file) {
                 return null;
             }
+            let content = file.content;
+            if (!file.isBinary && Buffer.isBuffer(file.content)) {
+                content = file.content.toString('utf-8');
+            }
             return {
                 name: partName,
-                content: file.content,
+                content,
                 contentType: this.getContentTypeForPart(partName),
                 isBinary: file.isBinary,
                 size: file.size,
@@ -694,7 +1115,7 @@ class Document {
     async getContentTypes() {
         const contentTypes = new Map();
         try {
-            const contentTypesXml = this.zipHandler.getFileAsString('[Content_Types].xml');
+            const contentTypesXml = this.zipHandler.getFileAsString("[Content_Types].xml");
             if (!contentTypesXml) {
                 return contentTypes;
             }
@@ -722,11 +1143,11 @@ class Document {
             if (!part) {
                 return null;
             }
-            if (typeof part.content === 'string') {
+            if (typeof part.content === "string") {
                 return part.content;
             }
             if (Buffer.isBuffer(part.content)) {
-                return part.content.toString('utf8');
+                return part.content.toString("utf8");
             }
             return null;
         }
@@ -753,39 +1174,41 @@ class Document {
         return xmlMap;
     }
     async setRawXml(partName, xmlContent) {
-        if (typeof xmlContent !== 'string') {
-            throw new Error('XML content must be a string');
+        if (typeof xmlContent !== "string") {
+            throw new Error("XML content must be a string");
         }
         await this.setPart(partName, xmlContent);
     }
     async addContentType(partNameOrExtension, contentType) {
         try {
-            let contentTypesXml = this.zipHandler.getFileAsString('[Content_Types].xml');
+            let contentTypesXml = this.zipHandler.getFileAsString("[Content_Types].xml");
             if (!contentTypesXml) {
                 return false;
             }
-            const isExtension = partNameOrExtension.startsWith('.');
+            const isExtension = partNameOrExtension.startsWith(".");
             if (isExtension) {
                 const extension = partNameOrExtension.substring(1);
-                const existingPattern = new RegExp(`<Default\\s+Extension="${extension}"\\s+ContentType="[^"]+"/?>`, 'g');
+                const existingPattern = new RegExp(`<Default\\s+Extension="${extension}"\\s+ContentType="[^"]+"/?>`, "g");
                 if (existingPattern.test(contentTypesXml)) {
                     contentTypesXml = contentTypesXml.replace(existingPattern, `<Default Extension="${extension}" ContentType="${contentType}"/>`);
                 }
                 else {
-                    contentTypesXml = contentTypesXml.replace('</Types>', `  <Default Extension="${extension}" ContentType="${contentType}"/>\n</Types>`);
+                    contentTypesXml = contentTypesXml.replace("</Types>", `  <Default Extension="${extension}" ContentType="${contentType}"/>\n</Types>`);
                 }
             }
             else {
-                const partName = partNameOrExtension.startsWith('/') ? partNameOrExtension : `/${partNameOrExtension}`;
-                const existingPattern = new RegExp(`<Override\\s+PartName="${partName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}"\\s+ContentType="[^"]+"/?>`, 'g');
+                const partName = partNameOrExtension.startsWith("/")
+                    ? partNameOrExtension
+                    : `/${partNameOrExtension}`;
+                const existingPattern = new RegExp(`<Override\\s+PartName="${partName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}"\\s+ContentType="[^"]+"/?>`, "g");
                 if (existingPattern.test(contentTypesXml)) {
                     contentTypesXml = contentTypesXml.replace(existingPattern, `<Override PartName="${partName}" ContentType="${contentType}"/>`);
                 }
                 else {
-                    contentTypesXml = contentTypesXml.replace('</Types>', `  <Override PartName="${partName}" ContentType="${contentType}"/>\n</Types>`);
+                    contentTypesXml = contentTypesXml.replace("</Types>", `  <Override PartName="${partName}" ContentType="${contentType}"/>\n</Types>`);
                 }
             }
-            this.zipHandler.updateFile('[Content_Types].xml', contentTypesXml);
+            this.zipHandler.updateFile("[Content_Types].xml", contentTypesXml);
             return true;
         }
         catch (error) {
@@ -795,18 +1218,20 @@ class Document {
     async getAllRelationships() {
         const relationships = new Map();
         try {
-            const relsPaths = this.zipHandler.getFilePaths().filter(path => path.endsWith('.rels'));
+            const relsPaths = this.zipHandler
+                .getFilePaths()
+                .filter((path) => path.endsWith(".rels"));
             for (const relsPath of relsPaths) {
                 const relsContent = this.zipHandler.getFileAsString(relsPath);
                 if (relsContent) {
                     const rels = [];
-                    const relationshipElements = XMLParser_1.XMLParser.extractElements(relsContent, 'Relationship');
+                    const relationshipElements = XMLParser_1.XMLParser.extractElements(relsContent, "Relationship");
                     for (const relElement of relationshipElements) {
                         const rel = {};
-                        const id = XMLParser_1.XMLParser.extractAttribute(relElement, 'Id');
-                        const type = XMLParser_1.XMLParser.extractAttribute(relElement, 'Type');
-                        const target = XMLParser_1.XMLParser.extractAttribute(relElement, 'Target');
-                        const targetMode = XMLParser_1.XMLParser.extractAttribute(relElement, 'TargetMode');
+                        const id = XMLParser_1.XMLParser.extractAttribute(relElement, "Id");
+                        const type = XMLParser_1.XMLParser.extractAttribute(relElement, "Type");
+                        const target = XMLParser_1.XMLParser.extractAttribute(relElement, "Target");
+                        const targetMode = XMLParser_1.XMLParser.extractAttribute(relElement, "TargetMode");
                         if (id)
                             rel.id = id;
                         if (type)
@@ -827,7 +1252,7 @@ class Document {
     }
     async getRelationships(partName) {
         try {
-            const lastSlash = partName.lastIndexOf('/');
+            const lastSlash = partName.lastIndexOf("/");
             const relsPath = lastSlash === -1
                 ? `_rels/${partName}.rels`
                 : `${partName.substring(0, lastSlash)}/_rels/${partName.substring(lastSlash + 1)}.rels`;
@@ -836,13 +1261,13 @@ class Document {
                 return [];
             }
             const relationships = [];
-            const relationshipElements = XMLParser_1.XMLParser.extractElements(relsContent, 'Relationship');
+            const relationshipElements = XMLParser_1.XMLParser.extractElements(relsContent, "Relationship");
             for (const relElement of relationshipElements) {
                 const rel = {};
-                const id = XMLParser_1.XMLParser.extractAttribute(relElement, 'Id');
-                const type = XMLParser_1.XMLParser.extractAttribute(relElement, 'Type');
-                const target = XMLParser_1.XMLParser.extractAttribute(relElement, 'Target');
-                const targetMode = XMLParser_1.XMLParser.extractAttribute(relElement, 'TargetMode');
+                const id = XMLParser_1.XMLParser.extractAttribute(relElement, "Id");
+                const type = XMLParser_1.XMLParser.extractAttribute(relElement, "Type");
+                const target = XMLParser_1.XMLParser.extractAttribute(relElement, "Target");
+                const targetMode = XMLParser_1.XMLParser.extractAttribute(relElement, "TargetMode");
                 if (id)
                     rel.id = id;
                 if (type)
@@ -861,18 +1286,18 @@ class Document {
     }
     getContentTypeForPart(partName) {
         try {
-            const contentTypesXml = this.zipHandler.getFileAsString('[Content_Types].xml');
+            const contentTypesXml = this.zipHandler.getFileAsString("[Content_Types].xml");
             if (!contentTypesXml) {
                 return undefined;
             }
-            const overridePattern = new RegExp(`<Override\\s+PartName="${partName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}"\\s+ContentType="([^"]+)"`, 'i');
+            const overridePattern = new RegExp(`<Override\\s+PartName="${partName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}"\\s+ContentType="([^"]+)"`, "i");
             const overrideMatch = contentTypesXml.match(overridePattern);
             if (overrideMatch) {
                 return overrideMatch[1];
             }
-            const ext = partName.substring(partName.lastIndexOf('.'));
+            const ext = partName.substring(partName.lastIndexOf("."));
             if (ext) {
-                const defaultPattern = new RegExp(`<Default\\s+Extension="${ext.substring(1)}"\\s+ContentType="([^"]+)"`, 'i');
+                const defaultPattern = new RegExp(`<Default\\s+Extension="${ext.substring(1)}"\\s+ContentType="([^"]+)"`, "i");
                 const defaultMatch = contentTypesXml.match(defaultPattern);
                 if (defaultMatch) {
                     return defaultMatch[1];
@@ -901,7 +1326,7 @@ class Document {
                 const runText = run.getText();
                 const compareText = caseSensitive ? runText : runText.toLowerCase();
                 if (wholeWord) {
-                    const wordPattern = new RegExp(`\\b${searchText.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`, caseSensitive ? 'g' : 'gi');
+                    const wordPattern = new RegExp(`\\b${searchText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`, caseSensitive ? "g" : "gi");
                     let match;
                     while ((match = wordPattern.exec(runText)) !== null) {
                         results.push({
@@ -945,9 +1370,11 @@ class Document {
                                 if (!run)
                                     continue;
                                 const runText = run.getText();
-                                const compareText = caseSensitive ? runText : runText.toLowerCase();
+                                const compareText = caseSensitive
+                                    ? runText
+                                    : runText.toLowerCase();
                                 if (wholeWord) {
-                                    const wordPattern = new RegExp(`\\b${searchText.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`, caseSensitive ? 'g' : 'gi');
+                                    const wordPattern = new RegExp(`\\b${searchText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`, caseSensitive ? "g" : "gi");
                                     let match;
                                     while ((match = wordPattern.exec(runText)) !== null) {
                                         results.push({
@@ -993,7 +1420,7 @@ class Document {
                 const originalText = run.getText();
                 let newText = originalText;
                 if (wholeWord) {
-                    const wordPattern = new RegExp(`\\b${find.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`, caseSensitive ? 'g' : 'gi');
+                    const wordPattern = new RegExp(`\\b${find.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`, caseSensitive ? "g" : "gi");
                     const matches = originalText.match(wordPattern);
                     if (matches) {
                         replacementCount += matches.length;
@@ -1001,7 +1428,7 @@ class Document {
                     }
                 }
                 else {
-                    const searchPattern = new RegExp(find.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), caseSensitive ? 'g' : 'gi');
+                    const searchPattern = new RegExp(find.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), caseSensitive ? "g" : "gi");
                     const matches = originalText.match(searchPattern);
                     if (matches) {
                         replacementCount += matches.length;
@@ -1021,7 +1448,7 @@ class Document {
         for (const paragraph of paragraphs) {
             const text = paragraph.getText().trim();
             if (text) {
-                const words = text.split(/\s+/).filter(word => word.length > 0);
+                const words = text.split(/\s+/).filter((word) => word.length > 0);
                 totalWords += words.length;
             }
         }
@@ -1035,7 +1462,7 @@ class Document {
                     for (const para of cellParas) {
                         const text = para.getText().trim();
                         if (text) {
-                            const words = text.split(/\s+/).filter(word => word.length > 0);
+                            const words = text.split(/\s+/).filter((word) => word.length > 0);
                             totalWords += words.length;
                         }
                     }
@@ -1053,7 +1480,7 @@ class Document {
                 totalChars += text.length;
             }
             else {
-                totalChars += text.replace(/\s/g, '').length;
+                totalChars += text.replace(/\s/g, "").length;
             }
         }
         const tables = this.getTables();
@@ -1069,7 +1496,7 @@ class Document {
                             totalChars += text.length;
                         }
                         else {
-                            totalChars += text.replace(/\s/g, '').length;
+                            totalChars += text.replace(/\s/g, "").length;
                         }
                     }
                 }
@@ -1079,7 +1506,7 @@ class Document {
     }
     removeParagraph(paragraphOrIndex) {
         let index;
-        if (typeof paragraphOrIndex === 'number') {
+        if (typeof paragraphOrIndex === "number") {
             index = paragraphOrIndex;
         }
         else {
@@ -1096,7 +1523,7 @@ class Document {
     }
     removeTable(tableOrIndex) {
         let index;
-        if (typeof tableOrIndex === 'number') {
+        if (typeof tableOrIndex === "number") {
             const tables = this.getTables();
             if (tableOrIndex >= 0 && tableOrIndex < tables.length) {
                 const table = tables[tableOrIndex];
@@ -1130,6 +1557,79 @@ class Document {
         this.bodyElements.splice(index, 0, paragraph);
         return this;
     }
+    insertTableAt(index, table) {
+        if (index < 0) {
+            index = 0;
+        }
+        else if (index > this.bodyElements.length) {
+            index = this.bodyElements.length;
+        }
+        this.bodyElements.splice(index, 0, table);
+        return this;
+    }
+    insertTocAt(index, toc) {
+        if (index < 0) {
+            index = 0;
+        }
+        else if (index > this.bodyElements.length) {
+            index = this.bodyElements.length;
+        }
+        this.bodyElements.splice(index, 0, toc);
+        return this;
+    }
+    replaceParagraphAt(index, paragraph) {
+        if (index >= 0 && index < this.bodyElements.length) {
+            const element = this.bodyElements[index];
+            if (element instanceof Paragraph_1.Paragraph) {
+                this.bodyElements[index] = paragraph;
+                return true;
+            }
+        }
+        return false;
+    }
+    replaceTableAt(index, table) {
+        if (index >= 0 && index < this.bodyElements.length) {
+            const element = this.bodyElements[index];
+            if (element instanceof Table_1.Table) {
+                this.bodyElements[index] = table;
+                return true;
+            }
+        }
+        return false;
+    }
+    moveElement(fromIndex, toIndex) {
+        if (fromIndex < 0 ||
+            fromIndex >= this.bodyElements.length ||
+            toIndex < 0 ||
+            toIndex >= this.bodyElements.length) {
+            return false;
+        }
+        const [element] = this.bodyElements.splice(fromIndex, 1);
+        this.bodyElements.splice(toIndex, 0, element);
+        return true;
+    }
+    swapElements(index1, index2) {
+        if (index1 < 0 ||
+            index1 >= this.bodyElements.length ||
+            index2 < 0 ||
+            index2 >= this.bodyElements.length) {
+            return false;
+        }
+        const temp = this.bodyElements[index1];
+        this.bodyElements[index1] = this.bodyElements[index2];
+        this.bodyElements[index2] = temp;
+        return true;
+    }
+    removeTocAt(index) {
+        if (index >= 0 && index < this.bodyElements.length) {
+            const element = this.bodyElements[index];
+            if (element instanceof TableOfContentsElement_1.TableOfContentsElement) {
+                this.bodyElements.splice(index, 1);
+                return true;
+            }
+        }
+        return false;
+    }
     getHyperlinks() {
         const hyperlinks = [];
         for (const paragraph of this.getParagraphs()) {
@@ -1191,21 +1691,21 @@ class Document {
     static createEmpty() {
         const doc = new Document(undefined, {}, false);
         const zipHandler = doc.getZipHandler();
-        zipHandler.addFile('[Content_Types].xml', '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' +
+        zipHandler.addFile("[Content_Types].xml", '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' +
             '<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">\n' +
             '  <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>\n' +
             '  <Default Extension="xml" ContentType="application/xml"/>\n' +
             '  <Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>\n' +
-            '</Types>');
-        zipHandler.addFile('_rels/.rels', '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' +
+            "</Types>");
+        zipHandler.addFile("_rels/.rels", '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' +
             '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">\n' +
             '  <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/>\n' +
-            '</Relationships>');
-        zipHandler.addFile('word/document.xml', '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' +
+            "</Relationships>");
+        zipHandler.addFile("word/document.xml", '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' +
             '<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">\n' +
-            '  <w:body/>\n' +
-            '</w:document>');
-        zipHandler.addFile('word/_rels/document.xml.rels', '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' +
+            "  <w:body/>\n" +
+            "</w:document>");
+        zipHandler.addFile("word/_rels/document.xml.rels", '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n' +
             '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"/>');
         return doc;
     }