inklet 4.0.0.dev7__tar.gz → 4.0.0.dev8__tar.gz

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/.github/workflows/publish.yml

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

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## Unreleased
 
+## 4.0.0.dev8 — 2026-09-12
+
+Eighth development preview: local browser layout editing with Python compilation.
+3.1.0 remains the stable release.
+
+- Add experimental LayoutEditor with a loopback browser inspector for named
+  composition placements and dimensions, using the real Python compiler for
+  previews and matching SVG/PDF exports.
+- Add atomic edit/load/reset commands, bounded undo/redo, saved dev7 layout JSON,
+  and explicit source refresh with removed-target reconciliation.
+- Preserve the last successful preview/history after errors, reject stale
+  revisions and exports, and keep shared nested definitions consistent.
+- Add a runnable mixed-content editor, an illustrated guide, browser/HTTP tests,
+  concurrent-client checks and core-only installed-package coverage.
+
 ## 4.0.0.dev7 — 2026-09-12
 
 Seventh development preview: reproducible composition layout choices.

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: inklet
-Version: 4.0.0.dev7
+Version: 4.0.0.dev8
 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.dev7** adds saved layout choices for reusable compositions. Restore
-named placements and measured dimensions after data, label or content changes,
-with explicit reports for removed targets and independently editable recipes.
+**4.0.0.dev8** adds a local browser layout inspector backed by the Python
+compiler. Edit named placements and dimensions, undo/redo changes, save layout
+choices, and export the same compiled preview to SVG or PDF.
 ```sh
-python -m pip install "inklet==4.0.0.dev7"
+python -m pip install "inklet==4.0.0.dev8"
 ```
 
 [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.dev7)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev8)
 
 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.dev7 → inklet-4.0.0.dev8}/README.md

@@ -31,16 +31,16 @@ their signatures and report schemas may change.
 
 ## 4.0 development preview
 
-**4.0.0.dev7** adds saved layout choices for reusable compositions. Restore
-named placements and measured dimensions after data, label or content changes,
-with explicit reports for removed targets and independently editable recipes.
+**4.0.0.dev8** adds a local browser layout inspector backed by the Python
+compiler. Edit named placements and dimensions, undo/redo changes, save layout
+choices, and export the same compiled preview to SVG or PDF.
 ```sh
-python -m pip install "inklet==4.0.0.dev7"
+python -m pip install "inklet==4.0.0.dev8"
 ```
 
 [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.dev7)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev8)
 
 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.dev7 → inklet-4.0.0.dev8}/docs/compatibility.md

@@ -48,7 +48,7 @@ Blender. Scene creation and rendering run Blender in a separate process.
 ### Development-preview table adapters
 
 The [pandas and Polars adapters](table-inputs.md) are included in the experimental
-[4.0.0.dev7 preview](development-preview.md), not in stable 3.1.0. Their `pandas` and `polars` extras are separate
+[4.0.0.dev8 preview](development-preview.md), not in stable 3.1.0. Their `pandas` and `polars` extras are separate
 from core dependencies. The adapter CI jobs use Linux/Python 3.12 with pandas
 2.2.0 / Polars 1.0.0 and the versions pinned in `requirements-tables.txt`.
 Both paths check scalar/identity contracts and saved-state SVG reconstruction.

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/docs/composition-recipes.md

@@ -15,7 +15,7 @@ illustrative data and generated geometry.
 
 [Open the standalone figure viewer](assets/guides/composition-recipes.html).
 The viewer supports exploration; these placement and content edits are made
-in Python. Browser layout editing remains on the [roadmap](roadmap.md).
+in Python or through the [local layout inspector](layout-editor.md) in dev8.
 
 ## Declare inputs and defaults
 
@@ -132,8 +132,9 @@ needs. The complete example rejects widths below 140 mm.
 Run `python examples/composition_recipes.py --render` from the checkout to
 produce the SVG/PDF/PNG comparisons, standalone HTML viewers, revised-data
 exports and build statistics in `out/composition-recipes/`. PNG requires the
