node-pptx-templater 1.0.1 → 1.0.3

package/src/templates/slideTemplate.js

@@ -38,9 +38,6 @@
  *   </p:sp>
  */
 
-import { generateUniqueId } from '../utils/idUtils.js';
-import { PPTXError } from '../utils/errors.js';
-
 /**
  * OpenXML namespace declarations used in slide XML.
  */
@@ -48,7 +45,7 @@ const SLIDE_NAMESPACES = [
   'xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"',
   'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"',
   'xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main"',
-].join(' ');
+].join(' ')
 
 /**
  * EMU conversion constants.
@@ -60,7 +57,7 @@ const EMU = {
   SLIDE_WIDTH: 9144000,
   /** Slide height (7.5 inches = 6858000 EMU for 4:3, 5143500 for 16:9) */
   SLIDE_HEIGHT: 5143500,
-};
+}
 
 /**
  * Builds the XML for a new slide.
@@ -69,29 +66,26 @@ const EMU = {
  * @param {number} slideIndex - 1-based slide index (for unique IDs).
  * @returns {string} Complete slide XML string.
  */
-export function buildNewSlideXml(options, slideIndex) {
-  const { title = '', elements = [], layout = 'blank', _rawXml } = options;
+function buildNewSlideXml(options, _slideIndex) {
+  const { title = '', elements = [], _layout = 'blank', _rawXml } = options
 
   // If raw XML is provided, use it directly (for clone/export operations)
-  if (_rawXml) return _rawXml;
+  if (_rawXml) return _rawXml
 
-  const shapes = [];
-  let shapeIdCounter = 1;
+  const shapes = []
+  let shapeIdCounter = 1
 
   // Add title shape if title is provided
   if (title) {
-    shapes.push(buildTitleShape(title, shapeIdCounter++));
+    shapes.push(buildTitleShape(title, shapeIdCounter++))
   }
 
   // Add element shapes
   for (const element of elements) {
-    shapes.push(buildElementShape(element, shapeIdCounter++));
+    shapes.push(buildElementShape(element, shapeIdCounter++))
   }
 
-  const spTreeContent = [
-    buildGroupShapeProps(),
-    ...shapes,
-  ].join('\n    ');
+  const spTreeContent = [buildGroupShapeProps(), ...shapes].join('\n    ')
 
   return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <p:sld ${SLIDE_NAMESPACES} show="1">
@@ -103,7 +97,7 @@ export function buildNewSlideXml(options, slideIndex) {
   <p:clrMapOvr>
     <a:masterClrMapping/>
   </p:clrMapOvr>
-</p:sld>`;
+</p:sld>`
 }
 
 /**
@@ -123,7 +117,7 @@ function buildGroupShapeProps() {
         <a:chOff x="0" y="0"/>
         <a:chExt cx="0" cy="0"/>
       </a:xfrm>
-    </p:grpSpPr>`;
+    </p:grpSpPr>`
 }
 
 /**
@@ -151,7 +145,7 @@ function buildTitleShape(title, shapeId) {
           </a:r>
         </a:p>
       </p:txBody>
-    </p:sp>`;
+    </p:sp>`
 }
 
 /**
@@ -164,13 +158,13 @@ function buildTitleShape(title, shapeId) {
 function buildElementShape(element, shapeId) {
   switch (element.type) {
     case 'text':
-      return buildTextShape(element, shapeId);
+      return buildTextShape(element, shapeId)
     case 'image':
-      return buildImagePlaceholder(element, shapeId);
+      return buildImagePlaceholder(element, shapeId)
     case 'shape':
-      return buildBasicShape(element, shapeId);
+      return buildBasicShape(element, shapeId)
     default:
-      return buildTextShape({ ...element, value: element.value || '' }, shapeId);
+      return buildTextShape({ ...element, value: element.value || '' }, shapeId)
   }
 }
 
@@ -192,10 +186,10 @@ function buildTextShape(element, shapeId) {
     bold = false,
     italic = false,
     name = `TextBox ${shapeId}`,
-  } = element;
+  } = element
 
-  const boldAttr = bold ? ' b="1"' : '';
-  const italicAttr = italic ? ' i="1"' : '';
+  const boldAttr = bold ? ' b="1"' : ''
+  const italicAttr = italic ? ' i="1"' : ''
 
   return `<p:sp>
       <p:nvSpPr>
@@ -223,7 +217,7 @@ function buildTextShape(element, shapeId) {
           </a:r>
         </a:p>
       </p:txBody>
-    </p:sp>`;
+    </p:sp>`
 }
 
 /**
@@ -242,7 +236,7 @@ function buildImagePlaceholder(element, shapeId) {
     width = 3 * EMU.INCH,
     height = 2 * EMU.INCH,
     name = `Image ${shapeId}`,
-  } = element;
+  } = element
 
   return `<p:pic>
       <p:nvPicPr>
@@ -261,7 +255,7 @@ function buildImagePlaceholder(element, shapeId) {
         </a:xfrm>
         <a:prstGeom prst="rect"><a:avLst/></a:prstGeom>
       </p:spPr>
-    </p:pic>`;
+    </p:pic>`
 }
 
 /**
@@ -280,7 +274,7 @@ function buildBasicShape(element, shapeId) {
     height = EMU.INCH,
     fillColor = 'FFFFFF',
     name = `Shape ${shapeId}`,
-  } = element;
+  } = element
 
   return `<p:sp>
       <p:nvSpPr>
@@ -296,7 +290,7 @@ function buildBasicShape(element, shapeId) {
         <a:prstGeom prst="${shape}"><a:avLst/></a:prstGeom>
         <a:solidFill><a:srgbClr val="${fillColor}"/></a:solidFill>
       </p:spPr>
-    </p:sp>`;
+    </p:sp>`
 }
 
 /**
@@ -310,5 +304,10 @@ function escapeXml(str) {
     .replace(/</g, '&lt;')
     .replace(/>/g, '&gt;')
     .replace(/"/g, '&quot;')
-    .replace(/'/g, '&apos;');
+    .replace(/'/g, '&apos;')
+}
+
+module.exports = {
+  buildNewSlideXml,
+  EMU,
 }

package/src/utils/contentTypesHelper.js

@@ -17,15 +17,15 @@
  *   </Types>
  */
 
-import { createLogger } from './logger.js';
+const { createLogger } = require('./logger.js')
 
-const logger = createLogger('ContentTypes');
+const logger = createLogger('ContentTypes')
 
 /** MIME type for PPTX slide parts. */
-const SLIDE_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.presentationml.slide+xml';
+const SLIDE_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.presentationml.slide+xml'
 
 /** MIME type for chart parts. */
-const CHART_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chart+xml';
+const CHART_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chart+xml'
 
 /**
  * Singleton helper for [Content_Types].xml manipulation.
@@ -38,11 +38,7 @@ class ContentTypesHelper {
    * @param {string} slideFileName - e.g., 'slide5.xml'
    */
   addSlideContentType(zipManager, slideFileName) {
-    this.#addOverride(
-      zipManager,
-      `/ppt/slides/${slideFileName}`,
-      SLIDE_CONTENT_TYPE
-    );
+    this.#addOverride(zipManager, `/ppt/slides/${slideFileName}`, SLIDE_CONTENT_TYPE)
   }
 
   /**
@@ -52,10 +48,7 @@ class ContentTypesHelper {
    * @param {string} slideFileName - e.g., 'slide5.xml'
    */
   removeSlideContentType(zipManager, slideFileName) {
-    this.#removeOverride(
-      zipManager,
-      `/ppt/slides/${slideFileName}`
-    );
+    this.#removeOverride(zipManager, `/ppt/slides/${slideFileName}`)
   }
 
   /**
@@ -65,11 +58,7 @@ class ContentTypesHelper {
    * @param {string} chartFileName - e.g., 'chart3.xml'
    */
   addChartContentType(zipManager, chartFileName) {
-    this.#addOverride(
-      zipManager,
-      `/ppt/charts/${chartFileName}`,
-      CHART_CONTENT_TYPE
-    );
+    this.#addOverride(zipManager, `/ppt/charts/${chartFileName}`, CHART_CONTENT_TYPE)
   }
 
   /**
@@ -81,24 +70,21 @@ class ContentTypesHelper {
    */
   addMediaDefault(zipManager, extension, mimeType) {
     this.#updateQueue = this.#updateQueue.then(async () => {
-      const xmlFile = zipManager.rawZip.file('[Content_Types].xml');
-      if (!xmlFile) return;
+      const xmlFile = zipManager.rawZip.file('[Content_Types].xml')
+      if (!xmlFile) return
 
-      const content = await xmlFile.async('text');
-      const entry = `Extension="${extension}" ContentType="${mimeType}"`;
+      const content = await xmlFile.async('text')
+      const entry = `Extension="${extension}" ContentType="${mimeType}"`
       if (!content.includes(entry)) {
-        const updated = content.replace(
-          '</Types>',
-          `  <Default ${entry}/>\n</Types>`
-        );
-        zipManager.writeFile('[Content_Types].xml', updated);
-        logger.debug(`Registered default content type for .${extension}`);
+        const updated = content.replace('</Types>', `  <Default ${entry}/>\n</Types>`)
+        zipManager.writeFile('[Content_Types].xml', updated)
+        logger.debug(`Registered default content type for .${extension}`)
       }
-    });
-    zipManager.addPendingPromise(this.#updateQueue);
+    })
+    zipManager.addPendingPromise(this.#updateQueue)
   }
 
