@a3s-lab/office 0.8.1 → 0.9.0

package/COLLABORATION_ROADMAP.md

@@ -247,9 +247,9 @@ comments, and delete-vs-edit cases converge and survive PPTX round trips.
 
 ### Phase 4: Spreadsheet
 
-Status: browser collaboration foundation and native conflict-local cell
-mutations implemented; structural operations, native recalculation parity, and
-XLSX concurrency coverage are pending.
+Status: browser collaboration foundation plus native conflict-local single-cell
+and atomic batch-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.
@@ -282,11 +282,16 @@ XLSX concurrency coverage are pending.
   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.
+- `spreadsheet-batch-cells` translates one paste, fill, or other bounded user
+  gesture into 1 to 4,096 distinct coordinates in one sheet and one Yjs
+  transaction. Set/create changes retain recursive optimistic guards; delete
+  changes require an exact complete observed cell. Every change is preflighted
+  against one shared sheet snapshot, so one conflict rejects the entire batch
+  without partial fields, presence markers, dense dimensions, or durable log
+  growth. Single-cell mutations use this same kernel.
 
 Remaining:
 
-- Translate one user gesture into one transaction; batch paste/fill/sort/filter
-  without emitting a document-sized replacement.
 - Add stable structural operations and reference transforms for row/column
   insertion/deletion, merged ranges, tables, sort, and named references.
 - Treat calculated values as derived once browser and native recalculation are
@@ -461,9 +466,10 @@ are pending.
   without replacing the full document.
 - 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.
+  an exact complete-cell match. `spreadsheet-batch-cells` applies 1 to 4,096
+  distinct changes from one sheet snapshot in one transaction. 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, 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

package/README.md

@@ -144,7 +144,7 @@ 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, Spreadsheet cell,
+  vectors, perform authorized typed Markdown, Document, Spreadsheet cell/batch,
   Presentation scene-element and z-order, and PDF annotation, form-value, and
   review changes, including attributable Document selection comments, replies,
   text suggestions, and atomic final decisions, retain browser/native actor
@@ -1109,6 +1109,13 @@ cargo run -p a3s-office-cli -- collab mutate .a3s/plan.replica \
   --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
 
+# Apply one bounded Spreadsheet gesture atomically. Coordinates must be unique;
+# nextCell:null is an exact guarded delete.
+cargo run -p a3s-office-cli -- collab mutate .a3s/plan.replica \
+  --artifact-id plan --kind spreadsheet --actor-id agent-7 --mode edit \
+  --operation-id paste-46 \
+  --mutation '{"type":"spreadsheet-batch-cells","sheetId":"sheet-data","changes":[{"row":1,"column":0,"expectedCell":{"v":12,"m":"12","f":"=6*2"},"nextCell":{"v":14,"m":"14","f":"=7*2"}},{"row":1,"column":1,"expectedCell":null,"nextCell":{"v":20,"m":"20"}},{"row":2,"column":0,"expectedCell":{"v":"obsolete","m":"obsolete"},"nextCell":null}]}' --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 \
@@ -1197,7 +1204,11 @@ 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
+empty sheets remain sparse. `spreadsheet-batch-cells` applies 1 to 4,096
+distinct coordinates in one sheet after checking every guard against the same
+snapshot, then writes fields, presence markers, and dense dimensions in one
+Yjs transaction. One conflict rejects the complete gesture without a durable
+event. 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
@@ -1309,6 +1320,7 @@ 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.9.0 documentation](https://a3s-lab.github.io/Office/docs/0.9.0/)
 - [A3S Office 0.8.1 documentation](https://a3s-lab.github.io/Office/docs/0.8.1/)
 - [A3S Office 0.8.0 documentation](https://a3s-lab.github.io/Office/docs/0.8.0/)
 - [A3S Office 0.7.3 documentation](https://a3s-lab.github.io/Office/docs/0.7.3/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",