@rapidmx/web-client 0.8.0 → 0.10.0

package/dist/apps/shared/keyboard/ShortcutProvider.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { createContext, useContext, useEffect, useMemo, useState, useSyncExternalStore } from "react";
+import { dispatchKeyEvent } from "./dispatch.js";
+import { SERVER_ENVIRONMENT, currentEnvironment } from "./platform.js";
+import { ShortcutRegistry } from "./registry.js";
+const ShortcutContext = createContext(null);
+/**
+ * The web client's one keyboard layer. Mounted once, by `AppChrome` (the frame that stays mounted as the router swaps pages), so shortcuts
+ * work in every view - mail, calendar, contacts, tasks, settings - and a page change only changes which handlers are registered.
+ *
+ * One `keydown` listener on `document` (bubbling, so what a widget handles itself and `preventDefault()`s is left alone) hands each key to
+ * `dispatchKeyEvent()`. Views claim keys with `useShortcut()`. Outside a provider - an admin page, a component rendered on its own - that
+ * hook does nothing.
+ *
+ * The platform (macOS, the desktop client) is read after mount, never during render, so the server render and hydration agree.
+ */
+export function ShortcutProvider({ children }) {
+    const registry = useMemo(() => new ShortcutRegistry(), []);
+    const [env, setEnv] = useState(SERVER_ENVIRONMENT);
+    useEffect(() => {
+        setEnv(currentEnvironment());
+    }, []);
+    useEffect(() => {
+        function handleKeyDown(event) {
+            dispatchKeyEvent(registry, event, currentEnvironment(), document);
+        }
+        document.addEventListener("keydown", handleKeyDown);
+        return () => document.removeEventListener("keydown", handleKeyDown);
+    }, [registry]);
+    const value = useMemo(() => ({ registry, env }), [registry, env]);
+    return _jsx(ShortcutContext.Provider, { value: value, children: children });
+}
+/** The registry, or `null` outside a `ShortcutProvider`. */
+export function useShortcutRegistry() {
+    return useContext(ShortcutContext)?.registry ?? null;
+}
+/** The platform as the keyboard layer sees it - `SERVER_ENVIRONMENT` until the client has mounted, and outside a provider. */
+export function useKeyEnvironment() {
+    return useContext(ShortcutContext)?.env ?? SERVER_ENVIRONMENT;
+}
+const NO_REGISTRATIONS = [];
+const getNoRegistrations = () => NO_REGISTRATIONS;
+const NEVER = () => () => undefined;
+/** Everything registered right now, updating as views mount and unmount - what the help dialog lists. Empty outside a provider. */
+export function useRegisteredShortcuts() {
+    const registry = useShortcutRegistry();
+    return useSyncExternalStore(registry?.subscribe ?? NEVER, registry?.getSnapshot ?? getNoRegistrations, getNoRegistrations);
+}

package/dist/apps/shared/keyboard/ShortcutsDialog.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+export interface ShortcutsDialogProps {
+    open: boolean;
+    onClose: () => void;
+}
+/**
+ * The keyboard shortcuts help dialog: what can be done from the keyboard *here*. It lists what is registered right now (see
+ * `useRegisteredShortcuts()`), so it shows the global shortcuts and those of the view that is on screen - and the compose window's while one
+ * is open - in groups, with the platform's own key names (Ctrl or Cmd, Alt or Option), and in the desktop client also the keys only it has.
+ * A shortcut a view cannot do at the moment (no message selected) is not registered, and so not listed.
+ *
+ * Built on `Modal`: focus moves into the dialog and stays there, Escape closes it, and it has an accessible name. `?` and Ctrl+/ close it too.
+ */
+export default function ShortcutsDialog({ open, onClose }: ShortcutsDialogProps): React.JSX.Element | null;