-  #updateQueue = Promise.resolve();
+  #updateQueue = Promise.resolve()
 
   /**
    * Adds an Override entry to [Content_Types].xml.
@@ -106,21 +92,21 @@ class ContentTypesHelper {
    */
   #addOverride(zipManager, partName, contentType) {
     this.#updateQueue = this.#updateQueue.then(async () => {
-      const xmlFile = zipManager.rawZip.file('[Content_Types].xml');
+      const xmlFile = zipManager.rawZip.file('[Content_Types].xml')
       if (!xmlFile) {
-        logger.warn('[Content_Types].xml not found');
-        return;
+        logger.warn('[Content_Types].xml not found')
+        return
       }
-      const content = await xmlFile.async('text');
-      const entry = `PartName="${partName}"`;
+      const content = await xmlFile.async('text')
+      const entry = `PartName="${partName}"`
       if (!content.includes(entry)) {
-        const override = `<Override PartName="${partName}" ContentType="${contentType}"/>`;
-        const updated = content.replace('</Types>', `  ${override}\n</Types>`);
-        zipManager.writeFile('[Content_Types].xml', updated);
-        logger.debug(`Registered content type for ${partName}`);
+        const override = `<Override PartName="${partName}" ContentType="${contentType}"/>`
+        const updated = content.replace('</Types>', `  ${override}\n</Types>`)
+        zipManager.writeFile('[Content_Types].xml', updated)
+        logger.debug(`Registered content type for ${partName}`)
       }
