@mog-sdk/spreadsheet-contracts 0.1.12

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

@@ -0,0 +1,12 @@
+/**
+ * Floating Object Collection Interfaces — Barrel Export
+ */
+export type { WorksheetObjectCollection } from './object-collection';
+export type { WorksheetShapeCollection } from './shape-collection';
+export type { WorksheetPictureCollection } from './picture-collection';
+export type { WorksheetTextBoxCollection } from './textbox-collection';
+export type { WorksheetDrawingCollection } from './drawing-collection';
+export type { WorksheetEquationCollection } from './equation-collection';
+export type { WorksheetWordArtCollection } from './wordart-collection';
+export type { WorksheetConnectorCollection } from './connector-collection';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * WorksheetObjectCollection — universal floating object collection.
+ *
+ * Returns base FloatingObjectHandle instances. For type-specific handles
+ * with content operations, use the typed collections (ws.shapes, ws.drawings, etc.)
+ * or type-narrow from the base handle.
+ */
+import type { ObjectBounds } from '../../../kernel/floating-object-manager';
+import type { FloatingObjectInfo } from '../../types';
+import type { FloatingObjectHandle } from '../handles/floating-object-handle';
+export interface WorksheetObjectCollection {
+    /** Get a floating object handle by ID. Returns null if not found. */
+    get(id: string): Promise<FloatingObjectHandle | null>;
+    /** Get summary info (with spatial fields) for a floating object. Returns null if not found. */
+    getInfo(id: string): Promise<FloatingObjectInfo | null>;
+    /** List all floating objects on the sheet. */
+    list(): Promise<FloatingObjectHandle[]>;
+    /** Delete multiple floating objects. Returns count of successfully deleted. */
+    deleteMany(ids: string[]): Promise<number>;
+    /** Delete a single floating object by ID. Returns true if deleted. */
+    delete(id: string): Promise<boolean>;
+    /** Bring a floating object to the front (highest z-order). */
+    bringToFront(id: string): Promise<void>;
+    /** Send a floating object to the back (lowest z-order). */
+    sendToBack(id: string): Promise<void>;
+    /** Bring a floating object forward by one layer. */
+    bringForward(id: string): Promise<void>;
+    /** Send a floating object backward by one layer. */
+    sendBackward(id: string): Promise<void>;
+    /** Update arbitrary properties of a floating object. */
+    update(objectId: string, updates: Record<string, unknown>): Promise<void>;
+    /** Convert a text box to WordArt by applying WordArt styling. */
+    convertToWordArt(objectId: string, presetId?: string): Promise<void>;
+    /** Convert WordArt back to a regular text box by removing WordArt styling. */
+    convertToTextBox(objectId: string): Promise<void>;
+    /** Compute pixel bounding box for a floating object (async — uses ComputeBridge). */
+    computeObjectBounds(objectId: string): Promise<ObjectBounds | null>;
+    /** Batch-compute pixel bounds for all floating objects on this sheet. */
+    computeAllObjectBounds(): Promise<Map<string, ObjectBounds>>;
+    /** Group multiple floating objects. Returns the group ID. */
+    group(ids: string[]): Promise<string>;
+    /** Ungroup a floating object group. */
+    ungroup(groupId: string): Promise<void>;
+}
+//# sourceMappingURL=object-collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object-collection.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/object-collection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,qEAAqE;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACtD,+FAA+F;IAC/F,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACxD,8CAA8C;IAC9C,IAAI,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACxC,+EAA+E;IAC/E,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAK3C,sEAAsE;IACtE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,oDAAoD;IACpD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,oDAAoD;IACpD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,wDAAwD;IACxD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAI1E,iEAAiE;IACjE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,8EAA8E;IAC9E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIlD,qFAAqF;IACrF,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACpE,yEAAyE;IACzE,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAI7D,6DAA6D;IAC7D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,uCAAuC;IACvC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"picture-collection.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/picture-collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,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,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACpD"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"shape-collection.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/shape-collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/B,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChD"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"textbox-collection.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/textbox-collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,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,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACpD"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"wordart-collection.d.ts","sourceRoot":"","sources":["../../../../src/api/worksheet/collections/wordart-collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,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,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACpD"}

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

