@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/editor/form-controls.d.ts

@@ -0,0 +1,428 @@
+/**
+ * Form Controls Contracts
+ *
+ * Type definitions for interactive form controls (Checkbox, Button, ComboBox)
+ * that overlay the cell grid and read/write values from linked cells.
+ *
+ * Architecture Notes:
+ * - Form controls are UI widgets for cells, NOT independent data stores
+ * - The linked cell is the SINGLE SOURCE OF TRUTH for control values
+ * - Controls READ from cell at render time, WRITE to cell on interaction
+ * - This eliminates sync loops and makes undo/collaboration automatic
+ *
+ * Cell Identity Model:
+ * - `anchor.cellId` uses CellId for stable positioning (survives row/col changes)
+ * - `linkedCellId` uses CellId for stable value binding (survives row/col changes)
+ * - Position/value resolution happens at render time via CellPositionLookup
+ *
+ * Rendering:
+ * - Form controls render as HTML overlays (React portals), NOT canvas
+ * - This enables native accessibility (keyboard nav, screen readers)
+ * - Follows same pattern as in-cell editor overlay
+ *
+ * @see plans/parity/Issue-3-INSERT-OBJECTS.md
+ */
+import type { CellId, IdentityRangeRef } from '../cells/cell-identity';
+import type { CellAnchor } from '../objects/floating-objects';
+/**
+ * Form control type discriminator.
+ * Used for type narrowing in union types.
+ *
+ * Supported types:
+ * - 'checkbox': Boolean toggle linked to cell (TRUE/FALSE)
+ * - 'button': Click action with optional cell write
+ * - 'comboBox': Dropdown selection with cell-stored index
+ *
+ * Future types (not yet implemented):
+ * - 'radioButton': Group of mutually exclusive options
+ * - 'slider': Numeric range control (different from schema slider)
+ * - 'spinner': Numeric increment/decrement control
+ */
+export type FormControlType = 'checkbox' | 'button' | 'comboBox' | 'radioButton' | 'slider' | 'spinner';
+/**
+ * Base interface for all form controls.
+ * Contains common properties shared by all control types.
+ */
+export interface FormControlBase {
+    /** Unique identifier (UUID) */
+    id: string;
+    /** Control type discriminator */
+    type: FormControlType;
+    /** Sheet containing the control */
+    sheetId: string;
+    /**
+     * Position anchor - uses CellId per Cell Identity Model.
+     * Control position updates automatically when anchor cell moves.
+     */
+    anchor: CellAnchor;
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+    /** Whether the control is enabled (interactive) */
+    enabled: boolean;
+    /** Optional name for the control (shown in selection, used in scripts) */
+    name?: string;
+    /** Z-order for overlapping controls (higher = on top) */
+    zIndex: number;
+    /** Created timestamp (Unix ms) */
+    createdAt?: number;
+    /** Last modified timestamp (Unix ms) */
+    updatedAt?: number;
+}
+/**
+ * Checkbox control - reads/writes boolean to linked cell.
+ *
+ * NO local "checked" state - value lives in cell.
+ * This is critical for single source of truth.
+ *
+ * Data flow:
+ * 1. Render: Read from cell → `checked = store.getCellValueById(linkedCellId) === true`
+ * 2. Click: Write to cell → `store.setCellValueById(linkedCellId, !checked)`
+ * 3. EventBus fires → component re-renders with new value
+ *
+ * @example
+ * // Cell A1 contains TRUE/FALSE
+ * // Checkbox linked to A1
+ * // Formula =IF(A1, "Yes", "No") works automatically
+ */
+export interface CheckboxControl extends FormControlBase {
+    type: 'checkbox';
+    /**
+     * REQUIRED - Cell that holds the boolean value.
+     * Uses CellId for stability across row/col insert/delete.
+     *
+     * Expected cell values:
+     * - TRUE, true, 1 → checked
+     * - FALSE, false, 0, empty → unchecked
+     */
+    linkedCellId: CellId;
+    /** Optional label displayed next to checkbox */
+    label?: string;
+    /**
+     * Value to write when checked.
+     * Default: true (boolean TRUE)
+     */
+    checkedValue?: unknown;
+    /**
+     * Value to write when unchecked.
+     * Default: false (boolean FALSE)
+     */
+    uncheckedValue?: unknown;
+}
+/**
+ * Button control - triggers actions on click.
+ *
+ * Unlike other controls, Button's primary purpose is triggering actions,
+ * not storing values. linkedCellId is optional.
+ *
+ * Use cases:
+ * - Increment a counter cell on click
+ * - Trigger a macro/script (via actionId)
+ * - Navigate to another sheet/location
+ */
+export interface ButtonControl extends FormControlBase {
+    type: 'button';
+    /** Button label text */
+    label: string;
+    /**
+     * Optional - Cell to write to on click.
+     * Common patterns:
+     * - Increment counter: read current value, write value + 1
+     * - Toggle: write opposite of current value
+     * - Fixed value: write specific value (e.g., timestamp)
+     */
+    linkedCellId?: CellId;
+    /**
+     * Action ID for future macro/script integration.
+     * Will be used to trigger named actions defined elsewhere.
+     */
+    actionId?: string;
+    /**
+     * Value to write to linked cell on click.
+     * Only used if linkedCellId is set and clickAction is 'setValue'.
+     */
+    clickValue?: unknown;
+    /**
+     * Click behavior when linkedCellId is set.
+     * - 'setValue': Write clickValue to cell
+     * - 'increment': Add 1 to current numeric value
+     * - 'decrement': Subtract 1 from current numeric value
+     * - 'toggle': Toggle boolean value
+     */
+    clickAction?: 'setValue' | 'increment' | 'decrement' | 'toggle';
+}
+/**
+ * ComboBox control - dropdown selection linked to cell.
+ *
+ * NO local "selectedIndex" state - value lives in cell.
+ * Cell stores the selected VALUE (string), not the index.
+ *
+ * Data flow:
+ * 1. Render: Read from cell → find matching item index
+ * 2. Select: Write to cell → `store.setCellValueById(linkedCellId, selectedItem)`
+ * 3. EventBus fires → component re-renders with new selection
+ *
+ * Items can be:
+ * - Static: `items: ['Option A', 'Option B', 'Option C']`
+ * - Dynamic: `itemsSourceRef: { startId: 'abc', endId: 'xyz' }` (range of cells)
+ */
+export interface ComboBoxControl extends FormControlBase {
+    type: 'comboBox';
+    /**
+     * REQUIRED - Cell that holds the selected value.
+     * Uses CellId for stability across row/col insert/delete.
+     *
+     * Stores the selected item VALUE (string), not index.
+     * This makes formulas like =VLOOKUP(A1, ...) work naturally.
+     */
+    linkedCellId: CellId;
+    /**
+     * Static items list.
+     * Use this for fixed options that don't change.
+     */
+    items?: string[];
+    /**
+     * Dynamic items from a cell range.
+     * Uses IdentityRangeRef (CellId-based) for stability.
+     * Range values are read at render time.
+     *
+     * If both `items` and `itemsSourceRef` are set, `itemsSourceRef` takes precedence.
+     */
+    itemsSourceRef?: IdentityRangeRef;
+    /**
+     * Placeholder text when no value is selected.
+     */
+    placeholder?: string;
+    /**
+     * Whether to allow typing to filter items.
+     * Default: true
+     */
+    filterable?: boolean;
+}
+/**
+ * Radio button control - one of multiple mutually exclusive options.
+ *
+ * Part of a radio group identified by `groupName`.
+ * Only one radio in a group can be selected at a time.
+ *
+ * NOT YET IMPLEMENTED
+ */
+export interface RadioButtonControl extends FormControlBase {
+    type: 'radioButton';
+    /**
+     * Cell that holds the selected value for this radio group.
+     * All radios in the same group share this linkedCellId.
+     */
+    linkedCellId: CellId;
+    /** Group name - radios with same group are mutually exclusive */
+    groupName: string;
+    /** Value written to cell when this radio is selected */
+    value: unknown;
+    /** Label displayed next to radio button */
+    label?: string;
+}
+/**
+ * Slider control - numeric range selection.
+ *
+ * Different from schema-based slider (which is an in-cell editor).
+ * This is a standalone form control that can be placed anywhere.
+ *
+ * NOT YET IMPLEMENTED
+ */
+export interface SliderControl extends FormControlBase {
+    type: 'slider';
+    /** Cell that holds the numeric value */
+    linkedCellId: CellId;
+    /** Minimum value */
+    min: number;
+    /** Maximum value */
+    max: number;
+    /** Step increment */
+    step: number;
+    /** Whether to show current value label */
+    showValue?: boolean;
+    /** Orientation */
+    orientation?: 'horizontal' | 'vertical';
+}
+/**
+ * Spinner control - numeric increment/decrement.
+ *
+ * NOT YET IMPLEMENTED
+ */
+export interface SpinnerControl extends FormControlBase {
+    type: 'spinner';
+    /** Cell that holds the numeric value */
+    linkedCellId: CellId;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Step increment */
+    step: number;
+}
+/**
+ * Union of all implemented form control types.
+ *
+ * Currently: Checkbox, Button, ComboBox
+ * Future: RadioButton, Slider, Spinner
+ */
+export type FormControl = CheckboxControl | ButtonControl | ComboBoxControl;
+/**
+ * Union of all form control types (including future).
+ */
+export type FormControlAny = CheckboxControl | ButtonControl | ComboBoxControl | RadioButtonControl | SliderControl | SpinnerControl;
+/**
+ * Options for creating a checkbox control.
+ */
+export interface CreateCheckboxOptions {
+    /** Sheet to create in */
+    sheetId: string;
+    /** Anchor position (row, col, offsets) - converted to CellId internally */
+    anchor: {
+        row: number;
+        col: number;
+        xOffset?: number;
+        yOffset?: number;
+    };
+    /** Cell to link (row, col) - converted to CellId internally */
+    linkedCell: {
+        row: number;
+        col: number;
+    };
+    /** Optional label */
+    label?: string;
+    /** Optional size override */
+    width?: number;
+    height?: number;
+}
+/**
+ * Options for creating a button control.
+ */
+export interface CreateButtonOptions {
+    /** Sheet to create in */
+    sheetId: string;
+    /** Anchor position */
+    anchor: {
+        row: number;
+        col: number;
+        xOffset?: number;
+        yOffset?: number;
+    };
+    /** Button label */
+    label: string;
+    /** Optional linked cell for value write */
+    linkedCell?: {
+        row: number;
+        col: number;
+    };
+    /** Click action type */
+    clickAction?: 'setValue' | 'increment' | 'decrement' | 'toggle';
+    /** Value to write on click (for setValue action) */
+    clickValue?: unknown;
+    /** Optional size override */
+    width?: number;
+    height?: number;
+}
+/**
+ * Options for creating a comboBox control.
+ */
+export interface CreateComboBoxOptions {
+    /** Sheet to create in */
+    sheetId: string;
+    /** Anchor position */
+    anchor: {
+        row: number;
+        col: number;
+        xOffset?: number;
+        yOffset?: number;
+    };
+    /** Cell to link for selected value */
+    linkedCell: {
+        row: number;
+        col: number;
+    };
+    /** Static items list */
+    items?: string[];
+    /** Dynamic items source range (row/col based, converted to CellId) */
+    itemsSource?: {
+        startRow: number;
+        startCol: number;
+        endRow: number;
+        endCol: number;
+    };
+    /** Placeholder text */
+    placeholder?: string;
+    /** Optional size override */
+    width?: number;
+    height?: number;
+}
+/**
+ * Form Control Manager interface.
+ *
+ * Provides CRUD operations for form controls with Yjs backing.
+ * Does NOT store control values - values live in linked cells.
+ */
+export interface IFormControlManager {
+    /**
+     * Create a checkbox control.
+     * Converts position-based anchors/links to CellId-based references.
+     */
+    createCheckbox(options: CreateCheckboxOptions): Promise<CheckboxControl>;
+    /**
+     * Create a button control.
+     */
+    createButton(options: CreateButtonOptions): Promise<ButtonControl>;
+    /**
+     * Create a comboBox control.
+     */
+    createComboBox(options: CreateComboBoxOptions): Promise<ComboBoxControl>;
+    /**
+     * Get a form control by ID.
+     */
+    getControl(controlId: string): FormControl | undefined;
+    /**
+     * Get all form controls for a sheet.
+     */
+    getControlsForSheet(sheetId: string): FormControl[];
+    /**
+     * Get all form controls in the document.
+     */
+    getAllControls(): FormControl[];
+    /**
+     * Update a form control's properties.
+     * Does NOT update the linked cell value - use SpreadsheetStore for that.
+     */
+    updateControl(controlId: string, updates: Partial<Omit<FormControl, 'id' | 'type' | 'sheetId'>>): void;
+    /**
+     * Move a control to a new anchor position.
+     */
+    moveControl(controlId: string, newAnchor: {
+        row: number;
+        col: number;
+        xOffset?: number;
+        yOffset?: number;
+    }): Promise<void>;
+    /**
+     * Resize a control.
+     */
+    resizeControl(controlId: string, width: number, height: number): void;
+    /**
+     * Delete a form control.
+     */
+    deleteControl(controlId: string): void;
+    /**
+     * Delete all form controls for a sheet.
+     */
+    deleteControlsForSheet(sheetId: string): void;
+    /**
+     * Check if a linked cell still exists.
+     * Returns true if cell exists, false if deleted.
+     */
+    isLinkedCellValid(controlId: string): boolean;
+    /**
+     * Get controls at a specific position (for hit testing).
+     */
+    getControlsAtPosition(sheetId: string, row: number, col: number): FormControl[];
+}
+//# sourceMappingURL=form-controls.d.ts.map

