chore(release): bump version to 0.4.0

This release introduces image scaling for terminal graphics (Sixel, Kitty)
and allows direct image instantiation in Python.

It also includes significant refactoring of terminal state management and
the Sixel processing pipeline, alongside performance optimizations for
Sixel color quantization and dithering. Python bindings received enhanced
docstrings and type hints.

BREAKING CHANGE: Canvas.drawText method parameter order changed from
(x, y, text, font, color) to (x, y, text, color, font).

Author: arrufat

CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.4.0] - 2025-08-06
+
+### Added
+
+#### Terminal Graphics
+- **Image Scaling Support**: Terminal graphics protocols now support image scaling
+  - Sixel: Added optional `width` and `height` fields to `sixel.Options` for image scaling
+  - Kitty: Added optional `width` and `height` fields to `kitty.Options` for image scaling
+  - Allows images to be scaled (perserving aspect-ratio) before transmission to terminal
+
+### Changed
+- **Terminal Architecture**: Refactored terminal state management
+  - Encapsulated state management in new `terminal.zig` module
+  - Replaced `TerminalSupport.zig` with more modular design
+- **Sixel Processing**: Refactored image processing pipeline
+  - Color lookup table now implemented as value type
+  - Optimized image preparation for dithering
+  - Better separation of concerns in processing stages
+
+### Performance
+- Optimized Sixel color quantization and dithering preparation
+- More efficient color lookup table implementation
+
 ## [0.3.0] - 2025-08-04
 
 ### Added

bindings/python/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Python Bindings Changelog
 
+## [0.4.0] - 2025-08-06
+
+### Added
+- **Image Instantiation**: Create images directly from Python
+  - `Image(rows, cols)` - Create image with specified dimensions
+  - `Image(rows, cols, color="white")` - Create with initial color
+- **Terminal Image Scaling**: Scale images for terminal display
+  - Sixel format: `format(image, "sixel:800x600")` scales to fit before display
+  - Kitty format: `format(image, "kitty:800x600")` scales to fit before display
+  - Supports partial specifications: `"sixel:800x"` (width only), `"sixel:x600"` (height only)
+
+### Changed
+- **Breaking**: Canvas `drawText` method parameter order changed
+  - Old: `drawText(x, y, text, font, color)`
+  - New: `drawText(x, y, text, color, font)`
+- **Documentation**: Enhanced docstrings and type hints
+  - Added comprehensive `__init__` docstrings for all classes
+  - Modernized type hints using pipe operator (`|`) syntax
+  - Improved IDE autocomplete support
+
+### Internal
+- Simplified font handling in Canvas text drawing
+- Extracted RGBA attribute parsing to shared utilities
+- Better error messages for invalid color types
+- Improved Python stub generation
+
 ## [0.3.0] - 2025-08-04
 
 ### Added

bindings/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "zignal-processing"
-version = "0.4.0.dev1"
+version = "0.4.0"
 description = "Zero-dependency image processing library"
 readme = "README.md"
 authors = [{name = "zignal contributors"}]

build.zig.zon

@@ -1,6 +1,6 @@
 .{
     .name = .zignal,
-    .version = "0.4.0-dev",
+    .version = "0.4.0",
     .fingerprint = 0x5303c43db377b63a,
     .minimum_zig_version = "0.15.0-dev.1034+bd97b6618",
     .dependencies = .{},