@mog-sdk/spreadsheet-contracts 0.1.12

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

@@ -0,0 +1,223 @@
+/**
+ * Hit Test and Physics Types for Canvas Rendering
+ *
+ * These types define hit testing results and scroll/zoom physics state.
+ * Moved to contracts to enable decoupling of canvas and state subsystems.
+ *
+ * @module @mog/spreadsheet-contracts/rendering/hit-test
+ */
+/** Cell hit result */
+export interface CellHitResult {
+    type: 'cell';
+    row: number;
+    col: number;
+}
+/** Column header hit result */
+export interface ColumnHeaderHitResult {
+    type: 'columnHeader';
+    col: number;
+}
+/** Row header hit result */
+export interface RowHeaderHitResult {
+    type: 'rowHeader';
+    row: number;
+}
+/** Column resize handle hit result */
+export interface ColumnResizeHitResult {
+    type: 'columnResize';
+    col: number;
+}
+/** Row resize handle hit result */
+export interface RowResizeHitResult {
+    type: 'rowResize';
+    row: number;
+}
+/** Fill handle hit result */
+export interface FillHandleHitResult {
+    type: 'fillHandle';
+}
+/** Frozen pane intersection hit result */
+export interface FrozenHitResult {
+    type: 'frozen';
+    region: 'topLeft' | 'top' | 'left';
+}
+/** Select all button hit result (corner cell) */
+export interface SelectAllHitResult {
+    type: 'selectAll';
+}
+/** Empty space hit result */
+export interface EmptyHitResult {
+    type: 'empty';
+}
+/** Outline level button hit result */
+export interface OutlineLevelButtonHitResult {
+    type: 'outlineLevelButton';
+    axis: 'row' | 'column';
+    level: number;
+}
+/** Outline collapse button hit result */
+export interface OutlineCollapseButtonHitResult {
+    type: 'outlineCollapseButton';
+    axis: 'row' | 'column';
+    groupId: string;
+    collapsed: boolean;
+}
+/** Outline gutter area hit result */
+export interface OutlineGutterHitResult {
+    type: 'outlineGutter';
+    orientation: 'row' | 'column';
+}
+/** Hidden column boundary hit result */
+export interface HiddenColumnBoundaryHitResult {
+    type: 'hiddenColumnBoundary';
+    col: number;
+    hiddenStart: number;
+    hiddenEnd: number;
+}
+/** Hidden row boundary hit result */
+export interface HiddenRowBoundaryHitResult {
+    type: 'hiddenRowBoundary';
+    row: number;
+    hiddenStart: number;
+    hiddenEnd: number;
+}
+/** Comment indicator hit result */
+export interface CommentIndicatorHitResult {
+    type: 'commentIndicator';
+    row: number;
+    col: number;
+}
+/** Hit region types for floating objects */
+export type ObjectHitRegion = 'body' | 'border' | 'rotation' | 'resize-nw' | 'resize-n' | 'resize-ne' | 'resize-e' | 'resize-se' | 'resize-s' | 'resize-sw' | 'resize-w' | 'warp-adjust';
+/** Floating object hit result */
+export interface FloatingObjectHitResult {
+    type: 'floatingObject';
+    objectId: string;
+    region: ObjectHitRegion;
+    isGroup: boolean;
+}
+/**
+ * Result of hit testing a point against the spreadsheet grid.
+ * Used to determine what UI element is at a given viewport coordinate.
+ */
+export type HitTestResult = CellHitResult | ColumnHeaderHitResult | RowHeaderHitResult | ColumnResizeHitResult | RowResizeHitResult | FillHandleHitResult | FrozenHitResult | SelectAllHitResult | EmptyHitResult | OutlineLevelButtonHitResult | OutlineCollapseButtonHitResult | OutlineGutterHitResult | HiddenColumnBoundaryHitResult | HiddenRowBoundaryHitResult | CommentIndicatorHitResult | FloatingObjectHitResult;
+/**
+ * Unified hit test result - either a cell, header, or floating object.
+ * This is the primary type that should be used for hit testing.
+ */
+export type UnifiedHitResult = HitTestResult;
+/**
+ * Current scroll state including animation properties.
+ */
+export interface ScrollState {
+    x: number;
+    y: number;
+    velocityX: number;
+    velocityY: number;
+    isAnimating: boolean;
+}
+/**
+ * Configuration for scroll physics (momentum, deceleration).
+ */
+export interface ScrollPhysicsConfig {
+    /** Time constant in ms (325 = iOS-like deceleration) */
+    decelerationRate: number;
+    /** Stop threshold in px/s */
+    minVelocity: number;
+    /** Clamp maximum velocity in px/s */
+    maxVelocity: number;
+}
+/**
+ * Current zoom state including animation properties.
+ */
+export interface ZoomState {
+    level: number;
+    centerX: number;
+    centerY: number;
+    isAnimating: boolean;
+}
+/**
+ * Configuration for zoom physics.
+ */
+export interface ZoomPhysicsConfig {
+    /** Minimum zoom level (e.g., 0.1) */
+    minZoom: number;
+    /** Maximum zoom level (e.g., 4.0) */
+    maxZoom: number;
+    /** Duration for animated zoom in ms */
+    animationDuration: number;
+}
+import type { CellRange } from '../core';
+import type { CellCoord } from './primitives';
+/**
+ * Remote user's cursor/selection state (from Yjs awareness).
+ * Used for rendering other users' selections in collaborative editing.
+ */
+export interface RemoteCursor {
+    clientId: number;
+    user: {
+        id: string;
+        name: string;
+        color: string;
+        avatar?: string;
+    };
+    selection: CellRange[];
+    activeCell: CellCoord;
+    sheetId: string;
+    isEditing: boolean;
+    editingCell?: CellCoord;
+}
+/**
+ * Object bounds in pixel coordinates.
+ * Used for rendering floating objects on the overlay layer.
+ */
+export interface ObjectBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+}
+/**
+ * Effective visual state for a floating object during operations.
+ *
+ * During drag/resize/rotate operations, this represents the visual position
+ * (calculated from original position + delta), not the persisted position.
+ * The renderer should use this for display instead of reading persisted state.
+ *
+ * Three-layer model:
+ * - Layer 3 (Local): Current user's in-progress operation (0ms latency)
+ * - Layer 2 (Remote): Other users' operations via presence (~100ms latency)
+ * - Layer 1 (Base): Persisted state in Yjs (source of truth)
+ *
+ * @see plans/active/refactor/unified-floating-object-operations.md
+ */
+export interface EffectiveObjectState {
+    /** Whether this state differs from persisted state */
+    isEffective: boolean;
+    /** Source of the effective state */
+    source: 'local' | 'remote' | 'persisted';
+    /** The effective bounds (visual position during operations) */
+    bounds: ObjectBounds;
+    /** The effective rotation in degrees */
+    rotation: number;
+}
+import type { CellFormat } from '../core';
+/**
+ * Preview data for a single cell.
+ * Contains the value and format that would be applied by a paste operation.
+ * Used for rendering paste preview overlays.
+ */
+export interface PreviewCellData {
+    /** Row position (absolute, not relative) */
+    row: number;
+    /** Column position (absolute, not relative) */
+    col: number;
+    /** The value that would be pasted (formatted for display) */
+    displayValue: string;
+    /** The format that would be applied */
+    format?: Partial<CellFormat>;
+    /** Whether this cell would have a formula */
+    hasFormula?: boolean;
+}
+//# sourceMappingURL=hit-test.d.ts.map

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

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

