@a3s-lab/office 0.6.0 → 0.7.1

package/COLLABORATION_ROADMAP.md

@@ -150,9 +150,10 @@ round trip preserves supported and untouched unsupported OOXML.
 
 ### Phase 3: Presentation
 
-Status: browser collaboration foundation and native conflict-local scene-element
-mutations implemented; rich-text CRDT, structural native operations, and PPTX
-round-trip concurrency coverage are pending.
+Status: browser collaboration foundation and native conflict-local
+scene-element content and z-order mutations implemented; rich-text CRDT,
+remaining structural native operations, and PPTX round-trip concurrency
+coverage are pending.
 
 - Stable slide/master/layout order arrays and ID-keyed record maps avoid a
   serialized whole-deck root. Scene elements and slide comments are ID-keyed
@@ -171,21 +172,25 @@ round-trip concurrency coverage are pending.
 - Tests cover bootstrap, identity validation, separate-record convergence,
   stale snapshots, concurrent comments, local-only undo, permissions, mounted
   projection, and framework adapters.
-- Rust, CLI, MCP, and A3S Code can create, optimistically update, or tombstone
-  one element in a slide, master, or layout. Creation can insert after a stable
-  active element. Update compares complete expected/current/next records and
-  writes only changed top-level fields, so unrelated concurrent changes merge
-  while a stale same-field edit fails atomically. Delete requires an exact
-  complete-element match. Browser/Yrs fixtures, native restart, duplicate and
-  reordered delivery, real CLI/MCP subprocesses, and the Playground cover the
-  same lifecycle.
+- Rust, CLI, MCP, and A3S Code can create, optimistically update, move, or
+  tombstone one element in a slide, master, or layout. Creation can insert
+  after a stable active element. Update compares complete
+  expected/current/next records and writes only changed top-level fields, so
+  unrelated concurrent changes merge while a stale same-field edit fails
+  atomically. Move compares stable observed and requested predecessor IDs,
+  treats an already-satisfied destination as idempotent, and changes only the
+  moved element's order entry; `null` means the first order position. Delete
+  requires an exact complete-element match. Browser/Yrs fixtures, native
+  restart, duplicate and reordered delivery, real CLI/MCP subprocesses, and
+  the Playground cover update/create/move/delete interoperability.
 
 Remaining:
 
 - Bind editable scene text to collaborative XML fragments instead of scalar
   text/run replacement.
 - Add structural native operations and explicit conflict handling for slide
-  order, z-order, grouping, and theme changes.
+  order, grouping, and theme changes; extend z-order beyond stable scene-element
+  moves where a concrete browser workflow requires it.
 - Keep derived thumbnails and layout measurements local and prove this in UI
   tests.
 - Add offline/reordered-update property tests plus merged PPTX export/reopen.
@@ -389,10 +394,11 @@ projection are pending.
   an exact complete-cell match. They preserve the browser's field-addressed
   representation, dense/sparse projection mode, and atomic fail-closed
   semantics without replacing a worksheet or workbook.
-- Presentation scene-element mutations create, update, or tombstone one stable
-  object inside a slide, master, or layout. Canonical creation claims prevent
-  conflicting same-ID reuse, optimistic top-level field guards merge unrelated
-  concurrent edits, and exact deletion guards prevent a stale destructive
+- Presentation scene-element mutations create, update, move, or tombstone one
+  stable object inside a slide, master, or layout. Canonical creation claims
+  prevent conflicting same-ID reuse, optimistic top-level field guards merge
+  unrelated concurrent edits, stable predecessor guards move one order entry
+  without array indexes, and exact deletion guards prevent a stale destructive
   write without replacing the deck or container.
 - PDF form-value mutations write the browser-compatible conflict-local record
   roots by fully-qualified field name, retain idempotent receipts and optional
@@ -422,7 +428,7 @@ projection are pending.
   an authorization token.
 - Cross-language tests apply deterministic native UTF-16 Markdown, ProseMirror
   Document text/options/paragraph, Spreadsheet cell, Presentation
-  scene-element, and PDF annotation/form-value updates in browser Yjs,
+  scene-element content/z-order, and PDF annotation/form-value updates in browser Yjs,
   including concurrent browser/native paragraph, cell-leaf, element-field,
   annotation-leaf, and PDF form edits, in addition to importing browser Yjs
   fixtures in Yrs.
@@ -432,7 +438,7 @@ projection are pending.
 
 Remaining:
 
-- Extend typed format-model mutations to Spreadsheet and Presentation
+- Extend typed format-model mutations to Spreadsheet and remaining Presentation
   structural/rich-text operations plus PDF signatures; deepen Document
   mutations to additional nested structures and review operations, and add
   durable comment/suggest operations before enabling those modes for local

package/README.md

@@ -23,6 +23,7 @@
   <a href="https://a3s-lab.github.io/Office/docs/">Documentation</a> ·
   <a href="#quick-start">Quick start</a> ·
   <a href="#five-format-native-surfaces">Editors</a> ·
+  <a href="#real-time-collaboration">Collaboration</a> ·
   <a href="#native-automation">Automation</a> ·
   <a href="#architecture">Architecture</a> ·
   <a href="ROADMAP.md">WPS gap roadmap</a> ·
