@dxos/plugin-debug 0.10.0 → 0.11.1

package/dist/lib/chunk-react-surface.mjs

@@ -0,0 +1,193 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { Position } from "@dxos/util";
+import { useCallback, useMemo } from "react";
+import { meta } from "#meta";
+import { AppAnnotation, AppCapabilities, GraphPath, LayoutOperation } from "@dxos/app-toolkit";
+import { Panel } from "@dxos/react-ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Annotation, Collection, Entity, Filter, Obj, Type } from "@dxos/echo";
+import { SpaceCapabilities, SpaceOperation } from "@dxos/plugin-space";
+import * as Effect from "effect/Effect";
+import { DebugCapabilities, DebugNodes, DebugSurface } from "#types";
+import { Logger } from "@dxos/react-ui-debug";
+import { Surface, useAtomCapability, useOperationInvoker, useSettingsState } from "@dxos/app-framework/ui";
+import { AppSurface, useActiveSpace } from "@dxos/app-toolkit/ui";
+import { SpaceState, isSpace } from "@dxos/react-client/echo";
+import { DebugObjectPanel, DebugSettings, DebugSpaceObjectsPanel, DebugStatus, LogStatus, SpaceGenerator, StatsPanel, Wireframe } from "#containers";
+import { useAtomValue } from "@effect-atom/atom-react";
+import * as Option from "effect/Option";
+import { HiddenAnnotation } from "@dxos/echo/Annotation";
+import { useClient } from "@dxos/react-client";
+//#region src/capabilities/DebugSurfaces.tsx
+/** Returns `onOpen` and `canOpen` for the ObjectsTree "Open" action. */
+var useObjectOpenAction = (invokePromise) => {
+	const client = useClient();
+	const showHidden = useAtomCapability(SpaceCapabilities.Settings)?.showHidden ?? false;
+	const allTypes = useAtomValue(useMemo(() => client.graph.registry.query(Filter.type(Type.Type)).atom, [client]));
+	const hiddenTypenames = useMemo(() => {
+		const result = /* @__PURE__ */ new Set();
+		for (const typeEntity of allTypes) {
+			const schema = Type.getSchema(typeEntity);
+			if (HiddenAnnotation.get(schema).pipe(Option.getOrElse(() => false))) result.add(Type.getTypename(typeEntity));
+		}
+		return result;
+	}, [allTypes]);
+	return {
+		onOpen: useCallback((object) => {
+			invokePromise(LayoutOperation.Open, { subject: [GraphPath.getObjectPathFromObject(object)] });
+		}, [invokePromise]),
+		canOpen: useCallback((entity) => {
+			if (showHidden) return true;
+			const typename = Entity.getTypename(entity);
+			return !hiddenTypenames.has(typename ?? "");
+		}, [showHidden, hiddenTypenames])
+	};
+};
+var DebugSettingsSurface = ({ subject, logStore, onUpload }) => {
+	const { settings, updateSettings } = useSettingsState(subject.atom);
+	return /* @__PURE__ */ jsx(DebugSettings, {
+		settings,
+		onSettingsChange: updateSettings,
+		logStore,
+		onUpload
+	});
+};
+/** Generated objects are added to the space's root collection, resolved at invocation time. */
+var SpaceGeneratorSurface = ({ role, space }) => {
+	const { invokePromise } = useOperationInvoker();
+	return /* @__PURE__ */ jsx(SpaceGenerator, {
+		role,
+		space,
+		onCreateObjects: useCallback((objects) => {
+			const collection = space.state.get() === SpaceState.SPACE_READY && Annotation.get(space.properties, AppAnnotation.RootCollectionAnnotation).pipe(Option.getOrUndefined)?.target;
+			if (!Obj.instanceOf(Collection.Collection, collection)) return;
+			objects.forEach((object) => {
+				invokePromise(SpaceOperation.AddObject, {
+					target: collection,
+					object
+				});
+			});
+		}, [space, invokePromise])
+	});
+};
+var ObjectDebugSurface = ({ role, companionTo }) => {
+	const { invokePromise } = useOperationInvoker();
+	const { onOpen, canOpen } = useObjectOpenAction(invokePromise);
+	return /* @__PURE__ */ jsx(DebugObjectPanel, {
+		role,
+		companionTo,
+		onOpen,
+		canOpen
+	});
+};
+var SpaceObjectsSurface = () => {
+	const space = useActiveSpace();
+	const { invokePromise } = useOperationInvoker();
+	const { onOpen, canOpen } = useObjectOpenAction(invokePromise);
+	if (!space) return null;
+	return /* @__PURE__ */ jsx(DebugSpaceObjectsPanel, {
+		space,
+		onOpen,
+		canOpen
+	});
+};
+var LoggerSurface = () => /* @__PURE__ */ jsx(Logger.Root, { children: /* @__PURE__ */ jsxs(Panel.Root, { children: [
+	/* @__PURE__ */ jsx(Panel.Toolbar, {
+		asChild: true,
+		children: /* @__PURE__ */ jsx(Logger.Toolbar, {})
+	}),
+	/* @__PURE__ */ jsx(Panel.Content, {
+		asChild: true,
+		children: /* @__PURE__ */ jsx(Logger.Content, { children: /* @__PURE__ */ jsx(Logger.List, {}) })
+	}),
+	/* @__PURE__ */ jsx(Panel.Statusbar, {
+		asChild: true,
+		children: /* @__PURE__ */ jsx(Logger.Filter, {})
+	})
+] }) });
+//#endregion
+//#region src/capabilities/react-surface.ts
+var isSpaceDebug = (data) => typeof data === "object" && data !== null && "type" in data && data.type === DebugNodes.SpaceType && "space" in data && isSpace(data.space);
+var react_surface_default = Capability.makeModule(Effect.fnUntraced(function* ({ logStore }) {
+	const capabilities = yield* Capability.Service;
+	const registry = capabilities.get(Capabilities.AtomRegistry);
+	const settingsAtom = capabilities.get(DebugCapabilities.Settings);
+	const fileUploader = capabilities.getAll(AppCapabilities.FileUploader)[0];
+	return Capability.contributes(Capabilities.ReactSurface, [
+		Surface.create({
+			id: "pluginSettings",
+			filter: AppSurface.settings(AppSurface.Article, meta.profile.key),
+			component: DebugSettingsSurface,
+			props: ({ data: { subject } }) => ({
+				subject,
+				logStore,
+				onUpload: fileUploader
+			})
+		}),
+		Surface.create({
+			id: "space",
+			filter: AppSurface.subject(AppSurface.Article, isSpaceDebug),
+			component: SpaceGeneratorSurface,
+			props: ({ role, data: { subject } }) => ({
+				role,
+				space: subject.space
+			})
+		}),
+		Surface.create({
+			id: "wireframe",
+			filter: AppSurface.oneOf(AppSurface.subject(AppSurface.Article, (value) => {
+				const settings = registry.get(settingsAtom);
+				return Obj.isObject(value) && !!settings.wireframe;
+			}), AppSurface.subject(AppSurface.Section, (value) => {
+				const settings = registry.get(settingsAtom);
+				return Obj.isObject(value) && !!settings.wireframe;
+			})),
+			position: Position.first,
+			component: Wireframe,
+			props: ({ role, name, data: { subject } }) => ({
+				label: `${role}:${name}`,
+				object: subject,
+				classNames: "row-span-2 overflow-hidden"
+			})
+		}),
+		Surface.create({
+			id: "objectDebug",
+			filter: AppSurface.allOf(AppSurface.literal(AppSurface.Article, "debug"), AppSurface.companion(AppSurface.Article)),
+			component: ObjectDebugSurface,
+			props: ({ role, data: { companionTo } }) => ({
+				role,
+				companionTo
+			})
+		}),
+		Surface.create({
+			id: "spaceObjects",
+			filter: Surface.makeFilter(AppSurface.deckCompanion("spaceObjects")),
+			component: SpaceObjectsSurface
+		}),
+		Surface.create({
+			id: "debugStatus",
+			filter: Surface.makeFilter(AppSurface.StatusIndicator),
+			position: Position.first,
+			component: DebugStatus
+		}),
+		Surface.create({
+			id: "logs",
+			filter: Surface.makeFilter(AppSurface.deckCompanion("logs")),
+			component: LoggerSurface
+		}),
+		Surface.create({
+			id: "logStatus",
+			filter: Surface.makeFilter(AppSurface.StatusIndicator),
+			component: LogStatus
+		}),
+		Surface.create({
+			id: "statsPanel",
+			filter: Surface.makeFilter(DebugSurface.Stats),
+			component: StatsPanel
+		})
+	]);
+}));
+//#endregion
+export { react_surface_default as default };
+
+//# sourceMappingURL=chunk-react-surface.mjs.map

