@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/kernel/kernel-context.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Kernel Context - Four-Tier Architecture
+ *
+ * OS Refactor - Kernel provides four levels of context:
+ *
+ * 1. IDomainContext (minimal)
+ *    - For domain modules (kernel/domain/)
+ *    - NO bridges - just event bus and undo labeling
+ *
+ * 2. IKernelContext (general-purpose)
+ *    - For any app type (spreadsheet, CRM, kanban, docs)
+ *    - Event bus, services, destroy() — no app-specific bridges
+ *
+ * 3. ISpreadsheetKernelContext (spreadsheet-specific)
+ *    - Extends IKernelContext with all spreadsheet bridges
+ *    - For spreadsheet Shell and app layer
+ *
+ * 4. DocumentContext (engine internals, defined in kernel)
+ *    - Extends ISpreadsheetKernelContext with compute bridge, viewport buffers
+ *
+ * All generic interfaces default to SpreadsheetEvent, so existing code that
+ * doesn't pass a type parameter keeps working unchanged.
+ */
+import type { IChartBridge, IEquationBridge, IInkRecognitionBridge, ILocaleBridge, IPivotBridge, ISchemaBridge, ISmartArtBridge, IWordArtRenderingBridge } from '../bridges';
+import type { IFloatingObjectManager } from './floating-object-manager';
+import type { PivotExpansionStateProvider } from '../data/pivot';
+import type { IEventBus, SpreadsheetEvent } from '../events';
+import type { IKernelServices } from '../services';
+export interface ISlicerBridge {
+}
+/**
+ * Minimal context for domain modules (kernel/domain/).
+ *
+ * This interface provides ONLY event bus and undo labeling - NO bridges.
+ * Domain modules should use this to ensure they don't accidentally depend
+ * on computation engines.
+ *
+ * Generic over event type — defaults to SpreadsheetEvent for backward compat.
+ * The name tells you who you are: "Am I writing domain code? Use IDomainContext."
+ */
+export interface IDomainContext<TEvent extends {
+    type: string;
+} = SpreadsheetEvent> {
+    /** Event bus for emitting Kernel events */
+    readonly eventBus: IEventBus<TEvent>;
+    /**
+     * Set pending undo description for the next undo stack item.
+     * Call this BEFORE performing an operation to label the undo entry.
+     */
+    setPendingUndoDescription(description: string): void;
+    /**
+     * Get the pending undo description (consumed by undo service).
+     * @internal
+     */
+    getPendingUndoDescription(): string | null;
+    /**
+     * Clear the pending undo description after it's been consumed.
+     * @internal
+     */
+    clearPendingUndoDescription(): void;
+}
+/**
+ * General-purpose kernel context for any app type.
+ *
+ * This extends IDomainContext with:
+ * - Services (clipboard, undo, notifications, queries)
+ * - destroy() for cleanup
+ *
+ * App-specific bridges are NOT on this interface. Spreadsheet bridges
+ * live on ISpreadsheetKernelContext. Future app types (CRM, kanban, docs)
+ * would define their own extension interfaces.
+ *
+ * Generic over event type — defaults to SpreadsheetEvent for backward compat.
+ */
+export interface IKernelContext<TEvent extends {
+    type: string;
+} = SpreadsheetEvent> extends IDomainContext<TEvent> {
+    /**
+     * System services that survive app switches.
+     * These are cross-app services available to all apps.
+     *
+     * NOTE: Optional during migration. Will be required once all
+     * consumers are updated to provide services.
+     */
+    readonly services?: IKernelServices;
+    /**
+     * Cleanup all bridges and resources.
+     * Called by DocumentProvider on unmount.
+     */
+    destroy(): void;
+}
+/**
+ * Spreadsheet-specific kernel context for Shell and app layer.
+ *
+ * Extends the general-purpose IKernelContext with all spreadsheet bridges.
+ * This is what DocumentFactory exposes and what the spreadsheet app uses.
+ *
+ * Other app types (CRM, kanban, docs) would define their own extension
+ * interfaces with their own bridges, extending IKernelContext directly.
+ */
+export interface ISpreadsheetKernelContext extends IKernelContext<SpreadsheetEvent> {
+    /**
+     * Provider for pivot table expansion state (which groups are expanded/collapsed).
+     * Owned and managed by the app layer; injected into the kernel after context creation.
+     * Optional — if not set, pivot computations use default (all expanded) state.
+     */
+    pivotExpansionProvider?: PivotExpansionStateProvider;
+    /** Pivot bridge - pivot table computation and caching */
+    readonly pivot: IPivotBridge;
+    /** Schema bridge - data validation */
+    readonly schema: ISchemaBridge;
+    /** Chart bridge - chart rendering and updates */
+    readonly charts: IChartBridge;
+    /** Locale bridge - locale-aware input normalization */
+    readonly locale: ILocaleBridge;
+    /** Slicer bridge - slicer filtering (future) */
+    readonly slicer?: ISlicerBridge;
+    /** Ink recognition bridge for converting ink strokes to shapes/text */
+    readonly inkRecognition: IInkRecognitionBridge;
+    /** WordArt rendering bridge for computing and rendering WordArt */
+    readonly wordArtRendering: IWordArtRenderingBridge;
+    /** Equation bridge for OMML and LaTeX parsing */
+    readonly equationBridge: IEquationBridge;
+    /** SmartArt bridge for diagram management and layout computation */
+    readonly smartArt: ISmartArtBridge;
+    /** Floating object manager — document-scoped singleton for object CRUD, transforms, ordering */
+    readonly floatingObjectManager: IFloatingObjectManager;
+}
+//# sourceMappingURL=kernel-context.d.ts.map

