pptx-viewer-mcp 2.2.0 → 2.3.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;
@@ -580,8 +592,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,6 +1093,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(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: { styleId: normalizedId, section: params.section }
+  };
+}
+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 entry = createTableStyleEntry(map, { styleName: params.styleName, basedOn });
+  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 = 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 }
+  };
+}
 function updateElementStyle(ctx, params) {
   const err = validateSlideIndex(params.slideIndex, ctx.pptxData.slides.length);
   if (err) {
@@ -1087,8 +1244,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 = 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;
@@ -1105,8 +1271,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 = 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;
@@ -1862,6 +2037,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 +2144,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 +2171,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 +2915,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 };