@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/api/workbook/viewport.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Viewport Management Sub-API
+ *
+ * Handle-based viewport region lifecycle for the Workbook.
+ * Consumers create viewport regions via `wb.viewport.createRegion()`,
+ * which returns a `ViewportRegion` handle. Dispose when done.
+ *
+ * @see plans/archive/kernel/round-5/02-HANDLE-BASED-API-PATTERN.md — Phase 1
+ */
+import type { IDisposable } from '../../core/disposable';
+import type { RenderScheduler } from '../../rendering/grid-renderer';
+export interface ViewportBounds {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+}
+/**
+ * Handle for a registered viewport region.
+ *
+ * Created by `wb.viewport.createRegion()`. The kernel tracks cell data
+ * for this region and delivers incremental updates. Dispose when the
+ * region is no longer needed (e.g., component unmount, sheet switch).
+ *
+ * Supports TC39 Explicit Resource Management:
+ *   using region = wb.viewport.createRegion(sheetId, bounds);
+ */
+export interface ViewportRegion extends IDisposable {
+    /** Unique ID for this region (auto-generated). */
+    readonly id: string;
+    /** Sheet this region is tracking. */
+    readonly sheetId: string;
+    /** Update the visible bounds (e.g., on scroll or resize). */
+    updateBounds(bounds: ViewportBounds): void;
+    /** Request a data refresh for this region. */
+    refresh(scrollBehavior?: unknown): Promise<void>;
+}
+/**
+ * Events emitted by the viewport coordinator when viewport state changes.
+ * Consumers subscribe to these events to react to data changes without polling.
+ */
+export type ViewportChangeEvent = {
+    type: 'fetch-committed';
+} | {
+    type: 'cells-patched';
+    cells: {
+        row: number;
+        col: number;
+    }[];
+} | {
+    type: 'dimensions-patched';
+    axis: 'row' | 'col';
+};
+/**
+ * Viewport management sub-API on the Workbook.
+ *
+ * Consumer-scoped: createRegion() returns a handle with per-viewport
+ * refresh, prefetch, and lifecycle management.
+ */
+export interface WorkbookViewport {
+    /** Create a tracked viewport region. Returns a handle — dispose when done. */
+    createRegion(sheetId: string, bounds: ViewportBounds, viewportId?: string): ViewportRegion;
+    /** Reset all regions for a sheet (e.g., on sheet switch). */
+    resetSheetRegions(sheetId: string): void;
+    /**
+     * Inject (or clear) the render scheduler for "Write = Invalidate" integration.
+     * When set, mutation patches applied to viewport buffers automatically
+     * trigger a render frame via the scheduler.
+     */
+    setRenderScheduler(scheduler: RenderScheduler | null): void;
+    /**
+     * Subscribe to viewport state change events from all viewport coordinators.
+     * Events are emitted synchronously after each state change.
+     * Returns an unsubscribe function.
+     */
+    subscribe(cb: (event: ViewportChangeEvent) => void): () => void;
+    /**
+     * Set the show-formulas mode. When true, Rust substitutes formula strings
+     * into the display text field of viewport cells that have formulas.
+     * Invalidates all prefetch bounds so the next viewport refresh fetches
+     * fresh data with the correct display mode.
+     */
+    setShowFormulas(value: boolean): void;
+}
+//# sourceMappingURL=viewport.d.ts.map

package/dist/api/workbook/viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../../src/api/workbook/viewport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3C,8CAA8C;IAC9C,OAAO,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAA;CAAE,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAC3F,6DAA6D;IAC7D,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5D;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAChE;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACvC"}

