@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/viewport/geometry.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @mog/spreadsheet-contracts/geometry
+ *
+ * 2D geometry primitives used by all floating object engines
+ * (shapes, equations, wordart, ink, drawing).
+ *
+ * Pure type definitions - no runtime code.
+ */
+/** A point in 2D space. */
+export interface Point2D {
+    x: number;
+    y: number;
+}
+/** A 2D vector (same shape as Point2D but different semantics). */
+export interface Vector2D {
+    x: number;
+    y: number;
+}
+/** Axis-aligned bounding box defined by top-left corner + dimensions. */
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * 2D affine transform represented as a 3x3 matrix:
+ *
+ *   | a  c  tx |
+ *   | b  d  ty |
+ *   | 0  0  1  |
+ *
+ * Applies as: x' = a*x + c*y + tx, y' = b*x + d*y + ty
+ */
+export interface AffineTransform {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    tx: number;
+    ty: number;
+}
+/** Move the pen to (x, y) without drawing. */
+export interface MoveTo {
+    type: 'M';
+    x: number;
+    y: number;
+}
+/** Draw a straight line to (x, y). */
+export interface LineTo {
+    type: 'L';
+    x: number;
+    y: number;
+}
+/** Draw a cubic Bezier curve to (x, y) with control points (x1, y1) and (x2, y2). */
+export interface CurveTo {
+    type: 'C';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+}
+/** Draw a quadratic Bezier curve to (x, y) with control point (x1, y1). */
+export interface QuadraticTo {
+    type: 'Q';
+    x1: number;
+    y1: number;
+    x: number;
+    y: number;
+}
+/** Close the current subpath by drawing a line back to the start. */
+export interface ClosePath {
+    type: 'Z';
+}
+/** A single segment in a path. */
+export type PathSegment = MoveTo | LineTo | CurveTo | QuadraticTo | ClosePath;
+/** A single subpath within a compound path. */
+export interface SubPath {
+    segments: PathSegment[];
+    closed: boolean;
+}
+/** A geometric path composed of segments. */
+export interface Path {
+    segments: PathSegment[];
+    closed: boolean;
+    subPaths?: SubPath[];
+}
+//# sourceMappingURL=geometry.d.ts.map

package/dist/viewport/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/viewport/geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,2BAA2B;AAC3B,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAID,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAID,8CAA8C;AAC9C,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,GAAG,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,sCAAsC;AACtC,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,GAAG,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qFAAqF;AACrF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,GAAG,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,GAAG,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,GAAG,CAAC;CACX;AAED,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAE9E,+CAA+C;AAC/C,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,IAAI;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB"}

package/dist/viewport/grid-canvas.d.ts

