pptx-viewer-mcp 2.1.7 → 2.3.0

package/dist/index.js

@@ -22,11 +22,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 pptxViewerCore.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);
@@ -58,7 +64,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;
@@ -581,8 +593,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 = pptxViewerCore.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;
@@ -1073,6 +1094,142 @@ function manageTableStructure(ctx, params) {
     }
   };
 }
+function findTableElement(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 !== "table") {
+    throw new Error(`Element '${elementId}' is not a table.`);
+  }
+  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(pptxViewerCore.normalizeTableStyleGuid(el.tableData.tableStyleId));
+      }
+    }
+  }
+  return used;
+}
+function setTableStyleSection(ctx, params) {
+  if (!pptxViewerCore.TABLE_STYLE_PART_SEQUENCE.includes(params.section)) {
+    throw new Error(
+      `Unknown table style section '${params.section}'. Valid sections: ${pptxViewerCore.TABLE_STYLE_PART_SEQUENCE.join(", ")}.`
+    );
+  }
+  const map = ctx.pptxData.tableStyleMap ?? {};
+  ctx.pptxData.tableStyleMap = map;
+  const normalizedId = pptxViewerCore.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: { styleId: normalizedId, section: params.section }
+  };
+}
+function createTableStyle(ctx, params) {
+  const map = ctx.pptxData.tableStyleMap ?? {};
+  ctx.pptxData.tableStyleMap = map;
+  const basedOn = params.basedOnStyleId ? map[pptxViewerCore.normalizeTableStyleGuid(params.basedOnStyleId)] : void 0;
+  if (params.basedOnStyleId && !basedOn) {
+    throw new Error(`basedOnStyleId '${params.basedOnStyleId}' is not a loaded table style.`);
+  }
+  const entry = pptxViewerCore.createTableStyleEntry(map, { styleName: params.styleName, basedOn });
+  pptxViewerCore.addTableStyleToMap(map, entry);
+  return {
+    pptxData: ctx.pptxData,
+    dirty: true,
+    result: { styleId: entry.styleId },
+    ...params.setAsDefault ? { saveOptions: { tableStylesDefaultId: entry.styleId } } : {}
+  };
+}
+function deleteTableStyle(ctx, params) {
+  const normalizedId = pptxViewerCore.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;
+  pptxViewerCore.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 = pptxViewerCore.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 }
+  };
+}
 function updateElementStyle(ctx, params) {
   const err = validateSlideIndex(params.slideIndex, ctx.pptxData.slides.length);
   if (err) {
@@ -1088,8 +1245,17 @@ function updateElementStyle(ctx, params) {
       el.shapeStyle = {};
     }
     const ss = el.shapeStyle;
-    if (params.fillColor !== void 0) {
+    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;
@@ -1106,8 +1272,17 @@ function updateElementStyle(ctx, params) {
     if (params.fillOpacity !== void 0) {
       ss.fillOpacity = params.fillOpacity;
     }
-    if (params.strokeColor !== void 0) {
+    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;
@@ -1848,6 +2023,159 @@ function createChart(ctx, params) {
     result: { elementId: chart.id, slideIndex: params.slideIndex }
   };
 }
+function findChartElement(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 formatChartDataPoint(ctx, params) {
+  const chart = findChartElement(ctx, params.slideIndex, params.elementId);
+  if (params.clearStyle) {
+    pptxViewerCore.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) {
+    pptxViewerCore.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) {
+    pptxViewerCore.setChartDataPointExplosion(chart, params.seriesIndex, params.pointIndex, params.explosion);
+  }
+  if (params.marker !== void 0) {
+    pptxViewerCore.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) {
+    pptxViewerCore.setChartDataPointLabel(chart, params.seriesIndex, params.pointIndex, null);
+    return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+  }
+  pptxViewerCore.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) {
+      pptxViewerCore.setChartSeriesMarker(chart, params.seriesIndex, null);
+    } else if (params.marker.strokeColor !== void 0 || params.marker.strokeWidth !== void 0 || params.marker.strokeDashStyle !== void 0) {
+      pptxViewerCore.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 {
+      pptxViewerCore.setChartSeriesMarker(chart, params.seriesIndex, params.marker);
+    }
+  }
+  if (params.trendline !== void 0) {
+    pptxViewerCore.setChartSeriesTrendline(chart, params.seriesIndex, params.trendline);
+  }
+  if (params.errorBars !== void 0) {
+    pptxViewerCore.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);
+  pptxViewerCore.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);
+  pptxViewerCore.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",
+    anchor: input.anchor ?? "rel",
+    from: input.from,
+    ...input.to ? { to: input.to } : {},
+    ...input.ext ? { ext: input.ext } : {},
+    ...input.prst ? { prst: input.prst } : {},
+    ...input.fill ? { fill: input.fill } : {},
+    ...input.stroke ? { stroke: input.stroke } : {},
+    ...input.strokeWidth !== void 0 ? { strokeWidth: input.strokeWidth } : {},
+    ...input.text ? { paragraphs: [{ text: input.text, align: "ctr" }] } : {}
+  };
+}
+function listChartUserShapesT(ctx, params) {
+  const chart = findChartElement2(ctx, params.slideIndex, params.elementId);
+  return { pptxData: ctx.pptxData, dirty: false, result: { shapes: pptxViewerCore.listChartUserShapes(chart) } };
+}
+function addChartUserShapeT(ctx, params) {
+  const chart = findChartElement2(ctx, params.slideIndex, params.elementId);
+  pptxViewerCore.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 = findChartElement2(ctx, params.slideIndex, params.elementId);
+  const patch = {
+    ...params.patch.kind ? { kind: params.patch.kind } : {},
+    ...params.patch.anchor ? { anchor: params.patch.anchor } : {},
+    ...params.patch.from ? { from: params.patch.from } : {},
+    ...params.patch.to ? { to: params.patch.to } : {},
+    ...params.patch.ext ? { ext: params.patch.ext } : {},
+    ...params.patch.prst ? { prst: params.patch.prst } : {},
+    ...params.patch.fill ? { fill: params.patch.fill } : {},
+    ...params.patch.stroke ? { stroke: params.patch.stroke } : {},
+    ...params.patch.strokeWidth !== void 0 ? { strokeWidth: params.patch.strokeWidth } : {},
+    ...params.patch.text !== void 0 ? { paragraphs: [{ text: params.patch.text, align: "ctr" }] } : {}
+  };
+  pptxViewerCore.updateChartUserShape(chart, params.index, patch);
+  return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+}
+function removeChartUserShapeT(ctx, params) {
+  const chart = findChartElement2(ctx, params.slideIndex, params.elementId);
+  pptxViewerCore.removeChartUserShape(chart, params.index);
+  return { pptxData: ctx.pptxData, dirty: true, result: { elementId: params.elementId } };
+}
 function extractNodes(data) {
   if (!data.nodes) {
     return [];
@@ -2593,18 +2921,22 @@ Object.defineProperty(exports, "PptxHandler", {
   get: function () { return pptxViewerCore.PptxHandler; }
 });
 exports.addChartSeriesT = addChartSeriesT;
+exports.addChartUserShapeT = addChartUserShapeT;
 exports.addElement = addElement;
 exports.addSlide = addSlide;
 exports.applyLayout = applyLayout;
 exports.applyTemplateT = applyTemplateT;
 exports.applyThemePreset = applyThemePreset;
 exports.arrangeElements = arrangeElements;
+exports.assignTableStyle = assignTableStyle;
 exports.batchUpdateElements = batchUpdateElements;
 exports.cloneElement = cloneElement;
 exports.convertToMarkdown = convertToMarkdown;
 exports.createChart = createChart;
+exports.createTableStyle = createTableStyle;
 exports.deleteElements = deleteElements;
 exports.deleteSlides = deleteSlides;
+exports.deleteTableStyle = deleteTableStyle;
 exports.describeElement = describeElement;
 exports.diffPresentationsT = diffPresentationsT;
 exports.duplicateSlide = duplicateSlide;
@@ -2615,6 +2947,9 @@ exports.exportToSvg = exportToSvg;
 exports.extractSlideText = extractSlideText;
 exports.findPlaceholdersT = findPlaceholdersT;
 exports.findText = findText;
+exports.formatChartDataLabel = formatChartDataLabel;
+exports.formatChartDataPoint = formatChartDataPoint;
+exports.formatChartSeries = formatChartSeries;
 exports.generateElementId = generateElementId;
 exports.generateSlideId = generateSlideId;
 exports.getLayouts = getLayouts;
@@ -2624,6 +2959,7 @@ exports.getSlide = getSlide;
 exports.getThemeInfo = getThemeInfo;
 exports.groupElements = groupElements;
 exports.importFromJson = importFromJson;
+exports.listChartUserShapesT = listChartUserShapesT;
 exports.loadPresentation = loadPresentation;
 exports.manageComments = manageComments;
 exports.manageHyperlinks = manageHyperlinks;
@@ -2632,6 +2968,7 @@ exports.manageSmartArt = manageSmartArt;
 exports.manageTableStructure = manageTableStructure;
 exports.mergePresentationT = mergePresentationT;
 exports.removeChartSeriesT = removeChartSeriesT;
+exports.removeChartUserShapeT = removeChartUserShapeT;
 exports.renameElement = renameElement;
 exports.reorderSlides = reorderSlides;
 exports.repairPresentation = repairPresentation;
@@ -2640,12 +2977,16 @@ exports.replaceText = replaceText;
 exports.runAccessibilityCheck = runAccessibilityCheck;
 exports.savePresentation = savePresentation;
 exports.setCanvasSize = setCanvasSize;
+exports.setChartColorMapOverrideT = setChartColorMapOverrideT;
+exports.setChartHelperLineT = setChartHelperLineT;
 exports.setElementAnimation = setElementAnimation;
 exports.setElementLockT = setElementLockT;
 exports.setSlideTransition = setSlideTransition;
+exports.setTableStyleSection = setTableStyleSection;
 exports.ungroupElements = ungroupElements;
 exports.updateChart = updateChart;
 exports.updateChartSeriesData = updateChartSeriesData;
+exports.updateChartUserShapeT = updateChartUserShapeT;
 exports.updateElement = updateElement;
 exports.updateElementStyle = updateElementStyle;
 exports.updateMetadata = updateMetadata;