@liveblocks/react 1.12.0 → 2.0.0-alpha1

package/dist/index.d.mts

@@ -1,1097 +1,4 @@
-import { ReactElement, ReactNode, PropsWithChildren } from 'react';
-import { JsonObject, LsonObject, BaseUserMeta, LiveObject, User, Json, RoomNotificationSettings, Room, Status, BroadcastOptions, OthersEvent, LostConnectionEvent, History, BaseMetadata as BaseMetadata$1, Client } from '@liveblocks/client';
+export { a as ClientContext, C as ClientSideSuspense, L as LiveblocksProvider, M as MutationContext, R as RoomContext, f as RoomProvider, U as UseThreadsOptions, c as createLiveblocksContext, e as createRoomContext, g as useAddReaction, h as useBatch, i as useBroadcastEvent, j as useCanRedo, k as useCanUndo, u as useClient, l as useCreateComment, m as useCreateThread, n as useDeleteComment, o as useEditComment, p as useEditThreadMetadata, q as useErrorListener, r as useEventListener, s as useHistory, _ as useInboxNotificationThread, V as useInboxNotifications, t as useLostConnectionListener, b as useMarkAllInboxNotificationsAsRead, d as useMarkInboxNotificationAsRead, v as useMarkThreadAsRead, w as useMutation, x as useMyPresence, K as useOther, N as useOthers, O as useOthersConnectionIds, y as useOthersListener, P as useOthersMapped, z as useRedo, A as useRemoveReaction, B as useRoom, W as useRoomInfo, D as useRoomNotificationSettings, Q as useSelf, E as useStatus, S as useStorage, F as useStorageRoot, G as useThreadSubscription, T as useThreads, H as useUndo, X as useUnreadInboxNotificationsCount, I as useUpdateMyPresence, J as useUpdateRoomNotificationSettings, Y as useUser } from './suspense-9ZocWu4y.mjs';
 export { Json, JsonObject, shallow } from '@liveblocks/client';
