inklet 4.0.0.dev7__tar.gz → 4.0.0.dev9__tar.gz

{inklet-4.0.0.dev7 → inklet-4.0.0.dev9}/.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.dev9
         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.dev9' >&2
             exit 1
           }
           gh release view "$RELEASE_TAG" --json isDraft,isPrerelease > "$RUNNER_TEMP/release.json"

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

@@ -2,6 +2,36 @@
 
 ## Unreleased
 
+## 4.0.0.dev9 — 2026-09-12
+
+Ninth development preview: mouse movement and proportional artwork scaling.
+3.1.0 remains the stable release.
+
+- Add click/drag selection and movement, corner scale handles, containing-group
+  selection, keyboard nudges and cancellable pointer gestures to LayoutEditor.
+- Map gestures through nested physical coordinate units and scales. Preserve
+  measured positions with folded offsets and keep the opposite scale corner fixed.
+- Add explicit Composition child scale, preserving registered ports and scaling
+  complete artwork. Width/height fitting retains its separate layout semantics.
+- Save scale in composition-layout schema 0.2; continue loading schema 0.1 files.
+- Cover geometry, ports, all four corners, undo/reopen, nested transforms,
+  invalid gestures and browser/Python export agreement; update the editor guide.
+
+## 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.dev9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: inklet
-Version: 4.0.0.dev7
+Version: 4.0.0.dev9
 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.dev9** adds mouse movement and proportional artwork scaling to the
+local layout editor. Drag named objects and groups, use corner handles, undo
+gestures, and save choices that reproduce through the Python compiler.
 ```sh
-python -m pip install "inklet==4.0.0.dev7"
+python -m pip install "inklet==4.0.0.dev9"
 ```
 
 [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.dev9)
 
 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.dev9}/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.dev9** adds mouse movement and proportional artwork scaling to the
+local layout editor. Drag named objects and groups, use corner handles, undo
+gestures, and save choices that reproduce through the Python compiler.
 ```sh
-python -m pip install "inklet==4.0.0.dev7"
+python -m pip install "inklet==4.0.0.dev9"
 ```
 
 [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.dev9)
 
 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.dev9}/docs/api.md

@@ -218,7 +218,7 @@ A figure assembled from named children and measured expressions.
 
 * `measure(name, dimension='width')` -- Reference a child's measured width or height, in composition units.
 * `point(name, anchor='center')` -- Reference a placed child's compass point or registered port.
-* `add(name, item, *, x=0, y=0, anchor=None, width=None, height=None)`
+* `add(name, item, *, x=0, y=0, anchor=None, width=None, height=None, scale=1)`
 * `replace(name, item)` -- Replace a child while preserving its placement and dependent references.
 * `slot(name, **placement)` -- Declare a required content input with the same placement options as add().
 * `copy()` -- Copy nested compositions, plots, modules and component instructions.

{inklet-4.0.0.dev7 → inklet-4.0.0.dev9}/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.dev9 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.dev9}/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
 
@@ -86,7 +86,9 @@ assert before.to_svg() == old_svg
 assert doc.compile() is after
 ```
 
-`place()` changes only placement fields: `x`, `y`, `anchor`, `width`, `height`.
+`place()` changes placement fields: `x`, `y`, `anchor`, `width`, `height` and
+`scale`. Explicit `scale` (dev9) uniformly scales complete artwork, including
+text and strokes; it is separate from fitting a plot to a new width/height.
 Set `anchor`, `width` or `height` to `None` to restore their unspecified behavior.
 `replace()` replaces content and keeps its placement and named relationships.
 Dimension updates through `configure()` validate before mutation; expressions,
@@ -132,8 +134,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.dev9}/docs/development-preview.md

@@ -1,6 +1,6 @@
-# Inklet 4.0.0.dev7
+# Inklet 4.0.0.dev9
 
-The seventh 4.0 development release includes the linked plotting, mapping,
+The ninth 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.dev9"
 ```
 
 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.dev9"
 # 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.dev9"
 ```
 
 The core preview needs no browser server, NumPy, pandas, Polars or Blender.
@@ -29,7 +29,46 @@ 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
+## Mouse movement and scaling in dev9
+
+The [layout editor](layout-editor.md) now supports direct mouse movement and
+proportional corner scaling of named objects and groups. Alt-click selects a
+containing group, arrow keys nudge, and Escape cancels. A drag shows an outline;
+release compiles the actual figure and updates dependent links.
+
+Moves preserve measured positions by adding offsets. Scaling keeps the opposite
+corner fixed, including inside scaled groups with different coordinate units.
+Each completed edit participates in undo/redo and saved-layout reconstruction.
+Uniform artwork scaling includes text and strokes; plot width/height controls
+retain their separate typography-preserving layout behavior.
+
+![Mouse selection and proportional scaling in the local editor](assets/guides/layout-editor-gestures.png)
+
+New layout files use schema 0.2 for explicit artwork scale. Dev7/dev8 schema 0.1
+files still load. Named composition objects are editable; individual plot marks,
+axis labels, connector segments and camera parameters remain outside this scope.
+
+## Local layout inspector retained from 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;
+label content, individual plot marks 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 +83,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 +102,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 +181,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.dev9 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.dev9}/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.dev9 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.dev9"
 # 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.dev9"
 ```
 
 Use a separate virtual environment when trying the preview. Experimental APIs

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

