pdfdancer-client-python 0.2.14__tar.gz → 0.2.16__tar.gz

pdfdancer_client_python-0.2.16/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: pdfdancer-client-python
+Version: 0.2.16
+Summary: Python client for PDFDancer API
+Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
+License: MIT
+Project-URL: Homepage, https://www.pdfdancer.com/
+Project-URL: Repository, https://github.com/MenschMachine/pdfdancer-client-python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pydantic>=1.8.0
+Requires-Dist: typing-extensions>=4.0.0
+Requires-Dist: python-dotenv>=0.19.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: flake8>=5.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: build>=0.8.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+
+# PDFDancer Python Client
+
+**Getting Started with PDFDancer**
+
+PDFDancer gives you pixel-perfect programmatic control over any PDF document from Python. Locate existing elements by
+coordinates or text, adjust them precisely, add brand-new content, and ship the modified PDF in memory or on disk. The
+same API is also available for TypeScript and Java, so teams can orchestrate identical PDF workflows across stacks.
+
+> Need the raw API schema? The latest OpenAPI description lives in `docs/openapi.yml` and is published at
+> https://bucket.pdfdancer.com/api-doc/development-0.0.yml.
+
+## Highlights
+
+- Locate paragraphs, text lines, images, vector paths, form fields, and pages by index, coordinates, or text prefixes.
+- Edit existing content in place with fluent editors and context managers that apply changes safely.
+- Programmatically control third-party PDFs—modify invoices, contracts, and reports you did not author.
+- Add content with precise XY positioning using paragraph and image builders, custom fonts, and color helpers.
+- Export results as bytes for downstream processing or save directly to disk with one call.
+
+## What Makes PDFDancer Different
+
+- **Edit any PDF**: Work with documents from customers, governments, or vendors—not just ones you generated.
+- **Pixel-perfect positioning**: Move or add elements at exact coordinates and keep the original layout intact.
+- **Surgical text replacement**: Swap or rewrite paragraphs without reflowing the rest of the page.
+- **Form manipulation**: Inspect, fill, and update AcroForm fields programmatically.
+- **Coordinate-based selection**: Select objects by position, bounding box, or text patterns.
+- **Real PDF editing**: Modify the underlying PDF structure instead of merely stamping overlays.
+
+## Installation
+
+```bash
+pip install pdfdancer-client-python
+
+# Editable install for local development
+pip install -e .
+```
+
+Requires Python 3.10+ and a PDFDancer API token.
+
+## Quick Start — Edit an Existing PDF
+
+```python
+from pathlib import Path
+from pdfdancer import Color, PDFDancer, StandardFonts
+
+with PDFDancer.open(
+    pdf_data=Path("input.pdf"),
+    token="your-api-token",             # optional when PDFDANCER_TOKEN is set
+    base_url="https://api.pdfdancer.com",
+) as pdf:
+    # Locate and update an existing paragraph
+    heading = pdf.page(0).select_paragraphs_starting_with("Executive Summary")[0]
+    heading.move_to(72, 680)
+    with heading.edit() as editor:
+        editor.replace("Overview")
+
+    # Add a new paragraph with precise placement
+    pdf.new_paragraph() \
+        .text("Generated with PDFDancer") \
+        .font(StandardFonts.HELVETICA, 12) \
+        .color(Color(70, 70, 70)) \
+        .line_spacing(1.4) \
+        .at(page_index=0, x=72, y=520) \
+        .add()
+
+    # Persist the modified document
+    pdf.save("output.pdf")
+    # or keep it in memory
+    pdf_bytes = pdf.get_bytes()
+```
+
+## Create a Blank PDF
+
+```python
+from pathlib import Path
+from pdfdancer import Color, PDFDancer, StandardFonts
+
+with PDFDancer.new(token="your-api-token") as pdf:
+    pdf.new_paragraph() \
+        .text("Quarterly Summary") \
+        .font(StandardFonts.TIMES_BOLD, 18) \
+        .color(Color(10, 10, 80)) \
+        .line_spacing(1.2) \
+        .at(page_index=0, x=72, y=730) \
+        .add()
+
+    pdf.new_image() \
+        .from_file(Path("logo.png")) \
+        .at(page=0, x=420, y=710) \
+        .add()
+
+    pdf.save("summary.pdf")
+```
+
+## Work with Forms and Layout
+
+```python
+from pdfdancer import PDFDancer
+
+with PDFDancer.open("contract.pdf") as pdf:
+    # Inspect global document structure
+    pages = pdf.pages()
+    print("Total pages:", len(pages))
+
+    # Update form fields
+    signature = pdf.select_form_fields_by_name("signature")[0]
+    signature.edit().value("Signed by Jane Doe").apply()
+
+    # Trim or move content at specific coordinates
+    images = pdf.page(1).select_images()
+    for image in images:
+        x = image.position.x()
+        if x is not None and x < 100:
+            image.delete()
+```
+
+Selectors return typed objects (`ParagraphObject`, `TextLineObject`, `ImageObject`, `FormFieldObject`, `PageClient`, …)
+with helpers such as `delete()`, `move_to(x, y)`, or `edit()` depending on the object type.
+
+## Configuration
+
+- Set `PDFDANCER_TOKEN` for authentication (preferred for local development and CI).
+- Override the API host with `PDFDANCER_BASE_URL` (e.g., sandbox environments).
+- Tune HTTP read timeouts via the `timeout` argument on `PDFDancer.open()` and `PDFDancer.new()`.
+
+## Error Handling
+
+Operations raise subclasses of `PdfDancerException`:
+
+- `ValidationException`: input validation problems (missing token, invalid coordinates, etc.).
+- `FontNotFoundException`: requested font unavailable on the service.
+- `HttpClientException`: transport or server errors with detailed context.
+- `SessionException`: session creation and lifecycle failures.
+
+Wrap automated workflows in `try/except` blocks to surface actionable errors to your users.
+
+## Development
+
+```bash
+python -m venv venv
+source venv/bin/activate            # Windows: venv\Scripts\activate
+pip install -e ".[dev]"
+
+pytest -q                           # unit suite
+pytest tests/e2e                    # integration tests (requires live API + fixtures)
+python -m build                     # produce distribution artifacts
+```
+
+Releases are published with `python release.py`. Contributions are welcome via pull request.
+
+## Related SDKs
+
+- TypeScript client: https://github.com/MenschMachine/pdfdancer-client-js
+- Java client: https://github.com/MenschMachine/pdfdancer-client-java
+
+## License
+
+MIT © The Famous Cat Ltd.