package/dist/rendering/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Rendering Types and Constants
+ *
+ * Shared types for canvas rendering used by both canvas and state subsystems.
+ * This module provides the contracts that enable decoupling of the rendering layer.
+ *
+ * @module @mog/spreadsheet-contracts/rendering
+ */
+export type { CellCoord, CoordinateSystem, DocumentPoint, DocumentRect, FrozenPanes, LayerPoint, LayerRect, MergeRegionLike, ScrollViewport, ViewportMergeIndexLike, ViewportPoint, ViewportPositionIndexLike, ViewportRect, VisibleRegions, } from './coordinates';
+export type { CellHitResult, ColumnHeaderHitResult, ColumnResizeHitResult, CommentIndicatorHitResult, EffectiveObjectState, EmptyHitResult, FillHandleHitResult, FloatingObjectHitResult, FrozenHitResult, HiddenColumnBoundaryHitResult, HiddenRowBoundaryHitResult, HitTestResult, ObjectBounds, ObjectHitRegion, OutlineCollapseButtonHitResult, OutlineLevelButtonHitResult, PreviewCellData, RemoteCursor, RowHeaderHitResult, RowResizeHitResult, ScrollPhysicsConfig, ScrollState, SelectAllHitResult, UnifiedHitResult, ZoomPhysicsConfig, ZoomState, } from './hit-test';
+export type { HitTestService, OutlineHitTestResult } from './hit-test-service';
+export type { SheetBounds, TextMeasurementContext, TextMeasurementService, TextPosition, TextPositionInput, } from './text-measurement-service';
+export type { GridRenderer, GridRendererConfig, GridRendererStats, LayerName, ObjectBoundsUpdate, RenderScheduler, RendererFactory, } from './grid-renderer';
+export { RenderPriority } from './grid-renderer';
+export type { FloatingObjectPatch, FloatingObjectRenderState, PageBreakDragState, PageBreakInfo, PageBreakOrientation, PageBreakType, RenderContextConfig, SelectionErrorType, SelectionRenderState, } from './render-context';
+export type { GroupingData } from './grouping';
+export { BUFFER_COLS, BUFFER_ROWS, COL_HEADER_HEIGHT, DEFAULT_COL_WIDTH, DEFAULT_ROW_HEIGHT, DEFAULT_ZOOM, MAX_OUTLINE_LEVELS, MAX_ZOOM, MIN_COL_WIDTH, MIN_ROW_HEIGHT, MIN_ZOOM, MOUSE_HIT_AREA_SIZE, OUTLINE_BUTTON_SIZE, OUTLINE_LEVEL_HEIGHT, OUTLINE_LEVEL_WIDTH, ROW_HEADER_WIDTH, SCROLL_BAR_WIDTH, TOUCH_HIT_AREA_SIZE, ZOOM_PRESETS, ZOOM_STEP, } from './constants';
+export type { HeaderVisibility } from './constants';
+export type { CheckboxMetadata, CommentIndicatorMetadata, FilterButtonMetadata, InteractiveElement, InteractiveElementBounds, InteractiveElementCollector, InteractiveElementMetadata, InteractiveElementType, ValidationDropdownMetadata, } from './interactive-elements';
+export type { FloatingObjectCoordinator, PointerCaptureManager, RendererDependencies, SheetStateProvider, } from './coordinator-interfaces';
+export type { CellBindingStatus, CellDataSource, ChartRenderBridge, ChromeTheme, CollaborationDataSource, DataBarData, DragDropState, FloatingObjectDataSource, GroupingDataSource, IconData, OverlayDataSource, PageBreakDataSource, PageBreakEntry, PageBreaks, PastePreviewData, PrintArea, SelectionDataSource, SheetDataSource, TraceDataSource, } from './data-sources';
+export { DEFAULT_CHROME_THEME } from './data-sources';
+export type { GridRegionMeta } from './grid-region';
+export type { IWordArtCanvasBridge, RenderBounds, RenderLatexFn } from './canvas-bridge-types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rendering/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,yBAAyB,EACzB,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,6BAA6B,EAC7B,0BAA0B,EAC1B,aAAa,EACb,YAAY,EACZ,eAAe,EACf,8BAA8B,EAC9B,2BAA2B,EAC3B,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,YAAY,EACV,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,YAAY,EACV,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/rendering/interactive-elements.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Interactive Element Types
+ *
+ * Types for canvas-rendered interactive elements that need DOM overlays.
+ * These elements are painted on canvas but require real DOM elements for:
+ * - Radix UI integration (Popover, Select, etc.)
+ * - Accessibility (screen readers, keyboard navigation)
+ * - Focus management
+ *
+ * @module @mog/spreadsheet-contracts/rendering/interactive-elements
+ */
+/**
+ * Types of interactive elements rendered on canvas that need DOM overlays.
+ */
+export type InteractiveElementType = 'filter-button' | 'checkbox' | 'comment-indicator' | 'validation-dropdown' | 'sparkline-edit' | 'hyperlink';
+/**
+ * Position and bounds of an interactive element in viewport coordinates.
+ */
+export interface InteractiveElementBounds {
+    /** X position relative to grid viewport (not including headers) */
+    x: number;
+    /** Y position relative to grid viewport */
+    y: number;
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+}
+/**
+ * Metadata for filter button elements.
+ */
+export interface FilterButtonMetadata {
+    type: 'filter-button';
+    /** Filter ID (AutoFilter or Table filter) */
+    filterId: string;
+    /** Header cell ID for this column */
+    headerCellId: string;
+    /** Whether this column has active filter criteria */
+    hasActiveFilter: boolean;
+}
+/**
+ * Metadata for checkbox elements.
+ */
+export interface CheckboxMetadata {
+    type: 'checkbox';
+    /** Cell ID */
+    cellId: string;
+    /** Sheet ID */
+    sheetId: string;
+    /** Current checked state */
+    checked: boolean;
+    /** Row position */
+    row: number;
+    /** Column position */
+    col: number;
+}
+/**
+ * Metadata for comment indicator elements.
+ */
+export interface CommentIndicatorMetadata {
+    type: 'comment-indicator';
+    /** Cell ID that has the comment */
+    cellId: string;
+    /** Sheet ID */
+    sheetId: string;
+    /** Row position */
+    row: number;
+    /** Column position */
+    col: number;
+}
+/**
+ * Metadata for validation dropdown elements.
+ */
+export interface ValidationDropdownMetadata {
+    type: 'validation-dropdown';
+    /** Cell ID */
+    cellId: string;
+    /** Sheet ID */
+    sheetId: string;
+    /** Row position */
+    row: number;
+    /** Column position */
+    col: number;
+    /** Validation options */
+    options: string[];
+}
+/**
+ * Union of all metadata types.
+ */
+export type InteractiveElementMetadata = FilterButtonMetadata | CheckboxMetadata | CommentIndicatorMetadata | ValidationDropdownMetadata;
+/**
+ * Complete interactive element with position and metadata.
+ */
+export interface InteractiveElement {
+    /** Unique identifier for this element instance */
+    id: string;
+    /** Element type */
+    type: InteractiveElementType;
+    /** Position and size in viewport coordinates */
+    bounds: InteractiveElementBounds;
+    /** Type-specific metadata */
+    metadata: InteractiveElementMetadata;
+}
+/**
+ * Collector interface for render context to emit interactive elements.
+ *
+ * The collector is cleared at the start of each render frame, and elements
+ * are added during the render pass. Subscribers are notified once per frame
+ * with the complete set of visible interactive elements.
+ */
+export interface InteractiveElementCollector {
+    /** Clear all elements (called at start of render frame) */
+    clear(): void;
+    /** Add an interactive element */
+    add(element: InteractiveElement): void;
+    /** Get all collected elements */
+    getAll(): InteractiveElement[];
+    /** Subscribe to element updates */
+    subscribe(callback: (elements: InteractiveElement[]) => void): () => void;
+}
+//# sourceMappingURL=interactive-elements.d.ts.map

