@petrarca/sonnet-graph 0.5.0 → 0.7.0

package/README.md

@@ -1,35 +1,33 @@
 # @petrarca/sonnet-graph
 
-Renderer-agnostic property graph visualization, exploration, and enrichment
-for the Petrarca Sonnet component library.
-
-## What's included
-
-**GraphVisualizer** — Main visualization component. Renders a property graph
-using the active renderer (Cytoscape or Reagraph). Supports node/edge
-selection, focus mode, hide/show, and graph expansion.
-
-**ActionPanel** — Side panel showing selected node/edge details and graph
-exploration actions.
-
-**GraphA11yList** — Accessible DOM mirror of the graph's selectable elements.
-Cytoscape (canvas) and Reagraph (WebGL) draw nodes/edges outside the DOM, so they
-are invisible to screen readers, keyboard users, and DOM automation; this renders
-a virtualized list of node/edge `<button>`s that drive the same selection store
-the canvas reads. `sr-only` by default (real apps); pass `visible` for an on-screen
-outline panel.
-
-**GraphRendererProvider** — Context provider that selects the active renderer
-(`"cytoscape"` or `"reagraph"`).
-
-**Store factories** — Create the Zustand stores the graph components need:
-`createGraphDataStore`, `createGraphFilterStore`, `createGraphExplorationStore`,
-`createSelectionStore`, `createGraphFocusStore`.
-
-**Graph utilities** — `enrichNodes`, `enrichEdges`, `buildColorPalette` for
-preparing raw graph data before passing it to stores.
-
----
+Property-graph visualization for the Petrarca Sonnet component library. The
+state and the transformations are renderer-independent; Cytoscape and Reagraph
+are two implementations of the drawing surface, switched at runtime
+([ADR-0004](../../docs/adr/0004-graph-rendering-is-renderer-agnostic.md)).
+
+## What it provides
+
+**A viewer.** `GraphVisualizer` draws the graph through the active renderer,
+with selection, focus mode, hide and show, and expansion.
+`GraphRendererProvider` holds the choice and reports changes so a host can
+persist it; `ActionPanel` shows the selected element and its actions.
+
+**An accessible list.** Both renderers draw outside the DOM, so `GraphA11yList`
+mirrors the selectable elements as buttons driving the same selection store,
+`sr-only` by default and displayable as an outline panel.
+
+**Stores and transforms.** `createGraphDataStore`, `createGraphFilterStore`,
+`createGraphExplorationStore`, `createSelectionStore`, `createGraphFocusStore`
+and `createActionPanelStore`, plus `enrichNodes`, `enrichEdges`,
+`normalizeGraph` and the palette builders. The consumer creates the stores, so
+two graph views in one application are isolated.
+
+**Two editors.** `GraphModelEditor` authors the metamodel -- node types, edge
+types, relations -- as a graph over a controlled `value`. The `graph-edit`
+surface (`GraphEditToolbar`, `NodeFormSheet`, `EdgeFormSheet`,
+`DeleteNodeDialog`) edits the instance data, writing through a
+`GraphMutationPort` you implement and reading schemas from a
+`GraphSchemaProvider` you supply. Nothing here does I/O of its own.
 
 ## Install
 
