@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/rendering/data-sources.d.ts

@@ -0,0 +1,372 @@
+/**
+ * Canvas Data Source Interfaces
+ *
+ * Typed data source interfaces that decompose the monolithic RenderContextConfig
+ * into focused data contracts. Each grid-renderer layer declares which data sources
+ * it requires via its constructor, replacing the 80+ field god-object.
+ *
+ * @module @mog/spreadsheet-contracts/rendering/data-sources
+ */
+import type { CellFormat, CellRange } from '../core';
+import type { CultureInfo } from '../culture/types';
+import type { FilterHeaderInfo } from '../data/filter';
+import type { GroupDefinition, OutlineLevel, SheetGroupingConfig } from '../data/grouping';
+import type { SparklineRenderData } from '../data/sparklines';
+import type { TableConfig } from '../data/tables';
+import type { TraceArrow } from '../data/trace-arrows';
+import type { SearchHighlight } from '../document/search';
+import type { ThemeDefinition } from '../formatting/theme';
+import type { ClipboardSnapshot, EditorSnapshot } from '../machines';
+import type { FloatingObject } from '../objects/floating-objects';
+import type { ObjectBounds, PreviewCellData, RemoteCursor } from './hit-test';
+import type { CellCoord } from './primitives';
+import type { FloatingObjectRenderState, PageBreakDragState, SelectionRenderState } from './render-context';
+/**
+ * Theme colors for the spreadsheet chrome — the UI shell surrounding cell content.
+ *
+ * Controls canvas background, gridlines, headers, selection indicators,
+ * scrollbars, and drag-drop overlays. Cell content colors are governed by
+ * ThemeDefinition / conditional formatting, not this interface.
+ */
+export interface ChromeTheme {
+    canvasBackground: string;
+    gridlineColor: string;
+    headerBackground: string;
+    headerText: string;
+    headerBorder: string;
+    headerHighlightBackground: string;
+    headerHighlightText: string;
+    selectionFill: string;
+    selectionBorder: string;
+    activeCellBorder: string;
+    fillHandleColor: string;
+    dragSourceColor: string;
+    dragTargetColor: string;
+    scrollbarTrack: string;
+    scrollbarThumb: string;
+}
+/**
+ * Default chrome theme — the single source of truth for all canvas chrome colors.
+ * Layers read colors from `sheetData.chromeTheme` at render time; this object
+ * provides the initial/fallback values.
+ */
+export declare const DEFAULT_CHROME_THEME: ChromeTheme;
+/**
+ * Binding status for a cell connected to an external data source.
+ */
+export interface CellBindingStatus {
+    readonly connectionId: string;
+    readonly staleness: 'fresh' | 'stale' | 'error';
+}
+/**
+ * Data bar rendering data produced by conditional formatting evaluation.
+ */
+export interface DataBarData {
+    fillPercent: number;
+    color: string;
+    isNegative: boolean;
+    gradient: boolean;
+    showValue: boolean;
+    showAxis: boolean;
+    axisPosition: number;
+    negativeColor: string;
+}
+/**
+ * Icon set rendering data produced by conditional formatting evaluation.
+ */
+export interface IconData {
+    setName: string;
+    iconIndex: number;
+    iconOnly: boolean;
+}
+/**
+ * Data source for cell content and metadata.
+ *
+ * Per-cell rendering data (formatted values, CF overrides, data bars, icons,
+ * hyperlinks, formulas, checkboxes, comments, projections) is now read from
+ * the binary viewport buffer (BinaryCellReader) — not from this interface.
+ *
+ * This interface retains only methods that are called per-cell by layers that
+ * haven't migrated to the buffer yet, plus sheet-level properties.
+ */
+export interface CellDataSource {
+    getCellValue(sheetId: string, cell: CellCoord): unknown;
+    getCellFormat(sheetId: string, cell: CellCoord): CellFormat | undefined;
+    getCellBindingStatus(sheetId: string, cell: CellCoord): CellBindingStatus | undefined;
+    getSparklineRenderData(sheetId: string, cell: CellCoord): SparklineRenderData | undefined;
+    getTableAtCell(sheetId: string, cell: CellCoord): TableConfig | undefined;
+    hasTableColumnFilter(sheetId: string, tableId: string, headerRow: number, headerCol: number): boolean;
+    getFilterHeaderInfo(sheetId: string, cell: CellCoord): FilterHeaderInfo | undefined;
+    hasValidationErrors(sheetId: string, cell: CellCoord): boolean;
+    showZeroValues: boolean;
+    /** Set of cells with dropdown indicators (key format: "row,col") */
+    dropdownCells: ReadonlySet<string>;
+}
+/**
+ * Paste preview data for rendering semi-transparent preview.
+ */
+export interface PastePreviewData {
+    readonly isActive: boolean;
+    readonly targetRange: CellRange;
+    readonly cells: ReadonlyArray<PreviewCellData>;
+}
+/**
+ * Drag-drop state for cell range drag operations.
+ */
+export interface DragDropState {
+    readonly isDragging: boolean;
+    readonly sourceRange: CellRange | null;
+    readonly targetRange: CellRange | null;
+}
+/**
+ * Data source for selection, editing, clipboard, and search state.
+ */
+export interface SelectionDataSource {
+    getSelectionState(): SelectionRenderState;
+    getEditorState(): EditorSnapshot;
+    getClipboardState(): ClipboardSnapshot;
+    getSearchHighlights(): ReadonlyArray<SearchHighlight>;
+    getPastePreview(): PastePreviewData | null;
+    getDragDropState(): DragDropState | null;
+    getTablePreviewRange(): CellRange | null;
+    /** Whether the selection has an error (e.g., invalid merge target) */
+    hasError(): boolean;
+}
+/**
+ * Data source for sheet-level settings and view options.
+ */
+export interface SheetDataSource {
+    readonly sheetId: string;
+    readonly totalRows: number;
+    readonly totalCols: number;
+    readonly showGridlines: boolean;
+    readonly gridlineColor: string;
+    readonly theme: ThemeDefinition;
+    readonly culture: CultureInfo;
+    readonly rightToLeft: boolean;
+    /** Whether to display formulas instead of values (View > Show Formulas) */
+    readonly showFormulas: boolean;
+    /** Whether to show row headers (1, 2, 3...) */
+    readonly showRowHeaders: boolean;
+    /** Whether to show column headers (A, B, C...) */
+    readonly showColumnHeaders: boolean;
+    /** Whether to show cut/copy indicator (marching ants) */
+    readonly showCutCopyIndicator: boolean;
+    /** Whether fill handle dragging is enabled */
+    readonly allowDragFill: boolean;
+    /** Whether validation circles are visible around invalid cells */
+    readonly validationCirclesVisible: boolean;
+    /** Preview font applied to selected cells during font picker hover */
+    readonly previewFont: string | null;
+    /** Blocked edit attempt state for red flash visual feedback */
+    readonly blockedEditAttempt: {
+        cellId: string;
+        timestamp: number;
+    } | null;
+    /** Chrome theme controlling canvas background, headers, selection, scrollbars */
+    readonly chromeTheme: ChromeTheme;
+}
+/**
+ * Data source for remote collaborator cursors.
+ */
+export interface CollaborationDataSource {
+    getRemoteCursors(): ReadonlyArray<RemoteCursor>;
+}
+/**
+ * Data source for formula auditing trace arrows.
+ */
+export interface TraceDataSource {
+    getTraceArrows(): ReadonlyArray<TraceArrow>;
+    getCellPositionForTrace(cellId: string): {
+        row: number;
+        col: number;
+        sheet: string;
+    } | null;
+}
+/**
+ * Data source for floating objects (unified with charts).
+ * Charts are floating objects in the scene graph, enabling correct z-interleaving.
+ */
+export interface FloatingObjectDataSource {
+    getFloatingObjects(): ReadonlyArray<FloatingObject>;
+    getFloatingObjectBounds(objectId: string): Promise<ObjectBounds | null> | ObjectBounds | null;
+    /** Batch-fetch bounds for all objects on the current sheet (single IPC call). */
+    getAllObjectBounds?(): Promise<Map<string, ObjectBounds>> | Map<string, ObjectBounds>;
+    getFloatingObjectState(): FloatingObjectRenderState;
+    /** Get charts visible in the current viewport (unified with floating objects) */
+    getChartsInViewport(): ReadonlyArray<{
+        id: string;
+        type: string;
+        [key: string]: unknown;
+    }>;
+    /** Get resolved chart position from CellId-based anchor */
+    getChartPosition(sheetId: string, chart: {
+        id: string;
+        [key: string]: unknown;
+    }): {
+        anchorRow: number;
+        anchorCol: number;
+        width: number;
+        height: number;
+    } | null;
+}
+/**
+ * Data source for row/column grouping (outline) information.
+ */
+export interface GroupingDataSource {
+    getGroupingConfig(): SheetGroupingConfig | null;
+    getRowGroups(): ReadonlyArray<GroupDefinition>;
+    getColumnGroups(): ReadonlyArray<GroupDefinition>;
+    getRowOutlineLevels(startRow: number, endRow: number): ReadonlyArray<OutlineLevel>;
+    getColumnOutlineLevels(startCol: number, endCol: number): ReadonlyArray<OutlineLevel>;
+    readonly maxRowOutlineLevel: number;
+    readonly maxColOutlineLevel: number;
+}
+/**
+ * A single page break entry with full metadata.
+ */
+export interface PageBreakEntry {
+    readonly id: number;
+    readonly min: number;
+    readonly max: number;
+    readonly manual: boolean;
+    readonly pt: boolean;
+}
+/**
+ * Page break information for manual and automatic breaks.
+ */
+export interface PageBreaks {
+    readonly rowBreaks: ReadonlyArray<PageBreakEntry>;
+    readonly colBreaks: ReadonlyArray<PageBreakEntry>;
+}
+/**
+ * Print area bounds.
+ */
+export interface PrintArea {
+    readonly startRow: number;
+    readonly startCol: number;
+    readonly endRow: number;
+    readonly endCol: number;
+}
+/**
+ * Data source for page break preview rendering.
+ */
+export interface PageBreakDataSource {
+    readonly pageBreakPreviewMode: boolean;
+    getPageBreaks(): PageBreaks;
+    getAutoPageBreaks(): PageBreaks;
+    getPrintArea(): PrintArea | null;
+    getPageBreakDragState(): PageBreakDragState | null;
+}
+/**
+ * Bridge for rendering charts to canvas.
+ *
+ * NOTE: This is a rendering bridge (side-effecting), NOT a data source.
+ * Named explicitly to distinguish from read-only data sources.
+ * The bridge draws the chart content into the provided canvas context.
+ */
+export interface ChartRenderBridge {
+    renderChart(chartId: string, ctx: CanvasRenderingContext2D, bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): void;
+}
+/**
+ * Data source for the screen-space overlay (canvas 1).
+ *
+ * Returns screen-space bounds (after camera/zoom transform) so that
+ * handles render at consistent CSS-pixel sizes regardless of zoom level.
+ */
+export interface OverlayDataSource {
+    /** Get the bounding box of all selected objects (screen-space) */
+    getSelectedObjectBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    /** Get IDs of all currently selected objects */
+    getSelectedObjectIds(): ReadonlyArray<string>;
+    /** Get bounds of a specific object (screen-space) */
+    getObjectBounds(id: string): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    /** Check if an object is locked (locked objects don't show resize/rotation handles) */
+    isObjectLocked(id: string): boolean;
+    /** Get rotation angle of an object in degrees */
+    getObjectRotation(id: string): number;
+    /** Get the currently active handle (if any) */
+    getActiveHandle(): string | null;
+    /** Get smart guide lines for alignment during drag/resize */
+    getGuides(): ReadonlyArray<{
+        readonly axis: 'horizontal' | 'vertical';
+        readonly position: number;
+        readonly start: number;
+        readonly end: number;
+    }>;
+    /** Get rubber band selection rectangle (null if not active) */
+    getRubberBand(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    /** Get drag preview state */
+    getDragPreview(): {
+        readonly objectIds: ReadonlyArray<string>;
+        readonly deltaX: number;
+        readonly deltaY: number;
+    } | null;
+    /** Get ink preview state (active strokes during drawing) */
+    getInkPreview(): {
+        readonly strokes: ReadonlyArray<{
+            readonly points: ReadonlyArray<{
+                x: number;
+                y: number;
+                pressure?: number;
+            }>;
+            readonly color: string;
+            readonly width: number;
+        }>;
+        readonly eraserPosition: {
+            x: number;
+            y: number;
+            radius: number;
+        } | null;
+        readonly lassoPath: ReadonlyArray<{
+            x: number;
+            y: number;
+        }> | null;
+    } | null;
+    /** Get insertion preview rectangle during drag-to-insert shape mode (null if not active) */
+    getInsertionPreview(): {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    } | null;
+    /**
+     * Get connection point indicators for the shape nearest to the cursor
+     * during connector-dragging mode.
+     *
+     * Returns all connection points for the target shape (as screen-space
+     * positions) plus the snap target (the nearest point within snap radius),
+     * or null if not in connector-dragging mode or no shape is nearby.
+     */
+    getConnectionPointIndicators(): {
+        readonly points: ReadonlyArray<{
+            readonly x: number;
+            readonly y: number;
+        }>;
+        readonly snapTarget: {
+            readonly x: number;
+            readonly y: number;
+        } | null;
+    } | null;
+}
+//# sourceMappingURL=data-sources.d.ts.map

package/dist/rendering/data-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-sources.d.ts","sourceRoot":"","sources":["../../src/rendering/data-sources.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EACV,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAM1B;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB,EAAE,MAAM,CAAC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAgBlC,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IACxD,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACxE,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACtF,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC1F,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1E,oBAAoB,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IACX,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACpF,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC/D,cAAc,EAAE,OAAO,CAAC;IACxB,oEAAoE;IACpE,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,IAAI,oBAAoB,CAAC;IAC1C,cAAc,IAAI,cAAc,CAAC;IACjC,iBAAiB,IAAI,iBAAiB,CAAC;IACvC,mBAAmB,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IACtD,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAAC;IAC3C,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAAC;IACzC,oBAAoB,IAAI,SAAS,GAAG,IAAI,CAAC;IACzC,sEAAsE;IACtE,QAAQ,IAAI,OAAO,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,yDAAyD;IACzD,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,kEAAkE;IAClE,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,kBAAkB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAMD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;CACjD;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;IAC5C,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7F;AAMD;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,IAAI,aAAa,CAAC,cAAc,CAAC,CAAC;IACpD,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;IAC9F,iFAAiF;IACjF,kBAAkB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtF,sBAAsB,IAAI,yBAAyB,CAAC;IACpD,iFAAiF;IACjF,mBAAmB,IAAI,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3F,2DAA2D;IAC3D,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAC5C;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnF;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,IAAI,mBAAmB,GAAG,IAAI,CAAC;IAChD,YAAY,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/C,eAAe,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IAClD,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IACnF,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IACtF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,aAAa,IAAI,UAAU,CAAC;IAC5B,iBAAiB,IAAI,UAAU,CAAC;IAChC,YAAY,IAAI,SAAS,GAAG,IAAI,CAAC;IACjC,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAAC;CACpD;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CACT,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,wBAAwB,EAC7B,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC9D,IAAI,CAAC;CACT;AAMD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,uBAAuB,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1F,gDAAgD;IAChD,oBAAoB,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,qDAAqD;IACrD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5F,uFAAuF;IACvF,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,+CAA+C;IAC/C,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IACjC,6DAA6D;IAC7D,SAAS,IAAI,aAAa,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;QACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,+DAA+D;IAC/D,aAAa,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChF,6BAA6B;IAC7B,cAAc,IAAI;QAChB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;IACT,4DAA4D;IAC5D,aAAa,IAAI;QACf,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;YAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAAE,CAAC,EAAE,MAAM,CAAC;gBAAC,CAAC,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;SACxB,CAAC,CAAC;QACH,QAAQ,CAAC,cAAc,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QACzE,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG,IAAI,CAAC;KACpE,GAAG,IAAI,CAAC;IACT,4FAA4F;IAC5F,mBAAmB,IAAI;QACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;IACT;;;;;;;OAOG;IACH,4BAA4B,IAAI;QAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;YAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC3E,QAAQ,CAAC,UAAU,EAAE;YAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;KACxE,GAAG,IAAI,CAAC;CACV"}

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

@@ -0,0 +1,32 @@
+/**
+ * Grid Region Types
+ *
+ * Spreadsheet-specific metadata for canvas-engine's generic RenderRegion<TMeta>.
+ * These types are the TMeta that grid-renderer uses when creating render regions
+ * from freeze pane configuration.
+ *
+ * @module @mog/spreadsheet-contracts/rendering/grid-region
+ */
+import type { CellRange } from '../core';
+/**
+ * Metadata for a grid render region.
+ * This is the TMeta used by grid-renderer with RenderRegion<GridRegionMeta>.
+ */
+export interface GridRegionMeta {
+    /** Sheet ID this region renders */
+    readonly sheetId: string;
+    /** Cell range visible in this region */
+    readonly cellRange: CellRange;
+    /** Whether this region contains frozen cells */
+    readonly isFrozen: boolean;
+    /** How this region scrolls */
+    readonly scrollBehavior: 'free' | 'row-anchored' | 'col-anchored' | 'none';
+    /**
+     * Viewport ID for per-viewport buffer resolution (Phase 6).
+     * Maps to a viewport region: 'main', 'frozen-corner', 'frozen-rows', 'frozen-cols'.
+     * When set, the cells layer reads from the viewport-specific binary buffer
+     * instead of the shared global buffer.
+     */
+    readonly viewportId?: string;
+}
+//# sourceMappingURL=grid-region.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grid-region.d.ts","sourceRoot":"","sources":["../../src/rendering/grid-region.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,GAAG,MAAM,CAAC;IAC3E;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}