@dxos/plugin-devtools 0.10.0 → 0.11.1

package/README.md

@@ -1,6 +1,6 @@
-# @dxos/plugin-kanban
+# @dxos/plugin-devtools
 
-Surface plugin for kanban entities.
+Developer inspector plugin for DXOS.
 
 ## DXOS Resources
 
@@ -12,4 +12,4 @@ Surface plugin for kanban entities.
 
 Your ideas, issues, and code are most welcome. Please take a look at our [community code of conduct](https://github.com/dxos/dxos/blob/main/CODE_OF_CONDUCT.md), the [issue guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-issues), and the [PR contribution guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-prs).
 
-License: [FSL-1.1-Apache-2.0](./LICENSE) Copyright 2023 © DXOS
+License: [FSL-1.1-Apache-2.0](./LICENSE) Copyright 2026 © DXOS

package/dist/lib/DevtoolsPlugin.mjs

@@ -0,0 +1,39 @@
+import { ActivationEvents, Capability, Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+import * as Effect from "effect/Effect";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { AppGraphBuilder, ReactContext, ReactSurface } from "#capabilities";
+import { translations } from "#translations";
+//#endregion
+//#region src/DevtoolsPlugin.tsx
+var DevtoolsPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }), AppPlugin.addReactContextModule({ activate: ReactContext }), Plugin.addModule({
+	id: Capability.getModuleTag(ReactSurface) ?? "surfaces",
+	activatesOn: ActivationEvents.SetupReactSurface,
+	activate: () => ReactSurface()
+}), AppPlugin.addTranslationsModule({ translations }), Plugin.addModule({
+	id: "setup-devtools",
+	activatesOn: ActivationEvents.Startup,
+	activate: () => Effect.sync(() => setupDevtools())
+}), AppPlugin.addPluginAssetModule({ asset: {
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: "---\nid: org.dxos.plugin.devtools\nname: DevtoolsPlugin\nversion: 0.1.0\n---\n\nDeveloper inspector plugin for `DXOS` Composer — structured devtools panels for Client/HALO/ECHO/Mesh/EDGE subsystems, an app-graph inspector, and a tools explorer. Debugging utilities (object generation, wireframe overlays, per-object inspection, stats) live in the sibling `@dxos/plugin-debug`.\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 Settings\n  fields:\n    wireframe?: boolean         # overlay every article/section surface with a labelled border\n    traceAll?: boolean          # enable verbose operation tracing across all plugins\n```\n\n```mdl\ntype DebugPluginOptions\n  fields:\n    logStore?: IdbLogStore      # shared persistent log store for capturing and downloading logs\n```\n\n```mdl\ntype DebugContextType\n  fields:\n    running: boolean\n    start(cb: TimerCallback, options: TimerOptions): void\n    stop(): void\n```\n\n## Components\n\n```mdl\ncomponent DebugSettings\n  desc: Settings panel rendered in the plugin-settings article slot; controls wireframe and traceAll toggles and exposes log download.\n  props:\n    settings: Settings\n    logStore?: IdbLogStore\n  actions:\n    updateSettings(patch: Partial<Settings>)\n    downloadLogs()\n```\n\n```mdl\ncomponent DebugStatus\n  desc: Status-indicator surface shown in the main toolbar; reflects the generator timer running state.\n  state:\n    running: boolean\n```\n\n```mdl\ncomponent DevtoolsOverviewContainer\n  desc: Deck-companion panel that provides quick access to all devtools sections via a categorised link list.\n  layout: |\n    ┌─────────────────────────────┐\n    │  Client  ▸ Config / Storage │\n    │            Logs / Diag      │\n    │  HALO    ▸ Identity / Keys  │\n    │  ECHO    ▸ Spaces / Feeds   │\n    │            Objects / Schema │\n    │  Mesh    ▸ Signal / Swarm   │\n    │  EDGE    ▸ Dashboard / …    │\n    └─────────────────────────────┘\n```\n\n```mdl\ncomponent DebugObjectPanel\n  desc: Companion panel for any ECHO object that shows raw field values, type info, and DXN.\n  props:\n    companionTo: string         # DXN of the object being inspected\n```\n\n```mdl\ncomponent DebugSpaceObjectsPanel\n  desc: Deck-companion panel listing all objects in the active space with their type, ID, and field count.\n  props:\n    space: Space\n```\n\n```mdl\ncomponent DebugGraph\n  desc: Visual representation of the Composer app-graph as a collapsible JSON tree.\n  props:\n    graph: Graph.Graph\n    root: string                # node ID used as the traversal root\n```\n\n```mdl\ncomponent SpaceGenerator\n  desc: Article view for generating synthetic ECHO objects into a space; controls count, type mix, and relation density.\n  props:\n    space: Space\n  actions:\n    generateObjects(count: number, types: string[])\n    clear()\n  emits:\n    onCreateObjects(objects: Obj.Unknown[])\n```\n\n```mdl\ncomponent Wireframe\n  desc: Transparent overlay that wraps any article or section surface and renders a labelled border for layout debugging.\n  props:\n    label: string               # \"role:name\" descriptor shown in the corner badge\n    object: Obj.Unknown\n    classNames?: string\n```\n\n```mdl\ncomponent SchemaTable\n  desc: Tabular display of all registered ECHO schemas with typename, fields, and version.\n```\n\n```mdl\ncomponent GithubPanel\n  desc: Developer panel linking to open GitHub issues and CI run status for the current build.\n```\n```\n\n## Components (Devtools Panels)\n\nThe following components are thin wrappers around `@dxos/devtools` panel components, each bound to a specific `Devtools.*` node:\n\n| Component              | Devtools node              | Displays                                |\n|------------------------|----------------------------|-----------------------------------------|\n| ConfigPanel            | Client.Config              | Vault config JSON viewer                |\n| StoragePanel           | Client.Storage             | Local storage browser                   |\n| LoggingPanel           | Client.Logs                | Live log stream; download via logStore  |\n| DiagnosticsPanel       | Client.Diagnostics         | Client health / metric charts           |\n| IdentityPanel          | Halo.Identity              | Local identity key + device list        |\n| DeviceListPanel        | Halo.Devices               | All devices paired with this identity   |\n| KeyringPanel           | Halo.Keyring               | Raw keyring entries                     |\n| CredentialsPanel       | Halo.Credentials           | Credentials held in the active space    |\n| SpaceListPanel         | Echo.Spaces                | All spaces with state + select action   |\n| SpaceInfoPanel         | Echo.Space                 | Selected space feeds / pipelines        |\n| FeedsPanel             | Echo.Feeds                 | Feed entries for the active space       |\n| ObjectsPanel           | Echo.Objects               | All objects in the active space         |\n| SchemaPanel            | Echo.Schema                | Schemas registered in the active space  |\n| AutomergePanel         | Echo.Automerge             | Automerge document internals            |\n| QueuesPanel            | Echo.Queues                | Pending queue items                     |\n| MembersPanel           | Echo.Members               | Space members with last-seen            |\n| MetadataPanel          | Echo.Metadata              | Space/feed metadata blobs               |\n| SignalPanel            | Mesh.Signal                | Signal-server connection state          |\n| SwarmPanel             | Mesh.Swarm                 | Active swarm peers                      |\n| NetworkPanel           | Mesh.Network               | Full network topology for active space  |\n| EdgeDashboardPanel     | Edge.Dashboard             | EDGE node health / worker stats         |\n| WorkflowPanel          | Edge.Workflows             | Workflow definitions in active space    |\n| InvocationTraceContainer | Edge.Traces              | Invocation trace timeline from feed     |\n| TestingPanel           | Edge.Testing               | Integration test harness for EDGE       |\n| ToolsExplorer          | ToolsExplorer              | MCP-backed tools explorer               |\n\n## Operations\n\nNo first-party operations are defined by DebugPlugin. The plugin invokes `SpaceOperation.AddObject`, `SpaceOperation.Migrate`, `LayoutOperation.Open`, and `ScriptOperation.CreateScript` from other plugins via `useOperationInvoker` inside its surfaces.\n\n## Features\n\n```mdl\nfeat F-1: Devtools Graph Node\n\n  req F-1.1:\n    when: DebugPlugin is loaded\n    then: a \"Devtools\" node appears pinned at the end of each root and space in the nav graph\n\n  req F-1.2: The Devtools node contains sub-trees for Client, HALO, ECHO, Mesh, and EDGE categories.\n  req F-1.3: An app-graph sub-node renders DebugGraph rooted at the current space or root.\n  req F-1.4: A tools-explorer sub-node renders ToolsExplorer connected to the MCP introspect service.\n```\n\n```mdl\nfeat F-2: Object Debug Companion\n\n  req F-2.1:\n    when: any ECHO object is open in the deck\n    then: a \"Debug\" companion tab is injected at the last position\n\n  req F-2.2: DebugObjectPanel shows raw object fields, DXN, and typename for the companion target.\n```\n\n```mdl\nfeat F-3: Space Object Explorer\n\n  req F-3.1:\n    when: user opens the \"Space Objects\" deck companion\n    then: DebugSpaceObjectsPanel lists all ECHO objects in the active space\n\n  req F-3.2: List updates reactively as objects are added or removed.\n```\n\n```mdl\nfeat F-4: Devtools Overview Companion\n\n  req F-4.1:\n    when: user opens the \"Devtools\" deck companion\n    then: DevtoolsOverviewContainer renders a categorised link list to all devtools panels\n\n  req F-4.2: Clicking a category link navigates the deck to the corresponding devtools article.\n```\n\n```mdl\nfeat F-5: Space Data Generator\n\n  req F-5.1:\n    when: user navigates to the debug node under a space\n    then: SpaceGenerator is rendered as the article\n\n  req F-5.2:\n    when: user triggers object generation\n    then: synthetic ECHO objects are created via op:SpaceOperation.AddObject in the active collection\n\n  req F-5.3: DebugStatus indicator in the toolbar shows a running state while generation is active.\n```\n\n```mdl\nfeat F-6: Wireframe Overlay\n\n  req F-6.1:\n    when: settings.wireframe is true\n    then: Wireframe wraps every article and section surface with a labelled border\n\n  req F-6.2:\n    when: settings.wireframe is false or unset\n    then: no overlay is injected; the Wireframe surface filter returns false immediately\n```\n\n```mdl\nfeat F-7: Log Capture and Download\n\n  req F-7.1:\n    when: logStore is provided in DebugPluginOptions\n    then: LoggingPanel can stream and display captured log entries\n\n  req F-7.2:\n    when: user clicks download in DebugSettings\n    then: captured logs are serialised and offered as a file download via the file uploader capability\n```\n\n```mdl\nfeat F-8: Global Dev Utilities\n\n  req F-8.1:\n    when: DebugPlugin activates\n    then: globalThis.composer.changeStorageVersionInMetadata is registered for manual storage-migration testing\n\n  req F-8.2: The function destroys the client, rewrites the storage version metadata, and reloads the page.\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Devtools node appears in nav graph\n  given: Composer loaded with DebugPlugin enabled\n  when: user opens the navigation tree\n  then:\n    - \"Devtools\" node is visible pinned at the end of the root\n    - sub-nodes Client, HALO, ECHO, Mesh, EDGE are present\n```\n\n```mdl\ntest T-2: Debug companion on ECHO object\n  given: a Document is open in the deck\n  when: user clicks the \"Debug\" companion tab\n  then:\n    - DebugObjectPanel renders with the object's DXN and field map\n```\n\n```mdl\ntest T-3: Wireframe overlay toggle\n  given: DebugPlugin settings panel is open\n  when: user enables the wireframe toggle\n  then:\n    - every article and section surface shows a labelled border\n  when: user disables the wireframe toggle\n  then:\n    - borders are removed immediately\n```\n\n```mdl\ntest T-4: Space object generation\n  given: a space with an empty collection is active\n  when: user opens the debug space node and generates 10 objects\n  then:\n    - 10 new objects appear in the active collection\n    - DebugStatus shows \"running\" while generation is in progress\n```\n\n```mdl\ntest T-5: Log download\n  given: logStore is configured and some log entries have been captured\n  when: user clicks \"Download Logs\" in DebugSettings\n  then:\n    - a file download is triggered containing the serialised log entries\n```\n\n---\n\n## Appendix: Extension Definitions\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\n    literals?: UnionList\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\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\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\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\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n",
+	mimeType: "application/x-mdl"
+} }), Plugin.make);
+var setupDevtools = () => {
+	globalThis.composer ??= {};
+	globalThis.composer.changeStorageVersionInMetadata = async (version) => {
+		const { changeStorageVersionInMetadata } = await import("@dxos/client-services/testing");
+		const { createStorageObjects } = await import("@dxos/client-services");
+		const client = window.dxos.client;
+		const config = client.config;
+		await client.destroy();
+		const { storage } = createStorageObjects(config.values?.runtime?.client?.storage ?? {});
+		await changeStorageVersionInMetadata(storage, version);
+		location.pathname = "/";
+	};
+};
+//#endregion
+export { DevtoolsPlugin, DevtoolsPlugin as default };
+
+//# sourceMappingURL=DevtoolsPlugin.mjs.map

