@dxos/plugin-debug 0.10.0 → 0.11.1

package/src/translations.ts

@@ -1,26 +1,25 @@
 //
-// Copyright 2023 DXOS.org
+// Copyright 2026 DXOS.org
 //
 
 import { type Resource } from '@dxos/react-ui';
-import { translations as introspectTranslations } from '@dxos/react-ui-introspect/translations';
+import { translations as logPanelTranslations } from '@dxos/react-ui-debug/translations';
 
 import { meta } from '#meta';
 
 export const translations = [
-  ...introspectTranslations,
+  // The R0 log companion and status popover render `@dxos/react-ui-debug`, so its namespace must be registered.
+  ...logPanelTranslations,
   {
     'en-US': {
       [meta.profile.key]: {
         'plugin.name': 'Debug',
-        'open-devtools.label': 'Open DevTools',
-        'devtools.label': 'DevTools',
-        'devtools-overview.label': 'Stats',
-        'space-objects.label': 'Database',
         'debug.label': 'Debug',
         'generate-objects.label': 'Generate Objects',
-        'debug-app-graph.label': 'App Graph',
-        'debug-tools-explorer.label': 'SDK Explorer',
+        'space-objects.label': 'Database',
+        'open-debug-panel.label': 'Show Debug',
+        'logs.label': 'Logs',
+        'open-logs.label': 'Show logs',
 
         'settings.wireframe.label': 'Show wireframes.',
         'settings.wireframe.description': 'Overlay wireframe outlines on UI components for debugging layout.',
@@ -50,49 +49,6 @@ export const translations = [
           'Warning: Swapping the storage adapter will make your data unavailable.',
 
         'settings.data-store.label': 'Data Store',
-
-        'reset-data.label': 'Reset data (ERASES ALL DATA)',
-        'open-debug-panel.label': 'Show Debug',
-        'client.label': 'Client',
-        'config.label': 'Config',
-        'storage.label': 'Storage',
-        'sqlite.label': 'SQLite',
-        'logs.label': 'Logs',
-        'diagnostics.label': 'Diagnostics',
-        'tracing.label': 'Tracing',
-        'halo.label': 'HALO',
-        'identity.label': 'Identity',
-        'devices.label': 'Devices',
-        'keyring.label': 'Keyring',
-        'credentials.label': 'Credentials',
-        'echo.label': 'ECHO',
-        'spaces.label': 'Spaces',
-        'space.label': 'Space',
-        'feeds.label': 'Feeds',
-        'objects.label': 'Objects',
-        'schema.label': 'Schema',
-        'registry.label': 'Registry',
-        'automerge.label': 'Automerge',
-        'queues.label': 'Queues',
-        'members.label': 'Members',
-        'metadata.label': 'Metadata',
-        'mesh.label': 'MESH',
-        'signal.label': 'Signal',
-        'swarm.label': 'Swarm',
-        'network.label': 'Network',
-        'agent.label': 'Agent',
-        'dashboard.label': 'Dashboard',
-        'search.label': 'Search',
-        'edge.label': 'EDGE',
-        'workflows.label': 'Workflows',
-        'traces.label': 'Traces',
-        'testing.label': 'Testing',
-        // GitHub (deck-companion--github surface).
-        'github-loading.message': 'Loading…',
-        'github-unavailable.message': 'GitHub feed unavailable.',
-        'recent-prs.label_one': '{{count}} recent PR',
-        'recent-prs.label_other': '{{count}} recent PRs',
-        'view-on-github.button': 'View on GitHub',
       },
     },
   },

package/src/types/DebugNodes.ts

@@ -0,0 +1,18 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// @import-as-namespace
+
+import { meta } from '#meta';
+
+/** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */
+export const nodeId = (fullId: string): string => fullId.split('.').at(-1) ?? '';
+
+const debugId = meta.profile.key;
+
+/** Top-level Debug node (sibling of DevTools under the SYSTEM navtree group). */
+export const id = `${debugId}.debug`;
+
+/** Discriminator for the space-generator article surface (`node.data.type`). */
+export const SpaceType = `${debugId}.space`;

package/src/types/DebugSurface.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// @import-as-namespace
+
+import { Role } from '@dxos/app-framework';
+
+import { meta } from '#meta';
+
+/**
+ * Role token for the transient-stats panel — renders the {@link AppCapabilities.StatsPanel} store
+ * (arbitrary reactive telemetry keyed by owner id). A layout targets this role (role-only dispatch);
+ * the surface reads the store directly, so it needs no subject.
+ */
+export const Stats = Role.make<Record<string, unknown>>(`${meta.profile.key}.surface.stats`);

package/src/types/debug.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type Atom } from '@effect-atom/atom-react';
+import { type Atom } from '@effect-atom/atom';
 import { type Context, createContext } from 'react';
 
 import { Capability } from '@dxos/app-framework';
@@ -16,6 +16,8 @@ import * as Settings from './Settings';
 export type DebugPluginOptions = {
   /** Shared persistent log store for capturing and downloading logs. */
   logStore?: IdbLogStore;
+  /** Persist the stats-panel store to localStorage so it survives a reload. Defaults to `true`. */
+  persistStats?: boolean;
 };
 
 export type DebugContextType = {

package/src/types/index.ts

@@ -1,8 +1,8 @@
 //
-// Copyright 2023 DXOS.org
+// Copyright 2026 DXOS.org
 //
 
 export * from './debug';
-export * from './surface';
-export * as Devtools from './Devtools';
+export * as DebugNodes from './DebugNodes';
+export * as DebugSurface from './DebugSurface';
 export * as Settings from './Settings';

package/dist/lib/neutral/DebugGraph-G4FWS57E.mjs

@@ -1,15 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/containers/DebugGraph/DebugGraph.tsx
-import React from "react";
-import { Tree } from "@dxos/devtools";
-import { Graph } from "@dxos/plugin-graph";
-var DebugGraph = ({ graph, root }) => {
-  return /* @__PURE__ */ React.createElement(Tree, {
-    data: Graph.toJSON(graph, root)
-  });
-};
-export {
-  DebugGraph as default
-};
-//# sourceMappingURL=DebugGraph-G4FWS57E.mjs.map

package/dist/lib/neutral/DebugGraph-G4FWS57E.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "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';\n\nexport type DebugGraphProps = { graph: Graph.Graph; root: string };\n\nexport const DebugGraph = ({ graph, root }: DebugGraphProps) => {\n  return <Tree data={Graph.toJSON(graph, root)} />;\n};\n"],
-  "mappings": ";;;AAIA,OAAOA,WAAW;AAElB,SAASC,YAAY;AACrB,SAASC,aAAa;AAIf,IAAMC,aAAa,CAAC,EAAEC,OAAOC,KAAI,MAAmB;AACzD,SAAO,sBAAA,cAACJ,MAAAA;IAAKK,MAAMJ,MAAMK,OAAOH,OAAOC,IAAAA;;AACzC;",
-  "names": ["React", "Tree", "Graph", "DebugGraph", "graph", "root", "data", "toJSON"]
-}

