node-pptx-templater 1.0.2 → 1.0.3

package/src/managers/charts/ChartCacheGenerator.js

@@ -1,7 +1,4 @@
-const { createLogger } = require('../../utils/logger.js');
-const { ChartWorkbookUpdater } = require('./ChartWorkbookUpdater.js');
-
-const logger = createLogger('ChartCacheGenerator');
+const { ChartWorkbookUpdater } = require('./ChartWorkbookUpdater.js')
 
 class ChartCacheGenerator {
   /**
@@ -10,8 +7,8 @@ class ChartCacheGenerator {
   static generateStrCache(values) {
     const ptEntries = values
       .map((val, i) => `<c:pt idx="${i}"><c:v>${this.#escapeXml(String(val))}</c:v></c:pt>`)
-      .join('');
-    return `<c:strCache><c:ptCount val="${values.length}"/>${ptEntries}</c:strCache>`;
+      .join('')
+    return `<c:strCache><c:ptCount val="${values.length}"/>${ptEntries}</c:strCache>`
   }
 
   /**
@@ -20,8 +17,8 @@ class ChartCacheGenerator {
   static generateNumCache(values) {
     const ptEntries = values
       .map((val, i) => `<c:pt idx="${i}"><c:v>${Number(val) || 0}</c:v></c:pt>`)
-      .join('');
-    return `<c:numCache><c:formatCode>General</c:formatCode><c:ptCount val="${values.length}"/>${ptEntries}</c:numCache>`;
+      .join('')
+    return `<c:numCache><c:formatCode>General</c:formatCode><c:ptCount val="${values.length}"/>${ptEntries}</c:numCache>`
   }
 
   /**
@@ -32,117 +29,137 @@ class ChartCacheGenerator {
    * @param {string} sheetName - Target worksheet name.
    */
   static updateCategories(xml, categories, sheetName = 'Sheet1') {
-    const count = categories.length;
+    const count = categories.length
 
     // Formula for categories: Sheet1!$A$2:$A$N
-    const formula = ChartWorkbookUpdater.getFormulaRange(sheetName, 2, 0, count + 1, 0);
-    const newStrCache = this.generateStrCache(categories);
+    const formula = ChartWorkbookUpdater.getFormulaRange(sheetName, 2, 0, count + 1, 0)
+    const newStrCache = this.generateStrCache(categories)
 
     // Replace the entire <c:cat> block to ensure correct formula and cache
-    const catPattern = /(<c:cat>)([\s\S]*?)(<\/c:cat>)/g;
+    const catPattern = /(<c:cat>)([\s\S]*?)(<\/c:cat>)/g
 
     return xml.replace(catPattern, (match, open, content, close) => {
       // Reconstruct the cat block
       // Try to determine if it used strRef or numRef originally
-      let refTag = content.includes('<c:numRef>') ? 'numRef' : 'strRef';
+      let refTag = content.includes('<c:numRef>') ? 'numRef' : 'strRef'
       // But typically categories are strings. Let's use strRef.
-      refTag = 'strRef';
+      refTag = 'strRef'
 
-      return `${open}<c:${refTag}><c:f>${formula}</c:f>${newStrCache}</c:${refTag}>${close}`;
-    });
+      return `${open}<c:${refTag}><c:f>${formula}</c:f>${newStrCache}</c:${refTag}>${close}`
+    })
   }
 
   /**
    * Updates series names and values in chart XML.
    */
   static updateSeries(xml, series, categoriesLength, sheetName = 'Sheet1') {
-    let updated = xml;
-    const serPattern = /(<c:ser>)([\s\S]*?)(<\/c:ser>)/g;
-    const serMatches = [...updated.matchAll(serPattern)];
+    let updated = xml
+    const serPattern = /(<c:ser>)([\s\S]*?)(<\/c:ser>)/g
+    const serMatches = [...updated.matchAll(serPattern)]
 
-    if (serMatches.length === 0) return xml;
+    if (serMatches.length === 0) return xml
 
-    let serIndex = 0;
+    let serIndex = 0
     updated = updated.replace(serPattern, (match, open, content, close) => {
       if (serIndex >= series.length) {
         // If there are more series templates than data, we could drop them,
         // but replacing with an empty string might break the XML layout if we're not careful.
         // Actually, removing extra series is requested: "Allow removing old series".
-        return '';
+        return ''
       }
 
-      const serData = series[serIndex];
-      const colIndex = serIndex + 1; // Series data starts in column B (1)
-      serIndex++;
+      const serData = series[serIndex]
+      const colIndex = serIndex + 1 // Series data starts in column B (1)
+      serIndex++
 
-      let updatedContent = content;
+      let updatedContent = content
 
       // 1. Update Series Name (c:tx)
       if (serData.name !== undefined) {
-        const nameFormula = ChartWorkbookUpdater.getFormulaSingleCell(sheetName, 1, colIndex);
-        const nameCache = `<c:strCache><c:ptCount val="1"/><c:pt idx="0"><c:v>${this.#escapeXml(serData.name)}</c:v></c:pt></c:strCache>`;
+        const nameFormula = ChartWorkbookUpdater.getFormulaSingleCell(sheetName, 1, colIndex)
+        const nameCache = `<c:strCache><c:ptCount val="1"/><c:pt idx="0"><c:v>${this.#escapeXml(serData.name)}</c:v></c:pt></c:strCache>`
 
-        const txPattern = /(<c:tx>)([\s\S]*?)(<\/c:tx>)/;
+        const txPattern = /(<c:tx>)([\s\S]*?)(<\/c:tx>)/
         if (txPattern.test(updatedContent)) {
           updatedContent = updatedContent.replace(txPattern, (match, p1, p2, p3) => {
-            return `${p1}<c:strRef><c:f>${nameFormula}</c:f>${nameCache}</c:strRef>${p3}`;
-          });
+            return `${p1}<c:strRef><c:f>${nameFormula}</c:f>${nameCache}</c:strRef>${p3}`
+          })
         } else {
           // Some charts don't have <c:tx>, we prepend it after <c:order> or <c:idx>
-          const insertAfter = /(<c:order[^>]*>)/;
+          const insertAfter = /(<c:order[^>]*>)/
           if (insertAfter.test(updatedContent)) {
             updatedContent = updatedContent.replace(insertAfter, (match, p1) => {
-              return `${p1}<c:tx><c:strRef><c:f>${nameFormula}</c:f>${nameCache}</c:strRef></c:tx>`;
-            });
+              return `${p1}<c:tx><c:strRef><c:f>${nameFormula}</c:f>${nameCache}</c:strRef></c:tx>`
+            })
           }
         }
       }
 
       // 2. Update Series Values (c:val)
       if (serData.values !== undefined) {
-        const valuesCount = categoriesLength || serData.values.length;
-        const valFormula = ChartWorkbookUpdater.getFormulaRange(sheetName, 2, colIndex, valuesCount + 1, colIndex);
-        const valCache = this.generateNumCache(serData.values);
-
-        const valPattern = /(<c:val>)([\s\S]*?)(<\/c:val>)/;
+        const valuesCount = categoriesLength || serData.values.length
+        const valFormula = ChartWorkbookUpdater.getFormulaRange(
+          sheetName,
+          2,
+          colIndex,
+          valuesCount + 1,
+          colIndex
+        )
+        const valCache = this.generateNumCache(serData.values)
+
+        const valPattern = /(<c:val>)([\s\S]*?)(<\/c:val>)/
         if (valPattern.test(updatedContent)) {
           updatedContent = updatedContent.replace(valPattern, (match, p1, p2, p3) => {
-            return `${p1}<c:numRef><c:f>${valFormula}</c:f>${valCache}</c:numRef>${p3}`;
-          });
+            return `${p1}<c:numRef><c:f>${valFormula}</c:f>${valCache}</c:numRef>${p3}`
+          })
         }
       }
 
