athena-python-pptx 0.4.0__tar.gz → 0.4.2__tar.gz

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 All notable changes to `athena-python-pptx` are documented in this file.
 
+## 0.4.2
+
+**Paragraph-level font fidelity — `paragraph.font` now matches stock
+python-pptx `defRPr` semantics (fidelity-pipeline findings batch).**
+
+- **`paragraph.font` is a real paragraph-level font.** Previously it
+  returned the first run's font ("approximate by targeting the first
+  run"), which (a) produced exports with explicit `<a:rPr>` on every run
+  where stock python-pptx writes `<a:pPr><a:defRPr/>` (the fidelity
+  pipeline's sdk-projection leg counted 229 structural diffs on the
+  25-slide diagnostic deck) and (b) mis-styled multi-run paragraphs (only
+  run 0 changed, where stock applies the default to ALL runs). Writes now
+  emit `SetParagraphStyle` with a `defaultRunStyle` payload; the studio
+  stores it as the paragraph's authored defaults and exports `defRPr`
+  exactly like stock.
+- **`run.font.color.brightness` now round-trips.** Previously stored
+  locally and silently dropped; now emitted with the theme color and
+  serialized as `lumMod`/`lumOff` modifiers on `<a:schemeClr>` using
+  python-pptx's mapping.
+- Studio-side (same batch): theme color references (`schemeColor`) now
+  survive on SDK-created textbox runs, and new paragraphs added via
+  `add_paragraph()`/multi-line `tf.text` no longer inherit the previous
+  paragraph's authored level/spacing/alignment (server-side paragraph
+  template bleed).
+
 ## 0.3.1
 
 **Chart title runs, slide insertion, and shape-delete local state — Insight

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/CLAUDE.md

@@ -45,8 +45,9 @@ A small number of REST-SDK-specific departures are documented in
 [`docs/API_PARITY_EXCEPTIONS.md`](docs/API_PARITY_EXCEPTIONS.md):
 
 - **`Presentation(filename)` not supported** — REST SDK uses
-  `Presentation.upload(path)` or `Presentation(deck_id=…)` instead;
-  there's no local OPC package to open.
+  `Presentation.upload(path)` or `Presentation(asset_id=…)` instead
+  (`deck_id=` is the accepted legacy alias); there's no local OPC
+  package to open.
 - **`NotesSlide.shapes` / `.placeholders` / `.notes_placeholder`** not yet exposed —
   use `slide.notes_slide.notes_text_frame` for notes text.
 - **`XyChartData.add_series(name, values)`** signature drift vs upstream's

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/DEV-GUIDE.md

@@ -23,9 +23,9 @@ Create `scratch.py` in the `python-sdk/` directory:
 ```python
 from pptx import Presentation
 
-# Upload a test file or use an existing deck ID
+# Upload a test file or use an existing asset id
 prs = Presentation.upload("path/to/test.pptx", name="test")
-print(f"Deck: {prs.deck_id}, Slides: {prs.slide_count}")
+print(f"Presentation: {prs.asset_id}, Slides: {prs.slide_count}")
 
 slide = prs.slides[0]
 for shape in slide.shapes:
@@ -100,5 +100,5 @@ The SDK is a **remote proxy** over the PPTX Studio API:
 | Method | Example |
 |--------|---------|
 | Env vars | `ATHENA_PPTX_BASE_URL=http://localhost:4000` |
-| Explicit | `Presentation(deck_id, base_url="http://localhost:4000")` |
+| Explicit | `Presentation(asset_id="asset_...", base_url="http://localhost:4000")` (`deck_id=` is the legacy alias) |
 | API key (optional) | `ATHENA_PPTX_API_KEY=your-key` |

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: athena-python-pptx
-Version: 0.4.0
+Version: 0.4.2
 Summary: Drop-in replacement for python-pptx that connects to PPTX Studio for real-time collaboration
 Project-URL: Homepage, https://github.com/pptx-studio/python-sdk
 Project-URL: Documentation, https://docs.pptx-studio.com/sdk/python
