inklet 4.0.0.dev1__tar.gz → 4.0.0.dev3__tar.gz

{inklet-4.0.0.dev1 → inklet-4.0.0.dev3}/.github/workflows/checks.yml

@@ -70,6 +70,7 @@ jobs:
           .venv/bin/python examples/v4/time_series.py --output out/v4-time
           .venv/bin/python examples/v4/statistical_views.py --output out/v4-statistics
           .venv/bin/python examples/v4/regional_report.py --render --output out/v4-regional-report
+          .venv/bin/python examples/v4/regional_report.py --renderer compiled --editor --render --output out/v4-compiled-regional
           .venv/bin/python examples/v4/engineering_report.py --render --output out/v4-engineering
           .venv/bin/python examples/v4/scientific_report.py --render --output out/v4-scientific
           .venv/bin/python examples/v4/mesh_fields.py --render --output out/v4-mesh-fields
@@ -92,6 +93,13 @@ jobs:
         run: |
           .venv/bin/python tools/benchmark_engine.py --repeat 1 --output out/engine-benchmark.json
           .venv/bin/python examples/engine_review.py --output out/engine-review
+          .venv/bin/python examples/compositing_review.py --output out/compositing-review
+          .venv/bin/python examples/hatch_review.py --output out/hatch-review
+          .venv/bin/python examples/clipping_review.py --output out/clipping-review
+          .venv/bin/python examples/render_scene_review.py --output out/render-scene-review
+          .venv/bin/python examples/dense_scatter_review.py --output out/dense-scatter-review
+          .venv/bin/python examples/compiled_marker_shapes.py --output out/compiled-marker-shapes
+          .venv/bin/python examples/compiled_scene_viewer.py --output out/compiled-scene-viewer
       - name: Diagram routing and label review
         run: |
           .venv/bin/python tools/benchmark_diagrams.py --repeat 1 --output out/diagram-benchmark.json

{inklet-4.0.0.dev1 → inklet-4.0.0.dev3}/.github/workflows/publish.yml

@@ -6,7 +6,7 @@ on:
       tag:
         description: Published GitHub release tag
         required: true
-        default: v4.0.0.dev1
+        default: v4.0.0.dev3
         type: string
       dry_run:
         description: Validate release files without uploading to PyPI
