@dxos/plugin-explorer 0.8.4-main.4a85c3132b → 0.8.4-main.51f1e5ca51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-explorer",
-  "version": "0.8.4-main.4a85c3132b",
+  "version": "0.8.4-main.51f1e5ca51",
   "description": "Braneframe data visualization plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -12,6 +12,15 @@
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#capabilities": "./src/capabilities/index.ts",
+    "#components": "./src/components/index.ts",
+    "#containers": "./src/containers/index.ts",
+    "#hooks": "./src/hooks/index.ts",
+    "#meta": "./src/meta.ts",
+    "#translations": "./src/translations.ts",
+    "#types": "./src/types/index.ts"
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
@@ -25,6 +34,12 @@
       "node": "./dist/lib/node-esm/meta.mjs",
       "types": "./dist/types/src/meta.d.ts"
     },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "browser": "./dist/lib/browser/translations.mjs",
+      "node": "./dist/lib/node-esm/translations.mjs"
+    },
     "./types": {
       "source": "./src/types/index.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
@@ -33,16 +48,6 @@
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "meta": [
-        "dist/types/src/meta.d.ts"
-      ],
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
     "src"
@@ -52,35 +57,35 @@
     "@effect-atom/atom-react": "^0.5.0",
     "@observablehq/plot": "^0.6.11",
     "d3": "^7.9.0",
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "force-graph": "^1.49.4",
     "lodash.defaultsdeep": "^4.6.1",
     "react-resize-detector": "^11.0.1",
     "three": "^0.178.0",
     "topojson-client": "^3.1.0",
-    "@dxos/app-framework": "0.8.4-main.4a85c3132b",
-    "@dxos/async": "0.8.4-main.4a85c3132b",
-    "@dxos/client": "0.8.4-main.4a85c3132b",
-    "@dxos/app-toolkit": "0.8.4-main.4a85c3132b",
-    "@dxos/echo-query": "0.8.4-main.4a85c3132b",
-    "@dxos/echo": "0.8.4-main.4a85c3132b",
-    "@dxos/graph": "0.8.4-main.4a85c3132b",
-    "@dxos/invariant": "0.8.4-main.4a85c3132b",
-    "@dxos/operation": "0.8.4-main.4a85c3132b",
-    "@dxos/log": "0.8.4-main.4a85c3132b",
-    "@dxos/plugin-client": "0.8.4-main.4a85c3132b",
-    "@dxos/plugin-search": "0.8.4-main.4a85c3132b",
-    "@dxos/plugin-graph": "0.8.4-main.4a85c3132b",
-    "@dxos/react-client": "0.8.4-main.4a85c3132b",
-    "@dxos/plugin-space": "0.8.4-main.4a85c3132b",
-    "@dxos/react-ui-attention": "0.8.4-main.4a85c3132b",
-    "@dxos/react-ui-components": "0.8.4-main.4a85c3132b",
-    "@dxos/react-ui-graph": "0.8.4-main.4a85c3132b",
-    "@dxos/react-ui-mosaic": "0.8.4-main.4a85c3132b",
-    "@dxos/schema": "0.8.4-main.4a85c3132b",
-    "@dxos/react-ui-stack": "0.8.4-main.4a85c3132b",
-    "@dxos/types": "0.8.4-main.4a85c3132b",
-    "@dxos/util": "0.8.4-main.4a85c3132b"
+    "@dxos/app-toolkit": "0.8.4-main.51f1e5ca51",
+    "@dxos/app-framework": "0.8.4-main.51f1e5ca51",
+    "@dxos/async": "0.8.4-main.51f1e5ca51",
+    "@dxos/client": "0.8.4-main.51f1e5ca51",
+    "@dxos/echo": "0.8.4-main.51f1e5ca51",
+    "@dxos/compute": "0.8.4-main.51f1e5ca51",
+    "@dxos/echo-query": "0.8.4-main.51f1e5ca51",
+    "@dxos/graph": "0.8.4-main.51f1e5ca51",
+    "@dxos/invariant": "0.8.4-main.51f1e5ca51",
+    "@dxos/log": "0.8.4-main.51f1e5ca51",
+    "@dxos/plugin-graph": "0.8.4-main.51f1e5ca51",
+    "@dxos/plugin-client": "0.8.4-main.51f1e5ca51",
+    "@dxos/plugin-search": "0.8.4-main.51f1e5ca51",
+    "@dxos/plugin-space": "0.8.4-main.51f1e5ca51",
+    "@dxos/react-client": "0.8.4-main.51f1e5ca51",
+    "@dxos/react-ui-graph": "0.8.4-main.51f1e5ca51",
+    "@dxos/react-ui-mosaic": "0.8.4-main.51f1e5ca51",
+    "@dxos/react-ui-attention": "0.8.4-main.51f1e5ca51",
+    "@dxos/react-ui-stack": "0.8.4-main.51f1e5ca51",
+    "@dxos/schema": "0.8.4-main.51f1e5ca51",
+    "@dxos/util": "0.8.4-main.51f1e5ca51",
+    "@dxos/types": "0.8.4-main.51f1e5ca51",
+    "@dxos/react-ui-components": "0.8.4-main.51f1e5ca51"
   },
   "devDependencies": {
     "@types/d3": "^7.4.3",
@@ -92,19 +97,19 @@
     "@types/topojson-specification": "^1.0.5",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/random": "0.8.4-main.4a85c3132b",
-    "@dxos/react-ui": "0.8.4-main.4a85c3132b",
-    "@dxos/storybook-utils": "0.8.4-main.4a85c3132b",
-    "@dxos/ui-theme": "0.8.4-main.4a85c3132b",
-    "@dxos/echo-generator": "0.8.4-main.4a85c3132b"
+    "vite": "^8.0.10",
+    "@dxos/echo-generator": "0.8.4-main.51f1e5ca51",
+    "@dxos/react-ui": "0.8.4-main.51f1e5ca51",
+    "@dxos/random": "0.8.4-main.51f1e5ca51",
+    "@dxos/storybook-utils": "0.8.4-main.51f1e5ca51",
+    "@dxos/ui-theme": "0.8.4-main.51f1e5ca51"
   },
   "peerDependencies": {
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/ui-theme": "0.8.4-main.4a85c3132b",
-    "@dxos/react-ui": "0.8.4-main.4a85c3132b"
+    "@dxos/ui-theme": "0.8.4-main.51f1e5ca51",
+    "@dxos/react-ui": "0.8.4-main.51f1e5ca51"
   },
   "publishConfig": {
     "access": "public"

package/src/ExplorerPlugin.tsx

@@ -3,30 +3,41 @@
 //
 
 import * as Effect from 'effect/Effect';
+import * as Option from 'effect/Option';
 
 import { Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
-import { Type } from '@dxos/echo';
+import { Operation } from '@dxos/compute';
+import { Annotation, Type } from '@dxos/echo';
+import { SpaceOperation } from '@dxos/plugin-space/operations';
 import { type CreateObject } from '@dxos/plugin-space/types';
 import { ViewModel } from '@dxos/schema';
 
-import { ReactSurface } from './capabilities';
-import { meta } from './meta';
-import { translations } from './translations';
-import { ExplorerAction, Graph } from './types';
+import { ReactSurface } from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
+import { ExplorerAction, Graph } from '#types';
 
 export const ExplorerPlugin = Plugin.define(meta).pipe(
   AppPlugin.addMetadataModule({
     metadata: {
       id: Type.getTypename(Graph.Graph),
       metadata: {
-        icon: 'ph--graph--regular',
-        iconHue: 'green',
+        icon: Annotation.IconAnnotation.get(Graph.Graph).pipe(Option.getOrThrow).icon,
+        iconHue: Annotation.IconAnnotation.get(Graph.Graph).pipe(Option.getOrThrow).hue ?? 'white',
         inputSchema: ExplorerAction.GraphProps,
-        createObject: ((props, { db }) =>
-          Effect.promise(async () => {
-            const { view } = await ViewModel.makeFromDatabase({ db, typename: props.typename });
-            return Graph.make({ name: props.name, view });
+        createObject: ((props, options) =>
+          Effect.gen(function* () {
+            const object = yield* Effect.promise(async () => {
+              const { view } = await ViewModel.makeFromDatabase({ db: options.db, typename: props.typename });
+              return Graph.make({ name: props.name, view });
+            });
+            return yield* Operation.invoke(SpaceOperation.AddObject, {
+              object,
+              target: options.target,
+              hidden: true,
+              targetNodeId: options.targetNodeId,
+            });
           })) satisfies CreateObject,
       },
     },

package/src/capabilities/index.ts

@@ -2,4 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './react-surface';
+import { Capability } from '@dxos/app-framework';
+
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/{react-surface/react-surface.tsx → react-surface.tsx}

@@ -7,23 +7,24 @@ import React from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
-import { Obj } from '@dxos/echo';
-import { type View } from '@dxos/echo';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 
-import { ExplorerContainer } from '../../containers';
-import { meta } from '../../meta';
-import { Graph } from '../../types';
+import { ExplorerContainer } from '#containers';
+import { Graph } from '#types';
 
 export default Capability.makeModule(() =>
   Effect.succeed(
     Capability.contributes(
       Capabilities.ReactSurface,
       Surface.create({
-        id: `${meta.id}/article`,
-        role: ['article', 'section'],
-        filter: (data): data is { subject: View.View } => Obj.instanceOf(Graph.Graph, data.subject),
+        id: 'article',
+        // TODO(wittjosiah): Split into multiple surfaces if this filter proves too strict for non-article roles.
+        filter: AppSurface.oneOf(
+          AppSurface.object(AppSurface.Article, Graph.Graph),
+          AppSurface.object(AppSurface.Section, Graph.Graph),
+        ),
         component: ({ data, role }) => {
-          return <ExplorerContainer role={role} subject={data.subject} />;
+          return <ExplorerContainer role={role} subject={data.subject} attendableId={data.attendableId} />;
         },
       }),
     ),

package/src/components/Chart/Chart.stories.tsx

@@ -9,7 +9,6 @@ import { ClientRepeater } from '@dxos/react-client/testing';
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
 import CitiesData from '../../../data/cities.js';
-
 import { Chart } from './Chart';
 
 // TODO(burdon): Generate data with geo lat/lng.

package/src/components/Globe/Globe.stories.tsx

@@ -14,7 +14,6 @@ import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
 import CitiesData from '../../../data/cities.js';
 import CountriesData from '../../../data/countries-110m.js';
-
 import { Globe } from './Globe';
 
 // TODO(burdon): Generate data with geo lat/lng.

package/src/components/Graph/D3ForceGraph.stories.tsx

@@ -7,27 +7,26 @@ import React, { useState } from 'react';
 
 import { Type } from '@dxos/echo';
 import { View } from '@dxos/echo';
-import { faker } from '@dxos/random';
+import { random } from '@dxos/random';
 import { useClient } from '@dxos/react-client';
 import { type Space } from '@dxos/react-client/echo';
 import { withClientProvider } from '@dxos/react-client/testing';
 import { useAsyncEffect } from '@dxos/react-ui';
-import { withLayout, withTheme } from '@dxos/react-ui/testing';
+import { Loading, withLayout, withTheme } from '@dxos/react-ui/testing';
 import { ViewModel } from '@dxos/schema';
 import { type ValueGenerator } from '@dxos/schema/testing';
 import { withRegistry } from '@dxos/storybook-utils';
-import { render } from '@dxos/storybook-utils';
 import { HasRelationship, Organization, Person, Pipeline } from '@dxos/types';
 
-import { useGraphModel } from '../../hooks';
-import { Graph } from '../../types';
+import { useGraphModel } from '#hooks';
+import { Graph } from '#types';
 
 import { D3ForceGraph } from './D3ForceGraph';
 import { generate } from './testing';
 
-const generator = faker as any as ValueGenerator;
+const generator = random as any as ValueGenerator;
 
-faker.seed(1);
+random.seed(1);
 
 const DefaultStory = () => {
   const client = useClient();
@@ -35,7 +34,7 @@ const DefaultStory = () => {
   const [graph, setGraph] = useState<Graph.Graph>();
 
   useAsyncEffect(async () => {
-    const space = client.spaces.default;
+    const space = client.spaces.get()[0];
     void generate(space, generator);
     const { view } = await ViewModel.makeFromDatabase({ db: space.db, typename: Type.getTypename(Graph.Graph) });
     const graph = Graph.make({ name: 'Test', view });
@@ -46,7 +45,7 @@ const DefaultStory = () => {
 
   const model = useGraphModel(space);
   if (!model || !space || !graph) {
-    return null;
+    return <Loading data={{ model: !!model, space: !!space, graph: !!graph }} />;
   }
 
   return <D3ForceGraph model={model} />;
@@ -55,7 +54,7 @@ const DefaultStory = () => {
 const meta = {
   title: 'plugins/plugin-explorer/components/D3ForceGraph',
   component: D3ForceGraph,
-  render: render(DefaultStory),
+  render: DefaultStory,
   decorators: [
     withRegistry,
     withTheme(),

package/src/components/Graph/D3ForceGraph.tsx

@@ -2,11 +2,11 @@
 // Copyright 2023 DXOS.org
 //
 
+import { Atom, useAtomValue } from '@effect-atom/atom-react';
 import React, { type ComponentPropsWithoutRef, useCallback, useEffect, useMemo, useRef } from 'react';
 
 import { Obj } from '@dxos/echo';
 import { SelectionModel } from '@dxos/graph';
-import { type ThemedClassName } from '@dxos/react-ui';
 import {
   type GraphController,
   GraphForceProjector,
@@ -16,87 +16,93 @@ import {
   type SVGContext,
 } from '@dxos/react-ui-graph';
 import { type SpaceGraphEdge, type SpaceGraphModel, type SpaceGraphNode } from '@dxos/schema';
-import { getHashStyles } from '@dxos/ui-theme';
-
+import { composable, composableProps, getHashStyles } from '@dxos/ui-theme';
 import '@dxos/react-ui-graph/styles/graph.css';
 
-export type D3ForceGraphProps = ThemedClassName<
-  {
-    model?: SpaceGraphModel;
-    match?: RegExp;
-    selection?: SelectionModel;
-    grid?: boolean;
-  } & Pick<GraphProps, 'drag'> &
-    ComponentPropsWithoutRef<'div'>
->;
+export type D3ForceGraphProps = {
+  model?: SpaceGraphModel;
+  match?: RegExp;
+  selection?: SelectionModel;
+  grid?: boolean;
+} & Pick<GraphProps, 'drag'> &
+  ComponentPropsWithoutRef<'div'>;
+
+const EMPTY_ATOM = Atom.make<{ nodes: SpaceGraphNode[]; edges: SpaceGraphEdge[] }>({ nodes: [], edges: [] });
+
+export const D3ForceGraph = composable<HTMLDivElement, D3ForceGraphProps>(
+  ({ model, selection: _selection, grid, drag, ...props }, forwardedRef) => {
+    // TODO(wittjosiah): This should go into Graph.tsx but for some reason doesn't work.
+    useAtomValue(model?.graphAtom ?? EMPTY_ATOM);
 
-export const D3ForceGraph = ({ classNames, model, selection: _selection, grid, drag, ...props }: D3ForceGraphProps) => {
-  const context = useRef<SVGContext>(null);
-  const projector = useMemo<GraphForceProjector | undefined>(() => {
-    if (context.current) {
-      return new GraphForceProjector(context.current, {
-        attributes: {
-          linkForce: (edge) => {
-            // TODO(burdon): Check type (currently assumes Employee property).
-            // Edge shouldn't contribute to force if it's not active.
-            return edge.data?.object?.active !== false;
+    const svgRef = useRef<SVGContext>(null);
+    const projector = useMemo<GraphForceProjector | undefined>(() => {
+      if (svgRef.current) {
+        return new GraphForceProjector(svgRef.current, {
+          attributes: {
+            linkForce: (edge) => {
+              // TODO(burdon): Check type (currently assumes Employee property).
+              // Edge shouldn't contribute to force if it's not active.
+              return edge.data?.object?.active !== false;
+            },
           },
-        },
-        forces: {
-          point: {
-            strength: 0.01,
+          forces: {
+            point: {
+              strength: 0.01,
+            },
           },
-        },
-      });
-    }
-  }, [context.current]);
+        });
+      }
+    }, []);
 
-  const graph = useRef<GraphController>(null);
-  const selection = useMemo(() => _selection ?? new SelectionModel(), [_selection]);
-  useEffect(() => selection.subscribe(() => graph.current?.repaint()), [selection]);
+    const graph = useRef<GraphController>(null);
+    const selection = useMemo(() => _selection ?? new SelectionModel(), [_selection]);
+    useEffect(() => selection.subscribe(() => graph.current?.repaint()), [selection]);
 
-  const handleSelect = useCallback<NonNullable<GraphProps['onSelect']>>(
-    (node) => {
-      if (selection.contains(node.id)) {
-        selection.remove(node.id);
-      } else {
-        selection.add(node.id);
-      }
-    },
-    [selection],
-  );
+    const handleSelect = useCallback<NonNullable<GraphProps['onSelect']>>(
+      (node) => {
+        if (selection.contains(node.id)) {
+          selection.remove(node.id);
+        } else {
+          selection.add(node.id);
+        }
+      },
+      [selection],
+    );
 
-  return (
-    <SVG.Root ref={context} classNames={classNames} {...props}>
-      <SVG.Markers />
-      {grid && <SVG.Grid axis />}
-      <SVG.Zoom extent={[1 / 2, 2]}>
-        <SVG.Graph<SpaceGraphNode, SpaceGraphEdge>
-          drag={drag}
-          ref={graph}
-          model={model}
-          projector={projector}
-          labels={{
-            text: (node) => {
-              return node.data?.data.label ?? node.id;
-            },
-          }}
-          attributes={{
-            node: (node: GraphLayoutNode<SpaceGraphNode>) => {
-              const obj = node.data?.data.object;
-              return {
-                data: {
-                  color: getHashStyles(obj && Obj.getTypename(obj))?.hue,
+    return (
+      <div {...composableProps(props, { classNames: 'dx-container' })} ref={forwardedRef}>
+        <SVG.Root ref={svgRef}>
+          <SVG.Markers />
+          {grid && <SVG.Grid axis />}
+          <SVG.Zoom extent={[1 / 2, 2]}>
+            <SVG.Graph<SpaceGraphNode, SpaceGraphEdge>
+              drag={drag}
+              ref={graph}
+              model={model}
+              projector={projector}
+              labels={{
+                text: (node) => {
+                  return node.data?.data.label ?? node.id;
                 },
-                classes: {
-                  'dx-selected': selection.contains(node.id),
+              }}
+              attributes={{
+                node: (node: GraphLayoutNode<SpaceGraphNode>) => {
+                  const obj = node.data?.data.object;
+                  return {
+                    data: {
+                      color: getHashStyles(obj && Obj.getTypename(obj))?.hue,
+                    },
+                    classes: {
+                      'dx-selected': selection.contains(node.id),
+                    },
+                  };
                 },
-              };
-            },
-          }}
-          onSelect={handleSelect}
-        />
-      </SVG.Zoom>
-    </SVG.Root>
-  );
-};
+              }}
+              onSelect={handleSelect}
+            />
+          </SVG.Zoom>
+        </SVG.Root>
+      </div>
+    );
+  },
+);

package/src/components/Graph/ForceGraph.stories.tsx

@@ -7,27 +7,26 @@ import React, { useState } from 'react';
 
 import { Type } from '@dxos/echo';
 import { View } from '@dxos/echo';
-import { faker } from '@dxos/random';
+import { random } from '@dxos/random';
 import { useClient } from '@dxos/react-client';
 import { type Space } from '@dxos/react-client/echo';
 import { withClientProvider } from '@dxos/react-client/testing';
 import { useAsyncEffect } from '@dxos/react-ui';
-import { withLayout, withTheme } from '@dxos/react-ui/testing';
+import { Loading, withLayout, withTheme } from '@dxos/react-ui/testing';
 import { ViewModel } from '@dxos/schema';
 import { type ValueGenerator } from '@dxos/schema/testing';
 import { withRegistry } from '@dxos/storybook-utils';
-import { render } from '@dxos/storybook-utils';
 import { HasRelationship, Organization, Person, Pipeline } from '@dxos/types';
 
-import { useGraphModel } from '../../hooks';
-import { Graph } from '../../types';
+import { useGraphModel } from '#hooks';
+import { Graph } from '#types';
 
 import { ForceGraph } from './ForceGraph';
 import { generate } from './testing';
 
-const generator = faker as any as ValueGenerator;
+const generator = random as any as ValueGenerator;
 
-faker.seed(1);
+random.seed(1);
 
 const DefaultStory = () => {
   const client = useClient();
@@ -35,7 +34,7 @@ const DefaultStory = () => {
   const [graph, setGraph] = useState<Graph.Graph>();
 
   useAsyncEffect(async () => {
-    const space = client.spaces.default;
+    const space = client.spaces.get()[0];
     void generate(space, generator);
     const { view } = await ViewModel.makeFromDatabase({ db: space.db, typename: Type.getTypename(Graph.Graph) });
     const graph = Graph.make({ name: 'Test', view });
@@ -46,7 +45,7 @@ const DefaultStory = () => {
 
   const model = useGraphModel(space);
   if (!model || !space || !graph) {
-    return null;
+    return <Loading data={{ model: !!model, space: !!space, graph: !!graph }} />;
   }
 
   return <ForceGraph model={model} />;
@@ -55,7 +54,7 @@ const DefaultStory = () => {
 const meta = {
   title: 'plugins/plugin-explorer/components/ForceGraph',
   component: ForceGraph,
-  render: render(DefaultStory),
+  render: DefaultStory,
   decorators: [
     withRegistry,
     withTheme(),

package/src/components/Tree/Tree.stories.tsx

@@ -5,7 +5,8 @@
 import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React, { useEffect, useState } from 'react';
 
-import { faker } from '@dxos/random';
+import { invariant } from '@dxos/invariant';
+import { random } from '@dxos/random';
 import { useClient } from '@dxos/react-client';
 import { type ClientRepeatedComponentProps, ClientRepeater } from '@dxos/react-client/testing';
 import { withLayout, withTheme } from '@dxos/react-ui/testing';
@@ -17,13 +18,14 @@ import { Tree as TreeModel, TreeType } from './types';
 // TODO(burdon): Storybook for Graph/Tree/Plot (generics); incl. GraphModel.
 // TODO(burdon): Type for all Explorer components (Space, Object, Query, etc.) incl.
 
-faker.seed(1);
+random.seed(1);
 
 type ComponentProps = ClientRepeatedComponentProps & { type?: TreeComponentProps<any>['variant'] };
 
 const Component = ({ type }: ComponentProps) => {
   const client = useClient();
-  const space = client.spaces.default;
+  const space = client.spaces.get()[0];
+  invariant(space, 'Tree story requires at least one space');
   const [object, setObject] = useState<TreeType>();
   useEffect(() => {
     setTimeout(() => {

package/src/components/Tree/testing/generator.ts

@@ -16,7 +16,7 @@ const random = (min: number, max: number) => Math.floor(Math.random() * (max - m
  */
 export const createTree = (spec: NumberOrNumberArray[] = [], createText?: () => string): Tree => {
   const tree = new Tree();
-  Obj.change(tree.tree, () => {
+  Obj.update(tree.tree, () => {
     tree.root.data = { text: 'root' };
   });
 

package/src/components/Tree/types/tree.test.ts

@@ -5,14 +5,13 @@
 import { describe, test } from 'vitest';
 
 import { Obj, Ref } from '@dxos/echo';
-import { faker } from '@dxos/random';
+import { random } from '@dxos/random';
 import { Task } from '@dxos/types';
 
 import { createTree } from '../testing';
-
 import { type Tree } from './tree';
 
-faker.seed(0);
+random.seed(0);
 
 const print = (tree: Tree) => {
   let count = 0;
@@ -129,7 +128,7 @@ describe('tree', () => {
 
     const tree = createTree();
     const node = tree.addNode(tree.root);
-    Obj.change(tree.tree, () => {
+    Obj.update(tree.tree, () => {
       node.ref = Ref.make(task);
     });
   });