@dxos/plugin-explorer 0.8.4-main.406dc2a → 0.8.4-main.422d1c7879

package/package.json

@@ -1,104 +1,108 @@
 {
   "name": "@dxos/plugin-explorer",
-  "version": "0.8.4-main.406dc2a",
+  "version": "0.8.4-main.422d1c7879",
   "description": "Braneframe data visualization plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "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",
+    "#types": "./src/types/index.ts"
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs"
+      "node": "./dist/lib/node-esm/index.mjs",
+      "types": "./dist/types/src/index.d.ts"
     },
     "./meta": {
       "source": "./src/meta.ts",
-      "types": "./dist/types/src/meta.d.ts",
       "browser": "./dist/lib/browser/meta.mjs",
-      "node": "./dist/lib/node-esm/meta.mjs"
+      "node": "./dist/lib/node-esm/meta.mjs",
+      "types": "./dist/types/src/meta.d.ts"
     },
     "./types": {
       "source": "./src/types/index.ts",
-      "types": "./dist/types/src/types/index.d.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
-      "node": "./dist/lib/node-esm/types/index.mjs"
+      "node": "./dist/lib/node-esm/types/index.mjs",
+      "types": "./dist/types/src/types/index.d.ts"
     }
   },
   "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"
   ],
   "dependencies": {
     "3d-force-graph": "^1.76.1",
+    "@effect-atom/atom-react": "^0.5.0",
     "@observablehq/plot": "^0.6.11",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.12.1",
     "d3": "^7.9.0",
-    "effect": "3.18.3",
+    "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.406dc2a",
-    "@dxos/client": "0.8.4-main.406dc2a",
-    "@dxos/async": "0.8.4-main.406dc2a",
-    "@dxos/echo": "0.8.4-main.406dc2a",
-    "@dxos/echo-query": "0.8.4-main.406dc2a",
-    "@dxos/graph": "0.8.4-main.406dc2a",
-    "@dxos/invariant": "0.8.4-main.406dc2a",
-    "@dxos/live-object": "0.8.4-main.406dc2a",
-    "@dxos/log": "0.8.4-main.406dc2a",
-    "@dxos/plugin-client": "0.8.4-main.406dc2a",
-    "@dxos/plugin-graph": "0.8.4-main.406dc2a",
-    "@dxos/plugin-search": "0.8.4-main.406dc2a",
-    "@dxos/react-client": "0.8.4-main.406dc2a",
-    "@dxos/plugin-space": "0.8.4-main.406dc2a",
-    "@dxos/react-ui-attention": "0.8.4-main.406dc2a",
-    "@dxos/react-ui-components": "0.8.4-main.406dc2a",
-    "@dxos/react-ui-graph": "0.8.4-main.406dc2a",
-    "@dxos/react-ui-stack": "0.8.4-main.406dc2a",
-    "@dxos/schema": "0.8.4-main.406dc2a",
-    "@dxos/util": "0.8.4-main.406dc2a"
+    "@dxos/app-framework": "0.8.4-main.422d1c7879",
+    "@dxos/app-toolkit": "0.8.4-main.422d1c7879",
+    "@dxos/client": "0.8.4-main.422d1c7879",
+    "@dxos/async": "0.8.4-main.422d1c7879",
+    "@dxos/echo": "0.8.4-main.422d1c7879",
+    "@dxos/echo-query": "0.8.4-main.422d1c7879",
+    "@dxos/graph": "0.8.4-main.422d1c7879",
+    "@dxos/operation": "0.8.4-main.422d1c7879",
+    "@dxos/plugin-client": "0.8.4-main.422d1c7879",
+    "@dxos/plugin-graph": "0.8.4-main.422d1c7879",
+    "@dxos/plugin-search": "0.8.4-main.422d1c7879",
+    "@dxos/invariant": "0.8.4-main.422d1c7879",
+    "@dxos/plugin-space": "0.8.4-main.422d1c7879",
+    "@dxos/react-client": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-attention": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-components": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-graph": "0.8.4-main.422d1c7879",
+    "@dxos/log": "0.8.4-main.422d1c7879",
+    "@dxos/schema": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-mosaic": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui-stack": "0.8.4-main.422d1c7879",
+    "@dxos/types": "0.8.4-main.422d1c7879",
+    "@dxos/util": "0.8.4-main.422d1c7879"
   },
   "devDependencies": {
     "@types/d3": "^7.4.3",
     "@types/d3-hierarchy": "^3.1.6",
     "@types/lodash.defaultsdeep": "^4.6.6",
-    "@types/react": "~19.2.2",
-    "@types/react-dom": "~19.2.1",
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
     "@types/topojson-client": "^3.1.4",
     "@types/topojson-specification": "^1.0.5",
-    "react": "~19.2.0",
-    "react-dom": "~19.2.0",
-    "vite": "7.1.9",
-    "@dxos/react-ui": "0.8.4-main.406dc2a",
-    "@dxos/random": "0.8.4-main.406dc2a",
-    "@dxos/echo-generator": "0.8.4-main.406dc2a",
-    "@dxos/react-ui-theme": "0.8.4-main.406dc2a",
-    "@dxos/storybook-utils": "0.8.4-main.406dc2a"
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "^7.1.11",
+    "@dxos/random": "0.8.4-main.422d1c7879",
+    "@dxos/echo-generator": "0.8.4-main.422d1c7879",
+    "@dxos/react-ui": "0.8.4-main.422d1c7879",
+    "@dxos/storybook-utils": "0.8.4-main.422d1c7879",
+    "@dxos/ui-theme": "0.8.4-main.422d1c7879"
   },
   "peerDependencies": {
-    "effect": "^3.13.3",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@dxos/react-ui": "0.8.4-main.406dc2a",
-    "@dxos/react-ui-theme": "0.8.4-main.406dc2a"
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.422d1c7879",
+    "@dxos/ui-theme": "0.8.4-main.422d1c7879"
   },
   "publishConfig": {
     "access": "public"

package/src/ExplorerPlugin.tsx

@@ -2,60 +2,49 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, createIntent, defineModule, definePlugin } from '@dxos/app-framework';
-import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
-import { SpaceCapabilities } from '@dxos/plugin-space';
-import { defineObjectForm } from '@dxos/plugin-space/types';
+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 { Annotation, Type } from '@dxos/echo';
+import { Operation } from '@dxos/operation';
+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 { ExplorerAction, Graph } from '#types';
 