package/dist/editor/form-controls.d.ts.map

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

package/dist/editor/index.d.ts

@@ -0,0 +1,4 @@
+export * from './drag';
+export * from './editor';
+export * from './form-controls';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/editor/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/equation/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Equation Parse Error Types
+ *
+ * Error types for equation parsing operations (OMML and LaTeX).
+ * These provide structured error information for better diagnostics.
+ *
+ * NOTE: These types are prefixed with "Equation" to avoid naming collision
+ * with the xlsx-parser's ParseError/ParseErrorCode types.
+ */
+export type EquationParseErrorCode = 'INVALID_XML' | 'UNKNOWN_ELEMENT' | 'INVALID_STRUCTURE' | 'MISSING_REQUIRED_CHILD' | 'INVALID_ATTRIBUTE' | 'MAX_DEPTH_EXCEEDED' | 'MAX_LENGTH_EXCEEDED' | 'UNSUPPORTED_LATEX' | 'SYNTAX_ERROR' | 'EMPTY_INPUT';
+export interface EquationParseError {
+    code: EquationParseErrorCode;
+    message: string;
+    /** Position in source (for LaTeX) or element path (for OMML) */
+    location?: string;
+    /** The problematic input fragment */
+    fragment?: string;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/equation/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/equation/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,iBAAiB,GACjB,mBAAmB,GACnB,wBAAwB,GACxB,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,GACrB,mBAAmB,GACnB,cAAc,GACd,aAAa,CAAC;AAElB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/equation/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Equation Module - Barrel Export
+ *
+ * Re-exports all equation-related types, utilities, and constants.
+ *
+ * @see plans/active/excel-parity/equation/01-CONTRACTS-DATA-MODEL.md
+ */
+export * from './errors';
+export * from './omml-ast';
+export * from './templates';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/equation/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}