lpdfio-lpdf 0.0.1__tar.gz

lpdfio_lpdf-0.0.1/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Editors
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db

lpdfio_lpdf-0.0.1/LICENSE

@@ -0,0 +1,131 @@
+# LPDF License
+
+Copyright © 2026 Codesense LLC
+License inquiries: license@lpdf.io
+
+---
+
+## Choosing Your License
+
+LPDF is available under two license types: a free Community License for individuals and qualifying organizations, and paid licenses for larger commercial use. All license tiers receive the complete feature set — no capabilities are gated behind paid plans.
+
+### Equal Features Across All Tiers
+
+Every user of LPDF, regardless of license tier, has access to the same library, the same layout engine, the same adapters, and the same output quality. Licensing determines the terms of use, not the features available.
+
+### Transitive Dependency
+
+If LPDF is pulled in as an indirect dependency of another library or framework rather than used directly in your project, the Community License applies automatically, regardless of your organization's revenue.
+
+This exemption does not apply if the dependency was introduced, created, or controlled by the licensee's organization for the purpose of circumventing license requirements.
+
+### Individuals and Open-Source Projects
+
+Personal use and open-source projects whose source code is publicly available under an OSI-approved license qualify for the Community License at no cost.
+
+### Non-Profit Organizations
+
+Legally recognized non-profit organizations (including 501(c)(3) entities in the United States and equivalent status in other jurisdictions) qualify for the Community License regardless of operating budget.
+
+### Small Businesses
+
+Companies and organizations whose total annual gross revenue did not exceed **1,000,000 USD** in the most recent 12-month fiscal year qualify for the Community License at no cost, including for commercial products and services.
+
+Organizations whose revenue crosses the 1,000,000 USD threshold have a **90-day grace period** following the close of their fiscal year to obtain a Professional or Enterprise license. During this grace period, continued use is permitted.
+
+### Larger Businesses
+
+Companies and organizations whose total annual gross revenue exceeded **1,000,000 USD** in the most recent 12-month fiscal year must obtain a Professional or Enterprise license to use LPDF in production environments.
+
+"Production environment" means any environment in which the Software processes real user data or supports live business operations, including staging environments accessible by end users.
+
+- **Professional License** — for organizations with up to 10 developers using LPDF
+- **Enterprise License** — for organizations with more than 10 developers using LPDF
+
+"Developer" means any individual who writes, modifies, or reviews code that directly integrates or calls the Software's API, including but not limited to software engineers and technical leads. The term does not include QA engineers whose sole interaction is executing pre-written test suites, or DevOps engineers whose sole interaction is deploying pre-packaged artifacts.
+
+### Supporting LPDF
+
+Paid licenses directly fund the continued development, maintenance, and improvement of LPDF. If your organization has grown beyond the Community threshold, purchasing a license is the most direct way to ensure LPDF continues to exist and improve.
+
+---
+
+## LPDF Community License
+
+*Applies to: individuals, open-source projects, non-profit organizations, and companies with annual gross revenue under 1,000,000 USD.*
+
+Permission is hereby granted, free of charge, to any person or qualifying organization obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+All modifications to the Software made by the licensee remain the intellectual property of the licensee. Codesense LLC claims no ownership over modifications unless they are voluntarily submitted as contributions to the LPDF project under a separate Contributor License Agreement.
+
+If your organization's annual gross revenue exceeds 1,000,000 USD, your rights under this Community License are automatically terminated upon expiration of the 90-day grace period described above, and you must obtain a Professional or Enterprise license before continuing to use LPDF in production.
+
+### Disclaimer of Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL CODESENSE LLC OR ITS CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. IN NO EVENT SHALL CODESENSE LLC'S TOTAL CUMULATIVE LIABILITY TO ANY PARTY EXCEED THE GREATER OF (A) THE FEES PAID BY THAT PARTY TO CODESENSE LLC IN THE TWELVE MONTHS PRECEDING THE CLAIM, OR (B) ONE HUNDRED US DOLLARS (USD 100).
+
+---
+
+## LPDF Professional and Enterprise License
+
+*Applies to: companies and organizations with annual gross revenue exceeding 1,000,000 USD.*
+
+### Conduct
+
+Licensees agree not to make false statements of fact about LPDF, Codesense LLC, or its contributors that are intended to cause material harm to the reputation of the project or the company. This clause does not restrict good-faith criticism, bug reports, public discussion of software deficiencies, or reviews based on the licensee's genuine experience.
+
+License rights may not be rented, leased, or transferred to any third party.
+
+### License Grant
+
+Subject to payment of the applicable license fee, Codesense LLC grants the licensee a non-exclusive, worldwide, royalty-free license to:
+
+- Use, copy, modify, and integrate the Software into unlimited applications and projects
+- Distribute the Software as part of compiled or packaged commercial products
+- Deploy the Software across unlimited servers, environments, and infrastructure
+
+**Professional License** grants these rights to up to 10 developers (as defined above) within the licensee's organization.
+
+**Enterprise License** grants these rights to all developers within the licensee's organization with no developer-count limit.
+
+### License Fees and Evaluation
+
+A license fee is required for use of LPDF in production environments (as defined above). Evaluation and testing in non-production environments is permitted without a license for a period not exceeding 30 days.
+
+Upon payment, the licensee receives a perpetual license for the version of LPDF current at the time of purchase, plus one year of updates, new features, and security patches. Continued access to new versions after the first year requires annual renewal. Cancellation of renewal does not affect the perpetual license for the version already held.
+
+### Ownership and Modifications
+
+Codesense LLC retains all ownership, copyright, and intellectual property rights in the Software at all times. This license grants rights to use the Software; it does not transfer ownership of any kind.
+
+All modifications to the Software made by the licensee remain the intellectual property of the licensee. Codesense LLC claims no ownership over licensee modifications unless they are voluntarily submitted as contributions to the LPDF project under a separate Contributor License Agreement.
+
+### Copyright
+
+All copies, modifications, and distributions of the Software must retain the original copyright notice. Licensees may not remove, alter, or obscure any copyright, trademark, or attribution notices included in the Software.
+
+### Data and Privacy
+
+Codesense LLC does not collect, process, or retain any data that the licensee processes through the Software. All data processed by LPDF remains solely within the licensee's infrastructure. For more information, see the Codesense LLC Privacy Policy at lpdf.io/privacy.
+
+### Export Compliance
+
+The Software may be subject to export control laws and regulations, including the U.S. Export Administration Regulations (EAR) and sanctions programs administered by OFAC. The licensee is solely responsible for complying with all applicable export control and sanctions laws in connection with the licensee's use of the Software.
+
+### Disclaimer of Warranty
+
+THIS SOFTWARE IS PROVIDED "AS IS," WITHOUT A WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL CODESENSE LLC OR ITS CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. IN NO EVENT SHALL CODESENSE LLC'S TOTAL CUMULATIVE LIABILITY TO ANY PARTY EXCEED THE GREATER OF (A) THE FEES PAID BY THAT PARTY TO CODESENSE LLC IN THE TWELVE MONTHS PRECEDING THE CLAIM, OR (B) ONE HUNDRED US DOLLARS (USD 100).
+
+### Governing Law and Dispute Resolution
+
+This license is governed by and construed in accordance with the laws of the State of Delaware, United States, without regard to its conflict of law provisions.
+
+Any dispute arising out of or relating to this license or the Software shall be resolved by binding arbitration administered by the American Arbitration Association under its Commercial Arbitration Rules. The arbitration shall take place in **Plano, Texas**. Judgment on the award rendered by the arbitrator may be entered in any court of competent jurisdiction.
+
+Notwithstanding the foregoing, either party may seek injunctive or other equitable relief in any court of competent jurisdiction to prevent the actual or threatened infringement, misappropriation, or violation of a party's intellectual property rights.
+
+---
+
+For license purchases and inquiries: **license@lpdf.io** | lpdf.io/privacy

