@liveblocks/core 2.14.0 → 2.15.0-debug1

package/README.md

@@ -9,4 +9,4 @@ not import anything directly from this package**.
 - At the `packages/liveblocks-core` root level, add a file `.env`
 - In this file, add the environment variable:
   `LIVEBLOCKS_PUBLIC_KEY="pk_YOUR_PUBLIC_API_KEY"`
-- Run `npm run test:e2e`
+- Run `turbo run test:e2e`

package/dist/index.d.mts

@@ -104,21 +104,22 @@ declare type EventSource<T> = Observable<T> & {
      * Returns the number of active subscribers.
      */
     count(): number;
-    /**
-     * Pauses event delivery until unpaused. Any .notify() calls made while
-     * paused will get buffered into memory and emitted later.
-     */
-    pause(): void;
-    /**
-     * Emits all in-memory buffered events, and unpauses. Any .notify() calls
-     * made after this will be synchronously delivered again.
-     */
-    unpause(): void;
     /**
      * Observable instance, which can be used to subscribe to this event source
      * in a readonly fashion. Safe to publicly expose.
      */
     observable: Observable<T>;
+    /**
+     * Disposes of this event source.
+     *
+     * Will clears all registered event listeners. None of the registered
+     * functions will ever get called again.
+     *
+     * WARNING!
+     * Be careful when using this API, because the subscribers may not have any
+     * idea they won't be notified anymore.
+     */
+    [Symbol.dispose](): void;
 };
 /**
  * makeEventSource allows you to generate a subscribe/notify pair of functions
@@ -473,6 +474,7 @@ declare type LiveMapUpdates<TKey extends string, TValue extends Lson> = {
  * If multiple clients update the same property simultaneously, the last modification received by the Liveblocks servers is the winner.
  */
 declare class LiveMap<TKey extends string, TValue extends Lson> extends AbstractCrdt {
+    #private;
     constructor(entries?: readonly (readonly [TKey, TValue])[] | undefined);
     /**
      * Returns a specified element from the LiveMap.
@@ -538,6 +540,7 @@ declare type LiveListUpdate = LiveListUpdates<Lson>;
 declare type StorageUpdate = LiveMapUpdate | LiveObjectUpdate | LiveListUpdate;
 
 declare abstract class AbstractCrdt {
+    #private;
     get roomId(): string | null;
     /**
      * Return an immutable snapshot of this Live node and its children.
@@ -581,6 +584,7 @@ declare type LiveListUpdates<TItem extends Lson> = {
  * The LiveList class represents an ordered collection of items that is synchronized across clients.
  */
 declare class LiveList<TItem extends Lson> extends AbstractCrdt {
+    #private;
     constructor(items: TItem[]);
     /**
      * Returns the number of elements.
@@ -684,6 +688,7 @@ declare class LiveList<TItem extends Lson> extends AbstractCrdt {
  * INTERNAL
  */
 declare class LiveRegister<TValue extends Json> extends AbstractCrdt {
+    #private;
     constructor(data: TValue);
     get data(): TValue;
     clone(): TValue;
@@ -750,6 +755,7 @@ declare type LiveObjectUpdates<TData extends LsonObject> = {
  * If multiple clients update the same property simultaneously, the last modification received by the Liveblocks servers is the winner.
  */
 declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
+    #private;
     constructor(obj?: O);
     /**
      * Transform the LiveObject into a javascript object
@@ -2578,24 +2584,93 @@ interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, Noti
 }
 
 /**
- * A Store is just a mini Zustand store.
+ * Back-port of TypeScript 5.4's built-in NoInfer utility type.
+ * See https://stackoverflow.com/a/56688073/148872
  */
-declare type Store<T> = {
-    get: () => Readonly<T>;
-    set: (callback: (currentState: Readonly<T>) => Readonly<T>) => void;
-    subscribe: (callback: () => void) => () => void;
-    batch: (callback: () => void) => void;
-};
+declare type NoInfr<A> = [A][A extends any ? 0 : never];
+
+declare const kTrigger: unique symbol;
 /**
- * Create a store for an immutable state. Close to Zustand's vanilla store conceptually but with less features.
+ * Runs a callback function that is allowed to change multiple signals. At the
+ * end of the batch, all changed signals will be notified (at most once).
+ *
+ * Nesting batches is supported.
  */
-declare function createStore<T>(initialState: T): Store<T>;
-
+declare function batch(callback: Callback<void>): void;
+declare type SignalType<S extends ISignal<any>> = S extends ISignal<infer T> ? T : never;
+interface ISignal<T> {
+    get(): T;
+    subscribe(callback: Callback<void>): UnsubscribeCallback;
+    addSink(sink: DerivedSignal<unknown>): void;
+    removeSink(sink: DerivedSignal<unknown>): void;
+}
 /**
- * Back-port of TypeScript 5.4's built-in NoInfer utility type.
- * See https://stackoverflow.com/a/56688073/148872
+ * Base functionality every Signal implementation needs.
+ */
+declare abstract class AbstractSignal<T> implements ISignal<T>, Observable<void> {
+    #private;
+    constructor(equals?: (a: T, b: T) => boolean);
+    [Symbol.dispose](): void;
+    abstract get(): T;
+    get hasWatchers(): boolean;
+    [kTrigger](): void;
+    subscribe(callback: Callback<void>): UnsubscribeCallback;
+    subscribeOnce(callback: Callback<void>): UnsubscribeCallback;
+    waitUntil(): never;
+    markSinksDirty(): void;
+    addSink(sink: DerivedSignal<unknown>): void;
+    removeSink(sink: DerivedSignal<unknown>): void;
+}
+declare class Signal<T> extends AbstractSignal<T> {
+    #private;
+    constructor(value: T, equals?: (a: T, b: T) => boolean);
+    [Symbol.dispose](): void;
+    get(): T;
+    set(newValue: T | ((oldValue: T) => T)): void;
+}
+declare class DerivedSignal<T> extends AbstractSignal<T> {
+    #private;
+    static from<Ts extends [unknown, ...unknown[]], V>(...args: [...signals: {
+        [K in keyof Ts]: ISignal<Ts[K]>;
+    }, transform: (...values: Ts) => V]): DerivedSignal<V>;
+    static from<Ts extends [unknown, ...unknown[]], V>(...args: [...signals: {
+        [K in keyof Ts]: ISignal<Ts[K]>;
+    }, transform: (...values: Ts) => V, equals: (a: V, b: V) => boolean]): DerivedSignal<V>;
+    private constructor();
+    [Symbol.dispose](): void;
+    get isDirty(): boolean;
+    markDirty(): void;
+    get(): T;
+    /**
+     * 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](): void;
+}
+/**
+ * A MutableSignal is a bit like Signal, except its state is managed by
+ * a single value whose reference does not change but is mutated.
+ *
+ * Similar to how useSyncExternalState() works in React, there is a way to read
+ * the current state at any point in time synchronously, and a way to update
+ * its reference.
  */
-declare type NoInfr<A> = [A][A extends any ? 0 : never];
+declare class MutableSignal<T extends object> extends AbstractSignal<T> {
+    #private;
+    constructor(initialState: T);
+    [Symbol.dispose](): void;
+    get(): T;
+    /**
+     * 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?: (state: T) => unknown): void;
+}
 
 declare type OptionalPromise<T> = T | Promise<T>;
 
@@ -2630,15 +2705,6 @@ declare type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS>
      * the authentication endpoint or connect via WebSocket.
      */
     autoConnect?: boolean;
-    /**
-     * Only necessary when you’re using Liveblocks with React v17 or lower.
-     *
-     * If so, pass in a reference to `ReactDOM.unstable_batchedUpdates` here.
-     * This will allow Liveblocks to circumvent the so-called "zombie child
-     * problem". To learn more, see
-     * https://liveblocks.io/docs/guides/troubleshooting#stale-props-zombie-child
-     */
-    unstable_batchedUpdates?: (cb: () => void) => void;
 } & PartialUnless<P, {
     /**
      * The initial Presence to use and announce when you enter the Room. The
@@ -2668,7 +2734,7 @@ declare type InternalSyncStatus = SyncStatus | "has-local-changes";
  * will probably happen if you do.
  */
 declare type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
-    readonly currentUserIdStore: Store<string | undefined>;
+    readonly currentUserId: Signal<string | undefined>;
     readonly mentionSuggestionsCache: Map<string, string[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
     readonly usersStore: BatchStore<U["info"] | undefined, string>;
@@ -3027,8 +3093,7 @@ declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
 declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
 declare function htmlSafe(value: string): HtmlSafeString;
 declare class HtmlSafeString {
-    private _strings;
-    private _values;
+    #private;
     constructor(strings: readonly string[], values: readonly (string | string[] | HtmlSafeString | HtmlSafeString[])[]);
     toString(): string;
 }
@@ -3463,8 +3528,7 @@ declare function shallow(a: unknown, b: unknown): boolean;
  * [{ id: 1 }, { id: 4 }, { id: 5 }, { id: 9 }])
  */
 declare class SortedList<T> {
-    private _data;
-    private _lt;
+    #private;
     private constructor();
     static from<T>(arr: T[], lt: (a: T, b: T) => boolean): SortedList<T>;
     static fromAlreadySorted<T>(alreadySorted: T[], lt: (a: T, b: T) => boolean): SortedList<T>;
@@ -3647,4 +3711,4 @@ declare const CommentsApiError: typeof HttpError;
 /** @deprecated Use HttpError instead. */
 declare const NotificationsApiError: typeof HttpError;
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, SortedList, type Status, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createStore, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };

package/dist/index.d.ts

@@ -104,21 +104,22 @@ declare type EventSource<T> = Observable<T> & {
      * Returns the number of active subscribers.
      */
     count(): number;
-    /**
-     * Pauses event delivery until unpaused. Any .notify() calls made while
-     * paused will get buffered into memory and emitted later.
-     */
-    pause(): void;
-    /**
-     * Emits all in-memory buffered events, and unpauses. Any .notify() calls
-     * made after this will be synchronously delivered again.
-     */
-    unpause(): void;
     /**
      * Observable instance, which can be used to subscribe to this event source
      * in a readonly fashion. Safe to publicly expose.
      */
     observable: Observable<T>;
+    /**
+     * Disposes of this event source.
+     *
+     * Will clears all registered event listeners. None of the registered
+     * functions will ever get called again.
+     *
+     * WARNING!
+     * Be careful when using this API, because the subscribers may not have any
+     * idea they won't be notified anymore.
+     */
+    [Symbol.dispose](): void;
 };
 /**
  * makeEventSource allows you to generate a subscribe/notify pair of functions
@@ -473,6 +474,7 @@ declare type LiveMapUpdates<TKey extends string, TValue extends Lson> = {
  * If multiple clients update the same property simultaneously, the last modification received by the Liveblocks servers is the winner.
  */
 declare class LiveMap<TKey extends string, TValue extends Lson> extends AbstractCrdt {
+    #private;
     constructor(entries?: readonly (readonly [TKey, TValue])[] | undefined);
     /**
      * Returns a specified element from the LiveMap.
@@ -538,6 +540,7 @@ declare type LiveListUpdate = LiveListUpdates<Lson>;
 declare type StorageUpdate = LiveMapUpdate | LiveObjectUpdate | LiveListUpdate;
 
 declare abstract class AbstractCrdt {
+    #private;
     get roomId(): string | null;
     /**
      * Return an immutable snapshot of this Live node and its children.
@@ -581,6 +584,7 @@ declare type LiveListUpdates<TItem extends Lson> = {
  * The LiveList class represents an ordered collection of items that is synchronized across clients.
  */
 declare class LiveList<TItem extends Lson> extends AbstractCrdt {
+    #private;
     constructor(items: TItem[]);
     /**
      * Returns the number of elements.
@@ -684,6 +688,7 @@ declare class LiveList<TItem extends Lson> extends AbstractCrdt {
  * INTERNAL
  */
 declare class LiveRegister<TValue extends Json> extends AbstractCrdt {
+    #private;
     constructor(data: TValue);
     get data(): TValue;
     clone(): TValue;
@@ -750,6 +755,7 @@ declare type LiveObjectUpdates<TData extends LsonObject> = {
  * If multiple clients update the same property simultaneously, the last modification received by the Liveblocks servers is the winner.
  */
 declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
+    #private;
     constructor(obj?: O);
     /**
      * Transform the LiveObject into a javascript object
@@ -2578,24 +2584,93 @@ interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, Noti
 }
 
 /**
- * A Store is just a mini Zustand store.
+ * Back-port of TypeScript 5.4's built-in NoInfer utility type.
+ * See https://stackoverflow.com/a/56688073/148872
  */
-declare type Store<T> = {
-    get: () => Readonly<T>;
-    set: (callback: (currentState: Readonly<T>) => Readonly<T>) => void;
-    subscribe: (callback: () => void) => () => void;
-    batch: (callback: () => void) => void;
-};
+declare type NoInfr<A> = [A][A extends any ? 0 : never];
+
+declare const kTrigger: unique symbol;
 /**
- * Create a store for an immutable state. Close to Zustand's vanilla store conceptually but with less features.
+ * Runs a callback function that is allowed to change multiple signals. At the
+ * end of the batch, all changed signals will be notified (at most once).
+ *
+ * Nesting batches is supported.
  */
-declare function createStore<T>(initialState: T): Store<T>;
-
+declare function batch(callback: Callback<void>): void;
+declare type SignalType<S extends ISignal<any>> = S extends ISignal<infer T> ? T : never;
+interface ISignal<T> {
+    get(): T;
+    subscribe(callback: Callback<void>): UnsubscribeCallback;
+    addSink(sink: DerivedSignal<unknown>): void;
+    removeSink(sink: DerivedSignal<unknown>): void;
+}
 /**
- * Back-port of TypeScript 5.4's built-in NoInfer utility type.
- * See https://stackoverflow.com/a/56688073/148872
+ * Base functionality every Signal implementation needs.
+ */
+declare abstract class AbstractSignal<T> implements ISignal<T>, Observable<void> {
+    #private;
+    constructor(equals?: (a: T, b: T) => boolean);
+    [Symbol.dispose](): void;
+    abstract get(): T;
+    get hasWatchers(): boolean;
+    [kTrigger](): void;
+    subscribe(callback: Callback<void>): UnsubscribeCallback;
+    subscribeOnce(callback: Callback<void>): UnsubscribeCallback;
+    waitUntil(): never;
+    markSinksDirty(): void;
+    addSink(sink: DerivedSignal<unknown>): void;
+    removeSink(sink: DerivedSignal<unknown>): void;
+}
+declare class Signal<T> extends AbstractSignal<T> {
+    #private;
+    constructor(value: T, equals?: (a: T, b: T) => boolean);
+    [Symbol.dispose](): void;
+    get(): T;
+    set(newValue: T | ((oldValue: T) => T)): void;
+}
+declare class DerivedSignal<T> extends AbstractSignal<T> {
+    #private;
+    static from<Ts extends [unknown, ...unknown[]], V>(...args: [...signals: {
+        [K in keyof Ts]: ISignal<Ts[K]>;
+    }, transform: (...values: Ts) => V]): DerivedSignal<V>;
+    static from<Ts extends [unknown, ...unknown[]], V>(...args: [...signals: {
+        [K in keyof Ts]: ISignal<Ts[K]>;
+    }, transform: (...values: Ts) => V, equals: (a: V, b: V) => boolean]): DerivedSignal<V>;
+    private constructor();
+    [Symbol.dispose](): void;
+    get isDirty(): boolean;
+    markDirty(): void;
+    get(): T;
+    /**
+     * 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](): void;
+}
+/**
+ * A MutableSignal is a bit like Signal, except its state is managed by
+ * a single value whose reference does not change but is mutated.
+ *
+ * Similar to how useSyncExternalState() works in React, there is a way to read
+ * the current state at any point in time synchronously, and a way to update
+ * its reference.
  */
-declare type NoInfr<A> = [A][A extends any ? 0 : never];
+declare class MutableSignal<T extends object> extends AbstractSignal<T> {
+    #private;
+    constructor(initialState: T);
+    [Symbol.dispose](): void;
+    get(): T;
+    /**
+     * 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?: (state: T) => unknown): void;
+}
 
 declare type OptionalPromise<T> = T | Promise<T>;
 
@@ -2630,15 +2705,6 @@ declare type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS>
      * the authentication endpoint or connect via WebSocket.
      */
     autoConnect?: boolean;
-    /**
-     * Only necessary when you’re using Liveblocks with React v17 or lower.
-     *
-     * If so, pass in a reference to `ReactDOM.unstable_batchedUpdates` here.
-     * This will allow Liveblocks to circumvent the so-called "zombie child
-     * problem". To learn more, see
-     * https://liveblocks.io/docs/guides/troubleshooting#stale-props-zombie-child
-     */
-    unstable_batchedUpdates?: (cb: () => void) => void;
 } & PartialUnless<P, {
     /**
      * The initial Presence to use and announce when you enter the Room. The
@@ -2668,7 +2734,7 @@ declare type InternalSyncStatus = SyncStatus | "has-local-changes";
  * will probably happen if you do.
  */
 declare type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
-    readonly currentUserIdStore: Store<string | undefined>;
+    readonly currentUserId: Signal<string | undefined>;
     readonly mentionSuggestionsCache: Map<string, string[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
     readonly usersStore: BatchStore<U["info"] | undefined, string>;
@@ -3027,8 +3093,7 @@ declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
 declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
 declare function htmlSafe(value: string): HtmlSafeString;
 declare class HtmlSafeString {
-    private _strings;
-    private _values;
+    #private;
     constructor(strings: readonly string[], values: readonly (string | string[] | HtmlSafeString | HtmlSafeString[])[]);
     toString(): string;
 }
@@ -3463,8 +3528,7 @@ declare function shallow(a: unknown, b: unknown): boolean;
  * [{ id: 1 }, { id: 4 }, { id: 5 }, { id: 9 }])
  */
 declare class SortedList<T> {
-    private _data;
-    private _lt;
+    #private;
     private constructor();
     static from<T>(arr: T[], lt: (a: T, b: T) => boolean): SortedList<T>;
     static fromAlreadySorted<T>(alreadySorted: T[], lt: (a: T, b: T) => boolean): SortedList<T>;
@@ -3647,4 +3711,4 @@ declare const CommentsApiError: typeof HttpError;
 /** @deprecated Use HttpError instead. */
 declare const NotificationsApiError: typeof HttpError;
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, SortedList, type Status, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createStore, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };