@a3s-lab/office 0.2.2 → 0.4.0

package/docs/latest/en/browser-editor-architecture.md

@@ -32,6 +32,115 @@ model:
    from host-page controls while its own shortcuts remain deterministic.
    Successful object and grid commands restore focus to the latest controlled
    selection before the next keystroke.
+   Writer keeps tab, group, label, and shortcut metadata in one internal
+   command catalog. Undo and redo live in a keyboard-described quick-access
+   toolbar. The ribbon measures its own toolbar instead of the browser viewport
+   and compacts low-priority, then normal-priority groups before exposing group
+   paging. It can remain collapsed; activating a tab temporarily overlays that
+   tab's commands without moving the document, and an outside pointer action
+   returns to the compact row. Writer routes its catalogued WPS font-size,
+   alignment, line-spacing, heading, spelling, field-refresh, comment, and
+   track-changes shortcuts only while the document surface owns the event. The
+   status route uses the same catalog for WPS word count, opening live page,
+   word, character, and paragraph details from either `Ctrl+Shift+G` or the
+   visible count. Its local formatting clipboard powers WPS copy-format and
+   paste-format shortcuts
+   plus a one-shot format painter without requiring browser clipboard access;
+   paste replaces only direct character and paragraph formatting, preserving
+   links, comments, and revision semantics in one document transaction.
+   Header and footer TipTap surfaces register the same WPS alignment and
+   copy-format shortcuts. Cross-surface paste retains compatible marks and
+   paragraph attributes while falling back from unsupported heading nodes.
+   Writer orders Insert commands as Pages, Table, Illustrations, Links, Header
+   and Footer, and Text. The Links group creates paired body-bookmark
+   boundaries around a selection or caret, keeps copy identity separate, and
+   represents internal destinations as `#name` marks with an explicit
+   missing-target class. The References target picker also exposes those body
+   bookmarks alongside captions; bookmark cross-reference atoms retain target
+   identity, source instruction, live display text, and a missing-target state.
+   DOCX import/export maps the boundaries to native
+   `w:bookmarkStart`/`w:bookmarkEnd` ranges, bookmark cross-references to `REF`
+   fields, and internal links to `w:anchor` rather than relationship-backed
+   external hyperlinks. Footnote and endnote reference atoms share a
+   transaction-normalized graph with their editable definitions. References
+   retain identity through moves, copied references clone definition content
+   under a new identity, deletions remove the complete pair, and one appended
+   transaction keeps undo and redo atomic. Each note kind numbers independently
+   in reference order; new or reconstructed footnote definitions use the
+   reference section and newly inserted endnotes use the final section. The
+   structured HTML parser
+   gives note markers precedence over generic superscript so native DOCX notes
+   survive repeated import and export. The Insert Text group creates atomic
+   `PAGE`, `NUMPAGES`, `SECTION`,
+   `SECTIONPAGES`, `DATE`, and `TIME` fields. A position resolver maps every
+   field to its measured Worker/WASM layout block, physical page descriptor,
+   owning section, and the set of physical pages occupied by that section, so
+   continuous sections sharing one page retain truthful section-page counts.
+   Pagination-driven numeric refreshes do not add undo history and deliberately
+   leave clock fields unchanged; the scoped F9 command refreshes date and time
+   too, as one history action. A transaction-mapped identity plugin lets moved
+   fields keep their IDs while copied atoms receive fresh, redo-stable IDs.
+   DOCX import atomizes only complete, non-nested inline `w:fldSimple` or
+   complex fields. Nested, incomplete, cross-paragraph, deleted, and
+   instructionless structures keep their rendered result as text and emit a
+   structural compatibility warning instead of being flattened into a false
+   editable field. Native export writes live simple fields and requests a Word
+   field update on open. Page Layout keeps direct margin, orientation, paper,
+   and equal-column presets in the ribbon; custom margins and advanced columns
+   open the corresponding controlled Page Setup tab instead of duplicating a
+   second settings model. References separates footnotes, captions, citations
+   and bibliography, and field updates; Review derives previous, next, accept,
+   and reject availability from the live revision ranges and moves the
+   selection to the next resolvable change. View keeps document modes before
+   display controls and calculates One Page and Page Width zoom from the live
+   page metrics and scroll viewport. Picture, Table, and Header and Footer tabs
+   carry explicit contextual semantics and disappear with their selection. The
+   Spreadsheet shell now uses the same responsive ribbon contract with its own
+   command catalog and workbook semantics. It keeps the WPS tab order, places
+   Conditional Formatting under Home and Styles, exposes real sorting under
+   Data, and owns F9 workbook recalculation in the root-scoped keyboard
+   controller. Paste, Cut, and Copy live in the first Home group; both button
+   clicks and WPS shortcuts cross one clipboard command port before using the
+   permission-resilient browser/local clipboard implementation. Format Painter
+   uses a dedicated format-pattern model and React session hook behind another
+   typed command port. It captures owned native style attributes only, expands
+   or tiles the pattern across same-sheet or cross-sheet targets, guards both
+   sides at 50,000 cells, suppresses repeated engine callbacks for the same
+   target, and emits one `batchCallApis` update per application. One-shot and
+   double-click locked state therefore stay outside the ribbon, while the
+   ribbon exposes pressed status and Escape cancellation without copying cell
+   values or workbook structure. AutoFilter follows the same boundary: a pure
+   workbook model derives a finite current region or accepts an explicit
+   multi-row range, a React hook owns controlled enable/disable state, and a
+   typed command port connects the Data ribbon plus `Cmd/Ctrl+Shift+L` and
+   `Alt+ArrowDown`. The Fortune adapter only exposes the header trigger and
+   value menu, adding dialog, checkbox, focus-restoration, and keyboard
+   semantics without making vendor DOM text the command contract. Freeze Panes
+   also stays controlled: a pure model translates the current WPS cell into
+   rows above and columns left or applies top-row and first-column presets, a
+   typed View command performs one immutable workbook update, and the native
+   Fortune/XLSX frozen-pane model remains the render and serialization
+   boundary. Its menu owns Arrow, Home, End, Enter, Escape, pressed state, and
+   focus restoration without introducing a parallel vendor toolbar. Home and
+   Cells now exposes the existing typed structure commands through one Rows and
+   Columns menu: insert and delete availability comes from the live selection,
+   execution stays in the workbook command port, and successful actions return
+   focus to the grid instead of introducing ribbon-local mutations. Home and
+   Alignment owns cell merging through a split control whose primary action and
+   `Ctrl+M` execute Merge and Center. Merge Cells, Merge Across, Unmerge Cells,
+   and Unmerge and Fill use the same typed command path, derive availability
+   from the selection and native Fortune merge ranges, and emit one
+   `batchCallApis` transaction per user intent. Home and Editing owns one Clear
+   disclosure for All, Formats, Contents, Comments, and Hyperlinks. Delete and
+   Backspace share the Contents command; all five modes transform the live
+   sheet immutably, retain merge geometry, preserve cell state outside the
+   selected mode, and emit one controlled workbook batch. The
+   catalog is the source of truth for labels, locations, and shortcut metadata;
+   typed command ports remain the source of truth for execution and
+   availability. The labelled status surface provides arrow-key traversal
+   across view and zoom
+   controls; compact Web widths remove secondary section, proofing, citation,
+   and save items in stages while retaining physical-page and zoom feedback.
 2. Each editor owns its selection model and exposes typed commands to the
    shell. A command never searches rendered text or infers intent from labels.
 3. Interactive editing stays on the main thread. Presentation keeps object
