3.0 KiB
HTML concept layout storage — version 1
Applies only to docs/design/presenter-menu.html, not the native application.
The page uses browser localStorage key pdf-presenter.menu-layouts.v1. Storage is
scoped by the browser to the page origin; file-URL handling is browser-dependent.
It is not the native global configuration or a file saved alongside a PDF.
The JSON envelope contains version: 1, global (null or a layout) and projects
(an object mapping the fixed mock project IDs ideas and workshop to layouts).
Each layout contains previous, current, next, notes, elapsed and clock.
Each widget has a boolean show and an integer size. Current is always visible.
Preview sizes are relative width weights: previous/next 30–160, current 60–200.
Notes size is a height percentage 12–65; elapsed/clock sizes are CSS pixels 16–72.
No document contents, notes, screen assignments or elapsed time are persisted.
Load precedence: project override, global default, built-in balanced layout. Edits and presets only affect the live view until explicitly saved. Project save replaces that project's entire layout. All-project save replaces the global default and preserves all project overrides. “Use all-projects default” removes the current project override and loads the global or built-in default. Changing demo projects or reloading discards unsaved edits. The existing Reset demo action reloads the page; it does not erase saved layouts.
Example (a complete all-project default without overrides):
{"version":1,"global":{"previous":{"show":true,"size":60},"current":{"show":true,"size":130},"next":{"show":true,"size":75},"notes":{"show":true,"size":28},"elapsed":{"show":true,"size":28},"clock":{"show":true,"size":28}},"projects":{}}
Reject unsupported versions, malformed envelopes, missing widgets, wrong types, non-integer/out-of-range sizes and a hidden current slide. Limit input to 20,000 JavaScript string code units. Ignore unknown fields/project IDs when normalizing. Failed reads load built-in defaults with a visible status. Failed saves/removals leave the current view and existing storage untouched; do not report success. Unsupported/corrupt records are not overwritten by save; removing this specific browser storage key allows recovery. No migration from other versions exists.
The native implementation must define real project identity and per-user settings storage separately; the mock's two project IDs are not a native compatibility contract.
Validation
tests/browser/layout-storage.js is an explicitly invoked browser regression harness.
Append it as a script before </body> in a temporary copy of the concept HTML and
open that copy in an isolated Firefox profile. It displays a PASS/FAIL report and
restores the original storage record. Covers round trips, project/global precedence,
override removal, unsaved changes, unsupported/corrupt records and failed storage.
It is not a native-application or physical-display acceptance test.