Function useSheetStatement

frontend/src/react/hooks/useSheetStatement.ts:70–131

({
  enabled,
  sheetName,
  getLocalSheet,
}: {
  enabled: boolean;
  sheetName: string;
  getLocalSheet?: (name: string) => Sheet | undefined;
})

 * statement reuse {@link seedSheetStatement} directly instead.
 */
export const useSheetStatement = ({
  enabled,
  sheetName,
  getLocalSheet,
}: {
  enabled: boolean;
  sheetName: string;
  getLocalSheet?: (name: string) => Sheet | undefined;
}): SheetStatementSnapshot => {
  const [snapshot, setSnapshot] = useState<SheetStatementSnapshot>(() =>
    enabled ? seedSheetStatement(sheetName, getLocalSheet) : EMPTY_SNAPSHOT
  );

  const seedKey = enabled ? sheetName : "";
  const [trackedSeedKey, setTrackedSeedKey] = useState(seedKey);
  if (seedKey !== trackedSeedKey) {
    setTrackedSeedKey(seedKey);
    setSnapshot(
      enabled ? seedSheetStatement(sheetName, getLocalSheet) : EMPTY_SNAPSHOT
    );
  }

  useEffect(() => {
    if (!enabled || !sheetName) {
      return;
    }
    // Local and already-cached sheets were seeded synchronously above.
    if (extractSheetUID(sheetName).startsWith("-")) {
      return;
    }
    if (useAppStore.getState().getSheetByName(sheetName)) {
      return;
    }

    let canceled = false;
    const load = async () => {
      try {
        const sheet = await useAppStore
          .getState()
          .getOrFetchSheetByName(sheetName);
        if (canceled || !sheet) {
          return;
        }
        setSnapshot(snapshotOfSheet(sheet));
      } finally {
        if (!canceled) {
          setSnapshot((prev) =>
            prev.isLoading ? { ...prev, isLoading: false } : prev
          );
        }
      }
    };
    void load();
    return () => {
      canceled = true;
    };
    // getLocalSheet is intentionally excluded: only the synchronous seed reads
    // it, and the effect handles remote sheets exclusively.