@@ -66,7 +175,7 @@ localized labels and viewport heuristics never decide behavior.
 | Task pane | Find and replace, page setup, citation sources, and revision review | Mutually exclusive at the right edge of the document workspace. It shares width with the page above 900 px, overlays the page below 900 px, and becomes workspace-wide below 520 px. Escape and the visible close action follow the same guarded close path. |
 | Review rail | Anchored comments and comment drafts | Sits beside the paper and connects each thread to its text range. Below 620 px it becomes a bounded review drawer, removes connector lines, and lays cards in document order instead of using absolute placement. |
 | Anchored popover | Table size, paragraph spacing, paragraph pagination, colors, and select options | Portaled to the body but positioned from the invoking control. It flips vertically, clamps to a 16 px viewport margin, updates on nested scroll and resize, focuses its first field when it behaves like a small dialog, and returns focus to the trigger on Escape. A dirty numeric field consumes the first Escape to discard only its local draft; a clean field lets the next Escape close the surface without a blur commit. |
-| Modal dialog | Captions, cross-references, links, image descriptions, notices, and confirmations | Centered in the viewport with bounded height and an independently scrolling body. The body-level portal makes every non-dialog body child inert. Focus stays inside, destructive confirmations initially focus the safe action, and closing returns to the actual invoker unless the completed command deliberately restores the editor. |
+| Modal dialog | Bookmarks, captions, cross-references, links, image descriptions, notices, and confirmations | Centered in the viewport with bounded height and an independently scrolling body. The body-level portal makes every non-dialog body child inert. Focus stays inside, destructive confirmations initially focus the safe action, and closing returns to the actual invoker unless the completed command deliberately restores the editor. |
 
 Task panes preserve editing context instead of behaving like navigation.
 Closing a pane returns focus to the body editor. Switching away from a dirty
@@ -157,9 +266,9 @@ focus restoration.
 
 | Product | Implemented browser surface | Implemented kernel boundary | Next fidelity gate |
 | --- | --- | --- | --- |
-| Document | One TipTap/ProseMirror body tree retained across editing and read-only preview, controlled TipTap header/footer surfaces with direct paper-margin editing and a contextual ribbon, one typography and page-chrome baseline across editing, preview, and PDF surfaces, a persistent typed heading-navigation pane with active-selection tracking, filtering and collapsible keyboard traversal, host-owned selected-text menus with full document context and range-mapped async commands, responsive and keyboard-operated paragraph-style and list galleries, typed bullet and numbering commands with restart/continue/start controls, typed physical-page and section-page descriptors, repeated first/default/even page chrome, a versioned structured model with an HTML compatibility representation, prefix-reused visual-line measurement and pages, page decorations, page-aware horizontal and vertical rulers for page margins, paragraph indents and typed tab stops, structured list-item pagination, explicit paragraph and list-item direction, compact spacing and pagination controls, typed inline/square/top-and-bottom image layout, imported style-inherited paragraph properties, structured inline tabs, and theme-aware run font/size/color/background import | Worker plus resumable Rust/WASM flow pagination and Rustybuzz shaping across CSS-matched registered text runs; the same live result remains mounted in read-only preview and is consumed by bounded browser PDF capture, including eligible list paragraphs, Unicode bidi level segmentation, ordered per-grapheme font fallback, packaged Latin/CJK/Arabic/Hebrew faces, and structured left-to-right tabs, with explicit DOM and JavaScript fallbacks for text affected by supported floats | Language-complete font substitution, complete Word style and numbering coverage, locale-complete and bidirectional tabs, arbitrary floating-object offsets and layering, complex table flow, searchable/vector PDF output, and loss-preserving OOXML package state |
+| Document | One TipTap/ProseMirror body tree retained across editing and read-only preview, controlled TipTap header/footer surfaces with direct paper-margin editing and a contextual ribbon, one typography and page-chrome baseline across editing, preview, and PDF surfaces, a persistent typed heading-navigation pane with active-selection tracking, filtering and collapsible keyboard traversal, host-owned selected-text menus with full document context and range-mapped async commands, responsive and keyboard-operated paragraph-style and list galleries, typed bullet and numbering commands with restart/continue/start controls, typed physical-page and section-page descriptors, repeated first/default/even page chrome, a versioned structured model with an HTML compatibility representation, prefix-reused visual-line measurement and pages, page decorations, page-aware horizontal and vertical rulers for page margins, paragraph indents and typed tab stops, structured list-item pagination, explicit paragraph and list-item direction, compact spacing and pagination controls, typed inline/square/tight/through/top-and-bottom/no-wrap image layout and floating-image drawing layers, imported style-inherited paragraph properties, structured inline tabs, and theme-aware run font/size/color/background import | Worker plus resumable Rust/WASM flow pagination and Rustybuzz shaping across CSS-matched registered text runs; the same live result remains mounted in read-only preview and is consumed by bounded browser PDF capture, including eligible list paragraphs, Unicode bidi level segmentation, ordered per-grapheme font fallback, packaged Latin/CJK/Arabic/Hebrew faces, and structured left-to-right tabs, with explicit DOM and JavaScript fallbacks for text affected by supported floats | Language-complete font substitution, complete Word style and numbering coverage, locale-complete and bidirectional tabs, arbitrary floating-object geometry and non-image drawing layers, complex table flow, searchable/vector PDF output, and loss-preserving OOXML package state |
 | Markdown | TipTap visual editing with a resizable source-and-preview split view by default, source-aware ribbon formatting and shortcuts, bounded source-native history with coalesced typing and selection restoration, host-defined selection menus across both editing surfaces, GFM tables, strikethrough, autolinks and nested task lists, controlled source state, coalesced preview rebuilds, proportional pane scrolling, keyboard-adjustable pane sizing, a flat measure-bounded reading surface, optional visual or source-only views, and a full-workspace Source/Preview switch on phones | No kernel required for normal editing | CommonMark differential fixtures, multi-megabyte profiling, and an off-main-thread parser boundary when measurements justify it |
