@dxos/plugin-explorer 0.8.4-main.1068cf700f → 0.8.4-main.1c7ec43d41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-explorer",
-  "version": "0.8.4-main.1068cf700f",
+  "version": "0.8.4-main.1c7ec43d41",
   "description": "Braneframe data visualization plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -12,37 +12,55 @@
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#plugin": "./src/ExplorerPlugin.tsx",
+    "#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",
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs",
-      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts"
     },
     "./meta": {
+      "source": "./src/meta.ts",
       "browser": "./dist/lib/browser/meta.mjs",
       "node": "./dist/lib/node-esm/meta.mjs",
-      "source": "./src/meta.ts",
       "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"
+    },
+    "./components": {
+      "source": "./src/components/index.ts",
+      "browser": "./dist/lib/browser/components/index.mjs",
+      "node": "./dist/lib/node-esm/components/index.mjs",
+      "types": "./dist/types/src/components/index.d.ts"
+    },
+    "./hooks": {
+      "source": "./src/hooks/index.ts",
+      "browser": "./dist/lib/browser/hooks/index.mjs",
+      "node": "./dist/lib/node-esm/hooks/index.mjs",
+      "types": "./dist/types/src/hooks/index.d.ts"
+    },
     "./types": {
+      "source": "./src/types/index.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
       "node": "./dist/lib/node-esm/types/index.mjs",
-      "source": "./src/types/index.ts",
       "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"
@@ -52,35 +70,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.1068cf700f",
-    "@dxos/app-toolkit": "0.8.4-main.1068cf700f",
-    "@dxos/async": "0.8.4-main.1068cf700f",
-    "@dxos/echo": "0.8.4-main.1068cf700f",
-    "@dxos/client": "0.8.4-main.1068cf700f",
-    "@dxos/echo-query": "0.8.4-main.1068cf700f",
-    "@dxos/log": "0.8.4-main.1068cf700f",
-    "@dxos/graph": "0.8.4-main.1068cf700f",
-    "@dxos/invariant": "0.8.4-main.1068cf700f",
-    "@dxos/plugin-client": "0.8.4-main.1068cf700f",
-    "@dxos/operation": "0.8.4-main.1068cf700f",
-    "@dxos/plugin-search": "0.8.4-main.1068cf700f",
-    "@dxos/plugin-space": "0.8.4-main.1068cf700f",
-    "@dxos/plugin-graph": "0.8.4-main.1068cf700f",
-    "@dxos/react-client": "0.8.4-main.1068cf700f",
-    "@dxos/react-ui-attention": "0.8.4-main.1068cf700f",
-    "@dxos/react-ui-components": "0.8.4-main.1068cf700f",
-    "@dxos/react-ui-mosaic": "0.8.4-main.1068cf700f",
-    "@dxos/react-ui-graph": "0.8.4-main.1068cf700f",
-    "@dxos/react-ui-stack": "0.8.4-main.1068cf700f",
-    "@dxos/schema": "0.8.4-main.1068cf700f",
-    "@dxos/types": "0.8.4-main.1068cf700f",
-    "@dxos/util": "0.8.4-main.1068cf700f"
+    "@dxos/app-framework": "0.8.4-main.1c7ec43d41",
+    "@dxos/app-toolkit": "0.8.4-main.1c7ec43d41",
+    "@dxos/async": "0.8.4-main.1c7ec43d41",
+    "@dxos/echo": "0.8.4-main.1c7ec43d41",
+    "@dxos/echo-query": "0.8.4-main.1c7ec43d41",
+    "@dxos/compute": "0.8.4-main.1c7ec43d41",
+    "@dxos/graph": "0.8.4-main.1c7ec43d41",
+    "@dxos/invariant": "0.8.4-main.1c7ec43d41",
+    "@dxos/plugin-client": "0.8.4-main.1c7ec43d41",
+    "@dxos/log": "0.8.4-main.1c7ec43d41",
+    "@dxos/plugin-graph": "0.8.4-main.1c7ec43d41",
+    "@dxos/plugin-space": "0.8.4-main.1c7ec43d41",
+    "@dxos/plugin-search": "0.8.4-main.1c7ec43d41",
+    "@dxos/react-client": "0.8.4-main.1c7ec43d41",
+    "@dxos/client": "0.8.4-main.1c7ec43d41",
+    "@dxos/react-ui-attention": "0.8.4-main.1c7ec43d41",
+    "@dxos/react-ui-components": "0.8.4-main.1c7ec43d41",
+    "@dxos/react-ui-graph": "0.8.4-main.1c7ec43d41",
+    "@dxos/react-ui-mosaic": "0.8.4-main.1c7ec43d41",
+    "@dxos/react-ui-stack": "0.8.4-main.1c7ec43d41",
+    "@dxos/schema": "0.8.4-main.1c7ec43d41",
+    "@dxos/types": "0.8.4-main.1c7ec43d41",
+    "@dxos/util": "0.8.4-main.1c7ec43d41"
   },
   "devDependencies": {
     "@types/d3": "^7.4.3",
@@ -92,19 +110,21 @@
     "@types/topojson-specification": "^1.0.5",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "7.1.9",
-    "@dxos/echo-generator": "0.8.4-main.1068cf700f",
-    "@dxos/random": "0.8.4-main.1068cf700f",
-    "@dxos/react-ui": "0.8.4-main.1068cf700f",
-    "@dxos/storybook-utils": "0.8.4-main.1068cf700f",
-    "@dxos/ui-theme": "0.8.4-main.1068cf700f"
+    "vite": "^8.0.10",
+    "@dxos/echo-generator": "0.8.4-main.1c7ec43d41",
+    "@dxos/plugin-preview": "0.8.4-main.1c7ec43d41",
+    "@dxos/random": "0.8.4-main.1c7ec43d41",
+    "@dxos/ui-theme": "0.8.4-main.1c7ec43d41",
+    "@dxos/plugin-testing": "0.8.4-main.1c7ec43d41",
+    "@dxos/react-ui": "0.8.4-main.1c7ec43d41",
+    "@dxos/storybook-utils": "0.8.4-main.1c7ec43d41"
   },
   "peerDependencies": {
-    "effect": "3.19.16",
+    "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.1068cf700f",
-    "@dxos/ui-theme": "0.8.4-main.1068cf700f"
+    "@dxos/react-ui": "0.8.4-main.1c7ec43d41",
+    "@dxos/ui-theme": "0.8.4-main.1c7ec43d41"
   },
   "publishConfig": {
     "access": "public"

package/src/ExplorerPlugin.test.ts

@@ -0,0 +1,26 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { ClientPlugin } from '@dxos/plugin-client';
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { ExplorerPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('ExplorerPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [ClientPlugin({}), ExplorerPlugin()],
+    });
+
+    expect(harness.manager.getActive()).toEqual(
+      expect.arrayContaining([moduleId('CreateObject'), moduleId('schema'), moduleId('ReactSurface')]),
+    );
+  });
+});