package/dist/apps/shared/keyboard/ShortcutsDialog.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import React from "react";
+import Modal from "@rapidmx/react-shared/components/overlays/Modal.js";
+import { formatSpec, specsFor } from "./format.js";
+import { HELP_SCOPES, SCOPE_LABELS, SHORTCUTS, shortcutRank } from "./keymap.js";
+import { useKeyEnvironment, useRegisteredShortcuts } from "./ShortcutProvider.js";
+import { useShortcut } from "./useShortcut.js";
+function Keys({ shortcut }) {
+    const env = useKeyEnvironment();
+    return (_jsx("span", { className: "flex flex-wrap justify-end gap-x-1.5 gap-y-1 shrink-0", children: specsFor(shortcut, env).map((spec, index) => (_jsxs(React.Fragment, { children: [index > 0 && _jsx("span", { className: "text-xs text-text-muted self-center", children: "or" }), _jsx("kbd", { className: "px-1.5 py-0.5 rounded-sm border border-border bg-surface-alt text-xs font-sans font-semibold whitespace-nowrap", children: formatSpec(spec, env) })] }, spec))) }));
+}
+/**
+ * The keyboard shortcuts help dialog: what can be done from the keyboard *here*. It lists what is registered right now (see
+ * `useRegisteredShortcuts()`), so it shows the global shortcuts and those of the view that is on screen - and the compose window's while one
+ * is open - in groups, with the platform's own key names (Ctrl or Cmd, Alt or Option), and in the desktop client also the keys only it has.
+ * A shortcut a view cannot do at the moment (no message selected) is not registered, and so not listed.
+ *
+ * Built on `Modal`: focus moves into the dialog and stays there, Escape closes it, and it has an accessible name. `?` and Ctrl+/ close it too.
+ */
+export default function ShortcutsDialog({ open, onClose }) {
+    // Mounted only while open: the body subscribes to the registry, which every view's shortcuts change as it mounts - not something the
+    // whole app should re-render for while the dialog is closed.
+    return open ? _jsx(ShortcutsDialogBody, { onClose: onClose }) : null;
+}
+function ShortcutsDialogBody({ onClose }) {
+    const registrations = useRegisteredShortcuts();
+    useShortcut(SHORTCUTS.global.help, onClose, { scope: "dialog" });
+    const groups = HELP_SCOPES.map((scope) => {
+        const listed = new Map();
+        for (const registration of registrations) {
+            if (registration.scope === scope) {
+                listed.set(registration.shortcut.id, registration.shortcut);
+            }
+        }
+        return { scope, shortcuts: [...listed.values()].sort((a, b) => shortcutRank(a) - shortcutRank(b)) };
+    }).filter((group) => group.shortcuts.length > 0);
+    return (_jsx(Modal, { open: true, onClose: onClose, title: "Keyboard shortcuts", children: _jsxs("div", { className: "flex flex-col gap-5", children: [groups.map(({ scope, shortcuts }) => (_jsxs("section", { "aria-labelledby": `shortcuts-${scope}`, children: [_jsx("h3", { id: `shortcuts-${scope}`, className: "text-xs font-bold uppercase tracking-wide text-text-muted mb-2", children: SCOPE_LABELS[scope] }), _jsx("ul", { className: "flex flex-col gap-1.5", children: shortcuts.map((shortcut) => (_jsxs("li", { className: "flex items-start justify-between gap-4 text-sm", children: [_jsx("span", { children: shortcut.label }), _jsx(Keys, { shortcut: shortcut })] }, shortcut.id))) })] }, scope))), _jsx("p", { className: "text-xs text-text-muted border-t border-border pt-3", children: "Some browsers keep a few keys for themselves, so a shortcut may not work everywhere." })] }) }));
+}

package/dist/apps/shared/keyboard/dispatch.d.ts

@@ -0,0 +1,16 @@
+import type { KeyEnvironment } from "./platform.js";
+import type { ShortcutRegistry } from "./registry.js";
+/**
+ * Handles one `keydown`: finds the registered shortcut it is, and runs its handler. Returns whether a handler ran - and only then is the
+ * event's default prevented and its propagation stopped, so a key nobody claims (or a handler that declines) behaves exactly as if this layer
+ * did not exist.
+ *
+ * Skipped outright: an event some other handler already `defaultPrevented` (a menu, the rich-text editor's own bindings), one from an IME
+ * composition, a bare modifier key, and the Copy/Cut/Paste/Select all/Undo/Redo/Find chords. A held key repeats: an action that is not
+ * marked `repeat` runs on the first press only, and the repeats are swallowed (so a browser doesn't reload on a held Ctrl+R) without running it.
+ *
+ * Which registration wins: the dialog scope alone while a modal is open; else, inside a compose window, `compose` then `global`; else
+ * whichever view is mounted, then `global`. Within a scope the most recently mounted registration goes first, and one that returns
+ * `false` passes the key on to the next.
+ */
+export declare function dispatchKeyEvent(registry: ShortcutRegistry, event: KeyboardEvent, env: KeyEnvironment, doc: Document): boolean;