package/dist/rendering/interactive-elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-elements.d.ts","sourceRoot":"","sources":["../../src/rendering/interactive-elements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,eAAe,GACf,UAAU,GACV,mBAAmB,GACnB,qBAAqB,GACrB,gBAAgB,GAChB,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,eAAe,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAClC,oBAAoB,GACpB,gBAAgB,GAChB,wBAAwB,GACxB,0BAA0B,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,gDAAgD;IAChD,MAAM,EAAE,wBAAwB,CAAC;IACjC,6BAA6B;IAC7B,QAAQ,EAAE,0BAA0B,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,2DAA2D;IAC3D,KAAK,IAAI,IAAI,CAAC;IACd,iCAAiC;IACjC,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,iCAAiC;IACjC,MAAM,IAAI,kBAAkB,EAAE,CAAC;IAC/B,mCAAmC;IACnC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3E"}

package/dist/rendering/primitives.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Rendering Primitive Types
+ *
+ * Fundamental types used throughout the rendering system.
+ * Extracted to break circular dependencies.
+ *
+ * @module @mog/spreadsheet-contracts/rendering/primitives
+ */
+/**
+ * Simple cell coordinate (row, col).
+ * Used for: single cell positions, active cell, anchor points, invalidation, etc.
+ */
+export interface CellCoord {
+    row: number;
+    col: number;
+}
+//# sourceMappingURL=primitives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/rendering/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb"}