@petrarca/sonnet-graph 0.4.0 → 0.4.1

package/dist/index.d.ts

@@ -494,6 +494,18 @@ declare const useGraphFocus: zustand.UseBoundStore<zustand.StoreApi<GraphFocusSt
  * - GraphFilter (label filters)
  */
 
+/** Options for bounded node expansion. */
+interface ExpandOptions {
+    direction?: "both" | "out" | "in";
+    relTypes?: string[];
+    limit?: number;
+}
+/** Result shape returned by the expand backend call. */
+interface ExpandResult {
+    nodes: RawGraphNode[];
+    edges: RawGraphEdge[];
+    has_more: boolean;
+}
 /**
  * Store dependencies for GraphExploration.
  * Allows workspace-specific or global store injection.
@@ -503,10 +515,8 @@ interface GraphExplorationDeps {
     selection: UseBoundStore<StoreApi<SelectionStore>>;
     graphFocus: UseBoundStore<StoreApi<GraphFocusStore>>;
     graphFilter: UseBoundStore<StoreApi<GraphFilterStore>>;
-    expandNode: (id: number) => Promise<{
-        nodes: RawGraphNode[];
-        edges: RawGraphEdge[];
-    }>;
+    expandNode: (id: number, options?: ExpandOptions) => Promise<ExpandResult>;
+    getNodeEdgeTypes?: (id: number) => Promise<string[]>;
     getNodes: (ids: number[]) => Promise<RawGraphNode[]>;
     getLabelDisplayMap?: () => LabelDisplayMap;
 }
@@ -614,9 +624,10 @@ interface GraphExplorationStore {
      * Expand a node by fetching connected nodes/edges from backend
      * and merging them into the graph data.
      * @param nodeId - ID of the node to expand
+     * @param options - Optional expand parameters (direction, relTypes, limit)
      * @returns Promise that resolves when expansion is complete
      */
-    expandNode: (nodeId: string) => Promise<void>;
+    expandNode: (nodeId: string, options?: ExpandOptions) => Promise<void>;
     /**
      * Add a node to the graph by ID.
      * If the node already exists in the graph, just focuses it (if autoFocus=true).
@@ -834,8 +845,10 @@ interface GraphVisualizerProps {
     onCopyNode?: (node: VisualGraphNode) => void;
     /** Extra toolbar content (e.g. clipboard UI) injected into the renderer toolbar. */
     extraToolbarContent?: ReactNode;
+    /** Fetch distinct edge types for a node (for expand options panel). */
+    getNodeEdgeTypes?: (id: number) => Promise<string[]>;
 }
-declare function GraphVisualizer({ onCopyNode, extraToolbarContent, }: GraphVisualizerProps): react_jsx_runtime.JSX.Element;
+declare function GraphVisualizer({ onCopyNode, extraToolbarContent, getNodeEdgeTypes, }: GraphVisualizerProps): react_jsx_runtime.JSX.Element;
 
 interface ActionPanelProps {
     /** Optional actions rendered at the top of the panel (e.g. CRUD buttons) */
@@ -866,4 +879,4 @@ interface GraphA11yListProps {
 }
 declare function GraphA11yList({ visible, rowHeight, maxHeight, className, }: GraphA11yListProps): react_jsx_runtime.JSX.Element;
 
-export { ActionPanel, type ActionPanelState, type ActionPanelStore, type ColorPalette, EMPTY_NORMALIZED, EdgeInfoCard, type EdgeVisual, GraphA11yList, type GraphA11yListProps, type GraphDataHook, type GraphDataStore, type GraphDisplayConfig, type GraphExplorationDeps, type GraphExplorationStore, type GraphFilterStore, type GraphFocusAction, type GraphFocusStore, type GraphProperties, type GraphProperty, type GraphRenderer, GraphRendererProvider, type GraphStatistics, type WorkspaceStores as GraphStoreBundle, GraphStoresContext, GraphVisualizer, type GraphVisualizerProps, type LabelDisplayMap, type LiveGraphDataResult, NodeInfoCard, type NodeVisual, type NormalizedGraph, Overview, type RawGraphEdge, type RawGraphNode, type SelectionStore, type StoreFactory, type VisualGraphEdge, type VisualGraphNode, type VisualGraphNormalized, type WorkspaceStores, buildColorPalette, buildColorPaletteFromNodes, createActionPanelStore, createGraphDataStore, createGraphExplorationStore, createGraphFilterStore, createGraphFocusStore, createSelectionStore, enrichEdge, enrichEdges, enrichNode, enrichNodes, extractDisplayLabel, isRawGraphNode, isVisualEdge, isVisualNode, normalizeGraph, toCytoscapeEdge, toCytoscapeNode, toReagraphEdge, toReagraphNode, useActionPanelStore, useCytoscapeData, useGraphFocus, useGraphRenderer, useLiveGraphData, useReagraphData, useWorkspaceGraphData, useWorkspaceGraphExploration, useWorkspaceGraphFilter, useWorkspaceSelection };
+export { ActionPanel, type ActionPanelState, type ActionPanelStore, type ColorPalette, EMPTY_NORMALIZED, EdgeInfoCard, type EdgeVisual, type ExpandOptions, type ExpandResult, GraphA11yList, type GraphA11yListProps, type GraphDataHook, type GraphDataStore, type GraphDisplayConfig, type GraphExplorationDeps, type GraphExplorationStore, type GraphFilterStore, type GraphFocusAction, type GraphFocusStore, type GraphProperties, type GraphProperty, type GraphRenderer, GraphRendererProvider, type GraphStatistics, type WorkspaceStores as GraphStoreBundle, GraphStoresContext, GraphVisualizer, type GraphVisualizerProps, type LabelDisplayMap, type LiveGraphDataResult, NodeInfoCard, type NodeVisual, type NormalizedGraph, Overview, type RawGraphEdge, type RawGraphNode, type SelectionStore, type StoreFactory, type VisualGraphEdge, type VisualGraphNode, type VisualGraphNormalized, type WorkspaceStores, buildColorPalette, buildColorPaletteFromNodes, createActionPanelStore, createGraphDataStore, createGraphExplorationStore, createGraphFilterStore, createGraphFocusStore, createSelectionStore, enrichEdge, enrichEdges, enrichNode, enrichNodes, extractDisplayLabel, isRawGraphNode, isVisualEdge, isVisualNode, normalizeGraph, toCytoscapeEdge, toCytoscapeNode, toReagraphEdge, toReagraphNode, useActionPanelStore, useCytoscapeData, useGraphFocus, useGraphRenderer, useLiveGraphData, useReagraphData, useWorkspaceGraphData, useWorkspaceGraphExploration, useWorkspaceGraphFilter, useWorkspaceSelection };