@a3s-lab/office 0.4.0 → 0.6.0

package/COLLABORATION_ROADMAP.md

@@ -150,12 +150,17 @@ round trip preserves supported and untouched unsupported OOXML.
 
 ### Phase 3: Presentation
 
-Status: browser collaboration foundation implemented; rich-text CRDT and PPTX
+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.
 
 - 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
   child records.
+- Append-only element claims make identical same-ID creation idempotent and
+  reject different records assigned to one ID. Deletion writes a durable
+  tombstone, removes the element from visible order, and permanently reserves
+  the identity; element ID and type cannot drift.
 - Snapshot writes are translated into `previous -> next` record patches, so an
   unrelated stale snapshot does not remove remotely added slides or objects.
 - Typed validation rejects duplicate identities and invalid references before
@@ -166,13 +171,21 @@ 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.
 
 Remaining:
 
 - Bind editable scene text to collaborative XML fragments instead of scalar
   text/run replacement.
-- Add creation claims and explicit conflict handling for concurrent same-ID
-  object creation, delete-vs-edit, z-order, grouping, and theme changes.
+- Add structural native operations and explicit conflict handling for slide
+  order, z-order, grouping, and theme changes.
 - Keep derived thumbnails and layout measurements local and prove this in UI
   tests.
 - Add offline/reordered-update property tests plus merged PPTX export/reopen.
@@ -182,8 +195,9 @@ comments, and delete-vs-edit cases converge and survive PPTX round trips.
 
 ### Phase 4: Spreadsheet
 
-Status: browser collaboration foundation implemented; structural operations,
-native recalculation parity, and XLSX concurrency coverage are pending.
+Status: browser collaboration foundation and native conflict-local cell
+mutations implemented; structural operations, native recalculation parity, and
+XLSX concurrency coverage are pending.
 
 - Stable sheet/named-range order arrays, ID-keyed records, and append-only
   creation claims avoid a serialized workbook or dense worksheet root.
@@ -208,6 +222,14 @@ native recalculation parity, and XLSX concurrency coverage are pending.
   route canonical edits plus local-only undo/redo through the same binding.
   Active-sheet status, selections, zoom, and Fortune Sheet focus remain local
   view state and are reapplied after remote canonical updates.
+- Rust, CLI, MCP, and A3S Code can create or recursively patch one cell with
+  `spreadsheet-set-cell`, or delete one exact complete cell with
+  `spreadsheet-delete-cell`. Recursive optimistic guards merge unrelated JSON
+  leaves and reject stale same-leaf edits before writing. Dense projections
+  retain and safely extend row lengths, sparse projections remain `celldata`,
+  and an empty sheet's first write stays sparse. Native restart, real CLI/MCP
+  subprocesses, and browser Yjs duplicate/reordered delivery cover the same
+  update contract.
 
 Remaining:
 
@@ -313,9 +335,10 @@ destructive actions remain attributable, reviewable, and non-retryable.
 
 Status: native Yrs replica store, resumable CLI/MCP event streams, `a3s code`
 projection, a host-injected live CLI transport session, and typed Markdown,
-Document, PDF annotation/form-value, and PDF redaction/page-operation review
-mutation surfaces are implemented; the remaining format mutations and native
-presence projection are pending.
+Document, Spreadsheet cell, Presentation scene-element, PDF
+annotation/form-value, and PDF redaction/page-operation review mutation
+surfaces are implemented; the remaining format mutations and native presence
+projection are pending.
 
 - Yrs `0.27.3` now uses 53-bit Yjs-compatible client IDs and exchanges standard
   Yjs v1 updates, state vectors, and y-sync `SyncStep1`/`Update` messages with
@@ -361,6 +384,16 @@ presence projection are pending.
   incremental updates through the same durable
   receipt/checkpoint path. Canonical typed mutations require `edit`; raw remote
   updates remain receivable in every mode so read-only peers still converge.