package/dist/api/workbook.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Unified Spreadsheet API -- Workbook Interface
+ *
+ * THE definitive API for all workbook-level operations.
+ * Every consumer -- headless agents, LLM code, OS apps, browser app -- uses this.
+ * No exceptions, no bypasses.
+ *
+ * ## Sub-API namespaces
+ *
+ * Domain-specific operations are grouped into readonly sub-API accessors:
+ *
+ *   await wb.sheets.addSheet("Sales");
+ *   await wb.names.addNamedRange("total", "Sheet1!A1:A10");
+ *   await wb.history.undo();
+ */
+import type { IChartBridge } from '../bridges/chart-bridge';
+import type { IInkRecognitionBridge } from '../bridges/ink-recognition-bridge';
+import type { IPivotBridge } from '../bridges/pivot-bridge';
+import type { EventByType, SpreadsheetEventType as InternalEventType, SpreadsheetEvent } from '../events/index';
+import type { SelectionCheckpoint } from '../selection/types';
+import type { IKernelServices } from '../services/index';
+import type { CalculationType, CheckpointInfo, CodeResult, Comment, ExecuteOptions, FunctionInfo, IRecordsAPI, PivotTableInfo, SheetId, SlicerInfo, TableInfo, WorkbookEvent, WorkbookSettings, WorkbookSnapshot } from './types';
+import type { CultureInfo } from '../culture/types';
+import type { WorkbookHistory, WorkbookNames, WorkbookNotifications, WorkbookProtection, WorkbookScenarios, WorkbookSheets, WorkbookSlicers, WorkbookStyles, WorkbookTheme, WorkbookViewport } from './workbook/index';
+import type { Worksheet } from './worksheet';
+import type { IFloatingObjectManager } from '../kernel/floating-object-manager';
+import type { CodeExecutionResult, CodeExecutionOptions } from '../core/execution';
+export interface Workbook {
+    /** Get a sheet by internal SheetId. SYNC — no IPC needed. Throws KernelError if not found. */
+    getSheet(sheetId: SheetId): Worksheet;
+    /** Get a sheet by name (case-insensitive). ASYNC — resolves name via Rust. */
+    getSheetByName(name: string): Promise<Worksheet>;
+    /** Get a sheet by 0-based index. ASYNC — resolves index via Rust. */
+    getSheetByIndex(index: number): Promise<Worksheet>;
+    /** Get the currently active sheet. SYNC — uses known activeSheetId. */
+    getActiveSheet(): Worksheet;
+    /** Sync getter alias for getActiveSheet(). */
+    readonly activeSheet: Worksheet;
+    /**
+     * Get a sheet by name, creating it if it doesn't exist.
+     *
+     * @param name - Sheet name (case-insensitive lookup)
+     * @returns The sheet and whether it was newly created
+     */
+    getOrCreateSheet(name: string): Promise<{
+        sheet: Worksheet;
+        created: boolean;
+    }>;
+    /** Get the number of sheets in the workbook. ASYNC — reads from Rust. */
+    getSheetCount(): Promise<number>;
+    /** Get the names of all sheets in order. ASYNC — reads from Rust. */
+    getSheetNames(): Promise<string[]>;
+    /**
+     * Execute a batch of operations as a single undo step.
+     *
+     * All operations inside the callback are grouped into one undo step.
+     * If an operation throws, the undo group is closed and all prior writes
+     * in the batch remain committed (Excel-style best-effort, not transactional).
+     *
+     * Note: Each mutation within the batch still triggers its own recalc pass.
+     * True deferred recalculation (single recalc at batch end) is not yet implemented.
+     */
+    batch<T = void>(fn: (wb: Workbook) => Promise<T>): Promise<T>;
+    /** Create a named checkpoint (version snapshot). Returns the checkpoint ID. */
+    createCheckpoint(label?: string): string;
+    /** Restore the workbook to a previously saved checkpoint. */
+    restoreCheckpoint(id: string): Promise<void>;
+    /** List all saved checkpoints. */
+    listCheckpoints(): CheckpointInfo[];
+    /**
+     * Trigger recalculation of formulas.
+     * @param calculationType - Type of recalculation (default: 'full')
+     *   - 'recalculate' — recalculate dirty cells only
+     *   - 'full' — recalculate all cells
+     *   - 'fullRebuild' — rebuild dependency graph and recalculate all
+     */
+    calculate(calculationType?: CalculationType): Promise<void>;
+    /**
+     * Suspend automatic recalculation until resumeCalc() is called.
+     * Mutations during suspension are accumulated and recalculated in a single pass on resume.
+     */
+    suspendCalc(): void;
+    /**
+     * Resume automatic recalculation after suspendCalc().
+     * Triggers a full recalc to pick up all accumulated mutations.
+     */
+    resumeCalc(): Promise<void>;
+    /**
+     * Get the current calculation mode (auto/manual/autoNoTable).
+     * Convenience accessor — equivalent to `(await getSettings()).calculationSettings.calcMode`.
+     */
+    getCalculationMode(): Promise<'auto' | 'autoNoTable' | 'manual'>;
+    /**
+     * Set the calculation mode.
+     * Convenience mutator — patches `calculationSettings.calcMode`.
+     */
+    setCalculationMode(mode: 'auto' | 'autoNoTable' | 'manual'): Promise<void>;
+    /**
+     * Get whether iterative calculation is enabled for circular references.
+     * Convenience accessor — equivalent to `(await getSettings()).calculationSettings.enableIterativeCalculation`.
+     */
+    getIterativeCalculation(): Promise<boolean>;
+    /**
+     * Set whether iterative calculation is enabled for circular references.
+     * Convenience mutator — patches `calculationSettings.enableIterativeCalculation`.
+     */
+    setIterativeCalculation(enabled: boolean): Promise<void>;
+    /**
+     * Set the maximum number of iterations for iterative calculation.
+     * Convenience mutator — patches `calculationSettings.maxIterations`.
+     */
+    setMaxIterations(n: number): Promise<void>;
+    /**
+     * Set the convergence threshold (maximum change) for iterative calculation.
+     * Convenience mutator — patches `calculationSettings.maxChange`.
+     */
+    setConvergenceThreshold(threshold: number): Promise<void>;
+    /**
+     * Whether to use displayed precision instead of full (15-digit) precision.
+     * Convenience accessor — inverted from `calculationSettings.fullPrecision`.
+     */
+    getUsePrecisionAsDisplayed(): Promise<boolean>;
+    /**
+     * Set whether to use displayed precision.
+     * Convenience mutator — inverts and patches `calculationSettings.fullPrecision`.
+     */
+    setUsePrecisionAsDisplayed(value: boolean): Promise<void>;
+    /** Get the calculation engine version string. */
+    getCalculationEngineVersion(): string;
+    /** Subscribe to a specific internal event type with full type inference. */
+    on<T extends InternalEventType>(event: T, handler: (event: EventByType<T>) => void): () => void;
+    /** Subscribe to a coarse WorkbookEvent or arbitrary event string. Handler receives the internal event directly. */
+    on(event: WorkbookEvent | string, handler: (event: any) => void): () => void;
+    /** Emit a workbook-level event. Used by coordinator mutations that need to notify the system of changes. */
+    emit(event: SpreadsheetEvent): void;
+    /** Execute TypeScript/JavaScript code in the spreadsheet sandbox. */
+    executeCode(code: string, options?: ExecuteOptions): Promise<CodeResult>;
+    /** Get a summary snapshot of the entire workbook. */
+    getWorkbookSnapshot(): Promise<WorkbookSnapshot>;
+    /** Get the catalog of all available spreadsheet functions. */
+    getFunctionCatalog(): FunctionInfo[];
+    /** Get detailed info about a specific function. */
+    getFunctionInfo(name: string): FunctionInfo | null;
+    /** Export the workbook as a snapshot. */
+    exportSnapshot(): Promise<WorkbookSnapshot>;
+    /** Export the workbook as an XLSX binary buffer. */
+    toBuffer(): Promise<Uint8Array>;
+    /** Copy a range from another workbook into this workbook. */
+    copyRangeFrom(source: Workbook, fromRange: string, toRange: string): Promise<void>;
+    /** Convert row/col to A1 address: (0, 0) -> "A1" */
+    indexToAddress(row: number, col: number): string;
+    /** Convert A1 address to row/col: "A1" -> { row: 0, col: 0 } */
+    addressToIndex(address: string): {
+        row: number;
+        col: number;
+    };
+    /**
+     * Get full CultureInfo for the workbook's current culture setting.
+     * Resolves the `culture` IETF tag (e.g. 'de-DE') into a complete CultureInfo
+     * with number/date/currency formatting details.
+     */
+    getCultureInfo(): Promise<CultureInfo>;
+    /** Get the decimal separator for the current culture (e.g. '.' or ','). */
+    getDecimalSeparator(): Promise<string>;
+    /** Get the thousands separator for the current culture (e.g. ',' or '.'). */
+    getThousandsSeparator(): Promise<string>;
+    /** Get all tables across all sheets. */
+    getAllTables(): Promise<TableInfo[]>;
+    /** Get all pivot tables across all sheets. */
+    getAllPivotTables(): Promise<PivotTableInfo[]>;
+    /** Get all slicers across all sheets. */
+    getAllSlicers(): Promise<SlicerInfo[]>;
+    /** Get all comments across all sheets. */
+    getAllComments(): Promise<Comment[]>;
+    /** Get workbook-level settings. */
+    getSettings(): Promise<WorkbookSettings>;
+    /** Update workbook-level settings. */
+    setSettings(updates: Partial<WorkbookSettings>): Promise<void>;
+    /**
+     * Close the workbook with optional save behavior.
+     * @param closeBehavior - 'save' exports snapshot before disposing, 'skipSave' disposes immediately (default: 'skipSave')
+     */
+    close(closeBehavior?: 'save' | 'skipSave'): Promise<void>;
+    /** Dispose of the workbook and release resources. */
+    dispose(): void;
+    /**
+     * Set the undo description for the next mutation.
+     * Call immediately before a mutation to label the undo step.
+     * Pattern: `wb.setPendingUndoDescription("Resize row"); ws.setRowHeight(...)`.
+     */
+    setPendingUndoDescription(description: string): void;
+    /**
+     * Set the selection checkpoint for undo.
+     * Call before selection-changing mutations so undo can restore selection state.
+     */
+    setPendingSelectionCheckpoint(checkpoint: SelectionCheckpoint): void;
+    /** Pivot table computation bridge. */
+    readonly pivot: IPivotBridge;
+    /** Chart management bridge (rendering, data resolution, caching). */
+    readonly charts: IChartBridge;
+    /** Table-aware record CRUD operations (Kanban, Gallery, Calendar, etc.). */
+    readonly records: IRecordsAPI;
+    /**
+     * Create a calculator context for formula evaluation.
+     * Used by Goal Seek, Function Arguments dialog, and other calculator infrastructure.
+     * Return type is `unknown` because CalculatorContext is a kernel-internal type.
+     */
+    createCalculatorContext(sheetId: SheetId): unknown;
+    /** Ink recognition bridge (shape and text recognition). Null if not available. */
+    readonly ink: IInkRecognitionBridge | null;
+    /**
+     * Trigger recalculation of all formulas across all sheets.
+     * @param sheetId - Context sheet for relative reference resolution
+     * @param origin - Transaction origin (default: 'user')
+     */
+    recalculateAll(sheetId: SheetId, origin?: string): void;
+    /**
+     * Trigger recalculation of formulas on a specific sheet.
+     * @param sheetId - Sheet to recalculate
+     * @param origin - Transaction origin (default: 'user')
+     */
+    recalculateSheet(sheetId: SheetId, origin?: string): void;
+    /** Sheet management (add, remove, move, rename, copy, hide, show) */
+    readonly sheets: WorkbookSheets;
+    /** Workbook-scoped slicer collection (all slicers across all sheets) */
+    readonly slicers: WorkbookSlicers;
+    /** Named range CRUD */
+    readonly names: WorkbookNames;
+    /** What-if scenario CRUD */
+    readonly scenarios: WorkbookScenarios;
+    /** Undo/redo/history traversal */
+    readonly history: WorkbookHistory;
+    /** Table styles and format lookup */
+    readonly styles: WorkbookStyles;
+    /** Workbook-level protection */
+    readonly protection: WorkbookProtection;
+    /** Toast/notification queue (info, warning, error, success) */
+    readonly notifications: WorkbookNotifications;
+    /** Theme management (workbook OOXML theme + chrome UI theme). */
+    readonly theme: WorkbookTheme;
+    /** Viewport region lifecycle (handle-based — create, update, dispose). */
+    readonly viewport: WorkbookViewport;
+}
+/**
+ * WorkbookInternal — Infrastructure-tier Workbook interface.
+ *
+ * Extends the app-facing Workbook with properties that only infrastructure code
+ * (shell, coordinator, headless engine) should access. Apps must NOT use this interface;
+ * they should use Workbook and its sub-API namespaces (wb.history, wb.notifications, etc.).
+ *
+ * @see Plan 18: Service API Surface
+ */
+export interface WorkbookInternal extends Workbook {
+    /** Kernel services (clipboard, undo, notifications, query executor). Infrastructure-only. */
+    readonly services: IKernelServices;
+    /** Refresh cached sheet metadata (name, index, visibility) from Rust. Infrastructure-only. */
+    refreshSheetMetadata(): Promise<void>;
+    /** Get the current active sheet ID. Infrastructure-only. */
+    getActiveSheetId(): string;
+    /** Set the active sheet ID. Infrastructure-only. */
+    setActiveSheetId(id: string): void;
+    /** Floating object manager — full CRUD + spatial queries. Infrastructure-only. */
+    readonly floatingObjects: IFloatingObjectManager;
+    /**
+     * Inject a code-executor factory.  The factory is called lazily on first
+     * `executeCode()` invocation.  Infrastructure-only — used by engine layers
+     * to wire a VM executor without creating a circular dependency.
+     */
+    setCodeExecutorFactory(factory: (config: {
+        ctx: unknown;
+        eventBus: unknown;
+        getActiveSheetId: () => string;
+    }) => {
+        execute(code: string, options?: CodeExecutionOptions): Promise<CodeExecutionResult>;
+        cancelExecution?(executionId: string): void;
+        dispose(): void;
+    }): void;
+}
+//# sourceMappingURL=workbook.d.ts.map

