@dxos/app-graph 0.3.11-main.fbbdc2a → 0.3.11-main.fe789c1

package/dist/lib/browser/index.mjs

@@ -78,6 +78,7 @@ import { untracked } from "@preact/signals-react";
 import { deepSignal as deepSignal2 } from "deepsignal/react";
 import { EventSubscriptions } from "@dxos/async";
 import { Keyboard } from "@dxos/keyboard";
+var KEY_BINDING = "KeyBinding";
 var GraphBuilder = class {
   constructor() {
     this._nodeBuilders = /* @__PURE__ */ new Map();
@@ -193,9 +194,11 @@ var GraphBuilder = class {
             const action = this._createAction(partial2);
             if (action.keyBinding) {
               Keyboard.singleton.getContext(path.join("/")).bind({
-                binding: action.keyBinding,
+                shortcut: action.keyBinding,
                 handler: () => {
-                  action.invoke();
+                  action.invoke({
+                    caller: KEY_BINDING
+                  });
                 },
                 data: action.label
               });
@@ -263,6 +266,7 @@ var isGraphNode = (data) => data && typeof data === "object" ? "id" in data && "
 export {
   Graph,
   GraphBuilder,
+  KEY_BINDING,
   isGraphNode
 };
 //# sourceMappingURL=index.mjs.map

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/graph.ts", "../../../src/graph-builder.ts", "../../../src/node.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { deepSignal } from 'deepsignal/react';\n// TODO(wittjosiah): Remove lodash dependency.\nimport get from 'lodash.get';\n\nimport { type Label } from './action';\nimport { type Node } from './node';\n\nexport type TraversalOptions = {\n  /**\n   * The node to start traversing from. Defaults to the root node.\n   */\n  node?: Node;\n\n  /**\n   * The direction to traverse the graph. Defaults to 'down'.\n   */\n  direction?: 'up' | 'down';\n\n  /**\n   * A predicate to filter nodes which are passed to the `visitor` callback.\n   */\n  filter?: (node: Node) => boolean;\n\n  /**\n   * A callback which is called for each node visited during traversal.\n   */\n  visitor?: (node: Node, path: string[]) => void;\n};\n\n/**\n * The Graph represents the structure of the application constructed via plugins.\n */\nexport class Graph {\n  // TODO(wittjosiah): Should this support multiple paths to the same node?\n  private readonly _index = deepSignal<{ [key: string]: string[] }>({});\n\n  constructor(private readonly _root: Node) {}\n\n  toJSON() {\n    const toLabel = (label: Label) => (Array.isArray(label) ? `${label[1].ns}[${label[0]}]` : label);\n    const toJSON = (node: Node): any => {\n      return {\n        id: node.id.slice(0, 16),\n        label: toLabel(node.label),\n        children: node.children.length ? node.children.map((node) => toJSON(node)) : undefined,\n        actions: node.actions.length\n          ? node.actions.map(({ id, label }) => ({\n              id,\n              label: toLabel(label),\n            }))\n          : undefined,\n      };\n    };\n\n    return toJSON(this._root);\n  }\n\n  /**\n   * The root node of the graph which is the entry point for all knowledge.\n   */\n  get root(): Node {\n    return this._root;\n  }\n\n  /**\n   * Get the path through the graph from the root to the node with the given id.\n   */\n  getPath(id: string): string[] | undefined {\n    return this._index[id];\n  }\n\n  /**\n   * @internal\n   */\n  _setPath(id: string, path: string[]) {\n    this._index[id] = path;\n  }\n\n  /**\n   * Find the node with the given id in the graph.\n   */\n  findNode(id: string): Node | undefined {\n    const path = this.getPath(id);\n    if (!path) {\n      return undefined;\n    }\n\n    return path.length > 0 ? get(this._root, path) : this._root;\n  }\n\n  /**\n   * Recursive breadth-first traversal.\n   */\n  traverse({ node = this._root, direction = 'down', filter, visitor }: TraversalOptions, depth = 0): void {\n    if (!filter || filter(node)) {\n      visitor?.(node, this.getPath(node.id)!);\n    }\n\n    if (direction === 'down') {\n      Object.values(node.children).forEach((child) => this.traverse({ node: child, filter, visitor }));\n    } else if (direction === 'up' && node.parent) {\n      this.traverse({ node: node.parent, direction, filter, visitor }, depth + 1);\n    }\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { untracked } from '@preact/signals-react';\nimport { type RevertDeepSignal, deepSignal } from 'deepsignal/react';\n\nimport { EventSubscriptions } from '@dxos/async';\nimport { Keyboard } from '@dxos/keyboard';\n\nimport type { ActionArg, Action } from './action';\nimport { Graph } from './graph';\nimport type { NodeArg, Node, NodeBuilder } from './node';\n\n/**\n * The builder...\n */\nexport class GraphBuilder {\n  private readonly _nodeBuilders = new Map<string, NodeBuilder>();\n  private readonly _unsubscribe = new Map<string, EventSubscriptions>();\n\n  /**\n   * Register a node builder which will be called in order to construct the graph.\n   */\n  addNodeBuilder(id: string, builder: NodeBuilder): GraphBuilder {\n    this._nodeBuilders.set(id, builder);\n    return this;\n  }\n\n  /**\n   * Remove a node builder from the graph builder.\n   */\n  removeNodeBuilder(id: string): GraphBuilder {\n    this._nodeBuilders.delete(id);\n    return this;\n  }\n\n  /**\n   * Construct the graph, starting by calling all registered node builders on the root node.\n   * Node builders will be filtered out as they are used such that they are only used once on any given path.\n   * @param previousGraph If provided, the graph will be updated in place.\n   * @param startingPath If provided, the graph will be updated starting at the given path.\n   */\n  build(previousGraph?: Graph, startingPath: string[] = []): Graph {\n    const graph: Graph = previousGraph ?? new Graph(this._createNode(() => graph, { id: 'root', label: 'Root' }));\n    return this._build(graph, graph.root, startingPath);\n  }\n\n  /**\n   * Called recursively.\n   */\n  private _build(graph: Graph, node: Node, path: string[] = [], ignoreBuilders: string[] = []): Graph {\n    // TODO(wittjosiah): Should this support multiple paths to the same node?\n    graph._setPath(node.id, path);\n\n    // TODO(burdon): Document.\n    const subscriptions = this._unsubscribe.get(node.id) ?? new EventSubscriptions();\n    subscriptions.clear();\n\n    Array.from(this._nodeBuilders.entries())\n      .filter(([id]) => ignoreBuilders.findIndex((ignore) => ignore === id) === -1)\n      .forEach(([_, builder]) => {\n        const unsubscribe = builder(node);\n        unsubscribe && subscriptions.add(unsubscribe);\n      });\n\n    this._unsubscribe.set(node.id, subscriptions);\n\n    return graph;\n  }\n\n  private _createNode<TData = null, TProperties extends Record<string, any> = Record<string, any>>(\n    getGraph: () => Graph,\n    partial: NodeArg<TData, TProperties>,\n    path: string[] = [],\n    ignoreBuilders: string[] = [],\n  ): Node<TData, TProperties> {\n    // TODO(burdon): Document implications and rationale of deepSignal.\n    const node: Node<TData, TProperties> = deepSignal({\n      parent: null,\n      data: null as TData, // TODO(burdon): Allow null property?\n      properties: {} as TProperties,\n      childrenMap: {},\n      actionsMap: {},\n      // TODO(burdon): Document.\n      ...partial,\n\n      get children() {\n        return Object.values(node.childrenMap);\n      },\n      get actions() {\n        return Object.values(node.actionsMap);\n      },\n\n      //\n      // Properties\n      //\n\n      addProperty: (key, value) => {\n        untracked(() => {\n          (node.properties as Record<string, any>)[key] = value;\n        });\n      },\n      removeProperty: (key) => {\n        untracked(() => {\n          delete (node.properties as Record<string, any>)[key];\n        });\n      },\n\n      //\n      // Nodes\n      //\n\n      addNode: (builder, ...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const builders = [...ignoreBuilders, builder];\n            const childPath = [...path, 'childrenMap', partial.id];\n            const child = this._createNode(getGraph, { ...partial, parent: node }, childPath, builders);\n            node.childrenMap[child.id] = child;\n            // TODO(burdon): Defer triggering recursive updates until task has completed.\n            this._build(getGraph(), child, childPath, builders);\n            return child;\n          });\n        });\n      },\n      removeNode: (id) => {\n        return untracked(() => {\n          const child = node.childrenMap[id];\n          delete node.childrenMap[id];\n          return child;\n        });\n      },\n\n      //\n      // Actions\n      //\n\n      addAction: (...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const action = this._createAction(partial);\n            if (action.keyBinding) {\n              Keyboard.singleton.getContext(path.join('/')).bind({\n                binding: action.keyBinding!,\n                handler: () => {\n                  action.invoke();\n                },\n                data: action.label,\n              });\n            }\n\n            node.actionsMap[action.id] = action;\n            return action;\n          });\n        });\n      },\n      removeAction: (id) => {\n        return untracked(() => {\n          const action = node.actionsMap[id];\n          if (action.keyBinding) {\n            // keyboardjs.unbind(action.keyBinding);\n          }\n\n          delete node.actionsMap[id];\n          return action;\n        });\n      },\n    }) as RevertDeepSignal<Node<TData, TProperties>>;\n\n    // Only actions added at this stage are available to subsequent builders.\n    // `addNode` immediately passes the new node to other builders.\n    // As such, actions added later with `addAction` are not available to those builders.\n    // Having actions available to subsequent builders is useful for building groups.\n    partial.actions && partial.actions.forEach((action) => node.addAction(action));\n\n    return node;\n  }\n\n  private _createAction<TProperties extends Record<string, any> = Record<string, any>>(\n    partial: ActionArg<TProperties>,\n  ): Action<TProperties> {\n    const action: Action<TProperties> = deepSignal({\n      properties: {} as TProperties,\n      ...partial,\n      actionsMap: {},\n      get actions() {\n        return Object.values(action.actionsMap);\n      },\n      addAction: (...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const subAction = this._createAction(partial);\n            action.actionsMap[subAction.id] = subAction;\n            return subAction;\n          });\n        });\n      },\n      removeAction: (id) => {\n        return untracked(() => {\n          const subAction = action.actionsMap[id];\n          delete action.actionsMap[id];\n          return subAction;\n        });\n      },\n      addProperty: (key, value) => {\n        return untracked(() => {\n          (action.properties as Record<string, any>)[key] = value;\n        });\n      },\n      removeProperty: (key) => {\n        return untracked(() => {\n          delete (action.properties as Record<string, any>)[key];\n        });\n      },\n    }) as RevertDeepSignal<Action<TProperties>>;\n\n    partial.actions && partial.actions.forEach((subAction) => action.addAction(subAction));\n\n    return action;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport type { IconProps } from '@phosphor-icons/react';\nimport { type FC } from 'react';\n\nimport type { UnsubscribeCallback } from '@dxos/async';\n\nimport { type ActionArg, type Action, type Label } from './action';\n\n/**\n * Called when a node is added to the graph, allowing other node builders to add children, actions or properties.\n */\nexport type NodeBuilder = (parent: Node) => UnsubscribeCallback | void;\n\n/**\n * Represents a node in the graph.\n */\nexport type Node<TData = any, TProperties extends Record<string, any> = Record<string, any>> = {\n  /**\n   * Globally unique ID.\n   */\n  id: string;\n\n  /**\n   * Parent node in the graph.\n   */\n  parent: Node | null;\n\n  /**\n   * Label to be used when displaying the node.\n   * For default labels, use a translated string.\n   *\n   * @example 'My Node'\n   * @example ['unknown node label, { ns: 'example-plugin' }]\n   */\n  label: Label;\n\n  /**\n   * Description to be used when displaying a detailed view of the node.\n   * For default descriptions, use a translated string.\n   */\n  description?: Label;\n\n  /**\n   * Icon to be used when displaying the node.\n   */\n  icon?: FC<IconProps>;\n\n  /**\n   * Properties of the node relevant to displaying the node.\n   */\n  // TODO(burdon): Make this extensible and move label, description, and icon into here?\n  properties: TProperties;\n\n  /**\n   * Data the node represents.\n   */\n  // TODO(burdon): Type system (e.g., minimally provide identifier string vs. TypedObject vs. Graph mixin type system)?\n  //  type field would prevent convoluted sniffing of object properties. And allow direct pass-through for ECHO TypedObjects.\n  // TODO(burdon): In some places `null` is cast to TData so make optional?\n  data: TData;\n\n  /**\n   * Children of the node stored by their id.\n   */\n  // TODO(burdon): Rename nodes/nodeMap?\n  childrenMap: Record<string, Node>;\n\n  /**\n   * Actions of the node stored by their id.\n   */\n  actionsMap: Record<string, Action>;\n\n  /**\n   * Children of the node in default order.\n   */\n  get children(): Node[];\n\n  /**\n   * Actions of the node in default order.\n   */\n  get actions(): Action[];\n\n  addProperty(key: string, value: any): void;\n  removeProperty(key: string): void;\n\n  addNode<TChildData = null, TChildProperties extends Record<string, any> = Record<string, any>>(\n    id: string,\n    ...node: NodeArg<TChildData, TChildProperties>[]\n  ): Node<TChildData, TChildProperties>[];\n  removeNode(id: string): Node;\n\n  addAction<TActionProperties extends Record<string, any> = Record<string, any>>(\n    ...action: ActionArg<TActionProperties>[]\n  ): Action<TActionProperties>[];\n  removeAction(id: string): Action;\n};\n\nexport type NodeArg<TData = null, TProperties extends Record<string, any> = Record<string, any>> = Pick<\n  Node,\n  'id' | 'label'\n> &\n  Partial<Omit<Node<TData, TProperties>, 'id' | 'label' | 'actions'>> & { actions?: ActionArg[] };\n\nexport const isGraphNode = (data: unknown): data is Node =>\n  data && typeof data === 'object' ? 'id' in data && 'label' in data : false;\n"],
-  "mappings": "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",
-  "names": ["deepSignal", "get", "Graph", "constructor", "_root", "_index", "deepSignal", "toJSON", "toLabel", "label", "Array", "isArray", "ns", "node", "id", "slice", "children", "length", "map", "undefined", "actions", "root", "getPath", "_setPath", "path", "findNode", "get", "traverse", "direction", "filter", "visitor", "depth", "Object", "values", "forEach", "child", "parent", "untracked", "deepSignal", "EventSubscriptions", "Keyboard", "GraphBuilder", "_nodeBuilders", "Map", "_unsubscribe", "addNodeBuilder", "id", "builder", "set", "removeNodeBuilder", "delete", "build", "previousGraph", "startingPath", "graph", "Graph", "_createNode", "label", "_build", "root", "node", "path", "ignoreBuilders", "_setPath", "subscriptions", "get", "EventSubscriptions", "clear", "Array", "from", "entries", "filter", "findIndex", "ignore", "forEach", "_", "unsubscribe", "add", "getGraph", "partial", "deepSignal", "parent", "data", "properties", "childrenMap", "actionsMap", "children", "Object", "values", "actions", "addProperty", "key", "value", "untracked", "removeProperty", "addNode", "partials", "map", "builders", "childPath", "child", "removeNode", "addAction", "action", "_createAction", "keyBinding", "Keyboard", "singleton", "getContext", "join", "bind", "binding", "handler", "invoke", "removeAction", "subAction", "isGraphNode", "data"]
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { deepSignal } from 'deepsignal/react';\n// TODO(wittjosiah): Remove lodash dependency.\nimport get from 'lodash.get';\n\nimport { type Label } from './action';\nimport { type Node } from './node';\n\nexport type TraversalOptions = {\n  /**\n   * The node to start traversing from. Defaults to the root node.\n   */\n  node?: Node;\n\n  /**\n   * The direction to traverse the graph. Defaults to 'down'.\n   */\n  direction?: 'up' | 'down';\n\n  /**\n   * A predicate to filter nodes which are passed to the `visitor` callback.\n   */\n  filter?: (node: Node) => boolean;\n\n  /**\n   * A callback which is called for each node visited during traversal.\n   */\n  visitor?: (node: Node, path: string[]) => void;\n};\n\n/**\n * The Graph represents the structure of the application constructed via plugins.\n */\nexport class Graph {\n  // TODO(wittjosiah): Should this support multiple paths to the same node?\n  private readonly _index = deepSignal<{ [key: string]: string[] }>({});\n\n  constructor(private readonly _root: Node) {}\n\n  toJSON() {\n    const toLabel = (label: Label) => (Array.isArray(label) ? `${label[1].ns}[${label[0]}]` : label);\n    const toJSON = (node: Node): any => {\n      return {\n        id: node.id.slice(0, 16),\n        label: toLabel(node.label),\n        children: node.children.length ? node.children.map((node) => toJSON(node)) : undefined,\n        actions: node.actions.length\n          ? node.actions.map(({ id, label }) => ({\n              id,\n              label: toLabel(label),\n            }))\n          : undefined,\n      };\n    };\n\n    return toJSON(this._root);\n  }\n\n  /**\n   * The root node of the graph which is the entry point for all knowledge.\n   */\n  get root(): Node {\n    return this._root;\n  }\n\n  /**\n   * Get the path through the graph from the root to the node with the given id.\n   */\n  getPath(id: string): string[] | undefined {\n    return this._index[id];\n  }\n\n  /**\n   * @internal\n   */\n  _setPath(id: string, path: string[]) {\n    this._index[id] = path;\n  }\n\n  /**\n   * Find the node with the given id in the graph.\n   */\n  findNode(id: string): Node | undefined {\n    const path = this.getPath(id);\n    if (!path) {\n      return undefined;\n    }\n\n    return path.length > 0 ? get(this._root, path) : this._root;\n  }\n\n  /**\n   * Recursive breadth-first traversal.\n   */\n  traverse({ node = this._root, direction = 'down', filter, visitor }: TraversalOptions, depth = 0): void {\n    if (!filter || filter(node)) {\n      visitor?.(node, this.getPath(node.id)!);\n    }\n\n    if (direction === 'down') {\n      Object.values(node.children).forEach((child) => this.traverse({ node: child, filter, visitor }));\n    } else if (direction === 'up' && node.parent) {\n      this.traverse({ node: node.parent, direction, filter, visitor }, depth + 1);\n    }\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { untracked } from '@preact/signals-react';\nimport { type RevertDeepSignal, deepSignal } from 'deepsignal/react';\n\nimport { EventSubscriptions } from '@dxos/async';\nimport { Keyboard } from '@dxos/keyboard';\n\nimport type { ActionArg, Action } from './action';\nimport { Graph } from './graph';\nimport type { NodeArg, Node, NodeBuilder } from './node';\n\nexport const KEY_BINDING = 'KeyBinding';\n\n/**\n * The builder...\n */\nexport class GraphBuilder {\n  private readonly _nodeBuilders = new Map<string, NodeBuilder>();\n  private readonly _unsubscribe = new Map<string, EventSubscriptions>();\n\n  /**\n   * Register a node builder which will be called in order to construct the graph.\n   */\n  addNodeBuilder(id: string, builder: NodeBuilder): GraphBuilder {\n    this._nodeBuilders.set(id, builder);\n    return this;\n  }\n\n  /**\n   * Remove a node builder from the graph builder.\n   */\n  removeNodeBuilder(id: string): GraphBuilder {\n    this._nodeBuilders.delete(id);\n    return this;\n  }\n\n  /**\n   * Construct the graph, starting by calling all registered node builders on the root node.\n   * Node builders will be filtered out as they are used such that they are only used once on any given path.\n   * @param previousGraph If provided, the graph will be updated in place.\n   * @param startingPath If provided, the graph will be updated starting at the given path.\n   */\n  build(previousGraph?: Graph, startingPath: string[] = []): Graph {\n    const graph: Graph = previousGraph ?? new Graph(this._createNode(() => graph, { id: 'root', label: 'Root' }));\n    return this._build(graph, graph.root, startingPath);\n  }\n\n  /**\n   * Called recursively.\n   */\n  private _build(graph: Graph, node: Node, path: string[] = [], ignoreBuilders: string[] = []): Graph {\n    // TODO(wittjosiah): Should this support multiple paths to the same node?\n    graph._setPath(node.id, path);\n\n    // TODO(burdon): Document.\n    const subscriptions = this._unsubscribe.get(node.id) ?? new EventSubscriptions();\n    subscriptions.clear();\n\n    Array.from(this._nodeBuilders.entries())\n      .filter(([id]) => ignoreBuilders.findIndex((ignore) => ignore === id) === -1)\n      .forEach(([_, builder]) => {\n        const unsubscribe = builder(node);\n        unsubscribe && subscriptions.add(unsubscribe);\n      });\n\n    this._unsubscribe.set(node.id, subscriptions);\n\n    return graph;\n  }\n\n  private _createNode<TData = null, TProperties extends Record<string, any> = Record<string, any>>(\n    getGraph: () => Graph,\n    partial: NodeArg<TData, TProperties>,\n    path: string[] = [],\n    ignoreBuilders: string[] = [],\n  ): Node<TData, TProperties> {\n    // TODO(burdon): Document implications and rationale of deepSignal.\n    const node: Node<TData, TProperties> = deepSignal({\n      parent: null,\n      data: null as TData, // TODO(burdon): Allow null property?\n      properties: {} as TProperties,\n      childrenMap: {},\n      actionsMap: {},\n      // TODO(burdon): Document.\n      ...partial,\n\n      get children() {\n        return Object.values(node.childrenMap);\n      },\n      get actions() {\n        return Object.values(node.actionsMap);\n      },\n\n      //\n      // Properties\n      //\n\n      addProperty: (key, value) => {\n        untracked(() => {\n          (node.properties as Record<string, any>)[key] = value;\n        });\n      },\n      removeProperty: (key) => {\n        untracked(() => {\n          delete (node.properties as Record<string, any>)[key];\n        });\n      },\n\n      //\n      // Nodes\n      //\n\n      addNode: (builder, ...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const builders = [...ignoreBuilders, builder];\n            const childPath = [...path, 'childrenMap', partial.id];\n            const child = this._createNode(getGraph, { ...partial, parent: node }, childPath, builders);\n            node.childrenMap[child.id] = child;\n            // TODO(burdon): Defer triggering recursive updates until task has completed.\n            this._build(getGraph(), child, childPath, builders);\n            return child;\n          });\n        });\n      },\n      removeNode: (id) => {\n        return untracked(() => {\n          const child = node.childrenMap[id];\n          delete node.childrenMap[id];\n          return child;\n        });\n      },\n\n      //\n      // Actions\n      //\n\n      addAction: (...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const action = this._createAction(partial);\n            if (action.keyBinding) {\n              Keyboard.singleton.getContext(path.join('/')).bind({\n                shortcut: action.keyBinding,\n                handler: () => {\n                  action.invoke({ caller: KEY_BINDING });\n                },\n                data: action.label,\n              });\n            }\n\n            node.actionsMap[action.id] = action;\n            return action;\n          });\n        });\n      },\n      removeAction: (id) => {\n        return untracked(() => {\n          const action = node.actionsMap[id];\n          if (action.keyBinding) {\n            // keyboardjs.unbind(action.keyBinding);\n          }\n\n          delete node.actionsMap[id];\n          return action;\n        });\n      },\n    }) as RevertDeepSignal<Node<TData, TProperties>>;\n\n    // Only actions added at this stage are available to subsequent builders.\n    // `addNode` immediately passes the new node to other builders.\n    // As such, actions added later with `addAction` are not available to those builders.\n    // Having actions available to subsequent builders is useful for building groups.\n    partial.actions && partial.actions.forEach((action) => node.addAction(action));\n\n    return node;\n  }\n\n  private _createAction<TProperties extends Record<string, any> = Record<string, any>>(\n    partial: ActionArg<TProperties>,\n  ): Action<TProperties> {\n    const action: Action<TProperties> = deepSignal({\n      properties: {} as TProperties,\n      ...partial,\n      actionsMap: {},\n      get actions() {\n        return Object.values(action.actionsMap);\n      },\n      addAction: (...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const subAction = this._createAction(partial);\n            action.actionsMap[subAction.id] = subAction;\n            return subAction;\n          });\n        });\n      },\n      removeAction: (id) => {\n        return untracked(() => {\n          const subAction = action.actionsMap[id];\n          delete action.actionsMap[id];\n          return subAction;\n        });\n      },\n      addProperty: (key, value) => {\n        return untracked(() => {\n          (action.properties as Record<string, any>)[key] = value;\n        });\n      },\n      removeProperty: (key) => {\n        return untracked(() => {\n          delete (action.properties as Record<string, any>)[key];\n        });\n      },\n    }) as RevertDeepSignal<Action<TProperties>>;\n\n    partial.actions && partial.actions.forEach((subAction) => action.addAction(subAction));\n\n    return action;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport type { IconProps } from '@phosphor-icons/react';\nimport { type FC } from 'react';\n\nimport type { UnsubscribeCallback } from '@dxos/async';\n\nimport { type ActionArg, type Action, type Label } from './action';\n\n/**\n * Called when a node is added to the graph, allowing other node builders to add children, actions or properties.\n */\nexport type NodeBuilder = (parent: Node) => UnsubscribeCallback | void;\n\n/**\n * Represents a node in the graph.\n */\nexport type Node<TData = any, TProperties extends Record<string, any> = Record<string, any>> = {\n  /**\n   * Globally unique ID.\n   */\n  id: string;\n\n  /**\n   * Parent node in the graph.\n   */\n  parent: Node | null;\n\n  /**\n   * Label to be used when displaying the node.\n   * For default labels, use a translated string.\n   *\n   * @example 'My Node'\n   * @example ['unknown node label, { ns: 'example-plugin' }]\n   */\n  label: Label;\n\n  /**\n   * Description to be used when displaying a detailed view of the node.\n   * For default descriptions, use a translated string.\n   */\n  description?: Label;\n\n  /**\n   * Icon to be used when displaying the node.\n   */\n  icon?: FC<IconProps>;\n\n  /**\n   * Properties of the node relevant to displaying the node.\n   */\n  // TODO(burdon): Make this extensible and move label, description, and icon into here?\n  properties: TProperties;\n\n  /**\n   * Data the node represents.\n   */\n  // TODO(burdon): Type system (e.g., minimally provide identifier string vs. TypedObject vs. Graph mixin type system)?\n  //  type field would prevent convoluted sniffing of object properties. And allow direct pass-through for ECHO TypedObjects.\n  // TODO(burdon): In some places `null` is cast to TData so make optional?\n  data: TData;\n\n  /**\n   * Children of the node stored by their id.\n   */\n  // TODO(burdon): Rename nodes/nodeMap?\n  childrenMap: Record<string, Node>;\n\n  /**\n   * Actions of the node stored by their id.\n   */\n  actionsMap: Record<string, Action>;\n\n  /**\n   * Children of the node in default order.\n   */\n  get children(): Node[];\n\n  /**\n   * Actions of the node in default order.\n   */\n  get actions(): Action[];\n\n  addProperty(key: string, value: any): void;\n  removeProperty(key: string): void;\n\n  addNode<TChildData = null, TChildProperties extends Record<string, any> = Record<string, any>>(\n    id: string,\n    ...node: NodeArg<TChildData, TChildProperties>[]\n  ): Node<TChildData, TChildProperties>[];\n  removeNode(id: string): Node;\n\n  addAction<TActionProperties extends Record<string, any> = Record<string, any>>(\n    ...action: ActionArg<TActionProperties>[]\n  ): Action<TActionProperties>[];\n  removeAction(id: string): Action;\n};\n\nexport type NodeArg<TData = null, TProperties extends Record<string, any> = Record<string, any>> = Pick<\n  Node,\n  'id' | 'label'\n> &\n  Partial<Omit<Node<TData, TProperties>, 'id' | 'label' | 'actions'>> & { actions?: ActionArg[] };\n\nexport const isGraphNode = (data: unknown): data is Node =>\n  data && typeof data === 'object' ? 'id' in data && 'label' in data : false;\n"],
+  "mappings": "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",
+  "names": ["deepSignal", "get", "Graph", "constructor", "_root", "_index", "deepSignal", "toJSON", "toLabel", "label", "Array", "isArray", "ns", "node", "id", "slice", "children", "length", "map", "undefined", "actions", "root", "getPath", "_setPath", "path", "findNode", "get", "traverse", "direction", "filter", "visitor", "depth", "Object", "values", "forEach", "child", "parent", "untracked", "deepSignal", "EventSubscriptions", "Keyboard", "KEY_BINDING", "GraphBuilder", "_nodeBuilders", "Map", "_unsubscribe", "addNodeBuilder", "id", "builder", "set", "removeNodeBuilder", "delete", "build", "previousGraph", "startingPath", "graph", "Graph", "_createNode", "label", "_build", "root", "node", "path", "ignoreBuilders", "_setPath", "subscriptions", "get", "EventSubscriptions", "clear", "Array", "from", "entries", "filter", "findIndex", "ignore", "forEach", "_", "unsubscribe", "add", "getGraph", "partial", "deepSignal", "parent", "data", "properties", "childrenMap", "actionsMap", "children", "Object", "values", "actions", "addProperty", "key", "value", "untracked", "removeProperty", "addNode", "partials", "map", "builders", "childPath", "child", "removeNode", "addAction", "action", "_createAction", "keyBinding", "Keyboard", "singleton", "getContext", "join", "bind", "shortcut", "handler", "invoke", "caller", "removeAction", "subAction", "isGraphNode", "data"]
 }

package/dist/lib/browser/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/sdk/app-graph/src/action.ts":{"bytes":3043,"imports":[],"format":"esm"},"packages/sdk/app-graph/src/graph.ts":{"bytes":9237,"imports":[{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"lodash.get","kind":"import-statement","external":true}],"format":"esm"},"packages/sdk/app-graph/src/graph-builder.ts":{"bytes":23684,"imports":[{"path":"@preact/signals-react","kind":"import-statement","external":true},{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/keyboard","kind":"import-statement","external":true},{"path":"packages/sdk/app-graph/src/graph.ts","kind":"import-statement","original":"./graph"}],"format":"esm"},"packages/sdk/app-graph/src/node.ts":{"bytes":4772,"imports":[],"format":"esm"},"packages/sdk/app-graph/src/index.ts":{"bytes":722,"imports":[{"path":"packages/sdk/app-graph/src/action.ts","kind":"import-statement","original":"./action"},{"path":"packages/sdk/app-graph/src/graph.ts","kind":"import-statement","original":"./graph"},{"path":"packages/sdk/app-graph/src/graph-builder.ts","kind":"import-statement","original":"./graph-builder"},{"path":"packages/sdk/app-graph/src/node.ts","kind":"import-statement","original":"./node"}],"format":"esm"},"packages/sdk/app-graph/src/testing.ts":{"bytes":11884,"imports":[],"format":"esm"}},"outputs":{"packages/sdk/app-graph/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":19741},"packages/sdk/app-graph/dist/lib/browser/index.mjs":{"imports":[{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"lodash.get","kind":"import-statement","external":true},{"path":"@preact/signals-react","kind":"import-statement","external":true},{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/keyboard","kind":"import-statement","external":true}],"exports":["Graph","GraphBuilder","isGraphNode"],"entryPoint":"packages/sdk/app-graph/src/index.ts","inputs":{"packages/sdk/app-graph/src/index.ts":{"bytesInOutput":0},"packages/sdk/app-graph/src/graph.ts":{"bytesInOutput":1841},"packages/sdk/app-graph/src/graph-builder.ts":{"bytesInOutput":5503},"packages/sdk/app-graph/src/node.ts":{"bytesInOutput":104}},"bytes":7660},"packages/sdk/app-graph/dist/lib/browser/testing.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":6167},"packages/sdk/app-graph/dist/lib/browser/testing.mjs":{"imports":[],"exports":["buildGraph","createTestNodeBuilder"],"entryPoint":"packages/sdk/app-graph/src/testing.ts","inputs":{"packages/sdk/app-graph/src/testing.ts":{"bytesInOutput":2180}},"bytes":2308}}}
+{"inputs":{"packages/sdk/app-graph/src/action.ts":{"bytes":3203,"imports":[],"format":"esm"},"packages/sdk/app-graph/src/graph.ts":{"bytes":9237,"imports":[{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"lodash.get","kind":"import-statement","external":true}],"format":"esm"},"packages/sdk/app-graph/src/graph-builder.ts":{"bytes":24017,"imports":[{"path":"@preact/signals-react","kind":"import-statement","external":true},{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/keyboard","kind":"import-statement","external":true},{"path":"packages/sdk/app-graph/src/graph.ts","kind":"import-statement","original":"./graph"}],"format":"esm"},"packages/sdk/app-graph/src/node.ts":{"bytes":4772,"imports":[],"format":"esm"},"packages/sdk/app-graph/src/index.ts":{"bytes":722,"imports":[{"path":"packages/sdk/app-graph/src/action.ts","kind":"import-statement","original":"./action"},{"path":"packages/sdk/app-graph/src/graph.ts","kind":"import-statement","original":"./graph"},{"path":"packages/sdk/app-graph/src/graph-builder.ts","kind":"import-statement","original":"./graph-builder"},{"path":"packages/sdk/app-graph/src/node.ts","kind":"import-statement","original":"./node"}],"format":"esm"},"packages/sdk/app-graph/src/testing.ts":{"bytes":11884,"imports":[],"format":"esm"}},"outputs":{"packages/sdk/app-graph/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":19877},"packages/sdk/app-graph/dist/lib/browser/index.mjs":{"imports":[{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"lodash.get","kind":"import-statement","external":true},{"path":"@preact/signals-react","kind":"import-statement","external":true},{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/keyboard","kind":"import-statement","external":true}],"exports":["Graph","GraphBuilder","KEY_BINDING","isGraphNode"],"entryPoint":"packages/sdk/app-graph/src/index.ts","inputs":{"packages/sdk/app-graph/src/index.ts":{"bytesInOutput":0},"packages/sdk/app-graph/src/graph.ts":{"bytesInOutput":1841},"packages/sdk/app-graph/src/graph-builder.ts":{"bytesInOutput":5597},"packages/sdk/app-graph/src/node.ts":{"bytesInOutput":104}},"bytes":7769},"packages/sdk/app-graph/dist/lib/browser/testing.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":6167},"packages/sdk/app-graph/dist/lib/browser/testing.mjs":{"imports":[],"exports":["buildGraph","createTestNodeBuilder"],"entryPoint":"packages/sdk/app-graph/src/testing.ts","inputs":{"packages/sdk/app-graph/src/testing.ts":{"bytesInOutput":2180}},"bytes":2308}}}

package/dist/lib/node/index.cjs

@@ -30,6 +30,7 @@ var node_exports = {};
 __export(node_exports, {
   Graph: () => Graph,
   GraphBuilder: () => GraphBuilder,
+  KEY_BINDING: () => KEY_BINDING,
   isGraphNode: () => isGraphNode
 });
 module.exports = __toCommonJS(node_exports);
@@ -110,6 +111,7 @@ var Graph = class {
     }
   }
 };