+- Spreadsheet cell mutations create or recursively patch one zero-based
+  coordinate after matching the caller's observed cell, or delete it only after
+  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
+  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
   state-vector preconditions, and never synchronize source bytes.
@@ -388,19 +421,22 @@ presence projection are pending.
   source browser operation, and source attribution is audit data rather than
   an authorization token.
 - Cross-language tests apply deterministic native UTF-16 Markdown, ProseMirror
-  Document text/options/paragraph, and PDF annotation/form-value updates in
-  browser Yjs, including concurrent browser/native paragraph, annotation-leaf,
-  and PDF form edits, in addition to importing browser Yjs fixtures in Yrs.
+  Document text/options/paragraph, Spreadsheet cell, Presentation
+  scene-element, 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.
 - Standard MCP exposes the durable replica lifecycle and bounded event stream;
   the same seven collaboration tools are explicitly available to the dedicated
   `a3s code` Use worker.
 
 Remaining:
 
-- Extend typed format-model mutations to Spreadsheet and Presentation 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 mutation.
+- Extend typed format-model mutations to Spreadsheet and 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
+  mutation.
 - Project editor-visible presence and selection state while keeping Awareness
   ephemeral and outside native replica persistence.
 

package/README.md

@@ -138,9 +138,10 @@ The images below are committed visual-regression baselines from the real
 - **Automation outside the browser** — The native Rust CLI, standard MCP
   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, and PDF annotation,
-  form-value, and review changes, retain browser/native actor attribution, and
-  checkpoint without replacing a whole Office file.
+  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.
 
 ## Quick start
 
@@ -1023,6 +1024,20 @@ cargo run -p a3s-office-cli -- collab mutate .a3s/report.replica \
   --operation-id edit-44 \
   --mutation '{"type":"document-insert-paragraph","anchorParagraphId":"00000001","position":"after","paragraphId":"00000012","textId":"00000013","text":"Native paragraph"}' --json
 
+# Recursively patch one Spreadsheet cell after matching the observed value.
+# Zero-based row/column coordinates follow the browser collaboration model.
+cargo run -p a3s-office-cli -- collab mutate .a3s/plan.replica \
+  --artifact-id plan --kind spreadsheet --actor-id agent-7 --mode edit \
+  --operation-id edit-45 \
+  --mutation '{"type":"spreadsheet-set-cell","sheetId":"sheet-data","row":1,"column":0,"expectedCell":{"v":10,"m":"10"},"nextCell":{"v":12,"m":"12","f":"=6*2"}}' --json
+
+# Update one Presentation scene element after matching the complete observed
+# record. Create/delete use presentation-create/delete-element.
+cargo run -p a3s-office-cli -- collab mutate .a3s/deck.replica \
+  --artifact-id deck --kind presentation --actor-id agent-7 --mode edit \
+  --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
+
 # 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 \
@@ -1080,7 +1095,19 @@ table rotate every identified ancestor row's `rowTextId`; incomplete row
 identities fail before any write. Paragraphs containing inline atoms or review
 marks remain guarded.
 Page-color/track-changes sidecars remain independent conflict-local fields. All
-mutations use the same durable event path. PDF annotation creation accepts the
+mutations use the same durable event path. Spreadsheet set-cell mutations
+recursively compare `expectedCell` with the current browser-compatible cell and
+write only changed leaves, so unrelated concurrent value, formula, style,
+hyperlink, note, and metadata edits merge. Use `expectedCell: null` only when
+creating an observed blank coordinate. Spreadsheet deletion requires the exact
+complete current cell, dense projections keep their dimensions, and sparse or
+empty sheets remain sparse. Presentation creation writes one complete element
+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
 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
