@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/formatting/theme.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Theme Contracts
+ *
+ * Type definitions and utilities for workbook themes.
+ * Themes define color palettes and font pairs that cells can reference.
+ *
+ * Issue 4: Page Layout - Themes
+ */
+/**
+ * Theme color slots following the OOXML standard.
+ * These 12 colors form the foundation of any theme.
+ */
+export interface ThemeColors {
+    /** Primary dark color - typically black/near-black for text */
+    dark1: string;
+    /** Primary light color - typically white for backgrounds */
+    light1: string;
+    /** Secondary dark color */
+    dark2: string;
+    /** Secondary light color */
+    light2: string;
+    /** Accent color 1 - primary accent (blue in Office default) */
+    accent1: string;
+    /** Accent color 2 - typically orange */
+    accent2: string;
+    /** Accent color 3 - typically gray */
+    accent3: string;
+    /** Accent color 4 - typically yellow/gold */
+    accent4: string;
+    /** Accent color 5 - typically blue-gray */
+    accent5: string;
+    /** Accent color 6 - typically green */
+    accent6: string;
+    /** Hyperlink color */
+    hyperlink: string;
+    /** Followed hyperlink color */
+    followedHyperlink: string;
+}
+/**
+ * All valid theme color slot names
+ */
+export type ThemeColorSlot = keyof ThemeColors;
+/**
+ * Theme font pair - major (headings) and minor (body) fonts.
+ */
+export interface ThemeFonts {
+    /** Font for headings (e.g., 'Calibri Light') */
+    majorFont: string;
+    /** Font for body text (e.g., 'Calibri') */
+    minorFont: string;
+}
+/**
+ * Standalone font theme definition (separate from full theme).
+ * Used for the Fonts dropdown in Page Layout to select font pair
+ * independently from the color theme.
+ *
+ * Plan 12: Fonts/Typography - Theme Font UI
+ */
+export interface FontThemeDefinition {
+    /** Unique identifier (e.g., 'office', 'arial') */
+    id: string;
+    /** Display name shown in UI (e.g., 'Office', 'Arial') */
+    name: string;
+    /** Font pair */
+    fonts: ThemeFonts;
+    /** True for built-in font themes */
+    builtIn: boolean;
+}
+/**
+ * Complete theme definition including colors and fonts.
+ */
+export interface ThemeDefinition {
+    /** Unique theme identifier (e.g., 'office', 'slice', 'custom-abc123') */
+    id: string;
+    /** Display name shown in UI (e.g., 'Office', 'Slice') */
+    name: string;
+    /** Theme color palette */
+    colors: ThemeColors;
+    /** Theme font pair */
+    fonts: ThemeFonts;
+    /** True for built-in themes, false for user-created */
+    builtIn: boolean;
+}
+/**
+ * Color value that can be either absolute hex or a theme reference.
+ *
+ * Formats:
+ * - Absolute: '#rrggbb' or '#rrggbbaa'
+ * - Theme reference: 'theme:slot' (e.g., 'theme:accent1')
+ * - Theme with tint: 'theme:slot:tint' (e.g., 'theme:accent1:0.4' for 40% lighter)
+ *
+ * @example
+ * '#4472c4'           // Absolute blue
+ * 'theme:accent1'     // Theme's accent1 color
+ * 'theme:accent1:0.4' // Theme's accent1, 40% tinted toward white
+ * 'theme:accent1:-0.25' // Theme's accent1, 25% shaded toward black
+ */
+export type ColorValue = string;
+/**
+ * Parsed theme color reference
+ */
+export interface ParsedThemeColor {
+    /** The theme color slot (e.g., 'accent1', 'dark1') */
+    slot: ThemeColorSlot;
+    /** Tint value: positive = lighter (toward white), negative = darker (toward black) */
+    tint?: number;
+}
+//# sourceMappingURL=theme.d.ts.map