lpdfio_lpdf-0.0.1/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: lpdfio-lpdf
+Version: 0.0.1
+Summary: Python adapter for lpdf — pixel-perfect, lightweight, and consistent PDF rendering
+Project-URL: Homepage, https://lpdf.io
+Project-URL: Repository, https://github.com/lpdfio/lpdf-python
+Project-URL: Changelog, https://github.com/lpdfio/lpdf/releases
+Author-email: "lpdf.io" <support@lpdf.io>
+License: # LPDF License
+        
+        Copyright © 2026 Codesense LLC
+        License inquiries: license@lpdf.io
+        
+        ---
+        
+        ## Choosing Your License
+        
+        LPDF is available under two license types: a free Community License for individuals and qualifying organizations, and paid licenses for larger commercial use. All license tiers receive the complete feature set — no capabilities are gated behind paid plans.
+        
+        ### Equal Features Across All Tiers
+        
+        Every user of LPDF, regardless of license tier, has access to the same library, the same layout engine, the same adapters, and the same output quality. Licensing determines the terms of use, not the features available.
+        
+        ### Transitive Dependency
+        
+        If LPDF is pulled in as an indirect dependency of another library or framework rather than used directly in your project, the Community License applies automatically, regardless of your organization's revenue.
+        
+        This exemption does not apply if the dependency was introduced, created, or controlled by the licensee's organization for the purpose of circumventing license requirements.
+        
+        ### Individuals and Open-Source Projects
+        
+        Personal use and open-source projects whose source code is publicly available under an OSI-approved license qualify for the Community License at no cost.
+        
+        ### Non-Profit Organizations
+        
+        Legally recognized non-profit organizations (including 501(c)(3) entities in the United States and equivalent status in other jurisdictions) qualify for the Community License regardless of operating budget.
+        
+        ### Small Businesses
+        
+        Companies and organizations whose total annual gross revenue did not exceed **1,000,000 USD** in the most recent 12-month fiscal year qualify for the Community License at no cost, including for commercial products and services.
+        
+        Organizations whose revenue crosses the 1,000,000 USD threshold have a **90-day grace period** following the close of their fiscal year to obtain a Professional or Enterprise license. During this grace period, continued use is permitted.
+        
+        ### Larger Businesses
+        
+        Companies and organizations whose total annual gross revenue exceeded **1,000,000 USD** in the most recent 12-month fiscal year must obtain a Professional or Enterprise license to use LPDF in production environments.
+        
+        "Production environment" means any environment in which the Software processes real user data or supports live business operations, including staging environments accessible by end users.
+        
+        - **Professional License** — for organizations with up to 10 developers using LPDF
+        - **Enterprise License** — for organizations with more than 10 developers using LPDF
+        
+        "Developer" means any individual who writes, modifies, or reviews code that directly integrates or calls the Software's API, including but not limited to software engineers and technical leads. The term does not include QA engineers whose sole interaction is executing pre-written test suites, or DevOps engineers whose sole interaction is deploying pre-packaged artifacts.
+        
+        ### Supporting LPDF
+        
+        Paid licenses directly fund the continued development, maintenance, and improvement of LPDF. If your organization has grown beyond the Community threshold, purchasing a license is the most direct way to ensure LPDF continues to exist and improve.
+        
+        ---
+        
+        ## LPDF Community License
+        
+        *Applies to: individuals, open-source projects, non-profit organizations, and companies with annual gross revenue under 1,000,000 USD.*
+        
+        Permission is hereby granted, free of charge, to any person or qualifying organization obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+        
+        All modifications to the Software made by the licensee remain the intellectual property of the licensee. Codesense LLC claims no ownership over modifications unless they are voluntarily submitted as contributions to the LPDF project under a separate Contributor License Agreement.
+        
+        If your organization's annual gross revenue exceeds 1,000,000 USD, your rights under this Community License are automatically terminated upon expiration of the 90-day grace period described above, and you must obtain a Professional or Enterprise license before continuing to use LPDF in production.
+        
+        ### Disclaimer of Warranty
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL CODESENSE LLC OR ITS CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. IN NO EVENT SHALL CODESENSE LLC'S TOTAL CUMULATIVE LIABILITY TO ANY PARTY EXCEED THE GREATER OF (A) THE FEES PAID BY THAT PARTY TO CODESENSE LLC IN THE TWELVE MONTHS PRECEDING THE CLAIM, OR (B) ONE HUNDRED US DOLLARS (USD 100).
+        
+        ---
+        
+        ## LPDF Professional and Enterprise License
+        
+        *Applies to: companies and organizations with annual gross revenue exceeding 1,000,000 USD.*
+        
+        ### Conduct
+        
+        Licensees agree not to make false statements of fact about LPDF, Codesense LLC, or its contributors that are intended to cause material harm to the reputation of the project or the company. This clause does not restrict good-faith criticism, bug reports, public discussion of software deficiencies, or reviews based on the licensee's genuine experience.
+        
+        License rights may not be rented, leased, or transferred to any third party.
+        
+        ### License Grant
+        
+        Subject to payment of the applicable license fee, Codesense LLC grants the licensee a non-exclusive, worldwide, royalty-free license to:
+        
+        - Use, copy, modify, and integrate the Software into unlimited applications and projects
+        - Distribute the Software as part of compiled or packaged commercial products
+        - Deploy the Software across unlimited servers, environments, and infrastructure
+        
+        **Professional License** grants these rights to up to 10 developers (as defined above) within the licensee's organization.
+        
+        **Enterprise License** grants these rights to all developers within the licensee's organization with no developer-count limit.
+        
+        ### License Fees and Evaluation
+        
+        A license fee is required for use of LPDF in production environments (as defined above). Evaluation and testing in non-production environments is permitted without a license for a period not exceeding 30 days.
+        
+        Upon payment, the licensee receives a perpetual license for the version of LPDF current at the time of purchase, plus one year of updates, new features, and security patches. Continued access to new versions after the first year requires annual renewal. Cancellation of renewal does not affect the perpetual license for the version already held.
+        
+        ### Ownership and Modifications
+        
+        Codesense LLC retains all ownership, copyright, and intellectual property rights in the Software at all times. This license grants rights to use the Software; it does not transfer ownership of any kind.
+        
+        All modifications to the Software made by the licensee remain the intellectual property of the licensee. Codesense LLC claims no ownership over licensee modifications unless they are voluntarily submitted as contributions to the LPDF project under a separate Contributor License Agreement.
+        
+        ### Copyright
+        
+        All copies, modifications, and distributions of the Software must retain the original copyright notice. Licensees may not remove, alter, or obscure any copyright, trademark, or attribution notices included in the Software.
+        
+        ### Data and Privacy
+        
+        Codesense LLC does not collect, process, or retain any data that the licensee processes through the Software. All data processed by LPDF remains solely within the licensee's infrastructure. For more information, see the Codesense LLC Privacy Policy at lpdf.io/privacy.
+        
+        ### Export Compliance
+        
+        The Software may be subject to export control laws and regulations, including the U.S. Export Administration Regulations (EAR) and sanctions programs administered by OFAC. The licensee is solely responsible for complying with all applicable export control and sanctions laws in connection with the licensee's use of the Software.
+        
+        ### Disclaimer of Warranty
+        
+        THIS SOFTWARE IS PROVIDED "AS IS," WITHOUT A WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL CODESENSE LLC OR ITS CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. IN NO EVENT SHALL CODESENSE LLC'S TOTAL CUMULATIVE LIABILITY TO ANY PARTY EXCEED THE GREATER OF (A) THE FEES PAID BY THAT PARTY TO CODESENSE LLC IN THE TWELVE MONTHS PRECEDING THE CLAIM, OR (B) ONE HUNDRED US DOLLARS (USD 100).
+        
+        ### Governing Law and Dispute Resolution
+        
+        This license is governed by and construed in accordance with the laws of the State of Delaware, United States, without regard to its conflict of law provisions.
+        
+        Any dispute arising out of or relating to this license or the Software shall be resolved by binding arbitration administered by the American Arbitration Association under its Commercial Arbitration Rules. The arbitration shall take place in **Plano, Texas**. Judgment on the award rendered by the arbitrator may be entered in any court of competent jurisdiction.
+        
+        Notwithstanding the foregoing, either party may seek injunctive or other equitable relief in any court of competent jurisdiction to prevent the actual or threatened infringement, misappropriation, or violation of a party's intellectual property rights.
+        
+        ---
+        
+        For license purchases and inquiries: **license@lpdf.io** | lpdf.io/privacy
+License-File: LICENSE
+Keywords: document,pdf,wasm,xml
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8