package/dist/api/workbook.d.ts.map

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

package/dist/api/worksheet/bindings.d.ts

@@ -0,0 +1,66 @@
+/**
+ * WorksheetBindings — Sub-API Interface for Sheet Data Bindings
+ *
+ * Methods for managing sheet-level data source bindings and querying
+ * projection (dynamic array spill) metadata.
+ */
+import type { CellRange, CreateBindingConfig, SheetDataBindingInfo } from '../types';
+/** Sub-API for worksheet data binding operations. */
+export interface WorksheetBindings {
+    /**
+     * List all data bindings on the sheet.
+     *
+     * @returns Array of binding info objects
+     */
+    list(): Promise<SheetDataBindingInfo[]>;
+    /**
+     * Create a new data binding on the sheet.
+     *
+     * @param config - Binding configuration (connection, column mappings, etc.)
+     */
+    create(config: CreateBindingConfig): Promise<void>;
+    /**
+     * Remove a data binding by ID.
+     *
+     * @param bindingId - The binding ID to remove
+     */
+    remove(bindingId: string): Promise<void>;
+    /**
+     * Get the spill range for a projected (dynamic array) cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns The spill range, or null if the cell is not a projection source
+     */
+    getProjectionRange(row: number, col: number): Promise<CellRange | null>;
+    /**
+     * Get the source cell of a projected value.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns The source cell position, or null if the cell is not a projection
+     */
+    getProjectionSource(row: number, col: number): Promise<{
+        row: number;
+        col: number;
+    } | null>;
+    /**
+     * Check whether a cell position is a projected (spilled) value.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns True if the cell holds a projected value
+     */
+    isProjectedPosition(row: number, col: number): Promise<boolean>;
+    /**
+     * Get all projection data overlapping a viewport range (batch query).
+     * Returns one entry per projection with origin position and dimensions.
+     */
+    getViewportProjectionData(startRow: number, startCol: number, endRow: number, endCol: number): Promise<Array<{
+        originRow: number;
+        originCol: number;
+        rows: number;
+        cols: number;
+    }>>;
+}
+//# sourceMappingURL=bindings.d.ts.map

