@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/rendering/grid-renderer.d.ts

@@ -0,0 +1,391 @@
+/**
+ * Grid Renderer Interface
+ *
+ * Stable API for the grid renderer. State subsystem uses this interface
+ * to control rendering without depending on canvas internals.
+ *
+ * ARCHITECTURE:
+ * - Interface defined in contracts (this file)
+ * - Implementation (GridRendererImpl) in canvas
+ * - State creates renderer via factory, uses only this interface
+ *
+ * The rendering model is NOT `render()` on demand. It's:
+ * 1. `updateContext()` called 50-200+ times per second with state updates
+ * 2. Scheduler decides if render needed
+ * 3. Invalidation is explicit (`invalidateLayer`, `invalidateCells`, `invalidateAll`)
+ *
+ * Performance critical: `updateContext()` must have minimal overhead.
+ *
+ * @module @mog/spreadsheet-contracts/rendering/grid-renderer
+ */
+import type { ISmartArtBridge } from '../bridges/smartart-bridge';
+import type { CellRange } from '../core';
+import type { InkAccessorForRendering } from '../ink';
+import type { IObjectBoundsReader } from '../objects/object-bounds-reader';
+import type { ViewportLayout } from '../viewport';
+import type { IWordArtCanvasBridge, RenderLatexFn } from './canvas-bridge-types';
+import type { CellCoord, CoordinateSystem, ViewportMergeIndexLike, ViewportPositionIndexLike } from './coordinates';
+import type { ObjectBounds, UnifiedHitResult } from './hit-test';
+import type { InteractiveElementCollector } from './interactive-elements';
+import type { RenderContextConfig } from './render-context';
+/**
+ * Logical render layer names.
+ * Layers are rendered in z-order (lower index = behind).
+ */
+export type LayerName = 'background' | 'cells' | 'validationCircles' | 'pageBreaks' | 'selection' | 'traceArrows' | 'remoteCursors' | 'ui' | 'drawing' | 'overlay' | 'sticky-headers' | 'headers' | 'dividers';
+/**
+ * Render priority levels.
+ * Lower number = higher priority = executed first.
+ *
+ * Priority behaviors:
+ * - CRITICAL: Always immediate, never deferred
+ * - USER_BLOCKING: Execute within frame budget (16ms)
+ * - NORMAL: Time-sliced, yields if frame budget exceeded
+ * - LOW: Scheduled during idle time
+ * - IDLE: Uses requestIdleCallback
+ */
+export declare enum RenderPriority {
+    /** Selection, cursor blink - always immediate */
+    CRITICAL = 0,
+    /** Scroll feedback, edit preview - within 16ms frame */
+    USER_BLOCKING = 1,
+    /** Visible cell content - time-sliced */
+    NORMAL = 2,
+    /** Prefetch adjacent cells - during idle */
+    LOW = 3,
+    /** Background formatting - requestIdleCallback */
+    IDLE = 4
+}
+/**
+ * Statistics for monitoring renderer performance.
+ */
+export interface GridRendererStats {
+    /** Current FPS */
+    fps: number;
+    /** Average frame time in ms */
+    averageFrameTime: number;
+    /** Is render loop running? */
+    isRunning: boolean;
+    /** Is renderer paused? */
+    isPaused: boolean;
+    /** Total frames rendered */
+    totalFrames: number;
+    /** Scheduler queue depth */
+    queueDepth: number;
+}
+/**
+ * Scheduler that bridges buffer writes to canvas layer invalidation.
+ *
+ * Implements the "Write = Invalidate" contract: when viewport buffers
+ * receive patches, they call these methods to mark the appropriate canvas
+ * layers dirty and wake the render loop.
+ *
+ * This is a contracts-level mirror of the canvas-engine RenderScheduler
+ * so that contracts does not depend on @mog/canvas-engine at runtime.
+ */
+export interface RenderScheduler {
+    /** Cell value or format changed — mark cells layer dirty. */
+    markCellsDirty(cells?: {
+        row: number;
+        col: number;
+    }[]): void;
+    /** Row/col dimensions changed — mark cells + headers + selection dirty. */
+    markGeometryDirty(): void;
+    /** Full buffer swap or theme change — mark all layers dirty. */
+    markAllDirty(): void;
+}
+/** Bounds update for scene graph writes during drag/resize/rotate. */
+export interface ObjectBoundsUpdate {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+}
+/**
+ * Stable interface for the grid renderer.
+ *
+ * IMPORTANT: This interface includes ALL public methods of GridRendererImpl.
+ * Do NOT create a minimal interface - that would require gradual migration
+ * which is forbidden by the architecture checklist (Section 13: No Slow Migrations).
+ */
+export interface GridRenderer {
+    /**
+     * Start the render loop.
+     */
+    start(): void;
+    /**
+     * Stop the render loop.
+     */
+    stop(): void;
+    /**
+     * Pause rendering (e.g., when tab is hidden).
+     */
+    pause(): void;
+    /**
+     * Resume rendering (e.g., when tab becomes visible).
+     */
+    resume(): void;
+    /**
+     * Dispose of all resources.
+     */
+    dispose(): void;
+    /**
+     * Resize the canvas.
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Set the viewport layout.
+     *
+     * When set, the renderer iterates through each viewport in the layout,
+     * clips to viewport bounds, and renders layers for each viewport's cell range.
+     * This enables freeze panes, split views, and overlay viewports.
+     *
+     * Pass null to fall back to legacy single-viewport mode.
+     *
+     * @param layout - The computed viewport layout, or null to use legacy mode
+     */
+    setViewportLayout(layout: ViewportLayout | null): void;
+    /**
+     * Get the current viewport layout.
+     *
+     * @returns Current viewport layout, or null if using legacy mode
+     */
+    getViewportLayout(): ViewportLayout | null;
+    /**
+     * Update scroll position.
+     */
+    setScroll(scrollTop: number, scrollLeft: number): void;
+    /**
+     * Update zoom level.
+     */
+    setZoom(zoom: number): void;
+    /**
+     * Switch to a different sheet.
+     */
+    switchSheet(sheetId: string): void;
+    /**
+     * Update render context configuration.
+     *
+     * CRITICAL: This is called 50-200+ times per second during editing
+     * (every keystroke, selection change, format change). Must have
+     * minimal overhead - no serialization/deserialization.
+     *
+     * @param config - Partial configuration to merge with current context
+     */
+    updateContext(config: Partial<RenderContextConfig>): void;
+    /**
+     * Invalidate a specific layer.
+     *
+     * @param layer - Layer to invalidate
+     * @param regions - Optional specific regions to invalidate
+     */
+    invalidateLayer(layer: LayerName, regions?: CellRange[]): void;
+    /**
+     * Invalidate specific cells.
+     *
+     * @param cells - Cells to invalidate
+     * @param priority - Optional render priority (default: NORMAL)
+     */
+    invalidateCells(cells: CellCoord[], priority?: RenderPriority): void;
+    /**
+     * Invalidate all layers (full redraw).
+     */
+    invalidateAll(): void;
+    /**
+     * Get the coordinate system.
+     *
+     * Used by state for hit testing, scroll calculations, and
+     * determining visible cell ranges.
+     */
+    getCoordinateSystem(): CoordinateSystem;
+    /**
+     * Get the page-space bounding rectangle for a cell.
+     *
+     * Combines cellToViewport (canvas-relative coordinates accounting for scroll,
+     * zoom, frozen panes, headers) with the container's getBoundingClientRect
+     * (canvas-to-page) to produce absolute page coordinates.
+     *
+     * Use cases: Playwright clicks, tooltip positioning, overlay anchoring.
+     *
+     * @param row - 0-indexed row
+     * @param col - 0-indexed column
+     * @returns Page-space rect, or null if cell is not visible or renderer not ready
+     */
+    getCellPageBounds(row: number, col: number): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    /**
+     * Unified hit test — queries all layers (overlay, drawing, grid) via the
+     * engine's hit test pipeline. Returns the topmost hit as a typed UnifiedHitResult.
+     *
+     * Replaces the old pattern of coords.hitTestPoint() which used a dead HitMap.
+     * This method delegates to the engine pipeline where the drawing-canvas HitMap
+     * (spatial index + Path2D) is actually populated during render.
+     *
+     * @param x - X coordinate in viewport space (CSS pixels, canvas-relative)
+     * @param y - Y coordinate in viewport space (CSS pixels, canvas-relative)
+     * @returns UnifiedHitResult — floatingObject, cell, header, resize handle, etc.
+     */
+    hitTest(x: number, y: number): UnifiedHitResult;
+    /**
+     * Get floating object bounds synchronously from the scene graph.
+     *
+     * Returns document-space bounds (absolute pixel coordinates) read directly
+     * from the drawing layer's scene graph. This is the sync alternative to
+     * FloatingObjectManager.computeObjectBounds() which requires async IPC.
+     *
+     * Used by the coordination layer to initialize drag/resize/rotate operations
+     * without blocking on async IPC — the scene graph already has the bounds
+     * from the last render pass.
+     *
+     * @param objectId - The floating object ID
+     * @returns ObjectBounds (doc-space) or null if object not in scene graph
+     */
+    getObjectBoundsSync(objectId: string): ObjectBounds | null;
+    /**
+     * Contract-backed bounds reader for floating objects.
+     *
+     * Provides synchronous, O(1) reads of object pixel bounds from the scene graph.
+     * Prefer this over getObjectBoundsSync() — it exposes the full IObjectBoundsReader
+     * interface (getBounds, getGroupBounds, getBoundsMany) rather than a single method.
+     *
+     * Consumers should migrate to `gridRenderer.boundsReader.getBounds(id)` instead
+     * of `gridRenderer.getObjectBoundsSync(id)`.
+     */
+    readonly boundsReader: IObjectBoundsReader;
+    /**
+     * Update floating object bounds in the scene graph.
+     *
+     * Synchronously updates the scene graph entry for the given object with new
+     * bounds and rotation. This is the write counterpart to `boundsReader` (read path).
+     *
+     * Used during drag/resize/rotate operations to update the scene graph on every
+     * pointer event, making the scene graph the single authority for object position
+     * throughout the entire operation lifecycle.
+     *
+     * Marks both drawing layer (via scene graph onDirty) and overlay layer dirty
+     * so selection/resize/rotation handles follow the shape.
+     *
+     * No-op if objectId does not exist in the scene graph.
+     *
+     * @param objectId - The floating object ID
+     * @param bounds - New bounds and rotation
+     */
+    updateObjectBounds(objectId: string, bounds: ObjectBoundsUpdate): void;
+    /**
+     * Get renderer statistics.
+     *
+     * Used for performance monitoring and debugging.
+     */
+    getStats(): GridRendererStats;
+    /**
+     * Get current sheet ID.
+     */
+    getCurrentSheetId(): string;
+    /**
+     * Get clipped content for a cell.
+     *
+     * When cell content overflows and is clipped, this returns the full
+     * content string for tooltip display. Returns null if:
+     * - Cell is not currently rendered
+     * - Cell content is not clipped
+     * - Cell is empty
+     *
+     * @param row - Row index
+     * @param col - Column index
+     */
+    getClippedCellContent(row: number, col: number): string | null;
+    /**
+     * Set ink accessor for overlay layer preview rendering.
+     *
+     * This enables live stroke preview during ink/drawing mode.
+     * Call with accessor to enable, null to disable.
+     *
+     * @param accessor - Ink accessor or null to clear
+     */
+    setInkAccessor(accessor: InkAccessorForRendering | null): void;
+    /**
+     * Set SmartArt bridge for overlay layer diagram rendering.
+     *
+     * This MUST be called during coordinator initialization to enable
+     * SmartArt rendering. Without the bridge, SmartArt objects render
+     * as placeholders instead of actual diagrams.
+     *
+     * @see plans/active/excel-parity/smart-art/09-CANVAS-INTEGRATION.md
+     *
+     * @param bridge - SmartArt bridge or null to disable
+     */
+    setSmartArtBridge(bridge: ISmartArtBridge | null): void;
+    /**
+     * Set the astToLatex function for equation rendering.
+     *
+     * This MUST be called during coordinator initialization to enable
+     * equation rendering. Without this function, equations render as
+     * placeholders with "Loading..." text instead of actual math.
+     *
+     * @see plans/active/excel-parity/equation/04-RENDERING-ENGINE.md
+     *
+     * @param fn - The LaTeX rendering function (renders LaTeX string to canvas)
+     */
+    setAstToLatex(fn: RenderLatexFn): void;
+    /**
+     * Set WordArt rendering bridge for overlay layer text effects rendering.
+     *
+     * This MUST be called during coordinator initialization to enable
+     * WordArt rendering. Without the bridge, WordArt objects render
+     * as plain text boxes instead of styled, warped text.
+     *
+     * @see plans/active/excel-parity/word-art/07-CANVAS-INTEGRATION.md
+     *
+     * @param bridge - WordArt canvas rendering bridge or null to disable
+     */
+    setWordArtBridge(bridge: IWordArtCanvasBridge | null): void;
+    /**
+     * Get the interactive element collector.
+     *
+     * This collector gathers interactive element positions (filter buttons, checkboxes, etc.)
+     * during each render pass. React components can subscribe to the collector to render
+     * invisible DOM overlays at the correct positions for accessibility and popover triggers.
+     *
+     * @see plans/archive/canvas/CANVAS-INTERACTIVE-ELEMENT-LAYER.md
+     *
+     * @returns The interactive element collector instance
+     */
+    getInteractiveElementCollector(): InteractiveElementCollector;
+    /**
+     * Get the render scheduler for "Write = Invalidate" buffer integration.
+     *
+     * The scheduler bridges viewport buffer mutations to canvas layer invalidation.
+     * When the kernel writes cell data into buffers, the buffer calls scheduler
+     * methods to mark affected layers dirty and wake the render loop.
+     */
+    getRenderScheduler(): RenderScheduler;
+}
+/**
+ * Configuration for creating a GridRenderer instance.
+ */
+export interface GridRendererConfig {
+    /** Container element — CanvasHost creates stacked canvases internally */
+    container: HTMLElement;
+    /** Initial sheet ID */
+    initialSheetId: string;
+    /** Total rows */
+    totalRows?: number;
+    /** Total columns */
+    totalCols?: number;
+    /** Initial render context config (for state data) */
+    contextConfig?: Partial<RenderContextConfig>;
+    /** Viewport position index for O(1) row/col position lookups */
+    positionIndex?: ViewportPositionIndexLike;
+    /** Viewport merge index for O(1) merged-region lookups */
+    mergeIndex?: ViewportMergeIndexLike;
+}
+/**
+ * Factory function to create a GridRenderer instance.
+ */
+export type RendererFactory = (config: GridRendererConfig) => GridRenderer;
+//# sourceMappingURL=grid-renderer.d.ts.map

