node-pptx-templater 1.1.3 → 1.1.6

package/CHANGELOG.md

@@ -5,22 +5,6 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.1.3] - 2026-06-22
-
-### Fixed
-
-- **Layout Preservation in `addCellShape()`**: Fixed a critical layout bug where querying cell bounds or adding cell shapes dynamically (via `addCellShape()` or `updateCellShape()`) mutated table row heights inside the XML. The sizing/positioning logic now runs in a layout-only mode, keeping the table XML completely untouched and respecting original template custom row heights.
-
-## [1.1.2] - 2026-06-22
-
-### Fixed
-
-- **Slide Link Relationships Target Paths**: Fixed PowerPoint "Repair Mode" errors when adding slide-to-slide hyperlinks (via `addSlideLink` or `addImageLink`). The relative target path resolves correctly to the sibling filename `slideX.xml` instead of using the redundant parent prefix `../slides/slideX.xml` (which exited and re-entered the same directory, violating PowerPoint's relative path resolution rules).
-
-### Added
-
-- **Redundant Traversal Validation**: Added automated check in `ValidationEngine` to identify and error on redundant relative path traversals inside relationship files (e.g. referencing `../slides/slideX.xml` from a source slide file already located in `ppt/slides/`).
-
 ## [1.1.0] - 2026-06-12
 
 ### Added

package/README.md

@@ -172,51 +172,27 @@ const meta = await ppt.getTableRows('SalesTable', { includeMetadata: true });
 ```
 
 ### Table Cell Shapes
-Cell shapes are overlay graphics anchored within table cells. They are positioned absolutely based on cell bounds, and **never** modify row heights, column widths, cell margins, or trigger table reflow.
-
-#### Merged Cell Support
-When targeting a merged cell (spanned using `rowSpan` or `colSpan`), `addCellShape()` dynamically resolves the **actual rendered bounds** of the entire merged cell region (summing the width and height of the spanned rows/columns). The shape is positioned and aligned relative to this final merged boundary. Any offset `x` and `y` specified is interpreted relative to the top-left corner of the resolved merged cell region.
-
-#### Alignment & Presets
-Shapes can be aligned dynamically within the cell (or merged region) using preset positions or explicit alignments:
-* **Presets**: Use `position` values like `'top-left'`, `'center'`, `'bottom-right'`, etc.
-* **Alignment Options**: Set `alignX: 'left' | 'center' | 'right'` and `alignY: 'top' | 'middle' | 'bottom'`. If no alignments or offsets are provided, shapes default to true centering (`'center'`/`'middle'`).
-* **Offsets & Padding**: Offsets (`x`, `y`) are applied relative to the resolved alignment. For instance, when `alignX: 'right'` is used, the shape is placed at `cellRight - shapeWidth - x` (defaulting to a `5px` padding if `x` is omitted).
+Cell shapes are overlay graphics anchored within table cells. They are positioned absolutely based on cell bounds, and **never** modify row heights, column widths, cell margins, or trigger table reflow. Offsets (`x`, `y`) are relative to the cell's top-left corner. Oversized shapes are scaled down proportionally to fit inside the cell.
 
 ```javascript
-// Add a status icon centered in a merged cell (rowSpan=2, colSpan=2)
-await ppt.addCellShape('StatusTable', 1, 1, {
+// Add a simple indicator
+await ppt.addCellShape('SalesTable', 2, 1, {
   type: 'circle',
   width: 12,
   height: 12,
-  fill: '#10B981', // Green status dot
-  alignX: 'center',
-  alignY: 'middle' // Visually centered in the merged cell
+  fill: '#10B981' // Green status dot
 });
 
-// Add a badge with text and explicit offsets inside a merged cell
-await ppt.addCellShape('StatusTable', 1, 1, {
+// Add a badge with text and custom offsets
+await ppt.addCellShape('SalesTable', 1, 2, {
   type: 'badge',
-  text: 'Urgent',
-  fill: '#EF4444',
-  alignX: 'left',
-  alignY: 'top',
-  x: 5,
-  y: 3,
+  text: 'Active',
+  fill: '#3B82F6',
+  x: 4,
+  y: 2,
   width: 50,
   height: 16
 });
-
-// Add an indicator with bottom-right alignment and custom padding
-await ppt.addCellShape('StatusTable', 1, 1, {
-  type: 'icon',
-  icon: 'up',
-  size: 14,
-  alignX: 'right',
-  alignY: 'bottom',
-  x: 4,
-  y: 2
-});
 ```
 
 ### XML Folder Workflow

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-pptx-templater",
-  "version": "1.1.3",
+  "version": "1.1.6",
   "description": "High-performance, low-level PowerPoint (PPTX) OpenXML template engine for Node.js. Dynamically replace text, insert images, update charts (with Excel workbook data caching), and merge table cells without PowerPoint corruption or Repair Mode prompts.",
   "main": "./src/index.js",
   "type": "commonjs",
@@ -37,7 +37,6 @@
     "example:table-extraction": "node examples/table-extraction.js",
     "example:nested-rows": "node examples/nested-table-rows.js",
     "example:xml-folder": "node examples/xml-folder-workflow.js",
-    "example:all": "node scripts/run-examples-check.js",
     "prepublishOnly": "npm run lint && npm run test"
   },
   "keywords": [

package/src/core/PPTXTemplater.js

@@ -473,10 +473,14 @@ class PPTXTemplater {
         throw new PPTXError(`Destination is a file: ${outputPath}`)
       }
       const files = fs.readdirSync(resolvedOut)
-      if (files.length > 0 && !options.overwrite) {
-        throw new PPTXError(
-          `Destination directory "${outputPath}" is not empty. Set overwrite: true to overwrite.`
-        )
+      if (files.length > 0) {
+        if (!options.overwrite) {
+          throw new PPTXError(
+            `Destination directory "${outputPath}" is not empty. Set overwrite: true to overwrite.`
+          )
+        } else {
+          await fs.emptyDir(resolvedOut)
+        }
       }
     } else {
       await fs.ensureDir(resolvedOut)
@@ -1591,7 +1595,14 @@ class PPTXTemplater {
     this.#assertLoaded()
     const targetIndices = this.#getTargetSlideIndices()
     for (const idx of targetIndices) {
-      this.#tableManager.addTableRow(idx, tableId, rowData, this.#slideManager, options)
+      this.#tableManager.addTableRow(
+        idx,
+        tableId,
+        rowData,
+        this.#slideManager,
+        this.#shapeManager,
+        options
+      )
     }
     return this
   }
@@ -1610,7 +1621,13 @@ class PPTXTemplater {
     this.#assertLoaded()
     const targetIndices = this.#getTargetSlideIndices()
     for (const idx of targetIndices) {
-      this.#tableManager.removeTableRow(idx, tableId, rowIndex, this.#slideManager)
+      this.#tableManager.removeTableRow(
+        idx,
+        tableId,
+        rowIndex,
+        this.#slideManager,
+        this.#shapeManager
+      )
     }
     return this
   }
@@ -1630,7 +1647,14 @@ class PPTXTemplater {
     this.#assertLoaded()
     const targetIndices = this.#getTargetSlideIndices()
     for (const idx of targetIndices) {
-      this.#tableManager.insertTableRow(idx, tableId, rowIndex, rowData, this.#slideManager)
+      this.#tableManager.insertTableRow(
+        idx,
+        tableId,
+        rowIndex,
+        rowData,
+        this.#slideManager,
+        this.#shapeManager
+      )
     }
     return this
   }
@@ -1655,7 +1679,8 @@ class PPTXTemplater {
         tableId,
         sourceRowIndex,
         targetRowIndex,
-        this.#slideManager
+        this.#slideManager,
+        this.#shapeManager
       )
     }
     return this
@@ -1735,7 +1760,16 @@ class PPTXTemplater {
     }
 
     for (const idx of targetIndices) {
-      this.#tableManager.mergeCells(idx, tableId, sRow, sCol, eRow, eCol, this.#slideManager)
+      this.#tableManager.mergeCells(
+        idx,
+        tableId,
+        sRow,
+        sCol,
+        eRow,
+        eCol,
+        this.#slideManager,
+        this.#shapeManager
+      )
     }
     return this
   }
@@ -1786,9 +1820,25 @@ class PPTXTemplater {
 
     for (const idx of targetIndices) {
       if (isCellCoord) {
-        this.#tableManager.unmergeCells(idx, tableId, cellRow, cellCol, this.#slideManager)
+        this.#tableManager.unmergeCells(
+          idx,
+          tableId,
+          cellRow,
+          cellCol,
+          this.#slideManager,
+          this.#shapeManager
+        )
       } else {
-        this.#tableManager.unmergeCells(idx, tableId, sRow, sCol, eRow, eCol, this.#slideManager)
+        this.#tableManager.unmergeCells(
+          idx,
+          tableId,
+          sRow,
+          sCol,
+          eRow,
+          eCol,
+          this.#slideManager,
+          this.#shapeManager
+        )
       }
     }
     return this