@textbus/collaborate 5.2.6 → 5.3.0

package/dist/index.esm.js

@@ -1,26 +1,26 @@
 import { Injectable, Inject, Optional } from '@viewfly/core';
-import { makeError, Slot, ChangeOrigin, observe, AsyncSlot, AsyncComponent, Component, Scheduler, Registry, Selection, HISTORY_STACK_SIZE, RootComponentRef, History } from '@textbus/core';
+import { makeError, Slot, ChangeOrigin, observe, toRaw, AsyncSlot, AsyncComponent, Component, Scheduler, Registry, Selection, HISTORY_STACK_SIZE, RootComponentRef, History } from '@textbus/core';
 import { Subject, map, filter, Subscription } from '@tanbo/stream';
-import { Doc, createAbsolutePositionFromRelativePosition, createRelativePositionFromTypeIndex, Map, Array as Array$1, Text, UndoManager } from 'yjs';
+import { Doc, createAbsolutePositionFromRelativePosition, createRelativePositionFromTypeIndex, Map, Array as Array$1, Text, XmlElement, UndoManager } from 'yjs';
 import { HocuspocusProvider } from '@hocuspocus/provider';
 import { WebsocketProvider } from 'y-websocket';
 
-function _assert_this_initialized$2(self) {
+function _assert_this_initialized$3(self) {
     if (self === void 0) {
         throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
     }
     return self;
 }
-function _call_super$2(_this, derived, args) {
-    derived = _get_prototype_of$2(derived);
-    return _possible_constructor_return$2(_this, _is_native_reflect_construct$2() ? Reflect.construct(derived, args || [], _get_prototype_of$2(_this).constructor) : derived.apply(_this, args));
+function _call_super$3(_this, derived, args) {
+    derived = _get_prototype_of$3(derived);
+    return _possible_constructor_return$3(_this, _is_native_reflect_construct$3() ? Reflect.construct(derived, args || [], _get_prototype_of$3(_this).constructor) : derived.apply(_this, args));
 }
-function _class_call_check$9(instance, Constructor) {
+function _class_call_check$a(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties$8(target, props) {
+function _defineProperties$9(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -29,17 +29,17 @@ function _defineProperties$8(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class$8(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties$8(Constructor.prototype, protoProps);
+function _create_class$9(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$9(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _get_prototype_of$2(o) {
-    _get_prototype_of$2 = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+function _get_prototype_of$3(o) {
+    _get_prototype_of$3 = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
         return o.__proto__ || Object.getPrototypeOf(o);
     };
-    return _get_prototype_of$2(o);
+    return _get_prototype_of$3(o);
 }
-function _inherits$2(subClass, superClass) {
+function _inherits$3(subClass, superClass) {
     if (typeof superClass !== "function" && superClass !== null) {
         throw new TypeError("Super expression must either be null or a function");
     }
@@ -50,30 +50,30 @@ function _inherits$2(subClass, superClass) {
             configurable: true
         }
     });
-    if (superClass) _set_prototype_of$2(subClass, superClass);
+    if (superClass) _set_prototype_of$3(subClass, superClass);
 }
-function _possible_constructor_return$2(self, call) {
-    if (call && (_type_of$3(call) === "object" || typeof call === "function")) {
+function _possible_constructor_return$3(self, call) {
+    if (call && (_type_of$4(call) === "object" || typeof call === "function")) {
         return call;
     }
-    return _assert_this_initialized$2(self);
+    return _assert_this_initialized$3(self);
 }
-function _set_prototype_of$2(o, p) {
-    _set_prototype_of$2 = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+function _set_prototype_of$3(o, p) {
+    _set_prototype_of$3 = Object.setPrototypeOf || function setPrototypeOf(o, p) {
         o.__proto__ = p;
         return o;
     };
-    return _set_prototype_of$2(o, p);
+    return _set_prototype_of$3(o, p);
 }
-function _type_of$3(obj) {
+function _type_of$4(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _is_native_reflect_construct$2() {
+function _is_native_reflect_construct$3() {
     try {
         var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
     } catch (_) {}
-    return (_is_native_reflect_construct$2 = function() {
+    return (_is_native_reflect_construct$3 = function() {
         return !!result;
     })();
 }
@@ -87,15 +87,15 @@ var subModelLoaderErrorFn = makeError('subModelLoaderError');
 /**
  * 子文档加载器
  */ var SubModelLoader = function SubModelLoader() {
-    _class_call_check$9(this, SubModelLoader);
+    _class_call_check$a(this, SubModelLoader);
 };
 var NonSubModelLoader = /*#__PURE__*/ function(SubModelLoader) {
-    _inherits$2(NonSubModelLoader, SubModelLoader);
+    _inherits$3(NonSubModelLoader, SubModelLoader);
     function NonSubModelLoader() {
-        _class_call_check$9(this, NonSubModelLoader);
-        return _call_super$2(this, NonSubModelLoader, arguments);
+        _class_call_check$a(this, NonSubModelLoader);
+        return _call_super$3(this, NonSubModelLoader, arguments);
     }
-    _create_class$8(NonSubModelLoader, [
+    _create_class$9(NonSubModelLoader, [
         {
             key: "createSubModelBySlot",
             value: function createSubModelBySlot() {
@@ -150,12 +150,12 @@ function _array_with_holes(arr) {
 function _array_without_holes(arr) {
     if (Array.isArray(arr)) return _array_like_to_array(arr);
 }
-function _class_call_check$8(instance, Constructor) {
+function _class_call_check$9(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties$7(target, props) {
+function _defineProperties$8(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -164,11 +164,11 @@ function _defineProperties$7(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class$7(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties$7(Constructor.prototype, protoProps);
+function _create_class$8(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$8(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$8(obj, key, value) {
+function _define_property$9(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -228,7 +228,7 @@ function _sliced_to_array(arr, i) {
 function _to_consumable_array(arr) {
     return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
 }
-function _type_of$2(obj) {
+function _type_of$3(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -249,14 +249,15 @@ function _ts_decorate$2(decorators, target, key, desc) {
 function _ts_metadata$2(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
+/** 与本地稀疏数组「空洞」对应的 YXmlElement，仅放入 YArray，不作通用 XML 节点使用 */ var ARRAY_HOLE_ELEMENT_NODE = 'tb-array-hole';
 var collaborateErrorFn = makeError('Collaborate');
 var SlotMap = /*#__PURE__*/ function() {
     function SlotMap() {
-        _class_call_check$8(this, SlotMap);
-        _define_property$8(this, "slotAndYTextMap", new WeakMap());
-        _define_property$8(this, "yTextAndSlotMap", new WeakMap());
+        _class_call_check$9(this, SlotMap);
+        _define_property$9(this, "slotAndYTextMap", new WeakMap());
+        _define_property$9(this, "yTextAndSlotMap", new WeakMap());
     }
-    _create_class$7(SlotMap, [
+    _create_class$8(SlotMap, [
         {
             key: "set",
             value: function set(key, value) {
@@ -301,19 +302,19 @@ var SlotMap = /*#__PURE__*/ function() {
 }();
 var Collaborate = /*#__PURE__*/ function() {
     function Collaborate(scheduler, registry, selection, subModelLoader) {
-        _class_call_check$8(this, Collaborate);
-        _define_property$8(this, "scheduler", void 0);
-        _define_property$8(this, "registry", void 0);
-        _define_property$8(this, "selection", void 0);
-        _define_property$8(this, "subModelLoader", void 0);
-        _define_property$8(this, "yDoc", void 0);
-        _define_property$8(this, "slotMap", void 0);
-        _define_property$8(this, "onAddSubModel", void 0);
-        _define_property$8(this, "subscriptions", void 0);
-        _define_property$8(this, "updateFromRemote", void 0);
-        _define_property$8(this, "addSubModelEvent", void 0);
-        _define_property$8(this, "updateRemoteActions", void 0);
-        _define_property$8(this, "noRecord", void 0);
+        _class_call_check$9(this, Collaborate);
+        _define_property$9(this, "scheduler", void 0);
+        _define_property$9(this, "registry", void 0);
+        _define_property$9(this, "selection", void 0);
+        _define_property$9(this, "subModelLoader", void 0);
+        _define_property$9(this, "yDoc", void 0);
+        _define_property$9(this, "slotMap", void 0);
+        _define_property$9(this, "onAddSubModel", void 0);
+        _define_property$9(this, "subscriptions", void 0);
+        _define_property$9(this, "updateFromRemote", void 0);
+        _define_property$9(this, "addSubModelEvent", void 0);
+        _define_property$9(this, "updateRemoteActions", void 0);
+        _define_property$9(this, "noRecord", void 0);
         this.scheduler = scheduler;
         this.registry = registry;
         this.selection = selection;
@@ -327,7 +328,7 @@ var Collaborate = /*#__PURE__*/ function() {
         this.noRecord = {};
         this.onAddSubModel = this.addSubModelEvent.asObservable();
     }
-    _create_class$7(Collaborate, [
+    _create_class$8(Collaborate, [
         {
             key: "syncRootComponent",
             value: function syncRootComponent(yDoc, sharedComponent, localComponent) {
@@ -694,12 +695,15 @@ var Collaborate = /*#__PURE__*/ function() {
         {
             key: "createLocalArrayBySharedArray",
             value: function createLocalArrayBySharedArray(sharedArray) {
-                var _this = this;
-                var _localArray;
-                var localArray = observe([]);
-                (_localArray = localArray).push.apply(_localArray, _to_consumable_array(sharedArray.map(function(item) {
-                    return _this.createLocalModelBySharedByModel(item);
-                })));
+                var raw = [];
+                for(var i = 0; i < sharedArray.length; i++){
+                    var item = sharedArray.get(i);
+                    if (!this.isArrayHoleElement(item)) {
+                        raw[i] = this.createLocalModelBySharedByModel(item);
+                    }
+                }
+                raw.length = sharedArray.length;
+                var localArray = observe(raw);
                 this.syncArray(sharedArray, localArray);
                 return localArray;
             }
@@ -726,13 +730,19 @@ var Collaborate = /*#__PURE__*/ function() {
         {
             key: "createSharedArrayByLocalArray",
             value: function createSharedArrayByLocalArray(localArray) {
-                var _this = this;
                 var sharedArray = new Array$1();
-                localArray.forEach(function(value) {
-                    sharedArray.push([
-                        _this.createSharedModelByLocalModel(value)
-                    ]);
-                });
+                var raw = toRaw(localArray);
+                for(var i = 0; i < raw.length; i++){
+                    if (i in raw) {
+                        sharedArray.push([
+                            this.sharedModelForArraySlot(raw[i])
+                        ]);
+                    } else {
+                        sharedArray.push([
+                            this.createArrayHoleXmlElement()
+                        ]);
+                    }
+                }
                 this.syncArray(sharedArray, localArray);
                 return sharedArray;
             }
@@ -920,7 +930,7 @@ var Collaborate = /*#__PURE__*/ function() {
                 if (Array.isArray(localModel)) {
                     return this.createSharedArrayByLocalArray(localModel);
                 }
-                if ((typeof localModel === "undefined" ? "undefined" : _type_of$2(localModel)) === 'object' && localModel !== null) {
+                if ((typeof localModel === "undefined" ? "undefined" : _type_of$3(localModel)) === 'object' && localModel !== null) {
                     return this.createSharedMapByLocalMap(localModel);
                 }
                 return localModel;
@@ -1033,6 +1043,51 @@ var Collaborate = /*#__PURE__*/ function() {
                 throw collaborateErrorFn("cannot find component factory `".concat(componentName, "`."));
             }
         },
+        {
+            key: "createArrayHoleXmlElement",
+            value: function createArrayHoleXmlElement() {
+                return new XmlElement(ARRAY_HOLE_ELEMENT_NODE);
+            }
+        },
+        {
+            key: "isArrayHoleElement",
+            value: function isArrayHoleElement(sharedModel) {
+                return _instanceof$1(sharedModel, XmlElement) && sharedModel.nodeName === ARRAY_HOLE_ELEMENT_NODE;
+            }
+        },
+        {
+            key: "sharedModelForArraySlot",
+            value: /**
+   * 仅用于 YArray ↔ 可观察数组：本地 `undefined` 槽位用 XmlElement 占位同步到 Yjs（不与对象字面量同步混用）。
+   */ function sharedModelForArraySlot(localItem) {
+                if (localItem === undefined) {
+                    return this.createArrayHoleXmlElement();
+                }
+                return this.createSharedModelByLocalModel(localItem);
+            }
+        },
+        {
+            key: "insertSparseHole",
+            value: /**
+   * 在可观察数组中插入稀疏空洞（与 YArray 中 XmlElement 占位对齐）。
+   * 仅在远端同步路径调用；直接操作 raw，避免走插入 undefined 的可观察路径。
+   */ function insertSparseHole(localArray, atIndex) {
+                var raw = toRaw(localArray);
+                var len = raw.length;
+                if (atIndex >= len) {
+                    raw.length = atIndex + 1;
+                    return;
+                }
+                for(var i = len; i > atIndex; i--){
+                    if (i - 1 in raw) {
+                        raw[i] = raw[i - 1];
+                    } else {
+                        delete raw[i];
+                    }
+                }
+                delete raw[atIndex];
+            }
+        },
         {
             key: "syncArray",
             value: /**
@@ -1063,7 +1118,7 @@ var Collaborate = /*#__PURE__*/ function() {
                                                 throw collaborateErrorFn('The insertion action must have a reference value.');
                                             }
                                             var data = ref.map(function(item) {
-                                                return _this.createSharedModelByLocalModel(item);
+                                                return _this.sharedModelForArraySlot(item);
                                             });
                                             if (index <= sharedArray.length) {
                                                 sharedArray.insert(index, data);
@@ -1087,11 +1142,11 @@ var Collaborate = /*#__PURE__*/ function() {
                                         if (action.index < sharedArray.length) {
                                             sharedArray.delete(action.index, 1);
                                             sharedArray.insert(action.index, [
-                                                _this.createSharedModelByLocalModel(action.ref)
+                                                _this.sharedModelForArraySlot(action.ref)
                                             ]);
                                         } else {
                                             sharedArray.insert(sharedArray.length, [
-                                                _this.createSharedModelByLocalModel(action.ref)
+                                                _this.sharedModelForArraySlot(action.ref)
                                             ]);
                                             logError('setIndex');
                                         }
@@ -1121,15 +1176,33 @@ var Collaborate = /*#__PURE__*/ function() {
                             if (Reflect.has(action, 'retain')) {
                                 index += action.retain;
                             } else if (action.insert) {
-                                var _localArray;
-                                var data = action.insert.map(function(item) {
-                                    return _this.createLocalModelBySharedByModel(item);
-                                });
-                                (_localArray = localArray).splice.apply(_localArray, [
-                                    index,
-                                    0
-                                ].concat(_to_consumable_array(data)));
-                                index += data.length;
+                                var at = index;
+                                var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                                try {
+                                    for(var _iterator = action.insert[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                        var item = _step.value;
+                                        if (_this.isArrayHoleElement(item)) {
+                                            _this.insertSparseHole(localArray, at);
+                                        } else {
+                                            localArray.splice(at, 0, _this.createLocalModelBySharedByModel(item));
+                                        }
+                                        at++;
+                                    }
+                                } catch (err) {
+                                    _didIteratorError = true;
+                                    _iteratorError = err;
+                                } finally{
+                                    try {
+                                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                            _iterator.return();
+                                        }
+                                    } finally{
+                                        if (_didIteratorError) {
+                                            throw _iteratorError;
+                                        }
+                                    }
+                                }
+                                index = at;
                             } else if (action.delete) {
                                 localArray.splice(index, action.delete);
                             }
@@ -1270,12 +1343,12 @@ function remoteFormatsToLocal(registry, attrs) {
     return formats;
 }
 
-function _class_call_check$7(instance, Constructor) {
+function _class_call_check$8(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties$6(target, props) {
+function _defineProperties$7(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -1284,11 +1357,11 @@ function _defineProperties$6(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class$6(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties$6(Constructor.prototype, protoProps);
+function _create_class$7(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$7(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$7(obj, key, value) {
+function _define_property$8(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1316,29 +1389,29 @@ function _ts_param$1(paramIndex, decorator) {
     };
 }
 var CustomUndoManagerConfig = function CustomUndoManagerConfig() {
-    _class_call_check$7(this, CustomUndoManagerConfig);
+    _class_call_check$8(this, CustomUndoManagerConfig);
 };
 var collabHistoryErrorFn = makeError('CollabHistory');
 var CollabHistory = /*#__PURE__*/ function() {
     function CollabHistory(rootComponentRef, collaborate, scheduler, stackSize, undoManagerConfig) {
-        _class_call_check$7(this, CollabHistory);
-        _define_property$7(this, "rootComponentRef", void 0);
-        _define_property$7(this, "collaborate", void 0);
-        _define_property$7(this, "scheduler", void 0);
-        _define_property$7(this, "stackSize", void 0);
-        _define_property$7(this, "undoManagerConfig", void 0);
-        _define_property$7(this, "onBack", void 0);
-        _define_property$7(this, "onForward", void 0);
-        _define_property$7(this, "onChange", void 0);
-        _define_property$7(this, "onPush", void 0);
-        _define_property$7(this, "manager", void 0);
-        _define_property$7(this, "historyItems", void 0);
-        _define_property$7(this, "index", void 0);
-        _define_property$7(this, "subscriptions", void 0);
-        _define_property$7(this, "backEvent", void 0);
-        _define_property$7(this, "forwardEvent", void 0);
-        _define_property$7(this, "changeEvent", void 0);
-        _define_property$7(this, "pushEvent", void 0);
+        _class_call_check$8(this, CollabHistory);
+        _define_property$8(this, "rootComponentRef", void 0);
+        _define_property$8(this, "collaborate", void 0);
+        _define_property$8(this, "scheduler", void 0);
+        _define_property$8(this, "stackSize", void 0);
+        _define_property$8(this, "undoManagerConfig", void 0);
+        _define_property$8(this, "onBack", void 0);
+        _define_property$8(this, "onForward", void 0);
+        _define_property$8(this, "onChange", void 0);
+        _define_property$8(this, "onPush", void 0);
+        _define_property$8(this, "manager", void 0);
+        _define_property$8(this, "historyItems", void 0);
+        _define_property$8(this, "index", void 0);
+        _define_property$8(this, "subscriptions", void 0);
+        _define_property$8(this, "backEvent", void 0);
+        _define_property$8(this, "forwardEvent", void 0);
+        _define_property$8(this, "changeEvent", void 0);
+        _define_property$8(this, "pushEvent", void 0);
         this.rootComponentRef = rootComponentRef;
         this.collaborate = collaborate;
         this.scheduler = scheduler;
@@ -1357,7 +1430,7 @@ var CollabHistory = /*#__PURE__*/ function() {
         this.onChange = this.changeEvent.asObservable();
         this.onPush = this.pushEvent.asObservable();
     }
-    _create_class$6(CollabHistory, [
+    _create_class$7(CollabHistory, [
         {
             key: "canBack",
             get: function get() {
@@ -1381,6 +1454,7 @@ var CollabHistory = /*#__PURE__*/ function() {
                 this.collaborate.syncRootComponent(this.collaborate.yDoc, root, rootComponent);
                 var undoManagerConfig = this.undoManagerConfig || {};
                 var manager = new UndoManager(root, {
+                    captureTimeout: typeof undoManagerConfig.captureTimeout === 'number' ? undoManagerConfig.captureTimeout : 500,
                     trackedOrigins: new Set([
                         this.collaborate.yDoc
                     ]),
@@ -1509,12 +1583,12 @@ CollabHistory = _ts_decorate$1([
     ])
 ], CollabHistory);
 
-function _class_call_check$6(instance, Constructor) {
+function _class_call_check$7(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties$5(target, props) {
+function _defineProperties$6(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -1523,11 +1597,11 @@ function _defineProperties$5(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class$5(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties$5(Constructor.prototype, protoProps);
+function _create_class$6(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$6(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$6(obj, key, value) {
+function _define_property$7(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1544,12 +1618,12 @@ function _define_property$6(obj, key, value) {
  * 协作消息总线，用于同步各终端消息
  */ var MessageBus = /*#__PURE__*/ function() {
     function MessageBus() {
-        _class_call_check$6(this, MessageBus);
-        _define_property$6(this, "onSync", void 0);
-        _define_property$6(this, "syncEvent", new Subject());
+        _class_call_check$7(this, MessageBus);
+        _define_property$7(this, "onSync", void 0);
+        _define_property$7(this, "syncEvent", new Subject());
         this.onSync = this.syncEvent.asObservable();
     }
-    _create_class$5(MessageBus, [
+    _create_class$6(MessageBus, [
         {
             /**
    * 立即同步消息
@@ -1562,12 +1636,12 @@ function _define_property$6(obj, key, value) {
     return MessageBus;
 }();
 
-function _class_call_check$5(instance, Constructor) {
+function _class_call_check$6(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties$4(target, props) {
+function _defineProperties$5(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -1576,11 +1650,11 @@ function _defineProperties$4(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class$4(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties$4(Constructor.prototype, protoProps);
+function _create_class$5(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$5(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$5(obj, key, value) {
+function _define_property$6(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1617,29 +1691,29 @@ function _ts_param(paramIndex, decorator) {
 }
 var MultipleDocCollabHistory = /*#__PURE__*/ function() {
     function MultipleDocCollabHistory(collaborate, scheduler, rootComponentRef, stackSize, undoManagerConfig) {
-        _class_call_check$5(this, MultipleDocCollabHistory);
-        _define_property$5(this, "collaborate", void 0);
-        _define_property$5(this, "scheduler", void 0);
-        _define_property$5(this, "rootComponentRef", void 0);
-        _define_property$5(this, "stackSize", void 0);
-        _define_property$5(this, "undoManagerConfig", void 0);
-        _define_property$5(this, "onChange", void 0);
-        _define_property$5(this, "onBack", void 0);
-        _define_property$5(this, "onForward", void 0);
-        _define_property$5(this, "onPush", void 0);
-        _define_property$5(this, "isListen", void 0);
-        _define_property$5(this, "changeEvent", void 0);
-        _define_property$5(this, "backEvent", void 0);
-        _define_property$5(this, "forwardEvent", void 0);
-        _define_property$5(this, "pushEvent", void 0);
-        _define_property$5(this, "actionStack", void 0);
-        _define_property$5(this, "index", void 0);
-        _define_property$5(this, "stackItem", void 0);
-        _define_property$5(this, "timer", void 0);
-        _define_property$5(this, "beforePosition", void 0);
-        _define_property$5(this, "subscription", void 0);
-        _define_property$5(this, "subDocs", void 0);
-        _define_property$5(this, "listenerCaches", void 0);
+        _class_call_check$6(this, MultipleDocCollabHistory);
+        _define_property$6(this, "collaborate", void 0);
+        _define_property$6(this, "scheduler", void 0);
+        _define_property$6(this, "rootComponentRef", void 0);
+        _define_property$6(this, "stackSize", void 0);
+        _define_property$6(this, "undoManagerConfig", void 0);
+        _define_property$6(this, "onChange", void 0);
+        _define_property$6(this, "onBack", void 0);
+        _define_property$6(this, "onForward", void 0);
+        _define_property$6(this, "onPush", void 0);
+        _define_property$6(this, "isListen", void 0);
+        _define_property$6(this, "changeEvent", void 0);
+        _define_property$6(this, "backEvent", void 0);
+        _define_property$6(this, "forwardEvent", void 0);
+        _define_property$6(this, "pushEvent", void 0);
+        _define_property$6(this, "actionStack", void 0);
+        _define_property$6(this, "index", void 0);
+        _define_property$6(this, "stackItem", void 0);
+        _define_property$6(this, "timer", void 0);
+        _define_property$6(this, "beforePosition", void 0);
+        _define_property$6(this, "subscription", void 0);
+        _define_property$6(this, "subDocs", void 0);
+        _define_property$6(this, "listenerCaches", void 0);
         this.collaborate = collaborate;
         this.scheduler = scheduler;
         this.rootComponentRef = rootComponentRef;
@@ -1663,7 +1737,7 @@ var MultipleDocCollabHistory = /*#__PURE__*/ function() {
         this.onForward = this.forwardEvent.asObservable();
         this.onPush = this.pushEvent.asObservable();
     }
-    _create_class$4(MultipleDocCollabHistory, [
+    _create_class$5(MultipleDocCollabHistory, [
         {
             key: "canBack",
             get: function get() {
@@ -1843,7 +1917,7 @@ var MultipleDocCollabHistory = /*#__PURE__*/ function() {
                                 _this.stackItem = null;
                                 _this.pushEvent.next();
                                 _this.changeEvent.next();
-                            }, 500);
+                            }, typeof undoManagerConfig.captureTimeout === 'number' ? undoManagerConfig.captureTimeout : 500);
                         }
                         _this.stackItem.undoManagers.push(undoManager);
                     }
@@ -1868,12 +1942,12 @@ MultipleDocCollabHistory = _ts_decorate([
     ])
 ], MultipleDocCollabHistory);
 
-function _class_call_check$4(instance, Constructor) {
+function _class_call_check$5(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _define_property$4(obj, key, value) {
+function _define_property$5(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1889,35 +1963,35 @@ function _define_property$4(obj, key, value) {
 /**
  * 协作通信通用接口
  */ var SyncConnector = function SyncConnector() {
-    _class_call_check$4(this, SyncConnector);
+    _class_call_check$5(this, SyncConnector);
     /**
    * 当文档加载完成时触发的观察者
-   */ _define_property$4(this, "onLoad", void 0);
+   */ _define_property$5(this, "onLoad", void 0);
     /**
    * 当文档 awareness 状态变更时触发的观察者
-   */ _define_property$4(this, "onStateChange", void 0);
-    _define_property$4(this, "loadEvent", new Subject());
-    _define_property$4(this, "stateChangeEvent", new Subject());
+   */ _define_property$5(this, "onStateChange", void 0);
+    _define_property$5(this, "loadEvent", new Subject());
+    _define_property$5(this, "stateChangeEvent", new Subject());
     this.onLoad = this.loadEvent.asObservable();
     this.onStateChange = this.stateChangeEvent.asObservable();
 };
 
-function _assert_this_initialized$1(self) {
+function _assert_this_initialized$2(self) {
     if (self === void 0) {
         throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
     }
     return self;
 }
-function _call_super$1(_this, derived, args) {
-    derived = _get_prototype_of$1(derived);
-    return _possible_constructor_return$1(_this, _is_native_reflect_construct$1() ? Reflect.construct(derived, [], _get_prototype_of$1(_this).constructor) : derived.apply(_this, args));
+function _call_super$2(_this, derived, args) {
+    derived = _get_prototype_of$2(derived);
+    return _possible_constructor_return$2(_this, _is_native_reflect_construct$2() ? Reflect.construct(derived, [], _get_prototype_of$2(_this).constructor) : derived.apply(_this, args));
 }
-function _class_call_check$3(instance, Constructor) {
+function _class_call_check$4(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
-function _defineProperties$3(target, props) {
+function _defineProperties$4(target, props) {
     for(var i = 0; i < props.length; i++){
         var descriptor = props[i];
         descriptor.enumerable = descriptor.enumerable || false;
@@ -1926,11 +2000,11 @@ function _defineProperties$3(target, props) {
         Object.defineProperty(target, descriptor.key, descriptor);
     }
 }
-function _create_class$3(Constructor, protoProps, staticProps) {
-    if (protoProps) _defineProperties$3(Constructor.prototype, protoProps);
+function _create_class$4(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$4(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$3(obj, key, value) {
+function _define_property$4(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1943,13 +2017,13 @@ function _define_property$3(obj, key, value) {
     }
     return obj;
 }
-function _get_prototype_of$1(o) {
-    _get_prototype_of$1 = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+function _get_prototype_of$2(o) {
+    _get_prototype_of$2 = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
         return o.__proto__ || Object.getPrototypeOf(o);
     };
-    return _get_prototype_of$1(o);
+    return _get_prototype_of$2(o);
 }
-function _inherits$1(subClass, superClass) {
+function _inherits$2(subClass, superClass) {
     if (typeof superClass !== "function" && superClass !== null) {
         throw new TypeError("Super expression must either be null or a function");
     }
@@ -1960,9 +2034,9 @@ function _inherits$1(subClass, superClass) {
             configurable: true
         }
     });
-    if (superClass) _set_prototype_of$1(subClass, superClass);
+    if (superClass) _set_prototype_of$2(subClass, superClass);
 }
-function _object_spread(target) {
+function _object_spread$1(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -1972,7 +2046,7 @@ function _object_spread(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$3(target, key, source[key]);
+            _define_property$4(target, key, source[key]);
         });
     }
     return target;
@@ -1996,38 +2070,38 @@ function _object_spread_props(target, source) {
     }
     return target;
 }
-function _possible_constructor_return$1(self, call) {
-    if (call && (_type_of$1(call) === "object" || typeof call === "function")) {
+function _possible_constructor_return$2(self, call) {
+    if (call && (_type_of$2(call) === "object" || typeof call === "function")) {
         return call;
     }
-    return _assert_this_initialized$1(self);
+    return _assert_this_initialized$2(self);
 }
-function _set_prototype_of$1(o, p) {
-    _set_prototype_of$1 = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+function _set_prototype_of$2(o, p) {
+    _set_prototype_of$2 = Object.setPrototypeOf || function setPrototypeOf(o, p) {
         o.__proto__ = p;
         return o;
     };
-    return _set_prototype_of$1(o, p);
+    return _set_prototype_of$2(o, p);
 }
-function _type_of$1(obj) {
+function _type_of$2(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _is_native_reflect_construct$1() {
+function _is_native_reflect_construct$2() {
     try {
         var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
     } catch (_) {}
-    return (_is_native_reflect_construct$1 = function() {
+    return (_is_native_reflect_construct$2 = function() {
         return !!result;
     })();
 }
 var HocuspocusConnector = /*#__PURE__*/ function(SyncConnector) {
-    _inherits$1(HocuspocusConnector, SyncConnector);
+    _inherits$2(HocuspocusConnector, SyncConnector);
     function HocuspocusConnector(config) {
-        _class_call_check$3(this, HocuspocusConnector);
+        _class_call_check$4(this, HocuspocusConnector);
         var _this;
-        _this = _call_super$1(this, HocuspocusConnector), _define_property$3(_this, "provide", void 0);
-        _this.provide = new HocuspocusProvider(_object_spread_props(_object_spread({}, config), {
+        _this = _call_super$2(this, HocuspocusConnector), _define_property$4(_this, "provide", void 0);
+        _this.provide = new HocuspocusProvider(_object_spread_props(_object_spread$1({}, config), {
             onSynced: function onSynced(data) {
                 var _config_onSynced;
                 (_config_onSynced = config.onSynced) === null || _config_onSynced === void 0 ? void 0 : _config_onSynced.call(config, data);
@@ -2047,7 +2121,7 @@ var HocuspocusConnector = /*#__PURE__*/ function(SyncConnector) {
         }));
         return _this;
     }
-    _create_class$3(HocuspocusConnector, [
+    _create_class$4(HocuspocusConnector, [
         {
             key: "setLocalStateField",
             value: function setLocalStateField(key, data) {
@@ -2065,6 +2139,170 @@ var HocuspocusConnector = /*#__PURE__*/ function(SyncConnector) {
     return HocuspocusConnector;
 }(SyncConnector);
 
+function _assert_this_initialized$1(self) {
+    if (self === void 0) {
+        throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
+    }
+    return self;
+}
+function _call_super$1(_this, derived, args) {
+    derived = _get_prototype_of$1(derived);
+    return _possible_constructor_return$1(_this, _is_native_reflect_construct$1() ? Reflect.construct(derived, [], _get_prototype_of$1(_this).constructor) : derived.apply(_this, args));
+}
+function _class_call_check$3(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties$3(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class$3(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$3(Constructor.prototype, protoProps);
+    return Constructor;
+}
+function _define_property$3(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _get_prototype_of$1(o) {
+    _get_prototype_of$1 = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+        return o.__proto__ || Object.getPrototypeOf(o);
+    };
+    return _get_prototype_of$1(o);
+}
+function _inherits$1(subClass, superClass) {
+    if (typeof superClass !== "function" && superClass !== null) {
+        throw new TypeError("Super expression must either be null or a function");
+    }
+    subClass.prototype = Object.create(superClass && superClass.prototype, {
+        constructor: {
+            value: subClass,
+            writable: true,
+            configurable: true
+        }
+    });
+    if (superClass) _set_prototype_of$1(subClass, superClass);
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property$3(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function _possible_constructor_return$1(self, call) {
+    if (call && (_type_of$1(call) === "object" || typeof call === "function")) {
+        return call;
+    }
+    return _assert_this_initialized$1(self);
+}
+function _set_prototype_of$1(o, p) {
+    _set_prototype_of$1 = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+        o.__proto__ = p;
+        return o;
+    };
+    return _set_prototype_of$1(o, p);
+}
+function _type_of$1(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _is_native_reflect_construct$1() {
+    try {
+        var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
+    } catch (_) {}
+    return (_is_native_reflect_construct$1 = function() {
+        return !!result;
+    })();
+}
+/**
+ * 不经网络的协作连接器，实现与 {@link SyncConnector} 相同的对外行为，
+ * 便于在单元测试中配合 {@link CollaborateModule} 使用，无需 WebSocket / Provider。
+ *
+ * - `onLoad`：在微任务中触发一次，对应远端「已同步可编辑」的时机。
+ * - `onStateChange`：在每次 {@link LocalConnector.setLocalStateField} 后发出当前客户端状态，
+ *   载荷形状与 `YWebsocketConnector` 一致（`{ clientId, message }`，其中 `message` 为 awareness 上的 `message` 字段）。
+ *
+ * 第一个参数与 `createConnector(yDoc)` 对齐，便于直接传入 `Collaborate` 的文档；当前实现不读写该 `YDoc`。
+ */ var LocalConnector = /*#__PURE__*/ function(SyncConnector) {
+    _inherits$1(LocalConnector, SyncConnector);
+    function LocalConnector(_yDoc, options) {
+        _class_call_check$3(this, LocalConnector);
+        var _this;
+        var _ref;
+        _this = _call_super$1(this, LocalConnector), _define_property$3(_this, "clientId", void 0), _define_property$3(_this, "destroyed", false), _define_property$3(_this, "fields", {});
+        _this.clientId = (_ref = options === null || options === void 0 ? void 0 : options.clientId) !== null && _ref !== void 0 ? _ref : 0;
+        Promise.resolve().then(function() {
+            if (!_this.destroyed) {
+                _this.loadEvent.next();
+            }
+        });
+        return _this;
+    }
+    _create_class$3(LocalConnector, [
+        {
+            key: "setLocalStateField",
+            value: function setLocalStateField(key, data) {
+                if (this.destroyed) {
+                    return;
+                }
+                this.fields[key] = data;
+                this.emitAwarenessStates();
+            }
+        },
+        {
+            key: "onDestroy",
+            value: function onDestroy() {
+                this.destroyed = true;
+            }
+        },
+        {
+            /**
+   * 读取当前本地 awareness 字段快照，仅用于测试断言。
+   */ key: "getLocalAwarenessSnapshot",
+            value: function getLocalAwarenessSnapshot() {
+                return _object_spread({}, this.fields);
+            }
+        },
+        {
+            key: "emitAwarenessStates",
+            value: function emitAwarenessStates() {
+                var states = [];
+                states.push({
+                    clientId: this.clientId,
+                    message: this.fields.message
+                });
+                this.stateChangeEvent.next(states);
+            }
+        }
+    ]);
+    return LocalConnector;
+}(SyncConnector);
+
 function _assert_this_initialized(self) {
     if (self === void 0) {
         throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
@@ -2433,5 +2671,5 @@ var MultipleDocumentCollaborateModule = /*#__PURE__*/ function() {
     return MultipleDocumentCollaborateModule;
 }();
 
-export { CollabHistory, Collaborate, CollaborateModule, CustomUndoManagerConfig, HocuspocusConnector, MessageBus, MultipleDocCollabHistory, MultipleDocumentCollaborateModule, NonSubModelLoader, SubModelLoader, SyncConnector, YWebsocketConnector };
+export { CollabHistory, Collaborate, CollaborateModule, CustomUndoManagerConfig, HocuspocusConnector, LocalConnector, MessageBus, MultipleDocCollabHistory, MultipleDocumentCollaborateModule, NonSubModelLoader, SubModelLoader, SyncConnector, YWebsocketConnector };
 //# sourceMappingURL=index.esm.js.map