-import { IntentResolver, ReactSurface } from './capabilities';
-import { meta } from './meta';
 import { translations } from './translations';
-import { ExplorerAction, Graph } from './types';
 
-export const ExplorerPlugin = definePlugin(meta, () => [
-  defineModule({
-    id: `${meta.id}/module/translations`,
-    activatesOn: Events.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, translations),
-  }),
-  defineModule({
-    id: `${meta.id}/module/metadata`,
-    activatesOn: Events.SetupMetadata,
-    activate: () =>
-      contributes(Capabilities.Metadata, {
-        id: Graph.Graph.typename,
-        metadata: {
-          icon: 'ph--graph--regular',
-        },
-      }),
-  }),
-  defineModule({
-    id: `${meta.id}/module/object-form`,
-    activatesOn: ClientEvents.SetupSchema,
-    activate: () =>
-      contributes(
-        SpaceCapabilities.ObjectForm,
-        defineObjectForm({
-          objectSchema: Graph.Graph,
-          formSchema: ExplorerAction.GraphProps,
-          hidden: true,
-          getIntent: (props, options) => createIntent(ExplorerAction.CreateGraph, { ...props, space: options.space }),
-        }),
-      ),
-  }),
-  defineModule({
-    id: `${meta.id}/module/schema`,
-    activatesOn: ClientEvents.SetupSchema,
-    activate: () => contributes(ClientCapabilities.Schema, [Graph.Graph]),
-  }),
-  defineModule({
-    id: `${meta.id}/module/react-surface`,
-    activatesOn: Events.SetupReactSurface,
-    activate: ReactSurface,
-  }),
-  defineModule({
-    id: `${meta.id}/module/intent-resolver`,
-    activatesOn: Events.SetupIntentResolver,
-    activate: IntentResolver,
+export const ExplorerPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addMetadataModule({
+    metadata: {
+      id: Type.getTypename(Graph.Graph),
+      metadata: {
+        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, 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,
+      },
+    },
   }),
-]);
+  AppPlugin.addSchemaModule({ schema: [Graph.Graph] }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations }),
+  Plugin.make,
+);

package/src/capabilities/index.ts

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

package/src/capabilities/react-surface.tsx

@@ -2,26 +2,31 @@
 // Copyright 2025 DXOS.org
 //
 
+import * as Effect from 'effect/Effect';
 import React from 'react';
 