@@ -0,0 +1,143 @@
+/**
+ * WorksheetComments — Sub-API for comment and note operations.
+ *
+ * Provides methods for simple notes (single string per cell) and
+ * threaded comments (multi-author, resolvable).
+ */
+import type { Comment, Note } from '../types';
+/** Sub-API for comment and note operations on a worksheet. */
+export interface WorksheetComments {
+    /**
+     * Add a note to a cell.
+     *
+     * @param address - A1-style cell address (e.g. "A1")
+     * @param text - Note text
+     * @param author - Optional author name (defaults to 'api')
+     */
+    addNote(address: string, text: string, author?: string): Promise<void>;
+    /**
+     * Add a note to a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @param text - Note text
+     * @param author - Optional author name (defaults to 'api')
+     */
+    addNote(row: number, col: number, text: string, author?: string): Promise<void>;
+    /**
+     * Get the note for a cell as a Note object.
+     *
+     * @param address - A1-style cell address
+     * @returns The Note object, or null if no note
+     */
+    getNote(address: string): Promise<Note | null>;
+    /**
+     * Get the note for a cell as a Note object.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns The Note object, or null if no note
+     */
+    getNote(row: number, col: number): Promise<Note | null>;
+    /**
+     * Remove the note from a cell.
+     *
+     * @param address - A1-style cell address
+     */
+    removeNote(address: string): Promise<void>;
+    /**
+     * Remove the note from a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     */
+    removeNote(row: number, col: number): Promise<void>;
+    /**
+     * Get the number of comments in the worksheet.
+     *
+     * @returns The total comment count
+     */
+    count(): Promise<number>;
+    /**
+     * Add a threaded comment to a cell.
+     *
+     * @param address - A1-style cell address
+     * @param text - Comment text
+     * @param author - Author name or identifier
+     */
+    add(address: string, text: string, author: string): Promise<Comment>;
+    /**
+     * Add a threaded comment to a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @param text - Comment text
+     * @param author - Author name or identifier
+     */
+    add(row: number, col: number, text: string, author: string): Promise<Comment>;
+    /**
+     * Update an existing comment's text.
+     *
+     * @param commentId - Comment identifier
+     * @param text - New comment text
+     */
+    update(commentId: string, text: string): Promise<void>;
+    /**
+     * Delete a comment.
+     *
+     * @param commentId - Comment identifier
+     */
+    delete(commentId: string): Promise<void>;
+    /**
+     * Set the resolved state of a comment thread.
+     *
+     * @param threadId - Thread identifier (cell ID)
+     * @param resolved - Whether the thread should be marked as resolved
+     */
+    resolveThread(threadId: string, resolved: boolean): Promise<void>;
+    /**
+     * List all comments in the worksheet.
+     *
+     * @returns Array of all comments
+     */
+    list(): Promise<Comment[]>;
+    /**
+     * Get all comments for a specific cell.
+     *
+     * @param address - A1-style cell address
+     * @returns Array of comments for the cell
+     */
+    getForCell(address: string): Promise<Comment[]>;
+    /**
+     * Get all comments for a specific cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns Array of comments for the cell
+     */
+    getForCell(row: number, col: number): Promise<Comment[]>;
+    /**
+     * Add a reply to an existing comment.
+     *
+     * @param commentId - ID of the comment to reply to
+     * @param text - Reply text
+     * @param author - Author name or identifier
+     * @returns The created reply comment
+     */
+    addReply(commentId: string, text: string, author: string): Promise<Comment>;
+    /**
+     * Get all comments in a thread (root + replies), sorted by createdAt.
+     *
+     * @param commentId - ID of any comment in the thread
+     * @returns Array of comments in the thread
+     */
+    getThread(commentId: string): Promise<Comment[]>;
+    /**
+     * Get a single comment by its ID.
+     *
+     * @param commentId - Comment identifier
+     * @returns The comment, or null if not found
+     */
+    getById(commentId: string): Promise<Comment | null>;
+}
+//# sourceMappingURL=comments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAKhC;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhF;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC/C;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAExD;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAMzB;;;;;;OAMG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE;;;;;;;OAOG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E;;;;;OAKG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAE3B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEzD;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CACrD"}

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

@@ -0,0 +1,101 @@
+/**
+ * WorksheetConditionalFormatting — Sub-API for conditional formatting operations.
+ *
+ * Provides methods to add, update, remove, and query conditional formats
+ * on a worksheet. Operates at the format level (not individual rules).
+ */
+import type { CellRange, CFRule, CFRuleInput, ConditionalFormat } from '../types';
+/** Update payload for a conditional format. */
+export interface ConditionalFormatUpdate {
+    /** Replace the rules array. */
+    rules?: CFRule[];
+    /** Replace the ranges this format applies to. */
+    ranges?: CellRange[];
+    /** Set stopIfTrue on all rules in this format. */
+    stopIfTrue?: boolean;
+}
+/** Sub-API for conditional formatting operations on a worksheet. */
+export interface WorksheetConditionalFormatting {
+    /**
+     * Add a new conditional format with ranges and rules.
+     * The API assigns IDs and priorities — callers provide rule configuration only.
+     *
+     * @param ranges - Cell ranges this format applies to
+     * @param rules - Rule inputs (without id/priority)
+     * @returns The generated format ID
+     */
+    add(ranges: CellRange[], rules: CFRuleInput[]): Promise<string>;
+    /**
+     * Get a conditional format by its ID.
+     *
+     * @param formatId - Format ID to look up
+     * @returns The conditional format, or null if not found
+     */
+    get(formatId: string): Promise<ConditionalFormat | null>;
+    /**
+     * Update an existing conditional format.
+     * Supports replacing rules, ranges, and setting stopIfTrue on all rules.
+     *
+     * @param formatId - Format ID to update
+     * @param updates - Object with optional rules, ranges, and stopIfTrue
+     */
+    update(formatId: string, updates: ConditionalFormatUpdate): Promise<void>;
+    /**
+     * Clear the style of a specific rule within a conditional format, resetting
+     * all style properties (font, fill, border, number format) to unset.
+     *
+     * @param formatId - Format ID containing the rule
+     * @param ruleId - Rule ID within the format to clear style for
+     */
+    clearRuleStyle(formatId: string, ruleId: string): Promise<void>;
+    /**
+     * Remove a conditional format by ID.
+     *
+     * @param formatId - Format ID to remove
+     */
+    remove(formatId: string): Promise<void>;
+    /**
+     * Get all conditional formats on the sheet.
+     *
+     * @returns Array of conditional format objects
+     */
+    list(): Promise<ConditionalFormat[]>;
+    /**
+     * Clear all conditional formats from the sheet.
+     */
+    clear(): Promise<void>;
+    /**
+     * Clear conditional formats that intersect with the given ranges.
+     *
+     * @param ranges - Ranges to clear conditional formats from
+     */
+    clearInRanges(ranges: CellRange[]): Promise<void>;
+    /**
+     * Reorder conditional formats by format ID array (first = highest priority).
+     *
+     * @param formatIds - Array of format IDs in the desired order
+     */
+    reorder(formatIds: string[]): Promise<void>;
+    /**
+     * Clone conditional formats from source to target with offset.
+     * Used by format painter and paste operations.
+     *
+     * @param sourceSheetId - Source sheet ID (for cut operation reference removal)
+     * @param relativeCFs - Relative CF formats with range offsets
+     * @param origin - Target paste origin (row, col)
+     * @param isCut - Whether this is a cut operation
+     */
+    cloneForPaste(sourceSheetId: string, relativeCFs: Array<{
+        rules: any[];
+        rangeOffsets: Array<{
+            startRowOffset: number;
+            startColOffset: number;
+            endRowOffset: number;
+            endColOffset: number;
+        }>;
+    }>, origin: {
+        row: number;
+        col: number;
+    }, isCut: boolean): Promise<void>;
+}
+//# sourceMappingURL=conditional-formats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-formats.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/conditional-formats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElF,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,oEAAoE;AACpE,MAAM,WAAW,8BAA8B;IAC7C;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAEzD;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAErC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;;;;;OAQG;IACH,aAAa,CACX,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,GAAG,EAAE,CAAC;QACb,YAAY,EAAE,KAAK,CAAC;YAClB,cAAc,EAAE,MAAM,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;YACvB,YAAY,EAAE,MAAM,CAAC;YACrB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;KACJ,CAAC,EACF,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EACpC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

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

