add changeset

* add text and badge component

* use button component for links

* add table components

* move inspector button to separate component

* refactor css to use goober

* add changeset

.changeset/big-pens-pull.md

@@ -1,18 +0,0 @@
----
-"jazz-tailwind-demo-auth-starter": patch
-"file-share-svelte": patch
-"jazz-password-manager": patch
-"version-history": patch
-"passkey-svelte": patch
-"chat-rn-clerk": patch
-"jazz-example-music-player": patch
-"passphrase": patch
-"multiauth": patch
-"reactions": patch
-"passkey": patch
-"clerk": patch
-"jazz-example-pets": patch
-"jazz-example-todo": patch
----
-
-Removed when="singedUp" from examples apps' Jazz providers. This is a really niche use-case option and can lead to broken-feeling experiences when anonymous users try to load something.

.changeset/dull-tools-run.md

@@ -1,5 +0,0 @@
----
-"create-jazz-app": patch
----
-
-add directory param to create-jazz-app

.changeset/good-parrots-rhyme.md

@@ -0,0 +1,5 @@
+---
+"multiauth": patch
+---
+
+Use the new Resolve API

.changeset/itchy-turkeys-enjoy.md

@@ -3,4 +3,4 @@
 "jazz-inspector-app": patch
 ---
 
-UI and JSON display improvements
+use goober for css

.changeset/old-countries-dress.md

@@ -0,0 +1,6 @@
+---
+"jazz-inspector": patch
+"jazz-inspector-app": patch
+---
+
+various fixes and css refactoring

.gitignore

@@ -24,4 +24,6 @@ test-results
 
 .vscode/settings.json
 
-.svelte-kit
+.svelte-kit
+
+.idea

.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

.idea/jazz.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/jazz.iml" filepath="$PROJECT_DIR$/.idea/jazz.iml" />
+    </modules>
+  </component>
+</project>

.idea/php.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="MessDetectorOptionsConfiguration">
+    <option name="transferred" value="true" />
+  </component>
+  <component name="PHPCSFixerOptionsConfiguration">
+    <option name="transferred" value="true" />
+  </component>
+  <component name="PHPCodeSnifferOptionsConfiguration">
+    <option name="highlightLevel" value="WARNING" />
+    <option name="transferred" value="true" />
+  </component>
+  <component name="PhpStanOptionsConfiguration">
+    <option name="transferred" value="true" />
+  </component>
+  <component name="PsalmOptionsConfiguration">
+    <option name="transferred" value="true" />
+  </component>
+</project>

.idea/prettier.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PrettierConfiguration">
+    <option name="myConfigurationMode" value="AUTOMATIC" />
+  </component>
+</project>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

examples/chat-rn-clerk/CHANGELOG.md

@@ -1,5 +1,58 @@
 # chat-rn-clerk
 
+## 1.0.91
+
+### Patch Changes
+
+- jazz-react-native@0.12.1
+- jazz-react-native-auth-clerk@0.12.1
+- jazz-tools@0.12.1
+- jazz-react-native-media-images@0.12.1
+
+## 1.0.90
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-react-native@0.12.0
+  - jazz-react-native-auth-clerk@0.12.0
+  - jazz-react-native-media-images@0.12.0
+
+## 1.0.89
+
+### Patch Changes
+
+- jazz-react-native@0.11.8
+- jazz-react-native-auth-clerk@0.11.8
+- jazz-tools@0.11.8
+- jazz-react-native-media-images@0.11.8
+
+## 1.0.88
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-react-native@0.11.7
+  - jazz-react-native-auth-clerk@0.11.7
+  - jazz-react-native-media-images@0.11.7
+
+## 1.0.87
+
+### Patch Changes
+
+- 1bfa9bb: Removed when="singedUp" from examples apps' Jazz providers. This is a really niche use-case option and can lead to broken-feeling experiences when anonymous users try to load something.
+- Updated dependencies [e7c85b7]
+  - jazz-react-native@0.11.6
+  - jazz-tools@0.11.6
+  - jazz-react-native-auth-clerk@0.11.6
+  - jazz-react-native-media-images@0.11.6
+
 ## 1.0.86
 
 ### Patch Changes

examples/chat-rn-clerk/app/chat/[chatId].tsx

