@mog-sdk/spreadsheet-contracts 0.1.12

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

@@ -0,0 +1,136 @@
+/**
+ * WorksheetFormats — Sub-API for cell formatting operations.
+ *
+ * Provides methods to get, set, and clear cell formats, as well as
+ * apply format patterns across ranges (Format Painter).
+ */
+import type { CellFormat, CellRange, FormatChangeResult, ResolvedCellFormat } from '../types';
+import type { NumberFormatType } from '../../core/core';
+/** Sub-API for cell formatting operations on a worksheet. */
+export interface WorksheetFormats {
+    /**
+     * Set format for a single cell.
+     *
+     * @param address - A1-style cell address (e.g. "A1", "B3")
+     * @param format - Format properties to apply
+     */
+    set(address: string, format: CellFormat): Promise<FormatChangeResult>;
+    /**
+     * Set format for a single cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @param format - Format properties to apply
+     */
+    set(row: number, col: number, format: CellFormat): Promise<FormatChangeResult>;
+    /**
+     * Set format for a contiguous range.
+     *
+     * @param range - A1-style range string (e.g. "A1:B2")
+     * @param format - Format properties to apply
+     */
+    setRange(range: string, format: CellFormat): Promise<FormatChangeResult>;
+    /**
+     * Set format for a contiguous range.
+     *
+     * @param range - Range object with start/end row and column
+     * @param format - Format properties to apply
+     */
+    setRange(range: CellRange, format: CellFormat): Promise<FormatChangeResult>;
+    /**
+     * Set format for multiple ranges, with full row/column optimization.
+     *
+     * @param ranges - Array of range objects
+     * @param format - Format properties to apply
+     */
+    setRanges(ranges: CellRange[], format: CellFormat): Promise<void>;
+    /**
+     * Clear format from a single cell, resetting it to default.
+     *
+     * @param address - A1-style cell address
+     */
+    clear(address: string): Promise<void>;
+    /**
+     * Clear format from a single cell, resetting it to default.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     */
+    clear(row: number, col: number): Promise<void>;
+    /**
+     * Get the fully-resolved format of a single cell.
+     *
+     * Returns a dense CellFormat with all fields present (null for unset properties,
+     * never undefined). Includes the full cascade (default → col → row → table → cell → CF)
+     * with theme colors resolved to hex.
+     *
+     * @param address - A1-style cell address
+     * @returns The resolved cell format (always an object, never null)
+     */
+    get(address: string): Promise<ResolvedCellFormat>;
+    /**
+     * Get the fully-resolved format of a single cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns The resolved cell format (always an object, never null)
+     */
+    get(row: number, col: number): Promise<ResolvedCellFormat>;
+    /**
+     * Adjust the indent level of a cell by a relative amount.
+     *
+     * @param address - A1-style cell address
+     * @param amount - Relative indent change (positive to increase, negative to decrease)
+     */
+    adjustIndent(address: string, amount: number): Promise<void>;
+    /**
+     * Adjust the indent level of a cell by a relative amount.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @param amount - Relative indent change (positive to increase, negative to decrease)
+     */
+    adjustIndent(row: number, col: number, amount: number): Promise<void>;
+    /**
+     * Clear only fill properties of a cell (backgroundColor, patternType, patternForegroundColor, gradientFill).
+     * Unlike `clear()`, this preserves font, alignment, borders, and other formatting.
+     *
+     * @param address - A1-style cell address
+     */
+    clearFill(address: string): Promise<void>;
+    /**
+     * Clear only fill properties of a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     */
+    clearFill(row: number, col: number): Promise<void>;
+    /**
+     * Get the auto-derived number format category for a cell based on its format code.
+     *
+     * @param address - A1-style cell address
+     * @returns The detected NumberFormatType category
+     */
+    getNumberFormatCategory(address: string): Promise<NumberFormatType>;
+    /**
+     * Get the auto-derived number format category for a cell based on its format code.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns The detected NumberFormatType category
+     */
+    getNumberFormatCategory(row: number, col: number): Promise<NumberFormatType>;
+    /**
+     * Apply a format pattern from a source range to a target range.
+     *
+     * When the target range is larger than the source range, the source format
+     * pattern is tiled to fill the target (like Excel's Format Painter with
+     * multi-cell sources).
+     *
+     * @param format - The base format to apply (used when sourceRange is null or single-cell)
+     * @param sourceRange - Source range for pattern replication, or null for simple application
+     * @param targetRange - Target range to apply formats to
+     */
+    applyPattern(format: CellFormat, sourceRange: CellRange | null, targetRange: CellRange): Promise<void>;
+}
+//# sourceMappingURL=formats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/formats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtE;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/E;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzE;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;;;;;OASG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;;;;OAMG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpE;;;;;;OAMG;IACH,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7E;;;;;;;;;;OAUG;IACH,YAAY,CACV,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,SAAS,GAAG,IAAI,EAC7B,WAAW,EAAE,SAAS,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/api/worksheet/handles/chart-handle.d.ts