@@ -43,7 +43,7 @@ jobs:
           RELEASE_TAG: ${{ inputs.tag }}
         run: |
           [[ "$RELEASE_TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(\.dev[0-9]+)?$ ]] || {
-            echo 'Expected a stable or development tag such as v3.1.0 or v4.0.0.dev1' >&2
+            echo 'Expected a stable or development tag such as v3.1.0 or v4.0.0.dev3' >&2
             exit 1
           }
           gh release view "$RELEASE_TAG" --json isDraft,isPrerelease > "$RUNNER_TEMP/release.json"

{inklet-4.0.0.dev1 → inklet-4.0.0.dev3}/CHANGELOG.md

@@ -1,5 +1,146 @@
 # Changelog
 
+## Unreleased
+
+## 4.0.0.dev3 — 2026-09-12
+
+Third development preview: shared scene execution, dense marker rendering,
+linked compiled reports and the first reproducible plot-style editor. Install
+explicitly with `python -m pip install "inklet==4.0.0.dev3"`; 3.1.0 remains stable.
+
+- Add an offline inspector for named plot colours, marker radii and line widths,
+  with bounded undo/redo and separate versioned overrides. Preserve compatible
+  choices across source revisions and page widths; reject or explicitly report
+  orphaned targets. Reproduce edited views through Python SVG/PDF/PNG exports.
+- Prepare style commands atomically, preserve selection and view state, and
+  prevent file/command/revision races. Add edited full-report visual comparisons,
+  failure cases, browser/Python agreement and installed-wheel checks.
+
+- Add opt-in compiled execution to linked browser figures, preserving keyed
+  selection, filtering, saved states, revision policies and vector exports.
+  Pack contiguous circle runs without reordering paint, retain native SVG for
+  other marks, and intersect visibility masks with spatial candidates.
+- Share the compiled viewer runtime with the linked report instead of duplicating
+  GPU execution. Retain immutable records during filtering and release surfaces
+  on revision replacement. Add a runnable regional report mode, complete-figure
+  display comparisons and state/revision/export regressions across backends.
+
+- Build ordered marker candidates with a reusable bitmap instead of temporary
+  JavaScript result arrays and comparison sorting. Accept fully contained grid
+  cells without rechecking each footprint, preserving source paint order and
+  independently owned result arrays.
+- Measure 250,000- and million-point index queries and browser submission.
+  The million-point zoom query falls from 5.253 to 0.629 ms in the standalone
+  study; tiny queries are slightly slower. Retained bitmap storage adds one bit
+  per row. Add word-boundary and query-result ownership regressions.
+
+- Cull individual packed markers with a shared spatial index of full marker
+  footprints. Preserve source order, antialiasing margins and vector exports.
+  Canvas paints candidates; WebGL2 fetches immutable records using compact
+  row-index uploads. Report candidate counts, uploads and index storage.
+- Add a 250,000-point stress recipe, brute-force and visual fidelity checks,
+  and separate submission/GPU timer studies. Canvas window submission improves
+  from 88.5 to 10.8 ms in the recorded workload; GPU draw time falls from 0.325
+  to 0.042 ms while CPU submission rises from 0.9 to 2.2 ms. Document memory costs.
+
+- Size compiled-viewer surfaces around the visible region with a retained pan
+  margin; skip painting offscreen layers and reuse their immutable buffers on
+  return. Preserve native clipping, marker order and complete vector export.
+- Keep deep-zoom resolution within the existing per-surface pixel limits. In
+  the five-panel RTX 5090 study, 8× zoom uses about 3.05 million backing pixels
+  instead of 20 million, and median WebGL submission falls from 49.0 to 13.8 ms.
+  Add normal/deep-zoom fidelity, visibility and re-entry checks with raw studies.
+
+- Retain compiled-viewer backing surfaces across pans and small zoom changes,
+  repaint only when resolution changes, and shrink after large zoom-outs.
+  Read all SVG transforms before changing canvas dimensions. Preserve the
+  existing pixel budgets, native compositing, vector export and error fallback.
+- Report surface paints, resizes, reuse and allocated pixel counts. Add hardware
+  before/after profiles and regressions for reuse, resolution growth, shrinking
+  and context loss. Warm small-zoom submission falls from 47.8 ms to 0.5 ms in
+  the measured five-panel RTX 5090 workload; startup and growth are excluded.
+
+- Accelerate filled square, triangle, diamond and star marker batches in the
+  compiled-scene viewer. Preserve exact polygon geometry, per-point sizes and
+  colours, winding rules, paint order, clipping and vector SVG download.
+- Add a five-panel interactive marker comparison and test complete composited
+  screenshots against SVG at two display resolutions, including concave
+  polygons. Self-intersections, open, outlined and curved markers stay native.
+- Validate the five-panel viewer on an RTX 5090 Laptop GPU through WSL/D3D12.
+  Publish timings and display comparisons; Canvas remains faster for this
+  measured workload, so hardware availability is not presented as a speedup.
+
+- Add `RenderScene.to_html()` for offline native-scene viewing, with instanced
+  WebGL2 circle layers, Canvas fallback and native SVG artwork in paint order.
+  Automatic selection avoids recognized software WebGL renderers. Report
+  backend decisions, context loss, display limits and buffer uploads.
+- Keep packed source buffers shared and immutable across browser view changes;
+  reconstruct vector SVG from 64-bit records, including exact source indices.
+- Add a complete interactive figure, shader/fallback/resource tests and native
+  export comparisons. Keyed-row interaction migration and broader GPU geometry
+  remain open; hardware performance is not inferred from software WebGL tests.
+
+- Store dense vector scatter in immutable 36-byte marker records, preserving
+  source order, per-point size/colour, physical strokes and native vector output.
+  Series with at least 256 points use batches unless placement anchors or
+  broken axes require individual nodes. Dense point handles become batch
+  handles; source indices remain inspectable in buffers and SVG elements.
+- Stream batches through SVG/PDF with bounded prototype caches, preserve
+  geometric clipping and painted windows, and retain batch geometry on revisions.
+- Check packed palettes against colour keys and inspect individual marker
+  footprints for text overlaps, avoiding false collisions over empty cloud space.
+- Add a 38,300-marker four-panel review, native-backend fidelity tests and
+  reproducible construction/export/memory measurements, including a separate
+  million-point construction test.
+
+- Compile a shared native render scene for SVG, PDF and PNG, resolving styles,
+  transforms, clipping and compositing once. Retain it across document exports.
+- Reuse unchanged scene nodes and geometry across revisions; share small shapes
+  and shaped labels by value, expose invalidation reasons and conservative
+  redraw coverage, and report render-compilation work separately from layout.
+- Reject missing image and font resources before native export; SVG no longer
+  silently emits broken image links or substitutes an unavailable font file.
+- Snapshot file-backed image bytes so completed figures survive source changes;
+  detect updated image inputs on subsequent document compilation and reject
+  exports using changed or missing font files.
+- Add a complete six-panel scene/revision review and repeated-export benchmarks.
+  Browser/GPU execution and finer layout invalidation remain open.
+
+## 4.0.0.dev2 — 2026-09-08
+
+Second development preview. Install explicitly with
+`python -m pip install "inklet==4.0.0.dev2"`; 3.1.0 remains stable.
+
+- Preserve open cubic segments through geometric clipping, using parameter
+  subdivision and bounded adaptive measurement sampling in the clip frame.
+- Add `window()` for nested, transformed visual clipping of all SVG/PDF/PNG
+  paint, including glyphs, images, markers, filled curves and rounded corners.
+  Keep window layout, painted bounds and authored child geometry distinct;
+  expose inherited clip regions and visibility filtering through resolution.
+- Preserve windows through document compilation/copying and account for hidden
+  content in page-bound and path-crossing diagnostics.
+- Reduce allocation in dense-line clipping; add an eight-panel rendering
+  review, independent backend checks and reproducible clipping/line benchmarks.
+
+
+- Share exact hatch-line geometry between SVG and PDF, with reusable local
+  coverage resources and independent shape clips. Preserve holes, transforms,
+  border styles and fill opacity without periodic tile seams or inherited
+  border settings affecting the fill.
+- Reuse hatch coverage across nearby shape sizes, retain explicit work limits,
+  and add an illustrated review plus repeated/distinct-size export benchmarks.
+
+- Correct PDF compositing for individual filled-and-stroked shapes, text halos
+  and vector brushes: group opacity fades their combined paint once.
+- Preserve palette and color-key PNG transparency in PDF, including partial
+  palette alpha and file-backed images.
+- Reuse subtree painted bounds and paint-count analysis within each PDF page
+  export; nested transparency groups no longer remeasure the same glyphs for
+  every ancestor. Keep inherited style/transform contexts separate and discard
+  the caches after export.
+- Add an illustrated compositing review, independent SVG/Poppler comparisons
+  and a nested-group workload to the rendering benchmark and CI checks.
+
 ## 4.0.0.dev1 — 2026-09-08
 
 First installable 4.0 development preview. This collects the linked-document,

{inklet-4.0.0.dev1 → inklet-4.0.0.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: inklet
-Version: 4.0.0.dev1
+Version: 4.0.0.dev3
 Summary: Scientific figures with live data, measured layout, and consistent vector exports.
 Project-URL: Repository, https://github.com/Mapika/inklet
 Project-URL: Documentation, https://inklet.readthedocs.io/en/latest/
@@ -81,18 +81,17 @@ their signatures and report schemas may change.
 
 ## 4.0 development preview
 
-**4.0.0.dev1** adds offline linked charts, maps, calibrated images, mesh fields,
-contours and streamlines, with saved selections and reproducible exports.
-It also includes date/UTC axes, facets, pandas/Polars adapters and shared
-plotting-quality improvements.
-
+**4.0.0.dev3** adds shared compiled rendering, packed dense markers, offline
+WebGL2/Canvas viewing, and a plot-style inspector with undo/redo and saved
+visual overrides. Linked charts, maps and scientific reports preserve selections,
+source revisions and reproducible vector exports.
 ```sh
-python -m pip install "inklet==4.0.0.dev1"
+python -m pip install "inklet==4.0.0.dev3"
 ```
 
 [Preview guide and examples](https://inklet.readthedocs.io/en/latest/development-preview/) ·
 [4.0 roadmap](https://inklet.readthedocs.io/en/latest/roadmap/) ·
-[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev1)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev3)
 
 This is an opt-in development release. Experimental APIs and saved-state schemas
 may change; 3.1.0 remains the stable release. General browser editing,

{inklet-4.0.0.dev1 → inklet-4.0.0.dev3}/README.md

@@ -31,18 +31,17 @@ their signatures and report schemas may change.
 
 ## 4.0 development preview
 
-**4.0.0.dev1** adds offline linked charts, maps, calibrated images, mesh fields,
-contours and streamlines, with saved selections and reproducible exports.
-It also includes date/UTC axes, facets, pandas/Polars adapters and shared
-plotting-quality improvements.
-
+**4.0.0.dev3** adds shared compiled rendering, packed dense markers, offline
+WebGL2/Canvas viewing, and a plot-style inspector with undo/redo and saved
+visual overrides. Linked charts, maps and scientific reports preserve selections,
+source revisions and reproducible vector exports.
 ```sh
-python -m pip install "inklet==4.0.0.dev1"
+python -m pip install "inklet==4.0.0.dev3"
 ```
 
 [Preview guide and examples](https://inklet.readthedocs.io/en/latest/development-preview/) ·
 [4.0 roadmap](https://inklet.readthedocs.io/en/latest/roadmap/) ·
-[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev1)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev3)
 
 This is an opt-in development release. Experimental APIs and saved-state schemas
 may change; 3.1.0 remains the stable release. General browser editing,

{inklet-4.0.0.dev1 → inklet-4.0.0.dev3}/docs/api.md

@@ -18,6 +18,23 @@ took before layout still resolves inside the finished figure.
 
 Declared format support; no renderer is selected implicitly.
 
+#### `class RenderScene(root: 'SceneNode', bbox: 'Rect', stats: 'Mapping', changes: 'tuple[SceneChange, ...]', _nodes: 'Mapping', _resources: 'Mapping', _images: 'Mapping', _fonts: 'Mapping') -> None`
+
+A compiled native scene shared by SVG, PDF and PNG exports.
+
+* `walk()`
+* `validate_fonts()`
+* `sources_current()` -- Check external inputs when a document considers reusing a snapshot.
+* `to_svg(**options)`
+* `to_pdf(**options)`
+* `to_png(**options)`
+* `to_html(*, title='Inklet figure', backend='auto', **options)` -- Offline experimental viewer; WebGL2 filled markers, Canvas fallback, SVG art.
+* `damage_bounds(previous: 'RenderScene')` -- Conservative old/new ink union for changed placements, in page mm.
+
+#### `compile_scene(root: 'Diagram | RenderScene', *, previous: 'RenderScene | None' = None) -> 'RenderScene'`
+
+Resolve a drawing for all native backends, reusing an optional revision.
+
 #### `blend(node, mode='multiply')`
 
 Blend an isolated group with the artwork behind it, natively in SVG/PDF.
@@ -457,6 +474,10 @@ One data glyph, centred on its own origin so `place()` lands it on the point it
 
 Put children at explicit coordinates, in millimetres.
 
+#### `window(items: 'Diagram | Iterable[Diagram]', region: 'Rect | Sequence[Point]', *, kind: 'str' = 'window', **style) -> 'Diagram'`
+
+Crop painted content to a fixed convex window, in local millimetres.
+
 #### `clip(items: 'Diagram | Iterable[Diagram]', region: 'Rect | Sequence[Point]', *, kind: 'str' = 'clip', strict: 'bool' = False, **style) -> 'Diagram'`
 
 Cut `items` down to `region`, in the coordinate frame you pass it in.
@@ -1019,19 +1040,19 @@ One actionable finding. `where` is figure-space, in millimetres.
 
 Compact report. Returns a single string with no trailing newline.
 
-#### `to_svg(root: 'Diagram', *, width: 'float | str | None' = None, height: 'float | str | None' = None, margin: 'float' = 0.0, background: 'str | None' = None, precision: 'int' = 3, title: 'str | None' = None, compact: 'bool | str' = 'auto', text: 'str' = 'names') -> 'str'`
+#### `to_svg(root: 'Diagram | RenderScene', *, width: 'float | str | None' = None, height: 'float | str | None' = None, margin: 'float' = 0.0, background: 'str | None' = None, precision: 'int' = 3, title: 'str | None' = None, compact: 'bool | str' = 'auto', text: 'str' = 'names') -> 'str'`
 
 Render a diagram tree to a self-contained SVG document.
 
-#### `save_svg(root: 'Diagram', path: 'str', *, width: 'float | str | None' = None, height: 'float | str | None' = None, margin: 'float' = 0.0, background: 'str | None' = None, precision: 'int' = 3, title: 'str | None' = None, compact: 'bool | str' = 'auto', text: 'str' = 'names') -> 'None'`
+#### `save_svg(root: 'Diagram | RenderScene', path: 'str', *, width: 'float | str | None' = None, height: 'float | str | None' = None, margin: 'float' = 0.0, background: 'str | None' = None, precision: 'int' = 3, title: 'str | None' = None, compact: 'bool | str' = 'auto', text: 'str' = 'names') -> 'None'`
 
 Write `root` to `path` as SVG. `to_svg` is the same thing as a string.
 
-#### `to_pdf(root: 'Diagram | Sequence[Diagram]', *, width: 'float | str | None' = None, height: 'float | str | None' = None, margin: 'float' = 0.0, background: 'str | None' = None, precision: 'int' = 3, title: 'str | None' = None, compress: 'bool' = True, text: 'str' = 'outline') -> 'bytes'`
+#### `to_pdf(root: 'Diagram | RenderScene | Sequence[Diagram | RenderScene]', *, width: 'float | str | None' = None, height: 'float | str | None' = None, margin: 'float' = 0.0, background: 'str | None' = None, precision: 'int' = 3, title: 'str | None' = None, compress: 'bool' = True, text: 'str' = 'outline') -> 'bytes'`
 
 Render one diagram tree, or a sequence of them, to a PDF document.
 
-#### `save_pdf(root: 'Diagram | Sequence[Diagram]', path: 'str | Path', **kwargs) -> 'None'`
+#### `save_pdf(root: 'Diagram | RenderScene | Sequence[Diagram | RenderScene]', path: 'str | Path', **kwargs) -> 'None'`
 
 Write `root` to `path` as PDF. `to_pdf` is the same thing as bytes.
 
@@ -1058,9 +1079,9 @@ Flatten the tree into world transforms, keyed by node id.
 
 ## Core types and units
 
-#### `class Diagram(prim: 'Prim | None' = None, children: "tuple['Diagram', ...]" = (), transform: 'Affine' = Affine(a=1.0, b=0.0, c=0.0, d=1.0, e=0.0, f=0.0), style: 'Style' = Style(fill=None, stroke=None, stroke_width=None, stroke_dash=None, stroke_linecap=None, stroke_linejoin=None, opacity=None, fill_opacity=None, stroke_opacity=None, corner_radius=None, font_family=None, font_size=None, font_weight=None, font_style=None, text_fill=None, line_height=None, halo=None, halo_color=None), kind: 'str' = 'g', name: 'str | None' = None, id: 'str' = '', envelope_override: 'Envelope | None' = None, attached_to: 'tuple[str, ...]' = (), anchors: 'dict[str, Vec2]' = <factory>, notes: 'dict[str, object]' = <factory>, _cache: 'dict' = <factory>) -> None`
+#### `class Diagram(prim: 'Prim | None' = None, children: "tuple['Diagram', ...]" = (), transform: 'Affine' = Affine(a=1.0, b=0.0, c=0.0, d=1.0, e=0.0, f=0.0), style: 'Style' = Style(fill=None, stroke=None, stroke_width=None, stroke_dash=None, stroke_linecap=None, stroke_linejoin=None, opacity=None, fill_opacity=None, stroke_opacity=None, corner_radius=None, font_family=None, font_size=None, font_weight=None, font_style=None, text_fill=None, line_height=None, halo=None, halo_color=None), kind: 'str' = 'g', name: 'str | None' = None, id: 'str' = '', envelope_override: 'Envelope | None' = None, attached_to: 'tuple[str, ...]' = (), anchors: 'dict[str, Vec2]' = <factory>, notes: 'dict[str, object]' = <factory>, clip_region: 'tuple[Vec2, ...]' = (), _cache: 'dict' = <factory>) -> None`
 
-Diagram(prim: 'Prim | None' = None, children: "tuple['Diagram', ...]" = (), transform: 'Affine' = Affine(a=1.0, b=0.0, c=0.0, d=1.0, e=0.0, f=0.0), style: 'Style' = Style(fill=None, stroke=None, stroke_width=None, stroke_dash=None, stroke_linecap=None, stroke_linejoin=None, opacity=None, fill_opacity=None, stroke_opacity=None, corner_radius=None, font_family=None, font_size=None, font_weight=None, font_style=None, text_fill=None, line_height=None, halo=None, halo_color=None), kind: 'str' = 'g', name: 'str | None' = None, id: 'str' = '', envelope_override: 'Envelope | None' = None, attached_to: 'tuple[str, ...]' = (), anchors: 'dict[str, Vec2]' = <factory>, notes: 'dict[str, object]' = <factory>, _cache: 'dict' = <factory>)
+Diagram(prim: 'Prim | None' = None, children: "tuple['Diagram', ...]" = (), transform: 'Affine' = Affine(a=1.0, b=0.0, c=0.0, d=1.0, e=0.0, f=0.0), style: 'Style' = Style(fill=None, stroke=None, stroke_width=None, stroke_dash=None, stroke_linecap=None, stroke_linejoin=None, opacity=None, fill_opacity=None, stroke_opacity=None, corner_radius=None, font_family=None, font_size=None, font_weight=None, font_style=None, text_fill=None, line_height=None, halo=None, halo_color=None), kind: 'str' = 'g', name: 'str | None' = None, id: 'str' = '', envelope_override: 'Envelope | None' = None, attached_to: 'tuple[str, ...]' = (), anchors: 'dict[str, Vec2]' = <factory>, notes: 'dict[str, object]' = <factory>, clip_region: 'tuple[Vec2, ...]' = (), _cache: 'dict' = <factory>)
 
 * `extent(direction: 'Vec2') -> 'float'` -- How far this reaches along a direction, in the parent's frame. This is what stacking asks, and why a rotated shape packs tighter than its bbox.
 * `anchor(name: 'str', at: 'tuple[float, float] | Vec2') -> "'Diagram'"` -- Register a named point. A tuple is read as fractions of the local bounding box, (0, 0) being its top-left corner -- the natural way to point at an ear in a photograph.

inklet-4.0.0.dev3/docs/assets/research-preview/clipping-after.json

@@ -0,0 +1,119 @@
+{
+  "schema": "inklet.clipping-benchmark/1",
+  "python": "3.12.3",
+  "platform": "Linux-6.6.87.2-microsoft-standard-WSL2-x86_64-with-glibc2.39",
+  "source_sha256": "b4ded74e40916e536713f7589469a20bb25677587c03e83942cf6aeb7ecf0bd5",
+  "cases": [
+    {
+      "case": "line",
+      "runs": [
+        {
+          "clip_seconds": 0.09736313400208019,
+          "svg_seconds": 0.010083654022309929,
+          "pdf_seconds": 0.01944988899049349,
+          "total_seconds": 0.1268966770148836,
+          "svg_bytes": 76870,
+          "pdf_bytes": 36176
+        },
+        {
+          "clip_seconds": 0.09901987100602128,
+          "svg_seconds": 0.010495024005649611,
+          "pdf_seconds": 0.0206202779954765,
+          "total_seconds": 0.1301351730071474,
+          "svg_bytes": 76870,
+          "pdf_bytes": 36176
+        },
+        {
+          "clip_seconds": 0.10801237399573438,
+          "svg_seconds": 0.01182610000250861,
+          "pdf_seconds": 0.022811452014138922,
+          "total_seconds": 0.1426499260123819,
+          "svg_bytes": 76870,
+          "pdf_bytes": 36176
+        }
+      ],
+      "median": {
+        "clip_seconds": 0.09901987100602128,
+        "svg_seconds": 0.010495024005649611,
+        "pdf_seconds": 0.0206202779954765,
+        "total_seconds": 0.1301351730071474,
+        "svg_bytes": 76870,
+        "pdf_bytes": 36176
+      }
+    },
+    {
+      "case": "band",
+      "runs": [
+        {
+          "clip_seconds": 0.6217630119936075,
+          "svg_seconds": 0.05115153800579719,
+          "pdf_seconds": 0.10317503899568692,
+          "total_seconds": 0.7760895889950916,
+          "svg_bytes": 316513,
+          "pdf_bytes": 145203
+        },
+        {
+          "clip_seconds": 0.626939455018146,
+          "svg_seconds": 0.06268787098815665,
+          "pdf_seconds": 0.09176701598335057,
+          "total_seconds": 0.7813943419896532,
+          "svg_bytes": 316513,
+          "pdf_bytes": 145203
+        },
+        {
+          "clip_seconds": 0.6646606319991406,
+          "svg_seconds": 0.05158257801667787,
+          "pdf_seconds": 0.09825415699742734,
+          "total_seconds": 0.8144973670132458,
+          "svg_bytes": 316513,
+          "pdf_bytes": 145203
+        }
+      ],
+      "median": {
+        "clip_seconds": 0.626939455018146,
+        "svg_seconds": 0.05158257801667787,
+        "pdf_seconds": 0.09825415699742734,
+        "total_seconds": 0.7813943419896532,
+        "svg_bytes": 316513,
+        "pdf_bytes": 145203
+      }
+    },
+    {
+      "case": "curves",
+      "runs": [
+        {
+          "clip_seconds": 0.02900044500711374,
+          "svg_seconds": 0.0009433439990971237,
+          "pdf_seconds": 0.0009197680046781898,
+          "total_seconds": 0.030863557010889053,
+          "svg_bytes": 5248,
+          "pdf_bytes": 3319
+        },
+        {
+          "clip_seconds": 0.030080602009547874,
+          "svg_seconds": 0.0012863579904660583,
+          "pdf_seconds": 0.0010805090132635087,
+          "total_seconds": 0.03244746901327744,
+          "svg_bytes": 5248,
+          "pdf_bytes": 3319
+        },
+        {
+          "clip_seconds": 0.029620053013786674,
+          "svg_seconds": 0.0009497819992247969,
+          "pdf_seconds": 0.0013156150234863162,
+          "total_seconds": 0.03188545003649779,
+          "svg_bytes": 5248,
+          "pdf_bytes": 3319
+        }
+      ],
+      "median": {
+        "clip_seconds": 0.029620053013786674,
+        "svg_seconds": 0.0009497819992247969,
+        "pdf_seconds": 0.0010805090132635087,
+        "total_seconds": 0.03188545003649779,
+        "svg_bytes": 5248,
+        "pdf_bytes": 3319
+      }
+    }
+  ]
+}

inklet-4.0.0.dev3/docs/assets/research-preview/clipping-before.json

@@ -0,0 +1,119 @@
+{
+  "schema": "inklet.clipping-benchmark/1",
+  "python": "3.12.3",
+  "platform": "Linux-6.6.87.2-microsoft-standard-WSL2-x86_64-with-glibc2.39",
+  "source_sha256": "f323b9e3b780d44cc5ea1b286512bc9d3ec019a1387e814803964d8cc9d27d13",
+  "cases": [
+    {
+      "case": "line",
+      "runs": [
+        {
+          "clip_seconds": 0.2047820259758737,
+          "svg_seconds": 0.010102088999701664,
+          "pdf_seconds": 0.02015214299899526,
+          "total_seconds": 0.23503625797457062,
+          "svg_bytes": 76870,
+          "pdf_bytes": 36176
+        },
+        {
+          "clip_seconds": 0.20985267401556484,
+          "svg_seconds": 0.010210584994638339,
+          "pdf_seconds": 0.02010145699023269,
+          "total_seconds": 0.24016471600043587,
+          "svg_bytes": 76870,
+          "pdf_bytes": 36176
+        },
+        {
+          "clip_seconds": 0.20240381799521856,
+          "svg_seconds": 0.010233473003609106,
+          "pdf_seconds": 0.02053205599077046,
+          "total_seconds": 0.23316934698959813,
+          "svg_bytes": 76870,
+          "pdf_bytes": 36176
+        }
+      ],
+      "median": {
+        "clip_seconds": 0.2047820259758737,
+        "svg_seconds": 0.010210584994638339,
+        "pdf_seconds": 0.02015214299899526,
+        "total_seconds": 0.23503625797457062,
+        "svg_bytes": 76870,
+        "pdf_bytes": 36176
+      }
+    },
+    {
+      "case": "band",
+      "runs": [
+        {
+          "clip_seconds": 0.6113144700066186,
+          "svg_seconds": 0.05068271100753918,
+          "pdf_seconds": 0.0926879330072552,
+          "total_seconds": 0.754685114021413,
+          "svg_bytes": 316513,
+          "pdf_bytes": 145203
+        },
+        {
+          "clip_seconds": 0.5794899000029545,
+          "svg_seconds": 0.0481099919998087,
+          "pdf_seconds": 0.08913570898585021,
+          "total_seconds": 0.7167356009886134,
+          "svg_bytes": 316513,
+          "pdf_bytes": 145203
+        },
+        {
+          "clip_seconds": 0.5717577220057137,
+          "svg_seconds": 0.047267758985981345,
+          "pdf_seconds": 0.09365696899476461,
+          "total_seconds": 0.7126824499864597,
+          "svg_bytes": 316513,
+          "pdf_bytes": 145203
+        }
+      ],
+      "median": {
+        "clip_seconds": 0.5794899000029545,
+        "svg_seconds": 0.0481099919998087,
+        "pdf_seconds": 0.0926879330072552,
+        "total_seconds": 0.7167356009886134,
+        "svg_bytes": 316513,
+        "pdf_bytes": 145203
+      }
+    },
+    {
+      "case": "curves",
+      "runs": [
+        {
+          "clip_seconds": 0.03832915498060174,
+          "svg_seconds": 0.0019394969858694822,
+          "pdf_seconds": 0.002644603024236858,
+          "total_seconds": 0.04291325499070808,
+          "svg_bytes": 13575,
+          "pdf_bytes": 7041
+        },
+        {
+          "clip_seconds": 0.03621691299485974,
+          "svg_seconds": 0.0019186209829058498,
+          "pdf_seconds": 0.0025379790167789906,
+          "total_seconds": 0.04067351299454458,
+          "svg_bytes": 13575,
+          "pdf_bytes": 7041
+        },
+        {
+          "clip_seconds": 0.038817927008494735,
+          "svg_seconds": 0.0018433219811413437,
+          "pdf_seconds": 0.0024352470063604414,
+          "total_seconds": 0.04309649599599652,
+          "svg_bytes": 13575,
+          "pdf_bytes": 7041
+        }
+      ],
+      "median": {
+        "clip_seconds": 0.03832915498060174,
+        "svg_seconds": 0.0019186209829058498,
+        "pdf_seconds": 0.0025379790167789906,
+        "total_seconds": 0.04291325499070808,
+        "svg_bytes": 13575,
+        "pdf_bytes": 7041
+      }
+    }
+  ]
+}

inklet-4.0.0.dev3/docs/assets/research-preview/clipping-caption.tex

@@ -0,0 +1 @@
+\caption{Clipping checks using original simulated data and artwork. (a) Geometrically clipped smooth response curves, retaining cubic segments. (b) A dense signal with a narrow peak and an explicit missing-data gap; physical simplification tolerance 0.02 mm. (c) Filled uncertainty-like bands representing supplied simulated intervals, cropped with their outlines. (d) Large boundary markers and thick strokes cropped by a painted window. (e) A synthetic scalar image under a rotated convex window. (f) Glyphs and halos cropped together. (g) Rounded rectangles and an even-odd hole, cropped without changing their source geometry. (h) Nested windows with group opacity beside an unclipped sibling. Letter labels identify checks; the artwork contains no panel titles. Recipe and artwork: MIT, Mark Marosi. No measured data or inferred uncertainty.}