pdfdancer-client-python 0.3.12__py3-none-any.whl → 0.3.14__py3-none-any.whl

pdfdancer/__init__.py

@@ -28,6 +28,7 @@ from .models import (
     ImageTransformRequest,
     ImageTransformType,
     Line,
+    ModifyPathRequest,
     ObjectRef,
     ObjectType,
     Orientation,
@@ -36,6 +37,7 @@ from .models import (
     Paragraph,
     Path,
     PathGroupInfo,
+    PathObjectRef,
     PathSegment,
     Point,
     Position,
@@ -53,9 +55,11 @@ from .types import PathGroupObject
 from .page_builder import PageBuilder
 from .paragraph_builder import ParagraphBuilder
 from .path_builder import BezierBuilder, LineBuilder, PathBuilder
+from ._runtime_version import resolve_package_version
 from .text_line_builder import TextLineBuilder
 
-__version__ = "0.3.12"
+__version__ = resolve_package_version()
+
 __all__ = [
     "PDFDancer",
     "ParagraphBuilder",
@@ -65,6 +69,8 @@ __all__ = [
     "LineBuilder",
     "BezierBuilder",
     "ObjectRef",
+    "PathObjectRef",
+    "ModifyPathRequest",
     "Position",
     "ObjectType",
     "Font",

pdfdancer/_runtime_version.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version as get_package_version
+from pathlib import Path
+
+
+def resolve_package_version(default: str = "0.0.0.dev0") -> str:
+    try:
+        from ._version import version
+
+        return version
+    except ImportError:
+        pass
+
+    try:
+        from setuptools_scm import get_version
+
+        return get_version(root=str(Path(__file__).resolve().parents[2]), relative_to=__file__)
+    except Exception:
+        pass
+
+    try:
+        return get_package_version("pdfdancer-client-python")
+    except PackageNotFoundError:
+        return default

pdfdancer/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.3.14'
+__version_tuple__ = version_tuple = (0, 3, 14)
+
+__commit_id__ = commit_id = None

pdfdancer/models.py

@@ -1895,3 +1895,85 @@ class ImageTransformRequest:
             result["fillColor"] = self.fill_color
 
         return result
+
+
+@dataclass
+class ModifyPathRequest:
+    """Request to modify path stroke and fill colors.
+
+    Parameters:
+    - object_ref: Reference to the path to modify.
+    - stroke_color: New stroke color (optional - null means don't change).
+    - fill_color: New fill color (optional - null means don't change).
+
+    Example:
+    ```python
+    req = ModifyPathRequest(object_ref=path_ref, stroke_color=Color(255, 0, 0), fill_color=None)
+    payload = req.to_dict()
+    ```
+    """
+
+    object_ref: ObjectRef
+    stroke_color: Optional[Color] = None
+    fill_color: Optional[Color] = None
+
+    def to_dict(self) -> dict:
+        """Convert to dictionary for JSON serialization."""
+        result: Dict[str, Any] = {
+            "ref": self.object_ref.to_dict(),
+        }
+
+        if self.stroke_color is not None:
+            result["strokeColor"] = {
+                "red": self.stroke_color.r,
+                "green": self.stroke_color.g,
+                "blue": self.stroke_color.b,
+                "alpha": self.stroke_color.a,
+            }
+
+        if self.fill_color is not None:
+            result["fillColor"] = {
+                "red": self.fill_color.r,
+                "green": self.fill_color.g,
+                "blue": self.fill_color.b,
+                "alpha": self.fill_color.a,
+            }
+
+        return result
+
+
+class PathObjectRef(ObjectRef):
+    """
+    Reference to a path object with stroke and fill color information.
+
+    Parameters (typically provided by the server):
+    - internal_id: Identifier of the path object.
+    - position: Position of the path.
+    - object_type: Should be ObjectType.PATH.
+    - stroke_color: Stroke/outline color of the path (optional).
+    - fill_color: Fill color of the path (optional).
+
+    Usage:
+    - Returned by find/snapshot APIs when querying paths.
+    - Pass to ModifyPathRequest to update path colors.
+    """
+
+    def __init__(
+        self,
+        internal_id: str,
+        position: Position,
+        object_type: ObjectType,
+        stroke_color: Optional[Color] = None,
+        fill_color: Optional[Color] = None,
+    ):
+        super().__init__(internal_id, position, object_type)
+        self.stroke_color = stroke_color
+        self.fill_color = fill_color
+
+    def get_stroke_color(self) -> Optional[Color]:
+        """Get the stroke/outline color of the path."""
+        return self.stroke_color
+
+    def get_fill_color(self) -> Optional[Color]:
+        """Get the fill color of the path."""
+        return self.fill_color

pdfdancer/pdfdancer_v1.py

@@ -14,7 +14,6 @@ import os
 import sys
 import time
 from datetime import datetime, timezone
-from importlib.metadata import version as get_package_version
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, BinaryIO, Dict, List, Mapping, Optional, Union
 
@@ -47,6 +46,7 @@ from .models import (
     FontType,
     FormFieldRef,
     Image,
+    ModifyPathRequest,
     ModifyRequest,
     ModifyTextRequest,
     MoveRequest,
@@ -58,6 +58,7 @@ from .models import (
     PageSize,
     PageSnapshot,
     Paragraph,
+    PathObjectRef,
     Position,
     PositionMode,
     RedactRequest,
@@ -72,6 +73,7 @@ from .models import (
 )
 from .page_builder import PageBuilder
 from .paragraph_builder import ParagraphPageBuilder
+from ._runtime_version import resolve_package_version
 from .types import (
     FormFieldObject,
     FormObject,
@@ -98,12 +100,8 @@ def _load_env():
 
 
 # Client identifier header for all HTTP requests
-# Always reads from installed package metadata (stays in sync with pyproject.toml)
-try:
-    CLIENT_HEADER_VALUE = f"python/{get_package_version('pdfdancer-client-python')}"
-except Exception:
-    # Fallback in case package metadata is not available
-    CLIENT_HEADER_VALUE = "python/unknown"
+# Prefer the SCM-generated version module; fall back to installed metadata.
+CLIENT_HEADER_VALUE = f"python/{resolve_package_version(default='unknown')}"
 
 # Global variable to disable SSL certificate verification
 # Set to True to skip SSL verification (useful for testing with self-signed certificates)
@@ -2755,6 +2753,38 @@ class PDFDancer:
         self._invalidate_snapshots()
         return result
 
+    def _modify_path(
+        self,
+        object_ref: ObjectRef,
+        stroke_color: Optional[Color],
+        fill_color: Optional[Color],
+    ) -> CommandResult:
+        """
+        Modifies the stroke and fill colors of a path object.
+
+        Args:
+            object_ref: Reference to the path to modify.
+            stroke_color: New stroke color (None means don't change).
+            fill_color: New fill color (None means don't change).
+
+        Returns:
+            CommandResult indicating success or failure.
+        """
+        if object_ref is None:
+            raise ValidationException("Object reference cannot be null")
+
+        request_data = ModifyPathRequest(
+            object_ref=object_ref,
+            stroke_color=stroke_color,
+            fill_color=fill_color,
+        ).to_dict()
+        response = self._make_request("PUT", "/pdf/modify/path", data=request_data)
+        result = CommandResult.from_dict(response.json())
+
+        # Invalidate snapshot caches after mutation
+        self._invalidate_snapshots()
+        return result
+
     # Font Operations
 
     def find_fonts(self, font_name: str, font_size: int) -> List[Font]:
@@ -3159,6 +3189,43 @@ class PDFDancer:
             value=obj_data["value"] if "value" in obj_data else None,
         )
 
+    def _parse_path_object_ref(self, obj_data: dict) -> PathObjectRef:
+        """Parse JSON object data into PathObjectRef instance with color information."""
+        position_data = obj_data.get("position", {})
+        position = self._parse_position(position_data) if position_data else None
+
+        object_type = ObjectType(obj_data["type"])
+
+        # Parse stroke color if present
+        stroke_color = None
+        stroke_color_data = obj_data.get("strokeColor")
+        if isinstance(stroke_color_data, dict):
+            red = stroke_color_data.get("red")
+            green = stroke_color_data.get("green")
+            blue = stroke_color_data.get("blue")
+            alpha = stroke_color_data.get("alpha", 255)
+            if all(isinstance(v, int) for v in [red, green, blue]):
+                stroke_color = Color(red, green, blue, alpha)
+
+        # Parse fill color if present
+        fill_color = None
+        fill_color_data = obj_data.get("fillColor")
+        if isinstance(fill_color_data, dict):
+            red = fill_color_data.get("red")
+            green = fill_color_data.get("green")
+            blue = fill_color_data.get("blue")
+            alpha = fill_color_data.get("alpha", 255)
+            if all(isinstance(v, int) for v in [red, green, blue]):
+                fill_color = Color(red, green, blue, alpha)
+
+        return PathObjectRef(
+            internal_id=obj_data["internalId"] if "internalId" in obj_data else None,
+            position=position,
+            object_type=object_type,
+            stroke_color=stroke_color,
+            fill_color=fill_color,
+        )
+
     @staticmethod
     def _parse_position(pos_data: dict) -> Position:
         """Parse JSON position data into Position instance."""
@@ -3473,6 +3540,9 @@ class PDFDancer:
                 ):
                     # Parse as FormFieldRef to capture name and value
                     elements.append(self._parse_form_field_ref(elem_data))
+                elif elem_type == ObjectType.PATH:
+                    # Parse as PathObjectRef to capture stroke/fill colors
+                    elements.append(self._parse_path_object_ref(elem_data))
                 else:
                     # Parse as basic ObjectRef
                     elements.append(self._parse_object_ref(elem_data))
@@ -3526,9 +3596,7 @@ class PDFDancer:
             self._client.close()
 
     def _to_path_objects(self, refs: List[ObjectRef]) -> List[PathObject]:
-        return [
-            PathObject(self, ref.internal_id, ref.type, ref.position) for ref in refs
-        ]
+        return [PathObject(self, ref) for ref in refs]
 
     def _to_paragraph_objects(self, refs: List[TextObjectRef]) -> List[ParagraphObject]:
         return [ParagraphObject(self, ref) for ref in refs]

pdfdancer/types.py

@@ -4,7 +4,7 @@ import sys
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Optional
 
-from . import FormFieldRef, ObjectRef, ObjectType, Point, Position, TextObjectRef
+from . import FormFieldRef, ObjectRef, ObjectType, PathObjectRef, Point, Position, TextObjectRef
 from .exceptions import ValidationException
 
 if TYPE_CHECKING:
@@ -86,11 +86,44 @@ class PDFObjectBase:
 class PathObject(PDFObjectBase):
     """Represents a vector path object inside a PDF page."""
 
+    def __init__(self, client: "PDFDancer", object_ref):
+        """
+        Initialize a PathObject.
+
+        Args:
+            client: PDFDancer client instance
+            object_ref: ObjectRef or PathObjectRef with path data
+        """
+        super().__init__(
+            client, object_ref.internal_id, object_ref.type, object_ref.position
+        )
+        self._object_ref = object_ref
+
     @property
     def bounding_box(self) -> Optional[BoundingRect]:
         """Optional bounding rectangle (if available)."""
         return self.position.bounding_rect
 
+    def edit(self) -> PathEditSession:
+        """Start a fluent editing session to modify path colors."""
+        return PathEditSession(self._client, self.object_ref())
+
+    def object_ref(self):
+        """Return an ObjectRef for this path."""
+        return self._object_ref
+
+    def get_stroke_color(self) -> Optional["Color"]:
+        """Get the stroke/outline color of the path, or None if not set."""
+        if isinstance(self._object_ref, PathObjectRef):
+            return self._object_ref.get_stroke_color()
+        return None
+
+    def get_fill_color(self) -> Optional["Color"]:
+        """Get the fill color of the path, or None if not set."""
+        if isinstance(self._object_ref, PathObjectRef):
+            return self._object_ref.get_fill_color()
+        return None
+
     def __eq__(self, other):
         if not isinstance(other, PathObject):
             return False
@@ -748,3 +781,61 @@ class FormFieldObject(PDFObjectBase):
             and self.name == other.name
             and self.value == other.value
         )
+
+
+class PathEditSession:
+    """
+    Fluent editing helper for modifying path stroke and fill colors.
+    """
+
+    def __init__(self, client: "PDFDancer", object_ref):
+        self._client = client
+        self._object_ref = object_ref
+        self._stroke_color = None
+        self._fill_color = None
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if exc_type:
+            return False
+        self.apply()
+        return False
+
+    def stroke_color(self, color) -> "PathEditSession":
+        """
+        Set the stroke/outline color.
+
+        Args:
+            color: The stroke color (Color object)
+
+        Returns:
+            Self for method chaining
+        """
+        self._stroke_color = color
+        return self
+
+    def fill_color(self, color) -> "PathEditSession":
+        """
+        Set the fill color.
+
+        Args:
+            color: The fill color (Color object)
+
+        Returns:
+            Self for method chaining
+        """
+        self._fill_color = color
+        return self
+
+    def apply(self):
+        """
+        Apply the color modifications to the path.
+
+        Returns:
+            CommandResult indicating success or failure
+        """
+        return self._client._modify_path(
+            self._object_ref, self._stroke_color, self._fill_color
+        )

{pdfdancer_client_python-0.3.12.dist-info → pdfdancer_client_python-0.3.14.dist-info}/METADATA

@@ -1,218 +1,15 @@
 Metadata-Version: 2.4
 Name: pdfdancer-client-python
-Version: 0.3.12
+Version: 0.3.14
 Summary: Python client for PDFDancer API
 Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
-License: 
-                                         Apache License
-                                   Version 2.0, January 2004
-                                http://www.apache.org/licenses/
-        
-           TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-        
-           1. Definitions.
-        
-              "License" shall mean the terms and conditions for use, reproduction,
-              and distribution as defined by Sections 1 through 9 of this document.
-        
-              "Licensor" shall mean the copyright owner or entity authorized by
-              the copyright owner that is granting the License.
-        
-              "Legal Entity" shall mean the union of the acting entity and all
-              other entities that control, are controlled by, or are under common
-              control with that entity. For the purposes of this definition,
-              "control" means (i) the power, direct or indirect, to cause the
-              direction or management of such entity, whether by contract or
-              otherwise, or (ii) ownership of fifty percent (50%) or more of the
-              outstanding shares, or (iii) beneficial ownership of such entity.
-        
-              "You" (or "Your") shall mean an individual or Legal Entity
-              exercising permissions granted by this License.
-        
-              "Source" form shall mean the preferred form for making modifications,
-              including but not limited to software source code, documentation
-              source, and configuration files.
-        
-              "Object" form shall mean any form resulting from mechanical
-              transformation or translation of a Source form, including but
-              not limited to compiled object code, generated documentation,
-              and conversions to other media types.
-        
-              "Work" shall mean the work of authorship, whether in Source or
-              Object form, made available under the License, as indicated by a
-              copyright notice that is included in or attached to the work
-              (an example is provided in the Appendix below).
-        
-              "Derivative Works" shall mean any work, whether in Source or Object
-              form, that is based on (or derived from) the Work and for which the
-              editorial revisions, annotations, elaborations, or other modifications
-              represent, as a whole, an original work of authorship. For the purposes
-              of this License, Derivative Works shall not include works that remain
-              separable from, or merely link (or bind by name) to the interfaces of,
-              the Work and Derivative Works thereof.
-        
-              "Contribution" shall mean any work of authorship, including
-              the original version of the Work and any modifications or additions
-              to that Work or Derivative Works thereof, that is intentionally
-              submitted to Licensor for inclusion in the Work by the copyright owner
-              or by an individual or Legal Entity authorized to submit on behalf of
-              the copyright owner. For the purposes of this definition, "submitted"
-              means any form of electronic, verbal, or written communication sent
-              to the Licensor or its representatives, including but not limited to
-              communication on electronic mailing lists, source code control systems,
-              and issue tracking systems that are managed by, or on behalf of, the
-              Licensor for the purpose of discussing and improving the Work, but
-              excluding communication that is conspicuously marked or otherwise
-              designated in writing by the copyright owner as "Not a Contribution."
-        
-              "Contributor" shall mean Licensor and any individual or Legal Entity
-              on behalf of whom a Contribution has been received by Licensor and
-              subsequently incorporated within the Work.
-        
-           2. Grant of Copyright License. Subject to the terms and conditions of
-              this License, each Contributor hereby grants to You a perpetual,
-              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-              copyright license to reproduce, prepare Derivative Works of,
-              publicly display, publicly perform, sublicense, and distribute the
-              Work and such Derivative Works in Source or Object form.
-        
-           3. Grant of Patent License. Subject to the terms and conditions of
-              this License, each Contributor hereby grants to You a perpetual,
-              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-              (except as stated in this section) patent license to make, have made,
-              use, offer to sell, sell, import, and otherwise transfer the Work,
-              where such license applies only to those patent claims licensable
-              by such Contributor that are necessarily infringed by their
-              Contribution(s) alone or by combination of their Contribution(s)
-              with the Work to which such Contribution(s) was submitted. If You
-              institute patent litigation against any entity (including a
-              cross-claim or counterclaim in a lawsuit) alleging that the Work
-              or a Contribution incorporated within the Work constitutes direct
-              or contributory patent infringement, then any patent licenses
-              granted to You under this License for that Work shall terminate
-              as of the date such litigation is filed.
-        
-           4. Redistribution. You may reproduce and distribute copies of the
-              Work or Derivative Works thereof in any medium, with or without
-              modifications, and in Source or Object form, provided that You
-              meet the following conditions:
-        
-              (a) You must give any other recipients of the Work or
-                  Derivative Works a copy of this License; and
-        
-              (b) You must cause any modified files to carry prominent notices
-                  stating that You changed the files; and
-        
-              (c) You must retain, in the Source form of any Derivative Works
-                  that You distribute, all copyright, patent, trademark, and
-                  attribution notices from the Source form of the Work,
-                  excluding those notices that do not pertain to any part of
-                  the Derivative Works; and
-        
-              (d) If the Work includes a "NOTICE" text file as part of its
-                  distribution, then any Derivative Works that You distribute must
-                  include a readable copy of the attribution notices contained
-                  within such NOTICE file, excluding those notices that do not
-                  pertain to any part of the Derivative Works, in at least one
-                  of the following places: within a NOTICE text file distributed
-                  as part of the Derivative Works; within the Source form or
-                  documentation, if provided along with the Derivative Works; or,
-                  within a display generated by the Derivative Works, if and
-                  wherever such third-party notices normally appear. The contents
-                  of the NOTICE file are for informational purposes only and
-                  do not modify the License. You may add Your own attribution
-                  notices within Derivative Works that You distribute, alongside
-                  or as an addendum to the NOTICE text from the Work, provided
-                  that such additional attribution notices cannot be construed
-                  as modifying the License.
-        
-              You may add Your own copyright statement to Your modifications and
-              may provide additional or different license terms and conditions
-              for use, reproduction, or distribution of Your modifications, or
-              for any such Derivative Works as a whole, provided Your use,
-              reproduction, and distribution of the Work otherwise complies with
-              the conditions stated in this License.
-        
-           5. Submission of Contributions. Unless You explicitly state otherwise,
-              any Contribution intentionally submitted for inclusion in the Work
-              by You to the Licensor shall be under the terms and conditions of
-              this License, without any additional terms or conditions.
-              Notwithstanding the above, nothing herein shall supersede or modify
-              the terms of any separate license agreement you may have executed
-              with Licensor regarding such Contributions.
-        
-           6. Trademarks. This License does not grant permission to use the trade
-              names, trademarks, service marks, or product names of the Licensor,
-              except as required for reasonable and customary use in describing the
-              origin of the Work and reproducing the content of the NOTICE file.
-        
-           7. Disclaimer of Warranty. Unless required by applicable law or
-              agreed to in writing, Licensor provides the Work (and each
-              Contributor provides its Contributions) on an "AS IS" BASIS,
-              WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-              implied, including, without limitation, any warranties or conditions
-              of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-              PARTICULAR PURPOSE. You are solely responsible for determining the
-              appropriateness of using or redistributing the Work and assume any
-              risks associated with Your exercise of permissions under this License.
-        
-           8. Limitation of Liability. In no event and under no legal theory,
-              whether in tort (including negligence), contract, or otherwise,
-              unless required by applicable law (such as deliberate and grossly
-              negligent acts) or agreed to in writing, shall any Contributor be
-              liable to You for damages, including any direct, indirect, special,
-              incidental, or consequential damages of any character arising as a
-              result of this License or out of the use or inability to use the
-              Work (including but not limited to damages for loss of goodwill,
-              work stoppage, computer failure or malfunction, or any and all
-              other commercial damages or losses), even if such Contributor
-              has been advised of the possibility of such damages.
-        
-           9. Accepting Warranty or Additional Liability. While redistributing
-              the Work or Derivative Works thereof, You may choose to offer,
-              and charge a fee for, acceptance of support, warranty, indemnity,
-              or other liability obligations and/or rights consistent with this
-              License. However, in accepting such obligations, You may act only
-              on Your own behalf and on Your sole responsibility, not on behalf
-              of any other Contributor, and only if You agree to indemnify,
-              defend, and hold each Contributor harmless for any liability
-              incurred by, or claims asserted against, such Contributor by reason
-              of your accepting any such warranty or additional liability.
-        
-           END OF TERMS AND CONDITIONS
-        
-           APPENDIX: How to apply the Apache License to your work.
-        
-              To apply the Apache License to your work, attach the following
-              boilerplate notice, with the fields enclosed by brackets "[]"
-              replaced with your own identifying information. (Don't include
-              the brackets!)  The text should be enclosed in the appropriate
-              comment syntax for the file format. We also recommend that a
-              file or class name and description of purpose be included on the
-              same "printed page" as the copyright notice for easier
-              identification within third-party archives.
-        
-           Copyright [yyyy] [name of copyright owner]
-        
-           Licensed under the Apache License, Version 2.0 (the "License");
-           you may not use this file except in compliance with the License.
-           You may obtain a copy of the License at
-        
-               http://www.apache.org/licenses/LICENSE-2.0
-        
-           Unless required by applicable law or agreed to in writing, software
-           distributed under the License is distributed on an "AS IS" BASIS,
-           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-           See the License for the specific language governing permissions and
-           limitations under the License.
-        
+License-Expression: Apache-2.0
 Project-URL: Homepage, https://www.pdfdancer.com/
 Project-URL: Documentation, https://www.pdfdancer.com/
 Project-URL: Source, https://github.com/MenschMachine/pdfdancer-client-python
 Project-URL: Issues, https://github.com/MenschMachine/pdfdancer-client-python/issues
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -567,20 +364,16 @@ python -m build
 python -m twine check dist/*
 ```
 
-Artifacts will be created in the `dist/` directory.
+Artifacts will be created in the `dist/` directory. Package versions are derived from Git tags via `setuptools-scm`.
 
 #### Publishing to PyPI
 
 Releases are published automatically to PyPI when a `v*` tag is pushed to GitHub (via GitHub Actions with Trusted Publishers).
 
 ```bash
-# Set version, commit, and push tag — GitHub Actions handles the rest
-python release.py tag --version 1.1.0
-
-# Or manually:
-# 1. Update version in pyproject.toml and src/pdfdancer/__init__.py
-# 2. Commit
-# 3. git tag v1.1.0 && git push origin HEAD && git push origin v1.1.0
+# Create and push a release tag — GitHub Actions handles the rest
+git tag v1.1.0
+git push origin v1.1.0
 ```
 
 #### Code Quality
@@ -619,7 +412,6 @@ pdfdancer-client-python/
 ├── docs/                    # Documentation
 ├── dist/                    # Build artifacts (created after packaging)
 ├── pyproject.toml           # Project metadata and dependencies
-├── release.py               # Helper for publishing releases
 └── README.md                # This file
 ```
 

pdfdancer_client_python-0.3.14.dist-info/RECORD

@@ -0,0 +1,19 @@
+pdfdancer/__init__.py,sha256=ETo-K0UiwHeQQJ3Lv06LAiTPNnTTSzJ-k1mU0tAtw7Y,3044
+pdfdancer/_runtime_version.py,sha256=SJGvQbmWWxQaCqx2vZ5IWRMdWe57edppwdYF60A8yEM,637
+pdfdancer/_version.py,sha256=-NzTse0Be4JnSSH5i0wPIIMS2UT8sttDmuD157cQSqc,522
+pdfdancer/exceptions.py,sha256=U6kD3NvcdNt05_OU11Tml5dXGtlodEtYC9zcV4fHXkc,2270
+pdfdancer/fingerprint.py,sha256=eL3PHPgv-knMya7s95RXg3qzzpkAA1aevxqb6tuOb34,3061
+pdfdancer/image_builder.py,sha256=aBxMFAMFzzbGTjlVH0hi94mA81cH8tp37Pk84HRPV00,1892
+pdfdancer/models.py,sha256=D8v42xWAqXQ7-q3gjpb5z5Gd3dxvjc0NE779Gd2-fBE,62964
+pdfdancer/page_builder.py,sha256=ARWLRtlrLGbES-0nbiigTOsRVmodRX0DNK8YIAkA9Ig,3850
+pdfdancer/paragraph_builder.py,sha256=OmhzYazMnq0n0rhrjWcKbo0LQfEC7BZoiLB29ycF630,20504
+pdfdancer/path_builder.py,sha256=safKb_IeHRWlQbyBTIXfcoBfXxUZhuzYvBIob5Tbp-8,23938
+pdfdancer/pdfdancer_v1.py,sha256=6GdhZ0EhnvlO0YPtivN3w5JNa9O5lJZiqN4SnBQoEP0,141075
+pdfdancer/text_line_builder.py,sha256=8jYknV4hw0fyzwX0OI_oLvnh5aMmCV3jXaVkmYLu6MQ,10273
+pdfdancer/types.py,sha256=GNThFde9dRloHB482nu3txhYc9wysI244cM1D7L8fa4,27501
+pdfdancer_client_python-0.3.14.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+pdfdancer_client_python-0.3.14.dist-info/licenses/NOTICE,sha256=xaC4l-IChAmtViNDie8ZWzUk0O6XRMyzOl0zLmVZ2HE,232
+pdfdancer_client_python-0.3.14.dist-info/METADATA,sha256=qRK84X0ImUwbIv105Kw1C1LogyvZV_-BACnXlUlxo8s,15567
+pdfdancer_client_python-0.3.14.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pdfdancer_client_python-0.3.14.dist-info/top_level.txt,sha256=ICwSVRpcCKrdBF9QlaX9Y0e_N3Nk1p7QVxadGOnbxeY,10
+pdfdancer_client_python-0.3.14.dist-info/RECORD,,

pdfdancer_client_python-0.3.12.dist-info/RECORD

@@ -1,17 +0,0 @@
-pdfdancer/__init__.py,sha256=DiYQ2gDQ4kYu8eUXc7Z-0vgdoeBi0Cek5jusrq0LYVE,2884
-pdfdancer/exceptions.py,sha256=U6kD3NvcdNt05_OU11Tml5dXGtlodEtYC9zcV4fHXkc,2270
-pdfdancer/fingerprint.py,sha256=eL3PHPgv-knMya7s95RXg3qzzpkAA1aevxqb6tuOb34,3061
-pdfdancer/image_builder.py,sha256=aBxMFAMFzzbGTjlVH0hi94mA81cH8tp37Pk84HRPV00,1892
-pdfdancer/models.py,sha256=nrR8ssEIz7BttWCMv7F0oriTego5Jh-h-34GvJmoni8,60462
-pdfdancer/page_builder.py,sha256=ARWLRtlrLGbES-0nbiigTOsRVmodRX0DNK8YIAkA9Ig,3850
-pdfdancer/paragraph_builder.py,sha256=OmhzYazMnq0n0rhrjWcKbo0LQfEC7BZoiLB29ycF630,20504
-pdfdancer/path_builder.py,sha256=safKb_IeHRWlQbyBTIXfcoBfXxUZhuzYvBIob5Tbp-8,23938
-pdfdancer/pdfdancer_v1.py,sha256=JaiB47v_zgUwb7OtnmnVDt4jroxB5Bh6sGQpAU8ZIBg,138359
-pdfdancer/text_line_builder.py,sha256=8jYknV4hw0fyzwX0OI_oLvnh5aMmCV3jXaVkmYLu6MQ,10273
-pdfdancer/types.py,sha256=w0dJ6JcHgm62BFDzZTx7v10GymjNaZw8x8lKfg-U2zA,24949
-pdfdancer_client_python-0.3.12.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-pdfdancer_client_python-0.3.12.dist-info/licenses/NOTICE,sha256=xaC4l-IChAmtViNDie8ZWzUk0O6XRMyzOl0zLmVZ2HE,232
-pdfdancer_client_python-0.3.12.dist-info/METADATA,sha256=8uO4RQWyE64otUm9cY_Vj9gZsBH5-JpajgDcvijv_JM,28756
-pdfdancer_client_python-0.3.12.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-pdfdancer_client_python-0.3.12.dist-info/top_level.txt,sha256=ICwSVRpcCKrdBF9QlaX9Y0e_N3Nk1p7QVxadGOnbxeY,10
-pdfdancer_client_python-0.3.12.dist-info/RECORD,,