@devries-cameron20 / t3code Mirror · read-only
Fork 0

The best way to control Claude Code, Codex and more from any computer or phone

Mirrored from https://github.com/Camo67/t3code.git

Synced Nov 21, 04:45 UTC

main
ts 214 lines 7.12 KB
Raw
1 import {
2 sourceControlClients,
3 type ChangeRequestTerminology,
4 } from "@t3tools/client-runtime/source-control-clients";
5 import type {
6 PullRequestAction,
7 PullRequestDetail,
8 PullRequestMergeMethod,
9 SourceControlProviderKind,
10 } from "@t3tools/contracts";
11 import { msg } from "gt-react-native";
12
13 import type { AppSymbolName } from "../../components/ui/AppSymbol";
14 import { m, type MessageResolver } from "../../i18n/messages";
15 import { changeRequestTermKind } from "../../lib/changeRequestTerm";
16 import { PullRequestGlyph } from "./pullRequestGlyphs";
17
18 type ActionDetail = Pick<
19 PullRequestDetail,
20 "state" | "isDraft" | "mergeability" | "autoMergeEnabled" | "workflowApprovalsRequired"
21 > & {
22 readonly capabilities: Pick<
23 PullRequestDetail["capabilities"],
24 "actions" | "mergeMethods" | "updateMethods" | "deleteBranch"
25 >;
26 readonly viewerPermissions: Pick<
27 PullRequestDetail["viewerPermissions"],
28 "actions" | "updateMethods"
29 >;
30 readonly mergeCapabilities: PullRequestDetail["mergeCapabilities"];
31 };
32
33 export const MERGE_METHODS = {
34 squash: {
35 title: msg("Squash and merge"),
36 description: msg("Combine the commits into one commit."),
37 },
38 merge: {
39 title: msg("Create a merge commit"),
40 description: msg("Keep the commits and add a merge commit."),
41 },
42 rebase: {
43 title: msg("Rebase and merge"),
44 description: msg("Add the commits without a merge commit."),
45 },
46 "fast-forward": {
47 title: msg("Fast-forward merge"),
48 description: msg("Add the commits as they are. Needs the branch to contain the base."),
49 },
50 } as const satisfies Record<PullRequestMergeMethod, { title: string; description: string }>;
51
52 /** Select key for a merge method in translated sentences; ICU keys cannot contain "-". */
53 export function mergeMethodKind(method: PullRequestMergeMethod | undefined) {
54 return method === "fast-forward" ? "fastForward" : (method ?? "other");
55 }
56
57 export function pullRequestActionLabel(
58 action: PullRequestAction,
59 terminology: ChangeRequestTerminology,
60 resolve: MessageResolver = m,
61 ): string {
62 const term = changeRequestTermKind(terminology);
63 switch (action) {
64 case "merge":
65 return resolve(
66 msg("Merge {term, select, mr {merge request} cr {change request} other {pull request}}", {
67 term,
68 }),
69 );
70 case "ready":
71 return resolve(msg("Mark ready for review"));
72 case "draft":
73 return resolve(msg("Convert to draft"));
74 case "close":
75 return resolve(
76 msg("Close {term, select, mr {merge request} cr {change request} other {pull request}}", {
77 term,
78 }),
79 );
80 case "reopen":
81 return resolve(
82 msg("Reopen {term, select, mr {merge request} cr {change request} other {pull request}}", {
83 term,
84 }),
85 );
86 case "update-branch":
87 return resolve(msg("Update branch"));
88 case "enable-auto-merge":
89 return resolve(msg("Enable auto-merge"));
90 case "disable-auto-merge":
91 return resolve(msg("Disable auto-merge"));
92 case "revert":
93 return resolve(
94 msg(
95 "Create revert {term, select, mr {merge request} cr {change request} other {pull request}}",
96 { term },
97 ),
98 );
99 case "delete-branch":
100 return resolve(msg("Delete branch"));
101 case "approve-workflows":
102 return resolve(msg("Approve workflows"));
103 }
104 }
105
106 export const PR_ACTION_ICONS = {
107 merge: PullRequestGlyph.merged,
108 ready: "checkmark.circle",
109 draft: "pencil",
110 close: "xmark",
111 reopen: "arrow.clockwise",
112 "update-branch": "arrow.up.circle",
113 "enable-auto-merge": "clock",
114 "disable-auto-merge": "xmark",
115 revert: "arrow.uturn.backward",
116 "delete-branch": "trash",
117 "approve-workflows": "checkmark",
118 } as const satisfies Record<PullRequestAction, AppSymbolName>;
119
120 export function allowedMergeMethods(pr: ActionDetail) {
121 return pr.capabilities.mergeMethods.filter((method) => pr.mergeCapabilities[method]);
122 }
123
124 export function resolveMergeMethod(
125 pr: ActionDetail,
126 selected: PullRequestMergeMethod | null,
127 projectDefault: PullRequestMergeMethod | null,
128 lastUsed: PullRequestMergeMethod | undefined,
129 ) {
130 const methods = allowedMergeMethods(pr);
131 return (
132 [selected, projectDefault, lastUsed, "squash" as const].find(
133 (method) => method != null && methods.includes(method),
134 ) ?? methods[0]
135 );
136 }
137
138 export function allowedUpdateMethods(pr: ActionDetail) {
139 return (pr.capabilities.updateMethods ?? []).filter((method) =>
140 pr.viewerPermissions.updateMethods?.includes(method),
141 );
142 }
143
144 export function canPerformPullRequestAction(pr: ActionDetail, action: PullRequestAction) {
145 if (!pr.capabilities.actions.includes(action) || !pr.viewerPermissions.actions.includes(action))
146 return false;
147 if (action === "reopen") return pr.state === "closed";
148 if (action === "revert") return pr.state === "merged";
149 if (action === "delete-branch")
150 return pr.state !== "open" && pr.capabilities.deleteBranch === true;
151 if (pr.state !== "open") return false;
152 switch (action) {
153 case "update-branch":
154 return allowedUpdateMethods(pr).length > 0;
155 case "approve-workflows":
156 return (pr.workflowApprovalsRequired ?? 0) > 0;
157 case "ready":
158 return pr.isDraft;
159 case "draft":
160 return !pr.isDraft;
161 case "merge":
162 return !pr.isDraft && pr.mergeability !== "conflicting" && allowedMergeMethods(pr).length > 0;
163 case "enable-auto-merge":
164 return !pr.isDraft && pr.autoMergeEnabled === false && allowedMergeMethods(pr).length > 0;
165 case "disable-auto-merge":
166 return pr.autoMergeEnabled === true;
167 default:
168 return true;
169 }
170 }
171
172 export function mergeUnavailableReason(
173 pr: ActionDetail,
174 connectionAllowsWrites: boolean,
175 terminology: ChangeRequestTerminology,
176 resolve: MessageResolver = m,
177 ) {
178 const term = changeRequestTermKind(terminology);
179 if (pr.state === "merged")
180 return resolve(
181 msg(
182 "This {term, select, mr {merge request} cr {change request} other {pull request}} has been merged.",
183 { term },
184 ),
185 );
186 if (pr.state === "closed")
187 return resolve(
188 msg(
189 "Reopen this {term, select, mr {merge request} cr {change request} other {pull request}} before merging.",
190 { term },
191 ),
192 );
193 if (!connectionAllowsWrites) return resolve(msg("This environment connection is read-only."));
194 if (!pr.capabilities.actions.includes("merge"))
195 return resolve(msg("This provider does not support merging here."));
196 if (!pr.viewerPermissions.actions.includes("merge"))
197 return resolve(
198 msg(
199 "Your account cannot merge this {term, select, mr {merge request} cr {change request} other {pull request}}.",
200 { term },
201 ),
202 );
203 if (pr.isDraft) return resolve(msg("Mark this draft ready for review before merging."));
204 if (pr.mergeability === "conflicting")
205 return resolve(msg("Resolve the branch conflicts before merging."));
206 if (!allowedMergeMethods(pr).length)
207 return resolve(msg("This repository has no available merge methods."));
208 return null;
209 }
210
211 export const openOnProviderLabel = (
212 provider: SourceControlProviderKind,
213 resolve: MessageResolver = m,
214 ) => resolve(msg("Open on {provider}", { provider: sourceControlClients.get(provider).label }));