-      return `${open}${updatedContent}${close}`;
-    });
+      return `${open}${updatedContent}${close}`
+    })
 
-    return updated;
+    return updated
   }
 
   /**
    * Clones a series template to support dynamic series addition.
    */
   static appendDynamicSeries(xml, targetCount) {
-    const serPattern = /(<c:ser>)([\s\S]*?)(<\/c:ser>)/g;
-    const matches = [...xml.matchAll(serPattern)];
-    if (matches.length === 0 || matches.length >= targetCount) return xml;
+    const serPattern = /(<c:ser>)([\s\S]*?)(<\/c:ser>)/g
+    const matches = [...xml.matchAll(serPattern)]
+    if (matches.length === 0 || matches.length >= targetCount) return xml
 
     // Use the last series as a template to clone
-    const templateMatch = matches[matches.length - 1];
-    const template = templateMatch[0];
+    const templateMatch = matches[matches.length - 1]
+    const template = templateMatch[0]
 
     // Find the end of the last series
-    const lastIndex = templateMatch.index + template.length;
+    const lastIndex = templateMatch.index + template.length
 
-    let newSeriesBlocks = '';
+    let newSeriesBlocks = ''
     for (let i = matches.length; i < targetCount; i++) {
-      let clone = template;
+      let clone = template
       // Update c:idx and c:order
-      clone = clone.replace(/(<c:idx val=")\d+("\/>)/g, `$1${i}$2`);
-      clone = clone.replace(/(<c:order val=")\d+("\/>)/g, `$1${i}$2`);
-      newSeriesBlocks += clone;
+      clone = clone.replace(/(<c:idx val=")\d+("\/>)/g, `$1${i}$2`)
+      clone = clone.replace(/(<c:order val=")\d+("\/>)/g, `$1${i}$2`)
+      newSeriesBlocks += clone
     }
 
-    return xml.substring(0, lastIndex) + newSeriesBlocks + xml.substring(lastIndex);
+    return xml.substring(0, lastIndex) + newSeriesBlocks + xml.substring(lastIndex)
+  }
+
+  /**
+   * Updates the chart title in chart XML.
+   */
+  static updateTitle(xml, title) {
+    const titleBlock = `<c:title><c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>${this.#escapeXml(title)}</a:t></a:r></a:p></c:rich></c:tx><c:layout/></c:title>`
+    if (xml.includes('<c:title>')) {
+      const fullTitlePattern = /(<c:title>[\s\S]*?<\/c:title>)/
+      return xml.replace(fullTitlePattern, titleBlock)
+    } else {
+      const chartPattern = /(<c:chart>)/
+      return xml.replace(chartPattern, `$1${titleBlock}`)
+    }
   }
 
   static #escapeXml(str) {