-    });
-    zipManager.addPendingPromise(this.#updateQueue);
+    })
+    zipManager.addPendingPromise(this.#updateQueue)
   }
 
   /**
@@ -129,21 +115,23 @@ class ContentTypesHelper {
    */
   #removeOverride(zipManager, partName) {
     this.#updateQueue = this.#updateQueue.then(async () => {
-      const xmlFile = zipManager.rawZip.file('[Content_Types].xml');
+      const xmlFile = zipManager.rawZip.file('[Content_Types].xml')
       if (!xmlFile) {
-        logger.warn('[Content_Types].xml not found');
-        return;
+        logger.warn('[Content_Types].xml not found')
+        return
       }
-      const content = await xmlFile.async('text');
-      const regex = new RegExp(`<Override[^>]*PartName="${partName}"[^>]*/>\\s*`, 'g');
+      const content = await xmlFile.async('text')
+      const regex = new RegExp(`<Override[^>]*PartName="${partName}"[^>]*/>\\s*`, 'g')
       if (regex.test(content)) {
-        const updated = content.replace(regex, '');
-        zipManager.writeFile('[Content_Types].xml', updated);
-        logger.debug(`Removed content type for ${partName}`);
+        const updated = content.replace(regex, '')
+        zipManager.writeFile('[Content_Types].xml', updated)
+        logger.debug(`Removed content type for ${partName}`)
       }
-    });
-    zipManager.addPendingPromise(this.#updateQueue);
+    })
+    zipManager.addPendingPromise(this.#updateQueue)
   }
 }
 
-export const contentTypesHelper = new ContentTypesHelper();
+module.exports = {
+  contentTypesHelper: new ContentTypesHelper(),
+}

package/src/utils/errors.js

@@ -18,19 +18,19 @@
  * @description Base error class for all node-pptx-templater errors.
  * @extends Error
  */
-export class PPTXError extends Error {
+class PPTXError extends Error {
   /**
    * @param {string} message - Human-readable error description.
    * @param {Error} [cause] - Original underlying error (for error chaining).
    */
   constructor(message, cause) {
-    super(message);
-    this.name = 'PPTXError';
-    if (cause) this.cause = cause;
+    super(message)
+    this.name = 'PPTXError'
+    if (cause) this.cause = cause
 
     // Maintains proper stack trace for where error was thrown (V8 only)
     if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, this.constructor);
+      Error.captureStackTrace(this, this.constructor)
     }
   }
 }