lpdfio_lpdf-0.0.1/lpdf/__init__.py

@@ -0,0 +1,83 @@
+# Top-level facades
+from .lpdf_engine import LpdfEngine
+from .lpdf_kit import LpdfKit
+from .lpdf_layout import LpdfLayout
+from .lpdf_canvas import LpdfCanvas
+
+# engine subpackage — commonly used types
+from .engine.engine_exception import EngineException
+from .engine.engine_options import EngineOptions
+from .engine.render_options import RenderOptions
+from .engine.encrypt_options import EncryptOptions, EncryptPermissions
+
+# kit subpackage
+from .kit.document import Document
+from .kit.document_options import DocumentOptions
+from .kit.document_meta import DocumentMeta
+from .kit.document_tokens import DocumentTokens
+from .kit.section_node import SectionNode
+from .kit.section_options import SectionOptions
+from .kit.section_layout import SectionLayout
+from .kit.section_canvas import SectionCanvas
+from .kit.orientation import Orientation
+
+# layout subpackage — options and enums
+from .layout.pin import Pin
+from .layout.field_type import FieldType
+from .layout.stack_options import StackOptions
+from .layout.flank_options import FlankOptions
+from .layout.split_options import SplitOptions
+from .layout.cluster_options import ClusterOptions
+from .layout.grid_options import GridOptions
+from .layout.frame_options import FrameOptions
+from .layout.link_options import LinkOptions
+from .layout.text_options import TextOptions
+from .layout.span_options import SpanOptions
+from .layout.divider_options import DividerOptions
+from .layout.img_options import ImgOptions
+from .layout.barcode_options import BarcodeOptions
+from .layout.field_options import FieldOptions
+from .layout.region_options import RegionOptions
+from .layout.table_options import TableOptions
+from .layout.thead_options import TheadOptions
+from .layout.tr_options import TrOptions
+from .layout.td_options import TdOptions
+
+# canvas subpackage — commonly used types
+from .canvas.layer_options import LayerOptions
+from .canvas.transform import Transform
+from .canvas.clip import Clip
+from .canvas.run import Run
+from .canvas.styles import RectStyle, LineStyle, EllipseStyle, PathStyle
+from .canvas.text_style import TextStyle
+from .canvas.text_align import TextAlign
+from .canvas.line_cap import LineCap
+from .canvas.line_join import LineJoin
+
+# shared
+from .shared.page_scope import PageScope
+
+__all__ = [
+    # facades
+    "LpdfEngine", "LpdfKit", "LpdfLayout", "LpdfCanvas",
+    # engine
+    "EngineException", "EngineOptions", "RenderOptions",
+    "EncryptOptions", "EncryptPermissions",
+    # kit
+    "Document", "DocumentOptions", "DocumentMeta", "DocumentTokens",
+    "SectionNode", "SectionOptions", "SectionLayout", "SectionCanvas",
+    "Orientation",
+    # layout options / enums
+    "Pin", "FieldType",
+    "StackOptions", "FlankOptions", "SplitOptions", "ClusterOptions",
+    "GridOptions", "FrameOptions", "LinkOptions",
+    "TextOptions", "SpanOptions", "DividerOptions",
+    "ImgOptions", "BarcodeOptions", "FieldOptions", "RegionOptions",
+    "TableOptions", "TheadOptions", "TrOptions", "TdOptions",
+    # canvas
+    "LayerOptions", "Transform", "Clip", "Run",
+    "RectStyle", "LineStyle", "EllipseStyle", "PathStyle",
+    "TextStyle", "TextAlign", "LineCap", "LineJoin",
+    # shared
+    "PageScope",
+]