package/dist/apps/shared/keyboard/dispatch.js

@@ -0,0 +1,109 @@
+import { matchesEvent } from "./match.js";
+import { resolveModifiers } from "./parse.js";
+import { isActivatable, isInPopoverDialog, isInWidget, isModalOpen, isPopupOpenAt, isTextEntry, regionScopeOf } from "./targets.js";
+/** The keys of the four view scopes: only the mounted view has registrations, so precedence among them is moot. */
+const VIEW_SCOPES = ["mail", "calendar", "contacts", "tasks"];
+/** Keys that move the caret or delete text, which a text field owns even with Ctrl or Alt held (word jumps, delete-word). */
+const EDITING_KEYS = new Set(["arrowup", "arrowdown", "arrowleft", "arrowright", "home", "end", "pageup", "pagedown", "backspace", "delete"]);
+/** The Copy / Cut / Paste / Select all / Undo / Redo / Find chords: never a shortcut, anywhere - they act on the page's selection, not on a view. */
+function isReservedChord(parsed, env) {
+    const modifiers = resolveModifiers(parsed, env);
+    return (modifiers.ctrl || modifiers.meta) && !modifiers.alt && !modifiers.shift && ["a", "c", "v", "x", "z", "y", "f"].includes(parsed.key);
+}
+/** Paste as plain text (Ctrl+Shift+V) and Redo (Ctrl+Shift+Z): text-editing chords in a field, free everywhere else (Ctrl+Shift+V is Move to). */
+function isShiftedEditingChord(parsed, env) {
+    const modifiers = resolveModifiers(parsed, env);
+    return (modifiers.ctrl || modifiers.meta) && !modifiers.alt && modifiers.shift && ["z", "v"].includes(parsed.key);
+}
+/**
+ * Whether `parsed` may fire with the event on this target.
+ *
+ * A text field (input, textarea, select, contenteditable - the rich-text editor) keeps everything that types or edits: bare keys
+ * (`j`, `?`, Delete), the caret keys with any modifier, and paste-as-plain-text and redo. A chord with Ctrl/Cmd/Alt works from one (that is how Ctrl+Enter sends from
+ * the body), except that Option on a Mac and Ctrl+Alt (AltGr) elsewhere type characters, so those don't. Escape works from a field unless a
+ * popup it owns is open (or it is in a popover dialog of its own). Outside a field, a bare key still isn't taken from a widget that reads keys itself (an open menu, a list box), and
+ * Enter/Space are left to the button or link that has the focus - unless the shortcut asked for them.
+ */
+function allowedOnTarget(registration, parsed, target, env) {
+    const modifiers = resolveModifiers(parsed, env);
+    const command = modifiers.ctrl || modifiers.meta || modifiers.alt;
+    if (parsed.key === "escape" && (isPopupOpenAt(target) || isInPopoverDialog(target))) {
+        return false;
+    }
+    if (isTextEntry(target)) {
+        if (parsed.key === "escape") {
+            return true;
+        }
+        if (!command || EDITING_KEYS.has(parsed.key) || isShiftedEditingChord(parsed, env)) {
+            return false;
+        }
+        return !(modifiers.alt && !modifiers.meta && (env.mac || modifiers.ctrl));
+    }
+    if (!command) {
+        if (isInWidget(target)) {
+            return false;
+        }
+        if ((parsed.key === "enter" || parsed.key === " ") && !registration.shortcut.allowOnActivatable && isActivatable(target)) {
+            return false;
+        }
+    }
+    return true;
+}
+/** The scopes that may act on this event, highest precedence first. */
+function activeScopes(event, doc) {
+    if (isModalOpen(doc)) {
+        return ["dialog"];
+    }
+    if (regionScopeOf(event.target) === "compose") {
+        return ["compose", "global"];
+    }
+    return [...VIEW_SCOPES, "global"];
+}
+/** Whether the registration applies to where the event happened (a compose window's shortcuts only inside it). */
+function inContainer(registration, event) {
+    if (!registration.container) {
+        return true;
+    }
+    return !!registration.container.current?.contains(event.target);
+}
+/**
+ * Handles one `keydown`: finds the registered shortcut it is, and runs its handler. Returns whether a handler ran - and only then is the
+ * event's default prevented and its propagation stopped, so a key nobody claims (or a handler that declines) behaves exactly as if this layer
+ * did not exist.
+ *
+ * Skipped outright: an event some other handler already `defaultPrevented` (a menu, the rich-text editor's own bindings), one from an IME
+ * composition, a bare modifier key, and the Copy/Cut/Paste/Select all/Undo/Redo/Find chords. A held key repeats: an action that is not
+ * marked `repeat` runs on the first press only, and the repeats are swallowed (so a browser doesn't reload on a held Ctrl+R) without running it.
+ *
+ * Which registration wins: the dialog scope alone while a modal is open; else, inside a compose window, `compose` then `global`; else
+ * whichever view is mounted, then `global`. Within a scope the most recently mounted registration goes first, and one that returns
+ * `false` passes the key on to the next.
+ */
+export function dispatchKeyEvent(registry, event, env, doc) {
+    if (event.defaultPrevented || event.isComposing || event.key === "Process" || ["Control", "Shift", "Alt", "Meta"].includes(event.key)) {
+        return false;
+    }
+    const scopes = activeScopes(event, doc);
+    const candidates = registry
+        .getSnapshot()
+        .filter((registration) => scopes.includes(registration.scope) && inContainer(registration, event))
+        .sort((a, b) => scopes.indexOf(a.scope) - scopes.indexOf(b.scope) || b.order - a.order);
+    for (const registration of candidates) {
+        const specs = env.electron ? [...registration.keys, ...registration.electronKeys] : registration.keys;
+        const parsed = specs.find((spec) => matchesEvent(spec, event, env));
+        if (!parsed || isReservedChord(parsed, env) || !allowedOnTarget(registration, parsed, event.target, env)) {
+            continue;
+        }
+        if (event.repeat && !registration.shortcut.repeat) {
+            event.preventDefault();
+            event.stopPropagation();
+            return true;
+        }
+        if (registration.run(event) !== false) {
+            event.preventDefault();
+            event.stopPropagation();
+            return true;
+        }
+    }
+    return false;
+}

