@dxos/plugin-explorer 0.8.1-main.303c73a → 0.8.1-main.81238a8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-explorer",
-  "version": "0.8.1-main.303c73a",
+  "version": "0.8.1-main.81238a8",
   "description": "Braneframe data visualization plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -33,29 +33,30 @@
     "src"
   ],
   "dependencies": {
+    "3d-force-graph": "^1.76.1",
     "@observablehq/plot": "^0.6.11",
     "@preact/signals-core": "^1.6.0",
     "d3": "^7.9.0",
-    "force-graph": "1.49.3",
+    "force-graph": "^1.49.4",
     "lodash.defaultsdeep": "^4.6.1",
     "lodash.get": "^4.4.2",
     "react-resize-detector": "^11.0.1",
     "topojson-client": "^3.1.0",
-    "@dxos/app-framework": "0.8.1-main.303c73a",
-    "@dxos/async": "0.8.1-main.303c73a",
-    "@dxos/echo-schema": "0.8.1-main.303c73a",
-    "@dxos/client": "0.8.1-main.303c73a",
-    "@dxos/live-object": "0.8.1-main.303c73a",
-    "@dxos/gem-spore": "0.8.1-main.303c73a",
-    "@dxos/gem-core": "0.8.1-main.303c73a",
-    "@dxos/log": "0.8.1-main.303c73a",
-    "@dxos/plugin-client": "0.8.1-main.303c73a",
-    "@dxos/plugin-search": "0.8.1-main.303c73a",
-    "@dxos/plugin-graph": "0.8.1-main.303c73a",
-    "@dxos/plugin-space": "0.8.1-main.303c73a",
-    "@dxos/react-client": "0.8.1-main.303c73a",
-    "@dxos/react-ui-stack": "0.8.1-main.303c73a",
-    "@dxos/util": "0.8.1-main.303c73a"
+    "@dxos/client": "0.8.1-main.81238a8",
+    "@dxos/async": "0.8.1-main.81238a8",
+    "@dxos/app-framework": "0.8.1-main.81238a8",
+    "@dxos/echo-schema": "0.8.1-main.81238a8",
+    "@dxos/gem-spore": "0.8.1-main.81238a8",
+    "@dxos/gem-core": "0.8.1-main.81238a8",
+    "@dxos/log": "0.8.1-main.81238a8",
+    "@dxos/plugin-client": "0.8.1-main.81238a8",
+    "@dxos/plugin-graph": "0.8.1-main.81238a8",
+    "@dxos/live-object": "0.8.1-main.81238a8",
+    "@dxos/plugin-search": "0.8.1-main.81238a8",
+    "@dxos/plugin-space": "0.8.1-main.81238a8",
+    "@dxos/react-client": "0.8.1-main.81238a8",
+    "@dxos/react-ui-stack": "0.8.1-main.81238a8",
+    "@dxos/util": "0.8.1-main.81238a8"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -70,19 +71,19 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/echo-generator": "0.8.1-main.303c73a",
-    "@dxos/plugin-outliner": "0.8.1-main.303c73a",
-    "@dxos/react-ui-theme": "0.8.1-main.303c73a",
-    "@dxos/storybook-utils": "0.8.1-main.303c73a",
-    "@dxos/react-ui": "0.8.1-main.303c73a",
-    "@dxos/random": "0.8.1-main.303c73a"
+    "@dxos/plugin-outliner": "0.8.1-main.81238a8",
+    "@dxos/echo-generator": "0.8.1-main.81238a8",
+    "@dxos/random": "0.8.1-main.81238a8",
+    "@dxos/react-ui": "0.8.1-main.81238a8",
+    "@dxos/react-ui-theme": "0.8.1-main.81238a8",
+    "@dxos/storybook-utils": "0.8.1-main.81238a8"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.1-main.303c73a",
-    "@dxos/react-ui-theme": "0.8.1-main.303c73a"
+    "@dxos/react-ui": "0.8.1-main.81238a8",
+    "@dxos/react-ui-theme": "0.8.1-main.81238a8"
   },
   "publishConfig": {
     "access": "public"

package/src/ExplorerPlugin.tsx

@@ -26,7 +26,7 @@ export const ExplorerPlugin = () =>
         contributes(Capabilities.Metadata, {
           id: ViewType.typename,
           metadata: {
-            placeholder: ['object title placeholder', { ns: EXPLORER_PLUGIN }],
+            placeholder: ['object placeholder', { ns: EXPLORER_PLUGIN }],
             icon: 'ph--graph--regular',
           },
         }),

package/src/capabilities/react-surface.tsx

@@ -5,6 +5,7 @@
 import React from 'react';
 
 import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
+import { isInstanceOf } from '@dxos/echo-schema';
 
 import { ExplorerContainer } from '../components';
 import { EXPLORER_PLUGIN } from '../meta';
@@ -16,7 +17,7 @@ export default () =>
     createSurface({
       id: `${EXPLORER_PLUGIN}/article`,
       role: ['article', 'section'],
-      filter: (data): data is { subject: ViewType } => data.subject instanceof ViewType,
+      filter: (data): data is { subject: ViewType } => isInstanceOf(ViewType, data.subject),
       component: ({ data, role }) => <ExplorerContainer view={data.subject} role={role} />,
     }),
   );

