pptx-glimpse 0.2.1 → 0.2.2

package/dist/index.cjs

@@ -3813,6 +3813,65 @@ function renderPlaceholder(mimeType, w, h, transformAttr) {
   ].join("");
 }
 
+// src/warning-logger.ts
+var PREFIX = "[pptx-glimpse]";
+var currentLevel = "off";
+var entries = [];
+var featureCounts = /* @__PURE__ */ new Map();
+function initWarningLogger(level) {
+  currentLevel = level;
+  entries = [];
+  featureCounts.clear();
+}
+function warn(feature, message, context) {
+  if (currentLevel === "off") return;
+  entries.push({ feature, message, ...context !== void 0 && { context } });
+  const existing = featureCounts.get(feature);
+  if (existing) {
+    existing.count++;
+  } else {
+    featureCounts.set(feature, { message, count: 1 });
+  }
+  if (currentLevel === "debug") {
+    const ctx = context ? ` (${context})` : "";
+    console.warn(`${PREFIX} SKIP: ${feature} - ${message}${ctx}`);
+  }
+}
+function debug(feature, message, context) {
+  if (currentLevel !== "debug") return;
+  entries.push({ feature, message, ...context !== void 0 && { context } });
+  const existing = featureCounts.get(feature);
+  if (existing) {
+    existing.count++;
+  } else {
+    featureCounts.set(feature, { message, count: 1 });
+  }
+  const ctx = context ? ` (${context})` : "";
+  console.warn(`${PREFIX} DEBUG: ${feature} - ${message}${ctx}`);
+}
+function getWarningSummary() {
+  const features = [];
+  for (const [feature, { message, count }] of featureCounts) {
+    features.push({ feature, message, count });
+  }
+  return { totalCount: entries.length, features };
+}
+function flushWarnings() {
+  const summary = getWarningSummary();
+  if (currentLevel !== "off" && summary.features.length > 0) {
+    console.warn(`${PREFIX} Summary: ${summary.features.length} unsupported feature(s) detected`);
+    for (const { feature, count } of summary.features) {
+      console.warn(`  - ${feature}: ${count} occurrence(s)`);
+    }
+  }
+  entries = [];
+  featureCounts.clear();
+  return summary;
+}
+function getWarningEntries() {
+  return entries;
+}
+
 // src/renderer/chart-renderer.ts
 var DEFAULT_SERIES_COLORS = [
   { hex: "#4472C4", alpha: 1 },
@@ -3894,11 +3953,20 @@ function renderChartTitle(title, chartWidth) {
 function renderBarChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.bar", "series is empty");
+    return "";
+  }
   const maxVal = getMaxValue(series);
-  if (maxVal === 0) return "";
+  if (maxVal === 0) {
+    debug("chart.bar", "max value is 0");
+    return "";
+  }
   const catCount = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.bar", "category count is 0");
+    return "";
+  }
   const isHorizontal = chart.barDirection === "bar";
   parts.push(
     `<line x1="${round3(x)}" y1="${round3(y + h)}" x2="${round3(x + w)}" y2="${round3(y + h)}" stroke="#D9D9D9" stroke-width="1"/>`
@@ -3958,11 +4026,20 @@ function renderBarChart(chart, x, y, w, h) {
 function renderLineChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.line", "series is empty");
+    return "";
+  }
   const maxVal = getMaxValue(series);
-  if (maxVal === 0) return "";
+  if (maxVal === 0) {
+    debug("chart.line", "max value is 0");
+    return "";
+  }
   const catCount = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.line", "category count is 0");
+    return "";
+  }
   parts.push(
     `<line x1="${round3(x)}" y1="${round3(y + h)}" x2="${round3(x + w)}" y2="${round3(y + h)}" stroke="#D9D9D9" stroke-width="1"/>`
   );
@@ -3998,11 +4075,20 @@ function renderLineChart(chart, x, y, w, h) {
 function renderAreaChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.area", "series is empty");
+    return "";
+  }
   const maxVal = getMaxValue(series);
