node-pptx-templater 1.0.1 → 1.0.2

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "node-pptx-templater",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Low-level PowerPoint OpenXML template engine for Node.js — generate and edit PPTX files directly through XML manipulation without relying on PowerPoint generation libraries.",
   "main": "./src/index.js",
-  "type": "module",
+  "type": "commonjs",
   "exports": {
     ".": {
-      "import": "./src/index.js"
+      "require": "./src/index.js"
     }
   },
   "bin": {
@@ -65,8 +65,8 @@
     "jszip": "^3.10.1",
     "fs-extra": "^11.2.0",
     "commander": "^12.0.0",
-    "chalk": "^5.3.0",
-    "ora": "^8.0.1"
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1"
   },
   "devDependencies": {
     "vitest": "^1.6.0",
@@ -80,4 +80,4 @@
     "LICENSE",
     "CHANGELOG.md"
   ]
-}
+}

package/src/cli/commands/build.js

@@ -2,11 +2,11 @@
  * @fileoverview `build` CLI command — builds a PPTX from a template + JSON data.
  */
 
-import chalk from 'chalk';
-import ora from 'ora';
-import { readFileSync } from 'fs';
-import { resolve } from 'path';
-import { PPTXTemplater } from '../../index.js';
+const chalk = require('chalk');
+const ora = require('ora');
+const { readFileSync } = require('fs');
+const { resolve } = require('path');
+const { PPTXTemplater } = require('../../index.js');
 
 /**
  * Executes the `build` CLI command.
@@ -15,7 +15,7 @@ import { PPTXTemplater } from '../../index.js';
  * @param {string} outputPath - Path for the generated PPTX.
  * @param {Object} opts - CLI options.
  */