package/dist/lib/neutral/DebugObjectPanel-QSGQJ3LM.mjs

@@ -1,61 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/containers/DebugObjectPanel/DebugObjectPanel.tsx
-import React, { useMemo, useState } from "react";
-import { ObjectsTree } from "@dxos/devtools";
-import { Filter, Json, Obj, Query } from "@dxos/echo";
-import { useQuery } from "@dxos/react-client/echo";
-import { Clipboard, Input, Panel, ScrollArea, Toolbar } from "@dxos/react-ui";
-import { Syntax } from "@dxos/react-ui-syntax-highlighter";
-import { mx } from "@dxos/ui-theme";
-var DebugObjectPanel = ({ role, companionTo, onOpen, canOpen }) => {
-  const db = Obj.getDatabase(companionTo);
-  const [selectedId, setSelectedId] = useState(null);
-  const [depth, setDepth] = useState(0);
-  const [selectedObject] = useQuery(db, Query.select(Filter.id(selectedId ?? companionTo.id)).options({
-    deleted: "include"
-  }));
-  const refReplacer = useMemo(() => db ? Json.createRefReplacer({
-    db,
-    depth
-  }) : void 0, [
-    db,
-    depth
-  ]);
-  return /* @__PURE__ */ React.createElement(Clipboard.Provider, null, /* @__PURE__ */ React.createElement(Panel.Root, {
-    role
-  }, /* @__PURE__ */ React.createElement(Panel.Toolbar, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement(Toolbar.Root, null)), /* @__PURE__ */ React.createElement(Panel.Content, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement("div", {
-    className: mx("grid divide-y divide-separator", db && "grid-rows-[1fr_2fr]")
-  }, db && /* @__PURE__ */ React.createElement(ScrollArea.Root, null, /* @__PURE__ */ React.createElement(ScrollArea.Viewport, null, /* @__PURE__ */ React.createElement(ObjectsTree, {
-    db,
-    root: companionTo,
-    onSelect: (entity) => setSelectedId(entity.id),
-    onOpen,
-    canOpen
-  }))), /* @__PURE__ */ React.createElement(Syntax.Root, {
-    data: selectedObject,
-    replacer: refReplacer
-  }, /* @__PURE__ */ React.createElement(Panel.Root, null, /* @__PURE__ */ React.createElement(Panel.Toolbar, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement(Toolbar.Root, {
-    classNames: "grid grid-cols-[1fr_3rem]"
-  }, /* @__PURE__ */ React.createElement(Syntax.Filter, null), /* @__PURE__ */ React.createElement(Input.Root, null, /* @__PURE__ */ React.createElement(Input.TextInput, {
-    variant: "subdued",
-    type: "number",
-    min: 0,
-    step: 1,
-    "aria-label": "Ref depth",
-    value: depth,
-    onChange: (event) => setDepth(Math.max(0, Number(event.target.value) || 0))
-  })))), /* @__PURE__ */ React.createElement(Panel.Content, {
-    asChild: true
-  }, /* @__PURE__ */ React.createElement(Syntax.Viewport, null, /* @__PURE__ */ React.createElement(Syntax.Code, null)))))))));
-};
-export {
-  DebugObjectPanel as default
-};
-//# sourceMappingURL=DebugObjectPanel-QSGQJ3LM.mjs.map

