Function useGraphViewer

ui/src/hooks/useGraphViewer.ts:265–1044

(
  options: UseGraphViewerOptions = {},
)

 * for the OSS reference shell.
 */
export function useGraphViewer(
  options: UseGraphViewerOptions = {},
): UseGraphViewerResult {
  const {
    chatHighlightNodes,
    extraHighlightSource,
    suppressNextAutoFitRef,
    autoFitMode = 'schedule',
  } = options;

  const canvasRef = useRef<GraphCanvasHandle>(null);

  const { graphData, stats, lastSearchQuery, graphVersion, loadGraph } =
    useGraph();

  const {
    selectedNode,
    setSelectedNode,
    selectedLink,
    setSelectedLink,
    setNodeHistory,
    setHiddenNodeTypes,
    setHiddenCommunities,
    colorMode,
    searchQuery,
    setSearchQuery,
    hops,
    setHops,
    focusedCommunityNodes,
    setFocusedCommunityNodes,
    communitiesEnabled,
    setCommunitiesEnabled,
    communityData,
    filteredGraphData,
    highlights,
  } = useGraphInteraction();

  // Stable pointer to the latest graphData. Lets stale closures (imperative
  // handle, narrow-dep effects) read fresh data without forcing graphData
  // into their dependency arrays.
  const graphDataRef = useRef(graphData);
  useEffect(() => {
    graphDataRef.current = graphData;
  }, [graphData]);

  // ─── Auto-fit on graphVersion bump ──────────────────────────────────────
  // Mode is consumer-selected via `options.autoFitMode`:
  //   - 'schedule' (default): `scheduleAutoFit` is throttled and gated by
  //     the user's pan/zoom state, so it's a no-op if the user has already
  //     moved the camera (preserves user intent — OSS default).
  //   - 'unconditional': always re-fits after a 500ms layout-settle delay,
  //     ignoring user camera state (matches the legacy UI-repo fork behavior).
  // Either mode honors `suppressNextAutoFitRef` for one-shot suppression.
  useEffect(() => {
    if (graphVersion === 0) return;
    if (suppressNextAutoFitRef?.current) {
      suppressNextAutoFitRef.current = false;
      return;