inklet 4.0.0.dev8__tar.gz → 4.0.0.dev10__tar.gz

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

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

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

@@ -2,6 +2,37 @@
 
 ## Unreleased
 
+## 4.0.0.dev10 — 2026-09-12
+
+Tenth development preview: reproducible named label and callout editing.
+3.1.0 remains the stable release.
+
+- Edit string module captions, text components, keyed plot titles/text/callouts
+  and named composition annotations in the local layout editor.
+- Expose callout text, preferred side, physical clearance and leader visibility;
+  remeasure content and dependent connections through the Python compiler.
+- Save typed label identities and changed fields in layout schema 0.3, accepting
+  legacy 0.1/0.2 files, undo/redo, independent copies and shared definitions.
+- Report removed or incompatible labels individually; explicit discard preserves
+  compatible edits on the same object. Leave unedited source decisions live.
+- Add browser controls, source revision and two-width SVG/PDF roundtrip checks,
+  installed-package coverage and an illustrated guide and example.
+
+## 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.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: inklet
-Version: 4.0.0.dev8
+Version: 4.0.0.dev10
 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.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.
+**4.0.0.dev10** adds named label and callout editing to the local layout
+editor. Edit text and callout preferences, move and scale content, undo changes,
+and save choices that reproduce through the Python compiler.
 ```sh
-python -m pip install "inklet==4.0.0.dev8"
+python -m pip install "inklet==4.0.0.dev10"
 ```
 
 [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.dev8)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev10)
 
 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.dev8 → inklet-4.0.0.dev10}/README.md

@@ -31,16 +31,16 @@ their signatures and report schemas may change.
 
 ## 4.0 development preview
 
-**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.
+**4.0.0.dev10** adds named label and callout editing to the local layout
+editor. Edit text and callout preferences, move and scale content, undo changes,
+and save choices that reproduce through the Python compiler.
 ```sh
-python -m pip install "inklet==4.0.0.dev8"
+python -m pip install "inklet==4.0.0.dev10"
 ```
 
 [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.dev8)
+[Release notes](https://github.com/Mapika/inklet/releases/tag/v4.0.0.dev10)
 
 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.dev8 → inklet-4.0.0.dev10}/docs/api.md

@@ -218,19 +218,19 @@ 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.
 * `instantiate(**items)` -- Create an independent recipe, filling required slots and replacing defaults.
 * `configure(*, width=None, height=None, unit=None, fit_top=None)` -- Atomically update authored page dimensions or coordinate units.
 * `place(name, **placement)` -- Edit a child's placement without replacing its content or named links.
-* `layout_overrides(reference)` -- Capture changed placements and page fields against a matching reference.
+* `layout_overrides(reference)` -- Capture changed layout and compatible named labels against a reference.
 * `with_layout_overrides(value, *, missing='error')` -- Return an independent edited recipe and a reconciliation report.
 * `port(name, target)` -- Expose a child's name:anchor as a reusable composition attachment point.
 * `constrain(value, *, minimum=0, message='composition needs more space')` -- Require an expression to meet a minimum; fail before drawing.
 * `link(source, target, **options)` -- Route a branch or return between named children (`name:port`).
-* `annotate(target, text, **options)` -- Place a measured callout after every child and connection exists.
+* `annotate(target, text, **options)` -- Place a measured callout; a unique name enables saved label editing.
 * `signature(trail=())`
 * `render(context, width=None, height=None)`
 

{inklet-4.0.0.dev8 → inklet-4.0.0.dev10}/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.dev8 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.dev8 → inklet-4.0.0.dev10}/docs/composition-recipes.md

@@ -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,

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

@@ -1,6 +1,6 @@
-# Inklet 4.0.0.dev8
+# Inklet 4.0.0.dev10
 
-The eighth 4.0 development release includes the linked plotting, mapping,
+The tenth 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.dev8"
+python -m pip install "inklet==4.0.0.dev10"
 ```
 
 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.dev8"
+python -m pip install "inklet[render,pandas,polars]==4.0.0.dev10"
 # Add calibrated volumes and TIFF workflows when needed:
-python -m pip install "inklet[volume,render]==4.0.0.dev8"
+python -m pip install "inklet[volume,render]==4.0.0.dev10"
 ```
 
 The core preview needs no browser server, NumPy, pandas, Polars or Blender.