package/dist/lib/chunk-react-surface.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-react-surface.mjs","names":[],"sources":["../../src/capabilities/DebugSurfaces.tsx","../../src/capabilities/react-surface.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// Surface components that cannot be expressed as a `props` mapper, because they call hooks or compose.\n\nimport { useAtomValue } from '@effect-atom/atom-react';\nimport * as Option from 'effect/Option';\nimport React, { useCallback, useMemo } from 'react';\n\nimport { useAtomCapability, useOperationInvoker, useSettingsState } from '@dxos/app-framework/ui';\nimport { AppAnnotation, type AppCapabilities, GraphPath, LayoutOperation } from '@dxos/app-toolkit';\nimport { useActiveSpace } from '@dxos/app-toolkit/ui';\nimport { Annotation, Collection, Entity, Filter, Obj, Type } from '@dxos/echo';\nimport { HiddenAnnotation } from '@dxos/echo/Annotation';\nimport { type IdbLogStore } from '@dxos/log-store-idb';\nimport { SpaceCapabilities, SpaceOperation } from '@dxos/plugin-space';\nimport { useClient } from '@dxos/react-client';\nimport { type Space, SpaceState } from '@dxos/react-client/echo';\nimport { Panel } from '@dxos/react-ui';\nimport { Logger } from '@dxos/react-ui-debug';\n\nimport { DebugObjectPanel, DebugSettings, DebugSpaceObjectsPanel, SpaceGenerator } from '#containers';\nimport { type Settings } from '#types';\n\n/** Returns `onOpen` and `canOpen` for the ObjectsTree \"Open\" action. */\nconst useObjectOpenAction = (invokePromise: ReturnType<typeof useOperationInvoker>['invokePromise']) => {\n  const client = useClient();\n  const spaceSettings = useAtomCapability(SpaceCapabilities.Settings);\n  const showHidden = spaceSettings?.showHidden ?? false;\n\n  const allTypes = useAtomValue(useMemo(() => client.graph.registry.query(Filter.type(Type.Type)).atom, [client]));\n\n  const hiddenTypenames = useMemo(() => {\n    const result = new Set<string>();\n    for (const typeEntity of allTypes) {\n      const schema = Type.getSchema(typeEntity);\n      if (HiddenAnnotation.get(schema).pipe(Option.getOrElse(() => false))) {\n        result.add(Type.getTypename(typeEntity));\n      }\n    }\n    return result;\n  }, [allTypes]);\n\n  const onOpen = useCallback(\n    (object: Obj.Unknown) => {\n      void invokePromise(LayoutOperation.Open, { subject: [GraphPath.getObjectPathFromObject(object)] });\n    },\n    [invokePromise],\n  );\n\n  const canOpen = useCallback(\n    (entity: Entity.Snapshot) => {\n      if (showHidden) {\n        return true;\n      }\n      const typename = Entity.getTypename(entity);\n      return !hiddenTypenames.has(typename ?? '');\n    },\n    [showHidden, hiddenTypenames],\n  );\n\n  return { onOpen, canOpen };\n};\n\nexport type DebugSettingsSurfaceProps = {\n  subject: AppCapabilities.Settings;\n  logStore?: IdbLogStore;\n  onUpload?: AppCapabilities.FileUploader;\n};\n\nexport const DebugSettingsSurface = ({ subject, logStore, onUpload }: DebugSettingsSurfaceProps) => {\n  const { settings, updateSettings } = useSettingsState<Settings.Settings>(subject.atom);\n\n  return (\n    <DebugSettings settings={settings} onSettingsChange={updateSettings} logStore={logStore} onUpload={onUpload} />\n  );\n};\n\nexport type SpaceGeneratorSurfaceProps = {\n  role: string;\n  space: Space;\n};\n\n/** Generated objects are added to the space's root collection, resolved at invocation time. */\nexport const SpaceGeneratorSurface = ({ role, space }: SpaceGeneratorSurfaceProps) => {\n  const { invokePromise } = useOperationInvoker();\n  const handleCreateObjects = useCallback(\n    (objects: Obj.Unknown[]) => {\n      const collection =\n        space.state.get() === SpaceState.SPACE_READY &&\n        Annotation.get(space.properties, AppAnnotation.RootCollectionAnnotation).pipe(Option.getOrUndefined)?.target;\n      if (!Obj.instanceOf(Collection.Collection, collection)) {\n        return;\n      }\n\n      objects.forEach((object) => {\n        void invokePromise(SpaceOperation.AddObject, { target: collection, object });\n      });\n    },\n    [space, invokePromise],\n  );\n\n  return <SpaceGenerator role={role} space={space} onCreateObjects={handleCreateObjects} />;\n};\n\nexport type ObjectDebugSurfaceProps = {\n  role: string;\n  companionTo: Obj.Unknown;\n};\n\nexport const ObjectDebugSurface = ({ role, companionTo }: ObjectDebugSurfaceProps) => {\n  const { invokePromise } = useOperationInvoker();\n  const { onOpen, canOpen } = useObjectOpenAction(invokePromise);\n\n  return <DebugObjectPanel role={role} companionTo={companionTo} onOpen={onOpen} canOpen={canOpen} />;\n};\n\nexport const SpaceObjectsSurface = () => {\n  const space = useActiveSpace();\n  const { invokePromise } = useOperationInvoker();\n  const { onOpen, canOpen } = useObjectOpenAction(invokePromise);\n  if (!space) {\n    return null;\n  }\n\n  return <DebugSpaceObjectsPanel space={space} onOpen={onOpen} canOpen={canOpen} />;\n};\n\nexport const LoggerSurface = () => (\n  <Logger.Root>\n    <Panel.Root>\n      <Panel.Toolbar asChild>\n        <Logger.Toolbar />\n      </Panel.Toolbar>\n      <Panel.Content asChild>\n        <Logger.Content>\n          <Logger.List />\n        </Logger.Content>\n      </Panel.Content>\n      <Panel.Statusbar asChild>\n        <Logger.Filter />\n      </Panel.Statusbar>\n    </Panel.Root>\n  </Logger.Root>\n);\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { Obj } from '@dxos/echo';\nimport { type IdbLogStore } from '@dxos/log-store-idb';\nimport { type Space, isSpace } from '@dxos/react-client/echo';\nimport { Position } from '@dxos/util';\n\nimport { DebugStatus, LogStatus, StatsPanel, Wireframe } from '#containers';\nimport { meta } from '#meta';\nimport { DebugCapabilities, DebugNodes, DebugSurface } from '#types';\n\nimport {\n  DebugSettingsSurface,\n  LoggerSurface,\n  ObjectDebugSurface,\n  SpaceGeneratorSurface,\n  SpaceObjectsSurface,\n} from './DebugSurfaces';\n\ntype SpaceDebug = {\n  type: string;\n  space: Space;\n};\n\nconst isSpaceDebug = (data: unknown): data is SpaceDebug =>\n  typeof data === 'object' &&\n  data !== null &&\n  'type' in data &&\n  data.type === DebugNodes.SpaceType &&\n  'space' in data &&\n  isSpace(data.space);\n\ntype ReactSurfaceOptions = {\n  logStore?: IdbLogStore;\n};\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* ({ logStore }: ReactSurfaceOptions) {\n    const capabilities = yield* Capability.Service;\n    const registry = capabilities.get(Capabilities.AtomRegistry);\n    const settingsAtom = capabilities.get(DebugCapabilities.Settings);\n    const fileUploader = capabilities.getAll(AppCapabilities.FileUploader)[0];\n\n    return Capability.contributes(Capabilities.ReactSurface, [\n      Surface.create({\n        id: 'pluginSettings',\n        filter: AppSurface.settings(AppSurface.Article, meta.profile.key),\n        component: DebugSettingsSurface,\n        props: ({ data: { subject } }) => ({ subject, logStore, onUpload: fileUploader }),\n      }),\n      Surface.create({\n        id: 'space',\n        filter: AppSurface.subject(AppSurface.Article, isSpaceDebug),\n        component: SpaceGeneratorSurface,\n        props: ({ role, data: { subject } }) => ({ role, space: subject.space }),\n      }),\n      Surface.create({\n        id: 'wireframe',\n        // TODO(wittjosiah): Split into multiple surfaces if this filter proves too strict for non-article roles.\n        filter: AppSurface.oneOf(\n          AppSurface.subject(AppSurface.Article, (value): value is Obj.Unknown => {\n            const settings = registry.get(settingsAtom);\n            return Obj.isObject(value) && !!settings.wireframe;\n          }),\n          AppSurface.subject(AppSurface.Section, (value): value is Obj.Unknown => {\n            const settings = registry.get(settingsAtom);\n            return Obj.isObject(value) && !!settings.wireframe;\n          }),\n        ),\n        position: Position.first,\n        component: Wireframe,\n        props: ({ role, name, data: { subject } }) => ({\n          label: `${role}:${name}`,\n          object: subject,\n          classNames: 'row-span-2 overflow-hidden',\n        }),\n      }),\n      Surface.create({\n        id: 'objectDebug',\n        filter: AppSurface.allOf(\n          AppSurface.literal(AppSurface.Article, 'debug'),\n          AppSurface.companion(AppSurface.Article),\n        ),\n        component: ObjectDebugSurface,\n        props: ({ role, data: { companionTo } }) => ({ role, companionTo }),\n      }),\n      Surface.create({\n        id: 'spaceObjects',\n        filter: Surface.makeFilter(AppSurface.deckCompanion('spaceObjects')),\n        component: SpaceObjectsSurface,\n      }),\n      Surface.create({\n        id: 'debugStatus',\n        filter: Surface.makeFilter(AppSurface.StatusIndicator),\n        position: Position.first,\n        component: DebugStatus,\n      }),\n      Surface.create({\n        id: 'logs',\n        filter: Surface.makeFilter(AppSurface.deckCompanion('logs')),\n        component: LoggerSurface,\n      }),\n      Surface.create({\n        id: 'logStatus',\n        filter: Surface.makeFilter(AppSurface.StatusIndicator),\n        component: LogStatus,\n      }),\n      Surface.create({\n        id: 'statsPanel',\n        filter: Surface.makeFilter(DebugSurface.Stats),\n        component: StatsPanel,\n      }),\n    ]);\n  }),\n);\n"],"mappings":"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"}

