rustplotlib 2.0.0__tar.gz → 3.0.0__tar.gz

rustplotlib-3.0.0/CONTRIBUTING.md

@@ -0,0 +1,195 @@
+# Contributing to RustPlotLib
+
+Thanks for wanting to help rebuild matplotlib in Rust! This guide will help you get started quickly.
+
+## How to Pick a Task
+
+1. Open [ROADMAP.md](ROADMAP.md) — every unchecked `[ ]` item is up for grabs
+2. Open a GitHub Issue saying "I'm working on [feature]" to avoid duplicate work
+3. Features are organized by priority version (v3, v4, v5, v6)
+
+**Best first contributions:**
+- Any item in the **v3.0.0** section (formatters, locators, missing plots)
+- Bug fixes and edge cases
+- Improving existing stubs (turning them into real implementations)
+
+## Project Structure
+
+```
+rustplotlib/
+├── src/                          # Rust core (this is where the rendering happens)
+│   ├── lib.rs                    # PyO3 module registration
+│   ├── figure.rs                 # Figure + PyO3 bindings (savefig, render, etc.)
+│   ├── axes.rs                   # Axes (2D plotting area, ~1500 lines)
+│   ├── axes3d.rs                 # Axes3D (3D plotting)
+│   ├── projection3d.rs           # 3D camera + projection math
+│   ├── transforms.rs             # Data coords → pixel coords
+│   ├── colors.rs                 # Color parsing (named, hex, RGB, RGBA)
+│   ├── text.rs                   # Text rendering (ab_glyph + DejaVu Sans font)
+│   ├── ticker.rs                 # Auto-tick computation
+│   ├── svg_renderer.rs           # Native SVG output
+│   ├── window.rs                 # Interactive window (winit + softbuffer)
+│   └── artists/                  # One file per plot type
+│       ├── mod.rs                # Artist trait definition
+│       ├── line2d.rs             # plot()
+│       ├── scatter.rs            # scatter()
+│       ├── bar.rs                # bar()
+│       ├── hist.rs               # hist()
+│       ├── image.rs              # imshow() + colormaps
+│       ├── contour.rs            # contour/contourf
+│       ├── surface3d.rs          # plot_surface()
+│       ├── ... (31 total)
+│       └── legend.rs             # Legend rendering
+│
+├── python/rustplotlib/           # Python API layer
+│   ├── __init__.py               # Package exports
+│   ├── pyplot.py                 # Main API (drop-in replacement for matplotlib.pyplot)
+│   ├── style/__init__.py         # Style themes (dark_background, ggplot, etc.)
+│   ├── animation.py              # FuncAnimation + GIF export
+│   ├── ticker.py                 # Formatters and Locators
+│   ├── dates.py                  # Date handling
+│   ├── ... (23 modules total)
+│   └── mpl_toolkits/mplot3d/     # 3D axes support
+│
+├── tests/                        # Python tests
+│   ├── test_colors.py
+│   ├── test_figure.py
+│   ├── test_pyplot.py
+│   ├── test_3d.py
+│   ├── test_benchmark.py
+│   └── ... (200+ tests)
+│
+├── Cargo.toml                    # Rust dependencies
+├── pyproject.toml                # Python package config (maturin)
+├── README.md                     # Project documentation
+├── ROADMAP.md                    # Feature roadmap with checkboxes
+└── CONTRIBUTING.md               # This file
+```
+
+## How to Add a New Plot Type
+
+Example: adding `spy()` (sparsity pattern)
+
+### Option A: Pure Python (simple cases)
+If the new plot can be built on top of existing Rust functions:
+
+```python
+# In python/rustplotlib/pyplot.py, add to AxesProxy:
+def spy(self, Z, precision=0, **kwargs):
+    import numpy as np
+    Z = np.asarray(Z)
+    mask = np.abs(Z) > precision
+    self.imshow(mask.astype(float), cmap='gray_r', **kwargs)
+    self.set_aspect('equal')
+```
+
+### Option B: Rust Implementation (performance-critical)
+For new rendering that needs to be fast:
+
+**1. Create the artist** (`src/artists/my_plot.rs`):
+```rust
+use crate::artists::Artist;
+use crate::colors::Color;
+use crate::transforms::Transform;
+
+pub struct MyPlot {
+    pub data: Vec<f64>,
+    pub color: Color,
+    pub label: Option<String>,
+}
+
+impl Artist for MyPlot {
+    fn draw(&self, pixmap: &mut tiny_skia::Pixmap, transform: &Transform) {
+        // Draw using tiny-skia
+    }
+    fn data_bounds(&self) -> (f64, f64, f64, f64) {
+        // Return (xmin, xmax, ymin, ymax)
+    }
+    fn legend_label(&self) -> Option<&str> { self.label.as_deref() }
+    fn legend_color(&self) -> Color { self.color }
+}
+```
+
+**2. Register in** `src/artists/mod.rs`:
+```rust
+pub mod my_plot;
+```
+
+**3. Add method to Axes** (`src/axes.rs`):
+```rust
+pub fn my_plot(&mut self, data: Vec<f64>, color: Option<Color>) {
+    let c = color.unwrap_or_else(|| self.next_color());
+    self.artists.push(Box::new(my_plot::MyPlot { data, color: c, label: None }));
+}
+```
+
+**4. Add PyO3 binding** (`src/figure.rs`):
+```rust
+fn axes_my_plot(&mut self, ax_id: usize, data: Vec<f64>, kwargs: &Bound<'_, PyDict>) -> PyResult<()> {
+    let ax = self.axes.get_mut(ax_id).ok_or_else(|| ...)?;
+    let color = if let Some(c) = kwargs.get_item("color")? { Some(parse_color_value(&c)?) } else { None };
+    ax.my_plot(data, color);
+    Ok(())
+}
+```
+
+**5. Add Python wrapper** (`python/rustplotlib/pyplot.py`):
+```python
+# In AxesProxy:
+def my_plot(self, data, **kwargs):
+    self._fig.axes_my_plot(self._id, _to_list(data), kwargs)
+
+# Module level:
+def my_plot(data, **kwargs):
+    _gca().my_plot(data, **kwargs)
+```
+
+**6. Add test** (`tests/test_my_plot.py`):
+```python
+def test_my_plot():
+    import rustplotlib.pyplot as plt
+    plt.my_plot([1, 2, 3])
+    plt.savefig("/tmp/test_my_plot.png")
+    plt.close()
+    import os
+    assert os.path.exists("/tmp/test_my_plot.png")
+    os.remove("/tmp/test_my_plot.png")
+```
+
+## Development Setup
+
+```bash
+# Clone
+git clone https://github.com/Thi4gon/rustplotlib.git
+cd rustplotlib
+
+# Setup (requires Rust and Python 3.9+)
+python -m venv .venv
+source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+pip install maturin numpy pytest
+
+# Build
+maturin develop
+
+# Test
+pytest tests/ -v
+
+# Build release (for benchmarks)
+maturin develop --release
+```
+
+## Code Style
+
+- **Rust:** standard rustfmt, no `unsafe`, proper error handling (no `.unwrap()` on user input)
+- **Python:** keep it simple, follow existing patterns in pyplot.py
+- **Tests:** every new feature needs at least one test
+- **Security:** validate all inputs at PyO3 boundary, no path traversal, no panics
+
+## PR Checklist
+
+- [ ] All existing tests pass (`pytest tests/ -v`)
+- [ ] New tests added for new features
+- [ ] `maturin develop` compiles without errors
+- [ ] No new warnings in Rust compilation
+- [ ] README.md updated if adding user-facing features
+- [ ] ROADMAP.md checkbox checked for completed items