package/dist/apps/shared/keyboard/format.d.ts

@@ -0,0 +1,12 @@
+import type { ShortcutDef } from "./keymap.js";
+import type { KeyEnvironment } from "./platform.js";
+/** A spec as a person reads it: `Ctrl+Shift+R`, or `⌃⇧R`-style glyphs on a Mac (`⌘` for Cmd, `⌥` for Option). */
+export declare function formatSpec(spec: string, env: KeyEnvironment): string;
+/** A spec in `aria-keyshortcuts` syntax: `Control+Shift+R`, `Meta+R`. */
+export declare function ariaSpec(spec: string, env: KeyEnvironment): string;
+/** Every spec that triggers a shortcut here: its keys, and in the desktop client also its desktop-only ones. */
+export declare function specsFor(shortcut: ShortcutDef, env: KeyEnvironment): string[];
+/** The `aria-keyshortcuts` value for a control that runs a shortcut: every alternative, space separated. */
+export declare function ariaKeyShortcuts(shortcut: ShortcutDef, env: KeyEnvironment): string;
+/** A tooltip/name suffix such as `Reply (Ctrl+R)`: the label with the shortcut's first key. */
+export declare function withHint(label: string, shortcut: ShortcutDef, env: KeyEnvironment): string;

package/dist/apps/shared/keyboard/format.js