@@ -151,8 +168,8 @@ class ChartCacheGenerator {
       .replace(/</g, '&lt;')
       .replace(/>/g, '&gt;')
       .replace(/"/g, '&quot;')
-      .replace(/'/g, '&apos;');
+      .replace(/'/g, '&apos;')
   }
 }
 
-module.exports = { ChartCacheGenerator };
+module.exports = { ChartCacheGenerator }

package/src/managers/charts/ChartParser.js

@@ -1,7 +1,3 @@
-const { createLogger } = require('../../utils/logger.js');
-
-const logger = createLogger('ChartParser');
-
 class ChartParser {
   /**
    * Finds a chart's relationship ID and type in a slide's XML based on shape name/id.
@@ -15,14 +11,14 @@ class ChartParser {
     const shapeNamePattern = new RegExp(
       `<p:cNvPr[^>]*name="${chartId}"[^>]*>(?:.*?)<c:chart[^>]*r:id="(rId\\d+)"`,
       's'
-    );
-    const rIdMatch = shapeNamePattern.exec(slideXml);
+    )
+    const rIdMatch = shapeNamePattern.exec(slideXml)
     if (rIdMatch) {
-      return { rId: rIdMatch[1] };
+      return { rId: rIdMatch[1] }
     }
 
     // Strategy 2: Find all chart graphicFrames and we will match later in manager
-    return null;
+    return null
   }
 
   /**
@@ -33,13 +29,13 @@ class ChartParser {
    */
   static parseChartData(xml) {
     // This could be used for validation and extracting current chart cache
-    const ptCountMatch = xml.match(/<c:ptCount val="(\d+)"\/>/);
-    const pointCount = ptCountMatch ? parseInt(ptCountMatch[1], 10) : 0;
+    const ptCountMatch = xml.match(/<c:ptCount val="(\d+)"\/>/)
+    const pointCount = ptCountMatch ? parseInt(ptCountMatch[1], 10) : 0
 
     return {
-      pointCount
-    };
+      pointCount,
+    }
   }
 }
 
-module.exports = { ChartParser };
+module.exports = { ChartParser }

package/src/managers/charts/ChartRelationshipManager.js

@@ -1,4 +1,4 @@
-const { REL_TYPES } = require('../RelationshipManager.js');
+const { REL_TYPES } = require('../RelationshipManager.js')
 
 class ChartRelationshipManager {
   /**
@@ -10,26 +10,28 @@ class ChartRelationshipManager {
    * @returns {Object} validation issues
    */
   static validateChartRelationships(relationshipManager, zipManager, chartZipPath) {
-    const issues = { errors: [], warnings: [] };
-    const rels = relationshipManager.getRelationships(chartZipPath);
+    const issues = { errors: [], warnings: [] }
+    const rels = relationshipManager.getRelationships(chartZipPath)
 
-    let hasWorkbook = false;
+    let hasWorkbook = false
     for (const rel of rels) {
       if (rel.type === REL_TYPES.PACKAGE) {
-        hasWorkbook = true;
-        const xlsxPath = relationshipManager.resolveTarget(chartZipPath, rel.target);
+        hasWorkbook = true
+        const xlsxPath = relationshipManager.resolveTarget(chartZipPath, rel.target)
         if (!zipManager.hasFile(xlsxPath)) {
-          issues.errors.push(`Embedded workbook missing: ${xlsxPath}`);
+          issues.errors.push(`Embedded workbook missing: ${xlsxPath}`)
         }
       }
     }
 
     if (!hasWorkbook) {
-      issues.warnings.push(`Chart ${chartZipPath} has no embedded workbook relationship. Live editing in PowerPoint may fail.`);
+      issues.warnings.push(
+        `Chart ${chartZipPath} has no embedded workbook relationship. Live editing in PowerPoint may fail.`
+      )
     }
 
-    return issues;
+    return issues
   }
 }
 
-module.exports = { ChartRelationshipManager };
+module.exports = { ChartRelationshipManager }

package/src/managers/charts/ChartWorkbookUpdater.js

@@ -1,7 +1,7 @@
-const JSZip = require('jszip');
-const { createLogger } = require('../../utils/logger.js');
+const JSZip = require('jszip')
+const { createLogger } = require('../../utils/logger.js')
 
-const logger = createLogger('ChartWorkbookUpdater');
+const logger = createLogger('ChartWorkbookUpdater')
 
 class ChartWorkbookUpdater {
   /**
@@ -12,83 +12,86 @@ class ChartWorkbookUpdater {
    * @returns {Promise<Buffer>} - The updated XLSX buffer.
    */
   static async updateWorkbook(workbookData, data) {
-    if (!workbookData) return null;
+    if (!workbookData) return null
 
     try {
-      const zip = await JSZip.loadAsync(workbookData);
+      const zip = await JSZip.loadAsync(workbookData)
 
       // Look for sheet1.xml
-      const sheetPath = 'xl/worksheets/sheet1.xml';
+      const sheetPath = 'xl/worksheets/sheet1.xml'
       if (!zip.file(sheetPath)) {
-        logger.warn('sheet1.xml not found in embedded workbook, trying to find first sheet');
+        logger.warn('sheet1.xml not found in embedded workbook, trying to find first sheet')
         // fallback to finding the first sheet
       }
 
-      const newSheetXml = this.#generateSheetXml(data);
-      zip.file(sheetPath, newSheetXml);
+      const newSheetXml = this.#generateSheetXml(data)
+      zip.file(sheetPath, newSheetXml)
 
       // Clean up any existing Excel tables, as our new sheet data might not align with them
-      const tableFiles = Object.keys(zip.files).filter(f => f.startsWith('xl/tables/'));
-      tableFiles.forEach(f => zip.remove(f));
+      const tableFiles = Object.keys(zip.files).filter(f => f.startsWith('xl/tables/'))
+      tableFiles.forEach(f => zip.remove(f))
 
-      const sheetRels = Object.keys(zip.files).filter(f => f.startsWith('xl/worksheets/_rels/'));
-      sheetRels.forEach(f => zip.remove(f));
+      const sheetRels = Object.keys(zip.files).filter(f => f.startsWith('xl/worksheets/_rels/'))
+      sheetRels.forEach(f => zip.remove(f))
 
-      const contentTypesFile = zip.file('[Content_Types].xml');
+      const contentTypesFile = zip.file('[Content_Types].xml')
       if (contentTypesFile) {
-        const contentTypesXml = await contentTypesFile.async('text');
-        const updatedContentTypes = contentTypesXml.replace(/<Override[^>]*PartName="\/xl\/tables\/[^"]*"[^>]*\/>/g, '');
-        zip.file('[Content_Types].xml', updatedContentTypes);
+        const contentTypesXml = await contentTypesFile.async('text')
+        const updatedContentTypes = contentTypesXml.replace(
+          /<Override[^>]*PartName="\/xl\/tables\/[^"]*"[^>]*\/>/g,
+          ''
+        )
+        zip.file('[Content_Types].xml', updatedContentTypes)
       }
 
       return await zip.generateAsync({
         type: 'nodebuffer',
         compression: 'DEFLATE',
-        compressionOptions: { level: 6 }
-      });
+        compressionOptions: { level: 6 },
+      })
     } catch (err) {
-      console.error('Failed to update embedded workbook', err);
-      logger.error('Failed to update embedded workbook', err);
-      return workbookData; // Return original if failed
+      console.error('Failed to update embedded workbook', err)
+      logger.error('Failed to update embedded workbook', err)
+      return workbookData // Return original if failed
     }
   }
 
   static #generateSheetXml(data) {
