@rowsncolumns/y-spreadsheet 15.1.0 → 16.1.0-beta.0

package/dist/cjs/use-yspreadsheet-v2.js

@@ -7,8 +7,8 @@ var utils_1 = require("@rowsncolumns/utils");
 var ui_1 = require("@rowsncolumns/ui");
 var react_1 = require("react");
 var react_dom_1 = require("react-dom");
-var Y = tslib_1.__importStar(require("yjs"));
 var helpers_1 = require("./helpers");
+var yjs_runtime_1 = require("./yjs-runtime");
 /**
  * Convert Y.js events to SheetDataEvent format for incremental processing
  */
@@ -57,10 +57,11 @@ var observables_1 = require("./observables");
 // Add a single null entry to the YSheetData
 var origin = "local";
 var useYSpreadsheetV2 = function (_a) {
-    var onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeCharts = _a.onChangeCharts, onChangeEmbeds = _a.onChangeEmbeds, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeCitations = _a.onChangeCitations, onAfterBroadcastPatch = _a.onAfterBroadcastPatch, recalcCellsMaxEntries = _a.recalcCellsMaxEntries, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeProtectedRanges = _a.onChangeProtectedRanges, onChangePivotTables = _a.onChangePivotTables, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, reevaluateDerivationsForCells = _a.reevaluateDerivationsForCells, onChangeCellXfs = _a.onChangeCellXfs, onChangeSharedStrings = _a.onChangeSharedStrings, calculateNow = _a.calculateNow, onChangeActiveSheet = _a.onChangeActiveSheet, clientOnlyFunctionPattern = _a.clientOnlyFunctionPattern, initialSheets = _a.initialSheets, awarenessScopeId = _a.awarenessScopeId, _b = _a.canWrite, canWrite = _b === void 0 ? true : _b, userId = _a.userId, title = _a.title, sheetId = _a.sheetId, activeCell = _a.activeCell, kind = _a.kind, agentInitiator = _a.agentInitiator, selections = _a.selections, doc = _a.doc, provider = _a.provider, _c = _a.yjs, yjs = _c === void 0 ? Y : _c, _d = _a.useV3, useV3 = _d === void 0 ? false : _d, _e = _a.sheetDataVersion, sheetDataVersion = _e === void 0 ? "v2" : _e, onMigrationComplete = _a.onMigrationComplete, _f = _a.deleteV2AfterMigration, deleteV2AfterMigration = _f === void 0 ? false : _f, _g = _a.skipInitialSync, skipInitialSync = _g === void 0 ? false : _g, _h = _a.supportLegacySharedStringsArray, supportLegacySharedStringsArray = _h === void 0 ? false : _h;
-    var _j = tslib_1.__read((0, react_1.useState)(false), 2), synced = _j[0], setSynced = _j[1];
-    var _k = tslib_1.__read((0, react_1.useState)([]), 2), users = _k[0], setUsers = _k[1];
-    var _l = tslib_1.__read((0, react_1.useState)(false), 2), isLeader = _l[0], setIsLeader = _l[1];
+    var onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeCharts = _a.onChangeCharts, onChangeEmbeds = _a.onChangeEmbeds, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeCitations = _a.onChangeCitations, onAfterBroadcastPatch = _a.onAfterBroadcastPatch, recalcCellsMaxEntries = _a.recalcCellsMaxEntries, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeProtectedRanges = _a.onChangeProtectedRanges, onChangePivotTables = _a.onChangePivotTables, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, reevaluateDerivationsForCells = _a.reevaluateDerivationsForCells, onChangeCellXfs = _a.onChangeCellXfs, onChangeSharedStrings = _a.onChangeSharedStrings, calculateNow = _a.calculateNow, onChangeActiveSheet = _a.onChangeActiveSheet, clientOnlyFunctionPattern = _a.clientOnlyFunctionPattern, initialSheets = _a.initialSheets, awarenessScopeId = _a.awarenessScopeId, _b = _a.canWrite, canWrite = _b === void 0 ? true : _b, userId = _a.userId, title = _a.title, sheetId = _a.sheetId, activeCell = _a.activeCell, kind = _a.kind, agentInitiator = _a.agentInitiator, selections = _a.selections, doc = _a.doc, provider = _a.provider, yjsRuntime = _a.yjs, _c = _a.useV3, useV3 = _c === void 0 ? false : _c, _d = _a.sheetDataVersion, sheetDataVersion = _d === void 0 ? "v2" : _d, onMigrationComplete = _a.onMigrationComplete, _e = _a.deleteV2AfterMigration, deleteV2AfterMigration = _e === void 0 ? false : _e, _f = _a.skipInitialSync, skipInitialSync = _f === void 0 ? false : _f, _g = _a.supportLegacySharedStringsArray, supportLegacySharedStringsArray = _g === void 0 ? false : _g;
+    var yjs = (0, yjs_runtime_1.resolveYjsRuntime)(yjsRuntime);
+    var _h = tslib_1.__read((0, react_1.useState)(false), 2), synced = _h[0], setSynced = _h[1];
+    var _j = tslib_1.__read((0, react_1.useState)([]), 2), users = _j[0], setUsers = _j[1];
+    var _k = tslib_1.__read((0, react_1.useState)(false), 2), isLeader = _k[0], setIsLeader = _k[1];
     var isLeaderRef = (0, react_1.useRef)(false);
     var resolvedAwarenessScopeId = awarenessScopeId;
     // Listen to awareness
@@ -109,6 +110,18 @@ var useYSpreadsheetV2 = function (_a) {
     var ySheetDataV3 = (0, react_1.useMemo)(function () { return doc.getMap("sheetDataV3"); }, [doc]);
     // Doc metadata - used as fallback for version when prop is undefined
     var yDocMeta = (0, react_1.useMemo)(function () { return doc.getMap("docMeta"); }, [doc]);
+    // V5: the engine marks the doc in `docMeta`; read live (the marker may arrive with a sync)
+    var isV5Doc = (0, react_1.useCallback)(function () {
+        return sheetDataVersion === "v5" || yDocMeta.get("sheetDataVersion") === "v5";
+    }, [sheetDataVersion, yDocMeta]);
+    // V5: the composed style plane, folded on a full read and on a remote style
+    // change, updated in place by this hook's own writes
+    var stylesV5Ref = (0, react_1.useRef)(null);
+    var stylesV5 = (0, react_1.useCallback)(function () { var _a; return ((_a = stylesV5Ref.current) !== null && _a !== void 0 ? _a : (stylesV5Ref.current = (0, helpers_1.readStyleOverlayV5)(doc))); }, [doc]);
+    var readSheetDataV5 = (0, react_1.useCallback)(function () {
+        stylesV5Ref.current = (0, helpers_1.readStyleOverlayV5)(doc);
+        return (0, helpers_1.sheetDataV5ToV2)(doc, stylesV5Ref.current);
+    }, [doc]);
     var yDisableRecalc = (0, react_1.useMemo)(function () { return doc.getMap("disableRecalc"); }, [doc]);
     // Recalc cells
     var yRecalcCells = (0, react_1.useMemo)(function () { return doc.getArray("recalcCells"); }, [doc]);
@@ -260,6 +273,7 @@ var useYSpreadsheetV2 = function (_a) {
     // Trigger cell recalcs
     var syncRecalcCells = (0, react_1.useCallback)(function (recalcCells, origin) {
         var e_2, _a;
+        var readV5 = isV5Doc() ? (0, helpers_1.createCellReaderV5)(doc, stylesV5()) : null;
         try {
             for (var recalcCells_1 = tslib_1.__values(recalcCells), recalcCells_1_1 = recalcCells_1.next(); !recalcCells_1_1.done; recalcCells_1_1 = recalcCells_1.next()) {
                 var _b = tslib_1.__read(recalcCells_1_1.value, 3), _1 = _b[0], position = _b[1], source = _b[2];
@@ -267,9 +281,11 @@ var useYSpreadsheetV2 = function (_a) {
                 var isAgent = source === "agent"; // Agent already does the calculation
                 // Read directly from Y.js to avoid race condition where recalcCells
                 // observer fires before sheetData observer has updated React state
-                var formulaValue = useV3
-                    ? getUserEnteredValueFromYDocV3(ySheetDataV3, position.sheetId, position.rowIndex, position.columnIndex)
-                    : getUserEnteredValueFromYDoc(ySheetDataV2, position.sheetId, position.rowIndex, position.columnIndex);
+                var formulaValue = readV5
+                    ? (0, utils_1.getExtendedValueFormula)((0, utils_1.getCellUserEnteredValue)(readV5(position.sheetId, position.rowIndex, position.columnIndex)))
+                    : useV3
+                        ? getUserEnteredValueFromYDocV3(ySheetDataV3, position.sheetId, position.rowIndex, position.columnIndex)
+                        : getUserEnteredValueFromYDoc(ySheetDataV2, position.sheetId, position.rowIndex, position.columnIndex);
                 // Was this from a changeBatch event in the back-end?
                 // To support client functions to run only
                 var isChangeBatch = position.force && isAgent;
@@ -337,6 +353,9 @@ var useYSpreadsheetV2 = function (_a) {
         ySheetDataV3,
         useV3,
         reevaluateDerivationsForCells,
+        isV5Doc,
+        doc,
+        stylesV5,
     ]);
     // Setup initial sync
     var setupInitialSync = (0, react_1.useCallback)(function () {
@@ -393,8 +412,12 @@ var useYSpreadsheetV2 = function (_a) {
             }
             finally { if (e_3) throw e_3.error; }
         }
-        // Load sheet data based on V2 or V3 mode
-        if (useV3) {
+        // Load sheet data based on V2, V3 or V5 mode
+        if (isV5Doc()) {
+            // V5: hot plane keyed by line ids; never migrated to V3
+            onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(readSheetDataV5());
+        }
+        else if (useV3) {
             // Check if we need to migrate from V2 to V3
             // Use prop if provided, otherwise fall back to yDocMeta for backwards compatibility
             var resolvedVersion = sheetDataVersion !== null && sheetDataVersion !== void 0 ? sheetDataVersion : yDocMeta.get("sheetDataVersion");
@@ -473,6 +496,8 @@ var useYSpreadsheetV2 = function (_a) {
         sheetDataVersion,
         onMigrationComplete,
         deleteV2AfterMigration,
+        isV5Doc,
+        readSheetDataV5,
     ]);
     /**
      * Replay the backend/agent recalc backlog into the local graph — and, on
@@ -615,6 +640,58 @@ var useYSpreadsheetV2 = function (_a) {
             ySheetDataV3.unobserve(callback);
         };
     }, [onChangeSheetData, ySheetDataV3, useV3]);
+    // Only for sheet Data (V5 docs): `rncCells`, `rncNotes`, the style planes and
+    // every sheet's id arrays. A change of an id array, a style plane (or of
+    // `docMeta`): full re-read; a cell or note change alone is applied
+    // incrementally. Roots are matched by name in `doc.share`, so a root a peer
+    // created after this effect ran is seen too.
+    (0, ui_1.useIsomorphicLayoutEffect)(function () {
+        var callback = function (transaction) {
+            var e_6, _a;
+            if (transaction.origin === "local" || !isV5Doc())
+                return;
+            var full = false;
+            var cellKeys = [];
+            try {
+                for (var _b = tslib_1.__values(doc.share), _c = _b.next(); !_c.done; _c = _b.next()) {
+                    var _d = tslib_1.__read(_c.value, 2), name_1 = _d[0], type = _d[1];
+                    var changed = transaction.changed.get(type);
+                    if (!changed)
+                        continue;
+                    if (name_1 === "rncCells" || name_1 === "rncNotes") {
+                        changed.forEach(function (key) { return key !== null && cellKeys.push(key); });
+                    }
+                    else if (name_1 === "docMeta" ||
+                        name_1 === "rncCellStylesLog" ||
+                        name_1 === "rncCellStyles" ||
+                        name_1.startsWith("rncRowIds:") ||
+                        name_1.startsWith("rncColIds:")) {
+                        full = true;
+                    }
+                }
+            }
+            catch (e_6_1) { e_6 = { error: e_6_1 }; }
+            finally {
+                try {
+                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                }
+                finally { if (e_6) throw e_6.error; }
+            }
+            if (full) {
+                onChangeSheetData(readSheetDataV5());
+            }
+            else if (cellKeys.length) {
+                onChangeSheetData(function (prevSheetData) {
+                    var _a;
+                    return (_a = (0, helpers_1.processSheetDataChangesV5)(cellKeys, prevSheetData, doc, stylesV5())) !== null && _a !== void 0 ? _a : prevSheetData;
+                });
+            }
+        };
+        doc.on("afterTransaction", callback);
+        return function () {
+            doc.off("afterTransaction", callback);
+        };
+    }, [doc, onChangeSheetData, isV5Doc, readSheetDataV5, stylesV5]);
     // CellXfs
     (0, ui_1.useIsomorphicLayoutEffect)(function () {
         // Subscribe to sheet data
@@ -632,16 +709,16 @@ var useYSpreadsheetV2 = function (_a) {
     }, [onChangeCellXfs, yCellXfs]);
     // All others
     (0, ui_1.useIsomorphicLayoutEffect)(function () {
-        var e_6, _a;
+        var e_7, _a;
         var subs = [];
         var _loop_1 = function (mappingKey, ydoc, callback) {
             // Only observe Arrays (shared strings Map is handled separately if needed)
             if (ydoc instanceof yjs.Array) {
                 var subscription = (0, observables_1.createDeepObservable)(ydoc).subscribe(function (events) {
-                    var e_7, _a;
+                    var e_8, _a;
                     var _b;
                     try {
-                        for (var events_1 = (e_7 = void 0, tslib_1.__values(events)), events_1_1 = events_1.next(); !events_1_1.done; events_1_1 = events_1.next()) {
+                        for (var events_1 = (e_8 = void 0, tslib_1.__values(events)), events_1_1 = events_1.next(); !events_1_1.done; events_1_1 = events_1.next()) {
                             var event_1 = events_1_1.value;
                             if (event_1.transaction.origin !== "local") {
                                 var json = ydoc.toJSON();
@@ -654,12 +731,12 @@ var useYSpreadsheetV2 = function (_a) {
                             }
                         }
                     }
-                    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+                    catch (e_8_1) { e_8 = { error: e_8_1 }; }
                     finally {
                         try {
                             if (events_1_1 && !events_1_1.done && (_a = events_1.return)) _a.call(events_1);
                         }
-                        finally { if (e_7) throw e_7.error; }
+                        finally { if (e_8) throw e_8.error; }
                     }
                 });
                 subs.push(subscription);
@@ -685,12 +762,12 @@ var useYSpreadsheetV2 = function (_a) {
                 _loop_1(mappingKey, ydoc, callback);
             }
         }
-        catch (e_6_1) { e_6 = { error: e_6_1 }; }
+        catch (e_7_1) { e_7 = { error: e_7_1 }; }
         finally {
             try {
                 if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
             }
-            finally { if (e_6) throw e_6.error; }
+            finally { if (e_7) throw e_7.error; }
         }
         return function () {
             subs.forEach(function (sub) { return sub.unsubscribe(); });
@@ -720,7 +797,7 @@ var useYSpreadsheetV2 = function (_a) {
         // Skip the first recalc cells change
         var sub = (0, observables_1.createObservable)(yRecalcCells).subscribe(onRecalcCellsChange);
         return function () {
-            var e_8, _a;
+            var e_9, _a;
             sub.unsubscribe();
             try {
                 for (var pending_1 = tslib_1.__values(pending), pending_1_1 = pending_1.next(); !pending_1_1.done; pending_1_1 = pending_1.next()) {
@@ -728,18 +805,18 @@ var useYSpreadsheetV2 = function (_a) {
                     clearTimeout(timer);
                 }
             }
-            catch (e_8_1) { e_8 = { error: e_8_1 }; }
+            catch (e_9_1) { e_9 = { error: e_9_1 }; }
             finally {
                 try {
                     if (pending_1_1 && !pending_1_1.done && (_a = pending_1.return)) _a.call(pending_1);
                 }
-                finally { if (e_8) throw e_8.error; }
+                finally { if (e_9) throw e_9.error; }
             }
         };
     }, [syncRecalcCells, recalcCellsMaxEntries, synced, yRecalcCells]);
     // Broadcast patch
     var onBroadcastPatch = (0, react_1.useCallback)(function (patches) {
-        var e_9, _a, e_10, _b;
+        var e_10, _a, e_11, _b;
         var _c;
         // Ignore push flag
         var disableRecalc = Boolean(patches.find(function (_a) {
@@ -775,12 +852,12 @@ var useYSpreadsheetV2 = function (_a) {
                     }
                 }
             }
-            catch (e_9_1) { e_9 = { error: e_9_1 }; }
+            catch (e_10_1) { e_10 = { error: e_10_1 }; }
             finally {
                 try {
                     if (patches_1_1 && !patches_1_1.done && (_a = patches_1.return)) _a.call(patches_1);
                 }
-                finally { if (e_9) throw e_9.error; }
+                finally { if (e_10) throw e_10.error; }
             }
             // Containment for this non-leader write path: an error may only
             // fill a cell with no effective value (the blank-after-reload case)
@@ -791,13 +868,19 @@ var useYSpreadsheetV2 = function (_a) {
             // write merges ONLY the error effective value into the existing doc
             // cell, preserving every other persisted field.
             var persistableErrorCellPatches_1 = [];
+            var isV5_1 = isV5Doc();
+            var readV5 = isV5_1 && errorCellPatches.length
+                ? (0, helpers_1.createCellReaderV5)(doc, stylesV5())
+                : null;
             try {
                 for (var errorCellPatches_1 = tslib_1.__values(errorCellPatches), errorCellPatches_1_1 = errorCellPatches_1.next(); !errorCellPatches_1_1.done; errorCellPatches_1_1 = errorCellPatches_1.next()) {
                     var errorPatch = errorCellPatches_1_1.value;
                     var _f = tslib_1.__read(errorPatch.path, 4), patchSheetId = _f[0], rowIndex = _f[1], columnIndex = _f[3];
-                    var currentCellData = useV3
-                        ? (_c = ySheetDataV3.get((0, helpers_1.createCellKeyV3)(Number(patchSheetId), Number(rowIndex), Number(columnIndex)))) === null || _c === void 0 ? void 0 : _c.value
-                        : (0, helpers_1.getCellDataFromYSheetData)(ySheetDataV2, patchSheetId, Number(rowIndex), Number(columnIndex));
+                    var currentCellData = readV5
+                        ? readV5(Number(patchSheetId), Number(rowIndex), Number(columnIndex))
+                        : useV3
+                            ? (_c = ySheetDataV3.get((0, helpers_1.createCellKeyV3)(Number(patchSheetId), Number(rowIndex), Number(columnIndex)))) === null || _c === void 0 ? void 0 : _c.value
+                            : (0, helpers_1.getCellDataFromYSheetData)(ySheetDataV2, patchSheetId, Number(rowIndex), Number(columnIndex));
                     var incomingCellData = errorPatch.value;
                     if (!(0, helpers_1.shouldPersistErrorCellPatch)(currentCellData, incomingCellData)) {
                         continue;
@@ -805,16 +888,19 @@ var useYSpreadsheetV2 = function (_a) {
                     persistableErrorCellPatches_1.push(tslib_1.__assign(tslib_1.__assign({}, errorPatch), { value: (0, helpers_1.mergeErrorEffectiveValueIntoCellData)(currentCellData, incomingCellData) }));
                 }
             }
-            catch (e_10_1) { e_10 = { error: e_10_1 }; }
+            catch (e_11_1) { e_11 = { error: e_11_1 }; }
             finally {
                 try {
                     if (errorCellPatches_1_1 && !errorCellPatches_1_1.done && (_b = errorCellPatches_1.return)) _b.call(errorCellPatches_1);
                 }
-                finally { if (e_10) throw e_10.error; }
+                finally { if (e_11) throw e_11.error; }
             }
             if (persistableErrorCellPatches_1.length) {
                 doc.transact(function () {
-                    if (useV3) {
+                    if (isV5_1) {
+                        (0, helpers_1.addSheetDataPatchesV5)(doc, persistableErrorCellPatches_1, origin, stylesV5());
+                    }
+                    else if (useV3) {
                         (0, helpers_1.addSheetDataPatchesV3)(ySheetDataV3, persistableErrorCellPatches_1);
                     }
                     else {
@@ -824,8 +910,9 @@ var useYSpreadsheetV2 = function (_a) {
             }
             return;
         }
+        var isV5 = isV5Doc();
         doc.transact(function () {
-            var e_11, _a, e_12, _b;
+            var e_12, _a, e_13, _b;
             var _c, _d, _e, _f;
             try {
                 for (var patches_2 = tslib_1.__values(patches), patches_2_1 = patches_2.next(); !patches_2_1.done; patches_2_1 = patches_2.next()) {
@@ -840,7 +927,10 @@ var useYSpreadsheetV2 = function (_a) {
                     var patchKey = type === "redo" ? "patches" : "inversePatches";
                     if (patch.sheetData) {
                         var patches_3 = (_c = patch.sheetData) === null || _c === void 0 ? void 0 : _c[patchKey];
-                        if (useV3) {
+                        if (isV5) {
+                            (0, helpers_1.addSheetDataPatchesV5)(doc, patches_3, origin, stylesV5());
+                        }
+                        else if (useV3) {
                             (0, helpers_1.addSheetDataPatchesV3)(ySheetDataV3, patches_3);
                         }
                         else {
@@ -852,7 +942,7 @@ var useYSpreadsheetV2 = function (_a) {
                         (0, helpers_1.applyMapPatches)(yCellXfs, patches_4);
                     }
                     try {
-                        for (var _j = (e_12 = void 0, tslib_1.__values(documentMap.entries())), _k = _j.next(); !_k.done; _k = _j.next()) {
+                        for (var _j = (e_13 = void 0, tslib_1.__values(documentMap.entries())), _k = _j.next(); !_k.done; _k = _j.next()) {
                             var _l = tslib_1.__read(_k.value, 2), mappingKey = _l[0], _m = tslib_1.__read(_l[1], 1), ydoc = _m[0];
                             if (patch === null || patch === void 0 ? void 0 : patch[mappingKey]) {
                                 var patches_5 = (_e = patch[mappingKey]) === null || _e === void 0 ? void 0 : _e[patchKey];
@@ -871,12 +961,12 @@ var useYSpreadsheetV2 = function (_a) {
                             }
                         }
                     }
-                    catch (e_12_1) { e_12 = { error: e_12_1 }; }
+                    catch (e_13_1) { e_13 = { error: e_13_1 }; }
                     finally {
                         try {
                             if (_k && !_k.done && (_b = _j.return)) _b.call(_j);
                         }
-                        finally { if (e_12) throw e_12.error; }
+                        finally { if (e_13) throw e_13.error; }
                     }
                     // Recalc cells
                     if ((_f = patch.recalcCells) === null || _f === void 0 ? void 0 : _f[type]) {
@@ -893,12 +983,12 @@ var useYSpreadsheetV2 = function (_a) {
                     }
                 }
             }
-            catch (e_11_1) { e_11 = { error: e_11_1 }; }
+            catch (e_12_1) { e_12 = { error: e_12_1 }; }
             finally {
                 try {
                     if (patches_2_1 && !patches_2_1.done && (_a = patches_2.return)) _a.call(patches_2);
                 }
-                finally { if (e_11) throw e_11.error; }
+                finally { if (e_12) throw e_12.error; }
             }
         }, origin);
         onAfterBroadcastPatch === null || onAfterBroadcastPatch === void 0 ? void 0 : onAfterBroadcastPatch(patches, doc);
@@ -915,6 +1005,8 @@ var useYSpreadsheetV2 = function (_a) {
         isLeader,
         recalcCellsMaxEntries,
         useV3,
+        isV5Doc,
+        stylesV5,
     ]);
     // Listen to active cell change
     (0, ui_1.useIsomorphicLayoutEffect)(function () {
@@ -935,7 +1027,7 @@ var useYSpreadsheetV2 = function (_a) {
     // Awareness
     (0, ui_1.useIsomorphicLayoutEffect)(function () {
         var onChangeAwareness = function () {
-            var e_13, _a;
+            var e_14, _a;
             var _b, _c, _d, _e, _f;
             if (awareness) {
                 var collaborators = [];
@@ -975,12 +1067,12 @@ var useYSpreadsheetV2 = function (_a) {
                         });
                     }
                 }
-                catch (e_13_1) { e_13 = { error: e_13_1 }; }
+                catch (e_14_1) { e_14 = { error: e_14_1 }; }
                 finally {
                     try {
                         if (_h && !_h.done && (_a = _g.return)) _a.call(_g);
                     }
-                    finally { if (e_13) throw e_13.error; }
+                    finally { if (e_14) throw e_14.error; }
                 }
                 setUsers(collaborators);
             }

package/dist/cjs/use-yspreadsheet.d.ts

@@ -3,7 +3,7 @@ import type { CellInterface } from "@rowsncolumns/grid";
 import type { CellData, Collaborator, ConditionalFormatRule, DataValidationRuleRecord, EmbeddedChart, EmbeddedObject, NamedRange, ProtectedRange, Sheet, TableView } from "@rowsncolumns/spreadsheet";
 import type { CalculateNowOptions, CalculationOperation, HistoryType, SheetData, SpreadsheetPatch } from "@rowsncolumns/spreadsheet-state";
 import type { Patch } from "immer";
-import * as Y from "yjs";
+import type * as Y from "yjs";
 import type { CollabProviderLike, YjsRuntime } from "./types";
 export type useYSpreadsheetProps<T extends CellData, S extends Sheet, C extends EmbeddedChart, O extends EmbeddedObject> = {
     userId: string | number;
@@ -12,7 +12,11 @@ export type useYSpreadsheetProps<T extends CellData, S extends Sheet, C extends
     activeCell?: CellInterface;
     provider?: HocuspocusProvider | CollabProviderLike | any;
     doc: Y.Doc;
-    /** The Yjs implementation `doc` belongs to; defaults to `yjs` (see `YjsRuntime`). */
+    /**
+     * The Yjs implementation `doc` belongs to, e.g. `import * as Y from "yjs"`.
+     * Falls back to the runtime registered with `setDefaultYjsRuntime`; with
+     * neither, the hook throws (see `YjsRuntime`).
+     */
     yjs?: YjsRuntime;
     calculateNow(options?: CalculateNowOptions): void;
     onChangeSheetData: React.Dispatch<React.SetStateAction<SheetData<T>>>;
@@ -33,7 +37,7 @@ export type useYSpreadsheetProps<T extends CellData, S extends Sheet, C extends
  * Does not load initial data
  * @returns
  */
-export declare const useYSpreadsheet: <T extends CellData, S extends Sheet, C extends EmbeddedChart, O extends EmbeddedObject>({ onChangeSheetData, onChangeSheets, onChangeTables, onChangeCharts, onChangeEmbeds, onChangeConditionalFormats, onChangeDataValidations, onChangeNamedRanges, onChangeProtectedRanges, onError, enqueueCalculation, calculateNow, userId, title, sheetId, activeCell, doc, provider, yjs, }: useYSpreadsheetProps<T, S, C, O>) => {
+export declare const useYSpreadsheet: <T extends CellData, S extends Sheet, C extends EmbeddedChart, O extends EmbeddedObject>({ onChangeSheetData, onChangeSheets, onChangeTables, onChangeCharts, onChangeEmbeds, onChangeConditionalFormats, onChangeDataValidations, onChangeNamedRanges, onChangeProtectedRanges, onError, enqueueCalculation, calculateNow, userId, title, sheetId, activeCell, doc, provider, yjs: yjsRuntime, }: useYSpreadsheetProps<T, S, C, O>) => {
     onBroadcastPatch: (patches: [patch: SpreadsheetPatch<Patch>, type?: HistoryType | undefined][]) => void;
     users: Collaborator[];
     synced: boolean;

package/dist/cjs/use-yspreadsheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-yspreadsheet.d.ts","sourceRoot":"","sources":["../../use-yspreadsheet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-yspreadsheet.d.ts","sourceRoot":"","sources":["../../use-yspreadsheet.ts"],"names":[],"mappings":"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"}

package/dist/cjs/use-yspreadsheet.js

@@ -6,7 +6,7 @@ var spreadsheet_1 = require("@rowsncolumns/spreadsheet");
 var immer_1 = require("immer");
 var uniqBy_1 = tslib_1.__importDefault(require("lodash/uniqBy"));
 var react_1 = require("react");
-var Y = tslib_1.__importStar(require("yjs"));
+var yjs_runtime_1 = require("./yjs-runtime");
 var getStateVector = function (doc, yjs) {
     return yjs.encodeStateVector(doc);
 };
@@ -22,9 +22,10 @@ var getUpdatesBetween = function (doc, stateVector1, stateVector2, yjs) {
  * @returns
  */
 var useYSpreadsheet = function (_a) {
-    var onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeCharts = _a.onChangeCharts, onChangeEmbeds = _a.onChangeEmbeds, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeProtectedRanges = _a.onChangeProtectedRanges, onError = _a.onError, enqueueCalculation = _a.enqueueCalculation, calculateNow = _a.calculateNow, userId = _a.userId, title = _a.title, sheetId = _a.sheetId, activeCell = _a.activeCell, doc = _a.doc, provider = _a.provider, _b = _a.yjs, yjs = _b === void 0 ? Y : _b;
-    var _c = tslib_1.__read((0, react_1.useState)([]), 2), users = _c[0], setUsers = _c[1];
-    var _d = tslib_1.__read((0, react_1.useState)(false), 2), synced = _d[0], setSynced = _d[1];
+    var onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeCharts = _a.onChangeCharts, onChangeEmbeds = _a.onChangeEmbeds, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeProtectedRanges = _a.onChangeProtectedRanges, onError = _a.onError, enqueueCalculation = _a.enqueueCalculation, calculateNow = _a.calculateNow, userId = _a.userId, title = _a.title, sheetId = _a.sheetId, activeCell = _a.activeCell, doc = _a.doc, provider = _a.provider, yjsRuntime = _a.yjs;
+    var yjs = (0, yjs_runtime_1.resolveYjsRuntime)(yjsRuntime);
+    var _b = tslib_1.__read((0, react_1.useState)([]), 2), users = _b[0], setUsers = _b[1];
+    var _c = tslib_1.__read((0, react_1.useState)(false), 2), synced = _c[0], setSynced = _c[1];
     var previousStateVectorRef = (0, react_1.useRef)(undefined);
     var currentStateVectorRef = (0, react_1.useRef)(undefined);
     // Recalc cells

package/dist/cjs/vitest.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../../vitest.config.ts"],"names":[],"mappings":";AAEA,wBAsBG"}
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../../vitest.config.ts"],"names":[],"mappings":";AAEA,wBAuBG"}

package/dist/cjs/vitest.config.js

@@ -5,6 +5,7 @@ exports.default = (0, config_1.defineConfig)({
     test: {
         globals: true,
         environment: "jsdom",
+        setupFiles: ["./__tests__/setup-yjs-runtime.ts"],
         // ✅ correct location for deps.inline
         deps: {
             inline: ["konva", "react-konva"],

package/dist/cjs/yjs-runtime.d.ts

@@ -0,0 +1,6 @@
+import type { YjsRuntime } from "./types";
+/** Registers (or, with `undefined`, clears) the runtime used when a call passes none. */
+export declare const setDefaultYjsRuntime: (runtime: YjsRuntime | undefined) => void;
+/** The runtime a call works with: the one it was given, else the registered default. */
+export declare const resolveYjsRuntime: (runtime?: YjsRuntime) => YjsRuntime;
+//# sourceMappingURL=yjs-runtime.d.ts.map

package/dist/cjs/yjs-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yjs-runtime.d.ts","sourceRoot":"","sources":["../../yjs-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAW1C,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,GAAI,SAAS,UAAU,GAAG,SAAS,KAAG,IAEtE,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,GAAI,UAAU,UAAU,KAAG,UAQxD,CAAC"}

package/dist/cjs/yjs-runtime.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveYjsRuntime = exports.setDefaultYjsRuntime = void 0;
+/**
+ * y-spreadsheet does not import a Yjs implementation: every helper and hook
+ * takes the namespace of the implementation the document belongs to (`yjs`,
+ * or a yjs-13-compatible layer over `@y/y` 14). A host that always works with
+ * one implementation can register it once here instead of passing it on every
+ * call; a runtime passed to a call wins over the registered one.
+ */
+var defaultYjsRuntime;
+/** Registers (or, with `undefined`, clears) the runtime used when a call passes none. */
+var setDefaultYjsRuntime = function (runtime) {
+    defaultYjsRuntime = runtime;
+};
+exports.setDefaultYjsRuntime = setDefaultYjsRuntime;
+/** The runtime a call works with: the one it was given, else the registered default. */
+var resolveYjsRuntime = function (runtime) {
+    var resolved = runtime !== null && runtime !== void 0 ? runtime : defaultYjsRuntime;
+    if (!resolved) {
+        throw new Error("@rowsncolumns/y-spreadsheet: no Yjs runtime. Pass `yjs` (the namespace of the Yjs implementation the document belongs to, e.g. `import * as Y from \"yjs\"`) or register one with setDefaultYjsRuntime(Y). The package does not import yjs itself.");
+    }
+    return resolved;
+};
+exports.resolveYjsRuntime = resolveYjsRuntime;

package/dist/esm/helpers-v5.d.ts

@@ -0,0 +1,64 @@
+import type { CellData, CellFormat } from "@rowsncolumns/spreadsheet";
+import type { SheetData } from "@rowsncolumns/spreadsheet-state";
+import type { Patch } from "immer";
+import type * as Y from "yjs";
+/** A parsed v5 cell key; line ids as decimal strings (an id can exceed 2^53). */
+export type ParsedCellKeyV5 = {
+    sheetId: number;
+    rowId: string;
+    colId: string;
+};
+/** The composed style plane: cell key → format (`StyleOverlay`). */
+export type StyleOverlayV5 = Map<string, CellFormat>;
+/**
+ * A sheet's line ids in grid order (position = index + 1), as decimal strings.
+ * Later duplicates and non-id values are skipped, as the engine's index does.
+ */
+export declare const readLineIds: (doc: Y.Doc, sheetId: number, axis: "row" | "column") => string[];
+/** The `rncCells` / `rncNotes` key of a cell by its line ids. */
+export declare const createCellKeyV5: (sheetId: number, rowId: string, colId: string) => string;
+/** Parse a v5 key `"{sheetId}:{rowId}:{colId}"`; null when malformed. */
+export declare const parseCellKeyV5: (key: string) => ParsedCellKeyV5 | null;
+/**
+ * The composed style plane of a v5 doc (`refold_style_overlay`): the legacy
+ * `rncCellStyles` seed (`"{sheetId}!{A1}"`, the client-0 ids of that position)
+ * with every `rncCellStylesLog` buffer folded on in array order. Walks the log.
+ */
+export declare const readStyleOverlayV5: (doc: Y.Doc) => StyleOverlayV5;
+/**
+ * A v5 doc as V2 `SheetData` (same shape as `sheetDataV3ToV2`), hot plane only:
+ * every key of `rncCells`, `rncNotes` and the composed style plane composed as
+ * `composeCell` does (tombstones and orphans skipped).
+ */
+export declare const sheetDataV5ToV2: <T extends CellData>(doc: Y.Doc, styles?: ReadonlyMap<string, CellFormat>) => SheetData<T>;
+/**
+ * A reader of the cell at a 1-based position (`composeCell`), line ids read once
+ * per sheet. Undefined when nothing is there or the line is unnamed.
+ */
+export declare const createCellReaderV5: <T extends CellData = CellData>(doc: Y.Doc, styles?: ReadonlyMap<string, CellFormat>) => (sheetId: number, rowIndex: number, columnIndex: number) => T | undefined;
+/** `createCellReaderV5` for one cell (reads both id arrays: O(lines)). */
+export declare const getCellV5: <T extends CellData = CellData>(doc: Y.Doc, sheetId: number, rowIndex: number, columnIndex: number, styles?: ReadonlyMap<string, CellFormat>) => T | undefined;
+/**
+ * Apply changed `rncCells` / `rncNotes` keys to `currentSheetData` (copy-on-write,
+ * like `processSheetDataEventsV3`), `uf` from `styles`. Only valid while no id
+ * array and no style changed (those need `sheetDataV5ToV2`). Null when nothing changed.
+ */
+export declare const processSheetDataChangesV5: <T extends CellData>(changedKeys: Iterable<string>, currentSheetData: SheetData<T>, doc: Y.Doc, styles?: ReadonlyMap<string, CellFormat>) => SheetData<T> | null;
+/**
+ * Apply immer `SheetData` patches to a v5 doc in one transaction (`origin`, the
+ * caller's; nested in an open transaction it joins that one). Positional, like
+ * the v3 path: a row insert/delete arrives as rewritten rows and is applied as
+ * cell writes/removals at each position's line ids; no line is inserted or
+ * deleted. Writes past an axis name lines (client-0 padding, `ensure_lines`).
+ * `uf` changes append ONE `STYLE_LOG_V2` buffer to `rncCellStylesLog` and stay
+ * inline on the cell. `styles`, when given, is the caller's composed style plane
+ * (`readStyleOverlayV5`), used instead of folding the log and updated in place.
+ */
+export declare const addSheetDataPatchesV5: (doc: Y.Doc, patches: Patch[] | undefined, origin?: unknown, styles?: StyleOverlayV5) => void;
+/** Set one cell of a v5 doc (see `addSheetDataPatchesV5`). */
+export declare const setCellV5: (doc: Y.Doc, sheetId: number, rowIndex: number, columnIndex: number, value: CellData) => void;
+/** Remove one cell of a v5 doc (see `addSheetDataPatchesV5`). */
+export declare const deleteCellV5: (doc: Y.Doc, sheetId: number, rowIndex: number, columnIndex: number) => void;
+/** Remove every cell of a sheet of a v5 doc; its line ids and dimensions stay. */
+export declare const deleteSheetV5: (doc: Y.Doc, sheetId: number) => void;
+//# sourceMappingURL=helpers-v5.d.ts.map

package/dist/esm/helpers-v5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers-v5.d.ts","sourceRoot":"","sources":["../../helpers-v5.ts"],"names":[],"mappings":"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"}