package/dist/lib/chunk-settings.mjs

@@ -0,0 +1,23 @@
+import { Capability } from "@dxos/app-framework";
+import { meta } from "#meta";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import * as Effect from "effect/Effect";
+import { DebugCapabilities, Settings } from "#types";
+import { createKvsStore } from "@dxos/effect";
+//#region src/capabilities/settings.ts
+var settings_default = Capability.makeModule(() => Effect.sync(() => {
+	const settingsAtom = createKvsStore({
+		key: meta.profile.key,
+		schema: Settings.Settings,
+		defaultValue: () => ({})
+	});
+	return [Capability.contributes(DebugCapabilities.Settings, settingsAtom), Capability.contributes(AppCapabilities.Settings, {
+		prefix: meta.profile.key,
+		schema: Settings.Settings,
+		atom: settingsAtom
+	})];
+}));
+//#endregion
+export { settings_default as default };
+
+//# sourceMappingURL=chunk-settings.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-settings.mjs","names":[],"sources":["../../src/capabilities/settings.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { createKvsStore } from '@dxos/effect';\n\nimport { meta } from '#meta';\nimport { DebugCapabilities, Settings } from '#types';\n\nexport default Capability.makeModule(() =>\n  Effect.sync(() => {\n    const settingsAtom = createKvsStore({\n      key: meta.profile.key,\n      schema: Settings.Settings,\n      defaultValue: () => ({}),\n    });\n\n    return [\n      Capability.contributes(DebugCapabilities.Settings, settingsAtom),\n      Capability.contributes(AppCapabilities.Settings, {\n        prefix: meta.profile.key,\n        schema: Settings.Settings,\n        atom: settingsAtom,\n      }),\n    ];\n  }),\n);\n"],"mappings":";;;;;;;AAaA,IAAA,mBAAe,WAAW,iBACxB,OAAO,WAAW;CAChB,MAAM,eAAe,eAAe;EAClC,KAAK,KAAK,QAAQ;EAClB,QAAQ,SAAS;EACjB,qBAAqB,CAAC;CACxB,CAAC;CAED,OAAO,CACL,WAAW,YAAY,kBAAkB,UAAU,YAAY,GAC/D,WAAW,YAAY,gBAAgB,UAAU;EAC/C,QAAQ,KAAK,QAAQ;EACrB,QAAQ,SAAS;EACjB,MAAM;CACR,CAAC,CACH;AACF,CAAC,CACH"}

