@syncfusion/ej2-docx 35.1.39 → 35.1.40

package/dist/global/index.d.ts

@@ -1,3 +1,12 @@
+/*!
+*  filename: index.d.ts
+*  version : 35.1.40
+*  Copyright Syncfusion Inc. 2001 - 2025. All rights reserved.
+*  Use of this code is subject to the terms of our license.
+*  A copy of the current license can be obtained at any time by e-mailing
+*  licensing@syncfusion.com. Any infringement will be prosecuted under
+*  applicable laws. 
+*/
 import * as _docx from '@syncfusion/ej2-docx';
 
 export declare namespace ej {

package/package.json

@@ -1,33 +1,33 @@
 {
-	"name": "@syncfusion/ej2-docx",
-	"version": "35.1.39",
-	"description": "The EJ2 DOCX library is utilized for creating, editing, and manipulating Word documents in JavaScript",
-	"author": "Syncfusion Inc.",
-	"license": "SEE LICENSE IN license",
-	"main": "./src/index.js",
-	"module": "./index.js",
-	"es2015": "./src/index.js",
-	"typings": "src/index.d.ts",
-	"devDependencies": {},
-	"dependencies": {
-		"@syncfusion/ej2-base": "~35.1.37"
-	},
-	"keywords": [
-		"ej2",
-		"syncfusion",
-		"ej2-docx",
-		"web-components",
-		"javascript",
-		"typescript",
-		"word",
-		"docx",
-		"ooxml",
-		"document-processing"
-	],
-	"repository": {
-    	"type": "git",
-    	"url": "https://github.com/syncfusion/ej2-javascript-ui-controls"
-  	},
-	"sideEffects": false,
-  	"homepage": "https://www.syncfusion.com/javascript-ui-controls"
+  "name": "@syncfusion/ej2-docx",
+  "version": "35.1.40",
+  "description": "The EJ2 DOCX library enables the creation, editing, and manipulation of Word documents in JavaScript.",
+  "author": "Syncfusion Inc.",
+  "license": "SEE LICENSE IN license",
+  "main": "./src/index.js",
+  "module": "./index.js",
+  "es2015": "./src/index.js",
+  "typings": "src/index.d.ts",
+  "devDependencies": {},
+  "dependencies": {
+    "@syncfusion/ej2-base": "~35.1.37"
+  },
+  "keywords": [
+    "ej2",
+    "syncfusion",
+    "ej2-docx",
+    "web-components",
+    "javascript",
+    "typescript",
+    "word",
+    "docx",
+    "ooxml",
+    "document-processing"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncfusion/ej2-javascript-ui-controls/tree/master/controls/docx"
+  },
+  "sideEffects": false,
+  "homepage": "https://www.syncfusion.com/javascript-ui-controls"
 }

package/src/features/document/alt-chunk.d.ts

@@ -90,7 +90,7 @@ export declare function altChunksInBlocks(blocks: ReadonlyArray<BlockContent>):
 /**
  * Modeled `w:altChunk` anchors in the Main Document body.
  *
- * @deprecated Use {@link WordDocument.altChunks} instead.
+
  * @private
  */
 export declare function altChunks(document: {

package/src/features/document/alt-chunk.js

@@ -192,7 +192,7 @@ export function altChunksInBlocks(blocks) {
 /**
  * Modeled `w:altChunk` anchors in the Main Document body.
  *
- * @deprecated Use {@link WordDocument.altChunks} instead.
+
  * @private
  */
 export function altChunks(document) {

package/src/features/document/augmentations.d.ts

@@ -262,7 +262,7 @@ declare module './index' {
         appendEndnote(text: string): import('../notes/index').Endnote;
         /**
          * Assign a list by numbering instance id (escape hatch). Prefer {@link Paragraph.listFormat}.
-         * @deprecated Prefer `listFormat` for customer-facing list authoring.
+
          */
         numbering: {
             numId: number;
@@ -529,7 +529,7 @@ declare module './paragraph' {
         appendEndnote(text: string): import('../notes/index').Endnote;
         /**
          * Assign a list by numbering instance id (escape hatch). Prefer {@link Paragraph.listFormat}.
-         * @deprecated Prefer `listFormat` for customer-facing list authoring.
+
          */
         numbering: {
             numId: number;

package/src/features/document/entity-type.d.ts

@@ -18,35 +18,35 @@ export declare enum EntityType {
     RowContentControl = 8,
     CellContentControl = 9,
     /**
-     * @deprecated Use {@link EntityType.BlockContentControl} instead.
+
      */
     StructureDocumentTag = 10,
     /**
-     * @deprecated Use {@link EntityType.InlineContentControl} instead.
+
      */
     StructureDocumentTagInline = 11,
     /**
-     * @deprecated Use {@link EntityType.RowContentControl} instead.
+
      */
     StructureDocumentTagRow = 12,
     /**
-     * @deprecated Use {@link EntityType.CellContentControl} instead.
+
      */
     StructureDocumentTagCell = 13,
     /**
-     * @deprecated Use {@link EntityType.BlockContentControl} instead.
+
      */
     SDTBlockContent = 14,
     /**
-     * @deprecated Use {@link EntityType.InlineContentControl} instead.
+
      */
     SDTInlineContent = 15,
     /**
-     * @deprecated Use {@link EntityType.RowContentControl} instead.
+
      */
     SDTRowContent = 16,
     /**
-     * @deprecated Use {@link EntityType.CellContentControl} instead.
+
      */
     SDTCellContent = 17,
     Table = 18,

package/src/features/document/entity-type.js

@@ -19,35 +19,35 @@ export var EntityType;
     EntityType[EntityType["RowContentControl"] = 8] = "RowContentControl";
     EntityType[EntityType["CellContentControl"] = 9] = "CellContentControl";
     /**
-     * @deprecated Use {@link EntityType.BlockContentControl} instead.
+
      */
     EntityType[EntityType["StructureDocumentTag"] = 10] = "StructureDocumentTag";
     /**
-     * @deprecated Use {@link EntityType.InlineContentControl} instead.
+
      */
     EntityType[EntityType["StructureDocumentTagInline"] = 11] = "StructureDocumentTagInline";
     /**
-     * @deprecated Use {@link EntityType.RowContentControl} instead.
+
      */
     EntityType[EntityType["StructureDocumentTagRow"] = 12] = "StructureDocumentTagRow";
     /**
-     * @deprecated Use {@link EntityType.CellContentControl} instead.
+
      */
     EntityType[EntityType["StructureDocumentTagCell"] = 13] = "StructureDocumentTagCell";
     /**
-     * @deprecated Use {@link EntityType.BlockContentControl} instead.
+
      */
     EntityType[EntityType["SDTBlockContent"] = 14] = "SDTBlockContent";
     /**
-     * @deprecated Use {@link EntityType.InlineContentControl} instead.
+
      */
     EntityType[EntityType["SDTInlineContent"] = 15] = "SDTInlineContent";
     /**
-     * @deprecated Use {@link EntityType.RowContentControl} instead.
+
      */
     EntityType[EntityType["SDTRowContent"] = 16] = "SDTRowContent";
     /**
-     * @deprecated Use {@link EntityType.CellContentControl} instead.
+
      */
     EntityType[EntityType["SDTCellContent"] = 17] = "SDTCellContent";
     EntityType[EntityType["Table"] = 18] = "Table";

package/src/features/document/length.d.ts

@@ -101,12 +101,12 @@ export declare function halfPoints(value: number): HalfPoints;
  */
 export declare function emus(value: number): Emus;
 /**
- * @internal @deprecated Prefer {@link pointToEmus}.
+ * @internal 
  * Residual alias — do not use in new code.
  */
 export declare function lengthToEmus(points: number): Emus;
 /**
- * @internal @deprecated Prefer {@link pointToHalfPoints}.
+ * @internal 
  * Residual alias — do not use in new code.
  */
 export declare function lengthToHalfPoints(points: number): HalfPoints;
@@ -123,30 +123,30 @@ export declare const LengthUnits: {
     HALF_POINTS_PER_PT: number;
     PT_PER_INCH: number;
 };
-/** @internal @deprecated Use plain point `number`. */
+/** @internal */
 export declare type Length = number;
-/** @internal @deprecated Use plain point `number`. */
+/** @internal */
 export declare type Point = number;
-/** @internal @deprecated Pass point numbers directly. */
+/** @internal */
 export declare function Pt(value: number): number;
-/** @internal @deprecated Use {@link inchesToPoint}. */
+/** @internal */
 export declare function Inches(value: number): number;
-/** @internal @deprecated Use {@link cmToPoint}. */
+/** @internal */
 export declare function Cm(value: number): number;
-/** @internal @deprecated Use {@link mmToPoint}. */
+/** @internal */
 export declare function Mm(value: number): number;
-/** @internal @deprecated Use {@link pxToPoint}. */
+/** @internal */
 export declare function Px(value: number): number;
-/** @internal @deprecated Use {@link twipsToPoint}. */
+/** @internal */
 export declare function Twips(value: number): number;
-/** @internal @deprecated Use {@link emuToPoint}. */
+/** @internal */
 export declare function Emu(value: number): number;
-/** @internal @deprecated Use {@link addPoints}. */
+/** @internal */
 export declare function add(a: number, b: number): number;
-/** @internal @deprecated Use {@link scalePoint}. */
+/** @internal */
 export declare function scale(points: number, factor: number): number;
 /**
- * @internal @deprecated Public API uses plain point numbers — do not call.
+ * @internal 
  * Identity helper retained only so residual dual-gap call sites compile during migration.
  */
 export declare function Point(value: number): number;

package/src/features/document/length.js

@@ -169,14 +169,14 @@ export function emus(value) {
     return value;
 }
 /**
- * @internal @deprecated Prefer {@link pointToEmus}.
+ * @internal 
  * Residual alias — do not use in new code.
  */
 export function lengthToEmus(points) {
     return pointToEmus(points);
 }
 /**
- * @internal @deprecated Prefer {@link pointToHalfPoints}.
+ * @internal 
  * Residual alias — do not use in new code.
  */
 export function lengthToHalfPoints(points) {
@@ -195,48 +195,48 @@ export var LengthUnits = {
     HALF_POINTS_PER_PT: HALF_POINTS_PER_PT,
     PT_PER_INCH: PT_PER_INCH,
 };
-/** @internal @deprecated Pass point numbers directly. */
+/** @internal */
 export function Pt(value) {
     assertFinite('Pt', value);
     return value;
 }
-/** @internal @deprecated Use {@link inchesToPoint}. */
+/** @internal */
 export function Inches(value) {
     return inchesToPoint(value);
 }
-/** @internal @deprecated Use {@link cmToPoint}. */
+/** @internal */
 export function Cm(value) {
     return cmToPoint(value);
 }
-/** @internal @deprecated Use {@link mmToPoint}. */
+/** @internal */
 export function Mm(value) {
     return mmToPoint(value);
 }
-/** @internal @deprecated Use {@link pxToPoint}. */
+/** @internal */
 export function Px(value) {
     return pxToPoint(value);
 }
-/** @internal @deprecated Use {@link twipsToPoint}. */
+/** @internal */
 export function Twips(value) {
     return twipsToPoint(value);
 }
-/** @internal @deprecated Use {@link emuToPoint}. */
+/** @internal */
 export function Emu(value) {
     if (!Number.isInteger(value)) {
         throw new RangeError("Emu must be an integer, got " + String(value));
     }
     return emuToPoint(value);
 }
-/** @internal @deprecated Use {@link addPoints}. */
+/** @internal */
 export function add(a, b) {
     return addPoints(a, b);
 }
-/** @internal @deprecated Use {@link scalePoint}. */
+/** @internal */
 export function scale(points, factor) {
     return scalePoint(points, factor);
 }
 /**
- * @internal @deprecated Public API uses plain point numbers — do not call.
+ * @internal 
  * Identity helper retained only so residual dual-gap call sites compile during migration.
  */
 export function Point(value) {

package/src/features/document/text-range.d.ts

@@ -373,7 +373,7 @@ export declare function serializeTextRange(textRange: TextRange): OpenXmlElement
  */
 export declare function serializeParagraphItems(items: ReadonlyArray<ParagraphItem>): OpenXmlElement[];
 /**
- * @deprecated Prefer {@link Break}. Public break view shape used by older APIs.
+
  * @private
  */
 export interface BreakLeaf {
@@ -382,27 +382,27 @@ export interface BreakLeaf {
     readonly clear: BreakClearType;
 }
 /**
- * @deprecated Prefer {@link Break}.
+
  * @private
  */
 export declare type BreakItem = Break;
 /**
- * @deprecated Prefer {@link Tab}.
+
  * @private
  */
 export declare type TabItem = Tab;
 /**
- * @deprecated Prefer {@link CarriageReturn}.
+
  * @private
  */
 export declare type CarriageReturnItem = CarriageReturn;
 /**
- * @deprecated Prefer {@link Symbol}.
+
  * @private
  */
 export declare type SymbolItem = Symbol;
 /**
- * @deprecated Prefer {@link ParagraphItemOwner}.
+
  * @private
  */
 export declare type Owner = ParagraphItemOwner;
@@ -414,27 +414,27 @@ export declare type Owner = ParagraphItemOwner;
  */
 export declare type ConcreteParagraphItem = TextRange | Tab | CarriageReturn | Symbol | Break | FeatureRunParagraphItem | FeatureInlineParagraphItem | OpaqueRunItem | OpaqueParagraphItem | Field | FieldMark;
 /**
- * @deprecated Prefer {@link ConcreteParagraphItem}.
+
  * @private
  */
 export declare type RunLeaf = ConcreteParagraphItem;
 /**
- * @deprecated Prefer {@link ConcreteParagraphItem}.
+
  * @private
  */
 export declare type InlineContent = ConcreteParagraphItem;
 /**
- * @deprecated Prefer {@link TextRange}.
+
  * @private
  */
 export declare const Run: typeof TextRange;
 /**
- * @deprecated Prefer {@link ParagraphItemOwner}.
+
  * @private
  */
 export declare type RunOwner = ParagraphItemOwner;
 /**
- * @deprecated Prefer {@link serializeTextRange}.
+
  * @private
  */
 export declare const serializeRun: typeof serializeTextRange;

package/src/features/document/text-range.js

@@ -1134,12 +1134,12 @@ export function serializeParagraphItems(items) {
     return out;
 }
 /**
- * @deprecated Prefer {@link TextRange}.
+
  * @private
  */
 export var Run = TextRange;
 /**
- * @deprecated Prefer {@link serializeTextRange}.
+
  * @private
  */
 export var serializeRun = serializeTextRange;

package/src/features/drawing/drawing-shape.d.ts

@@ -426,7 +426,7 @@ export declare class DrawingShape implements FeatureRunLeaf, FillFormatOwner, Li
      */
     extent(): DrawingExtent | undefined;
     /**
-     * @deprecated Use {@link DrawingShape.extent} instead. Returns raw EMU
+
      * numbers; kept for back-compat with existing feature-module tests.
      *
      * @private

package/src/features/drawing/drawing-shape.js

@@ -1013,7 +1013,7 @@ var DrawingShape = /** @class */ (function () {
         return undefined;
     };
     /**
-     * @deprecated Use {@link DrawingShape.extent} instead. Returns raw EMU
+
      * numbers; kept for back-compat with existing feature-module tests.
      *
      * @private

package/src/features/editable-ranges/index.d.ts

@@ -213,7 +213,7 @@ export declare class EditableRange {
      * Requires a document walk; pass the owning document via
      * {@link editableRangeMarkersShareParagraph}.
      *
-     * @deprecated Prefer {@link editableRangeMarkersShareParagraph}.
+
      * @private
      */
     markersShareParagraph(document: WordDocument): boolean;

package/src/features/editable-ranges/index.js

@@ -452,7 +452,7 @@ var EditableRange = /** @class */ (function () {
      * Requires a document walk; pass the owning document via
      * {@link editableRangeMarkersShareParagraph}.
      *
-     * @deprecated Prefer {@link editableRangeMarkersShareParagraph}.
+
      * @private
      */
     EditableRange.prototype.markersShareParagraph = function (document) {

package/src/features/headers-footers/index.d.ts

@@ -403,7 +403,7 @@ declare module '../sections/index' {
          * @param refType - Header slot (`default` | `first` | `even`). Defaults to `default`.
          * @returns {@link HeaderFooter} view, or `undefined` when no reference or part is missing.
          *
-         * @deprecated Prefer {@link PageSetup.oddHeader}, {@link PageSetup.firstPageHeader},
+
          * or {@link PageSetup.evenHeader}.
          * @public
          */
@@ -415,7 +415,7 @@ declare module '../sections/index' {
          * @param refType - Footer slot (`default` | `first` | `even`). Defaults to `default`.
          * @returns {@link HeaderFooter} view, or `undefined` when no reference or part is missing.
          *
-         * @deprecated Prefer {@link PageSetup.oddFooter}, {@link PageSetup.firstPageFooter},
+
          * or {@link PageSetup.evenFooter}.
          * @public
          */
@@ -428,7 +428,7 @@ declare module '../sections/index' {
          * @param refType - Header slot. Defaults to `default`.
          * @returns Live {@link HeaderFooter} view.
          *
-         * @deprecated Prefer property access (`oddHeader` / `firstPageHeader` / `evenHeader`).
+/ `firstPageHeader` / `evenHeader`).
          * @public
          */
         getOrCreateHeader(refType?: HeaderFooterReferenceType): HeaderFooter;
@@ -440,7 +440,7 @@ declare module '../sections/index' {
          * @param refType - Footer slot. Defaults to `default`.
          * @returns Live {@link HeaderFooter} view.
          *
-         * @deprecated Prefer property access (`oddFooter` / `firstPageFooter` / `evenFooter`).
+/ `firstPageFooter` / `evenFooter`).
          * @public
          */
         getOrCreateFooter(refType?: HeaderFooterReferenceType): HeaderFooter;
@@ -453,7 +453,7 @@ declare module '../sections/index' {
          * @throws DocxError `content/invalid-header-footer-reference` when the
          * relationship is not loaded in this document.
          *
-         * @deprecated Prefer assigning `section.oddHeader = header` (or firstPage/even).
+/even).
          * @public
          */
         linkHeader(header: HeaderFooter, refType?: HeaderFooterReferenceType): void;
@@ -466,7 +466,7 @@ declare module '../sections/index' {
          * @throws DocxError `content/invalid-header-footer-reference` when the
          * relationship is not loaded in this document.
          *
-         * @deprecated Prefer assigning `section.oddFooter = footer` (or firstPage/even).
+/even).
          * @public
          */
         linkFooter(footer: HeaderFooter, refType?: HeaderFooterReferenceType): void;
@@ -477,7 +477,7 @@ declare module '../sections/index' {
          *
          * @param refType - Header slot. Defaults to `default`.
          *
-         * @deprecated Prefer `section.oddHeader = undefined` (or firstPage/even).
+/even).
          * @public
          */
         removeHeader(refType?: HeaderFooterReferenceType): void;
@@ -488,7 +488,7 @@ declare module '../sections/index' {
          *
          * @param refType - Footer slot. Defaults to `default`.
          *
-         * @deprecated Prefer `section.oddFooter = undefined` (or firstPage/even).
+/even).
          * @public
          */
         removeFooter(refType?: HeaderFooterReferenceType): void;

package/src/features/headers-footers/index.js

@@ -1577,7 +1577,7 @@ defineSectionHeaderFooterProperty('firstPageFooter', 'first');
 defineSectionHeaderFooterProperty('evenHeader', 'even');
 defineSectionHeaderFooterProperty('evenFooter', 'even');
 /**
- * @deprecated Prefer {@link PageSetup.oddHeader}, {@link PageSetup.firstPageHeader},
+
  * or {@link PageSetup.evenHeader}. Returns the live header when already linked; does not create.
  */
 PageSetup.prototype.header = function (refType) {
@@ -1585,7 +1585,7 @@ PageSetup.prototype.header = function (refType) {
     return headerForSection(document, this, resolveRefType(refType));
 };
 /**
- * @deprecated Prefer {@link PageSetup.oddFooter}, {@link PageSetup.firstPageFooter},
+
  * or {@link PageSetup.evenFooter}. Returns the live footer when already linked; does not create.
  */
 PageSetup.prototype.footer = function (refType) {
@@ -1593,42 +1593,42 @@ PageSetup.prototype.footer = function (refType) {
     return footerForSection(document, this, resolveRefType(refType));
 };
 /**
- * @deprecated Prefer property access (`oddHeader` / `firstPageHeader` / `evenHeader`).
+/ `firstPageHeader` / `evenHeader`).
  */
 PageSetup.prototype.getOrCreateHeader = function (refType) {
     var document = requireAssociatedSectionDocument(this);
     return getOrCreateSectionHeader(document, this, resolveRefType(refType));
 };
 /**
- * @deprecated Prefer property access (`oddFooter` / `firstPageFooter` / `evenFooter`).
+/ `firstPageFooter` / `evenFooter`).
  */
 PageSetup.prototype.getOrCreateFooter = function (refType) {
     var document = requireAssociatedSectionDocument(this);
     return getOrCreateSectionFooter(document, this, resolveRefType(refType));
 };
 /**
- * @deprecated Prefer assigning `section.oddHeader = header` (or firstPage/even).
+/even).
  */
 PageSetup.prototype.linkHeader = function (header, refType) {
     var document = requireAssociatedSectionDocument(this);
     linkSectionHeader(document, this, header.relationshipId, resolveRefType(refType));
 };
 /**
- * @deprecated Prefer assigning `section.oddFooter = footer` (or firstPage/even).
+/even).
  */
 PageSetup.prototype.linkFooter = function (footer, refType) {
     var document = requireAssociatedSectionDocument(this);
     linkSectionFooter(document, this, footer.relationshipId, resolveRefType(refType));
 };
 /**
- * @deprecated Prefer `section.oddHeader = undefined` (or firstPage/even).
+/even).
  */
 PageSetup.prototype.removeHeader = function (refType) {
     requireAssociatedSectionDocument(this);
     this.setHeaderFooterReference('header', resolveRefType(refType), undefined);
 };
 /**
- * @deprecated Prefer `section.oddFooter = undefined` (or firstPage/even).
+/even).
  */
 PageSetup.prototype.removeFooter = function (refType) {
     requireAssociatedSectionDocument(this);

package/src/features/images/caption-authoring-api.d.ts

@@ -18,16 +18,16 @@ export declare function providePictureCaptionAuthoring(impl: AddCaptionToPicture
  */
 export declare function requirePictureCaptionAuthoring(): AddCaptionToPicture;
 /**
- * @deprecated Use {@link AddCaptionToPicture} instead.
+
  */
 export declare type AddCaptionToImage = AddCaptionToPicture;
 /**
  * @private
- * @deprecated Use {@link providePictureCaptionAuthoring} instead.
+
  */
 export declare function provideImageCaptionAuthoring(impl: AddCaptionToPicture): void;
 /**
  * @private
- * @deprecated Use {@link requirePictureCaptionAuthoring} instead.
+
  */
 export declare function requireImageCaptionAuthoring(): AddCaptionToPicture;

package/src/features/images/caption-authoring-api.js

@@ -19,14 +19,14 @@ export function requirePictureCaptionAuthoring() {
 }
 /**
  * @private
- * @deprecated Use {@link providePictureCaptionAuthoring} instead.
+
  */
 export function provideImageCaptionAuthoring(impl) {
     providePictureCaptionAuthoring(impl);
 }
 /**
  * @private
- * @deprecated Use {@link requirePictureCaptionAuthoring} instead.
+
  */
 export function requireImageCaptionAuthoring() {
     return requirePictureCaptionAuthoring();

package/src/features/images/captions.d.ts

@@ -7,7 +7,7 @@ import { Picture } from './index';
  */
 export declare function addCaptionToPicture(picture: Picture, captionName: string, numberingFormat: CaptionNumberingFormatValue, position: CaptionPositionValue): Paragraph;
 /**
- * @deprecated Use {@link addCaptionToPicture} instead.
+
  * @private
  */
 export declare function addCaptionToImage(image: Picture, captionName: string, numberingFormat: CaptionNumberingFormatValue, position: CaptionPositionValue): Paragraph;