-render extras. This is a Python recipe API; serialized project templates,
-asset manifests and browser layout overrides remain separate upcoming work.
+render extras. This is a Python recipe API; serialized project templates
+and asset manifests remain separate upcoming work. Saved layout choices and
+the [local inspector](layout-editor.md) build on these recipes.
 
 In dev7, [save and restore layout choices](layout-overrides.md) separately from
 the recipe, preserving measured expressions and reporting removed targets.

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/docs/development-preview.md

@@ -1,6 +1,6 @@
-# Inklet 4.0.0.dev7
+# Inklet 4.0.0.dev8
 
-The seventh 4.0 development release includes the linked plotting, mapping,
+The eighth 4.0 development release includes the linked plotting, mapping,
 engineering and scientific workflows developed since 3.1.0. It is an installable
 snapshot for trying real examples and reporting problems. **3.1.0 remains the
 stable release.** The [4.0 roadmap](roadmap.md) still has open work.
@@ -8,7 +8,7 @@ stable release.** The [4.0 roadmap](roadmap.md) still has open work.
 ```sh
 python -m venv .venv
 source .venv/bin/activate
-python -m pip install "inklet==4.0.0.dev7"
+python -m pip install "inklet==4.0.0.dev8"
 ```
 
 On Windows PowerShell, activate with `.venv\Scripts\Activate.ps1` instead.