package/dist/lib/chunk-stats-panel.mjs

@@ -0,0 +1,56 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { meta } from "#meta";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import * as Effect from "effect/Effect";
+import { Atom } from "@effect-atom/atom";
+//#region src/capabilities/stats-panel.ts
+var STORAGE_KEY = `${meta.profile.key}.statsPanel`;
+/**
+* Contributes the {@link AppCapabilities.StatsPanel} store: a single reactive atom holding one
+* compartment per plugin, keyed by plugin key. Read access spans the whole store; writes are scoped
+* to a compartment via `compartment(pluginKey)`. Kept alive with `Atom.keepAlive` so a background
+* writer (e.g. a sync operation) can populate it before any surface subscribes. When `persist` is set
+* the store hydrates from and saves to localStorage so stats survive a reload.
+*/
+var stats_panel_default = Capability.makeModule(Effect.fnUntraced(function* ({ persist = true } = {}) {
+	const registry = yield* Capability.get(Capabilities.AtomRegistry);
+	const canPersist = persist && typeof localStorage !== "undefined";
+	const hydrate = () => {
+		if (!canPersist) return {};
+		try {
+			const raw = localStorage.getItem(STORAGE_KEY);
+			return raw ? JSON.parse(raw) : {};
+		} catch {
+			return {};
+		}
+	};
+	const statsAtom = Atom.make(hydrate()).pipe(Atom.keepAlive);
+	const save = () => {
+		if (!canPersist) return;
+		try {
+			localStorage.setItem(STORAGE_KEY, JSON.stringify(registry.get(statsAtom)));
+		} catch {}
+	};
+	return Capability.contributes(AppCapabilities.StatsPanel, {
+		statsAtom,
+		get: (pluginKey) => registry.get(statsAtom)[pluginKey],
+		compartment: (pluginKey) => ({
+			set: (stats) => {
+				registry.set(statsAtom, {
+					...registry.get(statsAtom),
+					[pluginKey]: stats
+				});
+				save();
+			},
+			clear: () => {
+				const { [pluginKey]: _removed, ...rest } = registry.get(statsAtom);
+				registry.set(statsAtom, rest);
+				save();
+			}
+		})
+	});
+}));
+//#endregion
+export { stats_panel_default as default };
+
+//# sourceMappingURL=chunk-stats-panel.mjs.map

