@liveblocks/core 3.22.0 → 3.23.0-exp2

package/dist/index.cjs

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.22.0";
+var PKG_VERSION = "3.23.0-exp2";
 var PKG_FORMAT = "cjs";
 
 // src/dupe-detection.ts
@@ -3879,6 +3879,7 @@ var ManagedSocket = class {
 
 // src/internal.ts
 var kInternal = /* @__PURE__ */ Symbol();
+var kStorageUpdateSource = /* @__PURE__ */ Symbol();
 
 // src/lib/IncrementalJsonParser.ts
 var EMPTY_OBJECT = Object.freeze({});
@@ -5837,13 +5838,15 @@ var OpCode = Object.freeze({
   DELETE_CRDT: 5,
   DELETE_OBJECT_KEY: 6,
   CREATE_MAP: 7,
-  CREATE_REGISTER: 8
+  CREATE_REGISTER: 8,
+  CREATE_TEXT: 9,
+  UPDATE_TEXT: 10
 });
 function isIgnoredOp(op) {
   return op.type === OpCode.DELETE_CRDT && op.id === "ACK";
 }
 function isCreateOp(op) {
-  return op.type === OpCode.CREATE_OBJECT || op.type === OpCode.CREATE_REGISTER || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_LIST;
+  return op.type === OpCode.CREATE_OBJECT || op.type === OpCode.CREATE_REGISTER || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_LIST || op.type === OpCode.CREATE_TEXT;
 }
 
 // src/protocol/StorageNode.ts
@@ -5851,7 +5854,8 @@ var CrdtType = Object.freeze({
   OBJECT: 0,
   LIST: 1,
   MAP: 2,
-  REGISTER: 3
+  REGISTER: 3,
+  TEXT: 4
 });
 function isRootStorageNode(node) {
   return node[0] === "root";
@@ -5868,6 +5872,9 @@ function isMapStorageNode(node) {
 function isRegisterStorageNode(node) {
   return node[1].type === CrdtType.REGISTER;
 }
+function isTextStorageNode(node) {
+  return node[1].type === CrdtType.TEXT;
+}
 function isCompactRootNode(node) {
   return node[0] === "root";
 }
@@ -5890,6 +5897,9 @@ function* compactNodesToNodeStream(compactNodes) {
       case CrdtType.REGISTER:
         yield [cnode[0], { type: CrdtType.REGISTER, parentId: cnode[2], parentKey: cnode[3], data: cnode[4] }];
         break;
+      case CrdtType.TEXT:
+        yield [cnode[0], { type: CrdtType.TEXT, parentId: cnode[2], parentKey: cnode[3], data: cnode[4], version: cnode[5] }];
+        break;
       default:
     }
   }
@@ -5918,6 +5928,17 @@ function* nodeStreamToCompactNodes(nodes) {
       const id = node[0];
       const crdt = node[1];
       yield [id, CrdtType.REGISTER, crdt.parentId, crdt.parentKey, crdt.data];
+    } else if (isTextStorageNode(node)) {
+      const id = node[0];
+      const crdt = node[1];
+      yield [
+        id,
+        CrdtType.TEXT,
+        crdt.parentId,
+        crdt.parentKey,
+        crdt.data,
+        crdt.version
+      ];
     } else {
     }
   }
@@ -6120,6 +6141,10 @@ ${parentKey}`;
   get size() {
     return this.#byOpId.size;
   }
+  /** The still-unacknowledged op with the given opId, if any. */
+  get(opId) {
+    return this.#byOpId.get(opId);
+  }
   /**
    * Mark the given Op as still unacknowledged.
    */
@@ -6219,8 +6244,8 @@ function createManagedPool(options) {
     deleteNode: (id) => void nodes.delete(id),
     generateId: () => `${getCurrentConnectionId()}:${clock++}`,
     generateOpId: () => `${getCurrentConnectionId()}:${opClock++}`,
-    dispatch(ops, reverse, storageUpdates) {
-      _optionalChain([onDispatch, 'optionalCall', _129 => _129(ops, reverse, storageUpdates)]);
+    dispatch(ops, reverse, storageUpdates, options2) {
+      _optionalChain([onDispatch, 'optionalCall', _129 => _129(ops, reverse, storageUpdates, options2)]);
     },
     assertStorageIsWritable: () => {
       if (!isStorageWritable()) {
@@ -6243,10 +6268,17 @@ function Orphaned(oldKey, oldPos = asPos(oldKey)) {
   return Object.freeze({ type: "Orphaned", oldKey, oldPos });
 }
 var AbstractCrdt = class {
-  //                  ^^^^^^^^^^^^ TODO: Make this an interface
   #pool;
   #id;
   #parent = NoParent;
+  constructor() {
+    Object.defineProperty(this, kInternal, {
+      value: {
+        getId: () => this.#id
+      },
+      enumerable: false
+    });
+  }
   /** @internal */
   _getParentKeyOrThrow() {
     switch (this.parent.type) {
@@ -8776,6 +8808,1114 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
   }
 }, _class2.__initStatic(), _class2);
 
+// src/crdts/liveTextOps.ts
+function attributesEqual(left, right) {
+  if (left === right) {
+    return true;
+  }
+  if (left === void 0 || right === void 0) {
+    return false;
+  }
+  const leftKeys = Object.keys(left);
+  const rightKeys = Object.keys(right);
+  if (leftKeys.length !== rightKeys.length) {
+    return false;
+  }
+  for (const key of leftKeys) {
+    if (left[key] !== right[key]) {
+      return false;
+    }
+  }
+  return true;
+}
+function cloneAttributes(attributes) {
+  return attributes === void 0 ? void 0 : freeze({ ...attributes });
+}
+function normalizeSegments(segments) {
+  const normalized = [];
+  for (const segment of segments) {
+    if (segment.text.length === 0) {
+      continue;
+    }
+    const last = normalized.at(-1);
+    const attributes = cloneAttributes(segment.attributes);
+    if (last !== void 0 && attributesEqual(last.attributes, attributes)) {
+      last.text += segment.text;
+    } else {
+      normalized.push({ text: segment.text, attributes });
+    }
+  }
+  return normalized;
+}
+function dataToSegments(data) {
+  return normalizeSegments(
+    data.map(([text, attributes]) => ({
+      text,
+      attributes
+    }))
+  );
+}
+function segmentsToData(segments) {
+  return segments.map(
+    (segment) => segment.attributes === void 0 ? [segment.text] : [segment.text, { ...segment.attributes }]
+  );
+}
+function textLength(segments) {
+  return segments.reduce((sum, segment) => sum + segment.text.length, 0);
+}
+function splitSegmentsAt(segments, index) {
+  const result = [];
+  let offset = 0;
+  for (const segment of segments) {
+    const end = offset + segment.text.length;
+    if (index > offset && index < end) {
+      const before2 = segment.text.slice(0, index - offset);
+      const after2 = segment.text.slice(index - offset);
+      result.push({ text: before2, attributes: segment.attributes });
+      result.push({ text: after2, attributes: segment.attributes });
+    } else {
+      result.push({ text: segment.text, attributes: segment.attributes });
+    }
+    offset = end;
+  }
+  return result;
+}
+function clipRange(index, length, contentLength) {
+  const clippedIndex = Math.max(0, Math.min(index, contentLength));
+  const clippedEnd = Math.max(
+    clippedIndex,
+    Math.min(index + length, contentLength)
+  );
+  return { index: clippedIndex, length: clippedEnd - clippedIndex };
+}
+function applyInsert(segments, index, text, attributes) {
+  if (text.length === 0) {
+    return normalizeSegments(segments);
+  }
+  const split = splitSegmentsAt(segments, index);
+  const result = [];
+  let offset = 0;
+  let inserted = false;
+  for (const segment of split) {
+    if (!inserted && offset === index) {
+      result.push({ text, attributes });
+      inserted = true;
+    }
+    result.push(segment);
+    offset += segment.text.length;
+  }
+  if (!inserted) {
+    result.push({ text, attributes });
+  }
+  return normalizeSegments(result);
+}
+function extractDeletedSegments(segments, index, length) {
+  const split = splitSegmentsAt(
+    splitSegmentsAt(segments, index),
+    index + length
+  );
+  const deleted = [];
+  let offset = 0;
+  for (const segment of split) {
+    const end = offset + segment.text.length;
+    if (offset >= index && end <= index + length) {
+      deleted.push({
+        text: segment.text,
+        attributes: segment.attributes
+      });
+    }
+    offset = end;
+  }
+  return normalizeSegments(deleted);
+}
+function applyDelete(segments, index, length) {
+  const deletedSegments = extractDeletedSegments(segments, index, length);
+  const split = splitSegmentsAt(
+    splitSegmentsAt(segments, index),
+    index + length
+  );
+  const result = [];
+  let offset = 0;
+  let deletedText = "";
+  for (const segment of split) {
+    const end = offset + segment.text.length;
+    if (offset >= index && end <= index + length) {
+      deletedText += segment.text;
+    } else {
+      result.push(segment);
+    }
+    offset = end;
+  }
+  return {
+    segments: normalizeSegments(result),
+    deletedText,
+    deletedSegments
+  };
+}
+function applyFormat(segments, index, length, attributes) {
+  const split = splitSegmentsAt(
+    splitSegmentsAt(segments, index),
+    index + length
+  );
+  const result = [];
+  let offset = 0;
+  for (const segment of split) {
+    const end = offset + segment.text.length;
+    if (offset >= index && end <= index + length) {
+      const nextAttributes = {
+        ..._nullishCoalesce(segment.attributes, () => ( {}))
+      };
+      for (const [key, value] of Object.entries(attributes)) {
+        if (value === null) {
+          delete nextAttributes[key];
+        } else {
+          nextAttributes[key] = value;
+        }
+      }
+      result.push({
+        text: segment.text,
+        attributes: Object.keys(nextAttributes).length === 0 ? void 0 : freeze(nextAttributes)
+      });
+    } else {
+      result.push(segment);
+    }
+    offset = end;
+  }
+  return normalizeSegments(result);
+}
+function formatReverseOperations(segments, index, length, patch) {
+  const split = splitSegmentsAt(
+    splitSegmentsAt(segments, index),
+    index + length
+  );
+  const result = [];
+  let offset = 0;
+  for (const segment of split) {
+    const end = offset + segment.text.length;
+    if (offset >= index && end <= index + length) {
+      const attributes = {};
+      for (const key of Object.keys(patch)) {
+        attributes[key] = _nullishCoalesce(_optionalChain([segment, 'access', _217 => _217.attributes, 'optionalAccess', _218 => _218[key]]), () => ( null));
+      }
+      result.push({
+        type: "format",
+        index: offset,
+        length: segment.text.length,
+        attributes
+      });
+    }
+    offset = end;
+  }
+  return result;
+}
+function mapIndexThroughOperation(index, op) {
+  if (op.type === "insert") {
+    return op.index <= index ? index + op.text.length : index;
+  } else if (op.type === "delete") {
+    if (op.index >= index) {
+      return index;
+    }
+    return Math.max(op.index, index - op.length);
+  } else {
+    return index;
+  }
+}
+function mapTextIndexThroughOperations(index, ops) {
+  let mapped = index;
+  for (const op of ops) {
+    mapped = mapIndexThroughOperation(mapped, op);
+  }
+  return mapped;
+}
+function inverseMapIndexThroughOperation(index, op) {
+  if (op.type === "insert") {
+    if (index <= op.index) {
+      return index;
+    }
+    return Math.max(op.index, index - op.text.length);
+  } else if (op.type === "delete") {
+    return op.index <= index ? index + op.length : index;
+  } else {
+    return index;
+  }
+}
+function inverseMapTextIndexThroughOperations(index, ops) {
+  let mapped = index;
+  for (let i = ops.length - 1; i >= 0; i--) {
+    mapped = inverseMapIndexThroughOperation(mapped, ops[i]);
+  }
+  return mapped;
+}
+function oppositeOrder(order) {
+  return order === "before" ? "after" : "before";
+}
+function mapIndexOverDelete(index, deleteIndex, deleteLength) {
+  if (deleteIndex >= index) {
+    return index;
+  }
+  return Math.max(deleteIndex, index - deleteLength);
+}
+function transformInsert(op, over, order) {
+  if (over.type === "insert") {
+    const shifts = over.index < op.index || over.index === op.index && order === "after";
+    return [shifts ? { ...op, index: op.index + over.text.length } : { ...op }];
+  } else if (over.type === "delete") {
+    return [
+      { ...op, index: mapIndexOverDelete(op.index, over.index, over.length) }
+    ];
+  } else {
+    return [{ ...op }];
+  }
+}
+function transformDelete(op, over) {
+  const start = op.index;
+  const end = op.index + op.length;
+  if (over.type === "insert") {
+    const at = over.index;
+    const len = over.text.length;
+    if (at <= start) {
+      return [{ ...op, index: start + len }];
+    }
+    if (at >= end) {
+      return [{ ...op }];
+    }
+    return [
+      { type: "delete", index: start, length: at - start },
+      { type: "delete", index: start + len, length: end - at }
+    ];
+  } else if (over.type === "delete") {
+    const newStart = mapIndexOverDelete(start, over.index, over.length);
+    const newEnd = mapIndexOverDelete(end, over.index, over.length);
+    return newEnd - newStart > 0 ? [{ type: "delete", index: newStart, length: newEnd - newStart }] : [];
+  } else {
+    return [{ ...op }];
+  }
+}
+function transformFormat(op, over, order) {
+  const start = op.index;
+  const end = op.index + op.length;
+  if (over.type === "insert") {
+    const at = over.index;
+    const len = over.text.length;
+    if (at <= start) {
+      return [{ ...op, index: start + len }];
+    }
+    if (at >= end) {
+      return [{ ...op }];
+    }
+    return [
+      {
+        type: "format",
+        index: start,
+        length: at - start,
+        attributes: op.attributes
+      },
+      {
+        type: "format",
+        index: at + len,
+        length: end - at,
+        attributes: op.attributes
+      }
+    ];
+  } else if (over.type === "delete") {
+    const newStart = mapIndexOverDelete(start, over.index, over.length);
+    const newEnd = mapIndexOverDelete(end, over.index, over.length);
+    return newEnd - newStart > 0 ? [
+      {
+        type: "format",
+        index: newStart,
+        length: newEnd - newStart,
+        attributes: op.attributes
+      }
+    ] : [];
+  } else {
+    if (order === "after") {
+      return [{ ...op }];
+    }
+    const overlapStart = Math.max(start, over.index);
+    const overlapEnd = Math.min(end, over.index + over.length);
+    if (overlapStart >= overlapEnd) {
+      return [{ ...op }];
+    }
+    const hasConflict = Object.keys(op.attributes).some(
+      (key) => key in over.attributes
+    );
+    if (!hasConflict) {
+      return [{ ...op }];
+    }
+    const reduced = {};
+    for (const [key, value] of Object.entries(op.attributes)) {
+      if (!(key in over.attributes)) {
+        reduced[key] = value;
+      }
+    }
+    const pieces = [];
+    if (start < overlapStart) {
+      pieces.push({
+        type: "format",
+        index: start,
+        length: overlapStart - start,
+        attributes: op.attributes
+      });
+    }
+    if (Object.keys(reduced).length > 0) {
+      pieces.push({
+        type: "format",
+        index: overlapStart,
+        length: overlapEnd - overlapStart,
+        attributes: reduced
+      });
+    }
+    if (overlapEnd < end) {
+      pieces.push({
+        type: "format",
+        index: overlapEnd,
+        length: end - overlapEnd,
+        attributes: op.attributes
+      });
+    }
+    return pieces;
+  }
+}
+function transformSingle(op, over, order) {
+  switch (op.type) {
+    case "insert":
+      return transformInsert(op, over, order);
+    case "delete":
+      return transformDelete(op, over);
+    case "format":
+      return transformFormat(op, over, order);
+  }
+}
+function transformTextOperationsX(a, b, order) {
+  if (a.length === 0 || b.length === 0) {
+    return [[...a], [...b]];
+  }
+  if (a.length === 1 && b.length === 1) {
+    return [
+      transformSingle(a[0], b[0], order),
+      transformSingle(b[0], a[0], oppositeOrder(order))
+    ];
+  }
+  if (a.length > 1) {
+    const [headA1, b1] = transformTextOperationsX([a[0]], b, order);
+    const [restA1, b2] = transformTextOperationsX(a.slice(1), b1, order);
+    return [[...headA1, ...restA1], b2];
+  }
+  const [a1, headB1] = transformTextOperationsX(a, [b[0]], order);
+  const [a2, restB1] = transformTextOperationsX(a1, b.slice(1), order);
+  return [a2, [...headB1, ...restB1]];
+}
+function transformTextOperations(ops, over, order) {
+  return transformTextOperationsX(ops, over, order)[0];
+}
+function textOperationsEqual(a, b) {
+  return a === b || stableStringify(a) === stableStringify(b);
+}
+function applyTextOperationsToSegments(segments, ops) {
+  let next = [...segments];
+  for (const op of ops) {
+    if (op.type === "insert") {
+      const index = Math.max(0, Math.min(op.index, textLength(next)));
+      next = applyInsert(next, index, op.text, op.attributes);
+    } else if (op.type === "delete") {
+      const index = Math.max(0, Math.min(op.index, textLength(next)));
+      const clipped = clipRange(index, op.length, textLength(next));
+      next = applyDelete(next, clipped.index, clipped.length).segments;
+    } else {
+      const index = Math.max(0, Math.min(op.index, textLength(next)));
+      const clipped = clipRange(index, op.length, textLength(next));
+      next = applyFormat(next, clipped.index, clipped.length, op.attributes);
+    }
+  }
+  return next;
+}
+function applyLiveTextOperations(data, ops) {
+  return segmentsToData(
+    applyTextOperationsToSegments(dataToSegments(data), ops)
+  );
+}
+function invertTextOperations(segments, ops) {
+  let shadow = [...segments];
+  const reverse = [];
+  for (const op of ops) {
+    if (op.type === "insert") {
+      shadow = applyInsert(shadow, op.index, op.text, op.attributes);
+      reverse.unshift({
+        type: "delete",
+        index: op.index,
+        length: op.text.length
+      });
+    } else if (op.type === "delete") {
+      const deletedSegments = extractDeletedSegments(
+        shadow,
+        op.index,
+        op.length
+      );
+      shadow = applyDelete(shadow, op.index, op.length).segments;
+      const inserts = [];
+      let insertIndex = op.index;
+      for (const segment of deletedSegments) {
+        inserts.push({
+          type: "insert",
+          index: insertIndex,
+          text: segment.text,
+          attributes: segment.attributes
+        });
+        insertIndex += segment.text.length;
+      }
+      for (let index = inserts.length - 1; index >= 0; index--) {
+        reverse.unshift(inserts[index]);
+      }
+    } else {
+      const inverse = formatReverseOperations(
+        shadow,
+        op.index,
+        op.length,
+        op.attributes
+      );
+      shadow = applyFormat(shadow, op.index, op.length, op.attributes);
+      reverse.unshift(...inverse.reverse());
+    }
+  }
+  return reverse;
+}
+
+// src/crdts/LiveText.ts
+var ACCEPTED_OPS_HISTORY_LIMIT = 1e3;
+var LiveText = class _LiveText extends AbstractCrdt {
+  /** The local document: #confirmed ⊕ #inFlightOps ⊕ #queuedOps. */
+  #segments;
+  /** The server-confirmed document (only authoritative ops applied). */
+  #confirmed;
+  #version;
+  /** The op currently awaiting server acknowledgement (at most one). */
+  #inFlightOpId;
+  /** Its ops, continuously re-expressed against current server state. */
+  #inFlightOps = [];
+  /** Local edits made while an op is in flight; sent after the ack. */
+  #queuedOps = [];
+  #acceptedOps = [];
+  /**
+   * Creates a new LiveText document.
+   *
+   * @param textOrData Initial plain text, or an array of `[text]` /
+   *   `[text, attributes]` segments. Defaults to an empty document.
+   *
+   * @example
+   * new LiveText();
+   * new LiveText("Hello world");
+   * new LiveText([["Hello ", { bold: true }], ["world"]]);
+   */
+  constructor(textOrData = "", version = 0) {
+    super();
+    this.#segments = typeof textOrData === "string" ? textOrData.length === 0 ? [] : [{ text: textOrData }] : dataToSegments(textOrData);
+    this.#confirmed = [...this.#segments];
+    this.#version = version;
+    Object.assign(this[kInternal], {
+      encodeIndex: (localIndex) => this.#encodeIndex(localIndex),
+      decodeIndex: (index, fromVersion) => this.#decodeIndex(index, fromVersion)
+    });
+  }
+  get version() {
+    return this.#version;
+  }
+  get length() {
+    return textLength(this.#segments);
+  }
+  /** @internal */
+  static _deserialize([id, item], _parentToChildren, pool) {
+    const text = new _LiveText(item.data, item.version);
+    text._attach(id, pool);
+    return text;
+  }
+  /** @internal */
+  _toOps(parentId, parentKey) {
+    if (this._id === void 0) {
+      throw new Error("Cannot serialize LiveText if it is not attached");
+    }
+    return [
+      {
+        type: OpCode.CREATE_TEXT,
+        id: this._id,
+        parentId,
+        parentKey,
+        data: this.toJSON(),
+        version: this.#version
+      }
+    ];
+  }
+  /** @internal */
+  _serialize() {
+    if (this.parent.type !== "HasParent") {
+      throw new Error("Cannot serialize LiveText if parent is missing");
+    }
+    return {
+      type: CrdtType.TEXT,
+      parentId: nn(this.parent.node._id, "Parent node expected to have ID"),
+      parentKey: this.parent.key,
+      data: this.toJSON(),
+      version: this.#version
+    };
+  }
+  /** @internal */
+  _attachChild(_op) {
+    throw new Error("LiveText cannot contain child nodes");
+  }
+  /** @internal */
+  _detachChild(_crdt) {
+    throw new Error("LiveText cannot contain child nodes");
+  }
+  /** @internal */
+  _apply(op, isLocal) {
+    if (op.type !== OpCode.UPDATE_TEXT) {
+      return super._apply(op, isLocal);
+    }
+    if (isLocal) {
+      return this.#applyLocal(op);
+    }
+    if (op.opId !== void 0 && op.opId === this.#inFlightOpId) {
+      return this.#applyAck(op);
+    }
+    if (op.opId !== void 0 && this.#acceptedOps.some((entry) => entry.opId === op.opId)) {
+      this.#version = Math.max(this.#version, _nullishCoalesce(op.version, () => ( op.baseVersion + 1)));
+      return { modified: false };
+    }
+    return this.#applyRemote(op);
+  }
+  /**
+   * Inserts text at the given index.
+   *
+   * @param index Character index at which to insert. Values outside the
+   *   document range are clipped.
+   * @param text Text to insert.
+   * @param attributes Optional inline attributes for the inserted text.
+   *
+   * @example
+   * const text = new LiveText("Hello");
+   * text.insert(5, " world");
+   * text.insert(0, "Say: ", { italic: true });
+   */
+  insert(index, text, attributes) {
+    const clippedIndex = Math.max(0, Math.min(index, this.length));
+    this.#dispatch([{ type: "insert", index: clippedIndex, text, attributes }]);
+  }
+  /**
+   * Deletes `length` characters starting at `index`.
+   *
+   * @example
+   * const text = new LiveText("Hello world");
+   * text.delete(5, 6); // "Hello"
+   */
+  delete(index, length) {
+    const clipped = clipRange(index, length, this.length);
+    if (clipped.length === 0) {
+      return;
+    }
+    this.#dispatch([
+      { type: "delete", index: clipped.index, length: clipped.length }
+    ]);
+  }
+  /**
+   * Replaces a range of text with new text.
+   *
+   * @example
+   * const text = new LiveText("Hello world");
+   * text.replace(0, 5, "Hi"); // "Hi world"
+   */
+  replace(index, length, text, attributes) {
+    const clipped = clipRange(index, length, this.length);
+    const ops = [];
+    if (clipped.length > 0) {
+      ops.push({
+        type: "delete",
+        index: clipped.index,
+        length: clipped.length
+      });
+    }
+    if (text.length > 0) {
+      ops.push({ type: "insert", index: clipped.index, text, attributes });
+    }
+    this.#dispatch(ops);
+  }
+  /**
+   * Encode a local-document index (an offset into this LiveText's current
+   * #segments, which CodeMirror or any consumer mirrors as its document)
+   * into server-confirmed coordinates suitable for broadcasting to peers via
+   * presence or any other side channel.
+   *
+   * The returned index is in this LiveText's current #confirmed coordinates
+   * — that is, with this client's local pending ops inverse-mapped out.
+   * Pair it with the current {@link LiveText.version} when sending so the
+   * receiver can call {@link PrivateLiveTextApi.decodeIndex} to land the
+   * position in their own local document coordinates regardless of their
+   * private pending ops.
+   *
+   * Index ambiguity at boundaries is resolved by an inverse-of-forward
+   * convention: a position at or before a local insertion is reported as
+   * the position right before the insertion in #confirmed; a position past
+   * the insertion shifts left by the insertion's length. Positions inside
+   * an own-pending insertion collapse to the insertion point.
+   */
+  #encodeIndex(localIndex) {
+    let mapped = Math.max(0, Math.min(localIndex, this.length));
+    mapped = inverseMapTextIndexThroughOperations(mapped, this.#queuedOps);
+    mapped = inverseMapTextIndexThroughOperations(mapped, this.#inFlightOps);
+    return mapped;
+  }
+  /**
+   * Decode an `(index, fromVersion)` pair produced by
+   * {@link PrivateLiveTextApi.encodeIndex} — typically on a peer — into an
+   * offset in this LiveText's current local document (an index suitable for
+   * placing a CodeMirror marker, an annotation anchor, or anything else that
+   * lives over #segments).
+   *
+   * Composes the accepted ops applied since `fromVersion` (drawn from
+   * #acceptedOps in locally-applied form) with this client's own local
+   * pending ops, in that order. The result is in current #segments
+   * coordinates.
+   *
+   * Returns `null` when the position cannot be decoded against the current
+   * state:
+   *  - `fromVersion` is greater than this LiveText's current version: the
+   *    peer is ahead of us. The caller should park the message and retry
+   *    after more accepted ops arrive.
+   *  - `fromVersion` falls outside the retained accepted-ops history. This
+   *    only happens after very long-lived disconnections; the caller can
+   *    fall back to using the raw index and letting subsequent local
+   *    transactions map it (with bounded drift).
+   */
+  #decodeIndex(index, fromVersion) {
+    if (fromVersion > this.#version) {
+      return null;
+    }
+    if (fromVersion < this.#version) {
+      const oldest = _optionalChain([this, 'access', _219 => _219.#acceptedOps, 'access', _220 => _220[0], 'optionalAccess', _221 => _221.version]);
+      if (oldest === void 0 || oldest > fromVersion + 1) {
+        return null;
+      }
+    }
+    let mapped = index;
+    for (const entry of this.#acceptedOps) {
+      if (entry.version <= fromVersion) continue;
+      if (entry.version > this.#version) break;
+      if (entry.ops.length === 0) continue;
+      mapped = mapTextIndexThroughOperations(mapped, entry.ops);
+    }
+    mapped = mapTextIndexThroughOperations(mapped, this.#inFlightOps);
+    mapped = mapTextIndexThroughOperations(mapped, this.#queuedOps);
+    return Math.max(0, Math.min(mapped, this.length));
+  }
+  /**
+   * Applies or removes inline attributes on a range of text.
+   *
+   * Set an attribute to `null` to remove it from the range.
+   *
+   * @example
+   * const text = new LiveText("Hello world");
+   * text.format(0, 5, { bold: true });
+   * text.format(0, 5, { bold: null });
+   */
+  format(index, length, attributes) {
+    const clipped = clipRange(index, length, this.length);
+    if (clipped.length === 0) {
+      return;
+    }
+    this.#dispatch([
+      {
+        type: "format",
+        index: clipped.index,
+        length: clipped.length,
+        attributes
+      }
+    ]);
+  }
+  /** Local edits made through the public API. */
+  #dispatch(ops) {
+    if (ops.length === 0) {
+      return;
+    }
+    _optionalChain([this, 'access', _222 => _222._pool, 'optionalAccess', _223 => _223.assertStorageIsWritable, 'call', _224 => _224()]);
+    const attached = this._pool !== void 0 && this._id !== void 0;
+    const reverse = attached ? this.#invertOperations(ops) : [];
+    const changes = this.#applyOperationsLocally(ops);
+    if (!attached) {
+      return;
+    }
+    const pool = nn(this._pool);
+    const id = nn(this._id);
+    const updates = /* @__PURE__ */ new Map([
+      [
+        id,
+        {
+          type: "LiveText",
+          node: this,
+          version: this.#version,
+          updates: changes
+        }
+      ]
+    ]);
+    if (this.#inFlightOpId === void 0) {
+      const opId = pool.generateOpId();
+      this.#inFlightOpId = opId;
+      this.#inFlightOps = [...ops];
+      pool.dispatch(
+        [
+          {
+            type: OpCode.UPDATE_TEXT,
+            id,
+            opId,
+            baseVersion: this.#version,
+            ops: [...ops]
+          }
+        ],
+        reverse,
+        updates
+      );
+    } else {
+      this.#queuedOps.push(...ops);
+      pool.dispatch([], reverse, updates, { clearRedoStack: true });
+    }
+  }
+  /**
+   * A local replay of an existing wire op: an undo/redo frame, or an
+   * unacknowledged op re-sent after a reconnect.
+   */
+  #applyLocal(op) {
+    const mutableOp = op;
+    if (op.opId !== void 0 && op.opId === this.#inFlightOpId) {
+      this.#inFlightOps = [...this.#inFlightOps, ...this.#queuedOps];
+      this.#queuedOps = [];
+      mutableOp.baseVersion = this.#version;
+      mutableOp.ops = [...this.#inFlightOps];
+      return { modified: false };
+    }
+    let ops = op.ops;
+    for (const entry of this.#acceptedOps) {
+      if (entry.version > op.baseVersion && entry.ops.length > 0) {
+        ops = transformTextOperations(ops, entry.ops, "after");
+      }
+    }
+    const reverse = this.#invertOperations(ops);
+    const changes = this.#applyOperationsLocally(ops);
+    if (this.#inFlightOpId === void 0 && ops.length > 0) {
+      this.#inFlightOpId = nn(op.opId, "Local ops must have an opId");
+      this.#inFlightOps = [...ops];
+      mutableOp.baseVersion = this.#version;
+      mutableOp.ops = [...ops];
+    } else {
+      this.#queuedOps.push(...ops);
+      mutableOp.baseVersion = this.#version;
+      mutableOp.ops = [];
+    }
+    if (changes.length === 0) {
+      return { modified: false };
+    }
+    return {
+      reverse,
+      modified: {
+        type: "LiveText",
+        node: this,
+        version: this.#version,
+        updates: changes
+      }
+    };
+  }
+  /** Server acknowledgement of our in-flight op. */
+  #applyAck(op) {
+    const ackedVersion = _nullishCoalesce(op.version, () => ( Math.max(this.#version, op.baseVersion + 1)));
+    const predicted = this.#inFlightOps;
+    const opId = this.#inFlightOpId;
+    this.#confirmed = applyTextOperationsToSegments(this.#confirmed, op.ops);
+    this.#inFlightOpId = void 0;
+    this.#inFlightOps = [];
+    let appliedOps = [];
+    let result = { modified: false };
+    if (!textOperationsEqual(op.ops, predicted)) {
+      error2(
+        "LiveText: acknowledgement did not match the local prediction; resynchronizing"
+      );
+      const rebuilt = this.#rebuildLocalFromConfirmed();
+      appliedOps = rebuilt.appliedOps;
+      if (rebuilt.changes.length > 0) {
+        result = {
+          reverse: [],
+          modified: {
+            type: "LiveText",
+            node: this,
+            version: ackedVersion,
+            updates: rebuilt.changes
+          }
+        };
+      }
+    }
+    this.#version = Math.max(this.#version, ackedVersion);
+    this.#recordAccepted(ackedVersion, appliedOps, opId);
+    this.#flushQueued();
+    return result;
+  }
+  /** An accepted op from another client (or a server-fabricated fix op). */
+  #applyRemote(op) {
+    const version = _nullishCoalesce(op.version, () => ( this.#version + 1));
+    this.#confirmed = applyTextOperationsToSegments(this.#confirmed, op.ops);
+    const [overInFlight, inFlight] = transformTextOperationsX(
+      op.ops,
+      this.#inFlightOps,
+      "before"
+    );
+    const [applied, queued] = transformTextOperationsX(
+      overInFlight,
+      this.#queuedOps,
+      "before"
+    );
+    this.#inFlightOps = inFlight;
+    this.#queuedOps = queued;
+    this.#recordAccepted(version, applied, op.opId);
+    if (applied.length === 0) {
+      this.#version = Math.max(this.#version, version);
+      return { modified: false };
+    }
+    const reverse = this.#invertOperations(applied);
+    const changes = this.#applyOperationsLocally(applied);
+    this.#version = Math.max(this.#version, version);
+    return {
+      reverse,
+      modified: {
+        type: "LiveText",
+        node: this,
+        version: this.#version,
+        updates: changes
+      }
+    };
+  }
+  /** Send the queued ops as the next in-flight op (after an ack). */
+  #flushQueued() {
+    if (this.#queuedOps.length === 0 || this._pool === void 0 || this._id === void 0) {
+      return;
+    }
+    const opId = this._pool.generateOpId();
+    this.#inFlightOpId = opId;
+    this.#inFlightOps = this.#queuedOps;
+    this.#queuedOps = [];
+    this._pool.dispatch(
+      [
+        {
+          type: OpCode.UPDATE_TEXT,
+          id: this._id,
+          opId,
+          baseVersion: this.#version,
+          ops: [...this.#inFlightOps]
+        }
+      ],
+      [],
+      /* @__PURE__ */ new Map(),
+      // The local content was already applied (and made undoable) when the
+      // edits happened; this is purely an outbound flush.
+      { clearRedoStack: false }
+    );
+  }
+  /**
+   * Rebuild the local document as confirmed ⊕ queued ops, returning the
+   * coarse delta that was applied. Only used by defensive recovery paths.
+   */
+  #rebuildLocalFromConfirmed() {
+    const before2 = this.#segments;
+    const after2 = applyTextOperationsToSegments(this.#confirmed, [
+      ...this.#inFlightOps,
+      ...this.#queuedOps
+    ]);
+    if (stableStringify(segmentsToData(before2)) === stableStringify(segmentsToData(after2))) {
+      this.#segments = after2;
+      return { appliedOps: [], changes: [] };
+    }
+    const beforeText = before2.map((segment) => segment.text).join("");
+    this.#segments = after2;
+    this.invalidate();
+    const appliedOps = [];
+    const changes = [];
+    if (beforeText.length > 0) {
+      appliedOps.push({ type: "delete", index: 0, length: beforeText.length });
+      changes.push({
+        type: "delete",
+        index: 0,
+        length: beforeText.length,
+        deletedText: beforeText
+      });
+    }
+    let index = 0;
+    for (const segment of after2) {
+      appliedOps.push({
+        type: "insert",
+        index,
+        text: segment.text,
+        attributes: segment.attributes
+      });
+      changes.push({
+        type: "insert",
+        index,
+        text: segment.text,
+        attributes: segment.attributes
+      });
+      index += segment.text.length;
+    }
+    return { appliedOps, changes };
+  }
+  /**
+   * Reconcile this node against an authoritative storage snapshot (e.g.
+   * after a reconnect). The confirmed state and version are replaced by the
+   * snapshot's; pending (in-flight + queued) ops are preserved on top and
+   * will be re-sent by the offline-ops replay.
+   *
+   * @internal
+   */
+  _resyncText(data, version) {
+    this.#confirmed = dataToSegments(data);
+    this.#version = version;
+    this.#acceptedOps = [];
+    const rebuilt = this.#rebuildLocalFromConfirmed();
+    if (rebuilt.changes.length === 0) {
+      return void 0;
+    }
+    return {
+      type: "LiveText",
+      node: this,
+      version: this.#version,
+      updates: rebuilt.changes
+    };
+  }
+  /**
+   * Called when the server rejected one of our ops. Drops all pending state
+   * for this node (edits queued behind a rejected op cannot be trusted
+   * either); the room follows up with a storage resync.
+   *
+   * @internal
+   */
+  _rejectPendingOp(opId) {
+    if (opId !== this.#inFlightOpId) {
+      return;
+    }
+    this.#inFlightOpId = void 0;
+    this.#inFlightOps = [];
+    this.#queuedOps = [];
+  }
+  #recordAccepted(version, ops, opId) {
+    if (this.#acceptedOps.some((entry) => entry.version === version)) {
+      return;
+    }
+    this.#acceptedOps.push({ version, opId, ops: [...ops] });
+    this.#acceptedOps.sort((left, right) => left.version - right.version);
+    if (this.#acceptedOps.length > ACCEPTED_OPS_HISTORY_LIMIT) {
+      this.#acceptedOps.splice(
+        0,
+        this.#acceptedOps.length - ACCEPTED_OPS_HISTORY_LIMIT
+      );
+    }
+  }
+  #applyOperationsLocally(ops) {
+    const changes = [];
+    for (const op of ops) {
+      if (op.type === "insert") {
+        this.#segments = applyInsert(
+          this.#segments,
+          op.index,
+          op.text,
+          op.attributes
+        );
+        changes.push({
+          type: "insert",
+          index: op.index,
+          text: op.text,
+          attributes: op.attributes
+        });
+      } else if (op.type === "delete") {
+        const result = applyDelete(this.#segments, op.index, op.length);
+        this.#segments = result.segments;
+        changes.push({
+          type: "delete",
+          index: op.index,
+          length: op.length,
+          deletedText: result.deletedText
+        });
+      } else {
+        this.#segments = applyFormat(
+          this.#segments,
+          op.index,
+          op.length,
+          op.attributes
+        );
+        changes.push({
+          type: "format",
+          index: op.index,
+          length: op.length,
+          attributes: op.attributes
+        });
+      }
+    }
+    this.invalidate();
+    return changes;
+  }
+  #invertOperations(ops) {
+    return [
+      {
+        type: OpCode.UPDATE_TEXT,
+        id: nn(this._id),
+        baseVersion: this.#version,
+        ops: invertTextOperations(this.#segments, ops)
+      }
+    ];
+  }
+  /** Returns the plain text content without attributes. Equivalent to joining the text from each segment in {@link LiveText.toJSON}. */
+  toString() {
+    return this.#segments.map((segment) => segment.text).join("");
+  }
+  /**
+   * Returns a JSON-compatible snapshot of the document as a {@link LiveTextData}
+   * array.
+   *
+   * @example
+   * new LiveText([["Hello ", { bold: true }], ["world"]]).toJSON();
+   * // [["Hello ", { bold: true }], ["world"]]
+   */
+  toJSON() {
+    return super.toJSON();
+  }
+  /** @internal */
+  _toJSON() {
+    return segmentsToData(this.#segments);
+  }
+  /** @internal */
+  toTreeNode(key) {
+    return super.toTreeNode(key);
+  }
+  /** @internal */
+  _toTreeNode(key) {
+    const nodeId = _nullishCoalesce(this._id, () => ( nanoid()));
+    const payload = this.toJSON().map(
+      (segment, index) => ({
+        type: "Json",
+        id: `${nodeId}:${index}`,
+        key: String(index),
+        payload: segment
+      })
+    );
+    payload.push({
+      type: "Json",
+      id: `${nodeId}:version`,
+      key: "version",
+      payload: this.version
+    });
+    return {
+      type: "LiveText",
+      id: nodeId,
+      key,
+      payload
+    };
+  }
+  clone() {
+    return new _LiveText(this.toJSON(), this.#version);
+  }
+};
+
 // src/crdts/liveblocks-helpers.ts
 function creationOpToLiveNode(op) {
   return lsonToLiveNode(creationOpToLson(op));
@@ -8790,6 +9930,8 @@ function creationOpToLson(op) {
       return new LiveMap();
     case OpCode.CREATE_LIST:
       return new LiveList([]);
+    case OpCode.CREATE_TEXT:
+      return new LiveText(op.data, op.version);
     default:
       return assertNever(op, "Unknown creation Op");
   }
@@ -8822,6 +9964,8 @@ function deserialize(node, parentToChildren, pool) {
     return LiveMap._deserialize(node, parentToChildren, pool);
   } else if (isRegisterStorageNode(node)) {
     return LiveRegister._deserialize(node, parentToChildren, pool);
+  } else if (isTextStorageNode(node)) {
+    return LiveText._deserialize(node, parentToChildren, pool);
   } else {
     throw new Error("Unexpected CRDT type");
   }
@@ -8835,12 +9979,14 @@ function deserializeToLson(node, parentToChildren, pool) {
     return LiveMap._deserialize(node, parentToChildren, pool);
   } else if (isRegisterStorageNode(node)) {
     return node[1].data;
+  } else if (isTextStorageNode(node)) {
+    return LiveText._deserialize(node, parentToChildren, pool);
   } else {
     throw new Error("Unexpected CRDT type");
   }
 }
 function isLiveStructure(value) {
-  return isLiveList(value) || isLiveMap(value) || isLiveObject(value);
+  return isLiveList(value) || isLiveMap(value) || isLiveObject(value) || isLiveText(value);
 }
 function isLiveNode(value) {
   return isLiveStructure(value) || isLiveRegister(value);
@@ -8854,6 +10000,9 @@ function isLiveMap(value) {
 function isLiveObject(value) {
   return value instanceof LiveObject;
 }
+function isLiveText(value) {
+  return value instanceof LiveText;
+}
 function isLiveRegister(value) {
   return value instanceof LiveRegister;
 }
@@ -8863,14 +10012,14 @@ function cloneLson(value) {
 function liveNodeToLson(obj) {
   if (obj instanceof LiveRegister) {
     return obj.data;
-  } else if (obj instanceof LiveList || obj instanceof LiveMap || obj instanceof LiveObject) {
+  } else if (obj instanceof LiveList || obj instanceof LiveMap || obj instanceof LiveObject || obj instanceof LiveText) {
     return obj;
   } else {
     return assertNever(obj, "Unknown AbstractCrdt");
   }
 }
 function lsonToLiveNode(value) {
-  if (value instanceof LiveObject || value instanceof LiveMap || value instanceof LiveList) {
+  if (value instanceof LiveObject || value instanceof LiveMap || value instanceof LiveList || value instanceof LiveText) {
     return value;
   } else {
     return new LiveRegister(value);
@@ -8990,6 +10139,16 @@ function diffNodeMap(prev, next) {
           parentKey: crdt.parentKey
         });
         break;
+      case CrdtType.TEXT:
+        ops.push({
+          type: OpCode.CREATE_TEXT,
+          id,
+          parentId: crdt.parentId,
+          parentKey: crdt.parentKey,
+          data: crdt.data,
+          version: crdt.version
+        });
+        break;
     }
   }
   next.forEach((crdt, id) => {
@@ -9060,19 +10219,43 @@ function mergeListStorageUpdates(first, second) {
     updates: updates.concat(second.updates)
   };
 }
+function mergeTextStorageUpdates(first, second) {
+  return {
+    ...second,
+    updates: first.updates.concat(second.updates)
+  };
+}
 function mergeStorageUpdates(first, second) {
   if (first === void 0) {
     return second;
   }
+  let merged;
   if (first.type === "LiveObject" && second.type === "LiveObject") {
-    return mergeObjectStorageUpdates(first, second);
+    merged = mergeObjectStorageUpdates(first, second);
   } else if (first.type === "LiveMap" && second.type === "LiveMap") {
-    return mergeMapStorageUpdates(first, second);
+    merged = mergeMapStorageUpdates(first, second);
   } else if (first.type === "LiveList" && second.type === "LiveList") {
-    return mergeListStorageUpdates(first, second);
+    merged = mergeListStorageUpdates(first, second);
+  } else if (first.type === "LiveText" && second.type === "LiveText") {
+    merged = mergeTextStorageUpdates(first, second);
   } else {
+    merged = second;
+  }
+  const sa = first[kStorageUpdateSource];
+  const sb = second[kStorageUpdateSource];
+  if (sa !== void 0 || sb !== void 0) {
+    if (_optionalChain([sa, 'optionalAccess', _225 => _225.origin]) === "remote" || _optionalChain([sb, 'optionalAccess', _226 => _226.origin]) === "remote") {
+      merged[kStorageUpdateSource] = { origin: "remote" };
+    } else if (_optionalChain([sa, 'optionalAccess', _227 => _227.via]) === "history" || _optionalChain([sb, 'optionalAccess', _228 => _228.via]) === "history") {
+      const historySource = _optionalChain([sb, 'optionalAccess', _229 => _229.via]) === "history" ? sb : _optionalChain([sa, 'optionalAccess', _230 => _230.via]) === "history" ? sa : void 0;
+      if (_optionalChain([historySource, 'optionalAccess', _231 => _231.via]) === "history") {
+        merged[kStorageUpdateSource] = historySource;
+      }
+    } else {
+      merged[kStorageUpdateSource] = { origin: "local", via: "mutation" };
+    }
   }
-  return second;
+  return merged;
 }
 
 // src/devtools/bridge.ts
@@ -9088,7 +10271,7 @@ function sendToPanel(message, options) {
     ...message,
     source: "liveblocks-devtools-client"
   };
-  if (!(_optionalChain([options, 'optionalAccess', _217 => _217.force]) || _bridgeActive)) {
+  if (!(_optionalChain([options, 'optionalAccess', _232 => _232.force]) || _bridgeActive)) {
     return;
   }
   window.postMessage(fullMsg, "*");
@@ -9096,7 +10279,7 @@ function sendToPanel(message, options) {
 var eventSource = makeEventSource();
 if (process.env.NODE_ENV !== "production" && typeof window !== "undefined") {
   window.addEventListener("message", (event) => {
-    if (event.source === window && _optionalChain([event, 'access', _218 => _218.data, 'optionalAccess', _219 => _219.source]) === "liveblocks-devtools-panel") {
+    if (event.source === window && _optionalChain([event, 'access', _233 => _233.data, 'optionalAccess', _234 => _234.source]) === "liveblocks-devtools-panel") {
       eventSource.notify(event.data);
     } else {
     }
@@ -9238,7 +10421,7 @@ function fullSync(room) {
     msg: "room::sync::full",
     roomId: room.id,
     status: room.getStatus(),
-    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _220 => _220.toTreeNode, 'call', _221 => _221("root"), 'access', _222 => _222.payload]), () => ( null)),
+    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _235 => _235.toTreeNode, 'call', _236 => _236("root"), 'access', _237 => _237.payload]), () => ( null)),
     me,
     others
   });
@@ -9925,15 +11108,15 @@ function installBackgroundTabSpy() {
   const doc = typeof document !== "undefined" ? document : void 0;
   const inBackgroundSince = { current: null };
   function onVisibilityChange() {
-    if (_optionalChain([doc, 'optionalAccess', _223 => _223.visibilityState]) === "hidden") {
+    if (_optionalChain([doc, 'optionalAccess', _238 => _238.visibilityState]) === "hidden") {
       inBackgroundSince.current = _nullishCoalesce(inBackgroundSince.current, () => ( Date.now()));
     } else {
       inBackgroundSince.current = null;
     }
   }
-  _optionalChain([doc, 'optionalAccess', _224 => _224.addEventListener, 'call', _225 => _225("visibilitychange", onVisibilityChange)]);
+  _optionalChain([doc, 'optionalAccess', _239 => _239.addEventListener, 'call', _240 => _240("visibilitychange", onVisibilityChange)]);
   const unsub = () => {
-    _optionalChain([doc, 'optionalAccess', _226 => _226.removeEventListener, 'call', _227 => _227("visibilitychange", onVisibilityChange)]);
+    _optionalChain([doc, 'optionalAccess', _241 => _241.removeEventListener, 'call', _242 => _242("visibilitychange", onVisibilityChange)]);
   };
   return [inBackgroundSince, unsub];
 }
@@ -9957,7 +11140,7 @@ function makeNodeMapBuffer() {
 function topLevelKeysOf(nodes) {
   const keys2 = /* @__PURE__ */ new Set();
   const root = nodes.get("root");
-  for (const key in _optionalChain([root, 'optionalAccess', _228 => _228.data])) {
+  for (const key in _optionalChain([root, 'optionalAccess', _243 => _243.data])) {
     keys2.add(key);
   }
   for (const node of nodes.values()) {
@@ -10029,6 +11212,8 @@ function createRoom(options, config) {
     activeBatch: null,
     unacknowledgedOps
   };
+  let nextHistoryItemId = 0;
+  let historyDisabled = 0;
   const nodeMapBuffer = makeNodeMapBuffer();
   const stopwatch = config.enableDebugLogging ? makeStopWatch() : void 0;
   let lastTokenKey;
@@ -10113,7 +11298,10 @@ function createRoom(options, config) {
       }
     }
   });
-  function onDispatch(ops, reverse, storageUpdates) {
+  function onDispatch(ops, reverse, storageUpdates, options2) {
+    for (const value of storageUpdates.values()) {
+      value[kStorageUpdateSource] = { origin: "local", via: "mutation" };
+    }
     if (context.activeBatch) {
       for (const op of ops) {
         context.activeBatch.ops.push(op);
@@ -10128,19 +11316,24 @@ function createRoom(options, config) {
         );
       }
       context.activeBatch.reverseOps.pushLeft(reverse);
+      if (_optionalChain([options2, 'optionalAccess', _244 => _244.clearRedoStack])) {
+        context.activeBatch.clearRedoStack = true;
+      }
     } else {
       if (reverse.length > 0) {
         addToUndoStack(reverse);
       }
+      if (_nullishCoalesce(_optionalChain([options2, 'optionalAccess', _245 => _245.clearRedoStack]), () => ( ops.length > 0))) {
+        clearRedoStack();
+      }
       if (ops.length > 0) {
-        context.redoStack.length = 0;
         dispatchOps(ops);
       }
       notify({ storageUpdates });
     }
   }
   function isStorageWritable() {
-    const permissionMatrix = _optionalChain([context, 'access', _229 => _229.dynamicSessionInfoSig, 'access', _230 => _230.get, 'call', _231 => _231(), 'optionalAccess', _232 => _232.permissionMatrix]);
+    const permissionMatrix = _optionalChain([context, 'access', _246 => _246.dynamicSessionInfoSig, 'access', _247 => _247.get, 'call', _248 => _248(), 'optionalAccess', _249 => _249.permissionMatrix]);
     return permissionMatrix !== void 0 ? hasPermissionAccess(permissionMatrix, "storage", "write") : true;
   }
   const eventHub = {
@@ -10153,6 +11346,7 @@ function createRoom(options, config) {
     others: makeEventSource(),
     storageBatch: makeEventSource(),
     history: makeEventSource(),
+    privateHistory: makeEventSource(),
     storageDidLoad: makeEventSource(),
     storageStatus: makeEventSource(),
     ydoc: makeEventSource(),
@@ -10253,6 +11447,23 @@ function createRoom(options, config) {
     }
     if (context.root !== void 0) {
       const result = applyRemoteOps(diffCurrentStorageAgainst(nodes));
+      for (const [id, crdt] of nodes) {
+        if (crdt.type === CrdtType.TEXT) {
+          const node = context.pool.nodes.get(id);
+          if (node !== void 0 && isLiveText(node)) {
+            const update = node._resyncText(crdt.data, crdt.version);
+            if (update !== void 0) {
+              result.updates.storageUpdates.set(
+                id,
+                mergeStorageUpdates(
+                  result.updates.storageUpdates.get(id),
+                  update
+                )
+              );
+            }
+          }
+        }
+      }
       notify(result.updates);
     } else {
       context.root = LiveObject._fromItems(
@@ -10260,7 +11471,7 @@ function createRoom(options, config) {
         context.pool
       );
     }
-    const canWrite = _nullishCoalesce(_optionalChain([self, 'access', _233 => _233.get, 'call', _234 => _234(), 'optionalAccess', _235 => _235.canWrite]), () => ( true));
+    const canWrite = _nullishCoalesce(_optionalChain([self, 'access', _250 => _250.get, 'call', _251 => _251(), 'optionalAccess', _252 => _252.canWrite]), () => ( true));
     const serverTopLevelKeys = topLevelKeysOf(nodes);
     const root = context.root;
     disableHistory(() => {
@@ -10277,6 +11488,16 @@ function createRoom(options, config) {
       }
     });
   }
+  function notifyPrivateHistory(event) {
+    if (historyDisabled > 0) return;
+    eventHub.privateHistory.notify(event);
+  }
+  function clearRedoStack() {
+    if (context.redoStack.length === 0) return;
+    const ids = context.redoStack.map((item) => item.id);
+    context.redoStack.length = 0;
+    notifyPrivateHistory({ action: "discard", ids });
+  }
   function reconcileStorageWithNodes(nodes) {
     if (context.root === void 0) {
       throw new Error("Cannot reconcile storage before it is loaded");
@@ -10301,9 +11522,14 @@ function createRoom(options, config) {
   }
   function _addToRealUndoStack(frames) {
     if (context.undoStack.length >= 50) {
-      context.undoStack.shift();
+      const evicted = context.undoStack.shift();
+      if (evicted !== void 0) {
+        notifyPrivateHistory({ action: "discard", ids: [evicted.id] });
+      }
     }
-    context.undoStack.push(frames);
+    const id = nextHistoryItemId++;
+    context.undoStack.push({ id, frames });
+    notifyPrivateHistory({ action: "push", id });
     onHistoryChange();
   }
   function addToUndoStack(frames) {
@@ -10341,7 +11567,7 @@ function createRoom(options, config) {
       "Internal. Tried to get connection id but connection was never open"
     );
   }
-  function applyLocalOps(frames) {
+  function applyLocalOps(frames, localStorageUpdateSource = { origin: "local", via: "mutation" }) {
     const [pframes, ops] = partition(
       frames,
       (f) => f.type === "presence"
@@ -10353,7 +11579,8 @@ function createRoom(options, config) {
       pframes,
       opsWithOpIds,
       /* isLocal */
-      true
+      true,
+      localStorageUpdateSource
     );
     return { opsToEmit: opsWithOpIds, reverse, updates };
   }
@@ -10365,7 +11592,7 @@ function createRoom(options, config) {
       false
     );
   }
-  function applyOps(pframes, ops, isLocal) {
+  function applyOps(pframes, ops, isLocal, localStorageUpdateSource = { origin: "local", via: "mutation" }) {
     const output = {
       reverse: new Deque(),
       storageUpdates: /* @__PURE__ */ new Map(),
@@ -10403,6 +11630,7 @@ function createRoom(options, config) {
       }
       const applyOpResult = applyOp(op, source);
       if (applyOpResult.modified) {
+        applyOpResult.modified[kStorageUpdateSource] = source === 1 /* THEIRS */ ? { origin: "remote" } : localStorageUpdateSource;
         const nodeId = applyOpResult.modified.node._id;
         if (!(nodeId && createdNodeIds.has(nodeId))) {
           output.storageUpdates.set(
@@ -10414,7 +11642,7 @@ function createRoom(options, config) {
           );
           output.reverse.pushLeft(applyOpResult.reverse);
         }
-        if (op.type === OpCode.CREATE_LIST || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_OBJECT) {
+        if (op.type === OpCode.CREATE_LIST || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_OBJECT || op.type === OpCode.CREATE_TEXT) {
           createdNodeIds.add(op.id);
         }
       }
@@ -10434,6 +11662,7 @@ function createRoom(options, config) {
     switch (op.type) {
       case OpCode.DELETE_OBJECT_KEY:
       case OpCode.UPDATE_OBJECT:
+      case OpCode.UPDATE_TEXT:
       case OpCode.DELETE_CRDT: {
         const node = context.pool.nodes.get(op.id);
         if (node === void 0) {
@@ -10458,6 +11687,7 @@ function createRoom(options, config) {
       case OpCode.CREATE_OBJECT:
       case OpCode.CREATE_LIST:
       case OpCode.CREATE_MAP:
+      case OpCode.CREATE_TEXT:
       case OpCode.CREATE_REGISTER: {
         if (op.parentId === void 0) {
           return { modified: false };
@@ -10492,7 +11722,7 @@ function createRoom(options, config) {
     }
     context.myPresence.patch(patch);
     if (context.activeBatch) {
-      if (_optionalChain([options2, 'optionalAccess', _236 => _236.addToHistory])) {
+      if (_optionalChain([options2, 'optionalAccess', _253 => _253.addToHistory])) {
         context.activeBatch.reverseOps.pushLeft({
           type: "presence",
           data: oldValues
@@ -10501,7 +11731,7 @@ function createRoom(options, config) {
       context.activeBatch.updates.presence = true;
     } else {
       flushNowOrSoon();
-      if (_optionalChain([options2, 'optionalAccess', _237 => _237.addToHistory])) {
+      if (_optionalChain([options2, 'optionalAccess', _254 => _254.addToHistory])) {
         addToUndoStack([{ type: "presence", data: oldValues }]);
       }
       notify({ presence: true });
@@ -10680,11 +11910,11 @@ function createRoom(options, config) {
           break;
         }
         case ServerMsgCode.STORAGE_CHUNK:
-          _optionalChain([stopwatch, 'optionalAccess', _238 => _238.lap, 'call', _239 => _239()]);
+          _optionalChain([stopwatch, 'optionalAccess', _255 => _255.lap, 'call', _256 => _256()]);
           nodeMapBuffer.append(compactNodesToNodeStream(message.nodes));
           break;
         case ServerMsgCode.STORAGE_STREAM_END: {
-          const timing = _optionalChain([stopwatch, 'optionalAccess', _240 => _240.stop, 'call', _241 => _241()]);
+          const timing = _optionalChain([stopwatch, 'optionalAccess', _257 => _257.stop, 'call', _258 => _258()]);
           if (timing) {
             const ms = (v) => `${v.toFixed(1)}ms`;
             const rest = timing.laps.slice(1);
@@ -10711,16 +11941,37 @@ function createRoom(options, config) {
           }
           break;
         }
-        // Receiving a RejectedOps message in the client means that the server is no
-        // longer in sync with the client. Trying to synchronize the client again by
-        // rolling back particular Ops may be hard/impossible. It's fine to not try and
-        // accept the out-of-sync reality and throw an error.
+        // Receiving a RejectedOps message means the server refused some of
+        // our ops, so our optimistic local state is out of sync with the
+        // server. For LiveText ops this is a normal (if rare) situation —
+        // e.g. a client that was offline long enough to fall outside the
+        // server's retained history window — and we can recover: drop the
+        // rejected pending state and re-fetch the authoritative storage
+        // snapshot. For other ops (e.g. permission rejections), rolling back
+        // particular Ops is hard/impossible, so we keep the old behavior of
+        // accepting the out-of-sync reality and surfacing an error.
         case ServerMsgCode.REJECT_STORAGE_OP: {
           errorWithTitle(
             "Storage mutation rejection error",
             message.reason
           );
-          if (process.env.NODE_ENV !== "production") {
+          let needsStorageResync = false;
+          for (const opId of message.opIds) {
+            const rejectedOp = context.unacknowledgedOps.get(opId);
+            context.unacknowledgedOps.delete(opId);
+            context.buffer.storageOperations = context.buffer.storageOperations.filter((op) => op.opId !== opId);
+            if (rejectedOp !== void 0 && rejectedOp.type === OpCode.UPDATE_TEXT) {
+              const node = context.pool.nodes.get(rejectedOp.id);
+              if (node !== void 0 && isLiveText(node)) {
+                node._rejectPendingOp(opId);
+                needsStorageResync = true;
+              }
+            }
+          }
+          if (needsStorageResync) {
+            refreshStorage();
+            flushNowOrSoon();
+          } else if (process.env.NODE_ENV !== "production") {
             throw new Error(
               `Storage mutations rejected by server: ${message.reason}`
             );
@@ -10819,11 +12070,11 @@ function createRoom(options, config) {
           } else if (pendingFeedsRequests.has(requestId)) {
             const pending = pendingFeedsRequests.get(requestId);
             pendingFeedsRequests.delete(requestId);
-            _optionalChain([pending, 'optionalAccess', _242 => _242.reject, 'call', _243 => _243(err)]);
+            _optionalChain([pending, 'optionalAccess', _259 => _259.reject, 'call', _260 => _260(err)]);
           } else if (pendingFeedMessagesRequests.has(requestId)) {
             const pending = pendingFeedMessagesRequests.get(requestId);
             pendingFeedMessagesRequests.delete(requestId);
-            _optionalChain([pending, 'optionalAccess', _244 => _244.reject, 'call', _245 => _245(err)]);
+            _optionalChain([pending, 'optionalAccess', _261 => _261.reject, 'call', _262 => _262(err)]);
           }
           eventHub.feeds.notify(message);
           break;
@@ -10977,10 +12228,10 @@ function createRoom(options, config) {
       timeoutId,
       kind,
       feedId,
-      messageId: _optionalChain([options2, 'optionalAccess', _246 => _246.messageId]),
-      expectedClientMessageId: _optionalChain([options2, 'optionalAccess', _247 => _247.expectedClientMessageId])
+      messageId: _optionalChain([options2, 'optionalAccess', _263 => _263.messageId]),
+      expectedClientMessageId: _optionalChain([options2, 'optionalAccess', _264 => _264.expectedClientMessageId])
     });
-    if (kind === "add-message" && _optionalChain([options2, 'optionalAccess', _248 => _248.expectedClientMessageId]) === void 0) {
+    if (kind === "add-message" && _optionalChain([options2, 'optionalAccess', _265 => _265.expectedClientMessageId]) === void 0) {
       const q = _nullishCoalesce(pendingAddMessageFifoByFeed.get(feedId), () => ( []));
       q.push(requestId);
       pendingAddMessageFifoByFeed.set(feedId, q);
@@ -11031,10 +12282,10 @@ function createRoom(options, config) {
           }
           if (!matched) {
             const q = pendingAddMessageFifoByFeed.get(message.feedId);
-            const headId = _optionalChain([q, 'optionalAccess', _249 => _249[0]]);
+            const headId = _optionalChain([q, 'optionalAccess', _266 => _266[0]]);
             if (headId !== void 0) {
               const pending = pendingFeedMutations.get(headId);
-              if (_optionalChain([pending, 'optionalAccess', _250 => _250.kind]) === "add-message" && pending.expectedClientMessageId === void 0) {
+              if (_optionalChain([pending, 'optionalAccess', _267 => _267.kind]) === "add-message" && pending.expectedClientMessageId === void 0) {
                 settleFeedMutation(headId, "ok");
               }
             }
@@ -11070,7 +12321,7 @@ function createRoom(options, config) {
     const unacknowledgedOps2 = [...context.unacknowledgedOps.values()];
     createOrUpdateRootFromMessage(nodes);
     applyAndSendOfflineOps(unacknowledgedOps2);
-    _optionalChain([_resolveStoragePromise, 'optionalCall', _251 => _251()]);
+    _optionalChain([_resolveStoragePromise, 'optionalCall', _268 => _268()]);
     notifyStorageStatus();
     eventHub.storageDidLoad.notify();
   }
@@ -11079,7 +12330,7 @@ function createRoom(options, config) {
     if (!messages.some((msg) => msg.type === ClientMsgCode.FETCH_STORAGE)) {
       messages.push({ type: ClientMsgCode.FETCH_STORAGE });
       nodeMapBuffer.take();
-      _optionalChain([stopwatch, 'optionalAccess', _252 => _252.start, 'call', _253 => _253()]);
+      _optionalChain([stopwatch, 'optionalAccess', _269 => _269.start, 'call', _270 => _270()]);
     }
   }
   function startLoadingStorage() {
@@ -11133,10 +12384,10 @@ function createRoom(options, config) {
     const message = {
       type: ClientMsgCode.FETCH_FEEDS,
       requestId,
-      cursor: _optionalChain([options2, 'optionalAccess', _254 => _254.cursor]),
-      since: _optionalChain([options2, 'optionalAccess', _255 => _255.since]),
-      limit: _optionalChain([options2, 'optionalAccess', _256 => _256.limit]),
-      metadata: _optionalChain([options2, 'optionalAccess', _257 => _257.metadata])
+      cursor: _optionalChain([options2, 'optionalAccess', _271 => _271.cursor]),
+      since: _optionalChain([options2, 'optionalAccess', _272 => _272.since]),
+      limit: _optionalChain([options2, 'optionalAccess', _273 => _273.limit]),
+      metadata: _optionalChain([options2, 'optionalAccess', _274 => _274.metadata])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11156,9 +12407,9 @@ function createRoom(options, config) {
       type: ClientMsgCode.FETCH_FEED_MESSAGES,
       requestId,
       feedId,
-      cursor: _optionalChain([options2, 'optionalAccess', _258 => _258.cursor]),
-      since: _optionalChain([options2, 'optionalAccess', _259 => _259.since]),
-      limit: _optionalChain([options2, 'optionalAccess', _260 => _260.limit])
+      cursor: _optionalChain([options2, 'optionalAccess', _275 => _275.cursor]),
+      since: _optionalChain([options2, 'optionalAccess', _276 => _276.since]),
+      limit: _optionalChain([options2, 'optionalAccess', _277 => _277.limit])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11177,8 +12428,8 @@ function createRoom(options, config) {
       type: ClientMsgCode.ADD_FEED,
       requestId,
       feedId,
-      metadata: _optionalChain([options2, 'optionalAccess', _261 => _261.metadata]),
-      createdAt: _optionalChain([options2, 'optionalAccess', _262 => _262.createdAt])
+      metadata: _optionalChain([options2, 'optionalAccess', _278 => _278.metadata]),
+      createdAt: _optionalChain([options2, 'optionalAccess', _279 => _279.createdAt])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11212,15 +12463,15 @@ function createRoom(options, config) {
   function addFeedMessage(feedId, data, options2) {
     const requestId = nanoid();
     const promise = registerFeedMutation(requestId, "add-message", feedId, {
-      expectedClientMessageId: _optionalChain([options2, 'optionalAccess', _263 => _263.id])
+      expectedClientMessageId: _optionalChain([options2, 'optionalAccess', _280 => _280.id])
     });
     const message = {
       type: ClientMsgCode.ADD_FEED_MESSAGE,
       requestId,
       feedId,
       data,
-      id: _optionalChain([options2, 'optionalAccess', _264 => _264.id]),
-      createdAt: _optionalChain([options2, 'optionalAccess', _265 => _265.createdAt])
+      id: _optionalChain([options2, 'optionalAccess', _281 => _281.id]),
+      createdAt: _optionalChain([options2, 'optionalAccess', _282 => _282.createdAt])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11237,7 +12488,7 @@ function createRoom(options, config) {
       feedId,
       messageId,
       data,
-      updatedAt: _optionalChain([options2, 'optionalAccess', _266 => _266.updatedAt])
+      updatedAt: _optionalChain([options2, 'optionalAccess', _283 => _283.updatedAt])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11262,14 +12513,19 @@ function createRoom(options, config) {
     if (context.activeBatch) {
       throw new Error("undo is not allowed during a batch");
     }
-    const frames = context.undoStack.pop();
-    if (frames === void 0) {
+    const item = context.undoStack.pop();
+    if (item === void 0) {
       return;
     }
     context.pausedHistory = null;
-    const result = applyLocalOps(frames);
+    const result = applyLocalOps(item.frames, {
+      origin: "local",
+      via: "history",
+      action: "undo"
+    });
+    context.redoStack.push({ id: item.id, frames: result.reverse });
+    notifyPrivateHistory({ action: "undo", id: item.id });
     notify(result.updates);
-    context.redoStack.push(result.reverse);
     onHistoryChange();
     for (const op of result.opsToEmit) {
       context.buffer.storageOperations.push(op);
@@ -11280,14 +12536,19 @@ function createRoom(options, config) {
     if (context.activeBatch) {
       throw new Error("redo is not allowed during a batch");
     }
-    const frames = context.redoStack.pop();
-    if (frames === void 0) {
+    const item = context.redoStack.pop();
+    if (item === void 0) {
       return;
     }
     context.pausedHistory = null;
-    const result = applyLocalOps(frames);
+    const result = applyLocalOps(item.frames, {
+      origin: "local",
+      via: "history",
+      action: "redo"
+    });
+    context.undoStack.push({ id: item.id, frames: result.reverse });
+    notifyPrivateHistory({ action: "redo", id: item.id });
     notify(result.updates);
-    context.undoStack.push(result.reverse);
     onHistoryChange();
     for (const op of result.opsToEmit) {
       context.buffer.storageOperations.push(op);
@@ -11297,6 +12558,8 @@ function createRoom(options, config) {
   function clear() {
     context.undoStack.length = 0;
     context.redoStack.length = 0;
+    notifyPrivateHistory({ action: "clear" });
+    onHistoryChange();
   }
   function batch2(callback) {
     if (context.activeBatch) {
@@ -11324,8 +12587,8 @@ function createRoom(options, config) {
       if (currentBatch.scheduleHistoryResume) {
         commitPausedHistoryToUndoStack();
       }
-      if (currentBatch.ops.length > 0) {
-        context.redoStack.length = 0;
+      if (currentBatch.ops.length > 0 || currentBatch.clearRedoStack) {
+        clearRedoStack();
       }
       if (currentBatch.ops.length > 0) {
         dispatchOps(currentBatch.ops);
@@ -11354,7 +12617,6 @@ function createRoom(options, config) {
     }
     commitPausedHistoryToUndoStack();
   }
-  let historyDisabled = 0;
   function disableHistory(fn) {
     const origUndo = context.undoStack;
     const origRedo = context.redoStack;
@@ -11444,8 +12706,8 @@ function createRoom(options, config) {
   async function getThreads(options2) {
     return httpClient.getThreads({
       roomId,
-      query: _optionalChain([options2, 'optionalAccess', _267 => _267.query]),
-      cursor: _optionalChain([options2, 'optionalAccess', _268 => _268.cursor])
+      query: _optionalChain([options2, 'optionalAccess', _284 => _284.query]),
+      cursor: _optionalChain([options2, 'optionalAccess', _285 => _285.cursor])
     });
   }
   async function getThread(threadId) {
@@ -11568,7 +12830,7 @@ function createRoom(options, config) {
   function getSubscriptionSettings(options2) {
     return httpClient.getSubscriptionSettings({
       roomId,
-      signal: _optionalChain([options2, 'optionalAccess', _269 => _269.signal])
+      signal: _optionalChain([options2, 'optionalAccess', _286 => _286.signal])
     });
   }
   function updateSubscriptionSettings(settings) {
@@ -11590,30 +12852,45 @@ function createRoom(options, config) {
     {
       [kInternal]: {
         get presenceBuffer() {
-          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _270 => _270.buffer, 'access', _271 => _271.presenceUpdates, 'optionalAccess', _272 => _272.data]), () => ( null)));
+          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _287 => _287.buffer, 'access', _288 => _288.presenceUpdates, 'optionalAccess', _289 => _289.data]), () => ( null)));
         },
         // prettier-ignore
         get undoStack() {
-          return deepClone(context.undoStack);
+          return structuredClone(
+            context.undoStack.map((item) => ({
+              id: item.id,
+              frames: item.frames
+            }))
+          );
+        },
+        // prettier-ignore
+        get redoStack() {
+          return structuredClone(
+            context.redoStack.map((item) => ({
+              id: item.id,
+              frames: item.frames
+            }))
+          );
         },
         // prettier-ignore
         get nodeCount() {
           return context.pool.nodes.size;
         },
         // prettier-ignore
+        history: eventHub.privateHistory.observable,
         getYjsProvider() {
           return context.yjsProvider;
         },
         setYjsProvider(newProvider) {
-          _optionalChain([context, 'access', _273 => _273.yjsProvider, 'optionalAccess', _274 => _274.off, 'call', _275 => _275("status", yjsStatusDidChange)]);
+          _optionalChain([context, 'access', _290 => _290.yjsProvider, 'optionalAccess', _291 => _291.off, 'call', _292 => _292("status", yjsStatusDidChange)]);
           context.yjsProvider = newProvider;
-          _optionalChain([newProvider, 'optionalAccess', _276 => _276.on, 'call', _277 => _277("status", yjsStatusDidChange)]);
+          _optionalChain([newProvider, 'optionalAccess', _293 => _293.on, 'call', _294 => _294("status", yjsStatusDidChange)]);
           context.yjsProviderDidChange.notify();
         },
         yjsProviderDidChange: context.yjsProviderDidChange.observable,
         // send metadata when using a text editor
         reportTextEditor,
-        getPermissionMatrix: () => _optionalChain([context, 'access', _278 => _278.dynamicSessionInfoSig, 'access', _279 => _279.get, 'call', _280 => _280(), 'optionalAccess', _281 => _281.permissionMatrix]),
+        getPermissionMatrix: () => _optionalChain([context, 'access', _295 => _295.dynamicSessionInfoSig, 'access', _296 => _296.get, 'call', _297 => _297(), 'optionalAccess', _298 => _298.permissionMatrix]),
         // create a text mention when using a text editor
         createTextMention,
         // delete a text mention when using a text editor
@@ -11675,7 +12952,7 @@ ${dumpPool(
           source.dispose();
         }
         eventHub.roomWillDestroy.notify();
-        _optionalChain([context, 'access', _282 => _282.yjsProvider, 'optionalAccess', _283 => _283.off, 'call', _284 => _284("status", yjsStatusDidChange)]);
+        _optionalChain([context, 'access', _299 => _299.yjsProvider, 'optionalAccess', _300 => _300.off, 'call', _301 => _301("status", yjsStatusDidChange)]);
         syncSourceForStorage.destroy();
         syncSourceForYjs.destroy();
         uninstallBgTabSpy();
@@ -11837,7 +13114,7 @@ function makeClassicSubscribeFn(roomId, events, errorEvents) {
     }
     if (isLiveNode(first)) {
       const node = first;
-      if (_optionalChain([options, 'optionalAccess', _285 => _285.isDeep])) {
+      if (_optionalChain([options, 'optionalAccess', _302 => _302.isDeep])) {
         const storageCallback = second;
         return subscribeToLiveStructureDeeply(node, storageCallback);
       } else {
@@ -11927,8 +13204,8 @@ function createClient(options) {
   const authManager = createAuthManager(options, (token) => {
     currentUserId.set(() => token.uid);
   });
-  const fetchPolyfill = _optionalChain([clientOptions, 'access', _286 => _286.polyfills, 'optionalAccess', _287 => _287.fetch]) || /* istanbul ignore next */
-  _optionalChain([globalThis, 'access', _288 => _288.fetch, 'optionalAccess', _289 => _289.bind, 'call', _290 => _290(globalThis)]);
+  const fetchPolyfill = _optionalChain([clientOptions, 'access', _303 => _303.polyfills, 'optionalAccess', _304 => _304.fetch]) || /* istanbul ignore next */
+  _optionalChain([globalThis, 'access', _305 => _305.fetch, 'optionalAccess', _306 => _306.bind, 'call', _307 => _307(globalThis)]);
   const httpClient = createApiClient({
     baseUrl,
     fetchPolyfill,
@@ -11945,7 +13222,7 @@ function createClient(options) {
     delegates: {
       createSocket: makeCreateSocketDelegateForAi(
         baseUrl,
-        _optionalChain([clientOptions, 'access', _291 => _291.polyfills, 'optionalAccess', _292 => _292.WebSocket])
+        _optionalChain([clientOptions, 'access', _308 => _308.polyfills, 'optionalAccess', _309 => _309.WebSocket])
       ),
       authenticate: async () => {
         const resp = await authManager.getAuthValue({
@@ -12016,7 +13293,7 @@ function createClient(options) {
           createSocket: makeCreateSocketDelegateForRoom(
             roomId,
             baseUrl,
-            _optionalChain([clientOptions, 'access', _293 => _293.polyfills, 'optionalAccess', _294 => _294.WebSocket])
+            _optionalChain([clientOptions, 'access', _310 => _310.polyfills, 'optionalAccess', _311 => _311.WebSocket])
           ),
           authenticate: makeAuthDelegateForRoom(roomId, authManager)
         })),
@@ -12038,7 +13315,7 @@ function createClient(options) {
     const shouldConnect = _nullishCoalesce(options2.autoConnect, () => ( true));
     if (shouldConnect) {
       if (typeof atob === "undefined") {
-        if (_optionalChain([clientOptions, 'access', _295 => _295.polyfills, 'optionalAccess', _296 => _296.atob]) === void 0) {
+        if (_optionalChain([clientOptions, 'access', _312 => _312.polyfills, 'optionalAccess', _313 => _313.atob]) === void 0) {
           throw new Error(
             "You need to polyfill atob to use the client in your environment. Please follow the instructions at https://liveblocks.io/docs/errors/liveblocks-client/atob-polyfill"
           );
@@ -12050,7 +13327,7 @@ function createClient(options) {
     return leaseRoom(newRoomDetails);
   }
   function getRoom(roomId) {
-    const room = _optionalChain([roomsById, 'access', _297 => _297.get, 'call', _298 => _298(roomId), 'optionalAccess', _299 => _299.room]);
+    const room = _optionalChain([roomsById, 'access', _314 => _314.get, 'call', _315 => _315(roomId), 'optionalAccess', _316 => _316.room]);
     return room ? room : null;
   }
   function logout() {
@@ -12066,7 +13343,7 @@ function createClient(options) {
   const batchedResolveUsers = new Batch(
     async (batchedUserIds) => {
       const userIds = batchedUserIds.flat();
-      const users = await _optionalChain([resolveUsers, 'optionalCall', _300 => _300({ userIds })]);
+      const users = await _optionalChain([resolveUsers, 'optionalCall', _317 => _317({ userIds })]);
       warnOnceIf(
         !resolveUsers,
         "Set the resolveUsers option in createClient to specify user info."
@@ -12083,7 +13360,7 @@ function createClient(options) {
   const batchedResolveRoomsInfo = new Batch(
     async (batchedRoomIds) => {
       const roomIds = batchedRoomIds.flat();
-      const roomsInfo = await _optionalChain([resolveRoomsInfo, 'optionalCall', _301 => _301({ roomIds })]);
+      const roomsInfo = await _optionalChain([resolveRoomsInfo, 'optionalCall', _318 => _318({ roomIds })]);
       warnOnceIf(
         !resolveRoomsInfo,
         "Set the resolveRoomsInfo option in createClient to specify room info."
@@ -12100,7 +13377,7 @@ function createClient(options) {
   const batchedResolveGroupsInfo = new Batch(
     async (batchedGroupIds) => {
       const groupIds = batchedGroupIds.flat();
-      const groupsInfo = await _optionalChain([resolveGroupsInfo, 'optionalCall', _302 => _302({ groupIds })]);
+      const groupsInfo = await _optionalChain([resolveGroupsInfo, 'optionalCall', _319 => _319({ groupIds })]);
       warnOnceIf(
         !resolveGroupsInfo,
         "Set the resolveGroupsInfo option in createClient to specify group info."
@@ -12159,7 +13436,7 @@ function createClient(options) {
       }
     };
     const win = typeof window !== "undefined" ? window : void 0;
-    _optionalChain([win, 'optionalAccess', _303 => _303.addEventListener, 'call', _304 => _304("beforeunload", maybePreventClose)]);
+    _optionalChain([win, 'optionalAccess', _320 => _320.addEventListener, 'call', _321 => _321("beforeunload", maybePreventClose)]);
   }
   async function getNotificationSettings(options2) {
     const plainSettings = await httpClient.getNotificationSettings(options2);
@@ -12287,7 +13564,7 @@ var commentBodyElementsTypes = {
   mention: "inline"
 };
 function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
-  if (!body || !_optionalChain([body, 'optionalAccess', _305 => _305.content])) {
+  if (!body || !_optionalChain([body, 'optionalAccess', _322 => _322.content])) {
     return;
   }
   const element = typeof elementOrVisitor === "string" ? elementOrVisitor : void 0;
@@ -12297,13 +13574,13 @@ function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
   for (const block of body.content) {
     if (type === "all" || type === "block") {
       if (guard(block)) {
-        _optionalChain([visitor, 'optionalCall', _306 => _306(block)]);
+        _optionalChain([visitor, 'optionalCall', _323 => _323(block)]);
       }
     }
     if (type === "all" || type === "inline") {
       for (const inline of block.children) {
         if (guard(inline)) {
-          _optionalChain([visitor, 'optionalCall', _307 => _307(inline)]);
+          _optionalChain([visitor, 'optionalCall', _324 => _324(inline)]);
         }
       }
     }
@@ -12473,7 +13750,7 @@ var stringifyCommentBodyPlainElements = {
   text: ({ element }) => element.text,
   link: ({ element }) => _nullishCoalesce(element.text, () => ( element.url)),
   mention: ({ element, user, group }) => {
-    return `@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _308 => _308.name]), () => ( _optionalChain([group, 'optionalAccess', _309 => _309.name]))), () => ( element.id))}`;
+    return `@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _325 => _325.name]), () => ( _optionalChain([group, 'optionalAccess', _326 => _326.name]))), () => ( element.id))}`;
   }
 };
 var stringifyCommentBodyHtmlElements = {
@@ -12503,7 +13780,7 @@ var stringifyCommentBodyHtmlElements = {
     return html`<a href="${href}" target="_blank" rel="noopener noreferrer">${element.text ? html`${element.text}` : element.url}</a>`;
   },
   mention: ({ element, user, group }) => {
-    return html`<span data-mention>@${_optionalChain([user, 'optionalAccess', _310 => _310.name]) ? html`${_optionalChain([user, 'optionalAccess', _311 => _311.name])}` : _optionalChain([group, 'optionalAccess', _312 => _312.name]) ? html`${_optionalChain([group, 'optionalAccess', _313 => _313.name])}` : element.id}</span>`;
+    return html`<span data-mention>@${_optionalChain([user, 'optionalAccess', _327 => _327.name]) ? html`${_optionalChain([user, 'optionalAccess', _328 => _328.name])}` : _optionalChain([group, 'optionalAccess', _329 => _329.name]) ? html`${_optionalChain([group, 'optionalAccess', _330 => _330.name])}` : element.id}</span>`;
   }
 };
 var stringifyCommentBodyMarkdownElements = {
@@ -12533,20 +13810,20 @@ var stringifyCommentBodyMarkdownElements = {
     return markdown`[${_nullishCoalesce(element.text, () => ( element.url))}](${href})`;
   },
   mention: ({ element, user, group }) => {
-    return markdown`@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _314 => _314.name]), () => ( _optionalChain([group, 'optionalAccess', _315 => _315.name]))), () => ( element.id))}`;
+    return markdown`@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _331 => _331.name]), () => ( _optionalChain([group, 'optionalAccess', _332 => _332.name]))), () => ( element.id))}`;
   }
 };
 async function stringifyCommentBody(body, options) {
-  const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _316 => _316.format]), () => ( "plain"));
-  const separator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _317 => _317.separator]), () => ( (format === "markdown" ? "\n\n" : "\n")));
+  const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _333 => _333.format]), () => ( "plain"));
+  const separator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _334 => _334.separator]), () => ( (format === "markdown" ? "\n\n" : "\n")));
   const elements = {
     ...format === "html" ? stringifyCommentBodyHtmlElements : format === "markdown" ? stringifyCommentBodyMarkdownElements : stringifyCommentBodyPlainElements,
-    ..._optionalChain([options, 'optionalAccess', _318 => _318.elements])
+    ..._optionalChain([options, 'optionalAccess', _335 => _335.elements])
   };
   const { users: resolvedUsers, groups: resolvedGroupsInfo } = await resolveMentionsInCommentBody(
     body,
-    _optionalChain([options, 'optionalAccess', _319 => _319.resolveUsers]),
-    _optionalChain([options, 'optionalAccess', _320 => _320.resolveGroupsInfo])
+    _optionalChain([options, 'optionalAccess', _336 => _336.resolveUsers]),
+    _optionalChain([options, 'optionalAccess', _337 => _337.resolveGroupsInfo])
   );
   const blocks = body.content.flatMap((block, blockIndex) => {
     switch (block.type) {
@@ -12628,6 +13905,12 @@ function toPlainLson(lson) {
       liveblocksType: "LiveList",
       data: [...lson].map((item) => toPlainLson(item))
     };
+  } else if (lson instanceof LiveText) {
+    return {
+      liveblocksType: "LiveText",
+      data: lson.toJSON(),
+      version: lson.version
+    };
   } else {
     return lson;
   }
@@ -12681,9 +13964,9 @@ function makePoller(callback, intervalMs, options) {
   const startTime = performance.now();
   const doc = typeof document !== "undefined" ? document : void 0;
   const win = typeof window !== "undefined" ? window : void 0;
-  const maxStaleTimeMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _321 => _321.maxStaleTimeMs]), () => ( Number.POSITIVE_INFINITY));
+  const maxStaleTimeMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _338 => _338.maxStaleTimeMs]), () => ( Number.POSITIVE_INFINITY));
   const context = {
-    inForeground: _optionalChain([doc, 'optionalAccess', _322 => _322.visibilityState]) !== "hidden",
+    inForeground: _optionalChain([doc, 'optionalAccess', _339 => _339.visibilityState]) !== "hidden",
     lastSuccessfulPollAt: startTime,
     count: 0,
     backoff: 0
@@ -12764,11 +14047,11 @@ function makePoller(callback, intervalMs, options) {
     pollNowIfStale();
   }
   function onVisibilityChange() {
-    setInForeground(_optionalChain([doc, 'optionalAccess', _323 => _323.visibilityState]) !== "hidden");
+    setInForeground(_optionalChain([doc, 'optionalAccess', _340 => _340.visibilityState]) !== "hidden");
   }
-  _optionalChain([doc, 'optionalAccess', _324 => _324.addEventListener, 'call', _325 => _325("visibilitychange", onVisibilityChange)]);
-  _optionalChain([win, 'optionalAccess', _326 => _326.addEventListener, 'call', _327 => _327("online", onVisibilityChange)]);
-  _optionalChain([win, 'optionalAccess', _328 => _328.addEventListener, 'call', _329 => _329("focus", pollNowIfStale)]);
+  _optionalChain([doc, 'optionalAccess', _341 => _341.addEventListener, 'call', _342 => _342("visibilitychange", onVisibilityChange)]);
+  _optionalChain([win, 'optionalAccess', _343 => _343.addEventListener, 'call', _344 => _344("online", onVisibilityChange)]);
+  _optionalChain([win, 'optionalAccess', _345 => _345.addEventListener, 'call', _346 => _346("focus", pollNowIfStale)]);
   fsm.start();
   return {
     inc,
@@ -12913,5 +14196,10 @@ detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
 
 
 
-exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.DefaultMap = DefaultMap; exports.Deque = Deque; exports.DerivedSignal = DerivedSignal; exports.FeedRequestErrorCode = FeedRequestErrorCode; exports.HttpError = HttpError; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.LiveblocksError = LiveblocksError; exports.MENTION_CHARACTER = MENTION_CHARACTER; exports.MutableSignal = MutableSignal; exports.OpCode = OpCode; exports.Permission = Permission; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.Signal = Signal; exports.SortedList = SortedList; exports.TextEditorType = TextEditorType; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.batch = batch; exports.checkBounds = checkBounds; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactNodesToNodeStream = compactNodesToNodeStream; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToGroupData = convertToGroupData; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToSubscriptionData = convertToSubscriptionData; exports.convertToThreadData = convertToThreadData; exports.convertToUserSubscriptionData = convertToUserSubscriptionData; exports.createClient = createClient; exports.createCommentAttachmentId = createCommentAttachmentId; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createManagedPool = createManagedPool; exports.createNotificationSettings = createNotificationSettings; exports.createThreadId = createThreadId; exports.deepLiveify = deepLiveify; exports.defineAiTool = defineAiTool; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.entries = entries; exports.errorIf = errorIf; exports.findLastIndex = findLastIndex; exports.freeze = freeze; exports.generateUrl = generateUrl; exports.getMentionsFromCommentBody = getMentionsFromCommentBody; exports.getSubscriptionKey = getSubscriptionKey; exports.hasPermissionAccess = hasPermissionAccess; exports.html = html; exports.htmlSafe = htmlSafe; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isListStorageNode = isListStorageNode; exports.isLiveNode = isLiveNode; exports.isMapStorageNode = isMapStorageNode; exports.isNotificationChannelEnabled = isNotificationChannelEnabled; exports.isNumberOperator = isNumberOperator; exports.isObjectStorageNode = isObjectStorageNode; exports.isPlainObject = isPlainObject; exports.isRegisterStorageNode = isRegisterStorageNode; exports.isRootStorageNode = isRootStorageNode; exports.isStartsWithOperator = isStartsWithOperator; exports.isUrl = isUrl; exports.kInternal = kInternal; exports.keys = keys; exports.makeAbortController = makeAbortController; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.mergeRoomPermissionScopes = mergeRoomPermissionScopes; exports.nanoid = nanoid; exports.nn = nn; exports.nodeStreamToCompactNodes = nodeStreamToCompactNodes; exports.normalizeRoomAccesses = normalizeRoomAccesses; exports.normalizeRoomPermissions = normalizeRoomPermissions; exports.normalizeUpdateRoomAccesses = normalizeUpdateRoomAccesses; exports.objectToQuery = objectToQuery; exports.patchNotificationSettings = patchNotificationSettings; exports.permissionMatrixFromScopes = permissionMatrixFromScopes; exports.raise = raise; exports.resolveMentionsInCommentBody = resolveMentionsInCommentBody; exports.sanitizeUrl = sanitizeUrl; exports.shallow = shallow; exports.shallow2 = shallow2; exports.stableStringify = stableStringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.validatePermissionsSet = validatePermissionsSet; exports.wait = wait; exports.warnOnce = warnOnce; exports.warnOnceIf = warnOnceIf; exports.withTimeout = withTimeout;
+
+
+
+
+
+exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.DefaultMap = DefaultMap; exports.Deque = Deque; exports.DerivedSignal = DerivedSignal; exports.FeedRequestErrorCode = FeedRequestErrorCode; exports.HttpError = HttpError; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.LiveText = LiveText; exports.LiveblocksError = LiveblocksError; exports.MENTION_CHARACTER = MENTION_CHARACTER; exports.MutableSignal = MutableSignal; exports.OpCode = OpCode; exports.Permission = Permission; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.Signal = Signal; exports.SortedList = SortedList; exports.TextEditorType = TextEditorType; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.applyLiveTextOperations = applyLiveTextOperations; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.batch = batch; exports.checkBounds = checkBounds; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactNodesToNodeStream = compactNodesToNodeStream; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToGroupData = convertToGroupData; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToSubscriptionData = convertToSubscriptionData; exports.convertToThreadData = convertToThreadData; exports.convertToUserSubscriptionData = convertToUserSubscriptionData; exports.createClient = createClient; exports.createCommentAttachmentId = createCommentAttachmentId; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createManagedPool = createManagedPool; exports.createNotificationSettings = createNotificationSettings; exports.createThreadId = createThreadId; exports.deepLiveify = deepLiveify; exports.defineAiTool = defineAiTool; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.entries = entries; exports.errorIf = errorIf; exports.findLastIndex = findLastIndex; exports.freeze = freeze; exports.generateUrl = generateUrl; exports.getMentionsFromCommentBody = getMentionsFromCommentBody; exports.getSubscriptionKey = getSubscriptionKey; exports.hasPermissionAccess = hasPermissionAccess; exports.html = html; exports.htmlSafe = htmlSafe; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isListStorageNode = isListStorageNode; exports.isLiveNode = isLiveNode; exports.isMapStorageNode = isMapStorageNode; exports.isNotificationChannelEnabled = isNotificationChannelEnabled; exports.isNumberOperator = isNumberOperator; exports.isObjectStorageNode = isObjectStorageNode; exports.isPlainObject = isPlainObject; exports.isRegisterStorageNode = isRegisterStorageNode; exports.isRootStorageNode = isRootStorageNode; exports.isStartsWithOperator = isStartsWithOperator; exports.isTextStorageNode = isTextStorageNode; exports.isUrl = isUrl; exports.kInternal = kInternal; exports.kStorageUpdateSource = kStorageUpdateSource; exports.keys = keys; exports.makeAbortController = makeAbortController; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.mergeRoomPermissionScopes = mergeRoomPermissionScopes; exports.nanoid = nanoid; exports.nn = nn; exports.nodeStreamToCompactNodes = nodeStreamToCompactNodes; exports.normalizeRoomAccesses = normalizeRoomAccesses; exports.normalizeRoomPermissions = normalizeRoomPermissions; exports.normalizeUpdateRoomAccesses = normalizeUpdateRoomAccesses; exports.objectToQuery = objectToQuery; exports.patchNotificationSettings = patchNotificationSettings; exports.permissionMatrixFromScopes = permissionMatrixFromScopes; exports.raise = raise; exports.resolveMentionsInCommentBody = resolveMentionsInCommentBody; exports.sanitizeUrl = sanitizeUrl; exports.shallow = shallow; exports.shallow2 = shallow2; exports.stableStringify = stableStringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.transformTextOperations = transformTextOperations; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.validatePermissionsSet = validatePermissionsSet; exports.wait = wait; exports.warnOnce = warnOnce; exports.warnOnceIf = warnOnceIf; exports.withTimeout = withTimeout;
 //# sourceMappingURL=index.cjs.map