+var KEY_BINDING = "KeyBinding";
 var GraphBuilder = class {
   constructor() {
     this._nodeBuilders = /* @__PURE__ */ new Map();
@@ -225,9 +227,11 @@ var GraphBuilder = class {
             const action = this._createAction(partial2);
             if (action.keyBinding) {
               import_keyboard.Keyboard.singleton.getContext(path.join("/")).bind({
-                binding: action.keyBinding,
+                shortcut: action.keyBinding,
                 handler: () => {
-                  action.invoke();
+                  action.invoke({
+                    caller: KEY_BINDING
+                  });
                 },
                 data: action.label
               });
@@ -294,6 +298,7 @@ var isGraphNode = (data) => data && typeof data === "object" ? "id" in data && "
 0 && (module.exports = {
   Graph,
   GraphBuilder,
+  KEY_BINDING,
   isGraphNode
 });
 //# sourceMappingURL=index.cjs.map

package/dist/lib/node/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/graph.ts", "../../../src/graph-builder.ts", "../../../src/node.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { deepSignal } from 'deepsignal/react';\n// TODO(wittjosiah): Remove lodash dependency.\nimport get from 'lodash.get';\n\nimport { type Label } from './action';\nimport { type Node } from './node';\n\nexport type TraversalOptions = {\n  /**\n   * The node to start traversing from. Defaults to the root node.\n   */\n  node?: Node;\n\n  /**\n   * The direction to traverse the graph. Defaults to 'down'.\n   */\n  direction?: 'up' | 'down';\n\n  /**\n   * A predicate to filter nodes which are passed to the `visitor` callback.\n   */\n  filter?: (node: Node) => boolean;\n\n  /**\n   * A callback which is called for each node visited during traversal.\n   */\n  visitor?: (node: Node, path: string[]) => void;\n};\n\n/**\n * The Graph represents the structure of the application constructed via plugins.\n */\nexport class Graph {\n  // TODO(wittjosiah): Should this support multiple paths to the same node?\n  private readonly _index = deepSignal<{ [key: string]: string[] }>({});\n\n  constructor(private readonly _root: Node) {}\n\n  toJSON() {\n    const toLabel = (label: Label) => (Array.isArray(label) ? `${label[1].ns}[${label[0]}]` : label);\n    const toJSON = (node: Node): any => {\n      return {\n        id: node.id.slice(0, 16),\n        label: toLabel(node.label),\n        children: node.children.length ? node.children.map((node) => toJSON(node)) : undefined,\n        actions: node.actions.length\n          ? node.actions.map(({ id, label }) => ({\n              id,\n              label: toLabel(label),\n            }))\n          : undefined,\n      };\n    };\n\n    return toJSON(this._root);\n  }\n\n  /**\n   * The root node of the graph which is the entry point for all knowledge.\n   */\n  get root(): Node {\n    return this._root;\n  }\n\n  /**\n   * Get the path through the graph from the root to the node with the given id.\n   */\n  getPath(id: string): string[] | undefined {\n    return this._index[id];\n  }\n\n  /**\n   * @internal\n   */\n  _setPath(id: string, path: string[]) {\n    this._index[id] = path;\n  }\n\n  /**\n   * Find the node with the given id in the graph.\n   */\n  findNode(id: string): Node | undefined {\n    const path = this.getPath(id);\n    if (!path) {\n      return undefined;\n    }\n\n    return path.length > 0 ? get(this._root, path) : this._root;\n  }\n\n  /**\n   * Recursive breadth-first traversal.\n   */\n  traverse({ node = this._root, direction = 'down', filter, visitor }: TraversalOptions, depth = 0): void {\n    if (!filter || filter(node)) {\n      visitor?.(node, this.getPath(node.id)!);\n    }\n\n    if (direction === 'down') {\n      Object.values(node.children).forEach((child) => this.traverse({ node: child, filter, visitor }));\n    } else if (direction === 'up' && node.parent) {\n      this.traverse({ node: node.parent, direction, filter, visitor }, depth + 1);\n    }\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { untracked } from '@preact/signals-react';\nimport { type RevertDeepSignal, deepSignal } from 'deepsignal/react';\n\nimport { EventSubscriptions } from '@dxos/async';\nimport { Keyboard } from '@dxos/keyboard';\n\nimport type { ActionArg, Action } from './action';\nimport { Graph } from './graph';\nimport type { NodeArg, Node, NodeBuilder } from './node';\n\n/**\n * The builder...\n */\nexport class GraphBuilder {\n  private readonly _nodeBuilders = new Map<string, NodeBuilder>();\n  private readonly _unsubscribe = new Map<string, EventSubscriptions>();\n\n  /**\n   * Register a node builder which will be called in order to construct the graph.\n   */\n  addNodeBuilder(id: string, builder: NodeBuilder): GraphBuilder {\n    this._nodeBuilders.set(id, builder);\n    return this;\n  }\n\n  /**\n   * Remove a node builder from the graph builder.\n   */\n  removeNodeBuilder(id: string): GraphBuilder {\n    this._nodeBuilders.delete(id);\n    return this;\n  }\n\n  /**\n   * Construct the graph, starting by calling all registered node builders on the root node.\n   * Node builders will be filtered out as they are used such that they are only used once on any given path.\n   * @param previousGraph If provided, the graph will be updated in place.\n   * @param startingPath If provided, the graph will be updated starting at the given path.\n   */\n  build(previousGraph?: Graph, startingPath: string[] = []): Graph {\n    const graph: Graph = previousGraph ?? new Graph(this._createNode(() => graph, { id: 'root', label: 'Root' }));\n    return this._build(graph, graph.root, startingPath);\n  }\n\n  /**\n   * Called recursively.\n   */\n  private _build(graph: Graph, node: Node, path: string[] = [], ignoreBuilders: string[] = []): Graph {\n    // TODO(wittjosiah): Should this support multiple paths to the same node?\n    graph._setPath(node.id, path);\n\n    // TODO(burdon): Document.\n    const subscriptions = this._unsubscribe.get(node.id) ?? new EventSubscriptions();\n    subscriptions.clear();\n\n    Array.from(this._nodeBuilders.entries())\n      .filter(([id]) => ignoreBuilders.findIndex((ignore) => ignore === id) === -1)\n      .forEach(([_, builder]) => {\n        const unsubscribe = builder(node);\n        unsubscribe && subscriptions.add(unsubscribe);\n      });\n\n    this._unsubscribe.set(node.id, subscriptions);\n\n    return graph;\n  }\n\n  private _createNode<TData = null, TProperties extends Record<string, any> = Record<string, any>>(\n    getGraph: () => Graph,\n    partial: NodeArg<TData, TProperties>,\n    path: string[] = [],\n    ignoreBuilders: string[] = [],\n  ): Node<TData, TProperties> {\n    // TODO(burdon): Document implications and rationale of deepSignal.\n    const node: Node<TData, TProperties> = deepSignal({\n      parent: null,\n      data: null as TData, // TODO(burdon): Allow null property?\n      properties: {} as TProperties,\n      childrenMap: {},\n      actionsMap: {},\n      // TODO(burdon): Document.\n      ...partial,\n\n      get children() {\n        return Object.values(node.childrenMap);\n      },\n      get actions() {\n        return Object.values(node.actionsMap);\n      },\n\n      //\n      // Properties\n      //\n\n      addProperty: (key, value) => {\n        untracked(() => {\n          (node.properties as Record<string, any>)[key] = value;\n        });\n      },\n      removeProperty: (key) => {\n        untracked(() => {\n          delete (node.properties as Record<string, any>)[key];\n        });\n      },\n\n      //\n      // Nodes\n      //\n\n      addNode: (builder, ...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const builders = [...ignoreBuilders, builder];\n            const childPath = [...path, 'childrenMap', partial.id];\n            const child = this._createNode(getGraph, { ...partial, parent: node }, childPath, builders);\n            node.childrenMap[child.id] = child;\n            // TODO(burdon): Defer triggering recursive updates until task has completed.\n            this._build(getGraph(), child, childPath, builders);\n            return child;\n          });\n        });\n      },\n      removeNode: (id) => {\n        return untracked(() => {\n          const child = node.childrenMap[id];\n          delete node.childrenMap[id];\n          return child;\n        });\n      },\n\n      //\n      // Actions\n      //\n\n      addAction: (...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const action = this._createAction(partial);\n            if (action.keyBinding) {\n              Keyboard.singleton.getContext(path.join('/')).bind({\n                binding: action.keyBinding!,\n                handler: () => {\n                  action.invoke();\n                },\n                data: action.label,\n              });\n            }\n\n            node.actionsMap[action.id] = action;\n            return action;\n          });\n        });\n      },\n      removeAction: (id) => {\n        return untracked(() => {\n          const action = node.actionsMap[id];\n          if (action.keyBinding) {\n            // keyboardjs.unbind(action.keyBinding);\n          }\n\n          delete node.actionsMap[id];\n          return action;\n        });\n      },\n    }) as RevertDeepSignal<Node<TData, TProperties>>;\n\n    // Only actions added at this stage are available to subsequent builders.\n    // `addNode` immediately passes the new node to other builders.\n    // As such, actions added later with `addAction` are not available to those builders.\n    // Having actions available to subsequent builders is useful for building groups.\n    partial.actions && partial.actions.forEach((action) => node.addAction(action));\n\n    return node;\n  }\n\n  private _createAction<TProperties extends Record<string, any> = Record<string, any>>(\n    partial: ActionArg<TProperties>,\n  ): Action<TProperties> {\n    const action: Action<TProperties> = deepSignal({\n      properties: {} as TProperties,\n      ...partial,\n      actionsMap: {},\n      get actions() {\n        return Object.values(action.actionsMap);\n      },\n      addAction: (...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const subAction = this._createAction(partial);\n            action.actionsMap[subAction.id] = subAction;\n            return subAction;\n          });\n        });\n      },\n      removeAction: (id) => {\n        return untracked(() => {\n          const subAction = action.actionsMap[id];\n          delete action.actionsMap[id];\n          return subAction;\n        });\n      },\n      addProperty: (key, value) => {\n        return untracked(() => {\n          (action.properties as Record<string, any>)[key] = value;\n        });\n      },\n      removeProperty: (key) => {\n        return untracked(() => {\n          delete (action.properties as Record<string, any>)[key];\n        });\n      },\n    }) as RevertDeepSignal<Action<TProperties>>;\n\n    partial.actions && partial.actions.forEach((subAction) => action.addAction(subAction));\n\n    return action;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport type { IconProps } from '@phosphor-icons/react';\nimport { type FC } from 'react';\n\nimport type { UnsubscribeCallback } from '@dxos/async';\n\nimport { type ActionArg, type Action, type Label } from './action';\n\n/**\n * Called when a node is added to the graph, allowing other node builders to add children, actions or properties.\n */\nexport type NodeBuilder = (parent: Node) => UnsubscribeCallback | void;\n\n/**\n * Represents a node in the graph.\n */\nexport type Node<TData = any, TProperties extends Record<string, any> = Record<string, any>> = {\n  /**\n   * Globally unique ID.\n   */\n  id: string;\n\n  /**\n   * Parent node in the graph.\n   */\n  parent: Node | null;\n\n  /**\n   * Label to be used when displaying the node.\n   * For default labels, use a translated string.\n   *\n   * @example 'My Node'\n   * @example ['unknown node label, { ns: 'example-plugin' }]\n   */\n  label: Label;\n\n  /**\n   * Description to be used when displaying a detailed view of the node.\n   * For default descriptions, use a translated string.\n   */\n  description?: Label;\n\n  /**\n   * Icon to be used when displaying the node.\n   */\n  icon?: FC<IconProps>;\n\n  /**\n   * Properties of the node relevant to displaying the node.\n   */\n  // TODO(burdon): Make this extensible and move label, description, and icon into here?\n  properties: TProperties;\n\n  /**\n   * Data the node represents.\n   */\n  // TODO(burdon): Type system (e.g., minimally provide identifier string vs. TypedObject vs. Graph mixin type system)?\n  //  type field would prevent convoluted sniffing of object properties. And allow direct pass-through for ECHO TypedObjects.\n  // TODO(burdon): In some places `null` is cast to TData so make optional?\n  data: TData;\n\n  /**\n   * Children of the node stored by their id.\n   */\n  // TODO(burdon): Rename nodes/nodeMap?\n  childrenMap: Record<string, Node>;\n\n  /**\n   * Actions of the node stored by their id.\n   */\n  actionsMap: Record<string, Action>;\n\n  /**\n   * Children of the node in default order.\n   */\n  get children(): Node[];\n\n  /**\n   * Actions of the node in default order.\n   */\n  get actions(): Action[];\n\n  addProperty(key: string, value: any): void;\n  removeProperty(key: string): void;\n\n  addNode<TChildData = null, TChildProperties extends Record<string, any> = Record<string, any>>(\n    id: string,\n    ...node: NodeArg<TChildData, TChildProperties>[]\n  ): Node<TChildData, TChildProperties>[];\n  removeNode(id: string): Node;\n\n  addAction<TActionProperties extends Record<string, any> = Record<string, any>>(\n    ...action: ActionArg<TActionProperties>[]\n  ): Action<TActionProperties>[];\n  removeAction(id: string): Action;\n};\n\nexport type NodeArg<TData = null, TProperties extends Record<string, any> = Record<string, any>> = Pick<\n  Node,\n  'id' | 'label'\n> &\n  Partial<Omit<Node<TData, TProperties>, 'id' | 'label' | 'actions'>> & { actions?: ActionArg[] };\n\nexport const isGraphNode = (data: unknown): data is Node =>\n  data && typeof data === 'object' ? 'id' in data && 'label' in data : false;\n"],
-  "mappings": "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",
-  "names": ["import_react", "Graph", "constructor", "_root", "_index", "deepSignal", "toJSON", "toLabel", "label", "Array", "isArray", "ns", "node", "id", "slice", "children", "length", "map", "undefined", "actions", "root", "getPath", "_setPath", "path", "findNode", "get", "traverse", "direction", "filter", "visitor", "depth", "Object", "values", "forEach", "child", "parent", "GraphBuilder", "_nodeBuilders", "Map", "_unsubscribe", "addNodeBuilder", "builder", "set", "removeNodeBuilder", "delete", "build", "previousGraph", "startingPath", "graph", "_createNode", "_build", "ignoreBuilders", "subscriptions", "EventSubscriptions", "clear", "from", "entries", "findIndex", "ignore", "_", "unsubscribe", "add", "getGraph", "partial", "data", "properties", "childrenMap", "actionsMap", "addProperty", "key", "value", "untracked", "removeProperty", "addNode", "partials", "builders", "childPath", "removeNode", "addAction", "action", "_createAction", "keyBinding", "Keyboard", "singleton", "getContext", "join", "bind", "binding", "handler", "invoke", "removeAction", "subAction", "isGraphNode"]
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { deepSignal } from 'deepsignal/react';\n// TODO(wittjosiah): Remove lodash dependency.\nimport get from 'lodash.get';\n\nimport { type Label } from './action';\nimport { type Node } from './node';\n\nexport type TraversalOptions = {\n  /**\n   * The node to start traversing from. Defaults to the root node.\n   */\n  node?: Node;\n\n  /**\n   * The direction to traverse the graph. Defaults to 'down'.\n   */\n  direction?: 'up' | 'down';\n\n  /**\n   * A predicate to filter nodes which are passed to the `visitor` callback.\n   */\n  filter?: (node: Node) => boolean;\n\n  /**\n   * A callback which is called for each node visited during traversal.\n   */\n  visitor?: (node: Node, path: string[]) => void;\n};\n\n/**\n * The Graph represents the structure of the application constructed via plugins.\n */\nexport class Graph {\n  // TODO(wittjosiah): Should this support multiple paths to the same node?\n  private readonly _index = deepSignal<{ [key: string]: string[] }>({});\n\n  constructor(private readonly _root: Node) {}\n\n  toJSON() {\n    const toLabel = (label: Label) => (Array.isArray(label) ? `${label[1].ns}[${label[0]}]` : label);\n    const toJSON = (node: Node): any => {\n      return {\n        id: node.id.slice(0, 16),\n        label: toLabel(node.label),\n        children: node.children.length ? node.children.map((node) => toJSON(node)) : undefined,\n        actions: node.actions.length\n          ? node.actions.map(({ id, label }) => ({\n              id,\n              label: toLabel(label),\n            }))\n          : undefined,\n      };\n    };\n\n    return toJSON(this._root);\n  }\n\n  /**\n   * The root node of the graph which is the entry point for all knowledge.\n   */\n  get root(): Node {\n    return this._root;\n  }\n\n  /**\n   * Get the path through the graph from the root to the node with the given id.\n   */\n  getPath(id: string): string[] | undefined {\n    return this._index[id];\n  }\n\n  /**\n   * @internal\n   */\n  _setPath(id: string, path: string[]) {\n    this._index[id] = path;\n  }\n\n  /**\n   * Find the node with the given id in the graph.\n   */\n  findNode(id: string): Node | undefined {\n    const path = this.getPath(id);\n    if (!path) {\n      return undefined;\n    }\n\n    return path.length > 0 ? get(this._root, path) : this._root;\n  }\n\n  /**\n   * Recursive breadth-first traversal.\n   */\n  traverse({ node = this._root, direction = 'down', filter, visitor }: TraversalOptions, depth = 0): void {\n    if (!filter || filter(node)) {\n      visitor?.(node, this.getPath(node.id)!);\n    }\n\n    if (direction === 'down') {\n      Object.values(node.children).forEach((child) => this.traverse({ node: child, filter, visitor }));\n    } else if (direction === 'up' && node.parent) {\n      this.traverse({ node: node.parent, direction, filter, visitor }, depth + 1);\n    }\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { untracked } from '@preact/signals-react';\nimport { type RevertDeepSignal, deepSignal } from 'deepsignal/react';\n\nimport { EventSubscriptions } from '@dxos/async';\nimport { Keyboard } from '@dxos/keyboard';\n\nimport type { ActionArg, Action } from './action';\nimport { Graph } from './graph';\nimport type { NodeArg, Node, NodeBuilder } from './node';\n\nexport const KEY_BINDING = 'KeyBinding';\n\n/**\n * The builder...\n */\nexport class GraphBuilder {\n  private readonly _nodeBuilders = new Map<string, NodeBuilder>();\n  private readonly _unsubscribe = new Map<string, EventSubscriptions>();\n\n  /**\n   * Register a node builder which will be called in order to construct the graph.\n   */\n  addNodeBuilder(id: string, builder: NodeBuilder): GraphBuilder {\n    this._nodeBuilders.set(id, builder);\n    return this;\n  }\n\n  /**\n   * Remove a node builder from the graph builder.\n   */\n  removeNodeBuilder(id: string): GraphBuilder {\n    this._nodeBuilders.delete(id);\n    return this;\n  }\n\n  /**\n   * Construct the graph, starting by calling all registered node builders on the root node.\n   * Node builders will be filtered out as they are used such that they are only used once on any given path.\n   * @param previousGraph If provided, the graph will be updated in place.\n   * @param startingPath If provided, the graph will be updated starting at the given path.\n   */\n  build(previousGraph?: Graph, startingPath: string[] = []): Graph {\n    const graph: Graph = previousGraph ?? new Graph(this._createNode(() => graph, { id: 'root', label: 'Root' }));\n    return this._build(graph, graph.root, startingPath);\n  }\n\n  /**\n   * Called recursively.\n   */\n  private _build(graph: Graph, node: Node, path: string[] = [], ignoreBuilders: string[] = []): Graph {\n    // TODO(wittjosiah): Should this support multiple paths to the same node?\n    graph._setPath(node.id, path);\n\n    // TODO(burdon): Document.\n    const subscriptions = this._unsubscribe.get(node.id) ?? new EventSubscriptions();\n    subscriptions.clear();\n\n    Array.from(this._nodeBuilders.entries())\n      .filter(([id]) => ignoreBuilders.findIndex((ignore) => ignore === id) === -1)\n      .forEach(([_, builder]) => {\n        const unsubscribe = builder(node);\n        unsubscribe && subscriptions.add(unsubscribe);\n      });\n\n    this._unsubscribe.set(node.id, subscriptions);\n\n    return graph;\n  }\n\n  private _createNode<TData = null, TProperties extends Record<string, any> = Record<string, any>>(\n    getGraph: () => Graph,\n    partial: NodeArg<TData, TProperties>,\n    path: string[] = [],\n    ignoreBuilders: string[] = [],\n  ): Node<TData, TProperties> {\n    // TODO(burdon): Document implications and rationale of deepSignal.\n    const node: Node<TData, TProperties> = deepSignal({\n      parent: null,\n      data: null as TData, // TODO(burdon): Allow null property?\n      properties: {} as TProperties,\n      childrenMap: {},\n      actionsMap: {},\n      // TODO(burdon): Document.\n      ...partial,\n\n      get children() {\n        return Object.values(node.childrenMap);\n      },\n      get actions() {\n        return Object.values(node.actionsMap);\n      },\n\n      //\n      // Properties\n      //\n\n      addProperty: (key, value) => {\n        untracked(() => {\n          (node.properties as Record<string, any>)[key] = value;\n        });\n      },\n      removeProperty: (key) => {\n        untracked(() => {\n          delete (node.properties as Record<string, any>)[key];\n        });\n      },\n\n      //\n      // Nodes\n      //\n\n      addNode: (builder, ...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const builders = [...ignoreBuilders, builder];\n            const childPath = [...path, 'childrenMap', partial.id];\n            const child = this._createNode(getGraph, { ...partial, parent: node }, childPath, builders);\n            node.childrenMap[child.id] = child;\n            // TODO(burdon): Defer triggering recursive updates until task has completed.\n            this._build(getGraph(), child, childPath, builders);\n            return child;\n          });\n        });\n      },\n      removeNode: (id) => {\n        return untracked(() => {\n          const child = node.childrenMap[id];\n          delete node.childrenMap[id];\n          return child;\n        });\n      },\n\n      //\n      // Actions\n      //\n\n      addAction: (...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const action = this._createAction(partial);\n            if (action.keyBinding) {\n              Keyboard.singleton.getContext(path.join('/')).bind({\n                shortcut: action.keyBinding,\n                handler: () => {\n                  action.invoke({ caller: KEY_BINDING });\n                },\n                data: action.label,\n              });\n            }\n\n            node.actionsMap[action.id] = action;\n            return action;\n          });\n        });\n      },\n      removeAction: (id) => {\n        return untracked(() => {\n          const action = node.actionsMap[id];\n          if (action.keyBinding) {\n            // keyboardjs.unbind(action.keyBinding);\n          }\n\n          delete node.actionsMap[id];\n          return action;\n        });\n      },\n    }) as RevertDeepSignal<Node<TData, TProperties>>;\n\n    // Only actions added at this stage are available to subsequent builders.\n    // `addNode` immediately passes the new node to other builders.\n    // As such, actions added later with `addAction` are not available to those builders.\n    // Having actions available to subsequent builders is useful for building groups.\n    partial.actions && partial.actions.forEach((action) => node.addAction(action));\n\n    return node;\n  }\n\n  private _createAction<TProperties extends Record<string, any> = Record<string, any>>(\n    partial: ActionArg<TProperties>,\n  ): Action<TProperties> {\n    const action: Action<TProperties> = deepSignal({\n      properties: {} as TProperties,\n      ...partial,\n      actionsMap: {},\n      get actions() {\n        return Object.values(action.actionsMap);\n      },\n      addAction: (...partials) => {\n        return untracked(() => {\n          return partials.map((partial) => {\n            const subAction = this._createAction(partial);\n            action.actionsMap[subAction.id] = subAction;\n            return subAction;\n          });\n        });\n      },\n      removeAction: (id) => {\n        return untracked(() => {\n          const subAction = action.actionsMap[id];\n          delete action.actionsMap[id];\n          return subAction;\n        });\n      },\n      addProperty: (key, value) => {\n        return untracked(() => {\n          (action.properties as Record<string, any>)[key] = value;\n        });\n      },\n      removeProperty: (key) => {\n        return untracked(() => {\n          delete (action.properties as Record<string, any>)[key];\n        });\n      },\n    }) as RevertDeepSignal<Action<TProperties>>;\n\n    partial.actions && partial.actions.forEach((subAction) => action.addAction(subAction));\n\n    return action;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport type { IconProps } from '@phosphor-icons/react';\nimport { type FC } from 'react';\n\nimport type { UnsubscribeCallback } from '@dxos/async';\n\nimport { type ActionArg, type Action, type Label } from './action';\n\n/**\n * Called when a node is added to the graph, allowing other node builders to add children, actions or properties.\n */\nexport type NodeBuilder = (parent: Node) => UnsubscribeCallback | void;\n\n/**\n * Represents a node in the graph.\n */\nexport type Node<TData = any, TProperties extends Record<string, any> = Record<string, any>> = {\n  /**\n   * Globally unique ID.\n   */\n  id: string;\n\n  /**\n   * Parent node in the graph.\n   */\n  parent: Node | null;\n\n  /**\n   * Label to be used when displaying the node.\n   * For default labels, use a translated string.\n   *\n   * @example 'My Node'\n   * @example ['unknown node label, { ns: 'example-plugin' }]\n   */\n  label: Label;\n\n  /**\n   * Description to be used when displaying a detailed view of the node.\n   * For default descriptions, use a translated string.\n   */\n  description?: Label;\n\n  /**\n   * Icon to be used when displaying the node.\n   */\n  icon?: FC<IconProps>;\n\n  /**\n   * Properties of the node relevant to displaying the node.\n   */\n  // TODO(burdon): Make this extensible and move label, description, and icon into here?\n  properties: TProperties;\n\n  /**\n   * Data the node represents.\n   */\n  // TODO(burdon): Type system (e.g., minimally provide identifier string vs. TypedObject vs. Graph mixin type system)?\n  //  type field would prevent convoluted sniffing of object properties. And allow direct pass-through for ECHO TypedObjects.\n  // TODO(burdon): In some places `null` is cast to TData so make optional?\n  data: TData;\n\n  /**\n   * Children of the node stored by their id.\n   */\n  // TODO(burdon): Rename nodes/nodeMap?\n  childrenMap: Record<string, Node>;\n\n  /**\n   * Actions of the node stored by their id.\n   */\n  actionsMap: Record<string, Action>;\n\n  /**\n   * Children of the node in default order.\n   */\n  get children(): Node[];\n\n  /**\n   * Actions of the node in default order.\n   */\n  get actions(): Action[];\n\n  addProperty(key: string, value: any): void;\n  removeProperty(key: string): void;\n\n  addNode<TChildData = null, TChildProperties extends Record<string, any> = Record<string, any>>(\n    id: string,\n    ...node: NodeArg<TChildData, TChildProperties>[]\n  ): Node<TChildData, TChildProperties>[];\n  removeNode(id: string): Node;\n\n  addAction<TActionProperties extends Record<string, any> = Record<string, any>>(\n    ...action: ActionArg<TActionProperties>[]\n  ): Action<TActionProperties>[];\n  removeAction(id: string): Action;\n};\n\nexport type NodeArg<TData = null, TProperties extends Record<string, any> = Record<string, any>> = Pick<\n  Node,\n  'id' | 'label'\n> &\n  Partial<Omit<Node<TData, TProperties>, 'id' | 'label' | 'actions'>> & { actions?: ActionArg[] };\n\nexport const isGraphNode = (data: unknown): data is Node =>\n  data && typeof data === 'object' ? 'id' in data && 'label' in data : false;\n"],
+  "mappings": "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",
+  "names": ["import_react", "Graph", "constructor", "_root", "_index", "deepSignal", "toJSON", "toLabel", "label", "Array", "isArray", "ns", "node", "id", "slice", "children", "length", "map", "undefined", "actions", "root", "getPath", "_setPath", "path", "findNode", "get", "traverse", "direction", "filter", "visitor", "depth", "Object", "values", "forEach", "child", "parent", "KEY_BINDING", "GraphBuilder", "_nodeBuilders", "Map", "_unsubscribe", "addNodeBuilder", "builder", "set", "removeNodeBuilder", "delete", "build", "previousGraph", "startingPath", "graph", "_createNode", "_build", "ignoreBuilders", "subscriptions", "EventSubscriptions", "clear", "from", "entries", "findIndex", "ignore", "_", "unsubscribe", "add", "getGraph", "partial", "data", "properties", "childrenMap", "actionsMap", "addProperty", "key", "value", "untracked", "removeProperty", "addNode", "partials", "builders", "childPath", "removeNode", "addAction", "action", "_createAction", "keyBinding", "Keyboard", "singleton", "getContext", "join", "bind", "shortcut", "handler", "invoke", "caller", "removeAction", "subAction", "isGraphNode"]
 }

package/dist/lib/node/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/sdk/app-graph/src/action.ts":{"bytes":3043,"imports":[],"format":"esm"},"packages/sdk/app-graph/src/graph.ts":{"bytes":9237,"imports":[{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"lodash.get","kind":"import-statement","external":true}],"format":"esm"},"packages/sdk/app-graph/src/graph-builder.ts":{"bytes":23684,"imports":[{"path":"@preact/signals-react","kind":"import-statement","external":true},{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/keyboard","kind":"import-statement","external":true},{"path":"packages/sdk/app-graph/src/graph.ts","kind":"import-statement","original":"./graph"}],"format":"esm"},"packages/sdk/app-graph/src/node.ts":{"bytes":4772,"imports":[],"format":"esm"},"packages/sdk/app-graph/src/index.ts":{"bytes":722,"imports":[{"path":"packages/sdk/app-graph/src/action.ts","kind":"import-statement","original":"./action"},{"path":"packages/sdk/app-graph/src/graph.ts","kind":"import-statement","original":"./graph"},{"path":"packages/sdk/app-graph/src/graph-builder.ts","kind":"import-statement","original":"./graph-builder"},{"path":"packages/sdk/app-graph/src/node.ts","kind":"import-statement","original":"./node"}],"format":"esm"},"packages/sdk/app-graph/src/testing.ts":{"bytes":11884,"imports":[],"format":"esm"}},"outputs":{"packages/sdk/app-graph/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":19741},"packages/sdk/app-graph/dist/lib/node/index.cjs":{"imports":[{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"lodash.get","kind":"import-statement","external":true},{"path":"@preact/signals-react","kind":"import-statement","external":true},{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/keyboard","kind":"import-statement","external":true}],"exports":["Graph","GraphBuilder","isGraphNode"],"entryPoint":"packages/sdk/app-graph/src/index.ts","inputs":{"packages/sdk/app-graph/src/index.ts":{"bytesInOutput":0},"packages/sdk/app-graph/src/graph.ts":{"bytesInOutput":1841},"packages/sdk/app-graph/src/graph-builder.ts":{"bytesInOutput":5503},"packages/sdk/app-graph/src/node.ts":{"bytesInOutput":104}},"bytes":7660},"packages/sdk/app-graph/dist/lib/node/testing.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":6167},"packages/sdk/app-graph/dist/lib/node/testing.cjs":{"imports":[],"exports":["buildGraph","createTestNodeBuilder"],"entryPoint":"packages/sdk/app-graph/src/testing.ts","inputs":{"packages/sdk/app-graph/src/testing.ts":{"bytesInOutput":2180}},"bytes":2308}}}
+{"inputs":{"packages/sdk/app-graph/src/action.ts":{"bytes":3203,"imports":[],"format":"esm"},"packages/sdk/app-graph/src/graph.ts":{"bytes":9237,"imports":[{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"lodash.get","kind":"import-statement","external":true}],"format":"esm"},"packages/sdk/app-graph/src/graph-builder.ts":{"bytes":24017,"imports":[{"path":"@preact/signals-react","kind":"import-statement","external":true},{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/keyboard","kind":"import-statement","external":true},{"path":"packages/sdk/app-graph/src/graph.ts","kind":"import-statement","original":"./graph"}],"format":"esm"},"packages/sdk/app-graph/src/node.ts":{"bytes":4772,"imports":[],"format":"esm"},"packages/sdk/app-graph/src/index.ts":{"bytes":722,"imports":[{"path":"packages/sdk/app-graph/src/action.ts","kind":"import-statement","original":"./action"},{"path":"packages/sdk/app-graph/src/graph.ts","kind":"import-statement","original":"./graph"},{"path":"packages/sdk/app-graph/src/graph-builder.ts","kind":"import-statement","original":"./graph-builder"},{"path":"packages/sdk/app-graph/src/node.ts","kind":"import-statement","original":"./node"}],"format":"esm"},"packages/sdk/app-graph/src/testing.ts":{"bytes":11884,"imports":[],"format":"esm"}},"outputs":{"packages/sdk/app-graph/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":19877},"packages/sdk/app-graph/dist/lib/node/index.cjs":{"imports":[{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"lodash.get","kind":"import-statement","external":true},{"path":"@preact/signals-react","kind":"import-statement","external":true},{"path":"deepsignal/react","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/keyboard","kind":"import-statement","external":true}],"exports":["Graph","GraphBuilder","KEY_BINDING","isGraphNode"],"entryPoint":"packages/sdk/app-graph/src/index.ts","inputs":{"packages/sdk/app-graph/src/index.ts":{"bytesInOutput":0},"packages/sdk/app-graph/src/graph.ts":{"bytesInOutput":1841},"packages/sdk/app-graph/src/graph-builder.ts":{"bytesInOutput":5597},"packages/sdk/app-graph/src/node.ts":{"bytesInOutput":104}},"bytes":7769},"packages/sdk/app-graph/dist/lib/node/testing.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":6167},"packages/sdk/app-graph/dist/lib/node/testing.cjs":{"imports":[],"exports":["buildGraph","createTestNodeBuilder"],"entryPoint":"packages/sdk/app-graph/src/testing.ts","inputs":{"packages/sdk/app-graph/src/testing.ts":{"bytesInOutput":2180}},"bytes":2308}}}

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

@@ -5,6 +5,9 @@ export type Label = string | [string, {
     ns: string;
     count?: number;
 }];
+export type InvokeParams = Partial<{
+    caller: string;
+}>;
 /**
  * An action on a node in the graph which may be invoked by sending the associated intent.
  */
@@ -44,7 +47,7 @@ export type Action<TProperties extends Record<string, any> = Record<string, any>
      * Actions of the node in default order.
      */
     get actions(): Action[];
-    invoke: () => MaybePromise<any>;
+    invoke: (params?: InvokeParams) => MaybePromise<any>;
     addProperty(key: string, value: any): void;
     removeProperty(key: string): void;
     addAction<TActionProperties extends Record<string, any> = Record<string, any>>(...action: ActionArg<TActionProperties>[]): Action<TActionProperties>[];

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

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/action.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI;IAClF;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;OAMG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,EAAE,WAAW,CAAC;IAExB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;OAEG;IAEH,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;IAExB,MAAM,EAAE,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IAEhC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,SAAS,CAAC,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3E,GAAG,MAAM,EAAE,SAAS,CAAC,iBAAiB,CAAC,EAAE,GACxC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CACzF,MAAM,EACN,IAAI,GAAG,OAAO,GAAG,QAAQ,CAC1B,GACC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/action.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI;IAClF;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;OAMG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IAErB;;;OAGG;IAEH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,EAAE,WAAW,CAAC;IAExB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;OAEG;IAEH,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;IAExB,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC,GAAG,CAAC,CAAC;IAErD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,SAAS,CAAC,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3E,GAAG,MAAM,EAAE,SAAS,CAAC,iBAAiB,CAAC,EAAE,GACxC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CACzF,MAAM,EACN,IAAI,GAAG,OAAO,GAAG,QAAQ,CAC1B,GACC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC"}

package/dist/types/src/graph-builder.d.ts

@@ -1,5 +1,6 @@
 import { Graph } from './graph';
 import type { NodeBuilder } from './node';
+export declare const KEY_BINDING = "KeyBinding";
 /**
  * The builder...
  */

package/dist/types/src/graph-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-builder.d.ts","sourceRoot":"","sources":["../../../src/graph-builder.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEzD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IAEtE;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY;IAK9D;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY;IAK3C;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,YAAY,GAAE,MAAM,EAAO,GAAG,KAAK;IAKhE;;OAEG;IACH,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,WAAW;IA4GnB,OAAO,CAAC,aAAa;CA0CtB"}
+{"version":3,"file":"graph-builder.d.ts","sourceRoot":"","sources":["../../../src/graph-builder.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEzD,eAAO,MAAM,WAAW,eAAe,CAAC;AAExC;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IAEtE;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY;IAK9D;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY;IAK3C;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,YAAY,GAAE,MAAM,EAAO,GAAG,KAAK;IAKhE;;OAEG;IACH,OAAO,CAAC,MAAM;IAoBd,OAAO,CAAC,WAAW;IA4GnB,OAAO,CAAC,aAAa;CA0CtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/app-graph",
-  "version": "0.3.11-main.fbbdc2a",
+  "version": "0.3.11-main.fe789c1",
   "description": "Constructs knowledge graphs for the purpose of building applications on top of",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -37,11 +37,11 @@
     "deepsignal": "1.4.0-shallow.0",
     "lodash.get": "^4.4.2",
     "lodash.set": "^4.3.2",
-    "@dxos/async": "0.3.11-main.fbbdc2a",
-    "@dxos/debug": "0.3.11-main.fbbdc2a",
-    "@dxos/keyboard": "0.3.11-main.fbbdc2a",
-    "@dxos/util": "0.3.11-main.fbbdc2a",
-    "@dxos/invariant": "0.3.11-main.fbbdc2a"
+    "@dxos/debug": "0.3.11-main.fe789c1",
+    "@dxos/async": "0.3.11-main.fe789c1",
+    "@dxos/invariant": "0.3.11-main.fe789c1",
+    "@dxos/keyboard": "0.3.11-main.fe789c1",
+    "@dxos/util": "0.3.11-main.fe789c1"
   },
   "devDependencies": {
     "@faker-js/faker": "^8.0.2",
@@ -53,10 +53,10 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "vite": "^4.3.9",
-    "@dxos/react-client": "0.3.11-main.fbbdc2a",
-    "@dxos/react-ui-theme": "0.3.11-main.fbbdc2a",
-    "@dxos/storybook-utils": "0.3.11-main.fbbdc2a",
-    "@dxos/react-ui": "0.3.11-main.fbbdc2a"
+    "@dxos/react-client": "0.3.11-main.fe789c1",
+    "@dxos/react-ui": "0.3.11-main.fe789c1",
+    "@dxos/react-ui-theme": "0.3.11-main.fe789c1",
+    "@dxos/storybook-utils": "0.3.11-main.fe789c1"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.0.5",

package/src/action.ts

@@ -10,6 +10,10 @@ import type { MaybePromise } from '@dxos/util';
 // TODO(thure): `Parameters<TFunction>` causes typechecking issues because `TFunction` has so many signatures.
 export type Label = string | [string, { ns: string; count?: number }];
 
+export type InvokeParams = Partial<{
+  caller: string;
+}>;
+
 /**
  * An action on a node in the graph which may be invoked by sending the associated intent.
  */
@@ -37,6 +41,7 @@ export type Action<TProperties extends Record<string, any> = Record<string, any>
    * Key binding.
    * NOTE: Alphanumeric characters should be declared in lowercase.
    */
+  // TODO(burdon): Rename shortcut.
   keyBinding?: string;
 
   /**
@@ -57,7 +62,7 @@ export type Action<TProperties extends Record<string, any> = Record<string, any>
   // TODO(burdon): Why get vs. prop?
   get actions(): Action[];
 
-  invoke: () => MaybePromise<any>;
+  invoke: (params?: InvokeParams) => MaybePromise<any>;
 
   addProperty(key: string, value: any): void;
   removeProperty(key: string): void;

package/src/graph-builder.ts

@@ -12,6 +12,8 @@ import type { ActionArg, Action } from './action';
 import { Graph } from './graph';
 import type { NodeArg, Node, NodeBuilder } from './node';
 
+export const KEY_BINDING = 'KeyBinding';
+
 /**
  * The builder...
  */
@@ -142,9 +144,9 @@ export class GraphBuilder {
             const action = this._createAction(partial);
             if (action.keyBinding) {
               Keyboard.singleton.getContext(path.join('/')).bind({
-                binding: action.keyBinding!,
+                shortcut: action.keyBinding,
                 handler: () => {
-                  action.invoke();
+                  action.invoke({ caller: KEY_BINDING });
                 },
                 data: action.label,
               });