-| Spreadsheet | Fortune Sheet grid integrated with the shared Office shell, shared grid/formula/footer visual tokens and one spreadsheet accent across selection, sheet tabs, menus, and zoom, an A3S-owned accessible single-row workbook footer for creation, activation, rename, duplicate, color, hide, reorder, delete, selection status, and zoom, a resize-observed worksheet viewport that keeps the active tab and its touch action visible across desktop, compact, and phone-width changes, one cell/worksheet context-menu surface whose displayed accelerators remain executable while the menu owns focus, Arrow/Home/End tab navigation plus Shift+F10 and native context-menu access, typed editing and calculation command ports, A3S-owned deterministic Arrow, Enter, Tab, Home, PageUp/PageDown, extended-selection, row, column, and all-cells keyboard commands, selection-preserving focus restoration across controlled workbook remounts and F2/Escape editing transitions, Cmd/Ctrl formatting, undo/redo, clear, a permission-resilient editor-local clipboard fallback, Shift+F11 sheet creation, and Ctrl/Cmd+PageUp/PageDown sheet-navigation shortcuts, direct font-family, horizontal/vertical-alignment, text-wrap, general/number/percent, and decimal-place controls backed by native cell-style keys, live count/sum/average selection summaries, operation-driven sparse-workbook projection, guarded controlled-value remounts that reject stale engine callbacks, and no-history result patches with cell-scoped Fortune fallback | Versioned, cancellable Worker/Rust-WASM calculation sessions using the shared bounded Rust formula parser, retained formula ASTs, incremental forward/reverse dependency graphs, dirty-subgraph recalculation, cross-sheet references, and a dynamically loaded JavaScript fallback | A3S-owned virtual grid, moving replacement projection off the main thread, broader Excel formula semantics, A3S-owned custom number-format evaluation, and print layout |
+| Spreadsheet | Fortune Sheet grid integrated with the shared Office shell, a WPS-oriented command catalog and tab order, quick-access Undo and Redo, a priority-aware adaptive and collapsible ribbon with temporary tab expansion, Home and Styles Conditional Formatting, Home and Cells row/column insertion and deletion through the shared typed structure commands, Home and Alignment Merge and Center plus Merge Cells, Merge Across, Unmerge Cells, and Unmerge and Fill through one native-model-backed controlled batch per intent and the WPS `Ctrl+M` shortcut, Home and Editing Clear All, Formats, Contents, Comments, and Hyperlinks with Delete/Backspace mapped to content-only clearing and merge geometry retained, Data sorting and AutoFilter with bounded current-region discovery, controlled filter state, WPS toggle and header-menu shortcuts, and accessible vendor menu semantics, View and Window Freeze Panes with WPS current-cell, top-row, first-column, and unfreeze patterns backed by controlled state and native XLSX frozen panes, Formulas and F9 workbook recalculation, an executable Home clipboard group with permission-resilient Paste, Cut, and Copy plus a WPS-style one-shot and locked Format Painter for bounded cross-sheet native-style patterns, shared grid/formula/footer visual tokens and one spreadsheet accent across selection, sheet tabs, menus, and zoom, an A3S-owned accessible single-row workbook footer for creation, activation, rename, duplicate, color, hide, reorder, delete, selection status, and zoom, a resize-observed worksheet viewport that keeps the active tab and its touch action visible across desktop, compact, and phone-width changes, one cell/worksheet context-menu surface whose displayed accelerators remain executable while the menu owns focus, Arrow/Home/End tab navigation plus Shift+F10 and native context-menu access, typed editing and calculation command ports, A3S-owned deterministic Arrow, Enter, Tab, Home, PageUp/PageDown, extended-selection, row, column, and all-cells keyboard commands, selection-preserving focus restoration across controlled workbook remounts and F2/Escape editing transitions, Cmd/Ctrl formatting, undo/redo, clear, a permission-resilient editor-local clipboard fallback, Shift+F11 sheet creation, and Ctrl/Cmd+PageUp/PageDown sheet-navigation shortcuts, direct font-family, horizontal/vertical-alignment, text-wrap, general/number/percent, and decimal-place controls backed by native cell-style keys, live count/sum/average selection summaries, operation-driven sparse-workbook projection, guarded controlled-value remounts that reject stale engine callbacks, and no-history result patches with cell-scoped Fortune fallback | Versioned, cancellable Worker/Rust-WASM calculation sessions using the shared bounded Rust formula parser, retained formula ASTs, incremental forward/reverse dependency graphs, dirty-subgraph recalculation, cross-sheet references, and a dynamically loaded JavaScript fallback | A3S-owned virtual grid, moving replacement projection off the main thread, broader Excel formula semantics, A3S-owned custom number-format evaluation, and print layout |
 | Presentation | Scene canvas with ordered typed multi-selection, persistent nested browser groups, native PPTX group-node export, exact keyboard-accessible table-dimension insertion, native slide/object context actions with optional AI actions, a separate object/content editing state, one on-demand TipTap instance, collective move/scale/nudge/clipboard/delete/layer commands, selection-bound alignment and distribution, typed group/ungroup commands, one typed dispatcher for ribbon commands, editor-scoped shortcuts with post-command selection focus, direct beginning/current-slide playback with fullscreen fallback, frame-coalesced transactional move/resize previews that commit once on pointer release, two-level thumbnail node and scene windowing, and a phone stage that top-aligns the primary canvas while retaining one readable slide indicator beside view and zoom controls | Revisioned, cancellable Worker/Rust-WASM slide-relative alignment and object-set snapping with typed visual guides and a JavaScript fallback | Arbitrary rotated or reflected PPTX group transforms, connectors, theme resolution, text fitting, kernel-owned thumbnail layout, and slide serialization |
 | PDF | PDFium-backed page rendering with an A3S-owned responsive toolbar, a scrollable page-thumbnail rail with active-page synchronization and bounded bitmap/DOM windowing, a focus-contained phone page drawer, and typed capability controllers for navigation, zoom, search, basic annotations, annotation color, opacity, compatible stroke-width defaults and selection updates, history, and save; page and search drafts cancel without accidental commands, shortcuts remain scoped to the PDF root, and compact widths retain page status while exposing search-result traversal, navigation, zoom, and history through the keyboard-operated overflow menu | PDFium WebAssembly | Forms, redaction review, page organization, and reopen fixtures |
 