package/dist/api/worksheet/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/bindings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErF,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAExC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;;;OAMG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAExE;;;;;;OAMG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE5F;;;;;;OAMG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhE;;;OAGG;IACH,yBAAyB,CACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACzF"}

package/dist/api/worksheet/changes.d.ts

@@ -0,0 +1,60 @@
+/**
+ * WorksheetChanges — Sub-API for opt-in change tracking.
+ *
+ * Creates lightweight trackers that accumulate cell-level change records
+ * across mutations. Trackers are opt-in to avoid bloating return values;
+ * they return addresses + metadata only (no cell values) so callers can
+ * hydrate via getRange() when needed.
+ *
+ * Inspired by:
+ * - Excel OfficeJS onChanged (lightweight payload + lazy hydration)
+ * - Firestore onSnapshot (query-scoped subscriptions)
+ * - Yjs transaction.origin (source/origin tagging for collab)
+ */
+/** A single cell-level change observed by a tracker. */
+export interface ChangeRecord {
+    /** Cell address in A1 notation (e.g. "B1"). */
+    address: string;
+    /** 0-based row index. */
+    row: number;
+    /** 0-based column index. */
+    col: number;
+    /** What caused this change. */
+    origin: ChangeOrigin;
+    /** Type of change. */
+    type: 'modified';
+}
+/** Origin of a change: direct write, formula recalculation, or remote collaborator. */
+export type ChangeOrigin = 'direct' | 'cascade' | 'remote';
+/** Options for creating a change tracker. */
+export interface ChangeTrackOptions {
+    /** Only track changes within this range (A1 notation, e.g. "A1:Z100"). Omit for whole-sheet. */
+    scope?: string;
+    /** Exclude changes from these origin types. */
+    excludeOrigins?: ChangeOrigin[];
+}
+/** A handle that accumulates change records across mutations. */
+export interface ChangeTracker {
+    /**
+     * Drain all accumulated changes since creation or last collect() call.
+     * Returns addresses + metadata only (no cell values) — call ws.getRange()
+     * to hydrate if needed.
+     */
+    collect(): ChangeRecord[];
+    /** Stop tracking and release internal resources. */
+    close(): void;
+    /** Whether this tracker is still active (not closed). */
+    readonly active: boolean;
+}
+/** Sub-API for opt-in change tracking on a worksheet. */
+export interface WorksheetChanges {
+    /**
+     * Create a change tracker that accumulates cell-level change records
+     * from this point forward.
+     *
+     * @param options - Optional scope and origin filters
+     * @returns A ChangeTracker handle — call collect() to drain, close() when done
+     */
+    track(options?: ChangeTrackOptions): ChangeTracker;
+}
+//# sourceMappingURL=changes.d.ts.map