package/dist/lib/chunk-stats-panel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-stats-panel.mjs","names":[],"sources":["../../src/capabilities/stats-panel.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom } from '@effect-atom/atom';\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\n\nimport { meta } from '#meta';\n\ntype StatsPanelOptions = {\n  /** Persist the store to localStorage (hydrate on load, save on write). */\n  persist?: boolean;\n};\n\nconst STORAGE_KEY = `${meta.profile.key}.statsPanel`;\n\n/**\n * Contributes the {@link AppCapabilities.StatsPanel} store: a single reactive atom holding one\n * compartment per plugin, keyed by plugin key. Read access spans the whole store; writes are scoped\n * to a compartment via `compartment(pluginKey)`. Kept alive with `Atom.keepAlive` so a background\n * writer (e.g. a sync operation) can populate it before any surface subscribes. When `persist` is set\n * the store hydrates from and saves to localStorage so stats survive a reload.\n */\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* ({ persist = true }: StatsPanelOptions = {}) {\n    const registry = yield* Capability.get(Capabilities.AtomRegistry);\n    const canPersist = persist && typeof localStorage !== 'undefined';\n\n    const hydrate = (): Record<string, unknown> => {\n      if (!canPersist) {\n        return {};\n      }\n      try {\n        const raw = localStorage.getItem(STORAGE_KEY);\n        return raw ? JSON.parse(raw) : {};\n      } catch {\n        // Best-effort: a malformed/unavailable value just starts empty.\n        return {};\n      }\n    };\n\n    const statsAtom = Atom.make<Record<string, unknown>>(hydrate()).pipe(Atom.keepAlive);\n\n    const save = () => {\n      if (!canPersist) {\n        return;\n      }\n      try {\n        localStorage.setItem(STORAGE_KEY, JSON.stringify(registry.get(statsAtom)));\n      } catch {\n        // Best-effort: localStorage may be disabled or over quota; the in-memory atom is authoritative.\n      }\n    };\n\n    return Capability.contributes(AppCapabilities.StatsPanel, {\n      statsAtom,\n      get: (pluginKey) => registry.get(statsAtom)[pluginKey],\n      compartment: (pluginKey) => ({\n        set: (stats) => {\n          registry.set(statsAtom, { ...registry.get(statsAtom), [pluginKey]: stats });\n          save();\n        },\n        clear: () => {\n          const { [pluginKey]: _removed, ...rest } = registry.get(statsAtom);\n          registry.set(statsAtom, rest);\n          save();\n        },\n      }),\n    });\n  }),\n);\n"],"mappings":";;;;;;AAiBA,IAAM,cAAc,GAAG,KAAK,QAAQ,IAAI;;;;;;;;AASxC,IAAA,sBAAe,WAAW,WACxB,OAAO,WAAW,WAAW,EAAE,UAAU,SAA4B,CAAC,GAAG;CACvE,MAAM,WAAW,OAAO,WAAW,IAAI,aAAa,YAAY;CAChE,MAAM,aAAa,WAAW,OAAO,iBAAiB;CAEtD,MAAM,gBAAyC;EAC7C,IAAI,CAAC,YACH,OAAO,CAAC;EAEV,IAAI;GACF,MAAM,MAAM,aAAa,QAAQ,WAAW;GAC5C,OAAO,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;EAClC,QAAQ;GAEN,OAAO,CAAC;EACV;CACF;CAEA,MAAM,YAAY,KAAK,KAA8B,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS;CAEnF,MAAM,aAAa;EACjB,IAAI,CAAC,YACH;EAEF,IAAI;GACF,aAAa,QAAQ,aAAa,KAAK,UAAU,SAAS,IAAI,SAAS,CAAC,CAAC;EAC3E,QAAQ,CAER;CACF;CAEA,OAAO,WAAW,YAAY,gBAAgB,YAAY;EACxD;EACA,MAAM,cAAc,SAAS,IAAI,SAAS,CAAC,CAAC;EAC5C,cAAc,eAAe;GAC3B,MAAM,UAAU;IACd,SAAS,IAAI,WAAW;KAAE,GAAG,SAAS,IAAI,SAAS;MAAI,YAAY;IAAM,CAAC;IAC1E,KAAK;GACP;GACA,aAAa;IACX,MAAM,GAAG,YAAY,UAAU,GAAG,SAAS,SAAS,IAAI,SAAS;IACjE,SAAS,IAAI,WAAW,IAAI;IAC5B,KAAK;GACP;EACF;CACF,CAAC;AACH,CAAC,CACH"}

package/dist/lib/chunk-types.mjs

@@ -0,0 +1,60 @@
+import { Capability, Role } from "@dxos/app-framework";
+import { createContext } from "react";
+import { meta } from "#meta";
+import * as Schema from "effect/Schema";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/types/debug.ts
+var DebugContext = createContext({
+	running: false,
+	start: () => {},
+	stop: () => {}
+});
+var DebugCapabilities;
+(function(_DebugCapabilities) {
+	_DebugCapabilities.Settings = Capability.make(`${meta.profile.key}.capability.settings`);
+})(DebugCapabilities || (DebugCapabilities = {}));
+//#endregion
+//#region src/types/DebugNodes.ts
+var DebugNodes_exports = /* @__PURE__ */ __exportAll({
+	SpaceType: () => SpaceType,
+	id: () => id,
+	nodeId: () => nodeId
+});
+/** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */
+var nodeId = (fullId) => fullId.split(".").at(-1) ?? "";
+var debugId = meta.profile.key;
+/** Top-level Debug node (sibling of DevTools under the SYSTEM navtree group). */
+var id = `${debugId}.debug`;
+/** Discriminator for the space-generator article surface (`node.data.type`). */
+var SpaceType = `${debugId}.space`;
+//#endregion
+//#region src/types/DebugSurface.ts
+var DebugSurface_exports = /* @__PURE__ */ __exportAll({ Stats: () => Stats });
+/**
+* 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.
+*/
+var Stats = Role.make(`${meta.profile.key}.surface.stats`);
+//#endregion
+//#region src/types/Settings.ts
+var Settings_exports = /* @__PURE__ */ __exportAll({ Settings: () => Settings });
+var Settings = Schema.mutable(Schema.Struct({
+	wireframe: Schema.optional(Schema.Boolean),
+	traceAll: Schema.optional(Schema.Boolean)
+}));
+//#endregion
+export { DebugContext as a, DebugCapabilities as i, DebugSurface_exports as n, DebugNodes_exports as r, Settings_exports as t };
+
+//# sourceMappingURL=chunk-types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-types.mjs","names":[],"sources":["../../src/types/debug.ts","../../src/types/DebugNodes.ts","../../src/types/DebugSurface.ts","../../src/types/Settings.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom';\nimport { type Context, createContext } from 'react';\n\nimport { Capability } from '@dxos/app-framework';\nimport type { TimerCallback, TimerOptions } from '@dxos/async';\nimport { type IdbLogStore } from '@dxos/log-store-idb';\n\nimport { meta } from '#meta';\n\nimport * as Settings from './Settings';\n\nexport type DebugPluginOptions = {\n  /** Shared persistent log store for capturing and downloading logs. */\n  logStore?: IdbLogStore;\n  /** Persist the stats-panel store to localStorage so it survives a reload. Defaults to `true`. */\n  persistStats?: boolean;\n};\n\nexport type DebugContextType = {\n  running: boolean;\n  start: (cb: TimerCallback, options: TimerOptions) => void;\n  stop: () => void;\n};\n\nexport const DebugContext: Context<DebugContextType> = createContext<DebugContextType>({\n  running: false,\n  start: () => {},\n  stop: () => {},\n});\n\nexport namespace DebugCapabilities {\n  export const Settings = Capability.make<Atom.Writable<Settings.Settings>>(`${meta.profile.key}.capability.settings`);\n}\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { meta } from '#meta';\n\n/** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */\nexport const nodeId = (fullId: string): string => fullId.split('.').at(-1) ?? '';\n\nconst debugId = meta.profile.key;\n\n/** Top-level Debug node (sibling of DevTools under the SYSTEM navtree group). */\nexport const id = `${debugId}.debug`;\n\n/** Discriminator for the space-generator article surface (`node.data.type`). */\nexport const SpaceType = `${debugId}.space`;\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { Role } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\n/**\n * Role token for the transient-stats panel — renders the {@link AppCapabilities.StatsPanel} store\n * (arbitrary reactive telemetry keyed by owner id). A layout targets this role (role-only dispatch);\n * the surface reads the store directly, so it needs no subject.\n */\nexport const Stats = Role.make<Record<string, unknown>>(`${meta.profile.key}.surface.stats`);\n","//\n// Copyright 2023 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nexport const Settings = Schema.mutable(\n  Schema.Struct({\n    wireframe: Schema.optional(Schema.Boolean),\n    traceAll: Schema.optional(Schema.Boolean),\n  }),\n);\n\nexport interface Settings extends Schema.Schema.Type<typeof Settings> {}\n"],"mappings":";;;;;;;;;;;;;;;;;AA4BA,IAAa,eAA0C,cAAgC;CACrF,SAAS;CACT,aAAa,CAAC;CACd,YAAY,CAAC;AACf,CAAC;AAEM,IAAA;;CACQ,mBAAA,WAAW,WAAW,KAAuC,GAAG,KAAK,QAAQ,IAAI,qBAAqB;GACrH,sBAAA,oBAAA,CAAA,EAAA;;;;;;;;;AC3BA,IAAa,UAAU,WAA2B,OAAO,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK;AAE9E,IAAM,UAAU,KAAK,QAAQ;;AAG7B,IAAa,KAAK,GAAG,QAAQ;;AAG7B,IAAa,YAAY,GAAG,QAAQ;;;;;;;;;ACFpC,IAAa,QAAQ,KAAK,KAA8B,GAAG,KAAK,QAAQ,IAAI,eAAe;;;;ACP3F,IAAa,WAAW,OAAO,QAC7B,OAAO,OAAO;CACZ,WAAW,OAAO,SAAS,OAAO,OAAO;CACzC,UAAU,OAAO,SAAS,OAAO,OAAO;AAC1C,CAAC,CACH"}