@@ -191,12 +300,13 @@ mode changes editability, accessible role, command chrome, and contextual
 interactions without replacing the ProseMirror DOM or clearing its measured
 blocks, shaped runs, page descriptors, and automatic-break decorations. Page
 headers and footers are visual overlays inside the configured top and bottom
-margins. Kernel protocol 15 therefore computes body height from page height
+margins. Kernel protocol 16 therefore computes body height from page height
 minus physical margins only; page-chrome heights position repeated overlays
 and do not subtract the same space again. Browser PDF export locates the ready
 surface through the host's stable artifact ID, clones its ProseMirror DOM once,
 removes editing-only state, and crops exact physical pages from bounded capture
-batches. Explicit descriptor pages remain a fallback for surfaces without a
+batches when their geometry is uniform or from exact per-page viewports when
+it differs. Explicit descriptor pages remain a fallback for surfaces without a
 registered live document.
 
 The Word navigation pane uses that same capture boundary for real physical-page
@@ -396,20 +506,48 @@ Document image nodes carry typed layout, alignment, wrap-distance, alternative
 text, size, and per-image aspect-ratio-lock attributes. The contextual Picture
 ribbon keeps fast layout actions and opens one responsive Picture Properties
 dialog for centimeter width and height, aspect-ratio locking, wrapping,
-alignment, text distance, and alternative text. Applying the complete draft
+alignment, text distance, signed horizontal and vertical offsets, their column,
+paragraph, margin, or page reference frames, four-edge percentage cropping,
+relative drawing order, behind-text placement, overlap and cell-layout policy,
+anchor locking, and alternative text. Applying the complete draft
 updates only changed attributes in one separated TipTap history entry; cancel
 and Escape preserve the node and return focus to the exact invoker. Dimensions
 that were only projected into rounded centimeter fields retain their exact
 imported pixel values when untouched. Inline images stay in normal flow;
-supported left- or right-aligned square images use browser floats, and
-top-and-bottom images clear surrounding text. Paragraphs following a square
-float remain on the DOM visual-line path because the available line width
-changes while the float is active. The paginator reserves and observes the
-image block height, then sends the measured text fragments to the same
-Worker/Rust-WASM page-layout protocol. Supported square and top-and-bottom
-metadata round-trips through DOCX `wp:anchor`. Arbitrary offsets, crop geometry,
-contour wrapping, z-order, and drawing-layer relationships are not represented
-yet.
+supported left- or right-aligned square images use browser floats, tight and
+through images additionally project their DrawingML polygon through CSS
+`shape-outside`, top-and-bottom images clear surrounding text, and no-wrap
+images use absolute placement so body text does not reserve their rendered
+height. A one-pixel pagination anchor keeps each free-floating image attached to
+its document position, while `behindDoc` determines whether it paints behind or
+in front of text. Paragraphs
+following any supported side-wrapped float remain on the DOM visual-line path
+because the available line width changes while the float is active. The
+paginator reserves and observes the rendered height of flow-affecting images,
+uses only the anchor height for no-wrap images, then sends the measured text
+fragments to the same Worker/Rust-WASM page-layout protocol. Square,
+tight, through, top-and-bottom, and no-wrap metadata round-trips through DOCX
+`wp:anchor`; tight and through anchors preserve their wrap side, edited flag,
+and ordered `wrapPolygon` vertices. Aligned anchors remain aligned,
+while precise offsets preserve `positionH` and `positionV` reference frames
+through edit, preview, and regenerated DOCX. Four-edge crop geometry remains
+typed in the controlled model and round-trips as DrawingML `a:srcRect` for
+inline and floating pictures. Supported floating pictures also preserve
+drawing-layer relationships through unsigned `relativeHeight`,
+`behindDoc`, `allowOverlap`, `layoutInCell`, and `locked` anchor attributes.
+The browser maps the unsigned drawing order into bounded foreground and
+behind-text stacking ranges while retaining the exact OOXML value for export.
+Each image node also owns one normalized eight-hex-digit object identity plus
+its DOCX drawing-property, anchor, and edit identifiers. A ProseMirror
+transaction normalizer gives a pasted copy a fresh complete identity while a
+move, cut-and-paste, deletion followed by undo, and redo retain the surviving
+object's identity. Existing nodes and newly inserted images are normalized at
+the editor boundary, and duplicates prioritize the mapped pre-transaction
+object even when a copy is inserted before it. DOCX import retains
+`wp:docPr@id`, `wp14:anchorId`, and a conforming `wp14:editId`. Export keeps the
+drawing-property and anchor identity stable independently of regenerated media
+relationship IDs, retains an untouched edit identifier, and advances the edit
+identifier when the image itself is changed or moved.
 
 The page-layout panel mounts two bounded TipTap surfaces for the active
 header/footer variant. Pagination joins each kernel page placement to typed
@@ -534,10 +672,10 @@ font metric; imported tables no longer receive editor-only block margins. The
 Windows parity workflow exports the same fixture through WPS, captures both
 794 by 1123 CSS-pixel pages, and rejects page-size, landmark, or bounded pixel
 differences. Language-complete font substitution, variable font axes, the
-remaining character and table style properties, arbitrary floating-object
-offsets, cropping, contour wrapping and layering, row-internal table splitting
-inside a single long paragraph or complex merged-cell flow, nested tables,
-footnote balancing, multi-column flow, and mixed-size sections require the
+remaining character and table style properties, non-image floating-object
+layering, row-internal table splitting
+inside a single long paragraph, footnote balancing, multi-column flow, and
+mixed-size sections require the
 later layout stages below.
 
 Top-level tables now enter pagination as row flows. DOM measurement supplies