@@ -37,108 +35,81 @@ preparing raw graph data before passing it to stores.
 pnpm add @petrarca/sonnet-graph
 ```
 
-### Required peer dependencies
-
-```bash
-pnpm add react@">=19" react-dom@">=19"
-```
+| Peer | Range | Needed for |
+|---|---|---|
+| `react`, `react-dom` | `>=19` | Everything |
+| `lucide-react` | `>=0.300` | Toolbar and panel icons |
+| `cytoscape` | `>=3` | The Cytoscape renderer |
+| `cytoscape-cola`, `cytoscape-cise`, `cytoscape-cxtmenu`, `cytoscape-dagre`, `cytoscape-elk`, `cytoscape-fcose`, `cytoscape-klay` | `>=1` to `>=3` | Cytoscape layouts and the context menu |
+| `reagraph` | `>=4` | The Reagraph renderer |
 
-### Renderer peer dependencies
+**The renderer peers are declared optional, and are not optional in practice.**
+Both renderers and all seven Cytoscape plugins are statically imported at
+module scope, so `peerDependenciesMeta.optional` only stops your package manager
+warning at install time. Omit any one of the nine and importing
+`GraphVisualizer` fails; there is no supported subset.
 
-Install only the renderers you use:
+The plugin specifiers must also resolve from your own `node_modules`. If your
+bundler resolves this package from anywhere else -- a linked checkout, a build
+output outside the project, any alias pointing elsewhere -- resolution starts
+from that location and there is nothing to find. Alias all seven plugin
+specifiers to your own `node_modules`; a partial list fails on whichever one was
+left out, when the renderer first mounts. The configuration is in
+[getting started](docs/usage/getting-started.md).
 
-```bash
-pnpm add cytoscape          # Cytoscape.js renderer
-pnpm add reagraph           # Reagraph (3D/WebGL) renderer
-```
+## Usage
 
-If you use `@petrarca/sonnet-playground` (which includes the graph demo page),
-both `cytoscape` and `reagraph` are required even if your app only uses one renderer.
-
-### Cytoscape layout plugins (optional)
-
-Install the layout algorithms you need. All are optional — the graph works
-without them but with fewer layout options:
-
-```bash
-pnpm add cytoscape-fcose    # Force-directed, compound graph
-pnpm add cytoscape-cola     # Constraint-based
-pnpm add cytoscape-dagre    # DAG / hierarchical
-pnpm add cytoscape-elk      # Eclipse Layout Kernel
-pnpm add cytoscape-cise     # Circular layout
-pnpm add cytoscape-klay     # KLay hierarchical
-pnpm add cytoscape-cxtmenu  # Context menu extension
-```
-
-### Local development with SONNET_UI_LOCAL=1
-
-When resolving `@petrarca/sonnet-graph` from the local dist (via Vite aliases),
-the Cytoscape plugins must also be aliased to the consumer's `node_modules` —
-Vite cannot find them relative to the dist file. Add to your `sonnet-aliases.ts`:
-
-```ts
-const nm = path.resolve(baseDir, "node_modules");
-// ...
-"cytoscape-fcose": path.resolve(nm, "cytoscape-fcose"),
-"cytoscape-cola":  path.resolve(nm, "cytoscape-cola"),
-"cytoscape-dagre": path.resolve(nm, "cytoscape-dagre"),
-"cytoscape-elk":   path.resolve(nm, "cytoscape-elk"),
-"cytoscape-cise":  path.resolve(nm, "cytoscape-cise"),
-"cytoscape-klay":  path.resolve(nm, "cytoscape-klay"),
-"cytoscape-cxtmenu": path.resolve(nm, "cytoscape-cxtmenu"),
-```
-
-See `sonnet-ui-starter/sonnet-aliases.ts` for a complete reference implementation.
-
----
-
-## Basic usage
+Create the stores once, never in a render body, and give the container a height.
 
 ```tsx
 import {
-  GraphVisualizer,
-  ActionPanel,
-  GraphRendererProvider,
-  GraphStoresContext,
-  createGraphDataStore,
-  createGraphFilterStore,
-  createGraphExplorationStore,
-  createSelectionStore,
-  createGraphFocusStore,
-  enrichNodes,
-  enrichEdges,
-  buildColorPalette,
-  type RawGraphNode,
-  type RawGraphEdge,
-  type WorkspaceStores,
+  GraphRendererProvider, GraphStoresContext, GraphVisualizer,
+  createGraphDataStore, createGraphExplorationStore, createGraphFilterStore,
+  createGraphFocusStore, createSelectionStore, type WorkspaceStores,
 } from "@petrarca/sonnet-graph";
 
-// Create stores once (e.g. in a context provider)
+const graphData = createGraphDataStore();
+const graphFilter = createGraphFilterStore();
+const selection = createSelectionStore();
+
+// WorkspaceStores has exactly these four members. The focus store is a
+// dependency of the exploration store, which requires its deps object.
 const stores: WorkspaceStores = {
-  graphData:        createGraphDataStore(),
-  graphFilter:      createGraphFilterStore(),
-  graphExploration: createGraphExplorationStore(),
-  selection:        createSelectionStore(),
-  graphFocus:       createGraphFocusStore(),
+  graphData,
+  graphFilter,
+  selection,
+  graphExploration: createGraphExplorationStore({
+    graphData,
+    selection,
+    graphFilter,
+    graphFocus: createGraphFocusStore(),
+    expandNode: async () => ({ nodes: [], edges: [], has_more: false }),
+    getNodes: async () => [],
+  }),
 };
 
