docxmlater 10.3.6 → 10.4.0

package/dist/elements/Paragraph.js

@@ -13,6 +13,7 @@ exports.isTextBox = isTextBox;
 const deepClone_1 = require("../utils/deepClone");
 const dateFormatting_1 = require("../utils/dateFormatting");
 const diagnostics_1 = require("../utils/diagnostics");
+const formatting_1 = require("../utils/formatting");
 const logger_1 = require("../utils/logger");
 const XMLBuilder_1 = require("../xml/XMLBuilder");
 const CommonTypes_1 = require("./CommonTypes");
@@ -280,6 +281,18 @@ class Paragraph {
         }
         return this;
     }
+    addLineBreak() {
+        const run = new Run_1.Run('');
+        run.addBreak();
+        this.content.push(run);
+        return this;
+    }
+    addColumnBreak() {
+        const run = new Run_1.Run('');
+        run.addBreak('column');
+        this.content.push(run);
+        return this;
+    }
     setText(text, formatting) {
         this.content = [new Run_1.Run(text, formatting)];
         return this;
@@ -553,6 +566,11 @@ class Paragraph {
     isEmpty() {
         return this.getText().trim().length === 0;
     }
+    contains(text, caseSensitive = false) {
+        const paraText = caseSensitive ? this.getText() : this.getText().toLowerCase();
+        const search = caseSensitive ? text : text.toLowerCase();
+        return paraText.includes(search);
+    }
     getStyle() {
         return this.formatting.style;
     }
@@ -719,7 +737,7 @@ class Paragraph {
         const previousValue = this.formatting.keepNext;
         this.formatting.keepNext = keepNext;
         if (keepNext) {
-            this.formatting.pageBreakBefore = false;
+            this.formatting.pageBreakBefore = undefined;
         }
         if (this.trackingContext?.isEnabled() && previousValue !== keepNext) {
             this.trackingContext.trackParagraphPropertyChange(this, 'keepNext', previousValue, keepNext);
@@ -730,7 +748,7 @@ class Paragraph {
         const previousValue = this.formatting.keepLines;
         this.formatting.keepLines = keepLines;
         if (keepLines) {
-            this.formatting.pageBreakBefore = false;
+            this.formatting.pageBreakBefore = undefined;
         }
         if (this.trackingContext?.isEnabled() && previousValue !== keepLines) {
             this.trackingContext.trackParagraphPropertyChange(this, 'keepLines', previousValue, keepLines);
@@ -1000,14 +1018,16 @@ class Paragraph {
         if (this.formatting.style) {
             pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('pStyle', { 'w:val': this.formatting.style }));
         }
-        if (this.formatting.keepNext) {
-            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('keepNext'));
+        if (this.formatting.keepNext !== undefined) {
+            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('keepNext', { 'w:val': this.formatting.keepNext ? '1' : '0' }));
         }
-        if (this.formatting.keepLines) {
-            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('keepLines'));
+        if (this.formatting.keepLines !== undefined) {
+            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('keepLines', { 'w:val': this.formatting.keepLines ? '1' : '0' }));
         }
-        if (this.formatting.pageBreakBefore) {
-            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('pageBreakBefore'));
+        if (this.formatting.pageBreakBefore !== undefined) {
+            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('pageBreakBefore', {
+                'w:val': this.formatting.pageBreakBefore ? '1' : '0',
+            }));
         }
         if (this.formatting.framePr) {
             const attrs = {};
@@ -1062,8 +1082,17 @@ class Paragraph {
             ]);
             pPrChildren.push(numPr);
         }
-        if (this.formatting.suppressLineNumbers) {
-            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressLineNumbers'));
+        else if (this.formatting.numberingSuppressed) {
+            const numPr = XMLBuilder_1.XMLBuilder.w('numPr', undefined, [
+                XMLBuilder_1.XMLBuilder.wSelf('ilvl', { 'w:val': '0' }),
+                XMLBuilder_1.XMLBuilder.wSelf('numId', { 'w:val': '0' }),
+            ]);
+            pPrChildren.push(numPr);
+        }
+        if (this.formatting.suppressLineNumbers !== undefined) {
+            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressLineNumbers', {
+                'w:val': this.formatting.suppressLineNumbers ? '1' : '0',
+            }));
         }
         if (this.formatting.borders) {
             const borderChildren = [];
@@ -1128,8 +1157,10 @@ class Paragraph {
                 pPrChildren.push(XMLBuilder_1.XMLBuilder.w('tabs', undefined, tabChildren));
             }
         }
