pdf-html 0.1.0__tar.gz

pdf_html-0.1.0/.gitignore

@@ -0,0 +1,244 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+*.lcov
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi/*
+!.pixi/config.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule*
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+
+# Internal development files (workflow guide §4)
+REQS.md
+.github/instructions/workflow-instructions.md
+.github/*instructions.md
+
+tests/fixtures/*.html
+# Only the deterministic generated fixtures are committed; ad-hoc test PDFs
+# (often copyrighted course material) stay local.
+tests/fixtures/*.pdf
+tests/fixtures/*.PDF
+!tests/fixtures/report.pdf
+!tests/fixtures/two_column.pdf
+!tests/fixtures/slides.pdf
+!tests/fixtures/brochure.pdf
+!tests/fixtures/table.pdf
+chain*
+
+# Local conversion artifacts at repo root (often copyrighted sources — never commit)
+/*.pdf
+/*.html
+
+# macOS
+.DS_Store

pdf_html-0.1.0/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "liveServer.settings.port": 5501
+}

pdf_html-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omar (Top Gear Technologies LLC)
+
+Permission is hereby granted, free of charge, to any person 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.
+
+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 THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 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.

pdf_html-0.1.0/PKG-INFO

@@ -0,0 +1,296 @@
+Metadata-Version: 2.5
+Name: pdf-html
+Version: 0.1.0
+Summary: Early-stage geometry-first PDF-to-HTML converter for text-based PDFs — verbatim text, source typography, zero images.
+Project-URL: Homepage, https://github.com/OmarMWarraich/pdf-html
+Project-URL: Repository, https://github.com/OmarMWarraich/pdf-html
+Project-URL: Issues, https://github.com/OmarMWarraich/pdf-html/issues
+Project-URL: Documentation, https://github.com/OmarMWarraich/pdf-html#readme
+Author: Omar Warraich
+License: MIT
+License-File: LICENSE
+Keywords: converter,document-conversion,geometry-first,html,pdf,pdf-to-html,pymupdf,semantic-html,text-based-pdf
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: pymupdf>=1.24
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<img src="logo.png" alt="pdf-html logo" width="120" height="120" />
+
+# pdf-html
+
+**Early-stage geometry-first PDF → HTML converter for text-based PDFs — verbatim text, source typography, zero images.**
+
+[![Python](https://img.shields.io/badge/python-3.10%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/)
+[![PyMuPDF](https://img.shields.io/badge/powered%20by-PyMuPDF-orange)](https://pymupdf.readthedocs.io/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](#-license)
+[![Tests](https://img.shields.io/badge/tests-56%20passing-brightgreen?logo=pytest&logoColor=white)](#-testing)
+[![Typed](https://img.shields.io/badge/typing-fully%20typed-blue)](#)
+[![No LLM](https://img.shields.io/badge/NLP%2FLLM-none%2C%20pure%20geometry-purple)](#-design-principles)
+
+*One command in. One elegant, dependency-free HTML file out.*
+
+</div>
+
+---
+
+## 🎯 What it does
+
+`pdf-html` is an **early-stage, geometry-first PDF-to-HTML converter** for **text-based PDFs**. It rebuilds the document as a **single self-contained HTML5 file** that mirrors the source document's look and structure:
+
+- ✅ Best for: text-based PDFs with real text layers, headings, lists, tables, and multi-column layouts
+- ⚠️ Not a universal OCR-first converter: scanned/image-heavy PDFs still need an OCR pre-pass or a dedicated workflow
+
+- 🏷️ **Heading hierarchy** — font-size tiers become real `<h1>`–`<h6>`
+- 🎨 **Typography & color** — the page CSS is derived from the document's own fonts, sizes, and palette
+- 📊 **Tables** — ruled tables are rebuilt as real `<table>` elements, including lists *inside* cells and rows that continue across page breaks
+- 📝 **Lists** — bullets and numbered items become nested `<ul>`/`<ol>` (indent decides nesting)
+- 🧭 **Reading order** — multi-column layouts are re-linearized column by column
+- ✂️ **Page furniture** — repeated running headers/footers and page numbers are stripped
+- 🔒 **Text is verbatim** — never summarized, reworded, or reordered within a block
+- 🚫 **No images, ever** — image content is dropped by design; text alone carries the document
+
+## 🧭 Early-stage scope
+
+This is an **early-stage, geometry-first conversion tool for text-based PDFs**. It is designed to be reliable and deterministic where the PDF has a usable text layer, but it is not a universal OCR-first converter for scanned documents, forms, or arbitrary image-heavy PDFs.
+
+### What it does well
+
+- text-based PDFs with real text layers
+- styled HTML with verbatim text
+- heading hierarchy, lists, and multi-column layout reconstruction
+- ruled table reconstruction with cell-aware content flow
+
+### What it does not yet do well
+
+- OCR and scanned-document support are planned as separate, opt-in paths
+- arbitrary image-heavy PDFs or forms with weak text layers
+- pixel-perfect visual reconstruction of every layout edge case
+
+## ⚡ Quick start
+
+```bash
+# install (Python 3.10+)
+uv pip install .        # or: pip install .
+
+# convert
+pdf-html report.pdf -o report.html
+
+# open report.html in any browser — no external assets needed
+```
+
+## 🖥️ CLI reference
+
+```bash
+pdf-html INPUT.pdf -o out.html [--extractor pymupdf|pdftotext]
+    [--style auto|default] [--paginate] [--no-tables] [--no-callouts]
+    [--keep-headers] [--allow-scanned]
+```
+
+| Flag | Default | What it does |
+|---|---|---|
+| `-o, --output` | *(required)* | Path of the HTML file to write |
+| `--extractor` | `pymupdf` | Text extraction backend (`pdftotext` fallback planned) |
+| `--style` | `auto` | `auto` derives CSS from the document's own fonts/sizes/colors; `default` uses a clean built-in theme |
+| `--paginate` | off | Wrap each PDF page in a `<section class="sheet">` |
+| `--no-tables` | off | Disable table reconstruction (table text flows as paragraphs) |
+| `--keep-headers` | off | Keep repeated running headers/footers |
+| `--allow-scanned` | off | Convert scanned/image PDFs instead of exiting with an OCR hint |
+
+## 🏗️ Architecture
+
+A deterministic pipeline — every stage is a small, pure, individually testable module:
+
+<details>
+<summary>🔍 <b>Pipeline diagram</b> — click to enlarge (click again to close) · <a href="https://mermaid.live/view#pako:eNqNlV9vmzAUxb_KFQ97WVnzp1nbbKq2No3ykDYIMqnS2IOxL8GqsZExa7uq330GQgismZIHJzb28Tm_XJtXhyqGzhQc13VDSZWM-WYaSgBBXlRhpoDiseyaBFOcgsTCaCJCWU2PhXqiCdEGln45CSAvoo0mWQLB8GfohAW7GDPbUpzAEMJiMIjO4fbZSlATOr_qNeWHcY3UcCVhfd2OerP5t1fIE5LZrZmiJ9ZVhGIK-9L0rJwXOvDWLrx9aNeVwnsLt7sr_TXSp1d5RmQOHyFW0kCKhjBiSFfLioPrXlnNegwl62cdNVnRtiy-hFGT9UYgkfCBpNkX8LSKucAjci_mB-0vkDDUp3OlDG4jGM2zjMtN13bgtRoJPu9JBOZFYOOm1ogUe4Gc_8HGdzIMi9FgOE4-NyMZEWgMdjdZ1GgC7yCacQcNMhg3gsuqwI6g4a8O0vAtDZscVpptk1AlilQCFUVuAf1DZe23WrF2e3JrElkyPtpjYKkWuyrJULsUhYCMZyi43KPwTuSzJjK1bczOwyLGQQxnTfCgki70MZUQzPYOAP_dN7yTghka3PlNaix5-99pUpnbjQiem7yLZukdxLy0s8EjOt9ClmjhMijEqRJdke_BulWJ1FPfsH1eKcwULVK0Z86W2fByZMU32Py-Foo-9swFs6rQll71ZVUO0p906JMLmDSZfTsb9TEFd_-fgis1mpOHKZGGU1is75YTe4twWRYH3ARB1_3qxx4VQzbuO3dZZXc4AHsmPiUm7XH176vgVqgX_PaherCY192gBuSvOt319nb2V_VxndXdtd_pWqr14nvnBJwUdUo4s6-GV6e6_MuXxPb6d97e_gLHTOOG">open full screen ↗</a></summary>
+<br/>
+
+```mermaid
+---
+config:
+  layout: elk
+  theme: neutral
+---
+flowchart LR
+    subgraph S1["📥 1 · Extract"]
+        direction TB
+        PDF@{ shape: doc, label: "📄 PDF" }
+        EX@{ shape: rect, label: "Extractor<br/>spans + font metadata" }
+        PDF --> EX
+    end
+    subgraph S2["🧹 2 · Clean &amp; Profile"]
+        direction TB
+        HF@{ shape: rect, label: "Header/Footer<br/>stripping" }
+        SP@{ shape: hex, label: "Style Profiler<br/>body size · h1–h6 · palette" }
+        HF --> SP
+    end
+    subgraph S3["🧭 3 · Layout"]
+        direction TB
+        RO@{ shape: rect, label: "Reading Order<br/>column clustering" }
+        TR@{ shape: fr-rect, label: "Table Reconstructor<br/>per-cell pipeline" }
+    end
+    subgraph S4["🏗️ 4 · Structure"]
+        direction TB
+        SD@{ shape: div-rect, label: "Structure Detector<br/>headings · paragraphs · lists" }
+        LP@{ shape: rect, label: "List Parser<br/>nested ul/ol" }
+        AST@{ shape: bow-rect, label: "AST<br/>Document → Page → Blocks" }
+        SD --> LP --> AST
+    end
+    subgraph S5["🎨 5 · Render"]
+        direction TB
+        RN@{ shape: rect, label: "Renderer<br/>semantic HTML5 + inline CSS" }
+        OUT@{ shape: tag-doc, label: "🌐 out.html" }
+        RN --> OUT
+    end
+    EX --> HF
+    SP --> RO
+    SP --> TR
+    RO --> SD
+    TR --> SD
+    AST --> RN
+```
+
+</details>
+
+| Module | Responsibility |
+|---|---|
+| `extractor.py` | `TextExtractor` ABC; PyMuPDF backend reads per-span size/weight/color/bbox and detects table regions |
+| `header_footer.py` | Strips spans repeating on ≥ 60% of pages in the top/bottom 10% bands |
+| `style_profiler.py` | Character-weighted font-size histogram → body size, heading tiers, color palette |
+| `reading_order.py` | Column detection via x-gap clustering, with a card-grid fallback and straddle guard |
+| `table_reconstructor.py` | Assigns spans to detected cells, runs the full pipeline *inside each cell*, merges cross-page rows |
+| `structure.py` | Classifies lines into headings/paragraphs/list items from geometry + font cues |
+| `list_parser.py` | Indent-based nesting; glyph style only picks `ul` vs `ol`; markers stripped, text verbatim |
+| `ast.py` | Typed document model — `Document → Page → Block`, runs carry inline style |
+| `renderer.py` | Single-file HTML5 with one `<style>` block and CSS variables from the profile |
+
+## 📊 Table reconstruction highlights
+
+The hardest part of PDF → HTML is tables. `pdf-html`:
+
+1. 🔍 Detects ruled tables geometrically (PyMuPDF `find_tables()`) at extraction time
+2. 📌 Assigns the page's *styled* spans to cells by bounding box — inline bold/color/size survive
+3. 🔄 Runs the normal line → paragraph → list pipeline **inside every cell**, so bullets in cells become real nested lists
+4. 🧵 Merges rows that continue across page breaks (empty-first-cell fragments) back into one row — even resuming mid-list-item
+5. 🏷️ Promotes a bold-only first row to a `<th>` header row
+
+## 🧭 Design principles
+
+| Principle | Meaning |
+|---|---|
+| 🧮 **Pure geometry, no AI** | All structure is inferred from font metadata and bounding boxes. No NLP, no LLM, no document-specific regexes |
+| 🔒 **Text is sacred** | Output text is verbatim; only `& < >` are escaped |
+| 🚫 **No images** | Spans overlapping image rects are dropped; `<img>` is never emitted |
+| 🪂 **Graceful degradation** | Heuristic failures only affect styling — never text content or order |
+| 🔧 **Tunable & testable** | Every heuristic threshold is a named module-level constant with focused unit tests |
+
+## ⚖️ How it compares
+
+Every PDF converter picks a trade-off. `pdf-html` optimizes for **semantic, reflowable, styled HTML with a verbatim-text guarantee** — a square none of the established tools occupy:
+
+| Tool | Output | Semantic structure | Keeps typography | Deterministic | Footprint |
+|---|---|:---:|:---:|:---:|---|
+| **pdf-html** | Self-contained HTML5 | ✅ `h1–h6`, `ul/ol`, `table` | ✅ CSS derived from the source | ✅ | ~30 MB (PyMuPDF only) |
+| [pdf2htmlEX](https://github.com/pdf2htmlEX/pdf2htmlEX) | Pixel-faithful HTML | ❌ positioned glyphs | ✅ visually | ✅ | C++ toolchain |
+| [Poppler pdftohtml](https://poppler.freedesktop.org/) | Positioned divs / bare text | ❌ | ⚠️ partial | ✅ | system package |
+| [pymupdf4llm](https://pypi.org/project/pymupdf4llm/) | Markdown for LLM ingestion | ⚠️ headings & lists | ❌ discarded | ✅ | ~30 MB |
+| [marker-pdf](https://pypi.org/project/marker-pdf/) | Markdown/JSON via ML | ✅ | ❌ discarded | ❌ model-dependent | GB-scale models, GPU-friendly |
+| [docling](https://pypi.org/project/docling/) | Markdown/HTML/JSON via ML | ✅ | ❌ discarded | ❌ model-dependent | GB-scale models |
+| [unstructured](https://pypi.org/project/unstructured/) | Element JSON for RAG | ⚠️ element types | ❌ | ⚠️ | heavy optional deps |
+| Adobe PDF Services | Structured JSON/HTML | ✅ | ⚠️ | ❌ | cloud API, paid |
+
+**When to choose pdf-html** — you want a *readable, reflowable* document that still looks like the original, produced offline, reproducibly, with text you can trust character-for-character (text-based PDFs, tables included, even across page breaks).
+
+**When to choose something else** — you need pixel-perfect visual replicas (pdf2htmlEX), OCR-heavy scanned document conversion (marker, docling), or RAG-oriented element JSON (unstructured).
+
+## 🧪 Testing
+
+56 tests cover every pipeline stage plus end-to-end CLI runs over deterministic fixture PDFs
+(report, two-column paper, slide deck, brochure, ruled table):
+
+```bash
+uv sync                                        # dev deps (pytest, reportlab)
+uv run pytest                                  # run the suite
+uv run python tests/fixtures/make_fixtures.py  # regenerate fixture PDFs
+```
+
+Verbatim-ness is asserted mechanically: every source string drawn into a fixture must appear in the rendered HTML.
+
+## 📁 Project structure
+
+```
+pdf-html/
+├── src/pdf_html/
+│   ├── cli.py                  # argparse CLI → pipeline → HTML
+│   ├── extractor.py            # PyMuPDF span + table-region extraction
+│   ├── header_footer.py        # repeated page-furniture stripping
+│   ├── style_profiler.py       # font-size histogram → style profile
+│   ├── reading_order.py        # column clustering & span ordering
+│   ├── table_reconstructor.py  # cell assignment, per-cell pipeline, row merging
+│   ├── structure.py            # heading / paragraph / list classification
+│   ├── list_parser.py          # nested list folding
+│   ├── ast.py                  # typed document model
+│   └── renderer.py             # semantic HTML5 + derived CSS
+├── tests/                      # 56 tests + deterministic PDF fixtures
+├── README.md
+└── TUTORIAL.md                 # step-by-step usage guide
+```
+
+## 🛣️ Roadmap
+
+- [x] Ruled-table reconstruction with cross-page row merging
+- [x] Column-aware reading order with card-grid detection
+- [x] Repeated header/footer stripping
+- [ ] Borderless-table detection (whitespace-gap heuristic)
+- [ ] Callout/aside detection (`--no-callouts` flag already reserved)
+- [ ] Dependency-free `pdftotext` fallback extractor
+- [ ] `colspan`/`rowspan` from merged-cell geometry
+
+## 🤝 Contributing
+
+Contributions welcome! Ground rules:
+
+- 🐍 Python 3.10+, type hints throughout
+- 📦 PyMuPDF is the **only** hard runtime dependency
+- 🧩 Keep heuristics small, pure, and individually testable; thresholds as named constants
+- ✅ One feature per commit (`feat|fix|docs|refactor|chore: ...`); update README/TUTORIAL with any user-facing change
+- 🧪 `uv run pytest` must stay green — fixtures are the contract
+
+## 🚀 Releases
+
+This project is intentionally published as an **early-stage v0.x** tool: the core pipeline is solid for text-based PDFs, but it is not a universal PDF converter for scanned pages, forms, or OCR-heavy corpora.
+
+```bash
+# 1. bump version in pyproject.toml
+uv build        # 2. artifacts land in dist/
+uv publish      # 3. push to PyPI (or twine upload dist/*)
+```
+
+## 📄 License
+
+MIT — see [pyproject.toml](pyproject.toml).
+
+---
+
+<div align="center">
+
+**Built with 🐍 + 📐 — early-stage geometry over guesswork.**
+
+*If this project helped you, consider giving it a ⭐!*
+
+</div>