-// Render
-function MyGraph() {
-  return (
-    <GraphStoresContext.Provider value={stores}>
-      <GraphRendererProvider defaultRenderer="cytoscape">
-        <div style={{ display: "flex", height: 600 }}>
-          <GraphVisualizer />
-          <ActionPanel />
-        </div>
-      </GraphRendererProvider>
-    </GraphStoresContext.Provider>
-  );
-}
+const GraphView = () => (
+  <GraphStoresContext.Provider value={stores}>
+    <GraphRendererProvider defaultRenderer="cytoscape">
+      <div className="h-[600px] w-full">
+        <GraphVisualizer />
+      </div>
+    </GraphRendererProvider>
+  </GraphStoresContext.Provider>
+);
 ```
 
----
+## Documentation
+
+- [Usage guides](docs/usage/index.md) -- getting started,
+  [stores and data](docs/usage/stores-and-data.md),
+  [exploration and selection](docs/usage/exploration-and-selection.md),
+  [accessibility](docs/usage/accessibility.md), and both editors:
+  [model](docs/usage/model-editing.md) and
+  [instance](docs/usage/instance-editing.md).
+- [Design docs](docs/design/index.md) -- the renderer boundary and both editors.
+- [Workspace documentation](../../docs/README.md) -- how the packages layer.
 
 ## License
 
-See [LICENSE.md](../../LICENSE.md).
+Apache 2.0. See [LICENSE.md](../../LICENSE.md).

package/dist/index.d.ts

@@ -419,7 +419,7 @@ declare function createGraphDataStore(): zustand.UseBoundStore<zustand.StoreApi<
 /**
  * GraphFilterStore - Node/edge label filtering and data-change tracking.
  *
- * Graph-generic filtering store. Separated from Cypher-specific
+ * Graph-generic filtering store. Separated from query-language-specific
  * query editing (QueryEditorStore stays in the consumer).
  */
 interface GraphFilterStore {
@@ -679,19 +679,34 @@ type StoreFactory<T> = () => UseBoundStore<StoreApi<T>>;
  * Bundle of graph-related workspace-scoped store instances.
  * Each workspace gets its own isolated set of these stores.
  *
- * Note: QueryEditorStore stays in the consumer (e.g., explorer) since
- * it is Cypher/query-specific, not part of generic graph visualization.
+ * Note: QueryEditorStore stays in the consumer since it is
+ * query-language-specific, not part of generic graph visualization.
  */
 interface WorkspaceStores {
     graphFilter: UseBoundStore<StoreApi<GraphFilterStore>>;
     graphData: UseBoundStore<StoreApi<GraphDataStore>>;
     graphExploration: UseBoundStore<StoreApi<GraphExplorationStore>>;
     selection: UseBoundStore<StoreApi<SelectionStore>>;
+    /**
+     * Focus is workspace-scoped, not global.
+     *
+     * It is a two-part protocol, and both parts belong to one graph surface:
+     * `focusAction` is the request, and `overrideElementIds` is what makes a
+     * filtered-out element visible so the request can be carried out --
+     * useLiveGraphData merges those ids back past every filter. Sharing the store
+     * across surfaces would let a focus in one punch a hole in another's data.
+     *
+     * GraphExploration already writes focus through an injected store; before
+     * this, the readers used the module singleton instead, so a host that created
+     * an isolated focus store (the model editor, the playground) had its requests
+     * land where nothing was listening.
+     */
+    graphFocus: UseBoundStore<StoreApi<GraphFocusStore>>;
 }
 
 /**
  * Context for providing graph stores to visualization components.
- * Must be set by the host application (e.g., a graph explorer or consumer app).
+ * Must be set by the host application.
  */
 declare const GraphStoresContext: React.Context<WorkspaceStores | null>;
 /** Get GraphFilter store from context. */
@@ -702,6 +717,14 @@ declare function useWorkspaceGraphData(): UseBoundStore<StoreApi<GraphDataStore>
 declare function useWorkspaceGraphExploration(): UseBoundStore<StoreApi<GraphExplorationStore>>;
 /** Get Selection store from context. */
 declare function useWorkspaceSelection(): UseBoundStore<StoreApi<SelectionStore>>;
+/**
+ * Get GraphFocus store from context.
+ *
+ * Read this rather than importing the module singleton: focus is scoped to a
+ * graph surface, so a host with more than one (an explorer plus a model editor)
+ * keeps them independent.
+ */
+declare function useWorkspaceGraphFocus(): UseBoundStore<StoreApi<GraphFocusStore>>;
 
 declare function useStableRef<T extends (...args: never[]) => unknown>(fn: T): T;
 declare function useStableRef<T extends (...args: never[]) => unknown>(fn: T | undefined): T | undefined;
@@ -906,7 +929,7 @@ declare function GraphA11yList({ visible, rowHeight, maxHeight, className, }: Gr
  * A graph model is a list of type schemas, each a JSON Schema carrying an
  * `x-graph` extension that declares whether it is a node or edge type, its
  * graph label, and (for node types) the valid outbound relations. This mirrors
- * the shape consumed by cypher-graphdb-core, so a model authored here is a
+ * the shape consumed by the schema-to-graph backend, so a model authored here is a
  * valid model there.
  *
  * The model is the source of truth. It is rendered as a graph of node-types and
@@ -998,7 +1021,7 @@ declare function typeLabel(schema: GraphTypeSchema): string;
  * and `GraphVisualizer`. The model JSON is the source of truth; there is no
  * reverse conversion.
  *
- * Ports cypher-graphdb-core's `json_schemas_to_graph` with two deliberate
+ * Converts JSON Schemas to a graph model with two deliberate
  * differences:
  *  - Node/edge ids are derived deterministically from type/relation names so
  *    the same model always yields the same ids (required for visualizer merge,
@@ -1503,17 +1526,16 @@ declare function NodeTypeNameSheet({ open, onOpenChange, initial, existing, noun
  *
  * The write analog of the read-side injected dependencies
  * (`GraphExplorationDeps` / `GraphDataHook`). The library's editing components
- * call only this port; they never see HTTP, auth, Cypher, or a cache. Each
- * consumer implements the port against its own backend (the explorer wraps its
- * existing `graphService`; a new consumer wraps its own graph REST API).
+ * call only this port; they never see HTTP, auth, a query language, or a cache.
+ * Each consumer implements the port against its own backend.
  *
- * Node/edge ids are numeric, matching `RawGraphNode.id_` / `RawGraphEdge.id_`
- * and the explorer's `graphService` today. (If a future consumer keys nodes by
- * string, this would widen to `number | string`.)
+ * Node/edge ids are numeric, matching `RawGraphNode.id_` / `RawGraphEdge.id_`.
+ * (If a future consumer keys nodes by string, this would widen to
+ * `number | string`.)
  *
  * The port is EVENT-FREE: it `await`s and returns the mutation result; it does
  * not own a cache and emits no events. The consumer wraps the port to patch its
- * own cache (the explorer keeps its React-Query patching in its wrapper).
+ * own cache.
  *
  * Relations stay ATOMIC: `createNodeWithRelations` / `updateNodeWithRelations`
  * are single port methods, not decomposed into node + edge calls in the
@@ -1585,8 +1607,8 @@ interface UpdateNodeWithRelationsResult {
     };
 }
 /**
- * The injected write interface. Shapes mirror the explorer's `graphService`
- * almost one-to-one, which is what makes a consumer's adapter a thin wrapper.
+ * The injected write interface. Shapes are deliberately close to a typical
+ * graph REST service, so a consumer's adapter can be a thin wrapper.
  */
 interface GraphMutationPort {
     createNode(input: CreateNodeInput): Promise<RawGraphNode>;
@@ -1606,8 +1628,7 @@ interface GraphMutationPort {
     getPairEdges(a: number, b: number): Promise<RawGraphEdge[]>;
     /**
      * Fetch nodes by id -- used by the delete-node dialog to resolve the display
-     * names of dependent (neighbour) nodes. Mirrors the explorer's
-     * graphService.getNodes.
+     * names of dependent (neighbour) nodes.
      */
     getNodes(ids: number[]): Promise<RawGraphNode[]>;
 }
@@ -1646,7 +1667,7 @@ interface RelationDef {
     /**
      * Whether this relation is surfaced as an editable form field. Only relations
      * with `form_field === true` become `__rel_*` fields in the node form
-     * (matching the explorer). Defaults to not-a-field.
+     * Defaults to not-a-field.
      */
     form_field?: boolean;
     /**
@@ -1658,8 +1679,8 @@ interface RelationDef {
     title?: string;
     /**
      * Optional widget hint for the relation field (the `x-ui-widget` value).
-     * Defaults to "entity-select". The explorer overrides this with
-     * "cypher-select"; the widget itself is supplied app-level via the registry.
+     * Defaults to "entity-select". A consumer can override it with a custom
+     * widget name; the widget itself is supplied app-level via the registry.
      */
     widget?: string;
 }
@@ -1773,11 +1794,10 @@ declare function validateGraphCapabilities(input: unknown): GraphCapabilitiesVal
  * convert between that flat form shape and the structured
  * `{ properties, relations }` the mutation port expects.
  *
- * Relocated from the cypher-graphdb explorer (`services/nodeFormUtils.ts`) so
- * every consumer of the shared editor gets the same relation handling. The
- * functions are pure -- no I/O. Reads of a node's existing relations go through
- * the injected `GraphMutationPort` (getInboundEdges / getOutboundEdges), not a
- * hardcoded backend call.
+ * Kept here so every consumer of the shared editor gets the same relation
+ * handling. The functions are pure -- no I/O. Reads of a node's existing
+ * relations go through the injected `GraphMutationPort` (getInboundEdges /
+ * getOutboundEdges), not a hardcoded backend call.
  */
 
 /** A per-field UI schema map, as JsonSchemaFormRenderer's `uiSchema` prop. */
@@ -1814,17 +1834,17 @@ declare function extractRelationFields(formData: Record<string, unknown>): {
 /** Whether any form key is a relation field (decides the atomic save path). */
 declare function hasRelationFields(formData: Record<string, unknown>): boolean;
 /** Title-case a relation type for a default field title ("USES_TECHNOLOGY" ->
- * "Uses Technology"). Matches the explorer's formatting. */
+ * "Uses Technology"). */
 declare function relationTitle(relationType: string): string;
 /** A relation is editable (becomes a form field) when form_field === true,
- * matching the explorer. */
+ * for display. */
 declare function editableRelations(relations: RelationDef[]): RelationDef[];
 /** Whether a node/edge schema declares any properties (gates "Edit edge" the
- * same way the explorer's hasProperties does). */
+ * same way the has-properties check does). */
 declare function hasProperties(schema: JsonSchema | null | undefined): boolean;
 /**
  * Enrich a node schema with a `__rel_*` field per editable relation, returning
- * a new `{ schema, uiSchema }`. Mirrors the explorer's enrichment:
+ * a new `{ schema, uiSchema }`. Enrichment:
  *  - field type is `array of integer` (multi) for ONE_TO_MANY / unset
  *    cardinality, or `integer` (single) for ONE_TO_ONE;
  *  - the field title is the relation's title or a Title-Cased label;
@@ -1845,7 +1865,7 @@ declare function enrichSchemaWithRelations(baseSchema: JsonSchema, relations: Re
  * Reads the current selection from the workspace selection store (the same
  * store the viewer owns), gates each action behind the resolved
  * `GraphCapabilities`, and owns the edit dialogs (node form, edge form, delete
- * confirm). Relocated from the explorer's `CrudActions`, but library-native:
+ * confirm). Library-native:
  * it drives everything through the injected `GraphMutationPort` +
  * `GraphSchemaProvider` and is slot-injectable via `ActionPanel actions={...}`.
  *
@@ -1941,4 +1961,4 @@ interface DeleteNodeDialogProps {
 }
 declare function DeleteNodeDialog({ open, onOpenChange, node, port, onDeleted, }: DeleteNodeDialogProps): React__default.ReactElement;
 
-export { ActionPanel, type ActionPanelState, type ActionPanelStore, type CapabilitiesValidation, type Cardinality, type ColorPalette, type CreateEdgeInput, type CreateNodeInput, type CreateNodeWithRelationsInput, type CreateNodeWithRelationsResult, DeleteNodeDialog, type DeleteNodeDialogProps, EMPTY_NORMALIZED, EdgeFormSheet, type EdgeFormSheetProps, EdgeInfoCard, type EdgeTypeMode, type EdgeTypeView, type EdgeVisual, type EditMode$1 as EditMode, type EditableMode, type ExpandOptions, type ExpandResult, GraphA11yList, type GraphA11yListProps, type GraphCapabilities, type GraphCapabilitiesValidation, type GraphDataHook, type GraphDataStore, type GraphDisplayConfig, type EditMode as GraphEditMode, GraphEditToolbar, type GraphEditToolbarProps, type GraphExplorationDeps, type GraphExplorationStore, type GraphFilterStore, type GraphFocusAction, type GraphFocusStore, type GraphModel, type GraphModelCapabilities, type GraphModelDisplay, GraphModelEditor, type GraphModelEditorProps, type GraphModelProperty, type GraphMutationPort, type GraphProperties, type GraphProperty, type GraphRelation, type GraphRenderer, GraphRendererProvider, type GraphSchemaProvider, type GraphStatistics, type WorkspaceStores as GraphStoreBundle, GraphStoresContext, type GraphTypeSchema, GraphVisualizer, type GraphVisualizerProps, type LabelDisplayMap, type LiveGraphDataResult, ModelActionPanel, type ModelActionPanelProps, type ModelGraph, NodeFormSheet, type NodeFormSheetProps, NodeInfoCard, NodeTypeNameSheet, type NodeTypeNameSheetProps, type NodeTypeView, type NodeVisual, type NormalizedGraph, Overview, PropertyFormSheet, type PropertyFormSheetProps, type PropertyInput, type PropertyView, type RawGraphEdge, type RawGraphNode, type RelationCardinality, type RelationDef, type RelationDetailView, RelationFormSheet, type RelationFormSheetProps, type RelationInput, type RelationMap, type RelationView, type ResolvedCapabilities, type ResolvedGraphCapabilities, type SelectionStore, type StoreFactory, TypeDetailPanel, type TypeDetailPanelProps, type UpdateEdgeInput, type UpdateNodeInput, type UpdateNodeWithRelationsInput, type UpdateNodeWithRelationsResult, type VisualGraphEdge, type VisualGraphNode, type VisualGraphNormalized, type WorkspaceStores, type XGraph, addEdgeType, addNodeType, addRelation, buildColorPalette, buildColorPaletteFromNodes, capabilitiesSchema, cardinalityLabel, createActionPanelStore, createGraphDataStore, createGraphExplorationStore, createGraphFilterStore, createGraphFocusStore, createSelectionStore, deleteEdgeType, deleteEdgeTypeProperty, deleteNodeProperty, deleteNodeType, deleteRelation, deleteRelationProperty, edgeTypeView, editableRelations, enrichEdge, enrichEdges, enrichNode, enrichNodes, enrichSchemaWithRelations, extractDisplayLabel, extractRelationFields, findEdgeType, findType, graphCapabilitiesSchema, groupEdgesByRelation, hasProperties, hasRelationFields, initializeFormData, isEdgeType, isNodeType, isRawGraphNode, isRelationField, isVisualEdge, isVisualNode, modelToGraph, nodeTypeView, normalizeGraph, reconcileFilter, relationFieldName, relationTitle, relationTypeFromField, relationView, renameEdgeType, renameNodeType, resolveCapabilities, resolveGraphCapabilities, resolveRelationEdge, setEdgeTypeProperty, setNodeProperty, setRelationProperty, toCytoscapeEdge, toCytoscapeNode, toReagraphEdge, toReagraphNode, typeLabel, updateRelation, useActionPanelStore, useCytoscapeData, useGraphFocus, useGraphRenderer, useLiveGraphData, useReagraphData, useStableRef, useWorkspaceGraphData, useWorkspaceGraphExploration, useWorkspaceGraphFilter, useWorkspaceSelection, validateCapabilities, validateGraphCapabilities };
+export { ActionPanel, type ActionPanelState, type ActionPanelStore, type CapabilitiesValidation, type Cardinality, type ColorPalette, type CreateEdgeInput, type CreateNodeInput, type CreateNodeWithRelationsInput, type CreateNodeWithRelationsResult, DeleteNodeDialog, type DeleteNodeDialogProps, EMPTY_NORMALIZED, EdgeFormSheet, type EdgeFormSheetProps, EdgeInfoCard, type EdgeTypeMode, type EdgeTypeView, type EdgeVisual, type EditMode$1 as EditMode, type EditableMode, type ExpandOptions, type ExpandResult, GraphA11yList, type GraphA11yListProps, type GraphCapabilities, type GraphCapabilitiesValidation, type GraphDataHook, type GraphDataStore, type GraphDisplayConfig, type EditMode as GraphEditMode, GraphEditToolbar, type GraphEditToolbarProps, type GraphExplorationDeps, type GraphExplorationStore, type GraphFilterStore, type GraphFocusAction, type GraphFocusStore, type GraphModel, type GraphModelCapabilities, type GraphModelDisplay, GraphModelEditor, type GraphModelEditorProps, type GraphModelProperty, type GraphMutationPort, type GraphProperties, type GraphProperty, type GraphRelation, type GraphRenderer, GraphRendererProvider, type GraphSchemaProvider, type GraphStatistics, type WorkspaceStores as GraphStoreBundle, GraphStoresContext, type GraphTypeSchema, GraphVisualizer, type GraphVisualizerProps, type LabelDisplayMap, type LiveGraphDataResult, ModelActionPanel, type ModelActionPanelProps, type ModelGraph, NodeFormSheet, type NodeFormSheetProps, NodeInfoCard, NodeTypeNameSheet, type NodeTypeNameSheetProps, type NodeTypeView, type NodeVisual, type NormalizedGraph, Overview, PropertyFormSheet, type PropertyFormSheetProps, type PropertyInput, type PropertyView, type RawGraphEdge, type RawGraphNode, type RelationCardinality, type RelationDef, type RelationDetailView, RelationFormSheet, type RelationFormSheetProps, type RelationInput, type RelationMap, type RelationView, type ResolvedCapabilities, type ResolvedGraphCapabilities, type SelectionStore, type StoreFactory, TypeDetailPanel, type TypeDetailPanelProps, type UpdateEdgeInput, type UpdateNodeInput, type UpdateNodeWithRelationsInput, type UpdateNodeWithRelationsResult, type VisualGraphEdge, type VisualGraphNode, type VisualGraphNormalized, type WorkspaceStores, type XGraph, addEdgeType, addNodeType, addRelation, buildColorPalette, buildColorPaletteFromNodes, capabilitiesSchema, cardinalityLabel, createActionPanelStore, createGraphDataStore, createGraphExplorationStore, createGraphFilterStore, createGraphFocusStore, createSelectionStore, deleteEdgeType, deleteEdgeTypeProperty, deleteNodeProperty, deleteNodeType, deleteRelation, deleteRelationProperty, edgeTypeView, editableRelations, enrichEdge, enrichEdges, enrichNode, enrichNodes, enrichSchemaWithRelations, extractDisplayLabel, extractRelationFields, findEdgeType, findType, graphCapabilitiesSchema, groupEdgesByRelation, hasProperties, hasRelationFields, initializeFormData, isEdgeType, isNodeType, isRawGraphNode, isRelationField, isVisualEdge, isVisualNode, modelToGraph, nodeTypeView, normalizeGraph, reconcileFilter, relationFieldName, relationTitle, relationTypeFromField, relationView, renameEdgeType, renameNodeType, resolveCapabilities, resolveGraphCapabilities, resolveRelationEdge, setEdgeTypeProperty, setNodeProperty, setRelationProperty, toCytoscapeEdge, toCytoscapeNode, toReagraphEdge, toReagraphNode, typeLabel, updateRelation, useActionPanelStore, useCytoscapeData, useGraphFocus, useGraphRenderer, useLiveGraphData, useReagraphData, useStableRef, useWorkspaceGraphData, useWorkspaceGraphExploration, useWorkspaceGraphFilter, useWorkspaceGraphFocus, useWorkspaceSelection, validateCapabilities, validateGraphCapabilities };