sailfork / t3code-github / apps/ mobile/ src/ features/ pull-requests/ guide/ PullRequestGuideScreen.tsx

import { sourceControlClients } from "@t3tools/client-runtime/source-control-clients";
import { parsePatchFiles } from "@pierre/diffs/utils/parsePatchFiles";
import type { FileDiffMetadata } from "@pierre/diffs";
import { StackActions, useNavigation, type StaticScreenProps } from "@react-navigation/native";
import { useEffect } from "react";
import { Pressable, View } from "react-native";
import { AppBar } from "../../../components/ui/AppBar";
import { useSafeAreaInsets } from "react-native-safe-area-context";
import {
  letterStopNotes,
  stepTourPosition,
  stopFilePaths,
} from "@t3tools/client-runtime/review-guide-tour";
import { SymbolView } from "../../../components/ui/AppSymbol";
import { GuideOutline } from "./GuideOutline";
import { AppText as Text } from "../../../components/ui/AppText";
import { ScreenScrollView } from "../../../components/ui/ScreenScrollView";
import { useAppearancePreferences } from "../../settings/appearance/AppearancePreferencesProvider";
import { PullRequestCardGroup, PullRequestCardRow } from "../PullRequestControls";
import { PullRequestMarkdown, PullRequestMarkdownRepository } from "../PullRequestMarkdown";
import { usePullRequestDiff, type PullRequestParams } from "../usePullRequestDiff";
import { ReviewGuideExcerpt } from "./ReviewGuideExcerpt";
import { reviewGuideState } from "./reviewGuideState";
import { GuideNotice } from "./GuideNotice";
import Animated from "react-native-reanimated";
import { PR_ROW_ENTER, PR_ROW_EXIT, PR_ROW_LAYOUT } from "../pullRequestAnimations";
import { useEnvironmentQuery } from "../../../state/query";
import { composerPullRequests } from "../../../state/pull-requests";
import { usePullRequestPermissions } from "../usePullRequestPermissions";
import { pullRequestTarget } from "../usePullRequestDiff";
import { useReviewGuide } from "./useReviewGuide";

export type GuideStopParams = PullRequestParams & {
  readonly position: number;
  readonly guideHeadSha: string;
  readonly guideGeneratedAt: string;
};

const attentionLabels = {
  tradeoff: "A tradeoff to weigh",
  contract: "A contract to check",
  product: "A product call",
  risk: "A risk to judge",
  accessibility: "An accessibility call",
};

export function PullRequestGuideContent({
  params,
  visible = true,
}: {
  readonly params: PullRequestParams;
  readonly visible?: boolean;
}) {
  const navigation = useNavigation();
  const state = useReviewGuide(params, visible);
  const { guide, stale } = reviewGuideState(state.data);
  return (
    <Animated.View layout={PR_ROW_LAYOUT} className="w-full max-w-[760px] self-center">
      {!state.enabled ? (
        <Text>Review guides are disabled for this server.</Text>
      ) : (
        <>
          <GuideNotice state={state} />
          {guide ? (
            <Animated.View
              key={`outline:${guide.headSha}:${guide.generatedAt}`}
              layout={PR_ROW_LAYOUT}
              entering={PR_ROW_ENTER}
              exiting={PR_ROW_EXIT}
            >
              <GuideOutline
                guide={guide}
                onOpen={(position) =>
                  navigation.dispatch(
                    StackActions.push("PullRequestGuideStop", {
                      ...params,
                      position,
                      guideHeadSha: guide.headSha,
                      guideGeneratedAt: guide.generatedAt,
                    }),
                  )
                }
                onRewrite={
                  state.canWrite && !state.running && !stale && !state.startError && !state.error
                    ? () => void state.write()
                    : undefined
                }
              />
            </Animated.View>
          ) : null}
        </>
      )}
    </Animated.View>
  );
}

