@dxos/plugin-graph 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.13.0

package/dist/lib/chunk-action.mjs

@@ -2,7 +2,7 @@ import * as Effect from "effect/Effect";
 import * as Function from "effect/Function";
 import * as Capability from "@dxos/app-framework/Capability";
 import * as Operation from "@dxos/compute/Operation";
-import { EffectEx } from "@dxos/effect";
+import * as EffectEx from "@dxos/effect/EffectEx";
 //#region src/action.ts
 /**
 * Run an action with required layers: Operation.Service, Capability.Service, and captured context.

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-action.mjs","names":[],"sources":["../../src/action.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Function from 'effect/Function';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport type * as CapabilityManager from '@dxos/app-framework/CapabilityManager';\nimport type * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\nimport * as Operation from '@dxos/compute/Operation';\nimport { EffectEx } from '@dxos/effect';\n\n/**\n * Run an action with required layers: Operation.Service, Capability.Service, and captured context.\n * @param invoker The operation invoker to use for Operation.Service.\n * @param capabilityManager The capability manager for Capability.Service.\n * @param action The action to execute.\n * @param params Parameters to pass to the action.\n */\nexport const runAction = async (\n  invoker: Operation.OperationService,\n  capabilityManager: CapabilityManager.CapabilityManager,\n  action: AppGraphNode.Action,\n  params: AppGraphNode.InvokeProps = {},\n): Promise<void> =>\n  EffectEx.runAndForwardErrors(\n    action\n      .data(params)\n      .pipe(\n        Effect.provideService(Operation.Service, invoker),\n        Effect.provideService(Capability.Service, capabilityManager),\n        action._actionContext ? Effect.provide(action._actionContext) : Function.identity,\n      ),\n  );\n"],"mappings":";;;;;;;;;;;;;AAoBA,IAAa,YAAY,OACvB,SACA,mBACA,QACA,SAAmC,CAAC,MAEpC,SAAS,oBACP,OACG,KAAK,MAAM,CAAA,CACX,KACC,OAAO,eAAe,UAAU,SAAS,OAAO,GAChD,OAAO,eAAe,WAAW,SAAS,iBAAiB,GAC3D,OAAO,iBAAiB,OAAO,QAAQ,OAAO,cAAc,IAAI,SAAS,QAC3E,CACJ"}
+{"version":3,"file":"chunk-action.mjs","names":[],"sources":["../../src/action.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Function from 'effect/Function';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport type * as CapabilityManager from '@dxos/app-framework/CapabilityManager';\nimport type * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as EffectEx from '@dxos/effect/EffectEx';\n\n/**\n * Run an action with required layers: Operation.Service, Capability.Service, and captured context.\n * @param invoker The operation invoker to use for Operation.Service.\n * @param capabilityManager The capability manager for Capability.Service.\n * @param action The action to execute.\n * @param params Parameters to pass to the action.\n */\nexport const runAction = async (\n  invoker: Operation.OperationService,\n  capabilityManager: CapabilityManager.CapabilityManager,\n  action: AppGraphNode.Action,\n  params: AppGraphNode.InvokeProps = {},\n): Promise<void> =>\n  EffectEx.runAndForwardErrors(\n    action\n      .data(params)\n      .pipe(\n        Effect.provideService(Operation.Service, invoker),\n        Effect.provideService(Capability.Service, capabilityManager),\n        action._actionContext ? Effect.provide(action._actionContext) : Function.identity,\n      ),\n  );\n"],"mappings":";;;;;;;;;;;;;AAoBA,IAAa,YAAY,OACvB,SACA,mBACA,QACA,SAAmC,CAAC,MAEpC,SAAS,oBACP,OACG,KAAK,MAAM,CAAA,CACX,KACC,OAAO,eAAe,UAAU,SAAS,OAAO,GAChD,OAAO,eAAe,WAAW,SAAS,iBAAiB,GAC3D,OAAO,iBAAiB,OAAO,QAAQ,OAAO,cAAc,IAAI,SAAS,QAC3E,CACJ"}

package/dist/lib/chunk-graph.mjs

@@ -5,6 +5,7 @@ import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
 import * as Record from "effect/Record";
 import * as AppGraph from "@dxos/app-graph/AppGraph";
 import * as AppGraphBuilder from "@dxos/app-graph/AppGraphBuilder";
+import * as AppNode from "@dxos/app-toolkit/AppNode";
 import * as UrlPath from "@dxos/app-toolkit/UrlPath";
 import * as GraphNode from "@dxos/graph/GraphNode";
 //#region src/graph.ts