package/src/ExplorerPlugin.tsx

@@ -2,37 +2,20 @@
 // Copyright 2023 DXOS.org
 //
 
-import * as Effect from 'effect/Effect';
-
 import { Plugin } from '@dxos/app-framework';
 import { AppPlugin } from '@dxos/app-toolkit';
-import { Type } from '@dxos/echo';
-import { type CreateObject } from '@dxos/plugin-space/types';
-import { View } from '@dxos/schema';
 
-import { ReactSurface } from './capabilities';
-import { meta } from './meta';
-import { translations } from './translations';
-import { ExplorerAction, Graph } from './types';
+import { CreateObject, ReactSurface } from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
+import { 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',
-        inputSchema: ExplorerAction.GraphProps,
-        createObject: ((props, { db }) =>
-          Effect.promise(async () => {
-            const { view } = await View.makeFromDatabase({ db, typename: props.typename });
-            return Graph.make({ name: props.name, view });
-          })) satisfies CreateObject,
-      },
-    },
-  }),
+  AppPlugin.addCreateObjectModule({ activate: CreateObject }),
   AppPlugin.addSchemaModule({ schema: [Graph.Graph] }),
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations }),
   Plugin.make,
 );
+
+export default ExplorerPlugin;

package/src/capabilities/create-object.ts

