@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/ink/types.d.ts

@@ -0,0 +1,558 @@
+/**
+ * Ink Data Model Types
+ *
+ * Core type definitions for the ink/drawing engine. This module provides
+ * the foundational data structures for pen-based drawing, handwriting
+ * recognition, and shape detection.
+ *
+ * ARCHITECTURE NOTES:
+ * - Schema-Driven Initialization: All structures defined by schemas (see ink-schema.ts)
+ * - CRDT-Safe Design: Uses Map<StrokeId, InkStroke> instead of arrays to avoid ordering conflicts
+ * - Cell Identity Model: DrawingObject uses CellId for anchors (survives row/col insert/delete)
+ * - Contracts-First: All types in contracts/, no implementation logic
+ *
+ * SYNC NOTE: The Rust source of truth for wire types is in compute-core. The bridge
+ * codegen produces matching types in kernel/bridges/compute/compute-types.gen.ts
+ * (DrawingData, InkStroke, InkPoint, InkTool, InkToolState, InkToolSettings,
+ * RecognitionResult, RecognitionBounds, ShapeRecognitionParams, TextAlternative).
+ * These domain types intentionally differ from the wire types:
+ * - StrokeId is a branded string type (wire uses plain string)
+ * - InkToolState.toolSettings uses Record<InkTool, ...> (wire uses Record<string, ...>)
+ * - DrawingObject uses Map<> fields (wire uses Record<>)
+ * When updating these types, ensure the wire types stay compatible.
+ *
+ * @see plans/active/ink-engine/INK-ENGINE-OVERVIEW.md
+ */
+import type { FloatingObjectBase, ObjectPosition } from '../objects/floating-objects';
+/**
+ * Unique identifier for a stroke within a drawing.
+ *
+ * Branded type provides type safety - prevents accidentally using
+ * string IDs where StrokeId is expected (and vice versa).
+ *
+ * Uses UUID v7 (time-sortable) for:
+ * - Uniqueness across clients (no coordination needed)
+ * - Time-sortability for undo/redo ordering
+ * - Compact string representation
+ */
+export type StrokeId = string & {
+    readonly __brand: 'StrokeId';
+};
+/**
+ * A single point in a stroke with pressure and tilt support.
+ *
+ * Coordinates are in local drawing object space (pixels relative to
+ * drawing object bounds). Transform to sheet coordinates happens at render time.
+ *
+ * Pressure and tilt are normalized to [0, 1] ranges for consistent
+ * rendering regardless of input device.
+ */
+export interface InkPoint {
+    /** X coordinate in drawing object local space (pixels) */
+    x: number;
+    /** Y coordinate in drawing object local space (pixels) */
+    y: number;
+    /**
+     * Pen pressure normalized to [0, 1].
+     * - 0 = minimum pressure (or mouse with no pressure support)
+     * - 1 = maximum pressure
+     * - undefined = no pressure data (mouse, touch without pressure)
+     *
+     * Used for variable stroke width rendering.
+     */
+    pressure?: number;
+    /**
+     * Tilt angle in radians [0, PI/2].
+     * - 0 = perpendicular to surface
+     * - PI/2 = parallel to surface
+     * - undefined = no tilt data
+     *
+     * Used for brush shape and texture effects.
+     */
+    tilt?: number;
+    /**
+     * Timestamp when this point was captured (ms since stroke start).
+     * Used for velocity calculations and replay animations.
+     * - undefined = no timing data
+     */
+    timestamp?: number;
+}
+/**
+ * Available ink tools for drawing.
+ *
+ * Each tool has different rendering characteristics:
+ * - pen: Solid line, pressure-sensitive width
+ * - pencil: Textured line, slight transparency
+ * - highlighter: Wide, semi-transparent, blends with background
+ * - marker: Bold, opaque, consistent width
+ * - brush: Artistic brush effects, pressure-sensitive
+ * - eraser: Removes strokes (not a drawing tool, but handled similarly)
+ */
+export type InkTool = 'pen' | 'pencil' | 'highlighter' | 'marker' | 'brush' | 'eraser';
+/**
+ * Selection mode for selecting strokes within a drawing.
+ *
+ * Note: Selection is triggered via modifier key (e.g., holding Shift),
+ * not as a separate tool. This matches common drawing app UX patterns.
+ *
+ * - 'lasso': Free-form selection boundary
+ * - 'rectangle': Rectangular selection box
+ */
+export type SelectionMode = 'lasso' | 'rectangle';
+/**
+ * A complete ink stroke with all rendering properties.
+ *
+ * Strokes are immutable once created - modifications create new strokes
+ * with the same ID (for CRDT merge semantics).
+ */
+export interface InkStroke {
+    /** Unique identifier for this stroke */
+    id: StrokeId;
+    /** Ordered array of points composing the stroke */
+    points: InkPoint[];
+    /** Tool used to create this stroke */
+    tool: InkTool;
+    /** Stroke color in CSS color format (hex, rgb, hsl) */
+    color: string;
+    /**
+     * Base stroke width in pixels.
+     * Actual rendered width may vary with pressure.
+     */
+    width: number;
+    /**
+     * Stroke opacity [0, 1].
+     * - 0 = fully transparent
+     * - 1 = fully opaque
+     *
+     * Different tools have different default opacities
+     * (e.g., highlighter defaults to ~0.4).
+     */
+    opacity: number;
+    /**
+     * User ID who created this stroke.
+     * Used for:
+     * - Collaboration: Show who drew what
+     * - Permissions: Only creator can modify their strokes
+     * - Undo: Per-user undo stacks
+     */
+    createdBy: string;
+    /**
+     * Timestamp when stroke was created (Unix ms).
+     * Used for ordering and undo/redo.
+     */
+    createdAt: number;
+    /**
+     * Whether this stroke is currently selected.
+     * This is a transient UI state, not persisted.
+     */
+    selected?: boolean;
+}
+/**
+ * Serialized point format for storage efficiency.
+ *
+ * Points are stored as flat arrays [x, y, pressure?, tilt?, timestamp?]
+ * to reduce JSON overhead. Undefined values are omitted.
+ */
+export type SerializedPoint = [number, number, number?, number?, number?];
+/**
+ * Serialized stroke format for efficient Yjs/CRDT storage.
+ *
+ * Uses flat point array format to minimize storage size and
+ * reduce CRDT merge overhead.
+ */
+export interface SerializedStroke {
+    /** Unique identifier */
+    id: StrokeId;
+    /** Points as flat arrays for efficiency */
+    points: SerializedPoint[];
+    /** Tool type */
+    tool: InkTool;
+    /** Color string */
+    color: string;
+    /** Width in pixels */
+    width: number;
+    /** Opacity [0, 1] */
+    opacity: number;
+    /** Creator user ID */
+    createdBy: string;
+    /** Creation timestamp */
+    createdAt: number;
+}
+/**
+ * Default settings for a specific ink tool.
+ *
+ * Each tool can have different defaults for width, opacity, etc.
+ * These are used when creating new strokes.
+ */
+export interface InkToolSettings {
+    /** Default stroke width in pixels */
+    width: number;
+    /** Default opacity [0, 1] */
+    opacity: number;
+    /** Default color (CSS color string) */
+    color: string;
+    /**
+     * Whether this tool supports pressure sensitivity.
+     * Some tools (e.g., highlighter) ignore pressure.
+     */
+    supportsPressure: boolean;
+}
+/**
+ * Current tool state for a drawing session.
+ *
+ * Tracks the active tool and its settings.
+ */
+export interface InkToolState {
+    /** Currently selected tool */
+    activeTool: InkTool;
+    /** Per-tool settings (user preferences) */
+    toolSettings: Record<InkTool, InkToolSettings>;
+}
+/**
+ * Parameters for a recognized line shape.
+ */
+export interface LineShapeParams {
+    type: 'line';
+    /** Start point */
+    x1: number;
+    y1: number;
+    /** End point */
+    x2: number;
+    y2: number;
+    /** Rotation angle in radians (0 = horizontal) */
+    rotation: number;
+}
+/**
+ * Parameters for a recognized rectangle shape.
+ */
+export interface RectangleShapeParams {
+    type: 'rectangle';
+    /** Top-left corner */
+    x: number;
+    y: number;
+    /** Dimensions */
+    width: number;
+    height: number;
+    /** Rotation angle in radians (0 = axis-aligned) */
+    rotation: number;
+    /** Corner radius for rounded rectangles (0 = sharp corners) */
+    cornerRadius?: number;
+}
+/**
+ * Parameters for a recognized ellipse/circle shape.
+ */
+export interface EllipseShapeParams {
+    type: 'ellipse';
+    /** Center point */
+    cx: number;
+    cy: number;
+    /** Radii */
+    rx: number;
+    ry: number;
+    /** Rotation angle in radians */
+    rotation: number;
+}
+/**
+ * Parameters for a recognized triangle shape.
+ */
+export interface TriangleShapeParams {
+    type: 'triangle';
+    /** Three vertices */
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x3: number;
+    y3: number;
+    /** Rotation angle in radians */
+    rotation: number;
+}
+/**
+ * Parameters for a recognized arrow shape.
+ */
+export interface ArrowShapeParams {
+    type: 'arrow';
+    /** Start point (tail) */
+    x1: number;
+    y1: number;
+    /** End point (head) */
+    x2: number;
+    y2: number;
+    /** Arrow head size in pixels */
+    headSize: number;
+    /** Rotation angle in radians */
+    rotation: number;
+    /** Whether arrow has head at start (bidirectional) */
+    hasStartHead?: boolean;
+}
+/**
+ * Parameters for a recognized star shape.
+ */
+export interface StarShapeParams {
+    type: 'star';
+    /** Center point */
+    cx: number;
+    cy: number;
+    /** Outer radius (tip of points) */
+    outerRadius: number;
+    /** Inner radius (between points) */
+    innerRadius: number;
+    /** Number of points */
+    points: number;
+    /** Rotation angle in radians */
+    rotation: number;
+}
+/**
+ * Union type for all shape parameter types.
+ */
+export type ShapeParams = LineShapeParams | RectangleShapeParams | EllipseShapeParams | TriangleShapeParams | ArrowShapeParams | StarShapeParams;
+/**
+ * Type of recognized shape.
+ */
+export type RecognizedShapeType = 'line' | 'rectangle' | 'ellipse' | 'triangle' | 'arrow' | 'star';
+/**
+ * A shape recognized from one or more ink strokes.
+ *
+ * Recognition converts freehand strokes into clean geometric shapes
+ * while preserving the original strokes for undo/redo.
+ */
+export interface RecognizedShape {
+    /** Type discriminator */
+    type: 'shape';
+    /** Recognized shape type */
+    shapeType: RecognizedShapeType;
+    /** Shape parameters (position, dimensions, etc.) */
+    params: ShapeParams;
+    /**
+     * IDs of the source strokes that were recognized as this shape.
+     * Used for:
+     * - Undo: Can restore original strokes
+     * - Styling: Shape inherits color/width from source strokes
+     */
+    sourceStrokeIds: StrokeId[];
+    /** Confidence score [0, 1] for the recognition */
+    confidence: number;
+    /** Timestamp when recognition occurred */
+    recognizedAt: number;
+}
+/**
+ * A text segment recognized from handwriting.
+ *
+ * Represents an alternative interpretation of the handwriting
+ * with its confidence score.
+ */
+export interface TextAlternative {
+    /** Recognized text */
+    text: string;
+    /** Confidence score [0, 1] */
+    confidence: number;
+}
+/**
+ * Text recognized from handwritten ink strokes.
+ *
+ * Handwriting recognition converts ink to text with multiple
+ * alternative interpretations ranked by confidence.
+ */
+export interface RecognizedText {
+    /** Type discriminator */
+    type: 'text';
+    /** Primary recognized text (highest confidence) */
+    text: string;
+    /**
+     * Alternative interpretations ranked by confidence.
+     * First element is same as `text` field.
+     */
+    alternatives: TextAlternative[];
+    /**
+     * IDs of the source strokes that were recognized as this text.
+     * Used for undo and re-recognition.
+     */
+    sourceStrokeIds: StrokeId[];
+    /** Bounding box for the recognized text */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Timestamp when recognition occurred */
+    recognizedAt: number;
+}
+/**
+ * Union type for all recognition results.
+ */
+export type RecognitionResult = RecognizedShape | RecognizedText;
+/**
+ * Drawing object floating on the spreadsheet.
+ *
+ * Extends FloatingObjectBase to integrate with the existing floating
+ * object system (selection, drag, resize, z-order, etc.).
+ *
+ * CRDT-SAFE DESIGN:
+ * - Strokes stored as Map<StrokeId, InkStroke> to avoid array ordering conflicts
+ * - Uses CellId for anchors (survives row/col insert/delete)
+ * - Y.Map under the hood for concurrent editing support
+ */
+export interface DrawingObject extends FloatingObjectBase {
+    type: 'drawing';
+    /**
+     * Strokes in this drawing, keyed by StrokeId.
+     *
+     * Using Map<StrokeId, InkStroke> instead of array for CRDT safety:
+     * - No ordering conflicts when concurrent users add strokes
+     * - O(1) lookup/delete by ID
+     * - Stable references across edits
+     *
+     * Render order is determined by stroke createdAt timestamps.
+     */
+    strokes: Map<StrokeId, InkStroke>;
+    /**
+     * Current tool settings for this drawing.
+     * Persisted per-drawing to remember user preferences.
+     */
+    toolState: InkToolState;
+    /**
+     * Recognition results for strokes in this drawing.
+     * Maps from a "recognition ID" to the result.
+     * A recognition can be:
+     * - A shape recognized from one or more strokes
+     * - Text recognized from handwriting strokes
+     */
+    recognitions: Map<string, RecognitionResult>;
+    /**
+     * Background color of the drawing canvas.
+     * - undefined = transparent (shows sheet grid)
+     * - CSS color string = solid background
+     */
+    backgroundColor?: string;
+}
+/**
+ * Options for creating a new drawing object.
+ */
+export interface CreateDrawingOptions {
+    /** Optional name for the drawing object */
+    name?: string;
+    /** Alt text for accessibility */
+    altText?: string;
+    /** Whether the drawing is locked */
+    locked?: boolean;
+    /** Whether the drawing appears in print */
+    printable?: boolean;
+    /** Initial background color */
+    backgroundColor?: string;
+    /** Initial tool settings */
+    toolState?: Partial<InkToolState>;
+}
+/**
+ * Extension to IFloatingObjectManager for drawing operations.
+ *
+ * These methods are added to the existing floating object manager
+ * interface to support ink/drawing functionality.
+ */
+export interface IDrawingObjectManager {
+    /**
+     * Create a new drawing object.
+     *
+     * @param sheetId - Sheet to create the drawing in
+     * @param position - Initial position configuration
+     * @param options - Optional drawing configuration
+     * @returns The created drawing object
+     */
+    createDrawing(sheetId: string, position: Partial<ObjectPosition>, options?: CreateDrawingOptions): DrawingObject;
+    /**
+     * Add a stroke to a drawing.
+     *
+     * @param drawingId - ID of the drawing object
+     * @param stroke - The stroke to add
+     */
+    addStroke(drawingId: string, stroke: InkStroke): void;
+    /**
+     * Remove a stroke from a drawing.
+     *
+     * @param drawingId - ID of the drawing object
+     * @param strokeId - ID of the stroke to remove
+     */
+    removeStroke(drawingId: string, strokeId: StrokeId): void;
+    /**
+     * Update a stroke's properties.
+     *
+     * @param drawingId - ID of the drawing object
+     * @param strokeId - ID of the stroke to update
+     * @param updates - Partial stroke properties to update
+     */
+    updateStroke(drawingId: string, strokeId: StrokeId, updates: Partial<InkStroke>): void;
+    /**
+     * Get all strokes in a drawing ordered by creation time.
+     *
+     * Since strokes are stored in a Map for CRDT safety, this method
+     * provides ordered iteration for rendering.
+     *
+     * @param drawingId - ID of the drawing object
+     * @returns Array of strokes ordered by createdAt timestamp
+     */
+    getOrderedStrokes(drawingId: string): InkStroke[];
+    /**
+     * Add a recognition result to a drawing.
+     *
+     * @param drawingId - ID of the drawing object
+     * @param recognitionId - Unique ID for this recognition
+     * @param result - The recognition result (shape or text)
+     */
+    addRecognition(drawingId: string, recognitionId: string, result: RecognitionResult): void;
+    /**
+     * Remove a recognition result from a drawing.
+     *
+     * @param drawingId - ID of the drawing object
+     * @param recognitionId - ID of the recognition to remove
+     */
+    removeRecognition(drawingId: string, recognitionId: string): void;
+    /**
+     * Update tool state for a drawing.
+     *
+     * @param drawingId - ID of the drawing object
+     * @param toolState - New tool state
+     */
+    setToolState(drawingId: string, toolState: InkToolState): void;
+    /**
+     * Get the current tool state for a drawing.
+     *
+     * @param drawingId - ID of the drawing object
+     * @returns Current tool state
+     */
+    getToolState(drawingId: string): InkToolState;
+}
+/**
+ * Interface for accessing ink state during rendering.
+ *
+ * This is a minimal interface used by canvas-renderer to display live
+ * stroke previews during ink drawing mode. It abstracts the ink machine
+ * state to avoid direct XState dependencies in the renderer.
+ *
+ * @see canvas-renderer/src/layers/overlay-layer.ts - Consumer
+ * @see state-machines/src/ink/accessor.ts - Provider
+ */
+export interface InkAccessorForRendering {
+    /** Check if currently stroking */
+    isStroking(): boolean;
+    /** Check if currently erasing */
+    isErasing(): boolean;
+    /** Check if currently selecting with lasso */
+    isSelecting(): boolean;
+    /** Get target drawing object ID */
+    getTargetDrawingId(): string | null;
+    /** Get current stroke points */
+    getCurrentStroke(): InkPoint[];
+    /** Get active ink tool */
+    getActiveTool(): InkTool;
+    /** Get active stroke color */
+    getActiveColor(): string;
+    /** Get active stroke width */
+    getActiveWidth(): number;
+    /** Get active stroke opacity */
+    getActiveOpacity(): number;
+    /** Get lasso selection points */
+    getLassoPoints(): InkPoint[];
+    /** Get last recorded point (for cursor display) */
+    getLastPoint(): InkPoint | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/kernel/floating-object-manager.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Floating Object Manager Interface
+ *
+ * App-facing contract for the floating object management system.
+ * The kernel provides the implementation (SpreadsheetObjectManager);
+ * apps and shell program against this interface only.
+ *
+ * Lifecycle/wiring methods (setPositionLookup,
+ * setDocumentContext, dispose) are intentionally excluded — those are
+ * kernel-internal concerns that only the document lifecycle system calls.
+ */
+import type { CreateEquationOptions, CreateSmartArtOptions, CreateTextBoxOptions, CreateWordArtOptions, EquationObject, FloatingObject, ObjectPosition, PictureObject, SmartArtObject, TextBoxObject } from '../objects/floating-objects';
+import type { WordArtConfig } from '../wordart/types';
+/**
+ * Computed bounding box for a floating object in pixel coordinates.
+ */
+export interface ObjectBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+}
+export interface IFloatingObjectManager {
+    /** Get a floating object by ID. */
+    getObject(objectId: string): Promise<FloatingObject | undefined>;
+    /** Get all floating objects in a sheet, sorted by zIndex. */
+    getObjectsInSheet(sheetId: string): Promise<FloatingObject[]>;
+    /** Compute the pixel bounding box for a floating object (async — uses ComputeBridge). */
+    computeObjectBounds(obj: FloatingObject): Promise<ObjectBounds | null>;
+    /** Batch-compute pixel bounds for all floating objects on a sheet (single IPC call). */
+    computeAllObjectBounds(sheetId: string): Promise<Map<string, ObjectBounds>>;
+    createPicture(sheetId: string, src: string, position: Partial<ObjectPosition>, options?: {
+        name?: string;
+        altText?: string;
+    }): Promise<PictureObject>;
+    createTextBox(sheetId: string, content: string, position: Partial<ObjectPosition>, options?: CreateTextBoxOptions): Promise<TextBoxObject>;
+    createEquation(sheetId: string, position: Partial<ObjectPosition>, options?: CreateEquationOptions): Promise<EquationObject>;
+    createSmartArt(sheetId: string, position: Partial<ObjectPosition>, layoutId: string, options?: CreateSmartArtOptions): Promise<SmartArtObject>;
+    createWordArt(sheetId: string, content: string, position: Partial<ObjectPosition>, options: CreateWordArtOptions): Promise<TextBoxObject>;
+    deleteObject(objectId: string): Promise<boolean>;
+    deleteObjects(objectIds: string[]): Promise<number>;
+    moveObject(objectId: string, dx: number, dy: number): Promise<boolean>;
+    resizeObject(objectId: string, width: number, height: number): Promise<boolean>;
+    rotateObject(objectId: string, angle: number): Promise<boolean>;
+    updateObject(objectId: string, updates: Partial<FloatingObject>): Promise<boolean>;
+    updateWordArt(objectId: string, updates: Partial<WordArtConfig>): Promise<void>;
+    updateEquation(objectId: string, latex: string): Promise<void>;
+    updateEquationOmml(objectId: string, omml: string): Promise<void>;
+    convertToWordArt(objectId: string, config: WordArtConfig): Promise<void>;
+    removeWordArtStyling(objectId: string): Promise<void>;
+    bringToFront(objectId: string): Promise<boolean>;
+    bringToFront(containerId: string, objectId: string): Promise<boolean>;
+    sendToBack(objectId: string): Promise<boolean>;
+    sendToBack(containerId: string, objectId: string): Promise<boolean>;
+    bringForward(objectId: string): Promise<boolean>;
+    bringForward(containerId: string, objectId: string): Promise<boolean>;
+    sendBackward(objectId: string): Promise<boolean>;
+    sendBackward(containerId: string, objectId: string): Promise<boolean>;
+    groupObjects(objectIds: string[]): Promise<string | null>;
+    groupObjects(containerId: string, objectIds: string[]): Promise<string | null>;
+    ungroupObjects(groupId: string): Promise<boolean>;
+    duplicateObject(objectId: string, offset?: {
+        dx: number;
+        dy: number;
+    }): Promise<FloatingObject | null>;
+}
+//# sourceMappingURL=floating-object-manager.d.ts.map

package/dist/kernel/floating-object-manager.d.ts.map

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

package/dist/kernel/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Kernel Types
+ *
+ * Three-tier context architecture:
+ * - IDomainContext: Minimal (for domain modules — event bus + undo)
+ * - IKernelContext: Full (for Shell, includes all bridges + services + destroy)
+ * - DocumentContext: Engine internals (defined in kernel, not contracts)
+ */
+export type { IDomainContext, IKernelContext, ISlicerBridge, ISpreadsheetKernelContext, } from './kernel-context';
+export type { IFloatingObjectManager, ObjectBounds } from './floating-object-manager';
+export type { IKernelServices } from '../services';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kernel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGtF,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}