@@ -29,7 +29,45 @@ 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).
 
-## Local layout inspector in dev8
+## Named labels and callouts in dev10
+
+The [local layout editor](layout-editor.md#edit-labels-and-callouts) now edits
+string module captions, text components, keyed plot titles/text/callouts and
+named composition annotations. Callouts expose preferred side, physical
+clearance and leader visibility. Text changes remeasure content and update
+dependent layout and connections through Python.
+
+Saved choices contain explicit label keys and kinds. Reordering instructions
+preserves identity; removing a key or changing its kind reports an incompatible
+label. Explicit discard retains compatible edits on the same object. Shared
+definitions share text decisions, while unedited source fields remain live.
+
+![Named callout controls and the compiled figure](assets/guides/layout-editor-labels.png)
+
+New files use layout schema 0.3; schemas 0.1 and 0.2 still load. Undo/redo,
+reopening and matching SVG/PDF export include text edits. Axis labels, individual
+callout dragging, camera editing and general object relationships remain open.
+
+## Mouse movement and scaling retained from 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)
+
+Dev9 introduced 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
@@ -44,8 +82,8 @@ 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.
+This inspector requires its local Python session. Named label editing is added
+in dev10; individual plot marks and cameras remain separate work.
 The existing standalone viewers and linked-plot appearance editor retain their
 current scope.
 
@@ -162,7 +200,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.dev8 https://github.com/Mapika/inklet.git
+git clone --branch v4.0.0.dev10 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.dev8 → inklet-4.0.0.dev10}/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.dev8 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.dev8"
+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.dev8"
+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.dev8 → inklet-4.0.0.dev10}/docs/layout-editor.md

@@ -1,11 +1,11 @@
 # Local layout editor
 
-Available in **4.0.0.dev8**, under `inklet.experimental.layout_editor`. Adjust
+Available since **4.0.0.dev8**, with mouse gestures in **4.0.0.dev9** and named label editing in **4.0.0.dev10**, 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)
+![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:
@@ -45,12 +45,82 @@ 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 labels and callouts
+
+![Editing a named plot callout with text, side, clearance and leader controls](assets/guides/layout-editor-labels.png)
+
+Select a composition child, then edit its **Label** fields and choose **Apply
+changes**. The editor supports text components created with `component(i.text,
+...)`, string module captions, and plot `title`, `text` and `annotate`
+instructions with an explicit string `key`. For composition callouts, supply a
+unique `name` and select the composition that owns the callout.
+
+```python
+recipe['chart'].annotate(1, 2, 'Reference observation', key='observation', side='s', clear=4)
+recipe.annotate('caption', 'Measured response', name='response-note', side='e', clear=3)
+editor.command('refresh')
+editor.command('edit', {
+    'path': '/chart',
+    'labels': {'observation': {'kind': 'plot-annotate', 'text': 'Reviewed observation', 'side': 'sw'}},
+})
+```
+
+Callouts expose their preferred compass side, clearance in physical millimetres,
+and leader visibility. Automatic placement can choose another side to avoid
+conflicts. Plot clearance can be left blank to use its automatic value. This
+increment edits callout content and placement preferences; it does not add free
+mouse dragging of individual callouts or axis-label editing.
+
+A label's identity is its composition path, explicit key and kind. For example,
+`/chart` plus `observation` identifies a plot annotation even when its instruction
+moves in the recipe. Replacing that key with a different instruction kind is an
+incompatible target. A removed or incompatible label is reported as
+`/chart#observation`; explicit discard drops that label's edits while retaining
+compatible placement and label edits on the same chart. Renaming a path or key
+changes its identity. Reusing the same key and kind declares the same label.
+
+Text changes are measured by the Python compiler: longer module captions can
+move dependent modules and reroute their connections. Unedited labels, data
+coordinates, styling and other source choices remain live. Shared definitions
+share label edits; use an independent recipe copy for independent captions.
+Undo/redo, reset, saved JSON and SVG/PDF exports include the label edits.
+
 ## 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.
+select **Apply changes**. Other fields retain their definitions.
 
-- Child placement fields are X, Y, anchor, width and height. Numbers use the
+- 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
@@ -91,6 +161,7 @@ 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())
@@ -100,8 +171,10 @@ 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.
+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
 
