inklet 4.0.0.dev4__tar.gz → 4.0.0.dev5__tar.gz

{inklet-4.0.0.dev4 → inklet-4.0.0.dev5}/.github/workflows/publish.yml

@@ -6,7 +6,7 @@ on:
       tag:
         description: Published GitHub release tag
         required: true
-        default: v4.0.0.dev4
+        default: v4.0.0.dev5
         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.dev4' >&2
+            echo 'Expected a stable or development tag such as v3.1.0 or v4.0.0.dev5' >&2
             exit 1
           }
           gh release view "$RELEASE_TAG" --json isDraft,isPrerelease > "$RUNNER_TEMP/release.json"

{inklet-4.0.0.dev4 → inklet-4.0.0.dev5}/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+## 4.0.0.dev5 — 2026-09-12
+
+Fifth development preview: shared plotting, customization and composition.
+3.1.0 remains the stable release.
+
+- Add reusable PlotSpec.copy(), extend() and style() for independent recipe
+  variants, combined mark layers and preserved live data dependencies.
+- Add per-axis options to Panel.axes() and PlotSpec.axes(); preset grids use
+  matching label measurements. Support local Series colour/name overrides.
+- Preserve authored data heights when automatic document legends wrap, without
+  requiring globally shared margins. Apply plot dimension updates atomically.
+- Add a five-panel plot/diagram composition at two widths, an illustrated guide,
+  and regression checks for reuse, data edits, layout and customization.
+
+- Add experimental GeoFeatures and MapView for linked GeoJSON points, routes and
+  regions, with multi-part identity, topmost map picking, exact keyed joins,
+  source attribution and geometry revisions. Include a four-panel transport
+  recipe, two-width exports and an illustrated offline guide.
+
 ## 4.0.0.dev4 — 2026-09-12
 
 Fourth development preview: correct closed polar geometry and make the plot

{inklet-4.0.0.dev4 → inklet-4.0.0.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: inklet
-Version: 4.0.0.dev4
+Version: 4.0.0.dev5
 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,16 +81,16 @@ their signatures and report schemas may change.
 
 ## 4.0 development preview
 
-**4.0.0.dev4** fixes closed polar curves and shaded bands, and adds a visual
-plot gallery with 22 runnable examples. It retains shared compiled rendering,
-offline viewing, linked reports, and reproducible plot editing with undo/redo.
+**4.0.0.dev5** adds reusable plot recipes, independent styling, per-axis controls
+and improved automatic layout. Compose live plot layers, make visual variants,
+and resize mixed-content figures while preserving physical typography.
 ```sh
-python -m pip install "inklet==4.0.0.dev4"
+python -m pip install "inklet==4.0.0.dev5"
 ```
 
 [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.dev4)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev5)
 
 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.dev4 → inklet-4.0.0.dev5}/README.md

@@ -31,16 +31,16 @@ their signatures and report schemas may change.
 
 ## 4.0 development preview
 
-**4.0.0.dev4** fixes closed polar curves and shaded bands, and adds a visual
-plot gallery with 22 runnable examples. It retains shared compiled rendering,
-offline viewing, linked reports, and reproducible plot editing with undo/redo.
+**4.0.0.dev5** adds reusable plot recipes, independent styling, per-axis controls
+and improved automatic layout. Compose live plot layers, make visual variants,
+and resize mixed-content figures while preserving physical typography.
 ```sh
-python -m pip install "inklet==4.0.0.dev4"
+python -m pip install "inklet==4.0.0.dev5"
 ```
 
 [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.dev4)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev5)
 
 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.dev4 → inklet-4.0.0.dev5}/docs/api.md

@@ -287,9 +287,12 @@ Create a live document; optionally share plot furniture across the grid.
 
 A live plot recipe. Construct with `plot_spec()`.
 
+* `copy()` -- Copy instructions and nested plots, retaining explicit live dependencies.
+* `extend(other, *, prefix=None)` -- Append an independent copy of another plot's recorded instructions.
+* `style(key, **options)` -- Merge keyword options into a named instruction without replacing data.
 * `replace(key, *args, **kwargs)` -- Replace arguments of an instruction recorded with `key=...`.
 * `remove(key)`
-* `configure(*, width=None, height=None, **options)`
+* `configure(*, width=None, height=None, **options)` -- Validate physical dimensions together before applying configuration.
 * `annotate(x, y, text, *, avoid_marks=True, key=None, **options)` -- Place a callout after marks, insets and brackets have been measured.
 * `group_labels(categories, *, key=None, **kwargs)`
 * `series(series, *, kind='line', uncertainty=True, key=None, **style)` -- Draw a shared Series definition, including its name and uncertainty.
@@ -608,7 +611,7 @@ A drawing region plus the scales that map data into it.
 * `outline(**style) -> "'Panel'"` -- A rectangle around the area, drawn over the data.
 * `grid(*, x: 'bool' = True, y: 'bool' = True, count: 'int' = 5, x_options: 'dict | None' = None, y_options: 'dict | None' = None, **style) -> "'Panel'"` -- Rules at the tick positions, under the data.
 * `axis(side: 'str' = 'bottom', *, at=None, **kwargs) -> "'Panel'"` -- Hang an axis off one edge, built from this panel's own scale.
-* `axes(x: 'str | None' = None, y: 'str | None' = None, **kwargs) -> "'Panel'"` -- The usual pair: an x axis below and a y axis to the left, labelled.
+* `axes(x: 'str | None' = None, y: 'str | None' = None, *, x_options: 'dict | None' = None, y_options: 'dict | None' = None, **kwargs) -> "'Panel'"` -- Bottom and left axes with shared and per-axis options.
 * `twin_y(scale=None, *, side: 'str' = 'right', label: 'str | Diagram | None' = None, color: 'str | None' = None, axis: 'bool' = True, **kwargs) -> "'Panel'"` -- A second y scale over the same area, and a handle that draws in it.
 * `twin_x(scale=None, *, side: 'str' = 'top', label: 'str | Diagram | None' = None, color: 'str | None' = None, axis: 'bool' = True, **kwargs) -> "'Panel'"` -- A second x scale over the same area -- wavelength above frequency, or a second time base. `twin_y` explains the shape of it.
 * `title(content: 'str | Diagram', *, align: 'str' = 'center', pad: 'float | str | None' = None) -> "'Panel'"` -- A heading over the panel, clear of whatever is already in it.