@dxos/plugin-explorer 0.9.0 → 0.9.1-staging.ee54ba693a

package/dist/lib/neutral/ExplorerArticle-2WPXYTXV.mjs

@@ -0,0 +1,101 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/containers/ExplorerArticle/ExplorerArticle.tsx
+import React, { useCallback, useEffect, useMemo, useState } from "react";
+import { AppSurface } from "@dxos/app-toolkit/ui";
+import { Obj } from "@dxos/echo";
+import { QueryBuilder } from "@dxos/echo-query";
+import { useObject } from "@dxos/react-client/echo";
+import { DxAnchorActivate, Icon, Panel, Toolbar } from "@dxos/react-ui";
+import { QueryEditor } from "@dxos/react-ui-components";
+import "@dxos/react-ui-graph/styles/graph.css";
+import { VARIANTS, Visualization, isVariant } from "#components";
+import { useGraphModel } from "#hooks";
+var ExplorerArticle = ({ role, subject, variant }) => {
+  const [view] = useObject(subject);
+  const [filter, setFilter] = useState();
+  const db = view && Obj.getDatabase(view);
+  const model = useGraphModel(db, filter);
+  const builder = useMemo(() => new QueryBuilder(), []);
+  const handleChange = useCallback((value) => {
+    setFilter(builder.build(value).filter);
+  }, [
+    builder
+  ]);
+  const [selected, setSelected] = useState(isVariant(variant) ? variant : "force");
+  useEffect(() => {
+    if (isVariant(variant)) {
+      setSelected(variant);
+    }
+  }, [
+    variant
+  ]);
+  const handleVariantChange = useCallback((value) => {
+    if (isVariant(value)) {
+      setSelected(value);
+    }
+  }, []);
+  const handleDismiss = useCallback(() => {
+    document.defaultView?.dispatchEvent(new DxAnchorActivate({
+      dxn: "",
+      label: "",
+      trigger: document.body,
+      state: false
+    }));
+  }, []);
+  const handleHover = useCallback((node, event) => {
+    if (!node || !event) {
+      return;
+    }
+    const obj = node.data;
+    if (!obj || !Obj.isObject(obj)) {
+      return;
+    }
+    const dxn = Obj.getURI(obj);
+    if (!dxn) {
+      return;
+    }
+    const target = event.target;
+    target.dispatchEvent(new DxAnchorActivate({
+      dxn,
+      kind: "card",
+      trigger: target,
+      label: Obj.getLabel(obj) ?? dxn
+    }));
+  }, []);
+  const showToolbar = role === AppSurface.Article.role;
+  if (!db || !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,
+    onChange: handleChange
+  }), /* @__PURE__ */ React.createElement(Toolbar.ToggleGroup, {
+    type: "single",
+    value: selected,
+    onValueChange: handleVariantChange
+  }, VARIANTS.map(({ value, icon, label }) => /* @__PURE__ */ React.createElement(Toolbar.ToggleGroupItem, {
+    key: value,
+    value,
+    "aria-label": label,
+    title: label
+  }, /* @__PURE__ */ React.createElement(Icon, {
+    icon,
+    size: 4
+  })))))), /* @__PURE__ */ React.createElement(Panel.Content, null, /* @__PURE__ */ React.createElement(Visualization.Root, {
+    classNames: "bg-base-surface",
+    variant: selected,
+    model,
+    onSurfaceClick: handleDismiss
+  }, /* @__PURE__ */ React.createElement(Visualization.Graph, {
+    onNodeHover: handleHover
+  }))));
+};
+export {
+  ExplorerArticle as default
+};
+//# sourceMappingURL=ExplorerArticle-2WPXYTXV.mjs.map