@@ -552,8 +690,11 @@ page, split at synchronized boundaries between direct cell blocks. One
 non-editable widget per cell aligns the page gap and paints a clipped slice of
 the same measured header overlay. The leading cell alone extends the paper-gap
 paint across the page margins. `cantSplit` rows and a single indivisible long
-paragraph remain atomic and may overflow; nested tables and complex merged-cell
-flows require a later fragmentation model.
+paragraph remain atomic and may overflow. Nested tables contribute their own
+row boundaries to the containing cell's synchronized fragment plan. A
+`rowspan` cell is projected through every covered physical row with clipped,
+contiguous document ranges; page breaks before continuation rows render inside
+the spanning cell instead of inserting a conflicting synthetic table row.
 
 Table creation is selection-safe: a non-empty text selection is preserved and
 the chosen table is inserted after its containing block instead of replacing
@@ -563,7 +704,8 @@ Design owns keyboard-operated style presets, the header row, multi-cell
 shading, and a reusable border pen with whole-selection, outside, inside, side,
 inside-horizontal, and inside-vertical targets. Layout owns row and column
 insertion or deletion, cell merge and split, horizontal and vertical alignment, repeated headers,
-atomic rows, centimeter-based column width and row height fields, equal row and
+atomic rows, percentage- or centimeter-based column width and centimeter-based
+row height fields, equal row and
 column distribution, content/window autofit, table alignment, four-edge cell
 margins, and table deletion. Physical
 column widths remain coherent across merged cells through ProseMirror's table
@@ -586,7 +728,9 @@ areas.
 DOCX tables independently round-trip `tblGrid`, `tcW`, `tblLayout`, `tblW`,
 `jc`, `tblInd`, `tblCellMar`, `tcMar`, and `trHeight`; numeric fiftieth-percent
 and string percentage widths keep their actual size instead of collapsing to a
-full-width table. Window/content autofit remains responsive in the browser.
+full-width table. Per-column percentage preferences are editable and export as
+`tcW`, including merged cells, while `tblGrid` pixels remain browser layout
+fallbacks. Window/content autofit remains responsive in the browser.
 Independent top, right, bottom, and left cell-border attributes
 render identically in edit and preview, export as independent `w:tcBorders`,
 and reopen without being flattened. Explicit table-level outer and inside
@@ -601,17 +745,19 @@ order. Their cell fills, per-edge borders, run emphasis, fonts, and colors, plus
 paragraph alignment, direction, indents, spacing and line rules, pagination
 rules, and tab stops enter the marker pipeline after paragraph styles and before
 direct paragraph, character-style, or run formatting. Direct table and cell
-properties remain higher-priority layers for cell presentation. Theme-derived
-conditional presentation is materialized as stable RGB for editing, preview,
-and regenerated DOCX output.
+properties remain higher-priority layers for cell presentation. Nested tables
+retain independent geometry and formatting through the same marker and export
+paths, and target the innermost active table during editing. Theme-derived
+presentation resolves to stable RGB for editing and preview, while untouched
+run colors, run shading, cell fills, and per-edge borders retain semantic theme
+references on regenerated DOCX output. Explicit color edits export direct RGB.
 The real styled-table fixture exercises a centered 62.5% table, table margins,
 a first-cell margin override, and matching edit/preview geometry through A3S
 Test.
 Command availability comes from the ProseMirror table state, so actions that
-cannot apply to the current selection remain disabled. Loss-preserving semantic
-theme references, less-common conditional paragraph properties outside the
-supported layout set, percentage-width column authoring, nested-table editing,
-and complex merged-cell conditional flow remain explicit fidelity gaps.
+cannot apply to the current selection remain disabled. Less-common conditional
+paragraph properties outside the supported layout set remain explicit fidelity
+gaps.
 
 Paragraph tab stops are typed node attributes with normalized positions,
 left/center/right/decimal alignment, and leader styles. A leaf
@@ -698,6 +844,14 @@ text validation, UTF-16 offset mapping, shaping, and their tests live in
 focused modules. This keeps the fallback and WASM paths independently
 testable without duplicating their public protocol.
 
+Layout requests carry a bounded, deduplicated page-style table and let each
+measured block reference its section geometry. A geometry transition opens a
+new physical page in both the JavaScript fallback and Rust/WASM kernel, and
+each result page owns its exact metrics. The live page stack, navigation
+thumbnail capture, and PDF capture all consume those result metrics, including
+mixed custom sizes and orientations, instead of projecting the active
+section's dimensions across the document.
+
 The npm package emits `office-kernel.worker.js`, `office-kernel.wasm`, and
 default Noto Sans, Noto Sans Hans, Noto Naskh Arabic, and Noto Sans Hebrew
 regular faces beside the public JavaScript entries. Hosts may override the
@@ -736,15 +890,76 @@ controlled value. Document-level page color remains outside the ProseMirror
 tree, is updated through the same controlled value, and is preserved by DOCX
 import/export and the browser PDF render surface.
 
