5.2 KiB
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.