-        if (this.formatting.suppressAutoHyphens) {
-            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressAutoHyphens'));
+        if (this.formatting.suppressAutoHyphens !== undefined) {
+            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressAutoHyphens', {
+                'w:val': this.formatting.suppressAutoHyphens ? '1' : '0',
+            }));
         }
         if (this.formatting.kinsoku !== undefined) {
             pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('kinsoku', { 'w:val': this.formatting.kinsoku ? '1' : '0' }));
@@ -1162,8 +1193,16 @@ class Paragraph {
             const attributes = {};
             if (spc.before !== undefined)
                 attributes['w:before'] = spc.before;
+            if (spc.beforeLines !== undefined)
+                attributes['w:beforeLines'] = spc.beforeLines;
+            if (spc.beforeAutospacing !== undefined)
+                attributes['w:beforeAutospacing'] = spc.beforeAutospacing ? '1' : '0';
             if (spc.after !== undefined)
                 attributes['w:after'] = spc.after;
+            if (spc.afterLines !== undefined)
+                attributes['w:afterLines'] = spc.afterLines;
+            if (spc.afterAutospacing !== undefined)
+                attributes['w:afterAutospacing'] = spc.afterAutospacing ? '1' : '0';
             if (spc.line !== undefined)
                 attributes['w:line'] = spc.line;
             if (spc.lineRule)
@@ -1179,22 +1218,28 @@ class Paragraph {
                 attributes['w:left'] = ind.left;
             if (ind.right !== undefined)
                 attributes['w:right'] = ind.right;
-            if (ind.firstLine !== undefined)
-                attributes['w:firstLine'] = ind.firstLine;
-            if (ind.hanging !== undefined)
+            if (ind.hanging !== undefined) {
                 attributes['w:hanging'] = ind.hanging;
+            }
+            else if (ind.firstLine !== undefined) {
+                attributes['w:firstLine'] = ind.firstLine;
+            }
             if (Object.keys(attributes).length > 0) {
                 pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('ind', attributes));
             }
         }
-        if (this.formatting.contextualSpacing) {
-            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('contextualSpacing', { 'w:val': '1' }));
+        if (this.formatting.contextualSpacing !== undefined) {
+            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('contextualSpacing', {
+                'w:val': this.formatting.contextualSpacing ? '1' : '0',
+            }));
         }
-        if (this.formatting.mirrorIndents) {
-            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('mirrorIndents'));
+        if (this.formatting.mirrorIndents !== undefined) {
+            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('mirrorIndents', { 'w:val': this.formatting.mirrorIndents ? '1' : '0' }));
         }
