pptx-viewer-mcp 2.1.7 → 2.3.0

package/dist/schemas/index.mjs

@@ -61,6 +61,32 @@ var ConvertToMarkdownSchema = z.object({
 var AccessibilityCheckSchema = z.object({
   filePath: z.string().describe("Path to the PPTX file")
 });
+var ThemeColorRefSchema = z.object({
+  scheme: z.enum([
+    "dk1",
+    "lt1",
+    "dk2",
+    "lt2",
+    "accent1",
+    "accent2",
+    "accent3",
+    "accent4",
+    "accent5",
+    "accent6",
+    "hlink",
+    "folHlink",
+    "bg1",
+    "tx1",
+    "bg2",
+    "tx2",
+    "phClr"
+  ]),
+  lumMod: z.number().optional().describe("Multiply HSL luminance (0..1)"),
+  lumOff: z.number().optional().describe("Add to HSL luminance after lumMod (0..1)"),
+  tint: z.number().optional().describe("Blend towards white (0..1)"),
+  shade: z.number().optional().describe("Blend towards black (0..1)"),
+  alpha: z.number().optional().describe("Opacity fraction, 1 = opaque")
+});
 var AddElementSchema = z.object({
   filePath: z.string().describe("Path to the PPTX file"),
   slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
@@ -105,6 +131,12 @@ var UpdateElementSchema = z.object({
   fontSize: z.number().optional(),
   fontFamily: z.string().optional(),
   fontColor: z.string().optional(),
+  /**
+   * A theme colour for the run text. Wins on save; resolves `fontColor`
+   * immediately when `fontColor` was not also given. Passing `fontColor`
+   * alone clears a previously-set text theme colour.
+   */
+  fontThemeColor: ThemeColorRefSchema.optional(),
   bold: z.boolean().optional(),
   italic: z.boolean().optional(),
   underline: z.boolean().optional(),
@@ -177,6 +209,32 @@ var BatchUpdateElementsSchema = z.object({
   opacity: z.number().min(0).max(1).optional(),
   hidden: z.boolean().optional()
 });
+var ThemeColorRefSchema2 = z.object({
+  scheme: z.enum([
+    "dk1",
+    "lt1",
+    "dk2",
+    "lt2",
+    "accent1",
+    "accent2",
+    "accent3",
+    "accent4",
+    "accent5",
+    "accent6",
+    "hlink",
+    "folHlink",
+    "bg1",
+    "tx1",
+    "bg2",
+    "tx2",
+    "phClr"
+  ]),
+  lumMod: z.number().optional().describe("Multiply HSL luminance (0..1)"),
+  lumOff: z.number().optional().describe("Add to HSL luminance after lumMod (0..1)"),
+  tint: z.number().optional().describe("Blend towards white (0..1)"),
+  shade: z.number().optional().describe("Blend towards black (0..1)"),
+  alpha: z.number().optional().describe("Opacity fraction, 1 = opaque")
+});
 var UpdateTableCellsSchema = z.object({
   filePath: z.string().describe("Path to the PPTX file"),
   slideIndex: z.number().int().min(0),
@@ -203,6 +261,14 @@ var UpdateElementStyleSchema = z.object({
   slideIndex: z.number().int().min(0),
   elementId: z.string(),
   fillColor: z.string().optional(),
+  /**
+   * A theme colour for the fill (e.g. `{ scheme: 'accent1', lumMod: 0.8 }`
+   * for "Accent 1, Lighter 80%"). When set, the shape saves as
+   * `<a:schemeClr>` and keeps following the theme after a later theme
+   * change, instead of freezing today's resolved hex. Setting `fillColor`
+   * without this clears any previously-set fill theme colour.
+   */
+  fillThemeColor: ThemeColorRefSchema2.optional(),
   fillMode: z.string().optional(),
   fillGradientStops: z.array(
     z.object({
@@ -215,6 +281,8 @@ var UpdateElementStyleSchema = z.object({
   fillGradientType: z.string().optional(),
   fillOpacity: z.number().optional(),
   strokeColor: z.string().optional(),
+  /** A theme colour for the outline; see `fillThemeColor` above. */
+  strokeThemeColor: ThemeColorRefSchema2.optional(),
   strokeWidth: z.number().optional(),
   strokeDash: z.string().optional(),
   strokeOpacity: z.number().optional(),
@@ -261,6 +329,116 @@ var ManageCommentsSchema = z.object({
   resolved: z.boolean().optional(),
   includeResolved: z.boolean().optional()
 });
+var TABLE_STYLE_SECTIONS = [
+  "wholeTbl",
+  "band1H",
+  "band2H",
+  "band1V",
+  "band2V",
+  "lastCol",
+  "firstCol",
+  "lastRow",
+  "seCell",
+  "swCell",
+  "firstRow",
+  "neCell",
+  "nwCell"
+];
+var TableStyleSimpleColorSchema = z.object({
+  schemeColor: z.string().describe('Theme colour key (e.g. "accent1"), or "" for a non-scheme fill'),
+  tint: z.number().optional().describe("0-100000"),
+  shade: z.number().optional().describe("0-100000"),
+  color: z.string().optional().describe('Explicit hex colour, e.g. "#FF8800"')
+});
+var TableStyleFillSchema = z.object({
+  schemeColor: z.string(),
+  tint: z.number().optional(),
+  shade: z.number().optional(),
+  color: z.string().optional(),
+  noFill: z.boolean().optional(),
+  gradient: z.object({
+    type: z.enum(["linear", "radial"]),
+    angle: z.number().optional(),
+    stops: z.array(z.object({ position: z.number(), fill: TableStyleSimpleColorSchema }))
+  }).optional(),
+  pattern: z.object({
+    preset: z.string(),
+    foreground: TableStyleSimpleColorSchema.optional(),
+    background: TableStyleSimpleColorSchema.optional()
+  }).optional(),
+  image: z.object({ path: z.string().optional(), data: z.string().optional() }).optional()
+});
+var TableStyleTextSchema = z.object({
+  bold: z.boolean().optional(),
+  italic: z.boolean().optional(),
+  underline: z.boolean().optional(),
+  fontSchemeColor: z.string().optional(),
+  fontTint: z.number().optional(),
+  fontShade: z.number().optional(),
+  fontColor: z.string().optional(),
+  fontFace: z.string().optional(),
+  fontRefIdx: z.string().optional()
+});
+var TableStyleBorderSideSchema = z.object({
+  width: z.number().optional(),
+  dash: z.string().optional(),
+  fill: TableStyleSimpleColorSchema.optional(),
+  color: z.string().optional(),
+  noFill: z.boolean().optional()
+});
+var TableStyleBordersSchema = z.object({
+  left: TableStyleBorderSideSchema.optional(),
+  right: TableStyleBorderSideSchema.optional(),
+  top: TableStyleBorderSideSchema.optional(),
+  bottom: TableStyleBorderSideSchema.optional(),
+  insideH: TableStyleBorderSideSchema.optional(),
+  insideV: TableStyleBorderSideSchema.optional(),
+  tl2br: TableStyleBorderSideSchema.optional(),
+  tr2bl: TableStyleBorderSideSchema.optional()
+});
+var TableStyleCell3DSchema = z.object({
+  bevelWidth: z.number().optional(),
+  bevelHeight: z.number().optional(),
+  bevelPreset: z.string().optional(),
+  material: z.string().optional(),
+  lightRig: z.string().optional(),
+  lightRigDirection: z.string().optional()
+});
+var SetTableStyleSectionSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  styleId: z.string().describe('Table style GUID, e.g. "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}"'),
+  section: z.enum(TABLE_STYLE_SECTIONS).describe("Which of the 13 CT_TableStyle parts to patch"),
+  styleName: z.string().optional().describe("Rename the style"),
+  fill: TableStyleFillSchema.optional(),
+  text: TableStyleTextSchema.optional(),
+  borders: TableStyleBordersSchema.optional(),
+  cell3D: TableStyleCell3DSchema.optional()
+});
+var CreateTableStyleSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  styleName: z.string().describe("Display name for the new style"),
+  basedOnStyleId: z.string().optional().describe("Deep-clone every section from this existing style GUID as the starting point"),
+  setAsDefault: z.boolean().optional().describe("Repoint ppt/tableStyles.xml's default style at the new one")
+});
+var DeleteTableStyleSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  styleId: z.string().describe("Table style GUID to remove"),
+  force: z.boolean().optional().describe("Delete even though a table on this deck still references the style")
+});
+var AssignTableStyleSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementId: z.string().describe("Table element ID"),
+  styleId: z.string().optional().describe(
+    "Table style GUID to assign. Defaults to the presentation's current default table style when omitted."
+  ),
+  bandedRows: z.boolean().optional(),
+  bandedColumns: z.boolean().optional(),
+  firstRowHeader: z.boolean().optional(),
+  lastRow: z.boolean().optional(),
+  firstCol: z.boolean().optional(),
+  lastCol: z.boolean().optional()
+});
 var GetThemeInfoSchema = z.object({
   filePath: z.string().describe("Path to the PPTX file")
 });
@@ -290,6 +468,139 @@ var UpdateThemeFontsSchema = z.object({
   majorFont: z.string().optional().describe("Heading (major) font family"),
   minorFont: z.string().optional().describe("Body (minor) font family")
 });
+var MarkerSymbolSchema = z.enum([
+  "circle",
+  "dash",
+  "diamond",
+  "dot",
+  "none",
+  "picture",
+  "plus",
+  "square",
+  "star",
+  "triangle",
+  "x",
+  "auto"
+]);
+var DataLabelPositionSchema = z.enum([
+  "bestFit",
+  "b",
+  "ctr",
+  "inBase",
+  "inEnd",
+  "l",
+  "outEnd",
+  "r",
+  "t"
+]);
+var FormatChartDataPointSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID"),
+  seriesIndex: z.number().int().min(0).describe("Zero-based series index"),
+  pointIndex: z.number().int().min(0).describe("Zero-based data point (category) index"),
+  fillColor: z.string().optional().describe("Fill colour (hex) for this point only"),
+  strokeColor: z.string().optional().describe("Outline colour (hex) for this point only"),
+  strokeWidth: z.number().optional().describe("Outline width in points"),
+  strokeDashStyle: z.string().optional().describe("Outline dash style, e.g. solid, dash, dashDot, sysDot"),
+  clearStyle: z.boolean().optional().describe("Remove all per-point shape formatting"),
+  explosion: z.number().nullable().optional().describe("Pie/doughnut slice pull-out distance 0-100; null clears it"),
+  marker: z.object({
+    symbol: MarkerSymbolSchema.optional(),
+    size: z.number().optional(),
+    fillColor: z.string().optional()
+  }).nullable().optional().describe("Per-point marker override (line/scatter/bubble); null clears it")
+});
+var FormatChartDataLabelSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID"),
+  seriesIndex: z.number().int().min(0).describe("Zero-based series index"),
+  pointIndex: z.number().int().min(0).describe("Zero-based data point (category) index"),
+  remove: z.boolean().optional().describe("Remove the per-point label override entirely"),
+  showValue: z.boolean().optional(),
+  showCategory: z.boolean().optional(),
+  showSeriesName: z.boolean().optional(),
+  showPercent: z.boolean().optional(),
+  showLegendKey: z.boolean().optional(),
+  position: DataLabelPositionSchema.optional(),
+  text: z.string().optional().describe("Custom label text override; '' clears it"),
+  spPr: z.object({
+    fillColor: z.string().optional(),
+    strokeColor: z.string().optional(),
+    strokeWidth: z.number().optional(),
+    strokeDashStyle: z.string().optional()
+  }).nullable().optional().describe("This label's own fill/line formatting; null removes it"),
+  txPr: z.object({
+    fontFamily: z.string().optional(),
+    fontSize: z.number().optional(),
+    bold: z.boolean().optional(),
+    italic: z.boolean().optional(),
+    color: z.string().optional()
+  }).nullable().optional().describe("This label's own font; null removes it")
+});
+var FormatChartSeriesSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID"),
+  seriesIndex: z.number().int().min(0).describe("Zero-based series index"),
+  marker: z.object({
+    symbol: MarkerSymbolSchema.optional(),
+    size: z.number().optional(),
+    fillColor: z.string().optional(),
+    strokeColor: z.string().optional(),
+    strokeWidth: z.number().optional(),
+    strokeDashStyle: z.string().optional()
+  }).nullable().optional().describe("Series marker (line/scatter/bubble/radar); null removes it"),
+  trendline: z.object({
+    trendlineType: z.enum([
+      "linear",
+      "exponential",
+      "logarithmic",
+      "polynomial",
+      "power",
+      "movingAvg"
+    ]),
+    color: z.string().optional(),
+    lineWidth: z.number().optional().describe("Trendline width in points"),
+    lineDashStyle: z.string().optional(),
+    order: z.number().optional().describe("Polynomial order, 2-6"),
+    period: z.number().optional().describe("Moving-average period"),
+    displayEq: z.boolean().optional(),
+    displayRSq: z.boolean().optional()
+  }).nullable().optional().describe("Series trendline; null removes it"),
+  errorBars: z.object({
+    direction: z.enum(["x", "y"]),
+    barType: z.enum(["both", "minus", "plus"]),
+    valType: z.enum(["cust", "fixedVal", "percentage", "stdDev", "stdErr"]),
+    val: z.number().optional(),
+    customPlus: z.array(z.number()).optional(),
+    customMinus: z.array(z.number()).optional(),
+    noEndCap: z.boolean().optional(),
+    color: z.string().optional(),
+    width: z.number().optional().describe("Error-bar line width in points"),
+    dashStyle: z.string().optional()
+  }).nullable().optional().describe("Series error bars; null removes them")
+});
+var SetChartHelperLineSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID"),
+  line: z.enum(["dropLines", "hiLowLines"]).describe("Which helper line to set"),
+  style: z.object({
+    color: z.string().optional(),
+    width: z.number().optional(),
+    dashStyle: z.string().optional()
+  }).nullable().describe("Line colour/width/dash; {} shows the line with defaults, null removes it")
+});
+var SetChartColorMapOverrideSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID"),
+  overrides: z.record(z.string(), z.string()).nullable().describe(
+    'Theme colour role remap (bg1/tx1/bg2/tx2/accent1-6/hlink/folHlink -> role), e.g. { "accent1": "accent2" }; null removes the override'
+  )
+});
 var UpdateChartSchema = z.object({
   filePath: z.string().describe("Path to the PPTX file"),
   slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
@@ -369,6 +680,50 @@ var CreateChartSchema = z.object({
     position: z.string().optional()
   }).optional().describe("Legend configuration")
 });
