beffroi-tools/docs/interfaces/midra-layout-persistence-au...

5.2 KiB
Raw Blame History

Midra Layout persistence audit

Audited against the editor, project loader, application settings, capture controls, layer tree, format properties, import/export controls and device transfer state. Implemented with project version 12. This is an ownership audit: not every control should become document data.

Parameters Owner and decision
Output resolution / aspect Project: exact width/height. The output aspect preset is derived from them, not stored twice.
Layer position, dimensions, stacking order Project: full-precision bounds and array order; display/export rounding never changes the saved values.
Input format, native dimensions, custom input crop, shared input slot Project: inputs and layer source_id, already saved.
Layer format, dynamic crop, zoom and offset Project: final bounds and advanced crop, already saved. Zoom/offset/aspect are derived from these authoritative values.
Names, stable IDs, next ID, folder membership, visibility, lock, pivot Project, already saved. Folder visibility/locking acts on members, so there is no separate state to save. Explicit folder names are saved separately in project v12 and may have no members.
Device screen/layer mapping Project, already saved per layer. Physical source routing is separate and is not silently changed by a geometry send.
Reference images, order, visibility, opacity, fit/native sizing, offset Project, already embedded. Focused reference row is temporary.
Selected layers, viewport zoom/pan, positioning origins Project, already saved. Selection is validated against visible/unlocked IDs.
Backdrop title, source guide pattern, outline mode, aspect-ratio lock, icon captions Project, already saved. Pattern/ratio lock/captions also have application defaults.
Magnet, pixel/edge snapping, overlay visibility/divisions, overlay snapping Added to project. Application settings remain the defaults for a new workspace; opening a project restores its setup.
10/100-pixel tool grid, group resize mode Added to project. They determine editing behavior and now follow the saved workspace rather than the previously opened document.
Collapsed folder rows Added to project. Keeps larger memory collections manageable; stale folder names are filtered out.
Preview input, device-address binding, editor-source binding, enable flag Added to project per stable layer ID. Preselected-but-not-yet-captured inputs are saved too.
Last captured still, guide opacity Added to project. Original image bytes are embedded for offline reuse, subject to the shared 64 MiB image budget.
Auto-refresh choice, refresh interval, show no-signal inputs Added to project. Auto-refresh restores paused; no fetch or connection is initiated by loading. Resume/capture is explicit.
Theme/recent themes, connection address/history, startup connection, allow Program Application settings only. These belong to the workstation/operator; opening a document must not switch connections or global permissions. Capture host strings are bindings, not connection instructions.
All/selected/folder transfer scope, target bank, export sizing strategy Session choices. Links and folders are persistent; the current transfer action and destination bank are not document content. Existing behavior is retained.
Advanced shared-device input edit checkbox and staged edits Session-only by design. These are pending changes to external shared input settings; only explicit edits are sent. Local source/crop geometry is saved separately.
Import mapping, size/position/zoom toggles, ignored items/pages Temporary import review. Applied results are saved; unfinished operations and their external payloads are not.
Geometry export codec, selection scope, background/placeholders options Temporary export choices. No destination files are reopened or overwritten by project loading.
Alignment reference, prepared numeric ratio, active navigation/pivot/grid gesture, crop-edit mode, open tab/menu/dialog Temporary editing context. No partial interaction is replayed; the resize mode and grid spacing themselves are saved as above.
Undo/redo, text drafts, drag snapshots, selection marquee, errors/progress, cached device capabilities, network jobs/timers Transient runtime state. Loading starts a fresh document history and discards late capture results.
Named project path and last manual-save time Recovery envelope only, not the portable project. Recovery uses the same project representation and image validation.

The application settings contract is unchanged (v8). The recovery envelope is unchanged (v1); its nested project migrates to v12. Geometry export representations are unchanged and omit capture images/settings; optional fixed-reference backgrounds retain their existing behavior.

Regression coverage includes current-schema round trips, versions 1–11 migration, invalid assignments/settings and unknown/missing fields, embedded-still decoding, atomic failure on malformed images, cleared stale previews, restore-without-fetch, manual resumption eligibility and saved resize setup. The guide and example JSON are updated with the schema.