@dxos/plugin-explorer 0.8.4-main.74a063c4e0 → 0.8.4-main.765dc60934

package/dist/types/src/components/Tree/types/types.d.ts

@@ -1,8 +1,18 @@
-import { type GraphModel } from '@dxos/graph';
-export type TreeNode = {
+import { type Key } from '@dxos/echo';
+import { type TreeType } from './tree';
+/**
+ * In-memory tree shape used by the d3 layouts.
+ * `data` carries through to layout callbacks (e.g. hover/inspect) — typically an ECHO object on leaves.
+ */
+export type TreeNode<TData = unknown> = {
     id: string;
     label?: string;
-    children?: TreeNode[];
+    data?: TData;
+    children?: TreeNode<TData>[];
 };
-export declare const mapGraphToTreeData: (model: GraphModel.GraphModel, maxDepth?: number) => TreeNode | undefined;
+/**
+ * Convert an ECHO `TreeType` (id-keyed node map) into a nested `TreeNode` hierarchy.
+ * Returns `undefined` if the root id is missing — the tree is then incomplete and shouldn't render.
+ */
+export declare const treeTypeToTreeNode: (tree: TreeType, rootId?: Key.ObjectId, visited?: Set<string>) => TreeNode | undefined;
 //# sourceMappingURL=types.d.ts.map

package/dist/types/src/components/Tree/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Tree/types/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,CAAC,UAAU,EAAE,iBAAY,KAAG,QAAQ,GAAG,SA4B1F,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Tree/types/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,KAAK,GAAG,OAAO,IAAI;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,SACvB,QAAQ,WACN,GAAG,CAAC,QAAQ,YACX,GAAG,CAAC,MAAM,CAAC,KACnB,QAAQ,GAAG,SAkBb,CAAC"}

package/dist/types/src/components/plot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../../../../src/components/plot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7C,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;AAE7C,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,MAAM,MAAM,EACZ,UAAU,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,KAChC,gBAA+G,CAAC"}
+{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../../../../src/components/plot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7C,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;AAE7C,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QACnD,MAAM,YACF,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,KAChC,gBAA+G,CAAC"}

package/dist/types/src/containers/ExplorerArticle/ExplorerArticle.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { type AppSurface } from '@dxos/app-toolkit/ui';
+import { type View } from '@dxos/echo';
+/** Visualization variants exposed by `ExplorerArticle`. */
+export type ExplorerArticleVariant = 'force' | 'cluster' | 'bundle';
+export type ExplorerArticleProps = AppSurface.ObjectArticleProps<View.View>;
+export declare const ExplorerArticle: ({ role, subject, variant }: ExplorerArticleProps) => React.JSX.Element | null;
+//# sourceMappingURL=ExplorerArticle.d.ts.map

package/dist/types/src/containers/ExplorerArticle/ExplorerArticle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplorerArticle.d.ts","sourceRoot":"","sources":["../../../../../src/containers/ExplorerArticle/ExplorerArticle.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAEzE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAoB,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAUzD,2DAA2D;AAC3D,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAoBpE,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE5E,eAAO,MAAM,eAAe,+BAAgC,oBAAoB,6BA0E/E,CAAC"}

package/dist/types/src/containers/ExplorerArticle/ExplorerArticle.stories.d.ts

@@ -0,0 +1,24 @@
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import { type ExplorerArticleVariant } from './ExplorerArticle';
+type StoryArgs = {
+    variant: ExplorerArticleVariant;
+};
+declare const meta: Meta<StoryArgs>;
+export default meta;
+type Story = StoryObj<StoryArgs>;
+/**
+ * Default force-directed view (the production layout).
+ */
+export declare const Force: Story;
+/**
+ * Radial cluster: every object on the perimeter, grouped by its schema, all under
+ * a single database root. Inspired by https://observablehq.com/@d3/radial-cluster.
+ */
+export declare const Cluster: Story;
+/**
+ * Hierarchical edge bundling: same hierarchy as `cluster`, with bundled curves
+ * routed through the lowest common ancestor for every relation / ref in the space.
+ * Inspired by https://observablehq.com/@d3/hierarchical-edge-bundling.
+ */
+export declare const Bundle: Story;
+//# sourceMappingURL=ExplorerArticle.stories.d.ts.map

package/dist/types/src/containers/ExplorerArticle/ExplorerArticle.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplorerArticle.stories.d.ts","sourceRoot":"","sources":["../../../../../src/containers/ExplorerArticle/ExplorerArticle.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAkBjE,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAMjF,KAAK,SAAS,GAAG;IAAE,OAAO,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAYrD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,SAAS,CA4CzB,CAAC;eAEa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,KAInB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,KAIpB,CAAC"}

package/dist/types/src/containers/ExplorerArticle/index.d.ts

@@ -0,0 +1,2 @@
+export { ExplorerArticle as default } from './ExplorerArticle';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/containers/ExplorerArticle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/containers/ExplorerArticle/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/src/containers/index.d.ts

@@ -1,3 +1,3 @@
 import { type ComponentType } from 'react';
-export declare const ExplorerContainer: ComponentType<any>;
+export declare const ExplorerArticle: ComponentType<any>;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/containers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/containers/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAQ,MAAM,OAAO,CAAC;AAEjD,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/containers/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAQ,MAAM,OAAO,CAAC;AAEjD,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,GAAG,CAA2C,CAAC"}

package/dist/types/src/hooks/useGraphModel.d.ts

@@ -1,4 +1,4 @@
-import { type Filter, type Queue, type Space } from '@dxos/client/echo';
+import { type Database, type Entity, type Filter } from '@dxos/echo';
 import { SpaceGraphModel, type SpaceGraphModelOptions } from '@dxos/schema';
-export declare const useGraphModel: (space: Space | undefined, filter?: Filter.Any | undefined, options?: SpaceGraphModelOptions, queue?: Queue) => SpaceGraphModel | undefined;
+export declare const useGraphModel: (db: Database.Database | undefined, filter?: Filter.Any | undefined, options?: SpaceGraphModelOptions, items?: readonly Entity.Unknown[]) => SpaceGraphModel | undefined;
 //# sourceMappingURL=useGraphModel.d.ts.map

package/dist/types/src/hooks/useGraphModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGraphModel.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGraphModel.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG5E,eAAO,MAAM,aAAa,GACxB,OAAO,KAAK,GAAG,SAAS,EACxB,SAAS,MAAM,CAAC,GAAG,GAAG,SAAS,EAC/B,UAAU,sBAAsB,EAChC,QAAQ,KAAK,KACZ,eAAe,GAAG,SAyBpB,CAAC"}
+{"version":3,"file":"useGraphModel.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGraphModel.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG5E,eAAO,MAAM,aAAa,OACpB,QAAQ,CAAC,QAAQ,GAAG,SAAS,WACxB,MAAM,CAAC,GAAG,GAAG,SAAS,YACrB,sBAAsB,UACxB,SAAS,MAAM,CAAC,OAAO,EAAE,KAChC,eAAe,GAAG,SA6BpB,CAAC"}

package/dist/types/src/index.d.ts

@@ -1,5 +1,3 @@
-export * from './components';
-export * from './hooks';
 export * from './meta';
-export * from './ExplorerPlugin';
+export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AAEvB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/types/src/plugin.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from '@dxos/app-framework';
+export declare const ExplorerPlugin: Plugin.PluginFactory<void>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/src/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI7C,eAAO,MAAM,cAAc,4BAA6C,CAAC"}

package/dist/types/src/testing.d.ts

@@ -0,0 +1,2 @@
+export * from './ExplorerPlugin';
+//# sourceMappingURL=testing.d.ts.map

package/dist/types/src/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAMA,cAAc,kBAAkB,CAAC"}

package/dist/types/src/translations.d.ts

@@ -1,20 +1,18 @@
 export declare const translations: [{
     readonly 'en-US': {
         readonly [x: string]: {
-            readonly 'typename.label': "Explorer";
-            readonly 'typename.label_zero': "Explorers";
-            readonly 'typename.label_one': "Explorer";
-            readonly 'typename.label_other': "Explorers";
-            readonly 'object-name.placeholder': "New explorer";
-            readonly 'add-object.label': "Add explorer";
-            readonly 'rename-object.label': "Rename explorer";
-            readonly 'delete-object.label': "Delete explorer";
-            readonly 'object-deleted.label': "Explorer deleted";
+            readonly 'typename.label': 'Explorer';
+            readonly 'typename.label_zero': 'Explorers';
+            readonly 'typename.label_one': 'Explorer';
+            readonly 'typename.label_other': 'Explorers';
+            readonly 'object-name.placeholder': 'New explorer';
+            readonly 'add-object.label': 'Add explorer';
+            readonly 'rename-object.label': 'Rename explorer';
+            readonly 'delete-object.label': 'Delete explorer';
+            readonly 'object-deleted.label': 'Explorer deleted';
             readonly 'plugin.name'?: undefined;
             readonly 'object-title.label'?: undefined;
         } | {
-            readonly 'plugin.name': "Explorer";
-            readonly 'object-title.label': "Title";
             readonly 'typename.label'?: undefined;
             readonly 'typename.label_zero'?: undefined;
             readonly 'typename.label_one'?: undefined;
@@ -24,17 +22,19 @@ export declare const translations: [{
             readonly 'rename-object.label'?: undefined;
             readonly 'delete-object.label'?: undefined;
             readonly 'object-deleted.label'?: undefined;
+            readonly 'plugin.name': 'Explorer';
+            readonly 'object-title.label': 'Title';
         };
     };
 }, {
     readonly 'en-US': {
         readonly "@dxos/react-ui-components": {
-            readonly "no-commits.message": "No events yet";
-            readonly "query-editor.placeholder": "Enter query (e.g., \"#tag\", \"type\")";
-            readonly "picker-select.label": "Select";
-            readonly "picker-none.label": "None";
-            readonly "picker-type.placeholder": "Type";
-            readonly "picker-tag.placeholder": "Tag";
+            readonly 'no-commits.message': 'No events yet';
+            readonly 'query-editor.placeholder': 'Enter query (e.g., "#tag", "type")';
+            readonly 'picker-select.label': 'Select';
+            readonly 'picker-none.label': 'None';
+            readonly 'picker-type.placeholder': 'Type';
+            readonly 'picker-tag.placeholder': 'Tag';
         };
     };
 }];

package/dist/types/src/translations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBM,CAAC"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,YAAY;;;uCAIC,UAAU;4CACL,WAAW;2CACZ,UAAU;6CACR,WAAW;gDACR,cAAc;yCACrB,cAAc;4CACX,iBAAiB;4CACjB,iBAAiB;6CAChB,kBAAkB;;;;;;;;;;;;;oCAG3B,UAAU;2CACH,OAAO;;;;;;;;;;;;;;EAKN,CAAC"}

package/dist/types/src/types/Graph.d.ts

@@ -1,13 +1,12 @@
 import * as Schema from 'effect/Schema';
-import { Obj, QueryAST, Type } from '@dxos/echo';
-import { View } from '@dxos/echo';
+import { Obj, QueryAST, Type, View } from '@dxos/echo';
 declare const GraphSchema: Type.Obj<{
+    readonly name?: string | undefined;
     readonly view: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & View.View>;
     readonly query: {
-        readonly ast: QueryAST.QuerySelectClause | QueryAST.QueryFilterClause | QueryAST.QueryReferenceTraversalClause | QueryAST.QueryIncomingReferencesClause | QueryAST.QueryRelationClause | QueryAST.QueryRelationTraversalClause | QueryAST.QueryHierarchyTraversalClause | QueryAST.QueryUnionClause | QueryAST.QuerySetDifferenceClause | QueryAST.QueryOrderClause | QueryAST.QueryOptionsClause | QueryAST.QueryLimitClause | QueryAST.QueryFromClause;
         readonly raw?: string | undefined;
+        readonly ast: QueryAST.QueryFilterClause | QueryAST.QueryFromClause | QueryAST.QueryHierarchyTraversalClause | QueryAST.QueryIncomingReferencesClause | QueryAST.QueryLimitClause | QueryAST.QueryOptionsClause | QueryAST.QueryOrderClause | QueryAST.QueryReferenceTraversalClause | QueryAST.QueryRelationClause | QueryAST.QueryRelationTraversalClause | QueryAST.QuerySelectClause | QueryAST.QuerySetDifferenceClause | QueryAST.QueryUnionClause;
     };
-    readonly name?: string | undefined;
 }, Schema.Struct.Fields>;
 export interface Graph extends Schema.Schema.Type<typeof GraphSchema> {
 }

package/dist/types/src/types/Graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Graph.d.ts","sourceRoot":"","sources":["../../../../src/types/Graph.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAsB,GAAG,EAAS,QAAQ,EAAO,IAAI,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIlC,QAAA,MAAM,WAAW;;;;;;;wBAoBhB,CAAC;AACF,MAAM,WAAW,KAAM,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC;CAAG;AACxE,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAsB,CAAC;AAEzD,KAAK,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IACpE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,wBAIlB,SAAS,KAAG,KAEd,CAAC"}
+{"version":3,"file":"Graph.d.ts","sourceRoot":"","sources":["../../../../src/types/Graph.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAsB,GAAG,EAAS,QAAQ,EAAO,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvF,QAAA,MAAM,WAAW;;;;;;;wBAoBhB,CAAC;AACF,MAAM,WAAW,KAAM,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC;CAAG;AACxE,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAsB,CAAC;AAEzD,KAAK,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IACpE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,2BAId,SAAS,KAAG,KAEd,CAAC"}