rustplotlib 4.0.1__tar.gz → 5.0.0__tar.gz

{rustplotlib-4.0.1 → rustplotlib-5.0.0}/CLAUDE.md

@@ -6,14 +6,18 @@ Reimplementação completa do matplotlib em Rust puro. Drop-in replacement via P
 
 - Sempre responder em português (pt-BR)
 
-## Estado Atual — v4.0.0
+## Estado Atual — v5.0.0 (Phase 1 + Phase 2)
 
 - 40+ plot types 2D, 7 plot types 3D
 - 70+ colormaps (35 base + 35 reversed)
-- 21 módulos Python compatíveis com API matplotlib
-- 267 testes passando
+- 25 módulos Python compatíveis com API matplotlib
+- 298 testes passando
+- Tk backend interativo com toolbar, eventos de mouse/teclado e navegação
+- Jupyter rich display (`_repr_png_`, `_repr_svg_`, `_repr_html_`)
+- Sistema de eventos com `CallbackRegistry` e `mpl_connect`/`mpl_disconnect`
+- Backend auto-detection (inline/tk/agg)
 - Output: PNG (tiny-skia), SVG nativo, PDF, GIF, janela interativa
-- Performance: até 30x mais rápido que matplotlib
+- Performance: até 16x mais rápido que matplotlib (benchmark real com 12 testes)
 - Zero blocos `unsafe` em todo o código Rust
 
 ## Estrutura do Projeto
@@ -41,10 +45,13 @@ python/rustplotlib/           # Camada Python
 ├── style/                    # Temas (dark_background, ggplot, seaborn, bmh, fivethirtyeight)
 ├── animation.py              # FuncAnimation + GIF
 ├── ticker.py                 # 12 Formatters + 10 Locators funcionais
+├── backends/                 # backend_base, backend_inline, backend_tk, backend_pdf
+├── events.py                 # MouseEvent, KeyEvent, DrawEvent, ResizeEvent, CloseEvent
+├── callback_registry.py      # CallbackRegistry (mpl_connect/mpl_disconnect)
 ├── dates.py, colors.py, patches.py, ...
 └── mpl_toolkits/mplot3d/     # Suporte 3D
 