pdfdancer_client_python-0.2.16/README.md

@@ -0,0 +1,158 @@
+# PDFDancer Python Client
+
+**Getting Started with PDFDancer**
+
+PDFDancer gives you pixel-perfect programmatic control over any PDF document from Python. Locate existing elements by
+coordinates or text, adjust them precisely, add brand-new content, and ship the modified PDF in memory or on disk. The
+same API is also available for TypeScript and Java, so teams can orchestrate identical PDF workflows across stacks.
+
+> Need the raw API schema? The latest OpenAPI description lives in `docs/openapi.yml` and is published at
+> https://bucket.pdfdancer.com/api-doc/development-0.0.yml.
+
+## Highlights
+
+- Locate paragraphs, text lines, images, vector paths, form fields, and pages by index, coordinates, or text prefixes.
+- Edit existing content in place with fluent editors and context managers that apply changes safely.
+- Programmatically control third-party PDFs—modify invoices, contracts, and reports you did not author.
+- Add content with precise XY positioning using paragraph and image builders, custom fonts, and color helpers.
+- Export results as bytes for downstream processing or save directly to disk with one call.
+
+## What Makes PDFDancer Different
+
+- **Edit any PDF**: Work with documents from customers, governments, or vendors—not just ones you generated.
+- **Pixel-perfect positioning**: Move or add elements at exact coordinates and keep the original layout intact.
+- **Surgical text replacement**: Swap or rewrite paragraphs without reflowing the rest of the page.
+- **Form manipulation**: Inspect, fill, and update AcroForm fields programmatically.
+- **Coordinate-based selection**: Select objects by position, bounding box, or text patterns.
+- **Real PDF editing**: Modify the underlying PDF structure instead of merely stamping overlays.
+
+## Installation
+
+```bash
+pip install pdfdancer-client-python
+
+# Editable install for local development
+pip install -e .
+```
+
+Requires Python 3.10+ and a PDFDancer API token.
+
+## Quick Start — Edit an Existing PDF
+
+```python
+from pathlib import Path
+from pdfdancer import Color, PDFDancer, StandardFonts
+
+with PDFDancer.open(
+    pdf_data=Path("input.pdf"),
+    token="your-api-token",             # optional when PDFDANCER_TOKEN is set
+    base_url="https://api.pdfdancer.com",
+) as pdf:
+    # Locate and update an existing paragraph
+    heading = pdf.page(0).select_paragraphs_starting_with("Executive Summary")[0]
+    heading.move_to(72, 680)
+    with heading.edit() as editor:
+        editor.replace("Overview")
+
+    # Add a new paragraph with precise placement
+    pdf.new_paragraph() \
+        .text("Generated with PDFDancer") \
+        .font(StandardFonts.HELVETICA, 12) \
+        .color(Color(70, 70, 70)) \
+        .line_spacing(1.4) \
+        .at(page_index=0, x=72, y=520) \
+        .add()
+
+    # Persist the modified document
+    pdf.save("output.pdf")
+    # or keep it in memory
+    pdf_bytes = pdf.get_bytes()
+```
+
+## Create a Blank PDF
+
+```python
+from pathlib import Path
+from pdfdancer import Color, PDFDancer, StandardFonts
+
+with PDFDancer.new(token="your-api-token") as pdf:
+    pdf.new_paragraph() \
+        .text("Quarterly Summary") \
+        .font(StandardFonts.TIMES_BOLD, 18) \
+        .color(Color(10, 10, 80)) \
+        .line_spacing(1.2) \
+        .at(page_index=0, x=72, y=730) \
+        .add()
+
+    pdf.new_image() \
+        .from_file(Path("logo.png")) \
+        .at(page=0, x=420, y=710) \
+        .add()
+
+    pdf.save("summary.pdf")
+```
+
+## Work with Forms and Layout
+
+```python
+from pdfdancer import PDFDancer
+
+with PDFDancer.open("contract.pdf") as pdf:
+    # Inspect global document structure
+    pages = pdf.pages()
+    print("Total pages:", len(pages))
+
+    # Update form fields
+    signature = pdf.select_form_fields_by_name("signature")[0]
+    signature.edit().value("Signed by Jane Doe").apply()
+
+    # Trim or move content at specific coordinates
+    images = pdf.page(1).select_images()
+    for image in images:
+        x = image.position.x()
+        if x is not None and x < 100:
+            image.delete()
+```
+
+Selectors return typed objects (`ParagraphObject`, `TextLineObject`, `ImageObject`, `FormFieldObject`, `PageClient`, …)
+with helpers such as `delete()`, `move_to(x, y)`, or `edit()` depending on the object type.
+
+## Configuration
+
+- Set `PDFDANCER_TOKEN` for authentication (preferred for local development and CI).
+- Override the API host with `PDFDANCER_BASE_URL` (e.g., sandbox environments).
+- Tune HTTP read timeouts via the `timeout` argument on `PDFDancer.open()` and `PDFDancer.new()`.
+
+## Error Handling
+
+Operations raise subclasses of `PdfDancerException`:
+
+- `ValidationException`: input validation problems (missing token, invalid coordinates, etc.).
+- `FontNotFoundException`: requested font unavailable on the service.
+- `HttpClientException`: transport or server errors with detailed context.
+- `SessionException`: session creation and lifecycle failures.
+
+Wrap automated workflows in `try/except` blocks to surface actionable errors to your users.
+
+## Development
+
+```bash
+python -m venv venv
+source venv/bin/activate            # Windows: venv\Scripts\activate
+pip install -e ".[dev]"
+
+pytest -q                           # unit suite
+pytest tests/e2e                    # integration tests (requires live API + fixtures)
+python -m build                     # produce distribution artifacts
+```
+
+Releases are published with `python release.py`. Contributions are welcome via pull request.
+
+## Related SDKs
+
+- TypeScript client: https://github.com/MenschMachine/pdfdancer-client-js
+- Java client: https://github.com/MenschMachine/pdfdancer-client-java
+
+## License
+
+MIT © The Famous Cat Ltd.