package/dist/lib/neutral/ExplorerArticle-2WPXYTXV.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/containers/ExplorerArticle/ExplorerArticle.tsx"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { useCallback, useEffect, useMemo, useState } from 'react';\n\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { type Filter, Obj, type View } from '@dxos/echo';\nimport { QueryBuilder } from '@dxos/echo-query';\nimport { useObject } from '@dxos/react-client/echo';\nimport { DxAnchorActivate, Icon, Panel, Toolbar } from '@dxos/react-ui';\nimport { QueryEditor, type QueryEditorProps } from '@dxos/react-ui-components';\nimport { type TreeNode } from '@dxos/react-ui-graph';\nimport '@dxos/react-ui-graph/styles/graph.css';\n\nimport { type ExplorerArticleVariant, VARIANTS, Visualization, isVariant } from '#components';\nimport { useGraphModel } from '#hooks';\n\nexport type { ExplorerArticleVariant } from '#components';\n\nexport type ExplorerArticleProps = AppSurface.ObjectArticleProps<View.View>;\n\nexport const ExplorerArticle = ({ role, subject, variant }: ExplorerArticleProps) => {\n  const [view] = useObject(subject);\n  const [filter, setFilter] = useState<Filter.Any>();\n\n  const db = view && Obj.getDatabase(view);\n  const model = useGraphModel(db, filter);\n\n  const builder = useMemo(() => new QueryBuilder(), []);\n  const handleChange = useCallback<NonNullable<QueryEditorProps['onChange']>>(\n    (value) => {\n      setFilter(builder.build(value).filter);\n    },\n    [builder],\n  );\n\n  const [selected, setSelected] = useState<ExplorerArticleVariant>(isVariant(variant) ? variant : 'force');\n  useEffect(() => {\n    if (isVariant(variant)) {\n      setSelected(variant);\n    }\n  }, [variant]);\n\n  const handleVariantChange = useCallback((value: string) => {\n    if (isVariant(value)) {\n      setSelected(value);\n    }\n  }, []);\n\n  // Dismiss the preview popover. The dxn/label/trigger fields are placeholders ignored on\n  // `state: false`.\n  const handleDismiss = useCallback(() => {\n    document.defaultView?.dispatchEvent(\n      new DxAnchorActivate({ dxn: '', label: '', trigger: document.body, state: false }),\n    );\n  }, []);\n\n  const handleHover = useCallback((node: TreeNode | null, event?: MouseEvent) => {\n    // Pointer left the node/label: keep the popover open so it can be hovered/interacted with.\n    // The popover is dismissed only on an explicit click on the component surface (handleDismiss).\n    if (!node || !event) {\n      return;\n    }\n    const obj = node.data;\n    if (!obj || !Obj.isObject(obj)) {\n      return;\n    }\n    const dxn = Obj.getURI(obj);\n    if (!dxn) {\n      return;\n    }\n\n    const target = event.target as HTMLElement;\n    target.dispatchEvent(\n      new DxAnchorActivate({\n        dxn,\n        kind: 'card',\n        trigger: target,\n        label: Obj.getLabel(obj) ?? dxn,\n      }),\n    );\n  }, []);\n\n  const showToolbar = role === AppSurface.Article.role;\n\n  if (!db || !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={db} onChange={handleChange} />\n            <Toolbar.ToggleGroup type='single' value={selected} onValueChange={handleVariantChange}>\n              {VARIANTS.map(({ value, icon, label }) => (\n                <Toolbar.ToggleGroupItem key={value} value={value} aria-label={label} title={label}>\n                  <Icon icon={icon} size={4} />\n                </Toolbar.ToggleGroupItem>\n              ))}\n            </Toolbar.ToggleGroup>\n          </Toolbar.Root>\n        </Panel.Toolbar>\n      )}\n      <Panel.Content>\n        <Visualization.Root\n          classNames='bg-base-surface'\n          variant={selected}\n          model={model}\n          onSurfaceClick={handleDismiss}\n        >\n          <Visualization.Graph onNodeHover={handleHover} />\n        </Visualization.Root>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n"],
+  "mappings": ";;;AAIA,OAAOA,SAASC,aAAaC,WAAWC,SAASC,gBAAgB;AAEjE,SAASC,kBAAkB;AAC3B,SAAsBC,WAAsB;AAC5C,SAASC,oBAAoB;AAC7B,SAASC,iBAAiB;AAC1B,SAASC,kBAAkBC,MAAMC,OAAOC,eAAe;AACvD,SAASC,mBAA0C;AAEnD,OAAO;AAEP,SAAsCC,UAAUC,eAAeC,iBAAiB;AAChF,SAASC,qBAAqB;AAMvB,IAAMC,kBAAkB,CAAC,EAAEC,MAAMC,SAASC,QAAO,MAAwB;AAC9E,QAAM,CAACC,IAAAA,IAAQd,UAAUY,OAAAA;AACzB,QAAM,CAACG,QAAQC,SAAAA,IAAapB,SAAAA;AAE5B,QAAMqB,KAAKH,QAAQhB,IAAIoB,YAAYJ,IAAAA;AACnC,QAAMK,QAAQV,cAAcQ,IAAIF,MAAAA;AAEhC,QAAMK,UAAUzB,QAAQ,MAAM,IAAII,aAAAA,GAAgB,CAAA,CAAE;AACpD,QAAMsB,eAAe5B,YACnB,CAAC6B,UAAAA;AACCN,cAAUI,QAAQG,MAAMD,KAAAA,EAAOP,MAAM;EACvC,GACA;IAACK;GAAQ;AAGX,QAAM,CAACI,UAAUC,WAAAA,IAAe7B,SAAiCY,UAAUK,OAAAA,IAAWA,UAAU,OAAA;AAChGnB,YAAU,MAAA;AACR,QAAIc,UAAUK,OAAAA,GAAU;AACtBY,kBAAYZ,OAAAA;IACd;EACF,GAAG;IAACA;GAAQ;AAEZ,QAAMa,sBAAsBjC,YAAY,CAAC6B,UAAAA;AACvC,QAAId,UAAUc,KAAAA,GAAQ;AACpBG,kBAAYH,KAAAA;IACd;EACF,GAAG,CAAA,CAAE;AAIL,QAAMK,gBAAgBlC,YAAY,MAAA;AAChCmC,aAASC,aAAaC,cACpB,IAAI7B,iBAAiB;MAAE8B,KAAK;MAAIC,OAAO;MAAIC,SAASL,SAASM;MAAMC,OAAO;IAAM,CAAA,CAAA;EAEpF,GAAG,CAAA,CAAE;AAEL,QAAMC,cAAc3C,YAAY,CAAC4C,MAAuBC,UAAAA;AAGtD,QAAI,CAACD,QAAQ,CAACC,OAAO;AACnB;IACF;AACA,UAAMC,MAAMF,KAAKG;AACjB,QAAI,CAACD,OAAO,CAACzC,IAAI2C,SAASF,GAAAA,GAAM;AAC9B;IACF;AACA,UAAMR,MAAMjC,IAAI4C,OAAOH,GAAAA;AACvB,QAAI,CAACR,KAAK;AACR;IACF;AAEA,UAAMY,SAASL,MAAMK;AACrBA,WAAOb,cACL,IAAI7B,iBAAiB;MACnB8B;MACAa,MAAM;MACNX,SAASU;MACTX,OAAOlC,IAAI+C,SAASN,GAAAA,KAAQR;IAC9B,CAAA,CAAA;EAEJ,GAAG,CAAA,CAAE;AAEL,QAAMe,cAAcnC,SAASd,WAAWkD,QAAQpC;AAEhD,MAAI,CAACM,MAAM,CAACE,OAAO;AACjB,WAAO;EACT;AAEA,SACE,sBAAA,cAAChB,MAAM6C,MAAI;IAACrC;KACTmC,eACC,sBAAA,cAAC3C,MAAMC,SAAO;IAAC6C,SAAAA;KACb,sBAAA,cAAC7C,QAAQ4C,MAAI,MACX,sBAAA,cAAC3C,aAAAA;IAAYY;IAAQiC,UAAU7B;MAC/B,sBAAA,cAACjB,QAAQ+C,aAAW;IAACC,MAAK;IAAS9B,OAAOE;IAAU6B,eAAe3B;KAChEpB,SAASgD,IAAI,CAAC,EAAEhC,OAAOiC,MAAMvB,MAAK,MACjC,sBAAA,cAAC5B,QAAQoD,iBAAe;IAACC,KAAKnC;IAAOA;IAAcoC,cAAY1B;IAAO2B,OAAO3B;KAC3E,sBAAA,cAAC9B,MAAAA;IAAKqD;IAAYK,MAAM;WAOpC,sBAAA,cAACzD,MAAM0D,SAAO,MACZ,sBAAA,cAACtD,cAAcyC,MAAI;IACjBc,YAAW;IACXjD,SAASW;IACTL;IACA4C,gBAAgBpC;KAEhB,sBAAA,cAACpB,cAAcyD,OAAK;IAACC,aAAa7B;;AAK5C;",
+  "names": ["React", "useCallback", "useEffect", "useMemo", "useState", "AppSurface", "Obj", "QueryBuilder", "useObject", "DxAnchorActivate", "Icon", "Panel", "Toolbar", "QueryEditor", "VARIANTS", "Visualization", "isVariant", "useGraphModel", "ExplorerArticle", "role", "subject", "variant", "view", "filter", "setFilter", "db", "getDatabase", "model", "builder", "handleChange", "value", "build", "selected", "setSelected", "handleVariantChange", "handleDismiss", "document", "defaultView", "dispatchEvent", "dxn", "label", "trigger", "body", "state", "handleHover", "node", "event", "obj", "data", "isObject", "getURI", "target", "kind", "getLabel", "showToolbar", "Article", "Root", "asChild", "onChange", "ToggleGroup", "type", "onValueChange", "map", "icon", "ToggleGroupItem", "key", "aria-label", "title", "size", "Content", "classNames", "onSurfaceClick", "Graph", "onNodeHover"]
+}

package/dist/lib/neutral/ExplorerPlugin.mjs

@@ -1,7 +1,7 @@
 import {
   ExplorerPlugin,
   ExplorerPlugin_default
-} from "./chunk-3D7BYXOR.mjs";
+} from "./chunk-4F6AT7RA.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
   ExplorerPlugin,

package/dist/lib/neutral/NeighborhoodCompanion-WC6E3YE6.mjs