package/dist/lib/DevtoolsPlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevtoolsPlugin.mjs","names":[],"sources":["../../src/DevtoolsPlugin.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { ActivationEvents, Capability, Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\nimport { type Client } from '@dxos/react-client';\n\nimport { AppGraphBuilder, ReactContext, ReactSurface } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const DevtoolsPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addReactContextModule({ activate: ReactContext }),\n  Plugin.addModule({\n    id: Capability.getModuleTag(ReactSurface) ?? 'surfaces',\n    activatesOn: ActivationEvents.SetupReactSurface,\n    activate: () => ReactSurface(),\n  }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.addModule({\n    id: 'setup-devtools',\n    activatesOn: ActivationEvents.Startup,\n    activate: () => Effect.sync(() => setupDevtools()),\n  }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nconst setupDevtools = () => {\n  (globalThis as any).composer ??= {};\n\n  // Used to test how composer handles breaking protocol changes.\n  (globalThis as any).composer.changeStorageVersionInMetadata = async (version: number) => {\n    const { changeStorageVersionInMetadata } = await import('@dxos/client-services/testing');\n    const { createStorageObjects } = await import('@dxos/client-services');\n    const client: Client = (window as any).dxos.client;\n    const config = client.config;\n    await client.destroy();\n    const { storage } = createStorageObjects(config.values?.runtime?.client?.storage ?? {});\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;;;;;;AAiBA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAChD,UAAU,kBAAkB,EAAE,UAAU,gBAAgB,CAAC,GACzD,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,OAAO,UAAU;CACf,IAAI,WAAW,aAAa,YAAY,KAAK;CAC7C,aAAa,iBAAiB;CAC9B,gBAAgB,aAAa;AAC/B,CAAC,GACD,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,iBAAiB;CAC9B,gBAAgB,OAAO,WAAW,cAAc,CAAC;AACnD,CAAC,GACD,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,OAAO,IACT;AAEA,IAAM,sBAAsB;CAC1B,WAAoB,aAAa,CAAC;CAGlC,WAAoB,SAAS,iCAAiC,OAAO,YAAoB;EACvF,MAAM,EAAE,mCAAmC,MAAM,OAAO;EACxD,MAAM,EAAE,yBAAyB,MAAM,OAAO;EAC9C,MAAM,SAAkB,OAAe,KAAK;EAC5C,MAAM,SAAS,OAAO;EACtB,MAAM,OAAO,QAAQ;EACrB,MAAM,EAAE,YAAY,qBAAqB,OAAO,QAAQ,SAAS,QAAQ,WAAW,CAAC,CAAC;EACtF,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF"}

package/dist/lib/DevtoolsPlugin.node.mjs

@@ -0,0 +1,10 @@
+import { Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { AppGraphBuilder } from "#capabilities";
+//#region src/DevtoolsPlugin.node.ts
+var DevtoolsPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }), Plugin.make);
+//#endregion
+export { DevtoolsPlugin, DevtoolsPlugin as default };
+
+//# sourceMappingURL=DevtoolsPlugin.node.mjs.map

package/dist/lib/DevtoolsPlugin.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevtoolsPlugin.node.mjs","names":[],"sources":["../../src/DevtoolsPlugin.node.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { AppGraphBuilder } from '#capabilities';\nimport { meta } from '#meta';\n\nexport const DevtoolsPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  Plugin.make,\n);\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;;;AAUA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAChD,UAAU,kBAAkB,EAAE,UAAU,gBAAgB,CAAC,GACzD,OAAO,IACT"}

package/dist/lib/DevtoolsPlugin.workerd.mjs

@@ -0,0 +1,8 @@
+import { Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+//#region src/DevtoolsPlugin.workerd.ts
+var DevtoolsPlugin = Plugin.define(meta).pipe(Plugin.make);
+//#endregion
+export { DevtoolsPlugin, DevtoolsPlugin as default };
+
+//# sourceMappingURL=DevtoolsPlugin.workerd.mjs.map

package/dist/lib/DevtoolsPlugin.workerd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevtoolsPlugin.workerd.mjs","names":[],"sources":["../../src/DevtoolsPlugin.workerd.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\nexport const DevtoolsPlugin = Plugin.define(meta).pipe(Plugin.make);\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;AAQA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,IAAI"}

package/dist/lib/capabilities.mjs

@@ -0,0 +1,9 @@
+import { Capability } from "@dxos/app-framework";
+//#region src/capabilities/index.ts
+var AppGraphBuilder = Capability.lazy("AppGraphBuilder", () => import("./chunk-app-graph-builder.mjs"));
+var ReactContext = Capability.lazy("ReactContext", () => import("./chunk-react-context.mjs"));
+var ReactSurface = Capability.lazy("ReactSurface", () => import("./chunk-react-surface.mjs"));
+//#endregion
+export { AppGraphBuilder, ReactContext, ReactSurface };
+
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"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 ReactContext = Capability.lazy('ReactContext', () => import('./react-context'));\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\n"],"mappings":";;AAMA,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,gCAAsB;AACrG,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB"}