@@ -130,8 +203,8 @@ 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 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.dev8 → inklet-4.0.0.dev10}/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**, named text and callout decisions in **dev10**. 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.
@@ -21,7 +21,7 @@ Python APIs below or the [local inspector](layout-editor.md) in dev8. This forma
 
 Keep a reference recipe, copy it, then edit placements. The reference and edited
 recipe must have the same named composition structure when capturing changes.
-Content and styles can differ; they are not serialized into the layout file.
+Supported named label differences are captured too. Other content and styles are not serialized into the layout file.
 
 ```python
 import json
@@ -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.
@@ -52,6 +52,25 @@ identity within the recipe hierarchy. Renaming or moving a target changes its
 identity. Definitions hidden inside component factories or other BuildSpecs
 are not traversed.
 
+## Named label decisions
+
+Changed string module captions and text components are captured alongside layout.
+Plot titles, text and annotations require explicit string instruction keys;
+composition annotations require unique names. See the [label editor](layout-editor.md#edit-labels-and-callouts)
+for controls, identity rules and an executable example. Captures compare only
+matching label keys and kinds; they do not serialize added or removed content.
+
+A saved label entry includes its kind and only the fields that changed:
+
+```json
+{"schema":"inklet.composition-layout/0.3","targets":{"/caption":{"labels":{"label":{"kind":"module-label","text":"Reviewed response"}}}}}
+```
+
+Readers accept legacy schemas 0.1 and 0.2. New captures use 0.3; older readers
+must be upgraded before opening them. Label fields are rejected under older
+schema identifiers. Removed/incompatible labels appear as `path#key` in the
+orphan report. Explicit `missing='drop'` retains compatible edits on that path.
+
 ## Restore on the current recipe
 
 ```python
@@ -85,7 +104,7 @@ updated_figure = render(updated)
 updated_figure.save('updated.svg')
 ```
 
-The file stores layout decisions, not content, datasets, labels, plot styles,
+The file stores layout and supported label decisions, not datasets, plot styles,
 links, ports, constraints, factories or camera parameters. Keep the Python
 recipe and its assets alongside it. The containing document can supply its own
 render dimensions; restoring authored page dimensions does not override that
@@ -123,9 +142,12 @@ 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
-changed `placement` and/or `page` fields. It is a development-preview format,
+New files use `inklet.composition-layout/0.3`, adding named label decisions to
+0.2's positive uniform artwork scale. The loader also accepts 0.1 files from
+dev7/dev8 (without scale) and 0.2 files from dev9 (without labels). Unknown
+schemas are rejected. Upgrade older readers before opening a 0.3 file.
+The JSON object contains `schema` and `targets`; each target has changed
+`placement`, `page` and/or `labels` fields. This development-preview format is
 not a general Python object serializer or an asset manifest.
 
 ## Review revised content

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

@@ -58,8 +58,12 @@ Dev7 adds [saved layout overrides](layout-overrides.md) keyed by named paths,
 with measured expressions, independent restoration and explicit orphan reports.
 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
+Dev9 adds mouse movement, proportional artwork scaling and keyboard nudges
+for named composition children, with preserved measured positions and saved
+choices. Dev10 adds saved named text and callout editing across modules, text
+components, keyed plot instructions and composition annotations, including typed
+identity reconciliation. Serialized project templates, asset manifests, shared selection
+relationships, axis-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.dev8 → inklet-4.0.0.dev10}/examples/layout_editor.py

@@ -10,6 +10,7 @@ def main():
     parser.add_argument('--port',type=int,default=0,help='Local port; 0 chooses an available port')
     args=parser.parse_args()
     reports,_=make_reports()
+    reports[0]['chart'].annotate(2,3,'Reference observation',key='observation',side='s',clear=4)
     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()

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

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

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

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

{inklet-4.0.0.dev8 → inklet-4.0.0.dev10}/src/inklet/document/composition.py

@@ -12,6 +12,12 @@ from .spec import BuildSpec, ComponentSpec, fingerprint, freeze, length
 from .compiler import LayoutError
 
 
+def _scale(value):
+    if type(value) not in (int,float) or not math.isfinite(value) or value<=0:
+        raise ValueError('component scale must be a finite positive number')
+    return float(value)
+
+
 @dataclass(frozen=True)
 class _Slot(BuildSpec):
     name: str
@@ -66,6 +72,7 @@ class _Part:
     anchor: str | None = None
     width: object = None
     height: object = None