lpdfio_lpdf-0.0.1/lpdf/canvas/__init__.py

@@ -0,0 +1,35 @@
+from .canvas_node import CanvasNode
+from .layer_node import LayerNode
+from .layer_options import LayerOptions
+from .rect_node import RectNode
+from .line_node import LineNode
+from .ellipse_node import EllipseNode
+from .circle_node import CircleNode
+from .path_node import PathNode
+from .text_node import CanvasTextNode
+from .image_node import ImageNode
+from .text_style import TextStyle
+from .text_align import TextAlign
+from .run import Run
+from .transform import Transform
+from .clip import Clip
+from .line_cap import LineCap
+from .line_join import LineJoin
+from .styles import RectStyle, LineStyle, EllipseStyle, PathStyle
+
+__all__ = [
+    "CanvasNode",
+    "LayerNode", "LayerOptions",
+    "RectNode", "RectStyle",
+    "LineNode", "LineStyle",
+    "EllipseNode", "EllipseStyle",
+    "CircleNode",
+    "PathNode", "PathStyle",
+    "CanvasTextNode", "TextStyle", "TextAlign",
+    "Run",
+    "ImageNode",
+    "Transform",
+    "Clip",
+    "LineCap",
+    "LineJoin",
+]

lpdfio_lpdf-0.0.1/lpdf/canvas/canvas_node.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+
+class CanvasNode(ABC):
+    """Abstract base class for all canvas nodes."""
+
+    @abstractmethod
+    def to_dict(self) -> dict:
+        ...