-This is a transitional persistence boundary, not loss-preserving OOXML yet.
-DOCX still converts through Mammoth, but DOCX, HTML, and text imports create the
-structured model immediately through the same extension schema used by the
-editor. DOCX export materializes synchronized HTML from the structured model
-before OOXML generation, so a stale HTML cache cannot override model changes.
-Preview retains the mounted structured editor tree, and live browser PDF export
-captures that same paginated surface; compatibility HTML remains an
-import/export boundary. Unsupported OOXML package parts are not yet represented
-by the model.
+`encodeDocumentSnapshot` and `decodeDocumentSnapshot` expose that complete
+controlled value through the public Core entry point. The v1
+`a3s.office.document.snapshot` envelope is deterministic bounded JSON and uses
+the
+`application/vnd.a3s.office.document-snapshot+json;version=1` media type. It
+requires a synchronized structured model and retains every JSON-defined field,
+including layout, review, comment, and bibliography state. A different schema
+or version, malformed or oversized JSON, cyclic runtime input, and stale model
+fingerprints fail closed. This is the persistence and transport boundary for
+hosts that need exact browser/agent revision snapshots; they must not substitute
+a lossy HTML-to-Markdown conversion.
+
+This is a transitional persistence boundary, not fully loss-preserving OOXML
+yet. DOCX still converts through Mammoth, but DOCX, HTML, and text imports
+create the structured model immediately through the same extension schema used
+by the editor. DOCX export materializes synchronized HTML from the structured
+model before OOXML generation, so a stale HTML cache cannot override model
+changes. Preview retains the mounted structured editor tree, and live browser
+PDF export captures that same paginated surface; compatibility HTML remains an
+import/export boundary.
+
+The first package-state slice retains the original DOCX Blob by artifact ID.
+After the generated core package is complete, safe source-only OPC parts are
+copied byte-for-byte and their content-type declarations and relationships are
+reconnected with collision-free IDs. The generated core parts remain
+authoritative. Digital signatures, which are invalid after editing, plus VBA,
+ActiveX, and custom-ribbon content are not propagated into the macro-free DOCX.
+If a persisted artifact has lost its registered source Blob, export fails
+closed. A persisted SHA-256 fingerprint also prevents a different DOCX from
+being re-registered under the same artifact ID. Unknown attributes, elements,
+and `mc:AlternateContent` branches are now selectively merged inside
+`word/settings.xml`: only passive ignorable markup that is relationship-free,
+structurally valid, and non-conflicting with generated Word settings survives.
+Strict and transitional UTF-8/UTF-16 sources share this path. The package graph
+also retains source font-table metadata and source-only internal obfuscated-font
+payloads, then rewrites their references to collision-free relationship IDs.
+External fonts, mismatched relationship or content types, duplicate identities,
+and source payload paths that collide with generated parts are disconnected.
+This preserves embedded fonts for native DOCX consumers without loading those
+binaries into the browser editor, preview, or PDF renderer. Passive,
+relationship-free extension trees at the roots and uniquely matched nodes of
+`word/styles.xml` and `word/numbering.xml` are also retained. Styles match by
+type plus style ID. Imported abstract-numbering, concrete-numbering, and level
+metadata follows regenerated IDs. Duplicate, source-only, malformed, and
+ambiguous one-to-many mappings fail closed, and generated Word semantics remain
+authoritative. Relationship-free passive extensions from non-OOXML ignorable
+namespaces also follow uniquely matched picture drawings in regenerated
+document, header, and footer parts. The identity is the normalized anchor plus
+drawing-property ID; header and footer imports retain both through sanitized
+editable HTML. Strict/transitional UTF-8/UTF-16 sources share the same path.
+Source-only or duplicate drawings, relationship-bound content,
+Microsoft/OOXML semantic namespaces, and ambiguous identities fail closed,
+while generated geometry and media win. The paragraph-identity slice preserves
+the same class of passive extension on uniquely matched, unchanged paragraphs
+and their paragraph properties. Native `w14:paraId` plus `w14:textId` survives
+sanitized body and page-chrome HTML. Text edits rotate `textId`, formatting-only
+edits and moves retain it, and copies or splits receive new paragraph IDs.
+Changed text versions, duplicate identities, relationship-bound content, and
+Microsoft/OOXML semantic branches fail closed; generated paragraph semantics
+remain authoritative. The table-identity slice applies the same policy to
+`w:tbl`, `w:tr`, and `w:tc` plus their property nodes. Rows carry native
+`w14:paraId` and `w14:textId` through body and page-chrome HTML. Tables match by
+their ordered directly owned row IDs, while cells match by their owning row and
+directly owned paragraph IDs. Text or structural edits rotate a row version;
+formatting-only edits and moves retain it, and copies receive independent IDs.
+Nested DOM row and cell collections are filtered to their closest owning table
+or row. Missing, duplicate, cross-kind, relationship-bound, or semantic
+identities fail closed, and generated table geometry remains authoritative.
+Unknown run, note, comment, and other inline markup remains the next
+loss-preservation boundary.
 
 Migration to browser-native OOXML is staged:
 
@@ -797,12 +1012,12 @@ bundle regression.
 - Extend the current horizontal and vertical page rulers with bidirectional and
   locale-complete tab behavior, plus complete style, numbering, and theme
   inheritance beyond the implemented paragraph slices.
-- Complete row-internal splitting for single indivisible paragraphs and
-  complex merged-cell flows, and add nested tables, full floating-object
-  geometry beyond the supported square/top-and-bottom image anchors, footnote
-  balancing, columns, and mixed page sections. Row-flow pagination, direct-cell
-  block splitting, repeating headers, and the initial image-wrapping slice are
-  already implemented.
+- Complete row-internal splitting for single indivisible paragraphs and full
+  floating-object geometry beyond the supported wrap, precise-anchor, and
+  image-layer subset, plus footnote balancing and columns. Row-flow
+  pagination, direct-cell and nested-row splitting, merged-cell continuations,
+  repeating headers, and the current image-wrapping slice are already
+  implemented.
 - Keep pagination results as mapped ProseMirror decorations so reflow never
   corrupts selection or undo history.
 
@@ -1005,8 +1220,8 @@ repeatable fixtures. The targets below are release gates, not current claims:
 - WebAssembly performs no network or filesystem access.
 - Worker failure is recoverable and does not block typing.
 - Automatic pagination transactions are excluded from editor history.
