feat(phase-1/m5.1): desktop Esc back stack + Ctrl+N/Ctrl+comma shortcuts

JVM PlatformBackHandler made real (PlatformBackStack + LocalPlatformBackStack);
window drains it on Esc via Window(onPreviewKeyEvent) — the editor rides the
shared seam unchanged (draft flush + discard prompt). Shell registers
drawer/settings Esc; preview-phase shortcuts. New --keys-smoke leg drives the
exact dispatch headlessly. Keypress capture pending-manual (KWin/Wayland drops
xdotool XTEST events to the XWayland window).

Verify: ./gradlew assembleDebug :composeApp:compileKotlinJvm :desktopApp:build
(SUCCESSFUL); :desktopApp:run --args="--data-dir /tmp/incido-keys --keys-smoke
--exit-after 12" (KEYS ALL-OK); --self-test/--settings-smoke/--editor-smoke
green; :core:data-jvm:smoke M1a PASS.
This commit is contained in:
Incido Developer committed 2026-10-06 22:37:37 +13:00
1 parent faab0cde98
commit 639f39d187
5 files changed
+300 -56

No files matched your search

@@ -1,5 +1,7 @@
package org.incido.desktop
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.material3.DrawerValue
import androidx.compose.material3.ModalNavigationDrawer
import androidx.compose.material3.rememberDrawerState
@@ -11,12 +13,21 @@ import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.input.key.Key
import androidx.compose.ui.input.key.KeyEventType
import androidx.compose.ui.input.key.isCtrlPressed
import androidx.compose.ui.input.key.key
import androidx.compose.ui.input.key.onPreviewKeyEvent
import androidx.compose.ui.input.key.type
import kotlinx.coroutines.delay
import kotlinx.coroutines.launch
import org.incido.compose.di.LocalAppGraph
import org.incido.compose.ui.drawer.IncidoDrawer
import org.incido.compose.ui.editor.NoteEditorScreen
import org.incido.compose.ui.notelist.NoteListScreen
import org.incido.compose.util.LocalPlatformBackStack
import org.incido.compose.util.PlatformBackHandler
import org.incido.domain.model.NoteFilter
/**
@@ -31,8 +42,10 @@ import org.incido.domain.model.NoteFilter
* Platform differences handled, not faked (§6.5):
* - beginExternalActivity is null on desktop (no auto-lock to suppress),
* - the editor's intake seam hides camera/voice on the JVM,
* - PlatformBackHandler is a no-op here — Esc routing is M5 polish,
* the editor closes via its own top-bar arrow like the phone's up button.
* - M5.1: Esc routes through the window back stack — the editor's own
* commonMain PlatformBackHandler gets its discard-prompt tryClose, the
* shell registers drawer + settings below it.
* - M5.1 shortcuts: Ctrl+N new note, Ctrl+comma settings.
*/
@Composable
fun DesktopShell(
@@ -41,13 +54,32 @@ fun DesktopShell(
onShowSettings: (Boolean) -> Unit,
/** M4.5b scripted leg: opens the editor headlessly after first frame. */
editorSmoke: Boolean = false,
/** M5.1 scripted leg: drives backStack.dispatchBack() — the exact path
* Window(onPreviewKeyEvent) runs on Esc. */
keysSmoke: Boolean = false,
) {
val scope = rememberCoroutineScope()
val drawerState = rememberDrawerState(DrawerValue.Closed)
val backStack = LocalPlatformBackStack.current
var filterMode by remember { mutableStateOf<NoteFilter>(NoteFilter.Home) }
var editorOpen by remember { mutableStateOf(false) }
// null id = "new note" (exactly what onOpenEditor(null) means on Android).
var editorNoteId by remember { mutableStateOf<Long?>(null) }
// M5.1 KEYS leg mirror of the parent's showSettings — it flips only
// through the same callback the back handler calls, so asserting on it
// asserts on the real routing. Rendering stays on the parent's state.
var settingsOpen by remember { mutableStateOf(false) }
// Mirror follows the parent so every close path (back arrow, Esc,
// shortcut toggles) keeps the KEYS-leg assertion honest.
LaunchedEffect(showSettings) { settingsOpen = showSettings }
// M5.1 — Esc registrations below the editor's own (the common seam
// registers while the editor is composed; topmost enabled entry wins).
PlatformBackHandler(enabled = showSettings, onBack = { onShowSettings(false) })
PlatformBackHandler(
enabled = drawerState.isOpen,
onBack = { scope.launch { drawerState.close() } },
)
if (editorSmoke) {
LaunchedEffect(Unit) {
@@ -59,39 +91,107 @@ fun DesktopShell(
}
}
CompositionLocalProvider(LocalAppGraph provides app) {
when {
showSettings -> DesktopSettingsScreen(app = app, onBack = { onShowSettings(false) })
editorOpen -> NoteEditorScreen(
noteId = editorNoteId,
onClose = { editorOpen = false },
repository = app.noteRepository,
if (keysSmoke) {
LaunchedEffect(Unit) {
delay(2200)
var pass = backStack != null
// a) Editor owns Esc through the commonMain seam: a dispatch on
// a clean new note must flush the draft and close — exactly
// the Android BackHandler-chain behaviour.
editorNoteId = null
editorOpen = true
delay(1200) // let the editor register its handler
val consumedEditor = backStack?.dispatchBack() == true
delay(400) // state flip + recomposition
val editorClosed = !editorOpen
pass = pass && consumedEditor && editorClosed
println(
"KEYS editor Esc consumed=$consumedEditor closed=$editorClosed " +
(if (consumedEditor && editorClosed) "PASS" else "FAIL"),
)
else -> ModalNavigationDrawer(
drawerState = drawerState,
drawerContent = {
IncidoDrawer(
currentFilter = filterMode,
onSelectFilter = { picked ->
filterMode = picked
scope.launch { drawerState.close() }
},
onOpenSettings = {
scope.launch { drawerState.close() }
// b) Nothing enabled must NOT consume — Esc keeps reaching
// popups/text fields through the preview chain.
val consumedEmpty = backStack?.dispatchBack() == true
pass = pass && !consumedEmpty
println(
"KEYS nothing-enabled consumed=$consumedEmpty " +
(if (!consumedEmpty) "PASS" else "FAIL"),
)
// c) Settings closes on Esc via the shell registration — the
// same onShowSettings(false) the window's Esc callback makes.
settingsOpen = true
onShowSettings(true)
delay(600)
val consumedSettings = backStack?.dispatchBack() == true
delay(400)
val settingsGone = !settingsOpen
pass = pass && consumedSettings && settingsGone
println(
"KEYS settings Esc consumed=$consumedSettings closed=$settingsGone " +
(if (consumedSettings && settingsGone) "PASS" else "FAIL"),
)
println("KEYS ${if (pass) "ALL-OK" else "PROBLEMS (see FAIL lines above)"}")
}
}
CompositionLocalProvider(LocalAppGraph provides app) {
// M5.1 shortcuts. Preview-phase, so they win over focused text
// fields — Ctrl+N inside the editor means "new note", not "type n".
Box(
Modifier
.fillMaxSize()
.onPreviewKeyEvent { event ->
if (event.type != KeyEventType.KeyDown) return@onPreviewKeyEvent false
when {
event.isCtrlPressed && event.key == Key.N &&
!editorOpen && !showSettings -> {
println("KEYS shortcut ctrl+N -> new note")
editorNoteId = null
editorOpen = true
true
}
event.isCtrlPressed && event.key == Key.Comma && !showSettings -> {
println("KEYS shortcut ctrl+comma -> settings")
onShowSettings(true)
},
)
true
}
else -> false
}
},
) {
NoteListScreen(
filterMode = filterMode,
onOpenDrawer = { scope.launch { drawerState.open() } },
onOpenEditor = { id ->
editorNoteId = id
editorOpen = true
},
) {
when {
showSettings -> DesktopSettingsScreen(app = app, onBack = { onShowSettings(false) })
editorOpen -> NoteEditorScreen(
noteId = editorNoteId,
onClose = { editorOpen = false },
repository = app.noteRepository,
)
else -> ModalNavigationDrawer(
drawerState = drawerState,
drawerContent = {
IncidoDrawer(
currentFilter = filterMode,
onSelectFilter = { picked ->
filterMode = picked
scope.launch { drawerState.close() }
},
onOpenSettings = {
scope.launch { drawerState.close() }
onShowSettings(true)
},
)
},
) {
NoteListScreen(
filterMode = filterMode,
onOpenDrawer = { scope.launch { drawerState.open() } },
onOpenEditor = { id ->
editorNoteId = id
editorOpen = true
},
repository = app.noteRepository,
)
}
}
}
}
@@ -33,6 +33,7 @@ import androidx.compose.material3.Text
import androidx.compose.material3.darkColorScheme
import androidx.compose.material3.lightColorScheme
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.collectAsState
import androidx.compose.runtime.getValue
@@ -42,6 +43,10 @@ import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.input.key.Key
import androidx.compose.ui.input.key.KeyEventType
import androidx.compose.ui.input.key.key
import androidx.compose.ui.input.key.type
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import androidx.compose.ui.window.Window
@@ -60,6 +65,8 @@ import kotlinx.coroutines.runBlocking
import kotlinx.coroutines.withContext
import org.incido.compose.data.backup.BackupBridge
import org.incido.compose.ui.theme.IncidoTheme
import org.incido.compose.util.LocalPlatformBackStack
import org.incido.compose.util.PlatformBackStack
import org.incido.compose.data.backup.EncryptedBackupCodec
import org.incido.compose.data.backup.EncryptedKeyCodec
import org.incido.data.crypto.AesGcmFieldCipher
@@ -107,6 +114,10 @@ fun main(args: Array<String>) {
// so the shared sections (M4.4d) render on the JVM before auto-exit.
val settingsSmoke = "--settings-smoke" in args
val editorSmoke = "--editor-smoke" in args
// M5.1 scripted leg: drives the exact Esc dispatch path the window's
// onPreviewKeyEvent uses (backStack.dispatchBack) against the real
// editor and settings registrations.
val keysSmoke = "--keys-smoke" in args
val cryptoSelfTest = "--crypto-self-test" in args
val cryptoReopen = "--crypto-reopen" in args
val cryptoPassphrase = args.argAfter("--crypto-passphrase") ?: "selftest-passphrase"
@@ -123,6 +134,12 @@ fun main(args: Array<String>) {
val app = DesktopContainer(dataDir)
// M5.1: the desktop back stack. PlatformBackHandler (composeApp jvm
// actual) registers into it; Esc below drains it, topmost enabled
// entry first — the editor's discard-prompt chain included, since its
// BackHandler(enabled=true){tryClose()} rides the same seam.
val backStack = PlatformBackStack()
// M3: window geometry is desktop-only state, kept in its OWN store file
// (incido_window.preferences_pb) — settings stay the phone-shared schema.
// Position is deliberately NOT stored: KWin owns placement on this stack.
@@ -142,27 +159,43 @@ fun main(args: Array<String>) {
onCloseRequest = ::exitApplication,
state = windowState,
title = "Incido",
// M5.1: Esc = system back. Consumed only when a handler is
// live; otherwise it falls through so popups keep their own
// Esc handling. This is the exact dispatcher --keys-smoke
// drives headlessly via backStack.dispatchBack().
onPreviewKeyEvent = { event ->
if (event.type == KeyEventType.KeyDown && event.key == Key.Escape) {
val consumed = backStack.dispatchBack()
println("KEYS esc(captured) consumed=$consumed")
consumed
} else {
false
}
},
) {
NotesWindow(
app = app,
repository = app.noteRepository,
windowStore = windowStore,
windowState = windowState,
exitAfterSeconds = exitAfterSeconds,
selfTest = selfTest,
settingsSmoke = settingsSmoke,
editorSmoke = editorSmoke,
backupImport = backupImport,
backupExport = backupExport,
backupExportEnc = backupExportEnc,
backupPassphrase = backupPassphrase,
cryptoSelfTest = cryptoSelfTest,
cryptoReopen = cryptoReopen,
cryptoPassphrase = cryptoPassphrase,
keyExport = keyExport,
keyImport = keyImport,
onExit = ::exitApplication,
)
CompositionLocalProvider(LocalPlatformBackStack provides backStack) {
NotesWindow(
app = app,
repository = app.noteRepository,
windowStore = windowStore,
windowState = windowState,
exitAfterSeconds = exitAfterSeconds,
selfTest = selfTest,
settingsSmoke = settingsSmoke,
editorSmoke = editorSmoke,
keysSmoke = keysSmoke,
backupImport = backupImport,
backupExport = backupExport,
backupExportEnc = backupExportEnc,
backupPassphrase = backupPassphrase,
cryptoSelfTest = cryptoSelfTest,
cryptoReopen = cryptoReopen,
cryptoPassphrase = cryptoPassphrase,
keyExport = keyExport,
keyImport = keyImport,
onExit = ::exitApplication,
)
}
}
}
@@ -180,6 +213,7 @@ private fun NotesWindow(
selfTest: Boolean,
settingsSmoke: Boolean,
editorSmoke: Boolean,
keysSmoke: Boolean,
backupImport: String?,
backupExport: String?,
backupExportEnc: String?,
@@ -213,6 +247,7 @@ private fun NotesWindow(
showSettings = showSettings,
onShowSettings = { showSettings = it },
editorSmoke = editorSmoke,
keysSmoke = keysSmoke,
)
}