@@ -0,0 +1,90 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/containers/NeighborhoodCompanion/NeighborhoodCompanion.tsx
+import React, { useCallback, useState } from "react";
+import { Obj } from "@dxos/echo";
+import { DxAnchorActivate, Panel, Toolbar, useTranslation } from "@dxos/react-ui";
+import "@dxos/react-ui-graph/styles/graph.css";
+import { Visualization } from "#components";
+import { DEFAULT_NEIGHBORHOOD_DEPTH, useNeighborhoodModel } from "#hooks";
+import { meta } from "#meta";
+var DEPTHS = [
+  1,
+  2,
+  3
+];
+var NeighborhoodCompanion = ({ role = "article", subject }) => {
+  const { t } = useTranslation(meta.profile.key);
+  const [depth, setDepth] = useState(DEFAULT_NEIGHBORHOOD_DEPTH);
+  const model = useNeighborhoodModel(subject, depth);
+  const handleDepthChange = useCallback((value) => {
+    const next = Number.parseInt(value, 10);
+    if (Number.isFinite(next)) {
+      setDepth(next);
+    }
+  }, []);
+  const handleDismiss = useCallback(() => {
+    document.defaultView?.dispatchEvent(new DxAnchorActivate({
+      dxn: "",
+      label: "",
+      trigger: document.body,
+      state: false
+    }));
+  }, []);
+  const handleHover = useCallback((node, event) => {
+    if (!node || !event) {
+      return;
+    }
+    const obj = node.data;
+    if (!obj || !Obj.isObject(obj)) {
+      return;
+    }
+    const dxn = Obj.getURI(obj);
+    if (!dxn) {
+      return;
+    }
+    const target = event.target;
+    target.dispatchEvent(new DxAnchorActivate({
+      dxn,
+      kind: "card",
+      trigger: target,
+      label: Obj.getLabel(obj) ?? dxn
+    }));
+  }, []);
+  if (!subject || !model) {
+    return null;
+  }
+  return /* @__PURE__ */ React.createElement(Panel.Root, {
+    role
+  }, /* @__PURE__ */ React.createElement(Panel.Toolbar, {
+    asChild: true
+  }, /* @__PURE__ */ React.createElement(Toolbar.Root, null, /* @__PURE__ */ React.createElement("div", {
+    role: "none",
+    className: "grow"
+  }), /* @__PURE__ */ React.createElement(Toolbar.ToggleGroup, {
+    type: "single",
+    value: String(depth),
+    onValueChange: handleDepthChange
+  }, DEPTHS.map((value) => /* @__PURE__ */ React.createElement(Toolbar.ToggleGroupItem, {
+    key: value,
+    value: String(value),
+    "aria-label": t("depth.label", {
+      count: value
+    }),
+    title: t("depth.label", {
+      count: value
+    })
+  }, value))))), /* @__PURE__ */ React.createElement(Panel.Content, null, /* @__PURE__ */ React.createElement(Visualization.Root, {
+    classNames: "bg-base-surface",
+    model,
+    variant: "neighborhood",
+    focus: subject.id,
+    onSurfaceClick: handleDismiss
+  }, /* @__PURE__ */ React.createElement(Visualization.Graph, {
+    onNodeHover: handleHover
+  }))));
+};
+export {
+  NeighborhoodCompanion as default
+};
+//# sourceMappingURL=NeighborhoodCompanion-WC6E3YE6.mjs.map

package/dist/lib/neutral/NeighborhoodCompanion-WC6E3YE6.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/containers/NeighborhoodCompanion/NeighborhoodCompanion.tsx"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useState } from 'react';\n\nimport { Obj } from '@dxos/echo';\nimport { DxAnchorActivate, Panel, Toolbar, useTranslation } from '@dxos/react-ui';\nimport { type TreeNode } from '@dxos/react-ui-graph';\nimport '@dxos/react-ui-graph/styles/graph.css';\n\nimport { Visualization } from '#components';\nimport { DEFAULT_NEIGHBORHOOD_DEPTH, useNeighborhoodModel } from '#hooks';\nimport { meta } from '#meta';\n\n/** Selectable traversal depths offered in the companion toolbar. */\nconst DEPTHS = [1, 2, 3] as const;\n\nexport type NeighborhoodCompanionProps = {\n  role?: string;\n  /** The active node whose neighbourhood is rendered (passed as the companion subject). */\n  subject: Obj.Any;\n};\n\n/**\n * Companion that renders the n-hop neighbourhood of the active node as an ego-centric radial graph,\n * with the active node at the centre. Depth (number of hops traversed) is adjustable in the toolbar.\n */\nexport const NeighborhoodCompanion = ({ role = 'article', subject }: NeighborhoodCompanionProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const [depth, setDepth] = useState<number>(DEFAULT_NEIGHBORHOOD_DEPTH);\n  const model = useNeighborhoodModel(subject, depth);\n\n  const handleDepthChange = useCallback((value: string) => {\n    const next = Number.parseInt(value, 10);\n    if (Number.isFinite(next)) {\n      setDepth(next);\n    }\n  }, []);\n\n  // Dismiss the preview popover. The dxn/label/trigger fields are placeholders ignored on `state: false`.\n  const handleDismiss = useCallback(() => {\n    document.defaultView?.dispatchEvent(\n      new DxAnchorActivate({ dxn: '', label: '', trigger: document.body, state: false }),\n    );\n  }, []);\n\n  const handleHover = useCallback((node: TreeNode | null, event?: MouseEvent) => {\n    // Pointer left the node/label: keep the popover open so it can be hovered/interacted with.\n    if (!node || !event) {\n      return;\n    }\n    const obj = node.data;\n    if (!obj || !Obj.isObject(obj)) {\n      return;\n    }\n    const dxn = Obj.getURI(obj);\n    if (!dxn) {\n      return;\n    }\n\n    const target = event.target as HTMLElement;\n    target.dispatchEvent(new DxAnchorActivate({ dxn, kind: 'card', trigger: target, label: Obj.getLabel(obj) ?? dxn }));\n  }, []);\n\n  if (!subject || !model) {\n    return null;\n  }\n\n  return (\n    <Panel.Root role={role}>\n      <Panel.Toolbar asChild>\n        <Toolbar.Root>\n          <div role='none' className='grow' />\n          <Toolbar.ToggleGroup type='single' value={String(depth)} onValueChange={handleDepthChange}>\n            {DEPTHS.map((value) => (\n              <Toolbar.ToggleGroupItem\n                key={value}\n                value={String(value)}\n                aria-label={t('depth.label', { count: value })}\n                title={t('depth.label', { count: value })}\n              >\n                {value}\n              </Toolbar.ToggleGroupItem>\n            ))}\n          </Toolbar.ToggleGroup>\n        </Toolbar.Root>\n      </Panel.Toolbar>\n      <Panel.Content>\n        <Visualization.Root\n          classNames='bg-base-surface'\n          model={model}\n          variant='neighborhood'\n          focus={subject.id}\n          onSurfaceClick={handleDismiss}\n        >\n          <Visualization.Graph onNodeHover={handleHover} />\n        </Visualization.Root>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n"],
+  "mappings": ";;;AAIA,OAAOA,SAASC,aAAaC,gBAAgB;AAE7C,SAASC,WAAW;AACpB,SAASC,kBAAkBC,OAAOC,SAASC,sBAAsB;AAEjE,OAAO;AAEP,SAASC,qBAAqB;AAC9B,SAASC,4BAA4BC,4BAA4B;AACjE,SAASC,YAAY;AAGrB,IAAMC,SAAS;EAAC;EAAG;EAAG;;AAYf,IAAMC,wBAAwB,CAAC,EAAEC,OAAO,WAAWC,QAAO,MAA8B;AAC7F,QAAM,EAAEC,EAAC,IAAKT,eAAeI,KAAKM,QAAQC,GAAG;AAC7C,QAAM,CAACC,OAAOC,QAAAA,IAAYlB,SAAiBO,0BAAAA;AAC3C,QAAMY,QAAQX,qBAAqBK,SAASI,KAAAA;AAE5C,QAAMG,oBAAoBrB,YAAY,CAACsB,UAAAA;AACrC,UAAMC,OAAOC,OAAOC,SAASH,OAAO,EAAA;AACpC,QAAIE,OAAOE,SAASH,IAAAA,GAAO;AACzBJ,eAASI,IAAAA;IACX;EACF,GAAG,CAAA,CAAE;AAGL,QAAMI,gBAAgB3B,YAAY,MAAA;AAChC4B,aAASC,aAAaC,cACpB,IAAI3B,iBAAiB;MAAE4B,KAAK;MAAIC,OAAO;MAAIC,SAASL,SAASM;MAAMC,OAAO;IAAM,CAAA,CAAA;EAEpF,GAAG,CAAA,CAAE;AAEL,QAAMC,cAAcpC,YAAY,CAACqC,MAAuBC,UAAAA;AAEtD,QAAI,CAACD,QAAQ,CAACC,OAAO;AACnB;IACF;AACA,UAAMC,MAAMF,KAAKG;AACjB,QAAI,CAACD,OAAO,CAACrC,IAAIuC,SAASF,GAAAA,GAAM;AAC9B;IACF;AACA,UAAMR,MAAM7B,IAAIwC,OAAOH,GAAAA;AACvB,QAAI,CAACR,KAAK;AACR;IACF;AAEA,UAAMY,SAASL,MAAMK;AACrBA,WAAOb,cAAc,IAAI3B,iBAAiB;MAAE4B;MAAKa,MAAM;MAAQX,SAASU;MAAQX,OAAO9B,IAAI2C,SAASN,GAAAA,KAAQR;IAAI,CAAA,CAAA;EAClH,GAAG,CAAA,CAAE;AAEL,MAAI,CAACjB,WAAW,CAACM,OAAO;AACtB,WAAO;EACT;AAEA,SACE,sBAAA,cAAChB,MAAM0C,MAAI;IAACjC;KACV,sBAAA,cAACT,MAAMC,SAAO;IAAC0C,SAAAA;KACb,sBAAA,cAAC1C,QAAQyC,MAAI,MACX,sBAAA,cAACE,OAAAA;IAAInC,MAAK;IAAOoC,WAAU;MAC3B,sBAAA,cAAC5C,QAAQ6C,aAAW;IAACC,MAAK;IAAS7B,OAAO8B,OAAOlC,KAAAA;IAAQmC,eAAehC;KACrEV,OAAO2C,IAAI,CAAChC,UACX,sBAAA,cAACjB,QAAQkD,iBAAe;IACtBtC,KAAKK;IACLA,OAAO8B,OAAO9B,KAAAA;IACdkC,cAAYzC,EAAE,eAAe;MAAE0C,OAAOnC;IAAM,CAAA;IAC5CoC,OAAO3C,EAAE,eAAe;MAAE0C,OAAOnC;IAAM,CAAA;KAEtCA,KAAAA,CAAAA,CAAAA,CAAAA,CAAAA,GAMX,sBAAA,cAAClB,MAAMuD,SAAO,MACZ,sBAAA,cAACpD,cAAcuC,MAAI;IACjBc,YAAW;IACXxC;IACAyC,SAAQ;IACRC,OAAOhD,QAAQiD;IACfC,gBAAgBrC;KAEhB,sBAAA,cAACpB,cAAc0D,OAAK;IAACC,aAAa9B;;AAK5C;",
+  "names": ["React", "useCallback", "useState", "Obj", "DxAnchorActivate", "Panel", "Toolbar", "useTranslation", "Visualization", "DEFAULT_NEIGHBORHOOD_DEPTH", "useNeighborhoodModel", "meta", "DEPTHS", "NeighborhoodCompanion", "role", "subject", "t", "profile", "key", "depth", "setDepth", "model", "handleDepthChange", "value", "next", "Number", "parseInt", "isFinite", "handleDismiss", "document", "defaultView", "dispatchEvent", "dxn", "label", "trigger", "body", "state", "handleHover", "node", "event", "obj", "data", "isObject", "getURI", "target", "kind", "getLabel", "Root", "asChild", "div", "className", "ToggleGroup", "type", "String", "onValueChange", "map", "ToggleGroupItem", "aria-label", "count", "title", "Content", "classNames", "variant", "focus", "id", "onSurfaceClick", "Graph", "onNodeHover"]
+}

