Function useGitState

src/web-ui/src/tools/git/hooks/useGitState.ts:54–254

(options: UseGitStateOptions)

>;

export function useGitState(options: UseGitStateOptions): UseGitStateReturn {
  const {
    repositoryPath,
    isActive = true,
    participateInWindowFocusRefresh = true,
    selector,
    refreshOnMount = true,
    refreshOnActive = true,
    debugSource = 'use_git_state',
    cancelPendingRefreshSources = DEFAULT_CANCEL_PENDING_REFRESH_SOURCES,
    layers,
  } = options;

  const normalizedPath = useMemo(
    () => repositoryPath.replace(/\\/g, '/'),
    [repositoryPath]
  );

  const [state, setState] = useState<GitState | null>(() =>
    gitStateManager.getState(normalizedPath)
  );

  const prevActiveRef = useRef(isActive);
  const mountedRef = useRef(true);
  const selectorRef = useRef(selector);
  const layersRef = useRef(layers);
  const suppressedMountRefreshRef = useRef(false);

  useEffect(() => {
    selectorRef.current = selector;
  }, [selector]);

  useEffect(() => {
    layersRef.current = layers;
  }, [layers]);

  useEffect(() => {
    if (!normalizedPath) return;

    mountedRef.current = true;

    const unsubscribe = gitStateManager.subscribe(
      normalizedPath,
      (newState, _prevState, _changedLayers) => {
        if (!mountedRef.current) return;
        if (selectorRef.current) {
          const selectedValue = selectorRef.current(newState);
          setState((prev) => {
            const prevSelected = prev ? selectorRef.current!(prev) : null;
            if (shallowEqual(selectedValue, prevSelected)) {
              return prev;
            }
            return newState;
          });
        } else {
          setState(newState);
        }
      },