@@ -0,0 +1,74 @@
+import { parseSpec, resolveModifiers } from "./parse.js";
+const KEY_NAMES = {
+    escape: "Esc",
+    enter: "Enter",
+    tab: "Tab",
+    backspace: "Backspace",
+    delete: "Delete",
+    insert: "Insert",
+    home: "Home",
+    end: "End",
+    pageup: "Page Up",
+    pagedown: "Page Down",
+    arrowup: "↑",
+    arrowdown: "↓",
+    arrowleft: "←",
+    arrowright: "→",
+    " ": "Space",
+};
+const MAC_KEY_NAMES = { ...KEY_NAMES, enter: "↩", backspace: "⌫", delete: "⌦" };
+/** The key as it is printed on a key cap: `R`, `F5`, `Enter`, an arrow. */
+function keyLabel(key, mac) {
+    return (mac ? MAC_KEY_NAMES : KEY_NAMES)[key] ?? key.toUpperCase();
+}
+/** A spec as a person reads it: `Ctrl+Shift+R`, or `⌃⇧R`-style glyphs on a Mac (`⌘` for Cmd, `⌥` for Option). */
+export function formatSpec(spec, env) {
+    const parsed = parseSpec(spec);
+    const modifiers = resolveModifiers(parsed, env);
+    if (env.mac) {
+        return [modifiers.ctrl && "⌃", modifiers.alt && "⌥", modifiers.shift && "⇧", modifiers.meta && "⌘", keyLabel(parsed.key, true)]
+            .filter(Boolean)
+            .join("");
+    }
+    return [modifiers.ctrl && "Ctrl", modifiers.shift && "Shift", modifiers.alt && "Alt", modifiers.meta && "Meta", keyLabel(parsed.key, false)]
+        .filter(Boolean)
+        .join("+");
+}
+const ARIA_NAMED_KEYS = {
+    escape: "Escape",
+    enter: "Enter",
+    tab: "Tab",
+    backspace: "Backspace",
+    delete: "Delete",
+    insert: "Insert",
+    home: "Home",
+    end: "End",
+    pageup: "PageUp",
+    pagedown: "PageDown",
+    arrowup: "ArrowUp",
+    arrowdown: "ArrowDown",
+    arrowleft: "ArrowLeft",
+    arrowright: "ArrowRight",
+    " ": "Space",
+};
+/** A spec in `aria-keyshortcuts` syntax: `Control+Shift+R`, `Meta+R`. */
+export function ariaSpec(spec, env) {
+    const parsed = parseSpec(spec);
+    const modifiers = resolveModifiers(parsed, env);
+    const key = ARIA_NAMED_KEYS[parsed.key] ?? parsed.key.toUpperCase();
+    return [modifiers.ctrl && "Control", modifiers.alt && "Alt", modifiers.shift && "Shift", modifiers.meta && "Meta", key].filter(Boolean).join("+");
+}
+/** Every spec that triggers a shortcut here: its keys, and in the desktop client also its desktop-only ones. */
+export function specsFor(shortcut, env) {
+    return env.electron && shortcut.electronKeys ? [...shortcut.keys, ...shortcut.electronKeys] : [...shortcut.keys];
+}
+/** The `aria-keyshortcuts` value for a control that runs a shortcut: every alternative, space separated. */
+export function ariaKeyShortcuts(shortcut, env) {
+    return specsFor(shortcut, env)
+        .map((spec) => ariaSpec(spec, env))
+        .join(" ");
+}
+/** A tooltip/name suffix such as `Reply (Ctrl+R)`: the label with the shortcut's first key. */
+export function withHint(label, shortcut, env) {
+    return `${label} (${formatSpec(shortcut.keys[0], env)})`;
+}

package/dist/apps/shared/keyboard/keymap.d.ts

