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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: athena-python-pptx
-Version: 0.4.2
+Version: 0.4.3
 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

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

@@ -133,7 +133,7 @@ def flush_all() -> None:
     _active_buffers[:] = alive
 
 
-__version__ = "0.4.2"
+__version__ = "0.4.3"
 
 __all__ = [
     # Main entry point

{athena_python_pptx-0.4.2 → athena_python_pptx-0.4.3}/pptx/dml/color.py

@@ -50,6 +50,50 @@ def theme_color_to_scheme_name(theme_color: "MSO_THEME_COLOR") -> Optional[str]:
     return _THEME_COLOR_TO_SCHEME_NAME.get(value)
 
 
+# Reverse of ``_THEME_COLOR_TO_SCHEME_NAME`` for the read path: map an OOXML
+# ``<a:schemeClr val="...">`` name back to its canonical ``MSO_THEME_COLOR``.
+# The forward map is many-to-one (both DARK_1 and TEXT_1 spell 'tx1'); on the
+# way back python-pptx surfaces the index-13..16 spellings for the bg*/tx*
+# names (TEXT_1/BACKGROUND_1/TEXT_2/BACKGROUND_2) and the dk*/lt* aliases for
+# DARK_1/LIGHT_1/DARK_2/LIGHT_2, which is what we reproduce here.
+_SCHEME_NAME_TO_THEME_COLOR = {
+    "tx1": 13,       # TEXT_1
+    "bg1": 14,       # BACKGROUND_1
+    "tx2": 16,       # TEXT_2
+    "bg2": 15,       # BACKGROUND_2
+    "dk1": 1,        # DARK_1
+    "lt1": 2,        # LIGHT_1
+    "dk2": 3,        # DARK_2
+    "lt2": 4,        # LIGHT_2
+    "accent1": 5,
+    "accent2": 6,
+    "accent3": 7,
+    "accent4": 8,
+    "accent5": 9,
+    "accent6": 10,
+    "hlink": 11,     # HYPERLINK
+    "folHlink": 12,  # FOLLOWED_HYPERLINK
+}
+
+
+def scheme_name_to_theme_color(scheme_name: Optional[str]) -> Optional["MSO_THEME_COLOR"]:
+    """Convert an OOXML ``<a:schemeClr>`` name back to an ``MSO_THEME_COLOR``.
+
+    Inverse of :func:`theme_color_to_scheme_name`, used by the read path so a
+    re-opened deck exposes ``fill.fore_color.theme_color`` /
+    ``line.color.theme_color`` instead of ``None``. Returns ``None`` for
+    unknown names (e.g. ``phClr``) so callers fall back to sRGB.
+    """
+    if not scheme_name:
+        return None
+    value = _SCHEME_NAME_TO_THEME_COLOR.get(scheme_name)
+    if value is None:
+        return None
+    from ..enum.dml import MSO_THEME_COLOR
+
+    return MSO_THEME_COLOR(value)
+
+
 class RGBColor:
     """
     Immutable RGB color value, matching the standard python-pptx API.

{athena_python_pptx-0.4.2 → athena_python_pptx-0.4.3}/pptx/shapes/__init__.py

@@ -635,11 +635,27 @@ class FillFormat:
     def __init__(self, shape: Shape):
         self._shape = shape
         self._solid_color: Optional[str] = shape._properties.get("fillColorHex")
+        # Scheme (theme) fill read back from the snapshot. Initializing it here
+        # (rather than only in ``_on_color_change``) both fixes a latent
+        # AttributeError when ``_scheme_color`` is read before any write and
+        # lets a re-opened theme-colored fill round-trip on re-export.
+        self._scheme_color: Optional[str] = shape._properties.get("fillSchemeColor")
         self._transparency: float = 0.0
-        self._type: Optional[str] = 'solid' if self._solid_color else None
+        # A scheme fill with no explicit sRGB is still a solid fill.
+        self._type: Optional[str] = 'solid' if (self._solid_color or self._scheme_color) else None
         # Initialize fore_color ColorFormat
         rgb = RGBColor.from_string(self._solid_color) if self._solid_color else None
         self._fore_color_format = _FillColorFormat(self, rgb=rgb)
+        # Surface ``fore_color.theme_color`` for a scheme fill (no sRGB hex) so
+        # the agent "restyle a deck I just opened" workflow reads back the theme
+        # color instead of None. Set the attribute directly to avoid triggering
+        # the setter's write-emit on a pure read.
+        if self._scheme_color and not self._solid_color:
+            from ..dml.color import scheme_name_to_theme_color
+
+            theme = scheme_name_to_theme_color(self._scheme_color)
+            if theme is not None:
+                self._fore_color_format._theme_color = theme
 
     def solid(self) -> None:
         """
@@ -940,11 +956,25 @@ class LineFormat:
     def __init__(self, shape: Shape):
         self._shape = shape
         self._color_hex: Optional[str] = shape._properties.get("strokeColorHex")
+        # Scheme (theme) line color; initialized here so it round-trips and so
+        # the setters that reference ``_scheme_color`` never hit an
+        # AttributeError on a fresh read.
+        self._scheme_color: Optional[str] = shape._properties.get("strokeSchemeColor")
         self._width_emu: int = shape._properties.get("strokeWidthEmu", 12700)  # Default 1pt
-        self._dash_style: str = 'solid'
+        # Read the persisted dash style back (defaults to solid) so a re-opened
+        # deck exposes ``line.dash_style`` instead of always 'solid'. The Y.Doc
+        # and SDK share the same dash vocabulary, so no mapping is needed.
+        self._dash_style: str = shape._properties.get("strokeDashStyle") or 'solid'
         # Initialize color ColorFormat
         rgb = RGBColor.from_string(self._color_hex) if self._color_hex else None
         self._color_format = _LineColorFormat(self, rgb=rgb)
+        # Surface ``color.theme_color`` for a scheme line color (no sRGB hex).
+        if self._scheme_color and not self._color_hex:
+            from ..dml.color import scheme_name_to_theme_color
+
+            theme = scheme_name_to_theme_color(self._scheme_color)
+            if theme is not None:
+                self._color_format._theme_color = theme
 
     @property
     def color(self) -> _LineColorFormat:

{athena_python_pptx-0.4.2 → athena_python_pptx-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "athena-python-pptx"
-version = "0.4.2"
+version = "0.4.3"
 description = "Drop-in replacement for python-pptx that connects to PPTX Studio for real-time collaboration"
 readme = "README.md"
 license = "MIT"

{athena_python_pptx-0.4.2 → athena_python_pptx-0.4.3}/uv.lock

@@ -49,7 +49,7 @@ wheels = [
 
 [[package]]
 name = "athena-python-pptx"
-version = "0.4.2"
+version = "0.4.3"
 source = { editable = "." }
 dependencies = [
     { name = "requests" },
@@ -338,7 +338,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [