@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/views/types.d.ts

@@ -0,0 +1,161 @@
+/**
+ * View Types
+ *
+ * Pure type definitions for the view system (grid, kanban, timeline, etc.).
+ * These contracts enable the coordinator to manage views without depending
+ * on app-internal view implementations.
+ *
+ * NOTE: ViewAdapter and ViewAdapterConfig from the app's views/types.ts
+ * reference ClipboardPayload and other app-internal types. Only the types
+ * that have no app-internal dependencies are included here.
+ *
+ * @module @mog/spreadsheet-contracts/views
+ */
+import type { ColId } from '../cells/cell-identity';
+import type { CellFormat } from '../core';
+/** Discriminated union of supported view types. */
+export type ViewType = 'grid' | 'kanban' | 'timeline' | 'calendar' | 'gallery' | 'form';
+/** Branded string type for view identifiers. */
+export type ViewId = string & {
+    readonly __brand: 'ViewId';
+};
+/** Identifier for a table backing a view. */
+export type TableId = string;
+/** Cleanup function returned by subscription methods. */
+export type Unsubscribe = () => void;
+/** Opaque type for what the user is editing within a view. */
+export type EditTarget = unknown;
+/**
+ * Column type kinds supported by the system.
+ * Used in ViewColumnSchema for type-aware paste and column rendering.
+ *
+ * NOTE: This is distinct from CellSchemaType in core/schema.ts which describes
+ * cell-level data validation types. ColumnTypeKind describes high-level column
+ * semantics for view rendering and clipboard operations.
+ */
+export type ColumnTypeKind = 'text' | 'number' | 'date' | 'select' | 'checkbox' | 'person' | 'file' | 'url' | 'email' | 'phone' | 'rating' | 'progress' | 'relation' | 'lookup' | 'rollup' | 'formula' | 'createdTime' | 'modifiedTime' | 'createdBy' | 'modifiedBy' | 'autoNumber';
+/**
+ * Select option for select/multi-select columns.
+ */
+export interface SelectOption {
+    id: string;
+    label: string;
+    color?: string;
+}
+/**
+ * Column schema information for type-aware paste and view rendering.
+ *
+ * NOTE: This is distinct from ColumnSchema in core/schema.ts which describes
+ * cell-level validation schemas. This ColumnSchema describes column metadata
+ * for view-layer operations (clipboard, rendering, form fields).
+ * Import from '@mog/spreadsheet-contracts/views' to disambiguate.
+ */
+export interface ColumnSchema {
+    id: ColId;
+    name: string;
+    kind: ColumnTypeKind;
+    required?: boolean;
+    unique?: boolean;
+    /** For select columns: available options */
+    options?: SelectOption[];
+    /** For number columns: format config */
+    numberFormat?: {
+        decimals?: number;
+        prefix?: string;
+        suffix?: string;
+    };
+    /** For date columns: include time */
+    includeTime?: boolean;
+    /** For rating columns: max stars */
+    maxRating?: number;
+    /** For relation columns: target table */
+    targetTableId?: TableId;
+    /** Whether the column is read-only (computed columns) */
+    readOnly?: boolean;
+}
+/** Current selection state within a view. */
+export interface ViewSelection {
+    type: ViewType;
+    data: unknown;
+}
+/**
+ * Describes what toolbar actions are available and their current state
+ * for the active view. The toolbar UI reads this to enable/disable buttons
+ * and show toggle states.
+ */
+export interface ToolbarContext {
+    formatting: {
+        canBold: boolean;
+        canItalic: boolean;
+        canUnderline: boolean;
+        canChangeFont: boolean;
+        canChangeFontSize: boolean;
+        canChangeColor: boolean;
+        canChangeFillColor: boolean;
+        canChangeAlignment: boolean;
+        canChangeBorders: boolean;
+    };
+    state: {
+        isBold: boolean | 'mixed' | null;
+        isItalic: boolean | 'mixed' | null;
+        isUnderline: boolean | 'mixed' | null;
+        fontFamily: string | 'mixed' | null;
+        fontSize: number | 'mixed' | null;
+        textColor: string | 'mixed' | null;
+        fillColor: string | 'mixed' | null;
+        horizontalAlign: 'left' | 'center' | 'right' | 'mixed' | null;
+        verticalAlign: 'top' | 'middle' | 'bottom' | 'mixed' | null;
+    };
+    structure: {
+        canInsertRow: boolean;
+        canDeleteRow: boolean;
+        canInsertColumn: boolean;
+        canDeleteColumn: boolean;
+        canMerge: boolean;
+        canUnmerge: boolean;
+        canSort: boolean;
+        canFilter: boolean;
+    };
+    selection: {
+        hasSelection: boolean;
+        selectionCount: number;
+        selectionLabel: string;
+    };
+}
+/**
+ * Minimal interface for a view adapter.
+ *
+ * Each view type (grid, kanban, etc.) implements this interface so the
+ * coordinator can manage views uniformly. The full ViewAdapter in the app
+ * extends this with clipboard and other app-specific methods.
+ */
+export interface IViewAdapter {
+    readonly viewId: ViewId;
+    readonly viewType: ViewType;
+    getSelection(): ViewSelection;
+    clearSelection(): void;
+    selectAll(): void;
+    onSelectionChange(listener: (selection: ViewSelection) => void): Unsubscribe;
+    isEditing(): boolean;
+    startEdit(target: EditTarget): void;
+    commitEdit(): Promise<void>;
+    cancelEdit(): void;
+    getToolbarContext(): ToolbarContext;
+    onToolbarContextChange(listener: (ctx: ToolbarContext) => void): Unsubscribe;
+    handleKeyboard(event: KeyboardEvent): boolean;
+    applyFormatting(format: Partial<CellFormat>): void;
+    mount(container: HTMLElement): void;
+    unmount(): void;
+    dispose(): void;
+}
+/**
+ * Registry for view type factories.
+ * The shell uses this to discover available view types and create adapters.
+ */
+export interface IViewRegistry {
+    get(viewType: ViewType): unknown | undefined;
+    list(): ViewType[];
+    has(viewType: ViewType): boolean;
+    createAdapter(viewType: ViewType, config: unknown): IViewAdapter;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/what-if/index.d.ts

@@ -0,0 +1,2 @@
+export * from './what-if';
+//# sourceMappingURL=index.d.ts.map

package/dist/what-if/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/what-if/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/what-if/what-if.d.ts

@@ -0,0 +1,152 @@
+/**
+ * What-If Analysis Types
+ *
+ * Types for Goal Seek and Data Tables - features that explore hypothetical
+ * scenarios by evaluating formulas with different input values without
+ * actually modifying the spreadsheet.
+ *
+ * @see plans/active/excel-parity/WHAT-IF-ANALYSIS.md
+ */
+import type { CellId } from '../cells/cell-identity';
+import type { CellValue } from '../core/core';
+/**
+ * Parameters for Goal Seek algorithm.
+ *
+ * Goal Seek finds a value for the changing cell that makes the target cell
+ * equal to the target value. It uses an iterative numerical method.
+ */
+export interface GoalSeekParams {
+    /**
+     * Function that evaluates the target cell given a value for the changing cell.
+     * This function is called repeatedly during the search.
+     *
+     * @param x - The hypothetical value for the changing cell
+     * @returns The resulting value of the target cell
+     */
+    evaluate: (x: number) => number;
+    /**
+     * The target value we want the target cell to reach.
+     */
+    target: number;
+    /**
+     * Initial guess for the changing cell value.
+     * A good initial guess can speed up convergence.
+     */
+    initialGuess: number;
+    /**
+     * Maximum number of iterations before giving up.
+     * @default 100
+     */
+    maxIterations?: number;
+    /**
+     * Precision threshold - stop when |f(x) - target| < precision.
+     * @default 0.00001
+     */
+    precision?: number;
+    /**
+     * Maximum allowed change per iteration (prevents divergence).
+     * @default 1000000
+     */
+    maxChange?: number;
+}
+/**
+ * Result of Goal Seek operation.
+ */
+export interface GoalSeekResult {
+    /**
+     * Whether a solution was found within the precision threshold.
+     */
+    found: boolean;
+    /**
+     * The value for the changing cell that achieves the target (if found).
+     */
+    solutionValue?: number;
+    /**
+     * The actual value achieved in the target cell.
+     * May differ from target if solution was approximate.
+     */
+    achievedValue?: number;
+    /**
+     * Number of iterations performed.
+     */
+    iterations: number;
+    /**
+     * Error type if solution was not found.
+     */
+    error?: 'no_solution' | 'diverged' | 'non_numeric' | 'max_iterations';
+    /**
+     * Human-readable error message.
+     */
+    errorMessage?: string;
+}
+/**
+ * Parameters for Data Table operation.
+ *
+ * Data Tables evaluate a formula with different input values and display
+ * the results in a grid. Supports one-variable and two-variable tables.
+ *
+ * One-variable table: Either rowInputCellId or colInputCellId is set (not both)
+ * Two-variable table: Both rowInputCellId and colInputCellId are set
+ */
+export interface DataTableParams {
+    /**
+     * The cell containing the formula to evaluate.
+     */
+    formulaCellId: CellId;
+    /**
+     * The input cell to substitute with row header values.
+     * For one-variable tables with horizontal layout, or two-variable tables.
+     * null for one-variable tables with vertical layout.
+     */
+    rowInputCellId: CellId | null;
+    /**
+     * The input cell to substitute with column header values.
+     * For one-variable tables with vertical layout, or two-variable tables.
+     * null for one-variable tables with horizontal layout.
+     */
+    colInputCellId: CellId | null;
+    /**
+     * Values to substitute for the row input cell.
+     * These become the row headers in the result.
+     */
+    rowValues: CellValue[];
+    /**
+     * Values to substitute for the column input cell.
+     * These become the column headers in the result.
+     */
+    colValues: CellValue[];
+    /**
+     * Progress callback for large tables.
+     * @param percent - Progress percentage (0-100)
+     */
+    onProgress?: (percent: number) => void;
+    /**
+     * AbortSignal for cancellation support.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Result of Data Table operation.
+ */
+export interface DataTableResult {
+    /**
+     * 2D array of computed results.
+     * results[rowIndex][colIndex] is the value when:
+     * - rowInputCell = rowValues[rowIndex]
+     * - colInputCell = colValues[colIndex]
+     */
+    results: CellValue[][];
+    /**
+     * Total number of cells computed.
+     */
+    cellCount: number;
+    /**
+     * Time taken in milliseconds.
+     */
+    elapsedMs: number;
+    /**
+     * Whether the operation was cancelled.
+     */
+    cancelled?: boolean;
+}
+//# sourceMappingURL=what-if.d.ts.map

package/dist/what-if/what-if.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"what-if.d.ts","sourceRoot":"","sources":["../../src/what-if/what-if.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM9C;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAEhC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,GAAG,UAAU,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAEtE;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,SAAS,EAAE,SAAS,EAAE,CAAC;IAEvB;;;OAGG;IACH,SAAS,EAAE,SAAS,EAAE,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEvC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC;IAEvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/window-manager/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Window Manager Contracts
+ *
+ * The Window Manager owns:
+ * - Focus management (which app/pane has keyboard focus)
+ * - Keyboard routing (Cmd+C → focused app)
+ * - Pane layout (future: splits, tabs)
+ *
+ * This follows the true OS analogy: Window Manager is separate from Shell.
+ *
+ * @see plans/active/os-refactor/CLEAN-OS-ARCHITECTURE.md
+ */
+/**
+ * App focus state.
+ */
+export interface AppFocusState {
+    /** Currently focused app ID */
+    focusedAppId: string;
+    /** Focus stack for nested focus (dialogs, etc.) */
+    focusStack: string[];
+}
+/**
+ * Pane layout configuration (future use).
+ */
+export interface PaneLayout {
+    /** Layout type */
+    type: 'single' | 'horizontal-split' | 'vertical-split' | 'grid';
+    /** Pane configurations (for split/grid layouts) */
+    panes?: PaneConfig[];
+}
+/**
+ * Individual pane configuration (future use).
+ */
+export interface PaneConfig {
+    /** Unique pane ID */
+    id: string;
+    /** App ID rendered in this pane */
+    appId: string;
+    /** Size ratio (0-1) */
+    size: number;
+}
+/**
+ * Keyboard event that can be routed to apps.
+ */
+export interface RoutableKeyboardEvent {
+    /** Key being pressed */
+    key: string;
+    /** Key code (for special keys) */
+    code: string;
+    /** Modifier keys */
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+}
+/**
+ * Global shortcuts that should work regardless of focus state.
+ * These are critical operations that must always be available.
+ */
+export declare const GLOBAL_SHORTCUTS: Set<string>;
+/**
+ * Window Manager interface.
+ *
+ * Handles focus and keyboard routing to apps.
+ * Shell/Apps receive keyboard events when focused.
+ */
+export interface IWindowManager {
+    /** Currently focused app ID (read-only) */
+    readonly focusedAppId: string;
+    /**
+     * Request focus for an app.
+     * @param appId - App to focus
+     */
+    requestFocus(appId: string): void;
+    /**
+     * Push focus onto the stack (for dialogs, overlays).
+     * @param focusId - Focus layer ID
+     */
+    pushFocus(focusId: string): void;
+    /**
+     * Pop focus from the stack (when dialog closes).
+     */
+    popFocus(): void;
+    /**
+     * Reset focus to the base app.
+     */
+    resetFocus(): void;
+    /**
+     * Check if an app has focus.
+     * @param appId - App to check
+     */
+    hasFocus(appId: string): boolean;
+    /**
+     * Route a keyboard event to the focused app.
+     *
+     * Returns true if the event was handled by an app,
+     * false if it should propagate.
+     *
+     * @param event - Keyboard event to route
+     */
+    routeKeyboardEvent(event: RoutableKeyboardEvent): boolean;
+    /**
+     * Register a keyboard handler for an app.
+     *
+     * @param appId - App ID
+     * @param handler - Handler function, returns true if handled
+     */
+    registerKeyboardHandler(appId: string, handler: (event: RoutableKeyboardEvent) => boolean): () => void;
+    /**
+     * Get current pane layout.
+     */
+    getLayout(): PaneLayout;
+    /**
+     * Split the current pane.
+     * @param direction - Split direction
+     */
+    splitPane(direction: 'horizontal' | 'vertical'): void;
+    /**
+     * Close a pane.
+     * @param paneId - Pane to close
+     */
+    closePane(paneId: string): void;
+    /**
+     * Subscribe to focus changes.
+     * @param handler - Called when focus changes
+     */
+    onFocusChange(handler: (focusedAppId: string) => void): () => void;
+    /**
+     * Subscribe to layout changes.
+     * @param handler - Called when layout changes
+     */
+    onLayoutChange(handler: (layout: PaneLayout) => void): () => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/window-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/window-manager/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,QAAQ,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,MAAM,CAAC;IAChE,mDAAmD;IACnD,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAW3B,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAK7B,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAMjC;;;;;;;OAOG;IACH,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAE1D;;;;;OAKG;IACH,uBAAuB,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,GACjD,MAAM,IAAI,CAAC;IAMd;;OAEG;IACH,SAAS,IAAI,UAAU,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,YAAY,GAAG,UAAU,GAAG,IAAI,CAAC;IAEtD;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAMhC;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEnE;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnE"}