pptx-viewer-mcp 2.2.0 → 2.4.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { PptxHandler, hasTextProperties, cloneElement as cloneElement$1, isTemplateElementId, makeStoreAwareId, reassignDescendantIds, groupElements as groupElements$1, ungroupElements as ungroupElements$1, PptxMarkdownConverter, ThemePresets, getThemePreset, setChartType, setChartTitle, setChartGrouping, setChartLegend, setChartDataLabels, setChartAxis, setChartCategories, addChartSeries, removeChartSeries, updateChartSeriesValues, ChartBuilder, listChartUserShapes, addChartUserShape, updateChartUserShape, removeChartUserShape, decomposeSmartArt, demoteSmartArtNode, promoteSmartArtNode, reorderSmartArtNode, updateSmartArtNodeText, removeSmartArtNode, addSmartArtNode, mergePresentation, diffPresentations, findPlaceholders, applyTemplate, getSectionForSlide, moveSlidesToSection, reorderSections, removeSection, addSection, SvgExporter, buildPptxJsonDocument, deserializePptxFromJson, applyImportedPptxData, replaceWithCustomGeometry, replaceShapeGeometry, setElementLocked, validatePptx, repairPptx, findLayoutByName, findLayoutByType } from 'pptx-viewer-core';
+import { PptxHandler, hasTextProperties, resolveThemeColorRef, cloneElement as cloneElement$1, isTemplateElementId, makeStoreAwareId, reassignDescendantIds, groupElements as groupElements$1, ungroupElements as ungroupElements$1, TABLE_STYLE_PART_SEQUENCE, normalizeTableStyleGuid, createTableStyleEntry, addTableStyleToMap, deleteTableStyleFromMap, PptxMarkdownConverter, ThemePresets, getThemePreset, setChartType, setChartTitle, setChartGrouping, setChartLegend, setChartDataLabels, setChartAxis, setChartCategories, addChartSeries, removeChartSeries, updateChartSeriesValues, ChartBuilder, setChartDataPointStyle, setChartDataPointExplosion, setChartDataPointMarker, setChartDataPointLabel, setChartSeriesMarker, setChartSeriesTrendline, setChartSeriesErrorBars, setChartHelperLine, setChartColorMapOverride, listChartUserShapes, addChartUserShape, updateChartUserShape, removeChartUserShape, decomposeSmartArt, demoteSmartArtNode, promoteSmartArtNode, reorderSmartArtNode, updateSmartArtNodeText, removeSmartArtNode, addSmartArtNode, mergePresentation, diffPresentations, findPlaceholders, applyTemplate, getSectionForSlide, moveSlidesToSection, reorderSections, removeSection, addSection, SvgExporter, buildPptxJsonDocument, deserializePptxFromJson, applyImportedPptxData, replaceWithCustomGeometry, replaceShapeGeometry, setElementLocked, validatePptx, repairPptx, findLayoutByName, findLayoutByType } from 'pptx-viewer-core';
 export { PptxHandler } from 'pptx-viewer-core';
 
 // src/execution.ts
@@ -21,11 +21,17 @@ async function loadPresentation(filePath, execCtx) {
   const pptxData = await handler.load(rawBytes.buffer);
   return { pptxData, rawBytes };
 }
