@mog-sdk/spreadsheet-contracts 0.1.12

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElE,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7D;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE9E;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAE7F;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IAEzC;;;;;;;;OAQG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjF;;;;;OAKG;IACH,WAAW,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/D;;;;;;OAMG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAE3E;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7D;;;;;;OAMG;IACH,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE7D;;;;;;OAMG;IACH,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F"}

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

@@ -0,0 +1,150 @@
+/**
+ * WorksheetLayout — Sub-API for row/column dimension and visibility operations.
+ *
+ * Provides methods to read and modify row heights, column widths,
+ * and row/column visibility (hide/unhide).
+ */
+/** Sub-API for row/column layout operations on a worksheet. */
+export interface WorksheetLayout {
+    /**
+     * Get the height of a row in pixels.
+     *
+     * @param row - Row index (0-based)
+     * @returns Row height in pixels
+     */
+    getRowHeight(row: number): Promise<number>;
+    /**
+     * Set the height of a row.
+     *
+     * @param row - Row index (0-based)
+     * @param height - Height in pixels (must be > 0)
+     */
+    setRowHeight(row: number, height: number): Promise<void>;
+    /**
+     * Get the width of a column in pixels.
+     *
+     * @param col - Column index (0-based)
+     * @returns Column width in pixels
+     */
+    getColumnWidth(col: number): Promise<number>;
+    /**
+     * Set the width of a column.
+     *
+     * @param col - Column index (0-based)
+     * @param width - Width in pixels (must be > 0)
+     */
+    setColumnWidth(col: number, width: number): Promise<void>;
+    /**
+     * Auto-fit a column width to its content.
+     *
+     * @param col - Column index (0-based)
+     */
+    autoFitColumn(col: number): Promise<void>;
+    /**
+     * Auto-fit multiple columns to their content in a single batch call.
+     *
+     * @param cols - Array of column indices (0-based)
+     */
+    autoFitColumns(cols: number[]): Promise<void>;
+    /**
+     * Auto-fit a row height to its content.
+     *
+     * @param row - Row index (0-based)
+     */
+    autoFitRow(row: number): Promise<void>;
+    /**
+     * Auto-fit multiple rows to their content in a single batch call.
+     *
+     * @param rows - Array of row indices (0-based)
+     */
+    autoFitRows(rows: number[]): Promise<void>;
+    /**
+     * Get row heights for a range of rows.
+     *
+     * @param startRow - Start row index (0-based, inclusive)
+     * @param endRow - End row index (0-based, inclusive)
+     * @returns Array of [rowIndex, height] pairs
+     */
+    getRowHeightsBatch(startRow: number, endRow: number): Promise<Array<[number, number]>>;
+    /**
+     * Get column widths for a range of columns.
+     *
+     * @param startCol - Start column index (0-based, inclusive)
+     * @param endCol - End column index (0-based, inclusive)
+     * @returns Array of [colIndex, width] pairs
+     */
+    getColWidthsBatch(startCol: number, endCol: number): Promise<Array<[number, number]>>;
+    /**
+     * Set the visibility of a single row.
+     *
+     * @param row - Row index (0-based)
+     * @param visible - True to show, false to hide
+     */
+    setRowVisible(row: number, visible: boolean): Promise<void>;
+    /**
+     * Set the visibility of a single column.
+     *
+     * @param col - Column index (0-based)
+     * @param visible - True to show, false to hide
+     */
+    setColumnVisible(col: number, visible: boolean): Promise<void>;
+    /**
+     * Check whether a row is hidden.
+     *
+     * @param row - Row index (0-based)
+     * @returns True if the row is hidden
+     */
+    isRowHidden(row: number): Promise<boolean>;
+    /**
+     * Check whether a column is hidden.
+     *
+     * @param col - Column index (0-based)
+     * @returns True if the column is hidden
+     */
+    isColumnHidden(col: number): Promise<boolean>;
+    /**
+     * Unhide all rows in a range.
+     *
+     * @param startRow - Start row index (0-based, inclusive)
+     * @param endRow - End row index (0-based, inclusive)
+     */
+    unhideRows(startRow: number, endRow: number): Promise<void>;
+    /**
+     * Unhide all columns in a range.
+     *
+     * @param startCol - Start column index (0-based, inclusive)
+     * @param endCol - End column index (0-based, inclusive)
+     */
+    unhideColumns(startCol: number, endCol: number): Promise<void>;
+    /**
+     * Hide multiple rows by index.
+     *
+     * @param rows - Array of row indices to hide (0-based)
+     */
+    hideRows(rows: number[]): Promise<void>;
+    /**
+     * Get the set of all hidden row indices.
+     *
+     * @returns Set of hidden row indices
+     */
+    getHiddenRowsBitmap(): Promise<Set<number>>;
+    /**
+     * Get the set of all hidden column indices.
+     *
+     * @returns Set of hidden column indices
+     */
+    getHiddenColumnsBitmap(): Promise<Set<number>>;
+    /**
+     * Reset a row's height to the sheet default.
+     *
+     * @param row - Row index (0-based)
+     */
+    resetRowHeight(row: number): Promise<void>;
+    /**
+     * Reset a column's width to the sheet default.
+     *
+     * @param col - Column index (0-based)
+     */
+    resetColumnWidth(col: number): Promise<void>;
+}
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/layout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAEvF;;;;;;OAMG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5C;;;;OAIG;IACH,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/C;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;OAIG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}

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