@@ -0,0 +1,11 @@
+import type { ChartObject } from '../../../objects/floating-objects';
+import type { FloatingObjectHandle } from './floating-object-handle';
+/**
+ * Chart handle — hosting ops only.
+ * Content ops (series, categories, type, data range) via ws.charts.*
+ */
+export interface ChartHandle extends FloatingObjectHandle {
+    duplicate(offsetX?: number, offsetY?: number): Promise<ChartHandle>;
+    getData(): Promise<ChartObject>;
+}
+//# sourceMappingURL=chart-handle.d.ts.map

package/dist/api/worksheet/handles/chart-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/chart-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,oBAAoB;IACvD,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpE,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC"}

package/dist/api/worksheet/handles/connector-handle.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectorObject } from '../../../objects/floating-objects';
+import type { FloatingObjectHandle } from './floating-object-handle';
+export interface ConnectorHandle extends FloatingObjectHandle {
+    /** Update connector routing, endpoints, fill, outline. ConnectorConfig pending — uses generic record. */
+    update(props: Record<string, unknown>): Promise<void>;
+    duplicate(offsetX?: number, offsetY?: number): Promise<ConnectorHandle>;
+    getData(): Promise<ConnectorObject>;
+}
+//# sourceMappingURL=connector-handle.d.ts.map

package/dist/api/worksheet/handles/connector-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/connector-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,yGAAyG;IACzG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACxE,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACrC"}

package/dist/api/worksheet/handles/drawing-handle.d.ts

@@ -0,0 +1,14 @@
+import type { DrawingObject, InkStroke, StrokeId } from '../../../ink/types';
+import type { StrokeTransformParams } from '../../types';
+import type { FloatingObjectHandle } from './floating-object-handle';
+export interface DrawingHandle extends FloatingObjectHandle {
+    addStroke(stroke: InkStroke): Promise<void>;
+    eraseStrokes(strokeIds: StrokeId[]): Promise<void>;
+    clearStrokes(): Promise<void>;
+    moveStrokes(strokeIds: StrokeId[], dx: number, dy: number): Promise<void>;
+    transformStrokes(strokeIds: StrokeId[], transform: StrokeTransformParams): Promise<void>;
+    findStrokesAtPoint(x: number, y: number, tolerance?: number): Promise<StrokeId[]>;
+    duplicate(offsetX?: number, offsetY?: number): Promise<DrawingHandle>;
+    getData(): Promise<DrawingObject>;
+}
+//# sourceMappingURL=drawing-handle.d.ts.map

package/dist/api/worksheet/handles/drawing-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawing-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/drawing-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClF,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACnC"}

package/dist/api/worksheet/handles/equation-handle.d.ts

@@ -0,0 +1,9 @@
+import type { EquationObject } from '../../../objects/floating-objects';
+import type { EquationUpdates } from '../../types';
+import type { FloatingObjectHandle } from './floating-object-handle';
+export interface EquationHandle extends FloatingObjectHandle {
+    update(props: EquationUpdates): Promise<void>;
+    duplicate(offsetX?: number, offsetY?: number): Promise<EquationHandle>;
+    getData(): Promise<EquationObject>;
+}
+//# sourceMappingURL=equation-handle.d.ts.map

package/dist/api/worksheet/handles/equation-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equation-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/equation-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvE,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACpC"}

package/dist/api/worksheet/handles/floating-object-handle.d.ts

@@ -0,0 +1,75 @@
+/**
+ * FloatingObjectHandle — Base handle for all floating objects.
+ *
+ * Provides hosting operations (move, resize, rotate, flip, z-order, lifecycle)
+ * that are universal to ALL floating object types. Type-specific content
+ * operations are on subtype handles.
+ *
+ * Handles are stateless facades — they carry identity and delegate to kernel
+ * services. They are NOT disposable. A handle is just a typed reference.
+ */
+import type { FloatingObject, FloatingObjectType } from '../../../objects/floating-objects';
+import type { ObjectBounds } from '../../../objects/object-bounds-reader';
+import type { FloatingObjectDeleteReceipt, FloatingObjectMutationReceipt } from '../../mutation-receipt';
+import type { ChartHandle } from './chart-handle';
+import type { ConnectorHandle } from './connector-handle';
+import type { DrawingHandle } from './drawing-handle';
+import type { EquationHandle } from './equation-handle';
+import type { OleObjectHandle } from './ole-object-handle';
+import type { PictureHandle } from './picture-handle';
+import type { ShapeHandle } from './shape-handle';
+import type { SlicerHandle } from './slicer-handle';
+import type { SmartArtHandle } from './smartart-handle';
+import type { TextBoxHandle } from './textbox-handle';
+import type { WordArtHandle } from './wordart-handle';
+export interface FloatingObjectHandle {
+    /** Stable object ID. */
+    readonly id: string;
+    /** Discriminator for type narrowing. */
+    readonly type: FloatingObjectType;
+    /**
+     * Move by delta. dx/dy are pixel offsets (relative).
+     * Rust resolves to new cell anchor.
+     */
+    move(dx: number, dy: number): Promise<FloatingObjectMutationReceipt>;
+    /** Set absolute dimensions in pixels. */
+    resize(width: number, height: number): Promise<FloatingObjectMutationReceipt>;
+    /** Set absolute rotation angle in degrees. */
+    rotate(angle: number): Promise<void>;
+    /** Flip horizontally or vertically. */
+    flip(axis: 'horizontal' | 'vertical'): Promise<void>;
+    bringToFront(): Promise<void>;
+    sendToBack(): Promise<void>;
+    bringForward(): Promise<void>;
+    sendBackward(): Promise<void>;
+    delete(): Promise<FloatingObjectDeleteReceipt>;
+    duplicate(offsetX?: number, offsetY?: number): Promise<FloatingObjectHandle>;
+    /** Sync pixel bounds from scene graph. Null if not rendered yet. */
+    getBounds(): ObjectBounds | null;
+    /** Full object data (async — reads from store). */
+    getData(): Promise<FloatingObject>;
+    isShape(): this is ShapeHandle;
+    isPicture(): this is PictureHandle;
+    isTextBox(): this is TextBoxHandle;
+    isDrawing(): this is DrawingHandle;
+    isEquation(): this is EquationHandle;
+    isWordArt(): this is WordArtHandle;
+    isSmartArt(): this is SmartArtHandle;
+    isChart(): this is ChartHandle;
+    isConnector(): this is ConnectorHandle;
+    isOleObject(): this is OleObjectHandle;
+    isSlicer(): this is SlicerHandle;
+    /** Narrowing with throw — use when type is expected. */
+    asShape(): ShapeHandle;
+    asPicture(): PictureHandle;
+    asTextBox(): TextBoxHandle;
+    asDrawing(): DrawingHandle;
+    asEquation(): EquationHandle;
+    asWordArt(): WordArtHandle;
+    asSmartArt(): SmartArtHandle;
+    asChart(): ChartHandle;
+    asConnector(): ConnectorHandle;
+    asOleObject(): OleObjectHandle;
+    asSlicer(): SlicerHandle;
+}
+//# sourceMappingURL=floating-object-handle.d.ts.map

package/dist/api/worksheet/handles/floating-object-handle.d.ts.map

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

package/dist/api/worksheet/handles/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Floating Object Handle Interfaces — Barrel Export
+ */
+export type { FloatingObjectHandle } from './floating-object-handle';
+export type { ShapeHandle } from './shape-handle';
+export type { PictureHandle } from './picture-handle';
+export type { TextBoxHandle } from './textbox-handle';
+export type { DrawingHandle } from './drawing-handle';
+export type { EquationHandle } from './equation-handle';
+export type { WordArtHandle } from './wordart-handle';
+export type { ConnectorHandle } from './connector-handle';
+export type { ChartHandle } from './chart-handle';
+export type { SmartArtHandle } from './smartart-handle';
+export type { SlicerHandle } from './slicer-handle';
+export type { OleObjectHandle } from './ole-object-handle';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/worksheet/handles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/api/worksheet/handles/ole-object-handle.d.ts

