@liveblocks/react-flow 3.16.0-flow3 → 3.17.0-rc1

package/dist/constants.cjs

@@ -23,7 +23,8 @@ const EDGE_BASE_CONFIG = {
   // Atomic (synced as plain Json)
   markerStart: "atomic",
   markerEnd: "atomic",
-  label: "atomic"
+  label: "atomic",
+  labelBgPadding: "atomic"
   // Note: the `data` key is intentionally left out of this base config, as it
   // is expected to be provided by the end user
 };

package/dist/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constants.cjs","sources":["../src/constants.ts"],"sourcesContent":["import type { SyncConfig } from \"@liveblocks/core\";\n\nexport const DEFAULT_STORAGE_KEY = \"flow\";\n\nexport const NODE_BASE_CONFIG = {\n  // Local-only (not synced)\n  selected: false,\n  dragging: false,\n  measured: false,\n  resizing: false,\n\n  // Atomic (synced as plain Json)\n  position: \"atomic\",\n  sourcePosition: \"atomic\",\n  targetPosition: \"atomic\",\n  extent: \"atomic\",\n  origin: \"atomic\",\n  handles: \"atomic\",\n\n  // Note: the `data` key is intentionally left out of this base config, as it\n  // is expected to be provided by the end user\n} as const satisfies SyncConfig;\n\nexport const EDGE_BASE_CONFIG = {\n  // Local-only (not synced)\n  selected: false,\n\n  // Atomic (synced as plain Json)\n  markerStart: \"atomic\",\n  markerEnd: \"atomic\",\n  label: \"atomic\",\n\n  // Note: the `data` key is intentionally left out of this base config, as it\n  // is expected to be provided by the end user\n} as const satisfies SyncConfig;\n"],"names":[],"mappings":";;AAEO,MAAM,mBAAsB,GAAA,OAAA;AAE5B,MAAM,gBAAmB,GAAA;AAAA;AAAA,EAE9B,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,QAAU,EAAA,QAAA;AAAA,EACV,cAAgB,EAAA,QAAA;AAAA,EAChB,cAAgB,EAAA,QAAA;AAAA,EAChB,MAAQ,EAAA,QAAA;AAAA,EACR,MAAQ,EAAA,QAAA;AAAA,EACR,OAAS,EAAA,QAAA;AAAA;AAAA;AAIX,EAAA;AAEO,MAAM,gBAAmB,GAAA;AAAA;AAAA,EAE9B,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,WAAa,EAAA,QAAA;AAAA,EACb,SAAW,EAAA,QAAA;AAAA,EACX,KAAO,EAAA,QAAA;AAAA;AAAA;AAIT;;;;;;"}
+{"version":3,"file":"constants.cjs","sources":["../src/constants.ts"],"sourcesContent":["import type { SyncMode } from \"@liveblocks/core\";\nimport type { Edge, Node } from \"@xyflow/react\";\n\nexport const DEFAULT_STORAGE_KEY = \"flow\";\n\n// React Flow specific versions of `SyncConfig` that only allow keys that are actually exposed by React Flow.\ntype NodeSyncConfig = { [K in keyof Node]?: SyncMode };\ntype EdgeSyncConfig = { [K in keyof Edge]?: SyncMode };\n\nexport const NODE_BASE_CONFIG = {\n  // Local-only (not synced)\n  selected: false,\n  dragging: false,\n  measured: false,\n  resizing: false,\n\n  // Atomic (synced as plain Json)\n  position: \"atomic\",\n  sourcePosition: \"atomic\",\n  targetPosition: \"atomic\",\n  extent: \"atomic\",\n  origin: \"atomic\",\n  handles: \"atomic\",\n\n  // Note: the `data` key is intentionally left out of this base config, as it\n  // is expected to be provided by the end user\n} as const satisfies NodeSyncConfig;\n\nexport const EDGE_BASE_CONFIG = {\n  // Local-only (not synced)\n  selected: false,\n\n  // Atomic (synced as plain Json)\n  markerStart: \"atomic\",\n  markerEnd: \"atomic\",\n  label: \"atomic\",\n  labelBgPadding: \"atomic\",\n\n  // Note: the `data` key is intentionally left out of this base config, as it\n  // is expected to be provided by the end user\n} as const satisfies EdgeSyncConfig;\n"],"names":[],"mappings":";;AAGO,MAAM,mBAAsB,GAAA,OAAA;AAM5B,MAAM,gBAAmB,GAAA;AAAA;AAAA,EAE9B,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,QAAU,EAAA,QAAA;AAAA,EACV,cAAgB,EAAA,QAAA;AAAA,EAChB,cAAgB,EAAA,QAAA;AAAA,EAChB,MAAQ,EAAA,QAAA;AAAA,EACR,MAAQ,EAAA,QAAA;AAAA,EACR,OAAS,EAAA,QAAA;AAAA;AAAA;AAIX,EAAA;AAEO,MAAM,gBAAmB,GAAA;AAAA;AAAA,EAE9B,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,WAAa,EAAA,QAAA;AAAA,EACb,SAAW,EAAA,QAAA;AAAA,EACX,KAAO,EAAA,QAAA;AAAA,EACP,cAAgB,EAAA,QAAA;AAAA;AAAA;AAIlB;;;;;;"}

package/dist/constants.js

@@ -21,7 +21,8 @@ const EDGE_BASE_CONFIG = {
   // Atomic (synced as plain Json)
   markerStart: "atomic",
   markerEnd: "atomic",
-  label: "atomic"
+  label: "atomic",
+  labelBgPadding: "atomic"
   // Note: the `data` key is intentionally left out of this base config, as it
   // is expected to be provided by the end user
 };

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sources":["../src/constants.ts"],"sourcesContent":["import type { SyncConfig } from \"@liveblocks/core\";\n\nexport const DEFAULT_STORAGE_KEY = \"flow\";\n\nexport const NODE_BASE_CONFIG = {\n  // Local-only (not synced)\n  selected: false,\n  dragging: false,\n  measured: false,\n  resizing: false,\n\n  // Atomic (synced as plain Json)\n  position: \"atomic\",\n  sourcePosition: \"atomic\",\n  targetPosition: \"atomic\",\n  extent: \"atomic\",\n  origin: \"atomic\",\n  handles: \"atomic\",\n\n  // Note: the `data` key is intentionally left out of this base config, as it\n  // is expected to be provided by the end user\n} as const satisfies SyncConfig;\n\nexport const EDGE_BASE_CONFIG = {\n  // Local-only (not synced)\n  selected: false,\n\n  // Atomic (synced as plain Json)\n  markerStart: \"atomic\",\n  markerEnd: \"atomic\",\n  label: \"atomic\",\n\n  // Note: the `data` key is intentionally left out of this base config, as it\n  // is expected to be provided by the end user\n} as const satisfies SyncConfig;\n"],"names":[],"mappings":"AAEO,MAAM,mBAAsB,GAAA,OAAA;AAE5B,MAAM,gBAAmB,GAAA;AAAA;AAAA,EAE9B,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,QAAU,EAAA,QAAA;AAAA,EACV,cAAgB,EAAA,QAAA;AAAA,EAChB,cAAgB,EAAA,QAAA;AAAA,EAChB,MAAQ,EAAA,QAAA;AAAA,EACR,MAAQ,EAAA,QAAA;AAAA,EACR,OAAS,EAAA,QAAA;AAAA;AAAA;AAIX,EAAA;AAEO,MAAM,gBAAmB,GAAA;AAAA;AAAA,EAE9B,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,WAAa,EAAA,QAAA;AAAA,EACb,SAAW,EAAA,QAAA;AAAA,EACX,KAAO,EAAA,QAAA;AAAA;AAAA;AAIT;;;;"}
+{"version":3,"file":"constants.js","sources":["../src/constants.ts"],"sourcesContent":["import type { SyncMode } from \"@liveblocks/core\";\nimport type { Edge, Node } from \"@xyflow/react\";\n\nexport const DEFAULT_STORAGE_KEY = \"flow\";\n\n// React Flow specific versions of `SyncConfig` that only allow keys that are actually exposed by React Flow.\ntype NodeSyncConfig = { [K in keyof Node]?: SyncMode };\ntype EdgeSyncConfig = { [K in keyof Edge]?: SyncMode };\n\nexport const NODE_BASE_CONFIG = {\n  // Local-only (not synced)\n  selected: false,\n  dragging: false,\n  measured: false,\n  resizing: false,\n\n  // Atomic (synced as plain Json)\n  position: \"atomic\",\n  sourcePosition: \"atomic\",\n  targetPosition: \"atomic\",\n  extent: \"atomic\",\n  origin: \"atomic\",\n  handles: \"atomic\",\n\n  // Note: the `data` key is intentionally left out of this base config, as it\n  // is expected to be provided by the end user\n} as const satisfies NodeSyncConfig;\n\nexport const EDGE_BASE_CONFIG = {\n  // Local-only (not synced)\n  selected: false,\n\n  // Atomic (synced as plain Json)\n  markerStart: \"atomic\",\n  markerEnd: \"atomic\",\n  label: \"atomic\",\n  labelBgPadding: \"atomic\",\n\n  // Note: the `data` key is intentionally left out of this base config, as it\n  // is expected to be provided by the end user\n} as const satisfies EdgeSyncConfig;\n"],"names":[],"mappings":"AAGO,MAAM,mBAAsB,GAAA,OAAA;AAM5B,MAAM,gBAAmB,GAAA;AAAA;AAAA,EAE9B,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA,EACV,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,QAAU,EAAA,QAAA;AAAA,EACV,cAAgB,EAAA,QAAA;AAAA,EAChB,cAAgB,EAAA,QAAA;AAAA,EAChB,MAAQ,EAAA,QAAA;AAAA,EACR,MAAQ,EAAA,QAAA;AAAA,EACR,OAAS,EAAA,QAAA;AAAA;AAAA;AAIX,EAAA;AAEO,MAAM,gBAAmB,GAAA;AAAA;AAAA,EAE9B,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,WAAa,EAAA,QAAA;AAAA,EACb,SAAW,EAAA,QAAA;AAAA,EACX,KAAO,EAAA,QAAA;AAAA,EACP,cAAgB,EAAA,QAAA;AAAA;AAAA;AAIlB;;;;"}

package/dist/flow.cjs

