pptx-viewer-mcp 2.2.0 → 2.4.0

package/dist/schemas/index.js

@@ -63,6 +63,32 @@ var ConvertToMarkdownSchema = zod.z.object({
 var AccessibilityCheckSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file")
 });
+var ThemeColorRefSchema = zod.z.object({
+  scheme: zod.z.enum([
+    "dk1",
+    "lt1",
+    "dk2",
+    "lt2",
+    "accent1",
+    "accent2",
+    "accent3",
+    "accent4",
+    "accent5",
+    "accent6",
+    "hlink",
+    "folHlink",
+    "bg1",
+    "tx1",
+    "bg2",
+    "tx2",
+    "phClr"
+  ]),
+  lumMod: zod.z.number().optional().describe("Multiply HSL luminance (0..1)"),
+  lumOff: zod.z.number().optional().describe("Add to HSL luminance after lumMod (0..1)"),
+  tint: zod.z.number().optional().describe("Blend towards white (0..1)"),
+  shade: zod.z.number().optional().describe("Blend towards black (0..1)"),
+  alpha: zod.z.number().optional().describe("Opacity fraction, 1 = opaque")
+});
 var AddElementSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file"),
   slideIndex: zod.z.number().int().min(0).describe("Zero-based slide index"),
@@ -107,6 +133,12 @@ var UpdateElementSchema = zod.z.object({
   fontSize: zod.z.number().optional(),
   fontFamily: zod.z.string().optional(),
   fontColor: zod.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: zod.z.boolean().optional(),
   italic: zod.z.boolean().optional(),
   underline: zod.z.boolean().optional(),
@@ -117,7 +149,13 @@ var UpdateElementSchema = zod.z.object({
   opacity: zod.z.number().min(0).max(1).optional(),
   hidden: zod.z.boolean().optional(),
   flipH: zod.z.boolean().optional(),
-  flipV: zod.z.boolean().optional()
+  flipV: zod.z.boolean().optional(),
+  altText: zod.z.string().optional().describe(
+    "Accessibility description (p:cNvPr/@descr) for image, picture, table, chart, smartArt, ole, media, text, shape and connector elements"
+  ),
+  title: zod.z.string().optional().describe(
+    "Accessibility title (p:cNvPr/@title) for table, chart, smartArt, ole, media, text, shape and connector elements (not pictures)"
+  )
 });
 var RenameElementSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file"),
@@ -179,6 +217,32 @@ var BatchUpdateElementsSchema = zod.z.object({
   opacity: zod.z.number().min(0).max(1).optional(),
   hidden: zod.z.boolean().optional()
 });
+var ThemeColorRefSchema2 = zod.z.object({
+  scheme: zod.z.enum([
+    "dk1",
+    "lt1",
+    "dk2",
+    "lt2",
+    "accent1",
+    "accent2",
+    "accent3",
+    "accent4",
+    "accent5",
+    "accent6",
+    "hlink",
+    "folHlink",
+    "bg1",
+    "tx1",
+    "bg2",
+    "tx2",
+    "phClr"
+  ]),
+  lumMod: zod.z.number().optional().describe("Multiply HSL luminance (0..1)"),
+  lumOff: zod.z.number().optional().describe("Add to HSL luminance after lumMod (0..1)"),
+  tint: zod.z.number().optional().describe("Blend towards white (0..1)"),
+  shade: zod.z.number().optional().describe("Blend towards black (0..1)"),
+  alpha: zod.z.number().optional().describe("Opacity fraction, 1 = opaque")
+});
 var UpdateTableCellsSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file"),
   slideIndex: zod.z.number().int().min(0),
@@ -205,6 +269,14 @@ var UpdateElementStyleSchema = zod.z.object({
   slideIndex: zod.z.number().int().min(0),
   elementId: zod.z.string(),
   fillColor: zod.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: zod.z.string().optional(),
   fillGradientStops: zod.z.array(
     zod.z.object({
@@ -217,6 +289,8 @@ var UpdateElementStyleSchema = zod.z.object({
   fillGradientType: zod.z.string().optional(),
   fillOpacity: zod.z.number().optional(),
   strokeColor: zod.z.string().optional(),
+  /** A theme colour for the outline; see `fillThemeColor` above. */
+  strokeThemeColor: ThemeColorRefSchema2.optional(),
   strokeWidth: zod.z.number().optional(),
   strokeDash: zod.z.string().optional(),
   strokeOpacity: zod.z.number().optional(),
@@ -236,7 +310,12 @@ var UpdateElementStyleSchema = zod.z.object({
   brightness: zod.z.number().optional(),
   contrast: zod.z.number().optional(),
   grayscale: zod.z.boolean().optional(),
-  altText: zod.z.string().optional()
+  altText: zod.z.string().optional().describe(
+    "Accessibility description (p:cNvPr/@descr) for image, picture, table, chart, smartArt, ole, media, text, shape and connector elements"
+  ),
+  title: zod.z.string().optional().describe(
+    "Accessibility title (p:cNvPr/@title) for table, chart, smartArt, ole, media, text, shape and connector elements (not pictures)"
+  )
 });
 var FindTextSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file"),
@@ -263,6 +342,116 @@ var ManageCommentsSchema = zod.z.object({
   resolved: zod.z.boolean().optional(),
   includeResolved: zod.z.boolean().optional()
 });
+var TABLE_STYLE_SECTIONS = [
+  "wholeTbl",
+  "band1H",
+  "band2H",
+  "band1V",
+  "band2V",
+  "lastCol",
+  "firstCol",
+  "lastRow",
+  "seCell",
+  "swCell",
+  "firstRow",
+  "neCell",
+  "nwCell"
+];
+var TableStyleSimpleColorSchema = zod.z.object({
+  schemeColor: zod.z.string().describe('Theme colour key (e.g. "accent1"), or "" for a non-scheme fill'),
+  tint: zod.z.number().optional().describe("0-100000"),
+  shade: zod.z.number().optional().describe("0-100000"),
+  color: zod.z.string().optional().describe('Explicit hex colour, e.g. "#FF8800"')
+});
+var TableStyleFillSchema = zod.z.object({
+  schemeColor: zod.z.string(),
+  tint: zod.z.number().optional(),
+  shade: zod.z.number().optional(),
+  color: zod.z.string().optional(),
+  noFill: zod.z.boolean().optional(),
+  gradient: zod.z.object({
+    type: zod.z.enum(["linear", "radial"]),
+    angle: zod.z.number().optional(),
+    stops: zod.z.array(zod.z.object({ position: zod.z.number(), fill: TableStyleSimpleColorSchema }))
+  }).optional(),
+  pattern: zod.z.object({
+    preset: zod.z.string(),
+    foreground: TableStyleSimpleColorSchema.optional(),
+    background: TableStyleSimpleColorSchema.optional()
+  }).optional(),
+  image: zod.z.object({ path: zod.z.string().optional(), data: zod.z.string().optional() }).optional()
+});
+var TableStyleTextSchema = zod.z.object({
+  bold: zod.z.boolean().optional(),
+  italic: zod.z.boolean().optional(),
+  underline: zod.z.boolean().optional(),
+  fontSchemeColor: zod.z.string().optional(),
+  fontTint: zod.z.number().optional(),
+  fontShade: zod.z.number().optional(),
+  fontColor: zod.z.string().optional(),
+  fontFace: zod.z.string().optional(),
+  fontRefIdx: zod.z.string().optional()
+});
+var TableStyleBorderSideSchema = zod.z.object({
+  width: zod.z.number().optional(),
+  dash: zod.z.string().optional(),
+  fill: TableStyleSimpleColorSchema.optional(),
+  color: zod.z.string().optional(),
+  noFill: zod.z.boolean().optional()
+});
+var TableStyleBordersSchema = zod.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 = zod.z.object({
+  bevelWidth: zod.z.number().optional(),
+  bevelHeight: zod.z.number().optional(),
+  bevelPreset: zod.z.string().optional(),
+  material: zod.z.string().optional(),
+  lightRig: zod.z.string().optional(),
+  lightRigDirection: zod.z.string().optional()
+});
+var SetTableStyleSectionSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  styleId: zod.z.string().describe('Table style GUID, e.g. "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}"'),
+  section: zod.z.enum(TABLE_STYLE_SECTIONS).describe("Which of the 13 CT_TableStyle parts to patch"),
+  styleName: zod.z.string().optional().describe("Rename the style"),
+  fill: TableStyleFillSchema.optional(),
+  text: TableStyleTextSchema.optional(),
+  borders: TableStyleBordersSchema.optional(),
+  cell3D: TableStyleCell3DSchema.optional()
+});
+var CreateTableStyleSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  styleName: zod.z.string().describe("Display name for the new style"),
+  basedOnStyleId: zod.z.string().optional().describe("Deep-clone every section from this existing style GUID as the starting point"),
+  setAsDefault: zod.z.boolean().optional().describe("Repoint ppt/tableStyles.xml's default style at the new one")
+});
+var DeleteTableStyleSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  styleId: zod.z.string().describe("Table style GUID to remove"),
+  force: zod.z.boolean().optional().describe("Delete even though a table on this deck still references the style")
+});
+var AssignTableStyleSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  slideIndex: zod.z.number().int().min(0),
+  elementId: zod.z.string().describe("Table element ID"),
+  styleId: zod.z.string().optional().describe(
+    "Table style GUID to assign. Defaults to the presentation's current default table style when omitted."
+  ),
+  bandedRows: zod.z.boolean().optional(),
+  bandedColumns: zod.z.boolean().optional(),
+  firstRowHeader: zod.z.boolean().optional(),
+  lastRow: zod.z.boolean().optional(),
+  firstCol: zod.z.boolean().optional(),
+  lastCol: zod.z.boolean().optional()
+});
 var GetThemeInfoSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file")
 });