@@ -202,7 +202,7 @@ export ATHENA_PPTX_API_KEY=your-api-key  # Optional
 Or pass them explicitly:
 
 ```python
-prs = Presentation(deck_id="deck_123", base_url="...", api_key="...")
+prs = Presentation(asset_id="asset_3a9328bc-9c1c-4498-be8f-bda3883276f5", base_url="...", api_key="...")
 ```
 
 ## Quick Start
@@ -246,24 +246,27 @@ slide.shapes[0].text_frame.text = "Updated Title"
 prs.save("modified.pptx")
 ```
 
-### Connect to an Existing Deck
+### Connect to an Existing Presentation
 
 ```python
 from pptx import Presentation
 
-# Connect to a deck by ID
-prs = Presentation(deck_id="deck_abc123")
+# Connect to a presentation by its Athena asset id
+prs = Presentation(asset_id="asset_3a9328bc-9c1c-4498-be8f-bda3883276f5")
 
 # Work with slides
 for slide in prs.slides:
     print(f"Slide {slide.slide_index}: {len(slide.shapes)} shapes")
 ```
 
-> **Important:** When working with an existing deck, you **MUST** include the `deck_id` parameter:
+`deck_id=` is accepted as a legacy alias for `asset_id=` (it is the same
+identifier string); prefer `asset_id=` in new code.
+
+> **Important:** When working with an existing presentation, you **MUST** include the `asset_id` parameter:
 > ```python
-> prs = Presentation(deck_id="d822b6e3-0a73-4214-9e71-8f28a3f7c9d9")
+> prs = Presentation(asset_id="asset_d822b6e3-0a73-4214-9e71-8f28a3f7c9d9")
 > ```
-> Without `deck_id`, the SDK cannot connect to PPTX Studio and will fail.
+> Without `asset_id`, the SDK cannot connect to PPTX Studio and will fail.
 
 ---
 
@@ -271,7 +274,7 @@ for slide in prs.slides:
 
 ### Presentation
 
-The main entry point for working with a deck.
+The main entry point for working with a presentation.
 
 #### Class Methods
 
@@ -286,14 +289,14 @@ prs = Presentation.open("path/to/file.pptx")  # Alias for upload()
 # Connect from a full URL
 prs = Presentation.from_url("https://api.example.com/decks/deck_123")
 
-# Connect to an existing deck by ID
-prs = Presentation(deck_id="deck_123")
+# Connect to an existing presentation by asset id
+prs = Presentation(asset_id="asset_3a9328bc-9c1c-4498-be8f-bda3883276f5")
 ```
 
 #### Properties
 
 ```python
-prs.deck_id         # str: Deck identifier
+prs.asset_id        # str: Athena asset id (prs.deck_id is the legacy alias)
 prs.slides          # Slides: Collection of slides
 prs.slide_width     # Emu: Width of slides
 prs.slide_height    # Emu: Height of slides
@@ -889,7 +892,7 @@ print(info['authToken'])
 
 See [`docs/API_PARITY_EXCEPTIONS.md`](docs/API_PARITY_EXCEPTIONS.md) for the full list. Highlights:
 
-- **`Presentation(filename)` not supported** — use `Presentation.upload(path)` or `Presentation(deck_id=…)` instead.
+- **`Presentation(filename)` not supported** — use `Presentation.upload(path)` or `Presentation(asset_id=…)` instead (`deck_id=` is the legacy alias).
 - **`NotesSlide.shapes` / `.placeholders` / `.notes_placeholder`** not yet exposed — use `slide.notes_slide.notes_text_frame` for text.
 - **`XyChartData.add_series(name, values)`** signature drift vs upstream's `add_series(name, number_format=None)`.
 - **`TextFitter.best_fit_font_size()`** returns `max_size` unchanged (auto-fit is server-side).

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/README.md

@@ -162,7 +162,7 @@ export ATHENA_PPTX_API_KEY=your-api-key  # Optional
 Or pass them explicitly:
 
 ```python