{rustplotlib-2.0.0 → rustplotlib-3.0.0}/Cargo.lock

@@ -1368,7 +1368,7 @@ dependencies = [
 
 [[package]]
 name = "rustplotlib"
-version = "2.0.0"
+version = "3.0.0"
 dependencies = [
  "ab_glyph",
  "numpy",

{rustplotlib-2.0.0 → rustplotlib-3.0.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rustplotlib"
-version = "2.0.0"
+version = "3.0.0"
 edition = "2021"
 readme = "README.md"
 

{rustplotlib-2.0.0 → rustplotlib-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rustplotlib
-Version: 2.0.0
+Version: 3.0.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
@@ -87,15 +87,16 @@ plt.show()
 
 ## What's Implemented
 
-### 2D Plot Types (17 types)
+### 2D Plot Types (30+ types)
 | Function | Description |
 |---|---|
-| `plot()` | Line plots with color, linestyle, linewidth, markers, markevery, labels, alpha |
-| `scatter()` | Scatter plots with per-point sizes, colors, markers, alpha |
-| `bar()` / `barh()` | Vertical and horizontal bar charts (stacked via `bottom` param) |
+| `plot()` | Line plots with color, linestyle, linewidth, markers, markevery, labels, alpha, zorder |
+| `scatter()` | Scatter plots with per-point sizes, colors, markers, alpha, zorder |
+| `bar()` / `barh()` | Vertical and horizontal bar charts (stacked, hatch patterns, zorder) |
 | `hist()` | Histograms with configurable bins |
-| `imshow()` | Image/heatmap display with 35+ colormaps |
+| `imshow()` | Image/heatmap display with 70+ colormaps, bilinear interpolation, annotations |
 | `fill_between()` / `fill_betweenx()` | Filled area between curves (vertical and horizontal) |
+| `fill()` | Filled polygon from vertex arrays |
 | `errorbar()` | Error bars with caps (xerr/yerr) |
 | `step()` | Step plots (pre/post/mid) |
 | `pie()` | Pie charts with labels |
@@ -106,8 +107,20 @@ plt.show()
 | `hexbin()` | Hexagonal binning for 2D histograms |
 | `quiver()` | Vector field arrows |
 | `streamplot()` | Streamlines for vector fields (Euler integration) |
-
-### 3D Plot Types (5 types)
+| `stackplot()` | Stacked area charts |
+| `broken_barh()` | Broken horizontal bar charts |
+| `eventplot()` | Event/raster plots |
+| `pcolormesh()` / `pcolor()` | Pseudocolor plots for irregular grids |
+| `matshow()` | Matrix display with integer ticks |
+| `radar()` | Radar/spider charts |
+| `sankey()` | Sankey flow diagrams |
+| `spy()` | Sparsity pattern visualization |
+| `stairs()` | Step-wise constant function with edges |
+| `ecdf()` | Empirical cumulative distribution |
+| `triplot()` | Triangulation edge drawing |
+| `pcolormesh()` / `pcolor()` already listed above |
+
+### 3D Plot Types (7 types)
 | Function | Description |
 |---|---|
 | `plot()` (3D) | 3D line plots |
@@ -115,6 +128,8 @@ plt.show()
 | `plot_surface()` | 3D surface plots with colormaps |
 | `plot_wireframe()` | 3D wireframe plots |
 | `bar3d()` | 3D bar charts with shading |
+| `plot_trisurf()` | 3D triangulated surface |
+| `contour3D()` | 3D contour lines at Z offset |
 
 ### Layout & Figure
 | Function | Description |
@@ -145,7 +160,9 @@ plt.show()
 | `axis('off')` | Hide axes completely |
 | `set_facecolor()` | Axes background color |
 | `spines['right'].set_visible(False)` | Spine customization |
-| `twinx()` | Secondary y-axis |
+| `twinx()` / `twiny()` | Secondary y-axis / x-axis |
+| `zorder` | Drawing order control for all artists |
+| `hatch` | Hatch patterns for bars (`/`, `\\`, `|`, `-`, `+`, `x`, `o`, `.`, `*`) |
 | `legend()` | Legend with line+marker swatches and positioning |
 | `grid()` | Grid lines with color, linewidth, linestyle, alpha, which |
 | `text()` | Positioned text annotations |
@@ -191,9 +208,13 @@ plt.show()
 - **Format strings:** `"r--o"` = red + dashed + circle markers
 - **markevery:** show marker every N points
 
-### Colormaps (35+)
+### Colormaps (70+)
+35 base colormaps + all reversed variants (`_r` suffix):
+
 `viridis` `plasma` `inferno` `magma` `cividis` `twilight` `turbo` `hot` `cool` `gray` `jet` `spring` `summer` `autumn` `winter` `copper` `bone` `pink` `binary` `gist_heat` `ocean` `terrain` `Blues` `Reds` `Greens` `YlOrRd` `YlGnBu` `RdYlBu` `RdBu` `PiYG` `PRGn` `BrBG` `Spectral` `Set1` `Set2` `Set3` `Pastel1` `Pastel2` `tab20`
 
+All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
+
 ### Text Rendering
 - Embedded DejaVu Sans font (no system font dependency)
 - LaTeX-to-Unicode conversion (`$\theta$` -> theta, `$x_1$` -> x1, Greek letters, sub/superscripts, math operators)
@@ -205,21 +226,31 @@ plt.show()
 - **Dates:** `date2num()`, `num2date()`, date formatters and locators
 - **Categorical axes:** string-based x values automatically converted
 
-### Compatibility Modules
+### Compatibility Modules (23 modules)
 | Module | Status |
 |---|---|
-| `rustplotlib.pyplot` | Full implementation |
+| `rustplotlib.pyplot` | Full implementation (50+ functions) |
 | `rustplotlib.style` | Full implementation (6 themes) |
 | `rustplotlib.animation` | FuncAnimation + GIF export |
 | `rustplotlib.widgets` | Stubs (Slider, Button, CheckButtons, RadioButtons, TextBox, Cursor) |
-| `rustplotlib.font_manager` | FontProperties stub |
-| `rustplotlib.ticker` | FormatStrFormatter stub |
+| `rustplotlib.font_manager` | FontProperties |
+| `rustplotlib.ticker` | FormatStrFormatter |
 | `rustplotlib.patches` | Rectangle, Circle, Polygon, FancyBboxPatch, Wedge |
 | `rustplotlib.colors` | LinearSegmentedColormap, Normalize, LogNorm |
 | `rustplotlib.dates` | Date conversion, formatters, locators |
 | `rustplotlib.gridspec` | GridSpec, SubplotSpec |
-| `rustplotlib.backends` | Backend system with `use()` |
+| `rustplotlib.backends` | Backend system, PdfPages |
 | `rustplotlib.mpl_toolkits.mplot3d` | Axes3D for 3D plotting |
+| `rustplotlib.cm` | Colormap access by name |
+| `rustplotlib.collections` | LineCollection, PathCollection, PatchCollection |
+| `rustplotlib.lines` | Line2D with get/set methods |
+| `rustplotlib.text` | Text, Annotation |
+| `rustplotlib.transforms` | Bbox, Affine2D, BboxTransform |
+| `rustplotlib.patheffects` | Stroke, withStroke, SimplePatchShadow |
+| `rustplotlib.spines` | Spine |
+| `rustplotlib.axes` | Axes class reference |
+| `rustplotlib.figure` | Figure class reference |
+| `rustplotlib.cycler` | cycler compatibility |
 
 ---
 
@@ -389,11 +420,21 @@ Contributions are welcome! This is an open-source project under the MIT license.
 3. Open a PR against `master`
 4. PRs require at least 1 review before merging
 
+**Project stats:**
+- **45+ Rust source files** — 15,000+ lines of native code
+- **23 Python modules** — 4,000+ lines of API
+- **37+ artist types** (30 2D + 7 3D)
+- **70+ colormaps** (35 base + 35 reversed)
+- **228 tests** passing
+- **12 formatters + 10 locators**
+- **RGB/RGBA imshow** support
+- **Zero `unsafe` blocks**
+
 **Priority areas for contribution:**
 - Turning stub modules into full implementations (widgets, formatters/locators)
-- Adding more colormaps with exact matplotlib data
 - Improving SVG output fidelity
-- Jupyter inline display support
+- Interactive 3D (mouse rotation)
+- Qt/GTK backends
 - More comprehensive test coverage
 
 ---

{rustplotlib-2.0.0 → rustplotlib-3.0.0}/README.md

@@ -67,15 +67,16 @@ plt.show()
 
 ## What's Implemented
 
-### 2D Plot Types (17 types)
+### 2D Plot Types (30+ types)
 | Function | Description |
 |---|---|
-| `plot()` | Line plots with color, linestyle, linewidth, markers, markevery, labels, alpha |
-| `scatter()` | Scatter plots with per-point sizes, colors, markers, alpha |
-| `bar()` / `barh()` | Vertical and horizontal bar charts (stacked via `bottom` param) |
+| `plot()` | Line plots with color, linestyle, linewidth, markers, markevery, labels, alpha, zorder |
+| `scatter()` | Scatter plots with per-point sizes, colors, markers, alpha, zorder |
+| `bar()` / `barh()` | Vertical and horizontal bar charts (stacked, hatch patterns, zorder) |
 | `hist()` | Histograms with configurable bins |
-| `imshow()` | Image/heatmap display with 35+ colormaps |
+| `imshow()` | Image/heatmap display with 70+ colormaps, bilinear interpolation, annotations |
 | `fill_between()` / `fill_betweenx()` | Filled area between curves (vertical and horizontal) |
+| `fill()` | Filled polygon from vertex arrays |
 | `errorbar()` | Error bars with caps (xerr/yerr) |
 | `step()` | Step plots (pre/post/mid) |
 | `pie()` | Pie charts with labels |
@@ -86,8 +87,20 @@ plt.show()
 | `hexbin()` | Hexagonal binning for 2D histograms |
 | `quiver()` | Vector field arrows |
 | `streamplot()` | Streamlines for vector fields (Euler integration) |
-
-### 3D Plot Types (5 types)
+| `stackplot()` | Stacked area charts |
+| `broken_barh()` | Broken horizontal bar charts |
+| `eventplot()` | Event/raster plots |
+| `pcolormesh()` / `pcolor()` | Pseudocolor plots for irregular grids |
+| `matshow()` | Matrix display with integer ticks |
+| `radar()` | Radar/spider charts |
+| `sankey()` | Sankey flow diagrams |
+| `spy()` | Sparsity pattern visualization |
+| `stairs()` | Step-wise constant function with edges |
+| `ecdf()` | Empirical cumulative distribution |
+| `triplot()` | Triangulation edge drawing |
+| `pcolormesh()` / `pcolor()` already listed above |
+
+### 3D Plot Types (7 types)
 | Function | Description |
 |---|---|
 | `plot()` (3D) | 3D line plots |
@@ -95,6 +108,8 @@ plt.show()
 | `plot_surface()` | 3D surface plots with colormaps |
 | `plot_wireframe()` | 3D wireframe plots |
 | `bar3d()` | 3D bar charts with shading |
+| `plot_trisurf()` | 3D triangulated surface |
+| `contour3D()` | 3D contour lines at Z offset |
 
 ### Layout & Figure
 | Function | Description |
@@ -125,7 +140,9 @@ plt.show()
 | `axis('off')` | Hide axes completely |
 | `set_facecolor()` | Axes background color |
 | `spines['right'].set_visible(False)` | Spine customization |
-| `twinx()` | Secondary y-axis |
+| `twinx()` / `twiny()` | Secondary y-axis / x-axis |
+| `zorder` | Drawing order control for all artists |
+| `hatch` | Hatch patterns for bars (`/`, `\\`, `|`, `-`, `+`, `x`, `o`, `.`, `*`) |
 | `legend()` | Legend with line+marker swatches and positioning |
 | `grid()` | Grid lines with color, linewidth, linestyle, alpha, which |
 | `text()` | Positioned text annotations |
@@ -171,9 +188,13 @@ plt.show()
 - **Format strings:** `"r--o"` = red + dashed + circle markers
 - **markevery:** show marker every N points
 
-### Colormaps (35+)
+### Colormaps (70+)
+35 base colormaps + all reversed variants (`_r` suffix):
+
 `viridis` `plasma` `inferno` `magma` `cividis` `twilight` `turbo` `hot` `cool` `gray` `jet` `spring` `summer` `autumn` `winter` `copper` `bone` `pink` `binary` `gist_heat` `ocean` `terrain` `Blues` `Reds` `Greens` `YlOrRd` `YlGnBu` `RdYlBu` `RdBu` `PiYG` `PRGn` `BrBG` `Spectral` `Set1` `Set2` `Set3` `Pastel1` `Pastel2` `tab20`
 
+All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
+
 ### Text Rendering
 - Embedded DejaVu Sans font (no system font dependency)
 - LaTeX-to-Unicode conversion (`$\theta$` -> theta, `$x_1$` -> x1, Greek letters, sub/superscripts, math operators)
@@ -185,21 +206,31 @@ plt.show()
 - **Dates:** `date2num()`, `num2date()`, date formatters and locators
 - **Categorical axes:** string-based x values automatically converted
 
-### Compatibility Modules
+### Compatibility Modules (23 modules)
 | Module | Status |
 |---|---|
-| `rustplotlib.pyplot` | Full implementation |
+| `rustplotlib.pyplot` | Full implementation (50+ functions) |
 | `rustplotlib.style` | Full implementation (6 themes) |
 | `rustplotlib.animation` | FuncAnimation + GIF export |
 | `rustplotlib.widgets` | Stubs (Slider, Button, CheckButtons, RadioButtons, TextBox, Cursor) |
-| `rustplotlib.font_manager` | FontProperties stub |
-| `rustplotlib.ticker` | FormatStrFormatter stub |
+| `rustplotlib.font_manager` | FontProperties |
+| `rustplotlib.ticker` | FormatStrFormatter |
 | `rustplotlib.patches` | Rectangle, Circle, Polygon, FancyBboxPatch, Wedge |
 | `rustplotlib.colors` | LinearSegmentedColormap, Normalize, LogNorm |
 | `rustplotlib.dates` | Date conversion, formatters, locators |
 | `rustplotlib.gridspec` | GridSpec, SubplotSpec |
-| `rustplotlib.backends` | Backend system with `use()` |
+| `rustplotlib.backends` | Backend system, PdfPages |
 | `rustplotlib.mpl_toolkits.mplot3d` | Axes3D for 3D plotting |
+| `rustplotlib.cm` | Colormap access by name |
+| `rustplotlib.collections` | LineCollection, PathCollection, PatchCollection |
+| `rustplotlib.lines` | Line2D with get/set methods |
+| `rustplotlib.text` | Text, Annotation |
+| `rustplotlib.transforms` | Bbox, Affine2D, BboxTransform |
+| `rustplotlib.patheffects` | Stroke, withStroke, SimplePatchShadow |
+| `rustplotlib.spines` | Spine |
+| `rustplotlib.axes` | Axes class reference |
+| `rustplotlib.figure` | Figure class reference |
+| `rustplotlib.cycler` | cycler compatibility |
 
 ---
 
@@ -369,11 +400,21 @@ Contributions are welcome! This is an open-source project under the MIT license.
 3. Open a PR against `master`
 4. PRs require at least 1 review before merging
 
+**Project stats:**
+- **45+ Rust source files** — 15,000+ lines of native code
+- **23 Python modules** — 4,000+ lines of API
+- **37+ artist types** (30 2D + 7 3D)
+- **70+ colormaps** (35 base + 35 reversed)
+- **228 tests** passing
+- **12 formatters + 10 locators**
+- **RGB/RGBA imshow** support
+- **Zero `unsafe` blocks**
+
 **Priority areas for contribution:**
 - Turning stub modules into full implementations (widgets, formatters/locators)
-- Adding more colormaps with exact matplotlib data
 - Improving SVG output fidelity
-- Jupyter inline display support
+- Interactive 3D (mouse rotation)
+- Qt/GTK backends
 - More comprehensive test coverage
 
 ---

rustplotlib-3.0.0/ROADMAP.md

@@ -0,0 +1,189 @@
+# RustPlotLib Roadmap
+
+Goal: Full matplotlib reimplementation in Rust.
+
+---
+
+## DONE — v2.0.0
+
+### 2D Plot Types (26 implemented)
+- [x] plot, scatter, bar, barh, hist, imshow, fill_between, fill_betweenx, fill
+- [x] errorbar, step, pie, boxplot, violinplot, stem
+- [x] contour, contourf, hexbin, quiver, streamplot
+- [x] stackplot, broken_barh, eventplot, pcolormesh/pcolor, matshow, sankey
+
+### 3D Plot Types (7 implemented)
+- [x] plot3D, scatter3D, plot_surface, plot_wireframe, bar3d, plot_trisurf, contour3D
+
+### Drawing Elements (10 implemented)
+- [x] arrow, axhline, axvline, axhspan, axvspan, axline, hlines, vlines, annotate, text
+
+### Rendering
+- [x] PNG raster (tiny-skia), Native SVG (vector), PDF, Interactive window, GIF animation
+
+### Customization
+- [x] Log scale, twinx/twiny, spines, tick_params, zorder, hatch patterns
+- [x] Colorbar, 6 style themes, 70+ colormaps, custom fonts, rcParams (30+ keys)
+- [x] bbox_inches='tight', bilinear interpolation, title loc, multi-group plot
+- [x] Aspect ratio, invert axes, axis off, subplot_mosaic, suptitle, subplots_adjust
+
+### Compatibility Modules (23)
+- [x] pyplot, style, animation, widgets, font_manager, ticker, patches, colors
+- [x] dates, gridspec, backends, mpl_toolkits.mplot3d, cm, collections, lines
+- [x] text, transforms, patheffects, spines, axes, figure, cycler
+
+### Data Integration
+- [x] Pandas, NumPy, NaN handling, dates, categorical axes, imread/imsave
+
+### Security
+- [x] Zero unsafe, path validation, dimension limits, no panics on user input
+
+---
+
+## IN PROGRESS — v3.0.0
+
+### Missing Plot Types
+- [ ] `spy()` — sparsity pattern visualization
+- [ ] `specgram()` — spectrogram
+- [ ] `acorr()` / `xcorr()` — auto/cross correlation
+- [ ] `angle_spectrum()` / `magnitude_spectrum()` / `phase_spectrum()`
+- [ ] `cohere()` — coherence plot
+- [ ] `csd()` / `psd()` — cross/power spectral density
+- [ ] `ecdf()` — empirical cumulative distribution
+- [ ] `stairs()` — step plot with edges
+- [ ] `tricontour()` / `tricontourf()` — contour on triangulation
+- [ ] `tripcolor()` — pseudocolor on triangulation
+- [ ] `triplot()` — plot triangulation edges
+
+### Formatters & Locators (functional, not stubs)
+- [ ] `ScalarFormatter` — default number formatting
+- [ ] `LogFormatter` / `LogFormatterSciNotation`
+- [ ] `EngFormatter` — engineering notation (1k, 1M, 1G)
+- [ ] `PercentFormatter`
+- [ ] `StrMethodFormatter` / `FuncFormatter`
+- [ ] `MaxNLocator` — smart tick placement (partial, have auto_ticks)
+- [ ] `MultipleLocator` — ticks at multiples
+- [ ] `LogLocator` — logarithmic ticks
+- [ ] `FixedLocator` — user-specified positions
+- [ ] `AutoMinorLocator` — automatic minor ticks
+- [ ] `DateFormatter` functional (format ticks as dates)
+- [ ] `DateLocator` functional (place ticks at date intervals)
+
+### Advanced Customization
+- [ ] `FancyArrowPatch` — complex arrow styles (arc, angle, etc.)
+- [ ] `ConnectionPatch` — arrows connecting different axes
+- [ ] Spine positioning (`set_position('center')`, `set_position(('data', 0))`)
+- [ ] Minor ticks rendering (major/minor tick distinction)
+- [ ] Grid major/minor separate styling
+- [ ] `ax.set_xticks(minor=True)` functional
+- [ ] Colorbar as separate Axes (not inline drawing)
+- [ ] `TwoSlopeNorm`, `CenteredNorm`, `BoundaryNorm` functional
+
+### Image Improvements
+- [ ] Bicubic, Lanczos, Spline interpolation
+- [ ] Image origin ('upper' vs 'lower')
+- [ ] Image extent parameter
+- [ ] RGB/RGBA image support in imshow
+
+---
+
+## PLANNED — v4.0.0
+
+### Functional Backends
+- [ ] Qt backend (QApplication, mouse events, toolbar, save dialog)
+- [ ] GTK3/GTK4 backend
+- [ ] Tk backend (tkinter integration)
+- [ ] Jupyter inline backend (rich display protocol, `_repr_png_`)
+- [ ] WebAgg (HTML5 Canvas, browser-based interactive)
+- [ ] macOS native backend (NSView/Metal)
+
+### Functional Widgets
+- [ ] `Slider` with real callback and visual rendering
+- [ ] `RangeSlider`
+- [ ] `Button` with click detection
+- [ ] `CheckButtons` / `RadioButtons`
+- [ ] `TextBox` with keyboard input
+- [ ] `SpanSelector` / `RectangleSelector` / `LassoSelector` functional
+- [ ] `Cursor` with crosshair rendering
+
+### Interactive Features
+- [ ] Mouse events (click, motion, scroll, pick)
+- [ ] Keyboard events
+- [ ] Zoom/pan navigation toolbar
+- [ ] 3D mouse rotation
+- [ ] Blitting for fast animation updates
+- [ ] Interactive data cursors
+
+---
+
+## PLANNED — v5.0.0
+
+### Full LaTeX Math Rendering
+- [ ] TeX layout engine (fractions, roots, integrals, summation)
+- [ ] Subscript/superscript positioning
+- [ ] Math font rendering (Computer Modern, STIX)
+- [ ] `\frac{}{}`, `\sqrt{}`, `\int`, `\sum`, `\prod`
+- [ ] Matrices, arrays, aligned equations
+- [ ] `\mathbf{}`, `\mathit{}`, `\mathrm{}`
+
+### Advanced Layout
+- [ ] Tight layout engine (constraint solver)
+- [ ] Constrained layout
+- [ ] GridSpec with rowspan/colspan
+- [ ] Figure.add_axes() with custom position [left, bottom, width, height]
+- [ ] Axes divider (mpl_toolkits.axes_grid1)
+- [ ] `make_axes_locatable` for colorbar positioning
+- [ ] Nested subplots
+
+### Transform System
+- [ ] Composable transforms (data → axes → figure → display)
+- [ ] `ax.transData`, `ax.transAxes`, `fig.transFigure`
+- [ ] Blended transforms
+- [ ] Custom projections
+- [ ] Affine2D functional (rotate, scale, translate)
+- [ ] `ax.set_transform()` on artists
+
+---
+
+## PLANNED — v6.0.0
+
+### Geographic/Specialized Projections
+- [ ] Polar projection improvements (theta direction, offset)
+- [ ] Hammer, Aitoff, Mollweide projections
+- [ ] Lambert conformal conic
+- [ ] Stereographic projection
+- [ ] Basemap-like coastlines and borders (optional data)
+
+### Serialization
+- [ ] Pickle save/load figures
+- [ ] JSON export/import of figure state
+- [ ] Copy to system clipboard (PNG)
+- [ ] Multi-page PDF (real, not separate files)
+
+### Full Artist Hierarchy
+- [ ] Artist base class with all properties (alpha, clip, zorder, transform, visible, picker, animated, label, url)
+- [ ] `set_clip_path()`, `set_clip_box()`
+- [ ] `contains()` for hit testing
+- [ ] `get_children()`, `findobj()`
+- [ ] `draw()` dispatch through artist tree
+- [ ] `stale` property for incremental redraw
+
+### Remaining API Surface
+- [ ] 100% of `matplotlib.pyplot` functions
+- [ ] 100% of `Axes` methods
+- [ ] 100% of `Figure` methods
+- [ ] Image comparison regression tests vs matplotlib output
+- [ ] Full API documentation with examples
+- [ ] Type stubs (.pyi) for all modules
+
+---
+
+## Contributing
+
+Pick any unchecked item, open an issue to discuss, submit a PR with tests.
+
+**Highest impact areas:**
+1. Formatters/Locators (v3.0.0) — makes axes look professional
+2. Jupyter backend (v4.0.0) — huge for data scientists
+3. LaTeX rendering (v5.0.0) — needed for scientific papers
+4. Interactive features (v4.0.0) — needed for exploratory analysis