node-pptx-templater 1.0.5 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-pptx-templater",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "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",
@@ -52,11 +52,103 @@
     "mail-merge",
     "report-generator",
     "xml-manipulation",
-    "pptx-editor"
+    "pptx-editor",
+    "ppt",
+    "slide-cloning",
+    "z-index",
+    "z-order",
+    "bring-to-front",
+    "send-to-back",
+    "xlsx",
+    "excel-caching",
+    "jszip",
+    "slide-import",
+    "slide-relationships",
+    "content-types",
+    "xml-repair",
+    "xml-security",
+    "xml-bomb-protection",
+    "xxe-prevention",
+    "billion-laughs-fix",
+    "entity-expansion-fix",
+    "safe-xml-parser",
+    "fast-xml-parser",
+    "office-automation",
+    "docx",
+    "drawingml",
+    "presentationml",
+    "slide-deck",
+    "slide-generator",
+    "ppt-generator",
+    "generate-pptx",
+    "create-pptx",
+    "modify-pptx",
+    "edit-pptx",
+    "parse-pptx",
+    "read-pptx",
+    "write-pptx",
+    "pptx-parser",
+    "pptx-builder",
+    "pptx-writer",
+    "template-engine",
+    "placeholders",
+    "replacement-engine",
+    "run-fragmentation",
+    "text-runs",
+    "fonts",
+    "colors",
+    "shapes",
+    "cloning-shapes",
+    "copy-shapes",
+    "tables-formatting",
+    "charts-excel",
+    "xlsx-caching",
+    "workbook-update",
+    "bar-chart",
+    "pie-chart",
+    "line-chart",
+    "bar-charts",
+    "pie-charts",
+    "line-charts",
+    "scatter-chart",
+    "bubble-chart",
+    "area-chart",
+    "doughnut-chart",
+    "slide-masters",
+    "slide-layouts",
+    "custom-xml",
+    "relationship-remapping",
+    "rowid-generation",
+    "powerpoint-repair-fix",
+    "non-corrupting",
+    "zero-dependency",
+    "lambda-compatible",
+    "serverless-pptx",
+    "aws-lambda",
+    "vercel-edge",
+    "google-cloud-functions",
+    "pure-js-pptx",
+    "no-java",
+    "no-office",
+    "pptx-merge",
+    "pptx-split",
+    "pptx-reorder",
+    "pptx-stacking",
+    "pptx-layers",
+    "pptx-hyperlinks",
+    "pptx-action-links",
+    "pptx-navigation"
   ],
   "author": {
-    "name": "node-pptx-templater contributors"
+    "name": "node-pptx-templater contributors",
+    "url": "https://github.com/jsuyog2/node-pptx-templater/graphs/contributors"
   },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/jsuyog2"
+    }
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/core/PPTXTemplater.js

@@ -359,20 +359,34 @@ class PPTXTemplater {
    * Updates chart data in the selected slide(s).
    * Finds charts by their name/ID and updates categories, series, and values.
    * Preserves original chart styles, themes, and formatting.
+   * Supports inline custom data labels by passing objects in the format `{ data: number, label: string }` instead of numbers.
    *
    * @param {string} chartId - Chart name or relationship ID.
    * @param {ChartData} data - New chart data.
    * @param {string[]} data.categories - Category labels (X-axis).
    * @param {SeriesData[]} data.series - Data series array.
    * @param {string} data.series[].name - Series name.
-   * @param {number[]} data.series[].values - Data values.
+   * @param {number[]|object[]} data.series[].values - Data values (numbers or label objects).
    * @returns {PPTXTemplater} this (chainable)
    *
    * @example
+   * // Simple numeric values:
    * ppt.updateChart('sales-chart', {
    *   categories: ['Jan', 'Feb', 'Mar'],
    *   series: [{ name: 'Revenue', values: [120, 150, 180] }]
    * });
+   *
+   * // Custom inline data labels:
+   * ppt.updateChart('sales-chart', {
+   *   categories: ['Q1', 'Q2'],
+   *   series: [{
+   *     name: 'Revenue',
+   *     values: [
+   *       { data: 120, label: '120 (40%)' },
+   *       { data: 180, label: '180 (60%)' }
+   *     ]
+   *   }]
+   * });
    */
   updateChart(chartId, data) {
     this.#assertLoaded()
@@ -1320,6 +1334,43 @@ class PPTXTemplater {
     return this
   }
 
+  updateDataLabels(chartId, options) {
+    this.#assertLoaded()
+    const targetIndices = this.#getTargetSlideIndices()
+    for (const idx of targetIndices) {
+      this.#chartManager.updateDataLabels(
+        idx,
+        chartId,
+        options,
+        this.#slideManager,
+        this.#relationshipManager
+      )
+    }
+    return this
+  }
+
+  async getDataLabels(chartId, options = {}) {
+    this.#assertLoaded()
+    const targetIndices = this.#getTargetSlideIndices()
+    if (targetIndices.length === 0) return []
+    const idx = targetIndices[0]
+    return this.#chartManager.getDataLabels(
+      idx,
+      chartId,
+      options,
+      this.#slideManager,
+      this.#relationshipManager
+    )
+  }
+
+  async validateDataLabels(chartId, options = {}) {
+    this.#assertLoaded()
+    const targetIndices = this.#getTargetSlideIndices()
+    if (targetIndices.length === 0) return { valid: true, errors: [] }
+    const idx = targetIndices[0]
+    return ValidationEngine.validateDataLabels(this, idx, chartId, options)
+  }
+
   getCharts() {
     this.#assertLoaded()
     const targetIndices = this.#getTargetSlideIndices()

package/src/core/ValidationEngine.js

@@ -318,6 +318,99 @@ class ValidationEngine {
       warnings,
     }
   }
