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

main
tsx 443 lines 16.2 KB
Raw
1 import {
2 lazy,
3 Suspense,
4 useEffect,
5 useRef,
6 useState,
7 type ComponentType,
8 type KeyboardEvent,
9 } from "react";
10 import {
11 ArchiveIcon,
12 FlaskConicalIcon,
13 BotIcon,
14 createLucideIcon,
15 CalendarClockIcon,
16 FileDiffIcon,
17 FolderTreeIcon,
18 GitBranchIcon,
19 GlobeIcon,
20 InfoIcon,
21 MessageSquareTextIcon,
22 MessagesSquareIcon,
23 PanelsTopLeftIcon,
24 KeyboardIcon,
25 KeyRoundIcon,
26 MicIcon,
27 PaletteIcon,
28 SearchIcon,
29 ServerIcon,
30 Settings2Icon,
31 ShieldCheckIcon,
32 SmartphoneIcon,
33 WrenchIcon,
34 XIcon,
35 } from "lucide-react";
36 import { resolveEventKeys } from "@t3tools/shared/keybindings";
37 import { useLocation, useNavigate } from "@tanstack/react-router";
38 import { T, useGT, useMessages } from "gt-react";
39
40 import { cn } from "../../lib/utils";
41 import { Button } from "../ui/button";
42 import { Kbd } from "../ui/kbd";
43 import {
44 SidebarContent,
45 SidebarFooter,
46 SidebarGroup,
47 SidebarMenu,
48 SidebarMenuButton,
49 SidebarMenuItem,
50 SidebarInput,
51 } from "../ui/sidebar";
52 import { scrollToSettingsTarget } from "./settingsLayout";
53 import {
54 searchSettings,
55 revealSettingsSearchTarget,
56 SETTINGS_NAV_GROUPS,
57 SETTINGS_NAV_LABELS,
58 SETTINGS_SECTION_LABELS,
59 type SettingsPath,
60 type SettingsSearchItem,
61 } from "./settingsSearch";
62 import { useAvailableSettingsSearchItems } from "./useAvailableSettingsSearchItems";
63 import { handleSettingsSectionKeyDown } from "./settingsSectionNavigation";
64 import { workspaceAreaProps } from "../../lib/workspaceFocus";
65
66 const SnapShotIcon = createLucideIcon("snap-shot", [
67 [
68 "path",
69 {
70 d: "M8 3H6a3 3 0 0 0-3 3v2M16 3h2a3 3 0 0 1 3 3v2M21 16v2a3 3 0 0 1-3 3h-2M8 21H6a3 3 0 0 1-3-3v-2",
71 key: "capture-frame",
72 },
73 ],
74 ["rect", { width: "10", height: "8", x: "7", y: "8", rx: "2", key: "window" }],
75 ["circle", { cx: "12", cy: "12", r: "1.5", key: "lens" }],
76 ]);
77
78 const T3ConnectSidebarSignIn = lazy(() =>
79 import("../clerk/T3ConnectSidebarSignIn").then((module) => ({
80 default: module.T3ConnectSidebarSignIn,
81 })),
82 );
83 const T3ConnectSidebarAvatar = lazy(() =>
84 import("../clerk/T3ConnectSidebarSignIn").then((module) => ({
85 default: module.T3ConnectSidebarAvatar,
86 })),
87 );
88
89 const SETTINGS_SECTION_ICONS: Readonly<
90 Record<SettingsPath, ComponentType<{ className?: string }>>
91 > = {
92 "/settings/general": Settings2Icon,
93 "/settings/diagnostics": WrenchIcon,
94 "/settings/voice": MicIcon,
95 "/settings/appearance": PaletteIcon,
96 "/settings/chat": MessageSquareTextIcon,
97 "/settings/diffs": FileDiffIcon,
98 "/settings/projects": PanelsTopLeftIcon,
99 "/settings/keybindings": KeyboardIcon,
100 "/settings/snap-shot": SnapShotIcon,
101 "/settings/providers": BotIcon,
102 "/settings/threads": MessagesSquareIcon,
103 "/settings/browser": GlobeIcon,
104 "/settings/devices": SmartphoneIcon,
105 "/settings/scheduled-tasks": CalendarClockIcon,
106 "/settings/source-control": GitBranchIcon,
107 "/settings/worktrees": FolderTreeIcon,
108 "/settings/connections": ServerIcon,
109 "/settings/access": ShieldCheckIcon,
110 "/settings/secrets": KeyRoundIcon,
111 "/settings/maintenance": WrenchIcon,
112 "/settings/labs": FlaskConicalIcon,
113 "/settings/about": InfoIcon,
114 "/settings/archived": ArchiveIcon,
115 };
116
117 // Detail pages without a nav entry highlight the page that links to them.
118 const SETTINGS_DETAIL_PAGE_PARENTS: Readonly<Record<string, SettingsPath>> = {
119 "/settings/diagnostics": "/settings/maintenance",
120 "/settings/open-source-licenses": "/settings/about",
121 };
122
123 // Attached only to the highlighted result, so it runs whenever the highlight lands on a row.
124 function scrollResultIntoView(row: HTMLElement | null) {
125 row?.scrollIntoView({ block: "nearest" });
126 }
127
128 function SettingsSectionIcon({ to }: { to: SettingsPath }) {
129 const Icon = SETTINGS_SECTION_ICONS[to];
130 return <Icon className="size-4 h-5 shrink-0 text-(--sidebar-icon-color)" />;
131 }
132
133 export function SettingsSidebarNav({ pathname }: { pathname: string }) {
134 const gt = useGT();
135 const m = useMessages();
136 const navArea = workspaceAreaProps("settings-nav", 0, gt("Settings sections"));
137 const navigate = useNavigate();
138 const currentHash = useLocation({ select: (location) => location.hash });
139 const activePath = SETTINGS_DETAIL_PAGE_PARENTS[pathname] ?? pathname;
140 const searchInputRef = useRef<HTMLInputElement>(null);
141 const [query, setQuery] = useState("");
142 // Below md the nav is an icon rail; searching expands it over the page.
143 const [compactSearchOpen, setCompactSearchOpen] = useState(false);
144 const [activeResultIndex, setActiveResultIndex] = useState(0);
145 const searchableItems = useAvailableSettingsSearchItems();
146 const results = searchSettings(query, searchableItems, m);
147 const isSearching = query.trim().length > 0;
148 const hasResults = results.length > 0;
149 const maxResultIndex = Math.max(results.length - 1, 0);
150 // Persist the clamp so a shrink-then-recover of results keeps the clamped highlight.
151 if (activeResultIndex > maxResultIndex) {
152 setActiveResultIndex(maxResultIndex);
153 }
154
155 // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- window keydown listener for the find and slash search shortcuts
156 useEffect(() => {
157 const handleKeyDown = (event: globalThis.KeyboardEvent) => {
158 if (event.defaultPrevented || event.isComposing) return;
159 const eventKeys = resolveEventKeys(event);
160 const isFindShortcut =
161 eventKeys.has("f") && (event.metaKey || event.ctrlKey) && !event.altKey && !event.shiftKey;
162 // Shift is allowed only when the layout types "/" with it (German Shift+7); Shift on
163 // the physical Slash key types "?" or "," instead.
164 const isSlashShortcut =
165 eventKeys.has("/") &&
166 (event.key === "/" || !event.shiftKey) &&
167 !event.metaKey &&
168 !event.ctrlKey &&
169 !event.altKey;
170 if (!isFindShortcut && !isSlashShortcut) return;
171
172 const target = event.target;
173 if (
174 target instanceof HTMLElement &&
175 ((isSlashShortcut &&
176 (target.tagName === "INPUT" ||
177 target.tagName === "TEXTAREA" ||
178 target.isContentEditable)) ||
179 target.closest(
180 '[role="dialog"]:not([data-app-modal]), [aria-modal="true"]:not([data-app-modal]), [data-slot$="popup"]:not([data-app-modal]), [data-keybinding-capture]',
181 ) !== null)
182 ) {
183 return;
184 }
185
186 event.preventDefault();
187 setCompactSearchOpen(true);
188 searchInputRef.current?.focus();
189 searchInputRef.current?.select();
190 };
191 window.addEventListener("keydown", handleKeyDown);
192 return () => window.removeEventListener("keydown", handleKeyDown);
193 }, []);
194
195 // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- focuses the search input DOM node after the compact search opens
196 useEffect(() => {
197 if (compactSearchOpen) searchInputRef.current?.focus();
198 }, [compactSearchOpen]);
199
200 const handleSectionClick = (to: SettingsPath) => {
201 void navigate({
202 to,
203 hash: "",
204 replace: true,
205 hashScrollIntoView: false,
206 });
207 };
208
209 const clearSearch = () => {
210 setQuery("");
211 setActiveResultIndex(0);
212 };
213 const handleSearchResultClick = (item: SettingsSearchItem) => {
214 clearSearch();
215 setCompactSearchOpen(false);
216 const targetId = item.targetId ?? item.id;
217 revealSettingsSearchTarget(targetId);
218 if (pathname === item.to && currentHash.replace(/^#/, "") === targetId) {
219 scrollToSettingsTarget(targetId);
220 return;
221 }
222 void navigate({
223 to: item.to,
224 hash: targetId,
225 replace: true,
226 hashScrollIntoView: false,
227 state: { settingsTargetHighlight: true },
228 });
229 };
230
231 const handleSearchKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {
232 if (event.nativeEvent.isComposing || event.keyCode === 229) return;
233 if (event.key === "Escape" && isSearching) {
234 event.preventDefault();
235 event.stopPropagation();
236 clearSearch();
237 return;
238 }
239 if (results.length === 0) return;
240 if (event.key === "ArrowDown") {
241 event.preventDefault();
242 setActiveResultIndex((activeResultIndex + 1) % results.length);
243 return;
244 }
245 if (event.key === "ArrowUp") {
246 event.preventDefault();
247 setActiveResultIndex((activeResultIndex - 1 + results.length) % results.length);
248 return;
249 }
250 if (event.key === "Enter") {
251 event.preventDefault();
252 const result = results[activeResultIndex];
253 if (result) handleSearchResultClick(result);
254 }
255 };
256
257 return (
258 <nav
259 {...navArea}
260 role="navigation"
261 className={cn(
262 "flex w-60 shrink-0 flex-col border-e bg-sidebar text-sidebar-foreground max-md:w-14",
263 compactSearchOpen &&
264 "max-md:absolute max-md:inset-y-0 max-md:start-0 max-md:z-10 max-md:w-full",
265 )}
266 >
267 <SidebarContent className="overflow-x-hidden">
268 <SidebarGroup>
269 <div className="flex flex-col gap-2">
270 <div
271 className={cn(
272 "flex h-8 items-center gap-2 rounded-md px-2 py-1.5 text-sm font-medium text-sidebar-muted-foreground hover:bg-sidebar-row-hover hover:text-sidebar-foreground",
273 !compactSearchOpen && "max-md:hidden",
274 )}
275 >
276 <SearchIcon className="size-4 shrink-0 text-sidebar-muted-foreground/80" />
277 {/* Native search inputs clear on Escape even during IME composition. */}
278 <SidebarInput
279 ref={searchInputRef}
280 nativeInput
281 type="text"
282 value={query}
283 onChange={(event) => {
284 setQuery(event.currentTarget.value);
285 setActiveResultIndex(0);
286 }}
287 onKeyDown={handleSearchKeyDown}
288 onFocus={() => setCompactSearchOpen(true)}
289 onBlur={() => {
290 if (!isSearching) setCompactSearchOpen(false);
291 }}
292 placeholder={gt("Search")}
293 aria-label={gt("Search settings")}
294 role="combobox"
295 aria-autocomplete="list"
296 aria-expanded={isSearching && hasResults}
297 aria-controls={isSearching && hasResults ? "settings-search-results" : undefined}
298 aria-activedescendant={
299 isSearching && results[activeResultIndex]
300 ? `settings-search-result-${results[activeResultIndex].id}`
301 : undefined
302 }
303 className="min-w-0 flex-1"
304 />
305 {isSearching ? (
306 <Button
307 type="button"
308 size="icon-micro"
309 variant="ghost-muted"
310 className="shrink-0"
311 aria-label={gt("Clear settings search")}
312 onClick={() => {
313 clearSearch();
314 searchInputRef.current?.focus();
315 }}
316 >
317 <XIcon className="size-3" />
318 </Button>
319 ) : (
320 <Kbd>/</Kbd>
321 )}
322 </div>
323 {isSearching && results.length === 0 ? (
324 <p
325 role="status"
326 className="px-2 py-6 text-center text-xs text-sidebar-muted-foreground"
327 >
328 <T>No settings found</T>
329 </p>
330 ) : null}
331 {isSearching ? (
332 <SidebarMenu
333 id={hasResults ? "settings-search-results" : undefined}
334 role={hasResults ? "listbox" : undefined}
335 aria-label={hasResults ? gt("Settings search results") : undefined}
336 >
337 {results.map((item, index) => (
338 <SidebarMenuItem
339 key={item.id}
340 role="presentation"
341 ref={index === activeResultIndex ? scrollResultIntoView : undefined}
342 >
343 <SidebarMenuButton
344 id={`settings-search-result-${item.id}`}
345 role="option"
346 aria-selected={index === activeResultIndex}
347 tabIndex={-1}
348 size="sm"
349 isActive={index === activeResultIndex}
350 className="h-auto min-h-10 items-start"
351 onMouseMove={() => setActiveResultIndex(index)}
352 onClick={() => handleSearchResultClick(item)}
353 >
354 <SettingsSectionIcon to={item.to} />
355 <span className="min-w-0 flex-1">
356 <span className="block truncate text-sm font-medium text-sidebar-foreground">
357 {m(item.title)}
358 </span>
359 <span className="block truncate text-2xs text-sidebar-muted-foreground/75">
360 {m(SETTINGS_SECTION_LABELS[item.to])}
361 </span>
362 </span>
363 </SidebarMenuButton>
364 </SidebarMenuItem>
365 ))}
366 </SidebarMenu>
367 ) : (
368 <div className="flex flex-col gap-4">
369 {compactSearchOpen ? null : (
370 <SidebarMenu className="md:hidden">
371 <SidebarMenuItem>
372 <SidebarMenuButton
373 aria-label={gt("Search settings")}
374 onClick={() => setCompactSearchOpen(true)}
375 >
376 <SearchIcon />
377 </SidebarMenuButton>
378 </SidebarMenuItem>
379 </SidebarMenu>
380 )}
381 <div onKeyDown={handleSettingsSectionKeyDown} className="flex flex-col gap-4">
382 {SETTINGS_NAV_GROUPS.map((group, index) => (
383 <div
384 key={group.heading}
385 className="flex flex-col gap-1 max-md:border-t max-md:border-sidebar-border max-md:pt-4 max-md:first:border-t-0 max-md:first:pt-0"
386 >
387 <h3
388 id={`settings-nav-group-${index}`}
389 className={cn(
390 "px-2 text-xs font-medium text-sidebar-muted-foreground/80",
391 group.headingHidden ? "sr-only" : !compactSearchOpen && "max-md:sr-only",
392 )}
393 >
394 {m(group.heading)}
395 </h3>
396 {/* The heading stays outside the group it names so NVDA does not read the name twice. */}
397 <div role="group" aria-labelledby={`settings-nav-group-${index}`}>
398 <SidebarMenu>
399 {group.paths.map((to) => {
400 const Icon = SETTINGS_SECTION_ICONS[to];
401 const isActive = activePath === to || activePath.startsWith(`${to}/`);
402 return (
403 <SidebarMenuItem key={to}>
404 <SidebarMenuButton
405 data-settings-section={to}
406 aria-current={isActive ? "page" : undefined}
407 isActive={isActive}
408 onClick={() => handleSectionClick(to)}
409 >
410 <Icon />
411 <span
412 className={cn(
413 "truncate",
414 !compactSearchOpen && "max-md:sr-only",
415 )}
416 >
417 {m(SETTINGS_NAV_LABELS[to])}
418 </span>
419 </SidebarMenuButton>
420 </SidebarMenuItem>
421 );
422 })}
423 </SidebarMenu>
424 </div>
425 </div>
426 ))}
427 </div>
428 </div>
429 )}
430 </div>
431 </SidebarGroup>
432 </SidebarContent>
433 <SidebarFooter className="max-md:hidden">
434 <Suspense fallback={null}>
435 <T3ConnectSidebarSignIn />
436 </Suspense>
437 <Suspense fallback={null}>
438 <T3ConnectSidebarAvatar />
439 </Suspense>
440 </SidebarFooter>
441 </nav>
442 );
443 }