package/dist/lib/neutral/app-graph-builder-L2TJ6GNR.mjs

@@ -0,0 +1,37 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/capabilities/app-graph-builder.ts
+import * as Effect from "effect/Effect";
+import { Capability } from "@dxos/app-framework";
+import { AppCapabilities, AppNode } from "@dxos/app-toolkit";
+import { GraphBuilder, NodeMatcher } from "@dxos/plugin-graph";
+import { linkedSegment } from "@dxos/react-ui-attention";
+import { Position } from "@dxos/util";
+import { meta } from "#meta";
+var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function* () {
+  const extensions = yield* Effect.all([
+    GraphBuilder.createExtension({
+      id: "neighborhoodCompanion",
+      match: NodeMatcher.whenEchoObjectMatches,
+      connector: () => Effect.succeed([
+        AppNode.makeCompanion({
+          id: linkedSegment("neighborhood"),
+          label: [
+            "neighborhood-companion.label",
+            {
+              ns: meta.profile.key
+            }
+          ],
+          icon: "ph--share-network--regular",
+          data: "neighborhood",
+          position: Position.last
+        })
+      ])
+    })
+  ]);
+  return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);
+}));
+export {
+  app_graph_builder_default as default
+};
+//# sourceMappingURL=app-graph-builder-L2TJ6GNR.mjs.map

package/dist/lib/neutral/app-graph-builder-L2TJ6GNR.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/app-graph-builder.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { AppCapabilities, AppNode } from '@dxos/app-toolkit';\nimport { GraphBuilder, NodeMatcher } from '@dxos/plugin-graph';\nimport { linkedSegment } from '@dxos/react-ui-attention';\nimport { Position } from '@dxos/util';\n\nimport { meta } from '#meta';\n\n/**\n * Offers a \"Neighborhood\" companion on any ECHO object. The matched node is passed through as the\n * companion's `companionTo` (the active node), which the surface renders as an ego-centric graph.\n */\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const extensions = yield* Effect.all([\n      GraphBuilder.createExtension({\n        id: 'neighborhoodCompanion',\n        match: NodeMatcher.whenEchoObjectMatches,\n        connector: () =>\n          Effect.succeed([\n            AppNode.makeCompanion({\n              id: linkedSegment('neighborhood'),\n              label: ['neighborhood-companion.label', { ns: meta.profile.key }],\n              icon: 'ph--share-network--regular',\n              data: 'neighborhood',\n              position: Position.last,\n            }),\n          ]),\n      }),\n    ]);\n\n    return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);\n  }),\n);\n"],
+  "mappings": ";;;AAIA,YAAYA,YAAY;AAExB,SAASC,kBAAkB;AAC3B,SAASC,iBAAiBC,eAAe;AACzC,SAASC,cAAcC,mBAAmB;AAC1C,SAASC,qBAAqB;AAC9B,SAASC,gBAAgB;AAEzB,SAASC,YAAY;AAMrB,IAAA,4BAAeP,WAAWQ,WACjBC,kBAAW,aAAA;AAChB,QAAMC,aAAa,OAAcC,WAAI;IACnCR,aAAaS,gBAAgB;MAC3BC,IAAI;MACJC,OAAOV,YAAYW;MACnBC,WAAW,MACFC,eAAQ;QACbf,QAAQgB,cAAc;UACpBL,IAAIR,cAAc,cAAA;UAClBc,OAAO;YAAC;YAAgC;cAAEC,IAAIb,KAAKc,QAAQC;YAAI;;UAC/DC,MAAM;UACNC,MAAM;UACNC,UAAUnB,SAASoB;QACrB,CAAA;OACD;IACL,CAAA;GACD;AAED,SAAO1B,WAAW2B,YAAY1B,gBAAgB2B,iBAAiBlB,UAAAA;AACjE,CAAA,CAAA;",
+  "names": ["Effect", "Capability", "AppCapabilities", "AppNode", "GraphBuilder", "NodeMatcher", "linkedSegment", "Position", "meta", "makeModule", "fnUntraced", "extensions", "all", "createExtension", "id", "match", "whenEchoObjectMatches", "connector", "succeed", "makeCompanion", "label", "ns", "profile", "key", "icon", "data", "position", "last", "contributes", "AppGraphBuilder"]
+}