@@ -0,0 +1,133 @@
+/**
+ * GridCanvas Feature Types
+ *
+ * Feature flags for configuring GridCanvas behavior.
+ * Apps use these flags to enable/disable specific features.
+ *
+ * @see plans/active/os-refactor/CLEAN-OS-ARCHITECTURE.md
+ */
+/**
+ * Feature flags for GridCanvas component.
+ *
+ * Each flag controls whether a specific capability is enabled.
+ * Apps can configure GridCanvas for different use cases:
+ * - Spreadsheet: all features enabled
+ * - Embedded table: editing + selection, no formulas
+ * - Dashboard: read-only display
+ *
+ * @example
+ * ```tsx
+ * // Full spreadsheet
+ * <GridCanvas features={{ editing: true, selection: true, formulas: true, fill: true }} />
+ *
+ * // Embedded table in Slides
+ * <GridCanvas features={{ editing: true, selection: true }} />
+ *
+ * // Read-only dashboard
+ * <GridCanvas features={{ editing: false, selection: false }} />
+ * ```
+ */
+export interface GridCanvasFeatures {
+    /**
+     * Enable cell editing.
+     * When false, cells cannot be edited.
+     * @default true
+     */
+    editing?: boolean;
+    /**
+     * Enable cell selection UI.
+     * When false, no selection boxes are shown.
+     * @default true
+     */
+    selection?: boolean;
+    /**
+     * Enable formula bar integration.
+     * When true, the grid coordinates with an external formula bar.
+     * Spreadsheet app enables this; embedded grids typically don't.
+     * @default false
+     */
+    formulas?: boolean;
+    /**
+     * Enable format editing via toolbar.
+     * When true, selection changes update toolbar state.
+     * Apps that own their toolbar enable this; embedded grids don't.
+     * @default false
+     */
+    formatting?: boolean;
+    /**
+     * Enable row/column resize handles.
+     * When false, users cannot resize rows/columns by dragging.
+     * @default true
+     */
+    resize?: boolean;
+    /**
+     * Enable fill handle for drag-fill operations.
+     * When false, fill handle is not shown and drag-fill is disabled.
+     * @default false
+     */
+    fill?: boolean;
+    /**
+     * Enable right-click context menu.
+     * When false, no context menu appears on right-click.
+     * @default true
+     */
+    contextMenu?: boolean;
+    /**
+     * Enable keyboard shortcuts.
+     * When false, keyboard input is not handled by the grid.
+     * @default true
+     */
+    keyboard?: boolean;
+    /**
+     * Enable clipboard operations (copy/cut/paste).
+     * When false, clipboard operations are disabled.
+     * @default true
+     */
+    clipboard?: boolean;
+    /**
+     * Enable remote cursor display for collaboration.
+     * When false, remote cursors are not shown.
+     * @default false
+     */
+    collaboration?: boolean;
+    /**
+     * Enable cell comments.
+     * When false, comment indicators and hover are disabled.
+     * @default false
+     */
+    comments?: boolean;
+    /**
+     * Enable embedded charts.
+     * When false, chart objects are not rendered.
+     * @default false
+     */
+    charts?: boolean;
+    /**
+     * Enable floating objects (images, shapes, etc.).
+     * When false, floating objects are not rendered or interactive.
+     * @default false
+     */
+    floatingObjects?: boolean;
+    /**
+     * Enable find and replace functionality.
+     * When false, find/replace is disabled.
+     * @default false
+     */
+    findReplace?: boolean;
+}
+/**
+ * Preset names for common GridCanvas configurations.
+ * Use presets for ergonomic defaults, override with `features` prop if needed.
+ */
+export type GridCanvasPreset = 'full' | 'embedded' | 'readonly';
+/**
+ * Preset configurations for common use cases.
+ * These provide sensible defaults for typical scenarios.
+ */
+export declare const GRID_CANVAS_PRESETS: Record<GridCanvasPreset, Required<GridCanvasFeatures>>;
+/**
+ * Default features when no preset or explicit features are provided.
+ * Uses 'embedded' preset as a sensible default for most apps.
+ */
+export declare const DEFAULT_GRID_CANVAS_FEATURES: Required<GridCanvasFeatures>;
+//# sourceMappingURL=grid-canvas.d.ts.map

package/dist/viewport/grid-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-canvas.d.ts","sourceRoot":"","sources":["../../src/viewport/grid-canvas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CA+D7E,CAAC;AAMX;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,kBAAkB,CACxC,CAAC"}

package/dist/viewport/index.d.ts

@@ -0,0 +1,5 @@
+export * from './geometry';
+export * from './grid-canvas';
+export * from './viewport';
+export * from './viewport-config';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viewport/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/viewport/viewport-config.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Viewport Configuration Types
+ *
+ * Configuration types are split into:
+ * - PERSISTED: Stored in Yjs, shared across all collaborators
+ * - SESSION-LOCAL: Coordinator-owned, per-client
+ *
+ * @module viewport-config
+ */
+import type { CellRange } from '../core/core';
+import type { Rect } from './viewport';
+/**
+ * Persisted viewport configuration.
+ * Stored in Yjs, shared across all collaborators.
+ * This is the first-class viewport concept - no legacy "freeze config" indirection.
+ */
+export type PersistedViewportConfig = SingleViewportConfig | FreezeViewportConfig | SplitViewportConfig;
+/**
+ * Default: single viewport showing the active sheet.
+ */
+export interface SingleViewportConfig {
+    readonly type: 'single';
+}
+/**
+ * Freeze panes: 1-4 linked viewports.
+ * - rows=0, cols=0: same as SingleViewportConfig
+ * - rows>0, cols=0: 2 viewports (frozen rows, main)
+ * - rows=0, cols>0: 2 viewports (frozen cols, main)
+ * - rows>0, cols>0: 4 viewports (corner, frozen rows, frozen cols, main)
+ */
+export interface FreezeViewportConfig {
+    readonly type: 'freeze';
+    /** Number of frozen rows (0 = no frozen rows) */
+    readonly rows: number;
+    /** Number of frozen columns (0 = no frozen columns) */
+    readonly cols: number;
+}
+/**
+ * Split view: 2-4 independently scrolling viewports.
+ *
+ * Split view creates independent panes that can each scroll separately,
+ * allowing users to compare distant regions of the spreadsheet.
+ *
+ * Viewport IDs by direction:
+ * - 'horizontal': 'top', 'bottom' (split along a row)
+ * - 'vertical': 'left', 'right' (split along a column)
+ * - 'both': 'topLeft', 'topRight', 'bottomLeft', 'bottomRight' (4 quadrants)
+ *
+ * @see plans/active/excel-parity/01-split-view-not-implemented.md
+ */
+export interface SplitViewportConfig {
+    readonly type: 'split';
+    /** Direction of the split */
+    readonly direction: 'horizontal' | 'vertical' | 'both';
+    /**
+     * Row index for horizontal split line.
+     * Used when direction is 'horizontal' or 'both'.
+     * Defaults to 0 (ignored) when direction is 'vertical'.
+     */
+    readonly horizontalPosition: number;
+    /**
+     * Column index for vertical split line.
+     * Used when direction is 'vertical' or 'both'.
+     * Defaults to 0 (ignored) when direction is 'horizontal'.
+     */
+    readonly verticalPosition: number;
+}
+/**
+ * Content type for overlay viewports.
+ */
+export type OverlayContent = {
+    readonly type: 'range';
+    readonly sheetId?: string;
+    readonly range: CellRange;
+} | {
+    readonly type: 'cell';
+    readonly sheetId?: string;
+    readonly row: number;
+    readonly col: number;
+} | {
+    readonly type: 'custom';
+    readonly renderer: string;
+};
+/**
+ * Session-local overlay viewport configuration.
+ * Not persisted, not shared. Used for AI previews, focus mode, temporary visualizations.
+ */
+export interface OverlayViewportConfig {
+    readonly id: string;
+    readonly bounds: Rect;
+    readonly content: OverlayContent;
+    /** Whether this overlay receives input events (default: false) */
+    readonly interactive?: boolean;
+}
+//# sourceMappingURL=viewport-config.d.ts.map