@@ -0,0 +1,141 @@
+/**
+ * WorksheetFilters — Sub-API for filter operations.
+ *
+ * Provides methods to create, query, and manage auto-filters and
+ * CellId-aware filter operations on a worksheet.
+ */
+import type { ColumnFilterCriteria } from '../../data/filter';
+import type { CellRange, FilterDetailInfo, FilterInfo, FilterSortState, FilterState } from '../types';
+/** Sub-API for filter operations on a worksheet. */
+export interface WorksheetFilters {
+    /**
+     * Set an auto-filter on the sheet by parsing an A1-style range string.
+     *
+     * @param range - A1-style range string (e.g. "A1:D100")
+     */
+    setAutoFilter(range: string): Promise<void>;
+    /**
+     * Create an auto-filter from a CellRange (position-based).
+     *
+     * @param range - Range object with start/end row and column
+     */
+    createAutoFilter(range: CellRange): Promise<void>;
+    /**
+     * Clear the auto-filter from the sheet.
+     * Removes all filters, not just criteria.
+     */
+    clearAutoFilter(): Promise<void>;
+    /**
+     * Get the current auto-filter state.
+     *
+     * @returns The filter state, or null if no auto-filter is set
+     */
+    getAutoFilter(): Promise<FilterState | null>;
+    /**
+     * Get the filter overlapping a range, or null if none.
+     *
+     * @param range - Range to check for filter overlap
+     * @returns Object with filter ID if found, or null
+     */
+    getForRange(range: CellRange): Promise<{
+        id: string;
+    } | null>;
+    /**
+     * Remove a specific filter by its ID.
+     *
+     * @param filterId - Filter ID to remove
+     */
+    remove(filterId: string): Promise<void>;
+    /**
+     * Set filter criteria for a column on the first auto-filter.
+     *
+     * @param col - Column index (0-based)
+     * @param criteria - Filter criteria to apply
+     */
+    setColumnFilter(col: number, criteria: ColumnFilterCriteria): Promise<void>;
+    /**
+     * Clear filter criteria for a column on the first auto-filter.
+     *
+     * @param col - Column index (0-based)
+     */
+    clearColumnFilter(col: number): Promise<void>;
+    /**
+     * Get unique values in a column (for filter dropdowns).
+     * Uses the first auto-filter.
+     *
+     * @param col - Column index (0-based)
+     * @returns Array of unique values
+     */
+    getUniqueValues(col: number): Promise<any[]>;
+    /**
+     * Set filter criteria for a column using filter ID.
+     *
+     * @param filterId - Filter ID
+     * @param col - Column index (0-based)
+     * @param criteria - Filter criteria to apply
+     */
+    setCriteria(filterId: string, col: number, criteria: ColumnFilterCriteria): Promise<void>;
+    /**
+     * Clear filter criteria for a column.
+     *
+     * @param filterId - Filter ID
+     * @param col - Column index (0-based)
+     */
+    clearCriteria(filterId: string, col: number): Promise<void>;
+    /**
+     * Clear all filter criteria for a filter.
+     * Removes filters from all columns but keeps the filter structure intact.
+     *
+     * @param filterId - Filter ID
+     */
+    clearAllCriteria(filterId: string): Promise<void>;
+    /**
+     * Apply a filter (Rust evaluates criteria and updates row visibility).
+     *
+     * @param filterId - Filter ID to apply
+     */
+    apply(filterId: string): Promise<void>;
+    /**
+     * Get detailed filter info including resolved range and column filters.
+     *
+     * @param filterId - Filter ID
+     * @returns Detailed filter info, or null if not found
+     */
+    getInfo(filterId: string): Promise<FilterDetailInfo | null>;
+    /**
+     * Get unique values for a filter column.
+     *
+     * @param filterId - Filter ID
+     * @param col - Column index (0-based)
+     * @returns Array of unique values
+     */
+    getFilterUniqueValues(filterId: string, col: number): Promise<any[]>;
+    /**
+     * List all filters in the sheet.
+     *
+     * @returns Array of filter info objects
+     */
+    list(): Promise<FilterInfo[]>;
+    /**
+     * List all filters with resolved numeric ranges and column filters.
+     * Single bridge call — avoids the N+1 pattern.
+     *
+     * @returns Array of detailed filter info objects
+     */
+    listDetails(): Promise<FilterDetailInfo[]>;
+    /**
+     * Get the sort state for a filter.
+     *
+     * @param filterId - Filter ID
+     * @returns Sort state, or null if no sort state set
+     */
+    getSortState(filterId: string): Promise<FilterSortState | null>;
+    /**
+     * Set the sort state for a filter.
+     *
+     * @param filterId - Filter ID
+     * @param state - Sort state to set
+     */
+    setSortState(filterId: string, state: FilterSortState): Promise<void>;
+}
+//# sourceMappingURL=filters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/filters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;OAIG;IACH,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE9D;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;OAIG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;;;OAMG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE7C;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1F;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAE5D;;;;;;OAMG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAErE;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,WAAW,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE"}

