@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/drawing/three-d.d.ts

@@ -0,0 +1,171 @@
+/**
+ * 3D Effect Types — shared across SmartArt, WordArt, and general shape rendering
+ *
+ * Based on ECMA-376 5th Edition, Part 1 (dml-main.xsd)
+ * These types provide strongly-typed union literals for all 3D-related
+ * enumerations, replacing the weak `string` types previously used in
+ * SmartArt contracts.
+ */
+/**
+ * Preset camera type.
+ *
+ * Defines the camera viewing angle for 3D scenes.
+ * 62 presets covering legacy, orthographic, isometric, oblique,
+ * and perspective projections.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10.45 (ST_PresetCameraType)
+ */
+export type PresetCameraType = 'legacyObliqueTopLeft' | 'legacyObliqueTop' | 'legacyObliqueTopRight' | 'legacyObliqueFront' | 'legacyObliqueLeft' | 'legacyObliqueRight' | 'legacyPerspectiveTopLeft' | 'legacyPerspectiveTop' | 'legacyPerspectiveTopRight' | 'legacyPerspectiveFront' | 'legacyPerspectiveLeft' | 'legacyPerspectiveRight' | 'orthographicFront' | 'isometricTopUp' | 'isometricTopDown' | 'isometricBottomUp' | 'isometricBottomDown' | 'isometricLeftUp' | 'isometricLeftDown' | 'isometricRightUp' | 'isometricRightDown' | 'isometricOffAxis1Left' | 'isometricOffAxis1Right' | 'isometricOffAxis1Top' | 'isometricOffAxis2Left' | 'isometricOffAxis2Right' | 'isometricOffAxis2Top' | 'isometricOffAxis3Left' | 'isometricOffAxis3Right' | 'isometricOffAxis3Bottom' | 'isometricOffAxis4Left' | 'isometricOffAxis4Right' | 'isometricOffAxis4Bottom' | 'obliqueTopLeft' | 'obliqueTop' | 'obliqueTopRight' | 'obliqueLeft' | 'obliqueRight' | 'obliqueBottomLeft' | 'obliqueBottom' | 'obliqueBottomRight' | 'perspectiveFront' | 'perspectiveLeft' | 'perspectiveRight' | 'perspectiveAbove' | 'perspectiveAboveLeftFacing' | 'perspectiveAboveRightFacing' | 'perspectiveContrastingLeftFacing' | 'perspectiveContrastingRightFacing' | 'perspectiveHeroicLeftFacing' | 'perspectiveHeroicRightFacing' | 'perspectiveHeroicExtremeLeftFacing' | 'perspectiveHeroicExtremeRightFacing' | 'perspectiveBelow' | 'perspectiveRelaxed' | 'perspectiveRelaxedModerately';
+/**
+ * Bevel preset type.
+ *
+ * Defines the cross-section profile of a 3D bevel edge effect.
+ * 12 presets defining different edge shapes.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10.6 (ST_BevelPresetType)
+ */
+export type BevelPresetType = 'relaxedInset' | 'circle' | 'slope' | 'cross' | 'angle' | 'softRound' | 'convex' | 'coolSlant' | 'divot' | 'riblet' | 'hardEdge' | 'artDeco';
+/**
+ * Preset material type.
+ *
+ * Defines how a surface responds to light — affects highlights,
+ * reflections, and the overall appearance of 3D shapes.
+ * 14 presets ranging from matte to metallic.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10.43 (ST_PresetMaterialType)
+ */
+export type PresetMaterialType = 'dkEdge' | 'flat' | 'legacyMatte' | 'legacyMetal' | 'legacyPlastic' | 'legacyWireframe' | 'matte' | 'metal' | 'plastic' | 'powder' | 'softEdge' | 'softmetal' | 'translucentPowder' | 'warmMatte';
+/**
+ * Light rig type.
+ *
+ * Defines the lighting setup used to illuminate 3D shapes.
+ * Different rigs create different moods and highlight patterns.
+ * 27 presets including legacy compatibility types.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10.41 (ST_LightRigType)
+ */
+export type LightRigType = 'balanced' | 'brightRoom' | 'chilly' | 'contrasting' | 'flat' | 'flood' | 'freezing' | 'glow' | 'harsh' | 'legacyFlat1' | 'legacyFlat2' | 'legacyFlat3' | 'legacyFlat4' | 'legacyHarsh1' | 'legacyHarsh2' | 'legacyHarsh3' | 'legacyHarsh4' | 'legacyNormal1' | 'legacyNormal2' | 'legacyNormal3' | 'legacyNormal4' | 'morning' | 'soft' | 'sunrise' | 'sunset' | 'threePt' | 'twoPt';
+/**
+ * Light rig direction.
+ *
+ * Specifies from which direction the light illuminates a 3D shape.
+ * Affects shadow positions and highlight locations.
+ * 8 compass directions.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10.40 (ST_LightRigDirection)
+ */
+export type LightRigDirection = 't' | 'tl' | 'tr' | 'l' | 'r' | 'b' | 'bl' | 'br';
+/**
+ * 3D rotation angles in 60,000ths of a degree.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.7.7 (rot)
+ */
+export interface Rotation3D {
+    /** Latitude rotation */
+    lat: number;
+    /** Longitude rotation */
+    lon: number;
+    /** Revolution rotation */
+    rev: number;
+}
+/**
+ * Camera settings defining the viewing angle for a 3D scene.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.5.7 (camera)
+ */
+export interface Camera {
+    /** Camera preset type */
+    prst: PresetCameraType;
+    /** Field of view in 60,000ths of a degree (perspective cameras only) */
+    fov?: number;
+    /** Camera rotation angles */
+    rot?: Rotation3D;
+}
+/**
+ * Light rig settings defining illumination for a 3D scene.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.5.8 (lightRig)
+ */
+export interface LightRig {
+    /** Light rig preset type */
+    rig: LightRigType;
+    /** Light direction */
+    dir: LightRigDirection;
+    /** Light rotation angles */
+    rot?: Rotation3D;
+}
+/**
+ * 3D scene definition for perspective and lighting.
+ *
+ * Defines the camera position and lighting setup for 3D-style
+ * rendering. Used in style definitions to apply 3D effects to shapes.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.5.1 (scene3d)
+ */
+export interface Scene3D {
+    /** Camera settings defining the viewing angle */
+    camera: Camera;
+    /** Light rig settings defining illumination */
+    lightRig: LightRig;
+}
+/**
+ * Bevel effect for a 3D shape edge.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.5.3 (bevelT) and 20.1.5.4 (bevelB)
+ */
+export interface Bevel {
+    /** Bevel width in EMUs */
+    w?: number;
+    /** Bevel height in EMUs */
+    h?: number;
+    /** Bevel preset type */
+    prst?: BevelPresetType;
+}
+/**
+ * Color reference for 3D effects (extrusion color, contour color).
+ *
+ * Supports multiple color specification modes from DrawingML.
+ * The `type` field is optional to allow structural compatibility
+ * with domain-specific color types (e.g., SmartArt SchemeColor).
+ *
+ * @see ECMA-376 Part 1, Section 20.1.2.3 (Color)
+ */
+export interface ColorRef {
+    /** Color specification type */
+    type?: 'schemeClr' | 'srgbClr' | 'hslClr' | 'sysClr' | 'prstClr';
+    /** Color value (scheme name, hex RGB, preset name, etc.) */
+    val: string;
+    /** Hue component (for hslClr) */
+    hue?: number;
+    /** Saturation component (for hslClr) */
+    sat?: number;
+    /** Luminance component (for hslClr) */
+    lum?: number;
+}
+/**
+ * 3D shape properties for individual shapes.
+ *
+ * Defines per-shape 3D effects including bevels, extrusion, contours,
+ * and material. Applied on top of the scene-level 3D settings.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.5.12 (sp3d)
+ */
+export interface Shape3D {
+    /** Top bevel effect */
+    bevelT?: Bevel;
+    /** Bottom bevel effect */
+    bevelB?: Bevel;
+    /** Extrusion height in EMUs */
+    extrusionH?: number;
+    /** Extrusion color */
+    extrusionClr?: ColorRef;
+    /** Contour width in EMUs */
+    contourW?: number;
+    /** Contour color */
+    contourClr?: ColorRef;
+    /** Preset material type affecting surface reflectivity */
+    prstMaterial?: PresetMaterialType;
+    /** Z offset in EMUs */
+    z?: number;
+}
+//# sourceMappingURL=three-d.d.ts.map

