@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/keyboard/customization.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @file Keyboard Customization Types and Utilities
+ *
+ * Types for user customization of keyboard shortcuts.
+ * Runtime functions have been moved to @mog/spreadsheet-utils.
+ */
+import type { KeyboardShortcut, PlatformKeyBindings, ShortcutContext } from './shortcuts/types';
+import type { Platform } from './physical-keys';
+/**
+ * A user-defined custom binding for a shortcut.
+ *
+ * Custom bindings can override the default binding, add platform-specific
+ * overrides, or disable the shortcut entirely.
+ */
+export interface CustomBinding {
+    /**
+     * The ID of the shortcut being customized.
+     */
+    readonly shortcutId: string;
+    /**
+     * The custom key bindings.
+     *
+     * Partial allows overriding just specific platforms.
+     */
+    readonly bindings: Partial<PlatformKeyBindings>;
+    /**
+     * Whether this shortcut is disabled.
+     *
+     * If true, the shortcut will not trigger regardless of bindings.
+     */
+    readonly disabled?: boolean;
+}
+/**
+ * A keyboard profile containing user customizations.
+ *
+ * Profiles allow users to save and switch between different keyboard
+ * configurations (e.g., Excel-style, Google Sheets-style, custom).
+ */
+export interface KeyboardProfile {
+    /**
+     * Unique identifier for this profile.
+     */
+    readonly id: string;
+    /**
+     * Human-readable name for display.
+     */
+    readonly name: string;
+    /**
+     * Custom bindings in this profile.
+     *
+     * Map from shortcut ID to custom binding.
+     */
+    readonly customBindings: ReadonlyMap<string, CustomBinding>;
+    /**
+     * When this profile was created.
+     */
+    readonly createdAt: Date;
+    /**
+     * When this profile was last modified.
+     */
+    readonly modifiedAt: Date;
+}
+/**
+ * Type for built-in profile IDs.
+ */
+export type BuiltInProfileId = 'excel-default' | 'google-sheets';
+/**
+ * Serialized format for a keyboard profile.
+ *
+ * Used for storing profiles in localStorage or exporting/importing.
+ */
+export interface SerializedProfile {
+    id: string;
+    name: string;
+    customBindings: Array<{
+        shortcutId: string;
+        bindings: {
+            default?: {
+                code: string;
+                modifiers: string[];
+            };
+            macos?: {
+                code: string;
+                modifiers: string[];
+            };
+            windows?: {
+                code: string;
+                modifiers: string[];
+            };
+            linux?: {
+                code: string;
+                modifiers: string[];
+            };
+        };
+        disabled?: boolean;
+    }>;
+    createdAt: string;
+    modifiedAt: string;
+}
+/**
+ * Result of a conflict detection check.
+ */
+export interface ConflictResult {
+    /**
+     * Whether a conflict was detected.
+     */
+    readonly hasConflict: boolean;
+    /**
+     * The shortcut that conflicts, if any.
+     */
+    readonly conflictingShortcut?: KeyboardShortcut;
+    /**
+     * The platform(s) where the conflict occurs.
+     */
+    readonly platforms?: readonly Platform[];
+    /**
+     * The context(s) where the conflict occurs.
+     */
+    readonly contexts?: readonly ShortcutContext[];
+}
+//# sourceMappingURL=customization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customization.d.ts","sourceRoot":"","sources":["../../src/keyboard/customization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAMhD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAE5D;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,eAAe,CAAC;AAMjE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,KAAK,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE;YACR,OAAO,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;YAChD,KAAK,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;YAC9C,OAAO,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;YAChD,KAAK,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;SAC/C,CAAC;QACF,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,gBAAgB,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAChD"}

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