-prs = Presentation(deck_id="deck_123", base_url="...", api_key="...")
+prs = Presentation(asset_id="asset_3a9328bc-9c1c-4498-be8f-bda3883276f5", base_url="...", api_key="...")
 ```
 
 ## Quick Start
@@ -206,24 +206,27 @@ slide.shapes[0].text_frame.text = "Updated Title"
 prs.save("modified.pptx")
 ```
 
-### Connect to an Existing Deck
+### Connect to an Existing Presentation
 
 ```python
 from pptx import Presentation
 
-# Connect to a deck by ID
-prs = Presentation(deck_id="deck_abc123")
+# Connect to a presentation by its Athena asset id
+prs = Presentation(asset_id="asset_3a9328bc-9c1c-4498-be8f-bda3883276f5")
 
 # Work with slides
 for slide in prs.slides:
     print(f"Slide {slide.slide_index}: {len(slide.shapes)} shapes")
 ```
 
-> **Important:** When working with an existing deck, you **MUST** include the `deck_id` parameter:
+`deck_id=` is accepted as a legacy alias for `asset_id=` (it is the same
+identifier string); prefer `asset_id=` in new code.
+
+> **Important:** When working with an existing presentation, you **MUST** include the `asset_id` parameter:
 > ```python
-> prs = Presentation(deck_id="d822b6e3-0a73-4214-9e71-8f28a3f7c9d9")
+> prs = Presentation(asset_id="asset_d822b6e3-0a73-4214-9e71-8f28a3f7c9d9")
 > ```
-> Without `deck_id`, the SDK cannot connect to PPTX Studio and will fail.
+> Without `asset_id`, the SDK cannot connect to PPTX Studio and will fail.
 
 ---
 
@@ -231,7 +234,7 @@ for slide in prs.slides:
 
 ### Presentation
 
-The main entry point for working with a deck.
+The main entry point for working with a presentation.
 
 #### Class Methods
 
@@ -246,14 +249,14 @@ prs = Presentation.open("path/to/file.pptx")  # Alias for upload()
 # Connect from a full URL
 prs = Presentation.from_url("https://api.example.com/decks/deck_123")
 
-# Connect to an existing deck by ID
-prs = Presentation(deck_id="deck_123")
+# Connect to an existing presentation by asset id
+prs = Presentation(asset_id="asset_3a9328bc-9c1c-4498-be8f-bda3883276f5")
 ```
 
 #### Properties
 
 ```python
-prs.deck_id         # str: Deck identifier
+prs.asset_id        # str: Athena asset id (prs.deck_id is the legacy alias)
 prs.slides          # Slides: Collection of slides
 prs.slide_width     # Emu: Width of slides
 prs.slide_height    # Emu: Height of slides
@@ -849,7 +852,7 @@ print(info['authToken'])
 
 See [`docs/API_PARITY_EXCEPTIONS.md`](docs/API_PARITY_EXCEPTIONS.md) for the full list. Highlights:
 
-- **`Presentation(filename)` not supported** — use `Presentation.upload(path)` or `Presentation(deck_id=…)` instead.
+- **`Presentation(filename)` not supported** — use `Presentation.upload(path)` or `Presentation(asset_id=…)` instead (`deck_id=` is the legacy alias).
 - **`NotesSlide.shapes` / `.placeholders` / `.notes_placeholder`** not yet exposed — use `slide.notes_slide.notes_text_frame` for text.
 - **`XyChartData.add_series(name, values)`** signature drift vs upstream's `add_series(name, number_format=None)`.
 - **`TextFitter.best_fit_font_size()`** returns `max_size` unchanged (auto-fit is server-side).

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/docs/API_PARITY_EXCEPTIONS.md