-- Multi-column and mixed-page-layout documents currently retain explicit-break
-  behavior until their layout protocols are implemented.
+- Multi-column documents currently retain explicit-break behavior until their
+  layout protocol is implemented.
 
 ## Verification
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "Open-source browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -51,6 +51,7 @@
   "files": [
     "dist",
     "docs/latest/en/browser-editor-architecture.md",
+    "COLLABORATION_ROADMAP.md",
     "README.md",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md"
@@ -83,13 +84,32 @@
     "playground:preview": "rsbuild preview --config playground/rsbuild.config.ts --host 127.0.0.1 --port 4175 --strict-port",
     "playground:typecheck": "tsc --noEmit -p playground/tsconfig.json",
     "playground:visual": "playwright test --config playwright.config.ts",
+    "playground:visual:spreadsheet-ribbon": "playwright test visual-tests/spreadsheet-ribbon.functional.spec.ts --config playwright.config.ts",
     "playground:visual:update": "playwright test --config playwright.config.ts --update-snapshots",
     "test": "rstest",
-    "test:e2e": "bun run test:e2e:fixtures && a3s-test run tests/e2e/word-page-color.acl --json && a3s-test run tests/e2e/word-page-setup-phone.acl --json && a3s-test run tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test run tests/e2e/word-list-formatting-phone.acl --json && a3s-test run tests/e2e/word-comments-drawer.acl --json && a3s-test run tests/e2e/word-comment-windowing.acl --json && a3s-test run tests/e2e/word-citations-phone.acl --json && a3s-test run tests/e2e/word-navigation-search.acl --json && a3s-test run tests/e2e/word-navigation-windowing.acl --json && a3s-test run tests/e2e/word-find-replace-phone.acl --json && a3s-test run tests/e2e/word-page-navigation.acl --json && a3s-test run tests/e2e/word-page-windowing.acl --json && a3s-test run tests/e2e/word-ai-question.acl --json && a3s-test run tests/e2e/word-picture-insert.acl --json && a3s-test run tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test run tests/e2e/word-track-changes-phone.acl --json && a3s-test run tests/e2e/word-revision-windowing.acl --json && a3s-test run tests/e2e/word-table-phone.acl --json && a3s-test run tests/e2e/word-table-borders.acl --json && a3s-test run tests/e2e/word-theme-table.acl --json && a3s-test run tests/e2e/word-styled-table.acl --json && a3s-test run tests/e2e/word-multi-page-table.acl --json && a3s-test run tests/e2e/word-cross-reference-phone.acl --json && a3s-test run tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test run tests/e2e/spreadsheet-phone-find.acl --json && a3s-test run tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test run tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test run tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test run tests/e2e/presentation-presenter-view.acl --json && a3s-test run tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test run tests/e2e/presentation-phone-comments.acl --json && a3s-test run tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test run tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test run tests/e2e/markdown-phone-modes.acl --json && a3s-test run tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test run tests/e2e/office-docs-navigation.acl --json",
-    "test:e2e:check": "bun run test:e2e:fixtures && a3s-test check tests/e2e/word-page-color.acl --json && a3s-test check tests/e2e/word-page-setup-phone.acl --json && a3s-test check tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test check tests/e2e/word-list-formatting-phone.acl --json && a3s-test check tests/e2e/word-comments-drawer.acl --json && a3s-test check tests/e2e/word-comment-windowing.acl --json && a3s-test check tests/e2e/word-citations-phone.acl --json && a3s-test check tests/e2e/word-navigation-search.acl --json && a3s-test check tests/e2e/word-navigation-windowing.acl --json && a3s-test check tests/e2e/word-find-replace-phone.acl --json && a3s-test check tests/e2e/word-page-navigation.acl --json && a3s-test check tests/e2e/word-page-windowing.acl --json && a3s-test check tests/e2e/word-ai-question.acl --json && a3s-test check tests/e2e/word-picture-insert.acl --json && a3s-test check tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test check tests/e2e/word-track-changes-phone.acl --json && a3s-test check tests/e2e/word-revision-windowing.acl --json && a3s-test check tests/e2e/word-table-phone.acl --json && a3s-test check tests/e2e/word-table-borders.acl --json && a3s-test check tests/e2e/word-theme-table.acl --json && a3s-test check tests/e2e/word-styled-table.acl --json && a3s-test check tests/e2e/word-multi-page-table.acl --json && a3s-test check tests/e2e/word-cross-reference-phone.acl --json && a3s-test check tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test check tests/e2e/spreadsheet-phone-find.acl --json && a3s-test check tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test check tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test check tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test check tests/e2e/presentation-presenter-view.acl --json && a3s-test check tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test check tests/e2e/presentation-phone-comments.acl --json && a3s-test check tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test check tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test check tests/e2e/markdown-phone-modes.acl --json && a3s-test check tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test check tests/e2e/office-docs-navigation.acl --json",
+    "test:e2e": "bun run test:e2e:fixtures && a3s-test run tests/e2e/word-page-color.acl --json && a3s-test run tests/e2e/word-page-setup-phone.acl --json && a3s-test run tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test run tests/e2e/word-list-formatting-phone.acl --json && a3s-test run tests/e2e/word-font-picker-phone.acl --json && a3s-test run tests/e2e/word-comments-drawer.acl --json && a3s-test run tests/e2e/word-comment-windowing.acl --json && a3s-test run tests/e2e/word-citations-phone.acl --json && a3s-test run tests/e2e/word-navigation-search.acl --json && a3s-test run tests/e2e/word-navigation-windowing.acl --json && a3s-test run tests/e2e/word-find-replace-phone.acl --json && a3s-test run tests/e2e/word-page-navigation.acl --json && a3s-test run tests/e2e/word-page-windowing.acl --json && a3s-test run tests/e2e/word-ai-question.acl --json && a3s-test run tests/e2e/word-picture-insert.acl --json && a3s-test run tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test run tests/e2e/word-track-changes-phone.acl --json && a3s-test run tests/e2e/word-review-conflict-phone.acl --json && a3s-test run tests/e2e/word-revision-windowing.acl --json && a3s-test run tests/e2e/word-table-phone.acl --json && a3s-test run tests/e2e/word-table-borders.acl --json && a3s-test run tests/e2e/word-theme-table.acl --json && a3s-test run tests/e2e/word-styled-table.acl --json && a3s-test run tests/e2e/word-multi-page-table.acl --json && a3s-test run tests/e2e/word-cross-reference-phone.acl --json && a3s-test run tests/e2e/word-bookmark-links-phone.acl --json && a3s-test run tests/e2e/word-notes-phone.acl --json && a3s-test run tests/e2e/word-fields-phone.acl --json && a3s-test run tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test run tests/e2e/spreadsheet-phone-find.acl --json && a3s-test run tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test run tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test run tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test run tests/e2e/presentation-presenter-view.acl --json && a3s-test run tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test run tests/e2e/presentation-phone-comments.acl --json && a3s-test run tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test run tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test run tests/e2e/markdown-phone-modes.acl --json && a3s-test run tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test run tests/e2e/office-docs-navigation.acl --json && a3s-test run tests/e2e/collaboration-participants.acl --json && a3s-test run tests/e2e/collaboration-pdf-annotations.acl --json",
+    "test:e2e:check": "bun run test:e2e:fixtures && a3s-test check tests/e2e/word-page-color.acl --json && a3s-test check tests/e2e/word-page-setup-phone.acl --json && a3s-test check tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test check tests/e2e/word-list-formatting-phone.acl --json && a3s-test check tests/e2e/word-font-picker-phone.acl --json && a3s-test check tests/e2e/word-comments-drawer.acl --json && a3s-test check tests/e2e/word-comment-windowing.acl --json && a3s-test check tests/e2e/word-citations-phone.acl --json && a3s-test check tests/e2e/word-navigation-search.acl --json && a3s-test check tests/e2e/word-navigation-windowing.acl --json && a3s-test check tests/e2e/word-find-replace-phone.acl --json && a3s-test check tests/e2e/word-page-navigation.acl --json && a3s-test check tests/e2e/word-page-windowing.acl --json && a3s-test check tests/e2e/word-ai-question.acl --json && a3s-test check tests/e2e/word-picture-insert.acl --json && a3s-test check tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test check tests/e2e/word-track-changes-phone.acl --json && a3s-test check tests/e2e/word-review-conflict-phone.acl --json && a3s-test check tests/e2e/word-revision-windowing.acl --json && a3s-test check tests/e2e/word-table-phone.acl --json && a3s-test check tests/e2e/word-table-borders.acl --json && a3s-test check tests/e2e/word-theme-table.acl --json && a3s-test check tests/e2e/word-styled-table.acl --json && a3s-test check tests/e2e/word-multi-page-table.acl --json && a3s-test check tests/e2e/word-cross-reference-phone.acl --json && a3s-test check tests/e2e/word-bookmark-links-phone.acl --json && a3s-test check tests/e2e/word-notes-phone.acl --json && a3s-test check tests/e2e/word-fields-phone.acl --json && a3s-test check tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test check tests/e2e/spreadsheet-phone-find.acl --json && a3s-test check tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test check tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test check tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test check tests/e2e/presentation-presenter-view.acl --json && a3s-test check tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test check tests/e2e/presentation-phone-comments.acl --json && a3s-test check tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test check tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test check tests/e2e/markdown-phone-modes.acl --json && a3s-test check tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test check tests/e2e/office-docs-navigation.acl --json && a3s-test check tests/e2e/collaboration-participants.acl --json && a3s-test check tests/e2e/collaboration-pdf-annotations.acl --json",
     "test:e2e:fixtures": "bun scripts/create-e2e-fixtures.ts",
+    "test:e2e:initial-focus": "a3s-test run tests/e2e/office-editor-initial-focus.acl --json",
+    "test:e2e:initial-focus:check": "a3s-test check tests/e2e/office-editor-initial-focus.acl --json",
+    "test:e2e:collaboration-participants": "a3s-test run tests/e2e/collaboration-participants.acl --json",
+    "test:e2e:collaboration-participants:check": "a3s-test check tests/e2e/collaboration-participants.acl --json",
+    "test:e2e:collaboration-pdf-annotations": "a3s-test run tests/e2e/collaboration-pdf-annotations.acl --json",
+    "test:e2e:collaboration-pdf-annotations:check": "a3s-test check tests/e2e/collaboration-pdf-annotations.acl --json",
     "test:e2e:wps-layout": "bun run test:e2e:fixtures && a3s-test run tests/e2e/word-wps-layout-parity.acl --json && a3s-test run tests/e2e/word-wps-font-grid-parity.acl --json",
     "test:e2e:wps-layout:check": "bun run test:e2e:fixtures && a3s-test check tests/e2e/word-wps-layout-parity.acl --json && a3s-test check tests/e2e/word-wps-font-grid-parity.acl --json",
+    "test:e2e:writer-ribbon": "a3s-test run tests/e2e/word-ribbon-collapse.acl --json",
+    "test:e2e:writer-ribbon:check": "a3s-test check tests/e2e/word-ribbon-collapse.acl --json",
+    "test:e2e:spreadsheet-ribbon": "a3s-test run tests/e2e/spreadsheet-ribbon-alignment.acl --json",
+    "test:e2e:spreadsheet-ribbon:check": "a3s-test check tests/e2e/spreadsheet-ribbon-alignment.acl --json",
+    "test:e2e:writer-shortcuts": "a3s-test run tests/e2e/word-wps-shortcuts.acl --json",
+    "test:e2e:writer-shortcuts:check": "a3s-test check tests/e2e/word-wps-shortcuts.acl --json",
+    "test:e2e:writer-layout": "a3s-test run tests/e2e/word-insert-page-layout.acl --json",
+    "test:e2e:writer-layout:check": "a3s-test check tests/e2e/word-insert-page-layout.acl --json",
+    "test:e2e:writer-review-view": "a3s-test run tests/e2e/word-review-view.acl --json",
+    "test:e2e:writer-review-view:check": "a3s-test check tests/e2e/word-review-view.acl --json",
+    "test:e2e:writer-status": "a3s-test run tests/e2e/word-status-bar.acl --json",
+    "test:e2e:writer-status:check": "a3s-test check tests/e2e/word-status-bar.acl --json",
     "test:wps-layout": "powershell -NoProfile -ExecutionPolicy Bypass -File scripts/test-wps-layout-parity.ps1",
     "test:watch": "rstest --watch",
     "typecheck": "tsc --noEmit"
@@ -105,6 +125,8 @@
     "@fortune-sheet/formula-parser": "0.2.13",
     "@fortune-sheet/react": "^1.0.4",
     "@tiptap/core": "3.28.0",
+    "@tiptap/extension-collaboration": "3.28.0",
+    "@tiptap/extension-collaboration-caret": "3.28.0",
     "@tiptap/extension-color": "3.28.0",
     "@tiptap/extension-highlight": "3.28.0",
     "@tiptap/extension-image": "3.28.0",
@@ -120,6 +142,7 @@
     "@tiptap/pm": "3.28.0",
     "@tiptap/react": "3.28.0",
     "@tiptap/starter-kit": "3.28.0",
+    "@tiptap/y-tiptap": "3.0.8",
     "docx": "^9.7.1",
     "html2canvas": "^1.4.1",
     "jspdf": "^3.0.3",
@@ -127,7 +150,9 @@
     "lucide-react": "^0.544.0",
     "mammoth": "^1.12.0",
     "pptxgenjs": "^4.0.1",
-    "xlsx": "^0.18.5"
+    "xlsx": "^0.18.5",
+    "y-protocols": "1.0.7",
+    "yjs": "13.6.32"
   },
   "peerDependencies": {
     "react": ">=18.2.0 <20",