@@ -19,9 +19,9 @@ stable releases; see its [installation documentation](https://pip.pypa.io/en/sta
 Optional extras can be installed with the same pin:
 
 ```sh
-python -m pip install "inklet[render,pandas,polars]==4.0.0.dev7"
+python -m pip install "inklet[render,pandas,polars]==4.0.0.dev8"
 # Add calibrated volumes and TIFF workflows when needed:
-python -m pip install "inklet[volume,render]==4.0.0.dev7"
+python -m pip install "inklet[volume,render]==4.0.0.dev8"
 ```
 
 The core preview needs no browser server, NumPy, pandas, Polars or Blender.
@@ -29,7 +29,27 @@ Opening the generated HTML requires a browser. PNG/PDF exports from browser
 figures use separate Chrome/Chromium and Pillow; native Diagram exports retain
 their existing requirements. See [installation](installation.md).
 
-## Saved layout choices in dev7
+## Local layout inspector in dev8
+
+The [local layout editor](layout-editor.md) turns saved composition choices into
+a browser workflow. Edit named placements and dimensions, preview the actual
+Python-compiled figure, undo/redo changes, reopen layout JSON and download
+matching SVG/PDF exports. The source recipe remains unchanged.
+
+Failed edits retain the last successful preview and history. Explicit source
+refresh reapplies choices after data/content changes, reports removed targets
+and clears history. Revision checks prevent stale tabs from overwriting newer
+edits or silently exporting a different preview. Shared nested definitions
+remain consistent across repeated edits and resets.
+
+![The local browser layout inspector](assets/guides/layout-editor.png)
+
+This inspector requires its local Python session. It covers composition layout;
+drag handles, label content, plot styling and cameras remain separate work.
+The existing standalone viewers and linked-plot appearance editor retain their
+current scope.
+
+## Saved layout choices retained from dev7
 
 [Layout overrides](layout-overrides.md) capture changed placements and page
 settings separately from the Python recipe. Versioned JSON uses named paths,
@@ -44,8 +64,8 @@ after measurements, geometry and labels change.
 
 ![Saved layout applied to revised content](assets/guides/layout-revised.png)
 
-These are Python authoring APIs. Browser layout editing, label/camera overrides,
-shared selection relationships and asset manifests remain open roadmap work.
+The saved format covers layout decisions. Label/camera overrides, broader
+selection relationships and asset manifests remain open roadmap work.
 
 ## Reusable compositions retained from dev6
 
@@ -63,8 +83,8 @@ cache invalidation and guide execution are covered by regression checks.
 
 ![A reusable report combining a live plot, 3D and a nested workflow](assets/guides/composition-recipes.png)
 
-Serialized project templates, asset manifests and browser layout editing remain
-open roadmap items. This release develops the shared Python composition API.
+Serialized project templates and asset manifests remain open roadmap items.
+The local inspector above builds on this shared Python composition API.
 
 ## Shared plotting and composition retained from dev5
 
@@ -142,7 +162,7 @@ The wheel contains the library. To obtain recipes and fixtures, use the matching
 release checkout or source archive:
 
 ```sh
-git clone --branch v4.0.0.dev7 https://github.com/Mapika/inklet.git
+git clone --branch v4.0.0.dev8 https://github.com/Mapika/inklet.git
 cd inklet
 python -m pip install -e '.[render]'
 python examples/v4/regional_report.py --renderer compiled --editor --output out/regional

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/docs/installation.md

@@ -3,7 +3,7 @@
 Inklet requires Python 3.11 or later and an installed TrueType/OpenType font.
 The core Python dependencies are HarfBuzz bindings and fontTools.
 
-This page covers stable **Inklet 3.1** and the opt-in **4.0.0.dev7 preview**. See the
+This page covers stable **Inklet 3.1** and the opt-in **4.0.0.dev8 preview**. See the
 [compatibility matrix](compatibility.md) for tested platforms and Blender versions.
 
 ## From PyPI
@@ -24,9 +24,9 @@ Activate the environment or prefix commands with `.venv/bin/` on Linux/macOS.
 ## 4.0 development preview
 
 ```sh
-python -m pip install "inklet==4.0.0.dev7"
+python -m pip install "inklet==4.0.0.dev8"
 # Optional rendering and DataFrame adapters:
-python -m pip install "inklet[render,pandas,polars]==4.0.0.dev7"
+python -m pip install "inklet[render,pandas,polars]==4.0.0.dev8"
 ```
 
 Use a separate virtual environment when trying the preview. Experimental APIs

inklet-4.0.0.dev8/docs/layout-editor.md

@@ -0,0 +1,137 @@
+# Local layout editor
+
+Available in **4.0.0.dev8**, under `inklet.experimental.layout_editor`. Adjust
+named placements and dimensions in a browser while Python recompiles the
+actual composition. The preview and downloaded SVG/PDF come from the same
+compiled figure, including plots, nested diagrams and native 3D content.
+
+![The local layout inspector editing a mixed-content report](assets/guides/layout-editor.png)
+
+The [complete example](../examples/layout_editor.py) opens the reusable report
+from [composition recipes](composition-recipes.md). From the checkout, run:
+
+```sh
+python examples/layout_editor.py
+```
+
+Open the local URL printed in the terminal. Keep that Python process running;
+press Ctrl+C to stop it. This is a local editor, not a standalone HTML editing
+file. Ordinary [figure viewers](compiled-viewer.md) remain available for
+sharing a finished document without a Python process.
+
+## Start with your composition
+
+```python
+import inklet as i
+from inklet.experimental.layout_editor import LayoutEditor
+
+recipe = i.composition(120, 75)
+recipe.add('chart', i.plot_spec(x=(0, 2), y=(0, 4)).line([(0, 1), (1, 2), (2, 3)]).axes(),
+           x=13, y=8, anchor='area-nw', width=recipe.page_width - 26, height=30)
+recipe.add('caption', i.module('Response'), x=13, y=55)
+editor = LayoutEditor(recipe).start()
+print(editor.url)
+```
+
+In a notebook or interactive Python session, leave the editor running while you
+open its URL. It listens only on the local computer. `start(port=...)` can
+request a particular port; the default chooses an available one. The editor
+retains the supplied recipe as its live source and edits independent copies.
+It does not rewrite Python or modify the source recipe.
+
+Pass `preset='scientific.general'` or another preset name to compile under that
+preset. By default, the containing document follows the composition's physical
+width and height, including its coordinate unit. Optional `width=` and
+`height=` arguments fix the containing document's dimensions in millimetres;
+those dimensions remain authoritative when the authored page size changes.
+
+## Edit and review
+
+Choose a named path in **Content**, enter the fields you want to change, then
+select **Apply layout**. Other fields retain their definitions.
+
+- Child placement fields are X, Y, anchor, width and height. Numbers use the
+  containing composition's coordinate unit. For plots, width and height describe
+  the data region; changing them does not scale text or strokes.
+- A field marked **Measured** still follows its layout expression. Entering a
+  number replaces that expression with a fixed value. **Reset target** restores
+  that target's source layout, including its measured expressions.
+- Blank child width or height means to use the authored content size. A blank
+  anchor preserves the local coordinate frame. Composition size fields must
+  remain positive.
+- Nested compositions also expose their authored dimensions, coordinate unit
+  and top-fitting option. Registered ports and measured links reflow when the
+  compiler rebuilds.
+
+Failed layouts show an error beside the Apply controls. The last successful
+preview, saved choices and undo history remain available. The inspector does
+not automatically resolve overlap or add constraints: author the required
+measured relationships and minimum sizes in the Python recipe.
+
+**Undo** and **Redo** retain up to 100 successful layout edits. A new edit after
+undo starts a new history branch. Shared nested definitions remain shared:
+editing or resetting one occurrence affects the same definition wherever it
+appears. Distinct placements of that shared content remain independently editable.
+
+## Save, reopen and export
+
+**Save layout** downloads the versioned JSON described in
+[saved layout choices](layout-overrides.md). **Open layout choices** loads that
+same format. The file contains changed placements and dimensions, not the
+source content, styles, assets or undo history. Keep it alongside the recipe.
+
+**Download SVG** and **Download PDF** export the successful preview revision.
+If another editor tab changes the session first, stale commands and export
+links are rejected. Use **Reload editor** to obtain the current shared state.
+
+The same operations are available in Python:
+
+```python
+import json
+from pathlib import Path
+
+editor.command('edit', {'path': '/chart', 'placement': {'height': 35}})
+Path('layout-overrides.json').write_text(json.dumps(editor.overrides(), indent=2))
+editor.figure.save('edited.svg', 'edited.pdf')
+restored, report = recipe.with_layout_overrides(editor.overrides())
+assert report['orphaned_targets'] == []
+```
+
+`editor.figure` is the last successful compiled snapshot and supports the normal
+[export APIs](export-review.md), including PNG when render dependencies are
+installed. `overrides()` and `snapshot()` return independently owned data.
+Programmatic `command()` accepts `edit`, `reset`, `load`, `undo`, `redo` and
+`refresh`; an optional `revision=` rejects stale callers.
+
+## Refresh changed source content
+
+After updating a Dataset, module label or supplied component in the original
+Python recipe, choose **Refresh source**. The editor reapplies saved layout
+choices, recompiles and clears undo history. It does not watch or rerun Python
+source files. Use a live Python session for source edits, or restart the example
+and reopen its saved layout file after changing its script.
+
+Removed named targets or measured references are reported as errors. The
+**Refresh and discard removed targets** button appears after such a failure;
+it explicitly discards incompatible entries and reports their paths. The last
+successful figure remains visible until a refresh succeeds. Loading an
+incompatible file also fails rather than silently dropping choices; reconcile
+it explicitly through the Python [override API](layout-overrides.md) if needed.
+
+```python
+recipe['caption'].configure('Updated source label')
+editor.command('refresh')
+assert not editor.snapshot()['undo']
+editor.close()
+```
+
+Closing the editor stops its server. Its compiled figure and saved choices
+remain accessible in Python. The `with LayoutEditor(recipe) as editor:` form
+starts and closes the server automatically; keep that context alive during
+browser use.
+
+This first inspector edits composition layout. Drag handles, label content,
+plot styling, camera controls, and file watching are not part of this interface.
+The separate [linked-plot appearance editor](visual-editing.md) retains its
+existing scope. Broader authoring and identity work remains on the
+[4.0 roadmap](roadmap.md).

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/docs/layout-overrides.md

@@ -13,8 +13,8 @@ the edited SVG at both 180 and 150 mm. The [complete example](../examples/compos
 uses live illustrative data and generated geometry.
 
 [Open the restored figure viewer](assets/guides/layout-restored.html).
-The viewer supports zoom, pan and vector export; layout editing is currently
-through Python. This format is separate from the experimental linked-table
+The viewer supports zoom, pan and vector export. Edit layouts through the
+Python APIs below or the [local inspector](layout-editor.md) in dev8. This format is separate from the experimental linked-table
 [plot-style overrides](visual-editing.md).
 
 ## Capture changes against a reference
@@ -137,3 +137,6 @@ a revised module label. Run
 `python examples/composition_recipes.py --render --saved-layout` to generate
 the comparison files, `layout-overrides.json` and `layout-reconciliation.json`
 in `out/composition-recipes/`. PNG generation requires the render extras.
+
+In dev8, the [local layout editor](layout-editor.md) provides browser controls,
+undo/redo and Python-compiled previews using this saved format.

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/docs/roadmap.md

@@ -56,9 +56,11 @@ content inputs, independent instances, placement edits and nested attachment
 points in dev6, exercised by plots, diagrams and native 3D at two widths.
 Dev7 adds [saved layout overrides](layout-overrides.md) keyed by named paths,
 with measured expressions, independent restoration and explicit orphan reports.
-Serialized project templates, asset manifests, shared selection relationships
-and browser layout editing remain open. Subsequent work should connect these
-Python authoring contracts to direct editing and cross-content identity.
+Dev8 adds a [local layout inspector](layout-editor.md) backed by Python
+compilation, with saved choices, undo/redo and explicit source refresh.
+Serialized project templates, asset manifests, shared selection relationships,
+label/camera editing and direct manipulation remain open. Subsequent work
+should extend authoring and cross-content identity beyond this bounded inspector.
 
 ## Who this should serve
 

inklet-4.0.0.dev8/examples/layout_editor.py

@@ -0,0 +1,19 @@
+"""Edit a mixed plot, diagram and native-3D composition in a local browser."""
+import argparse
+import threading
+from composition_recipes import make_reports
+from inklet.experimental.layout_editor import LayoutEditor
+
+
+def main():
+    parser=argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--port',type=int,default=0,help='Local port; 0 chooses an available port')
+    args=parser.parse_args()
+    reports,_=make_reports()
+    with LayoutEditor(reports[0],preset='scientific.general').start(port=args.port) as editor:
+        print(f'Open {editor.url} — press Ctrl+C to stop.',flush=True)
+        try:threading.Event().wait()
+        except KeyboardInterrupt:pass
+
+
+if __name__=='__main__':main()

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/mkdocs.yml

@@ -64,6 +64,7 @@ nav:
   - Panel layout: layout.md
   - Reusable compositions: composition-recipes.md
   - Save layout choices: layout-overrides.md
+  - Local layout editor: layout-editor.md
   - Presets and styling: presets.md
   - Review and export: export-review.md
 - Interactive documents (preview):

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "inklet"
-version = "4.0.0.dev7"
+version = "4.0.0.dev8"
 description = "Scientific figures with live data, measured layout, and consistent vector exports."
 readme = "README.md"
 authors = [{name = "Mark Marosi"}]

{inklet-4.0.0.dev7 → inklet-4.0.0.dev8}/src/inklet/__init__.py

@@ -470,4 +470,4 @@ __all__ = [
     "mm", "pt", "COLUMN_SINGLE", "COLUMN_DOUBLE",
 ]
 
-__version__ = "4.0.0.dev7"
+__version__ = "4.0.0.dev8"