lpdfio_lpdf-0.0.1/lpdf/canvas/circle_node.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from .canvas_node import CanvasNode
+from .styles import EllipseStyle
+
+
+class CircleNode(CanvasNode):
+    __slots__ = ("_cx", "_cy", "_r", "_style")
+
+    def __init__(self, cx: float, cy: float, r: float, style: EllipseStyle | None = None):
+        self._cx = cx
+        self._cy = cy
+        self._r = r
+        self._style = style
+
+    def to_dict(self) -> dict:
+        attrs: dict = {"x": str(self._cx), "y": str(self._cy), "r": str(self._r)}
+        s = self._style
+        if s is not None:
+            if s.fill is not None:         attrs["fill"]         = s.fill
+            if s.stroke is not None:       attrs["stroke"]       = s.stroke
+            if s.stroke_width is not None: attrs["stroke-width"] = str(s.stroke_width)
+            if s.stroke_dash is not None:  attrs["stroke-dash"]  = " ".join(str(v) for v in s.stroke_dash)
+        return {"type": "canvas-circle", "attrs": attrs}

lpdfio_lpdf-0.0.1/lpdf/canvas/clip.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class Clip:
+    x: float
+    y: float
+    w: float
+    h: float
+    border_radius: float = 0.0

lpdfio_lpdf-0.0.1/lpdf/canvas/ellipse_node.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from .canvas_node import CanvasNode
+from .styles import EllipseStyle
+
+
+class EllipseNode(CanvasNode):
+    __slots__ = ("_cx", "_cy", "_rx", "_ry", "_style")
+
+    def __init__(self, cx: float, cy: float, rx: float, ry: float, style: EllipseStyle | None = None):
+        self._cx = cx
+        self._cy = cy
+        self._rx = rx
+        self._ry = ry
+        self._style = style
+
+    def to_dict(self) -> dict:
+        attrs: dict = {
+            "x": str(self._cx), "y": str(self._cy),
+            "rx": str(self._rx), "ry": str(self._ry),
+        }
+        s = self._style
+        if s is not None:
+            if s.fill is not None:         attrs["fill"]         = s.fill
+            if s.stroke is not None:       attrs["stroke"]       = s.stroke
+            if s.stroke_width is not None: attrs["stroke-width"] = str(s.stroke_width)
+            if s.stroke_dash is not None:  attrs["stroke-dash"]  = " ".join(str(v) for v in s.stroke_dash)
+        return {"type": "canvas-ellipse", "attrs": attrs}