-import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
-import { Obj } from '@dxos/echo';
-import { DataType } from '@dxos/schema';
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Surface } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 
-import { ExplorerContainer } from '../components';
-import { meta } from '../meta';
-import { Graph } from '../types';
+import { ExplorerContainer } from '#containers';
+import { Graph } from '#types';
 
-export default () =>
-  contributes(
-    Capabilities.ReactSurface,
-    createSurface({
-      id: `${meta.id}/article`,
-      role: ['article', 'section'],
-      filter: (data): data is { subject: DataType.View } =>
-        Obj.instanceOf(DataType.View, data.subject) && Obj.instanceOf(Graph.Graph, data.subject.presentation.target),
-      component: ({ data, role }) => {
-        return <ExplorerContainer view={data.subject} role={role} />;
-      },
-    }),
-  );
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(
+      Capabilities.ReactSurface,
+      Surface.create({
+        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} attendableId={data.attendableId} />;
+        },
+      }),
+    ),
+  ),
+);

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

@@ -6,10 +6,9 @@ import { type Meta } from '@storybook/react-vite';
 import React from 'react';
 
 import { ClientRepeater } from '@dxos/react-client/testing';
-import { withTheme } from '@dxos/react-ui/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.
@@ -32,9 +31,9 @@ const Story = () => {
 export const Default = () => <ClientRepeater component={Story} />;
 
 const meta = {
-  title: 'plugins/plugin-explorer/Chart',
+  title: 'plugins/plugin-explorer/components/Chart',
   component: Chart,
-  decorators: [withTheme],
+  decorators: [withTheme(), withLayout()],
   parameters: {
     layout: 'fullscreen',
   },

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

@@ -10,11 +10,10 @@ import { useResizeDetector } from 'react-resize-detector';
 import { feature } from 'topojson-client';
 
 import { ClientRepeater } from '@dxos/react-client/testing';
-import { withTheme } from '@dxos/react-ui/testing';
+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.
@@ -80,8 +79,8 @@ const ExtendedStory = () => {
 };
 
 const meta = {
-  title: 'plugins/plugin-explorer/Globe',
-  decorators: [withTheme],
+  title: 'plugins/plugin-explorer/components/Globe',
+  decorators: [withTheme(), withLayout()],
   parameters: {
     layout: 'fullscreen',
   },

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

@@ -5,63 +5,69 @@
 import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React, { useState } from 'react';
 
-import { faker } from '@dxos/random';
+import { Type } from '@dxos/echo';
+import { View } from '@dxos/echo';
+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 { withTheme } from '@dxos/react-ui/testing';
-import { DataType } from '@dxos/schema';
+import { Loading, withLayout, withTheme } from '@dxos/react-ui/testing';
+import { ViewModel } from '@dxos/schema';
 import { type ValueGenerator } from '@dxos/schema/testing';
-import { render } from '@dxos/storybook-utils';
+import { withRegistry } 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();
   const [space, setSpace] = useState<Space>();
-  const [view, setView] = useState<DataType.View>();
+  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 Graph.makeView({ client, space, name: 'Test', typename: Graph.Graph.typename });
-    space.db.add(view);
+    const { view } = await ViewModel.makeFromDatabase({ db: space.db, typename: Type.getTypename(Graph.Graph) });
+    const graph = Graph.make({ name: 'Test', view });
+    space.db.add(graph);
     setSpace(space);
-    setView(view);
-  }, []);
+    setGraph(graph);
+  }, [client]);
 
   const model = useGraphModel(space);
-  if (!model || !space || !view) {
-    return null;
+  if (!model || !space || !graph) {
+    return <Loading data={{ model: !!model, space: !!space, graph: !!graph }} />;
   }
 
   return <D3ForceGraph model={model} />;
 };
 
 const meta = {
-  title: 'plugins/plugin-explorer/D3ForceGraph',
+  title: 'plugins/plugin-explorer/components/D3ForceGraph',
   component: D3ForceGraph,
-  render: render(DefaultStory),
+  render: DefaultStory,
   decorators: [
-    withTheme,
+    withRegistry,
+    withTheme(),
+    withLayout(),
     withClientProvider({
       createSpace: true,
       types: [
         Graph.Graph,
-        DataType.View,
-        DataType.Organization,
-        DataType.Project,
-        DataType.Person,
-        DataType.HasRelationship,
+        View.View,
+        Organization.Organization,
+        Pipeline.Pipeline,
+        Person.Person,
+        HasRelationship.HasRelationship,
       ],
     }),
   ],