@@ -0,0 +1,10 @@
+import type { OleObjectObject } from '../../../objects/floating-objects';
+import type { FloatingObjectHandle } from './floating-object-handle';
+/**
+ * OLE object handle — hosting ops only. Parse-only type, no content mutations.
+ */
+export interface OleObjectHandle extends FloatingObjectHandle {
+    duplicate(offsetX?: number, offsetY?: number): Promise<OleObjectHandle>;
+    getData(): Promise<OleObjectObject>;
+}
+//# sourceMappingURL=ole-object-handle.d.ts.map

package/dist/api/worksheet/handles/ole-object-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ole-object-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/ole-object-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACxE,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACrC"}

package/dist/api/worksheet/handles/picture-handle.d.ts

@@ -0,0 +1,9 @@
+import type { PictureObject } from '../../../objects/floating-objects';
+import type { PictureConfig } from '../../types';
+import type { FloatingObjectHandle } from './floating-object-handle';
+export interface PictureHandle extends FloatingObjectHandle {
+    update(props: Partial<PictureConfig>): Promise<void>;
+    duplicate(offsetX?: number, offsetY?: number): Promise<PictureHandle>;
+    getData(): Promise<PictureObject>;
+}
+//# sourceMappingURL=picture-handle.d.ts.map

package/dist/api/worksheet/handles/picture-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picture-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/picture-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACnC"}

package/dist/api/worksheet/handles/shape-handle.d.ts

@@ -0,0 +1,11 @@
+import type { ShapeObject, ShapeType } from '../../../objects/floating-objects';
+import type { ShapeConfig } from '../../types';
+import type { FloatingObjectMutationReceipt } from '../../mutation-receipt';
+import type { FloatingObjectHandle } from './floating-object-handle';
+export interface ShapeHandle extends FloatingObjectHandle {
+    readonly shapeType: ShapeType;
+    update(props: Partial<ShapeConfig>): Promise<FloatingObjectMutationReceipt>;
+    duplicate(offsetX?: number, offsetY?: number): Promise<ShapeHandle>;
+    getData(): Promise<ShapeObject>;
+}
+//# sourceMappingURL=shape-handle.d.ts.map

package/dist/api/worksheet/handles/shape-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/shape-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,WAAY,SAAQ,oBAAoB;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC5E,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpE,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC"}

package/dist/api/worksheet/handles/slicer-handle.d.ts

@@ -0,0 +1,13 @@
+import type { FloatingObjectHandle } from './floating-object-handle';
+/**
+ * Slicer handle — hosting ops only.
+ * Content ops (selection, filter state) via ws.slicers.*
+ *
+ * Note: SlicerObject is not in the FloatingObject union (slicers use
+ * their own type system in contracts/src/data/slicers.ts).
+ * getData() returns the base FloatingObject type.
+ */
+export interface SlicerHandle extends FloatingObjectHandle {
+    duplicate(offsetX?: number, offsetY?: number): Promise<SlicerHandle>;
+}
+//# sourceMappingURL=slicer-handle.d.ts.map

package/dist/api/worksheet/handles/slicer-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slicer-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/slicer-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACtE"}

package/dist/api/worksheet/handles/smartart-handle.d.ts

@@ -0,0 +1,11 @@
+import type { SmartArtObject } from '../../../objects/floating-objects';
+import type { FloatingObjectHandle } from './floating-object-handle';
+/**
+ * SmartArt handle — hosting ops only.
+ * Content ops (nodes, layout, style) via ws.smartArt.*
+ */
+export interface SmartArtHandle extends FloatingObjectHandle {
+    duplicate(offsetX?: number, offsetY?: number): Promise<SmartArtHandle>;
+    getData(): Promise<SmartArtObject>;
+}
+//# sourceMappingURL=smartart-handle.d.ts.map

package/dist/api/worksheet/handles/smartart-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartart-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/smartart-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvE,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACpC"}

package/dist/api/worksheet/handles/textbox-handle.d.ts

@@ -0,0 +1,9 @@
+import type { TextBoxObject } from '../../../objects/floating-objects';
+import type { TextBoxConfig } from '../../types';
+import type { FloatingObjectHandle } from './floating-object-handle';
+export interface TextBoxHandle extends FloatingObjectHandle {
+    update(props: Partial<TextBoxConfig>): Promise<void>;
+    duplicate(offsetX?: number, offsetY?: number): Promise<TextBoxHandle>;
+    getData(): Promise<TextBoxObject>;
+}
+//# sourceMappingURL=textbox-handle.d.ts.map