lpdfio_lpdf-0.0.1/lpdf/canvas/image_node.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from .canvas_node import CanvasNode
+
+
+class ImageNode(CanvasNode):
+    __slots__ = ("_x", "_y", "_w", "_h", "_name")
+
+    def __init__(self, x: float, y: float, w: float, h: float, name: str):
+        self._x = x
+        self._y = y
+        self._w = w
+        self._h = h
+        self._name = name
+
+    def to_dict(self) -> dict:
+        return {
+            "type": "canvas-img",
+            "attrs": {
+                "x": str(self._x), "y": str(self._y),
+                "w": str(self._w), "h": str(self._h),
+                "name": self._name,
+            },
+        }

lpdfio_lpdf-0.0.1/lpdf/canvas/layer_node.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from ..shared.page_scope import PageScope
+from .canvas_node import CanvasNode
+from .clip import Clip
+from .layer_options import LayerOptions
+
+
+class LayerNode(CanvasNode):
+    """A canvas layer containing canvas primitives."""
+
+    __slots__ = ("_nodes", "_options")
+
+    def __init__(self, nodes: list, options: LayerOptions | None = None):
+        self._nodes = nodes
+        self._options = options
+
+    def to_dict(self) -> dict:
+        attrs: dict = {}
+        o = self._options
+        if o is not None:
+            if o.page is not None:
+                attrs["page"] = o.page
+            if o.opacity is not None:
+                attrs["opacity"] = str(o.opacity)
+            if o.transform is not None:
+                attrs["transform"] = o.transform.matrix
+            if o.clip is not None:
+                c = o.clip
+                clip: dict = {"x": c.x, "y": c.y, "w": c.w, "h": c.h}
+                if c.border_radius != 0.0:
+                    clip["borderRadius"] = c.border_radius
+                attrs["clip"] = clip
+        return {
+            "type": "canvas-layer",
+            "attrs": attrs,
+            "nodes": [n.to_dict() for n in self._nodes],
+        }

