@liveblocks/core 2.15.1 → 2.16.0-toolbars1

package/dist/index.mjs

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "2.15.1";
+var PKG_VERSION = "2.16.0-toolbars1";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -170,9 +170,6 @@ var errorWithTitle = wrapWithTitle("error");
 function raise(msg) {
   throw new Error(msg);
 }
-function isPlainObject(blob) {
-  return blob !== null && typeof blob === "object" && Object.prototype.toString.call(blob) === "[object Object]";
-}
 function entries(obj) {
   return Object.entries(obj);
 }
@@ -385,19 +382,319 @@ function makeBufferableEventSource() {
   };
 }
 
+// src/lib/freeze.ts
+var freeze = process.env.NODE_ENV === "production" ? (
+  /* istanbul ignore next */
+  (x) => x
+) : Object.freeze;
+
+// src/lib/signals.ts
+var kSinks = Symbol("kSinks");
+var kTrigger = Symbol("kTrigger");
+var signalsToTrigger = null;
+var trackedReads = null;
+function batch(callback) {
+  if (signalsToTrigger !== null) {
+    callback();
+    return;
+  }
+  signalsToTrigger = /* @__PURE__ */ new Set();
+  try {
+    callback();
+  } finally {
+    for (const signal of signalsToTrigger) {
+      signal[kTrigger]();
+    }
+    signalsToTrigger = null;
+  }
+}
+function enqueueTrigger(signal) {
+  if (!signalsToTrigger) raise("Expected to be in an active batch");
+  signalsToTrigger.add(signal);
+}
+function merge(target, patch) {
+  let updated = false;
+  const newValue = { ...target };
+  Object.keys(patch).forEach((k) => {
+    const key = k;
+    const val = patch[key];
+    if (newValue[key] !== val) {
+      if (val === void 0) {
+        delete newValue[key];
+      } else {
+        newValue[key] = val;
+      }
+      updated = true;
+    }
+  });
+  return updated ? newValue : target;
+}
+var AbstractSignal = class {
+  /** @internal */
+  equals;
+  #eventSource;
+  /** @internal */
+  [kSinks];
+  constructor(equals) {
+    this.equals = equals ?? Object.is;
+    this.#eventSource = makeEventSource();
+    this[kSinks] = /* @__PURE__ */ new Set();
+    this.get = this.get.bind(this);
+    this.subscribe = this.subscribe.bind(this);
+    this.subscribeOnce = this.subscribeOnce.bind(this);
+  }
+  [Symbol.dispose]() {
+    this.#eventSource[Symbol.dispose]();
+    this.#eventSource = "(disposed)";
+    this.equals = "(disposed)";
+  }
+  get hasWatchers() {
+    if (this.#eventSource.count() > 0) return true;
+    for (const sink of this[kSinks]) {
+      if (sink.hasWatchers) {
+        return true;
+      }
+    }
+    return false;
+  }
+  [kTrigger]() {
+    this.#eventSource.notify();
+    for (const sink of this[kSinks]) {
+      enqueueTrigger(sink);
+    }
+  }
+  subscribe(callback) {
+    if (this.#eventSource.count() === 0) {
+      this.get();
+    }
+    return this.#eventSource.subscribe(callback);
+  }
+  subscribeOnce(callback) {
+    const unsub = this.subscribe(() => {
+      unsub();
+      return callback();
+    });
+    return unsub;
+  }
+  waitUntil() {
+    throw new Error("waitUntil not supported on Signals");
+  }
+  markSinksDirty() {
+    for (const sink of this[kSinks]) {
+      sink.markDirty();
+    }
+  }
+  addSink(sink) {
+    this[kSinks].add(sink);
+  }
+  removeSink(sink) {
+    this[kSinks].delete(sink);
+  }
+  asReadonly() {
+    return this;
+  }
+};
+var Signal = class extends AbstractSignal {
+  #value;
+  constructor(value, equals) {
+    super(equals);
+    this.#value = freeze(value);
+  }
+  [Symbol.dispose]() {
+    super[Symbol.dispose]();
+    this.#value = "(disposed)";
+  }
+  get() {
+    trackedReads?.add(this);
+    return this.#value;
+  }
+  set(newValue) {
+    batch(() => {
+      if (typeof newValue === "function") {
+        newValue = newValue(this.#value);
+      }
+      if (!this.equals(this.#value, newValue)) {
+        this.#value = freeze(newValue);
+        this.markSinksDirty();
+        enqueueTrigger(this);
+      }
+    });
+  }
+};
+var PatchableSignal = class extends Signal {
+  constructor(data) {
+    super(freeze(compactObject(data)));
+  }
+  set() {
+    throw new Error("Don't call .set() directly, use .patch()");
+  }
+  /**
+   * Patches the current object.
+   */
+  patch(patch) {
+    super.set((old) => merge(old, patch));
+  }
+};
+var INITIAL = Symbol();
+var DerivedSignal = class _DerivedSignal extends AbstractSignal {
+  #prevValue;
+  #dirty;
+  // When true, the value in #value may not be up-to-date and needs re-checking
+  #sources;
+  #deps;
+  #transform;
+  // prettier-ignore
+  static from(...args) {
+    const last = args.pop();
+    if (typeof last !== "function")
+      raise("Invalid .from() call, last argument expected to be a function");
+    if (typeof args[args.length - 1] === "function") {
+      const equals = last;
+      const transform = args.pop();
+      return new _DerivedSignal(args, transform, equals);
+    } else {
+      const transform = last;
+      return new _DerivedSignal(args, transform);
+    }
+  }
+  constructor(deps, transform, equals) {
+    super(equals);
+    this.#dirty = true;
+    this.#prevValue = INITIAL;
+    this.#deps = deps;
+    this.#sources = /* @__PURE__ */ new Set();
+    this.#transform = transform;
+  }
+  [Symbol.dispose]() {
+    for (const src of this.#sources) {
+      src.removeSink(this);
+    }
+    this.#prevValue = "(disposed)";
+    this.#sources = "(disposed)";
+    this.#deps = "(disposed)";
+    this.#transform = "(disposed)";
+  }
+  get isDirty() {
+    return this.#dirty;
+  }
+  #recompute() {
+    const oldTrackedReads = trackedReads;
+    let derived;
+    trackedReads = /* @__PURE__ */ new Set();
+    try {
+      derived = this.#transform(...this.#deps.map((p) => p.get()));
+    } finally {
+      const oldSources = this.#sources;
+      this.#sources = /* @__PURE__ */ new Set();
+      for (const sig of trackedReads) {
+        this.#sources.add(sig);
+        oldSources.delete(sig);
+      }
+      for (const oldSource of oldSources) {
+        oldSource.removeSink(this);
+      }
+      for (const newSource of this.#sources) {
+        newSource.addSink(this);
+      }
+      trackedReads = oldTrackedReads;
+    }
+    this.#dirty = false;
+    if (!this.equals(this.#prevValue, derived)) {
+      this.#prevValue = derived;
+      return true;
+    }
+    return false;
+  }
+  markDirty() {
+    if (!this.#dirty) {
+      this.#dirty = true;
+      this.markSinksDirty();
+    }
+  }
+  get() {
+    if (this.#dirty) {
+      this.#recompute();
+    }
+    trackedReads?.add(this);
+    return this.#prevValue;
+  }
+  /**
+   * Called by the Signal system if one or more of the dependent signals have
+   * changed. In the case of a DerivedSignal, we'll only want to re-evaluate
+   * the actual value if it's being watched, or any of their sinks are being
+   * watched actively.
+   */
+  [kTrigger]() {
+    if (!this.hasWatchers) {
+      return;
+    }
+    const updated = this.#recompute();
+    if (updated) {
+      super[kTrigger]();
+    }
+  }
+};
+var MutableSignal = class extends AbstractSignal {
+  #state;
+  constructor(initialState) {
+    super();
+    this.#state = initialState;
+  }
+  [Symbol.dispose]() {
+    super[Symbol.dispose]();
+    this.#state = "(disposed)";
+  }
+  get() {
+    trackedReads?.add(this);
+    return this.#state;
+  }
+  /**
+   * Invokes a callback function that is allowed to mutate the given state
+   * value. Do not change the value outside of the callback.
+   *
+   * If the callback explicitly returns `false`, it's assumed that the state
+   * was not changed.
+   */
+  mutate(callback) {
+    batch(() => {
+      const result = callback ? callback(this.#state) : true;
+      if (result !== null && typeof result === "object" && "then" in result) {
+        raise("MutableSignal.mutate() does not support async callbacks");
+      }
+      if (result !== false) {
+        this.markSinksDirty();
+        enqueueTrigger(this);
+      }
+    });
+  }
+};
+
 // src/lib/stringify.ts
-function stringify(object, ...args) {
-  if (typeof object !== "object" || object === null || Array.isArray(object)) {
-    return JSON.stringify(object, ...args);
-  }
-  const sortedObject = Object.keys(object).sort().reduce(
-    (sortedObject2, key) => {
-      sortedObject2[key] = object[key];
-      return sortedObject2;
-    },
-    {}
-  );
-  return JSON.stringify(sortedObject, ...args);
+var EXPLICIT_UNDEFINED_PLACEHOLDER = "_explicit_undefined";
+function replacer(_key, value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? Object.keys(value).sort().reduce((sorted, key) => {
+    sorted[key] = value[key];
+    return sorted;
+  }, {}) : value === void 0 ? EXPLICIT_UNDEFINED_PLACEHOLDER : value;
+}
+function reviver(key, value) {
+  if (!key && value === EXPLICIT_UNDEFINED_PLACEHOLDER) {
+    return void 0;
+  }
+  if (value && typeof value === "object") {
+    for (const k in value) {
+      if (value[k] === EXPLICIT_UNDEFINED_PLACEHOLDER) {
+        Object.defineProperty(value, k, { value: void 0 });
+      }
+    }
+  }
+  return value;
+}
+function stringify(value) {
+  return JSON.stringify(value, replacer);
+}
+function unstringify(value) {
+  return JSON.parse(value, reviver);
 }
 
 // src/lib/batch.ts
@@ -492,57 +789,58 @@ var Batch = class {
   }
 };
 function createBatchStore(batch2) {
-  const cache = /* @__PURE__ */ new Map();
-  const eventSource2 = makeEventSource();
+  const signal = new MutableSignal(/* @__PURE__ */ new Map());
   function getCacheKey(args) {
     return stringify(args);
   }
-  function setStateAndNotify(cacheKey, state) {
-    cache.set(cacheKey, state);
-    eventSource2.notify();
+  function update(cacheKey, state) {
+    signal.mutate((cache) => {
+      cache.set(cacheKey, state);
+    });
   }
   function invalidate(inputs) {
-    if (Array.isArray(inputs)) {
-      for (const input of inputs) {
-        cache.delete(getCacheKey(input));
+    signal.mutate((cache) => {
+      if (Array.isArray(inputs)) {
+        for (const input of inputs) {
+          cache.delete(getCacheKey(input));
+        }
+      } else {
+        cache.clear();
       }
-    } else {
-      cache.clear();
-    }
-    eventSource2.notify();
+    });
   }
-  async function get(input) {
+  async function enqueue(input) {
     const cacheKey = getCacheKey(input);
+    const cache = signal.get();
     if (cache.has(cacheKey)) {
       return;
     }
     try {
-      setStateAndNotify(cacheKey, { isLoading: true });
+      update(cacheKey, { isLoading: true });
       const result = await batch2.get(input);
-      setStateAndNotify(cacheKey, { isLoading: false, data: result });
+      update(cacheKey, { isLoading: false, data: result });
     } catch (error3) {
-      setStateAndNotify(cacheKey, {
+      update(cacheKey, {
         isLoading: false,
         error: error3
       });
     }
   }
-  function getState(input) {
+  function getItemState(input) {
     const cacheKey = getCacheKey(input);
+    const cache = signal.get();
     return cache.get(cacheKey);
   }
   function _cacheKeys() {
+    const cache = signal.get();
     return [...cache.keys()];
   }
-  function getBatch() {
-    return batch2;
-  }
   return {
-    ...eventSource2.observable,
-    get,
-    getState,
+    subscribe: signal.subscribe,
+    enqueue,
+    getItemState,
     invalidate,
-    getBatch,
+    batch: batch2,
     _cacheKeys
   };
 }
@@ -583,6 +881,44 @@ function createInboxNotificationId() {
   return createOptimisticId(INBOX_NOTIFICATION_ID_PREFIX);
 }
 
+// src/lib/DefaultMap.ts
+var DefaultMap = class extends Map {
+  #defaultFn;
+  /**
+   * If the default function is not provided to the constructor, it has to be
+   * provided in each .getOrCreate() call individually.
+   */
+  constructor(defaultFn, entries2) {
+    super(entries2);
+    this.#defaultFn = defaultFn;
+  }
+  /**
+   * Gets the value at the given key, or creates it.
+   *
+   * Difference from normal Map: if the key does not exist, it will be created
+   * on the fly using the factory function, and that value will get returned
+   * instead of `undefined`.
+   */
+  getOrCreate(key, defaultFn) {
+    if (super.has(key)) {
+      return super.get(key);
+    } else {
+      const fn = defaultFn ?? this.#defaultFn ?? raise("DefaultMap used without a factory function");
+      const value = fn(key);
+      this.set(key, value);
+      return value;
+    }
+  }
+};
+
+// src/lib/guards.ts
+function isPlainObject(blob) {
+  return blob !== null && typeof blob === "object" && Object.prototype.toString.call(blob) === "[object Object]";
+}
+function isStartsWithOperator(blob) {
+  return isPlainObject(blob) && typeof blob.startsWith === "string";
+}
+
 // src/lib/objectToQuery.ts
 var identifierRegex = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
 function objectToQuery(obj) {
@@ -597,10 +933,12 @@ function objectToQuery(obj) {
     }
     if (isSimpleValue(value)) {
       keyValuePairs.push([key, value]);
-    } else if (isValueWithOperator(value)) {
-      keyValuePairsWithOperator.push([key, value]);
-    } else if (typeof value === "object" && !("startsWith" in value)) {
-      indexedKeys.push([key, value]);
+    } else if (isPlainObject(value)) {
+      if (isStartsWithOperator(value)) {
+        keyValuePairsWithOperator.push([key, value]);
+      } else {
+        indexedKeys.push([key, value]);
+      }
     }
   });
   filterList = [
@@ -617,7 +955,7 @@ function objectToQuery(obj) {
       }
       if (isSimpleValue(nestedValue)) {
         nKeyValuePairs.push([formatFilterKey(key, nestedKey), nestedValue]);
-      } else if (isValueWithOperator(nestedValue)) {
+      } else if (isStartsWithOperator(nestedValue)) {
         nKeyValuePairsWithOperator.push([
           formatFilterKey(key, nestedKey),
           nestedValue
@@ -659,16 +997,7 @@ var getFiltersFromKeyValuePairsWithOperator = (keyValuePairsWithOperator) => {
   return filters;
 };
 var isSimpleValue = (value) => {
-  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
-    return true;
-  }
-  return false;
-};
-var isValueWithOperator = (value) => {
-  if (typeof value === "object" && value !== null && "startsWith" in value) {
-    return true;
-  }
-  return false;
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
 };
 var formatFilter = (key, operator, value) => {
   return `${key}${operator}${value}`;
@@ -1083,40 +1412,31 @@ function createApiClient({
       }
     }
   }
-  const getAttachmentUrlsBatchStoreByRoom = /* @__PURE__ */ new Map();
+  const attachmentUrlsBatchStoresByRoom = new DefaultMap((roomId) => {
+    const batch2 = new Batch(
+      async (batchedAttachmentIds) => {
+        const attachmentIds = batchedAttachmentIds.flat();
+        const { urls } = await httpClient.post(
+          url`/v2/c/rooms/${roomId}/attachments/presigned-urls`,
+          await authManager.getAuthValue({
+            requestedScope: "comments:read",
+            roomId
+          }),
+          { attachmentIds }
+        );
+        return urls.map(
+          (url2) => url2 ?? new Error("There was an error while getting this attachment's URL")
+        );
+      },
+      { delay: 50 }
+    );
+    return createBatchStore(batch2);
+  });
   function getOrCreateAttachmentUrlsStore(roomId) {
-    let store = getAttachmentUrlsBatchStoreByRoom.get(roomId);
-    if (store === void 0) {
-      const batch2 = new Batch(
-        async (batchedAttachmentIds) => {
-          const attachmentIds = batchedAttachmentIds.flat();
-          const { urls } = await httpClient.post(
-            url`/v2/c/rooms/${roomId}/attachments/presigned-urls`,
-            await authManager.getAuthValue({
-              requestedScope: "comments:read",
-              roomId
-            }),
-            {
-              attachmentIds
-            }
-          );
-          return urls.map(
-            (url2) => url2 ?? new Error(
-              "There was an error while getting this attachment's URL"
-            )
-          );
-        },
-        {
-          delay: 50
-        }
-      );
-      store = createBatchStore(batch2);
-      getAttachmentUrlsBatchStoreByRoom.set(roomId, store);
-    }
-    return store;
+    return attachmentUrlsBatchStoresByRoom.getOrCreate(roomId);
   }
   function getAttachmentUrl(options) {
-    const batch2 = getOrCreateAttachmentUrlsStore(options.roomId).getBatch();
+    const batch2 = getOrCreateAttachmentUrlsStore(options.roomId).batch;
     return batch2.get(options.attachmentId);
   }
   async function getNotificationSettings(options) {
@@ -1142,33 +1462,25 @@ function createApiClient({
       options.settings
     );
   }
-  const markInboxNotificationsAsReadBatchByRoom = /* @__PURE__ */ new Map();
-  function getOrCreateMarkInboxNotificationsAsReadBatch(roomId) {
-    let batch2 = markInboxNotificationsAsReadBatchByRoom.get(roomId);
-    if (batch2 === void 0) {
-      batch2 = new Batch(
-        async (batchedInboxNotificationIds) => {
-          const inboxNotificationIds = batchedInboxNotificationIds.flat();
-          await httpClient.post(
-            url`/v2/c/rooms/${roomId}/inbox-notifications/read`,
-            await authManager.getAuthValue({
-              requestedScope: "comments:read",
-              roomId
-            }),
-            { inboxNotificationIds }
-          );
-          return inboxNotificationIds;
-        },
-        {
-          delay: 50
-        }
-      );
-      markInboxNotificationsAsReadBatchByRoom.set(roomId, batch2);
-    }
-    return batch2;
-  }
+  const markAsReadBatchesByRoom = new DefaultMap(
+    (roomId) => new Batch(
+      async (batchedInboxNotificationIds) => {
+        const inboxNotificationIds = batchedInboxNotificationIds.flat();
+        await httpClient.post(
+          url`/v2/c/rooms/${roomId}/inbox-notifications/read`,
+          await authManager.getAuthValue({
+            requestedScope: "comments:read",
+            roomId
+          }),
+          { inboxNotificationIds }
+        );
+        return inboxNotificationIds;
+      },
+      { delay: 50 }
+    )
+  );
   async function markRoomInboxNotificationAsRead(options) {
-    const batch2 = getOrCreateMarkInboxNotificationsAsReadBatch(options.roomId);
+    const batch2 = markAsReadBatchesByRoom.getOrCreate(options.roomId);
     return batch2.get(options.inboxNotificationId);
   }
   async function createTextMention(options) {
@@ -2166,6 +2478,7 @@ function toNewConnectionStatus(machine) {
       return machine.context.successCount > 0 ? "reconnecting" : "connecting";
     case "@idle.failed":
       return "disconnected";
+    // istanbul ignore next
     default:
       return assertNever(state, "Unknown state");
   }
@@ -3046,6 +3359,12 @@ function setupDevTools(getAllRooms) {
   _devtoolsSetupHasRun = true;
   onMessageFromPanel.subscribe((msg) => {
     switch (msg.msg) {
+      // When a devtool panel sends an explicit "connect" message back to this
+      // live running client (in response to the "wake-up-devtools" message,
+      // or when the devtool panel is opened for the first time), it means that it's okay to
+      // start emitting messages.
+      // Before this explicit acknowledgement, any call to sendToPanel() will
+      // be a no-op.
       case "connect": {
         activateBridge(true);
         for (const roomId of getAllRooms()) {
@@ -3186,6 +3505,8 @@ function linkDevTools(roomId, room) {
     // roomChannelListeners registry
     onMessageFromPanel.subscribe((msg) => {
       switch (msg.msg) {
+        // Sent by the devtool panel when it wants to receive the sync stream
+        // for a room
         case "room::subscribe": {
           if (msg.roomId === roomId) {
             startSyncStream(room);
@@ -3214,267 +3535,6 @@ function unlinkDevTools(roomId) {
   });
 }
 
-// src/lib/freeze.ts
-var freeze = process.env.NODE_ENV === "production" ? (
-  /* istanbul ignore next */
-  (x) => x
-) : Object.freeze;
-
-// src/lib/signals.ts
-var kSinks = Symbol("kSinks");
-var kTrigger = Symbol("kTrigger");
-var signalsToTrigger = null;
-function batch(callback) {
-  if (signalsToTrigger !== null) {
-    callback();
-    return;
-  }
-  signalsToTrigger = /* @__PURE__ */ new Set();
-  try {
-    callback();
-  } finally {
-    for (const signal of signalsToTrigger) {
-      signal[kTrigger]();
-    }
-    signalsToTrigger = null;
-  }
-}
-function enqueueTrigger(signal) {
-  if (!signalsToTrigger) raise("Expected to be in an active batch");
-  signalsToTrigger.add(signal);
-}
-function merge(target, patch) {
-  let updated = false;
-  const newValue = { ...target };
-  Object.keys(patch).forEach((k) => {
-    const key = k;
-    const val = patch[key];
-    if (newValue[key] !== val) {
-      if (val === void 0) {
-        delete newValue[key];
-      } else {
-        newValue[key] = val;
-      }
-      updated = true;
-    }
-  });
-  return updated ? newValue : target;
-}
-var AbstractSignal = class {
-  /** @internal */
-  equals;
-  #eventSource;
-  /** @internal */
-  [kSinks];
-  constructor(equals) {
-    this.equals = equals ?? Object.is;
-    this.#eventSource = makeEventSource();
-    this[kSinks] = /* @__PURE__ */ new Set();
-    this.get = this.get.bind(this);
-    this.subscribe = this.subscribe.bind(this);
-    this.subscribeOnce = this.subscribeOnce.bind(this);
-  }
-  [Symbol.dispose]() {
-    this.#eventSource[Symbol.dispose]();
-    this.#eventSource = "(disposed)";
-    this.equals = "(disposed)";
-  }
-  get hasWatchers() {
-    if (this.#eventSource.count() > 0) return true;
-    for (const sink of this[kSinks]) {
-      if (sink.hasWatchers) {
-        return true;
-      }
-    }
-    return false;
-  }
-  [kTrigger]() {
-    this.#eventSource.notify();
-    for (const sink of this[kSinks]) {
-      enqueueTrigger(sink);
-    }
-  }
-  subscribe(callback) {
-    return this.#eventSource.subscribe(callback);
-  }
-  subscribeOnce(callback) {
-    const unsub = this.subscribe(() => {
-      unsub();
-      return callback();
-    });
-    return unsub;
-  }
-  waitUntil() {
-    throw new Error("waitUntil not supported on Signals");
-  }
-  markSinksDirty() {
-    for (const sink of this[kSinks]) {
-      sink.markDirty();
-    }
-  }
-  addSink(sink) {
-    this[kSinks].add(sink);
-  }
-  removeSink(sink) {
-    this[kSinks].delete(sink);
-  }
-  asReadonly() {
-    return this;
-  }
-};
-var Signal = class extends AbstractSignal {
-  #value;
-  constructor(value, equals) {
-    super(equals);
-    this.#value = freeze(value);
-  }
-  [Symbol.dispose]() {
-    super[Symbol.dispose]();
-    this.#value = "(disposed)";
-  }
-  get() {
-    return this.#value;
-  }
-  set(newValue) {
-    batch(() => {
-      if (typeof newValue === "function") {
-        newValue = newValue(this.#value);
-      }
-      if (!this.equals(this.#value, newValue)) {
-        this.#value = freeze(newValue);
-        this.markSinksDirty();
-        enqueueTrigger(this);
-      }
-    });
-  }
-};
-var PatchableSignal = class extends Signal {
-  constructor(data) {
-    super(freeze(compactObject(data)));
-  }
-  set() {
-    throw new Error("Don't call .set() directly, use .patch()");
-  }
-  /**
-   * Patches the current object.
-   */
-  patch(patch) {
-    super.set((old) => merge(old, patch));
-  }
-};
-var INITIAL = Symbol();
-var DerivedSignal = class _DerivedSignal extends AbstractSignal {
-  #prevValue;
-  #dirty;
-  // When true, the value in #value may not be up-to-date and needs re-checking
-  #parents;
-  #transform;
-  // prettier-ignore
-  static from(...args) {
-    const last = args.pop();
-    if (typeof last !== "function")
-      raise("Invalid .from() call, last argument expected to be a function");
-    if (typeof args[args.length - 1] === "function") {
-      const equals = last;
-      const transform = args.pop();
-      return new _DerivedSignal(args, transform, equals);
-    } else {
-      const transform = last;
-      return new _DerivedSignal(args, transform);
-    }
-  }
-  constructor(parents, transform, equals) {
-    super(equals);
-    this.#dirty = true;
-    this.#prevValue = INITIAL;
-    this.#parents = parents;
-    this.#transform = transform;
-    for (const parent of parents) {
-      parent.addSink(this);
-    }
-  }
-  [Symbol.dispose]() {
-    for (const parent of this.#parents) {
-      parent.removeSink(this);
-    }
-    this.#prevValue = "(disposed)";
-    this.#parents = "(disposed)";
-    this.#transform = "(disposed)";
-  }
-  get isDirty() {
-    return this.#dirty;
-  }
-  #recompute() {
-    const derived = this.#transform(...this.#parents.map((p) => p.get()));
-    this.#dirty = false;
-    if (!this.equals(this.#prevValue, derived)) {
-      this.#prevValue = derived;
-      return true;
-    }
-    return false;
-  }
-  markDirty() {
-    if (!this.#dirty) {
-      this.#dirty = true;
-      this.markSinksDirty();
-    }
-  }
-  get() {
-    if (this.#dirty) {
-      this.#recompute();
-    }
-    return this.#prevValue;
-  }
-  /**
-   * Called by the Signal system if one or more of the dependent signals have
-   * changed. In the case of a DerivedSignal, we'll only want to re-evaluate
-   * the actual value if it's being watched, or any of their sinks are being
-   * watched actively.
-   */
-  [kTrigger]() {
-    if (!this.hasWatchers) {
-      return;
-    }
-    const updated = this.#recompute();
-    if (updated) {
-      super[kTrigger]();
-    }
-  }
-};
-var MutableSignal = class extends AbstractSignal {
-  #state;
-  constructor(initialState) {
-    super();
-    this.#state = initialState;
-  }
-  [Symbol.dispose]() {
-    super[Symbol.dispose]();
-    this.#state = "(disposed)";
-  }
-  get() {
-    return this.#state;
-  }
-  /**
-   * Invokes a callback function that is allowed to mutate the given state
-   * value. Do not change the value outside of the callback.
-   *
-   * If the callback explicitly returns `false`, it's assumed that the state
-   * was not changed.
-   */
-  mutate(callback) {
-    batch(() => {
-      const result = callback ? callback(this.#state) : true;
-      if (result !== null && typeof result === "object" && "then" in result) {
-        raise("MutableSignal.mutate() does not support async callbacks");
-      }
-      if (result !== false) {
-        this.markSinksDirty();
-        enqueueTrigger(this);
-      }
-    });
-  }
-};
-
 // src/lib/position.ts
 var MIN_CODE = 32;
 var MAX_CODE = 126;
@@ -6889,6 +6949,7 @@ function createRoom(options, config) {
           processInitialStorage(message);
           break;
         }
+        // Write event
         case 201 /* UPDATE_STORAGE */: {
           const applyResult = applyOps(message.ops, false);
           for (const [key, value] of applyResult.updates.storageUpdates) {
@@ -6899,6 +6960,11 @@ 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. We look at this kind of bug
+        // as a developer-owned bug. In production, these errors are not expected to happen.
         case 299 /* REJECT_STORAGE_OP */: {
           errorWithTitle(
             "Storage mutation rejection error",
@@ -7560,6 +7626,7 @@ function makeClassicSubscribeFn(events) {
           return events.comments.subscribe(
             callback
           );
+        // istanbul ignore next
         default:
           return assertNever(
             first,
@@ -8842,6 +8909,7 @@ export {
   ClientMsgCode,
   CommentsApiError,
   CrdtType,
+  DefaultMap,
   DerivedSignal,
   HttpError,
   LiveList,
@@ -8896,6 +8964,7 @@ export {
   isLiveNode,
   isPlainObject,
   isRootCrdt,
+  isStartsWithOperator,
   kInternal,
   legacy_patchImmutableObject,
   lsonToJson,
@@ -8917,6 +8986,7 @@ export {
   toAbsoluteUrl,
   toPlainLson,
   tryParseJson,
+  unstringify,
   url,
   urljoin,
   wait,