package/dist/api/worksheet/handles/textbox-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textbox-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/textbox-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACnC"}

package/dist/api/worksheet/handles/wordart-handle.d.ts

@@ -0,0 +1,10 @@
+import type { TextBoxObject } from '../../../objects/floating-objects';
+import type { WordArtUpdates } from '../../types';
+import type { FloatingObjectHandle } from './floating-object-handle';
+/** WordArt objects are textboxes with WordArt configuration. */
+export interface WordArtHandle extends FloatingObjectHandle {
+    update(props: WordArtUpdates): Promise<void>;
+    duplicate(offsetX?: number, offsetY?: number): Promise<WordArtHandle>;
+    getData(): Promise<TextBoxObject>;
+}
+//# sourceMappingURL=wordart-handle.d.ts.map

package/dist/api/worksheet/handles/wordart-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wordart-handle.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/handles/wordart-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,gEAAgE;AAChE,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACnC"}

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

@@ -0,0 +1,52 @@
+/**
+ * WorksheetHyperlinks — Sub-API for cell hyperlink operations.
+ *
+ * Provides methods to set, get, and remove hyperlinks on cells.
+ */
+/** Sub-API for hyperlink operations on a worksheet. */
+export interface WorksheetHyperlinks {
+    /**
+     * Set a hyperlink on a cell.
+     *
+     * @param address - A1-style cell address (e.g. "A1")
+     * @param url - Hyperlink URL
+     */
+    set(address: string, url: string): Promise<void>;
+    /**
+     * Set a hyperlink on a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @param url - Hyperlink URL
+     */
+    set(row: number, col: number, url: string): Promise<void>;
+    /**
+     * Get the hyperlink URL for a cell.
+     *
+     * @param address - A1-style cell address
+     * @returns The hyperlink URL, or null if no hyperlink
+     */
+    get(address: string): Promise<string | null>;
+    /**
+     * Get the hyperlink URL for a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns The hyperlink URL, or null if no hyperlink
+     */
+    get(row: number, col: number): Promise<string | null>;
+    /**
+     * Remove a hyperlink from a cell.
+     *
+     * @param address - A1-style cell address
+     */
+    remove(address: string): Promise<void>;
+    /**
+     * Remove a hyperlink from a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     */
+    remove(row: number, col: number): Promise<void>;
+}
+//# sourceMappingURL=hyperlinks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyperlinks.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/hyperlinks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEtD;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}

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