package/dist/api/worksheet/form-controls.d.ts

@@ -0,0 +1,22 @@
+/**
+ * WorksheetFormControls — Sub-API for form controls (Checkbox, Button, ComboBox).
+ *
+ * Read-only access to form controls for a sheet. Controls are document-scoped
+ * (managed by FormControlManager on the Workbook), but this sub-API filters
+ * to the current sheet.
+ *
+ * Values live in linked cells (accessed via worksheet.getCell/setCell),
+ * NOT on the controls themselves.
+ *
+ * @see contracts/src/editor/form-controls.ts — Type definitions
+ */
+import type { FormControl } from '../../editor/form-controls';
+export interface WorksheetFormControls {
+    /** Get all form controls on this sheet. */
+    list(): FormControl[];
+    /** Get a specific form control by ID. Returns undefined if not found or not on this sheet. */
+    get(controlId: string): FormControl | undefined;
+    /** Get form controls at a specific cell position (for hit testing). */
+    getAtPosition(row: number, col: number): FormControl[];
+}
+//# sourceMappingURL=form-controls.d.ts.map

package/dist/api/worksheet/form-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-controls.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/form-controls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,IAAI,IAAI,WAAW,EAAE,CAAC;IAEtB,8FAA8F;IAC9F,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAEhD,uEAAuE;IACvE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACxD"}

package/dist/api/worksheet/format-mappings.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Format mapping utilities for OfficeJS API compatibility.
+ *
+ * Provides bidirectional conversions between OfficeJS format representations
+ * and OOXML/Mog internal representations.
+ */
+import type { PatternType } from '../../core/core';
+/**
+ * Convert an OfficeJS text orientation angle to an OOXML text rotation value.
+ *
+ * OfficeJS uses: -90 to 90 (degrees), plus 180 for vertical stacked text.
+ * OOXML uses: 0-90 as-is, 91-180 for negative angles, 255 for vertical stacked.
+ *
+ * Conversion:
+ *  - angle >= 0  → rotation = angle (clamped to 90)
+ *  - angle < 0   → rotation = 90 + |angle| (clamped to 180)
+ *  - angle === 180 → rotation = 255 (vertical stacked)
+ */
+export declare function officeJsAngleToOoxmlRotation(angle: number): number;
+/**
+ * Convert an OOXML text rotation value to an OfficeJS text orientation angle.
+ *
+ * OOXML uses: 0-90 as-is, 91-180 for negative angles, 255 for vertical stacked.
+ * OfficeJS uses: -90 to 90 (degrees), plus 180 for vertical stacked text.
+ *
+ * Conversion:
+ *  - rotation <= 90       → angle = rotation
+ *  - 90 < rotation <= 180 → angle = -(rotation - 90)
+ *  - rotation === 255     → angle = 180 (vertical stacked)
+ *  - otherwise            → 0
+ */
+export declare function ooxmlRotationToOfficeJsAngle(rotation: number): number;
+/**
+ * Convert an OfficeJS pattern name to an OOXML/Mog PatternType.
+ * Returns `'none'` for unrecognised names.
+ */
+export declare function officeJsPatternToOoxml(officeJsPattern: string): PatternType;
+/**
+ * Convert an OOXML/Mog PatternType to an OfficeJS pattern name.
+ * Returns `'None'` for unrecognised values.
+ */
+export declare function ooxmlPatternToOfficeJs(ooxmlPattern: PatternType): string;
+/** Maximum indent level supported by the OfficeJS-compatible API. */
+export declare const MAX_INDENT_LEVEL = 250;
+/**
+ * Clamp an indent value to the valid OfficeJS range (0-250).
+ * The value is rounded to the nearest integer before clamping.
+ */
+export declare function clampIndent(indent: number): number;
+//# sourceMappingURL=format-mappings.d.ts.map

package/dist/api/worksheet/format-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-mappings.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/format-mappings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKrE;AAoDD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAE3E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,WAAW,GAAG,MAAM,CAExE;AAMD,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD"}