@mog-sdk/spreadsheet-contracts 0.1.12

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

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

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

@@ -0,0 +1,143 @@
+/**
+ * WorksheetSparklines — Sub-API for sparkline operations.
+ *
+ * Provides methods to add, query, update, and remove sparklines and
+ * sparkline groups on a worksheet.
+ */
+import type { CreateSparklineGroupOptions, CreateSparklineOptions, Sparkline, SparklineGroup, SparklineType } from '../../data/sparklines';
+import type { CellRange } from '../types';
+/** Sub-API for sparkline operations on a worksheet. */
+export interface WorksheetSparklines {
+    /**
+     * Add a sparkline to a cell.
+     *
+     * @param cell - Cell position (row and col, 0-based)
+     * @param dataRange - Data range for the sparkline
+     * @param type - Sparkline type (line, column, winLoss)
+     * @param options - Optional creation settings
+     * @returns The created sparkline
+     */
+    add(cell: {
+        row: number;
+        col: number;
+    }, dataRange: CellRange, type: SparklineType, options?: CreateSparklineOptions): Promise<Sparkline>;
+    /**
+     * Add a group of sparklines with shared settings.
+     *
+     * @param cells - Array of cell positions
+     * @param dataRanges - Array of data ranges (must match cells length)
+     * @param type - Sparkline type
+     * @param options - Optional group creation settings
+     * @returns The created sparkline group
+     */
+    addGroup(cells: Array<{
+        row: number;
+        col: number;
+    }>, dataRanges: CellRange[], type: SparklineType, options?: CreateSparklineGroupOptions): Promise<SparklineGroup>;
+    /**
+     * Get a sparkline by ID.
+     *
+     * @param sparklineId - Sparkline identifier
+     * @returns The sparkline, or null if not found
+     */
+    get(sparklineId: string): Promise<Sparkline | null>;
+    /**
+     * Get the sparkline at a specific cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns The sparkline at the cell, or null if none
+     */
+    getAtCell(row: number, col: number): Promise<Sparkline | null>;
+    /**
+     * List all sparklines in the worksheet.
+     *
+     * @returns Array of all sparklines
+     */
+    list(): Promise<Sparkline[]>;
+    /**
+     * Get a sparkline group by ID.
+     *
+     * @param groupId - Group identifier
+     * @returns The sparkline group, or null if not found
+     */
+    getGroup(groupId: string): Promise<SparklineGroup | null>;
+    /**
+     * List all sparkline groups in the worksheet.
+     *
+     * @returns Array of all sparkline groups
+     */
+    listGroups(): Promise<SparklineGroup[]>;
+    /**
+     * Update a sparkline's settings.
+     *
+     * @param sparklineId - Sparkline identifier
+     * @param updates - Partial sparkline properties to update
+     */
+    update(sparklineId: string, updates: Partial<Sparkline>): Promise<void>;
+    /**
+     * Update a sparkline group's settings (applies to all members).
+     *
+     * @param groupId - Group identifier
+     * @param updates - Partial group properties to update
+     */
+    updateGroup(groupId: string, updates: Partial<SparklineGroup>): Promise<void>;
+    /**
+     * Remove a sparkline.
+     *
+     * @param sparklineId - Sparkline identifier
+     */
+    remove(sparklineId: string): Promise<void>;
+    /**
+     * Remove a sparkline group and all its member sparklines.
+     *
+     * @param groupId - Group identifier
+     */
+    removeGroup(groupId: string): Promise<void>;
+    /**
+     * Clear all sparklines whose cell falls within a range.
+     *
+     * @param range - Range to clear sparklines from
+     */
+    clearInRange(range: CellRange): Promise<void>;
+    /**
+     * Clear all sparklines in the worksheet.
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Add a sparkline to a group.
+     *
+     * @param sparklineId - Sparkline identifier
+     * @param groupId - Group identifier
+     */
+    addToGroup(sparklineId: string, groupId: string): Promise<void>;
+    /**
+     * Remove a sparkline from its group (becomes standalone).
+     *
+     * @param sparklineId - Sparkline identifier
+     */
+    removeFromGroup(sparklineId: string): Promise<void>;
+    /**
+     * Ungroup all sparklines in a group (members become standalone).
+     *
+     * @param groupId - Group identifier
+     * @returns IDs of sparklines that were ungrouped
+     */
+    ungroupAll(groupId: string): Promise<string[]>;
+    /**
+     * Check if a cell has a sparkline.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns True if the cell has a sparkline
+     */
+    has(row: number, col: number): Promise<boolean>;
+    /**
+     * Get sparklines whose data range intersects with a given range.
+     *
+     * @param range - Range to check for data intersection
+     * @returns Sparklines with data in the range
+     */
+    getWithDataInRange(range: CellRange): Promise<Sparkline[]>;
+}
+//# sourceMappingURL=sparklines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sparklines.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/sparklines.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,SAAS,EACT,cAAc,EACd,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;OAQG;IACH,GAAG,CACD,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAClC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtB;;;;;;;;OAQG;IACH,QAAQ,CACN,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,EAC1C,UAAU,EAAE,SAAS,EAAE,EACvB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B;;;;;OAKG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAEpD;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE/D;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAE1D;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAExC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9E;;;;OAIG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/C;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC5D"}

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