-        if (this.formatting.suppressOverlap) {
-            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressOverlap'));
+        if (this.formatting.suppressOverlap !== undefined) {
+            pPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressOverlap', {
+                'w:val': this.formatting.suppressOverlap ? '1' : '0',
+            }));
         }
         if (this.formatting.alignment) {
             const alignmentValue = this.formatting.alignment === 'justify' ? 'both' : this.formatting.alignment;
@@ -1292,6 +1337,43 @@ class Paragraph {
                 if (prev.pageBreakBefore !== undefined) {
                     prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('pageBreakBefore', prev.pageBreakBefore ? { 'w:val': '1' } : { 'w:val': '0' }));
                 }
+                if (prev.framePr) {
+                    const fAttrs = {};
+                    const f = prev.framePr;
+                    if (f.w !== undefined)
+                        fAttrs['w:w'] = f.w.toString();
+                    if (f.h !== undefined)
+                        fAttrs['w:h'] = f.h.toString();
+                    if (f.hRule)
+                        fAttrs['w:hRule'] = f.hRule;
+                    if (f.x !== undefined)
+                        fAttrs['w:x'] = f.x.toString();
+                    if (f.y !== undefined)
+                        fAttrs['w:y'] = f.y.toString();
+                    if (f.xAlign)
+                        fAttrs['w:xAlign'] = f.xAlign;
+                    if (f.yAlign)
+                        fAttrs['w:yAlign'] = f.yAlign;
+                    if (f.hAnchor)
+                        fAttrs['w:hAnchor'] = f.hAnchor;
+                    if (f.vAnchor)
+                        fAttrs['w:vAnchor'] = f.vAnchor;
+                    if (f.hSpace !== undefined)
+                        fAttrs['w:hSpace'] = f.hSpace.toString();
+                    if (f.vSpace !== undefined)
+                        fAttrs['w:vSpace'] = f.vSpace.toString();
+                    if (f.wrap)
+                        fAttrs['w:wrap'] = f.wrap;
+                    if (f.dropCap)
+                        fAttrs['w:dropCap'] = f.dropCap;
+                    if (f.lines !== undefined)
+                        fAttrs['w:lines'] = f.lines.toString();
+                    if (f.anchorLock !== undefined)
+                        fAttrs['w:anchorLock'] = f.anchorLock ? '1' : '0';
+                    if (Object.keys(fAttrs).length > 0) {
+                        prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('framePr', fAttrs));
+                    }
+                }
                 if (prev.widowControl !== undefined) {
                     prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('widowControl', {
                         'w:val': prev.widowControl ? '1' : '0',
@@ -1309,6 +1391,12 @@ class Paragraph {
                         prevPPrChildren.push(XMLBuilder_1.XMLBuilder.w('numPr', undefined, numPrChildren));
                     }
                 }
+                else if (prev.numberingSuppressed) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.w('numPr', undefined, [
+                        XMLBuilder_1.XMLBuilder.wSelf('ilvl', { 'w:val': '0' }),
+                        XMLBuilder_1.XMLBuilder.wSelf('numId', { 'w:val': '0' }),
+                    ]));
+                }
                 if (prev.suppressLineNumbers !== undefined) {
                     if (prev.suppressLineNumbers) {
                         prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressLineNumbers'));
@@ -1362,6 +1450,24 @@ class Paragraph {
                         prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressAutoHyphens', { 'w:val': '1' }));
                     }
                 }
+                if (prev.kinsoku !== undefined) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('kinsoku', { 'w:val': prev.kinsoku ? '1' : '0' }));
+                }
+                if (prev.wordWrap !== undefined) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('wordWrap', { 'w:val': prev.wordWrap ? '1' : '0' }));
+                }
+                if (prev.overflowPunct !== undefined) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('overflowPunct', { 'w:val': prev.overflowPunct ? '1' : '0' }));
+                }
+                if (prev.topLinePunct !== undefined) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('topLinePunct', { 'w:val': prev.topLinePunct ? '1' : '0' }));
+                }
+                if (prev.autoSpaceDE !== undefined) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('autoSpaceDE', { 'w:val': prev.autoSpaceDE ? '1' : '0' }));
+                }
+                if (prev.autoSpaceDN !== undefined) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('autoSpaceDN', { 'w:val': prev.autoSpaceDN ? '1' : '0' }));
+                }
                 if (prev.bidi !== undefined) {
                     prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('bidi', { 'w:val': prev.bidi ? '1' : '0' }));
                 }