@@ -13,7 +14,11 @@ var graph_default = Capability.makeModule(Effect.fnUntraced(function* () {
 	const extensionsByModuleAtom = yield* Capability.atomByModule(AppCapabilities.AppGraphBuilder);
 	const builder = AppGraphBuilder.from(void 0, registry, {
 		anchorKey: UrlPath.WORKSPACE_KEY,
-		linkedKey: UrlPath.COMPANION_KEY
+		linked: {
+			key: UrlPath.COMPANION_KEY,
+			relation: AppNode.companion
+		},
+		tailSeparator: UrlPath.TAIL_SEPARATOR
 	});
 	const unsubscribe = registry.subscribe(extensionsByModuleAtom, (extensionsByModule) => {
 		const next = [];
@@ -24,10 +29,15 @@ var graph_default = Capability.makeModule(Effect.fnUntraced(function* () {
 		Record.values(registry.get(builder.extensions)).filter(({ id }) => !next.some(({ id: nextId }) => nextId === id)).forEach((extension) => AppGraphBuilder.removeExtension(builder, extension.id));
 		next.forEach((extension) => AppGraphBuilder.addExtension(builder, extension));
 	}, { immediate: true });
+	const retentionAtom = yield* Capability.atom(AppCapabilities.AppGraphRetention);
+	const unsubscribeRetention = registry.subscribe(retentionAtom, (retentions) => AppGraphBuilder.setRetention(builder, retentions), { immediate: true });
 	AppGraph.expandSync(builder.graph, GraphNode.RootId, "child");
 	setupDevtools(builder.graph);
 	yield* Effect.addFinalizer(() => Effect.sync(() => {
 		unsubscribe();
+		unsubscribeRetention();
+		AppGraphBuilder.setRetention(builder, []);
+		AppGraphBuilder.destroy(builder);
 	}));
 	return Capability.contribute(AppCapabilities.AppGraph, builder);
 }));

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-graph.mjs","names":[],"sources":["../../src/graph.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Record from 'effect/Record';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppGraph from '@dxos/app-graph/AppGraph';\nimport * as AppGraphBuilder from '@dxos/app-graph/AppGraphBuilder';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as UrlPath from '@dxos/app-toolkit/UrlPath';\nimport * as GraphNode from '@dxos/graph/GraphNode';\n\n// TODO(wittjosiah): Remove or restore graph caching.\n// import { meta } from './meta';\n\n// const KEY = `${meta.id}.app-graph`;\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const registry = yield* Capabilities.AtomRegistry;\n\n    // Live view: extensions contributed by dependency-mode modules (including those enabled\n    // later in the session) reach this subscription reactively.\n    const extensionsByModuleAtom = yield* Capability.atomByModule(AppCapabilities.AppGraphBuilder);\n\n    // The grammar's fixed tiers, configured here rather than declared by an extension: no connector\n    // produces their nodes (see `AppGraphBuilder.UrlGrammar`).\n    const builder = AppGraphBuilder.from(/* localStorage.getItem(KEY) ?? */ undefined, registry, {\n      anchorKey: UrlPath.WORKSPACE_KEY,\n      linkedKey: UrlPath.COMPANION_KEY,\n    });\n    // const interval = setInterval(() => {\n    //   localStorage.setItem(KEY, builder.graph.pickle());\n    // }, 5_000);\n\n    const unsubscribe = registry.subscribe(\n      extensionsByModuleAtom,\n      (extensionsByModule) => {\n        const next: AppGraphBuilder.BuilderExtension[] = [];\n        for (const [moduleId, extensions] of Object.entries(extensionsByModule)) {\n          for (const ext of AppGraphBuilder.flattenExtensions(extensions)) {\n            next.push({\n              ...ext,\n              id: `${moduleId}.${ext.id}`,\n            });\n          }\n        }\n        const current = Record.values(registry.get(builder.extensions));\n        const removed = current.filter(({ id }) => !next.some(({ id: nextId }) => nextId === id));\n        removed.forEach((extension) => AppGraphBuilder.removeExtension(builder, extension.id));\n        next.forEach((extension) => AppGraphBuilder.addExtension(builder, extension));\n      },\n      { immediate: true },\n    );\n\n    // await builder.initialize();\n    void AppGraph.expandSync(builder.graph, GraphNode.RootId, 'child');\n\n    setupDevtools(builder.graph);\n\n    yield* Effect.addFinalizer(() =>\n      Effect.sync(() => {\n        // clearInterval(interval);\n        unsubscribe();\n      }),\n    );\n    return Capability.contribute(AppCapabilities.AppGraph, builder);\n  }),\n);\n\n// Expose the graph to the window for debugging.\nconst setupDevtools = (graph: AppGraph.ExpandableGraph) => {\n  (globalThis as any).composer ??= {};\n  (globalThis as any).composer.graph = graph;\n};\n"],"mappings":";;;;;;;;;;AAoBA,IAAA,gBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,MAAM,WAAW,OAAO,aAAa;CAIrC,MAAM,yBAAyB,OAAO,WAAW,aAAa,gBAAgB,eAAe;CAI7F,MAAM,UAAU,gBAAgB,KAAwC,KAAA,GAAW,UAAU;EAC3F,WAAW,QAAQ;EACnB,WAAW,QAAQ;CACrB,CAAC;CAKD,MAAM,cAAc,SAAS,UAC3B,yBACC,uBAAuB;EACtB,MAAM,OAA2C,CAAC;EAClD,KAAK,MAAM,CAAC,UAAU,eAAe,OAAO,QAAQ,kBAAkB,GACpE,KAAK,MAAM,OAAO,gBAAgB,kBAAkB,UAAU,GAC5D,KAAK,KAAK;GACR,GAAG;GACH,IAAI,GAAG,SAAS,GAAG,IAAI;EACzB,CAAC;EAKL,OAFuB,OAAO,SAAS,IAAI,QAAQ,UAAU,CAC7C,CAAA,CAAQ,QAAQ,EAAE,SAAS,CAAC,KAAK,MAAM,EAAE,IAAI,aAAa,WAAW,EAAE,CACvF,CAAA,CAAQ,SAAS,cAAc,gBAAgB,gBAAgB,SAAS,UAAU,EAAE,CAAC;EACrF,KAAK,SAAS,cAAc,gBAAgB,aAAa,SAAS,SAAS,CAAC;CAC9E,GACA,EAAE,WAAW,KAAK,CACpB;CAGA,SAAc,WAAW,QAAQ,OAAO,UAAU,QAAQ,OAAO;CAEjE,cAAc,QAAQ,KAAK;CAE3B,OAAO,OAAO,mBACZ,OAAO,WAAW;EAEhB,YAAY;CACd,CAAC,CACH;CACA,OAAO,WAAW,WAAW,gBAAgB,UAAU,OAAO;AAChE,CAAC,CACH;AAGA,IAAM,iBAAiB,UAAoC;CACzD,WAAoB,aAAa,CAAC;CAClC,WAAoB,SAAS,QAAQ;AACvC"}
+{"version":3,"file":"chunk-graph.mjs","names":[],"sources":["../../src/graph.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Record from 'effect/Record';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppGraph from '@dxos/app-graph/AppGraph';\nimport * as AppGraphBuilder from '@dxos/app-graph/AppGraphBuilder';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppNode from '@dxos/app-toolkit/AppNode';\nimport * as UrlPath from '@dxos/app-toolkit/UrlPath';\nimport * as GraphNode from '@dxos/graph/GraphNode';\n\n// TODO(wittjosiah): Remove or restore graph caching.\n// import { meta } from './meta.ts';\n\n// const KEY = `${meta.id}.app-graph`;\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const registry = yield* Capabilities.AtomRegistry;\n\n    // Live view: extensions contributed by dependency-mode modules (including those enabled\n    // later in the session) reach this subscription reactively.\n    const extensionsByModuleAtom = yield* Capability.atomByModule(AppCapabilities.AppGraphBuilder);\n\n    // The grammar's fixed tiers, configured here rather than declared by an extension: no connector\n    // produces their nodes (see `AppGraphBuilder.UrlGrammar`).\n    const builder = AppGraphBuilder.from(/* localStorage.getItem(KEY) ?? */ undefined, registry, {\n      anchorKey: UrlPath.WORKSPACE_KEY,\n      linked: { key: UrlPath.COMPANION_KEY, relation: AppNode.companion },\n      tailSeparator: UrlPath.TAIL_SEPARATOR,\n    });\n    // const interval = setInterval(() => {\n    //   localStorage.setItem(KEY, builder.graph.pickle());\n    // }, 5_000);\n\n    const unsubscribe = registry.subscribe(\n      extensionsByModuleAtom,\n      (extensionsByModule) => {\n        const next: AppGraphBuilder.BuilderExtension[] = [];\n        for (const [moduleId, extensions] of Object.entries(extensionsByModule)) {\n          for (const ext of AppGraphBuilder.flattenExtensions(extensions)) {\n            next.push({\n              ...ext,\n              id: `${moduleId}.${ext.id}`,\n            });\n          }\n        }\n        const current = Record.values(registry.get(builder.extensions));\n        const removed = current.filter(({ id }) => !next.some(({ id: nextId }) => nextId === id));\n        removed.forEach((extension) => AppGraphBuilder.removeExtension(builder, extension.id));\n        next.forEach((extension) => AppGraphBuilder.addExtension(builder, extension));\n      },\n      { immediate: true },\n    );\n\n    const retentionAtom = yield* Capability.atom(AppCapabilities.AppGraphRetention);\n    const unsubscribeRetention = registry.subscribe(\n      retentionAtom,\n      (retentions) => AppGraphBuilder.setRetention(builder, retentions),\n      { immediate: true },\n    );\n\n    // await builder.initialize();\n    void AppGraph.expandSync(builder.graph, GraphNode.RootId, 'child');\n\n    setupDevtools(builder.graph);\n\n    yield* Effect.addFinalizer(() =>\n      Effect.sync(() => {\n        // clearInterval(interval);\n        unsubscribe();\n        unsubscribeRetention();\n        AppGraphBuilder.setRetention(builder, []);\n        AppGraphBuilder.destroy(builder);\n      }),\n    );\n    return Capability.contribute(AppCapabilities.AppGraph, builder);\n  }),\n);\n\n// Expose the graph to the window for debugging.\nconst setupDevtools = (graph: AppGraph.ExpandableGraph) => {\n  (globalThis as any).composer ??= {};\n  (globalThis as any).composer.graph = graph;\n};\n"],"mappings":";;;;;;;;;;;AAqBA,IAAA,gBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,MAAM,WAAW,OAAO,aAAa;CAIrC,MAAM,yBAAyB,OAAO,WAAW,aAAa,gBAAgB,eAAe;CAI7F,MAAM,UAAU,gBAAgB,KAAwC,KAAA,GAAW,UAAU;EAC3F,WAAW,QAAQ;EACnB,QAAQ;GAAE,KAAK,QAAQ;GAAe,UAAU,QAAQ;EAAU;EAClE,eAAe,QAAQ;CACzB,CAAC;CAKD,MAAM,cAAc,SAAS,UAC3B,yBACC,uBAAuB;EACtB,MAAM,OAA2C,CAAC;EAClD,KAAK,MAAM,CAAC,UAAU,eAAe,OAAO,QAAQ,kBAAkB,GACpE,KAAK,MAAM,OAAO,gBAAgB,kBAAkB,UAAU,GAC5D,KAAK,KAAK;GACR,GAAG;GACH,IAAI,GAAG,SAAS,GAAG,IAAI;EACzB,CAAC;EAKL,OAFuB,OAAO,SAAS,IAAI,QAAQ,UAAU,CAC7C,CAAA,CAAQ,QAAQ,EAAE,SAAS,CAAC,KAAK,MAAM,EAAE,IAAI,aAAa,WAAW,EAAE,CACvF,CAAA,CAAQ,SAAS,cAAc,gBAAgB,gBAAgB,SAAS,UAAU,EAAE,CAAC;EACrF,KAAK,SAAS,cAAc,gBAAgB,aAAa,SAAS,SAAS,CAAC;CAC9E,GACA,EAAE,WAAW,KAAK,CACpB;CAEA,MAAM,gBAAgB,OAAO,WAAW,KAAK,gBAAgB,iBAAiB;CAC9E,MAAM,uBAAuB,SAAS,UACpC,gBACC,eAAe,gBAAgB,aAAa,SAAS,UAAU,GAChE,EAAE,WAAW,KAAK,CACpB;CAGA,SAAc,WAAW,QAAQ,OAAO,UAAU,QAAQ,OAAO;CAEjE,cAAc,QAAQ,KAAK;CAE3B,OAAO,OAAO,mBACZ,OAAO,WAAW;EAEhB,YAAY;EACZ,qBAAqB;EACrB,gBAAgB,aAAa,SAAS,CAAC,CAAC;EACxC,gBAAgB,QAAQ,OAAO;CACjC,CAAC,CACH;CACA,OAAO,WAAW,WAAW,gBAAgB,UAAU,OAAO;AAChE,CAAC,CACH;AAGA,IAAM,iBAAiB,UAAoC;CACzD,WAAoB,aAAa,CAAC;CAClC,WAAoB,SAAS,QAAQ;AACvC"}

package/dist/lib/chunk-rolldown-runtime.mjs

@@ -1,5 +1,8 @@
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
 	for (var name in all) __defProp(target, name, {
@@ -9,5 +12,16 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 //#endregion
-export { __exportAll as t };
+export { __reExport as n, __exportAll as t };

package/dist/lib/hooks.mjs

@@ -1,19 +1,98 @@
 import { t as runAction } from "./chunk-action.mjs";
 import { useCallback, useMemo } from "react";
-import { useOperationInvoker, usePluginManager } from "@dxos/app-framework/ui";
-import { useAtomValue } from "@effect/atom-react/Hooks";
+import * as Hooks$1 from "@dxos/app-framework/Hooks";
+import * as PluginManagerProvider from "@dxos/app-framework/PluginManagerProvider";
 import * as Option from "effect/Option";
+import * as Atom from "effect/reactivity/Atom";
+import * as AppGraphNode from "@dxos/app-graph/AppGraphNode";
+import * as Hooks from "@dxos/app-toolkit/Hooks";
+import { Path } from "@dxos/react-ui-list";
+import { mx } from "@dxos/ui-theme";
+import { useAtomValue } from "@effect/atom-react/Hooks";
 //#region src/hooks/useActionRunner.ts
 /**
 * Hook that returns a function to run action Effects.
 * Provides Operation.Service, PluginContextService, and captured plugin context.
 */
 var useActionRunner = () => {
-	const invoker = useOperationInvoker();
-	const pluginManager = usePluginManager();
+	const invoker = Hooks$1.useOperationInvoker();
+	const pluginManager = PluginManagerProvider.usePluginManager();
 	return useCallback((action, params = {}) => runAction(invoker, pluginManager.capabilities, action, params), [invoker, pluginManager.capabilities]);
 };
 //#endregion
+//#region src/hooks/useGraphTreeModel.ts
+/** Rows the tree lists: not hidden, and either a plain node or an action the graph marks as an item. */
+var isItem = (node) => !AppGraphNode.hasDisposition(node, "hidden") && (!AppGraphNode.isAction(node) || AppGraphNode.hasDisposition(node, "item"));
+/**
+* A `TreeModel` over the app graph: topology and row props come from the graph, open/current state
+* from the caller, so one mapping serves the navtree (persisted state) and any other tree host.
+*/
+var createGraphTreeModel = (graph, rootId, { itemOpen, itemCurrent }) => {
+	const isVisibleChild = (node) => !AppGraphNode.hasDisposition(node, "hidden");
+	const itemPropsFamily = Atom.family((pathKey) => {
+		const path = Path.parts(pathKey);
+		const id = Path.last(pathKey);
+		return Atom.make((get) => {
+			const node = Option.getOrUndefined(get(graph.node(id)));
+			if (!node) return {
+				id,
+				label: id
+			};
+			const visibleChildren = get(graph.connections(node.id, "child")).filter((child) => !path.includes(child.id)).filter(isVisibleChild);
+			const parentOf = visibleChildren.length > 0 ? visibleChildren.map((child) => child.id) : node.properties.role === "branch" ? [] : void 0;
+			const parentId = path.length >= 2 ? path[path.length - 2] : void 0;
+			const parentNode = parentId ? Option.getOrUndefined(get(graph.node(parentId))) : void 0;
+			const droppable = node.properties.droppable === false || parentNode?.properties.childrenDroppable === false ? false : void 0;
+			const disposition = node.properties.disposition;
+			const isGroup = disposition === "group";
+			return {
+				id: node.id,
+				parentOf: isGroup ? void 0 : parentOf,
+				disposition,
+				disabled: isGroup || node.properties.disabled,
+				draggable: isGroup ? false : node.properties.draggable,
+				droppable: isGroup ? false : droppable,
+				label: node.properties.label ?? node.id,
+				className: mx(node.properties.className, node.properties.modified && "italic"),
+				headingClassName: node.properties.headingClassName,
+				icon: node.properties.icon,
+				iconHue: node.properties.iconHue,
+				testId: node.properties.testId,
+				count: node.properties.count,
+				modifiedCount: node.properties.modifiedCount
+			};
+		}).pipe(Atom.keepAlive);
+	});
+	const childIdsFamily = Atom.family((id) => Atom.make((get) => get(graph.connections(id, "child")).filter(isVisibleChild).map((child) => child.id)).pipe(Atom.keepAlive));
+	const itemFamily = Atom.family((id) => Atom.make((get) => {
+		const node = Option.getOrUndefined(get(graph.node(id)));
+		return node && isItem(node) ? node : void 0;
+	}).pipe(Atom.keepAlive));
+	const itemOpenFamily = Atom.family((pathKey) => itemOpen(Path.parts(pathKey)));
+	const itemCurrentFamily = Atom.family((pathKey) => itemCurrent(Path.parts(pathKey)));
+	return {
+		item: (id) => itemFamily(id),
+		itemProps: (path) => itemPropsFamily(Path.create(...path)),
+		itemOpen: (path) => itemOpenFamily(Path.create(...path)),
+		itemCurrent: (path) => itemCurrentFamily(Path.create(...path)),
+		childIds: (parentId) => childIdsFamily(parentId ?? rootId)
+	};
+};
+/** {@link createGraphTreeModel} over the app graph capability, memoised on its inputs. */
+var useGraphTreeModel = (rootId, options) => {
+	const { graph } = Hooks.useAppGraph();
+	const { itemOpen, itemCurrent } = options;
+	return useMemo(() => createGraphTreeModel(graph, rootId, {
+		itemOpen,
+		itemCurrent
+	}), [
+		graph,
+		rootId,
+		itemOpen,
+		itemCurrent
+	]);
+};
+//#endregion
 //#region src/hooks/useNode.ts
 /**
 * React hook to get a node from the graph.
@@ -53,6 +132,6 @@ var useEdges = (graph, id) => {
 	return useAtomValue(atom);
 };
 //#endregion
-export { useActionRunner, useActions, useConnections, useEdges, useNode };
+export { createGraphTreeModel, useActionRunner, useActions, useConnections, useEdges, useGraphTreeModel, useNode };
 
 //# sourceMappingURL=hooks.mjs.map

package/dist/lib/hooks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.mjs","names":[],"sources":["../../src/hooks/useActionRunner.ts","../../src/hooks/useNode.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { useCallback } from 'react';\n\nimport { useOperationInvoker, usePluginManager } from '@dxos/app-framework/ui';\nimport type * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\n\nimport { runAction } from '../action';\n\n/**\n * Hook that returns a function to run action Effects.\n * Provides Operation.Service, PluginContextService, and captured plugin context.\n */\nexport const useActionRunner = () => {\n  const invoker = useOperationInvoker();\n  const pluginManager = usePluginManager();\n\n  return useCallback(\n    (action: AppGraphNode.Action, params: AppGraphNode.InvokeProps = {}) =>\n      runAction(invoker, pluginManager.capabilities, action, params),\n    [invoker, pluginManager.capabilities],\n  );\n};\n","//\n// Copyright 2024 DXOS.org\n//\n\nimport { useAtomValue } from '@effect/atom-react/Hooks';\nimport * as Option from 'effect/Option';\nimport { useMemo } from 'react';\n\nimport type * as AppGraph from '@dxos/app-graph/AppGraph';\nimport type * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\n\n/**\n * React hook to get a node from the graph.\n *\n * @param graph Graph to find the node in.\n * @param id Id of the node to find.\n * @param timeout Optional timeout in milliseconds to wait for the node to be found.\n * @returns Node if found, undefined otherwise.\n */\n// TODO(wittjosiah): Factor out to @dxos/app-graph/react.\nexport const useNode = <T = any>(graph: AppGraph.ReadableGraph, id?: string): AppGraphNode.Node<T> | undefined => {\n  const atom = useMemo(() => graph.node(id ?? ''), [graph, id]);\n  return Option.getOrElse(useAtomValue(atom), () => undefined);\n};\n\nexport const useConnections = (\n  graph: AppGraph.ReadableGraph,\n  id: string | undefined,\n  relation: AppGraphNode.RelationInput,\n): AppGraphNode.Node[] => {\n  return useAtomValue(graph.connections(id ?? '', relation));\n};\n\n/**\n * React hook to get actions available for a node.\n *\n * @param graph Graph containing the node.\n * @param id Id of the node.\n * @returns Actions available for the node.\n */\nexport const useActions = (graph: AppGraph.ReadableGraph, id?: string): AppGraphNode.Node[] => {\n  const atom = useMemo(() => graph.actions(id ?? ''), [graph, id]);\n  return useAtomValue(atom);\n};\n\n/**\n * Subscribe to just the edge topology (inbound/outbound IDs) of a node without subscribing to node content.\n *\n * @param graph Graph containing the node.\n * @param id Id of the node.\n * @returns Edge topology for the node.\n */\nexport const useEdges = (graph: AppGraph.ReadableGraph, id?: string): AppGraph.Edges => {\n  const atom = useMemo(() => graph.edges(id ?? ''), [graph, id]);\n  return useAtomValue(atom);\n};\n"],"mappings":";;;;;;;;;;AAeA,IAAa,wBAAwB;CACnC,MAAM,UAAU,oBAAoB;CACpC,MAAM,gBAAgB,iBAAiB;CAEvC,OAAO,aACJ,QAA6B,SAAmC,CAAC,MAChE,UAAU,SAAS,cAAc,cAAc,QAAQ,MAAM,GAC/D,CAAC,SAAS,cAAc,YAAY,CACtC;AACF;;;;;;;;;;;ACJA,IAAa,WAAoB,OAA+B,OAAkD;CAChH,MAAM,OAAO,cAAc,MAAM,KAAK,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;CAC5D,OAAO,OAAO,UAAU,aAAa,IAAI,SAAS,KAAA,CAAS;AAC7D;AAEA,IAAa,kBACX,OACA,IACA,aACwB;CACxB,OAAO,aAAa,MAAM,YAAY,MAAM,IAAI,QAAQ,CAAC;AAC3D;;;;;;;;AASA,IAAa,cAAc,OAA+B,OAAqC;CAC7F,MAAM,OAAO,cAAc,MAAM,QAAQ,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;CAC/D,OAAO,aAAa,IAAI;AAC1B;;;;;;;;AASA,IAAa,YAAY,OAA+B,OAAgC;CACtF,MAAM,OAAO,cAAc,MAAM,MAAM,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;CAC7D,OAAO,aAAa,IAAI;AAC1B"}
+{"version":3,"file":"hooks.mjs","names":[],"sources":["../../src/hooks/useActionRunner.ts","../../src/hooks/useGraphTreeModel.ts","../../src/hooks/useNode.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { useCallback } from 'react';\n\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport * as PluginManagerProvider from '@dxos/app-framework/PluginManagerProvider';\nimport type * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\n\nimport { runAction } from '../action.ts';\n\n/**\n * Hook that returns a function to run action Effects.\n * Provides Operation.Service, PluginContextService, and captured plugin context.\n */\nexport const useActionRunner = () => {\n  const invoker = Hooks.useOperationInvoker();\n  const pluginManager = PluginManagerProvider.usePluginManager();\n\n  return useCallback(\n    (action: AppGraphNode.Action, params: AppGraphNode.InvokeProps = {}) =>\n      runAction(invoker, pluginManager.capabilities, action, params),\n    [invoker, pluginManager.capabilities],\n  );\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Option from 'effect/Option';\nimport * as Atom from 'effect/reactivity/Atom';\nimport { useMemo } from 'react';\n\nimport type * as AppGraph from '@dxos/app-graph/AppGraph';\nimport * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\nimport * as Hooks from '@dxos/app-toolkit/Hooks';\nimport { Path, type TreeModel } from '@dxos/react-ui-list';\nimport { mx } from '@dxos/ui-theme';\n\nexport type GraphTreeState = {\n  /** Open state keyed by the joined path (`Path.create`). */\n  itemOpen: (path: string[]) => Atom.Atom<boolean>;\n  /** Selected state keyed by the joined path. */\n  itemCurrent: (path: string[]) => Atom.Atom<boolean>;\n};\n\n/** Rows the tree lists: not hidden, and either a plain node or an action the graph marks as an item. */\nconst isItem = (node: AppGraphNode.Node): boolean =>\n  !AppGraphNode.hasDisposition(node, 'hidden') &&\n  (!AppGraphNode.isAction(node) || AppGraphNode.hasDisposition(node, 'item'));\n\n/**\n * A `TreeModel` over the app graph: topology and row props come from the graph, open/current state\n * from the caller, so one mapping serves the navtree (persisted state) and any other tree host.\n */\nexport const createGraphTreeModel = (\n  graph: AppGraph.ReadableGraph,\n  rootId: string,\n  { itemOpen, itemCurrent }: GraphTreeState,\n): TreeModel<AppGraphNode.Node> => {\n  const isVisibleChild = (node: AppGraphNode.Node) => !AppGraphNode.hasDisposition(node, 'hidden');\n\n  const itemPropsFamily = Atom.family((pathKey: string) => {\n    const path = Path.parts(pathKey);\n    const id = Path.last(pathKey);\n    return Atom.make((get) => {\n      const node = Option.getOrUndefined(get(graph.node(id)));\n      if (!node) {\n        return { id, label: id };\n      }\n      const safeChildren = get(graph.connections(node.id, 'child')).filter((child) => !path.includes(child.id));\n      const visibleChildren = safeChildren.filter(isVisibleChild);\n      const parentOf =\n        visibleChildren.length > 0\n          ? visibleChildren.map((child) => child.id)\n          : node.properties.role === 'branch'\n            ? []\n            : undefined;\n      const parentId = path.length >= 2 ? path[path.length - 2] : undefined;\n      const parentNode = parentId ? Option.getOrUndefined(get(graph.node(parentId))) : undefined;\n      const droppable =\n        node.properties.droppable === false || parentNode?.properties.childrenDroppable === false ? false : undefined;\n      const disposition = node.properties.disposition as string | undefined;\n      const isGroup = disposition === 'group';\n      return {\n        id: node.id,\n        parentOf: isGroup ? undefined : parentOf,\n        disposition,\n        disabled: isGroup || node.properties.disabled,\n        draggable: isGroup ? false : node.properties.draggable,\n        droppable: isGroup ? false : droppable,\n        label: node.properties.label ?? node.id,\n        className: mx(node.properties.className, node.properties.modified && 'italic'),\n        headingClassName: node.properties.headingClassName,\n        icon: node.properties.icon,\n        iconHue: node.properties.iconHue,\n        testId: node.properties.testId,\n        count: node.properties.count,\n        modifiedCount: node.properties.modifiedCount,\n      };\n    }).pipe(Atom.keepAlive);\n  });\n\n  const childIdsFamily = Atom.family((id: string) =>\n    Atom.make((get) =>\n      get(graph.connections(id, 'child'))\n        .filter(isVisibleChild)\n        .map((child) => child.id),\n    ).pipe(Atom.keepAlive),\n  );\n\n  const itemFamily = Atom.family((id: string) =>\n    Atom.make((get) => {\n      const node = Option.getOrUndefined(get(graph.node(id)));\n      return node && isItem(node) ? node : undefined;\n    }).pipe(Atom.keepAlive),\n  );\n\n  const itemOpenFamily = Atom.family((pathKey: string) => itemOpen(Path.parts(pathKey)));\n  const itemCurrentFamily = Atom.family((pathKey: string) => itemCurrent(Path.parts(pathKey)));\n\n  return {\n    item: (id) => itemFamily(id),\n    itemProps: (path) => itemPropsFamily(Path.create(...path)),\n    itemOpen: (path) => itemOpenFamily(Path.create(...path)),\n    itemCurrent: (path) => itemCurrentFamily(Path.create(...path)),\n    childIds: (parentId) => childIdsFamily(parentId ?? rootId),\n  };\n};\n\n/** {@link createGraphTreeModel} over the app graph capability, memoised on its inputs. */\nexport const useGraphTreeModel = (rootId: string, options: GraphTreeState): TreeModel<AppGraphNode.Node> => {\n  const { graph } = Hooks.useAppGraph();\n  const { itemOpen, itemCurrent } = options;\n  return useMemo(\n    () => createGraphTreeModel(graph, rootId, { itemOpen, itemCurrent }),\n    [graph, rootId, itemOpen, itemCurrent],\n  );\n};\n","//\n// Copyright 2024 DXOS.org\n//\n\nimport { useAtomValue } from '@effect/atom-react/Hooks';\nimport * as Option from 'effect/Option';\nimport { useMemo } from 'react';\n\nimport type * as AppGraph from '@dxos/app-graph/AppGraph';\nimport type * as AppGraphNode from '@dxos/app-graph/AppGraphNode';\n\n/**\n * React hook to get a node from the graph.\n *\n * @param graph Graph to find the node in.\n * @param id Id of the node to find.\n * @param timeout Optional timeout in milliseconds to wait for the node to be found.\n * @returns Node if found, undefined otherwise.\n */\n// TODO(wittjosiah): Factor out to @dxos/app-graph/react.\nexport const useNode = <T = any>(graph: AppGraph.ReadableGraph, id?: string): AppGraphNode.Node<T> | undefined => {\n  const atom = useMemo(() => graph.node(id ?? ''), [graph, id]);\n  return Option.getOrElse(useAtomValue(atom), () => undefined);\n};\n\nexport const useConnections = (\n  graph: AppGraph.ReadableGraph,\n  id: string | undefined,\n  relation: AppGraphNode.RelationInput,\n): AppGraphNode.Node[] => {\n  return useAtomValue(graph.connections(id ?? '', relation));\n};\n\n/**\n * React hook to get actions available for a node.\n *\n * @param graph Graph containing the node.\n * @param id Id of the node.\n * @returns Actions available for the node.\n */\nexport const useActions = (graph: AppGraph.ReadableGraph, id?: string): AppGraphNode.Node[] => {\n  const atom = useMemo(() => graph.actions(id ?? ''), [graph, id]);\n  return useAtomValue(atom);\n};\n\n/**\n * Subscribe to just the edge topology (inbound/outbound IDs) of a node without subscribing to node content.\n *\n * @param graph Graph containing the node.\n * @param id Id of the node.\n * @returns Edge topology for the node.\n */\nexport const useEdges = (graph: AppGraph.ReadableGraph, id?: string): AppGraph.Edges => {\n  const atom = useMemo(() => graph.edges(id ?? ''), [graph, id]);\n  return useAtomValue(atom);\n};\n"],"mappings":"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"}

package/dist/lib/index.mjs

@@ -1,4 +1,4 @@
+import { t as GraphAction_exports } from "./ns/GraphAction.mjs";
+import { t as Hooks_exports } from "./ns/Hooks.mjs";
 import { t as GraphPlugin_exports } from "./GraphPlugin.mjs";
-import { t as runAction } from "./chunk-action.mjs";
-export * from "#meta";
-export { GraphPlugin_exports as GraphPlugin, runAction };
+export { GraphAction_exports as GraphAction, GraphPlugin_exports as GraphPlugin, Hooks_exports as Hooks };

package/dist/lib/meta.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"meta.mjs","names":[],"sources":["../../dx.config.ts","../../src/meta.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.graph',\n    name: 'Graph',\n    author: 'DXOS',\n    description: trim`\n      Graph database layer providing relationship modeling and queries for workspace objects.\n      Build knowledge graphs and explore complex data relationships.\n    `,\n    tags: ['system'],\n  },\n});\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\n\nimport config from '../dx.config';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n"],"mappings":";;;;AAOA,IAAA,oBAAe,QAAQ,KAAK,EAC1B,QAAQ;CACN,KAAK;CACL,MAAM;CACN,QAAQ;CACR,aAAa,IAAI;;;;CAIjB,MAAM,CAAC,QAAQ;AACjB,EACF,CAAC;;;ACVD,IAAa,OAAO,OAAO,kBAAkB,iBAAM"}
+{"version":3,"file":"meta.mjs","names":[],"sources":["../../dx.config.ts","../../src/meta.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.graph',\n    name: 'Graph',\n    author: 'DXOS',\n    description: trim`\n      Graph database layer providing relationship modeling and queries for workspace objects.\n      Build knowledge graphs and explore complex data relationships.\n    `,\n    tags: ['system'],\n  },\n});\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\n\nimport config from '../dx.config.ts';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n"],"mappings":";;;;AAOA,IAAA,oBAAe,QAAQ,KAAK,EAC1B,QAAQ;CACN,KAAK;CACL,MAAM;CACN,QAAQ;CACR,aAAa,IAAI;;;;CAIjB,MAAM,CAAC,QAAQ;AACjB,EACF,CAAC;;;ACVD,IAAa,OAAO,OAAO,kBAAkB,iBAAM"}

package/dist/lib/ns/GraphAction.mjs

@@ -0,0 +1,8 @@
+import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
+import { t as runAction } from "../chunk-action.mjs";
+//#region src/GraphAction.ts
+var GraphAction_exports = /* @__PURE__ */ __exportAll({ run: () => runAction });
+//#endregion
+export { runAction as run, GraphAction_exports as t };
+
+//# sourceMappingURL=GraphAction.mjs.map

package/dist/lib/ns/GraphAction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphAction.mjs","names":[],"sources":["../../../src/GraphAction.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nexport { runAction as run } from './action.ts';\n"],"mappings":""}

package/dist/lib/ns/Hooks.mjs

@@ -0,0 +1,10 @@
+import { n as __reExport, t as __exportAll } from "../chunk-rolldown-runtime.mjs";
+export * from "#hooks";
+//#region src/Hooks.ts
+var Hooks_exports = /* @__PURE__ */ __exportAll({});
+import * as import__hooks from "#hooks";
+__reExport(Hooks_exports, import__hooks);
+//#endregion
+export { Hooks_exports as t };
+
+//# sourceMappingURL=Hooks.mjs.map

package/dist/lib/ns/Hooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hooks.mjs","names":[],"sources":["../../../src/Hooks.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nexport * from '#hooks';\n"],"mappings":""}

package/dist/lib/plugin.mjs

@@ -1,6 +1,6 @@
+import * as Capability from "@dxos/app-framework/Capability";
 import * as Plugin from "@dxos/app-framework/Plugin";
 import { meta } from "#meta";
-import * as Capability from "@dxos/app-framework/Capability";
 import * as Capabilities from "@dxos/app-framework/Capabilities";
 import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
 //#region src/plugin.ts

package/dist/lib/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/plugin.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\n\nimport { meta } from '#meta';\n\nconst Graph = Capability.lazyModule(\n  'Graph',\n  { requires: [Capabilities.AtomRegistry], provides: [AppCapabilities.AppGraph] },\n  () => import('./graph'),\n);\n\n/**\n * Manages the state of the graph for the application.\n * Enables other plugins to register node builders to add nodes to the graph.\n * This includes actions and annotation each other's nodes.\n */\nexport const GraphPlugin = Plugin.define(meta).pipe(Plugin.addModule(Graph), Plugin.make);\n\nexport default GraphPlugin;\n"],"mappings":";;;;;;AAWA,IAAM,QAAQ,WAAW,WACvB,SACA;CAAE,UAAU,CAAC,aAAa,YAAY;CAAG,UAAU,CAAC,gBAAgB,QAAQ;AAAE,SACxE,OAAO,oBACf;;;;;;AAOA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,UAAU,KAAK,GAAG,OAAO,IAAI"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/plugin.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\n\nimport { meta } from '#meta';\n\nconst Graph = Capability.lazyModule(\n  'Graph',\n  { requires: [Capabilities.AtomRegistry], provides: [AppCapabilities.AppGraph] },\n  () => import('./graph.ts'),\n);\n\n/**\n * Manages the state of the graph for the application.\n * Enables other plugins to register node builders to add nodes to the graph.\n * This includes actions and annotation each other's nodes.\n */\nexport const GraphPlugin = Plugin.define(meta).pipe(Plugin.addModule(Graph), Plugin.make);\n\nexport default GraphPlugin;\n"],"mappings":";;;;;;AAWA,IAAM,QAAQ,WAAW,WACvB,SACA;CAAE,UAAU,CAAC,aAAa,YAAY;CAAG,UAAU,CAAC,gBAAgB,QAAQ;AAAE,SACxE,OAAO,oBACf;;;;;;AAOA,IAAa,cAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,UAAU,KAAK,GAAG,OAAO,IAAI"}

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

@@ -0,0 +1,2 @@
+export { runAction as run } from './action.ts';
+//# sourceMappingURL=GraphAction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GraphAction.d.ts","sourceRoot":"","sources":["../../../src/GraphAction.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC"}

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

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

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

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

package/dist/types/src/hooks/graph-tree-model.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph-tree-model.test.d.ts.map

package/dist/types/src/hooks/graph-tree-model.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-tree-model.test.d.ts","sourceRoot":"","sources":["../../../../src/hooks/graph-tree-model.test.ts"],"names":[],"mappings":""}

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

@@ -1,3 +1,4 @@
-export * from './useActionRunner';
-export * from './useNode';
+export * from './useActionRunner.ts';
+export * from './useGraphTreeModel.ts';
+export * from './useNode.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAOA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAOA,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useActionRunner.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useActionRunner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,KAAK,YAAY,MAAM,8BAA8B,CAAC;AAIlE;;;GAGG;AACH,eAAO,MAAM,eAAe,iBAKf,YAAY,CAAC,MAAM,WAAU,YAAY,CAAC,WAAW,kBAIjE,CAAC"}
+{"version":3,"file":"useActionRunner.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useActionRunner.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,YAAY,MAAM,8BAA8B,CAAC;AAIlE;;;GAGG;AACH,eAAO,MAAM,eAAe,iBAKf,YAAY,CAAC,MAAM,WAAU,YAAY,CAAC,WAAW,kBAIjE,CAAC"}

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

@@ -0,0 +1,18 @@
+import * as Atom from 'effect/reactivity/Atom';
+import type * as AppGraph from '@dxos/app-graph/AppGraph';
+import * as AppGraphNode from '@dxos/app-graph/AppGraphNode';
+import { type TreeModel } from '@dxos/react-ui-list';
+export type GraphTreeState = {
+    /** Open state keyed by the joined path (`Path.create`). */
+    itemOpen: (path: string[]) => Atom.Atom<boolean>;
+    /** Selected state keyed by the joined path. */
+    itemCurrent: (path: string[]) => Atom.Atom<boolean>;
+};
+/**
+ * A `TreeModel` over the app graph: topology and row props come from the graph, open/current state
+ * from the caller, so one mapping serves the navtree (persisted state) and any other tree host.
+ */
+export declare const createGraphTreeModel: (graph: AppGraph.ReadableGraph, rootId: string, { itemOpen, itemCurrent }: GraphTreeState) => TreeModel<AppGraphNode.Node>;
+/** {@link createGraphTreeModel} over the app graph capability, memoised on its inputs. */
+export declare const useGraphTreeModel: (rootId: string, options: GraphTreeState) => TreeModel<AppGraphNode.Node>;
+//# sourceMappingURL=useGraphTreeModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGraphTreeModel.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGraphTreeModel.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAG/C,OAAO,KAAK,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,YAAY,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG3D,MAAM,MAAM,cAAc,GAAG;IAC3B,2DAA2D;IAC3D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,+CAA+C;IAC/C,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;CACrD,CAAC;AAOF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UACxB,QAAQ,CAAC,aAAa,UACrB,MAAM,6BACa,cAAc,KACxC,SAAS,CAAC,YAAY,CAAC,IAAI,CAqE7B,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,WAAY,MAAM,WAAW,cAAc,KAAG,SAAS,CAAC,YAAY,CAAC,IAAI,CAOtG,CAAC"}

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

@@ -1,4 +1,4 @@
-export * as GraphPlugin from './GraphPlugin';
-export * from './action';
-export * from '#meta';
+export * as GraphAction from './GraphAction.ts';
+export * as GraphPlugin from './GraphPlugin.ts';
+export * as Hooks from './Hooks.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/testing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC"}