@dxos/plugin-explorer 0.8.4-main.7996785055 → 0.8.4-main.8baae0fced

package/src/testing/relations.ts

@@ -0,0 +1,192 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { type Space } from '@dxos/client/echo';
+import { Obj, Query, Relation } from '@dxos/echo';
+import { type TypeSpec, type ValueGenerator, createObjectFactory } from '@dxos/schema/testing';
+import { HasConnection, HasRelationship, Organization, Person, Pipeline } from '@dxos/types';
+import { range } from '@dxos/util';
+
+import { type BundleEdge } from '../components/Tree/layout';
+import { type TreeNode } from '../components/Tree/types';
+
+const SECTORS = ['Technology', 'Finance', 'Research', 'Media'];
+const CONNECTION_KINDS = ['partner', 'investor', 'vendor', 'customer'];
+
+const pick = <T>(arr: readonly T[], rng = Math.random): T => arr[Math.floor(rng() * arr.length)];
+
+export type ConnectedOrgsResult = {
+  organizations: Obj.Any[];
+  people: Obj.Any[];
+  connections: Obj.Any[];
+};
+
+export type ConnectedOrgsOptions = {
+  organizationCount?: number;
+  personCount?: number;
+  connectionCount?: number;
+};
+
+/**
+ * Populate a space with Organizations, People, and HasConnection relations between organizations.
+ * Uses `createObjectFactory` to generate Org/Person properties from their `GeneratorAnnotation`s,
+ * then layers manual HasConnection relations on top — the connection schema is fixed
+ * (Org→Org) so it isn't a fit for the generator's reference inference.
+ */
+export const generateConnectedOrgs = async (
+  space: Space,
+  generator: ValueGenerator,
+  { organizationCount = 12, personCount = 24, connectionCount = 18 }: ConnectedOrgsOptions = {},
+): Promise<ConnectedOrgsResult> => {
+  const specs: TypeSpec[] = [
+    { type: Organization.Organization, count: organizationCount },
+    // Person has a Ref to Organization — generator fills it from objects already in db.
+    { type: Person.Person, count: personCount },
+  ];
+
+  const factory = createObjectFactory(space.db, generator);
+  await factory(specs);
+
+  const organizations = await space.db.query(Query.type(Organization.Organization)).run();
+  const people = await space.db.query(Query.type(Person.Person)).run();
+
+  const connections: Obj.Any[] = [];
+  const seen = new Set<string>();
+  for (let i = 0; i < connectionCount && organizations.length >= 2; i++) {
+    const source = pick(organizations);
+    const target = pick(organizations);
+    if (source.id === target.id) {
+      continue;
+    }
+    const key = `${source.id}->${target.id}`;
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+
+    const relation = Relation.make(HasConnection.HasConnection, {
+      [Relation.Source]: source as any,
+      [Relation.Target]: target as any,
+      kind: pick(CONNECTION_KINDS),
+    });
+    connections.push(space.db.add(relation as any));
+  }
+
+  await space.db.flush();
+  return { organizations, people, connections };
+};
+
+/**
+ * Build a TreeNode hierarchy: Root → Sector → Organization (leaf).
+ * Organizations are deterministically bucketed into `SECTORS` so the demo has visible groups.
+ */
+export const buildOrgHierarchy = (organizations: Obj.Any[], sectors: readonly string[] = SECTORS): TreeNode => {
+  // Avoid modulo-by-zero / missing-bucket crashes when the caller passes an empty sectors list.
+  const activeSectors = sectors.length > 0 ? sectors : ['Uncategorized'];
+  const buckets = new Map<string, TreeNode[]>();
+  for (const sector of activeSectors) {
+    buckets.set(sector, []);
+  }
+  for (let i = 0; i < organizations.length; i++) {
+    const org = organizations[i] as any;
+    const sector = activeSectors[i % activeSectors.length];
+    buckets.get(sector)!.push({
+      id: org.id,
+      label: org.name ?? org.id.slice(0, 6),
+    });
+  }
+
+  return {
+    id: 'root',
+    label: 'Organizations',
+    children: activeSectors.map((sector) => ({
+      id: `sector:${sector}`,
+      label: sector,
+      children: buckets.get(sector) ?? [],
+    })),
+  };
+};
+
+export type GenerateOptions = {
+  spec?: TypeSpec[];
+  relations?: {
+    count: number;
+    kind: string;
+  };
+};
+
+const defaultGenerateTypes: TypeSpec[] = [
+  {
+    type: Organization.Organization,
+    count: 20,
+  },
+  {
+    type: Person.Person,
+    count: 20,
+  },
+  {
+    type: Pipeline.Pipeline,
+    count: 20,
+  },
+];
+
+const defaultGenerateRelations: NonNullable<GenerateOptions['relations']> = {
+  kind: 'friend',
+  count: 10,
+};
+
+/**
+ * Populate a space with a mixed dataset (Orgs, Pipelines, People) plus
+ * `HasRelationship` edges between random pairs of People.
+ *
+ * Used by the force-directed and canvas-force graph stories that want a
+ * heterogeneous typed dataset without caring about the precise shape of relations.
+ */
+export const generate = async (
+  space: Space,
+  generator: ValueGenerator,
+  { spec = defaultGenerateTypes, relations = defaultGenerateRelations }: GenerateOptions = {},
+) => {
+  const createObjects = createObjectFactory(space.db, generator);
+  await createObjects(spec);
+
+  const contacts: Obj.Any[] = await space.db.query(Query.type(Person.Person)).run();
+  if (contacts.length < 2 || relations.count <= 0) {
+    return;
+  }
+
+  for (const _ of range(relations.count)) {
+    const source = pick(contacts);
+    const target = pick(contacts);
+    if (source.id !== target.id) {
+      space.db.add(
+        Relation.make(HasRelationship.HasRelationship, {
+          [Relation.Source]: source as any,
+          [Relation.Target]: target as any,
+          kind: relations.kind,
+        }) as any,
+      );
+    }
+  }
+};
+
+/**
+ * Convert HasConnection relations into bundle edges between organization ids.
+ */
+export const connectionsToEdges = (connections: Obj.Any[]): BundleEdge[] => {
+  return connections
+    .map((relation): BundleEdge | undefined => {
+      const source = Relation.getSource(relation as any) as any;
+      const target = Relation.getTarget(relation as any) as any;
+      if (!source?.id || !target?.id) {
+        return undefined;
+      }
+      return {
+        source: source.id,
+        target: target.id,
+        kind: (relation as any).kind,
+      };
+    })
+    .filter((e): e is BundleEdge => Boolean(e));
+};