@@ -0,0 +1,9 @@
+/**
+ * @file Keyboard Display Utilities
+ *
+ * Runtime implementations live in the spreadsheet app:
+ * apps/spreadsheet/src/keyboard/display-utils.ts
+ *
+ * This file is intentionally empty — all runtime code lives in spreadsheet-utils.
+ */
+//# sourceMappingURL=display-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"display-utils.d.ts","sourceRoot":"","sources":["../../src/keyboard/display-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/keyboard/excel-reference.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Excel Keyboard Shortcut Reference Types
+ *
+ * Type definition for the Excel shortcut reference data.
+ * The runtime data lives in the spreadsheet app:
+ * apps/spreadsheet/src/keyboard/excel-reference.ts
+ *
+ * Source: https://support.microsoft.com/en-us/office/keyboard-shortcuts-in-excel
+ */
+export interface ExcelShortcutReference {
+    /** Unique ID for this reference entry */
+    id: string;
+    /** The shortcut as documented by Microsoft (Windows) */
+    windowsBinding: string;
+    /** The shortcut as documented by Microsoft (Mac) */
+    macBinding: string;
+    /** What the shortcut does per Microsoft docs */
+    description: string;
+    /** Microsoft's category grouping */
+    msCategory: string;
+    /** Our mapping status */
+    status: 'mapped' | 'mapped-disabled' | 'unmapped' | 'deferred' | 'not-applicable';
+    /** Our internal shortcut ID if mapped */
+    mappedToId?: string;
+    /** Notes on any discrepancies */
+    notes?: string;
+}
+//# sourceMappingURL=excel-reference.d.ts.map