@@ -0,0 +1,170 @@
+# Local layout editor
+
+Available since **4.0.0.dev8**, with mouse gestures in **4.0.0.dev9**, 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.
+
+![Mouse selection and proportional scaling handles on a native 3D object](assets/guides/layout-editor-gestures.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.
+
+## Move and scale with the mouse
+
+Click a named object in the preview and drag it to move. Corner handles scale
+its complete artwork proportionally, keeping the opposite corner fixed. This
+works for plots, modules, text, images, native 3D components and nested
+compositions. A dashed outline follows the pointer; release to compile the
+result and update dependent links. Escape or a cancelled pointer gesture leaves
+the figure unchanged. A simple click selects without making an edit.
+
+Use Alt-click to select a containing group, or choose its path in **Content**.
+Drag a selected group's outline to move the group. With the canvas focused,
+arrow keys move the selected object by 1 mm in figure space; Shift changes that
+to 10 mm. Mouse and pointer gestures use the same coordinates even inside
+scaled groups or compositions with different coordinate units.
+
+Each completed edit is one undo step. Movements add offsets to measured
+positions instead of discarding their relationships. Repeated offsets are
+combined, so a long editing session does not grow ever-deeper expressions.
+Saved layout files retain movement and scaling for Python reconstruction.
+
+**Scaling artwork also scales its text and strokes.** To resize a plot's data
+region while retaining physical typography, use the width/height controls
+below. The **Uniform scale** field gives an exact artwork scale factor; Reset
+target restores the original factor and placement.
+
+The selectable units are named composition children and groups. Individual
+marks, ticks, axis labels and connector segments remain part of their owning
+plot or diagram. Scaling and movement do not remove authored constraints or
+top-fitting behavior; dependent content can reflow when the compiler rebuilds.
+
+## 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, height and uniform scale. 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}})
+editor.command('gesture', {'path': '/chart', 'dx': 2, 'dy': 1})
+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 `gesture`, `edit`, `reset`, `load`, `undo`,
+`redo` and `refresh`; an optional `revision=` rejects stale callers. A gesture
+uses figure-space `dx`/`dy` in millimetres. Optional `factor` and `corner`
+(`nw`, `ne`, `sw`, `se`) scale from the opposite corner.
+
+## 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.
+
+The inspector edits named composition layout and artwork scale. Label content,
+individual plot marks, 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.dev9}/docs/layout-overrides.md

@@ -1,6 +1,6 @@
 # Save and restore layout choices
 
-Available in **4.0.0.dev7**. Save placement and dimension edits separately from
+Available since **4.0.0.dev7**; uniform artwork scale is added in **dev9**. Save placement and dimension edits separately from
 a [composition recipe](composition-recipes.md), then restore those choices
 when its data, labels or content change. The saved JSON records only differences
 from a reference recipe. Unedited source decisions remain in control.
@@ -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
@@ -41,7 +41,7 @@ Path('layout.json').write_text(json.dumps(state, indent=2, allow_nan=False))
 ```
 
 `layout_overrides(reference)` captures changed `x`, `y`, `anchor`, `width` and
-`height` fields on children, plus `width`, `height`, `unit` and `fit_top` on
+`height` and uniform `scale` fields on children, plus `width`, `height`, `unit` and `fit_top` on
 compositions. It visits nested compositions through their named children.
 Measured expressions remain expressions, so page resizing and dependent
 content measurements still work after reopening.
@@ -123,8 +123,10 @@ of 32 operations. Malformed files, nonfinite numbers, invalid properties and
 contradictory edits to a shared nested definition are rejected, including when
 `missing='drop'` is used.
 
-The schema identifier is `inklet.composition-layout/0.1`. Unknown schemas are
-rejected. The file is a JSON object with `schema` and `targets`; each target has
+New files use `inklet.composition-layout/0.2`, which adds a positive uniform
+artwork scale. The loader also accepts `inklet.composition-layout/0.1` files
+from dev7/dev8; those cannot contain scale fields. Unknown schemas are rejected.
+Upgrade older readers before opening a new 0.2 file. The file is a JSON object with `schema` and `targets`; each target has
 changed `placement` and/or `page` fields. It is a development-preview format,
 not a general Python object serializer or an asset manifest.
 
@@ -137,3 +139,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.dev9}/docs/roadmap.md

@@ -56,9 +56,13 @@ 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.
+Dev9 adds mouse movement, proportional artwork scaling and keyboard nudges
+for named composition children, with preserved measured positions and saved
+choices. Serialized project templates, asset manifests, shared selection
+relationships, label/camera editing and finer-grained manipulation remain open. Subsequent work
+should extend authoring and cross-content identity beyond this bounded inspector.
 
 ## Who this should serve
 

inklet-4.0.0.dev9/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.dev9}/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.dev9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "inklet"
-version = "4.0.0.dev7"
+version = "4.0.0.dev9"
 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.dev9}/src/inklet/__init__.py

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