package/dist/viewport/viewport-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-config.d.ts","sourceRoot":"","sources":["../../src/viewport/viewport-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC/B,oBAAoB,GACpB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IACvD;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAMD;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/viewport/viewport.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Viewport Types
+ *
+ * A Viewport is the fundamental rendering primitive for the spreadsheet.
+ * Everything that shows sheet data—the main grid, freeze panes, AI previews,
+ * minimaps, split views—is a viewport.
+ *
+ * @module viewport
+ */
+import type { CellRange } from '../core/core';
+/**
+ * A 2D point in any coordinate space.
+ */
+export interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * A 2D size (width and height).
+ */
+export interface Size {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * A rectangle in any coordinate space.
+ */
+export interface Rect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * How a viewport responds to scroll input.
+ *
+ * There is ONE scroll position (owned by coordinator). Each viewport
+ * derives its scroll offset based on its ScrollBehavior:
+ * - `free`: uses scroll position directly (main viewport)
+ * - `horizontal-only`: uses scroll.x, ignores scroll.y (frozen rows)
+ * - `vertical-only`: uses scroll.y, ignores scroll.x (frozen cols)
+ * - `none`: always (0, 0) (frozen corner, previews)
+ * - `linked`: follows another viewport's computed offset
+ */
+export type ScrollBehavior = {
+    readonly type: 'free';
+} | {
+    readonly type: 'horizontal-only';
+} | {
+    readonly type: 'vertical-only';
+} | {
+    readonly type: 'none';
+} | {
+    readonly type: 'linked';
+    readonly viewportId: string;
+    readonly axis: 'x' | 'y';
+};
+/**
+ * Rendering configuration for a viewport.
+ */
+export interface ViewportRenderConfig {
+    /** Show grid lines (default: true) */
+    readonly showGridLines: boolean;
+    /** Show row/column headers (default: false for overlay viewports) */
+    readonly showHeaders: boolean;
+    /** Background color (default: white) */
+    readonly backgroundColor: string;
+    /** Border style for viewport edge */
+    readonly border?: {
+        readonly color: string;
+        readonly width: number;
+    };
+    /** Reduce detail for performance (minimap) */
+    readonly lowFidelity: boolean;
+    /** Opacity (for overlay viewports) */
+    readonly opacity: number;
+}
+/**
+ * Default render config for main viewports.
+ */
+export declare const DEFAULT_VIEWPORT_RENDER_CONFIG: ViewportRenderConfig;
+/**
+ * A Viewport is an independent view into sheet data.
+ * This is the fundamental rendering primitive.
+ *
+ * Viewports are immutable - they are computed fresh whenever inputs change.
+ */
+export interface Viewport {
+    /** Unique identifier */
+    readonly id: string;
+    /** Position and size on canvas (CSS pixels, after header area) */
+    readonly bounds: Rect;
+    /** What cells this viewport shows */
+    readonly cellRange: CellRange;
+    /**
+     * Where this viewport starts in document coordinate space.
+     *
+     * This is critical for freeze panes: when the main viewport starts at row 2 (after
+     * 1 frozen row), viewportOrigin.y = frozenRowsHeight (e.g., 21px). This allows
+     * correct calculation of viewport-relative coordinates:
+     *
+     *   localCoord = docCoord - viewportOrigin - scrollOffset
+     *
+     * For the 4 freeze viewport types:
+     * - Corner:      { x: 0, y: 0 }
+     * - FrozenRows:  { x: frozenColsWidth, y: 0 }
+     * - FrozenCols:  { x: 0, y: frozenRowsHeight }
+     * - Main:        { x: frozenColsWidth, y: frozenRowsHeight }
+     * - Single (no freeze): { x: 0, y: 0 }
+     */
+    readonly viewportOrigin: Point;
+    /** Current scroll offset within this viewport's cell space */
+    readonly scrollOffset: Point;
+    /** How this viewport responds to scroll input */
+    readonly scrollBehavior: ScrollBehavior;
+    /** Which sheet this viewport shows (default: active sheet) */
+    readonly sheetId?: string;
+    /** Zoom level (default: 1.0) */
+    readonly zoom: number;
+    /** Rendering configuration */
+    readonly renderConfig: ViewportRenderConfig;
+}
+/**
+ * A divider line between viewports (freeze lines, split bars).
+ */
+export interface ViewportDivider {
+    readonly type: 'freeze' | 'split';
+    readonly orientation: 'horizontal' | 'vertical';
+    /** Position in canvas coordinates (CSS pixels) */
+    readonly position: number;
+    readonly draggable: boolean;
+}
+/**
+ * Information needed to render row/column headers with freeze awareness.
+ *
+ * Headers are NOT viewports, but they follow the same 4-region structure
+ * when freeze panes are enabled:
+ * - Frozen column headers don't scroll horizontally
+ * - Scrolling column headers scroll with scrollPosition.x
+ * - Frozen row headers don't scroll vertically
+ * - Scrolling row headers scroll with scrollPosition.y
+ */
+export interface HeaderRenderInfo {
+    /** Number of frozen rows (0 if none) */
+    readonly frozenRows: number;
+    /** Number of frozen columns (0 if none) */
+    readonly frozenCols: number;
+    /** Pixel height of frozen rows region (unzoomed) */
+    readonly frozenRowsHeight: number;
+    /** Pixel width of frozen columns region (unzoomed) */
+    readonly frozenColsWidth: number;
+    /** Current scroll position */
+    readonly scrollPosition: Point;
+    /** Current zoom level */
+    readonly zoom: number;
+}
+/**
+ * Complete layout of all viewports for a frame.
+ * This is the output of computeViewportLayout() - computed fresh from inputs.
+ *
+ * ViewportLayout is immutable derived state. It is never mutated, only replaced.
+ */
+export interface ViewportLayout {
+    /** All viewports to render, in z-order (first = bottom) */
+    readonly viewports: readonly Viewport[];
+    /** Which viewport receives keyboard/scroll input */
+    readonly primaryViewportId: string;
+    /** Divider lines between viewports (freeze lines, split bars) */
+    readonly dividers: readonly ViewportDivider[];
+    /** Total content size for scroll bounds calculation */
+    readonly contentSize: Size;
+    /** Maximum scroll position allowed */
+    readonly maxScroll: Point;
+    /** Header rendering information (freeze-aware) */
+    readonly headerInfo: HeaderRenderInfo;
+}
+/**
+ * Result of hit testing a point against the viewport layout.
+ */
+export interface ViewportHitResult {
+    /** The viewport that was hit */
+    readonly viewport: Viewport;
+    /** Cell coordinate within the viewport */
+    readonly cell: {
+        readonly row: number;
+        readonly col: number;
+    };
+    /** Point relative to the viewport's bounds */
+    readonly localPoint: Point;
+}
+//# sourceMappingURL=viewport.d.ts.map

package/dist/viewport/viewport.d.ts.map

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

package/dist/views/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Views Module
+ *
+ * Shared types for the multi-view system (grid, kanban, timeline, etc.).
+ *
+ * @module @mog/spreadsheet-contracts/views
+ */
+export type { ColumnSchema, ColumnTypeKind, EditTarget, IViewAdapter, IViewRegistry, SelectOption, TableId, ToolbarContext, Unsubscribe, ViewId, ViewSelection, ViewType, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,OAAO,EACP,cAAc,EACd,WAAW,EACX,MAAM,EACN,aAAa,EACb,QAAQ,GACT,MAAM,SAAS,CAAC"}