package/dist/lib/chunk-DebugGraph.mjs

@@ -0,0 +1,20 @@
+import "react";
+import { Graph } from "@dxos/plugin-graph";
+import { Tree } from "@dxos/devtools";
+import { jsx } from "react/jsx-runtime";
+import { Panel, ScrollArea } from "@dxos/react-ui";
+//#region src/containers/DebugGraph/DebugGraph.tsx
+var DebugGraph = ({ graph, root }) => {
+	return /* @__PURE__ */ jsx(Panel.Root, { children: /* @__PURE__ */ jsx(Panel.Content, {
+		asChild: true,
+		children: /* @__PURE__ */ jsx(ScrollArea.Root, {
+			orientation: "all",
+			children: /* @__PURE__ */ jsx(ScrollArea.Viewport, { children: /* @__PURE__ */ jsx(Tree, { data: Graph.toJSON(graph, root) }) })
+		})
+	}) });
+};
+DebugGraph.displayName = "DebugGraph";
+//#endregion
+export { DebugGraph as default };
+
+//# sourceMappingURL=chunk-DebugGraph.mjs.map

package/dist/lib/chunk-DebugGraph.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-DebugGraph.mjs","names":[],"sources":["../../src/containers/DebugGraph/DebugGraph.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Tree } from '@dxos/devtools';\nimport { Graph } from '@dxos/plugin-graph';\nimport { Panel, ScrollArea } from '@dxos/react-ui';\n\nexport type DebugGraphProps = { graph: Graph.Graph; root: string };\n\nexport const DebugGraph = ({ graph, root }: DebugGraphProps) => {\n  return (\n    <Panel.Root>\n      <Panel.Content asChild>\n        <ScrollArea.Root orientation='all'>\n          <ScrollArea.Viewport>\n            <Tree data={Graph.toJSON(graph, root)} />\n          </ScrollArea.Viewport>\n        </ScrollArea.Root>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nDebugGraph.displayName = 'DebugGraph';\n"],"mappings":";;;;;;AAYA,IAAa,cAAc,EAAE,OAAO,WAA4B;CAC9D,OACE,oBAAC,MAAM,MAAP,EAAA,UACE,oBAAC,MAAM,SAAP;EAAe,SAAA;YACb,oBAAC,WAAW,MAAZ;GAAiB,aAAY;aAC3B,oBAAC,WAAW,UAAZ,EAAA,UACE,oBAAC,MAAD,EAAM,MAAM,MAAM,OAAO,OAAO,IAAI,EAAI,CAAA,EACrB,CAAA;EACN,CAAA;CACJ,CAAA,EACL,CAAA;AAEhB;AAEA,WAAW,cAAc"}

package/dist/lib/chunk-DevtoolsOverviewContainer.mjs

@@ -0,0 +1,40 @@
+import { useCallback, useMemo } from "react";
+import { Surface } from "@dxos/app-framework/ui";
+import { StatsPanel, useStats } from "@dxos/devtools";
+import { jsx } from "react/jsx-runtime";
+import { AppSurface } from "@dxos/app-toolkit/ui";
+//#region src/containers/DevtoolsOverviewContainer/DevtoolsOverviewContainer.tsx
+var DevtoolsOverviewContainer = () => {
+	const [stats, refreshStats] = useStats();
+	const surfaceProfilerStats = Surface.useProfilerStats();
+	const surfaceMetrics = Surface.useMetrics();
+	const clearSurfaceProfiler = Surface.useProfilerClear();
+	const handleClearSurfaceProfiler = useCallback(() => {
+		clearSurfaceProfiler?.();
+		Surface.clearMetrics();
+	}, [clearSurfaceProfiler]);
+	return /* @__PURE__ */ jsx(StatsPanel, {
+		stats,
+		surfaceProfilerStats: useMemo(() => {
+			const byId = new Map(surfaceMetrics.map((metric) => [metric.id, metric]));
+			return surfaceProfilerStats.map((stat) => {
+				const metric = byId.get(stat.id);
+				return metric ? {
+					...stat,
+					candidates: metric.candidates,
+					truncated: metric.truncated,
+					errors: metric.errors,
+					dataUnstable: metric.dataUnstable
+				} : stat;
+			});
+		}, [surfaceProfilerStats, surfaceMetrics]),
+		onRefresh: refreshStats,
+		onClearSurfaceProfiler: handleClearSurfaceProfiler,
+		children: /* @__PURE__ */ jsx(Surface.Surface, { type: AppSurface.DevtoolsOverview })
+	});
+};
+DevtoolsOverviewContainer.displayName = "DevtoolsOverviewContainer";
+//#endregion
+export { DevtoolsOverviewContainer as default };
+
+//# sourceMappingURL=chunk-DevtoolsOverviewContainer.mjs.map

package/dist/lib/chunk-DevtoolsOverviewContainer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-DevtoolsOverviewContainer.mjs","names":[],"sources":["../../src/containers/DevtoolsOverviewContainer/DevtoolsOverviewContainer.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport React, { useCallback, useMemo } from 'react';\n\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { StatsPanel, useStats } from '@dxos/devtools';\n\nexport const DevtoolsOverviewContainer = () => {\n  const [stats, refreshStats] = useStats();\n  const surfaceProfilerStats = Surface.useProfilerStats();\n  const surfaceMetrics = Surface.useMetrics();\n  const clearSurfaceProfiler = Surface.useProfilerClear();\n\n  // The panel joins profiler stats with dispatch metrics, so reset must clear both.\n  const handleClearSurfaceProfiler = useCallback(() => {\n    clearSurfaceProfiler?.();\n    Surface.clearMetrics();\n  }, [clearSurfaceProfiler]);\n\n  // Join dispatch metrics onto the render-timing stats (both keyed by `surface/<id>/<role>`).\n  const enrichedStats = useMemo(() => {\n    const byId = new Map(surfaceMetrics.map((metric) => [metric.id, metric]));\n    return surfaceProfilerStats.map((stat) => {\n      const metric = byId.get(stat.id);\n      return metric\n        ? {\n            ...stat,\n            candidates: metric.candidates,\n            truncated: metric.truncated,\n            errors: metric.errors,\n            dataUnstable: metric.dataUnstable,\n          }\n        : stat;\n    });\n  }, [surfaceProfilerStats, surfaceMetrics]);\n\n  return (\n    <StatsPanel\n      stats={stats}\n      surfaceProfilerStats={enrichedStats}\n      onRefresh={refreshStats}\n      onClearSurfaceProfiler={handleClearSurfaceProfiler}\n    >\n      <Surface.Surface type={AppSurface.DevtoolsOverview} />\n    </StatsPanel>\n  );\n};\n\nDevtoolsOverviewContainer.displayName = 'DevtoolsOverviewContainer';\n"],"mappings":";;;;;;AAUA,IAAa,kCAAkC;CAC7C,MAAM,CAAC,OAAO,gBAAgB,SAAS;CACvC,MAAM,uBAAuB,QAAQ,iBAAiB;CACtD,MAAM,iBAAiB,QAAQ,WAAW;CAC1C,MAAM,uBAAuB,QAAQ,iBAAiB;CAGtD,MAAM,6BAA6B,kBAAkB;EACnD,uBAAuB;EACvB,QAAQ,aAAa;CACvB,GAAG,CAAC,oBAAoB,CAAC;CAmBzB,OACE,oBAAC,YAAD;EACS;EACP,sBAnBkB,cAAc;GAClC,MAAM,OAAO,IAAI,IAAI,eAAe,KAAK,WAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;GACxE,OAAO,qBAAqB,KAAK,SAAS;IACxC,MAAM,SAAS,KAAK,IAAI,KAAK,EAAE;IAC/B,OAAO,SACH;KACE,GAAG;KACH,YAAY,OAAO;KACnB,WAAW,OAAO;KAClB,QAAQ,OAAO;KACf,cAAc,OAAO;IACvB,IACA;GACN,CAAC;EACH,GAAG,CAAC,sBAAsB,cAAc,CAKd;EACtB,WAAW;EACX,wBAAwB;YAExB,oBAAC,QAAQ,SAAT,EAAiB,MAAM,WAAW,iBAAmB,CAAA;CAC3C,CAAA;AAEhB;AAEA,0BAA0B,cAAc"}

package/dist/lib/chunk-GithubPanel.mjs

@@ -0,0 +1,158 @@
+import { meta } from "#meta";
+import { createContext, useContext, useEffect, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { IconButton, ScrollArea, useTranslation } from "@dxos/react-ui";
+//#region src/containers/GithubPanel/GithubComponent.tsx
+var DEFAULT_REPO = "dxos/dxos";
+var DEFAULT_LIMIT = 20;
+var ComponentContext = createContext(null);
+var useComponentContext = () => {
+	const ctx = useContext(ComponentContext);
+	if (!ctx) throw new Error("GithubComponent.* parts must be rendered inside GithubComponent.Root.");
+	return ctx;
+};
+var Root = ({ repo = DEFAULT_REPO, limit = DEFAULT_LIMIT, children }) => {
+	const [pulls, setPulls] = useState([]);
+	const [unavailable, setUnavailable] = useState(false);
+	useEffect(() => {
+		const controller = new AbortController();
+		setPulls([]);
+		setUnavailable(false);
+		(async () => {
+			try {
+				const url = new URL(`https://api.github.com/repos/${repo}/pulls`);
+				url.searchParams.set("state", "closed");
+				url.searchParams.set("sort", "updated");
+				url.searchParams.set("direction", "desc");
+				url.searchParams.set("per_page", String(limit * 2));
+				const response = await fetch(url.toString(), {
+					signal: controller.signal,
+					headers: { Accept: "application/vnd.github+json" }
+				});
+				if (!response.ok) {
+					setUnavailable(true);
+					return;
+				}
+				const items = await response.json();
+				setPulls(items.filter((pull) => pull.merged_at !== null).slice(0, limit));
+				setUnavailable(false);
+			} catch {
+				if (controller.signal.aborted) return;
+				setPulls([]);
+				setUnavailable(true);
+			}
+		})();
+		return () => controller.abort();
+	}, [repo, limit]);
+	return /* @__PURE__ */ jsx(ComponentContext.Provider, {
+		value: {
+			repo,
+			pulls,
+			unavailable
+		},
+		children
+	});
+};
+var Header = () => {
+	const { t } = useTranslation(meta.profile.key);
+	const { repo, pulls, unavailable } = useComponentContext();
+	return /* @__PURE__ */ jsxs("header", {
+		className: "flex items-center justify-between gap-1 px-4 py-3 dx-modal-surface border-b border-subdued-separator",
+		children: [/* @__PURE__ */ jsxs("a", {
+			href: `https://github.com/${repo}`,
+			target: "_blank",
+			rel: "noopener noreferrer",
+			className: "text-sm font-medium truncate",
+			children: ["@", repo]
+		}), /* @__PURE__ */ jsx("div", {
+			className: "text-xs text-description",
+			children: unavailable ? t("github-unavailable.message") : pulls.length > 0 ? t("recent-prs.label", { count: pulls.length }) : t("github-loading.message")
+		})]
+	});
+};
+var RELATIVE_UNITS = [
+	["year", 3600 * 24 * 365],
+	["month", 3600 * 24 * 30],
+	["week", 3600 * 24 * 7],
+	["day", 3600 * 24],
+	["hour", 3600],
+	["minute", 60]
+];
+var formatRelative = (iso) => {
+	const formatter = new Intl.RelativeTimeFormat(void 0, { numeric: "auto" });
+	const diffSeconds = (Date.parse(iso) - Date.now()) / 1e3;
+	const absDiff = Math.abs(diffSeconds);
+	for (const [unit, secondsInUnit] of RELATIVE_UNITS) if (absDiff >= secondsInUnit) return formatter.format(Math.round(diffSeconds / secondsInUnit), unit);
+	return formatter.format(Math.round(diffSeconds), "second");
+};
+var PullRow = ({ pull }) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("a", {
+	href: pull.html_url,
+	target: "_blank",
+	rel: "noopener noreferrer",
+	className: "flex items-start gap-2 px-2 py-1 rounded-sm hover:bg-hover-surface",
+	children: [/* @__PURE__ */ jsx("img", {
+		src: pull.user.avatar_url,
+		alt: "",
+		className: "w-6 h-6 rounded-full shrink-0 mt-0.5"
+	}), /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col min-w-0 flex-1",
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "text-sm truncate",
+			children: pull.title
+		}), /* @__PURE__ */ jsxs("span", {
+			className: "text-xs text-description truncate",
+			children: [
+				"#",
+				pull.number,
+				" · ",
+				pull.user.login,
+				" · ",
+				pull.merged_at ? formatRelative(pull.merged_at) : ""
+			]
+		})]
+	})]
+}) });
+var Content = () => {
+	const { pulls } = useComponentContext();
+	return /* @__PURE__ */ jsx(ScrollArea.Root, {
+		orientation: "vertical",
+		children: /* @__PURE__ */ jsx(ScrollArea.Viewport, { children: /* @__PURE__ */ jsx("ul", {
+			className: "flex flex-col p-1",
+			children: pulls.map((pull) => /* @__PURE__ */ jsx(PullRow, { pull }, pull.number))
+		}) })
+	});
+};
+var StatusBar = () => {
+	const { t } = useTranslation(meta.profile.key);
+	const { repo } = useComponentContext();
+	return /* @__PURE__ */ jsx(IconButton, {
+		icon: "ph--github-logo--regular",
+		label: t("view-on-github.button"),
+		variant: "primary",
+		classNames: "w-full",
+		onClick: () => {
+			window.open(`https://github.com/${repo}`, "_blank", "noopener,noreferrer");
+		}
+	});
+};
+var GithubComponent = {
+	Root,
+	Header,
+	Content,
+	StatusBar
+};
+//#endregion
+//#region src/containers/GithubPanel/GithubPanel.tsx
+var GithubPanel = () => /* @__PURE__ */ jsx(GithubComponent.Root, { children: /* @__PURE__ */ jsxs("div", {
+	className: "h-full grid grid-rows-[auto_minmax(0,1fr)_auto] overflow-hidden h-full w-full",
+	children: [
+		/* @__PURE__ */ jsx(GithubComponent.Header, {}),
+		/* @__PURE__ */ jsx(GithubComponent.Content, {}),
+		/* @__PURE__ */ jsx(GithubComponent.StatusBar, {})
+	]
+}) });
+GithubPanel.displayName = "GithubPanel";
+//#endregion
+export { GithubPanel as default };
+
+//# sourceMappingURL=chunk-GithubPanel.mjs.map