package/dist/kernel/kernel-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-context.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,EACf,uBAAuB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,WAAW,aAAa;CAAG;AAMjC;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB;IAChF,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAErC;;;OAGG;IACH,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAErD;;;OAGG;IACH,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAAC;IAE3C;;;OAGG;IACH,2BAA2B,IAAI,IAAI,CAAC;CACrC;AAMD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc,CAC7B,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAClD,SAAQ,cAAc,CAAC,MAAM,CAAC;IAK9B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAMpC;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,yBAA0B,SAAQ,cAAc,CAAC,gBAAgB,CAAC;IAKjF;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,2BAA2B,CAAC;IAMrD,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAE7B,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAMhC,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAE/C,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,EAAE,uBAAuB,CAAC;IAEnD,iDAAiD;IACjD,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IAEzC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAMnC,gGAAgG;IAChG,QAAQ,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;CACxD"}

package/dist/keyboard/actions.d.ts

@@ -0,0 +1,328 @@
+/**
+ * Keyboard Actions - Machine Events
+ *
+ * These types define all keyboard-triggered events that are sent to XState machines.
+ * The KeyboardCoordinator dispatches these events based on the shortcut registry.
+ *
+ * ARCHITECTURE:
+ * - Each action type maps to an event that a specific machine handles
+ * - The coordinator routes events to the correct machine based on action type
+ * - Actions are discriminated unions for type-safe dispatch
+ *
+ * @see plans/systematic-parity/1-keyboard-parity.md
+ */
+/**
+ * Target handler for keyboard actions.
+ * Used by KeyboardCoordinator to route events.
+ */
+export type ActionTarget = 'selection' | 'editor' | 'clipboard' | 'store' | 'ui' | 'workbook' | 'object';
+export type SelectionKeyboardAction = {
+    type: 'MOVE_UP';
+} | {
+    type: 'MOVE_DOWN';
+} | {
+    type: 'MOVE_LEFT';
+} | {
+    type: 'MOVE_RIGHT';
+} | {
+    type: 'MOVE_TO_EDGE_UP';
+} | {
+    type: 'MOVE_TO_EDGE_DOWN';
+} | {
+    type: 'MOVE_TO_EDGE_LEFT';
+} | {
+    type: 'MOVE_TO_EDGE_RIGHT';
+} | {
+    type: 'MOVE_TO_ROW_START';
+} | {
+    type: 'MOVE_TO_ROW_END';
+} | {
+    type: 'MOVE_TO_A1';
+} | {
+    type: 'MOVE_TO_LAST_USED_CELL';
+} | {
+    type: 'PAGE_UP';
+} | {
+    type: 'PAGE_DOWN';
+} | {
+    type: 'PAGE_LEFT';
+} | {
+    type: 'PAGE_RIGHT';
+} | {
+    type: 'TAB_FORWARD';
+} | {
+    type: 'TAB_BACKWARD';
+} | {
+    type: 'ENTER_NAVIGATE';
+} | {
+    type: 'SHIFT_ENTER_NAVIGATE';
+} | {
+    type: 'EXTEND_SELECTION_UP';
+} | {
+    type: 'EXTEND_SELECTION_DOWN';
+} | {
+    type: 'EXTEND_SELECTION_LEFT';
+} | {
+    type: 'EXTEND_SELECTION_RIGHT';
+} | {
+    type: 'EXTEND_TO_EDGE_UP';
+} | {
+    type: 'EXTEND_TO_EDGE_DOWN';
+} | {
+    type: 'EXTEND_TO_EDGE_LEFT';
+} | {
+    type: 'EXTEND_TO_EDGE_RIGHT';
+} | {
+    type: 'EXTEND_TO_ROW_START';
+} | {
+    type: 'EXTEND_TO_A1';
+} | {
+    type: 'EXTEND_TO_LAST_USED_CELL';
+} | {
+    type: 'SELECT_ALL';
+} | {
+    type: 'SELECT_CURRENT_REGION';
+} | {
+    type: 'SELECT_ENTIRE_ROW';
+} | {
+    type: 'SELECT_ENTIRE_COLUMN';
+} | {
+    type: 'SELECT_PRECEDENTS';
+} | {
+    type: 'SELECT_DEPENDENTS';
+} | {
+    type: 'SELECT_VISIBLE_CELLS';
+} | {
+    type: 'TOGGLE_ADD_TO_SELECTION';
+} | {
+    type: 'SELECT_BLANKS';
+} | {
+    type: 'SELECT_CONSTANTS';
+} | {
+    type: 'SELECT_FORMULAS';
+} | {
+    type: 'SELECT_NUMBERS';
+} | {
+    type: 'SELECT_TEXT';
+} | {
+    type: 'SELECT_LOGICALS';
+} | {
+    type: 'SELECT_ERRORS';
+} | {
+    type: 'SELECT_ROW_DIFFERENCES';
+} | {
+    type: 'SELECT_COLUMN_DIFFERENCES';
+};
+export type EditorKeyboardAction = {
+    type: 'EDIT_CELL';
+} | {
+    type: 'COMMIT_AND_MOVE_DOWN';
+} | {
+    type: 'COMMIT_AND_MOVE_UP';
+} | {
+    type: 'COMMIT_AND_MOVE_LEFT';
+} | {
+    type: 'COMMIT_AND_MOVE_RIGHT';
+} | {
+    type: 'CANCEL_EDIT';
+} | {
+    type: 'INSERT_NEWLINE';
+} | {
+    type: 'START_FORMULA';
+} | {
+    type: 'CLEAR_CONTENTS';
+} | {
+    type: 'CLEAR_AND_EDIT';
+} | {
+    type: 'DELETE_TO_END_OF_LINE';
+} | {
+    type: 'FILL_DOWN';
+} | {
+    type: 'FILL_RIGHT';
+} | {
+    type: 'FILL_SELECTION';
+} | {
+    type: 'INSERT_CURRENT_DATE';
+} | {
+    type: 'INSERT_CURRENT_TIME';
+} | {
+    type: 'COPY_VALUE_FROM_ABOVE';
+} | {
+    type: 'COPY_FORMULA_FROM_ABOVE';
+} | {
+    type: 'CYCLE_REFERENCE';
+} | {
+    type: 'ENTER_ARRAY_FORMULA';
+} | {
+    type: 'INSERT_FUNCTION_ARGS';
+} | {
+    type: 'PASTE_NAME_IN_FORMULA';
+} | {
+    type: 'AUTO_SUM';
+};
+export type ClipboardKeyboardAction = {
+    type: 'COPY';
+} | {
+    type: 'CUT';
+} | {
+    type: 'PASTE';
+} | {
+    type: 'OPEN_PASTE_SPECIAL_DIALOG';
+};
+export type FormattingKeyboardAction = {
+    type: 'TOGGLE_BOLD';
+} | {
+    type: 'TOGGLE_ITALIC';
+} | {
+    type: 'TOGGLE_UNDERLINE';
+} | {
+    type: 'TOGGLE_STRIKETHROUGH';
+} | {
+    type: 'INCREASE_FONT_SIZE';
+} | {
+    type: 'DECREASE_FONT_SIZE';
+} | {
+    type: 'FORMAT_GENERAL';
+} | {
+    type: 'FORMAT_NUMBER';
+} | {
+    type: 'FORMAT_TIME';
+} | {
+    type: 'FORMAT_DATE';
+} | {
+    type: 'FORMAT_CURRENCY';
+} | {
+    type: 'FORMAT_PERCENTAGE';
+} | {
+    type: 'FORMAT_SCIENTIFIC';
+} | {
+    type: 'APPLY_OUTLINE_BORDER';
+} | {
+    type: 'REMOVE_BORDERS';
+} | {
+    type: 'INSERT_TABLE';
+} | {
+    type: 'TOGGLE_MERGE';
+};
+export type DialogKeyboardAction = {
+    type: 'OPEN_GO_TO_DIALOG';
+} | {
+    type: 'OPEN_GO_TO_SPECIAL_DIALOG';
+} | {
+    type: 'OPEN_FORMAT_CELLS_DIALOG';
+} | {
+    type: 'OPEN_INSERT_FUNCTION_DIALOG';
+} | {
+    type: 'OPEN_NAME_MANAGER';
+} | {
+    type: 'OPEN_FIND_DIALOG';
+} | {
+    type: 'OPEN_FIND_REPLACE_DIALOG';
+} | {
+    type: 'OPEN_PASTE_SPECIAL_DIALOG';
+} | {
+    type: 'OPEN_DROPDOWN';
+};
+export type ViewKeyboardAction = {
+    type: 'TOGGLE_FORMULA_VIEW';
+} | {
+    type: 'TOGGLE_FORMULA_BAR_EXPAND';
+} | {
+    type: 'TOGGLE_AUTO_FILTER';
+} | {
+    type: 'TOGGLE_RIBBON';
+} | {
+    type: 'TOGGLE_RIBBON_TABS_MODE';
+} | {
+    type: 'ZOOM_IN';
+} | {
+    type: 'ZOOM_OUT';
+} | {
+    type: 'FULL_SCREEN';
+} | {
+    type: 'HIDE_ROW';
+} | {
+    type: 'UNHIDE_ROW';
+} | {
+    type: 'HIDE_COLUMN';
+} | {
+    type: 'UNHIDE_COLUMN';
+};
+export type WorkbookKeyboardAction = {
+    type: 'PREVIOUS_SHEET';
+} | {
+    type: 'NEXT_SHEET';
+} | {
+    type: 'INSERT_SHEET';
+} | {
+    type: 'GROUP';
+} | {
+    type: 'UNGROUP';
+} | {
+    type: 'SHOW_DETAIL';
+} | {
+    type: 'HIDE_DETAIL';
+};
+export type FileKeyboardAction = {
+    type: 'SAVE';
+} | {
+    type: 'OPEN';
+} | {
+    type: 'NEW_WORKBOOK';
+} | {
+    type: 'PRINT';
+} | {
+    type: 'UNDO';
+} | {
+    type: 'REDO';
+};
+export type DataKeyboardAction = {
+    type: 'FIND_NEXT';
+} | {
+    type: 'FIND_PREVIOUS';
+} | {
+    type: 'CALCULATE_ALL';
+} | {
+    type: 'CALCULATE_SHEET';
+} | {
+    type: 'CREATE_NAMES_FROM_SELECTION';
+} | {
+    type: 'EVALUATE_FORMULA_SELECTION';
+};
+export type ObjectKeyboardAction = {
+    type: 'DELETE_OBJECT';
+} | {
+    type: 'DESELECT_OBJECT';
+} | {
+    type: 'NUDGE_OBJECT_UP';
+} | {
+    type: 'NUDGE_OBJECT_DOWN';
+} | {
+    type: 'NUDGE_OBJECT_LEFT';
+} | {
+    type: 'NUDGE_OBJECT_RIGHT';
+} | {
+    type: 'NUDGE_OBJECT_UP_FINE';
+} | {
+    type: 'NUDGE_OBJECT_DOWN_FINE';
+} | {
+    type: 'NUDGE_OBJECT_LEFT_FINE';
+} | {
+    type: 'NUDGE_OBJECT_RIGHT_FINE';
+} | {
+    type: 'DUPLICATE_OBJECT';
+};
+export type NavigationKeyboardAction = {
+    type: 'FOCUS_NEXT_PANE';
+} | {
+    type: 'FOCUS_PREVIOUS_PANE';
+} | {
+    type: 'SCROLL_TO_ACTIVE_CELL';
+};
+export type KeyboardAction = SelectionKeyboardAction | EditorKeyboardAction | ClipboardKeyboardAction | FormattingKeyboardAction | DialogKeyboardAction | ViewKeyboardAction | WorkbookKeyboardAction | FileKeyboardAction | DataKeyboardAction | ObjectKeyboardAction | NavigationKeyboardAction;
+/**
+ * Maps action types to their target machine/handler.
+ * Used by KeyboardCoordinator to route events.
+ */
+export declare const ACTION_TARGET_MAP: Record<string, ActionTarget>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/keyboard/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/keyboard/actions.ts"],"names":[],"mappings":"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"}