@@ -352,19 +352,30 @@ public reorder API (callers manipulate `slides.sldIdLst` XML directly).
 prs.reorder_slides([2, 0, 1])  # move slide 2 to the front
 ```
 
-### Strict positive-dimension validation on every `Add*` command
-
-`AddTextBox`, `AddShape`, `AddPicture`, `AddTable`, and `SetTransform`
-now reject **zero** width/height client-side, not just negative values.
-This matches the server's Zod schema (`z.number().int().positive()`) so
-a stray `Inches(0)` raises a clear, field-named `ValidationError` locally
-instead of becoming a generic `commands.N.hEmu: Too small` 400 after the
-batch is on the wire. (For `AddPicture`, omit `width=`/`height=` entirely
-to fall back to the image's native dimensions — that path is still
-supported; the validation only fires when an explicit zero is passed.)
-
-`SetColWidth` and `SetRowHeight` still allow zero (`min(0)` server-side)
-because zero means "auto-fit" for table dimensions.
+### Non-negative dimension validation on every `Add*` command
+
+`AddTextBox`, `AddShape`, `AddPicture`, `AddTable`, `SetTransform`,
+`AddOleObject`, `AddLinkedOleObject`, `AddLinkedTable`, `AddChart`,
+`AddChart2016`, and `AddMovie` reject **negative** width/height
+client-side (the server's Zod schema is `z.number().int().nonnegative()`).
+
+**Zero is allowed**, matching python-pptx and OOXML — `a:ext` cx/cy are
+`ST_PositiveCoordinate` whose XSD facet is `minInclusive="0"`, so a
+zero-area shape (e.g. a degenerate divider line/connector) is valid and
+python-pptx accepts it without complaint. Earlier SDK versions rejected
+zero too; that was a parity departure that broke the common
+"thin divider" idiom and aborted whole command batches when an agent
+passed `height=0`, so it was reverted. A negative value still raises a
+clear, field-named `ValidationError` locally (and `400` server-side)
+rather than producing an invalid `<a:ext>`.
+
+(For `AddPicture`, omit `width=`/`height=` entirely to fall back to the
+image's native dimensions — that path is unchanged.)
+
+`SetColWidth` and `SetRowHeight` also allow zero (`min(0)` server-side)
+because zero means "auto-fit" for table dimensions. `SetPresentationSize`
+still requires strictly positive dimensions (a zero-size slide is
+degenerate, not a valid OOXML construct).
 
 ### Server fail-fast on partial batch failure
 
@@ -735,18 +746,35 @@ Athena-only. Equivalent to calling `prs.set_slide_size(Emu(14630400),
 Emu(8229600))` immediately after creation. For non-standard sizes call
 `prs.set_slide_size(width, height)` after `create()`.
 
-### `Presentation.asset_id` — alias for `deck_id`
+### `Presentation(asset_id=...)` / `Presentation.asset_id` — preferred spelling; `deck_id` is the legacy alias
 
 The deck id and the Athena asset id are the same string
-(`asset_<uuid>`); the property exists because Olympus URLs, GraphQL
-schemas, and most agent-facing copy refer to "asset id". Both names
-return `self._deck_id`:
+(`asset_<uuid>`); `asset_id` is the preferred name because Olympus
+URLs, GraphQL schemas, and most agent-facing copy refer to "asset id".
+Upstream `python-pptx` opens a local OPC package via
+`Presentation(pptx_path)` — the REST SDK has no local package, so the
+constructor reattaches to a server-side asset by id instead. Both the
+constructor keyword and the read property exist in both spellings:
 
 ```python