package/dist/lib/chunk-GithubPanel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-GithubPanel.mjs","names":[],"sources":["../../src/containers/GithubPanel/GithubComponent.tsx","../../src/containers/GithubPanel/GithubPanel.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { type ReactNode, createContext, useContext, useEffect, useState } from 'react';\n\nimport { IconButton, ScrollArea, useTranslation } from '@dxos/react-ui';\n\nimport { meta } from '#meta';\n\nconst DEFAULT_REPO = 'dxos/dxos';\nconst DEFAULT_LIMIT = 20;\n\ntype GithubUser = {\n  login: string;\n  avatar_url: string;\n  html_url: string;\n};\n\ntype GithubPullRequest = {\n  number: number;\n  title: string;\n  html_url: string;\n  merged_at: string | null;\n  user: GithubUser;\n};\n\ntype ComponentContextValue = {\n  repo: string;\n  pulls: GithubPullRequest[];\n  unavailable: boolean;\n};\n\nconst ComponentContext = createContext<ComponentContextValue | null>(null);\n\nconst useComponentContext = () => {\n  const ctx = useContext(ComponentContext);\n  if (!ctx) {\n    throw new Error('GithubComponent.* parts must be rendered inside GithubComponent.Root.');\n  }\n  return ctx;\n};\n\nexport type GithubComponentRootProps = {\n  /** `<owner>/<name>`. Defaults to `dxos/dxos`. */\n  repo?: string;\n  /** Maximum number of merged PRs to fetch. */\n  limit?: number;\n  children?: ReactNode;\n};\n\nconst Root = ({ repo = DEFAULT_REPO, limit = DEFAULT_LIMIT, children }: GithubComponentRootProps) => {\n  const [pulls, setPulls] = useState<GithubPullRequest[]>([]);\n  const [unavailable, setUnavailable] = useState(false);\n\n  useEffect(() => {\n    const controller = new AbortController();\n    setPulls([]);\n    setUnavailable(false);\n    void (async () => {\n      try {\n        const url = new URL(`https://api.github.com/repos/${repo}/pulls`);\n        url.searchParams.set('state', 'closed');\n        url.searchParams.set('sort', 'updated');\n        url.searchParams.set('direction', 'desc');\n        url.searchParams.set('per_page', String(limit * 2));\n        const response = await fetch(url.toString(), {\n          signal: controller.signal,\n          headers: { Accept: 'application/vnd.github+json' },\n        });\n        if (!response.ok) {\n          setUnavailable(true);\n          return;\n        }\n        const items = (await response.json()) as GithubPullRequest[];\n        setPulls(items.filter((pull) => pull.merged_at !== null).slice(0, limit));\n        setUnavailable(false);\n      } catch {\n        if (controller.signal.aborted) {\n          return;\n        }\n        setPulls([]);\n        setUnavailable(true);\n      }\n    })();\n    return () => controller.abort();\n  }, [repo, limit]);\n\n  return <ComponentContext.Provider value={{ repo, pulls, unavailable }}>{children}</ComponentContext.Provider>;\n};\n\nconst Header = () => {\n  const { t } = useTranslation(meta.profile.key);\n  const { repo, pulls, unavailable } = useComponentContext();\n  return (\n    <header className='flex items-center justify-between gap-1 px-4 py-3 dx-modal-surface border-b border-subdued-separator'>\n      <a\n        href={`https://github.com/${repo}`}\n        target='_blank'\n        rel='noopener noreferrer'\n        className='text-sm font-medium truncate'\n      >\n        @{repo}\n      </a>\n      <div className='text-xs text-description'>\n        {unavailable\n          ? t('github-unavailable.message')\n          : pulls.length > 0\n            ? t('recent-prs.label', { count: pulls.length })\n            : t('github-loading.message')}\n      </div>\n    </header>\n  );\n};\n\nconst RELATIVE_UNITS: Array<[Intl.RelativeTimeFormatUnit, number]> = [\n  ['year', 60 * 60 * 24 * 365],\n  ['month', 60 * 60 * 24 * 30],\n  ['week', 60 * 60 * 24 * 7],\n  ['day', 60 * 60 * 24],\n  ['hour', 60 * 60],\n  ['minute', 60],\n];\n\nconst formatRelative = (iso: string): string => {\n  const formatter = new Intl.RelativeTimeFormat(undefined, { numeric: 'auto' });\n  const diffSeconds = (Date.parse(iso) - Date.now()) / 1000;\n  const absDiff = Math.abs(diffSeconds);\n  for (const [unit, secondsInUnit] of RELATIVE_UNITS) {\n    if (absDiff >= secondsInUnit) {\n      return formatter.format(Math.round(diffSeconds / secondsInUnit), unit);\n    }\n  }\n  return formatter.format(Math.round(diffSeconds), 'second');\n};\n\nconst PullRow = ({ pull }: { pull: GithubPullRequest }) => (\n  <li>\n    <a\n      href={pull.html_url}\n      target='_blank'\n      rel='noopener noreferrer'\n      className='flex items-start gap-2 px-2 py-1 rounded-sm hover:bg-hover-surface'\n    >\n      <img src={pull.user.avatar_url} alt='' className='w-6 h-6 rounded-full shrink-0 mt-0.5' />\n      <div className='flex flex-col min-w-0 flex-1'>\n        <span className='text-sm truncate'>{pull.title}</span>\n        <span className='text-xs text-description truncate'>\n          #{pull.number} · {pull.user.login} · {pull.merged_at ? formatRelative(pull.merged_at) : ''}\n        </span>\n      </div>\n    </a>\n  </li>\n);\n\nconst Content = () => {\n  const { pulls } = useComponentContext();\n  return (\n    <ScrollArea.Root orientation='vertical'>\n      <ScrollArea.Viewport>\n        <ul className='flex flex-col p-1'>\n          {pulls.map((pull) => (\n            <PullRow key={pull.number} pull={pull} />\n          ))}\n        </ul>\n      </ScrollArea.Viewport>\n    </ScrollArea.Root>\n  );\n};\n\nconst StatusBar = () => {\n  const { t } = useTranslation(meta.profile.key);\n  const { repo } = useComponentContext();\n  return (\n    <IconButton\n      icon='ph--github-logo--regular'\n      label={t('view-on-github.button')}\n      variant='primary'\n      classNames='w-full'\n      onClick={() => {\n        window.open(`https://github.com/${repo}`, '_blank', 'noopener,noreferrer');\n      }}\n    />\n  );\n};\n\nexport const GithubComponent = {\n  Root,\n  Header,\n  Content,\n  StatusBar,\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport React from 'react';\n\nimport { GithubComponent } from './GithubComponent';\n\nexport const GithubPanel = () => (\n  <GithubComponent.Root>\n    <div className='h-full grid grid-rows-[auto_minmax(0,1fr)_auto] overflow-hidden h-full w-full'>\n      <GithubComponent.Header />\n      <GithubComponent.Content />\n      <GithubComponent.StatusBar />\n    </div>\n  </GithubComponent.Root>\n);\n\nGithubPanel.displayName = 'GithubPanel';\n"],"mappings":"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"}

package/dist/lib/chunk-RegistryPanel.mjs

@@ -0,0 +1,124 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { JsonView, Placeholder, Searchbar } from "@dxos/devtools";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Entity, Format, Obj, Type } from "@dxos/echo";
+import { Panel, Toolbar } from "@dxos/react-ui";
+import { Operation } from "@dxos/compute";
+import { useClient } from "@dxos/react-client";
+import { DynamicTable } from "@dxos/react-ui-table";
+import { mx } from "@dxos/ui-theme";
+//#region src/containers/RegistryPanel/RegistryPanel.tsx
+var textFilter = (text) => {
+	if (!text) return () => true;
+	const matcher = new RegExp(text, "i");
+	return (entity) => {
+		return [
+			Entity.getTypename(entity) ?? "",
+			Obj.isObject(entity) ? Obj.getMeta(entity).key ?? "" : "",
+			Type.isType(entity) ? Type.getURI(entity)?.toString() ?? "" : "",
+			Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity) ? Operation.getKey(entity) ?? "" : "",
+			Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity) ? entity.name : "",
+			getEntityId(entity)
+		].some((value) => value.match(matcher));
+	};
+};
+var getEntityId = (entity) => {
+	if (entity.id) return entity.id;
+	if (Type.isType(entity)) return Type.getURI(entity)?.toString() ?? Type.getTypename(entity) ?? "unknown-type";
+	return Entity.getTypename(entity) ?? "unknown";
+};
+var getKind = (entity) => {
+	if (Type.isType(entity)) return "type";
+	if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) return "operation";
+	return "other";
+};
+var getLabel = (entity) => {
+	if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) return entity.name || Operation.getKey(entity) || getEntityId(entity);
+	if (Type.isType(entity)) return Type.getTypename(entity) ?? getEntityId(entity);
+	return getEntityId(entity);
+};
+var toDetailJson = (entity) => {
+	if (Type.isType(entity)) return {
+		id: getEntityId(entity),
+		typename: Type.getTypename(entity),
+		uri: Type.getURI(entity)?.toString(),
+		version: Type.getVersion(entity),
+		jsonSchema: entity.jsonSchema
+	};
+	if (Obj.isObject(entity)) return Obj.toJSON(entity);
+	return {
+		id: getEntityId(entity),
+		typename: Entity.getTypename(entity)
+	};
+};
+var RegistryPanel = () => {
+	const client = useClient();
+	const [entities, setEntities] = useState([]);
+	const [filter, setFilter] = useState("");
+	const [selected, setSelected] = useState();
+	useEffect(() => {
+		const registry = client.graph.registry;
+		const refresh = () => setEntities([...registry.list()]);
+		refresh();
+		return registry.changed.on(refresh);
+	}, [client]);
+	const properties = useMemo(() => [
+		{
+			name: "kind",
+			format: Format.TypeFormat.String,
+			size: 100
+		},
+		{
+			name: "label",
+			format: Format.TypeFormat.String
+		},
+		{
+			name: "id",
+			format: Format.TypeFormat.String,
+			size: 280
+		}
+	], []);
+	const rows = useMemo(() => {
+		return entities.filter(textFilter(filter)).map((entity) => ({
+			id: getEntityId(entity),
+			kind: getKind(entity),
+			label: getLabel(entity),
+			_entity: entity
+		})).toSorted((left, right) => left.label.localeCompare(right.label));
+	}, [entities, filter]);
+	const handleRowClicked = useCallback((row) => {
+		if (!row?._entity) return;
+		setSelected(row._entity);
+	}, []);
+	const detailJson = useMemo(() => selected ? toDetailJson(selected) : void 0, [selected]);
+	const features = useMemo(() => ({ selection: {
+		enabled: true,
+		mode: "single"
+	} }), []);
+	return /* @__PURE__ */ jsxs(Panel.Root, { children: [/* @__PURE__ */ jsx(Panel.Toolbar, {
+		asChild: true,
+		children: /* @__PURE__ */ jsx(Toolbar.Root, { children: /* @__PURE__ */ jsx(Searchbar, {
+			placeholder: "Filter...",
+			onChange: setFilter
+		}) })
+	}), /* @__PURE__ */ jsx(Panel.Content, { children: /* @__PURE__ */ jsxs("div", {
+		className: mx("h-full grid grid-cols-[2fr_1fr] overflow-hidden"),
+		children: [/* @__PURE__ */ jsx("div", {
+			className: mx("flex flex-col min-h-0 overflow-hidden"),
+			children: /* @__PURE__ */ jsx(DynamicTable, {
+				properties,
+				rows,
+				features,
+				onRowClick: handleRowClicked
+			})
+		}), /* @__PURE__ */ jsx("div", {
+			className: mx("min-h-0 h-full overflow-auto border-s border-separator text-sm"),
+			children: detailJson ? /* @__PURE__ */ jsx(JsonView, { data: detailJson }) : /* @__PURE__ */ jsx(Placeholder, { label: "Details" })
+		})]
+	}) })] });
+};
+RegistryPanel.displayName = "RegistryPanel";
+//#endregion
+export { RegistryPanel, RegistryPanel as default };
+
+//# sourceMappingURL=chunk-RegistryPanel.mjs.map