+
+  /**
+   * Validates data label configurations for a chart.
+   *
+   * @param {PPTXTemplater} ppt
+   * @param {number} slideIndex
+   * @param {string} chartId
+   * @param {Object} options
+   * @returns {Promise<Object>} report
+   */
+  static async validateDataLabels(ppt, slideIndex, chartId, options = {}) {
+    const errors = []
+    const warnings = []
+
+    try {
+      const chartInfo = ppt.chartManager.findChartInSlide(
+        slideIndex,
+        chartId,
+        ppt.slideManager,
+        ppt.relationshipManager
+      )
+
+      if (!chartInfo) {
+        errors.push(`Chart "${chartId}" not found in slide ${slideIndex}`)
+        return { valid: false, errors, warnings }
+      }
+
+      const chartType = await ppt.chartManager.getChartTypeAsync(
+        slideIndex,
+        chartId,
+        ppt.slideManager,
+        ppt.relationshipManager
+      )
+
+      const supportedTypes = [
+        'bar',
+        'column',
+        'line',
+        'pie',
+        'doughnut',
+        'area',
+        'scatter',
+        'combo',
+        'unknown',
+      ]
+      if (!supportedTypes.includes(chartType)) {
+        errors.push(`Unsupported chart type "${chartType}" for data labels`)
+      }
+
+      const xml = await ppt.zipManager.readFile(chartInfo.zipPath)
+      let ptsCount = 0
+      const catMatch = /<c:cat>([\s\S]*?)<\/c:cat>/.exec(xml)
+      const valMatch = /<c:val>([\s\S]*?)<\/c:val>/.exec(xml)
+      const targetBlock = catMatch ? catMatch[1] : valMatch ? valMatch[1] : ''
+      const ptCountMatch = /<c:ptCount val="(\d+)"\/>/.exec(targetBlock)
+      if (ptCountMatch) {
+        ptsCount = parseInt(ptCountMatch[1], 10)
+      }
+
+      if (options.labels) {
+        if (ptsCount > 0 && options.labels.length !== ptsCount) {
+          errors.push(
+            `Label count (${options.labels.length}) does not match chart data points count (${ptsCount})`
+          )
+        }
+
+        options.labels.forEach((lbl, i) => {
+          if (lbl === null || lbl === undefined || String(lbl).trim() === '') {
+            warnings.push(`Label at index ${i} is empty`)
+          }
+        })
+      }
+
+      if (options.labelsFromCells) {
+        const range = options.labelsFromCells
+        const parts = range.split('!')
+        const rangePart = parts.length > 1 ? parts[1] : parts[0]
+
+        const rangeRegex = /^\$?[A-Z]+\$?\d+(?::\$?[A-Z]+\$?\d+)?$/i
+        if (!rangeRegex.test(rangePart)) {
+          errors.push(`Invalid range format: "${options.labelsFromCells}"`)
+        }
+      }
+    } catch (err) {
+      errors.push(`Data labels validation error: ${err.message}`)
+    }
+
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings,
+    }
+  }
 }
 
 module.exports = { ValidationEngine }

package/src/index.js

@@ -42,7 +42,15 @@ const { ValidationEngine } = require('./core/ValidationEngine.js')
 
 // Utility exports
 const { generateRelationshipId, parseRelationshipId } = require('./utils/relationshipUtils.js')
-const { validateXML, repairXML } = require('./utils/xmlUtils.js')
+const {
+  validateXml,
+  validateXML,
+  safeParseXml,
+  repairXML,
+  scanForEntities,
+  analyzeXmlFile,
+  reportXmlComplexity,
+} = require('./utils/xmlUtils.js')
 const { createLogger } = require('./utils/logger.js')
 const {
   PPTXError,
@@ -70,8 +78,13 @@ module.exports = {
   ValidationEngine,
   generateRelationshipId,
   parseRelationshipId,
+  validateXml,
   validateXML,
+  safeParseXml,
   repairXML,
+  scanForEntities,
+  analyzeXmlFile,
+  reportXmlComplexity,
   createLogger,
   PPTXError,
   SlideNotFoundError,