package/dist/drawing/three-d.d.ts.map

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

package/dist/editor/drag.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Drag & Drop Types
+ *
+ * Types for cell drag-drop operations (move/copy cells via dragging).
+ * Part of Stream C4: UI Micro-Polish.
+ *
+ * @see plans/active/detailed-parity-implementation/STREAM-C4-UI-POLISH.md
+ */
+import type { CellRange, SheetId } from '../core/core';
+/**
+ * Mode of the drag operation.
+ * - 'move': Cut and paste (default, removes source)
+ * - 'copy': Copy and paste (Ctrl held, keeps source)
+ */
+export type DragMode = 'move' | 'copy';
+/**
+ * Cell coordinate for drag operations.
+ */
+export interface DragCellCoord {
+    row: number;
+    col: number;
+}
+/**
+ * Context for an active cell drag operation.
+ * Stored in selection machine context during drag.
+ */
+export interface DragCellsContext {
+    /** Source range being dragged */
+    sourceRange: CellRange;
+    /** Current target cell (top-left of drop location) */
+    targetCell: DragCellCoord | null;
+    /** Drag mode: move (default) or copy (Ctrl held) */
+    mode: DragMode;
+    /** Offset from mouse position to range top-left (for visual ghost positioning) */
+    dragOffset: {
+        rows: number;
+        cols: number;
+    };
+}
+/**
+ * Options for Insert Cells operation.
+ * Excel behavior: when inserting cells (not full rows/cols), user chooses shift direction.
+ */
+export interface InsertCellsOptions {
+    /** Range where cells will be inserted */
+    range: CellRange;
+    /** Direction to shift existing cells */
+    direction: 'right' | 'down';
+}
+/**
+ * Result of an insert cells operation.
+ */
+export interface InsertCellsResult {
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Error message if failed (e.g., merge conflict) */
+    error?: string;
+    /** Number of cells shifted */
+    cellsShifted?: number;
+}
+/**
+ * Visual state for rendering drag feedback.
+ * Passed to UI layer for ghost/indicator rendering.
+ */
+export interface DragVisualState {
+    /** Is drag currently active? */
+    active: boolean;
+    /** Source range being dragged */
+    sourceRange: CellRange | null;
+    /** Current drop target (top-left cell) */
+    dropTarget: DragCellCoord | null;
+    /** Drag mode for visual indication */
+    mode: DragMode;
+    /** Mouse position relative to canvas (for ghost positioning) */
+    mousePosition: {
+        x: number;
+        y: number;
+    } | null;
+}
+/**
+ * State for cell overflow tooltip.
+ */
+export interface CellTooltipState {
+    /** Cell being hovered */
+    cell: DragCellCoord;
+    /** Full content of the clipped cell */
+    content: string;
+    /** Position to show tooltip (screen coordinates) */
+    position: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Event emitted when cells are inserted (partial range shift).
+ * Note: This is different from RowsInsertedEvent/ColumnsInsertedEvent
+ * which affect entire rows/columns.
+ */
+export interface CellsInsertedEvent {
+    type: 'cells:inserted';
+    timestamp: number;
+    /** Sheet where cells were inserted */
+    sheetId: SheetId;
+    /** Range where cells were inserted */
+    range: CellRange;
+    /** Direction cells were shifted */
+    direction: 'right' | 'down';
+    /** Source of the operation */
+    source: 'user' | 'api';
+}
+/**
+ * Event emitted when cells are deleted (partial range shift).
+ */
+export interface CellsDeletedEvent {
+    type: 'cells:deleted';
+    timestamp: number;
+    /** Sheet where cells were deleted */
+    sheetId: SheetId;
+    /** Range where cells were deleted */
+    range: CellRange;
+    /** Direction remaining cells were shifted */
+    direction: 'left' | 'up';
+    /** Source of the operation */
+    source: 'user' | 'api';
+}
+/**
+ * Event emitted when cells are moved via drag-drop.
+ */
+export interface CellsMovedEvent {
+    type: 'cells:moved';
+    timestamp: number;
+    /** Sheet ID */
+    sheetId: SheetId;
+    /** Original source range */
+    sourceRange: CellRange;
+    /** Target range after move */
+    targetRange: CellRange;
+    /** Source of the operation */
+    source: 'user' | 'api';
+}
+/**
+ * Event emitted when cells are copied via drag-drop (Ctrl+drag).
+ */
+export interface CellsCopiedEvent {
+    type: 'cells:copied';
+    timestamp: number;
+    /** Sheet ID */
+    sheetId: SheetId;
+    /** Source range (unchanged) */
+    sourceRange: CellRange;
+    /** Target range after copy */
+    targetRange: CellRange;
+    /** Source of the operation */
+    source: 'user' | 'api';
+}
+/**
+ * Type of header resize operation.
+ */
+export type HeaderResizeType = 'column' | 'row';
+/**
+ * State for an active header resize operation.
+ * Stored in selection machine context during drag.
+ */
+export interface HeaderResizeState {
+    /** Type of resize (column or row) */
+    type: HeaderResizeType;
+    /** Index of the column or row being resized */
+    index: number;
+    /** Starting position of the resize (screen coordinates) */
+    startPosition: number;
+    /** Starting size of the column/row (in pixels) */
+    startSize: number;
+    /** Current size during resize (in pixels) */
+    currentSize: number;
+    /** Minimum allowed size */
+    minSize: number;
+}
+//# sourceMappingURL=drag.d.ts.map

package/dist/editor/drag.d.ts.map

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

package/dist/editor/editor.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Cell Editor Types
+ *
+ * Types for determining the appropriate editor/picker for a cell based on its schema.
+ * Used by the editor state machine to render the correct input control.
+ *
+ * @module contracts/editor
+ */
+import type { CellSchema } from '../core/schema';
+/**
+ * Types of cell editors/pickers that can be rendered.
+ *
+ * The editor type determines what input control to show when a cell is edited.
+ * This is resolved from the cell's schema by resolveEditorType() in compute-schema (Rust).
+ */
+export type CellEditorType = 'text' | 'dropdown' | 'date' | 'time' | 'color' | 'checkbox' | 'slider' | 'calculator';
+/**
+ * Context provided to the editor for schema-aware editing.
+ *
+ * This is stored in the editor machine's context and used for:
+ * - Determining which picker to render
+ * - Validating input on commit
+ * - Providing dropdown items for enum constraints
+ */
+export interface CellEditorContext {
+    /** The resolved editor type for this cell */
+    editorType: CellEditorType;
+    /** The cell's schema (if any) for validation/dropdown items */
+    cellSchema: CellSchema | null;
+    /** Resolved enum items for dropdown (from static enum or enumSource) */
+    enumItems: unknown[] | null;
+}
+/**
+ * Input for resolving editor type from schema.
+ *
+ * The resolver function takes a cell's schema and optional context
+ * to determine the appropriate editor type.
+ */
+export interface EditorTypeResolutionInput {
+    /** The cell's schema (undefined if no schema applied) */
+    schema?: CellSchema;
+    /**
+     * Resolved enum items for enumSource constraints.
+     * Must be provided externally since enumSource requires cell lookups.
+     */
+    resolvedEnumItems?: unknown[];
+}
+/**
+ * Result of editor type resolution.
+ */
+export interface EditorTypeResolutionResult {
+    /** The resolved editor type */
+    editorType: CellEditorType;
+    /** Enum items to display (for dropdown type) */
+    enumItems: unknown[] | null;
+    /** Whether the schema requires validation on commit */
+    requiresValidation: boolean;
+}
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/editor/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMjD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,UAAU,GACV,QAAQ,GACR,YAAY,CAAC;AAEjB;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,UAAU,EAAE,cAAc,CAAC;IAE3B,+DAA+D;IAC/D,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAE9B,wEAAwE;IACxE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,yDAAyD;IACzD,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,+BAA+B;IAC/B,UAAU,EAAE,cAAc,CAAC;IAE3B,gDAAgD;IAChD,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE5B,uDAAuD;IACvD,kBAAkB,EAAE,OAAO,CAAC;CAC7B"}