export function PullRequestGuideStopScreen({ route }: StaticScreenProps<GuideStopParams>) {
  const navigation = useNavigation();
  const state = useReviewGuide(route.params);
  const detail = useEnvironmentQuery(composerPullRequests.detail(pullRequestTarget(route.params)));
  const permissions = usePullRequestPermissions(route.params, detail.data);
  const canReview =
    permissions.verdicts.length > 0 && detail.data?.headSha === route.params.guideHeadSha;
  const { guide, stale } = reviewGuideState(state.data);
  const position = Math.max(0, Math.min(route.params.position, (guide?.stops.length ?? 1) - 1));
  const stop = guide?.stops[Math.max(0, position)];
  const diff = usePullRequestDiff(
    route.params,
    sourceControlClients.get((detail.data ?? route.params.initialSummary)?.provider).changeRequest,
  );
  const excerptFiles = diffFilesByPath(diff.patch);
  const wanted = stop ? stopFilePaths(stop) : [];
  const loadedPaths = new Set(
    diff.parsed.kind === "files" ? diff.parsed.files.map((file) => file.path) : [],
  );
  const missing = wanted.some((path) => !loadedPaths.has(path));
  const { error: diffError, loadMore } = diff;
  // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- requests the next page of the paged diff query until the stop's files have loaded
  useEffect(() => {
    if (state.enabled && missing && !diffError) loadMore();
  }, [state.enabled, missing, diffError, loadMore]);
  const insets = useSafeAreaInsets();
  const changedGuide =
    guide !== null &&
    (guide.headSha !== route.params.guideHeadSha ||
      guide.generatedAt !== route.params.guideGeneratedAt);
  const { appearance, setCodeWordBreak } = useAppearancePreferences();
  const notes = stop ? letterStopNotes(stop).lettered : [];
  return (
    <View className="flex-1 bg-screen">
      <AppBar
        title={`Stop ${route.params.position + 1} of ${guide?.stops.length ?? "…"}`}
        onBack={() => navigation.goBack()}
        menus={[
          {
            title: "Guide options",
            icon: "ellipsis",
            items: [
              {
                id: "word-wrap",
                title: "Word wrap",
                icon: "text.alignleft",
                selected: appearance.codeWordBreak,
                onPress: () => setCodeWordBreak(!appearance.codeWordBreak),
              },
            ],
          },
        ]}
      />
      <PullRequestMarkdownRepository params={route.params} changeRequest={detail.data}>
        <ScreenScrollView
          contentInsetAdjustmentBehavior="automatic"
          contentContainerStyle={{ padding: 16, paddingBottom: insets.bottom + 24, gap: 20 }}
        >
          <View className="w-full max-w-[760px] self-center gap-5">
            {!state.enabled ? (
              <Text>Review guides are disabled for this server.</Text>
            ) : changedGuide ? (
              <Text>This guide was rewritten. Go back to start the new tour.</Text>
            ) : !stop ? (
              <Text>{state.error ?? "Loading stop…"}</Text>
            ) : (
              <>
                <GuideNotice state={state} />
                <Text className="text-2xl leading-8 font-t3-semibold">{stop.title}</Text>
                <PullRequestMarkdown lineBreaks={false} markdown={stop.summary} />
                {stop.attention ? (
                  <View className="gap-3 rounded-xl border border-border bg-grouped-card p-4">
                    <View className="flex-row items-center gap-2">
                      <SymbolView name="eye" size={17} tintColorClassName="accent-icon-muted" />
                      <Text className="text-sm font-t3-semibold">
                        {attentionLabels[stop.attention.kind]}
                      </Text>
                    </View>
                    <PullRequestMarkdown lineBreaks={false} markdown={stop.attention.note} />
                  </View>
                ) : null}
                {stale ? (
                  <Text className="text-sm text-foreground-muted">
                    Excerpts are hidden until the guide is rewritten for the current head.
                  </Text>
                ) : (
                  stop.excerpts.map((excerpt) => (
                    <ReviewGuideExcerpt
                      key={`${guide?.headSha}:${JSON.stringify(excerpt)}`}
                      onOpen={() =>
                        navigation.dispatch(
                          StackActions.push("PullRequestFile", {
                            ...route.params,
                            path: excerpt.path,
                            focus: { side: excerpt.side, start: excerpt.start, end: excerpt.end },
                          }),
                        )
                      }
                      excerpt={excerpt}
                      file={excerptFiles.get(excerpt.path)}
                      loading={diff.isPending || (missing && diff.nextCursor !== null)}
                    />
                  ))
                )}
                {diff.error ? <Text className="text-danger-foreground">{diff.error}</Text> : null}
                {notes.length ? (
                  <View className="gap-4">
                    <Text className="font-t3-semibold">Notes on this stop</Text>
                    {notes.map(({ marker, note }) => (
                      <View key={marker} className="flex-row gap-3">
                        <View className="h-7 w-7 items-center justify-center rounded-lg bg-grouped-card">
                          <Text className="text-xs font-t3-semibold">{marker}</Text>
                        </View>
                        <View className="min-w-0 flex-1 gap-2">
                          <Text className="font-t3-semibold">{note.title}</Text>
                          <Text className="text-xs text-foreground-muted">
                            {note.path.split("/").at(-1)}:{note.line}
                          </Text>
                          <PullRequestMarkdown lineBreaks={false} markdown={note.body} />
                        </View>
                      </View>
                    ))}
                  </View>
                ) : null}
                {stop.files.length ? (
                  <PullRequestCardGroup>
                    {stop.files.map((file, index) => (
                      <PullRequestCardRow
                        key={file.path}
                        title={file.path}
                        detail={file.note}
                        icon="doc"
                        last={index === stop.files.length - 1}
                        onPress={() =>
                          navigation.navigate("PullRequestFile", {
                            ...route.params,
                            path: file.path,
                          })
                        }
                      />
                    ))}
                  </PullRequestCardGroup>
                ) : null}
                {stop.questions.length ? (
                  <View className="gap-3">
                    <Text className="font-t3-semibold">Questions to consider</Text>
                    {stop.questions.map((question) => (
                      <PullRequestMarkdown key={question} lineBreaks={false} markdown={question} />
                    ))}
                  </View>
                ) : null}
                <Pressable
                  accessibilityRole="button"
                  accessibilityLabel={
                    guide && position < guide.stops.length - 1
                      ? "Next stop"
                      : canReview
                        ? "Finish review"
                        : "Finish tour"
                  }
                  className="mt-2 flex-row items-center gap-4 border-t border-border-subtle pt-5 pb-2 active:opacity-60"
                  onPress={() =>
                    guide && position < guide.stops.length - 1
                      ? navigation.dispatch(
                          StackActions.push("PullRequestGuideStop", {
                            ...route.params,
                            position: stepTourPosition(position, 1, guide.stops.length),
                          }),
                        )
                      : canReview
                        ? navigation.navigate("PullRequestReview", {
                            ...route.params,
                            mode: "review",
                          })
                        : navigation.dispatch(StackActions.popTo("PullRequest", route.params))
                  }
                >
                  <View className="min-w-0 flex-1 gap-1">
                    <Text className="text-xs text-foreground-muted">
                      {guide && position < guide.stops.length - 1
                        ? `Next · ${position + 2} of ${guide.stops.length}`
                        : "End of guide"}
                    </Text>
                    <Text className="text-base font-t3-semibold">
                      {guide && position < guide.stops.length - 1
                        ? guide.stops[position + 1]?.title
                        : canReview
                          ? "Finish review"
                          : "Finish tour"}
                    </Text>
                  </View>
                  <View className="h-11 w-11 items-center justify-center rounded-full bg-foreground">
                    <SymbolView
                      name={
                        guide && position < guide.stops.length - 1 ? "arrow.right" : "checkmark"
                      }
                      size={20}
                      tintColorClassName="accent-screen"
                    />
                  </View>
                </Pressable>
              </>
            )}
          </View>
        </ScreenScrollView>
      </PullRequestMarkdownRepository>
    </View>
  );
}

function diffFilesByPath(patchText: string): Map<string, FileDiffMetadata> {
  const files = new Map<string, FileDiffMetadata>();
  try {
    for (const patch of parsePatchFiles(patchText)) {
      for (const file of patch.files) {
        files.set(file.name, file);
        if (file.prevName) files.set(file.prevName, file);
      }
    }
  } catch {}
  return files;
}