-tests/                        # Testes Python (267 testes)
+tests/                        # Testes Python (298 testes)
 ```
 
 ## Stack Técnica
@@ -95,15 +102,15 @@ cargo check                  # Verificar compilação Rust
 - **Manter compatibilidade com API do matplotlib** — mesmos nomes de funções e parâmetros
 - **Atualizar ROADMAP.md e README.md** ao completar features
 
-## Roadmap Ativo (próximo: v5.0.0)
+## Roadmap Ativo (próximo: v5.1.0)
 
 Próximos itens prioritários (ver ROADMAP.md para lista completa):
 
-1. **Jupyter inline backend** — rich display protocol, _repr_png_
-2. **Backends interativos** — Qt, GTK, macOS native
-3. **Widgets funcionais** — Slider, Button, CheckButtons com renderização real
-4. **Features interativas** — mouse events, zoom/pan, rotação 3D
-5. **Triangulation plots** — tricontour, tricontourf, tripcolor (atualmente stubs)
+1. **Backends adicionais** — Qt, GTK, WebAgg, macOS native
+2. **Widgets funcionais** — Slider, Button, CheckButtons com renderização real
+3. **Features interativas** — pick events, rotação 3D, blitting
+4. **Triangulation plots** — tricontour, tricontourf, tripcolor (atualmente stubs)
+5. **Customização avançada** — spine positioning, TwoSlopeNorm, interpolação bicúbica
 
 ## Git
 

{rustplotlib-4.0.1 → rustplotlib-5.0.0}/Cargo.lock

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

{rustplotlib-4.0.1 → rustplotlib-5.0.0}/Cargo.toml

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

{rustplotlib-4.0.1 → rustplotlib-5.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rustplotlib
-Version: 4.0.1
+Version: 5.0.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
@@ -198,9 +198,23 @@ plt.show()
 | `savefig("file.png")` | Raster PNG (with dpi, transparent options) |
 | `savefig("file.svg")` | Native vector SVG (real `<line>`, `<text>`, `<rect>` elements) |
 | `savefig("file.pdf")` | PDF output |
-| `show()` | Interactive window display |
+| `show()` | Interactive window with backend auto-detection (Tk/inline/agg) |
 | `PdfPages` | Multi-page PDF export |
 
+### Backends & Interactive
+| Feature | Description |
+|---|---|
+| Backend auto-detection | Automatically selects inline (Jupyter), Tk, or Agg backend |
+| Tk backend | Interactive window with `PhotoImage` rendering (640x480) |
+| Navigation toolbar | Home, Back, Forward, Pan, Zoom, Save + status bar (7 widgets) |
+| Event system | `mpl_connect` / `mpl_disconnect` with `CallbackRegistry` |
+| Mouse events | `MouseEvent` with button, x/y data, key modifiers |
+| Key events | `KeyEvent` for keyboard interaction |
+| Draw/Resize/Close events | `DrawEvent`, `ResizeEvent`, `CloseEvent` |
+| Jupyter rich display | `_repr_png_()`, `_repr_svg_()`, `_repr_html_()` on Figure |
+| `render_to_svg_string()` | SVG output as string (PyO3) for Jupyter inline |
+| `render_to_rgba_buffer()` | Raw RGBA buffer (PyO3) for interactive backends |
+
 ### Animation
 | Feature | Description |
 |---|---|
@@ -245,7 +259,7 @@ All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
 - **Dates:** `date2num()`, `num2date()`, date formatters and locators
 - **Categorical axes:** string-based x values automatically converted
 
-### Compatibility Modules (21 modules)
+### Compatibility Modules (25 modules)
 | Module | Status |
 |---|---|
 | `rustplotlib.pyplot` | Full implementation (50+ functions) |
@@ -258,7 +272,9 @@ All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
 | `rustplotlib.colors` | LinearSegmentedColormap, Normalize, LogNorm, BoundaryNorm |
 | `rustplotlib.dates` | Date conversion, DateFormatter, DateLocator, Auto/Day/Month/Year/Hour/MinuteLocator |
 | `rustplotlib.gridspec` | GridSpec, SubplotSpec |
-| `rustplotlib.backends` | Backend system, PdfPages |
+| `rustplotlib.backends` | Backend system with auto-detection (inline/tk/agg), PdfPages |
+| `rustplotlib.backends.backend_base` | FigureCanvasBase, FigureManagerBase, NavigationToolbar2 |
+| `rustplotlib.backends.backend_tk` | Tk interactive window with toolbar and events |
 | `rustplotlib.mpl_toolkits.mplot3d` | Axes3D for 3D plotting |
 | `rustplotlib.cm` | Colormap access by name |
 | `rustplotlib.collections` | LineCollection, PathCollection, PatchCollection |
@@ -267,7 +283,10 @@ All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
 | `rustplotlib.transforms` | Bbox, Affine2D, BboxTransform |
 | `rustplotlib.patheffects` | Stroke, withStroke, SimplePatchShadow |
 | `rustplotlib.spines` | Spine |
-| `rustplotlib.figure` | Figure class reference |
+| `rustplotlib.axes` | Axes class reference |
+| `rustplotlib.figure` | Figure class with Jupyter rich display (`_repr_png_`, `_repr_svg_`, `_repr_html_`) |
+| `rustplotlib.events` | MouseEvent, KeyEvent, DrawEvent, ResizeEvent, CloseEvent |
+| `rustplotlib.callback_registry` | CallbackRegistry for mpl_connect/mpl_disconnect |
 | `rustplotlib.cycler` | cycler compatibility |
 
 ---
@@ -447,21 +466,24 @@ Contributions are welcome! This is an open-source project under the MIT license.
 
 **Project stats:**
 - **45+ Rust source files** — 23,000+ lines of native code
-- **21 Python modules** — 8,000+ lines of API
+- **25 Python modules** — 4,900+ lines of API
 - **47+ plot functions** (40 2D + 7 3D)
 - **70+ colormaps** (35 base + 35 reversed)
-- **267 tests** passing
+- **298 tests** passing
 - **22 formatters + locators** (functional)
+- **Tk interactive backend** with navigation toolbar and event system
+- **Jupyter rich display** (`_repr_png_`, `_repr_svg_`, `_repr_html_`)
+- **Event system** with `mpl_connect` / `mpl_disconnect`
 - **RGB/RGBA imshow**, bilinear interpolation, heatmap annotations
 - **Signal processing**: specgram, psd, acorr, xcorr, coherence
 - **Zero `unsafe` blocks**
 
 **Priority areas for contribution:**
-- Jupyter inline backend (rich display protocol)
-- Functional widgets (Slider, Button, CheckButtons with real rendering)
-- Interactive features (mouse events, zoom/pan, 3D rotation)
 - Qt/GTK backends
+- Functional widgets (Slider, Button, CheckButtons with real rendering)
+- 3D mouse rotation
 - Triangulation plots (tricontour, tripcolor)
+- LaTeX math rendering
 
 ---
 

{rustplotlib-4.0.1 → rustplotlib-5.0.0}/README.md

@@ -178,9 +178,23 @@ plt.show()
 | `savefig("file.png")` | Raster PNG (with dpi, transparent options) |
 | `savefig("file.svg")` | Native vector SVG (real `<line>`, `<text>`, `<rect>` elements) |
 | `savefig("file.pdf")` | PDF output |
-| `show()` | Interactive window display |
+| `show()` | Interactive window with backend auto-detection (Tk/inline/agg) |
 | `PdfPages` | Multi-page PDF export |
 
+### Backends & Interactive
+| Feature | Description |
+|---|---|
+| Backend auto-detection | Automatically selects inline (Jupyter), Tk, or Agg backend |
+| Tk backend | Interactive window with `PhotoImage` rendering (640x480) |
+| Navigation toolbar | Home, Back, Forward, Pan, Zoom, Save + status bar (7 widgets) |
+| Event system | `mpl_connect` / `mpl_disconnect` with `CallbackRegistry` |
+| Mouse events | `MouseEvent` with button, x/y data, key modifiers |
+| Key events | `KeyEvent` for keyboard interaction |
+| Draw/Resize/Close events | `DrawEvent`, `ResizeEvent`, `CloseEvent` |
+| Jupyter rich display | `_repr_png_()`, `_repr_svg_()`, `_repr_html_()` on Figure |
+| `render_to_svg_string()` | SVG output as string (PyO3) for Jupyter inline |
+| `render_to_rgba_buffer()` | Raw RGBA buffer (PyO3) for interactive backends |
+
 ### Animation
 | Feature | Description |
 |---|---|
@@ -225,7 +239,7 @@ All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
 - **Dates:** `date2num()`, `num2date()`, date formatters and locators
 - **Categorical axes:** string-based x values automatically converted
 
-### Compatibility Modules (21 modules)
+### Compatibility Modules (25 modules)
 | Module | Status |
 |---|---|
 | `rustplotlib.pyplot` | Full implementation (50+ functions) |
@@ -238,7 +252,9 @@ All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
 | `rustplotlib.colors` | LinearSegmentedColormap, Normalize, LogNorm, BoundaryNorm |
 | `rustplotlib.dates` | Date conversion, DateFormatter, DateLocator, Auto/Day/Month/Year/Hour/MinuteLocator |
 | `rustplotlib.gridspec` | GridSpec, SubplotSpec |
-| `rustplotlib.backends` | Backend system, PdfPages |
+| `rustplotlib.backends` | Backend system with auto-detection (inline/tk/agg), PdfPages |
+| `rustplotlib.backends.backend_base` | FigureCanvasBase, FigureManagerBase, NavigationToolbar2 |
+| `rustplotlib.backends.backend_tk` | Tk interactive window with toolbar and events |
 | `rustplotlib.mpl_toolkits.mplot3d` | Axes3D for 3D plotting |
 | `rustplotlib.cm` | Colormap access by name |
 | `rustplotlib.collections` | LineCollection, PathCollection, PatchCollection |
@@ -247,7 +263,10 @@ All also available as `viridis_r`, `plasma_r`, `hot_r`, etc.
 | `rustplotlib.transforms` | Bbox, Affine2D, BboxTransform |
 | `rustplotlib.patheffects` | Stroke, withStroke, SimplePatchShadow |
 | `rustplotlib.spines` | Spine |
-| `rustplotlib.figure` | Figure class reference |
+| `rustplotlib.axes` | Axes class reference |
+| `rustplotlib.figure` | Figure class with Jupyter rich display (`_repr_png_`, `_repr_svg_`, `_repr_html_`) |
+| `rustplotlib.events` | MouseEvent, KeyEvent, DrawEvent, ResizeEvent, CloseEvent |
+| `rustplotlib.callback_registry` | CallbackRegistry for mpl_connect/mpl_disconnect |
 | `rustplotlib.cycler` | cycler compatibility |
 
 ---
@@ -427,21 +446,24 @@ Contributions are welcome! This is an open-source project under the MIT license.
 
 **Project stats:**
 - **45+ Rust source files** — 23,000+ lines of native code
-- **21 Python modules** — 8,000+ lines of API
+- **25 Python modules** — 4,900+ lines of API
 - **47+ plot functions** (40 2D + 7 3D)
 - **70+ colormaps** (35 base + 35 reversed)
-- **267 tests** passing
+- **298 tests** passing
 - **22 formatters + locators** (functional)
+- **Tk interactive backend** with navigation toolbar and event system
+- **Jupyter rich display** (`_repr_png_`, `_repr_svg_`, `_repr_html_`)
+- **Event system** with `mpl_connect` / `mpl_disconnect`
 - **RGB/RGBA imshow**, bilinear interpolation, heatmap annotations
 - **Signal processing**: specgram, psd, acorr, xcorr, coherence
 - **Zero `unsafe` blocks**
 
 **Priority areas for contribution:**
-- Jupyter inline backend (rich display protocol)
-- Functional widgets (Slider, Button, CheckButtons with real rendering)
-- Interactive features (mouse events, zoom/pan, 3D rotation)
 - Qt/GTK backends
+- Functional widgets (Slider, Button, CheckButtons with real rendering)
+- 3D mouse rotation
 - Triangulation plots (tricontour, tripcolor)
+- LaTeX math rendering
 
 ---
 

{rustplotlib-4.0.1 → rustplotlib-5.0.0}/ROADMAP.md

@@ -54,7 +54,40 @@ Goal: Full matplotlib reimplementation in Rust.
 
 ---
 
-## PLANNED — v5.0.0
+## DONE — v5.0.0 (Phase 1 + Phase 2)
+
+### Backend System
+- [x] `backend_base.py` — `FigureCanvasBase`, `FigureManagerBase`, `NavigationToolbar2`
+- [x] `backends/__init__.py` — auto-detection (inline/tk/agg), registry, `show_figure()`
+- [x] `switch_backend()` / `set_backend()` functional
+
+### Tk Interactive Backend
+- [x] `backend_tk.py` — `FigureCanvasTk`, `FigureManagerTk`, `NavigationToolbarTk`
+- [x] Tkinter window with PhotoImage rendering
+- [x] Mouse events (click, release, motion, scroll)
+- [x] Keyboard events
+- [x] Navigation toolbar (Home, Back, Fwd, Pan, Zoom, Save)
+- [x] Coordinate display on mouse motion
+- [x] `show()` and `FigureProxy.show()` delegate to backend system
+
+### Jupyter Rich Display
+- [x] `render_to_svg_string()` exposed via PyO3
+- [x] `render_to_rgba_buffer()` exposed via PyO3
+- [x] `_repr_png_`, `_repr_svg_`, `_repr_html_` on FigureProxy
+- [x] `backend_inline.py` rewritten with SVG support and configurable `figure_format`
+
+### Event System
+- [x] Event classes: `Event`, `LocationEvent`, `MouseEvent`, `KeyEvent`, `PickEvent`, `DrawEvent`, `ResizeEvent`, `CloseEvent`
+- [x] `CallbackRegistry` with `connect(signal, func)`, `disconnect(cid)`, `process(signal, *args)`
+- [x] `CanvasProxy.mpl_connect()` / `mpl_disconnect()` functional
+- [x] `events` and `callback_registry` modules registered in package
+
+### Compatibility Modules (25 total)
+- [x] Added: events, callback_registry (+ backends expanded with backend_base, backend_tk, backend_inline)
+
+---
+
+## PLANNED — v5.1.0
 
 ### Remaining Plot Types
 - [ ] `tricontour()` / `tricontourf()` — contour on triangulation (currently stubs)
@@ -71,11 +104,9 @@ Goal: Full matplotlib reimplementation in Rust.
 ### Image Improvements
 - [ ] Bicubic, Lanczos, Spline interpolation
 
-### Functional Backends
+### Additional 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)
 
@@ -89,9 +120,7 @@ Goal: Full matplotlib reimplementation in Rust.
 - [ ] `Cursor` with crosshair rendering
 
 ### Interactive Features
-- [ ] Mouse events (click, motion, scroll, pick)
-- [ ] Keyboard events
-- [ ] Zoom/pan navigation toolbar
+- [ ] Pick events (artist hit testing)
 - [ ] 3D mouse rotation
 - [ ] Blitting for fast animation updates
 - [ ] Interactive data cursors
@@ -165,7 +194,7 @@ Goal: Full matplotlib reimplementation in Rust.
 Pick any unchecked item, open an issue to discuss, submit a PR with tests.
 
 **Highest impact areas:**
-1. Jupyter backend (v5.0.0) — huge for data scientists
-2. Interactive features (v5.0.0) — needed for exploratory analysis
+1. Qt/GTK backends (v5.1.0) — needed for desktop applications
+2. Functional widgets (v5.1.0) — Slider, Button, CheckButtons with real rendering
 3. LaTeX rendering (v6.0.0) — needed for scientific papers
-4. Triangulation plots (v5.0.0) — tricontour, tripcolor
+4. Triangulation plots (v5.1.0) — tricontour, tripcolor

{rustplotlib-4.0.1 → rustplotlib-5.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "rustplotlib"
-version = "4.0.1"
+version = "5.0.0"
 description = "Matplotlib drop-in replacement powered by Rust"
 requires-python = ">=3.9"
 dependencies = ["numpy"]

{rustplotlib-4.0.1 → rustplotlib-5.0.0}/python/rustplotlib/__init__.py

@@ -20,15 +20,17 @@ from rustplotlib import transforms
 from rustplotlib import lines
 from rustplotlib import text
 from rustplotlib import spines
+from rustplotlib import events
+from rustplotlib import callback_registry
 
 __all__ = ["pyplot", "style", "animation", "widgets", "dates", "backends",
            "font_manager", "ticker", "patches", "colors", "gridspec", "cycler",
            "axes", "figure", "collections", "cm", "patheffects", "transforms",
-           "lines", "text", "spines",
+           "lines", "text", "spines", "events", "callback_registry",
            "__version__", "use"]
 
 
 def use(backend):
     """Set the rendering backend (compatibility stub)."""
-    from rustplotlib import backends as _backends
-    _backends._current_backend = backend.lower()
+    from rustplotlib.backends import set_backend
+    set_backend(backend)

rustplotlib-5.0.0/python/rustplotlib/backends/__init__.py

@@ -0,0 +1,72 @@
+"""Backend system for rustplotlib.
+
+Manages backend selection and auto-detection:
+- 'inline' — Jupyter/IPython (auto-detected)
+- 'tk' — Tkinter interactive window (default for scripts)
+- 'agg' — Non-interactive, save-only (fallback)
+"""
+
+_current_backend = None  # None = auto-detect
+
+_BACKEND_REGISTRY = {
+    'agg': 'rustplotlib.backends.backend_base',
+    'inline': 'rustplotlib.backends.backend_inline',
+    'tk': 'rustplotlib.backends.backend_tk',
+}
+
+from rustplotlib.backends.backend_pdf import PdfPages
+
+
+def _auto_detect():
+    """Auto-detect the best backend for the current environment."""
+    try:
+        get_ipython()  # noqa: F821
+        return 'inline'
+    except NameError:
+        pass
+    return 'agg'  # Default to non-interactive
+
+
+def get_backend():
+    """Get the current backend name."""
+    global _current_backend
+    if _current_backend is None:
+        _current_backend = _auto_detect()
+    return _current_backend
+
+
+def set_backend(name):
+    """Set the backend by name."""
+    global _current_backend
+    name = name.lower()
+    if name == 'tkagg':
+        name = 'tk'
+    _current_backend = name
+
+
+def list_backends():
+    """Return list of registered backend names."""
+    return list(_BACKEND_REGISTRY.keys())
+
+
+def show_figure(figure_proxy):
+    """Show a figure using the current backend.
+
+    Parameters
+    ----------
+    figure_proxy : FigureProxy
+        The figure to show.
+    """
+    backend = get_backend()
+
+    if backend == 'inline':
+        from rustplotlib.backends.backend_inline import display_figure
+        display_figure(figure_proxy._fig)
+    elif backend == 'tk':
+        from rustplotlib.backends.backend_tk import FigureCanvasTk, FigureManagerTk
+        canvas = FigureCanvasTk(figure_proxy)
+        manager = FigureManagerTk(canvas, 1)
+        manager.show()
+    else:
+        # agg — non-interactive, use system viewer via Rust
+        figure_proxy._fig.show()

rustplotlib-5.0.0/python/rustplotlib/backends/backend_base.py

@@ -0,0 +1,164 @@
+"""Base classes for rustplotlib backends.
+
+Defines the interface that all backends must implement.
+Compatible with matplotlib's backend_bases module.
+"""
+
+from rustplotlib.callback_registry import CallbackRegistry
+
+
+class FigureCanvasBase:
+    """Base class for figure canvases. All backends implement this.
+
+    The canvas is responsible for:
+    - Rendering the figure (draw/draw_idle)
+    - Event handling (mpl_connect/mpl_disconnect)
+    - Size queries (get_width_height)
+    """
+
+    def __init__(self, figure):
+        self.figure = figure
+        self.callbacks = CallbackRegistry()
+        self._is_idle_drawing = False
+
+    def draw(self):
+        """Render the figure. Subclasses must implement."""
+        pass
+
+    def draw_idle(self):
+        """Request a draw at the next idle time."""
+        if not self._is_idle_drawing:
+            self._is_idle_drawing = True
+            self.draw()
+            self._is_idle_drawing = False
+
+    def mpl_connect(self, event_name, callback):
+        """Connect a callback to an event. Returns connection id."""
+        return self.callbacks.connect(event_name, callback)
+
+    def mpl_disconnect(self, cid):
+        """Disconnect a callback by connection id."""
+        self.callbacks.disconnect(cid)
+
+    def get_width_height(self):
+        """Return canvas width and height in pixels."""
+        fig = self.figure
+        if hasattr(fig, '_fig'):
+            # FigureProxy wrapping RustFigure
+            rust_fig = fig._fig
+            # RustFigure stores width/height directly
+            return (640, 480)  # default, overridden by subclasses with actual render info
+        return (640, 480)
+
+    def flush_events(self):
+        """Process pending GUI events."""
+        pass
+
+    def start_event_loop(self, timeout=0):
+        """Start a blocking event loop."""
+        pass
+
+    def stop_event_loop(self):
+        """Stop the current event loop."""
+        pass
+
+
+class FigureManagerBase:
+    """Base class for figure window managers.
+
+    The manager is responsible for:
+    - Creating and managing the GUI window
+    - Embedding the canvas in the window
+    - Window operations (show, destroy, resize, title)
+    """
+
+    def __init__(self, canvas, num):
+        self.canvas = canvas
+        self.num = num
+        self._window_title = f"Figure {num}"
+
+    def show(self):
+        """Show the figure window."""
+        pass
+
+    def destroy(self):
+        """Destroy the figure window."""
+        pass
+
+    def set_window_title(self, title):
+        """Set the window title."""
+        self._window_title = title
+
+    def resize(self, w, h):
+        """Resize the window."""
+        pass
+
+
+class NavigationToolbar2:
+    """Base class for navigation toolbars (zoom, pan, home, save).
+
+    Manages a stack of view limits for back/forward navigation.
+    """
+
+    def __init__(self, canvas):
+        self.canvas = canvas
+        self._nav_stack = []
+        self._current_idx = -1
+        self._active_mode = None  # None, 'zoom', 'pan'
+
+    def home(self):
+        """Reset to the original view."""
+        if self._nav_stack:
+            self._current_idx = 0
+            self._apply_view(self._nav_stack[0])
+
+    def back(self):
+        """Go to previous view in the stack."""
+        if self._current_idx > 0:
+            self._current_idx -= 1
+            self._apply_view(self._nav_stack[self._current_idx])
+
+    def forward(self):
+        """Go to next view in the stack."""
+        if self._current_idx < len(self._nav_stack) - 1:
+            self._current_idx += 1
+            self._apply_view(self._nav_stack[self._current_idx])
+
+    def push_current(self):
+        """Save current view limits to the stack."""
+        fig = self.canvas.figure
+        if hasattr(fig, '_axes') and fig._axes:
+            axes_list = fig._axes if isinstance(fig._axes, list) else [fig._axes]
+            views = []
+            for ax in axes_list:
+                xlim = ax.get_xlim() if hasattr(ax, 'get_xlim') else None
+                ylim = ax.get_ylim() if hasattr(ax, 'get_ylim') else None
+                views.append((xlim, ylim))
+            self._nav_stack = self._nav_stack[:self._current_idx + 1]
+            self._nav_stack.append(views)
+            self._current_idx = len(self._nav_stack) - 1
+
+    def _apply_view(self, views):
+        """Apply saved view limits."""
+        fig = self.canvas.figure
+        if hasattr(fig, '_axes') and fig._axes:
+            axes_list = fig._axes if isinstance(fig._axes, list) else [fig._axes]
+            for ax, (xlim, ylim) in zip(axes_list, views):
+                if xlim is not None and hasattr(ax, 'set_xlim'):
+                    ax.set_xlim(*xlim)
+                if ylim is not None and hasattr(ax, 'set_ylim'):
+                    ax.set_ylim(*ylim)
+            self.canvas.draw_idle()
+
+    def zoom(self):
+        """Toggle zoom mode."""
+        self._active_mode = None if self._active_mode == 'zoom' else 'zoom'
+
+    def pan(self):
+        """Toggle pan mode."""
+        self._active_mode = None if self._active_mode == 'pan' else 'pan'
+
+    def save_figure(self, filename=None):
+        """Save the figure to a file."""
+        if filename:
+            self.canvas.figure.savefig(filename)

rustplotlib-5.0.0/python/rustplotlib/backends/backend_inline.py

@@ -0,0 +1,70 @@
+"""Jupyter inline display backend for rustplotlib."""
+
+import base64
+
+_figure_format = 'png'
+
+
+def get_figure_format():
+    """Get the current inline figure format ('png' or 'svg')."""
+    return _figure_format
+
+
+def set_figure_format(fmt):
+    """Set the inline figure format ('png', 'svg', or 'retina')."""
+    if fmt not in ('png', 'svg', 'retina'):
+        raise ValueError(f"Unsupported figure format: {fmt!r}. Use 'png', 'svg', or 'retina'.")
+    global _figure_format
+    _figure_format = fmt
+
+
+class SVGWrapper:
+    """Wrapper for SVG string display in Jupyter."""
+
+    def __init__(self, data):
+        self.data = data
+
+    def _repr_svg_(self):
+        return self.data
+
+
+class PNGWrapper:
+    """Wrapper for PNG bytes display in Jupyter."""
+
+    def __init__(self, data):
+        self.data = data
+
+    def _repr_png_(self):
+        return self.data
+
+
+def display_figure(fig, display_func=None):
+    """Display a figure inline in Jupyter.
+
+    Parameters
+    ----------
+    fig : RustFigure
+        The Rust figure object (not the FigureProxy).
+    display_func : callable, optional
+        Custom display function (for testing). Defaults to IPython.display.display.
+    """
+    if display_func is None:
+        try:
+            from IPython.display import display as display_func
+        except ImportError:
+            return
+
+    fmt = get_figure_format()
+
+    if fmt == 'svg':
+        svg_str = fig.render_to_svg_string()
+        display_func(SVGWrapper(svg_str))
+    else:
+        # 'png' or 'retina'
+        png_bytes = fig.render_to_png_bytes()
+        display_func(PNGWrapper(bytes(png_bytes)))
+
+
+def configure_inline_support(shell=None, backend=None):
+    """Configure Jupyter to display rustplotlib figures inline."""
+    pass