-    const { categories = [], series = [] } = data;
+    const { categories = [], series = [] } = data
 
     // Column count = 1 (categories) + series.length
-    const numCols = 1 + series.length;
-    const numRows = 1 + categories.length; // Row 1 = headers
+    const numCols = 1 + series.length
+    const numRows = 1 + categories.length // Row 1 = headers
 
-    const lastColLetter = this.getColumnLetter(numCols - 1);
-    const dimensionRef = `A1:${lastColLetter}${numRows}`;
+    const lastColLetter = this.getColumnLetter(numCols - 1)
+    const dimensionRef = `A1:${lastColLetter}${numRows}`
 
-    let sheetData = '<sheetData>';
+    let sheetData = '<sheetData>'
 
     // Row 1: Headers (empty cell A1, then series names)
-    sheetData += '<row r="1">';
-    sheetData += `<c r="A1" t="inlineStr"><is><t></t></is></c>`;
+    sheetData += '<row r="1">'
+    sheetData += `<c r="A1" t="inlineStr"><is><t></t></is></c>`
     series.forEach((ser, i) => {
-      const colLetter = this.getColumnLetter(i + 1);
-      sheetData += `<c r="${colLetter}1" t="inlineStr"><is><t>${this.#escapeXml(ser.name || '')}</t></is></c>`;
-    });
-    sheetData += '</row>';
+      const colLetter = this.getColumnLetter(i + 1)
+      sheetData += `<c r="${colLetter}1" t="inlineStr"><is><t>${this.#escapeXml(ser.name || '')}</t></is></c>`
+    })
+    sheetData += '</row>'
 
     // Rows 2..N: Data (category name in A, then values)
     categories.forEach((cat, rowIndex) => {
-      const r = rowIndex + 2; // +1 for 1-based, +1 for header row
-      sheetData += `<row r="${r}">`;
-      sheetData += `<c r="A${r}" t="inlineStr"><is><t>${this.#escapeXml(String(cat))}</t></is></c>`;
+      const r = rowIndex + 2 // +1 for 1-based, +1 for header row
+      sheetData += `<row r="${r}">`
+      sheetData += `<c r="A${r}" t="inlineStr"><is><t>${this.#escapeXml(String(cat))}</t></is></c>`
 
       series.forEach((ser, colIndex) => {
-        const colLetter = this.getColumnLetter(colIndex + 1);
-        const val = ser.values && ser.values[rowIndex] !== undefined ? ser.values[rowIndex] : 0;
-        sheetData += `<c r="${colLetter}${r}"><v>${Number(val)}</v></c>`;
-      });
-      sheetData += '</row>';
-    });
+        const colLetter = this.getColumnLetter(colIndex + 1)
+        const val = ser.values && ser.values[rowIndex] !== undefined ? ser.values[rowIndex] : 0
+        sheetData += `<c r="${colLetter}${r}"><v>${Number(val)}</v></c>`
+      })
+      sheetData += '</row>'
+    })
 
