/**
 * Pure workbench-chrome logic: the keyboard-shortcut mapping plus the
 * theme/locale snapshot shape the panel header renders, and the toggle
 * targets for both switches. DOM-free so the mapping is unit-testable —
 * ResearchPanel adapts KeyboardEvent into {@link ShortcutInput}, and the
 * plugin entry adapts ctx.theme/ctx.locale into {@link WorkbenchChrome}.
 * @module dsh-client-ui-mimir/client/shortcuts
 */
import type { ResearchTab } from './store.ts';
/** The nine view tabs in rail order — also the `1`–`9` shortcut order. */
export declare const TABS: readonly ResearchTab[];
/** The panel header's chrome snapshot: resolved color scheme + active locale. */
export interface WorkbenchChrome {
    /** Whether the host's dark base palette is active (`system` already resolved). */
    dark: boolean;
    /** The host's active locale id ('zh' | 'en'). */
    locale: string;
}
/** DOM-free view of one keydown: exactly the fields the mapping reads. */
export interface ShortcutInput {
    key: string;
    metaKey: boolean;
    ctrlKey: boolean;
    altKey: boolean;
    /** Whether the event target is a text-entry surface (input, textarea, contenteditable). */
    editable: boolean;
    /** Whether a paper-view pane currently holds fullscreen (Esc exits it before closing). */
    fullscreen: boolean;
}
/** What one keydown asks the workbench to do. */
export type ShortcutAction = {
    type: 'tab';
    tab: ResearchTab;
} | {
    type: 'close';
} | {
    type: 'exit-fullscreen';
} | {
    type: 'compile';
};
/**
 * Map one keydown to a workbench action. The caller gates on the panel being
 * open; the mapping itself refuses every combo while a text-entry surface
 * holds focus, so the editor's own keystrokes (and the browser's alt-menu
 * accelerators) pass through untouched. `1`–`9` pick the rail tab in
 * {@link TABS} order, `Escape` exits a fullscreened pane first and closes the
 * panel only when nothing is fullscreened, ⌘/Ctrl+Enter asks for a compile
 * (the caller gates on the paper view and a selected project).
 * @param input - the keydown fields.
 * @returns the action, or null when the keydown is not a workbench shortcut.
 */
export declare function shortcutFor(input: ShortcutInput): ShortcutAction | null;
/** The preference the theme toggle writes: the opposite of the resolved scheme. */
export declare function nextColorScheme(dark: boolean): 'light' | 'dark';
/** The locale the language toggle switches to. */
export declare function nextLocale(locale: string): 'zh' | 'en';
//# sourceMappingURL=shortcuts.d.ts.map