@@ -0,0 +1,52 @@
+/**
+ * WorksheetNames — Sub-API for sheet-scoped named ranges.
+ *
+ * Convenience wrapper that delegates to the workbook-level names API
+ * with the scope pre-filled to the current sheet.
+ */
+import type { NamedRangeInfo, NamedRangeReference, NamedRangeUpdateOptions } from '../types';
+/** Sub-API for sheet-scoped named range operations. */
+export interface WorksheetNames {
+    /**
+     * Add a named range scoped to this sheet.
+     *
+     * @param name - Name for the range
+     * @param reference - Cell reference (e.g., "A1:B10" or "=Sheet1!A1:B10")
+     * @param comment - Optional comment
+     */
+    add(name: string, reference: string, comment?: string): Promise<void>;
+    /**
+     * Get a named range by name, scoped to this sheet.
+     *
+     * @param name - Name to look up
+     * @returns Named range info or null if not found
+     */
+    get(name: string): Promise<NamedRangeInfo | null>;
+    /**
+     * Get the range reference for a named range scoped to this sheet.
+     *
+     * @param name - Name to look up
+     * @returns Range reference or null if not found
+     */
+    getRange(name: string): Promise<NamedRangeReference | null>;
+    /**
+     * Remove a named range scoped to this sheet.
+     *
+     * @param name - Name to remove
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * Update a named range scoped to this sheet.
+     *
+     * @param name - Name of the range to update
+     * @param updates - Fields to update
+     */
+    update(name: string, updates: NamedRangeUpdateOptions): Promise<void>;
+    /**
+     * List all named ranges scoped to this sheet.
+     *
+     * @returns Array of named range info objects
+     */
+    list(): Promise<NamedRangeInfo[]>;
+}
+//# sourceMappingURL=names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAE7F,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAElD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAE5D;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACnC"}

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

