Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
//! The edit-operation vocabulary shared by the editor UI and AI tools.
//!
//! Slides are addressed by their stable id (`p:sldId/@id`), shapes by their
//! `p:cNvPr/@id` (unique within a slide). Positions and sizes are in points.
//! A slide master's or layout's id (from the deck outline's `masters`, at
//! least 2147483648) addresses it in place of a slide id in the operations
//! on shapes, text, tables, charts, pictures, and backgrounds, which edits
//! the master or layout and every slide based on it (Slide Master view).
//! Text positions count Unicode scalar values within a paragraph, where a line
//! break (`a:br`) counts as one character.
use serde::{Deserialize, Deserializer, Serialize};
mod geometry;
mod masters;
mod picture_format;
pub use geometry::{GeometryPath, MergeMode, PathCommand, PathFillMode};
pub use masters::PlaceholderKind;
pub use picture_format::{
CropMode, EffectSpec, GlowOptions, ReflectionOptions, ShadowOptions, SoftEdgeOptions,
};
/// Reads `null` as the default value: AI tool calls in strict mode send
/// `null` for every optional field they leave out.
fn nullable<'de, D, T>(de: D) -> Result<T, D::Error>
where
D: Deserializer<'de>,
T: Deserialize<'de> + Default,
{
Ok(Option::<T>::deserialize(de)?.unwrap_or_default())
}
mod values;
pub use values::*;
mod smartart;
pub use smartart::{SmartArtEdit, SmartArtItem, SmartArtPosition, SmartArtTarget};
/// One edit operation.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
// utoipa ignores `rename_all_fields`, so each struct variant repeats it.
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
#[serde(
rename_all = "camelCase",
rename_all_fields = "camelCase",
tag = "op",
deny_unknown_fields
)]
pub enum EditOp {
/// Replaces all text of a shape (`\n` separates paragraphs, `\u{b}` is a line
/// break), keeping the formatting of the first run of each paragraph.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetText {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Table cell whose text to edit (the shape must be a table).
#[serde(default)]
cell: Option<CellRef>,
/// New text.
text: String,
},
/// Inserts text at a position (`\n` splits paragraphs).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
InsertText {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Table cell whose text to edit (the shape must be a table).
#[serde(default)]
cell: Option<CellRef>,
/// Where to insert.
at: TextPos,
/// Text to insert.
text: String,
},
/// Deletes text between two positions (may span paragraphs).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DeleteText {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Table cell whose text to edit (the shape must be a table).
#[serde(default)]
cell: Option<CellRef>,
/// Start (inclusive).
start: TextPos,
/// End (exclusive).
end: TextPos,
},
/// Applies character formatting to a range (whole shape when omitted).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
FormatText {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Table cell whose text to edit (the shape must be a table).
#[serde(default)]
cell: Option<CellRef>,
/// Start of the range.
#[serde(default)]
start: Option<TextPos>,
/// End of the range.
#[serde(default)]
end: Option<TextPos>,
/// Changes.
props: RunPatch,
},
/// Applies paragraph formatting to paragraphs `from..=to` (all when omitted).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
FormatParagraphs {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Table cell whose text to edit (the shape must be a table).
#[serde(default)]
cell: Option<CellRef>,
/// First paragraph.
#[serde(default)]
from: Option<usize>,
/// Last paragraph.
#[serde(default)]
to: Option<usize>,
/// Changes.
props: ParaPatch,
},
/// Changes text box properties.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
FormatBody {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Table cell whose text to edit (the shape must be a table).
#[serde(default)]
cell: Option<CellRef>,
/// Changes.
props: BodyPatch,
},
/// Moves, resizes, rotates, or flips a shape (omitted fields stay).
/// Values are in slide space, also for group members (as the outline
/// reports them); their group grows or shrinks to fit.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetTransform {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Left (points).
#[serde(default)]
x: Option<f32>,
/// Top (points).
#[serde(default)]
y: Option<f32>,
/// Width (points).
#[serde(default)]
w: Option<f32>,
/// Height (points).
#[serde(default)]
h: Option<f32>,
/// Rotation in degrees.
#[serde(default)]
rotation: Option<f32>,
/// Horizontal flip.
#[serde(default)]
flip_h: Option<bool>,
/// Vertical flip.
#[serde(default)]
flip_v: Option<bool>,
},
/// Sets a shape's fill.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetFill {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// The fill.
fill: FillSpec,
},
/// Changes a shape's outline.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetLine {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Changes.
line: LinePatch,
},
/// Changes a shape's preset geometry.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetGeometry {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Preset name.
preset: String,
},
/// Adds a shape (its id is reported in the result).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
AddShape {
/// Slide id.
slide: u32,
/// What to add.
shape: NewShape,
/// Left (points).
x: f32,
/// Top (points).
y: f32,
/// Width (points).
w: f32,
/// Height (points).
h: f32,
},
/// Deletes a shape.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DeleteShape {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
},
/// Duplicates a shape, offset by (dx, dy) points.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DuplicateShape {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Horizontal offset.
#[serde(default, deserialize_with = "nullable")]
dx: f32,
/// Vertical offset.
#[serde(default, deserialize_with = "nullable")]
dy: f32,
},
/// Changes a shape's z-order.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
ReorderShape {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Where to move it.
to: ZOrder,
},
/// Replaces a picture's image.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
ReplaceImage {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Base64-encoded PNG, JPEG, or GIF bytes.
data: String,
},
/// Sets the text of a table cell.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetCellText {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Row.
row: usize,
/// Column.
col: usize,
/// Text.
text: String,
},
/// Inserts a table row (copying the formatting of an adjacent row).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
InsertTableRow {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Index of the new row.
at: usize,
},
/// Deletes a table row.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DeleteTableRow {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Row index.
row: usize,
},
/// Inserts a table column (copying the formatting of an adjacent column).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
InsertTableColumn {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Index of the new column.
at: usize,
},
/// Deletes a table column.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DeleteTableColumn {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Column index.
col: usize,
},
/// Merges the rectangle of table cells between two corners into one cell.
/// The top-left cell keeps its formatting; the text of the other cells is
/// appended to it as paragraphs. Merged cells already inside the rectangle
/// are absorbed; a rectangle that cuts through a merged cell is rejected.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
MergeCells {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// One corner of the rectangle.
from: CellRef,
/// The opposite corner.
to: CellRef,
},
/// Splits a merged cell back into the grid cells it covers. The revealed
/// cells are empty and take the merged cell's fill and outer borders.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SplitCell {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Any grid cell the merged cell covers.
cell: CellRef,
},
/// Formats the table cells in the rectangle between two corners (widened
/// to whole merged cells). Omitted fields stay unchanged.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
FormatCells {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// One corner of the rectangle.
from: CellRef,
/// The opposite corner.
to: CellRef,
/// Cell fill (`{"kind":"none"}` = no fill, so the table background shows).
#[serde(default)]
fill: Option<FillSpec>,
/// Borders to change.
#[serde(default)]
borders: Option<CellBorders>,
/// Vertical text alignment: `top`, `middle`, or `bottom`.
#[serde(default)]
anchor: Option<String>,
/// Cell margins `[left, top, right, bottom]` in points.
#[serde(default)]
margins: Option<[f32; 4]>,
},
/// Sets a table's style and which of its parts the style emphasizes
/// (omitted fields stay unchanged). Applying a different style clears
/// fills and borders set directly on cells, as PowerPoint does, so the
/// table shows the new style.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetTableStyle {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Style id (a GUID from the deck outline's `tableStyles`, e.g.
/// `{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}` = Medium Style 2 - Accent 1),
/// or `""` for no style.
#[serde(default)]
style: Option<String>,
/// Emphasize the first (header) row.
#[serde(default)]
first_row: Option<bool>,
/// Emphasize the last (total) row.
#[serde(default)]
last_row: Option<bool>,
/// Emphasize the first column.
#[serde(default)]
first_col: Option<bool>,
/// Emphasize the last column.
#[serde(default)]
last_col: Option<bool>,
/// Alternate the shading of rows.
#[serde(default)]
band_row: Option<bool>,
/// Alternate the shading of columns.
#[serde(default)]
band_col: Option<bool>,
},
/// Sets table column widths and minimum row heights in points (rows still
/// grow to fit their text). The frame is resized to match.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetTableGrid {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// One width per column.
#[serde(default)]
column_widths: Option<Vec<f32>>,
/// One minimum height per row.
#[serde(default)]
row_heights: Option<Vec<f32>>,
},
/// Adds a slide based on a layout (its id is reported in the result).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
AddSlide {
/// Layout name (e.g. "Title and Content"); defaults to the layout of the reference slide.
#[serde(default)]
layout: Option<String>,
/// Insert after this slide (end of deck when omitted).
#[serde(default)]
after: Option<u32>,
/// Title placeholder text.
#[serde(default)]
title: Option<String>,
/// Body placeholder text (`\n` separates paragraphs).
#[serde(default)]
body: Option<String>,
},
/// Duplicates a slide right after itself.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DuplicateSlide {
/// Slide id.
slide: u32,
},
/// Deletes a slide.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DeleteSlide {
/// Slide id.
slide: u32,
},
/// Moves a slide to a 0-based position.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
MoveSlide {
/// Slide id.
slide: u32,
/// New index.
to: usize,
},
/// Hides or shows a slide in slideshows.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetSlideHidden {
/// Slide id.
slide: u32,
/// Hidden.
hidden: bool,
},
/// Replaces the speaker notes of a slide.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetNotes {
/// Slide id.
slide: u32,
/// Notes text (`\n` separates paragraphs).
text: String,
},
/// Sets a slide's background.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetBackground {
/// Slide id.
slide: u32,
/// The fill (`None` removes the override, inheriting the layout background).
fill: Option<FillSpec>,
},
// ---- charts ----
/// Replaces a chart's categories and series (the chart must be `editable`
/// in the outline). Existing series keep their formatting; new series
/// copy the last one's with the next theme accent color. The embedded
/// workbook is rewritten to match.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetChartData {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Category labels.
categories: Vec<String>,
/// Series in plot order (one value per category).
series: Vec<ChartSeriesData>,
},
/// Changes a chart's type (the chart must be `editable` in the outline).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetChartType {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// `bar` (horizontal), `column`, `line`, `pie`, `doughnut`, or `area`.
kind: String,
/// `clustered`, `stacked`, `percentStacked`, or `standard` (kept or the type's default when omitted).
#[serde(default)]
grouping: Option<String>,
},
/// Changes a chart's title, legend, data labels, or series colors (omitted fields stay).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
FormatChart {
/// Slide id.
slide: u32,
/// Graphic frame id.
shape: u32,
/// Title text (`""` removes the title).
#[serde(default)]
title: Option<String>,
/// Legend position: `right`, `left`, `top`, `bottom`, `topRight`, or `none`.
#[serde(default)]
legend: Option<String>,
/// Show or hide value data labels on every series.
#[serde(default)]
data_labels: Option<bool>,
/// Series colors.
#[serde(default)]
series_colors: Option<Vec<ChartSeriesColor>>,
},
// ---- shapes and slides ----
/// Groups two or more shapes that share a parent (usually top-level
/// shapes) into a new group placed at the z-position of the topmost of
/// them. They keep their order and exactly where they are. The group's id
/// is reported in the result. Placeholders cannot be grouped.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
GroupShapes {
/// Slide id.
slide: u32,
/// Ids of the shapes to group (at least two).
shapes: Vec<u32>,
},
/// Ungroups a group: its members take its place in the z-order and keep
/// exactly where and how they appear (the group's offset, scale,
/// rotation, and flips are applied to each). The members' ids are
/// reported in the result, back to front.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
UngroupShape {
/// Slide id.
slide: u32,
/// Group id.
shape: u32,
},
/// Pastes shapes copied with `copyShapes` (from this or another
/// presentation) on top of a slide, with fresh ids, offset by (dx, dy)
/// points. Pictures, media, charts, and links come along. Theme colors,
/// theme fonts, and style references take this presentation's theme
/// (PowerPoint's "Use Destination Theme"). The new top-level shape ids are
/// reported in the result, back to front.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
PasteShapes {
/// Slide id.
slide: u32,
/// The clipboard payload JSON returned by `copyShapes`.
payload: String,
/// Horizontal offset in points.
#[serde(default, deserialize_with = "nullable")]
dx: f32,
/// Vertical offset in points.
#[serde(default, deserialize_with = "nullable")]
dy: f32,
},
/// Pastes slides copied with `copySlides` (from this or another
/// presentation), with their speaker notes. Each slide takes this deck's
/// layout of the same name, else the first with the same placeholder
/// types, else "Title and Content", else the first layout; theme colors
/// and fonts follow this deck's theme. New slide ids are reported in the
/// result, in order.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
PasteSlides {
/// Insert after this slide (end of deck when omitted).
#[serde(default)]
after: Option<u32>,
/// The clipboard payload JSON returned by `copySlides`.
payload: String,
},
/// Changes a slide's layout. Placeholders are matched to the new layout's
/// placeholders by type and index and take their position; placeholders
/// without a match stay where they are. Content is kept, and the new
/// layout's other placeholders are added empty.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetSlideLayout {
/// Slide id.
slide: u32,
/// Layout name (e.g. "Title Only"), as listed in the deck's layouts.
layout: String,
},
/// Sets the transition into a slide. Omitted fields keep the slide's
/// current value, or take the effect's default for a new transition.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetTransition {
/// Slide id.
slide: u32,
/// Effect: `none` (removes the transition), `cut`, `fade`, `push`,
/// `wipe`, `split`, `reveal`, `randomBar`, `shape`, `uncover`,
/// `cover`, `zoom`, `dissolve`, `flash`, or `morph`.
kind: String,
/// Duration in milliseconds (at most 60000).
#[serde(default)]
duration_ms: Option<u32>,
/// Effect option: `fade`: `smooth` or `black`; `push`, `wipe`: `l`,
/// `r`, `u`, `d`; `cover`, `uncover`: those or `lu`, `ru`, `ld`, `rd`;
/// `split`: `horzOut`, `horzIn`, `vertOut`, `vertIn`; `reveal`: `l`,
/// `r`; `randomBar`: `horz`, `vert`; `shape`: `circle`, `diamond`,
/// `plus`; `zoom`: `in`, `out`; `morph`: `byObject`, `byWord`,
/// `byChar`. Directions are the OOXML `dir` values.
#[serde(default)]
direction: Option<String>,
/// Whether a click advances to the next slide.
#[serde(default)]
advance_on_click: Option<bool>,
/// Advance automatically after this many milliseconds; `0` turns
/// automatic advance off, and an omitted (or null) field keeps the
/// current setting.
#[serde(default)]
advance_after_ms: Option<u32>,
/// Give every slide of the deck the resulting transition.
#[serde(default, deserialize_with = "nullable")]
apply_to_all: bool,
},
/// Replaces a slide's animations (its main sequence, which plays as the
/// presenter clicks through the slide) with these, in playback order;
/// `[]` removes them all. An entry matching an animation the slide has
/// (same shape, class, effect, and paragraph, and direction when given)
/// keeps it, with its other settings unless the entry gives them, so
/// listing the current animations in a new order reorders them.
/// Animations started by clicking a shape (triggers) are kept.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetAnimations {
/// Slide id.
slide: u32,
/// Animations in playback order.
animations: Vec<AnimationSpec>,
},
/// Adds a new animation to a slide's sequence.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
AddAnimation {
/// Slide id.
slide: u32,
/// The animation.
animation: AnimationSpec,
/// 0-based position in playback order (the end when omitted).
#[serde(default)]
index: Option<usize>,
},
/// Removes animations from a slide's sequence: every animation of the
/// listed shapes and the animations at the listed playback positions.
/// Give at least one of the lists (`setAnimations` with `[]` removes all).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
RemoveAnimations {
/// Slide id.
slide: u32,
/// Shapes whose animations to remove.
#[serde(default)]
shape_ids: Option<Vec<u32>>,
/// 0-based playback positions to remove.
#[serde(default)]
indexes: Option<Vec<usize>>,
},
/// Replaces text in shapes, group members, and table cells, on one slide
/// or on every slide. A match may span differently formatted runs but not
/// paragraphs; the replacement takes the formatting of the first matched
/// character. The number of replacements is reported in the result.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
ReplaceText {
/// Text to find (within one paragraph).
find: String,
/// Replacement text (may be empty; no paragraph or line breaks).
replace: String,
/// Match upper and lower case exactly (default: ignore case).
#[serde(default, deserialize_with = "nullable")]
match_case: bool,
/// Only match whole words (no letter, digit, or `_` on either side).
#[serde(default, deserialize_with = "nullable")]
whole_word: bool,
/// Slide id; omit to replace on every slide.
#[serde(default)]
slide: Option<u32>,
},
/// Sets a shape's alt text (its description for screen readers); `""` removes it.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetAltText {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Alt text.
text: String,
},
/// Renames a shape (the name shown in the selection pane).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetShapeName {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// New name.
name: String,
},
/// Links whole shapes: clicking one in a slide show follows the link.
/// Links on text are set with formatText's `link`.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetShapeLink {
/// Slide id.
slide: u32,
/// Shape ids.
shapes: Vec<u32>,
/// An address (`https://…`, `mailto:…`), `#slide=<id>`, a slide show
/// jump (`#nextslide`, `#previousslide`, `#firstslide`, `#lastslide`,
/// `#lastslideviewed`, `#endshow`), or `""` to remove the link.
link: String,
/// The ScreenTip shown on hover.
#[serde(default)]
tip: Option<String>,
},
/// Hides or shows a shape (hidden shapes are not drawn).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetShapeHidden {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Hidden.
hidden: bool,
},
/// Format painter: gives shapes the look of another shape — its fill,
/// outline, effects, theme style, and text margins and anchoring.
/// Character and paragraph formatting are not copied (use formatText and
/// formatParagraphs). Group targets paint every member.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
PasteFormat {
/// Slide id of the shapes to restyle.
slide: u32,
/// Shape ids to restyle.
shapes: Vec<u32>,
/// Slide id of the shape to copy from.
from_slide: u32,
/// Shape id to copy from (a shape, line, or picture).
from_shape: u32,
},
// ---- pictures and effects ----
/// Crops a picture (PowerPoint's Crop). Edges are fractions of the
/// original image: 0.1 crops 10% of its width (left, right) or height
/// (top, bottom) off that edge, 0 shows the edge, and a negative value
/// adds empty padding; omitted edges keep their current crop. The image
/// keeps its size and place on the slide, so the picture's frame moves
/// and resizes to the part left visible. With `mode` (and no edges), the
/// image is instead cropped (`fill`) or padded (`fit`) to the frame's
/// aspect ratio, centered, and the frame stays. To crop to a shape, use
/// `setGeometry` on the picture.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
CropPicture {
/// Slide id.
slide: u32,
/// Picture id.
shape: u32,
/// Fraction of the image's width cropped off its left edge.
#[serde(default)]
left: Option<f32>,
/// Fraction of the image's height cropped off its top edge.
#[serde(default)]
top: Option<f32>,
/// Fraction of the image's width cropped off its right edge.
#[serde(default)]
right: Option<f32>,
/// Fraction of the image's height cropped off its bottom edge.
#[serde(default)]
bottom: Option<f32>,
/// `fill` or `fit` the frame's aspect ratio (instead of edges).
#[serde(default)]
mode: Option<CropMode>,
},
/// Adjusts pictures (PowerPoint's Corrections, Color, and Transparency).
/// Omitted fields keep their current value.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
FormatPicture {
/// Slide id.
slide: u32,
/// Ids of the pictures.
shapes: Vec<u32>,
/// Brightness from -1 to 1 (0 = unchanged, 0.2 = +20%).
#[serde(default)]
brightness: Option<f32>,
/// Contrast from -1 to 1 (0 = unchanged).
#[serde(default)]
contrast: Option<f32>,
/// Recolor: `none`, `grayscale`, `sepia`, `washout`, `blackWhite`
/// (50% threshold), `blackWhite25`, `blackWhite75`,
/// `duotone:<color>` (the image in dark shades of the color, on
/// white), `duotoneLight:<color>` (in light shades of it, on black),
/// or `duotone:<dark>,<light>` (black and white become these
/// colors). Colors are `RRGGBB` or theme names (`accent1`...).
#[serde(default)]
recolor: Option<String>,
/// Transparency from 0 (opaque) to 1.
#[serde(default)]
transparency: Option<f32>,
/// First remove the crop (the frame grows back to the whole image at
/// its current scale) and every adjustment; the other fields then
/// apply.
#[serde(default, deserialize_with = "nullable")]
reset: bool,
},
/// Sets shape effects (PowerPoint's Shape Effects and Picture Effects)
/// on shapes, pictures, lines, or groups. Each effect is kept when
/// omitted (or null), removed with `"none"`, or set from a preset name
/// or an options object (omitted options keep the current values). A
/// shape that inherits effects from the theme starts from those.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetShapeEffects {
/// Slide id.
slide: u32,
/// Shape ids.
shapes: Vec<u32>,
/// Shadow: `none`; an outer preset (`outerBottomRight`,
/// `outerBottom`, `outerBottomLeft`, `outerRight`, `outerCenter`,
/// `outerLeft`, `outerTopRight`, `outerTop`, `outerTopLeft`); an
/// inner preset (`innerTopLeft`, `innerTop`, `innerTopRight`,
/// `innerLeft`, `innerCenter`, `innerRight`, `innerBottomLeft`,
/// `innerBottom`, `innerBottomRight`); a perspective preset
/// (`perspectiveUpperLeft`, `perspectiveUpperRight`,
/// `perspectiveBelow`, `perspectiveLowerLeft`,
/// `perspectiveLowerRight`); or options.
#[serde(default)]
shadow: Option<EffectSpec<ShadowOptions>>,
/// Glow: `none` or options (PowerPoint's gallery uses the accent
/// colors at 5, 8, 11, and 18 pt with 0.6 transparency).
#[serde(default)]
glow: Option<EffectSpec<GlowOptions>>,
/// Soft edges: `none` or options (PowerPoint's gallery: 1, 2.5, 5,
/// 10, 25, and 50 pt).
#[serde(default)]
soft_edge: Option<EffectSpec<SoftEdgeOptions>>,
/// Reflection: `none`; a preset (`tightTouching`, `halfTouching`,
/// `fullTouching`, `tight4pt`, `half4pt`, `full4pt`, `tight8pt`,
/// `half8pt`, `full8pt`: how much of the shape is reflected, and the
/// gap); or options.
#[serde(default)]
reflection: Option<EffectSpec<ReflectionOptions>>,
},
// ---- freeform geometry ----
/// Replaces a shape's outline with custom geometry (PowerPoint's Edit
/// Points; a preset shape becomes a freeform). Fill, outline, effects,
/// text, rotation, and flips stay. Works on drawn shapes, text boxes,
/// placeholders, and pictures (it reshapes their crop outline). The
/// text area keeps its place on the slide.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetCustomGeometry {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// The outline's paths, in shape-local points (see `PathCommand`).
paths: Vec<GeometryPath>,
/// When true (the default when omitted or null), the shape's box is
/// moved and resized to the paths' bounds so the outline stays
/// exactly where it is drawn on the slide, as PowerPoint does after
/// Edit Points; points may then lie outside the current box. When
/// false, the box stays and the paths are drawn in it as given
/// (resizing the shape later stretches them).
#[serde(default)]
fit: Option<bool>,
},
/// Merges shapes into new outlines (PowerPoint's Shape Format ▸ Merge
/// Shapes), working in slide space with each shape's rotation, flips,
/// and group transform. The result takes the formatting, text, and
/// effects of the first shape (and its rotation, so its fill and text
/// keep their orientation) and replaces the shapes. The result's shape
/// ids are reported as created: the first is the first shape's id, which
/// the result keeps (`fragment` adds the other pieces as new shapes).
/// Lines, connectors, tables, charts, and groups cannot be merged; a
/// merge that leaves nothing is an error.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
MergeShapes {
/// Slide id.
slide: u32,
/// Ids of two or more shapes in selection order; the first one's
/// formatting wins (and `subtract` cuts the others out of it).
shapes: Vec<u32>,
/// `union`, `combine`, `fragment`, `intersect`, or `subtract`.
mode: MergeMode,
},
// ---- theme ----
/// Recolors the deck: sets theme color slots in every slide master's
/// theme, so everything that uses theme colors (most text, shapes,
/// charts, and tables) follows. Omitted slots keep their color.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetThemeColors {
/// Slots to set.
colors: Vec<ThemeColor>,
/// New name of the color scheme.
#[serde(default)]
name: Option<String>,
},
/// Sets the theme's heading (`major`) and body (`minor`) Latin fonts in
/// every slide master's theme; text that uses theme fonts follows.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetThemeFonts {
/// Heading font (kept when omitted).
#[serde(default)]
major: Option<String>,
/// Body font (kept when omitted).
#[serde(default)]
minor: Option<String>,
/// New name of the font scheme.
#[serde(default)]
name: Option<String>,
},
// ---- deck ----
/// Shows, hides, or changes the slide number, date, and footer of slides
/// (PowerPoint's Insert ▸ Header & Footer). Each element shown is a
/// placeholder that takes its position and style from the slide's
/// layout; a slide whose layout has no such placeholder cannot show it.
/// Omitted fields keep each slide's current state.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetHeaderFooter {
/// Slide ids to change; omit (or null) for every slide ("Apply to
/// All", which also makes slides added later show the same elements).
#[serde(default)]
slides: Option<Vec<u32>>,
/// Show the slide number.
#[serde(default)]
slide_number: Option<bool>,
/// Show the date.
#[serde(default)]
date: Option<bool>,
/// Fixed date text (e.g. "Q3 2026"); `""` makes the date automatic
/// (it shows the current date). Changes slides that show a date, so
/// pass `date: true` to turn it on.
#[serde(default)]
date_text: Option<String>,
/// Format of an automatic date: `datetime1` (10/12/2007, the
/// default), `datetime2` (Friday, October 12, 2007), `datetime3` (12
/// October 2007), `datetime4` (October 12, 2007), `datetime5`
/// (12-Oct-07), `datetime6` (October 07), `datetime7` (Oct-07),
/// `datetime8` (10/12/2007 4:28 PM), `datetime9` (10/12/2007 4:28:34
/// PM), `datetime10` (16:28), `datetime11` (16:28:34), `datetime12`
/// (4:28 PM), or `datetime13` (4:28:34 PM). A format without
/// `dateText` makes the date automatic.
#[serde(default)]
date_format: Option<String>,
/// Show the footer.
#[serde(default)]
footer: Option<bool>,
/// Footer text. Changes slides that show a footer, so pass
/// `footer: true` to turn it on.
#[serde(default)]
footer_text: Option<String>,
/// Don't show the elements on slides whose layout is a Title Slide
/// layout (they are removed there).
#[serde(default, deserialize_with = "nullable")]
not_on_title: bool,
},
/// Changes the slide size of the deck (PowerPoint's Design ▸ Slide
/// Size). Every slide, layout, and master changes; speaker notes keep
/// their size.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetSlideSize {
/// Width in points, 72-4032 (960 for 16:9 widescreen, 720 for 4:3
/// and 16:9 on-screen show, 780 for A4).
width: f32,
/// Height in points, 72-4032 (540 for widescreen, 4:3, and A4; 405
/// for 16:9 on-screen show).
height: f32,
/// How content follows: `none` (the default when omitted; it keeps
/// its size and position), `fit` (PowerPoint's "Ensure Fit": scaled
/// by the smaller of the width and height ratios and centered, text
/// and lines too), or `maximize` (scaled by the larger ratio and
/// centered).
#[serde(default)]
scale: Option<SlideScale>,
},
/// Starts a new section at a slide: the section takes that slide and the
/// slides after it in its current section. In a deck without sections,
/// the slides before it go into a "Default Section", as in PowerPoint.
/// The new section's id is reported in the result.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
AddSection {
/// Section name.
name: String,
/// Id of the section's first slide.
before_slide: u32,
},
/// Renames a section.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
RenameSection {
/// Section id (a GUID from the deck outline's `sections`).
id: String,
/// New name.
name: String,
},
/// Removes a section. Its slides join the previous section (the next
/// one when it is the first), or are deleted with `deleteSlides`.
/// Removing the only section leaves the deck without sections.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
RemoveSection {
/// Section id.
id: String,
/// Delete the section's slides too.
#[serde(default, deserialize_with = "nullable")]
delete_slides: bool,
},
/// Moves a section and all its slides to a 0-based position among the
/// sections; the slides are reordered to match.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
MoveSection {
/// Section id.
id: String,
/// New index among the sections.
to_index: usize,
},
/// Replaces the deck's drawing guides (PowerPoint's View ▸ Guides): the
/// dashed lines shown over every slide for lining shapes up, which
/// shapes snap to while dragged. Pass the whole list (the deck outline's
/// `guides`, changed); an empty list removes every guide. Guides that
/// slide layouts and masters define are not affected.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetGuides {
/// The guides, in order.
guides: Vec<GuideSpec>,
},
// ---- slide masters and layouts (Slide Master view) ----
/// Adds a slide layout to a slide master (PowerPoint's Slide Master ▸
/// Insert Layout): a layout with a title placeholder and the master's
/// date, footer, and slide number placeholders, or with `duplicate` a
/// copy of that layout. Masters and layouts are listed in the deck
/// outline's `masters`. The new layout's id is reported in the result
/// (as `slide`); it addresses the layout's shapes like a slide id.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
AddLayout {
/// Id of the master to add it to (default: the master of `after`
/// or `duplicate`, else the first master).
#[serde(default)]
master: Option<u32>,
/// Id of the layout to insert it after; a master's id puts it first
/// (default: right after `duplicate`, else after the master's last
/// layout).
#[serde(default)]
after: Option<u32>,
/// Id of a layout to copy, with its shapes and background.
#[serde(default)]
duplicate: Option<u32>,
/// Name (default: "Custom Layout", or for a copy the original's name
/// prefixed "1_", numbered further when the master has one already).
#[serde(default)]
name: Option<String>,
},
/// Renames a slide layout, or a slide master (a master's name is its
/// theme's name, as PowerPoint shows it).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
RenameLayout {
/// Layout or master id.
layout: u32,
/// New name.
name: String,
},
/// Deletes a slide layout no slide uses (give those slides another
/// layout with `setSlideLayout` first). A master keeps at least one
/// layout. With a master's id, deletes that master and its layouts when
/// no slide uses any of them and another master remains.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DeleteLayout {
/// Layout or master id.
layout: u32,
},
/// Adds a placeholder to a slide layout (PowerPoint's Slide Master ▸
/// Insert Placeholder). Slides added with the layout afterwards get it,
/// empty, where the layout has it; existing slides get it when their
/// layout is applied again (`setSlideLayout`). Content and text
/// placeholders take the master's text styles. The new shape's id is
/// reported in the result.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
InsertPlaceholder {
/// Layout id.
layout: u32,
/// What it holds: `content`, `text`, `picture`, `chart`, `table`,
/// `smartArt`, or `media`.
kind: PlaceholderKind,
/// Left (points).
x: f32,
/// Top (points).
y: f32,
/// Width (points).
w: f32,
/// Height (points).
h: f32,
/// Vertical text (PowerPoint's "Content (Vertical)" and "Text
/// (Vertical)"); content and text placeholders only.
#[serde(default, deserialize_with = "nullable")]
vertical: bool,
},
/// Sets what a slide layout shows (PowerPoint's Slide Master ▸ Title,
/// Footers, and Hide Background Graphics). Omitted fields keep the
/// layout's current state.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetLayoutOptions {
/// Layout id.
layout: u32,
/// Show a title placeholder (added where the master's title is, or
/// removed).
#[serde(default)]
title: Option<bool>,
/// Show the date, footer, and slide number placeholders the master
/// has (added where the master has them, or removed).
#[serde(default)]
footers: Option<bool>,
/// Hide the master's shapes (logos, lines, pictures) on the layout
/// and its slides.
#[serde(default)]
hide_background_graphics: Option<bool>,
},
/// Gives a slide, slide master, or layout one of the theme's background
/// styles (PowerPoint's Background Styles gallery), which follow the
/// theme's colors and background fills. Styles 1-4 are the theme's
/// first background fill (usually solid) in Light 1, Dark 1, Light 2,
/// and Dark 2; 5-8 its second and 9-12 its third, in the same colors.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetBackgroundStyle {
/// Slide, master, or layout id.
slide: u32,
/// Style number, 1-12.
style: u8,
},
// ---- review ----
/// Adds a comment thread to a slide (PowerPoint's Review ▸ New
/// Comment), attached to a shape or to the slide. Written as PowerPoint
/// for Microsoft 365 writes comments. Read threads and their ids from
/// the slide outline's `comments`.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
AddComment {
/// Slide id.
slide: u32,
/// The comment (`\n` separates paragraphs).
text: String,
/// The author's name, as the Comments pane shows it.
author: String,
/// The author's initials (omit or null: the first letters of the
/// first two words of `author`).
#[serde(default)]
initials: Option<String>,
/// Where the comment's marker sits, in points from the slide's left
/// edge, for a comment on the slide (omit or null with `y` for
/// PowerPoint's default, the slide's top-left corner). Ignored with
/// `shape`.
#[serde(default)]
x: Option<f32>,
/// Marker position in points from the slide's top edge.
#[serde(default)]
y: Option<f32>,
/// Shape id to attach the comment to (its marker sits at the
/// shape's top-right corner); omit or null for the slide itself.
#[serde(default)]
shape: Option<u32>,
},
/// Replies to a comment thread.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
ReplyComment {
/// Slide id.
slide: u32,
/// Thread id (a comment's `id` in the outline). Legacy comments
/// (`legacy-…` ids) cannot be replied to.
comment: String,
/// The reply (`\n` separates paragraphs).
text: String,
/// The author's name.
author: String,
/// The author's initials (omit or null: derived from `author`).
#[serde(default)]
initials: Option<String>,
},
/// Replaces the text of a comment: a thread's first comment or a reply.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
EditComment {
/// Slide id.
slide: u32,
/// Thread or reply id.
comment: String,
/// The new text.
text: String,
},
/// Resolves a comment thread, or reopens it (PowerPoint's Resolve
/// thread / Reopen). Legacy comments cannot be resolved.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
ResolveComment {
/// Slide id.
slide: u32,
/// Thread id.
comment: String,
/// `true` resolves; `false` reopens.
resolved: bool,
},
/// Deletes a comment thread with its replies, or a single reply.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DeleteComment {
/// Slide id.
slide: u32,
/// Thread or reply id.
comment: String,
},
/// Deletes every comment on a slide, or with `slide` omitted (or null)
/// every comment in the presentation.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
DeleteAllComments {
/// Slide id (omit or null: all slides).
#[serde(default)]
slide: Option<u32>,
},
// ---- equations ----
/// Inserts an equation (PowerPoint's Insert ▸ Equation) written in the
/// LaTeX-style linear format: into a shape's text at `at`, or, without
/// `shape`, in a new text box centered on the slide (its id is reported
/// in the result). In text an equation counts as one character (U+FFFC
/// in the outline's paragraph text, listed in the paragraph's
/// `equations`): delete it with `deleteText`, change it with
/// `setEquation`. Supported: `\frac{a}{b}`, `^`, `_`, `\sqrt[n]{x}`,
/// `\sum_{i=1}^{n}`, `\prod`, `\int_{a}^{b}`, `\oint`, `\lim_{x\to 0}`,
/// `\sin` and other functions, `\left( \right)` (brackets such as
/// `(…)` pair and grow by themselves), `\begin{matrix}` / `pmatrix` /
/// `bmatrix` / `vmatrix` / `cases` / `aligned`, `\binom{n}{k}`, accents
/// (`\hat \bar \vec \dot \ddot \tilde`), `\overline`, `\underline`,
/// `\overbrace{x}^{a}`, `\underbrace{x}_{a}`, `\boxed`, Greek letters,
/// symbols (`\infty \pm \times \cdot \le \ge \ne \approx \to
/// \Rightarrow \partial \nabla`...), `\mathrm{}`, `\mathbf{}`,
/// `\mathbb{}`, `\mathcal{}`, `\text{}`, and spaces (`\, \; \quad`).
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
InsertEquation {
/// Slide id.
slide: u32,
/// Shape whose text gets the equation; omit (or null) to add a new
/// text box holding only the equation.
#[serde(default)]
shape: Option<u32>,
/// Table cell whose text gets the equation (the shape must be a table).
#[serde(default)]
cell: Option<CellRef>,
/// Where in the shape's text; omit (or null) for the end of its
/// last paragraph.
#[serde(default)]
at: Option<TextPos>,
/// The equation, e.g. `x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}`.
latex: String,
/// `true`: a display equation on a line (paragraph) of its own,
/// centered, with large operators and fractions at full size (what
/// PowerPoint inserts); `false`: inline, flowing with the text
/// around it. Omit (or null) for display in an empty paragraph or a
/// new text box, inline otherwise.
#[serde(default)]
display: Option<bool>,
},
/// Replaces an equation (one of a paragraph's `equations` in the
/// outline) with new linear text, keeping its size and color.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
SetEquation {
/// Slide id.
slide: u32,
/// Shape id.
shape: u32,
/// Table cell holding the equation (the shape must be a table).
#[serde(default)]
cell: Option<CellRef>,
/// Paragraph index.
paragraph: usize,
/// The equation's character index in the paragraph (its `index` in
/// the outline).
index: usize,
/// The new equation in the linear format (see `insertEquation`).
latex: String,
/// Make it a display (`true`) or inline (`false`) equation; omit
/// (or null) to keep.
#[serde(default)]
display: Option<bool>,
},
// ---- SmartArt ----
/// Edits a SmartArt graphic (a shape of kind `diagram` whose outline has
/// `smartArt`): its nodes and their text as in PowerPoint's text pane,
/// its layout, colors, or style. The diagram is laid out again, its text
/// shrinking together to fit. Nodes are addressed by the ids in
/// `smartArt.nodes`; a new node's id appears there afterwards. Diagrams
/// whose layout the outline reports as not `supported` take text edits,
/// colors, styles, and a new supported layout, but not node changes.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
EditSmartArt {
/// Slide id.
slide: u32,
/// The SmartArt graphic frame's id.
shape: u32,
/// The change.
edit: SmartArtEdit,
},
/// Converts a SmartArt graphic into ordinary shapes (a group that looks
/// the same) or into a bulleted text box. The new shape's id is reported
/// in the result.
#[cfg_attr(feature = "openapi", schema(rename_all = "camelCase"))]
ConvertSmartArt {
/// Slide id.
slide: u32,
/// The SmartArt graphic frame's id.
shape: u32,
/// `shapes` or `text`.
to: SmartArtTarget,
},
}
/// Something an edit created.
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct Created {
/// Slide id (a new section's first slide).
pub slide: u32,
/// Shape id, for created shapes.
pub shape: Option<u32>,
/// Section id, for created sections.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub section: Option<String>,
}
/// The outcome of applying a batch of operations.
#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct EditResult {
/// Ids created by the batch, in order.
pub created: Vec<Created>,
/// Slides whose rendering changed.
pub changed_slides: Vec<u32>,
/// Whether slides were added, removed, or reordered, or the slide size,
/// sections, or drawing guides changed.
/// Slide masters and layouts (by id) whose own rendering changed, as
/// Slide Master view shows them.
#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub changed_layouts: Vec<u32>,
/// Whether slides were added, removed, or reordered, or the slide size
/// or sections changed, or slide masters or layouts were added,
/// removed, reordered, renamed, or hid or showed background graphics.
pub structure_changed: bool,
/// Text replacements made by `replaceText` operations.
#[serde(default)]
pub replaced: usize,
}