Release Notes - Version 1.0.0-20261023

Master page items now follow their page when it moves to the other side of the spine; the page bar draws its previews as soon as a document opens; a one-page document is no longer shown as half a spread; and you can choose whether the page bar sits beside the canvas or over it, as it did before 20261022.3.

New in this release

• Master page items follow their page (TYP-983). A page from an InDesign document carries the items of its master page — a folio, a running head, a background — for the side of the spine it was on. When the page moves to the other side (a page moved, deleted or added before it, facing pages turned on or off, Page 1 on the left), it now gets its master's items for the new side: the master's own left- or right-page items, at their position, since the two can differ, not just mirror. One undo puts the page back as it was. A master group you unlocked or changed stays exactly as you left it. Documents converted from now on carry their master pages; reconvert an older one to get this.
• Page bar beside or over the canvas (TYP-999). The View menu has Page Bar Over Canvas / Page Bar Beside Canvas: the open page bar either narrows the canvas, as since 20261022.3, or lies over a full-width canvas, as before. A viewer host chooses with new Viewer({ page_bar: { mode: 'narrow' | 'overlay' } }), and any host can switch it with typograph.set_page_bar_mode(); 'narrow' is the default. In the viewer the page bar is now full height while it narrows the canvas.

Fixed in this release

• Page bar previews stayed empty until the mouse moved over the canvas (TYP-982). They are now drawn as soon as the document opens.
• A one-page document showed as half a spread in the page bar when the document said facing pages (TYP-980). One page has nothing to face: it is now shown as a page of its own. The document's setting is kept, so adding a second page pairs it up as before.
• Page numbers read # after an undo or redo of a page move or delete. They now show the page's number again.
• Locked groups opened unlocked. A group locked in the editor, or a master group from an InDesign document, now stays locked when the document is opened again.
• Client data (user_data) on an element was lost on undo, on a page move and when grouping. It is now kept.

For hosts

• New: the viewer's page_bar.mode option, and typograph.set_page_bar_mode() / get_page_bar_mode() at runtime (see docs/Embedding.md). Never through a typograph.setup() call of your own beside the editor or viewer: that replaces its document. Nothing to change to keep the current behaviour.
• user_data on an element is yours: canvas never writes into it, and it now survives undo, page moves and grouping. Master page provenance is in the document schema's own master field.
• Master groups from InDesign documents open locked, as the converter always wrote them. A host that relied on them being movable in the viewer should unlock them in the document.

Typograph developers notes

• Canvas pin beb267a (from 8abb6be): canvas #209 (TYP-980, TYP-982, TYP-999, TYP-983) and #210 (a longer timeout for the TYP-994 chrome tests).
• TYP-983 is also document-schema #62 (Template::$masters, MasterReference as master on elements and spreads) and indesign-converter #80 (writes them). ⚠️ Every service that locks document-schema must be on 6332635 or later before this release: they deserialise with ALLOW_EXTRA_ATTRIBUTES=false, and an editor save now carries masters and master.
• TYP-983, canvas: document.master_spreads, saved as masters; resolve_master_sides() runs in normalize_facing_structure() and at load (src/mastersides.ts). Substitutions, the font normalisation and the structure undo cover the master spreads. Browser suite run_master_sides_tests(): 29.
• TYP-999: canvas page_bar_mode and apply_page_bar_geometry(); editor TogglePageBarMode and the Page_Bar_Over_Canvas / Page_Bar_Beside_Canvas title pair (docs/MenuAPI.md). Browser suite run_page_bar_mode_tests(): 17.
• TYP-982: PageBar.update_pages() schedules one draw (requestAnimationFrame) that redraw() cancels. Browser suite run_page_bar_previews_tests(): 6.
• TYP-980: facing_pages_in_effect(); the page bar draws by it, the add-page rule keeps the stored setting. Browser suite run_one_page_facing_tests(): 16.
• canvas-service pins the same commit; deploy it with this release, or a conversion laid out there loses masters and the groups' master.