-import * as _liveblocks_core from '@liveblocks/core';
-import { BaseMetadata, QueryMetadata, Resolve, ToImmutable, kInternal, ThreadData, InboxNotificationData, LiveblocksError, RoomEventMessage, CommentData, RoomInfo, CommentBody, PartialNullable, RoomInitializers, ResolveUsersArgs, OptionalPromise, ResolveMentionSuggestionsArgs, BaseUserMeta as BaseUserMeta$1 } from '@liveblocks/core';
-
-declare type Props = {
-    fallback: NonNullable<ReactNode> | null;
-    children: () => ReactNode | undefined;
-};
-/**
- * Almost like a normal <Suspense> component, except that for server-side
- * renders, the fallback will be used.
- *
- * The child props will have to be provided in a function, i.e. change:
- *
- *   <Suspense fallback={<Loading />}>
- *     <MyRealComponent a={1} />
- *   </Suspense>
- *
- * To:
- *
- *   <ClientSideSuspense fallback={<Loading />}>
- *     {() => <MyRealComponent a={1} />}
- *   </ClientSideSuspense>
- *
- */
-declare function ClientSideSuspense(props: Props): ReactElement;
-
-declare type UseThreadsOptions<TThreadMetadata extends BaseMetadata> = {
-    /**
-     * The query (including metadata) to filter the threads by. If provided, only threads
-     * that match the query will be returned. If not provided, all threads will be returned.
-     */
-    query?: {
-        /**
-         * The metadata to filter the threads by. If provided, only threads with metadata that matches
-         * the provided metadata will be returned. If not provided, all threads will be returned.
-         */
-        metadata?: Partial<QueryMetadata<TThreadMetadata>>;
-    };
-    /**
-     * Whether to scroll to a comment on load based on the URL hash. Defaults to `true`.
-     *
-     * @example
-     * Given the URL `https://example.com/my-room#cm_xxx`, the `cm_xxx` comment will be
-     * scrolled to on load if it exists in the page.
-     */
-    scrollOnLoad?: boolean;
-};
-
-declare type UserStateLoading = {
-    isLoading: true;
-    user?: never;
-    error?: never;
-};
-declare type UserStateError = {
-    isLoading: false;
-    user?: never;
-    error: Error;
-};
-declare type UserStateSuccess<T> = {
-    isLoading: false;
-    user: T;
-    error?: never;
-};
-declare type UserState<T> = UserStateLoading | UserStateError | UserStateSuccess<T>;
-declare type RoomInfoStateLoading = {
-    isLoading: true;
-    info?: never;
-    error?: never;
-};
-declare type RoomInfoStateError = {
-    isLoading: false;
-    info?: never;
-    error: Error;
-};
-declare type RoomInfoStateSuccess = {
-    isLoading: false;
-    info: RoomInfo;
-    error?: never;
-};
-declare type RoomInfoState = RoomInfoStateLoading | RoomInfoStateError | RoomInfoStateSuccess;
-declare type CreateThreadOptions<TMetadata extends BaseMetadata> = [
-    TMetadata
-] extends [never] ? {
-    body: CommentBody;
-} : {
-    body: CommentBody;
-    metadata: TMetadata;
-};
-declare type EditThreadMetadataOptions<TMetadata extends BaseMetadata> = [
-    TMetadata
-] extends [never] ? {
-    threadId: string;
-} : {
-    threadId: string;
-    metadata: Resolve<PartialNullable<TMetadata>>;
-};
-declare type CreateCommentOptions = {
-    threadId: string;
-    body: CommentBody;
-};
-declare type EditCommentOptions = {
-    threadId: string;
-    commentId: string;
-    body: CommentBody;
-};
-declare type DeleteCommentOptions = {
-    threadId: string;
-    commentId: string;
-};
-declare type CommentReactionOptions = {
-    threadId: string;
-    commentId: string;
-    emoji: string;
-};
-declare type ThreadsStateLoading = {
-    isLoading: true;
-    threads?: never;
-    error?: never;
-};
-declare type ThreadsStateResolved<TThreadMetadata extends BaseMetadata> = {
-    isLoading: false;
-    threads: ThreadData<TThreadMetadata>[];
-    error?: Error;
-};
-declare type ThreadsStateSuccess<TThreadMetadata extends BaseMetadata> = {
-    isLoading: false;
-    threads: ThreadData<TThreadMetadata>[];
-    error?: never;
-};
-declare type ThreadsState<TThreadMetadata extends BaseMetadata> = ThreadsStateLoading | ThreadsStateResolved<TThreadMetadata>;
-declare type InboxNotificationsStateLoading = {
-    isLoading: true;
-    inboxNotifications?: never;
-    error?: never;
-};
-declare type InboxNotificationsStateResolved = {
-    isLoading: false;
-    inboxNotifications: InboxNotificationData[];
-    error?: Error;
-};
-declare type InboxNotificationsStateSuccess = {
-    isLoading: false;
-    inboxNotifications: InboxNotificationData[];
-    error?: never;
-};
-declare type InboxNotificationsStateError = {
-    isLoading: false;
-    inboxNotifications?: never;
-    error: Error;
-};
-declare type InboxNotificationsState = InboxNotificationsStateLoading | InboxNotificationsStateResolved | InboxNotificationsStateError;
-declare type UnreadInboxNotificationsCountStateLoading = {
-    isLoading: true;
-    count?: never;
-    error?: never;
-};
-declare type UnreadInboxNotificationsCountStateSuccess = {
-    isLoading: false;
-    count: number;
-    error?: never;
-};
-declare type UnreadInboxNotificationsCountStateError = {
-    isLoading: false;
-    count?: never;
-    error: Error;
-};
-declare type UnreadInboxNotificationsCountState = UnreadInboxNotificationsCountStateLoading | UnreadInboxNotificationsCountStateSuccess | UnreadInboxNotificationsCountStateError;
-declare type RoomNotificationSettingsStateLoading = {
-    isLoading: true;
-    settings?: never;
-    error?: never;
-};
-declare type RoomNotificationSettingsStateError = {
-    isLoading: false;
-    settings?: never;
-    error: Error;
-};
-declare type RoomNotificationSettingsStateSuccess = {
-    isLoading: false;
-    settings: RoomNotificationSettings;
-    error?: never;
-};
-declare type RoomNotificationSettingsState = RoomNotificationSettingsStateLoading | RoomNotificationSettingsStateError | RoomNotificationSettingsStateSuccess;
-declare type RoomProviderProps<TPresence extends JsonObject, TStorage extends LsonObject> = Resolve<{
-    /**
-     * The id of the room you want to connect to
-     */
-    id: string;
-    children: React.ReactNode;
-    /**
-     * Whether or not the room should connect to Liveblocks servers
-     * when the RoomProvider is rendered.
-     *
-     * By default equals to `typeof window !== "undefined"`,
-     * meaning the RoomProvider tries to connect to Liveblocks servers
-     * only on the client side.
-     */
-    autoConnect?: boolean;
-    /** @deprecated Renamed to `autoConnect` */
-    shouldInitiallyConnect?: boolean;
-    /**
-     * If you're on React 17 or lower, pass in a reference to
-     * `ReactDOM.unstable_batchedUpdates` or
-     * `ReactNative.unstable_batchedUpdates` here.
-     *
-     * @example
-     * import { unstable_batchedUpdates } from "react-dom";
-     *
-     * <RoomProvider ... unstable_batchedUpdates={unstable_batchedUpdates} />
-     *
-     * This will prevent you from running into the so-called "stale props"
-     * and/or "zombie child" problem that React 17 and lower can suffer from.
-     * Not necessary when you're on React v18 or later.
-     */
-    unstable_batchedUpdates?: (cb: () => void) => void;
-} & RoomInitializers<TPresence, TStorage>>;
-/**
- * For any function type, returns a similar function type, but without the
- * first argument.
- */
-declare type OmitFirstArg<F> = F extends (first: any, ...rest: infer A) => infer R ? (...args: A) => R : never;
-declare type MutationContext<TPresence extends JsonObject, TStorage extends LsonObject, TUserMeta extends BaseUserMeta> = {
-    storage: LiveObject<TStorage>;
-    self: User<TPresence, TUserMeta>;
-    others: readonly User<TPresence, TUserMeta>[];
-    setMyPresence: (patch: Partial<TPresence>, options?: {
-        addToHistory: boolean;
-    }) => void;
-};
-declare type ThreadSubscription = {
-    status: "not-subscribed";
-    unreadSince?: never;
-} | {
-    status: "subscribed";
-    unreadSince: null;
-} | {
-    status: "subscribed";
-    unreadSince: Date;
-};
-declare type SharedContextBundle<TUserMeta extends BaseUserMeta> = {
-    /**
-     * @beta
-     *
-     * Returns user info from a given user ID.
-     *
-     * @example
-     * const { user, error, isLoading } = useUser("user-id");
-     */
-    useUser(userId: string): UserState<TUserMeta["info"]>;
-    /**
-     * @private
-     *
-     * Returns room info from a given room ID.
-     *
-     * @example
-     * const { info, error, isLoading } = useRoomInfo("room-id");
-     */
-    useRoomInfo(roomId: string): RoomInfoState;
-    suspense: {
-        /**
-         * @beta
-         *
-         * Returns user info from a given user ID.
-         *
-         * @example
-         * const { user } = useUser("user-id");
-         */
-        useUser(userId: string): UserStateSuccess<TUserMeta["info"]>;
-        /**
-         * @private
-         *
-         * Returns room info from a given room ID.
-         *
-         * @example
-         * const { info } = useRoomInfo("room-id");
-         */
-        useRoomInfo(roomId: string): RoomInfoStateSuccess;
-    };
-};
-/**
- * Properties that are the same in RoomContext and RoomContext["suspense"].
- */
-declare type RoomContextBundleCommon<TPresence extends JsonObject, TStorage extends LsonObject, TUserMeta extends BaseUserMeta, TRoomEvent extends Json, TThreadMetadata extends BaseMetadata> = {
-    /**
-     * You normally don't need to directly interact with the RoomContext, but
-     * it can be necessary if you're building an advanced app where you need to
-     * set up a context bridge between two React renderers.
-     */
-    RoomContext: React.Context<Room<TPresence, TStorage, TUserMeta, TRoomEvent> | null>;
-    /**
-     * Makes a Room available in the component hierarchy below.
-     * Joins the room when the component is mounted, and automatically leaves
-     * the room when the component is unmounted.
-     */
-    RoomProvider(props: RoomProviderProps<TPresence, TStorage>): JSX.Element;
-    /**
-     * Returns the Room of the nearest RoomProvider above in the React component
-     * tree.
-     */
-    useRoom(): Room<TPresence, TStorage, TUserMeta, TRoomEvent>;
-    /**
-     * Returns the current connection status for the Room, and triggers
-     * a re-render whenever it changes. Can be used to render a status badge.
-     */
-    useStatus(): Status;
-    /**
-     * Returns a function that batches modifications made during the given function.
-     * All the modifications are sent to other clients in a single message.
-     * All the modifications are merged in a single history item (undo/redo).
-     * All the subscribers are called only after the batch is over.
-     */
-    useBatch<T>(): (callback: () => T) => T;
-    /**
-     * Returns a callback that lets you broadcast custom events to other users in the room
-     *
-     * @example
-     * const broadcast = useBroadcastEvent();
-     *
-     * broadcast({ type: "CUSTOM_EVENT", data: { x: 0, y: 0 } });
-     */
-    useBroadcastEvent(): (event: TRoomEvent, options?: BroadcastOptions) => void;
-    /**
-     * Get informed when users enter or leave the room, as an event.
-     *
-     * @example
-     * useOthersListener({ type, user, others }) => {
-     *   if (type === 'enter') {
-     *     // `user` has joined the room
-     *   } else if (type === 'leave') {
-     *     // `user` has left the room
-     *   }
-     * })
-     */
-    useOthersListener(callback: (event: OthersEvent<TPresence, TUserMeta>) => void): void;
-    /**
-     * Get informed when reconnecting to the Liveblocks servers is taking
-     * longer than usual. This typically is a sign of a client that has lost
-     * internet connectivity.
-     *
-     * This isn't problematic (because the Liveblocks client is still trying to
-     * reconnect), but it's typically a good idea to inform users about it if
-     * the connection takes too long to recover.
-     *
-     * @example
-     * useLostConnectionListener(event => {
-     *   if (event === 'lost') {
-     *     toast.warn('Reconnecting to the Liveblocks servers is taking longer than usual...')
-     *   } else if (event === 'failed') {
-     *     toast.warn('Reconnecting to the Liveblocks servers failed.')
-     *   } else if (event === 'restored') {
-     *     toast.clear();
-     *   }
-     * })
-     */
-    useLostConnectionListener(callback: (event: LostConnectionEvent) => void): void;
-    /**
-     * useErrorListener is a React hook that allows you to respond to potential room
-     * connection errors.
-     *
-     * @example
-     * useErrorListener(er => {
-     *   console.error(er);
-     * })
-     */
-    useErrorListener(callback: (err: LiveblocksError) => void): void;
-    /**
-     * useEventListener is a React hook that allows you to respond to events broadcast
-     * by other users in the room.
-     *
-     * @example
-     * useEventListener(({ connectionId, event }) => {
-     *   if (event.type === "CUSTOM_EVENT") {
-     *     // Do something
-     *   }
-     * });
-     */
-    useEventListener(callback: (data: RoomEventMessage<TPresence, TUserMeta, TRoomEvent>) => void): void;
-    /**
-     * Returns the room.history
-     */
-    useHistory(): History;
-    /**
-     * Returns a function that undoes the last operation executed by the current client.
-     * It does not impact operations made by other clients.
-     */
-    useUndo(): () => void;
-    /**
-     * Returns a function that redoes the last operation executed by the current client.
-     * It does not impact operations made by other clients.
-     */
-    useRedo(): () => void;
-    /**
-     * Returns whether there are any operations to undo.
-     */
-    useCanUndo(): boolean;
-    /**
-     * Returns whether there are any operations to redo.
-     */
-    useCanRedo(): boolean;
-    /**
-     * Returns the mutable (!) Storage root. This hook exists for
-     * backward-compatible reasons.
-     *
-     * @example
-     * const [root] = useStorageRoot();
-     */
-    useStorageRoot(): [root: LiveObject<TStorage> | null];
-    /**
-     * Returns the presence of the current user of the current room, and a function to update it.
-     * It is different from the setState function returned by the useState hook from React.
-     * You don't need to pass the full presence object to update it.
-     *
-     * @example
-     * const [myPresence, updateMyPresence] = useMyPresence();
-     * updateMyPresence({ x: 0 });
-     * updateMyPresence({ y: 0 });
-     *
-     * // At the next render, "myPresence" will be equal to "{ x: 0, y: 0 }"
-     */
-    useMyPresence(): [
-        TPresence,
-        (patch: Partial<TPresence>, options?: {
-            addToHistory: boolean;
-        }) => void
-    ];
-    /**
-     * useUpdateMyPresence is similar to useMyPresence but it only returns the function to update the current user presence.
-     * If you don't use the current user presence in your component, but you need to update it (e.g. live cursor), it's better to use useUpdateMyPresence to avoid unnecessary renders.
-     *
-     * @example
-     * const updateMyPresence = useUpdateMyPresence();
-     * updateMyPresence({ x: 0 });
-     * updateMyPresence({ y: 0 });
-     *
-     * // At the next render, the presence of the current user will be equal to "{ x: 0, y: 0 }"
-     */
-    useUpdateMyPresence(): (patch: Partial<TPresence>, options?: {
-        addToHistory: boolean;
-    }) => void;
-    /**
-     * Create a callback function that lets you mutate Liveblocks state.
-     *
-     * The first argument that gets passed into your callback will be
-     * a "mutation context", which exposes the following:
-     *
-     *   - `root` - The mutable Storage root.
-     *              You can normal mutation on Live structures with this, for
-     *              example: root.get('layers').get('layer1').set('fill',
-     *              'red')
-     *
-     *   - `setMyPresence` - Call this with a new (partial) Presence value.
-     *
-     *   - `self` - A read-only version of the latest self, if you need it to
-     *              compute the next state.
-     *
-     *   - `others` - A read-only version of the latest others list, if you
-     *                need it to compute the next state.
-     *
-     * useMutation is like React's useCallback, except that the first argument
-     * that gets passed into your callback will be a "mutation context".
-     *
-     * If you want get access to the immutable root somewhere in your mutation,
-     * you can use `root.ToImmutable()`.
-     *
-     * @example
-     * const fillLayers = useMutation(
-     *   ({ root }, color: Color) => {
-     *     ...
-     *   },
-     *   [],
-     * );
-     *
-     * fillLayers('red');
-     *
-     * const deleteLayers = useMutation(
-     *   ({ root }) => {
-     *     ...
-     *   },
-     *   [],
-     * );
-     *
-     * deleteLayers();
-     */
-    useMutation<F extends (context: MutationContext<TPresence, TStorage, TUserMeta>, ...args: any[]) => any>(callback: F, deps: readonly unknown[]): OmitFirstArg<F>;
-    /**
-     * Returns an object that lets you get information about all the users
-     * currently connected in the room.
-     *
-     * @example
-     * const others = useOthers();
-     *
-     * // Example to map all cursors in JSX
-     * return (
-     *   <>
-     *     {others.map((user) => {
-     *        if (user.presence.cursor == null) {
-     *          return null;
-     *        }
-     *        return <Cursor key={user.connectionId} cursor={user.presence.cursor} />
-     *      })}
-     *   </>
-     * )
-     */
-    useOthers(): readonly User<TPresence, TUserMeta>[];
-    /**
-     * Extract arbitrary data based on all the users currently connected in the
-     * room (except yourself).
-     *
-     * The selector function will get re-evaluated any time a user enters or
-     * leaves the room, as well as whenever their presence data changes.
-     *
-     * The component that uses this hook will automatically re-render if your
-     * selector function returns a different value from its previous run.
-     *
-     * By default `useOthers()` uses strict `===` to check for equality. Take
-     * extra care when returning a computed object or list, for example when you
-     * return the result of a .map() or .filter() call from the selector. In
-     * those cases, you'll probably want to use a `shallow` comparison check.
-     *
-     * @example
-     * const avatars = useOthers(users => users.map(u => u.info.avatar), shallow);
-     * const cursors = useOthers(users => users.map(u => u.presence.cursor), shallow);
-     * const someoneIsTyping = useOthers(users => users.some(u => u.presence.isTyping));
-     *
-     */
-    useOthers<T>(selector: (others: readonly User<TPresence, TUserMeta>[]) => T, isEqual?: (prev: T, curr: T) => boolean): T;
-    /**
-     * Returns an array of connection IDs. This matches the values you'll get by
-     * using the `useOthers()` hook.
-     *
-     * Roughly equivalent to:
-     *   useOthers((others) => others.map(other => other.connectionId), shallow)
-     *
-     * This is useful in particular to implement efficiently rendering components
-     * for each user in the room, e.g. cursors.
-     *
-     * @example
-     * const ids = useOthersConnectionIds();
-     * // [2, 4, 7]
-     */
-    useOthersConnectionIds(): readonly number[];
-    /**
-     * Related to useOthers(), but optimized for selecting only "subsets" of
-     * others. This is useful for performance reasons in particular, because
-     * selecting only a subset of users also means limiting the number of
-     * re-renders that will be triggered.
-     *
-     * @example
-     * const avatars = useOthersMapped(user => user.info.avatar);
-     * //    ^^^^^^^
-     * //    { connectionId: number; data: string }[]
-     *
-     * The selector function you pass to useOthersMapped() is called an "item
-     * selector", and operates on a single user at a time. If you provide an
-     * (optional) "item comparison" function, it will be used to compare each
-     * item pairwise.
-     *
-     * For example, to select multiple properties:
-     *
-     * @example
-     * const avatarsAndCursors = useOthersMapped(
-     *   user => [u.info.avatar, u.presence.cursor],
-     *   shallow,  // 👈
-     * );
-     */
-    useOthersMapped<T>(itemSelector: (other: User<TPresence, TUserMeta>) => T, itemIsEqual?: (prev: T, curr: T) => boolean): ReadonlyArray<readonly [connectionId: number, data: T]>;
-    /**
-     * Given a connection ID (as obtained by using `useOthersConnectionIds`), you
-     * can call this selector deep down in your component stack to only have the
-     * component re-render if properties for this particular user change.
-     *
-     * @example
-     * // Returns only the selected values re-renders whenever that selection changes)
-     * const { x, y } = useOther(2, user => user.presence.cursor);
-     */
-    useOther<T>(connectionId: number, selector: (other: User<TPresence, TUserMeta>) => T, isEqual?: (prev: T, curr: T) => boolean): T;
-    /**
-     * @beta
-     *
-     * Returns a function that creates a thread with an initial comment, and optionally some metadata.
-     *
-     * @example
-     * const createThread = useCreateThread();
-     * createThread({ body: {}, metadata: {} });
-     */
-    useCreateThread(): (options: CreateThreadOptions<TThreadMetadata>) => ThreadData<TThreadMetadata>;
-    /**
-     * @beta
-     *
-     * Returns a function that edits a thread's metadata.
-     * To delete an existing metadata property, set its value to `null`.
-     *
-     * @example
-     * const editThreadMetadata = useEditThreadMetadata();
-     * editThreadMetadata({ threadId: "th_xxx", metadata: {} })
-     */
-    useEditThreadMetadata(): (options: EditThreadMetadataOptions<TThreadMetadata>) => void;
-    /**
-     * @beta
-     *
-     * Returns a function that adds a comment to a thread.
-     *
-     * @example
-     * const createComment = useCreateComment();
-     * createComment({ threadId: "th_xxx", body: {} });
-     */
-    useCreateComment(): (options: CreateCommentOptions) => CommentData;
-    /**
-     * @beta
-     *
-     * Returns a function that edits a comment's body.
-     *
-     * @example
-     * const editComment = useEditComment()
-     * editComment({ threadId: "th_xxx", commentId: "cm_xxx", body: {} })
-     */
-    useEditComment(): (options: EditCommentOptions) => void;
-    /**
-     * @beta
-     *
-     * Returns a function that deletes a comment.
-     * If it is the last non-deleted comment, the thread also gets deleted.
-     *
-     * @example
-     * const deleteComment = useDeleteComment();
-     * deleteComment({ threadId: "th_xxx", commentId: "cm_xxx" })
-     */
-    useDeleteComment(): (options: DeleteCommentOptions) => void;
-    /**
-     * @beta
-     *
-     * Returns a function that adds a reaction from a comment.
-     *
-     * @example
-     * const addReaction = useAddReaction();
-     * addReaction({ threadId: "th_xxx", commentId: "cm_xxx", emoji: "👍" })
-     */
-    useAddReaction(): (options: CommentReactionOptions) => void;
-    /**
-     * @beta
-     *
-     * Returns a function that removes a reaction on a comment.
-     *
-     * @example
-     * const removeReaction = useRemoveReaction();
-     * removeReaction({ threadId: "th_xxx", commentId: "cm_xxx", emoji: "👍" })
-     */
-    useRemoveReaction(): (options: CommentReactionOptions) => void;
-    /**
-     * @beta
-     *
-     * Returns a function that updates the user's notification settings
-     * for the current room.
-     *
-     * @example
-     * const updateRoomNotificationSettings = useUpdateRoomNotificationSettings();
-     * updateRoomNotificationSettings({ threads: "all" });
-     */
-    useUpdateRoomNotificationSettings(): (settings: Partial<RoomNotificationSettings>) => void;
-    /**
-     * @beta
-     *
-     * Returns a function that marks a thread as read.
-     *
-     * @example
-     * const markThreadAsRead = useMarkThreadAsRead();
-     * markThreadAsRead("th_xxx");
-     */
-    useMarkThreadAsRead(): (threadId: string) => void;
-    /**
-     * @beta
-     *
-     * Returns the subscription status of a thread.
-     *
-     * @example
-     * const { status, unreadSince } = useThreadSubscription("th_xxx");
-     */
-    useThreadSubscription(threadId: string): ThreadSubscription;
-};
-/**
- * @private
- *
- * Private methods and variables used in the core internals, but as a user
- * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
- * will probably happen if you do.
- */
-declare type PrivateRoomContextApi = {
-    hasResolveMentionSuggestions: boolean;
-    useMentionSuggestions(search?: string): string[] | undefined;
-    useCurrentUserId(): string | null;
-};
-declare type RoomContextBundle<TPresence extends JsonObject, TStorage extends LsonObject, TUserMeta extends BaseUserMeta, TRoomEvent extends Json, TThreadMetadata extends BaseMetadata> = Resolve<RoomContextBundleCommon<TPresence, TStorage, TUserMeta, TRoomEvent, TThreadMetadata> & Omit<SharedContextBundle<TUserMeta>, "suspense"> & {
-    /**
-     * Extract arbitrary data from the Liveblocks Storage state, using an
-     * arbitrary selector function.
-     *
-     * The selector function will get re-evaluated any time something changes in
-     * Storage. The value returned by your selector function will also be the
-     * value returned by the hook.
-     *
-     * The `root` value that gets passed to your selector function is
-     * a immutable/readonly version of your Liveblocks storage root.
-     *
-     * The component that uses this hook will automatically re-render if the
-     * returned value changes.
-     *
-     * By default `useStorage()` uses strict `===` to check for equality. Take
-     * extra care when returning a computed object or list, for example when you
-     * return the result of a .map() or .filter() call from the selector. In
-     * those cases, you'll probably want to use a `shallow` comparison check.
-     */
-    useStorage<T>(selector: (root: ToImmutable<TStorage>) => T, isEqual?: (prev: T | null, curr: T | null) => boolean): T | null;
-    /**
-     * Gets the current user once it is connected to the room.
-     *
-     * @example
-     * const me = useSelf();
-     * const { x, y } = me.presence.cursor;
-     */
-    useSelf(): User<TPresence, TUserMeta> | null;
-    /**
-     * Extract arbitrary data based on the current user.
-     *
-     * The selector function will get re-evaluated any time your presence data
-     * changes.
-     *
-     * The component that uses this hook will automatically re-render if your
-     * selector function returns a different value from its previous run.
-     *
-     * By default `useSelf()` uses strict `===` to check for equality. Take extra
-     * care when returning a computed object or list, for example when you return
-     * the result of a .map() or .filter() call from the selector. In those
-     * cases, you'll probably want to use a `shallow` comparison check.
-     *
-     * Will return `null` while Liveblocks isn't connected to a room yet.
-     *
-     * @example
-     * const cursor = useSelf(me => me.presence.cursor);
-     * if (cursor !== null) {
-     *   const { x, y } = cursor;
-     * }
-     *
-     */
-    useSelf<T>(selector: (me: User<TPresence, TUserMeta>) => T, isEqual?: (prev: T, curr: T) => boolean): T | null;
-    /**
-     * @beta
-     *
-     * Returns the threads within the current room.
-     *
-     * @example
-     * const { threads, error, isLoading } = useThreads();
-     */
-    useThreads(options?: UseThreadsOptions<TThreadMetadata>): ThreadsState<TThreadMetadata>;
-    /**
-     * @beta
-     *
-     * Returns the user's notification settings for the current room
-     * and a function to update them.
-     *
-     * @example
-     * const [{ settings }, updateSettings] = useRoomNotificationSettings();
-     */
-    useRoomNotificationSettings(): [
-        RoomNotificationSettingsState,
-        (settings: Partial<RoomNotificationSettings>) => void
-    ];
-    /**
-     * Returns the LiveList associated with the provided key. The hook triggers
-     * a re-render if the LiveList is updated, however it does not triggers
-     * a re-render if a nested CRDT is updated.
-     *
-     * @param key The top-level storage key associated with the LiveList
-     * @returns null while storage is still loading, otherwise, returns the LiveList instance at the storage key
-     *
-     * @example
-     * const animals = useList("animals");  // e.g. [] or ["🦁", "🐍", "🦍"]  // ❌ No longer recommended
-     * const animals = useStorage((root) => root.animals);                    // ✅ Do this instead
-     *
-     * @deprecated We no longer recommend using `useList`. Prefer `useStorage`
-     * for reading and `useMutation` for writing.
-     */
-    useList<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey] | null;
-    /**
-     * Returns the LiveMap associated with the provided key. If the LiveMap
-     * does not exist, a new empty LiveMap will be created. The hook triggers
-     * a re-render if the LiveMap is updated, however it does not triggers
-     * a re-render if a nested CRDT is updated.
-     *
-     * @param key The top-level storage key associated with the LiveMap
-     * @returns null while storage is still loading, otherwise, returns the LiveMap instance at the storage key
-     *
-     * @example
-     * const shapesById = useMap("shapes");                   // ❌ No longer recommended
-     * const shapesById = useStorage((root) => root.shapes);  // ✅ Do this instead
-     *
-     * @deprecated We no longer recommend using `useMap`. Prefer `useStorage`
-     * for reading and `useMutation` for writing.
-     */
-    useMap<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey] | null;
-    /**
-     * Returns the LiveObject associated with the provided key.
-     * The hook triggers a re-render if the LiveObject is updated, however it does not triggers a re-render if a nested CRDT is updated.
-     *
-     * @param key The top-level storage key associated with the LiveObject
-     * @returns null while storage is still loading, otherwise, returns the LiveObject instance at the storage key
-     *
-     * @example
-     * const object = useObject("obj");                // ❌ No longer recommended
-     * const object = useStorage((root) => root.obj);  // ✅ Do this instead
-     *
-     * @deprecated We no longer recommend using `useObject`. Prefer `useStorage`
-     * for reading and `useMutation` for writing.
-     */
-    useObject<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey] | null;
-    suspense: Resolve<RoomContextBundleCommon<TPresence, TStorage, TUserMeta, TRoomEvent, TThreadMetadata> & SharedContextBundle<TUserMeta>["suspense"] & {
-        /**
-         * Extract arbitrary data from the Liveblocks Storage state, using an
-         * arbitrary selector function.
-         *
-         * The selector function will get re-evaluated any time something changes in
-         * Storage. The value returned by your selector function will also be the
-         * value returned by the hook.
-         *
-         * The `root` value that gets passed to your selector function is
-         * a immutable/readonly version of your Liveblocks storage root.
-         *
-         * The component that uses this hook will automatically re-render if the
-         * returned value changes.
-         *
-         * By default `useStorage()` uses strict `===` to check for equality. Take
-         * extra care when returning a computed object or list, for example when you
-         * return the result of a .map() or .filter() call from the selector. In
-         * those cases, you'll probably want to use a `shallow` comparison check.
-         */
-        useStorage<T>(selector: (root: ToImmutable<TStorage>) => T, isEqual?: (prev: T, curr: T) => boolean): T;
-        /**
-         * Gets the current user once it is connected to the room.
-         *
-         * @example
-         * const me = useSelf();
-         * const { x, y } = me.presence.cursor;
-         */
-        useSelf(): User<TPresence, TUserMeta>;
-        /**
-         * Extract arbitrary data based on the current user.
-         *
-         * The selector function will get re-evaluated any time your presence data
-         * changes.
-         *
-         * The component that uses this hook will automatically re-render if your
-         * selector function returns a different value from its previous run.
-         *
-         * By default `useSelf()` uses strict `===` to check for equality. Take extra
-         * care when returning a computed object or list, for example when you return
-         * the result of a .map() or .filter() call from the selector. In those
-         * cases, you'll probably want to use a `shallow` comparison check.
-         *
-         * Will return `null` while Liveblocks isn't connected to a room yet.
-         *
-         * @example
-         * const cursor = useSelf(me => me.presence.cursor);
-         * if (cursor !== null) {
-         *   const { x, y } = cursor;
-         * }
-         *
-         */
-        useSelf<T>(selector: (me: User<TPresence, TUserMeta>) => T, isEqual?: (prev: T, curr: T) => boolean): T;
-        /**
-         * @beta
-         *
-         * Returns the threads within the current room.
-         *
-         * @example
-         * const { threads } = useThreads();
-         */
-        useThreads(options?: UseThreadsOptions<TThreadMetadata>): ThreadsStateSuccess<TThreadMetadata>;
-        /**
-         * @beta
-         *
-         * Returns the user's notification settings for the current room
-         * and a function to update them.
-         *
-         * @example
-         * const [{ settings }, updateSettings] = useRoomNotificationSettings();
-         */
-        useRoomNotificationSettings(): [
-            RoomNotificationSettingsStateSuccess,
-            (settings: Partial<RoomNotificationSettings>) => void
-        ];
-        /**
-         * Returns the LiveList associated with the provided key. The hook triggers
-         * a re-render if the LiveList is updated, however it does not triggers
-         * a re-render if a nested CRDT is updated.
-         *
-         * @param key The top-level storage key associated with the LiveList
-         * @returns Returns the LiveList instance at the storage key
-         *
-         * @example
-         * const animals = useList("animals");  // e.g. [] or ["🦁", "🐍", "🦍"]  // ❌ No longer recommended
-         * const animals = useStorage((root) => root.animals);                    // ✅ Do this instead
-         *
-         * @deprecated We no longer recommend using `useList`. Prefer `useStorage`
-         * for reading and `useMutation` for writing.
-         */
-        useList<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey];
-        /**
-         * Returns the LiveMap associated with the provided key. If the LiveMap
-         * does not exist, a new empty LiveMap will be created. The hook triggers
-         * a re-render if the LiveMap is updated, however it does not triggers
-         * a re-render if a nested CRDT is updated.
-         *
-         * @param key The top-level storage key associated with the LiveMap
-         * @returns Returns the LiveMap instance at the storage key
-         *
-         * @example
-         * const shapesById = useMap("shapes");                   // ❌ No longer recommended
-         * const shapesById = useStorage((root) => root.shapes);  // ✅ Do this instead
-         *
-         * @deprecated We no longer recommend using `useMap`. Prefer `useStorage`
-         * for reading and `useMutation` for writing.
-         */
-        useMap<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey];
-        /**
-         * Returns the LiveObject associated with the provided key.
-         * The hook triggers a re-render if the LiveObject is updated, however it does not triggers a re-render if a nested CRDT is updated.
-         *
-         * @param key The top-level storage key associated with the LiveObject
-         * @returns Returns the LiveObject instance at the storage key
-         *
-         * @example
-         * const object = useObject("obj");                // ❌ No longer recommended
-         * const object = useStorage((root) => root.obj);  // ✅ Do this instead
-         *
-         * @deprecated We no longer recommend using `useObject`. Prefer `useStorage`
-         * for reading and `useMutation` for writing.
-         */
-        useObject<TKey extends Extract<keyof TStorage, string>>(key: TKey): TStorage[TKey];
-    }>;
-}> & {
-    /**
-     * @private
-     *
-     * Private methods and variables used in the core internals, but as a user
-     * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
-     * will probably happen if you do.
-     */
-    readonly [kInternal]: PrivateRoomContextApi;
-};
-/**
- * Properties that are the same in LiveblocksContext and LiveblocksContext["suspense"].
- */
-declare type LiveblocksContextBundleCommon<TThreadMetadata extends BaseMetadata> = {
-    /**
-     * @beta
-     *
-     * Makes Liveblocks features outside of rooms (e.g. Notifications) available
-     * in the component hierarchy below.
-     */
-    LiveblocksProvider(props: PropsWithChildren): JSX.Element;
-    /**
-     * @beta
-     *
-     * Returns a function that marks an inbox notification as read.
-     *
-     * @example
-     * const markInboxNotificationAsRead = useMarkInboxNotificationAsRead();
-     * markInboxNotificationAsRead("in_xxx");
-     */
-    useMarkInboxNotificationAsRead(): (inboxNotificationId: string) => void;
-    /**
-     * @beta
-     *
-     * Returns a function that marks all inbox notifications as read.
-     *
-     * @example
-     * const markAllInboxNotificationsAsRead = useMarkAllInboxNotificationsAsRead();
-     * markAllInboxNotificationsAsRead();
-     */
-    useMarkAllInboxNotificationsAsRead(): () => void;
-    /**
-     * @beta
-     *
-     * Returns the thread associated with a `"thread"` inbox notification.
-     *
-     * @example
-     * const thread = useInboxNotificationThread("in_xxx");
-     */
-    useInboxNotificationThread(inboxNotificationId: string): ThreadData<TThreadMetadata>;
-};
-/**
- * @private
- *
- * Private methods and variables used in the core internals, but as a user
- * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
- * will probably happen if you do.
- */
-declare type PrivateLiveblocksContextApi = {
-    /**
-     * @private
-     *
-     * Returns the current user ID. Can only be used after making a call to a Notifications API.
-     */
-    useCurrentUserId(): string | null;
-};
-declare type LiveblocksContextBundle<TUserMeta extends BaseUserMeta, TThreadMetadata extends BaseMetadata> = Resolve<LiveblocksContextBundleCommon<TThreadMetadata> & Omit<SharedContextBundle<TUserMeta>, "suspense"> & {
-    /**
-     * @beta
-     *
-     * Returns the inbox notifications for the current user.
-     *
-     * @example
-     * const { inboxNotifications, error, isLoading } = useInboxNotifications();
-     */
-    useInboxNotifications(): InboxNotificationsState;
-    /**
-     * @beta
-     *
-     * Returns the number of unread inbox notifications for the current user.
-     *
-     * @example
-     * const { count, error, isLoading } = useUnreadInboxNotificationsCount();
-     */
-    useUnreadInboxNotificationsCount(): UnreadInboxNotificationsCountState;
-    suspense: Resolve<LiveblocksContextBundleCommon<TThreadMetadata> & SharedContextBundle<TUserMeta>["suspense"] & {
-        /**
-         * @beta
-         *
-         * Returns the inbox notifications for the current user.
-         *
-         * @example
-         * const { inboxNotifications } = useInboxNotifications();
-         */
-        useInboxNotifications(): InboxNotificationsStateSuccess;
-        /**
-         * @beta
-         *
-         * Returns the number of unread inbox notifications for the current user.
-         *
-         * @example
-         * const { count } = useUnreadInboxNotificationsCount();
-         */
-        useUnreadInboxNotificationsCount(): UnreadInboxNotificationsCountStateSuccess;
-    }>;
-}> & {
-    /**
-     * @private
-     *
-     * Private methods and variables used in the core internals, but as a user
-     * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
-     * will probably happen if you do.
-     */
-    readonly [kInternal]: PrivateLiveblocksContextApi;
-};
-
-/**
- * @private
- *
- * This is an internal API, use "createLiveblocksContext" instead.
- */
-declare function useLiveblocksContextBundle(): LiveblocksContextBundle<BaseUserMeta, BaseMetadata$1>;
-declare function createLiveblocksContext<TUserMeta extends BaseUserMeta = BaseUserMeta, TThreadMetadata extends BaseMetadata$1 = never>(client: Client): LiveblocksContextBundle<TUserMeta, TThreadMetadata>;
-
-/**
- * @private
- *
- * This is an internal API, use `createRoomContext` instead.
- */
-declare function useRoomContextBundle(): RoomContextBundle<JsonObject, LsonObject, BaseUserMeta, never, BaseMetadata>;
-declare type Options<TUserMeta extends BaseUserMeta> = {
-    /**
-     * @deprecated Define 'resolveUsers' in 'createClient' from '@liveblocks/client' instead.
-     * Please refer to our Upgrade Guide to learn more, see https://liveblocks.io/docs/platform/upgrading/1.10.
-     *
-     * A function that returns user info from user IDs.
-     */
-    resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(TUserMeta["info"] | undefined)[] | undefined>;
-    /**
-     * @deprecated Define 'resolveMentionSuggestions' in 'createClient' from '@liveblocks/client' instead.
-     * Please refer to our Upgrade Guide to learn more, see https://liveblocks.io/docs/platform/upgrading/1.10.
-     *
-     * A function that returns a list of user IDs matching a string.
-     */
-    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => OptionalPromise<string[]>;
-};
-declare function createRoomContext<TPresence extends JsonObject, TStorage extends LsonObject = LsonObject, TUserMeta extends BaseUserMeta = BaseUserMeta, TRoomEvent extends Json = never, TThreadMetadata extends BaseMetadata = never>(client: Client, options?: Options<TUserMeta>): RoomContextBundle<TPresence, TStorage, TUserMeta, TRoomEvent, TThreadMetadata>;
-
-/**
- * @private
- *
- * This is an internal API, use `createLiveblocksContext` or `createRoomContext` instead.
- */
-declare function useSharedContextBundle(): RoomContextBundle<_liveblocks_core.JsonObject, _liveblocks_core.LsonObject, BaseUserMeta$1, never, _liveblocks_core.BaseMetadata> | LiveblocksContextBundle<BaseUserMeta$1, _liveblocks_core.BaseMetadata>;
-
-export { ClientSideSuspense, type MutationContext, type UseThreadsOptions, createLiveblocksContext, createRoomContext, useLiveblocksContextBundle, useRoomContextBundle, useSharedContextBundle };
+import 'react';
+import '@liveblocks/core';