pptx-viewer-mcp 2.3.0 → 2.4.0

package/dist/mcp/index.js

@@ -154,7 +154,13 @@ var UpdateElementSchema = zod.z.object({
   opacity: zod.z.number().min(0).max(1).optional(),
   hidden: zod.z.boolean().optional(),
   flipH: zod.z.boolean().optional(),
-  flipV: zod.z.boolean().optional()
+  flipV: zod.z.boolean().optional(),
+  altText: zod.z.string().optional().describe(
+    "Accessibility description (p:cNvPr/@descr) for image, picture, table, chart, smartArt, ole, media, text, shape and connector elements"
+  ),
+  title: zod.z.string().optional().describe(
+    "Accessibility title (p:cNvPr/@title) for table, chart, smartArt, ole, media, text, shape and connector elements (not pictures)"
+  )
 });
 var RenameElementSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file"),
@@ -309,7 +315,12 @@ var UpdateElementStyleSchema = zod.z.object({
   brightness: zod.z.number().optional(),
   contrast: zod.z.number().optional(),
   grayscale: zod.z.boolean().optional(),
-  altText: zod.z.string().optional()
+  altText: zod.z.string().optional().describe(
+    "Accessibility description (p:cNvPr/@descr) for image, picture, table, chart, smartArt, ole, media, text, shape and connector elements"
+  ),
+  title: zod.z.string().optional().describe(
+    "Accessibility title (p:cNvPr/@title) for table, chart, smartArt, ole, media, text, shape and connector elements (not pictures)"
+  )
 });
 var FindTextSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file"),
@@ -1631,6 +1642,240 @@ async function convertToMarkdown(ctx, params) {
     }
   };
 }
+var ALT_TEXT_ELEMENT_TYPES = /* @__PURE__ */ new Set(["image", "picture", "table", "chart", "smartArt", "ole", "media", "text", "shape", "connector"]);
+var TITLE_ELEMENT_TYPES = /* @__PURE__ */ new Set([
+  "table",
+  "chart",
+  "smartArt",
+  "ole",
+  "media",
+  "text",
+  "shape",
+  "connector"
+]);
+function applyElementAltText(el, altText) {
+  if (!ALT_TEXT_ELEMENT_TYPES.has(el.type)) {
+    throw new Error(
+      `Element '${el.id}' (${el.type}) does not support altText; only ${[...ALT_TEXT_ELEMENT_TYPES].join(", ")} elements do.`
+    );
+  }
+  el.altText = altText;
+}
+function applyElementTitle(el, title) {
+  if (!TITLE_ELEMENT_TYPES.has(el.type)) {
+    throw new Error(
+      `Element '${el.id}' (${el.type}) does not support title; only ${[...TITLE_ELEMENT_TYPES].join(", ")} elements do.`
+    );
+  }
+  el.title = title;
+}
+function updateElementStyle(ctx, params) {
+  const err = validateSlideIndex(params.slideIndex, ctx.pptxData.slides.length);
+  if (err) {
+    throw new Error(err);
+  }
+  const slide = ctx.pptxData.slides[params.slideIndex];
+  const el = slide.elements.find((e) => e.id === params.elementId);
+  if (!el) {
+    throw new Error(`Element '${params.elementId}' not found on slide ${params.slideIndex}.`);
+  }
+  if ("shapeStyle" in el) {
+    if (!el.shapeStyle) {
+      el.shapeStyle = {};
+    }
+    const ss = el.shapeStyle;
+    if (params.fillThemeColor !== void 0) {
+      ss.fillColorRef = params.fillThemeColor;
+      const resolved = pptxViewerCore.resolveThemeColorRef(params.fillThemeColor, ctx.pptxData.themeColorMap);
+      if (params.fillColor !== void 0) {
+        ss.fillColor = params.fillColor;
+      } else if (resolved) {
+        ss.fillColor = resolved;
+      }
+    } else if (params.fillColor !== void 0) {
+      ss.fillColor = params.fillColor;
+      ss.fillColorRef = void 0;
+    }
+    if (params.fillMode !== void 0) {
+      ss.fillMode = params.fillMode;
+    }
+    if (params.fillGradientStops !== void 0) {
+      ss.fillGradientStops = params.fillGradientStops;
+    }
+    if (params.fillGradientAngle !== void 0) {
+      ss.fillGradientAngle = params.fillGradientAngle;
+    }
+    if (params.fillGradientType !== void 0) {
+      ss.fillGradientType = params.fillGradientType;
+    }
+    if (params.fillOpacity !== void 0) {
+      ss.fillOpacity = params.fillOpacity;
+    }
+    if (params.strokeThemeColor !== void 0) {
+      ss.strokeColorRef = params.strokeThemeColor;
+      const resolved = pptxViewerCore.resolveThemeColorRef(params.strokeThemeColor, ctx.pptxData.themeColorMap);
+      if (params.strokeColor !== void 0) {
+        ss.strokeColor = params.strokeColor;
+      } else if (resolved) {
+        ss.strokeColor = resolved;
+      }
+    } else if (params.strokeColor !== void 0) {
+      ss.strokeColor = params.strokeColor;
+      ss.strokeColorRef = void 0;
+    }
+    if (params.strokeWidth !== void 0) {
+      ss.strokeWidth = params.strokeWidth;
+    }
+    if (params.strokeDash !== void 0) {
+      ss.strokeDash = params.strokeDash;
+    }
+    if (params.strokeOpacity !== void 0) {
+      ss.strokeOpacity = params.strokeOpacity;
+    }
+    if (params.shadowColor !== void 0) {
+      ss.shadowColor = params.shadowColor;
+    }
+    if (params.shadowBlur !== void 0) {
+      ss.shadowBlur = params.shadowBlur;
+    }
+    if (params.shadowOffsetX !== void 0) {
+      ss.shadowOffsetX = params.shadowOffsetX;
+    }
+    if (params.shadowOffsetY !== void 0) {
+      ss.shadowOffsetY = params.shadowOffsetY;
+    }
+    if (params.shadowOpacity !== void 0) {
+      ss.shadowOpacity = params.shadowOpacity;
+    }
+    if (params.glowColor !== void 0) {
+      ss.glowColor = params.glowColor;
+    }
+    if (params.glowRadius !== void 0) {
+      ss.glowRadius = params.glowRadius;
+    }
+    if (params.glowOpacity !== void 0) {
+      ss.glowOpacity = params.glowOpacity;
+    }
+    if (params.softEdgeRadius !== void 0) {
+      ss.softEdgeRadius = params.softEdgeRadius;
+    }
+  }
+  if (params.altText !== void 0) {
+    applyElementAltText(el, params.altText);
+  }
+  if (params.title !== void 0) {
+    applyElementTitle(el, params.title);
+  }
+  if (el.type === "image" || el.type === "picture") {
+    const img = el;
+    if (params.cropLeft !== void 0) {
+      img.cropLeft = params.cropLeft;
+    }
+    if (params.cropTop !== void 0) {
+      img.cropTop = params.cropTop;
+    }
+    if (params.cropRight !== void 0) {
+      img.cropRight = params.cropRight;
+    }
+    if (params.cropBottom !== void 0) {
+      img.cropBottom = params.cropBottom;
+    }
+    if (params.brightness !== void 0 || params.contrast !== void 0 || params.grayscale !== void 0) {
+      if (!img.imageEffects) {
+        img.imageEffects = {};
+      }
+      if (params.brightness !== void 0) {
+        img.imageEffects.brightness = params.brightness;
+      }
+      if (params.contrast !== void 0) {
+        img.imageEffects.contrast = params.contrast;
+      }
+      if (params.grayscale !== void 0) {
+        img.imageEffects.grayscale = params.grayscale;
+      }
+    }
+  }
+  return {
+    pptxData: ctx.pptxData,
+    dirty: true,
+    result: { elementId: params.elementId }
+  };
+}
+function runAccessibilityCheck(ctx) {
+  const issues = [];
+  for (let si = 0; si < ctx.pptxData.slides.length; si++) {
+    const slide = ctx.pptxData.slides[si];
+    let slideHasText = false;
+    for (const el of slide.elements) {
+      if (el.type === "image" || el.type === "picture") {
+        const img = el;
+        if (!img.altText) {
+          issues.push({
+            slideIndex: si,
+            elementId: el.id,
+            severity: "error",
+            message: `Image element '${el.id}' has no alt text.`
+          });
+        }
+      }
+      if (pptxViewerCore.hasTextProperties(el)) {
+        const textEl = el;
+        slideHasText = true;
+        if (!textEl.text || textEl.text.trim() === "") {
+          issues.push({
+            slideIndex: si,
+            elementId: el.id,
+            severity: "info",
+            message: `Text element '${el.id}' is empty.`
+          });
+        }
+        const fs = textEl.textStyle?.fontSize;
+        if (fs !== void 0 && fs < 10) {
+          issues.push({
+            slideIndex: si,
+            elementId: el.id,
+            severity: "warning",
+            message: `Text element '${el.id}' has very small font size (${fs}pt < 10pt).`
+          });
+        }
+        const textColor = textEl.textStyle?.color?.toLowerCase();
+        const bgColor = slide.backgroundColor?.toLowerCase();
+        if (textColor && bgColor && textColor === bgColor) {
+          issues.push({
+            slideIndex: si,
+            elementId: el.id,
+            severity: "error",
+            message: `Text element '${el.id}' has same color as slide background (${textColor}).`
+          });
+        }
+      }
+    }
+    if (!slideHasText) {
+      issues.push({
+        slideIndex: si,
+        severity: "warning",
+        message: `Slide ${si + 1} contains no text elements.`
+      });
+    }
+  }
+  const errorCount = issues.filter((i) => i.severity === "error").length;
+  const warningCount = issues.filter((i) => i.severity === "warning").length;
+  const infoCount = issues.filter((i) => i.severity === "info").length;
+  return {
+    pptxData: ctx.pptxData,
+    dirty: false,
+    result: {
+      slideCount: ctx.pptxData.slides.length,
+      totalIssues: issues.length,
+      errorCount,
+      warningCount,
+      infoCount,
+      issues
+    }
+  };
+}
+
+// src/tools/element-tools.ts
 function addElement(ctx, params) {
   const err = validateSlideIndex(params.slideIndex, ctx.pptxData.slides.length);
   if (err) {
@@ -1810,6 +2055,12 @@ function updateElement(ctx, params) {
   if (params.flipV !== void 0) {
     el.flipVertical = params.flipV;
   }
+  if (params.altText !== void 0) {
+    applyElementAltText(el, params.altText);
+  }
+  if (params.title !== void 0) {
+    applyElementTitle(el, params.title);
+  }
   if (pptxViewerCore.hasTextProperties(el)) {
     const textEl = el;
     if (params.text !== void 0) {
@@ -3064,208 +3315,6 @@ function manageSmartArt(ctx, params) {
       throw new Error(`Unknown SmartArt action: ${String(params.action)}`);
   }
 }
-function updateElementStyle(ctx, params) {
-  const err = validateSlideIndex(params.slideIndex, ctx.pptxData.slides.length);
-  if (err) {
-    throw new Error(err);
-  }
-  const slide = ctx.pptxData.slides[params.slideIndex];
-  const el = slide.elements.find((e) => e.id === params.elementId);
-  if (!el) {
-    throw new Error(`Element '${params.elementId}' not found on slide ${params.slideIndex}.`);
-  }
-  if ("shapeStyle" in el) {
-    if (!el.shapeStyle) {
-      el.shapeStyle = {};
-    }
-    const ss = el.shapeStyle;
-    if (params.fillThemeColor !== void 0) {
-      ss.fillColorRef = params.fillThemeColor;
-      const resolved = pptxViewerCore.resolveThemeColorRef(params.fillThemeColor, ctx.pptxData.themeColorMap);
-      if (params.fillColor !== void 0) {
-        ss.fillColor = params.fillColor;
-      } else if (resolved) {
-        ss.fillColor = resolved;
-      }
-    } else if (params.fillColor !== void 0) {
-      ss.fillColor = params.fillColor;
-      ss.fillColorRef = void 0;
-    }
-    if (params.fillMode !== void 0) {
-      ss.fillMode = params.fillMode;
-    }
-    if (params.fillGradientStops !== void 0) {
-      ss.fillGradientStops = params.fillGradientStops;
-    }
-    if (params.fillGradientAngle !== void 0) {
-      ss.fillGradientAngle = params.fillGradientAngle;
-    }
-    if (params.fillGradientType !== void 0) {
-      ss.fillGradientType = params.fillGradientType;
-    }
-    if (params.fillOpacity !== void 0) {
-      ss.fillOpacity = params.fillOpacity;
-    }
-    if (params.strokeThemeColor !== void 0) {
-      ss.strokeColorRef = params.strokeThemeColor;
-      const resolved = pptxViewerCore.resolveThemeColorRef(params.strokeThemeColor, ctx.pptxData.themeColorMap);
-      if (params.strokeColor !== void 0) {
-        ss.strokeColor = params.strokeColor;
-      } else if (resolved) {
-        ss.strokeColor = resolved;
-      }
-    } else if (params.strokeColor !== void 0) {
-      ss.strokeColor = params.strokeColor;
-      ss.strokeColorRef = void 0;
-    }
-    if (params.strokeWidth !== void 0) {
-      ss.strokeWidth = params.strokeWidth;
-    }
-    if (params.strokeDash !== void 0) {
-      ss.strokeDash = params.strokeDash;
-    }
-    if (params.strokeOpacity !== void 0) {
-      ss.strokeOpacity = params.strokeOpacity;
-    }
-    if (params.shadowColor !== void 0) {
-      ss.shadowColor = params.shadowColor;
-    }
-    if (params.shadowBlur !== void 0) {
-      ss.shadowBlur = params.shadowBlur;
-    }
-    if (params.shadowOffsetX !== void 0) {
-      ss.shadowOffsetX = params.shadowOffsetX;
-    }
-    if (params.shadowOffsetY !== void 0) {
-      ss.shadowOffsetY = params.shadowOffsetY;
-    }
-    if (params.shadowOpacity !== void 0) {
-      ss.shadowOpacity = params.shadowOpacity;
-    }
-    if (params.glowColor !== void 0) {
-      ss.glowColor = params.glowColor;
-    }
-    if (params.glowRadius !== void 0) {
-      ss.glowRadius = params.glowRadius;
-    }
-    if (params.glowOpacity !== void 0) {
-      ss.glowOpacity = params.glowOpacity;
-    }
-    if (params.softEdgeRadius !== void 0) {
-      ss.softEdgeRadius = params.softEdgeRadius;
-    }
-  }
-  if (el.type === "image" || el.type === "picture") {
-    const img = el;
-    if (params.altText !== void 0) {
-      img.altText = params.altText;
-    }
-    if (params.cropLeft !== void 0) {
-      img.cropLeft = params.cropLeft;
-    }
-    if (params.cropTop !== void 0) {
-      img.cropTop = params.cropTop;
-    }
-    if (params.cropRight !== void 0) {
-      img.cropRight = params.cropRight;
-    }
-    if (params.cropBottom !== void 0) {
-      img.cropBottom = params.cropBottom;
-    }
-    if (params.brightness !== void 0 || params.contrast !== void 0 || params.grayscale !== void 0) {
-      if (!img.imageEffects) {
-        img.imageEffects = {};
-      }
-      if (params.brightness !== void 0) {
-        img.imageEffects.brightness = params.brightness;
-      }
-      if (params.contrast !== void 0) {
-        img.imageEffects.contrast = params.contrast;
-      }
-      if (params.grayscale !== void 0) {
-        img.imageEffects.grayscale = params.grayscale;
-      }
-    }
-  }
-  return {
-    pptxData: ctx.pptxData,
-    dirty: true,
-    result: { elementId: params.elementId }
-  };
-}
-function runAccessibilityCheck(ctx) {
-  const issues = [];
-  for (let si = 0; si < ctx.pptxData.slides.length; si++) {
-    const slide = ctx.pptxData.slides[si];
-    let slideHasText = false;
-    for (const el of slide.elements) {
-      if (el.type === "image" || el.type === "picture") {
-        const img = el;
-        if (!img.altText) {
-          issues.push({
-            slideIndex: si,
-            elementId: el.id,
-            severity: "error",
-            message: `Image element '${el.id}' has no alt text.`
-          });
-        }
-      }
-      if (pptxViewerCore.hasTextProperties(el)) {
-        const textEl = el;
-        slideHasText = true;
-        if (!textEl.text || textEl.text.trim() === "") {
-          issues.push({
-            slideIndex: si,
-            elementId: el.id,
-            severity: "info",
-            message: `Text element '${el.id}' is empty.`
-          });
-        }
-        const fs = textEl.textStyle?.fontSize;
-        if (fs !== void 0 && fs < 10) {
-          issues.push({
-            slideIndex: si,
-            elementId: el.id,
-            severity: "warning",
-            message: `Text element '${el.id}' has very small font size (${fs}pt < 10pt).`
-          });
-        }
-        const textColor = textEl.textStyle?.color?.toLowerCase();
-        const bgColor = slide.backgroundColor?.toLowerCase();
-        if (textColor && bgColor && textColor === bgColor) {
-          issues.push({
-            slideIndex: si,
-            elementId: el.id,
-            severity: "error",
-            message: `Text element '${el.id}' has same color as slide background (${textColor}).`
-          });
-        }
-      }
-    }
-    if (!slideHasText) {
-      issues.push({
-        slideIndex: si,
-        severity: "warning",
-        message: `Slide ${si + 1} contains no text elements.`
-      });
-    }
-  }
-  const errorCount = issues.filter((i) => i.severity === "error").length;
-  const warningCount = issues.filter((i) => i.severity === "warning").length;
-  const infoCount = issues.filter((i) => i.severity === "info").length;
-  return {
-    pptxData: ctx.pptxData,
-    dirty: false,
-    result: {
-      slideCount: ctx.pptxData.slides.length,
-      totalIssues: issues.length,
-      errorCount,
-      warningCount,
-      infoCount,
-      issues
-    }
-  };
-}
 function findTableElement(ctx, slideIndex, elementId) {
   const err = validateSlideIndex(slideIndex, ctx.pptxData.slides.length);
   if (err) {