package/dist/keyboard/binding-utils.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Binding Utilities for the Unified Keyboard System
+ *
+ * Pure helper functions for creating physical key bindings.
+ * These utilities ensure consistent binding creation across all shortcut definitions.
+ *
+ * NOTE: Additional runtime utilities (resolveBinding, parseBinding, serializeBinding, etc.)
+ * live in @mog/kernel/keyboard.
+ */
+import type { ModifierKey, PhysicalKeyCode } from './physical-keys';
+import type { PhysicalKeyBinding, PlatformKeyBindings } from './shortcuts/types';
+/**
+ * Create a physical key binding from a key code and modifiers.
+ *
+ * @param code - The physical key code
+ * @param modifiers - Zero or more modifier keys
+ * @returns A PhysicalKeyBinding
+ *
+ * @example
+ * binding('KeyC', 'ctrl')           // Ctrl+C
+ * binding('Equal', 'ctrl', 'shift') // Ctrl+Shift+= (produces '+')
+ * binding('F2')                     // F2 alone
+ */
+export declare function binding(code: PhysicalKeyCode, ...modifiers: ModifierKey[]): PhysicalKeyBinding;
+/**
+ * Create cross-platform bindings with automatic Ctrl -> Cmd translation for Mac.
+ *
+ * This is the most common pattern: Windows/Linux uses Ctrl, Mac uses Cmd.
+ * This function automatically creates both bindings.
+ *
+ * @param code - The physical key code
+ * @param modifiers - Zero or more modifier keys (use 'ctrl' for the command modifier)
+ * @returns PlatformKeyBindings with macOS Cmd automatically mapped
+ *
+ * @example
+ * crossPlatformBinding('KeyC', 'ctrl')
+ * // Returns: { default: Ctrl+C, macos: Cmd+C }
+ *
+ * crossPlatformBinding('Equal', 'ctrl', 'shift')
+ * // Returns: { default: Ctrl+Shift+=, macos: Cmd+Shift+= }
+ */
+export declare function crossPlatformBinding(code: PhysicalKeyCode, ...modifiers: ModifierKey[]): PlatformKeyBindings;
+/**
+ * Create bindings where Mac uses a completely different key.
+ *
+ * Use this when Mac requires a different physical key, not just a modifier swap.
+ *
+ * @param defaultCode - The key code for Windows/Linux
+ * @param defaultModifiers - The modifiers for Windows/Linux
+ * @param macCode - The key code for Mac
+ * @param macModifiers - The modifiers for Mac
+ * @returns PlatformKeyBindings with explicit macOS override
+ *
+ * @example
+ * // Windows: Ctrl+Home, Mac: Cmd+Fn+Left
+ * macSpecificBinding(
+ *   'Home', ['ctrl'],     // Windows binding
+ *   'ArrowLeft', ['meta', 'fn']  // Mac binding
+ * )
+ */
+export declare function macSpecificBinding(defaultCode: PhysicalKeyCode, defaultModifiers: ModifierKey[], macCode: PhysicalKeyCode, macModifiers: ModifierKey[]): PlatformKeyBindings;
+/**
+ * Create a simple binding that is the same on all platforms.
+ *
+ * Use this for keys that don't need any platform-specific handling,
+ * like F-keys, arrow keys, or shortcuts without Ctrl/Cmd.
+ *
+ * @param code - The physical key code
+ * @param modifiers - Zero or more modifier keys
+ * @returns PlatformKeyBindings
+ *
+ * @example
+ * universalBinding('F2')                // F2 on all platforms
+ * universalBinding('ArrowUp', 'shift')  // Shift+Up on all platforms
+ */
+export declare function universalBinding(code: PhysicalKeyCode, ...modifiers: ModifierKey[]): PlatformKeyBindings;
+/**
+ * Create bindings for an Alt-based shortcut.
+ *
+ * Alt shortcuts are the same on Windows/Linux and Mac (Option key).
+ *
+ * @param code - The physical key code
+ * @param additionalModifiers - Additional modifiers beyond Alt
+ * @returns PlatformKeyBindings
+ *
+ * @example
+ * altBinding('Equal')  // Alt+= on all platforms
+ */
+export declare function altBinding(code: PhysicalKeyCode, ...additionalModifiers: ModifierKey[]): PlatformKeyBindings;
+/**
+ * Determine the appropriate matchBy strategy for a given key code + modifiers.
+ *
+ * Classification rule:
+ * - Letter keys (KeyA-KeyZ) with command modifier (Ctrl/Cmd/Alt) -> 'key' (mnemonic)
+ * - Everything else -> 'code' (positional)
+ *
+ * @param code - The physical key code
+ * @param modifiers - The modifier keys
+ * @returns 'key' for mnemonic letter shortcuts, 'code' for positional
+ */
+export declare function inferMatchBy(code: PhysicalKeyCode, modifiers: readonly ModifierKey[]): 'key' | 'code';
+/**
+ * Extract the expected character from a physical key code.
+ *
+ * For letter keys (KeyA-KeyZ), returns the lowercase letter.
+ * For non-letter keys, returns undefined.
+ *
+ * @param code - The physical key code
+ * @returns The lowercase character, or undefined for non-letter keys
+ */
+export declare function extractCharacterFromCode(code: PhysicalKeyCode): string | undefined;
+//# sourceMappingURL=binding-utils.d.ts.map

package/dist/keyboard/binding-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-utils.d.ts","sourceRoot":"","sources":["../../src/keyboard/binding-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMjF;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAO9F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,GAAG,SAAS,EAAE,WAAW,EAAE,GAC1B,mBAAmB,CAiBrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,eAAe,EAC5B,gBAAgB,EAAE,WAAW,EAAE,EAC/B,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,WAAW,EAAE,GAC1B,mBAAmB,CAKrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,GAAG,SAAS,EAAE,WAAW,EAAE,GAC1B,mBAAmB,CAIrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,eAAe,EACrB,GAAG,mBAAmB,EAAE,WAAW,EAAE,GACpC,mBAAmB,CAIrB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,SAAS,WAAW,EAAE,GAChC,KAAK,GAAG,MAAM,CAUhB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAGlF"}