package/dist/formatting/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/formatting/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC;AAM/C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,sBAAsB;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,IAAI,EAAE,cAAc,CAAC;IACrB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @mog/spreadsheet-contracts - Root Barrel (Minimal)
+ *
+ * This barrel exports only the fundamental types that are ubiquitous across
+ * the entire codebase. All other types should be imported from their
+ * respective sub-paths:
+ *
+ * @example
+ * // Fundamental types (from root)
+ * import type { CellRange, SheetId } from '@mog/spreadsheet-contracts';
+ *
+ * // Domain-specific types (from sub-paths)
+ * import type { SpreadsheetEvent } from '@mog/spreadsheet-contracts/events';
+ * import type { PivotTableConfig } from '@mog/spreadsheet-contracts/pivot';
+ * import type { RangeSchema } from '@mog/spreadsheet-contracts/schema';
+ *
+ * Available sub-paths:
+ * - /core - Core types (CellData, RowInfo, ColumnInfo, etc.)
+ * - /events - All spreadsheet events
+ * - /schema - Schema and validation types
+ * - /pivot - Pivot table types
+ * - /actors - Actor machine types
+ * - /rendering - Rendering and viewport types
+ * - /apps - App manifest and API types
+ * - /connections - Data connection types
+ * - /tables - Table types
+ * - /slicers - Slicer types
+ * - /filter - Filter types
+ * - /grouping - Grouping types
+ * - /sparklines - Sparkline types
+ * - /floating-objects - Floating object types
+ * - /protection - Protection types
+ * - /machines - State machine types
+ * - /versioning - Version control types
+ * - /testing - Testing framework types
+ * - ... and many more (see package.json exports)
+ */
+export type { 
+/** Cell address with row, col, and sheetId */
+CellAddress, 
+/** Cell formatting options */
+CellFormat, 
+/** Cell range with startRow, startCol, endRow, endCol */
+CellRange, 
+/** Cell value: string | number | boolean | null | CellError */
+CellValue, 
+/** Sheet identifier */
+SheetId, } from './core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAMH,YAAY;AACV,8CAA8C;AAC9C,WAAW;AACX,8BAA8B;AAC9B,UAAU;AACV,yDAAyD;AACzD,SAAS;AAET,+DAA+D;AAC/D,SAAS;AACT,uBAAuB;AACvB,OAAO,GACR,MAAM,QAAQ,CAAC"}