package/dist/rendering/grid-renderer.d.ts.map

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

package/dist/rendering/grouping.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Grouping Data Types
+ *
+ * Types for row/column grouping (outlines) used by hit testing and rendering.
+ *
+ * @module @mog/spreadsheet-contracts/rendering/grouping
+ */
+import type { GroupDefinition, SheetGroupingConfig } from '../data/grouping';
+/**
+ * Grouping data for outline hit testing.
+ * This interface is used by the HitTestService to perform hit tests
+ * without requiring a full RenderContext.
+ */
+export interface GroupingData {
+    config: SheetGroupingConfig | null;
+    rowGroups: GroupDefinition[];
+    columnGroups: GroupDefinition[];
+    maxRowLevel: number;
+    maxColLevel: number;
+}
+//# sourceMappingURL=grouping.d.ts.map

package/dist/rendering/grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouping.d.ts","sourceRoot":"","sources":["../../src/rendering/grouping.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE7E;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/rendering/hit-test-service.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Hit Test Service Interface
+ *
+ * Service interface for hit testing outline buttons (row/column grouping controls).
+ *
+ * NOTE: This is a stateless rendering service, NOT a Bridge.
+ * Unlike Calculator/Pivot bridges which listen to EventBus triggers and cache
+ * computations, HitTestService is synchronous with no lifecycle management needed.
+ *
+ * @module @mog/spreadsheet-contracts/rendering/hit-test-service
+ */
+/**
+ * Result of an outline hit test.
+ *
+ * Returned when testing if a point hits an outline button:
+ * - Level buttons (1, 2, 3, ...) for expanding/collapsing to a specific level
+ * - Collapse buttons (+/-) for individual groups
+ */
+export interface OutlineHitTestResult {
+    /** Type of button hit */
+    type: 'level-button' | 'collapse-button' | 'none';
+    /** Whether it's a row or column outline */
+    axis: 'row' | 'column';
+    /** For level-button: the level clicked (1-8). For collapse-button: undefined */
+    level?: number;
+    /** For collapse-button: the group ID */
+    groupId?: string;
+    /** For collapse-button: current collapsed state */
+    collapsed?: boolean;
+}
+/**
+ * Service interface for hit testing outline (row/column grouping) buttons.
+ *
+ * This interface enables decoupling of the state coordinator from canvas
+ * implementation details. The coordinator receives an injected service
+ * rather than importing the hit test function directly from canvas.
+ *
+ * Architecture:
+ * - State coordinator owns the ObjectCoordination module
+ * - ObjectCoordination needs to hit test outline buttons
+ * - Canvas provides the implementation via OutlineHitTester class
+ * - Coordinator wires the implementation at construction time
+ */
+export interface HitTestService {
+    /**
+     * Hit test against outline buttons (row/column grouping controls).
+     *
+     * Tests if a viewport coordinate hits any outline button:
+     * - Level buttons in the corner gutter area
+     * - Collapse/expand (+/-) buttons on group summary rows/columns
+     *
+     * @param x - X coordinate in viewport pixels
+     * @param y - Y coordinate in viewport pixels
+     * @returns Information about which button was clicked, or result with type='none' if no hit
+     */
+    hitTestOutline(x: number, y: number): OutlineHitTestResult | null;
+}
+//# sourceMappingURL=hit-test-service.d.ts.map

package/dist/rendering/hit-test-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-test-service.d.ts","sourceRoot":"","sources":["../../src/rendering/hit-test-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,MAAM,CAAC;IAClD,2CAA2C;IAC3C,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;OAUG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAAC;CACnE"}