lpdfio_lpdf-0.0.1/lpdf/canvas/layer_options.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .transform import Transform
+from .clip import Clip
+
+
+@dataclass(frozen=True)
+class LayerOptions:
+    page: str | None = None
+    opacity: float | None = None
+    transform: Transform | None = None
+    clip: Clip | None = None

lpdfio_lpdf-0.0.1/lpdf/canvas/line_cap.py

@@ -0,0 +1,7 @@
+from enum import StrEnum
+
+
+class LineCap(StrEnum):
+    BUTT   = "butt"
+    ROUND  = "round"
+    SQUARE = "square"

lpdfio_lpdf-0.0.1/lpdf/canvas/line_join.py

@@ -0,0 +1,7 @@
+from enum import StrEnum
+
+
+class LineJoin(StrEnum):
+    MITER = "miter"
+    ROUND = "round"
+    BEVEL = "bevel"

lpdfio_lpdf-0.0.1/lpdf/canvas/line_node.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from .canvas_node import CanvasNode
+from .styles import LineStyle
+
+
+class LineNode(CanvasNode):
+    __slots__ = ("_x1", "_y1", "_x2", "_y2", "_style")
+
+    def __init__(self, x1: float, y1: float, x2: float, y2: float, style: LineStyle | None = None):
+        self._x1 = x1
+        self._y1 = y1
+        self._x2 = x2
+        self._y2 = y2
+        self._style = style
+
+    def to_dict(self) -> dict:
+        attrs: dict = {
+            "x1": str(self._x1), "y1": str(self._y1),
+            "x2": str(self._x2), "y2": str(self._y2),
+        }
+        s = self._style
+        if s is not None:
+            if s.stroke is not None:       attrs["stroke"]       = s.stroke
+            if s.stroke_width is not None: attrs["stroke-width"] = str(s.stroke_width)
+            if s.stroke_dash is not None:  attrs["stroke-dash"]  = " ".join(str(v) for v in s.stroke_dash)
+            if s.line_cap is not None:     attrs["line-cap"]     = str(s.line_cap)
+            if s.line_join is not None:    attrs["line-join"]    = str(s.line_join)
+        return {"type": "canvas-line", "attrs": attrs}