package/dist/lib/neutral/capabilities/index.mjs

@@ -2,9 +2,11 @@ import "../chunk-J5LGTIGS.mjs";
 
 // src/capabilities/index.ts
 import { Capability } from "@dxos/app-framework";
-var CreateObject = Capability.lazy("CreateObject", () => import("../create-object-F6TKVAGV.mjs"));
-var ReactSurface = Capability.lazy("ReactSurface", () => import("../react-surface-APBW2VQG.mjs"));
+var AppGraphBuilder = Capability.lazy("AppGraphBuilder", () => import("../app-graph-builder-L2TJ6GNR.mjs"));
+var CreateObject = Capability.lazy("CreateObject", () => import("../create-object-WKIN3OB6.mjs"));
+var ReactSurface = Capability.lazy("ReactSurface", () => import("../react-surface-EWPG5PUQ.mjs"));
 export {
+  AppGraphBuilder,
   CreateObject,
   ReactSurface
 };

package/dist/lib/neutral/capabilities/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/capabilities/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\n"],
-  "mappings": ";;;AAIA,SAASA,kBAAkB;AAEpB,IAAMC,eAAeD,WAAWE,KAAK,gBAAgB,MAAM,OAAO,+BAAA,CAAA;AAClE,IAAMC,eAAeH,WAAWE,KAAK,gBAAgB,MAAM,OAAO,+BAAA,CAAA;",
-  "names": ["Capability", "CreateObject", "lazy", "ReactSurface"]
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\n"],
+  "mappings": ";;;AAIA,SAASA,kBAAkB;AAEpB,IAAMC,kBAAkBD,WAAWE,KAAK,mBAAmB,MAAM,OAAO,mCAAA,CAAA;AACxE,IAAMC,eAAeH,WAAWE,KAAK,gBAAgB,MAAM,OAAO,+BAAA,CAAA;AAClE,IAAME,eAAeJ,WAAWE,KAAK,gBAAgB,MAAM,OAAO,+BAAA,CAAA;",
+  "names": ["Capability", "AppGraphBuilder", "lazy", "CreateObject", "ReactSurface"]
 }

package/dist/lib/neutral/{chunk-3D7BYXOR.mjs → chunk-4F6AT7RA.mjs}

@@ -1,17 +1,19 @@
 // src/ExplorerPlugin.tsx
 import { Plugin } from "@dxos/app-framework";
 import { AppPlugin } from "@dxos/app-toolkit";
-import { CreateObject, ReactSurface } from "#capabilities";
+import { AppGraphBuilder, CreateObject, ReactSurface } from "#capabilities";
 import { meta } from "#meta";
 import { translations } from "#translations";
 import { Graph } from "#types";
 
-// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-explorer/PLUGIN.mdl?raw
+// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-explorer/PLUGIN.mdl
 var PLUGIN_default = "---\nid: org.dxos.plugin.explorer\nname: ExplorerPlugin\nversion: 0.1.0\n---\n\nAn interactive hypergraph visualization plugin for `DXOS` Composer that reveals relationships between objects in a workspace.\nThe plugin renders a live `Graph` object \u2014 backed by a `View` and a `QueryAST` query \u2014 through four switchable layout\nvariants: force-directed, radial cluster, edge bundling, and lattice.\nNode colours are derived from ECHO object types; hovering a node triggers an anchor-card preview.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.0`         |\n\n## Types\n\n```mdl\ntype QueryInput\n  fields:\n    raw?: string               # raw query string entered by the user\n    ast: QueryAST.Query        # compiled AST produced by QueryBuilder\n```\n\n```mdl\ntype GraphObject\n  desc: ECHO-persistent object that describes a hypergraph visualisation session.\n  fields:\n    name?: string\n    view: Ref<View>            # schema view that defines visible fields\n    query: QueryInput\n```\n\n```mdl\ntype ExplorerVariant\n  literals: force | cluster | bundle | lattice\n```\n\n## Components\n\n```mdl\ncomponent ExplorerArticle\n  desc: |\n    Top-level article / section surface for a Graph object.\n    Renders one of four SVG layout variants and a toolbar for switching between them.\n  props:\n    role: article | section\n    subject: Ref<View>\n    attendableId?: string\n  state:\n    variant: ExplorerVariant        # active layout; default force\n    filter?: Filter.Any             # compiled from toolbar query input\n    model?: SpaceGraphModel         # live reactive graph built from db + filter\n  slots:\n    toolbar?: ReactNode             # shown only when role === article\n  actions:\n    setVariant(v: ExplorerVariant)\n    setFilter(raw: string)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [toolbar slot \u2014 article only]  \u2502\n    \u2502  [QueryEditor] [variant tabs]  \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502                                \u2502\n    \u2502   SVG canvas (force / cluster  \u2502\n    \u2502   / bundle / lattice)          \u2502\n    \u2502                                \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent Visualization\n  desc: |\n    Internal component that owns a single persistent SVG.Graph mount.\n    Swaps the active GraphProjector when the variant changes, seeding the\n    new projector with the previous layout so node positions tween smoothly.\n  props:\n    variant: ExplorerVariant\n    model: SpaceGraphModel\n  state:\n    projector?: GraphProjector<SpaceGraphNode>\n  actions:\n    createProjector(variant: ExplorerVariant, prev?: GraphLayout) \u2192 GraphProjector\n    createRenderNode(variant: ExplorerVariant) \u2192 RenderNode\n```\n\n## Operations\n\n```mdl\nop createGraph\n  desc: |\n    Creates a new Graph object scoped to a target space or collection.\n    Derives a ViewModel from the database for the selected typename, then\n    writes the object via SpaceOperation.AddObject.\n  input:\n    name?: string\n    typename?: string            # ECHO typename used to seed the initial view\n    target: Space | Collection\n    targetNodeId?: string\n  output: GraphObject\n  effects: [echo:write]\n  note: |\n    The typename is resolved through ViewModel.makeFromDatabase; the resulting\n    View is stored as a Ref inside the Graph object.\n```\n\n```mdl\nop buildFilter\n  desc: |\n    Compiles a raw query string into a Filter via QueryBuilder.\n    Pure \u2014 no side effects; result is passed to SpaceGraphModel.setFilter.\n  input:\n    raw: string\n  output: Filter.Any\n  errors:\n    ParseError: raw string is not valid query syntax\n```\n\n## Features\n\n```mdl\nfeat F-1: Graph Object\n\n  req F-1.1: A Graph object stores a name, a View ref, and a compiled QueryAST.\n  req F-1.2:\n    when: user creates a new graph\n    then: op:createGraph derives a ViewModel from the chosen typename and writes the Graph to ECHO\n\n  req F-1.3:\n    when: Graph is persisted\n    then: it appears in the space object list and can be opened as an article\n```\n\n```mdl\nfeat F-2: Live Graph Model\n\n  req F-2.1:\n    when: ExplorerArticle mounts with a valid Graph subject\n    then: SpaceGraphModel is opened against the subject's database\n\n  req F-2.2:\n    when: user types a query in the toolbar\n    then: op:buildFilter compiles the raw string; model.setFilter applied; SVG re-renders\n\n  req F-2.3:\n    when: Graph is unmounted\n    then: SpaceGraphModel is closed and all subscriptions released\n\n  req F-2.4:\n    when: an ECHO object in the database changes\n    then: SpaceGraphModel emits an update and SVG.Graph re-renders without full remount\n    tags: [reactive, collaborative]\n```\n\n```mdl\nfeat F-3: Visualization Variants\n\n  req F-3.1:\n    when: variant tab is selected\n    then: Visualization swaps projector; previous node x/y seed the new projector so positions tween\n\n  req F-3.2:\n    when: variant is force\n    then: SVG.Zoom wrapper is mounted enabling pan/zoom drag interaction\n\n  req F-3.3:\n    when: variant is cluster or bundle\n    then: no SVG.Zoom wrapper; leaves grouped by typename; radial labels fade in after tween\n\n  req F-3.4:\n    when: variant is lattice\n    then: nodes rendered as small rounded rectangles sorted by typename then label\n\n  req F-3.5:\n    when: variant is cluster and user clicks a root or group node\n    then: subtree toggles collapsed/expanded via GraphClusterProjector.toggleCollapsed\n```\n\n```mdl\nfeat F-4: Node Interaction\n\n  req F-4.1:\n    when: pointer enters a node\n    then: DxAnchorActivate event dispatched with the object's DXN and label, kind: card\n\n  req F-4.2:\n    when: pointer leaves a node\n    then: DxAnchorActivate cleared (onNodeHover called with null)\n\n  req F-4.3:\n    when: node has no underlying ECHO object (synthetic root / group)\n    then: no preview dispatched; node rendered in neutral colour\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Graph creation\n  given: user opens the object creation dialog and selects Graph\n  when: a typename is selected and the form submitted\n  then:\n    - op:createGraph runs without error\n    - new Graph object visible in space object list\n    - Graph.view references a valid View object\n```\n\n```mdl\ntest T-2: Article mounts model\n  given: a Graph with a populated query\n  when: ExplorerArticle is rendered with role === article\n  then:\n    - SpaceGraphModel is opened\n    - SVG canvas renders nodes derived from the database\n    - toolbar shows QueryEditor and variant tabs\n```\n\n```mdl\ntest T-3: Variant switch preserves positions\n  given: force variant is active with nodes positioned\n  when: user switches to cluster variant\n  then:\n    - projector is recreated from previous layout\n    - nodes tween from old positions to cluster target positions\n    - SVG.Zoom wrapper is absent in the new mount\n```\n\n```mdl\ntest T-4: Query filter updates graph\n  given: ExplorerArticle is open with all objects visible\n  when: user types a typename filter in QueryEditor\n  then:\n    - op:buildFilter returns a Filter without error\n    - SpaceGraphModel.setFilter applied\n    - only matching nodes remain visible in the SVG\n```\n\n```mdl\ntest T-5: Node hover preview\n  given: force-directed graph with at least one ECHO object node\n  when: pointer enters that node\n  then:\n    - DxAnchorActivate event fired with correct DXN\n    - kind === card\n```\n\n```mdl\ntest T-6: Lattice sort order\n  given: database contains objects of two typenames A and B\n  when: lattice variant is active\n  then:\n    - all typename-A nodes appear before typename-B nodes (or vice-versa, consistent order)\n    - within each group nodes are ordered alphabetically by label\n```\n\n```mdl\ntest T-7: Model closed on unmount\n  given: ExplorerArticle is mounted and SpaceGraphModel is open\n  when: component unmounts\n  then:\n    - SpaceGraphModel.close() is called\n    - no lingering ECHO subscriptions remain\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n";
 
 // src/ExplorerPlugin.tsx
 var ExplorerPlugin = Plugin.define(meta).pipe(AppPlugin.addCreateObjectModule({
   activate: CreateObject
+}), AppPlugin.addAppGraphModule({
+  activate: AppGraphBuilder
 }), AppPlugin.addSchemaModule({
   schema: [
     Graph.Graph
@@ -22,7 +24,7 @@ var ExplorerPlugin = Plugin.define(meta).pipe(AppPlugin.addCreateObjectModule({
   translations
 }), AppPlugin.addPluginAssetModule({
   asset: {
-    pluginId: meta.id,
+    pluginId: meta.profile.key,
     path: "PLUGIN.mdl",
     content: PLUGIN_default,
     mimeType: "application/x-mdl"
@@ -34,4 +36,4 @@ export {
   ExplorerPlugin,
   ExplorerPlugin_default
 };
-//# sourceMappingURL=chunk-3D7BYXOR.mjs.map
+//# sourceMappingURL=chunk-4F6AT7RA.mjs.map

package/dist/lib/neutral/chunk-4F6AT7RA.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ExplorerPlugin.tsx", "raw-loader:/__w/dxos/dxos/packages/plugins/plugin-explorer/PLUGIN.mdl"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { AppGraphBuilder, CreateObject, ReactSurface } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { Graph } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const ExplorerPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addSchemaModule({ schema: [Graph.Graph] }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nexport default ExplorerPlugin;\n", "---\nid: org.dxos.plugin.explorer\nname: ExplorerPlugin\nversion: 0.1.0\n---\n\nAn interactive hypergraph visualization plugin for `DXOS` Composer that reveals relationships between objects in a workspace.\nThe plugin renders a live `Graph` object \u2014 backed by a `View` and a `QueryAST` query \u2014 through four switchable layout\nvariants: force-directed, radial cluster, edge bundling, and lattice.\nNode colours are derived from ECHO object types; hovering a node triggers an anchor-card preview.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.0`         |\n\n## Types\n\n```mdl\ntype QueryInput\n  fields:\n    raw?: string               # raw query string entered by the user\n    ast: QueryAST.Query        # compiled AST produced by QueryBuilder\n```\n\n```mdl\ntype GraphObject\n  desc: ECHO-persistent object that describes a hypergraph visualisation session.\n  fields:\n    name?: string\n    view: Ref<View>            # schema view that defines visible fields\n    query: QueryInput\n```\n\n```mdl\ntype ExplorerVariant\n  literals: force | cluster | bundle | lattice\n```\n\n## Components\n\n```mdl\ncomponent ExplorerArticle\n  desc: |\n    Top-level article / section surface for a Graph object.\n    Renders one of four SVG layout variants and a toolbar for switching between them.\n  props:\n    role: article | section\n    subject: Ref<View>\n    attendableId?: string\n  state:\n    variant: ExplorerVariant        # active layout; default force\n    filter?: Filter.Any             # compiled from toolbar query input\n    model?: SpaceGraphModel         # live reactive graph built from db + filter\n  slots:\n    toolbar?: ReactNode             # shown only when role === article\n  actions:\n    setVariant(v: ExplorerVariant)\n    setFilter(raw: string)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [toolbar slot \u2014 article only]  \u2502\n    \u2502  [QueryEditor] [variant tabs]  \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502                                \u2502\n    \u2502   SVG canvas (force / cluster  \u2502\n    \u2502   / bundle / lattice)          \u2502\n    \u2502                                \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent Visualization\n  desc: |\n    Internal component that owns a single persistent SVG.Graph mount.\n    Swaps the active GraphProjector when the variant changes, seeding the\n    new projector with the previous layout so node positions tween smoothly.\n  props:\n    variant: ExplorerVariant\n    model: SpaceGraphModel\n  state:\n    projector?: GraphProjector<SpaceGraphNode>\n  actions:\n    createProjector(variant: ExplorerVariant, prev?: GraphLayout) \u2192 GraphProjector\n    createRenderNode(variant: ExplorerVariant) \u2192 RenderNode\n```\n\n## Operations\n\n```mdl\nop createGraph\n  desc: |\n    Creates a new Graph object scoped to a target space or collection.\n    Derives a ViewModel from the database for the selected typename, then\n    writes the object via SpaceOperation.AddObject.\n  input:\n    name?: string\n    typename?: string            # ECHO typename used to seed the initial view\n    target: Space | Collection\n    targetNodeId?: string\n  output: GraphObject\n  effects: [echo:write]\n  note: |\n    The typename is resolved through ViewModel.makeFromDatabase; the resulting\n    View is stored as a Ref inside the Graph object.\n```\n\n```mdl\nop buildFilter\n  desc: |\n    Compiles a raw query string into a Filter via QueryBuilder.\n    Pure \u2014 no side effects; result is passed to SpaceGraphModel.setFilter.\n  input:\n    raw: string\n  output: Filter.Any\n  errors:\n    ParseError: raw string is not valid query syntax\n```\n\n## Features\n\n```mdl\nfeat F-1: Graph Object\n\n  req F-1.1: A Graph object stores a name, a View ref, and a compiled QueryAST.\n  req F-1.2:\n    when: user creates a new graph\n    then: op:createGraph derives a ViewModel from the chosen typename and writes the Graph to ECHO\n\n  req F-1.3:\n    when: Graph is persisted\n    then: it appears in the space object list and can be opened as an article\n```\n\n```mdl\nfeat F-2: Live Graph Model\n\n  req F-2.1:\n    when: ExplorerArticle mounts with a valid Graph subject\n    then: SpaceGraphModel is opened against the subject's database\n\n  req F-2.2:\n    when: user types a query in the toolbar\n    then: op:buildFilter compiles the raw string; model.setFilter applied; SVG re-renders\n\n  req F-2.3:\n    when: Graph is unmounted\n    then: SpaceGraphModel is closed and all subscriptions released\n\n  req F-2.4:\n    when: an ECHO object in the database changes\n    then: SpaceGraphModel emits an update and SVG.Graph re-renders without full remount\n    tags: [reactive, collaborative]\n```\n\n```mdl\nfeat F-3: Visualization Variants\n\n  req F-3.1:\n    when: variant tab is selected\n    then: Visualization swaps projector; previous node x/y seed the new projector so positions tween\n\n  req F-3.2:\n    when: variant is force\n    then: SVG.Zoom wrapper is mounted enabling pan/zoom drag interaction\n\n  req F-3.3:\n    when: variant is cluster or bundle\n    then: no SVG.Zoom wrapper; leaves grouped by typename; radial labels fade in after tween\n\n  req F-3.4:\n    when: variant is lattice\n    then: nodes rendered as small rounded rectangles sorted by typename then label\n\n  req F-3.5:\n    when: variant is cluster and user clicks a root or group node\n    then: subtree toggles collapsed/expanded via GraphClusterProjector.toggleCollapsed\n```\n\n```mdl\nfeat F-4: Node Interaction\n\n  req F-4.1:\n    when: pointer enters a node\n    then: DxAnchorActivate event dispatched with the object's DXN and label, kind: card\n\n  req F-4.2:\n    when: pointer leaves a node\n    then: DxAnchorActivate cleared (onNodeHover called with null)\n\n  req F-4.3:\n    when: node has no underlying ECHO object (synthetic root / group)\n    then: no preview dispatched; node rendered in neutral colour\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Graph creation\n  given: user opens the object creation dialog and selects Graph\n  when: a typename is selected and the form submitted\n  then:\n    - op:createGraph runs without error\n    - new Graph object visible in space object list\n    - Graph.view references a valid View object\n```\n\n```mdl\ntest T-2: Article mounts model\n  given: a Graph with a populated query\n  when: ExplorerArticle is rendered with role === article\n  then:\n    - SpaceGraphModel is opened\n    - SVG canvas renders nodes derived from the database\n    - toolbar shows QueryEditor and variant tabs\n```\n\n```mdl\ntest T-3: Variant switch preserves positions\n  given: force variant is active with nodes positioned\n  when: user switches to cluster variant\n  then:\n    - projector is recreated from previous layout\n    - nodes tween from old positions to cluster target positions\n    - SVG.Zoom wrapper is absent in the new mount\n```\n\n```mdl\ntest T-4: Query filter updates graph\n  given: ExplorerArticle is open with all objects visible\n  when: user types a typename filter in QueryEditor\n  then:\n    - op:buildFilter returns a Filter without error\n    - SpaceGraphModel.setFilter applied\n    - only matching nodes remain visible in the SVG\n```\n\n```mdl\ntest T-5: Node hover preview\n  given: force-directed graph with at least one ECHO object node\n  when: pointer enters that node\n  then:\n    - DxAnchorActivate event fired with correct DXN\n    - kind === card\n```\n\n```mdl\ntest T-6: Lattice sort order\n  given: database contains objects of two typenames A and B\n  when: lattice variant is active\n  then:\n    - all typename-A nodes appear before typename-B nodes (or vice-versa, consistent order)\n    - within each group nodes are ordered alphabetically by label\n```\n\n```mdl\ntest T-7: Model closed on unmount\n  given: ExplorerArticle is mounted and SpaceGraphModel is open\n  when: component unmounts\n  then:\n    - SpaceGraphModel.close() is called\n    - no lingering ECHO subscriptions remain\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n"],
+  "mappings": ";AAIA,SAASA,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,iBAAiBC,cAAcC,oBAAoB;AAC5D,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAC7B,SAASC,aAAa;;;ACVtB;;;ADeO,IAAMC,iBAAiBC,OAAOC,OAAOC,IAAAA,EAAMC,KAChDC,UAAUC,sBAAsB;EAAEC,UAAUC;AAAa,CAAA,GACzDH,UAAUI,kBAAkB;EAAEF,UAAUG;AAAgB,CAAA,GACxDL,UAAUM,gBAAgB;EAAEC,QAAQ;IAACC,MAAMA;;AAAO,CAAA,GAClDR,UAAUS,iBAAiB;EAAEP,UAAUQ;AAAa,CAAA,GACpDV,UAAUW,sBAAsB;EAAEC;AAAa,CAAA,GAC/CZ,UAAUa,qBAAqB;EAC7BC,OAAO;IAAEC,UAAUjB,KAAKkB,QAAQC;IAAKC,MAAM;IAAcC,SAASC;IAAYC,UAAU;EAAoB;AAC9G,CAAA,GACAzB,OAAO0B,IAAI;AAGb,IAAA,yBAAe3B;",
+  "names": ["Plugin", "AppPlugin", "AppGraphBuilder", "CreateObject", "ReactSurface", "meta", "translations", "Graph", "ExplorerPlugin", "Plugin", "define", "meta", "pipe", "AppPlugin", "addCreateObjectModule", "activate", "CreateObject", "addAppGraphModule", "AppGraphBuilder", "addSchemaModule", "schema", "Graph", "addSurfaceModule", "ReactSurface", "addTranslationsModule", "translations", "addPluginAssetModule", "asset", "pluginId", "profile", "key", "path", "content", "pluginSpec", "mimeType", "make"]
+}

package/dist/lib/neutral/chunk-C56B464A.mjs

@@ -0,0 +1,53 @@
+// src/meta.ts
+import { Plugin } from "@dxos/app-framework";
+
+// dx.config.ts
+import { Config2 } from "@dxos/app-framework/config";
+import { trim } from "@dxos/util";
+var dx_config_default = Config2.make({
+  plugin: {
+    key: "org.dxos.plugin.explorer",
+    name: "Explorer",
+    author: "DXOS",
+    description: trim`
+    Explorer is an interactive hypergraph visualization plugin that reveals the relationships
+    between objects stored in your DXOS workspace. Each Graph document is backed by a live
+    ECHO query and a View that you configure — Explorer keeps the visualization synchronized
+    with the database in real time so every peer immediately sees changes made by collaborators.
+
+    The plugin offers four switchable layout algorithms for the same data set: a physics-based
+    force-directed graph for freeform exploration, a radial cluster layout that groups objects
+    by type around a central root, an edge-bundling layout that tames visual clutter on dense
+    graphs, and a lattice grid that arranges objects in a sorted matrix sorted by type and label.
+    Switching between layouts smoothly tweens node positions so spatial context is preserved.
+
+    Nodes are coloured by their ECHO object type, and hovering any node opens an anchor-card
+    preview panel with the object's details without leaving the graph view.
+    The toolbar's query editor lets you filter the visible node set on the fly using
+    the same query syntax available across Composer.
+
+    A new Graph document can be created from the object-creation dialog; Explorer automatically
+    derives an initial View from the chosen type and persists both to ECHO so the graph is
+    immediately shareable and replicable across the space.
+  `,
+    source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-explorer",
+    icon: {
+      key: "ph--graph--regular",
+      hue: "green"
+    },
+    spec: "PLUGIN.mdl",
+    screenshots: [
+      {
+        dark: "https://dxos.network/plugin-details-explorer-dark.png"
+      }
+    ]
+  }
+});
+
+// src/meta.ts
+var meta = Plugin.getMetaFromConfig(dx_config_default);
+
+export {
+  meta
+};
+//# sourceMappingURL=chunk-C56B464A.mjs.map

package/dist/lib/neutral/chunk-C56B464A.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/meta.ts", "../../../dx.config.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport config from '../dx.config';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.explorer',\n    name: 'Explorer',\n    author: 'DXOS',\n    description: trim`\n    Explorer is an interactive hypergraph visualization plugin that reveals the relationships\n    between objects stored in your DXOS workspace. Each Graph document is backed by a live\n    ECHO query and a View that you configure — Explorer keeps the visualization synchronized\n    with the database in real time so every peer immediately sees changes made by collaborators.\n\n    The plugin offers four switchable layout algorithms for the same data set: a physics-based\n    force-directed graph for freeform exploration, a radial cluster layout that groups objects\n    by type around a central root, an edge-bundling layout that tames visual clutter on dense\n    graphs, and a lattice grid that arranges objects in a sorted matrix sorted by type and label.\n    Switching between layouts smoothly tweens node positions so spatial context is preserved.\n\n    Nodes are coloured by their ECHO object type, and hovering any node opens an anchor-card\n    preview panel with the object's details without leaving the graph view.\n    The toolbar's query editor lets you filter the visible node set on the fly using\n    the same query syntax available across Composer.\n\n    A new Graph document can be created from the object-creation dialog; Explorer automatically\n    derives an initial View from the chosen type and persists both to ECHO so the graph is\n    immediately shareable and replicable across the space.\n  `,\n    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-explorer',\n    icon: { key: 'ph--graph--regular', hue: 'green' },\n    spec: 'PLUGIN.mdl',\n    screenshots: [{ dark: 'https://dxos.network/plugin-details-explorer-dark.png' }],\n  },\n});\n"],
+  "mappings": ";AAIA,SAASA,cAAc;;;ACAvB,SAASC,eAAe;AACxB,SAASC,YAAY;AAErB,IAAA,oBAAeD,QAAQE,KAAK;EAC1BC,QAAQ;IACNC,KAAK;IACLC,MAAM;IACNC,QAAQ;IACRC,aAAaN;;;;;;;;;;;;;;;;;;;;;IAqBbO,QAAQ;IACRC,MAAM;MAAEL,KAAK;MAAsBM,KAAK;IAAQ;IAChDC,MAAM;IACNC,aAAa;MAAC;QAAEC,MAAM;MAAwD;;EAChF;AACF,CAAA;;;AD9BO,IAAMC,OAAOC,OAAOC,kBAAkBC,iBAAAA;",
+  "names": ["Plugin", "Config2", "trim", "make", "plugin", "key", "name", "author", "description", "source", "icon", "hue", "spec", "screenshots", "dark", "meta", "Plugin", "getMetaFromConfig", "config"]
+}

package/dist/lib/neutral/{chunk-7XUDLV6E.mjs → chunk-EZ52JY7X.mjs}

@@ -1,28 +1,3 @@
-// src/components/Tree/types/types.ts
-var treeTypeToTreeNode = (tree, rootId = tree.root, visited = /* @__PURE__ */ new Set()) => {
-  const node = tree.nodes[rootId];
-  if (!node) {
-    return void 0;
-  }
-  if (visited.has(rootId)) {
-    return {
-      id: rootId,
-      label: labelOf(node),
-      data: node.data
-    };
-  }
-  visited.add(rootId);
-  return {
-    id: rootId,
-    label: labelOf(node),
-    data: node.data,
-    children: node.children.map((childId) => treeTypeToTreeNode(tree, childId, visited)).filter((c) => Boolean(c))
-  };
-};
-var labelOf = (node) => {
-  return typeof node.data?.text === "string" ? node.data.text : void 0;
-};
-
 // src/components/Tree/types/tree.ts
 import * as Schema from "effect/Schema";
 import { DXN, Key, Obj, Ref, Type } from "@dxos/echo";
@@ -38,13 +13,14 @@ var TreeNodeType = Schema.Struct({
   })),
   ref: Schema.optional(Ref.Ref(TestSchema.Expando))
 }).pipe(Schema.mutable);