-async function savePresentation(filePath, pptxData, rawBytes, execCtx) {
+async function savePresentation(filePath, pptxData, rawBytes, execCtx, tableStyleSaveOptions) {
   const handler = new PptxHandler();
   await handler.load(rawBytes.buffer);
   const outputBytes = await handler.save(pptxData.slides, {
-    headerFooter: pptxData.headerFooter
+    headerFooter: pptxData.headerFooter,
+    // `pptxData.tableStyleMap` carries any in-memory table-style edits a
+    // tool made (e.g. `set_table_style_section`, `create_table_style`);
+    // without forwarding it here those edits were silently dropped on
+    // save even though the core save pipeline already supports them.
+    tableStyles: pptxData.tableStyleMap,
+    ...tableStyleSaveOptions
   });
   if (execCtx.collaboration) {
     const room = execCtx.collaboration.getRoom(filePath);
@@ -57,7 +63,13 @@ async function executeToolWithContext(filePath, execCtx, toolFn) {
   const { pptxData, rawBytes } = await loadPresentation(filePath, execCtx);
   const toolResult = await toolFn({ pptxData });
   if (toolResult.dirty) {
-    const saveResult = await savePresentation(filePath, toolResult.pptxData, rawBytes, execCtx);
+    const saveResult = await savePresentation(
+      filePath,
+      toolResult.pptxData,
+      rawBytes,
+      execCtx,
+      toolResult.saveOptions
+    );
     return { ...toolResult.result, ...saveResult };
   }
   return toolResult.result;
@@ -382,6 +394,240 @@ function setCanvasSize(ctx, params) {
     result: { canvasWidth: params.width, canvasHeight: params.height }
   };
 }
+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 = 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 = 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 (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) {
@@ -561,6 +807,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 (hasTextProperties(el)) {
     const textEl = el;
     if (params.text !== void 0) {
@@ -580,8 +832,17 @@ function updateElement(ctx, params) {
     if (params.fontFamily !== void 0) {
       textEl.textStyle.fontFamily = params.fontFamily;
     }
-    if (params.fontColor !== void 0) {
+    if (params.fontThemeColor !== void 0) {
+      textEl.textStyle.colorRef = params.fontThemeColor;
+      const resolved = resolveThemeColorRef(params.fontThemeColor, ctx.pptxData.themeColorMap);
+      if (params.fontColor !== void 0) {
+        textEl.textStyle.color = params.fontColor;
+      } else if (resolved) {
+        textEl.textStyle.color = resolved;
+      }
+    } else if (params.fontColor !== void 0) {
       textEl.textStyle.color = params.fontColor;
+      textEl.textStyle.colorRef = void 0;
     }
     if (params.bold !== void 0) {
       textEl.textStyle.bold = params.bold;
@@ -1072,188 +1333,140 @@ function manageTableStructure(ctx, params) {
     }
   };
 }
-function updateElementStyle(ctx, params) {
-  const err = validateSlideIndex(params.slideIndex, ctx.pptxData.slides.length);
+function findTableElement(ctx, slideIndex, elementId) {
+  const err = validateSlideIndex(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);
+  const slide = ctx.pptxData.slides[slideIndex];
+  const el = slide.elements.find((e) => e.id === elementId);
   if (!el) {
-    throw new Error(`Element '${params.elementId}' not found on slide ${params.slideIndex}.`);
+    throw new Error(`Element '${elementId}' not found on slide ${slideIndex}.`);
   }
-  if ("shapeStyle" in el) {
-    if (!el.shapeStyle) {
-      el.shapeStyle = {};
-    }
-    const ss = el.shapeStyle;
-    if (params.fillColor !== void 0) {
-      ss.fillColor = params.fillColor;
-    }
-    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.strokeColor !== void 0) {
-      ss.strokeColor = params.strokeColor;
-    }
-    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 !== "table") {
+    throw new Error(`Element '${elementId}' is not a table.`);
   }
-  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 el;
+}
+function tableStyleIdsInUse(ctx) {
+  const used = /* @__PURE__ */ new Set();
+  for (const slide of ctx.pptxData.slides) {
+    for (const el of slide.elements) {
+      if (el.type === "table" && el.tableData?.tableStyleId) {
+        used.add(normalizeTableStyleGuid(el.tableData.tableStyleId));
       }
     }
   }
+  return used;
+}
+function setTableStyleSection(ctx, params) {
+  if (!TABLE_STYLE_PART_SEQUENCE.includes(params.section)) {
+    throw new Error(
+      `Unknown table style section '${params.section}'. Valid sections: ${TABLE_STYLE_PART_SEQUENCE.join(", ")}.`
+    );
+  }
+  const map = ctx.pptxData.tableStyleMap ?? {};
+  ctx.pptxData.tableStyleMap = map;
+  const normalizedId = normalizeTableStyleGuid(params.styleId);
+  const entry = map[normalizedId];
+  if (!entry) {
+    throw new Error(
+      `Table style '${params.styleId}' is not loaded in this presentation. Use create_table_style to add a new one.`
+    );
+  }
+  if (params.styleName !== void 0) {
+    entry.styleName = params.styleName;
+  }
+  const mutableEntry = entry;
+  if (params.fill !== void 0) {
+    mutableEntry[`${params.section}Fill`] = params.fill;
+  }
+  if (params.text !== void 0) {
+    mutableEntry[`${params.section}Text`] = params.text;
+  }
+  if (params.borders !== void 0) {
+    mutableEntry[`${params.section}Borders`] = params.borders;
+  }
+  if (params.cell3D !== void 0) {
+    mutableEntry[`${params.section}Cell3D`] = params.cell3D;
+  }
   return {
     pptxData: ctx.pptxData,
     dirty: true,
-    result: { elementId: params.elementId }
+    result: { styleId: normalizedId, section: params.section }
   };
 }
-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 (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.`
-      });
-    }
+function createTableStyle(ctx, params) {
+  const map = ctx.pptxData.tableStyleMap ?? {};
+  ctx.pptxData.tableStyleMap = map;
+  const basedOn = params.basedOnStyleId ? map[normalizeTableStyleGuid(params.basedOnStyleId)] : void 0;
+  if (params.basedOnStyleId && !basedOn) {
+    throw new Error(`basedOnStyleId '${params.basedOnStyleId}' is not a loaded table style.`);
   }
-  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;
+  const entry = createTableStyleEntry(map, { styleName: params.styleName, basedOn });
+  addTableStyleToMap(map, entry);
   return {
     pptxData: ctx.pptxData,
-    dirty: false,
-    result: {
-      slideCount: ctx.pptxData.slides.length,
-      totalIssues: issues.length,
-      errorCount,
-      warningCount,
-      infoCount,
-      issues
+    dirty: true,
+    result: { styleId: entry.styleId },
+    ...params.setAsDefault ? { saveOptions: { tableStylesDefaultId: entry.styleId } } : {}
+  };
+}
+function deleteTableStyle(ctx, params) {
+  const normalizedId = normalizeTableStyleGuid(params.styleId);
+  if (!params.force) {
+    const used = tableStyleIdsInUse(ctx);
+    if (used.has(normalizedId)) {
+      throw new Error(
+        `Table style '${params.styleId}' is assigned to at least one table on this deck. Reassign those tables first, or pass force: true.`
+      );
     }
+  }
+  const map = ctx.pptxData.tableStyleMap ?? {};
+  ctx.pptxData.tableStyleMap = map;
+  deleteTableStyleFromMap(map, normalizedId);
+  return {
+    pptxData: ctx.pptxData,
+    dirty: true,
+    result: { deleted: true },
+    saveOptions: { tableStylesToDelete: [normalizedId] }
+  };
+}
+function assignTableStyle(ctx, params) {
+  const el = findTableElement(ctx, params.slideIndex, params.elementId);
+  if (!el.tableData) {
+    throw new Error(`Table '${params.elementId}' has no tableData.`);
+  }
+  const styleId = params.styleId ?? ctx.pptxData.tableStylesDefaultId;
+  if (!styleId) {
+    throw new Error(
+      "styleId was not provided and this presentation has no tableStylesDefaultId to fall back to."
+    );
+  }
+  const normalizedId = normalizeTableStyleGuid(styleId);
+  el.tableData.tableStyleId = normalizedId;
+  if (params.bandedRows !== void 0) {
+    el.tableData.bandedRows = params.bandedRows;
+  }
+  if (params.bandedColumns !== void 0) {
+    el.tableData.bandedColumns = params.bandedColumns;
+  }
+  if (params.firstRowHeader !== void 0) {
+    el.tableData.firstRowHeader = params.firstRowHeader;
+  }
+  if (params.lastRow !== void 0) {
+    el.tableData.lastRow = params.lastRow;
+  }
+  if (params.firstCol !== void 0) {
+    el.tableData.firstCol = params.firstCol;
+  }
+  if (params.lastCol !== void 0) {
+    el.tableData.lastCol = params.lastCol;
+  }
+  return {
+    pptxData: ctx.pptxData,
+    dirty: true,
+    result: { elementId: params.elementId, styleId: normalizedId }
   };
 }
 var MAX_REGEX_LEN = 200;
@@ -1862,6 +2075,98 @@ function findChartElement(ctx, slideIndex, elementId) {
   }
   return el;
 }
+function formatChartDataPoint(ctx, params) {
+  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  if (params.clearStyle) {
+    setChartDataPointStyle(chart, params.seriesIndex, params.pointIndex, null);
+  } else if (params.fillColor !== void 0 || params.strokeColor !== void 0 || params.strokeWidth !== void 0 || params.strokeDashStyle !== void 0) {
+    setChartDataPointStyle(chart, params.seriesIndex, params.pointIndex, {
+      ...params.fillColor !== void 0 ? { fillColor: params.fillColor } : {},
+      ...params.strokeColor !== void 0 ? { strokeColor: params.strokeColor } : {},
+      ...params.strokeWidth !== void 0 ? { strokeWidth: params.strokeWidth } : {},
+      ...params.strokeDashStyle !== void 0 ? { strokeDashStyle: params.strokeDashStyle } : {}
+    });
+  }
+  if (params.explosion !== void 0) {
+    setChartDataPointExplosion(chart, params.seriesIndex, params.pointIndex, params.explosion);
+  }
+  if (params.marker !== void 0) {
+    setChartDataPointMarker(chart, params.seriesIndex, params.pointIndex, params.marker);
+  }
+  return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+}
+function formatChartDataLabel(ctx, params) {
+  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  if (params.remove) {
+    setChartDataPointLabel(chart, params.seriesIndex, params.pointIndex, null);
+    return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+  }
+  setChartDataPointLabel(chart, params.seriesIndex, params.pointIndex, {
+    ...params.showValue !== void 0 ? { showValue: params.showValue } : {},
+    ...params.showCategory !== void 0 ? { showCategory: params.showCategory } : {},
+    ...params.showSeriesName !== void 0 ? { showSeriesName: params.showSeriesName } : {},
+    ...params.showPercent !== void 0 ? { showPercent: params.showPercent } : {},
+    ...params.showLegendKey !== void 0 ? { showLegendKey: params.showLegendKey } : {},
+    ...params.position !== void 0 ? { position: params.position } : {},
+    ...params.text !== void 0 ? { text: params.text } : {},
+    ...params.spPr !== void 0 ? { spPr: params.spPr } : {},
+    ...params.txPr !== void 0 ? { txPr: params.txPr } : {}
+  });
+  return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+}
+function formatChartSeries(ctx, params) {
+  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  if (params.marker !== void 0) {
+    if (params.marker === null) {
+      setChartSeriesMarker(chart, params.seriesIndex, null);
+    } else if (params.marker.strokeColor !== void 0 || params.marker.strokeWidth !== void 0 || params.marker.strokeDashStyle !== void 0) {
+      setChartSeriesMarker(chart, params.seriesIndex, {
+        symbol: params.marker.symbol ?? "circle",
+        ...params.marker.size !== void 0 ? { size: params.marker.size } : {},
+        spPr: {
+          ...params.marker.fillColor !== void 0 ? { fillColor: params.marker.fillColor } : {},
+          ...params.marker.strokeColor !== void 0 ? { strokeColor: params.marker.strokeColor } : {},
+          ...params.marker.strokeWidth !== void 0 ? { strokeWidth: params.marker.strokeWidth } : {},
+          ...params.marker.strokeDashStyle !== void 0 ? { strokeDashStyle: params.marker.strokeDashStyle } : {}
+        }
+      });
+    } else {
+      setChartSeriesMarker(chart, params.seriesIndex, params.marker);
+    }
+  }
+  if (params.trendline !== void 0) {
+    setChartSeriesTrendline(chart, params.seriesIndex, params.trendline);
+  }
+  if (params.errorBars !== void 0) {
+    setChartSeriesErrorBars(chart, params.seriesIndex, params.errorBars);
+  }
+  return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+}
+function setChartHelperLineT(ctx, params) {
+  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  setChartHelperLine(chart, params.line, params.style);
+  return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+}
+function setChartColorMapOverrideT(ctx, params) {
+  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  setChartColorMapOverride(chart, params.overrides);
+  return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+}
+function findChartElement2(ctx, slideIndex, elementId) {
+  const err = validateSlideIndex(slideIndex, ctx.pptxData.slides.length);
+  if (err) {
+    throw new Error(err);
+  }
+  const slide = ctx.pptxData.slides[slideIndex];
+  const el = slide.elements.find((e) => e.id === elementId);
+  if (!el) {
+    throw new Error(`Element '${elementId}' not found on slide ${slideIndex}.`);
+  }
+  if (el.type !== "chart") {
+    throw new Error(`Element '${elementId}' is not a chart.`);
+  }
+  return el;
+}
 function buildShape(input) {
   return {
     kind: input.kind ?? "sp",
@@ -1877,17 +2182,17 @@ function buildShape(input) {
   };
 }
 function listChartUserShapesT(ctx, params) {
-  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  const chart = findChartElement2(ctx, params.slideIndex, params.elementId);
   return { pptxData: ctx.pptxData, dirty: false, result: { shapes: listChartUserShapes(chart) } };
 }
 function addChartUserShapeT(ctx, params) {
-  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  const chart = findChartElement2(ctx, params.slideIndex, params.elementId);
   addChartUserShape(chart, buildShape(params.shape));
   const index = (chart.chartData?.userShapes?.length ?? 1) - 1;
   return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId, index } };
 }
 function updateChartUserShapeT(ctx, params) {
-  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  const chart = findChartElement2(ctx, params.slideIndex, params.elementId);
   const patch = {
     ...params.patch.kind ? { kind: params.patch.kind } : {},
     ...params.patch.anchor ? { anchor: params.patch.anchor } : {},
@@ -1904,7 +2209,7 @@ function updateChartUserShapeT(ctx, params) {
   return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
 }
 function removeChartUserShapeT(ctx, params) {
-  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  const chart = findChartElement2(ctx, params.slideIndex, params.elementId);
   removeChartUserShape(chart, params.index);
   return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
 }
@@ -2648,4 +2953,4 @@ function applyLayout(ctx, params) {
   };
 }
 
-export { addChartSeriesT, addChartUserShapeT, addElement, addSlide, applyLayout, applyTemplateT, applyThemePreset, arrangeElements, batchUpdateElements, cloneElement, convertToMarkdown, createChart, deleteElements, deleteSlides, describeElement, diffPresentationsT, duplicateSlide, executeToolWithContext, exportSlideSvg, exportToJson, exportToSvg, extractSlideText, findPlaceholdersT, findText, generateElementId, generateSlideId, getLayouts, getMetadata, getPresentationProperties, getSlide, getThemeInfo, groupElements, importFromJson, listChartUserShapesT, loadPresentation, manageComments, manageHyperlinks, manageSections, manageSmartArt, manageTableStructure, mergePresentationT, removeChartSeriesT, removeChartUserShapeT, renameElement, reorderSlides, repairPresentation, replaceGeometry, replaceText, runAccessibilityCheck, savePresentation, setCanvasSize, setElementAnimation, setElementLockT, setSlideTransition, ungroupElements, updateChart, updateChartSeriesData, updateChartUserShapeT, updateElement, updateElementStyle, updateMetadata, updatePresentationProperties, updateSlideProperties, updateTableCells, updateThemeColors, updateThemeFonts, validatePresentation, validateSlideIndex };
+export { addChartSeriesT, addChartUserShapeT, addElement, addSlide, applyLayout, applyTemplateT, applyThemePreset, arrangeElements, assignTableStyle, batchUpdateElements, cloneElement, convertToMarkdown, createChart, createTableStyle, deleteElements, deleteSlides, deleteTableStyle, describeElement, diffPresentationsT, duplicateSlide, executeToolWithContext, exportSlideSvg, exportToJson, exportToSvg, extractSlideText, findPlaceholdersT, findText, formatChartDataLabel, formatChartDataPoint, formatChartSeries, generateElementId, generateSlideId, getLayouts, getMetadata, getPresentationProperties, getSlide, getThemeInfo, groupElements, importFromJson, listChartUserShapesT, loadPresentation, manageComments, manageHyperlinks, manageSections, manageSmartArt, manageTableStructure, mergePresentationT, removeChartSeriesT, removeChartUserShapeT, renameElement, reorderSlides, repairPresentation, replaceGeometry, replaceText, runAccessibilityCheck, savePresentation, setCanvasSize, setChartColorMapOverrideT, setChartHelperLineT, setElementAnimation, setElementLockT, setSlideTransition, setTableStyleSection, ungroupElements, updateChart, updateChartSeriesData, updateChartUserShapeT, updateElement, updateElementStyle, updateMetadata, updatePresentationProperties, updateSlideProperties, updateTableCells, updateThemeColors, updateThemeFonts, validatePresentation, validateSlideIndex };