@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/bridges/ink-recognition-bridge.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Ink Recognition Bridge Interface
+ *
+ * Bridge interface for converting ink strokes into geometric shapes or text.
+ * Provides shape recognition (local algorithms) and text recognition (browser API).
+ *
+ * Bridge Pattern:
+ * - Interface defined here in contracts/
+ * - Implementation in engine/src/bridges/
+ * - Accessed via DocumentContext for dependency injection
+ *
+ * @see plans/active/ink-engine/07-INK-RECOGNITION.md
+ * @see contracts/src/ink/types.ts for InkStroke, RecognizedShape, RecognizedText
+ */
+import type { InkStroke, RecognizedShapeType, ShapeParams } from '../ink/types';
+/**
+ * Result of shape recognition.
+ *
+ * Contains the recognized shape type, confidence score, bounding box,
+ * and shape-specific parameters.
+ */
+export interface ShapeRecognitionResult {
+    /** Type of recognized shape */
+    type: RecognizedShapeType;
+    /** Confidence score [0, 1] */
+    confidence: number;
+    /** Bounding box of the recognized shape */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Shape-specific parameters */
+    params: ShapeParams;
+}
+/**
+ * Result of text recognition.
+ *
+ * Contains the recognized text string, confidence score, and optional bounds.
+ */
+export interface TextRecognitionResult {
+    /** Recognized text string */
+    text: string;
+    /** Confidence score [0, 1] */
+    confidence: number;
+    /** Bounding box of the text (null if not available) */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+}
+/**
+ * Configurable confidence thresholds per shape type.
+ *
+ * Users can tune these based on their drawing precision:
+ * - Lower values = more permissive (may get false positives)
+ * - Higher values = stricter (may miss intended shapes)
+ */
+export interface RecognitionThresholds {
+    /** Threshold for line recognition (default: 0.70) */
+    line: number;
+    /** Threshold for rectangle recognition (default: 0.65) */
+    rectangle: number;
+    /** Threshold for ellipse/circle recognition (default: 0.70) */
+    ellipse: number;
+    /** Threshold for triangle recognition (default: 0.60) */
+    triangle: number;
+    /** Threshold for arrow recognition (default: 0.60) */
+    arrow: number;
+    /** Threshold for star recognition (default: 0.65) */
+    star: number;
+    /** Threshold for text recognition (default: 0.50) */
+    text: number;
+}
+/**
+ * Default thresholds - balanced for most users.
+ */
+export declare const DEFAULT_RECOGNITION_THRESHOLDS: RecognitionThresholds;
+/**
+ * Bridge interface for ink recognition.
+ *
+ * Provides methods for recognizing strokes as shapes or text,
+ * with configurable confidence thresholds.
+ */
+export interface IInkRecognitionBridge {
+    /**
+     * Recognize strokes as a geometric shape.
+     *
+     * Returns the highest-confidence match above its type's threshold.
+     * Returns null if no shape is recognized with sufficient confidence.
+     *
+     * @param strokes - Array of strokes to analyze
+     * @returns Recognition result or null
+     */
+    recognizeShape(strokes: InkStroke[]): Promise<ShapeRecognitionResult | null>;
+    /**
+     * Recognize strokes as handwritten text.
+     *
+     * Uses browser Handwriting Recognition API when available.
+     * Returns null if recognition fails or API is unavailable.
+     *
+     * @param strokes - Array of strokes to analyze
+     * @returns Recognition result or null
+     */
+    recognizeText(strokes: InkStroke[]): Promise<TextRecognitionResult | null>;
+    /**
+     * Check if shape recognition is available.
+     *
+     * Shape recognition uses local algorithms, so it's always available.
+     */
+    isShapeRecognitionAvailable(): boolean;
+    /**
+     * Check if text recognition is available.
+     *
+     * Text recognition requires the browser Handwriting Recognition API.
+     */
+    isTextRecognitionAvailable(): boolean;
+    /**
+     * Update recognition thresholds.
+     *
+     * Allows runtime tuning without recreating the bridge.
+     *
+     * @param thresholds - Partial threshold updates
+     */
+    setThresholds(thresholds: Partial<RecognitionThresholds>): void;
+    /**
+     * Get current thresholds.
+     *
+     * @returns Current threshold configuration
+     */
+    getThresholds(): RecognitionThresholds;
+    /**
+     * Cleanup resources.
+     *
+     * Called when the bridge is no longer needed.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=ink-recognition-bridge.d.ts.map

package/dist/bridges/ink-recognition-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ink-recognition-bridge.d.ts","sourceRoot":"","sources":["../../src/bridges/ink-recognition-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,gCAAgC;IAChC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACxE;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,qBAQ5C,CAAC;AAMF;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;OAQG;IACH,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAE7E;;;;;;;;OAQG;IACH,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAE3E;;;;OAIG;IACH,2BAA2B,IAAI,OAAO,CAAC;IAEvC;;;;OAIG;IACH,0BAA0B,IAAI,OAAO,CAAC;IAEtC;;;;;;OAMG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;IAEhE;;;;OAIG;IACH,aAAa,IAAI,qBAAqB,CAAC;IAEvC;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/bridges/locale-bridge.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Locale Bridge Interface
+ *
+ * Defines the contract for locale-aware input normalization.
+ * This interface handles locale-specific number parsing, transforming
+ * locale-specific formats into normalized format for the schema engine.
+ *
+ * Features:
+ * - Locale-aware decimal separator (1,5 -> 1.5 in European locales)
+ * - Locale-aware thousands separator (1.000,50 -> 1000.50)
+ * - Locale-aware negative format ((123) -> -123)
+ * - Fraction input recognition (1/2 -> 0.5, 3 1/4 -> 3.25)
+ * - Format auto-detection from input ($100 -> currency format)
+ *
+ * @see engine/src/state/bridges/locale-bridge.ts - Implementation
+ * @see contracts/src/culture.ts - CultureInfo type
+ */
+import type { SheetId } from '../core';
+import type { CultureInfo } from '../culture/types';
+/**
+ * Result of normalizing user input.
+ */
+export interface LocaleNormalizationResult {
+    /** The normalized value (locale-agnostic) */
+    normalizedValue: string;
+    /** Whether normalization was applied */
+    wasNormalized: boolean;
+    /** Detected input type for format auto-detection */
+    detectedType?: 'number' | 'currency' | 'percentage' | 'fraction' | 'date' | 'time';
+    /** Suggested format code based on input */
+    suggestedFormat?: string;
+    /** Detected currency symbol if any */
+    currencySymbol?: string;
+}
+/**
+ * Partial cell format for format suggestions.
+ */
+export interface PartialCellFormat {
+    /** Suggested number format code */
+    numberFormat?: string;
+}
+/**
+ * Bridge interface for locale-aware input handling.
+ *
+ * This interface provides methods for normalizing user input according to
+ * locale settings and suggesting appropriate cell formats.
+ */
+export interface ILocaleBridge {
+    /**
+     * Normalize user input according to locale settings.
+     * Call this before passing input to coercion.
+     *
+     * @param input - Raw user input string
+     * @param sheetId - Sheet for locale lookup (optional)
+     * @returns Normalization result with locale-agnostic value
+     */
+    normalizeInput(input: string, sheetId?: SheetId): LocaleNormalizationResult;
+    /**
+     * Get the decimal separator for the current locale.
+     * Used for numpad decimal key handling.
+     *
+     * @param sheetId - Sheet for locale lookup (optional)
+     * @returns Decimal separator character ('.' or ',')
+     */
+    getDecimalSeparator(sheetId?: SheetId): string;
+    /**
+     * Get the thousands separator for the current locale.
+     *
+     * @param sheetId - Sheet for locale lookup (optional)
+     * @returns Thousands separator character (',', '.', or ' ')
+     */
+    getThousandsSeparator(sheetId?: SheetId): string;
+    /**
+     * Get the current culture info.
+     *
+     * @param sheetId - Sheet for locale lookup (optional)
+     * @returns Full CultureInfo object
+     */
+    getCulture(sheetId?: SheetId): CultureInfo;
+    /**
+     * Suggest a cell format based on input pattern.
+     *
+     * @param input - Raw user input string
+     * @param sheetId - Sheet for locale lookup (optional)
+     * @returns Suggested format or undefined
+     */
+    suggestFormat(input: string, sheetId?: SheetId): PartialCellFormat | undefined;
+    /**
+     * Cleanup resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=locale-bridge.d.ts.map

package/dist/bridges/locale-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-bridge.d.ts","sourceRoot":"","sources":["../../src/bridges/locale-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,YAAY,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACnF,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAK5B;;;;;;;OAOG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,yBAAyB,CAAC;IAM5E;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE/C;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEjD;;;;;OAKG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAM3C;;;;;;OAMG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAM/E;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/bridges/pivot-bridge.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Pivot Bridge Interface
+ *
+ * Defines the contract for pivot table computation and caching.
+ * This interface wraps IPivotEngine (from pivot.ts) with engine-specific
+ * functionality like result caching and subscription.
+ *
+ * NOTE: IPivotEngine already exists in contracts/src/pivot.ts and handles
+ * the core computation. IPivotBridge adds:
+ * - Result caching with invalidation
+ * - Subscription for reactive updates
+ * - Integration with DocumentContext
+ *
+ * @see contracts/src/pivot.ts - IPivotEngine (core computation)
+ * @see engine/src/state/bridges/pivot-bridge.ts - Implementation
+ */
+import type { CellValue, SheetId } from '../core';
+import type { PivotField, PivotTableConfig, PivotTableResult } from '../data/pivot';
+/**
+ * Callback for pivot result updates.
+ */
+export type PivotResultCallback = (pivotId: string, result: PivotTableResult | null, error?: string) => void;
+/**
+ * Cache statistics for debugging/monitoring.
+ */
+export interface PivotCacheStats {
+    /** Number of cached results */
+    size: number;
+    /** Individual cache entries */
+    entries: Array<{
+        pivotId: string;
+        computedAt: number;
+        ageMs: number;
+    }>;
+}
+/**
+ * Bridge interface for pivot table computation.
+ *
+ * This interface provides methods for computing pivot tables with caching,
+ * subscription for reactive updates, and field detection.
+ *
+ * All CRUD operations delegate to the Rust compute engine.
+ * The former IPivotStore/PivotStore has been deleted (Phase 4).
+ */
+export interface IPivotBridge {
+    /**
+     * Create a new pivot table.
+     * Delegates to Rust compute engine which generates the ID and timestamps.
+     *
+     * @param config - Pivot table configuration (without id, createdAt, updatedAt)
+     * @returns Created pivot table configuration with generated ID
+     */
+    createPivot(config: PivotTableConfig): Promise<PivotTableConfig>;
+    /**
+     * Get a single pivot table by ID.
+     *
+     * @param sheetId - Output sheet ID where the pivot is displayed
+     * @param pivotId - Pivot table ID
+     * @returns Pivot table configuration or null if not found
+     */
+    getPivot(sheetId: string, pivotId: string): Promise<PivotTableConfig | null>;
+    /**
+     * Get all pivot tables displayed on a sheet.
+     *
+     * @param sheetId - Output sheet ID
+     * @returns Array of pivot table configurations
+     */
+    getAllPivots(sheetId: string): Promise<PivotTableConfig[]>;
+    /**
+     * Update a pivot table configuration by merging partial updates.
+     * All granular operations (addFieldPlacement, setAggregateFunction, etc.)
+     * map to this method with different partial configs.
+     *
+     * @param sheetId - Output sheet ID where the pivot is displayed
+     * @param pivotId - Pivot table ID
+     * @param updates - Partial configuration updates
+     * @returns Updated configuration or null if not found
+     */
+    updatePivot(sheetId: string, pivotId: string, updates: Partial<PivotTableConfig>): Promise<PivotTableConfig | null>;
+    /**
+     * Delete a pivot table.
+     *
+     * @param sheetId - Output sheet ID where the pivot is displayed
+     * @param pivotId - Pivot table ID
+     * @returns True if deleted, false if not found
+     */
+    deletePivot(sheetId: string, pivotId: string): Promise<boolean>;
+    /**
+     * Atomically create a new sheet AND a pivot table on it.
+     * Both operations happen in a single transaction for undo atomicity.
+     *
+     * @param sheetName - Name for the new sheet
+     * @param config - Pivot table configuration
+     * @returns The new sheet's ID and the stored pivot config
+     */
+    createPivotWithSheet(sheetName: string, config: PivotTableConfig): Promise<{
+        sheetId: string;
+        config: PivotTableConfig;
+    }>;
+    /**
+     * Compute a pivot table result.
+     * Uses cached result if available and valid.
+     *
+     * @param sheetId - Sheet containing the pivot table
+     * @param pivotId - Pivot table ID
+     * @param forceRefresh - Force recomputation ignoring cache
+     * @returns Computed pivot table result or null if not found/failed
+     */
+    compute(sheetId: SheetId, pivotId: string, forceRefresh?: boolean): Promise<PivotTableResult | null>;
+    /**
+     * Compute all pivot tables in a sheet.
+     *
+     * @param sheetId - Sheet ID
+     * @returns Map of pivot ID to result
+     */
+    computeAll(sheetId: SheetId): Promise<Map<string, PivotTableResult>>;
+    /**
+     * Refresh a pivot table (recompute without cache).
+     *
+     * @param sheetId - Sheet ID
+     * @param pivotId - Pivot table ID
+     * @returns Recomputed result
+     */
+    refresh(sheetId: SheetId, pivotId: string): Promise<PivotTableResult | null>;
+    /**
+     * Refresh all pivot tables that depend on a sheet's data.
+     *
+     * @param sourceSheetId - Sheet whose data changed
+     */
+    refreshDependentPivots(sourceSheetId: SheetId): Promise<void>;
+    /**
+     * Detect fields from source data range.
+     *
+     * @param sourceSheetId - Sheet containing source data
+     * @param range - Data range to analyze
+     * @returns Array of detected fields
+     */
+    detectFields(sourceSheetId: SheetId, range: {
+        startRow: number;
+        startCol: number;
+        endRow: number;
+        endCol: number;
+    }): Promise<PivotField[]>;
+    /**
+     * Get source row indices for a pivot cell (drill-down).
+     *
+     * @param sheetId - Sheet ID
+     * @param pivotId - Pivot table ID
+     * @param rowKey - Row key from result
+     * @param columnKey - Column key from result
+     * @returns Source row indices that contribute to this cell
+     */
+    drillDown(sheetId: SheetId, pivotId: string, rowKey: string, columnKey: string): Promise<number[]>;
+    /**
+     * Get actual source rows for a pivot cell.
+     *
+     * @param sheetId - Sheet ID
+     * @param pivotId - Pivot table ID
+     * @param rowKey - Row key from result
+     * @param columnKey - Column key from result
+     * @returns Source data rows
+     */
+    getDrillDownData(sheetId: SheetId, pivotId: string, rowKey: string, columnKey: string): Promise<CellValue[][]>;
+    /**
+     * Subscribe to updates for a specific pivot table.
+     *
+     * @param pivotId - Pivot table ID
+     * @param callback - Called when pivot result changes
+     * @returns Unsubscribe function
+     */
+    subscribe(pivotId: string, callback: PivotResultCallback): () => void;
+    /**
+     * Get current cached result for a pivot table.
+     *
+     * @param pivotId - Pivot table ID
+     * @returns Cached result or null
+     */
+    getCachedResult(pivotId: string): PivotTableResult | null;
+    /**
+     * Invalidate cache for a specific pivot table.
+     *
+     * @param pivotId - Pivot table ID
+     */
+    invalidateCache(pivotId: string): void;
+    /**
+     * Invalidate all cached results.
+     */
+    invalidateAllCache(): void;
+    /**
+     * Get cache statistics.
+     *
+     * @returns Cache statistics
+     */
+    getCacheStats(): PivotCacheStats;
+    /**
+     * Clean up resources.
+     */
+    destroy(): void;
+}
+export type { IPivotEngine, PivotTableConfig, PivotTableResult } from '../data/pivot';
+//# sourceMappingURL=pivot-bridge.d.ts.map

package/dist/bridges/pivot-bridge.d.ts.map

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

package/dist/bridges/schema-bridge.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Schema Bridge Interface
+ *
+ * Defines the contract for schema validation and type checking.
+ * This interface wraps ISchemaValidator (from schema.ts) with engine-specific
+ * functionality like event-driven validation and cell metadata storage.
+ *
+ * Validation is primarily owned by Rust compute-core, which validates cells
+ * during every mutation (in prepare_recalc_for_flush). Annotations flow through
+ * MutationResult.recalc.validationAnnotations and are emitted as
+ * `validation:recalc-annotations` EventBus events. The SchemaBridge listens
+ * for these events and processes the annotations (storing errors in cell
+ * metadata and emitting validation:failed / validation:passed events).
+ *
+ * NOTE: ISchemaValidator and ISchemaRegistry already exist in contracts/src/schema.ts
+ * and handle core validation/registry operations. ISchemaBridge adds:
+ * - Processing validation annotations from Rust recalc results
+ * - Validation error storage in cell metadata
+ * - Event emission for validation results
+ * - On-demand validation (validateColumn, validateSheet)
+ *
+ * @see contracts/src/schema.ts - ISchemaValidator, ISchemaRegistry (core validation)
+ * @see kernel/src/bridges/schema-bridge.ts - Implementation
+ */
+import type { SheetId, ValidationError } from '../core';
+import type { ValidationRecalcAnnotationsEvent } from '../events/validation-events';
+/**
+ * Options for schema validation bridge.
+ */
+export interface SchemaValidationOptions {
+    /**
+     * Whether to validate on every cell change.
+     * @default true
+     */
+    validateOnChange?: boolean;
+    /**
+     * Whether to clear validation errors when a cell is cleared.
+     * @default true
+     */
+    clearErrorsOnEmpty?: boolean;
+    /**
+     * Whether to emit validation events to the event bus.
+     * @default true
+     */
+    emitEvents?: boolean;
+}
+/**
+ * Cell with validation errors.
+ */
+export interface CellWithErrors {
+    row: number;
+    col: number;
+    errors: ValidationError[];
+}
+/**
+ * Validation error summary for a sheet.
+ */
+export interface ValidationErrorSummary {
+    /** Total number of errors */
+    totalErrors: number;
+    /** Total number of warnings */
+    totalWarnings: number;
+    /** Number of cells with at least one error */
+    cellsWithErrors: number;
+}
+/**
+ * A single validation annotation from Rust recalc results.
+ */
+export type ValidationRecalcAnnotation = ValidationRecalcAnnotationsEvent['annotations'][number];
+/**
+ * Bridge interface for schema validation.
+ *
+ * Validation is primarily driven by Rust compute-core. The bridge listens
+ * for `validation:recalc-annotations` events and processes them into
+ * cell metadata and UI events.
+ */
+export interface ISchemaBridge {
+    /**
+     * Start listening for validation annotation events from Rust recalc.
+     *
+     * @returns Cleanup function to stop listening
+     */
+    start(): () => void;
+    /**
+     * Stop listening for events.
+     */
+    stop(): void;
+    /**
+     * Process validation annotations from Rust mutation results.
+     * For each annotation: stores errors in cell metadata and emits
+     * validation:failed or validation:passed events.
+     *
+     * @param annotations - Validation annotations from Rust recalc
+     */
+    processValidationAnnotations(annotations: ValidationRecalcAnnotation[]): void;
+    /**
+     * Validate a single cell value against its column schema.
+     * Stores validation errors in cell metadata and emits events.
+     *
+     * @param sheetId - Sheet ID
+     * @param row - Row index
+     * @param col - Column index
+     * @param value - Cell value to validate
+     */
+    validateCell(sheetId: SheetId, row: number, col: number, value: unknown): void;
+    /**
+     * Validate all cells in a column against the column schema.
+     * Useful when a schema is first applied to an existing column.
+     *
+     * @param sheetId - Sheet ID
+     * @param colIndex - Column index
+     */
+    validateColumn(sheetId: SheetId, colIndex: number): void;
+    /**
+     * Validate all cells that have column schemas in a sheet.
+     * Useful after importing data or applying schemas.
+     *
+     * @param sheetId - Sheet ID
+     */
+    validateSheet(sheetId: SheetId): void;
+    /**
+     * Get all cells with validation errors in a sheet.
+     *
+     * @param sheetId - Sheet ID
+     * @returns Array of cells with their errors
+     */
+    getCellsWithErrors(sheetId: SheetId): CellWithErrors[] | Promise<CellWithErrors[]>;
+    /**
+     * Get validation error summary for a sheet.
+     *
+     * @param sheetId - Sheet ID
+     * @returns Error summary
+     */
+    getErrorSummary(sheetId: SheetId): ValidationErrorSummary | Promise<ValidationErrorSummary>;
+}
+export type { ColumnSchema, ISchemaRegistry, ISchemaValidator, ValidationResult, } from '../core/schema';
+//# sourceMappingURL=schema-bridge.d.ts.map

package/dist/bridges/schema-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-bridge.d.ts","sourceRoot":"","sources":["../../src/bridges/schema-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAMpF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,gCAAgC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAMjG;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAK5B;;;;OAIG;IACH,KAAK,IAAI,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAMb;;;;;;OAMG;IACH,4BAA4B,CAAC,WAAW,EAAE,0BAA0B,EAAE,GAAG,IAAI,CAAC;IAM9E;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/E;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzD;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAMtC;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEnF;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC7F;AAMD,YAAY,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}