@@ -51,15 +51,19 @@ function applyNodeChanges(changes, nodes, history, getNodeSyncConfig) {
       }
       case "position": {
         const node = nodes.get(change.id);
-        if (!node || !change.position)
+        if (!node)
           break;
+        if (change.dragging === true) {
+          history.pause();
+        }
         if (change.position !== void 0) {
-          node.set("position", change.position);
+          const prev = node.get("position");
+          if (prev?.x !== change.position.x || prev?.y !== change.position.y) {
+            node.set("position", change.position);
+          }
         }
         if (change.dragging !== void 0) {
-          if (change.dragging) {
-            history.pause();
-          } else {
+          if (change.dragging === false) {
             history.resume();
           }
           node.setLocal("dragging", change.dragging);
@@ -70,6 +74,9 @@ function applyNodeChanges(changes, nodes, history, getNodeSyncConfig) {
         const node = nodes.get(change.id);
         if (!node)
           break;
+        if (change.resizing === true) {
+          history.pause();
+        }
         if (change.dimensions !== void 0 && change.setAttributes !== void 0) {
           if (change.setAttributes === true || change.setAttributes === "width") {
             node.set("width", change.dimensions.width);
@@ -82,9 +89,7 @@ function applyNodeChanges(changes, nodes, history, getNodeSyncConfig) {
           node.setLocal("measured", change.dimensions);
         }
         if (change.resizing !== void 0) {
-          if (change.resizing) {
-            history.pause();
-          } else {
+          if (change.resizing === false) {
             history.resume();
           }
           node.setLocal("resizing", change.resizing);

package/dist/flow.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"flow.cjs","sources":["../src/flow.ts"],"sourcesContent":["import type {\n  History,\n  JsonObject,\n  Resolve,\n  ToImmutable,\n} from \"@liveblocks/core\";\nimport { kInternal, LiveMap, LiveObject } from \"@liveblocks/core\";\nimport { useHistory, useMutation, useStorage } from \"@liveblocks/react\";\nimport {\n  useInitial,\n  useSuspendUntilStorageReady,\n} from \"@liveblocks/react/_private\";\nimport type {\n  BuiltInEdge,\n  BuiltInNode,\n  Connection,\n  Edge,\n  EdgeChange,\n  Node,\n  NodeChange,\n  OnConnect,\n  OnDelete,\n  OnEdgesChange,\n  OnNodesChange,\n} from \"@xyflow/react\";\nimport { addEdge as defaultAddEdge } from \"@xyflow/react\";\nimport { useEffect, useMemo } from \"react\";\n\nimport {\n  DEFAULT_STORAGE_KEY,\n  EDGE_BASE_CONFIG,\n  NODE_BASE_CONFIG,\n} from \"./constants\";\nimport { toLiveblocksInternalEdge, toLiveblocksInternalNode } from \"./helpers\";\nimport type {\n  EdgeSyncConfig,\n  InternalLiveblocksEdge,\n  InternalLiveblocksFlow,\n  InternalLiveblocksNode,\n  NodeSyncConfig,\n  SyncConfig,\n} from \"./types\";\n\nconst EMPTY_ARRAY = [] as unknown[];\n\ntype UseLiveblocksFlowResult<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> = Resolve<\n  (\n    | {\n        nodes: null;\n        edges: null;\n        isLoading: true;\n      }\n    | {\n        nodes: N[];\n        edges: E[];\n        isLoading: false;\n      }\n  ) & {\n    onNodesChange: OnNodesChange<N>;\n    onEdgesChange: OnEdgesChange<E>;\n    onConnect: OnConnect;\n    onDelete: OnDelete<N, E>;\n  }\n>;\n\ntype LiveblocksFlowSuspenseResult<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> = Extract<UseLiveblocksFlowResult<N, E>, { isLoading: false }>;\n\nfunction mergeAndBuildDataConfigCache(\n  base: SyncConfig,\n  data?: Record<string, SyncConfig | undefined>\n): (type: string | undefined) => SyncConfig {\n  if (!data) return () => base;\n\n  const dataFallback = data[\"*\"];\n  const fallback = dataFallback ? { ...base, data: dataFallback } : base;\n\n  // Pre-compute full node/edge sync configs for all explicitly declared types\n  const cache = new Map<string | undefined, SyncConfig>();\n  for (const type in data) {\n    if (type === \"*\") continue;\n    const specific = data[type];\n    if (!specific) continue;\n    const dataConfig: SyncConfig = { ...dataFallback, ...specific };\n    cache.set(type, { ...base, data: dataConfig });\n  }\n\n  return (type) => cache.get(type) || fallback;\n}\n\nfunction buildNodeConfigCache<N extends Node>(\n  /** The user-provided node data sync configuration, if any. */\n  nodeDataConfig?: NodeSyncConfig<N>\n): (type: string | undefined) => SyncConfig {\n  return mergeAndBuildDataConfigCache(NODE_BASE_CONFIG, nodeDataConfig);\n}\n\nfunction buildEdgeConfigCache<E extends Edge>(\n  /** The user-provided edge data sync configuration, if any. */\n  edgeDataConfig?: EdgeSyncConfig<E>\n): (type: string | undefined) => SyncConfig {\n  return mergeAndBuildDataConfigCache(EDGE_BASE_CONFIG, edgeDataConfig);\n}\n\ntype UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {\n  nodes?: {\n    /**\n     * The initial React Flow nodes.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   nodes: {\n     *     initial: [\n     *       { id: \"1\", position: { x: 0, y: 0 }, data: { label: \"Node 1\" } },\n     *       { id: \"2\", position: { x: 0, y: 100 }, data: { label: \"Node 2\" } },\n     *     ],\n     *   },\n     * });\n     * ```\n     */\n    initial?: N[];\n    /**\n     * Per-type sync configuration for node data keys.\n     *\n     * Use `\"*\"` as a fallback for all node types. Type-specific entries are\n     * deep-merged on top of `\"*\"`, with explicitly named keys taking\n     * precedence.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   nodes: {\n     *     sync: {\n     *       // Fallback for all node types\n     *       \"*\": {\n     *         label: false,  // Don't sync node.data.label\n     *       },\n     *\n     *       // Override for node.type === 'myCustomNode'\n     *       // This will also not sync `myCustomNode.data.label` (because of the fallback above)\n     *       myCustomNode: {\n     *         showPreview: false,  // Don't sync myCustomNode.data.showPreview\n     *       },\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    sync?: NodeSyncConfig<N>;\n  };\n\n  edges?: {\n    initial?: E[];\n    /**\n     * Per-type sync configuration for edge data keys.\n     *\n     * Use `\"*\"` as a fallback for all edge types. Type-specific entries are\n     * deep-merged on top of `\"*\"`, with explicitly named keys taking\n     * precedence.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   edges: {\n     *     sync: {\n     *       // Fallback for all edge types\n     *       \"*\": {\n     *         hovered: false,  // Don't sync edge.data.hovered\n     *       },\n     *\n     *       // Override for edge.type === 'myCustomEdge'\n     *       // This will also not sync `myCustomEdge.data.hovered` (because of the fallback above)\n     *       myCustomEdge: {\n     *         isHighlighted: false,  // Don't sync myCustomEdge.data.isHighlighted\n     *       },\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    sync?: EdgeSyncConfig<E>;\n  };\n\n  /**\n   * The key used to store the React Flow diagram in Liveblocks Storage.\n   * Defaults to `\"flow\"`.\n   */\n  storageKey?: string;\n\n  /**\n   * When true, suspends until Storage is ready (use a React `Suspense`\n   * boundary). Then `nodes` and `edges` are always arrays and `isLoading` is\n   * always false.\n   */\n  suspense?: boolean;\n};\n\n// Similar to React Flow's `applyNodeChanges()`, but writes local-only\n// properties via `setLocal()` / `delete()` on the LiveObject directly.\n// https://reactflow.dev/api-reference/utils/apply-node-changes\nfunction applyNodeChanges<N extends Node>(\n  changes: NodeChange<N>[],\n  nodes: LiveMap<string, InternalLiveblocksNode>,\n  history: History,\n  getNodeSyncConfig: (nodeType: string | undefined) => SyncConfig\n): void {\n  for (const change of changes) {\n    switch (change.type) {\n      case \"add\":\n      case \"replace\": {\n        const config = getNodeSyncConfig(change.item.type);\n        const existing = nodes.get(change.item.id);\n        if (existing) {\n          existing.reconcile(change.item as unknown as JsonObject, config);\n        } else {\n          nodes.set(\n            change.item.id,\n            toLiveblocksInternalNode(change.item, config)\n          );\n        }\n        break;\n      }\n\n      case \"position\": {\n        const node = nodes.get(change.id);\n        if (!node || !change.position) break;\n\n        if (change.position !== undefined) {\n          node.set(\"position\", change.position);\n        }\n\n        if (change.dragging !== undefined) {\n          if (change.dragging) {\n            history.pause();\n          } else {\n            history.resume();\n          }\n          // Must match NODE_BASE_CONFIG's `dragging: false`\n          node.setLocal(\"dragging\", change.dragging);\n        }\n        break;\n      }\n\n      case \"dimensions\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        if (\n          change.dimensions !== undefined &&\n          change.setAttributes !== undefined\n        ) {\n          if (\n            change.setAttributes === true ||\n            change.setAttributes === \"width\"\n          ) {\n            node.set(\"width\", change.dimensions.width);\n          }\n\n          if (\n            change.setAttributes === true ||\n            change.setAttributes === \"height\"\n          ) {\n            node.set(\"height\", change.dimensions.height);\n          }\n        }\n\n        if (change.dimensions !== undefined) {\n          // Must match NODE_BASE_CONFIG's `measured: false`\n          node.setLocal(\"measured\", change.dimensions);\n        }\n\n        if (change.resizing !== undefined) {\n          if (change.resizing) {\n            history.pause();\n          } else {\n            history.resume();\n          }\n          // Must match NODE_BASE_CONFIG's `resizing: false`\n          node.setLocal(\"resizing\", change.resizing);\n        }\n\n        break;\n      }\n\n      case \"select\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        // Must match NODE_BASE_CONFIG's `selected: false`\n        node.setLocal(\"selected\", change.selected);\n        break;\n      }\n\n      case \"remove\":\n        // Removals are handled by onDelete for atomic undo\n        break;\n    }\n  }\n}\n\n// Similar to React Flow's `applyEdgeChanges()`, but writes local-only\n// properties via `setLocal()` / `delete()` on the LiveObject directly.\n// https://reactflow.dev/api-reference/utils/apply-edge-changes\nfunction applyEdgeChanges<E extends Edge>(\n  changes: EdgeChange<E>[],\n  edges: LiveMap<string, InternalLiveblocksEdge>,\n  getEdgeSyncConfig: (type: string | undefined) => SyncConfig\n): void {\n  for (const change of changes) {\n    switch (change.type) {\n      case \"add\":\n      case \"replace\": {\n        const config = getEdgeSyncConfig(change.item.type);\n        const existing = edges.get(change.item.id);\n        if (existing) {\n          existing.reconcile(change.item as unknown as JsonObject, config);\n        } else {\n          edges.set(\n            change.item.id,\n            toLiveblocksInternalEdge(change.item, config)\n          );\n        }\n        break;\n      }\n\n      case \"select\": {\n        const edge = edges.get(change.id);\n        if (!edge) break;\n        // Must match EDGE_BASE_CONFIG's `selected: false`\n        edge.setLocal(\"selected\", change.selected);\n        break;\n      }\n\n      case \"remove\":\n        // Removals are handled by onDelete for atomic undo\n        break;\n    }\n  }\n}\n\n/**\n * Returns a controlled React Flow state backed by Liveblocks Storage.\n *\n * @example\n * ```tsx\n * const { nodes, edges, onNodesChange, onEdgesChange, onConnect, onDelete, isLoading } = useLiveblocksFlow();\n *\n * if (isLoading) {\n *   return <div>Loading…</div>\n * }\n *\n * return <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} onDelete={onDelete} />;\n * ```\n * Pass `{ suspense: true }` to suspend until Storage is ready, `nodes` and `edges` will never be `null`.\n *\n * @example\n * ```tsx\n * const { nodes, edges, onNodesChange, onEdgesChange, onConnect, onDelete } =\n *   useLiveblocksFlow({ suspense: true });\n *\n * return <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} onDelete={onDelete} />;\n * ```\n */\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options?: UseLiveblocksFlowOptions<N, E> & { suspense?: false }\n): Resolve<UseLiveblocksFlowResult<N, E>>;\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: UseLiveblocksFlowOptions<N, E> & { suspense: true }\n): Resolve<LiveblocksFlowSuspenseResult<N, E>>;\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: UseLiveblocksFlowOptions<N, E> = {}\n): Resolve<UseLiveblocksFlowResult<N, E> | LiveblocksFlowSuspenseResult<N, E>> {\n  const history = useHistory();\n  const isStorageLoaded = useStorage(() => true) ?? false;\n\n  // These options are not reactive, only their initial values are used.\n  const frozenOptions = useInitial({\n    nodes: options.nodes,\n    edges: options.edges,\n    storageKey: options.storageKey ?? DEFAULT_STORAGE_KEY,\n    suspense: options.suspense ?? false,\n  });\n\n  // Pre-compute sync config caches once (not on every render)\n  const [getNodeSyncConfig, getEdgeSyncConfig] = useMemo(\n    () =>\n      [\n        buildNodeConfigCache(frozenOptions.nodes?.sync),\n        buildEdgeConfigCache(frozenOptions.edges?.sync),\n      ] as const,\n    [frozenOptions]\n  );\n\n  // Storage already includes local overlays via toImmutable(), so no\n  // separate local layer is needed. Individual node/edge immutable references\n  // are already stable (only change when the underlying LiveObject changes).\n  const nodes = useStorage((storage) => {\n    const flow = storage[frozenOptions.storageKey] as\n      | ToImmutable<InternalLiveblocksFlow>\n      | undefined;\n    return flow?.nodes ? ([...flow.nodes.values()] as unknown as N[]) : null;\n  });\n  const edges = useStorage((storage) => {\n    const flow = storage[frozenOptions.storageKey] as\n      | ToImmutable<InternalLiveblocksFlow>\n      | undefined;\n    return flow?.edges ? ([...flow.edges.values()] as unknown as E[]) : null;\n  });\n\n  const onNodesChange = useMutation(\n    ({ storage }, changes: NodeChange<N>[]) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      applyNodeChanges(changes, flow.get(\"nodes\"), history, getNodeSyncConfig);\n    },\n    [history, frozenOptions, getNodeSyncConfig]\n  );\n\n  const onEdgesChange = useMutation(\n    ({ storage }, changes: EdgeChange<E>[]) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      applyEdgeChanges(changes, flow.get(\"edges\"), getEdgeSyncConfig);\n    },\n    [frozenOptions, getEdgeSyncConfig]\n  );\n\n  const onConnect = useMutation(\n    ({ storage }, connection: Connection) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      // Delegate to React Flow's own `addEdge` helper for consistent default\n      // edge ID generation, passing an empty array since de-duplication is\n      // already handled above.\n      const [newEdge] = defaultAddEdge(connection, [] as E[]);\n      if (!newEdge) {\n        return;\n      }\n\n      const edges = flow.get(\"edges\");\n      const config = getEdgeSyncConfig(newEdge.type);\n      edges.set(newEdge.id, toLiveblocksInternalEdge(newEdge, config));\n    },\n    [frozenOptions.storageKey, getEdgeSyncConfig]\n  );\n\n  const onDelete = useMutation(\n    ({ storage }, params: { nodes: N[]; edges: E[] }) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      const nodesMap = flow.get(\"nodes\");\n      const edgesMap = flow.get(\"edges\");\n\n      for (const edge of params.edges) {\n        edgesMap.delete(edge.id);\n      }\n\n      for (const node of params.nodes) {\n        nodesMap.delete(node.id);\n      }\n    },\n    [frozenOptions.storageKey]\n  );\n\n  const setInitialStorage = useMutation(\n    ({ storage }) => {\n      // Similarly to `initialStorage` on `Client.enterRoom` and `RoomProvider`, we only\n      // initialize Storage if it doesn't already exist.\n      if (storage.get(frozenOptions.storageKey) !== undefined) {\n        return;\n      }\n\n      const initialNodes = frozenOptions.nodes?.initial ?? [];\n      const initialEdges = frozenOptions.edges?.initial ?? [];\n\n      storage.set(\n        frozenOptions.storageKey,\n        new LiveObject({\n          nodes: new LiveMap(\n            initialNodes.map((node) => [\n              node.id,\n              toLiveblocksInternalNode(node, getNodeSyncConfig(node.type)),\n            ])\n          ),\n          edges: new LiveMap(\n            initialEdges.map((edge) => [\n              edge.id,\n              toLiveblocksInternalEdge(edge, getEdgeSyncConfig(edge.type)),\n            ])\n          ),\n        })\n      );\n    },\n    [frozenOptions, getNodeSyncConfig, getEdgeSyncConfig]\n  );\n\n  useEffect(() => {\n    if (isStorageLoaded) {\n      history[kInternal].withoutHistory(() => {\n        setInitialStorage();\n      });\n    }\n  }, [isStorageLoaded, setInitialStorage, history]);\n\n  if (frozenOptions.suspense) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `suspense` is frozen so this branch is stable\n    useSuspendUntilStorageReady();\n  }\n\n  return {\n    nodes: frozenOptions.suspense ? (nodes ?? (EMPTY_ARRAY as N[])) : nodes,\n    edges: frozenOptions.suspense ? (edges ?? (EMPTY_ARRAY as E[])) : edges,\n    isLoading: frozenOptions.suspense ? false : !isStorageLoaded,\n    onNodesChange,\n    onEdgesChange,\n    onConnect,\n    onDelete,\n  } as UseLiveblocksFlowResult<N, E> | LiveblocksFlowSuspenseResult<N, E>;\n}\n"],"names":["NODE_BASE_CONFIG","EDGE_BASE_CONFIG","toLiveblocksInternalNode","toLiveblocksInternalEdge","useHistory","useStorage","useInitial","DEFAULT_STORAGE_KEY","useMemo","useMutation","defaultAddEdge","edges","LiveObject","LiveMap","useEffect","kInternal","useSuspendUntilStorageReady"],"mappings":"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"}
+{"version":3,"file":"flow.cjs","sources":["../src/flow.ts"],"sourcesContent":["import type {\n  History,\n  JsonObject,\n  Resolve,\n  ToImmutable,\n} from \"@liveblocks/core\";\nimport { kInternal, LiveMap, LiveObject } from \"@liveblocks/core\";\nimport { useHistory, useMutation, useStorage } from \"@liveblocks/react\";\nimport {\n  useInitial,\n  useSuspendUntilStorageReady,\n} from \"@liveblocks/react/_private\";\nimport type {\n  BuiltInEdge,\n  BuiltInNode,\n  Connection,\n  Edge,\n  EdgeChange,\n  Node,\n  NodeChange,\n  OnConnect,\n  OnDelete,\n  OnEdgesChange,\n  OnNodesChange,\n} from \"@xyflow/react\";\nimport { addEdge as defaultAddEdge } from \"@xyflow/react\";\nimport { useEffect, useMemo } from \"react\";\n\nimport {\n  DEFAULT_STORAGE_KEY,\n  EDGE_BASE_CONFIG,\n  NODE_BASE_CONFIG,\n} from \"./constants\";\nimport { toLiveblocksInternalEdge, toLiveblocksInternalNode } from \"./helpers\";\nimport type {\n  EdgeSyncConfig,\n  InternalLiveblocksEdge,\n  InternalLiveblocksFlow,\n  InternalLiveblocksNode,\n  NodeSyncConfig,\n  SyncConfig,\n} from \"./types\";\n\nconst EMPTY_ARRAY = [] as unknown[];\n\ntype UseLiveblocksFlowResult<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> = Resolve<\n  (\n    | {\n        nodes: null;\n        edges: null;\n        isLoading: true;\n      }\n    | {\n        nodes: N[];\n        edges: E[];\n        isLoading: false;\n      }\n  ) & {\n    onNodesChange: OnNodesChange<N>;\n    onEdgesChange: OnEdgesChange<E>;\n    onConnect: OnConnect;\n    onDelete: OnDelete<N, E>;\n  }\n>;\n\ntype LiveblocksFlowSuspenseResult<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> = Extract<UseLiveblocksFlowResult<N, E>, { isLoading: false }>;\n\nfunction mergeAndBuildDataConfigCache(\n  base: SyncConfig,\n  data?: Record<string, SyncConfig | undefined>\n): (type: string | undefined) => SyncConfig {\n  if (!data) return () => base;\n\n  const dataFallback = data[\"*\"];\n  const fallback = dataFallback ? { ...base, data: dataFallback } : base;\n\n  // Pre-compute full node/edge sync configs for all explicitly declared types\n  const cache = new Map<string | undefined, SyncConfig>();\n  for (const type in data) {\n    if (type === \"*\") continue;\n    const specific = data[type];\n    if (!specific) continue;\n    const dataConfig: SyncConfig = { ...dataFallback, ...specific };\n    cache.set(type, { ...base, data: dataConfig });\n  }\n\n  return (type) => cache.get(type) || fallback;\n}\n\nfunction buildNodeConfigCache<N extends Node>(\n  /** The user-provided node data sync configuration, if any. */\n  nodeDataConfig?: NodeSyncConfig<N>\n): (type: string | undefined) => SyncConfig {\n  return mergeAndBuildDataConfigCache(NODE_BASE_CONFIG, nodeDataConfig);\n}\n\nfunction buildEdgeConfigCache<E extends Edge>(\n  /** The user-provided edge data sync configuration, if any. */\n  edgeDataConfig?: EdgeSyncConfig<E>\n): (type: string | undefined) => SyncConfig {\n  return mergeAndBuildDataConfigCache(EDGE_BASE_CONFIG, edgeDataConfig);\n}\n\ntype UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {\n  nodes?: {\n    /**\n     * The initial React Flow nodes.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   nodes: {\n     *     initial: [\n     *       { id: \"1\", position: { x: 0, y: 0 }, data: { label: \"Node 1\" } },\n     *       { id: \"2\", position: { x: 0, y: 100 }, data: { label: \"Node 2\" } },\n     *     ],\n     *   },\n     * });\n     * ```\n     */\n    initial?: N[];\n    /**\n     * Per-type sync configuration for node data keys.\n     *\n     * Each key in the config is either:\n     * - `false` - Local-only, not synced to other clients\n     * - `\"atomic\"` - Synced as a single value (replaced as-a-whole, not patched)\n     * - `true` (or absent) - Deep sync (default, objects/arrays are patched)\n     * - `{ ... }` - Nested config, applies recursively to sub-keys\n     *\n     * Use `\"*\"` as a fallback for all node types. Type-specific entries are\n     * deep-merged on top of `\"*\"`, with explicitly named keys taking\n     * precedence.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   nodes: {\n     *     sync: {\n     *       \"*\": {\n     *         label: false,       // Don't sync node.data.label\n     *         color: \"atomic\",    // Sync as a single value, replaced as-a-whole\n     *       },\n     *       myCustomNode: {\n     *         showPreview: false,  // Don't sync myCustomNode.data.showPreview\n     *       },\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    sync?: NodeSyncConfig<N>;\n  };\n\n  edges?: {\n    initial?: E[];\n    /**\n     * Per-type sync configuration for edge data keys.\n     *\n     * Each key in the config is either:\n     * - `false` - Local-only, not synced to other clients\n     * - `\"atomic\"` - Synced as a single value (replaced as-a-whole, not patched)\n     * - `true` (or absent) - Deep sync (default, objects/arrays are patched)\n     * - `{ ... }` - Nested config, applies recursively to sub-keys\n     *\n     * Use `\"*\"` as a fallback for all edge types. Type-specific entries are\n     * deep-merged on top of `\"*\"`, with explicitly named keys taking\n     * precedence.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   edges: {\n     *     sync: {\n     *       \"*\": {\n     *         hovered: false,       // Don't sync edge.data.hovered\n     *         style: \"atomic\",      // Sync as a single value, replaced as-a-whole\n     *       },\n     *       myCustomEdge: {\n     *         isHighlighted: false,  // Don't sync myCustomEdge.data.isHighlighted\n     *       },\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    sync?: EdgeSyncConfig<E>;\n  };\n\n  /**\n   * The key used to store the React Flow diagram in Liveblocks Storage.\n   * Defaults to `\"flow\"`.\n   */\n  storageKey?: string;\n\n  /**\n   * When true, suspends until Storage is ready (use a React `Suspense`\n   * boundary). Then `nodes` and `edges` are always arrays and `isLoading` is\n   * always false.\n   */\n  suspense?: boolean;\n};\n\n// Similar to React Flow's `applyNodeChanges()`, but writes local-only\n// properties via `setLocal()` / `delete()` on the LiveObject directly.\n// https://reactflow.dev/api-reference/utils/apply-node-changes\nfunction applyNodeChanges<N extends Node>(\n  changes: NodeChange<N>[],\n  nodes: LiveMap<string, InternalLiveblocksNode>,\n  history: History,\n  getNodeSyncConfig: (nodeType: string | undefined) => SyncConfig\n): void {\n  for (const change of changes) {\n    switch (change.type) {\n      case \"add\":\n      case \"replace\": {\n        const config = getNodeSyncConfig(change.item.type);\n        const existing = nodes.get(change.item.id);\n        if (existing) {\n          existing.reconcile(change.item as unknown as JsonObject, config);\n        } else {\n          nodes.set(\n            change.item.id,\n            toLiveblocksInternalNode(change.item, config)\n          );\n        }\n        break;\n      }\n\n      case \"position\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        // Pause before setting the first position change so it doesn't create a separate undo step.\n        if (change.dragging === true) {\n          history.pause();\n        }\n\n        if (change.position !== undefined) {\n          const prev = node.get(\"position\");\n          if (prev?.x !== change.position.x || prev?.y !== change.position.y) {\n            node.set(\"position\", change.position);\n          }\n        }\n\n        if (change.dragging !== undefined) {\n          if (change.dragging === false) {\n            history.resume();\n          }\n          // Must match NODE_BASE_CONFIG's `dragging: false`\n          node.setLocal(\"dragging\", change.dragging);\n        }\n        break;\n      }\n\n      case \"dimensions\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        // Pause before setting the first position change so it doesn't create a separate undo step.\n        if (change.resizing === true) {\n          history.pause();\n        }\n\n        if (\n          change.dimensions !== undefined &&\n          change.setAttributes !== undefined\n        ) {\n          if (\n            change.setAttributes === true ||\n            change.setAttributes === \"width\"\n          ) {\n            node.set(\"width\", change.dimensions.width);\n          }\n\n          if (\n            change.setAttributes === true ||\n            change.setAttributes === \"height\"\n          ) {\n            node.set(\"height\", change.dimensions.height);\n          }\n        }\n\n        if (change.dimensions !== undefined) {\n          // Must match NODE_BASE_CONFIG's `measured: false`\n          node.setLocal(\"measured\", change.dimensions);\n        }\n\n        if (change.resizing !== undefined) {\n          if (change.resizing === false) {\n            history.resume();\n          }\n          // Must match NODE_BASE_CONFIG's `resizing: false`\n          node.setLocal(\"resizing\", change.resizing);\n        }\n\n        break;\n      }\n\n      case \"select\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        // Must match NODE_BASE_CONFIG's `selected: false`\n        node.setLocal(\"selected\", change.selected);\n        break;\n      }\n\n      case \"remove\":\n        // Removals are handled by onDelete for atomic undo\n        break;\n    }\n  }\n}\n\n// Similar to React Flow's `applyEdgeChanges()`, but writes local-only\n// properties via `setLocal()` / `delete()` on the LiveObject directly.\n// https://reactflow.dev/api-reference/utils/apply-edge-changes\nfunction applyEdgeChanges<E extends Edge>(\n  changes: EdgeChange<E>[],\n  edges: LiveMap<string, InternalLiveblocksEdge>,\n  getEdgeSyncConfig: (type: string | undefined) => SyncConfig\n): void {\n  for (const change of changes) {\n    switch (change.type) {\n      case \"add\":\n      case \"replace\": {\n        const config = getEdgeSyncConfig(change.item.type);\n        const existing = edges.get(change.item.id);\n        if (existing) {\n          existing.reconcile(change.item as unknown as JsonObject, config);\n        } else {\n          edges.set(\n            change.item.id,\n            toLiveblocksInternalEdge(change.item, config)\n          );\n        }\n        break;\n      }\n\n      case \"select\": {\n        const edge = edges.get(change.id);\n        if (!edge) break;\n        // Must match EDGE_BASE_CONFIG's `selected: false`\n        edge.setLocal(\"selected\", change.selected);\n        break;\n      }\n\n      case \"remove\":\n        // Removals are handled by onDelete for atomic undo\n        break;\n    }\n  }\n}\n\n/**\n * Returns a controlled React Flow state backed by Liveblocks Storage.\n *\n * @example\n * ```tsx\n * const { nodes, edges, onNodesChange, onEdgesChange, onConnect, onDelete, isLoading } = useLiveblocksFlow();\n *\n * if (isLoading) {\n *   return <div>Loading…</div>\n * }\n *\n * return <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} onDelete={onDelete} />;\n * ```\n * Pass `{ suspense: true }` to suspend until Storage is ready, `nodes` and `edges` will never be `null`.\n *\n * @example\n * ```tsx\n * const { nodes, edges, onNodesChange, onEdgesChange, onConnect, onDelete } =\n *   useLiveblocksFlow({ suspense: true });\n *\n * return <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} onDelete={onDelete} />;\n * ```\n */\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options?: UseLiveblocksFlowOptions<N, E> & { suspense?: false }\n): Resolve<UseLiveblocksFlowResult<N, E>>;\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: UseLiveblocksFlowOptions<N, E> & { suspense: true }\n): Resolve<LiveblocksFlowSuspenseResult<N, E>>;\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: UseLiveblocksFlowOptions<N, E> = {}\n): Resolve<UseLiveblocksFlowResult<N, E> | LiveblocksFlowSuspenseResult<N, E>> {\n  const history = useHistory();\n  const isStorageLoaded = useStorage(() => true) ?? false;\n\n  // These options are not reactive, only their initial values are used.\n  const frozenOptions = useInitial({\n    nodes: options.nodes,\n    edges: options.edges,\n    storageKey: options.storageKey ?? DEFAULT_STORAGE_KEY,\n    suspense: options.suspense ?? false,\n  });\n\n  // Pre-compute sync config caches once (not on every render)\n  const [getNodeSyncConfig, getEdgeSyncConfig] = useMemo(\n    () =>\n      [\n        buildNodeConfigCache(frozenOptions.nodes?.sync),\n        buildEdgeConfigCache(frozenOptions.edges?.sync),\n      ] as const,\n    [frozenOptions]\n  );\n\n  // Storage already includes local overlays via toImmutable(), so no\n  // separate local layer is needed. Individual node/edge immutable references\n  // are already stable (only change when the underlying LiveObject changes).\n  const nodes = useStorage((storage) => {\n    const flow = storage[frozenOptions.storageKey] as\n      | ToImmutable<InternalLiveblocksFlow>\n      | undefined;\n    return flow?.nodes ? ([...flow.nodes.values()] as unknown as N[]) : null;\n  });\n  const edges = useStorage((storage) => {\n    const flow = storage[frozenOptions.storageKey] as\n      | ToImmutable<InternalLiveblocksFlow>\n      | undefined;\n    return flow?.edges ? ([...flow.edges.values()] as unknown as E[]) : null;\n  });\n\n  const onNodesChange = useMutation(\n    ({ storage }, changes: NodeChange<N>[]) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      applyNodeChanges(changes, flow.get(\"nodes\"), history, getNodeSyncConfig);\n    },\n    [history, frozenOptions, getNodeSyncConfig]\n  );\n\n  const onEdgesChange = useMutation(\n    ({ storage }, changes: EdgeChange<E>[]) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      applyEdgeChanges(changes, flow.get(\"edges\"), getEdgeSyncConfig);\n    },\n    [frozenOptions, getEdgeSyncConfig]\n  );\n\n  const onConnect = useMutation(\n    ({ storage }, connection: Connection) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      // Delegate to React Flow's own `addEdge` helper for consistent default\n      // edge ID generation, passing an empty array since de-duplication is\n      // already handled above.\n      const [newEdge] = defaultAddEdge(connection, [] as E[]);\n      if (!newEdge) {\n        return;\n      }\n\n      const edges = flow.get(\"edges\");\n      const config = getEdgeSyncConfig(newEdge.type);\n      edges.set(newEdge.id, toLiveblocksInternalEdge(newEdge, config));\n    },\n    [frozenOptions.storageKey, getEdgeSyncConfig]\n  );\n\n  const onDelete = useMutation(\n    ({ storage }, params: { nodes: N[]; edges: E[] }) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      const nodesMap = flow.get(\"nodes\");\n      const edgesMap = flow.get(\"edges\");\n\n      for (const edge of params.edges) {\n        edgesMap.delete(edge.id);\n      }\n\n      for (const node of params.nodes) {\n        nodesMap.delete(node.id);\n      }\n    },\n    [frozenOptions.storageKey]\n  );\n\n  const setInitialStorage = useMutation(\n    ({ storage }) => {\n      // Similarly to `initialStorage` on `Client.enterRoom` and `RoomProvider`, we only\n      // initialize Storage if it doesn't already exist.\n      if (storage.get(frozenOptions.storageKey) !== undefined) {\n        return;\n      }\n\n      const initialNodes = frozenOptions.nodes?.initial ?? [];\n      const initialEdges = frozenOptions.edges?.initial ?? [];\n\n      storage.set(\n        frozenOptions.storageKey,\n        new LiveObject({\n          nodes: new LiveMap(\n            initialNodes.map((node) => [\n              node.id,\n              toLiveblocksInternalNode(node, getNodeSyncConfig(node.type)),\n            ])\n          ),\n          edges: new LiveMap(\n            initialEdges.map((edge) => [\n              edge.id,\n              toLiveblocksInternalEdge(edge, getEdgeSyncConfig(edge.type)),\n            ])\n          ),\n        })\n      );\n    },\n    [frozenOptions, getNodeSyncConfig, getEdgeSyncConfig]\n  );\n\n  useEffect(() => {\n    if (isStorageLoaded) {\n      history[kInternal].withoutHistory(() => {\n        setInitialStorage();\n      });\n    }\n  }, [isStorageLoaded, setInitialStorage, history]);\n\n  if (frozenOptions.suspense) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `suspense` is frozen so this branch is stable\n    useSuspendUntilStorageReady();\n  }\n\n  return {\n    nodes: frozenOptions.suspense ? (nodes ?? (EMPTY_ARRAY as N[])) : nodes,\n    edges: frozenOptions.suspense ? (edges ?? (EMPTY_ARRAY as E[])) : edges,\n    isLoading: frozenOptions.suspense ? false : !isStorageLoaded,\n    onNodesChange,\n    onEdgesChange,\n    onConnect,\n    onDelete,\n  } as UseLiveblocksFlowResult<N, E> | LiveblocksFlowSuspenseResult<N, E>;\n}\n"],"names":["NODE_BASE_CONFIG","EDGE_BASE_CONFIG","toLiveblocksInternalNode","toLiveblocksInternalEdge","useHistory","useStorage","useInitial","DEFAULT_STORAGE_KEY","useMemo","useMutation","defaultAddEdge","edges","LiveObject","LiveMap","useEffect","kInternal","useSuspendUntilStorageReady"],"mappings":"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"}

package/dist/flow.js

@@ -49,15 +49,19 @@ function applyNodeChanges(changes, nodes, history, getNodeSyncConfig) {
       }
       case "position": {
         const node = nodes.get(change.id);
-        if (!node || !change.position)
+        if (!node)
           break;
+        if (change.dragging === true) {
+          history.pause();
+        }
         if (change.position !== void 0) {
-          node.set("position", change.position);
+          const prev = node.get("position");
+          if (prev?.x !== change.position.x || prev?.y !== change.position.y) {
+            node.set("position", change.position);
+          }
         }
         if (change.dragging !== void 0) {
-          if (change.dragging) {
-            history.pause();
-          } else {
+          if (change.dragging === false) {
             history.resume();
           }
           node.setLocal("dragging", change.dragging);
@@ -68,6 +72,9 @@ function applyNodeChanges(changes, nodes, history, getNodeSyncConfig) {
         const node = nodes.get(change.id);
         if (!node)
           break;
+        if (change.resizing === true) {
+          history.pause();
+        }
         if (change.dimensions !== void 0 && change.setAttributes !== void 0) {
           if (change.setAttributes === true || change.setAttributes === "width") {
             node.set("width", change.dimensions.width);
@@ -80,9 +87,7 @@ function applyNodeChanges(changes, nodes, history, getNodeSyncConfig) {
           node.setLocal("measured", change.dimensions);
         }
         if (change.resizing !== void 0) {
-          if (change.resizing) {
-            history.pause();
-          } else {
+          if (change.resizing === false) {
             history.resume();
           }
           node.setLocal("resizing", change.resizing);

package/dist/flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.js","sources":["../src/flow.ts"],"sourcesContent":["import type {\n  History,\n  JsonObject,\n  Resolve,\n  ToImmutable,\n} from \"@liveblocks/core\";\nimport { kInternal, LiveMap, LiveObject } from \"@liveblocks/core\";\nimport { useHistory, useMutation, useStorage } from \"@liveblocks/react\";\nimport {\n  useInitial,\n  useSuspendUntilStorageReady,\n} from \"@liveblocks/react/_private\";\nimport type {\n  BuiltInEdge,\n  BuiltInNode,\n  Connection,\n  Edge,\n  EdgeChange,\n  Node,\n  NodeChange,\n  OnConnect,\n  OnDelete,\n  OnEdgesChange,\n  OnNodesChange,\n} from \"@xyflow/react\";\nimport { addEdge as defaultAddEdge } from \"@xyflow/react\";\nimport { useEffect, useMemo } from \"react\";\n\nimport {\n  DEFAULT_STORAGE_KEY,\n  EDGE_BASE_CONFIG,\n  NODE_BASE_CONFIG,\n} from \"./constants\";\nimport { toLiveblocksInternalEdge, toLiveblocksInternalNode } from \"./helpers\";\nimport type {\n  EdgeSyncConfig,\n  InternalLiveblocksEdge,\n  InternalLiveblocksFlow,\n  InternalLiveblocksNode,\n  NodeSyncConfig,\n  SyncConfig,\n} from \"./types\";\n\nconst EMPTY_ARRAY = [] as unknown[];\n\ntype UseLiveblocksFlowResult<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> = Resolve<\n  (\n    | {\n        nodes: null;\n        edges: null;\n        isLoading: true;\n      }\n    | {\n        nodes: N[];\n        edges: E[];\n        isLoading: false;\n      }\n  ) & {\n    onNodesChange: OnNodesChange<N>;\n    onEdgesChange: OnEdgesChange<E>;\n    onConnect: OnConnect;\n    onDelete: OnDelete<N, E>;\n  }\n>;\n\ntype LiveblocksFlowSuspenseResult<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> = Extract<UseLiveblocksFlowResult<N, E>, { isLoading: false }>;\n\nfunction mergeAndBuildDataConfigCache(\n  base: SyncConfig,\n  data?: Record<string, SyncConfig | undefined>\n): (type: string | undefined) => SyncConfig {\n  if (!data) return () => base;\n\n  const dataFallback = data[\"*\"];\n  const fallback = dataFallback ? { ...base, data: dataFallback } : base;\n\n  // Pre-compute full node/edge sync configs for all explicitly declared types\n  const cache = new Map<string | undefined, SyncConfig>();\n  for (const type in data) {\n    if (type === \"*\") continue;\n    const specific = data[type];\n    if (!specific) continue;\n    const dataConfig: SyncConfig = { ...dataFallback, ...specific };\n    cache.set(type, { ...base, data: dataConfig });\n  }\n\n  return (type) => cache.get(type) || fallback;\n}\n\nfunction buildNodeConfigCache<N extends Node>(\n  /** The user-provided node data sync configuration, if any. */\n  nodeDataConfig?: NodeSyncConfig<N>\n): (type: string | undefined) => SyncConfig {\n  return mergeAndBuildDataConfigCache(NODE_BASE_CONFIG, nodeDataConfig);\n}\n\nfunction buildEdgeConfigCache<E extends Edge>(\n  /** The user-provided edge data sync configuration, if any. */\n  edgeDataConfig?: EdgeSyncConfig<E>\n): (type: string | undefined) => SyncConfig {\n  return mergeAndBuildDataConfigCache(EDGE_BASE_CONFIG, edgeDataConfig);\n}\n\ntype UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {\n  nodes?: {\n    /**\n     * The initial React Flow nodes.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   nodes: {\n     *     initial: [\n     *       { id: \"1\", position: { x: 0, y: 0 }, data: { label: \"Node 1\" } },\n     *       { id: \"2\", position: { x: 0, y: 100 }, data: { label: \"Node 2\" } },\n     *     ],\n     *   },\n     * });\n     * ```\n     */\n    initial?: N[];\n    /**\n     * Per-type sync configuration for node data keys.\n     *\n     * Use `\"*\"` as a fallback for all node types. Type-specific entries are\n     * deep-merged on top of `\"*\"`, with explicitly named keys taking\n     * precedence.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   nodes: {\n     *     sync: {\n     *       // Fallback for all node types\n     *       \"*\": {\n     *         label: false,  // Don't sync node.data.label\n     *       },\n     *\n     *       // Override for node.type === 'myCustomNode'\n     *       // This will also not sync `myCustomNode.data.label` (because of the fallback above)\n     *       myCustomNode: {\n     *         showPreview: false,  // Don't sync myCustomNode.data.showPreview\n     *       },\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    sync?: NodeSyncConfig<N>;\n  };\n\n  edges?: {\n    initial?: E[];\n    /**\n     * Per-type sync configuration for edge data keys.\n     *\n     * Use `\"*\"` as a fallback for all edge types. Type-specific entries are\n     * deep-merged on top of `\"*\"`, with explicitly named keys taking\n     * precedence.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   edges: {\n     *     sync: {\n     *       // Fallback for all edge types\n     *       \"*\": {\n     *         hovered: false,  // Don't sync edge.data.hovered\n     *       },\n     *\n     *       // Override for edge.type === 'myCustomEdge'\n     *       // This will also not sync `myCustomEdge.data.hovered` (because of the fallback above)\n     *       myCustomEdge: {\n     *         isHighlighted: false,  // Don't sync myCustomEdge.data.isHighlighted\n     *       },\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    sync?: EdgeSyncConfig<E>;\n  };\n\n  /**\n   * The key used to store the React Flow diagram in Liveblocks Storage.\n   * Defaults to `\"flow\"`.\n   */\n  storageKey?: string;\n\n  /**\n   * When true, suspends until Storage is ready (use a React `Suspense`\n   * boundary). Then `nodes` and `edges` are always arrays and `isLoading` is\n   * always false.\n   */\n  suspense?: boolean;\n};\n\n// Similar to React Flow's `applyNodeChanges()`, but writes local-only\n// properties via `setLocal()` / `delete()` on the LiveObject directly.\n// https://reactflow.dev/api-reference/utils/apply-node-changes\nfunction applyNodeChanges<N extends Node>(\n  changes: NodeChange<N>[],\n  nodes: LiveMap<string, InternalLiveblocksNode>,\n  history: History,\n  getNodeSyncConfig: (nodeType: string | undefined) => SyncConfig\n): void {\n  for (const change of changes) {\n    switch (change.type) {\n      case \"add\":\n      case \"replace\": {\n        const config = getNodeSyncConfig(change.item.type);\n        const existing = nodes.get(change.item.id);\n        if (existing) {\n          existing.reconcile(change.item as unknown as JsonObject, config);\n        } else {\n          nodes.set(\n            change.item.id,\n            toLiveblocksInternalNode(change.item, config)\n          );\n        }\n        break;\n      }\n\n      case \"position\": {\n        const node = nodes.get(change.id);\n        if (!node || !change.position) break;\n\n        if (change.position !== undefined) {\n          node.set(\"position\", change.position);\n        }\n\n        if (change.dragging !== undefined) {\n          if (change.dragging) {\n            history.pause();\n          } else {\n            history.resume();\n          }\n          // Must match NODE_BASE_CONFIG's `dragging: false`\n          node.setLocal(\"dragging\", change.dragging);\n        }\n        break;\n      }\n\n      case \"dimensions\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        if (\n          change.dimensions !== undefined &&\n          change.setAttributes !== undefined\n        ) {\n          if (\n            change.setAttributes === true ||\n            change.setAttributes === \"width\"\n          ) {\n            node.set(\"width\", change.dimensions.width);\n          }\n\n          if (\n            change.setAttributes === true ||\n            change.setAttributes === \"height\"\n          ) {\n            node.set(\"height\", change.dimensions.height);\n          }\n        }\n\n        if (change.dimensions !== undefined) {\n          // Must match NODE_BASE_CONFIG's `measured: false`\n          node.setLocal(\"measured\", change.dimensions);\n        }\n\n        if (change.resizing !== undefined) {\n          if (change.resizing) {\n            history.pause();\n          } else {\n            history.resume();\n          }\n          // Must match NODE_BASE_CONFIG's `resizing: false`\n          node.setLocal(\"resizing\", change.resizing);\n        }\n\n        break;\n      }\n\n      case \"select\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        // Must match NODE_BASE_CONFIG's `selected: false`\n        node.setLocal(\"selected\", change.selected);\n        break;\n      }\n\n      case \"remove\":\n        // Removals are handled by onDelete for atomic undo\n        break;\n    }\n  }\n}\n\n// Similar to React Flow's `applyEdgeChanges()`, but writes local-only\n// properties via `setLocal()` / `delete()` on the LiveObject directly.\n// https://reactflow.dev/api-reference/utils/apply-edge-changes\nfunction applyEdgeChanges<E extends Edge>(\n  changes: EdgeChange<E>[],\n  edges: LiveMap<string, InternalLiveblocksEdge>,\n  getEdgeSyncConfig: (type: string | undefined) => SyncConfig\n): void {\n  for (const change of changes) {\n    switch (change.type) {\n      case \"add\":\n      case \"replace\": {\n        const config = getEdgeSyncConfig(change.item.type);\n        const existing = edges.get(change.item.id);\n        if (existing) {\n          existing.reconcile(change.item as unknown as JsonObject, config);\n        } else {\n          edges.set(\n            change.item.id,\n            toLiveblocksInternalEdge(change.item, config)\n          );\n        }\n        break;\n      }\n\n      case \"select\": {\n        const edge = edges.get(change.id);\n        if (!edge) break;\n        // Must match EDGE_BASE_CONFIG's `selected: false`\n        edge.setLocal(\"selected\", change.selected);\n        break;\n      }\n\n      case \"remove\":\n        // Removals are handled by onDelete for atomic undo\n        break;\n    }\n  }\n}\n\n/**\n * Returns a controlled React Flow state backed by Liveblocks Storage.\n *\n * @example\n * ```tsx\n * const { nodes, edges, onNodesChange, onEdgesChange, onConnect, onDelete, isLoading } = useLiveblocksFlow();\n *\n * if (isLoading) {\n *   return <div>Loading…</div>\n * }\n *\n * return <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} onDelete={onDelete} />;\n * ```\n * Pass `{ suspense: true }` to suspend until Storage is ready, `nodes` and `edges` will never be `null`.\n *\n * @example\n * ```tsx\n * const { nodes, edges, onNodesChange, onEdgesChange, onConnect, onDelete } =\n *   useLiveblocksFlow({ suspense: true });\n *\n * return <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} onDelete={onDelete} />;\n * ```\n */\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options?: UseLiveblocksFlowOptions<N, E> & { suspense?: false }\n): Resolve<UseLiveblocksFlowResult<N, E>>;\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: UseLiveblocksFlowOptions<N, E> & { suspense: true }\n): Resolve<LiveblocksFlowSuspenseResult<N, E>>;\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: UseLiveblocksFlowOptions<N, E> = {}\n): Resolve<UseLiveblocksFlowResult<N, E> | LiveblocksFlowSuspenseResult<N, E>> {\n  const history = useHistory();\n  const isStorageLoaded = useStorage(() => true) ?? false;\n\n  // These options are not reactive, only their initial values are used.\n  const frozenOptions = useInitial({\n    nodes: options.nodes,\n    edges: options.edges,\n    storageKey: options.storageKey ?? DEFAULT_STORAGE_KEY,\n    suspense: options.suspense ?? false,\n  });\n\n  // Pre-compute sync config caches once (not on every render)\n  const [getNodeSyncConfig, getEdgeSyncConfig] = useMemo(\n    () =>\n      [\n        buildNodeConfigCache(frozenOptions.nodes?.sync),\n        buildEdgeConfigCache(frozenOptions.edges?.sync),\n      ] as const,\n    [frozenOptions]\n  );\n\n  // Storage already includes local overlays via toImmutable(), so no\n  // separate local layer is needed. Individual node/edge immutable references\n  // are already stable (only change when the underlying LiveObject changes).\n  const nodes = useStorage((storage) => {\n    const flow = storage[frozenOptions.storageKey] as\n      | ToImmutable<InternalLiveblocksFlow>\n      | undefined;\n    return flow?.nodes ? ([...flow.nodes.values()] as unknown as N[]) : null;\n  });\n  const edges = useStorage((storage) => {\n    const flow = storage[frozenOptions.storageKey] as\n      | ToImmutable<InternalLiveblocksFlow>\n      | undefined;\n    return flow?.edges ? ([...flow.edges.values()] as unknown as E[]) : null;\n  });\n\n  const onNodesChange = useMutation(\n    ({ storage }, changes: NodeChange<N>[]) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      applyNodeChanges(changes, flow.get(\"nodes\"), history, getNodeSyncConfig);\n    },\n    [history, frozenOptions, getNodeSyncConfig]\n  );\n\n  const onEdgesChange = useMutation(\n    ({ storage }, changes: EdgeChange<E>[]) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      applyEdgeChanges(changes, flow.get(\"edges\"), getEdgeSyncConfig);\n    },\n    [frozenOptions, getEdgeSyncConfig]\n  );\n\n  const onConnect = useMutation(\n    ({ storage }, connection: Connection) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      // Delegate to React Flow's own `addEdge` helper for consistent default\n      // edge ID generation, passing an empty array since de-duplication is\n      // already handled above.\n      const [newEdge] = defaultAddEdge(connection, [] as E[]);\n      if (!newEdge) {\n        return;\n      }\n\n      const edges = flow.get(\"edges\");\n      const config = getEdgeSyncConfig(newEdge.type);\n      edges.set(newEdge.id, toLiveblocksInternalEdge(newEdge, config));\n    },\n    [frozenOptions.storageKey, getEdgeSyncConfig]\n  );\n\n  const onDelete = useMutation(\n    ({ storage }, params: { nodes: N[]; edges: E[] }) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      const nodesMap = flow.get(\"nodes\");\n      const edgesMap = flow.get(\"edges\");\n\n      for (const edge of params.edges) {\n        edgesMap.delete(edge.id);\n      }\n\n      for (const node of params.nodes) {\n        nodesMap.delete(node.id);\n      }\n    },\n    [frozenOptions.storageKey]\n  );\n\n  const setInitialStorage = useMutation(\n    ({ storage }) => {\n      // Similarly to `initialStorage` on `Client.enterRoom` and `RoomProvider`, we only\n      // initialize Storage if it doesn't already exist.\n      if (storage.get(frozenOptions.storageKey) !== undefined) {\n        return;\n      }\n\n      const initialNodes = frozenOptions.nodes?.initial ?? [];\n      const initialEdges = frozenOptions.edges?.initial ?? [];\n\n      storage.set(\n        frozenOptions.storageKey,\n        new LiveObject({\n          nodes: new LiveMap(\n            initialNodes.map((node) => [\n              node.id,\n              toLiveblocksInternalNode(node, getNodeSyncConfig(node.type)),\n            ])\n          ),\n          edges: new LiveMap(\n            initialEdges.map((edge) => [\n              edge.id,\n              toLiveblocksInternalEdge(edge, getEdgeSyncConfig(edge.type)),\n            ])\n          ),\n        })\n      );\n    },\n    [frozenOptions, getNodeSyncConfig, getEdgeSyncConfig]\n  );\n\n  useEffect(() => {\n    if (isStorageLoaded) {\n      history[kInternal].withoutHistory(() => {\n        setInitialStorage();\n      });\n    }\n  }, [isStorageLoaded, setInitialStorage, history]);\n\n  if (frozenOptions.suspense) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `suspense` is frozen so this branch is stable\n    useSuspendUntilStorageReady();\n  }\n\n  return {\n    nodes: frozenOptions.suspense ? (nodes ?? (EMPTY_ARRAY as N[])) : nodes,\n    edges: frozenOptions.suspense ? (edges ?? (EMPTY_ARRAY as E[])) : edges,\n    isLoading: frozenOptions.suspense ? false : !isStorageLoaded,\n    onNodesChange,\n    onEdgesChange,\n    onConnect,\n    onDelete,\n  } as UseLiveblocksFlowResult<N, E> | LiveblocksFlowSuspenseResult<N, E>;\n}\n"],"names":["defaultAddEdge","edges"],"mappings":"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"}
+{"version":3,"file":"flow.js","sources":["../src/flow.ts"],"sourcesContent":["import type {\n  History,\n  JsonObject,\n  Resolve,\n  ToImmutable,\n} from \"@liveblocks/core\";\nimport { kInternal, LiveMap, LiveObject } from \"@liveblocks/core\";\nimport { useHistory, useMutation, useStorage } from \"@liveblocks/react\";\nimport {\n  useInitial,\n  useSuspendUntilStorageReady,\n} from \"@liveblocks/react/_private\";\nimport type {\n  BuiltInEdge,\n  BuiltInNode,\n  Connection,\n  Edge,\n  EdgeChange,\n  Node,\n  NodeChange,\n  OnConnect,\n  OnDelete,\n  OnEdgesChange,\n  OnNodesChange,\n} from \"@xyflow/react\";\nimport { addEdge as defaultAddEdge } from \"@xyflow/react\";\nimport { useEffect, useMemo } from \"react\";\n\nimport {\n  DEFAULT_STORAGE_KEY,\n  EDGE_BASE_CONFIG,\n  NODE_BASE_CONFIG,\n} from \"./constants\";\nimport { toLiveblocksInternalEdge, toLiveblocksInternalNode } from \"./helpers\";\nimport type {\n  EdgeSyncConfig,\n  InternalLiveblocksEdge,\n  InternalLiveblocksFlow,\n  InternalLiveblocksNode,\n  NodeSyncConfig,\n  SyncConfig,\n} from \"./types\";\n\nconst EMPTY_ARRAY = [] as unknown[];\n\ntype UseLiveblocksFlowResult<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> = Resolve<\n  (\n    | {\n        nodes: null;\n        edges: null;\n        isLoading: true;\n      }\n    | {\n        nodes: N[];\n        edges: E[];\n        isLoading: false;\n      }\n  ) & {\n    onNodesChange: OnNodesChange<N>;\n    onEdgesChange: OnEdgesChange<E>;\n    onConnect: OnConnect;\n    onDelete: OnDelete<N, E>;\n  }\n>;\n\ntype LiveblocksFlowSuspenseResult<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n> = Extract<UseLiveblocksFlowResult<N, E>, { isLoading: false }>;\n\nfunction mergeAndBuildDataConfigCache(\n  base: SyncConfig,\n  data?: Record<string, SyncConfig | undefined>\n): (type: string | undefined) => SyncConfig {\n  if (!data) return () => base;\n\n  const dataFallback = data[\"*\"];\n  const fallback = dataFallback ? { ...base, data: dataFallback } : base;\n\n  // Pre-compute full node/edge sync configs for all explicitly declared types\n  const cache = new Map<string | undefined, SyncConfig>();\n  for (const type in data) {\n    if (type === \"*\") continue;\n    const specific = data[type];\n    if (!specific) continue;\n    const dataConfig: SyncConfig = { ...dataFallback, ...specific };\n    cache.set(type, { ...base, data: dataConfig });\n  }\n\n  return (type) => cache.get(type) || fallback;\n}\n\nfunction buildNodeConfigCache<N extends Node>(\n  /** The user-provided node data sync configuration, if any. */\n  nodeDataConfig?: NodeSyncConfig<N>\n): (type: string | undefined) => SyncConfig {\n  return mergeAndBuildDataConfigCache(NODE_BASE_CONFIG, nodeDataConfig);\n}\n\nfunction buildEdgeConfigCache<E extends Edge>(\n  /** The user-provided edge data sync configuration, if any. */\n  edgeDataConfig?: EdgeSyncConfig<E>\n): (type: string | undefined) => SyncConfig {\n  return mergeAndBuildDataConfigCache(EDGE_BASE_CONFIG, edgeDataConfig);\n}\n\ntype UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {\n  nodes?: {\n    /**\n     * The initial React Flow nodes.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   nodes: {\n     *     initial: [\n     *       { id: \"1\", position: { x: 0, y: 0 }, data: { label: \"Node 1\" } },\n     *       { id: \"2\", position: { x: 0, y: 100 }, data: { label: \"Node 2\" } },\n     *     ],\n     *   },\n     * });\n     * ```\n     */\n    initial?: N[];\n    /**\n     * Per-type sync configuration for node data keys.\n     *\n     * Each key in the config is either:\n     * - `false` - Local-only, not synced to other clients\n     * - `\"atomic\"` - Synced as a single value (replaced as-a-whole, not patched)\n     * - `true` (or absent) - Deep sync (default, objects/arrays are patched)\n     * - `{ ... }` - Nested config, applies recursively to sub-keys\n     *\n     * Use `\"*\"` as a fallback for all node types. Type-specific entries are\n     * deep-merged on top of `\"*\"`, with explicitly named keys taking\n     * precedence.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   nodes: {\n     *     sync: {\n     *       \"*\": {\n     *         label: false,       // Don't sync node.data.label\n     *         color: \"atomic\",    // Sync as a single value, replaced as-a-whole\n     *       },\n     *       myCustomNode: {\n     *         showPreview: false,  // Don't sync myCustomNode.data.showPreview\n     *       },\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    sync?: NodeSyncConfig<N>;\n  };\n\n  edges?: {\n    initial?: E[];\n    /**\n     * Per-type sync configuration for edge data keys.\n     *\n     * Each key in the config is either:\n     * - `false` - Local-only, not synced to other clients\n     * - `\"atomic\"` - Synced as a single value (replaced as-a-whole, not patched)\n     * - `true` (or absent) - Deep sync (default, objects/arrays are patched)\n     * - `{ ... }` - Nested config, applies recursively to sub-keys\n     *\n     * Use `\"*\"` as a fallback for all edge types. Type-specific entries are\n     * deep-merged on top of `\"*\"`, with explicitly named keys taking\n     * precedence.\n     *\n     * @example\n     * ```tsx\n     * const { ... } = useLiveblocksFlow({\n     *   edges: {\n     *     sync: {\n     *       \"*\": {\n     *         hovered: false,       // Don't sync edge.data.hovered\n     *         style: \"atomic\",      // Sync as a single value, replaced as-a-whole\n     *       },\n     *       myCustomEdge: {\n     *         isHighlighted: false,  // Don't sync myCustomEdge.data.isHighlighted\n     *       },\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    sync?: EdgeSyncConfig<E>;\n  };\n\n  /**\n   * The key used to store the React Flow diagram in Liveblocks Storage.\n   * Defaults to `\"flow\"`.\n   */\n  storageKey?: string;\n\n  /**\n   * When true, suspends until Storage is ready (use a React `Suspense`\n   * boundary). Then `nodes` and `edges` are always arrays and `isLoading` is\n   * always false.\n   */\n  suspense?: boolean;\n};\n\n// Similar to React Flow's `applyNodeChanges()`, but writes local-only\n// properties via `setLocal()` / `delete()` on the LiveObject directly.\n// https://reactflow.dev/api-reference/utils/apply-node-changes\nfunction applyNodeChanges<N extends Node>(\n  changes: NodeChange<N>[],\n  nodes: LiveMap<string, InternalLiveblocksNode>,\n  history: History,\n  getNodeSyncConfig: (nodeType: string | undefined) => SyncConfig\n): void {\n  for (const change of changes) {\n    switch (change.type) {\n      case \"add\":\n      case \"replace\": {\n        const config = getNodeSyncConfig(change.item.type);\n        const existing = nodes.get(change.item.id);\n        if (existing) {\n          existing.reconcile(change.item as unknown as JsonObject, config);\n        } else {\n          nodes.set(\n            change.item.id,\n            toLiveblocksInternalNode(change.item, config)\n          );\n        }\n        break;\n      }\n\n      case \"position\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        // Pause before setting the first position change so it doesn't create a separate undo step.\n        if (change.dragging === true) {\n          history.pause();\n        }\n\n        if (change.position !== undefined) {\n          const prev = node.get(\"position\");\n          if (prev?.x !== change.position.x || prev?.y !== change.position.y) {\n            node.set(\"position\", change.position);\n          }\n        }\n\n        if (change.dragging !== undefined) {\n          if (change.dragging === false) {\n            history.resume();\n          }\n          // Must match NODE_BASE_CONFIG's `dragging: false`\n          node.setLocal(\"dragging\", change.dragging);\n        }\n        break;\n      }\n\n      case \"dimensions\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        // Pause before setting the first position change so it doesn't create a separate undo step.\n        if (change.resizing === true) {\n          history.pause();\n        }\n\n        if (\n          change.dimensions !== undefined &&\n          change.setAttributes !== undefined\n        ) {\n          if (\n            change.setAttributes === true ||\n            change.setAttributes === \"width\"\n          ) {\n            node.set(\"width\", change.dimensions.width);\n          }\n\n          if (\n            change.setAttributes === true ||\n            change.setAttributes === \"height\"\n          ) {\n            node.set(\"height\", change.dimensions.height);\n          }\n        }\n\n        if (change.dimensions !== undefined) {\n          // Must match NODE_BASE_CONFIG's `measured: false`\n          node.setLocal(\"measured\", change.dimensions);\n        }\n\n        if (change.resizing !== undefined) {\n          if (change.resizing === false) {\n            history.resume();\n          }\n          // Must match NODE_BASE_CONFIG's `resizing: false`\n          node.setLocal(\"resizing\", change.resizing);\n        }\n\n        break;\n      }\n\n      case \"select\": {\n        const node = nodes.get(change.id);\n        if (!node) break;\n\n        // Must match NODE_BASE_CONFIG's `selected: false`\n        node.setLocal(\"selected\", change.selected);\n        break;\n      }\n\n      case \"remove\":\n        // Removals are handled by onDelete for atomic undo\n        break;\n    }\n  }\n}\n\n// Similar to React Flow's `applyEdgeChanges()`, but writes local-only\n// properties via `setLocal()` / `delete()` on the LiveObject directly.\n// https://reactflow.dev/api-reference/utils/apply-edge-changes\nfunction applyEdgeChanges<E extends Edge>(\n  changes: EdgeChange<E>[],\n  edges: LiveMap<string, InternalLiveblocksEdge>,\n  getEdgeSyncConfig: (type: string | undefined) => SyncConfig\n): void {\n  for (const change of changes) {\n    switch (change.type) {\n      case \"add\":\n      case \"replace\": {\n        const config = getEdgeSyncConfig(change.item.type);\n        const existing = edges.get(change.item.id);\n        if (existing) {\n          existing.reconcile(change.item as unknown as JsonObject, config);\n        } else {\n          edges.set(\n            change.item.id,\n            toLiveblocksInternalEdge(change.item, config)\n          );\n        }\n        break;\n      }\n\n      case \"select\": {\n        const edge = edges.get(change.id);\n        if (!edge) break;\n        // Must match EDGE_BASE_CONFIG's `selected: false`\n        edge.setLocal(\"selected\", change.selected);\n        break;\n      }\n\n      case \"remove\":\n        // Removals are handled by onDelete for atomic undo\n        break;\n    }\n  }\n}\n\n/**\n * Returns a controlled React Flow state backed by Liveblocks Storage.\n *\n * @example\n * ```tsx\n * const { nodes, edges, onNodesChange, onEdgesChange, onConnect, onDelete, isLoading } = useLiveblocksFlow();\n *\n * if (isLoading) {\n *   return <div>Loading…</div>\n * }\n *\n * return <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} onDelete={onDelete} />;\n * ```\n * Pass `{ suspense: true }` to suspend until Storage is ready, `nodes` and `edges` will never be `null`.\n *\n * @example\n * ```tsx\n * const { nodes, edges, onNodesChange, onEdgesChange, onConnect, onDelete } =\n *   useLiveblocksFlow({ suspense: true });\n *\n * return <ReactFlow nodes={nodes} edges={edges} onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} onConnect={onConnect} onDelete={onDelete} />;\n * ```\n */\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options?: UseLiveblocksFlowOptions<N, E> & { suspense?: false }\n): Resolve<UseLiveblocksFlowResult<N, E>>;\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: UseLiveblocksFlowOptions<N, E> & { suspense: true }\n): Resolve<LiveblocksFlowSuspenseResult<N, E>>;\nexport function useLiveblocksFlow<\n  N extends Node = BuiltInNode,\n  E extends Edge = BuiltInEdge,\n>(\n  options: UseLiveblocksFlowOptions<N, E> = {}\n): Resolve<UseLiveblocksFlowResult<N, E> | LiveblocksFlowSuspenseResult<N, E>> {\n  const history = useHistory();\n  const isStorageLoaded = useStorage(() => true) ?? false;\n\n  // These options are not reactive, only their initial values are used.\n  const frozenOptions = useInitial({\n    nodes: options.nodes,\n    edges: options.edges,\n    storageKey: options.storageKey ?? DEFAULT_STORAGE_KEY,\n    suspense: options.suspense ?? false,\n  });\n\n  // Pre-compute sync config caches once (not on every render)\n  const [getNodeSyncConfig, getEdgeSyncConfig] = useMemo(\n    () =>\n      [\n        buildNodeConfigCache(frozenOptions.nodes?.sync),\n        buildEdgeConfigCache(frozenOptions.edges?.sync),\n      ] as const,\n    [frozenOptions]\n  );\n\n  // Storage already includes local overlays via toImmutable(), so no\n  // separate local layer is needed. Individual node/edge immutable references\n  // are already stable (only change when the underlying LiveObject changes).\n  const nodes = useStorage((storage) => {\n    const flow = storage[frozenOptions.storageKey] as\n      | ToImmutable<InternalLiveblocksFlow>\n      | undefined;\n    return flow?.nodes ? ([...flow.nodes.values()] as unknown as N[]) : null;\n  });\n  const edges = useStorage((storage) => {\n    const flow = storage[frozenOptions.storageKey] as\n      | ToImmutable<InternalLiveblocksFlow>\n      | undefined;\n    return flow?.edges ? ([...flow.edges.values()] as unknown as E[]) : null;\n  });\n\n  const onNodesChange = useMutation(\n    ({ storage }, changes: NodeChange<N>[]) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      applyNodeChanges(changes, flow.get(\"nodes\"), history, getNodeSyncConfig);\n    },\n    [history, frozenOptions, getNodeSyncConfig]\n  );\n\n  const onEdgesChange = useMutation(\n    ({ storage }, changes: EdgeChange<E>[]) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      applyEdgeChanges(changes, flow.get(\"edges\"), getEdgeSyncConfig);\n    },\n    [frozenOptions, getEdgeSyncConfig]\n  );\n\n  const onConnect = useMutation(\n    ({ storage }, connection: Connection) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      // Delegate to React Flow's own `addEdge` helper for consistent default\n      // edge ID generation, passing an empty array since de-duplication is\n      // already handled above.\n      const [newEdge] = defaultAddEdge(connection, [] as E[]);\n      if (!newEdge) {\n        return;\n      }\n\n      const edges = flow.get(\"edges\");\n      const config = getEdgeSyncConfig(newEdge.type);\n      edges.set(newEdge.id, toLiveblocksInternalEdge(newEdge, config));\n    },\n    [frozenOptions.storageKey, getEdgeSyncConfig]\n  );\n\n  const onDelete = useMutation(\n    ({ storage }, params: { nodes: N[]; edges: E[] }) => {\n      const flow = storage.get(frozenOptions.storageKey) as\n        | InternalLiveblocksFlow\n        | undefined;\n      if (!flow) {\n        return;\n      }\n\n      const nodesMap = flow.get(\"nodes\");\n      const edgesMap = flow.get(\"edges\");\n\n      for (const edge of params.edges) {\n        edgesMap.delete(edge.id);\n      }\n\n      for (const node of params.nodes) {\n        nodesMap.delete(node.id);\n      }\n    },\n    [frozenOptions.storageKey]\n  );\n\n  const setInitialStorage = useMutation(\n    ({ storage }) => {\n      // Similarly to `initialStorage` on `Client.enterRoom` and `RoomProvider`, we only\n      // initialize Storage if it doesn't already exist.\n      if (storage.get(frozenOptions.storageKey) !== undefined) {\n        return;\n      }\n\n      const initialNodes = frozenOptions.nodes?.initial ?? [];\n      const initialEdges = frozenOptions.edges?.initial ?? [];\n\n      storage.set(\n        frozenOptions.storageKey,\n        new LiveObject({\n          nodes: new LiveMap(\n            initialNodes.map((node) => [\n              node.id,\n              toLiveblocksInternalNode(node, getNodeSyncConfig(node.type)),\n            ])\n          ),\n          edges: new LiveMap(\n            initialEdges.map((edge) => [\n              edge.id,\n              toLiveblocksInternalEdge(edge, getEdgeSyncConfig(edge.type)),\n            ])\n          ),\n        })\n      );\n    },\n    [frozenOptions, getNodeSyncConfig, getEdgeSyncConfig]\n  );\n\n  useEffect(() => {\n    if (isStorageLoaded) {\n      history[kInternal].withoutHistory(() => {\n        setInitialStorage();\n      });\n    }\n  }, [isStorageLoaded, setInitialStorage, history]);\n\n  if (frozenOptions.suspense) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `suspense` is frozen so this branch is stable\n    useSuspendUntilStorageReady();\n  }\n\n  return {\n    nodes: frozenOptions.suspense ? (nodes ?? (EMPTY_ARRAY as N[])) : nodes,\n    edges: frozenOptions.suspense ? (edges ?? (EMPTY_ARRAY as E[])) : edges,\n    isLoading: frozenOptions.suspense ? false : !isStorageLoaded,\n    onNodesChange,\n    onEdgesChange,\n    onConnect,\n    onDelete,\n  } as UseLiveblocksFlowResult<N, E> | LiveblocksFlowSuspenseResult<N, E>;\n}\n"],"names":["defaultAddEdge","edges"],"mappings":";;;;;;;;AA2CA,MAAM,cAAc,EAAC,CAAA;AA8BrB,SAAS,4BAAA,CACP,MACA,IAC0C,EAAA;AAC1C,EAAA,IAAI,CAAC,IAAA;AAAM,IAAA,OAAO,MAAM,IAAA,CAAA;AAExB,EAAM,MAAA,YAAA,GAAe,KAAK,GAAG,CAAA,CAAA;AAC7B,EAAA,MAAM,WAAW,YAAe,GAAA,EAAE,GAAG,IAAM,EAAA,IAAA,EAAM,cAAiB,GAAA,IAAA,CAAA;AAGlE,EAAM,MAAA,KAAA,uBAAY,GAAoC,EAAA,CAAA;AACtD,EAAA,KAAA,MAAW,QAAQ,IAAM,EAAA;AACvB,IAAA,IAAI,IAAS,KAAA,GAAA;AAAK,MAAA,SAAA;AAClB,IAAM,MAAA,QAAA,GAAW,KAAK,IAAI,CAAA,CAAA;AAC1B,IAAA,IAAI,CAAC,QAAA;AAAU,MAAA,SAAA;AACf,IAAA,MAAM,UAAyB,GAAA,EAAE,GAAG,YAAA,EAAc,GAAG,QAAS,EAAA,CAAA;AAC9D,IAAA,KAAA,CAAM,IAAI,IAAM,EAAA,EAAE,GAAG,IAAM,EAAA,IAAA,EAAM,YAAY,CAAA,CAAA;AAAA,GAC/C;AAEA,EAAA,OAAO,CAAC,IAAA,KAAS,KAAM,CAAA,GAAA,CAAI,IAAI,CAAK,IAAA,QAAA,CAAA;AACtC,CAAA;AAEA,SAAS,qBAEP,cAC0C,EAAA;AAC1C,EAAO,OAAA,4BAAA,CAA6B,kBAAkB,cAAc,CAAA,CAAA;AACtE,CAAA;AAEA,SAAS,qBAEP,cAC0C,EAAA;AAC1C,EAAO,OAAA,4BAAA,CAA6B,kBAAkB,cAAc,CAAA,CAAA;AACtE,CAAA;AAyGA,SAAS,gBACP,CAAA,OAAA,EACA,KACA,EAAA,OAAA,EACA,iBACM,EAAA;AACN,EAAA,KAAA,MAAW,UAAU,OAAS,EAAA;AAC5B,IAAA,QAAQ,OAAO,IAAM;AAAA,MACnB,KAAK,KAAA,CAAA;AAAA,MACL,KAAK,SAAW,EAAA;AACd,QAAA,MAAM,MAAS,GAAA,iBAAA,CAAkB,MAAO,CAAA,IAAA,CAAK,IAAI,CAAA,CAAA;AACjD,QAAA,MAAM,QAAW,GAAA,KAAA,CAAM,GAAI,CAAA,MAAA,CAAO,KAAK,EAAE,CAAA,CAAA;AACzC,QAAA,IAAI,QAAU,EAAA;AACZ,UAAS,QAAA,CAAA,SAAA,CAAU,MAAO,CAAA,IAAA,EAA+B,MAAM,CAAA,CAAA;AAAA,SAC1D,MAAA;AACL,UAAM,KAAA,CAAA,GAAA;AAAA,YACJ,OAAO,IAAK,CAAA,EAAA;AAAA,YACZ,wBAAA,CAAyB,MAAO,CAAA,IAAA,EAAM,MAAM,CAAA;AAAA,WAC9C,CAAA;AAAA,SACF;AACA,QAAA,MAAA;AAAA,OACF;AAAA,MAEA,KAAK,UAAY,EAAA;AACf,QAAA,MAAM,IAAO,GAAA,KAAA,CAAM,GAAI,CAAA,MAAA,CAAO,EAAE,CAAA,CAAA;AAChC,QAAA,IAAI,CAAC,IAAA;AAAM,UAAA,MAAA;AAGX,QAAI,IAAA,MAAA,CAAO,aAAa,IAAM,EAAA;AAC5B,UAAA,OAAA,CAAQ,KAAM,EAAA,CAAA;AAAA,SAChB;AAEA,QAAI,IAAA,MAAA,CAAO,aAAa,KAAW,CAAA,EAAA;AACjC,UAAM,MAAA,IAAA,GAAO,IAAK,CAAA,GAAA,CAAI,UAAU,CAAA,CAAA;AAChC,UAAI,IAAA,IAAA,EAAM,MAAM,MAAO,CAAA,QAAA,CAAS,KAAK,IAAM,EAAA,CAAA,KAAM,MAAO,CAAA,QAAA,CAAS,CAAG,EAAA;AAClE,YAAK,IAAA,CAAA,GAAA,CAAI,UAAY,EAAA,MAAA,CAAO,QAAQ,CAAA,CAAA;AAAA,WACtC;AAAA,SACF;AAEA,QAAI,IAAA,MAAA,CAAO,aAAa,KAAW,CAAA,EAAA;AACjC,UAAI,IAAA,MAAA,CAAO,aAAa,KAAO,EAAA;AAC7B,YAAA,OAAA,CAAQ,MAAO,EAAA,CAAA;AAAA,WACjB;AAEA,UAAK,IAAA,CAAA,QAAA,CAAS,UAAY,EAAA,MAAA,CAAO,QAAQ,CAAA,CAAA;AAAA,SAC3C;AACA,QAAA,MAAA;AAAA,OACF;AAAA,MAEA,KAAK,YAAc,EAAA;AACjB,QAAA,MAAM,IAAO,GAAA,KAAA,CAAM,GAAI,CAAA,MAAA,CAAO,EAAE,CAAA,CAAA;AAChC,QAAA,IAAI,CAAC,IAAA;AAAM,UAAA,MAAA;AAGX,QAAI,IAAA,MAAA,CAAO,aAAa,IAAM,EAAA;AAC5B,UAAA,OAAA,CAAQ,KAAM,EAAA,CAAA;AAAA,SAChB;AAEA,QAAA,IACE,MAAO,CAAA,UAAA,KAAe,KACtB,CAAA,IAAA,MAAA,CAAO,kBAAkB,KACzB,CAAA,EAAA;AACA,UAAA,IACE,MAAO,CAAA,aAAA,KAAkB,IACzB,IAAA,MAAA,CAAO,kBAAkB,OACzB,EAAA;AACA,YAAA,IAAA,CAAK,GAAI,CAAA,OAAA,EAAS,MAAO,CAAA,UAAA,CAAW,KAAK,CAAA,CAAA;AAAA,WAC3C;AAEA,UAAA,IACE,MAAO,CAAA,aAAA,KAAkB,IACzB,IAAA,MAAA,CAAO,kBAAkB,QACzB,EAAA;AACA,YAAA,IAAA,CAAK,GAAI,CAAA,QAAA,EAAU,MAAO,CAAA,UAAA,CAAW,MAAM,CAAA,CAAA;AAAA,WAC7C;AAAA,SACF;AAEA,QAAI,IAAA,MAAA,CAAO,eAAe,KAAW,CAAA,EAAA;AAEnC,UAAK,IAAA,CAAA,QAAA,CAAS,UAAY,EAAA,MAAA,CAAO,UAAU,CAAA,CAAA;AAAA,SAC7C;AAEA,QAAI,IAAA,MAAA,CAAO,aAAa,KAAW,CAAA,EAAA;AACjC,UAAI,IAAA,MAAA,CAAO,aAAa,KAAO,EAAA;AAC7B,YAAA,OAAA,CAAQ,MAAO,EAAA,CAAA;AAAA,WACjB;AAEA,UAAK,IAAA,CAAA,QAAA,CAAS,UAAY,EAAA,MAAA,CAAO,QAAQ,CAAA,CAAA;AAAA,SAC3C;AAEA,QAAA,MAAA;AAAA,OACF;AAAA,MAEA,KAAK,QAAU,EAAA;AACb,QAAA,MAAM,IAAO,GAAA,KAAA,CAAM,GAAI,CAAA,MAAA,CAAO,EAAE,CAAA,CAAA;AAChC,QAAA,IAAI,CAAC,IAAA;AAAM,UAAA,MAAA;AAGX,QAAK,IAAA,CAAA,QAAA,CAAS,UAAY,EAAA,MAAA,CAAO,QAAQ,CAAA,CAAA;AACzC,QAAA,MAAA;AAAA,OACF;AAAA,MAEA,KAAK,QAAA;AAEH,QAAA,MAAA;AAAA,KACJ;AAAA,GACF;AACF,CAAA;AAKA,SAAS,gBAAA,CACP,OACA,EAAA,KAAA,EACA,iBACM,EAAA;AACN,EAAA,KAAA,MAAW,UAAU,OAAS,EAAA;AAC5B,IAAA,QAAQ,OAAO,IAAM;AAAA,MACnB,KAAK,KAAA,CAAA;AAAA,MACL,KAAK,SAAW,EAAA;AACd,QAAA,MAAM,MAAS,GAAA,iBAAA,CAAkB,MAAO,CAAA,IAAA,CAAK,IAAI,CAAA,CAAA;AACjD,QAAA,MAAM,QAAW,GAAA,KAAA,CAAM,GAAI,CAAA,MAAA,CAAO,KAAK,EAAE,CAAA,CAAA;AACzC,QAAA,IAAI,QAAU,EAAA;AACZ,UAAS,QAAA,CAAA,SAAA,CAAU,MAAO,CAAA,IAAA,EAA+B,MAAM,CAAA,CAAA;AAAA,SAC1D,MAAA;AACL,UAAM,KAAA,CAAA,GAAA;AAAA,YACJ,OAAO,IAAK,CAAA,EAAA;AAAA,YACZ,wBAAA,CAAyB,MAAO,CAAA,IAAA,EAAM,MAAM,CAAA;AAAA,WAC9C,CAAA;AAAA,SACF;AACA,QAAA,MAAA;AAAA,OACF;AAAA,MAEA,KAAK,QAAU,EAAA;AACb,QAAA,MAAM,IAAO,GAAA,KAAA,CAAM,GAAI,CAAA,MAAA,CAAO,EAAE,CAAA,CAAA;AAChC,QAAA,IAAI,CAAC,IAAA;AAAM,UAAA,MAAA;AAEX,QAAK,IAAA,CAAA,QAAA,CAAS,UAAY,EAAA,MAAA,CAAO,QAAQ,CAAA,CAAA;AACzC,QAAA,MAAA;AAAA,OACF;AAAA,MAEA,KAAK,QAAA;AAEH,QAAA,MAAA;AAAA,KACJ;AAAA,GACF;AACF,CAAA;AAqCgB,SAAA,iBAAA,CAId,OAA0C,GAAA,EACmC,EAAA;AAC7E,EAAA,MAAM,UAAU,UAAW,EAAA,CAAA;AAC3B,EAAA,MAAM,eAAkB,GAAA,UAAA,CAAW,MAAM,IAAI,CAAK,IAAA,KAAA,CAAA;AAGlD,EAAA,MAAM,gBAAgB,UAAW,CAAA;AAAA,IAC/B,OAAO,OAAQ,CAAA,KAAA;AAAA,IACf,OAAO,OAAQ,CAAA,KAAA;AAAA,IACf,UAAA,EAAY,QAAQ,UAAc,IAAA,mBAAA;AAAA,IAClC,QAAA,EAAU,QAAQ,QAAY,IAAA,KAAA;AAAA,GAC/B,CAAA,CAAA;AAGD,EAAM,MAAA,CAAC,iBAAmB,EAAA,iBAAiB,CAAI,GAAA,OAAA;AAAA,IAC7C,MACE;AAAA,MACE,oBAAA,CAAqB,aAAc,CAAA,KAAA,EAAO,IAAI,CAAA;AAAA,MAC9C,oBAAA,CAAqB,aAAc,CAAA,KAAA,EAAO,IAAI,CAAA;AAAA,KAChD;AAAA,IACF,CAAC,aAAa,CAAA;AAAA,GAChB,CAAA;AAKA,EAAM,MAAA,KAAA,GAAQ,UAAW,CAAA,CAAC,OAAY,KAAA;AACpC,IAAM,MAAA,IAAA,GAAO,OAAQ,CAAA,aAAA,CAAc,UAAU,CAAA,CAAA;AAG7C,IAAO,OAAA,IAAA,EAAM,QAAS,CAAC,GAAG,KAAK,KAAM,CAAA,MAAA,EAAQ,CAAuB,GAAA,IAAA,CAAA;AAAA,GACrE,CAAA,CAAA;AACD,EAAM,MAAA,KAAA,GAAQ,UAAW,CAAA,CAAC,OAAY,KAAA;AACpC,IAAM,MAAA,IAAA,GAAO,OAAQ,CAAA,aAAA,CAAc,UAAU,CAAA,CAAA;AAG7C,IAAO,OAAA,IAAA,EAAM,QAAS,CAAC,GAAG,KAAK,KAAM,CAAA,MAAA,EAAQ,CAAuB,GAAA,IAAA,CAAA;AAAA,GACrE,CAAA,CAAA;AAED,EAAA,MAAM,aAAgB,GAAA,WAAA;AAAA,IACpB,CAAC,EAAE,OAAQ,EAAA,EAAG,OAA6B,KAAA;AACzC,MAAA,MAAM,IAAO,GAAA,OAAA,CAAQ,GAAI,CAAA,aAAA,CAAc,UAAU,CAAA,CAAA;AAGjD,MAAA,IAAI,CAAC,IAAM,EAAA;AACT,QAAA,OAAA;AAAA,OACF;AAEA,MAAA,gBAAA,CAAiB,SAAS,IAAK,CAAA,GAAA,CAAI,OAAO,CAAA,EAAG,SAAS,iBAAiB,CAAA,CAAA;AAAA,KACzE;AAAA,IACA,CAAC,OAAS,EAAA,aAAA,EAAe,iBAAiB,CAAA;AAAA,GAC5C,CAAA;AAEA,EAAA,MAAM,aAAgB,GAAA,WAAA;AAAA,IACpB,CAAC,EAAE,OAAQ,EAAA,EAAG,OAA6B,KAAA;AACzC,MAAA,MAAM,IAAO,GAAA,OAAA,CAAQ,GAAI,CAAA,aAAA,CAAc,UAAU,CAAA,CAAA;AAGjD,MAAA,IAAI,CAAC,IAAM,EAAA;AACT,QAAA,OAAA;AAAA,OACF;AAEA,MAAA,gBAAA,CAAiB,OAAS,EAAA,IAAA,CAAK,GAAI,CAAA,OAAO,GAAG,iBAAiB,CAAA,CAAA;AAAA,KAChE;AAAA,IACA,CAAC,eAAe,iBAAiB,CAAA;AAAA,GACnC,CAAA;AAEA,EAAA,MAAM,SAAY,GAAA,WAAA;AAAA,IAChB,CAAC,EAAE,OAAQ,EAAA,EAAG,UAA2B,KAAA;AACvC,MAAA,MAAM,IAAO,GAAA,OAAA,CAAQ,GAAI,CAAA,aAAA,CAAc,UAAU,CAAA,CAAA;AAGjD,MAAA,IAAI,CAAC,IAAM,EAAA;AACT,QAAA,OAAA;AAAA,OACF;AAKA,MAAA,MAAM,CAAC,OAAO,CAAA,GAAIA,OAAe,CAAA,UAAA,EAAY,EAAS,CAAA,CAAA;AACtD,MAAA,IAAI,CAAC,OAAS,EAAA;AACZ,QAAA,OAAA;AAAA,OACF;AAEA,MAAMC,MAAAA,MAAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,OAAO,CAAA,CAAA;AAC9B,MAAM,MAAA,MAAA,GAAS,iBAAkB,CAAA,OAAA,CAAQ,IAAI,CAAA,CAAA;AAC7C,MAAAA,OAAM,GAAI,CAAA,OAAA,CAAQ,IAAI,wBAAyB,CAAA,OAAA,EAAS,MAAM,CAAC,CAAA,CAAA;AAAA,KACjE;AAAA,IACA,CAAC,aAAc,CAAA,UAAA,EAAY,iBAAiB,CAAA;AAAA,GAC9C,CAAA;AAEA,EAAA,MAAM,QAAW,GAAA,WAAA;AAAA,IACf,CAAC,EAAE,OAAQ,EAAA,EAAG,MAAuC,KAAA;AACnD,MAAA,MAAM,IAAO,GAAA,OAAA,CAAQ,GAAI,CAAA,aAAA,CAAc,UAAU,CAAA,CAAA;AAGjD,MAAA,IAAI,CAAC,IAAM,EAAA;AACT,QAAA,OAAA;AAAA,OACF;AAEA,MAAM,MAAA,QAAA,GAAW,IAAK,CAAA,GAAA,CAAI,OAAO,CAAA,CAAA;AACjC,MAAM,MAAA,QAAA,GAAW,IAAK,CAAA,GAAA,CAAI,OAAO,CAAA,CAAA;AAEjC,MAAW,KAAA,MAAA,IAAA,IAAQ,OAAO,KAAO,EAAA;AAC/B,QAAS,QAAA,CAAA,MAAA,CAAO,KAAK,EAAE,CAAA,CAAA;AAAA,OACzB;AAEA,MAAW,KAAA,MAAA,IAAA,IAAQ,OAAO,KAAO,EAAA;AAC/B,QAAS,QAAA,CAAA,MAAA,CAAO,KAAK,EAAE,CAAA,CAAA;AAAA,OACzB;AAAA,KACF;AAAA,IACA,CAAC,cAAc,UAAU,CAAA;AAAA,GAC3B,CAAA;AAEA,EAAA,MAAM,iBAAoB,GAAA,WAAA;AAAA,IACxB,CAAC,EAAE,OAAA,EAAc,KAAA;AAGf,MAAA,IAAI,OAAQ,CAAA,GAAA,CAAI,aAAc,CAAA,UAAU,MAAM,KAAW,CAAA,EAAA;AACvD,QAAA,OAAA;AAAA,OACF;AAEA,MAAA,MAAM,YAAe,GAAA,aAAA,CAAc,KAAO,EAAA,OAAA,IAAW,EAAC,CAAA;AACtD,MAAA,MAAM,YAAe,GAAA,aAAA,CAAc,KAAO,EAAA,OAAA,IAAW,EAAC,CAAA;AAEtD,MAAQ,OAAA,CAAA,GAAA;AAAA,QACN,aAAc,CAAA,UAAA;AAAA,QACd,IAAI,UAAW,CAAA;AAAA,UACb,OAAO,IAAI,OAAA;AAAA,YACT,YAAA,CAAa,GAAI,CAAA,CAAC,IAAS,KAAA;AAAA,cACzB,IAAK,CAAA,EAAA;AAAA,cACL,wBAAyB,CAAA,IAAA,EAAM,iBAAkB,CAAA,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,aAC5D,CAAA;AAAA,WACH;AAAA,UACA,OAAO,IAAI,OAAA;AAAA,YACT,YAAA,CAAa,GAAI,CAAA,CAAC,IAAS,KAAA;AAAA,cACzB,IAAK,CAAA,EAAA;AAAA,cACL,wBAAyB,CAAA,IAAA,EAAM,iBAAkB,CAAA,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,aAC5D,CAAA;AAAA,WACH;AAAA,SACD,CAAA;AAAA,OACH,CAAA;AAAA,KACF;AAAA,IACA,CAAC,aAAe,EAAA,iBAAA,EAAmB,iBAAiB,CAAA;AAAA,GACtD,CAAA;AAEA,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,eAAiB,EAAA;AACnB,MAAQ,OAAA,CAAA,SAAS,CAAE,CAAA,cAAA,CAAe,MAAM;AACtC,QAAkB,iBAAA,EAAA,CAAA;AAAA,OACnB,CAAA,CAAA;AAAA,KACH;AAAA,GACC,EAAA,CAAC,eAAiB,EAAA,iBAAA,EAAmB,OAAO,CAAC,CAAA,CAAA;AAEhD,EAAA,IAAI,cAAc,QAAU,EAAA;AAE1B,IAA4B,2BAAA,EAAA,CAAA;AAAA,GAC9B;AAEA,EAAO,OAAA;AAAA,IACL,KAAO,EAAA,aAAA,CAAc,QAAY,GAAA,KAAA,IAAU,WAAuB,GAAA,KAAA;AAAA,IAClE,KAAO,EAAA,aAAA,CAAc,QAAY,GAAA,KAAA,IAAU,WAAuB,GAAA,KAAA;AAAA,IAClE,SAAW,EAAA,aAAA,CAAc,QAAW,GAAA,KAAA,GAAQ,CAAC,eAAA;AAAA,IAC7C,aAAA;AAAA,IACA,aAAA;AAAA,IACA,SAAA;AAAA,IACA,QAAA;AAAA,GACF,CAAA;AACF;;;;"}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { ComponentPropsWithoutRef, ComponentType, CSSProperties } from 'react';
-import { SyncConfig, LiveObject, LiveMap, SyncMode, Json, JsonScalar, LiveList, Lson, LsonObject, Resolve } from '@liveblocks/core';
+import { ComponentPropsWithoutRef, ComponentType } from 'react';
+import { SyncConfig, LiveObject, LiveMap, SyncMode, JsonScalar, LiveList, Lson, LsonObject, Resolve } from '@liveblocks/core';
 export { SyncConfig, SyncMode } from '@liveblocks/core';
 import { Node, Edge, BuiltInNode, BuiltInEdge, OnNodesChange, OnEdgesChange, OnConnect, OnDelete } from '@xyflow/react';
 
@@ -58,6 +58,7 @@ declare const EDGE_BASE_CONFIG: {
     readonly markerStart: "atomic";
     readonly markerEnd: "atomic";
     readonly label: "atomic";
+    readonly labelBgPadding: "atomic";
 };
 
 type InferNodeTypeLiterals<N> = N extends Node<any, infer T extends string> ? string extends T ? never : T : never;
@@ -71,22 +72,27 @@ type EdgeSyncConfig<E extends Edge> = {
     [key in EdgeTypeLiterals<E>]?: SyncConfig;
 };
 type ToLsonProperty<V, S extends SyncMode> = undefined extends V ? ToLson<Exclude<V, undefined>, S> | undefined : ToLson<V, S>;
-type SyncedKeysFor<K, S extends SyncMode> = S extends SyncConfig ? K extends keyof S ? S[K] extends false ? never : K : K : K;
-type SyncModeFor<K, S extends SyncMode> = S extends SyncConfig ? K extends keyof S ? S[K] extends SyncMode ? S[K] : true : true : S;
-type ToLson<T, S extends SyncMode = true> = [S] extends [false] ? T : [S] extends ["atomic"] ? Json : T extends JsonScalar ? T : T extends Date | RegExp | Function | Promise<any> | WeakMap<any, any> | WeakSet<any> | Map<any, any> | Set<any> ? never : T extends ReadonlyArray<infer E> ? LiveList<ToLson<E, S> & Lson> : T extends CSSProperties ? LiveObject<CSSProperties & LsonObject> : T extends object ? LiveObject<{
-    [K in keyof T as SyncedKeysFor<K, S>]: ToLsonProperty<T[K], SyncModeFor<K, S>>;
-} & LsonObject> : never;
-type ToLiveElement<Base, BaseConfig, Concrete, Data> = LiveObject<{
-    [K in keyof Base]: K extends keyof BaseConfig ? BaseConfig[K & keyof BaseConfig] extends "atomic" | false ? Json : Concrete[K & keyof Concrete] : K extends "data" ? Data : ToLson<Base[K]>;
-} & LsonObject>;
+type ResolveSyncMode<S extends SyncMode, K> = S extends SyncConfig ? K extends keyof S ? S[K] extends SyncMode ? S[K] : true : true : S;
+type ToLson<T, S extends SyncMode = true> = [
+    S
+] extends [false] ? T | undefined : [
+    S
+] extends ["atomic"] ? T : T extends JsonScalar ? T : T extends Date | RegExp | Function | Promise<any> | WeakMap<any, any> | WeakSet<any> | Map<any, any> | Set<any> ? never : T extends ReadonlyArray<infer E> ? ToLiveList<E, S> : T extends object ? ToLiveObject<T, S> : never;
+type ToLiveList<T, S extends SyncMode = true> = LiveList<ToLson<T, S> & Lson>;
+type ToLiveObject<T extends object, S extends SyncMode = true> = {
+    [K in keyof T]: ToLsonProperty<T[K], ResolveSyncMode<S, K>>;
+} & LsonObject extends infer O extends LsonObject ? LiveObject<O> : never;
+type ToLiveElement<S extends SyncConfig, B extends Node | Edge, T extends B, D> = {
+    [K in keyof B]: K extends keyof S ? T[K & keyof T] : K extends "data" ? D : ToLson<B[K]>;
+} & LsonObject extends infer O extends LsonObject ? LiveObject<O> : never;
 /**
  * The Liveblocks Storage representation of a React Flow `Node`.
  */
-type LiveblocksNode<N extends Node = BuiltInNode, S extends SyncConfig = SyncConfig> = ToLiveElement<Node, typeof NODE_BASE_CONFIG, N, ToLson<N["data"], S>>;
+type LiveblocksNode<N extends Node = BuiltInNode, S extends SyncConfig = SyncConfig> = ToLiveElement<typeof NODE_BASE_CONFIG, Node, N, ToLson<N["data"], S>>;
 /**
  * The Liveblocks Storage representation of a React Flow `Edge`.
  */
-type LiveblocksEdge<E extends Edge = BuiltInEdge, S extends SyncConfig = SyncConfig> = ToLiveElement<Edge, typeof EDGE_BASE_CONFIG, E, ToLson<E["data"], S>>;
+type LiveblocksEdge<E extends Edge = BuiltInEdge, S extends SyncConfig = SyncConfig> = ToLiveElement<typeof EDGE_BASE_CONFIG, Edge, E, ToLson<E["data"], S>>;
 /**
  * The Liveblocks Storage representation of a React Flow diagram made of nodes and edges.
  */
@@ -133,6 +139,12 @@ type UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {
         /**
          * Per-type sync configuration for node data keys.
          *
+         * Each key in the config is either:
+         * - `false` - Local-only, not synced to other clients
+         * - `"atomic"` - Synced as a single value (replaced as-a-whole, not patched)
+         * - `true` (or absent) - Deep sync (default, objects/arrays are patched)
+         * - `{ ... }` - Nested config, applies recursively to sub-keys
+         *
          * Use `"*"` as a fallback for all node types. Type-specific entries are
          * deep-merged on top of `"*"`, with explicitly named keys taking
          * precedence.
@@ -142,13 +154,10 @@ type UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {
          * const { ... } = useLiveblocksFlow({
          *   nodes: {
          *     sync: {
-         *       // Fallback for all node types
          *       "*": {
-         *         label: false,  // Don't sync node.data.label
+         *         label: false,       // Don't sync node.data.label
+         *         color: "atomic",    // Sync as a single value, replaced as-a-whole
          *       },
-         *
-         *       // Override for node.type === 'myCustomNode'
-         *       // This will also not sync `myCustomNode.data.label` (because of the fallback above)
          *       myCustomNode: {
          *         showPreview: false,  // Don't sync myCustomNode.data.showPreview
          *       },
@@ -164,6 +173,12 @@ type UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {
         /**
          * Per-type sync configuration for edge data keys.
          *
+         * Each key in the config is either:
+         * - `false` - Local-only, not synced to other clients
+         * - `"atomic"` - Synced as a single value (replaced as-a-whole, not patched)
+         * - `true` (or absent) - Deep sync (default, objects/arrays are patched)
+         * - `{ ... }` - Nested config, applies recursively to sub-keys
+         *
          * Use `"*"` as a fallback for all edge types. Type-specific entries are
          * deep-merged on top of `"*"`, with explicitly named keys taking
          * precedence.
@@ -173,13 +188,10 @@ type UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {
          * const { ... } = useLiveblocksFlow({
          *   edges: {
          *     sync: {
-         *       // Fallback for all edge types
          *       "*": {
-         *         hovered: false,  // Don't sync edge.data.hovered
+         *         hovered: false,       // Don't sync edge.data.hovered
+         *         style: "atomic",      // Sync as a single value, replaced as-a-whole
          *       },
-         *
-         *       // Override for edge.type === 'myCustomEdge'
-         *       // This will also not sync `myCustomEdge.data.hovered` (because of the fallback above)
          *       myCustomEdge: {
          *         isHighlighted: false,  // Don't sync myCustomEdge.data.isHighlighted
          *       },

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { ComponentPropsWithoutRef, ComponentType, CSSProperties } from 'react';
-import { SyncConfig, LiveObject, LiveMap, SyncMode, Json, JsonScalar, LiveList, Lson, LsonObject, Resolve } from '@liveblocks/core';
+import { ComponentPropsWithoutRef, ComponentType } from 'react';
+import { SyncConfig, LiveObject, LiveMap, SyncMode, JsonScalar, LiveList, Lson, LsonObject, Resolve } from '@liveblocks/core';
 export { SyncConfig, SyncMode } from '@liveblocks/core';
 import { Node, Edge, BuiltInNode, BuiltInEdge, OnNodesChange, OnEdgesChange, OnConnect, OnDelete } from '@xyflow/react';
 
@@ -58,6 +58,7 @@ declare const EDGE_BASE_CONFIG: {
     readonly markerStart: "atomic";
     readonly markerEnd: "atomic";
     readonly label: "atomic";
+    readonly labelBgPadding: "atomic";
 };
 
 type InferNodeTypeLiterals<N> = N extends Node<any, infer T extends string> ? string extends T ? never : T : never;
@@ -71,22 +72,27 @@ type EdgeSyncConfig<E extends Edge> = {
     [key in EdgeTypeLiterals<E>]?: SyncConfig;
 };
 type ToLsonProperty<V, S extends SyncMode> = undefined extends V ? ToLson<Exclude<V, undefined>, S> | undefined : ToLson<V, S>;
-type SyncedKeysFor<K, S extends SyncMode> = S extends SyncConfig ? K extends keyof S ? S[K] extends false ? never : K : K : K;
-type SyncModeFor<K, S extends SyncMode> = S extends SyncConfig ? K extends keyof S ? S[K] extends SyncMode ? S[K] : true : true : S;
-type ToLson<T, S extends SyncMode = true> = [S] extends [false] ? T : [S] extends ["atomic"] ? Json : T extends JsonScalar ? T : T extends Date | RegExp | Function | Promise<any> | WeakMap<any, any> | WeakSet<any> | Map<any, any> | Set<any> ? never : T extends ReadonlyArray<infer E> ? LiveList<ToLson<E, S> & Lson> : T extends CSSProperties ? LiveObject<CSSProperties & LsonObject> : T extends object ? LiveObject<{
-    [K in keyof T as SyncedKeysFor<K, S>]: ToLsonProperty<T[K], SyncModeFor<K, S>>;
-} & LsonObject> : never;
-type ToLiveElement<Base, BaseConfig, Concrete, Data> = LiveObject<{
-    [K in keyof Base]: K extends keyof BaseConfig ? BaseConfig[K & keyof BaseConfig] extends "atomic" | false ? Json : Concrete[K & keyof Concrete] : K extends "data" ? Data : ToLson<Base[K]>;
-} & LsonObject>;
+type ResolveSyncMode<S extends SyncMode, K> = S extends SyncConfig ? K extends keyof S ? S[K] extends SyncMode ? S[K] : true : true : S;
+type ToLson<T, S extends SyncMode = true> = [
+    S
+] extends [false] ? T | undefined : [
+    S
+] extends ["atomic"] ? T : T extends JsonScalar ? T : T extends Date | RegExp | Function | Promise<any> | WeakMap<any, any> | WeakSet<any> | Map<any, any> | Set<any> ? never : T extends ReadonlyArray<infer E> ? ToLiveList<E, S> : T extends object ? ToLiveObject<T, S> : never;
+type ToLiveList<T, S extends SyncMode = true> = LiveList<ToLson<T, S> & Lson>;
+type ToLiveObject<T extends object, S extends SyncMode = true> = {
+    [K in keyof T]: ToLsonProperty<T[K], ResolveSyncMode<S, K>>;
+} & LsonObject extends infer O extends LsonObject ? LiveObject<O> : never;
+type ToLiveElement<S extends SyncConfig, B extends Node | Edge, T extends B, D> = {
+    [K in keyof B]: K extends keyof S ? T[K & keyof T] : K extends "data" ? D : ToLson<B[K]>;
+} & LsonObject extends infer O extends LsonObject ? LiveObject<O> : never;
 /**
  * The Liveblocks Storage representation of a React Flow `Node`.
  */
-type LiveblocksNode<N extends Node = BuiltInNode, S extends SyncConfig = SyncConfig> = ToLiveElement<Node, typeof NODE_BASE_CONFIG, N, ToLson<N["data"], S>>;
+type LiveblocksNode<N extends Node = BuiltInNode, S extends SyncConfig = SyncConfig> = ToLiveElement<typeof NODE_BASE_CONFIG, Node, N, ToLson<N["data"], S>>;
 /**
  * The Liveblocks Storage representation of a React Flow `Edge`.
  */
-type LiveblocksEdge<E extends Edge = BuiltInEdge, S extends SyncConfig = SyncConfig> = ToLiveElement<Edge, typeof EDGE_BASE_CONFIG, E, ToLson<E["data"], S>>;
+type LiveblocksEdge<E extends Edge = BuiltInEdge, S extends SyncConfig = SyncConfig> = ToLiveElement<typeof EDGE_BASE_CONFIG, Edge, E, ToLson<E["data"], S>>;
 /**
  * The Liveblocks Storage representation of a React Flow diagram made of nodes and edges.
  */
@@ -133,6 +139,12 @@ type UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {
         /**
          * Per-type sync configuration for node data keys.
          *
+         * Each key in the config is either:
+         * - `false` - Local-only, not synced to other clients
+         * - `"atomic"` - Synced as a single value (replaced as-a-whole, not patched)
+         * - `true` (or absent) - Deep sync (default, objects/arrays are patched)
+         * - `{ ... }` - Nested config, applies recursively to sub-keys
+         *
          * Use `"*"` as a fallback for all node types. Type-specific entries are
          * deep-merged on top of `"*"`, with explicitly named keys taking
          * precedence.
@@ -142,13 +154,10 @@ type UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {
          * const { ... } = useLiveblocksFlow({
          *   nodes: {
          *     sync: {
-         *       // Fallback for all node types
          *       "*": {
-         *         label: false,  // Don't sync node.data.label
+         *         label: false,       // Don't sync node.data.label
+         *         color: "atomic",    // Sync as a single value, replaced as-a-whole
          *       },
-         *
-         *       // Override for node.type === 'myCustomNode'
-         *       // This will also not sync `myCustomNode.data.label` (because of the fallback above)
          *       myCustomNode: {
          *         showPreview: false,  // Don't sync myCustomNode.data.showPreview
          *       },
@@ -164,6 +173,12 @@ type UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {
         /**
          * Per-type sync configuration for edge data keys.
          *
+         * Each key in the config is either:
+         * - `false` - Local-only, not synced to other clients
+         * - `"atomic"` - Synced as a single value (replaced as-a-whole, not patched)
+         * - `true` (or absent) - Deep sync (default, objects/arrays are patched)
+         * - `{ ... }` - Nested config, applies recursively to sub-keys
+         *
          * Use `"*"` as a fallback for all edge types. Type-specific entries are
          * deep-merged on top of `"*"`, with explicitly named keys taking
          * precedence.
@@ -173,13 +188,10 @@ type UseLiveblocksFlowOptions<N extends Node, E extends Edge> = {
          * const { ... } = useLiveblocksFlow({
          *   edges: {
          *     sync: {
-         *       // Fallback for all edge types
          *       "*": {
-         *         hovered: false,  // Don't sync edge.data.hovered
+         *         hovered: false,       // Don't sync edge.data.hovered
+         *         style: "atomic",      // Sync as a single value, replaced as-a-whole
          *       },
-         *
-         *       // Override for edge.type === 'myCustomEdge'
-         *       // This will also not sync `myCustomEdge.data.hovered` (because of the fallback above)
          *       myCustomEdge: {
          *         isHighlighted: false,  // Don't sync myCustomEdge.data.isHighlighted
          *       },

package/dist/version.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 const PKG_NAME = "@liveblocks/react-flow";
-const PKG_VERSION = typeof "3.16.0-flow3" === "string" && "3.16.0-flow3";
+const PKG_VERSION = typeof "3.17.0-rc1" === "string" && "3.17.0-rc1";
 const PKG_FORMAT = typeof TSUP_FORMAT === "string" && TSUP_FORMAT;
 
 exports.PKG_FORMAT = PKG_FORMAT;

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.cjs","sources":["../src/version.ts"],"sourcesContent":["declare const __VERSION__: string;\ndeclare const TSUP_FORMAT: string;\n\nexport const PKG_NAME = \"@liveblocks/react-flow\";\nexport const PKG_VERSION = typeof __VERSION__ === \"string\" && __VERSION__;\nexport const PKG_FORMAT = typeof TSUP_FORMAT === \"string\" && TSUP_FORMAT;\n"],"names":[],"mappings":";;AAGO,MAAM,QAAW,GAAA,yBAAA;AACX,MAAA,WAAA,GAAc,OAAO,cAAA,KAAgB,QAAY,IAAA,eAAA;AACjD,MAAA,UAAA,GAAa,OAAO,WAAA,KAAgB,QAAY,IAAA;;;;;;"}
+{"version":3,"file":"version.cjs","sources":["../src/version.ts"],"sourcesContent":["declare const __VERSION__: string;\ndeclare const TSUP_FORMAT: string;\n\nexport const PKG_NAME = \"@liveblocks/react-flow\";\nexport const PKG_VERSION = typeof __VERSION__ === \"string\" && __VERSION__;\nexport const PKG_FORMAT = typeof TSUP_FORMAT === \"string\" && TSUP_FORMAT;\n"],"names":[],"mappings":";;AAGO,MAAM,QAAW,GAAA,yBAAA;AACX,MAAA,WAAA,GAAc,OAAO,YAAA,KAAgB,QAAY,IAAA,aAAA;AACjD,MAAA,UAAA,GAAa,OAAO,WAAA,KAAgB,QAAY,IAAA;;;;;;"}

package/dist/version.js

@@ -1,5 +1,5 @@
 const PKG_NAME = "@liveblocks/react-flow";
-const PKG_VERSION = typeof "3.16.0-flow3" === "string" && "3.16.0-flow3";
+const PKG_VERSION = typeof "3.17.0-rc1" === "string" && "3.17.0-rc1";
 const PKG_FORMAT = typeof TSUP_FORMAT === "string" && TSUP_FORMAT;
 
 export { PKG_FORMAT, PKG_NAME, PKG_VERSION };

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["declare const __VERSION__: string;\ndeclare const TSUP_FORMAT: string;\n\nexport const PKG_NAME = \"@liveblocks/react-flow\";\nexport const PKG_VERSION = typeof __VERSION__ === \"string\" && __VERSION__;\nexport const PKG_FORMAT = typeof TSUP_FORMAT === \"string\" && TSUP_FORMAT;\n"],"names":[],"mappings":"AAGO,MAAM,QAAW,GAAA,yBAAA;AACX,MAAA,WAAA,GAAc,OAAO,cAAA,KAAgB,QAAY,IAAA,eAAA;AACjD,MAAA,UAAA,GAAa,OAAO,WAAA,KAAgB,QAAY,IAAA;;;;"}
+{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["declare const __VERSION__: string;\ndeclare const TSUP_FORMAT: string;\n\nexport const PKG_NAME = \"@liveblocks/react-flow\";\nexport const PKG_VERSION = typeof __VERSION__ === \"string\" && __VERSION__;\nexport const PKG_FORMAT = typeof TSUP_FORMAT === \"string\" && TSUP_FORMAT;\n"],"names":[],"mappings":"AAGO,MAAM,QAAW,GAAA,yBAAA;AACX,MAAA,WAAA,GAAc,OAAO,YAAA,KAAgB,QAAY,IAAA,aAAA;AACjD,MAAA,UAAA,GAAa,OAAO,WAAA,KAAgB,QAAY,IAAA;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liveblocks/react-flow",
-  "version": "3.16.0-flow3",
+  "version": "3.17.0-rc1",
   "description": "An integration of React Flow to enable collaboration and realtime cursors with Liveblocks.",
   "license": "Apache-2.0",
   "author": "Liveblocks Inc.",
@@ -40,13 +40,14 @@
     "lint": "eslint src/ && stylelint src/styles/",
     "test": "npx liveblocks dev -p 1154 -c 'vitest run --coverage'",
     "test:ci": "vitest run",
+    "test:types": "ls test-d/* | xargs -n1 tsd --files",
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@liveblocks/client": "3.16.0-flow3",
-    "@liveblocks/core": "3.16.0-flow3",
-    "@liveblocks/react": "3.16.0-flow3",
-    "@liveblocks/react-ui": "3.16.0-flow3"
+    "@liveblocks/client": "3.17.0-rc1",
+    "@liveblocks/core": "3.17.0-rc1",
+    "@liveblocks/react": "3.17.0-rc1",
+    "@liveblocks/react-ui": "3.17.0-rc1"
   },
   "peerDependencies": {
     "@xyflow/react": "^12",