Extend matplotlib parsing

Author: max-models

.github/workflows/matplotlib-import.yml

@@ -0,0 +1,23 @@
+name: Matplotlib import compatibility
+
+on:
+  push:
+    branches: [main, devel]
+  pull_request:
+
+jobs:
+  import-fixtures:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        matplotlib: ['3.8.*', '3.9.*', '3.10.*', '3.11.*']
+    env:
+      MPLBACKEND: Agg
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - run: python -m pip install '.[test]' 'numpy<2' 'matplotlib==${{ matrix.matplotlib }}'
+      - run: python -m pytest src/maxplotlib/tests/test_matplotlib_import.py src/maxplotlib/tests/test_matplotlib_import_extended.py

docs/matplotlib-import-support.md

@@ -48,9 +48,12 @@ conversion is not possible.
   (subfigure rectangles/decorations are flattened into the destination figure).
 - [x] Grid width/height ratios, margins, spacing, constrained/tight layout
   for ordinary/nested GridSpec; subfigures retain their snapshot rectangles.
-- [ ] Arbitrary axes rectangles, overlapping axes, inset axes, inset connectors.
-  Rectangles, overlaps and child insets are implemented; connectors referring to
-  other axes still need live-reference rebinding.
+- [x] Arbitrary axes rectangles, overlapping axes, inset axes, inset-zoom
+  connectors (`indicate_inset_zoom`/`indicate_inset`, Matplotlib 3.10+). The
+  connector spans two Axes and recomputes its geometry from live limits on
+  every draw, so it is rebuilt against the reconstructed parent/inset pair
+  rather than snapshotted. Matplotlib < 3.10's tuple-returning API still falls
+  back to native geometry.
 - [x] Secondary axes with forward/inverse coordinate functions.
 - [x] Figure backgrounds, frame styling, and figure-level text/patches/images.
 - [x] Figure title/shared-label typography and placement.

scripts/benchmark_matplotlib_import.py

@@ -0,0 +1,58 @@
+"""Measure import time and peak Python allocation for reproducible fixtures.
+
+Run from an installed checkout: python scripts/benchmark_matplotlib_import.py
+Timings are observations, not brittle pass/fail thresholds. Native renderer
+allocations outside Python are not included in tracemalloc's peak measurement.
+"""
+
+import argparse
+import json
+import time
+import tracemalloc
+
+import matplotlib
+
+matplotlib.use("Agg")
+import matplotlib.pyplot as plt
+import numpy as np
+
+from maxplotlib import Canvas
+
+
+def benchmark(points, panels):
+    fig, axes = plt.subplots(panels, 1, figsize=(8, max(3, panels * 2)))
+    x = np.linspace(0, 10, points)
+    for index, ax in enumerate(np.atleast_1d(axes)):
+        ax.plot(x, np.sin(x + index))
+        ax.scatter([], [])
+    tracemalloc.start()
+    started = time.perf_counter()
+    canvas = Canvas.from_matplotlib(fig, strict=True)
+    imported = time.perf_counter()
+    _, peak = tracemalloc.get_traced_memory()
+    tracemalloc.stop()
+    result, _ = canvas.render()
+    result.canvas.draw()
+    finished = time.perf_counter()
+    stats = dict(
+        matplotlib=matplotlib.__version__,
+        points_per_panel=points,
+        panels=panels,
+        import_seconds=imported - started,
+        render_seconds=finished - imported,
+        import_peak_python_mib=peak / 1024**2,
+        entries=sum(len(plot.line_data) for _, _, plot in canvas.iter_subplots()),
+    )
+    plt.close(fig)
+    plt.close(result)
+    return stats
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--points", type=int, default=100_000)
+    parser.add_argument("--panels", type=int, default=4)
+    arguments = parser.parse_args()
+    if arguments.points < 1 or arguments.panels < 1:
+        parser.error("points and panels must be positive")
+    print(json.dumps(benchmark(arguments.points, arguments.panels), indent=2))