@@ -28,7 +28,7 @@ export default function Conversation() {
   const { me } = useAccount();
   const [chat, setChat] = useState<Chat>();
   const [message, setMessage] = useState("");
-  const loadedChat = useCoState(Chat, chat?.id, [{}]);
+  const loadedChat = useCoState(Chat, chat?.id, { resolve: { $each: true } });
   const navigation = useNavigation();
   const [isUploading, setIsUploading] = useState(false);
 
@@ -71,7 +71,7 @@ export default function Conversation() {
 
   const loadChat = async (chatId: ID<Chat>) => {
     try {
-      const chat = await Chat.load(chatId, me, []);
+      const chat = await Chat.load(chatId, me);
       setChat(chat);
     } catch (error) {
       console.log("Error loading chat", error);

examples/chat-rn-clerk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chat-rn-clerk",
   "main": "index.js",
-  "version": "1.0.86",
+  "version": "1.0.91",
   "scripts": {
     "build": "expo export -p ios",
     "start": "expo start",

examples/chat-rn/CHANGELOG.md

@@ -1,5 +1,47 @@
 # chat-rn
 
+## 1.0.87
+
+### Patch Changes
+
+- jazz-react-native@0.12.1
+- jazz-tools@0.12.1
+
+## 1.0.86
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-react-native@0.12.0
+
+## 1.0.85
+
+### Patch Changes
+
+- jazz-react-native@0.11.8
+- jazz-tools@0.11.8
+
+## 1.0.84
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-react-native@0.11.7
+
+## 1.0.83
+
+### Patch Changes
+
+- Updated dependencies [e7c85b7]
+  - jazz-react-native@0.11.6
+  - jazz-tools@0.11.6
+
 ## 1.0.82
 
 ### Patch Changes

examples/chat-rn/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-rn",
-  "version": "1.0.82",
+  "version": "1.0.87",
   "main": "index.js",
   "scripts": {
     "build": "expo export -p ios",

examples/chat-rn/src/chat.tsx

@@ -20,7 +20,7 @@ import { Chat, Message } from "./schema";
 export default function ChatScreen({ navigation }: { navigation: any }) {
   const { me, logOut } = useAccount();
   const [chatId, setChatId] = useState<ID<Chat>>();
-  const loadedChat = useCoState(Chat, chatId, [{}]);
+  const loadedChat = useCoState(Chat, chatId, { resolve: { $each: true } });
   const [message, setMessage] = useState("");
   const profile = useCoState(Profile, me._refs.profile?.id, {});
 

examples/chat-vue/CHANGELOG.md

@@ -1,5 +1,53 @@
 # chat-vue
 
+## 0.0.72
+
+### Patch Changes
+
+- jazz-browser@0.12.1
+- jazz-tools@0.12.1
+- jazz-vue@0.12.1
+
+## 0.0.71
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+- Updated dependencies [4c01459]
+  - jazz-tools@0.12.0
+  - jazz-vue@0.12.0
+  - jazz-browser@0.12.0
+
+## 0.0.70
+
+### Patch Changes
+
+- jazz-browser@0.11.8
+- jazz-tools@0.11.8
+- jazz-vue@0.11.8
+
+## 0.0.69
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-browser@0.11.7
+  - jazz-vue@0.11.7
+
+## 0.0.68
+
+### Patch Changes
+
+- Updated dependencies [e7c85b7]
+  - jazz-tools@0.11.6
+  - jazz-vue@0.11.6
+  - jazz-browser@0.11.6
+
 ## 0.0.67
 
 ### Patch Changes

examples/chat-vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-vue",
-  "version": "0.0.67",
+  "version": "0.0.72",
   "private": true,
   "type": "module",
   "scripts": {

examples/chat-vue/src/views/ChatView.vue

@@ -49,7 +49,7 @@ export default defineComponent({
     },
   },
   setup(props) {
-    const chat = useCoState(Chat, props.chatId, [{}]);
+    const chat = useCoState(Chat, props.chatId, { resolve: { $each: true } });
     const showNLastMessages = ref(30);
 
     const displayedMessages = computed(() => {

examples/chat/CHANGELOG.md

@@ -1,5 +1,60 @@
 # jazz-example-chat
 
+## 0.0.169
+
+### Patch Changes
+
+- jazz-inspector@0.12.1
+- jazz-react@0.12.1
+- jazz-tools@0.12.1
+
+## 0.0.168
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+- Updated dependencies [9a56bb3]
+  - jazz-tools@0.12.0
+  - jazz-inspector@0.12.0
+  - jazz-react@0.12.0
+
+## 0.0.167
+
+### Patch Changes
+
+- Updated dependencies [71b9390]
+  - jazz-inspector@0.11.8
+  - jazz-react@0.11.8
+  - jazz-tools@0.11.8
+
+## 0.0.166
+
+### Patch Changes
+
+- Updated dependencies [2c3761c]
+- Updated dependencies [a140f55]
+- Updated dependencies [4019918]
+- Updated dependencies [2b0d1b0]
+  - jazz-inspector@0.11.7
+  - jazz-tools@0.11.7
+  - jazz-react@0.11.7
+
+## 0.0.165
+
+### Patch Changes
+
+- Updated dependencies [e7c85b7]
+- Updated dependencies [09f0a98]
+- Updated dependencies [11da4d1]
+- Updated dependencies [8ed144e]
+  - jazz-react@0.11.6
+  - jazz-tools@0.11.6
+  - jazz-inspector@0.11.6
+  - jazz-browser-media-images@0.11.6
+
 ## 0.0.164
 
 ### Patch Changes

examples/chat/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-chat",
   "private": true,
-  "version": "0.0.164",
+  "version": "0.0.169",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -15,7 +15,6 @@
   "dependencies": {
     "clsx": "^2.0.0",
     "hash-slash": "workspace:*",
-    "jazz-browser-media-images": "workspace:*",
     "jazz-inspector": "workspace:*",
     "jazz-react": "workspace:*",
     "jazz-tools": "workspace:*",

examples/chat/src/chatScreen.tsx

@@ -1,5 +1,4 @@
-import { createImage } from "jazz-browser-media-images";
-import { useAccount, useCoState } from "jazz-react";
+import { createImage, useAccount, useCoState } from "jazz-react";
 import { Account, ID } from "jazz-tools";
 import { useState } from "react";
 import { Chat, Message } from "./schema.ts";
@@ -17,8 +16,8 @@ import {
 } from "./ui.tsx";
 
 export function ChatScreen(props: { chatID: ID<Chat> }) {
+  const chat = useCoState(Chat, props.chatID, { resolve: { $each: true } });
   const account = useAccount();
-  const chat = useCoState(Chat, props.chatID, [{}]);
   const [showNLastMessages, setShowNLastMessages] = useState(30);
 
   if (!chat)

examples/clerk/CHANGELOG.md

@@ -1,5 +1,54 @@
 # minimal-auth-clerk
 
+## 0.0.68
+
+### Patch Changes
+
+- jazz-react@0.12.1
+- jazz-react-auth-clerk@0.12.1
+- jazz-tools@0.12.1
+
+## 0.0.67
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-react@0.12.0
+  - jazz-react-auth-clerk@0.12.0
+
+## 0.0.66
+
+### Patch Changes
+
+- jazz-react@0.11.8
+- jazz-react-auth-clerk@0.11.8
+- jazz-tools@0.11.8
+
+## 0.0.65
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [4019918]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-react@0.11.7
+  - jazz-react-auth-clerk@0.11.7
+
+## 0.0.64
+
+### Patch Changes
+
+- 1bfa9bb: Removed when="singedUp" from examples apps' Jazz providers. This is a really niche use-case option and can lead to broken-feeling experiences when anonymous users try to load something.
+- Updated dependencies [e7c85b7]
+  - jazz-react@0.11.6
+  - jazz-tools@0.11.6
+  - jazz-react-auth-clerk@0.11.6
+
 ## 0.0.63
 
 ### Patch Changes

examples/clerk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clerk",
   "private": true,
-  "version": "0.0.63",
+  "version": "0.0.68",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -13,7 +13,7 @@
   "dependencies": {
     "@clerk/clerk-react": "^5.4.1",
     "jazz-react": "workspace:*",
-    "jazz-react-auth-clerk": "workspace:0.11.5",
+    "jazz-react-auth-clerk": "workspace:0.12.1",
     "jazz-tools": "workspace:*",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"

examples/file-share-svelte/CHANGELOG.md

@@ -1,5 +1,48 @@
 # file-share-svelte
 
+## 0.0.52
+
+### Patch Changes
+
+- jazz-svelte@0.12.1
+- jazz-tools@0.12.1
+
+## 0.0.51
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-svelte@0.12.0
+
+## 0.0.50
+
+### Patch Changes
+
+- jazz-svelte@0.11.8
+- jazz-tools@0.11.8
+
+## 0.0.49
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-svelte@0.11.7
+
+## 0.0.48
+
+### Patch Changes
+
+- 1bfa9bb: Removed when="singedUp" from examples apps' Jazz providers. This is a really niche use-case option and can lead to broken-feeling experiences when anonymous users try to load something.
+- Updated dependencies [e7c85b7]
+  - jazz-tools@0.11.6
+  - jazz-svelte@0.11.6
+
 ## 0.0.47
 
 ### Patch Changes

examples/file-share-svelte/package.json

@@ -1,6 +1,6 @@
 {
   "name": "file-share-svelte",
-  "version": "0.0.47",
+  "version": "0.0.52",
   "private": true,
   "type": "module",
   "scripts": {

examples/filestream/CHANGELOG.md

@@ -1,5 +1,48 @@
 # jazz-tailwind-demo-auth-starter
 
+## 0.0.8
+
+### Patch Changes
+
+- jazz-react@0.12.1
+- jazz-tools@0.12.1
+
+## 0.0.7
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-react@0.12.0
+
+## 0.0.6
+
+### Patch Changes
+
+- jazz-react@0.11.8
+- jazz-tools@0.11.8
+
+## 0.0.5
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [4019918]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-react@0.11.7
+
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [e7c85b7]
+  - jazz-react@0.11.6
+  - jazz-tools@0.11.6
+
 ## 0.0.3
 
 ### Patch Changes

examples/filestream/package.json

@@ -1,7 +1,7 @@
 {
   "name": "filestream",
   "private": true,
-  "version": "0.0.3",
+  "version": "0.0.8",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/form/CHANGELOG.md

@@ -1,5 +1,50 @@
 # form
 
+## 0.1.10
+
+### Patch Changes
+
+- jazz-react@0.12.1
+- jazz-tools@0.12.1
+
+## 0.1.9
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-react@0.12.0
+
+## 0.1.8
+
+### Patch Changes
+
+- jazz-react@0.11.8
+- jazz-tools@0.11.8
+
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [4019918]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-react@0.11.7
+
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies [e7c85b7]
+- Updated dependencies [8ed144e]
+  - jazz-react@0.11.6
+  - jazz-tools@0.11.6
+  - jazz-browser-media-images@0.11.6
+
 ## 0.1.5
 
 ### Patch Changes

examples/form/package.json

@@ -1,7 +1,7 @@
 {
   "name": "form",
   "private": true,
-  "version": "0.1.5",
+  "version": "0.1.10",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -12,7 +12,6 @@
   },
   "dependencies": {
     "hash-slash": "workspace:*",
-    "jazz-browser-media-images": "workspace:*",
     "jazz-react": "workspace:*",
     "jazz-tools": "workspace:*",
     "react": "^18.3.1",

examples/form/src/CreateOrder.tsx

@@ -12,7 +12,9 @@ import {
 } from "./schema.ts";
 
 export function CreateOrder() {
-  const { me } = useAccount({ root: { draft: {}, orders: [] } });
+  const { me } = useAccount({
+    resolve: { root: { draft: true, orders: true } },
+  });
   const router = useIframeHashRouter();
   const [errors, setErrors] = useState<string[]>([]);
 
@@ -60,7 +62,7 @@ function CreateOrderForm({
   onSave: (draft: DraftBubbleTeaOrder) => void;
 }) {
   const draft = useCoState(DraftBubbleTeaOrder, id, {
-    addOns: [],
+    resolve: { addOns: true },
   });
 
   if (!draft) return;

examples/form/src/DraftIndicator.tsx

@@ -2,7 +2,7 @@ import { useAccount } from "jazz-react";
 
 export function DraftIndicator() {
   const { me } = useAccount({
-    root: { draft: {} },
+    resolve: { root: { draft: true } },
   });
 
   if (me?.root.draft?.hasChanges) {

examples/form/src/EditOrder.tsx

@@ -6,7 +6,7 @@ import { OrderThumbnail } from "./OrderThumbnail.tsx";
 import { BubbleTeaOrder } from "./schema.ts";
 
 export function EditOrder(props: { id: ID<BubbleTeaOrder> }) {
-  const order = useCoState(BubbleTeaOrder, props.id, []);
+  const order = useCoState(BubbleTeaOrder, props.id);
 
   if (!order) return;
 

examples/form/src/Orders.tsx

@@ -4,7 +4,7 @@ import { OrderThumbnail } from "./OrderThumbnail.tsx";
 
 export function Orders() {
   const { me } = useAccount({
-    root: { orders: [] },
+    resolve: { root: { orders: true } },
   });
 
   return (

examples/image-upload/CHANGELOG.md

@@ -1,5 +1,50 @@
 # image-upload
 
+## 0.0.66
+
+### Patch Changes
+
+- jazz-react@0.12.1
+- jazz-tools@0.12.1
+
+## 0.0.65
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-react@0.12.0
+
+## 0.0.64
+
+### Patch Changes
+
+- jazz-react@0.11.8
+- jazz-tools@0.11.8
+
+## 0.0.63
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [4019918]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-react@0.11.7
+
+## 0.0.62
+
+### Patch Changes
+
+- Updated dependencies [e7c85b7]
+- Updated dependencies [8ed144e]
+  - jazz-react@0.11.6
+  - jazz-tools@0.11.6
+  - jazz-browser-media-images@0.11.6
+
 ## 0.0.61
 
 ### Patch Changes

examples/image-upload/package.json

@@ -1,7 +1,7 @@
 {
   "name": "image-upload",
   "private": true,
-  "version": "0.0.61",
+  "version": "0.0.66",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -11,7 +11,6 @@
     "format-and-lint:fix": "biome check . --write"
   },
   "dependencies": {
-    "jazz-browser-media-images": "workspace:*",
     "jazz-react": "workspace:*",
     "jazz-tools": "workspace:*",
     "react": "^18.3.1",
@@ -24,6 +23,9 @@
     "@vitejs/plugin-react": "^4.3.3",
     "globals": "^15.11.0",
     "typescript": "~5.6.2",
-    "vite": "^6.0.11"
+    "vite": "^6.0.11",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.4.27",
+    "tailwindcss": "^3.4.17"
   }
 }

examples/image-upload/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

examples/image-upload/src/App.tsx

@@ -3,7 +3,7 @@ import ImageUpload from "./ImageUpload.tsx";
 function App() {
   return (
     <>
-      <main className="container">
+      <main className="container py-16">
         <ImageUpload />
       </main>
     </>

examples/image-upload/src/ImageUpload.tsx

@@ -1,60 +1,96 @@
-import { createImage } from "jazz-browser-media-images";
-import { ProgressiveImg, useAccount } from "jazz-react";
-import { ImageDefinition } from "jazz-tools";
-import { ChangeEvent, useRef } from "react";
-
-function Image({ image }: { image: ImageDefinition }) {
-  return (
-    <ProgressiveImg image={image}>
-      {({ src }) => <img src={src} />}
-    </ProgressiveImg>
-  );
-}
+import { ProgressiveImg, createImage, useAccount } from "jazz-react";
+import { ChangeEvent, useEffect, useRef, useState } from "react";
 
 export default function ImageUpload() {
   const { me } = useAccount();
-
+  const [imagePreviewUrl, setImagePreviewUrl] = useState<string | null>(null);
   const inputRef = useRef<HTMLInputElement>(null);
 
+  useEffect(() => {
+    const handleBeforeUnload = (e: BeforeUnloadEvent) => {
+      if (imagePreviewUrl) {
+        e.preventDefault();
+        return "Upload in progress. Are you sure you want to leave?";
+      }
+    };
+
+    window.addEventListener("beforeunload", handleBeforeUnload);
+    return () => {
+      window.removeEventListener("beforeunload", handleBeforeUnload);
+
+      if (imagePreviewUrl) {
+        URL.revokeObjectURL(imagePreviewUrl);
+      }
+    };
+  }, [imagePreviewUrl]);
+
   const onImageChange = async (event: ChangeEvent<HTMLInputElement>) => {
     if (!me?.profile) return;
 
     const file = event.currentTarget.files?.[0];
 
     if (file) {
-      me.profile.image = await createImage(file, {
-        owner: me.profile._owner,
-      });
+      const objectUrl = URL.createObjectURL(file);
+      setImagePreviewUrl(objectUrl);
+
+      try {
+        me.profile.image = await createImage(file, {
+          owner: me.profile._owner,
+        });
+      } catch (error) {
+        console.error("Error uploading image:", error);
+      } finally {
+        URL.revokeObjectURL(objectUrl);
+        setImagePreviewUrl(null);
+      }
     }
   };
 
   const deleteImage = () => {
     if (!me?.profile) return;
-
     me.profile.image = null;
   };
 
-  return (
-    <>
-      <div>{me?.profile?.image && <Image image={me.profile.image} />}</div>
+  if (me?.profile?.image) {
+    return (
+      <>
+        <ProgressiveImg image={me.profile.image}>
+          {({ src }) => <img alt="" src={src} className="w-full h-auto" />}
+        </ProgressiveImg>
 
-      <div>
-        {me?.profile?.image ? (
-          <button type="button" onClick={deleteImage}>
-            Delete image
-          </button>
-        ) : (
-          <div>
-            <label>Upload image</label>
-            <input
-              ref={inputRef}
-              type="file"
-              accept="image/png, image/jpeg, image/gif"
-              onChange={onImageChange}
-            />
-          </div>
-        )}
+        <button type="button" onClick={deleteImage} className="mt-5">
+          Delete image
+        </button>
+      </>
+    );
+  }
+
+  if (imagePreviewUrl) {
+    return (
+      <div className="relative">
+        <p className="z-10 absolute font-semibold text-gray-900 inset-0 flex items-center justify-center">
+          Uploading image...
+        </p>
+        <img
+          src={imagePreviewUrl}
+          alt="Preview"
+          className="opacity-50 w-full h-auto"
+        />
       </div>
-    </>
+    );
+  }
+
+  return (
+    <div className="flex flex-col gap-3">
+      <label htmlFor="image">Image</label>
+      <input
+        id="image"
+        name="image"
+        ref={inputRef}
+        type="file"
+        accept="image/png, image/jpeg, image/gif, image/bmp"
+        onChange={onImageChange}
+      />
+    </div>
   );
 }

examples/image-upload/src/index.css

@@ -1,82 +1,3 @@
-:root {
-  font-family: Inter, system-ui, Avenir, Helvetica, Arial, sans-serif;
-  line-height: 1.5;
-  font-weight: 400;
-
-  color-scheme: light dark;
-  color: rgba(255, 255, 255, 0.87);
-  background-color: #242424;
-
-  font-synthesis: none;
-  text-rendering: optimizeLegibility;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-  --border-color: #2f2e2d;
-}
-
-html,
-body,
-#root {
-  height: 100%;
-}
-
-body {
-  margin: 0;
-}
-
-button {
-  border-radius: 8px;
-  border: 0;
-  padding: 0.6em 1.2em;
-  font-weight: 500;
-  background-color: #1a1a1a;
-  cursor: pointer;
-}
-
-@media (prefers-color-scheme: light) {
-  :root {
-    --border-color: #e5e5e5;
-    color: #213547;
-    background-color: #ffffff;
-  }
-
-  a:hover {
-    color: #747bff;
-  }
-
-  button {
-    background-color: #f9f9f9;
-  }
-}
-
-* {
-  border-color: var(--border-color);
-}
-
-header,
-main {
-  padding: 0.5rem 0;
-}
-
-header {
-  border-bottom: 1px solid var(--border-color);
-  margin-bottom: 2rem;
-}
-
-nav {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-}
-
-.container {
-  margin-right: auto;
-  margin-left: auto;
-  padding: 2rem 0.75rem;
-  max-width: 800px;
-}
-
-label {
-  display: block;
-  margin-bottom: 0.25rem;
-}
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

examples/image-upload/tailwind.config.ts

@@ -0,0 +1,18 @@
+import type { Config } from "tailwindcss";
+
+const config: Config = {
+  content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
+  theme: {
+    extend: {
+      container: {
+        center: true,
+        padding: {
+          DEFAULT: "0.75rem",
+          sm: "1rem",
+        },
+      },
+    },
+  },
+} as const;
+
+export default config;

examples/inspector/CHANGELOG.md

@@ -1,5 +1,61 @@
 # jazz-example-inspector
 
+## 0.0.119
+
+### Patch Changes
+
+- Updated dependencies [5a00fe0]
+  - cojson@0.12.1
+  - cojson-transport-ws@0.12.1
+  - jazz-inspector@0.12.1
+
+## 0.0.118
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [01523dc]
+- Updated dependencies [9a56bb3]
+  - cojson@0.12.0
+  - jazz-inspector@0.12.0
+  - cojson-transport-ws@0.12.0
+
+## 0.0.117
+
+### Patch Changes
+
+- Updated dependencies [71b9390]
+- Updated dependencies [6c86c4f]
+- Updated dependencies [9d0c9dc]
+  - jazz-inspector@0.11.8
+  - cojson@0.11.8
+  - cojson-transport-ws@0.11.8
+
+## 0.0.116
+
+### Patch Changes
+
+- 2c3761c: fix: CoFeed and FileStream are showing as CoStream
+- Updated dependencies [2c3761c]
+- Updated dependencies [2b94bc8]
+- Updated dependencies [2957362]
+  - jazz-inspector@0.11.7
+  - cojson@0.11.7
+  - cojson-transport-ws@0.11.7
+
+## 0.0.115
+
+### Patch Changes
+
+- 09f0a98: UI and JSON display improvements
+- 11da4d1: isolate class name hashing on inspector
+- Updated dependencies [09f0a98]
+- Updated dependencies [11da4d1]
+- Updated dependencies [8ed144e]
+  - jazz-inspector@0.11.6
+  - cojson@0.11.6
+  - cojson-transport-ws@0.11.6
+
 ## 0.0.114
 
 ### Patch Changes

examples/inspector/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-inspector-app",
   "private": true,
-  "version": "0.0.114",
+  "version": "0.0.119",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -13,8 +13,8 @@
   "dependencies": {
     "jazz-inspector": "workspace:*",
     "clsx": "^2.0.0",
-    "cojson": "workspace:0.11.5",
-    "cojson-transport-ws": "workspace:0.11.5",
+    "cojson": "workspace:0.12.1",
+    "cojson-transport-ws": "workspace:0.12.1",
     "hash-slash": "workspace:0.2.2",
     "lucide-react": "^0.274.0",
     "react": "^18.3.1",

examples/inspector/src/viewer/new-app.tsx

@@ -12,14 +12,15 @@ import { WasmCrypto } from "cojson/crypto/WasmCrypto";
 import {
   Breadcrumbs,
   Button,
+  GlobalStyles,
   Icon,
   Input,
   PageStack,
   Select,
 } from "jazz-inspector";
+import { resolveCoValue, useResolvedCoValue } from "jazz-inspector";
 import React, { useState, useEffect } from "react";
 import { usePagePath } from "./use-page-path";
-import { resolveCoValue, useResolvedCoValue } from "./use-resolve-covalue";
 
 interface Account {
   id: CoID<RawAccount>;
@@ -126,7 +127,7 @@ export default function CoJsonViewerApp() {
   }
 
   return (
-    <div
+    <GlobalStyles
       className={clsx(
         "h-screen overflow-hidden flex flex-col",
         " text-stone-700 bg-white",
@@ -202,7 +203,7 @@ export default function CoJsonViewerApp() {
           </form>
         )}
       </PageStack>
-    </div>
+    </GlobalStyles>
   );
 }
 
@@ -223,6 +224,7 @@ function AccountSwitcher({
     <div className="relative flex items-stretch gap-1">
       <Select
         label="Account to inspect"
+        hideLabel
         className="label:sr-only max-w-96"
         value={currentAccount?.id || "add-account"}
         onChange={(e) => {
@@ -301,6 +303,7 @@ function AddAccountForm({
         type="password"
         value={secret}
         onChange={(e) => setSecret(e.target.value)}
+        placeholder="sealerSecret_ziz7NA12340abcdef123789..."
       />
       <Button className="mt-3" type="submit">
         Add account

examples/inspector/src/viewer/use-resolve-covalue.ts

@@ -1,216 +0,0 @@
-import { CoID, LocalNode, RawBinaryCoStream, RawCoValue } from "cojson";
-import { useEffect, useState } from "react";
-
-export type CoJsonType = "comap" | "costream" | "colist";
-export type ExtendedCoJsonType = "image" | "record" | "account" | "group";
-
-type JSON = string | number | boolean | null | JSON[] | { [key: string]: JSON };
-type JSONObject = { [key: string]: JSON };
-
-type ResolvedImageDefinition = {
-  originalSize: [number, number];
-  placeholderDataURL?: string;
-  [res: `${number}x${number}`]: RawBinaryCoStream["id"];
-};
-
-// Type guard for browser image
-export const isBrowserImage = (
-  coValue: JSONObject,
-): coValue is ResolvedImageDefinition => {
-  return "originalSize" in coValue && "placeholderDataURL" in coValue;
-};
-
-export type ResolvedGroup = {
-  readKey: string;
-  [key: string]: JSON;
-};
-
-export const isGroup = (coValue: JSONObject): coValue is ResolvedGroup => {
-  return "readKey" in coValue;
-};
-
-export type ResolvedAccount = {
-  profile: {
-    name: string;
-  };
-  [key: string]: JSON;
-};
-
-export const isAccount = (coValue: JSONObject): coValue is ResolvedAccount => {
-  return isGroup(coValue) && "profile" in coValue;
-};
-
-export async function resolveCoValue(
-  coValueId: CoID<RawCoValue>,
-  node: LocalNode,
-): Promise<
-  | {
-      value: RawCoValue;
-      snapshot: JSONObject;
-      type: CoJsonType | null;
-      extendedType: ExtendedCoJsonType | undefined;
-    }
-  | {
-      value: undefined;
-      snapshot: "unavailable";
-      type: null;
-      extendedType: undefined;
-    }
-> {
-  const value = await node.load(coValueId);
-
-  if (value === "unavailable") {
-    return {
-      value: undefined,
-      snapshot: "unavailable",
-      type: null,
-      extendedType: undefined,
-    };
-  }
-
-  const snapshot = value.toJSON() as JSONObject;
-  const type = value.type as CoJsonType;
-
-  // Determine extended type
-  let extendedType: ExtendedCoJsonType | undefined;
-
-  if (type === "comap") {
-    if (isBrowserImage(snapshot)) {
-      extendedType = "image";
-    } else if (isAccount(snapshot)) {
-      extendedType = "account";
-    } else if (isGroup(snapshot)) {
-      extendedType = "group";
-    } else {
-      // This check is a bit of a hack
-      // There might be a better way to do this
-      const children = Object.values(snapshot).slice(0, 10);
-      if (
-        children.every((c) => typeof c === "string" && c.startsWith("co_")) &&
-        children.length > 3
-      ) {
-        extendedType = "record";
-      }
-    }
-  }
-
-  return {
-    value,
-    snapshot,
-    type,
-    extendedType,
-  };
-}
-
-function subscribeToCoValue(
-  coValueId: CoID<RawCoValue>,
-  node: LocalNode,
-  callback: (result: Awaited<ReturnType<typeof resolveCoValue>>) => void,
-) {
-  return node.subscribe(coValueId, (value) => {
-    if (value === "unavailable") {
-      callback({
-        value: undefined,
-        snapshot: "unavailable",
-        type: null,
-        extendedType: undefined,
-      });
-    } else {
-      const snapshot = value.toJSON() as JSONObject;
-      const type = value.type as CoJsonType;
-      let extendedType: ExtendedCoJsonType | undefined;
-
-      if (type === "comap") {
-        if (isBrowserImage(snapshot)) {
-          extendedType = "image";
-        } else if (isAccount(snapshot)) {
-          extendedType = "account";
-        } else if (isGroup(snapshot)) {
-          extendedType = "group";
-        } else {
-          const children = Object.values(snapshot).slice(0, 10);
-          if (
-            children.every(
-              (c) => typeof c === "string" && c.startsWith("co_"),
-            ) &&
-            children.length > 3
-          ) {
-            extendedType = "record";
-          }
-        }
-      }
-
-      callback({
-        value,
-        snapshot,
-        type,
-        extendedType,
-      });
-    }
-  });
-}
-
-export function useResolvedCoValue(
-  coValueId: CoID<RawCoValue>,
-  node: LocalNode,
-) {
-  const [result, setResult] =
-    useState<Awaited<ReturnType<typeof resolveCoValue>>>();
-
-  useEffect(() => {
-    let isMounted = true;
-    const unsubscribe = subscribeToCoValue(coValueId, node, (newResult) => {
-      if (isMounted) {
-        setResult(newResult);
-      }
-    });
-
-    return () => {
-      isMounted = false;
-      unsubscribe();
-    };
-  }, [coValueId, node]);
-
-  return (
-    result || {
-      value: undefined,
-      snapshot: undefined,
-      type: undefined,
-      extendedType: undefined,
-    }
-  );
-}
-
-export function useResolvedCoValues(
-  coValueIds: CoID<RawCoValue>[],
-  node: LocalNode,
-) {
-  const [results, setResults] = useState<
-    Awaited<ReturnType<typeof resolveCoValue>>[]
-  >([]);
-
-  useEffect(() => {
-    let isMounted = true;
-    const unsubscribes: (() => void)[] = [];
-
-    coValueIds.forEach((coValueId, index) => {
-      const unsubscribe = subscribeToCoValue(coValueId, node, (newResult) => {
-        if (isMounted) {
-          setResults((prevResults) => {
-            const newResults = [...prevResults];
-            newResults[index] = newResult;
-            return newResults;
-          });
-        }
-      });
-      unsubscribes.push(unsubscribe);
-    });
-
-    return () => {
-      isMounted = false;
-      unsubscribes.forEach((unsubscribe) => unsubscribe());
-    };
-  }, [coValueIds, node]);
-
-  return results;
-}

examples/multi-cursors/.env

@@ -0,0 +1,3 @@
+VITE_CURSOR_FEED_ID=multi-cursors-250425-1708
+VITE_GROUP_ID=co_zXE8C8sd9QxEbxnt3neRvFRPFUc
+VITE_OLD_CURSOR_AGE_SECONDS=36000

examples/multi-cursors/.env.local.example

@@ -0,0 +1,3 @@
+VITE_CURSOR_FEED_ID=multi-cursors-250425-1708
+VITE_GROUP_ID=co_zXE8C8sd9QxEbxnt3neRvFRPFUc
+VITE_OLD_CURSOR_AGE_SECONDS=5

examples/multi-cursors/.gitignore

@@ -0,0 +1,28 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+/test-results/
+/playwright-report/
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+playwright-report

examples/multi-cursors/CHANGELOG.md

@@ -0,0 +1,36 @@
+# multi-cursors
+
+## 0.0.62
+
+### Patch Changes
+
+- jazz-react@0.12.1
+- jazz-tools@0.12.1
+
+## 0.0.61
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-react@0.12.0
+
+## 0.0.60
+
+### Patch Changes
+
+- jazz-react@0.11.8
+- jazz-tools@0.11.8
+
+## 0.0.59
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [4019918]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-react@0.11.7

examples/multi-cursors/README.md

@@ -0,0 +1,3 @@
+# Multi-cursor example
+
+An example app of using Jazz for showing multiple-cursors on a simple canvas.

examples/multi-cursors/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en" class="h-full">
+
+<head>
+  <meta charset="UTF-8" />
+  <link rel="icon" type="image/png" href="/favicon.ico" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Jazz | Multi-cursors</title>
+</head>
+
+<body class="h-full flex flex-col">
+  <div id="root" class="align-self-center flex-1"></div>
+  <script type="module" src="/src/main.tsx"></script>
+</body>
+
+</html>

examples/multi-cursors/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "multi-cursors",
+  "private": true,
+  "version": "0.0.62",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview",
+    "format-and-lint": "biome check .",
+    "format-and-lint:fix": "biome check . --write",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@react-spring/web": "^9.7.5",
+    "jazz-react": "workspace:*",
+    "jazz-tools": "workspace:*",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "1.9.4",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@vitejs/plugin-react": "^4.3.3",
+    "autoprefixer": "^10.4.20",
+    "globals": "^15.11.0",
+    "is-ci": "^3.0.1",
+    "postcss": "^8.4.27",
+    "tailwindcss": "^3.4.17",
+    "typescript": "~5.6.2",
+    "vite": "^6.0.11",
+    "vitest": "3.0.5"
+  }
+}

examples/multi-cursors/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

examples/multi-cursors/src/App.tsx

@@ -0,0 +1,66 @@
+import { useAccount } from "jazz-react";
+import { Group, type ID } from "jazz-tools";
+import { useEffect, useState } from "react";
+import { Logo } from "./Logo";
+import Container from "./components/Container";
+import { CursorFeed } from "./schema";
+import { getName } from "./utils/getName";
+import { loadCursorContainer } from "./utils/loadCursorContainer";
+
+const cursorFeedIDToLoad = import.meta.env.VITE_CURSOR_FEED_ID;
+const groupIDToLoad = import.meta.env.VITE_GROUP_ID;
+
+function App() {
+  const { me } = useAccount();
+  const [loaded, setLoaded] = useState(false);
+  const [cursorFeedID, setCursorFeedID] = useState<ID<CursorFeed> | null>(null);
+
+  useEffect(() => {
+    console.log("Loading cursor feed...", me.id);
+    if (!me?.id) return;
+    const loadCursorFeed = async () => {
+      const id = await loadCursorContainer(
+        me,
+        cursorFeedIDToLoad as ID<CursorFeed>,
+        groupIDToLoad as ID<Group>,
+      );
+      if (id) {
+        setCursorFeedID(id);
+        setLoaded(true);
+      }
+    };
+    loadCursorFeed();
+  }, [me?.id]);
+
+  return (
+    <>
+      <main className="h-screen">
+        {loaded && cursorFeedID ? (
+          <Container cursorFeedID={cursorFeedID} />
+        ) : (
+          <div>Loading...</div>
+        )}
+      </main>
+
+      <footer className="fixed bottom-4 right-4 flex items-center gap-4">
+        <input
+          type="text"
+          value={getName(me?.profile?.name, me?.sessionID)}
+          onChange={(e) => {
+            if (!me?.profile) return;
+            me.profile.name = e.target.value;
+          }}
+          placeholder="Your name"
+          className="px-2 py-1 rounded border pointer-events-auto"
+          autoComplete="off"
+          maxLength={32}
+        />
+        <div className="pointer-events-none">
+          <Logo />
+        </div>
+      </footer>
+    </>
+  );
+}
+
+export default App;

examples/multi-cursors/src/Logo.tsx

@@ -0,0 +1,21 @@
+export function Logo() {
+  return (
+    <svg
+      viewBox="0 0 386 146"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      className="text-black w-48 mx-auto"
+    >
+      <path
+        d="M176.725 33.865H188.275V22.7H176.725V33.865ZM164.9 129.4H172.875C182.72 129.4 188.275 123.9 188.275 114.22V43.6H176.725V109.545C176.725 115.65 173.975 118.51 167.925 118.51H164.9V129.4ZM245.298 53.28C241.613 45.47 233.363 41.95 222.748 41.95C208.998 41.95 200.748 48.44 197.888 58.615L208.613 61.915C210.648 55.315 216.368 52.565 222.638 52.565C231.933 52.565 235.673 56.415 236.058 64.61C226.433 65.93 216.643 67.195 209.768 69.23C200.583 72.145 195.743 77.865 195.743 86.83C195.743 96.51 202.673 104.65 215.818 104.65C225.443 104.65 232.318 101.35 237.213 94.365V103H247.388V66.425C247.388 61.475 247.168 57.185 245.298 53.28ZM217.853 95.245C210.483 95.245 207.128 91.34 207.128 86.72C207.128 82.045 210.593 79.515 215.323 77.92C220.328 76.435 226.983 75.5 235.948 74.18C235.893 76.93 235.673 80.725 234.738 83.475C233.418 89.25 227.643 95.245 217.853 95.245ZM251.22 103H301.545V92.715H269.535L303.195 45.47V43.6H254.3V53.885H284.935L251.22 101.185V103ZM304.815 103H355.14V92.715H323.13L356.79 45.47V43.6H307.895V53.885H338.53L304.815 101.185V103Z"
+        fill="currentColor"
+      />
+      <path
+        fillRule="evenodd"
+        clipRule="evenodd"
+        d="M136.179 44.8277C136.179 44.8277 136.179 44.8277 136.179 44.8276V21.168C117.931 28.5527 97.9854 32.6192 77.0897 32.6192C65.1466 32.6192 53.5138 31.2908 42.331 28.7737V51.4076C42.331 51.4076 42.331 51.4076 42.331 51.4076V81.1508C41.2955 80.4385 40.1568 79.8458 38.9405 79.3915C36.1732 78.358 33.128 78.0876 30.1902 78.6145C27.2524 79.1414 24.5539 80.4419 22.4358 82.3516C20.3178 84.2613 18.8754 86.6944 18.291 89.3433C17.7066 91.9921 18.0066 94.7377 19.1528 97.2329C20.2991 99.728 22.2403 101.861 24.7308 103.361C27.2214 104.862 30.1495 105.662 33.1448 105.662H33.1455C33.6061 105.662 33.8365 105.662 34.0314 105.659C44.5583 105.449 53.042 96.9656 53.2513 86.4386C53.2534 86.3306 53.2544 86.2116 53.2548 86.0486H53.2552V85.7149L53.2552 85.5521V82.0762L53.2552 53.1993C61.0533 54.2324 69.0092 54.7656 77.0897 54.7656C77.6696 54.7656 78.2489 54.7629 78.8276 54.7574V110.696C77.792 109.983 76.6533 109.391 75.437 108.936C72.6697 107.903 69.6246 107.632 66.6867 108.159C63.7489 108.686 61.0504 109.987 58.9323 111.896C56.8143 113.806 55.3719 116.239 54.7875 118.888C54.2032 121.537 54.5031 124.283 55.6494 126.778C56.7956 129.273 58.7368 131.405 61.2273 132.906C63.7179 134.406 66.646 135.207 69.6414 135.207C70.1024 135.207 70.3329 135.207 70.5279 135.203C81.0548 134.994 89.5385 126.51 89.7478 115.983C89.7517 115.788 89.7517 115.558 89.7517 115.097V111.621L89.7517 54.3266C101.962 53.4768 113.837 51.4075 125.255 48.2397V80.9017C124.219 80.1894 123.081 79.5966 121.864 79.1424C119.097 78.1089 116.052 77.8384 113.114 78.3653C110.176 78.8922 107.478 80.1927 105.36 82.1025C103.242 84.0122 101.799 86.4453 101.215 89.0941C100.631 91.743 100.931 94.4886 102.077 96.9837C103.223 99.4789 105.164 101.612 107.655 103.112C110.145 104.612 113.073 105.413 116.069 105.413C116.53 105.413 116.76 105.413 116.955 105.409C127.482 105.2 135.966 96.7164 136.175 86.1895C136.179 85.9945 136.179 85.764 136.179 85.3029V81.8271L136.179 44.8277Z"
+        fill="#3313F7"
+      />
+    </svg>
+  );
+}

examples/multi-cursors/src/apiKey.ts

@@ -0,0 +1 @@
+export const apiKey = "jazz-multi-cursors@garden.co";

examples/multi-cursors/src/components/Boundary.tsx

@@ -0,0 +1,16 @@
+import { ViewBox } from "../types";
+
+export function Boundary({ bounds }: { bounds: ViewBox }) {
+  return (
+    <>
+      <rect
+        x={bounds.x}
+        y={bounds.y}
+        width={bounds.width}
+        height={bounds.height}
+        stroke="red"
+        fill="none"
+      />
+    </>
+  );
+}

examples/multi-cursors/src/components/Canvas.tsx

@@ -0,0 +1,102 @@
+import { useAccount } from "jazz-react";
+import { CoFeedEntry, co } from "jazz-tools";
+import { CursorMoveEvent, useCanvas } from "../hooks/useCanvas";
+import { Cursor as CursorType, ViewBox } from "../types";
+import { centerOfBounds } from "../utils/centerOfBounds";
+import { getColor } from "../utils/getColor";
+import { getName } from "../utils/getName";
+import { Boundary } from "./Boundary";
+import { CanvasBackground } from "./CanvasBackground";
+import { CanvasDemoContent } from "./CanvasDemoContent";
+import { Cursor } from "./Cursor";
+
+const OLD_CURSOR_AGE_SECONDS = Number(
+  import.meta.env.VITE_OLD_CURSOR_AGE_SECONDS,
+);
+
+const DEBUG = import.meta.env.VITE_DEBUG === "true";
+
+// For debugging purposes, we can set a fixed bounds
+const debugBounds: ViewBox = {
+  x: 320,
+  y: 320,
+  width: 640,
+  height: 640,
+};
+
+interface CanvasProps {
+  remoteCursors: CoFeedEntry<co<CursorType>>[];
+  onCursorMove: (move: CursorMoveEvent) => void;
+  name: string;
+}
+
+function Canvas({ remoteCursors, onCursorMove, name }: CanvasProps) {
+  const { me } = useAccount();
+
+  const {
+    svgProps,
+    isDragging,
+    isMouseOver,
+    mousePosition,
+    bgPosition,
+    dottedGridSize,
+    viewBox,
+  } = useCanvas({ onCursorMove });
+
+  const bounds = DEBUG ? debugBounds : viewBox;
+  const center = centerOfBounds(bounds);
+
+  return (
+    <svg width="100%" height="100%" {...svgProps}>
+      <CanvasBackground
+        bgPosition={bgPosition}
+        dottedGridSize={dottedGridSize}
+      />
+
+      <CanvasDemoContent />
+      {DEBUG && <Boundary bounds={bounds} />}
+
+      {remoteCursors.map((entry) => {
+        if (
+          entry.tx.sessionID === me?.sessionID ||
+          (OLD_CURSOR_AGE_SECONDS &&
+            entry.madeAt < new Date(Date.now() - 1000 * OLD_CURSOR_AGE_SECONDS))
+        ) {
+          return null;
+        }
+
+        const name = getName(entry.by?.profile?.name, entry.tx.sessionID);
+        const color = getColor(entry.tx.sessionID);
+        const age = new Date().getTime() - new Date(entry.madeAt).getTime();
+
+        return (
+          <Cursor
+            key={entry.tx.sessionID}
+            position={entry.value.position}
+            color={color}
+            isDragging={false}
+            isRemote={true}
+            name={name}
+            age={age}
+            centerOfBounds={center}
+            bounds={bounds}
+          />
+        );
+      })}
+
+      {isMouseOver ? (
+        <Cursor
+          position={mousePosition}
+          color="#FF69B4"
+          isDragging={isDragging}
+          isRemote={false}
+          name={name}
+          centerOfBounds={center}
+          bounds={bounds}
+        />
+      ) : null}
+    </svg>
+  );
+}
+
+export default Canvas;

examples/multi-cursors/src/components/CanvasBackground.tsx

@@ -0,0 +1,33 @@
+interface CanvasBackgroundProps {
+  bgPosition: { x: number; y: number };
+  dottedGridSize: number;
+}
+
+export function CanvasBackground({
+  bgPosition,
+  dottedGridSize,
+}: CanvasBackgroundProps) {
+  const bgProps = { x: "-10000", y: "-10000", width: "20000", height: "20000" };
+
+  return (
+    <>
+      <defs>
+        <pattern
+          id="dottedGrid"
+          width={dottedGridSize}
+          height={dottedGridSize}
+          patternUnits="userSpaceOnUse"
+          patternContentUnits="userSpaceOnUse"
+        >
+          <circle cx="20" cy="20" r="2" fill="oklch(0.923 0.003 48.717)" />
+        </pattern>
+      </defs>
+
+      {/* backgrounds using translate to appear infinite by moving it to visible area */}
+      <g transform={`translate(${bgPosition.x}, ${bgPosition.y})`}>
+        <rect {...bgProps} fill="oklch(0.97 0.001 106.424)" />
+        <rect {...bgProps} fill="url(#dottedGrid)" />
+      </g>
+    </>
+  );
+}

examples/multi-cursors/src/components/CanvasDemoContent.tsx

@@ -0,0 +1,19 @@
+export function CanvasDemoContent() {
+  return (
+    <>
+      <circle cx={0} cy={0} r="200" fill="oklch(0.985 0.001 106.423)" />
+
+      <text
+        x={0}
+        y={0}
+        textAnchor="middle"
+        dominantBaseline="middle"
+        fontSize="32"
+        fontFamily="ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace"
+        fill="#3318F7"
+      >
+        Hello, World!
+      </text>
+    </>
+  );
+}

examples/multi-cursors/src/components/Container.tsx

@@ -0,0 +1,30 @@
+import { useAccount, useCoState } from "jazz-react";
+import { ID } from "jazz-tools";
+import { CursorFeed } from "../schema";
+import { getName } from "../utils/getName";
+import Canvas from "./Canvas";
+
+/** A higher order component that wraps the canvas. */
+function Container({ cursorFeedID }: { cursorFeedID: ID<CursorFeed> }) {
+  const { me } = useAccount();
+  const cursors = useCoState(CursorFeed, cursorFeedID, { resolve: true });
+
+  return (
+    <Canvas
+      onCursorMove={(move) => {
+        if (!(cursors && me)) return;
+
+        cursors.push({
+          position: {
+            x: move.position.x,
+            y: move.position.y,
+          },
+        });
+      }}
+      remoteCursors={Object.values(cursors?.perSession ?? {})}
+      name={getName(me?.profile?.name, me?.sessionID)}
+    />
+  );
+}
+
+export default Container;

examples/multi-cursors/src/components/Cursor.tsx

@@ -0,0 +1,141 @@
+import { animated, to, useSpring } from "@react-spring/web";
+import { Vec2, ViewBox } from "../types";
+import { calculateBoundaryIntersection } from "../utils/boundaryIntersection";
+import { isOutOfBounds } from "../utils/isOutOfBounds";
+import { CursorLabel } from "./CursorLabel";
+
+interface CursorProps {
+  position: { x: number; y: number };
+  color: string;
+  isDragging: boolean;
+  isRemote: boolean;
+  name: string;
+  age?: number;
+  centerOfBounds: Vec2;
+  bounds?: ViewBox;
+}
+
+const LABEL_BOUNDS_PADDING = 32;
+const CURSOR_VISIBILITY_OFFSET = 20;
+
+export function Cursor({
+  position,
+  color,
+  isDragging,
+  isRemote,
+  name,
+  age = 0,
+  centerOfBounds,
+  bounds,
+}: CursorProps) {
+  if (!bounds) return null;
+
+  const intersectionPoint = calculateBoundaryIntersection(
+    centerOfBounds,
+    position,
+    bounds,
+  );
+
+  const labelBounds = {
+    x: bounds.x + LABEL_BOUNDS_PADDING / 2,
+    y: bounds.y + LABEL_BOUNDS_PADDING / 2,
+    width: bounds.width - LABEL_BOUNDS_PADDING,
+    height: bounds.height - LABEL_BOUNDS_PADDING,
+  };
+
+  const cursorIntersectionPoint = calculateBoundaryIntersection(
+    centerOfBounds,
+    position,
+    labelBounds,
+  );
+
+  const isStrictlyOutOfBounds = isOutOfBounds(position, bounds);
+  const shouldHideCursor = isOutOfBounds(
+    position,
+    bounds,
+    CURSOR_VISIBILITY_OFFSET,
+  );
+
+  const springs = useSpring({
+    x: position.x,
+    y: position.y,
+    opacity: age > 60000 ? 0 : 1,
+    immediate: !isRemote,
+    config: {
+      tension: 170,
+      friction: 26,
+    },
+  });
+
+  const intersectionSprings = useSpring({
+    x: intersectionPoint.x,
+    y: intersectionPoint.y,
+    config: {
+      tension: 170,
+      friction: 26,
+    },
+  });
+
+  return (
+    <>
+      <animated.g
+        transform={to(
+          [springs.x, springs.y],
+          (x: number, y: number) => `translate(${x}, ${y})`,
+        )}
+      >
+        {isStrictlyOutOfBounds ? (
+          <circle cx={0} cy={0} r={4} fill={color} />
+        ) : null}
+        {!shouldHideCursor ? (
+          <polygon
+            points="0,0 0,20 14.3,14.3"
+            fill={
+              isDragging
+                ? color
+                : `color-mix(in oklch, ${color}, transparent 56%)`
+            }
+            stroke={color}
+            strokeWidth="3"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+        ) : null}
+      </animated.g>
+
+      {isRemote ? (
+        <>
+          <CursorLabel
+            name={name}
+            color={color}
+            position={cursorIntersectionPoint}
+            bounds={bounds}
+            isOutOfBounds={isStrictlyOutOfBounds}
+          />
+          {isStrictlyOutOfBounds ? (
+            <animated.g
+              transform={to(
+                [intersectionSprings.x, intersectionSprings.y],
+                (x: number, y: number) => {
+                  const angle =
+                    Math.atan2(centerOfBounds.y - y, centerOfBounds.x - x) *
+                    (180 / Math.PI);
+                  return `translate(${x}, ${y}) rotate(${angle})`;
+                },
+              )}
+            >
+              <path
+                d="M 8,-4 L 2,0 L 8,4"
+                fill="none"
+                stroke={color}
+                strokeWidth="3"
+                strokeLinecap="round"
+                strokeLinejoin="round"
+              />
+            </animated.g>
+          ) : null}
+        </>
+      ) : null}
+    </>
+  );
+}

examples/multi-cursors/src/components/CursorLabel.tsx

@@ -0,0 +1,93 @@
+import { animated, to, useSpring } from "@react-spring/web";
+import { useEffect, useRef, useState } from "react";
+import { Vec2, ViewBox } from "../types";
+import { getLabelPosition } from "../utils/getLabelPosition";
+
+const DEBUG = import.meta.env.VITE_DEBUG === "true";
+
+interface CursorLabelProps {
+  name: string;
+  color: string;
+  position: Vec2;
+  bounds?: ViewBox;
+  isOutOfBounds?: boolean;
+}
+
+interface TextDimensions {
+  width: number;
+  height: number;
+}
+
+export function CursorLabel({
+  name,
+  color,
+  position,
+  bounds,
+  isOutOfBounds,
+}: CursorLabelProps) {
+  const textRef = useRef<SVGTextElement>(null);
+  const [dimensions, setDimensions] = useState<TextDimensions>({
+    width: 0,
+    height: 0,
+  });
+
+  useEffect(() => {
+    const bbox = textRef.current?.getBBox();
+    setDimensions({ width: bbox?.width ?? 0, height: bbox?.height ?? 0 });
+  }, [name]);
+
+  const labelPosition = getLabelPosition(
+    position,
+    dimensions,
+    bounds,
+    isOutOfBounds,
+  );
+  const labelSprings = useSpring<Vec2>({
+    ...labelPosition,
+    config: {
+      tension: 170,
+      friction: 26,
+    },
+  });
+
+  return (
+    <>
+      <animated.text
+        ref={textRef}
+        x={to([labelSprings.x], (x) => x)}
+        y={to([labelSprings.y], (y) => y)}
+        fill={color}
+        stroke="white"
+        strokeWidth="3"
+        strokeLinejoin="round"
+        paintOrder="stroke"
+        fontSize="14"
+        dominantBaseline="hanging"
+        textAnchor="start"
+      >
+        {name}
+      </animated.text>
+      {DEBUG ? (
+        <>
+          <text x={position.x} y={position.y} fill="red" fontSize="8">
+            {position.x}, {position.y}
+          </text>
+          <text x={labelPosition.x} y={labelPosition.y} fill="red" fontSize="8">
+            {bounds
+              ? `${bounds.x - labelPosition.x}, ${bounds.y - labelPosition.y}`
+              : "no bounds"}
+          </text>
+          <line
+            x1={position.x}
+            y1={position.y}
+            x2={labelPosition.x}
+            y2={labelPosition.y}
+            stroke="red"
+            strokeWidth="1"
+            strokeLinejoin="round"
+          />
+        </>
+      ) : null}
+    </>
+  );
+}

examples/multi-cursors/src/hooks/useCanvas.ts

@@ -0,0 +1,140 @@
+import { useCallback, useEffect, useState } from "react";
+import type { ViewBox } from "../types";
+import { throttleTime } from "../utils/throttleTime";
+
+export interface CursorMoveEvent {
+  position: { x: number; y: number };
+  isDragging: boolean;
+}
+
+export function useCanvas({
+  onCursorMove,
+  throttleMs = 100,
+}: {
+  onCursorMove: (event: CursorMoveEvent) => void;
+  throttleMs?: number;
+}) {
+  const [viewBox, setViewBox] = useState<ViewBox>({
+    x: 0,
+    y: 0,
+    width: window.innerWidth,
+    height: window.innerHeight,
+  });
+  const [isDragging, setIsDragging] = useState(false);
+  const [isMouseOver, setIsMouseOver] = useState(false);
+  const [dragStart, setDragStart] = useState({ x: 0, y: 0 });
+  const [mousePosition, setMousePosition] = useState({ x: 0, y: 0 });
+
+  const onCursorMoveThrottled = useCallback(
+    throttleTime((move: CursorMoveEvent) => onCursorMove(move), throttleMs),
+    [onCursorMove, throttleMs],
+  );
+
+  useEffect(() => {
+    const handleResize = () => {
+      setViewBox((prev) => ({
+        ...prev,
+        width: window.innerWidth,
+        height: window.innerHeight,
+      }));
+    };
+
+    setViewBox((prev) => ({
+      ...prev,
+      x: -window.innerWidth / 2,
+      y: -window.innerHeight / 2,
+    }));
+
+    window.addEventListener("resize", handleResize);
+    return () => window.removeEventListener("resize", handleResize);
+  }, []);
+
+  const handleMouseDown = (e: React.MouseEvent<SVGSVGElement>) => {
+    setIsDragging(true);
+    setDragStart({
+      x: e.clientX,
+      y: e.clientY,
+    });
+
+    onCursorMoveThrottled({
+      position: mousePosition,
+      isDragging: true,
+    });
+  };
+  const handleMouseUp = () => {
+    setIsDragging(false);
+
+    onCursorMoveThrottled({
+      position: mousePosition,
+      isDragging: false,
+    });
+  };
+  const handleMouseEnter = () => setIsMouseOver(true);
+  const handleMouseLeave = () => {
+    setIsMouseOver(false);
+    setIsDragging(false);
+
+    onCursorMoveThrottled({
+      position: mousePosition,
+      isDragging: false,
+    });
+  };
+
+  const handleMouseMove = (e: React.MouseEvent<SVGSVGElement>) => {
+    const svg = e.currentTarget;
+    const ctm = svg.getScreenCTM();
+
+    if (!ctm) throw new Error("can't get SVG screen CTM");
+
+    const point = svg.createSVGPoint();
+    point.x = e.clientX;
+    point.y = e.clientY;
+    const svgPoint = point.matrixTransform(ctm.inverse());
+
+    setMousePosition(svgPoint);
+
+    onCursorMoveThrottled({
+      position: svgPoint,
+      isDragging,
+    });
+
+    if (!isDragging) return;
+
+    const dx = e.clientX - dragStart.x;
+    const dy = e.clientY - dragStart.y;
+
+    setViewBox((prev) => ({ ...prev, x: prev.x - dx, y: prev.y - dy }));
+    setDragStart({ x: e.clientX, y: e.clientY });
+  };
+
+  const dottedGridSize = 40;
+
+  const bgPosition = {
+    x: Math.floor(viewBox.x / dottedGridSize) * dottedGridSize,
+    y: Math.floor(viewBox.y / dottedGridSize) * dottedGridSize,
+  };
+
+  const handlers = {
+    onMouseDown: handleMouseDown,
+    onMouseUp: handleMouseUp,
+    onMouseEnter: handleMouseEnter,
+    onMouseLeave: handleMouseLeave,
+    onMouseMove: handleMouseMove,
+  };
+
+  const svgProps: React.SVGProps<SVGSVGElement> = {
+    ...handlers,
+    viewBox: `${viewBox.x} ${viewBox.y} ${viewBox.width} ${viewBox.height}`,
+    className: "select-none cursor-none",
+  };
+
+  return {
+    svgProps,
+    isDragging,
+    isMouseOver,
+    mousePosition,
+    bgPosition,
+    dottedGridSize,
+    viewBox,
+  };
+}

examples/multi-cursors/src/index.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

examples/multi-cursors/src/main.tsx

@@ -0,0 +1,27 @@
+import { JazzProvider } from "jazz-react";
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import App from "./App.tsx";
+import "./index.css";
+import { apiKey } from "./apiKey.ts";
+import { CursorAccount } from "./schema.ts";
+
+declare module "jazz-react" {
+  export interface Register {
+    Account: CursorAccount;
+  }
+}
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <JazzProvider
+      sync={{
+        peer: `wss://cloud.jazz.tools/?key=${apiKey}`,
+        when: "always",
+      }}
+      AccountSchema={CursorAccount}
+    >
+      <App />
+    </JazzProvider>
+  </StrictMode>,
+);

examples/multi-cursors/src/schema.ts

@@ -0,0 +1,51 @@
+import { Account, CoFeed, CoMap, Group, Profile, co } from "jazz-tools";
+import type { Camera, Cursor } from "./types";
+
+export class CursorFeed extends CoFeed.Of(co.json<Cursor>()) {}
+
+export class CursorProfile extends Profile {
+  name = co.string;
+}
+
+export class CursorRoot extends CoMap {
+  camera = co.json<Camera>();
+  cursors = co.ref(CursorFeed);
+}
+
+export class CursorContainer extends CoMap {
+  cursorFeed = co.ref(CursorFeed);
+}
+
+export class CursorAccount extends Account {
+  profile = co.ref(CursorProfile);
+  root = co.ref(CursorRoot);
+
+  /** The account migration is run on account creation and on every log-in.
+   *  You can use it to set up the account root and any other initial CoValues you need.
+   */
+  migrate(this: CursorAccount) {
+    if (this.root === undefined) {
+      this.root = CursorRoot.create({
+        camera: {
+          position: {
+            x: 0,
+            y: 0,
+          },
+        },
+        cursors: CursorFeed.create([]),
+      });
+    }
+
+    if (this.profile === undefined) {
+      const group = Group.create();
+      group.addMember("everyone", "reader"); // The profile info is visible to everyone
+
+      this.profile = CursorProfile.create(
+        {
+          name: "Anonymous user",
+        },
+        group,
+      );
+    }
+  }
+}

examples/multi-cursors/src/types.d.ts

@@ -0,0 +1,27 @@
+export type Vec2 = {
+  x: number;
+  y: number;
+};
+
+export type Cursor = {
+  position: Vec2;
+};
+
+export type Camera = {
+  position: Vec2;
+};
+
+export type RemoteCursor = Cursor & {
+  id: ID;
+  color: string;
+  name: string;
+  isRemote: true;
+  isDragging: boolean;
+};
+
+export type ViewBox = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};

examples/multi-cursors/src/utils/__tests__/boundaryIntersection.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { calculateBoundaryIntersection } from "../boundaryIntersection";
+
+describe("calculateBoundaryIntersection", () => {
+  const bounds = { x: 0, y: 0, width: 100, height: 100 };
+
+  it("should handle vertical lines (dx = 0)", () => {
+    const center = { x: 50, y: 50 };
+    const point = { x: 50, y: 150 }; // Straight up from center
+
+    const intersection = calculateBoundaryIntersection(center, point, bounds);
+
+    expect(intersection).toEqual({ x: 50, y: 100 }); // Should intersect at bottom boundary
+  });
+
+  it("should handle horizontal lines (dy = 0)", () => {
+    const center = { x: 50, y: 50 };
+    const point = { x: 150, y: 50 }; // Straight right from center
+
+    const intersection = calculateBoundaryIntersection(center, point, bounds);
+
+    expect(intersection).toEqual({ x: 100, y: 50 }); // Should intersect at right boundary
+  });
+
+  it("should handle vertical lines at boundaries", () => {
+    const center = { x: 0, y: 50 };
+    const point = { x: 0, y: 150 }; // Vertical line at x=0
+
+    const intersection = calculateBoundaryIntersection(center, point, bounds);
+
+    expect(intersection).toEqual({ x: 0, y: 100 }); // Should intersect at bottom boundary
+  });
+
+  it("should handle horizontal lines at boundaries", () => {
+    const center = { x: 50, y: 0 };
+    const point = { x: 150, y: 0 }; // Horizontal line at y=0
+
+    const intersection = calculateBoundaryIntersection(center, point, bounds);
+
+    expect(intersection).toEqual({ x: 100, y: 0 }); // Should intersect at right boundary
+  });
+});

examples/multi-cursors/src/utils/__tests__/getLabelPosition.test.ts

@@ -0,0 +1,61 @@
+import { describe, expect, it } from "vitest";
+import { getLabelPosition } from "../getLabelPosition";
+
+describe("getLabelPosition", () => {
+  const dimensions = { width: 100, height: 20 };
+  const bounds = { x: 0, y: 0, width: 1000, height: 1000 };
+
+  it("should position label with default offset when cursor is in bounds", () => {
+    const position = { x: 500, y: 500 };
+    const result = getLabelPosition(position, dimensions, bounds, false);
+
+    expect(result).toEqual({
+      x: position.x + 15,
+      y: position.y + 25,
+    });
+  });
+
+  it("should position label with default offset when bounds are undefined", () => {
+    const position = { x: 500, y: 500 };
+    const result = getLabelPosition(position, dimensions, undefined, true);
+
+    expect(result).toEqual({
+      x: position.x + 15,
+      y: position.y + 25,
+    });
+  });
+
+  it("should adjust label position based on cursor position when out of bounds", () => {
+    const position = { x: 800, y: 600 };
+    const result = getLabelPosition(position, dimensions, bounds, true);
+
+    // At x=800, percentageH = 0.8, so x offset should be -80 (0.8 * width)
+    // At y=600, percentageV = 0.6, so y offset should be -12 (0.6 * height)
+    expect(result).toEqual({
+      x: position.x - 0.8 * dimensions.width,
+      y: position.y - 0.6 * dimensions.height,
+    });
+  });
+
+  it("should handle cursor at bounds edges", () => {
+    const position = { x: 1000, y: 1000 }; // Bottom-right corner
+    const result = getLabelPosition(position, dimensions, bounds, true);
+
+    // At the edges, percentages should be 1, so full dimension should be subtracted
+    expect(result).toEqual({
+      x: position.x - dimensions.width,
+      y: position.y - dimensions.height,
+    });
+  });
+
+  it("should handle cursor at bounds origin", () => {
+    const position = { x: 0, y: 0 }; // Top-left corner
+    const result = getLabelPosition(position, dimensions, bounds, true);
+
+    // At origin, percentages should be 0, so no offset from position
+    expect(result).toEqual({
+      x: position.x,
+      y: position.y,
+    });
+  });
+});

examples/multi-cursors/src/utils/__tests__/isOutOfBounds.test.ts

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { isOutOfBounds } from "../isOutOfBounds";
+
+describe("isOutOfBounds", () => {
+  it("should return true if the position is out of bounds", () => {
+    expect(
+      isOutOfBounds(
+        { x: 101, y: 101 },
+        { x: 0, y: 0, width: 100, height: 100 },
+      ),
+    ).toBe(true);
+  });
+
+  it("should return false if the position is within bounds", () => {
+    expect(
+      isOutOfBounds({ x: 50, y: 50 }, { x: 0, y: 0, width: 100, height: 100 }),
+    ).toBe(false);
+  });
+
+  it("should return false if the position is inside the grace area", () => {
+    expect(
+      isOutOfBounds(
+        { x: 110, y: 110 },
+        { x: 0, y: 0, width: 100, height: 100 },
+        20,
+      ),
+    ).toBe(false);
+  });
+});

examples/multi-cursors/src/utils/boundaryIntersection.ts

@@ -0,0 +1,77 @@
+import { Vec2, ViewBox } from "../types";
+
+/**
+ * Calculate the intersection point of a line and a boundary.
+ * @param center - The origin of the line.
+ * @param point - The end of the line to calculate the intersection for.
+ * @param bounds - The bounds of the boundary.
+ * @returns The intersection point.
+ */
+export function calculateBoundaryIntersection(
+  center: Vec2,
+  point: Vec2,
+  bounds: ViewBox,
+): Vec2 {
+  // Calculate direction vector
+  const dx = point.x - center.x;
+  const dy = point.y - center.y;
+
+  // Calculate all possible intersections
+  let horizontalIntersection: Vec2 | null = null;
+  let verticalIntersection: Vec2 | null = null;
+
+  // Check horizontal bounds
+  if (dx !== 0) {
+    // Skip horizontal bounds check if line is vertical
+    if (point.x < bounds.x) {
+      const y = center.y + (dy * (bounds.x - center.x)) / dx;
+      if (y >= bounds.y && y <= bounds.y + bounds.height) {
+        horizontalIntersection = { x: bounds.x, y };
+      }
+    } else if (point.x > bounds.x + bounds.width) {
+      const y = center.y + (dy * (bounds.x + bounds.width - center.x)) / dx;
+      if (y >= bounds.y && y <= bounds.y + bounds.height) {
+        horizontalIntersection = { x: bounds.x + bounds.width, y };
+      }
+    }
+  }
+
+  // Check vertical bounds
+  if (dy !== 0) {
+    // Skip vertical bounds check if line is horizontal
+    if (point.y < bounds.y) {
+      const x = center.x + (dx * (bounds.y - center.y)) / dy;
+      if (x >= bounds.x && x <= bounds.x + bounds.width) {
+        verticalIntersection = { x, y: bounds.y };
+      }
+    } else if (point.y > bounds.y + bounds.height) {
+      const x = center.x + (dx * (bounds.y + bounds.height - center.y)) / dy;
+      if (x >= bounds.x && x <= bounds.x + bounds.width) {
+        verticalIntersection = { x, y: bounds.y + bounds.height };
+      }
+    }
+  }
+
+  // Choose the intersection point that's closest to the actual point
+  if (horizontalIntersection && verticalIntersection) {
+    const horizontalDist = Math.hypot(
+      point.x - horizontalIntersection.x,
+      point.y - horizontalIntersection.y,
+    );
+    const verticalDist = Math.hypot(
+      point.x - verticalIntersection.x,
+      point.y - verticalIntersection.y,
+    );
+    return horizontalDist < verticalDist
+      ? horizontalIntersection
+      : verticalIntersection;
+  }
+
+  return (
+    horizontalIntersection ||
+    verticalIntersection || {
+      x: Math.max(bounds.x, Math.min(bounds.x + bounds.width, point.x)),
+      y: Math.max(bounds.y, Math.min(bounds.y + bounds.height, point.y)),
+    }
+  );
+}

examples/multi-cursors/src/utils/centerOfBounds.ts

@@ -0,0 +1,17 @@
+import { Vec2, ViewBox } from "../types";
+
+/**
+ * Get the center of a bounds.
+ * @param bounds - The bounds to get the center of.
+ * @returns The center of the bounds.
+ */
+export function centerOfBounds(bounds?: ViewBox): Vec2 {
+  if (!bounds) {
+    return { x: 0, y: 0 };
+  }
+
+  return {
+    x: bounds.x + bounds.width / 2,
+    y: bounds.y + bounds.height / 2,
+  };
+}

examples/multi-cursors/src/utils/getColor.ts

@@ -0,0 +1,29 @@
+/**
+ * Converts a string (like a coID) to a consistent color with controlled brightness
+ * Uses Oklch color model for better perceptual uniformity
+ * @param str - The string to convert to a color (typically a coID)
+ * @returns An Oklch color string
+ */
+export const getColor = (str: string): string => {
+  // Simple hash function to get a number from a string
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    hash = str.charCodeAt(i) + ((hash << 5) - hash);
+  }
+
+  // Convert to a positive number
+  hash = Math.abs(hash);
+
+  // Use the hash to determine the hue (0-360)
+  // This spreads colors around the entire color wheel
+  const hue = hash % 360;
+
+  // Use fixed values for lightness and chroma to ensure consistent brightness
+  // Lightness: 0.65 gives good visibility on both light and dark backgrounds
+  // Chroma: 0.15 gives vibrant but not overpowering colors
+  const lightness = 0.65;
+  const chroma = 0.15;
+
+  // Return the color as an Oklch string
+  return `oklch(${lightness} ${chroma} ${hue})`;
+};

examples/multi-cursors/src/utils/getLabelPosition.ts

@@ -0,0 +1,40 @@
+import { Vec2, ViewBox } from "../types";
+
+interface TextDimensions {
+  width: number;
+  height: number;
+}
+
+interface LabelPosition {
+  x: number;
+  y: number;
+}
+
+/**
+ * Calculate the position of a cursor label based on cursor position, label dimensions, and bounds
+ * Such that the label is always on the same side of the bounds as the cursor
+ * @param position - The cursor position
+ * @param dimensions - The dimensions of the label text
+ * @param bounds - The viewport bounds
+ * @param isOutOfBounds - Whether the cursor is outside the bounds
+ * @returns The calculated label position
+ */
+export function getLabelPosition(
+  position: Vec2,
+  dimensions: TextDimensions,
+  bounds?: ViewBox,
+  isOutOfBounds?: boolean,
+): LabelPosition {
+  if (!isOutOfBounds || !bounds) {
+    return { x: position.x + 15, y: position.y + 25 };
+  }
+
+  // Calculate the percentage of the bounds that the intersection point is from the left
+  const percentageH = (position.x - bounds.x) / bounds.width;
+  const percentageV = (position.y - bounds.y) / bounds.height;
+
+  return {
+    x: position.x - percentageH * dimensions.width,
+    y: position.y - percentageV * dimensions.height,
+  };
+}

examples/multi-cursors/src/utils/getName.ts

@@ -0,0 +1,44 @@
+import { Account, ID, SessionID } from "jazz-tools";
+
+const animals = [
+  "elephant",
+  "penguin",
+  "giraffe",
+  "octopus",
+  "kangaroo",
+  "dolphin",
+  "cheetah",
+  "koala",
+  "platypus",
+  "pangolin",
+  "tiger",
+  "zebra",
+  "panda",
+  "lion",
+  "honey badger",
+  "hippo",
+];
+
+/**
+ * Get a psuedo-random username.
+ * @param str The string to get the username from.
+ * @returns A psuedo-random username.
+ */
+export function getRandomUsername(str: string) {
+  return `Anonymous ${animals[Math.abs(str.split("").reduce((acc, char) => acc + char.charCodeAt(0), 0)) % animals.length]}`;
+}
+
+/**
+ * Get the name of a user. If the name is "Anonymous user" or not set, return a random username.
+ * @param name The name of the user.
+ * @param id The id of the user.
+ * @returns The psuedo-random name of the user.
+ */
+export function getName(
+  name: string | undefined,
+  id: ID<Account> | SessionID | undefined,
+) {
+  if (name === "Anonymous user" || !name || !id)
+    return getRandomUsername(id ?? "");
+  return name;
+}

examples/multi-cursors/src/utils/isOutOfBounds.ts

@@ -0,0 +1,21 @@
+import { Vec2, ViewBox } from "../types";
+
+/**
+ * Check if a position is out of bounds of a view box.
+ * @param position - The position to check.
+ * @param bounds - The bounds of the view box.
+ * @param grace - The grace distance to allow for the position to be out of bounds.
+ * @returns True if the position is out of bounds, false otherwise.
+ */
+export function isOutOfBounds(
+  position: Vec2,
+  bounds: ViewBox,
+  grace: number = 0,
+): boolean {
+  return (
+    position.x < bounds.x - grace ||
+    position.x > bounds.x + bounds.width + grace ||
+    position.y < bounds.y - grace ||
+    position.y > bounds.y + bounds.height + grace
+  );
+}

examples/multi-cursors/src/utils/loadCursorContainer.ts

@@ -0,0 +1,83 @@
+import { Account, Group, type ID } from "jazz-tools";
+import { CursorContainer, CursorFeed } from "../schema";
+
+/**
+ * Creates a new group to own the cursor container.
+ * @param me - The account of the current user.
+ * @returns The group.
+ */
+function createGroup(me: Account) {
+  const group = Group.create({
+    owner: me,
+  });
+  group.addMember("everyone", "writer");
+  console.log("Created group");
+  console.log(`Add "VITE_GROUP_ID=${group.id}" to your .env file`);
+  return group;
+}
+
+export async function loadGroup(me: Account, groupID: ID<Group>) {
+  if (groupID === undefined) {
+    console.log("No group ID found in .env, creating group...");
+    return createGroup(me);
+  }
+  const group = await Group.load(groupID, {});
+  if (group === null || group === undefined) {
+    console.log("Group not found, creating group...");
+    return createGroup(me);
+  }
+  return group;
+}
+
+/**
+ * Loads the cursor container for the given cursor feed ID.
+ * If the cursor container does not exist, it creates a new one.
+ * If the cursor container exists, it loads the existing one.
+ * @param me - The account of the current user.
+ * @param cursorFeedID - The ID of the cursor feed.
+ * @param groupID - The ID of the group.
+ */
+export async function loadCursorContainer(
+  me: Account,
+  cursorFeedID = "cursor-feed",
+  groupID: ID<Group>,
+): Promise<ID<CursorFeed> | undefined> {
+  if (!me) return;
+  console.log("Loading group...");
+  const group = await loadGroup(me, groupID);
+
+  const cursorContainerID = CursorContainer.findUnique(
+    cursorFeedID,
+    group?.id as ID<Group>,
+  );
+  console.log("Loading cursor container:", cursorContainerID);
+  const cursorContainer = await CursorContainer.load(cursorContainerID, {
+    resolve: {
+      cursorFeed: true,
+    },
+  });
+
+  if (cursorContainer === null || cursorContainer === undefined) {
+    console.log("Global cursors does not exist, creating...");
+    const cursorContainer = CursorContainer.create(
+      {
+        cursorFeed: CursorFeed.create([], group),
+      },
+      {
+        owner: group,
+        unique: cursorFeedID,
+      },
+    );
+    console.log("Created global cursors", cursorContainer.id);
+    if (cursorContainer.cursorFeed === null) {
+      throw new Error("cursorFeed is null");
+    }
+    return cursorContainer.cursorFeed.id;
+  } else {
+    console.log(
+      "Global cursors already exists, loading...",
+      cursorContainer.id,
+    );
+    return cursorContainer.cursorFeed?.id;
+  }
+}

examples/multi-cursors/src/utils/throttleTime.ts

@@ -0,0 +1,68 @@
+/**
+ * Options for the throttleTime function
+ */
+interface ThrottleOptions {
+  /** Whether to invoke on the leading edge of the timeout (default: true) */
+  leading?: boolean;
+  /** Whether to invoke on the trailing edge of the timeout (default: true) */
+  trailing?: boolean;
+}
+
+/**
+ * Creates a throttled function that only invokes the provided function
+ * at most once per every `wait` milliseconds.
+ *
+ * @param func - The function to throttle
+ * @param wait - The number of milliseconds to throttle invocations to
+ * @param options - The options object
+ * @returns Returns the new throttled function
+ */
+export function throttleTime<T extends (...args: any[]) => any>(
+  func: T,
+  wait: number,
+  options: ThrottleOptions = {},
+): (...args: Parameters<T>) => ReturnType<T> | undefined {
+  const { leading = true, trailing = true } = options;
+
+  let timeout: NodeJS.Timeout | null = null;
+  let previous = 0;
+  let result: ReturnType<T> | undefined;
+  let context: any;
+  let args: Parameters<T>;
+
+  const later = (): void => {
+    previous = !leading ? 0 : Date.now();
+    timeout = null;
+    result = func.apply(context, args);
+    if (!timeout) context = args = null!;
+  };
+
+  return function throttled(
+    this: any,
+    ...params: Parameters<T>
+  ): ReturnType<T> | undefined {
+    const now = Date.now();
+    if (!previous && !leading) previous = now;
+
+    const remaining = wait - (now - previous);
+
+    context = this;
+    args = params;
+
+    if (remaining <= 0 || remaining > wait) {
+      if (timeout) {
+        clearTimeout(timeout);
+        timeout = null;
+      }
+
+      previous = now;
+      result = func.apply(context, args);
+
+      if (!timeout) context = args = null!;
+    } else if (!timeout && trailing) {
+      timeout = setTimeout(later, remaining);
+    }
+
+    return result;
+  };
+}

examples/multi-cursors/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

examples/multi-cursors/tailwind.config.ts

@@ -0,0 +1,23 @@
+import type { Config } from "tailwindcss";
+
+const config: Config = {
+  content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
+  theme: {
+    extend: {
+      container: {
+        center: true,
+        padding: {
+          DEFAULT: "0.75rem",
+          sm: "1rem",
+        },
+        screens: {
+          lg: "600px",
+          xl: "600px",
+        },
+      },
+    },
+  },
+  plugins: [],
+} as const;
+
+export default config;

examples/multi-cursors/tsconfig.app.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src"]
+}

examples/multi-cursors/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

examples/multi-cursors/tsconfig.node.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+    "target": "ES2022",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["vite.config.ts"]
+}

examples/multi-cursors/vercel.json

@@ -0,0 +1,8 @@
+{
+  "build": {
+    "env": {
+      "APP_NAME": "multi-cursors"
+    }
+  },
+  "ignoreCommand": "node ../../ignore-vercel-build.js"
+}

examples/multi-cursors/vite.config.ts

@@ -0,0 +1,15 @@
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [react()],
+  build: {
+    minify: "esbuild",
+    terserOptions: {
+      compress: {
+        drop_console: true,
+      },
+    },
+  },
+});

examples/multiauth/CHANGELOG.md

@@ -1,5 +1,54 @@
 # multiauth
 
+## 0.0.9
+
+### Patch Changes
+
+- jazz-react@0.12.1
+- jazz-react-auth-clerk@0.12.1
+- jazz-tools@0.12.1
+
+## 0.0.8
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+  - jazz-tools@0.12.0
+  - jazz-react@0.12.0
+  - jazz-react-auth-clerk@0.12.0
+
+## 0.0.7
+
+### Patch Changes
+
+- jazz-react@0.11.8
+- jazz-react-auth-clerk@0.11.8
+- jazz-tools@0.11.8
+
+## 0.0.6
+
+### Patch Changes
+
+- Updated dependencies [a140f55]
+- Updated dependencies [4019918]
+- Updated dependencies [2b0d1b0]
+  - jazz-tools@0.11.7
+  - jazz-react@0.11.7
+  - jazz-react-auth-clerk@0.11.7
+
+## 0.0.5
+
+### Patch Changes
+
+- 1bfa9bb: Removed when="singedUp" from examples apps' Jazz providers. This is a really niche use-case option and can lead to broken-feeling experiences when anonymous users try to load something.
+- Updated dependencies [e7c85b7]
+  - jazz-react@0.11.6
+  - jazz-tools@0.11.6
+  - jazz-react-auth-clerk@0.11.6
+
 ## 0.0.4
 
 ### Patch Changes

examples/multiauth/package.json

@@ -1,7 +1,7 @@
 {
   "name": "multiauth",
   "private": true,
-  "version": "0.0.4",
+  "version": "0.0.9",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/multiauth/src/components/Home.tsx

@@ -1,7 +1,7 @@
 import { useAccount, useIsAuthenticated } from "jazz-react";
 
 export function Home() {
-  const { me, logOut } = useAccount({ root: {} });
+  const { me, logOut } = useAccount({ resolve: { root: true } });
   const isAuthenticated = useIsAuthenticated();
 
   if (!me) return;

examples/music-player/CHANGELOG.md

@@ -1,5 +1,59 @@
 # jazz-example-musicplayer
 
+## 0.0.90
+
+### Patch Changes
+
+- jazz-inspector@0.12.1
+- jazz-react@0.12.1
+- jazz-tools@0.12.1
+
+## 0.0.89
+
+### Patch Changes
+
+- Updated dependencies [01523dc]
+- Updated dependencies [4ea87dc]
+- Updated dependencies [1e6da19]
+- Updated dependencies [b6c6a0a]
+- Updated dependencies [9a56bb3]
+  - jazz-tools@0.12.0
+  - jazz-inspector@0.12.0
+  - jazz-react@0.12.0
+
+## 0.0.88
+
+### Patch Changes
+
+- Updated dependencies [71b9390]
+  - jazz-inspector@0.11.8
+  - jazz-react@0.11.8
+  - jazz-tools@0.11.8
+
+## 0.0.87
+
+### Patch Changes
+
+- Updated dependencies [2c3761c]
+- Updated dependencies [a140f55]
+- Updated dependencies [4019918]
+- Updated dependencies [2b0d1b0]
+  - jazz-inspector@0.11.7
+  - jazz-tools@0.11.7
+  - jazz-react@0.11.7
+
+## 0.0.86
+
+### Patch Changes
+
+- 1bfa9bb: Removed when="singedUp" from examples apps' Jazz providers. This is a really niche use-case option and can lead to broken-feeling experiences when anonymous users try to load something.
+- Updated dependencies [e7c85b7]
+- Updated dependencies [09f0a98]
+- Updated dependencies [11da4d1]
+  - jazz-react@0.11.6
+  - jazz-tools@0.11.6
+  - jazz-inspector@0.11.6
+
 ## 0.0.85
 
 ### Patch Changes

examples/music-player/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-music-player",
   "private": true,
-  "version": "0.0.85",
+  "version": "0.0.90",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -22,8 +22,8 @@
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",
     "jazz-inspector": "workspace:*",
-    "jazz-react": "workspace:0.11.5",
-    "jazz-tools": "workspace:0.11.5",
+    "jazz-react": "workspace:0.12.1",
+    "jazz-tools": "workspace:0.12.1",
     "lucide-react": "^0.274.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",

examples/music-player/src/3_HomePage.tsx

@@ -24,10 +24,7 @@ export function HomePage({ mediaPlayer }: { mediaPlayer: MediaPlayer }) {
    *  access rights to CoValues. We get it from the top-level provider `<WithJazz/>`.
    */
   const { me } = useAccount({
-    root: {
-      rootPlaylist: {},
-      playlists: [],
-    },
+    resolve: { root: { rootPlaylist: true, playlists: true } },
   });
 
   const navigate = useNavigate();
@@ -51,8 +48,9 @@ export function HomePage({ mediaPlayer }: { mediaPlayer: MediaPlayer }) {
 
   const params = useParams<{ playlistId: ID<Playlist> }>();
   const playlistId = params.playlistId ?? me?.root._refs.rootPlaylist.id;
+
   const playlist = useCoState(Playlist, playlistId, {
-    tracks: [],
+    resolve: { tracks: true },
   });
 
   const isRootPlaylist = !params.playlistId;

examples/music-player/src/4_actions.ts

@@ -27,9 +27,11 @@ export async function uploadMusicTracks(
   isExampleTrack: boolean = false,
 ) {
   const { root } = await MusicaAccount.getMe().ensureLoaded({
-    root: {
-      rootPlaylist: {
-        tracks: [],
+    resolve: {
+      root: {
+        rootPlaylist: {
+          tracks: true,
+        },
       },
     },
   });
@@ -65,8 +67,10 @@ export async function uploadMusicTracks(
 
 export async function createNewPlaylist() {
   const { root } = await MusicaAccount.getMe().ensureLoaded({
-    root: {
-      playlists: [],
+    resolve: {
+      root: {
+        playlists: true,
+      },
     },
   });
 
@@ -149,9 +153,11 @@ export async function updateMusicTrackTitle(track: MusicTrack, title: string) {
 
 export async function updateActivePlaylist(playlist?: Playlist) {
   const { root } = await MusicaAccount.getMe().ensureLoaded({
-    root: {
-      activePlaylist: {},
-      rootPlaylist: {},
+    resolve: {
+      root: {
+        activePlaylist: true,
+        rootPlaylist: true,
+      },
     },
   });
 
@@ -160,7 +166,9 @@ export async function updateActivePlaylist(playlist?: Playlist) {
 
 export async function updateActiveTrack(track: MusicTrack) {
   const { root } = await MusicaAccount.getMe().ensureLoaded({
-    root: {},
+    resolve: {
+      root: {},
+    },
   });
 
   root.activeTrack = track;
@@ -170,17 +178,23 @@ export async function onAnonymousAccountDiscarded(
   anonymousAccount: MusicaAccount,
 ) {
   const { root: anonymousAccountRoot } = await anonymousAccount.ensureLoaded({
-    root: {
-      rootPlaylist: {
-        tracks: [{}],
+    resolve: {
+      root: {
+        rootPlaylist: {
+          tracks: {
+            $each: true,
+          },
+        },
       },
     },
   });
 
   const me = await MusicaAccount.getMe().ensureLoaded({
-    root: {
-      rootPlaylist: {
-        tracks: [],
+    resolve: {
+      root: {
+        rootPlaylist: {
+          tracks: true,
+        },
       },
     },
   });
@@ -197,8 +211,10 @@ export async function onAnonymousAccountDiscarded(
 
 export async function deletePlaylist(playlistId: string) {
   const { root } = await MusicaAccount.getMe().ensureLoaded({
-    root: {
-      playlists: [],
+    resolve: {
+      root: {
+        playlists: true,
+      },
     },
   });
 

examples/music-player/src/5_useMediaPlayer.ts

@@ -9,7 +9,7 @@ import { getNextTrack, getPrevTrack } from "./lib/getters";
 
 export function useMediaPlayer() {
   const { me } = useAccount({
-    root: {},
+    resolve: { root: true },
   });
 
   const playState = usePlayState();

examples/music-player/src/6_InvitePage.tsx

@@ -16,8 +16,10 @@ export function InvitePage() {
         const playlist = await Playlist.load(playlistId, {});
 
         const me = await MusicaAccount.getMe().ensureLoaded({
-          root: {
-            playlists: [],
+          resolve: {
+            root: {
+              playlists: true,
+            },
           },
         });
 

examples/music-player/src/components/AuthModal.tsx

@@ -22,9 +22,13 @@ export function AuthModal({ open, onOpenChange }: AuthModalProps) {
   const [error, setError] = useState<string | null>(null);
 
   const { me } = useAccount({
-    root: {
-      rootPlaylist: {
-        tracks: [{}],
+    resolve: {
+      root: {
+        rootPlaylist: {
+          tracks: {
+            $each: true,
+          },
+        },
       },
     },
   });