docxmlater 11.0.4 → 11.0.6

package/dist/esm/elements/ImageRun.js

@@ -20,9 +20,14 @@ export class ImageRun extends Run {
             return { name: '__rawXml', rawXml: this._rawRunXml };
         }
         const drawing = this.imageElement.toXML();
+        const children = [];
+        const rPr = Run.generateRunPropertiesXML(this.getFormatting());
+        if (rPr)
+            children.push(rPr);
+        children.push(drawing);
         return {
             name: 'w:r',
-            children: [drawing],
+            children,
         };
     }
 }

package/dist/esm/elements/ImageRun.js.map

@@ -1 +1 @@
-{"version":3,"file":"ImageRun.js","sourceRoot":"","sources":["../../../src/elements/ImageRun.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAgB/B,MAAM,OAAO,QAAS,SAAQ,GAAG;IACvB,YAAY,CAAQ;IACpB,UAAU,CAAU;IAM5B,YAAY,KAAY;QAGtB,KAAK,CAAC,EAAE,CAAC,CAAC;QACV,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,GAAW;QACtB,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAMD,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAOD,KAAK;QACH,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB,CAAC;IACJ,CAAC;CACF","sourcesContent":["/**\n * ImageRun - A run that contains an image (drawing)\n * Extends Run class for type-safe paragraph content\n *\n * This is a specialized Run that contains a drawing instead of text.\n * It generates proper w:r (run) XML with w:drawing child element.\n */\n\nimport { Run } from './Run.js';\nimport { Image } from './Image.js';\nimport { XMLElement } from '../xml/XMLBuilder.js';\n\n/**\n * ImageRun - A run containing an embedded image\n *\n * In WordprocessingML, images are embedded in runs as drawing elements:\n * <w:r>\n *   <w:drawing>\n *     <wp:inline>\n *       ... image data ...\n *     </wp:inline>\n *   </w:drawing>\n * </w:r>\n */\nexport class ImageRun extends Run {\n  private imageElement: Image;\n  private _rawRunXml?: string;\n\n  /**\n   * Creates a new image run\n   * @param image The image to embed in this run\n   */\n  constructor(image: Image) {\n    // Call parent constructor with empty text\n    // The text is irrelevant for image runs\n    super('');\n    this.imageElement = image;\n  }\n\n  setRawRunXml(xml: string): void {\n    this._rawRunXml = xml;\n  }\n\n  getRawRunXml(): string | undefined {\n    return this._rawRunXml;\n  }\n\n  /**\n   * Gets the image element\n   * @returns Image instance\n   */\n  getImageElement(): Image {\n    return this.imageElement;\n  }\n\n  /**\n   * Override toXML to generate image-specific XML\n   * Generates a w:r element containing w:drawing instead of w:t\n   * @returns XMLElement with w:r containing w:drawing\n   */\n  toXML(): XMLElement {\n    if (this._rawRunXml) {\n      return { name: '__rawXml', rawXml: this._rawRunXml };\n    }\n    const drawing = this.imageElement.toXML();\n    return {\n      name: 'w:r',\n      children: [drawing],\n    };\n  }\n}\n"]}
+{"version":3,"file":"ImageRun.js","sourceRoot":"","sources":["../../../src/elements/ImageRun.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAgB/B,MAAM,OAAO,QAAS,SAAQ,GAAG;IACvB,YAAY,CAAQ;IACpB,UAAU,CAAU;IAM5B,YAAY,KAAY;QAGtB,KAAK,CAAC,EAAE,CAAC,CAAC;QACV,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,GAAW;QACtB,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAMD,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAOD,KAAK;QACH,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAiB,EAAE,CAAC;QAMlC,MAAM,GAAG,GAAG,GAAG,CAAC,wBAAwB,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAC/D,IAAI,GAAG;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,QAAQ;SACT,CAAC;IACJ,CAAC;CACF","sourcesContent":["/**\n * ImageRun - A run that contains an image (drawing)\n * Extends Run class for type-safe paragraph content\n *\n * This is a specialized Run that contains a drawing instead of text.\n * It generates proper w:r (run) XML with w:drawing child element.\n */\n\nimport { Run } from './Run.js';\nimport { Image } from './Image.js';\nimport { XMLElement } from '../xml/XMLBuilder.js';\n\n/**\n * ImageRun - A run containing an embedded image\n *\n * In WordprocessingML, images are embedded in runs as drawing elements:\n * <w:r>\n *   <w:drawing>\n *     <wp:inline>\n *       ... image data ...\n *     </wp:inline>\n *   </w:drawing>\n * </w:r>\n */\nexport class ImageRun extends Run {\n  private imageElement: Image;\n  private _rawRunXml?: string;\n\n  /**\n   * Creates a new image run\n   * @param image The image to embed in this run\n   */\n  constructor(image: Image) {\n    // Call parent constructor with empty text\n    // The text is irrelevant for image runs\n    super('');\n    this.imageElement = image;\n  }\n\n  setRawRunXml(xml: string): void {\n    this._rawRunXml = xml;\n  }\n\n  getRawRunXml(): string | undefined {\n    return this._rawRunXml;\n  }\n\n  /**\n   * Gets the image element\n   * @returns Image instance\n   */\n  getImageElement(): Image {\n    return this.imageElement;\n  }\n\n  /**\n   * Override toXML to generate image-specific XML\n   * Generates a w:r element containing w:drawing instead of w:t\n   * @returns XMLElement with w:r containing w:drawing\n   */\n  toXML(): XMLElement {\n    if (this._rawRunXml) {\n      return { name: '__rawXml', rawXml: this._rawRunXml };\n    }\n    const drawing = this.imageElement.toXML();\n    const children: XMLElement[] = [];\n    // Per ECMA-376 §17.3.2.28, w:rPr (if present) must precede the run's\n    // content. For runs containing an inline drawing, the rPr's w:rFonts\n    // affects line metrics in Word; dropping it shifts the baseline and\n    // can let images (with shadow effectExtent) overflow their containing\n    // cell. Emit rPr whenever the run carries formatting.\n    const rPr = Run.generateRunPropertiesXML(this.getFormatting());\n    if (rPr) children.push(rPr);\n    children.push(drawing);\n    return {\n      name: 'w:r',\n      children,\n    };\n  }\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docxmlater",
-  "version": "11.0.4",
-  "description": "A comprehensive DOCX editing framework for creating, reading, and manipulating Microsoft Word documents",
+  "version": "11.0.6",
+  "description": "TypeScript library for editing existing Word documents with full tracked-changes, comment, and bookmark fidelity. Round-trip safe DOCX modification.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -52,18 +52,29 @@
     "document",
     "office",
     "openxml",
+    "ooxml",
+    "ecma-376",
     "xml",
     "wordprocessingml",
     "microsoft-word",
-    "document-generation",
     "docx-editor",
-    "openxml-sdk"
+    "edit-docx",
+    "modify-docx",
+    "docx-typescript",
+    "tracked-changes",
+    "track-changes",
+    "revisions",
+    "comments",
+    "bookmarks",
+    "round-trip",
+    "openxml-sdk",
+    "docxtemplater-alternative"
   ],
   "author": "DiaTech",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ItMeDiaTech/docXMLater.git"
+    "url": "git+https://github.com/ItMeDiaTech/docXMLater.git"
   },
   "bugs": {
     "url": "https://github.com/ItMeDiaTech/docXMLater/issues"

package/src/core/DocumentParser.ts

@@ -1349,6 +1349,11 @@ export class DocumentParser {
                 imageManager
               );
               if (imageRun) {
+                // Preserve the parent run's w:rPr (rFonts, noProof, b, etc.)
+                // — without this, ImageRun.toXML() emits <w:r><w:drawing/></w:r>
+                // and Word recalculates line height with the default font,
+                // shifting the image and clipping it into adjacent cells.
+                this.parseRunPropertiesFromObject(runObj['w:rPr'], imageRun);
                 paragraph.addRun(imageRun);
               }
             }
@@ -2123,6 +2128,7 @@ export class DocumentParser {
                     imageManager
                   );
                   if (imageRun) {
+                    this.parseRunPropertiesFromObject(child['w:rPr'], imageRun);
                     paragraph.addRun(imageRun);
                   }
                 }
@@ -2184,6 +2190,7 @@ export class DocumentParser {
                 imageManager
               );
               if (imageRun) {
+                this.parseRunPropertiesFromObject(child['w:rPr'], imageRun);
                 paragraph.addRun(imageRun);
               }
             }

package/src/elements/ImageRun.ts

@@ -63,9 +63,18 @@ export class ImageRun extends Run {
       return { name: '__rawXml', rawXml: this._rawRunXml };
     }
     const drawing = this.imageElement.toXML();
+    const children: XMLElement[] = [];
+    // Per ECMA-376 §17.3.2.28, w:rPr (if present) must precede the run's
+    // content. For runs containing an inline drawing, the rPr's w:rFonts
+    // affects line metrics in Word; dropping it shifts the baseline and
+    // can let images (with shadow effectExtent) overflow their containing
+    // cell. Emit rPr whenever the run carries formatting.
+    const rPr = Run.generateRunPropertiesXML(this.getFormatting());
+    if (rPr) children.push(rPr);
+    children.push(drawing);
     return {
       name: 'w:r',
-      children: [drawing],
+      children,
     };
   }
 }