-  if (maxVal === 0) return "";
+  if (maxVal === 0) {
+    debug("chart.area", "max value is 0");
+    return "";
+  }
   const catCount = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.area", "category count is 0");
+    return "";
+  }
   parts.push(
     `<line x1="${round3(x)}" y1="${round3(y + h)}" x2="${round3(x + w)}" y2="${round3(y + h)}" stroke="#D9D9D9" stroke-width="1"/>`
   );
@@ -4039,9 +4125,15 @@ function renderAreaChart(chart, x, y, w, h) {
 function renderPieChart(chart, x, y, w, h) {
   const parts = [];
   const series = chart.series[0];
-  if (!series || series.values.length === 0) return "";
+  if (!series || series.values.length === 0) {
+    debug("chart.pie", "series is empty or has no values");
+    return "";
+  }
   const total = series.values.reduce((sum, v) => sum + v, 0);
-  if (total === 0) return "";
+  if (total === 0) {
+    debug("chart.pie", "total value is 0");
+    return "";
+  }
   const cx = x + w / 2;
   const cy = y + h / 2;
   const r = Math.min(w, h) / 2 * 0.85;
@@ -4071,9 +4163,15 @@ function renderPieChart(chart, x, y, w, h) {
 function renderDoughnutChart(chart, x, y, w, h) {
   const parts = [];
   const series = chart.series[0];
-  if (!series || series.values.length === 0) return "";
+  if (!series || series.values.length === 0) {
+    debug("chart.doughnut", "series is empty or has no values");
+    return "";
+  }
   const total = series.values.reduce((sum, v) => sum + v, 0);
-  if (total === 0) return "";
+  if (total === 0) {
+    debug("chart.doughnut", "total value is 0");
+    return "";
+  }
   const cx = x + w / 2;
   const cy = y + h / 2;
   const outerR = Math.min(w, h) / 2 * 0.85;
@@ -4112,7 +4210,10 @@ function renderDoughnutChart(chart, x, y, w, h) {
 function renderScatterChart(chart, x, y, w, h) {
   const parts = [];
   const { series } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.scatter", "series is empty");
+    return "";
+  }
   let maxX = 0;
   let maxY = 0;
   for (const s of series) {
@@ -4144,7 +4245,10 @@ function renderScatterChart(chart, x, y, w, h) {
 function renderBubbleChart(chart, x, y, w, h) {
   const parts = [];
   const { series } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.bubble", "series is empty");
+    return "";
+  }
   let maxX = 0;
   let maxY = 0;
   let maxBubble = 0;
@@ -4186,11 +4290,20 @@ function renderBubbleChart(chart, x, y, w, h) {
 function renderRadarChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.radar", "series is empty");
+    return "";
+  }
   const maxVal = getMaxValue(series);
-  if (maxVal === 0) return "";
+  if (maxVal === 0) {
+    debug("chart.radar", "max value is 0");
+    return "";
+  }
   const catCount = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.radar", "category count is 0");
+    return "";
+  }
   const cx = x + w / 2;
   const cy = y + h / 2;
   const radius = Math.min(w, h) / 2 * 0.85;
@@ -4254,12 +4367,18 @@ function renderRadarChart(chart, x, y, w, h) {
 function renderStockChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length < 3) return "";
+  if (series.length < 3) {
+    debug("chart.stock", `insufficient series count: ${series.length} (need at least 3)`);
+    return "";
+  }
   const highSeries = series[0];
   const lowSeries = series[1];
   const closeSeries = series[2];
   const catCount = categories.length || highSeries.values.length;
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.stock", "category count is 0");
+    return "";
+  }
   let maxVal = 0;
   let minVal = Infinity;
   for (const s of [highSeries, lowSeries, closeSeries]) {
@@ -4268,7 +4387,10 @@ function renderStockChart(chart, x, y, w, h) {
       minVal = Math.min(minVal, v);
     }
   }
-  if (maxVal === minVal) return "";
+  if (maxVal === minVal) {
+    debug("chart.stock", "max equals min value");
+    return "";
+  }
   parts.push(
     `<line x1="${round3(x)}" y1="${round3(y + h)}" x2="${round3(x + w)}" y2="${round3(y + h)}" stroke="#D9D9D9" stroke-width="1"/>`
   );
@@ -4304,10 +4426,16 @@ function renderStockChart(chart, x, y, w, h) {
 function renderSurfaceChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.surface", "series is empty");
+    return "";
+  }
   const rows = series.length;
   const cols = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (cols === 0) return "";
+  if (cols === 0) {
+    debug("chart.surface", "column count is 0");
+    return "";
+  }
   let minVal = Infinity;
   let maxVal = -Infinity;
   for (const s of series) {
@@ -4380,9 +4508,15 @@ function heatmapColor(t) {
 function renderOfPieChart(chart, x, y, w, h) {
   const parts = [];
   const series = chart.series[0];
-  if (!series || series.values.length === 0) return "";
+  if (!series || series.values.length === 0) {
+    debug("chart.ofPie", "series is empty or has no values");
+    return "";
+  }
   const total = series.values.reduce((sum, v) => sum + v, 0);
-  if (total === 0) return "";
+  if (total === 0) {
+    debug("chart.ofPie", "total value is 0");
+    return "";
+  }
   const splitPos = chart.splitPos ?? 2;
   const secondPieSize = chart.secondPieSize ?? 75;
   const isBarOfPie = chart.ofPieType === "bar";
@@ -4747,65 +4881,6 @@ async function svgToPng(svgString, options) {
   return { png: result.data, width: result.info.width, height: result.info.height };
 }
 
-// src/warning-logger.ts
-var PREFIX = "[pptx-glimpse]";
-var currentLevel = "off";
-var entries = [];
-var featureCounts = /* @__PURE__ */ new Map();
-function initWarningLogger(level) {
-  currentLevel = level;
-  entries = [];
-  featureCounts.clear();
-}
-function warn(feature, message, context) {
-  if (currentLevel === "off") return;
-  entries.push({ feature, message, ...context !== void 0 && { context } });
-  const existing = featureCounts.get(feature);
-  if (existing) {
-    existing.count++;
-  } else {
-    featureCounts.set(feature, { message, count: 1 });
-  }
-  if (currentLevel === "debug") {
-    const ctx = context ? ` (${context})` : "";
-    console.warn(`${PREFIX} SKIP: ${feature} - ${message}${ctx}`);
-  }
-}
-function debug(feature, message, context) {
-  if (currentLevel !== "debug") return;
-  entries.push({ feature, message, ...context !== void 0 && { context } });
-  const existing = featureCounts.get(feature);
-  if (existing) {
-    existing.count++;
-  } else {
-    featureCounts.set(feature, { message, count: 1 });
-  }
-  const ctx = context ? ` (${context})` : "";
-  console.warn(`${PREFIX} DEBUG: ${feature} - ${message}${ctx}`);
-}
-function getWarningSummary() {
-  const features = [];
-  for (const [feature, { message, count }] of featureCounts) {
-    features.push({ feature, message, count });
-  }
-  return { totalCount: entries.length, features };
-}
-function flushWarnings() {
-  const summary = getWarningSummary();
-  if (currentLevel !== "off" && summary.features.length > 0) {
-    console.warn(`${PREFIX} Summary: ${summary.features.length} unsupported feature(s) detected`);
-    for (const { feature, count } of summary.features) {
-      console.warn(`  - ${feature}: ${count} occurrence(s)`);
-    }
-  }
-  entries = [];
-  featureCounts.clear();
-  return summary;
-}
-function getWarningEntries() {
-  return entries;
-}
-
 // src/parser/pptx-reader.ts
 var import_fflate = require("fflate");
 function readPptx(input) {
@@ -6183,10 +6258,16 @@ function parseCustomGeometry(custGeom) {
   for (const path of paths) {
     const w = Number(path["@_w"] ?? 0);
     const h = Number(path["@_h"] ?? 0);
-    if (w === 0 && h === 0) continue;
+    if (w === 0 && h === 0) {
+      debug("custGeom.path", "path skipped: width and height are both 0");
+      continue;
+    }
     const vars = evaluateGuides(avGd, gdGd, w, h);
     const commands = buildPathCommands(path, vars);
-    if (!commands) continue;
+    if (!commands) {
+      debug("custGeom.path", "path skipped: failed to build path commands");
+      continue;
+    }
     result.push({ width: w, height: h, commands });
   }
   return result.length > 0 ? result : null;
@@ -6759,7 +6840,10 @@ function parseImage(pic, rels, slidePath, archive, colorResolver) {
   if (!rel) return null;
   const mediaPath = resolveRelationshipTarget(slidePath, rel.target);
   const mediaData = archive.media.get(mediaPath);
-  if (!mediaData) return null;
+  if (!mediaData) {
+    debug("picture.media", `media file not found: ${mediaPath}`);
+    return null;
+  }
   const ext = mediaPath.split(".").pop()?.toLowerCase() ?? "png";
   const mimeMap = {
     png: "image/png",
@@ -6958,9 +7042,15 @@ function parseSmartArt(graphicData, transform, rels, slidePath, archive, colorRe
       }
     }
   }
-  if (!drawingPath) return null;
+  if (!drawingPath) {
+    debug("smartArt.drawing", "diagramDrawing relationship not found");
+    return null;
+  }
   const drawingXml = archive.files.get(drawingPath);
-  if (!drawingXml) return null;
+  if (!drawingXml) {
+    debug("smartArt.drawing", `drawing XML not found in archive: ${drawingPath}`);
+    return null;
+  }
   const parsed = parseXml(drawingXml);
   const drawing = parsed.drawing;
   const spTree = drawing?.spTree;

package/dist/index.js

@@ -3770,6 +3770,65 @@ function renderPlaceholder(mimeType, w, h, transformAttr) {
   ].join("");
 }
 
+// src/warning-logger.ts
+var PREFIX = "[pptx-glimpse]";
+var currentLevel = "off";
+var entries = [];
+var featureCounts = /* @__PURE__ */ new Map();
+function initWarningLogger(level) {
+  currentLevel = level;
+  entries = [];
+  featureCounts.clear();
+}
+function warn(feature, message, context) {
+  if (currentLevel === "off") return;
+  entries.push({ feature, message, ...context !== void 0 && { context } });
+  const existing = featureCounts.get(feature);
+  if (existing) {
+    existing.count++;
+  } else {
+    featureCounts.set(feature, { message, count: 1 });
+  }
+  if (currentLevel === "debug") {
+    const ctx = context ? ` (${context})` : "";
+    console.warn(`${PREFIX} SKIP: ${feature} - ${message}${ctx}`);
+  }
+}
+function debug(feature, message, context) {
+  if (currentLevel !== "debug") return;
+  entries.push({ feature, message, ...context !== void 0 && { context } });
+  const existing = featureCounts.get(feature);
+  if (existing) {
+    existing.count++;
+  } else {
+    featureCounts.set(feature, { message, count: 1 });
+  }
+  const ctx = context ? ` (${context})` : "";
+  console.warn(`${PREFIX} DEBUG: ${feature} - ${message}${ctx}`);
+}
+function getWarningSummary() {
+  const features = [];
+  for (const [feature, { message, count }] of featureCounts) {
+    features.push({ feature, message, count });
+  }
+  return { totalCount: entries.length, features };
+}
+function flushWarnings() {
+  const summary = getWarningSummary();
+  if (currentLevel !== "off" && summary.features.length > 0) {
+    console.warn(`${PREFIX} Summary: ${summary.features.length} unsupported feature(s) detected`);
+    for (const { feature, count } of summary.features) {
+      console.warn(`  - ${feature}: ${count} occurrence(s)`);
+    }
+  }
+  entries = [];
+  featureCounts.clear();
+  return summary;
+}
+function getWarningEntries() {
+  return entries;
+}
+
 // src/renderer/chart-renderer.ts
 var DEFAULT_SERIES_COLORS = [
   { hex: "#4472C4", alpha: 1 },
@@ -3851,11 +3910,20 @@ function renderChartTitle(title, chartWidth) {
 function renderBarChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.bar", "series is empty");
+    return "";
+  }
   const maxVal = getMaxValue(series);
-  if (maxVal === 0) return "";
+  if (maxVal === 0) {
+    debug("chart.bar", "max value is 0");
+    return "";
+  }
   const catCount = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.bar", "category count is 0");
+    return "";
+  }
   const isHorizontal = chart.barDirection === "bar";
   parts.push(
     `<line x1="${round3(x)}" y1="${round3(y + h)}" x2="${round3(x + w)}" y2="${round3(y + h)}" stroke="#D9D9D9" stroke-width="1"/>`
@@ -3915,11 +3983,20 @@ function renderBarChart(chart, x, y, w, h) {
 function renderLineChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.line", "series is empty");
+    return "";
+  }
   const maxVal = getMaxValue(series);
-  if (maxVal === 0) return "";
+  if (maxVal === 0) {
+    debug("chart.line", "max value is 0");
+    return "";
+  }
   const catCount = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.line", "category count is 0");
+    return "";
+  }
   parts.push(
     `<line x1="${round3(x)}" y1="${round3(y + h)}" x2="${round3(x + w)}" y2="${round3(y + h)}" stroke="#D9D9D9" stroke-width="1"/>`
   );
@@ -3955,11 +4032,20 @@ function renderLineChart(chart, x, y, w, h) {
 function renderAreaChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.area", "series is empty");
+    return "";
+  }
   const maxVal = getMaxValue(series);
-  if (maxVal === 0) return "";
+  if (maxVal === 0) {
+    debug("chart.area", "max value is 0");
+    return "";
+  }
   const catCount = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.area", "category count is 0");
+    return "";
+  }
   parts.push(
     `<line x1="${round3(x)}" y1="${round3(y + h)}" x2="${round3(x + w)}" y2="${round3(y + h)}" stroke="#D9D9D9" stroke-width="1"/>`
   );
@@ -3996,9 +4082,15 @@ function renderAreaChart(chart, x, y, w, h) {
 function renderPieChart(chart, x, y, w, h) {
   const parts = [];
   const series = chart.series[0];
-  if (!series || series.values.length === 0) return "";
+  if (!series || series.values.length === 0) {
+    debug("chart.pie", "series is empty or has no values");
+    return "";
+  }
   const total = series.values.reduce((sum, v) => sum + v, 0);
-  if (total === 0) return "";
+  if (total === 0) {
+    debug("chart.pie", "total value is 0");
+    return "";
+  }
   const cx = x + w / 2;
   const cy = y + h / 2;
   const r = Math.min(w, h) / 2 * 0.85;
@@ -4028,9 +4120,15 @@ function renderPieChart(chart, x, y, w, h) {
 function renderDoughnutChart(chart, x, y, w, h) {
   const parts = [];
   const series = chart.series[0];
-  if (!series || series.values.length === 0) return "";
+  if (!series || series.values.length === 0) {
+    debug("chart.doughnut", "series is empty or has no values");
+    return "";
+  }
   const total = series.values.reduce((sum, v) => sum + v, 0);
-  if (total === 0) return "";
+  if (total === 0) {
+    debug("chart.doughnut", "total value is 0");
+    return "";
+  }
   const cx = x + w / 2;
   const cy = y + h / 2;
   const outerR = Math.min(w, h) / 2 * 0.85;
@@ -4069,7 +4167,10 @@ function renderDoughnutChart(chart, x, y, w, h) {
 function renderScatterChart(chart, x, y, w, h) {
   const parts = [];
   const { series } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.scatter", "series is empty");
+    return "";
+  }
   let maxX = 0;
   let maxY = 0;
   for (const s of series) {
@@ -4101,7 +4202,10 @@ function renderScatterChart(chart, x, y, w, h) {
 function renderBubbleChart(chart, x, y, w, h) {
   const parts = [];
   const { series } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.bubble", "series is empty");
+    return "";
+  }
   let maxX = 0;
   let maxY = 0;
   let maxBubble = 0;
@@ -4143,11 +4247,20 @@ function renderBubbleChart(chart, x, y, w, h) {
 function renderRadarChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.radar", "series is empty");
+    return "";
+  }
   const maxVal = getMaxValue(series);
-  if (maxVal === 0) return "";
+  if (maxVal === 0) {
+    debug("chart.radar", "max value is 0");
+    return "";
+  }
   const catCount = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.radar", "category count is 0");
+    return "";
+  }
   const cx = x + w / 2;
   const cy = y + h / 2;
   const radius = Math.min(w, h) / 2 * 0.85;
@@ -4211,12 +4324,18 @@ function renderRadarChart(chart, x, y, w, h) {
 function renderStockChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length < 3) return "";
+  if (series.length < 3) {
+    debug("chart.stock", `insufficient series count: ${series.length} (need at least 3)`);
+    return "";
+  }
   const highSeries = series[0];
   const lowSeries = series[1];
   const closeSeries = series[2];
   const catCount = categories.length || highSeries.values.length;
-  if (catCount === 0) return "";
+  if (catCount === 0) {
+    debug("chart.stock", "category count is 0");
+    return "";
+  }
   let maxVal = 0;
   let minVal = Infinity;
   for (const s of [highSeries, lowSeries, closeSeries]) {
@@ -4225,7 +4344,10 @@ function renderStockChart(chart, x, y, w, h) {
       minVal = Math.min(minVal, v);
     }
   }
-  if (maxVal === minVal) return "";
+  if (maxVal === minVal) {
+    debug("chart.stock", "max equals min value");
+    return "";
+  }
   parts.push(
     `<line x1="${round3(x)}" y1="${round3(y + h)}" x2="${round3(x + w)}" y2="${round3(y + h)}" stroke="#D9D9D9" stroke-width="1"/>`
   );
@@ -4261,10 +4383,16 @@ function renderStockChart(chart, x, y, w, h) {
 function renderSurfaceChart(chart, x, y, w, h) {
   const parts = [];
   const { series, categories } = chart;
-  if (series.length === 0) return "";
+  if (series.length === 0) {
+    debug("chart.surface", "series is empty");
+    return "";
+  }
   const rows = series.length;
   const cols = categories.length || Math.max(...series.map((s) => s.values.length));
-  if (cols === 0) return "";
+  if (cols === 0) {
+    debug("chart.surface", "column count is 0");
+    return "";
+  }
   let minVal = Infinity;
   let maxVal = -Infinity;
   for (const s of series) {
@@ -4337,9 +4465,15 @@ function heatmapColor(t) {
 function renderOfPieChart(chart, x, y, w, h) {
   const parts = [];
   const series = chart.series[0];
-  if (!series || series.values.length === 0) return "";
+  if (!series || series.values.length === 0) {
+    debug("chart.ofPie", "series is empty or has no values");
+    return "";
+  }
   const total = series.values.reduce((sum, v) => sum + v, 0);
-  if (total === 0) return "";
+  if (total === 0) {
+    debug("chart.ofPie", "total value is 0");
+    return "";
+  }
   const splitPos = chart.splitPos ?? 2;
   const secondPieSize = chart.secondPieSize ?? 75;
   const isBarOfPie = chart.ofPieType === "bar";
@@ -4704,65 +4838,6 @@ async function svgToPng(svgString, options) {
   return { png: result.data, width: result.info.width, height: result.info.height };
 }
 
-// src/warning-logger.ts
-var PREFIX = "[pptx-glimpse]";
-var currentLevel = "off";
-var entries = [];
-var featureCounts = /* @__PURE__ */ new Map();
-function initWarningLogger(level) {
-  currentLevel = level;
-  entries = [];
-  featureCounts.clear();
-}
-function warn(feature, message, context) {
-  if (currentLevel === "off") return;
-  entries.push({ feature, message, ...context !== void 0 && { context } });
-  const existing = featureCounts.get(feature);
-  if (existing) {
-    existing.count++;
-  } else {
-    featureCounts.set(feature, { message, count: 1 });
-  }
-  if (currentLevel === "debug") {
-    const ctx = context ? ` (${context})` : "";
-    console.warn(`${PREFIX} SKIP: ${feature} - ${message}${ctx}`);
-  }
-}
-function debug(feature, message, context) {
-  if (currentLevel !== "debug") return;
-  entries.push({ feature, message, ...context !== void 0 && { context } });
-  const existing = featureCounts.get(feature);
-  if (existing) {
-    existing.count++;
-  } else {
-    featureCounts.set(feature, { message, count: 1 });
-  }
-  const ctx = context ? ` (${context})` : "";
-  console.warn(`${PREFIX} DEBUG: ${feature} - ${message}${ctx}`);
-}
-function getWarningSummary() {
-  const features = [];
-  for (const [feature, { message, count }] of featureCounts) {
-    features.push({ feature, message, count });
-  }
-  return { totalCount: entries.length, features };
-}
-function flushWarnings() {
-  const summary = getWarningSummary();
-  if (currentLevel !== "off" && summary.features.length > 0) {
-    console.warn(`${PREFIX} Summary: ${summary.features.length} unsupported feature(s) detected`);
-    for (const { feature, count } of summary.features) {
-      console.warn(`  - ${feature}: ${count} occurrence(s)`);
-    }
-  }
-  entries = [];
-  featureCounts.clear();
-  return summary;
-}
-function getWarningEntries() {
-  return entries;
-}
-
 // src/parser/pptx-reader.ts
 import { unzipSync, strFromU8 } from "fflate";
 function readPptx(input) {
@@ -6140,10 +6215,16 @@ function parseCustomGeometry(custGeom) {
   for (const path of paths) {
     const w = Number(path["@_w"] ?? 0);
     const h = Number(path["@_h"] ?? 0);
-    if (w === 0 && h === 0) continue;
+    if (w === 0 && h === 0) {
+      debug("custGeom.path", "path skipped: width and height are both 0");
+      continue;
+    }
     const vars = evaluateGuides(avGd, gdGd, w, h);
     const commands = buildPathCommands(path, vars);
-    if (!commands) continue;
+    if (!commands) {
+      debug("custGeom.path", "path skipped: failed to build path commands");
+      continue;
+    }
     result.push({ width: w, height: h, commands });
   }
   return result.length > 0 ? result : null;
@@ -6716,7 +6797,10 @@ function parseImage(pic, rels, slidePath, archive, colorResolver) {
   if (!rel) return null;
   const mediaPath = resolveRelationshipTarget(slidePath, rel.target);
   const mediaData = archive.media.get(mediaPath);
-  if (!mediaData) return null;
+  if (!mediaData) {
+    debug("picture.media", `media file not found: ${mediaPath}`);
+    return null;
+  }
   const ext = mediaPath.split(".").pop()?.toLowerCase() ?? "png";
   const mimeMap = {
     png: "image/png",
@@ -6915,9 +6999,15 @@ function parseSmartArt(graphicData, transform, rels, slidePath, archive, colorRe
       }
     }
   }
-  if (!drawingPath) return null;
+  if (!drawingPath) {
+    debug("smartArt.drawing", "diagramDrawing relationship not found");
+    return null;
+  }
   const drawingXml = archive.files.get(drawingPath);
-  if (!drawingXml) return null;
+  if (!drawingXml) {
+    debug("smartArt.drawing", `drawing XML not found in archive: ${drawingPath}`);
+    return null;
+  }
   const parsed = parseXml(drawingXml);
   const drawing = parsed.drawing;
   const spTree = drawing?.spTree;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pptx-glimpse",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "A Node.js library to render PPTX as SVG / PNG.",
   "type": "module",
   "main": "./dist/index.cjs",