@@ -292,6 +481,139 @@ var UpdateThemeFontsSchema = zod.z.object({
   majorFont: zod.z.string().optional().describe("Heading (major) font family"),
   minorFont: zod.z.string().optional().describe("Body (minor) font family")
 });
+var MarkerSymbolSchema = zod.z.enum([
+  "circle",
+  "dash",
+  "diamond",
+  "dot",
+  "none",
+  "picture",
+  "plus",
+  "square",
+  "star",
+  "triangle",
+  "x",
+  "auto"
+]);
+var DataLabelPositionSchema = zod.z.enum([
+  "bestFit",
+  "b",
+  "ctr",
+  "inBase",
+  "inEnd",
+  "l",
+  "outEnd",
+  "r",
+  "t"
+]);
+var FormatChartDataPointSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  slideIndex: zod.z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: zod.z.string().describe("Chart element ID"),
+  seriesIndex: zod.z.number().int().min(0).describe("Zero-based series index"),
+  pointIndex: zod.z.number().int().min(0).describe("Zero-based data point (category) index"),
+  fillColor: zod.z.string().optional().describe("Fill colour (hex) for this point only"),
+  strokeColor: zod.z.string().optional().describe("Outline colour (hex) for this point only"),
+  strokeWidth: zod.z.number().optional().describe("Outline width in points"),
+  strokeDashStyle: zod.z.string().optional().describe("Outline dash style, e.g. solid, dash, dashDot, sysDot"),
+  clearStyle: zod.z.boolean().optional().describe("Remove all per-point shape formatting"),
+  explosion: zod.z.number().nullable().optional().describe("Pie/doughnut slice pull-out distance 0-100; null clears it"),
+  marker: zod.z.object({
+    symbol: MarkerSymbolSchema.optional(),
+    size: zod.z.number().optional(),
+    fillColor: zod.z.string().optional()
+  }).nullable().optional().describe("Per-point marker override (line/scatter/bubble); null clears it")
+});
+var FormatChartDataLabelSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  slideIndex: zod.z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: zod.z.string().describe("Chart element ID"),
+  seriesIndex: zod.z.number().int().min(0).describe("Zero-based series index"),
+  pointIndex: zod.z.number().int().min(0).describe("Zero-based data point (category) index"),
+  remove: zod.z.boolean().optional().describe("Remove the per-point label override entirely"),
+  showValue: zod.z.boolean().optional(),
+  showCategory: zod.z.boolean().optional(),
+  showSeriesName: zod.z.boolean().optional(),
+  showPercent: zod.z.boolean().optional(),
+  showLegendKey: zod.z.boolean().optional(),
+  position: DataLabelPositionSchema.optional(),
+  text: zod.z.string().optional().describe("Custom label text override; '' clears it"),
+  spPr: zod.z.object({
+    fillColor: zod.z.string().optional(),
+    strokeColor: zod.z.string().optional(),
+    strokeWidth: zod.z.number().optional(),
+    strokeDashStyle: zod.z.string().optional()
+  }).nullable().optional().describe("This label's own fill/line formatting; null removes it"),
+  txPr: zod.z.object({
+    fontFamily: zod.z.string().optional(),
+    fontSize: zod.z.number().optional(),
+    bold: zod.z.boolean().optional(),
+    italic: zod.z.boolean().optional(),
+    color: zod.z.string().optional()
+  }).nullable().optional().describe("This label's own font; null removes it")
+});
+var FormatChartSeriesSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  slideIndex: zod.z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: zod.z.string().describe("Chart element ID"),
+  seriesIndex: zod.z.number().int().min(0).describe("Zero-based series index"),
+  marker: zod.z.object({
+    symbol: MarkerSymbolSchema.optional(),
+    size: zod.z.number().optional(),
+    fillColor: zod.z.string().optional(),
+    strokeColor: zod.z.string().optional(),
+    strokeWidth: zod.z.number().optional(),
+    strokeDashStyle: zod.z.string().optional()
+  }).nullable().optional().describe("Series marker (line/scatter/bubble/radar); null removes it"),
+  trendline: zod.z.object({
+    trendlineType: zod.z.enum([
+      "linear",
+      "exponential",
+      "logarithmic",
+      "polynomial",
+      "power",
+      "movingAvg"
+    ]),
+    color: zod.z.string().optional(),
+    lineWidth: zod.z.number().optional().describe("Trendline width in points"),
+    lineDashStyle: zod.z.string().optional(),
+    order: zod.z.number().optional().describe("Polynomial order, 2-6"),
+    period: zod.z.number().optional().describe("Moving-average period"),
+    displayEq: zod.z.boolean().optional(),
+    displayRSq: zod.z.boolean().optional()
+  }).nullable().optional().describe("Series trendline; null removes it"),
+  errorBars: zod.z.object({
+    direction: zod.z.enum(["x", "y"]),
+    barType: zod.z.enum(["both", "minus", "plus"]),
+    valType: zod.z.enum(["cust", "fixedVal", "percentage", "stdDev", "stdErr"]),
+    val: zod.z.number().optional(),
+    customPlus: zod.z.array(zod.z.number()).optional(),
+    customMinus: zod.z.array(zod.z.number()).optional(),
+    noEndCap: zod.z.boolean().optional(),
+    color: zod.z.string().optional(),
+    width: zod.z.number().optional().describe("Error-bar line width in points"),
+    dashStyle: zod.z.string().optional()
+  }).nullable().optional().describe("Series error bars; null removes them")
+});
+var SetChartHelperLineSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  slideIndex: zod.z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: zod.z.string().describe("Chart element ID"),
+  line: zod.z.enum(["dropLines", "hiLowLines"]).describe("Which helper line to set"),
+  style: zod.z.object({
+    color: zod.z.string().optional(),
+    width: zod.z.number().optional(),
+    dashStyle: zod.z.string().optional()
+  }).nullable().describe("Line colour/width/dash; {} shows the line with defaults, null removes it")
+});
+var SetChartColorMapOverrideSchema = zod.z.object({
+  filePath: zod.z.string().describe("Path to the PPTX file"),
+  slideIndex: zod.z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: zod.z.string().describe("Chart element ID"),
+  overrides: zod.z.record(zod.z.string(), zod.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 = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file"),
   slideIndex: zod.z.number().int().min(0).describe("Zero-based slide index"),
@@ -564,18 +886,24 @@ exports.ApplyLayoutSchema = ApplyLayoutSchema;
 exports.ApplyTemplateSchema = ApplyTemplateSchema;
 exports.ApplyThemePresetSchema = ApplyThemePresetSchema;
 exports.ArrangeElementsSchema = ArrangeElementsSchema;
+exports.AssignTableStyleSchema = AssignTableStyleSchema;
 exports.BatchUpdateElementsSchema = BatchUpdateElementsSchema;
 exports.CloneElementSchema = CloneElementSchema;
 exports.ConvertToMarkdownSchema = ConvertToMarkdownSchema;
 exports.CreateChartSchema = CreateChartSchema;
+exports.CreateTableStyleSchema = CreateTableStyleSchema;
 exports.DeleteElementsSchema = DeleteElementsSchema;
 exports.DeleteSlidesSchema = DeleteSlidesSchema;
+exports.DeleteTableStyleSchema = DeleteTableStyleSchema;
 exports.DuplicateSlideSchema = DuplicateSlideSchema;
 exports.ExportSlideSvgSchema = ExportSlideSvgSchema;
 exports.ExportToJsonSchema = ExportToJsonSchema;
 exports.ExportToSvgSchema = ExportToSvgSchema;
 exports.FindPlaceholdersSchema = FindPlaceholdersSchema;
 exports.FindTextSchema = FindTextSchema;
+exports.FormatChartDataLabelSchema = FormatChartDataLabelSchema;
+exports.FormatChartDataPointSchema = FormatChartDataPointSchema;
+exports.FormatChartSeriesSchema = FormatChartSeriesSchema;
 exports.GetLayoutsSchema = GetLayoutsSchema;
 exports.GetMetadataSchema = GetMetadataSchema;
 exports.GetPresentationPropertiesSchema = GetPresentationPropertiesSchema;
@@ -597,9 +925,17 @@ exports.RepairPresentationSchema = RepairPresentationSchema;
 exports.ReplaceGeometrySchema = ReplaceGeometrySchema;
 exports.ReplaceTextSchema = ReplaceTextSchema;
 exports.SetCanvasSizeSchema = SetCanvasSizeSchema;
+exports.SetChartColorMapOverrideSchema = SetChartColorMapOverrideSchema;
+exports.SetChartHelperLineSchema = SetChartHelperLineSchema;
 exports.SetElementAnimationSchema = SetElementAnimationSchema;
 exports.SetElementLockSchema = SetElementLockSchema;
 exports.SetSlideTransitionSchema = SetSlideTransitionSchema;
+exports.SetTableStyleSectionSchema = SetTableStyleSectionSchema;
+exports.TABLE_STYLE_SECTIONS = TABLE_STYLE_SECTIONS;
+exports.TableStyleBordersSchema = TableStyleBordersSchema;
+exports.TableStyleCell3DSchema = TableStyleCell3DSchema;
+exports.TableStyleFillSchema = TableStyleFillSchema;
+exports.TableStyleTextSchema = TableStyleTextSchema;
 exports.UngroupElementsSchema = UngroupElementsSchema;
 exports.UpdateChartSchema = UpdateChartSchema;
 exports.UpdateChartSeriesDataSchema = UpdateChartSeriesDataSchema;