@@ -40,13 +40,13 @@ export class PPTXError extends Error {
  * @description Thrown when a slide reference cannot be resolved.
  * @extends PPTXError
  */
-export class SlideNotFoundError extends PPTXError {
+class SlideNotFoundError extends PPTXError {
   /**
    * @param {string} message
    */
   constructor(message) {
-    super(message);
-    this.name = 'SlideNotFoundError';
+    super(message)
+    this.name = 'SlideNotFoundError'
   }
 }
 
@@ -55,13 +55,13 @@ export class SlideNotFoundError extends PPTXError {
  * @description Thrown when a chart cannot be located in a slide.
  * @extends PPTXError
  */
-export class ChartNotFoundError extends PPTXError {
+class ChartNotFoundError extends PPTXError {
   /**
    * @param {string} message
    */
   constructor(message) {
-    super(message);
-    this.name = 'ChartNotFoundError';
+    super(message)
+    this.name = 'ChartNotFoundError'
   }
 }
 
@@ -70,13 +70,13 @@ export class ChartNotFoundError extends PPTXError {
  * @description Thrown when a table cannot be located in a slide.
  * @extends PPTXError
  */
-export class TableNotFoundError extends PPTXError {
+class TableNotFoundError extends PPTXError {
   /**
    * @param {string} message
    */
   constructor(message) {
-    super(message);
-    this.name = 'TableNotFoundError';
+    super(message)
+    this.name = 'TableNotFoundError'
   }
 }
 
@@ -85,14 +85,14 @@ export class TableNotFoundError extends PPTXError {
  * @description Thrown when XML parsing or building fails.
  * @extends PPTXError
  */
-export class XMLParseError extends PPTXError {
+class XMLParseError extends PPTXError {
   /**
    * @param {string} message
    * @param {Error} [cause]
    */
   constructor(message, cause) {
-    super(message, cause);
-    this.name = 'XMLParseError';
+    super(message, cause)
+    this.name = 'XMLParseError'
   }
 }
 
@@ -101,14 +101,14 @@ export class XMLParseError extends PPTXError {
  * @description Thrown when a PPTX file has an invalid or unsupported structure.
  * @extends PPTXError
  */
-export class InvalidTemplateError extends PPTXError {
+class InvalidTemplateError extends PPTXError {
   /**
    * @param {string} message
    * @param {Error} [cause]
    */
   constructor(message, cause) {
-    super(message, cause);
-    this.name = 'InvalidTemplateError';
+    super(message, cause)
+    this.name = 'InvalidTemplateError'
   }
 }
 
@@ -117,13 +117,23 @@ export class InvalidTemplateError extends PPTXError {
  * @description Thrown when a media file cannot be embedded.
  * @extends PPTXError
  */
-export class MediaEmbedError extends PPTXError {
+class MediaEmbedError extends PPTXError {
   /**
    * @param {string} message
    * @param {Error} [cause]
    */
   constructor(message, cause) {
-    super(message, cause);
-    this.name = 'MediaEmbedError';
+    super(message, cause)
+    this.name = 'MediaEmbedError'
   }
 }
+
+module.exports = {
+  PPTXError,
+  SlideNotFoundError,
+  ChartNotFoundError,
+  TableNotFoundError,
+  XMLParseError,
+  InvalidTemplateError,
+  MediaEmbedError,
+}

package/src/utils/idUtils.js

@@ -3,7 +3,7 @@
  * Used for generating shape IDs, slide IDs, etc. in OpenXML.
  */
 
-import { randomBytes } from 'crypto';
+const { randomBytes } = require('crypto')
 
 /**
  * Generates a unique integer ID for use as a shape or slide ID.
@@ -12,9 +12,9 @@ import { randomBytes } from 'crypto';
  * @param {number[]} [existingIds] - Array of existing IDs to avoid.
  * @returns {number} Unique positive integer.
  */
-export function generateUniqueId(existingIds = []) {
-  const maxId = existingIds.length > 0 ? Math.max(...existingIds) : 0;
-  return maxId + 1;
+function generateUniqueId(existingIds = []) {
+  const maxId = existingIds.length > 0 ? Math.max(...existingIds) : 0
+  return maxId + 1
 }
 
 /**
@@ -23,21 +23,23 @@ export function generateUniqueId(existingIds = []) {
  *
  * @returns {string} UUID v4 string (e.g., '{A1B2C3D4-E5F6-...}')
  */
-export function generateGuid() {
-  const bytes = randomBytes(16);
-  bytes[6] = (bytes[6] & 0x0f) | 0x40; // Version 4
-  bytes[8] = (bytes[8] & 0x3f) | 0x80; // Variant RFC4122
+function generateGuid() {
+  const bytes = randomBytes(16)
+  bytes[6] = (bytes[6] & 0x0f) | 0x40 // Version 4
+  bytes[8] = (bytes[8] & 0x3f) | 0x80 // Variant RFC4122
 
-  const hex = bytes.toString('hex');
+  const hex = bytes.toString('hex')
   const guid = [
     hex.slice(0, 8),
     hex.slice(8, 12),
     hex.slice(12, 16),
     hex.slice(16, 20),
     hex.slice(20, 32),
-  ].join('-').toUpperCase();
+  ]
+    .join('-')
+    .toUpperCase()
 
-  return `{${guid}}`;
+  return `{${guid}}`
 }
 
 /**
@@ -47,8 +49,14 @@ export function generateGuid() {
  * @param {string[]} [existingSlideIds] - Existing slide ID strings.
  * @returns {string} New slide ID string.
  */
-export function generateSlideId(existingSlideIds = []) {
-  const existingNums = existingSlideIds.map(id => parseInt(id, 10)).filter(n => !isNaN(n));
-  const maxId = existingNums.length > 0 ? Math.max(...existingNums) : 255;
-  return String(maxId + 1);
+function generateSlideId(existingSlideIds = []) {
+  const existingNums = existingSlideIds.map(id => parseInt(id, 10)).filter(n => !isNaN(n))
+  const maxId = existingNums.length > 0 ? Math.max(...existingNums) : 255
+  return String(maxId + 1)
+}
+
+module.exports = {
+  generateUniqueId,
+  generateGuid,
+  generateSlideId,
 }

package/src/utils/logger.js

@@ -22,11 +22,10 @@
  *   PPTX_LOG_LEVEL=silent → suppress all logs
  */
 
-const LOG_LEVELS = { debug: 0, info: 1, warn: 2, error: 3, silent: 4 };
+const LOG_LEVELS = { debug: 0, info: 1, warn: 2, error: 3, silent: 4 }
 
-const currentLevel = LOG_LEVELS[
-  (process.env.PPTX_LOG_LEVEL || 'warn').toLowerCase()
-] ?? LOG_LEVELS.warn;
+const currentLevel =
+  LOG_LEVELS[(process.env.PPTX_LOG_LEVEL || 'warn').toLowerCase()] ?? LOG_LEVELS.warn
 
 /**
  * ANSI color codes for terminal output.
@@ -38,14 +37,14 @@ const COLORS = {
   green: '\x1b[32m',
   yellow: '\x1b[33m',
   red: '\x1b[31m',
-};
+}
 
 /**
  * Formats the current timestamp as HH:MM:SS.mmm
  * @returns {string}
  */
 function timestamp() {
-  return new Date().toISOString().substring(11, 23);
+  return new Date().toISOString().substring(11, 23)
 }
 
 /**
@@ -66,20 +65,23 @@ function timestamp() {
  * const logger = createLogger('SlideManager');
  * logger.info('Loaded 5 slides');
  */
-export function createLogger(moduleName) {
-  const isTTY = process.stdout.isTTY;
+function createLogger(moduleName) {
+  const isTTY = process.stdout.isTTY
 
   const log = (level, levelNum, color, message, ...args) => {
-    if (levelNum < currentLevel) return;
+    if (levelNum < currentLevel) return
 
     const prefix = isTTY
       ? `${COLORS.dim}${timestamp()}${COLORS.reset} ${color}[${level.toUpperCase().padEnd(5)}]${COLORS.reset} ${COLORS.cyan}[${moduleName}]${COLORS.reset}`
-      : `${timestamp()} [${level.toUpperCase().padEnd(5)}] [${moduleName}]`;
+      : `${timestamp()} [${level.toUpperCase().padEnd(5)}] [${moduleName}]`
 
-    const output = args.length > 0 ? `${message} ${args.map(a => JSON.stringify(a, null, 0)).join(' ')}` : message;
-    const stream = level === 'error' ? process.stderr : process.stdout;
-    stream.write(`${prefix} ${output}\n`);
-  };
+    const output =
+      args.length > 0
+        ? `${message} ${args.map(a => JSON.stringify(a, null, 0)).join(' ')}`
+        : message
+    const stream = level === 'error' ? process.stderr : process.stdout
+    stream.write(`${prefix} ${output}\n`)
+  }
 
   return {
     /**
@@ -109,5 +111,9 @@ export function createLogger(moduleName) {
      * @param {...*} args
      */
     error: (message, ...args) => log('error', LOG_LEVELS.error, COLORS.red, message, ...args),
-  };
+  }
+}
+
+module.exports = {
+  createLogger,
 }