@@ -0,0 +1,35 @@
+/**
+ * Worksheet Sub-API Interfaces — Barrel Export
+ *
+ * All worksheet namespace interfaces for the unified spreadsheet API.
+ */
+export type { WorksheetBindings } from './bindings';
+export type { ChangeOrigin, ChangeRecord, ChangeTracker, ChangeTrackOptions, WorksheetChanges, } from './changes';
+export type { ChartImageExporter, WorksheetCharts } from './charts';
+export type { WorksheetComments } from './comments';
+export type { ConditionalFormatUpdate, WorksheetConditionalFormatting, } from './conditional-formats';
+export type { WorksheetFilters } from './filters';
+export type { WorksheetFormControls } from './form-controls';
+export type { WorksheetFormats } from './formats';
+export type { WorksheetHyperlinks } from './hyperlinks';
+export type { WorksheetInternal } from './internal';
+export type { WorksheetLayout } from './layout';
+export type { WorksheetNames } from './names';
+/** @internal — kept for kernel WorksheetObjectsImpl; not part of the public Worksheet interface. */
+export type { WorksheetObjects } from './objects';
+export type { WorksheetOutline } from './outline';
+export type { WorksheetPivots } from './pivots';
+export type { WorksheetPrint } from './print';
+export type { WorksheetProtection } from './protection';
+export type { WorksheetSettings } from './settings';
+export type { WorksheetSlicers } from './slicers';
+export type { NodeMoveDirection, NodePosition, WorksheetSmartArt } from './smartart';
+export type { WorksheetSparklines } from './sparklines';
+export type { WorksheetStructure } from './structure';
+export type { WorksheetTables } from './tables';
+export type { WorksheetValidation } from './validation';
+export type { WorksheetView } from './view';
+export { officeJsAngleToOoxmlRotation, ooxmlRotationToOfficeJsAngle, officeJsPatternToOoxml, ooxmlPatternToOfficeJs, clampIndent, MAX_INDENT_LEVEL, } from './format-mappings';
+export type { FloatingObjectHandle, ShapeHandle, PictureHandle, TextBoxHandle, DrawingHandle, EquationHandle, WordArtHandle, ConnectorHandle, ChartHandle, SmartArtHandle, SlicerHandle, OleObjectHandle, } from './handles/index';
+export type { WorksheetObjectCollection, WorksheetShapeCollection, WorksheetPictureCollection, WorksheetTextBoxCollection, WorksheetDrawingCollection, WorksheetEquationCollection, WorksheetWordArtCollection, WorksheetConnectorCollection, } from './collections/index';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EACV,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,oGAAoG;AACpG,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrF,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAG5C,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,eAAe,EACf,WAAW,EACX,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,105 @@
+/**
+ * WorksheetInternal — Internal plumbing interface (NOT public API).
+ *
+ * Exposes low-level operations needed by internal consumers (bridges,
+ * formula bar, action handlers) but NOT part of the public Worksheet surface.
+ * Only exposed on WorksheetImpl directly, never on the Worksheet interface.
+ */
+import type { IdentityFormula } from '../../cells/cell-identity';
+import type { TableConfig } from '../../data/tables';
+import type { CellRange, ConditionalFormatCache } from '../types';
+/** Internal worksheet operations — not part of the public Worksheet API. */
+export interface WorksheetInternal {
+    /**
+     * Get the cell ID at a given position, or null if no cell exists there.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns Cell ID string or null
+     */
+    getCellIdAt(row: number, col: number): Promise<string | null>;
+    /**
+     * Get or create a cell ID at the given position.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns Cell ID string (guaranteed to exist after call)
+     */
+    getOrCreateCellId(row: number, col: number): Promise<string>;
+    /**
+     * Reverse-lookup: get the (row, col) position of a cell by its ID.
+     *
+     * @param cellId - The cell ID to look up
+     * @returns Position object, or null if the cell ID is not found
+     */
+    getCellPosition(cellId: string): Promise<{
+        row: number;
+        col: number;
+    } | null>;
+    /**
+     * Batch reverse-lookup: get positions for multiple cell IDs at once.
+     *
+     * @param cellIds - Array of cell IDs to look up
+     * @returns Map from cell ID to position (missing IDs are omitted)
+     */
+    batchGetCellPositions(cellIds: string[]): Promise<Map<string, {
+        row: number;
+        col: number;
+    }>>;
+    /**
+     * Reactive conditional format cache.
+     * Previously exposed as `ws.conditionalFormats` — renamed to avoid collision
+     * with the new conditionalFormats sub-API.
+     */
+    readonly cfCache: ConditionalFormatCache;
+    /**
+     * Get the edit-mode string representation of a cell value.
+     * Used by formula bar and in-cell editing.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @param editText - Optional pre-computed edit text (for date/time cells)
+     * @returns The string to display in edit mode
+     */
+    getValueForEditing(row: number, col: number, editText?: string): Promise<string>;
+    /**
+     * Convert an identity formula to an A1-display string.
+     *
+     * @param identityFormula - The identity formula to convert
+     * @returns A1-notation display string
+     */
+    toA1Display(identityFormula: IdentityFormula): Promise<string>;
+    /**
+     * Get the full table configuration for a cell, if the cell is inside a table.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns Full table config, or undefined if not in a table
+     */
+    getTableConfig(row: number, col: number): Promise<TableConfig | undefined>;
+    /**
+     * Get raw store-level data for a cell. Used for debugging and internal tooling.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns Raw cell store data (shape is implementation-dependent)
+     */
+    getCellStoreData(row: number, col: number): Promise<unknown>;
+    /**
+     * Clamp a range to the actual data bounds of the sheet.
+     * Full-column and full-row ranges are shrunk to the data extent plus a buffer.
+     *
+     * @param range - The range to clamp
+     * @returns Clamped range (non-full ranges are returned as-is)
+     */
+    clampRangeToDataBounds(range: CellRange): Promise<CellRange>;
+    /**
+     * Relocate (move) cells from a source range to a target position.
+     *
+     * @param sourceRange - The range of cells to move
+     * @param targetRow - Destination top-left row (0-based)
+     * @param targetCol - Destination top-left column (0-based)
+     */
+    relocateCells(sourceRange: CellRange, targetRow: number, targetCol: number): Promise<void>;
+}
+//# sourceMappingURL=internal.d.ts.map