package/dist/lib/neutral/DebugObjectPanel-QSGQJ3LM.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/containers/DebugObjectPanel/DebugObjectPanel.tsx"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport React, { useMemo, useState } from 'react';\n\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { ObjectsTree } from '@dxos/devtools';\nimport { type Entity, Filter, Json, Obj, Query } from '@dxos/echo';\nimport type { EntityId } from '@dxos/keys';\nimport { useQuery } from '@dxos/react-client/echo';\nimport { Clipboard, Input, Panel, ScrollArea, Toolbar } from '@dxos/react-ui';\nimport { Syntax } from '@dxos/react-ui-syntax-highlighter';\nimport { mx } from '@dxos/ui-theme';\n\nexport type DebugObjectPanelProps = Pick<\n  AppSurface.ObjectArticleProps<Obj.Unknown, {}, Obj.Unknown>,\n  'role' | 'companionTo'\n> & {\n  onOpen?: (object: Obj.Unknown) => void;\n  canOpen?: (entity: Entity.Snapshot) => boolean;\n};\n\nexport const DebugObjectPanel = ({ role, companionTo, onOpen, canOpen }: DebugObjectPanelProps) => {\n  const db = Obj.getDatabase(companionTo);\n  const [selectedId, setSelectedId] = useState<EntityId | null>(null);\n  const [depth, setDepth] = useState(0);\n  const [selectedObject] = useQuery(\n    db,\n    Query.select(Filter.id(selectedId ?? companionTo.id)).options({ deleted: 'include' }),\n  );\n  const refReplacer = useMemo(() => (db ? Json.createRefReplacer({ db, depth }) : undefined), [db, depth]);\n\n  return (\n    <Clipboard.Provider>\n      <Panel.Root role={role}>\n        <Panel.Toolbar asChild>\n          <Toolbar.Root />\n        </Panel.Toolbar>\n        <Panel.Content asChild>\n          <div className={mx('grid divide-y divide-separator', db && 'grid-rows-[1fr_2fr]')}>\n            {db && (\n              <ScrollArea.Root>\n                <ScrollArea.Viewport>\n                  <ObjectsTree\n                    db={db}\n                    root={companionTo}\n                    onSelect={(entity) => setSelectedId(entity.id)}\n                    onOpen={onOpen}\n                    canOpen={canOpen}\n                  />\n                </ScrollArea.Viewport>\n              </ScrollArea.Root>\n            )}\n            <Syntax.Root data={selectedObject} replacer={refReplacer}>\n              <Panel.Root>\n                <Panel.Toolbar asChild>\n                  <Toolbar.Root classNames='grid grid-cols-[1fr_3rem]'>\n                    <Syntax.Filter />\n                    <Input.Root>\n                      <Input.TextInput\n                        variant='subdued'\n                        type='number'\n                        min={0}\n                        step={1}\n                        aria-label='Ref depth'\n                        value={depth}\n                        onChange={(event) => setDepth(Math.max(0, Number(event.target.value) || 0))}\n                      />\n                    </Input.Root>\n                  </Toolbar.Root>\n                </Panel.Toolbar>\n                <Panel.Content asChild>\n                  <Syntax.Viewport>\n                    <Syntax.Code />\n                  </Syntax.Viewport>\n                </Panel.Content>\n              </Panel.Root>\n            </Syntax.Root>\n          </div>\n        </Panel.Content>\n      </Panel.Root>\n    </Clipboard.Provider>\n  );\n};\n"],
-  "mappings": ";;;AAIA,OAAOA,SAASC,SAASC,gBAAgB;AAGzC,SAASC,mBAAmB;AAC5B,SAAsBC,QAAQC,MAAMC,KAAKC,aAAa;AAEtD,SAASC,gBAAgB;AACzB,SAASC,WAAWC,OAAOC,OAAOC,YAAYC,eAAe;AAC7D,SAASC,cAAc;AACvB,SAASC,UAAU;AAUZ,IAAMC,mBAAmB,CAAC,EAAEC,MAAMC,aAAaC,QAAQC,QAAO,MAAyB;AAC5F,QAAMC,KAAKf,IAAIgB,YAAYJ,WAAAA;AAC3B,QAAM,CAACK,YAAYC,aAAAA,IAAiBtB,SAA0B,IAAA;AAC9D,QAAM,CAACuB,OAAOC,QAAAA,IAAYxB,SAAS,CAAA;AACnC,QAAM,CAACyB,cAAAA,IAAkBnB,SACvBa,IACAd,MAAMqB,OAAOxB,OAAOyB,GAAGN,cAAcL,YAAYW,EAAE,CAAA,EAAGC,QAAQ;IAAEC,SAAS;EAAU,CAAA,CAAA;AAErF,QAAMC,cAAc/B,QAAQ,MAAOoB,KAAKhB,KAAK4B,kBAAkB;IAAEZ;IAAII;EAAM,CAAA,IAAKS,QAAY;IAACb;IAAII;GAAM;AAEvG,SACE,sBAAA,cAAChB,UAAU0B,UAAQ,MACjB,sBAAA,cAACxB,MAAMyB,MAAI;IAACnB;KACV,sBAAA,cAACN,MAAME,SAAO;IAACwB,SAAAA;KACb,sBAAA,cAACxB,QAAQuB,MAAI,IAAA,CAAA,GAEf,sBAAA,cAACzB,MAAM2B,SAAO;IAACD,SAAAA;KACb,sBAAA,cAACE,OAAAA;IAAIC,WAAWzB,GAAG,kCAAkCM,MAAM,qBAAA;KACxDA,MACC,sBAAA,cAACT,WAAWwB,MAAI,MACd,sBAAA,cAACxB,WAAW6B,UAAQ,MAClB,sBAAA,cAACtC,aAAAA;IACCkB;IACAqB,MAAMxB;IACNyB,UAAU,CAACC,WAAWpB,cAAcoB,OAAOf,EAAE;IAC7CV;IACAC;QAKR,sBAAA,cAACN,OAAOsB,MAAI;IAACS,MAAMlB;IAAgBmB,UAAUd;KAC3C,sBAAA,cAACrB,MAAMyB,MAAI,MACT,sBAAA,cAACzB,MAAME,SAAO;IAACwB,SAAAA;KACb,sBAAA,cAACxB,QAAQuB,MAAI;IAACW,YAAW;KACvB,sBAAA,cAACjC,OAAOV,QAAM,IAAA,GACd,sBAAA,cAACM,MAAM0B,MAAI,MACT,sBAAA,cAAC1B,MAAMsC,WAAS;IACdC,SAAQ;IACRC,MAAK;IACLC,KAAK;IACLC,MAAM;IACNC,cAAW;IACXC,OAAO7B;IACP8B,UAAU,CAACC,UAAU9B,SAAS+B,KAAKC,IAAI,GAAGC,OAAOH,MAAMI,OAAON,KAAK,KAAK,CAAA,CAAA;SAKhF,sBAAA,cAAC3C,MAAM2B,SAAO;IAACD,SAAAA;KACb,sBAAA,cAACvB,OAAO2B,UAAQ,MACd,sBAAA,cAAC3B,OAAO+C,MAAI,IAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AAUhC;",
-  "names": ["React", "useMemo", "useState", "ObjectsTree", "Filter", "Json", "Obj", "Query", "useQuery", "Clipboard", "Input", "Panel", "ScrollArea", "Toolbar", "Syntax", "mx", "DebugObjectPanel", "role", "companionTo", "onOpen", "canOpen", "db", "getDatabase", "selectedId", "setSelectedId", "depth", "setDepth", "selectedObject", "select", "id", "options", "deleted", "refReplacer", "createRefReplacer", "undefined", "Provider", "Root", "asChild", "Content", "div", "className", "Viewport", "root", "onSelect", "entity", "data", "replacer", "classNames", "TextInput", "variant", "type", "min", "step", "aria-label", "value", "onChange", "event", "Math", "max", "Number", "target", "Code"]
-}

