@agent-native/core-corpus 0.212.1 → 0.214.0

package/corpus/templates/content/app/components/editor/database/GitHubSourcePanel.tsx

@@ -0,0 +1,228 @@
+import type { ContentDatabaseSource } from "@shared/api";
+import { IconExternalLink, IconRefresh } from "@tabler/icons-react";
+import { useState } from "react";
+
+import { Button } from "@/components/ui/button";
+import { Spinner } from "@/components/ui/spinner";
+import { useGitHubConnection } from "@/hooks/use-github-folder";
+import { openGitHubLinkDialog } from "@/lib/github-link-dialog";
+
+import {
+  githubAvailability,
+  githubBlockedExplanation,
+  githubOffersNewCollection,
+  githubRowDescription,
+  type GitHubAvailability,
+  type GitHubCollectionPlace,
+} from "./github-availability";
+import {
+  GitHubFolderFacts,
+  useCheckGitHubForUpdates,
+  useNow,
+} from "./GitHubSourceStatusLine";
+import { GitHubUnlinkDialog } from "./GitHubUnlinkDialog";
+import { dbText } from "./text";
+
+function openLinkDialog(
+  place: GitHubCollectionPlace,
+  returnFocusTo: HTMLElement | null,
+) {
+  openGitHubLinkDialog({
+    target: {
+      kind: "collection",
+      databaseId: place.databaseId,
+      documentId: place.documentId,
+      spaceId: place.spaceId,
+      parentId: place.parentId,
+    },
+    returnFocusTo,
+  });
+}
+
+function openNewCollectionDialog(
+  place: GitHubCollectionPlace,
+  returnFocusTo: HTMLElement | null,
+) {
+  if (!place.spaceId) return;
+  openGitHubLinkDialog({
+    target: { kind: "new", spaceId: place.spaceId, parentId: place.parentId },
+    returnFocusTo,
+  });
+}
+
+/**
+ * The GitHub row in a collection's Sources: whether a folder can be linked
+ * here, said on the row itself before any typing. A row that can link opens
+ * the dialog; the rest open the GitHub step, which explains and offers a fix.
+ */
+export function useGitHubSourcesRow(
+  place: GitHubCollectionPlace,
+  sources: ContentDatabaseSource[],
+  onOpenStep: () => void,
+) {
+  const now = useNow();
+  // Only asked when the collection could link, so readers and full
+  // collections never wait on GitHub.
+  const collectionAllows =
+    githubAvailability(place, sources, true).kind === "available";
+  const connection = useGitHubConnection(collectionAllows);
+  const availability = githubAvailability(
+    place,
+    sources,
+    connection.data?.connected,
+  );
+  return {
+    availability,
+    description: githubRowDescription(availability, now),
+    // Grayed out when this collection can't take a folder, but still
+    // reachable for the reason and, where there is one, the fix.
+    muted: availability.kind === "blocked",
+    open: (button: HTMLElement | null) => {
+      if (
+        availability.kind === "available" ||
+        availability.kind === "connect"
+      ) {
+        openLinkDialog(place, button);
+      } else {
+        onOpenStep();
+      }
+    },
+  };
+}
+
+function LinkedGitHubFolder({
+  source,
+  place,
+  onUnlinked,
+}: {
+  source: ContentDatabaseSource;
+  place: GitHubCollectionPlace;
+  onUnlinked: () => void;
+}) {
+  const now = useNow();
+  const check = useCheckGitHubForUpdates(source);
+  const [unlinkOpen, setUnlinkOpen] = useState(false);
+  const status = source.metadata.github;
+  if (!status) return null;
+  return (
+    <div className="grid min-w-0 gap-4" data-github-source-panel="linked">
+      <GitHubFolderFacts status={status} now={now} />
+      <div className="flex flex-wrap gap-1.5">
+        <Button asChild size="sm" variant="outline">
+          <a href={status.folderUrl} target="_blank" rel="noreferrer">
+            {dbText("githubOpenFolder")}
+            <IconExternalLink className="ms-1 size-3.5" aria-hidden />
+          </a>
+        </Button>
+        <Button
+          type="button"
+          size="sm"
+          variant="outline"
+          disabled={check.pending}
+          onClick={check.run}
+        >
+          {check.pending ? (
+            <Spinner className="me-1 size-3.5" />
+          ) : (
+            <IconRefresh className="me-1 size-3.5" aria-hidden />
+          )}
+          {dbText("githubCheckForUpdates")}
+        </Button>
+      </div>
+      <div className="grid min-w-0 gap-2 border-t border-border pt-3">
+        <p className="break-words text-xs text-muted-foreground">
+          {dbText("githubExplainLinked")}
+        </p>
+        {place.canEdit ? (
+          <>
+            <Button
+              type="button"
+              size="sm"
+              variant="outline-destructive"
+              className="justify-self-start"
+              onClick={() => setUnlinkOpen(true)}
+            >
+              {dbText("githubUnlinkFolder")}
+            </Button>
+            <GitHubUnlinkDialog
+              open={unlinkOpen}
+              onOpenChange={setUnlinkOpen}
+              documentId={place.documentId}
+              sourceId={source.id}
+              pageCount={place.pageCount}
+              onUnlinked={onUnlinked}
+            />
+          </>
+        ) : null}
+      </div>
+    </div>
+  );
+}
+
+/**
+ * The GitHub step of a collection's Sources: the linked folder's details
+ * and Unlink, or why a folder can't be linked here and what to do instead.
+ */
+export function GitHubSourcePanel({
+  place,
+  sources,
+  onUnlinked,
+}: {
+  place: GitHubCollectionPlace;
+  sources: ContentDatabaseSource[];
+  onUnlinked: () => void;
+}) {
+  const availability: GitHubAvailability = githubAvailability(
+    place,
+    sources,
+    undefined,
+  );
+  if (availability.kind === "linked") {
+    return (
+      <LinkedGitHubFolder
+        source={availability.source}
+        place={place}
+        onUnlinked={onUnlinked}
+      />
+    );
+  }
+  if (availability.kind === "blocked") {
+    return (
+      <div className="grid min-w-0 gap-3" data-github-source-panel="blocked">
+        <p className="break-words text-sm">
+          {githubBlockedExplanation(
+            availability.reason,
+            place,
+            availability.sourceName,
+          )}
+        </p>
+        {githubOffersNewCollection(availability, place) ? (
+          <Button
+            type="button"
+            size="sm"
+            className="justify-self-start"
+            onClick={(event) =>
+              openNewCollectionDialog(place, event.currentTarget)
+            }
+          >
+            {dbText("githubNewCollectionInstead")}
+          </Button>
+        ) : null}
+      </div>
+    );
+  }
+  // It became linkable since the row was opened, like after a page moved out.
+  return (
+    <div className="grid min-w-0 gap-3" data-github-source-panel="available">
+      <p className="break-words text-sm">{dbText("githubLinkDescription")}</p>
+      <Button
+        type="button"
+        size="sm"
+        className="justify-self-start"
+        onClick={(event) => openLinkDialog(place, event.currentTarget)}
+      >
+        {dbText("githubLinkTitle")}
+      </Button>
+    </div>
+  );
+}