package/dist/api/worksheet/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,sBAAsB;IACtB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAM3D,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;CACjC;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,IAAI,YAAY,EAAE,CAAC;IAE1B,oDAAoD;IACpD,KAAK,IAAI,IAAI,CAAC;IAEd,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAMD,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,aAAa,CAAC;CACpD"}

package/dist/api/worksheet/charts.d.ts

@@ -0,0 +1,83 @@
+/**
+ * WorksheetCharts — Sub-API Interface for Chart Operations
+ *
+ * CRUD operations plus convenience, z-order, table-linking,
+ * series manipulation, and point formatting methods.
+ */
+import type { Chart, ChartBorder, ChartConfig, ChartType, DataLabelConfig, ImageExportOptions, SeriesConfig } from '../types';
+/**
+ * ChartImageExporter — Injectable dependency for chart image export.
+ *
+ * The kernel is headless (no DOM/canvas), so actual rendering must be
+ * provided by the shell or platform layer via dependency injection.
+ */
+export interface ChartImageExporter {
+    exportImage(sheetId: string, chartId: string, options?: ImageExportOptions): Promise<string | null>;
+}
+export interface WorksheetCharts {
+    /** Add a chart to the sheet. Returns the chart ID. */
+    add(config: ChartConfig): Promise<string>;
+    /** Get a chart by ID, or null if not found. */
+    get(chartId: string): Promise<Chart | null>;
+    /** Update a chart's configuration. */
+    update(chartId: string, updates: Partial<ChartConfig>): Promise<void>;
+    /** Remove a chart by ID. */
+    remove(chartId: string): Promise<void>;
+    /** List all charts in the sheet. */
+    list(): Promise<Chart[]>;
+    /** Duplicate a chart, offsetting the copy by 2 rows. Returns the new chart ID. */
+    duplicate(chartId: string): Promise<string>;
+    /**
+     * Export a chart as an image.
+     *
+     * Note: This is a stub — actual rendering requires a canvas context.
+     * The bridge integration will be wired in Wave 4.
+     */
+    exportImage(chartId: string, options?: ImageExportOptions): Promise<string>;
+    /** Set a chart's data range (A1 notation). */
+    setDataRange(chartId: string, range: string): Promise<void>;
+    /** Set a chart's type and optional sub-type. */
+    setType(chartId: string, type: ChartType, subType?: string): Promise<void>;
+    /** Get the total number of charts on this sheet. */
+    getCount(): Promise<number>;
+    /** Find a chart by its name, or null if not found. */
+    getByName(name: string): Promise<Chart | null>;
+    /** Bring a chart to the front (highest z-index). */
+    bringToFront(chartId: string): Promise<void>;
+    /** Send a chart to the back (lowest z-index). */
+    sendToBack(chartId: string): Promise<void>;
+    /** Bring a chart forward by one layer. */
+    bringForward(chartId: string): Promise<void>;
+    /** Send a chart backward by one layer. */
+    sendBackward(chartId: string): Promise<void>;
+    /** Link a chart to a table so it auto-updates with the table's data. */
+    linkToTable(chartId: string, tableId: string): Promise<void>;
+    /** Unlink a chart from its source table. */
+    unlinkFromTable(chartId: string): Promise<void>;
+    /** Check whether a chart is linked to a table. */
+    isLinkedToTable(chartId: string): Promise<boolean>;
+    /** Add a data series to a chart. Returns the new series index. */
+    addSeries(chartId: string, config: SeriesConfig): Promise<number>;
+    /** Remove a data series by index. */
+    removeSeries(chartId: string, index: number): Promise<void>;
+    /** Get a data series by index. */
+    getSeries(chartId: string, index: number): Promise<SeriesConfig>;
+    /** Update a data series at the given index. */
+    updateSeries(chartId: string, index: number, updates: Partial<SeriesConfig>): Promise<void>;
+    /** Get the number of data series in a chart. */
+    getSeriesCount(chartId: string): Promise<number>;
+    /** Reorder a series from one index to another. */
+    reorderSeries(chartId: string, fromIndex: number, toIndex: number): Promise<void>;
+    /** Set the values range for a series (A1 notation). */
+    setSeriesValues(chartId: string, index: number, range: string): Promise<void>;
+    /** Set the categories range for a series (A1 notation). */
+    setSeriesCategories(chartId: string, index: number, range: string): Promise<void>;
+    /** Format an individual data point within a series. */
+    formatPoint(chartId: string, seriesIndex: number, pointIndex: number, format: {
+        fill?: string;
+        border?: ChartBorder;
+    }): Promise<void>;
+    /** Set the data label configuration for an individual data point. */
+    setPointDataLabel(chartId: string, seriesIndex: number, pointIndex: number, config: DataLabelConfig): Promise<void>;
+}
+//# sourceMappingURL=charts.d.ts.map

