feat(plugins): add source-control extension contracts (#2117)

This commit is contained in:
José Almeida
2026-08-13 08:29:29 +01:00
committed by GitHub
parent 064b852884
commit f218880ecb
530 changed files with 39054 additions and 7518 deletions
+46 -115
View File
@@ -1,29 +1,18 @@
"use client";
import Link from "@/components/routing/app-link";
import { useTranslation } from "react-i18next";
import { ChangeRequestList, ChangeRequestRow } from "@/components/integrations/change-request-list";
import {
IconGitPullRequest,
IconGitPullRequestClosed,
IconGitMerge,
IconPlus,
IconChevronDown,
} from "@tabler/icons-react";
import type { Icon } from "@tabler/icons-react";
import { Button } from "@kandev/ui/button";
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuTrigger,
} from "@kandev/ui/dropdown-menu";
import { Spinner } from "@kandev/ui/spinner";
IntegrationIcon,
type IntegrationIconName,
} from "@/components/integrations/integration-icon";
import { IntegrationStartTaskMenu } from "@/components/integrations/integration-start-task-menu";
import { cn, formatRelativeTime } from "@/lib/utils";
import type { GitHubPR, GitHubPRStatus, TaskPR } from "@/lib/types/github";
import type { LaunchPayload, TaskPreset } from "./quick-task-launcher";
import { PRStatusBadges } from "./pr-status-badges";
import { prStatusKey, usePRStatuses } from "./use-pr-statuses";
import { PRRowTaskIndicator } from "./pr-row-task-indicator";
import { useTranslation } from "react-i18next";
import { prStatusKey, usePRStatuses } from "./use-pr-statuses";
type PRListProps = {
workspaceId: string | null;
@@ -35,20 +24,17 @@ type PRListProps = {
prKeyToTasks?: Map<string, TaskPR[]>;
};
// Prefer the enriched PR returned by the batched status endpoint — the search
// API used to populate `items` does not include head/base branches, so the
// launcher needs the enriched copy to pre-fill the task dialog correctly.
export function pickPRForLaunch(pr: GitHubPR, status: GitHubPRStatus | null | undefined): GitHubPR {
return status?.pr ?? pr;
}
function prStateIcon(pr: GitHubPR): { Icon: Icon; className: string } {
function prStateIcon(pr: GitHubPR): { name: IntegrationIconName; className: string } {
if (pr.state === "merged")
return { Icon: IconGitMerge, className: "text-purple-600 dark:text-purple-400" };
return { name: "merged", className: "text-purple-600 dark:text-purple-400" };
if (pr.state === "closed")
return { Icon: IconGitPullRequestClosed, className: "text-red-600 dark:text-red-400" };
if (pr.draft) return { Icon: IconGitPullRequest, className: "text-muted-foreground" };
return { Icon: IconGitPullRequest, className: "text-emerald-600 dark:text-emerald-400" };
return { name: "pull-request-closed", className: "text-red-600 dark:text-red-400" };
if (pr.draft) return { name: "pull-request", className: "text-muted-foreground" };
return { name: "pull-request", className: "text-emerald-600 dark:text-emerald-400" };
}
function StartTaskMenu({
@@ -61,42 +47,15 @@ function StartTaskMenu({
onStartTask: PRListProps["onStartTask"];
}) {
const { t } = useTranslation();
const launch = (preset: TaskPreset) => onStartTask({ kind: "pr", pr, preset });
return (
<DropdownMenu>
<DropdownMenuTrigger asChild>
<Button
size="sm"
variant="outline"
className="h-7 gap-1 cursor-pointer"
data-testid="pr-start-task-trigger"
>
<IconPlus className="h-3.5 w-3.5" />
{t("github:task")}
<IconChevronDown className="h-3 w-3" />
</Button>
</DropdownMenuTrigger>
<DropdownMenuContent align="end" className="w-48">
{presets.map((p) => {
const ItemIcon = p.icon;
return (
<DropdownMenuItem
key={p.id}
className="cursor-pointer gap-2 py-1.5"
onSelect={() => launch(p)}
data-testid="pr-start-task-preset"
data-preset-id={p.id}
>
<ItemIcon className="h-3.5 w-3.5 text-muted-foreground shrink-0" />
<div className="flex flex-col min-w-0">
<span className="text-xs font-medium leading-tight">{p.label}</span>
<span className="text-[11px] text-muted-foreground leading-tight">{p.hint}</span>
</div>
</DropdownMenuItem>
);
})}
</DropdownMenuContent>
</DropdownMenu>
<IntegrationStartTaskMenu
presets={presets}
onSelect={(preset) => onStartTask({ kind: "pr", pr, preset })}
triggerLabel={t("github:task")}
triggerAriaLabel={t("github:task")}
triggerTestId="pr-start-task-trigger"
itemTestId="pr-start-task-preset"
/>
);
}
@@ -113,25 +72,15 @@ function PRRow({
onStartTask: PRListProps["onStartTask"];
tasks: TaskPR[] | undefined;
}) {
const { Icon: StateIcon, className: stateIconClass } = prStateIcon(pr);
const { t } = useTranslation();
const { name: stateIconName, className: stateIconClass } = prStateIcon(pr);
return (
<div
className="flex items-start gap-3 px-4 py-3 hover:bg-muted/40 transition-colors"
data-testid="pr-row"
data-pr-number={pr.number}
>
<StateIcon className={cn("h-4 w-4 mt-1 shrink-0", stateIconClass)} />
<div className="min-w-0 flex-1">
<Link
href={pr.html_url}
target="_blank"
rel="noopener noreferrer"
className="text-sm font-semibold hover:underline block truncate cursor-pointer"
>
{pr.title}
</Link>
<div className="flex flex-wrap items-center gap-x-2 gap-y-1 mt-0.5 text-xs text-muted-foreground">
<ChangeRequestRow
stateIcon={<IntegrationIcon name={stateIconName} className={cn("h-4 w-4", stateIconClass)} />}
title={pr.title}
href={pr.html_url}
metadata={
<>
<span className="whitespace-nowrap">
{pr.repo_owner}/{pr.repo_name}#{pr.number}
</span>
@@ -143,50 +92,26 @@ function PRRow({
})}
</span>
<PRStatusBadges pr={pr} status={status} />
<PRRowTaskIndicator tasks={tasks} />
</div>
</div>
<div className="shrink-0">
</>
}
taskIndicator={<PRRowTaskIndicator tasks={tasks} />}
action={
<StartTaskMenu
pr={pickPRForLaunch(pr, status)}
presets={presets}
onStartTask={onStartTask}
/>
</div>
</div>
}
testId="pr-row"
dataAttributes={{ "data-pr-number": pr.number }}
/>
);
}
function PRListBody({
workspaceId,
loading,
error,
items,
presets,
onStartTask,
prKeyToTasks,
}: PRListProps) {
const { t } = useTranslation();
function PRListBody({ workspaceId, items, presets, onStartTask, prKeyToTasks }: PRListProps) {
const statuses = usePRStatuses(workspaceId, items);
if (loading) {
return (
<div className="flex justify-center py-10">
<Spinner />
</div>
);
}
if (error) {
return <div className="text-center py-10 text-destructive text-sm">{error}</div>;
}
if (items.length === 0) {
return (
<div className="text-center py-10 text-muted-foreground text-sm">
{t("github:noPullRequestsMatchThisFilter")}
</div>
);
}
return (
<div className="divide-y">
<>
{items.map((pr) => {
const key = prStatusKey(pr.repo_owner, pr.repo_name, pr.number);
return (
@@ -200,14 +125,20 @@ function PRListBody({
/>
);
})}
</div>
</>
);
}
export function PRList(props: PRListProps) {
const { t } = useTranslation();
return (
<div className="rounded-md border overflow-hidden">
<ChangeRequestList
loading={props.loading}
error={props.error}
emptyMessage={t("github:noPullRequestsMatchThisFilter")}
isEmpty={props.items.length === 0}
>
<PRListBody {...props} />
</div>
</ChangeRequestList>
);
}