@@ -0,0 +1,124 @@
+/**
+ * WorksheetObjects — Sub-API Interface for Floating Object Operations
+ *
+ * Generic floating object operations (move, resize, rotate, flip, z-order,
+ * grouping), plus type-specific creation/update for shapes, pictures,
+ * text boxes, equations, WordArt, SmartArt, and drawings (ink).
+ */
+import type { CreateDrawingOptions, DrawingObject, InkStroke, StrokeId } from '../../ink/index';
+import type { ObjectBounds } from '../../kernel/floating-object-manager';
+import type { ObjectPosition } from '../../objects/floating-objects';
+import type { FloatingObjectDeleteReceipt, FloatingObjectMutationReceipt } from '../mutation-receipt';
+import type { EquationConfig, EquationUpdates, FloatingObjectInfo, PictureConfig, Shape, ShapeConfig, StrokeTransformParams, TextBoxConfig, WordArtConfig, WordArtUpdates } from '../types';
+export interface WorksheetObjects {
+    /** Delete any floating object by ID. */
+    delete(id: string): Promise<FloatingObjectDeleteReceipt>;
+    /** Move any floating object to a new position. */
+    move(id: string, x: number, y: number): Promise<FloatingObjectMutationReceipt>;
+    /** Resize any floating object. */
+    resize(id: string, width: number, height: number): Promise<FloatingObjectMutationReceipt>;
+    /** Rotate any floating object to the given angle (degrees). */
+    rotate(id: string, angle: number): Promise<void>;
+    /** Flip any floating object horizontally or vertically. */
+    flip(id: string, direction: 'horizontal' | 'vertical'): Promise<void>;
+    /** Duplicate any floating object. Returns a receipt with the new object. */
+    duplicate(id: string): Promise<FloatingObjectMutationReceipt>;
+    /** List all floating objects on the sheet. */
+    list(): Promise<FloatingObjectInfo[]>;
+    /** Get a floating object by ID. Returns null if not found on this sheet. */
+    get(objectId: string): Promise<FloatingObjectInfo | null>;
+    /** 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>>;
+    /** Update arbitrary properties of a floating object. */
+    update(objectId: string, updates: Record<string, unknown>): Promise<void>;
+    /** Delete multiple floating objects. Returns count of successfully deleted objects. */
+    deleteMany(objectIds: string[]): Promise<number>;
+    /** 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>;
+    /** Group multiple floating objects. Returns the group ID. */
+    group(ids: string[]): Promise<string>;
+    /** Ungroup a floating object group. */
+    ungroup(groupId: string): Promise<void>;
+    /** Add a shape to the sheet. Returns a receipt with the new shape. */
+    addShape(config: ShapeConfig): Promise<FloatingObjectMutationReceipt>;
+    /** Get a shape by ID, or null if not found. */
+    getShape(shapeId: string): Promise<Shape | null>;
+    /** Update a shape's configuration. */
+    updateShape(shapeId: string, updates: Partial<ShapeConfig>): Promise<FloatingObjectMutationReceipt>;
+    /** Remove a shape by ID. */
+    removeShape(shapeId: string): Promise<void>;
+    /** List all shapes in the sheet. */
+    listShapes(): Promise<Shape[]>;
+    /** Add a picture to the sheet. Returns a receipt with the new picture. */
+    addPicture(config: PictureConfig): Promise<FloatingObjectMutationReceipt>;
+    /** Update a picture's properties. */
+    updatePicture(id: string, updates: Partial<PictureConfig>): Promise<void>;
+    /** Add a text box to the sheet. Returns a receipt with the new text box. */
+    addTextBox(config: TextBoxConfig): Promise<FloatingObjectMutationReceipt>;
+    /** Add an equation to the sheet. Returns the equation ID. */
+    addEquation(config: EquationConfig): Promise<string>;
+    /** Update an existing equation. */
+    updateEquation(id: string, updates: EquationUpdates): Promise<void>;
+    /** Add WordArt to the sheet. Returns the WordArt ID. */
+    addWordArt(config: WordArtConfig): Promise<string>;
+    /** Update existing WordArt. */
+    updateWordArt(id: string, updates: WordArtUpdates): Promise<void>;
+    /** Convert a regular 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>;
+    /** Create a new drawing object. Returns the drawing ID. */
+    createDrawing(position: Partial<ObjectPosition>, options?: CreateDrawingOptions): Promise<string>;
+    /** Add a completed stroke to a drawing. */
+    addDrawingStroke(drawingId: string, stroke: InkStroke): Promise<void>;
+    /** Erase strokes from a drawing by their IDs. */
+    eraseDrawingStrokes(drawingId: string, strokeIds: StrokeId[]): Promise<void>;
+    /** Clear all strokes from a drawing. */
+    clearDrawingStrokes(drawingId: string): Promise<void>;
+    /** Move strokes by a delta offset. */
+    moveDrawingStrokes(drawingId: string, strokeIds: StrokeId[], deltaX: number, deltaY: number): Promise<void>;
+    /** Transform strokes (rotate, scale, flip). */
+    transformDrawingStrokes(drawingId: string, strokeIds: StrokeId[], transform: StrokeTransformParams): Promise<void>;
+    /** Get a drawing object by ID, with deserialized Maps. Returns null if not found. */
+    getDrawing(drawingId: string): Promise<DrawingObject | null>;
+    /** Find strokes at a point using spatial index. Returns stroke IDs. */
+    findStrokesAtPoint(drawingId: string, x: number, y: number, tolerance?: number): Promise<StrokeId[]>;
+    /** Connect the start of a connector to a target shape at a connection site. */
+    connectBeginShape(connectorId: string, targetShapeId: string, siteIndex: number): Promise<void>;
+    /** Connect the end of a connector to a target shape at a connection site. */
+    connectEndShape(connectorId: string, targetShapeId: string, siteIndex: number): Promise<void>;
+    /** Disconnect the start of a connector from its connected shape. */
+    disconnectBeginShape(connectorId: string): Promise<void>;
+    /** Disconnect the end of a connector from its connected shape. */
+    disconnectEndShape(connectorId: string): Promise<void>;
+    /** Get connection data for a connector (which shapes it connects to). */
+    getConnectorData(connectorId: string): Promise<{
+        startConnection?: {
+            shapeId: string;
+            siteIndex: number;
+        };
+        endConnection?: {
+            shapeId: string;
+            siteIndex: number;
+        };
+    } | null>;
+    /** Get the member object IDs of a floating object group. */
+    getGroupMembers(groupId: string): Promise<string[]>;
+    /** Get the image format (png, jpeg, gif, etc.) for a picture object. */
+    getImageFormat(objectId: string): Promise<string | null>;
+    /**
+     * Get the number of connection sites on a shape.
+     * Most standard shapes have 4 connection sites (top, right, bottom, left).
+     * Returns 0 if the object is not found.
+     */
+    getConnectionSiteCount(objectId: string): Promise<number>;
+}
+//# sourceMappingURL=objects.d.ts.map

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

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

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