package/dist/ink/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Ink Module Barrel Export
+ *
+ * Central export for all ink/drawing engine types and utilities.
+ *
+ * @example
+ * import {
+ *   InkStroke,
+ *   StrokeId,
+ *   generateStrokeId,
+ *   computeStrokeBounds
+ * } from '@mog/spreadsheet-contracts/ink';
+ */
+export type { ArrowShapeParams, CreateDrawingOptions, DrawingObject, EllipseShapeParams, IDrawingObjectManager, InkAccessorForRendering, InkPoint, InkStroke, InkTool, InkToolSettings, InkToolState, LineShapeParams, RecognitionResult, RecognizedShape, RecognizedShapeType, RecognizedText, RectangleShapeParams, SelectionMode, SerializedPoint, SerializedStroke, ShapeParams, StarShapeParams, StrokeId, TextAlternative, TriangleShapeParams, } from './types';
+export type { ISpatialIndex, InkBoundingBox, } from './spatial-index';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ink/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EAEpB,aAAa,EACb,kBAAkB,EAElB,qBAAqB,EAErB,uBAAuB,EAEvB,QAAQ,EACR,SAAS,EACT,OAAO,EAEP,eAAe,EACf,YAAY,EAGZ,eAAe,EACf,iBAAiB,EAEjB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,aAAa,EAEb,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,eAAe,EAEf,QAAQ,EACR,eAAe,EACf,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAMjB,YAAY,EAEV,aAAa,EAEb,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/ink/spatial-index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Spatial Index Types for Ink Engine
+ *
+ * Types and utilities for spatial indexing and hit testing of ink strokes.
+ * Spatial indexing enables efficient queries like:
+ * - Which strokes are under the cursor? (hit testing)
+ * - Which strokes are within a selection region? (lasso/rectangle select)
+ * - Which strokes intersect a given bounding box? (viewport culling)
+ *
+ * ARCHITECTURE NOTES:
+ * - InkBoundingBox is the fundamental unit for spatial queries
+ * - ISpatialIndex interface enables different implementations (R-tree, grid, etc.)
+ * - Utility functions are pure and can be used without a spatial index
+ *
+ * @see contracts/src/ink/types.ts for InkStroke and InkPoint
+ */
+import type { StrokeId } from './types';
+/**
+ * Axis-aligned bounding box (AABB).
+ *
+ * Represents the smallest rectangle containing a shape.
+ * Used for fast spatial queries (O(1) intersection tests).
+ */
+export interface InkBoundingBox {
+    /** Minimum X coordinate (left edge) */
+    minX: number;
+    /** Minimum Y coordinate (top edge) */
+    minY: number;
+    /** Maximum X coordinate (right edge) */
+    maxX: number;
+    /** Maximum Y coordinate (bottom edge) */
+    maxY: number;
+}
+/**
+ * Spatial index for efficient stroke queries.
+ *
+ * Implementations can use different algorithms:
+ * - R-tree: Good for dynamic datasets, O(log n) queries
+ * - Grid: Good for uniform distributions, O(1) average queries
+ * - Quadtree: Good for non-uniform distributions
+ *
+ * The interface is implementation-agnostic for flexibility.
+ */
+export interface ISpatialIndex {
+    /**
+     * Insert a stroke into the spatial index.
+     *
+     * @param strokeId - ID of the stroke
+     * @param bounds - Bounding box of the stroke
+     */
+    insert(strokeId: StrokeId, bounds: InkBoundingBox): void;
+    /**
+     * Remove a stroke from the spatial index.
+     *
+     * @param strokeId - ID of the stroke to remove
+     */
+    remove(strokeId: StrokeId): void;
+    /**
+     * Update a stroke's bounds in the spatial index.
+     *
+     * Equivalent to remove + insert but may be more efficient.
+     *
+     * @param strokeId - ID of the stroke to update
+     * @param newBounds - New bounding box
+     */
+    update(strokeId: StrokeId, newBounds: InkBoundingBox): void;
+    /**
+     * Find all strokes that intersect a bounding box.
+     *
+     * @param bounds - Query bounding box
+     * @returns Array of stroke IDs whose bounds intersect the query box
+     */
+    query(bounds: InkBoundingBox): StrokeId[];
+    /**
+     * Find all strokes that contain a point.
+     *
+     * This performs bounds-based filtering first, then may need
+     * additional checks for precise point-in-stroke testing.
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @returns Array of stroke IDs whose bounds contain the point
+     */
+    queryPoint(x: number, y: number): StrokeId[];
+    /**
+     * Find the nearest stroke to a point.
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @param maxDistance - Maximum search distance (optional)
+     * @returns Nearest stroke ID and distance, or null if none found
+     */
+    queryNearest(x: number, y: number, maxDistance?: number): {
+        strokeId: StrokeId;
+        distance: number;
+    } | null;
+    /**
+     * Clear all strokes from the index.
+     */
+    clear(): void;
+    /**
+     * Get the number of strokes in the index.
+     */
+    size(): number;
+    /**
+     * Bulk insert multiple strokes.
+     * May be more efficient than individual inserts.
+     *
+     * @param entries - Array of [strokeId, bounds] tuples
+     */
+    bulkInsert(entries: Array<[StrokeId, InkBoundingBox]>): void;
+}
+//# sourceMappingURL=spatial-index.d.ts.map

package/dist/ink/spatial-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-index.d.ts","sourceRoot":"","sources":["../../src/ink/spatial-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMxC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAEzD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEjC;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAE5D;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,EAAE,CAAC;IAE1C;;;;;;;;;OASG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAE7C;;;;;;;OAOG;IACH,YAAY,CACV,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,WAAW,CAAC,EAAE,MAAM,GACnB;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;IAEf;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC;CAC9D"}