package/dist/keyboard/excel-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-reference.d.ts","sourceRoot":"","sources":["../../src/keyboard/excel-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAAC;IAClF,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/keyboard/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Unified Keyboard Shortcut System - Type Definitions
+ *
+ * This module contains ONLY type definitions for the keyboard system.
+ * Runtime implementation has been moved to @mog/kernel/keyboard.
+ *
+ * For runtime code (binding utilities, shortcut definitions, display utils, etc.),
+ * import from: @mog/kernel/keyboard
+ */
+export type { DigitKeyCode, EditingKeyCode, FunctionKeyCode, ImeKeyCode, LetterKeyCode, ModifierKey, ModifierKeyCode, ModifierState, NavigationKeyCode, NumpadKeyCode, PhysicalKeyCode, Platform, PunctuationKeyCode, SpecialKeyCode, } from './physical-keys';
+export type { ClassifiedInput, KeyboardInput, KeyboardInputType } from './input';
+export type { BrowserConflict, BrowserConflictPolicy, KeyboardShortcut, MuscleMemoryLevel, PhysicalKeyBinding, PlatformKeyBindings, ShortcutCategory, ShortcutContext, ShortcutHandler, ShortcutMatchResult, ShortcutPriority, ShortcutRegistry, } from './shortcuts/types';
+export type { ActionTarget, ClipboardKeyboardAction, DataKeyboardAction, DialogKeyboardAction, EditorKeyboardAction, FileKeyboardAction, FormattingKeyboardAction, KeyboardAction, NavigationKeyboardAction, ObjectKeyboardAction, SelectionKeyboardAction, ViewKeyboardAction, WorkbookKeyboardAction, } from './actions';
+export type { BuiltInProfileId, ConflictResult, CustomBinding, KeyboardProfile, SerializedProfile, } from './customization';
+export type { ExcelShortcutReference } from './excel-reference';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/keyboard/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,UAAU,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMjF,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAM3B,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAMnB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/keyboard/input.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @file Keyboard Input Types
+ *
+ * Defines the normalized keyboard input types that all handlers receive.
+ * This provides a consistent interface regardless of the original browser event.
+ */
+import type { ModifierState, PhysicalKeyCode, Platform } from './physical-keys';
+/**
+ * Classification of keyboard input types.
+ *
+ * This determines how the input is routed through the keyboard system:
+ * - 'shortcut': Key combination with modifiers (Ctrl+C, Cmd+S)
+ * - 'navigation': Arrow keys, Tab, Page Up/Down (may have Shift for selection)
+ * - 'action': Enter, Escape, Delete, Backspace (context-sensitive actions)
+ * - 'character': Printable character input (letters, numbers, symbols)
+ * - 'composition': IME composition events (Japanese, Korean, Chinese input)
+ * - 'modifier-only': Pressing just a modifier key (Shift, Ctrl, Alt, Meta)
+ * - 'unknown': Unrecognized or system-reserved keys
+ */
+export type KeyboardInputType = 'shortcut' | 'navigation' | 'action' | 'character' | 'composition' | 'modifier-only' | 'unknown';
+/**
+ * Normalized keyboard input.
+ *
+ * This is the canonical representation of a keyboard event that all handlers
+ * receive. It normalizes browser differences and provides all information
+ * needed to handle the input correctly.
+ *
+ * @remarks
+ * The KeyboardInput is immutable - once created from a KeyboardEvent, it
+ * cannot be modified. This ensures consistent behavior across all handlers.
+ *
+ * @example
+ * ```ts
+ * function handleInput(input: KeyboardInput) {
+ *   if (input.modifiers.ctrl && input.physicalKey === 'KeyC') {
+ *     // Handle Ctrl+C
+ *   }
+ *   if (input.character && !input.modifiers.ctrl && !input.modifiers.meta) {
+ *     // Handle character input
+ *   }
+ * }
+ * ```
+ */
+export interface KeyboardInput {
+    /**
+     * The physical key code (from KeyboardEvent.code).
+     *
+     * This represents the physical location of the key on the keyboard,
+     * independent of the current keyboard layout.
+     */
+    readonly physicalKey: PhysicalKeyCode;
+    /**
+     * The character produced by this key (from KeyboardEvent.key).
+     *
+     * For printable keys, this is the character that would be typed.
+     * For non-printable keys, this may be a named value like 'Enter', 'Escape', etc.
+     * For modifier-only keypresses, this will be the modifier name.
+     */
+    readonly character: string;
+    /**
+     * The state of all modifier keys when this input occurred.
+     */
+    readonly modifiers: ModifierState;
+    /**
+     * Whether the input is part of an IME composition.
+     *
+     * When true, the input should generally be passed through to allow
+     * the IME to complete its composition. Only the final composed
+     * character should be processed.
+     */
+    readonly isComposing: boolean;
+    /**
+     * Whether this is a repeated keypress (key held down).
+     *
+     * Some shortcuts should only trigger once even when held (like Ctrl+S),
+     * while others should repeat (like arrow navigation).
+     */
+    readonly isRepeat: boolean;
+    /**
+     * The current platform.
+     *
+     * Used for platform-specific behavior (e.g., Cmd vs Ctrl on Mac).
+     */
+    readonly platform: Platform;
+    /**
+     * High-resolution timestamp when the input occurred.
+     *
+     * From KeyboardEvent.timeStamp (milliseconds since page load).
+     */
+    readonly timestamp: number;
+    /**
+     * The original browser KeyboardEvent.
+     *
+     * Preserved for cases where low-level access is needed, such as
+     * calling preventDefault() or accessing event.target.
+     */
+    readonly originalEvent: KeyboardEvent;
+}
+/**
+ * A keyboard input with its type classification.
+ *
+ * This combines the normalized input with its classification, which
+ * determines how it should be routed through the keyboard system.
+ */
+export interface ClassifiedInput {
+    /**
+     * The normalized keyboard input.
+     */
+    readonly input: KeyboardInput;
+    /**
+     * The classification of this input type.
+     */
+    readonly type: KeyboardInputType;
+    /**
+     * Whether the input produces a printable character.
+     *
+     * True for letters, numbers, symbols that would appear in a text field.
+     * False for function keys, navigation keys, modifier-only presses, etc.
+     *
+     * This is only defined when relevant (character and some action types).
+     */
+    readonly isPrintable?: boolean;
+}
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/keyboard/input.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAMhF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,aAAa,GACb,eAAe,GACf,SAAS,CAAC;AAMd;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAElC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/keyboard/physical-keys.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @file Physical Keyboard Key Types
+ *
+ * Defines physical keyboard key codes, modifier keys, and platform types.
+ * Based on KeyboardEvent.code values from the W3C UI Events specification.
+ *
+ * @see https://www.w3.org/TR/uievents-code/
+ */
+/** Physical letter key codes (KeyA through KeyZ) */
+export type LetterKeyCode = 'KeyA' | 'KeyB' | 'KeyC' | 'KeyD' | 'KeyE' | 'KeyF' | 'KeyG' | 'KeyH' | 'KeyI' | 'KeyJ' | 'KeyK' | 'KeyL' | 'KeyM' | 'KeyN' | 'KeyO' | 'KeyP' | 'KeyQ' | 'KeyR' | 'KeyS' | 'KeyT' | 'KeyU' | 'KeyV' | 'KeyW' | 'KeyX' | 'KeyY' | 'KeyZ';
+/** Physical digit key codes (Digit0 through Digit9) */
+export type DigitKeyCode = 'Digit0' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'Digit5' | 'Digit6' | 'Digit7' | 'Digit8' | 'Digit9';
+/** Physical numpad key codes */
+export type NumpadKeyCode = 'Numpad0' | 'Numpad1' | 'Numpad2' | 'Numpad3' | 'Numpad4' | 'Numpad5' | 'Numpad6' | 'Numpad7' | 'Numpad8' | 'Numpad9' | 'NumpadAdd' | 'NumpadSubtract' | 'NumpadMultiply' | 'NumpadDivide' | 'NumpadDecimal' | 'NumpadEnter' | 'NumpadEqual' | 'NumpadComma' | 'NumpadParenLeft' | 'NumpadParenRight';
+/** Physical function key codes (F1 through F12) */
+export type FunctionKeyCode = 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12';
+/** Physical navigation key codes */
+export type NavigationKeyCode = 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'PageUp' | 'PageDown';
+/** Physical editing key codes */
+export type EditingKeyCode = 'Backspace' | 'Delete' | 'Insert' | 'Enter' | 'Tab' | 'Escape' | 'Space';
+/** Physical punctuation key codes */
+export type PunctuationKeyCode = 'Minus' | 'Equal' | 'BracketLeft' | 'BracketRight' | 'Semicolon' | 'Quote' | 'Comma' | 'Period' | 'Slash' | 'Backslash' | 'Backquote' | 'IntlBackslash' | 'IntlRo' | 'IntlYen';
+/** Physical special key codes */
+export type SpecialKeyCode = 'ContextMenu' | 'NumLock' | 'ScrollLock' | 'Pause' | 'PrintScreen' | 'CapsLock';
+/** Physical modifier key codes (left/right variants) */
+export type ModifierKeyCode = 'ShiftLeft' | 'ShiftRight' | 'ControlLeft' | 'ControlRight' | 'AltLeft' | 'AltRight' | 'MetaLeft' | 'MetaRight';
+/** Physical keys for Japanese/Korean IME input */
+export type ImeKeyCode = 'Convert' | 'NonConvert' | 'KanaMode' | 'Lang1' | 'Lang2' | 'Hangul' | 'Hanja';
+/**
+ * Union of all physical key codes supported by the keyboard system.
+ *
+ * These correspond to KeyboardEvent.code values and represent the physical
+ * location of a key on the keyboard, independent of the current keyboard layout.
+ *
+ * @example
+ * ```ts
+ * const handleKey = (code: PhysicalKeyCode) => {
+ *   if (code === 'KeyA') {
+ *     // Always the left-most letter key, regardless of layout (QWERTY, AZERTY, etc.)
+ *   }
+ * };
+ * ```
+ */
+export type PhysicalKeyCode = LetterKeyCode | DigitKeyCode | NumpadKeyCode | FunctionKeyCode | NavigationKeyCode | EditingKeyCode | PunctuationKeyCode | SpecialKeyCode | ModifierKeyCode | ImeKeyCode;
+/**
+ * Logical modifier key names.
+ *
+ * These represent the logical modifier keys (not physical key codes) used
+ * in shortcut definitions. The mapping from physical to logical is:
+ * - 'ctrl' maps to ControlLeft/ControlRight
+ * - 'shift' maps to ShiftLeft/ShiftRight
+ * - 'alt' maps to AltLeft/AltRight
+ * - 'meta' maps to MetaLeft/MetaRight (Cmd on Mac, Win key on Windows)
+ */
+export type ModifierKey = 'ctrl' | 'shift' | 'alt' | 'meta';
+/**
+ * Complete modifier key state.
+ *
+ * Represents the state of all modifier keys at a point in time.
+ * Used for matching keyboard shortcuts and tracking modifier state.
+ */
+export interface ModifierState {
+    /** Control key state (Ctrl on Windows/Linux, Control on Mac) */
+    readonly ctrl: boolean;
+    /** Shift key state */
+    readonly shift: boolean;
+    /** Alt key state (Alt on Windows/Linux, Option on Mac) */
+    readonly alt: boolean;
+    /** Meta key state (Win on Windows, Cmd on Mac) */
+    readonly meta: boolean;
+}
+/**
+ * Supported operating system platforms.
+ *
+ * Re-exported from contracts/platform where the canonical definition lives.
+ * Keyboard code imports Platform for shortcut binding resolution.
+ */
+export type { Platform } from '../platform';
+//# sourceMappingURL=physical-keys.d.ts.map

package/dist/keyboard/physical-keys.d.ts.map

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

package/dist/keyboard/shortcuts/definitions/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Keyboard Shortcut Definition Types
+ *
+ * This module re-exports the KeyboardShortcut type for consumers that need it.
+ *
+ * For runtime shortcut definitions (KEYBOARD_SHORTCUTS array, category arrays),
+ * import from the spreadsheet app: apps/spreadsheet/src/keyboard/definitions/
+ */
+export type { KeyboardShortcut } from '../types';
+//# sourceMappingURL=index.d.ts.map

package/dist/keyboard/shortcuts/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/keyboard/shortcuts/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}