+    scale: float = 1
 
 
 @dataclass(eq=False)
@@ -76,7 +83,8 @@ class Composition(BuildSpec):
     and height describe data regions. Other children retain their authored size
     unless explicit dimensions are provided. `anchor=None` preserves the local
     coordinate frame; `nw`, `center`, registered ports and `area-nw` align a
-    measured point to (x, y). Layout never scales text or strokes.
+    measured point to (x, y). Dimension fitting never scales text or strokes. Explicit scale uniformly
+    scales the complete child artwork, including typography and strokes.
     """
     width: float
     height: float
@@ -109,11 +117,11 @@ class Composition(BuildSpec):
         """Reference a placed child's compass point or registered port."""
         return tuple(LayoutValue('point', (name, anchor, axis)) for axis in ('x', 'y'))
 
-    def add(self, name, item, *, x=0, y=0, anchor=None, width=None, height=None):
+    def add(self, name, item, *, x=0, y=0, anchor=None, width=None, height=None, scale=1):
         if not isinstance(name, str) or not re.fullmatch(r'[A-Za-z][A-Za-z0-9_-]*', name):
             raise ValueError('component names start with a letter and contain letters, digits, underscores or hyphens')
         if any(part.name == name for part in self._parts): raise LayoutError(f'duplicate component {name!r}')
-        self._parts.append(_Part(name, item, x, y, anchor, width, height))
+        self._parts.append(_Part(name, item, x, y, anchor, width, height, _scale(scale)))
         return item
 
     def __getitem__(self, name):
@@ -171,12 +179,13 @@ class Composition(BuildSpec):
     def place(self, name, **placement):
         """Edit a child's placement without replacing its content or named links.
 
-        Accepts x, y, anchor, width and height as in add(). Expressions and
+        Accepts x, y, anchor, width, height and uniform scale as in add(). Expressions and
         resulting geometry are validated during compilation.
         """
         from dataclasses import replace
-        unknown = placement.keys() - {'x','y','anchor','width','height'}
+        unknown = placement.keys() - {'x','y','anchor','width','height','scale'}
         if unknown: raise TypeError(f'unknown placement options: {", ".join(sorted(unknown))}')
+        if 'scale' in placement: placement['scale'] = _scale(placement['scale'])
         for index,part in enumerate(self._parts):
             if part.name == name:
                 self._parts[index] = replace(part, **freeze(placement))
@@ -184,10 +193,10 @@ class Composition(BuildSpec):
         raise KeyError(name)
 
     def layout_overrides(self, reference):
-        """Capture changed placements and page fields against a matching reference.
+        """Capture changed layout and compatible named labels against a reference.
 
         Return JSON-compatible, versioned decisions keyed by named child paths.
-        Content, styles, data, links and constraints remain in the Python recipe.
+        Other content, styles, data, links and constraints remain in Python.
         """
         from .layout_overrides import capture
         return capture(self, reference)
@@ -225,7 +234,12 @@ class Composition(BuildSpec):
         return self
 
     def annotate(self, target, text, **options):
-        """Place a measured callout after every child and connection exists."""
+        """Place a measured callout; a unique name enables saved label editing."""
+        name = options.get('name')
+        if name is not None:
+            if not isinstance(name,str) or not name: raise ValueError('annotation name must be a nonempty string')
+            if any(opts.get('name')==name for _,_,opts in self._annotations):
+                raise LayoutError(f'duplicate annotation name {name!r}')
         self._annotations.append((target, text, freeze(options)))
         return self
 
@@ -282,7 +296,15 @@ class Composition(BuildSpec):
                         item = ComponentSpec(item.factory, evaluate(item.args), evaluate(item.kwargs), item.responsive)
                     w = None if part.width is None else length(evaluate(part.width), 'child width')*self.unit
                     h = None if part.height is None else length(evaluate(part.height), 'child height')*self.unit
-                    return context.build(item, w, h).copy()
+                    node = context.build(item, w, h).copy()
+                    factor = _scale(part.scale)
+                    if factor != 1:
+                        scaled = node.scaled(factor)
+                        # Keep registered ports directly available to measured
+                        # placement; their coordinates precede the new scale.
+                        for key in node.anchors: scaled.anchors[key] = placed_anchor(node,key)
+                        node = scaled
+                    return node
                 built[name] = guarded('measure', name, perform)
             return built[name]