package/dist/lib/neutral/DebugPlugin.mjs

@@ -1,59 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/DebugPlugin.tsx
-import * as Effect from "effect/Effect";
-import { ActivationEvents, Capability, Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { AppGraphBuilder, DebugSettings, ReactContext, ReactSurface } from "#capabilities";
-import { meta } from "#meta";
-import { translations } from "#translations";
-
-// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-debug/PLUGIN.mdl
-var PLUGIN_default = '---\nid: org.dxos.plugin.debug\nname: DebugPlugin\nversion: 0.1.0\n---\n\nDeveloper toolkit plugin for `DXOS` Composer \u2014 real-time object inspection, structured devtools panels for Client/HALO/ECHO/Mesh/EDGE subsystems, space data generation, wireframe overlays, a tools explorer, and downloadable log capture.\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    \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\u2510\n    \u2502  Client  \u25B8 Config / Storage \u2502\n    \u2502            Logs / Diag      \u2502\n    \u2502  HALO    \u25B8 Identity / Keys  \u2502\n    \u2502  ECHO    \u25B8 Spaces / Feeds   \u2502\n    \u2502            Objects / Schema \u2502\n    \u2502  Mesh    \u25B8 Signal / Swarm   \u2502\n    \u2502  EDGE    \u25B8 Dashboard / \u2026    \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\u2518\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';
-
-// src/DebugPlugin.tsx
-var DebugPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({
-  activate: AppGraphBuilder
-}), AppPlugin.addReactContextModule({
-  activate: ReactContext
-}), AppPlugin.addSettingsModule({
-  activate: DebugSettings
-}), Plugin.addModule(({ logStore }) => ({
-  id: Capability.getModuleTag(ReactSurface) ?? "surfaces",
-  activatesOn: ActivationEvents.SetupReactSurface,
-  activate: () => ReactSurface({
-    logStore
-  })
-})), 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: PLUGIN_default,
-    mimeType: "application/x-mdl"
-  }
-}), Plugin.make);
-var setupDevtools = () => {
-  globalThis.composer ??= {};
-  globalThis.composer.changeStorageVersionInMetadata = async (version) => {
-    const { changeStorageVersionInMetadata } = await import("@dxos/echo-host/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 = "/";
-  };
-};
-var DebugPlugin_default = DebugPlugin;
-export {
-  DebugPlugin,
-  DebugPlugin_default as default
-};
-//# sourceMappingURL=DebugPlugin.mjs.map

package/dist/lib/neutral/DebugPlugin.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/DebugPlugin.tsx", "raw-loader:/__w/dxos/dxos/packages/plugins/plugin-debug/PLUGIN.mdl"],
-  "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, DebugSettings, ReactContext, ReactSurface } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { type DebugPluginOptions } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\n// TODO(wittjosiah): Factor out DevtoolsPlugin?\n\nexport const DebugPlugin = Plugin.define<DebugPluginOptions>(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addReactContextModule({ activate: ReactContext }),\n  AppPlugin.addSettingsModule({ activate: DebugSettings }),\n  Plugin.addModule(({ logStore }) => ({\n    id: Capability.getModuleTag(ReactSurface) ?? 'surfaces',\n    activatesOn: ActivationEvents.SetupReactSurface,\n    activate: () => ReactSurface({ logStore }),\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/echo-host/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 DebugPlugin;\n", "---\nid: org.dxos.plugin.debug\nname: DebugPlugin\nversion: 0.1.0\n---\n\nDeveloper toolkit plugin for `DXOS` Composer \u2014 real-time object inspection, structured devtools panels for Client/HALO/ECHO/Mesh/EDGE subsystems, space data generation, wireframe overlays, a tools explorer, and downloadable log capture.\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    \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\u2510\n    \u2502  Client  \u25B8 Config / Storage \u2502\n    \u2502            Logs / Diag      \u2502\n    \u2502  HALO    \u25B8 Identity / Keys  \u2502\n    \u2502  ECHO    \u25B8 Spaces / Feeds   \u2502\n    \u2502            Objects / Schema \u2502\n    \u2502  Mesh    \u25B8 Signal / Swarm   \u2502\n    \u2502  EDGE    \u25B8 Dashboard / \u2026    \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\u2518\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"],
-  "mappings": ";;;AAIA,YAAYA,YAAY;AAExB,SAASC,kBAAkBC,YAAYC,cAAc;AACrD,SAASC,iBAAiB;AAG1B,SAASC,iBAAiBC,eAAeC,cAAcC,oBAAoB;AAC3E,SAASC,YAAY;AACrB,SAASC,oBAAoB;;;ACZ7B;;;ADoBO,IAAMC,cAAcC,OAAOC,OAA2BC,IAAAA,EAAMC,KACjEC,UAAUC,kBAAkB;EAAEC,UAAUC;AAAgB,CAAA,GACxDH,UAAUI,sBAAsB;EAAEF,UAAUG;AAAa,CAAA,GACzDL,UAAUM,kBAAkB;EAAEJ,UAAUK;AAAc,CAAA,GACtDX,OAAOY,UAAU,CAAC,EAAEC,SAAQ,OAAQ;EAClCC,IAAIC,WAAWC,aAAaC,YAAAA,KAAiB;EAC7CC,aAAaC,iBAAiBC;EAC9Bd,UAAU,MAAMW,aAAa;IAAEJ;EAAS,CAAA;AAC1C,EAAA,GACAT,UAAUiB,sBAAsB;EAAEC;AAAa,CAAA,GAC/CtB,OAAOY,UAAU;EACfE,IAAI;EACJI,aAAaC,iBAAiBI;EAC9BjB,UAAU,MAAakB,YAAK,MAAMC,cAAAA,CAAAA;AACpC,CAAA,GACArB,UAAUsB,qBAAqB;EAC7BC,OAAO;IAAEC,UAAU1B,KAAK2B,QAAQC;IAAKC,MAAM;IAAcC,SAASC;IAAYC,UAAU;EAAoB;AAC9G,CAAA,GACAlC,OAAOmC,IAAI;AAGb,IAAMV,gBAAgB,MAAA;AACnBW,aAAmBC,aAAa,CAAC;AAGjCD,aAAmBC,SAASC,iCAAiC,OAAOC,YAAAA;AACnE,UAAM,EAAED,+BAA8B,IAAK,MAAM,OAAO,yBAAA;AACxD,UAAM,EAAEE,qBAAoB,IAAK,MAAM,OAAO,uBAAA;AAC9C,UAAMC,SAAkBC,OAAeC,KAAKF;AAC5C,UAAMG,SAASH,OAAOG;AACtB,UAAMH,OAAOI,QAAO;AACpB,UAAM,EAAEC,QAAO,IAAKN,qBAAqBI,OAAOG,QAAQC,SAASP,QAAQK,WAAW,CAAC,CAAA;AACrF,UAAMR,+BAA+BQ,SAASP,OAAAA;AAC9CU,aAASC,WAAW;EACtB;AACF;AAEA,IAAA,sBAAenD;",
-  "names": ["Effect", "ActivationEvents", "Capability", "Plugin", "AppPlugin", "AppGraphBuilder", "DebugSettings", "ReactContext", "ReactSurface", "meta", "translations", "DebugPlugin", "Plugin", "define", "meta", "pipe", "AppPlugin", "addAppGraphModule", "activate", "AppGraphBuilder", "addReactContextModule", "ReactContext", "addSettingsModule", "DebugSettings", "addModule", "logStore", "id", "Capability", "getModuleTag", "ReactSurface", "activatesOn", "ActivationEvents", "SetupReactSurface", "addTranslationsModule", "translations", "Startup", "sync", "setupDevtools", "addPluginAssetModule", "asset", "pluginId", "profile", "key", "path", "content", "pluginSpec", "mimeType", "make", "globalThis", "composer", "changeStorageVersionInMetadata", "version", "createStorageObjects", "client", "window", "dxos", "config", "destroy", "storage", "values", "runtime", "location", "pathname"]
-}

