The best way to control Claude Code, Codex and more from any computer or phone
feat(web): label chips show the label's description on hover (#28732)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: maria-rcks <maria@kuuro.net> Co-authored-by: Julius Marminge <julius0216@outlook.com>
Antony committed
Nov 11, 2026 at 08:06 UTC
dea84724384fcc68ef802e7db8440d9abaf0ef26
11 files changed
+64
-26
apps/web/src/components/pullRequest/PullRequestSummaryTab.tsx
+1
@@ -901,6 +901,7 @@ export function PullRequestSummaryTab({
901
label={label}
902
size="default"
903
className="max-w-48"
904
+ focusable
905
/>
906
))
907
)}
apps/web/src/components/pullRequest/pullRequestPresentation.tsx
+13
-2
@@ -40,25 +40,36 @@ export function PullRequestLabelChip({
40
label,
41
size = "sm",
42
className,
43
+ focusable = false,
44
children,
45
}: {
45
- label: Pick<PullRequestLabel, "name" | "color">;
46
+ label: Pick<PullRequestLabel, "name" | "color" | "description">;
47
size?: "sm" | "default";
48
className?: string;
49
+ focusable?: boolean;
50
children?: ReactNode;
51
}) {
52
const color = pullRequestLabelColor(label.color);
51
- return (
53
+ const badge = (
54
<Badge
55
size={size}
56
variant={color ? "label" : "secondary"}
57
className={cn("min-w-0 max-w-40 shrink justify-start", className)}
58
+ {...(focusable && label.description ? { tabIndex: 0 } : {})}
59
{...(color ? { style: { "--label": color } as CSSProperties } : {})}
60
>
61
<span className="truncate">{label.name}</span>
62
+ {label.description ? <span className="sr-only">: {label.description}</span> : null}
63
{children}
64
</Badge>
65
);
66
+ if (!label.description) return badge;
67
+ return (
68
+ <Tooltip>
69
+ <TooltipTrigger render={badge} />
70
+ <TooltipPopup>{label.description}</TooltipPopup>
71
+ </Tooltip>
72
+ );
73
}
74
75
function reviewDecisionPresentation(decision: PullRequestReviewDecision) {
packages/contracts/src/pullRequest.ts
+1
@@ -89,6 +89,7 @@ export type PullRequestActor = typeof PullRequestActor.Type;
89
export const PullRequestLabel = Schema.Struct({
90
name: TrimmedNonEmptyString,
91
color: Schema.NullOr(Schema.String),
92
+ description: Schema.optional(Schema.NullOr(Schema.String)),
93
});
94
export type PullRequestLabel = typeof PullRequestLabel.Type;
95
packages/source-control-forgejo/src/server/ForgejoSourceControlProvider.test.ts
+8
-1
@@ -573,7 +573,10 @@ it.effect.each([
573
updated_at: "2026-09-16T00:00:00Z",
574
closed_at: null,
575
merged_at: null,
576
- labels: [],
576
+ labels: [
577
+ { id: 1, name: "bug", color: "ee0701", description: "Something is broken" },
578
+ { id: 2, name: "triage", color: "c5def5", description: "" },
579
+ ],
580
};
581
const requests: string[] = [];
582
return Effect.gen(function* () {
@@ -603,6 +606,10 @@ it.effect.each([
606
const detail = yield* provider.getChangeRequest(input);
607
assert.strictEqual(list.items.length, 1);
608
assert.strictEqual(detail.headSha, "head");
609
+ assert.deepStrictEqual(detail.labels, [
610
+ { name: "bug", color: "ee0701", description: "Something is broken" },
611
+ { name: "triage", color: "c5def5", description: null },
612
+ ]);
613
for (const result of [list.items[0]!, summary, detail]) {
614
assert.strictEqual(result.mergeability, mergeability);
615
assert.strictEqual(result.isDraft, isDraft);
packages/source-control-forgejo/src/server/forgejoPullRequestJson.ts
+5
-1
@@ -147,7 +147,11 @@ export function forgejoChangeRequest(pr: typeof ForgejoPullRequest.Type) {
147
closedAt: pr.closed_at === null ? null : toIsoUtc(pr.closed_at),
148
mergedAt: pr.merged_at === null ? null : toIsoUtc(pr.merged_at),
149
reviewRequestLogins: (pr.requested_reviewers ?? []).map((user) => user.login),
150
- labels: (pr.labels ?? []).map((label) => ({ name: label.name, color: label.color ?? null })),
150
+ labels: (pr.labels ?? []).map((label) => ({
151
+ name: label.name,
152
+ color: label.color ?? null,
153
+ description: label.description || null,
154
+ })),
155
} satisfies ProviderChangeRequest;
156
}
157
packages/source-control-github/src/server/GitHubPullRequestApi.test.ts
+10
-3
@@ -475,7 +475,7 @@ function searchItem(number: number, repository: string, updatedAt: string) {
475
updatedAt,
476
repository: { nameWithOwner: repository },
477
reviewRequests: { nodes: [{ requestedReviewer: { __typename: "User", login: "hubot" } }] },
478
- labels: { nodes: [{ name: "bug", color: "ff0000" }] },
478
+ labels: { nodes: [{ name: "bug", color: "ff0000", description: "Something is broken" }] },
479
};
480
}
481
@@ -1612,6 +1612,9 @@ layer("GitHubPullRequestApi.layer", (it) => {
1612
[0, 0],
1613
],
1614
);
1615
+ assert.deepStrictEqual(batch.items[0]?.labels, [
1616
+ { name: "bug", color: "ff0000", description: "Something is broken" },
1617
+ ]);
1618
assert.isFalse(batch.truncated);
1619
}),
1620
);
@@ -3513,7 +3516,9 @@ layer("GitHubPullRequestApi.layer", (it) => {
3516
},
3517
],
3518
},
3516
- labels: { nodes: [{ name: "bug", color: "ff0000" }] },
3519
+ labels: {
3520
+ nodes: [{ name: "bug", color: "ff0000", description: "Something is broken" }],
3521
+ },
3522
commits: {
3523
nodes: [
3524
{
@@ -3564,7 +3569,9 @@ layer("GitHubPullRequestApi.layer", (it) => {
3569
avatarUrl: "https://avatars.githubusercontent.com/t/1",
3570
},
3571
]);
3567
- expect(detail.labels).toEqual([{ name: "bug", color: "ff0000" }]);
3572
+ expect(detail.labels).toEqual([
3573
+ { name: "bug", color: "ff0000", description: "Something is broken" },
3574
+ ]);
3575
expect(detail.checks).toHaveLength(2);
3576
expect(detail.checksState).toBe("failing");
3577
}),
packages/source-control-github/src/server/gitHubPullRequestJson.ts
+4
-1
@@ -113,6 +113,7 @@ interface ListItemFields {
113
interface LabelFields {
114
readonly name: string;
115
readonly color?: string | null | undefined;
116
+ readonly description?: string | null | undefined;
117
}
118
119
interface ReviewRequestFields {
@@ -546,7 +547,9 @@ function toReviewDecision(value: string | null | undefined): PullRequestReviewDe
547
function toLabels(raw: ReadonlyArray<LabelFields> | undefined): ReadonlyArray<PullRequestLabel> {
548
return (raw ?? []).flatMap((label) => {
549
const name = trimmed(label.name);
549
- return name === null ? [] : [{ name, color: trimmed(label.color) }];
550
+ return name === null
551
+ ? []
552
+ : [{ name, color: trimmed(label.color), description: trimmed(label.description) }];
553
});
554
}
555
packages/source-control-github/src/server/pullRequestListings.graphql
+1
@@ -67,6 +67,7 @@ fragment PullRequestRow on PullRequest {
67
nodes {
68
name
69
color
70
+ description
71
}
72
}
73
# GitHub's rollup for the head commit, one enum, rather than the whole check list: measured at a
packages/source-control-github/src/server/pullRequestListings.graphql.ts
+5
-3
@@ -121,7 +121,9 @@ export const Label = Schema.Struct({
121
/** Identifies the label name. */
122
name: Schema.String,
123
/** Identifies the label color. */
124
- color: Schema.String
124
+ color: Schema.String,
125
+ /** A brief description of this label. */
126
+ description: Schema.NullOr(Schema.String)
127
})
128
export interface Label extends Schema.Struct.Type<typeof Label.fields> {}
129
@@ -268,7 +270,7 @@ export const PullRequestSearch = GraphQL.query("PullRequestSearch", {
270
{ name: "search", body: ["(query:$", "q", " type:ISSUE first:$", "first", " after:$", "after", "){pageInfo{hasNextPage endCursor}nodes{__typename...", "PullRequestRow", "}}"] }
271
],
272
fragments: [
271
- { name: "PullRequestRow", body: ["on PullRequest{stack@include(if:$", "stacks", "){number size baseRefName}stackEntry@include(if:$", "stacks", "){position}number title url author{__typename login avatarUrl...on User{name}}headRefName baseRefName state isDraft mergeable reviewDecision latestReviews(first:20){nodes{state isMinimized author{__typename login}}}additions@include(if:$", "stats", ")deletions@include(if:$", "stats", ")createdAt updatedAt mergedAt repository{nameWithOwner}reviewRequests(first:20){nodes{requestedReviewer{__typename...on User{login}...on Team{slug}}}}labels(first:20){nodes{name color}}commits(last:1){nodes{commit{statusCheckRollup{state}}}}}"] }
273
+ { name: "PullRequestRow", body: ["on PullRequest{stack@include(if:$", "stacks", "){number size baseRefName}stackEntry@include(if:$", "stacks", "){position}number title url author{__typename login avatarUrl...on User{name}}headRefName baseRefName state isDraft mergeable reviewDecision latestReviews(first:20){nodes{state isMinimized author{__typename login}}}additions@include(if:$", "stats", ")deletions@include(if:$", "stats", ")createdAt updatedAt mergedAt repository{nameWithOwner}reviewRequests(first:20){nodes{requestedReviewer{__typename...on User{login}...on Team{slug}}}}labels(first:20){nodes{name color description}}commits(last:1){nodes{commit{statusCheckRollup{state}}}}}"] }
274
]
275
},
276
variables: {
@@ -320,7 +322,7 @@ export const PullRequestList = GraphQL.query("PullRequestList", {
322
{ name: "repository", body: ["(owner:$", "owner", " name:$", "name", "){pullRequests(first:$", "first", " after:$", "after", " states:$", "states", " orderBy:{field:CREATED_AT direction:DESC}){pageInfo{hasNextPage endCursor}nodes{...", "PullRequestRow", "}}}"] }
323
],
324
fragments: [
323
- { name: "PullRequestRow", body: ["on PullRequest{stack@include(if:$", "stacks", "){number size baseRefName}stackEntry@include(if:$", "stacks", "){position}number title url author{__typename login avatarUrl...on User{name}}headRefName baseRefName state isDraft mergeable reviewDecision latestReviews(first:20){nodes{state isMinimized author{__typename login}}}additions@include(if:$", "stats", ")deletions@include(if:$", "stats", ")createdAt updatedAt mergedAt repository{nameWithOwner}reviewRequests(first:20){nodes{requestedReviewer{__typename...on User{login}...on Team{slug}}}}labels(first:20){nodes{name color}}commits(last:1){nodes{commit{statusCheckRollup{state}}}}}"] }
325
+ { name: "PullRequestRow", body: ["on PullRequest{stack@include(if:$", "stacks", "){number size baseRefName}stackEntry@include(if:$", "stacks", "){position}number title url author{__typename login avatarUrl...on User{name}}headRefName baseRefName state isDraft mergeable reviewDecision latestReviews(first:20){nodes{state isMinimized author{__typename login}}}additions@include(if:$", "stats", ")deletions@include(if:$", "stats", ")createdAt updatedAt mergedAt repository{nameWithOwner}reviewRequests(first:20){nodes{requestedReviewer{__typename...on User{login}...on Team{slug}}}}labels(first:20){nodes{name color description}}commits(last:1){nodes{commit{statusCheckRollup{state}}}}}"] }
326
]
327
},
328
variables: {
packages/source-control-github/src/server/pullRequestReads.graphql
+1
@@ -144,6 +144,7 @@ query PullRequestCore(
144
nodes {
145
name
146
color
147
+ description
148
}
149
}
150
commits(last: 1) {
packages/source-control-github/src/server/pullRequestReads.graphql.ts
+15
-15
@@ -340,7 +340,9 @@ export const PullRequestCoreRepositoryPullRequestLabelsNodesLabel = Schema.Struc
340
/** Identifies the label name. */
341
name: Schema.String,
342
/** Identifies the label color. */
343
- color: Schema.String
343
+ color: Schema.String,
344
+ /** A brief description of this label. */
345
+ description: Schema.NullOr(Schema.String)
346
})
347
export interface PullRequestCoreRepositoryPullRequestLabelsNodesLabel extends Schema.Struct.Type<typeof PullRequestCoreRepositoryPullRequestLabelsNodesLabel.fields> {}
348
@@ -503,7 +505,7 @@ export const PullRequestCore = GraphQL.query("PullRequestCore", {
505
{ name: "requestedReviewers", body: "Int!" }
506
],
507
selections: [
506
- { name: "repository", body: ["(owner:$", "owner", " name:$", "name", "){mergeCommitAllowed squashMergeAllowed rebaseMergeAllowed autoMergeAllowed viewerPermission pullRequest(number:$", "number", "){number title url body state isDraft mergeable mergeStateStatus reviewDecision additions deletions changedFiles createdAt updatedAt mergedAt closedAt headRefName baseRefName headRefOid isCrossRepository maintainerCanModify headRepositoryOwner{__typename login}headRepository{nameWithOwner viewerPermission}headRef{id}author{__typename login avatarUrl...on User{id name}}autoMergeRequest{mergeMethod}viewerCanUpdate viewerDidAuthor viewerCanUpdateBranch baseRef{compare(headRef:$", "headRef", "){behindBy}}reviewRequests(first:$", "requestedReviewers", "){nodes{requestedReviewer{__typename...on User{login name}...on Bot{login}...on Team{slug combinedSlug teamName:name teamAvatarUrl:avatarUrl}}}}labels(first:100){nodes{name color}}commits(last:1){nodes{commit{statusCheckRollup{contexts(first:100){nodes{__typename...", "CheckContext", "}pageInfo{hasNextPage endCursor}}}}}}}}"] }
508
+ { name: "repository", body: ["(owner:$", "owner", " name:$", "name", "){mergeCommitAllowed squashMergeAllowed rebaseMergeAllowed autoMergeAllowed viewerPermission pullRequest(number:$", "number", "){number title url body state isDraft mergeable mergeStateStatus reviewDecision additions deletions changedFiles createdAt updatedAt mergedAt closedAt headRefName baseRefName headRefOid isCrossRepository maintainerCanModify headRepositoryOwner{__typename login}headRepository{nameWithOwner viewerPermission}headRef{id}author{__typename login avatarUrl...on User{id name}}autoMergeRequest{mergeMethod}viewerCanUpdate viewerDidAuthor viewerCanUpdateBranch baseRef{compare(headRef:$", "headRef", "){behindBy}}reviewRequests(first:$", "requestedReviewers", "){nodes{requestedReviewer{__typename...on User{login name}...on Bot{login}...on Team{slug combinedSlug teamName:name teamAvatarUrl:avatarUrl}}}}labels(first:100){nodes{name color description}}commits(last:1){nodes{commit{statusCheckRollup{contexts(first:100){nodes{__typename...", "CheckContext", "}pageInfo{hasNextPage endCursor}}}}}}}}"] }
509
],
510
fragments: [
511
{ name: "CheckContext", body: ["on StatusCheckRollupContext{__typename...on StatusContext{context state targetUrl createdAt description isRequired(pullRequestNumber:$", "number", ")@include(if:$", "required", ")}...on CheckRun{name status conclusion startedAt completedAt detailsUrl isRequired(pullRequestNumber:$", "number", ")@include(if:$", "required", ")checkSuite{workflowRun{workflow{name}}}}}"] }
@@ -1227,23 +1229,12 @@ export declare namespace ReviewerCandidates {
1229
export type Result = typeof ReviewerCandidates.result.Type
1230
}
1231
1230
-/** A label for categorizing Issues, Pull Requests, Milestones, or Discussions with a given Repository. */
1231
-export const RepositoryLabelsNodesLabel = Schema.Struct({
1232
- /** Identifies the label name. */
1233
- name: Schema.String,
1234
- /** Identifies the label color. */
1235
- color: Schema.String,
1236
- /** A brief description of this label. */
1237
- description: Schema.NullOr(Schema.String)
1238
-})
1239
-export interface RepositoryLabelsNodesLabel extends Schema.Struct.Type<typeof RepositoryLabelsNodesLabel.fields> {}
1240
-
1232
/** The connection type for Label. */
1233
export const LabelCandidatesRepositoryLabelsLabelConnection = Schema.Struct({
1234
/** Information to aid in pagination. */
1235
pageInfo: AssignableUsersPageInfoPageInfo,
1236
/** A list of nodes. */
1246
- nodes: Schema.NullOr(Schema.Array(Schema.NullOr(RepositoryLabelsNodesLabel)))
1237
+ nodes: Schema.NullOr(Schema.Array(Schema.NullOr(PullRequestCoreRepositoryPullRequestLabelsNodesLabel)))
1238
})
1239
export interface LabelCandidatesRepositoryLabelsLabelConnection extends Schema.Struct.Type<typeof LabelCandidatesRepositoryLabelsLabelConnection.fields> {}
1240
@@ -1305,12 +1296,21 @@ export declare namespace LabelCandidates {
1296
export type Result = typeof LabelCandidates.result.Type
1297
}
1298
1299
+/** A label for categorizing Issues, Pull Requests, Milestones, or Discussions with a given Repository. */
1300
+export const RepositoryLabelsNodesLabel = Schema.Struct({
1301
+ /** Identifies the label name. */
1302
+ name: Schema.String,
1303
+ /** Identifies the label color. */
1304
+ color: Schema.String
1305
+})
1306
+export interface RepositoryLabelsNodesLabel extends Schema.Struct.Type<typeof RepositoryLabelsNodesLabel.fields> {}
1307
+
1308
/** The connection type for Label. */
1309
export const RepositoryLabelsRepositoryLabelsLabelConnection = Schema.Struct({
1310
/** Information to aid in pagination. */
1311
pageInfo: AssignableUsersPageInfoPageInfo,
1312
/** A list of nodes. */
1313
- nodes: Schema.NullOr(Schema.Array(Schema.NullOr(PullRequestCoreRepositoryPullRequestLabelsNodesLabel)))
1313
+ nodes: Schema.NullOr(Schema.Array(Schema.NullOr(RepositoryLabelsNodesLabel)))
1314
})
1315
export interface RepositoryLabelsRepositoryLabelsLabelConnection extends Schema.Struct.Type<typeof RepositoryLabelsRepositoryLabelsLabelConnection.fields> {}
1316