@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/accessibility/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Accessibility Checker Contracts
+ *
+ * Type definitions for accessibility checking functionality.
+ *
+ * @see plans/active/excel-parity/02-accessibility-checker-not-implemented.md
+ */
+export type { AccessibilityIssue, AccessibilityIssueCategory, AccessibilityIssueLocation, AccessibilityIssueSeverity, AccessibilityIssueType, AccessibilityLocationType, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/accessibility/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAEV,kBAAkB,EAElB,0BAA0B,EAE1B,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,SAAS,CAAC"}

package/dist/accessibility/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Accessibility Checker Types
+ *
+ * Type definitions for accessibility issues found during spreadsheet analysis.
+ * Used by the accessibility checker to report problems and help users fix them.
+ *
+ * @see plans/active/excel-parity/02-accessibility-checker-not-implemented.md
+ */
+/**
+ * Severity level for accessibility issues.
+ * - error: Critical issues that must be fixed (e.g., missing alt text)
+ * - warning: Potential issues that may confuse screen readers (e.g., merged cells)
+ * - tip: Improvement suggestions (e.g., default sheet names)
+ */
+export type AccessibilityIssueSeverity = 'error' | 'warning' | 'tip';
+/**
+ * Category of accessibility issue.
+ * Maps to the collapsible sections in the accessibility checker panel.
+ */
+export type AccessibilityIssueCategory = 'images' | 'tables' | 'sheets' | 'cells' | 'charts' | 'hyperlinks';
+/**
+ * Type of location that the issue refers to.
+ */
+export type AccessibilityLocationType = 'cell' | 'range' | 'object' | 'sheet';
+/**
+ * Specific types of accessibility issues.
+ * Used for mapping to fix actions and filtering.
+ */
+export type AccessibilityIssueType = 'missing-alt-text' | 'missing-table-header' | 'default-sheet-name' | 'merged-cells' | 'missing-chart-title' | 'hyperlink-text-is-url';
+/**
+ * Location of an accessibility issue within the workbook.
+ * Provides enough information to navigate to and highlight the issue.
+ */
+export interface AccessibilityIssueLocation {
+    /** The sheet containing the issue */
+    sheetId: string;
+    /** Human-readable sheet name for display */
+    sheetName: string;
+    /** Type of location */
+    type: AccessibilityLocationType;
+    /** Cell reference like "A1" or range like "A1:B5" (for cell/range types) */
+    ref?: string;
+    /** Floating object ID (for images, charts, etc.) */
+    objectId?: string;
+}
+/**
+ * An accessibility issue found during workbook analysis.
+ *
+ * Issues contain all information needed to:
+ * - Display in the accessibility checker panel
+ * - Navigate to the problem location
+ * - Provide fix suggestions
+ * - Explain why it matters
+ */
+export interface AccessibilityIssue {
+    /** Unique identifier for this issue */
+    id: string;
+    /** Severity level */
+    severity: AccessibilityIssueSeverity;
+    /** Category for grouping in UI */
+    category: AccessibilityIssueCategory;
+    /** Specific issue type for fix action mapping */
+    issueType: AccessibilityIssueType;
+    /** Short title describing the issue */
+    title: string;
+    /** Detailed description of the problem */
+    description: string;
+    /** Location of the issue in the workbook */
+    location: AccessibilityIssueLocation;
+    /** Suggested action to fix the issue */
+    recommendedAction: string;
+    /** Explanation of why this issue matters for accessibility */
+    whyFix: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/accessibility/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/accessibility/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAClC,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAC9B,kBAAkB,GAClB,sBAAsB,GACtB,oBAAoB,GACpB,cAAc,GACd,qBAAqB,GACrB,uBAAuB,CAAC;AAM5B;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,IAAI,EAAE,yBAAyB,CAAC;IAChC,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,QAAQ,EAAE,0BAA0B,CAAC;IACrC,kCAAkC;IAClC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,iDAAiD;IACjD,SAAS,EAAE,sBAAsB,CAAC;IAClC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,EAAE,0BAA0B,CAAC;IACrC,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/actions/comments.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Comment Action Types
+ *
+ * Action types for comment operations in the unified action system.
+ * These actions are dispatched from keyboard shortcuts, toolbar, and context menu.
+ *
+ * @see plans/active/detailed-parity-implementation/STREAM-C3-COMMENTS-RICHTEXT.md
+ */
+/**
+ * Comment-related action types.
+ * These integrate with the Unified Action System.
+ *
+ * Excel standard shortcuts:
+ * - Shift+F2: Insert/Edit Comment
+ * - Ctrl+Shift+O: Show All Comments
+ * - Ctrl+Alt+M: New Comment (Google Sheets style alternative)
+ */
+export type CommentActionType = 
+/** Insert a new comment on the active cell (opens popover in compose mode) */
+'INSERT_COMMENT'
+/** Edit the existing comment on the active cell (opens popover in edit mode) */
+ | 'EDIT_COMMENT'
+/** Delete all comments on the active cell */
+ | 'DELETE_COMMENT'
+/** Toggle visibility of all comments in the sheet */
+ | 'SHOW_HIDE_COMMENTS'
+/** Navigate to next cell with a comment */
+ | 'NEXT_COMMENT'
+/** Navigate to previous cell with a comment */
+ | 'PREVIOUS_COMMENT';
+//# sourceMappingURL=comments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/actions/comments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB;AAC3B,8EAA8E;AAC5E,gBAAgB;AAClB,gFAAgF;GAC9E,cAAc;AAChB,6CAA6C;GAC3C,gBAAgB;AAClB,qDAAqD;GACnD,oBAAoB;AACtB,2CAA2C;GACzC,cAAc;AAChB,+CAA+C;GAC7C,kBAAkB,CAAC"}

package/dist/actions/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Unified Action System - Contracts
+ *
+ * Type definitions and utilities for the unified action dispatch system.
+ *
+ * Usage:
+ * ```typescript
+ * import type {
+ *   ActionType,
+ *   ActionDependencies,
+ *   ActionResult,
+ *   ActionHandler
+ * } from '@mog/spreadsheet-contracts/actions';
+ *
+ * // Type guards live in apps/spreadsheet/src/actions/type-guards.ts
+ * import { isSelectionAction } from '../actions/type-guards';
+ * ```
+ *
+ * @see plans/state-refactor/04-keyboard-refactor.md
+ */
+export type { ActionDependencies, ActionHandler, ActionHandlerMap, ActionResult, ActionType, AnyActionHandler, AsyncActionHandler, AutoFillActionType, ChartActionType, ClipboardActionType, CommentActionType, ConditionalFormattingActionType, DataAnalysisDialogActionType, DragDropActionType, EditorActionType, EquationActionType, FillContextMenuActionType, FilterActionType, FlashFillActionType, FormattingActionType, IUIStoreApi, InkActionType, NavigationActionType, ObjectActionType, PasteValidationActionType, PrintExportActionType, RepeatActionType, SelectionActionType, SlicerActionType, SmartArtActionType, StructureActionType, TableActionType, ThesaurusInsertPayload, TotalRowActionType, UIActionType, ViewActionType, WorkbookActionType, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,YAAY,EAEV,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,YAAY,EAEZ,UAAU,EAEV,gBAAgB,EAChB,kBAAkB,EAElB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,+BAA+B,EAC/B,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAEhB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EAEpB,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EAEf,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/actions/types.d.ts

@@ -0,0 +1,448 @@
+/**
+ * Unified Action System - Type Definitions
+ *
+ * These types define the unified action dispatch system that replaces
+ * duplicate action implementations across keyboard, toolbar, and context menu.
+ *
+ * ARCHITECTURE:
+ * - All input sources (keyboard, toolbar, context menu, AI agent) dispatch actions
+ *   through a single handler system: dispatch(actionType, deps) → ActionResult
+ * - Handlers are pure functions in engine/src/state/actions/handlers/
+ * - This file contains ONLY types; all implementation is in engine/
+ *
+ * Package Boundary:
+ * - Types in contracts/ (this file)
+ * - Handlers in engine/ (handlers import Mutations, domain modules, etc.)
+ * - This prevents contracts → engine → contracts circular dependency
+ *
+ * @see plans/state-refactor/04-keyboard-refactor.md
+ */
+/** Payload for THESAURUS_INSERT_WORD action */
+export interface ThesaurusInsertPayload {
+    /** The synonym/antonym word to insert */
+    word: string;
+}
+/**
+ * Selection actions - movement and selection operations.
+ * Target: SelectionMachine
+ */
+export type SelectionActionType = 'MOVE_UP' | 'MOVE_DOWN' | 'MOVE_LEFT' | 'MOVE_RIGHT' | 'MOVE_TO_EDGE_UP' | 'MOVE_TO_EDGE_DOWN' | 'MOVE_TO_EDGE_LEFT' | 'MOVE_TO_EDGE_RIGHT' | 'MOVE_TO_ROW_START' | 'MOVE_TO_ROW_END' | 'MOVE_TO_A1' | 'MOVE_TO_LAST_USED_CELL' | 'MOVE_TO_TABLE_START' | 'MOVE_TO_TABLE_END' | 'MOVE_TO_TABLE_EDGE_UP' | 'MOVE_TO_TABLE_EDGE_DOWN' | 'MOVE_TO_TABLE_EDGE_LEFT' | 'MOVE_TO_TABLE_EDGE_RIGHT' | 'PAGE_UP' | 'PAGE_DOWN' | 'PAGE_LEFT' | 'PAGE_RIGHT' | 'TAB_FORWARD' | 'TAB_BACKWARD' | 'ENTER_NAVIGATE' | 'SHIFT_ENTER_NAVIGATE' | 'EXTEND_SELECTION_UP' | 'EXTEND_SELECTION_DOWN' | 'EXTEND_SELECTION_LEFT' | 'EXTEND_SELECTION_RIGHT' | 'EXTEND_TO_EDGE_UP' | 'EXTEND_TO_EDGE_DOWN' | 'EXTEND_TO_EDGE_LEFT' | 'EXTEND_TO_EDGE_RIGHT' | 'EXTEND_TO_ROW_START' | 'EXTEND_TO_A1' | 'EXTEND_TO_LAST_USED_CELL' | 'SELECT_ALL' | 'SELECT_CURRENT_REGION' | 'SELECT_ENTIRE_ROW' | 'SELECT_ENTIRE_COLUMN' | 'SELECT_PRECEDENTS' | 'SELECT_DEPENDENTS' | 'SELECT_VISIBLE_CELLS' | 'TOGGLE_ADD_TO_SELECTION' | 'SELECT_BLANKS' | 'SELECT_CONSTANTS' | 'SELECT_FORMULAS' | 'SELECT_NUMBERS' | 'SELECT_TEXT' | 'SELECT_LOGICALS' | 'SELECT_ERRORS' | 'SELECT_LAST_CELL' | 'SELECT_CELLS_WITH_CONDITIONAL_FORMATS' | 'SELECT_CELLS_WITH_DATA_VALIDATION' | 'SELECT_CELLS_WITH_SAME_VALIDATION' | 'SELECT_CELLS_WITH_COMMENTS' | 'SELECT_ROW_DIFFERENCES' | 'SELECT_COLUMN_DIFFERENCES' | 'SELECT_CURRENT_ARRAY' | 'SELECT_OBJECTS' | 'ROTATE_SELECTION_CORNER' | 'TOGGLE_EXTEND_SELECTION_MODE' | 'ACTIVATE_END_MODE' | 'CYCLE_TABLE_COLUMN_SELECTION' | 'CYCLE_TABLE_SELECTION' | 'SET_SELECTION_ERROR' | 'CLEAR_SELECTION_ERROR';
+/**
+ * Editor actions - cell editing operations.
+ * Target: EditorMachine
+ */
+export type EditorActionType = 'EDIT_CELL' | 'COMMIT_AND_MOVE_DOWN' | 'COMMIT_AND_MOVE_UP' | 'COMMIT_AND_MOVE_LEFT' | 'COMMIT_AND_MOVE_RIGHT' | 'CANCEL_EDIT' | 'COMMIT_IN_PLACE' | 'BLUR_EDITOR' | 'PICKER_COMMIT' | 'INSERT_NEWLINE' | 'START_FORMULA' | 'CLEAR_CONTENTS' | 'CLEAR_AND_EDIT' | 'DELETE_TO_END_OF_LINE' | 'CURSOR_UP' | 'CURSOR_DOWN' | 'DELETE_WORD_FORWARD' | 'DELETE_WORD_BACKWARD' | 'FILL_DOWN' | 'FILL_RIGHT' | 'FILL_UP' | 'FILL_LEFT' | 'FILL_SELECTION' | 'DOUBLE_CLICK_FILL_HANDLE' | 'CLEAR_ALL' | 'CLEAR_FORMATS' | 'CLEAR_COMMENTS' | 'SORT_ASCENDING' | 'SORT_DESCENDING' | 'SORT_BY_CELL_COLOR' | 'SORT_BY_FONT_COLOR' | 'INSERT_CURRENT_DATE' | 'INSERT_CURRENT_TIME' | 'COPY_VALUE_FROM_ABOVE' | 'COPY_FORMULA_FROM_ABOVE' | 'CYCLE_REFERENCE' | 'ENTER_ARRAY_FORMULA' | 'INSERT_FUNCTION_ARGS' | 'INSERT_FUNCTION' | 'PASTE_NAME_IN_FORMULA' | 'AUTO_SUM' | 'EVALUATE_FORMULA_SELECTION' | 'TOGGLE_EDIT_MODE' | 'FORMULA_SELECT_UP' | 'FORMULA_SELECT_DOWN' | 'FORMULA_SELECT_LEFT' | 'FORMULA_SELECT_RIGHT' | 'FORMULA_EXTEND_UP' | 'FORMULA_EXTEND_DOWN' | 'FORMULA_EXTEND_LEFT' | 'FORMULA_EXTEND_RIGHT' | 'EDIT_FORMULA_WITH_ERROR' | 'COMMIT_FORMULA_AS_TEXT' | 'OPEN_FORMULA_HELP' | 'OPEN_CELL_PICKER' | 'UPDATE_FORMULA_RANGE';
+/**
+ * Clipboard actions - copy/cut/paste operations.
+ * Target: ClipboardMachine
+ * G1/G2: Added CLEAR_CLIPBOARD for ESC key to clear clipboard state
+ * G3: Added paste options button actions
+ * Track 4: Added paste submenu options (PASTE_VALUES, PASTE_FORMULAS, etc.)
+ * Track 3.4: Added paste size mismatch dialog actions
+ */
+export type ClipboardActionType = 'COPY' | 'CUT' | 'PASTE' | 'PASTE_SPECIAL' | 'CLEAR_CLIPBOARD' | 'SHOW_PASTE_OPTIONS' | 'HIDE_PASTE_OPTIONS' | 'PASTE_WITH_OPTIONS' | 'PASTE_VALUES' | 'PASTE_FORMULAS' | 'PASTE_FORMATTING' | 'PASTE_TRANSPOSE' | 'PASTE_LINK' | 'PASTE_AS_PICTURE' | 'PASTE_AS_LINKED_PICTURE' | 'SHOW_PASTE_SIZE_MISMATCH_DIALOG' | 'CONFIRM_PASTE_SIZE_MISMATCH' | 'CANCEL_PASTE_SIZE_MISMATCH';
+/**
+ * Formatting actions - cell formatting operations.
+ * Target: Mutations layer (store)
+ */
+export type FormattingActionType = 'TOGGLE_BOLD' | 'TOGGLE_ITALIC' | 'TOGGLE_UNDERLINE' | 'TOGGLE_STRIKETHROUGH' | 'APPLY_FONT_FORMAT' | 'SET_FONT_SIZE' | 'SET_FONT_FAMILY' | 'SET_FONT_COLOR' | 'SET_FONT_THEME' | 'INCREASE_FONT_SIZE' | 'DECREASE_FONT_SIZE' | 'SET_BACKGROUND_COLOR' | 'SET_HORIZONTAL_ALIGN' | 'SET_VERTICAL_ALIGN' | 'SET_TEXT_ROTATION' | 'INCREASE_INDENT' | 'DECREASE_INDENT' | 'TOGGLE_WRAP_TEXT' | 'APPLY_ALIGNMENT_FORMAT' | 'APPLY_FILL_FORMAT' | 'APPLY_PROTECTION_FORMAT' | 'SET_NUMBER_FORMAT' | 'APPLY_NUMBER_FORMAT' | 'FORMAT_GENERAL' | 'FORMAT_NUMBER' | 'FORMAT_TIME' | 'FORMAT_DATE' | 'FORMAT_CURRENCY' | 'FORMAT_PERCENTAGE' | 'FORMAT_SCIENTIFIC' | 'FORMAT_COMMA' | 'TOGGLE_SUPERSCRIPT' | 'TOGGLE_SUBSCRIPT' | 'INCREASE_DECIMALS' | 'DECREASE_DECIMALS' | 'APPLY_BORDERS' | 'APPLY_OUTLINE_BORDER' | 'REMOVE_BORDERS' | 'SET_ALL_BORDERS' | 'SET_INSIDE_BORDERS' | 'SET_INSIDE_HORIZONTAL_BORDERS' | 'SET_INSIDE_VERTICAL_BORDERS' | 'SET_TOP_BORDER' | 'SET_BOTTOM_BORDER' | 'SET_LEFT_BORDER' | 'SET_RIGHT_BORDER' | 'SET_DIAGONAL_UP_BORDER' | 'SET_DIAGONAL_DOWN_BORDER' | 'SET_DIAGONAL_BOTH_BORDER' | 'SET_TOP_AND_BOTTOM_BORDERS' | 'SET_TOP_AND_THICK_BOTTOM_BORDERS' | 'SET_TOP_AND_DOUBLE_BOTTOM_BORDERS' | 'CLEAR_HYPERLINKS' | 'CLEAR_CONDITIONAL_FORMATTING' | 'CLEAR_DATA_VALIDATION' | 'CLEAR_OUTLINE' | 'INSERT_TABLE' | 'TOGGLE_MERGE' | 'MERGE_ACROSS' | 'MERGE_AND_CENTER' | 'UNMERGE_CELLS' | 'MERGE_CELLS_WITH_WARNING' | 'CONFIRM_MERGE_WITH_DATA_LOSS' | 'CANCEL_MERGE' | 'ACTIVATE_DRAW_BORDER' | 'ACTIVATE_DRAW_BORDER_GRID' | 'ACTIVATE_ERASE_BORDER' | 'DEACTIVATE_DRAW_BORDER';
+/**
+ * Structure actions - insert/delete rows/columns.
+ * Target: Mutations layer (store)
+ */
+export type StructureActionType = 'INSERT_ROW_ABOVE' | 'INSERT_ROW_BELOW' | 'INSERT_COLUMN_LEFT' | 'INSERT_COLUMN_RIGHT' | 'DELETE_ROWS' | 'DELETE_COLUMNS' | 'INSERT_CELLS' | 'DELETE_CELLS' | 'HIDE_ROW' | 'UNHIDE_ROW' | 'HIDE_COLUMN' | 'UNHIDE_COLUMN' | 'INSERT_HORIZONTAL_PAGE_BREAK' | 'REMOVE_HORIZONTAL_PAGE_BREAK' | 'INSERT_VERTICAL_PAGE_BREAK' | 'REMOVE_VERTICAL_PAGE_BREAK' | 'UNDO' | 'REDO';
+/**
+ * Navigation actions - pane focus and viewport navigation.
+ * Target: PaneFocusMachine and SelectionMachine
+ * Track 4: Added OPEN_HYPERLINK for context menu
+ * Track 7.1: Added TOGGLE_END_MODE for End Mode navigation
+ */
+export type NavigationActionType = 'FOCUS_NEXT_PANE' | 'FOCUS_PREVIOUS_PANE' | 'SCROLL_TO_ACTIVE_CELL' | 'OPEN_HYPERLINK' | 'TOGGLE_END_MODE';
+/**
+ * UI actions - dialogs and view controls.
+ * Target: UI layer callbacks
+ */
+export type UIActionType = 'TRACE_ERROR' | 'IGNORE_ERROR' | 'SELECT_ARRAY' | 'OPEN_GO_TO_DIALOG' | 'CLOSE_GO_TO_DIALOG' | 'NAVIGATE_TO_REFERENCE' | 'OPEN_GO_TO_SPECIAL_DIALOG' | 'OPEN_FORMAT_CELLS_DIALOG' | 'CLOSE_FORMAT_CELLS_DIALOG' | 'OPEN_INSERT_CELLS_DIALOG' | 'OPEN_DELETE_CELLS_DIALOG' | 'OPEN_INSERT_FUNCTION_DIALOG' | 'CLOSE_INSERT_FUNCTION_DIALOG' | 'OPEN_FUNCTION_ARGUMENTS_DIALOG' | 'CLOSE_FUNCTION_ARGUMENTS_DIALOG' | 'OPEN_NAME_MANAGER' | 'OPEN_DEFINE_NAME_DIALOG' | 'OPEN_FIND_DIALOG' | 'OPEN_FIND_REPLACE_DIALOG' | 'OPEN_PASTE_SPECIAL_DIALOG' | 'OPEN_DROPDOWN' | 'OPEN_CUSTOM_SORT_DIALOG' | 'INVOKE_CONTEXT_MENU' | 'OPEN_ROW_HEIGHT_DIALOG' | 'CLOSE_ROW_HEIGHT_DIALOG' | 'OPEN_COLUMN_WIDTH_DIALOG' | 'CLOSE_COLUMN_WIDTH_DIALOG' | 'OPEN_HYPERLINK_DIALOG' | 'REMOVE_HYPERLINK' | 'OPEN_FILL_SERIES_DIALOG' | 'CLOSE_FILL_SERIES_DIALOG' | 'EXECUTE_FILL_SERIES' | 'OPEN_PAGE_SETUP_DIALOG' | 'CLOSE_PAGE_SETUP_DIALOG' | 'APPLY_PAGE_SETUP' | 'SET_PAGE_ORIENTATION' | 'SET_PAPER_SIZE' | 'SET_PAGE_MARGINS' | 'SET_PAGE_SCALE' | 'OPEN_BACKSTAGE' | 'CLOSE_BACKSTAGE' | 'SET_BACKSTAGE_PANEL' | 'TOGGLE_FORMULA_VIEW' | 'TOGGLE_SHOW_FORMULAS' | 'TOGGLE_FORMULA_BAR_EXPAND' | 'TOGGLE_AUTO_FILTER' | 'TOGGLE_RIBBON' | 'SET_RIBBON_DISPLAY_MODE' | 'TOGGLE_RIBBON_TABS_MODE' | 'SHOW_RIBBON_TEMPORARILY' | 'HIDE_RIBBON_TEMPORARILY' | 'ACTIVATE_RIBBON_KEYTIPS' | 'DEACTIVATE_RIBBON_KEYTIPS' | 'ZOOM_IN' | 'ZOOM_OUT' | 'SET_ZOOM' | 'FULL_SCREEN' | 'TOGGLE_PAGE_BREAK_PREVIEW' | 'SAVE' | 'OPEN' | 'NEW_WORKBOOK' | 'CLOSE_WORKBOOK' | 'PRINT' | 'FIND_NEXT' | 'FIND_PREVIOUS' | 'CALCULATE_ALL' | 'CALCULATE_SHEET' | 'SET_CALCULATION_MODE' | 'CREATE_NAMES_FROM_SELECTION' | 'CREATE_NAMES_EXECUTE' | 'REFRESH_ALL_DATA' | 'REFRESH_CONNECTION' | 'TRACE_PRECEDENTS' | 'TRACE_DEPENDENTS' | 'REMOVE_TRACE_ARROWS' | 'REMOVE_PRECEDENT_ARROWS' | 'REMOVE_DEPENDENT_ARROWS' | 'SHOW_VALIDATION_CIRCLES' | 'HIDE_VALIDATION_CIRCLES' | 'TOGGLE_VALIDATION_CIRCLES' | 'OPEN_SPARKLINE_DIALOG' | 'OPEN_DV_DIALOG' | 'CLOSE_DV_DIALOG' | 'OPEN_PIVOT_DIALOG' | 'OPEN_SUBTOTAL_DIALOG' | 'OPEN_SCHEMA_BROWSER' | 'OPEN_REMOVE_DUPLICATES_DIALOG' | 'OPEN_TEXT_TO_COLUMNS_DIALOG' | 'OPEN_SPREAD_SETTINGS_DIALOG' | 'OPEN_SHEET_SETTINGS_DIALOG' | 'OPEN_QUICK_RULE_DIALOG' | 'TRACK_RECENT_COLOR' | 'OPEN_MORE_COLORS_DIALOG' | 'CLOSE_MORE_COLORS_DIALOG' | 'APPLY_MORE_COLORS_FILL' | 'APPLY_MORE_COLORS_FONT' | 'APPLY_MORE_COLORS_BORDER' | 'START_RANGE_SELECTION_MODE' | 'UPDATE_RANGE_SELECTION' | 'COMPLETE_RANGE_SELECTION' | 'CANCEL_RANGE_SELECTION' | 'OPEN_HELP' | 'OPEN_KEYBOARD_SHORTCUTS_DIALOG' | 'CLOSE_KEYBOARD_SHORTCUTS_DIALOG' | 'ANNOUNCE_CELL_FORMAT' | 'OPEN_QUICK_ANALYSIS' | 'OPEN_THESAURUS_DIALOG' | 'CLOSE_THESAURUS_DIALOG' | 'THESAURUS_INSERT_WORD' | 'SHOW_WORKBOOK_STATISTICS' | 'CHECK_ACCESSIBILITY' | 'CLOSE_ACCESSIBILITY_PANEL' | 'NAVIGATE_TO_ACCESSIBILITY_ISSUE' | 'TOGGLE_MACRO_RECORDING' | 'STOP_MACRO_RECORDING' | 'EXPORT_FILE' | 'OPEN_COMMAND_PALETTE' | 'ZOOM_RESET' | 'TOGGLE_SCROLL_LOCK' | 'TOGGLE_EXTENSION_PANEL';
+/**
+ * Workbook actions - sheet navigation and management.
+ * Target: Workbook callbacks
+ */
+export type WorkbookActionType = 'PREVIOUS_SHEET' | 'NEXT_SHEET' | 'INSERT_SHEET' | 'DELETE_SHEET' | 'MOVE_SHEET' | 'COPY_SHEET_TO_POSITION' | 'OPEN_PROTECT_SHEET_DIALOG' | 'CLOSE_PROTECT_SHEET_DIALOG' | 'PROTECT_SHEET' | 'UNPROTECT_SHEET' | 'OPEN_PROTECT_WORKBOOK_DIALOG' | 'CLOSE_PROTECT_WORKBOOK_DIALOG' | 'PROTECT_WORKBOOK' | 'UNPROTECT_WORKBOOK' | 'SELECT_ALL_SHEETS' | 'GROUP' | 'UNGROUP' | 'SHOW_DETAIL' | 'HIDE_DETAIL';
+/**
+ * Object actions - floating object operations.
+ * Target: ObjectInteractionMachine
+ */
+export type ObjectActionType = 'DELETE_OBJECT' | 'DESELECT_OBJECT' | 'NUDGE_OBJECT_UP' | 'NUDGE_OBJECT_DOWN' | 'NUDGE_OBJECT_LEFT' | 'NUDGE_OBJECT_RIGHT' | 'NUDGE_OBJECT_UP_FINE' | 'NUDGE_OBJECT_DOWN_FINE' | 'NUDGE_OBJECT_LEFT_FINE' | 'NUDGE_OBJECT_RIGHT_FINE' | 'DUPLICATE_OBJECT' | 'OPEN_FORMAT_PICTURE_DIALOG' | 'CLOSE_FORMAT_PICTURE_DIALOG' | 'OPEN_EDIT_ALT_TEXT_DIALOG' | 'CLOSE_EDIT_ALT_TEXT_DIALOG' | 'SAVE_PICTURE_AS_FILE' | 'UPDATE_PICTURE' | 'CHANGE_PICTURE' | 'RESET_PICTURE' | 'INSERT_SHAPE' | 'START_SHAPE_INSERT' | 'INSERT_TEXTBOX' | 'FLIP_SHAPE_HORIZONTAL' | 'FLIP_SHAPE_VERTICAL' | 'SET_SHAPE_FILL' | 'SET_SHAPE_OUTLINE' | 'SET_SHAPE_TEXT' | 'SET_SHAPE_SHADOW' | 'COPY_SHAPE' | 'CUT_SHAPE' | 'PASTE_SHAPE' | 'BRING_OBJECT_TO_FRONT' | 'BRING_OBJECT_FORWARD' | 'SEND_OBJECT_TO_BACK' | 'SEND_OBJECT_BACKWARD' | 'ALIGN_OBJECTS_LEFT' | 'ALIGN_OBJECTS_CENTER' | 'ALIGN_OBJECTS_RIGHT' | 'ALIGN_OBJECTS_TOP' | 'ALIGN_OBJECTS_MIDDLE' | 'ALIGN_OBJECTS_BOTTOM' | 'GROUP_OBJECTS' | 'UNGROUP_OBJECTS' | 'ROTATE_OBJECT_RIGHT_90' | 'ROTATE_OBJECT_LEFT_90' | 'FLIP_OBJECT_VERTICAL' | 'FLIP_OBJECT_HORIZONTAL';
+/**
+ * Comment actions - comment operations.
+ * Target: Comment machine + Comments domain module
+ */
+export type CommentActionType = 'INSERT_COMMENT' | 'EDIT_COMMENT' | 'DELETE_COMMENT' | 'SHOW_HIDE_COMMENTS' | 'NEXT_COMMENT' | 'PREVIOUS_COMMENT' | 'TOGGLE_SHOW_ALL_COMMENTS';
+/**
+ * Format Painter actions - copy and apply formatting.
+ * Target: UIStore (format painter slice) + Mutations
+ *
+ * Excel Parity Quickwin D1: Format Painter
+ */
+export type FormatPainterActionType = 'START_FORMAT_PAINTER' | 'STOP_FORMAT_PAINTER' | 'LOCK_FORMAT_PAINTER' | 'APPLY_FORMAT_PAINTER';
+/**
+ * Filter actions - filter dropdown operations.
+ * Target: Filters domain + UIStore
+ *
+ * Excel Parity Quickwin B4: Filter Dropdown Panel
+ * Track 4: Added context menu filter actions
+ *
+ * Uses Draft + Apply pattern:
+ * 1. Store pending config in UIStore (setPendingFilterConfig, etc.)
+ * 2. Dispatch action to apply (reads from UIStore)
+ */
+export type FilterActionType = 'APPLY_NUMBER_FILTER' | 'APPLY_TEXT_FILTER' | 'APPLY_COLOR_FILTER' | 'APPLY_TOP10_FILTER' | 'OPEN_TOP10_DIALOG' | 'CLOSE_TOP10_DIALOG' | 'CLEAR_COLUMN_FILTER' | 'FILTER_BY_SELECTED_VALUE' | 'FILTER_BY_COLOR' | 'FILTER_BY_FONT_COLOR' | 'CLEAR_FILTER' | 'OPEN_CUSTOM_AUTOFILTER_DIALOG' | 'CLOSE_CUSTOM_AUTOFILTER_DIALOG' | 'APPLY_CUSTOM_AUTOFILTER' | 'OPEN_ADVANCED_FILTER_DIALOG' | 'CLOSE_ADVANCED_FILTER_DIALOG' | 'APPLY_ADVANCED_FILTER' | 'CLEAR_ALL_FILTERS' | 'REAPPLY_FILTERS';
+/**
+ * AutoFill actions - autofill options button operations.
+ * Target: UIStore (autofill options slice) + FillCoordinator
+ *
+ * Excel Parity Track 5.5: AutoFill Options Button
+ * @see plans/active/excel-parity/05-FILL-AUTOFILL.md
+ */
+export type AutoFillActionType = 'SHOW_AUTOFILL_OPTIONS' | 'HIDE_AUTOFILL_OPTIONS' | 'APPLY_AUTOFILL_OPTION';
+/**
+ * Fill Context Menu actions - right-click drag fill handle operations.
+ * Target: UIStore (fill context menu slice) + FillCoordinator
+ *
+ * Track 5.6: Right-Click Drag Fill Context Menu
+ * @see plans/active/excel-parity/05-FILL-AUTOFILL.md
+ */
+export type FillContextMenuActionType = 'SHOW_FILL_CONTEXT_MENU' | 'HIDE_FILL_CONTEXT_MENU' | 'EXECUTE_FILL_COPY_CELLS' | 'EXECUTE_FILL_SERIES_CONTEXT_MENU' | 'EXECUTE_FILL_FORMATTING_ONLY' | 'EXECUTE_FILL_WITHOUT_FORMATTING' | 'EXECUTE_FILL_DAYS' | 'EXECUTE_FILL_WEEKDAYS' | 'EXECUTE_FILL_MONTHS' | 'EXECUTE_FILL_YEARS' | 'EXECUTE_FILL_LINEAR_TREND' | 'EXECUTE_FILL_GROWTH_TREND';
+/**
+ * Flash Fill actions - pattern recognition and application.
+ * Target: UIStore (flash fill slice) + FlashFillCoordinator
+ *
+ * Plan 10 Group 2: Flash Fill (Ctrl+E)
+ * @see plans/active/excel-parity/10-FILL-AUTOFILL-PLAN.md
+ */
+export type FlashFillActionType = 'FLASH_FILL' | 'SHOW_FLASH_FILL_PREVIEW' | 'ACCEPT_FLASH_FILL' | 'REJECT_FLASH_FILL';
+/**
+ * Custom Lists actions - user-defined fill lists management.
+ * Target: UIStore (custom lists dialog slice) + Workbook domain (Yjs storage)
+ *
+ * Plan 10 Group 4: Custom Lists
+ * @see plans/active/excel-parity/10-FILL-AUTOFILL-PLAN.md
+ */
+export type CustomListsActionType = 'OPEN_CUSTOM_LISTS_DIALOG' | 'CLOSE_CUSTOM_LISTS_DIALOG' | 'ADD_CUSTOM_LIST' | 'EDIT_CUSTOM_LIST' | 'DELETE_CUSTOM_LIST';
+/**
+ * Repeat Action types - F4 repeat last action feature.
+ * Target: UIStore (repeat action slice) + Dispatcher tracking
+ *
+ * Track 7.4: F4 Repeat Last Action
+ * @see plans/active/excel-parity/07-KEYBOARD.md
+ */
+export type RepeatActionType = 'REPEAT_LAST_ACTION';
+/**
+ * Drag-Drop actions - cell drag-drop overwrite warning dialog operations.
+ * Target: UIStore (drag-drop-overwrite-dialog slice) + DragDropCoordinator
+ *
+ * Plan 01: Mouse Interactions - D.2 Overwrite Warning on Drag-Drop
+ * @see plans/active/excel-parity/01-MOUSE-INTERACTIONS-PLAN.md
+ */
+export type DragDropActionType = 'SHOW_DRAG_DROP_OVERWRITE_DIALOG' | 'CONFIRM_DRAG_DROP_OVERWRITE' | 'CANCEL_DRAG_DROP_OVERWRITE';
+/**
+ * Paste Validation actions - paste validation summary dialog operations.
+ * Target: UIStore (paste-validation slice) + ClipboardCoordinator
+ *
+ * Plan 16 Group 18: Batch Paste Validation UI
+ * @see plans/active/excel-parity/16-DATA-VALIDATION-PLAN.md - Group 18
+ */
+export type PasteValidationActionType = 'SHOW_PASTE_VALIDATION_SUMMARY' | 'CLOSE_PASTE_VALIDATION_SUMMARY' | 'CONFIRM_PASTE_WITH_INVALID' | 'REVERT_INVALID_PASTE' | 'HIGHLIGHT_INVALID_CELLS';
+/**
+ * Conditional Formatting actions - CF rule management.
+ * Target: CondFormatCache + Mutations layer + UIStore (CF dialog slices)
+ *
+ * Track 12: Conditional Formatting Architecture Alignment
+ * @see plans/active/excel-parity/12-CONDITIONAL-FORMATTING.md
+ */
+export type ConditionalFormattingActionType = 'CREATE_CF_RULE' | 'UPDATE_CF_RULE' | 'DELETE_CF_RULE' | 'REORDER_CF_RULES' | 'OPEN_CF_RULES_MANAGER' | 'CLOSE_CF_RULES_MANAGER' | 'OPEN_CF_DIALOG' | 'CLOSE_CF_DIALOG' | 'OPEN_CF_MENU';
+/**
+ * Table Total Row actions - total row function dropdown operations.
+ * Target: UIStore (total row dropdown slice) + Tables domain
+ *
+ * Track 10.9: Total Row Function Dropdown
+ * @see plans/active/excel-parity/10-TABLES.md
+ */
+export type TotalRowActionType = 'OPEN_TOTAL_ROW_DROPDOWN' | 'CLOSE_TOTAL_ROW_DROPDOWN' | 'SET_TOTAL_ROW_FUNCTION';
+/**
+ * Table actions - table operations and dialogs.
+ * Target: Tables domain + UIStore + Mutations layer
+ *
+ * Plan 15: Tables Excel Parity
+ * @see plans/active/excel-parity/15-TABLES-PLAN.md
+ */
+export type TableActionType = 'REMOVE_DUPLICATES' | 'CONVERT_TO_RANGE' | 'TOGGLE_FILTER_BUTTONS' | 'INSERT_TABLE_ROW_ABOVE' | 'INSERT_TABLE_ROW_BELOW' | 'INSERT_TABLE_COLUMN_LEFT' | 'INSERT_TABLE_COLUMN_RIGHT' | 'DELETE_TABLE_ROWS' | 'DELETE_TABLE_COLUMNS' | 'CREATE_CUSTOM_TABLE_STYLE' | 'MODIFY_TABLE_STYLE' | 'DUPLICATE_TABLE_STYLE' | 'DELETE_CUSTOM_TABLE_STYLE' | 'RESIZE_TABLE' | 'CLOSE_REMOVE_DUPLICATES_DIALOG' | 'OPEN_CUSTOM_TABLE_STYLE_DIALOG' | 'CLOSE_CUSTOM_TABLE_STYLE_DIALOG' | 'OPEN_RESIZE_TABLE_DIALOG' | 'CLOSE_RESIZE_TABLE_DIALOG' | 'OPEN_CONVERT_TO_RANGE_DIALOG' | 'CLOSE_CONVERT_TO_RANGE_DIALOG' | 'SELECT_TABLE_COLUMN' | 'SELECT_TABLE_ROW' | 'SELECT_TABLE_DATA' | 'SELECT_FULL_TABLE' | 'TOGGLE_AUTO_CALCULATED_COLUMNS' | 'OVERWRITE_CALCULATED_COLUMN' | 'TOGGLE_TABLE_AUTO_EXPAND';
+/**
+ * Print/Export actions - print preview, page breaks, PDF export.
+ * Target: UIStore (print slices) + Sheets domain (print settings)
+ *
+ * Plan 13: Printing/Export Excel Parity
+ * @see plans/active/excel-parity/13-PRINTING-EXPORT-PLAN.md
+ */
+export type PrintExportActionType = 'EXPORT_PDF' | 'TOGGLE_PAGE_BREAK_PREVIEW' | 'SET_PRINT_AREA' | 'CLEAR_PRINT_AREA' | 'ADD_TO_PRINT_AREA' | 'RESET_PAGE_BREAKS' | 'SET_PRINT_SCOPE' | 'SET_PRINT_PAGE_RANGE' | 'QUICK_PRINT';
+/**
+ * Chart actions - chart-specific operations.
+ * Target: ChartMachine + Charts domain module + UIStore (chart slices)
+ *
+ * Track 13: Charts - Z-Order, Copy/Paste, Multi-Select
+ * P2-C/P2-D: Keyboard shortcuts and clipboard integration
+ * @see plans/active/excel-parity/13-CHARTS.md
+ * @see plans/active/charts/CHART-ENGINE-REARCHITECTURE.md
+ */
+export type ChartActionType = 'SELECT_CHART' | 'DESELECT_CHART' | 'DESELECT_ALL_CHARTS' | 'ADD_CHART_TO_SELECTION' | 'TOGGLE_CHART_SELECTION' | 'BRING_CHART_TO_FRONT' | 'SEND_CHART_TO_BACK' | 'BRING_CHART_FORWARD' | 'SEND_CHART_BACKWARD' | 'COPY_CHART' | 'CUT_CHART' | 'PASTE_CHART' | 'CYCLE_NEXT_CHART' | 'CYCLE_PREVIOUS_CHART' | 'CREATE_CHART_SHEET' | 'CREATE_EMBEDDED_CHART' | 'EDIT_CHART' | 'EDIT_CHART_TITLE' | 'CHANGE_CHART_TYPE' | 'DUPLICATE_CHART' | 'SAVE_CHART_AS_IMAGE' | 'DELETE_CHART' | 'OPEN_SELECT_DATA_DIALOG' | 'CLOSE_SELECT_DATA_DIALOG' | 'APPLY_SELECT_DATA' | 'OPEN_INSERT_CHART_WIZARD_DIALOG' | 'CLOSE_INSERT_CHART_WIZARD_DIALOG' | 'INSERT_CHART_FROM_WIZARD' | 'NUDGE_CHART_UP' | 'NUDGE_CHART_DOWN' | 'NUDGE_CHART_LEFT' | 'NUDGE_CHART_RIGHT' | 'RESET_CHART_STYLE' | 'OPEN_MOVE_CHART_DIALOG' | 'OPEN_FORMAT_CHART_AREA' | 'OPEN_FORMAT_PLOT_AREA' | 'OPEN_FORMAT_DATA_SERIES' | 'ADD_DATA_LABELS' | 'ADD_TRENDLINE' | 'OPEN_FORMAT_AXIS' | 'TOGGLE_GRIDLINES' | 'OPEN_FORMAT_LEGEND' | 'OPEN_FORMAT_CHART_TITLE' | 'SHOW_CHART_TOOLTIP' | 'HIDE_CHART_TOOLTIP' | 'SET_CHART_ERROR' | 'CLEAR_CHART_ERROR' | 'CLEAR_ALL_CHART_ERRORS' | 'SET_CHART_EDITOR_TAB' | 'OPEN_CHART_TITLE_EDITOR' | 'CLOSE_CHART_TITLE_EDITOR';
+/**
+ * Data Analysis Dialog actions - Goal Seek, Consolidate, Error Checking, etc.
+ * Target: UIStore (dialog slices) + Analysis operations
+ *
+ * Plan 08 P3: Data Analysis Dialogs
+ */
+export type DataAnalysisDialogActionType = 'OPEN_GOAL_SEEK_DIALOG' | 'CLOSE_GOAL_SEEK_DIALOG' | 'EXECUTE_GOAL_SEEK' | 'APPLY_GOAL_SEEK_RESULT' | 'CANCEL_GOAL_SEEK' | 'OPEN_CONSOLIDATE_DIALOG' | 'CLOSE_CONSOLIDATE_DIALOG' | 'EXECUTE_CONSOLIDATE' | 'OPEN_SPELLING_DIALOG' | 'CLOSE_SPELLING_DIALOG' | 'SPELL_CHECK_NEXT' | 'SPELL_CHECK_CHANGE' | 'SPELL_CHECK_CHANGE_ALL' | 'SPELL_CHECK_IGNORE' | 'SPELL_CHECK_IGNORE_ALL' | 'SPELL_CHECK_ADD_TO_DICTIONARY' | 'OPEN_WATCH_WINDOW' | 'CLOSE_WATCH_WINDOW' | 'TOGGLE_WATCH_WINDOW' | 'ADD_WATCH' | 'DELETE_WATCH' | 'DELETE_ALL_WATCHES' | 'OPEN_ERROR_CHECKING_DIALOG' | 'CLOSE_ERROR_CHECKING_DIALOG' | 'ERROR_CHECK_NEXT' | 'ERROR_CHECK_PREVIOUS' | 'ERROR_CHECK_IGNORE' | 'ERROR_CHECK_EDIT_IN_FORMULA_BAR' | 'OPEN_EVALUATE_FORMULA_DIALOG' | 'CLOSE_EVALUATE_FORMULA_DIALOG' | 'EVALUATE_NEXT_STEP' | 'EVALUATE_STEP_IN' | 'EVALUATE_STEP_OUT' | 'EVALUATE_RESTART' | 'OPEN_DATA_TABLE_DIALOG' | 'CLOSE_DATA_TABLE_DIALOG' | 'EXECUTE_DATA_TABLE' | 'CANCEL_DATA_TABLE' | 'OPEN_SCENARIO_MANAGER_DIALOG' | 'CLOSE_SCENARIO_MANAGER_DIALOG' | 'CREATE_SCENARIO' | 'UPDATE_SCENARIO' | 'DELETE_SCENARIO' | 'APPLY_SCENARIO' | 'RESTORE_ORIGINAL_VALUES';
+/**
+ * Ink actions - ink/drawing operations.
+ * Target: Drawing Manager + UIStore (ink slice)
+ *
+ * Wave 5: Ink Actions & UI System
+ * @see plans/active/ink-engine/INK-ENGINE-OVERVIEW.md
+ */
+export type InkActionType = 'ACTIVATE_INK_MODE' | 'DEACTIVATE_INK_MODE' | 'TOGGLE_INK_TOOL' | 'TOGGLE_INK_MODE_DEFAULT' | 'SET_INK_TOOL' | 'SET_INK_COLOR' | 'SET_INK_WIDTH' | 'SET_INK_OPACITY' | 'CLEAR_DRAWING' | 'DELETE_SELECTED_STROKES' | 'SELECT_ALL_STROKES' | 'INSERT_DRAWING' | 'TOGGLE_LASSO_SELECTION' | 'MOVE_SELECTED_STROKES' | 'TRANSFORM_SELECTED_STROKES' | 'RECOGNIZE_INK_AS_SHAPE' | 'RECOGNIZE_INK_AS_TEXT';
+/**
+ * Slicer actions - slicer control operations.
+ * Target: Slicers domain + UIStore
+ *
+ * P2.5: Slicer Context Menu (Plan 07 - Context Menus)
+ * Plan 15: Tables Excel Parity - Item 20: Slicer Connections Dialog
+ */
+export type SlicerActionType = 'OPEN_INSERT_SLICER_DIALOG' | 'CUT_SLICER' | 'COPY_SLICER' | 'PASTE_SLICER' | 'OPEN_SLICER_SETTINGS' | 'CLOSE_SLICER_SETTINGS' | 'OPEN_SLICER_REPORT_CONNECTIONS' | 'CLOSE_SLICER_REPORT_CONNECTIONS' | 'OPEN_SLICER_SIZE_PROPERTIES' | 'CLOSE_SLICER_SIZE_PROPERTIES' | 'OPEN_SLICER_CONNECTIONS' | 'UPDATE_SLICER_CONNECTIONS' | 'CLOSE_SLICER_CONNECTIONS_DIALOG' | 'BRING_SLICER_TO_FRONT' | 'SEND_SLICER_TO_BACK' | 'BRING_SLICER_FORWARD' | 'SEND_SLICER_BACKWARD' | 'DELETE_SLICER';
+/**
+ * Split View actions - split viewport operations.
+ * Target: SheetMeta (Yjs) + UIStore (split slice)
+ *
+ * @see plans/active/excel-parity/01-split-view-not-implemented.md
+ */
+export type SplitActionType = 'TOGGLE_SPLIT' | 'SET_SPLIT_POSITION' | 'REMOVE_SPLIT' | 'FOCUS_NEXT_SPLIT_VIEWPORT' | 'FOCUS_PREV_SPLIT_VIEWPORT';
+/**
+ * SmartArt actions - SmartArt diagram operations.
+ * Target: SmartArtBridge + FloatingObjectManager + UIStore
+ *
+ * @see plans/active/excel-parity/smart-art/08-UI-COMPONENTS.md
+ */
+export type SmartArtActionType = 'OPEN_SMARTART_DIALOG' | 'CLOSE_SMARTART_DIALOG' | 'SMARTART_SELECT_NODE' | 'SMARTART_DESELECT_NODE' | 'TOGGLE_SMARTART_TEXT_PANE' | 'SMARTART_STOP_EDITING' | 'SMARTART_INSERT' | 'SMARTART_DELETE' | 'SMARTART_ADD_NODE' | 'SMARTART_REMOVE_NODE' | 'SMARTART_UPDATE_NODE' | 'SMARTART_PROMOTE_NODE' | 'SMARTART_DEMOTE_NODE' | 'SMARTART_MOVE_NODE_UP' | 'SMARTART_MOVE_NODE_DOWN' | 'SMARTART_UPDATE_STYLE' | 'SMARTART_UPDATE_LAYOUT';
+/**
+ * WordArt actions - WordArt object operations.
+ * Target: WordArtMutations + FloatingObjectManager + UIStore
+ *
+ * @see plans/active/excel-parity/word-art/05-ENGINE-INTEGRATION.md
+ */
+export type WordArtActionType = 'INSERT_WORDART' | 'DELETE_WORDART' | 'UPDATE_WORDART_WARP' | 'UPDATE_WORDART_FILL' | 'UPDATE_WORDART_OUTLINE' | 'UPDATE_WORDART_EFFECTS' | 'UPDATE_WORDART_FORMAT' | 'EDIT_WORDART_TEXT' | 'COMMIT_WORDART_TEXT' | 'CANCEL_WORDART_EDIT' | 'CONVERT_TO_WORDART' | 'CONVERT_TO_TEXTBOX' | 'OPEN_WORDART_GALLERY' | 'CLOSE_WORDART_GALLERY' | 'SET_WORDART_GALLERY_PRESET';
+/**
+ * Equation actions - equation insertion and editing operations.
+ * Target: Floating Object Manager / UIStore
+ *
+ * @see plans/active/excel-parity/equation/05-ENGINE-INTEGRATION.md
+ */
+export type EquationActionType = 'INSERT_EQUATION' | 'EDIT_EQUATION' | 'UPDATE_EQUATION' | 'DELETE_EQUATION' | 'OPEN_EQUATION_DIALOG' | 'CLOSE_EQUATION_DIALOG';
+/**
+ * View actions - keyboard shortcuts for alternate views (Kanban, Gallery, Calendar, Timeline).
+ * Target: View-specific interaction handlers
+ */
+export type ViewActionType = 'KANBAN_MOVE_UP' | 'KANBAN_MOVE_DOWN' | 'KANBAN_MOVE_LEFT' | 'KANBAN_MOVE_RIGHT' | 'KANBAN_EDIT' | 'KANBAN_DELETE' | 'KANBAN_DESELECT' | 'KANBAN_NEW_CARD' | 'KANBAN_SELECT_ALL' | 'GALLERY_MOVE_UP' | 'GALLERY_MOVE_DOWN' | 'GALLERY_MOVE_LEFT' | 'GALLERY_MOVE_RIGHT' | 'GALLERY_EDIT' | 'GALLERY_DELETE' | 'GALLERY_DESELECT' | 'GALLERY_SELECT_ALL' | 'CALENDAR_DELETE' | 'CALENDAR_DESELECT' | 'CALENDAR_SELECT_ALL' | 'TIMELINE_DELETE' | 'TIMELINE_DESELECT' | 'TIMELINE_SELECT_ALL';
+/**
+ * All possible action types in the unified action system.
+ * This is the complete set of actions that can be dispatched.
+ */
+export type ActionType = SelectionActionType | EditorActionType | ClipboardActionType | FormattingActionType | StructureActionType | NavigationActionType | UIActionType | WorkbookActionType | ObjectActionType | CommentActionType | FormatPainterActionType | FilterActionType | AutoFillActionType | FillContextMenuActionType | FlashFillActionType | CustomListsActionType | RepeatActionType | DragDropActionType | PasteValidationActionType | TotalRowActionType | TableActionType | ChartActionType | SlicerActionType | SplitActionType | InkActionType | ConditionalFormattingActionType | PrintExportActionType | DataAnalysisDialogActionType | SmartArtActionType | WordArtActionType | EquationActionType | ViewActionType;
+/**
+ * Minimal interface for UI Store API (Zustand store pattern).
+ *
+ * This interface describes the subset of Zustand's StoreApi that action handlers need.
+ * The actual state type is intentionally `unknown` to avoid circular dependencies
+ * between contracts and engine/shell packages.
+ *
+ * In practice:
+ * - Engine's UIStore implements this with UIState
+ * - Shell's UIStore implements this with ShellUIState
+ *
+ * Handlers should use type-safe helper functions to access the store:
+ * ```ts
+ * // In shell/src/actions/handlers/helpers/ui-store.ts
+ * import type { UIState } from '@mog/spreadsheet-engine/state';
+ *
+ * export function getUIState(deps: ActionDependencies): UIState {
+ *   return deps.uiStore.getState() as UIState;
+ * }
+ * ```
+ */
+export interface IUIStoreApi {
+    /**
+     * Get the current state snapshot.
+     * State contains both data and action methods (Zustand pattern).
+     */
+    getState(): unknown;
+    /**
+     * Update state with partial state or updater function.
+     * Typically not used directly by handlers - call state methods instead.
+     */
+    setState(partial: unknown | ((state: unknown) => unknown), replace?: boolean): void;
+    /**
+     * Subscribe to state changes.
+     * Typically not used by action handlers.
+     */
+    subscribe(listener: (state: unknown, prevState: unknown) => void): () => void;
+}
+/**
+ * Dependencies needed by action handlers.
+ *
+ * This interface is designed to be constructed once and passed to dispatch().
+ * Handlers receive all dependencies they might need; unused ones are simply ignored.
+ *
+ * CRITICAL: Handlers must not store references to these dependencies.
+ * They should use them synchronously and return.
+ */
+export interface ActionDependencies {
+    /**
+     * Unified Workbook API — THE single entry point for all data/compute operations.
+     *
+     * The single entry point for all data/compute operations.
+     * All paths terminate at the same ComputeBridge -> MutationResultHandler -> EventBus pipeline.
+     */
+    workbook: import('../api').Workbook;
+    /**
+     * Actor accessors for reading actor state (point-in-time reads).
+     * Handlers should use this instead of directly accessing actors.
+     *
+     * @example
+     * ```ts
+     * const activeCell = deps.accessors.selection.getActiveCell();
+     * if (deps.accessors.editor.isFormulaEditing()) { ... }
+     * ```
+     *
+     * @see plans/active/refactor/actor-access-layer.md
+     */
+    accessors: import('../actors').ActorAccessors;
+    /**
+     * Actor commands for writing actor state.
+     * Handlers should use this instead of directly calling actor.send().
+     *
+     * @example
+     * ```ts
+     * deps.commands.selection.keyArrow('down', false);
+     * deps.commands.editor.commit('down');
+     * ```
+     *
+     * @see plans/active/refactor/actor-access-layer.md
+     */
+    commands: import('../actors').ActorCommands;
+    /** Get active sheet ID */
+    getActiveSheetId: () => string;
+    /**
+     * Get selected sheet IDs for multi-sheet operations.
+     * When multiple sheets are selected, operations like formatting
+     * should broadcast to all selected sheets.
+     *
+     * Returns [activeSheetId] if not set (single sheet selection).
+     *
+     * Stream H: Multi-Sheet Selection
+     */
+    getSelectedSheetIds?: () => string[] | Promise<string[]>;
+    /** UI action callback (for dialogs, view toggles, etc.) */
+    onUIAction?: (action: string) => void;
+    /** Workbook action callback (for sheet navigation, etc.) */
+    onWorkbookAction?: (action: string) => void;
+    /** Check if floating objects are selected */
+    hasObjectSelection?: () => boolean;
+    /** Check if editing text inside a floating object */
+    isEditingObjectText?: () => boolean;
+    /** Get current selection state (for handlers that need selection info) */
+    getSelection?: () => unknown;
+    /**
+     * UI Store for ephemeral UI state (dialogs, pending formats, etc.).
+     *
+     * This is a Zustand store API instance that provides access to UI state.
+     * The state type is generic to avoid contracts → engine circular dependency.
+     *
+     * Handler pattern - use getState() to access current state:
+     * ```ts
+     * const state = deps.uiStore.getState();
+     * if (state.dialogOpen) { ... }
+     * state.openDialog();  // Methods are on the state, not the store
+     * ```
+     *
+     * In engine, the state type is `UIState`.
+     * In shell, the state type is `ShellUIState`.
+     */
+    uiStore: IUIStoreApi;
+    /**
+     * Coordinator instance for viewport/scroll operations.
+     * Type is `unknown` here to avoid contracts → engine dependency.
+     * In engine, this is typed as `SheetCoordinator`.
+     *
+     * E1/E4: Used for scrollToActiveCell via Ctrl+Backspace.
+     */
+    coordinator?: unknown;
+}
+/**
+ * Result of executing an action handler.
+ */
+export interface ActionResult {
+    /**
+     * Whether the action was handled.
+     * If true, the caller should typically preventDefault().
+     */
+    handled: boolean;
+    /**
+     * Error message if the action failed.
+     * Only set when handled is true but an error occurred.
+     */
+    error?: string;
+    /**
+     * Reason for not handling (debugging).
+     * Only set when handled is false.
+     */
+    reason?: 'not_found' | 'not_implemented' | 'wrong_context' | 'disabled' | 'blocked';
+    /**
+     * Mutation receipts collected during action execution.
+     * Downstream consumers (rendering, selection, undo) can use these
+     * without re-querying for the mutated state.
+     */
+    receipts?: import('../api/mutation-receipt').MutationReceipt[];
+}
+/**
+ * Function signature for action handlers.
+ *
+ * Handlers are pure functions that:
+ * 1. Receive dependencies (actors, ctx, etc.) and optional payload
+ * 2. Perform the action (send to actor, call Mutations, etc.)
+ * 3. Return a result indicating success/failure
+ *
+ * Handlers should NOT:
+ * - Store references to dependencies
+ * - Perform async operations (use callbacks for those)
+ * - Access global state directly
+ *
+ * @param deps - Action dependencies (ctx, actors, etc.)
+ * @param payload - Optional action-specific data (e.g., { panel: 'info' } for SET_BACKSTAGE_PANEL)
+ */
+export type ActionHandler = (deps: ActionDependencies, payload?: any) => ActionResult;
+/**
+ * Async action handler type.
+ *
+ * Used for actions that require async operations (e.g., ink recognition).
+ * The dispatcher handles awaiting these automatically.
+ */
+export type AsyncActionHandler = (deps: ActionDependencies, payload?: any) => Promise<ActionResult>;
+/**
+ * Combined handler type that allows both sync and async handlers.
+ */
+export type AnyActionHandler = ActionHandler | AsyncActionHandler;
+/**
+ * Type for the handler map.
+ * Ensures every ActionType has a corresponding handler.
+ * Handlers can be sync or async.
+ */
+export type ActionHandlerMap = Record<ActionType, AnyActionHandler>;
+//# sourceMappingURL=types.d.ts.map