+var PointSchema = z.object({ x: z.number(), y: z.number() });
+var ExtentSchema = z.object({ cx: z.number(), cy: z.number() });
+var ChartUserShapeInputSchema = z.object({
+  kind: z.enum(["sp", "cxnSp"]).optional().describe('Overlay shape kind: "sp" (text/preset shape, default) or "cxnSp" (connector).'),
+  anchor: z.enum(["rel", "abs"]).optional().describe(
+    'Anchor kind: "rel" (default, resizes with the chart; needs `to`) or "abs" (fixed EMU size; needs `ext`).'
+  ),
+  from: PointSchema.describe("Top-left corner as chart-relative fractions (0-1 each)."),
+  to: PointSchema.optional().describe(
+    "Bottom-right corner as chart-relative fractions; rel anchors only."
+  ),
+  ext: ExtentSchema.optional().describe("Width/height in EMU; abs anchors only."),
+  prst: z.string().optional().describe('Preset geometry name (e.g. "rect", "roundRect"); default "rect".'),
+  fill: z.string().optional().describe('Solid fill colour, hex (e.g. "#FFFF00").'),
+  stroke: z.string().optional().describe("Line colour, hex."),
+  strokeWidth: z.number().optional().describe("Line width in points."),
+  text: z.string().optional().describe("Plain text content, centred in the shape.")
+});
+var ListChartUserShapesSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID")
+});
+var AddChartUserShapeSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID"),
+  shape: ChartUserShapeInputSchema.describe("The overlay shape to add.")
+});
+var UpdateChartUserShapeSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID"),
+  index: z.number().int().min(0).describe("Zero-based overlay-shape index (from chart_user_shape_list)"),
+  patch: ChartUserShapeInputSchema.partial().describe(
+    "Fields to overwrite; anything omitted is left as-is."
+  )
+});
+var RemoveChartUserShapeSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("Chart element ID"),
+  index: z.number().int().min(0).describe("Zero-based overlay-shape index to remove")
+});
 var ManageSmartArtSchema = z.object({
   filePath: z.string().describe("Path to the PPTX file"),
   slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
@@ -509,4 +864,4 @@ var ApplyLayoutSchema = z.object({
   layoutType: z.string().optional().describe("Layout type to apply (alternative to name)")
 });
 
-export { AccessibilityCheckSchema, AddChartSeriesSchema, AddElementSchema, AddSlideSchema, ApplyLayoutSchema, ApplyTemplateSchema, ApplyThemePresetSchema, ArrangeElementsSchema, BatchUpdateElementsSchema, CloneElementSchema, ConvertToMarkdownSchema, CreateChartSchema, DeleteElementsSchema, DeleteSlidesSchema, DuplicateSlideSchema, ExportSlideSvgSchema, ExportToJsonSchema, ExportToSvgSchema, FindPlaceholdersSchema, FindTextSchema, GetLayoutsSchema, GetMetadataSchema, GetPresentationPropertiesSchema, GetSlideSchema, GetThemeInfoSchema, GroupElementsSchema, ImportFromJsonSchema, ManageCommentsSchema, ManageHyperlinksSchema, ManageSectionsSchema, ManageSmartArtSchema, ManageTableStructureSchema, RemoveChartSeriesSchema, RenameElementSchema, ReorderSlidesSchema, RepairPresentationSchema, ReplaceGeometrySchema, ReplaceTextSchema, SetCanvasSizeSchema, SetElementAnimationSchema, SetElementLockSchema, SetSlideTransitionSchema, UngroupElementsSchema, UpdateChartSchema, UpdateChartSeriesDataSchema, UpdateElementSchema, UpdateElementStyleSchema, UpdateMetadataSchema, UpdatePresentationPropertiesSchema, UpdateSlidePropertiesSchema, UpdateTableCellsSchema, UpdateThemeColorsSchema, UpdateThemeFontsSchema, ValidatePresentationSchema };
+export { AccessibilityCheckSchema, AddChartSeriesSchema, AddChartUserShapeSchema, AddElementSchema, AddSlideSchema, ApplyLayoutSchema, ApplyTemplateSchema, ApplyThemePresetSchema, ArrangeElementsSchema, AssignTableStyleSchema, BatchUpdateElementsSchema, CloneElementSchema, ConvertToMarkdownSchema, CreateChartSchema, CreateTableStyleSchema, DeleteElementsSchema, DeleteSlidesSchema, DeleteTableStyleSchema, DuplicateSlideSchema, ExportSlideSvgSchema, ExportToJsonSchema, ExportToSvgSchema, FindPlaceholdersSchema, FindTextSchema, FormatChartDataLabelSchema, FormatChartDataPointSchema, FormatChartSeriesSchema, GetLayoutsSchema, GetMetadataSchema, GetPresentationPropertiesSchema, GetSlideSchema, GetThemeInfoSchema, GroupElementsSchema, ImportFromJsonSchema, ListChartUserShapesSchema, ManageCommentsSchema, ManageHyperlinksSchema, ManageSectionsSchema, ManageSmartArtSchema, ManageTableStructureSchema, RemoveChartSeriesSchema, RemoveChartUserShapeSchema, RenameElementSchema, ReorderSlidesSchema, RepairPresentationSchema, ReplaceGeometrySchema, ReplaceTextSchema, SetCanvasSizeSchema, SetChartColorMapOverrideSchema, SetChartHelperLineSchema, SetElementAnimationSchema, SetElementLockSchema, SetSlideTransitionSchema, SetTableStyleSectionSchema, TABLE_STYLE_SECTIONS, TableStyleBordersSchema, TableStyleCell3DSchema, TableStyleFillSchema, TableStyleTextSchema, UngroupElementsSchema, UpdateChartSchema, UpdateChartSeriesDataSchema, UpdateChartUserShapeSchema, UpdateElementSchema, UpdateElementStyleSchema, UpdateMetadataSchema, UpdatePresentationPropertiesSchema, UpdateSlidePropertiesSchema, UpdateTableCellsSchema, UpdateThemeColorsSchema, UpdateThemeFontsSchema, ValidatePresentationSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-viewer-mcp",
-	"version": "2.1.7",
+	"version": "2.3.0",
 	"description": "PowerPoint PPTX tools and MCP server: manipulate, convert, and collaborate on .pptx files from AI agents.",
 	"keywords": [
 		"ai",
@@ -72,7 +72,7 @@
 		"@modelcontextprotocol/sdk": "^1.30.0",
 		"fast-xml-parser": "^5.11.0",
 		"jszip": "^3.10.1",
-		"pptx-viewer-core": "^3.0.2",
+		"pptx-viewer-core": "^3.5.0",
 		"zod": "^4.4.3"
 	},
 	"devDependencies": {