-var TreeType = Schema.Struct({
+var TreeType = class extends Type.makeObject(DXN.make("org.dxos.type.tree", "0.1.0"))(Schema.Struct({
   root: Key.EntityId,
   nodes: Schema.mutable(Schema.Record({
     key: Key.EntityId,
     value: TreeNodeType
   }))
-}).pipe(Type.makeObject(DXN.make("org.dxos.type.tree", "0.1.0")));
+})) {
+};
 var Tree = class _Tree {
   static create = () => {
     const id = Key.EntityId.random();
@@ -96,7 +72,7 @@ var Tree = class _Tree {
   }
   getNode(id) {
     const node = this._tree.nodes[id];
-    invariant(node, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 77, S: this, A: ["node", ""] });
+    invariant(node, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 78, S: this, A: ["node", ""] });
     return node;
   }
   /**
@@ -222,8 +198,8 @@ var Tree = class _Tree {
   * Move child node.
   */
   moveNode(node, from, to) {
-    invariant(from >= 0 && from < node.children.length, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 197, S: this, A: ["from >= 0 && from < node.children.length", ""] });
-    invariant(to >= 0 && to < node.children.length, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 198, S: this, A: ["to >= 0 && to < node.children.length", ""] });
+    invariant(from >= 0 && from < node.children.length, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 198, S: this, A: ["from >= 0 && from < node.children.length", ""] });
+    invariant(to >= 0 && to < node.children.length, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 199, S: this, A: ["to >= 0 && to < node.children.length", ""] });
     if (from === to) {
       return null;
     }
@@ -280,8 +256,35 @@ var Tree = class _Tree {
   }
 };
 
+// src/components/Tree/types/types.ts
+var treeTypeToTreeNode = (tree, rootId = tree.root, visited = /* @__PURE__ */ new Set()) => {
+  const node = tree.nodes[rootId];
+  if (!node) {
+    return void 0;
+  }
+  if (visited.has(rootId)) {
+    return {
+      id: rootId,
+      label: labelOf(node),
+      data: node.data
+    };
+  }
+  visited.add(rootId);
+  return {
+    id: rootId,
+    label: labelOf(node),
+    data: node.data,
+    children: node.children.map((childId) => treeTypeToTreeNode(tree, childId, visited)).filter((c) => Boolean(c))
+  };
+};
+var labelOf = (node) => {
+  return typeof node.data?.text === "string" ? node.data.text : void 0;
+};
+
 export {
+  TreeNodeType,
+  TreeType,
   Tree,
   treeTypeToTreeNode
 };
-//# sourceMappingURL=chunk-7XUDLV6E.mjs.map
+//# sourceMappingURL=chunk-EZ52JY7X.mjs.map