package/src/components/Graph/Graph.tsx

@@ -34,6 +34,7 @@ export const Graph: FC<GraphProps> = ({ space, match }) => {
   useEffect(() => {
     if (rootRef.current) {
       // https://github.com/vasturiano/force-graph
+      // https://github.com/vasturiano/3d-force-graph
       forceGraph.current = new ForceGraph(rootRef.current)
         .nodeRelSize(6)
         .nodeLabel((node: any) => {

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

@@ -7,59 +7,26 @@ import '@dxos-theme';
 import { type Meta } from '@storybook/react';
 import React, { type FC, useEffect, useState } from 'react';
 
-import { create, makeRef } from '@dxos/live-object';
-import { TreeItemType, TreeType } from '@dxos/plugin-outliner/types';
+import { TreeType, Tree as TreeModel } from '@dxos/plugin-outliner/types';
 import { faker } from '@dxos/random';
 import { useClient } from '@dxos/react-client';
 import { type ClientRepeatedComponentProps, ClientRepeater } from '@dxos/react-client/testing';
 import { withLayout, withTheme } from '@dxos/storybook-utils';
-import { range } from '@dxos/util';
 
 import { Tree, type TreeComponentProps } from './Tree';
 
 // TODO(burdon): Storybook for Graph/Tree/Plot (generics); incl. GraphModel.
 // TODO(burdon): Type for all Explorer components (Space, Object, Query, etc.) incl.
-// TODO(burdon): Factor out to gem?
 
 faker.seed(1);
 
-const makeTreeItems = <T extends number>(count: T, items: TreeItemType[] = []) => {
-  return range(count, () => create(TreeItemType, { content: '', items: items.map((item) => makeRef(item)) }));
-};
-
 const Story: FC<ClientRepeatedComponentProps & { type?: TreeComponentProps<any>['variant'] }> = ({ type }) => {
   const client = useClient();
   const space = client.spaces.default;
   const [object, setObject] = useState<TreeType>();
   useEffect(() => {
     setTimeout(() => {
-      const tree = create(TreeType, {
-        root: makeRef(
-          makeTreeItems(1, [
-            ...makeTreeItems(7),
-            ...makeTreeItems(1, [
-              ...makeTreeItems(1),
-              ...makeTreeItems(1, [
-                ...makeTreeItems(3),
-                ...makeTreeItems(1, makeTreeItems(2)),
-                ...makeTreeItems(2),
-                ...makeTreeItems(1, makeTreeItems(2)),
-                ...makeTreeItems(2),
-              ]),
-              ...makeTreeItems(1),
-            ]),
-            ...makeTreeItems(2),
-            ...makeTreeItems(1, [
-              ...makeTreeItems(1),
-              ...makeTreeItems(1, [...makeTreeItems(2), ...makeTreeItems(1, makeTreeItems(2))]),
-              ...makeTreeItems(1),
-            ]),
-            ...makeTreeItems(2),
-          ])[0],
-        ),
-      });
-
-      space.db.add(tree);
+      const tree = space.db.add(TreeModel.create());
       setObject(tree);
     });
   }, []);
@@ -92,7 +59,7 @@ export const Edge = {
 const meta: Meta = {
   title: 'plugins/plugin-explorer/Tree',
   component: Tree,
-  render: () => <ClientRepeater component={Story} types={[TreeType, TreeItemType]} createSpace />,
+  render: () => <ClientRepeater component={Story} types={[TreeType]} createSpace />,
   decorators: [withTheme, withLayout({ fullscreen: true })],
   parameters: {
     layout: 'fullscreen',

package/src/meta.ts

@@ -6,7 +6,7 @@ import { type PluginMeta } from '@dxos/app-framework';
 
 export const EXPLORER_PLUGIN = 'dxos.org/plugin/explorer';
 
-export const meta = {
+export const meta: PluginMeta = {
   id: EXPLORER_PLUGIN,
   name: 'Explorer',
   description: 'Install this plugin to view a hypergraph of all objects inside of your Space.',
@@ -14,4 +14,4 @@ export const meta = {
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/experimental/plugin-explorer',
   tags: ['experimental'],
   screenshots: ['https://dxos.network/plugin-details-explorer-dark.png'],
-} satisfies PluginMeta;
+};

package/src/translations.ts

@@ -14,7 +14,7 @@ export default [
       [EXPLORER_PLUGIN]: {
         'plugin name': 'Explorer',
         'object title label': 'Title',
-        'object title placeholder': 'New explorer',
+        'object placeholder': 'New explorer',
         'create object label': 'Create explorer',
       },
     },

package/dist/lib/browser/chunk-QOKAZK4V.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type PluginMeta } from '@dxos/app-framework';\n\nexport const EXPLORER_PLUGIN = 'dxos.org/plugin/explorer';\n\nexport const meta = {\n  id: EXPLORER_PLUGIN,\n  name: 'Explorer',\n  description: 'Install this plugin to view a hypergraph of all objects inside of your Space.',\n  icon: 'ph--graph--regular',\n  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/experimental/plugin-explorer',\n  tags: ['experimental'],\n  screenshots: ['https://dxos.network/plugin-details-explorer-dark.png'],\n} satisfies PluginMeta;\n"],
-  "mappings": ";AAMO,IAAMA,kBAAkB;AAExB,IAAMC,OAAO;EAClBC,IAAIF;EACJG,MAAM;EACNC,aAAa;EACbC,MAAM;EACNC,QAAQ;EACRC,MAAM;IAAC;;EACPC,aAAa;IAAC;;AAChB;",
-  "names": ["EXPLORER_PLUGIN", "meta", "id", "name", "description", "icon", "source", "tags", "screenshots"]
-}

package/dist/lib/browser/react-surface-Q7OT6GXC.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/react-surface.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Capabilities, contributes, createSurface } from '@dxos/app-framework';\n\nimport { ExplorerContainer } from '../components';\nimport { EXPLORER_PLUGIN } from '../meta';\nimport { ViewType } from '../types';\n\nexport default () =>\n  contributes(\n    Capabilities.ReactSurface,\n    createSurface({\n      id: `${EXPLORER_PLUGIN}/article`,\n      role: ['article', 'section'],\n      filter: (data): data is { subject: ViewType } => data.subject instanceof ViewType,\n      component: ({ data, role }) => <ExplorerContainer view={data.subject} role={role} />,\n    }),\n  );\n"],
-  "mappings": ";;;;;;;;;;;;AAIA,OAAOA,WAAW;AAElB,SAASC,cAAcC,aAAaC,qBAAqB;AAMzD,IAAA,wBAAe,MACbC,YACEC,aAAaC,cACbC,cAAc;EACZC,IAAI,GAAGC,eAAAA;EACPC,MAAM;IAAC;IAAW;;EAClBC,QAAQ,CAACC,SAAwCA,KAAKC,mBAAmBC;EACzEC,WAAW,CAAC,EAAEH,MAAMF,KAAI,MAAO,sBAAA,cAACM,mBAAAA;IAAkBC,MAAML,KAAKC;IAASH;;AACxE,CAAA,CAAA;",
-  "names": ["React", "Capabilities", "contributes", "createSurface", "contributes", "Capabilities", "ReactSurface", "createSurface", "id", "EXPLORER_PLUGIN", "role", "filter", "data", "subject", "ViewType", "component", "ExplorerContainer", "view"]
-}

package/dist/lib/node/chunk-5MTMJYC4.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type PluginMeta } from '@dxos/app-framework';\n\nexport const EXPLORER_PLUGIN = 'dxos.org/plugin/explorer';\n\nexport const meta = {\n  id: EXPLORER_PLUGIN,\n  name: 'Explorer',\n  description: 'Install this plugin to view a hypergraph of all objects inside of your Space.',\n  icon: 'ph--graph--regular',\n  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/experimental/plugin-explorer',\n  tags: ['experimental'],\n  screenshots: ['https://dxos.network/plugin-details-explorer-dark.png'],\n} satisfies PluginMeta;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAMO,IAAMA,kBAAkB;AAExB,IAAMC,OAAO;EAClBC,IAAIF;EACJG,MAAM;EACNC,aAAa;EACbC,MAAM;EACNC,QAAQ;EACRC,MAAM;IAAC;;EACPC,aAAa;IAAC;;AAChB;",
-  "names": ["EXPLORER_PLUGIN", "meta", "id", "name", "description", "icon", "source", "tags", "screenshots"]
-}

package/dist/lib/node/react-surface-5G52HSJW.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/react-surface.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Capabilities, contributes, createSurface } from '@dxos/app-framework';\n\nimport { ExplorerContainer } from '../components';\nimport { EXPLORER_PLUGIN } from '../meta';\nimport { ViewType } from '../types';\n\nexport default () =>\n  contributes(\n    Capabilities.ReactSurface,\n    createSurface({\n      id: `${EXPLORER_PLUGIN}/article`,\n      role: ['article', 'section'],\n      filter: (data): data is { subject: ViewType } => data.subject instanceof ViewType,\n      component: ({ data, role }) => <ExplorerContainer view={data.subject} role={role} />,\n    }),\n  );\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,mBAAkB;AAElB,2BAAyD;AAMzD,IAAA,wBAAe,UACbA,kCACEC,kCAAaC,kBACbC,oCAAc;EACZC,IAAI,GAAGC,qCAAAA;EACPC,MAAM;IAAC;IAAW;;EAClBC,QAAQ,CAACC,SAAwCA,KAAKC,mBAAmBC;EACzEC,WAAW,CAAC,EAAEH,MAAMF,KAAI,MAAO,6BAAAM,QAAA,cAACC,yCAAAA;IAAkBC,MAAMN,KAAKC;IAASH;;AACxE,CAAA,CAAA;",
-  "names": ["contributes", "Capabilities", "ReactSurface", "createSurface", "id", "EXPLORER_PLUGIN", "role", "filter", "data", "subject", "ViewType", "component", "React", "ExplorerContainer", "view"]
-}

package/dist/lib/node-esm/chunk-UHJZUVRI.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/meta.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type PluginMeta } from '@dxos/app-framework';\n\nexport const EXPLORER_PLUGIN = 'dxos.org/plugin/explorer';\n\nexport const meta = {\n  id: EXPLORER_PLUGIN,\n  name: 'Explorer',\n  description: 'Install this plugin to view a hypergraph of all objects inside of your Space.',\n  icon: 'ph--graph--regular',\n  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/experimental/plugin-explorer',\n  tags: ['experimental'],\n  screenshots: ['https://dxos.network/plugin-details-explorer-dark.png'],\n} satisfies PluginMeta;\n"],
-  "mappings": ";;;AAMO,IAAMA,kBAAkB;AAExB,IAAMC,OAAO;EAClBC,IAAIF;EACJG,MAAM;EACNC,aAAa;EACbC,MAAM;EACNC,QAAQ;EACRC,MAAM;IAAC;;EACPC,aAAa;IAAC;;AAChB;",
-  "names": ["EXPLORER_PLUGIN", "meta", "id", "name", "description", "icon", "source", "tags", "screenshots"]
-}

package/dist/lib/node-esm/react-surface-QSQVINGP.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/react-surface.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Capabilities, contributes, createSurface } from '@dxos/app-framework';\n\nimport { ExplorerContainer } from '../components';\nimport { EXPLORER_PLUGIN } from '../meta';\nimport { ViewType } from '../types';\n\nexport default () =>\n  contributes(\n    Capabilities.ReactSurface,\n    createSurface({\n      id: `${EXPLORER_PLUGIN}/article`,\n      role: ['article', 'section'],\n      filter: (data): data is { subject: ViewType } => data.subject instanceof ViewType,\n      component: ({ data, role }) => <ExplorerContainer view={data.subject} role={role} />,\n    }),\n  );\n"],
-  "mappings": ";;;;;;;;;;;;;AAIA,OAAOA,WAAW;AAElB,SAASC,cAAcC,aAAaC,qBAAqB;AAMzD,IAAA,wBAAe,MACbC,YACEC,aAAaC,cACbC,cAAc;EACZC,IAAI,GAAGC,eAAAA;EACPC,MAAM;IAAC;IAAW;;EAClBC,QAAQ,CAACC,SAAwCA,KAAKC,mBAAmBC;EACzEC,WAAW,CAAC,EAAEH,MAAMF,KAAI,MAAO,sBAAA,cAACM,mBAAAA;IAAkBC,MAAML,KAAKC;IAASH;;AACxE,CAAA,CAAA;",
-  "names": ["React", "Capabilities", "contributes", "createSurface", "contributes", "Capabilities", "ReactSurface", "createSurface", "id", "EXPLORER_PLUGIN", "role", "filter", "data", "subject", "ViewType", "component", "ExplorerContainer", "view"]
-}