@@ -0,0 +1,44 @@
+/**
+ * WorksheetStructure — Sub-API Interface for Structure Operations
+ *
+ * Row/column insertion and deletion, cell shifting, dimensions,
+ * text-to-columns, remove duplicates, and merge operations.
+ */
+import type { CellRange, MergedRegion, RemoveDuplicatesResult, TextToColumnsOptions } from '../types';
+export interface WorksheetStructure {
+    /** Insert rows starting at the given 0-based index. */
+    insertRows(index: number, count: number): Promise<void>;
+    /** Delete rows starting at the given 0-based index. */
+    deleteRows(index: number, count: number): Promise<void>;
+    /** Insert columns starting at the given 0-based index. */
+    insertColumns(index: number, count: number): Promise<void>;
+    /** Delete columns starting at the given 0-based index. */
+    deleteColumns(index: number, count: number): Promise<void>;
+    /** Insert cells by shifting existing cells in the specified direction. */
+    insertCellsWithShift(startRow: number, startCol: number, endRow: number, endCol: number, direction: 'right' | 'down'): Promise<void>;
+    /** Delete cells by shifting remaining cells in the specified direction. */
+    deleteCellsWithShift(startRow: number, startCol: number, endRow: number, endCol: number, direction: 'left' | 'up'): Promise<void>;
+    /** Get the number of rows with data. */
+    getRowCount(): Promise<number>;
+    /** Get the number of columns with data. */
+    getColumnCount(): Promise<number>;
+    /** Split text in a column into multiple columns. */
+    textToColumns(range: string, options: TextToColumnsOptions): Promise<void>;
+    /** Remove duplicate rows in a range. */
+    removeDuplicates(range: string, columns: number[], hasHeaders?: boolean): Promise<RemoveDuplicatesResult>;
+    /** Merge cells by A1 range. */
+    merge(range: string): Promise<void>;
+    /** Merge cells by numeric bounds. */
+    merge(startRow: number, startCol: number, endRow: number, endCol: number): Promise<void>;
+    /** Unmerge cells by A1 range. */
+    unmerge(range: string): Promise<void>;
+    /** Unmerge cells by numeric bounds. */
+    unmerge(startRow: number, startCol: number, endRow: number, endCol: number): Promise<void>;
+    /** Get all merged regions in the sheet. */
+    getMergedRegions(): Promise<MergedRegion[]>;
+    /** Get the merge containing a cell by A1 address, or null if not merged. */
+    getMergeAtCell(address: string): Promise<CellRange | null>;
+    /** Get the merge containing a cell by row/col, or null if not merged. */
+    getMergeAtCell(row: number, col: number): Promise<CellRange | null>;
+}
+//# sourceMappingURL=structure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/structure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,kBAAkB;IAKjC,uDAAuD;IACvD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,uDAAuD;IACvD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,0DAA0D;IAC1D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,0DAA0D;IAC1D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAM3D,0EAA0E;IAC1E,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,GAAG,MAAM,GAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,2EAA2E;IAC3E,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,IAAI,CAAC,CAAC;IAMjB,wCAAwC;IACxC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/B,2CAA2C;IAC3C,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAMlC,oDAAoD;IACpD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E,wCAAwC;IACxC,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,CAAC,EAAE,OAAO,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAMnC,+BAA+B;IAC/B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,qCAAqC;IACrC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF,iCAAiC;IACjC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,uCAAuC;IACvC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3F,2CAA2C;IAC3C,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE5C,4EAA4E;IAC5E,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC3D,yEAAyE;IACzE,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACrE"}

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

