html2pic 0.2.1__tar.gz

html2pic-0.2.1/.gitignore

@@ -0,0 +1,145 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+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
+.hypothesis/
+.pytest_cache/
+
+# 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
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.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
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.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/
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db

html2pic-0.2.1/CHANGELOG.md

@@ -0,0 +1,204 @@
+# Changelog
+
+All notable changes to html2pic will be documented in this file.
+
+## [0.2.0] - 2026-01-10
+
+### ⚠️ BREAKING CHANGES
+
+This release requires **PicTex 2.0** or higher. The underlying layout engine has been migrated to use Taffy (via `stretchable` bindings).
+
+- **`fill-available` size mode removed**: This was a non-standard CSS value internal to PicTex 1.x. Use `flex-grow: 1` in your CSS instead for elements that should fill available space.
+
+### ✨ New Features
+
+- **Full CSS Positioning Support**: Complete implementation of CSS positioning model
+  - `position: relative` with `top`, `right`, `bottom`, `left` offsets
+  - `position: absolute` for parent-relative positioning  
+  - `position: fixed` for canvas-relative positioning
+  - All four inset properties (`top`, `right`, `bottom`, `left`) now supported
+
+- **Flex Item Properties**: Fine-grained flexbox control
+  - `flex-grow`: Control how elements grow to fill available space
+  - `flex-shrink`: Control how elements shrink when space is limited  
+  - `align-self`: Override container's alignment for individual items
+
+- **Multi-line Flex Containers**: 
+  - `flex-wrap: wrap` and `flex-wrap: wrap-reverse` for responsive layouts
+
+- **Size Constraints**:
+  - `min-width`, `max-width`: Set width boundaries
+  - `min-height`, `max-height`: Set height boundaries
+  - All support both pixel and percentage values
+
+- **Aspect Ratio**:
+  - `aspect-ratio`: Maintain element proportions (e.g., `16/9` or `1.777`)
+
+- **CSS Transforms (translate only)**:
+  - `transform: translate(x, y)`, `translateX(x)`, `translateY(y)`
+  - Enables anchor-based centering: `top: 50%; left: 50%; transform: translate(-50%, -50%)`
+
+- **CSS-Standard Values**: Now accepts both CSS standard values (`start`, `end`) and flex-prefixed values (`flex-start`, `flex-end`) for `justify-content` and `align-items`
+
+### 🔧 Improvements
+
+- **Robust Layout Engine**: Migrated to Taffy-based layout engine via PicTex 2.0 for improved flexbox correctness
+- **Better Text Wrapping**: Improved text wrapping behavior in nested containers
+- **Percentage-based Sizing**: More accurate percentage-based width/height calculations
+
+### 🏗️ Internal Changes
+
+- Translator updated to use PicTex 2.0 API:
+  - `justify_content()` replaces `horizontal_distribution()`/`vertical_distribution()`
+  - `align_items()` replaces `vertical_align()`/`horizontal_align()`
+  - Positioning uses keyword arguments (`top=`, `left=`, etc.) instead of positional args
+- Added new helper methods for size constraints, aspect ratio, and flex item properties
+- Updated CSS validation to recognize new properties
+
+## [0.1.3] - 2024-09-13
+
+### ✨ New Features
+- **Individual Border-Radius Properties**: Full support for individual corner border-radius properties
+  - `border-top-left-radius`, `border-top-right-radius`, `border-bottom-left-radius`, `border-bottom-right-radius`
+  - Works alongside existing shorthand `border-radius` property
+  - Support for both px and percentage values for each corner
+  - Proper priority handling: individual properties override shorthand when specified
+
+- **Alpha Channel Color Support**: Enhanced color handling with full alpha channel support
+  - RGBA colors now properly rendered with transparency
+  - Alpha values below 0.01 automatically converted to 'transparent'
+  - Improved color validation and normalization
+  - Full hex RGBA support (#rrggbbaa format)
+
+- **Display None Support**: Complete CSS `display: none` implementation
+  - Elements with `display: none` are completely omitted from rendering
+  - Children of hidden elements are also properly excluded
+  - Zero performance impact for hidden elements (not rendered at all)
+  - Semantically correct behavior matching standard CSS
+
+### 🔧 Improvements
+- Enhanced CSS parser to recognize and validate individual border-radius properties
+- Updated translator to use PicTex's native 4-corner border-radius API
+- Improved color parsing system with better error handling and transparency support
+- Optimized element generation to skip hidden elements entirely
+
+### 🏗️ Architecture Changes
+- Extended CSS property validation lists to include individual border-radius properties
+- Modified translator's `_get_border_radius_values()` to return proper PicTex format
+- Updated style engine's `_normalize_display()` to handle 'none' value
+- Added early return logic in `_create_element_builder()` for display: none elements
+
+## [0.1.2] - 2024-09-13
+
+### ✨ New Features
+- **@font-face Support**: Full CSS @font-face declarations with advanced font loading
+  - Complete @font-face parsing with `font-family`, `src`, `font-weight`, and `font-style` properties
+  - Support for multiple font weights and styles (normal, bold, italic) per font family
+  - Flexible font source paths: relative paths, absolute paths, and URLs
+
+### 🔧 Improvements
+- Enhanced CSS parser to detect and process @font-face at-rules separately from regular CSS rules
+- Added FontRegistry system for managing and resolving font declarations
+- Updated font resolution logic to match fonts by weight and style specifications
+- Improved typography system to use advanced font fallback chains instead of single font selection
+
+### 🏗️ Architecture Changes
+- Added `FontFace` and `FontRegistry` classes to `models.py`
+- Extended CSS parser with @font-face specific parsing methods
+- Updated style engine and translator to integrate font registry throughout the rendering pipeline
+- Modified core `Html2Pic` class to expose font registry in debug information
+
+## [0.1.1] - 2024-09-12
+
+### ✨ New Features
+- **Linear Gradient Support**: Added full support for CSS `linear-gradient()` in backgrounds
+  - Angle-based gradients: `linear-gradient(135deg, #667eea, #764ba2)`
+  - Keyword directions: `linear-gradient(to right, red, blue)`
+  - Color stops with percentages: `linear-gradient(90deg, red 0%, blue 100%)`
+  - Multiple colors with automatic distribution
+  - Support for all CSS color formats (hex, rgb, rgba, named colors)
+
+### 🔧 Improvements
+- Updated documentation with linear-gradient examples and limitations
+- Enhanced background rendering system to handle both images and gradients
+- Improved CSS parser to recognize linear-gradient as supported feature
+
+### 📝 Documentation
+- Added comprehensive linear-gradient documentation to README
+- Updated examples to showcase gradient capabilities
+- Clarified that only linear gradients are supported (radial/conic not yet implemented)
+
+## [0.1.0] - 2024-09-12
+
+### Initial Release
+
+#### ✨ Core Features
+- **HTML to Image Conversion**: Convert HTML + CSS to high-quality images using PicTex as rendering engine
+- **Modern CSS Layout**: Full flexbox support with `display: flex`, `justify-content`, `align-items`, `gap`, etc.
+- **Rich Typography**: Font families, sizes, weights, colors, text decorations, text shadows
+- **Complete Box Model**: Padding, margins, borders, border-radius support
+- **Visual Effects**: Box shadows and text shadows with RGBA color support
+- **Positioning**: Absolute positioning with `left` and `top` properties
+- **Background Images & Gradients**: Support for `background-image` with `url()` syntax and `linear-gradient()`, plus `background-size` (cover, contain, tile)
+
+#### 🏗️ Architecture
+- **Modular Design**: Clean separation of HTML parser, CSS parser, style engine, and translator
+- **Comprehensive Warnings System**: Detailed debugging information for unsupported features
+- **CSS Cascade Engine**: Proper specificity calculations and inheritance
+- **Smart Translation**: Maps HTML/CSS concepts to PicTex builders (Canvas, Row, Column, Text, Image)
+
+#### 📋 Supported HTML Elements
+- Container elements: `div`, `section`, `article`, `header`, `footer`, `main`, `nav`, `aside`
+- Text elements: `h1`-`h6`, `p`, `span`, `strong`, `em`, `b`, `i`, `u`, `s`
+- Media elements: `img`
+- List elements: `ul`, `ol`, `li`
+- Other: `a`, `br`, `hr`
+
+#### 🎨 Supported CSS Features
+- **Layout**: `display` (flex, block, inline), `flex-direction`, `justify-content`, `align-items`, `gap`
+- **Box Model**: `width`, `height`, `padding`, `margin`, `border`, `border-radius`
+- **Typography**: `font-family`, `font-size`, `font-weight`, `font-style`, `color`, `text-align`, `line-height`, `text-decoration`
+- **Visual Effects**: `background-color`, `background-image`, `background-size`, `box-shadow`, `text-shadow`
+- **Positioning**: `position: absolute` with `left` and `top`
+- **Units**: `px`, `em`, `rem`, `%` support
+- **Colors**: Hex, RGB, RGBA, and named colors
+
+#### 🚨 Intelligent Warnings System
+- **CSS Validation**: Warns about unexpected/invalid CSS property values
+- **HTML Element Detection**: Warns about unrecognized or unsupported HTML elements
+- **Feature Limitations**: Clear warnings about unsupported CSS features with alternatives
+- **Color Fallbacks**: Automatic fallback for invalid colors with warnings
+- **Categorized Warnings**: Organized by HTML parsing, CSS parsing, style application, etc.
+
+#### 🔧 Developer Experience
+- **Simple API**: Clean `Html2Pic(html, css).render()` interface
+- **Multiple Output Formats**: PNG, JPG via PicTex integration
+- **Debug Information**: `get_warnings()`, `print_warnings()`, `get_warnings_summary()` methods
+- **Error Handling**: Graceful degradation with informative warnings instead of crashes
+
+#### 🏃‍♂️ Performance Features
+- **Empty Element Optimization**: Only renders elements with visual styles
+- **Smart RGBA Parsing**: Proper handling of RGBA colors in shadows and backgrounds
+- **Efficient Shadow Parsing**: Supports multiple shadows on single elements
+
+#### 🌟 Special Improvements
+- **Fixed Empty Div Rendering**: Empty divs with visual styles (background, borders, shadows) now render correctly
+- **Advanced Shadow Support**: Full CSS shadow syntax with multiple shadows and RGBA colors
+- **Background Image Integration**: Complete CSS background-image support with PicTex backend
+- **Comprehensive Property Validation**: Validates CSS values and provides helpful error messages
+
+### Known Limitations
+- CSS Grid layout not supported (use Flexbox instead)
+- Relative positioning not supported (use absolute positioning)
+- CSS transforms and animations not supported
+- Background gradients not supported (use solid colors or images)
+- Complex selectors (descendants, pseudo-classes) not supported
+
+### Dependencies
+- PicTex: High-quality rendering engine
+- BeautifulSoup4: HTML parsing
+- tinycss2: CSS parsing
+
+---
+
+*This project was developed using AI assistance (Claude Code) for rapid prototyping and implementation.*

html2pic-0.2.1/PKG-INFO

@@ -0,0 +1,367 @@
+Metadata-Version: 2.4
+Name: html2pic
+Version: 0.2.1
+Summary: Convert HTML + CSS to images without a browser
+Project-URL: Homepage, https://github.com/francozanardi/html2pic
+Project-URL: Repository, https://github.com/francozanardi/html2pic.git
+Project-URL: Bug Tracker, https://github.com/francozanardi/html2pic/issues
+Project-URL: Documentation, https://github.com/francozanardi/html2pic/blob/main/README.md
+Project-URL: Examples, https://github.com/francozanardi/html2pic/tree/main/examples
+Author-email: Franco Zanardi <francozanardi97@gmail.com>
+License-Expression: MIT
+Keywords: conversion,css,html,image,rendering
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=3.8
+Requires-Dist: beautifulsoup4>=4.9.0
+Requires-Dist: pictex>=2.0.0
+Requires-Dist: tinycss2>=1.1.0
+Provides-Extra: examples
+Requires-Dist: pillow>=8.0.0; extra == 'examples'
+Description-Content-Type: text/markdown
+
+# html2pic
+
+**Convert HTML + CSS to images — no browser required**
+
+A Python library that transforms HTML and CSS into images.
+
+---
+
+## Features
+
+- **Browser-Free Rendering** — No browser required
+- **CSS Support** — Flexbox layout, gradients, shadows  and more
+- **Output Formats** — PNG, JPG, and SVG (basic support for SVGs)
+
+---
+
+## Installation
+
+```bash
+pip install html2pic
+```
+
+---
+
+## Quick Start
+
+```python
+from html2pic import Html2Pic
+
+html = '''
+<div class="card">
+    <h1>Hello, html2pic!</h1>
+    <p>Transform HTML to images with ease</p>
+</div>
+'''
+
+css = '''
+.card {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    padding: 40px;
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    border-radius: 20px;
+    width: 400px;
+}
+
+h1 {
+    color: white;
+    font-size: 32px;
+    font-weight: bold;
+    margin: 0 0 12px 0;
+}
+
+p {
+    color: rgba(255, 255, 255, 0.9);
+    font-size: 18px;
+    margin: 0;
+}
+'''
+
+renderer = Html2Pic(html, css)
+image = renderer.render()
+image.save("output.png")
+```
+
+**Result:**
+
+![Quick Start Example](https://raw.githubusercontent.com/francozanardi/html2pic/main/examples/01_quick_start_output.png)
+
+---
+
+## How It Works
+
+html2pic translates web markup into PicTex rendering instructions:
+
+```
+HTML + CSS  →  DOM Tree  →  Style Application  →  PicTex Builders  →  Image
+```
+
+1. **Parse HTML** with BeautifulSoup
+2. **Parse CSS** with tinycss2
+3. **Apply Styles** using CSS cascade, specificity, and inheritance
+4. **Translate** styled nodes to PicTex layout primitives (Canvas, Row, Column, Text, Image)
+5. **Render** using PicTex's Skia-based engine
+
+## CSS Support
+
+html2pic supports a comprehensive subset of modern CSS. Here's what you can use:
+
+### Layout
+
+| Property | Values | Notes |
+|----------|--------|-------|
+| `display` | `block`, `flex`, `none` | Flexbox is fully supported |
+| `flex-direction` | `row`, `column`, `row-reverse`, `column-reverse` | |
+| `justify-content` | `start`, `center`, `end`, `space-between`, `space-around`, `space-evenly` | |
+| `align-items` | `start`, `center`, `end`, `stretch` | |
+| `align-self` | Same as `align-items` | Override per-item alignment |
+| `flex-grow` | Number | Control growth ratio |
+| `flex-shrink` | Number | Control shrink ratio |
+| `flex-wrap` | `wrap`, `wrap-reverse`, `nowrap` | Multi-line containers |
+| `gap` | `px`, `%` | Spacing between flex items |
+
+### Box Model
+
+| Property | Values | Notes |
+|----------|--------|-------|
+| `width`, `height` | `px`, `%`, `auto`, `fit-content` | |
+| `min-width`, `max-width` | `px`, `%` | Size constraints |
+| `min-height`, `max-height` | `px`, `%` | Size constraints |
+| `aspect-ratio` | Number or ratio (e.g., `16/9`) | Maintain proportions |
+| `padding` | `px`, `%`, `em`, `rem` | Shorthand and individual sides |
+| `margin` | `px`, `%`, `em`, `rem` | Shorthand and individual sides |
+| `border` | Width, style, color | Styles: `solid`, `dashed`, `dotted` |
+| `border-radius` | `px`, `%` | Shorthand or individual corners |
+
+**Individual corner radius:**
+- `border-top-left-radius`
+- `border-top-right-radius`
+- `border-bottom-left-radius`
+- `border-bottom-right-radius`
+
+### Visual Styling
+
+| Property | Values | Notes |
+|----------|--------|-------|
+| `background-color` | Hex, RGB, RGBA, named | Alpha channel supported |
+| `background-image` | `url()`, `linear-gradient()` | See gradients section below |
+| `background-size` | `cover`, `contain`, `tile` | For images |
+| `box-shadow` | `offset-x offset-y blur color` | RGBA supported |
+
+**Linear Gradients:**
+```css
+/* Angle-based */
+background-image: linear-gradient(135deg, #667eea, #764ba2);
+
+/* Direction keywords */
+background-image: linear-gradient(to right, red, blue);
+
+/* Color stops */
+background-image: linear-gradient(90deg, #ff0000 0%, #00ff00 50%, #0000ff 100%);
+```
+
+### Typography
+
+| Property | Values | Notes |
+|----------|--------|-------|
+| `font-family` | Font names, file paths | See @font-face below |
+| `font-size` | `px`, `em`, `rem` | |
+| `font-weight` | `normal`, `bold`, `100-900` | |
+| `font-style` | `normal`, `italic` | |
+| `color` | Hex, RGB, RGBA, named | |
+| `text-align` | `left`, `right`, `center`, `justify` | |
+| `line-height` | Number, `px`, `%` | |
+| `text-decoration` | `underline`, `line-through` | |
+| `text-shadow` | `offset-x offset-y blur color` | |
+
+**@font-face Support:**
+```css
+@font-face {
+    font-family: "CustomFont";
+    src: url("./fonts/custom.ttf");
+    font-weight: normal;
+    font-style: normal;
+}
+
+@font-face {
+    font-family: "CustomFont";
+    src: url("./fonts/custom-bold.ttf");
+    font-weight: bold;
+}
+
+h1 {
+    font-family: "CustomFont", Arial, sans-serif;
+    font-weight: bold;
+}
+```
+
+**Features:**
+- Multiple weights and styles per family
+- Fallback chains (prioritizes @font-face, then system fonts)
+- Relative, absolute paths, and URLs
+
+### Positioning & Transforms
+
+| Property | Values | Notes |
+|----------|--------|-------|
+| `position` | `static`, `relative`, `absolute`, `fixed` | |
+| `top`, `right`, `bottom`, `left` | `px`, `%`, `em`, `rem` | |
+| `transform` | `translate()`, `translateX()`, `translateY()` | Only translate supported |
+
+**Centering with transforms:**
+```css
+.centered {
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    transform: translate(-50%, -50%);
+}
+```
+
+### Selectors
+
+- **Tag:** `div`, `p`, `h1`, etc.
+- **Class:** `.my-class`
+- **ID:** `#my-id`
+- **Universal:** `*`
+
+---
+
+## Examples
+
+Complete examples with source code are available in the [`examples/`](examples/) directory.
+
+### Basic Card Layout
+
+Simple flexbox card with centered content:
+
+![Quick Start](https://raw.githubusercontent.com/francozanardi/html2pic/main/examples/01_quick_start_output.png)
+
+### User Profile Card
+
+Social media style card with avatar and information:
+
+![Flexbox Card](https://raw.githubusercontent.com/francozanardi/html2pic/main/examples/02_flexbox_card_output.png)
+
+### Typography Showcase
+
+Advanced text styling and formatting:
+
+![Typography](https://raw.githubusercontent.com/francozanardi/html2pic/main/examples/03_typography_showcase_output.png)
+
+### Visual Effects
+
+Shadows, positioning, and advanced styling:
+
+![Shadows and Effects](https://raw.githubusercontent.com/francozanardi/html2pic/main/examples/04_shadows_and_effects_output.png)
+
+### Background Images
+
+Background image support with different sizing modes:
+
+![Background Images](https://raw.githubusercontent.com/francozanardi/html2pic/main/examples/05_background_images_output.png)
+
+[View all examples with source code](examples/)
+
+---
+
+## API Reference
+
+### `Html2Pic(html: str, css: str = "")`
+
+Main renderer class.
+
+**Methods:**
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `render(crop_mode=CropMode.CONTENT_BOX)` | `BitmapImage` | Render to PNG/JPG |
+| `render_as_svg(embed_font=True)` | `VectorImage` | Render to SVG |
+| `debug_info()` | `dict` | Get parsing and styling details |
+
+**Output Formats:**
+
+The returned `BitmapImage` and `VectorImage` objects provide:
+
+```python
+# Save to file
+image.save("output.png")
+
+# Convert to other formats
+numpy_array = image.to_numpy()
+pil_image = image.to_pillow()
+
+# Display
+image.show()
+```
+
+---
+
+## Limitations
+
+html2pic supports a subset of CSS, several features are not implemented:
+
+| Feature | Status | Alternative |
+|---------|--------|-------------|
+| CSS Grid | ❌ Not supported | Use Flexbox |
+| Transforms (rotate, scale, skew) | ❌ Not supported | Only `translate()` works |
+| Animations & Transitions | ❌ Not supported | Generate static images |
+| Radial/Conic Gradients | ❌ Not supported | Use `linear-gradient()` |
+| Complex Selectors | ❌ Not supported | Use simple tag, class, or ID selectors |
+| Pseudo-classes (`:hover`, `:nth-child`) | ❌ Not supported | Apply styles directly |
+| Media Queries | ❌ Not supported | Set explicit dimensions |
+| Overflow & Scrolling | ❌ Not supported | Content must fit container |
+
+---
+
+## Contributing
+
+Contributions are welcome! Please feel free to:
+
+- Report bugs via [GitHub Issues](https://github.com/francozanardi/html2pic/issues)
+- Suggest features or improvements
+- Submit pull requests
+
+For major changes, please open an issue first to discuss your ideas.
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+## Acknowledgments
+
+Built with:
+- **[PicTex](https://github.com/francozanardi/pictex)** — High-performance rendering engine (Skia + Taffy)
+- **[BeautifulSoup](https://www.crummy.com/software/BeautifulSoup/)** — HTML parsing
+- **[tinycss2](https://github.com/Kozea/tinycss2)** — CSS parsing
+
+---
+
+## Version & Status
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and migration guides.
+
+---
+
+## Development Status
+
+**Note:** This software is currently in early alpha stage. It lacks test coverage and may contain bugs or unexpected behavior. Use with caution in production environments and please report any issues you encounter.