@@ -1374,8 +1480,16 @@ class Paragraph {
                     const spacingAttrs = {};
                     if (prev.spacing.before !== undefined)
                         spacingAttrs['w:before'] = prev.spacing.before.toString();
+                    if (prev.spacing.beforeLines !== undefined)
+                        spacingAttrs['w:beforeLines'] = prev.spacing.beforeLines.toString();
+                    if (prev.spacing.beforeAutospacing !== undefined)
+                        spacingAttrs['w:beforeAutospacing'] = prev.spacing.beforeAutospacing ? '1' : '0';
                     if (prev.spacing.after !== undefined)
                         spacingAttrs['w:after'] = prev.spacing.after.toString();
+                    if (prev.spacing.afterLines !== undefined)
+                        spacingAttrs['w:afterLines'] = prev.spacing.afterLines.toString();
+                    if (prev.spacing.afterAutospacing !== undefined)
+                        spacingAttrs['w:afterAutospacing'] = prev.spacing.afterAutospacing ? '1' : '0';
                     if (prev.spacing.line !== undefined)
                         spacingAttrs['w:line'] = prev.spacing.line.toString();
                     if (prev.spacing.lineRule)
@@ -1406,6 +1520,11 @@ class Paragraph {
                         'w:val': prev.mirrorIndents ? '1' : '0',
                     }));
                 }
+                if (prev.suppressOverlap !== undefined) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('suppressOverlap', {
+                        'w:val': prev.suppressOverlap ? '1' : '0',
+                    }));
+                }
                 if (prev.alignment) {
                     const alignmentValue = prev.alignment === 'justify' ? 'both' : prev.alignment;
                     prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('jc', { 'w:val': alignmentValue }));
@@ -1416,9 +1535,18 @@ class Paragraph {
                 if (prev.textAlignment) {
                     prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('textAlignment', { 'w:val': prev.textAlignment }));
                 }
+                if (prev.textboxTightWrap) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('textboxTightWrap', { 'w:val': prev.textboxTightWrap }));
+                }
                 if (prev.outlineLevel !== undefined) {
                     prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('outlineLvl', { 'w:val': prev.outlineLevel.toString() }));
                 }
