Return the full document state (slides, shapes, props), undo/redo flags, and clipboard summary.

List all slides in the document (id, title, shape count).

Get a single slide by index (default: current).

Append a new slide. Returns the new slide index.

Delete a slide by index. Refuses if it would leave the deck empty.

Move slide src -> dst (both 0-based indices).

Rename a slide (default: current).

Set a slide's background as a hex color.

Set or clear the speaker notes on a slide (default: current). Pass an empty string to clear. Round-trips through the <p:notesSlides> node on save.

Set or clear a slide transition (default: current). kind is a PowerPoint transition name (fade / push / wipe / cover / cut / …) or "" to clear. duration is in seconds (default 0). Round-trips through the <p:transition> node on save.

List shapes on a slide (default: current).

Look up a shape by id across all slides.

Add a shape to a slide. Returns the new shape id. kinds: text / rect / ellipse / image (NamedShape subclasses — fill / text / path go in their own fields). kinds: connector / arrow / autoshape (preset shape — pass props.prst). kind: freeform (props.path_ops is a list of [op, *args] tuples: M/L/C/Q/Z). kind: table (rows / cols / cells). Every kind accepts extra props that ride through onto the shape verbatim (rotation, flip_h, fill, stroke, font_size, ln_color, head_end, ...).

Delete a shape by id.

Translate a shape by (dx, dy) in slide coordinates.

Set a shape's box (x, y, w, h) in slide coordinates.

Replace the text on a text/auto-shape.

Set a single property on a shape (e.g. fill, stroke, font_size, bold, color).

Set a shape's rotation in degrees (clockwise, 0..360). Stored on props.rotation; the renderer applies it as a Qt item transform around the shape centre. Round-trips through OOXML <a:xfrm rot="..."/> on save.

Undo the most recent command.

Redo the most recently undone command.

Return whether undo/redo are possible.

Copy the given shape ids to the in-process clipboard. If shape_ids is omitted, all shapes on the current slide are copied. The clipboard is shared with the GUI (Edit → Copy / Cmd-C).

Copy the given shape ids to the clipboard AND remove them from the current slide. Each removal is a separate undo-able command.

Paste shapes from the clipboard onto the current (or specified) slide. Each pasted shape gets a new id and is offset by (offset, offset) pt from the original so consecutive pastes cascade visibly.

Duplicate the given shape ids in place (slight offset). Unlike copy+paste, no clipboard side-effect.

Inspect the in-process clipboard (size, is_cut, source slide, shape payloads).

Empty the in-process clipboard.

Reset the document to a blank one with the given title. Also clears the clipboard.

Open a .pptx file and replace the current document. Also clears the clipboard.

Save to the current path; if no path set, fails (use save_document_as).

Save to a specific path.

Dump the document to a JSON file (lossless internal model).

Render a single slide to a PNG file at the slide's native resolution (default 2x = 1920x1080). Uses QGraphicsScene.render on a fresh QImage so no GUI widget needs to be shown.

Render every slide as slide_NN.png in the given directory. Returns the list of paths written.

Ask the GUI to quit (no-op in headless mode).

Execute a Python string against the live Document. Bound names: document, slides, current_slide, undo_stack, rt (with add_text/add_rect/...), math, random, json. Imports, eval/exec, and dunder access are blocked.

Return a sample script for the script editor.

Copy whole slides to the slide-level clipboard. Indices default to [current]. Survives paste across calls; cut is not supported here (use duplicate_slide + delete_slides for a two-step cut).

Paste slides from the slide-level clipboard after after_index (default: last slide). Pushes one command per pasted slide so undo cleanly removes them.

Duplicate the slides at the given indices. Operates highest-index first so earlier insertions don't shift later targets.

Delete the slides at the given indices. Refuses if it would leave the deck empty.

Align 2+ shapes on the current slide along one of the edges (left / center_h / right / top / center_v / bottom). Uses the bounding box of the selection as the alignment target.

Reorder shapes on a slide (z-order). to is one of front / back / forward / backward. Forward/backward move each shape one step.

Wrap the given shape ids in a new logical Group on a slide. If any of the shapes are already in a group, the entire group is included. Returns the new group_id.

Remove a Group wrapper. Pass either group_id or shape_id (any shape from the group).