@@ -0,0 +1,294 @@
+/**
+ * Where a shortcut applies. `global` works in every view; a view scope (`mail`, `calendar`, `contacts`, `tasks`) exists only while that
+ * view is mounted; `compose` applies while focus is inside a compose window; `dialog` is for what a modal dialog binds itself - a
+ * dialog on screen silences every other scope.
+ */
+export type ShortcutScope = "global" | "mail" | "compose" | "calendar" | "contacts" | "tasks" | "dialog";
+/** The scopes the help dialog lists, in the order it lists them. */
+export declare const HELP_SCOPES: readonly ShortcutScope[];
+export declare const SCOPE_LABELS: Record<ShortcutScope, string>;
+/** One action the keyboard can trigger, and the keys that trigger it. Views register handlers for these; nothing else defines a key. */
+export interface ShortcutDef {
+    /** Stable name, unique across the map - what the help dialog de-duplicates on. */
+    id: string;
+    /** Specs (see `parseSpec()`) that trigger it, the first being the one shown first. `mod` is Ctrl, or Cmd on macOS. */
+    keys: readonly string[];
+    /** Extra specs that apply only in the desktop client, where the browser's own reserved keys (Ctrl+N, Ctrl+T) are the app's. */
+    electronKeys?: readonly string[];
+    /** What the help dialog and a button's tooltip call it. */
+    label: string;
+    scope: ShortcutScope;
+    /** Fires from a focused button or link too (Enter on a message row); by default Enter/Space are left to what has the focus. */
+    allowOnActivatable?: boolean;
+    /** Keeps firing while the key is held (arrows); by default a held key runs a one-shot action once. */
+    repeat?: boolean;
+}
+/**
+ * The whole key map, in the order the help dialog lists it. The navigation set is literally Ctrl+Shift+<letter> on every platform (Cmd+Shift
+ * on macOS collides with the browsers' own - Cmd+Shift+A/B/C/L/M/S are tab search, the bookmarks bar, Inspect, the sidebar, the profile
+ * switcher and Save As - so it is not offered); the mail actions use `mod`, so Reply is Ctrl+R on Windows and Linux and Cmd+R on a Mac.
+ * Ctrl+Q (mark read) stays Ctrl on a Mac because Cmd+Q is the system's Quit.
+ */
+export declare const SHORTCUTS: {
+    readonly global: {
+        readonly account: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "global";
+        };
+        readonly settings: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "global";
+        };
+        readonly contacts: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "global";
+        };
+        readonly mail: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "global";
+        };
+        readonly calendar: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "global";
+        };
+        readonly tasks: {
+            id: string;
+            keys: string[];
+            electronKeys: string[];
+            label: string;
+            scope: "global";
+        };
+        readonly help: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "global";
+        };
+    };
+    readonly mail: {
+        readonly create: {
+            id: string;
+            keys: string[];
+            electronKeys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly reply: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly replyAll: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly forward: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly delete: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly archive: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly move: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly markRead: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly markUnread: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly flag: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly next: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+            repeat: true;
+        };
+        readonly previous: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+            repeat: true;
+        };
+        readonly nextUnread: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly previousUnread: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly open: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+            allowOnActivatable: true;
+        };
+        readonly close: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+        readonly search: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "mail";
+        };
+    };
+    readonly compose: {
+        readonly create: {
+            id: string;
+            keys: string[];
+            electronKeys: string[];
+            label: string;
+            scope: "compose";
+        };
+        readonly send: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "compose";
+        };
+        readonly saveDraft: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "compose";
+        };
+        readonly close: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "compose";
+        };
+    };
+    readonly calendar: {
+        readonly create: {
+            id: string;
+            keys: string[];
+            electronKeys: string[];
+            label: string;
+            scope: "calendar";
+        };
+        readonly today: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "calendar";
+        };
+        readonly previous: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "calendar";
+            repeat: true;
+        };
+        readonly next: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "calendar";
+            repeat: true;
+        };
+        readonly day: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "calendar";
+        };
+        readonly workWeek: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "calendar";
+        };
+        readonly week: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "calendar";
+        };
+        readonly month: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "calendar";
+        };
+    };
+    readonly contacts: {
+        readonly create: {
+            id: string;
+            keys: string[];
+            electronKeys: string[];
+            label: string;
+            scope: "contacts";
+        };
+        readonly search: {
+            id: string;
+            keys: string[];
+            label: string;
+            scope: "contacts";
+        };
+    };
+    readonly tasks: {
+        readonly create: {
+            id: string;
+            keys: string[];
+            electronKeys: string[];
+            label: string;
+            scope: "tasks";
+        };
+    };
+};
+/** Every shortcut of the map flattened, in listing order. */
+export declare const ALL_SHORTCUTS: readonly ShortcutDef[];
+/** Where a shortcut sits in the listing, for ordering registrations that arrive in whatever order components mount. */
+export declare function shortcutRank(shortcut: ShortcutDef): number;