-    sheetData += '</sheetData>';
+    sheetData += '</sheetData>'
 
     return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">
@@ -96,27 +99,27 @@ class ChartWorkbookUpdater {
   <sheetViews><sheetView workbookViewId="0"/></sheetViews>
   <sheetFormatPr defaultRowHeight="15"/>
   ${sheetData}
-</worksheet>`;
+</worksheet>`
   }
 
   static getColumnLetter(colIndex) {
-    let letter = '';
+    let letter = ''
     while (colIndex >= 0) {
-      letter = String.fromCharCode(65 + (colIndex % 26)) + letter;
-      colIndex = Math.floor(colIndex / 26) - 1;
+      letter = String.fromCharCode(65 + (colIndex % 26)) + letter
+      colIndex = Math.floor(colIndex / 26) - 1
     }
-    return letter;
+    return letter
   }
 
   static getFormulaRange(sheetName, startRow, startCol, endRow, endCol) {
-    const startLetter = this.getColumnLetter(startCol);
-    const endLetter = this.getColumnLetter(endCol);
-    return `${sheetName}!$${startLetter}$${startRow}:$${endLetter}$${endRow}`;
+    const startLetter = this.getColumnLetter(startCol)
+    const endLetter = this.getColumnLetter(endCol)
+    return `${sheetName}!$${startLetter}$${startRow}:$${endLetter}$${endRow}`
   }
 
   static getFormulaSingleCell(sheetName, row, col) {
-    const letter = this.getColumnLetter(col);
-    return `${sheetName}!$${letter}$${row}`;
+    const letter = this.getColumnLetter(col)
+    return `${sheetName}!$${letter}$${row}`
   }
 
   static #escapeXml(str) {
@@ -125,8 +128,8 @@ class ChartWorkbookUpdater {
       .replace(/</g, '&lt;')
       .replace(/>/g, '&gt;')
       .replace(/"/g, '&quot;')
-      .replace(/'/g, '&apos;');
+      .replace(/'/g, '&apos;')
   }
 }
 
-module.exports = { ChartWorkbookUpdater };
+module.exports = { ChartWorkbookUpdater }