The best way to control Claude Code, Codex and more from any computer or phone
| 1 | import { resolveEnvironmentMachineKind } from "@t3tools/contracts"; |
| 2 | import { fileBasename } from "@t3tools/shared/path"; |
| 3 | import { useLocation } from "@tanstack/react-router"; |
| 4 | import { CheckIcon, ChevronDownIcon, FolderIcon, LayersIcon } from "lucide-react"; |
| 5 | import { Fragment, useState, type ReactNode } from "react"; |
| 6 | import { T, useGT, useMessages, Var } from "gt-react"; |
| 7 | |
| 8 | import type { SidebarProjectSnapshot } from "../../sidebarProjectGrouping"; |
| 9 | import { useEnvironments, type EnvironmentPresentation } from "../../state/environments"; |
| 10 | import { EnvironmentMachineIcon } from "../EnvironmentMachineIcon"; |
| 11 | import { ProjectFavicon } from "../ProjectFavicon"; |
| 12 | import { Button } from "../ui/button"; |
| 13 | import { |
| 14 | Combobox, |
| 15 | ComboboxEmpty, |
| 16 | ComboboxItem, |
| 17 | ComboboxList, |
| 18 | ComboboxPopup, |
| 19 | ComboboxSearchInput, |
| 20 | ComboboxTrigger, |
| 21 | } from "../ui/combobox"; |
| 22 | import { |
| 23 | Menu, |
| 24 | MenuPopup, |
| 25 | MenuRadioGroup, |
| 26 | MenuRadioItem, |
| 27 | MenuRadioItemIndicator, |
| 28 | MenuSeparator, |
| 29 | MenuTrigger, |
| 30 | } from "../ui/menu"; |
| 31 | import { useOptionalSettingsScope } from "./SettingsScopeContext"; |
| 32 | import { resolveSettingsScope, type SettingsScopeSearch } from "./settingsScope"; |
| 33 | import { |
| 34 | ALL_CHECKOUTS_VALUE, |
| 35 | ALL_ENVIRONMENTS_VALUE, |
| 36 | ALL_PROJECTS_VALUE, |
| 37 | environmentAxisValue, |
| 38 | projectAxisValue, |
| 39 | projectScopeMenuGroups, |
| 40 | selectCheckoutAxis, |
| 41 | selectEnvironmentAxis, |
| 42 | selectProjectAxis, |
| 43 | settingsScopeCheckoutChoices, |
| 44 | settingsScopeCheckoutLabel, |
| 45 | settingsScopeEnvironmentAddress, |
| 46 | settingsScopeEnvironmentLabel, |
| 47 | settingsScopeEnvironmentLabels, |
| 48 | settingsScopeProjectMachines, |
| 49 | } from "./settingsScopeAxis"; |
| 50 | |
| 51 | export const SETTINGS_DEVICE_ONLY_PATHS: ReadonlySet<string> = new Set([ |
| 52 | "/settings/general", |
| 53 | "/settings/appearance", |
| 54 | "/settings/chat", |
| 55 | "/settings/diffs", |
| 56 | "/settings/snap-shot", |
| 57 | "/settings/connections", |
| 58 | // Access picks its environment on the page itself. |
| 59 | "/settings/access", |
| 60 | "/settings/about", |
| 61 | ]); |
| 62 | |
| 63 | interface SettingsScopeMenuProps { |
| 64 | readonly value: SettingsScopeSearch; |
| 65 | readonly groups: readonly SidebarProjectSnapshot[]; |
| 66 | readonly environments: readonly EnvironmentPresentation[]; |
| 67 | readonly singleEnvironment: boolean; |
| 68 | readonly onChange: (next: SettingsScopeSearch) => void; |
| 69 | } |
| 70 | |
| 71 | export function SettingsScopeSentence() { |
| 72 | const scope = useOptionalSettingsScope(); |
| 73 | const pathname = useLocation({ select: (location) => location.pathname }); |
| 74 | const { environments } = useEnvironments(); |
| 75 | if (scope === null || SETTINGS_DEVICE_ONLY_PATHS.has(pathname)) return null; |
| 76 | const props: SettingsScopeMenuProps = { |
| 77 | value: scope.search, |
| 78 | singleEnvironment: scope.singleEnvironment, |
| 79 | groups: scope.groups, |
| 80 | environments, |
| 81 | onChange: scope.selectScope, |
| 82 | }; |
| 83 | const group = scope.groups.find((candidate) => candidate.projectKey === scope.search.project); |
| 84 | const hasCheckouts = group ? settingsScopeCheckoutChoices(group, scope.search).length > 0 : false; |
| 85 | const project = <ProjectScopeMenu {...props} />; |
| 86 | const environment = <EnvironmentScopeMenu {...props} />; |
| 87 | const checkout = <CheckoutScopeMenu {...props} />; |
| 88 | const onEnvironment = scope.search.machine || scope.scope.kind === "checkout"; |
| 89 | return ( |
| 90 | <p className="flex min-w-0 flex-wrap items-center gap-x-1.5 gap-y-1 px-3 text-sm text-muted-foreground sm:px-4"> |
| 91 | {onEnvironment && hasCheckouts ? ( |
| 92 | <T context="settings scope sentence; each variable is a menu"> |
| 93 | <span className="flex min-w-0 items-center gap-1.5"> |
| 94 | <span className="shrink-0">Applying settings for</span> |
| 95 | <Var>{project}</Var> |
| 96 | </span> |
| 97 | <span className="flex min-w-0 items-center gap-1.5"> |
| 98 | <span className="shrink-0">on</span> |
| 99 | <Var>{environment}</Var> |
| 100 | </span> |
| 101 | <span className="flex min-w-0 items-center gap-1.5"> |
| 102 | <span className="shrink-0">in</span> |
| 103 | <Var>{checkout}</Var> |
| 104 | </span> |
| 105 | </T> |
| 106 | ) : onEnvironment ? ( |
| 107 | <T context="settings scope sentence; each variable is a menu"> |
| 108 | <span className="flex min-w-0 items-center gap-1.5"> |
| 109 | <span className="shrink-0">Applying settings for</span> |
| 110 | <Var>{project}</Var> |
| 111 | </span> |
| 112 | <span className="flex min-w-0 items-center gap-1.5"> |
| 113 | <span className="shrink-0">on</span> |
| 114 | <Var>{environment}</Var> |
| 115 | </span> |
| 116 | </T> |
| 117 | ) : hasCheckouts ? ( |
| 118 | <T context="settings scope sentence; each variable is a menu"> |
| 119 | <span className="flex min-w-0 items-center gap-1.5"> |
| 120 | <span className="shrink-0">Applying settings for</span> |
| 121 | <Var>{project}</Var> |
| 122 | </span> |
| 123 | <span className="flex min-w-0 items-center gap-1.5"> |
| 124 | <span className="shrink-0">across</span> |
| 125 | <Var>{environment}</Var> |
| 126 | </span> |
| 127 | <span className="flex min-w-0 items-center gap-1.5"> |
| 128 | <span className="shrink-0">in</span> |
| 129 | <Var>{checkout}</Var> |
| 130 | </span> |
| 131 | </T> |
| 132 | ) : ( |
| 133 | <T context="settings scope sentence; each variable is a menu"> |
| 134 | <span className="flex min-w-0 items-center gap-1.5"> |
| 135 | <span className="shrink-0">Applying settings for</span> |
| 136 | <Var>{project}</Var> |
| 137 | </span> |
| 138 | <span className="flex min-w-0 items-center gap-1.5"> |
| 139 | <span className="shrink-0">across</span> |
| 140 | <Var>{environment}</Var> |
| 141 | </span> |
| 142 | </T> |
| 143 | )} |
| 144 | </p> |
| 145 | ); |
| 146 | } |
| 147 | |
| 148 | interface ScopeOption { |
| 149 | value: string; |
| 150 | label: string; |
| 151 | secondary?: string; |
| 152 | icon?: ReactNode; |
| 153 | offline?: boolean; |
| 154 | } |
| 155 | |
| 156 | function ScopeOptionLabel({ option }: { option: ScopeOption }) { |
| 157 | return ( |
| 158 | <> |
| 159 | {option.icon} |
| 160 | <span className="min-w-0 flex-1"> |
| 161 | <span className="block truncate">{option.label}</span> |
| 162 | {option.secondary ? ( |
| 163 | <span className="block truncate text-xs text-muted-foreground">{option.secondary}</span> |
| 164 | ) : null} |
| 165 | </span> |
| 166 | {option.offline ? ( |
| 167 | <span className="shrink-0 text-xs text-muted-foreground"> |
| 168 | <T>Offline</T> |
| 169 | </span> |
| 170 | ) : null} |
| 171 | </> |
| 172 | ); |
| 173 | } |
| 174 | |
| 175 | function ScopeMenu({ |
| 176 | ariaLabel, |
| 177 | icon, |
| 178 | label, |
| 179 | value, |
| 180 | options, |
| 181 | allOption, |
| 182 | searchLabel, |
| 183 | onChange, |
| 184 | }: { |
| 185 | ariaLabel: string; |
| 186 | icon: ReactNode; |
| 187 | label: string; |
| 188 | value: string; |
| 189 | options: ScopeOption[]; |
| 190 | allOption: ScopeOption | null; |
| 191 | searchLabel: string; |
| 192 | onChange: (next: string) => void; |
| 193 | }) { |
| 194 | const [query, setQuery] = useState(""); |
| 195 | const Trigger = options.length > 6 ? ComboboxTrigger : MenuTrigger; |
| 196 | const trigger = ( |
| 197 | <Trigger |
| 198 | aria-label={`${ariaLabel}: ${label}`} |
| 199 | render={<Button variant="outline" size="sm" />} |
| 200 | className="min-w-0 max-w-72" |
| 201 | > |
| 202 | {icon} |
| 203 | <span className="min-w-0 truncate">{label}</span> |
| 204 | <ChevronDownIcon |
| 205 | aria-hidden |
| 206 | strokeWidth={1.75} |
| 207 | className="-me-0.5 size-3.5 shrink-0 text-muted-foreground opacity-70" |
| 208 | /> |
| 209 | </Trigger> |
| 210 | ); |
| 211 | const choices = allOption ? [allOption, ...options] : options; |
| 212 | if (options.length > 6) { |
| 213 | const needle = query.trim().toLowerCase(); |
| 214 | const filteredItems = choices.filter((option) => |
| 215 | `${option.label} ${option.secondary ?? ""} ${option.value}`.toLowerCase().includes(needle), |
| 216 | ); |
| 217 | return ( |
| 218 | <Combobox |
| 219 | items={choices} |
| 220 | filteredItems={filteredItems} |
| 221 | filter={null} |
| 222 | autoHighlight |
| 223 | itemToStringLabel={(option) => option.label} |
| 224 | isItemEqualToValue={(a, b) => a.value === b.value} |
| 225 | value={choices.find((option) => option.value === value) ?? null} |
| 226 | onOpenChange={(open) => { |
| 227 | if (!open) setQuery(""); |
| 228 | }} |
| 229 | onValueChange={(option) => { |
| 230 | if (option) onChange(option.value); |
| 231 | }} |
| 232 | > |
| 233 | {trigger} |
| 234 | <ComboboxPopup align="start" className="w-80"> |
| 235 | <ComboboxSearchInput |
| 236 | aria-label={searchLabel} |
| 237 | placeholder={searchLabel} |
| 238 | value={query} |
| 239 | onChange={(event) => setQuery(event.target.value)} |
| 240 | /> |
| 241 | <ComboboxEmpty> |
| 242 | <T>No matches found.</T> |
| 243 | </ComboboxEmpty> |
| 244 | <ComboboxList> |
| 245 | {(option: ScopeOption) => ( |
| 246 | <ComboboxItem key={option.value} value={option}> |
| 247 | <ScopeOptionLabel option={option} /> |
| 248 | {option.value === value ? ( |
| 249 | <CheckIcon aria-hidden className="size-3.5 shrink-0" /> |
| 250 | ) : null} |
| 251 | </ComboboxItem> |
| 252 | )} |
| 253 | </ComboboxList> |
| 254 | </ComboboxPopup> |
| 255 | </Combobox> |
| 256 | ); |
| 257 | } |
| 258 | return ( |
| 259 | <Menu> |
| 260 | {trigger} |
| 261 | <MenuPopup align="start"> |
| 262 | <div className="w-72 max-w-full"> |
| 263 | <MenuRadioGroup |
| 264 | value={value} |
| 265 | onValueChange={(next) => { |
| 266 | if (typeof next === "string") onChange(next); |
| 267 | }} |
| 268 | > |
| 269 | {choices.map((option, index) => ( |
| 270 | <Fragment key={option.value}> |
| 271 | <MenuRadioItem value={option.value} closeOnClick> |
| 272 | <span className="flex min-w-0 items-center gap-2"> |
| 273 | <ScopeOptionLabel option={option} /> |
| 274 | <MenuRadioItemIndicator /> |
| 275 | </span> |
| 276 | </MenuRadioItem> |
| 277 | {index === 0 && allOption ? <MenuSeparator /> : null} |
| 278 | </Fragment> |
| 279 | ))} |
| 280 | </MenuRadioGroup> |
| 281 | </div> |
| 282 | </MenuPopup> |
| 283 | </Menu> |
| 284 | ); |
| 285 | } |
| 286 | |
| 287 | function EnvironmentScopeMenu({ |
| 288 | value, |
| 289 | groups, |
| 290 | environments, |
| 291 | onChange, |
| 292 | singleEnvironment, |
| 293 | }: SettingsScopeMenuProps) { |
| 294 | const messages = useMessages(); |
| 295 | const gt = useGT(); |
| 296 | const resolved = resolveSettingsScope(value, groups, environments, messages); |
| 297 | const environmentValue = environmentAxisValue( |
| 298 | value, |
| 299 | resolved.kind === "checkout" ? resolved.environmentId : null, |
| 300 | ); |
| 301 | const selected = environments.find( |
| 302 | (environment) => environment.environmentId === environmentValue, |
| 303 | ); |
| 304 | const project = groups.find((group) => group.projectKey === value.project); |
| 305 | const memberEnvironmentIds = project |
| 306 | ? new Set(project.memberProjects.map((member) => member.environmentId)) |
| 307 | : null; |
| 308 | const options = memberEnvironmentIds |
| 309 | ? environments.filter((environment) => memberEnvironmentIds.has(environment.environmentId)) |
| 310 | : environments; |
| 311 | return ( |
| 312 | <ScopeMenu |
| 313 | ariaLabel={gt("Environment scope")} |
| 314 | icon={ |
| 315 | selected ? ( |
| 316 | <EnvironmentMachineIcon |
| 317 | aria-hidden |
| 318 | kind={resolveEnvironmentMachineKind(selected.serverConfig)} |
| 319 | className="size-3.5 shrink-0" |
| 320 | /> |
| 321 | ) : null |
| 322 | } |
| 323 | label={ |
| 324 | selected |
| 325 | ? settingsScopeEnvironmentLabel(selected, environments) |
| 326 | : environmentValue !== ALL_ENVIRONMENTS_VALUE |
| 327 | ? gt("Unavailable environment") |
| 328 | : singleEnvironment |
| 329 | ? gt("No environments") |
| 330 | : gt("All environments") |
| 331 | } |
| 332 | value={environmentValue} |
| 333 | onChange={(next) => onChange(selectEnvironmentAxis(value, next))} |
| 334 | searchLabel={gt("Search environments")} |
| 335 | allOption={ |
| 336 | singleEnvironment |
| 337 | ? null |
| 338 | : { |
| 339 | value: ALL_ENVIRONMENTS_VALUE, |
| 340 | label: gt("All environments"), |
| 341 | icon: <LayersIcon aria-hidden className="size-3.5 shrink-0" />, |
| 342 | } |
| 343 | } |
| 344 | options={options.map((environment) => { |
| 345 | const { primary, secondary } = settingsScopeEnvironmentLabels(environment, environments); |
| 346 | return { |
| 347 | value: environment.environmentId, |
| 348 | label: primary, |
| 349 | secondary: |
| 350 | environments.length <= 1 |
| 351 | ? "" |
| 352 | : secondary || settingsScopeEnvironmentAddress(environment), |
| 353 | icon: ( |
| 354 | <EnvironmentMachineIcon |
| 355 | aria-hidden |
| 356 | kind={resolveEnvironmentMachineKind(environment.serverConfig)} |
| 357 | className="size-3.5 shrink-0" |
| 358 | /> |
| 359 | ), |
| 360 | offline: environment.connection.phase !== "connected", |
| 361 | }; |
| 362 | })} |
| 363 | /> |
| 364 | ); |
| 365 | } |
| 366 | |
| 367 | function CheckoutScopeMenu({ value, groups, onChange }: SettingsScopeMenuProps) { |
| 368 | const gt = useGT(); |
| 369 | const group = groups.find((candidate) => candidate.projectKey === value.project); |
| 370 | const checkouts = group ? settingsScopeCheckoutChoices(group, value) : []; |
| 371 | if (checkouts.length === 0) return null; |
| 372 | const selected = checkouts.find((member) => member.physicalProjectKey === value.checkout); |
| 373 | return ( |
| 374 | <ScopeMenu |
| 375 | ariaLabel={gt("Checkout scope")} |
| 376 | icon={<FolderIcon aria-hidden className="size-3.5 shrink-0" />} |
| 377 | label={ |
| 378 | selected |
| 379 | ? settingsScopeCheckoutLabel(selected, checkouts) |
| 380 | : value.checkout |
| 381 | ? gt("Unavailable checkout") |
| 382 | : gt("All checkouts") |
| 383 | } |
| 384 | value={value.checkout ?? ALL_CHECKOUTS_VALUE} |
| 385 | onChange={(next) => |
| 386 | onChange( |
| 387 | selectCheckoutAxis( |
| 388 | value, |
| 389 | checkouts.find((member) => member.physicalProjectKey === next) ?? null, |
| 390 | ), |
| 391 | ) |
| 392 | } |
| 393 | searchLabel={gt("Search checkouts")} |
| 394 | allOption={{ value: ALL_CHECKOUTS_VALUE, label: gt("All checkouts") }} |
| 395 | options={checkouts.map((member) => ({ |
| 396 | value: member.physicalProjectKey, |
| 397 | label: fileBasename(member.workspaceRoot), |
| 398 | secondary: member.workspaceRoot, |
| 399 | }))} |
| 400 | /> |
| 401 | ); |
| 402 | } |
| 403 | |
| 404 | function ProjectScopeMenu({ value, groups, environments, onChange }: SettingsScopeMenuProps) { |
| 405 | const gt = useGT(); |
| 406 | const selected = groups.find((group) => group.projectKey === value.project); |
| 407 | const projects = projectScopeMenuGroups(groups, value).map((group) => ({ |
| 408 | group, |
| 409 | machines: settingsScopeProjectMachines(group, environments, true).join(", "), |
| 410 | })); |
| 411 | return ( |
| 412 | <ScopeMenu |
| 413 | ariaLabel={gt("Project scope")} |
| 414 | icon={selected ? <ProjectFavicon project={selected} className="size-3.5 shrink-0" /> : null} |
| 415 | label={ |
| 416 | selected?.displayName ?? (value.project ? gt("Unavailable project") : gt("All projects")) |
| 417 | } |
| 418 | value={projectAxisValue(value)} |
| 419 | onChange={(next) => onChange(selectProjectAxis(value, next))} |
| 420 | searchLabel={gt("Search projects")} |
| 421 | allOption={{ value: ALL_PROJECTS_VALUE, label: gt("All projects") }} |
| 422 | options={projects.map(({ group, machines }) => { |
| 423 | const sameName = projects.filter( |
| 424 | (other) => |
| 425 | other.group.projectKey !== group.projectKey && |
| 426 | other.group.displayName === group.displayName, |
| 427 | ); |
| 428 | const location = |
| 429 | sameName.length === 0 |
| 430 | ? environments.length > 1 |
| 431 | ? group.workspaceRoot |
| 432 | : "" |
| 433 | : sameName.some((other) => other.machines === machines) |
| 434 | ? `${machines} · ${group.workspaceRoot}` |
| 435 | : machines; |
| 436 | return { |
| 437 | value: group.projectKey, |
| 438 | label: group.displayName, |
| 439 | secondary: group.archived |
| 440 | ? [gt("Archived", { $context: "project state" }), location].filter(Boolean).join(" · ") |
| 441 | : location, |
| 442 | icon: <ProjectFavicon project={group} className="size-3.5 shrink-0" />, |
| 443 | }; |
| 444 | })} |
| 445 | /> |
| 446 | ); |
| 447 | } |