+                if (prev.divId !== undefined) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('divId', { 'w:val': prev.divId.toString() }));
+                }
+                if (prev.cnfStyle) {
+                    prevPPrChildren.push(XMLBuilder_1.XMLBuilder.wSelf('cnfStyle', { 'w:val': prev.cnfStyle }));
+                }
             }
             if (prevPPrChildren.length > 0) {
                 const pPrChangeChildren = [
@@ -1508,6 +1636,9 @@ class Paragraph {
         if (this.formatting.paraId) {
             paragraphAttributes['w14:paraId'] = this.formatting.paraId;
         }
+        if (this.formatting.textId) {
+            paragraphAttributes['w14:textId'] = this.formatting.textId;
+        }
         return XMLBuilder_1.XMLBuilder.w('p', Object.keys(paragraphAttributes).length > 0 ? paragraphAttributes : undefined, paragraphChildren);
     }
     getWordCount() {
@@ -1545,6 +1676,115 @@ class Paragraph {
         clonedParagraph.commentsEnd = [...this.commentsEnd];
         return clonedParagraph;
     }
+    toJSON() {
+        const runs = this.getRuns().map((run) => ({
+            text: run.getText(),
+            formatting: run.getFormatting(),
+        }));
+        const result = {
+            text: this.getText(),
+            runs,
+        };
+        if (this.formatting.style)
+            result.style = this.formatting.style;
+        if (this.formatting.alignment)
+            result.alignment = this.formatting.alignment;
+        if (this.formatting.numbering)
+            result.numbering = { ...this.formatting.numbering };
+        if (this.formatting.indentation)
+            result.indentation = { ...this.formatting.indentation };
+        if (this.formatting.spacing) {
+            result.spacing = {
+                before: this.formatting.spacing.before,
+                after: this.formatting.spacing.after,
+                line: this.formatting.spacing.line,
+                lineRule: this.formatting.spacing.lineRule,
+            };
+        }
+        return result;
+    }
+    static fromJSON(data) {
+        const para = new Paragraph();
+        if (data.runs && data.runs.length > 0) {
+            for (const runData of data.runs) {
+                para.addText(runData.text, runData.formatting);
+            }
+        }
+        else if (data.text) {
+            para.addText(data.text);
+        }
+        if (data.style)
+            para.setStyle(data.style);
+        if (data.alignment)
+            para.setAlignment(data.alignment);
+        if (data.numbering)
+            para.setNumbering(data.numbering.numId, data.numbering.level);
+        if (data.indentation) {
+            if (data.indentation.left !== undefined)
+                para.setLeftIndent(data.indentation.left);
+            if (data.indentation.right !== undefined)
+                para.setRightIndent(data.indentation.right);
+            if (data.indentation.firstLine !== undefined)
+                para.setFirstLineIndent(data.indentation.firstLine);
+            if (data.indentation.hanging !== undefined)
+                para.setHangingIndent(data.indentation.hanging);
+        }
+        if (data.spacing) {
+            if (data.spacing.before !== undefined)
+                para.setSpaceBefore(data.spacing.before);
+            if (data.spacing.after !== undefined)
+                para.setSpaceAfter(data.spacing.after);
+            if (data.spacing.line !== undefined) {
+                para.setLineSpacing(data.spacing.line, data.spacing.lineRule ?? 'auto');
+            }
+        }
+        return para;
+    }
+    splitAt(offset) {
+        const tailPara = new Paragraph((0, deepClone_1.deepClone)(this.formatting));
+        const totalLength = this.getText().length;
+        if (offset >= totalLength) {
+            return tailPara;
+        }
+        if (offset <= 0) {
+            tailPara.content = this.content;
+            this.content = [];
+            return tailPara;
+        }
+        let charPos = 0;
+        let splitContentIndex = -1;
+        for (let i = 0; i < this.content.length; i++) {
+            const item = this.content[i];
+            if (item instanceof Run_1.Run) {
+                const runLen = item.getText().length;
+                const runEnd = charPos + runLen;
+                if (runEnd <= offset) {
+                    charPos = runEnd;
+                    continue;
+                }
+                if (charPos >= offset) {
+                    splitContentIndex = i;
+                    break;
+                }
+                const localOffset = offset - charPos;
+                const tailRun = item.splitAt(localOffset);
+                this.content.splice(i + 1, 0, tailRun);
+                splitContentIndex = i + 1;
+                break;
+            }
+            else {
+                if (charPos >= offset) {
+                    splitContentIndex = i;
+                    break;
+                }
+            }
+        }
+        if (splitContentIndex === -1) {
+            return tailPara;
+        }
+        tailPara.content = this.content.splice(splitContentIndex);
+        return tailPara;
+    }
     setBorder(borders) {
         if (!this.formatting) {
             this.formatting = {};
@@ -1653,6 +1893,260 @@ class Paragraph {
         }
         return replacementCount;
     }
+    replaceAll(find, replace) {
+        return this.replaceTextCrossRun(find, replace);
+    }
+    findTextCrossRun(find, options) {
+        const caseSensitive = options?.caseSensitive ?? false;
+        let fullText = '';
+        for (const item of this.content) {
+            if (item instanceof Run_1.Run) {
+                fullText += item.getText();
+            }
+        }
+        if (fullText.length === 0)
+            return [];
+        const escaped = find.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const regex = new RegExp(escaped, caseSensitive ? 'g' : 'gi');
+        const results = [];
+        let m;
+        while ((m = regex.exec(fullText)) !== null) {
+            results.push({ offset: m.index, text: m[0] });
+        }
+        return results;
+    }
+    replaceTextCrossRun(find, replace, options) {
+        const caseSensitive = options?.caseSensitive ?? false;
+        const runMap = [];
+        let charPos = 0;
+        for (let i = 0; i < this.content.length; i++) {
+            const item = this.content[i];
+            if (item instanceof Run_1.Run) {
+                const len = item.getText().length;
+                if (len > 0) {
+                    runMap.push({ run: item, contentIndex: i, start: charPos, end: charPos + len });
+                }
+                charPos += len;
+            }
+        }
+        if (runMap.length === 0)
+            return 0;
+        const fullText = runMap.map((r) => r.run.getText()).join('');
+        const escaped = find.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const regex = new RegExp(escaped, caseSensitive ? 'g' : 'gi');
+        const matches = [];
+        let m;
+        while ((m = regex.exec(fullText)) !== null) {
+            matches.push({ start: m.index, end: m.index + m[0].length });
+        }
+        if (matches.length === 0)
+            return 0;
+        for (let mi = matches.length - 1; mi >= 0; mi--) {
+            const match = matches[mi];
+            const affectedRuns = runMap.filter((r) => r.end > match.start && r.start < match.end);
+            if (affectedRuns.length === 0)
+                continue;
+            const firstAffected = affectedRuns[0];
+            const lastAffected = affectedRuns[affectedRuns.length - 1];
+            const keepBefore = match.start > firstAffected.start
+                ? firstAffected.run.getText().slice(0, match.start - firstAffected.start)
+                : '';
+            const keepAfter = match.end < lastAffected.end
+                ? lastAffected.run.getText().slice(match.end - lastAffected.start)
+                : '';
+            firstAffected.run.setText(keepBefore + replace + keepAfter);
+            for (let r = affectedRuns.length - 1; r >= 1; r--) {
+                const runEntry = affectedRuns[r];
+                const idx = this.content.indexOf(runEntry.run);
+                if (idx !== -1) {
+                    this.content.splice(idx, 1);
+                }
+            }
+        }
+        return matches.length;
+    }
+    deleteRange(start, end) {
+        if (start >= end)
+            return this;
+        const runMap = [];
+        let charPos = 0;
+        for (let i = 0; i < this.content.length; i++) {
+            const item = this.content[i];
+            if (item instanceof Run_1.Run) {
+                const len = item.getText().length;
+                if (len > 0) {
+                    runMap.push({ index: i, start: charPos, end: charPos + len });
+                }
+                charPos += len;
+            }
+        }
+        for (let m = runMap.length - 1; m >= 0; m--) {
+            const entry = runMap[m];
+            const run = this.content[entry.index];
+            if (entry.end <= start || entry.start >= end)
+                continue;
+            const runStart = entry.start;
+            const runEnd = entry.end;
+            const delStart = Math.max(0, start - runStart);
+            const delEnd = Math.min(runEnd - runStart, end - runStart);
+            const runLen = runEnd - runStart;
+            if (delStart === 0 && delEnd === runLen) {
+                this.content.splice(entry.index, 1);
+            }
+            else {
+                const textBefore = run.getText().slice(0, delStart);
+                const textAfter = run.getText().slice(delEnd);
+                run.setText(textBefore + textAfter);
+            }
+        }
+        return this;
+    }
+    truncate(maxLength, suffix = '...') {
+        const text = this.getText();
+        if (text.length <= maxLength)
+            return this;
+        const cutoff = Math.max(0, maxLength - suffix.length);
+        this.deleteRange(cutoff, text.length);
+        if (suffix) {
+            this.addText(suffix);
+        }
+        return this;
+    }
+    wrap(prefix, suffix, formatting) {
+        if (prefix) {
+            const prefixRun = new Run_1.Run(prefix, formatting);
+            this.content.unshift(prefixRun);
+        }
+        if (suffix) {
+            const suffixRun = new Run_1.Run(suffix, formatting);
+            this.content.push(suffixRun);
+        }
+        return this;
+    }
+    getRunAtOffset(offset) {
+        if (offset < 0)
+            return undefined;
+        let charPos = 0;
+        for (const item of this.content) {
+            if (!(item instanceof Run_1.Run))
+                continue;
+            const len = item.getText().length;
+            if (charPos + len > offset) {
+                return { run: item, localOffset: offset - charPos };
+            }
+            charPos += len;
+        }
+        return undefined;
+    }
+    getFormattingAtOffset(offset) {
+        const result = this.getRunAtOffset(offset);
+        return result ? result.run.getFormatting() : undefined;
+    }
+    applyFormattingToRange(start, end, formatting) {
+        if (start >= end)
+            return this;
+        const contentMap = [];
+        let charPos = 0;
+        for (let i = 0; i < this.content.length; i++) {
+            const item = this.content[i];
+            let len = 0;
+            if (item instanceof Run_1.Run) {
+                len = item.getText().length;
+            }
+            if (len > 0) {
+                contentMap.push({ index: i, start: charPos, end: charPos + len });
+            }
+            charPos += len;
+        }
+        for (let m = contentMap.length - 1; m >= 0; m--) {
+            const entry = contentMap[m];
+            const run = this.content[entry.index];
+            if (entry.end <= start || entry.start >= end)
+                continue;
+            const runStart = entry.start;
+            const runEnd = entry.end;
+            const splitStart = Math.max(0, start - runStart);
+            const splitEnd = Math.min(runEnd - runStart, end - runStart);
+            const runLen = runEnd - runStart;
+            if (splitStart === 0 && splitEnd === runLen) {
+                this.applyFormattingToRun(run, formatting);
+            }
+            else if (splitStart === 0) {
+                const tail = run.splitAt(splitEnd);
+                this.applyFormattingToRun(run, formatting);
+                this.content.splice(entry.index + 1, 0, tail);
+            }
+            else if (splitEnd === runLen) {
+                const tail = run.splitAt(splitStart);
+                this.applyFormattingToRun(tail, formatting);
+                this.content.splice(entry.index + 1, 0, tail);
+            }
+            else {
+                const mid = run.splitAt(splitStart);
+                const tail = mid.splitAt(splitEnd - splitStart);
+                this.applyFormattingToRun(mid, formatting);
+                this.content.splice(entry.index + 1, 0, mid, tail);
+            }
+        }
+        return this;
+    }
+    applyFormattingToRun(run, formatting) {
+        if (formatting.bold !== undefined)
+            run.setBold(formatting.bold);
+        if (formatting.italic !== undefined)
+            run.setItalic(formatting.italic);
+        if (formatting.underline !== undefined)
+            run.setUnderline(formatting.underline);
+        if (formatting.strike !== undefined)
+            run.setStrike(formatting.strike);
+        if (formatting.subscript !== undefined)
+            run.setSubscript(formatting.subscript);
+        if (formatting.superscript !== undefined)
+            run.setSuperscript(formatting.superscript);
+        if (formatting.smallCaps !== undefined)
+            run.setSmallCaps(formatting.smallCaps);
+        if (formatting.allCaps !== undefined)
+            run.setAllCaps(formatting.allCaps);
+        if (formatting.font !== undefined)
+            run.setFont(formatting.font);
+        if (formatting.size !== undefined)
+            run.setSize(formatting.size);
+        if (formatting.color !== undefined)
+            run.setColor(formatting.color);
+        if (formatting.highlight !== undefined)
+            run.setHighlight(formatting.highlight);
+        if (formatting.characterSpacing !== undefined)
+            run.setCharacterSpacing(formatting.characterSpacing);
+        if (formatting.vanish !== undefined)
+            run.setVanish(formatting.vanish);
+    }
+    consolidateRuns() {
+        if (this.content.length < 2)
+            return 0;
+        const consolidated = [];
+        let eliminated = 0;
+        for (const item of this.content) {
+            if (!(item instanceof Run_1.Run)) {
+                consolidated.push(item);
+                continue;
+            }
+            const prev = consolidated.length > 0 ? consolidated[consolidated.length - 1] : undefined;
+            if (prev instanceof Run_1.Run &&
+                (0, formatting_1.isEqualFormatting)(prev.getFormatting(), item.getFormatting())) {
+                const mergedContent = [...prev.getContent(), ...item.getContent()];
+                const mergedRun = Run_1.Run.createFromContent(mergedContent, (0, deepClone_1.deepClone)(prev.getFormatting()));
+                consolidated[consolidated.length - 1] = mergedRun;
+                eliminated++;
+            }
+            else {
+                consolidated.push(item);
+            }
+        }
+        if (eliminated > 0) {
+            this.content = consolidated;
+        }
+        return eliminated;
+    }
     mergeWith(otherPara) {
         for (const item of otherPara.content) {
             if (item instanceof Run_1.Run) {