package/dist/api/worksheet/charts.d.ts.map

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

package/dist/api/worksheet/collections/connector-collection.d.ts

@@ -0,0 +1,7 @@
+import type { ConnectorHandle } from '../handles/connector-handle';
+/** Connector collection — get/list only. add() deferred until ConnectorConfig exists. */
+export interface WorksheetConnectorCollection {
+    get(id: string): Promise<ConnectorHandle | null>;
+    list(): Promise<ConnectorHandle[]>;
+}
+//# sourceMappingURL=connector-collection.d.ts.map

package/dist/api/worksheet/collections/connector-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-collection.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/connector-collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,yFAAyF;AACzF,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACjD,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACpC"}

package/dist/api/worksheet/collections/drawing-collection.d.ts

@@ -0,0 +1,9 @@
+import type { CreateDrawingOptions } from '../../../ink/types';
+import type { ObjectPosition } from '../../../objects/floating-objects';
+import type { DrawingHandle } from '../handles/drawing-handle';
+export interface WorksheetDrawingCollection {
+    get(id: string): Promise<DrawingHandle | null>;
+    list(): Promise<DrawingHandle[]>;
+    add(position: Partial<ObjectPosition>, options?: CreateDrawingOptions): Promise<DrawingHandle>;
+}
+//# sourceMappingURL=drawing-collection.d.ts.map

package/dist/api/worksheet/collections/drawing-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawing-collection.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/drawing-collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC/C,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAChG"}

package/dist/api/worksheet/collections/equation-collection.d.ts

@@ -0,0 +1,8 @@
+import type { EquationConfig } from '../../types';
+import type { EquationHandle } from '../handles/equation-handle';
+export interface WorksheetEquationCollection {
+    get(id: string): Promise<EquationHandle | null>;
+    list(): Promise<EquationHandle[]>;
+    add(config: EquationConfig): Promise<EquationHandle>;
+}
+//# sourceMappingURL=equation-collection.d.ts.map

package/dist/api/worksheet/collections/equation-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equation-collection.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/equation-collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAChD,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACtD"}