-export async function buildCommand(templatePath, outputPath, opts) {
+async function buildCommand(templatePath, outputPath, opts) {
   const spinner = ora(`Loading template: ${templatePath}`).start();
 
   try {
@@ -77,3 +77,5 @@ export async function buildCommand(templatePath, outputPath, opts) {
     process.exit(1);
   }
 }
+
+module.exports = { buildCommand };

package/src/cli/commands/debug.js

@@ -1,13 +1,12 @@
 /**
  * @fileoverview `debug` CLI command — diagnoses and repairs corrupted PPTX files.
  */
-import chalk from 'chalk';
-import ora from 'ora';
-import { resolve } from 'path';
-import { repairXML } from '../../utils/xmlUtils.js';
-import { PPTXTemplater } from '../../index.js';
+const chalk = require('chalk');
+const ora = require('ora');
+const { resolve } = require('path');
+const { PPTXTemplater } = require('../../index.js');
 
-export async function debugCommand(filePath, opts) {
+async function debugCommand(filePath, opts) {
   const spinner = ora(`Loading PPTX for debug: ${filePath}`).start();
 
   try {
@@ -44,3 +43,5 @@ export async function debugCommand(filePath, opts) {
     process.exit(1);
   }
 }
+
+module.exports = { debugCommand };

package/src/cli/commands/extract.js

@@ -1,12 +1,12 @@
 /**
  * @fileoverview `extract` CLI command — extracts XML parts from a PPTX.
  */
-import chalk from 'chalk';
-import { resolve } from 'path';
-import { writeFileSync } from 'fs';
-import { PPTXTemplater } from '../../index.js';
+const chalk = require('chalk');
+const { resolve } = require('path');
+const { writeFileSync } = require('fs');
+const { PPTXTemplater } = require('../../index.js');
 
-export async function extractCommand(filePath, opts) {
+async function extractCommand(filePath, opts) {
   try {
     const ppt = await PPTXTemplater.load(resolve(filePath));
 
@@ -14,7 +14,7 @@ export async function extractCommand(filePath, opts) {
       const slideNum = parseInt(opts.slide, 10);
       // Access internal zip via the engine's buffer
       const buffer = await ppt.toBuffer();
-      const JSZip = (await import('jszip')).default;
+      const JSZip = require('jszip');
       const zip = await JSZip.loadAsync(buffer);
       const slideFile = zip.file(`ppt/slides/slide${slideNum}.xml`);
 
@@ -40,3 +40,5 @@ export async function extractCommand(filePath, opts) {
     process.exit(1);
   }
 }
+
+module.exports = { extractCommand };

package/src/cli/commands/inspect.js

@@ -1,12 +1,12 @@
 /**
  * @fileoverview `inspect` CLI command — detailed PPTX structure inspection.
  */
-import chalk from 'chalk';
-import ora from 'ora';
-import { resolve } from 'path';
-import { PPTXTemplater } from '../../index.js';
+const chalk = require('chalk');
+const ora = require('ora');
+const { resolve } = require('path');
+const { PPTXTemplater } = require('../../index.js');
 
-export async function inspectCommand(filePath, opts) {
+async function inspectCommand(filePath, opts) {
   const showAll = opts.all;
   const spinner = ora(`Inspecting: ${filePath}`).start();
 
@@ -37,3 +37,5 @@ export async function inspectCommand(filePath, opts) {
     process.exit(1);
   }
 }
+
+module.exports = { inspectCommand };

package/src/cli/commands/validate.js

@@ -1,12 +1,12 @@
 /**
  * @fileoverview `validate` CLI command.
  */
-import chalk from 'chalk';
-import ora from 'ora';
-import { resolve } from 'path';
-import { PPTXTemplater } from '../../index.js';
+const chalk = require('chalk');
+const ora = require('ora');
+const { resolve } = require('path');
+const { PPTXTemplater } = require('../../index.js');
 
-export async function validateCommand(filePath, opts) {
+async function validateCommand(filePath, opts) {
   const spinner = ora(`Validating: ${filePath}`).start();
   try {
     const ppt = await PPTXTemplater.load(resolve(filePath));
@@ -34,3 +34,5 @@ export async function validateCommand(filePath, opts) {
     process.exit(1);
   }
 }
+
+module.exports = { validateCommand };

package/src/cli/index.js

@@ -18,20 +18,15 @@
  *   node-pptx-templater --help
  */
 
-import { Command } from 'commander';
-import chalk from 'chalk';
-import ora from 'ora';
-import { readFileSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { PPTXTemplater } from '../index.js';
-import { buildCommand } from './commands/build.js';
-import { validateCommand } from './commands/validate.js';
-import { inspectCommand } from './commands/inspect.js';
-import { extractCommand } from './commands/extract.js';
-import { debugCommand } from './commands/debug.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
+const { Command } = require('commander');
+const chalk = require('chalk');
+const { readFileSync } = require('fs');
+const { resolve } = require('path');
+const { buildCommand } = require('./commands/build.js');
+const { validateCommand } = require('./commands/validate.js');
+const { inspectCommand } = require('./commands/inspect.js');
+const { extractCommand } = require('./commands/extract.js');
+const { debugCommand } = require('./commands/debug.js');
 
 // Read version from package.json
 const pkg = JSON.parse(
@@ -121,12 +116,16 @@ program
 // ─── Global error handling ──────────────────────────────────────────────────
 program.exitOverride();
 
-try {
-  await program.parseAsync(process.argv);
-} catch (err) {
-  if (err.code === 'commander.helpDisplayed' || err.code === 'commander.version') {
-    process.exit(0);
+async function main() {
+  try {
+    await program.parseAsync(process.argv);
+  } catch (err) {
+    if (err.code === 'commander.helpDisplayed' || err.code === 'commander.version') {
+      process.exit(0);
+    }
+    console.error(chalk.red(`\n✗ Error: ${err.message}\n`));
+    process.exit(1);
   }
-  console.error(chalk.red(`\n✗ Error: ${err.message}\n`));
-  process.exit(1);
 }
+
+main();

package/src/core/OutputWriter.js

@@ -8,13 +8,13 @@
  *  4. Write to file, buffer, or stream
  */
 
-import fsExtra from 'fs-extra';
+const fsExtra = require('fs-extra');
 const { writeFile, ensureDir } = fsExtra;
-import path from 'path';
-import { XMLParser } from '../parsers/XMLParser.js';
-import { createLogger } from '../utils/logger.js';
-import { PPTXError } from '../utils/errors.js';
-import { Readable } from 'stream';
+const path = require('path');
+const { XMLParser } = require('../parsers/XMLParser.js');
+const { createLogger } = require('../utils/logger.js');
+const { PPTXError } = require('../utils/errors.js');
+const { Readable } = require('stream');
 
 const logger = createLogger('OutputWriter');
 
@@ -22,7 +22,7 @@ const logger = createLogger('OutputWriter');
  * @class OutputWriter
  * @description Serializes the modified PPTX to various output formats.
  */
-export class OutputWriter {
+class OutputWriter {
   /** @private @type {ZipManager} */
   #zipManager;
   /** @private @type {ContentTypesManager} */
@@ -179,3 +179,5 @@ export class OutputWriter {
     logger.debug(`Flushed ${info.length} slide(s) to ZIP`);
   }
 }
+
+module.exports = { OutputWriter };

package/src/core/PPTXTemplater.js

@@ -24,19 +24,19 @@
  *     └── app.xml              — application metadata
  */
 
-import { ZipManager } from '../managers/ZipManager.js';
-import { XMLParser } from '../parsers/XMLParser.js';
-import { ContentTypesManager } from '../managers/ContentTypesManager.js';
-import { SlideManager } from '../managers/SlideManager.js';
-import { ChartManager } from '../managers/ChartManager.js';
-import { TableManager } from '../managers/TableManager.js';
-import { HyperlinkManager } from '../managers/HyperlinkManager.js';
-import { MediaManager } from '../managers/MediaManager.js';
-import { RelationshipManager } from '../managers/RelationshipManager.js';
-import { OutputWriter } from './OutputWriter.js';
-import { TemplateEngine } from './TemplateEngine.js';
-import { createLogger } from '../utils/logger.js';
-import { PPTXError } from '../utils/errors.js';
+const { ZipManager } = require('../managers/ZipManager.js');
+const { XMLParser } = require('../parsers/XMLParser.js');
+const { ContentTypesManager } = require('../managers/ContentTypesManager.js');
+const { SlideManager } = require('../managers/SlideManager.js');
+const { ChartManager } = require('../managers/ChartManager.js');
+const { TableManager } = require('../managers/TableManager.js');
+const { HyperlinkManager } = require('../managers/HyperlinkManager.js');
+const { MediaManager } = require('../managers/MediaManager.js');
+const { RelationshipManager } = require('../managers/RelationshipManager.js');
+const { OutputWriter } = require('./OutputWriter.js');
+const { TemplateEngine } = require('./TemplateEngine.js');
+const { createLogger } = require('../utils/logger.js');
+const { PPTXError } = require('../utils/errors.js');
 
 const logger = createLogger('PPTXTemplater');
 
@@ -50,7 +50,7 @@ const logger = createLogger('PPTXTemplater');
  * ppt.replaceText({ '{{title}}': 'My Report' });
  * await ppt.saveToFile('./output/report.pptx');
  */
-export class PPTXTemplater {
+class PPTXTemplater {
   /**
    * @private
    * @type {ZipManager}
@@ -781,8 +781,8 @@ export class PPTXTemplater {
     this.#assertLoaded();
     const issues = { valid: true, errors: [], warnings: [] };
 
-    // We lazy import ChartRelationshipManager so we don't circularly depend if not needed
-    const { ChartRelationshipManager } = await import('../managers/charts/ChartRelationshipManager.js');
+    // We lazy require ChartRelationshipManager so we don't circularly depend if not needed
+    const { ChartRelationshipManager } = require('../managers/charts/ChartRelationshipManager.js');
 
     const chartFiles = this.#zipManager.listFiles('ppt/charts/')
       .filter(f => {
@@ -959,3 +959,5 @@ export class PPTXTemplater {
   get hyperlinkManager() { return this.#hyperlinkManager; }
   get mediaManager() { return this.#mediaManager; }
 }
+
+module.exports = { PPTXTemplater };

package/src/core/TemplateEngine.js

@@ -26,7 +26,7 @@
  * This "text normalization" approach correctly handles fragmented placeholders.
  */
 
-import { createLogger } from '../utils/logger.js';
+const { createLogger } = require('../utils/logger.js');
 
 const logger = createLogger('TemplateEngine');
 
@@ -42,7 +42,7 @@ const DEFAULT_PLACEHOLDER_PATTERN = /\{\{([^{}]+)\}\}/g;
  *
  * Implements the text-normalization strategy to handle fragmented placeholders.
  */
-export class TemplateEngine {
+class TemplateEngine {
   /** @private @type {XMLParser} */
   #xmlParser;
 
@@ -319,3 +319,5 @@ export class TemplateEngine {
       .replace(/'/g, "'");
   }
 }
+
+module.exports = { TemplateEngine };

package/src/index.js

@@ -24,20 +24,43 @@
  * └─────────────────────────────────────────────────────────────┘
  */
 
-export { PPTXTemplater } from './core/PPTXTemplater.js';
-export { ZipManager } from './managers/ZipManager.js';
-export { XMLParser } from './parsers/XMLParser.js';
-export { SlideManager } from './managers/SlideManager.js';
-export { ChartManager } from './managers/ChartManager.js';
-export { TableManager } from './managers/TableManager.js';
-export { HyperlinkManager } from './managers/HyperlinkManager.js';
-export { MediaManager } from './managers/MediaManager.js';
-export { RelationshipManager } from './managers/RelationshipManager.js';
-export { OutputWriter } from './core/OutputWriter.js';
-export { TemplateEngine } from './core/TemplateEngine.js';
+const { PPTXTemplater } = require('./core/PPTXTemplater.js');
+const { ZipManager } = require('./managers/ZipManager.js');
+const { XMLParser } = require('./parsers/XMLParser.js');
+const { SlideManager } = require('./managers/SlideManager.js');
+const { ChartManager } = require('./managers/ChartManager.js');
+const { TableManager } = require('./managers/TableManager.js');
+const { HyperlinkManager } = require('./managers/HyperlinkManager.js');
+const { MediaManager } = require('./managers/MediaManager.js');
+const { RelationshipManager } = require('./managers/RelationshipManager.js');
+const { OutputWriter } = require('./core/OutputWriter.js');
+const { TemplateEngine } = require('./core/TemplateEngine.js');
 
 // Utility exports
-export { generateRelationshipId, parseRelationshipId } from './utils/relationshipUtils.js';
-export { validateXML, repairXML } from './utils/xmlUtils.js';
-export { createLogger } from './utils/logger.js';
-export { PPTXError, SlideNotFoundError, ChartNotFoundError, TableNotFoundError } from './utils/errors.js';
+const { generateRelationshipId, parseRelationshipId } = require('./utils/relationshipUtils.js');
+const { validateXML, repairXML } = require('./utils/xmlUtils.js');
+const { createLogger } = require('./utils/logger.js');
+const { PPTXError, SlideNotFoundError, ChartNotFoundError, TableNotFoundError } = require('./utils/errors.js');
+
+module.exports = {
+  PPTXTemplater,
+  ZipManager,
+  XMLParser,
+  SlideManager,
+  ChartManager,
+  TableManager,
+  HyperlinkManager,
+  MediaManager,
+  RelationshipManager,
+  OutputWriter,
+  TemplateEngine,
+  generateRelationshipId,
+  parseRelationshipId,
+  validateXML,
+  repairXML,
+  createLogger,
+  PPTXError,
+  SlideNotFoundError,
+  ChartNotFoundError,
+  TableNotFoundError
+};

package/src/managers/ChartManager.js

@@ -39,11 +39,11 @@
  * We update both to ensure compatibility with both cached and live data.
  */
 
-import { createLogger } from '../utils/logger.js';
-import { ChartNotFoundError } from '../utils/errors.js';
-import { REL_TYPES } from './RelationshipManager.js';
-import { ChartWorkbookUpdater } from './charts/ChartWorkbookUpdater.js';
-import { ChartCacheGenerator } from './charts/ChartCacheGenerator.js';
+const { createLogger } = require('../utils/logger.js');
+const { ChartNotFoundError } = require('../utils/errors.js');
+const { REL_TYPES } = require('./RelationshipManager.js');
+const { ChartWorkbookUpdater } = require('./charts/ChartWorkbookUpdater.js');
+const { ChartCacheGenerator } = require('./charts/ChartCacheGenerator.js');
 
 const logger = createLogger('ChartManager');
 
@@ -69,7 +69,7 @@ const CHART_TYPE_MAP = {
  * Unlike high-level charting libraries, this manager edits the raw OpenXML
  * chart structure, allowing full control while preserving styles and themes.
  */
-export class ChartManager {
+class ChartManager {
   /** @private @type {XMLParser} */
   #xmlParser;
   /** @private @type {ZipManager} */
@@ -315,3 +315,5 @@ export class ChartManager {
     return 'unknown';
   }
 }
+
+module.exports = { ChartManager };

package/src/managers/ContentTypesManager.js

@@ -4,14 +4,14 @@
  * Implements structured, XML-safe manipulation of the OPC manifest.
  */
 
-import { createLogger } from '../utils/logger.js';
-import { PPTXError } from '../utils/errors.js';
+const { createLogger } = require('../utils/logger.js');
+const { PPTXError } = require('../utils/errors.js');
 
 const logger = createLogger('ContentTypesManager');
 
 const TYPES_XML_PATH = '[Content_Types].xml';
 
-export class ContentTypesManager {
+class ContentTypesManager {
   /** @private @type {XMLParser} */
   #xmlParser;
 
@@ -158,3 +158,5 @@ export class ContentTypesManager {
     logger.debug(`Flushed ${TYPES_XML_PATH}`);
   }
 }
+
+module.exports = { ContentTypesManager };

package/src/managers/HyperlinkManager.js

@@ -31,9 +31,9 @@
  *   Use <a:hlinkMouseOver r:id="..."/> instead of hlinkClick.
  */
 
-import { createLogger } from '../utils/logger.js';
-import { PPTXError } from '../utils/errors.js';
-import { REL_TYPES } from './RelationshipManager.js';
+const { createLogger } = require('../utils/logger.js');
+const { PPTXError } = require('../utils/errors.js');
+const { REL_TYPES } = require('./RelationshipManager.js');
 
 const logger = createLogger('HyperlinkManager');
 
@@ -41,7 +41,7 @@ const logger = createLogger('HyperlinkManager');
  * @class HyperlinkManager
  * @description Manages hyperlink creation and modification in PPTX slides.
  */
-export class HyperlinkManager {
+class HyperlinkManager {
   /** @private @type {XMLParser} */
   #xmlParser;
   /** @private @type {RelationshipManager} */
@@ -449,3 +449,5 @@ export class HyperlinkManager {
     return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
   }
 }
+
+module.exports = { HyperlinkManager };

package/src/managers/MediaManager.js

@@ -36,11 +36,11 @@
  *   Audio: MP3, WAV, M4A
  */
 
-import { createHash } from 'crypto';
-import { createLogger } from '../utils/logger.js';
-import { PPTXError } from '../utils/errors.js';
-import { REL_TYPES } from './RelationshipManager.js';
-import fsExtra from 'fs-extra';
+const { createHash } = require('crypto');
+const { createLogger } = require('../utils/logger.js');
+const { PPTXError } = require('../utils/errors.js');
+const { REL_TYPES } = require('./RelationshipManager.js');
+const fsExtra = require('fs-extra');
 
 const logger = createLogger('MediaManager');
 
@@ -84,7 +84,7 @@ const EXT_TO_MIME = {
  * @class MediaManager
  * @description Manages media embedding, deduplication, and retrieval in PPTX files.
  */
-export class MediaManager {
+class MediaManager {
   /** @private @type {ContentTypesManager} */
   #contentTypesManager;
   /** @private @type {ZipManager} */
@@ -305,3 +305,5 @@ export class MediaManager {
     this.#contentTypesManager.addDefault(ext, mimeType);
   }
 }
+
+module.exports = { MediaManager };

package/src/managers/RelationshipManager.js

@@ -35,9 +35,9 @@
  *  - .../slideToSlide       → slide → another slide (inter-slide link)
  */
 
-import { createLogger } from '../utils/logger.js';
-import { PPTXError } from '../utils/errors.js';
-import { generateRelationshipId } from '../utils/relationshipUtils.js';
+const { createLogger } = require('../utils/logger.js');
+const { PPTXError } = require('../utils/errors.js');
+const { generateRelationshipId } = require('../utils/relationshipUtils.js');
 
 const logger = createLogger('RelationshipManager');
 
@@ -45,7 +45,7 @@ const logger = createLogger('RelationshipManager');
  * OpenXML relationship type constants.
  * Using shortened forms; full URIs are in the OpenXML spec.
  */
-export const REL_TYPES = {
+const REL_TYPES = {
   SLIDE: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide',
   SLIDE_LAYOUT: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout',
   SLIDE_MASTER: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster',
@@ -70,7 +70,7 @@ export const REL_TYPES = {
  *  - ppt/presentation.xml → ppt/_rels/presentation.xml.rels
  *  - ppt/slides/slide1.xml → ppt/slides/_rels/slide1.xml.rels
  */
-export class RelationshipManager {
+class RelationshipManager {
   /**
    * @private
    * @type {XMLParser}
@@ -399,3 +399,5 @@ export class RelationshipManager {
     logger.debug(`Removed ${removedCount} orphan relationship(s).`);
   }
 }
+
+module.exports = { REL_TYPES, RelationshipManager };

package/src/managers/SlideManager.js

@@ -24,12 +24,12 @@
  *  - p:cxnSp    → Connectors
  */
 
-import { createLogger } from '../utils/logger.js';
-import { PPTXError, SlideNotFoundError } from '../utils/errors.js';
-import { REL_TYPES } from './RelationshipManager.js';
-import { buildNewSlideXml } from '../templates/slideTemplate.js';
-import { generateUniqueId } from '../utils/idUtils.js';
-import { remapRelationshipIds } from '../utils/relationshipUtils.js';
+const { createLogger } = require('../utils/logger.js');
+const { PPTXError, SlideNotFoundError } = require('../utils/errors.js');
+const { REL_TYPES } = require('./RelationshipManager.js');
+const { buildNewSlideXml } = require('../templates/slideTemplate.js');
+const { generateUniqueId } = require('../utils/idUtils.js');
+const { remapRelationshipIds } = require('../utils/relationshipUtils.js');
 
 const logger = createLogger('SlideManager');
 
@@ -50,7 +50,7 @@ const SLIDE_CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.presen
  * @class SlideManager
  * @description Manages slide loading, ordering, modification, and creation.
  */
-export class SlideManager {
+class SlideManager {
   /** @private @type {XMLParser} */
   #xmlParser;
   /** @private @type {RelationshipManager} */
@@ -733,7 +733,7 @@ export class SlideManager {
    */
   async exportSlides(slideIndices, sourceEngine) {
     // Lazy import to avoid circular dep
-    const { PPTXTemplater } = await import('../core/PPTXTemplater.js');
+    const { PPTXTemplater } = require('../core/PPTXTemplater.js');
 
     // Create a blank new PPTX
     const newEngine = await PPTXTemplater.create();
@@ -948,3 +948,5 @@ export class SlideManager {
     }
   }
 }
+
+module.exports = { SlideManager };

package/src/managers/TableManager.js

@@ -45,8 +45,8 @@
  *  - <a:tc vMerge="1"> → continuation of vertical merge
  */
 
-import { createLogger } from '../utils/logger.js';
-import { TableNotFoundError } from '../utils/errors.js';
+const { createLogger } = require('../utils/logger.js');
+const { TableNotFoundError } = require('../utils/errors.js');
 
 const logger = createLogger('TableManager');
 
@@ -57,7 +57,7 @@ const logger = createLogger('TableManager');
  * The key design principle is "preserve formatting, replace content".
  * We never touch table styles, borders, or fonts — only the text.
  */
-export class TableManager {
+class TableManager {
   /** @private @type {XMLParser} */
   #xmlParser;
 
@@ -414,3 +414,5 @@ export class TableManager {
     return tables;
   }
 }
+
+module.exports = { TableManager };