package/src/translations.ts

@@ -4,28 +4,28 @@
 
 import { Type } from '@dxos/echo';
 import { type Resource } from '@dxos/react-ui';
-import { translations as componentsTranslations } from '@dxos/react-ui-components';
+import { translations as componentsTranslations } from '@dxos/react-ui-components/translations';
 
-import { meta } from './meta';
-import { Graph } from './types';
+import { meta } from '#meta';
+import { Graph } from '#types';
 
 export const translations = [
   {
     'en-US': {
       [Type.getTypename(Graph.Graph)]: {
-        'typename label': 'Explorer',
-        'typename label_zero': 'Explorers',
-        'typename label_one': 'Explorer',
-        'typename label_other': 'Explorers',
-        'object name placeholder': 'New explorer',
-        'add object label': 'Add explorer',
-        'rename object label': 'Rename explorer',
-        'delete object label': 'Delete explorer',
-        'object deleted label': 'Explorer deleted',
+        'typename.label': 'Explorer',
+        'typename.label_zero': 'Explorers',
+        'typename.label_one': 'Explorer',
+        'typename.label_other': 'Explorers',
+        'object-name.placeholder': 'New explorer',
+        'add-object.label': 'Add explorer',
+        'rename-object.label': 'Rename explorer',
+        'delete-object.label': 'Delete explorer',
+        'object-deleted.label': 'Explorer deleted',
       },
       [meta.id]: {
-        'plugin name': 'Explorer',
-        'object title label': 'Title',
+        'plugin.name': 'Explorer',
+        'object-title.label': 'Title',
       },
     },
   },

package/src/types/ExplorerAction.ts

@@ -4,7 +4,7 @@
 
 import * as Schema from 'effect/Schema';
 
-import { TypeInputOptionsAnnotation } from '@dxos/plugin-space/types';
+import { TypeInputOptionsAnnotation } from '@dxos/plugin-space';
 
 export const GraphProps = Schema.Struct({
   name: Schema.optional(Schema.String),

package/src/types/Graph.ts

@@ -4,8 +4,7 @@
 
 import * as Schema from 'effect/Schema';
 
-import { Annotation, Filter, Obj, Query, QueryAST, Ref, Type } from '@dxos/echo';
-import { View } from '@dxos/echo';
+import { Annotation, Filter, Obj, Query, QueryAST, Ref, Type, View } from '@dxos/echo';
 import { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/internal';
 import { ViewAnnotation } from '@dxos/schema';
 
@@ -24,7 +23,7 @@ const GraphSchema = Schema.Struct({
     version: '0.1.0',
   }),
   LabelAnnotation.set(['name']),
-  ViewAnnotation.set(true),
+  ViewAnnotation.set(['view']),
   Annotation.IconAnnotation.set({
     icon: 'ph--graph--regular',
     hue: 'green',

package/src/typings.d.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+declare module '*.css' {
+  const content: undefined;
+  export default content;
+}

package/src/util/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export * from './node-color';
+export * from './plot';

package/src/util/node-color.ts

@@ -0,0 +1,23 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { Obj } from '@dxos/echo';
+import { getHashHue } from '@dxos/ui-theme';
+
+/**
+ * Returns the SVG `fill` value for a node, derived from its typename via the
+ * same hue-hash used by the force-directed renderer. Resolves to a Tailwind
+ * color token CSS variable so the value reads consistently across themes.
+ *
+ * Used by every variant of `ExplorerArticle` so nodes are colored consistently
+ * regardless of which layout is rendering them.
+ */
+export const getNodeFillForTypename = (typename: string | undefined): string => {
+  return `var(--color-${getHashHue(typename)}-400)`;
+};
+
+/** Convenience: derive the fill from an ECHO object's typename. */
+export const getNodeFillForObject = (object: Obj.Unknown | undefined): string => {
+  return getNodeFillForTypename(object && Obj.getTypename(object));
+};

package/src/{components → util}/plot.ts

@@ -4,12 +4,24 @@
 
 import type { ChannelValueSpec } from '@observablehq/plot';
 
-export type Point = { x: number; y: number };
-export type GeoLocation = { lat: number; lng: number };
-
 export type Accessor<T> = (object: any) => T;
 
+export type Point = {
+  x: number;
+  y: number;
+};
+
+export type GeoLocation = {
+  lat: number;
+  lng: number;
+};
+
 export const createAdapter = <T extends Record<string, any>>(
   prop: string,
   accessor: Accessor<T> | undefined,
-): ChannelValueSpec => (accessor ? { transform: (values) => values.map((value) => accessor(value)[prop]) } : prop);
+): ChannelValueSpec =>
+  accessor
+    ? {
+        transform: (values) => values.map((value) => accessor(value)[prop]),
+      }
+    : prop;

package/dist/lib/browser/ExplorerContainer-H5RGY6AD.mjs

@@ -1,48 +0,0 @@
-import {
-  D3ForceGraph,
-  useGraphModel
-} from "./chunk-56VV76WZ.mjs";
-import "./chunk-J5LGTIGS.mjs";
-
-// src/containers/ExplorerContainer/ExplorerContainer.tsx
-import React, { useCallback, useMemo, useState } from "react";
-import { QueryBuilder } from "@dxos/echo-query";
-import { useGlobalSearch } from "@dxos/plugin-search";
-import { getSpace, useObject } from "@dxos/react-client/echo";
-import { Panel, Toolbar } from "@dxos/react-ui";
-import { QueryEditor } from "@dxos/react-ui-components";
-var ExplorerContainer = ({ role, subject: view }) => {
-  useObject(view);
-  const space = view && getSpace(view);
-  const [filter, setFilter] = useState();
-  const model = useGraphModel(space, filter);
-  const { match } = useGlobalSearch();
-  const builder = useMemo(() => new QueryBuilder(), []);
-  const handleChange = useCallback((value) => {
-    setFilter(builder.build(value).filter);
-  }, []);
-  const showToolbar = role === "article";
-  if (!space || !model) {
-    return null;
-  }
-  return /* @__PURE__ */ React.createElement(Panel.Root, {
-    role
-  }, showToolbar && /* @__PURE__ */ React.createElement(Panel.Toolbar, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement(Toolbar.Root, null, /* @__PURE__ */ React.createElement(QueryEditor, {
-    db: space.db,
-    onChange: handleChange
-  }))), /* @__PURE__ */ React.createElement(Panel.Content, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement(D3ForceGraph, {
-    model,
-    match
-  })));
-};
-
-// src/containers/ExplorerContainer/index.ts
-var ExplorerContainer_default = ExplorerContainer;
-export {
-  ExplorerContainer_default as default
-};
-//# sourceMappingURL=ExplorerContainer-H5RGY6AD.mjs.map

package/dist/lib/browser/ExplorerContainer-H5RGY6AD.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/containers/ExplorerContainer/ExplorerContainer.tsx", "../../../src/containers/ExplorerContainer/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { useCallback, useMemo, useState } from 'react';\n\nimport { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';\nimport { type Filter } from '@dxos/echo';\nimport { type View } from '@dxos/echo';\nimport { QueryBuilder } from '@dxos/echo-query';\nimport { useGlobalSearch } from '@dxos/plugin-search';\nimport { getSpace, useObject } from '@dxos/react-client/echo';\nimport { Panel, Toolbar } from '@dxos/react-ui';\nimport { QueryEditor, type QueryEditorProps } from '@dxos/react-ui-components';\n\nimport { D3ForceGraph } from '../../components';\nimport { useGraphModel } from '../../hooks';\n\nexport type ExplorerContainerProps = SurfaceComponentProps<View.View>;\n\nexport const ExplorerContainer = ({ role, subject: view }: ExplorerContainerProps) => {\n  useObject(view);\n  const space = view && getSpace(view);\n  const [filter, setFilter] = useState<Filter.Any>();\n  const model = useGraphModel(space, filter);\n  const { match } = useGlobalSearch();\n\n  const builder = useMemo(() => new QueryBuilder(), []);\n  const handleChange = useCallback<NonNullable<QueryEditorProps['onChange']>>((value) => {\n    setFilter(builder.build(value).filter);\n  }, []);\n\n  const showToolbar = role === 'article';\n\n  if (!space || !model) {\n    return null;\n  }\n\n  return (\n    <Panel.Root role={role}>\n      {showToolbar && (\n        <Panel.Toolbar asChild>\n          <Toolbar.Root>\n            <QueryEditor db={space.db} onChange={handleChange} />\n          </Toolbar.Root>\n        </Panel.Toolbar>\n      )}\n      <Panel.Content asChild>\n        <D3ForceGraph model={model} match={match} />\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { ExplorerContainer } from './ExplorerContainer';\n\nexport default ExplorerContainer;\n"],
-  "mappings": ";;;;;;;AAIA,OAAOA,SAASC,aAAaC,SAASC,gBAAgB;AAKtD,SAASC,oBAAoB;AAC7B,SAASC,uBAAuB;AAChC,SAASC,UAAUC,iBAAiB;AACpC,SAASC,OAAOC,eAAe;AAC/B,SAASC,mBAA0C;AAO5C,IAAMC,oBAAoB,CAAC,EAAEC,MAAMC,SAASC,KAAI,MAA0B;AAC/EC,YAAUD,IAAAA;AACV,QAAME,QAAQF,QAAQG,SAASH,IAAAA;AAC/B,QAAM,CAACI,QAAQC,SAAAA,IAAaC,SAAAA;AAC5B,QAAMC,QAAQC,cAAcN,OAAOE,MAAAA;AACnC,QAAM,EAAEK,MAAK,IAAKC,gBAAAA;AAElB,QAAMC,UAAUC,QAAQ,MAAM,IAAIC,aAAAA,GAAgB,CAAA,CAAE;AACpD,QAAMC,eAAeC,YAAuD,CAACC,UAAAA;AAC3EX,cAAUM,QAAQM,MAAMD,KAAAA,EAAOZ,MAAM;EACvC,GAAG,CAAA,CAAE;AAEL,QAAMc,cAAcpB,SAAS;AAE7B,MAAI,CAACI,SAAS,CAACK,OAAO;AACpB,WAAO;EACT;AAEA,SACE,sBAAA,cAACY,MAAMC,MAAI;IAACtB;KACToB,eACC,sBAAA,cAACC,MAAME,SAAO;IAACC,SAAAA;KACb,sBAAA,cAACD,QAAQD,MAAI,MACX,sBAAA,cAACG,aAAAA;IAAYC,IAAItB,MAAMsB;IAAIC,UAAUX;QAI3C,sBAAA,cAACK,MAAMO,SAAO;IAACJ,SAAAA;KACb,sBAAA,cAACK,cAAAA;IAAapB;IAAcE;;AAIpC;;;AC9CA,IAAA,4BAAemB;",
-  "names": ["React", "useCallback", "useMemo", "useState", "QueryBuilder", "useGlobalSearch", "getSpace", "useObject", "Panel", "Toolbar", "QueryEditor", "ExplorerContainer", "role", "subject", "view", "useObject", "space", "getSpace", "filter", "setFilter", "useState", "model", "useGraphModel", "match", "useGlobalSearch", "builder", "useMemo", "QueryBuilder", "handleChange", "useCallback", "value", "build", "showToolbar", "Panel", "Root", "Toolbar", "asChild", "QueryEditor", "db", "onChange", "Content", "D3ForceGraph", "ExplorerContainer"]
-}