@ai-matrx/office 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.7.0
+
+New `./collab/sheets-transform` entry: the co-editing transformer for workbook edits (COLLAB-DESIGN unit C5a). Pure functions, no runtime wiring: nothing calls it until the Sheets flip (C6).
+
+- `transformGroup(x, y, side)` rewrites command group `x` to apply after `y`. The later-committed op takes `"left"`: it wins overwrites and sits first on position ties. It returns `{ op, lost, dropped }` or a `Barrier`. `sheetTransformer` is the same thing as an `OpTransformer` for the C2 session.
+- Covered: cell values and styles (`set-range-values`; style keys and border sides merge per key), row and column insert, remove and move, merge and unmerge (including the merge fixups structural commands emit), row height, auto-height and column width, worksheet name.
+- `SHEET_MUTATIONS` classifies all 116 mutation ids Univer 1.0.4 can emit into a workbook: 14 covered (with params allowlists), 26 never travel, 76 barriers (sort, row/column counts, sheet order, cut-paste, sheet-level settings and visibility are X; formulas wait for C5b, ranged resources for C5c). A census test fails on any unclassified or stale id. Regenerate the census with `node scripts/census-sheet-mutations.mjs` after a Univer bump.
+- Two capture rules for C6, enforced as barriers when broken. `completeCellContent(entry, postCell)` must complete every content write from the sender's post-state. `exactMergeRemovals(group, mergesBefore)` must replace unmerge selections with the exact merges they remove.
+- `lost` names parts of the other op this one overrode, for the other author's notice. `dropped` names parts of this op that cannot apply, for its own author's notice.
+- Evidence: a pairwise TP1 fuzz over 13 command families (91 pairs), on shapes captured from real Univer 1.0.4 commands and judged by the canonical state hash. 4,000 seeds per pair, both commit orders: 728,000 checks, 0 divergences, 0 throws. Moves of partly overlapping blocks return a barrier: 1,540 of 8,000 row-move pairs and 1,478 of 8,000 column-move pairs. Reproduce with `SHEET_FUZZ_SEEDS=4000 pnpm vitest run src/collab/sheets/transform/sheet-transform-fuzz.test.ts`; the default test run uses 150 seeds.
+
+New dependency `@univerjs/sheets` 1.0.4 (for its range helper). `@univerjs/engine-formula` and `@univerjs/engine-render` are dev-only, for the headless test seats.
+
+### Consumer action
+
+None. The entry is inert until C6 wires it.
+
+## 0.6.1
+
+Fix: the collab room relayed two things it must not. (1) Mutations Univer marks `onlyLocal` (formula-engine recalculation results, which every seat computes itself) were logged and sent, so every recalculation became network traffic. (2) The sender's view-only params (`layoutState`, `textRanges`, `prevTextRanges`) travelled with a document edit and the receiver restored the sender's layout and caret. Both now stay home, for Docs and Workbooks (one session). `DocumentModel` passes Univer's execution options to its collab listeners. New exports from the collab session: `stripSenderView`, `SENDER_VIEW_PARAMS`.
+
 ## 0.6.0
 
 Fix: two-seat co-editing corrupted the saved document on reload. Live, both screens showed the same clean text; after a reload the stored version showed it twice or interleaved, and the next reload scrambled it further. Cause: the Docs model never trimmed the room's shared mutation log, so a reloading seat booted from the newest saved snapshot (which already held every edit) and then replayed the whole log on top of it; it then saved that. Workbooks trimmed the log by POSITION after the save, which could drop an entry that arrived while the save was in flight, and a seat that read a snapshot older than the trim lost edits.