@@ -0,0 +1,101 @@
+/**
+ * WorksheetOutline — Sub-API for row/column grouping and outline operations.
+ *
+ * Provides methods to group/ungroup rows and columns, manage collapse state,
+ * apply subtotals, and configure outline settings.
+ */
+import type { GroupState, OutlineSettings, SubtotalConfig } from '../types';
+/** Sub-API for outline (row/column grouping) operations on a worksheet. */
+export interface WorksheetOutline {
+    /**
+     * Group rows in a range.
+     *
+     * @param startRow - Start row index (0-based, inclusive)
+     * @param endRow - End row index (0-based, inclusive)
+     */
+    groupRows(startRow: number, endRow: number): Promise<void>;
+    /**
+     * Ungroup rows in a range.
+     *
+     * @param startRow - Start row index (0-based, inclusive)
+     * @param endRow - End row index (0-based, inclusive)
+     */
+    ungroupRows(startRow: number, endRow: number): Promise<void>;
+    /**
+     * Group columns in a range.
+     *
+     * @param startCol - Start column index (0-based, inclusive)
+     * @param endCol - End column index (0-based, inclusive)
+     */
+    groupColumns(startCol: number, endCol: number): Promise<void>;
+    /**
+     * Ungroup columns in a range.
+     *
+     * @param startCol - Start column index (0-based, inclusive)
+     * @param endCol - End column index (0-based, inclusive)
+     */
+    ungroupColumns(startCol: number, endCol: number): Promise<void>;
+    /**
+     * Toggle the collapsed state of a group.
+     *
+     * @param groupId - Group identifier
+     */
+    toggleCollapsed(groupId: string): Promise<void>;
+    /**
+     * Expand all groups in the worksheet.
+     */
+    expandAll(): Promise<void>;
+    /**
+     * Collapse all groups in the worksheet.
+     */
+    collapseAll(): Promise<void>;
+    /**
+     * Get the full group state for the worksheet.
+     *
+     * @returns Group state including row groups, column groups, and max levels
+     */
+    getState(): Promise<GroupState>;
+    /**
+     * Get the outline level of a specific row or column.
+     *
+     * @param type - Whether to query a row or column
+     * @param index - Row or column index (0-based)
+     * @returns The outline level (0 if not in any group)
+     */
+    getLevel(type: 'row' | 'column', index: number): Promise<number>;
+    /**
+     * Get the maximum outline level for rows or columns.
+     *
+     * @param type - Whether to query rows or columns
+     * @returns The maximum outline level
+     */
+    getMaxLevel(type: 'row' | 'column'): Promise<number>;
+    /**
+     * Apply automatic subtotals.
+     *
+     * @param config - Subtotal configuration
+     */
+    subtotal(config: SubtotalConfig): Promise<void>;
+    /**
+     * Get the outline display settings.
+     *
+     * @returns Current outline settings
+     */
+    getSettings(): Promise<OutlineSettings>;
+    /**
+     * Update outline display settings.
+     *
+     * @param settings - Partial outline settings to update
+     */
+    setSettings(settings: Partial<OutlineSettings>): Promise<void>;
+    /**
+     * Show outline to a specific level for rows and/or columns.
+     * Groups at levels > the specified level are collapsed; groups at levels <= are expanded.
+     * Pass 0 to collapse all, or a number > maxLevel to expand all.
+     *
+     * @param rowLevels - Target outline level for rows (0 = collapse all rows)
+     * @param colLevels - Target outline level for columns (0 = collapse all columns)
+     */
+    showOutlineLevels(rowLevels: number, colLevels: number): Promise<void>;
+}
+//# sourceMappingURL=outline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../../src/api/worksheet/outline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE5E,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAEhC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAExC;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;;;;;;OAOG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE"}