@@ -0,0 +1,313 @@
+/**
+ * WorksheetTables — Sub-API for table operations on a worksheet.
+ *
+ * Provides methods to create, query, modify, and remove tables (ListObjects)
+ * within a worksheet. Tables are workbook-scoped by name but sheet-scoped
+ * for listing.
+ */
+import type { CellValue, TableInfo, TableOptions } from '../types';
+/** Sub-API for table operations on a worksheet. */
+export interface WorksheetTables {
+    /**
+     * Create a new table from a cell range.
+     *
+     * @param range - A1-style range string (e.g. "A1:D10")
+     * @param options - Optional table creation settings (name, headers, style)
+     * @returns The created table information
+     */
+    add(range: string, options?: TableOptions): Promise<TableInfo>;
+    /**
+     * Get a table by name.
+     *
+     * Tables are workbook-scoped, so the name is unique across all sheets.
+     *
+     * @param name - Table name
+     * @returns Table information, or null if not found
+     */
+    get(name: string): Promise<TableInfo | null>;
+    /**
+     * List all tables in this worksheet.
+     *
+     * @returns Array of table information objects
+     */
+    list(): Promise<TableInfo[]>;
+    /**
+     * Remove a table definition, converting it back to a plain range.
+     *
+     * Cell data is preserved; only the table metadata is removed.
+     *
+     * @param name - Table name
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * Rename a table.
+     *
+     * @param oldName - Current table name
+     * @param newName - New table name
+     */
+    rename(oldName: string, newName: string): Promise<void>;
+    /**
+     * Update a table's properties.
+     *
+     * @param tableName - Table name
+     * @param updates - Key-value pairs of properties to update
+     */
+    update(tableName: string, updates: Record<string, any>): Promise<void>;
+    /**
+     * Get the table at a specific cell position, if one exists.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns Table information, or null if no table exists at that cell
+     */
+    getAtCell(row: number, col: number): Promise<TableInfo | null>;
+    /**
+     * Clear all column filters on a table.
+     *
+     * @param tableName - Table name
+     */
+    clearFilters(tableName: string): Promise<void>;
+    /**
+     * Set the visual style preset for a table.
+     *
+     * @param tableName - Table name
+     * @param preset - Style preset name (e.g. "TableStyleLight1")
+     */
+    setStylePreset(tableName: string, preset: string): Promise<void>;
+    /**
+     * Resize a table to a new range.
+     *
+     * @param name - Table name
+     * @param newRange - New A1-style range string
+     */
+    resize(name: string, newRange: string): Promise<void>;
+    /**
+     * Add a column to a table.
+     *
+     * @param name - Table name
+     * @param columnName - Name for the new column
+     * @param position - Column position (0-based index). If omitted, appends to the end.
+     */
+    addColumn(name: string, columnName: string, position?: number): Promise<void>;
+    /**
+     * Remove a column from a table by index.
+     *
+     * @param name - Table name
+     * @param columnIndex - Column index within the table (0-based)
+     */
+    removeColumn(name: string, columnIndex: number): Promise<void>;
+    /**
+     * Toggle the totals row visibility on a table.
+     *
+     * @param name - Table name
+     */
+    toggleTotalsRow(name: string): Promise<void>;
+    /**
+     * Toggle the header row visibility on a table.
+     *
+     * @param name - Table name
+     */
+    toggleHeaderRow(name: string): Promise<void>;
+    /**
+     * Apply auto-expansion to a table, extending it to include adjacent data.
+     *
+     * @param tableName - Table name
+     */
+    applyAutoExpansion(tableName: string): Promise<void>;
+    /**
+     * Set a calculated column formula for all data cells in a table column.
+     *
+     * @param tableName - Table name
+     * @param colIndex - Column index within the table (0-based)
+     * @param formula - The formula to set (e.g. "=[@Price]*[@Quantity]")
+     */
+    setCalculatedColumn(tableName: string, colIndex: number, formula: string): Promise<void>;
+    /**
+     * Clear the calculated column formula from a table column, replacing with empty values.
+     *
+     * @param tableName - Table name
+     * @param colIndex - Column index within the table (0-based)
+     */
+    clearCalculatedColumn(tableName: string, colIndex: number): Promise<void>;
+    /**
+     * Get the A1-notation range covering the data body of a table (excludes header and totals rows).
+     *
+     * @param name - Table name
+     * @returns A1-notation range string, or null if the table has no data body rows
+     */
+    getDataBodyRange(name: string): Promise<string | null>;
+    /**
+     * Get the A1-notation range covering the header row of a table.
+     *
+     * @param name - Table name
+     * @returns A1-notation range string, or null if the table has no header row
+     */
+    getHeaderRowRange(name: string): Promise<string | null>;
+    /**
+     * Get the A1-notation range covering the totals row of a table.
+     *
+     * @param name - Table name
+     * @returns A1-notation range string, or null if the table has no totals row
+     */
+    getTotalRowRange(name: string): Promise<string | null>;
+    /**
+     * Add a data row to a table.
+     *
+     * @param tableName - Table name
+     * @param index - Row index within the data body (0-based). If omitted, appends to the end.
+     * @param values - Optional cell values for the new row
+     */
+    addRow(tableName: string, index?: number, values?: CellValue[]): Promise<void>;
+    /**
+     * Delete a data row from a table.
+     *
+     * @param tableName - Table name
+     * @param index - Row index within the data body (0-based)
+     */
+    deleteRow(tableName: string, index: number): Promise<void>;
+    /**
+     * Get the number of data rows in a table (excludes header and totals rows).
+     *
+     * @param tableName - Table name
+     * @returns Number of data rows
+     */
+    getRowCount(tableName: string): Promise<number>;
+    /**
+     * Get the A1-notation range for a specific data row.
+     *
+     * @param tableName - Table name
+     * @param index - Row index within the data body (0-based)
+     * @returns A1-notation range string
+     */
+    getRowRange(tableName: string, index: number): Promise<string>;
+    /**
+     * Get the cell values of a specific data row.
+     *
+     * @param tableName - Table name
+     * @param index - Row index within the data body (0-based)
+     * @returns Array of cell values
+     */
+    getRowValues(tableName: string, index: number): Promise<CellValue[]>;
+    /**
+     * Set the cell values of a specific data row.
+     *
+     * @param tableName - Table name
+     * @param index - Row index within the data body (0-based)
+     * @param values - Cell values to set
+     */
+    setRowValues(tableName: string, index: number, values: CellValue[]): Promise<void>;
+    /**
+     * Get the A1-notation range covering the data body cells of a table column.
+     *
+     * @param tableName - Table name
+     * @param columnIndex - Column index within the table (0-based)
+     * @returns A1-notation range string, or null if no data body rows
+     */
+    getColumnDataBodyRange(tableName: string, columnIndex: number): Promise<string | null>;
+    /**
+     * Get the A1-notation range covering the header cell of a table column.
+     *
+     * @param tableName - Table name
+     * @param columnIndex - Column index within the table (0-based)
+     * @returns A1-notation range string, or null if no header row
+     */
+    getColumnHeaderRange(tableName: string, columnIndex: number): Promise<string | null>;
+    /**
+     * Get the A1-notation range covering the entire table column (header + data + totals).
+     *
+     * @param tableName - Table name
+     * @param columnIndex - Column index within the table (0-based)
+     * @returns A1-notation range string, or null if column does not exist
+     */
+    getColumnRange(tableName: string, columnIndex: number): Promise<string | null>;
+    /**
+     * Get the A1-notation range covering the totals cell of a table column.
+     *
+     * @param tableName - Table name
+     * @param columnIndex - Column index within the table (0-based)
+     * @returns A1-notation range string, or null if no totals row
+     */
+    getColumnTotalRange(tableName: string, columnIndex: number): Promise<string | null>;
+    /**
+     * Get the cell values of a table column (data body only).
+     *
+     * @param tableName - Table name
+     * @param columnIndex - Column index within the table (0-based)
+     * @returns Array of cell values
+     */
+    getColumnValues(tableName: string, columnIndex: number): Promise<CellValue[]>;
+    /**
+     * Set the cell values of a table column (data body only).
+     *
+     * @param tableName - Table name
+     * @param columnIndex - Column index within the table (0-based)
+     * @param values - Cell values to set
+     */
+    setColumnValues(tableName: string, columnIndex: number, values: CellValue[]): Promise<void>;
+    /**
+     * Set whether the first column is highlighted.
+     *
+     * @param tableName - Table name
+     * @param value - Whether to highlight the first column
+     */
+    setHighlightFirstColumn(tableName: string, value: boolean): Promise<void>;
+    /**
+     * Set whether the last column is highlighted.
+     *
+     * @param tableName - Table name
+     * @param value - Whether to highlight the last column
+     */
+    setHighlightLastColumn(tableName: string, value: boolean): Promise<void>;
+    /**
+     * Set whether banded columns are shown.
+     *
+     * @param tableName - Table name
+     * @param value - Whether to show banded columns
+     */
+    setShowBandedColumns(tableName: string, value: boolean): Promise<void>;
+    /**
+     * Set whether banded rows are shown.
+     *
+     * @param tableName - Table name
+     * @param value - Whether to show banded rows
+     */
+    setShowBandedRows(tableName: string, value: boolean): Promise<void>;
+    /**
+     * Set whether filter buttons are shown on the header row.
+     *
+     * @param tableName - Table name
+     * @param value - Whether to show filter buttons
+     */
+    setShowFilterButton(tableName: string, value: boolean): Promise<void>;
+    /**
+     * Set whether the header row is visible.
+     *
+     * @param tableName - Table name
+     * @param visible - Whether to show the header row
+     */
+    setShowHeaders(tableName: string, visible: boolean): Promise<void>;
+    /**
+     * Set whether the totals row is visible.
+     *
+     * @param tableName - Table name
+     * @param visible - Whether to show the totals row
+     */
+    setShowTotals(tableName: string, visible: boolean): Promise<void>;
+    /**
+     * Apply sort fields to a table.
+     *
+     * @param tableName - Table name
+     * @param fields - Array of sort field descriptors
+     */
+    sortApply(tableName: string, fields: Array<{
+        columnIndex: number;
+        ascending?: boolean;
+    }>): Promise<void>;
+    /**
+     * Clear all sort fields from a table.
+     *
+     * @param tableName - Table name
+     */
+    sortClear(tableName: string): Promise<void>;
+}
+//# sourceMappingURL=tables.d.ts.map

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

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

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

