@pluv/react 5.0.0 → 5.0.2

package/CHANGELOG.md

@@ -1,2505 +0,0 @@
-# @pluv/react
-
-## 5.0.0
-
-### Patch Changes
-
-- @pluv/client@5.0.0
-- @pluv/crdt@5.0.0
-- @pluv/types@5.0.0
-
-## 4.1.0
-
-### Patch Changes
-
-- @pluv/client@4.1.0
-- @pluv/crdt@4.1.0
-- @pluv/types@4.1.0
-
-## 4.0.2
-
-### Patch Changes
-
-- e1913b3: Upgraded internal dependencies
-- Updated dependencies [e1913b3]
-    - @pluv/client@4.0.2
-    - @pluv/types@4.0.2
-    - @pluv/crdt@4.0.2
-
-## 4.0.1
-
-### Patch Changes
-
-- @pluv/client@4.0.1
-- @pluv/crdt@4.0.1
-- @pluv/types@4.0.1
-
-## 4.0.0
-
-### Major Changes
-
-- df5c39c: Update all packages to be ESM only.
-
-### Minor Changes
-
-- 037074e: Migrated build process from tsup to tsdown.
-
-### Patch Changes
-
-- 2eb5def: Bumped dependencies.
-- Updated dependencies [2eb5def]
-- Updated dependencies [df5c39c]
-- Updated dependencies [037074e]
-    - @pluv/client@4.0.0
-    - @pluv/types@4.0.0
-    - @pluv/crdt@4.0.0
-
-## 3.2.2
-
-### Patch Changes
-
-- Updated dependencies [8665dbe]
-    - @pluv/client@3.2.2
-    - @pluv/types@3.2.2
-    - @pluv/crdt@3.2.2
-
-## 3.2.1
-
-### Patch Changes
-
-- Updated dependencies [1e0c886]
-    - @pluv/client@3.2.1
-    - @pluv/crdt@3.2.1
-    - @pluv/types@3.2.1
-
-## 3.2.0
-
-### Patch Changes
-
-- @pluv/client@3.2.0
-- @pluv/crdt@3.2.0
-- @pluv/types@3.2.0
-
-## 3.1.7
-
-### Patch Changes
-
-- @pluv/client@3.1.7
-- @pluv/crdt@3.1.7
-- @pluv/types@3.1.7
-
-## 3.1.6
-
-### Patch Changes
-
-- fd8d314: Fix creating excessive storage subscriptions.
-    - @pluv/client@3.1.6
-    - @pluv/crdt@3.1.6
-    - @pluv/types@3.1.6
-
-## 3.1.5
-
-### Patch Changes
-
-- @pluv/client@3.1.5
-- @pluv/crdt@3.1.5
-- @pluv/types@3.1.5
-
-## 3.1.4
-
-### Patch Changes
-
-- Updated dependencies [e443b66]
-    - @pluv/client@3.1.4
-    - @pluv/crdt@3.1.4
-    - @pluv/types@3.1.4
-
-## 3.1.3
-
-### Patch Changes
-
-- @pluv/client@3.1.3
-- @pluv/crdt@3.1.3
-- @pluv/types@3.1.3
-
-## 3.1.2
-
-### Patch Changes
-
-- @pluv/client@3.1.2
-- @pluv/crdt@3.1.2
-- @pluv/types@3.1.2
-
-## 3.1.1
-
-### Patch Changes
-
-- @pluv/client@3.1.1
-- @pluv/crdt@3.1.1
-- @pluv/types@3.1.1
-
-## 3.1.0
-
-### Patch Changes
-
-- Updated dependencies [022857d]
-    - @pluv/client@3.1.0
-    - @pluv/crdt@3.1.0
-    - @pluv/types@3.1.0
-
-## 3.0.0
-
-### Patch Changes
-
-- Updated dependencies [bc1ae91]
-    - @pluv/client@3.0.0
-    - @pluv/crdt@3.0.0
-    - @pluv/types@3.0.0
-
-## 2.3.1
-
-### Patch Changes
-
-- @pluv/client@2.3.1
-- @pluv/crdt@2.3.1
-- @pluv/types@2.3.1
-
-## 2.3.0
-
-### Patch Changes
-
-- @pluv/client@2.3.0
-- @pluv/crdt@2.3.0
-- @pluv/types@2.3.0
-
-## 2.2.8
-
-### Patch Changes
-
-- @pluv/client@2.2.8
-- @pluv/crdt@2.2.8
-- @pluv/types@2.2.8
-
-## 2.2.7
-
-### Patch Changes
-
-- @pluv/client@2.2.7
-- @pluv/crdt@2.2.7
-- @pluv/types@2.2.7
-
-## 2.2.6
-
-### Patch Changes
-
-- @pluv/client@2.2.6
-- @pluv/crdt@2.2.6
-- @pluv/types@2.2.6
-
-## 2.2.5
-
-### Patch Changes
-
-- @pluv/client@2.2.5
-- @pluv/crdt@2.2.5
-- @pluv/types@2.2.5
-
-## 2.2.4
-
-### Patch Changes
-
-- @pluv/client@2.2.4
-- @pluv/crdt@2.2.4
-- @pluv/types@2.2.4
-
-## 2.2.3
-
-### Patch Changes
-
-- @pluv/client@2.2.3
-- @pluv/crdt@2.2.3
-- @pluv/types@2.2.3
-
-## 2.2.2
-
-### Patch Changes
-
-- @pluv/client@2.2.2
-- @pluv/crdt@2.2.2
-- @pluv/types@2.2.2
-
-## 2.2.1
-
-### Patch Changes
-
-- @pluv/client@2.2.1
-- @pluv/crdt@2.2.1
-- @pluv/types@2.2.1
-
-## 2.2.0
-
-### Minor Changes
-
-- 3ce1547: Updated typings for `useDoc` to be narrower to get the native doc type.
-
-    ```ts
-    import { createClient } from "@pluv/client";
-    import { yjs } from "@pluv/crdt-yjs";
-    import { createBundle } from "@pluv/react";
-    import type { Doc as YDoc } from "yjs";
-
-    const client = createClient({
-        // ...
-        crdt: yjs,
-    });
-    const { useDoc } = createBundle(client);
-
-    const doc = useDoc();
-
-    // This is now typed as the native YDoc
-    doc.value;
-    //  ^? const value: YDoc
-    ```
-
-- b999c1c: Added a new type `InferBundleRoom` to get the type of the `PluvRoom` from the react bundle that is created.
-
-    ```ts
-    import { createClient } from "@pluv/client";
-    import type { InferBundleRoom } from "@pluv/react";
-    import { createBundle } from "@pluv/react";
-
-    const client = createclient({
-        /* ... */
-    });
-
-    const bundle = createBundle(client);
-
-    type RoomType = InferBundleRoom<typeof bundle>;
-
-    const { useStorage } = bundle;
-    ```
-
-### Patch Changes
-
-- cb660cd: Fixed the room not changing if the room name was changed on the `PluvRoomProvider` without first unmounting the component.
-- 4916c27: Fixed `useConnection` requiring a selector function (this is now optional).
-- 48191fa: Fixed `useDoc` not returning a stable doc reference for a single connection.
-- Updated dependencies [3ce1547]
-- Updated dependencies [fd3bfe2]
-- Updated dependencies [aee40cb]
-- Updated dependencies [edd1789]
-- Updated dependencies [48191fa]
-    - @pluv/client@2.2.0
-    - @pluv/crdt@2.2.0
-    - @pluv/types@2.2.0
-
-## 2.1.0
-
-### Minor Changes
-
-- 8931f7b: Moved `@pluv/client` from `peerDependencies` to `dependencies` due to an unfortunate [changesets design decision](https://github.com/changesets/changesets/issues/1011).
-
-### Patch Changes
-
-- e8d8fbc: Updated the internals of various hooks to use the new `PluvRoom.subscribe` object.
-- Updated dependencies [e8d8fbc]
-- Updated dependencies [a86ff5e]
-- Updated dependencies [d5ac29e]
-- Updated dependencies [5ca5cb6]
-- Updated dependencies [4acbe1e]
-- Updated dependencies [e8d8fbc]
-    - @pluv/client@2.1.0
-    - @pluv/crdt@2.1.0
-    - @pluv/types@2.1.0
-
-## 2.0.2
-
-### Patch Changes
-
-- @pluv/client@2.0.2
-- @pluv/crdt@2.0.2
-- @pluv/types@2.0.2
-
-## 2.0.1
-
-### Patch Changes
-
-- Updated dependencies [1b93b18]
-    - @pluv/client@2.0.1
-    - @pluv/crdt@2.0.1
-    - @pluv/types@2.0.1
-
-## 2.0.0
-
-### Minor Changes
-
-- 5cec54a: **Deprecated** Declaring top-level types on your CRDT storage via the `yjs` or `loro` utility (e.g. `yjs.array` or `loro.list`) for the `initialStorage` prop on `PluvRoomProvider` is now deprecated, to be removed in the next major release (v2). Continuing to use the `yjs` or `loro` utilities to declare top-level types will log a warning to your console while in development mode (i.e. when `process.env.NODE_ENV === "development"`). To declare top-level types, you should now use the builder type exposed in the `initialStorage` function. See the example below:
-
-    ```tsx
-    import { yjs } from "@pluv/crdt-yjs";
-
-    // Before
-    <PluvRoomProvider
-        room="example-room"
-        initialStorage={() => ({
-            // Using the `yjs` or `loro` utility (in this case `yjs.map`) when
-            // declaring top-level types is now deprecated
-            topType: yjs.map([
-                ["key1", yjs.text("")],
-                ["key2", yjs.text("")],
-            ]),
-        })}
-    >
-        <div />
-    </PluvRoomProvider>
-
-    // After
-    <PluvRoomProvider
-        room="example-room"
-        initialStorage={(t) => ({
-            // Top-level properties must now use the builder (in this case `t`).
-            // This effectively calls `yjs.getMap("topType")` to instantiate the type on
-            // the root document.
-            // This simply returns the native Yjs shared-types (e.g. Y.Map), which
-            // allows you operate on your yjs shared-typess in a more native way.
-            topType: t.map("topType", [
-                // Declaring nested types should continue to use the `yjs` utilities
-                // you've used before
-                ["key1", yjs.text("")],
-                ["key2", yjs.text("")],
-            ]),
-        })}
-    >
-        <div />
-    </PluvRoomProvider>
-    ```
-
-    The functions on the builder type calls the native yjs shared-type (or loro container type) instantiating methods and returns the native types (e.g. `t.map("topType")` is simply just a `Y.Doc.getMap("topType")`) call under the hood. This allows you to declare your type in a more yjs-native and predictable way, and enables declaring more complex initial storage states if needed.
-
-### Patch Changes
-
-- Updated dependencies [047a1d8]
-- Updated dependencies [0806212]
-- Updated dependencies [3a34dbb]
-    - @pluv/client@2.0.0
-    - @pluv/types@2.0.0
-    - @pluv/crdt@2.0.0
-
-## 1.0.2
-
-### Patch Changes
-
-- Updated dependencies [d87159c]
-    - @pluv/client@1.0.2
-    - @pluv/crdt@1.0.2
-    - @pluv/types@1.0.2
-
-## 1.0.1
-
-### Patch Changes
-
-- Updated dependencies [c583be9]
-    - @pluv/client@1.0.1
-    - @pluv/crdt@1.0.1
-    - @pluv/types@1.0.1
-
-## 1.0.0
-
-### Major Changes
-
-- 4c8b203: **BREAKING** `@pluv/client` is now a peer dependency of `@pluv/react`.
-- af94706: pluv.io is now stable and production ready!
-
-    With this v1 release, pluv.io will now follow [semantic versioning](https://semver.org/) with more comprehensive release notes for future changes to the library.
-
-    Checkout the [full documentation here](https://pluv.io/docs/introduction) to get started today!
-
-### Patch Changes
-
-- Updated dependencies [af94706]
-    - @pluv/client@1.0.0
-    - @pluv/crdt@1.0.0
-    - @pluv/types@1.0.0
-
-## 0.44.2
-
-### Patch Changes
-
-- Updated dependencies [6cfd36f]
-    - @pluv/client@0.44.2
-    - @pluv/crdt@0.44.2
-    - @pluv/types@0.44.2
-
-## 0.44.1
-
-### Patch Changes
-
-- Updated dependencies [67c081d]
-    - @pluv/client@0.44.1
-    - @pluv/crdt@0.44.1
-    - @pluv/types@0.44.1
-
-## 0.44.0
-
-### Patch Changes
-
-- Updated dependencies [fba9354]
-- Updated dependencies [bc2d684]
-- Updated dependencies [c9fcea5]
-    - @pluv/client@0.44.0
-    - @pluv/crdt@0.44.0
-    - @pluv/types@0.44.0
-
-## 0.43.0
-
-### Patch Changes
-
-- Updated dependencies [65d9172]
-    - @pluv/client@0.43.0
-    - @pluv/crdt@0.43.0
-    - @pluv/types@0.43.0
-
-## 0.42.0
-
-### Patch Changes
-
-- Updated dependencies [7ae56bf]
-    - @pluv/client@0.42.0
-    - @pluv/crdt@0.42.0
-    - @pluv/types@0.42.0
-
-## 0.41.7
-
-### Patch Changes
-
-- @pluv/client@0.41.7
-- @pluv/crdt@0.41.7
-- @pluv/types@0.41.7
-
-## 0.41.6
-
-### Patch Changes
-
-- Updated dependencies [71642fa]
-    - @pluv/client@0.41.6
-    - @pluv/crdt@0.41.6
-    - @pluv/types@0.41.6
-
-## 0.41.5
-
-### Patch Changes
-
-- Updated dependencies [b3b7b30]
-    - @pluv/client@0.41.5
-    - @pluv/crdt@0.41.5
-    - @pluv/types@0.41.5
-
-## 0.41.4
-
-### Patch Changes
-
-- @pluv/client@0.41.4
-- @pluv/crdt@0.41.4
-- @pluv/types@0.41.4
-
-## 0.41.3
-
-### Patch Changes
-
-- Updated dependencies [49051c0]
-    - @pluv/client@0.41.3
-    - @pluv/crdt@0.41.3
-    - @pluv/types@0.41.3
-
-## 0.41.2
-
-### Patch Changes
-
-- Updated dependencies [37956d3]
-    - @pluv/client@0.41.2
-    - @pluv/crdt@0.41.2
-    - @pluv/types@0.41.2
-
-## 0.41.1
-
-### Patch Changes
-
-- @pluv/client@0.41.1
-- @pluv/crdt@0.41.1
-- @pluv/types@0.41.1
-
-## 0.41.0
-
-### Patch Changes
-
-- Updated dependencies [41aa439]
-- Updated dependencies [eb2d903]
-- Updated dependencies [555b88d]
-- Updated dependencies [555b88d]
-    - @pluv/client@0.41.0
-    - @pluv/crdt@0.41.0
-    - @pluv/types@0.41.0
-
-## 0.40.2
-
-### Patch Changes
-
-- Updated dependencies [6fbc2fe]
-    - @pluv/client@0.40.2
-    - @pluv/crdt@0.40.2
-    - @pluv/types@0.40.2
-
-## 0.40.1
-
-### Patch Changes
-
-- @pluv/client@0.40.1
-- @pluv/crdt@0.40.1
-- @pluv/types@0.40.1
-
-## 0.40.0
-
-### Patch Changes
-
-- @pluv/client@0.40.0
-- @pluv/crdt@0.40.0
-- @pluv/types@0.40.0
-
-## 0.39.1
-
-### Patch Changes
-
-- 36606b4: Fix `PluvRoomProvider` never connecting when `metadata` is a function.
-    - @pluv/client@0.39.1
-    - @pluv/crdt@0.39.1
-    - @pluv/types@0.39.1
-
-## 0.39.0
-
-### Minor Changes
-
-- ca160f5: **BREAKING** Update the context value of `MockedRoomContext` to mirror the same shape as `PluvRoomContext`. i.e. the value of `MockedRoomContext` is now the room itself, rather than an object containing the room. This should not be breaking in most cases. If you happen to be using `useContext(MockedRoomContext)`, those will need to be updated as shown below:
-
-    ```tsx
-    // Before
-    const { room } = useContext(MockedRoomContext);
-
-    // After
-    const room = useContext(MockedRoomContext);
-    ```
-
-### Patch Changes
-
-- e6ddddc: Fixed potential race conditions between connecting and disconnecting between re-renders of `PluvRoomProvider`.
-- e6ddddc: (Internal) Update how `PluvRoomProvider` handles the `metadata` prop internally to be updated to how `PluvClient` now handles this (i.e. moved to `PluvClient.enter`, from `PluvClient.createRoom`).
-- e6ddddc: Add support for a passing either a function or object for the `metadata` prop on `PluvRoomProvider`. When a function is used, the `metadata` will be gotten at the moment of connection (internally this is a `useEffect`, so browser APIs can be used such as `document`, `window` and `localStorage`).
-
-    ```tsx
-    // Both of these work
-    <PluvRoomProvider metadata={{ hello: "world" }}>
-        {children}
-    </PluvRoomProvider>
-
-    <PluvRoomProvider
-        metadata={() => {
-            const value = localStorage.get(MY_LOCALSTORAGE_KEY);
-
-            return { hello: value };
-        }}
-    >
-        {children}
-    </PluvRoomProvider>
-    ```
-
-- Updated dependencies [e6ddddc]
-- Updated dependencies [e6ddddc]
-- Updated dependencies [2cfb68d]
-- Updated dependencies [e6ddddc]
-    - @pluv/client@0.39.0
-    - @pluv/crdt@0.39.0
-    - @pluv/types@0.39.0
-
-## 0.38.14
-
-### Patch Changes
-
-- Updated dependencies [886a1f9]
-    - @pluv/client@0.38.14
-    - @pluv/crdt@0.38.14
-    - @pluv/types@0.38.14
-
-## 0.38.13
-
-### Patch Changes
-
-- @pluv/client@0.38.13
-- @pluv/crdt@0.38.13
-- @pluv/types@0.38.13
-
-## 0.38.12
-
-### Patch Changes
-
-- Updated dependencies [b617726]
-    - @pluv/client@0.38.12
-    - @pluv/crdt@0.38.12
-    - @pluv/types@0.38.12
-
-## 0.38.11
-
-### Patch Changes
-
-- Updated dependencies [5ac1aba]
-    - @pluv/client@0.38.11
-    - @pluv/crdt@0.38.11
-    - @pluv/types@0.38.11
-
-## 0.38.10
-
-### Patch Changes
-
-- Updated dependencies [cadd963]
-    - @pluv/client@0.38.10
-    - @pluv/crdt@0.38.10
-    - @pluv/types@0.38.10
-
-## 0.38.9
-
-### Patch Changes
-
-- @pluv/client@0.38.9
-- @pluv/crdt@0.38.9
-- @pluv/types@0.38.9
-
-## 0.38.8
-
-### Patch Changes
-
-- @pluv/client@0.38.8
-- @pluv/crdt@0.38.8
-- @pluv/types@0.38.8
-
-## 0.38.7
-
-### Patch Changes
-
-- @pluv/client@0.38.7
-- @pluv/crdt@0.38.7
-- @pluv/types@0.38.7
-
-## 0.38.6
-
-### Patch Changes
-
-- @pluv/client@0.38.6
-- @pluv/crdt@0.38.6
-- @pluv/types@0.38.6
-
-## 0.38.5
-
-### Patch Changes
-
-- @pluv/client@0.38.5
-- @pluv/crdt@0.38.5
-- @pluv/types@0.38.5
-
-## 0.38.4
-
-### Patch Changes
-
-- @pluv/client@0.38.4
-- @pluv/crdt@0.38.4
-- @pluv/types@0.38.4
-
-## 0.38.3
-
-### Patch Changes
-
-- Updated dependencies [8346273]
-    - @pluv/client@0.38.3
-    - @pluv/crdt@0.38.3
-    - @pluv/types@0.38.3
-
-## 0.38.2
-
-### Patch Changes
-
-- Updated dependencies [de35f0b]
-    - @pluv/client@0.38.2
-    - @pluv/crdt@0.38.2
-    - @pluv/types@0.38.2
-
-## 0.38.1
-
-### Patch Changes
-
-- @pluv/client@0.38.1
-- @pluv/crdt@0.38.1
-- @pluv/types@0.38.1
-
-## 0.38.0
-
-### Patch Changes
-
-- Updated dependencies [f4ceca3]
-    - @pluv/client@0.38.0
-    - @pluv/types@0.38.0
-    - @pluv/crdt@0.38.0
-
-## 0.37.7
-
-### Patch Changes
-
-- @pluv/client@0.37.7
-- @pluv/crdt@0.37.7
-- @pluv/types@0.37.7
-
-## 0.37.6
-
-### Patch Changes
-
-- @pluv/client@0.37.6
-- @pluv/crdt@0.37.6
-- @pluv/types@0.37.6
-
-## 0.37.5
-
-### Patch Changes
-
-- @pluv/client@0.37.5
-- @pluv/crdt@0.37.5
-- @pluv/types@0.37.5
-
-## 0.37.4
-
-### Patch Changes
-
-- Updated dependencies [a9c3d17]
-    - @pluv/client@0.37.4
-    - @pluv/crdt@0.37.4
-    - @pluv/types@0.37.4
-
-## 0.37.3
-
-### Patch Changes
-
-- dff89ff: Added an error message for when `createBundle` functions are used outside of `PluvRoomProvider`.
-- Updated dependencies [9ae837b]
-    - @pluv/client@0.37.3
-    - @pluv/crdt@0.37.3
-    - @pluv/types@0.37.3
-
-## 0.37.2
-
-### Patch Changes
-
-- Updated dependencies [11920af]
-    - @pluv/client@0.37.2
-    - @pluv/crdt@0.37.2
-    - @pluv/types@0.37.2
-
-## 0.37.1
-
-### Patch Changes
-
-- Updated dependencies [e923a8d]
-    - @pluv/client@0.37.1
-    - @pluv/crdt@0.37.1
-    - @pluv/types@0.37.1
-
-## 0.37.0
-
-### Patch Changes
-
-- @pluv/client@0.37.0
-- @pluv/crdt@0.37.0
-- @pluv/types@0.37.0
-
-## 0.36.0
-
-### Minor Changes
-
-- 2a84951: **BREAKING**
-
-    Removed re-exports of `@pluv/client` and `@pluv/crdt` parts from `@pluv/react`.
-
-    ```ts
-    // Before
-
-    import { createBundle, createClient } from "@pluv/react";
-
-    // After
-
-    import { createClient } from "@pluv/client";
-    import { createBundle } from "@pluv/react";
-    ```
-
-### Patch Changes
-
-- Updated dependencies [4518b6d]
-    - @pluv/client@0.36.0
-    - @pluv/crdt@0.36.0
-    - @pluv/types@0.36.0
-
-## 0.35.4
-
-### Patch Changes
-
-- @pluv/client@0.35.4
-- @pluv/crdt@0.35.4
-- @pluv/types@0.35.4
-
-## 0.35.3
-
-### Patch Changes
-
-- @pluv/client@0.35.3
-- @pluv/crdt@0.35.3
-- @pluv/types@0.35.3
-
-## 0.35.2
-
-### Patch Changes
-
-- Updated dependencies [81cb692]
-    - @pluv/types@0.35.2
-    - @pluv/client@0.35.2
-    - @pluv/crdt@0.35.2
-
-## 0.35.1
-
-### Patch Changes
-
-- @pluv/client@0.35.1
-- @pluv/crdt@0.35.1
-- @pluv/types@0.35.1
-
-## 0.35.0
-
-### Patch Changes
-
-- @pluv/client@0.35.0
-- @pluv/crdt@0.35.0
-- @pluv/types@0.35.0
-
-## 0.34.1
-
-### Patch Changes
-
-- @pluv/client@0.34.1
-- @pluv/crdt@0.34.1
-- @pluv/types@0.34.1
-
-## 0.34.0
-
-### Patch Changes
-
-- @pluv/client@0.34.0
-- @pluv/crdt@0.34.0
-- @pluv/types@0.34.0
-
-## 0.33.0
-
-### Minor Changes
-
-- c3b07ab: Allow peer react@19.0.0.
-
-### Patch Changes
-
-- @pluv/client@0.33.0
-- @pluv/crdt@0.33.0
-- @pluv/types@0.33.0
-
-## 0.32.9
-
-### Patch Changes
-
-- 89d004d: Fix event proxy types for client-side events.
-    - @pluv/client@0.32.9
-    - @pluv/crdt@0.32.9
-    - @pluv/types@0.32.9
-
-## 0.32.8
-
-### Patch Changes
-
-- @pluv/client@0.32.8
-- @pluv/crdt@0.32.8
-- @pluv/types@0.32.8
-
-## 0.32.7
-
-### Patch Changes
-
-- @pluv/client@0.32.7
-- @pluv/crdt@0.32.7
-- @pluv/types@0.32.7
-
-## 0.32.6
-
-### Patch Changes
-
-- @pluv/client@0.32.6
-- @pluv/crdt@0.32.6
-- @pluv/types@0.32.6
-
-## 0.32.5
-
-### Patch Changes
-
-- @pluv/client@0.32.5
-- @pluv/crdt@0.32.5
-- @pluv/types@0.32.5
-
-## 0.32.4
-
-### Patch Changes
-
-- @pluv/client@0.32.4
-- @pluv/crdt@0.32.4
-- @pluv/types@0.32.4
-
-## 0.32.3
-
-### Patch Changes
-
-- 75e992f: Export `register` helper in `@pluv/react`.
-- Updated dependencies [b18230f]
-    - @pluv/client@0.32.3
-    - @pluv/crdt@0.32.3
-    - @pluv/types@0.32.3
-
-## 0.32.2
-
-### Patch Changes
-
-- @pluv/client@0.32.2
-- @pluv/crdt@0.32.2
-- @pluv/types@0.32.2
-
-## 0.32.1
-
-### Patch Changes
-
-- @pluv/client@0.32.1
-- @pluv/crdt@0.32.1
-- @pluv/types@0.32.1
-
-## 0.32.0
-
-### Patch Changes
-
-- @pluv/client@0.32.0
-- @pluv/crdt@0.32.0
-- @pluv/types@0.32.0
-
-## 0.31.0
-
-### Patch Changes
-
-- @pluv/client@0.31.0
-- @pluv/crdt@0.31.0
-- @pluv/types@0.31.0
-
-## 0.30.2
-
-### Patch Changes
-
-- @pluv/client@0.30.2
-- @pluv/crdt@0.30.2
-- @pluv/types@0.30.2
-
-## 0.30.1
-
-### Patch Changes
-
-- @pluv/client@0.30.1
-- @pluv/crdt@0.30.1
-- @pluv/types@0.30.1
-
-## 0.30.0
-
-### Patch Changes
-
-- Updated dependencies [cff933a]
-    - @pluv/client@0.30.0
-    - @pluv/crdt@0.30.0
-    - @pluv/types@0.30.0
-
-## 0.29.0
-
-### Minor Changes
-
-- 525aeae: **BREAKING**
-
-    Merge `createBundle` with `createRoomBundle`.
-
-    ```ts
-    // Before
-    const {
-        createRoomBundle,
-
-        // components
-        PluvProvider,
-
-        // hooks
-        useClient,
-    } = createBundle(client);
-
-    export const {
-        // components
-        MockedRoomProvider,
-        PluvRoomProvider,
-
-        // utils
-        event,
-
-        // hooks
-        useBroadcast,
-        useCanRedo,
-        useCanUndo,
-        useConnection,
-        useDoc,
-        useEvent,
-        useMyPresence,
-        useMyself,
-        useOther,
-        useOthers,
-        useRedo,
-        useRoom,
-        useStorage,
-        useTransact,
-        useUndo,
-    } = createRoomBundle({});
-
-    // After
-    const {
-        // components
-        MockedRoomProvider,
-        PluvProvider,
-        PluvRoomProvider,
-
-        // utils
-        event,
-
-        // hooks
-        useBroadcast,
-        useCanRedo,
-        useCanUndo,
-        useClient,
-        useConnection,
-        useDoc,
-        useEvent,
-        useMyPresence,
-        useMyself,
-        useOther,
-        useOthers,
-        useRedo,
-        useRoom,
-        useStorage,
-        useTransact,
-        useUndo,
-    } = createBundle(client);
-    ```
-
-### Patch Changes
-
-- @pluv/client@0.29.0
-- @pluv/crdt@0.29.0
-- @pluv/types@0.29.0
-
-## 0.28.0
-
-### Minor Changes
-
-- 778b43e: Remove the `initialStorage` option from `createRoomBundle`. This has been moved to `createClient`.
-
-### Patch Changes
-
-- @pluv/client@0.28.0
-- @pluv/crdt@0.28.0
-- @pluv/types@0.28.0
-
-## 0.27.0
-
-### Minor Changes
-
-- 19ed36c: Updated `createClient` and `createRoomBundle` object params to better support automatic type inference.
-
-    ```ts
-    // Before
-    import { createClient } from "@pluv/react";
-    import { yjs } from "@pluv/crdt-yjs";
-    import { z } from "zod";
-    import type { ioServer } from "./server/ioServer";
-
-    const client = createClient<typeof ioServer>({
-        authEndpoint: ({ room }) => "MY_AUTH_URL",
-        wsEndpoint: ({ room }) => "MY_WEBSOCKET_URL",
-    });
-
-    client.createRoom("my-example-room", {
-        presence: z.object({
-            selectionId: z.string().nullish(),
-        }),
-        initialPresence: {
-            selectionId: null,
-        },
-        initialStorage: yjs.doc(() => ({
-            messages: yjs.array<string>([]),
-        })),
-    });
-
-    // After
-
-    import { createBundle, createClient } from "@pluv/react";
-
-    const client = createClient({
-        authEndpoint: ({ room }) => "MY_AUTH_URL",
-        wsEndpoint: ({ room }) => "MY_WEBSOCKET_URL",
-        /**
-         * @description The ioServer type now needs to be inferred on this property
-         * instead of within the generic on `createClient`. This is because of
-         * limitations with TypeScript not yet supporting partial type-inference
-         * for generics. Ensure to no-loonger include any generics on `createClient`
-         */
-        infer: (i) => ({ io: i<typeof ioServer> }),
-        // Now moved to `createClient` from `PluvClient.createRoom`
-        presence: z.object({
-            selectionId: z.string().nullish(),
-        }),
-        /**
-         * @description Now added to `createClient` to specify defaults for all
-         * rooms, and to infer types for storage. This value will be overwritten by
-         * `PluvClient.createRoom`.
-         */
-        initialStorage: yjs.doc(() => ({
-            messages: yjs.array<string>([]),
-        })),
-    });
-
-    const { createRoomBundle } = createBundle(client);
-    const pluv = createRoomBundle({});
-    ```
-
-### Patch Changes
-
-- 19ed36c: Added client-side event router. This more-or-less mirrors the server-side event router. You can use both the server-side and client-side router simultaneously, but you should generally prefer only using one or the other.
-
-    ```ts
-    // Backend Server
-    import { createIO } from "@pluv/io";
-
-    const io = createIO({ /* ... */ });
-    const ioServer = io.server({
-        router: io.router({
-            multiply2: io.procedure
-                .input(z.object({ value: z.number() }))
-                .broadcast(({ value }) => ({
-                    multiplied2: { value: value * 2 },
-                })),
-        }),
-    });
-
-    // Frontend Client
-    import { createBundle createClient } from "@pluv/react";
-
-    const io = createClient({ /* ... */ });
-
-    const { createRoomBundle } = createBundle(io);
-    const pluv = createRoomBundle({
-        // ...
-        router: io.router({
-            add5: io.procedure
-                .input(z.object({ value: z.number() }))
-                .broadcast(({ value }) => ({
-                    /**
-                     * @description Because `ioServer` does not specify `added5`,
-                     * this will be forwarded to connected peers.
-                     */
-                    added5: { value: value + 5 },
-                })),
-            /**
-             * @description This is possible, but not recommended to do. Because
-             * `multiply2` is a procedure on `ioServer`, this will trigger the
-             * `multiply2` procedure on `ioServer`. Connected peers will not
-             * receive `multiply2`, but rather `multipled2`.
-             */
-            subtract5Multiply2: io.procedure
-                .input(z.object({ value: z.number() }))
-                .broadcast(({ value }) => ({
-                    multiply2: { value: value - 5 },
-                })),
-        }),
-    });
-    ```
-
-- Updated dependencies [19ed36c]
-- Updated dependencies [19ed36c]
-    - @pluv/client@0.27.0
-    - @pluv/crdt@0.27.0
-    - @pluv/types@0.27.0
-
-## 0.26.0
-
-### Minor Changes
-
-- 19e5dda: **BREAKING**
-  Update `authEndpoint` and `wsEndpoint` to now use a parameterized object that passes through additional data via a `metadata` property.
-
-    ```tsx
-    // Before
-
-    import { env } from "./env";
-    import type { ioServer } from "./server";
-
-    const client = createClient<typeof ioServer>({
-        authEndpoint: (room: string) => `${env.API_URL}}/room/${room}`,
-        wsEndpoint: (room: string) => `${env.WS_URL}/room/${room}`,
-    });
-
-    // After
-
-    const client = createClient<
-        typeof ioServer,
-        // Optional: You can specify types for metadata here. This is useful for Cloudflare Pages
-        { apiUrl: string; wsUrl: string }
-    >({
-        authEndpoint: ({ metadata, room }) => `${metadata.apiUrl}}/room/${room}`,
-        wsEndpoint: ({ metadata, room }) => `${{ metadata.wsUrl }}/room/${room}`,
-    });
-
-    client.createRoom("my-room", {
-        // This property exists when the `metadata` generic type is defined above
-        metadata: {
-            apiUrl: "https://example.com/api",
-            wsUrl: "wss://example.com/api",
-        },
-        // ...
-    });
-
-    <PluvRoomProvider
-        // This property exists when the `metadata` generic type is defined above
-        metadata={{
-            apiUrl: "https://example.com/api",
-            wsUrl: "wss://example.com/api",
-        }}
-    >
-        {/* ... */}
-    </PluvRoomProvider>
-    ```
-
-### Patch Changes
-
-- Updated dependencies [19e5dda]
-    - @pluv/client@0.26.0
-    - @pluv/crdt@0.26.0
-    - @pluv/types@0.26.0
-
-## 0.25.4
-
-### Patch Changes
-
-- @pluv/client@0.25.4
-- @pluv/crdt@0.25.4
-- @pluv/types@0.25.4
-
-## 0.25.3
-
-### Patch Changes
-
-- @pluv/client@0.25.3
-- @pluv/crdt@0.25.3
-- @pluv/types@0.25.3
-
-## 0.25.2
-
-### Patch Changes
-
-- @pluv/client@0.25.2
-- @pluv/crdt@0.25.2
-- @pluv/types@0.25.2
-
-## 0.25.1
-
-### Patch Changes
-
-- @pluv/client@0.25.1
-- @pluv/crdt@0.25.1
-- @pluv/types@0.25.1
-
-## 0.25.0
-
-### Patch Changes
-
-- @pluv/client@0.25.0
-- @pluv/crdt@0.25.0
-- @pluv/types@0.25.0
-
-## 0.24.1
-
-### Patch Changes
-
-- Updated dependencies [ba299e2]
-    - @pluv/client@0.24.1
-    - @pluv/crdt@0.24.1
-    - @pluv/types@0.24.1
-
-## 0.24.0
-
-### Patch Changes
-
-- @pluv/client@0.24.0
-- @pluv/crdt@0.24.0
-- @pluv/types@0.24.0
-
-## 0.23.0
-
-### Patch Changes
-
-- @pluv/client@0.23.0
-- @pluv/crdt@0.23.0
-- @pluv/types@0.23.0
-
-## 0.22.0
-
-### Patch Changes
-
-- @pluv/client@0.22.0
-- @pluv/crdt@0.22.0
-- @pluv/types@0.22.0
-
-## 0.21.1
-
-### Patch Changes
-
-- @pluv/client@0.21.1
-- @pluv/crdt@0.21.1
-- @pluv/types@0.21.1
-
-## 0.21.0
-
-### Patch Changes
-
-- Updated dependencies [b98ab6b]
-    - @pluv/client@0.21.0
-    - @pluv/crdt@0.21.0
-    - @pluv/types@0.21.0
-
-## 0.20.0
-
-### Minor Changes
-
-- 9492085: **BREAKING**: `@pluv/crdt-yjs` and `@pluv/crdt-loro` have been updated so that the utilities to create shared-types/containers no-longer return a wrapper around the underlying shared-types and containers, but rather return the shared-types/containers directly.
-
-    This means that for methods such as `getStorage` from `@pluv/client` and `useStorage` from `@pluv/react`, the shared-types/containers are also returned instead of the wrapper types.
-
-    The motivation for these changes are so that pluv.io is supplementary to `yjs` and `loro-crdt`, instead of having these libraries be an internal implementation of pluv.io.
-
-    ```ts
-    // Before
-
-    import { yjs } from "@pluv/crdt-yjs";
-
-    yjs.array([]); // Returns CrdtYjsArray
-    yjs.object([]); // Returns CrdtYjsObject
-
-    const room: PluvRoom = /* ... */;
-
-    room.getStorage("messages"); // Returns AbstractCrdtType
-
-    const [, sharedType] = useStorage("messages"); // sharedType is an AbstractCrdtType
-    ```
-
-    ```ts
-    // Now
-
-    import { yjs } from "@pluv/crdt-yjs";
-
-    yjs.array([]); // Returns yjs.Array
-    yjs.object([]); // Returns yjs.Map
-
-    const room: PluvRoom = /* ... */;
-
-    room.getStorage("messages"); // Returns yjs.AbstractType
-
-    const [, sharedType] = useStorage("messages"); // sharedType is a yjs.AbstractType
-    ```
-
-    For `@pluv/crdt-loro` specifically, `@pluv/client` relies on [loro events and subscriptions](https://www.loro.dev/docs/tutorial/get_started#event) to detect changes. The `AbstractLoroCrdt` types previously called `Loro.commit` after each change as an abstraction, but now this no-longer happens. To ensure that changes to loro containers are properly handled in `@pluv/react`, make sure to commit your changes whenever possible:
-
-    ```ts
-    // Before
-
-    const [data, container] = useStorage("messages");
-
-    // This automatically called Loro.commit under the hood and rerendered the page with updated data.
-    container.push(loro.object({ name: "John Doe", age: 35 }));
-    ```
-
-    ```ts
-    // Now
-
-    const [data, container] = useStorage("messages");
-
-    const doc = useDoc();
-    const transact = useTransact();
-
-    // Updates need to be committed back to the doc whenever the changes need to be emitted to other users
-    // The returned data also will not update until the changes are commited
-
-    // The two operations below are functionally equivalent
-    transact(() => {
-        container.push(loro.object({ name: "John Doe", age: 35 }));
-    });
-
-    container.push(loro.object({ name: "John Doe", age: 35 }));
-    doc.value.commit();
-    ```
-
-### Patch Changes
-
-- Updated dependencies [9492085]
-    - @pluv/client@0.20.0
-    - @pluv/crdt@0.20.0
-    - @pluv/types@0.20.0
-
-## 0.19.0
-
-### Minor Changes
-
-- 798e32d: **Breaking**: useOthers now allows returning any data besides arrays when using a custom selector.
-- 8450306: **Breaking**: Require minimum react version of ^18.0.0.
-
-### Patch Changes
-
-- 607afe3: Update the `updateMyPresence` function from `useMyPresence` to simply forward the function from the `PluvRoom`. This means all `updateMyPresence` functions should be the same underlying reference across all `useMyPresence` hooks.
-- Updated dependencies [137444b]
-- Updated dependencies [f5e4370]
-    - @pluv/client@0.19.0
-    - @pluv/crdt@0.19.0
-    - @pluv/types@0.19.0
-
-## 0.18.0
-
-### Minor Changes
-
-- 99b5ca9: ## Breaking Changes
-    - `@pluv/io` has been updated to introduce `PluvProcedure`, `PluvRouter` and `PluvServer`. This change is intended to improve the ergonomics of declaring events and simplifying inferences of event types.
-
-    ### Before:
-
-    ```ts
-    // backend/io.ts
-
-    import { createIO } from "@pluv/io";
-    import { createPluvHandler, platformNode } from "@pluv/platform-node";
-    import { z } from "zod";
-
-    export const io = createIO({
-        platform: platformNode(),
-    })
-        .event("SEND_MESSAGE", {
-            input: z.object({ message: z.string() }),
-            resolver: ({ message }) => ({ RECEIVE_MESSAGE: { message } }),
-        })
-        .event("DOUBLE_VALUE", {
-            input: z.object({ value: z.number() }),
-            resolver: ({ value }) => ({ VALUE_DOUBLED: { value: value * 2 } }),
-        });
-
-    const Pluv = createPluvHandler({
-        io,
-        /* ... */
-    });
-    ```
-
-    ```ts
-    // frontend/pluv.ts
-
-    import { createClient } from "@pluv/react";
-    import type { io } from "../backend/io";
-
-    const client = createClient<typeof io>({
-        /* ... */
-    });
-    ```
-
-    ### Now:
-
-    ```ts
-    import { createIO } from "@pluv/io";
-    import { createPluvHandler, platformNode } from "@pluv/platform-node";
-    import { z } from "zod";
-
-    const io = createIO({
-        platform: platformNode(),
-    });
-
-    const router = io.router({
-        SEND_MESSAGE: io.procedure
-            .input(z.object({ message: z.string() }))
-            .broadcast(({ message }) => ({
-                RECEIVE_MESSAGE: { message },
-            })),
-        DOUBLE_VALUE: io.procedure
-            .input(z.object({ value: z.number() }))
-            .broadcast(({ value }) => ({
-                VALUE_DOUBLED: { value: value * 2 },
-            })),
-    });
-
-    export const ioServer = io.server({ router });
-
-    const Pluv = createPluvHandler({
-        io: ioServer, // <- This uses the PluvServer now
-        /* ... */
-    });
-    ```
-
-    ```ts
-    // frontend/pluv.ts
-
-    import { createClient } from "@pluv/react";
-    import type { ioServer } from "../backend/io";
-
-    // This users the PluvServer type now
-    const client = createClient<typeof ioServer>({
-        /* ... */
-    });
-    ```
-
-    - `PluvRouter` instances can also be merged via the `mergeRouters` method, which effectively performs an `Object.assign` of the events object and returns a new `PluvRouter` with the correct types:
-
-    ```ts
-    const router = io.mergeRouters(router1, router2);
-    ```
-
-- 07a7725: Added broadcast proxy as a new way to broadcast events to other users.
-
-    ```tsx
-    // backend
-
-    const router = io.router({
-        SEND_MESSAGE: io.procedure
-            .input(z.object({ message: z.string() }))
-            .broadcast(({ message }) => ({ RECEIVE_MESSAGE: { message } })),
-    });
-
-    // frontend
-    const pluv = createRoomBundle(/* ... */);
-
-    const broadcast = pluv.useBroadcast();
-
-    // Both of the examples below are equivalent.
-
-    broadcast("SEND_MESSAGE", { message: "Hello world~!" });
-
-    broadcast.SEND_MESSAGE({ message: "Hello world~!" });
-    ```
-
-### Patch Changes
-
-- e587c18: Added event proxy as a new way to listen to events.
-
-    ```tsx
-    // backend
-
-    const router = io.router({
-        SEND_MESSAGE: io.procedure
-            .input(z.object({ message: z.string() }))
-            .broadcast(({ message }) => ({ RECEIVE_MESSAGE: { message } })),
-    });
-
-    // frontend
-    const pluv = createRoomBundle(/* ... */);
-
-    // Both of the examples below are equivalent.
-
-    pluv.useEvent("RECEIVE_MESSAGE", ({ data }) => {
-        const { message } = data;
-
-        console.log(message);
-    });
-
-    pluv.event.RECEIVE_MESSAGE.useEvent(({ data }) => {
-        const { message } = data;
-
-        console.log(message);
-    });
-    ```
-
-- Updated dependencies [06c67be]
-- Updated dependencies [99b5ca9]
-- Updated dependencies [df1342c]
-    - @pluv/client@0.18.0
-    - @pluv/types@0.18.0
-    - @pluv/crdt@0.18.0
-
-## 0.17.3
-
-### Patch Changes
-
-- @pluv/client@0.17.3
-- @pluv/crdt@0.17.3
-- @pluv/types@0.17.3
-
-## 0.17.2
-
-### Patch Changes
-
-- @pluv/client@0.17.2
-- @pluv/crdt@0.17.2
-- @pluv/types@0.17.2
-
-## 0.17.1
-
-### Patch Changes
-
-- @pluv/client@0.17.1
-- @pluv/crdt@0.17.1
-- @pluv/types@0.17.1
-
-## 0.17.0
-
-### Patch Changes
-
-- Updated dependencies [507bc00]
-    - @pluv/types@0.17.0
-    - @pluv/client@0.17.0
-    - @pluv/crdt@0.17.0
-
-## 0.16.3
-
-### Patch Changes
-
-- @pluv/client@0.16.3
-- @pluv/crdt@0.16.3
-- @pluv/types@0.16.3
-
-## 0.16.2
-
-### Patch Changes
-
-- @pluv/client@0.16.2
-- @pluv/crdt@0.16.2
-- @pluv/types@0.16.2
-
-## 0.16.1
-
-### Patch Changes
-
-- @pluv/client@0.16.1
-- @pluv/crdt@0.16.1
-- @pluv/types@0.16.1
-
-## 0.16.0
-
-### Minor Changes
-
-- 995aa9c: Renamed all hooks from `@pluv/react` to be simply prefixed with `use` instead of `usePluv` (e.g. `usePluvStorage` is now just `useStorage`).
-
-    Hooks can be aliased to retain the same names if preferred:
-
-    ```ts
-    export const {
-        // ...
-        useStorage: usePluvStorage,
-        useTransact: usePluvTransact,
-        // ...
-    } = createRoomBundle(/* */);
-    ```
-
-- 4280220: ## Breaking Changes
-    - Storage types are now kept on the root of the document.
-        - Previously, `@pluv/crdt-yjs` kept all shared-types on a hidden Yjs Map called `storage` on the root of the Yjs Doc. Now all shared-types are kept on the root of the Yjs Doc instead. This behavior should be more in-line with how shared-types are documented to be used from Yjs.
-    - `@pluv/client` and `@pluv/react` no-longer re-export `@pluv/crdt-yjs`. This package will now need to be installed separately.
-
-        ```bash
-        # if installing @pluv/client
-        npm install @pluv/client @pluv/crdt-yjs
-        # if installing @pluv/react
-        npm install @pluv/react @pluv/crdt-yjs
-        ```
-
-        ```ts
-        // Before:
-        import { createClient, y } from "@pluv/client";
-        // After:
-        import { createClient } from "@pluv/client";
-        import { yjs } from "@pluv/crdt-yjs"; // y renamed to yjs
-        ```
-
-    - The `y` import has been renamed to `yjs`.
-        ```ts
-        // Before:
-        import { y } from "@pluv/crdt-yjs";
-        // After:
-        import { yjs } from "@pluv/crdt-yjs";
-        ```
-    - `@pluv/crdt-yjs` functions no-longer return Yjs shared-types directly, but instead return an `AbstractCrdtType` from `@pluv/crdt` (new package). This also affects methods that return storage shared types in both `@pluv/client` and `@pluv/react` from functions like `PluvRoom.getStorage` and `PluvRoom.useStorage`.
-
-        ```ts
-        // Before:
-        import { y } from "@pluv/crdt-yjs";
-        import type { Array as YArray, Map as YMap } from "yjs";
-
-        const array: YArray<YMap<{ message: string }>> = y.array([y.object({ message: "Hello" })]);
-
-        array.push([y.object({ message: "World!" })]);
-
-        // After:
-        import type { CrdtYjsArray, CrdtYjsObject } from "@pluv/crdt-yjs";
-        import { yjs } from "@pluv/crdt-yjs";
-        import type { Array as YArray } from "yjs";
-
-        const array: CrdtYjsArray<CrdtYjsObject<{ message: string }>> = yjs.array([
-            yjs.object({ message: "Hello" }),
-        ]);
-
-        array.push(yjs.object({ message: "World!" }));
-
-        // use .value to get the underlying yjs type
-        const yarray: YArray<YMap<{ message: string }>> = array.value;
-        ```
-
-    - `initialStorage` must now use the `doc` function from `@pluv/crdt-yjs` to be defined. This also affects `@pluv/react`.
-
-        ```ts
-        // Before:
-        import { createClient, y } from "@pluv/client";
-
-        const client = createClient({
-            /* ... */
-        });
-
-        client.createRoom({
-            // ...
-            initialStorage: () => ({
-                messages: y.array([y.object({ message: "Hello world!" })]),
-            }),
-        });
-
-        // After:
-        import { createClient } from "@pluv/client";
-        // This is now imported separately
-        import { yjs } from "@pluv/crdt-yjs";
-
-        const client = createClient({
-            /* ... */
-        });
-
-        client.createRoom({
-            // ...
-            initialStorage: yjs.doc(() => ({
-                messages: yjs.array([yjs.object({ message: "Hello world!" })]),
-            })),
-        });
-        ```
-
-    - `@pluv/client` can now instead use [loro](https://github.com/loro-dev/loro) instead of [yjs](https://github.com/yjs/yjs).
-        ```bash
-        npm install @pluv/client @pluv/crdt-loro loro-crdt
-        ```
-    - If you are using storage features with pluv, `@pluv/io` must now specify which crdt library (i.e. `@pluv/crdt-yjs` or `@pluv/crdt-loro`) it is meant to use.
-
-        ```ts
-        import { loro } from "@pluv/crdt-loro";
-        import { yjs } from "@pluv/crdt-yjs";
-        import { createIO } from "@pluv/io";
-
-        const io = createIO({
-            // ...
-            // If using loro
-            crdt: loro,
-            // If using yjs
-            crdt: yjs,
-        });
-        ```
-
-    - `PluvRoom.getDoc()` from `@pluv/client` no-longer returns the Yjs Doc instance, but rather a `AbstractCrdtDoc` instance from `@pluv/crdt`. This also affects the hook from `@pluv/react`.
-
-        ```ts
-        // Before:
-        import { Doc as YDoc } from "yjs";
-
-        const room: PluvRoom = client.createRoom({
-            /* ... */
-        });
-
-        const doc: YDoc = room.getDoc();
-
-        // After:
-        import { CrdtYjsDoc } from "@pluv/crdt-yjs";
-        import { Doc as YDoc } from "yjs";
-
-        const room: PluvRoom = client.createRoom({
-            /* ... */
-        });
-
-        const doc: CrdtYjsDoc<any> = room.getDoc();
-        const ydoc: YDoc = doc.value;
-        ```
-
-    - `@pluv/client` and `@pluv/react` now may return `null` when retrieving storage while storage is being initialized.
-
-        ```ts
-        const sharedType = room.getStorage("messages"); // This may be null
-
-        const [data, sharedType] = useStorage("messages"); // data and sharedType may both be null
-        ```
-
-### Patch Changes
-
-- Updated dependencies [4280220]
-    - @pluv/client@0.16.0
-    - @pluv/crdt@0.16.0
-    - @pluv/types@0.16.0
-
-## 0.15.0
-
-### Patch Changes
-
-- @pluv/client@0.15.0
-- @pluv/types@0.15.0
-
-## 0.14.1
-
-### Patch Changes
-
-- @pluv/client@0.14.1
-- @pluv/types@0.14.1
-
-## 0.14.0
-
-### Patch Changes
-
-- @pluv/client@0.14.0
-- @pluv/types@0.14.0
-
-## 0.13.0
-
-### Minor Changes
-
-- 4c4b47f: Added `useDoc` to access the root Yjs doc.
-
-    ```ts
-    import type { Doc } from "yjs";
-
-    const doc: Doc = useDoc();
-    ```
-
-### Patch Changes
-
-- Updated dependencies [1126215]
-    - @pluv/client@0.13.0
-    - @pluv/types@0.13.0
-
-## 0.12.3
-
-### Patch Changes
-
-- da9f600: Upgraded dependencies
-- Updated dependencies [da9f600]
-    - @pluv/client@0.12.3
-    - @pluv/types@0.12.3
-
-## 0.12.2
-
-### Patch Changes
-
-- 259a7da: Bumped dependencies
-
-## 0.12.1
-
-### Patch Changes
-
-- cae08aa: Updated storage from `getStorage` to never return null
-- Updated dependencies [cae08aa]
-    - @pluv/client@0.12.1
-    - @pluv/types@0.12.1
-
-## 0.12.0
-
-### Minor Changes
-
-- 436040b: Added ability to undo and redo changes to storage.
-
-    ## @pluv/crdt-yjs
-
-    `@pluv/crdt-yjs` now exposes 5 new methods: `canRedo`, `canUndo`, `redo`, `undo` and `trackOrigins`.
-
-    Refer to the code-example below to better understand how to undo and redo with your doc.
-
-    ```ts
-    // Example
-    import { array, doc } from "@pluv/crdt-yjs";
-
-    // Create your doc with your shared-types
-    const myDoc = doc({
-        messages: array<string>([]),
-    });
-
-    /**
-     * @description Track origins to enable undos and redos for your document.
-     * trackOrigins must be called before any storage mutations, to enable those
-     * mutations to be undone/redone.
-     */
-    myDoc.trackOrigins({
-        /**
-         * @description This is the same `captureTimeout` option from yjs's UndoManager.
-         * This specifies a number in ms, during which edits are merged together to be
-         * undone together. Set this to 0, to track each transacted change individually.
-         * @see (@link https://docs.yjs.dev/api/undo-manager)
-         * @default 500
-         */
-        captureTimeout: 500,
-        /**
-         * @desription This is the same `trackedOrigins` option from yjs's UndoManager.
-         * This specifies transaction origins (strings only) to filter which transactions
-         * can be undone.
-         * @see (@link https://docs.yjs.dev/api/undo-manager)
-         * @default undefined
-         */
-        trackedOrigins: ["user-123"],
-    });
-
-    /**
-     * @description Check whether calling undo will mutate storage
-     * @returns boolean
-     */
-    myDoc.canUndo();
-    /**
-     * @description Check whether calling redo will mutate storage
-     * @returns boolean
-     */
-    myDoc.canRedo();
-
-    // Perform a storage mutation within a transaction so that it can be affected
-    // by undo/redo operations.
-    myDoc.transact(() => {
-        myDoc.get("messages").push(["hello world!"]);
-    }, "user-123");
-
-    /**
-     * @description Undoes the last valid mutation to storage
-     */
-    myDoc.undo();
-
-    /**
-     * @description Re-applies the last undone mutation to storage
-     */
-    myDoc.redo();
-    ```
-
-    ## @pluv/client
-
-    `@pluv/client`'s `PluvRoom` and `MockedRoom` now exposes 5 new methods: `canRedo`, `canUndo`, `redo`, `undo` and `transact`.
-
-    Refer to the code-example below to better understand how to undo and redo with your `PluvRoom`.
-
-    ```ts
-    import { createClient, y } from "@pluv/client";
-
-    const client = createClient({});
-
-    /**
-     * @description When a room is created, undo/redo will automatically
-     * be configured to filter for changes made by the connected user
-     * (so that users only undo/redo their changes).
-     */
-    const room = client.createRoom("my-room", {
-        initialStorage: () => ({
-            messages: y.array<string>([]),
-        }),
-        /**
-         * @description This is the same `captureTimeout` option from yjs's UndoManager.
-         * This specifies a number in ms, during which edits are merged together to be
-         * undone together. Set this to 0, to track each transacted change individually.
-         * @see (@link https://docs.yjs.dev/api/undo-manager)
-         * @default 500
-         */
-        captureTimeout: 500,
-        /**
-         * @desription This is the same `trackedOrigins` option from yjs's UndoManager.
-         * This specifies transaction origins (strings only) to filter which transactions
-         * can be undone.
-         * When omitted, the user's connection id will be tracked. When provided,
-         * specifies additional tracked origins besides the user's connection id.
-         * @see (@link https://docs.yjs.dev/api/undo-manager)
-         * @default undefined
-         */
-        trackedOrigins: ["user-123"],
-    });
-
-    /**
-     * @description Check whether calling undo will mutate storage
-     * @returns boolean
-     */
-    room.canUndo();
-    /**
-     * @description Check whether calling redo will mutate storage
-     * @returns boolean
-     */
-    room.canRedo();
-
-    /**
-     * @description Calling transact will enable a storage mutation to be undone/redone.
-     * When called without an origin, the origin will default to the user's connection
-     * id.
-     *
-     * You can specify a 2nd parameter to transact with a different transaction origin.
-     */
-    room.transact(() => {
-        room.get("messages").push(["hello world!"]);
-    });
-
-    // This will also be undoable because `"user-123"` is a tracked origin.
-    room.transact(() => {
-        room.get("messages").push(["hello world!"]);
-    }, "user-123");
-
-    /**
-     * @description Undoes the last valid mutation to storage
-     */
-    room.undo();
-
-    /**
-     * @description Re-applies the last undone mutation to storage
-     */
-    room.redo();
-    ```
-
-    ## @pluv/react
-
-    `@pluv/react`'s `createRoomBundle` now exposes 5 new react hooks: `useCanRedo`, `useCanUndo`, `useRedo`, `useUndo` and `useTransact`.
-
-    Refer to the code-example below to better understand how to undo and redo with your `createRoomBundle`.
-
-    ```tsx
-    import { createBundle, createClient, y } from "@pluv/react";
-    import { type io } from "./io";
-
-    const client = createClient<typeof io>();
-
-    const { createRoomBundle } = createBundle(client);
-
-    const { useCanRedo, useCanUndo, useRedo, useStorage, useTransact, useUndo } = createRoomBundle({
-        initialStorage: () => ({
-            messages: y.array<string>([]),
-        }),
-        /**
-         * @description This is the same `captureTimeout` option from yjs's UndoManager.
-         * This specifies a number in ms, during which edits are merged together to be
-         * undone together. Set this to 0, to track each transacted change individually.
-         * @see (@link https://docs.yjs.dev/api/undo-manager)
-         * @default 500
-         */
-        captureTimeout: 500,
-        /**
-         * @desription This is the same `trackedOrigins` option from yjs's UndoManager.
-         * This specifies transaction origins (strings only) to filter which transactions
-         * can be undone.
-         * When omitted, the user's connection id will be tracked. When provided,
-         * specifies additional tracked origins besides the user's connection id.
-         * @see (@link https://docs.yjs.dev/api/undo-manager)
-         * @default undefined
-         */
-        trackedOrigins: ["user-123"],
-    });
-
-    /**
-     * @description Check whether calling undo will mutate storage
-     */
-    const canUndo: boolean = useCanUndo();
-    /**
-     * @description Check whether calling redo will mutate storage
-     */
-    const canRedo: boolean = useCanRedo();
-
-    const [messages, sharedType] = useStorage("messages");
-
-    /**
-     * @description Calling transact will enable a storage mutation to be undone/redone.
-     * When called without an origin, the origin will default to the user's connection
-     * id.
-     *
-     * You can specify a 2nd parameter to transact with a different transaction origin.
-     */
-    const transact = useTransact();
-
-    transact(() => {
-        sharedType.push(["hello world!"]);
-    });
-
-    // This will also be undoable because `"user-123"` is a tracked origin.
-    transact(() => {
-        sharedType.push(["hello world!"]);
-    }, "user-123");
-
-    /**
-     * @description Undoes the last valid mutation to storage
-     */
-    const undo = useUndo();
-
-    undo();
-
-    /**
-     * @description Re-applies the last undone mutation to storage
-     */
-    const redo = useRedo();
-
-    redo();
-    ```
-
-### Patch Changes
-
-- Updated dependencies [436040b]
-    - @pluv/client@0.12.0
-    - @pluv/types@0.12.0
-
-## 0.11.1
-
-### Patch Changes
-
-- 74b3061: Bumped minor and patch dependencies.
-- Updated dependencies [74b3061]
-    - @pluv/client@0.11.1
-    - @pluv/types@0.11.1
-
-## 0.11.0
-
-### Patch Changes
-
-- @pluv/client@0.11.0
-- @pluv/types@0.11.0
-
-## 0.10.3
-
-### Patch Changes
-
-- @pluv/client@0.10.3
-- @pluv/types@0.10.3
-
-## 0.10.2
-
-### Patch Changes
-
-- @pluv/client@0.10.2
-- @pluv/types@0.10.2
-
-## 0.10.1
-
-### Patch Changes
-
-- 885835d: remove unnecessary dependency
-- Updated dependencies [885835d]
-    - @pluv/client@0.10.1
-    - @pluv/types@0.10.1
-
-## 0.10.0
-
-### Minor Changes
-
-- f43f1cc: Change packages to all be versioned together for consistency.
-
-### Patch Changes
-
-- Updated dependencies [f43f1cc]
-    - @pluv/client@0.10.0
-    - @pluv/types@0.10.0
-
-## 0.6.2
-
-### Patch Changes
-
-- f4317ba: \* Renamed type `unstable_YObjectValue` to `YObjectValue`;
-    - Renamed type `unstable_YObject` to `YObject`.
-    - Re-exported `xmlElement`, `xmlFragment` and `xmlText` from `@pluv/client`.
-
-        ```ts
-        import { y } from "@pluv/client";
-        // or
-        import { y } from "@pluv/react";
-
-        y.xmlElement("MyElement", {});
-        y.xmlFragment({});
-        y.xmlText("hello world");
-        ```
-
-- Updated dependencies [f4317ba]
-    - @pluv/client@0.9.2
-
-## 0.6.1
-
-### Patch Changes
-
-- 8fba48b: fix including incorrect dependency
-- 8997c65: bumped dependencies
-- Updated dependencies [8fba48b]
-- Updated dependencies [8997c65]
-    - @pluv/client@0.9.1
-    - @pluv/types@0.2.2
-
-## 0.6.0
-
-### Minor Changes
-
-- 829d31b: Added support for defining persistant frontend storage for rooms via a new `addons` option on rooms.
-
-    This also introduces the first new addon `@pluv/addon-indexeddb`, which is more-or-less the equivalent to `y-indexeddb` which you can install like so:
-
-    ```
-    npm install @pluv/addon-indexeddb
-    ```
-
-    To use this new addon, simply pass it to options when creating a room:
-
-    ```ts
-    import { addonIndexedDB } from "@pluv/addon-indexeddb";
-    import { createClient } from "@pluv/client";
-
-    const client = createClient({
-        // ...
-    });
-
-    const room = client.createRoom("my-new-room", {
-        addons: [
-            // Define your addons in an array like so
-            addonIndexedDB(),
-        ],
-    });
-    ```
-
-    Or when using `@pluv/react`:
-
-    ```ts
-    const PluvRoom = createRoomBundle({
-        // ...
-        addons: [
-            // Define your addons in an array like so
-            addonIndexedDB(),
-        ],
-    });
-    ```
-
-### Patch Changes
-
-- 8d11672: bumped dependencies to latest
-- Updated dependencies [8d11672]
-- Updated dependencies [829d31b]
-    - @pluv/client@0.9.0
-    - @pluv/types@0.2.1
-
-## 0.5.11
-
-### Patch Changes
-
-- 2c9c5c3: changed my-presence to be non-nullable
-- Updated dependencies [2c9c5c3]
-    - @pluv/client@0.8.1
-
-## 0.5.10
-
-### Patch Changes
-
-- 5bbfb98: fix not properly handling unauthorized checks
-- b85a232: bumped dependencies
-- Updated dependencies [5bbfb98]
-- Updated dependencies [b85a232]
-- Updated dependencies [fde89cf]
-    - @pluv/client@0.8.0
-    - @pluv/types@0.2.0
-
-## 0.5.9
-
-### Patch Changes
-
-- 3518a83: bumped dependencies
-- Updated dependencies [0dd847e]
-- Updated dependencies [bb2886b]
-- Updated dependencies [ae679a8]
-- Updated dependencies [bb2886b]
-- Updated dependencies [3518a83]
-    - @pluv/client@0.7.0
-    - @pluv/types@0.2.0
-
-## 0.5.8
-
-### Patch Changes
-
-- 7ad4967: fixed user's presence not updating locally while offline
-- Updated dependencies [7ad4967]
-- Updated dependencies [4535687]
-    - @pluv/client@0.6.5
-    - @pluv/types@0.1.6
-
-## 0.5.7
-
-### Patch Changes
-
-- 78fd644: updated readmes with links to the documentation website
-- Updated dependencies [78fd644]
-    - @pluv/client@0.6.4
-
-## 0.5.6
-
-### Patch Changes
-
-- 850626e: bumped dependencies
-- Updated dependencies [850626e]
-    - @pluv/client@0.6.3
-    - @pluv/types@0.1.6
-
-## 0.5.5
-
-### Patch Changes
-
-- 9ae251d: bumped dependencies
-- Updated dependencies [9ae251d]
-    - @pluv/client@0.6.2
-
-## 0.5.4
-
-### Patch Changes
-
-- 19433af: updated MockedRoomProvider events to allow partial events
-- b80c555: updated react hooks to not re-render if state is deeply equal by default
-- 74870ee: bumped dependencies
-- Updated dependencies [19433af]
-- Updated dependencies [74870ee]
-    - @pluv/client@0.6.1
-    - @pluv/types@0.1.5
-
-## 0.5.3
-
-### Patch Changes
-
-- 57ae13f: bumped dependencies
-    - @pluv/client@0.6.0
-    - @pluv/types@0.1.4
-
-## 0.5.2
-
-### Patch Changes
-
-- 9516a4e: updated typescript to 5.0
-- 7b6da1c: bumped dependencies
-- e9c1514: bumped dependencies
-- 9d1829c: chore: bumped dependencies
-- Updated dependencies [e1308e3]
-- Updated dependencies [9516a4e]
-- Updated dependencies [e1308e3]
-- Updated dependencies [7b6da1c]
-- Updated dependencies [e9c1514]
-- Updated dependencies [9d1829c]
-    - @pluv/client@0.6.0
-    - @pluv/types@0.1.4
-
-## 0.5.1
-
-### Patch Changes
-
-- 161e00e: fixed links to other pluv packages in readmes
-- f6c0e65: bumped dependencies
-- Updated dependencies [161e00e]
-- Updated dependencies [f6c0e65]
-    - @pluv/client@0.5.1
-    - @pluv/types@0.1.3
-
-## 0.5.0
-
-### Minor Changes
-
-- 327a6ef: renamed y.unstable\_\_object to y.object
-
-### Patch Changes
-
-- 78a6119: Fixed MockedRoom not sending storage updates
-- 8bf62cb: bumped dependencies
-- 7e52685: Bumped dependencies
-- b1cb325: Updated dependencies
-- b4e34bc: chore(deps): update dependency @types/react to v18.0.28
-- ec50c73: fix: fixed mocked room not working
-- 8e97fb2: Updated dependencies
-- Updated dependencies [78a6119]
-- Updated dependencies [8bf62cb]
-- Updated dependencies [7e52685]
-- Updated dependencies [b1cb325]
-- Updated dependencies [327a6ef]
-- Updated dependencies [8e97fb2]
-    - @pluv/client@0.5.0
-    - @pluv/types@0.1.3
-
-## 0.4.0
-
-### Minor Changes
-
-- 043c915: Added MockedDataProvider from createRoomBundle
-
-### Patch Changes
-
-- 93f8c54: chore(deps): update dependency @types/react to v18.0.27
-- Updated dependencies [595e66f]
-    - @pluv/client@0.4.0
-
-## 0.3.0
-
-### Minor Changes
-
-- 043c915: Added MockedDataProvider from createRoomBundle
-
-### Patch Changes
-
-- 93f8c54: chore(deps): update dependency @types/react to v18.0.27
-- Updated dependencies [595e66f]
-    - @pluv/client@0.3.0
-
-## 0.2.0
-
-### Minor Changes
-
-- 95b5ef8: breaking: update PluvRoom.broadcast api
-
-### Patch Changes
-
-- Updated dependencies [95b5ef8]
-    - @pluv/client@0.2.0
-    - @pluv/types@0.1.2
-
-## 0.1.3
-
-### Patch Changes
-
-- fe80d7b: added preview disclaimer about breaking changes in the readme
-- Updated dependencies [fe80d7b]
-    - @pluv/client@0.1.3
-    - @pluv/types@0.1.2
-
-## 0.1.2
-
-### Patch Changes
-
-- @pluv/client@0.1.2
-
-## 0.1.1
-
-### Patch Changes
-
-- 24016e6: Updated dependencies
-- Updated dependencies [23a7382]
-- Updated dependencies [24016e6]
-    - @pluv/client@0.1.1
-    - @pluv/types@0.1.1
-
-## 0.1.0
-
-### Minor Changes
-
-- a22f525: Added documentation
-
-### Patch Changes
-
-- Updated dependencies [a22f525]
-    - @pluv/client@0.1.0
-    - @pluv/types@0.1.0