package/dist/lib/neutral/DebugPlugin.node.mjs

@@ -1,18 +0,0 @@
-import "./chunk-J5LGTIGS.mjs";
-
-// src/DebugPlugin.node.ts
-import { Plugin } from "@dxos/app-framework";
-import { AppPlugin } from "@dxos/app-toolkit";
-import { AppGraphBuilder, DebugSettings } from "#capabilities";
-import { meta } from "#meta";
-var DebugPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({
-  activate: AppGraphBuilder
-}), AppPlugin.addSettingsModule({
-  activate: DebugSettings
-}), Plugin.make);
-var DebugPlugin_node_default = DebugPlugin;
-export {
-  DebugPlugin,
-  DebugPlugin_node_default as default
-};
-//# sourceMappingURL=DebugPlugin.node.mjs.map

package/dist/lib/neutral/DebugPlugin.node.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/DebugPlugin.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, DebugSettings } from '#capabilities';\nimport { meta } from '#meta';\nimport { type DebugPluginOptions } from '#types';\n\nexport const DebugPlugin = Plugin.define<DebugPluginOptions>(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addSettingsModule({ activate: DebugSettings }),\n  Plugin.make,\n);\n\nexport default DebugPlugin;\n"],
-  "mappings": ";;;AAIA,SAASA,cAAc;AACvB,SAASC,iBAAiB;AAE1B,SAASC,iBAAiBC,qBAAqB;AAC/C,SAASC,YAAY;AAGd,IAAMC,cAAcL,OAAOM,OAA2BF,IAAAA,EAAMG,KACjEN,UAAUO,kBAAkB;EAAEC,UAAUP;AAAgB,CAAA,GACxDD,UAAUS,kBAAkB;EAAED,UAAUN;AAAc,CAAA,GACtDH,OAAOW,IAAI;AAGb,IAAA,2BAAeN;",
-  "names": ["Plugin", "AppPlugin", "AppGraphBuilder", "DebugSettings", "meta", "DebugPlugin", "define", "pipe", "addAppGraphModule", "activate", "addSettingsModule", "make"]
-}

package/dist/lib/neutral/DebugPlugin.workerd.mjs

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

package/dist/lib/neutral/DebugPlugin.workerd.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/DebugPlugin.workerd.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\nimport { type DebugPluginOptions } from '#types';\n\nexport const DebugPlugin = Plugin.define<DebugPluginOptions>(meta).pipe(Plugin.make);\n\nexport default DebugPlugin;\n"],
-  "mappings": ";;;AAIA,SAASA,cAAc;AAEvB,SAASC,YAAY;AAGd,IAAMC,cAAcF,OAAOG,OAA2BF,IAAAA,EAAMG,KAAKJ,OAAOK,IAAI;AAEnF,IAAA,8BAAeH;",
-  "names": ["Plugin", "meta", "DebugPlugin", "define", "pipe", "make"]
-}