-prs.deck_id   # "asset_3a93..."
-prs.asset_id  # same value
+prs = Presentation(asset_id="asset_3a93...")  # preferred
+prs = Presentation(deck_id="asset_3a93...")   # legacy alias — same behaviour
+
+prs.asset_id  # "asset_3a93..." — preferred
+prs.deck_id   # same value — legacy alias
 ```
 
+Rules (mirrors the `name`/`title` reconciliation on
+`Presentation.create()`):
+
+- `asset_id` and `deck_id` are interchangeable; internally both bind the
+  same identifier (`self._deck_id`).
+- Passing **both** is allowed only when the values match; differing
+  values raise `ValueError`.
+- Passing **neither** raises `TypeError` (previously `deck_id` was the
+  required first positional parameter; positional
+  `Presentation("asset_...")` still works unchanged).
+
 ### `Presentation.close()` — alias for `flush()`
 
 Stock python-pptx has no flush/close concept (it writes packages

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/pptx/__init__.py

@@ -19,8 +19,9 @@ for real-time collaboration. Use exactly the same code you would with python-ppt
     # Or upload an existing file
     prs = Presentation.upload("my_presentation.pptx")
 
-    # Or connect to an existing deck
-    prs = Presentation(deck_id="deck_123")
+    # Or connect to an existing presentation asset
+    # (deck_id= is accepted as a legacy alias for asset_id=)
+    prs = Presentation(asset_id="asset_3a9328bc-9c1c-4498-be8f-bda3883276f5")
 
     # Work with slides and shapes (same API as python-pptx)
     slide = prs.slides[0]
@@ -132,7 +133,7 @@ def flush_all() -> None:
     _active_buffers[:] = alive
 
 
-__version__ = "0.4.0"
+__version__ = "0.4.2"
 
 __all__ = [
     # Main entry point

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/pptx/client.py

@@ -666,6 +666,7 @@ class Client:
                     flipV=transform_data.get("flipV"),
                 ),
                 preview_text=elem_data.get("previewText"),
+                rich_content=elem_data.get("richContent"),
                 placeholder=placeholder,
                 properties=elem_data.get("properties"),
                 source=elem_data.get("source"),

{athena_python_pptx-0.4.0 → athena_python_pptx-0.4.2}/pptx/commands.py

@@ -87,14 +87,14 @@ class AddTextBox(Command):
     def validate(self) -> None:
         if self.slide_index < 0:
             raise ValidationError("slide_index must be non-negative", "slide_index")
-        # Server Zod schema is z.number().int().positive() → rejects 0 and
-        # negatives. Reject locally too so a stray Inches(0) raises with a
-        # clear field name + value instead of becoming a generic
-        # "commands.N.hEmu: Too small" 400 after the round-trip.
-        if self.w_emu <= 0:
-            raise ValidationError(f"width must be > 0 EMU (got {self.w_emu})", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError(f"height must be > 0 EMU (got {self.h_emu})", "h_emu")
+        # OOXML `a:ext` cx/cy are ST_PositiveCoordinate (minInclusive=0), so
+        # zero-area shapes are valid (e.g. a degenerate divider/connector) and
+        # python-pptx accepts them. Only negatives are rejected, matching the
+        # server Zod schema (z.number().int().nonnegative()).
+        if self.w_emu < 0:
+            raise ValidationError(f"width must be >= 0 EMU (got {self.w_emu})", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError(f"height must be >= 0 EMU (got {self.h_emu})", "h_emu")
 
 
 @dataclass
@@ -155,14 +155,15 @@ class SetTransform(Command):
     def validate(self) -> None:
         if not self.shape_id:
             raise ValidationError("shape_id is required", "shape_id")
-        # Server Zod schema: wEmu / hEmu are z.number().int().positive() —
-        # rejects 0 and negatives. Mirror locally so a stray Inches(0) raises
-        # synchronously with the offending field rather than failing
-        # validation server-side after the round-trip.
-        if self.w_emu is not None and self.w_emu <= 0:
-            raise ValidationError(f"width must be > 0 EMU (got {self.w_emu})", "w_emu")
-        if self.h_emu is not None and self.h_emu <= 0:
-            raise ValidationError(f"height must be > 0 EMU (got {self.h_emu})", "h_emu")
+        # Server Zod schema: wEmu / hEmu are z.number().int().nonnegative() —
+        # zero is valid (OOXML a:ext cx/cy are ST_PositiveCoordinate,
+        # minInclusive=0; python-pptx accepts zero-area shapes). Only negatives
+        # are rejected, mirrored locally so they surface synchronously with the
+        # offending field rather than failing server-side after the round-trip.
+        if self.w_emu is not None and self.w_emu < 0:
+            raise ValidationError(f"width must be >= 0 EMU (got {self.w_emu})", "w_emu")
+        if self.h_emu is not None and self.h_emu < 0:
+            raise ValidationError(f"height must be >= 0 EMU (got {self.h_emu})", "h_emu")
 
 
 @dataclass
@@ -293,6 +294,10 @@ class SetParagraphStyle(Command):
     space_after_emu: Optional[int] = None
     margin_left_emu: Optional[int] = None
     indent_emu: Optional[int] = None
+    # Authored paragraph-level run defaults (python-pptx ``paragraph.font``).
+    # Keys are already wire-format camelCase (the Font style payload);
+    # the studio exports them as ``<a:pPr><a:defRPr …/></a:pPr>``.
+    default_run_style: Optional[dict] = None
 
     @property
     def command_type(self) -> str:
@@ -352,10 +357,10 @@ class AddShape(Command):
             raise ValidationError("slide_index must be non-negative", "slide_index")
         if not self.shape_type:
             raise ValidationError("shape_type is required", "shape_type")
-        if self.w_emu <= 0:
-            raise ValidationError(f"width must be > 0 EMU (got {self.w_emu})", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError(f"height must be > 0 EMU (got {self.h_emu})", "h_emu")
+        if self.w_emu < 0:
+            raise ValidationError(f"width must be >= 0 EMU (got {self.w_emu})", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError(f"height must be >= 0 EMU (got {self.h_emu})", "h_emu")
 
 
 @dataclass
@@ -492,12 +497,13 @@ class AddPicture(Command):
             raise ValidationError(
                 "image_format must be 'png', 'jpeg', 'gif', 'bmp', or 'tiff'", "image_format"
             )
-        # Server schema treats wEmu / hEmu as positive() when present (omit
-        # them entirely to fall back to the image's native size).
-        if self.w_emu is not None and self.w_emu <= 0:
-            raise ValidationError(f"width must be > 0 EMU (got {self.w_emu})", "w_emu")
-        if self.h_emu is not None and self.h_emu <= 0:
-            raise ValidationError(f"height must be > 0 EMU (got {self.h_emu})", "h_emu")
+        # Server schema treats wEmu / hEmu as nonnegative() when present (zero
+        # is allowed; omit them entirely to fall back to the image's native
+        # size). Only negatives are rejected.
+        if self.w_emu is not None and self.w_emu < 0:
+            raise ValidationError(f"width must be >= 0 EMU (got {self.w_emu})", "w_emu")
+        if self.h_emu is not None and self.h_emu < 0:
+            raise ValidationError(f"height must be >= 0 EMU (got {self.h_emu})", "h_emu")
 
 
 @dataclass
@@ -547,10 +553,10 @@ class AddOleObject(Command):
     def validate(self) -> None:
         if self.slide_index < 0:
             raise ValidationError("slide_index must be non-negative", "slide_index")
-        if self.w_emu <= 0:
-            raise ValidationError(f"width must be > 0 EMU (got {self.w_emu})", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError(f"height must be > 0 EMU (got {self.h_emu})", "h_emu")
+        if self.w_emu < 0:
+            raise ValidationError(f"width must be >= 0 EMU (got {self.w_emu})", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError(f"height must be >= 0 EMU (got {self.h_emu})", "h_emu")
         if not self.preview_base64:
             raise ValidationError("preview_base64 is required", "preview_base64")
         if self.preview_format not in ("png", "jpeg"):
@@ -635,10 +641,10 @@ class AddLinkedOleObject(Command):
     def validate(self) -> None:
         if self.slide_index < 0:
             raise ValidationError("slide_index must be non-negative", "slide_index")
-        if self.w_emu <= 0:
-            raise ValidationError(f"width must be > 0 EMU (got {self.w_emu})", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError(f"height must be > 0 EMU (got {self.h_emu})", "h_emu")
+        if self.w_emu < 0:
+            raise ValidationError(f"width must be >= 0 EMU (got {self.w_emu})", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError(f"height must be >= 0 EMU (got {self.h_emu})", "h_emu")
         if not isinstance(self.source_ref, dict) or not self.source_ref.get("id"):
             raise ValidationError(
                 "source_ref must be an AssetReference dict with an 'id' field",
@@ -730,10 +736,10 @@ class AddLinkedTable(Command):
     def validate(self) -> None:
         if self.slide_index < 0:
             raise ValidationError("slide_index must be non-negative", "slide_index")
-        if self.w_emu <= 0:
-            raise ValidationError(f"width must be > 0 EMU (got {self.w_emu})", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError(f"height must be > 0 EMU (got {self.h_emu})", "h_emu")
+        if self.w_emu < 0:
+            raise ValidationError(f"width must be >= 0 EMU (got {self.w_emu})", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError(f"height must be >= 0 EMU (got {self.h_emu})", "h_emu")
         if not isinstance(self.source_ref, dict) or not self.source_ref.get("id"):
             raise ValidationError(
                 "source_ref must be an AssetReference dict with an 'id' field",
@@ -803,10 +809,10 @@ class AddTable(Command):
             raise ValidationError("rows must be between 1 and 100", "rows")
         if self.cols < 1 or self.cols > 26:
             raise ValidationError("cols must be between 1 and 26", "cols")
-        if self.w_emu <= 0:
-            raise ValidationError(f"width must be > 0 EMU (got {self.w_emu})", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError(f"height must be > 0 EMU (got {self.h_emu})", "h_emu")
+        if self.w_emu < 0:
+            raise ValidationError(f"width must be >= 0 EMU (got {self.w_emu})", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError(f"height must be >= 0 EMU (got {self.h_emu})", "h_emu")
 
 
 @dataclass
@@ -2260,10 +2266,10 @@ class AddChart(Command):
                 f"chart_type must be one of {sorted(valid_types)}",
                 "chart_type",
             )
-        if self.w_emu <= 0:
-            raise ValidationError("w_emu must be positive", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError("h_emu must be positive", "h_emu")
+        if self.w_emu < 0:
+            raise ValidationError("w_emu must be >= 0", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError("h_emu must be >= 0", "h_emu")
         if not self.series:
             raise ValidationError("at least one series is required", "series")
         if self.grouping is not None and self.grouping not in (
@@ -2576,10 +2582,10 @@ class AddChart2016(Command):
                 f"chart_type must be one of {sorted(valid)} (got {self.chart_type!r})",
                 "chart_type",
             )
-        if self.w_emu <= 0:
-            raise ValidationError("w_emu must be positive", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError("h_emu must be positive", "h_emu")
+        if self.w_emu < 0:
+            raise ValidationError("w_emu must be >= 0", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError("h_emu must be >= 0", "h_emu")
         if not self.series:
             raise ValidationError("at least one series is required", "series")
 
@@ -2952,10 +2958,10 @@ class AddMovie(Command):
     def validate(self) -> None:
         if self.slide_index < 0:
             raise ValidationError("slide_index must be >= 0", "slide_index")
-        if self.w_emu <= 0:
-            raise ValidationError("w_emu must be positive", "w_emu")
-        if self.h_emu <= 0:
-            raise ValidationError("h_emu must be positive", "h_emu")
+        if self.w_emu < 0:
+            raise ValidationError("w_emu must be >= 0", "w_emu")
+        if self.h_emu < 0:
+            raise ValidationError("h_emu must be >= 0", "h_emu")
         # Reject empty strings — they look "set" but ship no payload.
         has_embedded = bool(self.movie_base64)
         has_url = bool(self.url)