@@ -0,0 +1,36 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+import { Type } from '@dxos/echo';
+import { SpaceOperation } from '@dxos/plugin-space/operations';
+import { SpaceCapabilities } from '@dxos/plugin-space/types';
+import { ViewModel } from '@dxos/schema';
+
+import { ExplorerAction, Graph } from '#types';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {
+      id: Type.getTypename(Graph.Graph),
+      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,
+          });
+        }),
+    });
+  }),
+);

package/src/capabilities/index.ts

@@ -2,4 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './react-surface';
+import { Capability } from '@dxos/app-framework';
+
+export const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));
+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/schema';
+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 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

@@ -2,42 +2,35 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type Meta } from '@storybook/react-vite';
+import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React from 'react';
 
-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.
-// TODO(burdon): How to provide geo service via agent?
-
-const Story = () => {
-  if (!CitiesData) {
-    return null;
-  }
-
-  const items = CitiesData.features.map((feature: any) => ({
-    x: feature.geometry.coordinates[0],
-    y: feature.geometry.coordinates[1],
-  }));
+const items = CitiesData.features.map((feature: any) => ({
+  x: feature.geometry.coordinates[0],
+  y: feature.geometry.coordinates[1],
+}));
 
-  return <Chart items={items} accessor={(obj) => ({ x: obj.x, y: obj.y })} options={{ stroke: 'blue' }} />;
-};
-
-// TODO(burdon): Change to decorator.
-export const Default = () => <ClientRepeater component={Story} />;
+const DefaultStory = () => (
+  <Chart items={items} accessor={(obj) => ({ x: obj.x, y: obj.y })} options={{ stroke: 'blue' }} />
+);
 
 const meta = {
-  title: 'plugins/plugin-explorer/Chart',
+  title: 'plugins/plugin-explorer/components/Chart',
   component: Chart,
-  decorators: [withTheme(), withLayout()],
+  render: DefaultStory,
+  decorators: [withTheme(), withLayout({ layout: 'fullscreen' })],
   parameters: {
     layout: 'fullscreen',
   },
 } satisfies Meta<typeof Chart>;
 
 export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};

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

@@ -3,31 +3,27 @@
 //
 
 import { dot, geo, graticule, plot, sphere } from '@observablehq/plot';
-import { type Meta } from '@storybook/react-vite';
+import { type Meta, type StoryObj } from '@storybook/react-vite';
 import { geoCircle } from 'd3';
 import React, { useEffect } from 'react';
 import { useResizeDetector } from 'react-resize-detector';
 import { feature } from 'topojson-client';
 
-import { ClientRepeater } from '@dxos/react-client/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.
 // TODO(burdon): How to provide geo service via agent?
 