@@ -0,0 +1,101 @@
+/**
+ * WorksheetValidation — Sub-API for data validation operations.
+ *
+ * Provides methods to set, get, remove, and query data validation rules
+ * on a worksheet. Supports both A1-style string and numeric (row, col)
+ * addressing.
+ */
+import type { ValidationRule } from '../types';
+/** Sub-API for data validation operations on a worksheet. */
+export interface WorksheetValidation {
+    /**
+     * Set a validation rule on a cell or range.
+     *
+     * @param address - A1-style cell or range address (e.g. "A1", "A1:B5")
+     * @param rule - Validation rule to apply
+     */
+    set(address: string, rule: ValidationRule): Promise<void>;
+    /**
+     * Set a validation rule on a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @param rule - Validation rule to apply
+     */
+    set(row: number, col: number, rule: ValidationRule): Promise<void>;
+    /**
+     * Remove validation from a cell (deletes any range schema covering the cell).
+     *
+     * @param address - A1-style cell address
+     */
+    remove(address: string): Promise<void>;
+    /**
+     * Remove validation from a cell (deletes any range schema covering the cell).
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     */
+    remove(row: number, col: number): Promise<void>;
+    /**
+     * Get the validation rule for a cell.
+     *
+     * @param address - A1-style cell address
+     * @returns The validation rule, or null if none
+     */
+    get(address: string): Promise<ValidationRule | null>;
+    /**
+     * Get the validation rule for a cell.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns The validation rule, or null if none
+     */
+    get(row: number, col: number): Promise<ValidationRule | null>;
+    /**
+     * Get dropdown items for a cell with list validation.
+     *
+     * @param address - A1-style cell address
+     * @returns Array of dropdown item strings
+     */
+    getDropdownItems(address: string): Promise<string[]>;
+    /**
+     * Get dropdown items for a cell with list validation.
+     *
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     * @returns Array of dropdown item strings
+     */
+    getDropdownItems(row: number, col: number): Promise<string[]>;
+    /**
+     * List all validation rules on the sheet.
+     *
+     * @returns Array of validation rules
+     */
+    list(): Promise<ValidationRule[]>;
+    /**
+     * Clear validation rules that overlap a range.
+     *
+     * @param range - A1-style range string (e.g. "A1:B5")
+     */
+    clear(range: string): Promise<void>;
+    /**
+     * Delete a validation rule by its ID.
+     *
+     * @param id - Validation rule / range schema ID
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get cells with validation errors in a range.
+     *
+     * @param startRow - Start row (0-based)
+     * @param startCol - Start column (0-based)
+     * @param endRow - End row (0-based)
+     * @param endCol - End column (0-based)
+     * @returns Array of {row, col} for cells with errors
+     */
+    getErrorsInRange(startRow: number, startCol: number, endRow: number, endCol: number): Promise<Array<{
+        row: number;
+        col: number;
+    }>>;
+}
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;;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;IAEhD;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9D;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAElC;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;;;;;OAQG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACjD"}