@@ -43,6 +44,8 @@ workflows, and a separate Rust automation plane.
   lowest-common-denominator model.
 - **Own the product boundary**: your application controls content, storage,
   permissions, collaboration, and model providers.
+- **Collaborate across every editor** with shared Yjs/Yrs content, Awareness
+  participants and remote locations, plus browser, CLI, MCP, and A3S Code peers.
 - **Automate deterministically** through the native CLI, standard MCP server,
   or packaged Office Skill.
 
@@ -139,9 +142,24 @@ The images below are committed visual-regression baselines from the real
   server, and Office Skill share bounded mutation contracts. Coding agents can
   also keep a durable Yrs replica, exchange standard Yjs v1 updates and state
   vectors, perform authorized typed Markdown, Document, Spreadsheet cell,
-  Presentation scene-element, and PDF annotation, form-value, and review
-  changes, retain browser/native actor attribution, and checkpoint without
-  replacing a whole Office file.
+  Presentation scene-element and z-order, and PDF annotation, form-value, and
+  review changes, retain browser/native actor attribution, and checkpoint
+  without replacing a whole Office file.
+
+## Real-time collaboration
+
+Document, Markdown, Spreadsheet, Presentation, and PDF expose the same
+transport-neutral collaboration boundary. Two browser clients can edit one
+artifact live, render an accessible participant roster, and project remote
+text selections, cells, scene objects, pages, or annotations without moving
+the local user's viewport or focus. Native Yrs replicas join the same state
+through the CLI, standard MCP server, or A3S Code.
+
+The host owns rooms, authentication, authorization, network delivery, offline
+buffering, persistence, and the `Y.Doc`; A3S Office owns format-specific
+bindings, local undo, validated presence, and conflict-local typed mutations.
+See the bilingual [real-time collaboration guide](https://a3s-lab.github.io/Office/docs/components/collaboration.html)
+for React, Vue, Web Component, reconnect, security, and native-agent setup.
 
 ## Quick start
 
@@ -1038,6 +1056,14 @@ cargo run -p a3s-office-cli -- collab mutate .a3s/deck.replica \
   --operation-id edit-46 \
   --mutation '{"type":"presentation-update-element","containerKind":"slide","containerId":"slide-1","elementId":"title-1","expectedElement":{"id":"title-1","type":"text","x":10,"y":10,"width":80,"height":20,"text":"Draft"},"nextElement":{"id":"title-1","type":"text","x":16,"y":10,"width":80,"height":20,"text":"Final"}}' --json
 
+# Move that element to the first order position after verifying its currently
+# observed predecessor. Destination and source positions use stable IDs, not
+# array indexes; null means no predecessor.
+cargo run -p a3s-office-cli -- collab mutate .a3s/deck.replica \
+  --artifact-id deck --kind presentation --actor-id agent-7 --mode edit \
+  --operation-id move-46 \
+  --mutation '{"type":"presentation-move-element","containerKind":"slide","containerId":"slide-1","elementId":"title-1","expectedAfterElementId":"background-1","afterElementId":null}' --json
+
 # Set one PDF form value through its stable fully-qualified field name.
 cargo run -p a3s-office-cli -- collab mutate .a3s/application.replica \
   --artifact-id application --kind pdf --actor-id agent-7 --mode edit \
@@ -1106,8 +1132,13 @@ plus a canonical immutable claim inside a slide, master, or layout and can
 place it after a stable active element. Presentation update compares complete
 expected/current/next elements and writes only changed top-level fields, so
 unrelated concurrent geometry, text, or style changes merge while a stale
-same-field edit fails. Exact deletion writes a durable tombstone, and element
-IDs and types never drift or become reusable. PDF annotation creation accepts the
+same-field edit fails. Presentation move compares the stable observed and
+requested predecessor IDs instead of array indexes; `null` means the first
+element-order position. An already-satisfied destination is idempotent, while
+a stale source position or unavailable anchor fails before a durable update.
+Only the moved element's order entry changes; no object fields, container, or
+deck are replaced. Exact deletion writes a durable tombstone, and element IDs
+and types never drift or become reusable. PDF annotation creation accepts the
 portable browser record for FreeText, Highlight, Underline, StrikeOut, or Ink,
 writes `source: created`, and commits its immutable claim atomically. An update
 supplies complete `expectedAnnotation` and `nextAnnotation` values; recursive
@@ -1185,6 +1216,8 @@ without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.7.1 documentation](https://a3s-lab.github.io/Office/docs/0.7.1/)
+- [A3S Office 0.7.0 documentation](https://a3s-lab.github.io/Office/docs/0.7.0/)
 - [A3S Office 0.6.0 documentation](https://a3s-lab.github.io/Office/docs/0.6.0/)
 - [A3S Office 0.5.0 documentation](https://a3s-lab.github.io/Office/docs/0.5.0/)
 - [A3S Office 0.4.0 documentation](https://a3s-lab.github.io/Office/docs/0.4.0/)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.6.0",
-  "description": "Open-source browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
+  "version": "0.7.1",
+  "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
     "document-editor",
@@ -9,6 +9,8 @@
     "spreadsheet",
     "presentation",
     "pdf",
+    "collaboration",
+    "yjs",
     "react",
     "vue",
     "web-components"