-const DefaultStory = () => {
-  const items = CitiesData.features.map((feature: any) => ({
-    lat: feature.geometry.coordinates[0],
-    lng: feature.geometry.coordinates[1],
-  }));
+const items = CitiesData.features.map((feature: any) => ({
+  lat: feature.geometry.coordinates[0],
+  lng: feature.geometry.coordinates[1],
+}));
 
-  return <Globe items={items} />;
-};
+const DefaultStory = () => <Globe items={items} />;
 
 const ExtendedStory = () => {
   const { ref: containerRef, width = 0, height = 0 } = useResizeDetector({ refreshRate: 200 });
@@ -37,11 +33,6 @@ const ExtendedStory = () => {
     }
 
     const land = feature(CountriesData as any, CountriesData.objects.land as any);
-    const items = CitiesData.features.map((feature: any) => ({
-      lat: feature.geometry.coordinates[0],
-      lng: feature.geometry.coordinates[1],
-    }));
-
     const city = items[0];
     const circle = geoCircle().center([city.lat, city.lng]).radius(16)();
 
@@ -50,7 +41,6 @@ const ExtendedStory = () => {
     const drawing = plot({
       // https://observablehq.com/plot/features/projections
       projection: { type: 'orthographic', rotate: [-city.lat + 30, -30] },
-      // projection: { type: 'equirectangular', rotate: [-140, -30] },
       width,
       height,
       style: {
@@ -80,15 +70,22 @@ const ExtendedStory = () => {
 };
 
 const meta = {
-  title: 'plugins/plugin-explorer/Globe',
-  decorators: [withTheme(), withLayout()],
+  title: 'plugins/plugin-explorer/components/Globe',
+  component: Globe,
+  decorators: [withTheme(), withLayout({ layout: 'fullscreen' })],
   parameters: {
     layout: 'fullscreen',
   },
-} satisfies Meta;
+} satisfies Meta<typeof Globe>;
 
 export default meta;
 
-export const Default = () => <ClientRepeater component={DefaultStory} createSpace />;
+type Story = StoryObj<typeof meta>;
 
-export const Extended = () => <ClientRepeater component={ExtendedStory} createSpace />;
+export const Default: Story = {
+  render: DefaultStory,
+};
+
+export const Extended: Story = {
+  render: ExtendedStory,
+};

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

@@ -0,0 +1,83 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { withPluginManager } from '@dxos/app-framework/testing';
+import { Type, View } from '@dxos/echo';
+import { ClientPlugin } from '@dxos/plugin-client';
+import { initializeIdentity } from '@dxos/plugin-client/testing';
+import { corePlugins } from '@dxos/plugin-testing';
+import { random } from '@dxos/random';
+import { useSpaces } from '@dxos/react-client/echo';
+import { Loading, withLayout, withTheme } from '@dxos/react-ui/testing';
+import { ViewModel } from '@dxos/schema';
+import { type ValueGenerator } from '@dxos/schema/testing';
+import { HasRelationship, Organization, Person, Pipeline } from '@dxos/types';
+
+import { useGraphModel } from '#hooks';
+import { Graph } from '#types';
+
+import { CanvasForceGraph } from './CanvasForceGraph';
+import { generate } from './testing';
+
+const generator = random as any as ValueGenerator;
+
+random.seed(1);
+
+const DefaultStory = () => {
+  const [space] = useSpaces();
+  const model = useGraphModel(space);
+  if (!space || !model) {
+    return <Loading data={{ space: !!space, model: !!model }} />;
+  }
+
+  return <CanvasForceGraph model={model} />;
+};
+
+const meta = {
+  title: 'plugins/plugin-explorer/components/CanvasForceGraph',
+  component: CanvasForceGraph,
+  render: DefaultStory,
+  decorators: [
+    withTheme(),
+    withLayout({ layout: 'fullscreen' }),
+    withPluginManager({
+      plugins: [
+        ...corePlugins(),
+        ClientPlugin({
+          types: [
+            Graph.Graph,
+            View.View,
+            HasRelationship.HasRelationship,
+            Organization.Organization,
+            Pipeline.Pipeline,
+            Person.Person,
+          ],
+          onClientInitialized: ({ client }) =>
+            Effect.gen(function* () {
+              const { personalSpace } = yield* initializeIdentity(client);
+              yield* Effect.promise(() => generate(personalSpace, generator));
+              const { view } = yield* Effect.promise(() =>
+                ViewModel.makeFromDatabase({ db: personalSpace.db, typename: Type.getTypename(Graph.Graph) }),
+              );
+              personalSpace.db.add(Graph.make({ name: 'Test', view }));
+              yield* Effect.promise(() => personalSpace.db.flush({ indexes: true }));
+            }),
+        }),
+      ],
+    }),
+  ],
+  parameters: {
+    layout: 'fullscreen',
+  },
+} satisfies Meta<typeof CanvasForceGraph>;
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};