package/dist/lib/chunk-RegistryPanel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-RegistryPanel.mjs","names":[],"sources":["../../src/containers/RegistryPanel/RegistryPanel.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useEffect, useMemo, useState } from 'react';\n\nimport { Operation } from '@dxos/compute';\nimport { JsonView, Placeholder, Searchbar } from '@dxos/devtools';\nimport { Entity, Format, Obj, Type } from '@dxos/echo';\nimport { useClient } from '@dxos/react-client';\nimport { Panel, Toolbar } from '@dxos/react-ui';\nimport { DynamicTable, type TableFeatures } from '@dxos/react-ui-table';\nimport { mx } from '@dxos/ui-theme';\n\ntype RegistryRow = {\n  id: string;\n  kind: string;\n  label: string;\n  _entity: Entity.Unknown;\n};\n\nconst textFilter = (text?: string) => {\n  if (!text) {\n    return () => true;\n  }\n\n  const matcher = new RegExp(text, 'i');\n  return (entity: Entity.Unknown) => {\n    const typename = Entity.getTypename(entity) ?? '';\n    const metaKey = Obj.isObject(entity) ? (Obj.getMeta(entity).key ?? '') : '';\n    const uri = Type.isType(entity) ? (Type.getURI(entity)?.toString() ?? '') : '';\n    const operationKey =\n      Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)\n        ? (Operation.getKey(entity) ?? '')\n        : '';\n    const name = Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity) ? entity.name : '';\n    return [typename, metaKey, uri, operationKey, name, getEntityId(entity)].some((value) => value.match(matcher));\n  };\n};\n\nconst getEntityId = (entity: Entity.Unknown): string => {\n  if (entity.id) {\n    return entity.id;\n  }\n  if (Type.isType(entity)) {\n    return Type.getURI(entity)?.toString() ?? Type.getTypename(entity) ?? 'unknown-type';\n  }\n  return Entity.getTypename(entity) ?? 'unknown';\n};\n\nconst getKind = (entity: Entity.Unknown): string => {\n  if (Type.isType(entity)) {\n    return 'type';\n  }\n  if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) {\n    return 'operation';\n  }\n  return 'other';\n};\n\nconst getLabel = (entity: Entity.Unknown): string => {\n  if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) {\n    return entity.name || Operation.getKey(entity) || getEntityId(entity);\n  }\n  if (Type.isType(entity)) {\n    return Type.getTypename(entity) ?? getEntityId(entity);\n  }\n  return getEntityId(entity);\n};\n\nconst toDetailJson = (entity: Entity.Unknown): object => {\n  if (Type.isType(entity)) {\n    return {\n      id: getEntityId(entity),\n      typename: Type.getTypename(entity),\n      uri: Type.getURI(entity)?.toString(),\n      version: Type.getVersion(entity),\n      jsonSchema: entity.jsonSchema,\n    };\n  }\n  if (Obj.isObject(entity)) {\n    return Obj.toJSON(entity);\n  }\n  return { id: getEntityId(entity), typename: Entity.getTypename(entity) };\n};\n\nexport const RegistryPanel = () => {\n  const client = useClient();\n  const [entities, setEntities] = useState<Entity.Unknown[]>([]);\n  const [filter, setFilter] = useState('');\n  const [selected, setSelected] = useState<Entity.Unknown>();\n\n  useEffect(() => {\n    const registry = client.graph.registry;\n    const refresh = () => setEntities([...registry.list()]);\n    refresh();\n    return registry.changed.on(refresh);\n  }, [client]);\n\n  const properties = useMemo(\n    () => [\n      { name: 'kind', format: Format.TypeFormat.String, size: 100 },\n      { name: 'label', format: Format.TypeFormat.String },\n      { name: 'id', format: Format.TypeFormat.String, size: 280 },\n    ],\n    [],\n  );\n\n  const rows = useMemo((): RegistryRow[] => {\n    return entities\n      .filter(textFilter(filter))\n      .map((entity) => ({\n        id: getEntityId(entity),\n        kind: getKind(entity),\n        label: getLabel(entity),\n        _entity: entity,\n      }))\n      .toSorted((left, right) => left.label.localeCompare(right.label));\n  }, [entities, filter]);\n\n  const handleRowClicked = useCallback((row: RegistryRow | undefined) => {\n    if (!row?._entity) {\n      return;\n    }\n    setSelected(row._entity);\n  }, []);\n\n  const detailJson = useMemo(() => (selected ? toDetailJson(selected) : undefined), [selected]);\n\n  const features: Partial<TableFeatures> = useMemo(() => ({ selection: { enabled: true, mode: 'single' } }), []);\n\n  return (\n    <Panel.Root>\n      <Panel.Toolbar asChild>\n        <Toolbar.Root>\n          <Searchbar placeholder='Filter...' onChange={setFilter} />\n        </Toolbar.Root>\n      </Panel.Toolbar>\n      <Panel.Content>\n        <div className={mx('h-full grid grid-cols-[2fr_1fr] overflow-hidden')}>\n          <div className={mx('flex flex-col min-h-0 overflow-hidden')}>\n            <DynamicTable properties={properties} rows={rows} features={features} onRowClick={handleRowClicked} />\n          </div>\n          <div className={mx('min-h-0 h-full overflow-auto border-s border-separator text-sm')}>\n            {detailJson ? <JsonView data={detailJson} /> : <Placeholder label='Details' />}\n          </div>\n        </div>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nRegistryPanel.displayName = 'RegistryPanel';\n"],"mappings":"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"}