pptx-glimpse 3.0.0 → 3.1.0

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+import {
+  convertPptxToPng,
+  convertPptxToSvg
+} from "./chunk-XGCLQP2P.js";
+import "./chunk-NMAO44T7.js";
+import "./chunk-PGCREQQU.js";
+
+// src/cli-runner.ts
+import { mkdir, readFile, stat, writeFile } from "fs/promises";
+import { basename, extname, resolve } from "path";
+import { parseArgs } from "util";
+var defaultConverters = {
+  convertPptxToSvg,
+  convertPptxToPng
+};
+var helpText = `Usage:
+  pptx-glimpse convert <file.pptx> [options]
+
+Options:
+  --format <svg|png>       Output format. Defaults to svg.
+  --slides <list>          Comma-separated 1-based slide numbers, such as 1,3.
+  --out <dir>              Output directory. Defaults to the current directory.
+  --log-level <level>      Diagnostic output: off, warn, or debug. Defaults to warn.
+  --system-fonts           Scan OS system font directories for better text fidelity.
+  -h, --help               Show this help message.
+`;
+async function runCli(argv, options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const streams = options.streams ?? { stdout: process.stdout, stderr: process.stderr };
+  const converters = options.converters ?? defaultConverters;
+  try {
+    if (argv.length === 0 || argv[0] === "--help" || argv[0] === "-h" || argv[0] === "help") {
+      streams.stdout.write(helpText);
+      return 0;
+    }
+    const [command, ...commandArgs] = argv;
+    if (command !== "convert") {
+      throw new CliUsageError(`Unknown command: ${command}`);
+    }
+    const commandOptions = parseConvertCommand(commandArgs, cwd);
+    await runConvertCommand(commandOptions, streams, converters);
+    return 0;
+  } catch (error) {
+    if (error instanceof CliHelpRequested) {
+      streams.stdout.write(helpText);
+      return 0;
+    }
+    streams.stderr.write(`pptx-glimpse: ${formatError(error)}
+`);
+    return 1;
+  }
+}
+function parseConvertCommand(args, cwd) {
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args: [...args],
+      allowPositionals: true,
+      options: {
+        format: { type: "string" },
+        slides: { type: "string" },
+        out: { type: "string" },
+        "log-level": { type: "string" },
+        "system-fonts": { type: "boolean" },
+        help: { type: "boolean", short: "h" }
+      }
+    });
+  } catch (error) {
+    throw new CliUsageError(formatError(error));
+  }
+  if (parsed.values.help === true) {
+    throw new CliHelpRequested();
+  }
+  if (parsed.positionals.length !== 1) {
+    throw new CliUsageError("Expected exactly one PPTX input file.");
+  }
+  const format = parseFormat(stringOption(parsed.values.format, "--format"));
+  const logLevel = parseLogLevel(stringOption(parsed.values["log-level"], "--log-level"));
+  const slides = parseSlides(stringOption(parsed.values.slides, "--slides"));
+  const outputDir = resolve(cwd, stringOption(parsed.values.out, "--out") ?? ".");
+  return {
+    inputPath: resolve(cwd, parsed.positionals[0]),
+    outputDir,
+    format,
+    ...slides !== void 0 ? { slides } : {},
+    logLevel,
+    systemFonts: parsed.values["system-fonts"] === true
+  };
+}
+async function runConvertCommand(options, streams, converters) {
+  await assertReadableFile(options.inputPath);
+  await mkdir(options.outputDir, { recursive: true });
+  const input = await readFile(options.inputPath);
+  const basenameWithoutExtension = basename(options.inputPath, extname(options.inputPath));
+  const conversionOptions = {
+    // Route diagnostics through the CLI streams below instead of converter console output.
+    logLevel: "off",
+    skipSystemFonts: !options.systemFonts,
+    ...options.slides !== void 0 ? { slides: options.slides } : {}
+  };
+  if (options.format === "png") {
+    const report2 = await converters.convertPptxToPng(input, conversionOptions);
+    for (const slide of report2.slides) {
+      const outputPath = resolve(
+        options.outputDir,
+        `${basenameWithoutExtension}-slide${slide.slideNumber}.png`
+      );
+      await writeFile(outputPath, slide.png);
+      streams.stdout.write(`${outputPath}
+`);
+    }
+    printDiagnostics(report2, options.logLevel, streams.stderr);
+    return;
+  }
+  const report = await converters.convertPptxToSvg(input, conversionOptions);
+  for (const slide of report.slides) {
+    const outputPath = resolve(
+      options.outputDir,
+      `${basenameWithoutExtension}-slide${slide.slideNumber}.svg`
+    );
+    await writeFile(outputPath, slide.svg, "utf8");
+    streams.stdout.write(`${outputPath}
+`);
+  }
+  printDiagnostics(report, options.logLevel, streams.stderr);
+}
+async function assertReadableFile(inputPath) {
+  try {
+    const inputStat = await stat(inputPath);
+    if (!inputStat.isFile()) {
+      throw new CliUsageError(`Input is not a file: ${inputPath}`);
+    }
+  } catch (error) {
+    if (error instanceof CliUsageError) throw error;
+    throw new CliUsageError(`Input file not found: ${inputPath}`);
+  }
+}
+function parseFormat(value) {
+  if (value === void 0) return "svg";
+  if (value === "svg" || value === "png") return value;
+  throw new CliUsageError(`Invalid --format value: ${value}. Expected svg or png.`);
+}
+function stringOption(value, name) {
+  if (value === void 0) return void 0;
+  if (typeof value === "string") return value;
+  throw new CliUsageError(`Invalid ${name} value.`);
+}
+function parseLogLevel(value) {
+  if (value === void 0) return "warn";
+  if (value === "off" || value === "warn" || value === "debug") return value;
+  throw new CliUsageError(`Invalid --log-level value: ${value}. Expected off, warn, or debug.`);
+}
+function parseSlides(value) {
+  if (value === void 0) return void 0;
+  const slides = value.split(",").map((part) => {
+    const trimmed = part.trim();
+    if (!/^[1-9]\d*$/.test(trimmed)) {
+      throw new CliUsageError(`Invalid --slides value: ${value}. Expected values like 1,3.`);
+    }
+    return Number(trimmed);
+  });
+  if (slides.length === 0) {
+    throw new CliUsageError("Expected at least one slide number.");
+  }
+  return slides;
+}
+function printDiagnostics(report, logLevel, stderr) {
+  if (logLevel === "off") return;
+  const warnings = report.diagnostics.filter((diagnostic) => diagnostic.severity === "warning");
+  if (warnings.length === 0) return;
+  stderr.write(`pptx-glimpse: ${warnings.length} warning(s)
+`);
+  if (logLevel !== "debug") return;
+  for (const warning of warnings) {
+    const slide = warning.slideNumber !== void 0 ? ` slide ${warning.slideNumber}` : "";
+    stderr.write(`pptx-glimpse:${slide} ${warning.code}: ${warning.message}
+`);
+  }
+}
+function formatError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+var CliUsageError = class extends Error {
+};
+var CliHelpRequested = class extends Error {
+  constructor() {
+    super(helpText);
+  }
+};
+
+// src/cli.ts
+void runCli(process.argv.slice(2)).then((exitCode) => {
+  process.exitCode = exitCode;
+});