@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/services/index.d.ts

@@ -0,0 +1,273 @@
+/**
+ * Kernel Services Interfaces
+ *
+ * System services that survive app switches.
+ *
+ * These are the canonical interface definitions for kernel services.
+ * Implementations are in @mog/kernel/services.
+ *
+ * @see plans/active/os-refactor/CLEAN-OS-ARCHITECTURE.md
+ */
+import type { CallableDisposable } from '../core/disposable';
+import type { Result } from '../core/result';
+/** Clipboard operation type */
+export type ClipboardOperation = 'copy' | 'cut' | null;
+/** Clipboard state machine states */
+export type ClipboardState = 'empty' | 'hasCopy' | 'hasCut' | 'pasting';
+/** Kernel clipboard service snapshot for consumers */
+export interface KernelClipboardSnapshot {
+    /** Current state of the clipboard */
+    state: ClipboardState;
+    /** Current operation (copy/cut/null) */
+    operation: ClipboardOperation;
+    /** Whether clipboard has data */
+    hasData: boolean;
+    /** Whether data is stale (source changed) */
+    isStale: boolean;
+    /** Any error message from paste operations */
+    error: string | null;
+}
+/**
+ * CANONICAL clipboard format. All views export TO this, import FROM this.
+ *
+ * Key insight: `cells` is ALWAYS present (universal format).
+ * `tableContext` is OPTIONAL (enables smart paste when available).
+ *
+ * This is 2N translations (each view: export + import), NOT N x N.
+ */
+export interface ClipboardPayload {
+    /**
+     * Cell values as 2D array. ALWAYS present.
+     */
+    cells: {
+        values: unknown[][];
+        formulas?: (string | null)[][];
+        formats?: (Record<string, unknown> | null)[][];
+        rowCount: number;
+        colCount: number;
+    };
+    /**
+     * Present when copying from a table context.
+     */
+    tableContext?: {
+        tableId: string;
+        rowIds: string[];
+        colIds: string[];
+        columnSchemas: unknown[];
+    };
+    /**
+     * Source view information.
+     */
+    source: {
+        viewType: string;
+        viewId: string | null;
+        sheetId: string | null;
+    };
+    /**
+     * Tab-separated values (TSV) for system clipboard.
+     */
+    text: string;
+    /**
+     * HTML table for rich paste into Excel/Google Sheets.
+     */
+    html?: string;
+}
+/** Clipboard service interface */
+export interface IClipboardService {
+    /** Get current clipboard snapshot */
+    getSnapshot(): KernelClipboardSnapshot;
+    /** Get clipboard payload data */
+    getPayload(): ClipboardPayload | null;
+    /** Copy data to clipboard */
+    copy(payload: ClipboardPayload): void;
+    /** Cut data to clipboard */
+    cut(payload: ClipboardPayload): void;
+    /** Start a paste operation */
+    startPaste(): void;
+    /** Complete a paste operation */
+    completePaste(): void;
+    /** Mark paste as failed with error */
+    errorPaste(message: string): void;
+    /** Clear clipboard */
+    clear(): void;
+    /** Mark clipboard as stale (source changed) */
+    markStale(): void;
+    /** Mark clipboard as fresh */
+    markFresh(): void;
+    /** Subscribe to clipboard changes. Returns CallableDisposable — call directly or .dispose() to unsubscribe. */
+    subscribe(listener: (snapshot: KernelClipboardSnapshot) => void): CallableDisposable;
+    /** Cleanup resources */
+    dispose(): void;
+}
+/** Undo stack item metadata */
+export interface UndoStackItem {
+    /** Description of the operation */
+    description: string | null;
+}
+/** Undo service state */
+export interface UndoServiceState {
+    /** Whether undo is available */
+    canUndo: boolean;
+    /** Whether redo is available */
+    canRedo: boolean;
+    /** Number of items in undo stack */
+    undoStackSize: number;
+    /** Number of items in redo stack */
+    redoStackSize: number;
+    /** Description of next undo operation */
+    nextUndoDescription: string | null;
+    /** Description of next redo operation */
+    nextRedoDescription: string | null;
+}
+/** Undo state change event */
+export interface UndoStateChangeEvent {
+    /** Current state */
+    state: UndoServiceState;
+    /** What triggered this change */
+    trigger: 'undo' | 'redo' | 'push' | 'clear' | 'external';
+}
+/**
+ * Typed error enum for undo/redo operations.
+ * Mirrors Rust-style discriminated unions for exhaustive handling.
+ */
+export type UndoError = {
+    type: 'nothing-to-undo';
+} | {
+    type: 'nothing-to-redo';
+} | {
+    type: 'rust-failed';
+    reason: string;
+};
+/** Undo service interface */
+export interface IUndoService {
+    getState(): UndoServiceState;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    getNextUndoDescription(): string | null;
+    getNextRedoDescription(): string | null;
+    undo(): Promise<Result<void, UndoError>>;
+    redo(): Promise<Result<void, UndoError>>;
+    clear(): void;
+    setNextDescription(description: string): void;
+    stopCapturing(): void;
+    /**
+     * Notify the service that a forward mutation was applied.
+     * Refreshes cached undo state from Rust and emits change events.
+     * This is ONLY for forward mutations — never call this for undo/redo operations.
+     */
+    notifyForwardMutation(): Promise<void>;
+    subscribe(listener: (event: UndoStateChangeEvent) => void): CallableDisposable;
+    dispose(): void;
+}
+/** Notification severity levels */
+export type NotificationType = 'info' | 'success' | 'warning' | 'error';
+/** A single notification */
+export interface Notification {
+    /** Unique ID for the notification */
+    id: string;
+    /** Notification type/severity */
+    type: NotificationType;
+    /** Short title (optional) */
+    title?: string;
+    /** Main message content */
+    message: string;
+    /** Timestamp when created */
+    timestamp: number;
+    /** Auto-dismiss after this many ms (null = manual dismiss only) */
+    duration: number | null;
+    /** Whether the notification can be dismissed */
+    dismissible: boolean;
+    /** Optional action button */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+/** Options for creating a notification */
+export interface NotificationOptions {
+    /** Notification type/severity (default: 'info') */
+    type?: NotificationType;
+    /** Short title */
+    title?: string;
+    /** Auto-dismiss duration in ms (default: 5000, null for no auto-dismiss) */
+    duration?: number | null;
+    /** Whether dismissible (default: true) */
+    dismissible?: boolean;
+    /** Optional action button */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+/** Notifications service state */
+export interface NotificationsState {
+    /** Current active notifications (ordered by timestamp, newest first) */
+    notifications: Notification[];
+    /** Maximum number of notifications to show at once */
+    maxVisible: number;
+}
+/** Notifications service interface */
+export interface INotificationsService {
+    getAll(): Notification[];
+    getCount(): number;
+    notify(message: string, options?: NotificationOptions): string;
+    info(message: string, options?: Omit<NotificationOptions, 'type'>): string;
+    success(message: string, options?: Omit<NotificationOptions, 'type'>): string;
+    warning(message: string, options?: Omit<NotificationOptions, 'type'>): string;
+    error(message: string, options?: Omit<NotificationOptions, 'type'>): string;
+    dismiss(id: string): void;
+    dismissAll(): void;
+    subscribe(listener: (notifications: Notification[]) => void): CallableDisposable;
+    dispose(): void;
+}
+/** Query executor service interface (minimal contract) */
+export interface IQueryExecutor {
+    /** Set or replace the external connection resolver */
+    setConnectionResolver(resolver: unknown): void;
+    /** Register a database connection */
+    registerConnection(name: string, config: unknown): void;
+    /** Get a connection by name */
+    getConnection(name: string): {
+        id: string;
+        [key: string]: unknown;
+    } | undefined;
+    /** List all registered connection names */
+    listConnections(): string[];
+    /** Remove a connection by name */
+    removeConnection(name: string): void;
+    /** Execute a query against a database connection */
+    executeQuery(connectionName: string, sql: string, params?: unknown[]): Promise<unknown>;
+    /** Get a cached query result */
+    getCachedResult(cacheKey: string): unknown[][] | undefined;
+    /** Set a cached query result */
+    setCachedResult(cacheKey: string, result: unknown[][], metadata?: unknown): void;
+    /** Build a cache key from query parameters */
+    buildCacheKey(connectionName: string, sql: string, params?: unknown[]): string;
+    /** Invalidate cache entries */
+    invalidateCache(connectionName?: string): void;
+    /** Get cache statistics */
+    getCacheStats(): {
+        size: number;
+        hits: number;
+        misses: number;
+    };
+    /** Register a callback for query completion events */
+    onQueryComplete(callback: (event: unknown) => void): CallableDisposable;
+    /** Dispose the query executor and clean up resources */
+    dispose(): void;
+}
+/**
+ * Kernel services namespace.
+ * These are system services that survive app switches.
+ */
+export interface IKernelServices {
+    /** Cross-app clipboard service */
+    readonly clipboard: IClipboardService;
+    /** Cross-app undo/redo service */
+    readonly undo: IUndoService;
+    /** Cross-app notifications/toast service */
+    readonly notifications: INotificationsService;
+    /** Cross-app query executor service */
+    readonly queryExecutor: IQueryExecutor;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/smartart/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SmartArt Module
+ *
+ * Barrel export for SmartArt types, layouts, and styles.
+ * This module provides all the type definitions needed for SmartArt diagrams.
+ *
+ * @see types.ts - Core SmartArt types (nodes, diagrams, computed layout)
+ * @see layouts.ts - Layout definitions and algorithms (legacy)
+ * @see styles.ts - Quick styles and color themes
+ * @see ooxml-data-model-types.ts - OOXML data model types (points, connections, rich text)
+ * @see ooxml-layout-types.ts - OOXML layout definition types (layout nodes, algorithms, shapes)
+ * @see ooxml-drawing-types.ts - OOXML drawing cache types (pre-rendered shapes)
+ * @see ooxml-algorithm-types.ts - OOXML algorithm parameter types (55 ST_ParameterId values)
+ * @see ooxml-engine-types.ts - OOXML constraint, iteration, and variable types
+ * @see ooxml-style-types.ts - OOXML style label types (colors, styles)
+ */
+export * from './layouts';
+export * from './ooxml-algorithm-types';
+export * from './ooxml-data-model-types';
+export * from './ooxml-drawing-types';
+export * from './ooxml-engine-types';
+export * from './ooxml-layout-types';
+export * from './ooxml-style-types';
+export * from './styles';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/smartart/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/smartart/layouts.d.ts

@@ -0,0 +1,193 @@
+/**
+ * SmartArt Layout Types
+ *
+ * Type definitions for SmartArt layout algorithms and registry.
+ * Layouts define how nodes are positioned and connected within a diagram.
+ *
+ * Architecture Notes:
+ * - SmartArtLayoutDefinition describes layout metadata and constraints
+ * - ILayoutRegistry interface is types-only; implementation lives in engine
+ * - ILayoutAlgorithm defines the contract for layout computation
+ * - LayoutResult uses NodeId branded type for type safety
+ */
+import type { ConnectorType, NodeId, SmartArtCategory, SmartArtShapeType } from './types';
+/**
+ * Layout definition - describes how to render a SmartArt type.
+ *
+ * Each layout definition specifies:
+ * - Metadata (name, description, thumbnail for gallery)
+ * - Constraints (min/max nodes, hierarchy depth, feature support)
+ * - Defaults (shape type, connector type)
+ * - Algorithm to use for positioning
+ */
+export interface SmartArtLayoutDefinition {
+    /** Unique layout identifier (e.g., 'hierarchy/org-chart', 'process/basic-process') */
+    id: string;
+    /** Display name shown in the gallery */
+    name: string;
+    /** Description for gallery tooltip/help text */
+    description: string;
+    /** Category this layout belongs to */
+    category: SmartArtCategory;
+    /** Minimum number of nodes required for this layout */
+    minNodes: number;
+    /** Maximum number of nodes allowed (null = unlimited) */
+    maxNodes: number | null;
+    /** Maximum hierarchy depth (levels) supported */
+    maxLevels: number;
+    /** Whether nodes can have children (hierarchical structure) */
+    supportsChildren: boolean;
+    /** Whether layout supports picture placeholders in nodes */
+    supportsPictures: boolean;
+    /** Default shape type for nodes in this layout */
+    defaultShapeType: SmartArtShapeType;
+    /** Default connector type between nodes */
+    defaultConnectorType: ConnectorType;
+    /** Layout algorithm to use for positioning */
+    algorithm: LayoutAlgorithm;
+    /** Thumbnail image for the layout gallery (base64 data URL or asset URL) */
+    thumbnail: string;
+}
+/**
+ * Available layout algorithms.
+ *
+ * Each algorithm positions nodes according to different patterns:
+ *
+ * LINEAR ALGORITHMS:
+ * - 'linear-horizontal': Nodes in a horizontal row
+ * - 'linear-vertical': Nodes in a vertical column
+ * - 'snake': Nodes snake horizontally then wrap to next row
+ *
+ * TREE ALGORITHMS:
+ * - 'tree-horizontal': Tree with horizontal parent-child flow
+ * - 'tree-vertical': Tree with vertical parent-child flow
+ *
+ * CIRCULAR ALGORITHMS:
+ * - 'radial': Nodes radiate outward from center
+ * - 'circular': Nodes arranged in a circle
+ *
+ * GRID ALGORITHMS:
+ * - 'grid': Nodes arranged in a matrix/grid
+ *
+ * SPECIALIZED ALGORITHMS:
+ * - 'pyramid': Triangular/pyramid arrangement
+ * - 'funnel': Funnel shape (wide at top, narrow at bottom)
+ * - 'venn': Overlapping circles (Venn diagram)
+ * - 'target': Concentric circles (target/bullseye)
+ * - 'gear': Interlocking gear shapes
+ * - 'balance': Balance scale arrangement
+ *
+ * CUSTOM:
+ * - 'custom': Custom positioning logic (for unique layouts)
+ */
+export type LayoutAlgorithm = 'linear-horizontal' | 'linear-vertical' | 'snake' | 'tree-horizontal' | 'tree-vertical' | 'radial' | 'circular' | 'grid' | 'pyramid' | 'funnel' | 'venn' | 'target' | 'gear' | 'balance' | 'custom';
+/**
+ * Interface for layout registry.
+ *
+ * NOTE: This is a type definition only. The actual registry with all
+ * 42+ layout definitions is implemented in engine/src/smartart/registry.ts.
+ *
+ * The registry is responsible for:
+ * - Storing all available layout definitions
+ * - Providing lookup by ID or category
+ * - Allowing registration of custom layouts
+ */
+export interface ILayoutRegistry {
+    /** Map of all registered layouts by ID */
+    layouts: Map<string, SmartArtLayoutDefinition>;
+    /**
+     * Get all layouts in a specific category.
+     * @param category The category to filter by
+     * @returns Array of layout definitions in that category
+     */
+    getByCategory(category: SmartArtCategory): SmartArtLayoutDefinition[];
+    /**
+     * Get a layout by its ID.
+     * @param id The layout ID to look up
+     * @returns The layout definition, or undefined if not found
+     */
+    getById(id: string): SmartArtLayoutDefinition | undefined;
+    /**
+     * Register a new layout (for custom layouts).
+     * @param layout The layout definition to register
+     */
+    register(layout: SmartArtLayoutDefinition): void;
+}
+/**
+ * Layout algorithm interface - implemented per layout type.
+ *
+ * Each algorithm takes the diagram structure and computes positions
+ * for all nodes and connectors.
+ *
+ * NOTE: Uses NodeId branded type for type safety. The bridge ensures
+ * all node IDs are valid NodeIds before passing to layout algorithms.
+ */
+export interface ILayoutAlgorithm {
+    /**
+     * Compute positions for all nodes.
+     *
+     * @param nodes Map of NodeId to node hierarchy info (level, parent, children, order)
+     * @param rootNodeIds Ordered array of root node IDs
+     * @param bounds Available space for layout (width and height in pixels)
+     * @param options Layout-specific options (varies by algorithm)
+     * @returns Computed positions and connector paths
+     */
+    compute(nodes: Map<NodeId, {
+        level: number;
+        parentId: NodeId | null;
+        childIds: NodeId[];
+        siblingOrder: number;
+    }>, rootNodeIds: NodeId[], bounds: {
+        width: number;
+        height: number;
+    }, options: Record<string, unknown>): LayoutResult;
+}
+/**
+ * Result of a layout computation.
+ *
+ * Contains all positioning information needed to render the diagram.
+ */
+export interface LayoutResult {
+    /**
+     * Computed positions for each node.
+     * Maps NodeId to position/size/rotation.
+     */
+    positions: Map<NodeId, {
+        /** X position in pixels (relative to diagram origin) */
+        x: number;
+        /** Y position in pixels (relative to diagram origin) */
+        y: number;
+        /** Width in pixels */
+        width: number;
+        /** Height in pixels */
+        height: number;
+        /** Rotation angle in degrees */
+        rotation: number;
+    }>;
+    /**
+     * Computed connector paths between nodes.
+     */
+    connectors: Array<{
+        /** Source node ID */
+        fromId: NodeId;
+        /** Target node ID */
+        toId: NodeId;
+        /** Path data for rendering */
+        path: {
+            type: 'line' | 'bezier' | 'polyline';
+            points: Array<{
+                x: number;
+                y: number;
+            }>;
+        };
+    }>;
+    /**
+     * Overall bounds of the computed layout.
+     * May differ from input bounds if content doesn't fill space.
+     */
+    bounds: {
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=layouts.d.ts.map

package/dist/smartart/layouts.d.ts.map

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