@@ -1158,6 +1185,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.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/)
 - [A3S Office 0.3.0 documentation](https://a3s-lab.github.io/Office/docs/0.3.0/)
 - [A3S Office 0.2.0 documentation](https://a3s-lab.github.io/Office/docs/0.2.0/)

package/dist/4560.js

@@ -1,5 +1,5 @@
 import { initializeWorkOfficeCollaborationMetadata, assertWorkOfficeCollaborationEditable, OfficeCollaborationError as WorkOfficeCollaborationError, readOfficeCollaborationMetadata as readWorkOfficeCollaborationMetadata, registerWorkOfficeCollaborationInitializer, markWorkOfficeCollaborationInitialized, assertWorkOfficeCollaborationOrigin } from "./9787.js";
-import { workOfficeCollaborationJsonEqual, isWorkOfficeCollaborationRecord, cloneWorkOfficeCollaborationJson } from "./4650.js";
+import { workOfficeCollaborationJsonEqual, canonicalWorkOfficeCollaborationJson, isWorkOfficeCollaborationRecord, cloneWorkOfficeCollaborationJson } from "./4650.js";
 import * as __rspack_external_yjs from "yjs";
 function validateWorkOfficePresentationContent(content) {
     if (!content || 'presentation' !== content.type) invalidWorkOfficePresentationInput('a Presentation content value');
@@ -66,6 +66,7 @@ function validateLayout(value) {
 }
 function validateElement(value) {
     const record = requiredInputRecord(value, 'presentation element');
+    if (Object.hasOwn(record, 'tombstone')) invalidWorkOfficePresentationInput("a presentation element without the reserved 'tombstone' field");
     const element = validateJsonRecord(record, 'presentation element');
     element.id = requiredIdentifier(record.id, 'presentation element');
     element.type = requiredString(record.type, 'presentation element type');
@@ -131,11 +132,115 @@ function requiredFiniteNumber(value, label) {
 function invalidWorkOfficePresentationInput(expected) {
     throw new WorkOfficeCollaborationError('office.collaboration.content_invalid', `Presentation collaboration requires ${expected}.`);
 }
+function appendWorkOfficePresentationRecordClaims(claims, previous, next) {
+    appendContainerClaims(claims, 'slide', previous?.slides ?? [], next.slides);
+    appendContainerClaims(claims, 'master', previous?.masters ?? [], next.masters ?? []);
+    appendContainerClaims(claims, 'layout', previous?.layouts ?? [], next.layouts ?? []);
+}
+function assertWorkOfficePresentationRecordClaims(claims, content) {
+    const fingerprints = new Map();
+    for (const raw of claims.toArray()){
+        const claim = parsedClaim(raw);
+        const identity = claimIdentity(claim.containerKind, claim.containerId, claim.id);
+        const existing = fingerprints.get(identity);
+        if (void 0 !== existing && existing !== claim.fingerprint) throw new WorkOfficeCollaborationError('office.collaboration.content_invalid', `The scene element in ${claim.containerKind} '${claim.containerId}' ID '${claim.id}' was concurrently assigned to different records.`);
+        fingerprints.set(identity, claim.fingerprint);
+    }
+    assertClaimedElementIdentities(fingerprints, 'slide', content.slides);
+    assertClaimedElementIdentities(fingerprints, 'master', content.masters ?? []);
+    assertClaimedElementIdentities(fingerprints, 'layout', content.layouts ?? []);
+}
+function appendContainerClaims(claims, containerKind, previous, next) {
+    const previousById = new Map(previous.map((container)=>[
+            container.id,
+            container
+        ]));
+    for (const container of next){
+        const previousElementIds = new Set((previousById.get(container.id)?.elements ?? []).map(({ id })=>id));
+        for (const element of container.elements)if (!previousElementIds.has(element.id)) appendClaim(claims, containerKind, container.id, element);
+    }
+}
+function appendClaim(claims, containerKind, containerId, element) {
+    const serialized = canonicalWorkOfficeCollaborationJson({
+        containerId,
+        containerKind,
+        fingerprint: canonicalWorkOfficeCollaborationJson(element),
+        id: element.id,
+        kind: 'element'
+    });
+    if (!claims.toArray().includes(serialized)) claims.push([
+        serialized
+    ]);
+}
+function parsedClaim(raw) {
+    if ('string' != typeof raw) invalidWorkOfficePresentationShared('record claim');
+    let value;
+    try {
+        value = JSON.parse(raw);
+    } catch  {
+        invalidWorkOfficePresentationShared('record claim');
+    }
+    if (!isWorkOfficeCollaborationRecord(value) || canonicalWorkOfficeCollaborationJson(value) !== raw) invalidWorkOfficePresentationShared('record claim');
+    if (Object.keys(value).some((key)=>'containerId' !== key && 'containerKind' !== key && 'fingerprint' !== key && 'id' !== key && 'kind' !== key)) invalidWorkOfficePresentationShared('record claim');
+    if ('element' !== value.kind) invalidWorkOfficePresentationShared('record claim kind');
+    const containerKind = requiredContainerKind(value.containerKind);
+    const containerId = office_presentation_collaboration_claims_requiredIdentifier(value.containerId, 'record claim container');
+    const id = office_presentation_collaboration_claims_requiredIdentifier(value.id, 'record claim');
+    const fingerprint = office_presentation_collaboration_claims_requiredString(value.fingerprint, 'record claim fingerprint');
+    let claimed;
+    try {
+        claimed = JSON.parse(fingerprint);
+    } catch  {
+        invalidWorkOfficePresentationShared('record claim fingerprint');
+    }
+    if (!isWorkOfficeCollaborationRecord(claimed) || canonicalWorkOfficeCollaborationJson(claimed) !== fingerprint || claimed.id !== id || 'string' != typeof claimed.type) invalidWorkOfficePresentationShared('record claim fingerprint');
+    return {
+        containerId,
+        containerKind,
+        fingerprint,
+        id,
+        kind: 'element'
+    };
+}
+function assertClaimedElementIdentities(claims, containerKind, containers) {
+    for (const container of containers)for (const element of container.elements){
+        const fingerprint = claims.get(claimIdentity(containerKind, container.id, element.id));
+        if (void 0 === fingerprint) continue;
+        let claimed;
+        try {
+            claimed = JSON.parse(fingerprint);
+        } catch  {
+            invalidWorkOfficePresentationShared('record claim fingerprint');
+        }
+        if (!isWorkOfficeCollaborationRecord(claimed) || claimed.id !== element.id || claimed.type !== element.type) invalidWorkOfficePresentationShared('scene element immutable identity claim');
+    }
+}
+function requiredContainerKind(value) {
+    if ('layout' === value || 'master' === value || 'slide' === value) return value;
+    invalidWorkOfficePresentationShared('record claim container kind');
+}
+function office_presentation_collaboration_claims_requiredIdentifier(value, label) {
+    const result = office_presentation_collaboration_claims_requiredString(value, label);
+    if (!result || result !== result.trim() || result.length > 256) invalidWorkOfficePresentationShared(label);
+    return result;
+}
+function office_presentation_collaboration_claims_requiredString(value, label) {
+    if ('string' != typeof value) invalidWorkOfficePresentationShared(label);
+    return value;
+}
+function claimIdentity(containerKind, containerId, id) {
+    return canonicalWorkOfficeCollaborationJson([
+        containerKind,
+        containerId,
+        id
+    ]);
+}
 const PRESENTATION_RECORD_ELEMENTS = 'elements';
 const PRESENTATION_RECORD_ELEMENT_ORDER = 'elementOrder';
 const PRESENTATION_RECORD_COMMENTS = 'comments';
 const PRESENTATION_RECORD_COMMENT_ORDER = 'commentOrder';
 const PRESENTATION_RECORD_COMMENTS_PRESENT = 'commentsPresent';
+const PRESENTATION_RECORD_TOMBSTONE = 'tombstone';
 function nestedPresentationMap(parent, key, label) {
     const existing = parent.get(key);
     if (existing instanceof __rspack_external_yjs.Map) return existing;
@@ -162,7 +267,7 @@ function requiredPresentationArray(parent, key, label) {
     if (!(value instanceof __rspack_external_yjs.Array)) invalidWorkOfficePresentationShared(label);
     return value;
 }
-function validatedPresentationOrder(order, records, label) {
+function validatedPresentationOrder(order, records, label, allowTombstones = false) {
     const seen = new Set();
     const values = [];
     for (const value of order.toArray()){
@@ -172,7 +277,20 @@ function validatedPresentationOrder(order, records, label) {
             values.push(value);
         }
     }
-    if (seen.size !== records.size || Array.from(records.keys()).some((id)=>!seen.has(id))) invalidWorkOfficePresentationShared(`${label} order and record set`);
+    for (const id of seen){
+        const record = records.get(id);
+        if (!(record instanceof __rspack_external_yjs.Map)) invalidWorkOfficePresentationShared(`${label} order and record set`);
+        if (void 0 !== record.get(PRESENTATION_RECORD_TOMBSTONE)) invalidWorkOfficePresentationShared(`${label} order and record set`);
+    }
+    for (const [id, value] of records.entries()){
+        if (!(value instanceof __rspack_external_yjs.Map)) invalidWorkOfficePresentationShared(`${label} order and record set`);
+        const tombstone = value.get(PRESENTATION_RECORD_TOMBSTONE);
+        if (void 0 === tombstone) {
+            if (!seen.has(id)) invalidWorkOfficePresentationShared(`${label} order and record set`);
+            continue;
+        }
+        if (!allowTombstones || true !== tombstone || seen.has(id)) invalidWorkOfficePresentationShared(`${label} order and record set`);
+    }
     return values;
 }
 function readPresentationCollection(records, order, label) {
@@ -191,15 +309,15 @@ function readPresentationCollection(records, order, label) {
             }
         }
         if (value.id !== id) invalidWorkOfficePresentationShared(`${label} identity`);
-        value.elements = readIdRecords(requiredPresentationMap(record, PRESENTATION_RECORD_ELEMENTS, `${label} elements`), requiredPresentationArray(record, PRESENTATION_RECORD_ELEMENT_ORDER, `${label} element order`), `${label} element`);
+        value.elements = readIdRecords(requiredPresentationMap(record, PRESENTATION_RECORD_ELEMENTS, `${label} elements`), requiredPresentationArray(record, PRESENTATION_RECORD_ELEMENT_ORDER, `${label} element order`), `${label} element`, true);
         if ('slide' === label) readSlideComments(record, value);
         return value;
     });
 }
 function patchPresentationElements(records, order, previous, next, parentLabel) {
-    patchPresentationIdRecords(records, order, previous, next, `${parentLabel} element`);
+    patchPresentationIdRecords(records, order, previous, next, `${parentLabel} element`, true);
 }
-function patchPresentationIdRecords(records, order, previous, next, label) {
+function patchPresentationIdRecords(records, order, previous, next, label, durableTombstones = false) {
     const previousById = new Map(previous.map((value)=>[
             value.id,
             value
@@ -208,7 +326,19 @@ function patchPresentationIdRecords(records, order, previous, next, label) {
             value.id,
             value
         ]));
-    for (const value of previous)if (!nextById.has(value.id)) records.delete(value.id);
+    for (const value of previous){
+        if (nextById.has(value.id)) continue;
+        if (!durableTombstones) {
+            records.delete(value.id);
+            continue;
+        }
+        const record = records.get(value.id);
+        if (void 0 === record) continue;
+        if (!(record instanceof __rspack_external_yjs.Map)) invalidWorkOfficePresentationShared(label);
+        const tombstone = record.get(PRESENTATION_RECORD_TOMBSTONE);
+        if (void 0 !== tombstone && true !== tombstone) invalidWorkOfficePresentationShared(`${label} tombstone`);
+        record.set(PRESENTATION_RECORD_TOMBSTONE, true);
+    }
     for (const value of next){
         const before = previousById.get(value.id);
         if (before && workOfficeCollaborationJsonEqual(before, value)) continue;
@@ -218,6 +348,13 @@ function patchPresentationIdRecords(records, order, previous, next, label) {
             records.set(value.id, record);
         }
         if (!(record instanceof __rspack_external_yjs.Map)) invalidWorkOfficePresentationShared(label);
+        const tombstone = record.get(PRESENTATION_RECORD_TOMBSTONE);
+        if (void 0 !== tombstone) {
+            if (true !== tombstone) invalidWorkOfficePresentationShared(`${label} tombstone`);
+            if (!before) throw new WorkOfficeCollaborationError('office.collaboration.content_invalid', `The deleted scene element ID '${value.id}' cannot be reused.`);
+            continue;
+        }
+        if (durableTombstones && before && before.type !== value.type) throw new WorkOfficeCollaborationError('office.collaboration.content_invalid', `The scene element ID '${value.id}' cannot change type.`);
         patchPresentationJsonMap(record, before ?? {}, value);
     }
     patchPresentationOrder(order, previous.map((value)=>value.id), next.map((value)=>value.id));
@@ -246,12 +383,21 @@ function readSlideComments(record, value) {
     if (commentRecords.size > 0 || commentOrder.length > 0) value.comments = readIdRecords(commentRecords, commentOrder, 'slide comment');
     else if (true === record.get(PRESENTATION_RECORD_COMMENTS_PRESENT)) value.comments = [];
 }
-function readIdRecords(records, order, label) {
-    return validatedPresentationOrder(order, records, label).map((id)=>readJsonMap(requiredPresentationMap(records, id, label), id, label));
+function readIdRecords(records, order, label, allowTombstones = false) {
+    const activeIds = validatedPresentationOrder(order, records, label, allowTombstones);
+    if (allowTombstones) for (const [id, value] of records.entries()){
+        if (!(value instanceof __rspack_external_yjs.Map)) invalidWorkOfficePresentationShared(label);
+        if (true === value.get(PRESENTATION_RECORD_TOMBSTONE)) readJsonMap(value, id, label, true);
+    }
+    return activeIds.map((id)=>readJsonMap(requiredPresentationMap(records, id, label), id, label));
 }
-function readJsonMap(record, expectedId, label) {
+function readJsonMap(record, expectedId, label, tombstoned = false) {
     const value = {};
     for (const [key, item] of record.entries()){
+        if (key === PRESENTATION_RECORD_TOMBSTONE) {
+            if (!tombstoned || true !== item) invalidWorkOfficePresentationShared(`${label} tombstone`);
+            continue;
+        }
         if (item instanceof __rspack_external_yjs.AbstractType) invalidWorkOfficePresentationShared(`${label} field '${key}'`);
         value[key] = cloneWorkOfficeCollaborationJson(item);
     }
@@ -299,6 +445,7 @@ const PRESENTATION_MASTERS_ROOT = 'presentation.masters';
 const PRESENTATION_MASTER_ORDER_ROOT = 'presentation.master-order';
 const PRESENTATION_LAYOUTS_ROOT = 'presentation.layouts';
 const PRESENTATION_LAYOUT_ORDER_ROOT = 'presentation.layout-order';
+const PRESENTATION_RECORD_CLAIMS_ROOT = 'presentation.record-claims';
 function workOfficePresentationRoots(document, rootName) {
     return {
         options: document.getMap(rootName(PRESENTATION_OPTIONS_ROOT)),
@@ -307,10 +454,12 @@ function workOfficePresentationRoots(document, rootName) {
         masters: document.getMap(rootName(PRESENTATION_MASTERS_ROOT)),
         masterOrder: document.getArray(rootName(PRESENTATION_MASTER_ORDER_ROOT)),
         layouts: document.getMap(rootName(PRESENTATION_LAYOUTS_ROOT)),
-        layoutOrder: document.getArray(rootName(PRESENTATION_LAYOUT_ORDER_ROOT))
+        layoutOrder: document.getArray(rootName(PRESENTATION_LAYOUT_ORDER_ROOT)),
+        recordClaims: document.getArray(rootName(PRESENTATION_RECORD_CLAIMS_ROOT))
     };
 }
 function initializeWorkOfficePresentationRoots(roots, content) {
+    appendWorkOfficePresentationRecordClaims(roots.recordClaims, void 0, content);
     patchOptionalJson(roots.options, 'width', void 0, content.width);
     patchOptionalJson(roots.options, 'height', void 0, content.height);
     patchCollection({
@@ -348,11 +497,14 @@ function readWorkOfficePresentationRoots(roots) {
     const layouts = readPresentationCollection(roots.layouts, roots.layoutOrder, 'presentation layout');
     if (masters.length > 0) result.masters = masters;
     if (layouts.length > 0) result.layouts = layouts;
-    return validateSharedWorkOfficePresentationContent(result);
+    const validated = validateSharedWorkOfficePresentationContent(result);
+    assertWorkOfficePresentationRecordClaims(roots.recordClaims, validated);
+    return validated;
 }
 function patchWorkOfficePresentationRoots(roots, previous, next) {
     const shared = readWorkOfficePresentationRoots(roots);
     assertChangedRecordsStillExist(previous, next, shared);
+    appendWorkOfficePresentationRecordClaims(roots.recordClaims, previous, next);
     patchOptionalJson(roots.options, 'width', previous.width, next.width);
     patchOptionalJson(roots.options, 'height', previous.height, next.height);
     patchCollection({
@@ -413,7 +565,7 @@ function assertChangedChildRecordsExist(previous, next, shared, label) {
     }
 }
 function assertWorkOfficePresentationRootsEmpty(roots) {
-    if (roots.options.size > 0 || roots.slides.size > 0 || roots.slideOrder.length > 0 || roots.masters.size > 0 || roots.masterOrder.length > 0 || roots.layouts.size > 0 || roots.layoutOrder.length > 0) throw new WorkOfficeCollaborationError('office.collaboration.bootstrap_ambiguous', 'The Presentation collaboration roots contain data without initialized metadata.');
+    if (roots.options.size > 0 || roots.slides.size > 0 || roots.slideOrder.length > 0 || roots.masters.size > 0 || roots.masterOrder.length > 0 || roots.layouts.size > 0 || roots.layoutOrder.length > 0 || roots.recordClaims.length > 0) throw new WorkOfficeCollaborationError('office.collaboration.bootstrap_ambiguous', 'The Presentation collaboration roots contain data without initialized metadata.');
 }
 function workOfficePresentationUndoScope(roots) {
     return [
@@ -423,7 +575,8 @@ function workOfficePresentationUndoScope(roots) {
         roots.masters,
         roots.masterOrder,
         roots.layouts,
-        roots.layoutOrder
+        roots.layoutOrder,
+        roots.recordClaims
     ];
 }
 function patchCollection({ label, order, previous, records, next }) {

package/dist/internal/collaboration/office-presentation-collaboration-claims.d.ts

@@ -0,0 +1,5 @@
+import type * as Y from 'yjs';
+import type { WorkPresentationContent } from '../features/work/work-types';
+export type WorkOfficePresentationContainerKind = 'layout' | 'master' | 'slide';
+export declare function appendWorkOfficePresentationRecordClaims(claims: Y.Array<string>, previous: WorkPresentationContent | undefined, next: WorkPresentationContent): void;
+export declare function assertWorkOfficePresentationRecordClaims(claims: Y.Array<string>, content: WorkPresentationContent): void;

package/dist/internal/collaboration/office-presentation-collaboration-model.d.ts

@@ -8,6 +8,7 @@ export declare const PRESENTATION_MASTERS_ROOT = "presentation.masters";
 export declare const PRESENTATION_MASTER_ORDER_ROOT = "presentation.master-order";
 export declare const PRESENTATION_LAYOUTS_ROOT = "presentation.layouts";
 export declare const PRESENTATION_LAYOUT_ORDER_ROOT = "presentation.layout-order";
+export declare const PRESENTATION_RECORD_CLAIMS_ROOT = "presentation.record-claims";
 export interface WorkOfficePresentationRoots {
     options: Y.Map<unknown>;
     slides: Y.Map<unknown>;
@@ -16,6 +17,7 @@ export interface WorkOfficePresentationRoots {
     masterOrder: Y.Array<string>;
     layouts: Y.Map<unknown>;
     layoutOrder: Y.Array<string>;
+    recordClaims: Y.Array<string>;
 }
 export declare function workOfficePresentationRoots(document: Y.Doc, rootName: (suffix: string) => string): WorkOfficePresentationRoots;
 export declare function initializeWorkOfficePresentationRoots(roots: WorkOfficePresentationRoots, content: WorkPresentationContent): void;

package/dist/internal/collaboration/office-presentation-collaboration-records.d.ts

@@ -5,6 +5,7 @@ export declare const PRESENTATION_RECORD_ELEMENT_ORDER = "elementOrder";
 export declare const PRESENTATION_RECORD_COMMENTS = "comments";
 export declare const PRESENTATION_RECORD_COMMENT_ORDER = "commentOrder";
 export declare const PRESENTATION_RECORD_COMMENTS_PRESENT = "commentsPresent";
+export declare const PRESENTATION_RECORD_TOMBSTONE = "tombstone";
 export type WorkOfficePresentationRecord = {
     id: string;
     elements: WorkSlideElement[];
@@ -13,10 +14,10 @@ export declare function nestedPresentationMap(parent: Y.Map<unknown>, key: strin
 export declare function nestedPresentationArray(parent: Y.Map<unknown>, key: string, label: string): Y.Array<string>;
 export declare function requiredPresentationMap(parent: Y.Map<unknown>, key: string, label: string): Y.Map<unknown>;
 export declare function requiredPresentationArray(parent: Y.Map<unknown>, key: string, label: string): Y.Array<string>;
-export declare function validatedPresentationOrder(order: Y.Array<string>, records: Y.Map<unknown>, label: string): string[];
+export declare function validatedPresentationOrder(order: Y.Array<string>, records: Y.Map<unknown>, label: string, allowTombstones?: boolean): string[];
 export declare function readPresentationCollection(records: Y.Map<unknown>, order: Y.Array<string>, label: string): WorkOfficePresentationRecord[];
 export declare function patchPresentationElements(records: Y.Map<unknown>, order: Y.Array<string>, previous: WorkSlideElement[], next: WorkSlideElement[], parentLabel: string): void;
 export declare function patchPresentationIdRecords<T extends {
     id: string;
-}>(records: Y.Map<unknown>, order: Y.Array<string>, previous: T[], next: T[], label: string): void;
+}>(records: Y.Map<unknown>, order: Y.Array<string>, previous: T[], next: T[], label: string, durableTombstones?: boolean): void;
 export declare function patchPresentationOrder(order: Y.Array<string>, previous: string[], next: string[]): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Open-source browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -87,8 +87,8 @@
     "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-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": "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 && a3s-test run tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test run tests/e2e/collaboration-presentation-elements.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 && a3s-test check tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test check tests/e2e/collaboration-presentation-elements.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",
@@ -96,6 +96,10 @@
     "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:collaboration-spreadsheet-cells": "a3s-test run tests/e2e/collaboration-spreadsheet-cells.acl --json",
+    "test:e2e:collaboration-spreadsheet-cells:check": "a3s-test check tests/e2e/collaboration-spreadsheet-cells.acl --json",
+    "test:e2e:collaboration-presentation-elements": "a3s-test run tests/e2e/collaboration-presentation-elements.acl --json",
+    "test:e2e:collaboration-presentation-elements:check": "a3s-test check tests/e2e/collaboration-presentation-elements.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",