Shell 28: fluxer-platform shortcuts on Wayland (portal) #820

Closed
opened 2026-11-17 23:03:01 +00:00 by charles · 0 comments
Owner

Task 28 of the Desktop shell plan (docs/superpowers/plans/2026-11-17-desktop-shell.md, section "### Task 28:"). The plan on the shell branch is the source of truth; this copy is for reading.

Closes: — Depends on: 3, 18, 25

Files:

  • Create: crates/fluxer-platform/src/shortcuts/portal.rs · Modify: shortcuts/mod.rs, README · Test: crates/fluxer-platform/tests/portal_shortcuts_bus.rs (Task 3's fake, extended)

Interfaces:

  • Produces: the portal back end with ashpd: registers the app id once per connection (after Task 18's entry exists; unregistered reported), session with a fixed handle token, ListShortcuts, BindShortcuts on ShortcutsCommand::PortalBind (all global-capable actions, labels, preferred triggers; no timeout on the user's dialog), ConfigureShortcuts on v2, Activated / Deactivated → BackendOutput::Event, a repeated Activated without Deactivated ignored for holds and re-armed after 1.5 s for toggles (D/LinuxGlobalShortcutsPortal.ts:462-475), ShortcutsChanged → PortalUpdate::Triggers and releases, the portal's owner changing → Reconnecting; the hold debounce: a Deactivated of a hold action is delivered 60 ms later unless an Activated for it arrives first (KDE bug 484525; the constant named, the reason in the module doc). The state decisions stay in core (Task 12); this file only talks to the bus.

  • Step 1: failing tests (private bus): registers_then_creates_session, bind_sends_all_actions_with_triggers, activated_deactivated_map_to_events, hold_release_debounced_and_cancelled_by_press, toggle_rearmed_after_repeat, changed_triggers_reported_and_released, denied_bind_reported, portal_restart_reconnects, v1_has_no_configure.

  • Step 2–5: FAIL → implement → PASS → commit feat(platform): global shortcuts through the portal.

Task 28 of the Desktop shell plan (`docs/superpowers/plans/2026-11-17-desktop-shell.md`, section "### Task 28:"). The plan on the `shell` branch is the source of truth; this copy is for reading. **Closes:** — **Depends on:** 3, 18, 25 **Files:** - Create: `crates/fluxer-platform/src/shortcuts/portal.rs` · Modify: `shortcuts/mod.rs`, README · Test: `crates/fluxer-platform/tests/portal_shortcuts_bus.rs` (Task 3's fake, extended) **Interfaces:** - Produces: the portal back end with `ashpd`: registers the app id once per connection (after Task 18's entry exists; `unregistered` reported), session with a fixed handle token, `ListShortcuts`, `BindShortcuts` on `ShortcutsCommand::PortalBind` (all global-capable actions, labels, preferred triggers; no timeout on the user's dialog), `ConfigureShortcuts` on v2, `Activated` / `Deactivated` → `BackendOutput::Event`, a repeated `Activated` without `Deactivated` ignored for holds and re-armed after 1.5 s for toggles (`D/LinuxGlobalShortcutsPortal.ts:462-475`), `ShortcutsChanged` → `PortalUpdate::Triggers` and releases, the portal's owner changing → `Reconnecting`; the **hold debounce**: a `Deactivated` of a hold action is delivered 60 ms later unless an `Activated` for it arrives first (KDE bug 484525; the constant named, the reason in the module doc). The state decisions stay in core (Task 12); this file only talks to the bus. - [ ] **Step 1: failing tests** (private bus): `registers_then_creates_session`, `bind_sends_all_actions_with_triggers`, `activated_deactivated_map_to_events`, `hold_release_debounced_and_cancelled_by_press`, `toggle_rearmed_after_repeat`, `changed_triggers_reported_and_released`, `denied_bind_reported`, `portal_restart_reconnects`, `v1_has_no_configure`. - [ ] **Step 2–5:** FAIL → implement → PASS → commit `feat(platform): global shortcuts through the portal`.
charles added this to the Desktop shell milestone 2026-11-17 23:03:01 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/fluxer-native#820
No description provided.