Commit 26b8f985d85773e41a2ee637785f7c87d5c1a01e | the-knife

apps/mobile/modules/t3-composer-editor/ios/T3ComposerEditorModule.swift+3

 @@ -87,6 +87,9 @@ public class T3ComposerEditorModule: Module {
       Prop("spellCheck") { (view: T3ComposerEditorView, spellCheck: Bool) in
         view.setSpellCheck(spellCheck)
       }
+      Prop("enterBehavior") { (view: T3ComposerEditorView, behavior: String) in
+        view.setEnterBehavior(behavior)
+      }
       Prop("textPasteThresholdBytes") { (view: T3ComposerEditorView, threshold: Int) in
         view.setTextPasteThresholdBytes(threshold)
       }

apps/mobile/modules/t3-composer-editor/ios/T3ComposerEditorView.swift+39

...	@@ -45,6 +45,11 @@ private struct ComposerChipStyle {	...	@@ -45,6 +45,11 @@ private struct ComposerChipStyle {
45	let textColor: UIColor	45	let textColor: UIColor
46	}	46	}
47		47
		48	private enum ComposerEnterBehavior: String {
		49	case send
		50	case newline
		51	}
		52
48	private final class ComposerTextAttachment: NSTextAttachment {	53	private final class ComposerTextAttachment: NSTextAttachment {
49	let source: String	54	let source: String
50	let label: String	55	let label: String
...	@@ -93,10 +98,12 @@ private final class ComposerTextView: UITextView {	...	@@ -93,10 +98,12 @@ private final class ComposerTextView: UITextView {
93	var isReadOnly = false	98	var isReadOnly = false
94	var textPasteThresholdBytes = 0	99	var textPasteThresholdBytes = 0
95	var maxInputChars = Int.max	100	var maxInputChars = Int.max
		101	var enterBehavior: ComposerEnterBehavior = .send
96	private var bypassTextPasteInterception = false	102	private var bypassTextPasteInterception = false
97		103
98	override var keyCommands: [UIKeyCommand]? {	104	override var keyCommands: [UIKeyCommand]? {
99	var commands = super.keyCommands ?? []	105	var commands = super.keyCommands ?? []
		106	guard !isReadOnly, markedTextRange == nil else { return commands }
100	let submit = UIKeyCommand(	107	let submit = UIKeyCommand(
101	input: "\r",	108	input: "\r",
102	modifierFlags: .command,	109	modifierFlags: .command,
...	@@ -105,6 +112,25 @@ private final class ComposerTextView: UITextView {	...	@@ -105,6 +112,25 @@ private final class ComposerTextView: UITextView {
105	submit.discoverabilityTitle = "Send Message"	112	submit.discoverabilityTitle = "Send Message"
106	submit.wantsPriorityOverSystemBehavior = true	113	submit.wantsPriorityOverSystemBehavior = true
107	commands.append(submit)	114	commands.append(submit)
		115	if enterBehavior == .send {
		116	let submitOnReturn = UIKeyCommand(
		117	input: "\r",
		118	modifierFlags: [],
		119	action: #selector(submitMessage(_:))
		120	)
		121	submitOnReturn.discoverabilityTitle = "Send Message"
		122	submitOnReturn.wantsPriorityOverSystemBehavior = true
		123	commands.append(submitOnReturn)
		124
		125	let newline = UIKeyCommand(
		126	input: "\r",
		127	modifierFlags: .shift,
		128	action: #selector(insertNewline(_:))
		129	)
		130	newline.discoverabilityTitle = "New Line"
		131	newline.wantsPriorityOverSystemBehavior = true
		132	commands.append(newline)
		133	}
108	if textPasteThresholdBytes > 0 {	134	if textPasteThresholdBytes > 0 {
109	let pasteAsText = UIKeyCommand(	135	let pasteAsText = UIKeyCommand(
110	input: "v",	136	input: "v",
...	@@ -119,9 +145,15 @@ private final class ComposerTextView: UITextView {	...	@@ -119,9 +145,15 @@ private final class ComposerTextView: UITextView {
119	}	145	}
120		146
121	@objc private func submitMessage(_ sender: UIKeyCommand) {	147	@objc private func submitMessage(_ sender: UIKeyCommand) {
		148	guard !isReadOnly, markedTextRange == nil else { return }
122	onSubmit?()	149	onSubmit?()
123	}	150	}
124		151
		152	@objc private func insertNewline(_ sender: UIKeyCommand) {
		153	guard !isReadOnly, markedTextRange == nil else { return }
		154	insertText("\n")
		155	}
		156
125	@objc private func pasteInline(_ sender: UIKeyCommand) {	157	@objc private func pasteInline(_ sender: UIKeyCommand) {
126	guard !isReadOnly else {	158	guard !isReadOnly else {
127	return	159	return
...	@@ -132,6 +164,9 @@ private final class ComposerTextView: UITextView {	...	@@ -132,6 +164,9 @@ private final class ComposerTextView: UITextView {
132	}	164	}
133		165
134	override func canPerformAction(_ action: Selector, withSender sender: Any?) -> Bool {	166	override func canPerformAction(_ action: Selector, withSender sender: Any?) -> Bool {
		167	if action == #selector(submitMessage(_:)) \|\| action == #selector(insertNewline(_:)) {
		168	return isEditable && !isReadOnly && markedTextRange == nil
		169	}
135	if isReadOnly && Self.readOnlyActions.contains(NSStringFromSelector(action)) {	170	if isReadOnly && Self.readOnlyActions.contains(NSStringFromSelector(action)) {
136	return false	171	return false
137	}	172	}
...	@@ -657,6 +692,10 @@ public final class T3ComposerEditorView: ExpoView, UITextViewDelegate, UITextDro	...	@@ -657,6 +692,10 @@ public final class T3ComposerEditorView: ExpoView, UITextViewDelegate, UITextDro
657	textView.spellCheckingType = spellCheck ? .yes : .no	692	textView.spellCheckingType = spellCheck ? .yes : .no
658	}	693	}
659		694
		695	func setEnterBehavior(_ behavior: String) {
		696	textView.enterBehavior = ComposerEnterBehavior(rawValue: behavior) ?? .send
		697	}
		698
660	func setTextPasteThresholdBytes(_ threshold: Int) {	699	func setTextPasteThresholdBytes(_ threshold: Int) {
661	textView.textPasteThresholdBytes = threshold	700	textView.textPasteThresholdBytes = threshold
662	}	701	}

apps/mobile/modules/t3-native-controls/ios/T3KeyboardCommandsModule.swift+37-2

...	@@ -20,11 +20,26 @@ public final class T3KeyboardCommandsView: ExpoView {	...	@@ -20,11 +20,26 @@ public final class T3KeyboardCommandsView: ExpoView {
20		20
21	public override var canBecomeFirstResponder: Bool { true }	21	public override var canBecomeFirstResponder: Bool { true }
22		22
		23	public override func canPerformAction(_ action: Selector, withSender sender: Any?) -> Bool {
		24	if action == #selector(openCommandPalette) \|\| action == #selector(paletteNext) \|\| action == #selector(palettePrevious) \|\| action == #selector(paletteDismiss),
		25	let input = window?.t3FirstResponder as? UITextInput,
		26	input.markedTextRange != nil {
		27	return false
		28	}
		29	return super.canPerformAction(action, withSender: sender)
		30	}
		31
23	public override var keyCommands: [UIKeyCommand]? {	32	public override var keyCommands: [UIKeyCommand]? {
24	[	33	let isPad = UIDevice.current.userInterfaceIdiom == .pad
		34	var commands = [
25	enabledCommand("newTask", input: "n", modifiers: .command, action: #selector(newTask), title: "New Task"),	35	enabledCommand("newTask", input: "n", modifiers: .command, action: #selector(newTask), title: "New Task"),
26	enabledCommand("focusSearch", input: "f", modifiers: .command, action: #selector(focusSearch), title: "Find"),	36	enabledCommand("focusSearch", input: "f", modifiers: .command, action: #selector(focusSearch), title: "Find"),
27	enabledCommand("focusSearch", input: "k", modifiers: .command, action: #selector(focusSearch), title: "Focus Search"),	37	isPad
		38	? enabledCommand("commandPalette", input: "k", modifiers: .command, action: #selector(openCommandPalette), title: "Command Palette")
		39	: enabledCommand("focusSearch", input: "k", modifiers: .command, action: #selector(focusSearch), title: "Focus Search"),
		40	enabledCommand("paletteNext", input: UIKeyCommand.inputDownArrow, modifiers: [], action: #selector(paletteNext), title: "Next Result"),
		41	enabledCommand("palettePrevious", input: UIKeyCommand.inputUpArrow, modifiers: [], action: #selector(palettePrevious), title: "Previous Result"),
		42	enabledCommand("paletteDismiss", input: UIKeyCommand.inputEscape, modifiers: [], action: #selector(paletteDismiss), title: "Close Command Palette"),
28	enabledCommand("back", input: "[", modifiers: .command, action: #selector(goBack), title: "Back"),	43	enabledCommand("back", input: "[", modifiers: .command, action: #selector(goBack), title: "Back"),
29	enabledCommand("files", input: "f", modifiers: [.command, .shift], action: #selector(openFiles), title: "Open Files"),	44	enabledCommand("files", input: "f", modifiers: [.command, .shift], action: #selector(openFiles), title: "Open Files"),
30	enabledCommand("terminal", input: "t", modifiers: [.command, .shift], action: #selector(openTerminal), title: "Open Terminal"),	45	enabledCommand("terminal", input: "t", modifiers: [.command, .shift], action: #selector(openTerminal), title: "Open Terminal"),
...	@@ -38,6 +53,18 @@ public final class T3KeyboardCommandsView: ExpoView {	...	@@ -38,6 +53,18 @@ public final class T3KeyboardCommandsView: ExpoView {
38	),	53	),
39	enabledCommand("toggleSidebar", input: "\\", modifiers: .command, action: #selector(handleToggleSidebar), title: "Toggle Sidebar"),	54	enabledCommand("toggleSidebar", input: "\\", modifiers: .command, action: #selector(handleToggleSidebar), title: "Toggle Sidebar"),
40	].compactMap { $0 }	55	].compactMap { $0 }
		56	if isPad {
		57	commands += (1...9).compactMap { index in
		58	enabledCommand(
		59	"thread.jump.\(index)",
		60	input: String(index),
		61	modifiers: .command,
		62	action: #selector(jumpToThread(_:)),
		63	title: "Go to Thread \(index)"
		64	)
		65	}
		66	}
		67	return commands
41	}	68	}
42		69
43	func setEnabledCommands(_ commands: [String]) {	70	func setEnabledCommands(_ commands: [String]) {
...	@@ -108,6 +135,14 @@ public final class T3KeyboardCommandsView: ExpoView {	...	@@ -108,6 +135,14 @@ public final class T3KeyboardCommandsView: ExpoView {
108	}	135	}
109		136
110	@objc private func newTask() { emit("newTask") }	137	@objc private func newTask() { emit("newTask") }
		138	@objc private func openCommandPalette() { emit("commandPalette") }
		139	@objc private func paletteNext() { emit("paletteNext") }
		140	@objc private func palettePrevious() { emit("palettePrevious") }
		141	@objc private func paletteDismiss() { emit("paletteDismiss") }
		142	@objc private func jumpToThread(_ sender: UIKeyCommand) {
		143	guard let input = sender.input else { return }
		144	emit("thread.jump.\(input)")
		145	}
111	@objc private func focusSearch() { emit("focusSearch") }	146	@objc private func focusSearch() { emit("focusSearch") }
112	@objc private func goBack() { emit("back") }	147	@objc private func goBack() { emit("back") }
113	@objc private func openFiles() { emit("files") }	148	@objc private func openFiles() { emit("files") }

apps/mobile/src/App.tsx+2

...	@@ -38,6 +38,8 @@ void SplashScreen.preventAutoHideAsync().catch(() => {	...	@@ -38,6 +38,8 @@ void SplashScreen.preventAutoHideAsync().catch(() => {
38		38
39	const appLinking = {	39	const appLinking = {
40	prefixes: [Linking.createURL("/"), "t3code://", "t3code-dev://", "t3code-preview://"],	40	prefixes: [Linking.createURL("/"), "t3code://", "t3code-dev://", "t3code-preview://"],
		41	// Keep the compact thread list available beneath a directly opened thread.
		42	config: { initialRouteName: "Home" },
41	// The Expo dev client launches the app via	43	// The Expo dev client launches the app via
42	// <scheme>://expo-development-client/?url=<packager> — that URL addresses	44	// <scheme>://expo-development-client/?url=<packager> — that URL addresses
43	// the launcher, not app navigation. Without this filter it falls through	45	// the launcher, not app navigation. Without this filter it falls through

apps/mobile/src/Stack.tsx+25-7

 @@ -23,7 +23,10 @@ import { useConnectOnboardingNavigation } from "./features/cloud/connectOnboardi
 import { AttachmentFileScreen } from "./features/files/AttachmentFileScreen";
 import { ThreadFilesTreeScreen, ThreadFileScreen } from "./features/files/ThreadFilesRouteScreen";
 import { AdaptiveWorkspaceLayout } from "./features/layout/AdaptiveWorkspaceLayout";
-import { HardwareKeyboardCommandProvider } from "./features/keyboard/HardwareKeyboardCommandProvider";
+import {
+  HardwareKeyboardCommandOverlay,
+  HardwareKeyboardCommandProvider,
+} from "./features/keyboard/HardwareKeyboardCommandProvider";
 import { ReviewCommentComposerSheet } from "./features/review/ReviewCommentComposerSheet";
 import { ReviewSheet } from "./features/review/ReviewSheet";
 import { ThreadTerminalRouteScreen } from "./features/terminal/ThreadTerminalRouteScreen";
 @@ -56,6 +59,7 @@ import { SettingsClientStorageRouteScreen } from "./features/settings/SettingsCl
 import { SettingsDiagnosticsRouteScreen } from "./features/diagnostics/SettingsDiagnosticsRouteScreen";
 import { SettingsAuthRouteScreen } from "./features/settings/SettingsAuthRouteScreen";
 import { SettingsEnvironmentsRouteScreen } from "./features/settings/SettingsEnvironmentsRouteScreen";
+import { SettingsKeyboardRouteScreen } from "./features/settings/SettingsKeyboardRouteScreen";
 import { SettingsLegalRouteScreen } from "./features/settings/SettingsLegalRouteScreen";
 import {
   SettingsOpenSourceLicenseRouteScreen,
 @@ -192,6 +196,13 @@ const SettingsContentStack = createNativeStackNavigator({
         title: "Project Grouping",
       },
     }),
+    SettingsKeyboard: createNativeStackScreen({
+      screen: SettingsKeyboardRouteScreen,
+      linking: "keyboard",
+      options: {
+        title: "Keyboard",
+      },
+    }),
     SettingsClientStorage: createNativeStackScreen({
       screen: SettingsClientStorageRouteScreen,
       linking: "client-storage",
 @@ -381,17 +392,20 @@ const WORKSPACE_OVERLAY_ROUTES = new Set([
 ]);
 /**
- * Pathname of the topmost NON-overlay route — the screen the workspace is
+ * Location of the topmost non-overlay route, including its key so thread
- * actually "on", regardless of any sheets floating above it.
+ * selection can dismiss sheets without replacing the wrong destination.
  */
-function workspacePathFromState(state: NavigationState): string {
+function workspaceLocationFromState(state: NavigationState) {
   const routes = state.routes.filter((route) => !WORKSPACE_OVERLAY_ROUTES.has(route.name));
   const effectiveState =
     routes.length > 0 && routes.length !== state.routes.length
       ? ({ ...state, routes, index: routes.length - 1 } as NavigationState)
       : state;
   const path = getPathFromState(effectiveState, navigationPathConfig);
-  return path.startsWith("/") ? path : `/${path}`;
+  return {
+    pathname: path.startsWith("/") ? path : `/${path}`,
+    routeKey: effectiveState.routes[effectiveState.index]?.key,
+  };
 }
 // The drain hook subscribes to the outbox, all thread shells, projects, and
 @@ -435,15 +449,19 @@ function RootStackLayout(props: {
   // workspace layout only reacts to the underlying non-overlay route.
   const path = getPathFromState(props.state, navigationPathConfig);
   const pathname = path.startsWith("/") ? path : `/${path}`;
-  const workspacePathname = workspacePathFromState(props.state);
+  const workspaceLocation = workspaceLocationFromState(props.state);
   return (
     <HardwareKeyboardCommandProvider pathname={pathname}>
       <ThreadOutboxDrainWorker />
       <ShowcaseCaptureCoordinator pathname={pathname} />
       <ExistingThreadSettingsRouteProvider>
-        <AdaptiveWorkspaceLayout pathname={workspacePathname}>
+        <AdaptiveWorkspaceLayout
+          pathname={workspaceLocation.pathname}
+          workspaceRouteKey={workspaceLocation.routeKey}
+        >
           {props.children}
+          <HardwareKeyboardCommandOverlay />
         </AdaptiveWorkspaceLayout>
       </ExistingThreadSettingsRouteProvider>
     </HardwareKeyboardCommandProvider>

apps/mobile/src/components/ComposerEditor.tsx+8

...	@@ -1,4 +1,6 @@	...	@@ -1,4 +1,6 @@
1	import { ComposerContextId } from "@t3tools/contracts";	1	import { ComposerContextId } from "@t3tools/contracts";
		2	import { useAtomValue } from "@effect/atom-react";
		3	import { AsyncResult } from "effect/unstable/reactivity";
2	import { useEffect, useMemo, useRef, useState } from "react";	4	import { useEffect, useMemo, useRef, useState } from "react";
3	import { Alert } from "react-native";	5	import { Alert } from "react-native";
4	import type { EnvironmentId } from "@t3tools/contracts";	6	import type { EnvironmentId } from "@t3tools/contracts";
...	@@ -19,6 +21,7 @@ import {	...	@@ -19,6 +21,7 @@ import {
19	useComposerDraft,	21	useComposerDraft,
20	} from "../state/use-composer-drafts";	22	} from "../state/use-composer-drafts";
21	import { importComposerContextClipboard } from "../lib/composerContextClipboard";	23	import { importComposerContextClipboard } from "../lib/composerContextClipboard";
		24	import { mobilePreferencesAtom } from "../state/preferences";
22	import { ComposerContextSheet } from "./ComposerContextSheet";	25	import { ComposerContextSheet } from "./ComposerContextSheet";
23	import { AppText as Text } from "./AppText";	26	import { AppText as Text } from "./AppText";
24	import {	27	import {
...	@@ -53,6 +56,10 @@ export function ComposerEditor({	...	@@ -53,6 +56,10 @@ export function ComposerEditor({
53	...props	56	...props
54	}: ComposerEditorProps) {	57	}: ComposerEditorProps) {
55	const draft = useComposerDraft(draftKey ?? null);	58	const draft = useComposerDraft(draftKey ?? null);
		59	const preferencesResult = useAtomValue(mobilePreferencesAtom);
		60	const preferredEnterBehavior = AsyncResult.isSuccess(preferencesResult)
		61	? preferencesResult.value.composerEnterBehavior
		62	: undefined;
56	const contextHistory = useMemo(() => createComposerDraftContextHistory(), [draftKey]);	63	const contextHistory = useMemo(() => createComposerDraftContextHistory(), [draftKey]);
57	useEffect(() => () => contextHistory.dispose(), [contextHistory]);	64	useEffect(() => () => contextHistory.dispose(), [contextHistory]);
58	const changeText = (text: string) => {	65	const changeText = (text: string) => {
...	@@ -158,6 +165,7 @@ export function ComposerEditor({	...	@@ -158,6 +165,7 @@ export function ComposerEditor({
158	<>	165	<>
159	<NativeComposerEditor	166	<NativeComposerEditor
160	{...props}	167	{...props}
		168	enterBehavior={props.enterBehavior ?? preferredEnterBehavior}
161	onChangeText={changeText}	169	onChangeText={changeText}
162	readOnly={props.readOnly \|\| importing}	170	readOnly={props.readOnly \|\| importing}
163	onSubmit={importing ? undefined : props.onSubmit}	171	onSubmit={importing ? undefined : props.onSubmit}

apps/mobile/src/components/RowPressable.tsx created+35

...	@@ -0,0 +1,35 @@
1	import type { ComponentProps, ReactNode } from "react";
2	import { Pressable, View } from "react-native";
3	import { GestureDetector } from "react-native-gesture-handler";
4
5	import { cn } from "../lib/cn";
6	import { useHoverGesture } from "../lib/useHoverGesture";
7
8	/** Shared row feedback, layered over the background so selection stays visible. */
9	export function RowPressable({
10	children,
11	className,
12	interactionClassName = "bg-primary",
13	...props
14	}: Omit<ComponentProps<typeof Pressable>, "children"> & {
15	readonly children: ReactNode;
16	readonly interactionClassName?: string;
17	}) {
18	const { hovered, hoverGesture } = useHoverGesture(props.disabled ?? false);
19	return (
20	<GestureDetector gesture={hoverGesture}>
21	<Pressable {...props} className={cn("relative overflow-hidden", className)}>
22	{({ pressed }) => (
23	<>
24	<View
25	pointerEvents="none"
26	className={cn("absolute inset-0", interactionClassName)}
27	style={{ opacity: props.disabled ? 0 : pressed ? 0.2 : hovered ? 0.1 : 0 }}
28	/>
29	{children}
30	</>
31	)}
32	</Pressable>
33	</GestureDetector>
34	);
35	}

apps/mobile/src/features/home/HomeScreen.tsx+6

 @@ -37,6 +37,7 @@ import { NATIVE_LIQUID_GLASS_SUPPORTED } from "../../native/native-glass";
 import { mobilePreferencesAtom, updateMobilePreferencesAtom } from "../../state/preferences";
 import { useThreadSearch } from "../../state/queries";
 import { useAppearancePreferences } from "../settings/appearance/AppearancePreferencesProvider";
+import { useThreadJumpShortcuts } from "../keyboard/threadKeyboardShortcuts";
 import { useThreadListV2Enabled } from "../threads/use-thread-list-v2-enabled";
 import { usePendingThreadOrder } from "../../state/thread-order";
 import { environmentServerConfigsAtom } from "../../state/server";
 @@ -775,6 +776,11 @@ export function HomeScreen(props: HomeScreenProps) {
     [settledShelfExpanded, snoozedShelfExpanded, threadListV2Layout, v2PendingTasks],
   );
+  useThreadJumpShortcuts(
+    threadListV2Enabled ? threadListV2Items : listLayout.items,
+    props.onSelectThread,
+  );
   const renderV2Item = useCallback(
     ({ item, index }: { readonly item: ThreadListV2ListItem; readonly index: number }) => {
       const nextItem = threadListV2Items[index + 1];

apps/mobile/src/features/home/homeListItems.test.ts+23

...	@@ -15,6 +15,7 @@ import {	...	@@ -15,6 +15,7 @@ import {
15	type HomeListItem,	15	type HomeListItem,
16	} from "./homeListItems";	16	} from "./homeListItems";
17	import type { HomeThreadGroup } from "./homeThreadList";	17	import type { HomeThreadGroup } from "./homeThreadList";
		18	import { threadJumpTarget } from "../keyboard/threadKeyboardShortcuts";
18		19
19	const environmentId = EnvironmentId.make("environment-1");	20	const environmentId = EnvironmentId.make("environment-1");
20		21
...	@@ -87,6 +88,28 @@ function displayStates(	...	@@ -87,6 +88,28 @@ function displayStates(
87	return new Map(Object.entries(entries));	88	return new Map(Object.entries(entries));
88	}	89	}
89		90
		91	describe("threadJumpTarget", () => {
		92	it("numbers only displayed threads across groups, skipping collapsed groups and pagination rows", () => {
		93	const layout = buildHomeListLayout({
		94	groups: [makeGroup("collapsed", 3), makeGroup("alpha", 8), makeGroup("beta", 3)],
		95	displayStates: displayStates({ collapsed: { collapsed: true, visibleCount: 6 } }),
		96	});
		97	expect(threadJumpTarget(layout.items, "thread.jump.1")?.id).toBe("alpha-thread-0");
		98	expect(threadJumpTarget(layout.items, "thread.jump.7")?.id).toBe("beta-thread-0");
		99	expect(threadJumpTarget(layout.items, "thread.jump.9")?.id).toBe("beta-thread-2");
		100	});
		101
		102	it("ignores missing positions and unrelated commands", () => {
		103	const layout = buildHomeListLayout({
		104	groups: [makeGroup("alpha", 1)],
		105	displayStates: displayStates({}),
		106	});
		107	expect(threadJumpTarget(layout.items, "thread.jump.2")).toBeNull();
		108	expect(threadJumpTarget([], "thread.jump.1")).toBeNull();
		109	expect(threadJumpTarget(layout.items, "commandPalette")).toBeNull();
		110	});
		111	});
		112
90	describe("buildHomeListLayout", () => {	113	describe("buildHomeListLayout", () => {
91	it("renders a header plus all threads for a small group without a show-more row", () => {	114	it("renders a header plus all threads for a small group without a show-more row", () => {
92	const layout = buildHomeListLayout({	115	const layout = buildHomeListLayout({

apps/mobile/src/features/keyboard/CommandPalette.tsx created+472

...	@@ -0,0 +1,472 @@
1	import { useNavigation } from "@react-navigation/native";
2	import type { EnvironmentThreadSearchMatch } from "@t3tools/client-runtime/state/thread-search";
3	import { THREAD_JUMP_KEYBINDING_COMMANDS } from "@t3tools/contracts";
4	import { threadPullRequestSearchTerms } from "@t3tools/shared/threadPullRequests";
5	import { useCallback, useEffect, useMemo, useRef, useState } from "react";
6	import {
7	FlatList,
8	KeyboardAvoidingView,
9	Modal,
10	Pressable,
11	TextInput,
12	useWindowDimensions,
13	View,
14	} from "react-native";
15
16	import { GestureHandlerRootView } from "react-native-gesture-handler";
17
18	import { RowPressable } from "../../components/RowPressable";
19	import { AppText as Text } from "../../components/AppText";
20	import { SymbolView, type AppSymbolName } from "../../components/AppSymbol";
21	import { GlassSurface } from "../../components/GlassSurface";
22	import { scopedProjectKey, scopedThreadKey } from "../../lib/scopedEntities";
23	import { T3KeyboardCommands } from "../../native/T3KeyboardCommands";
24	import { useProjects, useThreadShell, useThreadShells } from "../../state/entities";
25	import { useThreadSearch } from "../../state/queries";
26	import { useWorkspaceState } from "../../state/workspace";
27	import { useSavedRemoteConnections } from "../../state/use-remote-environment-registry";
28	import { useAdaptiveWorkspaceLayout } from "../layout/AdaptiveWorkspaceLayout";
29	import { ThreadSearchMatchExcerpt } from "../threads/thread-search-match";
30	import {
31	filterCommandPaletteItems,
32	nextPaletteIndex,
33	type CommandPaletteItem,
34	} from "./commandPaletteItems";
35	import { parseActiveThreadPath, type HardwareKeyboardCommand } from "./hardwareKeyboardCommands";
36	import { threadJumpIndex } from "./threadKeyboardShortcuts";
37
38	const PALETTE_COMMANDS: ReadonlyArray<HardwareKeyboardCommand> = [
39	"commandPalette",
40	"paletteDismiss",
41	"paletteNext",
42	"palettePrevious",
43	...THREAD_JUMP_KEYBINDING_COMMANDS,
44	];
45	const ROW_HEIGHT = 50;
46
47	const ACTION_ICONS: Record<string, AppSymbolName> = {
48	newTask: "square.and.pencil",
49	newThread: "square.and.pencil",
50	addProject: "folder.badge.plus",
51	settings: "gearshape",
52	appearance: "paintbrush",
53	environments: "desktopcomputer",
54	usage: "chart.bar.xaxis",
55	archive: "archivebox",
56	files: "doc.text",
57	terminal: "terminal",
58	review: "arrow.triangle.pull",
59	copyThreadReference: "link",
60	};
61
62	function itemIcon(item: CommandPaletteItem): AppSymbolName {
63	if (item.kind === "project") return "folder";
64	if (item.kind === "thread") return "text.bubble";
65	return ACTION_ICONS[item.key] ?? "ellipsis";
66	}
67
68	function PaletteRow(props: {
69	readonly item: CommandPaletteItem;
70	readonly index: number;
71	readonly selected: boolean;
72	readonly searchMatch?: EnvironmentThreadSearchMatch;
73	readonly searchQuery: string;
74	readonly onSelect: () => void;
75	}) {
76	return (
77	<RowPressable
78	accessibilityRole="button"
79	accessibilityState={{ selected: props.selected }}
80	onPress={props.onSelect}
81	className={
82	props.selected
83	? "mx-2 flex-row items-center gap-3 rounded-xl bg-primary/10 px-3"
84	: "mx-2 flex-row items-center gap-3 rounded-xl px-3"
85	}
86	style={{ height: ROW_HEIGHT }}
87	>
88	<View className="w-7 items-center">
89	<SymbolView name={itemIcon(props.item)} size={20} tintColorClassName="accent-icon" />
90	</View>
91	<View className="flex-1">
92	<Text numberOfLines={1} className="text-base">
93	{props.item.title}
94	</Text>
95	{props.searchMatch ? (
96	<ThreadSearchMatchExcerpt match={props.searchMatch} query={props.searchQuery} compact />
97	) : props.item.detail ? (
98	<Text numberOfLines={1} className="text-sm text-foreground-muted">
99	{props.item.detail}
100	</Text>
101	) : null}
102	</View>
103	{props.index < 9 ? (
104	<Text className="text-sm text-foreground-muted">⌘{props.index + 1}</Text>
105	) : null}
106	</RowPressable>
107	);
108	}
109
110	/** Mounted only while open, so the app root does not subscribe to the full thread catalog. */
111	export function CommandPalette(props: {
112	readonly pathname: string;
113	readonly onClose: () => void;
114	readonly onCommand: (command: HardwareKeyboardCommand) => void;
115	}) {
116	const navigation = useNavigation();
117	const { selectThread } = useAdaptiveWorkspaceLayout();
118	const runCommand = props.onCommand;
119	const projects = useProjects();
120	const threads = useThreadShells();
121	const activeThreadRef = useMemo(() => parseActiveThreadPath(props.pathname), [props.pathname]);
122	const activeThread = useThreadShell(activeThreadRef);
123	const { environments } = useWorkspaceState();
124	const { savedConnectionsById } = useSavedRemoteConnections();
125	const [query, setQuery] = useState("");
126	const [selection, setSelection] = useState<string \| null>(null);
127	const [visible, setVisible] = useState(true);
128	const pendingAction = useRef<(() => void) \| null>(null);
129	const closing = useRef(false);
130	const inputRef = useRef<TextInput>(null);
131	const listRef = useRef<FlatList<CommandPaletteItem>>(null);
132	const { width, height } = useWindowDimensions();
133	const searchEnvironmentIds = useMemo(
134	() =>
135	environments
136	.filter((environment) => environment.connectionState === "connected")
137	.map((environment) => environment.environmentId),
138	[environments],
139	);
140	const search = useThreadSearch(searchEnvironmentIds, query.startsWith(">") ? "" : query);
141	const matchedThreadKeys = useMemo(
142	() =>
143	new Set(search.matches.map((match) => scopedThreadKey(match.environmentId, match.threadId))),
144	[search.matches],
145	);
146	const contentMatchByKey = useMemo(
147	() =>
148	new Map(
149	search.matches
150	.filter((match) => match.source === "user" \|\| match.source === "assistant")
151	.map((match) => [scopedThreadKey(match.environmentId, match.threadId), match]),
152	),
153	[search.matches],
154	);
155	const items = useMemo(() => {
156	const actions: CommandPaletteItem[] = [
157	{
158	key: "newTask",
159	kind: "action",
160	title: "New thread in…",
161	searchTerms: ["new task", "chat", "create", "project"],
162	run: () => navigation.navigate("NewTaskSheet", { screen: "NewTask" }),
163	},
164	{
165	key: "addProject",
166	kind: "action",
167	title: "Add project",
168	searchTerms: ["folder", "clone", "repository", "git"],
169	run: () => navigation.navigate("NewTaskSheet", { screen: "AddProject" }),
170	},
171	{
172	key: "settings",
173	kind: "action",
174	title: "Open settings",
175	searchTerms: ["preferences", "configuration"],
176	run: () =>
177	navigation.navigate("SettingsSheet", {
178	screen: "SettingsContent",
179	params: { screen: "Settings" },
180	}),
181	},
182	{
183	key: "appearance",
184	kind: "action",
185	title: "Appearance",
186	searchTerms: ["theme", "colors", "dark", "light"],
187	run: () =>
188	navigation.navigate("SettingsSheet", {
189	screen: "SettingsContent",
190	params: { screen: "SettingsAppearance" },
191	}),
192	},
193	{
194	key: "environments",
195	kind: "action",
196	title: "Manage environments",
197	searchTerms: ["connections", "server", "remote"],
198	run: () =>
199	navigation.navigate("SettingsSheet", {
200	screen: "SettingsContent",
201	params: { screen: "SettingsEnvironments" },
202	}),
203	},
204	{
205	key: "usage",
206	kind: "action",
207	title: "Usage",
208	searchTerms: ["limits", "accounts", "quota"],
209	run: () =>
210	navigation.navigate("SettingsSheet", {
211	screen: "SettingsContent",
212	params: { screen: "SettingsUsage" },
213	}),
214	},
215	{
216	key: "archive",
217	kind: "action",
218	title: "Archived threads",
219	searchTerms: ["restore", "history"],
220	run: () =>
221	navigation.navigate("SettingsSheet", {
222	screen: "SettingsContent",
223	params: { screen: "SettingsArchive" },
224	}),
225	},
226	];
227	const projectByKey = new Map(
228	projects.map((project) => [scopedProjectKey(project.environmentId, project.id), project]),
229	);
230	const activeProject = activeThread
231	? projectByKey.get(scopedProjectKey(activeThread.environmentId, activeThread.projectId))
232	: null;
233	if (activeProject) {
234	actions.unshift({
235	key: "newThread",
236	kind: "action",
237	title: `New thread in ${activeProject.title}`,
238	searchTerms: ["new task", "chat", "create"],
239	run: () =>
240	navigation.navigate("NewTaskSheet", {
241	screen: "NewTaskDraft",
242	params: {
243	environmentId: activeProject.environmentId,
244	projectId: activeProject.id,
245	title: activeProject.title,
246	},
247	}),
248	});
249	}
250	if (activeThreadRef) {
251	const threadActions = [
252	["files", "Go to file", ["open", "files", "browse", "search"]],
253	["terminal", "Open terminal", ["shell", "console"]],
254	["review", "Review changes", ["diff", "git", "pull request"]],
255	["copyThreadReference", "Copy PR link or thread ID", ["reference", "clipboard"]],
256	] as const;
257	actions.push(
258	...threadActions.map(([command, title, searchTerms]) => ({
259	key: command,
260	kind: "action" as const,
261	title,
262	searchTerms,
263	run: () => runCommand(command),
264	})),
265	);
266	}
267	const projectItems: CommandPaletteItem[] = projects.map((project) => ({
268	key: `project:${scopedProjectKey(project.environmentId, project.id)}`,
269	kind: "project",
270	title: project.title,
271	detail: `New thread · ${savedConnectionsById[project.environmentId]?.environmentLabel ?? project.environmentId}`,
272	searchTerms: [project.workspaceRoot, "new thread", "project"],
273	run: () =>
274	navigation.navigate("NewTaskSheet", {
275	screen: "NewTaskDraft",
276	params: {
277	environmentId: project.environmentId,
278	projectId: project.id,
279	title: project.title,
280	},
281	}),
282	}));
283	const threadItems: CommandPaletteItem[] = threads
284	.filter((thread) => thread.archivedAt === null)
285	.sort((left, right) =>
286	(right.latestUserMessageAt ?? right.updatedAt).localeCompare(
287	left.latestUserMessageAt ?? left.updatedAt,
288	),
289	)
290	.map((thread) => {
291	const project = projectByKey.get(scopedProjectKey(thread.environmentId, thread.projectId));
292	const environment =
293	savedConnectionsById[thread.environmentId]?.environmentLabel ?? thread.environmentId;
294	return {
295	key: scopedThreadKey(thread.environmentId, thread.id),
296	kind: "thread",
297	title: thread.title \|\| "Untitled thread",
298	detail: [project?.title, environment].filter(Boolean).join(" · "),
299	searchTerms: [
300	project?.title ?? "",
301	environment,
302	thread.branch ?? "",
303	...threadPullRequestSearchTerms(thread),
304	],
305	run: () => selectThread(thread),
306	};
307	});
308	return [...actions, ...projectItems, ...threadItems];
309	}, [
310	activeThread,
311	activeThreadRef,
312	navigation,
313	projects,
314	runCommand,
315	savedConnectionsById,
316	selectThread,
317	threads,
318	]);
319	const results = useMemo(
320	() => filterCommandPaletteItems(items, query, matchedThreadKeys),
321	[items, matchedThreadKeys, query],
322	);
323	const selectedIndex = Math.max(
324	0,
325	results.findIndex((item) => item.key === selection),
326	);
327	const selectedKey = results[selectedIndex]?.key;
328	useEffect(() => {
329	if (selectedIndex === 0) {
330	// Centering before the list measures its height scrolls half the first row out of view.
331	listRef.current?.scrollToOffset({ offset: 0, animated: false });
332	} else if (selectedKey !== undefined) {
333	listRef.current?.scrollToIndex({ index: selectedIndex, animated: false, viewPosition: 0.5 });
334	}
335	}, [selectedIndex, selectedKey]);
336
337	const dismissed = useRef(false);
338	const handleDismissed = useCallback(() => {
339	if (dismissed.current) return;
340	dismissed.current = true;
341	// Present navigation sheets only after UIKit has dismissed this modal.
342	props.onClose();
343	pendingAction.current?.();
344	}, [props]);
345
346	// iOS drops Modal onDismiss when the VC is dismissed mid-presentation (e.g.
347	// ⌘K during the fade-in) or raced by another sheet — without a fallback the
348	// palette stays mounted-but-invisible and ⌘K dead-ends on a stale open state.
349	useEffect(() => {
350	if (visible) return;
351	const fallback = setTimeout(handleDismissed, 400);
352	return () => clearTimeout(fallback);
353	}, [visible, handleDismissed]);
354
355	function close(run?: () => void) {
356	if (closing.current) return;
357	closing.current = true;
358	pendingAction.current = run ?? null;
359	setVisible(false);
360	}
361
362	function onCommand(command: HardwareKeyboardCommand) {
363	if (command === "commandPalette" \|\| command === "paletteDismiss") {
364	close();
365	} else if (command === "paletteNext" \|\| command === "palettePrevious") {
366	setSelection(
367	results[nextPaletteIndex(selectedIndex, command === "paletteNext" ? 1 : -1, results.length)]
368	?.key ?? null,
369	);
370	} else {
371	const item = results[threadJumpIndex(command)];
372	if (item) close(item.run);
373	}
374	}
375
376	return (
377	<Modal
378	visible={visible}
379	transparent
380	animationType="fade"
381	onShow={() => inputRef.current?.focus()}
382	onRequestClose={() => close()}
383	onDismiss={handleDismissed}
384	>
385	<GestureHandlerRootView className="flex-1">
386	<T3KeyboardCommands enabledCommands={PALETTE_COMMANDS} onCommand={onCommand}>
387	<KeyboardAvoidingView
388	behavior="padding"
389	className="flex-1 items-center justify-center p-4"
390	>
391	<Pressable
392	className="absolute inset-0 bg-black/15"
393	accessibilityLabel="Close command palette"
394	onPress={() => close()}
395	/>
396	<GlassSurface
397	accessibilityViewIsModal
398	style={{
399	width: Math.min(600, width - 32),
400	height: Math.min(520, height - 80),
401	borderRadius: 20,
402	}}
403	>
404	<View className="px-3 pb-2.5 pt-3.5">
405	<View className="h-[38px] flex-row items-center gap-1.5 pr-2.5 pl-[11px]">
406	<SymbolView
407	name="magnifyingglass"
408	size={15}
409	tintColorClassName="accent-foreground-muted"
410	type="monochrome"
411	/>
412	<TextInput
413	ref={inputRef}
414	accessibilityLabel="Search commands, projects, and threads"
415	placeholder="Search commands, projects, and threads…"
416	placeholderTextColorClassName="accent-placeholder"
417	autoCorrect={false}
418	autoCapitalize="none"
419	clearButtonMode="while-editing"
420	className="h-[34px] flex-1 px-0 py-0 font-sans text-base text-foreground"
421	value={query}
422	onChangeText={(value) => {
423	setQuery(value);
424	setSelection(null);
425	listRef.current?.scrollToOffset({ offset: 0, animated: false });
426	}}
427	returnKeyType="go"
428	submitBehavior="submit"
429	onSubmitEditing={() => {
430	const item = results[selectedIndex];
431	if (item) close(item.run);
432	}}
433	/>
434	</View>
435	</View>
436	<FlatList
437	ref={listRef}
438	data={results}
439	extraData={selectedKey}
440	keyboardShouldPersistTaps="handled"
441	keyExtractor={(item) => item.key}
442	getItemLayout={(_, index) => ({
443	length: ROW_HEIGHT,
444	offset: ROW_HEIGHT * index,
445	index,
446	})}
447	contentContainerClassName="pb-2"
448	ListEmptyComponent={
449	<Text className="p-5 text-center text-foreground-muted">
450	{search.isPending ? "Searching…" : "No results"}
451	</Text>
452	}
453	renderItem={({ item, index }) => (
454	<PaletteRow
455	item={item}
456	index={index}
457	selected={item.key === selectedKey}
458	searchMatch={
459	item.kind === "thread" ? contentMatchByKey.get(item.key) : undefined
460	}
461	searchQuery={query}
462	onSelect={() => close(item.run)}
463	/>
464	)}
465	/>
466	</GlassSurface>
467	</KeyboardAvoidingView>
468	</T3KeyboardCommands>
469	</GestureHandlerRootView>
470	</Modal>
471	);
472	}

apps/mobile/src/features/keyboard/HardwareKeyboardCommandProvider.tsx+34-3

 @@ -1,6 +1,8 @@
 import { StackActions, useNavigation } from "@react-navigation/native";
 import { resolveThreadReferenceCopyTarget } from "@t3tools/shared/threadReference";
 import {
+  createContext,
+  use,
   useCallback,
   useEffect,
   useMemo,
 @@ -8,6 +10,7 @@ import {
   useState,
   useSyncExternalStore,
   type PropsWithChildren,
+  type ReactNode,
 } from "react";
 import { tryCopyTextWithHaptic } from "../../lib/copyTextWithHaptic";
 @@ -15,6 +18,7 @@ import { T3KeyboardCommands } from "../../native/T3KeyboardCommands";
 import { useThreadShell } from "../../state/entities";
 import type { GitActionProgress } from "../../state/use-vcs-action-state";
 import { GitActionProgressOverlay } from "../threads/GitActionProgressOverlay";
+import { CommandPalette } from "./CommandPalette";
 import {
   dispatchHardwareKeyboardCommand,
   getHardwareKeyboardCommandRegistrationVersion,
 @@ -31,11 +35,20 @@ const EMPTY_COPY_FEEDBACK: GitActionProgress = {
 };
 const COPY_FEEDBACK_DISMISS_MS = 3_000;
+const CommandPaletteContext = createContext<ReactNode>(null);
+/** Render inside the workspace so palette actions share its navigation and pane state. */
+export function HardwareKeyboardCommandOverlay() {
+  return use(CommandPaletteContext);
+}
 export function HardwareKeyboardCommandProvider({
   children,
   pathname,
 }: PropsWithChildren<{ readonly pathname: string }>) {
   const navigation = useNavigation();
+  const [paletteOpen, setPaletteOpen] = useState(false);
+  const closePalette = useCallback(() => setPaletteOpen(false), []);
   const activeThreadRef = useMemo(() => parseActiveThreadPath(pathname), [pathname]);
   const activeThread = useThreadShell(activeThreadRef);
   const copyTarget = useMemo(
 @@ -86,6 +99,12 @@ export function HardwareKeyboardCommandProvider({
   const enabledCommands = useMemo(() => {
     const commands = new Set<HardwareKeyboardCommand>(getRegisteredHardwareKeyboardCommands());
     commands.add("newTask");
+    commands.add("commandPalette");
+    if (pathname !== "/" && !pathname.startsWith("/threads/")) {
+      for (const command of commands) {
+        if (command.startsWith("thread.jump.")) commands.delete(command);
+      }
+    }
     if (pathname !== "/" || navigation.canGoBack()) commands.add("back");
     if (activeThreadRef !== null) {
       commands.add("files");
 @@ -94,10 +113,14 @@ export function HardwareKeyboardCommandProvider({
       if (pathname.split("/")[4] !== "terminal") commands.add("copyThreadReference");
     }
     return [...commands];
-  }, [pathname, registrationVersion, navigation]);
+  }, [activeThreadRef, pathname, registrationVersion, navigation]);
   const onCommand = useCallback(
     (command: HardwareKeyboardCommand) => {
+      if (command === "commandPalette") {
+        setPaletteOpen(true);
+        return;
+      }
       if (dispatchHardwareKeyboardCommand(command)) return;
       if (command === "copyThreadReference") {
 @@ -152,12 +175,20 @@ export function HardwareKeyboardCommandProvider({
     [copyTarget, navigation, pathname, showCopyFeedback],
   );
+  const palette = useMemo(
+    () =>
+      paletteOpen ? (
+        <CommandPalette pathname={pathname} onClose={closePalette} onCommand={onCommand} />
+      ) : null,
+    [closePalette, onCommand, paletteOpen, pathname],
+  );
   return (
-    <>
+    <CommandPaletteContext value={palette}>
       <T3KeyboardCommands enabledCommands={enabledCommands} onCommand={onCommand}>
         {children}
       </T3KeyboardCommands>
       <GitActionProgressOverlay progress={copyFeedback} onDismiss={dismissCopyFeedback} />
-    </>
+    </CommandPaletteContext>
   );
 }

apps/mobile/src/features/keyboard/commandPaletteItems.test.ts created+76

...	@@ -0,0 +1,76 @@
1	import { describe, expect, it } from "vite-plus/test";
2
3	import {
4	filterCommandPaletteItems,
5	nextPaletteIndex,
6	type CommandPaletteItem,
7	} from "./commandPaletteItems";
8
9	function item(
10	key: string,
11	title: string,
12	kind: CommandPaletteItem["kind"],
13	searchTerms: string[] = [],
14	): CommandPaletteItem {
15	return { key, title, kind, searchTerms, run: () => {} };
16	}
17
18	const items = [
19	item("new", "New thread in…", "action", ["project", "create"]),
20	item("settings", "Open settings", "action", ["preferences"]),
21	item("project", "Mobile app", "project", ["/workspaces/mobile", "new thread"]),
22	item("siva:one", "Keyboard shortcuts", "thread", ["Mobile app", "Siva"]),
23	item("mac:one", "Mobile app", "thread", ["Mac"]),
24	];
25	const emptyMatches = new Set<string>();
26
27	describe("filterCommandPaletteItems", () => {
28	it("shows actions and recent threads in their original order when the query is empty", () => {
29	expect(filterCommandPaletteItems(items, "", emptyMatches).map((item) => item.key)).toEqual([
30	"new",
31	"settings",
32	"siva:one",
33	"mac:one",
34	]);
35	});
36
37	it("matches query tokens across titles and metadata and ranks exact titles first", () => {
38	expect(
39	filterCommandPaletteItems(items, " MOBILE app ", emptyMatches).map((item) => item.key),
40	).toEqual(["project", "mac:one", "siva:one"]);
41	expect(
42	filterCommandPaletteItems(items, "siva keyboard", emptyMatches).map((item) => item.key),
43	).toEqual(["siva:one"]);
44	});
45
46	it("supports the desktop actions-only prefix and action aliases", () => {
47	expect(filterCommandPaletteItems(items, ">", emptyMatches).map((item) => item.key)).toEqual([
48	"new",
49	"settings",
50	]);
51	expect(
52	filterCommandPaletteItems(items, "> preferences", emptyMatches).map((item) => item.key),
53	).toEqual(["settings"]);
54	expect(
55	filterCommandPaletteItems(items, "> new thread", emptyMatches).map((item) => item.key),
56	).toEqual(["new"]);
57	});
58
59	it("includes server content matches scoped to the correct environment, except in actions-only mode", () => {
60	const matches = new Set(["siva:one", "project"]);
61	expect(
62	filterCommandPaletteItems(items, "message content", matches).map((item) => item.key),
63	).toEqual(["siva:one"]);
64	expect(filterCommandPaletteItems(items, "> message content", matches)).toEqual([]);
65	});
66	});
67
68	describe("nextPaletteIndex", () => {
69	it("wraps arrow navigation in both directions and handles empty results", () => {
70	expect(nextPaletteIndex(0, -1, 3)).toBe(2);
71	expect(nextPaletteIndex(2, 1, 3)).toBe(0);
72	expect(nextPaletteIndex(0, 1, 3)).toBe(1);
73	expect(nextPaletteIndex(0, -1, 0)).toBe(0);
74	expect(nextPaletteIndex(0, 1, 0)).toBe(0);
75	});
76	});

apps/mobile/src/features/keyboard/commandPaletteItems.ts created+46

...	@@ -0,0 +1,46 @@
1	export interface CommandPaletteItem {
2	readonly key: string;
3	readonly kind: "action" \| "project" \| "thread";
4	readonly title: string;
5	readonly detail?: string;
6	readonly searchTerms: ReadonlyArray<string>;
7	readonly run: () => void;
8	}
9
10	/** `>` narrows to actions, matching the desktop palette. Stable ties retain recent-thread order. */
11	export function filterCommandPaletteItems(
12	items: ReadonlyArray<CommandPaletteItem>,
13	query: string,
14	matchedThreadKeys: ReadonlySet<string>,
15	) {
16	const actionsOnly = query.startsWith(">");
17	const normalized = (actionsOnly ? query.slice(1) : query).trim().toLocaleLowerCase();
18	const tokens = normalized.split(/\s+/);
19	return items
20	.flatMap((item, index) => {
21	if (actionsOnly && item.kind !== "action") return [];
22	if (!normalized) return item.kind === "project" ? [] : [{ item, rank: 0, index }];
23	const title = item.title.toLocaleLowerCase();
24	const haystack = [title, ...item.searchTerms].join(" ").toLocaleLowerCase();
25	if (
26	!tokens.every((token) => haystack.includes(token)) &&
27	!(item.kind === "thread" && matchedThreadKeys.has(item.key))
28	)
29	return [];
30	const rank =
31	title === normalized
32	? 3
33	: title.startsWith(normalized)
34	? 2
35	: title.includes(normalized)
36	? 1
37	: 0;
38	return [{ item, rank, index }];
39	})
40	.sort((left, right) => right.rank - left.rank \|\| left.index - right.index)
41	.map(({ item }) => item);
42	}
43
44	export function nextPaletteIndex(index: number, direction: -1 \| 1, count: number) {
45	return count === 0 ? 0 : (index + direction + count) % count;
46	}

apps/mobile/src/features/keyboard/hardwareKeyboardCommands.ts+20-9

 @@ -1,7 +1,12 @@
-import { EnvironmentId, ThreadId } from "@t3tools/contracts";
+import { EnvironmentId, ThreadId, type ThreadJumpKeybindingCommand } from "@t3tools/contracts";
 import { useEffect } from "react";
 export type HardwareKeyboardCommand =
+  | ThreadJumpKeybindingCommand
+  | "commandPalette"
+  | "paletteNext"
+  | "palettePrevious"
+  | "paletteDismiss"
   | "newTask"
   | "focusSearch"
   | "back"
 @@ -11,7 +16,7 @@ export type HardwareKeyboardCommand =
   | "copyThreadReference"
   | "toggleSidebar";
-type CommandHandler = () => boolean | void;
+type CommandHandler = (command: HardwareKeyboardCommand) => boolean | void;
 const handlers = new Map<HardwareKeyboardCommand, Set<CommandHandler>>();
 const registrationListeners = new Set<() => void>();
 @@ -22,18 +27,24 @@ let registrationVersion = 0;
  * the first chance to consume the command, allowing focused screens to override app defaults.
  */
 export function useHardwareKeyboardCommand(
-  command: HardwareKeyboardCommand,
+  command: HardwareKeyboardCommand | ReadonlyArray<HardwareKeyboardCommand>,
   handler: CommandHandler,
 ): void {
   useEffect(() => {
-    const commandHandlers = handlers.get(command) ?? new Set<CommandHandler>();
+    const commands = typeof command === "string" ? [command] : command;
-    commandHandlers.add(handler);
+    for (const command of commands) {
-    handlers.set(command, commandHandlers);
+      const commandHandlers = handlers.get(command) ?? new Set<CommandHandler>();
+      commandHandlers.add(handler);
+      handlers.set(command, commandHandlers);
+    }
     registrationVersion += 1;
     registrationListeners.forEach((listener) => listener());
     return () => {
-      commandHandlers.delete(handler);
+      for (const command of commands) {
-      if (commandHandlers.size === 0) handlers.delete(command);
+        const commandHandlers = handlers.get(command);
+        commandHandlers?.delete(handler);
+        if (commandHandlers?.size === 0) handlers.delete(command);
+      }
       registrationVersion += 1;
       registrationListeners.forEach((listener) => listener());
     };
 @@ -58,7 +69,7 @@ export function dispatchHardwareKeyboardCommand(command: HardwareKeyboardCommand
   if (!commandHandlers) return false;
   // `.reverse()` on a copy, not `.toReversed()`: Hermes has no ES2023 array methods.
   for (const handler of [...commandHandlers].reverse()) {
-    if (handler() !== false) return true;
+    if (handler(command) !== false) return true;
   }
   return false;
 }

apps/mobile/src/features/keyboard/threadKeyboardShortcuts.ts created+49

...	@@ -0,0 +1,49 @@
1	import type { EnvironmentThreadShell } from "@t3tools/client-runtime/state/shell";
2	import { THREAD_JUMP_KEYBINDING_COMMANDS } from "@t3tools/contracts";
3	import { useCallback } from "react";
4
5	import type { HomeListItem } from "../home/homeListItems";
6	import type { ThreadListV2ListItem } from "../threads/threadListV2";
7	import {
8	useHardwareKeyboardCommand,
9	type HardwareKeyboardCommand,
10	} from "./hardwareKeyboardCommands";
11
12	type ThreadShortcutListItem =
13	\| HomeListItem
14	\| ThreadListV2ListItem
15	\| { readonly type: "v2-show-more" };
16
17	export function threadJumpIndex(command: HardwareKeyboardCommand) {
18	return THREAD_JUMP_KEYBINDING_COMMANDS.findIndex((candidate) => candidate === command);
19	}
20
21	/** Uses the rendered list so filters, collapsed groups and shelves keep their order. */
22	export function threadJumpTarget(
23	items: ReadonlyArray<ThreadShortcutListItem>,
24	command: HardwareKeyboardCommand,
25	) {
26	let index = threadJumpIndex(command);
27	if (index < 0) return null;
28	for (const item of items) {
29	const thread =
30	item.type === "thread" ? item.thread : item.type === "v2-thread" ? item.item.thread : null;
31	if (thread !== null && index-- === 0) return thread;
32	}
33	return null;
34	}
35
36	export function useThreadJumpShortcuts(
37	items: ReadonlyArray<ThreadShortcutListItem>,
38	onSelectThread: (thread: EnvironmentThreadShell) => void,
39	) {
40	const jumpToThread = useCallback(
41	(command: HardwareKeyboardCommand) => {
42	const thread = threadJumpTarget(items, command);
43	if (thread !== null) onSelectThread(thread);
44	return true;
45	},
46	[items, onSelectThread],
47	);
48	useHardwareKeyboardCommand(THREAD_JUMP_KEYBINDING_COMMANDS, jumpToThread);
49	}

apps/mobile/src/features/layout/AdaptiveWorkspaceLayout.tsx+52-31

 @@ -6,6 +6,7 @@ import { EnvironmentId, ThreadId, type SidebarProjectGroupingMode } from "@t3too
 import { useAtomValue } from "@effect/atom-react";
 import { useFocusEffect } from "@react-navigation/native";
 import {
+  CommonActions,
   NavigationContext,
   NavigationRouteContext,
   StackActions,
 @@ -39,7 +40,10 @@ import {
   type WorkspaceAuxiliaryPaneRole,
   type WorkspacePaneLayout,
 } from "../../lib/layout";
-import { resolveThreadSelectionNavigationAction } from "../../lib/adaptive-navigation";
+import {
+  resolveThreadSelectionNavigationAction,
+  resolveThreadSelectionOverlayState,
+} from "../../lib/adaptive-navigation";
 import { scopedThreadKey } from "../../lib/scopedEntities";
 import { mobilePreferencesAtom } from "../../state/preferences";
 import {
 @@ -63,6 +67,7 @@ interface AdaptiveWorkspaceContextValue {
   readonly panes: WorkspacePaneLayout;
   readonly fileInspector: FileInspectorPaneLayout;
   readonly primarySidebarSearchQuery: string;
+  readonly selectThread: (thread: EnvironmentThreadShell) => void;
   readonly activateAuxiliaryPaneRole: (role: WorkspaceAuxiliaryPaneRole) => () => void;
   /**
    * Route screens hand their inspector pane content to the workspace so it
 @@ -96,6 +101,7 @@ const AdaptiveWorkspaceContext = createContext<AdaptiveWorkspaceContextValue>({
   panes: compactPanes,
   fileInspector: compactFileInspector,
   primarySidebarSearchQuery: "",
+  selectThread: () => undefined,
   activateAuxiliaryPaneRole: () => () => undefined,
   registerWorkspaceInspector: () => () => undefined,
   setPrimarySidebarSearchQuery: () => undefined,
 @@ -198,6 +204,7 @@ export function useRegisterWorkspaceInspector(render: (() => ReactNode) | undefi
 export function AdaptiveWorkspaceLayout(props: {
   readonly children: ReactNode;
   readonly pathname: string;
+  readonly workspaceRouteKey: string | undefined;
 }) {
   const preferencesResult = useAtomValue(mobilePreferencesAtom);
   if (!AsyncResult.isSuccess(preferencesResult)) {
 @@ -221,6 +228,7 @@ function AdaptiveWorkspaceLayoutContent(
   props: {
     readonly children: ReactNode;
     readonly pathname: string;
+    readonly workspaceRouteKey: string | undefined;
   } & {
     readonly projectGroupingMode: SidebarProjectGroupingMode;
   },
 @@ -408,35 +416,6 @@ function AdaptiveWorkspaceLayoutContent(
     },
     [auxiliaryPaneRole],
   );
-  const contextValue = useMemo(
-    () => ({
-      layout,
-      panes,
-      fileInspector,
-      primarySidebarSearchQuery,
-      activateAuxiliaryPaneRole,
-      registerWorkspaceInspector,
-      setPrimarySidebarSearchQuery,
-      showAuxiliaryPane,
-      toggleAuxiliaryPane,
-      togglePrimarySidebar,
-      setAuxiliaryPaneWidth,
-    }),
-    [
-      activateAuxiliaryPaneRole,
-      fileInspector,
-      layout,
-      panes,
-      primarySidebarSearchQuery,
-      registerWorkspaceInspector,
-      showAuxiliaryPane,
-      setPrimarySidebarSearchQuery,
-      setAuxiliaryPaneWidth,
-      toggleAuxiliaryPane,
-      togglePrimarySidebar,
-    ],
-  );
   const handleOpenSettings = useCallback(() => {
     navigation.navigate("SettingsSheet", {
       screen: "SettingsContent",
 @@ -526,6 +505,17 @@ function AdaptiveWorkspaceLayoutContent(
         usesSplitView: layout.usesSplitView,
         pathname,
       });
+      const overlayState = resolveThreadSelectionOverlayState({
+        state: navigation.getState(),
+        workspaceRouteKey: props.workspaceRouteKey,
+        action: navigationAction,
+        params,
+      });
+      if (overlayState !== null) {
+        setFileInspectorPreferredVisible(false);
+        navigation.dispatch(CommonActions.reset(overlayState));
+        return;
+      }
       if (navigationAction === "set-params") {
         const nextThreadKey = scopedThreadKey(thread.environmentId, thread.id);
         if (nextThreadKey === selectedThreadKey) {
 @@ -542,7 +532,38 @@ function AdaptiveWorkspaceLayoutContent(
       }
       navigation.navigate("Thread", params);
     },
-    [layout.usesSplitView, pathname, navigation, selectedThreadKey],
+    [layout.usesSplitView, pathname, navigation, selectedThreadKey, props.workspaceRouteKey],
+  );
+  const contextValue = useMemo(
+    () => ({
+      layout,
+      panes,
+      fileInspector,
+      primarySidebarSearchQuery,
+      selectThread: handleSelectThread,
+      activateAuxiliaryPaneRole,
+      registerWorkspaceInspector,
+      setPrimarySidebarSearchQuery,
+      showAuxiliaryPane,
+      toggleAuxiliaryPane,
+      togglePrimarySidebar,
+      setAuxiliaryPaneWidth,
+    }),
+    [
+      activateAuxiliaryPaneRole,
+      fileInspector,
+      handleSelectThread,
+      layout,
+      panes,
+      primarySidebarSearchQuery,
+      registerWorkspaceInspector,
+      showAuxiliaryPane,
+      setPrimarySidebarSearchQuery,
+      setAuxiliaryPaneWidth,
+      toggleAuxiliaryPane,
+      togglePrimarySidebar,
+    ],
   );
   return (

apps/mobile/src/features/layout/workspace-pane-divider.tsx+3-6

 @@ -20,7 +20,6 @@ interface WorkspacePaneDividerProps {
 export function WorkspacePaneDivider(props: WorkspacePaneDividerProps) {
   const latestProps = useRef(props);
   latestProps.current = props;
-  const [hovered, setHovered] = useState(false);
   const [dragging, setDragging] = useState(false);
   const handleResizeStart = useCallback(() => {
     setDragging(true);
 @@ -63,7 +62,7 @@ export function WorkspacePaneDivider(props: WorkspacePaneDividerProps) {
   return (
     <GestureDetector gesture={resizeGesture}>
       <Pressable
-        className="relative z-[100] -mx-[22px] w-11 self-stretch cursor-pointer justify-center"
+        className="relative z-[100] -mx-[22px] w-11 self-stretch justify-center"
         accessibilityActions={[
           { name: "increment", label: "Make pane wider" },
           { name: "decrement", label: "Make pane narrower" },
 @@ -75,15 +74,13 @@ export function WorkspacePaneDivider(props: WorkspacePaneDividerProps) {
           text: `${Math.round(props.currentWidth)} points wide`,
         }}
         onAccessibilityAction={handleAccessibilityAction}
-        onHoverIn={() => setHovered(true)}
-        onHoverOut={() => setHovered(false)}
       >
         <View
           className={cn(
             "h-full self-center bg-border opacity-70",
-            hovered || dragging ? "w-0.5 bg-primary opacity-100" : "w-px",
+            dragging ? "w-0.5 bg-primary opacity-100" : "w-px",
           )}
-          style={[styles.line, (hovered || dragging) && styles.activeLine]}
+          style={[styles.line, dragging && styles.activeLine]}
         />
       </Pressable>
     </GestureDetector>

apps/mobile/src/features/settings/SettingsKeyboardRouteScreen.tsx created+101

...	@@ -0,0 +1,101 @@
1	import { useAtomSet, useAtomValue } from "@effect/atom-react";
2	import { useNavigation } from "@react-navigation/native";
3	import { AsyncResult } from "effect/unstable/reactivity";
4	import { Platform, Pressable, ScrollView, View } from "react-native";
5	import { useSafeAreaInsets } from "react-native-safe-area-context";
6
7	import { AndroidScreenHeader } from "../../components/AndroidScreenHeader";
8	import { AppText as Text } from "../../components/AppText";
9	import { SymbolView } from "../../components/AppSymbol";
10	import { NativeStackScreenOptions } from "../../native/StackHeader";
11	import {
12	DEFAULT_COMPOSER_ENTER_BEHAVIOR,
13	type ComposerEnterBehavior,
14	} from "../../lib/composerEnterBehavior";
15	import { mobilePreferencesAtom, updateMobilePreferencesAtom } from "../../state/preferences";
16	import { SettingsSection } from "./components/SettingsSection";
17
18	const ENTER_BEHAVIOR_OPTIONS: ReadonlyArray<{
19	readonly behavior: ComposerEnterBehavior;
20	readonly label: string;
21	readonly description: string;
22	}> = [
23	{
24	behavior: "send",
25	label: "Send message",
26	description: "Return sends the message. Shift-Return inserts a new line.",
27	},
28	{
29	behavior: "newline",
30	label: "Insert new line",
31	description: "Return inserts a new line. Command-Return sends the message.",
32	},
33	];
34
35	export function SettingsKeyboardRouteScreen() {
36	const navigation = useNavigation();
37	const insets = useSafeAreaInsets();
38	const preferencesResult = useAtomValue(mobilePreferencesAtom);
39	const savePreferences = useAtomSet(updateMobilePreferencesAtom);
40	const preferencesReady = AsyncResult.isSuccess(preferencesResult) && !preferencesResult.waiting;
41	const selectedBehavior = AsyncResult.isSuccess(preferencesResult)
42	? (preferencesResult.value.composerEnterBehavior ?? DEFAULT_COMPOSER_ENTER_BEHAVIOR)
43	: null;
44
45	return (
46	<View collapsable={false} className="flex-1 bg-sheet">
47	{Platform.OS === "android" ? (
48	<>
49	<NativeStackScreenOptions options={{ headerShown: false }} />
50	<AndroidScreenHeader title="Keyboard" onBack={() => navigation.goBack()} />
51	</>
52	) : null}
53	<ScrollView
54	contentInsetAdjustmentBehavior="automatic"
55	showsVerticalScrollIndicator={false}
56	className="flex-1"
57	contentContainerClassName="gap-3 px-5 pt-4"
58	contentContainerStyle={{ paddingBottom: Math.max(insets.bottom, 18) + 18 }}
59	>
60	<SettingsSection title="Return key">
61	{ENTER_BEHAVIOR_OPTIONS.map((option, index) => (
62	<Pressable
63	key={option.behavior}
64	accessibilityRole="radio"
65	accessibilityState={{
66	checked: selectedBehavior === option.behavior,
67	disabled: !preferencesReady,
68	}}
69	disabled={!preferencesReady}
70	onPress={() => savePreferences({ composerEnterBehavior: option.behavior })}
71	className={
72	index === 0
73	? "flex-row items-center gap-4 p-4"
74	: "flex-row items-center gap-4 border-t border-border-subtle p-4"
75	}
76	>
77	<View className="min-w-0 flex-1 gap-1">
78	<Text className="text-lg text-foreground">{option.label}</Text>
79	<Text className="text-sm leading-normal text-foreground-muted">
80	{option.description}
81	</Text>
82	</View>
83	{selectedBehavior === option.behavior ? (
84	<SymbolView
85	name="checkmark"
86	size={18}
87	tintColorClassName={"accent-icon"}
88	type="monochrome"
89	weight="semibold"
90	/>
91	) : null}
92	</Pressable>
93	))}
94	</SettingsSection>
95	<Text className="px-2 text-sm text-foreground-muted">
96	Applies to the composer when a hardware keyboard is connected.
97	</Text>
98	</ScrollView>
99	</View>
100	);
101	}

apps/mobile/src/features/settings/SettingsRouteScreen.tsx+3

 @@ -598,6 +598,9 @@ function GeneralSettingsSection() {
   return (
     <SettingsSection title="General">
       <SettingsRow icon="folder" label="Project Grouping" target="SettingsProjectGrouping" />
+      {Platform.OS === "ios" ? (
+        <SettingsRow icon="keyboard" label="Keyboard" target="SettingsKeyboard" />
+      ) : null}
       <AutoSettleSettingsRows />
       <SettingsRow icon="chart.bar.xaxis" label="Usage" target="SettingsUsage" />
     </SettingsSection>

apps/mobile/src/features/settings/components/settings-sheet-targets.ts+1

...	@@ -2,6 +2,7 @@ export type SettingsSheetTarget =	...	@@ -2,6 +2,7 @@ export type SettingsSheetTarget =
2	\| "SettingsEnvironments"	2	\| "SettingsEnvironments"
3	\| "SettingsArchive"	3	\| "SettingsArchive"
4	\| "SettingsAppearance"	4	\| "SettingsAppearance"
		5	\| "SettingsKeyboard"
5	\| "SettingsProjectGrouping"	6	\| "SettingsProjectGrouping"
6	\| "SettingsClientStorage"	7	\| "SettingsClientStorage"
7	\| "SettingsDiagnostics"	8	\| "SettingsDiagnostics"

apps/mobile/src/features/threads/NewTaskDraftScreen.tsx+3

 @@ -1396,6 +1396,9 @@ export function NewTaskDraftScreen(props: {
         skills={composerMenu.skills}
         selection={composerMenu.selection}
         onChangeText={flow.setPrompt}
+        onSubmit={() => {
+          if (canStart) void handleStart();
+        }}
         onSelectionChange={composerMenu.onSelectionChange}
         onFocus={() => setIsComposerFocused(true)}
         onBlur={() => setIsComposerFocused(false)}

apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx+2

...	@@ -38,6 +38,7 @@ import { useQueuedThreadKeys } from "../../state/use-thread-outbox";	...	@@ -38,6 +38,7 @@ import { useQueuedThreadKeys } from "../../state/use-thread-outbox";
38	import { useWorkspaceState } from "../../state/workspace";	38	import { useWorkspaceState } from "../../state/workspace";
39	import { useSavedRemoteConnections } from "../../state/use-remote-environment-registry";	39	import { useSavedRemoteConnections } from "../../state/use-remote-environment-registry";
40	import { useHardwareKeyboardCommand } from "../keyboard/hardwareKeyboardCommands";	40	import { useHardwareKeyboardCommand } from "../keyboard/hardwareKeyboardCommands";
		41	import { useThreadJumpShortcuts } from "../keyboard/threadKeyboardShortcuts";
41	import {	42	import {
42	hasCustomHomeListOptions,	43	hasCustomHomeListOptions,
43	PROJECT_SORT_OPTIONS,	44	PROJECT_SORT_OPTIONS,
...	@@ -801,6 +802,7 @@ function ThreadNavigationSidebarPane(	...	@@ -801,6 +802,7 @@ function ThreadNavigationSidebarPane(
801	threadSearchMatchByKey,	802	threadSearchMatchByKey,
802	],	803	],
803	);	804	);
		805	useThreadJumpShortcuts(listItems, handleSelectThread);
804	const sidebarItemsAreEqual = useCallback(	806	const sidebarItemsAreEqual = useCallback(
805	(previous: SidebarListItem, item: SidebarListItem): boolean => {	807	(previous: SidebarListItem, item: SidebarListItem): boolean => {
806	if (previous.type === "v2-thread" && item.type === "v2-thread") {	808	if (previous.type === "v2-thread" && item.type === "v2-thread") {

apps/mobile/src/features/threads/thread-list-items.tsx+32-32

 @@ -1,4 +1,3 @@
-import { useRecyclingState } from "@legendapp/list/react-native";
 import type {
   EnvironmentProject,
   EnvironmentThreadShell,
 @@ -13,6 +12,7 @@ import type { SwipeableMethods } from "react-native-gesture-handler/ReanimatedSw
 import { useAppearancePreferences } from "../settings/appearance/AppearancePreferencesProvider";
 import Svg, { Circle, Path } from "react-native-svg";
+import { RowPressable } from "../../components/RowPressable";
 import { AppText as Text } from "../../components/AppText";
 import { ControlPillMenu } from "../../components/ControlPill";
 import { EnvironmentMachineSymbol } from "../../components/EnvironmentMachineSymbol";
 @@ -20,7 +20,6 @@ import { ProjectFavicon } from "../../components/ProjectFavicon";
 import { cn } from "../../lib/cn";
 import { HOME_HORIZONTAL_INSET } from "../../lib/layoutMetrics";
 import { relativeTime } from "../../lib/time";
-import { themeColorWithAlpha } from "../../lib/mobileTheme";
 import { useUniwindTheme } from "../../lib/useUniwindTheme";
 import type { PendingNewTask } from "../../state/use-pending-new-tasks";
 import { useThreadPr, type ThreadPrPresentation } from "../../state/use-thread-pr";
 @@ -358,11 +357,12 @@ export const PendingTaskListRow = memo(function PendingTaskListRow(props: {
     : "Sends when the environment reconnects. Opens the task for editing";
   const rowContent = compact ? (
-    <Pressable
+    <RowPressable
+      key={pendingTask.key}
       accessibilityHint={accessibilityHint}
       accessibilityLabel={pendingTask.title}
       accessibilityRole="button"
-      className="bg-screen active:opacity-70"
+      className="bg-screen"
       onPress={() => onSelectPendingTask(pendingTask)}
     >
       <View className="pr-[18px] pt-[10px]" style={{ paddingLeft: THREAD_LIST_COMPACT_INSET }}>
 @@ -387,17 +387,16 @@ export const PendingTaskListRow = memo(function PendingTaskListRow(props: {
           {subtitleRow}
         </View>
       </View>
-    </Pressable>
+    </RowPressable>
   ) : (
-    <Pressable
+    <RowPressable
+      key={pendingTask.key}
       accessibilityHint={accessibilityHint}
       accessibilityLabel={pendingTask.title}
       accessibilityRole="button"
-      className="active:bg-subtle"
       onPress={() => onSelectPendingTask(pendingTask)}
       style={{
         borderRadius: SIDEBAR_ROW_RADIUS,
-        cursor: "pointer",
         minHeight: 64,
         justifyContent: "center",
         paddingHorizontal: 12,
 @@ -420,7 +419,7 @@ export const PendingTaskListRow = memo(function PendingTaskListRow(props: {
         </View>
         {subtitleRow}
       </View>
-    </Pressable>
+    </RowPressable>
   );
   return (
 @@ -472,14 +471,9 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
   const compact = props.variant === "compact";
   const selected = props.selected === true;
   const visuallySelected = selected && (!compact || materialYouStyleLayoutActive);
-  // Recycling-safe: resets when the list container is reused for another
-  // thread, so a hover highlight can't leak across rows.
-  const [hovered, setHovered] = useRecyclingState(false);
   const theme = useUniwindTheme();
   const screenColor = theme["--color-screen"];
   const drawerColor = theme["--color-drawer"];
-  const pressedBackgroundColor = theme["--color-subtle"];
   const selectedBackgroundColor = theme["--color-user-bubble"];
   const materialSelectedBackgroundColor = theme["--color-thread-selected"];
   const materialSelectedForegroundColor = theme["--color-thread-selected-foreground"];
 @@ -516,9 +510,6 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
   const effectiveSelectedForeground = materialYouStyleLayoutActive
     ? materialSelectedForegroundColor
     : selectedForegroundColor;
-  const effectivePressedBackground = visuallySelected
-    ? themeColorWithAlpha(String(effectiveSelectedForeground), 0.16)
-    : pressedBackgroundColor;
   const effectiveStatus =
     visuallySelected && status
       ? {
 @@ -665,11 +656,19 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
   const rowContent = (close: () => void) =>
     compact ? (
-      <Pressable
+      <RowPressable
+        key={`${thread.environmentId}:${thread.id}`}
+        interactionClassName={
+          visuallySelected
+            ? materialYouStyleLayoutActive
+              ? "bg-thread-selected-foreground"
+              : "bg-user-bubble-foreground"
+            : "bg-primary"
+        }
         accessibilityHint="Swipe left for archive and delete actions"
         accessibilityLabel={threadAccessibilityLabel}
         accessibilityRole="button"
-        className="bg-screen active:opacity-70"
+        className="bg-screen"
         style={
           materialYouStyleLayoutActive
             ? {
 @@ -735,32 +734,33 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
             {subtitleRow}
           </View>
         </View>
-      </Pressable>
+      </RowPressable>
     ) : (
-      <Pressable
+      <RowPressable
+        key={`${thread.environmentId}:${thread.id}`}
+        interactionClassName={
+          visuallySelected
+            ? materialYouStyleLayoutActive
+              ? "bg-thread-selected-foreground"
+              : "bg-user-bubble-foreground"
+            : "bg-primary"
+        }
         accessibilityHint="Opens the thread"
         accessibilityLabel={threadAccessibilityLabel}
         accessibilityRole="button"
         accessibilityState={{ selected }}
-        onHoverIn={() => setHovered(true)}
-        onHoverOut={() => setHovered(false)}
         onPress={() => {
           close();
           onSelectThread(thread);
         }}
-        style={({ pressed }) => ({
+        style={{
-          backgroundColor: visuallySelected
+          backgroundColor: visuallySelected ? effectiveSelectedBackground : backgroundColor,
-            ? effectiveSelectedBackground
-            : pressed || hovered
-              ? effectivePressedBackground
-              : backgroundColor,
           borderRadius: SIDEBAR_ROW_RADIUS,
-          cursor: "pointer",
           minHeight: 64,
           justifyContent: "center",
           paddingHorizontal: 12,
           paddingVertical: 10,
-        })}
+        }}
       >
         <View className="gap-[3px]">
           <View className="flex-row items-center justify-between gap-2">
 @@ -806,7 +806,7 @@ export const ThreadListRow = memo(function ThreadListRow(props: {
           ) : null}
           {subtitleRow}
         </View>
-      </Pressable>
+      </RowPressable>
     );
   return (

apps/mobile/src/features/threads/thread-list-v2-items.tsx+41-27

 @@ -1,3 +1,4 @@
+import { RowPressable } from "../../components/RowPressable";
 import { CustomSnoozeSheet } from "./CustomSnoozeSheet";
 import { useAppearancePreferences } from "../settings/appearance/AppearancePreferencesProvider";
 import { appAtomRegistry } from "../../state/atom-registry";
 @@ -302,7 +303,7 @@ export const ThreadListV2PendingRow = memo(function ThreadListV2PendingRow(props
         onPressAction={handleMenuAction}
         shouldOpenOnLongPress
       >
-        <Pressable
+        <RowPressable
           accessibilityHint={
             isDraft
               ? "Opens the draft in the new task composer"
 @@ -310,7 +311,8 @@ export const ThreadListV2PendingRow = memo(function ThreadListV2PendingRow(props
           }
           accessibilityLabel={pendingTask.title}
           accessibilityRole="button"
-          className={sidebarPane ? "bg-drawer active:bg-subtle" : undefined}
+          key={pendingTask.key}
+          className={sidebarPane ? "bg-drawer" : "bg-screen"}
           onPress={() => onSelectPendingTask(pendingTask)}
           style={
             sidebarPane
 @@ -319,20 +321,20 @@ export const ThreadListV2PendingRow = memo(function ThreadListV2PendingRow(props
                   paddingHorizontal: 12,
                   paddingVertical: 10,
                 }
-              : ({ pressed }) => ({ opacity: pressed ? 0.7 : 1 })
+              : undefined
           }
         >
           {sidebarPane ? (
             rowContent
           ) : (
-            <View className="bg-screen">
+            <View>
               <View className="px-5 py-2.5">{rowContent}</View>
               {props.showTrailingDivider !== false ? (
                 <View className="ml-5 h-px bg-border-subtle" />
               ) : null}
             </View>
           )}
-        </Pressable>
+        </RowPressable>
       </ControlPillMenu>
     </>
   );
 @@ -441,7 +443,6 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
   const theme = useUniwindTheme();
   const screenColor = theme["--color-screen"];
   const drawerColor = theme["--color-drawer"];
-  const pressedBackgroundColor = theme["--color-subtle"];
   const selectedBackgroundColor =
     theme[materialYouStyleLayoutActive ? "--color-thread-selected" : "--color-user-bubble"];
   const sidebarPane = props.pane === "sidebar";
 @@ -930,7 +931,16 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
   const rowContent = (close: () => void) =>
     variant === "card" ? (
-      <Pressable
+      <RowPressable
+        key={`${thread.environmentId}:${thread.id}`}
+        interactionClassName={
+          selected && (sidebarPane || materialYouStyleLayoutActive)
+            ? materialYouStyleLayoutActive
+              ? "bg-thread-selected-foreground"
+              : "bg-user-bubble-foreground"
+            : "bg-primary"
+        }
+        className={sidebarPane || materialYouStyleLayoutActive ? undefined : "bg-screen"}
         accessibilityHint={swipeAccessibilityHint}
         accessibilityLabel={
           props.hasQueuedMessages ? `${thread.title}, messages queued to send` : thread.title
 @@ -943,18 +953,16 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
         }}
         style={
           sidebarPane || materialYouStyleLayoutActive
-            ? ({ pressed }) => ({
+            ? {
                 backgroundColor: selected
                   ? selectedBackgroundColor
-                  : pressed
+                  : sidebarPane
-                    ? pressedBackgroundColor
+                    ? drawerColor
-                    : sidebarPane
+                    : screenColor,
-                      ? drawerColor
-                      : screenColor,
                 borderRadius: SIDEBAR_V2_ROW_RADIUS,
                 ...(sidebarPane ? { paddingHorizontal: 12, paddingVertical: 10 } : null),
-              })
+              }
-            : ({ pressed }) => ({ opacity: pressed ? 0.7 : 1 })
+            : undefined
         }
       >
         {sidebarPane ? (
 @@ -964,16 +972,24 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
              labels and text hierarchy carry state, an inset hairline
              separates rows. The opaque screen background stays so swipe
              actions reveal behind the row. */
-          <View className={materialYouStyleLayoutActive ? undefined : "bg-screen"}>
+          <View>
             <View className="px-5 py-2.5">{cardContent}</View>
             {props.showTrailingDivider !== false ? (
               <View className="ml-5 h-px bg-border-subtle" />
             ) : null}
           </View>
         )}
-      </Pressable>
+      </RowPressable>
     ) : (
-      <Pressable
+      <RowPressable
+        key={`${thread.environmentId}:${thread.id}`}
+        interactionClassName={
+          selected && (sidebarPane || materialYouStyleLayoutActive)
+            ? materialYouStyleLayoutActive
+              ? "bg-thread-selected-foreground"
+              : "bg-user-bubble-foreground"
+            : "bg-primary"
+        }
         accessibilityHint={swipeAccessibilityHint}
         accessibilityLabel={
           props.hasQueuedMessages ? `${thread.title}, messages queued to send` : thread.title
 @@ -987,17 +1003,15 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
         }}
         style={
           sidebarPane || materialYouStyleLayoutActive
-            ? ({ pressed }) => ({
+            ? {
                 backgroundColor: selected
                   ? selectedBackgroundColor
-                  : pressed
+                  : sidebarPane
-                    ? pressedBackgroundColor
+                    ? drawerColor
-                    : sidebarPane
+                    : screenColor,
-                      ? drawerColor
-                      : screenColor,
                 borderRadius: SIDEBAR_V2_ROW_RADIUS,
-              })
+              }
-            : ({ pressed }) => ({ opacity: pressed ? 0.7 : 1 })
+            : undefined
         }
       >
         {/* Settled history recedes: dimmed favicon + muted title. */}
 @@ -1059,7 +1073,7 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
               : timeLabel}
           </Text>
         </View>
-      </Pressable>
+      </RowPressable>
     );
   return (

apps/mobile/src/features/threads/threadListV2.test.ts+4

...	@@ -22,6 +22,7 @@ import {	...	@@ -22,6 +22,7 @@ import {
22	import { describe, expect, it } from "vite-plus/test";	22	import { describe, expect, it } from "vite-plus/test";
23		23
24	import type { PendingNewTask } from "../../state/use-pending-new-tasks";	24	import type { PendingNewTask } from "../../state/use-pending-new-tasks";
		25	import { threadJumpTarget } from "../keyboard/threadKeyboardShortcuts";
25	import {	26	import {
26	buildThreadListV2Items,	27	buildThreadListV2Items,
27	buildThreadListV2ListItems,	28	buildThreadListV2ListItems,
...	@@ -1050,6 +1051,9 @@ describe("buildThreadListV2ListItems", () => {	...	@@ -1050,6 +1051,9 @@ describe("buildThreadListV2ListItems", () => {
1050	"v2-settled-shelf",	1051	"v2-settled-shelf",
1051	"v2-thread",	1052	"v2-thread",
1052	]);	1053	]);
		1054	expect(threadJumpTarget(items, "thread.jump.1")?.id).toBe("active");
		1055	expect(threadJumpTarget(items, "thread.jump.2")?.id).toBe("settled");
		1056	expect(threadJumpTarget(items, "thread.jump.3")).toBeNull();
1053	});	1057	});
1054	});	1058	});
1055		1059

apps/mobile/src/lib/adaptive-navigation.test.ts+70

...	@@ -4,6 +4,7 @@ import {	...	@@ -4,6 +4,7 @@ import {
4	isBaseThreadRoute,	4	isBaseThreadRoute,
5	resolveFileSelectionNavigationAction,	5	resolveFileSelectionNavigationAction,
6	resolveThreadSelectionNavigationAction,	6	resolveThreadSelectionNavigationAction,
		7	resolveThreadSelectionOverlayState,
7	} from "./adaptive-navigation";	8	} from "./adaptive-navigation";
8		9
9	describe("isBaseThreadRoute", () => {	10	describe("isBaseThreadRoute", () => {
...	@@ -66,3 +67,72 @@ describe("resolveFileSelectionNavigationAction", () => {	...	@@ -66,3 +67,72 @@ describe("resolveFileSelectionNavigationAction", () => {
66	);	67	);
67	});	68	});
68	});	69	});
		70
		71	describe("resolveThreadSelectionOverlayState", () => {
		72	const stack = {
		73	key: "workspace",
		74	type: "stack",
		75	stale: false as const,
		76	routeNames: ["Home", "Thread", "ThreadFiles", "SettingsSheet", "SettingsLegal"],
		77	};
		78	const home = { key: "home", name: "Home" };
		79	const thread = {
		80	key: "thread",
		81	name: "Thread",
		82	params: { environmentId: "environment", threadId: "old-thread" },
		83	};
		84	const files = { key: "files", name: "ThreadFiles", params: thread.params };
		85	const settings = { key: "settings", name: "SettingsSheet" };
		86	const params = { environmentId: "environment", threadId: "new-thread" };
		87
		88	it("replaces the underlying file route and dismisses every overlay above it", () => {
		89	expect(
		90	resolveThreadSelectionOverlayState({
		91	state: {
		92	...stack,
		93	index: 4,
		94	routes: [home, thread, files, settings, { key: "legal", name: "SettingsLegal" }],
		95	},
		96	workspaceRouteKey: files.key,
		97	action: "replace",
		98	params,
		99	}),
		100	).toEqual({ ...stack, index: 2, routes: [home, thread, { name: "Thread", params }] });
		101	});
		102
		103	it("dismisses an overlay when selecting the current thread without replacing its route key", () => {
		104	expect(
		105	resolveThreadSelectionOverlayState({
		106	state: { ...stack, index: 2, routes: [home, thread, settings] },
		107	workspaceRouteKey: thread.key,
		108	action: "set-params",
		109	params: thread.params,
		110	}),
		111	).toEqual({ ...stack, index: 1, routes: [home, thread] });
		112	});
		113
		114	it.each([home, files])(
		115	"keeps $name in the back stack when pushing from beneath a sheet",
		116	(route) => {
		117	expect(
		118	resolveThreadSelectionOverlayState({
		119	state: { ...stack, index: 1, routes: [route, settings] },
		120	workspaceRouteKey: route.key,
		121	action: "push",
		122	params,
		123	}),
		124	).toEqual({ ...stack, index: 1, routes: [route, { name: "Thread", params }] });
		125	},
		126	);
		127
		128	it("leaves ordinary thread selection alone when no overlay is present", () => {
		129	expect(
		130	resolveThreadSelectionOverlayState({
		131	state: { ...stack, index: 2, routes: [home, thread, files] },
		132	workspaceRouteKey: files.key,
		133	action: "replace",
		134	params,
		135	}),
		136	).toBeNull();
		137	});
		138	});

apps/mobile/src/lib/adaptive-navigation.ts+29

...	@@ -1,3 +1,5 @@	...	@@ -1,3 +1,5 @@
		1	import type { NavigationState } from "@react-navigation/native";
		2
1	export type AdaptiveNavigationAction = "push" \| "replace" \| "set-params";	3	export type AdaptiveNavigationAction = "push" \| "replace" \| "set-params";
2		4
3	const BASE_THREAD_ROUTE_PATTERN = /^\/threads\/[^/]+\/[^/]+\/?$/;	5	const BASE_THREAD_ROUTE_PATTERN = /^\/threads\/[^/]+\/[^/]+\/?$/;
...	@@ -23,6 +25,33 @@ export function resolveThreadSelectionNavigationAction(input: {	...	@@ -23,6 +25,33 @@ export function resolveThreadSelectionNavigationAction(input: {
23	return isBaseThreadRoute(input.pathname) ? "set-params" : "replace";	25	return isBaseThreadRoute(input.pathname) ? "set-params" : "replace";
24	}	26	}
25		27
		28	/** Dismiss sheets and select their underlying workspace destination in one stack update. */
		29	export function resolveThreadSelectionOverlayState(input: {
		30	readonly state: NavigationState \| undefined;
		31	readonly workspaceRouteKey: string \| undefined;
		32	readonly action: AdaptiveNavigationAction;
		33	readonly params: ReactNavigation.RootParamList["Thread"];
		34	}) {
		35	if (input.state === undefined) return null;
		36	const workspaceIndex = input.state.routes.findIndex(
		37	(route) => route.key === input.workspaceRouteKey,
		38	);
		39	if (workspaceIndex < 0 \|\| workspaceIndex >= input.state.index) return null;
		40
		41	const workspaceRoute = input.state.routes[workspaceIndex];
		42	const routes = input.state.routes.slice(0, workspaceIndex + (input.action === "push" ? 1 : 0));
		43	return {
		44	...input.state,
		45	index: routes.length,
		46	routes: [
		47	...routes,
		48	input.action === "set-params" && workspaceRoute?.name === "Thread"
		49	? { ...workspaceRoute, params: { ...workspaceRoute.params, ...input.params } }
		50	: { name: "Thread", params: input.params },
		51	],
		52	};
		53	}
		54
26	/**	55	/**
27	* On regular-width layouts, the file browser and preview occupy one workspace	56	* On regular-width layouts, the file browser and preview occupy one workspace
28	* destination. Replacing the browser route keeps a single back step to chat.	57	* destination. Replacing the browser route keeps a single back step to chat.

apps/mobile/src/lib/composerEnterBehavior.ts created+9

...	@@ -0,0 +1,9 @@
1	/**
2	* What the Return key does in the composer on a hardware keyboard. `send`
3	* submits the draft and Shift-Return inserts a newline; `newline` inserts a
4	* newline and Command-Return submits. Applies on iOS only — Android's composer
5	* has no hardware Return handling.
6	*/
7	export type ComposerEnterBehavior = "send" \| "newline";
8
9	export const DEFAULT_COMPOSER_ENTER_BEHAVIOR: ComposerEnterBehavior = "send";

apps/mobile/src/lib/useHoverGesture.ts created+24

...	@@ -0,0 +1,24 @@
1	import { useMemo, useState } from "react";
2	import { Gesture } from "react-native-gesture-handler";
3
4	/** Uses native hover recognition without React Native's optional pointer-event flags. */
5	export function useHoverGesture(disabled = false) {
6	const [hovered, setHovered] = useState(false);
7	const hoverGesture = useMemo(
8	() =>
9	Gesture.Hover()
10	.manualActivation(true)
11	.enabled(!disabled)
12	// Observe hover without competing with row taps, scrolling, or swipe actions.
13	.cancelsTouchesInView(false)
14	.runOnJS(true)
15	.onBegin(() => {
16	setHovered(true);
17	})
18	.onFinalize(() => {
19	setHovered(false);
20	}),
21	[disabled],
22	);
23	return { hovered: !disabled && hovered, hoverGesture };
24	}

apps/mobile/src/native/T3ComposerEditor.ios.tsx+3

apps/mobile/src/native/T3ComposerEditor.tsx+1

...	@@ -17,6 +17,7 @@ export function ComposerEditor({	...	@@ -17,6 +17,7 @@ export function ComposerEditor({
17	textStyle,	17	textStyle,
18	contentInsetVertical = 0,	18	contentInsetVertical = 0,
19	singleLineCentered: _singleLineCentered,	19	singleLineCentered: _singleLineCentered,
		20	enterBehavior: _enterBehavior,
20	readOnly = false,	21	readOnly = false,
21	...props	22	...props
22	}: ComposerEditorProps) {	23	}: ComposerEditorProps) {

apps/mobile/src/native/T3ComposerEditor.types.ts+10-1

 @@ -2,6 +2,10 @@ import type { OrchestrationMessageContext, ServerProviderSkill } from "@t3tools/
 import type { Ref } from "react";
 import type { StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { ComposerEnterBehavior } from "../lib/composerEnterBehavior";
+export type { ComposerEnterBehavior };
 export type ComposerEditorSelection = {
   readonly start: number;
   readonly end: number;
 @@ -61,6 +65,11 @@ export interface ComposerEditorProps {
   readonly onPasteText?: (paste: ComposerTextPaste) => void;
   readonly onFocus?: () => void;
   readonly onBlur?: () => void;
-  /** Invoked by the native editor when Command-Return is pressed on a hardware keyboard. */
+  /**
+   * Hardware-keyboard Return behavior on iOS. No-op on Android, which has no
+   * hardware Return handling.
+   */
+  readonly enterBehavior?: ComposerEnterBehavior;
+  /** Hardware keyboard submission: Command-Return, or Return when `enterBehavior` is "send". */
   readonly onSubmit?: () => void;
 }

apps/mobile/src/persistence/mobile-preferences.ts+7

docs/user/keybindings.md+13

...	@@ -28,6 +28,19 @@ to copy its URL and `mod+shift+k` to copy its number with a `#` prefix.	...	@@ -28,6 +28,19 @@ to copy its URL and `mod+shift+k` to copy its number with a `#` prefix.
28	Both shortcuts can be changed in Settings. Search for “Copy Link or Thread ID”	28	Both shortcuts can be changed in Settings. Search for “Copy Link or Thread ID”
29	or “Copy Number”. They copy the selected PR and leave terminal input alone.	29	or “Copy Number”. They copy the selected PR and leave terminal input alone.
30		30
		31	## iPad
		32
		33	With a hardware keyboard, use `Cmd+1` through `Cmd+9` to open the first nine
		34	displayed threads. The shortcuts follow the current list filters and order.
		35	`Cmd+K` opens the command palette to search commands, projects, and threads.
		36	Use the arrow keys and Return to choose a result, or `Cmd+1` through `Cmd+9` to
		37	choose directly. Escape or `Cmd+K` closes the palette. Start a search with `>`
		38	to show only actions.
		39
		40	In the composer, Return sends and `Shift+Return` inserts a new line. `Cmd+Return`
		41	also sends. To make Return insert a new line instead, change the Return key
		42	behavior in Settings → Keyboard.
		43
31	## Edit the configuration file	44	## Edit the configuration file
32		45
33	Keybindings live on the environment's machine, in	46	Keybindings live on the environment's machine, in

patches/react-native-gesture-handler@2.32.0.patch+17-1

...	@@ -1,3 +1,19 @@	...	@@ -1,3 +1,19 @@
		1	diff --git a/apple/Handlers/RNHoverHandler.m b/apple/Handlers/RNHoverHandler.m
		2	index 320cb8cb2652bfcfe1ecc65ebd81a8d208e4260f..a88ac5f04a9663fd7a62ee89e42d85ec41dcaf55 100644
		3	--- a/apple/Handlers/RNHoverHandler.m
		4	+++ b/apple/Handlers/RNHoverHandler.m
		5	@@ -132,8 +132,10 @@ - (void)unbindFromView
		6	{
		7	#if CHECK_TARGET(13_4)
		8	if (@available(iOS 13.4, *)) {
		9	+ // The superclass detaches the recognizer, clearing recognizer.view. Remove
		10	+ // the interaction from its own view before it can be recycled by Fabric.
		11	+ [_pointerInteraction.view removeInteraction:_pointerInteraction];
		12	[super unbindFromView];
		13	- [self.recognizer.view removeInteraction:_pointerInteraction];
		14	}
		15	#endif
		16	}
1	diff --git a/lib/commonjs/components/ReanimatedSwipeable/ReanimatedSwipeable.js b/lib/commonjs/components/ReanimatedSwipeable/ReanimatedSwipeable.js	17	diff --git a/lib/commonjs/components/ReanimatedSwipeable/ReanimatedSwipeable.js b/lib/commonjs/components/ReanimatedSwipeable/ReanimatedSwipeable.js
2	index 551ab92bf58db0b79d428dcd2f2df898ef686493..13db26d88bff975bc5d46bb6432cbf9fda3d489a 100644	18	index 551ab92bf58db0b79d428dcd2f2df898ef686493..13db26d88bff975bc5d46bb6432cbf9fda3d489a 100644
3	--- a/lib/commonjs/components/ReanimatedSwipeable/ReanimatedSwipeable.js	19	--- a/lib/commonjs/components/ReanimatedSwipeable/ReanimatedSwipeable.js
...	@@ -97,7 +113,7 @@ index a2835d5416ffd5cf9a04e98774516b9e6569691e..055afce410d6eb655532e7a09371dfc2	...	@@ -97,7 +113,7 @@ index a2835d5416ffd5cf9a04e98774516b9e6569691e..055afce410d6eb655532e7a09371dfc2
97	const animatedStyle = useAnimatedStyle(() => ({	113	const animatedStyle = useAnimatedStyle(() => ({
98	transform: [{	114	transform: [{
99	diff --git a/lib/typescript/components/ReanimatedSwipeable/ReanimatedSwipeableProps.d.ts b/lib/typescript/components/ReanimatedSwipeable/ReanimatedSwipeableProps.d.ts	115	diff --git a/lib/typescript/components/ReanimatedSwipeable/ReanimatedSwipeableProps.d.ts b/lib/typescript/components/ReanimatedSwipeable/ReanimatedSwipeableProps.d.ts
100	index ac8b76830d468edfbc29052b452a36221323c3de..6985d54d9d359e825a5a0e6078bb113204e2807b 100644	116	index ac8b76830d468edfbc29052b452a36221323c3de..cac72ebaafaf746af7640783a16e99c93ecad2a4 100644
101	--- a/lib/typescript/components/ReanimatedSwipeable/ReanimatedSwipeableProps.d.ts	117	--- a/lib/typescript/components/ReanimatedSwipeable/ReanimatedSwipeableProps.d.ts
102	+++ b/lib/typescript/components/ReanimatedSwipeable/ReanimatedSwipeableProps.d.ts	118	+++ b/lib/typescript/components/ReanimatedSwipeable/ReanimatedSwipeableProps.d.ts
103	@@ -64,6 +64,13 @@ export interface SwipeableProps {	119	@@ -64,6 +64,13 @@ export interface SwipeableProps {

pnpm-lock.yaml+3-3

...	@@ -99,7 +99,7 @@ patchedDependencies:	...	@@ -99,7 +99,7 @@ patchedDependencies:
99	expo-audio@57.0.4: fa9a3e0442ed395d4071bb406e08c3a471c9a84700bdfa0b9ad7ff144c96041a	99	expo-audio@57.0.4: fa9a3e0442ed395d4071bb406e08c3a471c9a84700bdfa0b9ad7ff144c96041a
100	expo-sharing@57.0.17: 8d2e3b10eb3f52036a9a086800180ec6cebf3b75bccc5b1775117a7244d4ac45	100	expo-sharing@57.0.17: 8d2e3b10eb3f52036a9a086800180ec6cebf3b75bccc5b1775117a7244d4ac45
101	expo-widgets@57.0.15: 319a9ded5db49c5b5215c511a138b33f44c7ea2972eb418192e8d5342fe75ce6	101	expo-widgets@57.0.15: 319a9ded5db49c5b5215c511a138b33f44c7ea2972eb418192e8d5342fe75ce6
102	react-native-gesture-handler@2.32.0: 96573c000f7fe56b5abfa13e2e5f0d065907e674cb8e2300155226d7c9874398	102	react-native-gesture-handler@2.32.0: 0579f8e4dad02bf3183d95b02620358412983c36f9bda7425dc8bcb9643b5ce2
103	react-native-keyboard-controller@1.21.13: 6e4339347bc5bb3c9ea67d85ff5c814058b211c5750f247aba59d07869a2e787	103	react-native-keyboard-controller@1.21.13: 6e4339347bc5bb3c9ea67d85ff5c814058b211c5750f247aba59d07869a2e787
104	react-native-nitro-modules@0.35.9: 825622aae63a8fb5b904f3c77908a0e216261d727ea171709f2c0b6088422675	104	react-native-nitro-modules@0.35.9: 825622aae63a8fb5b904f3c77908a0e216261d727ea171709f2c0b6088422675
105	react-native-reanimated@4.5.1: a23baea5d82cbf1254720110aef6671e39d57a425f8be446756f91ab806eb72c	105	react-native-reanimated@4.5.1: a23baea5d82cbf1254720110aef6671e39d57a425f8be446756f91ab806eb72c
...	@@ -426,7 +426,7 @@ importers:	...	@@ -426,7 +426,7 @@ importers:
426	version: 0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6)	426	version: 0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6)
427	react-native-gesture-handler:	427	react-native-gesture-handler:
428	specifier: ~2.32.0	428	specifier: ~2.32.0
429	version: 2.32.0(patch_hash=96573c000f7fe56b5abfa13e2e5f0d065907e674cb8e2300155226d7c9874398)(react-native@0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6))(react@19.2.3)	429	version: 2.32.0(patch_hash=0579f8e4dad02bf3183d95b02620358412983c36f9bda7425dc8bcb9643b5ce2)(react-native@0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6))(react@19.2.3)
430	react-native-image-viewing:	430	react-native-image-viewing:
431	specifier: ^0.2.2	431	specifier: ^0.2.2
432	version: 0.2.2(react-native@0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6))(react@19.2.3)	432	version: 0.2.2(react-native@0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6))(react@19.2.3)
...	@@ -20977,7 +20977,7 @@ snapshots:	...	@@ -20977,7 +20977,7 @@ snapshots:
20977	transitivePeerDependencies:	20977	transitivePeerDependencies:
20978	- supports-color	20978	- supports-color
20979		20979
20980	react-native-gesture-handler@2.32.0(patch_hash=96573c000f7fe56b5abfa13e2e5f0d065907e674cb8e2300155226d7c9874398)(react-native@0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6))(react@19.2.3):	20980	react-native-gesture-handler@2.32.0(patch_hash=0579f8e4dad02bf3183d95b02620358412983c36f9bda7425dc8bcb9643b5ce2)(react-native@0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6))(react@19.2.3):
20981	dependencies:	20981	dependencies:
20982	'@egjs/hammerjs': 2.0.17	20982	'@egjs/hammerjs': 2.0.17
20983	'@types/react-test-renderer': 19.1.0	20983	'@types/react-test-renderer': 19.1.0

author	Ben Davis <45952064+bmdavis419@users.noreply.github.com> 2026-09-14 22:12:54-07:00
committer	GitHub <noreply@github.com> 2026-09-15 05:12:54+00:00
log	26b8f985d85773e41a2ee637785f7c87d5c1a01e
tree	19f59dc67df2f111fcbf789528f379959df95a5f
parent	b20d29dc438bcabb2c25e85976dc108169bb4c6d
signature	Signed by PGP key B5690EEEBB952194

...	@@ -33,6 +33,7 @@ import {	...	@@ -33,6 +33,7 @@ import {
33	resolveComposerControlledEventCount,	33	resolveComposerControlledEventCount,
34	type ComposerNativeEventSnapshot,	34	type ComposerNativeEventSnapshot,
35	} from "./composerEditorRevision";	35	} from "./composerEditorRevision";
		36	import { DEFAULT_COMPOSER_ENTER_BEHAVIOR } from "../lib/composerEnterBehavior";
36	import type { ComposerEditorProps, ComposerEditorSelection } from "./T3ComposerEditor.types";	37	import type { ComposerEditorProps, ComposerEditorSelection } from "./T3ComposerEditor.types";
37		38
38	const NATIVE_MODULE_NAME = "T3ComposerEditor";	39	const NATIVE_MODULE_NAME = "T3ComposerEditor";
...	@@ -79,6 +80,7 @@ interface NativeComposerEditorProps extends ViewProps {	...	@@ -79,6 +80,7 @@ interface NativeComposerEditorProps extends ViewProps {
79	readonly contentInsetVertical: number;	80	readonly contentInsetVertical: number;
80	readonly editable: boolean;	81	readonly editable: boolean;
81	readonly readOnly: boolean;	82	readonly readOnly: boolean;
		83	readonly enterBehavior: string;
82	readonly scrollEnabled: boolean;	84	readonly scrollEnabled: boolean;
83	readonly autoFocus: boolean;	85	readonly autoFocus: boolean;
84	readonly autoCorrect: boolean;	86	readonly autoCorrect: boolean;
...	@@ -291,6 +293,7 @@ export function ComposerEditor({	...	@@ -291,6 +293,7 @@ export function ComposerEditor({
291	contentInsetVertical={contentInsetVertical}	293	contentInsetVertical={contentInsetVertical}
292	editable={props.editable ?? true}	294	editable={props.editable ?? true}
293	readOnly={props.readOnly ?? false}	295	readOnly={props.readOnly ?? false}
		296	enterBehavior={props.enterBehavior ?? DEFAULT_COMPOSER_ENTER_BEHAVIOR}
294	scrollEnabled={props.scrollEnabled ?? true}	297	scrollEnabled={props.scrollEnabled ?? true}
295	autoFocus={props.autoFocus ?? false}	298	autoFocus={props.autoFocus ?? false}
296	autoCorrect={props.autoCorrect ?? true}	299	autoCorrect={props.autoCorrect ?? true}

...	@@ -6,6 +6,7 @@ import * as Ref from "effect/Ref";	...	@@ -6,6 +6,7 @@ import * as Ref from "effect/Ref";
6	import * as Schema from "effect/Schema";	6	import * as Schema from "effect/Schema";
7	import * as Semaphore from "effect/Semaphore";	7	import * as Semaphore from "effect/Semaphore";
8	import type { SidebarProjectGroupingMode } from "@t3tools/contracts";	8	import type { SidebarProjectGroupingMode } from "@t3tools/contracts";
		9	import type { ComposerEnterBehavior } from "../lib/composerEnterBehavior";
9	import { MOBILE_THEME_IDS, type MobileThemeId, type MobileThemeMode } from "../lib/mobileTheme";	10	import { MOBILE_THEME_IDS, type MobileThemeId, type MobileThemeMode } from "../lib/mobileTheme";
10		11
11	import * as MobileDatabase from "./mobile-database";	12	import * as MobileDatabase from "./mobile-database";
...	@@ -29,6 +30,8 @@ export interface Preferences {	...	@@ -29,6 +30,8 @@ export interface Preferences {
29	readonly codeWordBreak?: boolean;	30	readonly codeWordBreak?: boolean;
30	readonly connectOnboardingOptOutAccounts?: ReadonlyArray<string>;	31	readonly connectOnboardingOptOutAccounts?: ReadonlyArray<string>;
31	readonly collapsedProjectGroups?: readonly string[];	32	readonly collapsedProjectGroups?: readonly string[];
		33	/** What the Return key does in the composer on a hardware keyboard. iOS only. */
		34	readonly composerEnterBehavior?: ComposerEnterBehavior;
32	/** @deprecated Kept temporarily so older OTA bundles retain the selected mode. */	35	/** @deprecated Kept temporarily so older OTA bundles retain the selected mode. */
33	readonly projectGroupingEnabled?: boolean;	36	readonly projectGroupingEnabled?: boolean;
34	readonly projectGroupingMode?: SidebarProjectGroupingMode;	37	readonly projectGroupingMode?: SidebarProjectGroupingMode;
...	@@ -99,6 +102,7 @@ function sanitizePreferences(parsed: Preferences): Preferences {	...	@@ -99,6 +102,7 @@ function sanitizePreferences(parsed: Preferences): Preferences {
99	codeWordBreak?: boolean;	102	codeWordBreak?: boolean;
100	connectOnboardingOptOutAccounts?: ReadonlyArray<string>;	103	connectOnboardingOptOutAccounts?: ReadonlyArray<string>;
101	collapsedProjectGroups?: readonly string[];	104	collapsedProjectGroups?: readonly string[];
		105	composerEnterBehavior?: ComposerEnterBehavior;
102	projectGroupingEnabled?: boolean;	106	projectGroupingEnabled?: boolean;
103	projectGroupingMode?: SidebarProjectGroupingMode;	107	projectGroupingMode?: SidebarProjectGroupingMode;
104	legacyThreadListEnabled?: boolean;	108	legacyThreadListEnabled?: boolean;
...	@@ -159,6 +163,9 @@ function sanitizePreferences(parsed: Preferences): Preferences {	...	@@ -159,6 +163,9 @@ function sanitizePreferences(parsed: Preferences): Preferences {
159	(key): key is string => typeof key === "string",	163	(key): key is string => typeof key === "string",
160	);	164	);
161	}	165	}
		166	if (parsed.composerEnterBehavior === "send" \|\| parsed.composerEnterBehavior === "newline") {
		167	preferences.composerEnterBehavior = parsed.composerEnterBehavior;
		168	}
162	if (typeof parsed.projectGroupingEnabled === "boolean") {	169	if (typeof parsed.projectGroupingEnabled === "boolean") {
163	preferences.projectGroupingEnabled = parsed.projectGroupingEnabled;	170	preferences.projectGroupingEnabled = parsed.projectGroupingEnabled;
164	}	171	}

feat(mobile): add iPad keyboard shortcuts and command palette (#11679)