@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/actors/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Actor Access Layer
+ *
+ * Exports for actor-related types and interfaces.
+ * Runtime selectors have been moved to @mog/kernel/selectors.
+ *
+ * ARCHITECTURE: Selectors are the single primitive for extraction logic.
+ * - Snapshots compose selectors (no duplication)
+ * - Accessors wrap selectors + getSnapshot() (no duplication)
+ * - Hooks use selectors directly with useSelector (no duplication)
+ *
+ * @see plans/active/refactor/actor-access-layer.md
+ * @module @mog/spreadsheet-contracts/actors
+ */
+export type { SelectionAccessor, SelectionState } from './selection';
+export type { EditorAccessor, EditorState, FormulaContext, FunctionStackEntry } from './editor';
+export { EXTERNAL_SOURCE_SHEET_ID } from './clipboard';
+export type { ClipboardAccessor, CellCoord as ClipboardCellCoord, ClipboardCellData, ClipboardData, ClipboardState, PasteMenuOption, PasteSpecialOptions, PasteValidationViolation, RelativeComment, RelativeConditionalFormat, RelativeMerge, RelativeValidation, } from './clipboard';
+export type { ChartAccessor, ChartElementType, ChartState, ChartType } from './chart';
+export type { ObjectAccessor, Point as ObjectPoint, ObjectState } from './object';
+export type { FindReplaceAccessor, FindReplaceCommands, FindReplaceState } from './find-replace';
+export type { InputAccessor, InputCommands, InputState } from './input';
+export type { SlicerAccessor, SlicerActor, SlicerCommands, SlicerEvent, SlicerState, } from './slicer';
+export type { PageBreakAccessor, PageBreakCommands, PageBreakState } from './page-break';
+export type { CommentAccessor, CommentState, CommentTarget } from './comment';
+export type { PaneFocusAccessor, PaneFocusCommands, PaneFocusState, PaneType } from './pane-focus';
+export type { DrawBorderAccessor, DrawBorderMode, DrawBorderState, DrawBorderStyle, } from './draw-border';
+export type { SmartArtAccessor, NodeId as SmartArtNodeId, SmartArtState, SmartArtUIState, } from './smartart';
+export type { PendingAction, RendererAccessor, RendererCommands, RendererState, RendererStatus, } from './renderer';
+export type { FocusAccessor, FocusState } from './focus';
+export type { CancelOperationEvent, ClearOperationEvent, CompleteOperationEvent, FloatingObjectOperation, OperationEvent, OperationObjectState, OperationResizeHandle, StartDragEvent, StartResizeEvent, StartRotateEvent, UpdatePositionEvent, } from './object-interaction';
+export type { ActorCommands, ChartCommands, ClipboardCommands, CommentCommands, DrawBorderCommands, DrawBorderStyleConfig, EditorCommands, ObjectCommands, PasteOption, ResizeHandle, SelectionCommands, SmartArtCommands, } from './commands';
+export type { Point } from './commands';
+import type { ChartAccessor } from './chart';
+import type { ClipboardAccessor } from './clipboard';
+import type { CommentAccessor } from './comment';
+import type { DrawBorderAccessor } from './draw-border';
+import type { EditorAccessor } from './editor';
+import type { FindReplaceAccessor } from './find-replace';
+import type { FocusAccessor } from './focus';
+import type { ObjectAccessor } from './object';
+import type { PaneFocusAccessor } from './pane-focus';
+import type { RendererAccessor } from './renderer';
+import type { SelectionAccessor } from './selection';
+import type { SmartArtAccessor } from './smartart';
+/**
+ * Aggregated interface containing all actor accessors.
+ * This is the main interface used by handlers to read actor state.
+ *
+ * @example
+ * ```ts
+ * const MOVE_UP: ActionHandler = (deps) => {
+ *   const activeCell = deps.accessors.selection.getActiveCell();
+ *   if (deps.accessors.editor.isEditing()) {
+ *     deps.commands.editor.commit('up');
+ *   } else {
+ *     deps.commands.selection.keyArrow('up', false);
+ *   }
+ * };
+ * ```
+ */
+export interface ActorAccessors {
+    /** Selection machine accessors (point-in-time reads) */
+    selection: SelectionAccessor;
+    /** Editor machine accessors (point-in-time reads) */
+    editor: EditorAccessor;
+    /** Clipboard machine accessors (point-in-time reads) */
+    clipboard: ClipboardAccessor;
+    /** Chart machine accessors (point-in-time reads) */
+    chart: ChartAccessor;
+    /** Object interaction machine accessors (point-in-time reads) */
+    object: ObjectAccessor;
+    /** Find-replace machine accessors (optional - not all contexts have it) */
+    findReplace?: FindReplaceAccessor;
+    /** Pane focus machine accessors (optional - not all contexts have it) */
+    paneFocus?: PaneFocusAccessor;
+    /** Comment machine accessors (optional - not all contexts have it) */
+    comment?: CommentAccessor;
+    /** Draw border machine accessors (optional - not all contexts have it) */
+    drawBorder?: DrawBorderAccessor;
+    /** Renderer machine accessors (optional - not all contexts have it) */
+    renderer?: RendererAccessor;
+    /** Focus machine accessors (optional - not all contexts have it) */
+    focus?: FocusAccessor;
+    /** SmartArt machine accessors (optional - not all contexts have it) */
+    smartArt?: SmartArtAccessor;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/actors/input.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Input Actor Access
+ *
+ * Selectors (the primitive) + Accessor interface (the contract for handlers).
+ * Co-located to prevent drift.
+ *
+ * States:
+ * - idle: No active gesture, waiting for input
+ * - scrolling: Active wheel scrolling
+ * - momentum: Inertial scrolling after wheel/pan ends
+ * - panning: Pointer/touch drag to scroll
+ * - pinching: Two-finger pinch to zoom
+ * - zooming: Wheel-based zoom (Ctrl+wheel or trackpad pinch)
+ *
+ * @see state-machines/src/input-machine.ts
+ */
+/**
+ * Minimal state type for selectors - matches XState snapshot shape.
+ */
+export interface InputState {
+    context: {
+        /** Current horizontal scroll position in pixels */
+        scrollX: number;
+        /** Current vertical scroll position in pixels */
+        scrollY: number;
+        /** Current horizontal velocity in px/s */
+        velocityX: number;
+        /** Current vertical velocity in px/s */
+        velocityY: number;
+        /** Current zoom level (1.0 = 100%) */
+        zoomLevel: number;
+        /** Zoom center X coordinate */
+        zoomCenterX: number;
+        /** Zoom center Y coordinate */
+        zoomCenterY: number;
+        /** Active touch points */
+        activeTouches: Array<{
+            id: number;
+            x: number;
+            y: number;
+        }>;
+        /** Initial pinch distance for zoom calculation */
+        initialPinchDistance: number;
+        /** Pan start X coordinate */
+        panStartX: number;
+        /** Pan start Y coordinate */
+        panStartY: number;
+    };
+    matches(state: any): boolean;
+    value: string;
+}
+export interface InputAccessor {
+    getScrollX(): number;
+    getScrollY(): number;
+    getVelocityX(): number;
+    getVelocityY(): number;
+    getZoomLevel(): number;
+    getZoomCenterX(): number;
+    getZoomCenterY(): number;
+    getActiveTouches(): Array<{
+        id: number;
+        x: number;
+        y: number;
+    }>;
+    getPanStartX(): number;
+    getPanStartY(): number;
+    isIdle(): boolean;
+    isScrolling(): boolean;
+    isPanning(): boolean;
+    isPinching(): boolean;
+    isZooming(): boolean;
+    isMomentum(): boolean;
+    isAnimating(): boolean;
+    getMachineState(): string;
+}
+export interface InputCommands {
+    wheel(deltaX: number, deltaY: number): void;
+    scrollEnd(): void;
+    zoom(delta: number, centerX: number, centerY: number): void;
+    zoomComplete(): void;
+    panStart(x: number, y: number): void;
+    panMove(x: number, y: number): void;
+    panEnd(velocityX: number, velocityY: number): void;
+    touchStart(touches: Array<{
+        id: number;
+        x: number;
+        y: number;
+    }>): void;
+    touchMove(touches: Array<{
+        id: number;
+        x: number;
+        y: number;
+    }>): void;
+    touchEnd(touchIds: number[]): void;
+    momentumComplete(): void;
+    interrupt(): void;
+}
+//# sourceMappingURL=input.d.ts.map

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

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

package/dist/actors/object-interaction.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Object Interaction Operation Types
+ *
+ * Defines types for the unified floating object operation model.
+ * All operations (drag, resize, rotate) use ONE state machine state
+ * with operation details stored in context.
+ *
+ * This enables:
+ * - Direct canvas updates (objects move with cursor, not preview outlines)
+ * - Real-time collaboration (operations broadcast via presence channel)
+ * - Single completion path (impossible to forget handling one operation type)
+ * - Clean undo (single Yjs transaction per operation)
+ *
+ * @see plans/active/refactor/unified-floating-object-operations.md
+ * @module @mog/spreadsheet-contracts/actors/object-interaction
+ */
+import type { FloatingObjectType } from '../objects/floating-objects';
+import type { ObjectBounds } from '../rendering/hit-test';
+import type { Point } from '../viewport';
+/**
+ * Resize handle directions.
+ * Represents the 8 compass points for resize handles around an object.
+ */
+export type OperationResizeHandle = 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w' | 'nw';
+/**
+ * State of an object (bounds + rotation) for operation tracking.
+ * Captures the complete geometric state needed to render an object.
+ */
+export interface OperationObjectState {
+    /** Object bounds in pixel coordinates */
+    bounds: ObjectBounds;
+    /** Rotation angle in radians */
+    rotation: number;
+    /** Object type for constraint application during resize preview.
+     *  Captured at operation start to avoid async IPC during rendering. */
+    objectType?: FloatingObjectType;
+}
+/**
+ * Unified floating object operation.
+ * Captures all information needed for drag/resize/rotate operations.
+ *
+ * This is stored in the state machine context during an operation,
+ * enabling:
+ * - Pure calculation functions to derive effective state
+ * - Single completion handler for all operation types
+ * - Clean serialization for presence broadcast
+ *
+ * @example
+ * ```typescript
+ * // Start a drag operation
+ * const operation: FloatingObjectOperation = {
+ *   type: 'drag',
+ *   objectIds: ['shape-1', 'shape-2'],
+ *   startPosition: { x: 100, y: 100 },
+ *   currentPosition: { x: 150, y: 120 },
+ *   originalStates: new Map([
+ *     ['shape-1', { bounds: { x: 50, y: 50, width: 100, height: 80, rotation: 0 }, rotation: 0 }],
+ *     ['shape-2', { bounds: { x: 200, y: 50, width: 100, height: 80, rotation: 0 }, rotation: 0 }]
+ *   ])
+ * };
+ * ```
+ */
+export interface FloatingObjectOperation {
+    /** Operation type discriminator */
+    type: 'drag' | 'resize' | 'rotate';
+    /** IDs of objects being operated on (supports multi-select) */
+    objectIds: string[];
+    /** Mouse position at operation start (viewport coordinates) */
+    startPosition: Point;
+    /** Current mouse position (viewport coordinates) */
+    currentPosition: Point;
+    /**
+     * Original states of all objects at operation start.
+     * Used to calculate effective position during operation and
+     * detect actual changes for undo.
+     */
+    originalStates: Map<string, OperationObjectState>;
+    /** Resize handle being used (only for resize operations) */
+    resizeHandle?: OperationResizeHandle;
+    /** Center point for rotation (only for rotate operations) */
+    rotationCenter?: Point;
+}
+/**
+ * Event to start a drag operation.
+ * Transitions from selected → operating state.
+ */
+export interface StartDragEvent {
+    type: 'START_DRAG';
+    /** IDs of objects to drag */
+    objectIds: string[];
+    /** Starting mouse position */
+    position: Point;
+    /** Original states of all objects */
+    originalStates: Map<string, OperationObjectState>;
+}
+/**
+ * Event to start a resize operation.
+ * Transitions from selected → operating state.
+ */
+export interface StartResizeEvent {
+    type: 'START_RESIZE';
+    /** IDs of objects to resize */
+    objectIds: string[];
+    /** Starting mouse position */
+    position: Point;
+    /** Which resize handle was grabbed */
+    handle: OperationResizeHandle;
+    /** Original states of all objects */
+    originalStates: Map<string, OperationObjectState>;
+}
+/**
+ * Event to start a rotate operation.
+ * Transitions from selected → operating state.
+ */
+export interface StartRotateEvent {
+    type: 'START_ROTATE';
+    /** IDs of objects to rotate */
+    objectIds: string[];
+    /** Starting mouse position */
+    position: Point;
+    /** Center point for rotation calculation */
+    rotationCenter: Point;
+    /** Original states of all objects */
+    originalStates: Map<string, OperationObjectState>;
+}
+/**
+ * Event to update the current position during an operation.
+ * Fires on mouse move while operating.
+ */
+export interface UpdatePositionEvent {
+    type: 'UPDATE_POSITION';
+    /** New mouse position */
+    position: Point;
+}
+/**
+ * Event to complete the current operation.
+ * Transitions from operating → selected state.
+ * Operation remains in context for the completion subscription to read.
+ */
+export interface CompleteOperationEvent {
+    type: 'COMPLETE_OPERATION';
+}
+/**
+ * Event to cancel the current operation.
+ * Transitions from operating → selected state and clears the operation.
+ * Objects return to their original positions.
+ */
+export interface CancelOperationEvent {
+    type: 'CANCEL_OPERATION';
+}
+/**
+ * Event to clear the operation from context after commit.
+ * Called by the completion subscription after persisting to Yjs.
+ */
+export interface ClearOperationEvent {
+    type: 'CLEAR_OPERATION';
+}
+/**
+ * Union of all operation-related events.
+ * Used for type-safe event handling in the state machine.
+ */
+export type OperationEvent = StartDragEvent | StartResizeEvent | StartRotateEvent | UpdatePositionEvent | CompleteOperationEvent | CancelOperationEvent | ClearOperationEvent;
+//# sourceMappingURL=object-interaction.d.ts.map

package/dist/actors/object-interaction.d.ts.map

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

package/dist/actors/object.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Object Actor Access (Floating Objects - Images, Shapes, Text Boxes)
+ *
+ * Selectors (the primitive) + Accessor interface (the contract for handlers).
+ * Co-located to prevent drift.
+ *
+ * States:
+ * - idle: No object selected, clicks go to cells
+ * - selected: Single object selected, showing handles
+ * - multiSelected: Multiple objects selected
+ * - operating: Unified operation state for drag/resize/rotate
+ * - editingText: Editing text inside textbox/shape
+ *
+ * @see state-machines/src/object-interaction-machine.ts
+ * @see plans/active/refactor/unified-floating-object-operations.md
+ */
+import type { ObjectHitRegion, ObjectInteractionState } from '../objects/floating-objects';
+import type { FloatingObjectOperation } from './object-interaction';
+/**
+ * Point type for drag/resize operations.
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Minimal state type for selectors - matches XState snapshot shape.
+ */
+export interface ObjectState {
+    context: {
+        /** Currently selected object IDs (empty if idle) */
+        selectedIds: string[];
+        /** Active resize/rotation handle (if applicable) */
+        activeHandle: ObjectHitRegion | null;
+        /** Object being edited (for text editing state) */
+        editingObjectId: string | null;
+        /** Whether shift key was held (for constrained resize) */
+        shiftKey: boolean;
+        /**
+         * Current unified operation (null when not operating).
+         * Contains all information for drag/resize/rotate operations.
+         * @see FloatingObjectOperation
+         */
+        operation?: FloatingObjectOperation | null;
+    };
+    matches(state: any): boolean;
+    value: string;
+}
+export interface ObjectAccessor {
+    getSelectedIds(): string[];
+    getActiveHandle(): ObjectHitRegion | null;
+    getEditingObjectId(): string | null;
+    getShiftKey(): boolean;
+    hasSelection(): boolean;
+    hasMultipleSelected(): boolean;
+    getSelectedCount(): number;
+    getFirstSelectedId(): string | null;
+    isResizeHandle(): boolean;
+    isRotationHandle(): boolean;
+    isIdle(): boolean;
+    isSelected(): boolean;
+    isMultiSelected(): boolean;
+    isEditingText(): boolean;
+    isInAnySelectedState(): boolean;
+    isInteracting(): boolean;
+    getInteractionState(): ObjectInteractionState;
+    /**
+     * Get the current unified operation (null when not operating).
+     * @see FloatingObjectOperation
+     */
+    getOperation(): FloatingObjectOperation | null;
+    /**
+     * Check if currently in the unified operating state.
+     */
+    isOperating(): boolean;
+    /**
+     * Get the type of the current operation ('drag' | 'resize' | 'rotate' | null).
+     * Returns null if not in an operation.
+     */
+    getOperationType(): 'drag' | 'resize' | 'rotate' | null;
+    /**
+     * Get the object IDs involved in the current operation.
+     * Returns empty array if not operating.
+     */
+    getOperationObjectIds(): string[];
+    /**
+     * Check if currently interacting via the unified operation model.
+     * This checks for the 'operating' state.
+     */
+    isInteractingUnified(): boolean;
+    /**
+     * Check if currently in insert mode (drag-to-insert a new shape).
+     */
+    isInserting(): boolean;
+    /**
+     * Get the shape type being inserted (null when not in insert mode).
+     */
+    getInsertShapeType(): string | null;
+    /**
+     * Get the start position for drag-to-insert.
+     */
+    getInsertStartPosition(): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Get the current position during drag-to-insert.
+     */
+    getInsertCurrentPosition(): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Check if currently editing WordArt text.
+     */
+    isWordArtEditing(): boolean;
+    /**
+     * Check if currently adjusting WordArt warp.
+     */
+    isAdjustingWarp(): boolean;
+}
+export type { ObjectHitRegion, ObjectInteractionState };
+export type { FloatingObjectOperation } from './object-interaction';
+//# sourceMappingURL=object.d.ts.map

package/dist/actors/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/actors/object.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAMpE;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE;QACP,oDAAoD;QACpD,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,oDAAoD;QACpD,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;QACrC,mDAAmD;QACnD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,0DAA0D;QAC1D,QAAQ,EAAE,OAAO,CAAC;QAClB;;;;WAIG;QACH,SAAS,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;KAC5C,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAWD,MAAM,WAAW,cAAc;IAE7B,cAAc,IAAI,MAAM,EAAE,CAAC;IAC3B,eAAe,IAAI,eAAe,GAAG,IAAI,CAAC;IAC1C,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAAC;IACpC,WAAW,IAAI,OAAO,CAAC;IAGvB,YAAY,IAAI,OAAO,CAAC;IACxB,mBAAmB,IAAI,OAAO,CAAC;IAC/B,gBAAgB,IAAI,MAAM,CAAC;IAC3B,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAAC;IACpC,cAAc,IAAI,OAAO,CAAC;IAC1B,gBAAgB,IAAI,OAAO,CAAC;IAG5B,MAAM,IAAI,OAAO,CAAC;IAClB,UAAU,IAAI,OAAO,CAAC;IACtB,eAAe,IAAI,OAAO,CAAC;IAC3B,aAAa,IAAI,OAAO,CAAC;IAGzB,oBAAoB,IAAI,OAAO,CAAC;IAChC,aAAa,IAAI,OAAO,CAAC;IACzB,mBAAmB,IAAI,sBAAsB,CAAC;IAM9C;;;OAGG;IACH,YAAY,IAAI,uBAAuB,GAAG,IAAI,CAAC;IAE/C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;;OAGG;IACH,gBAAgB,IAAI,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;IAExD;;;OAGG;IACH,qBAAqB,IAAI,MAAM,EAAE,CAAC;IAElC;;;OAGG;IACH,oBAAoB,IAAI,OAAO,CAAC;IAMhC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,sBAAsB,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,wBAAwB,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAM5D;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC;IAE5B;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC;CAC5B;AAGD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,CAAC;AAGxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/actors/page-break.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Page Break Actor Access
+ *
+ * Selectors (the primitive) + Accessor interface (the contract for handlers).
+ * Co-located to prevent drift.
+ *
+ * States:
+ * - idle: No drag in progress, waiting for user interaction
+ * - dragging: User is actively dragging a page break line
+ *
+ * @see state-machines/src/page-break-machine.ts
+ */
+import type { PageBreakInfo } from '../rendering';
+/**
+ * Minimal state type for selectors - matches XState snapshot shape.
+ */
+export interface PageBreakState {
+    context: {
+        /** Information about the page break being dragged (null when idle) */
+        pageBreak: PageBreakInfo | null;
+        /** Starting mouse position in pixels */
+        startPosition: {
+            x: number;
+            y: number;
+        };
+        /** Current mouse position in pixels during drag */
+        currentPosition: {
+            x: number;
+            y: number;
+        };
+        /** Current target position (row/col index the break would move to) */
+        targetPosition: number | null;
+    };
+    matches(state: any): boolean;
+    value: string;
+}
+export interface PageBreakAccessor {
+    getPageBreak(): PageBreakInfo | null;
+    getStartPosition(): {
+        x: number;
+        y: number;
+    };
+    getCurrentPosition(): {
+        x: number;
+        y: number;
+    };
+    getTargetPosition(): number | null;
+    isIdle(): boolean;
+    isDragging(): boolean;
+    hasMoved(): boolean;
+    hasPageBreak(): boolean;
+    getMachineState(): string;
+}
+export interface PageBreakCommands {
+    /** Start dragging a page break */
+    startDrag(pageBreak: PageBreakInfo, startX: number, startY: number): void;
+    /** Update drag position */
+    drag(x: number, y: number, targetPosition: number): void;
+    /** End the drag operation */
+    endDrag(): void;
+    /** Cancel the drag operation */
+    cancel(): void;
+}
+//# sourceMappingURL=page-break.d.ts.map

package/dist/actors/page-break.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-break.d.ts","sourceRoot":"","sources":["../../src/actors/page-break.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,sEAAsE;QACtE,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;QAChC,wCAAwC;QACxC,aAAa,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,mDAAmD;QACnD,eAAe,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,sEAAsE;QACtE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAWD,MAAM,WAAW,iBAAiB;IAEhC,YAAY,IAAI,aAAa,GAAG,IAAI,CAAC;IACrC,gBAAgB,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,kBAAkB,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAAC;IAGnC,MAAM,IAAI,OAAO,CAAC;IAClB,UAAU,IAAI,OAAO,CAAC;IAGtB,QAAQ,IAAI,OAAO,CAAC;IACpB,YAAY,IAAI,OAAO,CAAC;IACxB,eAAe,IAAI,MAAM,CAAC;CAC3B;AAMD,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,SAAS,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1E,2BAA2B;IAC3B,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzD,6BAA6B;IAC7B,OAAO,IAAI,IAAI,CAAC;IAEhB,gCAAgC;IAChC,MAAM,IAAI,IAAI,CAAC;CAChB"}

package/dist/actors/pane-focus.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Pane Focus Actor Access
+ *
+ * Selectors (the primitive) + Accessor interface (the contract for handlers).
+ * Co-located to prevent drift.
+ *
+ * Manages F6 pane navigation for cycling focus between major UI panes:
+ * toolbar -> formulaBar -> grid -> statusBar (and back)
+ *
+ * States:
+ * - toolbar: Quick Access Toolbar / Ribbon has focus
+ * - formulaBar: Formula bar input has focus
+ * - grid: Spreadsheet grid has focus (default state)
+ * - statusBar: Status bar has focus
+ *
+ * @see state-machines/src/pane-focus-machine.ts
+ */
+/**
+ * Types of panes that can receive focus.
+ * Order determines navigation cycle: toolbar -> formulaBar -> grid -> statusBar
+ */
+export type PaneType = 'toolbar' | 'formulaBar' | 'grid' | 'statusBar';
+/**
+ * Minimal state type for selectors - matches XState snapshot shape.
+ */
+export interface PaneFocusState {
+    context: {
+        /** Currently focused pane */
+        currentPane: PaneType;
+        /** Previously focused pane (for restoration after overlays) */
+        previousPane: PaneType | null;
+    };
+    matches(state: any): boolean;
+    value: string;
+}
+export interface PaneFocusAccessor {
+    getCurrentPane(): PaneType;
+    getPreviousPane(): PaneType | null;
+    isToolbarFocused(): boolean;
+    isFormulaBarFocused(): boolean;
+    isGridFocused(): boolean;
+    isStatusBarFocused(): boolean;
+    isGrid(): boolean;
+    getMachineState(): string;
+}
+export interface PaneFocusCommands {
+    /** Move to the next pane in the cycle (F6) */
+    focusNextPane(): void;
+    /** Move to the previous pane in the cycle (Shift+F6) */
+    focusPreviousPane(): void;
+    /** Focus a specific pane */
+    focusPane(pane: PaneType): void;
+    /** Reset focus to the grid */
+    resetToGrid(): void;
+}
+//# sourceMappingURL=pane-focus.d.ts.map

package/dist/actors/pane-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane-focus.d.ts","sourceRoot":"","sources":["../../src/actors/pane-focus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAMvE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,6BAA6B;QAC7B,WAAW,EAAE,QAAQ,CAAC;QACtB,+DAA+D;QAC/D,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAC;KAC/B,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAWD,MAAM,WAAW,iBAAiB;IAEhC,cAAc,IAAI,QAAQ,CAAC;IAC3B,eAAe,IAAI,QAAQ,GAAG,IAAI,CAAC;IAGnC,gBAAgB,IAAI,OAAO,CAAC;IAC5B,mBAAmB,IAAI,OAAO,CAAC;IAC/B,aAAa,IAAI,OAAO,CAAC;IACzB,kBAAkB,IAAI,OAAO,CAAC;IAG9B,MAAM,IAAI,OAAO,CAAC;IAClB,eAAe,IAAI,MAAM,CAAC;CAC3B;AAMD,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,aAAa,IAAI,IAAI,CAAC;IAEtB,wDAAwD;IACxD,iBAAiB,IAAI,IAAI,CAAC;IAE1B,4BAA4B;IAC5B,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEhC,8BAA8B;IAC9B,WAAW,IAAI,IAAI,CAAC;CACrB"}