{pdfdancer_client_python-0.2.14 → pdfdancer_client_python-0.2.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pdfdancer-client-python"
-version = "0.2.14"
+version = "0.2.16"
 description = "Python client for PDFDancer API"
 readme = "README.md"
 authors = [

{pdfdancer_client_python-0.2.14 → pdfdancer_client_python-0.2.16}/src/pdfdancer/__init__.py

@@ -12,7 +12,8 @@ from .exceptions import (
 )
 from .models import (
     ObjectRef, Position, ObjectType, Font, Color, Image, BoundingRect, Paragraph, FormFieldRef, TextObjectRef,
-    PageRef, PositionMode, ShapeType, Point, StandardFonts, PageSize, Orientation
+    PageRef, PositionMode, ShapeType, Point, StandardFonts, PageSize, Orientation, TextStatus, FontRecommendation,
+    FontType
 )
 from .paragraph_builder import ParagraphBuilder
 
@@ -37,6 +38,9 @@ __all__ = [
     "StandardFonts",
     "PageSize",
     "Orientation",
+    "TextStatus",
+    "FontRecommendation",
+    "FontType",
     "PdfDancerException",
     "FontNotFoundException",
     "ValidationException",

{pdfdancer_client_python-0.2.14 → pdfdancer_client_python-0.2.16}/src/pdfdancer/models.py

@@ -154,7 +154,6 @@ class StandardFonts(Enum):
 
 
 class ObjectType(Enum):
-    """Object type enumeration matching the Java ObjectType."""
     FORM_FIELD = "FORM_FIELD"
     IMAGE = "IMAGE"
     FORM_X_OBJECT = "FORM_X_OBJECT"
@@ -192,7 +191,6 @@ class Point:
 class BoundingRect:
     """
     Represents a bounding rectangle with position and dimensions.
-    Matches the Java BoundingRect class.
     """
     x: float
     y: float
@@ -216,7 +214,6 @@ class BoundingRect:
 class Position:
     """
     Represents spatial positioning and location information for PDF objects.
-    Closely mirrors the Java Position class with Python conventions.
     """
     page_index: Optional[int] = None
     shape: Optional[ShapeType] = None
@@ -230,7 +227,6 @@ class Position:
     def at_page(page_index: int) -> 'Position':
         """
         Creates a position specification for an entire page.
-        Equivalent to Position.fromPageIndex() in Java.
         """
         return Position(page_index=page_index, mode=PositionMode.CONTAINS)
 
@@ -238,7 +234,6 @@ class Position:
     def at_page_coordinates(page_index: int, x: float, y: float) -> 'Position':
         """
         Creates a position specification for specific coordinates on a page.
-        Equivalent to Position.onPageCoordinates() in Java.
         """
         position = Position.at_page(page_index)
         position.at_coordinates(Point(x, y))
@@ -248,7 +243,6 @@ class Position:
     def by_name(name: str) -> 'Position':
         """
         Creates a position specification for finding objects by name.
-        Equivalent to Position.byName() in Java.
         """
         position = Position()
         position.name = name
@@ -257,7 +251,6 @@ class Position:
     def at_coordinates(self, point: Point) -> 'Position':
         """
         Sets the position to a specific point location.
-        Equivalent to Position.set() in Java.
         """
         self.mode = PositionMode.CONTAINS
         self.shape = ShapeType.POINT
@@ -293,7 +286,6 @@ class Position:
 class ObjectRef:
     """
     Lightweight reference to a PDF object providing identity and type information.
-    Mirrors the Java ObjectRef class exactly.
     """
     internal_id: str
     position: Position
@@ -333,7 +325,6 @@ class Color:
     a: int = 255  # Alpha channel, default fully opaque
 
     def __post_init__(self):
-        # Validation similar to Java client
         for component in [self.r, self.g, self.b, self.a]:
             if not 0 <= component <= 255:
                 raise ValueError(f"Color component must be between 0 and 255, got {component}")
@@ -354,7 +345,6 @@ class Font:
 class Image:
     """
     Represents an image object in a PDF document.
-    Matches the Java Image class structure.
     """
     position: Optional[Position] = None
     format: Optional[str] = None
@@ -375,7 +365,6 @@ class Image:
 class Paragraph:
     """
     Represents a paragraph of text in a PDF document.
-    Structure mirrors the Java Paragraph class.
     """
     position: Optional[Position] = None
     text_lines: Optional[List[str]] = None
@@ -456,7 +445,7 @@ class MoveRequest:
 
     def to_dict(self) -> dict:
         """Convert to dictionary for JSON serialization."""
-        # Server API expects the new coordinates under 'newPosition' (see Java MoveRequest)
+        # Server API expects the new coordinates under 'newPosition'
         return {
             "objectRef": {
                 "internalId": self.object_ref.internal_id,
@@ -488,7 +477,7 @@ class AddRequest:
     def to_dict(self) -> dict:
         """Convert to dictionary for JSON serialization matching server API.
         Server expects an AddRequest with a nested 'object' containing the PDFObject
-        (with a 'type' discriminator), mirroring Java AddRequest(PDFObject object).
+        (with a 'type' discriminator).
         """
         obj = self.pdf_object
         return {
@@ -621,6 +610,58 @@ class FormFieldRef(ObjectRef):
         return self.value
 
 
+class FontType(Enum):
+    """Font type classification from the PDF."""
+    SYSTEM = "SYSTEM"
+    STANDARD = "STANDARD"
+    EMBEDDED = "EMBEDDED"
+
+
+@dataclass
+class FontRecommendation:
+    """Represents a font recommendation with similarity score."""
+    font_name: str
+    font_type: 'FontType'
+    similarity_score: float
+
+    def get_font_name(self) -> str:
+        """Get the recommended font name."""
+        return self.font_name
+
+    def get_font_type(self) -> 'FontType':
+        """Get the recommended font type."""
+        return self.font_type
+
+    def get_similarity_score(self) -> float:
+        """Get the similarity score."""
+        return self.similarity_score
+
+
+@dataclass
+class TextStatus:
+    """Status information for text objects."""
+    modified: bool
+    encodable: bool
+    font_type: FontType
+    font_recommendation: FontRecommendation
+
+    def is_modified(self) -> bool:
+        """Check if the text has been modified."""
+        return self.modified
+
+    def is_encodable(self) -> bool:
+        """Check if the text is encodable."""
+        return self.encodable
+
+    def get_font_type(self) -> FontType:
+        """Get the font type."""
+        return self.font_type
+
+    def get_font_recommendation(self) -> FontRecommendation:
+        """Get the font recommendation."""
+        return self.font_recommendation
+
+
 class TextObjectRef(ObjectRef):
     """
     Represents a text object reference with additional text-specific properties.
@@ -630,13 +671,14 @@ class TextObjectRef(ObjectRef):
     def __init__(self, internal_id: str, position: Position, object_type: ObjectType,
                  text: Optional[str] = None, font_name: Optional[str] = None,
                  font_size: Optional[float] = None, line_spacings: Optional[List[float]] = None,
-                 color: Optional[Color] = None):
+                 color: Optional[Color] = None, status: Optional[TextStatus] = None):
         super().__init__(internal_id, position, object_type)
         self.text = text
         self.font_name = font_name
         self.font_size = font_size
         self.line_spacings = line_spacings
         self.color = color
+        self.status = status
         self.children: List['TextObjectRef'] = []
 
     def get_text(self) -> Optional[str]:
@@ -663,6 +705,10 @@ class TextObjectRef(ObjectRef):
         """Get the child text objects."""
         return self.children
 
+    def get_status(self) -> Optional[TextStatus]:
+        """Get the status information."""
+        return self.status
+
 
 @dataclass
 class PageRef(ObjectRef):
@@ -680,3 +726,30 @@ class PageRef(ObjectRef):
     def get_orientation(self) -> Optional[Orientation]:
         """Get the page orientation."""
         return self.orientation
+
+
+@dataclass
+class CommandResult:
+    """
+    Result object returned by certain API endpoints indicating the outcome of an operation.
+    """
+    command_name: str
+    element_id: str | None
+    message: str | None
+    success: bool
+    warning: str | None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> 'CommandResult':
+        """Create a CommandResult from a dictionary response."""
+        return cls(
+            command_name=data.get('commandName', ''),
+            element_id=data.get('elementId', ''),
+            message=data.get('message', ''),
+            success=data.get('success', False),
+            warning=data.get('warning', '')
+        )
+
+    @classmethod
+    def empty(cls, command_name: str, element_id: str | None) -> 'CommandResult':
+        return CommandResult(command_name=command_name, element_id=element_id, message=None, success=True, warning=None)

{pdfdancer_client_python-0.2.14 → pdfdancer_client_python-0.2.16}/src/pdfdancer/pdfdancer_v1.py

@@ -27,7 +27,7 @@ from .image_builder import ImageBuilder
 from .models import (
     ObjectRef, Position, ObjectType, Font, Image, Paragraph, FormFieldRef, TextObjectRef, PageRef,
     FindRequest, DeleteRequest, MoveRequest, PageMoveRequest, AddRequest, ModifyRequest, ModifyTextRequest,
-    ChangeFormFieldRequest,
+    ChangeFormFieldRequest, CommandResult,
     ShapeType, PositionMode, PageSize, Orientation
 )
 from .paragraph_builder import ParagraphPageBuilder
@@ -915,7 +915,7 @@ class PDFDancer:
         return ImageBuilder(self)
 
     # Modify Operations
-    def _modify_paragraph(self, object_ref: ObjectRef, new_paragraph: Union[Paragraph, str]) -> bool:
+    def _modify_paragraph(self, object_ref: ObjectRef, new_paragraph: Union[Paragraph, str]) -> CommandResult:
         """
         Modifies a paragraph object or its text content.
 
@@ -929,20 +929,20 @@ class PDFDancer:
         if object_ref is None:
             raise ValidationException("Object reference cannot be null")
         if new_paragraph is None:
-            raise ValidationException("New paragraph cannot be null")
+            return CommandResult.empty("ModifyParagraph", object_ref.internal_id)
 
         if isinstance(new_paragraph, str):
-            # Text modification
+            # Text modification - returns CommandResult
             request_data = ModifyTextRequest(object_ref, new_paragraph).to_dict()
             response = self._make_request('PUT', '/pdf/text/paragraph', data=request_data)
+            return CommandResult.from_dict(response.json())
         else:
             # Object modification
             request_data = ModifyRequest(object_ref, new_paragraph).to_dict()
             response = self._make_request('PUT', '/pdf/modify', data=request_data)
+            return CommandResult.from_dict(response.json())
 
-        return response.json()
-
-    def _modify_text_line(self, object_ref: ObjectRef, new_text: str) -> bool:
+    def _modify_text_line(self, object_ref: ObjectRef, new_text: str) -> CommandResult:
         """
         Modifies a text line object.
 
@@ -960,7 +960,7 @@ class PDFDancer:
 
         request_data = ModifyTextRequest(object_ref, new_text).to_dict()
         response = self._make_request('PUT', '/pdf/text/line', data=request_data)
-        return response.json()
+        return CommandResult.from_dict(response.json())
 
     # Font Operations
 
@@ -1171,6 +1171,29 @@ class PDFDancer:
             if all(isinstance(v, int) for v in [red, green, blue]):
                 color = Color(red, green, blue, alpha)
 
+        # Parse status if present
+        status = None
+        status_data = obj_data.get('status')
+        if isinstance(status_data, dict):
+            from .models import TextStatus, FontRecommendation, FontType
+
+            # Parse font recommendation
+            font_rec_data = status_data.get('fontRecommendation')
+            font_rec = None
+            if isinstance(font_rec_data, dict):
+                font_rec = FontRecommendation(
+                    font_name=font_rec_data.get('fontName', ''),
+                    font_type=FontType(font_rec_data.get('fontType', 'SYSTEM')),
+                    similarity_score=font_rec_data.get('similarityScore', 0.0)
+                )
+
+            status = TextStatus(
+                modified=status_data.get('modified', False),
+                encodable=status_data.get('encodable', True),
+                font_type=FontType(status_data.get('fontType', 'UNKNOWN')),
+                font_recommendation=font_rec
+            )
+
         text_object = TextObjectRef(
             internal_id=internal_id,
             position=position,
@@ -1179,7 +1202,8 @@ class PDFDancer:
             font_name=obj_data.get('fontName') if isinstance(obj_data.get('fontName'), str) else None,
             font_size=obj_data.get('fontSize') if isinstance(obj_data.get('fontSize'), (int, float)) else None,
             line_spacings=line_spacings,
-            color=color
+            color=color,
+            status=status
         )
 
         if isinstance(obj_data.get('children'), list) and len(obj_data['children']) > 0: